@bolloon/bolloon-agent 0.4.23 → 0.4.25

package/dist/ios/index.html

@@ -34,15 +34,16 @@
 <div id="app" class="app">
   <!-- 顶部导航 -->
   <header class="topbar">
+    <button class="icon-btn" id="btn-index" title="索引"><svg class="ico" viewBox="0 0 24 24"><path d="M4 6h16M4 12h16M4 18h16"/></svg></button>
     <div class="topbar-title" id="topbar-title">首页</div>
     <div class="topbar-actions" id="topbar-actions">
-      <button class="icon-btn" id="btn-refresh" title="刷新"><svg class="ico" viewBox="0 0 24 24"><path d="M20 12a8 8 0 1 1-2.3-5.6"/><path d="M20 4v4.5h-4.5"/></svg></button>
+      <button class="icon-btn" id="btn-search" title="搜索"><svg class="ico" viewBox="0 0 24 24"><circle cx="11" cy="11" r="6.5"/><path d="M16 16l4.5 4.5"/></svg></button>
       <button class="icon-btn" id="btn-add" title="添加会话"><svg class="ico" viewBox="0 0 24 24"><path d="M12 5v14M5 12h14"/></svg></button>
     </div>
   </header>
 
   <!-- 主页面: 双频滑动卡片 -->
-  <main class="page-container" id="page-main" data-tab="main">
+  <main class="page-container" id="page-main" data-tab="main" hidden>
     <!-- 水平滑动卡片轨道 -->
     <div class="card-carousel" id="card-carousel">
       <div class="card-track" id="card-track">
@@ -60,31 +61,43 @@
       <div class="detail-body" id="detail-body"></div>
     </div>
   </main>
-
-  <!-- 网络 tab -->
-  <section class="page" id="page-network" data-tab="network" hidden>
+  <!-- 好友 tab: 好友与 P2P (原来散在网络页, 现已归拢; 网络页不再重复这些) -->
+  <section class="page" id="page-friends" data-tab="friends" hidden>
     <div class="list">
-      <div class="list-item" id="item-join-net"><span class="list-icon"><svg class="ico" viewBox="0 0 24 24"><path d="M3.5 9.5a13 13 0 0 1 17 0M6.5 13a8.5 8.5 0 0 1 11 0M9.6 16.3a4 4 0 0 1 4.8 0"/><circle cx="12" cy="19.5" r="1.1" fill="currentColor" stroke="none"/></svg></span><span>加入网络</span></div>
-      <div class="list-item" id="item-scan-net"><span class="list-icon"><svg class="ico" viewBox="0 0 24 24"><path d="M4 8V6a2 2 0 0 1 2-2h2M16 4h2a2 2 0 0 1 2 2v2M20 16v2a2 2 0 0 1-2 2h-2M8 20H6a2 2 0 0 1-2-2v-2"/><path d="M4 12h16"/></svg></span><span>扫码入网</span></div>
+      <div class="list-item" id="item-add-friend"><span class="list-icon"><svg class="ico" viewBox="0 0 24 24"><circle cx="9" cy="8" r="3.2"/><path d="M3.5 19c.8-3 3-4.6 5.5-4.6S13.7 16 14.5 19"/><path d="M17 8v6M14 11h6"/></svg></span><span>连接好友</span><span class="list-arrow">›</span></div>
+      <div class="list-item" id="item-nearby"><span class="list-icon"><svg class="ico" viewBox="0 0 24 24"><path d="M4 12a8 8 0 0 1 16 0"/><path d="M7.5 12a4.5 4.5 0 0 1 9 0"/><circle cx="12" cy="12" r="1.4"/><path d="M12 13.6V19"/></svg></span><span>附近设备</span><span class="list-arrow">›</span></div>
+      <div class="list-item" id="item-scan-net"><span class="list-icon"><svg class="ico" viewBox="0 0 24 24"><path d="M4 8V6a2 2 0 0 1 2-2h2M16 4h2a2 2 0 0 1 2 2v2M20 16v2a2 2 0 0 1-2 2h-2M8 20H6a2 2 0 0 1-2-2v-2"/><path d="M4 12h16"/></svg></span><span>扫码入网 / 加好友</span></div>
     </div>
     <input type="file" id="qr-scan-input" accept="image/*" capture="environment" style="display:none">
