@bolloon/bolloon-agent 0.4.23 → 0.4.24

package/dist/ios/mobile.js

@@ -16,6 +16,9 @@
     },
   };
 
+  // 一键入网默认 prompt: 交给智能体去读网关入网说明并执行入网 (人类只点一下)
+  const DEFAULT_JOIN_PROMPT = 'read https://bolloon.cn/bolloon-gateway-join.md';
+
   const THEMES = {
     dark: { '--bg': '#1a1a18', '--bg-card': '#222220', '--bg-hover': '#2a2a26', '--text': '#d8d8c8', '--text-secondary': '#909088', '--accent': '#c4d640', '--border': '#3a3a36' },
     light: { '--bg': '#f5f5f0', '--bg-card': '#ffffff', '--bg-hover': '#eeeeea', '--text': '#1a1a18', '--text-secondary': '#606058', '--accent': '#8a9430', '--border': '#d0d0c8' },
@@ -66,7 +69,7 @@
     });
   } catch (e) {}
 
-  const TITLES = { main: '首页', network: '网络', me: '我' };
+  const TITLES = { main: '首页', friends: '好友', network: '网络', me: '我' };
   let currentTab = 'main';
   function switchTab(tab) {
     currentTab = tab;
@@ -75,7 +78,8 @@
     $('#topbar-title').textContent = TITLES[tab] || '会话';
     const cs = $('#btn-create-session'); if (cs) cs.hidden = tab !== 'main';
     const ta = $('#topbar-actions'); if (ta) ta.hidden = tab === 'me';   // 我 页不显示 加号/刷新
-    if (tab === 'network') { loadContacts(); loadMcpTools(); loadApprovals(); loadNetMembers(); loadP2PStatus(); loadAgentServices(); }
+    if (tab === 'friends') { loadContacts(); loadP2PStatus(); }
+    if (tab === 'network') { loadAgentControl(); loadApprovals(); loadNetMembers(); loadAgentServices(); loadX402Info(); }
     if (tab === 'main') { loadAgentCovers(); }
     window.__mobileTouch?.('tab', tab);
   }
@@ -131,30 +135,135 @@
     } catch (e) { /* 忽略 */ }
   }
 
