acp-ts 1.1.5 → 1.1.6

package/dist/agentcp.d.ts

@@ -85,6 +85,11 @@ declare class AgentCP implements IAgentCP {
      * 设置群组事件处理器
      */
     setGroupEventHandler(handler: ACPGroupEventHandler): void;
+    /**
+     * 创建默认的群组事件处理器（防御性，仅打印日志）。
+     * 外部可通过 setGroupEventHandler 覆盖。
+     */
+    private _createDefaultGroupEventHandler;
     /**
      * 设置群组游标存储
      */

package/dist/agentcp.js

@@ -333,6 +333,8 @@ class AgentCP {
         };
         this.groupClient = new group_1.ACPGroupClient(this.activeAid, sendFunc);
         this.groupOps = new group_1.GroupOperations(this.groupClient);
+        // 设置默认 event handler，防止通知被静默丢弃
+        this.groupClient.setEventHandler(this._createDefaultGroupEventHandler());
     }
     /**
      * 初始化跨AP群组客户端。
@@ -349,6 +351,8 @@ class AgentCP {
         };
         this.groupClient = new group_1.ACPGroupClient(this.activeAid, sendFunc);
         this.groupOps = new group_1.GroupOperations(this.groupClient);
+        // 设置默认 event handler，防止通知被静默丢弃
+        this.groupClient.setEventHandler(this._createDefaultGroupEventHandler());
     }
     /**
      * 处理群组协议消息路由。
@@ -393,6 +397,38 @@ class AgentCP {
             this.groupClient.setEventHandler(handler);
         }
     }
+    /**
+     * 创建默认的群组事件处理器（防御性，仅打印日志）。
+     * 外部可通过 setGroupEventHandler 覆盖。
+     */
+    _createDefaultGroupEventHandler() {
+        return {
+            onNewMessage(groupId, latestMsgId, sender, preview) {
+                console.log(`[Group][DefaultHandler] onNewMessage: group=${groupId} msgId=${latestMsgId} sender=${sender} preview=${preview}`);
+            },
+            onNewEvent(groupId, latestEventId, eventType, summary) {
+                console.log(`[Group][DefaultHandler] onNewEvent: group=${groupId} eventId=${latestEventId} type=${eventType}`);
+            },
+            onGroupInvite(groupId, groupAddress, invitedBy) {
+                console.log(`[Group][DefaultHandler] onGroupInvite: group=${groupId} address=${groupAddress} invitedBy=${invitedBy}`);
+            },
+            onJoinApproved(groupId, groupAddress) {
+                console.log(`[Group][DefaultHandler] onJoinApproved: group=${groupId} address=${groupAddress}`);
+            },
+            onJoinRejected(groupId, reason) {
+                console.log(`[Group][DefaultHandler] onJoinRejected: group=${groupId} reason=${reason}`);
+            },
+            onJoinRequestReceived(groupId, agentId, message) {
+                console.log(`[Group][DefaultHandler] onJoinRequestReceived: group=${groupId} agent=${agentId}`);
+            },
+            onGroupMessage(groupId, msg) {
+                console.log(`[Group][DefaultHandler] onGroupMessage: group=${groupId} msgId=${msg.msg_id} sender=${msg.sender}`);
+            },
+            onGroupEvent(groupId, evt) {
+                console.log(`[Group][DefaultHandler] onGroupEvent: group=${groupId} event=${evt.event_type}`);
+            },
+        };
+    }
     /**
      * 设置群组游标存储
      */

package/dist/group/client.js