-    <div class="section-label">P2P 连接</div>
-    <div class="list" id="p2p-status"></div>
-    <div class="section-label">Agent 网络</div>
-    <div class="list" id="net-members"></div>
     <div class="list">
       <div class="list-item" id="item-p2p"><span class="list-icon"><svg class="ico" viewBox="0 0 24 24"><circle cx="12" cy="12" r="8.5"/><path d="M3.5 12h17"/><path d="M12 3.5c2.3 2.3 3.5 5.3 3.5 8.5s-1.2 6.2-3.5 8.5c-2.3-2.3-3.5-5.3-3.5-8.5S9.7 5.8 12 3.5z"/></svg></span><span>P2P 好友</span></div>
       <div class="list-item" id="item-p2p-id"><span class="list-icon"><svg class="ico" viewBox="0 0 24 24"><rect x="3" y="5.5" width="18" height="13" rx="2.5"/><circle cx="8.5" cy="11" r="2"/><path d="M5.6 15.8a3.2 3.2 0 0 1 5.8 0M13.5 10h5M13.5 13.5h5"/></svg></span><span>我的 P2P ID</span></div>
     </div>
+    <div class="section-label">P2P 连接</div>
+    <div class="list" id="p2p-status"></div>
+    <div class="section-label">好友列表</div>
+    <div class="list" id="contacts-list"></div>
+  </section>
+
+  </main>
+
+  <!-- 网络 tab -->
+  <section class="page" id="page-network" data-tab="network" hidden>
+    <div class="list">
+      <div class="list-item" id="item-join-global"><span class="list-icon"><svg class="ico" viewBox="0 0 24 24"><circle cx="12" cy="12" r="8.5"/><path d="M3.5 12h17"/><path d="M12 3.5c2.7 2.6 2.7 14.4 0 17M12 3.5c-2.7 2.6-2.7 14.4 0 17"/><circle cx="12" cy="12" r="1.2" fill="currentColor" stroke="none"/></svg></span><span>一键入网 · 全球智能体网络</span><span class="list-arrow">›</span></div>
+      <div class="list-item" id="item-join-net"><span class="list-icon"><svg class="ico" viewBox="0 0 24 24"><path d="M3.5 9.5a13 13 0 0 1 17 0M6.5 13a8.5 8.5 0 0 1 11 0M9.6 16.3a4 4 0 0 1 4.8 0"/><circle cx="12" cy="19.5" r="1.1" fill="currentColor" stroke="none"/></svg></span><span>加入网络</span><span class="list-arrow">›</span></div>
+    </div>
+    <div class="section-label">Agent 网络</div>
+    <div class="list" id="net-members"></div>
     <div class="section-label">Agent 服务 (协议自动发现)</div>
     <div class="list" id="agent-services"></div>
     <div class="list">
       <div class="list-item" id="item-trade"><span class="list-icon"><svg class="ico" viewBox="0 0 24 24"><path d="M4 7h16M4 12h10M4 17h7"/><path d="M17.5 14.5l2.5 2.5-2.5 2.5"/></svg></span><span style="flex:1">资源交易</span><span class="list-arrow">›</span></div>
     </div>
-    <div class="section-label">P2P 好友列表</div>
-    <div class="list" id="contacts-list"></div>
-    <div class="section-label">MCP 工具 (触控调用)</div>
-    <div class="list" id="mcp-tools"></div>
+    <div class="section-label">微信息 (微支付)</div>
+    <div class="list" id="x402-info-list"></div>
+    <div class="section-label">智能体控制 (MCP / Skills)</div>
+    <div class="list" id="agent-control"></div>
     <div class="section-label">待人工审批支付</div>
     <div class="list" id="approval-list"></div>
     <div class="section-label">A2UI 动态面板 (智能体生成)</div>
@@ -117,6 +130,7 @@
 <!-- 底部 tab -->
 <nav class="tabbar" id="tabbar">
   <button class="tab active" data-tab="main"><span class="tab-icon"><svg class="ico" viewBox="0 0 24 24"><rect x="3.5" y="3.5" width="7" height="7" rx="1.6"/><rect x="13.5" y="3.5" width="7" height="7" rx="1.6"/><rect x="3.5" y="13.5" width="7" height="7" rx="1.6"/><rect x="13.5" y="13.5" width="7" height="7" rx="1.6"/></svg></span><span>首页</span></button>
