acp-ts 1.2.3 → 1.2.5

package/dist/agentcp.js

@@ -77,7 +77,7 @@ class AgentCP {
         }
         const baseUrl = `https://acp3.${apiUrl}`;
         this.seedPassword = seedPassword;
-        this._basePath = basePath || process.cwd();
+        this._basePath = basePath || datamanager_1.DEFAULT_ACP_DIR;
         this.apUrl = `${baseUrl}/api/accesspoint`;
         this.msgUrl = `${baseUrl}/api/message`;
         this._persistGroupMessages = (_a = options === null || options === void 0 ? void 0 : options.persistGroupMessages) !== null && _a !== void 0 ? _a : true;
@@ -96,7 +96,7 @@ class AgentCP {
             await (0, cert_1.preloadCrypto)();
         }
         catch (error) {
-            console.warn('AgentCP 加密模块预热失败:', error);
+            utils_1.logger.warn('AgentCP 加密模块预热失败:', error);
         }
     }
     /// 导入本地用户信息
@@ -226,11 +226,11 @@ class AgentCP {
                     this.agentMdUploaded = true;
                 }
                 else {
-                    console.warn('agent.md 上传失败:', result.error);
+                    utils_1.logger.warn('agent.md 上传失败:', result.error);
                 }
             }
             catch (err) {
-                console.warn('agent.md 上传异常:', err);
+                utils_1.logger.warn('agent.md 上传异常:', err);
             }
         }
         // 自动生成并上传 agent.md（仅当未设置自定义路径且启用了自动生成时）
@@ -245,14 +245,14 @@ class AgentCP {
                 const result = await fileSync.uploadAgentMd(content);
                 if (result.success) {
                     this.saveAgentMdMarker(aid);
-                    console.log(`agent.md 自动生成并上传成功: ${aid}`);
+                    utils_1.logger.log(`agent.md 自动生成并上传成功: ${aid}`);
                 }
                 else {
-                    console.warn('agent.md 自动上传失败:', result.error);
+                    utils_1.logger.warn('agent.md 自动上传失败:', result.error);
                 }
             }
             catch (err) {
-                console.warn('agent.md 自动生成异常:', err);
+                utils_1.logger.warn('agent.md 自动生成异常:', err);
             }
         }
         return {
@@ -304,7 +304,7 @@ class AgentCP {
             fs.writeFileSync(this.getAgentMdMarkerPath(aid), new Date().toISOString(), 'utf-8');
         }
         catch (err) {
-            console.warn('保存 agent.md 标记文件失败:', err);
+            utils_1.logger.warn('保存 agent.md 标记文件失败:', err);
         }
     }
     // ============================================================