-  async function loadMcpTools() {
-    const box = $('#mcp-tools');
+  // 智能体控制 = MCP 控制 + Skills 控制 (不是屏幕触控!)
+  //  - MCP 工具: 真正的工具调用 (gateway_status / join / register …)
+  //  - Skills:   电脑端 ~/.bolloon/skills/ 同步下来的本机技能
+  // 屏幕触控(无障碍) 挪到 设置 → 无障碍服务 (屏幕触控)。
+  function mkOverlayPage(id, title, inner) {
+    const page = document.createElement('div');
+    page.className = 'chat-page';
+    page.id = id;
+    page.style.zIndex = '70';
+    page.innerHTML = `<div class="chat-topbar">
+        <button class="icon-btn" id="${id}-back">←</button>
+        <div style="flex:1;font-weight:600">${escapeHtml(title)}</div>
+      </div>
+      <div id="${id}-body" style="padding:12px;flex:1;min-height:0;overflow:auto">${inner}</div>`;
+    document.body.appendChild(page);
+    page.querySelector(`#${id}-back`).addEventListener('click', () => page.remove());
+    return page;
+  }
+
+  async function loadAgentControl() {
+    const box = $('#agent-control');
     if (!box) return;
-    box.innerHTML = '<div style="padding:12px 16px;color:var(--text-muted)">加载 MCP 工具...</div>';
+    const iconMcp = '<svg class="ico" viewBox="0 0 24 24"><path d="M14.5 4.5a3.5 3.5 0 0 0-4.9 4.2L4 14.3V20h5.7l5.6-5.6a3.5 3.5 0 0 0 4.2-4.9l-2.4 2.4-2.1-2.1z"/></svg>';
+    const iconSkill = '<svg class="ico" viewBox="0 0 24 24"><path d="M5 4h11l3 3v13H5z"/><path d="M9 12h6M9 16h4M9 8h4"/></svg>';
+    let tools = []; let skills = [];
+    try { tools = (await api.get('/api/mcp/tools')) || []; } catch (e) { tools = []; }
+    try { skills = (await api.get('/api/skills')) || []; } catch (e) { skills = []; }
+    const skillSub = skills.length
+      ? skills.slice(0, 3).map((s) => '/' + String(s.name || '')).join('  ')
+      : '尚无本机技能 —— 点开后从电脑端同步';
+    box.innerHTML = `
+      <div class="list-item" id="item-mcp"><span class="list-icon">${iconMcp}</span>
+        <span style="flex:1"><span style="display:block">MCP 工具 · ${tools.length} 个</span>
+        <span class="conv-preview" style="display:block">点开读工具说明并调用（gateway_status / join / register / call）</span></span>
+        <span class="list-arrow">›</span></div>
+      <div class="list-item" id="item-skills"><span class="list-icon">${iconSkill}</span>
+        <span style="flex:1"><span style="display:block">Skills · ${skills.length} 个</span>
+        <span class="conv-preview" style="display:block">${escapeHtml(skillSub)}</span></span>
+        <span class="list-arrow">›</span></div>`;
+    const mcpEl = $('#item-mcp'); if (mcpEl) mcpEl.addEventListener('click', () => void openMcpPage(tools));
+    const skEl = $('#item-skills'); if (skEl) skEl.addEventListener('click', () => void openSkillsPage());
+  }
+
+  async function openMcpPage(toolsIn) {
+    if ($('#mcp-page')) return;
+    const page = mkOverlayPage('mcp-page', 'MCP 工具', '<div style="font-size:12px;color:var(--text-muted)">读取中…</div>');
+    let tools = toolsIn;
+    if (!Array.isArray(tools) || !tools.length) {
+      try { tools = (await api.get('/api/mcp/tools')) || []; } catch (e) { tools = []; }
+    }
+    const body = page.querySelector('#mcp-page-body');
+    if (!tools.length) { body.innerHTML = '<div style="padding:20px;text-align:center;color:var(--text-muted)">没有可用的 MCP 工具</div>'; return; }
+    body.innerHTML = tools.map((t, i) => `<div class="conv-item" data-ti="${i}">
+        <div class="conv-avatar">${escapeHtml(String(t.name || 'M').charAt(0))}</div>
+        <div class="conv-body"><div class="conv-name">${escapeHtml(String(t.name || ''))}</div>
+        <div class="conv-preview">${escapeHtml(String(t.description || ''))}</div></div></div>`).join('')
+      + '<div style="font-size:11px;color:var(--text-muted);margin-top:12px;line-height:1.7">点一下 = 让本机智能体调用该工具（gateway_* 需要先加入 Agent 网络）</div>';
+    body.querySelectorAll('[data-ti]').forEach((el) => el.addEventListener('click', () => void runMcpTool(tools[Number(el.dataset.ti)])));
+  }
+
+  async function runMcpTool(t) {
+    const name = String((t && t.name) || '');
+    if (!name) return;
+    let args = {};
     try {
-      const r = await api.get('/api/mcp/tools').catch(() => null);
-      const tools = r?.tools || r || [];
-      if (!Array.isArray(tools) || tools.length === 0) {
-        box.innerHTML = '<div style="padding:12px 16px;color:var(--text-muted)">暂无可用 MCP 工具</div>';
+      if (name === 'gateway_join') {
+        const link = prompt('gateway_join 需要网络链接：\norbitdb://… 或 ipns://… 或 https://…/registry', '');
+        if (!link) return;
+        args = { link };
+      } else if (name === 'gateway_register') {
+        const svc = prompt('注册为服务提供者，填一个服务名（例如 手机端助手）：', '');
+        if (!svc) return;
+        let agentId = '';
+        try { const id2 = await api.get('/api/auth/status'); agentId = (id2 && (id2.agentId || id2.did)) || ''; } catch (e) { agentId = ''; }
+        if (!agentId) { alert('还没有身份（我 → 登录），无法注册为服务提供者'); return; }
+        args = { self: { agentId, name: svc, service: { name: svc } } };
+      } else if (name === 'gateway_call') {
+        const svc = prompt('要调用的服务（名称或 agentId）：', '');
+        if (!svc) return;
+        args = { service: svc };
+      }
+      const r = await api.post('/api/mcp/call', { name, args });
+      const ok = r && r.ok !== false;
+      alert(`${name} ${ok ? '✔' : '✘'}\n\n${(r && r.output) || JSON.stringify(r)}`);
+      void loadAgentControl();
+    } catch (e) {
+      alert(`${name} 调用失败：${(e && e.message) || e}`);
+    }
+  }
+
+  async function openSkillsPage() {
+    if ($('#skills-page')) return;
+    const page = mkOverlayPage('skills-page', 'Skills', '<div style="font-size:12px;color:var(--text-muted)">读取中…</div>');
+    const bar = document.createElement('div');
+    bar.style.cssText = 'padding:0 12px 14px';
+    bar.innerHTML = '<button id="skills-sync" style="width:100%;padding:11px;border-radius:10px;border:1px solid var(--border);background:var(--bg-hover);color:var(--accent);font-size:14px">从电脑端同步</button>';
+    page.appendChild(bar);
+    const render = async () => {
+      let skills = []; let err = '';
+      try { skills = (await api.get('/api/skills')) || []; } catch (e) { skills = []; err = (e && e.message) || ''; }
+      const body = page.querySelector('#skills-page-body');
+      if (!body) return;
+      if (!skills.length) {
+        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>`;
         return;
       }
-      box.innerHTML = '';
-      tools.forEach((t) => {
-        const name = t.name || t.function?.name || '工具';
-        const desc = t.description || t.function?.description || '';
-        const el = document.createElement('div');
-        el.className = 'conv-item';
-        el.innerHTML = `<div class="conv-avatar"><svg class="ico" viewBox="0 0 24 24"><path d="M9 3.5v4.5M15 3.5v4.5"/><path d="M6.5 8h11v3.2a5.5 5.5 0 0 1-11 0z"/><path d="M12 16.7V20.5"/></svg></div>
-          <div class="conv-body"><div class="conv-name">${escapeHtml(name)}</div>
-          <div class="conv-preview">${escapeHtml(desc)}</div></div>`;
-        el.addEventListener('click', () => { window.__mobileTouch?.('mcp', name); });
-        box.appendChild(el);
-      });
-    } catch (e) { box.innerHTML = '<div style="padding:12px 16px;color:var(--text-muted)">MCP 工具加载失败</div>'; }
+      body.innerHTML = skills.map((s, i) => `<div class="conv-item" data-sk="${i}">
+          <div class="conv-avatar">${escapeHtml(String(s.name || 'S').charAt(0).toUpperCase())}</div>
+          <div class="conv-body"><div class="conv-name">/${escapeHtml(String(s.name || ''))}</div>
+          <div class="conv-preview">${escapeHtml(String(s.description || '（无说明）').slice(0, 60))}</div></div></div>`).join('')
+        + `<div style="font-size:11px;color:var(--text-muted);margin-top:12px">共 ${skills.length} 个 · 来自电脑端 ~/.bolloon/skills/</div>`;
+      body.querySelectorAll('[data-sk]').forEach((el) => el.addEventListener('click', () => {
+        const s = skills[Number(el.dataset.sk)] || {};
+        alert(`/${s.name || ''}\n\n${s.description || '（无说明）'}`);
+      }));
+    };
+    await render();
+    const btn = page.querySelector('#skills-sync');
+    if (btn) btn.addEventListener('click', async () => {
+      btn.disabled = true; const old = btn.textContent; btn.textContent = '同步中…';
+      try {
+        const r = await api.post('/api/desktop/sync');
+        if (r && r.ok === false) { alert('同步失败：' + (r.error || '未知错误')); }
+        else { alert('同步完成' + (r && r.counts ? '：' + JSON.stringify(r.counts) : '')); }
+      } catch (e) { alert('同步失败：' + ((e && e.message) || e)); }
+      finally { btn.disabled = false; btn.textContent = old; await render(); }
+    });
   }
 
   async function loadApprovals() {
@@ -681,6 +790,155 @@
   let chatEventSource = null;
   let chatStepCancel = null;
   let streamingBubble = null;
+  let chatLoadPromise = Promise.resolve();   // openChat 的首次历史加载 (供一键入网等自动发消息等它完成, 免被清屏抹掉)
+
+  function fmtAgo(ts) {
+    if (!ts) return '';
+    const d = Date.now() - ts;
+    if (d < 60e3) return '刚刚';
+    if (d < 3600e3) return Math.floor(d / 60e3) + ' 分钟前';
+    if (d < 86400e3) return Math.floor(d / 3600e3) + ' 小时前';
+    if (d < 7 * 86400e3) return Math.floor(d / 86400e3) + ' 天前';
+    return new Date(ts).toLocaleDateString();
+  }
+
+  // 左上角「索引」: 最近历史会话 (本机 IndexedDB 里的 sessions, 按更新时间倒序)
+  async function openIndexPanel() {
+    if ($('#index-page')) return;
+    const page = document.createElement('div');
+    page.className = 'chat-page';
+    page.id = 'index-page';
+    page.style.zIndex = '70';
+    page.innerHTML = `
+      <div class="chat-topbar">
+        <button class="icon-btn" id="index-back">←</button>
+        <div style="flex:1;font-weight:600">索引 · 最近会话</div>
+        <button class="icon-btn" id="index-settings" title="设置">⚙</button>
+      </div>
+      <div id="index-body" style="padding:12px;flex:1;min-height:0;overflow:auto">
+        <div style="font-size:12px;color:var(--text-muted)">读取最近会话…</div>
+      </div>`;
+    document.body.appendChild(page);
+    $('#index-back').addEventListener('click', () => page.remove());
+    $('#index-settings').addEventListener('click', () => { page.remove(); openSettings(); });
+
+    let snap = null;
+    try { snap = await api.get('/api/data/snapshot'); } catch (e) { snap = null; }
+    const channels = (snap && snap.channels) || [];
+    const sessions = (snap && snap.sessions) || [];
+    const byId = new Map();
+    channels.forEach((c) => byId.set(c.id, c));
+    const rows = sessions.map((s) => {
+      const msgs = s.messages || [];
+      const last = msgs[msgs.length - 1];
+      return {
+        ch: byId.get(s.channelId) || { id: s.channelId, name: '（会话已删除）' },
+        updatedAt: s.updatedAt || (last && last.ts) || 0,
+        count: msgs.length,
+        lastText: (last && last.content) || '（无消息）',
+      };
+    }).sort((a, b) => b.updatedAt - a.updatedAt);
+
+    const head = `<div style="font-size:12px;color:var(--text-muted);margin:2px 0 10px">本机智能体 ${channels.length} 个 · 有历史会话 ${rows.length} 个</div>`;
+    const list = rows.length
+      ? rows.map((r, i) => `<div class="conv-item" data-si="${i}">
+          <div class="conv-avatar">${escapeHtml(String(r.ch.name || 'A').charAt(0))}</div>
+          <div class="conv-body">
+            <div class="conv-name">${escapeHtml(String(r.ch.name || r.ch.id))}</div>
+            <div class="conv-preview">${escapeHtml(String(r.lastText).slice(0, 40))}</div>
+          </div>
+          <span style="font-size:11px;color:var(--text-muted);text-align:right;flex:0 0 auto">${escapeHtml(fmtAgo(r.updatedAt))}<br>${r.count} 条</span>
+        </div>`).join('')
+      : '<div style="padding:24px;text-align:center;color:var(--text-muted)">还没有历史会话<br><span style="font-size:12px">从下面的 ＋ 新建一个智能体开始</span></div>';
+    const body = $('#index-body');
+    if (body) {
+      body.innerHTML = head + list;
+      body.querySelectorAll('[data-si]').forEach((el) => el.addEventListener('click', () => {
+        const r = rows[Number(el.dataset.si)];
+        page.remove();
+        openChat(r.ch);
+      }));
+    }
+  }
+
+  // 右上角「搜索」: 本机智能体 + 好友 + 全局智能体 (协议发现) 一起搜
+  async function openSearch() {
+    if ($('#search-page')) return;
+    const page = document.createElement('div');
+    page.className = 'chat-page';
+    page.id = 'search-page';
+    page.style.zIndex = '70';
+    page.innerHTML = `
+      <div class="chat-topbar">
+        <button class="icon-btn" id="search-back">←</button>
+        <div style="flex:1;font-weight:600">搜索</div>
+      </div>
+      <div style="padding:12px;display:flex;flex-direction:column;gap:10px;flex:1;min-height:0">
+        <input id="search-input" type="search" autocomplete="off" placeholder="搜智能体 / 好友：名称、DID、节点 ID"
+          style="padding:10px 12px;border:1px solid var(--border);border-radius:10px;background:var(--bg-hover);color:var(--text);font-size:14px">
+        <div id="search-hint" style="font-size:12px;color:var(--text-muted)">正在建立索引…</div>
+        <div id="search-results" style="flex:1;overflow:auto;-webkit-overflow-scrolling:touch"></div>
+      </div>`;
+    document.body.appendChild(page);
+    $('#search-back').addEventListener('click', () => page.remove());
+
+    let channels = []; let peers = []; let services = [];
+    try { channels = (await api.get('/channels')) || []; } catch (e) { channels = []; }
+    try { const p = await api.get('/api/peers'); peers = Array.isArray(p) ? p : ((p && p.peers) || []); } catch (e) { peers = []; }
+    try { const d = await api.get('/api/social/discover'); services = (d && d.services) || []; } catch (e) { services = []; }
+
+    const rows = [
+      ...channels.map((c) => ({
+        tag: '本机智能体', name: c.name || c.agentId || c.id, sub: c.id || '',
+        hay: [c.name, c.id, c.agentId, c.did, c.description].filter(Boolean).join(' '),
+        act: () => { page.remove(); openChat(c); },
+      })),
+      ...peers.map((p) => ({
+        tag: '好友', name: p.name || String(p.publicKey || p.id || '好友').slice(0, 12),
+        sub: String(p.publicKey || p.id || p.address || '').slice(0, 28),
+        hay: [p.name, p.publicKey, p.id, p.address, p.did].filter(Boolean).join(' '),
+        act: () => alert(`好友信息\n名称: ${p.name || '(未命名)'}\n节点ID: ${p.publicKey || p.id || '—'}\n地址: ${p.address || '—'}`),
+      })),
+      ...services.map((s) => ({
+        tag: '全局智能体',
+        name: (s.service && s.service.name) || s.name || s.agentId || 'agent',
+        sub: (s.service && s.service.description) || s.description || '',
+        hay: [(s.service && s.service.name), s.serviceName, s.name, s.agentId, s.description, s.did].filter(Boolean).join(' '),
+        act: () => { page.remove(); openTradeCall(s); },
+      })),
+    ];
+    rows.forEach((r) => { r.hay = String(r.hay || '').toLowerCase(); });
+
+    const hint = $('#search-hint');
+    const box = $('#search-results');
+    const render = (q) => {
+      const k = String(q || '').trim().toLowerCase();
+      const hits = rows.filter((r) => !k || r.hay.includes(k) || r.name.toLowerCase().includes(k));
+      if (hint) hint.innerHTML = `本机智能体 ${channels.length} · 好友 ${peers.length} · 全局智能体 ${services.length}` + (k ? ` · 命中 ${hits.length}` : '');
+      if (!box) return;
+      if (!hits.length) {
+        box.innerHTML = `<div style="padding:24px;text-align:center;color:var(--text-muted);font-size:13px">没有匹配「${escapeHtml(String(q))}」的智能体或好友</div>`;
+        return;
+      }
+      let html = '';
+      let lastTag = '';
+      hits.forEach((r, i) => {
+        if (r.tag !== lastTag) { html += `<div class="section-label">${escapeHtml(r.tag)}</div>`; lastTag = r.tag; }
+        html += `<div class="conv-item" data-ri="${i}">
+          <div class="conv-avatar">${escapeHtml(String(r.name || 'A').charAt(0))}</div>
+          <div class="conv-body">
+            <div class="conv-name">${escapeHtml(String(r.name))}</div>
+            <div class="conv-preview">${escapeHtml(String(r.sub).slice(0, 48))}</div>
+          </div>
+        </div>`;
+      });
+      box.innerHTML = html;
+      box.querySelectorAll('[data-ri]').forEach((el) => el.addEventListener('click', () => hits[Number(el.dataset.ri)].act()));
+    };
+    render('');
+    const input = $('#search-input');
+    if (input) { input.addEventListener('input', () => render(input.value)); input.focus(); }
+  }
 
    function openChat(ch) {
      activeChannel = ch;
@@ -710,7 +968,7 @@
        $('#chat-send').addEventListener('click', sendChat);
        $('#chat-input').addEventListener('keydown', (e) => { if (e.key === 'Enter') sendChat(); });
        attachStepListener();
-       loadMessages();
+       chatLoadPromise = loadMessages().catch(() => {});
        openChatSse();
        window.__mobileTouch?.('chat', ch.id);
        }
@@ -1261,10 +1519,19 @@
     try { const u = await api.get('/api/desktop/url'); url = (u && u.url) || ''; } catch (e) {}
     let d = { ok: false, addrs: [], error: '' };
     try { d = await api.get('/api/network/desktop-addrs'); } catch (e) {}
+    // 2026-09-11: 可拨入地址 (/p2p-circuit) —— 手机在 WebView 里不能 listen,
+    // 向中继预约是它唯一能被别人拨入的途径。两个节点 (P2P / Helia) 都看一眼。
+    let helia = {};
+    try { helia = await api.get('/api/helia/status'); } catch (e) {}
     const conn = !!(net && net.connected);
     const peers = ((net && net.peerIds) || []).length;
     const nodeId = (net && net.nodeId) || '';
     const addrs = (d && d.addrs) || [];
+    const circuitAddrs = ((net && net.circuitAddrs) || []).length
+      ? net.circuitAddrs
+      : (((helia && helia.circuitAddrs) || []));
+    const relays = ((net && net.relays) || []).length ? net.relays : (((helia && helia.relays) || []));
+    const relayRes = ((net && net.relayReservations) || []).find((r) => r && !r.ok);
     const row = (k, v, small) => `<div class="list-item"><span style="flex:1">${k}</span><span style="font-size:${small ? 11 : 13}px;color:var(--text-secondary);text-align:right;word-break:break-all;max-width:60%">${escapeHtml(v)}</span></div>`;
     let html = '';
     html += row('状态', conn ? '已启动' : '未启动');
@@ -1272,7 +1539,27 @@
     html += row('已连对端', peers + ' 个');
     html += row('电脑端', url || '未配置', true);
     if (addrs.length) html += row('可拨地址', addrs[0], true);
+    // 可拨入地址: 没有就是「暂时不能被别人拨入」, 用大白话说清原因, 不假装成功
+    html += circuitAddrs.length
+      ? row('可拨入地址', circuitAddrs[0], true)
+      : row('可拨入地址', relayRes ? ('预约失败: ' + String(relayRes.error || '').slice(0, 60)) : '无 (没有可用中继 / 还没预约上)', true);
+    if (relays.length) html += row('已预约中继', relays.length + ' 个', true);
     box.innerHTML = html;
+    // 有可拨入地址 → 给一个复制入口 (别人要用它拨你)
+    if (circuitAddrs.length) {
+      const cp = document.createElement('div');
+      cp.className = 'list-item';
+      cp.id = 'p2p-copy-circuit';
+      cp.innerHTML = `<span class="list-icon">${ICONS.globe}</span><span style="flex:1">复制可拨入地址</span>`;
+      cp.addEventListener('click', async () => {
+        try {
+          if (navigator.clipboard && navigator.clipboard.writeText) await navigator.clipboard.writeText(circuitAddrs[0]);
+          else throw new Error('无剪贴板权限');
+          showToast('已复制可拨入地址');
+        } catch (e) { showToast('复制失败: ' + ((e && e.message) || e)); }
+      });
+      box.appendChild(cp);
+    }
     // 连接/重连按钮 + 人话提示
     const btn = document.createElement('div');
     btn.className = 'list-item';
@@ -1299,6 +1586,9 @@
     hint.textContent = !url && !addrs.length
       ? '手机在 WebView 里不能自己监听端口 → 需要「拨入」至少一个节点才能进网。电脑端是**可选**的：点「添加节点地址」填任意可拨节点的 multiaddr (如 /ip4/1.2.3.4/tcp/4001/ws)，手机就能独立入网并从该节点收发服务请求。'
       : (conn ? (peers ? '已连上 ' + peers + ' 个对端，可收发消息/服务请求（手机拨入的连接是双向的，所以别人也能调用你的服务）。' : '已连上节点，等待其他对端…') : ('未连接：' + ((d && d.error) || '点「连接电脑端」或「添加节点地址」')));
+    if (conn && !circuitAddrs.length) {
+      hint.textContent += '\n「可拨入地址」还是空的 —— 手机自己不能被别人拨入，必须成功预约到中继才有。确认电脑端已开启中继 (电脑端 /api/p2p/mobile-connect 里 isRelay=true)，再点「重新连接电脑端」。';
+    }
     box.appendChild(hint);
   }
 
@@ -1419,9 +1709,10 @@
       <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-network"><span class="list-icon">${ICONS.globe}</span><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-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>
@@ -1435,7 +1726,36 @@
       const next = currentTheme === 'auto' ? 'light' : (currentTheme === 'light' ? 'dark' : 'auto');
       applyTheme(next, true);
     });
-    $('#settings-network').addEventListener('click', () => switchTab('network'));
+    // 无障碍服务: 屏幕触控 (电脑端 phone.tap / phone.swipe) 的前提 — 与 MCP/Skills 控制无关
+    $('#settings-accessibility').addEventListener('click', async () => {
+      const cap = window.Capacitor;
+      const bridge = cap && cap.Plugins && cap.Plugins.RokidBridge;
+      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'); }
+    });
+
+    // 本机数据: 直接读 IndexedDB 快照 (智能体/会话/消息都在本机, 重开 App 不会丢)
+    const dataEl = $('#settings-data');
+    if (dataEl) {
+      const subEl = dataEl.querySelector('.conv-preview');
+      void (async () => {
+        try {
+          const snap = await api.get('/api/data/snapshot');
+          const chs = (snap && snap.channels) || [];
+          const ses = (snap && snap.sessions) || [];
+          const msgs = ses.reduce((n, s) => n + ((s.messages || []).length), 0);
+          if (subEl) subEl.textContent = `已保存 ${chs.length} 个智能体 · ${ses.length} 个会话 · ${msgs} 条消息（本机 IndexedDB）`;
+        } catch (e) { if (subEl) subEl.textContent = '读取失败: ' + ((e && e.message) || e); }
+      })();
+      dataEl.addEventListener('click', () => {
+        const sp = $('#settings-page'); if (sp) sp.remove();
+        void openIndexPanel();
+      });
+    }
     $('#settings-desktop').addEventListener('click', openDesktopSync);
     // 本机卡片显示开关 (移除后从这里恢复)
     const drawSelfCardToggle = () => {
@@ -1461,14 +1781,25 @@
   }
 
   // === API 配置 (LLM 供应商) ===
-  const LLM_PROVIDERS = ['deepseek', 'openai', 'anthropic', 'minimax', 'openrouter', '自定义'];
-  const LLM_DEFAULTS = {
-    deepseek: { baseUrl: 'https://api.deepseek.com/v1', model: 'deepseek-chat' },
-    openai: { baseUrl: 'https://api.openai.com/v1', model: 'gpt-4o-mini' },
-    anthropic: { baseUrl: 'https://api.anthropic.com/v1', model: 'claude-3-5-sonnet-latest' },
-    minimax: { baseUrl: 'https://api.minimax.chat/v1', model: 'MiniMax-M2.7' },
-    openrouter: { baseUrl: 'https://openrouter.ai/api/v1', model: 'openai/gpt-4o-mini' },
-  };
+  // 注意: 手机端 RemoteLlm 走 OpenAI 兼容协议 (baseUrl + /chat/completions) —— 新增 provider 必须是
+  // OpenAI 兼容端点 (gemini 用 /v1beta/openai, 智谱 v4 / dashscope compatible-mode 都兼容)。
+  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' },
+    { id: 'anthropic', label: 'Anthropic', baseUrl: 'https://api.anthropic.com/v1', model: 'claude-3-5-sonnet-latest' },
+    { id: 'gemini', label: 'Gemini', baseUrl: 'https://generativelanguage.googleapis.com/v1beta/openai', model: 'gemini-3.5-flash' },
+    { id: 'xai', label: 'Grok', baseUrl: 'https://api.x.ai/v1', model: 'grok-2-latest' },
+    { id: 'qwen', label: '通义千问', baseUrl: 'https://dashscope.aliyuncs.com/compatible-mode/v1', model: 'qwen-plus' },
+    { id: 'zhipu', label: '智谱 GLM', baseUrl: 'https://open.bigmodel.cn/api/paas/v4', model: 'glm-4-plus' },
+    { id: 'moonshot', label: 'Kimi', baseUrl: 'https://api.moonshot.cn/v1', model: 'moonshot-v1-8k' },
+    { id: 'minimax', label: 'MiniMax', baseUrl: 'https://api.minimax.chat/v1', model: 'MiniMax-M2.7' },
+    { id: 'siliconflow', label: '硅基流动', baseUrl: 'https://api.siliconflow.cn/v1', model: 'deepseek-ai/DeepSeek-V3' },
+    { id: 'groq', label: 'Groq', baseUrl: 'https://api.groq.com/openai/v1', model: 'llama-3.3-70b-versatile' },
+    { id: 'openrouter', label: 'OpenRouter', baseUrl: 'https://openrouter.ai/api/v1', model: 'openai/gpt-4o-mini' },
+    { id: 'ollama', label: '本地 Ollama', baseUrl: 'http://localhost:11434/v1', model: 'qwen2.5:7b' },
+    { id: 'custom', label: '自定义', baseUrl: '', model: '' },
+  ];
+  const LLM_BY_ID = LLM_PROVIDERS.reduce((m, p) => (m[p.id] = p, m), {});
   async function openApiConfig() {
     let cfg;
     try { cfg = await api.get('/api/llm-config'); } catch { cfg = null; }
@@ -1484,10 +1815,11 @@
         <div style="flex:1;font-weight:600">API 配置</div>
       </div>
       <div style="padding:12px;display:flex;flex-direction:column;gap:12px">
-        <label style="font-size:13px;color:var(--text-secondary)">供应商</label>
-        <select id="api-provider" style="padding:10px;border:1px solid var(--border);border-radius:8px;background:var(--bg-hover);color:var(--text)">
-          ${LLM_PROVIDERS.map((p) => `<option value="${p}" ${p === provider ? 'selected' : ''}>${p}</option>`).join('')}
-        </select>
+        <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>
+        <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>
@@ -1498,15 +1830,37 @@
       </div>`;
     document.body.appendChild(page);
     $('#api-config-back').addEventListener('click', () => page.remove());
-    const provSel = $('#api-provider');
-    provSel.addEventListener('change', () => {
-      const p = provSel.value;
-      const d = LLM_DEFAULTS[p];
-      if (d) { $('#api-baseurl').value = d.baseUrl; $('#api-model').value = d.model; }
-      if (p === '自定义') { $('#api-baseurl').value = ''; $('#api-model').value = ''; $('#api-key').value = ''; }
+    // 供应商选择: 芯片式 (原来是一个原生 select, 小屏上难点、也看不出有哪些可选)
+    let picked = LLM_BY_ID[provider] ? provider : 'deepseek';
+    const fillFrom = (id) => {
+      const saved = (cfg.providers && cfg.providers[id]) || {};
+      const d = LLM_BY_ID[id] || {};
+      $('#api-baseurl').value = saved.baseUrl || d.baseUrl || '';
+      $('#api-model').value = saved.model || d.model || '';
+      $('#api-key').value = saved.apiKey || '';
+      const hint = $('#api-hint');
+      if (hint) {
+        hint.textContent = id === 'custom'
+          ? '自定义: 填任意 OpenAI 兼容的 baseUrl (/chat/completions)'
+          : (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) => {
+      const b = e.target.closest && e.target.closest('.provider-chip');
+      if (!b) return;
+      picked = b.dataset.provider;
+      paintChips();
+      fillFrom(picked);
     });
+    fillFrom(picked);
     $('#api-save').addEventListener('click', async () => {
-      const p = provSel.value === '自定义' ? 'custom' : provSel.value;
+      const p = picked;
       const next = (cfg && cfg.providers) ? cfg : { activeProvider: cfg.activeProvider, providers: {}, updatedAt: Date.now() };
       next.activeProvider = p;
       next.providers[p] = Object.assign({}, (next.providers[p] || {}), {
@@ -1702,6 +2056,38 @@
   function showSheet(id) { const s = $(id); if (s) s.hidden = false; }
   function hideSheet(id) { const s = $(id); if (s) s.hidden = true; }
 
+  /**
+   * 一键入网 (全球智能体网络): 把默认 prompt 发给智能体, 由它读网关入网说明并执行入网。
+   * 人类只点一下 — 没有可用会话时先建一个 (与"新建会话"同一条路径)。
+   */
+  async function joinGlobalNetwork() {
+    showToast('正在加入全球智能体网络…');
+    try {
+      let ch = activeChannel;
+      if (!ch) {
+        let channels = [];
+        try { channels = await api.get('/channels'); } catch { channels = []; }
+        ch = (Array.isArray(channels) && channels[0]) || null;
+        if (!ch) {
+          await api.post('/api/channels/create', {});
+          await new Promise((r) => setTimeout(r, 700));
+          channels = await api.get('/channels').catch(() => []);
+          ch = (Array.isArray(channels) && channels[0]) || null;
+        }
+      }
+      if (!ch) { showToast('没有可用会话: 先在电脑端连上你的智能体'); return; }
+      openChat(ch);
+      await chatLoadPromise;   // 等首次历史加载完成再发, 免得用户气泡被清屏抹掉
+      const input = $('#chat-input');
+      if (!input) return;
+      input.value = DEFAULT_JOIN_PROMPT;
+      await sendChat();
+      showToast('入网指令已交给智能体');
+    } catch (e) {
+      showToast('入网失败: ' + ((e && e.message) || e));
+    }
+  }
+
   // 创建智能体: 无输入框, 底部滑入加载 sheet, 完成后滑出
   async function createSession() {
     showSheet('#create-sheet');
@@ -1808,11 +2194,13 @@
       try { await api.post('/api/auth/logout', {}); await loadMe(); } catch (e) { alert('注销失败: ' + (e.message || e)); }
     });
     $('#btn-add').addEventListener('click', addFriend);
+    const bIdx = $('#btn-index'); if (bIdx) bIdx.addEventListener('click', () => void openIndexPanel());
+    const bSearch = $('#btn-search'); if (bSearch) bSearch.addEventListener('click', () => void openSearch());
     const cs = $('#btn-create-session'); if (cs) cs.addEventListener('click', createSession);
     const csScan = $('#choice-scan'); if (csScan) csScan.addEventListener('click', addFriendScan);
     const csMan = $('#choice-manual'); if (csMan) csMan.addEventListener('click', addFriendManual);
     const csCan = $('#choice-cancel'); if (csCan) csCan.addEventListener('click', () => hideSheet('#addfriend-sheet'));
-    $('#item-p2p').addEventListener('click', () => { switchTab('network'); });
+    $('#item-p2p').addEventListener('click', () => { switchTab('friends'); void loadContacts(); });
     const itTrade = $('#item-trade');
     if (itTrade) itTrade.addEventListener('click', async () => {
       await loadAgentServices();
@@ -1823,17 +2211,47 @@
       try { const net = await api.get('/api/network/status'); const p2p = net && net.nodeId; alert('P2P ID (通信ID, ≠ DID):\n' + (p2p || '未连接')); }
       catch (e) { alert('P2P ID: 获取失败'); }
     });
-    // #2 极简入网按钮: 粘贴/输入链接 → BolloonCore.gateway.join (懒加载 mobile-gateway)
+    // #1 一键入网 (全球智能体网络): 点一下 → 默认 prompt 交给智能体执行
+    const joinGlobalBtn = $('#item-join-global');
+    if (joinGlobalBtn) joinGlobalBtn.addEventListener('click', () => { void joinGlobalNetwork(); });
+
+    // #2 加入网络 (点按式): sheet → [附近的电脑/设备] [扫电脑上的二维码] [粘贴链接兜底]
     const joinNetBtn = $('#item-join-net');
-    if (joinNetBtn) joinNetBtn.addEventListener('click', async () => {
-      const link = (window.prompt && window.prompt('粘贴网络链接\n(orbitdb://  ipns://  https://.../registry)') || '').trim();
-      if (!link) return;
-      try {
-        const r = await (window.BolloonCore && window.BolloonCore.gateway && window.BolloonCore.gateway.join(link));
-        alert(r ? (r.output || '已处理') : 'BolloonCore.gateway 不可用');
-      } catch (e) { alert('加入失败: ' + String((e && e.message) || e).slice(0, 120)); }
-      loadNetMembers();
+    if (joinNetBtn) joinNetBtn.addEventListener('click', () => showSheet('#network-sheet'));
+    const cJoinNearby = $('#choice-join-nearby');
+    if (cJoinNearby) cJoinNearby.addEventListener('click', () => { hideSheet('#network-sheet'); openNearbySheet('join'); });
+    const cJoinScan = $('#choice-join-scan');
+    if (cJoinScan) cJoinScan.addEventListener('click', () => {
+      hideSheet('#network-sheet'); _qrMode = 'join';
+      const inp = $('#qr-scan-input'); if (inp) inp.click();
     });
+    const cJoinManual = $('#choice-join-manual');
+    if (cJoinManual) cJoinManual.addEventListener('click', () => { hideSheet('#network-sheet'); joinNetworkManual(); });
+    const cJoinCancel = $('#choice-join-cancel');
+    if (cJoinCancel) cJoinCancel.addEventListener('click', () => hideSheet('#network-sheet'));
+
+    // #2b 连接好友 (点按式) + 附近设备 + 待处理申请
+    const addFriendBtn = $('#item-add-friend');
+    if (addFriendBtn) addFriendBtn.addEventListener('click', () => showSheet('#addfriend-sheet'));
+    const cNearby = $('#choice-nearby');
+    if (cNearby) cNearby.addEventListener('click', () => { hideSheet('#addfriend-sheet'); openNearbySheet('friend'); });
+    const cRequests = $('#choice-requests');
+    if (cRequests) cRequests.addEventListener('click', () => { hideSheet('#addfriend-sheet'); openRequestsSheet(); });
+    const nearbyBtn = $('#item-nearby');
+    if (nearbyBtn) nearbyBtn.addEventListener('click', () => openNearbySheet('friend'));
+    const nearbyRefresh = $('#nearby-refresh');
+    if (nearbyRefresh) nearbyRefresh.addEventListener('click', () => loadNearbyList(_nearbyMode));
+    const nearbyClose = $('#nearby-close');
+    if (nearbyClose) nearbyClose.addEventListener('click', () => hideSheet('#nearby-sheet'));
+    // 微信息 (x402 付费信息): 详情 → 购买并验真 / 只看元数据
+    const x402Buy = $('#x402-buy');
+    if (x402Buy) x402Buy.addEventListener('click', () => buyX402Info());
+    const x402VerifyBtn = $('#x402-verify');
+    if (x402VerifyBtn) x402VerifyBtn.addEventListener('click', () => verifyX402Info());
+    const x402Close = $('#x402-close');
+    if (x402Close) x402Close.addEventListener('click', () => hideSheet('#x402-sheet'));
+    const x402ResultClose = $('#x402-result-close');
+    if (x402ResultClose) x402ResultClose.addEventListener('click', () => hideSheet('#x402-result-sheet'));
     // #3 扫码入网: 拍照/选图 → BolloonCore.qr.decode(jsQR) → gateway.join (免原生插件)
     const scanBtn = $('#item-scan-net');
     const scanInput = $('#qr-scan-input');
@@ -1878,6 +2296,370 @@
     });
   }
 
+  // ==================== 点按式联网 / 加好友 (2026-09-13) ====================
+  // 人类手机习惯: 点按钮选一条, 而不是粘贴网址。粘贴/手动输入只作兜底放在最下面。
+  let _nearbyMode = 'friend';   // 'join' = 加入网络 | 'friend' = 连接好友
+
+  /** 电脑端基地址 (未配置 → 空字符串, 走本机能力) */
+  async function desktopBaseUrl() {
+    try {
+      const u = await (window.BolloonCore && window.BolloonCore.desktop && window.BolloonCore.desktop.url && window.BolloonCore.desktop.url());
+      // BolloonCore.desktop.url() 返回 { url }, 但也兼容直接返回字符串的实现 —
+      // 直接 String(对象) 会得到 "[object Object]"，转发全部静默失败 (2026-09-13 修)
+      const raw = (u && typeof u === 'object') ? (u.url || u.baseUrl || '') : u;
+      return String(raw || '').replace(/\/+$/, '');
+    } catch (e) { return ''; }
+  }
+
+  /** 转发到电脑端 HTTP (手机自足模式下拿不到就返回 null, 不假装成功) */
+  async function desktopFetch(path, body) {
+    const base = await desktopBaseUrl();
+    if (!base) return null;
+    try {
+      const res = await fetch(base + path, body
+        ? { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) }
+        : undefined);
+      if (!res.ok) return null;
+      return await res.json();
+    } catch (e) { return null; }
+  }
+
+  /** 加入网络 · 手动粘贴 (兜底入口, 从 sheet 底部小字进来) */
+  async function joinNetworkManual() {
+    const link = (window.prompt && window.prompt('粘贴网络链接\n(orbitdb://  ipns://  https://.../registry)') || '').trim();
+    if (!link) return;
+    try {
+      const r = await (window.BolloonCore && window.BolloonCore.gateway && window.BolloonCore.gateway.join(link));
+      alert(r ? (r.output || '已处理') : 'BolloonCore.gateway 不可用');
+    } catch (e) { alert('加入失败: ' + String((e && e.message) || e).slice(0, 120)); }
+    loadNetMembers();
+  }
+
+  function openNearbySheet(mode) {
+    _nearbyMode = mode;
+    const t = $('#nearby-title');
+    if (t) t.textContent = mode === 'join' ? '附近的电脑 / 设备' : '附近的设备';
+    showSheet('#nearby-sheet');
+    loadNearbyList(mode);
+  }
+
+  /** 扫一遍"附近": 电脑端 (同一 Wi-Fi) + 已连通的 P2P 设备 (+ 待处理申请) */
+  async function loadNearbyList(mode) {
+    const list = $('#nearby-list');
+    const hint = $('#nearby-hint');
+    if (!list) return;
+    list.innerHTML = '';
+    if (hint) hint.textContent = '正在查找...';
+    const rows = [];
+    try {
+      const addrs = await (window.BolloonCore && window.BolloonCore.network && window.BolloonCore.network.desktopAddrs());
+      const base = await desktopBaseUrl();
+      const firstAddr = (addrs && Array.isArray(addrs.addrs) && addrs.addrs[0]) || '';
+      if (base || firstAddr) {
+        rows.push({
+          icon: '🖥️',
+          title: '电脑端' + (addrs && addrs.peerId ? ' · ' + String(addrs.peerId).slice(0, 8) : ''),
+          sub: base || firstAddr,
+          kind: 'desktop',
+        });
+      }
+    } catch (e) { /* 电脑端不可达 */ }
+    try {
+      const peers = await api.get('/api/peers');
+      for (const p of (peers || [])) {
+        const key = p.publicKey || p.id || '';
+        rows.push({
+          icon: '📱',
+          title: p.name || String(key).slice(0, 12) || '设备',
+          sub: '已连通 · ' + String(key).slice(0, 16),
+          kind: 'peer',
+          key,
+        });
+      }
+    } catch (e) { /* 无对端 */ }
+    if (mode === 'friend') {
+      const fr = await desktopFetch('/api/friend-requests');
+      if (fr && fr.count > 0) {
+        rows.push({ icon: '📋', title: `待处理好友申请 ${fr.count} 个`, sub: '点一下处理', kind: 'requests' });
+      }
+    }
+    if (hint) hint.textContent = rows.length ? '点一条即操作' : '没找到设备 — 让电脑端开着 (同一 Wi-Fi), 或扫电脑上的二维码';
+    if (rows.length === 0) { list.innerHTML = '<div class="list-item">（暂无）</div>'; return; }
+    for (const r of rows) {
+      const el = document.createElement('div');
+      el.className = 'list-item';
+      el.innerHTML = `<span class="list-icon">${r.icon}</span><span><div>${escapeHtml(r.title)}</div><div style="font-size:12px;color:var(--text-muted)">${escapeHtml(r.sub || '')}</div></span><span class="list-arrow">›</span>`;
+      el.addEventListener('click', () => onNearbyTap(r, mode));
+      list.appendChild(el);
+    }
+  }
+
+  async function onNearbyTap(row, mode) {
+    if (row.kind === 'requests') { hideSheet('#nearby-sheet'); return openRequestsSheet(); }
+    if (row.kind === 'desktop') {
+      try {
+        const r = await (window.BolloonCore && window.BolloonCore.network && window.BolloonCore.network.connect());
+        const bad = r && r.ok === false;
+        alert(bad ? ('连接电脑端失败: ' + String(r.error || '').slice(0, 100)) : '已连接电脑端 (数据/网络开始同步)');
+        if (!bad && mode === 'join') {
+          try { await (window.BolloonCore.desktop && window.BolloonCore.desktop.sync && window.BolloonCore.desktop.sync()); } catch (e) {}
+        }
+        loadNetMembers(); loadP2PStatus();
+      } catch (e) { alert('连接失败: ' + String((e && e.message) || e).slice(0, 120)); }
+      return;
+    }
+    if (row.kind === 'peer') {
+      if (mode !== 'friend') { alert('这个设备已经和本机连通了。'); return; }
+      let me = '手机端用户';
+      try { const s = await api.get('/api/auth/status'); if (s && s.name) me = s.name; } catch (e) {}
+      const sent = await desktopFetch('/api/friend-request', { targetPublicKey: row.key, name: me, message: '手机端请求加好友' });
+      alert(sent ? '已发出好友申请' : '本机已记录该设备; 需要电脑端在线才能把申请发出去');
+    }
+  }
+
+  /** 待处理好友申请: 点一条 → 通过 (取消 = 忽略) */
+  async function openRequestsSheet() {
+    const t = $('#nearby-title'); if (t) t.textContent = '待处理好友申请';
+    showSheet('#nearby-sheet');
+    const list = $('#nearby-list'); const hint = $('#nearby-hint');
+    if (!list) return;
+    list.innerHTML = '';
+    if (hint) hint.textContent = '正在读取...';
+    const fr = await desktopFetch('/api/friend-requests');
+    if (!fr || !fr.requests || fr.requests.length === 0) {
+      if (hint) hint.textContent = fr ? '没有待处理申请' : '需要电脑端在线 (设置里填桌面地址) 才能读取';
+      list.innerHTML = '<div class="list-item">（空）</div>';
+      return;
+    }
+    if (hint) hint.textContent = '点一条 = 通过 · 取消 = 忽略';
+    for (const r of fr.requests) {
+      const el = document.createElement('div');
+      el.className = 'list-item';
+      el.innerHTML = `<span class="list-icon">👤</span><span><div>${escapeHtml(r.fromName || '陌生人')}</div><div style="font-size:12px;color:var(--text-muted)">${escapeHtml(r.note || r.message || '(无备注)')}</div></span>`;
+      el.addEventListener('click', async () => {
+        const ok = window.confirm(`通过 ${r.fromName || '对方'} 的好友申请?\n\n确定 = 通过并加为好友\n取消 = 忽略这条申请`);
+        if (ok) {
+          const acc = await desktopFetch('/api/friend-accept', { fromPublicKey: r.fromPublicKey, name: r.fromName, requestId: r.requestId });
+          alert(acc ? '已加为好友' : '通过失败 — 检查电脑端是否在线');
+        } else {
+          const ig = await desktopFetch('/api/friend-requests/ignore', { requestId: r.requestId });
+          alert(ig ? '已忽略' : '忽略失败 — 检查电脑端是否在线');
+        }
+        hideSheet('#nearby-sheet');
+        if (typeof loadContacts === 'function') loadContacts();
+      });
+      list.appendChild(el);
+    }
+  }
+
+  // ==================== 微信息 (x402 付费信息, 2026-09-13) ====================
+  // 人类手机操作: 浏览 → 点一条看详情 (价格/类别/哈希/来源) → 「购买并验真」→ 内容 + 验真分档。
+  // 安全边界 (**不能破**): 手机端不持 EVM 私钥, 付款一律经电脑端 /api/x402/info/buy 代付;
+  //   没配桌面地址 / 电脑端不可达 → 说人话提示, 绝不假装成功、绝不自己造数据。
+  let _x402Cache = [];        // 最近一次列表 (行点击按 id 找回)
+  let _x402Current = null;    // 详情 sheet 当前对应的 item
+
+  /** 售卖端点 (付费取内容): <桌面基址>/api/x402/info/<id> */
+  async function x402SellUrl(id) {
+    const base = await desktopBaseUrl();
+    return base ? base + '/api/x402/info/' + encodeURIComponent(String(id || '')) : '';
+  }
+
+  /**
+   * 转发到电脑端并**保留后端错误原文** (购买失败要如实显示 "需要钱包私钥"/"facilitator 不可达",
+   * 而 desktopFetch 失败时只回 null 会丢掉原因)。基地址仍走 desktopBaseUrl(), 不另起一套。
+   */
+  async function desktopPostRaw(path, body) {
+    const base = await desktopBaseUrl();
+    if (!base) return { ok: false, error: '需要电脑端在线 (设置里填桌面地址)' };
+    try {
+      const res = await fetch(base + path, {
+        method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body || {}),
+      });
+      let data = null;
+      try { data = await res.json(); } catch (e) { data = null; }
+      if (!res.ok) {
+        return { ok: false, status: res.status, error: (data && (data.error || data.message)) || ('电脑端返回 ' + res.status), data };
+      }
+      return data || { ok: false, error: '电脑端返回空响应' };
+    } catch (e) {
+      return { ok: false, error: '电脑端不可达: ' + String((e && e.message) || e).slice(0, 120) };
+    }
+  }
+
+  /** 离线能核对的部分 (全部来自免费元数据, 不含内容本体) */
+  function x402MetaLines(item) {
+    const it = item || {};
+    const p = it.price || {};
+    const src = it.source || {};
+    const refs = Array.isArray(src.refs) ? src.refs : [];
+    const lines = [
+      `价格: ${p.amount || '0'} ${p.currency || ''} (网络 ${p.network || '未声明'})`,
+      `类别: ${it.category || 'other'}`,
+      `提供方: ${(it.provider && (it.provider.name || '未命名')) || '未知'} · ${String((it.provider && it.provider.did) || '').slice(0, 28)}${(it.provider && it.provider.did && String(it.provider.did).length > 28) ? '…' : ''}`,
+      `内容哈希: ${it.contentHash || '(无)'}`,
+      `来源声明: ${src.kind || '未声明'}${refs.length ? ' · 引用 ' + refs.length + ' 条' : ' · 无引用'}`,
+    ];
+    for (const r of refs) lines.push('  · ' + String(r));
+    if (src.note) lines.push(`来源备注: ${src.note}`);
+    if (it.description) lines.push(`说明: ${it.description}`);
+    lines.push('', '付款由电脑端代付 (手机端不拿私钥)');
+    return lines;
+  }
+
+  /** 拉列表: 有数据 / 桌面不可达 / 空列表 三种情况都给人话 */
+  async function loadX402Info() {
+    const list = $('#x402-info-list');
+    if (!list) return;
+    list.innerHTML = '<div class="list-item">正在读取微信息...</div>';
+    const base = await desktopBaseUrl();
+    const r = base ? await desktopFetch('/api/x402/info') : null;
+    if (!r || r.note === 'desktop-unreachable') {
+      // (b) 桌面不可达: 手机端不持私钥, 浏览/代付都只能靠电脑端 — 直接说, 不假装有数据
+      _x402Cache = [];
+      list.innerHTML = '<div class="list-item">需要电脑端在线 (设置里填桌面地址)</div>';
+      return;
+    }
+    const items = Array.isArray(r.items) ? r.items : [];
+    _x402Cache = items;
+    if (items.length === 0) {
+      // (c) 电脑端在线但没发布过
+      list.innerHTML = '<div class="list-item">电脑端还没发布任何付费信息</div>';
+      return;
+    }
+    // (a) 有数据 → 每条一行: 标题 + 价格 + 类别 + 提供方
+    list.innerHTML = '';
+    for (const it of items) {
+      const p = it.price || {};
+      const amount = p.amount ? `${p.amount} ${p.currency || ''}`.trim() : '免费';
+      const provName = (it.provider && (it.provider.name || it.provider.did)) || '未知提供方';
+      const el = document.createElement('div');
+      el.className = 'list-item';
+      el.innerHTML = `<span class="list-icon">💰</span><span><div>${escapeHtml(it.title || '(无标题)')}</div>` +
+        `<div style="font-size:12px;color:var(--text-muted)">${escapeHtml(amount)} · ${escapeHtml(it.category || 'other')} · ${escapeHtml(String(provName).slice(0, 20))}</div></span>` +
+        `<span class="list-arrow">›</span>`;
+      el.addEventListener('click', () => openX402Sheet(it));
+      list.appendChild(el);
+    }
+  }
+
+  /** 点一条 → 详情 sheet (价格/网络/类别/提供方 DID 前缀/内容哈希/来源) */
+  function openX402Sheet(item) {
+    if (!item) return;
+    _x402Current = item;
+    const t = $('#x402-title');
+    if (t) t.textContent = item.title || '微信息';
+    const body = $('#x402-body');
+    if (body) body.textContent = x402MetaLines(item).join('\n');
+    const buy = $('#x402-buy');
+    if (buy) { buy.disabled = false; buy.textContent = '购买并验真'; }
+    showSheet('#x402-sheet');
+  }
+
+  /** 结果 sheet: 内容 + 验真结论 (纯文本渲染, 不用 innerHTML) */
+  function showX402Result(title, text) {
+    const t = $('#x402-result-title');
+    if (t) t.textContent = title || '验真结果';
+    const b = $('#x402-result-body');
+    if (b) b.textContent = String(text || '');
+    showSheet('#x402-result-sheet');
+  }
+
+  /** 购买并验真: 一律转发电脑端代付 (手机端不签名, 不持 EVM 私钥) */
+  async function buyX402Info() {
+    const item = _x402Current;
+    if (!item) return;
+    const btn = $('#x402-buy');
+    const base = await desktopBaseUrl();
+    if (!base) {
+      alert('需要电脑端在线 (设置里填桌面地址) — 付款只能由电脑端代付, 手机端不保存私钥');
+      return;
+    }
+    const sellUrl = base + '/api/x402/info/' + encodeURIComponent(String(item.id || ''));
+    // 上限 = 标价上浮 20% (防挂单涨价); 标价读不到就不传上限
+    const amt = Number((item.price || {}).amount);
+    const maxPayment = Number.isFinite(amt) && amt > 0 ? String(Number((amt * 1.2).toFixed(8))) : undefined;
+    if (btn) { btn.disabled = true; btn.textContent = '付款中...'; }
+    try {
+      const r = await desktopPostRaw('/api/x402/info/buy', {
+        url: sellUrl,
+        ...(maxPayment ? { maxPayment } : {}),
+        allowLocalDev: true,
+      });
+      if (!r || r.ok !== true) {
+        // 如实转述后端原因 (缺私钥 / facilitator 不可达 / 电脑端不可达), 不吞错
+        alert('购买失败: ' + ((r && r.error) || '电脑端不可达 (检查设置里的桌面地址)'));
+        return;
+      }
+      const content = String(r.content || '');
+      const lines = [
+        r.verifySummary || ((r.verify && r.verify.trust) ? '验真档: ' + r.verify.trust : '后端未给验真结论'),
+        r.payment ? `支付模式: ${r.payment.mode || '?'}${r.payment.txHash ? ' · tx ' + String(r.payment.txHash).slice(0, 24) : ''}` : '',
+        `内容哈希: ${(r.item && r.item.contentHash) || item.contentHash || '?'}`,
+        `内容长度: ${content.length} 字`,
+        '',
+        '—— 内容 (前 2000 字) ——',
+        content.slice(0, 2000) + (content.length > 2000 ? '\n…(已截断)' : ''),
+      ].filter((x) => x !== '');
+      showX402Result('已购买并验真', lines.join('\n'));
+    } catch (e) {
+      alert('购买失败: ' + String((e && e.message) || e).slice(0, 160));
+    } finally {
+      if (btn) { btn.disabled = false; btn.textContent = '购买并验真'; }
+    }
+  }
+
+  /** 只看元数据 / 离线验真: 没付款就没有信封 → 明说还差什么, 不谎称"验真通过" */
+  async function verifyX402Info() {
+    const item = _x402Current;
+    if (!item) return;
+    const btn = $('#x402-verify');
+    const meta = x402MetaLines(item);
+    const sellUrl = await x402SellUrl(item.id);
+    if (!sellUrl) {
+      showX402Result('离线查看元数据', meta.join('\n') + '\n\n没配桌面地址 → 拿不到签名信封, 无法验真。');
+      return;
+    }
+    if (btn) { btn.disabled = true; btn.textContent = '核对中...'; }
+    try {
+      const r = await desktopPostRaw('/api/x402/info/verify', { envelope: null, url: sellUrl });
+      // 注意: 后端 verify 的 ok = "信封验真是否通过", 不是 "HTTP 是否成功" —
+      //   只要拿到 report 就是一次成功的请求, 不能把 report.ok=false 当成"电脑端不可达"
+      const report = r && r.report ? r.report : null;
+      if (!report) {
+        showX402Result('还不能验真', ((r && r.error) || '电脑端不可达') + '\n\n离线可核对的:\n' + meta.join('\n'));
+        return;
+      }
+      const checks = Array.isArray(report.checks) ? report.checks : [];
+      // 没付款时后端拿到的是 402 的付款要求 (不是信封) → 报告必然是 unverified; 如实说明原因
+      const noEnvelope = report.trust === 'unverified' && !checks.some((c) => c.name === 'provider-signature' && c.ok);
+      if (noEnvelope) {
+        const p = item.price || {};
+        showX402Result('只看元数据 (还没付款)', [
+          '电脑端返回 402 付款要求 → 还没付款就拿不到签名信封, 此时无法验真。',
+          `付款要求 (来自元数据): ${p.amount || '0'} ${p.currency || ''} → ${String(p.payTo || '').slice(0, 20)}… (${p.network || '未声明'})`,
+          '',
+          '离线可核对的 (免费元数据):',
+          ...meta,
+          '',
+          '点「购买并验真」由电脑端代付后, 才能拿到信封做分档验真。',
+        ].join('\n'));
+        return;
+      }
+      showX402Result('验真结果', [
+        r.summary || ('验真档: ' + (report.trust || '?')),
+        report.warnings && report.warnings.length ? '提示: ' + report.warnings.join('; ') : '',
+        '',
+        '逐项检查:',
+        ...checks.map((c) => `${c.ok ? '✅' : '❌'} ${c.name}: ${c.detail}`),
+      ].filter((x) => x !== '').join('\n'));
+    } catch (e) {
+      showX402Result('核对失败', String((e && e.message) || e).slice(0, 200));
+    } finally {
+      if (btn) { btn.disabled = false; btn.textContent = '只看元数据 (离线验真)'; }
+    }
+  }
+
   async function loadNetMembers() {
     const el = $('#net-members');
     if (!el) return;
@@ -1901,7 +2683,7 @@
       if (!msg || msg.type !== 'ui' || !msg.action) return;
       const d = msg.data || {};
       switch (msg.action) {
-        case 'switchTab': if (d.tab && ['main', 'network', 'me'].includes(d.tab)) switchTab(d.tab); break;
+        case 'switchTab': if (d.tab && ['main', 'friends', 'network', 'me'].includes(d.tab)) switchTab(d.tab); break;
         case 'openSettings': openSettings(); break;
         case 'showToast': alert(d.message || ''); break;
         case 'goBack': closeCardDetail(); closeChat(); break;
@@ -1987,11 +2769,85 @@
     } catch (e) {}
   }
 
+  // === 手势 (2026-09-14): 滑动切 tab / 点空白关弹窗 / 右滑返回上一层 ===
+  // 优先级: 有浮层 → 右滑 = 返回上一层 (关浮层); 无浮层 → 左右滑 = 依次切 tab
+  function topOverlay() {
+    const all = $$('.crop-modal:not([hidden]), .sheet:not([hidden]), .chat-page:not([hidden]), .card-detail:not([hidden])');
+    if (!all.length) return null;
+    return all
+      .map((el) => ({ el, z: parseFloat(getComputedStyle(el).zIndex) || 0 }))
+      .sort((a, b) => a.z - b.z)
+      .pop().el;
+  }
+  function closeOverlay(el) {
+    if (!el) return false;
+    if (el.classList.contains('sheet')) { el.hidden = true; return true; }
+    if (el.classList.contains('card-detail')) {
+      const b = el.querySelector('#detail-back'); if (b) { b.click(); return true; }
+      el.hidden = true; return true;
+    }
+    if (el.classList.contains('crop-modal')) {
+      const b = el.querySelector('[id$="-cancel"], [id$="-close"], .icon-btn');
+      if (b) { b.click(); return true; }
+      el.hidden = true; return true;
+    }
+    if (el.classList.contains('chat-page')) {
+      const b = el.querySelector('.chat-topbar .icon-btn');   // 各页左上角 ← : 走它自带的清理
+      if (b) { b.click(); return true; }
+      el.remove(); return true;
+    }
+    return false;
+  }
+  function goBack() { return closeOverlay(topOverlay()); }
+  function inHorizontalScroller(node) {
+    for (let n = node; n && n !== document.body && n.nodeType === 1; n = n.parentElement) {
+      if (!n.scrollWidth || n.scrollWidth <= n.clientWidth + 4) continue;
+      const ox = getComputedStyle(n).overflowX;
+      if (ox === 'auto' || ox === 'scroll') return true;
+    }
+    return false;
+  }
+  function setupGestures() {
+    const TAB_ORDER = ['main', 'friends', 'network', 'me'];
+    let sx = 0, sy = 0, st = 0, active = false, startTarget = null;
+    document.addEventListener('touchstart', (e) => {
+      if (e.touches.length !== 1) { active = false; return; }
+      sx = e.touches[0].clientX; sy = e.touches[0].clientY;
+      st = Date.now(); active = true; startTarget = e.target;
+    }, { passive: true });
+    document.addEventListener('touchend', (e) => {
+      if (!active) return;
+      active = false;
+      const t = e.changedTouches[0];
+      const dx = t.clientX - sx, dy = t.clientY - sy;
+      if (Date.now() - st > 900) return;                                  // 慢拖不算滑
+      if (Math.abs(dx) < 60 || Math.abs(dx) < Math.abs(dy) * 1.4) return;  // 不够横向
+      if (inHorizontalScroller(startTarget)) return;                       // 横向列表/卡片轨道里不抢手势
+      const ov = topOverlay();
+      if (ov) {
+        if (dx > 0) closeOverlay(ov);           // 浮层内右滑 = 返回上一层 (输入框选中文本时不触发: dx 门槛已过滤)
+        return;
+      }
+      const i = TAB_ORDER.indexOf(currentTab);
+      if (dx < 0) { if (i + 1 < TAB_ORDER.length) switchTab(TAB_ORDER[i + 1]); }
+      else { if (i > 0) switchTab(TAB_ORDER[i - 1]); }
+    }, { passive: true });
+
+    // 点空白关弹窗: 点 sheet 的暗背景 (非 .sheet-inner 内容) 即关
+    document.addEventListener('click', (e) => {
+      const t = e.target;
+      if (!t || !t.closest) return;
+      const sheet = t.closest('.sheet');
+      if (sheet && !sheet.hasAttribute('hidden') && !t.closest('.sheet-inner')) sheet.hidden = true;
+    });
+  }
+
   function init() {
     bindMenu();
     applyTheme(resolveThemePref(), false);
     switchTab('main');
     setupUiControl();
+    setupGestures();
     installDeepLinkListeners();
     loadAgentCovers();
     loadMe();