codebuddy 提供三种代码理解方式：右键“ask codebuddy”即时解释选中代码块的逻辑与副作用；/explain 指令深度解析文件级控制流、变量作用域及调用频次；craft 模式结合运行时约束还原算法状态流转与循环不变式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你面对一个刚接手的遗留项目，几十个文件、嵌套调用关系复杂、没有文档，光看函数名根本猜不出业务意图时，CodeBuddy 能直接帮你穿透代码表层，还原真实逻辑脉络和数据流向，不用逐行手写注释或反复打断点调试。
在 VS Code 中用右键快速解释选中代码
这一步操作起来很简单，直接右键就能触发，适合单个函数或一段关键逻辑的即时理解。
1. 在编辑器中用鼠标拖选你要分析的代码块（可以是单个方法、一段 if-else 分支，甚至是一个 for 循环体）。
2. 右键 → 选择 “Ask CodeBuddy”（注意不是“Ask CodeBuddy in Craft Mode”，那是更重的上下文模式）。
3. 等待几秒，侧边栏自动弹出解释窗口，内容包含该段代码的输入来源、核心处理动作、输出结果形态，以及可能被忽略的副作用（比如是否修改了全局状态、是否触发了未捕获的异常）。
【必须选中有效代码才能触发，纯空行或注释行会导致无响应】
用 /explain 指令做文件级深度解析
当你需要整体把握一个模块的协作关系，比如搞清 controller → service → dao 的数据流转，或者想确认某个工具类所有方法的使用边界，就该用这个指令。
方法一：交互式面板中输入指令
1. 打开 CodeBuddy 侧边栏 → 切换到 Chat 标签 → 在输入框里敲 /explain。
2. 如果当前编辑器里没选中任何代码，系统会默认解析整个打开的文件；如果已选中，则只解释所选部分。
3. 【务必按 Backspace 删除自动生成的 @ 符号，否则模型会误读为引用某段历史对话，导致解释失焦】
4. 回车后，CodeBuddy 返回的不只是功能描述，还会画出简易控制流图、标出每个变量的作用域起止位置、指出哪些参数实际未被使用，并提示该文件在当前工程中的调用频次（基于 AST 跨文件扫描）。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
方法二：命令行终端中执行（适用于无图形界面环境）
进入项目根目录，运行：codebuddy -p "/explain src/main/java/com/example/OrderService.java"。这条命令会把解释结果直接打印到终端，不启动 GUI，适合 CI 流水线中做自动化代码认知检查。
通过 Craft 模式理解算法与状态流转
遇到排序、图遍历、动态规划这类带强状态依赖的代码时，普通解释容易漏掉执行时序细节。Craft 模式能结合你本地的类型定义和运行时约束，还原真实行为。
第一步：定位目标函数
把光标停在你要分析的函数名上（例如 partition 或 dfs），不要选中，也不要展开折叠区域。
第二步：激活 Craft 解释
右键 → 选择 “Ask CodeBuddy in Craft Mode”，或直接按快捷键 Ctrl + Windows + I（Windows）/⌘ + ⌃ + I（macOS）。
第三步：精准提问
在弹出框中输入具体指令，例如：“说明该递归函数的终止条件如何保证不栈溢出，每层调用传入的索引范围变化规律是什么，是否存在重复子问题未缓存”。模型会返回带编号步骤的执行快照，包括第 3 层调用时 left=5, right=12、第 4 层变为 left=5, right=8 这类真实参数轨迹。
第四步：验证不变式
解释结果末尾会明确写出该算法维持的循环不变式（loop invariant），比如“每次 partition 后，pivot 左侧元素均 ≤ pivot，右侧均 > pivot”，并标注代码中哪一行实际维护了该性质——这是纯静态分析无法给出的关键信息。
