@bolloon/bolloon-agent 0.3.15 → 0.3.17

package/dist/web/components/p2p/p2p-tools.js

@@ -0,0 +1,248 @@
+/**
+ * P2P 工具调用模块
+ * 支持文件和本地信息的 P2P 传递
+ */
+// 工具类型枚举
+export var P2PToolType;
+(function (P2PToolType) {
+    P2PToolType["FILE_TRANSFER"] = "file_transfer";
+    P2PToolType["LOCAL_INFO"] = "local_info";
+    P2PToolType["SYSTEM_INFO"] = "system_info";
+    P2PToolType["FILE_LIST"] = "file_list";
+})(P2PToolType || (P2PToolType = {}));
+// 文件传输
+export async function transferFile(targetDid, fileInfo, messageId) {
+    try {
+        const payload = {
+            type: 'file',
+            tool: P2PToolType.FILE_TRANSFER,
+            data: {
+                name: fileInfo.name,
+                size: fileInfo.size,
+                mimeType: fileInfo.mimeType,
+                content: fileInfo.content
+            }
+        };
+        const res = await fetch('/api/message-p2p', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                targetDid,
+                content: JSON.stringify(payload),
+                type: 'file'
+            })
+        });
+        if (res.ok) {
+            const data = await res.json();
+            return {
+                success: true,
+                messageId: data.messageId || messageId
+            };
+        }
+        else {
+            return { success: false, error: '文件传输失败' };
+        }
+    }
+    catch (e) {
+        return { success: false, error: e.message };
+    }
+}
+// 本地信息查询
+export async function queryLocalInfo(targetDid, query) {
+    try {
+        const payload = {
+            type: 'info_query',
+            tool: P2PToolType.LOCAL_INFO,
+            query: query
+        };
+        const res = await fetch('/api/message-p2p', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                targetDid,
+                content: JSON.stringify(payload),
+                type: 'ai-dialogue'
+            })
+        });
+        if (res.ok) {
+            const data = await res.json();
+            return {
+                success: true,
+                data: data.response,
+                messageId: data.messageId
+            };
+        }
+        else {
+            return { success: false, error: '信息查询失败' };
+        }
+    }
+    catch (e) {
+        return { success: false, error: e.message };
+    }
+}
+// 系统信息请求
+export async function getSystemInfo(targetDid) {
+    try {
+        const payload = {
+            type: 'system_info_request',
+            tool: P2PToolType.SYSTEM_INFO
+        };
+        const res = await fetch('/api/message-p2p', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                targetDid,
+                content: JSON.stringify(payload),
+                type: 'ai-dialogue'
+            })
+        });
+        if (res.ok) {
+            const data = await res.json();
+            return {
+                success: true,
+                data: data.response,
+                messageId: data.messageId
+            };
+        }
+        else {
+            return { success: false, error: '系统信息获取失败' };
+        }
+    }
+    catch (e) {
+        return { success: false, error: e.message };
+    }
+}
+// 文件列表请求
+export async function listFiles(targetDid, path = '/') {
+    try {
+        const payload = {
+            type: 'file_list_request',
+            tool: P2PToolType.FILE_LIST,
+            path: path
+        };
+        const res = await fetch('/api/message-p2p', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                targetDid,
+                content: JSON.stringify(payload),
+                type: 'ai-dialogue'
+            })
+        });
+        if (res.ok) {
+            const data = await res.json();
+            return {
+                success: true,
+                data: data.response,
+                messageId: data.messageId
+            };
+        }
+        else {
+            return { success: false, error: '文件列表获取失败' };
+        }
+    }
+    catch (e) {
+        return { success: false, error: e.message };
+    }
+}
+// 工具调用入口
+export async function executeP2PTool(request) {
+    const { toolName, payload, targetDid } = request;
+    if (!targetDid) {
+        return { success: false, error: '未指定目标节点' };
+    }
+    switch (toolName) {
+        case P2PToolType.FILE_TRANSFER:
+            return transferFile(targetDid, payload.data);
+        case P2PToolType.LOCAL_INFO:
+            return queryLocalInfo(targetDid, payload.data);
+        case P2PToolType.SYSTEM_INFO:
+            return getSystemInfo(targetDid);
+        case P2PToolType.FILE_LIST:
+            return listFiles(targetDid, payload.data?.path || '/');
+        default:
+            return { success: false, error: `未知工具: ${toolName}` };
+    }
+}
+// 本地系统信息获取 (用于响应来自远程的请求)
+export function getLocalSystemInfo() {
+    const memUsage = process.memoryUsage();
+    const cpuCores = require('os').cpus();
+    return {
+        platform: process.platform,
+        arch: process.arch,
+        nodeVersion: process.version,
+        memory: {
+            total: memUsage.heapTotal,
+            free: memUsage.heapTotal - memUsage.heapUsed,
+            used: memUsage.heapUsed
+        },
+        cpu: {
+            cores: cpuCores.length,
+            model: cpuCores[0]?.model || 'Unknown'
+        },
+        uptime: process.uptime()
+    };
+}
+// 本地文件列表 (用于响应来自远程的请求)
+export function getLocalFileList(dirPath) {
+    try {
+        // Dynamic import for ESM compatibility
+        const pathModule = require('path');
+        const fs = require('fs');
+        const fullPath = pathModule.resolve(dirPath);
+        const files = fs.readdirSync(fullPath);
+        const fileList = files.map((name) => {
+            const fullFilePath = pathModule.join(fullPath, name);
+            let stat;
+            try {
+                stat = fs.statSync(fullFilePath);
+            }
+            catch {
+                return null;
+            }
+            return {
+                name: name,
+                size: stat.size,
+                isDirectory: stat.isDirectory(),
+                modified: stat.mtime.toISOString()
+            };
+        }).filter(Boolean);
+        return {
+            success: true,
+            path: fullPath,
+            files: fileList
+        };
+    }
+    catch (e) {
+        return {
+            success: false,
+            path: dirPath,
+            error: e.message
+        };
+    }
+}
+// 导出工具名称列表
+export const P2P_TOOLS = [
+    {
+        name: P2PToolType.FILE_TRANSFER,
+        description: '传输文件到远程节点',
+        parameters: ['targetDid', 'fileInfo']
+    },
+    {
+        name: P2PToolType.LOCAL_INFO,
+        description: '查询远程节点本地信息',
+        parameters: ['targetDid', 'query']
+    },
+    {
+        name: P2PToolType.SYSTEM_INFO,
+        description: '获取远程节点系统信息',
+        parameters: ['targetDid']
+    },
+    {
+        name: P2PToolType.FILE_LIST,
+        description: '列出远程节点目录文件',
+        parameters: ['targetDid', 'path']
+    }
+];
+console.log('[P2P Tools] 工具模块已加载');

