acp-ts 1.1.5 → 1.1.7

package/dist/agentcp.d.ts

@@ -85,6 +85,11 @@ declare class AgentCP implements IAgentCP {
      * 设置群组事件处理器
      */
     setGroupEventHandler(handler: ACPGroupEventHandler): void;
+    /**
+     * 创建默认的群组事件处理器（防御性，仅打印日志）。
+     * 外部可通过 setGroupEventHandler 覆盖。
+     */
+    private _createDefaultGroupEventHandler;
     /**
      * 设置群组游标存储
      */
@@ -127,6 +132,10 @@ declare class AgentCP implements IAgentCP {
      * 添加群组到本地存储
      */
     addGroupToStore(groupId: string, name: string): void;
+    /**
+     * 将加入的群组注册到 Home AP（内部方法）
+     */
+    registerGroupToHomeAP(groupId: string, groupUrl: string, role?: string): Promise<void>;
     /**
      * 从本地存储删除群组
      */

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,58 @@ 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}`);
+                (async () => {
+                    try {
+                        if (!this.groupOps || !this._groupTargetAid) {
+                            console.warn(`[Group][DefaultHandler] onJoinApproved skipped: groupOps or targetAid not available`);
+                            return;
+                        }
+                        let groupName = groupId;
+                        try {
+                            const info = await this.groupOps.getGroupInfo(this._groupTargetAid, groupId);
+                            groupName = info.name || groupId;
+                        }
+                        catch (_) { }
+                        this.addGroupToStore(groupId, groupName);
+                        const groupUrl = groupAddress || `https://${this._groupTargetAid}/${groupId}`;
+                        await this.registerGroupToHomeAP(groupId, groupUrl);
+                    }
+                    catch (e) {
+                        console.error(`[Group][DefaultHandler] onJoinApproved processing failed: group=${groupId}`, e.message);
+                    }
+                })();
+            },
+            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}`);
+            },
+        };
+    }
     /**
      * 设置群组游标存储
      */
@@ -497,6 +553,20 @@ class AgentCP {
             return;
         this.groupMessageStore.getOrCreateGroup(groupId, this._groupTargetAid, name);
     }
+    /**
+     * 将加入的群组注册到 Home AP（内部方法）
+     */
+    async registerGroupToHomeAP(groupId, groupUrl, role = 'member') {
+        if (!this.groupOps || !this._groupTargetAid)
+            return;
+        try {
+            await this.groupOps.registerMembership(this._groupTargetAid, groupId, groupUrl, this._groupTargetAid, this._groupSessionId, role);
+            console.log(`[Group] registerGroupToHomeAP success: group=${groupId}`);
+        }
+        catch (e) {
+            console.error(`[Group] registerGroupToHomeAP failed: group=${groupId}`, e.message);
+        }
+    }
     /**
      * 从本地存储删除群组
      */

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,58 @@ 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}`);
+            // 审核通过：获取群信息、添加本地存储、注册到 Home AP
+            (async () => {
+                try {
+                    if (!instance.agentCP.groupOps) {
+                        console.warn(`[Group] onJoinApproved skipped: groupOps not available`);
+                        return;
+                    }
+                    let groupName = groupId;
+                    try {
+                        const info = await instance.agentCP.groupOps.getGroupInfo(instance.groupTargetAid, groupId);
+                        groupName = info.name || groupId;
+                    }
+                    catch (_) { }
+                    instance.agentCP.addGroupToStore(groupId, groupName);
+                    const groupUrl = groupAddress || `https://${instance.groupTargetAid}/${groupId}`;
+                    await instance.agentCP.registerGroupToHomeAP(groupId, groupUrl);
+                }
+                catch (e) {
+                    console.error(`[Group] onJoinApproved processing failed: group=${groupId}`, e.message);
+                }
+            })();
+        },
+        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 +310,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 +327,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 +368,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 +382,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 +407,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: '', 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'));
         }
-        return { type: '', name: '', description: '' };
     }