@@ -368,7 +368,7 @@ class AgentCP {
     handleGroupMessage(message) {
         var _a, _b;
         if (this.groupClient == null || !this._groupTargetAid) {
-            console.log(`[Group] handleGroupMessage skipped: groupClient=${this.groupClient != null}, targetAid=${this._groupTargetAid}`);
+            utils_1.logger.log(`[Group] handleGroupMessage skipped: groupClient=${this.groupClient != null}, targetAid=${this._groupTargetAid}`);
             return false;
         }
         const data = message.data || message;
@@ -377,15 +377,16 @@ class AgentCP {
             try {
                 const rawMsg = (_b = data.message) !== null && _b !== void 0 ? _b : "";
                 if (typeof rawMsg === 'string' && rawMsg) {
+                    utils_1.logger.log(`[Group] handleGroupMessage: routing to groupClient, sender=${sender} msgLen=${rawMsg.length}`);
                     this.groupClient.handleIncoming(rawMsg);
                 }
                 else {
-                    console.warn(`[Group] rawMsg is not a non-empty string, skipping handleIncoming`);
+                    utils_1.logger.warn(`[Group] rawMsg is not a non-empty string, skipping handleIncoming. type=${typeof rawMsg}`);
                 }
                 return true;
             }
             catch (e) {
-                console.error("[Group] handleIncoming error:", e);
+                utils_1.logger.error("[Group] handleIncoming error:", e);
                 return true;
             }
         }
@@ -408,20 +409,20 @@ class AgentCP {
     _createDefaultGroupEventHandler() {
         return {
             onNewMessage(groupId, latestMsgId, sender, preview) {
-                console.log(`[Group][DefaultHandler] onNewMessage: group=${groupId} msgId=${latestMsgId} sender=${sender} preview=${preview}`);
+                utils_1.logger.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}`);
+                utils_1.logger.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}`);
+                utils_1.logger.log(`[Group][DefaultHandler] onGroupInvite: group=${groupId} address=${groupAddress} invitedBy=${invitedBy}`);
             },
             onJoinApproved: (groupId, groupAddress) => {
-                console.log(`[Group][DefaultHandler] onJoinApproved: group=${groupId} address=${groupAddress}`);
+                utils_1.logger.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`);
+                            utils_1.logger.warn(`[Group][DefaultHandler] onJoinApproved skipped: groupOps or targetAid not available`);
                             return;
                         }
                         let groupName = groupId;
@@ -433,27 +434,24 @@ class AgentCP {
                         this.addGroupToStore(groupId, groupName);
                     }
                     catch (e) {
-                        console.error(`[Group][DefaultHandler] onJoinApproved processing failed: group=${groupId}`, e.message);
+                        utils_1.logger.error(`[Group][DefaultHandler] onJoinApproved processing failed: group=${groupId}`, e.message);
                     }
                 })();
             },
             onJoinRejected(groupId, reason) {
-                console.log(`[Group][DefaultHandler] onJoinRejected: group=${groupId} reason=${reason}`);
+                utils_1.logger.log(`[Group][DefaultHandler] onJoinRejected: group=${groupId} reason=${reason}`);
             },
             onJoinRequestReceived(groupId, agentId, message) {
-                console.log(`[Group][DefaultHandler] onJoinRequestReceived: group=${groupId} agent=${agentId}`);
+                utils_1.logger.log(`[Group][DefaultHandler] onJoinRequestReceived: group=${groupId} agent=${agentId}`);
             },
             onGroupMessageBatch: (groupId, batch) => {
-                console.log(`[Group][DefaultHandler] onGroupMessageBatch: group=${groupId} count=${batch.count} range=[${batch.start_msg_id}, ${batch.latest_msg_id}]`);
+                utils_1.logger.log(`[Group][DefaultHandler] onGroupMessageBatch: group=${groupId} count=${batch.count} range=[${batch.start_msg_id}, ${batch.latest_msg_id}]`);
                 this.processAndAckBatch(groupId, batch).catch(e => {
-                    console.error(`[Group][DefaultHandler] processAndAckBatch failed: group=${groupId}`, e);
+                    utils_1.logger.error(`[Group][DefaultHandler] processAndAckBatch failed: group=${groupId}`, e);
                 });
             },
             onGroupEvent(groupId, evt) {
-                console.log(`[Group][DefaultHandler] onGroupEvent: group=${groupId} event=${evt.event_type}`);
-            },
-            onDutyDispatch(groupId, context) {
-                console.log(`[Group][DefaultHandler] onDutyDispatch: group=${groupId} original_msg_id=${context.original_msg_id} sender=${context.sender_id}`);
+                utils_1.logger.log(`[Group][DefaultHandler] onGroupEvent: group=${groupId} event=${evt.event_type}`);
             },
         };
     }
@@ -462,7 +460,12 @@ class AgentCP {
      * 返回排序后的消息列表，供上层使用（如推送给浏览器）。
      */
     async processAndAckBatch(groupId, batch) {
-        const sorted = [...batch.messages].sort((a, b) => a.msg_id - b.msg_id);
+        const batchMessages = batch.messages || [];
+        const sorted = [...batchMessages].sort((a, b) => a.msg_id - b.msg_id);
+        utils_1.logger.log(`[AgentCP] processAndAckBatch: group=${groupId} batchCount=${batchMessages.length} sortedCount=${sorted.length} msgIds=[${sorted.map(m => m.msg_id).join(',')}]`);
+        const storeExists = !!this.groupMessageStore;
+        const storeGroupExists = storeExists ? !!this.groupMessageStore.getGroup(groupId) : false;
+        utils_1.logger.log(`[AgentCP] processAndAckBatch: storeExists=${storeExists} storeGroupExists=${storeGroupExists} lastMsgId=${this.getGroupLastMsgId(groupId)}`);
         await this.addGroupMessagesToStore(groupId, sorted);
         // ACK batch 中最后一条消息
         if (sorted.length > 0) {
@@ -478,7 +481,7 @@ class AgentCP {
         if (!this.groupOps || !this._groupTargetAid)
             return;
         this.groupOps.ackMessages(this._groupTargetAid, groupId, msgId).catch(e => {
-            console.warn(`[Group] ack failed: group=${groupId} msgId=${msgId}`, e.message || e);
+            utils_1.logger.warn(`[Group] ack failed: group=${groupId} msgId=${msgId}`, e.message || e);
         });
     }
     /**
@@ -501,7 +504,7 @@ class AgentCP {
                 this.groupClient.close();
             }
             catch (e) {
-                console.error("[Group] group_client close error:", e);
+                utils_1.logger.error("[Group] group_client close error:", e);
             }
             this.groupClient = null;
             this.groupOps = null;
@@ -522,7 +525,7 @@ class AgentCP {
                 await this.groupMessageStore.loadGroupsForAid(this.activeAid);
             }
             catch (e) {
-                console.warn('[AgentCP] 加载群消息存储失败:', e);
+                utils_1.logger.warn('[AgentCP] 加载群消息存储失败:', e);
             }
         }
     }
@@ -573,7 +576,7 @@ class AgentCP {
             for (const local of localGroups) {
                 if (!serverGroupIds.has(local.groupId)) {
                     await this.groupMessageStore.deleteGroup(local.groupId);
-                    console.log(`[Group] syncGroupList: 清理本地已退出群组 ${local.groupId}`);
+                    utils_1.logger.log(`[Group] syncGroupList: 清理本地已退出群组 ${local.groupId}`);
                 }
             }
         }
@@ -630,8 +633,10 @@ class AgentCP {
      * 批量添加群消息到本地存储
      */
     async addGroupMessagesToStore(groupId, msgs) {
-        if (!this.groupMessageStore)
+        if (!this.groupMessageStore) {
+            utils_1.logger.warn(`[AgentCP] addGroupMessagesToStore: groupMessageStore is NULL! group=${groupId} msgs=${msgs.length} — 消息将丢失!`);
             return;
+        }
         await this.groupMessageStore.addMessages(groupId, msgs);
     }
     /**
@@ -677,17 +682,19 @@ class AgentCP {
                 });
                 await this.addGroupMessagesToStore(groupId, msgs);
                 // ACK 这批消息中的最后一条
-                const lastMsgId = msgs[msgs.length - 1].msg_id;
-                await this.groupOps.ackMessages(this._groupTargetAid, groupId, lastMsgId);
-                // 更新 after 用于下一轮拉取
-                after = lastMsgId;
+                if (msgs.length > 0) {
+                    const lastMsgId = msgs[msgs.length - 1].msg_id;
+                    await this.groupOps.ackMessages(this._groupTargetAid, groupId, lastMsgId);
+                    // 更新 after 用于下一轮拉取
+                    after = lastMsgId;
+                }
                 if (!pulled.has_more) {
                     break;
                 }
             }
         }
         catch (e) {
-            console.warn('[AgentCP] pullAndStoreGroupMessages error:', e.message);
+            utils_1.logger.warn('[AgentCP] pullAndStoreGroupMessages error:', e.message);
         }
         return this.getLocalGroupMessages(groupId);
     }
@@ -707,14 +714,14 @@ class AgentCP {
         // Step 1: register_online（仅通知 group.ap 在线，不再返回游标）
         await this.groupOps.registerOnline(this._groupTargetAid);
         this._onlineGroups.add(groupId);
-        console.log(`[Group] joinGroupSession: group=${groupId}`);
+        utils_1.logger.log(`[Group] joinGroupSession: group=${groupId}`);
         // Step 2: 冷启动同步 — 拉取历史消息对齐，再进入批推送接收
         try {
             const lastMsgId = this.getGroupLastMsgId(groupId);
             await this.pullAndStoreGroupMessages(groupId, lastMsgId, 50);
         }
         catch (e) {
-            console.warn(`[Group] cold-start sync failed: group=${groupId}`, e.message || e);
+            utils_1.logger.warn(`[Group] cold-start sync failed: group=${groupId}`, e.message || e);
         }
         // Step 3: 启动心跳定时器（首次加入群组时启动）
         this._ensureHeartbeat();
@@ -734,7 +741,7 @@ class AgentCP {
                 await this.groupOps.unregisterOnline(this._groupTargetAid);
             }
             catch (e) {
-                console.warn(`[Group] unregisterOnline failed`, e.message || e);
+                utils_1.logger.warn(`[Group] unregisterOnline failed`, e.message || e);
             }
             this._stopHeartbeat();
         }
@@ -776,7 +783,7 @@ class AgentCP {
         this._heartbeatTimer = setInterval(() => {
             this._sendHeartbeats();
         }, this._heartbeatIntervalMs);
-        console.log(`[Group] heartbeat started: interval=${this._heartbeatIntervalMs}ms`);
+        utils_1.logger.log(`[Group] heartbeat started: interval=${this._heartbeatIntervalMs}ms`);
     }
     /**
      * 停止心跳定时器
@@ -785,7 +792,7 @@ class AgentCP {
         if (this._heartbeatTimer) {
             clearInterval(this._heartbeatTimer);
             this._heartbeatTimer = null;
-            console.log(`[Group] heartbeat stopped`);
+            utils_1.logger.log(`[Group] heartbeat stopped`);
         }
     }
     /**
@@ -795,7 +802,7 @@ class AgentCP {
         if (!this.groupOps || !this._groupTargetAid)
             return;
         this.groupOps.heartbeat(this._groupTargetAid).catch(e => {
-            console.warn(`[Group] heartbeat failed`, e.message || e);
+            utils_1.logger.warn(`[Group] heartbeat failed`, e.message || e);
         });
     }
     /**

package/dist/agentws.d.ts

@@ -85,9 +85,15 @@ declare class AgentWS implements IAgentWS {
      */
     disconnect(): void;
     /**
-     * 重连 WebSocket（心跳重连成功后调用）
+     * 注册"快速重连全部失败"回调，透传 WSClient 的回调
      */
-    reconnect(): Promise<void>;
+    onReconnectNeeded(cb: () => void): void;
+    /**
+     * 重连 WebSocket
+     * @param newServer 新的消息服务器地址（可选，重新鉴权后传入）
+     * @param newSignature 新的签名（可选，重新鉴权后传入）
+     */
+    reconnect(newServer?: string, newSignature?: string): Promise<void>;
     /**
      * 接受来自心跳通道的邀请
      * 当心跳客户端收到邀请时，调用此方法通过 WebSocket 加入会话

package/dist/agentws.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentWS = void 0;
 const websocket_1 = require("./websocket");
+const utils_1 = require("./utils");
 /**
  * AgentWS类
  * 提供基于WebSocket的智能体通信功能，封装了WebSocket连接、会话创建和消息传递等操作
@@ -69,7 +70,7 @@ class AgentWS {
                 this.invite(receiver, sessionRes.sessionId, sessionRes.identifyingCode, onInviteStatus);
             }
             else {
-                console.error("会话创建成功但未返回sessionId或identifyingCode");
+                utils_1.logger.error("会话创建成功但未返回sessionId或identifyingCode");
             }
         });
     }
@@ -145,10 +146,27 @@ class AgentWS {
         this.msgClient.disconnect();
     }
     /**
-     * 重连 WebSocket（心跳重连成功后调用）
+     * 注册"快速重连全部失败"回调，透传 WSClient 的回调
      */
-    async reconnect() {
-        await this.msgClient.reconnect();
+    onReconnectNeeded(cb) {
+        this.msgClient.onReconnectNeeded(cb);
+    }
+    /**
+     * 重连 WebSocket
+     * @param newServer 新的消息服务器地址（可选，重新鉴权后传入）
+     * @param newSignature 新的签名（可选，重新鉴权后传入）
+     */
+    async reconnect(newServer, newSignature) {
+        let newUrl;
+        if (newServer && newSignature) {
+            this.messageServer = newServer;
+            this.messageSignature = newSignature;
+            let url = newServer.replace("https://", "wss://").replace("http://", "ws://");
+            const encodedAid = encodeURIComponent(this.aid);
+            const encodedSignature = encodeURIComponent(newSignature);
+            newUrl = `${url}/session?agent_id=${encodedAid}&signature=${encodedSignature}`;
+        }
+        await this.msgClient.reconnect(newUrl);
     }
     /**
      * 接受来自心跳通道的邀请

package/dist/api.js

@@ -35,7 +35,7 @@ async function getGuestAid(apiUrl, seedPassword) {
         return null;
     }
     catch (error) {
-        console.error('获取访客证书失败:', error);
+        utils_1.logger.error('获取访客证书失败:', error);
         return null;
     }
 }
@@ -57,7 +57,7 @@ async function getEntryPointConfig(aid, apiUrl) {
         return null;
     }
     catch (error) {
-        console.error('获取接入点配置失败:', error);
+        utils_1.logger.error('获取接入点配置失败:', error);
         return null;
     }
 }
@@ -78,7 +78,7 @@ async function signCert(agentId, apiUrl, csr) {
         return null;
     }
     catch (error) {
-        console.error('sign_cert接口异常:', error, data);
+        utils_1.logger.error('sign_cert接口异常:', error, data);
         return null;
     }
 }
@@ -107,7 +107,7 @@ async function signIn(agentId, apiUrl, privateKey, publicKeyPem, certPem) {
                 certificate = certificate || keyInfo.certPem;
             }
             if (!publicKey || !certificate) {
-                console.error('signIn 失败: 无法获取公钥或证书');
+                utils_1.logger.error('signIn 失败: 无法获取公钥或证书');
                 return null;
             }
             const signatureHex = await (0, cert_1.signPrivate)(nonce, privateKey);
@@ -128,15 +128,15 @@ async function signIn(agentId, apiUrl, privateKey, publicKeyPem, certPem) {
                     signData
                 };
             }
-            console.error('signIn 第二步失败:', res.status, res.data);
+            utils_1.logger.error('signIn 第二步失败:', res.status, res.data);
             return null;
         }
-        console.error('signIn 第一步失败:', response.status, response.data);
+        utils_1.logger.error('signIn 第一步失败:', response.status, response.data);
         return null;
     }
     catch (error) {
         const errMsg = ((_b = (_a = error.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.message) || error.message || error;
-        console.error('登录异常:', errMsg);
+        utils_1.logger.error('登录异常:', errMsg);
         return null;
     }
 }
@@ -158,7 +158,7 @@ async function signOut(agentId, apiUrl) {
         return false;
     }
     catch (error) {
-        console.error('退出登录异常:', error);
+        utils_1.logger.error('退出登录异常:', error);
         return false;
     }
 }

package/dist/cert.js

@@ -8,6 +8,7 @@ exports.signPrivate = signPrivate;
 exports.preloadCrypto = preloadCrypto;
 const jsrsasign_1 = require("jsrsasign");
 const datamanager_1 = require("./datamanager");
+const utils_1 = require("./utils");
 function createSignedCertificate(aid = '') {
     const { pubKeyObj, prvKeyObj } = jsrsasign_1.KEYUTIL.generateKeypair("EC", "secp384r1");
     const prvKeyPEM = jsrsasign_1.KEYUTIL.getPEM(prvKeyObj, "PKCS8PRV");
@@ -61,7 +62,7 @@ async function getPublicKeyPem(agentId) {
         };
     }
     catch (error) {
-        console.error('获取公钥 PEM 格式失败:', error);
+        utils_1.logger.error('获取公钥 PEM 格式失败:', error);
         throw new Error('获取公钥失败');
     }
 }
@@ -215,7 +216,7 @@ async function preloadCrypto() {
         require('jsrsasign');
     }
     catch (error) {
-        console.warn('Crypto preload failed:', error);
+        utils_1.logger.warn('Crypto preload failed:', error);
     }
 }
 function createCSR(commonName, prvKeyPEM, pubKeyPEM) {

package/dist/cli.js

@@ -38,6 +38,7 @@ const server_1 = require("./server");
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const child_process_1 = require("child_process");
+const utils_1 = require("./utils");
 // 判断是否为 Windows 平台
 const isWindows = process.platform === 'win32';
 // 获取 npm 命令（Windows 需要使用 npm.cmd）
@@ -57,7 +58,7 @@ function getVersion() {
 }
 // 更新到最新版本
 function update() {
-    console.log('正在检查更新...');
+    utils_1.logger.log('正在检查更新...');
     const npm = getNpmCommand();
     try {
         // 获取最新版本号
@@ -74,33 +75,33 @@ function update() {
         const latestVersion = result.stdout.trim();
         const currentVersion = getVersion();
         if (latestVersion === currentVersion) {
-            console.log(`当前已是最新版本 v${currentVersion}`);
+            utils_1.logger.log(`当前已是最新版本 v${currentVersion}`);
             return;
         }
-        console.log(`发现新版本 v${latestVersion}，当前版本 v${currentVersion}`);
-        console.log('正在更新...');
+        utils_1.logger.log(`发现新版本 v${latestVersion}，当前版本 v${currentVersion}`);
+        utils_1.logger.log('正在更新...');
         // 执行全局更新
         const installResult = (0, child_process_1.spawnSync)(npm, ['install', '-g', 'acp-ts@latest'], {
             stdio: 'inherit',
             shell: true
         });
         if (installResult.status === 0) {
-            console.log(`更新成功！已更新到 v${latestVersion}`);
+            utils_1.logger.log(`更新成功！已更新到 v${latestVersion}`);
         }
         else {
             // 可能是权限问题
             if (!isWindows) {
-                console.log('\n更新失败，可能需要管理员权限，请尝试运行:');
-                console.log('  sudo npm install -g acp-ts@latest');
+                utils_1.logger.log('\n更新失败，可能需要管理员权限，请尝试运行:');
+                utils_1.logger.log('  sudo npm install -g acp-ts@latest');
             }
             else {
-                console.log('\n更新失败，请尝试以管理员身份运行命令提示符后重试');
+                utils_1.logger.log('\n更新失败，请尝试以管理员身份运行命令提示符后重试');
             }
             process.exit(1);
         }
     }
     catch (error) {
-        console.error('更新失败:', error.message);
+        utils_1.logger.error('更新失败:', error.message);
         process.exit(1);
     }
 }
@@ -115,18 +116,18 @@ for (let i = 0; i < args.length; i++) {
         process.exit(0);
     }
     else if (args[i] === '-v' || args[i] === '--version') {
-        console.log(`acp-ts v${getVersion()}`);
+        utils_1.logger.log(`acp-ts v${getVersion()}`);
         process.exit(0);
     }
     else if (args[i] === '-p' || args[i] === '--port') {
         const portArg = args[i + 1];
         if (!portArg || portArg.startsWith('-')) {
-            console.error('错误: -p 参数需要指定端口号');
+            utils_1.logger.error('错误: -p 参数需要指定端口号');
             process.exit(1);
         }
         const parsedPort = parseInt(portArg, 10);
         if (isNaN(parsedPort) || parsedPort < 1 || parsedPort > 65535) {
-            console.error('错误: 端口号必须是 1-65535 之间的数字');
+            utils_1.logger.error('错误: 端口号必须是 1-65535 之间的数字');
             process.exit(1);
         }
         port = parsedPort;
@@ -135,7 +136,7 @@ for (let i = 0; i < args.length; i++) {
     else if (args[i] === '-u' || args[i] === '--url') {
         const urlArg = args[i + 1];
         if (!urlArg || urlArg.startsWith('-')) {
-            console.error('错误: -u 参数需要指定 URL');
+            utils_1.logger.error('错误: -u 参数需要指定 URL');
             process.exit(1);
         }
         apiUrl = urlArg;
@@ -144,14 +145,14 @@ for (let i = 0; i < args.length; i++) {
     else if (args[i] === '-d' || args[i] === '--data-dir') {
         const dirArg = args[i + 1];
         if (!dirArg || dirArg.startsWith('-')) {
-            console.error('错误: -d 参数需要指定数据目录路径');
+            utils_1.logger.error('错误: -d 参数需要指定数据目录路径');
             process.exit(1);
         }
         dataDir = dirArg;
         i++;
     }
     else if (args[i] === '-h' || args[i] === '--help') {
-        console.log(`
+        utils_1.logger.log(`
 acp-ts - 智能体通信调试工具 v${getVersion()}
 
 用法:

package/dist/datamanager.d.ts

@@ -1,3 +1,5 @@
+declare const DEFAULT_ACP_DIR: string;
+export { DEFAULT_ACP_DIR };
 export declare class CertAndKeyStore {
     static aidKey: string;
     private static basePath;