@bolloon/bolloon-agent 0.4.33 → 0.5.1

package/dist/ios/mobile.js

@@ -69,7 +69,7 @@
     });
   } catch (e) {}
 
-  const TITLES = { main: '首页', friends: '好友', network: '网络', me: '我' };
+  const TITLES = { main: '首页', friends: '好友', network: '网络', tasks: '任务', me: '我' };
   let currentTab = 'main';
   function switchTab(tab) {
     currentTab = tab;
@@ -1697,6 +1697,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,10 +1813,11 @@
       <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>
-        <div class="conv-item" id="settings-accessibility"><span class="list-icon">${ICONS.globe}</span><span>无障碍服务 (屏幕触控)</span><span class="list-arrow">›</span></div>
+        <div class="conv-item" id="settings-accessibility"><span class="list-icon">${ICONS.globe}</span><span>完全访问权限<span class="conv-preview" style="display:block" id="access-preview">默认开启</span></span><span class="list-arrow">›</span></div>
         <div class="conv-item" id="settings-ipfs"><span class="list-icon">${ICONS.chip}</span><span>IPFS 存储</span><span class="list-arrow">›</span></div>
         <div class="conv-item" id="settings-helia"><span class="list-icon">${ICONS.globe}</span><span>本机 IPFS 节点</span><span class="list-arrow">›</span></div>
         <div class="conv-item" id="settings-selfcard"><span class="list-icon">${ICONS.chip}</span><span id="selfcard-text">显示本机卡片: 开</span></div>
@@ -1725,20 +1830,66 @@
     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);
     });
-    // 无障碍服务: 屏幕触控 (电脑端 phone.tap / phone.swipe) 的前提 — 与 MCP/Skills 控制无关
+    // 完全访问权限 (屏幕点按/滑动, 电脑端 phone.tap / phone.swipe 的前提) — 默认开启
+    const ACCESS_AUTO_KEY = 'bolloon_access_auto_guided';
+    const refreshAccessPreview = async () => {
+      const el = document.querySelector('#access-preview');
+      if (!el) return;
+      const cap = window.Capacitor;
+      const b = cap && cap.Plugins && cap.Plugins.RokidBridge;
+      if (!b) { el.textContent = '仅手机 App'; return; }
+      let st = {};
+      try { st = (await b.touchStatus()) || {}; } catch (e) { st = {}; }
+      el.textContent = st.ready ? '已开启' : '未开启 · 点这里开';
+    };
+    void refreshAccessPreview();
+    // 默认开启: 首次启动自动把用户带到系统开关页 (只引导一次, 不反复打扰)
+    void (async () => {
+      try {
+        const cap = window.Capacitor;
+        const b = cap && cap.Plugins && cap.Plugins.RokidBridge;
+        if (!b) return;
+        let st = {};
+        try { st = (await b.touchStatus()) || {}; } catch (e) { return; }
+        if (st.ready) return;
+        if (localStorage.getItem(ACCESS_AUTO_KEY) === '1') return;
+        localStorage.setItem(ACCESS_AUTO_KEY, '1');
+        await b.openAccessibilitySettings();
+      } catch (e) {}
+    })();
     $('#settings-accessibility').addEventListener('click', async () => {
       const cap = window.Capacitor;
       const bridge = cap && cap.Plugins && cap.Plugins.RokidBridge;
-      if (!bridge) { alert('仅真机可用：App 内可把屏幕触控能力授权给电脑端'); return; }
+      if (!bridge) { alert('完全访问权限只在手机 App 里有：电脑端 / 网页版没有这项。'); return; }
       let st = {};
       try { st = (await bridge.touchStatus()) || {}; } catch (e) { st = {}; }
-      if (st.ready) { alert('触控已就绪：电脑端可发 phone.tap / phone.swipe 操作这台手机'); return; }
-      try { await bridge.openAccessibilitySettings(); }
-      catch (e) { alert('请手动开启：设置 → 辅助功能 → 已安装的服务 → Bolloon Agent'); }
+      if (st.ready) { alert('完全访问权限已开启：智能体可以在这台手机上点按、滑动屏幕（电脑端也能远程帮你点）。\n\n想关掉：系统设置 → 辅助功能 → 已开启的服务 → Bolloon Agent，关掉即可。'); return; }
+      try {
+        alert('马上打开系统设置，把「Bolloon Agent」的完全访问权限打开。\n（这一项在有些手机叫「辅助功能」，有些叫「无障碍」，指同一个开关；打开后一直有效，随时可以关掉。）');
+        await bridge.openAccessibilitySettings();
+        void refreshAccessPreview();
+      }
+      catch (e) { alert('没打开成功，请手动去：系统设置 → 辅助功能 → 已开启的服务 → Bolloon Agent，打开即可。'); }
     });
 
     // 本机数据: 直接读 IndexedDB 快照 (智能体/会话/消息都在本机, 重开 App 不会丢)
@@ -1797,9 +1948,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' },
@@ -1817,43 +1987,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) {
@@ -1862,23 +2144,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(),
@@ -1890,6 +2186,12 @@
         page.remove();
       } catch (e) { alert('保存失败: ' + (e.message || e)); }
     });
+
+    // 启动: 先画芯片(服务端清单) → 再画生效卡片与目录
+    lastProviders = await paintEffective();
+    paintChips();
+    fillFrom(picked);
+    await paintCatalog();
   }
 
   // === 加密钱包 (只读 MVP) ===