+  <button class="tab" data-tab="friends"><span class="tab-icon"><svg class="ico" viewBox="0 0 24 24"><circle cx="9" cy="8" r="3.2"/><path d="M3.5 19c.8-3 3-4.6 5.5-4.6S13.7 16 14.5 19"/><path d="M17 8v6M14 11h6"/></svg></span><span>好友</span></button>
   <button class="tab" data-tab="network"><span class="tab-icon"><svg class="ico" viewBox="0 0 24 24"><circle cx="12" cy="12" r="8.5"/><path d="M3.5 12h17"/><path d="M12 3.5c2.3 2.3 3.5 5.3 3.5 8.5s-1.2 6.2-3.5 8.5c-2.3-2.3-3.5-5.3-3.5-8.5S9.7 5.8 12 3.5z"/></svg></span><span>网络</span></button>
   <button class="tab" data-tab="me"><span class="tab-icon"><svg class="ico" viewBox="0 0 24 24"><circle cx="12" cy="8.5" r="4"/><path d="M4.5 20.5a7.5 7.5 0 0 1 15 0"/></svg></span><span>我</span></button>
 </nav>
@@ -125,6 +139,26 @@
 <button class="create-session-btn" id="btn-create-session" hidden>＋ 创建新会话</button>
 
 <!-- 创建智能体: 底部滑入加载 sheet -->
+<!-- 2026-09-16: 首启隐私同意门 — 上架要求: 用户同意前不读取本机数据 / 不连网 / 不申请任何权限 -->
+<div class="sheet" id="privacy-gate" hidden>
+  <div class="sheet-inner">
+    <div class="sheet-title" id="privacy-gate-title">隐私政策与权限说明</div>
+    <div class="sheet-text" id="privacy-gate-body"></div>
+    <a class="privacy-link" href="#" id="privacy-gate-link">阅读完整隐私政策 ›</a>
+    <button class="sheet-choice" id="privacy-agree">同意并继续</button>
+    <button class="sheet-choice sheet-cancel" id="privacy-decline">不同意</button>
+  </div>
+</div>
+
+<!-- 2026-09-16: 应用内隐私政策 (全屏, 离线可用; 权威版 = bolloon.cn/privacy.html) -->
+<div class="chat-page" id="policy-page" hidden>
+  <div class="chat-topbar">
+    <button class="icon-btn" id="policy-back">←</button>
+    <div style="flex:1;font-weight:600">隐私政策</div>
+  </div>
+  <div class="policy-body" id="policy-body"></div>
+</div>
+
 <div class="sheet" id="create-sheet" hidden>
   <div class="sheet-inner">
     <div class="spinner"></div>
@@ -132,15 +166,58 @@
   </div>
 </div>
 
-<!-- 添加好友: 底部滑出选择 sheet -->
+<!-- 添加好友: 底部滑出选择 sheet (点按式: 扫码 / 附近 / 待处理申请 / 手动) -->
 <div class="sheet" id="addfriend-sheet" hidden>
   <div class="sheet-inner sheet-inner-choices">
-    <div class="sheet-title">添加 P2P 好友</div>
+    <div class="sheet-title">连接好友</div>
+    <button class="sheet-choice" id="choice-nearby"><svg class="ico" viewBox="0 0 24 24"><path d="M4 12a8 8 0 0 1 16 0"/><path d="M7.5 12a4.5 4.5 0 0 1 9 0"/><circle cx="12" cy="12" r="1.4"/><path d="M12 13.6V19"/></svg> 附近的设备</button>
     <button class="sheet-choice" id="choice-scan"><svg class="ico" viewBox="0 0 24 24"><path d="M4 8V6a2 2 0 0 1 2-2h2M16 4h2a2 2 0 0 1 2 2v2M20 16v2a2 2 0 0 1-2 2h-2M8 20H6a2 2 0 0 1-2-2v-2"/><path d="M4 12h16"/></svg> 扫码添加</button>
