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

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

@@ -6,15 +6,17 @@
  * 技巧列表包含快捷键、命令使用及联系方式提示
  */
 
-import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 
 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,24 +98,55 @@ 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 中调整消息发送模式和行为偏好",
   // 记忆功能使用技巧
   "💡 记忆功能自动记录会话中的关键经验，下次会话自动应用",
-  "💡 使用 /memory 查看当前记忆库中的条目",
   "💡 在对话中说'记住这个'可手动保存经验到记忆库",
   "💡 记忆功能支持选择性注入 (selective)，只注入相关记忆避免干扰",
-  "💡 说'忘记 XXX'可删除特定记忆条目",
+  "💡 说'忘记 XXX '可删除特定记忆条目",
   "💡 记忆会在会话结束时自动整合优化，提炼更有价值的经验",
   "💡 记忆功能示例：记住代码规范后，后续开发自动遵循该规范",
   "💡 记忆功能示例：记录常见错误模式，主动避免重复犯错",
   "💡 记忆功能示例：保存项目特定配置，新会话自动加载上下文",
+  // 安全和最佳实践提示
+  "⚠️ 目前模型算力有限，部分任务可能存在排队等待的情况，若出现卡顿请稍后重试",
+  "⚠️ 执行 shell 命令前会自动检测是否为 safe command，非安全命令需要确认",
+  "⚠️ Banner 启动时显示当前版本、模型配置和常用命令，方便快速查看环境",
+  "⚠️ 使用 !! 前缀执行 bash 命令不会将输出发送给 AI，适合敏感操作",
+  // CodeGraph 使用方法（推荐使用）
+  "🔗 创建本地索引目录并构建知识图谱，操作说明 参考  UniDoc《2026.5 aicode+codegraph 安装与使用》  ",
   // Subagent 使用方法
   "🤖 说'使用 subagent 探索当前代码关于权限校验的实现'可快速定位相关代码",
   "🤖 说'使用 subagent 为这个功能制定实施计划'可生成详细的开发步骤",
@@ -120,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/bash-check.ts

@@ -10,7 +10,7 @@
  * 危险模式配置: config/agent/dangerous-patterns.json
  */
 
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { readFileSync, existsSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";

package/config/agent/extensions/context-monitor.ts

@@ -14,7 +14,7 @@
  * - 100%  : 阻止继续并强制提示压缩
  */
 
-import type { ExtensionAPI, ExtensionContext, ToolResultEvent } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI, ExtensionContext, ToolResultEvent } from "@earendil-works/pi-coding-agent";
 
 interface ContextThresholds {
 	info: number;    // 70%

package/config/agent/extensions/context.ts

@@ -9,9 +9,9 @@
  * - current context window usage + session totals (tokens/cost)
  */
 
-import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext, ToolResultEvent } from "@mariozechner/pi-coding-agent";
-import { DynamicBorder } from "@mariozechner/pi-coding-agent";
-import { Container, Key, Text, matchesKey, type Component, type TUI } from "@mariozechner/pi-tui";
+import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext, ToolResultEvent } from "@earendil-works/pi-coding-agent";
+import { DynamicBorder } from "@earendil-works/pi-coding-agent";
+import { Container, Key, Text, matchesKey, type Component, type TUI } from "@earendil-works/pi-tui";
 import os from "node:os";
 import path from "node:path";
 import fs from "node:fs/promises";

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

@@ -6,9 +6,9 @@
  * [gold]  [dim]       [dim]       [color ctx]  [accent]
  */
 
