DSH Native Collab · 原生协作增强

Deepseek Harness Agent协作增强（基于原版插件）：为 DeepSeek Harness (DSH) 提供子 Agent 沟通增强与 Team 模型选择支持，基于 DSH 派生的非官方社区插件（非官方发行版）。

当前状态：本地试用版本（未发布至 npm），兼容 DSH >=0.2.1-rc.1 <0.2.2-0 与 Node >=22.19.0。

English · 安装指南 · 常见问题 (FAQ)

---

主要功能

功能	说明
子 Agent 沟通增强	插件配置页提供增强主开关，并支持“工作中接收补充要求”与“允许继续已完成的子对话”；关闭增强后保留原生基础能力与权限规则。
Team 与子 Agent 模型选择	统一提供三种模型来源：对话开始时设置的子模型列表、DSH 当前设置的子模型列表、当前 DSH 全部可用模型；后两者在每次查询或创建 Agent 时重新读取，并遵循模型适配器与权限校验。
连续自动唤醒轮数上限	默认 32 轮，由 Team 家族共享，防止多 Agent 协作死循环；只统计无人类输入介入的连续自动唤醒，人类输入或进程重启即清零，子任务完成/停止的自动回报不受此限。
单入口托管三个后台服务	子 Agent 服务、Team 服务、Team 工具由同一个管理入口统一托管；与原生根服务互斥，关闭入口并重启同一 Profile 即回到原生。
四个协作工具动态适配	control/list/spawn/fork 按四种已知 AgentPreset 的模块身份与 ID 在内存中适配，不修改也不锁定用户预设文件，亦不影响未知自定义 provider；官方实验包的四个根层工具保持禁用。
只读状态诊断	展示各组件当前状态与运行阶段、模型来源及装配诊断（原生 / 托管 / 混合 / 未知），只读展示，不在线写入 Profile。
设置自动保存与双语界面	配置页各项修改自动保存，保存未确认或失败时在对应项旁提示；界面随 DSH 语言在中/英文间切换。
卸载回原生与故障排查	移除插件会自动移除 patch 并切回原生根服务；若卸载或降级后 DSH 无法启动，按 FAQ 检查 Profile 的外部启动覆盖文件与 patch 残留。

进度与结果请在发起任务的对话中的 Team 面板或任务卡片查看；设置页面不作为实时任务监控板。

运行与适配机制

插件 patch 只插入一个管理入口，由其统一管理三个后台服务。三个原生根服务与管理入口状态互斥：入口启用时运行增强托管服务；关闭入口后正常重启同一 Profile 即可恢复原生服务。 四个协作工具针对四种已知 AgentPreset 在内存中按模块身份与 ID 动态适配，不修改或锁定用户原有预设文件，亦不影响未知自定义 provider。官方实验包的四个根层工具保持禁用。

安装与快速上手

首先停止目标 Profile（如 web）的运行服务，然后在工作区根目录执行安装（亦可使用 TGZ 包的绝对路径）：

dsh plugin --profile web add "./release/artifacts/current/sieuno-dsh-native-collab-<version>.tgz"

安装完成后重新启动同一 Profile 并进入插件管理页面：

• 修改自动保存：页面中的各项设置修改后会自动保存，无需点击保存按钮；若保存未确认或失败，对应项旁将显示错误提示。
• 生效方式：模型来源立即生效于后续的模型查询与创建；增强开关及连续自动唤醒轮数上限等启动配置，在按提示正常关闭服务并重启同一 Profile 后应用（单纯刷新网页不算重启）。
• 卸载与清理：移除插件会自动移除 patch 并切回原生根服务。如曾手动修改并锁定过插件内部模块，请查阅 常见问题 (FAQ) 的恢复指南。
• 启动失败排查：卸载或降级后若 DSH 无法启动，先检查 Profile 目录下的 *.patch.json 外部启动覆盖文件是否仍引用本插件，再清理 Profile patch 中的残留行；步骤见 常见问题 (FAQ)。

开发与许可

开发说明 · 测试说明 · 更新日志。

本项目源自 DeepSeek Harness dsh-v0.2.1-rc.2，遵循 MIT License，保留版权与 NOTICE 说明。详见 上游来源说明 与 第三方声明。