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。