package/dist/web/index.html

@@ -78,6 +78,13 @@
       </div>
 
       <div class="sidebar-footer">
+        <div class="user-avatar" id="user-avatar" title="点击查看 DID 身份">
+          <span class="avatar-letter" id="avatar-letter">?</span>
+        </div>
+        <div class="user-info">
+          <span class="user-name" id="user-name">加载中...</span>
+          <span class="user-did" id="user-did"></span>
+        </div>
         <div class="agent-status">
           <span class="status-dot"></span>
           <span class="status-text">已连接</span>

package/dist/web/server.js

@@ -15,6 +15,7 @@ import { registerLlmConfigRoutes } from './routes-llm-config.js';
 import { registerExternalEngineRoutes } from './routes-external-engines.js';
 import { registerTaskRoutes } from './routes-tasks.js';
 import { registerHearthRoutes } from './routes-hearth.js';
+import { loadOrCreateAgentIdentity } from '../agents/agent-identity.js';
 // 2026-07-06: 类型抽到 ./server-types.ts (channel / session / task / sse client / iroh info / paths)
 import { SESSION_CACHE_PATH, SHARED_SESSION_PATH, IPFS_ENDPOINT, } from './server-types.js';
 // 同时也 re-export 出去 (其它地方可能从 './server.js' 引用)
