@twinsearth/dsh-master 3.3.2 → 3.3.4

package/README.md

@@ -21,8 +21,8 @@ DSH Host
 │   mirror / essence / derived                core（主 Agent 控制面）
 │   fangForker / fangDecisionCenter  ◄──────  ├── superagent-router   （essence/mother）
 │   fangSessionCatalog                       ├── superagent-worker   （fork/essence）
-│                                            ├── cost-optimizer       （fork）
-│                                            └── dual-manager         （mother/essence）
+│                                            ├── cost-optimizer       （fork/mother）
+│                                            └── dual-manager         （mother/essence/fork）
 └── 协作只走服务键；任一方向失败一律 fail-closed，不本地降级执行
 ```
 
@@ -31,10 +31,29 @@ DSH Host
 | 子插件 | 行 id | 允许角色 | 路线图 | 已交付 |
 |---|---|---|---|---|
 | SuperAgent Router | `master-superagent-router` | **essence / mother** | 3.2.1/3.2.3 | Webhook/Ticket/Mandate、渐进信任、本地或母体桥派发、Worker 实时事件、回写 |
-| SuperAgent Worker | `master-superagent-worker` | **fork / essence** | 3.2.1 | Ticket 上下文、Mandate 守卫 |
-| Worker Agent Loop | `master-superagent-loop` | **fork / essence** | 3.2.3 | tsc 编译 preset；有 Ticket 自动跑多轮工具循环并流式回传 |
-| 成本优化 HarnessMM | `master-cost-optimizer` | **fork only** | 3.3.0 | observe 层：token 估算、实测记录 |
-| 双主管 PM + PJM | `master-dual-manager` | **mother / essence** | 3.4.0 | PRD/计划/调度/决策中心澄清 |
+| SuperAgent Worker | `master-superagent-worker` | **fork / essence / mother** | 3.2.1 | Ticket 上下文、Mandate 守卫 |
+| Worker Agent Loop | `master-superagent-loop` | **fork / essence / mother** | 3.2.3 | tsc 编译 preset；有 Ticket 自动跑多轮工具循环并流式回传 |
+| 成本优化 HarnessMM | `master-cost-optimizer` | **fork / mother** | 3.3.0 | observe 层：token 估算、实测记录、瓮城回流 |
+| 双主管 PM + PJM | `master-dual-manager` | **mother / essence / fork** | 3.4.0 | PRD/计划/调度/决策中心澄清 |
+
+> 角色矩阵自 **3.3.3** 起：**母体全开**（含 Worker/Loop/成本），**分身也挂双主管**；
+> 唯一保留的限制是 **Router 不进 fork**（分身只执行，不注册控制面）。
+> 旧的「母体不接纳执行体」约束已按用户明确要求废止。
+
+## 智能体（3.3.4）
+
+除子插件行之外，房主还提供两个**可选择的 Agent preset**（新会话创建时选择）：
+
+| 智能体 | preset | 职责 | 工具边界 |
+|---|---|---|---|
+| 产品经理 PM | `master-pm` | 澄清需求、WHY/WHAT、PRD、六类现状盘点 | 只读 fs + 搜索 + 提问 + 交付；**不执行、不派发、不发布** |
+| 项目经理 PJM | `master-pjm` | WBS、七类项目管理、隔离派发、节点汇总、结案 | 只读 fs + 待办 + 交付；派发只走 `fangForker.spawn`，无则 fail-closed |
+
+- PM 的“已完成”必须有证据（文件/测试/报告），否则拒收；冲突与歧义必须给用户重新判断的选项。
+- PJM 的结案有门禁：全部步骤 done + 必须写 summary；结案后冻结，不能再派发。
+- 两者共享 `dual-manager` 的结构化状态（PRD / 盘点 / 计划 / 节点 / 结案），文档只写 Session workspace 下的 `docs/pm`、`docs/pjm`。
+- 详见 [智能体设计](docs/AGENTS-PM-PJM.md)。
+- 面板「房主」抽屉新增两张智能体卡片与「智囊团 · Command Center」**只读**摘要（PRD / 盘点 / 计划 / 结案 / 派发可用性），不提供写入口。
 
 ## 本地开发
 
@@ -96,6 +115,8 @@ dsh plugin add <package>  # 加载 dist-host/dist-worker
 - **3.3.1 发布线**：M5 收口 —— 瓮城回流接口升级到 `@twinsearth/dsh-fang-contract` **1.1.0**（`fang.relay.publish` / `fang.relay.status`），房主侧 `src/cost/fang-relay.ts` 做真实探测与投递（只有对端回执才算送达，不可用给具名原因）；里程碑 **M1–M5 全部 done**。详见 [M5 回流实测](docs/EXPERIMENT-M5-fang-relay.md)。
 - **3.3.0 发布线**：成本优化系统层（ledger / budget / policy / audit）+ Worker 四个成本切点 + A1 紧凑化（默认 shadow）+ A2–A3 / B1–B4；真实 A/B 实测 tokens/task 6263 → 3906.75（−37.6%），成功率 0pp 差，详见 [3.3.0 架构设计](docs/DESIGN-v3.3.0-cost-optimization.md)。
 - 3.2.10 发布线：角色矩阵放宽——Router 进入母体（essence/mother），Worker 与 Worker Agent Loop 进入原身（fork/essence）；母体仍不接纳执行体，fork 仍不注册 Router。
+- **3.3.4 发布线（智能体）**：新增两个可选择的 Agent preset —— 产品经理（PM，`master-pm`）与项目经理（PJM，`master-pjm`），共享 `dual-manager` 的结构化 PRD / 六类盘点 / WBS / 结案；面板新增智能体卡片与「智囊团 · Command Center」只读摘要。详见 [智能体设计](docs/AGENTS-PM-PJM.md)、[产品盘点与项目计划](docs/REVIEW-PM-PJM-3.3.4.md)。
+- **3.3.3 发布线（角色矩阵调整，用户明确要求）**：母体全开（Worker / Worker Agent Loop / 成本优化进 mother），分身挂双主管（dual 进 fork）；唯一保留的限制是 Router 不进 fork。
 - 3.2.9 发布线：房主面板改注册到 `shell.overlay` 常驻浮层——点击面板之外不收起、侧栏「房主」按钮二次点击收起、正文独立滚动；新增无浏览器 hook 运行时行为测试（开关、无 outside-click 监听、滚动容器、SSE 失败不卸载面板）。
 - 3.2.8 发布线：与瓮城通过 fang-master contract 1.0 互联（local/http/file/legacy 四级保底）；GitHub Release + NPM public。
 - 当前工作树完成新一轮审计修复：工具名/死循环阈值、Router 鉴权与生命周期、真实路由分流、契约幂等与超时、PR 护栏与交付、飞书加密、长 Shell 后台作业、成本实测接线、PJM 派生契约。

package/client.js

@@ -110,6 +110,50 @@ window.__ModuleLoader__.load({
       )
     }
 
+    /** 3.3.4：PM / PJM 智能体卡片（Agent preset，与子插件行分开显示）。 */
+    function AgentCard({ item }) {
+      return h('div', { style: S.card },
+        h('div', { style: S.row },
+          h('span', { style: S.name }, item.name),
+          tag(item.nameEn),
+          tag('preset ' + item.preset),
+          h('span', { style: { marginLeft: 'auto', fontSize: 11.5, ...(item.selectable ? S.ok : S.off) } },
+            item.selectable ? '可选择' : '本宿主不可用')),
+        h('div', { style: S.desc }, item.boundary),
+        h('div', { style: S.desc }, '职责：' + (item.responsibilities || []).join(' · ')),
+        h('div', { style: S.desc }, '工具：' + (item.tools || []).join(' · ')),
+        h('div', { style: S.desc }, item.hint || ''),
+      )
+    }
+
+    /**
+     * 3.3.4「智囊团」只读摘要：PM/PJM 两个 Agent 共享 dual-manager 的结构化账目。
+     * 面板只展示计数与协作状态，不创建 PRD/计划（写入只经 Agent 自己的工具）。
+     */
+    function CommandCenter({ dual }) {
+      const line = (label, value) => h('div', { style: S.desc }, label + '：' + value)
+      if (!dual) {
+        return h('div', { style: S.card, 'data-dsh-master': 'command-center' },
+          h('div', { style: S.row },
+            h('span', { style: S.name }, '智囊团 · Command Center'),
+            tag('未装配'),
+            h('span', { style: { marginLeft: 'auto', fontSize: 11.5, ...S.off } }, '不可用')),
+          h('div', { style: S.desc }, 'dual-manager 未启用：PM/PJM 的工具会返回 dual-service-unavailable。'))
+      }
+      const pm = dual.pm || {}
+      const pjm = dual.pjm || {}
+      const coop = dual.cooperation || {}
+      return h('div', { style: S.card, 'data-dsh-master': 'command-center' },
+        h('div', { style: S.row },
+          h('span', { style: S.name }, '智囊团 · Command Center'),
+          tag('只读'),
+          h('span', { style: { marginLeft: 'auto', fontSize: 11.5, ...S.ok } }, dual.ok ? '已装配' : '降级')),
+        line('产品经理', 'PRD ' + (pm.prds ?? 0) + ' · 盘点 ' + (pm.assessments ?? 0)),
+        line('项目经理', '计划 ' + (pjm.plans ?? 0) + ' · 已结案 ' + (pjm.closed ?? 0)),
+        line('协作', '决策中心 ' + (coop.decisionCenter ? '✓' : '×') + ' · 分身派发 ' + (coop.forker ? '✓' : '×')),
+        h('div', { style: S.desc }, '面板只读：PRD/计划由 PM/PJM 会话里的工具创建；派发必须经 fangForker。'))
+    }
+
     function FangCard({ cooperation }) {
       if (!cooperation) return null
       const entries = Object.entries(cooperation.services || {})
@@ -275,7 +319,7 @@ window.__ModuleLoader__.load({
       return h('div', { style: S.card, 'data-dsh-master': 'cost-block' },
         h('div', { style: S.row },
           h('span', { style: S.name }, '成本（只读）'),
-          tag(block ? '3.3.2' : '未启用', block ? undefined : '#B45309')),
+          tag(block ? '3.3.4' : '未启用', block ? undefined : '#B45309')),
         failed ? h('div', { style: S.error }, '成本接口不可达') : null,
         !block && !failed ? h('div', { style: S.desc }, '成本系统未装配（cost-optimizer 未启用或角色不匹配）') : null,
         columns ? h('div', { style: S.desc },
@@ -332,6 +376,8 @@ window.__ModuleLoader__.load({
             h('div', { style: S.desc }, '运行：' + Math.max(1, Math.round((status.uptimeMs || 0) / 60000)) + ' 分钟'),
           ) : null,
           ...items.map((item) => h(SubpluginCard, { key: item.id, item })),
+          ...(status && Array.isArray(status.agents) ? status.agents : []).map((item) => h(AgentCard, { key: item.id, item })),
+          h(CommandCenter, { dual: status && status.dual }),
           h(CostCard),
           h(FangCard, { cooperation: status && status.cooperation }),
           h(LiveFeed),

package/cordis.patch.yml

@@ -69,3 +69,52 @@
       name: '@twinsearth/dsh-master/dual-manager'
       config:
         enabled: true
+    # ── 3.3.4：两个可被新会话选择的智能体 preset ────────────────────────────────
+    # PM 只拿“读 + 问 + 交付文档”，PJM 只拿“读 + 待办 + 交付 + 共享服务工具”。
+    # 两者都不拿 shell / 写文件 / 发布会话，避免智能体绕过 Role Matrix 自行改代码。
+    - id: preset-master-pm
+      name: '@deepseek-ai/dsh-agent-preset'
+      config:
+        id: master-pm
+        name: 产品经理（PM）
+        description: 把需求翻译成 PRD 与六类现状盘点；只读证据、出选择题、写文档，不执行代码。
+        order: 20
+        plugins:
+          - id: pm-agent
+            name: '@twinsearth/dsh-master/pm-agent'
+          - id: tool-fs
+            name: '@deepseek-ai/dsh-tool-fs'
+            config:
+              read: true
+              readImage: true
+              write: false
+              edit: false
+          - id: tool-fs-search
+            name: '@deepseek-ai/dsh-tool-fs-search'
+          - id: tool-ask-user
+            name: '@deepseek-ai/dsh-tool-ask-user'
+          - id: tool-present
+            name: '@deepseek-ai/dsh-tool-present'
+    - id: preset-master-pjm
+      name: '@deepseek-ai/dsh-agent-preset'
+      config:
+        id: master-pjm
+        name: 项目经理（PJM）
+        description: 把 PRD 拆成 WBS 与七类项目管理内容；隔离派发、节点汇总、结案汇报。
+        order: 21
+        plugins:
+          - id: pjm-agent
+            name: '@twinsearth/dsh-master/pjm-agent'
+          - id: tool-fs
+            name: '@deepseek-ai/dsh-tool-fs'
+            config:
+              read: true
+              readImage: true
+              write: false
+              edit: false
+          - id: tool-fs-search
+            name: '@deepseek-ai/dsh-tool-fs-search'
+          - id: tool-todo
+            name: '@deepseek-ai/dsh-tool-todo'
+          - id: tool-present
+            name: '@deepseek-ai/dsh-tool-present'

package/dist-host/agents/pjm-agent.js

@@ -0,0 +1,46 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 dsh-Master contributors — see LICENSE-CORE.
+// @ts-nocheck
+import { PJM_SYSTEM_PROMPT } from "./prompts.js";
+import { dualService, dualUnavailable, id, installAgent, jsonTool, objectSchema, objects, string, strings } from "./toolkit.js";
+export const name = 'dsh-master-pjm-agent';
+export const inject = ['systemPrompt', 'tools'];
+/** PJM preset：项目计划、节点、隔离派发、结案；不替 PM 决定需求。 */
+export function apply(ctx) {
+    const dual = () => dualService(ctx);
+    const tools = [
+        jsonTool('pjm_create_plan', '把已确认 PRD 拆成 WBS 与七类项目计划，返回 plan id；估时必须以分钟给出。', objectSchema({
+            prdId: id('PRD id'), title: string('项目计划标题'), how: string('实施路径'), where: string('执行场景'),
+            projectReview: strings('项目会审结论'), requirements: strings('项目需求与内容'),
+            steps: objects('WBS：id/title/prompt/owner/where/estimateMinutes/dependsOn/acceptance/kind'),
+            schedule: { type: 'object', description: 'startAt 与 milestones[]（title/owner/estimateMinutes/dependsOn）', additionalProperties: true },
+            team: objects('人员：role/owner/responsibility'),
+            quality: { type: 'object', description: 'tests[] / deployment[] / acceptance[]', additionalProperties: true },
+        }, ['prdId', 'steps']), async (args) => dual() ? dual().pjm.plan(args.prdId, args) : dualUnavailable()),
+        jsonTool('pjm_dispatch_step', '通过 fangForker.spawn 在隔离分身中执行一个 WBS 步骤；不可用会 fail-closed，不在宿主本地执行。', objectSchema({
+            planId: id('计划 id'), stepId: id('步骤 id'),
+        }, ['planId', 'stepId']), async (args) => dual() ? await dual().pjm.dispatch(args.planId, { stepId: args.stepId }) : dualUnavailable()),
+        jsonTool('pjm_complete_step', '记录步骤完成/失败、证据与实际用时；不得把失败写成完成。', objectSchema({
+            planId: id('计划 id'), stepId: id('步骤 id'),
+            status: { type: 'string', enum: ['done', 'failed'] }, summary: string('结果摘要'),
+            evidence: strings('测试/文件/报告证据'), actualMinutes: { type: 'number', description: '实际用时（分钟）' },
+        }, ['planId', 'stepId', 'status']), async (args) => dual() ? dual().pjm.completeStep(args.planId, args.stepId, args) : dualUnavailable()),
+        jsonTool('pjm_project_status', '读取项目看板：完成/进行/待办/失败、估时、实际用时、是否可结案。', objectSchema({ planId: id('计划 id') }, ['planId']), async (args) => dual() ? dual().pjm.progress(args.planId) : dualUnavailable()),
+        jsonTool('pjm_write_project', '把项目计划与当前节点写成 workspace/docs/pjm 下的 Markdown。', objectSchema({ planId: id('计划 id') }, ['planId']), async (args, exec) => dual() ? await dual().pjm.writeProject(args.planId, { agent: exec.agent }) : dualUnavailable()),
+        jsonTool('pjm_close_project', '全部步骤完成后结案：写入总结、评审报告、验收与资料清单，并可生成结案文档。', objectSchema({
+            planId: id('计划 id'), summary: string('结案总结（必填）'), reviewReport: string('评审报告'),
+            acceptance: strings('验收记录'), artifacts: strings('项目资料路径'), write: { type: 'boolean', description: '是否同时写结案 Markdown，默认 true' },
+        }, ['planId', 'summary']), async (args, exec) => {
+            if (!dual())
+                return dualUnavailable();
+            const closed = dual().pjm.close(args.planId, args);
+            if (!closed.ok)
+                return closed;
+            if (args.write === false)
+                return closed;
+            const document = await dual().pjm.writeClosure(args.planId, { agent: exec.agent });
+            return { ...closed, document };
+        }),
+    ];
+    return installAgent(ctx, { prompt: PJM_SYSTEM_PROMPT, tools });
+}

package/dist-host/agents/pm-agent.js

@@ -0,0 +1,35 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 dsh-Master contributors — see LICENSE-CORE.
+// @ts-nocheck
+import { PM_SYSTEM_PROMPT } from "./prompts.js";
+import { dualService, dualUnavailable, id, installAgent, jsonTool, objectSchema, objects, string, strings } from "./toolkit.js";
+export const name = 'dsh-master-pm-agent';
+export const inject = ['systemPrompt', 'tools'];
+/** PM preset：只提供需求/盘点/文档工具，不提供任何执行或派生能力。 */
+export function apply(ctx) {
+    const dual = () => dualService(ctx);
+    const tools = [
+        jsonTool('pm_create_prd', '创建结构化产品需求文档（WHY/WHAT/模块/约束/验收），返回 PRD id。', objectSchema({
+            title: string('需求标题'), goal: string('要解决的问题与目标'),
+            why: string('背景与价值'), what: strings('功能范围'), architecture: string('架构说明'),
+            outcomes: strings('预期结果'), modules: objects('模块：name/result/architecture/status'),
+            priority: { type: 'string', enum: ['low', 'normal', 'high', 'critical'] },
+            constraints: strings('约束'), acceptance: strings('验收标准'), nonGoals: strings('非目标'),
+            assumptions: strings('假设'), openQuestions: strings('待澄清问题'), requester: string('请求方'),
+        }, ['title', 'goal']), async (args) => dual() ? dual().pm.createPrd(args) : dualUnavailable()),
+        jsonTool('pm_create_assessment', '保存六类产品现状盘点。completed 每项必须附 evidence；其它类给原因、计划、冲突或歧义。', objectSchema({
+            prdId: id('可选：关联的 PRD id'), title: string('盘点标题'), why: string('目标'), what: strings('范围'),
+            completed: objects('已完成：title/progress/evidence[]（证据必填）'),
+            unfinished: objects('未完成：title/reason/nextStep/progress'),
+            blocked: objects('受阻：title/reason/blocker/nextStep'),
+            planned: objects('已计划：title/plan/estimateMinutes/priority'),
+            conflicts: objects('冲突：title/question/options[{value,label,consequence}]'),
+            ambiguities: objects('歧义：title/question/currentInterpretation'),
+        }, ['title']), async (args) => dual() ? dual().pm.createAssessment(args) : dualUnavailable()),
+        jsonTool('pm_write_prd', '把 PRD（可带六类盘点）写成 workspace/docs/pm 下的 Markdown，返回文档路径。', objectSchema({
+            prdId: id('PRD id'), assessmentId: id('可选：关联的 Assessment id'),
+        }, ['prdId']), async (args, exec) => dual() ? await dual().pm.writePrd(args.prdId, { assessmentId: args.assessmentId, agent: exec.agent }) : dualUnavailable()),
+        jsonTool('pm_list_prds', '列出当前 Host 中的 PRD 与六类盘点索引。', objectSchema({}), async () => dual() ? ({ ok: true, prds: dual().pm.listPrds().items, assessments: dual().pm.listAssessments().items }) : dualUnavailable()),
+    ];
+    return installAgent(ctx, { prompt: PM_SYSTEM_PROMPT, tools });
+}

package/dist-host/agents/prompts.js

@@ -0,0 +1,61 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 dsh-Master contributors — see LICENSE-CORE.
+export const PM_AGENT_ID = 'master-pm';
+export const PJM_AGENT_ID = 'master-pjm';
+export const PM_SYSTEM_PROMPT = String.raw `# Role
+你是 DSH-Master「房主」的产品经理 Agent（PM，preset: master-pm）。你把用户和开发者的大白话转换成可核对、可验收的产品需求与文档。
+
+# Goals — WHY / WHAT
+1. WHY：说清解决什么问题、为什么值得做、达成什么目标。
+2. WHAT：说清功能、模块、架构、预期结果、约束、非目标和验收标准。
+3. 对现状做证据驱动的六类盘点：已完成、未完成、无法实现/受阻、已计划、冲突、歧义。
+
+# Workflow
+1. 先识别目标、范围、约束和未决项；重大歧义或不可逆选择必须用 ask_user_question 提出一个具体决策点，给 2–4 个选项并标推荐项。不要为琐碎实现细节打断用户。
+2. 盘点前先用 read/grep/glob 读取真实代码、测试和文档。没有证据的“完成”不得写 100%，不得把设计稿当成已交付。
+3. 用 pm_create_prd 保存结构化 PRD；用 pm_create_assessment 保存六类盘点。每个 completed 项必须附文件、测试或报告证据。
+4. 用 pm_write_prd 生成 Markdown 文档；需要用户打开时用 present 交付。需要 PJM 执行时，只移交 PRD id、验收标准、未决问题，不代替 PJM 派工。
+
+# Rules
+- 不臆测、不伪造证据、不把“可以实现”写成“已经完成”。
+- 冲突必须列出冲突双方、影响、可选方案和需要用户重新判断的问题。
+- 歧义必须写出当前理解与待确认问题；用户未回答前不得把该理解当成事实。
+- PM 不写生产代码、不跑 shell、不发布、不安装、不调度 VM/分身。
+- 只写 PRD/盘点文档；不改需求范围外的文件。
+
+# Output Format
+默认用简洁 Markdown 汇报，必须按任务需要包含：
+- WHY & WHAT
+- 六类现状矩阵：completed / unfinished / blocked / planned / conflicts / ambiguities
+- 冲突与歧义的用户决策点
+- 已保存的 PRD/Assessment id 与文档路径
+只输出已核实内容；未知、未验证、受限分别标明。`;
+export const PJM_SYSTEM_PROMPT = String.raw `# Role
+你是 DSH-Master「房主」的项目经理 Agent（PJM，preset: master-pjm）。你把已确认的 PRD 变成可执行、可追踪、可验收的项目计划，并按节点汇报直至结案。
+
+# Goals — HOW / WHO / WHERE / WHEN
+1. HOW：把 PRD 拆成 WBS，每步写清 prompt、依赖、验收、估时。
+2. WHO：给每一步分配 owner 与责任；未分配必须写 unassigned，不得虚构人员。
+3. WHERE：明确执行场景（宿主、fork、workspace、DSH Web）；脏任务只能在隔离执行体中运行。
+4. WHEN：给里程碑与估时；估时是计划，不是承诺工期。
+
+# Workflow
+1. 项目会审：核对 PRD、验收标准、约束、未决问题；未决项未解决不得自行扩权。
+2. 用 pjm_create_plan 建立七类项目内容：项目会审、WBS、需求内容、时间、人员、测试部署验收、结案。
+3. 执行前申请隔离资源，通过 pjm_dispatch_step 走 fangForker.spawn；不可用就 fail-closed，绝不在母体/原身本地降级执行，不虚构 vm_create/vm_exec。
+4. 用 pjm_project_status 汇总节点，用 todo_write 跟踪当前工作；完成步骤时记录 summary/evidence/actualMinutes。
+5. 用 pjm_write_project 保存计划与节点报告。全部步骤完成后才能 pjm_close_project；结案必须有总结、验收记录、评审报告和资料清单，并交付文档。
+
+# Rules
+- 按时、按质、按量报告真实状态；失败、阻塞、未测量不得包装成完成。
+- 不发布、不部署到生产、不修改 profile、不触碰凭据，除非用户对该动作另行明确授权。
+- 不代替 PM 决定需求，不替用户回答选择题；阻塞时给出原因、影响、可选方案和所需决策。
+- 不做无限轮询；节点汇报写完成/进行/待办/失败及下一步。
+
+# Output Format
+- 项目会审与范围
+- WBS 看板（Todo / In Progress / Done / Failed）
+- Owner、场景、估时、实际用时与依赖
+- 测试/部署/交付/验收证据
+- 结案：评审报告、验收记录、资料汇总
+- 仍需人类决策的事项（如有）`;

package/dist-host/agents/toolkit.js

@@ -0,0 +1,64 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 dsh-Master contributors — see LICENSE-CORE.
+// @ts-nocheck
+import { SERVICE, masterError, safeGet } from "../kernel.js";
+export function dualService(ctx) {
+    const service = safeGet(ctx, SERVICE.dual);
+    return service && service.pm && service.pjm ? service : null;
+}
+export function dualUnavailable() {
+    return masterError('dual-service-unavailable', 'dshMasterDual is required; enable master-dual-manager in this Host');
+}
+/** 注册一个返回结构化 JSON 的模型工具；异常也转成具名错误，不吞掉。 */
+export function jsonTool(name, description, parameters, execute) {
+    return {
+        name,
+        description,
+        parameters,
+        output: {
+            schema: { type: 'object' },
+            render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }],
+        },
+        async execute(args, exec) {
+            try {
+                return await execute(args && typeof args === 'object' ? args : {}, exec);
+            }
+            catch (error) {
+                return masterError('agent-tool-threw', String(error?.message ?? error), { tool: name });
+            }
+        },
+    };
+}
+/** 在 preset scope 内挂 persona 与 scoped tools，全部纳入 Cordis effect 生命周期。 */
+export function installAgent(ctx, { prompt, tools }) {
+    const systemPrompt = safeGet(ctx, 'systemPrompt');
+    const registry = safeGet(ctx, 'tools');
+    if (!systemPrompt || typeof systemPrompt.section !== 'function') {
+        return { ok: false, code: 'system-prompt-unavailable', error: 'ctx.systemPrompt with section() is required' };
+    }
+    if (!registry || typeof registry.register !== 'function') {
+        return { ok: false, code: 'tools-unavailable', error: 'ctx.tools with register() is required' };
+    }
+    const registered = [];
+    try {
+        ctx.effect(() => systemPrompt.section({ name: 'deployment:persona-prefix', order: 0, text: prompt }));
+    }
+    catch (error) {
+        return { ok: false, code: 'prompt-registration-failed', error: String(error?.message ?? error) };
+    }
+    for (const definition of tools) {
+        try {
+            ctx.effect(() => registry.register(definition));
+            registered.push(definition.name);
+        }
+        catch (error) {
+            return { ok: false, code: 'tool-registration-failed', error: String(error?.message ?? error), tool: definition.name, registered };
+        }
+    }
+    return { ok: true, tools: registered };
+}
+export const objectSchema = (properties = {}, required = []) => ({ type: 'object', properties, required, additionalProperties: true });
+export const string = (description = '') => ({ type: 'string', description });
+export const strings = (description = '') => ({ type: 'array', items: { type: 'string' }, description });
+export const objects = (description = '') => ({ type: 'array', items: { type: 'object', additionalProperties: true }, description });
+export const id = (description) => ({ type: 'string', description });

package/dist-host/dual/documents.js

@@ -0,0 +1,107 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 dsh-Master contributors — see LICENSE-CORE.
+// @ts-nocheck
+import { ASSESSMENT_CATEGORIES, planProgress } from "./schema.js";
+const lines = (items, render) => items.length ? items.map(render).join('\n') : '- （无）';
+const bullets = (items) => lines(items, (item) => `- ${item}`);
+const cell = (value) => String(value ?? '—').replaceAll('|', '\\|').replaceAll('\n', ' ');
+const CATEGORY_TITLES = {
+    completed: '1. 已完成（进度与证据）',
+    unfinished: '2. 未完成（原因与后续）',
+    blocked: '3. 无法实现 / 受阻（卡点）',
+    planned: '4. 已计划待开发',
+    conflicts: '5. 相互矛盾 / 冲突（待重新判断）',
+    ambiguities: '6. 理解歧义（待确认）',
+};
+export function renderPrdDocument(prd, assessment = null) {
+    return [
+        `# PRD · ${prd.title}`, '',
+        `- 文档 ID：\`${prd.id}\``,
+        `- 状态：${prd.status}`,
+        `- 优先级：${prd.priority}`,
+        `- 请求方：${prd.requester}`, '',
+        '## WHY · 解决什么问题、达成什么目标', '',
+        prd.why || prd.goal, '',
+        `**目标**：${prd.goal}`, '',
+        '## WHAT · 功能、模块、架构与结果', '',
+        bullets(prd.what), '',
+        '### 架构', '', prd.architecture || '（待补充）', '',
+        '### 模块', '',
+        lines(prd.modules, (item) => `- **${item.name}**（${item.status}）：${item.result || item.architecture || '待补充'}`), '',
+        '### 预期结果', '', bullets(prd.outcomes), '',
+        '## 约束与非目标', '',
+        '### 约束', '', bullets(prd.constraints), '',
+        '### 非目标', '', bullets(prd.nonGoals), '',
+        '## 验收标准', '', bullets(prd.acceptance), '',
+        '## 假设与待澄清问题', '',
+        '### 假设', '', bullets(prd.assumptions), '',
+        '### 待澄清', '', bullets(prd.openQuestions), '',
+        assessment ? `\n---\n\n${renderAssessmentDocument(assessment)}` : '',
+    ].join('\n').trim() + '\n';
+}
+export function renderAssessmentDocument(assessment) {
+    const out = [`# 产品现状盘点 · ${assessment.title}`, '', `- 盘点 ID：\`${assessment.id}\``, `- 关联 PRD：${assessment.prdId ?? '未关联'}`, ''];
+    if (assessment.why)
+        out.push('## WHY', '', assessment.why, '');
+    if (assessment.what.length)
+        out.push('## WHAT', '', bullets(assessment.what), '');
+    for (const category of ASSESSMENT_CATEGORIES) {
+        out.push(`## ${CATEGORY_TITLES[category]}`, '');
+        const items = assessment[category];
+        out.push(lines(items, (item) => {
+            if (category === 'completed')
+                return `- **${item.title}**（${item.progress}%）${item.detail ? `：${item.detail}` : ''}\n  - 证据：${item.evidence.join('；')}`;
+            if (category === 'unfinished')
+                return `- **${item.title}**：${item.reason}\n  - 后续：${item.nextStep || '待计划'}`;
+            if (category === 'blocked')
+                return `- **${item.title}**：${item.reason}\n  - 卡点：${item.blocker}\n  - 下一步：${item.nextStep || '待决策'}`;
+            if (category === 'planned')
+                return `- **${item.title}**（${item.priority}）：${item.plan || '待拆解'}${item.estimateMinutes ? `\n  - 估时：${item.estimateMinutes} 分钟` : ''}`;
+            if (category === 'conflicts')
+                return `- **${item.title}**：${item.question}\n  - 选项：${item.options.map((option) => `${option.value}=${option.label}`).join('；') || '待补充'}`;
+            return `- **${item.title}**：${item.question}\n  - 当前理解：${item.currentInterpretation || '未形成结论'}`;
+        }), '');
+    }
+    return out.join('\n').trim() + '\n';
+}
+export function renderProjectDocument(plan) {
+    const progress = planProgress(plan);
+    return [
+        `# 项目计划 · ${plan.title}`, '',
+        `- 计划 ID：\`${plan.id}\``,
+        `- 关联 PRD：\`${plan.prdId}\``,
+        `- 状态：${plan.status}`,
+        `- 进度：${progress.done}/${progress.total}（${progress.percent}%）`,
+        `- 总估时：${progress.estimatedMinutes} 分钟（估算，不是承诺工期）`, '',
+        '## 1. 项目会审', '', bullets(plan.projectReview), '',
+        '## 2. 项目计划（HOW / WHERE）', '', plan.how || '（待补充）', '', `**场景**：${plan.where}`, '',
+        '### WBS', '',
+        '| 步骤 | 内容 | Owner | 场景 | 估时(分钟) | 依赖 | 状态 |',
+        '|---|---|---|---|---:|---|---|',
+        ...plan.steps.map((step) => `| ${cell(step.id)} | ${cell(step.title)} | ${cell(step.owner)} | ${cell(step.where)} | ${step.estimateMinutes} | ${cell(step.dependsOn.join(', '))} | ${cell(step.status)} |`), '',
+        '## 3. 项目需求与内容', '', bullets(plan.requirements), '',
+        '## 4. 项目时间', '',
+        `- 开始时间：${plan.schedule.startAt ?? '待定'}`,
+        `- 总估时：${plan.schedule.totalEstimateMinutes} 分钟`, '',
+        lines(plan.schedule.milestones, (item) => `- **${item.title}**：${item.estimateMinutes} 分钟 · ${item.owner} · 依赖 ${item.dependsOn.join(', ') || '无'}`), '',
+        '## 5. 项目人员', '',
+        lines(plan.team, (item) => `- **${item.role}** · ${item.owner}：${item.responsibility || '待分配'}`), '',
+        '## 6. 测试、部署、交付与验收', '',
+        '### 测试', '', bullets(plan.quality.tests), '',
+        '### 部署', '', bullets(plan.quality.deployment), '',
+        '### 验收', '', bullets(plan.quality.acceptance), '',
+        '## 7. 项目结案', '',
+        plan.closure.status === 'closed' ? renderClosureDocument(plan) : '- 尚未结案；必须全部步骤完成后才能结案。',
+    ].join('\n').trim() + '\n';
+}
+export function renderClosureDocument(plan) {
+    const closure = plan.closure;
+    return [
+        `### 结案状态：${closure.status}`, '',
+        `- 结案时间：${closure.closedAt ?? '未结案'}`,
+        `- 总结：${closure.summary || '未填写'}`, '',
+        '#### 评审报告', '', closure.reviewReport || '（待补充）', '',
+        '#### 验收记录', '', bullets(closure.acceptance), '',
+        '#### 项目资料汇总', '', bullets(closure.artifacts), '',
+    ].join('\n');
+}