dsh-agent-commander
多智能体总指挥插件（DeepSeek Harness 原生版） —— 让 DeepSeek 打开并指挥一个
claude / opencode / codex 智能体团队，实时看到每个智能体在做什么，通过共享记忆
与任务看板高效编排多人协作。
┌────────────────────────────────────────────┐
│ DeepSeek Harness │
│ ┌──────────────────────┐ ┌──────────────┐ │
│ │ 中间：聊天区（原生） │ │ 右侧：智能体雷达 │ │
│ │ 你 ↔ DeepSeek(总指挥) │ │ claude working│ │
│ └──────────────────────┘ │ opencode idle │ │
│ │ 点击→实时终端 │ │
│ │ ＋新建(角色+技能)│ │
│ └──────────────┘ │
└────────────────────────────────────────────┘
✨ 功能亮点
- 智能体雷达（右侧详情栏）：所有已打开的智能体列表，实时状态徽标（working /
idle / blocked / exited）、角色、工作目录；点击展开实时终端（xterm +
WebSocket + node-pty），可直接打字与智能体交互
- 工作区隔离 + 自动重检：雷达列表按当前工作区（会话工作目录）隔离；切换工作区
自动重新检测并恢复
.deepseek/agents.json 中保存的未运行智能体
- 新建智能体弹窗：选引擎（自动检测 claude / opencode / codex 是否安装）、命名、
角色定义（内置 6 个预设：数据库专家 / 设计专家 / 前端专家 / 测试专家 /
代码审查专家 / 架构师）、挂载技能（
~/.agents/skills/*）—— 角色与技能作为
开场简报自动注入并回车执行
- DeepSeek 指挥工具：
agent_open / agent_list / agent_read / agent_send /
agent_broadcast / agent_signal / agent_close，总指挥可在对话里直接开智能体、
派活、收结果
- 共享记忆协议：开智能体时自动播种
.deepseek/memory.md（长期记忆）、
.deepseek/task-board.md（任务进度）、.deepseek/experience.md（经验沉淀）、
.deepseek/handoffs/（交接文件）与 SQLite 知识库 memory.db —— 所有智能体
读写同一份，天然共享上下文
- 安全设计：路径穿越防护、请求体上限、环境变量白名单、信号白名单、
Trust fence、自动审批仅限启动阶段
📦 安装
方式一：GitHub 直接安装（推荐）
# 安装最新 main 分支
dsh plugin add github:qinglang8609/deepseek_herdr
# 或锁定到发布 tag
dsh plugin add github:qinglang8609/deepseek_herdr#v0.2.2
首次安装若提示 ERR_PNPM_IGNORED_BUILDS（node-pty 构建脚本），在 profile 目录
执行 pnpm approve-builds 放行 node-pty 即可。
方式二：tarball 安装
cd plugin && pnpm pack
dsh plugin --profile web add ./dsh-agent-commander-0.2.2.tgz
方式三：一键脚本（自动标准流程 + 回退）
bash install.sh # 默认 profile: web；优先走 dsh plugin add 标准流程
# bash install.sh --profile <name> # 指定 profile
# bash install.sh --remove # 卸载
# bash install.sh --skill-only # 只装 skill
装完重启 DeepSeek Harness 生效（插件集变更需要重启）。
🚀 快速开始
- 重启后，右侧「智能体雷达」面板自动打开（主界面右上角有悬浮「🤖 雷达」按钮可弹出/收起）
- 点「＋ 新建」→ 选引擎、写角色（如"数据库专家"）、勾选技能 → 创建
- 点击智能体行展开实时终端（xterm + WebSocket），直接打字下达指令
- 对 DeepSeek 说：
"用 agent_open 打开一个 opencode，角色定为前端专家，派它修复 xx 页面的样式问题"
- 切换工作区时，雷达会自动重新检测新文件夹的智能体列表
⚙️ 配置（Config schema）
插件导出标准 Schemastery Config schema，所有参数可在 profile 的 cordis.patch.yml 覆盖：
- id: agent-commander
config:
maxAgents: 12 # 同时打开的最大智能体数（默认 8）
transcriptLimit: 2097152 # 每个智能体转录环上限字节（默认 1048576 = 1 MiB，示例为 2 MiB）
rolePresets:
- 数据库专家
- 安全专家 # 自定义预设会出现在「新建智能体」弹窗里
memoryDir: .deepseek # 共享记忆目录名（默认 .deepseek）
allowedSignals: [SIGINT, SIGTSTP, SIGTERM]
baseCwd: /path/to/project # 无会话工作目录时的默认项目根
monitorIntervalMs: 30000 # 会话定时监控间隔（毫秒，默认 30000；0 = 关闭）
会话定时监控：服务端按 monitorIntervalMs 巡检当前工作区的会话状态
（运行中 / 启动中 / 已退出 / 空闲），仅在状态变化时经 WebSocket 推送，雷达
面板静默替换列表 —— 不弹提示、不闪 loading。面板顶部一行显示「定时监控 ·
每 30秒 巡检 · 已同步 15:04:05」。
完整字段表见 plugin/README.md。
📦 发布流程
node scripts/release.mjs patch # patch | minor | major | 显式版本号；需在 main 分支、工作区干净
node scripts/release.mjs --no-commit --allow-branch # 试跑：构建+升版本+打包，不提交不打 tag
脚本自动完成：构建 client bundle → 同步 plugin/ 与根 package.json 版本 →
pnpm pack（失败自动回退 npm pack，缓存指向 dist/ 绕开权限问题）→
git commit release: vX.Y.Z + tag → 输出发布清单（push remote + dsh plugin add github:…）。
打包产物在 dist/（已 gitignore）。
🔧 开发
plugin/
├── lib/
│ ├── index.js # node 端：Config schema + AgentRegistry(node-pty) + 共享记忆 + agent_* 工具 + WS/HTTP 路由
│ ├── session-scanner.js # 四引擎会话历史扫描（claude/opencode/codex/codebuddy）
│ ├── session-monitor.js # 会话定时监控：会话列表构建 + 按 monitorIntervalMs 巡检（变化才推送）
│ └── client.js # client bundle（构建产物，勿手改）
├── src/client/ # client 源码（app.js 雷达面板 / panel.css；vendored xterm 终端小窗）
│ └── vendor/ # 内联的 xterm + addon-fit + xterm.css
├── skill/agent-commander/skill.md # 总指挥 skill（随插件包分发，启动时自动装到 ~/.agents/skills/）
├── scripts/build-client.mjs # 组装 client.js
├── cordis.patch.yml # 激活补丁
└── package.json
templates/experience.md # 经验总结模板
install.sh # 一键安装脚本
scripts/release.mjs # 发布流程（构建+升版本+打包+commit/tag+清单）
改完 client 源码后重新构建：
ELECTRON_RUN_AS_NODE=1 "/Applications/DeepSeek Harness.app/Contents/MacOS/DeepSeek Harness" plugin/scripts/build-client.mjs
bash install.sh
node 端实现为 cordis Service 类（AgentCommanderService），其他插件只需
inject: ['agentCommander'] 即可调用其公开 API（list / open / send / read /
approve / signal / close / memory.* / scan / restore），详见
plugin/README.md。
🏷 版本历史
| 版本 | 内容 |
|---|
| v0.2.2 | （未发布）终端宿主重构：移除 herdr 三件套（herdr-adapter / herdr-registry / composite-registry）与 docs/ 两个相关设计文档、失效测试 plugin/test/herdr-e2e.mjs；宿主统一为node-pty 网页终端（xterm + WebSocket 实时输出）；雷达改两段独立展示（「运行中」= 活跃终端 /「会话历史」= 四引擎持久会话）；新增 /ws/terminal 终端流、SessionScanner(四引擎扫描) + SessionMonitor(定时巡检)；buildSessionList 历史只做 running 精确标注（未命中历史会话的运行窗口合成精确 live: 卡片，引擎写入首条消息后自动消失） |
| v0.2.1 | 修复 4 CRITICAL + 5 HIGH（渲染期 ref 副作用 / WebSocket 泄漏 / 竞态 / prompt 注入 / schema 文档不一致 / VACUUM 吞错 / resize 节流 / busy 未重置）+ 状态卡死专项（周期巡检 idle 回落）；支持 dsh plugin add github:... 直接安装 |
| v0.2.0 | 插件标准化：Config schema、tarball 标准安装、skill 随包分发、SQLite 记忆层、依赖解析兜底 |
📄 许可
详见 plugin/README.md 与插件包内文件。