-    <button class="sheet-choice" id="choice-manual"><svg class="ico" viewBox="0 0 24 24"><path d="M10.5 13.5a3.5 3.5 0 0 1 0-5l2-2a3.5 3.5 0 0 1 5 5l-1 1"/><path d="M13.5 10.5a3.5 3.5 0 0 1 0 5l-2 2a3.5 3.5 0 0 1-5-5l1-1"/></svg> 手动输入地址</button>
+    <button class="sheet-choice" id="choice-requests"><svg class="ico" viewBox="0 0 24 24"><path d="M6 4h9l4 4v12a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V5a1 1 0 0 1 1-1z"/><path d="M9 12h6M9 16h4"/></svg> 待处理申请</button>
+    <button class="sheet-choice sheet-cancel" id="choice-manual">⌨️ 手动输入地址 (兜底)</button>
     <button class="sheet-choice sheet-cancel" id="choice-cancel">取消</button>
   </div>
 </div>
+
+<!-- 加入网络: 点按式 sheet (扫一扫 / 附近设备 / 手动粘贴兜底) -->
+<div class="sheet" id="network-sheet" hidden>
+  <div class="sheet-inner sheet-inner-choices">
+    <div class="sheet-title">加入网络</div>
+    <button class="sheet-choice" id="choice-join-nearby"><svg class="ico" viewBox="0 0 24 24"><path d="M4 12a8 8 0 0 1 16 0"/><path d="M7.5 12a4.5 4.5 0 0 1 9 0"/><circle cx="12" cy="12" r="1.4"/><path d="M12 13.6V19"/></svg> 附近的电脑 / 设备</button>
+    <button class="sheet-choice" id="choice-join-scan"><svg class="ico" viewBox="0 0 24 24"><path d="M4 8V6a2 2 0 0 1 2-2h2M16 4h2a2 2 0 0 1 2 2v2M20 16v2a2 2 0 0 1-2 2h-2M8 20H6a2 2 0 0 1-2-2v-2"/><path d="M4 12h16"/></svg> 扫电脑上的二维码</button>
+    <button class="sheet-choice sheet-cancel" id="choice-join-manual">🔗 粘贴入网链接 (兜底)</button>
+    <button class="sheet-choice sheet-cancel" id="choice-join-cancel">取消</button>
+  </div>
+</div>
+
+<!-- 附近设备: 点按列表 (点一条即连接 / 建立好友) -->
+<div class="sheet" id="nearby-sheet" hidden>
+  <div class="sheet-inner">
+    <div class="sheet-title" id="nearby-title">附近设备</div>
+    <div class="sheet-text" id="nearby-hint">正在查找...</div>
+    <div class="list" id="nearby-list" style="width:100%;max-height:46vh;overflow-y:auto"></div>
+    <button class="sheet-choice" id="nearby-refresh">↻ 刷新</button>
+    <button class="sheet-choice sheet-cancel" id="nearby-close">关闭</button>
+  </div>
+</div>
+<!-- 微信息 (x402 付费信息): 点一条看详情 → 购买并验真 / 只看元数据 -->
+<div class="sheet" id="x402-sheet" hidden>
+  <div class="sheet-inner">
+    <div class="sheet-title" id="x402-title">微信息</div>
+    <div class="sheet-text" id="x402-body" style="width:100%;max-height:46vh;overflow-y:auto;text-align:left;white-space:pre-wrap;word-break:break-word"></div>
+    <button class="sheet-choice" id="x402-buy">购买并验真</button>
+    <button class="sheet-choice" id="x402-verify">只看元数据 (离线验真)</button>
+    <button class="sheet-choice sheet-cancel" id="x402-close">关闭</button>
+  </div>
+</div>
+
+<!-- 微信息结果: 内容 + 验真分档 (verified / self-attested / content-only / unverified) -->
+<div class="sheet" id="x402-result-sheet" hidden>
+  <div class="sheet-inner">
+    <div class="sheet-title" id="x402-result-title">验真结果</div>
+    <div class="sheet-text" id="x402-result-body" style="width:100%;max-height:56vh;overflow-y:auto;text-align:left;white-space:pre-wrap;word-break:break-word"></div>
+    <button class="sheet-choice sheet-cancel" id="x402-result-close">关闭</button>
+  </div>
+</div>
 </div>
 
 <!-- 2026-08-14: 手机端内化内核 (IndexedDB 数据 + 本地身份 + 支付审批 + Agent). 必须最先加载 -->

