dsh-nanobot-subagent-link：將 NanoBot 作爲子代理接入 DeepSeek Harness

前言¶

DeepSeek Harness (DSH) 採用插件化架構。當需要在 DSH 流程中調用本地運行的 AI 代理時，手動集成成本較高。dsh-nanobot-subagent-link 插件提供了現成的橋接方案，它允許 DSH 將一個獨立的子任務通過 nanobot_run 工具交給本地 NanoBot 執行，並將執行結果返回給 Harness 流程。

插件定位¶

名稱：dsh-nanobot-subagent-link
所有者：2025Bigeye
核心能力：將本地 NanoBot 實例註冊爲 DSH 的子代理。DSH 會通過工具調用將自包含的子任務傳遞給 NanoBot，由其使用自身的工具和上下文執行，並僅返回最終答案。
支持：該插件會註冊 nanobot_run 工具、nanobot-run 運行時技能以及對應的提示部分，使新會話能直接發現該能力。

安裝與前置要求¶

安裝前請確保環境滿足以下條件：
* DSH Web 版本不小於 0.1.0-rc.6
* 系統中已安裝本地 nanobot CLI，且在 PATH 環境變量中
* Windows 系統必須使用 PowerShell

執行以下命令進行安裝：

dsh plugin --profile web add dsh-tool-nanobot

安裝完成後，重啓 dsh web 服務即可使用。

使用模式¶

DSH 會自動調用 nanobot_run 工具，支持兩種調用模式，通過配置切換：

oneshot（默認模式）
- 每個任務會啓動一個獨立的 nanobot agent 進程。
- 執行 nanobot agent -m <prompt> 命令。
- 特點是無狀態的，適合執行與上下文無關的獨立任務。
server 模式
- 啓動一個持久的 nanobot serve 服務，提供 OpenAI 兼容的 /v1/chat/completions 端點。
- 命令：nanobot serve。
- 特點是響應更快，且由插件在 DSH 關閉時自動終止服務進程。

配置項¶

在 DSH 的設置界面中找到 nanobot 命名空間進行配置：

字段	默認值	說明
`mode`	`oneshot`	默認調用模式：`oneshot` 或 `server`
`oneshotCommand`	`nanobot agent -m "{prompt}" --no-markdown`	單次運行命令模板，必須包含一個 `{prompt}` 佔位符
`serverBaseUrl`	`http://localhost:8900`	服務模式下的地址（僅限本地迴環）
`serverStartCommand`	`nanobot serve`	用於啓動服務模式的命令
`serverModel`	(空)	發送給服務器的模型名稱，留空則由服務端自行決定

安全與執行機制¶

插件內置了多層安全防護與執行控制：
* 命令與 URL 注入防護：命令模板和服務器 Base URL 僅來自受信任的用戶設置，沒有模型可控的注入面。
* 網絡隔離：服務器模式強制迴環白名單，API 密鑰不會發送到主機之外。
* 沙盒與審批：支持沙盒感知執行，結合 sandbox_permissions 和 justification 實現批准升級機制。
* 資源清理：插件在銷燬時會自動截斷輸出，並終止已啓動的服務器進程。

注意事項¶

該插件以當前 DSH 進程的權限運行，請確保在安裝前檢查其源碼與許可證。
在 Windows 環境下，插件依賴 PowerShell 的 Shell Service 來執行命令。
此插件屬於社區維護項目，與 DeepSeek 或幻方量化無官方從屬關係。

生態背景¶

DSH 的理念是「一切皆插件」，社區目錄（如 SkillHub）是獨立站點，不隸屬於任何官方應用商店。