@bolloon/bolloon-agent 0.1.25 → 0.1.27

package/dist/index.js

@@ -1426,9 +1426,9 @@ async function main() {
         const port = parseInt(process.env.PORT || '54188');
         const { createWebServer, openBrowser } = await import('./web/server.js');
         s.info(`启动 Web 服务端口 ${port}...`);
-        await createWebServer(port);
-        s.success(`浏览器已打开 → http://localhost:${port}`);
-        openBrowser(`http://localhost:${port}`);
+        const { port: actualPort } = await createWebServer(port);
+        s.success(`浏览器已打开 → http://localhost:${actualPort}`);
+        openBrowser(`http://localhost:${actualPort}`);
     }
     else if (isNonInteractive) {
         console.log = originalLog;

package/dist/web/client.js

@@ -23,6 +23,7 @@ let eventSources = new Map(); // channelId -> EventSource
 let currentChannelId = null;
 let currentAgentId = '';
 let channels = [];
+let remoteChannels = []; // v3: 远端 channel UI 元数据 (按 peer 分组)
 let isSidebarCollapsed = false;
 let reconnectAttempts = new Map(); // channelId -> attempts
 let reconnectTimers = new Map(); // channelId -> timer
@@ -2490,6 +2491,163 @@ loadJudgments();
 // 后台定期刷新 (与 modal 打开/关闭无关, 任何时候都保持徽章新鲜)
 setInterval(loadJudgments, 10000);
 
+// ============================================================================
+// v3: 远端智能体 (从 P2P 连接的 peer 拉取的 channel UI 元数据)
+// ============================================================================
+
+async function loadRemoteChannels() {
+  try {
+    const res = await fetch('/api/remote-channels');
+    if (!res.ok) return;
+    const data = await res.json();
+    remoteChannels = Array.isArray(data.peers) ? data.peers : [];
+    renderRemoteChannels();
+  } catch (err) {
+    console.error('[v3] loadRemoteChannels 失败:', err);
+  }
+}
+
+function renderRemoteChannels() {
+  const list = document.getElementById('remote-channel-list');
+  if (!list) return;
+  if (remoteChannels.length === 0) {
+    list.innerHTML = '<li style="color:var(--text-muted);font-size:11px;padding:8px 4px;text-align:center;">(暂无, 点 ↻ 刷新)</li>';
+    return;
+  }
+  const html = remoteChannels.map(p => {
+    const peerShort = p.peerId.substring(0, 12) + '…';
+    return `
+      <li class="remote-peer-group" style="margin-bottom:8px;">
+        <div style="font-size:10px;color:var(--text-muted);padding:2px 4px;display:flex;align-items:center;gap:4px;">
+          <span>🌐</span><span title="${escapeHtml(p.peerId)}">${escapeHtml(peerShort)}</span>
+          <span>·</span>
+          <span>${p.channels.length} 个</span>
+        </div>
+        ${p.channels.map(c => `
+          <div class="remote-channel-row" data-peer-id="${escapeHtml(p.peerId)}" data-channel-id="${escapeHtml(c.id)}"
+               style="display:flex;align-items:center;gap:6px;padding:4px 6px;cursor:pointer;border-radius:4px;font-size:12px;color:var(--text);">
+            <span>🤖</span>
+            <span style="flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;" title="${escapeHtml(c.name || '')}">${escapeHtml(c.name || '(未命名)')}</span>
+            ${c.hasWallet ? '<span title="绑定钱包">⛓</span>' : ''}
+            <span title="绑定判断力数" style="font-size:10px;color:var(--text-muted);">🧠${c.boundJudgmentCount || 0}</span>
+          </div>
+        `).join('')}
+      </li>
+    `;
+  }).join('');
+  list.innerHTML = html;
+
+  // 绑定点击 — 暂时只是 console.log + 提示, Phase 2 接 chat
+  list.querySelectorAll('.remote-channel-row').forEach(row => {
+    row.addEventListener('click', () => {
+      const peerId = row.dataset.peerId;
+      const channelId = row.dataset.channelId;
+      console.log('[v3] 点击远端 channel:', peerId.substring(0,12), channelId);
+      alert(`远端智能体点击 — Phase 2 实现 chat 调用\n\nPeer: ${peerId}\nChannel: ${channelId}`);
+    });
+  });
+}
+
+const refreshRemoteBtn = document.getElementById('refresh-remote-agents-btn');
+if (refreshRemoteBtn) {
+  refreshRemoteBtn.addEventListener('click', async (e) => {
+    e.stopPropagation(); // 防止冒泡触发折叠
+    refreshRemoteBtn.disabled = true;
+    refreshRemoteBtn.textContent = '⏳';
+    try {
+      const res = await fetch('/api/remote-channels/refresh', { method: 'POST' });
+      const data = await res.json();
+      console.log('[v3] 刷新远端智能体:', data);
+      setTimeout(loadRemoteChannels, 1500);
+    } catch (err) {
+      console.error('[v3] 刷新失败:', err);
+    } finally {
+      setTimeout(() => {
+        refreshRemoteBtn.disabled = false;
+        refreshRemoteBtn.textContent = '↻ 刷新';
+      }, 2000);
+    }
+  });
+}
+
+// 启动时拉一次 + 定期轮询 (SSE 接收 P2P reply 后也会更新)
+loadRemoteChannels();
+setInterval(loadRemoteChannels, 8000);
+
+// ============ v3: 折叠 + 拖拽分隔线 ============
+
+// 给本地/远端 section 加 flex 修饰类 (CSS variable 驱动比例)
+const localSection = document.querySelector('.sidebar-section'); // 第一个 section = 本地 channel
+const remoteSection = document.getElementById('remote-agents-section');
+if (localSection) localSection.classList.add('local-flex');
+if (remoteSection) remoteSection.classList.add('remote-flex');
+
+// 折叠: 点 header 切换 collapsed 类
+const remoteHeader = document.getElementById('remote-agents-header');
+if (remoteHeader && remoteSection) {
+  remoteHeader.addEventListener('click', (e) => {
+    // 阻止刷新按钮的事件冒泡在 refreshRemoteBtn 里已处理
+    remoteSection.classList.toggle('collapsed');
+  });
+}
+
+// 拖拽分隔线: 鼠标按下开始拖, mousemove 改 --local-flex / --remote-flex, mouseup 结束
+const splitHandle = document.getElementById('sidebar-split-handle');
+if (splitHandle && localSection && remoteSection) {
+  // 初始化等分
+  const updateFlexVars = (localRatio, remoteRatio) => {
+    localSection.style.setProperty('--local-flex', String(localRatio));
+    remoteSection.style.setProperty('--remote-flex', String(remoteRatio));
+  };
+  updateFlexVars(1, 1);
+
+  let isDragging = false;
+  let dragStartY = 0;
+  let startLocalFlex = 1;
+  let startRemoteFlex = 1;
+  let sidebarHeight = 0;
+
+  splitHandle.addEventListener('mousedown', (e) => {
+    isDragging = true;
+    splitHandle.classList.add('dragging');
+    dragStartY = e.clientY;
+    // 读当前 CSS variable 拿真实 flex 值
+    const lf = parseFloat(getComputedStyle(localSection).getPropertyValue('--local-flex')) || 1;
+    const rf = parseFloat(getComputedStyle(remoteSection).getPropertyValue('--remote-flex')) || 1;
+    startLocalFlex = lf;
+    startRemoteFlex = rf;
+    // 父容器可用高度 = sidebar-section 总和 (本地+远端+handle)
+    const sidebar = document.querySelector('.sidebar');
+    if (sidebar) sidebarHeight = sidebar.clientHeight;
+    e.preventDefault();
+    document.body.style.cursor = 'ns-resize';
+  });
+
+  document.addEventListener('mousemove', (e) => {
+    if (!isDragging) return;
+    const deltaY = e.clientY - dragStartY;
+    if (sidebarHeight <= 0) return;
+    // deltaY 正 = 鼠标下移 = 拉大本地 / 缩小远端
+    // 转换: 1 像素 ≈ sidebarHeight 中 0.005 的比例
+    const deltaRatio = deltaY / sidebarHeight * 4; // 4 倍灵敏
+    let newLocal = Math.max(0.1, startLocalFlex + deltaRatio);
+    let newRemote = Math.max(0.1, startRemoteFlex - deltaRatio);
+    updateFlexVars(newLocal, newRemote);
+  });
+
+  document.addEventListener('mouseup', () => {
+    if (!isDragging) return;
+    isDragging = false;
+    splitHandle.classList.remove('dragging');
+    document.body.style.cursor = '';
+  });
+
+  // 双击分隔线 = 重置为等分
+  splitHandle.addEventListener('dblclick', () => {
+    updateFlexVars(1, 1);
+  });
+}
+
 if (taskModal) {
   taskModal.addEventListener('click', (e) => {
     if (e.target === taskModal) {

package/dist/web/index.html

@@ -64,6 +64,25 @@
         <ul class="channel-list" id="channel-list"></ul>
       </div>
 
+      <!-- v3: 本地/远端分隔线 — 可拖拽改变两边高度 -->
+      <div id="sidebar-split-handle" title="拖动调整上方/下方高度">
+        <div class="split-handle-grip"></div>
+      </div>
+
+      <!-- v3: 远端智能体 — 从 P2P 连接的 peer 拉取的 channel UI 元数据 -->
+      <div class="sidebar-section" id="remote-agents-section">
+        <div class="section-header" id="remote-agents-header" style="display:flex;align-items:center;justify-content:space-between;margin-bottom:8px;cursor:pointer;user-select:none;">
+          <span style="display:flex;align-items:center;gap:6px;">
+            <span id="remote-agents-toggle" style="font-size:10px;color:var(--text-muted);transition:transform 0.2s;">▼</span>
+            <span class="section-title" style="font-size:11px;font-weight:600;text-transform:uppercase;letter-spacing:0.5px;color:var(--text-muted);">远端智能体</span>
+          </span>
+          <button id="refresh-remote-agents-btn" title="从已连接 P2P peer 拉取" style="background:none;border:1px solid var(--border);color:var(--text-secondary);cursor:pointer;padding:2px 6px;border-radius:4px;font-size:11px;line-height:1;">↻ 刷新</button>
+        </div>
+        <ul class="channel-list" id="remote-channel-list" style="list-style:none;padding:0;margin:0;">
+          <li style="color:var(--text-muted);font-size:11px;padding:8px 4px;text-align:center;">(暂无, 点 ↻ 刷新)</li>
+        </ul>
+      </div>
+
       <div class="sidebar-footer">
         <div class="agent-status">
           <span class="status-dot"></span>

package/dist/web/server.js

@@ -254,6 +254,9 @@ async function executeTask(task, channelId) {
     executionTaskId = null;
 }
 let sseClients = new Set();
+// v3: 远端 channel UI 元数据缓存 — key: peerId, value: sanitize 过的 channel 列表
+// in-memory only, 进程重启清空 (judgment 内容永远不在这里)
+let remoteChannelCache = new Map();
 let channelSessions = new Map(); // key: channelId
 let sessionMessages = new Map(); // key: channelId + sessionId
 /**
@@ -263,6 +266,24 @@ let sessionMessages = new Map(); // key: channelId + sessionId
  * 返回 "" 表示完全没数据; 否则返回完整 "[系统上下文] ..." 块 (含尾部换行)
  * 失败非致命 — 任何异常都返回空串, 保证 LLM 调用不被阻塞
  */
+/**
+ * v3: 过滤 channel 元数据, 只返回对远端 peer 安全的字段.
+ * 关键: bound_judgment_ids / walletBinding / autoInvokeTools 内部状态不外传.
+ * judgment 内容永远不会出现在 RPC 响应里 (judgment 始终在 A 节点内存, 由 A 跑 LLM).
+ */
+function sanitizeChannelForPeer(ch) {
+    return {
+        id: ch.id,
+        name: ch.name,
+        did: ch.did,
+        publicKey: ch.publicKey,
+        createdAt: ch.createdAt,
+        updatedAt: ch.updatedAt,
+        hasWallet: !!ch.walletAddress, // 只告诉 B "有没有钱包", 不传地址
+        boundJudgmentCount: Array.isArray(ch.bound_judgment_ids) ? ch.bound_judgment_ids.length : 0,
+        // 🔒 不返回: bound_judgment_ids, walletAddress, walletBinding, autoInvokeTools, sessions
+    };
+}
 async function buildJudgmentHint(channel, channelIdForLog) {
     try {
         const { loadAllJudgments, initializeValueStore } = await import('../pi-ecosystem-judgment/human-value-store.js');
@@ -714,6 +735,40 @@ export async function createWebServer(port = 3000, options = {}) {
             res.status(500).json({ error: err.message });
         }
     });
+    // v3: 列出本节点缓存的远端 channel (按 peerId 分组)
+    app.get('/api/remote-channels', async (_req, res) => {
+        try {
+            const out = [];
+            for (const [peerId, list] of remoteChannelCache.entries()) {
+                out.push({ peerId, channels: list });
+            }
+            res.json({ count: out.length, peers: out });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // v3: 主动向所有已连接 P2P peer 拉 channel 列表
+    // 用法: B 端用户点 "刷新远端智能体" → 触发本 endpoint
+    app.post('/api/remote-channels/refresh', async (_req, res) => {
+        try {
+            const peers = irohTransport.getPeers ? irohTransport.getPeers() : [];
+            const peerIds = Array.isArray(peers) ? peers.map((p) => p.nodeId || p) : [];
+            if (peerIds.length === 0) {
+                return res.json({ ok: true, sent: 0, note: 'no connected peers' });
+            }
+            let sent = 0;
+            for (const peerId of peerIds) {
+                const ok = await irohTransport.sendMessage(peerId, 'agent.meta.list', new TextEncoder().encode('{}'));
+                if (ok)
+                    sent++;
+            }
+            res.json({ ok: true, sent, total: peerIds.length });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
     app.post('/channels', async (req, res) => {
         try {
             const { name, agentId, walletAddress, autoInvokeTools, bound_judgment_ids } = req.body;
@@ -1590,6 +1645,91 @@ export async function createWebServer(port = 3000, options = {}) {
                     timestamp: Date.now()
                 }, 'p2p-global');
             });
+            // ============ v3: 跨用户 channel 元数据 RPC ============
+            // 设计原则: judgment / bound_judgment_ids / wallet 等敏感字段绝不出现在 RPC 响应里.
+            // 收到 'agent.meta.list' → 返回本节点所有 channel 的 UI 元数据 (无 judgment)
+            // 收到 'agent.meta.get' + channelId → 返回单条 channel 的 UI 元数据
+            // B 节点收到响应 → 存到远端 cache → 渲染到 "远端智能体" 区域
+            // B 侧: 收到对端的 list/get 回复 → 更新远端 cache → SSE 推给前端
+            irohTransport.onMessage('agent.meta.list.reply', (msg) => {
+                try {
+                    const data = JSON.parse(new TextDecoder().decode(msg.payload));
+                    if (!data.ok)
+                        return;
+                    const peerId = msg.from;
+                    const list = Array.isArray(data.channels) ? data.channels : [];
+                    remoteChannelCache.set(peerId, list);
+                    console.log(`[v3] 缓存远端 peer ${peerId.substring(0, 12)}... 的 ${list.length} 个 channel`);
+                    broadcast({
+                        type: 'remote-channel-update',
+                        peerId,
+                        channels: list
+                    }, 'p2p-global');
+                }
+                catch (err) {
+                    console.error('[v3] 处理 agent.meta.list.reply 失败:', err);
+                }
+            });
+            irohTransport.onMessage('agent.meta.get.reply', (msg) => {
+                try {
+                    const data = JSON.parse(new TextDecoder().decode(msg.payload));
+                    if (!data.ok || !data.channel)
+                        return;
+                    const peerId = msg.from;
+                    const ch = data.channel;
+                    const list = remoteChannelCache.get(peerId) || [];
+                    const idx = list.findIndex(c => c.id === ch.id);
+                    if (idx >= 0)
+                        list[idx] = ch;
+                    else
+                        list.push(ch);
+                    remoteChannelCache.set(peerId, list);
+                    broadcast({
+                        type: 'remote-channel-update',
+                        peerId,
+                        channels: list
+                    }, 'p2p-global');
+                }
+                catch (err) {
+                    console.error('[v3] 处理 agent.meta.get.reply 失败:', err);
+                }
+            });
+            // A 侧: 收到对端的 list/get 请求
+            irohTransport.onMessage('agent.meta.list', async (msg) => {
+                console.log(`[v3] 收到 agent.meta.list from ${msg.from.substring(0, 12)}...`);
+                try {
+                    const channels = await loadChannels();
+                    const publicMeta = channels.map(sanitizeChannelForPeer);
+                    const response = JSON.stringify({ ok: true, channels: publicMeta });
+                    const encoded = new TextEncoder().encode(response);
+                    // 沿用 msg.from 路由回去
+                    irohTransport.sendMessage(msg.from, 'agent.meta.list.reply', encoded).catch(err => {
+                        console.error('[v3] 发送 agent.meta.list.reply 失败:', err);
+                    });
+                }
+                catch (err) {
+                    console.error('[v3] 处理 agent.meta.list 失败:', err);
+                }
+            });
+            irohTransport.onMessage('agent.meta.get', async (msg) => {
+                try {
+                    const req = JSON.parse(new TextDecoder().decode(msg.payload));
+                    const channelId = req.channelId;
+                    console.log(`[v3] 收到 agent.meta.get for ${channelId} from ${msg.from.substring(0, 12)}...`);
+                    const channels = await loadChannels();
+                    const ch = channels.find(c => c.id === channelId);
+                    if (!ch) {
+                        const response = JSON.stringify({ ok: false, error: 'channel not found' });
+                        irohTransport.sendMessage(msg.from, 'agent.meta.get.reply', new TextEncoder().encode(response));
+                        return;
+                    }
+                    const response = JSON.stringify({ ok: true, channel: sanitizeChannelForPeer(ch) });
+                    irohTransport.sendMessage(msg.from, 'agent.meta.get.reply', new TextEncoder().encode(response));
+                }
+                catch (err) {
+                    console.error('[v3] 处理 agent.meta.get 失败:', err);
+                }
+            });
             irohTransport.onMessage('ai-dialogue', (msg) => {
                 const content = new TextDecoder().decode(msg.payload);
                 console.log(`[iroh] 收到 AI 对话 from ${msg.from.substring(0, 12)}...`);
@@ -2671,19 +2811,52 @@ export async function createWebServer(port = 3000, options = {}) {
     }
     // 安装自改总线 -> SSE 桥
     void installSelfImproveHook();
-    return new Promise((resolve) => {
-        server.listen(port, () => {
-            console.log(`Web 服务器启动完成: http://localhost:${port}`);
-            console.log('服务器已监听');
-            // 安装 chat bus -> SSE 桥 (供前端 inbox UI 实时刷新)
-            void installChatBusHook();
-            setInterval(() => {
-                for (const client of sseClients) {
-                    client.res.write(': ping\n\n');
+    // 端口冲突时自动找下一个可用端口（最多 10 次），避免 EADDRINUSE 直接崩溃
+    return new Promise((resolve, reject) => {
+        const maxAttempts = 10;
+        const startPort = port;
+        let currentPort = startPort;
+        let attempt = 0;
+        // 局部可变 server 引用 — listen 失败后必须重新 createServer 再 listen
+        let currentServer = server;
+        const tryListen = () => {
+            currentServer.removeAllListeners('error');
+            currentServer.once('error', onError);
+            currentServer.listen(currentPort, () => {
+                if (currentPort !== startPort) {
+                    console.warn(`⚠ 端口 ${startPort} 被占用，已自动切换到 ${currentPort}`);
                 }
-            }, 30000);
-            resolve({ app, server });
-        });
+                console.log(`Web 服务器启动完成: http://localhost:${currentPort}`);
+                console.log('服务器已监听');
+                // 安装 chat bus -> SSE 桥 (供前端 inbox UI 实时刷新)
+                void installChatBusHook();
+                setInterval(() => {
+                    for (const client of sseClients) {
+                        client.res.write(': ping\n\n');
+                    }
+                }, 30000);
+                resolve({ app, server: currentServer, port: currentPort });
+            });
+        };
+        const onError = (err) => {
+            if (err && err.code === 'EADDRINUSE' && attempt < maxAttempts - 1) {
+                attempt += 1;
+                const nextPort = currentPort + 1;
+                console.log(`⚠ 端口 ${currentPort} 被占用，尝试 ${nextPort}...`);
+                try {
+                    currentServer.close();
+                }
+                catch { /* ignore */ }
+                // 重新创建 server 实例（listen 失败后原 server 无法再次 listen）
+                currentServer = createServer(app);
+                currentPort = nextPort;
+                tryListen();
+            }
+            else {
+                reject(err);
+            }
+        };
+        tryListen();
     });
 }
 function broadcast(data, channelId) {

package/dist/web/style.css

@@ -269,6 +269,41 @@ body {
   padding: 16px;
   position: relative;
 }
+
+/* v3: 本地/远端 flex 比例由 CSS variable 驱动, 拖拽分隔线时改这两个值 */
+.sidebar-section.local-flex { flex: var(--local-flex, 1) 1 0; }
+.sidebar-section.remote-flex { flex: var(--remote-flex, 1) 1 0; transition: flex 0.15s; }
+
+/* v3: 可拖拽分隔线 */
+#sidebar-split-handle {
+  flex: 0 0 auto;
+  height: 6px;
+  cursor: ns-resize;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  position: relative;
+  background: transparent;
+  user-select: none;
+}
+#sidebar-split-handle:hover { background: var(--bg-hover); }
+#sidebar-split-handle.dragging { background: var(--accent-glow); }
+#sidebar-split-handle .split-handle-grip {
+  width: 32px;
+  height: 3px;
+  border-radius: 2px;
+  background: var(--border-light);
+  pointer-events: none;
+}
+#sidebar-split-handle:hover .split-handle-grip,
+#sidebar-split-handle.dragging .split-handle-grip { background: var(--accent); }
+
+/* v3: 远端区域折叠状态 */
+#remote-agents-section.collapsed .channel-list { display: none; }
+#remote-agents-section.collapsed { flex: 0 0 auto; padding-top: 0; padding-bottom: 0; }
+#remote-agents-section.collapsed .section-header { margin-bottom: 0; }
+#remote-agents-section.collapsed #remote-agents-toggle { transform: rotate(-90deg); }
+
 .section-header {
   display: flex;
   align-items: center;

package/package.json

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

package/src/index.ts

@@ -1629,10 +1629,10 @@ async function main() {
     const { createWebServer, openBrowser } = await import('./web/server.js');
 
     s.info(`启动 Web 服务端口 ${port}...`);
-    await createWebServer(port);
+    const { port: actualPort } = await createWebServer(port);
 
-    s.success(`浏览器已打开 → http://localhost:${port}`);
-    openBrowser(`http://localhost:${port}`);
+    s.success(`浏览器已打开 → http://localhost:${actualPort}`);
+    openBrowser(`http://localhost:${actualPort}`);
   } else if (isNonInteractive) {
     console.log = originalLog;
     console.info = originalInfo;

package/src/web/client.js

@@ -23,6 +23,7 @@ let eventSources = new Map(); // channelId -> EventSource
 let currentChannelId = null;
 let currentAgentId = '';
 let channels = [];
+let remoteChannels = []; // v3: 远端 channel UI 元数据 (按 peer 分组)
 let isSidebarCollapsed = false;
 let reconnectAttempts = new Map(); // channelId -> attempts
 let reconnectTimers = new Map(); // channelId -> timer
@@ -2490,6 +2491,163 @@ loadJudgments();
 // 后台定期刷新 (与 modal 打开/关闭无关, 任何时候都保持徽章新鲜)
 setInterval(loadJudgments, 10000);
 
+// ============================================================================
+// v3: 远端智能体 (从 P2P 连接的 peer 拉取的 channel UI 元数据)
+// ============================================================================
+
+async function loadRemoteChannels() {
+  try {
+    const res = await fetch('/api/remote-channels');
+    if (!res.ok) return;
+    const data = await res.json();
+    remoteChannels = Array.isArray(data.peers) ? data.peers : [];
+    renderRemoteChannels();
+  } catch (err) {
+    console.error('[v3] loadRemoteChannels 失败:', err);
+  }
+}
+
+function renderRemoteChannels() {
+  const list = document.getElementById('remote-channel-list');
+  if (!list) return;
+  if (remoteChannels.length === 0) {
+    list.innerHTML = '<li style="color:var(--text-muted);font-size:11px;padding:8px 4px;text-align:center;">(暂无, 点 ↻ 刷新)</li>';
+    return;
+  }
+  const html = remoteChannels.map(p => {
+    const peerShort = p.peerId.substring(0, 12) + '…';
+    return `
+      <li class="remote-peer-group" style="margin-bottom:8px;">
+        <div style="font-size:10px;color:var(--text-muted);padding:2px 4px;display:flex;align-items:center;gap:4px;">
+          <span>🌐</span><span title="${escapeHtml(p.peerId)}">${escapeHtml(peerShort)}</span>
+          <span>·</span>
+          <span>${p.channels.length} 个</span>
+        </div>
+        ${p.channels.map(c => `
+          <div class="remote-channel-row" data-peer-id="${escapeHtml(p.peerId)}" data-channel-id="${escapeHtml(c.id)}"
+               style="display:flex;align-items:center;gap:6px;padding:4px 6px;cursor:pointer;border-radius:4px;font-size:12px;color:var(--text);">
+            <span>🤖</span>
+            <span style="flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;" title="${escapeHtml(c.name || '')}">${escapeHtml(c.name || '(未命名)')}</span>
+            ${c.hasWallet ? '<span title="绑定钱包">⛓</span>' : ''}
+            <span title="绑定判断力数" style="font-size:10px;color:var(--text-muted);">🧠${c.boundJudgmentCount || 0}</span>
+          </div>
+        `).join('')}
+      </li>
+    `;
+  }).join('');
+  list.innerHTML = html;
+
+  // 绑定点击 — 暂时只是 console.log + 提示, Phase 2 接 chat
+  list.querySelectorAll('.remote-channel-row').forEach(row => {
+    row.addEventListener('click', () => {
+      const peerId = row.dataset.peerId;
+      const channelId = row.dataset.channelId;
+      console.log('[v3] 点击远端 channel:', peerId.substring(0,12), channelId);
+      alert(`远端智能体点击 — Phase 2 实现 chat 调用\n\nPeer: ${peerId}\nChannel: ${channelId}`);
+    });
+  });
+}
+
+const refreshRemoteBtn = document.getElementById('refresh-remote-agents-btn');
+if (refreshRemoteBtn) {
+  refreshRemoteBtn.addEventListener('click', async (e) => {
+    e.stopPropagation(); // 防止冒泡触发折叠
+    refreshRemoteBtn.disabled = true;
+    refreshRemoteBtn.textContent = '⏳';
+    try {
+      const res = await fetch('/api/remote-channels/refresh', { method: 'POST' });
+      const data = await res.json();
+      console.log('[v3] 刷新远端智能体:', data);
+      setTimeout(loadRemoteChannels, 1500);
+    } catch (err) {
+      console.error('[v3] 刷新失败:', err);
+    } finally {
+      setTimeout(() => {
+        refreshRemoteBtn.disabled = false;
+        refreshRemoteBtn.textContent = '↻ 刷新';
+      }, 2000);
+    }
+  });
+}
+
+// 启动时拉一次 + 定期轮询 (SSE 接收 P2P reply 后也会更新)
+loadRemoteChannels();
+setInterval(loadRemoteChannels, 8000);
+
+// ============ v3: 折叠 + 拖拽分隔线 ============
+
+// 给本地/远端 section 加 flex 修饰类 (CSS variable 驱动比例)
+const localSection = document.querySelector('.sidebar-section'); // 第一个 section = 本地 channel
+const remoteSection = document.getElementById('remote-agents-section');
+if (localSection) localSection.classList.add('local-flex');
+if (remoteSection) remoteSection.classList.add('remote-flex');
+
+// 折叠: 点 header 切换 collapsed 类
+const remoteHeader = document.getElementById('remote-agents-header');
+if (remoteHeader && remoteSection) {
+  remoteHeader.addEventListener('click', (e) => {
+    // 阻止刷新按钮的事件冒泡在 refreshRemoteBtn 里已处理
+    remoteSection.classList.toggle('collapsed');
+  });
+}
+
+// 拖拽分隔线: 鼠标按下开始拖, mousemove 改 --local-flex / --remote-flex, mouseup 结束
+const splitHandle = document.getElementById('sidebar-split-handle');
+if (splitHandle && localSection && remoteSection) {
+  // 初始化等分
+  const updateFlexVars = (localRatio, remoteRatio) => {
+    localSection.style.setProperty('--local-flex', String(localRatio));
+    remoteSection.style.setProperty('--remote-flex', String(remoteRatio));
+  };
+  updateFlexVars(1, 1);
+
+  let isDragging = false;
+  let dragStartY = 0;
+  let startLocalFlex = 1;
+  let startRemoteFlex = 1;
+  let sidebarHeight = 0;
+
+  splitHandle.addEventListener('mousedown', (e) => {
+    isDragging = true;
+    splitHandle.classList.add('dragging');
+    dragStartY = e.clientY;
+    // 读当前 CSS variable 拿真实 flex 值
+    const lf = parseFloat(getComputedStyle(localSection).getPropertyValue('--local-flex')) || 1;
+    const rf = parseFloat(getComputedStyle(remoteSection).getPropertyValue('--remote-flex')) || 1;
+    startLocalFlex = lf;
+    startRemoteFlex = rf;
+    // 父容器可用高度 = sidebar-section 总和 (本地+远端+handle)
+    const sidebar = document.querySelector('.sidebar');
+    if (sidebar) sidebarHeight = sidebar.clientHeight;
+    e.preventDefault();
+    document.body.style.cursor = 'ns-resize';
+  });
+
+  document.addEventListener('mousemove', (e) => {
+    if (!isDragging) return;
+    const deltaY = e.clientY - dragStartY;
+    if (sidebarHeight <= 0) return;
+    // deltaY 正 = 鼠标下移 = 拉大本地 / 缩小远端
+    // 转换: 1 像素 ≈ sidebarHeight 中 0.005 的比例
+    const deltaRatio = deltaY / sidebarHeight * 4; // 4 倍灵敏
+    let newLocal = Math.max(0.1, startLocalFlex + deltaRatio);
+    let newRemote = Math.max(0.1, startRemoteFlex - deltaRatio);
+    updateFlexVars(newLocal, newRemote);
+  });
+
+  document.addEventListener('mouseup', () => {
+    if (!isDragging) return;
+    isDragging = false;
+    splitHandle.classList.remove('dragging');
+    document.body.style.cursor = '';
+  });
+
+  // 双击分隔线 = 重置为等分
+  splitHandle.addEventListener('dblclick', () => {
+    updateFlexVars(1, 1);
+  });
+}
+
 if (taskModal) {
   taskModal.addEventListener('click', (e) => {
     if (e.target === taskModal) {

package/src/web/index.html

@@ -64,6 +64,25 @@
         <ul class="channel-list" id="channel-list"></ul>
       </div>
 
+      <!-- v3: 本地/远端分隔线 — 可拖拽改变两边高度 -->
+      <div id="sidebar-split-handle" title="拖动调整上方/下方高度">
+        <div class="split-handle-grip"></div>
+      </div>
+
+      <!-- v3: 远端智能体 — 从 P2P 连接的 peer 拉取的 channel UI 元数据 -->
+      <div class="sidebar-section" id="remote-agents-section">
+        <div class="section-header" id="remote-agents-header" style="display:flex;align-items:center;justify-content:space-between;margin-bottom:8px;cursor:pointer;user-select:none;">
+          <span style="display:flex;align-items:center;gap:6px;">
+            <span id="remote-agents-toggle" style="font-size:10px;color:var(--text-muted);transition:transform 0.2s;">▼</span>
+            <span class="section-title" style="font-size:11px;font-weight:600;text-transform:uppercase;letter-spacing:0.5px;color:var(--text-muted);">远端智能体</span>
+          </span>
+          <button id="refresh-remote-agents-btn" title="从已连接 P2P peer 拉取" style="background:none;border:1px solid var(--border);color:var(--text-secondary);cursor:pointer;padding:2px 6px;border-radius:4px;font-size:11px;line-height:1;">↻ 刷新</button>
+        </div>
+        <ul class="channel-list" id="remote-channel-list" style="list-style:none;padding:0;margin:0;">
+          <li style="color:var(--text-muted);font-size:11px;padding:8px 4px;text-align:center;">(暂无, 点 ↻ 刷新)</li>
+        </ul>
+      </div>
+
       <div class="sidebar-footer">
         <div class="agent-status">
           <span class="status-dot"></span>

package/src/web/server.ts

@@ -382,6 +382,9 @@ interface SSEClient {
 }
 
 let sseClients: Set<SSEClient> = new Set();
+// v3: 远端 channel UI 元数据缓存 — key: peerId, value: sanitize 过的 channel 列表
+// in-memory only, 进程重启清空 (judgment 内容永远不在这里)
+let remoteChannelCache: Map<string, Array<Record<string, unknown>>> = new Map();
 let channelSessions: Map<string, AgentSession> = new Map(); // key: channelId
 let sessionMessages: Map<string, any[]> = new Map(); // key: channelId + sessionId
 
@@ -392,6 +395,26 @@ let sessionMessages: Map<string, any[]> = new Map(); // key: channelId + session
  * 返回 "" 表示完全没数据; 否则返回完整 "[系统上下文] ..." 块 (含尾部换行)
  * 失败非致命 — 任何异常都返回空串, 保证 LLM 调用不被阻塞
  */
+
+/**
+ * v3: 过滤 channel 元数据, 只返回对远端 peer 安全的字段.
+ * 关键: bound_judgment_ids / walletBinding / autoInvokeTools 内部状态不外传.
+ * judgment 内容永远不会出现在 RPC 响应里 (judgment 始终在 A 节点内存, 由 A 跑 LLM).
+ */
+function sanitizeChannelForPeer(ch: Channel): Record<string, unknown> {
+  return {
+    id: ch.id,
+    name: ch.name,
+    did: ch.did,
+    publicKey: ch.publicKey,
+    createdAt: ch.createdAt,
+    updatedAt: ch.updatedAt,
+    hasWallet: !!ch.walletAddress,    // 只告诉 B "有没有钱包", 不传地址
+    boundJudgmentCount: Array.isArray(ch.bound_judgment_ids) ? ch.bound_judgment_ids.length : 0,
+    // 🔒 不返回: bound_judgment_ids, walletAddress, walletBinding, autoInvokeTools, sessions
+  };
+}
+
 async function buildJudgmentHint(
   channel: Channel | undefined | null,
   channelIdForLog: string
@@ -904,6 +927,43 @@ app.get('/channels', async (_req, res) => {
   }
 });
 
+  // v3: 列出本节点缓存的远端 channel (按 peerId 分组)
+  app.get('/api/remote-channels', async (_req, res) => {
+    try {
+      const out: Array<{ peerId: string; channels: Array<Record<string, unknown>> }> = [];
+      for (const [peerId, list] of remoteChannelCache.entries()) {
+        out.push({ peerId, channels: list });
+      }
+      res.json({ count: out.length, peers: out });
+    } catch (err: any) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  // v3: 主动向所有已连接 P2P peer 拉 channel 列表
+  // 用法: B 端用户点 "刷新远端智能体" → 触发本 endpoint
+  app.post('/api/remote-channels/refresh', async (_req, res) => {
+    try {
+      const peers = irohTransport.getPeers ? irohTransport.getPeers() : [];
+      const peerIds = Array.isArray(peers) ? peers.map((p: any) => p.nodeId || p) : [];
+      if (peerIds.length === 0) {
+        return res.json({ ok: true, sent: 0, note: 'no connected peers' });
+      }
+      let sent = 0;
+      for (const peerId of peerIds) {
+        const ok = await irohTransport.sendMessage(
+          peerId,
+          'agent.meta.list',
+          new TextEncoder().encode('{}')
+        );
+        if (ok) sent++;
+      }
+      res.json({ ok: true, sent, total: peerIds.length });
+    } catch (err: any) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+
   app.post('/channels', async (req, res) => {
     try {
       const { name, agentId, walletAddress, autoInvokeTools, bound_judgment_ids } = req.body;
@@ -1858,6 +1918,88 @@ app.get('/channels', async (_req, res) => {
         }, 'p2p-global');
       });
 
+      // ============ v3: 跨用户 channel 元数据 RPC ============
+      // 设计原则: judgment / bound_judgment_ids / wallet 等敏感字段绝不出现在 RPC 响应里.
+      // 收到 'agent.meta.list' → 返回本节点所有 channel 的 UI 元数据 (无 judgment)
+      // 收到 'agent.meta.get' + channelId → 返回单条 channel 的 UI 元数据
+      // B 节点收到响应 → 存到远端 cache → 渲染到 "远端智能体" 区域
+
+      // B 侧: 收到对端的 list/get 回复 → 更新远端 cache → SSE 推给前端
+      irohTransport.onMessage('agent.meta.list.reply', (msg) => {
+        try {
+          const data = JSON.parse(new TextDecoder().decode(msg.payload));
+          if (!data.ok) return;
+          const peerId = msg.from;
+          const list = Array.isArray(data.channels) ? data.channels : [];
+          remoteChannelCache.set(peerId, list);
+          console.log(`[v3] 缓存远端 peer ${peerId.substring(0, 12)}... 的 ${list.length} 个 channel`);
+          broadcast({
+            type: 'remote-channel-update',
+            peerId,
+            channels: list
+          }, 'p2p-global');
+        } catch (err) {
+          console.error('[v3] 处理 agent.meta.list.reply 失败:', err);
+        }
+      });
+
+      irohTransport.onMessage('agent.meta.get.reply', (msg) => {
+        try {
+          const data = JSON.parse(new TextDecoder().decode(msg.payload));
+          if (!data.ok || !data.channel) return;
+          const peerId = msg.from;
+          const ch = data.channel;
+          const list = remoteChannelCache.get(peerId) || [];
+          const idx = list.findIndex(c => c.id === ch.id);
+          if (idx >= 0) list[idx] = ch;
+          else list.push(ch);
+          remoteChannelCache.set(peerId, list);
+          broadcast({
+            type: 'remote-channel-update',
+            peerId,
+            channels: list
+          }, 'p2p-global');
+        } catch (err) {
+          console.error('[v3] 处理 agent.meta.get.reply 失败:', err);
+        }
+      });
+
+      // A 侧: 收到对端的 list/get 请求
+      irohTransport.onMessage('agent.meta.list', async (msg) => {
+        console.log(`[v3] 收到 agent.meta.list from ${msg.from.substring(0, 12)}...`);
+        try {
+          const channels = await loadChannels();
+          const publicMeta = channels.map(sanitizeChannelForPeer);
+          const response = JSON.stringify({ ok: true, channels: publicMeta });
+          const encoded = new TextEncoder().encode(response);
+          // 沿用 msg.from 路由回去
+          irohTransport.sendMessage(msg.from, 'agent.meta.list.reply', encoded).catch(err => {
+            console.error('[v3] 发送 agent.meta.list.reply 失败:', err);
+          });
+        } catch (err) {
+          console.error('[v3] 处理 agent.meta.list 失败:', err);
+        }
+      });
+
+      irohTransport.onMessage('agent.meta.get', async (msg) => {
+        try {
+          const req = JSON.parse(new TextDecoder().decode(msg.payload));
+          const channelId = req.channelId;
+          console.log(`[v3] 收到 agent.meta.get for ${channelId} from ${msg.from.substring(0, 12)}...`);
+          const channels = await loadChannels();
+          const ch = channels.find(c => c.id === channelId);
+          if (!ch) {
+            const response = JSON.stringify({ ok: false, error: 'channel not found' });
+            irohTransport.sendMessage(msg.from, 'agent.meta.get.reply', new TextEncoder().encode(response));
+            return;
+          }
+          const response = JSON.stringify({ ok: true, channel: sanitizeChannelForPeer(ch) });
+          irohTransport.sendMessage(msg.from, 'agent.meta.get.reply', new TextEncoder().encode(response));
+        } catch (err) {
+          console.error('[v3] 处理 agent.meta.get 失败:', err);
+        }
+      });
+
       irohTransport.onMessage('ai-dialogue', (msg) => {
         const content = new TextDecoder().decode(msg.payload);
         console.log(`[iroh] 收到 AI 对话 from ${msg.from.substring(0, 12)}...`);
@@ -3009,19 +3151,51 @@ app.get('/channels', async (_req, res) => {
   // 安装自改总线 -> SSE 桥
   void installSelfImproveHook();
 
-  return new Promise<{ app: express.Express; server: typeof server }>((resolve) => {
-    server.listen(port, () => {
-      console.log(`Web 服务器启动完成: http://localhost:${port}`);
-      console.log('服务器已监听');
-      // 安装 chat bus -> SSE 桥 (供前端 inbox UI 实时刷新)
-      void installChatBusHook();
-      setInterval(() => {
-        for (const client of sseClients) {
-          client.res.write(': ping\n\n');
+  // 端口冲突时自动找下一个可用端口（最多 10 次），避免 EADDRINUSE 直接崩溃
+  return new Promise<{ app: express.Express; server: ReturnType<typeof createServer>; port: number }>((resolve, reject) => {
+    const maxAttempts = 10;
+    const startPort = port;
+    let currentPort = startPort;
+    let attempt = 0;
+    // 局部可变 server 引用 — listen 失败后必须重新 createServer 再 listen
+    let currentServer: ReturnType<typeof createServer> = server;
+
+    const tryListen = () => {
+      currentServer.removeAllListeners('error');
+      currentServer.once('error', onError);
+      currentServer.listen(currentPort, () => {
+        if (currentPort !== startPort) {
+          console.warn(`⚠ 端口 ${startPort} 被占用，已自动切换到 ${currentPort}`);
         }
-      }, 30000);
-      resolve({ app, server });
-    });
+        console.log(`Web 服务器启动完成: http://localhost:${currentPort}`);
+        console.log('服务器已监听');
+        // 安装 chat bus -> SSE 桥 (供前端 inbox UI 实时刷新)
+        void installChatBusHook();
+        setInterval(() => {
+          for (const client of sseClients) {
+            client.res.write(': ping\n\n');
+          }
+        }, 30000);
+        resolve({ app, server: currentServer, port: currentPort });
+      });
+    };
+
+    const onError = (err: NodeJS.ErrnoException) => {
+      if (err && err.code === 'EADDRINUSE' && attempt < maxAttempts - 1) {
+        attempt += 1;
+        const nextPort = currentPort + 1;
+        console.log(`⚠ 端口 ${currentPort} 被占用，尝试 ${nextPort}...`);
+        try { currentServer.close(); } catch { /* ignore */ }
+        // 重新创建 server 实例（listen 失败后原 server 无法再次 listen）
+        currentServer = createServer(app);
+        currentPort = nextPort;
+        tryListen();
+      } else {
+        reject(err);
+      }
+    };
+
+    tryListen();
   });
 }
 

package/src/web/style.css

@@ -269,6 +269,41 @@ body {
   padding: 16px;
   position: relative;
 }
+
+/* v3: 本地/远端 flex 比例由 CSS variable 驱动, 拖拽分隔线时改这两个值 */
+.sidebar-section.local-flex { flex: var(--local-flex, 1) 1 0; }
+.sidebar-section.remote-flex { flex: var(--remote-flex, 1) 1 0; transition: flex 0.15s; }
+
+/* v3: 可拖拽分隔线 */
+#sidebar-split-handle {
+  flex: 0 0 auto;
+  height: 6px;
+  cursor: ns-resize;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  position: relative;
+  background: transparent;
+  user-select: none;
+}
+#sidebar-split-handle:hover { background: var(--bg-hover); }
+#sidebar-split-handle.dragging { background: var(--accent-glow); }
+#sidebar-split-handle .split-handle-grip {
+  width: 32px;
+  height: 3px;
+  border-radius: 2px;
+  background: var(--border-light);
+  pointer-events: none;
+}
+#sidebar-split-handle:hover .split-handle-grip,
+#sidebar-split-handle.dragging .split-handle-grip { background: var(--accent); }
+
+/* v3: 远端区域折叠状态 */
+#remote-agents-section.collapsed .channel-list { display: none; }
+#remote-agents-section.collapsed { flex: 0 0 auto; padding-top: 0; padding-bottom: 0; }
+#remote-agents-section.collapsed .section-header { margin-bottom: 0; }
+#remote-agents-section.collapsed #remote-agents-toggle { transform: rotate(-90deg); }
+
 .section-header {
   display: flex;
   align-items: center;