@@ -1376,9 +1377,41 @@ export async function createWebServer(port = 3000, options = {}) {
     };
     try {
         console.log('开始生成 P2P 身份...');
-        // 生成 DIAP 身份
-        const kp = KeyManager.generate();
-        console.log('KeyManager.generate() 完成, kp:', !!kp, 'kp.did:', kp?.did);
+        // 加载或生成持久化的 P2P 身份
+        const homeDir = process.env.HOME || process.env.USERPROFILE || '.';
+        const p2pIdentityPath = path.join(homeDir, '.bolloon', 'p2p-identity.json');
+        let kp;
+        let reused = false;
+        try {
+            if (fsSync.existsSync(p2pIdentityPath)) {
+                const raw = fsSync.readFileSync(p2pIdentityPath, 'utf-8');
+                const j = JSON.parse(raw);
+                const pkBytes = Buffer.from(j.privateKey, 'hex');
+                if (pkBytes.length === 32) {
+                    kp = KeyManager.fromPrivateKey(pkBytes);
+                    reused = true;
+                }
+                else
+                    throw 0;
+            }
+            else
+                throw 0;
+        }
+        catch {
+            kp = KeyManager.generate();
+            const privateKeyHex = Buffer.from(kp.privateKey).toString('hex');
+            const publicKeyHex = Buffer.from(kp.publicKey).toString('hex');
+            fsSync.mkdirSync(path.dirname(p2pIdentityPath), { recursive: true });
+            fsSync.writeFileSync(p2pIdentityPath, JSON.stringify({
+                keyType: 'Ed25519', privateKey: privateKeyHex, publicKey: publicKeyHex,
+                did: kp.did, createdAt: new Date().toISOString(), version: '1.0'
+            }, null, 2), { mode: 0o600 });
+            try {
+                fsSync.chmodSync(p2pIdentityPath, 0o600);
+            }
+            catch { /* ignore */ }
+        }
+        console.log(reused ? `复用 P2P 身份: ${kp.did.substring(0, 24)}...` : `新建 P2P 身份: ${kp.did.substring(0, 24)}...`);
         console.log('kp.publicKey:', kp?.publicKey);
         const did = kp.did || 'did:unknown:123456';
         console.log(`DID: ${did}`);
@@ -1415,14 +1448,39 @@ export async function createWebServer(port = 3000, options = {}) {
                     if (parsed && parsed.v === 3 && parsed.op) {
                         // v3 跨用户 chat: B 端收到 A 的 chat.reply, 直接 SSE 推给前端
                         if (parsed.op === 'agent.chat.reply') {
-                            console.log(`[v3] 收到来自 ${evt.fromPublicKey.substring(0, 12)}... 的 chat.reply (${(parsed.payload?.text || '').length} chars)`);
+                            const replyText = parsed.payload?.text || '';
+                            const replyChannelId = parsed.payload?.channelId;
+                            console.log(`[v3] 收到来自 ${evt.fromPublicKey.substring(0, 12)}... 的 chat.reply (${replyText.length} chars, channel=${replyChannelId})`);
                             broadcast({
                                 type: 'remote-chat-reply',
                                 fromPublicKey: evt.fromPublicKey,
-                                channelId: parsed.payload?.channelId,
-                                text: parsed.payload?.text || '',
+                                channelId: replyChannelId,
+                                text: replyText,
                                 error: parsed.payload?.error
                             }, 'p2p-global');
+                            // 2026-07-27: 把远端回复持久化到本地 session, 让 LLM 下次能读到上下文
+                            if (replyChannelId && replyText) {
+                                import('../web/server-storage.js').then(async ({ loadSession, saveSession }) => {
+                                    try {
+                                        const existing = await loadSession(replyChannelId, 'default');
+                                        const session = existing || { channelId: replyChannelId, sessionId: 'default', messages: [], lastUpdated: '' };
+                                        session.messages.push({
+                                            id: `msg-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+                                            type: 'ai',
+                                            content: replyText,
+                                            timestamp: new Date().toISOString(),
+                                            source: 'remote-reply',
+                                            fromPublicKey: evt.fromPublicKey,
+                                        });
+                                        session.lastUpdated = new Date().toISOString();
+                                        await saveSession(session);
+                                        console.log(`[v3] chat.reply 已持久化到 session (${replyChannelId}): ${replyText.substring(0, 40)}...`);
+                                    }
+                                    catch (e) {
+                                        console.warn('[v3] chat.reply 持久化失败:', e?.message?.substring(0, 100));
+                                    }
+                                }).catch(() => { });
+                            }
                             return;
                         }
                         // 2026-07-21: 社交心跳 beacon — 远端智能体宣告存活/能力, 更新本地 liveness
@@ -1488,9 +1546,19 @@ export async function createWebServer(port = 3000, options = {}) {
                             return;
                         }
                         const commShim = {
-                            sendToConnection: (_id, data) => {
+                            sendToConnection: async (_id, data) => {
+                                // 尝试解析 JSON 提取 op + payload，走 outbox（连接断开也不丢消息）
+                                try {
+                                    const parsed = JSON.parse(data);
+                                    if (parsed && parsed.v === 3 && parsed.op) {
+                                        const { sendOrQueue } = await import('../network/p2p-outbox.js');
+                                        await sendOrQueue(evt.fromPublicKey, parsed.op, parsed.payload || {}, v3P2PRef);
+                                        return;
+                                    }
+                                }
+                                catch { }
+                                // 兜底：直接发送
                                 v3P2PRef.sendTo(evt.fromPublicKey, data);
-                                return Promise.resolve();
                             }
                         };
                         // v3 新增: 好友申请 RPC — 任何对端可以发, 推到前端 UI 让用户接受
@@ -1599,6 +1667,10 @@ export async function createWebServer(port = 3000, options = {}) {
                                     const counts = await writeRemoteResources(peerKey2, manifest);
                                     await peerFs.writeCapabilityIndex(peerKey2, idx);
                                     console.log(`[v3-manifest] (P2PDirect) 收到 ${peerKey2.substring(0, 12)}... manifest (${manifest.agents.length} agents, owner=${manifest.ownerName || '?'}, +g${counts.groups}/f${counts.functions}/e${counts.exportments}/s${counts.sciences}) → 落盘`);
+                                    // 2026-07-27: 如果是自动发现的 peer，用 manifest 中的名字更新
+                                    if (manifest.ownerName) {
+                                        import('../network/auto-peer-discovery.js').then(({ updateDiscoveredPeerName }) => updateDiscoveredPeerName(peerKey2, manifest.ownerName).catch(() => { })).catch(() => { });
+                                    }
                                     broadcast({
                                         type: 'peer-manifest-updated',
                                         fromPublicKey: peerKey2,
@@ -1606,6 +1678,16 @@ export async function createWebServer(port = 3000, options = {}) {
                                         agentCount: manifest.agents.length,
                                         capabilityIndex: await peerFs.readCapabilityIndex(peerKey2),
                                     }, 'p2p-global');
+                                    // 2026-07-27: 对 manifest 中有 cid/ipnsName 的 agent 解析 DID 文档
+                                    // 不阻塞主流程，fire-and-forget 后台进行
+                                    const agentsWithDID = manifest.agents.filter((a) => a.cid || a.ipnsName);
+                                    if (agentsWithDID.length > 0) {
+                                        import('../network/did-agent-resolver.js').then(({ resolveAgentsFromManifest, persistResolvedAgent }) => resolveAgentsFromManifest(agentsWithDID).then(resolved => {
+                                            for (const r of resolved) {
+                                                persistResolvedAgent(peerKey2, r).catch(() => { });
+                                            }
+                                        }).catch(() => { })).catch(() => { });
+                                    }
                                 }
                                 catch (err) {
                                     console.error('[v3-manifest] (P2PDirect) manifest.exchange.reply 失败:', err.message);
@@ -1788,10 +1870,16 @@ ${goalDesc}
                     return { initiate: false };
                 }
             }
-            // 新连接进来 → 主动发我分享给 ta 的 channel 列表
+            // 新连接进来 → 主动发我分享给 ta 的 channel 列表 + 自动发现好友
             v3P2PRef.on('connection', (evt) => {
                 // 2026-06-10: 喂 watchdog —— 新连接到来是真实业务活动
                 watchdogRef?.recordActivity?.();
+                // 2026-07-27: 自动发现 — 通过 topic 进来的新 peer 自动加好友
+                // fire-and-forget: 不阻塞 connection 处理主流程
+                import('../network/auto-peer-discovery.js').then(({ tryAutoDiscoverPeer }) => {
+                    const localPk = v3P2PRef?.getPublicKey() || '';
+                    tryAutoDiscoverPeer(evt.remotePublicKey, localPk).catch((e) => console.warn('[auto-discover] 失败:', e?.message));
+                }).catch(() => { });
                 setTimeout(async () => {
                     try {
                         const channels = await loadChannels();
@@ -1982,8 +2070,8 @@ ${goalDesc}
                     console.warn('[v3-outbox] flushAllOutboxes failed:', err.message);
                 }
             }
-            // 每 2 分钟兜底 flush
-            setInterval(flushAllOutboxes, 2 * 60 * 1000);
+            // 每 15s 兜底 flush (连接窗口通常 5-10s, 要能抓住窗口 flush 出去)
+            setInterval(flushAllOutboxes, 15 * 1000);
         }
         catch (err) {
             console.error('[v3] P2PDirect 启动失败:', err.message);
@@ -1994,9 +2082,7 @@ ${goalDesc}
         // v3 修复: 用 setInterval 替代一次性 setTimeout, 确保分享变更后能持续推送给 peer
         setInterval(v3BroadcastOwn, 30000);
         // 保留 @diap/sdk 的旧实例 (它的 Hyperswarm 实例能帮 P2PDirect 做 DHT bootstrap)
-        // 2026-07-04: hyperswarm 4.x 删除了 Discovery.update() (被 .flushed() 替代).
-        //   @diap/sdk 0.1.10 还调 .update(), 是上游 bug (已记录 docs/plans/2026-06-17-supervisor-iter-1.md).
-        //   这里静默 joinTopic 失败, P2PDirect (v3 主路径) 不依赖 @diap/sdk, 不影响功能.
+        // 2026-07-04: @diap/sdk v0.2.0 已修复 seed/*update*/connect 类型, 此处走正常路径.
         try {
             const rawSeed = crypto.getRandomValues(new Uint8Array(32));
             p2pCommunicator = createHyperswarmCommunicator({
@@ -2025,18 +2111,17 @@ ${goalDesc}
             });
             await p2pCommunicator.start();
             // @diap/sdk 也 join topic — 它的 Hyperswarm 实例帮 P2PDirect 做 DHT 引导
-            // joinTopic 失败已知 (hyperswarm 4.x + @diap/sdk 0.1.10), catch 静默
+            // v0.2.1 (2026-07-28): hyperswarm seed 类型固定 + join() 返回 { refresh, flushed, destroy }
+            //   discovery.update 错误已彻底修复. catch 保留做防御性兜底.
             const oldTopic = createTopic('bolloon-agent-harness');
             try {
                 await p2pCommunicator.joinTopic(oldTopic);
                 console.log(`P2P 老通道已就绪 (DHT bootstrap 帮 P2PDirect, 实际数据走 P2PDirect)`);
             }
             catch (joinErr) {
-                // 已知: @diap/sdk 0.1.10 + hyperswarm 4.x → discovery.update is not a function
-                // v3 P2PDirect 是主路径, 此处不阻断
                 const msg = String(joinErr?.message || joinErr);
                 if (msg.includes('discovery.update') || msg.includes('is not a function')) {
-                    console.warn(`[v3-legacy] @diap/sdk joinTopic 失败 (已知 hyperswarm 4.x 兼容问题, 已忽略): ${msg}`);
+                    console.warn(`[v3-legacy] joinTopic 触发旧版兼容警告: ${msg}`);
                 }
                 else {
                     throw joinErr;
@@ -2135,6 +2220,50 @@ ${goalDesc}
     app.get('/api/tools', (_req, res) => {
         res.json(listTools().map(t => t.id));
     });
+    // 2026-07-28: 用户 DID 身份端点 — 静默生成/加载, 持久化到 ~/.bolloon/identity/user.json
+    let userIdentityCache = null;
+    const IDENTITY_DIR = `${process.env.HOME || '/tmp'}/.bolloon/identity`;
+    async function loadOrCreateUserIdentity() {
+        if (userIdentityCache)
+            return userIdentityCache;
+        try {
+            const { readFileSync, existsSync, mkdirSync, writeFileSync } = await import('fs');
+            const file = `${IDENTITY_DIR}/user.json`;
+            if (existsSync(file)) {
+                const raw = readFileSync(file, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (parsed.did && parsed.publicKeyHex) {
+                    userIdentityCache = parsed;
+                    return parsed;
+                }
+            }
+            // 生成新 DID keypair
+            const kp = KeyManager.generate();
+            const didShort = kp.did.split(':').pop()?.substring(0, 8) || 'unknown';
+            const publicKeyHex = Buffer.from(kp.publicKey).toString('hex');
+            const username = getUserName();
+            const identity = {
+                did: kp.did,
+                didShort,
+                publicKeyHex,
+                name: `blln-${username}`,
+                createdAt: new Date().toISOString(),
+            };
+            mkdirSync(IDENTITY_DIR, { recursive: true });
+            writeFileSync(file, JSON.stringify(identity, null, 2), { mode: 0o600 });
+            userIdentityCache = identity;
+            console.log(`[user-identity] ✅ DID: ${kp.did.substring(0, 30)}...`);
+            return identity;
+        }
+        catch (e) {
+            console.warn('[user-identity] 加载失败:', e.message);
+            return { did: '', didShort: 'anon', publicKeyHex: '', name: getUserName() };
+        }
+    }
+    app.get('/api/user/identity', async (_req, res) => {
+        const identity = await loadOrCreateUserIdentity();
+        res.json(identity);
+    });
     // 2026-07-01 (v0.2.6): 前后端分离核心 — 后端切 LLM 输出为结构化 segments
     //   - POST /api/segment-reply { reply, knownTools }
     //   - 返回 ChatSegment[] (think / text / env_details / tool_call / final)
@@ -3095,25 +3224,24 @@ ${goalDesc}
         const didMissing = !channel.did || channel.did === 'undefined' || channel.did === 'null' || channel.did === '';
         if (!didMissing)
             return;
-        let kp;
+        let identity = null;
         try {
-            kp = KeyManager.generate();
-        }
-        catch {
-            kp = null;
-        }
-        if (kp && kp.did) {
-            channel.did = kp.did;
-            channel.publicKey = Buffer.from(kp.publicKey).toString('hex');
+            // 用 agentId 作为持久化身份的 key — 确保同一 agentId 跨重启稳定
+            identity = loadOrCreateAgentIdentity(channel.agentId || channel.id);
+            channel.did = identity.did;
+            channel.publicKey = identity.publicKey;
         }
-        else {
+        catch (e) {
             // 兜底: 用 channelId 派生, 不阻塞 UI
+            console.warn(`[DID 修复] ${channel.name} agentIdentity 加载失败:`, e.message);
             channel.did = `did:web:${channel.id}`;
             channel.publicKey = `pk_${channel.id}`;
         }
-        console.log(`[DID 修复] ${channel.name} DID = ${channel.did}`);
+        console.log(`[DID 修复] ${channel.name} DID = ${channel.did} (${identity?.reused ? '复用' : '新建'} agent 持久身份)`);
         // IPFS 注册: 失败也无所谓, 后续可重试
         try {
+            const pkBytes = Buffer.from(channel.publicKey, 'hex');
+            const kp = { privateKey: new Uint8Array(32), publicKey: pkBytes, did: channel.did };
             const auth = await AgentAuthManager.newWithRemoteIpfs('http://127.0.0.1:5001', 'http://127.0.0.1:8080');
             const result = await auth.registerAgent({ name: channel.name, services: [] }, kp, '');
             channel.cid = result.cid || channel.cid;
@@ -4275,21 +4403,16 @@ ${goalDesc}
                 return res.status(400).json({ error: 'text length must be 1-8000' });
             }
             const fromPk = v3P2PRef.getPublicKey();
-            const msg = JSON.stringify({
-                v: 3,
-                op: 'agent.chat.send',
-                payload: { channelId, text, fromPublicKey: fromPk }
-            });
-            const ok = v3P2PRef.sendTo(targetPublicKey, msg);
-            if (!ok) {
-                return res.status(502).json({
-                    error: 'peer not connected. POST /api/remote-channels/p2p-connect first.'
-                });
+            // 2026-07-27: 改用 sendOrQueue (先尝试直发, 失败则入队, 不断线不丢)
+            const { sendOrQueue } = await import('../network/p2p-outbox.js');
+            const r = await sendOrQueue(targetPublicKey, 'agent.chat.send', { channelId, text, fromPublicKey: fromPk }, v3P2PRef);
+            if (r === 'FAILED') {
+                return res.status(502).json({ error: 'send failed: peer not reachable' });
             }
             // 2026-06-10: 喂 watchdog — chat-send 成功是真实业务活动
             watchdogRef?.recordActivity?.();
-            console.log(`[v3] chat-send 转发到 ${targetPublicKey.substring(0, 12)}... (channelId=${channelId})`);
-            res.json({ ok: true, sent: true });
+            console.log(`[v3] chat-send 转发到 ${targetPublicKey.substring(0, 12)}... (channelId=${channelId}) => ${r}`);
+            res.json({ ok: true, sent: r === 'SENT', queued: r === 'QUEUED' });
         }
         catch (err) {
             console.error('[v3] chat-send 失败:', err);

package/dist/web/style.css

@@ -822,16 +822,71 @@ body {
 
 /* Sidebar Footer */
 .sidebar-footer {
-  padding: 16px;
+  padding: 12px 16px;
   border-top: 1px solid var(--border);
+  display: flex;
+  align-items: center;
+  gap: 10px;
 }
 
-.agent-status {
+/* 用户头像 — DID 身份 */
+.user-avatar {
+  width: 32px;
+  height: 32px;
+  border-radius: 50%;
+  background: linear-gradient(135deg, var(--accent) 0%, var(--accent-dark) 100%);
   display: flex;
   align-items: center;
-  gap: 8px;
+  justify-content: center;
+  flex-shrink: 0;
+  cursor: pointer;
+  transition: transform 0.2s, box-shadow 0.2s;
+}
+.user-avatar:hover {
+  transform: scale(1.1);
+  box-shadow: 0 0 12px var(--accent-glow);
+}
+.avatar-letter {
+  font-size: 14px;
+  font-weight: 700;
+  color: #1a1a18;
+  text-transform: uppercase;
+  user-select: none;
+}
+
+.user-info {
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+.user-name {
   font-size: 12px;
+  font-weight: 600;
+  color: var(--text);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  line-height: 1.2;
+}
+.user-did {
+  font-size: 10px;
+  font-family: var(--font-mono);
+  color: var(--text-muted);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  line-height: 1.2;
+}
+
+.agent-status {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 11px;
   color: var(--text-secondary);
+  flex-shrink: 0;
 }
 
 .status-dot {