@bolloon/bolloon-agent 0.4.18 → 0.4.19

package/dist/web/mobile-gateway.js

@@ -0,0 +1,191 @@
+// ─── 手机端 Gateway (browser-safe, 与桌面同一协议) ────────────────────────
+//   手机 WebView 跑不了 OrbitDB/Helia → 入网走 browser-safe 路径:
+//     ① https://.../registry → 直接 fetch JSON+meta (与桌面 fetchRemoteRegistry 同构)
+//     ② orbitdb:// | ipns://  → 需桌面节点 → 若有 desktopBaseUrl 则转发 /api/gateway/join, 否则明确提示
+//   成员 schema 与桌面一致 (AgentService: agentId=did / service{name,price} / capabilities)。
+import { parseNetworkLink, detectGatewayLink } from '../agents/network-link.js';
+const MEMBERS_KEY = 'bolloon_mobile_net_members';
+const DESKTOP_URL_KEY = 'bolloon_desktop_base_url';
+/** 手机侧持久化的桌面节点 API 基址 (设置页填; localStorage) */
+export function getDesktopBaseUrl() {
+    try {
+        return typeof localStorage !== 'undefined' ? (localStorage.getItem(DESKTOP_URL_KEY) || '') : '';
+    }
+    catch {
+        return '';
+    }
+}
+export function setDesktopBaseUrl(url) {
+    try {
+        if (typeof localStorage !== 'undefined')
+            localStorage.setItem(DESKTOP_URL_KEY, String(url || ''));
+    }
+    catch { /* 忽略 */ }
+}
+function defaultStorage() {
+    let mem = [];
+    return {
+        get: () => {
+            try {
+                const s = typeof localStorage !== 'undefined' ? localStorage.getItem(MEMBERS_KEY) : null;
+                return s ? JSON.parse(s) : [];
+            }
+            catch {
+                return [];
+            }
+        },
+        set: (m) => {
+            mem = m;
+            try {
+                if (typeof localStorage !== 'undefined')
+                    localStorage.setItem(MEMBERS_KEY, JSON.stringify(m));
+            }
+            catch { /* 忽略 */ }
+        },
+    };
+}
+function afetch(opts) {
+    return opts.fetch || globalThis.fetch;
+}
+/** 从 HTTP registry 端点拉 {services, meta} (browser-safe) */
+async function fetchHttpRegistry(url, opts) {
+    try {
+        const f = afetch(opts);
+        const signal = typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function' ? AbortSignal.timeout(15000) : undefined;
+        const r = await f(url, signal ? { signal } : undefined);
+        if (!r.ok)
+            return null;
+        const d = await r.json();
+        const services = Array.isArray(d) ? d : d?.services;
+        if (!Array.isArray(services))
+            return null;
+        return { services: services, meta: d?.meta };
+    }
+    catch {
+        return null;
+    }
+}
+function mergeMembers(remote, local) {
+    const out = local.slice();
+    let joined = 0;
+    for (const m of remote) {
+        if (!m?.agentId)
+            continue;
+        const exists = out.some((l) => l.agentId === m.agentId && (l.service?.name || '') === (m.service?.name || ''));
+        if (!exists) {
+            out.push(m);
+            joined++;
+        }
+    }
+    return { merged: out, joined };
+}
+/** 手机入网: https registry 直接拉; orbitdb/ipns 转发桌面 (或提示) */
+export async function mobileJoinNetwork(link, opts = {}) {
+    const parsed = parseNetworkLink(link);
+    if (!parsed)
+        return { ok: false, error: '无法解析链接' };
+    if (parsed.kind === 'http') {
+        const r = await fetchHttpRegistry(parsed.url || parsed.value, opts);
+        if (!r)
+            return { ok: false, error: '远端 registry 不可达' };
+        const st = opts.storage || defaultStorage();
+        const { merged, joined } = mergeMembers(r.services, st.get());
+        st.set(merged);
+        return { ok: true, joined, total: r.services.length, networkName: parsed.networkName, meta: r.meta };
+    }
+    // orbitdb/ipns → 桌面转发 (默认用设置页持久化的 desktopBaseUrl)
+    const desktopBaseUrl = opts.desktopBaseUrl || getDesktopBaseUrl();
+    if (desktopBaseUrl) {
+        try {
+            const f = afetch(opts);
+            const r = await f(`${String(desktopBaseUrl).replace(/\/$/, '')}/api/gateway/join`, {
+                method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ link }),
+            });
+            const j = r.ok ? await r.json() : null;
+            if (r.ok && j?.ok)
+                return { ok: true, joined: j.joined ?? 0, total: j.total ?? 0, viaDesktop: true };
+            return { ok: false, error: j?.error || '桌面加入失败', viaDesktop: true };
+        }
+        catch (e) {
+            return { ok: false, error: `桌面转发失败: ${String(e?.message || e).slice(0, 120)}`, viaDesktop: true };
+        }
+    }
+    return { ok: false, error: 'orbitdb/ipns 链接需桌面节点: 请用 https://.../registry 链接, 或配置 desktopBaseUrl' };
+}
+/** 手机注册本机声明 (写入本地成员表, 供网络画像展示) */
+export function mobileRegister(self, opts = {}) {
+    const st = opts.storage || defaultStorage();
+    const cur = st.get();
+    const i = cur.findIndex((m) => m.agentId === self.agentId && (m.service?.name || '') === (self.service?.name || ''));
+    if (i >= 0)
+        cur[i] = self;
+    else
+        cur.push(self);
+    st.set(cur);
+}
+/** 手机网络状态 (本地成员表) */
+export function mobileNetworkStatus(opts = {}) {
+    return (opts.storage || defaultStorage()).get();
+}
+/** 拉共享 context (browser-safe: HTTP IPFS 网关) */
+export async function mobilePullSharedContext(cid, opts = {}) {
+    try {
+        const gw = String(opts.ipfsGateway || 'https://ipfs.io').replace(/\/$/, '');
+        const f = afetch(opts);
+        const r = await f(`${gw}/ipfs/${cid}`, { signal: AbortSignal.timeout?.(15000) });
+        return r.ok ? await r.text() : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 自动加入入口: 文本检测到 gateway 链接 → join (幂等). 返回通知或 null */
+export async function mobileAutoJoinGateway(text, opts = {}) {
+    const link = detectGatewayLink(text);
+    if (!link)
+        return null;
+    const r = await mobileJoinNetwork(link, opts);
+    if (r.ok) {
+        return `🆕 已加入 Agent 网络${r.networkName ? `「${r.networkName}」` : ''}${r.viaDesktop ? '(经桌面)' : ''}: 拉取 ${r.total ?? 0} 个成员, 新增 ${r.joined ?? 0} 个。`;
+    }
+    return `⚠️ 检测到网络链接但加入失败: ${r.error}`;
+}
+/**
+ * 手机端 gateway 工具统一分派 (供 Kotlin AgentRuntime 或 JS 路由调用):
+ *   gateway_join(link) / gateway_status() / gateway_register(self) / gateway_context(cid)
+ * 返回 {ok, output} 给 agent 作为工具结果文本.
+ */
+export async function mobileGatewayTool(name, args, opts = {}) {
+    const n = String(name || '').trim();
+    if (n === 'gateway_join') {
+        const link = String(args?.link || args?.url || args?.value || '');
+        if (!link)
+            return { ok: false, output: 'gateway_join 需要 link 参数 (orbitdb:// / ipns:// / https://.../registry)' };
+        const r = await mobileJoinNetwork(link, opts);
+        return r.ok
+            ? { ok: true, output: `已加入 Agent 网络${r.networkName ? `「${r.networkName}」` : ''}: ${r.total ?? 0} 成员, 新增 ${r.joined ?? 0}` }
+            : { ok: false, output: `加入失败: ${r.error}` };
+    }
+    if (n === 'gateway_status') {
+        const m = mobileNetworkStatus(opts);
+        return m.length
+            ? { ok: true, output: m.map((x) => `${x.name} (${String(x.agentId).slice(0, 12)}…) ${x.service?.name || ''}`).join('\n') }
+            : { ok: true, output: '（网络为空: 先 gateway_join 或设置 desktopBaseUrl）' };
+    }
+    if (n === 'gateway_register') {
+        const self = args?.self || args;
+        if (self?.agentId) {
+            mobileRegister(self, opts);
+            return { ok: true, output: '已注册本机声明' };
+        }
+        return { ok: false, output: 'gateway_register 需要 self{agentId,name,service?}' };
+    }
+    if (n === 'gateway_context') {
+        const cid = String(args?.cid || '');
+        if (!cid)
+            return { ok: false, output: 'gateway_context 需要 cid' };
+        const t = await mobilePullSharedContext(cid, opts);
+        return t ? { ok: true, output: t.slice(0, 400) } : { ok: false, output: '共享 context 拉取失败' };
+    }
+    return { ok: false, output: `未知 gateway 工具: ${n}` };
+}

package/dist/web/mobile.html

@@ -52,6 +52,13 @@
 
   <!-- 网络 tab -->
   <section class="page" id="page-network" data-tab="network" hidden>
+    <div class="list">
+      <div class="list-item" id="item-join-net"><span class="list-icon">🛜</span><span>加入网络</span></div>
+      <div class="list-item" id="item-scan-net"><span class="list-icon">📷</span><span>扫码入网</span></div>
+    </div>
+    <input type="file" id="qr-scan-input" accept="image/*" capture="environment" style="display:none">
+    <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">🌐</span><span>P2P 好友</span></div>
       <div class="list-item" id="item-p2p-id"><span class="list-icon">🪪</span><span>我的 P2P ID</span></div>

package/dist/web/mobile.js

@@ -46,7 +46,7 @@
     $$('.tab').forEach((t) => t.classList.toggle('active', t.dataset.tab === tab));
     $('#topbar-title').textContent = TITLES[tab] || '会话';
     const cs = $('#btn-create-session'); if (cs) cs.hidden = tab !== 'main';
-    if (tab === 'network') { loadContacts(); loadMcpTools(); loadApprovals(); }
+    if (tab === 'network') { loadContacts(); loadMcpTools(); loadApprovals(); loadNetMembers(); }
     if (tab === 'main') { loadAgentCovers(); }
     window.__mobileTouch?.('tab', tab);
   }
@@ -1199,6 +1199,57 @@
       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)
