@bolloon/bolloon-agent 0.4.23 → 0.4.24

package/dist/web/agent-delegate-server.js

@@ -17,9 +17,10 @@
  */
 import express from 'express';
 import { buildAgentDelegateRequest, buildAgentResponse, buildManifestPayload, parseFrame, setLocalManifest, getLocalManifest, getRemoteManifests, cacheRemoteManifest, pickAgent, } from '../agents/agent-manifest-protocol.js';
-export function createAgentDelegateApp(transport) {
+export function createAgentDelegateApp(transport, options = {}) {
     const app = express();
     app.use(express.json({ limit: '2mb' }));
+    const executeTimeoutMs = options.executeTimeoutMs ?? 60_000;
     // ---- 本地 manifest ----
     app.get('/api/agent/local-manifest', (_req, res) => {
         res.json(getLocalManifest());
@@ -81,7 +82,10 @@ export function createAgentDelegateApp(transport) {
             }
             res.json({
                 ok: true,
-                targetAgent: targetAgent || { id: f.payload.delegatedTo, capabilities: [capability], status: 'active', name: f.payload.delegatedTo },
+                // 2026-09-15: 没缓存到对端 manifest 就如实给 null —— 旧版会编一个
+                // 「capabilities:[capability], name:<id>」的假目标, 让人以为已经知道对端是谁。
+                targetAgent: targetAgent || null,
+                targetAgentKnown: !!targetAgent,
                 response: f.payload,
             });
         }
@@ -104,18 +108,60 @@ export function createAgentDelegateApp(transport) {
             return null; // 不需要回包
         }
         if (f.type === 'agent_delegate') {
-            // 路由到本地匹配 agent
             const req = f.payload;
+            const capability = String(req?.capability || '');
+            // 2026-09-15: 严格按文档 §6 / §9 —— 只认 capabilities 含该能力且 active 的 agent。
+            //   旧实现 `|| local.agents[0]` 会把不匹配的指令塞给任意一个本地 agent,
+            //   与「pick 404 = 没有匹配能力」的语义自相矛盾。
             const local = getLocalManifest();
-            const target = local.agents.find((a) => a.capabilities.includes(req.capability) && a.status === 'active') || local.agents[0];
-            if (!target)
-                return buildAgentResponse({ ok: false, delegatedTo: 'none', summary: 'no local agent available' });
-            return buildAgentResponse({
-                ok: true,
-                delegatedTo: target.id,
-                resultCid: `mock-${Date.now()}`,
-                summary: `[${target.name}] 已处理任务: ${req.instruction?.substring(0, 30)}`,
-            });
+            const target = local.agents.find((a) => a.capabilities.includes(capability) && a.status === 'active');
+            if (!target) {
+                return buildAgentResponse({
+                    ok: false,
+                    delegatedTo: 'none',
+                    summary: `no local agent available for capability '${capability}'`,
+                    error: 'no-capability-match',
+                });
+            }
+            // 匹配到了, 但本节点没接执行器 → 如实说"干不了", 不假签收
+            if (!options.execute) {
+                return buildAgentResponse({
+                    ok: false,
+                    delegatedTo: target.id,
+                    summary: `matched agent '${target.name}' but this node has no executor wired`,
+                    error: 'no-executor',
+                });
+            }
+            try {
+                const raced = await Promise.race([
+                    options.execute({
+                        capability,
+                        instruction: String(req?.instruction || ''),
+                        docPath: req?.docPath ? String(req.docPath) : undefined,
+                        docContent: req?.docContent ? String(req.docContent) : undefined,
+                        fromAgentId: req?.fromAgentId ? String(req.fromAgentId) : undefined,
+                        fromPublicKey,
+                        targetAgentId: target.id,
+                        targetAgentName: target.name,
+                    }),
+                    new Promise((resolve) => setTimeout(() => resolve({ ok: false, summary: `executor timed out after ${executeTimeoutMs}ms`, error: 'executor-timeout' }), executeTimeoutMs)),
+                ]);
+                return buildAgentResponse({
+                    ok: !!raced.ok,
+                    delegatedTo: target.id,
+                    resultCid: raced.resultCid,
+                    summary: String(raced.summary || '').slice(0, 4000),
+                    error: raced.error,
+                });
+            }
+            catch (e) {
+                return buildAgentResponse({
+                    ok: false,
+                    delegatedTo: target.id,
+                    summary: `executor threw: ${String(e?.message || e).slice(0, 300)}`,
+                    error: 'executor-error',
+                });
+            }
         }
         return null;
     });

package/dist/web/mobile-agent.js

@@ -160,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 {

package/dist/web/mobile-core.js

@@ -86655,15 +86655,20 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
   // src/web/mobile-agent.ts
   var mobile_agent_exports = {};
   __export(mobile_agent_exports, {
+    MOBILE_JOIN_DOC_RE: () => MOBILE_JOIN_DOC_RE,
     callRemoteAgent: () => callRemoteAgent,
     cancelPhoneAgent: () => cancelPhoneAgent,
     default: () => mobile_agent_default,
+    detectJoinDocUrl: () => detectJoinDocUrl,
     ensureIdentity: () => ensureIdentity,
+    formatMobileJoinResult: () => formatMobileJoinResult,
     getLastWorklog: () => getLastWorklog,
     getLlmConfig: () => getLlmConfig,
+    getMobileJoinState: () => getMobileJoinState,
     handleIncomingAgentMessage: () => handleIncomingAgentMessage,
     handleIncomingPhoneMessage: () => handleIncomingPhoneMessage,
     identityStatus: () => identityStatus,
+    joinGatewayFromDoc: () => joinGatewayFromDoc,
     loginIdentity: () => loginIdentity,
     logoutIdentity: () => logoutIdentity,
     notifyAgentReply: () => notifyAgentReply,
@@ -86810,9 +86815,171 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
     } catch {
     }
   }
+  function detectJoinDocUrl(text) {
+    const m2 = MOBILE_JOIN_DOC_RE.exec(String(text || ""));
+    return m2 ? m2[1] : null;
+  }
+  function parseFm(text) {
+    const m2 = /^---\r?\n([\s\S]*?)\r?\n---/.exec(String(text || ""));
+    if (!m2) return {};
+    const out = {};
+    for (const line of m2[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;
+  }
+  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(s2) {
+    try {
+      if (typeof localStorage !== "undefined") localStorage.setItem(MOBILE_JOIN_STATE_KEY, JSON.stringify(s2));
+    } catch {
+    }
+  }
+  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: `\u5165\u7F51\u8BF4\u660E\u5730\u5740\u5FC5\u987B\u662F http(s) URL (\u6536\u5230: ${url.slice(0, 60)})` };
+    }
+    let docVersion;
+    try {
+      const r = await f(url, { signal: AbortSignal.timeout(opts.timeoutMs ?? 15e3) });
+      if (!r.ok) {
+        steps.push({ step: "\u8BFB\u5165\u7F51\u8BF4\u660E", ok: false, note: `\u6587\u6863\u4E0D\u53EF\u8FBE (HTTP ${r.status})` });
+        return { ok: false, docUrl: url, steps, error: `\u5165\u7F51\u8BF4\u660E\u4E0D\u53EF\u8FBE (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: "\u8BFB\u5165\u7F51\u8BF4\u660E", ok: false, note: `\u4E0D\u662F Bolloon \u5165\u7F51\u8BF4\u660E (name=${fm.name || "\u65E0"})` });
+        return { ok: false, docUrl: url, steps, error: "\u8BE5\u6587\u6863\u4E0D\u662F Bolloon \u7F51\u5173\u5165\u7F51\u8BF4\u660E, \u62D2\u7EDD\u636E\u6B64\u5165\u7F51" };
+      }
+      docVersion = fm.version;
+      steps.push({ step: "\u8BFB\u5165\u7F51\u8BF4\u660E", ok: true, note: `${fm.name || "bolloon-gateway-join"} v${fm.version || "?"} (${text.length} \u5B57\u7B26)` });
+    } catch (e) {
+      steps.push({ step: "\u8BFB\u5165\u7F51\u8BF4\u660E", ok: false, note: `\u8BFB\u53D6\u5931\u8D25: ${String(e?.message || e).slice(0, 120)}` });
+      return { ok: false, docUrl: url, steps, error: `\u5165\u7F51\u8BF4\u660E\u8BFB\u53D6\u5931\u8D25: ${String(e?.message || e).slice(0, 120)}` };
+    }
+    let did = String(opts.did || "");
+    if (did) {
+      steps.push({ step: "DID \u8EAB\u4EFD", ok: true, note: `${did} (\u6CE8\u5165\u8EAB\u4EFD)` });
+    } else {
+      try {
+        const id = await ensureIdentity();
+        did = id.did;
+        steps.push({ step: "DID \u8EAB\u4EFD", ok: true, note: `${did} (\u624B\u673A\u7AEF\u672C\u673A\u751F\u6210)` });
+      } catch (e) {
+        steps.push({ step: "DID \u8EAB\u4EFD", ok: false, note: String(e?.message || e).slice(0, 120) });
+        return { ok: false, docUrl: url, docVersion, steps, error: "\u624B\u673A\u7AEF DID \u751F\u6210\u5931\u8D25" };
+      }
+    }
+    const name10 = String(opts.name || "phone-agent");
+    const capabilities = ["chat", "gateway-join"];
+    let desktopBase = String(opts.desktopBaseUrl ?? "");
+    if (opts.desktopBaseUrl === void 0) {
+      try {
+        const g = await Promise.resolve().then(() => (init_mobile_gateway(), mobile_gateway_exports));
+        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: name10,
+            wallet: "",
+            service: { name: "chat", description: "\u624B\u673A\u7AEF\u667A\u80FD\u4F53 (\u81EA\u8DB3\u8282\u70B9)", price: { amount: "0", currency: "USDC", per: "task" }, endpoint: "" },
+            capabilities
+          }),
+          signal: AbortSignal.timeout(opts.timeoutMs ?? 15e3)
+        });
+        if (r.ok) {
+          registeredOn = "desktop";
+          steps.push({ step: "\u670D\u52A1\u767B\u8BB0", ok: true, note: `\u5DF2\u767B\u8BB0\u8FDB\u7535\u8111\u7AEF\u7F51\u7EDC registry (${desktopBase}) \u2014\u2014 \u7F51\u7EDC\u5185\u5176\u4ED6\u667A\u80FD\u4F53\u53EF\u6309\u80FD\u529B\u53D1\u73B0\u6211` });
+        } else {
+          steps.push({ step: "\u670D\u52A1\u767B\u8BB0", ok: false, note: `\u7535\u8111\u7AEF registry \u62D2\u7EDD (HTTP ${r.status}); \u5DF2\u6539\u4E3A\u672C\u673A\u767B\u8BB0` });
+        }
+      } catch (e) {
+        steps.push({ step: "\u670D\u52A1\u767B\u8BB0", ok: false, note: `\u7535\u8111\u7AEF\u4E0D\u53EF\u8FBE (${String(e?.message || e).slice(0, 80)}); \u5DF2\u6539\u4E3A\u672C\u673A\u767B\u8BB0` });
+      }
+    } else {
+      steps.push({ step: "\u670D\u52A1\u767B\u8BB0", ok: true, note: "\u672A\u914D\u7F6E\u7535\u8111\u7AEF\u57FA\u5740 \u2192 \u53EA\u5728\u672C\u673A\u767B\u8BB0 (\u624B\u673A\u662F\u81EA\u6CBB\u8282\u70B9; \u8BBE\u7F6E\u91CC\u586B\u7535\u8111\u7AEF\u5730\u5740\u53EF\u767B\u8BB0\u8FDB\u7F51\u7EDC registry)" });
+    }
+    try {
+      const p2p = await Promise.resolve().then(() => (init_mobile_p2p(), mobile_p2p_exports));
+      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: name10, capabilities }), did);
+        steps.push({ step: "P2P \u516C\u544A", ok: !!okAnnounce, note: okAnnounce ? `\u5DF2\u5411 ${peers} \u4E2A\u5BF9\u7AEF\u5E7F\u64AD\u672C\u673A\u58F0\u660E` : `\u5E7F\u64AD\u5931\u8D25 (\u5BF9\u7AEF ${peers} \u4E2A)` });
+      } else {
+        steps.push({ step: "P2P \u516C\u544A", ok: false, note: "\u5F53\u524D\u65E0\u5DF2\u8FDE\u63A5\u5BF9\u7AEF (\u6D4F\u89C8\u5668/\u672A\u8FDE\u7535\u8111\u7AEF\u65F6\u6B63\u5E38) \u2014 \u672C\u673A\u58F0\u660E\u5DF2\u5C31\u7EEA, \u8FDE\u4E0A\u5373\u751F\u6548" });
+      }
+    } catch (e) {
+      steps.push({ step: "P2P \u516C\u544A", ok: false, note: `P2P \u5C42\u4E0D\u53EF\u7528: ${String(e?.message || e).slice(0, 80)}` });
+    }
+    saveMobileJoinState({ url, did, name: name10, capabilities, docVersion, registeredOn, desktopBaseUrl: desktopBase || void 0, joinedAt: (/* @__PURE__ */ new Date()).toISOString() });
+    const state2 = await getMobileJoinState();
+    steps.push({ step: "\u843D\u76D8\u5165\u7F51\u6001", ok: !!state2?.did, note: `localStorage:${MOBILE_JOIN_STATE_KEY}` });
+    return { ok: true, docUrl: url, docVersion, did, steps };
+  }
+  function formatMobileJoinResult(r) {
+    if (!r.ok) {
+      return `\u274C \u5165\u7F51\u5931\u8D25: ${r.error || "\u672A\u77E5\u539F\u56E0"}
+
+${r.steps.map((s3) => `${s3.ok ? "\u2713" : "\u2717"} ${s3.step}: ${s3.note}`).join("\n")}`;
+    }
+    const s2 = r.steps.find((x) => x.step === "\u670D\u52A1\u767B\u8BB0");
+    return [
+      "\u2705 \u5DF2\u52A0\u5165\u5168\u7403\u667A\u80FD\u4F53\u7F51\u7EDC (\u624B\u673A\u7AEF\u81EA\u8DB3\u6267\u884C)",
+      "",
+      `DID: ${r.did}`,
+      `\u5165\u7F51\u8BF4\u660E: v${r.docVersion || "?"} (${r.docUrl})`,
+      s2 ? `\u767B\u8BB0: ${s2.note}` : "",
+      "",
+      ...r.steps.map((x) => `${x.ok ? "\u2713" : "\u2717"} ${x.step}: ${x.note}`),
+      "",
+      "\u7528\u300C\u7F51\u7EDC \u2192 Agent \u7F51\u7EDC\u300D\u53EF\u67E5\u770B\u6210\u5458; \u8BBE\u7F6E\u91CC\u586B\u7535\u8111\u7AEF\u5730\u5740\u53EF\u628A\u672C\u673A\u767B\u8BB0\u8FDB\u7F51\u7EDC registry\u3002"
+    ].filter((l) => l !== "").join("\n");
+  }
   async function runLocalAgent(goal) {
     const win = typeof window !== "undefined" ? window : null;
     const cap = win?.Capacitor;
+    const joinDocUrl = detectJoinDocUrl(goal);
+    if (joinDocUrl) {
+      _lastWorklog = [`\u{1F9E9} \u8BC6\u522B\u4E3A\u5165\u7F51\u53E3\u4EE4: ${joinDocUrl}`];
+      const r = await joinGatewayFromDoc(joinDocUrl).catch((e) => ({
+        ok: false,
+        docUrl: joinDocUrl,
+        steps: [{ step: "\u5165\u7F51", ok: false, note: String(e?.message || e).slice(0, 120) }],
+        error: String(e?.message || e)
+      }));
+      _lastWorklog = [..._lastWorklog, ...r.steps.map((s2) => `${s2.ok ? "\u2713" : "\u2717"} ${s2.step}: ${s2.note}`)];
+      return formatMobileJoinResult(r);
+    }
     const bridge = cap && cap.Plugins && cap.Plugins.RokidBridge;
     if (bridge && cap.isNativePlatform?.()) {
       try {
@@ -87068,7 +87235,7 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
     } catch {
     }
   }
-  var IDENTITY_DB, _identity, _identityDb, _llmConfig, _lastWorklog, _send, _ownDid, replyHandlers, inboundChatHandlers, mobile_agent_default;
+  var IDENTITY_DB, _identity, _identityDb, _llmConfig, _lastWorklog, MOBILE_JOIN_DOC_RE, MOBILE_JOIN_STATE_KEY, _send, _ownDid, replyHandlers, inboundChatHandlers, mobile_agent_default;
   var init_mobile_agent = __esm({
     "src/web/mobile-agent.ts"() {
       "use strict";
@@ -87078,6 +87245,8 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
       _identityDb = null;
       _llmConfig = null;
       _lastWorklog = [];
+      MOBILE_JOIN_DOC_RE = /read\s+(https?:\/\/\S*bolloon-gateway-join\.md)/i;
+      MOBILE_JOIN_STATE_KEY = "bolloon_gateway_join";
       _send = null;
       _ownDid = "";
       replyHandlers = /* @__PURE__ */ new Set();

package/dist/web/server.js

@@ -3020,14 +3020,61 @@ ${goalDesc}
     // 2026-09-15: agent-delegate (manifest 协议 + agent_delegate) **启动即挂载**
     //   文档 bolloon-gateway-join.md 第 3 节要求 POST /api/agent/register 可用;
     //   之前只在 iroh 懒初始化 (/api/iroh/info 首次访问) 的收尾挂上 → 没触发时恒 404。
+    //
+    //   2026-09-15 (二修): 同时注入**真执行器** —— 被委派的一方不再是
+    //   `resultCid: mock-<ts>` 的假签收: 真的跑本地 agent session 出结果,
+    //   并把结果存进 OrbitDB 得到真实内容寻址 CID; 无活跃 channel / 无 LLM 时如实报错。
+    const delegateExecutor = async (req) => {
+        try {
+            const channels = await loadChannels();
+            const active = (() => {
+                try {
+                    const raw = fsSync.existsSync(path.join(process.env.HOME || '/tmp', '.bolloon', 'active-channel.json'))
+                        ? fsSync.readFileSync(path.join(process.env.HOME || '/tmp', '.bolloon', 'active-channel.json'), 'utf-8') : '';
+                    return raw ? JSON.parse(raw) : null;
+                }
+                catch {
+                    return null;
+                }
+            })();
+            const ch = channels.find((c) => c.id === active?.channelId) || channels.find((c) => c.id === active?.id) || channels[0];
+            if (!ch)
+                return { ok: false, summary: 'no local channel to execute with', error: 'no-channel' };
+            const agent = await getAgentForChannel(ch.id, ch.publicKey, ch.name, ch.didDocument);
+            const task = [
+                `【被委派任务 · 能力 ${req.capability}】`,
+                req.instruction,
+                req.docPath ? `\n资料路径: ${req.docPath}` : '',
+                req.docContent ? `\n资料内容:\n${req.docContent}` : '',
+                `\n(来自 agent ${req.fromAgentId || 'unknown'})，请直接给出可交付结果。`,
+            ].join('');
+            const out = await agent.prompt(task);
+            const text = String(out || '').trim();
+            if (!text || text.startsWith('❌') || text.startsWith('[AI 服务调用失败]')) {
+                return { ok: false, summary: text.slice(0, 800) || '(空结果)', error: 'execution-failed' };
+            }
+            // 真结果 → 内容寻址存储 (CID), 失败不编造 CID, 只回摘要
+            let cid;
+            try {
+                const { getCIDDatabase } = await import('../orbitdb/cid-database.js');
+                const rec = await getCIDDatabase().save({ agentId: req.targetAgentId, type: 'context', content: text, metadata: { capability: req.capability, fromAgentId: req.fromAgentId, kind: 'delegate-result' } });
+                cid = rec?.id;
+            }
+            catch { /* 存不上就不给 CID */ }
+            return { ok: true, summary: text.slice(0, 4000), resultCid: cid };
+        }
+        catch (e) {
+            return { ok: false, summary: `delegate executor failed: ${String(e?.message || e).slice(0, 300)}`, error: 'executor-error' };
+        }
+    };
     let agentDelegateMounted = false;
     try {
         const delegateTransport = createIrohDelegateTransport({ verbose: true });
         // 注意: createAgentDelegateApp 内部声明的是绝对路径 (/api/agent/...),
         // 所以挂载时**不能**再带 '/api/agent' 前缀 (否则变成 /api/agent/api/agent/... 恒 404)
-        app.use(createAgentDelegateApp(delegateTransport));
+        app.use(createAgentDelegateApp(delegateTransport, { execute: delegateExecutor }));
         agentDelegateMounted = true;
-        console.log('[agent-delegate] 已挂载到 /api/agent (启动即用: local-manifest / register / pick / delegate)');
+        console.log('[agent-delegate] 已挂载到 /api/agent (启动即用: local-manifest / register / pick / delegate, 真执行器已注入)');
     }
     catch (e) {
         console.warn('[agent-delegate] 挂载失败 (非致命):', e?.message);
@@ -6588,10 +6635,10 @@ ${goalDesc}
             if (!agentDelegateMounted) {
                 try {
                     const delegateTransport = createIrohDelegateTransport({ verbose: true });
-                    const delegateApp = createAgentDelegateApp(delegateTransport);
+                    const delegateApp = createAgentDelegateApp(delegateTransport, { execute: delegateExecutor });
                     app.use(delegateApp);
                     agentDelegateMounted = true;
-                    console.log('[iroh API] agent-delegate app 已挂载到 /api/agent (补挂)');
+                    console.log('[iroh API] agent-delegate app 已挂载到 /api/agent (补挂, 真执行器已注入)');
                 }
                 catch (e) {
                     console.error('[iroh API] 挂载 agent-delegate app 失败:', e);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolloon/bolloon-agent",
-  "version": "0.4.23",
+  "version": "0.4.24",
   "type": "module",
   "description": "P2P AI Document Agent - 全局安装后执行 `bolloon` 启动产品",
   "main": "dist/cli-entry.js",