@luchenglong/cli-bridge 0.2.7 → 0.2.8

package/CHANGELOG.md

@@ -9,6 +9,54 @@ GitHub Release（`scripts/verify.mjs` 在 CI 与 prepack 双重锁一致）。
 > - CodeBuddy 线：[docs/history/codebuddy/CHANGELOG.md](docs/history/codebuddy/CHANGELOG.md)（终版 1.6.2）
 > - MiMo 线：[docs/history/mimo/CHANGELOG.md](docs/history/mimo/CHANGELOG.md)（终版 1.2.9）
 
+## [0.2.8] - 2026-10-18
+
+> 用户使用 agy 优先模式时整轮失败：
+> `unknown prompt variable "{{cwd}}" in section "deployment:persona-suffix"; registered variables: provider, model`。
+> 根因是**预设从旧版上游模板转录**，继承了上游在实装 `0.2.1-alpha.5` 已删除的三类写法。
+> 完整方案与逐项取证：[docs/audits/2026-10-18-preset-0.2.1-contract-fix.md](docs/audits/2026-10-18-preset-0.2.1-contract-fix.md)。
+
+### Fixed
+
+- **预设整体不可用：persona `suffix` 里的 `{{cwd}}` 不是注册变量**。`dsh-system-prompt` 的
+  `interpolate()` 对 `{{name}}` 严格解析（须匹配 `/^[a-z][a-z0-9_]*$/` 且**已注册**），
+  未注册引用会在**任何模型请求之前**抛错 ⇒ 该预设完全不可用。当前循环只注册 `provider` 与
+  `model`（`dsh-agent-loop`），工作目录已改由 working-directory 服务以「不插值的用户上下文」
+  提供 —— 官方预设的 persona 因此**只有 `prefix`**。已在 `standard-base.mjs` 与
+  agy/mimo/opencode 三个单源里删除 `suffix`，并重新生成四个 `agent.cordis.yml`。
+- **`cordis-mimo` 整个预设挂载失败：`tool-subagent.config.persona`**。`dsh-tool-subagent`
+  0.2.1 起在 `apply()` 里对 `persona`/`toolFilter` **显式 throw**
+  （"…no longer supported; configure persona and tool plugins in an Agent Preset and select it
+  with agentPreset (spawn only)"）。原委派人格已**迁移**为成员预设（见 Added），能力未丢失。
+- **死配置 `backgroundMode`**（四行委派行都有）。该字段已从 DSH 全部包移除，且实装 schema
+  **会放行并保留**它（`Config['~standard'].validate` 无 issues；schemastery 没有 strict 开关），
+  只是**无人读取** ⇒ 静默**忽略**而非丢弃：表面声明 `continuable`/`one-shot` 却毫无效果，
+  且**运行时不报错**。已删除。
+
+### Added
+
+- **成员预设 `cordis-mimo-member`**（`preset/mimo-member/plugin-list.mjs`）：人格 = 旧委派指令
+  verbatim；工具面 = mimo 桥接行（子 agent 必须能调 `mimo_run` 才能"派活"）+ 只读文件面
+  （旧 `toolFilter` 白名单的新表达：`write`/`edit` 直接不存在）。`cordis-mimo` 的 **spawn**
+  行以 `agentPreset` 引用它；**fork 行不设**（`agentPreset` 仅 in-process spawn 支持，
+  fork/外部后端会 reject）。成员预设**先于**主预设注册（委派行 `validate()` 会经
+  `presets.readDocument(id)` 校验引用存在）。
+- **防回归闸门 `tests/keystone/persona-prompt-vars.test.mjs`**：persona 的 `{{var}}` 必须在注册
+  白名单内且不设 `suffix`；`tool-subagent` 行不得带已删字段；委派行的 `agentPreset` 必须等于
+  成员预设 `meta.id` 且只出现在 `spawn` 行。内存单源 + 磁盘生成物双层。三道闸门均已实测
+  **按正确原因变红**后再保留。
+
+### Changed
+
+- `tests/keystone/scheduling-gate.test.mjs` 的注册顺序期望改为从成员表派生
+  （`[...memberPresetIds(ids), ...provider presets]`），不硬编码。
+
+### 未跟进（能力面差异，非缺陷）
+
+- 相对实装 `dsh-web-app@0.2.1-alpha.5` 的官方 standard 预设（35 行），本包基线（对齐官方
+  `0.1.7-rc.1`，33 行）缺 `time-context`、`tool-schedule`、`tool-plugin-market`。属能力面差异，
+  是否跟进待定。
+
 ## [0.2.7] - 2026-10-18
 
 > 0.2.6 发布后立即发现两件事必须纠正，故 0.2.7 紧随其后。

package/docs/HANDOVER.md

@@ -317,6 +317,15 @@ npm whoami          # 应输出 luchenglong
   已收敛到 `mcp/version.mjs` 单一来源（红线 §5.8）。
 - **测试里硬编码 id 列表**：4 个 keystone 测试钉死三家 id，新增 provider 即红 → 违反单一 id 轴。
   已全部改为从 `PROVIDER_IDS` 派生（红线 §5.4）。
+- **预设契约随 DSH 版本漂移**（2026-10-18）：预设从**旧版上游模板**转录，继承了上游已删除的写法 →
+  ① persona `suffix` 里的 `{{cwd}}` 不再是注册变量（DSH 只注册 `provider`/`model`），
+  组装期直接 throw，**整个预设不可用**；② `dsh-tool-subagent` 0.2.1 起 `persona`/`toolFilter`
+  在 `apply()` 里显式 throw、`backgroundMode` 被静默**忽略**（注意：不是"被 schema 丢弃" ——
+  实测实装 schema 会**放行并保留**该键，只是无人读取；所以运行时不报错，只能靠静态闸门拦）。
+  已修 + 立三层闸门（`tests/keystone/persona-prompt-vars.test.mjs`）。
+  **完整方案与取证：`docs/audits/2026-10-18-preset-0.2.1-contract-fix.md`**（索引 `docs/audits/README.md`）。
+  教训：上游预设模板是**会过期**的参考物，升级 DSH 后必须重新对照已实装包的
+  `presets/*.patch.yml` 与 `lib/index.js` 的 schema，不能沿用旧转录。
 
 ## 13. OpenCode provider（0.2.3 新增）
 

