dsh-collab（中文）

English · 中文

非 DeepSeek 官方项目：这是社区插件，与 DeepSeek 官方无隶属、无背书关系。 DSH 商标归其所有者。

把多个 AI 会话变成一个小而可审计的团队：工单、交接、文件记忆。

---

要解决的问题

在一个工作区里同时跑多个 AI 会话，看起来很美，直到：

• 换会话就失忆——压缩或切换后，它忘了自己在干什么。
• 各写各的——互相覆盖、格式漂移，没人知道哪份是真源。
• 过程不可见——“派了”和“做完了”之间什么都没有：没进度、没接单、没证据，也不知道谁卡住。
• 静默停摆——一个会话在等另一个，没人被叫醒。

dsh-collab 把这种靠聊天的协作，变成显式、落文件、可追踪的流程。

三个支柱

支柱	含义
记忆在文件里，不在上下文里	每个会话有身份卡、状态摘要、按日期的记忆和索引；新会话几秒就能接上。
写入走工具	AI 只调 wb_read / wb_write，不直接改状态文件；每次写入都校验（必须带来源、体量上限、只写自己目录），派生文件自动刷新。
协作靠工单	派单 → 转交 → 回执；一单到底，记录每棒耗时、证据路径，看板显示每单卡在哪。

---

功能

1. 工单（核心）

• 一任务一单：复合需求（实现+测试+文档）建一张单，用 flow 接力；同任务哈希在未关闭前不能重复建单。
• 按日单号：dhNNN 每天从 1 开始（collab/YYYY-MM-DD/dh001-<assignee>.md）；跨日引用写 YYYY-MM-DD/dhNNN。
• 按 flow 接力：主负责人决定哪些部分归谁；每一棒先 ack、再干活、然后 handoff 给下一棒；交接会自动唤醒下一棒。
• 接管自动：下一棒第一次 progress 即记为接管，不用额外调用。
• 防跳步：非最后一棒不能 close——插件会把它转成交接并警告；最后一棒负责交回主负责人。
• 主负责人验收：verify / reject 带证据；关单写回执给主负责人；assignee 忘了写记忆时自动补一条；summary 投影同步更新。
• 单内评论：comment 把补充、催办、讨论留在同一张单里，不另开单。
• 证据纪律：submit / handoff / verify / close 必须带 refs；refs 会校验存在性、可读性、.. 穿越与大小（≤ 20 MB）。
• 完成索引：collab/done-index.md 按日期分段列出完成/取消的单（时间/单号/标题/负责人/状态/路径）。
• 工单指标：每棒的开始/提交/交接/验收/关单时间、耗时、交接次数与总时长，均由事件推导。

2. 记忆

