前言¶
在 DeepSeek Harness 里跑带 Task 子 Agent 的长会话时，主会话、子 Agent 和工具调用都散落在对话与轨迹里。要弄清「谁在做哪件事、汇报到了哪一步」，往往得在标签页之间来回翻，脑内还原协作结构。dsh-mutipleagent 是社区插件（维护者 lkuliuying，分类：工作流），把同一会话里的主 Agent、子 Agent、工具活动与汇报放进统一的 3D「办公室」场景，只做只读观察，不替代 Harness 的对话与审批。下面介绍它的定位、能力、安装方式和典型用法。
这是什么¶
全名 dsh-mutipleagent（npm 包名相同，显示名「DSH 多 Agent 办公室」），当前版本 v0.4.0，许可证 MIT。它兼容 DeepSeek Harness ^0.2.2-rc.1，插件运行环境要求 Node.js ^22.19.0 || >=24.0.0。
一句话定位：DeepSeek Harness 多 Agent 3D 协作办公室插件——在 3D 场景中观察真实主会话、子 Agent、工具活动与完整汇报。插件只读：不启动任务、不调用模型、不审批、不修改会话，也不把内容发到本机以外。数据来自 Harness 的 sessionQuery 公开接口，不读取 .codex、凭据或私有推理。
页面路由为宿主下的 /dsh-mutipleagent/，Web 与 Desktop 共用同源入口；会话接口沿用 Harness 登录校验，仅允许 owner 访问。
核心功能¶
会话页内一键打开当前办公室¶
自 v0.3.0 起，插件注册 conversation.view，在任意会话页顶部标签行增加「多 Agent 办公室」，与「对话 / 轨迹 / 上下文」并列；标签放不下时收入右侧「更多会话视图」。点开即显示当前会话的办公室，不必先选工作目录再选会话。嵌入模式用 ?mode=live&source=harness&rootId=<会话 ID>&embed=1 打开，目录选择器自动隐藏，标题显示当前会话名；切换会话或标签时 iframe 按新会话 ID 重载。
v0.3.1：打开该标签时，会话页底部输入框自动收起以腾出画面高度；嵌入模式下办公室自有顶栏（搜索、会话下拉、计时、铃铛）收起，协作统计与「Agent 详情」上移到标签页顶部，搜索与通知改用宿主自带能力。
3D 场景与协作信息¶
v0.4.0 将办公室铺满一整层：4 列 × 3 行对坐工位共 24 座，主 Agent 与第一位子 Agent 隔桌面对面；共享长桌、玻璃会议室、设备柜、书架、茶水吧与休息角等场景元素一并补齐。支持拖动旋转、滚轮缩放，点击人物或工位查看详情，点击显示器看工位屏幕详情；「隐藏面板」（工具条按钮或按 H）可只留 3D 画面，Esc 或右下角「显示面板」恢复，偏好存本地。
右侧可查看任务原文、工具活动、进展消息与汇报全文；底部时间线展示分配、追加指令、等待、汇报、完成和失败。顶部铃铛查看协作动态。无 WebGL 时仍可使用团队树、活动记录与报告。
侧栏跨项目浏览¶
侧栏入口「多 Agent 办公室」保留，用于跨项目浏览：先选工作目录，再选具体会话。下拉支持按路径、标题、时间、ID 筛选；记住上次目录与会话，「跟随新会话」仅跟随当前目录。后台会话标题最多每 30 秒刷新，观察中的团队随原有轮询更新。
性能与只读边界¶
v0.2.x 起侧重读取效率：对未变化会话复用观察租约与日志游标，减少重复折叠与 zstd 日志重读；静态资源支持 ETag / gzip，无页面连接时停止轮询。插件停用或卸载时释放路由、轮询与页面资源；构建产物与模型随包提供，不使用 CDN。
要在办公室里看到真实子 Agent，需要在 Harness 会话中实际创建子 Agent（例如通过 Task 分工）；插件本身不会替你启动并行任务。
安装与启用¶
安装前建议完全退出 Harness Desktop，装完再重启。README 中的示例版本号为 0.2.1；仓库与 npm 当前发布为 v0.4.0，升级时把命令里的版本号换成目标版本即可。
从 npm 安装¶
包已发布到 npm：
dsh plugin --profile desktop add 'dsh-mutipleagent@0.2.1' --ignore-scripts
若本机终端没有 dsh，可使用 Desktop 随附 CLI（README 以 Windows 为例）：
& 'C:\ProgramSoftware\Deepseek\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add 'dsh-mutipleagent@0.2.1' --ignore-scripts
从 GitHub 标签安装¶
完全退出 Desktop 后，用固定标签的 tarball 安装（同样可将 v0.2.1 改为目标标签，例如 v0.4.0）：
dsh plugin --profile desktop add 'dsh-mutipleagent@https://codeload.github.com/lkuliuying/dsh-mutipleagent/legacy.tar.gz/refs/tags/v0.2.1' --ignore-scripts
从本地打包安装¶
在插件源码目录构建并打包后，退出 Desktop，安装生成的 .tgz（路径按实际调整）：
npm ci
npm run build
node -e "require('node:fs').mkdirSync('.artifacts', { recursive: true })"
npm pack --pack-destination .artifacts --ignore-scripts
dsh plugin --profile desktop add "F:\Program\Multiple-Agent\.artifacts\dsh-mutipleagent-0.2.1.tgz"
启用后：在会话页顶部点「多 Agent 办公室」，或从侧栏打开。不需要单独运行办公室服务，也不需要设置 API Key。
典型用法¶
在 Harness 内观察当前会话¶
- 安装并重启 Desktop。
- 打开已有子 Agent 分工的主会话（若没有，先在对话里明确要求并行子 Agent 并等待其运行）。
- 在顶部标签点「多 Agent 办公室」，确认画面绑定当前
rootId。 - 在 3D 场景中点选成员，在右侧读任务原文与汇报；用时间线对照分配与完成顺序。
README 给出的 Codex 侧提示语示例（需在真实任务环境中自行发起，插件只观察）：
请启动两个只读子 Agent：一个检查接口契约，另一个检查测试缺口。等待它们完成，再汇总发现和建议。
演示与独立观察器（可选）¶
仓库还支持脱离 Harness 的本地只读观察：Windows 可双击 启动办公室.cmd，或运行 node src/server.js --open，默认浏览器打开 http://127.0.0.1:4317。纯前端演示页为 http://127.0.0.1:4317/demo.html；带真实数据的演示为 demo.html?mode=live。该路径面向 Codex Desktop / CLI 会话目录观察，与 Harness 插件共用同一套 3D 与 UI 思路，但 Harness 用户日常以插件标签页为主即可。
适用场景与注意¶
适合谁：需要在 DSH 里做子 Agent 编排、又想用空间化视图跟踪分工与汇报的开发者；不适合指望在本插件里下发指令、改会话或代批审批的场景。
权限与信任：插件以当前 DSH 进程权限运行，能读到的范围与会话 owner 规则一致。安装前应查看 源码仓库 与 MIT 许可证，自行判断是否纳入工作环境。
生态说明：DeepSeek Harness 奉行「一切皆插件」；SkillHub 目录页 是社区收录站点，与 DeepSeek / 幻方无官方从属关系，不等同于官方应用商店。
版本信息：变更细节见仓库 CHANGELOG.md 与 GitHub Releases。仓库 README 安装示例仍写 0.2.1，与 package.json 中 0.4.0 并存时，以你显式指定的安装版本为准。
结尾¶
dsh-mutipleagent 把多 Agent 协作从线性日志里「抽」成可巡视的 3D 办公室，并严格限定为只读观察，降低理解并行任务时的切换成本。目录与文档入口：