package/docs/audits/2026-10-18-preset-0.2.1-contract-fix.md

@@ -0,0 +1,160 @@
+# 审计：DSH 0.2.1 预设契约漂移修复（2026-10-18）
+
+> 起因：用户使用 **agy 优先模式**时整轮失败 ——
+> `unknown prompt variable "{{cwd}}" in section "deployment:persona-suffix"; registered variables: provider, model`
+>
+> 修复范围：本仓（`@luchenglong/cli-bridge`）+ 姊妹仓 `agy-first-bridge`。
+> 本文是**修复方案 + 结果审计**存档（用户规则 #29），并与 `docs/HANDOVER.md` §12 速查表互相索引。
+
+---
+
+## 1. 根因
+
+DSH 的提示词组装器 `interpolate()`（`dsh-system-prompt/lib/index.js:158-182`）对 `{{name}}` 做**严格解析**：
+
+| 判据 | 源码 | 违反后果 |
+|---|---|---|
+| 完整 `{{…}}` 组 | `GROUP_AT = /^\{\{([^{}]*)\}\}/`（:65） | 有 `}}` 却不成组 → `malformed prompt variable reference` |
+| 名字形态 | `VARIABLE_NAME = /^[a-z][a-z0-9_]*$/`（:63） | `{{cwd }}`（含空格）也算 malformed |
+| **必须已注册** | `if (!Object.hasOwn(variables, name)) throw`（:172-174） | `unknown prompt variable` |
+
+关键：它在**任何模型请求之前**、组装系统提示词时抛错 ⇒ 整个回合失败，且该预设**完全不可用**（不是降级、不是警告）。
+
+**当前只注册两个变量**（已全量取证）：
+
+- `dsh-agent-loop/lib/index.js:1591-1592` —— `provider` / `model`，全仓无第二个注册点。
+- 官方 `dsh-system-prompt/README.zh.md:72` —— 工作目录改由 working-directory 服务以
+  **不执行插值的用户上下文**提供；`:78` 明确要求从 preset 的 `suffix` 字段移除该句。
+- 实装 `dsh-web-app@0.2.1-alpha.5` 的 `presets/{standard,ptc,cordis,minimal}.patch.yml`
+  的 persona **只有 `prefix`**，没有 `suffix`。
+
+**为什么现在才炸（漂移性质）**：上游预设在 `0.1.5-rc.2` ~ `0.1.7-rc.1` 期间**确实带**这句
+（`agy-first-bridge/.probe/wa-*` 逐版留证 16 处），到 `0.2.1-alpha.5` 才移除。
+本仓预设从**旧版上游模板转录**而来 ⇒ 继承了被上游删除的 suffix。
+属"上游改版、下游转录物陈旧"型漂移，**不是**当初写错。
+
+---
+
+## 2. 第二类缺陷（同一主题，独立成因）
+
+排查"还有没有同类问题"时又查出两类 **dsh-tool-subagent 契约漂移**：
+
+| 字段 | 0.2.1 行为 | 证据 | 影响 |
+|---|---|---|---|
+| `persona` | **显式 throw** | `dsh-tool-subagent/lib/index.js:355`：`for (const field of ["persona","toolFilter"]) if (Object.hasOwn(config, field)) throw new Error("tool-subagent: … is no longer supported; configure persona and tool plugins in an Agent Preset and select it with agentPreset (spawn only)")` | **mimo 预设整个挂载失败** |
+| `toolFilter` | 同上 | 同上 | 同上 |
+| `backgroundMode` | **静默忽略（非丢弃）** | 该字段已从 DSH 全部包消失（实测全仓 0 命中）；且实装 schema **会放行**它 —— 见下方更正 | 声明 `continuable`/`one-shot` 却毫无效果，**运行时不报错** |
+
+> **⚠ 机制更正（2026-10-18 独立验证查出）**：初稿写"`Config` 不是 strict ⇒ 被静默丢弃"是**错的**。
+> 用实装包双路径实测：`Config({provider, backgroundMode})` 与 cordis 真正走的
+> `Config['~standard'].validate(...)`（`cordis/lib/index.js:958`）**都无 issues 且把该键原样保留**；
+> `Config.strict` 为 `undefined` —— schemastery **根本没有 strict 开关**。
+> 正确表述：未知/已删键**通过校验并被保留**，随后**无人读取** ⇒ 静默**忽略**。
+> 这条更正很关键：正因为校验放行，**运行时永远抓不到这类死字段**，静态闸门是唯一防线；
+> 而"schema 会丢"的错误表述会让人误以为 schema 层已兜住。
+> 附带影响：键被保留 ⇒ 任何对 config 的反射/对比/序列化都可能把它当**幽灵设置**暴露出来。
+
+当前 `Config` 接受：`provider` / `toolName` / `modelSelectionSettings` / `agentOptions` /
+`agentPreset` / `allowedAgentPresets` / `maxDepth`。
+
+---
+
+## 3. 修复方案
+
+### 3.1 变量契约（`{{cwd}}`）
+
+删除所有 preset 的 persona `suffix`，保留 `prefix` 的 `{{model}}`。与官方预设形态一致。
+
+| 文件 | 性质 |
+|---|---|
+| `preset/standard-base.mjs` | **源头**（共享基座；codebuddy 经它继承） |
+| `preset/agy-first/plugin-list.mjs`、`preset/mimo-first/plugin-list.mjs`、`preset/opencode-first/plugin-list.mjs` | **源头**（各自 persona 覆盖） |
+| `preset/{agy,codebuddy,mimo,opencode}-first/agent.cordis.yml` | **生成物** —— 由 `node scripts/build.mjs` 从上述源头重新生成 |
+
+> ⚠️ 只改生成物无效：`npm test` 里的 `build --check` 会判漂移失败。
+
+### 3.2 死字段（`backgroundMode`）
+
+从 `preset/standard-base.mjs` 的委派组四行中删除。
+
+### 3.3 mimo 委派人设 → 成员预设（迁移，不删能力）
+
+0.2.1 的契约是"人格与工具面放进独立 Agent Preset，由委派行经 `agentPreset` 选择"。
+新增成员预设 + 让 spawn 行引用它，**保留**"子 agent 优先把活派给 mimo_run"这一能力。
+
+| 新增/改动 | 内容 |
+|---|---|
+| **新增** `preset/mimo-member/plugin-list.mjs` | 成员预设单源：人格（旧委派指令 verbatim）+ mimo 桥接工具面（子 agent 必须能调 `mimo_run`）+ 只读文件面（旧 `toolFilter` 白名单的新表达：`write/edit: false`） |
+| `preset/mimo-first/plugin-list.mjs` | 删 `persona`/`toolFilter`；**仅 spawn 行**加 `agentPreset: cordis-mimo-member`（`fork` 与外部后端会 reject 该字段） |
+| `home-plugin/…/lib/preset-declarations.mjs` | 新增 `declareMemberPresets()` 并在主预设**之前**注册；导出 `memberPresetIds()` 供测试派生 |
+
+**可行性取证（关键，避免了错误的实现路径）**：
+
+```js
+// dsh-agent-preset-registry/lib/index.js
+async register(definition) { … this.definitions.set(definition.id, record) }   // :470-479 写
+readDocument(agentPreset) { const record = this.definitions.get(agentPreset) … } // :613 读**同一个 Map**
+```
+
+而委派行 `validate()` 正是用 `presets.readDocument(id)` 校验引用
+（`dsh-tool-subagent/lib/index.js:228-232`，未注册即 `agent-preset/not-found`）。
+⇒ **动态 `register()` 与 bundle 行声明互通**，无需改用 bundle 行，
+因而不破坏本包"旧 DSH 上不因行 import 失败而整包拒挂"的既有设计（见 `cordis.patch.yml` 头注）。
+
+顺序要求：成员预设**先于**主预设注册（kexi-crypto v1.9.21 同款结论）。
+
+---
+
+## 4. 防回归闸门
+
+新增 `tests/keystone/persona-prompt-vars.test.mjs`（15 项），三层同时覆盖：
+
+1. **内存单源层** —— 对 5 个 preset 目录（4 provider + 1 成员）的 `buildPlugins()` 输出断言：
+   - persona 的 `prefix`/`suffix` 里每个 `{{var}}` ∈ `['provider','model']`；
+   - `suffix` 必须缺席；
+   - `tool-subagent` 行不含 `persona`/`toolFilter`/`backgroundMode`。
+2. **磁盘生成物层** —— 对 4 个 `agent.cordis.yml` 全文同样断言（防只手改生成物）。
+   字段用**键正则** `(^|\n)[ \t]*<field>[ \t]*:` 匹配，而非子串 —— 否则
+   `name: '@deepseek-ai/dsh-persona'` 与 `- id: persona` 会误报。
+3. **跨文件一致性层** —— 委派行引用的 `agentPreset` 必须等于成员预设的 `meta.id`，
+   且只允许出现在 `provider: spawn` 行上（fork/外部后端会 reject）。
+
+`tests/keystone/scheduling-gate.test.mjs` 与 `tests/mimo/plugin-list.test.mjs` 同步改造：
+注册顺序期望改为 `[...memberPresetIds(ids), ...provider presets]`（从单一源派生，不硬编码）。
+
+---
+
+## 5. 验证结果（本机实测）
+
+| 命令 | 结果 |
+|---|---|
+| `node scripts/build.mjs --check` | `[build] up to date`，exit 0 |
+| `node --test` | **373 tests / 372 pass / 0 fail / 1 skipped**，exit 0（20.5s） |
+| `node scripts/verify.mjs` | `verify: OK`（含导出目标、四 provider 描述符、凭据扫描 201 文件） |
+| `node mcp/cli-bridge-mcp.mjs --check` | `"errors": []`，exit 0 |
+| 静态复核 | mimo 生成物含 `agentPreset: cordis-mimo-member`、**无** `persona:` 字段、无 `backgroundMode`、4 个 yml 均无 `{{cwd}}` |
+
+**闸门"确实会红"取证**（临时注入缺陷 → 跑闸门 → 还原，三次均按**正确原因**变红）：
+
+| 注入的缺陷 | 闸门报错 |
+|---|---|
+| 删掉 spawn 行的 `agentPreset` | `本 provider 应至少有一行经 agentPreset 选择成员预设` |
+| 把 `persona` 写回 spawn 行 | `tool-subagent 行 'tool-subagent' 仍带已删除字段 persona` |
+| 成员预设 `id` 改成 `cordis-mimo-member-TYPO` | `tool-subagent 行 'tool-subagent' 的 agentPreset 与成员预设 id 不一致` |
+
+另：`{{cwd}}` 的闸门在修复过程中亦已实测会红（写回后 `agent.cordis.yml 引用了未注册变量 {{cwd}}`）。
+全部场景还原后复跑均恢复绿。
+
+---
+
+## 6. 未做 / 遗留
+
+- **未发版**：未 bump `package.json` 版本、未加 `CHANGELOG.md` 条目、未 `npm publish`、未 commit。
+- **姊妹仓**：`agy-first-bridge` 的同类修复由并行同伴完成并独立复跑验证，同样未发版。
+- **历史留证未动**：`docs/history/**/CHANGELOG.md` 与 `agy-first-bridge/.probe/**` 里的 `{{cwd}}`
+  字面量是"上游旧版确有该 suffix"的原始证据，**故意保留**。
+- **面未覆盖**：本次只治理 preset 内的人格模板；宿主层 `personaSuffix`、
+  家级/profile `cordis.patch.yml` 若也有未注册引用，需另行排查（本闸门不覆盖）。
+- **成员预设工具面偏窄**（刻意）：只给只读文件面 + 桥接行。若希望子 agent 能自己跑构建做验证，
+  需在 `preset/mimo-member/plugin-list.mjs` 里补平台门控 shell —— 属产品取舍，未擅自加。
+- **`.probe/` 留证已过期**（只到 `0.1.7-rc.1`，实装已 `0.2.1-alpha.5`）：若要复算上游轨迹需重取该版本 tarball。

