@luchenglong/cli-bridge 0.2.3 → 0.2.5

package/dynamic/mimo.host.template.mjs

@@ -3,7 +3,7 @@
 // 构建（node scripts/build.mjs --only=mimo）把 core/bridge-kit.mjs 与
 // providers/mimo.mjs 分别内联进下方两个占位标记行（各占一行、行内仅此标记），
 // 生成 dynamic/mimo.host.js。注意：标记字面量绝不能出现在本注释里 —— 构建做全局
-// 替换，注释中出现同样会被替换成正文代码而炸掉语法。
+// 替换，注释中出现同样也会被替换成正文代码而炸掉语法。
 // 沙箱纪律（旧仓 dynamic/host.js 头注 verbatim 精神）：
 //  - 禁 import/require、无 TypeScript；无 AbortController/process 裸引用/Buffer/原生
 //    定时器 —— process 只经 typeof 守卫探测；宿主能力全部来自注入的 harness.*/ctx。
@@ -12,14 +12,9 @@
 //  - 无 ctx.emit：状态经 ctx.get('cliBridgeCollector').mergeSnapshot('mimo', snap)
 //    推给家级灯（旧 mimoCollector 服务名在 keystone 里保留别名）；动态形态不宣告
 //    mode（旧语义：普通模式灯仅在调用 mimo 时临时显示）。
-//  - mimo-desktop 在沙箱的形态（契约 §9）：无 fs 发现 desktop-api.json，且多数沙箱
-//    无 fetch —— 描述符 preflight 直接 abort 为 DESKTOP_UNREACHABLE 并提示改用
-//    backend=mimocode（旧仓返回 DESKTOP_UNSUPPORTED 的替代；语义升级，Lead 定案）。
-//    宿主若注入了 globalThis.fetch 且给出 MIMO_DESKTOP_PORT/MIMO_DESKTOP_TOKEN env，
-//    委托 execute 仍可走通（fetch 路径全部 typeof 守卫）。
 //  - mimo_settings 在沙箱不持久化（无 nodeFs → 描述符回显语义；旧 dynamic echo 形态）。
-//  - exe 解析（旧动态候选无 existsSync 校验，盲取候选 [0] 易 spawn 失败）：升级走
-//    agy 模板同款链路 —— MIMO_BIN/MIMO_CLI env > subprocess.resolveExecutable(PATH)。
+//  - 单后端（本地 mimo CLI / MiMoCode）：exe 解析走 agy 模板同款链路 ——
+//    MIMO_BIN/MIMO_CLI env > 已知安装位置 > subprocess.resolveExecutable(PATH)。
 /*__KIT__*/
 /*__PROVIDER__*/
 /*__SCHED__*/
@@ -48,14 +43,16 @@ return {
       } catch (e) { /* 灯数据尽力而为 */ }
     }
 
