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

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,44 @@ const AICODE_TIPS = [
   "/btw 并行侧边对话，可在不中断主流程的情况下进行临时讨论或查询 ",
   "/rewind 回退到任意工具执行前的状态，支持快照恢复和撤销重做 ",
   "/mcp 连接现有的 MCP 服务器 (如 xx 平台、企业微信等等)，扩展 AI 能力支持多种外部工具和服务 ",
+  // 新增扩展命令提示
+  "/cd 路径  切换会话工作目录，快速跳转不同项目",
+  "/grill-me  启动设计访谈，系统收集需求并生成决策文档",
+  "/ponytail  开启极简模式，强制 AI 用最少代码解决问题",
+  "💡 多步骤任务会自动显示待办进度条，实时跟踪完成情况",
+  "💡 需要理解陌生代码库时说'帮我解读这个项目'，自动构建知识图谱",
+  "💡 autoresearch：自动实验循环，持续优化参数直到收敛",
+  "🛡️ 安全围栏已默认启用，自动拦截危险操作（rm -rf、git reset --hard 等）",
+  // 新增扩展功能提示
+  "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 +143,18 @@ const AICODE_TIPS = [
   "💡 记忆功能自动记录会话中的关键经验，下次会话自动应用",
   "💡 在对话中说'记住这个'可手动保存经验到记忆库",
   "💡 记忆功能支持选择性注入 (selective)，只注入相关记忆避免干扰",
-  "💡 说'忘记 XXX'可删除特定记忆条目",
+  "💡 说'忘记 XXX '可删除特定记忆条目",
   "💡 记忆会在会话结束时自动整合优化，提炼更有价值的经验",
   "💡 记忆功能示例：记住代码规范后，后续开发自动遵循该规范",
   "💡 记忆功能示例：记录常见错误模式，主动避免重复犯错",
   "💡 记忆功能示例：保存项目特定配置，新会话自动加载上下文",
+  // 安全和最佳实践提示
+  "⚠️ 目前模型算力有限，部分任务可能存在排队等待的情况，若出现卡顿请稍后重试",
+  "⚠️ 执行 shell 命令前会自动检测是否为 safe command，非安全命令需要确认",
+  "⚠️ Banner 启动时显示当前版本、模型配置和常用命令，方便快速查看环境",
+  "⚠️ 使用 !! 前缀执行 bash 命令不会将输出发送给 AI，适合敏感操作",
+  // CodeGraph 使用方法（推荐使用）
+  "🔗 创建本地索引目录并构建知识图谱，操作说明 参考  UniDoc《2026.5 aicode+codegraph 安装与使用》  ",
   // Subagent 使用方法
   "🤖 说'使用 subagent 探索当前代码关于权限校验的实现'可快速定位相关代码",
   "🤖 说'使用 subagent 为这个功能制定实施计划'可生成详细的开发步骤",
@@ -119,6 +163,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",
 ];
@@ -127,7 +172,7 @@ export default function (pi: ExtensionAPI) {
   let currentTipIndex = -1;
   let autoHideTimeoutId: NodeJS.Timeout | undefined;
   let autoShowTimeoutId: NodeJS.Timeout | undefined;
-  let currentCtx: ExtensionContext | undefined;
+  let currentUI: any = undefined; // 保存当前有效的 UI context
   let isAutoPlaying = false;
 
   // 基于 #49bccf (73, 188, 207) 的随机颜色生成
@@ -141,8 +186,8 @@ export default function (pi: ExtensionAPI) {
   };
 
   const hideTip = () => {
-    if (!currentCtx?.hasUI) return;
-    currentCtx.ui.setWidget("aicode-tips", [], { placement: "aboveEditor" });
+    if (!currentUI) return;
+    currentUI.setWidget("aicode-tips", [], { placement: "aboveEditor" });
   };
 
   const clearAllTimers = () => {
@@ -165,7 +210,7 @@ export default function (pi: ExtensionAPI) {
   };
 
   const showRandomTip = (isInternalCall = false) => {
-    if (!currentCtx?.hasUI) return;
+    if (!currentUI) return;
 
     // 清除之前的定时器（但内部轮播调用时不清除，避免中断轮播）
     if (!isInternalCall) {
@@ -181,11 +226,20 @@ export default function (pi: ExtensionAPI) {
     // 使用随机颜色
     const color = getRandomTipColor();
     const coloredTip = `${color}tips: ${tip}\x1b[0m`;
-    currentCtx.ui.setWidget("aicode-tips", [coloredTip], { placement: "aboveEditor" });
+    currentUI.setWidget("aicode-tips", [coloredTip], { placement: "aboveEditor" });
 
     // 自动轮播：10 秒后直接显示下一条
     if (isAutoPlaying) {
-      autoHideTimeoutId = setTimeout(() => showRandomTip(true), 10000);
+      autoHideTimeoutId = setTimeout(() => {
+        try {
+          showRandomTip(true);
+        } catch (error) {
+          // 如果出现错误（比如 stale context），清理定时器
+          console.error('aicode-tips extension error:', error);
+          stopAutoPlay();
+          currentUI = undefined;
+        }
+      }, 10000);
     }
   };
 
@@ -201,22 +255,22 @@ export default function (pi: ExtensionAPI) {
 
   // 会话开始时启动自动轮播
   pi.on("session_start", (_event, ctx) => {
-    currentCtx = ctx;
+    currentUI = ctx.ui;
     startAutoPlay();
   });
 
   // 会话结束时清理
   pi.on("session_shutdown", () => {
     stopAutoPlay();
-    currentCtx?.ui.setWidget("aicode-tips", undefined);
-    currentCtx = undefined;
+    currentUI?.setWidget("aicode-tips", undefined);
+    currentUI = undefined;
   });
 
   // 手动切换技巧
   pi.registerCommand("tip", {
     description: "显示一个新的 aicode 使用技巧",
     handler: async (_args, ctx) => {
-      currentCtx = ctx;
+      currentUI = ctx.ui;
       showRandomTip();
     },
   });