dsh-agent-lines

dsh-agent-lines

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

GitHub: [Lencen/dsh-agent-lines](https://github.com/Lencen/dsh-agent-lines)

> DeepSeek Harness 社区插件，不是 DeepSeek 官方产品。

> 100% Vibe Coding。 架构、代码、测试、文档都在 AI agent 会话中完成。它是实验性项目：生产使用前请审阅代码并跑一遍集成测试。

DSH 的 super agent 平替插件。

你不用每次新开会话、手动把背景复制给几个 agent。让一个负责人 agent 带一支长期协作的团队：每个成员有名字、各负责一块，任务和消息不会丢，结果由负责人汇总给你。

Quick Context（给 AI 助手）

> 这一段是给 AI 读的结构化上下文：把本插件粘给 AI 让它安排团队时，先让它读这里，能少猜、少幻觉。人类读者可跳过。

• 运行环境：DeepSeek Harness (DSH) 社区插件，运行在 DSH Host 进程内，不是独立应用、不是官方产品。DSH >=0.2.1-rc.5 <0.3.0；Node ^22.19.0 || >=24.0.0。
• 数据存储：本地 SQLite（默认 DSH_HOME/agent-lines/lines.db，可用配置 dbPath 或环境变量 DSH_AGENT_LINES_DB 覆盖）；网络文件系统会被拒绝。
• 核心实体：Manager Line（createFrom 指定的负责人线）/ Worker Line（成员线）；每条线 = label（稳定名字） + sessionId（可替换会话） + 租约。
• 关键约束：只有 createFrom 线（且 allowCreate: true）能调用 line_create；worker profile 不要开 allowCreate；一个 Session 同时只有一个 writer；不要在另一个 DSH 进程打开线 Session（会 session/writer-held）。
• 零配置行为：未绑定根会话可调用 line_claim_manager({ confirm: "bind-manager" }) 自行绑定（需 allowClaim: true，零配置下默认开启）。
• 投递语义：至少一次；幂等权威是 DSH 的 requestId；失败态可查可救（line_messages / line_trace / line_redeliver），ack 超时只报数不自动重投。
• AI 操作契约：[AGENTS.md](AGENTS.md)（配置字段、22 个工具、line_status 字段、硬性约束）；设计思想：[docs/PHILOSOPHY.md](docs/PHILOSOPHY.md)｜[网页版](https://lencen.github.io/dsh-agent-lines/philosophy.html)。

什么时候用 / 什么时候不用

| 场景 | 选 dsh-agent-lines | 不选（更适合别的方案） |

|---|---|---|

| 长期项目，不想每次重讲背景 | ✅ 每个角色有长期记忆 | ❌ 一次性小任务，用普通会话更快 |

| 多个 agent 长期固定分工（调研/开发/测试/发布） | ✅ 直接点名派任务 | ❌ 只需要一个会话里临时并发，用 DSH 官方“智能体团队”插件即可 |

| 任务做到一半要关窗口、重启还要接着做 | ✅ 消息与状态落盘 | ❌ 不需要跨重启，官方插件更轻 |

| 会话满了要换人但角色不能换 | ✅ line_handoff / line_rebind | ❌ 只要一次性的多 agent 协作 |

| 需要任务依赖管控、质量门控、任务看板 | ⚠️ 只读融合官方任务板，不自己做 DAG | ✅ 用 DSH 官方“智能体团队”插件（任务 DAG + 面板） |

| 需要跨机/多活/强隔离 | ❌ 不支持（本地 SQLite + 本地租约） | ✅ 另选分布式方案 |

两种团队长什么样

官方“智能体团队”插件

~~~text

一个 DSH 会话

└─ 会话里的若干子 agent

~~~

• 一个会话就是一个官方团队；
• 子 agent 是任务型成员：围绕任务启动，任务结束后通常释放或复用；
• 子 agent 不是长期角色，不要把它当成有长期记忆的固定成员；
• 官方团队有任务板、任务依赖、网页面板；
• 团队内可以并发处理子任务。

dsh-agent-lines

~~~text

多个 DSH 会话组成团队

├─ 负责人会话

├─ 开发角色会话

├─ 测试角色会话

└─ 校对角色会话

~~~

• 团队由会话组成，不是“一个会话里塞很多子 agent”；
• 每个会话有自己的持久记忆；
• 角色可以在自己的会话里连续做任务，也可以隔一段时间再做；
• 会话满了可以换新会话，但角色不换；
• 负责人在自己的会话里做拆解、调度、验收；
• dsh-agent-lines 自己不提供任务板。

和官方“智能体团队”插件的区别

不是替代关系，是互补关系。一句话：官方插件管“一个会话里的团队”，dsh-agent-lines 管“多个会话组成的长期团队”。

| 维度 | 官方“智能体团队”插件（实验性） | dsh-agent-lines |

|---|---|---|

| 组织单位 | 一个会话 + 会话里的子 agent | 多个 DSH 会话组成团队 |

| 成员性质 | 任务型子 agent，任务结束通常释放/复用 | 长期角色会话，可连续或不连续做任务 |

| 记忆 | 会话有记忆；团队成员子 agent 不是长期角色，换子 agent 可能丢失成员记忆 | 团队每个成员都是独立会话，有持久记忆；会话不删除，记忆不丢 |

| 任务板 | 有，一个团队一个任务板 | 没有自己的任务板 |

| 并发 | 会话内子 agent 并发 | 会话之间并行 |

| 换人 | 换会话就是换团队；会话里换子 agent 就是换成员；换子 agent 会丢成员记忆 | 换会话（交接）可以继承任务与关键记忆；历史会话记忆保留在团队里 |

| 网页面板 | 官方任务/成员面板 | 组织树 + 成员会话台 |

| 适合 | 一次性或短周期多子 agent 协作 | 长期小说、视频、研究、运营团队 |

line 的交接继承的是任务状态和关键记忆（交接单、文件），不是完整复制模型上下文。

DSH 官方“智能体团队”插件目前是实验性的；dsh-agent-lines 是社区插件，不是 DeepSeek 官方产品。

与 DSH 官方“智能体团队”插件的融合（只读，0.5.1 起；0.6.0 增部门视图）

用户只给负责人发任务。负责人自动读取官方智能体团队插件的任务和成员，按成员名字自动对应角色；不要求用户导出任务、不要求配置对应关系、不要求点插件按钮。

前提：负责人必须同时是官方智能体团队插件的负责人或成员；否则显示不可用，不降级到用户导出。

只读：不写任务、不改角色、不触发负责人回合；双向写回未批准。

融合后的三级组织

~~~~text

L1 管理线会话（用户只说目标）

└─ L2 角色线会话（长期角色、持久记忆、line 能力）

└─ L3 该角色会话里的官方智能体团队（teammate，任务型、并行、用完释放）

~~~~

• L1 管线：建线、派任务、批策略（subteamPolicy）、验收；
• L2 管活：拆解任务、决定"自己做还是开内部团队"、产出与自检、把结果回 L1；
• L3 管并行：只做被切出来的子任务/交叉验证/一次性质量点，不是长期角色；
• 记忆与交付证据在文件里；官方任务板的 owner 只能是 teammate（L1/L2 不能当 owner）。