@ia-ccun/code-agent-cli 0.0.52-release → 0.0.53

package/config/agent/bin/README.md

@@ -0,0 +1,102 @@
+# CLI 工具安装指南
+
+本目录包含 `fd` 和 `rg`（ripgrep）两个高效文件搜索工具的各平台预编译二进制文件。
+
+> **Author**: aicode-cli
+
+## 文件清单
+
+| 文件名 | 平台 | 版本 |
+|--------|------|------|
+| `fd` | Linux (x86-64 ELF) | 10.3.0 |
+| `rg` | Linux (x86-64 ELF) | 15.1.0 |
+| `fd.exe` | Windows (x64) | 10.4.2 |
+| `rg.exe` | Windows (x64) | 15.1.0 |
+| `fd-win.zip` | Windows 源码包 | 10.4.2 |
+| `rg-win.zip` | Windows 源码包 | 15.1.0 |
+
+---
+
+## Linux 用户
+
+本目录中的 `fd` 和 `rg` 已是 Linux 可执行文件，无需额外操作，只需赋予执行权限即可使用。
+
+```bash
+# 确保有执行权限
+chmod +x fd rg
+
+# 验证安装
+./fd --version
+./rg --version
+```
+
+### 安装到系统路径（可选）
+
+```bash
+sudo cp fd rg /usr/local/bin/
+```
+
+或安装到用户目录：
+
+```bash
+mkdir -p ~/.local/bin
+cp fd rg ~/.local/bin/
+```
+
+确保 `~/.local/bin` 在 `$PATH` 中。
+
+---
+
+## Windows 用户
+
+本目录已包含 `fd.exe` 和 `rg.exe`，可直接使用。
+
+### 直接使用
+
+```powershell
+# 验证
+.\fd.exe --version
+.\rg.exe --version
+```
+
+### 添加到 PATH（可选）
+
+将 `fd.exe` 和 `rg.exe` 放入以下任一位置：
+
+- `C:\Users\<用户名>\.aicode-cli\agent\bin\`
+- 或任意已在 `%PATH%` 中的目录
+
+**验证：**
+
+```powershell
+# 重新打开终端后执行
+fd --version
+rg --version
+```
+ 
+---
+         
+## macOS 用户
+
+> ⚠️ 本目录 **不提供** macOS 版本二进制文件。
+
+请通过 Homebrew 安装：
+
+```bash
+brew install fd ripgrep
+```
+
+---
+
+## 用途说明
+
+| 工具 | 用途 | 常用示例 |
+|------|------|----------|
+| `fd` | 快速文件查找 | `fd -e ts "pattern"` |
+| `rg` | 快速文本搜索 | `rg -t ts "pattern"` |
+
+---
+
+详细用法请参阅：
+- fd: https://github.com/sharkdp/fd
+- ripgrep: https://github.com/BurntSushi/ripgrep

package/config/agent/extensions/aicode-advisor.ts

@@ -146,6 +146,19 @@ function setDisabledForModels(models: Array<string | { model: string; minEffort?
 }
 
 // ============== 工具清单序列化 ==============
+/**
+ * stableStringify - 稳定序列化对象（键排序）
+ * 
+ * 用于序列化工具参数，确保参数对象的键顺序一致，便于对比和展示。
+ * 
+ * 功能说明：
+ * - 处理 null 和非对象类型：直接 JSON.stringify
+ * - 处理数组：递归序列化每个元素，undefined 替换为 "null"
+ * - 处理对象：键排序后序列化，跳过 undefined 值
+ * 
+ * @param value - 要序列化的值
+ * @returns 稳定的 JSON 字符串（键排序）
+ */
 function stableStringify(value: unknown): string {
   if (value === null || typeof value !== "object") {
     return JSON.stringify(value);

package/config/agent/extensions/aicode-btw.ts

@@ -40,6 +40,18 @@ function matchesBtwFocusShortcut(data: string): boolean {
   return BTW_FOCUS_SHORTCUTS.some((shortcut) => matchesKey(data, shortcut));
 }
 
+/**
+ * 类型守卫：检查 entry 是否是有效的 Message 对象
+ * ✅ 用于安全转换，避免使用危险的 as unknown as
+ */
+function isMessageLike(entry: unknown): entry is Partial<Message> & { role?: string; customType?: string; content?: unknown } {
+  if (!entry || typeof entry !== "object") {
+    return false;
+  }
+  const candidate = entry as { role?: unknown; customType?: string; content?: unknown };
+  return typeof candidate.role === "string" && Array.isArray(candidate.content);
+}
+
 const BTW_SYSTEM_PROMPT = [
   "You are having an aside conversation with the user, separate from their main working session.",
   "If main session messages are provided, they are for context only — that work is being handled by another agent.",
@@ -277,17 +289,17 @@ function buildBtwSeedState(
           (message) => !isVisibleBtwMessage(message),
         ),
       );
-    } catch {
+    } catch (error) {
+      // ✅ 改进错误处理：记录错误而不忽略
+      console.warn('[btw] buildSessionContext failed, using fallback:', error);
       messages.push(
         ...ctx.sessionManager.getEntries().flatMap((entry) => {
-          if (!entry || typeof entry !== "object") {
+          // ✅ 使用类型守卫进行安全转换，避免 as unknown as
+          if (!isMessageLike(entry)) {
             return [];
           }
 
-          const message = entry as unknown as Partial<Message> & { role?: string; customType?: string; content?: unknown };
-          if (typeof message.role !== "string" || !Array.isArray(message.content)) {
-            return [];
-          }
+          const message = entry; // ✅ 类型安全
 
           return isVisibleBtwMessage({ role: message.role, customType: message.customType }) ? [] : [message as Message];
         }),
@@ -380,7 +392,9 @@ function formatToolPreview(value: unknown): string {
       return "";
     }
     return preview.length > 120 ? `${preview.slice(0, 117)}...` : preview;
-  } catch {
+  } catch (error) {
+    // ✅ 改进错误处理：记录错误而不忽略
+    console.warn('[btw] JSON.stringify failed in formatToolPreview:', error);
     return "";
   }
 }
@@ -396,6 +410,26 @@ function createEmptyTranscriptState(): BtwTranscriptState {
   };
 }
 
+/**
+ * clearTranscriptState - 清理 transcriptState 的所有资源
+ * ✅ 清理 entries 数组
+ * ✅ 清理 toolCalls Map（防止内存泄漏）
+ * ✅ 重置所有状态
+ */
+function clearTranscriptState(state: BtwTranscriptState): void {
+  // ✅ 清理 toolCalls Map（防止内存泄漏）
+  state.toolCalls.clear();
+  
+  // 清理 entries 数组
+  state.entries = [];
+  
+  // 重置状态
+  state.nextEntryId = 1;
+  state.nextTurnId = 1;
+  state.currentTurnId = null;
+  state.lastTurnId = null;
+}
+
 function appendTranscriptEntry<T extends BtwTranscriptEntry>(
   state: BtwTranscriptState,
   entry: Omit<T, "id">,
@@ -444,6 +478,13 @@ function finishTranscriptTurn(state: BtwTranscriptState, turnId?: number | null)
   if (state.currentTurnId === resolvedTurnId) {
     state.currentTurnId = null;
   }
+
+  // ✅ 清理当前 turn 的 toolCalls（防止内存泄漏）
+  for (const [toolCallId, toolCall] of state.toolCalls.entries()) {
+    if (toolCall.turnId === resolvedTurnId) {
+      state.toolCalls.delete(toolCallId);
+    }
+  }
 }
 
 function removeTranscriptTurn(state: BtwTranscriptState, turnId: number | null): void {
@@ -574,7 +615,9 @@ function summarizeToolResult(value: unknown, maxLength = 400): { content: string
     } else if (value !== undefined) {
       try {
         content = JSON.stringify(value, null, 2);
-      } catch {
+      } catch (error) {
+        // ✅ 改进错误处理：记录错误而不忽略
+        console.warn('[btw] JSON.stringify failed in summarizeToolResult:', error);
         content = String(value);
       }
     }
@@ -1340,8 +1383,9 @@ export default function (pi: ExtensionAPI) {
 
     try {
       unsubscribe();
-    } catch {
-      // Ignore unsubscribe errors during BTW session replacement/shutdown.
+    } catch (error) {
+      // ✅ 改进错误处理：记录错误而不忽略
+      console.warn('[btw] Unsubscribe failed during session removal:', error);
     }
   }
 
@@ -1402,6 +1446,12 @@ export default function (pi: ExtensionAPI) {
   async function disposeBtwSession(): Promise<void> {
     const current = activeBtwSession;
     activeBtwSession = null;
+
+    // ✅ 清理 transcriptState（防止内存泄漏）
+    if (transcriptState) {
+      clearTranscriptState(transcriptState);
+    }
+
     if (!current) {
       return;
     }
@@ -1410,8 +1460,9 @@ export default function (pi: ExtensionAPI) {
 
     try {
       await current.session.abort();
-    } catch {
-      // Ignore abort errors during BTW session replacement/shutdown.
+    } catch (error) {
+      // ✅ 改进错误处理：记录错误而不忽略
+      console.warn('[btw] Session abort failed during disposal:', error);
     }
 
     current.session.dispose();
@@ -2144,8 +2195,9 @@ export default function (pi: ExtensionAPI) {
     } finally {
       try {
         await session.abort();
-      } catch {
-        // Ignore abort errors during summarize session shutdown.
+      } catch (error) {
+        // ✅ 改进错误处理：记录错误而不忽略
+        console.warn('[btw] Session abort failed during summarize shutdown:', error);
       }
       session.dispose();
     }