@bolloon/bolloon-agent 0.4.9 → 0.4.10

package/dist/agents/pi-sdk-tools.js

@@ -34,6 +34,84 @@ export const SIDE_EFFECT_TOOLS = new Set([
     'write_file', 'edit_file', 'shell_exec', 'git_commit', 'git_push', 'git_branch',
     'create_task', 'update_task', 'terminal', 'process',
 ]);
+/** 2026-08-12 (TaskA): 探测可用的命令 (跨平台: Windows 无 python3, 有 python). 返回 [cmd, ...] 或 null. */
+async function detectRunner(candidates) {
+    const { spawn } = await import('child_process');
+    for (const c of candidates) {
+        try {
+            const ok = await new Promise((resolve) => {
+                const p = spawn(c, ['--version'], { stdio: 'ignore', windowsHide: true });
+                p.on('close', (code) => resolve(code === 0));
+                p.on('error', () => resolve(false));
+            });
+            if (ok)
+                return [c];
+        }
+        catch { /* 下一个 */ }
+    }
+    return null;
+}
+export async function runCodeSnippet(opts) {
+    const code = String(opts.code ?? '').trim();
+    if (!code)
+        return { success: false, error: 'code 必填' };
+    const lang = String(opts.language || '').trim().toLowerCase();
+    // 语言 → (扩展名, 解释器命令)
+    const ext = lang === 'python' || lang === 'py' ? 'py'
+        : lang === 'javascript' || lang === 'js' || lang === 'node' ? 'js'
+            : lang === 'typescript' || lang === 'ts' ? 'ts'
+                : lang === 'shell' || lang === 'bash' || lang === 'sh' ? 'sh'
+                    : lang === 'html' ? 'html'
+                        : 'txt';
+    const runner = lang === 'python' || lang === 'py' ? await detectRunner(['python3', 'python'])
+        : lang === 'javascript' || lang === 'js' || lang === 'node' ? await detectRunner(['node'])
+            : lang === 'typescript' || lang === 'ts' ? ['npx', 'tsx']
+                : lang === 'shell' || lang === 'bash' || lang === 'sh' ? ['bash']
+                    : null;
+    if (!runner) {
+        if (['python', 'py', 'js', 'javascript', 'node', 'ts', 'typescript', 'shell', 'bash', 'sh'].includes(lang)) {
+            return { success: false, error: `解释器未找到 (${lang}), 请装对应运行时或改用 command` };
+        }
+        return { success: false, error: `不支持的语言 '${lang}', 支持: python/js/ts/shell/html` };
+    }
+    const { tmpdir } = await import('os');
+    const tmpDir = opts.tmpDir ?? tmpdir();
+    const file = `${tmpDir}/bolloon-code-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.${ext}`;
+    const fsMod = await import('fs/promises');
+    await fsMod.writeFile(file, code, 'utf-8');
+    try {
+        const { spawn } = await import('child_process');
+        const timeoutMs = opts.timeoutMs ?? 30000;
+        const result = await new Promise((resolve) => {
+            const proc = spawn(runner[0], [...runner.slice(1), file], {
+                cwd: opts.cwd ?? process.cwd(),
+                env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
+                windowsHide: true,
+            });
+            let stdout = '';
+            let stderr = '';
+            const timer = setTimeout(() => {
+                try {
+                    proc.kill('SIGKILL');
+                }
+                catch { /* 忽略 */ }
+                resolve({ success: false, error: `代码执行超时 (>${timeoutMs}ms)`, output: (stdout + (stderr ? `\n[stderr]\n${stderr}` : '')).trim().slice(0, 8000) });
+            }, timeoutMs);
+            proc.stdout.on('data', (d) => { stdout += d.toString(); });
+            proc.stderr.on('data', (d) => { stderr += d.toString(); });
+            proc.on('error', (e) => { clearTimeout(timer); resolve({ success: false, error: `启动失败: ${e.message}` }); });
+            proc.on('close', (code) => {
+                clearTimeout(timer);
+                const output = (stdout + (stderr ? `\n[stderr]\n${stderr}` : '')).trim().slice(0, 8000) || '(无输出)';
+                resolve({ success: code === 0, output, exitCode: code, language: lang, script: file });
+            });
+        });
+        return result;
+    }
+    finally {
+        await fsMod.rm(file, { force: true }).catch(() => { });
+    }
+}
 export async function runTerminalCommand(raw, opts = {}) {
     const { checkTerminalCommand } = await import('./shell-guard.js');
     const timeoutMs = opts.timeoutMs ?? 30000;
@@ -716,14 +794,20 @@ export function registerBuiltinTools(ctx) {
     //   与 shell_exec 的区别: 直接接受完整 shell 命令字符串, 更适合模型自主写命令.
     ctx.tools.set('terminal', {
         name: 'terminal',
-        description: '执行完整 shell 命令 (支持管道/重定向/写文件/跑脚本). 护栏只挡高危破坏操作 (sudo/格式化/rm -rf 根目录/写 ~/.bolloon 数据), 其余灵活放行. 适合: 写 HTML 文件、跑 python/node 脚本、查系统状态、装依赖. 多条命令用 commands 数组并行执行. 长命令 (服务器/构建/后台任务) 设 background=true 后台执行不阻塞对话.',
-        parameters: { command: '完整 shell 命令 (必填, 如: echo "<html>" > /tmp/site/index.html && ls /tmp/site)', commands: '可选: 多条命令数组 (并行执行), 每条独立字符串', timeoutMs: '超时毫秒, 默认 30000', background: '可选: true 后台执行, 立即返回 session_id (用 process 工具 poll/wait/kill)' },
+        description: '执行完整 shell 命令 (支持管道/重定向/写文件/跑脚本). 护栏只挡高危破坏操作 (sudo/格式化/rm -rf 根目录/写 ~/.bolloon 数据), 其余灵活放行. 适合: 写 HTML 文件、跑 python/node 脚本、查系统状态、装依赖. 多条命令用 commands 数组并行执行. 长命令 (服务器/构建/后台任务) 设 background=true 后台执行不阻塞对话. 也可直接传 code+language 自动写脚本执行 (便捷代码运行: python/js/ts/shell/html).',
+        parameters: { command: '完整 shell 命令 (可选, 如: echo "<html>" > /tmp/site/index.html && ls /tmp/site)', commands: '可选: 多条命令数组 (并行执行), 每条独立字符串', code: '可选: 一段代码, 传 code+language 时自动写脚本执行 (便捷代码运行)', language: '可选: code 的语言 (python/js/ts/shell/html), 默认自动', timeoutMs: '超时毫秒, 默认 30000', background: '可选: true 后台执行, 立即返回 session_id (用 process 工具 poll/wait/kill)' },
         execute: async (args) => {
+            const timeoutMs = Number(args.timeoutMs) || 30000;
+            // 便捷代码运行: 传 code → 自动写脚本执行
+            const code = String(args.code ?? '').trim();
+            if (code) {
+                const lang = String(args.language || '').trim().toLowerCase();
+                return await runCodeSnippet({ code, language: lang, timeoutMs, cwd: ctx.cwd });
+            }
             const raw = String(args.command || '').trim();
             const commands = Array.isArray(args.commands) ? args.commands.map((c) => String(c || '').trim()).filter(Boolean) : [];
             if (!raw && commands.length === 0)
-                return { success: false, error: 'command 或 commands 必填' };
-            const timeoutMs = Number(args.timeoutMs) || 30000;
+                return { success: false, error: 'command/code/commands 至少一个必填' };
             return await runTerminalCommand(raw, { timeoutMs, cwd: ctx.cwd, commands: commands.length > 0 ? commands : undefined, background: String(args.background).toLowerCase() === 'true' });
         }
     });
@@ -2131,6 +2215,34 @@ export function registerBuiltinTools(ctx) {
             }
         }
     });
