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）是独立站点，不隶属于任何官方应用商店。