@luchenglong/cli-bridge 0.2.9 → 0.2.10

package/providers/codebuddy.mjs

@@ -1,578 +1,600 @@
-// providers/codebuddy.mjs — codebuddy provider descriptor。
-//
-// 移植基线：codebuddy-first-bridge v1.6.x 的纯逻辑与 preset/codebuddy-first 内联语义，
-// 逐字保持（契约 §8：工具入参语义与 schema 不许漂移）。provider 无关骨架在 bridge-kit。
-// 纯逻辑片：codebuddy-catalog.mjs（模型目录/凭据/探测）、codebuddy-schemas.mjs（三 schema）、
-// codebuddy-models-tool.mjs（codebuddy_models 工具）。build 会把 codebuddy-*.mjs 全部
-// 内联进沙箱同一作用域。
-//
-// 红线：本文件会被内联进 dynamic 沙箱 —— 绝不出现元环境字面量；process/env/fs 只经
-// deps 注入或 typeof 守卫读取；宿主能力全部走 attach(hostOpts)。isLimited 用本文件
-// 自定义的中文限流表（旧 core verbatim），不用 kit 通用表。
-import { createStatusEngine, createRunner, clampInt } from '../core/bridge-kit.mjs'
-
-// ── 提示词策略段（旧 preset POLICY_TEXT verbatim；systemPrompt order 5）────────
-// （LIMIT_RE 在 kit L33 已有，故此处带 CODEBUDDY_ 前缀）。
-// codebuddy-en 凭据的第三条通道：DSH 凭据库里可能已有的 workbuddy key（旧 core verbatim）。
-
-// 离线/读不到描述文件时的回退静态表（真机按账号实测快照，2026-09）。
-// 模型目录相关常量与纯逻辑已拆到 ./codebuddy-catalog.mjs —— 主文件原 864 行远超
-// 600 行红线（规则 §26）。
-//   • ESM 形态（preset / MCP / 测试）：直接 import。
-//   • dynamic 沙箱形态：scripts/build.mjs 把该文件内联进同一作用域（模板顶部的
-//     第三个占位标记），import 行被 stripModuleSyntax 剥掉，同名标识符天然可见。
-//     ⚠️ 本注释里绝不写出那个标记的字面量：build 做全局文本替换，注释中出现同样
-//     会被替换成正文代码，把注释劈开 → 生成物语法崩。
-import {
-  BACKEND_MODEL_IDS, PRODUCT_DESCRIPTOR_ENV, CREDIT_ID_ALIASES, MODEL_DESCRIPTION, BACKEND_ENUM,
-  accountConfigCandidates, productDescriptorCandidates, normalizeProductConfig,
-  extractModelIds, parseCreditValue, formatCreditLabel, extractModelCredits, lookupModelCredits,
-  backendModelCatalog, rememberAccountCatalog, getAccountCatalog, parseAccountModels,
-  modelCatalogDetailed, formatModelCatalogText, cbCatalogSetHost,
-  BACKEND_AUTH_IDS, CREDENTIAL_KEYS, readBackendAuthDomain,
-  readDshWorkbuddyToken, resolveEnToken,
-  fetchHelpModelsSync, cachedCliModels, currentPreferredBackend, parseHelpModels, probeAccountModelsSync,
-
-} from './codebuddy-catalog.mjs'
-import { codebuddyModelsTool } from './codebuddy-models-tool.mjs'
-import { POLICY_TEXT, CODEBUDDY_LIMIT_RE, BACKENDS, BACKEND_ENDPOINTS, AUTH_DOMAIN_ENDPOINTS, BACKEND_LABELS, BACKEND_ALIASES, DEFAULT_BACKEND, SETTINGS_KEYS } from './codebuddy-consts.mjs'
-import { RUN_PARAMS, CONTINUE_PARAMS, STATUS_PARAMS } from './codebuddy-schemas.mjs'
-
-export default function defineProvider(deps = {}) {
-  const env = deps.env || {}
-  let host = null // attach 后保存 hostOpts（preset/dynamic/MCP 形态宿主能力）
-
-  // 宿主 fs/path 访问的统一入口：deps 注入优先；dynamic 内联体（无 import，运行在
-  // 后端 Node 上下文）回退到 getBuiltinModule —— 与旧 core builtinModule() 的
-  // typeof 守卫模式一致（这是旧 dynamic 端点修复生效的同一条通道，缺了它默认
-  // 后端会回到 401 老病）。两者皆不可用时自然降级：读不到文件 = 静态表兜底。
-  function builtinModule(name) {
-    try {
-      const proc = globalThis.process
-      return (proc && typeof proc.getBuiltinModule === 'function') ? proc.getBuiltinModule(name) : null
-    } catch (e) { return null }
-  }
-  function fsRead(p) {
-    const nf = deps.nodeFs || builtinModule('node:fs')
-    if (!nf || typeof nf.readFileSync !== 'function') return null
-    try { return nf.readFileSync(p, 'utf8') } catch (e) { return null }
-  }
-  function pathJoin(...parts) {
-    const np = deps.nodePath || builtinModule('node:path')
-    if (np && typeof np.join === 'function') return np.join(...parts)
-    return parts.join('/')
-  }
-  const pathSep = (deps.nodePath && deps.nodePath.sep) || (/[A-Za-z]:[\\/]/.test(env.USERPROFILE || env.APPDATA || '') ? '\\' : '/')
-
-  // 把宿主真实能力注入 catalog 模块：它从本闭包搬出后拿不到 env / fsRead / pathJoin /
-  // pathSep。未注入时 catalog 退到 getBuiltinModule 守卫（绝不抛）。内联到 dynamic
-  // 沙箱时 cbCatalogSetHost 同作用域可见，行为一致。
-  try {
-    cbCatalogSetHost(env, deps.nodePath || builtinModule('node:path'), deps.nodeFs || builtinModule('node:fs'))
-  } catch (e) { }
-
-  // ── 端点/登录域（旧 core endpointHost verbatim：非法 URL 容错）───────────────
-  function endpointHost(url) {
-    const s = String(url || '').trim()
-    if (!s) return ''
-    try { return new URL(s).hostname.toLowerCase() } catch (e) { }
-    const m = /^[a-z]+:\/\/([^/?#]+)/i.exec(s)
-    return m ? m[1].toLowerCase() : ''
-  }
-
-  function resolveEndpoint(explicitBaseUrl, authDomain) {
-    const explicit = String(explicitBaseUrl || '').trim()
-    if (explicit) return explicit
-    const d = String(authDomain || '').trim().toLowerCase()
-    if (d && AUTH_DOMAIN_ENDPOINTS[d]) return AUTH_DOMAIN_ENDPOINTS[d]
-    return null
-  }
-
-  function isBackend(v) { return BACKENDS.indexOf(v) >= 0 }
-
-  // 后端名规范化（v1.3.3 verbatim）：别名 + 大小写不敏感；非后端名原样返回。
-  function normalizeBackend(v) {
-    if (typeof v !== 'string') return v
-    const lower = v.trim().toLowerCase()
-    const aliased = BACKEND_ALIASES[lower] || lower
-    return BACKENDS.indexOf(aliased) >= 0 ? aliased : v
-  }
-
-  // 后端解析优先级（旧 core verbatim）：显式 > 会话归属 > 用户偏好 > 默认。
-  function resolveBackend(args, target, preferredBackend) {
-    if (args && isBackend(normalizeBackend(args.backend))) return normalizeBackend(args.backend)
-    if (target && target.backend && isBackend(normalizeBackend(target.backend))) return normalizeBackend(target.backend)
-    if (preferredBackend && isBackend(normalizeBackend(preferredBackend))) return normalizeBackend(preferredBackend)
-    return DEFAULT_BACKEND
-  }
-
-  // 本次调用的端点/凭据 env 注入（旧 core endpointEnv verbatim 三规则）。
-  function endpointEnv(backend, explicitBaseUrl, authDomain, authToken) {
-    const out = {}
-    const endpoint = resolveEndpoint(explicitBaseUrl, authDomain)
-    const product = BACKEND_ENDPOINTS[backend]
-    if (endpoint && endpointHost(endpoint) !== endpointHost(product)) {
-      out.CODEBUDDY_BASE_URL = endpoint
-    }
-    if (backend === 'codebuddy-en') {
-      const tok = String(authToken || '').trim()
-      if (tok) out.CODEBUDDY_AUTH_TOKEN = tok
-    }
-    return Object.keys(out).length ? out : null
-  }
-
-  // 可操作提示（旧 core endpointMismatchHint 三分支 verbatim）。
-  function endpointMismatchHint(backend, authDomain, hasToken) {
-    if (backend === 'codebuddy-en' && !hasToken) {
-      return 'codebuddy-en（WorkBuddy 国际版）没有可用凭据。国际版的登录 token 被桌面 App 的 protector key 封装，该密钥不落盘、headless CLI 无法自行读取（CLI 自身报 category:"missing-key"）。桥接会依次尝试：插件设置 codebuddyEnToken → 环境变量 CODEBUDDY_AUTH_TOKEN → DSH 凭据库（.credentials.yaml / .env 里的 WORKBUDDY_TOKEN）——三者皆空。请在 DSH 里配好 workbuddy provider 的 key，或把国际版 token 填入插件设置；也可直接用 backend="workbuddy"（国内版桌面 CLI，免配置）。'
-    }
-    if (backend === 'codebuddy-intl') {
-      return 'codebuddy-intl（CodeBuddy 国际版）使用同一个 npm CLI，但国际面模型由服务端按账号授权放行：未授权时 CLI 返回 400「model [...] is only available for authorized users」。若你用的是国内账号，请改用 backend="codebuddy"（国内面模型清单）或 backend="codebuddy-en"（WorkBuddy 国际版）。'
-    }
-    const d = String(authDomain || '').trim().toLowerCase()
-    if (d && endpointHost(resolveEndpoint(null, d)) !== endpointHost(BACKEND_ENDPOINTS[backend])) {
-      return backend + ' 的登录域是 ' + d + '，与产品端点 ' + BACKEND_ENDPOINTS[backend] + ' 不一致；桥接层已自动注入 CODEBUDDY_BASE_URL=' + AUTH_DOMAIN_ENDPOINTS[d] + '。若仍 401，请重新登录对应客户端。'
-    }
-    return null
-  }
-
-  // 从 auth 库读某后端登录域（旧 core readBackendAuthDomain verbatim 语义；fs 经
-  // deps 注入。io 可覆盖 readFileSync/dir/env，供测试夹具与 MCP 面注入真实 fs）。
-
-  // ── 模型目录（面板/诊断用；无促销角标版，见头注 TODO）───────────────────────
-  // ── 设置清洗（旧 normalizeBridgeSettings verbatim；updatedAt 透传）───────────
-  function normalizeSettings(raw) {
-    const snap = { preferredBackend: DEFAULT_BACKEND, defaultModel: '', codebuddyEnToken: '', endpointOverride: '' }
-    if (!raw || typeof raw !== 'object') return snap
-    if (typeof raw.preferredBackend === 'string') {
-      const nb = normalizeBackend(raw.preferredBackend)
-      if (typeof nb === 'string' && BACKENDS.indexOf(nb) >= 0) snap.preferredBackend = nb
-    }
-    if (typeof raw.defaultModel === 'string') snap.defaultModel = raw.defaultModel.trim()
-    if (typeof raw.codebuddyEnToken === 'string') snap.codebuddyEnToken = raw.codebuddyEnToken.trim()
-    if (typeof raw.endpointOverride === 'string') snap.endpointOverride = raw.endpointOverride.trim()
-    if (typeof raw.updatedAt === 'number' && raw.updatedAt > 0) snap.updatedAt = raw.updatedAt
-    return snap
-  }
-
-  // 诊断（旧 diagnoseBackend verbatim；fs/env 走 deps）。
-  function diagnoseBackend(backend, settings, io) {
-    const o = io || {}
-    const e = o.env || env
-    const s = settings || normalizeSettings(null)
-    const authDomain = readBackendAuthDomain(backend, Object.assign({ env: e }, o))
-    const override = String(s.endpointOverride || '').trim()
-    const byDomain = resolveEndpoint(null, authDomain)
-    const endpoint = override || byDomain || BACKEND_ENDPOINTS[backend] || null
-    const endpointSource = override ? 'override' : (byDomain ? 'auth-domain' : 'product')
-    const tok = resolveEnToken(backend === 'codebuddy-en' ? s.codebuddyEnToken : null, { env })
-    return {
-      backend: backend,
-      authDomain: authDomain,
-      endpoint: endpoint,
-      endpointSource: endpointSource,
-      tokenSource: backend === 'codebuddy-en' ? tok.source : 'not-needed',
-      tokenHint: tok.source === 'setting' ? '来自设置面板'
-        : tok.source === 'env' ? '来自环境变量 CODEBUDDY_AUTH_TOKEN'
-          : tok.source === 'dsh-store' ? '来自 DSH 凭据库（自动复用 WORKBUDDY_TOKEN）'
-            : backend === 'codebuddy-en' ? '缺失：国际版 token 不落盘，需在设置面板填写或先在 DSH 配 workbuddy provider'
-              : '无需填写（国内版由 CLI 自行登录）',
-      mismatch: endpointMismatchHint(backend, authDomain, !!tok.token) !== null,
-      hint: endpointMismatchHint(backend, authDomain, !!tok.token) || null,
-      defaultModel: String(s.defaultModel || '').trim() || '(CLI 默认)'
-    }
-  }
-
-  // ── 结果判定（旧 isLimited/isTransientCliError/failureHint verbatim）─────────
-  function isLimitedCodebuddy(res) {
-    if (!res || res.ok) return false
-    // 前置凭据缺失：配置问题，不是限流（弹窗重试不会让 token 出现）。
-    if (res.status === 'AUTH_REQUIRED') return false
-    if (res.status === 'SPAWN_ERROR' || res.status === 'CODEBUDDY_UNAVAILABLE' || res.status === 'HUNG_TIMEOUT') return true
-    const hay = String(res.stderr || '') + ' ' + String(res.status || '')
-    // 401/端点域不匹配：需要用户换登录域，不归限流类（旧 v1.3.0 verbatim）。
-    if (/401 authentication failed|differs from the current product endpoint/i.test(hay)) return false
-    return CODEBUDDY_LIMIT_RE.test(hay)
-  }
-
-  function isTransientCliError(res) {
-    if (!res || res.ok) return false
-    if (isLimitedCodebuddy(res)) return false
-    return res.status === 'ERROR_DURING_EXECUTION'
-  }
-
-  function failureHint(res) {
-    if (!res || res.ok) return ''
-    // AUTH_REQUIRED：stderr 已带完整指引，透传（旧 v1.3.1 verbatim）。
-    if (res.status === 'AUTH_REQUIRED') return '[诊断] ' + String(res.stderr || '')
-    if (isTransientCliError(res)) {
-      return res.retried
-        ? '[诊断] codebuddy CLI 侧瞬时错误（error_during_execution，CLI 未给出原因），已自动重试 1 次仍失败。可换 model 再试一次；若仍失败请改用原生工具完成，或告知用户。'
-        : '[诊断] codebuddy CLI 侧瞬时错误（error_during_execution，CLI 未给出原因）。直接重试同一请求通常即可通过；也可显式指定 model。不要据此认为任务本身有问题。'
-    }
-    if (res.status === 'PARSE_ERROR') {
-      return '[诊断] 未能从 codebuddy 输出解析出 result 事件（进程可能被中断或输出被截断）。可重试；持续出现请检查 codebuddy CLI 版本。'
-    }
-    if (/401 authentication failed|differs from the current product endpoint/i.test(String(res.stderr || ''))) {
-      return '[诊断] 认证失败（401）：请求被送到的端点与当前 CLI 登录域不匹配（国际/国内登录互斥）。请让用户在对应产品域完成 `codebuddy` CLI 登录后重试；这不是限流，重试与回退都无效。'
-    }
-    return ''
-  }
-
-  // stream-json 解析（旧 parseCodebuddyJson verbatim）。
-  function parseCodebuddyJson(stdoutText) {
-    const trimmed = String(stdoutText || '').trim()
-    if (!trimmed) return null
-    const lines = trimmed.split(/\r?\n/).filter(Boolean)
-    for (let i = lines.length - 1; i >= 0; i--) {
-      const ln = lines[i].trim()
-      if (!ln.startsWith('{')) continue
-      try {
-        const obj = JSON.parse(ln)
-        if (obj && obj.type === 'result') return obj
-      } catch (e) {}
-    }
-    try { return JSON.parse(trimmed) } catch (e) {}
-    return null
-  }
-
-  // result 事件 → 统一结果对象（旧 buildResult verbatim，含账号清单收割）。
-  function buildResult(parsed, outcome, mode, stderrText, stdoutText, backend) {
-    const bk = backend || 'codebuddy'
-    const exitCode = outcome ? outcome.exitCode : null
-    const errText = parsed && typeof parsed.error === 'string' && parsed.error ? parsed.error : ''
-    const stderr = (stderrText ? String(stderrText).slice(-2000) : '') + (errText ? (stderrText ? ' ' : '') + errText : '')
-    // v1.6.0：顺手收割服务端回吐的「本账号可用模型」清单（失败静默）。
-    try {
-      const harvest = parseAccountModels(stderr) || parseAccountModels(String(stdoutText || ''))
-      if (harvest && harvest.length) rememberAccountCatalog(bk, harvest)
-    } catch (e) { /* 收割失败不影响主流程 */ }
-    if (parsed && parsed.type === 'result') {
-      const isOk = exitCode === 0 && parsed.is_error === false && parsed.subtype === 'success'
-      let modelUsed = null
-      try {
-        if (parsed.modelUsage && typeof parsed.modelUsage === 'object') {
-          const names = Object.keys(parsed.modelUsage)
-          if (names.length) modelUsed = names.join('+')
-        }
-      } catch (e) { }
-      return {
-        ok: isOk,
-        status: String(parsed.subtype || (isOk ? 'SUCCESS' : 'ERROR')).toUpperCase(),
-        response: typeof parsed.result === 'string' ? parsed.result : '',
-        sessionId: typeof parsed.session_id === 'string' ? parsed.session_id : null,
-        durationSeconds: typeof parsed.duration_ms === 'number' ? parsed.duration_ms / 1000 : null,
-        numTurns: typeof parsed.num_turns === 'number' ? parsed.num_turns : null,
-        totalTokens: (parsed.usage && typeof parsed.usage.input_tokens === 'number' && typeof parsed.usage.output_tokens === 'number')
-          ? (parsed.usage.input_tokens + parsed.usage.output_tokens) : null,
-        exitCode: exitCode,
-        mode: mode,
-        backend: bk,
-        modelUsed: modelUsed,
-        stderr: stderr
-      }
-    }
-    return {
-      ok: false,
-      status: 'PARSE_ERROR',
-      response: '',
-      sessionId: null,
-      durationSeconds: null,
-      numTurns: null,
-      totalTokens: null,
-      exitCode: exitCode,
-      mode: mode,
-      backend: bk,
-      stderr: stderr,
-      rawStdout: String(stdoutText || '').slice(-2000)
-    }
-  }
-
-  // 统一 argv 构造（旧 buildArgv verbatim；env 端点/凭据注入在本 provider 内完成，
-  // 因为 kit 只透传 opts，宿主三形态都从本函数的返回值取 built.env 下发 spawn）。
-  function buildArgvCodebuddy(prefix, args, opts) {
-    const o = opts || {}
-    const argv = [prefix[0], ...prefix.slice(1), '-p', String(args.prompt), '--output-format', 'stream-json']
-    let mode = args.mode || o.defaultMode || 'auto'
-    if (mode === 'auto') mode = o.planActive ? 'plan' : 'bypassPermissions'
-    if (mode === 'plan') {
-      argv.push('--permission-mode', 'plan')
-      argv.push('--allowedTools', 'Bash')
-    } else {
-      mode = 'bypassPermissions'
-      argv.push('--permission-mode', 'bypassPermissions')
-    }
-    // 模型优先级：显式 args.model > 用户偏好 defaultModel > CLI 默认。
-    const model = args.model || o.defaultModel
-    if (model) argv.push('--model', String(model))
-    if (args.effort) argv.push('--effort', String(args.effort))
-    if (args.maxTurns !== undefined && args.maxTurns !== null) argv.push('--max-turns', String(clampInt(args.maxTurns, 50, 1, 500)))
-    if (Array.isArray(args.addDirs)) for (const d of args.addDirs) { if (d) argv.push('--add-dir', String(d)) }
-    if (args.sessionId) argv.push('--resume', String(args.sessionId))
-    else if (args.continueLatest) argv.push('--continue')
-    const timeoutSec = clampInt(args.timeoutSec, 300, 10, 3600)
-    // 端点/凭据注入（旧 preset/dynamic/MCP 三形态一致语义，宿主不必自算）：
-    // authDomain 只在有 fs 能力的宿主读得到；dynamic 沙箱 → 沿用 CLI 自身端点。
-    const bk = o.backend || DEFAULT_BACKEND
-    const settings = o.settings || null
-    const authDomain = readBackendAuthDomain(bk, { env })
-    const tok = resolveEnToken(bk === 'codebuddy-en' && settings ? settings.codebuddyEnToken : null, { env })
-    const inject = endpointEnv(bk, settings ? settings.endpointOverride : null, authDomain, tok.token)
-    return { argv: argv, timeoutSec: timeoutSec, mode: mode, env: o.env || inject }
-  }
-
-  // 流事件折叠（旧 foldEvent 主体 verbatim；project 状态由 kit engine 持有）。
-  function foldStreamEvent(ev, p, summarizeArgs, MAX_ARG_LEN, MAX_TRAIL) {
-    if (!ev || !ev.type) return
-    if (ev.type === 'assistant' && ev.message && Array.isArray(ev.message.content)) {
-      for (const block of ev.message.content) {
-        if (block.type === 'tool_use') {
-          p._stepCounter = (p._stepCounter || 0) + 1
-          const stepIndex = p._stepCounter
-          if (!p._toolMap) p._toolMap = {}
-          p._toolMap[block.id] = { stepIndex: stepIndex, name: block.name }
-          const args = summarizeArgs(block.input)
-          p.trail.push({ stepIndex: stepIndex, state: 'ACTIVE', tool: block.name, args: args, at: new Date().toISOString() })
-          if (p.trail.length > MAX_TRAIL) p.trail.shift()
-          p.current = { tool: block.name, args: args, stepIndex: stepIndex, since: new Date().toISOString() }
-        } else if (block.type === 'thinking') {
-          p.current = { tool: 'thinking', args: { text: String(block.thinking || '').slice(0, MAX_ARG_LEN) }, stepIndex: 0, since: new Date().toISOString() }
-        } else if (block.type === 'text') {
-          p.current = { tool: 'typing', args: { text: String(block.text || '').slice(0, MAX_ARG_LEN) }, stepIndex: 0, since: new Date().toISOString() }
-        }
-      }
-    } else if (ev.type === 'user' && ev.message && Array.isArray(ev.message.content)) {
-      for (const block of ev.message.content) {
-        if (block.type === 'tool_result' && p._toolMap && p._toolMap[block.tool_use_id]) {
-          const rec = p._toolMap[block.tool_use_id]
-          p.trail.push({ stepIndex: rec.stepIndex, state: block.is_error ? 'ERROR' : 'DONE', tool: rec.name, args: null, at: new Date().toISOString() })
-          if (p.trail.length > MAX_TRAIL) p.trail.shift()
-          if (p.current && p.current.stepIndex === rec.stepIndex) p.current = null
-        }
-      }
-    }
-  }
-
-  const descriptor = {
-    id: 'codebuddy',
-    label: 'CB',
-    presetId: 'codebuddy-first',
-    defaultBackend: DEFAULT_BACKEND,
-    defaultMode: 'auto',
-    exeName: 'codebuddy',
-    binEnvVars: ['CODEBUDDY_BIN', 'CODEBUDDY_EN_BIN', 'WORKBUDDY_BIN'],
-    unavailableStatus: 'CODEBUDDY_UNAVAILABLE',
-    // 旧 renderResult verbatim 语义：标头用具体 backend（'workbuddy OK'），仅当结果
-    // 无 backend 字段时回落 'codebuddy'（= provider.id）。agy/mimo 旧包标头硬编码
-    // provider 名，不设此旗。
-    backendLabel: true,
-
-    backends: () => BACKENDS.slice(),
-    normalizeBackend,
-    resolveBackend,
-
-    buildArgv: buildArgvCodebuddy,
-    parseJson: parseCodebuddyJson,
-    buildResult,
-    foldStreamEvent,
-    isLimited: isLimitedCodebuddy,
-    isTransientCliError,
-    failureHint,
-
-    // codebuddy-en 无凭据的确定性前置（v1.3.1 语义，经 kit preflight 钩子实现）：
-    // 三通道皆空 → 直接 AUTH_REQUIRED（可操作指引进 stderr），不白跑一次 spawn。
-    // 其它后端一律放行。dynamic 沙箱无 fs → dsh-store 通道缺席，abort 提示即可。
-    preflight({ args, backend, engine, o }) {
-      if (backend !== 'codebuddy-en') return null
-      const settings = (o && o.getSettings && o.getSettings()) || null
-      const tok = resolveEnToken(settings ? settings.codebuddyEnToken : null, { env })
-      if (tok.token) return null
-      const authDomain = readBackendAuthDomain('codebuddy-en', { env })
-      const hint = endpointMismatchHint('codebuddy-en', authDomain, false)
-      return {
-        abort: {
-          ok: false,
-          status: 'AUTH_REQUIRED',
-          response: '',
-          sessionId: null,
-          durationSeconds: null,
-          numTurns: null,
-          totalTokens: null,
-          exitCode: null,
-          mode: (args && args.mode) || descriptor.defaultMode || 'auto',
-          backend: 'codebuddy-en',
-          stderr: hint
-        }
-      }
-    },
-
-    tools: {
-      run: {
-        name: 'codebuddy_run',
-        description: 'Dispatch a coding/build/debug/investigation task to the local codebuddy agent CLI and return its final answer. Prefer this for implementation, edits, refactors, multi-file investigation and debugging in every mode. DSH fully controls codebuddy: it always runs non-interactively with permissions auto-approved (codebuddy never prompts). Use read-only native tools only for quick lookups and for final build/test verification. In mode=auto the DSH plan state decides plan vs bypassPermissions. Set background=true for long tasks and collect the result via job_output.',
-        inputSchema: RUN_PARAMS
-      },
-      continue: {
-        name: 'codebuddy_continue',
-        description: 'Continue an existing codebuddy conversation with a follow-up prompt, reusing codebuddy context. Pass sessionId from a prior codebuddy_run result, or set latest=true to continue the most recent codebuddy conversation. Same DSH-controlled, no-prompt execution as codebuddy_run.',
-        inputSchema: CONTINUE_PARAMS
-      },
-      status: {
-        name: 'codebuddy_status',
-        description: 'Read a live snapshot of what the local codebuddy agent is currently doing. Returns one section per project (working directory): running count, the current step (tool name + arguments being executed, or agent_response thinking/typing), the recent step trail (tools executed, done/error), the last completed run status + session id, and per-project cumulative usage (runs + total tokens, since codebuddy exposes no quota API). Optional cwd filters to a single project. Call this to check on an in-flight codebuddy_run/codebuddy_continue without waiting for it to finish.',
-        inputSchema: STATUS_PARAMS
-      }
-    },
-
-    // codebuddy_models：实时列出本机 codebuddy 可用模型（账号探测优先，回落 CLI 名册）。
-    // 只在宿主有 spawn/fs 能力时注册（preset 注入 deps.process / MCP 注入 deps.nodeChild；
-    // dynamic 沙箱形态省略）。**失败必须 ok:false + 可操作错误**，绝不静默返回空列表或
-    // 伪造模型（工作手册红线 §7；对照 workbuddy-auth 的 catalog-store 静默降级 —— 不照抄）。
-    extraTools: (deps.process || deps.nodeChild || deps.nodeFs) ? [codebuddyModelsTool({
-      env, deps, BACKEND_ENUM, normalizeBackend, resolveBackend, modelCatalogDetailed, getAccountCatalog,
-      // faceEnv：让账号探测打到**请求的那个产品面**（与 buildArgv 完全同一套端点/凭据
-      // 注入规则）。缺了它，探测会走 CLI 自身默认登录面 —— 标着 codebuddy-en 实际却
-      // 问的是 codebuddy 面，得出的清单看着对其实是另一个面的（本轮修的就是这类偏差）。
-      faceEnv: (backend) => {
-        try {
-          const settings = (deps.settings && typeof deps.settings === 'object') ? deps.settings : {}
-          const authDomain = readBackendAuthDomain(backend, { env })
-          const tok = resolveEnToken(backend === 'codebuddy-en' ? settings.codebuddyEnToken : null, { env })
-          return endpointEnv(backend, settings.endpointOverride, authDomain, tok.token) || {}
-        } catch (e) { return {} }
-      }
-    })] : [],
-
-    // 设置分区（契约 §3）：keystone 统一文件 {codebuddy:{...}}；旧扁平文件的字段
-    // 级迁移由 keystone LEGACY_SOURCES 承担（字段名逐字相同）。
-    settings: {
-      keys: SETTINGS_KEYS,
-      secretKeys: ['codebuddyEnToken'],
-      defaults: () => normalizeSettings(null),
-      normalize: (raw) => normalizeSettings(raw),
-      meta() {
-        // defaultModel 下拉 = 账号级实时清单（服务端裁决）。走过的弯路留档：
-        //   ① 随包冻结的 product.ioa.json → 16 项、2 个 id 已改名（错）
-        //   ② CLI `--help` 的 "Currently supported:" → 18 项，但那是 CLI 构建期烙进去的，
-        //      实测同样滞后（含已废弃的 minimax-m3/kimi-k3-1，缺 glm-5.3-flashx 等）
-        //   ③ 现在：用无效模型探测让服务端回「该账号当前支持」的 19 项 —— 唯一权威源。
-        // 面板同步回调故用 spawnSync 探测并缓存 5 分钟；失败则下拉留空 + 明确提示，
-        // 绝不展示已知错误的 roster。面跟随 preferredBackend（旧实现硬编码 codebuddy 面）。
-        const face = (currentPreferredBackend() && normalizeBackend(currentPreferredBackend())) || DEFAULT_BACKEND
-        const faceEnv = (() => {
-          try {
-            const s = deps.settings || {}
-            const authDomain = readBackendAuthDomain(face, { env })
-            const tok = resolveEnToken(face === 'codebuddy-en' ? s.codebuddyEnToken : null, { env })
-            return endpointEnv(face, s.endpointOverride, authDomain, tok.token) || {}
-          } catch (e) { return {} }
-        })()
-        const live = cachedCliModels(face, () => probeAccountModelsSync(env, { envExtra: faceEnv, timeoutMs: 12000 }))
-        let options = []
-        let note = ''
-        if (live && live.ok && live.ids.length) {
-          const detail = modelCatalogDetailed(face, { env, accountModels: live.ids })
-          const byId = new Map(detail.map((x) => [x.id, x]))
-          options = live.ids.map((id) => {
-            const d = byId.get(id)
-            return { value: id, label: (d && d.label) || id }
-          })
-          note = '账号实时清单（' + live.ids.length + ' 项，服务端裁决）；当前面：' + face + '。日常任务优先免费（x0.00）。'
-        } else {
-          note = '未能读取该账号的模型清单（' + String((live && live.error) || 'unknown') +
-            '）。请确认该产品面已登录（在 codebuddy CLI 里完成登录），或手动输入模型 id。'
-        }
-        return {
-          titleSuffix: 'CodeBuddy',
-          fields: [
-            {
-              key: 'preferredBackend', label: '默认后端', type: 'select',
-              options: BACKENDS.map((b) => ({ value: b, label: BACKEND_LABELS[b] })),
-              note: '新会话未显式指定 backend 时用这里选的后端；单次调用可覆盖。codebuddy-en 需要 codebuddyEnToken 或 DSH 已配 workbuddy key。'
-            },
-            {
-              key: 'defaultModel', label: '默认模型', type: 'select', allowCustom: true, placeholder: '(CLI 默认)',
-              options,
-              note
-            },
-            { key: 'codebuddyEnToken', label: 'WorkBuddy 国际版 Token', type: 'secret', note: '仅 backend="codebuddy-en" 需要。国际版登录 token 被 protector key 封装不落盘，只能手工提供；留空则自动尝试 DSH 凭据库的 WORKBUDDY_TOKEN。' },
-            { key: 'endpointOverride', label: '端点覆盖', type: 'text', placeholder: 'https://…/v2', note: '一般留空：端点按登录域自动对齐（www.codebuddy.cn 等）。仅在需要强制指定 API 端点时填写，且必须自带 /v2。' }
-          ]
-        }
-      },
-      diagnose(snap) {
-        const s = normalizeSettings(snap)
-        const lines = []
-        const seen = new Set()
-        // 默认后端一行；codebuddy-en 是 4 面里唯一需要凭据的，恒附一行状态。
-        for (const b of [s.preferredBackend, 'codebuddy-en']) {
-          if (seen.has(b)) continue
-          seen.add(b)
-          const d = diagnoseBackend(b, s, {})
-          lines.push(b + ': ' + (d.endpoint || '?') + '（登录域 ' + (d.authDomain || '未读到') + '，' + d.tokenHint + '）')
-          if (d.hint) lines.push('  ⚠ ' + d.hint)
-        }
-        return lines.join('\n')
-      }
-    },
-
-    mcp: { version: '0.2.2' }
-  }
-
-  // 三形态共用的工具逻辑（签名保持 keystone/队友接线契约不变）。
-  descriptor.runToolLogic = async function (args, exec) {
-    return this.runner.coreExecute(args, exec)
-  }
-  // 旧 preset continueTool.execute verbatim 映射（sessionId 优先，否则 latest）。
-  descriptor.continueToolLogic = async function (args, exec) {
-    const a = args || {}
-    const mapped = { prompt: a.prompt, backend: a.backend, mode: a.mode, model: a.model, effort: a.effort, maxTurns: a.maxTurns, cwd: a.cwd, timeoutSec: a.timeoutSec, background: a.background }
-    if (a.sessionId) mapped.sessionId = a.sessionId
-    else if (a.latest) mapped.continueLatest = true
-    return this.runner.coreExecute(mapped, exec)
-  }
-  // 旧 statusTool.execute verbatim：cwd 过滤 + 单项目聚合覆写（含 runs/totalTokens）。
-  descriptor.statusToolLogic = function (args) {
-    const a = args || {}
-    const snap = this.engine.statusSnapshot()
-    if (a.cwd) {
-      const key = String(a.cwd)
-      snap.projects = snap.projects.filter((p) => p.cwd === key)
-      const g = snap.projects[0]
-      if (g) { snap.state = g.state; snap.running = g.running; snap.current = g.current; snap.trail = g.trail; snap.lastStatus = g.lastStatus; snap.lastAt = g.lastAt; snap.lastSessionId = g.lastSessionId; snap.lastBackend = g.lastBackend; snap.fallbackActive = g.fallbackActive; snap.runs = g.runs; snap.totalTokens = g.totalTokens; snap.updatedAt = g.updatedAt }
-    }
-    return snap
-  }
-
-  // 供 preset/dynamic/MCP/测试形态复用的领域函数（不 import home-plugin，全部经
-  // 描述符暴露；MCP 面据 buildArgv/parseJson/buildResult/isLimited/failureHint 组
-  // 装真实 spawn 执行，语义与旧 mcp/codebuddy-mcp-server.mjs 一致）。
-  Object.assign(descriptor, {
-    policyText: POLICY_TEXT, limits: { LIMIT_RE: CODEBUDDY_LIMIT_RE },
-    backendLabels: BACKEND_LABELS, backendEndpoints: BACKEND_ENDPOINTS,
-    authDomainEndpoints: AUTH_DOMAIN_ENDPOINTS, backendAuthIds: BACKEND_AUTH_IDS,
-    staticModelIds: BACKEND_MODEL_IDS, endpointHost, resolveEndpoint, endpointEnv,
-    endpointMismatchHint, resolveEnToken, readDshWorkbuddyToken, readBackendAuthDomain,
-    diagnoseBackend, parseAccountModels, rememberAccountCatalog, getAccountCatalog,
-    normalizeProductConfig, extractModelIds, extractModelCredits, parseCreditValue,
-    formatCreditLabel, lookupModelCredits, normalizeSettings
-  })
-  // env 经 io 绑定：catalog 是模块级纯函数，若共用模块级 env，多 provider 实例会互相
-  // 覆盖（测试串扰）。这里每个实例调用时都带上自己的 env。
-  const withEnv = (fn) => (backend, io) => fn(backend, Object.assign({ env }, io || {}))
-  Object.assign(descriptor, {
-    backendModelCatalog: withEnv(backendModelCatalog),
-    modelCatalogDetailed: withEnv(modelCatalogDetailed),
-    formatModelCatalogText: withEnv(formatModelCatalogText)
-  })
-
-  descriptor.attach = function (hostOpts) {
-    host = hostOpts || {}
-    this.engine = createStatusEngine({ provider: this, publish: host.publish })
-    const runner = createRunner(Object.assign({}, host, { provider: this, engine: this.engine }))
-    this.runner = runner
-    return runner
-  }
-  descriptor.hostOptions = () => host
-  return descriptor
-}
+// providers/codebuddy.mjs — codebuddy provider descriptor。
+//
+// 移植基线：codebuddy-first-bridge v1.6.x 的纯逻辑与 preset 内联语义，逐字保持（契约 §8： // 工具入参语义与 schema 不许漂移）。provider 无关骨架在 bridge-kit。纯逻辑片：
+// codebuddy-catalog.mjs（模型目录/凭据）、codebuddy-models-source.mjs（探测+缓存）、
+// codebuddy-models-tool.mjs（codebuddy_models）、codebuddy-consts.mjs（POLICY_TEXT/后端表）、
+// codebuddy-schemas.mjs（三 schema）。
+//
+// 红线：本文件会被内联进 dynamic 沙箱 —— 绝不出现元环境字面量；process/env/fs 只经 deps
+// 注入或 typeof 守卫读取；宿主能力全部走 attach(hostOpts)。isLimited 用本文件自定义的中文
+// 限流表（旧 core verbatim），不用 kit 通用表。命名纪律：顶层名绝不与 bridge-kit 同名
+// （沙箱里同作用域），故限流表带 CODEBUDDY_ 前缀。
+// ⚠️ 各片在沙箱里被内联进**同一作用域**（build 做全局文本替换）：注释里绝不写占位标记的
+// 字面量，否则注释会被替换成正文代码而劈开，生成物语法崩。
+import { createStatusEngine, createRunner, clampInt } from '../core/bridge-kit.mjs'
+
+import {
+  BACKEND_MODEL_IDS, PRODUCT_DESCRIPTOR_ENV, CREDIT_ID_ALIASES, MODEL_DESCRIPTION, BACKEND_ENUM,
+  accountConfigCandidates, productDescriptorCandidates, normalizeProductConfig,
+  extractModelIds, parseCreditValue, formatCreditLabel, extractModelCredits, lookupModelCredits,
+  backendModelCatalog, rememberAccountCatalog, getAccountCatalog, parseAccountModels,
+  modelCatalogDetailed, formatModelCatalogText, cbCatalogSetHost,
+  BACKEND_AUTH_IDS, CREDENTIAL_KEYS, readBackendAuthDomain,
+  readDshWorkbuddyToken, resolveEnToken
+} from './codebuddy-catalog.mjs'
+// 探测/缓存那一层单独一片（要走子进程，与纯解析内聚度低；见 codebuddy-models-source.mjs 头注）。
+import {
+  fetchHelpModelsSync, cachedCliModels, currentPreferredBackend, parseHelpModels, probeAccountModelsSync,
+  rememberCliModels, probeAccountModels
+} from './codebuddy-models-source.mjs'
+import { codebuddyModelsTool } from './codebuddy-models-tool.mjs'
+import { POLICY_TEXT, CODEBUDDY_LIMIT_RE, BACKENDS, BACKEND_ENDPOINTS, AUTH_DOMAIN_ENDPOINTS, BACKEND_LABELS, BACKEND_ALIASES, DEFAULT_BACKEND, SETTINGS_KEYS } from './codebuddy-consts.mjs'
+import { RUN_PARAMS, CONTINUE_PARAMS, STATUS_PARAMS } from './codebuddy-schemas.mjs'
+
+export default function defineProvider(deps = {}) {
+  const env = deps.env || {}
+  let host = null // attach 后保存 hostOpts（preset/dynamic/MCP 形态宿主能力）
+
+  // 宿主 fs/path 访问的统一入口：deps 注入优先；dynamic 内联体（无 import，运行在
+  // 后端 Node 上下文）回退到 getBuiltinModule —— 与旧 core builtinModule() 的
+  // typeof 守卫模式一致（这是旧 dynamic 端点修复生效的同一条通道，缺了它默认
+  // 后端会回到 401 老病）。两者皆不可用时自然降级：读不到文件 = 静态表兜底。
+  function builtinModule(name) {
+    try {
+      const proc = globalThis.process
+      return (proc && typeof proc.getBuiltinModule === 'function') ? proc.getBuiltinModule(name) : null
+    } catch (e) { return null }
+  }
+  function fsRead(p) {
+    const nf = deps.nodeFs || builtinModule('node:fs')
+    if (!nf || typeof nf.readFileSync !== 'function') return null
+    try { return nf.readFileSync(p, 'utf8') } catch (e) { return null }
+  }
+  function pathJoin(...parts) {
+    const np = deps.nodePath || builtinModule('node:path')
+    if (np && typeof np.join === 'function') return np.join(...parts)
+    return parts.join('/')
+  }
+  const pathSep = (deps.nodePath && deps.nodePath.sep) || (/[A-Za-z]:[\\/]/.test(env.USERPROFILE || env.APPDATA || '') ? '\\' : '/')
+
+  // 把宿主真实能力注入 catalog 模块：它从本闭包搬出后拿不到 env / fsRead / pathJoin /
+  // pathSep。未注入时 catalog 退到 getBuiltinModule 守卫（绝不抛）。内联到 dynamic
+  // 沙箱时 cbCatalogSetHost 同作用域可见，行为一致。
+  try {
+    cbCatalogSetHost(env, deps.nodePath || builtinModule('node:path'), deps.nodeFs || builtinModule('node:fs'))
+  } catch (e) { }
+
+  // ── 端点/登录域（旧 core endpointHost verbatim：非法 URL 容错）───────────────
+  function endpointHost(url) {
+    const s = String(url || '').trim()
+    if (!s) return ''
+    try { return new URL(s).hostname.toLowerCase() } catch (e) { }
+    const m = /^[a-z]+:\/\/([^/?#]+)/i.exec(s)
+    return m ? m[1].toLowerCase() : ''
+  }
+
+  function resolveEndpoint(explicitBaseUrl, authDomain) {
+    const explicit = String(explicitBaseUrl || '').trim()
+    if (explicit) return explicit
+    const d = String(authDomain || '').trim().toLowerCase()
+    if (d && AUTH_DOMAIN_ENDPOINTS[d]) return AUTH_DOMAIN_ENDPOINTS[d]
+    return null
+  }
+
+  function isBackend(v) { return BACKENDS.indexOf(v) >= 0 }
+
+  // 后端名规范化（v1.3.3 verbatim）：别名 + 大小写不敏感；非后端名原样返回。
+  function normalizeBackend(v) {
+    if (typeof v !== 'string') return v
+    const lower = v.trim().toLowerCase()
+    const aliased = BACKEND_ALIASES[lower] || lower
+    return BACKENDS.indexOf(aliased) >= 0 ? aliased : v
+  }
+
+  // 后端解析优先级（旧 core verbatim）：显式 > 会话归属 > 用户偏好 > 默认。
+  function resolveBackend(args, target, preferredBackend) {
+    if (args && isBackend(normalizeBackend(args.backend))) return normalizeBackend(args.backend)
+    if (target && target.backend && isBackend(normalizeBackend(target.backend))) return normalizeBackend(target.backend)
+    if (preferredBackend && isBackend(normalizeBackend(preferredBackend))) return normalizeBackend(preferredBackend)
+    return DEFAULT_BACKEND
+  }
+
+  // 本次调用的端点/凭据 env 注入（旧 core endpointEnv verbatim 三规则）。
+  function endpointEnv(backend, explicitBaseUrl, authDomain, authToken) {
+    const out = {}
+    const endpoint = resolveEndpoint(explicitBaseUrl, authDomain)
+    const product = BACKEND_ENDPOINTS[backend]
+    if (endpoint && endpointHost(endpoint) !== endpointHost(product)) {
+      out.CODEBUDDY_BASE_URL = endpoint
+    }
+    if (backend === 'codebuddy-en') {
+      const tok = String(authToken || '').trim()
+      if (tok) out.CODEBUDDY_AUTH_TOKEN = tok
+    }
+    return Object.keys(out).length ? out : null
+  }
+
+  // 可操作提示（旧 core endpointMismatchHint 三分支 verbatim）。
+  function endpointMismatchHint(backend, authDomain, hasToken) {
+    if (backend === 'codebuddy-en' && !hasToken) {
+      return 'codebuddy-en（WorkBuddy 国际版）没有可用凭据。国际版的登录 token 被桌面 App 的 protector key 封装，该密钥不落盘、headless CLI 无法自行读取（CLI 自身报 category:"missing-key"）。桥接会依次尝试：插件设置 codebuddyEnToken → 环境变量 CODEBUDDY_AUTH_TOKEN → DSH 凭据库（.credentials.yaml / .env 里的 WORKBUDDY_TOKEN）——三者皆空。请在 DSH 里配好 workbuddy provider 的 key，或把国际版 token 填入插件设置；也可直接用 backend="workbuddy"（国内版桌面 CLI，免配置）。'
+    }
+    if (backend === 'codebuddy-intl') {
+      return 'codebuddy-intl（CodeBuddy 国际版）使用同一个 npm CLI，但国际面模型由服务端按账号授权放行：未授权时 CLI 返回 400「model [...] is only available for authorized users」。若你用的是国内账号，请改用 backend="codebuddy"（国内面模型清单）或 backend="codebuddy-en"（WorkBuddy 国际版）。'
+    }
+    const d = String(authDomain || '').trim().toLowerCase()
+    if (d && endpointHost(resolveEndpoint(null, d)) !== endpointHost(BACKEND_ENDPOINTS[backend])) {
+      return backend + ' 的登录域是 ' + d + '，与产品端点 ' + BACKEND_ENDPOINTS[backend] + ' 不一致；桥接层已自动注入 CODEBUDDY_BASE_URL=' + AUTH_DOMAIN_ENDPOINTS[d] + '。若仍 401，请重新登录对应客户端。'
+    }
+    return null
+  }
+
+  // 从 auth 库读某后端登录域（旧 core readBackendAuthDomain verbatim 语义；fs 经
+  // deps 注入。io 可覆盖 readFileSync/dir/env，供测试夹具与 MCP 面注入真实 fs）。
+
+  // ── 模型目录（面板/诊断用；无促销角标版，见头注 TODO）───────────────────────
+  // ── 设置清洗（旧 normalizeBridgeSettings verbatim；updatedAt 透传）───────────
+  function normalizeSettings(raw) {
+    const snap = { preferredBackend: DEFAULT_BACKEND, defaultModel: '', codebuddyEnToken: '', endpointOverride: '' }
+    if (!raw || typeof raw !== 'object') return snap
+    if (typeof raw.preferredBackend === 'string') {
+      const nb = normalizeBackend(raw.preferredBackend)
+      if (typeof nb === 'string' && BACKENDS.indexOf(nb) >= 0) snap.preferredBackend = nb
+    }
+    if (typeof raw.defaultModel === 'string') snap.defaultModel = raw.defaultModel.trim()
+    if (typeof raw.codebuddyEnToken === 'string') snap.codebuddyEnToken = raw.codebuddyEnToken.trim()
+    if (typeof raw.endpointOverride === 'string') snap.endpointOverride = raw.endpointOverride.trim()
+    if (typeof raw.updatedAt === 'number' && raw.updatedAt > 0) snap.updatedAt = raw.updatedAt
+    return snap
+  }
+
+  // 诊断（旧 diagnoseBackend verbatim；fs/env 走 deps）。
+  function diagnoseBackend(backend, settings, io) {
+    const o = io || {}
+    const e = o.env || env
+    const s = settings || normalizeSettings(null)
+    const authDomain = readBackendAuthDomain(backend, Object.assign({ env: e }, o))
+    const override = String(s.endpointOverride || '').trim()
+    const byDomain = resolveEndpoint(null, authDomain)
+    const endpoint = override || byDomain || BACKEND_ENDPOINTS[backend] || null
+    const endpointSource = override ? 'override' : (byDomain ? 'auth-domain' : 'product')
+    const tok = resolveEnToken(backend === 'codebuddy-en' ? s.codebuddyEnToken : null, { env })
+    return {
+      backend: backend,
+      authDomain: authDomain,
+      endpoint: endpoint,
+      endpointSource: endpointSource,
+      tokenSource: backend === 'codebuddy-en' ? tok.source : 'not-needed',
+      tokenHint: tok.source === 'setting' ? '来自设置面板'
+        : tok.source === 'env' ? '来自环境变量 CODEBUDDY_AUTH_TOKEN'
+          : tok.source === 'dsh-store' ? '来自 DSH 凭据库（自动复用 WORKBUDDY_TOKEN）'
+            : backend === 'codebuddy-en' ? '缺失：国际版 token 不落盘，需在设置面板填写或先在 DSH 配 workbuddy provider'
+              : '无需填写（国内版由 CLI 自行登录）',
+      mismatch: endpointMismatchHint(backend, authDomain, !!tok.token) !== null,
+      hint: endpointMismatchHint(backend, authDomain, !!tok.token) || null,
+      defaultModel: String(s.defaultModel || '').trim() || '(CLI 默认)'
+    }
+  }
+
+  // ── 结果判定（旧 isLimited/isTransientCliError/failureHint verbatim）─────────
+  function isLimitedCodebuddy(res) {
+    if (!res || res.ok) return false
+    // 前置凭据缺失：配置问题，不是限流（弹窗重试不会让 token 出现）。
+    if (res.status === 'AUTH_REQUIRED') return false
+    if (res.status === 'SPAWN_ERROR' || res.status === 'CODEBUDDY_UNAVAILABLE' || res.status === 'HUNG_TIMEOUT') return true
+    const hay = String(res.stderr || '') + ' ' + String(res.status || '')
+    // 401/端点域不匹配：需要用户换登录域，不归限流类（旧 v1.3.0 verbatim）。
+    if (/401 authentication failed|differs from the current product endpoint/i.test(hay)) return false
+    return CODEBUDDY_LIMIT_RE.test(hay)
+  }
+
+  function isTransientCliError(res) {
+    if (!res || res.ok) return false
+    if (isLimitedCodebuddy(res)) return false
+    return res.status === 'ERROR_DURING_EXECUTION'
+  }
+
+  function failureHint(res) {
+    if (!res || res.ok) return ''
+    // AUTH_REQUIRED：stderr 已带完整指引，透传（旧 v1.3.1 verbatim）。
+    if (res.status === 'AUTH_REQUIRED') return '[诊断] ' + String(res.stderr || '')
+    if (isTransientCliError(res)) {
+      return res.retried
+        ? '[诊断] codebuddy CLI 侧瞬时错误（error_during_execution，CLI 未给出原因），已自动重试 1 次仍失败。可换 model 再试一次；若仍失败请改用原生工具完成，或告知用户。'
+        : '[诊断] codebuddy CLI 侧瞬时错误（error_during_execution，CLI 未给出原因）。直接重试同一请求通常即可通过；也可显式指定 model。不要据此认为任务本身有问题。'
+    }
+    if (res.status === 'PARSE_ERROR') {
+      return '[诊断] 未能从 codebuddy 输出解析出 result 事件（进程可能被中断或输出被截断）。可重试；持续出现请检查 codebuddy CLI 版本。'
+    }
+    if (/401 authentication failed|differs from the current product endpoint/i.test(String(res.stderr || ''))) {
+      return '[诊断] 认证失败（401）：请求被送到的端点与当前 CLI 登录域不匹配（国际/国内登录互斥）。请让用户在对应产品域完成 `codebuddy` CLI 登录后重试；这不是限流，重试与回退都无效。'
+    }
+    return ''
+  }
+
+  // stream-json 解析（旧 parseCodebuddyJson verbatim）。
+  function parseCodebuddyJson(stdoutText) {
+    const trimmed = String(stdoutText || '').trim()
+    if (!trimmed) return null
+    const lines = trimmed.split(/\r?\n/).filter(Boolean)
+    for (let i = lines.length - 1; i >= 0; i--) {
+      const ln = lines[i].trim()
+      if (!ln.startsWith('{')) continue
+      try {
+        const obj = JSON.parse(ln)
+        if (obj && obj.type === 'result') return obj
+      } catch (e) {}
+    }
+    try { return JSON.parse(trimmed) } catch (e) {}
+    return null
+  }
+
+  // result 事件 → 统一结果对象（旧 buildResult verbatim，含账号清单收割）。
+  function buildResult(parsed, outcome, mode, stderrText, stdoutText, backend) {
+    const bk = backend || 'codebuddy'
+    const exitCode = outcome ? outcome.exitCode : null
+    const errText = parsed && typeof parsed.error === 'string' && parsed.error ? parsed.error : ''
+    const stderr = (stderrText ? String(stderrText).slice(-2000) : '') + (errText ? (stderrText ? ' ' : '') + errText : '')
+    // v1.6.0：顺手收割服务端回吐的「本账号可用模型」清单（失败静默）。
+    try {
+      const harvest = parseAccountModels(stderr) || parseAccountModels(String(stdoutText || ''))
+      if (harvest && harvest.length) rememberAccountCatalog(bk, harvest)
+    } catch (e) { /* 收割失败不影响主流程 */ }
+    if (parsed && parsed.type === 'result') {
+      const isOk = exitCode === 0 && parsed.is_error === false && parsed.subtype === 'success'
+      let modelUsed = null
+      try {
+        if (parsed.modelUsage && typeof parsed.modelUsage === 'object') {
+          const names = Object.keys(parsed.modelUsage)
+          if (names.length) modelUsed = names.join('+')
+        }
+      } catch (e) { }
+      return {
+        ok: isOk,
+        status: String(parsed.subtype || (isOk ? 'SUCCESS' : 'ERROR')).toUpperCase(),
+        response: typeof parsed.result === 'string' ? parsed.result : '',
+        sessionId: typeof parsed.session_id === 'string' ? parsed.session_id : null,
+        durationSeconds: typeof parsed.duration_ms === 'number' ? parsed.duration_ms / 1000 : null,
+        numTurns: typeof parsed.num_turns === 'number' ? parsed.num_turns : null,
+        totalTokens: (parsed.usage && typeof parsed.usage.input_tokens === 'number' && typeof parsed.usage.output_tokens === 'number')
+          ? (parsed.usage.input_tokens + parsed.usage.output_tokens) : null,
+        exitCode: exitCode,
+        mode: mode,
+        backend: bk,
+        modelUsed: modelUsed,
+        stderr: stderr
+      }
+    }
+    return {
+      ok: false,
+      status: 'PARSE_ERROR',
+      response: '',
+      sessionId: null,
+      durationSeconds: null,
+      numTurns: null,
+      totalTokens: null,
+      exitCode: exitCode,
+      mode: mode,
+      backend: bk,
+      stderr: stderr,
+      rawStdout: String(stdoutText || '').slice(-2000)
+    }
+  }
+
+  // 统一 argv 构造（旧 buildArgv verbatim；env 端点/凭据注入在本 provider 内完成，
+  // 因为 kit 只透传 opts，宿主三形态都从本函数的返回值取 built.env 下发 spawn）。
+  function buildArgvCodebuddy(prefix, args, opts) {
+    const o = opts || {}
+    const argv = [prefix[0], ...prefix.slice(1), '-p', String(args.prompt), '--output-format', 'stream-json']
+    let mode = args.mode || o.defaultMode || 'auto'
+    if (mode === 'auto') mode = o.planActive ? 'plan' : 'bypassPermissions'
+    if (mode === 'plan') {
+      argv.push('--permission-mode', 'plan')
+      argv.push('--allowedTools', 'Bash')
+    } else {
+      mode = 'bypassPermissions'
+      argv.push('--permission-mode', 'bypassPermissions')
+    }
+    // 模型优先级：显式 args.model > 用户偏好 defaultModel > CLI 默认。
+    const model = args.model || o.defaultModel
+    if (model) argv.push('--model', String(model))
+    if (args.effort) argv.push('--effort', String(args.effort))
+    if (args.maxTurns !== undefined && args.maxTurns !== null) argv.push('--max-turns', String(clampInt(args.maxTurns, 50, 1, 500)))
+    if (Array.isArray(args.addDirs)) for (const d of args.addDirs) { if (d) argv.push('--add-dir', String(d)) }
+    if (args.sessionId) argv.push('--resume', String(args.sessionId))
+    else if (args.continueLatest) argv.push('--continue')
+    const timeoutSec = clampInt(args.timeoutSec, 300, 10, 3600)
+    // 端点/凭据注入（旧 preset/dynamic/MCP 三形态一致语义，宿主不必自算）：
+    // authDomain 只在有 fs 能力的宿主读得到；dynamic 沙箱 → 沿用 CLI 自身端点。
+    const bk = o.backend || DEFAULT_BACKEND
+    const settings = o.settings || null
+    const authDomain = readBackendAuthDomain(bk, { env })
+    const tok = resolveEnToken(bk === 'codebuddy-en' && settings ? settings.codebuddyEnToken : null, { env })
+    const inject = endpointEnv(bk, settings ? settings.endpointOverride : null, authDomain, tok.token)
+    return { argv: argv, timeoutSec: timeoutSec, mode: mode, env: o.env || inject }
+  }
+
+  // 流事件折叠（旧 foldEvent 主体 verbatim；project 状态由 kit engine 持有）。
+  function foldStreamEvent(ev, p, summarizeArgs, MAX_ARG_LEN, MAX_TRAIL) {
+    if (!ev || !ev.type) return
+    if (ev.type === 'assistant' && ev.message && Array.isArray(ev.message.content)) {
+      for (const block of ev.message.content) {
+        if (block.type === 'tool_use') {
+          p._stepCounter = (p._stepCounter || 0) + 1
+          const stepIndex = p._stepCounter
+          if (!p._toolMap) p._toolMap = {}
+          p._toolMap[block.id] = { stepIndex: stepIndex, name: block.name }
+          const args = summarizeArgs(block.input)
+          p.trail.push({ stepIndex: stepIndex, state: 'ACTIVE', tool: block.name, args: args, at: new Date().toISOString() })
+          if (p.trail.length > MAX_TRAIL) p.trail.shift()
+          p.current = { tool: block.name, args: args, stepIndex: stepIndex, since: new Date().toISOString() }
+        } else if (block.type === 'thinking') {
+          p.current = { tool: 'thinking', args: { text: String(block.thinking || '').slice(0, MAX_ARG_LEN) }, stepIndex: 0, since: new Date().toISOString() }
+        } else if (block.type === 'text') {
+          p.current = { tool: 'typing', args: { text: String(block.text || '').slice(0, MAX_ARG_LEN) }, stepIndex: 0, since: new Date().toISOString() }
+        }
+      }
+    } else if (ev.type === 'user' && ev.message && Array.isArray(ev.message.content)) {
+      for (const block of ev.message.content) {
+        if (block.type === 'tool_result' && p._toolMap && p._toolMap[block.tool_use_id]) {
+          const rec = p._toolMap[block.tool_use_id]
+          p.trail.push({ stepIndex: rec.stepIndex, state: block.is_error ? 'ERROR' : 'DONE', tool: rec.name, args: null, at: new Date().toISOString() })
+          if (p.trail.length > MAX_TRAIL) p.trail.shift()
+          if (p.current && p.current.stepIndex === rec.stepIndex) p.current = null
+        }
+      }
+    }
+  }
+
+  const descriptor = {
+    id: 'codebuddy',
+    label: 'CB',
+    presetId: 'codebuddy-first',
+    defaultBackend: DEFAULT_BACKEND,
+    defaultMode: 'auto',
+    exeName: 'codebuddy',
+    binEnvVars: ['CODEBUDDY_BIN', 'CODEBUDDY_EN_BIN', 'WORKBUDDY_BIN'],
+    unavailableStatus: 'CODEBUDDY_UNAVAILABLE',
+    // 旧 renderResult verbatim 语义：标头用具体 backend（'workbuddy OK'），仅当结果
+    // 无 backend 字段时回落 'codebuddy'（= provider.id）。agy/mimo 旧包标头硬编码
+    // provider 名，不设此旗。
+    backendLabel: true,
+
+    backends: () => BACKENDS.slice(),
+    normalizeBackend,
+    resolveBackend,
+
+    buildArgv: buildArgvCodebuddy,
+    parseJson: parseCodebuddyJson,
+    buildResult,
+    foldStreamEvent,
+    isLimited: isLimitedCodebuddy,
+    isTransientCliError,
+    failureHint,
+
+    // codebuddy-en 无凭据的确定性前置（v1.3.1 语义，经 kit preflight 钩子实现）：
+    // 三通道皆空 → 直接 AUTH_REQUIRED（可操作指引进 stderr），不白跑一次 spawn。
+    // 其它后端一律放行。dynamic 沙箱无 fs → dsh-store 通道缺席，abort 提示即可。
+    preflight({ args, backend, engine, o }) {
+      if (backend !== 'codebuddy-en') return null
+      const settings = (o && o.getSettings && o.getSettings()) || null
+      const tok = resolveEnToken(settings ? settings.codebuddyEnToken : null, { env })
+      if (tok.token) return null
+      const authDomain = readBackendAuthDomain('codebuddy-en', { env })
+      const hint = endpointMismatchHint('codebuddy-en', authDomain, false)
+      return {
+        abort: {
+          ok: false,
+          status: 'AUTH_REQUIRED',
+          response: '',
+          sessionId: null,
+          durationSeconds: null,
+          numTurns: null,
+          totalTokens: null,
+          exitCode: null,
+          mode: (args && args.mode) || descriptor.defaultMode || 'auto',
+          backend: 'codebuddy-en',
+          stderr: hint
+        }
+      }
+    },
+
+    tools: {
+      run: {
+        name: 'codebuddy_run',
+        description: 'Dispatch a coding/build/debug/investigation task to the local codebuddy agent CLI and return its final answer. Prefer this for implementation, edits, refactors, multi-file investigation and debugging in every mode. DSH fully controls codebuddy: it always runs non-interactively with permissions auto-approved (codebuddy never prompts). Use read-only native tools only for quick lookups and for final build/test verification. In mode=auto the DSH plan state decides plan vs bypassPermissions. Set background=true for long tasks and collect the result via job_output.',
+        inputSchema: RUN_PARAMS
+      },
+      continue: {
+        name: 'codebuddy_continue',
+        description: 'Continue an existing codebuddy conversation with a follow-up prompt, reusing codebuddy context. Pass sessionId from a prior codebuddy_run result, or set latest=true to continue the most recent codebuddy conversation. Same DSH-controlled, no-prompt execution as codebuddy_run.',
+        inputSchema: CONTINUE_PARAMS
+      },
+      status: {
+        name: 'codebuddy_status',
+        description: 'Read a live snapshot of what the local codebuddy agent is currently doing. Returns one section per project (working directory): running count, the current step (tool name + arguments being executed, or agent_response thinking/typing), the recent step trail (tools executed, done/error), the last completed run status + session id, and per-project cumulative usage (runs + total tokens, since codebuddy exposes no quota API). Optional cwd filters to a single project. Call this to check on an in-flight codebuddy_run/codebuddy_continue without waiting for it to finish.',
+        inputSchema: STATUS_PARAMS
+      }
+    },
+
+    // codebuddy_models：只在宿主有 spawn/fs 能力时注册（preset 注 deps.process；MCP 注
+    // deps.nodeChild；dynamic 沙箱省略）。**失败必须 ok:false + 可操作错误**，绝不静默返回
+    // 空列表或伪造模型（红线 §7；对照 workbuddy-auth 的 catalog-store 静默降级 —— 不照抄）。
+    extraTools: (deps.process || deps.nodeChild || deps.nodeFs) ? [codebuddyModelsTool({
+      env, deps, BACKEND_ENUM, normalizeBackend, resolveBackend, modelCatalogDetailed, getAccountCatalog,
+      // faceEnv：让账号探测打到**请求的那个产品面**（与 buildArgv 同一套端点/凭据注入）。
+      // 缺了它探测会走 CLI 自身默认登录面 —— 标着 codebuddy-en 却去问 codebuddy 面。
+      faceEnv: (backend) => {
+        try {
+          const settings = (deps.settings && typeof deps.settings === 'object') ? deps.settings : {}
+          const authDomain = readBackendAuthDomain(backend, { env })
+          const tok = resolveEnToken(backend === 'codebuddy-en' ? settings.codebuddyEnToken : null, { env })
+          return endpointEnv(backend, settings.endpointOverride, authDomain, tok.token) || {}
+        } catch (e) { return {} }
+      }
+    })] : [],
+
+    // 设置分区（契约 §3）：keystone 统一文件 {codebuddy:{...}}；旧扁平文件的字段
+    // 级迁移由 keystone LEGACY_SOURCES 承担（字段名逐字相同）。
+    settings: {
+      keys: SETTINGS_KEYS,
+      secretKeys: ['codebuddyEnToken'],
+      defaults: () => normalizeSettings(null),
+      normalize: (raw) => normalizeSettings(raw),
+      meta() {
+        // defaultModel 下拉 = 缓存里的账号级清单。走过的弯路：静态表层（16 项、2 个 id 已改名）
+        // → CLI `--help` 名册（18 项但仍滞后、含已废 id）→ 无效模型探测让服务端回权威清单。
+        // 契约 §3.2 起 meta() **只读缓存、绝不 spawn**；探测由「拉取可用模型」触发 refreshModels。
+        // 面的取值必须与 refreshModels 同源（先宿主设置、再设置文件），否则会「刷新成功但下拉仍空」。
+        const face0 = (deps.settings && deps.settings.preferredBackend) || currentPreferredBackend()
+        const face = normalizeBackend(face0) || DEFAULT_BACKEND
+        const live = cachedCliModels(face)          // 只读：未命中返回 undefined
+        let options = []
+        let note = '点下方「拉取可用模型」从服务端获取本账号的可用清单；当前面：' + face +
+          '。日常任务优先免费（x0.00）。'
+        if (live && live.ids && live.ids.length) {
+          const detail = modelCatalogDetailed(face, { env, accountModels: live.ids })
+          const byId = new Map(detail.map((x) => [x.id, x]))
+          options = live.ids.map((id) => {
+            const d = byId.get(id)
+            return { value: id, label: (d && d.label) || id }
+          })
+          note = '上次拉取结果（' + live.ids.length + ' 项，服务端裁决）；当前面：' + face +
+            '。要更新请重新点「拉取可用模型」。'
+        } else {
+          note = '尚未拉取（或该面未登录）。点「拉取可用模型」让服务端回吐本账号的清单；' +
+            '此前也可直接手输模型 id。当前面：' + face + '。'
+        }
+        return {
+          titleSuffix: 'CodeBuddy',
+          fields: [
+            {
+              key: 'preferredBackend', label: '默认后端', type: 'select',
+              options: BACKENDS.map((b) => ({ value: b, label: BACKEND_LABELS[b] })),
+              note: '新会话未显式指定 backend 时用这里选的后端；单次调用可覆盖。codebuddy-en 需要 codebuddyEnToken 或 DSH 已配 workbuddy key。'
+            },
+            {
+              key: 'defaultModel', label: '默认模型', type: 'select', allowCustom: true, placeholder: '(CLI 默认)',
+              options,
+              refresh: { label: '拉取可用模型' },
+              note
+            },
+            { key: 'codebuddyEnToken', label: 'WorkBuddy 国际版 Token', type: 'secret', note: '仅 backend="codebuddy-en" 需要。国际版登录 token 被 protector key 封装不落盘，只能手工提供；留空则自动尝试 DSH 凭据库的 WORKBUDDY_TOKEN。' },
+            { key: 'endpointOverride', label: '端点覆盖', type: 'text', placeholder: 'https://…/v2', note: '一般留空：端点按登录域自动对齐（www.codebuddy.cn 等）。仅在需要强制指定 API 端点时填写，且必须自带 /v2。' }
+          ]
+        }
+      },
+      diagnose(snap) {
+        const s = normalizeSettings(snap)
+        const lines = []
+        const seen = new Set()
+        // 默认后端一行；codebuddy-en 是 4 面里唯一需要凭据的，恒附一行状态。
+        for (const b of [s.preferredBackend, 'codebuddy-en']) {
+          if (seen.has(b)) continue
+          seen.add(b)
+          const d = diagnoseBackend(b, s, {})
+          lines.push(b + ': ' + (d.endpoint || '?') + '（登录域 ' + (d.authDomain || '未读到') + '，' + d.tokenHint + '）')
+          if (d.hint) lines.push('  ⚠ ' + d.hint)
+        }
+        return lines.join('\n')
+      },
+      /**
+       * 手动拉取（契约 §3.2）：唯一权威源 = 无效模型触发的服务端 400 报文（「Currently
+       * supported models for your account」）。成功后回填缓存，settingsView 再取 meta 即显示。
+       * 失败一律 ok:false + 可操作错误 —— 绝不返回 {ok:true, ids:[]}，也绝不把静态表/CLI
+       * 自报名册冒充成账号可用清单（0.2.6~0.2.7 反复踩过的坑）。
+       */
+      async refreshModels(settings, envOverride) {
+        const s = normalizeSettings(settings)
+        const face = normalizeBackend(s.preferredBackend) || DEFAULT_BACKEND
+        const e = envOverride || env
+        // 端点/凭据注入与 buildArgv 同一套规则（否则会拿 A 面凭据去问 B 面）。
+        let faceEnv = {}
+        try {
+          const authDomain = readBackendAuthDomain(face, { env: e })
+          const tok = resolveEnToken(face === 'codebuddy-en' ? s.codebuddyEnToken : null, { env: e })
+          faceEnv = endpointEnv(face, s.endpointOverride, authDomain, tok.token) || {}
+        } catch (err) { faceEnv = {} }
+        let probe
+        try {
+          probe = await probeAccountModels(e, { envExtra: faceEnv, timeoutMs: 90000 })
+        } catch (err) {
+          return { ok: false, ids: [], source: 'account-live', error: '探测进程异常：' + String((err && err.message) || err) }
+        }
+        if (!probe || !probe.ok || !probe.ids || !probe.ids.length) {
+          return {
+            ok: false, ids: [], source: 'account-live',
+            error: '未能从「' + face + '」面获取账号模型清单：' + String((probe && probe.error) || 'no roster') +
+              '。常见原因：该面未登录（先在 codebuddy CLI 里 /login）、token 缺失或端点不通；' +
+              '也可在「默认后端」里换个面再拉。'
+          }
+        }
+        rememberCliModels(face, probe.ids, 'account-live')
+        // 标签沿用目录展示名（没有就回落 id），与下拉其它项一致。
+        const detail = modelCatalogDetailed(face, { env: e, accountModels: probe.ids })
+        const labels = {}
+        for (const x of (Array.isArray(detail) ? detail : [])) if (x && x.label) labels[x.id] = x.label
+        return { ok: true, ids: probe.ids, labels, source: 'account-live' }
+      }
+    },
+
+    mcp: { version: '0.2.2' }
+  }
+
+  // 三形态共用的工具逻辑（签名保持 keystone/队友接线契约不变）。
+  descriptor.runToolLogic = async function (args, exec) {
+    return this.runner.coreExecute(args, exec)
+  }
+  // 旧 preset continueTool.execute verbatim 映射（sessionId 优先，否则 latest）。
+  descriptor.continueToolLogic = async function (args, exec) {
+    const a = args || {}
+    const mapped = { prompt: a.prompt, backend: a.backend, mode: a.mode, model: a.model, effort: a.effort, maxTurns: a.maxTurns, cwd: a.cwd, timeoutSec: a.timeoutSec, background: a.background }
+    if (a.sessionId) mapped.sessionId = a.sessionId
+    else if (a.latest) mapped.continueLatest = true
+    return this.runner.coreExecute(mapped, exec)
+  }
+  // 旧 statusTool.execute verbatim：cwd 过滤 + 单项目聚合覆写（含 runs/totalTokens）。
+  descriptor.statusToolLogic = function (args) {
+    const a = args || {}
+    const snap = this.engine.statusSnapshot()
+    if (a.cwd) {
+      const key = String(a.cwd)
+      snap.projects = snap.projects.filter((p) => p.cwd === key)
+      const g = snap.projects[0]
+      if (g) { snap.state = g.state; snap.running = g.running; snap.current = g.current; snap.trail = g.trail; snap.lastStatus = g.lastStatus; snap.lastAt = g.lastAt; snap.lastSessionId = g.lastSessionId; snap.lastBackend = g.lastBackend; snap.fallbackActive = g.fallbackActive; snap.runs = g.runs; snap.totalTokens = g.totalTokens; snap.updatedAt = g.updatedAt }
+    }
+    return snap
+  }
+
+  // 供 preset/dynamic/MCP/测试形态复用的领域函数（不 import home-plugin，全部经
+  // 描述符暴露；MCP 面据 buildArgv/parseJson/buildResult/isLimited/failureHint 组
+  // 装真实 spawn 执行，语义与旧 mcp/codebuddy-mcp-server.mjs 一致）。
+  Object.assign(descriptor, {
+    policyText: POLICY_TEXT, limits: { LIMIT_RE: CODEBUDDY_LIMIT_RE },
+    backendLabels: BACKEND_LABELS, backendEndpoints: BACKEND_ENDPOINTS,
+    authDomainEndpoints: AUTH_DOMAIN_ENDPOINTS, backendAuthIds: BACKEND_AUTH_IDS,
+    staticModelIds: BACKEND_MODEL_IDS, endpointHost, resolveEndpoint, endpointEnv,
+    endpointMismatchHint, resolveEnToken, readDshWorkbuddyToken, readBackendAuthDomain,
+    diagnoseBackend, parseAccountModels, rememberAccountCatalog, getAccountCatalog,
+    normalizeProductConfig, extractModelIds, extractModelCredits, parseCreditValue,
+    formatCreditLabel, lookupModelCredits, normalizeSettings
+  })
+  // env 经 io 绑定：catalog 是模块级纯函数，若共用模块级 env，多 provider 实例会互相
+  // 覆盖（测试串扰）。这里每个实例调用时都带上自己的 env。
+  const withEnv = (fn) => (backend, io) => fn(backend, Object.assign({ env }, io || {}))
+  Object.assign(descriptor, {
+    backendModelCatalog: withEnv(backendModelCatalog),
+    modelCatalogDetailed: withEnv(modelCatalogDetailed),
+    formatModelCatalogText: withEnv(formatModelCatalogText)
+  })
+
+  descriptor.attach = function (hostOpts) {
+    host = hostOpts || {}
+    this.engine = createStatusEngine({ provider: this, publish: host.publish })
+    const runner = createRunner(Object.assign({}, host, { provider: this, engine: this.engine }))
+    this.runner = runner
+    return runner
+  }
+  descriptor.hostOptions = () => host
+  return descriptor
+}