前言¶
DeepSeek Harness (DSH) 支持通过插件扩展能力。本插件用于连接 DeepSeek Harness 到 Netcatty 的官方 External MCP 服务器。在本地开发或使用 SSH/SFTP 时，通常需要分别管理工具链或依赖外部服务。通过此插件，DSH 可以直接调用 Netcatty 提供的工具，而无需将敏感凭证直接暴露给 DSH 进程。
这是什么¶
dsh-netcatty 是一个 DeepSeek Harness 插件，由开发者 qq739844663 维护，采用 MIT 许可证。
它的核心作用是：注册 Netcatty 的工具到 DSH。插件本身不处理 SSH 会话、SFTP 传输或 Vault 数据，这些安全敏感的操作仍由 Netcatty 原生接管。DSH 仅通过标准化的 MCP 协议与 Netcatty 通信，实现工具调用。
核心功能¶
根据已核实的事实，该插件具备以下能力：
- 连接官方服务器：直接连接 Netcatty 的官方 External MCP 服务器。
- 工具注册：在 DSH 中注册 Netcatty 暴露的工具。
- 权限控制：强制执行 Netcatty 的权限策略，并在进行受保护操作时显示审批请求。
- 协议支持：支持 SSH 和 SFTP 操作。
安装与启用¶
安装前请确保环境满足依赖要求。
前置条件¶
- DeepSeek Harness：需安装
@deepseek-ai/dsh-mcp-client0.1.0-rc.7 或更新版本。 - Netcatty：需安装 1.1.80 或更新版本。
- 配置：需在 Netcatty 的 Settings > AI > External MCP 中启用 External MCP 功能。
- 运行状态：DSH 使用工具期间，Netcatty 必须保持运行，建议使用持久化模式。
安装命令¶
以默认 Web Profile 为例：
dsh plugin --profile web add https://github.com/qq739844663/dsh-netcatty
如果使用无头 Profile，请执行：
dsh plugin --profile headless add https://github.com/qq739844663/dsh-netcatty
安装完成后，必须重启 DSH Web 主机，工具才会以 mcp__netcatty__ 前缀注册到 DSH 中。
典型用法与配置¶
对于标准安装路径，DSH 会自动定位 Netcatty 的 netcatty-external-mcp 启动器。若安装位置非标准，需通过环境变量或配置文件指定。
1. 非标准安装路径¶
在启动 DSH 前设置环境变量 NETCATTY_MCP_LAUNCHER：
$env:NETCATTY_MCP_LAUNCHER = 'D:\Apps\Netcatty\resources\app.asar.unpacked\electron\cli\netcatty-external-mcp.cmd'
dsh web
2. 非默认 Profile¶
若使用非默认的 Netcatty Profile，需设置 NETCATTY_EXTERNAL_MCP_DISCOVERY_FILE 指向该 Profile 的 external-mcp/discovery.json 文件。
3. 个性化配置¶
可以通过 Override Patch 覆盖默认行为，例如调整超时时间或断线重连策略：
- id: netcatty-external-mcp
config:
launcherPath: D:\\Apps\\Netcatty\\resources\\app.asar.unpacked\\electron\\cli\\netcatty-external-mcp.cmd
discoveryFile: C:\\Users\\me\\AppData\\Roaming\\Netcatty\\external-mcp\\discovery.json
toolCallTimeoutMs: 120000
failOnStartupError: false
reconnect:
enabled: true
initialDelayMs: 1000
maxDelayMs: 30000
maxAttempts: 10
适用场景与注意¶
安全机制¶
插件遵循“最小权限”原则。它不会解析 Netcatty 的 Vault，不会读取保存的凭证，也不会复制发现令牌。所有认证和会话管理均由 Netcatty 的官方启动器自行处理。
启动错误处理¶
插件的默认配置为 failOnStartupError: false。这意味着，如果检测到 Netcatty 未安装或启动失败，DSH Profile 仍会继续运行，只是此时 Netcatty 工具不可用。如果希望安装 Netcatty 后立即生效，建议安装或启用 Netcatty 后重启 DSH。
总结¶
dsh-netcatty 解决了 DeepSeek Harness 与 Netcatty 之间的连接问题。它允许 DSH 利用 Netcatty 的 SSH/SFTP 能力，同时保持安全边界的清晰。对于需要将 DeepSeek 集成到 SSH 管理或文件传输场景的开发者，这是一个直接的集成方案。
- GitHub 仓库: https://github.com/qq739844663/dsh-netcatty
- 插件目录: https://www.skillhub.cn/plugins/qq739844663/dsh-netcatty