+    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();
+    });
+    // #3 扫码入网: 拍照/选图 → BolloonCore.qr.decode(jsQR) → gateway.join (免原生插件)
+    const scanBtn = $('#item-scan-net');
+    const scanInput = $('#qr-scan-input');
+    if (scanBtn && scanInput) scanBtn.addEventListener('click', () => scanInput.click());
+    if (scanInput) scanInput.addEventListener('change', (e) => {
+      const f = e.target.files && e.target.files[0];
+      if (!f) return;
+      scanInput.value = '';
+      const img = new Image();
+      const url = URL.createObjectURL(f);
+      img.onload = async () => {
+        try {
+          const c = document.createElement('canvas');
+          c.width = img.naturalWidth; c.height = img.naturalHeight;
+          const c2 = c.getContext('2d');
+          if (!c2) return alert('画布不可用');
+          c2.drawImage(img, 0, 0);
+          const id = c2.getImageData(0, 0, c.width, c.height);
+          const text = await (window.BolloonCore && window.BolloonCore.qr && window.BolloonCore.qr.decode(id.data, id.width, id.height));
+          if (!text) { alert('未识别到二维码 (试试 /net qr 重新出码)'); return; }
+          const r = await (window.BolloonCore && window.BolloonCore.gateway && window.BolloonCore.gateway.join(text));
+          alert(r ? (r.output || '已入网') : 'gateway.join 不可用');
+          loadNetMembers();
+        } catch (err) { alert('解码失败: ' + String((err && err.message) || err).slice(0, 120)); }
+        finally { URL.revokeObjectURL(url); }
+      };
+      img.onerror = () => { alert('图片读取失败'); URL.revokeObjectURL(url); };
+      img.src = url;
+    });
+  }
+
+  async function loadNetMembers() {
+    const el = $('#net-members');
+    if (!el) return;
+    try {
+      const r = await (window.BolloonCore && window.BolloonCore.gateway && window.BolloonCore.gateway.status());
+      if (r && r.output) {
+        el.innerHTML = r.output.split('\n').filter(Boolean).map((l) => `<div class="list-item">${escapeHtml(l)}</div>`).join('');
+      } else el.innerHTML = '<div class="list-item">（网络为空）</div>';
+    } catch (e) { el.innerHTML = '<div class="list-item">网络状态获取失败</div>'; }
   }
 
   function escapeHtml(s) {

package/dist/web/qr.js

@@ -0,0 +1,49 @@
+// ─── 扫码入网: 二维码编解码 (纯 JS, PC 出码 / 手机扫码) ─────────────────────
+//   encode: qrcode → 终端 ASCII / dataURL; decode: jsQR (浏览器 camera/capture 图).
+//   payload 是一份短文本: <网络链接>?name=..&ctx=<cid>&v=.., 手机 decode 后 detectGatewayLink → join.
+import QRCode from 'qrcode';
+import jsQR from 'jsqr';
+/** 组装"扫码即入网"短文本 (链接 + 可选 query) */
+export function buildQrPayload(o) {
+    let s = String(o.link || '').trim();
+    const params = new URLSearchParams();
+    if (o.name)
+        params.set('name', o.name);
+    if (o.ctxCid)
+        params.set('ctx', o.ctxCid);
+    if (o.version)
+        params.set('v', o.version);
+    const q = params.toString();
+    if (q)
+        s += (s.includes('?') ? '&' : '?') + q;
+    return s;
+}
+/** 终端 ASCII 二维码 (半块字符 ▄█), 供 CLI /net qr 面板显示 */
+export async function encodeQrTerminal(text) {
+    try {
+        const s = await QRCode.toString(text, { type: 'terminal', small: true });
+        return s || '';
+    }
+    catch {
+        return '';
+    }
+}
+/** 浏览器/客户端图片二维码 (dataURL), 供 Web 端显示 */
+export async function encodeQrDataUrl(text) {
+    try {
+        return await QRCode.toDataURL(text, { width: 320, margin: 2 });
+    }
+    catch {
+        return '';
+    }
+}
+/** 解码: 传入 RGBA 像素 (来自 canvas getImageData), 返回二维码文本或 null */
+export function decodeQrImageData(data, width, height) {
+    try {
+        const r = jsQR(data, width, height);
+        return r?.data ?? null;
+    }
+    catch {
+        return null;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolloon/bolloon-agent",
-  "version": "0.4.18",
+  "version": "0.4.19",
   "type": "module",
   "description": "P2P AI Document Agent - 全局安装后执行 `bolloon` 启动产品",
   "main": "dist/cli-entry.js",
@@ -88,10 +88,12 @@
     "ink": "^7.1.1",
     "ink-text-input": "^6.0.0",
     "js-yaml": "^5.4.1",
+    "jsqr": "^1.4.0",
     "libp2p": "^3.3.11",
     "mammoth": "^1.12.2",
     "pdf-parse": "^2.4.5",
     "platform": "^1.3.6",
+    "qrcode": "^1.5.4",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "viem": "^2.56.3"
@@ -102,6 +104,7 @@
     "@types/express": "^5.0.6",
     "@types/node": "^26.5.0",
     "@types/pdf-parse": "^1.1.5",
+    "@types/qrcode": "^1.5.6",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.7",
     "concurrently": "^10.0.5",