dsh-ssh-pro

DeepSeek Harness 的 SSH 增强运维插件 —— 补齐 base dsh-ssh 插件容易忽略的操作： 连接测试、远程目录浏览、~/.ssh/config 导入、known_hosts 指纹检查、多主机批量执行。

独立社区项目。复用 @linxin666/dsh-ssh 的主机配置存储（Apache-2.0），但无运行时依赖——只依赖 ssh2 库，可与任何 SSH 插件共存。

为什么做这个

原版 dsh-ssh 提供了 ssh_list/exec/upload/download/tunnel/cluster 和完整 GUI，但 5 个引擎已有能力没暴露给 agent，正是"存在但容易被忽略"的缺口：

| 缺失的能力 | 原版状态 | 本插件 | |---|---|---| | 连接测试 | 引擎有 test()，无工具 | ✅ ssh_test | | 远程目录浏览 | 引擎有 ls()，无工具 | ✅ ssh_ls | | ssh-config 导入 | store 有 importFromSshConfig，无工具 | ✅ ssh_import | | 指纹确认 | 无 | ✅ ssh_keyscan | | 多主机批量 | cluster 依赖 GUI 面板 | ✅ ssh_multi_exec（独立实现） |

特性

• 5 个原生工具：ssh_test / ssh_ls / ssh_import / ssh_keyscan / ssh_multi_exec
• 直接读 ~/.dsh/dsh-ssh.json（与 dsh-ssh GUI 配置互通）
• ssh_multi_exec 支持别名/环境/标签过滤 + 并发控制
• 附带 SKILL.md 技能文件
• Schemastery 配置 + bundle patch 层
• 安全模型与 dsh-ssh 一致：0600 主机库、输出原样返回、无密钥泄露

前置要求

• DeepSeek Harness（dsh）
• ssh2 npm 包（插件依赖）
• 主机配置：dsh-ssh GUI 配置，或 ~/.dsh/dsh-ssh.json（可用 ssh_import 从 ~/.ssh/config 导入）

安装

# profile 的 cordis.patch.yml
- insert:
    - id: ssh-pro
      name: './src/index.js'
      config:
        storePath: ~/.dsh/dsh-ssh.json
        sshConfigPath: ~/.ssh/config
        timeoutMs: 30000

# 或本地开发
pnpm dsh web --patch ./dsh-ssh-pro/cordis.patch.yml

工具

| 工具 | 行为 | |---|---| | ssh_test | 连接并跑 true，报延迟/错误 | | ssh_ls | SFTP 列目录（名字/类型/大小/mtime） | | ssh_import | 解析 ~/.ssh/config 导入主机库（跳过已存在/通配符） | | ssh_keyscan | 检查 known_hosts 是否已有该主机指纹 | | ssh_multi_exec | 并发多主机执行（别名/环境/标签过滤） |

配置项

| 键 | 默认 | 说明 | |---|---|---| | storePath | ~/.dsh/dsh-ssh.json | 主机库路径 | | sshConfigPath | ~/.ssh/config | 导入源 | | knownHostsPath | ~/.ssh/known_hosts | 指纹检查 | | timeoutMs | 30000 | 默认超时 |

安全说明

• 密码/passphrase 存 0600 主机库；工具从不输出密钥
• ssh_multi_exec 输出原样返回（env 等命令可能带回远端环境变量）
• ssh_keyscan 只读；新主机提示需用户确认指纹

目录结构

dsh-ssh-pro/
  src/index.js            # 插件入口：5 个工具 + ssh2 引擎 + 配置
  skills/ssh-pro/SKILL.md # agent 技能
  docs/                   # 文档
  cordis.patch.yml        # bundle patch 层

许可

Apache-2.0。