dsh-agent-lines 0.3.8 → 0.4.0

package/CHANGELOG.en.md

@@ -2,6 +2,21 @@
 
 English | [中文](CHANGELOG.md)
 
+## 0.4.0 (2026-11-09)
+
+- Message governance: line_send adds kind (info/request/task/alert) and ccManager; a non-manager task becomes pending_approval and is delivered only after line_manager_ack.
+- Schema v8: messages.kind/cc_manager/approval_state/approved_by/approved_at; additive migration.
+- Added line_manager_ack (approve/reject).
+- line_observe shows kind/ccManager/approvalState; pending tasks do not enter the target inbox.
+- README is team-agnostic; GitHub Pages is rewritten for beginners (DSH-assisted install, novel/video/dev scenarios, restart handoff card).
+
+## 0.3.9 (2026-11-09)
+
+- Added read-only line_observe: a manager feed of cross-line messages without prompts or state changes.
+- Added CLI observe --json.
+- README now documents version-by-version business scenarios; fixed line_handoff version (0.3.7).
+- No schema change; line_send semantics unchanged.
+
 ## 0.3.8 (2026-11-09)
 
 - line_status / line_list expose activity: turns/steps/decodeTokens/level/lastActivityAt.

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 [English](CHANGELOG.en.md) | 中文
 
+## 0.4.0 (2026-11-09)
+
+- 消息治理：line_send 新增 kind（info/request/task/alert）、ccManager；非管理线发 task 进入 pending_approval，需 line_manager_ack 审批后才投递。
+- schema v8：messages.kind/cc_manager/approval_state/approved_by/approved_at；additive 迁移。
+- 新增 line_manager_ack（approve/reject）。
+- line_observe 展示 kind/ccManager/approvalState；待审批任务不进目标线 inbox。
+- README 团队类型通用化；GitHub Pages 面向小白改版（安装交给 DSH、小说/视频/开发场景、重启前交接卡）。
+
+## 0.3.9 (2026-11-09)
+
+- 新增只读 line_observe：管理线查看跨线消息 feed，不注入 prompt、不改消息状态。
+- CLI 新增 observe --json。
+- README 补“版本能力与业务场景”，修正 line_handoff 的版本标注（0.3.7）。
+- 无 schema 变化，line_send 语义不变。
+
 ## 0.3.8 (2026-11-09)
 
 - line_status / line_list 增加 activity：turns/steps/decodeTokens/level/lastActivityAt。

package/README.en.md

@@ -23,6 +23,44 @@ Use it when:
 - You want one lead agent to decompose work, create the team, track progress, collect results, and report back.
 
 
+## Any team type, not just development
+
+The plugin does not limit team types. It is "one manager + several long-lived members".
+The examples below use a development team; novel, video, research, or operations teams only change roles and tasks.
+
+- Novel: editor-in-chief, outline, writer, editor, proofreader, reviewer;
+- Video: manager, planning, script, editing, cover, publishing;
+- Development: manager, developer, tester, acceptance;
+- Research: manager, research, analysis, writing, review.
+
+You do not need to know the roles up front. Tell the manager "build a novel team and set up its workflow and mechanisms"; it proposes the team shape first.
+
+## What each version adds (business scenarios)
+
+### 0.3.6: replace a role when context is full
+
+Scenario: a writer line has worked long enough that its context is saturated and quality drops.  
+Use: the manager calls line_create({ label: "writer", replace: true, force: true, reason: "context full" }).  
+Effect: the same label moves to a clean Session; the old Session is retired but kept; queued/claimed messages migrate; delivered/acked are never re-delivered; no manual routing.
+
+### 0.3.7: hand off before replacing
+
+Scenario: the new writer does not know what the old line finished, what is next, or which traps to avoid.  
+Use: line_handoff({ line: "writer", format: "md" }).  
+Effect: a structured snapshot (progress, backlog, recent messages, lifecycle) without a model call; the new line reads it first.
+
+### 0.3.8: know when to replace
+
+Scenario: the manager wants to see which line is close to saturation or has gone quiet.  
+Use: line_status / line_list expose activity.level, turns, steps, lastActivityAt.  
+Effect: a low/medium/high activity proxy, not a fake "78% context used"; exact context usage waits for DSH.
+
+### 0.4.0: the manager can see cross-line traffic
+
+Scenario: lines message each other directly; the manager needs visibility without every message becoming a manager turn.  
+Use: line_observe({ line: "writer", limit: 20 }) or CLI observe --json.  
+Effect: a read-only feed with from/to/state/summary; no prompt injection and no state change; line_send semantics unchanged.
+
 ## Install
 
 One-command install (recommended; no need to find a profile):
@@ -36,7 +74,7 @@ The script picks the DSH Web profile, installs the plugin, and verifies agent-li
 
 Offline or when npm is unavailable, use the local tarball:
 
-    bash install.sh ./dsh-agent-lines-0.3.8.tgz
+    bash install.sh ./dsh-agent-lines-0.4.0.tgz
 
 After install and restart, it works without a config. When you want a fixed manager/worker setup, paste the "Manager config" block below into the file printed by the installer.
 
@@ -139,11 +177,13 @@ Tools:
 | `line_list` | List lines, status, unread counts, current line and role |
 | `line_create` | Manager only: create a line; same label is idempotent; replace:true swaps the label to a fresh Session |
 | `line_handoff` | Manager only: structured handoff snapshot (JSON/Markdown), no model call |
+| `line_observe` | Manager only: read-only cross-line feed with kind/approval state; no prompt injection, no state change |
+| `line_manager_ack` | Manager only: approve/reject a pending_approval task |
 | `line_retire` | Manager only: soft-retire; reject new sends, keep Session and history |
 | `line_rebind` | Manager only: atomically switch a line to a new live Session, optionally migrating backlog |
 | `line_rename` | Manager only: rename the sidebar title and persist it in lines.db |
 | `line_move_workspace` | Manager only: attach an existing line Session to a workspace whose path exactly matches the Session cwd |
-| `line_send` | Send to `line` or `agent#line`; optional `idempotencyKey`, `replyTo`, `noReply`, `forceDistinct`, `ttlMs` |
+| `line_send` | Send to `line` or `agent#line`; optional `kind`, `ccManager`, `idempotencyKey`, `replyTo`, `noReply`, `forceDistinct`, `ttlMs` |
 | `line_inbox` | Read delivered messages for the current line |
 | `line_ack` | Acknowledge a delivered message |
 
@@ -155,7 +195,7 @@ Line tools other than `line_status` and `line_claim_manager` are registered only
 
 A line does not inherit the old Session context. Recommended flow:
 
-1. Have the old line write a handoff file (line_handoff is available from 0.3.8);
+1. Have the old line write a handoff file (line_handoff is available from 0.3.7);
 2. The manager calls `line_create({ label, replace: true, force: true, reason: "context full" })`;
 3. The plugin creates a clean Session, atomically swaps the same label, and marks the old Session retired but keeps it;
 4. queued/claimed messages migrate to the new line; delivered/acked stay on the old Session and are never re-delivered.
@@ -171,6 +211,7 @@ dsh-agent-lines list
 dsh-agent-lines send --from frontend-line --to backend-line --text "hi"
 dsh-agent-lines inbox --line backend-line
 dsh-agent-lines ack --line backend-line --id msg_...