package/dist/ios/manifest.json

@@ -2,7 +2,7 @@
   "name": "Bolloon Agent",
   "short_name": "Bolloon",
   "description": "去中心化智能体网络 — 手机端 (P2P / DID / 数字资源)",
-  "id": "com.bolloon.agent.mobile",
+  "id": "com.hibs.bolloon",
   "start_url": "./mobile.html",
   "scope": "./",
   "display": "standalone",

package/dist/ios/mobile-agent.js

@@ -52,6 +52,45 @@ export async function resetAgentDb() {
         }
     });
 }
+async function _kvGet(key) {
+    try {
+        const db = _identityDb || (await openIdentityDb());
+        _identityDb = db;
+        return await new Promise((res) => { const t = db.transaction('kv', 'readonly'); const r = t.objectStore('kv').get(key); r.onsuccess = () => res(r.result ?? null); r.onerror = () => res(null); });
+    }
+    catch {
+        return null;
+    }
+}
+async function _kvPut(key, val) {
+    try {
+        const db = _identityDb || (await openIdentityDb());
+        _identityDb = db;
+        await new Promise((res) => { const t = db.transaction('kv', 'readwrite'); t.objectStore('kv').put(val, key); t.oncomplete = () => res(); t.onerror = () => res(); });
+    }
+    catch { /* IDB 不可用则仅内存态 */ }
+}
+/** 登录: 设置本机身份昵称 (无身份则新建) + 标记已登录 */
+export async function loginIdentity(name) {
+    const id = await ensureIdentity();
+    const nm = String(name || '').trim() || 'blln-mobile';
+    const next = { ...id, name: nm };
+    await _kvPut('identity', next);
+    await _kvPut('loggedIn', true);
+    _identity = next;
+    return { ...next, loggedIn: true };
+}
+/** 注销: 清除登录态 (保留设备 DID, 不影响 P2P/频道) */
+export async function logoutIdentity() {
+    await _kvPut('loggedIn', false);
+    return { ok: true };
+}
+/** 身份状态 (含登录态; 未登录时 name 置空) */
+export async function identityStatus() {
+    const id = await ensureIdentity();
+    const loggedIn = (await _kvGet('loggedIn')) === true;
+    return { did: id.did, didShort: id.did ? id.did.slice(0, 12) : '', name: loggedIn ? id.name : '', createdAt: id.createdAt, loggedIn };
+}
 /** 获取本机 DID (首次生成并持久化) */
 export async function ensureIdentity() {
     if (_identity)
@@ -121,11 +160,205 @@ async function applyLlmConfigToBridge() {
     }
     catch { /* 注入失败不阻塞本地执行 */ }
 }
