DSH｜dsh-agent-team｜给 DSH 一个可长期协作的持久 Agent 团队

[wowyuarm]

非官方项目，由社区独立开发和维护；非 DeepSeek 官方产品、审核或背书。

项目地址

https://github.com/wowyuarm/dsh-agent-team

它和 DSH 如何配合

dsh-agent-team 是通过 dsh plugin add 安装的 opt-in DeepSeek Harness bundle。安装后从 DSH 导航进入 Team mode；普通 DSH Session、默认 preset 和原生 subagent 工作流保持不变。

它面向 human-in-the-loop 的持续协作管理：由 human 组织角色、频道和任务，让多个 Agent 围绕同一条 Task Thread 推进。它不是自动 DAG / plan 执行器，也不替代原生 subagent。

核心想法

• Agent 是 Team 的一等单位，不只是会话。 每个 Agent 成员有自己的记忆与职责边界，以及私有空间——memory、notes 与 skills 单独维护；同时所有 Agent 在同一个共享项目 Workspace 下协作，多 Workspace 可管理多支 Team。
• Workspace 组织一切。 不同项目放在不同 Workspace，各自管理自己的 Agents 与 Channels。
• Human 管 Channel 与职责。 你决定谁在哪个频道、负责什么；@提及把工作路由到对的 Agent。
• Task Thread 串联推进。 用 Task 认领方向、Thread 保持上下文，多个 Session Agent 围绕同一条工作线推进而不散乱。工作事实落在同一条 Thread 里，成员之间不会各说各的。
• 无需操心上下文。 上下文由成员自己管理：刷新到新上下文继续待命（context_rollover），或回到过去的锚点继续（context_timeline / context_checkpoint），切换与重启都不丢待决事项；memory 与 notes 持续沉淀，成员带着完整记忆进入新上下文。

Team mode 一览

安装后普通 DSH 页面保持原样，Team mode 是侧栏底部多出的一个入口：

进入后是频道、受管 Agent 与协作时间线：

对 human 的价值：有序地管理任务，把 agents 用成真正的协作成员，而不是一堆平行开立的会话。

安装

已认证 DSH 0.1.1-rc.2：

dsh plugin --profile web add @wowyuarm/dsh-agent-team
dsh web

安装后在 DSH 导航进入 Team mode 即可开始。

• npm: https://www.npmjs.com/package/@wowyuarm/dsh-agent-team
• 反馈与问题：https://github.com/wowyuarm/dsh-agent-team/issues

本帖维护项目定位、安装和使用入口；版本更新记录见评论区。

EN: dsh-agent-team is an unofficial, community-maintained opt-in DeepSeek Harness bundle for human-managed collaboration. It provides durable Workspaces, Channels, Threads, Tasks, and managed Agent members — first-class units of the team, each with its own private space (memory, notes, and skills) while collaborating in one shared project Workspace, with multiple Workspaces managing multiple teams — sharing one durable Thread per line of work so members never talk past each other, with members managing their own context (rolling over to a fresh one or returning to a past checkpoint, with memory and notes persisting across generations), while leaving ordinary Sessions, default presets, and native subagent workflows unchanged.

[wowyuarm]

实际使用：我们怎么用自己的团队造这个插件

dsh-agent-team 的 0.1.x 就是由一个 agent 团队开发出来的——这不是宣传语，下面两张图就是我们的日常工作区（近期界面实拍）：

图 1：# Main Channel 全景。 侧边栏是频道列表与在线 Agent 成员；Main Channel 的消息串着 Task 引用——Thread-first 协作从这里开始。

图 2：一条 Task Thread 的内部。 Claim 认领、Agent 交接、Human 验收活动与后续回复都保留在同一条可回读的上下文里——多个 session agent 围绕同一条工作线推进而不散乱，靠的就是这个。

human 管理 Channel 与职责、Task Thread 串联多个 session agent——这套定位我们自己每天都在用。截图随版本更新，发版记录见下方评论区。

EN: dsh-agent-team 0.1.x is built by an agent team itself. Image 1: the Main Channel with the agent roster and Task references; Image 2: a Task Thread keeping a Claim, agent handoffs, Human acceptance, and follow-up replies in one durable context.

[wowyuarm]

版本历史（v0.1.1 – v0.1.8）

最新版本单独发一条评论，历史版本合并在这里，倒序排列。完整变更见各版 Release 页与 CHANGELOG。