+dsh-agent-lines --json observe --line writer --limit 20
 dsh-agent-lines claim --agent agent-demo --line manager --session "$DSH_SESSION_ID"
 dsh-agent-lines doctor
 ```
@@ -235,6 +276,19 @@ dsh-agent-lines claim --agent agent-demo --line manager --session "$DSH_SESSION_
 
 Claim is never automatic for every new Session: it needs an explicit user request or an explicit CLI call.
 
+## Message kinds and task approval
+
+`line_send` supports four kinds:
+
+| kind | Meaning | Non-manager send |
+|---|---|---|
+| info | Informational sync | delivered directly |
+| request | Request help | delivered directly |
+| task | Assign work | becomes pending_approval; delivered only after manager approve |
+| alert | Alert | delivered directly |
+
+Manager tasks skip approval. Use `line_observe` to see pending tasks and `line_manager_ack({ messageId, decision: "approve" | "reject" })` to decide.
+
 ## Echo and duplicate protection
 
 - Same `idempotencyKey` returns the existing message.

package/README.md

@@ -23,8 +23,62 @@ DSH 的 super agent 平替插件。
 - 你希望一个负责人 agent 自己拆任务、建团队、追进度、收结果，最后向你汇报。
 
 
+## 团队类型不限于开发
+
+插件不限定团队类型。本质是“一个负责人 + 若干长期成员”的协作方式。
+下面用开发团队做示例；小说、视频、研究、运营团队只换角色和任务，不需要改插件或代码。
+
+- 小说：总编、大纲、写手、编辑、校对、审读；
+- 视频：负责人、策划、脚本、剪辑、封面、发布；
+- 开发：负责人、开发、测试、验收；
+- 研究：负责人、资料、分析、写作、审阅。
+
+第一次不需要自己想清楚角色：直接对负责人说“帮我建个小说创作团队，按小说创作的流程建立工作流程与机制”，它会先给团队结构和流程建议，你确认或补充即可。
+
+## 版本能力与业务场景
+
+### 0.3.6：上下文满了，角色可以换人
+
+场景：写手线连续工作很久，上下文配额耗尽；继续写容易出现前后矛盾。  
+用法：管理线调用 line_create({ label: "writer", replace: true, force: true, reason: "context full" })。  
+效果：同一个 label 切到干净 Session，旧 Session 只 retired、不删除；queued/claimed 消息迁移，delivered/acked 不重投；管理线不需要手工改路由。
+
+### 0.3.7：换人之前先交接
+
+场景：新写手不知道旧线做到哪、下一步是什么、哪些坑不能踩。  
+用法：line_handoff({ line: "writer", format: "md" })。  
+效果：生成结构化交接单（进度、积压、最近消息、生命周期），不调用模型；新线先读交接单再继续。
+
+### 0.3.8：什么时候该换线
+
+场景：管理线想知道哪条线快满了、哪条线最近没动静。  
+用法：line_status / line_list 看 activity.level、turns、steps、lastActivityAt。  
+效果：给出低/中/高活跃度，不伪造“上下文使用率 78%”；真实窗口等 DSH 上游提供。
+
+### 0.4.0：管理线看得到跨线消息
+
+场景：成员线之间直接同步，管理线需要知道发生了什么，但不希望每条消息都打断自己。  
+用法：line_observe({ line: "writer", limit: 20 }) 或 CLI observe --json。  
+效果：只读 feed，显示 from/to/state/摘要；不注入 prompt、不改消息状态；line_send 语义不变。
+
 ## 安装
 
+### 让 DSH 帮你装（推荐给新手）
+
+在 DSH 新会话里说：
+
+~~~text
+帮我检查并安装 GitHub 上 Lencen/dsh-agent-lines 插件。
+只从官方仓库或官方 npm 安装，不要从其他 fork 安装。
+安装前先告诉我准备执行什么命令，等我确认后再执行。
+安装完成后按插件要求加载；如果需要重启 DSH Web，先告诉我重启后打开哪个地址、
+怎么新开会话、第一句该说什么，并提醒当前会话会断开；等我确认后再重启。
+~~~
+
+重启后当前会话会断开，agent 无法再自动通知你；重启后的步骤会在重启前给你。
+
+### 手动安装
+
 一条命令安装（推荐，不需要自己找 profile）：
 
     curl -fsSL https://raw.githubusercontent.com/Lencen/dsh-agent-lines/main/install.sh -o install.sh
@@ -36,7 +90,7 @@ DSH 的 super agent 平替插件。
 
 离线或 npm 不可用时，用本地 tarball：
 
-    bash install.sh ./dsh-agent-lines-0.3.8.tgz
+    bash install.sh ./dsh-agent-lines-0.4.0.tgz
 
 安装并重启后，不写配置也可以直接使用；需要固定管理线/worker 时，再把下面“管理线配置”粘贴到脚本打印的配置文件。
 
@@ -144,11 +198,13 @@ level 是活跃度代理（low/medium/high），不是上下文使用率百分
 | `line_list` | 列出线、状态、未读数、当前线和 role |
 | `line_create` | 仅管理线：创建新线；同 label 幂等；传 replace:true 可给同 label 换新 Session |
 | `line_handoff` | 仅管理线：生成结构化交接单（JSON/Markdown），不调模型 |
+| `line_observe` | 仅管理线：只读跨线消息 feed；显示 kind/审批状态，不注入 prompt、不改状态 |
+| `line_manager_ack` | 仅管理线：对 pending_approval 的 task 做 approve/reject |
 | `line_retire` | 仅管理线：软下线；拒绝新发送，保留 Session/历史 |
 | `line_rebind` | 仅管理线：把线原子切到新的 live Session，可迁移积压 |
 | `line_rename` | 仅管理线：改侧栏标题，持久化到 lines.db |
 | `line_move_workspace` | 仅管理线：把已有线的 Session 挂到路径完全匹配的工作区 |
-| `line_send` | 发到 `line` 或 `agent#line`；可选 `idempotencyKey`、`replyTo`、`noReply`、`forceDistinct`、`ttlMs` |
+| `line_send` | 发到 `line` 或 `agent#line`；可选 `kind`、`ccManager`、`idempotencyKey`、`replyTo`、`noReply`、`forceDistinct`、`ttlMs` |
 | `line_inbox` | 读当前线已投递消息 |
 | `line_ack` | 确认已处理 |
 
@@ -160,7 +216,7 @@ level 是活跃度代理（low/medium/high），不是上下文使用率百分
 
 线不会自动继承旧 Session 的上下文。推荐流程：
 
-1. 让旧线写交接单（0.3.8 起可用 `line_handoff`）；
+1. 让旧线写交接单（0.3.7 起可用 `line_handoff`）；
 2. 管理线调用 `line_create({ label, replace: true, force: true, reason: "context full" })`；
 3. 插件创建干净 Session、同 label 原子切换，旧 Session 标记 retired 但保留；
 4. queued/claimed 消息迁移到新线；delivered/acked 留在旧 Session，不重投。
@@ -176,6 +232,7 @@ dsh-agent-lines list
 dsh-agent-lines send --from frontend-line --to backend-line --text "hi"
 dsh-agent-lines inbox --line backend-line
 dsh-agent-lines ack --line backend-line --id msg_...
+dsh-agent-lines --json observe --line writer --limit 20
 dsh-agent-lines claim --agent agent-demo --line manager --session "$DSH_SESSION_ID"
 dsh-agent-lines doctor
 ```
@@ -233,6 +290,19 @@ dsh-agent-lines claim --agent agent-demo --line manager --session "$DSH_SESSION_
 
 claim 不会对每个新会话自动执行：需要用户明确要求，或运维显式调用。
 
+## 消息类型与任务审批
+
+`line_send` 支持四种 kind：
+
+| kind | 含义 | 非管理线发送 |
+|---|---|---|
+| info | 信息同步 | 直接投递 |
+| request | 请求协助 | 直接投递 |
+| task | 派任务 | 进入 pending_approval，管理线 approve 后才投递 |
+| alert | 告警 | 直接投递 |
+
+管理线发 task 不进入审批。管理线用 `line_observe` 看 pending，再用 `line_manager_ack({ messageId, decision: "approve" | "reject" })` 决定。
+
 ## 回声与重复保护
 
 - 同 `idempotencyKey` 返回已有消息。

package/bin/dsh-agent-lines.js

@@ -9,6 +9,7 @@ import { LineError, lineId } from '../lib/protocol.js'
 
 function usage() {
   console.error(`Usage:
+  dsh-agent-lines [--db <path>] [--json] observe [--line <line>] [--since <epochMs>] [--limit N] [--agent <id>]
   dsh-agent-lines [--db <path>] [--json] list
   dsh-agent-lines [--db <path>] [--json] send --from <line> --to <line|agent#line> --text <text> [--agent <id>] [--key <key>] [--reply-to <id>]
   dsh-agent-lines [--db <path>] [--json] inbox --line <line> [--agent <id>] [--limit N] [--all]