package/docs/audits/README.md

@@ -0,0 +1,15 @@
+# docs/audits — 修复方案与结果审计存档
+
+本目录按"一事一档"存放**修复方案 + 验证结果 + 取证**，供后来者追溯"当时为什么这么改、
+验证到什么程度、还有什么没做"。索引如下（新档请追加一行）。
+
+| 日期 | 主题 | 档 |
+|---|---|---|
+| 2026-10-18 | DSH 0.2.1 预设契约漂移：`{{cwd}}` 未注册变量、`tool-subagent` 已删字段、mimo 委派人设迁移为成员预设 | [2026-10-18-preset-0.2.1-contract-fix.md](./2026-10-18-preset-0.2.1-contract-fix.md) |
+
+相关索引：
+
+- 事故速查表：`docs/HANDOVER.md` §12
+- 排障手册（症状 → 原因 → 处置）：`docs/HANDOVER.md` §10
+- 不可动的契约（红线）：`docs/HANDOVER.md` §5
+- 发布流程：`docs/RELEASE-SOP.md`

package/home-plugin/cli-bridge-indicator/lib/preset-declarations.mjs

@@ -27,6 +27,23 @@ export const PKG_NAME = '@luchenglong/cli-bridge'
 // 三个旧包时代的遗留布局，provider id 不带 —— 这里不映射就永远找不到 plugin-list）。
 const PRESET_DIRS = { agy: 'agy-first', codebuddy: 'codebuddy-first', mimo: 'mimo-first', opencode: 'opencode-first' }
 