-// ============ 本地执行 (Kotlin AgentRuntime / 内置规则) ============
+// ============ 手机端「读入网说明 → 入网」(2026-09-15) ============
+//
+// 背景: 手机端「一键入网」发出的口令是 `read https://bolloon.cn/bolloon-gateway-join.md`
+// (mobile.js DEFAULT_JOIN_PROMPT), 但手机侧此前只会走到「已收到: "…"」的兜底回复 ——
+// 也就是说这句话在手机上是**空转**的: 既不读文档, 也不入网。
+// 现在手机自己就能走完: 读说明(校验 frontmatter) → 本机 DID → 服务登记
+// (桌面可达则登记进桌面的网络 registry, 否则本机登记并如实说明) → P2P 公告(尽力) → 落盘入网态。
+// 桌面不可达不是失败: 手机是自治节点; 但每一步都如实报 ok/note, 不假装入网。
+/** 入网口令识别 (与 mobile.js 的默认 prompt 同源) */
+export const MOBILE_JOIN_DOC_RE = /read\s+(https?:\/\/\S*bolloon-gateway-join\.md)/i;
+const MOBILE_JOIN_STATE_KEY = 'bolloon_gateway_join';
+export function detectJoinDocUrl(text) {
+    const m = MOBILE_JOIN_DOC_RE.exec(String(text || ''));
+    return m ? m[1] : null;
+}
+/** 极简 SKILL.md frontmatter 解析 (只认 name/version) */
+function parseFm(text) {
+    const m = /^---\r?\n([\s\S]*?)\r?\n---/.exec(String(text || ''));
+    if (!m)
+        return {};
+    const out = {};
+    for (const line of m[1].split(/\r?\n/)) {
+        const kv = /^([A-Za-z_][\w-]*)\s*:\s*(.*)$/.exec(line.trim());
+        if (!kv)
+            continue;
+        const k = kv[1].toLowerCase();
+        if (k === 'name')
+            out.name = kv[2].trim().replace(/^["']|["']$/g, '');
+        if (k === 'version')
+            out.version = kv[2].trim().replace(/^["']|["']$/g, '');
+    }
+    return out;
+}
+export async function getMobileJoinState() {
+    try {
+        const raw = typeof localStorage !== 'undefined' ? localStorage.getItem(MOBILE_JOIN_STATE_KEY) : null;
+        return raw ? JSON.parse(raw) : null;
+    }
+    catch {
+        return null;
+    }
+}
+function saveMobileJoinState(s) {
+    try {
+        if (typeof localStorage !== 'undefined')
+            localStorage.setItem(MOBILE_JOIN_STATE_KEY, JSON.stringify(s));
+    }
+    catch { /* 忽略 */ }
+}
+/**
+ * 按入网说明文档入网 (手机端自足执行)。
+ * opts.desktopBaseUrl 可注入 (测试用); 默认读 mobile-gateway 持久化的桌面基址。
+ */
+export async function joinGatewayFromDoc(docUrl, opts = {}) {
+    const f = opts.fetchImpl || fetch;
+    const steps = [];
+    const url = String(docUrl || '').trim();
+    if (!/^https?:\/\//i.test(url)) {
+        return { ok: false, docUrl: url, steps, error: `入网说明地址必须是 http(s) URL (收到: ${url.slice(0, 60)})` };
+    }
+    // ① 读入网说明 + 校验
+    let docVersion;
+    try {
+        const r = await f(url, { signal: AbortSignal.timeout(opts.timeoutMs ?? 15000) });
+        if (!r.ok) {
+            steps.push({ step: '读入网说明', ok: false, note: `文档不可达 (HTTP ${r.status})` });
+            return { ok: false, docUrl: url, steps, error: `入网说明不可达 (HTTP ${r.status})` };
+        }
+        const text = await r.text();
+        const fm = parseFm(text);
+        if (fm.name !== 'bolloon-gateway-join' && !/加入网关|bolloon-gateway-join/.test(text)) {
+            steps.push({ step: '读入网说明', ok: false, note: `不是 Bolloon 入网说明 (name=${fm.name || '无'})` });
+            return { ok: false, docUrl: url, steps, error: '该文档不是 Bolloon 网关入网说明, 拒绝据此入网' };
+        }
+        docVersion = fm.version;
+        steps.push({ step: '读入网说明', ok: true, note: `${fm.name || 'bolloon-gateway-join'} v${fm.version || '?'} (${text.length} 字符)` });
+    }
+    catch (e) {
+        steps.push({ step: '读入网说明', ok: false, note: `读取失败: ${String(e?.message || e).slice(0, 120)}` });
+        return { ok: false, docUrl: url, steps, error: `入网说明读取失败: ${String(e?.message || e).slice(0, 120)}` };
+    }
+    // ② 本机 DID (手机端身份层; 可注入, 便于测试/无 IndexedDB 环境)
+    let did = String(opts.did || '');
+    if (did) {
+        steps.push({ step: 'DID 身份', ok: true, note: `${did} (注入身份)` });
+    }
+    else {
+        try {
+            const id = await ensureIdentity();
+            did = id.did;
+            steps.push({ step: 'DID 身份', ok: true, note: `${did} (手机端本机生成)` });
+        }
+        catch (e) {
+            steps.push({ step: 'DID 身份', ok: false, note: String(e?.message || e).slice(0, 120) });
+            return { ok: false, docUrl: url, docVersion, steps, error: '手机端 DID 生成失败' };
+        }
+    }
+    const name = String(opts.name || 'phone-agent');
+    const capabilities = ['chat', 'gateway-join'];
+    // ③ 服务登记: 桌面可达 → 登记进桌面(网络) registry; 否则本机登记并如实说明
+    let desktopBase = String(opts.desktopBaseUrl ?? '');
+    if (opts.desktopBaseUrl === undefined) {
+        try {
+            const g = await import('./mobile-gateway.js');
+            desktopBase = String(g.getDesktopBaseUrl() || '');
+        }
+        catch {
+            desktopBase = '';
+        }
+    }
+    desktopBase = desktopBase.replace(/\/+$/, '');
+    let registeredOn = 'local';
+    if (desktopBase) {
+        try {
+            const r = await f(`${desktopBase}/api/registry/register`, {
+                method: 'POST', headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({
+                    agentId: did, name, wallet: '',
+                    service: { name: 'chat', description: '手机端智能体 (自足节点)', price: { amount: '0', currency: 'USDC', per: 'task' }, endpoint: '' },
+                    capabilities,
+                }),
+                signal: AbortSignal.timeout(opts.timeoutMs ?? 15000),
+            });
+            if (r.ok) {
+                registeredOn = 'desktop';
+                steps.push({ step: '服务登记', ok: true, note: `已登记进电脑端网络 registry (${desktopBase}) —— 网络内其他智能体可按能力发现我` });
+            }
+            else {
+                steps.push({ step: '服务登记', ok: false, note: `电脑端 registry 拒绝 (HTTP ${r.status}); 已改为本机登记` });
+            }
+        }
+        catch (e) {
+            steps.push({ step: '服务登记', ok: false, note: `电脑端不可达 (${String(e?.message || e).slice(0, 80)}); 已改为本机登记` });
+        }
+    }
+    else {
+        steps.push({ step: '服务登记', ok: true, note: '未配置电脑端基址 → 只在本机登记 (手机是自治节点; 设置里填电脑端地址可登记进网络 registry)' });
+    }
+    // ④ P2P 公告 (尽力): 让已连接的对端知道本机服务; 没连上不是入网失败
+    try {
+        const p2p = await import('./mobile-p2p.js');
+        let peers = 0;
+        try {
+            peers = (p2p.getConnectedPeers?.() || []).length;
+        }
+        catch {
+            peers = 0;
+        }
+        if (peers > 0 && typeof p2p.sendMobileP2PMessage === 'function') {
+            const okAnnounce = await p2p.sendMobileP2PMessage('*', 'registry.register', JSON.stringify({ agent_id: did, name, capabilities }), did);
+            steps.push({ step: 'P2P 公告', ok: !!okAnnounce, note: okAnnounce ? `已向 ${peers} 个对端广播本机声明` : `广播失败 (对端 ${peers} 个)` });
+        }
+        else {
+            steps.push({ step: 'P2P 公告', ok: false, note: '当前无已连接对端 (浏览器/未连电脑端时正常) — 本机声明已就绪, 连上即生效' });
+        }
+    }
+    catch (e) {
+        steps.push({ step: 'P2P 公告', ok: false, note: `P2P 层不可用: ${String(e?.message || e).slice(0, 80)}` });
+    }
+    // ⑤ 落盘入网态 (幂等: 同 url 再次入网覆盖时间戳)
+    saveMobileJoinState({ url, did, name, capabilities, docVersion, registeredOn, desktopBaseUrl: desktopBase || undefined, joinedAt: new Date().toISOString() });
+    const state = await getMobileJoinState();
+    steps.push({ step: '落盘入网态', ok: !!state?.did, note: `localStorage:${MOBILE_JOIN_STATE_KEY}` });
+    return { ok: true, docUrl: url, docVersion, did, steps };
+}
+/** 把入网结果渲染成给用户看的回复 (与桌面工具的 steps 汇报风格一致) */
+export function formatMobileJoinResult(r) {
+    if (!r.ok) {
+        return `❌ 入网失败: ${r.error || '未知原因'}\n\n${r.steps.map((s) => `${s.ok ? '✓' : '✗'} ${s.step}: ${s.note}`).join('\n')}`;
+    }
+    const s = r.steps.find((x) => x.step === '服务登记');
+    return [
+        '✅ 已加入全球智能体网络 (手机端自足执行)',
+        '',
+        `DID: ${r.did}`,
+        `入网说明: v${r.docVersion || '?'} (${r.docUrl})`,
+        s ? `登记: ${s.note}` : '',
+        '',
+        ...r.steps.map((x) => `${x.ok ? '✓' : '✗'} ${x.step}: ${x.note}`),
+        '',
+        '用「网络 → Agent 网络」可查看成员; 设置里填电脑端地址可把本机登记进网络 registry。',
+    ].filter((l) => l !== '').join('\n');
+}
+// ============ 本地执行 (Kotlin AgentRuntime / 离线兜底) ============
 /** 手机端本地 agent 执行 (优先 Kotlin, 离线内置规则) */
 export async function runLocalAgent(goal) {
     const win = typeof window !== 'undefined' ? window : null;
     const cap = win?.Capacitor;
+    // 2026-09-15: 「读入网说明 → 入网」在手机端本地自足执行 (先于 Kotlin 桥: 原生工具集里没有入网能力,
+    //   交给它只会得到空转回复)。这样浏览器 / WebView / 真机三种环境行为一致。
+    const joinDocUrl = detectJoinDocUrl(goal);
+    if (joinDocUrl) {
+        _lastWorklog = [`🧩 识别为入网口令: ${joinDocUrl}`];
+        const r = await joinGatewayFromDoc(joinDocUrl).catch((e) => ({
+            ok: false, docUrl: joinDocUrl, steps: [{ step: '入网', ok: false, note: String(e?.message || e).slice(0, 120) }], error: String(e?.message || e),
+        }));
+        _lastWorklog = [..._lastWorklog, ...r.steps.map((s) => `${s.ok ? '✓' : '✗'} ${s.step}: ${s.note}`)];
+        return formatMobileJoinResult(r);
+    }
     const bridge = cap && cap.Plugins && cap.Plugins.RokidBridge;
     if (bridge && cap.isNativePlatform?.()) {
         try {
@@ -318,12 +551,18 @@ export async function runPhoneAgent(goal) {
                 stepCount: r?.stepCount,
             };
         }
-        // 离线 fallback: 内置规则 (不依赖 LLM/无障碍, 手机仍自治可用)
+        // 离线 fallback: 内置规则 (不依赖 LLM/原生执行能力, 手机仍自治可用)
         const reply = await runLocalAgent(goal);
-        return { ok: true, goal, result: reply, did: id.did, mode: 'fallback' };
+        return {
+            ok: true, goal, result: reply, did: id.did, mode: 'fallback',
+            hint: '当前是「手机本地规则」模式：这台手机上还没接原生执行能力 (iOS 暂不支持原生操控 App; Android 需开无障碍服务)，所以只能用内置规则回复。连上电脑端后，任务可以交给电脑端 Agent 真正执行。',
+        };
     }
     catch (e) {
-        return { ok: false, goal, error: String(e?.message || e).slice(0, 100), did: id.did, mode: native ? 'native' : 'fallback' };
+        return {
+            ok: false, goal, error: String(e?.message || e).slice(0, 100), did: id.did, mode: native ? 'native' : 'fallback',
+            hint: '任务没跑起来。常见原因：① 电脑端没在运行或不同网段 (设置 → 电脑端同步 里配置/测试) ② 没配 LLM API (设置 → API 配置) ③ 这台手机没接原生执行能力 (iOS 不支持原生操控, Android 需无障碍服务)。',
+        };
     }
 }
 /** 手机端 Agent 状态 (phone.agent.status) */
@@ -400,4 +639,4 @@ export async function handleIncomingPhoneMessage(type, payload, fromPeer) {
     }
     catch { /* 控制消息处理失败静默 */ }
 }
-export default { ensureIdentity, runLocalAgent, setAgentTransport, onAgentReply, callRemoteAgent, handleIncomingAgentMessage, notifyAgentReply, onInboundChat, setLlmConfig, getLlmConfig, runPhoneAgent, phoneStatus, cancelPhoneAgent, handleIncomingPhoneMessage };
+export default { ensureIdentity, loginIdentity, logoutIdentity, identityStatus, runLocalAgent, setAgentTransport, onAgentReply, callRemoteAgent, handleIncomingAgentMessage, notifyAgentReply, onInboundChat, setLlmConfig, getLlmConfig, runPhoneAgent, phoneStatus, cancelPhoneAgent, handleIncomingPhoneMessage };