@@ -74,7 +74,7 @@ class ACPGroupClient {
      * Called by the message dispatch chain in AgentCP.
      */
     handleIncoming(payload) {
-        var _a, _b;
+        var _a, _b, _c;
         // console.log(`[GroupClient] <<< handleIncoming raw payload (first 500 chars): ${payload.substring(0, 500)}`);
         let data;
         try {
@@ -95,6 +95,12 @@ class ACPGroupClient {
                 clearTimeout(pending.timer);
                 this._pendingReqs.delete(requestId);
                 pending.resolve(resp);
+                // 如果响应同时携带 event 字段，也要 dispatch 通知
+                const event = (_b = data.event) !== null && _b !== void 0 ? _b : "";
+                if (event && this._handler != null) {
+                    const notify = (0, types_1.parseGroupNotify)(data);
+                    (0, events_1.dispatchAcpNotify)(this._handler, notify);
+                }
                 return;
             }
             else {
@@ -102,12 +108,15 @@ class ACPGroupClient {
             }
         }
         // Try as notification (has event field)
-        const event = (_b = data.event) !== null && _b !== void 0 ? _b : "";
+        const event = (_c = data.event) !== null && _c !== void 0 ? _c : "";
         if (event) {
             const notify = (0, types_1.parseGroupNotify)(data);
             if (this._handler != null) {
                 (0, events_1.dispatchAcpNotify)(this._handler, notify);
             }
+            else {
+                console.warn(`[GroupClient] !!! notification event="${event}" dropped: no event handler registered. Call setEventHandler() first.`);
+            }
             return;
         }
         console.warn(`[GroupClient] !!! unhandled incoming message: no request_id and no event field`, JSON.stringify(data).substring(0, 300));

package/dist/server.js

@@ -84,7 +84,8 @@ async function doEnsureOnline(aid) {
     const cp = new agentcp_1.AgentCP(globalApiUrl, '', globalDataDir || undefined, { persistMessages: true, persistGroupMessages: true });
     await cp.loadAid(aid);
     cp.setAutoGenerateAgentMd(true);
-    cp.setAgentMdOptions({ type: 'human', tags: ['human', 'acp'] });
+    const customOpts = getAidMdOptionsForAid(aid);
+    cp.setAgentMdOptions(Object.assign({ type: 'human', tags: ['human', 'acp'] }, customOpts));
     const connConfig = await cp.online();
     console.log(`[Server] 自动上线 AID: ${aid}`);
     const hb = new heartbeat_1.HeartbeatClient(aid, connConfig.heartbeatServer, '');
@@ -223,6 +224,37 @@ async function ensureGroupClient(instance) {
     instance.agentWS.onRawMessage((message) => {
         return instance.agentCP.handleGroupMessage(message);
     });
+    // 注册群组事件处理器，确保 SDK 通知回调可靠触发
+    instance.agentCP.setGroupEventHandler({
+        onNewMessage(groupId, latestMsgId, sender, preview) {
+            console.log(`[Group] onNewMessage: group=${groupId} msgId=${latestMsgId} sender=${sender} preview=${preview}`);
+            // 收到新消息通知时，主动拉取并存储到本地
+            instance.agentCP.pullAndStoreGroupMessages(groupId, 20).catch(e => {
+                console.error(`[Group] auto-pull messages failed for group=${groupId}:`, e);
+            });
+        },
+        onNewEvent(groupId, latestEventId, eventType, summary) {
+            console.log(`[Group] onNewEvent: group=${groupId} eventId=${latestEventId} type=${eventType} summary=${summary}`);
+        },
+        onGroupInvite(groupId, groupAddress, invitedBy) {
+            console.log(`[Group] onGroupInvite: group=${groupId} address=${groupAddress} invitedBy=${invitedBy}`);
+        },
+        onJoinApproved(groupId, groupAddress) {
+            console.log(`[Group] onJoinApproved: group=${groupId} address=${groupAddress}`);
+        },
+        onJoinRejected(groupId, reason) {
+            console.log(`[Group] onJoinRejected: group=${groupId} reason=${reason}`);
+        },
+        onJoinRequestReceived(groupId, agentId, message) {
+            console.log(`[Group] onJoinRequestReceived: group=${groupId} agent=${agentId} msg=${message}`);
+        },
+        onGroupMessage(groupId, msg) {
+            console.log(`[Group] onGroupMessage: group=${groupId} msgId=${msg.msg_id} sender=${msg.sender}`);
+        },
+        onGroupEvent(groupId, evt) {
+            console.log(`[Group] onGroupEvent: group=${groupId} event=${evt.event_type}`);
+        },
+    });
     instance.groupInitialized = true;
     instance.groupSessionId = groupSessionId;
     instance.groupTargetAid = targetAid;
@@ -257,7 +289,7 @@ async function getAidStatusList() {
     }
     return result;
 }
-// agent.md 信息缓存 (aid -> { type, name, description, cachedAt })
+// agent.md 信息缓存 (aid -> { type, name, description, tags, cachedAt })
 // 内存缓存 + 本地文件持久化，TTL 24 小时
 const agentInfoCache = new Map();
 const AGENT_INFO_CACHE_TTL = 24 * 60 * 60 * 1000; // 24 hours
@@ -274,7 +306,7 @@ function loadAgentInfoCacheFromDisk() {
             const now = Date.now();
             for (const [aid, info] of entries) {
                 if (now - info.cachedAt < AGENT_INFO_CACHE_TTL) {
-                    agentInfoCache.set(aid, info);
+                    agentInfoCache.set(aid, Object.assign(Object.assign({}, info), { tags: info.tags || [] }));
                 }
             }
             console.log(`[Server] 已加载 agent info 缓存: ${agentInfoCache.size} 条`);
@@ -315,7 +347,7 @@ function fetchAgentMd(aid) {
     });
 }
 function parseAgentMdFrontmatter(content) {
-    const result = { type: '', name: '', description: '' };
+    const result = { type: '', name: '', description: '', tags: [] };
     const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
     if (!match)
         return result;
@@ -329,12 +361,20 @@ function parseAgentMdFrontmatter(content) {
         result.name = nameMatch[1].trim();
     if (descMatch)
         result.description = descMatch[1].trim();
+    // parse tags list
+    const tagsBlock = yaml.match(/^tags:\s*\n((?:\s+-\s+.*\n?)*)/m);
+    if (tagsBlock) {
+        const tagLines = tagsBlock[1].match(/^\s+-\s+(.+)$/gm);
+        if (tagLines) {
+            result.tags = tagLines.map(l => l.replace(/^\s+-\s+/, '').trim().replace(/^"(.*)"$/, '$1'));
+        }
+    }
     return result;
 }
 async function getAgentInfo(aid) {
     const cached = agentInfoCache.get(aid);
     if (cached && Date.now() - cached.cachedAt < AGENT_INFO_CACHE_TTL) {
-        return { type: cached.type, name: cached.name, description: cached.description };
+        return { type: cached.type, name: cached.name, description: cached.description, tags: cached.tags || [] };
     }
     try {
         const md = await fetchAgentMd(aid);
@@ -346,10 +386,40 @@ async function getAgentInfo(aid) {
     catch (_a) {
         // 远程请求失败时，如果有过期缓存也先用着
         if (cached) {
-            return { type: cached.type, name: cached.name, description: cached.description };
+            return { type: cached.type, name: cached.name, description: cached.description, tags: cached.tags || [] };
         }
-        return { type: '', name: '', description: '' };
+        return { type: '', name: '', description: '', tags: [] };
+    }
+}
+// 每个 AID 的自定义 agent.md 选项 (昵称、描述)
+function getAidMdOptionsPath() {
+    const dir = globalDataDir || process.cwd();
+    return path.join(dir, 'AIDs', '.aid-md-options.json');
+}
+function loadAidMdOptions() {
+    try {
+        const filePath = getAidMdOptionsPath();
+        if (fs.existsSync(filePath)) {
+            return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+        }
+    }
+    catch (_a) { }
+    return {};
+}
+function saveAidMdOptions(aid, opts) {
+    try {
+        const filePath = getAidMdOptionsPath();
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        const all = loadAidMdOptions();
+        all[aid] = opts;
+        fs.writeFileSync(filePath, JSON.stringify(all, null, 2), 'utf-8');
     }
+    catch (_a) { }
+}
+function getAidMdOptionsForAid(aid) {
+    return loadAidMdOptions()[aid] || {};
 }
 // 消息与会话管理 — 每个 AID 独立 MessageStore
 let activeSessionId = null;
@@ -450,6 +520,10 @@ const indexHtml = `<!DOCTYPE html>
                 <span class="dot-separator">.</span>
                 <select id="apSelect"></select>
             </div>
+            <div style="display:flex;gap:8px;margin-top:8px;">
+                <input type="text" id="aidNickname" placeholder="昵称（选填）" style="flex:1;padding:8px 12px;border:1px solid #ddd;border-radius:6px;font-size:14px;">
+                <input type="text" id="aidDescription" placeholder="描述（选填）" style="flex:2;padding:8px 12px;border:1px solid #ddd;border-radius:6px;font-size:14px;">
+            </div>
             <button class="btn btn-primary" onclick="createAid()">注册 AID</button>
         </div>
 
@@ -558,10 +632,12 @@ const indexHtml = `<!DOCTYPE html>
             var ap = document.getElementById('apSelect').value;
             if (!ap) { showStatus('请选择 AP', 'error'); return; }
             var fullPrefix = prefix + '.' + ap;
+            var nickname = document.getElementById('aidNickname').value.trim();
+            var description = document.getElementById('aidDescription').value.trim();
             try {
-                var res = await fetch('/api/aid/create', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ prefix: fullPrefix }) });
+                var res = await fetch('/api/aid/create', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ prefix: fullPrefix, nickname: nickname, description: description }) });
                 var data = await res.json();
-                if (data.success) { showStatus('AID 注册成功', 'success'); document.getElementById('newAid').value = ''; loadAidInfo(); }
+                if (data.success) { showStatus('AID 注册成功', 'success'); document.getElementById('newAid').value = ''; document.getElementById('aidNickname').value = ''; document.getElementById('aidDescription').value = ''; loadAidInfo(); }
                 else { showStatus(data.error || '注册失败', 'error'); }
             } catch (e) { showStatus('注册失败: ' + e.message, 'error'); }
         }