+// 【成员预设】0.2.1 起 dsh-tool-subagent 的 config 不再接受 persona/toolFilter（apply()
+// 里显式 throw），角色人格只能作为独立 Agent Preset 存在、由委派行经 agentPreset 选择。
+// key = provider id（决定它是否随该 provider 的启用面注册，与主预设的启用语义一致）；
+// value = { id: 预设身份（委派行按它选择）, dir: preset/<dir>/plugin-list.mjs }。
+// ⚠ 必须**先于**对应 provider 的主预设注册：主预设委派行的 validate() 会对每个
+// agentPreset id 调 presets.readDocument(id)，未注册即抛 agent-preset/not-found，
+// 而 apply() 一抛就拖垮整组预设挂载（这正是 mimo 在 0.2.1 上挂载失败的根因链）。
+const MEMBER_PRESETS = { mimo: { id: 'cordis-mimo-member', dir: 'mimo-member' } }
+
+/** 只读视图：provider id → 成员预设 id（测试与诊断从它派生，避免第二处硬编码）。 */
+export function memberPresetIds(ids) {
+  const list = ids || []
+  return Object.entries(MEMBER_PRESETS)
+    .filter(([providerId]) => list.includes(providerId))
+    .map(([, member]) => member.id)
+}
+
 const HERE = dirname(fileURLToPath(import.meta.url))
 const ROOT = join(HERE, '..', '..', '..')
 
@@ -46,26 +63,85 @@ function realize(v, seen) {
   return out
 }
 
