科研协作团队 Tongwu791/dsh-research-teams

dsh-research-teams

一个运行在 DeepSeek Harness (DSH) 中的动态 Cordis 插件：为一次会话装配三位持久化科研角色子代理（评审员 / 研究助理 / 代码工程师），由用户以斜杠命令驱动、逐步讨论、按需串联成流水线，并在输入框上方提供实时看板。

它解决什么问题

长期科研/工程会话里，最贵的是上下文：检索与评审、方案撰写、代码调试往往互相污染同一个上下文窗口，且任务之间需要反复“重新交代背景”。

本插件把三类工作外置给三个各自独立的续聊子代理：

- 每个角色 = 一个 durable continuable child subagent（独立会话、独立模型路由、独立上下文）；
- 角色之间不自动互相协作（避免自主串联带来的失控与费用），编排权始终在用户手里；
- 角色可以自主使用工具（fs / bash / ssh / web_search），执行过程不需逐步审批（限制在会话工作区内）；
- 完成后把完整结论回传给会话，命令卡片直接呈现。

三位角色

| 角色 | 命令 | 定位 |
| 🧐 Reviewer（评审员） | /reviewer | 检索文献、严格客观评审 idea/方案，指出逻辑漏洞、假设问题、方法学缺陷；把需要澄清的问题列在回复末尾 |
| 📝 Assistant（研究助理） | /assistant | 调研 + 完善方案 + 用 fs 落成 Markdown 文档（建议 docs/） |
| 💻 Coder（代码工程师） | /coder | 读代码、找 bug、写修复、跑验证（fs / bash / 远程 ssh） |

组合流水线（步骤之间会内联询问你是否继续）：

- /reviewer-assistant — 先评审 →（你确认）→ 助理完善并落档
- /assistant-coder — 先梳理需求与验收标准 →（你确认）→ 工程师实现

管理命令

| 命令 | 作用 |
| /team-config [effort] | 配置某角色模型路由；支持一次粘贴多行（每行一个角色） |
| /team-reset | 解绑角色子代理（下次调用按最新路由新建，即“清空该角色的记忆”） |
| /team-status | 角色状态（含实时活跃度）/ 路由 / 子代理 |
| /team-diagnose | 环境诊断：commands/subagents/sessions/fs 服务、工作区根、子代理会话可读性 |
| /team-help | 帮助 |

路由切换只在新建子代理时生效：/team-config 之后需 /team-reset ，下次调用才会用新路由。

实时看板（输入框上方）

- 每 2.5 s 自动刷新，无需反复敲 /team-status；
- 状态来自 DSH agents 注册表的真实活跃度（执行中 / 空闲 / 未创建），因此直接派单的运行同样可见；
- 点「看板 ▼」展开：角色 / 状态 / 路由 / 子代理 ID / 最近输出（悬停看全文）。

安装 / 激活

本插件是 DSH 动态 Cordis 插件（Host + Client 两半），源码即两个纯 JavaScript 函数体：

1. 在 DSH 会话中调用 cordis_define：
- kind: "new"，idPrefix: "rste"（或任意 3–6 字母语义前缀）
- code.host = host.js 的内容，code.client = client.js 的内容
2. 用返回的 pluginId/packageId 调 cordis_run 激活；Client 半在浏览器侧装载（首次可能需要在页面上确认授权）。
3. 激活后输入 /team-help 查看命令，输入框上方出现状态条。

也可以把 Host 半作为一行插件挂进 Host composition（共享给多会话）；但这属于 harness 组合层面的改动，请遵循 DSH 的 agent preset / composition 规则。

数据与状态

- 角色绑定与最近输出落在 /.dsh-research-teams/state.json（由插件自行读写，不会越出工作区）；
- 子代理会话由 DSH 的 subagents 服务持久化，/team-reset 只解绑，不删除历史。

实现要点（踩过的坑）

这些是让插件在真实 DSH 会话里稳定可用的关键设计，欢迎借鉴：

1. 子代理如何“回报”：子代理 settle 后其活动会话会被释放，sessions.get(childId) 轮询收不到收尾内容。正确做法是监听父会话收到的 subagent-settled / subagent-report 通知（source.senderSessionId === childId），并从 "Its closing message:" 之后取正文；同时以投递前的 events.length 作为扫描起点，避免命中历史通知。
2. 禁用交互式提问：子代理会话没有人类应答者，ask_user_question 会永久阻塞回合 → 创建子代理时用 toolFilter: { deny: ['ask_user_question'] }（注意 tools.restrict 对不存在的工具名会响亮拒绝），并在 persona 中要求“把澄清问题写在回复末尾”。
3. 定时器：动态插件沙箱没有 Node 原生 setTimeout，轮询需使用 cordis timer 服务（inject: ['timer'] + ctx.timeout(ms)）。
4. 文件系统边界：fs 写入需带上会话沙箱策略（sandboxPolicy.resolve({ session })），否则会被工作区外写入拒绝。
5. 工作区根：从 inv.agent.session.header.cwd 解析（不是 meta）。
6. 路由健壮性：provider/model 不允许多行粘贴污染（校验含 / 与空白），并在创建子代理前快速失败。
7. 活跃度：Client 看板的“执行中”取自 ctx.get('agents').get(childId)?.status，而不是插件自己维护的 busy 标志。

版本一览（演进摘要）

| 版本 | 关键变化 |
| v1–v12 | 早期手写工具循环实现（自建 LLM 调用/工具调度），逐步修复消息契约、工具透出、沙箱策略、工作区解析等 |
| v13 | 重构为 DSH 原生续聊子代理（subagents.startContinuable + followup），插件不再自己跑模型循环 |
| v14–v16 | 路由校验与多行粘贴、状态加载竞态、cordis timer 迁移 |
| v17–v18 | 子代理阻塞修复：toolFilter 禁用 ask_user_question |
| v19–v20 | 回报机制修复：改监听父会话 settle 通知 + eventsStart 起点扫描（解决“等待子代理回报超时”） |
| v21 | 实时活跃度 + 可展开看板（本文档上半部分所述形态） |

兼容性

- 需要 DSH 提供 commands / subagents / sessions / agents / fs / timer / userQuestions 服务与 conversation.input.dock 插槽；
- 在 DSH Web GUI（dsh web，默认 http://127.0.0.1:3080）下开发与验证；最后更新：2026-09。

许可

MIT License，见 LICENSE。

免责声明

本项目按“现状”提供；插件会驱动子代理在工作区内读写文件、执行命令。请在受控环境与已知工作区内使用，并自行审阅子代理的产出。