@luchenglong/cli-bridge 0.2.6 → 0.2.8

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.6'
+const SERVER_VERSION = '0.2.8'
 const PROTOCOL = '2024-11-05'
 
 const PROVIDERS = [agyMcp, codebuddyMcp, mimoMcp, opencodeMcp]
@@ -183,3 +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.6",
+  "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,6 +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' },

package/providers/codebuddy-catalog.mjs

@@ -339,6 +339,38 @@ export const BACKEND_ENUM = ['codebuddy', 'codebuddy-intl', 'codebuddy-ioa', 'co
     return { ok: false, ids: [], mode: 'cli-help', error: lastErr || 'codebuddy CLI not found (set CODEBUDDY_BIN)' }
   }
 
+  /**
+   * 同步版的账号探测（供设置面板用 —— 面板必须同步返回）。
+   * 走 spawnSync + 超时；结果进 5 分钟缓存，避免每次渲染都打一次网络。
+   *
+   * ⚠️ 为什么面板不能用 `--help` 名册顶替：实测本机 CLI 2.167.0 的 help 文本**本身
+   * 就是过时的** —— 它列 18 项且含已不存在的 `minimax-m3` / `kimi-k3-1`，缺真实的
+   * `glm-5.3-flashx` / `minimax-m3-pay` / `kimi-k3-2`；而账号探测给出 19 项且全部有效。
+   * 也就是说「CLI 声明」≠「服务端实际可用」，拿它当兜底会直接把错误清单展示给用户。
+   * 故这里宁可空列表 + 明确提示，也不展示已知错误的 roster。
+   * @returns {{ok:boolean, ids:string[], mode:string, error?:string}}
+   */
+  export function probeAccountModelsSync(env, opts) {
+    const o = opts || {}
+    const cands = cbCatalogCliCandidates(env)
+    const extraEnv = o.envExtra || {}
+    const reasons = []
+    const timeout = Math.max(3000, Math.min(o.timeoutMs || 12000, 30000))
+    for (const exe of cands) {
+      const r = cliSpawnSync(exe, ['-p', 'hi', '--model', '__clb_probe_invalid__', '--output-format', 'text'], {
+        timeout,
+        env: Object.assign({}, (globalThis.process && globalThis.process.env) || {}, extraEnv)
+      })
+      if (!r || r.error) { reasons.push(exe + ': ' + String((r && r.error && (r.error.code || r.error.message)) || 'spawn failed')); continue }
+      const out = String(r.stdout || '') + String(r.stderr || '')
+      const ids = parseAccountModels(out)
+      if (ids && ids.length) return { ok: true, ids, mode: 'account-live', exe }
+      const head = String(out).replace(/\s+/g, ' ').trim().slice(0, 140)
+      reasons.push(exe + ': exit ' + r.status + ', no account roster' + (head ? ' — ' + head : ''))
+    }
+    return { ok: false, ids: [], mode: 'account-live', error: reasons.join('; ') || 'no CLI candidate to probe' }
+  }
+
   /**
    * 异步探测「该账号当前支持」的清单：用无效模型触发 CLI 的 400 报文。
    * 对齐 workbuddy-auth 的权威白名单语义（服务器告诉我们这个账号能用什么）。
@@ -565,41 +597,3 @@ export const CREDENTIAL_KEYS = ['WORKBUDDY_TOKEN', 'WORKBUDDY_AI_TOKEN', 'CODEBU
     return { token: null, source: null }
   }
 
-// ── 三工具 schema（旧 preset/codebuddy-first verbatim；契约 §8 红线）────────────
-// 纯数据，无依赖 —— 放这里是为了让主描述符留在 600 行红线内（规则 §26）。
-export const RUN_PARAMS = {
-  type: 'object',
-  additionalProperties: false,
-  required: ['prompt'],
-  properties: {
-    prompt: { type: 'string', description: 'The full task/instruction for codebuddy. Be complete and self-contained.' },
-    backend: { type: 'string', enum: BACKEND_ENUM, description: 'Which CLI face to dispatch to. codebuddy (default; domestic CodeBuddy npm CLI, product endpoint www.codebuddy.ai) for coding work; codebuddy-intl = CodeBuddy INTERNATIONAL face of the same npm CLI (product.ioa.json catalogue: claude-sonnet-5 / claude-opus-5 / gemini-3.1-pro / gpt-6-astra / hy3-ioa ...; aliases codebuddy-ioa / codebuddy-international) when the account is an international CodeBuddy account; codebuddy-en = WorkBuddy international edition (the WorkBuddyAI desktop bundled CLI at C:\\Program Files\\WorkBuddyAI, product endpoint www.workbuddy.ai; needs codebuddyEnToken unless DSH already holds a workbuddy key) — aliases workbuddy-en / workbuddy-ai also accepted; workbuddy = WorkBuddy domestic desktop CLI (product endpoint copilot.tencent.com, zero config), the office-scenario face: documents/slides/spreadsheets, knowledge-base lookups, image/video generation, WeChat/WeCom replies. New calls without a backend follow the user-preferred default backend (plugin settings). Continuing a session routes back to its owning backend automatically.' },
-    mode: { type: 'string', enum: ['auto', 'plan', 'accept-edits'], description: 'auto follows DSH plan state; plan = no writes; accept-edits = allow edits. Default auto.' },
-    model: { type: 'string', description: MODEL_DESCRIPTION },
-    effort: { type: 'string', enum: ['minimal', 'low', 'medium', 'high', 'xhigh', 'max'], description: 'Optional reasoning effort.' },
-    maxTurns: { type: 'integer', description: 'Optional max agentic turns (1-500, default unlimited).' },
-    cwd: { type: 'string', description: 'Working directory for codebuddy. Defaults to the DSH workspace root.' },
-    addDirs: { type: 'array', items: { type: 'string' }, description: 'Extra directories to add to codebuddy workspace.' },
-    timeoutSec: { type: 'integer', description: 'Run timeout seconds (10-3600, default 300); a DSH-side hang guard force-terminates at timeout+60s.' },
-    background: { type: 'boolean', description: 'Run as a background job and return a jobId immediately.' }
-  }
-}
-export const CONTINUE_PARAMS = {
-  type: 'object',
-  additionalProperties: false,
-  required: ['prompt'],
-  properties: {
-    prompt: { type: 'string', description: 'Follow-up instruction for the ongoing codebuddy conversation.' },
-    sessionId: { type: 'string', description: 'codebuddy session id to resume (from a prior codebuddy_run result).' },
-    latest: { type: 'boolean', description: 'Continue the most recent codebuddy conversation instead of a specific id.' },
-    backend: { type: 'string', enum: BACKEND_ENUM, description: 'Which CLI face to resume on. codebuddy-en = WorkBuddy international (WorkBuddyAI desktop CLI; aliases workbuddy-en / workbuddy-ai accepted), workbuddy = WorkBuddy domestic desktop CLI. When omitted, the backend that owns the sessionId is used automatically; brand-new conversations follow the user-preferred default backend (plugin settings).' },
-    mode: { type: 'string', enum: ['auto', 'plan', 'accept-edits'], description: 'Execution mode; default auto.' },
-    model: { type: 'string', description: 'Optional model id (two layers: product face carries it, account licenses it; the credit multiplier of each id comes from the CLI descriptor — see codebuddy_run).' },
-    effort: { type: 'string', enum: ['minimal', 'low', 'medium', 'high', 'xhigh', 'max'], description: 'Optional reasoning effort.' },
-    maxTurns: { type: 'integer', description: 'Optional max agentic turns.' },
-    cwd: { type: 'string', description: "Working directory for codebuddy; when resuming, defaults to the resumed session's project directory." },
-    timeoutSec: { type: 'integer', description: 'Run timeout seconds (10-3600, default 300); a DSH-side hang guard force-terminates at timeout+60s.' },
-    background: { type: 'boolean', description: 'Run as a background job and return a jobId immediately.' }
-  }
-}
-export const STATUS_PARAMS = { type: 'object', additionalProperties: false, required: [], properties: { cwd: { type: 'string', description: 'Optional: filter the snapshot to a single project (working directory).' } } }