+    // 2026-08-12: MCP 驱动前端 UI 工具 — agent 理解用户意图后调用, 通过 SSE 广播驱动前端组件.
+    //   复用 ui-tools (dispatchUiAction → broadcast {type:'ui'}), 前端订阅 /events 执行.
+    const registerUiAgentTools = async () => {
+        const ui = await import('../pi-ecosystem-mcp/ui-tools.js');
+        // 注册到 MCP 系统 (供 mcp_list_tools 可见) + 注册为 agent 工具
+        ui.registerUiControlTools();
+        const uiTools = [
+            { name: 'ui_switch_tab', description: '驱动前端切换底部 tab (微信/通讯录/发现/我). 用户想"去通讯录/去设置/去我的"时调用.', params: { tab: 'wechat|contacts|discover|me (必填)' }, map: (a) => ({ action: 'switchTab', data: { tab: String(a.tab || '') } }) },
+            { name: 'ui_open_chat', description: '驱动前端打开某个智能体聊天页. 用户想"打开和 X 的聊天"时调用.', params: { channelId: '目标 channel id (必填)' }, map: (a) => ({ action: 'openChat', data: { channelId: String(a.channelId || '') } }) },
+            { name: 'ui_open_settings', description: '驱动前端打开设置页.', params: {}, map: () => ({ action: 'openSettings', data: {} }) },
+            { name: 'ui_open_wallet', description: '驱动前端打开钱包.', params: {}, map: () => ({ action: 'openWallet', data: {} }) },
+            { name: 'ui_open_add_friend', description: '驱动前端打开添加好友.', params: {}, map: () => ({ action: 'openAddFriend', data: {} }) },
+            { name: 'ui_show_toast', description: '驱动前端顶部显示提示 (toast).', params: { message: '提示内容 (必填)' }, map: (a) => ({ action: 'showToast', data: { message: String(a.message || '') } }) },
+            { name: 'ui_go_back', description: '驱动前端返回上一页.', params: {}, map: () => ({ action: 'goBack', data: {} }) },
+        ];
+        for (const t of uiTools) {
+            ctx.tools.set(t.name, {
+                name: t.name,
+                description: t.description,
+                parameters: t.params,
+                execute: async (args) => {
+                    const r = ui.dispatchUiAction(t.map(args));
+                    return r.success ? { success: true, output: r.output } : { success: false, error: r.output };
+                },
+            });
+        }
+    };
+    registerUiAgentTools().catch(() => { });
     // ============================================================
     // publish_did (2026-08-03) — 把当前 agent 的 DID 发布到 IPFS + IPNS
     // 全自动: 自动安装/启动本地 Kubo → 上传 DID 文档 → 发布 IPNS name

package/dist/agents/python-exec.js

