xgone/dsh-netshell

DSH-NetShell

中文 · English

面向 DeepSeek Harness 的受保护本地与远程 SSH 终端

DSH-NetShell 让你在 DSH 中管理服务器、使用实时终端，并在危险命令执行前保留一个清晰的人工确认点。人工输入和 AI 操作共用同一套命令护栏。

核心能力

| 能力 | 你得到什么 |
| --- | --- |
| 本地终端 | 直接启动当前设备的 bash、sh、PowerShell 或 cmd，无需 SSH 配置 |
| 远程 SSH | 管理主机、端口、用户和认证方式，多个会话并行运行 |
| 命令护栏 | allow 直接执行、ask 等待确认、deny 直接拦截 |
| 可见执行 | 人工输入和 AI 执行都实时显示在同一个终端面板 |
| 凭据隔离 | SSH 密码只进入 DSH 加密凭据库，不进入 AI 消息、工具结果或日志 |
| 命令历史 | 查看执行、拦截、放行计数和每条命令的裁决记录 |

安装

已发布包：

dsh plugin --profile web add @xgone/dsh-netshell

从本地源码安装：

dsh plugin --profile web add link:/path/to/dsh-netshell

安装后重启 DSH Web，然后打开 设置 → 终端。

快速开始

本地终端

1. 打开主区域的 终端 Tab。
2. 在左侧 本地终端 行点击 新建。
3. 输入命令并观察实时输出。

本地终端不会读取远程服务器档案或 SSH 密码。

远程服务器

1. 打开 设置 → 终端 → 新增。
2. 填写名称、主机、端口和用户名。
3. 选择密码、私钥或 ssh-agent 认证。
4. 选择权限等级，第一次使用建议保持 guarded。
5. 回到 终端 Tab，在服务器行点击 连接。

密码保存后只显示“已设置”，不会再次回显。

危险命令

命令在回车提交时检查：

| 等级 | 行为 |
| --- | --- |
| open | 日常使用；除硬拦截规则外直接执行 |
| guarded（默认） | 高风险命令暂停并等待确认 |
| locked | 只有明确允许的命令可以直接执行 |

遇到 ask 命令时，选择 执行一次、永久放行该命令 或 拒绝。永久放行只对当前服务器和当前命令文本生效。

界面预览

终端与危险命令确认（中文）

终端底栏会显示执行、拦截和放行次数；点击 历史 可查看本会话的命令记录。切换到其他 DSH Tab 不会主动断开后台会话。

AI 工具

插件提供两个模型工具：

| 工具 | 用途 |
| --- | --- |
| netshell_servers | 列出服务器档案，不返回密码 |
| netshell_run | 在指定服务器上执行一条命令 |

AI 和人工输入共用同一套 Guard。deny 命令不会执行，ask 命令必须由你在 DSH 的确认卡或终端面板中裁决；AI 看不到密码，也不能伪造确认结果。

当前模型会话首次使用某台服务器，或用户手动断开该服务器后再次使用时，netshell_run 会先弹出远程连接确认；确认前不会启动 SSH。确认在当前插件生命周期内按模型会话和服务器分别保留；不同模型会话即使复用同一个 SSH 会话，也必须各自确认。网络故障、SSH 异常退出或连接等待超时只会触发当前模型会话的自动重连，不会再次询问。GUI 中已有的人工连接不会替代模型确认；确认服务不可用时插件会拒绝自动建连。

安全边界

这是命令操作护栏，不是完整的安全沙箱。它只保护通过本插件终端和 netshell_run 进入的命令；其他插件或通用 Shell 工具建立的 SSH 连接不在拦截范围内。对敏感环境建议使用 locked，并审查交互式程序内部执行的操作。

SSH 主机指纹保存在插件私有的 ~/.dsh/netshell/known_hosts，不会写入用户手工 SSH 使用的 ~/.ssh/known_hosts。

文档

- English README
- 更新记录
- 技术细节
- 动态加载手册
- 设计方案与宿主契约
- 完整历史变更

常见问题
连接失败怎么办？ 检查主机、端口、用户名和认证方式。若提示主机指纹变化，确认服务器确已重装后，再按提示清理插件私有 known_hosts 记录。

密码会被 AI 看到吗？ 不会。密码由 Host 侧从 DSH 加密凭据库读取，只用于建立 SSH 连接；列表、工具返回、日志和终端输出都不包含密码值。