-    // exe：MIMO_BIN/MIMO_CLI env > PATH 查找 mimo（subprocess.resolveExecutable）。
-    // mimo-desktop 后端不 spawn：返回占位字符串让 kit 直达 delegates→execute/preflight。
+    // exe：MIMO_BIN/MIMO_CLI env > 已知安装位置 > PATH 查找 mimo
+    // （subprocess.resolveExecutable）。与 descriptor 的 resolveMimoExePrefix 同一套
+    // 优先级；.js/.mjs 目标经 process.execPath 包装（供测试 fixture 使用）。
     async function resolveExe(backend, signal) {
-      if (backend === 'mimo-desktop') return 'mimo'
-      const bin = env.MIMO_BIN || env.MIMO_CLI || ''
-      if (bin) {
-        if (/\.(mjs|cjs|js)$/i.test(bin) && typeof process !== 'undefined' && process.execPath) return [process.execPath, bin]
-        return bin
+      const prefix = resolveMimoExePrefix(env)
+      if (prefix.length && prefix[0]) {
+        const head = String(prefix[0])
+        if (prefix.length > 1) return prefix
+        if (/\.(mjs|cjs|js)$/i.test(head) && typeof process !== 'undefined' && process.execPath) return [process.execPath, head]
+        return head
       }
       return await subprocess.resolveExecutable('mimo', undefined, signal)
     }
@@ -70,9 +67,22 @@ return {
       return '.'
     }
 
-    // 预选链（沙箱无 fs 读设置文件）：env MIMO_BRIDGE_BACKEND / MIMO_BACKEND。
-    function getPreferredBackend() {
-      return env.MIMO_BRIDGE_BACKEND || env.MIMO_BACKEND || null
+    // 设置分区（descriptor 的 host.getSettings('mimo') 契约：直接返回分区对象
+    // { defaultModel } 或空对象）。每次调用重读统一设置文件 —— 面板改默认模型后
+    // 无需重启即生效；读不到（沙箱无 fs / 文件缺失）回落 {} = 不传 --model。
+    function getSettings() {
+      try {
+        const proc = (typeof process !== 'undefined') ? process : null
+        const nodeFs = (proc && typeof proc.getBuiltinModule === 'function') ? proc.getBuiltinModule('node:fs') : null
+        if (!nodeFs || typeof nodeFs.readFileSync !== 'function') return {}
+        const nodePath = (proc && typeof proc.getBuiltinModule === 'function') ? proc.getBuiltinModule('node:path') : null
+        const join = nodePath ? nodePath.join.bind(nodePath) : ((...p) => p.join('/'))
+        const file = env.CLI_BRIDGE_SETTINGS_FILE || (env.DSH_HOME ? join(env.DSH_HOME, 'cli-bridge-settings.json') : null)
+        if (!file) return {}
+        const all = JSON.parse(nodeFs.readFileSync(file, 'utf8'))
+        if (all && typeof all === 'object' && all.mimo && typeof all.mimo === 'object') return all.mimo
+      } catch (e) { /* 读不到：回落空分区（默认模型为空 → 不传 --model） */ }
+      return {}
     }
 
     function planActiveFor(exec) {
@@ -85,7 +95,7 @@ return {
       return false
     }
 
-    provider.attach({ ctx, subprocess, resolveExe, getCwdFallback, getPreferredBackend, planActiveFor, publish })
+    provider.attach({ ctx, subprocess, resolveExe, getCwdFallback, getSettings, planActiveFor, publish })
 
     const OUTPUT_SCHEMA = { type: 'object', additionalProperties: true }
 
@@ -126,13 +136,22 @@ return {
     // 浏览器指示灯轮询的 RPC 面（旧 dynamic/handle('mimo_status') 语义）。
     harness.handle('mimo_status', function () { return provider.statusToolLogic({}) })
 
-    // 旧 policy 文案 verbatim（提示词连续性红线）。
+    // 提示词连续性（契约 §8）：决策表 / 上下文协议 / 回退协议三段保留旧语义；后端段与
+    // 模型段随「去 desktop 化 + 模型手动指定」重写（免费 API 已终止 + mimo auth login）。
+    // 与 preset/mimo-first/cli-bridge.mjs 的 policy 段保持同文。
     const policyText = [
-      'mimo-first execution policy (Xiaomi MiMo: MiMoCode CLI or MiMo Desktop client).',
+      'mimo-first execution policy (Xiaomi MiMo: MiMoCode CLI).',
+      '',
+      'Local `mimo` CLI (MiMoCode) handles coding tasks under full DSH control (--dangerously-skip-permissions, never prompts).',
       '',
-      'Local backends (selectable in settings: backend = mimocode | mimo-desktop):',
-      '- mimocode (default): local `mimo` CLI (MiMoCode). Full DSH control (--dangerously-skip-permissions, never prompts).',
-      '- mimo-desktop: Xiaomi MiMo Desktop client local API (running Desktop app; uses its login/model/session UI).',
+      'Model:',
+      '- The model is chosen in the CLI Bridge settings panel (provider/model form, e.g. xiaomi/mimo-v2.6-flash) — this bridge does not pick one.',
+      '- Leave the setting empty to pass no --model, letting the mimo CLI use its own default. A per-call `model` argument overrides the setting for that call only.',
+      '- List available models with `mimo models` on this machine.',
+      '',
+      'Credentials:',
+      "- Xiaomi MiMo's free API service has ENDED. The user must run `mimo auth login` (or configure a third-party API) on this machine before dispatch works.",
+      '- If a run fails with sign-in / free-API-ended errors, tell the user to log in. Do not retry in a loop.',
       '',
       'By default, dispatch runs in the background and returns a jobId immediately; collect via job_output and watch live progress via mimo_status.',
       '',
@@ -142,12 +161,6 @@ return {
       '- Follow-ups on the same topic -> mimo_continue (with latest=true or sessionId; context is preserved).',
       '- Final build/test verification of mimo output -> Native tools.',
       '- Plan / read-only analysis -> mimo_run with mode=plan.',
-      '- Desktop-native work (Desktop session UI, shared Desktop login/model) -> prefer backend=mimo-desktop (or preselect it in settings).',
-      '',
-      'Backend preselection (settings):',
-      '- Default backend is configured OUT-OF-BAND (plugin config.backend / env MIMO_BRIDGE_BACKEND / settings file).',
-      '- Per-call `backend` argument overrides the default only when necessary.',
-      '- Do NOT invent a backend every call — use the preselected default.',
       '',
       'Context protocol (one topic = one mimo session):',
       '- First dispatch on a topic: compact CONTEXT preamble (point to paths, do not paste file contents).',

package/dynamic/opencode.host.js

@@ -561,31 +561,22 @@ function createRunner(o) {
   return { coreExecute, runSync, askFallback }
 }
 
-// providers/opencode.mjs — opencode provider descriptor（第四家 CLI）。
+// providers/opencode.mjs — opencode provider descriptor（第四家 CLI，无旧包可迁）。
 //
-// 移植基线 = 本机实测的 OpenCode **V2** CLI（v2.0.29，桌面版自带二进制
-// opencode-cli.exe）+ 官方 CLI 源码 emit 全集。不是旧包（本包新增，无旧包可迁）。
-//
-// 实测事实（2026-10-15，CLI v2.0.29）：
-//   opencode run [message..]     非交互主命令；prompt 是【位置参数】（run 子命令无
-//                                --prompt；-p 是 --password，切勿当 prompt 用）
-//   --format json                NDJSON 事件流（每行一个 JSON 对象）
-//   --auto                       auto-approve 未显式拒绝的权限（不加会卡在权限提示）
-//   -m, --model provider/model   V2 支持 provider/model#variant
-//   --session <id> / --continue  会话续接（无 `opencode continue` 子命令）
-//   --agent / --title / --file / --thinking / --standalone
-//   ⚠️ V2 无 --dir（V1 有）→ cwd 只能靠 spawn 的工作目录
-//   ⚠️ V2 无 --variant（V1 有）→ variant 并入 --model 的 # 后缀
-//   退出码：0 成功 / 1 错误 / 130 SIGINT（退出码才是成败判据）
-//   事件 type（源码全集）：step_start / text / reasoning / tool_use / step_finish / error
-//   ⚠️ 不存在 result/complete/init 事件
-//   ⚠️ 文本在 part.text；统计在 step_finish.part（cost/tokens）——两者是不同事件
+// 基线 = 本机实测 OpenCode V2 CLI v2.0.29（桌面版自带 opencode-cli.exe）+ 源码 emit 全集。
+// 完整 CLI 事实表见 docs/HANDOVER.md §13；这里只留写代码时最容易踩的几条：
+//   • 非交互 = `opencode run "<prompt>"`，prompt 是【位置参数】（run 子命令无 --prompt；
+//     `-p` 是 --password）。`--format json` → NDJSON。`--auto` = 自动批准权限。
+//   • ⚠️ V2 无 --dir（cwd 靠 spawn）、无 --variant（并入 --model#variant）。
+//   • 退出码才是成败判据：0 成功 / 1 错误 / 130 SIGINT。
+//   • ⚠️ 无 result/complete/init 事件；type 全集 = step_start/text/reasoning/tool_use/
+//     step_finish/error。文本在 part.text，统计在 step_finish.part —— 两者是不同事件。
 //
 // 红线（PROVIDER-CONTRACT.md §8 + §1）：
 //  - 本文件会被 build 内联进 dynamic 沙箱（new Function）：绝不出现 import.meta 字面量；
 //    process 只经 deps 注入或 typeof 守卫读取；宿主能力全部走 deps/attach(hostOpts)。
 //  - 只允许 import '../core/bridge-kit.mjs'。
-
+// import { createStatusEngine, createRunner, clampInt, isLimited } from '../core/bridge-kit.mjs'
 function nowIso() { return new Date().toISOString() }
 
 // ── 可执行文件解析（env > 桌面版已知路径 > PATH）───────────────────────────────
@@ -771,16 +762,35 @@ function defineProvider (deps = {}) {
   let settingsRef = { binPath: '', defaultModel: '', defaultAgent: '' }
 
   /**
-   * 取当前生效的偏好设置（宿主经 hostOpts.getSettings 注入；无则退回 env/默认）。
+   * 取当前生效的偏好设置。三条来源按优先级合并，每次 buildArgv 都重新读 ——
+   * 面板改默认模型后无需重启即生效：
+   *   1) `host.getSettings('opencode')` —— preset/dynamic 形态（attach 时由宿主注入）；
+   *   2) `deps.readSettings()` —— MCP 形态（真 Node 进程，每次现读设置文件）；
+   *   3) `settingsRef` —— attach 时固化的一次性快照 / 缺省值。
+   * 三条都拿不到 → 缺省空值（= 不传 --model，交给 opencode 自身配置决定）。
+   *
+   * 历史坑：MCP 形态不 attach（自建 engine），只认 host.getSettings 会让面板设置的
+   * defaultModel 在 MCP 面对 opencode_run 完全失效 —— 只有 args.model 才落地。
+   * 三个形态行为不一致是缺陷，故此处统一把 readSettings 纳入（与 mimo 同构）。
    */
   function currentSettings() {
+    const out = Object.assign({}, settingsRef)
+    try {
+      if (typeof deps.readSettings === 'function') {
+        const r = deps.readSettings()
+        if (r && typeof r === 'object') {
+          const part = ('partition' in r || 'path' in r || 'home' in r) ? r.partition : r
+          if (part && typeof part === 'object') Object.assign(out, part)
+        }
+      }
+    } catch (e) { }
     try {
       if (host && typeof host.getSettings === 'function') {
         const s = host.getSettings('opencode')
-        if (s && typeof s === 'object') return Object.assign({}, settingsRef, s)
+        if (s && typeof s === 'object') Object.assign(out, s)
       }
     } catch (e) { }
-    return settingsRef
+    return out
   }
 
   const descriptor = {

package/home-plugin/cli-bridge-indicator/lib/index.mjs

@@ -30,7 +30,17 @@ import { settingsView, parseSettingsBody, readSettingsFile, writeSettingsFile, S
 import { declareBridgePresets } from './preset-declarations.mjs'
 
 export const PRESET_TTL_MS = 75000
+/** 运行中/仍在活动的项目的新鲜期（防抖：短暂停顿不该让灯闪）。 */
 export const PROJECT_TTL_MS = 10 * 60 * 1000
+/**
+ * 已完成（running=0 且已有 lastStatus）项目的新鲜期。
+ *
+ * 0.2.1 用单一 10 分钟 TTL 修「一次失败后灯永久挂着」—— 但 10 分钟对于「刚跑完、
+ * 想看到灯灭」来说太长：任务结束后灯要挂满 10 分钟才消失，用户感知是「灯不灭」。
+ * 区分两态：运行中（含短暂间隔）保持长 TTL 防抖；已收口的项目走短 TTL 快速淡出。
+ * 淡出只影响 pill 渲染（stale 项目仍在弹窗里作历史），不丢数据。
+ */
+export const PROJECT_DONE_TTL_MS = 60 * 1000
 export const MAX_PROJECTS = 24
 export const MAX_SESSIONS = 64
 
@@ -50,6 +60,11 @@ export function createIndicatorState(opts) {
   const now = typeof o.now === 'function' ? o.now : Date.now
   const ttlMs = o.ttlMs != null ? o.ttlMs : PRESET_TTL_MS
   const projectTtlMs = o.projectTtlMs != null ? o.projectTtlMs : PROJECT_TTL_MS
+  // doneTtlMs 缺省跟随 projectTtlMs（显式传 projectTtlMs 的测试/调用方同时支配两态，
+  // 否则「传短 TTL 却不生效」会静默坑人）；只有走生产默认值时才取更短的
+  // PROJECT_DONE_TTL_MS（已完成项目快速淡出）。
+  const doneTtlMs = o.doneTtlMs != null ? o.doneTtlMs
+    : (o.projectTtlMs != null ? projectTtlMs : PROJECT_DONE_TTL_MS)
   const staleMs = o.staleMs != null ? o.staleMs : MCP_BRIDGE_STALE_MS
   const ids = Array.isArray(o.ids) && o.ids.length ? o.ids.slice() : PROVIDER_IDS.slice()
   const listPresetSessions = typeof o.listPresetSessions === 'function' ? o.listPresetSessions : null
@@ -183,7 +198,11 @@ export function createIndicatorState(opts) {
     const isStale = (p) => {
       if (p.running > 0) return false
       const at = Number(p.updatedAt) || Number(p.lastAt) || 0
-      return !!at && (t - at) > projectTtlMs
+      if (!at) return false
+      // 已收口（有终态）的项目走短 TTL → 完成后快速淡出；
+      // 仍无终态的（长时间运行中的间隔、或从未跑完）保持长 TTL 防抖。
+      const ttl = p.lastStatus ? doneTtlMs : projectTtlMs
+      return (t - at) > ttl
     }
     // 顶层聚合只看新鲜（未 stale）项目：陈旧历史不再决定灯色（0.2.1 修复「指示灯长期
     // 存在」的服务端半边 —— 客户端半边在 pill 过滤；无新鲜项目时顶层回落 idle）。

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

@@ -67,28 +67,25 @@ export async function buildPresetDefinition(id) {
 }
 
 /**
- * 在 indicator 的 ctx 上挂「agentPresets 就绪 → 注册三个 preset」等待器。
+ * 在 indicator 的 ctx 上挂「agentPresets 就绪 → 注册启用面的 preset」等待器。
  * 返回每个 provider 的注册状态数组（诊断用）；任何异常都不外抛。
  *
- * 调度语义（0.2.0）：三个 preset 恒常注册（可读性/可回退优先 —— 禁用≠从目录消失，
- * 用户随时可切进禁用 preset 排查），注册【顺序】按 priority 排列；真正的「不启用」
- * 发生在桥接插件 apply()：读 _scheduling，禁用面不注册任何工具/政策段（安全且即时，
- * 改设置只影响下次会话，无需重新注册表）。opts.ids 显式传入时跳过调度排序。
+ * 调度语义（0.2.5 起按 enabled 过滤注册，用户定案）：
+ *   只注册**启用面**的 preset —— 未启用的 provider 不出现在预设目录里。
+ *   0.2.0 曾是「恒常注册、禁用只影响 apply()」，但用户明确要求：停用的 CLI 不该在
+ *   预设列表里占位（选中它等于立刻撞到一个零注册的桥，纯噪音）。
+ *   代价：停用后旧会话头若仍指向该 preset，进入该会话会找不到预设 —— 这是停用的
+ *   应有语义；重新启用即恢复（注册表在宿主启动时重建）。
+ *   opts.ids 显式传入时跳过调度过滤与排序（测试/手工可控）。
  */
 export function declareBridgePresets(ctx, opts) {
   let ids = (opts && opts.ids) || PROVIDER_IDS_FALLBACK
   if (!opts || !opts.ids) {
     try {
       const sched = resolveScheduling(PROVIDER_IDS_FALLBACK, opts && opts.io)
-      // 顺序 = 启用项（order = priority ∩ enabled）在前，禁用项按 priority 顺序补尾。
-      // UI 卡片序 / preset 目录序 / MCP 工具序三处因此永远一致（priority 是总轴，
-      // enabled 只决定 apply() 里注不注册工具，不决定它排在哪儿）。
-      const tail = sched.priority.filter((x) => sched.order.indexOf(x) < 0)
-      const ordered = sched.order.slice()
-      for (const id of tail) ordered.push(id)
-      for (const id of PROVIDER_IDS_FALLBACK) if (ordered.indexOf(id) < 0) ordered.push(id)
-      ids = ordered
-    } catch (e) { /* 调度不可得 = 缺省顺序，注册不受影响 */ }
+      // 只取 order（= priority ∩ enabled），不再补禁用项到尾部。
+      ids = sched.order.slice()
+    } catch (e) { /* 调度不可得 = 缺省全量注册，绝不因读不到配置而清空预设 */ }
   }
   const out = []
   if (typeof ctx.inject !== 'function') return out

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.3'
+const SERVER_VERSION = '0.2.5'
 const PROTOCOL = '2024-11-05'
 
 const PROVIDERS = [agyMcp, codebuddyMcp, mimoMcp, opencodeMcp]

package/mcp/providers/agy.mjs

@@ -18,8 +18,9 @@ import { fileURLToPath } from 'node:url'
 
 import defineProvider from '../../providers/agy.mjs'
 import { createStatusEngine, createLineStream, buildMcpBridgePayload, isLimited, renderStatus } from '../../core/bridge-kit.mjs'
+import { packageVersion } from '../version.mjs'
 
-export const meta = { id: 'agy', label: 'AGY', version: '0.2.2' }
+export const meta = { id: 'agy', label: 'AGY', version: packageVersion() }
 
 const QUOTA_SCRIPT_DEFAULT = fileURLToPath(new URL('../../bin/agy-quota.mjs', import.meta.url))