dsh-collab

dsh-collab（中文）

[English](README.en.md) · 中文

> 非 DeepSeek 官方项目：这是社区插件，与 DeepSeek 官方无隶属、无背书关系。

> DSH 商标归其所有者。

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

---

要解决的问题

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

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

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

三个支柱

| 支柱 | 含义 |

|---|---|

| 记忆在文件里，不在上下文里 | 每个会话有身份卡、状态摘要、按日期的记忆和索引；新会话几秒就能接上。 |

| 写入走工具 | AI 只调 wb_read / wb_write，不直接改状态文件；每次写入都校验（必须带来源、体量上限、只写自己目录），派生文件自动刷新。 |

| 协作靠工单 | 派单 → 转交 → 回执；一单到底，记录每棒耗时、证据路径，看板显示每单卡在哪。 |

---

功能

1. 工单（核心）

• 一任务一单：复合需求（实现+测试+文档）建一张单，用 flow 接力；同任务哈希在未关闭前不能重复建单。
• 按日单号：dhNNN 每天从 1 开始（collab/YYYY-MM-DD/dh001-.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//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；设置页支持编辑技能。
• 模板可覆盖：/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 /node_modules/@sessionhive/dsh-collab

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

1. 建 2~3 个会话（如 命令 / 后端 / 测试），放进同一个分组。

2. 给“命令”发一句：“用 Go 写个小接口，测试一下，测试报告给我。”

3. 看单子跑：派单 → ack → 转交 → 测试 → 转交 → 验收 → 完成。

30 秒理解

1. 主负责人：谁接到需求谁负责，判断哪些自己做、哪些派出去（一单 flow）。

2. 接力：flow 里每一棒先 ack、再干活、然后 handoff；下一棒自动被唤醒。

3. 回执与验收：最后一棒交回主负责人；主负责人核证据（不重跑全套）、关单、交付。

4. 记忆：结论落日期文件，summary/INDEX 是派生文件；新会话读三个文件就能继续。

工具面

| 工具 | 动作 |