@@ -0,0 +1,115 @@
+/**
+ * python-exec.ts — Python 代码执行引擎 (2026-08-12, TaskP)
+ *
+ * 借鉴 hermes code_execution_tool: 让 agent 输入 Python 代码运行操作, 而非逐条 shell 命令.
+ * 设计:
+ *   - 把 LLM 给的 Python 代码写到临时文件, 用 python3 子进程执行 (隔离, 不污染主进程)
+ *   - 带超时 + kill (子进程跑太久强制终止)
+ *   - stdout/stderr 合并捕获 + 截断 (head+tail, 显式 truncation 标记 — hermes 模式)
+ *   - 依赖检测: 找不到 python3 返回明确错误
+ *
+ * 安全: 不 eval (子进程隔离); 代码里若含高危 shell (os.system("rm -rf /") 等) 走 checkTerminalCommand 预检 (最佳努力).
+ */
+import { spawn } from 'child_process';
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+const MAX_OUTPUT = 16000; // 捕获输出上限 (head+tail)
+/** 探测可用的 python 解释器 (python3 / python) */
+async function detectPython() {
+    const candidates = process.platform === 'win32' ? ['python', 'py'] : ['python3', 'python'];
+    for (const c of candidates) {
+        try {
+            await new Promise((resolve, reject) => {
+                const p = spawn(c, ['--version'], { stdio: 'ignore', windowsHide: true });
+                p.on('close', (code) => (code === 0 ? resolve() : reject(new Error('exit ' + code))));
+                p.on('error', reject);
+            });
+            return c;
+        }
+        catch { /* 下一个 */ }
+    }
+    return null;
+}
+/**
+ * 截断输出: 保留 head + tail, 中间省略, 返回截断标记 (hermes 模式).
+ */
+export function truncateOutput(text) {
+    if (text.length <= MAX_OUTPUT)
+        return { text, truncated: false };
+    const head = text.slice(0, 4000);
+    const tail = text.slice(-4000);
+    return { text: `${head}\n…[输出截断 ${text.length - 8000} 字节]…\n${tail}`, truncated: true };
+}
+/** 最佳努力: 代码里明显的高危 shell 调用预检 (防 os.system("rm -rf /") 等) */
+function checkDangerousCode(code) {
+    const dangerous = [
+        { re: /os\.system\s*\(\s*["']\s*rm\s+(-[a-z]*f[a-z]*\s+)?-[a-z]*r[a-z]*\s+\//, reason: '禁止递归删除根目录' },
+        { re: /shutil\.rmtree\s*\(\s*["']\s*\//, reason: '禁止删除根目录' },
+        { re: /os\.system\s*\(\s*["']\s*(sudo|mkfs|dd\s+if=.*of=\/dev)/, reason: '禁止高危系统命令' },
+    ];
+    for (const { re, reason } of dangerous) {
+        if (re.test(code))
+            return { allowed: false, reason };
+    }
+    return { allowed: true };
+}
+/**
+ * 执行一段 Python 代码 (隔离子进程 + 超时 + 输出截断).
+ */
+export async function executePython(opts) {
+    const code = String(opts.code ?? '').trim();
+    if (!code)
+        return { success: false, error: 'code 必填', output: '' };
+    // 高危代码预检 (最佳努力)
+    const d = checkDangerousCode(code);
+    if (!d.allowed)
+        return { success: false, error: `[python-guard] ${d.reason}`, deniedByGuard: true, output: '' };
+    // 探测 python
+    const python = await detectPython();
+    if (!python) {
+        return { success: false, error: '未找到 python3/python 解释器, 无法执行 Python 代码', output: '' };
+    }
+    // 写临时文件
+    const tmpFile = path.join(os.tmpdir(), `bolloon-py-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.py`);
+    await fs.writeFile(tmpFile, code, 'utf-8');
+    const timeoutMs = opts.timeoutMs ?? 30000;
+    try {
+        const result = await new Promise((resolve) => {
+            const proc = spawn(python, [tmpFile], {
+                cwd: opts.cwd ?? process.cwd(),
+                env: { ...process.env, GIT_TERMINAL_PROMPT: '0', PYTHONIOENCODING: 'utf-8' },
+                windowsHide: true,
+            });
+            let stdout = '';
+            let stderr = '';
+            const timer = setTimeout(() => {
+                try {
+                    proc.kill('SIGKILL');
+                }
+                catch { /* 忽略 */ }
+                resolve({ success: false, output: '', error: `Python 执行超时 (>${timeoutMs}ms), 已终止`, exitCode: -1, python });
+            }, timeoutMs);
+            proc.stdout.on('data', (d) => { stdout += d.toString(); });
+            proc.stderr.on('data', (d) => { stderr += d.toString(); });
+            proc.on('error', (e) => { clearTimeout(timer); resolve({ success: false, output: '', error: `启动失败: ${e.message}`, python }); });
+            proc.on('close', (code) => {
+                clearTimeout(timer);
+                const raw = (stdout + (stderr ? `\n[stderr]\n${stderr}` : '')).trim();
+                const { text, truncated } = truncateOutput(raw || '(无输出)');
+                resolve({
+                    success: code === 0,
+                    output: text,
+                    stdoutTruncated: truncated,
+                    exitCode: code,
+                    error: code === 0 ? undefined : `exit code ${code}`,
+                    python,
+                });
+            });
+        });
+        return result;
+    }
+    finally {
+        await fs.rm(tmpFile, { force: true }).catch(() => { });
+    }
+}

package/dist/pi-ecosystem-mcp/ui-tools.js

@@ -0,0 +1,108 @@
+/**
+ * ui-tools.ts — MCP 驱动的前端 UI 控制工具 (2026-08-12)
+ *
+ * 目标: bolloon 作为 MCP server 暴露 UI 控制工具, agent 理解用户意图后
+ * 通过 MCP 调用这些工具, 驱动前端 (web / 手机端 Capacitor) 的 UI 组件.
+ *
+ * 机制:
+ *   - 注册一组 UI 控制工具到 MCP 系统 (registerTool), 供 agent 用 mcp_tool 调用
+ *   - 工具 execute 时通过注入的 broadcast 回调, 广播 { type: 'ui', action, data } 给前端 (SSE /events)
+ *   - 前端订阅 /events, 收到 ui 指令执行对应组件 (switchTab/openChat/openSettings 等)
+ *
+ * 设计: UI 工具不走外部 MCP server (executeTool 硬依赖 server), 而是本地 handler + broadcast.
+ */
+import { registerTool, listTools } from './index.js';
+/** broadcast 注入点 (由 server 调用 setUiBroadcast 注入, 广播给前端 SSE) */
+let uiBroadcast = null;
+/** 注入广播函数 (server 启动时调用, 关联到 SSE /events) */
+export function setUiBroadcast(fn) {
+    uiBroadcast = fn;
+}
+/** 广播一条 UI 控制指令给所有前端 */
+export function broadcastUiAction(action, data) {
+    if (!uiBroadcast)
+        return false;
+    uiBroadcast({ type: 'ui', action, data: data ?? {} });
+    return true;
+}
+/** 把一次 UI 工具调用 (agent 意图理解后发起) 广播给前端 */
+export function dispatchUiAction(call) {
+    const { action, data } = call || {};
+    if (!action)
+        return { success: false, output: 'action 必填 (switchTab/openChat/openSettings 等)' };
+    const ok = broadcastUiAction(action, data);
+    return { success: ok, output: ok ? `已驱动前端: ${action}` : 'UI 广播未连接' };
+}
+/** 注册 UI 控制工具到 MCP 系统 (供 agent mcp_tool 调用) */
+export function registerUiControlTools() {
+    const toolDefs = [
+        {
+            name: 'ui_switch_tab',
+            description: '驱动前端切换底部 tab. 用户想"去通讯录/去我的/去设置"时调用. tab: wechat|contacts|discover|me',
+            inputSchema: { type: 'object', properties: { tab: { type: 'string' } }, required: ['tab'] },
+        },
+        {
+            name: 'ui_open_chat',
+            description: '驱动前端打开某个智能体聊天页. 用户想"打开和 X 的聊天"时调用. channelId: 目标 channel',
+            inputSchema: { type: 'object', properties: { channelId: { type: 'string' } }, required: ['channelId'] },
+        },
+        {
+            name: 'ui_open_settings',
+            description: '驱动前端打开设置页. 用户想"打开设置/配置"时调用.',
+            inputSchema: { type: 'object', properties: {} },
+        },
+        {
+            name: 'ui_open_wallet',
+            description: '驱动前端打开钱包. 用户想"看钱包/支付"时调用.',
+            inputSchema: { type: 'object', properties: {} },
+        },
+        {
+            name: 'ui_open_add_friend',
+            description: '驱动前端打开添加好友. 用户想"添加好友"时调用.',
+            inputSchema: { type: 'object', properties: {} },
+        },
+        {
+            name: 'ui_send_message',
+            description: '驱动前端在当前聊天发送消息. channelId: 目标 channel, text: 要发的消息文本.',
+            inputSchema: { type: 'object', properties: { channelId: { type: 'string' }, text: { type: 'string' } }, required: ['channelId', 'text'] },
+        },
+        {
+            name: 'ui_show_toast',
+            description: '在前端顶部显示一条提示 (toast). message: 提示内容.',
+            inputSchema: { type: 'object', properties: { message: { type: 'string' } }, required: ['message'] },
+        },
+        {
+            name: 'ui_go_back',
+            description: '驱动前端返回上一页. 用户想"返回/回去"时调用.',
+            inputSchema: { type: 'object', properties: {} },
+        },
+    ];
+    let count = 0;
+    for (const t of toolDefs) {
+        // 已注册则跳过 (幂等)
+        if (listTools().some((x) => x.name === t.name))
+            continue;
+        registerTool({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+            serverName: 'ui', // 本地 UI 工具 (不走外部 server; 由 agent 调用方 dispatch)
+        });
+        count++;
+    }
+    return count;
+}
+/** agent 工具 (pi-sdk-tools 注册) 的 execute 适配: name → UiAction */
+export function uiToolNameToAction(name) {
+    switch (name) {
+        case 'ui_switch_tab': return 'switchTab';
+        case 'ui_open_chat': return 'openChat';
+        case 'ui_open_settings': return 'openSettings';
+        case 'ui_open_wallet': return 'openWallet';
+        case 'ui_open_add_friend': return 'openAddFriend';
+        case 'ui_send_message': return 'sendMessage';
+        case 'ui_show_toast': return 'showToast';
+        case 'ui_go_back': return 'goBack';
+        default: return null;
+    }
+}

package/dist/web/index.html

@@ -5,6 +5,19 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Bolloon Agent</title>
 
+  <!-- 2026-08-12: 手机端 (Capacitor webview / 移动浏览器) 跳转专门的手机端 UI (mobile.html, 微信风格) -->
+  <script>
+    (function () {
+      try {
+        var isCapacitor = window.Capacitor && window.Capacitor.isNativePlatform && window.Capacitor.isNativePlatform();
+        var isMobile = /Android|iPhone|iPad|iPod/i.test(navigator.userAgent);
+        if ((isCapacitor || isMobile) && !location.pathname.endsWith('/mobile.html')) {
+          location.replace('./mobile.html');
+        }
+      } catch (e) { /* 跳转失败静默, 继续桌面 UI */ }
+    })();
+  </script>
+
   <!-- Favicon -->
   <link rel="icon" type="image/x-icon" href="./icons/favicon.ico">
   <link rel="icon" type="image/png" sizes="32x32" href="./icons/favicon-32x32.png">

package/dist/web/mobile.css

@@ -0,0 +1,173 @@
+/* 手机端 UI — 微信风格 + bolloon WebUI 主题 (配色不变) */
+:root {
+  --bg: #1a1a18;
+  --bg-card: #222220;
+  --bg-hover: #2a2a26;
+  --text: #d8d8c8;
+  --text-secondary: #909088;
+  --text-muted: #606058;
+  --accent: #c4d640;
+  --accent-hover: #d4e650;
+  --border: #3a3a36;
+  --radius: 12px;
+  --tabbar-h: 60px;
+  --topbar-h: 56px;
+}
+
+* { margin: 0; padding: 0; box-sizing: border-box; -webkit-tap-highlight-color: transparent; }
+html, body { height: 100%; }
+body {
+  background: var(--bg);
+  color: var(--text);
+  font-family: -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif;
+  overflow: hidden;
+  touch-action: manipulation;
+}
+
+.app {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+}
+
+/* 顶部栏 */
+.topbar {
+  height: var(--topbar-h);
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0 16px;
+  padding-top: env(safe-area-inset-top);
+  background: var(--bg-card);
+  border-bottom: 1px solid var(--border);
+}
+.topbar-title { font-size: 18px; font-weight: 600; color: var(--text); }
+.topbar-actions { display: flex; gap: 12px; }
+.icon-btn {
+  width: 36px; height: 36px;
+  border: none; border-radius: 8px;
+  background: var(--bg-hover);
+  color: var(--accent);
+  font-size: 22px;
+  display: flex; align-items: center; justify-content: center;
+}
+
+/* 页面容器 */
+.page-container { flex: 1; overflow-y: auto; -webkit-overflow-scrolling: touch; }
+.page { min-height: 100%; }
+
+/* 列表 */
+.list { padding: 8px 0; }
+.list-item {
+  display: flex; align-items: center;
+  gap: 12px;
+  padding: 14px 16px;
+  background: var(--bg-card);
+  border-bottom: 1px solid var(--border);
+  cursor: pointer;
+}
+.list-item:active { background: var(--bg-hover); }
+.list-icon { font-size: 20px; width: 32px; text-align: center; }
+.list-item span:nth-child(2) { flex: 1; }
+.list-arrow { color: var(--text-muted); }
+
+/* 分组标签 */
+.section-label {
+  padding: 12px 16px 4px;
+  font-size: 12px;
+  color: var(--text-muted);
+}
+
+/* 会话 / 联系人条目 */
+.conv-item {
+  display: flex; align-items: center; gap: 12px;
+  padding: 12px 16px;
+  background: var(--bg-card);
+  border-bottom: 1px solid var(--border);
+  cursor: pointer;
+}
+.conv-item:active { background: var(--bg-hover); }
+.conv-avatar {
+  width: 44px; height: 44px; border-radius: 8px;
+  background: var(--accent);
+  color: var(--bg);
+  display: flex; align-items: center; justify-content: center;
+  font-size: 18px; font-weight: 600;
+}
+.conv-body { flex: 1; min-width: 0; }
+.conv-name { font-size: 16px; color: var(--text); }
+.conv-preview { font-size: 13px; color: var(--text-muted); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+
+/* 我 tab 卡片 */
+.profile-card {
+  display: flex; align-items: center; gap: 14px;
+  padding: 20px 16px;
+  background: var(--bg-card);
+  border-bottom: 1px solid var(--border);
+}
+.avatar {
+  width: 56px; height: 56px; border-radius: 12px;
+  background: var(--accent); color: var(--bg);
+  display: flex; align-items: center; justify-content: center;
+  font-size: 24px; font-weight: 700;
+}
+.profile-name { font-size: 18px; font-weight: 600; }
+.profile-did { font-size: 12px; color: var(--text-muted); word-break: break-all; margin-top: 4px; }
+
+/* 底部 tab */
+.tabbar {
+  height: var(--tabbar-h);
+  display: flex;
+  padding-bottom: env(safe-area-inset-bottom);
+  background: var(--bg-card);
+  border-top: 1px solid var(--border);
+}
+.tab {
+  flex: 1;
+  display: flex; flex-direction: column;
+  align-items: center; justify-content: center;
+  gap: 2px;
+  border: none; background: transparent;
+  color: var(--text-secondary);
+  font-size: 11px;
+}
+.tab.active { color: var(--accent); }
+.tab-icon { font-size: 20px; }
+
+/* 聊天页 */
+.chat-page {
+  position: fixed; inset: 0;
+  display: flex; flex-direction: column;
+  background: var(--bg);
+  z-index: 10;
+}
+.chat-topbar {
+  height: var(--topbar-h);
+  display: flex; align-items: center;
+  padding: 0 12px; padding-top: env(safe-area-inset-top);
+  background: var(--bg-card);
+  border-bottom: 1px solid var(--border);
+  gap: 8px;
+}
+.chat-messages { flex: 1; overflow-y: auto; padding: 12px; }
+.chat-input-bar {
+  display: flex; gap: 8px; padding: 8px 12px;
+  padding-bottom: calc(8px + env(safe-area-inset-bottom));
+  background: var(--bg-card);
+  border-top: 1px solid var(--border);
+}
+.chat-input-bar input {
+  flex: 1; height: 38px; padding: 0 12px;
+  border: 1px solid var(--border); border-radius: 8px;
+  background: var(--bg-hover); color: var(--text);
+  outline: none;
+}
+.chat-input-bar button {
+  height: 38px; padding: 0 16px;
+  border: none; border-radius: 8px;
+  background: var(--accent); color: var(--bg);
+  font-weight: 600;
+}
+.bubble { max-width: 75%; padding: 8px 12px; border-radius: 10px; margin: 4px 0; word-break: break-word; }
+.bubble.user { margin-left: auto; background: var(--accent); color: var(--bg); }
+.bubble.ai { background: var(--bg-card); color: var(--text); }

package/dist/web/mobile.html

@@ -0,0 +1,72 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover">
+<title>Bolloon 手机端</title>
+<link rel="stylesheet" href="./mobile.css">
+</head>
+<body>
+<div id="app" class="app">
+  <!-- 顶部导航 -->
+  <header class="topbar">
+    <div class="topbar-title" id="topbar-title">微信</div>
+    <div class="topbar-actions">
+      <button class="icon-btn" id="btn-add" title="添加好友">＋</button>
+    </div>
+  </header>
+
+  <!-- 页面容器 (切换 4 个 tab) -->
+  <main class="page-container">
+    <!-- 微信 tab: 会话列表 -->
+    <section class="page" id="page-wechat" data-tab="wechat">
+      <div class="list" id="conversation-list"></div>
+    </section>
+
+    <!-- 通讯录 tab -->
+    <section class="page" id="page-contacts" data-tab="contacts" hidden>
+      <div class="list" id="contacts-list"></div>
+    </section>
+
+    <!-- 发现 tab -->
+    <section class="page" id="page-discover" data-tab="discover" hidden>
+      <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>
+      </div>
+      <div class="section-label">MCP 工具 (触控调用)</div>
+      <div class="list" id="mcp-tools"></div>
+    </section>
+
+    <!-- 我 tab -->
+    <section class="page" id="page-me" data-tab="me" hidden>
+      <div class="profile-card" id="profile-card">
+        <div class="avatar" id="me-avatar">?</div>
+        <div class="profile-info">
+          <div class="profile-name" id="me-name">未登录</div>
+          <div class="profile-did" id="me-did"></div>
+        </div>
+      </div>
+      <div class="list">
+        <div class="list-item" id="item-settings"><span class="list-icon">⚙️</span><span>设置</span><span class="list-arrow">›</span></div>
+        <div class="list-item" id="item-wallet"><span class="list-icon">👛</span><span>钱包</span><span class="list-arrow">›</span></div>
+        <div class="list-item" id="item-judgments"><span class="list-icon">🧠</span><span>判断力 API</span><span class="list-arrow">›</span></div>
+        <div class="list-item" id="item-did"><span class="list-icon">🪪</span><span>DID 身份</span><span class="list-arrow">›</span></div>
+        <div class="list-item" id="item-login"><span class="list-icon">🔐</span><span id="login-label">登录</span><span class="list-arrow">›</span></div>
+        <div class="list-item" id="item-logout"><span class="list-icon">🚪</span><span>注销</span></div>
+      </div>
+    </section>
+  </main>
+
+  <!-- 底部 tab -->
+  <nav class="tabbar">
+    <button class="tab active" data-tab="wechat"><span class="tab-icon">💬</span><span>微信</span></button>
+    <button class="tab" data-tab="contacts"><span class="tab-icon">📇</span><span>通讯录</span></button>
+    <button class="tab" data-tab="discover"><span class="tab-icon">🧭</span><span>发现</span></button>
+    <button class="tab" data-tab="me"><span class="tab-icon">🙂</span><span>我</span></button>
+  </nav>
+</div>
+
+<script src="./mobile.js"></script>
+</body>
+</html>

package/dist/web/mobile.js

@@ -0,0 +1,346 @@
+/**
+ * mobile.js — 手机端 UI 交互 (微信风格, Capacitor webview)
+ * bolloon WebUI 主题配色. 数据来自 bolloon server HTTP API + SSE 流式聊天.
+ * 触控组件: tab 切换 / 列表点击 / 聊天输入 / 设置 / MCP 工具调用.
+ */
+(function () {
+  const $ = (sel) => document.querySelector(sel);
+  const $$ = (sel) => Array.from(document.querySelectorAll(sel));
+
+  const api = {
+    async get(path) {
+      const r = await fetch(path);
+      if (!r.ok) throw new Error(`HTTP ${r.status}`);
+      return r.json();
+    },
+    async post(path, body) {
+      const r = await fetch(path, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: body ? JSON.stringify(body) : undefined,
+      });
+      if (!r.ok) throw new Error(`HTTP ${r.status}`);
+      return r.json();
+    },
+  };
+
+  // === 主题 (外观切换, 复用 WebUI 主题变量) ===
+  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' },
+  };
+  function applyTheme(name) {
+    const t = THEMES[name] || THEMES.dark;
+    const root = document.documentElement;
+    Object.entries(t).forEach(([k, v]) => root.style.setProperty(k, v));
+    localStorage.setItem('bolloon_theme', name);
+    const btn = $('#theme-toggle');
+    if (btn) btn.textContent = name === 'dark' ? '🌙 深色' : '☀️ 浅色';
+  }
+
+  // === tab 切换 ===
+  const TITLES = { wechat: '微信', contacts: '通讯录', discover: '发现', me: '我' };
+  function switchTab(tab) {
+    $$('.page').forEach((p) => { p.hidden = p.dataset.tab !== tab; });
+    $$('.tab').forEach((t) => t.classList.toggle('active', t.dataset.tab === tab));
+    $('#topbar-title').textContent = TITLES[tab] || '微信';
+    if (tab === 'discover') loadMcpTools();
+    window.__mobileTouch?.('tab', tab);
+  }
+  $$('.tab').forEach((t) => t.addEventListener('click', () => switchTab(t.dataset.tab)));
+
+  // === 会话列表 ===
+  async function loadConversations() {
+    try {
+      const channels = await api.get('/channels');
+      const list = $('#conversation-list');
+      list.innerHTML = '';
+      if (!Array.isArray(channels) || channels.length === 0) {
+        list.innerHTML = '<div style="padding:20px;text-align:center;color:var(--text-muted)">暂无会话, 点右上角 + 添加</div>';
+        return;
+      }
+      channels.forEach((ch) => {
+        const name = ch.persona?.name || ch.name || ch.agentId || '智能体';
+        const el = document.createElement('div');
+        el.className = 'conv-item';
+        el.innerHTML = `
+          <div class="conv-avatar">${escapeHtml(name.charAt(0))}</div>
+          <div class="conv-body">
+            <div class="conv-name">${escapeHtml(name)}</div>
+            <div class="conv-preview">${escapeHtml(ch.preview || '开始对话')}</div>
+          </div>`;
+        el.addEventListener('click', () => openChat(ch));
+        list.appendChild(el);
+      });
+    } catch (e) {
+      $('#conversation-list').innerHTML = `<div style="padding:20px;color:var(--error)">加载失败: ${escapeHtml(e.message)}</div>`;
+    }
+  }
+
+  // === 通讯录 ===
+  async function loadContacts() {
+    try {
+      let peers = [];
+      try { peers = await api.get('/api/peers'); } catch { peers = []; }
+      const list = $('#contacts-list');
+      list.innerHTML = '';
+      if (!Array.isArray(peers) || peers.length === 0) {
+        list.innerHTML = '<div style="padding:20px;text-align:center;color:var(--text-muted)">暂无好友</div>';
+        return;
+      }
+      peers.forEach((p) => {
+        const name = p.name || p.publicKey?.slice(0, 12) || '好友';
+        const el = document.createElement('div');
+        el.className = 'conv-item';
+        el.innerHTML = `<div class="conv-avatar">${escapeHtml(name.charAt(0))}</div>
+          <div class="conv-body"><div class="conv-name">${escapeHtml(name)}</div></div>`;
+        list.appendChild(el);
+      });
+    } catch (e) { /* 忽略 */ }
+  }
+
+  // === 发现: MCP 工具列表 (MCP 前端支持) ===
+  async function loadMcpTools() {
+    const box = $('#mcp-tools');
+    if (!box) return;
+    box.innerHTML = '<div style="padding:12px 16px;color:var(--text-muted)">加载 MCP 工具...</div>';
+    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>';
+        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">🔌</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); alert('MCP 工具: ' + name + '\n可在对话中让智能体调用'); });
+        box.appendChild(el);
+      });
+    } catch (e) { box.innerHTML = '<div style="padding:12px 16px;color:var(--text-muted)">MCP 工具加载失败</div>'; }
+  }
+
+  // === 我的页 ===
+  async function loadMe() {
+    try {
+      const s = await api.get('/api/auth/status');
+      $('#me-avatar').textContent = (s.name || 'U').charAt(0);
+      $('#me-name').textContent = s.name || '未登录';
+      $('#me-did').textContent = s.didShort || s.did || '';
+      const hasAccount = (s.accounts && s.accounts.length > 0);
+      $('#login-label').textContent = hasAccount ? '已登录账号' : '登录';
+      $('#settings-did').textContent = 'DID: ' + (s.did || '未生成');
+      $('#settings-login-state').textContent = hasAccount ? '已登录 (' + (s.accounts.map(a => a.provider).join(',')) + ')' : '未登录';
+    } catch (e) { /* 默认 */ }
+  }
+
+  // === 聊天页 (SSE 流式) ===
+  let activeChannel = null;
+  let chatEventSource = null;
+  let streamingBubble = null;
+
+  function openChat(ch) {
+    activeChannel = ch;
+    const page = document.createElement('div');
+    page.className = 'chat-page';
+    page.id = 'chat-page';
+    const name = ch.persona?.name || ch.name || ch.agentId || '智能体';
+    page.innerHTML = `
+      <div class="chat-topbar">
+        <button class="icon-btn" id="chat-back">‹</button>
+        <div style="flex:1;font-weight:600">${escapeHtml(name)}</div>
+      </div>
+      <div class="chat-messages" id="chat-messages"></div>
+      <div class="chat-input-bar">
+        <input id="chat-input" placeholder="输入消息...">
+        <button id="chat-send">发送</button>
+      </div>`;
+    document.body.appendChild(page);
+    $('#chat-back').addEventListener('click', closeChat);
+    $('#chat-send').addEventListener('click', sendChat);
+    $('#chat-input').addEventListener('keydown', (e) => { if (e.key === 'Enter') sendChat(); });
+    loadMessages();
+    openChatSse();
+    window.__mobileTouch?.('chat', ch.id);
+  }
+
+  function closeChat() {
+    if (chatEventSource) { chatEventSource.close(); chatEventSource = null; }
+    const p = $('#chat-page');
+    if (p) p.remove();
+    activeChannel = null;
+    loadConversations();
+  }
+
+  function openChatSse() {
+    if (chatEventSource) chatEventSource.close();
+    if (!activeChannel) return;
+    // 订阅全局事件流, 过滤当前 channel 的 AI 流式回复 (step/token/ai)
+    try {
+      chatEventSource = new EventSource('/events');
+      chatEventSource.onmessage = (e) => {
+        if (!activeChannel || !e.data) return;
+        let msg;
+        try { msg = JSON.parse(e.data); } catch { return; }
+        const box = $('#chat-messages');
+        if (!box) return;
+        // AI 消息 / token 流 → 流式气泡
+        if (msg.type === 'ai' || msg.type === 'token' || msg.role === 'ai') {
+          const content = msg.content || msg.text || '';
+          if (msg.channelId && msg.channelId !== activeChannel.id) return;
+          if (!streamingBubble || !streamingBubble.isConnected) {
+            streamingBubble = document.createElement('div');
+            streamingBubble.className = 'bubble ai';
+            box.appendChild(streamingBubble);
+          }
+          streamingBubble.textContent += content;
+          box.scrollTop = box.scrollHeight;
+        } else if (msg.type === 'done') {
+          streamingBubble = null;
+          setTimeout(loadMessages, 300);
+        }
+      };
+      chatEventSource.onerror = () => { /* SSE 断线静默重连 */ };
+    } catch (e) { /* SSE 不支持则退回轮询 */ }
+  }
+
+  async function loadMessages() {
+    if (!activeChannel) return;
+    const box = $('#chat-messages');
+    try {
+      const data = await api.get(`/sessions/${encodeURIComponent(activeChannel.id)}`);
+      const msgs = data?.messages || [];
+      box.innerHTML = '';
+      msgs.slice(-50).forEach((m) => {
+        const role = (m.role || m.type || '') === 'user' ? 'user' : 'ai';
+        const d = document.createElement('div');
+        d.className = 'bubble ' + role;
+        d.textContent = m.content || '';
+        box.appendChild(d);
+      });
+      box.scrollTop = box.scrollHeight;
+    } catch (e) { box.innerHTML = '<div style="color:var(--text-muted)">暂无历史消息</div>'; }
+  }
+
+  async function sendChat() {
+    const input = $('#chat-input');
+    const text = input.value.trim();
+    if (!text || !activeChannel) return;
+    input.value = '';
+    const box = $('#chat-messages');
+    const userBubble = document.createElement('div');
+    userBubble.className = 'bubble user';
+    userBubble.textContent = text;
+    box.appendChild(userBubble);
+    box.scrollTop = box.scrollHeight;
+    try {
+      await api.post('/message', { text, channelId: activeChannel.id });
+      // AI 回复走 SSE 流式 (openChatSse)
+      setTimeout(() => { if (!streamingBubble) loadMessages(); }, 1500);
+    } catch (e) {
+      const ai = document.createElement('div');
+      ai.className = 'bubble ai';
+      ai.textContent = '发送失败: ' + (e.message || '');
+      box.appendChild(ai);
+    }
+  }
+
+  // === 设置页 (弹层) ===
+  function openSettings() {
+    const page = document.createElement('div');
+    page.className = 'chat-page';
+    page.id = 'settings-page';
+    page.innerHTML = `
+      <div class="chat-topbar">
+        <button class="icon-btn" id="settings-back">‹</button>
+        <div style="flex:1;font-weight:600">设置</div>
+      </div>
+      <div style="padding:12px">
+        <div class="conv-item" id="theme-toggle">🌙 深色</div>
+        <div class="conv-item" id="settings-api"><span class="list-icon">🔧</span><span>API 配置</span><span class="list-arrow">›</span></div>
+        <div class="conv-item" id="settings-wallet"><span class="list-icon">👛</span><span>钱包</span><span class="list-arrow">›</span></div>
+        <div class="conv-item" id="settings-judgments"><span class="list-icon">🧠</span><span>判断力 API</span><span class="list-arrow">›</span></div>
+        <div class="conv-item" id="settings-did">🪪 DID</div>
+        <div class="conv-item" id="settings-login-state">🔐 登录状态</div>
+      </div>`;
+    document.body.appendChild(page);
+    const theme = localStorage.getItem('bolloon_theme') || 'dark';
+    applyTheme(theme);
+    $('#settings-back').addEventListener('click', () => page.remove());
+    $('#theme-toggle').addEventListener('click', () => applyTheme(localStorage.getItem('bolloon_theme') === 'dark' ? 'light' : 'dark'));
+    $('#settings-api').addEventListener('click', () => openUrl('/api-config'));
+    $('#settings-wallet').addEventListener('click', () => alert('钱包管理 (桌面 Web UI 提供)'));
+    $('#settings-judgments').addEventListener('click', () => alert('判断力 API (桌面 Web UI 提供)'));
+    $('#settings-did').addEventListener('click', () => { api.get('/api/auth/status').then((s) => alert('DID: ' + (s.did || '未生成'))); });
+  }
+
+  // === 菜单绑定 ===
+  function bindMenu() {
+    $('#item-settings').addEventListener('click', openSettings);
+    $('#item-wallet').addEventListener('click', () => { alert('钱包管理 (桌面 Web UI 提供)'); });
+    $('#item-judgments').addEventListener('click', () => { alert('判断力 API (桌面 Web UI 提供)'); });
+    $('#item-did').addEventListener('click', () => { api.get('/api/auth/status').then((s) => alert('DID: ' + (s.did || '未生成'))); });
+    $('#item-login').addEventListener('click', () => { openUrl('/api-config'); });
+    $('#item-logout').addEventListener('click', () => { api.post('/api/auth/logout', { provider: 'github' }).then(() => loadMe()); });
+    $('#btn-add').addEventListener('click', () => { alert('添加好友: 在桌面 Web UI 的 P2P 好友中添加'); });
+    $('#item-p2p').addEventListener('click', () => { switchTab('contacts'); });
+    $('#item-p2p-id').addEventListener('click', () => { alert('我的 P2P ID 见桌面 Web UI'); });
+  }
+
+  function openUrl(url) {
+    if (window.Capacitor && window.Capacitor.isNativePlatform?.()) location.href = url;
+    else window.open(url, '_blank');
+  }
+
+  function escapeHtml(s) {
+    return String(s ?? '').replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]));
+  }
+
+  // === MCP 触控钩子 ===
+  window.__mobileTouch = (type, data) => {
+    // 预留: 触控事件上报/控制
+  };
+
+  // === MCP 驱动前端 UI (2026-08-12): 订阅 /events, 收到 {type:'ui'} 指令执行组件动作 ===
+  function setupUiControl() {
+    try {
+      const es = new EventSource('/events');
+      es.onmessage = (e) => {
+        if (!e.data) return;
+        let msg;
+        try { msg = JSON.parse(e.data); } catch { return; }
+        if (msg.type !== 'ui' || !msg.action) return;
+        const d = msg.data || {};
+        switch (msg.action) {
+          case 'switchTab': if (d.tab && ['wechat', 'contacts', 'discover', 'me'].includes(d.tab)) switchTab(d.tab); break;
+          case 'openSettings': openSettings(); break;
+          case 'openWallet': alert('钱包管理 (桌面 Web UI 提供)'); break;
+          case 'openAddFriend': alert('添加好友: 在桌面 Web UI 的 P2P 好友中添加'); break;
+          case 'showToast': alert(d.message || ''); break;
+          case 'goBack': { const p = $('#chat-page'); if (p) closeChat(); else openSettings(); break; }
+          default: break;
+        }
+        window.__mobileTouch?.('ui', msg.action);
+      };
+      es.onerror = () => { /* SSE 断线静默重连 */ };
+    } catch (e) { /* 忽略 */ }
+  }
+
+  function init() {
+    bindMenu();
+    applyTheme(localStorage.getItem('bolloon_theme') || 'dark');
+    switchTab('wechat');
+    setupUiControl();
+    loadConversations();
+    loadContacts();
+    loadMe();
+  }
+  document.addEventListener('DOMContentLoaded', init);
+  if (document.readyState !== 'loading') init();
+})();

package/dist/web/server.js

@@ -2785,6 +2785,29 @@ ${goalDesc}
             res.status(400).json({ ok: false, severity: 'block', reason: e?.message ?? 'parse error' });
         }
     });
