前言¶
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