+    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;
@@ -383,19 +474,19 @@ const indexHtml = `<!DOCTYPE html>
         .container { background: white; padding: 32px; border-radius: 12px; box-shadow: 0 4px 20px rgba(0,0,0,0.1); max-width: 560px; width: 100%; }
         h1 { color: #333; margin-bottom: 24px; text-align: center; font-size: 22px; }
         .hint { text-align: center; color: #999; font-size: 13px; margin-bottom: 20px; }
-        .create-section { margin-bottom: 24px; }
-        .create-section .aid-input-row { display: flex; gap: 8px; margin-bottom: 10px; align-items: center; }
+        .create-section { margin-bottom: 24px; display: flex; flex-direction: column; gap: 12px; }
+        .create-section .aid-input-row { display: flex; gap: 8px; align-items: center; }
         .create-section .aid-input-row input { flex: 1; padding: 10px 14px; border: 1px solid #ddd; border-radius: 8px; font-size: 14px; min-width: 0; }
         .create-section .aid-input-row input:focus { outline: none; border-color: #007bff; }
         .create-section .aid-input-row .dot-separator { color: #999; font-size: 16px; flex-shrink: 0; }
-        .create-section .aid-input-row select { 
-            padding: 10px 30px 10px 14px; 
-            border: 1px solid #ddd; 
-            border-radius: 8px; 
-            font-size: 14px; 
-            background: white; 
-            flex-shrink: 0; 
-            cursor: pointer; 
+        .create-section .aid-input-row select {
+            padding: 10px 30px 10px 14px;
+            border: 1px solid #ddd;
+            border-radius: 8px;
+            font-size: 14px;
+            background: white;
+            flex-shrink: 0;
+            cursor: pointer;
             appearance: none;
             -webkit-appearance: none;
             -moz-appearance: none;
@@ -405,6 +496,9 @@ const indexHtml = `<!DOCTYPE html>
             background-size: 10px auto;
         }
         .create-section .aid-input-row select:focus { outline: none; border-color: #007bff; }
+        .create-section .extra-fields { display: flex; gap: 8px; }
+        .create-section .extra-fields input { flex: 1; padding: 10px 14px; border: 1px solid #ddd; border-radius: 8px; font-size: 14px; min-width: 0; }
+        .create-section .extra-fields input:focus { outline: none; border-color: #007bff; }
         .btn { display: block; width: 100%; padding: 12px; border: none; border-radius: 8px; font-size: 15px; cursor: pointer; transition: background 0.2s; }
         .btn-primary { background: #007bff; color: white; }
         .btn-primary:hover { background: #0056b3; }
@@ -450,6 +544,10 @@ const indexHtml = `<!DOCTYPE html>
                 <span class="dot-separator">.</span>
                 <select id="apSelect"></select>
             </div>
+            <div class="extra-fields">
+                <input type="text" id="aidNickname" placeholder="昵称（选填）">
+                <input type="text" id="aidDescription" placeholder="描述（选填）" style="flex:2;">
+            </div>
             <button class="btn btn-primary" onclick="createAid()">注册 AID</button>
         </div>
 
@@ -558,10 +656,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 +759,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 +772,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 +856,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; }
@@ -823,6 +925,7 @@ const chatHtml = `<!DOCTYPE html>
                 <div class="group-actions">
                     <div class="gbtn" onclick="showCreateGroupModal()">创建群组</div>
                     <div class="gbtn" onclick="showJoinGroupModal()">加入群组</div>
+                    <div class="gbtn" onclick="showMyGroups()">我的群</div>
                 </div>
                 <div class="group-list" id="groupList"><div style="padding:20px;text-align:center;color:#999;font-size:12px;">暂无群组</div></div>
             </div>
@@ -908,9 +1011,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>
@@ -925,6 +1028,15 @@ const chatHtml = `<!DOCTYPE html>
             </div>
         </div>
     </div>
+    <div class="modal-overlay" id="myGroupsModal">
+        <div class="modal" style="max-width:560px;">
+            <h3>我的群</h3>
+            <div id="myGroupsContent" style="max-height:420px;overflow-y:auto;margin-bottom:16px;font-size:13px;"></div>
+            <div class="modal-btns">
+                <button class="mbtn mbtn-cancel" onclick="hideMyGroupsModal()">关闭</button>
+            </div>
+        </div>
+    </div>
     <script>
         var S = { aid:'', sid:null, sessions:[], status:'disconnected', expanded:{}, sidebarOpen:true, aidList:[], closed:false, tab:'p2p', activeGroupId:null, groups:[], groupMsgs:[], groupTargetAid:'', isGroupCreator:false };
         var D = {};
@@ -942,7 +1054,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 +1152,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 +1390,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 +1401,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 +1607,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 +1671,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); }
@@ -1578,6 +1816,39 @@ const chatHtml = `<!DOCTYPE html>
             } catch(e){ alert('退出失败: '+e.message); }
         }
 
+        // ============================================================
+        // 我的群 Functions
+        // ============================================================
+        function showMyGroupsModal(){ $('myGroupsModal').classList.add('show'); }
+        function hideMyGroupsModal(){ $('myGroupsModal').classList.remove('show'); }
+        async function showMyGroups(){
+            showMyGroupsModal();
+            $('myGroupsContent').innerHTML='<div style="text-align:center;padding:20px;color:#999;">加载中...</div>';
+            try {
+                var r=await fetch('/api/group/my-groups');
+                var d=await r.json();
+                if(!d.success){ $('myGroupsContent').innerHTML='<div style="text-align:center;padding:20px;color:#e74c3c;">'+escH(d.error||'获取失败')+'</div>'; return; }
+                var groups=d.groups||[];
+                if(!groups.length){ $('myGroupsContent').innerHTML='<div style="text-align:center;padding:20px;color:#999;">暂无群组</div>'; return; }
+                var html='<table style="width:100%;border-collapse:collapse;font-size:12px;">';
+                html+='<tr style="background:#f8fafc;"><th style="padding:8px 6px;text-align:left;border-bottom:1px solid #e2e8f0;">群名称</th><th style="padding:8px 6px;text-align:left;border-bottom:1px solid #e2e8f0;">群ID</th><th style="padding:8px 6px;text-align:center;border-bottom:1px solid #e2e8f0;">角色</th><th style="padding:8px 6px;text-align:center;border-bottom:1px solid #e2e8f0;">状态</th></tr>';
+                groups.forEach(function(g){
+                    var statusText=g.status===1?'正常':g.status===0?'待审核':'未知('+g.status+')';
+                    var statusColor=g.status===1?'#10b981':g.status===0?'#f59e0b':'#94a3b8';
+                    var shortId=g.group_id.length>16?g.group_id.substring(0,16)+'...':g.group_id;
+                    html+='<tr style="border-bottom:1px solid #f1f5f9;cursor:pointer;" onmouseover="this.style.background=\\'#f0f9ff\\'" onmouseout="this.style.background=\\'\\'">';
+                    html+='<td style="padding:8px 6px;font-weight:500;">'+escH(g.name||g.group_id)+'</td>';
+                    html+='<td style="padding:8px 6px;color:#64748b;" title="'+escH(g.group_id)+'">'+escH(shortId)+'</td>';
+                    html+='<td style="padding:8px 6px;text-align:center;">'+escH(g.role||'-')+'</td>';
+                    html+='<td style="padding:8px 6px;text-align:center;"><span style="color:'+statusColor+';font-weight:500;">'+escH(statusText)+'</span></td>';
+                    html+='</tr>';
+                });
+                html+='</table>';
+                html+='<div style="margin-top:8px;font-size:11px;color:#94a3b8;text-align:right;">共 '+d.total+' 个群组</div>';
+                $('myGroupsContent').innerHTML=html;
+            } catch(e){ $('myGroupsContent').innerHTML='<div style="text-align:center;padding:20px;color:#e74c3c;">请求失败: '+escH(e.message)+'</div>'; }
+        }
+
         // 扩展轮询：群组模式下也轮询群消息
         var _origPoll=poll;
         poll=async function(){
@@ -1676,6 +1947,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 +2039,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) {
@@ -2158,6 +2456,9 @@ async function handleRequest(req, res) {
                 }
                 catch (_) { }
                 instance.agentCP.addGroupToStore(groupId, groupName);
+                // 注册到 Home AP
+                const registrationUrl = `https://${targetAid}/${groupId}`;
+                await instance.agentCP.registerGroupToHomeAP(groupId, registrationUrl);
                 sendJson(res, { success: true, group_id: groupId });
             }
             else {
@@ -2223,6 +2524,31 @@ async function handleRequest(req, res) {
         }
         return;
     }
+    if (pathname === '/api/group/my-groups' && method === 'GET') {
+        try {
+            const instance = await ensureOnline();
+            await ensureGroupClient(instance);
+            const ops = instance.agentCP.groupOps;
+            const target = instance.groupTargetAid;
+            const result = await ops.listMyGroups(target);
+            // 尝试获取每个群的详细信息（名称等）
+            const groups = [];
+            for (const m of result.groups) {
+                let name = m.group_id;
+                try {
+                    const info = await ops.getGroupInfo(target, m.group_id);
+                    name = info.name || m.group_id;
+                }
+                catch (_) { }
+                groups.push(Object.assign(Object.assign({}, m), { name }));
+            }
+            sendJson(res, { success: true, groups, total: result.total });
+        }
+        catch (e) {
+            sendJson(res, { success: false, error: e.message, groups: [] });
+        }
+        return;
+    }
     if (pathname === '/api/group/leave' && method === 'POST') {
         try {
             const body = await parseBody(req);

package/package.json

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