@liziy/ssh-manager

版本 1.1.0 — AI 远程操作服务器扩展

通过 /ssh 命令管理 SSH 连接，AI 可通过 ssh_exec / ssh_list_servers 工具远程执行命令，受权限控制。

特性

• AI 远程操作 — 注册 ssh_exec 和 ssh_list_servers 工具，AI 可远程执行命令
• 安全控制 — 3 层防护：硬限制危险命令、只读模式、执行确认策略
• 导航菜单 — /ssh 默认显示 5 选项菜单（查看/新增/编辑/删除/配置）
• 连接测试 — 添加时自动测试连接是否可达
• OS 自动探测 — 自动扫描 ~/.ssh/ 下的 ed25519 / rsa / ecdsa / dsa 密钥
• 本地存储 — 配置保存到 ~/.pi/agent/ssh-configs.json

安装

pi install npm:@liziy/ssh-manager

依赖 ssh2 npm 包，pi install 会自动安装。

使用

/ssh 子命令

| 命令 | 作用 | |------|------| | /ssh | 打开导航菜单（查看/新增/编辑/删除/配置） | | /ssh add | 新增连接 | | /ssh edit | 编辑已有连接 | | /ssh rm | 删除连接 | | /ssh ls | 列出并选择连接查看详情 | | /ssh config | 查看/修改插件配置 |

新增流程

1. IP 地址          [必填]
2. 用途说明          [可选]
3. 用户名           [默认: 当前系统用户]
4. 端口             [默认: 22]
5. 密码             [可选，留空使用密钥]
6. 密钥路径          [从 ~/.ssh/ 自动探测]
7. 连接名称          [默认: 从 host 派生]

编辑流程

• 顶部明确回显所有当前值
• 每个字段标题包含"当前: x"
• 留空 = 保持当前值
• 输 - = 清空说明字段

插件配置

通过 /ssh config 或导航菜单「配置」修改全局配置：

| 配置项 | 默认值 | 说明 | |--------|--------|------| | AI 只读模式 | 是 | AI 只能执行 ls/cat/ps 等读命令 | | 执行确认 | 写操作确认 | 不确认 / 写操作确认 / 每次都确认 | | 命令超时 | 30s | 单条命令超时秒数 |

AI 工具

| 工具 | 说明 | |------|------| | ssh_exec | 在指定服务器上执行命令，返回 stdout/stderr/退出码 | | ssh_list_servers | 列出所有已配置的 SSH 服务器 |

安全检查

• 硬限制：rm -rf /、shutdown、reboot、dd、mkfs 等危险命令直接禁止
• 只读模式：只允许 50+ 种读命令（ls/cat/ps/df/git log 等）
• 确认策略：AI 执行写操作时需用户手动确认

版本历史

1.1.1

• 删除连接前新增确认对话框，防止误删

1.1.0

• 新增 AI 工具：ssh_exec 远程命令执行、ssh_list_servers 列出服务器
• 新增全局配置系统：ai_readonly、confirm_before_exec、command_timeout
• 新增 /ssh 导航菜单（查看/新增/编辑/删除/配置）
• 新增安全控制：硬限制危险命令、只读命令列表、执行确认策略
• 更新 /db 命令描述为"AI 远程操作服务器"

1.0.1

• 修复连接测试超时问题

1.0.0

• 初始发布：SSH 连接管理，添加/编辑/删除/查看配置

许可

MIT