-import type { AssistantMessage } from "@mariozechner/pi-ai";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import { truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+import type { AssistantMessage } from "@earendil-works/pi-ai";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
 function fmtTokens(n: number): string {
 	if (n < 1000) return n.toString();
@@ -26,6 +26,16 @@ function getVersion() {
 }
 
 export default function (pi: ExtensionAPI) {
+	// Plan 模式状态（由 EventBus 更新）
+	let planModeEnabled = false;
+	let footerTui: import("@earendil-works/pi-tui").TUI | null = null;
+
+	// 监听 plan 模式变化事件（全局监听，只注册一次）
+	pi.events.on("aicode-plan:mode-changed", (data: any) => {
+		planModeEnabled = data.enabled;
+		footerTui?.requestRender();
+	});
+
 	pi.on("session_start", async (_event, ctx) => {
 		// 检查版本更新并显示通知
 		const cachePath = process.env.AICODE_CLI_VERSION_CACHE;
@@ -47,6 +57,7 @@ export default function (pi: ExtensionAPI) {
 		}
 
 		ctx.ui.setFooter((tui, theme, footerData) => {
+			footerTui = tui;
 			const unsub = footerData.onBranchChange(() => tui.requestRender());
 
 			return {
@@ -149,7 +160,6 @@ export default function (pi: ExtensionAPI) {
 
 					// quots
 					const quotes = [
-                        "代码是有灵魂的",
                         "敬畏生产，双人复核，稳妥变更",
                         "让代码更有温度",
                         "民生所系，支付所向",
@@ -184,6 +194,14 @@ export default function (pi: ExtensionAPI) {
 					if (statsColored) segments.push(statsColored);
 					segments.push(ctxColored);
 					segments.push(modelColored);
+
+					// ── Plan mode segment ────────────────────────────────────
+					if (planModeEnabled) {
+						segments.push(theme.fg("success", "⏸ 计划模式"));
+					}else{
+				    	segments.push(theme.fg("error", "▶ 自动模式"));
+					}
+
 					segments.push(theme.fg("muted", quote));
 
 					// ── Version segment (rightmost) ─────────────────────────

package/config/agent/extensions/custom.ts

@@ -2,15 +2,14 @@
  * @author: xujianjiang
  * 自定义扩展示例
  *
- * 放置位置: config/agent/extensions/
+ * 放置位置：config/agent/extensions/
  * 安装后会复制到 ~/.pi/agent/extensions/
  *
  * 可以拦截内置工具、注册自定义工具和命令
  */
 
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import type { AssistantMessage } from "@mariozechner/pi-ai";
-import { truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { AssistantMessage } from "@earendil-works/pi-ai";
 
 export default function (pi: ExtensionAPI) {
   // === 记录开始时间 ===
@@ -23,40 +22,48 @@ export default function (pi: ExtensionAPI) {
   // === 消息完成通知（只在最后一条显示）===
 
   pi.on("agent_end", async (event, ctx) => {
-    // 计算耗时
-    const elapsed = Date.now() - agentStartTime;
-    let timeStr: string;
-    if (elapsed < 1000) {
-      timeStr = `${elapsed}ms`;
-    } else if (elapsed < 60000) {
-      timeStr = `${(elapsed / 1000).toFixed(1)}s`;
-    } else {
-      const mins = Math.floor(elapsed / 60000);
-      const secs = Math.floor((elapsed % 60000) / 1000);
-      timeStr = `${mins}m ${secs}s`;
-    }
+    try {
+      // 计算耗时
+      const elapsed = Date.now() - agentStartTime;
+      let timeStr: string;
+      if (elapsed < 1000) {
+        timeStr = `${elapsed}ms`;
+      } else if (elapsed < 60000) {
+        timeStr = `${(elapsed / 1000).toFixed(1)}s`;
+      } else {
+        const mins = Math.floor(elapsed / 60000);
+        const secs = Math.floor((elapsed % 60000) / 1000);
+        timeStr = `${mins}m ${secs}s`;
+      }
 
-    // 格式化完整时间
-    const now = new Date();
-    const timeStr2 = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')} ${String(now.getHours()).padStart(2, '0')}:${String(now.getMinutes()).padStart(2, '0')}:${String(now.getSeconds()).padStart(2, '0')}`;
+      // 格式化完整时间
+      const now = new Date();
+      const timeStr2 = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')} ${String(now.getHours()).padStart(2, '0')}:${String(now.getMinutes()).padStart(2, '0')}:${String(now.getSeconds()).padStart(2, '0')}`;
 
-    // agent_end 表示一轮对话结束，显示完成提示
-    ctx.ui.notify(`${timeStr2} | ✨ 消息处理完成 (${timeStr})`, "info");
+      // agent_end 表示一轮对话结束，显示完成提示
+      ctx.ui.notify(`${timeStr2} | ✨ 消息处理完成 (${timeStr})`, "info");
+    } catch (e) {
+      // 忽略错误（ctx 可能已过期）
+    }
   });
 
   // === 拦截工具调用 ===
 
   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 可能已过期）
     }
   });
 
@@ -66,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 可能已过期）
+      }
     },
   });
 
@@ -89,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");
     },
   });
 
@@ -127,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) {
+        // 忽略错误
+      }
     },
   });
 
@@ -138,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 命令 ===
 
@@ -200,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✅ 已是最新版本";
         }
@@ -211,8 +245,8 @@ export default function (pi: ExtensionAPI) {
       const info = `
 📦 版本信息
 
-   当前版本: v${localVersion}
-   最新版本: v${latestVersion}
+   当前版本：v${localVersion}
+   最新版本：v${latestVersion}
 ${updateMsg}
       `.trim();
 

package/config/agent/extensions/error-monitor.ts

@@ -6,7 +6,7 @@
  * Logs errors to ~/.aicode-cli/logs/aicode-error-YYYY-MM-DD.log
  */
 
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import fs from "fs";
 import os from "os";
 import path from "path";