前言¶
在 DeepSeek Harness(下称 DSH)里把一个目标拆给多个子 Agent 执行已经可行,但过程往往不够透明:子会话各自运行,出了问题只能翻日志;批准过的计划和实际执行之间差在哪里,缺少一个有证据的答案;失败之后想重试,也不清楚哪些工作可以复用。
dsh-product-subagent-console 针对的就是这条链路:先有可审阅的计划,再看真实的执行,出偏差时定位到具体一步,最后准备一次安全的恢复。下面介绍它的功能、安装方法和基本用法。
这是什么¶
dsh-product-subagent-console 是由 Jokasa7 维护的独立社区插件,不是 DSH 官方组件,采用 MIT 许可证,当前版本 0.9.0。
它在 DSH 会话内加入一个可拖拽的 Subagents 工作台,用于设计多 Agent 运行、观察真实的子会话树、检查实际发生了什么,并准备下一步的恢复动作。界面语言跟随当前 DSH 语言设置,文档与截图提供中英文版本。
四个模式¶
Plan:先有可审阅的计划¶
把目标转化为可编辑的角色、任务、依赖、Provider、工具、检查项与预算,并在审批前进行预检(preflight)。你批准的是具体的计划修订版,而不是一句模糊的指令。
Live:看真实的父子树¶
将原生子会话与兼容 Provider 的运行以真实父子树的形式展示,可在同一画布上查看任务、生命周期状态、时序与子会话关系。
Deviation:定位首个有证据的不一致¶
把已批准的任务映射到实际执行尝试,回放权威事件时间线,找到第一个有证据支撑的不一致点,而不是凭印象猜测。
Recovery:准备安全的下一步¶
预览哪些工作会被重试、哪些可以复用,就运行事实提问,导出脱敏的 Run Capsule,并从已验证的运行中提炼可复用的工作流候选。
安装¶
插件通过 GitHub Release 本地安装,不使用在线源。先从匹配的 Release 下载 .tgz 与 SHA256SUMS.txt,校验包完整性:
sha256sum --check SHA256SUMS.txt
再按所用 profile 执行安装。DSH Desktop 在 Open DSH Terminal 中运行:
dsh plugin add ./dsh-product-subagent-console-0.9.0.tgz
常规 Web profile 使用:
dsh plugin --profile web add ./dsh-product-subagent-console-0.9.0.tgz
安装完成后重启 DSH Desktop 或对应 Web profile。
启用规划与执行¶
插件默认提供 Live 观测;要在计划中直接执行任务图,需要启用 planner 工具。做法是复制一个 Agent Preset,加入 planner 工具后保存,再用该预设新建会话:
- id: agent-planner
name: dsh-product-subagent-console/plan-tool
config:
toolName: design_subagent_plan
executeToolName: execute_subagent_plan
预设变更只对新会话生效。未启用 planner 工具时,对普通兼容委托的 Live 观测仍然可用。
60 秒试用¶
启用 planner 工具后,打开 Subagents → Plan,使用 README 提供的只读三 Agent 示例:
设计一个只读的三 Agent 工作流。Agent A 从 README.md 读取项目定位;Agent B 从 package.json 读取 name 与 version;Agent C 只使用 A、B 的结果返回三条事实。不要修改文件。执行前让我审阅计划。
流程为:生成计划 → 审阅角色与边界 → 预检 → 批准指定修订版 → 确认执行,然后在 Live、Deviation、Recovery 三个视图之间切换,从三个角度查看同一次运行。
README 称 v0.9 构建经 4 次成功的只读工作流运行、15 个观测子会话、30 个测试文件 / 245 项测试以及包/安装冒烟检查验证。
适用场景与注意事项¶
适合的场景¶
README 列出以下几类:
- 需要保持归属与依赖可见的并行代码、文档或仓库审查;
- 分阶段实现,之后接独立的验证或综合;
- 诊断卡住、未完成、意外分支或缺少证据的运行;
- 把反复验证过的工作流变成可复用的起点,且不自动运行。
兼容性¶
- DeepSeek Harness Web 或 Desktop profile
0.1.1-rc.2 - Node.js
^22.19.0或>=24.0.0 - 计划执行需要兼容的 subagent Provider;外部编码 Agent 需要对应的 Provider Bundle
隐私与权限¶
计划中的目标、职责、任务简报、完成标准、资源名称都是用户输入内容,不要填入凭据或隐私内容,详见仓库内 docs/data-and-privacy.md。
需要提醒的是:该插件以当前 dsh 进程的权限运行。它是独立社区项目,安装前建议先检查源码与许可证(MIT,第三方声明见 THIRD_PARTY_NOTICES.md),确认可接受再安装。
卸载¶
dsh plugin remove dsh-product-subagent-console
# 或:dsh plugin --profile web remove dsh-product-subagent-console
移除后重启对应 profile。卸载不会自动删除本地 Foundry 数据,处理方式见 Data and Privacy 文档。漏洞请通过 SECURITY.md 中的私密渠道报告,不要走公开 Issue。
小结¶
dsh-product-subagent-console 把多 Agent 运行的计划、观测、比对与恢复放进同一个 DSH 会话,核心价值在于每一步判断都有运行事实可依。经过上面的步骤即可完成安装、启用与试用。
- GitHub 仓库:https://github.com/Jokasa7/dsh-product-subagent-console
- 社区目录页:https://www.skillhub.cn/plugins/Jokasa7/dsh-product-subagent-console (社区目录为独立站点,与 DeepSeek、幻方无官方从属关系)