@@ -62,6 +63,16 @@ function main() {
   }
   const store = new LineStore(opts.db)
   try {
+    if (command === 'observe') {
+      const result = store.observe({
+        agentId: String(opts.agent ?? 'agent-deepseek'),
+        line: opts.line === undefined ? null : String(opts.line),
+        since: Number(opts.since ?? 0),
+        limit: Number(opts.limit ?? 100),
+      })
+      print({ db: store.dbPath, ...result }, opts.json)
+      return 0
+    }
     if (command === 'list') {
       print({ db: store.dbPath, lines: store.listLines(), counts: store.counts() }, opts.json)
       return 0
@@ -152,4 +163,4 @@ function main() {
   }
 }
 
-process.exitCode = main()
+process.exitCode = main()

package/docs/PROTOCOL.en.md

@@ -103,6 +103,7 @@ The new line is an ordinary DSH Session in the same DSH process; no OS process,
     line_retire({ line, reason? })
     line_rebind({ line, sessionId, migrate?: "queued" | "none", reason? })
     line_create({ label, replace: true, force?, migrate?, title?, reason? })
+    line_observe({ line?, since?, limit? })
     line_handoff({ line, format?: "md" | "json", limit?: number })
     line_rename({ line, title })
 
@@ -112,6 +113,7 @@ The new line is an ordinary DSH Session in the same DSH process; no OS process,
 - migrate=none: returns LINE_BACKLOG_NOT_EMPTY if the backlog is non-empty.
 - replace: creates a fresh Session for the same label and rebinds; an active line requires force + reason.
 - line_events records title/retire/rebind audit; titles survive restarts.
+- line_observe is a manager-only read-only cross-line feed; it does not inject prompts or change state.
 
 ## Echo and reply depth
 

package/docs/PROTOCOL.md

@@ -95,6 +95,7 @@ line_move_workspace({ line, workspace }) 把已有线 Session 挂到已有工作
     line_retire({ line, reason? })
     line_rebind({ line, sessionId, migrate?: "queued" | "none", reason? })
     line_create({ label, replace: true, force?, migrate?, title?, reason? })
+    line_observe({ line?, since?, limit? })
     line_handoff({ line, format?: "md" | "json", limit?: number })
     line_rename({ line, title })
 
@@ -104,6 +105,7 @@ line_move_workspace({ line, workspace }) 把已有线 Session 挂到已有工作
 - migrate=none：backlog 非空时返回 LINE_BACKLOG_NOT_EMPTY。
 - replace：同 label 创建新 Session 并 rebind；active 线需 force + reason。
 - line_events 记录 title/retire/rebind 审计；title 持久化，重启保留。
+- line_observe 仅管理线、只读跨线 feed；不注入 prompt、不改消息状态。
 
 ## 回声与回复深度
 

package/docs/en/index.html

@@ -3,97 +3,151 @@
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<title>dsh-agent-lines — let one AI lead run a team</title>
-<meta name="description" content="State the goal. One AI lead splits the work, creates team lines, tracks progress, and reports back. Each line keeps its own context; work survives a restart.">
+<title>dsh-agent-lines — let an AI lead run your AI team</title>
+<meta name="description" content="Tell the lead your goal. It splits work, builds a team, tracks progress and summarizes results. Members and messages survive a DSH restart.">
 <meta property="og:image" content="https://lencen.github.io/dsh-agent-lines/assets/social-preview.png">
 <style>
-:root{--bg:#080b10;--panel:#0d1117;--line:#263241;--text:#e6edf3;--muted:#8b949e;--cyan:#58a6ff;--green:#7ee787}
+:root{--bg:#080b10;--panel:#0d1117;--line:#263241;--text:#e6edf3;--muted:#8b949e;--cyan:#58a6ff;--green:#7ee787;--warn:#f0b72f}
 *{box-sizing:border-box}
-body{margin:0;background:radial-gradient(circle at 80% 0%,#12314a 0,#080b10 42%);color:var(--text);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;line-height:1.7}
+body{margin:0;background:radial-gradient(circle at 80% 0%,#12314a 0,#080b10 42%);color:var(--text);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI","Noto Sans CJK SC",sans-serif;line-height:1.75}
 a{color:var(--cyan);text-decoration:none}
-.wrap{max-width:1080px;margin:0 auto;padding:0 24px}
+.wrap{max-width:1060px;margin:0 auto;padding:0 24px}
 header{display:flex;align-items:center;justify-content:space-between;padding:22px 0;border-bottom:1px solid #1f2937}
 .brand{display:flex;align-items:center;gap:10px;color:var(--text);font-weight:700}
 .mark{width:24px;height:24px;border-radius:7px;background:linear-gradient(135deg,#58a6ff,#7ee787)}
 nav a{color:var(--muted);margin-left:18px;font-size:14px}
-.hero{padding:72px 0 48px;display:grid;grid-template-columns:1.05fr .95fr;gap:42px;align-items:center}
-.kicker{color:var(--green);font-size:12px;letter-spacing:.16em;text-transform:uppercase}
-h1{font-size:48px;line-height:1.15;margin:14px 0 18px;letter-spacing:-.03em}
+.hero{padding:64px 0 32px;display:grid;grid-template-columns:1.1fr .9fr;gap:40px;align-items:center}
+.kicker{color:var(--green);font-size:12px;letter-spacing:.14em;text-transform:uppercase}
+h1{font-size:46px;line-height:1.15;margin:12px 0 16px;letter-spacing:-.03em}
 h1 span{color:var(--cyan)}
-.lead{color:#b7c3cf;font-size:17px;max-width:560px}
-.install{margin:26px 0;background:#0a0f16;border:1px solid var(--line);border-radius:10px;padding:14px 16px;font-family:"DejaVu Sans Mono",monospace;font-size:13px;color:#c9d1d9;overflow:auto}
-.actions{display:flex;gap:12px;flex-wrap:wrap}
-.btn{display:inline-block;padding:10px 16px;border-radius:9px;border:1px solid var(--line);color:var(--text);font-size:14px}
-.btn.primary{background:var(--cyan);color:#06111f;border-color:var(--cyan);font-weight:700}
+.lead{color:#b7c3cf;font-size:17px;max-width:580px}
+.actions{display:flex;gap:12px;flex-wrap:wrap;margin-top:22px}
+.btn{display:inline-block;padding:11px 17px;border-radius:9px;border:1px solid var(--line);color:var(--text);font-size:14px}
+.btn.primary{background:var(--green);color:#06111f;border-color:var(--green);font-weight:700}
 .shot{border:1px solid var(--line);border-radius:14px;overflow:hidden;background:var(--panel);box-shadow:0 22px 60px rgba(0,0,0,.35)}
 .shot img{display:block;width:100%;height:auto}
 .caption{font-size:12px;color:var(--muted);padding:10px 14px;border-top:1px solid #1f2937}
-section{padding:36px 0;border-top:1px solid #161d27}
-h2{font-size:22px;margin:0 0 18px}
+section{padding:34px 0;border-top:1px solid #161d27}
+h2{font-size:23px;margin:0 0 16px}
 .cards{display:grid;grid-template-columns:repeat(3,1fr);gap:14px}
-.card{background:rgba(13,17,23,.8);border:1px solid var(--line);border-radius:12px;padding:18px}
+.card{background:rgba(13,17,23,.82);border:1px solid var(--line);border-radius:12px;padding:18px}
 .card b{display:block;margin-bottom:6px}
 .card p{color:var(--muted);font-size:14px;margin:0}
-pre{background:#0a0f16;border:1px solid var(--line);border-radius:10px;padding:16px;overflow:auto;color:#c9d1d9;font-size:13px}
-footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
-@media(max-width:820px){.hero{grid-template-columns:1fr;padding-top:44px}h1{font-size:36px}.cards{grid-template-columns:1fr}}
+pre{background:#0a0f16;border:1px solid var(--line);border-radius:10px;padding:16px;overflow:auto;color:#c9d1d9;font-size:13px;white-space:pre-wrap}
+.note{color:var(--muted);font-size:13px}
+.warn{border-left:3px solid var(--warn);padding:10px 14px;background:#141007;color:#e8d7a8;border-radius:6px;font-size:14px}
+details{background:rgba(13,17,23,.7);border:1px solid var(--line);border-radius:10px;padding:14px 16px;margin-top:14px}
+summary{cursor:pointer;color:var(--muted);font-size:14px}
+footer{padding:30px 0 46px;color:var(--muted);font-size:12px;border-top:1px solid #161d27}
+@media(max-width:820px){.hero{grid-template-columns:1fr;padding-top:40px}h1{font-size:36px}.cards{grid-template-columns:1fr}}
 </style>
 </head>
 <body>
 <div class="wrap">
 <header>
   <a class="brand" href="../"><span class="mark"></span>dsh-agent-lines</a>
-  <nav><a href="../">中文</a><a href="https://github.com/Lencen/dsh-agent-lines">GitHub</a><a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.8">Release</a></nav>
+  <nav><a href="../">中文</a><a href="https://github.com/Lencen/dsh-agent-lines">GitHub</a><a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.4.0">Release</a></nav>
 </header>
 <main>
-<section class="hero" style="border:0;padding-bottom:22px">
+<section class="hero" style="border:0;padding-bottom:20px">
   <div>
     <div class="kicker">Community plugin · Apache-2.0</div>
-    <h1>Let one AI lead<br><span>run a team for you</span></h1>
-    <p class="lead">You state the goal. The lead splits it into research, architecture, UI, development, test, acceptance, release, and ops lines; assigns work, tracks progress, and reports back. Close the window or restart DSH; the work and messages remain.</p>
-    <div class="install">curl -fsSL https://raw.githubusercontent.com/Lencen/dsh-agent-lines/main/install.sh -o install.sh &amp;&amp; bash install.sh</div>
+    <h1>Let an AI lead<br><span>run your AI team</span></h1>
+    <p class="lead">Tell it the goal. The lead splits work, picks members, assigns tasks, tracks progress and summarizes the result. Close the window or restart DSH: members and messages stay.</p>
     <div class="actions">
-      <a class="btn primary" href="https://github.com/Lencen/dsh-agent-lines">GitHub repository</a>
-      <a class="btn" href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.8">Download 0.3.8</a>
+      <a class="btn primary" href="#start">How to start</a>
+      <a class="btn" href="#install">Install</a>
     </div>
   </div>
   <div class="shot">
-    <img src="../assets/first-use.gif" alt="First use: create a manager line and 8 member lines, then receive acks">
-    <div class="caption">demo profile · generic labels · no internal data</div>
+    <img src="../assets/first-use.gif" alt="A lead creates member lines and gets acknowledgements">
+    <div class="caption">Demo profile · generic roles · no internal data</div>
   </div>
 </section>
+
 <section>
-  <h2>What it takes off your plate</h2>
+  <h2>What it does for you</h2>
   <div class="cards">
-    <div class="card"><b>No repeated context</b><p>Each member line is a long-lived DSH Session with its own context. Send new work to the right role instead of re-explaining the project.</p></div>
-    <div class="card"><b>No manual dispatch</b><p>The lead decomposes work, assigns it, coordinates, resolves disagreements, and collects results. You read the summary.</p></div>
-    <div class="card"><b>No lost work</b><p>Tasks and messages are stored locally. Restart DSH and continue; member state and unread messages are still there.</p></div>
+    <div class="card"><b>No repeated background</b><p>Each member keeps its own context; new tasks go straight to the right role.</p></div>
+    <div class="card"><b>No manual scheduling</b><p>The lead splits work, coordinates, tracks progress; you read the summary.</p></div>
+    <div class="card"><b>No fear of closing</b><p>Members and messages are stored locally; restart DSH and continue.</p></div>
   </div>
-  <p style="color:var(--muted);font-size:14px;margin-top:14px">Built for long-running projects and multi-role work.</p>
 </section>
+
 <section>
-  <h2>A real usage pattern</h2>
+  <h2>Any team type</h2>
+  <p class="note">Not only development. Novel, video, research, operations — change roles and tasks, not the plugin.</p>
   <div class="cards">
-    <div class="card"><b>1. You state the goal</b><p>“Add CSV export to the reports page, with tests and a short runbook.”</p></div>
-    <div class="card"><b>2. The lead forms the team</b><p>Split into research, architecture, UI/UX, development, test, acceptance, release, and ops; create each line.</p></div>
-    <div class="card"><b>3. The team works in parallel</b><p>Members do their parts; the lead tracks progress, resolves interface disagreements, and reassigns when needed.</p></div>
-    <div class="card"><b>4. You get the result</b><p>The lead reports conclusions, file paths, risks, and open questions. You do not chase every member yourself.</p></div>
+    <div class="card"><b>Novel team</b><p>Editor-in-chief, outline, writer, editor, proofreader, reviewer.</p></div>
+    <div class="card"><b>Video team</b><p>Lead, planning, script, editing, cover, publishing.</p></div>
+    <div class="card"><b>Development team</b><p>Lead, developer, tester, acceptance.</p></div>
   </div>
+  <p class="note" style="margin-top:14px">You do not need to know the roles first. Say “build a novel team and set up its workflow and mechanisms”; the lead proposes the team shape first.</p>
 </section>
-<section>
-  <h2>First use: let the lead form the team</h2>
-  <pre>Use dsh-agent-lines. Make this Session the development team lead; bind it first if needed.
 
-You own task decomposition, assignment, coordination, progress tracking, result collection, and reporting. You manage and coordinate only; do not execute development tasks.
+<section id="install">
+  <h2>Install: let DSH do it</h2>
+  <p>In a new DSH session, say:</p>
+  <pre>Check and install the GitHub plugin Lencen/dsh-agent-lines.
+Use only the official repo or official npm package; do not install from forks.
+Before running anything, show me the command and wait for my confirmation.
+After install, load it as required; if DSH Web must restart, first tell me which URL to open,
+how to start a new session, and what to say first, and warn me that this session will disconnect.
+Wait for my confirmation before restarting.</pre>
+  <div class="warn">Restarting DSH Web disconnects this session; the agent cannot notify you after the restart. Put the next steps in the last message before restarting.</div>
+  <details>
+    <summary>Prefer manual install? Command</summary>
+    <pre>curl -fsSL https://raw.githubusercontent.com/Lencen/dsh-agent-lines/main/install.sh -o install.sh &amp;&amp; bash install.sh</pre>
+    <p class="note">Restart DSH Web after install so the plugin loads.</p>
+  </details>
+</section>
+
+<section id="start">
+  <h2>How to start</h2>
+  <div class="cards">
+    <div class="card"><b>1. Install and restart</b><p>Use the flow above; restart DSH Web when asked.</p></div>
+    <div class="card"><b>2. Open a new session</b><p>Tell the lead what kind of team you want.</p></div>
+    <div class="card"><b>3. Confirm the plan</b><p>The lead proposes team shape and workflow; confirm or add roles.</p></div>
+  </div>
+  <p class="note" style="margin-top:14px">Say:</p>
+  <pre>Build a novel team and set up its workflow and mechanisms.
+or
+Build a development team and set up its development workflow and mechanisms.</pre>
+  <p class="note">If you have specific roles, add:</p>
+  <pre>Also add a proofreader and a reviewer.</pre>
+</section>
 
-Form the team. Use short English names and Chinese roles:
-research (调研), architecture (架构), uiux (UIUX), dev (开发), test (测试), acceptance (验收), release (发布), ops (运维).
+<section>
+  <h2>First prompts</h2>
+  <p class="note">Novel:</p>
+  <pre>Build a novel team and set up its workflow and mechanisms.
+Do not write the novel yet; wait for my first chapter task.</pre>
+  <p class="note">Video:</p>
+  <pre>Build a video team and set up its workflow and mechanisms.
+Do not start yet; wait for my first topic.</pre>
+  <p class="note">Development:</p>
+  <pre>Build a development team and set up its development workflow and mechanisms.
+Do not start yet; wait for my first requirement.</pre>
+</section>
 
-After the team is ready, wait for my first task. Do not start by yourself.</pre>
-  <p style="color:var(--muted);font-size:14px">Restart DSH Web after install or update. Technical details, protocol, and limits: <a href="https://github.com/Lencen/dsh-agent-lines">README / architecture</a>. Community plugin, not an official DeepSeek product.</p>
+<section>
+  <h2>FAQ</h2>
+  <div class="cards">
+    <div class="card"><b>Is it expensive?</b><p>You pay for actual usage; the lead proposes a minimal team first and expands later.</p></div>
+    <div class="card"><b>Do I lose it on restart?</b><p>No. Members and messages are stored locally; continue after restart.</p></div>
+    <div class="card"><b>Two teams at once?</b><p>One plugin instance supports one team. Use separate environments for novel and video.</p></div>
+  </div>
 </section>
-<footer>dsh-agent-lines 0.3.8 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</footer>
+
+<footer>
+  <details>
+    <summary>Developers: protocol, limits, install command</summary>
+    <p><a href="https://github.com/Lencen/dsh-agent-lines">GitHub</a> · <a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.4.0">Release</a> · <a href="https://github.com/Lencen/dsh-agent-lines/blob/main/docs/PROTOCOL.en.md">Protocol</a></p>
+    <p class="note">Community plugin, not an official DeepSeek product.</p>
+  </details>
+  <p style="margin-top:18px">dsh-agent-lines 0.4.0 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</p>
+</footer>
 </main>
 </div>
 </body>
-</html>
+</html>

package/docs/index.html

@@ -3,97 +3,150 @@
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<title>dsh-agent-lines — 让 AI 负责人带一支 AI 团队</title>
-<meta name="description" content="你说目标，AI 负责人拆任务、建团队、盯进度、收结果；每条成员线有独立会话和持久消息，重启不丢。">
+<title>dsh-agent-lines — 让 AI 负责人带一支团队</title>
+<meta name="description" content="你说目标，AI 负责人拆任务、组团队、追进度、收结果；关掉窗口、重启 DSH，成员和消息还在。">
 <meta property="og:image" content="https://lencen.github.io/dsh-agent-lines/assets/social-preview.png">
 <style>
-:root{--bg:#080b10;--panel:#0d1117;--line:#263241;--text:#e6edf3;--muted:#8b949e;--cyan:#58a6ff;--green:#7ee787}
+:root{--bg:#080b10;--panel:#0d1117;--line:#263241;--text:#e6edf3;--muted:#8b949e;--cyan:#58a6ff;--green:#7ee787;--warn:#f0b72f}
 *{box-sizing:border-box}
-body{margin:0;background:radial-gradient(circle at 80% 0%,#12314a 0,#080b10 42%);color:var(--text);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI","Noto Sans CJK SC",sans-serif;line-height:1.7}
+body{margin:0;background:radial-gradient(circle at 80% 0%,#12314a 0,#080b10 42%);color:var(--text);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI","Noto Sans CJK SC",sans-serif;line-height:1.75}
 a{color:var(--cyan);text-decoration:none}
-.wrap{max-width:1080px;margin:0 auto;padding:0 24px}
+.wrap{max-width:1060px;margin:0 auto;padding:0 24px}
 header{display:flex;align-items:center;justify-content:space-between;padding:22px 0;border-bottom:1px solid #1f2937}
 .brand{display:flex;align-items:center;gap:10px;color:var(--text);font-weight:700}
 .mark{width:24px;height:24px;border-radius:7px;background:linear-gradient(135deg,#58a6ff,#7ee787)}
 nav a{color:var(--muted);margin-left:18px;font-size:14px}
-.hero{padding:72px 0 48px;display:grid;grid-template-columns:1.05fr .95fr;gap:42px;align-items:center}
-.kicker{color:var(--green);font-size:12px;letter-spacing:.16em;text-transform:uppercase}
-h1{font-size:48px;line-height:1.15;margin:14px 0 18px;letter-spacing:-.03em}
+.hero{padding:64px 0 32px;display:grid;grid-template-columns:1.1fr .9fr;gap:40px;align-items:center}
+.kicker{color:var(--green);font-size:12px;letter-spacing:.14em;text-transform:uppercase}
+h1{font-size:46px;line-height:1.15;margin:12px 0 16px;letter-spacing:-.03em}
 h1 span{color:var(--cyan)}
-.lead{color:#b7c3cf;font-size:17px;max-width:560px}
-.install{margin:26px 0;background:#0a0f16;border:1px solid var(--line);border-radius:10px;padding:14px 16px;font-family:"DejaVu Sans Mono",monospace;font-size:13px;color:#c9d1d9;overflow:auto}
-.actions{display:flex;gap:12px;flex-wrap:wrap}
-.btn{display:inline-block;padding:10px 16px;border-radius:9px;border:1px solid var(--line);color:var(--text);font-size:14px}
-.btn.primary{background:var(--cyan);color:#06111f;border-color:var(--cyan);font-weight:700}
+.lead{color:#b7c3cf;font-size:17px;max-width:580px}
+.actions{display:flex;gap:12px;flex-wrap:wrap;margin-top:22px}
+.btn{display:inline-block;padding:11px 17px;border-radius:9px;border:1px solid var(--line);color:var(--text);font-size:14px}
+.btn.primary{background:var(--green);color:#06111f;border-color:var(--green);font-weight:700}
 .shot{border:1px solid var(--line);border-radius:14px;overflow:hidden;background:var(--panel);box-shadow:0 22px 60px rgba(0,0,0,.35)}
 .shot img{display:block;width:100%;height:auto}
 .caption{font-size:12px;color:var(--muted);padding:10px 14px;border-top:1px solid #1f2937}
-section{padding:36px 0;border-top:1px solid #161d27}
-h2{font-size:22px;margin:0 0 18px}
+section{padding:34px 0;border-top:1px solid #161d27}
+h2{font-size:23px;margin:0 0 16px}
 .cards{display:grid;grid-template-columns:repeat(3,1fr);gap:14px}
-.card{background:rgba(13,17,23,.8);border:1px solid var(--line);border-radius:12px;padding:18px}
+.card{background:rgba(13,17,23,.82);border:1px solid var(--line);border-radius:12px;padding:18px}
 .card b{display:block;margin-bottom:6px}
 .card p{color:var(--muted);font-size:14px;margin:0}
-pre{background:#0a0f16;border:1px solid var(--line);border-radius:10px;padding:16px;overflow:auto;color:#c9d1d9;font-size:13px}
-footer{padding:34px 0 48px;color:var(--muted);font-size:12px}
-@media(max-width:820px){.hero{grid-template-columns:1fr;padding-top:44px}h1{font-size:36px}.cards{grid-template-columns:1fr}}
+pre{background:#0a0f16;border:1px solid var(--line);border-radius:10px;padding:16px;overflow:auto;color:#c9d1d9;font-size:13px;white-space:pre-wrap}
+.note{color:var(--muted);font-size:13px}
+.warn{border-left:3px solid var(--warn);padding:10px 14px;background:#141007;color:#e8d7a8;border-radius:6px;font-size:14px}
+details{background:rgba(13,17,23,.7);border:1px solid var(--line);border-radius:10px;padding:14px 16px;margin-top:14px}
+summary{cursor:pointer;color:var(--muted);font-size:14px}
+footer{padding:30px 0 46px;color:var(--muted);font-size:12px;border-top:1px solid #161d27}
+@media(max-width:820px){.hero{grid-template-columns:1fr;padding-top:40px}h1{font-size:36px}.cards{grid-template-columns:1fr}}
 </style>
 </head>
 <body>
 <div class="wrap">
 <header>
   <a class="brand" href="./"><span class="mark"></span>dsh-agent-lines</a>
-  <nav><a href="en/index.html">English</a><a href="https://github.com/Lencen/dsh-agent-lines">GitHub</a><a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.8">Release</a></nav>
+  <nav><a href="en/index.html">English</a><a href="https://github.com/Lencen/dsh-agent-lines">GitHub</a><a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.4.0">Release</a></nav>
 </header>
 <main>
-<section class="hero" style="border:0;padding-bottom:22px">
+<section class="hero" style="border:0;padding-bottom:20px">
   <div>
     <div class="kicker">Community plugin · Apache-2.0</div>
-    <h1>让一个 AI 负责人<br><span>替你带一支 AI 团队</span></h1>
-    <p class="lead">你只管说目标。负责人会拆任务、建调研 / 架构 / 开发 / 测试等成员线、分配工作、追进度、收结果，最后给你一份汇总。关掉窗口或重启 DSH，任务和消息还在。</p>
-    <div class="install">curl -fsSL https://raw.githubusercontent.com/Lencen/dsh-agent-lines/main/install.sh -o install.sh &amp;&amp; bash install.sh</div>
+    <h1>让 AI 负责人<br><span>替你带一支 AI 团队</span></h1>
+    <p class="lead">你只说目标。负责人会拆任务、找合适的成员、安排工作、追进度，最后把结果汇总给你。关掉窗口、重启 DSH，成员和消息都还在。</p>
     <div class="actions">
-      <a class="btn primary" href="https://github.com/Lencen/dsh-agent-lines">GitHub 仓库</a>
-      <a class="btn" href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.3.8">下载 0.3.8</a>
+      <a class="btn primary" href="#start">怎么开始</a>
+      <a class="btn" href="#install">安装插件</a>
     </div>
   </div>
   <div class="shot">
-    <img src="assets/first-use.gif" alt="首次使用：创建管理线、8 条成员线并收到 ack">
-    <div class="caption">demo profile · 通用 label · 不含内部数据</div>
+    <img src="assets/first-use.gif" alt="负责人创建成员线并收到确认">
+    <div class="caption">演示环境 · 通用角色 · 不含内部数据</div>
   </div>
 </section>
+
 <section>
-  <h2>它替你省掉什么</h2>
+  <h2>它能帮你做什么</h2>
   <div class="cards">
-    <div class="card"><b>不用反复讲背景</b><p>每条成员线是一个独立的 DSH 会话，长期保留自己的上下文；新任务直接派给对应角色。</p></div>
-    <div class="card"><b>不用自己当调度</b><p>负责人拆任务、分配、协调、处理分歧、收结果；你只需要看最后的汇总。</p></div>
-    <div class="card"><b>不用怕关窗口</b><p>任务和消息保存在本地；重启 DSH 后还能接着做，成员状态和未处理消息都在。</p></div>
+    <div class="card"><b>不用反复讲背景</b><p>每个成员长期保留自己的上下文；新任务直接派给对应角色。</p></div>
+    <div class="card"><b>不用自己当调度</b><p>负责人拆任务、分工、协调、追进度，你只看最后的汇总。</p></div>
+    <div class="card"><b>不用怕关窗口</b><p>成员和消息保存在本地；重启 DSH 后还能接着做。</p></div>
   </div>
-  <p style="color:var(--muted);font-size:14px;margin-top:14px">适合长期项目、多角色协作。</p>
 </section>
+
 <section>
-  <h2>一个真实用法</h2>
+  <h2>适合什么团队</h2>
+  <p class="note">不限于开发。小说、视频、研究、运营都可以；只换角色和任务，不需要改插件。</p>
   <div class="cards">
-    <div class="card"><b>1. 你说目标</b><p>“给报表页加 CSV 导出，带测试和一页 runbook。”</p></div>
-    <div class="card"><b>2. 负责人组队</b><p>拆成调研、架构、UIUX、开发、测试、验收、发布、运维，按角色建线。</p></div>
-    <div class="card"><b>3. 团队并行</b><p>成员各自做事；负责人追进度、处理接口分歧，必要时重新分配。</p></div>
-    <div class="card"><b>4. 你收结果</b><p>负责人汇总结论、文件路径、风险和遗留问题；不用自己挨个问。</p></div>
+    <div class="card"><b>小说团队</b><p>总编、大纲、写手、编辑、校对、审读。</p></div>
+    <div class="card"><b>视频团队</b><p>负责人、策划、脚本、剪辑、封面、发布。</p></div>
+    <div class="card"><b>开发团队</b><p>负责人、开发、测试、验收。</p></div>
   </div>
+  <p class="note" style="margin-top:14px">第一次不需要自己想清楚角色。你只说“帮我建个小说创作团队，按小说创作的流程建立工作流程与机制”，负责人会先给团队结构和流程建议。</p>
 </section>
-<section>
-  <h2>首次使用：让负责人自己组队</h2>
-  <pre>使用 dsh-agent-lines。先把这个会话设为开发团队的管理线；如果还没绑定，就先完成绑定。
 
-你是开发团队负责人：负责任务拆解与分配、协调沟通、跟踪进度、汇总结果、总结汇报。你只做管理和协调，不执行具体开发任务。
+<section id="install">
+  <h2>安装：可以让 DSH 帮你装</h2>
+  <p>在 DSH 新会话里说：</p>
+  <pre>帮我检查并安装 GitHub 上 Lencen/dsh-agent-lines 插件。
+只从官方仓库或官方 npm 安装，不要从其他 fork 安装。
+安装前先告诉我准备执行什么命令，等我确认后再执行。
+安装完成后按插件要求加载；如果需要重启 DSH Web，先告诉我重启后打开哪个地址、
+怎么新开会话、第一句该说什么，并提醒当前会话会断开；等我确认后再重启。</pre>
+  <div class="warn">重启 DSH Web 会让当前会话断开，重启后 agent 无法再自动通知你；重启后的步骤必须写在重启前。</div>
+  <details>
+    <summary>不想让 DSH 装？手动安装命令</summary>
+    <pre>curl -fsSL https://raw.githubusercontent.com/Lencen/dsh-agent-lines/main/install.sh -o install.sh &amp;&amp; bash install.sh</pre>
+    <p class="note">安装后必须重启 DSH Web，插件才会生效。</p>
+  </details>
+</section>
+
+<section id="start">
+  <h2>怎么开始（白话）</h2>
+  <div class="cards">
+    <div class="card"><b>1. 装好并重启</b><p>按上面的方式安装；需要时重启 DSH Web。</p></div>
+    <div class="card"><b>2. 新开一个会话</b><p>重启后新开会话，对负责人说要建什么团队。</p></div>
+    <div class="card"><b>3. 等它给方案</b><p>负责人先提团队结构和流程；你确认或补充角色。</p></div>
+  </div>
+  <p class="note" style="margin-top:14px">直接说：</p>
+  <pre>帮我建个小说创作团队，按小说创作的流程建立工作流程与机制。
+或
+帮我建个开发团队，按开发流程建立工作流程与机制。</pre>
+  <p class="note">如果你有明确要求，再补一句：</p>
+  <pre>另外加一个校对和一个审读角色。</pre>
+</section>
 
-请组建开发团队。成员名字用简短英文，岗位用中文：
-research（调研）、architecture（架构）、uiux（UIUX）、dev（开发）、test（测试）、acceptance（验收）、release（发布）、ops（运维）。
+<section>
+  <h2>第一次使用提示词</h2>
+  <p class="note">小说：</p>
+  <pre>帮我建个小说创作团队，按小说创作的流程建立工作流程与机制。
+先不要写正文，建好后等我发第一章任务。</pre>
+  <p class="note">视频：</p>
+  <pre>帮我建个视频创作团队，按视频创作的流程建立工作流程与机制。
+先不要开工，建好后等我发第一个选题。</pre>
+  <p class="note">开发：</p>
+  <pre>帮我建个开发团队，按开发流程建立工作流程与机制。
+先不要开工，建好后等我发第一个需求。</pre>
+</section>
 
-团队建好后先待命，不要自动开工，等我发第一个任务。</pre>
-  <p style="color:var(--muted);font-size:14px">安装或更新后需要重启 DSH Web。技术细节、协议和限制见 <a href="https://github.com/Lencen/dsh-agent-lines">README / 架构文档</a>。社区插件，不是 DeepSeek 官方产品。</p>
+<section>
+  <h2>常见问题</h2>
+  <div class="cards">
+    <div class="card"><b>会不会很贵？</b><p>按实际使用计费；负责人会先提最小可用团队，后续再扩。</p></div>
+    <div class="card"><b>关掉会丢吗？</b><p>不会，成员和消息保存在本地，重启后还能接着做。</p></div>
+    <div class="card"><b>能同时做两个团队吗？</b><p>当前一个插件实例只支持一个团队；小说和视频建议分开环境。</p></div>
+  </div>
 </section>
-<footer>dsh-agent-lines 0.3.8 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</footer>
+
+<footer>
+  <details>
+    <summary>给开发者：协议、限制、安装命令</summary>
+    <p><a href="https://github.com/Lencen/dsh-agent-lines">GitHub 仓库</a> · <a href="https://github.com/Lencen/dsh-agent-lines/releases/tag/v0.4.0">Release</a> · <a href="https://github.com/Lencen/dsh-agent-lines/blob/main/docs/PROTOCOL.md">协议</a></p>
+    <p class="note">社区插件，不是 DeepSeek 官方产品。技术细节以 README / 协议为准。</p>
+  </details>
+  <p style="margin-top:18px">dsh-agent-lines 0.4.0 · Apache-2.0 · Community plugin for DeepSeek Harness. Not an official DeepSeek product.</p>
+</footer>
 </main>
 </div>
 </body>
-</html>
+</html>

package/docs/market-index.json

@@ -50,11 +50,11 @@
         ]
       },
       "dist-tags": {
-        "latest": "0.3.8"
+        "latest": "0.4.0"
       },
       "versions": [
         {
-          "version": "0.3.8",
+          "version": "0.4.0",
           "publishTimestamp": 1793771000,
           "source": {
             "type": "npm"

package/examples/market-index.json

@@ -50,11 +50,11 @@
         ]
       },
       "dist-tags": {
-        "latest": "0.3.8"
+        "latest": "0.4.0"
       },
       "versions": [
         {
-          "version": "0.3.8",
+          "version": "0.4.0",
           "publishTimestamp": 1793771000,
           "source": {
             "type": "npm"

package/lib/store.js

@@ -62,6 +62,11 @@ CREATE TABLE IF NOT EXISTS messages (
   root_message_id TEXT,
   hop INTEGER NOT NULL DEFAULT 0,
   no_reply INTEGER NOT NULL DEFAULT 0,
+  kind TEXT NOT NULL DEFAULT 'info',
+  cc_manager INTEGER NOT NULL DEFAULT 0,
+  approval_state TEXT,
+  approved_by TEXT,
+  approved_at INTEGER,
   state TEXT NOT NULL,
   claimed_by TEXT,
   claimed_at INTEGER,
@@ -115,7 +120,7 @@ CREATE TABLE IF NOT EXISTS line_events (
 );
 CREATE INDEX IF NOT EXISTS line_events_line ON line_events(line_id, created_at);
 
-PRAGMA user_version = 7;
+PRAGMA user_version = 8;
 `
 
 export function defaultDbPath() {
@@ -168,9 +173,14 @@ export class LineStore {
     if (!messageColumns.includes('root_message_id')) this.db.exec('ALTER TABLE messages ADD COLUMN root_message_id TEXT')
     if (!messageColumns.includes('hop')) this.db.exec('ALTER TABLE messages ADD COLUMN hop INTEGER NOT NULL DEFAULT 0')
     if (!messageColumns.includes('no_reply')) this.db.exec('ALTER TABLE messages ADD COLUMN no_reply INTEGER NOT NULL DEFAULT 0')
+    if (!messageColumns.includes('kind')) this.db.exec("ALTER TABLE messages ADD COLUMN kind TEXT NOT NULL DEFAULT 'info'")
+    if (!messageColumns.includes('cc_manager')) this.db.exec('ALTER TABLE messages ADD COLUMN cc_manager INTEGER NOT NULL DEFAULT 0')
+    if (!messageColumns.includes('approval_state')) this.db.exec('ALTER TABLE messages ADD COLUMN approval_state TEXT')
+    if (!messageColumns.includes('approved_by')) this.db.exec('ALTER TABLE messages ADD COLUMN approved_by TEXT')
+    if (!messageColumns.includes('approved_at')) this.db.exec('ALTER TABLE messages ADD COLUMN approved_at INTEGER')
     this.db.exec('CREATE TABLE IF NOT EXISTS line_events (id TEXT PRIMARY KEY, line_id TEXT NOT NULL, action TEXT NOT NULL, old_session_id TEXT, new_session_id TEXT, actor TEXT, reason TEXT, detail TEXT, created_at INTEGER NOT NULL)')
     this.db.exec('CREATE INDEX IF NOT EXISTS line_events_line ON line_events(line_id, created_at)')
-    this.db.exec('PRAGMA user_version = 7')
+    this.db.exec('PRAGMA user_version = 8')
     this.prepared = new Map()
     this.closed = false
     this.fresh = fresh
@@ -265,7 +275,10 @@ export class LineStore {
   }
 
   /** Enqueue a message from one registered line to another. */
-  send({ agentId, fromLine, to, text, idempotencyKey, replyTo, noReply = false, maxReplyDepth = 8, maxMessageBytes = 65536, ttlMs, now = Date.now() }) {
+  send({ agentId, fromLine, to, text, idempotencyKey, replyTo, noReply = false, kind = 'info', ccManager = false, requireApproval = false, maxReplyDepth = 8, maxMessageBytes = 65536, ttlMs, now = Date.now() }) {
+    if (!['info', 'request', 'task', 'alert'].includes(String(kind))) {
+      throw new LineError('LINE_INVALID_KIND', `kind must be info/request/task/alert: ${kind}`)
+    }
     const from = this.#stmt('SELECT * FROM lines WHERE agent_id = ? AND label = ?').get(agentId, fromLine)
     if (from === undefined) throw new LineError('LINE_NOT_FOUND', `Sender line is not registered: ${agentId}#${fromLine}`)
     const target = this.resolveTarget(agentId, to)
@@ -290,9 +303,9 @@ export class LineStore {
     const expiresAt = ttlMs === undefined || ttlMs === null || ttlMs <= 0 ? null : now + ttlMs
     this.#stmt(`INSERT INTO messages(
       id, idempotency_key, from_agent, from_line, from_session, to_agent, to_line, body,
-      created_at, expires_at, reply_to, root_message_id, hop, no_reply, state, attempts, next_attempt_at
-    ) VALUES(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'queued', 0, ?)`)
-      .run(id, key, from.agent_id, from.label, from.session_id, target.agentId, target.line, body, now, expiresAt, replyTo ?? null, rootMessageId, hop, noReply === true ? 1 : 0, now)
+      created_at, expires_at, reply_to, root_message_id, hop, no_reply, kind, cc_manager, approval_state, state, attempts, next_attempt_at
+    ) VALUES(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0, ?)`)
+      .run(id, key, from.agent_id, from.label, from.session_id, target.agentId, target.line, body, now, expiresAt, replyTo ?? null, rootMessageId, hop, noReply === true ? 1 : 0, String(kind), ccManager === true ? 1 : 0, requireApproval ? 'pending' : null, requireApproval ? 'pending_approval' : 'queued', now)
     return { ...this.#stmt('SELECT * FROM messages WHERE id = ?').get(id), deduplicated: false }
   }
 
@@ -542,6 +555,57 @@ export class LineStore {
     return this.#stmt('SELECT * FROM line_events WHERE line_id = ? AND action = ? ORDER BY created_at DESC LIMIT 1').get(id, action)
   }
 
+  /** Manager decision on a pending task message: approve queues it, reject closes it. */
+  approveMessage({ messageId, decision = 'approve', actor = null, now = Date.now() }) {
+    if (!['approve', 'reject'].includes(String(decision))) throw new LineError('LINE_INVALID_ARGUMENT', 'decision must be approve or reject')
+    return this.#tx(() => {
+      const row = this.#stmt('SELECT * FROM messages WHERE id = ?').get(String(messageId))
+      if (row === undefined) throw new LineError('LINE_MESSAGE_NOT_FOUND', `No message: ${messageId}`)
+      if (row.state !== 'pending_approval') throw new LineError('LINE_NOT_PENDING_APPROVAL', `Message ${messageId} is ${row.state}`)
+      const approved = String(decision) === 'approve'
+      this.#stmt(`UPDATE messages SET state = ?, approval_state = ?, approved_by = ?, approved_at = ?
+        WHERE id = ? AND state = 'pending_approval'`).run(
+        approved ? 'queued' : 'rejected', approved ? 'approved' : 'rejected', actor, now, row.id,
+      )
+      return { ...this.#stmt('SELECT * FROM messages WHERE id = ?').get(row.id), approved }
+    })
+  }
+
+  /** Read-only cross-line feed for the manager; no state changes. */
+  observe({ agentId, line = null, since = 0, limit = 100 } = {}) {
+    const n = Math.min(200, Math.max(1, Number(limit) || 100))
+    const from = Math.max(0, Number(since) || 0)
+    const params = [agentId, agentId]
+    let sql = `SELECT id, from_agent, from_line, to_agent, to_line, body, state, kind, cc_manager, approval_state, reply_to, root_message_id,
+      hop, no_reply, created_at, delivered_at, acked_at
+      FROM messages WHERE (from_agent = ? OR to_agent = ?) AND from_line != to_line AND created_at > ?`
+    params.push(from)
+    if (line !== null && String(line).trim() !== '') {
+      sql += ' AND (from_line = ? OR to_line = ?)'
+      params.push(String(line), String(line))
+    }
+    sql += ' ORDER BY created_at DESC LIMIT ?'
+    params.push(n)
+    const rows = this.#stmt(sql).all(...params)
+    return {
+      agentId, line: line === null ? null : String(line), since: from, count: rows.length,
+      messages: rows.map(row => ({
+        id: row.id,
+        from: row.from_agent + '#' + row.from_line,
+        to: row.to_agent + '#' + row.to_line,
+        state: row.state,
+        kind: row.kind,
+        ccManager: Number(row.cc_manager) === 1,
+        approvalState: row.approval_state,
+        noReply: Number(row.no_reply) === 1,
+        replyTo: row.reply_to,
+        hop: row.hop,
+        createdAt: row.created_at,
+        summary: String(row.body || '').replace(/\s+/g, ' ').slice(0, 240),
+      })),
+    }
+  }
+
   /** Structured handoff snapshot: counts + recent messages + lifecycle events. */
   handoff({ agentId, line, limit = 20, now = Date.now() }) {
     const row = this.getLine(agentId, line, now)

package/lib/tools.js

@@ -20,11 +20,12 @@ function currentLine(exec, lineDefs) {
   return def
 }
 
-function windowKey({ from, to, text, replyTo, windowMs, now = Date.now() }) {
+function windowKey({ from, to, text, replyTo, kind = 'info', ccManager = false, windowMs, now = Date.now() }) {
   if (windowMs <= 0) return undefined
   const bucket = Math.floor(now / windowMs)
   const digest = createHash('sha256')
     .update(from).update('\0').update(to).update('\0').update(text).update('\0').update(String(replyTo ?? ''))
+    .update('\0').update(String(kind)).update('\0').update(ccManager ? 'cc' : '')
     .digest('hex')
   return `window:${bucket}:${digest}`
 }
@@ -208,6 +209,8 @@ export function registerToolsForAgent(agent, def, { config, store, lineDefs, cre
         idempotencyKey: { type: 'string', description: 'Optional stable key for retry-safe sends' },
         replyTo: { type: 'string', description: 'Optional message id this message replies to; blocked if that message is noReply and checked against maxReplyDepth' },
         noReply: { type: 'boolean', description: 'Mark this message as a notification; replies are rejected' },
+        kind: { type: 'string', enum: ['info', 'request', 'task', 'alert'], description: 'Message intent; non-manager task messages wait for line_manager_ack approval' },
+        ccManager: { type: 'boolean', description: 'Mark this message as manager-visible; defaults true for task/alert' },
         forceDistinct: { type: 'boolean', description: 'Allow two identical messages inside dedupeWindowMs' },
         ttlMs: { type: 'number', description: 'Optional time-to-live in milliseconds' },
       },
@@ -222,9 +225,14 @@ export function registerToolsForAgent(agent, def, { config, store, lineDefs, cre
       if (target.lineId === def.lineId && config.allowSelfSend !== true) {
         throw new LineError('LINE_SELF_SEND_FORBIDDEN', `Self-send is disabled; set allowSelfSend to enable: ${def.lineId}`)
       }
+      const kind = args.kind === undefined ? 'info' : String(args.kind)
+      if (!['info', 'request', 'task', 'alert'].includes(kind)) throw new LineError('LINE_INVALID_KIND', `kind must be info/request/task/alert: ${kind}`)
+      const isManager = def.label === config.createFrom
+      const ccManager = args.ccManager === undefined ? (kind === 'task' || kind === 'alert') : args.ccManager === true
+      const requireApproval = kind === 'task' && !isManager
       const idempotencyKey = args.idempotencyKey ?? (args.forceDistinct === true
         ? undefined
-        : windowKey({ from: def.lineId, to: target.lineId, text, replyTo: args.replyTo, windowMs: config.dedupeWindowMs }))
+        : windowKey({ from: def.lineId, to: target.lineId, text, replyTo: args.replyTo, kind, ccManager, windowMs: config.dedupeWindowMs }))
       const row = store.send({
         agentId: def.agentId,
         fromLine: def.label,
@@ -233,6 +241,7 @@ export function registerToolsForAgent(agent, def, { config, store, lineDefs, cre
         idempotencyKey,
         replyTo: args.replyTo,
         noReply: args.noReply === true,
+        kind, ccManager, requireApproval,
         maxReplyDepth: config.maxReplyDepth,
         ttlMs: args.ttlMs,
         maxMessageBytes: config.maxMessageBytes,
@@ -244,6 +253,10 @@ export function registerToolsForAgent(agent, def, { config, store, lineDefs, cre
         hop: row.hop,
         rootMessageId: row.root_message_id,
         noReply: Number(row.no_reply) === 1,
+        kind: row.kind,
+        ccManager: Number(row.cc_manager) === 1,
+        approvalState: row.approval_state ?? null,
+        requiresApproval: row.state === 'pending_approval',
         deduplicated: row.deduplicated === true,
       }
     },
@@ -398,6 +411,50 @@ export function registerToolsForAgent(agent, def, { config, store, lineDefs, cre
       },
     }))
 
+    disposers.push(agent.ctx.tools.register({
+      name: 'line_manager_ack',
+      description: 'Manager-only decision for a pending task message: approve queues it for delivery, reject closes it. Use line_observe to find pending approvals.',
+      parameters: {
+        type: 'object', additionalProperties: false,
+        properties: {
+          messageId: { type: 'string', description: 'Pending task message id' },
+          decision: { type: 'string', enum: ['approve', 'reject'], description: 'Approve queues the message; reject closes it' },
+        },
+        required: ['messageId', 'decision'],
+      },
+      output: OUTPUT,
+      execute: async (args, exec) => {
+        const caller = currentLine(exec, lineDefs)
+        if (caller.label !== config.createFrom) throw new LineError('LINE_CREATE_FORBIDDEN', `Only ${config.createFrom} may approve tasks`, { caller: caller.label })
+        const row = store.approveMessage({ messageId: String(args.messageId), decision: String(args.decision), actor: caller.label })
+        return { messageId: row.id, state: row.state, approvalState: row.approval_state, approved: row.approved }
+      },
+    }))
+
+    disposers.push(agent.ctx.tools.register({
+      name: 'line_observe',
+      description: 'Manager-only read-only feed of recent cross-line messages (from/to, state, noReply, summary). Does not inject prompts or change any message state. Use it to watch team traffic without turning every message into a manager turn.',
+      parameters: {
+        type: 'object', additionalProperties: false,
+        properties: {
+          line: { type: 'string', description: 'Optional line filter (matches from or to)' },
+          since: { type: 'number', description: 'Only messages created after this epoch ms' },
+          limit: { type: 'number', description: 'Maximum messages, 1-200 (default 100)' },
+        },
+      },
+      output: OUTPUT,
+      execute: async (args, exec) => {
+        const caller = currentLine(exec, lineDefs)
+        if (caller.label !== config.createFrom) throw new LineError('LINE_CREATE_FORBIDDEN', `Only ${config.createFrom} may observe lines`, { caller: caller.label })
+        return store.observe({
+          agentId: config.agentId,
+          line: args.line === undefined ? null : String(args.line),
+          since: Number(args.since) || 0,
+          limit: limitValue(args.limit, 100, 200),
+        })
+      },
+    }))
+
     disposers.push(agent.ctx.tools.register({
       name: 'line_handoff',
       description: 'Generate a structured handoff snapshot for a line: current metadata, backlog counts, recent messages, lifecycle events. Does not call a model; write the returned markdown to a file before retire/replace/rebind.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-agent-lines",
-  "version": "0.3.8",
+  "version": "0.4.0",
   "description": "DSH Agent 的持久、可寻址消息线（社区插件）。",
   "type": "module",
   "license": "Apache-2.0",