@@ -659,12 +735,12 @@ const chatHtml = `<!DOCTYPE html>
 
         /* AID Group */
         .aid-group { border-bottom:1px solid var(--border); }
-        .aid-group-header { padding:12px 14px; display:flex; align-items:center; cursor:pointer; background:linear-gradient(135deg,#f8fafc,#f1f5f9); user-select:none; border-left:3px solid var(--primary); }
-        .aid-group-header:hover { background:linear-gradient(135deg,#eef2f7,#e8edf4); }
+        .aid-group-header { padding:12px 14px; display:flex; align-items:center; cursor:pointer; background:linear-gradient(135deg,#eef4ff,#e8f0fe); user-select:none; border-left:3px solid var(--primary); transition:all 0.2s; }
+        .aid-group-header:hover { background:linear-gradient(135deg,#dbeafe,#d0e4fd); }
         .aid-group-info { flex:1; min-width:0; margin-left:4px; }
-        .aid-group-title { font-size:13px; font-weight:700; color:var(--t1); overflow:hidden; text-overflow:ellipsis; white-space:nowrap; display:block; }
-        .aid-group-desc { font-size:10px; color:var(--t2); overflow:hidden; text-overflow:ellipsis; white-space:nowrap; margin-top:2px; display:block; }
-        .aid-group-arrow { font-size:10px; color:var(--t2); transition:transform 0.2s; flex-shrink:0; }
+        .aid-group-title { font-size:13px; font-weight:700; color:#1e40af; background:linear-gradient(135deg,#dbeafe,#c7d7fe); padding:2px 8px; border-radius:6px; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; display:inline-block; max-width:100%; border:1px solid #bfdbfe; }
+        .aid-group-desc { font-size:10px; color:#6b7280; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; margin-top:3px; display:block; padding-left:2px; }
+        .aid-group-arrow { font-size:10px; color:var(--primary); transition:transform 0.2s; flex-shrink:0; }
         .aid-group-arrow.open { transform:rotate(90deg); }
         .aid-group-badge { font-size:10px; background:var(--primary); color:#fff; padding:1px 6px; border-radius:8px; margin-left:8px; flex-shrink:0; }
         .aid-group-add { background:none; border:1px solid var(--border); color:var(--t2); width:22px; height:22px; border-radius:4px; cursor:pointer; font-size:14px; line-height:20px; text-align:center; margin-left:6px; flex-shrink:0; }
@@ -672,24 +748,25 @@ const chatHtml = `<!DOCTYPE html>
         .aid-group-del { background:none; border:none; color:var(--t2); width:20px; height:20px; border-radius:4px; cursor:pointer; font-size:12px; line-height:20px; text-align:center; margin-left:4px; flex-shrink:0; display:none; }
         .aid-group-header:hover .aid-group-del { display:block; }
         .aid-group-del:hover { color:#dc3545; background:#ffebeb; }
-        .session-del { position:absolute; right:8px; top:12px; background:none; border:none; color:var(--t2); font-size:12px; cursor:pointer; display:none; padding:2px; }
+        .session-del { position:absolute; right:8px; top:50%; transform:translateY(-50%); background:none; border:none; color:var(--t2); font-size:12px; cursor:pointer; display:none; padding:2px; }
         .session-item:hover .session-del { display:block; }
         .session-del:hover { color:#dc3545; }
-        .aid-group-sessions { display:none; }
+        .aid-group-sessions { display:none; background:#fafbfc; }
         .aid-group-sessions.open { display:block; }
 
-        .aid-group-avatar { width:34px; height:34px; border-radius:50%; object-fit:cover; flex-shrink:0; margin-right:8px; box-shadow:0 1px 3px rgba(0,0,0,0.12); }
+        .aid-group-avatar { width:36px; height:36px; border-radius:50%; object-fit:cover; flex-shrink:0; margin-right:8px; box-shadow:0 1px 4px rgba(37,99,235,0.18); border:2px solid #bfdbfe; }
 
-        .session-item { padding:10px 14px 10px 32px; border-bottom:1px solid #f3f4f6; cursor:pointer; transition:background 0.15s; position:relative; }
-        .session-item::before { content:''; position:absolute; left:18px; top:16px; width:6px; height:6px; border-radius:50%; background:var(--border); }
-        .session-item:hover { background:#f5f7fa; }
+        .session-item { padding:10px 14px 10px 32px; border-bottom:1px solid #f0f1f3; cursor:pointer; transition:all 0.15s; position:relative; }
+        .session-item::before { content:''; position:absolute; left:18px; top:50%; transform:translateY(-50%); width:6px; height:6px; border-radius:50%; background:#d1d5db; }
+        .session-item:hover { background:#f0f5ff; }
         .session-item.active { background:#eff6ff; border-left:3px solid var(--primary); padding-left:29px; }
-        .session-item.active::before { background:var(--primary); }
-        .session-peer { font-weight:400; font-size:12px; color:var(--t1); overflow:hidden; text-overflow:ellipsis; white-space:nowrap; padding-left:10px; }
-        .session-meta { font-size:10px; color:var(--t2); margin-top:2px; display:flex; align-items:center; gap:6px; padding-left:10px; }
-        .tag { font-size:9px; padding:1px 5px; border-radius:3px; color:#fff; }
+        .session-item.active::before { background:var(--primary); box-shadow:0 0 0 2px rgba(37,99,235,0.2); }
+        .session-peer { font-weight:500; font-size:12px; color:var(--t1); overflow:hidden; text-overflow:ellipsis; white-space:nowrap; padding-left:10px; background:#f1f5f9; border-radius:4px; padding:3px 8px 3px 10px; border:1px solid #e8ecf1; }
+        .session-item.active .session-peer { background:#dbeafe; border-color:#bfdbfe; color:#1e40af; }
+        .session-meta { font-size:10px; color:var(--t2); margin-top:4px; display:flex; align-items:center; gap:6px; padding-left:10px; }
+        .tag { font-size:9px; padding:1px 5px; border-radius:3px; color:#fff; font-weight:600; letter-spacing:0.3px; }
         .tag.outgoing { background:var(--ok); }
-        .tag.incoming { background:var(--t2); }
+        .tag.incoming { background:#8b5cf6; }
 
         /* Chat Area */
         .chat-area { flex:1; display:flex; flex-direction:column; background:var(--chat-bg); min-width:0; }
@@ -755,7 +832,8 @@ const chatHtml = `<!DOCTYPE html>
         .bubble ul, .bubble ol { padding-left:1.5em; margin-bottom:0.5em; }
         .bubble li { margin-bottom:0.2em; }
         .bubble blockquote { margin:0.5em 0; padding-left:1em; border-left:4px solid rgba(0,0,0,0.1); color:var(--t2); }
-        .bubble a { color:var(--primary); text-decoration:none; } .bubble a:hover { text-decoration:underline; }
+        .bubble a { color:var(--primary); text-decoration:underline; } .bubble a:hover { opacity:0.85; }
+        .message.sent .bubble a { color:#fff; } .message.sent .bubble a:hover { opacity:0.85; }
         .bubble img { max-width:100%; border-radius:4px; }
         .bubble code { background:rgba(0,0,0,0.1); padding:2px 4px; border-radius:3px; font-family:monospace; font-size:0.9em; }
         .bubble pre { background:#2d2d2d; color:#fff; padding:12px; border-radius:6px; overflow-x:auto; margin:8px 0; }
@@ -908,9 +986,9 @@ const chatHtml = `<!DOCTYPE html>
         </div>
     </div>
     <div class="modal-overlay" id="membersModal">
-        <div class="modal">
+        <div class="modal" style="max-width:520px;">
             <h3>群组成员</h3>
-            <div id="membersList" style="max-height:300px;overflow-y:auto;margin-bottom:16px;font-size:13px;"></div>
+            <div id="membersList" style="max-height:400px;overflow-y:auto;margin-bottom:16px;font-size:13px;"></div>
             <div class="modal-btns">
                 <button class="mbtn mbtn-cancel" onclick="hideMembersModal()">关闭</button>
             </div>
@@ -942,7 +1020,7 @@ const chatHtml = `<!DOCTYPE html>
                 var d = await r.json();
                 if (d.type || d.name) { agentInfoCache[aid] = d; }
                 return d;
-            } catch(e) { return { type:'', name:'', description:'' }; }
+            } catch(e) { return { type:'', name:'', description:'', tags:[] }; }
         }
         async function deleteSession(e, sessionId){
             e.stopPropagation();
@@ -1040,12 +1118,17 @@ const chatHtml = `<!DOCTYPE html>
         var _pollCount=0;
         async function poll(){
             try {
-                var [sr,mr,wr] = await Promise.all([fetch('/api/sessions'),fetch('/api/messages'),fetch('/api/ws/status')]);
-                var sd=await sr.json(), md=await mr.json(), wd=await wr.json();
-                if(sd.sessions) updateSessions(sd.sessions, sd.activeSessionId);
-                S.closed=md.closed||false;
-                if(md.messages) renderMsgs(md.messages, S.closed);
+                var wr=await fetch('/api/ws/status');
+                var wd=await wr.json();
                 updateDot(wd.status);
+                // P2P会话和消息仅在P2P标签页时刷新
+                if(S.tab==='p2p'){
+                    var [sr,mr] = await Promise.all([fetch('/api/sessions'),fetch('/api/messages')]);
+                    var sd=await sr.json(), md=await mr.json();
+                    if(sd.sessions) updateSessions(sd.sessions, sd.activeSessionId);
+                    S.closed=md.closed||false;
+                    if(md.messages) renderMsgs(md.messages, S.closed);
+                }
                 // 每5次轮询刷新一次AID在线状态
                 if(++_pollCount%5===0){
                     var ar=await fetch('/api/aid'); var ad=await ar.json();
@@ -1273,6 +1356,8 @@ const chatHtml = `<!DOCTYPE html>
                 D.groupInfoBar.style.display=S.activeGroupId?'flex':'none';
                 D.input.placeholder='输入群消息...';
                 D.input.disabled=!S.activeGroupId;
+                D.msgs.dataset.s='';
+                _lastGroupMsgSig='';
                 initGroupClient();
                 pollGroupList();
                 if(S.activeGroupId) pollGroupMessages();
@@ -1282,6 +1367,17 @@ const chatHtml = `<!DOCTYPE html>
                 D.groupInfoBar.style.display='none';
                 D.input.placeholder='输入消息...';
                 D.input.disabled=false;
+                _lastGroupMsgSig='';
+                // 切回P2P时立即刷新消息
+                D.msgs.dataset.s='';
+                if(S.sid){
+                    fetch('/api/messages').then(function(r){ return r.json(); }).then(function(d){
+                        S.closed=d.closed||false;
+                        if(d.messages) renderMsgs(d.messages, S.closed);
+                    }).catch(function(){});
+                } else {
+                    D.msgs.innerHTML='';
+                }
             }
         }
 
@@ -1477,6 +1573,62 @@ const chatHtml = `<!DOCTYPE html>
             } catch(e){ alert('生成邀请码失败: '+e.message); }
         }
 
+        function copyMemberAid(btn,aid){
+            navigator.clipboard.writeText(aid).then(function(){
+                btn.textContent='已复制';
+                setTimeout(function(){ btn.textContent='复制'; },1200);
+            });
+        }
+
+        async function openAgentMdPage(aid){
+            try {
+                var r=await fetch('/api/agent-md-raw?aid='+encodeURIComponent(aid));
+                var d=await r.json();
+                if(!d.success||!d.content){ alert(d.error||'获取 agent.md 失败'); return; }
+                var md=d.content;
+                // 简单 markdown 渲染
+                function renderMd(src){
+                    var h=escH(src);
+                    // headings
+                    h=h.replace(/^######\\s+(.+)$/gm,'<h6>$1</h6>');
+                    h=h.replace(/^#####\\s+(.+)$/gm,'<h5>$1</h5>');
+                    h=h.replace(/^####\\s+(.+)$/gm,'<h4>$1</h4>');
+                    h=h.replace(/^###\\s+(.+)$/gm,'<h3>$1</h3>');
+                    h=h.replace(/^##\\s+(.+)$/gm,'<h2>$1</h2>');
+                    h=h.replace(/^#\\s+(.+)$/gm,'<h1>$1</h1>');
+                    // bold & italic
+                    h=h.replace(/\\*\\*(.+?)\\*\\*/g,'<strong>$1</strong>');
+                    h=h.replace(/\\*(.+?)\\*/g,'<em>$1</em>');
+                    // blockquote
+                    h=h.replace(/^&gt;\\s?(.+)$/gm,'<blockquote style="border-left:3px solid #ddd;padding-left:12px;color:#666;margin:8px 0;">$1</blockquote>');
+                    // list items
+                    h=h.replace(/^-\\s+(.+)$/gm,'<li>$1</li>');
+                    // code inline
+                    var bt=String.fromCharCode(96);
+                    h=h.replace(new RegExp(bt+'([^'+bt+']+)'+bt,'g'),'<code style="background:#f5f5f5;padding:1px 4px;border-radius:3px;font-size:12px;">$1</code>');
+                    // frontmatter block: hide ---...---
+                    h=h.replace(/^---[\\s\\S]*?---\\s*/,'');
+                    // paragraphs
+                    h=h.replace(/\\n\\n/g,'</p><p>');
+                    h='<p>'+h+'</p>';
+                    return h;
+                }
+                var html='<!DOCTYPE html><html><head><meta charset="utf-8"><title>'+escH(aid)+' - Agent Profile</title>'
+                    +'<style>body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;max-width:720px;margin:40px auto;padding:0 20px;color:#333;line-height:1.6;}'
+                    +'h1{border-bottom:2px solid #eee;padding-bottom:8px;}h2{border-bottom:1px solid #eee;padding-bottom:6px;margin-top:24px;}'
+                    +'ul{padding-left:20px;}li{margin:4px 0;}blockquote{margin:12px 0;}'
+                    +'pre{background:#f5f5f5;padding:12px;border-radius:6px;overflow-x:auto;}'
+                    +'.aid-badge{display:inline-block;background:#e8f4fd;color:#0969da;padding:2px 8px;border-radius:10px;font-size:12px;font-family:monospace;margin-bottom:16px;}'
+                    +'</style></head><body>'
+                    +'<div class="aid-badge">'+escH(aid)+'</div>'
+                    +renderMd(md)
+                    +'</body></html>';
+                var w=window.open('','_blank');
+                if(w){ w.document.write(html); w.document.close(); }
+                else { alert('弹窗被拦截，请允许弹窗后重试'); }
+            } catch(e){ alert('获取 agent.md 失败: '+e.message); }
+        }
+
         async function showGroupMembers(){
             if(!S.activeGroupId) return;
             try {
@@ -1485,10 +1637,62 @@ const chatHtml = `<!DOCTYPE html>
                 if(d.members){
                     var html=d.members.map(function(m){
                         var aid=m.agent_id||m;
-                        var role=m.role?' ('+m.role+')':'';
-                        return '<div style="padding:6px 0;border-bottom:1px solid #f3f4f6;font-family:monospace;font-size:12px;">'+escH(typeof aid==='string'?aid:JSON.stringify(aid))+role+'</div>';
+                        if(typeof aid!=='string') aid=JSON.stringify(aid);
+                        var role=m.role||'';
+                        var cachedInfo=agentInfoCache[aid];
+                        var avatarSrc=getAvatarSrc(cachedInfo?cachedInfo.type:'');
+                        var displayName=(cachedInfo&&cachedInfo.name)?cachedInfo.name:aid.split('.')[0];
+                        var typeTags='';
+                        if(cachedInfo&&cachedInfo.tags&&cachedInfo.tags.length){
+                            typeTags=cachedInfo.tags.map(function(t){ return '<span style="display:inline-block;background:#e8f4fd;color:#0969da;padding:1px 6px;border-radius:8px;font-size:10px;margin-right:4px;">'+escH(t)+'</span>'; }).join('');
+                        } else if(cachedInfo&&cachedInfo.type){
+                            typeTags='<span style="display:inline-block;background:#e8f4fd;color:#0969da;padding:1px 6px;border-radius:8px;font-size:10px;">'+escH(cachedInfo.type)+'</span>';
+                        }
+                        if(role){ typeTags+='<span style="display:inline-block;background:#fff3cd;color:#856404;padding:1px 6px;border-radius:8px;font-size:10px;margin-left:4px;">'+escH(role)+'</span>'; }
+                        var safeId='member-'+escH(aid).replace(/\\./g,'_');
+                        return '<div id="'+safeId+'" style="padding:10px 0;border-bottom:1px solid #f3f4f6;display:flex;align-items:center;gap:10px;">'
+                            +'<img src="'+avatarSrc+'" style="width:36px;height:36px;border-radius:50%;flex-shrink:0;" class="member-avatar" data-aid="'+escH(aid)+'">'
+                            +'<div style="flex:1;min-width:0;">'
+                            +'<div style="display:flex;align-items:center;gap:6px;flex-wrap:wrap;">'
+                            +'<span style="font-size:13px;font-weight:500;" class="member-name" data-aid="'+escH(aid)+'">'+escH(displayName)+'</span>'
+                            +'<span class="member-tags" data-aid="'+escH(aid)+'">'+typeTags+'</span>'
+                            +'</div>'
+                            +'<div style="font-size:11px;color:var(--t2);font-family:monospace;margin-top:2px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;">'+escH(aid)+'</div>'
+                            +'</div>'
+                            +'<div style="display:flex;gap:4px;flex-shrink:0;">'
+                            +'<button class="mbtn mbtn-ok" style="padding:4px 10px;font-size:11px;" onclick="copyMemberAid(this,\\''+escH(aid)+'\\')">复制</button>'
+                            +'<button class="mbtn mbtn-cancel" style="padding:4px 10px;font-size:11px;" onclick="openAgentMdPage(\\''+escH(aid)+'\\')">查看</button>'
+                            +'</div></div>';
                     }).join('');
                     $('membersList').innerHTML=html||'<div style="color:#999;">暂无成员</div>';
+                    // 异步加载未缓存的 agent info
+                    d.members.forEach(function(m){
+                        var aid=m.agent_id||m;
+                        if(typeof aid!=='string') aid=JSON.stringify(aid);
+                        if(!aid||agentInfoCache[aid]) return;
+                        fetchAgentInfo(aid).then(function(info){
+                            if(!info||(!info.name&&!info.type)) return;
+                            var safeId='member-'+aid.replace(/\\./g,'_');
+                            var el=document.getElementById(safeId);
+                            if(!el) return;
+                            var avatarEl=el.querySelector('.member-avatar[data-aid="'+aid+'"]');
+                            var nameEl=el.querySelector('.member-name[data-aid="'+aid+'"]');
+                            var tagsEl=el.querySelector('.member-tags[data-aid="'+aid+'"]');
+                            if(avatarEl) avatarEl.src=getAvatarSrc(info.type);
+                            if(nameEl) nameEl.textContent=info.name||aid.split('.')[0];
+                            if(tagsEl){
+                                var tags='';
+                                if(info.tags&&info.tags.length){
+                                    tags=info.tags.map(function(t){ return '<span style="display:inline-block;background:#e8f4fd;color:#0969da;padding:1px 6px;border-radius:8px;font-size:10px;margin-right:4px;">'+escH(t)+'</span>'; }).join('');
+                                } else if(info.type){
+                                    tags='<span style="display:inline-block;background:#e8f4fd;color:#0969da;padding:1px 6px;border-radius:8px;font-size:10px;">'+escH(info.type)+'</span>';
+                                }
+                                // 保留已有的 role tag
+                                var existingRole=tagsEl.querySelector('span[style*="fff3cd"]');
+                                tagsEl.innerHTML=tags+(existingRole?existingRole.outerHTML:'');
+                            }
+                        });
+                    });
                 } else { $('membersList').innerHTML='<div style="color:#999;">获取失败</div>'; }
                 $('membersModal').classList.add('show');
             } catch(e){ alert('获取成员失败: '+e.message); }
@@ -1676,6 +1880,22 @@ async function handleRequest(req, res) {
         sendJson(res, info);
         return;
     }
+    // 获取远程 agent.md 原始内容
+    if (pathname === '/api/agent-md-raw' && method === 'GET') {
+        const aid = parsedUrl.query.aid;
+        if (!aid) {
+            sendJson(res, { success: false, error: '缺少 aid' });
+            return;
+        }
+        try {
+            const md = await fetchAgentMd(aid);
+            sendJson(res, { success: true, content: md });
+        }
+        catch (e) {
+            sendJson(res, { success: false, error: e.message || '获取失败' });
+        }
+        return;
+    }
     if (pathname === '/api/aid' && method === 'GET') {
         try {
             const aidList = await datamanager_1.CertAndKeyStore.getAids();
@@ -1752,6 +1972,17 @@ async function handleRequest(req, res) {
             try {
                 const created = await agentCP.createAid(aid);
                 currentAid = created;
+                // 保存自定义昵称和描述
+                const nickname = (body.nickname || '').trim();
+                const description = (body.description || '').trim();
+                if (nickname || description) {
+                    const opts = {};
+                    if (nickname)
+                        opts.name = nickname;
+                    if (description)
+                        opts.description = description;
+                    saveAidMdOptions(created, opts);
+                }
                 sendJson(res, { success: true, aid: created });
             }
             catch (createErr) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acp-ts",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "description": "基于 ACP智能体通信协议 的智能体通信库，提供智能体身份管理和实时通信功能",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",