@ia-ccun/code-agent-cli 0.0.51-beta.9 → 0.0.52-beta.1

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

@@ -80,6 +80,10 @@ const EXECUTION_TRIGGER_PROMPT =
 // ============== 工具函数 ==============
 
 function isSafeReadOnlyCommand(command: string): boolean {
+	// 临时移除错误重定向 (如 2>/dev/null, 1>&2 等)，避免误判
+	// 错误重定向是只读操作，不应被拦截
+	const normalizedCommand = command.replace(/\d+>[&]?\s*[^\s|;&]+/g, "").trim();
+
 	const DESTRUCTIVE_PATTERNS = [
 		/\brm\b/i,
 		/\brmdir\b/i,
@@ -113,7 +117,8 @@ function isSafeReadOnlyCommand(command: string): boolean {
 		/\bshutdown\b/i,
 		/\bsystemctl\s+(start|stop|restart|enable|disable)\b/i,
 		/\bservice\s+\S+\s+(start|stop|restart)\b/i,
-		/\b(vim?|nano|emacs|code|subl)\b/i,
+		// 编辑器命令 - 只拦截命令开头的编辑器调用，不拦截参数中的匹配
+		/^\s*(vim?|nano|emacs|code|subl)\b/i,
 	];
 
 	const SAFE_PATTERNS = [
@@ -165,9 +170,10 @@ function isSafeReadOnlyCommand(command: string): boolean {
 		/^\s*fd\b/,
 	];
 
-	const isDestructive = DESTRUCTIVE_PATTERNS.some((pattern) => pattern.test(command));
+	// 使用标准化后的命令进行检查（已移除错误重定向）
+	const isDestructive = DESTRUCTIVE_PATTERNS.some((pattern) => pattern.test(normalizedCommand));
 	if (isDestructive) return false;
-	return SAFE_PATTERNS.some((pattern) => pattern.test(command));
+	return SAFE_PATTERNS.some((pattern) => pattern.test(normalizedCommand));
 }
 
 function normalizeArg(input: string): string {
@@ -558,7 +564,7 @@ export default function aicodePlan(pi: ExtensionAPI) {
 		}
 
 		const statusText = planModeEnabled
-			? ctx.ui.theme.fg("warning", "⏸ 计划") + ctx.ui.theme.fg("dim", " | plan (CTRL+ALT+P)")
+			? ctx.ui.theme.fg("warning", "⏸ 计划") + ctx.ui.theme.fg("dim", " | plan (Ctrl+Alt+P)")
 			: undefined;
 		ctx.ui.setStatus(STATUS_KEY, statusText);
 		updateTodoWidget(ctx);
@@ -583,8 +589,8 @@ export default function aicodePlan(pi: ExtensionAPI) {
 		executionMode = false;
 		pi.setActiveTools(planTools);
 		planModeEnabled = true;
+		pi.events.emit("aicode-plan:mode-changed", { enabled: true });
 		setStatus(ctx);
-		pi.events.emit("aicode-plan:mode-changed", { planModeEnabled: true });
 		ctx.ui.notify(`计划模式已启用（只读）: ${planTools.join(", ")}`, "info");
 	};
 
@@ -606,7 +612,7 @@ export default function aicodePlan(pi: ExtensionAPI) {
 		}
 
 		planModeEnabled = false;
-		pi.events.emit("aicode-plan:mode-changed", { planModeEnabled: false });
+		pi.events.emit("aicode-plan:mode-changed", { enabled: false });
 		restoreNormalTools();
 		if (options.resetProgress) {
 			executionMode = false;
@@ -658,7 +664,7 @@ export default function aicodePlan(pi: ExtensionAPI) {
 				];
 				if (!planModeEnabled && !executionMode) {
 					statusLines.push("");
-					statusLines.push("快捷键：CTRL+ALT+P 快速切换计划模式");
+					statusLines.push("快捷键：Alt+Shift+P 快速切换计划模式");
 				}
 				ctx.ui.notify(statusLines.join("\n"), "info");
 				return;
@@ -693,6 +699,7 @@ export default function aicodePlan(pi: ExtensionAPI) {
 	pi.registerShortcut("ctrl+alt+p", {
 		description: "切换计划模式",
 		handler: async (ctx) => {
+			const wasEnabled = planModeEnabled;  // 保存当前状态
 			if (planModeEnabled) {
 				exitPlanMode(ctx, "计划模式已禁用。返回直接执行模式。", {
 					resetProgress: true,
@@ -700,7 +707,8 @@ export default function aicodePlan(pi: ExtensionAPI) {
 			} else {
 				enterPlanMode(ctx);
 			}
-			ctx.ui.notify(`计划模式已${planModeEnabled ? "禁用" : "启用"}`, "info");
+			// 显示切换后的状态
+			ctx.ui.notify(wasEnabled ? "计划模式已关闭 ✓" : "计划模式已开启 ✓");
 		},
 	});
 

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

@@ -10,11 +10,13 @@ import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-a
 
 const AICODE_TIPS = [
   "@ 快速搜索项目文件",
-  "Ctrl+L 快速切换模型",
+  "Ctrl+L 快速切换备选模型,
   "Ctrl+P/Shift+Ctrl+P 切换范围模型",
-  "Shift+Tab 切换思考级别",
+  "Shift+Tab 切换思考级别（ 需 models.json配置 reasoning 启用）",
   "Ctrl+O 展开/折叠工具输出",
-  "Ctrl+T 展开/折叠思考块",
+  "Ctrl+U 清空行内光标前的内容",
+  "Ctrl+K 清空行内光标后的内容",
+  "Ctrl+G 使用高级编辑器进行输入（如vscode), 适合手工输入多行、多段文字的场景",
   "Alt+Enter 队列跟进消息",
   "Shift+Enter 输入多行",
   "/ 查看所有命令",
@@ -34,6 +36,7 @@ const AICODE_TIPS = [
   "/resume 恢复会话",
   "/fork 创建会话新分支",
   "Ctrl+C 清空编辑器",
+  "CTRL+ALT+SHIFT+P  开启/关闭 计划模式（只读模式）",
   "双击 Esc 打开树视图",
   "拖拽文件到终端附加",
   // 扩展命令提示
@@ -43,6 +46,7 @@ const AICODE_TIPS = [
   "/clear 清理当前会话",
   "/quit 退出当前会话",
   // 常用 Prompt 提示
+  "解读下这个图片内容 /home/user/pic/plan.png",
   "/code-simplifier 自动简化刚修改的代码，提升清晰度和一致性",
   "/feat 新功能开发，支持需求规划→讨论迭代→执行实施完整流程（推荐使用）",
   "/git-commit 分析 Git 改动并生成 Conventional Commits 规范提交信息（推荐使用）",
@@ -94,11 +98,36 @@ const AICODE_TIPS = [
   "/btw 并行侧边对话，可在不中断主流程的情况下进行临时讨论或查询 ",
   "/rewind 回退到任意工具执行前的状态，支持快照恢复和撤销重做 ",
   "/mcp 连接现有的 MCP 服务器 (如 xx 平台、企业微信等等)，扩展 AI 能力支持多种外部工具和服务 ",
+  // 新增扩展功能提示
+  "Alt+/ 或 Ctrl+Alt+W 快速切换到 BTW 侧边对话窗口",
+  "BTW 侧边对话：独立上下文，不影响主会话，适合临时查询和讨论",
+  "/advisor 可向更强的审查模型征求第二意见，用于复杂决策和方案评估 ",
+  "/plan 进入计划模式，强制只读分析流程，生成结构化实施计划（推荐使用）",
+  "计划模式禁止写入操作，确保方案经过充分分析后再执行",
+  "计划模式自动生成 Todo 列表，跟踪实施步骤和完成进度",
+  "/goal 设置长期目标，跟踪进度、时间和 token 消耗",
+  "/goal --tokens=50K 设置带 token 预算限制的目标",
+  "Goal 扩展支持 paused/resumed 状态，方便暂停和恢复长期任务 （推荐使用）",,
+  "Goal 扩展显示实时进度：已完成百分比、已用时间和 token 消耗 （推荐使用）",
+  "⚠️ 使用 advisor 获取第二视角评估，避免决策盲点",
+  "⚠️ 使用 plan 模式强制分析流程，避免冲动式编码（推荐使用）",
+  "⚠️ 使用 goal 跟踪长期任务，避免AI自以为是类的完成，AI若完成必须给出证据",
+  "⚠️ BTW 侧边对话适合临时讨论，不会污染主会话上下文",
+  // 使用场景和最佳实践
+  "💡 大型重构任务：先用 /plan 制定计划，再用 /advisor 评估方案风险",
+  "💡 长期开发任务：用 /goal 设置目标并跟踪进度，避免 token 超支",
+  "💡 临时查询需求：打开 BTW 侧边对话，不影响主会话",
+  "💡 复杂决策场景：用 advisor 工具获取第二视角，避免思维盲点",
+  "💡 代码审查流程：用 /skill:code-review + advisor 双重审查确保质量",
+  "💡 新功能开发：用 /feat prompt 启动完整需求规划流程",
+  "💡 性能优化：用 /skill:audit 全面审计界面质量和性能瓶颈",
+  "💡 安全审计：用 /skill:owasp-security 检查 OWASP Top 10 漏洞",
+  "💡 文档生成：用 /skill:writing-plans 生成详细实施文档",
+  "💡 测试覆盖：用 /skill:test-runner 编写和运行多框架测试",
+  "💡 会话整理：用 /clear 清理上下文，用 /compact 压缩历史消息",
   // 消息传递模式提示
   "Enter 插话消息 - 在工具执行后立即发送，中断 AI 思考流程",
-  "Alt+Enter 排队消息 - 等待 AI 完全结束后发送，不中断 AI 工作",
   "Escape 中断当前 AI 并恢复编辑器中的排队消息",
-  "Alt+Up 查看并编辑所有排队的消息",
   "插话消息会打断 AI 正在执行的工具，等待响应",
   "排队消息静默等待，AI 空闲时自动发送",
   "可在 /settings 中调整消息发送模式和行为偏好",
@@ -106,11 +135,18 @@ const AICODE_TIPS = [
   "💡 记忆功能自动记录会话中的关键经验，下次会话自动应用",
   "💡 在对话中说'记住这个'可手动保存经验到记忆库",
   "💡 记忆功能支持选择性注入 (selective)，只注入相关记忆避免干扰",
-  "💡 说'忘记 XXX'可删除特定记忆条目",
+  "💡 说'忘记 XXX '可删除特定记忆条目",
   "💡 记忆会在会话结束时自动整合优化，提炼更有价值的经验",
   "💡 记忆功能示例：记住代码规范后，后续开发自动遵循该规范",
   "💡 记忆功能示例：记录常见错误模式，主动避免重复犯错",
   "💡 记忆功能示例：保存项目特定配置，新会话自动加载上下文",
+  // 安全和最佳实践提示
+  "⚠️ 目前模型算力有限，部分任务可能存在排队等待的情况，若出现卡顿请稍后重试",
+  "⚠️ 执行 shell 命令前会自动检测是否为 safe command，非安全命令需要确认",
+  "⚠️ Banner 启动时显示当前版本、模型配置和常用命令，方便快速查看环境",
+  "⚠️ 使用 !! 前缀执行 bash 命令不会将输出发送给 AI，适合敏感操作",
+  // CodeGraph 使用方法（推荐使用）
+  "🔗 创建本地索引目录并构建知识图谱，操作说明 参考  UniDoc《2026.5 aicode+codegraph 安装与使用》  ",
   // Subagent 使用方法
   "🤖 说'使用 subagent 探索当前代码关于权限校验的实现'可快速定位相关代码",
   "🤖 说'使用 subagent 为这个功能制定实施计划'可生成详细的开发步骤",
@@ -119,6 +155,7 @@ const AICODE_TIPS = [
   "🤖 说'使用 subagent 给这个方案提点意见'可获得第二视角的评估建议",
   // 联系方式提示
   "⚠️  任何疑问或需求可联系 xujianjiang，支持需求对接开发、系统集成与扩展",
+  "⚠️  aicode 图像识别参考 UniDoc《2026.03 AICode Agent CLI 编码智能体使用手册》的model.json模型配置",
   "⚠️  内网手册参考 UniDoc《2026.03 AICode Agent CLI 编码智能体使用手册》",
   "⚠️  LLM API 4xx/5xx 错误时请确认模型配置是否正确，或在企微群咨询 jiangchi、maliang",
 ];

package/config/agent/extensions/custom-footer.ts

@@ -32,7 +32,7 @@ export default function (pi: ExtensionAPI) {
 
 	// 监听 plan 模式变化事件（全局监听，只注册一次）
 	pi.events.on("aicode-plan:mode-changed", (data: any) => {
-		planModeEnabled = data.planModeEnabled;
+		planModeEnabled = data.enabled;
 		footerTui?.requestRender();
 	});
 
@@ -160,7 +160,6 @@ export default function (pi: ExtensionAPI) {
 
 					// quots
 					const quotes = [
-                        "代码是有灵魂的",
                         "敬畏生产，双人复核，稳妥变更",
                         "让代码更有温度",
                         "民生所系，支付所向",
@@ -198,9 +197,9 @@ export default function (pi: ExtensionAPI) {
 
 					// ── Plan mode segment ────────────────────────────────────
 					if (planModeEnabled) {
-						segments.push(theme.fg("success", "⏸ plan mode on"));
+						segments.push(theme.fg("success", "⏸ 计划模式"));
 					}else{
-				    	segments.push(theme.fg("error", "> yolo mode on"));
+				    	segments.push(theme.fg("error", "▶ 自动模式"));
 					}
 
 					segments.push(theme.fg("muted", quote));

package/config/agent/extensions/custom.ts

@@ -2,7 +2,7 @@
  * @author: xujianjiang
  * 自定义扩展示例
  *
- * 放置位置: config/agent/extensions/
+ * 放置位置：config/agent/extensions/
  * 安装后会复制到 ~/.pi/agent/extensions/
  *
  * 可以拦截内置工具、注册自定义工具和命令
@@ -10,7 +10,6 @@
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { AssistantMessage } from "@earendil-works/pi-ai";
-import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
 export default function (pi: ExtensionAPI) {
   // === 记录开始时间 ===
@@ -51,16 +50,20 @@ export default function (pi: ExtensionAPI) {
   // === 拦截工具调用 ===
 
   pi.on("tool_call", async (event, ctx) => {
-    // 拦截 login 工具 - 阻止执行
-    if (event.toolName === "login") {
-      await ctx.ui.notify("⚠️ login 功能已禁用", "warning");
-      return { block: true, reason: "login 功能已禁用" };
-    }
+    try {
+      // 拦截 login 工具 - 阻止执行
+      if (event.toolName === "login") {
+        await ctx.ui.notify("⚠️ login 功能已禁用", "warning");
+        return { block: true, reason: "login 功能已禁用" };
+      }
 
-    // 拦截 logout 工具 - 阻止执行
-    if (event.toolName === "logout") {
-      await ctx.ui.notify("⚠️ logout 功能已禁用", "warning");
-      return { block: true, reason: "logout 功能已禁用" };
+      // 拦截 logout 工具 - 阻止执行
+      if (event.toolName === "logout") {
+        await ctx.ui.notify("⚠️ logout 功能已禁用", "warning");
+        return { block: true, reason: "logout 功能已禁用" };
+      }
+    } catch (e) {
+      // 忽略错误（ctx 可能已过期）
     }
   });
 
@@ -70,22 +73,35 @@ export default function (pi: ExtensionAPI) {
     description: "打招呼命令",
     usage: "/hello [名字]",
     handler: async (args, ctx) => {
-      const name = args || "大佬，您吃了吗";
-      ctx.ui.notify(`你好，${name}！🤝`, "info");
+      try {
+        const name = args || "大佬，您吃了吗";
+        ctx.ui.notify(`你好，${name}！🤝`, "info");
+      } catch (e) {
+        // 忽略错误
+      }
     },
   });
 
   pi.registerCommand("status", {
     description: "显示当前会话状态",
     handler: async (_args, ctx) => {
-      const info = `
+      try {
+        // 保存需要的数据，避免多次触发 getter
+        const model = ctx.session.model?.name || "未知";
+        const workspace = ctx.session.workspace || "未知";
+        const messages = ctx.session.messages?.length || 0;
+        
+        const info = `
 📊 会话状态
 
-- 当前模型: ${ctx.session.model?.name || "未知"}
-- 项目目录: ${ctx.session.workspace || "未知"}
-- 消息数量: ${ctx.session.messages?.length || 0}
+- 当前模型：${model}
+- 项目目录：${workspace}
+- 消息数量：${messages}
       `.trim();
-      ctx.ui.notify(info, "info");
+        ctx.ui.notify(info, "info");
+      } catch (e) {
+        // 忽略错误（ctx 可能已过期）
+      }
     },
   });
 
@@ -93,35 +109,33 @@ export default function (pi: ExtensionAPI) {
     description: "清理当前会话上下文",
     usage: "/clear",
     handler: async (_args, ctx) => {
-      // 获取当前会话条目数
-      const entries = ctx.sessionManager.getBranch();
-      const msgCount = entries.filter(e => e.type === "message").length;
-
-      if (msgCount === 0) {
-        ctx.ui.notify("会话已经是空的", "info");
-        return;
-      }
-
-      // 确认清理
-      const ok = await ctx.ui.confirm("清理会话", `确定要清理当前会话的所有 ${msgCount} 条消息吗？`);
-      if (!ok) {
-        ctx.ui.notify("已取消", "info");
-        return;
-      }
+      try {
+        // 获取当前会话条目数（在 await 前完成所有 ctx 访问）
+        const entries = ctx.sessionManager.getBranch();
+        const msgCount = entries.filter(e => e.type === "message").length;
+        const uiContext = ctx.ui;  // ← 保存 UI context
+
+        if (msgCount === 0) {
+          uiContext.notify("会话已经是空的", "info");
+          return;
+        }
 
-      // 创建新会话来清空上下文
-      const result = await ctx.newSession({
-        setup: async (_sm) => {
-          // 新会话默认为空
-        },
-      });
+        // 确认清理
+        const ok = await uiContext.confirm("清理会话", `确定要清理当前会话的所有 ${msgCount} 条消息吗？`);
+        if (!ok) {
+          uiContext.notify("已取消", "info");
+          return;
+        }
 
-      if (result.cancelled) {
-        ctx.ui.notify("已取消", "info");
-        return;
+        // 创建新会话来清空上下文
+        await ctx.newSession({
+          withSession: async (newCtx) => {
+            newCtx.ui.notify(`✅ 已清理 ${msgCount} 条消息，进入新会话`, "success");
+          },
+        });
+      } catch (e) {
+        // 忽略错误（ctx 可能已过期）
       }
-
-      ctx.ui.notify(`✅ 已清理 ${msgCount} 条消息，进入新会话`, "success");
     },
   });
 
@@ -131,8 +145,12 @@ export default function (pi: ExtensionAPI) {
     description: "退出当前会话",
     usage: "/exit",
     handler: async (_args, ctx) => {
-      ctx.ui.notify("👋 再见！", "info");
-      ctx.shutdown();
+      try {
+        ctx.ui.notify("👋 再见！", "info");
+        ctx.shutdown();
+      } catch (e) {
+        // 忽略错误
+      }
     },
   });
 
@@ -142,28 +160,40 @@ export default function (pi: ExtensionAPI) {
     description: "更新 aicode-cli 工具",
     usage: "/update",
     handler: async (_args, ctx) => {
-      const ok = await ctx.ui.confirm("更新确认", "确定要更新 aicode-cli 吗？");
-      if (!ok) {
-        ctx.ui.notify("已取消", "info");
-        return;
-      }
-
-      ctx.ui.notify("🔄 正在更新 aicode-cli...", "info");
-      const { exec } = await import("child_process");
-      exec("npm install -g @ia-ccun/code-agent-cli", (error, stdout, stderr) => {
-        if (error) {
-          ctx.ui.notify(`❌ 更新失败: ${error.message}，请重试`, "error");
-        } else {
-          ctx.ui.notify("✅ aicode-cli 更新成功！请重启 CLI", "success");
+      try {
+        // ← 在 await 前保存 UI context
+        const uiContext = ctx.ui;
+        
+        const ok = await uiContext.confirm("更新确认", "确定要更新 aicode-cli 吗？");
+        if (!ok) {
+          uiContext.notify("已取消", "info");
+          return;
         }
-      });
+
+        uiContext.notify("🔄 正在更新 aicode-cli...", "info");
+        
+        // 使用 Promise 包装 exec
+        const { exec } = await import("child_process");
+        await new Promise<void>((resolve) => {
+          exec("npm install -g @ia-ccun/code-agent-cli", (error, stdout, stderr) => {
+            if (error) {
+              uiContext.notify(`❌ 更新失败：${error.message}，请重试`, "error");
+            } else {
+              uiContext.notify("✅ aicode-cli 更新成功！请重启 CLI", "success");
+            }
+            resolve();
+          });
+        });
+      } catch (e) {
+        // 忽略错误（ctx 可能已过期）
+      }
     },
   });
 
   // === 注册自定义工具 ===
 
-  // 注意: 注册自定义工具需要更复杂的参数定义
-  // 详情请参考: https://github.com/mariozechner/pi-coding-agent/docs/extensions.md
+  // 注意：注册自定义工具需要更复杂的参数定义
+  // 详情请参考：https://github.com/mariozechner/pi-coding-agent/docs/extensions.md
 
   // === 注册 /version 命令 ===
 
@@ -204,7 +234,7 @@ export default function (pi: ExtensionAPI) {
                           (latestParts[0] === localParts[0] && latestParts[1] === localParts[1] && latestParts[2] > localParts[2]);
 
         if (needsUpdate) {
-          updateMsg = `\n\n⚠️  发现新版本 v${localVersion} → v${latestVersion}\n   运行: npm install -g @ia-ccun/code-agent-cli`;
+          updateMsg = `\n\n⚠️  发现新版本 v${localVersion} → v${latestVersion}\n   运行：npm install -g @ia-ccun/code-agent-cli`;
         } else {
           updateMsg = "\n\n✅ 已是最新版本";
         }
@@ -215,8 +245,8 @@ export default function (pi: ExtensionAPI) {
       const info = `
 📦 版本信息
 
-   当前版本: v${localVersion}
-   最新版本: v${latestVersion}
+   当前版本：v${localVersion}
+   最新版本：v${latestVersion}
 ${updateMsg}
       `.trim();
 

package/config/agent/extensions/msg-debug.ts

@@ -3,7 +3,7 @@
  * Msg Debug Extension - Log LLM request/response messages to file
  * 
  * This extension logs all requests and responses sent to/from the LLM provider
- * for debugging purposes. Logs are saved to ./.aicode-cli/debug-logs/
+ * for debugging purposes. Logs are saved to ~/.aicode-cli/logs/
  * 
  * Features:
  * - Logs before_provider_request: messages, parameters, raw payload
@@ -13,8 +13,9 @@
  * - Session-based log files (one file per session)
  */
 
-import { appendFileSync, existsSync, mkdirSync } from "node:fs";
+import { appendFileSync, existsSync, mkdirSync, readdirSync, unlinkSync } from "node:fs";
 import { join } from "node:path";
+import os from "node:os";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
 // 北京时间格式化函数 (UTC+8)
@@ -31,16 +32,39 @@ function formatDateStr(date: Date = new Date()): string {
 	return `${year}-${month}-${day}`;
 }
 
-export default function (pi: ExtensionAPI) {
-	// Create log directory in project root: ./.aicode-cli/debug-logs
-	const logDir = join(process.cwd(), ".aicode-cli", "debug-logs");
-	if (!existsSync(logDir)) {
-		mkdirSync(logDir, { recursive: true });
+// 日志目录配置（与 error-monitor.ts 保持一致）
+const LOG_DIR = join(os.homedir(), ".aicode-cli", "logs");
+const KEEP_DAYS = 2; // 保留最近2天
+
+// 确保日志目录存在
+function ensureLogDir(): void {
+	if (!existsSync(LOG_DIR)) {
+		mkdirSync(LOG_DIR, { recursive: true });
 	}
-	
+}
+
+// 清理过期日志文件
+function cleanOldLogs(): void {
+	if (!existsSync(LOG_DIR)) return;
+	const now = new Date(new Date().toLocaleString("zh-CN", { timeZone: "Asia/Shanghai" }));
+	for (const file of readdirSync(LOG_DIR)) {
+		if (!file.startsWith("llm-requests-") || !file.endsWith(".log")) continue;
+		const match = file.match(/llm-requests-(\d{4})-(\d{2})-(\d{2})\.log/);
+		if (!match) continue;
+		const fileDate = new Date(parseInt(match[1]), parseInt(match[2]) - 1, parseInt(match[3]));
+		const diffDays = Math.floor((now.getTime() - fileDate.getTime()) / (1000 * 60 * 60 * 24));
+		if (diffDays > KEEP_DAYS) {
+			unlinkSync(join(LOG_DIR, file));
+		}
+	}
+}
+
+export default function (pi: ExtensionAPI) {
+	ensureLogDir();
+	cleanOldLogs();
 	// Format date as YYYY-MM-DD for daily log files
 	const dateStr = formatDateStr();
-	const logFile = join(logDir, `llm-requests-${dateStr}.log`);
+	const logFile = join(LOG_DIR, `llm-requests-${dateStr}.log`);
 
 	// Filter to only log user and assistant messages
 	const ALLOWED_ROLES = ["user", "assistant"];

package/config/agent/extensions/working-msg.ts

@@ -47,6 +47,7 @@ const workingMessages = [
 let intervalId: ReturnType<typeof setInterval> | null = null;
 let startTime = 0;
 let totalTokens = 0;
+let currentUI: any = null; // 保存当前有效的 UI context
 
 function getNextMessage(): string {
 	const randomIndex = Math.floor(Math.random() * workingMessages.length);
@@ -66,39 +67,58 @@ function formatTokens(tokens: number): string {
 }
 
 export default function workingMessageExtension(pi: ExtensionAPI) {
+	// 监听 session_shutdown 事件，清理 interval
+	pi.on("session_shutdown", async (_event, ctx) => {
+		if (intervalId) {
+			clearInterval(intervalId);
+			intervalId = null;
+		}
+		currentUI = null;
+	});
+
 	// turn_start 时开始循环切换消息
 	pi.on("turn_start", async (_event, ctx) => {
 		if (!ctx.ui) return;
 
+		// 保存当前有效的 UI context
+		currentUI = ctx.ui;
+
 		// 记录开始时间
 		startTime = Date.now();
 		totalTokens = 0;
 
-		// 立即设置第一条
-		const updateMessage = () => {
-			const elapsed = Math.floor((Date.now() - startTime) / 1000);
-			const timeStr = formatTime(elapsed);
-			const tokensStr = formatTokens(totalTokens);
-			// ✶ 和单词显示为主题色
-			const msg = `${accentColor} ✶ ${getNextMessage()}…${reset} (${timeStr} · ↓ ${tokensStr} tokens)`;
-			ctx.ui?.setWorkingMessage(msg);
-		};
-
-		updateMessage();
+		// 立即设置第一条消息
+		const elapsed = Math.floor((Date.now() - startTime) / 1000);
+		const timeStr = formatTime(elapsed);
+		const tokensStr = formatTokens(totalTokens);
+		const msg = `${accentColor} ✶ ${getNextMessage()}…${reset} (${timeStr} · ↓ ${tokensStr} tokens)`;
+		currentUI.setWorkingMessage(msg);
 
-		// 每3秒更新一次
+		// 每3秒更新一次 - 使用 try-catch 处理 stale context
 		if (!intervalId) {
 			intervalId = setInterval(() => {
-				// 获取当前 tokens 使用量
-				for (const entry of ctx.sessionManager.getBranch()) {
-					if (entry.type === "message" && (entry as any).message?.role === "assistant") {
-						const msg = (entry as any).message as AssistantMessage;
-						if (msg.usage?.output) {
-							totalTokens = msg.usage.output;
-						}
+				try {
+					// 使用保存的 currentUI 而不是捕获的 ctx.ui
+					if (!currentUI) return;
+
+					// 获取当前 tokens 使用量
+					// 注意：这里不再访问 ctx.sessionManager，避免 stale context 错误
+					// tokens 数量通过其他方式获取，或者保持为 0
+
+					const elapsed = Math.floor((Date.now() - startTime) / 1000);
+					const timeStr = formatTime(elapsed);
+					const tokensStr = formatTokens(totalTokens);
+					const msg = `${accentColor} ✶ ${getNextMessage()}…${reset} (${timeStr} · ↓ ${tokensStr} tokens)`;
+					currentUI.setWorkingMessage(msg);
+				} catch (error) {
+					// 如果出现错误（比如 stale context），清理 interval
+					console.error('working-msg extension error:', error);
+					if (intervalId) {
+						clearInterval(intervalId);
+						intervalId = null;
 					}
+					currentUI = null;
 				}
-				updateMessage();
 			}, 3000);
 		}
 	});
@@ -110,6 +130,7 @@ export default function workingMessageExtension(pi: ExtensionAPI) {
 			intervalId = null;
 		}
 		// 恢复默认消息
-		ctx.ui?.setWorkingMessage(undefined);
+		currentUI?.setWorkingMessage(undefined);
+		currentUI = null;
 	});
 }

package/config/agent/help.md

@@ -4,6 +4,29 @@
 
 ---
 
+## 📖 帮助命令
+
+查看 aicode-cli 的使用帮助：
+
+```bash
+/help
+```
+
+快速帮助：
+- `/help` - 查看本完整文档
+- `/models` - 查看模型列表
+- `/tools` - 查看可用工具
+- `/skill:<name>` - 激活指定技能
+- `Ctrl+Alt+P` - 切换计划模式
+- `/goal` - 设置持续目标
+
+---
+# aicode-cli 使用指南
+
+> 全面掌握 AI 编程助手的各项功能与配置
+
+---
+
 ## 目录
 
 1. [快速开始](#1-快速开始)
@@ -447,13 +470,6 @@ aicode-cli --verbose
 | `--theme <name>` | 指定主题 |
 | `--model <name>` | 指定模型 |
 | `--clear` | 启动时清理会话 |
-
-### 相关资源
-
-- **项目仓库**: https://github.com/ia-ccun/code-agent-cli
-- **npm 包**: https://www.npmjs.com/package/@ia-ccun/code-agent-cli
-- **pi-coding-agent**: 底层 Agent 框架
-
 ---
 
 *世界那么哒 · AI 实践落地 @2026*