前言¶
在 DSH（DeepSeek Harness）里做跨度较长的科研，常见做法是同一聊天里反复切换文献、实现、实验和写作，上下文越堆越长，证据链和角色边界也容易糊在一起。Research Team Mode 是维护者 ZhanRuiXin 发布的 profile 级 DSH bundle（npm 包名 dsh-research-team-preset），把一次会话组织成带 Lead 与专职成员的小队：Lead 规划任务、维护看板与用户门禁、分派工作并汇总结果；默认八种角色覆盖咨询、文献、数据、设计、实现、运行、独立复核与论文写作。分类上属于工作流类插件；GitHub 仓库当前约 1 star。下文介绍其定位、能力、安装与首轮用法，事实以 GitHub README 为准。
这是什么¶
一句话：A DSH agent preset that turns one session into a small, coordinated research team.
- 名称：
dsh-research-team-preset（社区目录页：SkillHub 插件页） - 版本：0.1.1（README 标注更新于 2026-11-10）
- 许可证：MIT
- 维护者：Ruixin Zhan（ZhanRuiXin）
- 运行环境：Node.js
>=22；面向 DSH0.2.x（README 写明针对0.2.1-rc.5开发，其他版本可能可用但不保证）
该 preset 不是一次性问答模式：简单问题由 Lead 直接回答，实质性科研才按需拉起成员。
核心功能¶
默认角色与分工¶
README 中的 At a glance 表列出 8 个默认角色：advisor、designer、researcher、data、builder、runner、reviewer、writer。Lead 只为任务实际需要的角色建员，而不是固定满编出动。
门禁式工作流¶
内部步骤走 team_task_*；面向用户的节点落在看板卡片上。流程大致为：创建、认领、执行、汇报、复核、用户验收。卡片进入 in_review 后，agent 侧停止推进；只有用户才能把卡片标为 done。
连续性与工作日志¶
每个项目在根目录维护一套 worklog：worklog/PLAN.md、INDEX.md，以及每个门禁卡片对应的 bounded 文件。恢复会话时先读 PLAN 与 INDEX，再结合当前卡片状态块；看板与 git 跨会话携带状态。有实质工作时由 agent 初始化 git；破坏性变更走分支，验收通过后再合并。
模型路由¶
各角色可在 Plugins 页设置表单中分别配置 provider、model 与 reasoning effort。
运行时¶
README 写明使用 PTC（run_code + 生成的 SDK），每个成员一层 subagent。
Lead 与用户的沟通方式¶
Lead 的回复按科学沟通组织：先给出结论或结果，再附证据（如 run id、数据集、带不确定性与样本量的指标、来源），说明不确定处与用户需决策项。陈述会区分 observed fact、inference、hypothesis、open question。内部交接、重试、工具错误与看板簿记默认不对外刷屏，除非影响结果解读或阻塞决策。
可选集成（非硬依赖）¶
preset 单独可跑，不会替你安装下列第三方插件：
| 集成 | 作用（缺省时） |
|---|---|
dsh-taskboard |
taskboard_*、用户可见卡片与验收清单；无则用 worklog 作持久记录 |
dsh-zotero |
zotero_* 与论文抓取导入；无则走 Semantic Scholar、arXiv 与 Web，证据表仍记 claim、source、location |
dsh-mnemon |
mnemon_* 跨会话笔记；无则靠 worklog 与 CHANGELOG.md |
依赖与启用顺序¶
Research Team Mode 是 profile 级 bundle：它不会自动安装或启用所依赖的其它 bundle；DSH 包安装器处理 npm 依赖，不代替功能 bundle。请在同一 profile 里先启用依赖，再安装本 preset。
| 能力 | 提供方 | 说明 |
|---|---|---|
| DSH | DeepSeek Harness 0.2.x |
见上 |
| Agent Teams | @deepseek-ai/dsh-experimental-agent-team-profile |
spawn_teammate、send_message、wait_agent、interrupt_agent、team_task_* 与 Team 服务 |
| PTC runtime | @deepseek-ai/dsh-agent-tool-presentation、@deepseek-ai/dsh-ptc-runtime-node |
DSH 基础能力，run_code |
若缺依赖，模式可能部分加载，但团队工具、看板或设置页会不可用；插件管理器不会提示这些 bundle，也不会自动关联。
安装与启用¶
安装前请自行阅读仓库源码与 LICENSE，并确认本机 DSH 进程权限与网络策略。插件与 agent 以当前 DSH 进程权限执行工具与写文件。
图形界面（Settings → Plugins）¶
- 在目标 profile 启用 Agent Teams（
@deepseek-ai/dsh-experimental-agent-team-profile）；可选集成可稍后添加。 - 打开 Settings → Plugins，点击 Add。
- 粘贴安装说明符之一：
- npm：dsh-research-team-preset@0.1.1
- 固定 Git 源：github:ZhanRuiXin/dsh-research-team-preset#v0.1.1
- 本地链接：link:/absolute/path/to/dsh-research-team-preset - 重启 DSH。preset 行与 bundle 客户端半部在启动时加载。
- 在同一 profile 确认 bundle 已启用，新开 session，在模式选择器选 Research Team Mode。
CLI¶
官方 README 给出的命令为：
dsh plugin add dsh-research-team-preset@0.1.1
固定 Git 源而非 registry 时：
dsh plugin add github:ZhanRuiXin/dsh-research-team-preset#v0.1.1
若使用 task board 的执行会话，创建卡片时设 presetId=research-team，使执行会话使用同一 persona 与工具集。
在某一 profile 安装不会自动作用于其它 profile；每个 profile 需重复 prerequisite 与安装步骤。
典型用法¶
开工前自检¶
README First run 建议先让 Lead 检查环境与看板，再进入实质工作。可向 Lead 发送或让其执行语义对应的检查（示例自 README）：
list_agents # create only the roles the task needs
research_project # resolve the current project/workspaceId
taskboard_list # check existing cards in this project
任务表述¶
README First run 中的典型首轮任务与协作链如下：
User: "Survey the literature on X, implement the baseline, and draft the method section."
Lead: research_project -> taskboard_create only at user gates -> team_task_create -> send_message
Members: team_task_update (claim) -> work -> complete + send_message; gated steps also claim the card
Reviewer: independent PASS/FAIL with evidence
Lead: summarize -> user acceptance (done)
用户设定科学方向并评判证据，团队承担检索、实现、实验与验证；重要节点须用户在看板上验收后卡片才可进入 done。
适用场景与注意¶
适合：
- 文献、实现、实验与论文产出组合的科研课题；
- 需要从 claim 追溯到来源、运行记录或日志的证据链；
- 希望有 advisor 与独立 reviewer，而不是单一通用 agent；
- 最终验收必须由用户拍板，而非 agent 自行结案。
不适合： 快速事实问答、单文件小改、一次回答即可的任务；此类需求 Lead 会直接回答而不动员全队。
安全与运维： 安装任意 DSH 插件前建议审阅源码与许可证；运行时代码生成、子 agent、git 与外部 API 均受本机 DSH 配置与权限约束。社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系，勿当作官方应用商店。
结尾¶
dsh-research-team-preset 把 DSH 的 Agent Teams 能力收成一种「科研小队」preset：门禁式看板、分角色模型路由、worklog 与 git 跨会话续作，面向周级别的可追踪科研而非单次聊天。进一步细节见 GitHub 仓库 与 SkillHub 目录页。