• 每个会话的文件：agents/<id>/card.json（身份/职责/边界/技能）、summary.md（在做/下一步/卡点/指针）、memory/<日期>/*.md（带来源的结论）。
• 自动投影：wb_write(note) 追加按日期的结论，重算 summary.md，并把 memory/INDEX.md 维护成紧凑时间线（≤ 120 行，更早按月折叠）。
• 体量纪律与轮转：单文件约 2 KB 上限；超出轮转到 .detail*.md，内容不丢。
• 会话时间线：sessions.jsonl 记录 entry / handover / accept / end（ISO 本地时间），可审计谁何时接手。
• 交接：重绑会话时生成接力摘要（card + summary + 最近记忆 + 在途单），给新会话发 seed，旧会话改名为 名字（已交接 MM-DD HH:mm）。
• 入场 seed：任何绑定（新建/选已有/交接）都发短 seed：读卡与摘要、看板、无单即回、有实质工作才写回。

3. 会话生命周期

• 三态：在用（已绑定）/ 待处理（无会话）/ 已归档（停用）——归档默认折叠，不挤占分组。
• 交接 / 解绑 / 归档 / 恢复 / 回收 / 导出快照。
• 回收站（dataRoot/trash）：按条目勾选、右键打开、清空需二次确认。
• 自动建技能：创建会话时未选技能会自动创建并绑定基础 SKILL.md；设置页支持编辑技能。
• 模板可覆盖：<dataRoot>/shared/templates/{seed.md,dispatch.md}。

4. 看板

• 实时面板（/plugins/workbench-core/board）：会话数、在途单、今日完成、事件流、学习卡。
• 工单面板 + 详情抽屉：点开任意单看完整链路——flow 各棒、当前负责人、下一棒、每棒耗时与事件时间线（含证据路径）。
• 会话表：每会话的在做/下一步/卡点/在途单，点开看摘要抽屉。
• 主题：auto / 深色 / 浅色，配置持久化。
• 语言：中/英 UI、事件标签、状态与日期格式（缺翻译回落中文）。
• 筛选：事件类型筛选；历史事件聚合/限量，保证页面快。

5. 可靠性与安全

• 证据安全：refs 按工作区/会话 cwd 解析，拒绝 .. 穿越、不可读与超大文件，违规记入 violations.jsonl。
• 唤醒可靠：wake 失败退避重试 + outbox；宿主会话 API 不可用时明确降级。
• stale 检测：投递后窗口内无 ack/进度 → 标 stale、通知负责人、并再唤醒接单方一次。
• 幂等：重复 handoff / ack / receipt 去重。
• 模式迁移：config/registry 带 schemaVersion，启动时幂等迁移（失败可回滚）；manifest.json 做 SHA-256 校验。
• 自检：/ops/selfcheck 校验路由、数据根、配置、索引一致性、模板、技能、运行版本 vs 磁盘——不依赖任何外壳脚本，独立 DSH 可用。
• 警告而非静默失败：越界写入、必填项缺失、非法动作都返回可读 warning 并记录。

6. 学习（零 AI，可关闭）

• 信号采集：只收异常——拒绝、stale、违规、中断、用户显式反馈。
• 失败分类：优先按 rule_id（缺证据/越权写/身份错/交接/超时），关键词兜底。
• 周报（_meta/learn/weekly.md）：返工率、stale 率、单均时长、主要失败模式、调整台账。
• 看板学习卡：当前版本信号 + 历史信号（仅参考）。
• 受控自动调优：先候选（样本 ≥3 且占比 ≥30%）→ 7 天观察期 → 才注入；只改插件默认值，每周 ≤3 项，带版本、可回退；不碰宪法与用户规则。
• 一键反馈：单卡片/抽屉可标“顺利 / 卡住 / 有问题”，进入同一学习闭环。

7. 开发与可移植

• 不需要外壳：独立 DSH profile 配 config.dataRoot、重启即可用。
• HTTP API：UI 用到的能力都有接口（看板数据、会话、工单、运维、自检、i18n、配置）。
• 模板与 i18n 数据驱动：改文案不用改逻辑。
• 测试：46 套脚本测试，覆盖协议、看板、学习、迁移、外部 profile 验收。

---

快速开始

# 你的 DSH profile 的 cordis.patch.yml
- insert:
    - id: workbench-core
      name: '@sessionhive/dsh-collab'
      config:
        dataRoot: '/你的/.dsh/绝对路径'   # 协作数据落在这里

# 方式 1（推荐）：从 npm 安装
npm install @sessionhive/dsh-collab
# 方式 2：解压 release 里的 tgz 到 profile 的 node_modules
tar -xzf sessionhive-dsh-collab-0.1.0.tgz --strip-components=1 \
  -C <profile>/node_modules/@sessionhive/dsh-collab

重启 DSH → 设置 → 会话协作。

1. 建 2~3 个会话（如 命令 / 后端 / 测试），放进同一个分组。
2. 给“命令”发一句：“用 Go 写个小接口，测试一下，测试报告给我。”
3. 看单子跑：派单 → ack → 转交 → 测试 → 转交 → 验收 → 完成。

30 秒理解

1. 主负责人：谁接到需求谁负责，判断哪些自己做、哪些派出去（一单 flow）。
2. 接力：flow 里每一棒先 ack、再干活、然后 handoff；下一棒自动被唤醒。
3. 回执与验收：最后一棒交回主负责人；主负责人核证据（不重跑全套）、关单、交付。
4. 记忆：结论落日期文件，summary/INDEX 是派生文件；新会话读三个文件就能继续。

工具面

工具	动作
wb_read	check（三项检查）/ scene（卡+摘要+记忆）/ order（单+事件+时间线）/ board / search
wb_write	note / progress / comment / task / submit / verify / reject / handoff / close / cancel / reopen

配置（_meta/config.json）

键	默认	说明
dataRoot	—	协作数据根（与 harness 安装目录无关）
inject	auto	是否把核心宪法注入 AGENTS.md（auto/on/off）
seedOnCreate	true	新建会话时是否发 seed
enginePort	自动	手动覆盖本地引擎端口（看板链接）
token.warn / token.context	60k / 120k	上下文阈值（提醒/交接）
notice.enabled	false	超时自动催办
learn.autoApply	true	允许受控自动调优插件默认值
theme / lang	auto / zh	看板主题 / UI 语言

数据目录

<dataRoot>/
├─ agents/<会话>/          card.json、summary.md、memory/<日期>/、sessions.jsonl
├─ collab/<日期>/          工单（dhNNN-*.md / .done.md / .cancelled.md）、done-index.md
├─ events/                 events.jsonl、violations.jsonl、plugin.log
├─ _meta/                  config.json、registry.json、learn/、logs/
├─ shared/                 全局规则、playbooks、模板覆盖
├─ board/                  离线看板页
├─ skills/<会话>/          SKILL.md
└─ trash/                  回收站

常见问题

• 看板数据旧 → 先看 /ops/selfcheck；插件在引擎启动时加载，升级后需重启。
• 单子一直“等待” → 接单方没 ack；stale 窗口后负责人会收到通知，接单方会被再唤醒一次。
• 关单被拒：证据不可达 → 修 refs（相对路径按工作区解析，建议用绝对路径）后重试。
• 会话被 host 归档 → 在设置页重新绑定/交接；归档是冻结不是删除。
• 外部 DSH 没有外壳脚本 → 插件自检、看板、工具都是自包含的；只有可选的“一键自检”包装依赖工作台。

明确不做

• 不是 DeepSeek 官方产品。
• 不自动切换会话、不跑后台 AI 循环、不自动改宪法/用户规则。
• 暂无向量检索、多用户权限模型、新手引导。

路线

• 0.1.x：稳定性、外部验收、文档。
• 之后：更丰富的看板分析、可配置策略、英文优先文档、1.0 冻结文件格式。

在 DSH 插件市场里发现

本仓库自带一份格式 1 的市场索引：market/index.json（已用官方 @deepseek-ai/dsh-plugin-market-index 校验）。

在 DSH 的 插件 → Discover 里「添加市场索引」，填入：

https://cdn.jsdelivr.net/gh/sessionhive/dsh-collab@main/market/index.json

之后即可在 Discover 中看到 dsh-collab 并一键安装（npm 源，或 git 源锁定提交）。

备用 raw 地址：https://raw.githubusercontent.com/sessionhive/dsh-collab/main/market/index.json

贡献

欢迎 issue 与小型 PR：见 CONTRIBUTING.md。

许可

MIT