@@ -3001,3 +3303,673 @@
   document.addEventListener('DOMContentLoaded', init);
   if (document.readyState !== 'loading') init();
 })();
+
+// ============ 联系方式与持久授权 (2026-09-19) ============
+// 独立 IIFE: 不改动既有逻辑, 只用 window.BolloonCore.contacts (编译进 mobile-core.js)。
+// 分工: 手机 = 输入/OTP/确认/展示待发内容/批准/签名授权; 桌面 = 落盘/执行/等待回复/证据。
+(function () {
+  const $ = (sel) => document.querySelector(sel);
+  const C = () => (window.BolloonCore && window.BolloonCore.contacts) || null;
+  const esc = (v) => String(v == null ? '' : v).replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]));
+
+  function openSheet() { const el = $('#contacts-sheet'); if (el) el.hidden = false; }
+  function closeSheet() { const el = $('#contacts-sheet'); if (el) el.hidden = true; }
+  function setText(id, text) { const el = $(id); if (el) el.textContent = text; }
+
+  let _lastChallenge = null;
+
+  async function refresh() {
+    const c = C();
+    setText('#contacts-effective', '加载中...');
+    if (!c) { setText('#contacts-effective', '内核未就绪 (mobile-core 没加载)'); return; }
+    setText('#contacts-signing', c.deviceSigning()
+      ? '本机可做设备签名 (Ed25519) — 授权由这台手机签名后桌面才认'
+      : '⚠ 本机 WebView 不支持 Ed25519 设备签名 — 无法在手机上授权, 请在桌面端授权');
+    // 桌面回来先补同步排队中的授权
+    try { const fl = await c.flushQueue(); if (fl && fl.sent) setText('#contacts-signing', `已补同步 ${fl.sent} 条手机授权到桌面`); } catch (e) {}
+
+    let card = null;
+    try { card = await c.card(); } catch (e) { card = null; }
+    if (!card) { setText('#contacts-effective', '读取失败'); return; }
+    setText('#contacts-effective',
+      `当前授权: ${card.effective}` + (card.deviceSigning ? '' : ' · 本机不能签名'));
+    setText('#contacts-willnot', '不会获得权限: ' + (card.willNotGet || []).join(' · '));
+
+    // 联系方式 (只有脱敏值)
+    const list = $('#contacts-list');
+    if (list) {
+      list.innerHTML = (card.contacts && card.contacts.length)
+        ? card.contacts.map((x) => `<div class="sheet-text">${esc(x.displayValue)} <span style="color:var(--text-secondary)">[${esc(x.kind)}] ${esc(x.state)} · ${esc(x.label)}</span></div>`).join('')
+        : '<div class="sheet-text" style="color:var(--text-secondary)">还没有绑定 — 在下面输入手机号或邮箱</div>';
+    }
+
+    // 待批准 (展示待发内容 → 批准/拒绝)
+    const ap = $('#contacts-approvals');
+    if (ap) {
+      ap.innerHTML = (card.approvals && card.approvals.length)
+        ? `<div class="sheet-title" style="margin-top:10px">待你批准 (${card.approvals.length})</div>` + card.approvals.map((a) => `
+          <div style="border:1px solid var(--border);border-radius:10px;padding:8px;margin-top:6px">
+            <div class="sheet-text" style="font-weight:600">${esc(a.contactName)} · ${esc(a.channel)}${a.reallySent ? '' : ' · 本地落盘(未真实外发)'}</div>
+            <div class="sheet-text" style="font-size:12px">${a.subject ? esc(a.subject) + ' — ' : ''}${esc(a.bodyPreview)}</div>
+            <div class="sheet-text" style="font-size:11px;color:var(--text-secondary)">原因: ${esc(a.reason)}</div>
+            <div style="display:flex;gap:8px;margin-top:6px">
+              <button class="sheet-choice" data-approve="${esc(a.consentId)}" style="flex:1">批准并发送</button>
+              <button class="sheet-choice sheet-cancel" data-reject="${esc(a.consentId)}" style="flex:1">拒绝</button>
+            </div>
+          </div>`).join('')
+        : '<div class="sheet-text" style="color:var(--text-secondary);margin-top:10px">没有待批准的联系</div>';
+      ap.querySelectorAll('[data-approve]').forEach((b) => b.addEventListener('click', async () => {
+        const id = b.getAttribute('data-approve');
+        const r = await C().decide(id, 'approve');
+        alert(r && r.ok ? '已批准并发送' : '批准失败: ' + ((r && r.error) || '未知'));
+        refresh();
+      }));
+      ap.querySelectorAll('[data-reject]').forEach((b) => b.addEventListener('click', async () => {
+        const id = b.getAttribute('data-reject');
+        const r = await C().decide(id, 'reject', { reason: '手机端拒绝' });
+        alert(r && r.ok ? '已拒绝' : '拒绝失败: ' + ((r && r.error) || '未知'));
+        refresh();
+      }));
+    }
+
+    // 三个授权选项
+    const ch = $('#contacts-choices');
+    if (ch && !ch.dataset.bound) {
+      ch.dataset.bound = '1';
+      ch.innerHTML = (card.choices || []).map((x) => `<button class="sheet-choice" data-choice="${esc(x.id)}">${esc(x.label)}</button>`).join('');
+      ch.querySelectorAll('[data-choice]').forEach((b) => b.addEventListener('click', async () => {
+        const choice = b.getAttribute('data-choice');
+        const warn = choice === 'full_contact_access'
+          ? '完全授权联系方式能力: 手机号/邮箱能力交给 Agent, 普通与敏感内容不再逐次确认 (密钥/支付/合同承诺仍然拒绝)。确认吗?'
+          : choice === 'persistent' ? '长期使用: 以后 Agent 联系已验证的人不再打断你 (仍受频率/任务/证据/撤销约束)。确认吗?'
+            : '仅本次任务: 只授权当前任务使用。确认吗?';
+        if (window.confirm && !window.confirm(warn)) return;
+        const r = await C().authorize(choice);
+        if (r && r.ok) alert('已授权: 桌面已验签接受\n' + (r.note || ''));
+        else if (r && r.queued) alert('桌面暂时不在线\n授权已保存在手机本地队列, 桌面一上线自动同步\n(' + (r.error || '') + ')');
+        else alert('授权失败: ' + ((r && r.error) || '未知'));
+        refresh();
+      }));
+    }
+  }
+
+  function bindEvents() {
+    const item = $('#item-contacts');
+    if (item) item.addEventListener('click', () => { openSheet(); refresh(); });
+    const close = $('#contacts-close');
+    if (close) close.addEventListener('click', closeSheet);
+
+    const bind = $('#contacts-bind');
+    if (bind) bind.addEventListener('click', async () => {
+      const v = ($('#contacts-value') || {}).value || '';
+      if (!v.trim()) { alert('先输入手机号或邮箱'); return; }
+      const isEmail = /@/.test(v);
+      const r = await C().bind(isEmail ? 'email' : 'phone', v.trim(), isEmail ? undefined : 'CN');
+      if (!r || !r.ok) { alert('绑定失败: ' + ((r && r.error) || '未知')); return; }
+      _lastChallenge = r.data;
+      alert('已登记 ' + r.data.displayValue + '\n通道: ' + (r.data.channelLabel || '') +
+        (r.data.otpForLocalSink ? '\n本地落盘验证码: ' + r.data.otpForLocalSink : '\n验证码已通过通道发出, 收到后填在下面'));
+      refresh();
+    });
+
+    const verify = $('#contacts-verify');
+    if (verify) verify.addEventListener('click', async () => {
+      const code = ($('#contacts-code') || {}).value || '';
+      if (!_lastChallenge) { alert('先绑定一个手机号或邮箱'); return; }
+      const r = await C().verify(_lastChallenge.contactId, _lastChallenge.challengeId, code.trim());
+      if (!r || !r.ok) { alert('验证失败: ' + ((r && r.error) || '未知')); return; }
+      alert('验证通过: ' + r.data.displayValue + '\n下一步: 选择下面的授权等级 (验证 ≠ 自动长期授权)');
+      refresh();
+    });
+
+    const revoke = $('#contacts-revoke-all');
+    if (revoke) revoke.addEventListener('click', async () => {
+      if (window.confirm && !window.confirm('撤销全部联系方式授权? 之后 Agent 不能再自动联系任何人 (历史证据保留)')) return;
+      const card = await C().card();
+      const grants = (card && card.grants) || [];
+      if (!grants.length) { alert('当前没有生效中的授权'); return; }
+      let done = 0, err = '';
+      for (const g of grants) {
+        if (g.status !== 'active') continue;
+        const r = await C().revoke(g.grantId, '手机端收回');
+        if (r && r.ok) done++; else err = (r && r.error) || '未知';
+      }
+      alert(done ? `已撤销 ${done} 条授权` : ('撤销未完成: ' + err));
+      refresh();
+    });
+  }
+
+  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', bindEvents);
+  else bindEvents();
+})();
+
+// ============ 任务协作: 入群 · 发公告 · 看飞轮进度 (2026-09-25) ============
+// 独立 IIFE (与联系方式面板同款): 只用 window.BolloonCore.tasks (编译进 mobile-core.js)。
+// 分工**不变**: 手机 = 输入 · 展示待发内容 · 设备签名; 桌面 = 落盘 · 执行 · 等待回复 · 证据。
+// 纪律:
+//   · 动态文本一律 textContent (本文件这一段**不用 innerHTML** 拼任何数据)
+//   · 渲染只取白名单字段 (视图对象里多出来的字段进不了 DOM)
+//   · 双语走 data-zh/data-en (切语言只重写文字节点, 不重建结构)
+//   · 相对时间只更新 .rel-time 文字节点 (不重渲染整页)
+(function () {
+  const $ = (sel) => document.querySelector(sel);
+  const T = () => (window.BolloonCore && window.BolloonCore.tasks) || null;
+
+  // ── 语言 (data-zh/data-en; 默认中文, 显式切 en 才英文) ──────────────────────
+  function lang() {
+    try { return localStorage.getItem('bolloon_lang') === 'en' ? 'en' : 'zh'; } catch (e) { return 'zh'; }
+  }
+  function bilingual(el, zh, en) {
+    if (!el) return el;
+    el.setAttribute('data-zh', String(zh));
+    el.setAttribute('data-en', String(en));
+    el.textContent = lang() === 'en' ? String(en) : String(zh);
+    return el;
+  }
+  function applyLang(root) {
+    const scope = root || document;
+    scope.querySelectorAll('[data-zh][data-en]').forEach((el) => {
+      el.textContent = lang() === 'en' ? el.getAttribute('data-en') : el.getAttribute('data-zh');
+    });
+  }
+  window.__mobileLang = {
+    get: lang,
+    set(v) {
+      try { localStorage.setItem('bolloon_lang', v === 'en' ? 'en' : 'zh'); } catch (e) {}
+      applyLang();
+      // 列表里的空态/描述是用 lang() 现拼的 → 切完语言重渲染一次, 免得留下上一语言的旧句子
+      try {
+        if (window.__mobileTasksUi && typeof window.__mobileTasksUi.refresh === 'function') window.__mobileTasksUi.refresh();
+      } catch (e) {}
+    },
+  };
+
+  // ── DOM 小工具 (全部 textContent) ─────────────────────────────────────────
+  function mk(tag, cls) { const e = document.createElement(tag); if (cls) e.className = cls; return e; }
+  function line(cls, text) { const e = mk('div', cls || 'sheet-text'); if (text !== undefined && text !== null) e.textContent = String(text); return e; }
+  function row(text, sub) {
+    const e = mk('div', 'list-item');
+    const box = mk('div');
+    box.style.flex = '1';
+    box.appendChild(line('', text));
+    if (sub !== undefined && sub !== null && String(sub) !== '') {
+      const s = line('', sub);
+      s.style.fontSize = '12px';
+      s.style.color = 'var(--text-secondary)';
+      box.appendChild(s);
+    }
+    e.appendChild(box);
+    return e;
+  }
+  /** 相对时间节点: 只改这一个文字节点 (data-at 记住基准) */
+  function relNode(atMs) {
+    const s = mk('span', 'rel-time');
+    s.setAttribute('data-at', String(Number(atMs) || 0));
+    s.textContent = relText(Number(atMs) || 0);
+    return s;
+  }
+  /** 相对时间节点 (输入是**毫秒差**, 例如 deadlineInMs / resumeInMs) —— 每 30s 只改这个文字节点 */
+  function relDeltaNode(deltaMs) {
+    const s = mk('span', 'rel-time');
+    s.setAttribute('data-delta', String(Number(deltaMs) || 0));
+    s.textContent = relDeltaText(Number(deltaMs) || 0);
+    return s;
+  }
+  function relDeltaText(deltaMs) {
+    const t = T();
+    if (!t || !t.relative) return '';
+    return t.relative(Number(deltaMs) || 0, lang()) || '';
+  }
+  function relText(atMs) {
+    const t = T();
+    if (!atMs) return '';
+    if (t && t.relative) return t.relative(Date.now() - Number(atMs), lang()) || '';
+    return '';
+  }
+  function shorten(v, n) { const t = T(); return t && t.shorten ? t.shorten(v, n) : String(v == null ? '' : v).slice(0, n || 12); }
+  /** 最后一道自检: 命中红线就不显示原文 (桌面已经挡过, 这里只兜底) */
+  function safeText(v) {
+    const s = String(v == null ? '' : v);
+    const t = T();
+    if (t && t.scanText) {
+      const hits = t.scanText(s);
+      if (hits && hits.length) return '[' + (lang() === 'en' ? 'redacted:' : '已遮蔽:') + hits[0].rule + ']';
+    }
+    return s;
+  }
+  function setText(sel, text) { const el = $(sel); if (el) el.textContent = text == null ? '' : String(text); }
+  /** 动态状态行: 带上 data-zh/data-en, 这样切语言时它也换 (applyLang 只管文字节点) */
+  function dynText(sel, zh, en) {
+    const el = $(sel);
+    if (!el) return;
+    el.setAttribute('data-zh', String(zh));
+    el.setAttribute('data-en', String(en));
+    el.textContent = lang() === 'en' ? String(en) : String(zh);
+  }
+  function clear(node) { if (node) while (node.firstChild) node.removeChild(node.firstChild); }
+  function openSheet() { const el = $('#task-confirm-sheet'); if (el) el.hidden = false; }
+  function closeSheet() { const el = $('#task-confirm-sheet'); if (el) el.hidden = true; }
+  function toast(msg) {
+    if (window.alert) window.alert(String(msg));
+  }
+
+  // ── 状态 (完整 id 只留在这段 JS 内存里, 不进 DOM 文本) ─────────────────────
+  const state = { groups: [], groupsView: [], board: null, flywheel: null, trail: null, selectedGroupRef: '', pending: null };
+
+  // ── 渲染: 群 ──────────────────────────────────────────────────────────────
+  function renderGroups() {
+    const list = $('#tasks-groups');
+    if (!list) return;
+    clear(list);
+    if (!state.groups.length) {
+      list.appendChild(line('sheet-text', lang() === 'en' ? 'No groups joined yet' : '还没有加入任何群'));
+      return;
+    }
+    state.groups.forEach((g, i) => {
+      const view = state.groupsView[i] || {};
+      const r = row(String(view.name || '') + '  ·  ' + String(view.idShort || ''), '');
+      const when = relNode(Date.parse(String(view.joinedAt || '')) || 0);
+      const sub = line('', '');
+      sub.style.fontSize = '12px';
+      sub.style.color = 'var(--text-secondary)';
+      sub.appendChild(document.createTextNode(lang() === 'en' ? 'joined ' : '加入于 '));
+      sub.appendChild(when);
+      r.firstChild.appendChild(sub);
+      const b = mk('button', 'sheet-choice');
+      b.style.flex = '0 0 auto';
+      bilingual(b, '退群', 'Leave');
+      b.setAttribute('data-group-leave', String(i));
+      b.addEventListener('click', () => askLeave(i));
+      r.appendChild(b);
+      list.appendChild(r);
+    });
+  }
+
+  // ── 渲染: 公告板 ──────────────────────────────────────────────────────────
+  function renderBoard() {
+    const list = $('#tasks-board');
+    if (!list) return;
+    clear(list);
+    const d = state.board || {};
+    const items = d.items || [];
+    if (!items.length) {
+      list.appendChild(line('sheet-text', lang() === 'en' ? 'Board is empty' : '板上暂时没有公告'));
+    }
+    items.forEach((it, i) => {
+      const r = row(
+        String(it.capability || '') + '  ·  ' + String(it.idShort || '') + '  ·  ' + String((it.statusLabel || {})[lang()] || ''),
+        '',
+      );
+      const sub = line('', '');
+      sub.style.fontSize = '12px';
+      sub.style.color = 'var(--text-secondary)';
+      sub.appendChild(document.createTextNode((lang() === 'en' ? 'budget ' : '预算 ') + safeText(it.budgetLabel || '—') + ' · '));
+      sub.appendChild(document.createTextNode(lang() === 'en' ? 'closes ' : '截止 '));
+      sub.appendChild(relDeltaNode(it.deadlineInMs));
+      r.firstChild.appendChild(sub);
+      if (it.claimable) {
+        const b = mk('button', 'sheet-choice');
+        b.style.flex = '0 0 auto';
+        bilingual(b, '发进群', 'Post to group');
+        b.setAttribute('data-announce', String(i));
+        b.addEventListener('click', () => askAnnounceToGroup(i));
+        r.appendChild(b);
+      }
+      list.appendChild(r);
+    });
+    const notes = Array.isArray(d.notes) ? d.notes : [];
+    if (notes.length) list.appendChild(line('sheet-text', notes.join(' · ')));
+  }
+
+  // ── 渲染: 飞轮进度 (只读; 状态来自 goal-flywheel 的五类用户可见状态) ────────
+  function renderFlywheel() {
+    const list = $('#tasks-flywheel');
+    if (!list) return;
+    clear(list);
+    const goals = (state.flywheel && state.flywheel.goals) || [];
+    if (!goals.length) {
+      list.appendChild(line('sheet-text', lang() === 'en' ? 'No goals yet' : '还没有目标'));
+      const hint = state.flywheel && state.flywheel.hint;
+      if (hint) list.appendChild(line('sheet-text', hint));
+      return;
+    }
+    const zh = lang() === 'zh';
+    goals.forEach((g) => {
+      const v = g.view || {};
+      const r = row(String(g.objectiveShort || '') + '  ·  ' + String((v.stateLabel || {})[lang()] || g.status || ''), '');
+      const box = r.firstChild;
+      const rep = v.report || {};
+      if (rep.nextStep) box.appendChild(line('sheet-text', (zh ? '下一步: ' : 'next step: ') + safeText(rep.nextStep)));
+      if (rep.conclusion) box.appendChild(line('sheet-text', (zh ? '结论: ' : 'conclusion: ') + safeText(rep.conclusion)));
+      if (Array.isArray(rep.remaining) && rep.remaining.length) {
+        box.appendChild(line('sheet-text', (zh ? '还剩: ' : 'remaining: ') + rep.remaining.map(safeText).join(' · ')));
+      }
+      if (Array.isArray(rep.blockReasons) && rep.blockReasons.length) {
+        box.appendChild(line('sheet-text', (zh ? '卡住原因: ' : 'blocked by: ') + rep.blockReasons.map(safeText).join(' · ')));
+      }
+      const sub = line('', '');
+      sub.style.fontSize = '12px';
+      sub.style.color = 'var(--text-secondary)';
+      if (v.resumeInMs !== null && v.resumeInMs !== undefined) {
+        sub.appendChild(document.createTextNode(zh ? '下次醒来 ' : 'wakes '));
+        sub.appendChild(relDeltaNode(v.resumeInMs));
+      }
+      sub.appendChild(document.createTextNode((zh ? ' · 会继续: ' : ' · will continue: ') + (rep.willContinue ? (zh ? '是' : 'yes') : (zh ? '否' : 'no'))));
+      box.appendChild(sub);
+      if (v.requiredAgent) box.appendChild(line('sheet-text', safeText(v.requiredAgent)));
+      if (v.riskLevel) box.appendChild(line('sheet-text', (zh ? '风险: ' : 'risk: ') + safeText(v.riskLevel)));
+      const blocks = Array.isArray(v.blocks) ? v.blocks : [];
+      blocks.forEach((b) => {
+        const label = [(b.kindLabel || {})[lang()], (b.ownerLabel || {})[lang()], (b.actionLabel || {})[lang()]].filter(Boolean).join(' · ');
+        const bl = line('sheet-text', safeText(label) + (b.note ? ' — ' + safeText(b.note) : ''));
+        box.appendChild(bl);
+        const bd = line('', '');
+        bd.style.fontSize = '12px';
+        bd.style.color = 'var(--text-secondary)';
+        bd.appendChild(document.createTextNode(zh ? '卡了 ' : 'blocked for '));
+        bd.appendChild(relDeltaNode(b.blockedForMs));
+        box.appendChild(bd);
+      });
+      list.appendChild(r);
+    });
+    const note = state.flywheel && state.flywheel.note;
+    if (note) list.appendChild(line('sheet-text', note));
+  }
+
+  // ── 渲染: 群痕迹 (只读) ───────────────────────────────────────────────────
+  function renderTrail() {
+    const list = $('#tasks-trail');
+    if (!list) return;
+    clear(list);
+    const t = state.trail;
+    if (!t) { list.appendChild(line('sheet-text', lang() === 'en' ? 'Pick a group first' : '先选一个群')); return; }
+    if (!t.entries.length) {
+      list.appendChild(line('sheet-text', lang() === 'en' ? 'No trail entries for this round' : '这一期还没有过程痕迹'));
+      return;
+    }
+    t.entries.forEach((e) => {
+      const label = (e.kindLabel || {})[lang()] || e.kind;
+      const r = row(String(label) + '  ·  ' + String(e.sender || ''), '');
+      const box = r.firstChild;
+      const sub = line('', '');
+      sub.style.fontSize = '12px';
+      sub.style.color = 'var(--text-secondary)';
+      sub.appendChild(relNode(e.atMs || 0));
+      box.appendChild(sub);
+      (e.facts || []).forEach((f) => box.appendChild(line('sheet-text', safeText(f.k) + '=' + safeText(f.v))));
+      list.appendChild(r);
+    });
+    if (t.privacyHits) list.appendChild(line('sheet-text', lang() === 'en' ? '⚠ some lines hit the privacy rules and were redacted' : '⚠ 有消息命中隐私红线, 已遮蔽'));
+    if (t.ignoredMessages) list.appendChild(line('sheet-text', (lang() === 'en' ? 'ignored messages: ' : '忽略消息: ') + String(t.ignoredMessages)));
+  }
+
+  // ── 确认页 (展示待发内容 → 确认 → 签名) ───────────────────────────────────
+  function renderConfirm() {
+    const t = T();
+    const p = state.pending;
+    if (!t || !p) return;
+    const d = t.describeConfirm(p.kind, p.req) || {};
+    const title = $('#task-confirm-title');
+    if (title) bilingual(title, d.titleZh || '确认这个动作', d.titleEn || 'Confirm this action');
+    const lines = $('#task-confirm-lines');
+    if (lines) {
+      clear(lines);
+      (d.lines || []).forEach((l) => lines.appendChild(line('sheet-text', (lang() === 'en' ? l.kEn : l.k) + ': ' + safeText(l.v))));
+    }
+    setText('#task-confirm-what', lang() === 'en'
+      ? 'This will be signed with this device key. The desktop verifies that signature before doing anything.'
+      : '这个动作会用本机设备密钥签名; 桌面验签通过后才会真正执行。');
+    // 群选择 (群消息类动作必须显式选群)
+    const wrap = $('#task-confirm-group-wrap');
+    const box = $('#task-confirm-group');
+    const needsGroup = p.needsGroup === true;
+    if (wrap) wrap.hidden = !needsGroup;
+    if (box && needsGroup) {
+      clear(box);
+      state.groups.forEach((g, i) => {
+        const view = state.groupsView[i] || {};
+        const b = mk('button', 'sheet-choice');
+        bilingual(b, String(view.name || ''), String(view.name || ''));
+        b.setAttribute('data-pick-group', String(i));
+        if (p.req.groupRef === g.id) b.style.borderColor = 'var(--accent)';
+        b.addEventListener('click', () => { p.req.groupRef = g.id; state.selectedGroupRef = g.id; renderConfirm(); refreshPreview(); });
+        box.appendChild(b);
+      });
+      if (!state.groups.length) box.appendChild(line('sheet-text', lang() === 'en' ? 'no groups' : '还没有群'));
+    }
+    // 群消息类: 预览按钮 + 原文区
+    const pv = $('#task-confirm-preview');
+    if (pv) pv.hidden = !p.showPreview;
+    const ct = $('#task-confirm-content-title');
+    const cc = $('#task-confirm-content');
+    if (ct) ct.hidden = !p.previewText;
+    if (cc) { cc.hidden = !p.previewText; cc.textContent = p.previewText || ''; }
+    const yes = $('#task-confirm-yes');
+    if (yes) {
+      const disabled = needsGroup && !p.req.groupRef;
+      yes.disabled = !!disabled;
+      yes.style.opacity = disabled ? '0.5' : '';
+    }
+  }
+
+  async function refreshPreview() {
+    const t = T();
+    const p = state.pending;
+    if (!t || !p || !p.showPreview) return;
+    if (!p.req.groupRef) { p.previewText = ''; renderConfirm(); return; }
+    const r = await t.previewGroupMessage(p.req);
+    if (r && r.ok) { p.previewText = (r.data && r.data.text) || ''; setText('#tasks-hint', ''); }
+    else { p.previewText = ''; setText('#tasks-hint', (lang() === 'en' ? 'preview failed: ' : '预览失败: ') + String((r && r.code) || '') + ' ' + String((r && r.error) || '')); }
+    renderConfirm();
+  }
+
+  function askConfirm(kind, req, opts) {
+    state.pending = Object.assign({ kind: kind, req: req, showPreview: false, previewText: '' }, opts || {});
+    renderConfirm();
+    openSheet();
+    if (state.pending.showPreview) refreshPreview();
+  }
+
+  function requireSigning() {
+    const t = T();
+    if (!t) { toast(lang() === 'en' ? 'phone kernel not ready' : '手机内核未就绪 (mobile-core 没加载)'); return null; }
+    if (!t.deviceSigning || !t.deviceSigning()) {
+      toast(lang() === 'en'
+        ? 'this WebView cannot do Ed25519 device signing — run it from the desktop instead'
+        : '本机 WebView 不支持 Ed25519 设备签名 —— 这个动作请在桌面端执行 (不降级, 不假装签了)');
+      return null;
+    }
+    return t;
+  }
+
+  // ── 四个能力的入口 ────────────────────────────────────────────────────────
+  function askJoin() {
+    const link = (($('#tasks-group-link') || {}).value || '').trim();
+    if (!link) { toast(lang() === 'en' ? 'paste the group invite link first' : '先粘贴群邀请链接'); return; }
+    if (!requireSigning()) return;
+    const req = T().emptyRequest('group_join');
+    req.groupRef = link;
+    askConfirm('group_join', req, {});
+  }
+  function askCreate() {
+    const name = (($('#tasks-group-name') || {}).value || '').trim();
+    if (!name) { toast(lang() === 'en' ? 'give the group a name first' : '先给群起个名字'); return; }
+    if (!requireSigning()) return;
+    const req = T().emptyRequest('group_create');
+    req.groupRef = name;
+    askConfirm('group_create', req, {});
+  }
+  function askLeave(i) {
+    if (!requireSigning()) return;
+    const g = state.groups[i];
+    if (!g) return;
+    const req = T().emptyRequest('group_leave');
+    req.groupRef = g.id;
+    askConfirm('group_leave', req, {});
+  }
+  function askPublish() {
+    if (!requireSigning()) return;
+    const cap = (($('#tasks-pub-capability') || {}).value || '').trim();
+    const ins = (($('#tasks-pub-instruction') || {}).value || '').trim();
+    const bud = (($('#tasks-pub-budget') || {}).value || '').trim();
+    const dl = (($('#tasks-pub-deadline') || {}).value || '').trim();
+    if (!cap || !ins || !bud) { toast(lang() === 'en' ? 'capability / instruction / budget are required' : '能力 / 任务正文 / 预算 都要填'); return; }
+    const req = T().emptyRequest('announce_publish');
+    req.capability = cap; req.instruction = ins; req.budgetHuman = bud; req.currency = 'USDC';
+    if (dl) req.deadline = dl;
+    askConfirm('announce_publish', req, {});
+  }
+  function askAnnounceToGroup(i) {
+    if (!requireSigning()) return;
+    const it = ((state.board || {}).items || [])[i];
+    if (!it) return;
+    const req = T().emptyRequest('announce_to_group');
+    req.announcementId = it.ref || '';
+    req.groupRef = state.selectedGroupRef || (state.groups[0] && state.groups[0].id) || '';
+    if (!req.announcementId) { toast(lang() === 'en' ? 'desktop did not give a usable announcement id' : '桌面没给出可用的公告号, 先刷新') ; return; }
+    askConfirm('announce_to_group', req, { needsGroup: true, showPreview: true });
+  }
+  function askTrail(kind) {
+    if (!requireSigning()) return;
+    const req = T().emptyRequest('trail_post');
+    req.groupRef = state.selectedGroupRef || (state.groups[0] && state.groups[0].id) || '';
+    req.trailKind = kind;
+    if (!req.groupRef) { toast(lang() === 'en' ? 'pick a group first' : '先选一个群'); return; }
+    askConfirm('trail_post', req, { needsGroup: true, showPreview: true });
+  }
+
+  async function doConfirmed() {
+    const t = T();
+    const p = state.pending;
+    if (!t || !p) return;
+    const yes = $('#task-confirm-yes');
+    if (yes) yes.disabled = true;
+    const r = await t.execute(p.req);
+    if (yes) yes.disabled = false;
+    closeSheet();
+    if (r && r.ok) {
+      const text = (r.data && r.data.text) || (lang() === 'en' ? 'done' : '已执行');
+      t.setHint ? t.setHint(safeText(text)) : null;
+      toast(safeText(text));
+    } else {
+      const code = String((r && r.code) || 'unknown');
+      const err = String((r && r.error) || '');
+      t.setHint ? t.setHint((lang() === 'en' ? 'failed: ' : '失败: ') + code) : null;
+      toast((lang() === 'en' ? 'not executed: ' : '没有执行: ') + code + (err ? '\n' + safeText(err) : ''));
+    }
+    state.pending = null;
+    state.selectedGroupRef = '';
+    await refreshAll();
+  }
+
+  // ── 刷新 ──────────────────────────────────────────────────────────────────
+  async function refreshAll() {
+    const t = T();
+    if (!t) {
+      dynText('#tasks-signing', '手机内核未就绪 (mobile-core 没加载)', 'phone kernel not ready');
+      return;
+    }
+    const canSign = !!t.deviceSigning();
+    const signingEl = $('#tasks-signing');
+    if (signingEl) signingEl.setAttribute('data-signing', canSign ? 'yes' : 'no');
+    setText('#tasks-hint', t.hint ? t.hint() : '');
+    dynText('#tasks-signing', canSign
+      ? '本机可做设备签名 (Ed25519) —— 高风险动作必须由它签名'
+      : '⚠ 本机 WebView 不支持签名 —— 高风险动作请在桌面端执行',
+    canSign
+      ? 'this device can sign (Ed25519) — risky actions need it'
+      : '⚠ this WebView cannot sign — run risky actions on the desktop');
+
+    const g = await t.listGroups();
+    state.groups = (g && g.ok && Array.isArray(g.data)) ? g.data.map((x) => ({ id: x.id, name: x.name })) : [];
+    state.groups.some((x) => x.id === state.selectedGroupRef) || (state.selectedGroupRef = state.groups[0] ? state.groups[0].id : '');
+    state.groupsView = (g && g.ok && Array.isArray(g.data)) ? g.data : [];
+    renderGroups();
+    renderTrailGroupPicker();
+
+    const b = await t.loadBoard();
+    state.board = b && b.ok ? b.data : {};
+    renderBoard();
+
+    const f = await t.loadFlywheel();
+    state.flywheel = f && f.ok ? f.data : {};
+    renderFlywheel();
+
+    if (state.selectedGroupRef) await loadTrailNow();
+  }
+
+  function renderTrailGroupPicker() {
+    const list = $('#tasks-trail-group-picker');
+    if (!list) return;
+    clear(list);
+    if (!state.groups.length) { list.appendChild(line('sheet-text', lang() === 'en' ? 'join a group to see its trail' : '入群后可以看群里这一期的痕迹')); return; }
+    state.groups.forEach((g, i) => {
+      const view = state.groupsView[i] || {};
+      const b = mk('button', 'sheet-choice');
+      bilingual(b, String(view.name || ''), String(view.name || ''));
+      b.setAttribute('data-pick-trail', String(i));
+      if (g.id === state.selectedGroupRef) b.style.borderColor = 'var(--accent)';
+      b.addEventListener('click', async () => {
+        state.selectedGroupRef = g.id;
+        renderTrailGroupPicker();
+        await loadTrailNow();
+      });
+      list.appendChild(b);
+    });
+  }
+
+  async function loadTrailNow() {
+    const t = T();
+    if (!t || !state.selectedGroupRef) return;
+    const r = await t.loadTrail({ groupRef: state.selectedGroupRef });
+    state.trail = (r && r.ok) ? r.data : null;
+    if (!r || !r.ok) setText('#tasks-hint', (lang() === 'en' ? 'trail read failed: ' : '读群痕迹失败: ') + String((r && r.code) || '') + ' ' + String((r && r.error) || ''));
+    renderTrail();
+  }
+
+  function bindEvents() {
+    const tab = document.querySelector('.tab[data-tab="tasks"]');
+    if (tab) tab.addEventListener('click', () => { applyLang(); refreshAll(); });
+    const r = $('#tasks-refresh');
+    if (r) r.addEventListener('click', refreshAll);
+    const j = $('#tasks-group-join');
+    if (j) j.addEventListener('click', askJoin);
+    const c = $('#tasks-group-create');
+    if (c) c.addEventListener('click', askCreate);
+    const p = $('#tasks-pub-submit');
+    if (p) p.addEventListener('click', askPublish);
+    const tr = $('#tasks-trail-refresh');
+    if (tr) tr.addEventListener('click', loadTrailNow);
+    const pv = $('#task-confirm-preview');
+    if (pv) pv.addEventListener('click', refreshPreview);
+    const yes = $('#task-confirm-yes');
+    if (yes) yes.addEventListener('click', doConfirmed);
+    const no = $('#task-confirm-no');
+    if (no) no.addEventListener('click', () => { state.pending = null; closeSheet(); });
+
+    // 相对时间: 每 30s 只改 .rel-time 文字节点 (不重渲染, 不动结构)
+    setInterval(() => {
+      document.querySelectorAll('.rel-time[data-at]').forEach((el) => {
+        const next = relText(Number(el.getAttribute('data-at')) || 0);
+        if (next && el.textContent !== next) el.textContent = next;
+      });
+      document.querySelectorAll('.rel-time[data-delta]').forEach((el) => {
+        const next = relDeltaText(Number(el.getAttribute('data-delta')) || 0);
+        if (next && el.textContent !== next) el.textContent = next;
+      });
+    }, 30000);
+
+    applyLang();
+  }
+
+  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', bindEvents);
+  else bindEvents();
+
+  // 供验收脚本/壳层驱动 (真 headless DOM 用): 只暴露行为入口, 不暴露数据
+  window.__mobileUpdateUi = { open: () => openUpdatePage(), openSettings: () => openSettings() };
+  window.__mobileTasksUi = {
+    refresh: refreshAll, askJoin: askJoin, askCreate: askCreate, askPublish: askPublish,
+    askTrail: askTrail, askAnnounceToGroup: askAnnounceToGroup, confirm: doConfirmed,
+    preview: refreshPreview, lang: window.__mobileLang, state: state,
+  };
+})();