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。

来源信息

安装

检查来源文件

dsh-ssh-pro

为什么做这个

特性

前置要求

安装

工具

配置项

安全说明

目录结构

许可

更多相关插件

dsh-skillopt

dsh-az

dsh-codex