@bolloon/bolloon-agent 0.5.0 → 0.5.2

package/dist/web/mobile.js

@@ -225,6 +225,68 @@
     }
   }
 
+  // ── Efficode 条目 (内置参考实现: 仓内 src/efficode/**, 不靠"从电脑端同步") ──────
+  // 纪律: 这段**不用 innerHTML 拼任何数据** (纯 createElement + textContent) ·
+  //       双语走 data-zh/data-en (切语言时外面那段 applyLang 会一起改文字节点) ·
+  //       role=button + tabindex + aria-label + Enter/Space 可达 · 无外部依赖。
+  const EFFICODE_SPEC_PATH = 'docs/wiki/efficode.md';
+  const EFFICODE_IMPL_PATH = 'src/efficode/** · src/agents/agent-lang.ts';
+  const EFFICODE_GATE = 'scripts/verify-efficode.ts (55/0)';
+  function effiLangNow() {
+    try { return localStorage.getItem('bolloon_lang') === 'en' ? 'en' : 'zh'; } catch (e) { return 'zh'; }
+  }
+  function buildEfficodeEntry() {
+    const el = document.createElement('div');
+    el.className = 'conv-item';
+    el.id = 'item-efficode';
+    el.setAttribute('role', 'button');
+    el.setAttribute('tabindex', '0');
+    el.setAttribute('aria-label', 'Efficode 规范页 (中文): ' + EFFICODE_SPEC_PATH);
+    const avatar = document.createElement('div');
+    avatar.className = 'conv-avatar';
+    avatar.textContent = 'E';
+    const body = document.createElement('div');
+    body.className = 'conv-body';
+    const name = document.createElement('div');
+    name.className = 'conv-name';
+    name.textContent = '/efficode';
+    const desc = document.createElement('div');
+    desc.className = 'conv-preview';
+    desc.setAttribute('data-zh', '智能体间的符号化交流语言 · 参考实现 (签名/声波未实现) — 点开看规范页 docs/wiki/efficode.md');
+    desc.setAttribute('data-en', 'Symbolic agent-to-agent language · reference impl (signing/audio not implemented) — tap for docs/wiki/efficode.md');
+    desc.textContent = effiLangNow() === 'en' ? desc.getAttribute('data-en') : desc.getAttribute('data-zh');
+    body.appendChild(name);
+    body.appendChild(desc);
+    el.appendChild(avatar);
+    el.appendChild(body);
+    const open = () => alert(
+      '/efficode\n\n' +
+      (effiLangNow() === 'en'
+        ? 'Symbolic binary language between agents (Efficient + Code). Reference implementation in this repo; negotiation falls back to natural language unless both sides declare efficode. Signing / ECC session keys / sound-wave mode are NOT implemented.\n\n'
+        : '智能体之间的符号化二进制交流语言 (Efficient + Code)。本仓有参考实现; 只有双方都声明 efficode 才用, 否则明确回落自然语言。签名验证 / ECC 临时会话密钥 / 声波模式尚未实现。\n\n') +
+      '规范页: ' + EFFICODE_SPEC_PATH + '\n' +
+      '实现: ' + EFFICODE_IMPL_PATH + '\n' +
+      '验收门: ' + EFFICODE_GATE
+    );
+    el.addEventListener('click', open);
+    el.addEventListener('keydown', (ev) => {
+      if (ev.key === 'Enter' || ev.key === ' ' || ev.key === 'Spacebar') { ev.preventDefault(); open(); }
+    });
+    return el;
+  }
+
+  /** 把内置 Efficode 条目追加到 Skills 页 (空态 / 有列表都显示 —— 它是仓内参考实现) */
+  function appendEfficodeBlock(body) {
+    if (!body || body.querySelector('#item-efficode')) return;
+    const cap = document.createElement('div');
+    cap.style.cssText = 'font-size:11px;color:var(--text-muted);margin:14px 0 6px';
+    cap.setAttribute('data-zh', '内置 (随客户端发布, 不来自电脑端同步)');
+    cap.setAttribute('data-en', 'Built in (ships with the client, not synced from desktop)');
+    cap.textContent = effiLangNow() === 'en' ? cap.getAttribute('data-en') : cap.getAttribute('data-zh');
+    body.appendChild(cap);
+    body.appendChild(buildEfficodeEntry());
+  }
+
   async function openSkillsPage() {
     if ($('#skills-page')) return;
     const page = mkOverlayPage('skills-page', 'Skills', '<div style="font-size:12px;color:var(--text-muted)">读取中…</div>');
@@ -241,6 +303,7 @@
         body.innerHTML = `<div style="padding:18px 8px;text-align:center;color:var(--text-muted);line-height:1.8">
           还没有技能列表<br><span style="font-size:12px">电脑端 ~/.bolloon/skills/ 下的 skills，会在「从电脑端同步」后出现在这里</span>
           ${err ? `<div style="font-size:11px;margin-top:8px">（读取失败：${escapeHtml(err)}）</div>` : ''}</div>`;
+        appendEfficodeBlock(body);
         return;
       }
       body.innerHTML = skills.map((s, i) => `<div class="conv-item" data-sk="${i}">
@@ -252,6 +315,7 @@
         const s = skills[Number(el.dataset.sk)] || {};
         alert(`/${s.name || ''}\n\n${s.description || '（无说明）'}`);
       }));
+      appendEfficodeBlock(body);
     };
     await render();
     const btn = page.querySelector('#skills-sync');
@@ -1697,6 +1761,110 @@
     return r;
   }
 
+  /**
+   * 「App 更新 (web 资源层)」页 (2026-09-26, update-protocol §13)
+   *   看得见的: 当前装的是哪个源 / 哪个版本·sha / 能切回哪个源 —— 与桌面 `bolloon update --status` 同一口径。
+   *   做得出的: 检查 → (智能体可自动跑到"准备并验证") → 人工确认切换 → 重载; 一键回滚。
+   *   说不出的不说: 原生壳层不能在这里自更 (iOS 走商店/TestFlight, Android 侧载需允许未知来源)。
+   */
+  async function openUpdatePage() {
+    const page = document.createElement('div');
+    page.className = 'chat-page';
+    page.id = 'update-page';
+    page.innerHTML = `
+      <div class="chat-topbar">
+        <button class="icon-btn" id="update-back">←</button>
+        <div style="flex:1;font-weight:600">App 更新</div>
+        <button class="icon-btn" id="update-check" title="检查更新">↻</button>
+      </div>
+      <div style="padding:12px;overflow:auto">
+        <pre id="update-identity" style="white-space:pre-wrap;word-break:break-all;font-size:12px;line-height:1.6;background:var(--bg-2,#0001);padding:10px;border-radius:10px;margin:0 0 10px">读取中…</pre>
+        <div style="display:flex;gap:8px;margin-bottom:10px">
+          <button class="conv-item" id="update-ch-stable" style="flex:1;justify-content:center">stable (npm)</button>
+          <button class="conv-item" id="update-ch-dev" style="flex:1;justify-content:center">dev (GitHub master)</button>
+        </div>
+        <div class="conv-item" id="update-apply"><span class="list-icon">${ICONS.chip}</span><span style="flex:1;min-width:0"><span style="display:block">安装更新（需要你确认）</span><span class="conv-preview" style="display:block" id="update-apply-sub">先点右上角 ↻ 检查</span></span><span class="list-arrow">›</span></div>
+        <div class="conv-item" id="update-rollback"><span class="list-icon">${ICONS.trash}</span><span style="flex:1;min-width:0"><span style="display:block">回滚到上一份</span><span class="conv-preview" style="display:block">装坏了就换回上一次能用的资源</span></span><span class="list-arrow">›</span></div>
+        <div class="conv-item" id="update-reload"><span class="list-icon">${ICONS.themeAuto}</span><span>重载界面让更新生效</span></div>
+        <div id="update-ceiling" style="font-size:12px;line-height:1.6;color:var(--fg-2,#888);margin:10px 0"></div>
+        <pre id="update-log" style="white-space:pre-wrap;word-break:break-all;font-size:12px;line-height:1.6;margin:0"></pre>
+      </div>`;
+    document.body.appendChild(page);
+
+    const identityEl = page.querySelector('#update-identity');
+    const logEl = page.querySelector('#update-log');
+    const applySub = page.querySelector('#update-apply-sub');
+    const ceilingEl = page.querySelector('#update-ceiling');
+    let lastCheck = null;
+
+    const log = (line) => { logEl.textContent += `${line}\n`; logEl.scrollTop = logEl.scrollHeight; };
+    const UP = () => (window.BolloonCore && window.BolloonCore.update) || null;
+    const setIdentity = async () => {
+      const up = UP();
+      if (!up) { identityEl.textContent = '内核未就绪'; return; }
+      const voc = up.vocabulary();
+      ceilingEl.textContent = voc.nativeCeiling;
+      const st = await up.state();
+      const applied = st.installedChannel ? `${st.installedChannel}${st.installedDevSha ? ` @ ${st.installedDevSha}` : ''}` : '（还没用这个功能装过）';
+      identityEl.textContent = [
+        `当前装的:   ${applied}`,
+        `通道偏好:   ${up.channel()}`,
+        `能切回:     ${st.switchableTo ? `${st.switchableTo.channel} (${st.switchableTo.source}${st.switchableTo.target ? ` @ ${st.switchableTo.target}` : ''})` : '—'}`,
+        `上次来源:   ${st.installedFrom ? `${st.installedFrom.source}${st.installedFrom.digest ? ` · ${st.installedFrom.digest}` : ''}` : '—'}`,
+        `更新层:     web 资源层（界面与逻辑：入群 / 发任务公告 / 看飞轮进度 / 授权签名）`,
+        `会生效吗:   ${up.nativeWired() ? '会（原生壳已指向可写目录）' : '不会 —— 原生壳还没指向可写目录，装了也不生效，所以不会切换'}`,
+      ].join('\n');
+    };
+    const runCheck = async () => {
+      const up = UP();
+      if (!up) { log('内核未就绪'); return; }
+      log('· 检查两源（npm + GitHub）…');
+      const r = await up.report({});
+      lastCheck = r.result;
+      identityEl.textContent = r.lines.join('\n');
+      applySub.textContent = r.result.status === 'update_available'
+        ? `可装: ${r.result.targetIdentity || r.result.latestVersion}` : `结论: ${r.result.status}`;
+      log(`· 结论: ${r.result.status}${r.result.reason ? ` — ${r.result.reason}` : ''}`);
+      if (r.result.warnings && r.result.warnings.length) r.result.warnings.forEach((w) => log(`  ⚠ ${w}`));
+      await setIdentity();
+    };
+
+    page.querySelector('#update-back').addEventListener('click', () => { page.remove(); void openSettings(); });
+    page.querySelector('#update-check').addEventListener('click', () => { logEl.textContent = ''; void runCheck(); });
+    page.querySelector('#update-ch-stable').addEventListener('click', async () => { const r = await UP().setChannel('stable'); log(`· ${r.detail}`); await setIdentity(); });
+    page.querySelector('#update-ch-dev').addEventListener('click', async () => { const r = await UP().setChannel('dev'); log(`· ${r.detail}`); await setIdentity(); });
+    page.querySelector('#update-apply').addEventListener('click', async () => {
+      const up = UP();
+      if (!up) return;
+      const target = lastCheck && (lastCheck.targetIdentity || lastCheck.latestVersion);
+      if (!lastCheck || lastCheck.status !== 'update_available') { log('· 先检查更新（右上角 ↻）：现在没有可装的目标，或源不可达/交叉校验不一致 —— 拒绝安装。'); return; }
+      // 人在环: 说清要换的是哪一层, 再动手
+      if (!confirm(`要装 ${target} 吗？\n\n换的是「web 资源层」（界面与逻辑）。装完需要重载界面才生效；装坏了可以一键回滚。\n原生壳层（二进制）不在这里更新。`)) return;
+      log('· 准备并验证 …');
+      const prep = await up.prepare({ onStage: (s, d) => log(`    [${s}] ${d}`) });
+      if (!prep.ok) { log(`· 准备/验证失败: ${prep.status} — ${prep.reason}`); return; }
+      log(`· 已验证 ${prep.to}（${prep.fileCount} 个文件）—— 现在切换`);
+      const out = await up.apply({ confirm: true, reuseStaging: true, onStage: (s, d) => log(`    [${s}] ${d}`) });
+      log(out.ok ? `· 成功: ${out.from} → ${out.to}（重载界面后生效）` : `· 未生效 (${out.stage}): ${out.reason}`);
+      applySub.textContent = out.ok ? '已装好 · 点「重载界面」生效' : `未生效: ${out.status}`;
+      await setIdentity();
+    });
+    page.querySelector('#update-rollback').addEventListener('click', async () => {
+      const up = UP();
+      if (!up) return;
+      if (!confirm('换回上一份能用的 web 资源吗？（当前这一份会被替换掉）')) return;
+      const out = await up.rollback({ confirm: true, onStage: (s, d) => log(`    [${s}] ${d}`) });
+      log(out.ok ? `· 已回滚到 ${out.to}` : `· 回滚未执行 (${out.stage}): ${out.reason}`);
+      await setIdentity();
+    });
+    page.querySelector('#update-reload').addEventListener('click', async () => {
+      const r = await UP().reload();
+      log(`· ${r.detail}（方式: ${r.how}）`);
+    });
+
+    await setIdentity();
+  }
+
   function openSettings() {
     const page = document.createElement('div');
     page.className = 'chat-page';
@@ -1709,6 +1877,7 @@
       <div style="padding:12px">
         <div class="conv-item" id="api-config-item"><span class="list-icon">${ICONS.chip}</span><span>API 配置</span><span class="list-arrow">›</span></div>
         <div class="conv-item" id="theme-toggle"><span class="list-icon" id="theme-icon">${ICONS.themeAuto}</span><span id="theme-text">跟随系统</span></div>
+        <div class="conv-item" id="settings-update"><span class="list-icon">${ICONS.themeAuto}</span><span style="flex:1;min-width:0"><span style="display:block">App 更新（web 资源层）</span><span class="conv-preview" style="display:block" id="update-preview">读取中…</span></span><span class="list-arrow">›</span></div>
         <div class="conv-item" id="settings-data"><span class="list-icon">${ICONS.chip}</span><span style="flex:1;min-width:0"><span style="display:block">本机数据</span><span class="conv-preview" style="display:block">读取中…</span></span><span class="list-arrow">›</span></div>
         <div class="conv-item" id="settings-desktop"><span class="list-icon">${ICONS.globe}</span><span>电脑端同步</span><span class="list-arrow">›</span></div>
         <div class="conv-item" id="settings-chain"><span class="list-icon">${ICONS.chip}</span><span>链上配置 (RPC/网络)</span><span class="list-arrow">›</span></div>
@@ -1725,6 +1894,22 @@
     applyTheme(resolveThemePref(), false);
     $('#settings-back').addEventListener('click', () => page.remove());
     $('#api-config-item').addEventListener('click', openApiConfig);
+    // App 更新: 预览里就说清"现在装的是哪个源 / 哪个版本·sha / 能切回谁"(= 桌面 update --status 同一口径)
+    $('#settings-update').addEventListener('click', () => { page.remove(); void openUpdatePage(); });
+    void (async () => {
+      const el = page.querySelector('#update-preview');
+      if (!el) return;
+      try {
+        const up = window.BolloonCore && window.BolloonCore.update;
+        if (!up) { el.textContent = '内核未就绪'; return; }
+        const st = await up.state();
+        const applied = st.installedChannel
+          ? `${st.installedChannel}${st.installedDevSha ? ` @ ${st.installedDevSha}` : ''}`
+          : '内置资源';
+        const back = st.switchableTo ? ` · 能切回 ${st.switchableTo.channel}` : '';
+        el.textContent = `当前 ${applied}${back} · 通道 ${up.channel()}${up.nativeWired() ? '' : ' · 原生壳未接通'}`;
+      } catch (e) { el.textContent = '读取失败: ' + ((e && e.message) || e); }
+    })();
     $('#theme-toggle').addEventListener('click', () => {
       const next = currentTheme === 'auto' ? 'light' : (currentTheme === 'light' ? 'dark' : 'auto');
       applyTheme(next, true);
@@ -1827,9 +2012,28 @@
     $('#settings-did').addEventListener('click', () => { api.get('/api/auth/status').then((s) => alert('DID: ' + (s.did || '未生成'))); });
   }
 
-  // === API 配置 (LLM 供应商) ===
-  // 注意: 手机端 RemoteLlm 走 OpenAI 兼容协议 (baseUrl + /chat/completions) —— 新增 provider 必须是
-  // OpenAI 兼容端点 (gemini 用 /v1beta/openai, 智谱 v4 / dashscope compatible-mode 都兼容)。
+  // === 模型配置 (供应商 / 模型 / 地址) ===
+  //
+  // 2026-09-26 (模型链路升级 P6 的手机侧): 这一页**只显示与触发**, 自己不算配置 ——
+  // 唯一事实来自桌面端的模型端点 (与 CLI `/model` / Web 桌面页**同一份**):
+  //
+  //   当前真实生效   GET  /api/models/providers             → body.effective
+  //                       (provider · model · baseUrl · scope · configHash)
+  //   目录 + 来源    GET  /api/models/options?provider=<id> → body.catalog.origin
+  //                       (live | cached | curated | custom | unavailable)
+  //   刷新发现       POST /api/models/discover {action:'refresh', provider}
+  //   手输模型       POST /api/models/discover {action:'admit',   provider, model}
+  //
+  // 纪律: **不回读 /api/llm-config 自己拼 activeProvider/providers 来显示"生效配置"** —— 那是
+  //   第二套读配置逻辑, 与服务端早晚漂移。下面 `localCfg` 只喂"编辑表单"和"保存"(写路径),
+  //   展示层一个字都不从它取; 拿不到桌面端就如实说"显示不了", 不猜不编。
+  //
+  // 注意: 手机端 RemoteLlm 走 OpenAI 兼容协议 (baseUrl + /chat/completions) —— 自定义 provider
+  // 必须是 OpenAI 兼容端点 (gemini 用 /v1beta/openai, 智谱 v4 / dashscope compatible-mode 都兼容)。
+  const ORIGIN_LABEL = {
+    live: '实时发现 (live)', cached: '缓存发现 (cached)', curated: '内置清单 (curated)',
+    custom: '自定义 (custom)', unavailable: '不可用 (unavailable)',
+  };
   const LLM_PROVIDERS = [
     { id: 'deepseek', label: 'DeepSeek', baseUrl: 'https://api.deepseek.com/v1', model: 'deepseek-chat' },
     { id: 'openai', label: 'OpenAI', baseUrl: 'https://api.openai.com/v1', model: 'gpt-4o-mini' },
@@ -1847,43 +2051,155 @@
     { id: 'custom', label: '自定义', baseUrl: '', model: '' },
   ];
   const LLM_BY_ID = LLM_PROVIDERS.reduce((m, p) => (m[p.id] = p, m), {});
+
+  /** configHash 只显示前 8 位 (完整值在桌面端 / Run 快照里, 手机屏不需要 64 位) */
+  function shortConfigHash(h) {
+    const s = String(h == null ? '' : h);
+    return s ? s.slice(0, 8) : '—';
+  }
+
+  /** 目录来源标记 → 人话 (认不出来就原样回显, 不编) */
+  function originLabel(origin) {
+    const k = String(origin || '');
+    return ORIGIN_LABEL[k] || (k ? k : '—');
+  }
+
+  /** 电脑端基址 (设置里填; 手机自足模式拿不到就如实说, 不假装成功) */
+  async function modelApiGet(path) {
+    const base = await desktopBaseUrl();
+    if (!base) return { ok: false, error: '未接电脑端 —— 设置 → 电脑端同步 里填桌面地址后可看' };
+    const r = await desktopFetch(path);
+    if (r === null) return { ok: false, error: '电脑端不可达或返回非 200' };
+    return { ok: true, data: r };
+  }
+  async function modelApiPost(path, body) {
+    const base = await desktopBaseUrl();
+    if (!base) return { ok: false, error: '未接电脑端 —— 设置 → 电脑端同步 里填桌面地址后可看' };
+    return await desktopPostRaw(path, body);       // 保留后端错误原文
+  }
+
   async function openApiConfig() {
-    let cfg;
-    try { cfg = await api.get('/api/llm-config'); } catch { cfg = null; }
-    if (!cfg || !cfg.providers) cfg = { activeProvider: 'deepseek', providers: {}, updatedAt: Date.now() };
     const page = document.createElement('div');
     page.className = 'chat-page';
     page.id = 'api-config-page';
-    const provider = cfg.activeProvider || 'deepseek';
-    const pc = cfg.providers?.[provider] || {};
+    // 编辑表单的本地草稿 (写路径) —— 展示层不读它
+    let localCfg = null;
+    try { localCfg = await api.get('/api/llm-config'); } catch (e) { localCfg = null; }
+    if (!localCfg || !localCfg.providers) localCfg = { activeProvider: 'deepseek', providers: {}, updatedAt: Date.now() };
+    const _in = 'width:100%;padding:10px;border:1px solid var(--border);border-radius:8px;background:var(--bg-hover);color:var(--text);box-sizing:border-box';
+    const _btn = 'padding:10px 14px;border:1px solid var(--border);border-radius:8px;background:var(--bg-hover);color:var(--text)';
     page.innerHTML = `
       <div class="chat-topbar">
         <button class="icon-btn" id="api-config-back">←</button>
-        <div style="flex:1;font-weight:600">API 配置</div>
+        <div style="flex:1;font-weight:600">模型配置</div>
       </div>
-      <div style="padding:12px;display:flex;flex-direction:column;gap:12px">
-        <label style="font-size:13px;color:var(--text-secondary)">供应商 <span id="api-provider-count" style="opacity:.55"></span></label>
-        <div class="provider-chips" id="api-provider-chips">
-          ${LLM_PROVIDERS.map((p) => `<button type="button" class="provider-chip${p.id === provider ? ' active' : ''}" data-provider="${p.id}">${p.label}</button>`).join('')}
+      <div style="padding:12px;display:flex;flex-direction:column;gap:12px;overflow:auto">
+        <div class="section-label">当前真实生效 (电脑端 /api/models/providers)</div>
+        <div id="api-eff-card" style="padding:12px;border:1px solid var(--border);border-radius:10px;background:var(--bg-card);display:flex;flex-direction:column;gap:6px">
+          <div style="font-size:13px">供应商: <b id="api-eff-provider">读取中…</b></div>
+          <div style="font-size:13px">模型: <b id="api-eff-model">—</b></div>
+          <div style="font-size:12px;color:var(--text-secondary);word-break:break-all">地址: <span id="api-eff-baseurl">—</span></div>
+          <div style="font-size:12px;color:var(--text-secondary)">来源(scope): <span id="api-eff-scope">—</span> · 配置指纹: <span id="api-eff-hash">—</span></div>
+          <div id="api-eff-note" style="font-size:12px;color:var(--text-muted)"></div>
+        </div>
+
+        <div class="section-label">模型目录 (电脑端 /api/models/options)</div>
+        <div id="api-catalog-origin" style="font-size:13px">—</div>
+        <div id="api-catalog-head" style="font-size:12px;color:var(--text-secondary)"></div>
+        <div id="api-catalog-list" style="font-size:12px;color:var(--text-secondary);max-height:170px;overflow:auto;word-break:break-all"></div>
+        <div id="api-catalog-note" style="font-size:12px;color:var(--text-muted)"></div>
+        <button id="api-discover-refresh" style="${_btn}">刷新发现</button>
+        <div style="display:flex;gap:8px">
+          <input id="api-manual-model" placeholder="手输模型名 (目录里没有的)" style="flex:1;${_in}">
+          <button id="api-manual-admit" style="${_btn}">加入目录</button>
         </div>
+        <div id="api-discover-result" style="font-size:12px;color:var(--text-secondary)"></div>
+
+        <div class="section-label">供应商 / 端点 / 凭据 (本机保存) <span id="api-provider-count" style="opacity:.55"></span></div>
+        <div class="provider-chips" id="api-provider-chips"></div>
         <div id="api-hint" style="font-size:12px;color:var(--text-muted)"></div>
-        <label style="font-size:13px;color:var(--text-secondary)">Base URL</label>
-        <input id="api-baseurl" placeholder="https://api.xxx.com/v1" value="${escapeHtml(pc.baseUrl || '')}" style="padding:10px;border:1px solid var(--border);border-radius:8px;background:var(--bg-hover);color:var(--text)">
-        <label style="font-size:13px;color:var(--text-secondary)">API Key</label>
-        <input id="api-key" type="password" placeholder="sk-..." value="${escapeHtml(pc.apiKey || '')}" style="padding:10px;border:1px solid var(--border);border-radius:8px;background:var(--bg-hover);color:var(--text)">
-        <label style="font-size:13px;color:var(--text-secondary)">模型</label>
-        <input id="api-model" placeholder="模型名" value="${escapeHtml(pc.model || '')}" style="padding:10px;border:1px solid var(--border);border-radius:8px;background:var(--bg-hover);color:var(--text)">
+        <input id="api-baseurl" placeholder="https://api.xxx.com/v1" style="${_in}">
+        <input id="api-key" type="password" placeholder="sk-..." style="${_in}">
+        <input id="api-model" placeholder="模型名" style="${_in}">
         <button id="api-save" style="padding:12px;border:none;border-radius:10px;background:var(--accent);color:var(--bg);font-weight:700">保存配置</button>
       </div>`;
     document.body.appendChild(page);
     $('#api-config-back').addEventListener('click', () => page.remove());
-    // 供应商选择: 芯片式 (原来是一个原生 select, 小屏上难点、也看不出有哪些可选)
-    let picked = LLM_BY_ID[provider] ? provider : 'deepseek';
-    const fillFrom = (id) => {
-      const saved = (cfg.providers && cfg.providers[id]) || {};
+    const setText = (sel, v) => { const el = page.querySelector(sel); if (el) el.textContent = String(v == null ? '' : v); };
+
+    // ── ① 当前真实生效: 只认服务端 effective ──────────────────────────
+    let lastProviders = null;
+    async function paintEffective() {
+      const r = await modelApiGet('/api/models/providers');
+      if (!r.ok) {
+        setText('#api-eff-provider', '—'); setText('#api-eff-model', '—');
+        setText('#api-eff-baseurl', '—'); setText('#api-eff-scope', '—'); setText('#api-eff-hash', '—');
+        setText('#api-eff-note', '读不到生效配置: ' + r.error);
+        return null;
+      }
+      const eff = r.data && r.data.effective;
+      if (!eff) {
+        setText('#api-eff-note', '电脑端没给出 effective (不猜: 不显示任何默认值)');
+        return r.data;
+      }
+      setText('#api-eff-provider', eff.provider);
+      setText('#api-eff-model', eff.model || '—');
+      setText('#api-eff-baseurl', eff.baseUrl || '—');
+      setText('#api-eff-scope', eff.scope || eff.source || '—');
+      setText('#api-eff-hash', shortConfigHash(eff.configHash));
+      setText('#api-eff-note', '协议 ' + (eff.protocol || '?') + ' · 凭据 ' + (eff.authRef || 'none')
+        + ' · 指纹前 8 位 (完整值见电脑端 Run 快照)');
+      return r.data;
+    }
+
+    // ── ② 目录 + 来源标记 ────────────────────────────────────────────
+    let picked = (localCfg.activeProvider && LLM_BY_ID[localCfg.activeProvider]) ? localCfg.activeProvider : 'deepseek';
+    async function paintCatalog() {
+      setText('#api-catalog-origin', '来源: 读取中…');
+      setText('#api-catalog-head', ''); setText('#api-catalog-list', ''); setText('#api-catalog-note', '');
+      const r = await modelApiGet('/api/models/options?provider=' + encodeURIComponent(picked));
+      if (!r.ok) { setText('#api-catalog-origin', '来源: —'); setText('#api-catalog-note', '读不到目录: ' + r.error); return; }
+      const d = r.data || {};
+      const cat = d.catalog || null;
+      setText('#api-catalog-origin', '来源: ' + originLabel(cat && cat.origin));
+      const models = Array.isArray(d.models) ? d.models : [];
+      setText('#api-catalog-head', String(d.count == null ? models.length : d.count) + ' 个模型'
+        + (cat && cat.stale ? ' · 缓存已过期' : '')
+        + (cat && cat.discoveryFailed ? ' · 上游发现失败' : ''));
+      const listEl = page.querySelector('#api-catalog-list');
+      if (listEl) {
+        listEl.innerHTML = models.slice(0, 40).map((m) => {
+          const id = escapeHtml(String((m && (m.id || m.name)) || ''));
+          const tool = (m && m.toolCalling) ? ' · 工具调用 ' + escapeHtml(String(m.toolCalling)) : '';
+          return '<div>' + id + tool + '</div>';
+        }).join('') || '(空目录)';
+      }
+      if (cat && cat.failure) {
+        const f = cat.failure;
+        setText('#api-catalog-note', '上游失败类目: ' + String(f.failureClass || f.class || f.message || JSON.stringify(f)).slice(0, 160));
+      }
+    }
+
+    // ── ③ 供应商芯片 (名字/可用性来自服务端 providers, 不是本机硬编码表) ──
+    function paintChips() {
+      const box = page.querySelector('#api-provider-chips');
+      if (!box) return;
+      const rows = (lastProviders && Array.isArray(lastProviders.providers) && lastProviders.providers.length)
+        ? lastProviders.providers.map((p) => ({ id: String(p.id), label: String(p.name || p.id), configured: p.configured !== false, current: p.current === true, isLocal: p.isLocal === true }))
+        : LLM_PROVIDERS;
+      box.innerHTML = rows.map((p) => `<button type="button" class="provider-chip${p.id === picked ? ' active' : ''}" data-provider="${escapeHtml(p.id)}">${escapeHtml(p.label)}</button>`).join('');
+      const cn = page.querySelector('#api-provider-count');
+      if (cn) {
+        const ready = rows.filter((p) => p.configured !== false).length;
+        cn.textContent = '（' + ready + ' / ' + rows.length + ' 家可用凭据就绪）';
+      }
+    }
+    function fillFrom(id) {
+      const saved = (localCfg.providers && localCfg.providers[id]) || {};
       const d = LLM_BY_ID[id] || {};
-      $('#api-baseurl').value = saved.baseUrl || d.baseUrl || '';
-      $('#api-model').value = saved.model || d.model || '';
+      const row = lastProviders && Array.isArray(lastProviders.providers) ? lastProviders.providers.find((x) => String(x.id) === String(id)) : null;
+      $('#api-baseurl').value = saved.baseUrl || (row && row.baseUrl) || d.baseUrl || '';
+      $('#api-model').value = saved.model || (row && row.configuredModel) || d.model || '';
       $('#api-key').value = saved.apiKey || '';
       const hint = $('#api-hint');
       if (hint) {
@@ -1892,23 +2208,37 @@
           : (saved.apiKey ? '该供应商已保存过 key（改完记得再点保存）'
                           : '填官方文档里的 API key; 保存后本机智能体就走它');
       }
-    };
-    const paintChips = () => {
-      $$('#api-provider-chips .provider-chip').forEach((c) => c.classList.toggle('active', c.dataset.provider === picked));
-    };
-    const configured = Object.keys(cfg.providers || {}).filter((k) => cfg.providers[k] && cfg.providers[k].apiKey);
-    $('#api-provider-count').textContent = configured.length ? `（已配 ${configured.length} 个: ${configured.join(' / ')}）` : '';
-    $('#api-provider-chips').addEventListener('click', (e) => {
+    }
+    page.querySelector('#api-provider-chips').addEventListener('click', (e) => {
       const b = e.target.closest && e.target.closest('.provider-chip');
       if (!b) return;
       picked = b.dataset.provider;
       paintChips();
       fillFrom(picked);
+      void paintCatalog();
     });
-    fillFrom(picked);
+
+    // ── ④ 刷新发现 / ⑤ 手输模型 (都打在服务端唯一入口上) ─────────────
+    page.querySelector('#api-discover-refresh').addEventListener('click', async () => {
+      setText('#api-discover-result', '刷新中…');
+      const r = await modelApiPost('/api/models/discover', { action: 'refresh', provider: picked, force: true });
+      if (r && r.ok === false) { setText('#api-discover-result', '刷新失败: ' + String(r.error || r.message || '').slice(0, 200)); return; }
+      setText('#api-discover-result', '刷新完成 · 来源 ' + originLabel(r && r.catalog && r.catalog.origin));
+      await paintCatalog();
+    });
+    page.querySelector('#api-manual-admit').addEventListener('click', async () => {
+      const model = String($('#api-manual-model').value || '').trim();
+      if (!model) { setText('#api-discover-result', '先填一个模型名'); return; }
+      const r = await modelApiPost('/api/models/discover', { action: 'admit', provider: picked, model });
+      if (r && r.ok === false) { setText('#api-discover-result', '加入失败: ' + String(r.error || r.message || '').slice(0, 200)); return; }
+      setText('#api-discover-result', '已加入目录: ' + model);
+      await paintCatalog();
+    });
+
+    // ── ⑥ 编辑表单保存 (写路径, 与从前同一口) ─────────────────────────
     $('#api-save').addEventListener('click', async () => {
       const p = picked;
-      const next = (cfg && cfg.providers) ? cfg : { activeProvider: cfg.activeProvider, providers: {}, updatedAt: Date.now() };
+      const next = (localCfg && localCfg.providers) ? localCfg : { activeProvider: localCfg.activeProvider, providers: {}, updatedAt: Date.now() };
       next.activeProvider = p;
       next.providers[p] = Object.assign({}, (next.providers[p] || {}), {
         enabled: true, apiKey: $('#api-key').value.trim(), baseUrl: $('#api-baseurl').value.trim(),
@@ -1920,6 +2250,12 @@
         page.remove();
       } catch (e) { alert('保存失败: ' + (e.message || e)); }
     });
+
+    // 启动: 先画芯片(服务端清单) → 再画生效卡片与目录
+    lastProviders = await paintEffective();
+    paintChips();
+    fillFrom(picked);
+    await paintCatalog();
   }
 
   // === 加密钱包 (只读 MVP) ===
@@ -3693,7 +4029,8 @@
   if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', bindEvents);
   else bindEvents();
 
-  // 供验收脚本驱动 (真 headless DOM 用): 只暴露行为入口, 不暴露数据
+  // 供验收脚本/壳层驱动 (真 headless DOM 用): 只暴露行为入口, 不暴露数据
+  window.__mobileUpdateUi = { open: () => openUpdatePage(), openSettings: () => openSettings() };
   window.__mobileTasksUi = {
     refresh: refreshAll, askJoin: askJoin, askCreate: askCreate, askPublish: askPublish,
     askTrail: askTrail, askAnnounceToGroup: askAnnounceToGroup, confirm: doConfirmed,