• v0.1.8（2026-09-05）新增两档建议性提醒（连续 20/40/60… 次工具调用未在 Thread 汇报时提醒一次；跟随未 claim 的 todo Task 时建议一次 team_claim）；Team 工具与界面接受 6 位以上唯一 hex 的简写 ref；Thread 提及候选 follower 优先；成员会话改回原装输入框（Team 提示条与 /compact、@成员 入口移除）。
• v0.1.7（2026-09-04）修复与 DSH 0.1.2-rc.1 组合后无法启动的问题，认证基线移到 rc.1（对 0.1.1-rc.2 是硬切换，需同时升级 @deepseek-ai/dsh）；补齐四个缺失的 peer 声明；成员会话改用完整原装输入框；/compact 支持整行输入；成员与 Channel 支持 archive（suspend 与 remove 之间的可逆第三态）。
• v0.1.6（2026-09-02）成员 runtime 第一阶段：持久化的 per-member capabilities、per-member 工具策略、成员私有 skills；bundled member-skill-manager 指导成员维护自己的私有 skill；成员间 DM；Thread 更新自动已读。
• v0.1.5（2026-08-31）成员会话可原地「从新上下文启动」（保留 Agent 身份）；压缩前提示成员先落笔关键结论；composer 支持粘贴文件、@all 展开、Tab 接受候选；侧栏折叠状态按浏览器持久化；文档全面双语化。
• v0.1.4（2026-08-30）Thread-first 协作：可先开无 Task 的普通 Thread，工作成型后再提升为 Task；长消息展开与 Thread/Channel 版式改进；Human 可重启不可用的 Agent 成员。
• v0.1.3（2026-08-29）Human 可直接编辑成员会话并发消息；已验收 Task 的成员上下文在超过阈值时自动压缩（不写入 ledger）；成员恢复连续三次失败后停止；Task ref 稳定格式化与 inline mention 渲染。
• v0.1.2（2026-08-27）Human 回帖支持本地附件；Task ref 解析为编号并可跨 Channel 跳转；Human 可在 Claim 尚未完成时提前验收 Task；Channel 与成员顺序按浏览器保存。
• v0.1.1（2026-08-26）composer 附件上传与缩略图预览；成员恢复（行菜单 resume/restart + 自动恢复，反复失败后停手）；per-member 推理力度与模型选择一起固定；Agent 与 Channel 创建表单简化。
• v0.1.0（2026-08-24）首个版本：单主机持久 Agent Team（Workspaces / Channels / Messages / Tasks / Threads / Claims + append-only 操作 ledger）、Human 控制用的 Web Client、隔离的 team-member preset 与五个模型侧工具、pull-based 协作协议。认证基线 DSH 0.1.1-rc.2。

EN: Version history for v0.1.1 – v0.1.8, newest first — the current release stays in its own comment below. Highlights: two advisory member reminders (progress reporting, team_claim suggestion), abbreviated refs, follower-first mention ranking, and the shipped composer for member sessions (0.1.8), rc.1 baseline hard cut and the shipped composer for member sessions (0.1.7), member runtime with per-member capabilities/tool policy/private skills and member DMs (0.1.6), in-place new-context restart and pre-compaction persistence hints (0.1.5), thread-first collaboration with promote-to-Task (0.1.4), Human-editable member sessions and automatic member compaction (0.1.3), attachments on Human replies and cross-Channel Task references (0.1.2), member recovery and composer attachments (0.1.1), and the initial ledger-backed single-host Team (0.1.0). Full detail in each Release page and the CHANGELOG.

[wowyuarm]

dsh-agent-team v0.1.9

本版本汇总自 v0.1.8 以来的变更。

新增功能

• 成员可自行管理上下文：context_rollover 结束当前上下文、以同一成员身份在新上下文继续，context_checkpoint 在风险操作前记录可恢复锚点，context_timeline 查看上下文谱系（checkpoint、首次到达与 Task claim 边界按语义标注）并选择回到的锚点。
• 成员上下文不再需要被关注：接近预算时成员收到一次建议 context_rollover 的提示，达到上限时 Host 在下一次请求前强制压缩，任务不会因上下文耗尽中断。
• 上下文切换在重启或崩溃后不丢失：待决切换会安全重放，崩溃后从上次记录重建交接。
• team_view 现在列出顶级 Thread（含 revision 与消息数），成员可以发现未被提及的讨论。
• Windows 支持：附件文件名与成员记忆目录按 Windows 规则消毒（非法字符、保留设备名、尾随点与空格），旧记忆目录自动迁移；历史遗留的冒号拼写记忆目录在激活时自动并入规范路径，冲突内容以 .colon-twin 后缀留档。

体验优化

• 成员的工具结果携带更完整的决策信息：thread/inbox 行显示 channel、状态、未读/直达数与 revision，Claim 显示状态、owner 与方向。

问题修复

• 修复成员激活时偶发的会话退役竞态导致的启动失败。
• 修复离开嵌入式成员视图后底层会话未重新绑定、回复串线的问题。
• 修复提前验收通知携带空 finished-claim 子句的问题。
• 修复 rollover 待决被污染后无法恢复的问题，恢复过程会自动重试并预校验 checkpointRef。

其他变更

• 原「从新上下文启动」行操作移除，成员上下文管理完全交给成员自身与 Host 压力策略。
• CI 新增 Linux 与 Windows（Git Bash）双 lane，构建与开发脚本适配 Windows 环境。

安装 / 升级：

dsh plugin --profile web add @wowyuarm/dsh-agent-team
dsh web

要求 DeepSeek Harness 0.1.2-rc.1 或更高（<0.2.0）。

• npm: https://www.npmjs.com/package/@wowyuarm/dsh-agent-team
• Release: https://github.com/wowyuarm/dsh-agent-team/releases/tag/v0.1.9

EN: v0.1.9 lets members manage their own context (context_rollover / context_checkpoint / context_timeline, with the Host enforcing the pressure budget and compaction at the hard limit), makes context switches survive restarts and crashes, adds Windows support (Win32 sanitization of attachment and member-memory-directory names plus migration of legacy directories), and lets team_view enumerate top-level Threads. Requires DSH 0.1.2-rc.1 or newer.