+    // 2026-08-12: MCP 工具列表 (MCP 前端支持 — 手机端/桌面 UI 展示可用 MCP 工具)
+    app.get('/api/mcp/tools', async (_req, res) => {
+        try {
+            const mcp = await import('../pi-ecosystem-mcp/index.js');
+            await mcp.initializeMcpAdapter().catch(() => { });
+            const tools = mcp.listTools().map((t) => ({ name: t.name, description: t.description || '' }));
+            res.json({ tools });
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    // 2026-08-12: MCP 驱动前端 UI — 把 broadcast 注入 ui-tools, agent 调 UI 工具时广播 {type:'ui'} 给前端 SSE
+    (async () => {
+        try {
+            const { setUiBroadcast, registerUiControlTools } = await import('../pi-ecosystem-mcp/ui-tools.js');
+            setUiBroadcast(broadcast);
+            registerUiControlTools();
+        }
+        catch (e) {
+            console.warn('[ui-tools] UI 广播注入失败 (非致命):', e?.message?.slice(0, 120));
+        }
+    })();
     app.get('/api/health', (_req, res) => {
         res.json(healthCheck(getPackageVersion()));
     });

package/package.json

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

package/scripts/build-web.ts

@@ -14,7 +14,7 @@ async function main() {
 
   // 重要: 不能 rm -rf 整个 dist/web/, 否则会删掉 build:main 编译出来的
   // dist/web/server.js. 只清理 web 静态资源, 保留 server.js.
-  for (const f of ['index.html', 'api-config.html', 'style.css', 'client.js', 'components']) {
+  for (const f of ['index.html', 'api-config.html', 'style.css', 'client.js', 'mobile.html', 'mobile.css', 'mobile.js', 'components']) {
     await fs.rm(path.join(DIST_WEB, f), { recursive: true, force: true });
   }
   await fs.mkdir(DIST_WEB, { recursive: true });
@@ -96,6 +96,10 @@ async function main() {
   await fs.copyFile(path.join(ROOT, 'src/web/index.html'), path.join(DIST_WEB, 'index.html'));
   await fs.copyFile(path.join(ROOT, 'src/web/api-config.html'), path.join(DIST_WEB, 'api-config.html'));
   await fs.copyFile(path.join(ROOT, 'src/web/style.css'), path.join(DIST_WEB, 'style.css'));
+  // 2026-08-12: 手机端 UI (微信风格, Capacitor webview 加载) — 纯静态复制
+  await fs.copyFile(path.join(ROOT, 'src/web/mobile.html'), path.join(DIST_WEB, 'mobile.html'));
+  await fs.copyFile(path.join(ROOT, 'src/web/mobile.css'), path.join(DIST_WEB, 'mobile.css'));
+  await fs.copyFile(path.join(ROOT, 'src/web/mobile.js'), path.join(DIST_WEB, 'mobile.js'));
   // 复制 PWA manifest (index.html 里有 <link rel="manifest">, 否则浏览器会 404)
   await fs.copyFile(path.join(ROOT, 'src/web/manifest.json'), path.join(DIST_WEB, 'manifest.json'));
   // 复制 icons 目录 (manifest.json 里引用了 favicon 等)