@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.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