-async function loadPluginList(id) {
-  const abs = join(ROOT, 'preset', PRESET_DIRS[id] || id, 'plugin-list.mjs')
+/** 按 preset 目录名加载单源 plugin-list（provider 预设与成员预设共用）。 */
+async function loadPluginListDir(dir) {
+  const abs = join(ROOT, 'preset', dir, 'plugin-list.mjs')
   if (!existsSync(abs)) return null
   const mod = await import(pathToFileURL(abs).href)
   if (!mod || typeof mod.buildPlugins !== 'function' || !mod.meta) return null
   return mod
 }
 
+async function loadPluginList(id) {
+  return loadPluginListDir(PRESET_DIRS[id] || id)
+}
+
 /**
- * 生成某 provider 的 agentPresets 定义（真函数已落地；不含任何 DSH 活对象）。
+ * 按【目录名】生成 agentPresets 定义（真函数已落地；不含任何 DSH 活对象）。
+ * bridgeName 决定桥接行的入口子路径：provider 预设用 '/preset-<id>'，成员预设用
+ * 其所属 provider 的同一入口（子 agent 要能调到该 provider 的 run 工具）。
  * @returns {Promise<{id,name,description,order,plugins}|null>}
  */
-export async function buildPresetDefinition(id) {
-  const mod = await loadPluginList(id)
+async function buildDefinitionFromDir(dir, bridgeName) {
+  const mod = await loadPluginListDir(dir)
   if (!mod) return null
   const meta = mod.meta
-  const plugins = realize(mod.buildPlugins({ bridgeName: PKG_NAME + '/preset-' + id }) || [], [])
+  const plugins = realize(mod.buildPlugins({ bridgeName }) || [], [])
   return { id: meta.id, name: meta.name || meta.id, description: meta.description || '', order: meta.order != null ? meta.order : 10, plugins }
 }
 
+/**
+ * 生成某 provider 的 agentPresets 定义。
+ * @returns {Promise<{id,name,description,order,plugins}|null>}
+ */
+export async function buildPresetDefinition(id) {
+  return buildDefinitionFromDir(PRESET_DIRS[id] || id, PKG_NAME + '/preset-' + id)
+}
+
+/**
+ * 注册某 provider 的成员预设（先行注册）。只注册启用面里的 provider，与主预设一致。
+ * @param ctx - 指示灯插件的 context。
+ * @param out - 与主预设共用的诊断数组。
+ * @param ids - 已启用（按调度顺序）的 provider id 列表。
+ */
+function declareMemberPresets(ctx, out, ids) {
+  if (typeof ctx.inject !== 'function') return
+  for (const [providerId, member] of Object.entries(MEMBER_PRESETS)) {
+    if (!ids.includes(providerId)) continue
+    try {
+      ctx.inject(['agentPresets'], (child) => {
+        child.effect(() => {
+          let disposer = null
+          const registering = (async () => {
+            try {
+              const def = await buildDefinitionFromDir(member.dir, PKG_NAME + '/preset-' + providerId)
+              if (!def) { out.push({ id: member.id, ok: false, error: 'plugin-list missing' }); return }
+              disposer = await child.agentPresets.register(def)
+              out.push({ id: member.id, ok: true, member: true })
+            } catch (e) {
+              out.push({ id: member.id, ok: false, error: String(e && e.message || e) })
+              try {
+                if (child.logger && typeof child.logger.warn === 'function') {
+                  child.logger.warn('cli-bridge: member preset ' + member.id + ' registration skipped: ' + (e && e.message || e))
+                }
+              } catch (_) { }
+            }
+          })()
+          return async () => {
+            try { await registering } catch (_) { }
+            if (typeof disposer === 'function') {
+              try { await disposer() } catch (_) { }
+            }
+            disposer = null
+          }
+        }, 'cli-bridge: member preset declaration ' + member.id)
+      })
+    } catch (e) {
+      out.push({ id: member.id, ok: false, error: String(e && e.message || e) })
+    }
+  }
+}
+
 /**
  * 在 indicator 的 ctx 上挂「agentPresets 就绪 → 注册启用面的 preset」等待器。
  * 返回每个 provider 的注册状态数组（诊断用）；任何异常都不外抛。
@@ -89,6 +165,9 @@ export function declareBridgePresets(ctx, opts) {
   }
   const out = []
   if (typeof ctx.inject !== 'function') return out
+  // 成员预设先注册：主预设委派行的 validate() 会经 presets.readDocument(id) 校验
+  // agentPreset 引用存在，未注册即抛 agent-preset/not-found。
+  declareMemberPresets(ctx, out, ids)
   for (const id of ids) {
     try {
       ctx.inject(['agentPresets'], (child) => {

package/mcp/cli-bridge-mcp.mjs

@@ -31,7 +31,7 @@ import * as mimoMcp from './providers/mimo.mjs'
 import * as opencodeMcp from './providers/opencode.mjs'
 
 const SERVER_NAME = 'cli-bridge-mcp'
-const SERVER_VERSION = '0.2.7'
+const SERVER_VERSION = '0.2.8'
 const PROTOCOL = '2024-11-05'
 
 const PROVIDERS = [agyMcp, codebuddyMcp, mimoMcp, opencodeMcp]
@@ -183,4 +183,4 @@ process.stdin.on('data', (d) => {
 process.stdin.on('end', () => { stdinClosed = true; maybeExit() })
 process.on('SIGINT', () => process.exit(0))
 process.on('SIGTERM', () => process.exit(0))
-
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luchenglong/cli-bridge",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "CLI Bridge for DeepSeek Harness (DSH): one package bridging four local coding-CLI agents — agy (Google Antigravity CLI), Tencent CodeBuddy Code, Xiaomi MiMo (MiMoCode / MiMo Desktop), and OpenCode. Each provider keeps its own agent preset (cordis-agy / codebuddy-first / cordis-mimo / opencode-first), tools (agy_run / codebuddy_run / mimo_run / opencode_run + continue + status), rate-limit/network fallback dialog, and zero-dependency MCP server, unified under a single home-level status light, one settings file, and one bundle patch. Merges agy-first-bridge, codebuddy-first-bridge and mimo-first-bridge.",
   "license": "MIT",
   "publishConfig": {
@@ -89,7 +89,7 @@
     "url": "https://github.com/new-256/cli-bridge/issues"
   }
 }
-
-
-
-
+
+
+
+

package/preset/agy-first/agent.cordis.yml

@@ -4,7 +4,6 @@
 - id: persona
   name: '@deepseek-ai/dsh-persona'
   config:
-    suffix: 'Your working directory is {{cwd}}.'
     prefix: 'You are a coding agent powered by the {{model}} model.'
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'
@@ -86,20 +85,17 @@
         provider: spawn
         toolName: subagent
         modelSelectionSettings: true
-        backgroundMode: continuable
     - id: tool-subagent-fork
       name: '@deepseek-ai/dsh-tool-subagent'
       config:
         provider: fork
         toolName: subagent_fork
-        backgroundMode: continuable
     - id: tool-subagent-codex
       name: '@deepseek-ai/dsh-tool-subagent'
       disabled: true
       config:
         provider: codex
         toolName: subagent_codex
-        backgroundMode: one-shot
         maxDepth: provider-managed
     - id: tool-subagent-claude-code
       name: '@deepseek-ai/dsh-tool-subagent'
@@ -107,7 +103,6 @@
       config:
         provider: claude-code
         toolName: subagent_claude_code
-        backgroundMode: one-shot
         maxDepth: provider-managed
     - id: workflow-ptc
       name: '@deepseek-ai/dsh-workflow-ptc'

package/preset/agy-first/plugin-list.mjs

@@ -16,10 +16,13 @@ export function buildPlugins(deps) {
   const rows = standardPluginRows()
   // 旧仓 agent.cordis.yml persona 段 verbatim（v1.5.15：dsh-persona 要求
   // prefix 必填 + suffix 可选；旧单 text: 字段被 schema 拒绝）。
+  // 2026-10-18：不再设置 suffix —— 当前 DSH 只注册 provider/model 两个提示词变量，
+  // 工作目录由 working-directory 服务作为不插值的用户上下文提供，写 {{cwd}} 会让
+  // 本预设整轮组装失败（unknown prompt variable）。delete 兼防基座再引入 suffix。
   const persona = rows.find((r) => r.id === 'persona')
   if (persona && persona.config) {
     persona.config.prefix = 'You are a coding agent powered by the {{model}} model.'
-    persona.config.suffix = 'Your working directory is {{cwd}}.'
+    delete persona.config.suffix
   }
   rows.push(bridgeRow('agy', deps && deps.bridgeName))
   return rows

package/preset/codebuddy-first/agent.cordis.yml

@@ -4,7 +4,6 @@
 - id: persona
   name: '@deepseek-ai/dsh-persona'
   config:
-    suffix: 'Your working directory is {{cwd}}.'
     prefix: 'You are a coding agent powered by the {{model}} model.'
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'
@@ -86,20 +85,17 @@
         provider: spawn
         toolName: subagent
         modelSelectionSettings: true
-        backgroundMode: continuable
     - id: tool-subagent-fork
       name: '@deepseek-ai/dsh-tool-subagent'
       config:
         provider: fork
         toolName: subagent_fork
-        backgroundMode: continuable
     - id: tool-subagent-codex
       name: '@deepseek-ai/dsh-tool-subagent'
       disabled: true
       config:
         provider: codex
         toolName: subagent_codex
-        backgroundMode: one-shot
         maxDepth: provider-managed
     - id: tool-subagent-claude-code
       name: '@deepseek-ai/dsh-tool-subagent'
@@ -107,7 +103,6 @@
       config:
         provider: claude-code
         toolName: subagent_claude_code
-        backgroundMode: one-shot
         maxDepth: provider-managed
     - id: workflow-ptc
       name: '@deepseek-ai/dsh-workflow-ptc'

package/preset/mimo-first/agent.cordis.yml

@@ -4,7 +4,6 @@
 - id: persona
   name: '@deepseek-ai/dsh-persona'
   config:
-    suffix: 'Your working directory is {{cwd}}.'
     prefix: 'You are a coding agent powered by the {{model}} model.'
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'
@@ -86,22 +85,18 @@
         provider: spawn
         toolName: subagent
         modelSelectionSettings: true
-        backgroundMode: continuable
-        persona: 'Delegation directive: you are a child agent in a MiMo-first session. Before doing any coding, building, debugging, or multi-file investigation work yourself, check whether the mimo_run tool (or the MCP form mcp__mimo__mimo_run) is available to you; if it is, dispatch that work to mimo first per the MiMo-first policy, then verify its output with your own read-only tools. Reserve your own direct work for quick read-only lookups and final verification.'
+        agentPreset: cordis-mimo-member
     - id: tool-subagent-fork
       name: '@deepseek-ai/dsh-tool-subagent'
       config:
         provider: fork
         toolName: subagent_fork
-        backgroundMode: continuable
-        persona: 'Delegation directive: you are a child agent in a MiMo-first session. Before doing any coding, building, debugging, or multi-file investigation work yourself, check whether the mimo_run tool (or the MCP form mcp__mimo__mimo_run) is available to you; if it is, dispatch that work to mimo first per the MiMo-first policy, then verify its output with your own read-only tools. Reserve your own direct work for quick read-only lookups and final verification.'
     - id: tool-subagent-codex
       name: '@deepseek-ai/dsh-tool-subagent'
       disabled: true
       config:
         provider: codex
         toolName: subagent_codex
-        backgroundMode: one-shot
         maxDepth: provider-managed
     - id: tool-subagent-claude-code
       name: '@deepseek-ai/dsh-tool-subagent'
@@ -109,7 +104,6 @@
       config:
         provider: claude-code
         toolName: subagent_claude_code
-        backgroundMode: one-shot
         maxDepth: provider-managed
     - id: workflow-ptc
       name: '@deepseek-ai/dsh-workflow-ptc'

package/preset/mimo-first/plugin-list.mjs

@@ -1,7 +1,6 @@
 // preset/mimo-first/plugin-list.mjs — cordis-mimo 预设的单源插件清单（PROVIDER-CONTRACT §5）。
 //
-// = 官方 standard 基线（standard-base.mjs）+ mimo 桥接行 + persona/委派差异（旧仓
-// preset/mimo-first/agent.cordis.yml 的 persona 与 tool-subagent 委派文案 verbatim）。
+// = 官方 standard 基线（standard-base.mjs）+ mimo 桥接行 + 委派差异。
 // preset id 'cordis-mimo' 是旧会话头引用，不可变。
 import { standardPluginRows, bridgeRow } from '../standard-base.mjs'
 
@@ -12,26 +11,33 @@ export const meta = {
   order: 10
 }
 
-// 旧 agent.cordis.yml 的 tool-subagent（spawn/fork）委派指令文案 verbatim：
-// 子 agent 在 MiMo-first 会话里优先把编码工作派给 mimo_run。
-const MIMO_DELEGATION_PERSONA = 'Delegation directive: you are a child agent in a MiMo-first session. Before doing any coding, building, debugging, or multi-file investigation work yourself, check whether the mimo_run tool (or the MCP form mcp__mimo__mimo_run) is available to you; if it is, dispatch that work to mimo first per the MiMo-first policy, then verify its output with your own read-only tools. Reserve your own direct work for quick read-only lookups and final verification.'
+/**
+ * 子 agent 所用的成员预设 id（人格与工具面在 preset/mimo-member/plugin-list.mjs）。
+ * 0.2.1 起角色人格不能再写在 dsh-tool-subagent 行上，只能由 agentPreset 指向独立预设。
+ */
+export const MEMBER_PRESET_ID = 'cordis-mimo-member'
 
 export function buildPlugins(deps) {
   const rows = standardPluginRows()
-  // persona 行：旧仓 mimo 的 prefix/suffix 与官方 standard 逐字一致（{{model}}/{{cwd}}），
-  // 无差异；保留取回逻辑以便上游若分化时单点修改。
+  // persona 行：prefix 与官方 standard 逐字一致（{{model}}）。
+  // 2026-10-18：不再设置 suffix —— DSH 只注册 provider/model 两个变量，工作目录由
+  // working-directory 服务以不插值的用户上下文提供，{{cwd}} 会让本预设整轮组装失败。
   const persona = rows.find((r) => r.id === 'persona')
   if (persona && persona.config) {
     persona.config.prefix = 'You are a coding agent powered by the {{model}} model.'
-    persona.config.suffix = 'Your working directory is {{cwd}}.'
+    delete persona.config.suffix
   }
-  // 委派组：给 spawn/fork 两个 tool-subagent 行注入 MiMo-first 委派 persona（旧 yml）。
+  // 委派组：0.2.1 起人格与工具面属于【独立成员预设】，委派行只用 agentPreset 选择它。
   const delegation = rows.find((r) => r.id === 'delegation')
   if (delegation && Array.isArray(delegation.config)) {
     for (const child of delegation.config) {
-      if (child && child.name === '@deepseek-ai/dsh-tool-subagent' && child.config && (child.config.provider === 'spawn' || child.config.provider === 'fork')) {
-        child.config.persona = MIMO_DELEGATION_PERSONA
-      }
+      if (!child || child.name !== '@deepseek-ai/dsh-tool-subagent' || !child.config) continue
+      // persona/toolFilter 会被 dsh-tool-subagent 的 apply() 直接 throw，写进去就是
+      // 整个预设挂载失败 —— 一律删除（人格已迁到成员预设）。
+      delete child.config.persona
+      delete child.config.toolFilter
+      // agentPreset 只有 in-process spawn 支持；fork 与外部后端会拒绝它，故只给 spawn。
+      if (child.config.provider === 'spawn') child.config.agentPreset = MEMBER_PRESET_ID
     }
   }
   rows.push(bridgeRow('mimo', deps && deps.bridgeName))

package/preset/mimo-member/plugin-list.mjs

@@ -0,0 +1,49 @@
+// preset/mimo-member/plugin-list.mjs — cordis-mimo 的【成员预设】单源清单（PROVIDER-CONTRACT §5）。
+//
+// 为什么需要它（2026-10-18 实测结论）：
+//   dsh-tool-subagent 0.2.1 起，config 里的 `persona` / `toolFilter` 会在 apply() 里
+//   **显式 throw**（"tool-subagent: persona is no longer supported; configure persona
+//   and tool plugins in an Agent Preset and select it with agentPreset (spawn only)"）。
+//   mimo 预设此前把委派指令写在 tool-subagent.config.persona 上 ⇒ 整个 preset 挂载失败
+//   （与 dsh-kexi-crypto v1.9.21 踩的是同一个坑）。
+//   新契约：角色人格只能是**独立的 Agent Preset**，由委派行经 `agentPreset` 选择。
+//
+// 本预设就是那个成员预设：人格（旧委派指令 verbatim）+ mimo 桥接工具面（子 agent 必须
+// 能调 mimo_run，否则"派活"无从谈起）+ 只读文件面（够做只读查询与最终验证）。
+// 由 preset-declarations.mjs 在**主预设之前**注册 —— 委派行的 validate() 会对每个
+// agentPreset id 调 presets.readDocument(id)，未注册即抛 agent-preset/not-found。
+//
+// 它不是独立会话入口：直接选择它只会得到一个只能派活、不能自己改文件的子代理。
+import { bridgeRow } from '../standard-base.mjs'
+
+/** Preset identity —— 旧会话头不可引用它（成员预设是本次新增），但委派行按此 id 选择。 */
+export const meta = {
+  id: 'cordis-mimo-member',
+  name: 'MiMo 子代理（内部预设·勿直接选择）',
+  description: 'MiMo-first 会话里被委派的子 agent 所用成员预设：只挂 mimo 桥接工具与只读文件面，人格要求把编码工作派给 mimo_run。仅供 cordis-mimo 的委派行经 agentPreset 选择，不是独立会话入口；直接选择它只会得到一个只能派活、不能自己改文件的子代理。',
+  order: 501
+}
+
+/** 旧 agent.cordis.yml 的 spawn/fork 委派指令文案 verbatim（0.2.1 起只能放进 persona）。 */
+export const MIMO_DELEGATION_PERSONA = 'Delegation directive: you are a child agent in a MiMo-first session. Before doing any coding, building, debugging, or multi-file investigation work yourself, check whether the mimo_run tool (or the MCP form mcp__mimo__mimo_run) is available to you; if it is, dispatch that work to mimo first per the MiMo-first policy, then verify its output with your own read-only tools. Reserve your own direct work for quick read-only lookups and final verification.'
+
+export function buildPlugins(deps) {
+  return [
+    // 人格：委派指令。prefix 必填；suffix 不设（DSH 只注册 provider/model 两个提示词变量，
+    // 工作目录由 working-directory 服务以不插值的用户上下文提供）。
+    { id: 'persona', name: '@deepseek-ai/dsh-persona', config: {
+      prefix: MIMO_DELEGATION_PERSONA,
+      includeRuntimeContext: true,
+    } },
+    // 只读文件面：旧 toolFilter 白名单的新表达 —— 写/改工具直接不存在，比黑名单更严格
+    // （成员纪律：改文件一律经 mimo_run）。
+    { 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', config: {
+      sampleOverCapGlobResults: false,
+    } },
+    // 桥接工具面：子 agent 必须能调 mimo_run/mimo_continue/ mimo_status。
+    bridgeRow('mimo', deps && deps.bridgeName),
+  ]
+}

package/preset/opencode-first/agent.cordis.yml

@@ -4,7 +4,6 @@
 - id: persona
   name: '@deepseek-ai/dsh-persona'
   config:
-    suffix: 'Your working directory is {{cwd}}.'
     prefix: 'You are a coding agent powered by the {{model}} model.'
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'
@@ -86,20 +85,17 @@
         provider: spawn
         toolName: subagent
         modelSelectionSettings: true
-        backgroundMode: continuable
     - id: tool-subagent-fork
       name: '@deepseek-ai/dsh-tool-subagent'
       config:
         provider: fork
         toolName: subagent_fork
-        backgroundMode: continuable
     - id: tool-subagent-codex
       name: '@deepseek-ai/dsh-tool-subagent'
       disabled: true
       config:
         provider: codex
         toolName: subagent_codex
-        backgroundMode: one-shot
         maxDepth: provider-managed
     - id: tool-subagent-claude-code
       name: '@deepseek-ai/dsh-tool-subagent'
@@ -107,7 +103,6 @@
       config:
         provider: claude-code
         toolName: subagent_claude_code
-        backgroundMode: one-shot
         maxDepth: provider-managed
     - id: workflow-ptc
       name: '@deepseek-ai/dsh-workflow-ptc'

package/preset/opencode-first/plugin-list.mjs

@@ -15,11 +15,13 @@ export const meta = {
 
 export function buildPlugins(deps) {
   const rows = standardPluginRows()
-  // persona 段：与三家旧 preset 同构（dsh-persona 要求 prefix 必填 + suffix 可选）。
+  // persona 段：prefix 与三家旧 preset 同构（dsh-persona 要求 prefix 必填）。
+  // 2026-10-18：不再设置 suffix —— DSH 只注册 provider/model 两个变量，工作目录由
+  // working-directory 服务以不插值的用户上下文提供，{{cwd}} 会让本预设整轮组装失败。
   const persona = rows.find((r) => r.id === 'persona')
   if (persona && persona.config) {
     persona.config.prefix = 'You are a coding agent powered by the {{model}} model.'
-    persona.config.suffix = 'Your working directory is {{cwd}}.'
+    delete persona.config.suffix
   }
   rows.push(bridgeRow('opencode', deps && deps.bridgeName))
   return rows

package/preset/standard-base.mjs

@@ -26,13 +26,16 @@ export const PLAN_MODE_SECTION = [
 
 /**
  * 官方 standard preset 的插件行表（不含 persona 差异与桥接行）。
- * persona 行返回【副本】供 provider 修改 prefix/suffix；其余行按原样返回。
+ * persona 行返回【副本】供 provider 修改 prefix；其余行按原样返回。
  * @returns {object[]}
  */
 export function standardPluginRows() {
   return [
+    // persona 只留 prefix。DSH 的提示词循环只注册 provider/model 两个变量
+    // （dsh-agent-loop），工作目录由 working-directory 服务以「不执行插值的用户
+    // 上下文」提供。写 {{cwd}} 会在组装期抛 unknown prompt variable，导致整个
+    // 预设不可用（2026-10-18 实测）。官方 presets 全部不带 suffix。
     { id: 'persona', name: '@deepseek-ai/dsh-persona', config: {
-      suffix: 'Your working directory is {{cwd}}.',
       prefix: 'You are a coding agent powered by the {{model}} model.',
     } },
     { id: 'agent-instructions', name: '@deepseek-ai/dsh-agent-instructions', config: { maxBytes: 65536 } },
@@ -66,20 +69,29 @@ export function standardPluginRows() {
     {
       id: 'delegation', name: 'cordis:group', group: true,
       isolate: { workflowEngine: true },
+      // 2026-10-18：移除 backgroundMode —— dsh-tool-subagent 0.2.1（当前 0.2.1-alpha.5）
+      // 已删除该字段。机制经实装包双路径实测更正：未知/已删键会**通过 schema 校验并被
+      // 原样保留**（`Config['~standard'].validate({provider,backgroundMode})` 无 issues，
+      // 值幸存；schemastery 根本没有 strict 开关），只是**无人读取**该键
+      // （全 DSH 树对 backgroundMode 0 命中）⇒ 属「静默**忽略**」，不是「静默丢弃」。
+      // 危害：表面声明 continuable/one-shot 却毫无效果，且**运行时不报错**，
+      // 只能靠静态闸门（tests/keystone/persona-prompt-vars.test.mjs）拦。
+      // 当前 schema 接受：provider / toolName / modelSelectionSettings /
+      // agentOptions / agentPreset / allowedAgentPresets / maxDepth。
       config: [
         { id: 'tool-subagent-control', name: '@deepseek-ai/dsh-tool-subagent-control' },
         { id: 'tool-subagent-list-agents', name: '@deepseek-ai/dsh-tool-subagent-control/list-agents' },
         { id: 'tool-subagent', name: '@deepseek-ai/dsh-tool-subagent', config: {
-          provider: 'spawn', toolName: 'subagent', modelSelectionSettings: true, backgroundMode: 'continuable',
+          provider: 'spawn', toolName: 'subagent', modelSelectionSettings: true,
         } },
         { id: 'tool-subagent-fork', name: '@deepseek-ai/dsh-tool-subagent', config: {
-          provider: 'fork', toolName: 'subagent_fork', backgroundMode: 'continuable',
+          provider: 'fork', toolName: 'subagent_fork',
         } },
         { id: 'tool-subagent-codex', name: '@deepseek-ai/dsh-tool-subagent', disabled: true, config: {
-          provider: 'codex', toolName: 'subagent_codex', backgroundMode: 'one-shot', maxDepth: 'provider-managed',
+          provider: 'codex', toolName: 'subagent_codex', maxDepth: 'provider-managed',
         } },
         { id: 'tool-subagent-claude-code', name: '@deepseek-ai/dsh-tool-subagent', disabled: true, config: {
-          provider: 'claude-code', toolName: 'subagent_claude_code', backgroundMode: 'one-shot', maxDepth: 'provider-managed',
+          provider: 'claude-code', toolName: 'subagent_claude_code', maxDepth: 'provider-managed',
         } },
         { id: 'workflow-ptc', name: '@deepseek-ai/dsh-workflow-ptc', config: { provider: 'spawn' } },
         { id: 'tool-workflow', name: '@deepseek-ai/dsh-tool-workflow' },