@tencent-ai/codebuddy-code 2.80.0 → 2.81.1-next.84eab07.20260409

package/dist/web-ui/docs/search-index-zh.json

@@ -1 +1 @@
-[{"id":"/cli/overview","title":"概述","body":"概述 腾讯云智能编程助手 让代码开发更智能、更高效 CodeBuddy Code 是基于腾讯云 AI 技术的智能编程工具，深度集成腾讯云生态，提供从代码编写到项目部署的全链路 AI 辅助。 为什么选择 CodeBuddy Code？ 🚀 用自然语言驱动整个开发运维生命周期 CodeBuddy Code 让您能够用自然语言描述需求，自动化完成从代码编写、测试、调试到部署的全链路开发任务，实现极致的自动化效率提升。无论是简单的代码修改还是复杂的架构重构，都能通过对话式交互轻松完成。 🔧 终端原生，无缝集成 熟悉的环境：直接在您熟悉的命令行环境中获得 AI 辅助，无需切换开发工具或学习新界面 原生体验：完美融入现有的开发工作流，支持所有主流操作系统和终端 零学习成本：保持原有的开发习惯，AI 助手静默工作在后台 ⚡ 开箱即用的强大能力 内置工具链：集成文件编辑、命令运行、Git 操作、测试执行等核心开发工具 智能提交：自动生成规范的提交信息，支持代码审查和变更管理 灵活扩展：通过 MCP (模型上下文协议) 轻松集成第三方工具和服务 自定义开发工具：根据项目需求定制专属的开发助手 🛠️ Unix 哲学的 AI 集成 管道友好：像 和 一样，原生支持管道输入进行智能分析 脚本集成：完美融入 shell 脚本和自动化工具链 组合能力：与现有 Unix 工具无缝组合，构建强大的 AI 驱动工作流 标准输入输出：遵循 Unix 标准，支持重定向和管道操作 快速体验 环境要求 Node.js 18.0+ 一键安装 开始使用 下一步操作 📚 深入了解 详细的设置和使用指南 扩展思考、图片粘贴、 resume 等功能 在你喜欢的编辑器中使用 🔧 配置和扩展 模型上下文协议集成 内置命令参考 配置文件、环境变量、工具设置 🚀 高级用法 GitHub Actions CI/CD 集成 SDK 开发 扩展和自定义 企业部署 容器化部署 🆘 获取帮助 常见问题解决 完整命令行参考 交互模式 键盘快捷键和技巧 反馈和支持 📧 技术支持：codebuddy@tencent.com 🌐 🌐"},{"id":"/cli/quickstart","title":"快速入门指南","body":"快速入门指南 欢迎使用 CodeBuddy Code！这份指南将帮助您在 5 分钟内上手，体验自然语言驱动的编程助手。 🎯 开始之前 系统要求 Node.js：版本 18.20 或更高 操作系统: macOS、Linux 或 Windows 验证环境 ⚡ 极速安装 npm 全局安装 原生安装器（Beta） ⚠️ Beta 功能：原生安装器目前处于 Beta 阶段。我们推荐您尝试使用，以获得更快速、独立的安装体验。 原生安装器提供独立的 CodeBuddy 安装，无需 Node.js 环境。 下载并安装： 优势： ✅ 无需 Node.js 依赖 ✅ 安装和启动速度更快 验证安装 🔐 登录认证 首次使用 CodeBuddy Code 时，您需要完成登录认证。启动后会显示登录方式选择界面： 登录方式说明 登录方式 适用场景 说明 Chinese Site 国内用户 通过腾讯云国内站 (copilot.tencent.com) 进行认证，支持国内主流模型 International Site 海外用户 通过腾讯云国际站 (codebuddy.ai) 进行认证，支持海外主流模型 Enterprise Domain 专享版/私有化部署 连接企业专享版或自建的 CodeBuddy 服务，需要输入企业提供的服务地址 iOA 腾讯内部员工 通过腾讯 iOA 零信任系统进行认证，仅限腾讯内部员工使用 使用 键选择登录方式，按 确认后会自动打开浏览器完成认证。 🚀 首次体验 1. 进入项目目录 2. 启动交互模式 您将看到欢迎界面： 提示：如果您希望 CodeBuddy Code 始终使用特定语言回复（如简体中文），可以在启动后运行 命令设置 Language 选项。 3. 初始化项目上下文（强烈推荐） 在正式开始对话之前，强烈建议先使用 命令初始化项目上下文： 为什么 /init 如此重要？ 📊 效果提升： ✅ 理解更准确：预先构建项目知识图谱，AI 能更准确理解代码结构和业务逻辑 ✅ 响应更快速：避免重复扫描文件，后续对话响应速度显著提升 ✅ 建议更精准：基于全局视图提供更符合项目架构的建议 ✅ 减少误判：了解项目依赖关系，避免提出不兼容的修改方案 💰 成本优化： ✅ Token 消耗更少：一次性建立上下文，避免每次对话都重新分析 ✅ 减少重复请求：预加载关键信息，减少 30 50% 的上下文 Token 开销 ✅ 更高效的对话：每轮对话携带更少的冗余信息，整体成本更低 最佳实践： 4. 尝试第一个对话 CodeBuddy 会自动扫描您的项目文件，并提供详细的结构分析。 💡 核心使用模式 交互式对话模式 最自然的使用方式，适合探索性开发： 典型对话示例： 单次命令模式 适合脚本化和自动化场景： 重要提示：使用 参数进行单次执行时,如果操作需要访问文件、执行命令等授权操作,必须添加 （或 ) 参数。 项目级操作 处理复杂的跨文件任务： 快捷键 基础导航 快捷键 功能 浏览命令历史 查看后台任务（当有运行中任务时） 命令自动补全 清空输入（按两次） / 返回上级菜单 退出程序 退出程序（输入框为空且无进行中对话时，连按两次） 权限和模式 快捷键 功能 (macOS/Linux) 或 (Windows) 切换权限模式（default → bypass → accept → plan） 编辑功能 快捷键 功能 展开/收起详细输出（在对话中） 使用外部编辑器编辑提示词 发送消息 换行（多行输入） 换行（反斜杠转义） 插入换行（多行输入） 面板操作 快捷键 功能 在面板中导航选项 选择当前项 切换选择（多选面板） 终止选中的后台任务 专用功能 快捷键 功能 Vim风格的上下导航（部分面板支持） 查看思考详情面板 当终端显示“Thinking”指示时，可用 打开完整推理内容,再按 退出。 🎓 进阶学习 恭喜您完成快速入门！接下来推荐阅读： 学习扩展思考、图片分析等高级功能 在 VS Code、JetBrains 中使用 掌握所有内置命令 扩展自定义工具 💬 获取帮助 遇到问题？我们随时为您提供支持： 🐛 📧 技术支持：codebuddy@tencent.com 📚 🌐 现在开始，让 AI 成为您的编程伙伴！🚀"},{"id":"/cli/installation","title":"CodeBuddy Code 安装指南","body":"CodeBuddy Code 安装指南 安装方式 📦 使用包管理器安装 Node.js 包管理器 前置要求: Node.js 18.20 或更高版本 选择你喜欢的包管理器执行以下命令: ::: code group ::: Homebrew (macOS/Linux) 无需 Node.js，直接安装: ::: code group ::: 验证安装 安装完成后,运行以下命令验证是否安装成功: ⚙️ 使用原生二进制安装（Beta） ⚠️ Beta 测试阶段 原生二进制安装目前处于 Beta 测试阶段，功能仍在完善中。 如遇到任何问题，请在 提交问题报告，或联系技术支持（codebuddy@tencent.com）。 特性说明 原生二进制安装相比 npm 版本提供以下特性： 单一可执行文件，无需额外依赖 无需 Node.js 运行时 改进的自动更新机制 支持平台 macOS (Apple Silicon M1/M2/M3 或 Intel x8664) Linux (arm64 或 x8664) Windows (x8664) 从 npm 版本迁移 如果你已经通过 npm 安装了 CodeBuddy Code，可以使用以下命令迁移到原生二进制版本： 全新安装 ::: code group ::: 验证安装 安装脚本会自动下载最新版本并配置环境变量。安装完成后，运行以下命令验证： 如果命令不可用,请手动将安装路径添加到环境变量 : ::: code group ::: 📁 配置目录 CodeBuddy Code 默认将配置文件存储在以下目录: 平台 默认配置目录 macOS / Linux Windows 配置目录内容 自定义配置目录 通过设置环境变量 可以自定义配置目录位置: 这在以下场景中非常有用: 多个 CodeBuddy 实例需要独立配置 企业环境中需要统一管理配置位置 与其他使用 CodeBuddy 引擎的应用（如 WorkBuddy）共存时避免配置冲突 🔄 更新 自动更新 CodeBuddy Code 默认会自动保持最新状态，以确保你拥有最新的功能和安全修复。 关闭自动更新 如需关闭自动更新，可设置环境变量： 手动更新 使用以下命令手动更新到最新版本： 命令会自动检测你的安装方式并执行相应的更新操作。 使用包管理器更新 如果 命令未能成功更新，你也可以使用包管理器重新安装： 或使用其他包管理器（pnpm、yarn、bun）执行相应的安装命令。 🔧 故障排查 命令不可用 问题： 安装后提示 解决方案： 1. 检查安装路径是否在 环境变量中： 2. 将 CodeBuddy 安装路径添加到 （参考上方 如需完全清理,可删除配置目录: macOS / Linux: 💡 提示: 如果你使用了 环境变量自定义了配置目录，请删除对应的目录。"},{"id":"/cli/common-workflows","title":"常见工作流","body":"常见工作流 学习 CodeBuddy Code 的常见工作流程。 本文档中的每个任务都包含清晰的说明、示例命令和最佳实践，帮助您充分利用 CodeBuddy Code。 理解新代码库 快速了解代码库概况 假设您刚加入一个新项目，需要快速了解其结构。 步骤： 1. 导航到项目根目录 2. 启动 CodeBuddy Code 3. 询问高层次概览 4. 深入了解特定组件 最佳实践： 从宏观问题开始，然后缩小到特定领域 询问项目中使用的编码规范和模式 请求项目特定术语的词汇表 查找相关代码 假设您需要定位与特定功能相关的代码。 步骤： 1. 请 CodeBuddy 查找相关文件 2. 了解组件如何交互 3. 理解执行流程 最佳实践： 对要查找的内容要具体 使用项目中的领域语言 重构代码 假设您需要更新旧代码以使用现代模式和实践。 步骤： 1. 识别需要重构的遗留代码 2. 获取重构建议 3. 安全地应用更改 4. 验证重构 最佳实践： 请 CodeBuddy 解释现代方法的好处 需要时请求更改保持向后兼容性 以小的、可测试的增量进行重构 使用计划模式进行安全的代码分析 计划模式指示 CodeBuddy 通过只读操作分析代码库来创建计划，非常适合探索代码库、规划复杂更改或安全地审查代码。 何时使用计划模式 多步骤实现：当您的功能需要编辑许多文件时 代码探索：当您想在更改任何内容之前彻底研究代码库时 交互式开发：当您想与 CodeBuddy 就方向进行迭代时 如何使用计划模式 在会话期间开启计划模式 您可以在会话期间使用快捷键切换权限模式来切换到计划模式： macOS/Linux：按 Shift+Tab Windows：按 Alt+M 如果您处于普通模式，按快捷键将首先切换到自动接受模式，终端底部会显示 。再次按快捷键将切换到计划模式,显示 。 以计划模式启动新会话 要以计划模式启动新会话，使用 参数： 在计划模式下运行\"无头\"查询 您也可以使用 直接在计划模式下运行查询（即在 中）: 示例： 规划复杂重构 CodeBuddy 将分析当前实现并创建全面的计划。使用后续问题进行完善： 将计划模式配置为默认 查看 了解更多配置选项。 处理测试 假设您需要为未覆盖的代码添加测试。 步骤： 1. 识别未测试的代码 2. 生成测试脚手架 3. 添加有意义的测试用例 4. 运行并验证测试 最佳实践： 要求涵盖边缘情况和错误条件的测试 适当时请求单元测试和集成测试 让 CodeBuddy 解释测试策略 创建合并请求 假设您需要为更改创建一个文档完善的合并请求。 步骤： 1. 总结您的更改 2. 使用 CodeBuddy 生成 MR 3. 审查并完善 4. 添加测试详情 最佳实践： 直接让 CodeBuddy 为您创建 MR 提交前审查 CodeBuddy 生成的 MR 让 CodeBuddy 强调潜在的风险或考虑因素 处理文档 假设您需要为代码添加或更新文档。 步骤： 1. 识别未文档化的代码 2. 生成文档 3. 审查并增强 4. 验证文档 最佳实践： 指定您想要的文档风格(JSDoc、docstrings 等） 在文档中要求示例 为公共 API、接口和复杂逻辑请求文档 处理图片 假设您需要处理代码库中的图片，并希望 CodeBuddy 帮助分析图片内容。 步骤： 1. 将图片添加到对话中 您可以使用以下任一方法： 1. 将图片拖放到 CodeBuddy Code 窗口中 2. 复制图片并用 ctrl+v 粘贴到 CLI 中（不要使用 cmd+v) 3. 向 CodeBuddy 提供图片路径。例如：\"分析这张图片： /path/to/your/image.png\" 2. 让 CodeBuddy 分析图片 3. 使用图片提供上下文 4. 从视觉内容获取代码建议 最佳实践： 当文本描述不清楚或繁琐时使用图片 包含错误、UI 设计或图表的截图以获得更好的上下文 您可以在对话中处理多张图片 图片分析适用于图表、截图、原型设计等 引用文件和目录 使用 @ 快速包含文件或目录，无需等待 CodeBuddy 读取它们。 步骤： 1. 引用单个文件 这会在对话中包含文件的完整内容。 2. 引用目录 这会提供带有文件信息的目录列表。 3. 引用 MCP 资源（暂不支持） 这会使用 @server:resource 格式从连接的 MCP 服务器获取数据。详见 。 最佳实践： 文件路径可以是相对路径或绝对路径 @ 文件引用会将文件目录及父目录中的 CODEBUDDY.md 添加到上下文 目录引用显示文件列表，而不是内容 您可以在单条消息中引用多个文件（例如，\"@file1.js 和 @file2.js\") 使用扩展思考 假设您正在处理复杂的架构决策、具有挑战性的 bug"},{"id":"/cli/interactive-mode","title":"交互模式","body":"交互模式 CodeBuddy Code 交互式会话中的完整键盘快捷键、输入模式和交互功能参考。 键盘快捷键 <Note 键盘快捷键可能因平台和终端而异。在交互式会话中输入问号 可查看您环境中可用的快捷键。 </Note 通用控制 快捷键 描述 上下文 CodeBuddy 支持 : : : : 取消当前输入或生成 标准中断 ✅ 支持 退出 CodeBuddy Code 会话（输入框为空且无进行中对话时） EOF 信号，连按两次退出 ✅ 支持 清除终端屏幕 保留对话历史 ✅ 支持 切换详细输出 显示详细的工具使用和执行信息 ✅ 支持 反向搜索命令历史 交互式搜索之前的命令 ✅ 支持 (macOS/Linux) 或 (Windows) 从剪贴板粘贴图片 粘贴图片或图片文件路径 ✅ 支持 导航命令历史 调用之前的输入 ✅ 支持 + 回退代码/对话 将代码和/或对话恢复到之前的状态 (需在输入框为空时连续按两次) ✅ 支持 切换思考模式 在思考开启和思考关闭之间切换 ✅ 支持 (macOS/Linux) 或 (Windows) 切换权限模式 在自动接受模式、计划模式和普通模式之间切换 ✅ 支持 (macOS) 或 (Windows/Linux) 切换模型 快速打开模型选择面板 ✅ 支持 说明： + 回退功能已支持：当输入框内容为空时，连续按两次 ESC 键可激活 功能，快速回退代码或对话到之前的状态 键在 CodeBuddy Code 中主要用于自动补全，扩展思考模式的切换功能部分支持 (macOS/Linux) 或 (Windows) 用于切换权限模式，包括普通模式、自动接受编辑模式、跳过权限模式和计划模式。注意：在 Windows 上必须使用 ， 不起作用 多行输入 方法 快捷键 上下文 CodeBuddy 支持 : : : : 快速转义 + 在所有终端中工作 ✅ 支持 macOS 默认 macOS 上的默认设置 ✅ 支持 终端设置 执行 后 ✅ 支持 控制序列 多行的换行字符 ✅ 支持 粘贴模式 直接粘贴 用于代码块、日志 ✅ 支持 <Tip 在终端设置中配置您首选的换行行为。运行 为 iTerm2 和 VS Code 终端安装 Shift+Enter 绑定。 </Tip 快速命令 快捷键 描述 注释 CodeBuddy 支持 : : : : 在开头 记忆快捷方式 添加到 CODEBUDDY.md 提示选择文件 ✅ 支持 在开头 斜杠命令 参见 ✅ 支持 在开头 Bash 模式 直接运行命令并将执行输出添加到会话 ✅ 支持 文件路径提及 触发文件路径自动补全 ✅ 支持 编辑快捷键 快捷键 描述 CodeBuddy 支持 : : : 移动到行首 ✅ 支持 移动到行尾 ✅ 支持 删除从光标到行尾 ✅ 支持 删除从行首到光标 ✅ 支持 删除前一个单词 ✅ 支持 复制最后一条 AI 回复到剪贴板 ✅ 支持 删除前一个单词 ✅ 支持 删除下一个单词 ✅ 支持 移动到上一个单词 ✅ 支持 移动到下一个单词 ✅ 支持 移动到行首 ✅ 支持 移动到行尾 ✅ 支持 打开外部编辑器编辑提示词 ✅ 支持 Vim 编辑器模式 使用 命令启用 vim 风格编辑,或通过 永久配置。 模式切换 命令 操作 从模式 CodeBuddy 支持 : : : : 进入 NORMAL 模式 INSERT ✅ 支持 在光标前插入 NORMAL ✅ 支持 在行首插入 NORMAL ✅ 支持 在光标后插入 NORMAL ✅ 支持 在行尾插入 NORMAL ✅ 支持 在下方打开新行 NORMAL ✅ 支持 在上方打开新行 NORMAL ✅ 支持 导航 （NORMAL 模式） 命令 操作 CodeBuddy 支持 : : : / / / 向左/下/上/右移动 ✅ 支持 下一个单词 ✅ 支持 单词末尾 ✅ 支持 上一个单词 ✅ 支持 行首 ✅ 支持 行尾 ✅ 支持 第一个非空白字符 ✅ 支持 输入开始 ✅ 支持 输入结束 ✅ 支持 编辑 （NORMAL 模式） 命令 操作 CodeBuddy 支持 : : : 删除字符 ✅ 支持 删除行 ✅ 支持 删除到行尾 ✅ 支持 / / 删除单词/到末尾/到开头 ✅ 支持 修改行 ✅ 支持 修改到行尾 ✅ 支持 / / 修改单词/到末尾/到开头 ✅ 支持 重复上次修改 ✅ 支持 命令历史 CodeBuddy Code 为当前会话维护命令历史： 历史记录按工作目录存储 使用 开启全新对话（旧对话可通过 恢复） 使用 Up/Down 方向键导航 （参见上面的键盘快捷键） 注意：历史扩展 （ ) 默认禁用 使用 Ctrl+R 反向搜索 按 交互式搜索您的命令历史： 1. 开始搜索：按 激活反向历史搜索 2. 输入查询：输入文本以在之前的命令中搜索 "},{"id":"/cli/headless","title":"无头模式 （Headless Mode)","body":"无头模式 （Headless Mode) 以编程方式运行 CodeBuddy Code,无需交互式 UI 概述 无头模式允许您通过命令行脚本和自动化工具以编程方式运行 CodeBuddy Code,无需任何交互式 UI。 无头模式也支持定时任务相关能力。在脚本、SDK 或服务端集成场景中，可以使用 、 、 等工具来创建、查看和取消定时任务。 ⚠️ 重要提示： （或 ) 是非交互模式的必需参数。在使用 参数进行非交互式执行时，必须添加此参数才能执行需要授权的操作（文件读写、命令执行、网络请求等）,否则这些操作会被阻止。仅在受信任的环境和明确的任务场景下使用此参数。详见 。 基本用法 CodeBuddy Code 的主要命令行接口是 （或 ) 命令。使用 （或 ) 标志在非交互模式下运行并打印最终结果： 配置选项 无头模式利用 CodeBuddy Code 中所有可用的 CLI 选项。以下是用于自动化和脚本编写的关键选项： 标志 描述 示例 : : : , 在非交互模式下运行 指定输出格式 （ , , ) , 通过会话 ID 恢复对话 , 继续最近的对话 启用详细日志记录 追加到系统提示词 （仅与 配合使用） 允许的工具列表,空格分隔或<br / <br / 逗号分隔的字符串 <br / <br / 拒绝的工具列表,空格分隔或<br / <br / 逗号分隔的字符串 <br / <br / 从 JSON 文件或 JSON 字符串加载额外的设置配置 指定要加载的设置源（可选值: , , ） 从 JSON 文件加载 MCP 服务器 用于处理权限提示的 MCP 工具 （仅与 配合使用） ❌ 不支持 说明： 功能当前不支持。 有关 CLI 选项和功能的完整列表，请参阅 文档。 多轮对话 对于多轮对话，您可以恢复对话或从最近的会话继续： 输出格式 文本输出 （默认） JSON 输出 返回包含元数据的结构化数据： 响应格式： 流式 JSON 输出 在收到每条消息时流式传输： 每个对话都以初始 系统消息开始,然后是用户和助手消息列表,最后是包含统计信息的最终 系统消息。每条消息都作为单独的 JSON 对象发出。 结构化 JSON 输出 要获得符合特定架构的输出，请使用 和 以及 定义。响应包括关于请求的元数据（会话 ID、使用情况等），结构化输出在 字段中。 此示例从 auth.py 中提取函数名称并将其作为字符串数组返回： 提示：使用 之类的工具来解析响应并提取特定字段： 输入格式 文本输入 （默认） 流式 JSON 输入 通过 提供的消息流,其中每条消息代表一个用户轮次。这允许在不重新启动 二进制文件的情况下进行多轮对话，并允许在模型处理请求时向模型提供指导。 每条消息都是一个 JSON \"用户消息\" 对象,遵循与输出消息模式相同的格式。消息使用 格式进行格式化,其中每行输入都是一个完整的 JSON 对象。流式 JSON 输入需要 和 。 Agent 集成示例 SRE 事件响应机器人 自动化安全审查 多轮法律助手 最佳实践 使用 JSON 输出格式 进行程序化解析响应： 优雅地处理错误 检查退出代码和 stderr: 使用会话管理 在多轮对话中维护上下文 考虑超时 对于长时间运行的操作： 遵守速率限制 在进行多个请求时，通过在调用之间添加延迟 使用 在非交互模式下执行需要授权的操作： ⚠️ 重要提示： （或 ) 是非交互模式的必需参数。在使用 参数进行非交互式执行时，必须添加此参数才能执行需要授权的操作（文件读写、命令执行、网络请求等）,否则这些操作会被阻止。仅在受信任的环境和明确的任务场景下使用此参数。详见 。 相关资源 完整的 CLI 文档 常见用例的分步指南 交互式会话功能 工具权限和访问控制 提示：无头模式非常适合 CI/CD 管道、自动化脚本和 agent 集成。将其与 MCP 服务器结合使用以扩展功能。"},{"id":"/cli/troubleshooting","title":"故障排查与最佳实践","body":"故障排查与最佳实践 本文档涵盖常见问题解决方案和使用优化建议。 常见问题 额度共享 CLI、CodeBuddy IDE 和 CodeBuddy Plugin 共享同一账号的资源配额。 JetBrains IDE 中 ESC 键不生效 JetBrains 终端对 ESC 键处理不同，改用 或 。 操作 标准终端 JetBrains 终端 退出/取消 或 模型切换 serve 模式网络访问问题 局域网 IP 访问报 症状：使用 启动后，通过局域网 IP（如 ）访问时，浏览器报 （未发送任何数据）。 原因：HTTP 服务默认监听 （本地回环地址），只接受本机连接。使用局域网 IP 访问时，请求到达了机器但被服务拒绝。 解决方案：启动时添加 参数，使服务监听所有网络接口： 非回环地址启动时会自动启用密码认证，密码在控制台输出中可见。 确认服务监听状态 可以通过以下命令检查服务是否正确监听： 若显示 — 只接受本机连接 若显示 或 — 接受所有网络连接 从 Claude Code 迁移 迁移内容 目录/文件 说明 自定义 agents 配置 斜杠命令定义 专业技能定义 → AI 指令和记忆文档 方案一：符号链接（推荐） 共享配置，修改一处两边生效。 方案二：复制文件 独立配置，互不影响。 插件 Skills 一键安装 Claude Code 插件中的 Skills 支持一键安装，安装后自动加载。 验证迁移 成本优化 核心原则 新任务用 开启新会话 长对话用 压缩历史 用 引用文件，避免粘贴代码 会话管理命令 命令 功能 查看 Token 消耗 开启新会话 压缩历史 恢复旧对话 成本对比 方式 输入 Token 相对成本 单会话连续 10 个任务 50,000 高 每个任务新会话 15,000 低 定期 25,000 中 推荐做法 ✓ 新任务开新会话 ✓ 每 20 30 轮用 ✓ 用 引用文件 ✓ 精简提问 避免做法 ✗ 同一会话处理多个无关任务 ✗ 对话超过 30 轮不清理 ✗ 重复粘贴已知代码 更多帮助："},{"id":"/cli/best-practices","title":"CodeBuddy Code 最佳实践","body":"CodeBuddy Code 最佳实践 从环境配置到并行扩展，掌握让 CodeBuddy Code 发挥最大效能的技巧与模式。 CodeBuddy Code 是一个智能编程环境。与传统的问答式助手不同，CodeBuddy Code 能够读取文件、执行命令、修改代码，无论您是在旁观察、适时引导，还是离开去做其他事，它都能自主解决问题。 这将改变您的工作方式——您不再需要自己编写代码然后请求审查，而是描述目标，让 CodeBuddy Code 去探索、规划并实现。 本指南汇集了在各类代码库、语言和环境中经过验证的实践模式。 给 CodeBuddy Code 验证自己工作的方法 核心建议：提供测试用例、截图或预期输出，让 CodeBuddy Code 能够自我检验。这是提升效果最立竿见影的方法。 当 CodeBuddy Code 能够验证自己的工作时，表现会显著提升——无论是运行测试、对比截图，还是校验输出结果。 如果没有明确的成功标准，它可能产出看似正确但实际无效的代码。这时您就成了唯一能发现问题的人，每个错误都需要您亲自排查。 策略 改进前 改进后 提供验证标准 \"写一个检查手机号格式的函数\" \"写一个 validatePhone 函数。测试用例：13812345678 返回 true，12345 返回 false，138 1234 5678 返回 false。实现后运行测试\" 视觉验证 UI 变更 \"优化一下这个表格的样式\" \"[粘贴截图] 按这个设计稿实现。完成后截图对比原图，列出差异并修复\" 解决根本原因 \"编译报错了\" \"编译失败，错误信息：[粘贴错误]。找出根本原因并修复，不要只是绕过错误。修复后确认编译通过\" 验证手段可以是测试套件、linter，或者一个检查输出的 Bash 命令。花点时间让验证足够可靠，值得。 在提示中提供具体上下文 核心建议：指令越精确，后续纠正就越少。 CodeBuddy Code 能推断意图，但不会读心。引用具体文件，说明约束条件，指向示例代码。 策略 改进前 改进后 限定任务范围 \"给 userservice.py 加测试\" \"给 userservice.py 写测试，重点覆盖用户注销的边缘情况，不要用 mock\" 指向来源 \"为什么 OrderProcessor 的接口设计这么奇怪？\" \"查一下 OrderProcessor 的 git 历史，总结这个接口是怎么演变成现在这样的\" 引用现有模式 \"加一个搜索组件\" \"看看 src/components 里现有组件是怎么写的，特别是 ProductCard.vue 这个例子。按同样的模式实现一个搜索组件，支持关键词高亮和历史记录。只用项目里已有的依赖\" 描述症状 \"登录有 bug\" \"用户反馈 token 过期后重新登录会失败。查一下 src/auth/ 的认证流程，重点看 token 刷新逻辑。先写个能复现问题的测试，再修复\" 模糊提示在探索阶段也有用，允许反复尝试。像 这样的提示，往往能发现一些你没想到的问题。 提供丰富内容 核心建议：用 引用文件，粘贴截图，或通过管道输入数据。 您可以通过多种方式向 CodeBuddy Code 提供丰富的上下文： 用 引用文件：CodeBuddy Code 在回复前会先读取文件，不用您描述代码在哪 直接粘贴图片：复制/粘贴或拖放图片到输入框 提供 URL：文档和 API 参考的链接。用 可以允许常用域名 管道输入数据：运行 直接把文件内容喂给它 让 CodeBuddy Code 自己取：告诉它用 Bash 命令、MCP 工具或读文件来获取所需上下文 配置您的环境 一些简单的配置步骤，就能让 CodeBuddy Code 在所有会话中更加高效。 设置首选语言 如果您希望 CodeBuddy Code 始终使用特定语言回复（如简体中文），可以通过 命令设置 Language 选项： 或者直接在 中配置： 设置后，CodeBuddy Code 会使用指定语言进行所有回复和解释，技术术语和代码标识符保持原样。留空则自动根据您的输入语言判断。 编写有效的 CODEBUDDY.md 核心建议：运行 基于当前项目结构生成初始 CODEBUDDY.md，然后逐步完善。 CODEBUDDY.md 是 CodeBuddy Code 每次对话开始时都会读取的特殊文件，里面包含常用命令、代码风格和工作流规则。它为 CodeBuddy Code 提供了无法从代码本身推断出的持久上下文。 命令会分析您的代码库，检测构建系统、测试框架和代码模式，为您生成一个可以继续完善的基础版本。 CODEBUDDY.md 没有固定格式，保持简短、易读就好。例如： CODEBUDDY.md 每次会话都会加载，所以只放那些普遍适用的内容。对于只在"},{"id":"/cli/settings","title":"设置配置","body":"设置配置 CodeBuddy Code 使用分层配置系统，让您能够在不同级别进行个性化定制，从个人偏好到团队标准，再到项目特定需求。 配置文件 文件是配置 CodeBuddy Code 的官方机制，支持分层设置： 用户设置 定义在 ，应用于所有项目 项目设置 保存在项目目录中： 用于检入源代码控制并与团队共享的设置 用于不检入的设置，适合个人偏好和实验。CodeBuddy Code 会自动配置 git 忽略此文件 完整配置示例 可用设置 支持以下选项： 配置键 描述 示例 : : : 首选响应语言，设置后 CodeBuddy Code 将使用指定语言进行回复。留空则自动根据用户输入判断语言 自定义脚本，在 中执行，生成认证值。此值将作为模型请求的 和 头发送 文生图功能使用的模型 ID 图生图功能使用的模型 ID 根据最后活动日期本地保留聊天记录的时长(默认:30 天) 应用于每个会话的环境变量 是否在 git 提交和拉取请求中包含 署名(默认: ） 权限配置，见下表 配置在工具执行前后运行的自定义命令。见 禁用所有 覆盖 CodeBuddy Code 使用的默认模型 配置自定义状态行以显示上下文。见 启用 Prompt 建议功能，在 Agent 完成对话后自动预测下一步操作（默认： ） Reasoning effort 级别配置，控制模型推理的深度。可选值： 、 、 、 。留空时使用产品配置默认值。可通过 面板切换，选择 等效于清除此设置 [Experimental] 记忆功能配置，见 权限设置 配置键 描述 示例 : : : 数组,允许工具使用。注意: Bash 规则使用前缀匹配,不是正则表达式 数组,在工具使用时询问确认 数组,拒绝工具使用。用于排除 CodeBuddy Code 访问敏感文件。注意: Bash 模式是前缀匹配,可以被绕过(参见 ) CodeBuddy 可以访问的额外 打开 CodeBuddy Code 时的默认 设置为 以防止激活 模式。这会禁用 和 命令行标志 记忆功能配置（Experimental） 记忆功能允许 CodeBuddy Code 在会话之间保持持久化记忆，自动管理项目上下文和学习历史。 配置键 描述 示例 : : : 是否启用记忆功能（默认： ） 是否启用 Auto Memory 功能（默认： ）。Auto Memory 允许 CodeBuddy 自动管理跨会话的持久化记忆，存储在 目录 [Experimental] 是否启用 Typed Memory 模式（默认： ）。启用后使用 4 种记忆类型（user/feedback/project/reference）+ YAML frontmatter 格式管理记忆 是否启用团队记忆模式（默认： ）。启用后，项目记忆存储在项目目录下，便于团队共享 团队用户 ID，用于隔离不同用户的记忆。默认自动获取（git user.name 系统用户名） 配置示例： 记忆存储位置： 个人模式（默认）： 团队模式： 全局记忆： 也可以通过 命令在设置面板中启用此功能。 Bash沙箱设置 配置高级沙箱行为。沙箱将 bash 命令与您的文件系统和网络隔离。详见 。 文件系统和网络限制通过 Read、Edit 和 WebFetch 权限规则配置，而非通过这些沙箱设置。 配置键 描述 示例 : : : 启用 bash 沙箱(仅限 macOS/Linux)。默认:false 在沙箱环境中自动批准 bash 命令。默认:true 应在沙箱外运行的命令 允许通过 参数在沙箱外运行命令。设置为 时，完全禁用 沙箱中可访问的 Unix 套接字路径（用于 SSH 代理等） 允许绑定到 localhost 端口(仅限 macOS)。默认: false 如果您希望使用自己的代理,使用的 HTTP 代理端口。如果未指定,CodeBuddy 将运行自己的代理 如果您希望使用自己的代理,使用的 SOCKS5 代理端口。如果未指定,CodeBuddy 将运行自己的代理 为无特权的 Docker 环境启用较弱的沙箱(仅限 Linux)。降低安全性。 默认:false 配置示例： 文件系统访问通过 Read/Edit 权限控制： Read deny 规则阻止沙箱中的文件读取 Edit allow 规则允许文件写入（除默认值外，如当前工作目录） Edit deny 规则阻止允许路径内的写入 注意：沙箱默认将 CodeBuddy 配置文件（ 、 ）加入写保护列表，防止沙箱内的命令或工具篡改配置。详见 。 网络访问通过 WebFetch 权限控制： WebFetch allow 规则允许网络域 WebFetch deny 规则阻止网络域 设置优先级 设置按优先级顺序应用（从高到低）: 1. 命令行"},{"id":"/cli/models","title":"models.json 配置指南","body":"models.json 配置指南 概述 是一个配置文件，用于自定义模型列表和控制模型下拉列表的显示。该配置支持两个级别： 用户级: 全局配置，适用于所有项目 项目级: 项目特定配置，优先级高于用户级 配置文件位置 用户级配置 项目级配置 配置优先级 配置合并优先级从高到低： 1. 项目级 models.json 2. 用户级 models.json 3. 内置默认配置 项目级配置会覆盖用户级配置中的相同模型定义（基于 字段匹配）。 字段：项目级完全覆盖用户级，不进行合并。 配置结构 配置字段说明 models 类型： 定义自定义模型列表。可以添加新模型或覆盖内置模型配置。 LanguageModel 字段 字段 类型 必填 说明 string ✓ 模型唯一标识符 string 模型显示名称 string 模型供应商 （如 OpenAI, Google) string API 密钥，支持环境变量引用（见下方安全配置说明） number 最大输入 token 数 number 最大输出 token 数 string API 端点 URL，支持环境变量引用 (必须是接口完整路径,一般以 结尾） number 采样温度，范围 0 2，值越高输出越随机，值越低输出越确定 boolean 是否支持工具调用 boolean 是否支持图片输入 boolean 是否支持推理模式 重要说明： 目前仅支持 OpenAI 接口格式的 API 字段必须是接口完整路径,一般以 结尾 例如: 或 安全配置：使用环境变量引用 为避免 API 密钥明文存储在配置文件中， 和 字段支持环境变量引用语法 。 语法格式： 配置示例： 设置环境变量： 使用系统 Keychain（macOS）： 注意事项： 环境变量在 CLI 启动时解析 如果环境变量不存在，将保留原始占位符（会导致 API 调用失败） 建议将 文件权限设置为 （仅所有者可读写） 不要将包含实际密钥的配置文件提交到版本控制系统 availableModels 类型： 控制模型下拉列表中显示哪些模型。只有在此数组中列出的模型 ID 才会在 UI 中显示。 如果未配置或为空数组，则显示所有模型 配置后，只显示列出的模型 ID 可以同时包含内置模型和自定义模型的 ID 使用场景 1. 添加自定义模型 在用户级或项目级添加新的模型配置： 2. 覆盖内置模型配置 修改内置模型的默认参数： 3. 限制可用模型列表 只在下拉列表中显示特定模型： 4. 项目特定配置 为特定项目使用不同的模型或 API 端点： 项目 A ( ): 热重载 配置文件支持热重载： 文件变更会被自动检测 使用 1 秒防抖延迟避免频繁重载 配置更新后会自动同步到应用 监听的文件： （用户级） （项目级） 标签系统 通过 添加的模型会自动标记 标签，便于在 UI 中识别和过滤。 合并策略 配置使用 策略： 相同 ID 的模型配置会被覆盖 不同 ID 的模型会被追加 项目级配置优先于用户级配置 过滤在所有合并完成后执行 示例配置 API 端点 URL 格式说明 必须使用完整路径： 所有自定义模型的 字段一般以 结尾。 ✅ 正确示例： ❌ 错误示例： OpenRouter 平台配置示例 使用 OpenRouter 访问多种模型： DeepSeek 平台配置示例 使用 DeepSeek 模型： 完整示例 故障排查 配置未生效 1. 检查 JSON 格式是否正确 2. 确认文件路径是否正确 3. 查看日志输出确认配置是否被加载 4. 确认环境变量中的 API 密钥是否已设置 模型未在列表中显示 1. 检查模型 ID 是否在 中列出 2. 确认 配置是否正确 3. 验证必填字段 （ , , ) 是否都已提供 热重载未触发 配置文件变更有 1 秒防抖延迟 确保文件确实被保存到磁盘 检查文件监听是否正常启动 （查看调试日志）"},{"id":"/cli/memory","title":"管理 CodeBuddy 的记忆","body":"管理 CodeBuddy 的记忆 了解如何通过不同的记忆位置和最佳实践来管理 CodeBuddy Code 跨会话的记忆。 CodeBuddy Code 可以跨会话记住您的偏好，例如代码风格指南和工作流程中的常用命令。 确定记忆类型 CodeBuddy Code 提供四种分层结构的记忆位置，每种都有不同的用途： 记忆类型 位置 用途 使用场景示例 共享范围 用户记忆 适用于所有项目的个人偏好 代码风格偏好、个人工具快捷方式 仅限本人（所有项目） 用户规则 模块化的个人规则 个人编码习惯、常用工作流 仅限本人（所有项目） 项目记忆 或 项目的团队共享指令 项目架构、编码标准、常用工作流程 通过源代码管理与团队成员共享 项目规则 模块化的、按主题划分的项目指令 语言特定指南、测试规范、API 标准 通过源代码管理与团队成员共享 项目记忆（本地） 个人的项目特定偏好 您的沙箱 URL、首选测试数据 仅限本人（当前项目） 所有记忆文件在启动 CodeBuddy Code 时自动加载到上下文中。加载顺序如下： 1. 用户级：加载 等主文件及 下的所有规则 2. 项目级主文件：从当前工作目录向上递归加载所有 和 3. 项目级规则：仅加载当前工作目录的 下的规则（不加载父目录的规则） 4. 子目录记忆：当 CodeBuddy 操作子目录中的文件时，动态加载该子目录的 5. 本地记忆：加载 提示：CODEBUDDY.local.md 文件会自动添加到 .gitignore，非常适合存储不应提交到版本控制的私有项目特定偏好。 CODEBUDDY.md 导入 CODEBUDDY.md 文件可以使用 语法导入其他文件。以下示例导入了 3 个文件： 支持相对路径和绝对路径。特别是，导入用户主目录中的文件是一种方便的方式，让团队成员可以提供不会提交到仓库的个人指令。导入是 CODEBUDDY.local.md 的替代方案，在多个 git worktree 之间工作得更好。 为避免潜在冲突，代码块和代码范围内的导入不会被解析。 导入的文件可以递归导入其他文件，最大深度为 5 层。您可以通过运行 命令查看已加载的记忆文件。 CodeBuddy 如何查找记忆 CodeBuddy Code 递归读取记忆：从当前工作目录开始，CodeBuddy Code 向上递归到根目录（但不包括根目录 ），并读取找到的任何 CODEBUDDY.md 或 CODEBUDDY.local.md 文件。这在大型仓库中特别方便，当您在 目录中运行 CodeBuddy Code，并且在 和 两处都有记忆时。 CodeBuddy 还会发现当前工作目录下子树中嵌套的 CODEBUDDY.md。这些文件不会在启动时加载，只有当 CodeBuddy 读取这些子树中的文件时才会包含。 使用 管理记忆 在会话中使用 斜杠命令，打开记忆管理面板。在该面板中你可以： 打开 Auto Memory 目录 打开 索引文件 切换 Auto Memory 开关 设置项目记忆 假设您想设置一个 CODEBUDDY.md 文件来存储重要的项目信息、约定和常用命令。项目记忆可以存储在 或 中。 使用以下命令为您的代码库引导一个 CODEBUDDY.md： 提示： 包含常用命令（构建、测试、lint）以避免重复搜索 记录代码风格偏好和命名约定 添加项目特定的重要架构模式 CODEBUDDY.md 记忆既可用于与团队共享的指令，也可用于个人偏好 使用 实现模块化规则 对于较大的项目，您可以使用 目录将指令组织到多个文件中。这允许团队维护专注的、组织良好的规则文件，而不是一个庞大的 CODEBUDDY.md。 基本结构 将 markdown 文件放在项目的 目录中： 中的所有 文件都会自动作为项目记忆加载，优先级与 相同。 注意：项目级规则仅从当前工作目录（workDir）的 加载，不会加载父目录的规则文件夹。这确保规则的作用域清晰明确。 规则控制字段 规则文件支持以下 YAML frontmatter 字段来控制加载和应用行为： 字段 类型 默认值 说明 boolean 是否加载此规则。设为 时规则完全不加载 boolean 是否始终应用此规则 string/string[] 触发规则的文件路径 glob 模式 规则类型判定 规则类型由 和 共同决定： alwaysApply paths 规则类型 行为 （默认） 任意 ALWAYS 始终注入到上下文 有值 MANUAL（条件触发） 仅在操作匹配文件时触发 无 不支持 规则不会加载 示例 始终应用的规则（默认行为）： 条件触发规则： 禁用规则（临时关闭）： 注意： 字段不仅限于 目录，在所有记忆文件（包括 CODEBUDDY.md、CODEBUDDY.local.md）"},{"id":"/cli/statusline","title":"状态行配置","body":"状态行配置 为 CodeBuddy Code 创建自定义状态行以显示上下文信息 通过自定义状态行让 CodeBuddy Code 更具个性化，状态行显示在 CodeBuddy Code 界面的底部，类似于 Oh my zsh 等 shell 中的终端提示符(PS1)的工作方式。 创建自定义状态行 您可以选择以下方式之一： 运行 让 CodeBuddy Code 帮助您设置自定义状态行。默认情况下,它会尝试复制您终端的提示符,但您可以向 CodeBuddy Code 提供有关所需行为的额外说明,例如 直接在您的 中添加 命令： 工作原理 状态行在对话消息更新时更新 更新最多每 300ms 运行一次 命令输出的第一行 stdout 成为状态行文本 支持 ANSI 颜色代码来设置状态行样式 CodeBuddy Code 通过 stdin 以 JSON 格式向您的脚本传递有关当前会话的上下文信息（模型、目录等） JSON 输入结构 您的状态行命令通过 stdin 接收 JSON 格式的结构化数据： 示例脚本 简单状态行 Git 感知状态行 带颜色的中文状态行 显示成本和统计信息 Python 示例 Node.js 示例 助手函数方法 对于更复杂的 bash 脚本，您可以创建助手函数： 完整的中文示例 高级示例 显示当前时间和会话时长 根据成本显示不同颜色 提示 保持状态行简洁 它应该适合一行 使用 emoji（如果您的终端支持）和颜色使信息易于浏览 在 Bash 中使用 进行 JSON 解析（参见上面的示例） 通过使用模拟 JSON 输入手动运行脚本来测试您的脚本： 如果需要，考虑缓存昂贵的操作（如 git status) 确保脚本输出是有效的 UTF 8,以正确显示中文和 emoji 常用 ANSI 颜色代码 故障排查 状态行不显示 检查脚本是否可执行： 确保脚本输出到 stdout（不是 stderr) 验证 JSON 路径正确： 中文或 emoji 显示乱码 确保终端支持 UTF 8 编码 检查脚本文件保存为 UTF 8 格式 在脚本开头添加： 颜色不显示 检查终端是否支持 ANSI 颜色 确保使用 来解释转义序列 验证颜色代码是否正确 Git 信息不显示 确保在 git 仓库中运行 检查 git 命令是否在 PATH 中 验证有权限读取 目录 脚本执行缓慢 缓存昂贵的操作（如 git status) 避免在状态行脚本中进行网络请求 使用后台进程更新缓存的信息 配置示例 用户级配置 在 中： 项目级配置 在 中： 这允许不同项目使用不同的状态行样式。 实用工具推荐 jq: JSON 解析工具，必备 bc：用于浮点数计算（成本比较） git：显示分支和状态信息 date：显示时间信息 安装： 相关资源 了解完整的配置选项 了解更多自定义功能 使用 快速配置 通过自定义状态行，让 CodeBuddy Code 更符合您的工作风格"},{"id":"/cli/terminal-config","title":"优化终端配置","body":"优化终端配置 CodeBuddy Code 在合适的终端配置下能发挥最佳性能。按照以下指南优化您的使用体验。 🎨 主题和外观 CodeBuddy Code 无法控制您终端的主题，这由您的终端应用程序处理。您可以随时通过 命令将 CodeBuddy Code 的主题与终端主题匹配。 如需进一步自定义 CodeBuddy Code 界面本身，您可以配置 在终端底部显示上下文信息，如当前模型、工作目录或 git 分支等。 ⌨️ 换行输入 在 CodeBuddy Code 中输入换行符有以下几种方式： Ctrl+J:跨平台快捷键，在多行输入时按 Ctrl+J 即可插入换行 快速转义:输入 后按 Enter 即可创建换行 Shift+Enter:通过 命令自动配置（推荐） 配置 Shift+Enter（推荐）: 在 CodeBuddy Code 中运行 命令，自动配置 Shift+Enter 快捷键。 支持的终端： macOS: iTerm2, Terminal.app IDE: VSCode, Cursor, Windsurf, Zed, CodeBuddy JetBrains: PyCharm, IntelliJ IDEA, WebStorm, PhpStorm, GoLand, Rider, CLion, RubyMine, AppCode, DataGrip 终端模拟器: Ghostty, WezTerm, Kitty, Alacritty, Hyper, Tabby, Warp Windows: Windows Terminal 配置 Option+Enter(VS Code、iTerm2 或 macOS Terminal.app): 对于 Mac Terminal.app: 1. 打开 设置 → 描述文件 → 键盘 2. 勾选\"将 Option 用作 Meta 键\" 对于 iTerm2 和 VS Code 终端： 1. 打开 Settings → Profiles → Keys 2. 在\"General\"下，将 Left/Right Option 键设置为\"Esc+\" 🔔 通知设置 通过合适的通知配置，让您在 CodeBuddy 完成任务时不会错过： iTerm 2 系统通知 为 iTerm 2 配置任务完成时的提醒： 1. 打开 iTerm 2 偏好设置 2. 导航到 Profiles → Terminal 3. 启用\"Silence bell\"和 Filter Alerts → “Send escape sequence generated alerts” 4. 设置您偏好的通知延迟 注意：这些通知功能仅适用于 iTerm 2,在 macOS 默认终端中不可用。 自定义通知 Hook 如需高级通知处理，您可以创建 来运行自己的逻辑。 📝 处理大量输入 在处理大量代码或长指令时： 避免直接粘贴:CodeBuddy Code 可能无法很好地处理非常长的粘贴内容 使用基于文件的工作流:将内容写入文件并要求 CodeBuddy 读取它 注意 VS Code 的限制:VS Code 终端特别容易截断长粘贴内容 ⌨️ Vim 模式 CodeBuddy Code 支持部分 Vim 快捷键，可以通过 命令启用,或通过 配置。 支持的功能子集包括： 模式切换： （切换到 NORMAL 模式）、 / 、 / 、 / （切换到 INSERT 模式） 导航： / / / 、 / / 、 / / 、 / 编辑： 、 / / / / 、 / / / / 、 （重复）"},{"id":"/cli/env-vars","title":"环境变量参考","body":"环境变量参考 CodeBuddy Code 支持通过环境变量来控制其行为。这些变量可以在启动前设置，也可以在 的 字段中配置以应用到每个会话。 提示：所有环境变量也可以在 的 字段中设置，这样可以自动为每个会话应用，或为整个团队推出配置。 认证相关 环境变量 说明 API 密钥。设置此密钥用于模型接口调用。在非交互模式 ( ) 下始终使用此密钥 CodeBuddy 平台认证令牌，用于所有平台接口调用 自定义 HTTP 请求头。格式： ，多个请求头用换行符或 分隔 API 端点和代理 环境变量 说明 覆盖 API 端点地址，通常与 配合使用 网络环境配置（ 用于中国版， 用于 iOA 企业版） / HTTP 代理服务器地址 / HTTPS 代理服务器地址 / 绕过代理的域和 IP 列表（逗号分隔，如 ） 模型配置 环境变量 说明 覆盖默认代理模型 后台任务使用的小型快速模型 复杂推理任务使用的大型模型 子代理使用的模型 启用扩展思考并设置思考过程的 token 预算。默认禁用 Bash 工具配置 环境变量 说明 长时间运行 bash 命令的默认超时（默认：120000） bash 输出在内存中保留的最大字符数（默认：30000，上限：150000）。超出部分会被中间截断（保留 head 20% + tail 80%），完整输出会自动保存到磁盘 模型可为长时间运行的 bash 命令设置的最大超时（默认：600000） 工具输出外部化 环境变量 说明 工具结果外部化的大小阈值（KB），超过此阈值的非 bash 工具结果会被保存到磁盘并替换为占位符（默认：50） 说明：Bash 工具的输出外部化由 控制，当输出超过该值发生截断时，完整输出自动流式写入磁盘。 主要影响其他工具（如 MCP 工具）的大输出处理。详见 章节。 工具和功能开关 环境变量 说明 设置为 禁用热更新系统 设置为 跳过内置插件市场加载 设置为 或 启用第三方插件市场自动更新（默认：禁用） 冒号分隔的本地插件目录路径列表（等同于 ），插件的 目录会自动注入到 设置为 或 禁用图片生成功能 设置为 或 禁用图片编辑功能 设置为 或 禁用 MCP 工具延迟加载 设置为 或 显示所有延迟工具的完整描述 设置为 禁用计划任务 设置为 在 模式流式输出中将图片 blob 引用还原为完整 base64 数据。适用于需要直接获取图片数据的下游集成场景 上下文和内存 环境变量 说明 设置自动压缩触发的上下文容量百分比（1 100）。默认由产品配置决定（通常 70 92%）。使用更低的值（如 ）来更早压缩 设置为 禁用自动内存，设置为 启用 设置为 或 启用记忆功能 设置为 或 启用分类记忆模式 设置为 或 启用团队记忆模式 团队记忆模式下的用户 ID MCP (Model Context Protocol) 环境变量 说明 MCP 服务器连接的超时时间（毫秒） MCP 工具执行的超时时间（毫秒） MCP 工具响应中允许的最大 token 数（默认：20000） 性能和输出 环境变量 说明 设置大多数请求的最大输出 token 数 覆盖文件读取的默认 token 限制（默认：20000） 流式响应中两个数据块之间允许的最大静默时间（毫秒）（默认：120000） 等待第一个模型输出的最大时间（毫秒）（默认：120000） 文件系统和配置 环境变量 说明 自定义 CodeBuddy Code 存储配置和数据文件的位置 调试日志目录 容器沙箱镜像（默认： ） 设置为 使用系统安装的 而不是 CodeBuddy Code 附带的 Shell 配置 环境变量 说明 覆盖自动 shell 检测。支持的值： 、 、 、 、 包装所有 shell 命令的命令前缀（如用于日志或审计） Windows 下显式指定 Git Bash 路径 在执行每个 shell 命令前自动 source 的环境文件路径 UI 和交互 环境变量 说明 设置为 禁用自动终端标题更新 设置为 禁用提示建议 设置为 启用演示模式：隐藏邮箱和组织 安全和认证 环境变量 说明 mTLS 客户端证书文件路径 ⚠️ 暂未支持 mTLS 客户端私钥文件路径 ⚠️ 暂未支持 mTLS 加密私钥的密码（可选）⚠️ 暂未支持 遥测和报告 环境变量 说明 设置为 禁用遥测 设置为 禁用错误报告 设置为 禁用自动更新 设置为 禁用 命令 任务和后台工作 环境变量 说明 设置为 禁用所有后台任务功能 Agent 执行控制 环境变量 说明 主 Agent 的最大执行轮次。优先级：CLI 此环境变量 默认值 (500) 子 Agent 的最大执行轮次。优先级：CLI 此环境变量 模型动态传入的 默认值 (500) Gateway 和远程访问 环境变量 说明"},{"id":"/cli/ide-integrations","title":"IDE 集成","body":"IDE 集成 CodeBuddy Code 支持两种与编辑器集成的方式，属于同一层级的 IDE 集成能力： 1. 通过 ACP (Agent Client Protocol) 协议作为通用「智能体服务端」被 IDE 调用 2. 通过 启动参数和 斜杠命令，作为「IDE 插件的后端伴生进程」进行深度集成 集成方式一：ACP 协议集成 适用于 Zed 等支持 ACP 的编辑器，将 CodeBuddy Code 作为通用 Agent Server 使用。 支持的编辑器 Zed 编辑器 通过 ACP 协议完整集成，支持： 项目上下文感知 工具操作代理（文件读写、终端命令） 权限请求交互 实时流式响应 配置详见： 集成方式二：IDE 插件集成 （ / ) 适用于 VS Code / Cursor / Windsurf / JetBrains 系列 IDE，通过插件 + 本地 MCP 服务器的方式集成。IDE 侧插件负责： 创建并维护 MCP 连接 （SSE / WebSocket) 将工作区信息、选区等上下文通过 MCP 协议传给 CodeBuddy 暴露 / / / 等 IDE 能力给 CodeBuddy 调用 启动参数 当您在终端中直接启动 CodeBuddy 时，可以通过 参数让 CLI 主动尝试连接当前工作目录对应的 IDE： 行为说明： CodeBuddy 会在当前用户目录下扫描由 IDE 插件创建的锁文件，检测可用的 IDE 实例 仅当 IDE 的工作区包含当前目录时才认为是「有效 IDE」 优先连接「工作区匹配且进程链路为当前终端上游」的 IDE 连接成功后，CLI 会通过 IDE MCP 服务器获得： 文件/差异预览 （openFile / openDiff) 诊断信息 （getDiagnostics) 选区变化通知 （selectionchanged) 只是在「您从 IDE 终端手动启动 CLI」时的一种快捷连接方式，不负责真正启动 IDE 或插件。 斜杠命令 当您在 CodeBuddy 的交互式界面中使用 IDE 插件集成时，可以通过 命令查看和管理当前 IDE 连接状态： 典型用途包括： 查看当前是否已连接 IDE、连接的是哪一个 IDE 在存在多个可用 IDE 时，选择要连接的实例 手动断开或重新建立与 IDE 的 MCP 连接 具体交互行为由 IDE 集成 UI 决定，但整体定位是「管理 IDE 集成状态」而不是直接发起聊天。 选择哪种集成方式？ 如果您的编辑器原生支持 ACP（例如 Zed），推荐使用 ACP 协议集成： 使用 启动 由编辑器负责会话 UI 和工具代理 如果您使用 VS Code / Cursor / JetBrains 等，通过插件市场安装 CodeBuddy 插件，则推荐使用 / 插件集成： 插件负责启动 CodeBuddy 进程并建立 MCP 连接 CLI 侧通过 / 与 IDE 建立和管理连接 两种方式在「集成层级」上是等价的，都是让 CodeBuddy 作为外部 Agent 与 IDE 深度协作，只是接入协议和 UI 承载方不同。 未来计划 后续版本将提供更多增强功能： 更友好的 DIFF 展示与修改确认流程 （结合 IDE diff 预览） 在 IDE 插件中提供更丰富的上下文选择与可视化 更多编辑器和 IDE 的官方集成 相关文档 详细的 ACP 配置指南 命令行参数说明 包含 等会话命令总览"},{"id":"/cli/acp","title":"ACP 协议集成","body":"ACP 协议集成 ACP (Agent Client Protocol) 是 Zed 编辑器推出的一种通用智能体协议，使智能体的核心功能（服务端）和用户界面（客户端）解耦，允许用户自由选择不同的智能体服务端和客户端进行搭配使用。 CodeBuddy Code 原生支持 ACP 协议，可以作为智能体服务端与支持 ACP 的编辑器无缝集成。 快速开始 启动 ACP 模式 使用 参数启动 CodeBuddy Code 的 ACP 服务器： Zed 编辑器集成 配置步骤 打开 Zed 配置文件（ ），添加以下配置： 随后即可在 Zed 侧边栏创建 CodeBuddy Code Thread，开始使用。 配置说明 command：指定 CodeBuddy Code 的命令路径（确保 在 PATH 中可用） args：使用 启用 ACP 协议模式 env：可选的环境变量配置，例如： 注意：使用 时，必须根据版本正确配置 ： 海外版：不设置（默认） 中国版： iOA 版： 详见 。 ACP 协议特性 认证信息扩展 CodeBuddy Code 在 响应的 字段中返回用户信息： 客户端可以利用这些信息提供更好的用户体验，例如显示当前登录用户、个性化界面等。 工具代理机制 ACP 协议支持客户端代理部分工具操作，提升性能和安全性： 文件操作代理：基于客户端的 和 能力 终端操作代理：基于客户端的 能力 当客户端声明支持这些能力时，CodeBuddy Code 会自动将相关工具调用代理给客户端执行。 命令列表推送 CodeBuddy Code 会在创建新会话时自动向客户端推送可用的 Slash 命令列表（ ），让客户端能够： 提供命令自动补全功能 显示命令提示和帮助信息 动态更新可用命令 命令列表会自动过滤掉本地命令（如 、 ）和客户端专属命令（如 、 ），只推送适用于 ACP 模式的命令。 Agent Teams 协议扩展 CodeBuddy Code 通过 的 字段扩展 ACP 协议，支持 Agent Teams 多智能体协作的实时状态推送。 Team 状态事件 通过 推送以下事件类型： 成员状态变化 ( )： Team 创建 ( ) / 删除 ( )： 成员流式消息 成员的实时消息（文本、工具调用）通过标准 ACP 事件推送，附加 标记来标识消息来源： 客户端收到带 标记的事件后，应将其路由到对应成员的对话时间线，而非主对话区。 页面刷新恢复 页面刷新后， 的 完成后会自动推送当前 Team 状态（ 事件），客户端无需单独请求。 在订阅成员 session 时会自动重放其完整历史，因此成员的对话数据也通过 ACP SSE 完整恢复，无需额外 HTTP API。 其他编辑器支持 ACP 是开放协议，理论上任何支持 ACP 的编辑器都可以集成 CodeBuddy Code。配置方式与 Zed 类似： 故障排除 连接失败 问题: Zed 无法连接到 CodeBuddy 解决方法: 1. 确认 命令可用： 2. 测试 ACP 模式启动： 3. 检查配置文件 JSON 格式是否正确 工具调用失败 问题：文件操作或命令执行报错 解决方法: 1. 检查工作目录权限 2. 查看 CodeBuddy 日志 相关链接 查看所有命令行参数 更多编辑器集成方式 协议详细文档 通过 ACP 协议，让 CodeBuddy Code 融入您喜爱的编辑器 🚀"},{"id":"/cli/gitlab-ci-cd","title":"CodeBuddy Code GitLab CI/CD 集成","body":"CodeBuddy Code GitLab CI/CD 集成 概述 CodeBuddy Code 支持与 GitLab CI/CD 深度集成，让您能够在 CI/CD 流水线中使用 AI 辅助完成代码审查、自动化实现和智能优化等任务。该集成基于 CodeBuddy Code CLI 构建，可在 GitLab CI 作业中以编程方式使用 AI 能力。 工作原理 CodeBuddy Code 利用 GitLab CI/CD 在隔离的作业中运行 AI 任务，并通过 MR 提交结果： 1. 事件驱动编排: GitLab 监听您选择的触发器（例如 Issue、MR 或评论中提及 @codebuddy)。作业收集上下文和代码库信息，构建提示并运行 CodeBuddy Code。 2. 沙箱执行：每次交互都在具有严格网络和文件系统规则的容器中运行。CodeBuddy Code 强制执行工作区范围的权限约束写入。每个变更都通过 MR 流转，审查者可以看到差异，审批流程仍然适用。 配置指南 快速配置 最快的入门方式是在 .gitlab ci.yml 中添加一个最小化的作业，并将 API 密钥设置为受保护的变量。 步骤 1：添加受保护的 CI/CD 变量 进入 GitLab 项目的 设置 → CI/CD → 变量，添加以下环境变量： 认证配置： 在 GitLab 项目的 设置 → CI/CD → 变量 中添加以下环境变量： CODEBUDDYAPIKEY （必需） 用于模型接口调用的 API 密钥 配置时勾选： ✅ 受保护 （Protect variable)、✅ 已屏蔽 （Mask variable) 可选配置： CODEBUDDYINTERNETENVIRONMENT 网络环境配置（中国版用户需要设置为 ,iOA 用户设置为 ) CODEBUDDYBASEURL 自定义模型服务的基础 URL（需兼容 OpenAI 接口协议） GITLABACCESSTOKEN GitLab 项目访问令牌（需具有 api 范围） 用于 CodeBuddy 创建/更新 MR 和评论 如不配置，默认使用 配置时勾选： ✅ 受保护、✅ 已屏蔽 📖 完整配置指南：根据您的账号类型，查看对应的配置方法和 API KEY 获取地址： iOA 账号用户（公司内部）：参考 中国版用户：参考 海外版用户：参考 每个章节包含完整的环境变量配置方法和 API KEY 获取地址。 步骤 2：在 .gitlab ci.yml 中添加 CodeBuddy 作业 添加作业和 API 密钥变量后，通过 CI/CD → 流水线手动运行作业进行测试，或从 MR 触发它，让 CodeBuddy 在分支中提出更新并在需要时创建 MR。 手动配置（推荐用于生产环境） 如果您需要更精细的控制： 1. 添加 GitLab API 操作的项目凭据: 默认使用 CIJOBTOKEN,或创建具有 api 范围的项目访问令牌 如果使用 PAT,将其存储为 GITLABACCESSTOKEN（已屏蔽） 2. 在 .gitlab ci.yml 中添加 CodeBuddy 作业（参见上面的示例） 3. （可选）启用提及驱动的触发器: 为\"评论(notes)\"添加项目 Webhook 到您的事件监听器（如果使用） 让监听器在评论包含 @codebuddy 时调用流水线触发 API,传递 AIFLOWINPUT 和 AIFLOWCONTEXT 等变量 使用示例 将 Issue 转化为 MR 在 Issue 评论中： CodeBuddy 分析 Issue 和代码库，在分支中编写变更，并创建 MR 供审查。 获取实现帮助 在 MR 讨论中： CodeBuddy 提出变更方案，添加适当的缓存代码，并更新 MR。 快速修复 Bug 在 Issue 或 MR 评论中： CodeBuddy 定位 Bug,实现修复，并更新分支或创建新的 MR。 最佳实践 CODEBUDDY.md 配置 在仓库根目录创建 CODEBUDDY.md 文件，定义编码标准、审查标准和项目特定规则。CodeBuddy 在运行期间会读取此文件，并在提出变更时遵循您的约定。 示例 CODEBUDDY.md: 安全考虑 永远不要将敏感信息提交到仓库！ 始终使用 GitLab CI/CD 变量： 将敏感配置添加为已屏蔽的变量（如有需要，标记为受保护） 限制作业权限和网络出口 像审查其他贡献者一样审查 CodeBuddy 的 MR 性能优化 保持 CODEBUDDY.md 简洁明了 提供清晰的 Issue/MR 描述以减少迭代 配置合理的作业超时以避免失控运行 在 Runner 中缓存 npm 和包安装（如果可能） CI 成本控制 使用 CodeBuddy Code 与 "},{"id":"/cli/devcontainer","title":"CodeBuddy Code 开发容器","body":"CodeBuddy Code 开发容器 CodeBuddy Code 开发容器提供了一个预配置、安全的开发环境，适合需要一致性和隔离性工作空间的团队使用。它与 Visual Studio Code 的 Dev Containers 扩展以及类似工具无缝集成。 四步快速开始 1. 安装 VS Code 和 Remote Containers 扩展 2. 参考下方配置详解在工作区创建 目录及相关文件 3. 在 VS Code 中打开仓库 4. 当提示时，点击 \"Reopen in Container\"（或使用命令面板：Cmd+Shift+P → \"Remote Containers: Reopen in Container\"） 🚀 安装 CodeBuddy Code（推荐方案） 方案 1：使用 Dev Containers Feature（推荐） Dev Containers Feature 是在 Dev Container 中安装 CodeBuddy Code 的推荐方式。它提供自动版本管理、与其他特性配置一致、简化维护等优势。 优势： ✅ 自动版本管理 轻松升级到最新版本或固定特定版本 ✅ 配置一致性 与其他 Dev Containers 特性采用相同配置方式 ✅ 简化维护 无需在 Dockerfile 中管理复杂的安装逻辑 ✅ 团队共享 易于在团队中统一配置 配置方法： 在 中的 字段添加配置： 固定特定版本： 使用默认最新版本： 方案 2：在 Dockerfile 中手动安装 如果需要更多控制或特殊场景，可在 Dockerfile 中手动安装。详见下方 Dockerfile 部分。 1. devcontainer.json 控制容器设置、管理扩展、配置卷挂载。 包含 Dev Containers Feature 的完整示例： 关键配置说明： 声明使用 CodeBuddy Code Dev Containers Feature，支持版本管理 使用最新版本（可替换为具体版本号如 \"2.16.0\"） 注意：使用 Feature 方式时，Dockerfile 中无需 参数 2. Dockerfile 定义容器镜像、指定安装的工具。 使用 Feature 时的简化 Dockerfile 如使用上方 Dev Containers Feature 安装 CodeBuddy Code，Dockerfile 可以更简洁（无需 参数和手动安装命令）： 如果你选择使用 Dev Containers Feature 方式（推荐），可以参考下方\"简化版 Dockerfile\"。如需在 Dockerfile 中手动安装，可参考\"完整版 Dockerfile\"。 简化版 Dockerfile（推荐配合 Feature 使用）： 手动安装方式的完整 Dockerfile 如需完全控制安装过程，可在 Dockerfile 中手动安装 CodeBuddy Code（此方案不使用 Dev Containers Feature）： 注意： 若使用此方式，devcontainer.json 中的 需包含 参数,且 字段中不应包含 CodeBuddy Code Feature。 3. init firewall.sh 建立网络安全规则。 安全特性 容器实现了多层安全防护： 精确访问控制：限制出站连接到白名单域名（npm registry、GitHub、CodeBuddy API 等） 允许的出站连接：防火墙允许出站 DNS 和 SSH 连接 默认拒绝策略：阻止所有其他外部网络访问 启动验证：容器初始化时验证防火墙规则 隔离：创建与主系统分离的安全开发环境 重要安全提示 虽然开发容器提供了实质性的保护，但没有系统能够完全免疫所有攻击。当使用 （或 ) 执行时，开发容器无法阻止恶意项目窃取容器内可访问的任何内容，包括 CodeBuddy Code 凭证。我们建议仅在处理可信仓库时使用开发容器。 始终保持良好的安全实践并监控 CodeBuddy 的活动。 无人值守操作 容器增强的安全措施（隔离和防火墙规则）允许您运行 （或 ) 来绕过权限提示，实现无人值守操作。 自定义选项 开发容器配置设计灵活，可根据需求调整： 根据工作流添加或删除 VS Code 扩展 为不同硬件环境调整资源分配 调整网络访问权限 自定义 shell 配置和开发工具 使用场景 1. 安全的客户项目开发 使用开发容器隔离不同客户的项目，确保代码和凭证永不混合。 2. 团队快速入职 新团队成员可在几分钟内获得完全配置的开发环境，所有必要的工具和设置都已预装。 3. 一致的 CI/CD 环境 在 CI/CD 流水线中镜像您的开发容器配置，确保开发和生产环境匹配。 相关资源 📖 🔗"},{"id":"/cli/mcp","title":"MCP (Model Context Protocol) 使用文档","body":"MCP (Model Context Protocol) 使用文档 概述 MCP (Model Context Protocol) 是一个开放标准，允许 CodeBuddy 与外部工具和数据源进行集成。通过 MCP，您可以扩展 CodeBuddy 的功能，连接到各种外部服务、数据库、API 等。 核心概念 MCP 服务器 MCP 服务器是提供工具、资源和提示的独立进程，CodeBuddy 通过不同的传输协议与这些服务器通信。 MCP Prompts 集成 MCP 服务器可以提供 Prompts（提示模板）,这些 Prompts 会自动转换为 CodeBuddy 的斜杠命令。当 MCP 服务器连接后： 服务器提供的 Prompts 会自动注册为斜杠命令 命令名称格式为： 支持动态参数，通过交互式界面收集用户输入 命令执行时会调用 MCP 服务器的 接口获取完整内容 支持实时监听配置变更，自动更新可用命令列表 传输类型 STDIO：通过标准输入输出与本地进程通信 SSE：通过 Server Sent Events 与远程服务通信 HTTP：通过 HTTP 流式传输与远程服务通信 配置作用域 user：全局用户配置，应用于所有项目 project：项目级配置，应用于特定项目 local：本地配置，仅应用于当前会话或工作区 对于同名服务（即在多个作用域有同名配置），生效的优先级为： 安全审批机制 项目作用域的 MCP 服务器在首次连接时需要用户审批，以确保安全性。系统会显示服务器详细信息，用户可以选择批准或拒绝连接。 非交互模式（ p/ print）下的审批 在非交互模式（如使用 参数)下,由于无法通过 UI 进行审批,需要通过 参数预先配置允许的 MCP 服务器： 工具权限管理 MCP 工具支持完整的权限管理系统，可以精确控制哪些工具可以被使用： 权限规则类型 权限系统支持三种规则类型（按优先级排序）： 1. 拒绝规则 （deny) 阻止使用指定工具（最高优先级） 2. 询问规则 （ask) 使用工具前需要用户确认（覆盖允许规则） 3. 允许规则 （allow) 允许工具使用而无需手动批准 MCP 权限规则格式 重要：MCP 权限不支持通配符 （) 服务器级权限 匹配指定服务器提供的任何工具 服务器名是在 CodeBuddy 中配置的名称 工具级权限 匹配指定服务器的特定工具 配置示例 批准服务器的所有工具 仅批准特定工具 拒绝特定工具 配置文件 配置文件位置 配置文件使用优先级机制，系统会按优先级顺序查找第一个存在的文件进行读取。写入时，如果文件已存在，会写入第一个存在的文件；如果都不存在，会创建最高优先级的文件。 USER 作用域 优先级顺序（从高到低）： 1. （推荐） 2. （已废弃） 3. （旧版配置文件） 读取规则：系统会按上述顺序查找第一个存在的文件并读取其内容。 写入规则： 如果上述文件中存在任意一个，写入第一个存在的文件 如果都不存在，创建 （最高优先级） PROJECT 作用域 优先级顺序（从高到低）： 1. （推荐） 2. （已废弃） 读取规则：系统会按上述顺序查找第一个存在的文件并读取其内容。 写入规则： 如果上述文件中存在任意一个，写入第一个存在的文件 如果都不存在，创建 （最高优先级） LOCAL 作用域 local 作用域的配置实际上保存在 user 作用域的配置文件中，通过 字段来区分不同项目的 local 配置。 文件路径： 使用的是 JSON Pointer 语法，用于指向 JSON 文档中的特定位置。关于 JSON Pointer 的详细说明，请参考：https://datatracker.ietf.org/doc/html/rfc6901 注意： 系统不会合并同一个作用域的多个配置文件内容，只会使用第一个存在的文件 示例见下方配置文件格式说明。 配置文件格式 MCP 配置文件支持 JSONC (JSON with Comments) 格式，允许在配置中添加注释，提升可读性和可维护性。 JSONC 支持的特性 单行注释：使用 添加行内或行尾注释 多行注释：使用 添加块注释 尾随逗号：数组和对象的最后一个元素后可以添加逗号 基础配置格式 带注释的完整示例 注意： 标准 JSON 格式文件仍然完全兼容 解析错误时会提供清晰的错误提示 json { \"mcpServers\": { \"python tools\": { \"type\": \"stdio\", \"command\": \"${PYTHONPATH: python}\", \"args\": [ \" m\", \"mymcpserver\", \" config\", \"${CONFIGDIR: /etc/config}\" ], \"env\": { \"PYTHONPAT"},{"id":"/cli/slash-commands","title":"CodeBuddy Code 斜杠命令 （Slash Commands)","body":"CodeBuddy Code 斜杠命令 （Slash Commands) CodeBuddy Code 支持斜杠命令，允许您在聊天中执行特殊操作、管理会话以及自定义常用工作流。 内置斜杠命令 （Built in Slash Commands) 这些命令用于管理您的 CodeBuddy Code 会话。以下是当前的支持情况： 命令 参数 CodeBuddy 支持情况 描述 : : ✅ 支持 显示帮助信息，并提供反馈渠道的指引。 ✅ 支持 开启全新对话（旧对话可通过 恢复）。 ✅ 支持 登录到您的账号。 ✅ 支持 退出当前的账号。 ✅ 支持 检查 CodeBuddy Code 的状态和环境。 ✅ 支持 显示当前仓库和会话的状态。 ✅ 支持 添加工作目录。指定要添加的目录路径。 ✅ 支持 管理实验性 AI 智能体 ✅ 支持 快速提问，不中断当前 Agent 工作流。适用于在 Agent 执行任务时临时提出简短问题，答案基于已有上下文生成。 ✅ 支持 压缩上下文。 ✅ 支持 查看或修改本地配置。不带参数时打开交互式面板， 列出当前设置， 读取设置， 修改设置。 ✅ 支持 计算当前会话的上下文 token 分布情况。 ✅ 支持 显示会话的成本和 Token 使用情况。 ✅ 支持 初始化一个新的 CodeBuddy 存储库。 ✅ 支持 管理 MCP 连接。 ✅ 支持 管理长期记忆 ✅ 支持 切换或查看当前使用的 AI 模型。不带参数时打开交互式选择界面， 列出可用模型，带模型名称参数时直接切换到指定模型（如 ）。 ✅ 支持 切换或查看当前使用的文生图模型。不带参数时打开交互式选择界面， 列出可用模型，带模型 ID 参数时直接切换到指定模型。 ✅ 支持 切换或查看当前使用的图生图模型。不带参数时打开交互式选择界面， 列出可用模型，带模型 ID 参数时直接切换到指定模型。 ✅ 支持 管理工具权限和工作区目录访问权限。 ✅ 支持 预览当前计划模式下的计划文件内容。 ✅ 支持 在浏览器中打开升级页面，查看高级功能和订阅选项。 ✅ 支持 列出和管理后台任务。 ✅ 支持 配置 Shift+Enter 快捷键绑定，用于在输入框中插入换行符。 ✅ 支持 显示当前会话中的待办事项列表。 ✅ 支持 配置终端状态行显示，可以显示会话信息、模型状态等。 ✅ 支持 执行当前分支的代码安全审查，由高级安全工程师进行焦点式的安全审查以识别高置信度的安全漏洞。 ✅ 支持 打开主题选择面板，可选择和预览不同的终端主题(dark、light、colorblind friendly、ANSI 等）。 ✅ 支持 导出当前对话到文件或剪贴板。 ✅ 支持 打开反馈页面，提交 Bug 报告或功能建议。 ✅ 支持 恢复之前的会话。不带参数时打开交互式面板， 列出所有会话，带 session id 时直接切换到指定会话。 ✅ 支持 回退对话到之前的某个消息点，可选择仅回退对话、仅回退代码或同时回退两者。详见 。 ✅ 支持 管理 Bash 命令沙箱模式，控制命令执行的安全策略。详见 。 ✅ 支持 显示使用统计信息，包括 Token 使用量、模型调用次数、会话时长等详细数据，支持总览和按模型分类两个视图。 ✅ 支持 管理 IDE 集成状态。可以查看当前连接的 IDE、切换 IDE 连接或断开连接。详见 。 ✅ 支持 管理插件和插件市场。不带参数时打开交互式界面,支持 、 、 、 、 等操作。详见 。 ✅ 支持 验证插件目录结构和 manifest 有效性。不带参数时验证当前目录。详见 。 ✅ 支持 重新加载所有插件（Skills、Agents、Hooks、MCP/LSP 服务器等）,无需重启。 ✅ 支持 查看当前已加载的所有 Skills,包括用户级、项目级和插件级 Skills,并显示预估 token 数量。详见 。 ✅ 支持 生成 AI 驱动的使用洞察报告,分析您的 CodeBuddy Code 使用模式、交互风格、项目领域、摩擦点等多个维度,并生成可在浏览器中查看的 HTML 报告。 description: \"为我的项目运行单元测试并报告结果。\" argument hint: \"[test file]\" allowed tools: Bash(npm run:) model: gemini 3.1 pro description: \"代码审查\" argument hint: \"[pr number] [priority] [assignee]\" 请审查 PR #$1，优先级为 $2，并分配给 $3 进行最终确认。 重点检查以下方面： 代码风格和最佳实践 性能影响 安全问题 测试覆盖率 markdown description: \"修复代码问题\" argument hint: \"[is"},{"id":"/cli/sub-agents","title":"子代理","body":"子代理 在 CodeBuddy Code 中创建和使用专门的 AI 子代理，用于特定任务工作流和改进的上下文管理。 CodeBuddy Code 中的自定义子代理是专门的 AI 助手，可以被调用来处理特定类型的任务。它们通过提供具有自定义系统提示、工具和独立上下文窗口的特定任务配置，实现更高效的问题解决。 什么是子代理？ 子代理是预配置的 AI 人格，CodeBuddy Code 可以将任务委派给它们。每个子代理： 具有特定的目的和专业领域 使用与主对话分离的自己的上下文窗口 可以配置为允许使用特定工具 包含指导其行为的自定义系统提示 当 CodeBuddy Code 遇到与子代理专业领域相匹配的任务时，它可以将该任务委派给专门的子代理，该子代理独立工作并返回结果。 主要优势 优势 说明 : : 上下文保留 每个子代理在自己的上下文中运行，防止主对话被污染，并使其专注于高级目标。 专业化知识 子代理可以使用特定领域的详细说明进行微调，从而提高指定任务的成功率。 可重用性 创建后，子代理可以在不同项目中使用，并与您的团队共享以实现一致的工作流。 灵活的权限 每个子代理可以具有不同的工具访问级别，允许您将强大的工具限制为特定的子代理类型。 快速开始 要创建您的第一个子代理： 1. 打开子代理界面 运行以下命令： 2. 选择\"创建新代理\" 选择是创建项目级别还是用户级别的子代理 3. 定义子代理 推荐：先使用 AI 生成，然后自定义以使其成为您自己的 详细描述您的子代理，包括何时应该使用它 选择您想要授予访问权限的工具，或留空以继承所有工具 界面会显示所有可用工具 如果您使用 AI 生成，也可以按 在自己的编辑器中编辑系统提示 4. 保存并使用 您的子代理现在可用。CodeBuddy Code 会在适当时自动使用它，或者您可以显式调用它： 子代理配置 文件位置 子代理存储为具有 YAML 前置内容的 Markdown 文件，位置有两个： 类型 位置 范围 优先级 : : : : 项目子代理 在当前项目中可用 最高 用户子代理 在所有项目中可用 较低 当子代理名称冲突时，项目级别的子代理优先于用户级别的子代理。 插件代理 可以提供与 CodeBuddy Code 无缝集成的自定义子代理。插件代理的工作方式与用户定义的代理相同，并在 界面中显示。 插件代理位置：插件在其 目录中包含代理（或插件清单中指定的自定义路径）。 使用插件代理： 插件代理与您的自定义代理一起显示在 中 可以显式调用：\"使用 security plugin 中的 code reviewer 代理\" 可以在适当时由 CodeBuddy Code 自动调用 可以通过 界面进行管理（查看、检查） 有关创建插件代理的详细信息，请参阅 。 基于 CLI 的配置 您也可以使用 CLI 标志动态定义子代理，该标志接受 JSON 对象： 优先级：CLI 定义的子代理的优先级低于项目级别的子代理，但高于用户级别的子代理。 用例：此方法适用于： 快速测试子代理配置 不需要保存的会话特定子代理 需要自定义子代理的自动化脚本 在文档或脚本中共享子代理定义 有关 JSON 格式和所有可用选项的详细信息，请参阅 。 文件格式 每个子代理在具有以下结构的 Markdown 文件中定义： 配置字段 字段 必需 描述 : : : 是 使用小写字母和连字符的唯一标识符 是 子代理目的的自然语言描述 否 特定工具的逗号分隔列表。如果省略，继承主线程中的所有工具 否 用于此子代理的模型。可以是模型别名（ 、 等）或 以使用主对话的模型。如果省略，默认为配置的子代理模型 否 子代理的权限模式。有效值: 、 、 、 、 。控制子代理如何处理权限请求 否 子代理启动时自动加载的技能名称，逗号分隔 模型选择 字段允许您控制子代理使用的 ： 模型别名：使用可用别名之一，如 、 、 、 等 ：使用与主对话相同的模型（对于一致性很有用） 省略：如果未指定，使用为子代理配置的默认模型 注意：当您希望子代理适应主对话的模型选择，确保整个会话中的功能和响应风格一致时，使用 特别有用。 可用工具 子代理可以被授予访问 CodeBuddy Code 任何内部工具的权限。有关可用工具的完整列表，请参阅 。 提示：推荐：使用 命令修改工具访问权限 它提供了一个交互式界面，列出所有可用工具，包括任何连接的 MCP 服务器工具，使选择所需工具变得更容易。 您有两个选项来配置工具： 省略 字段以继承主线程中的所有工具（默认），包括 MCP 工具 指定单个工具作为逗号分隔列表以获得更精细的控制（可以手动编辑或通过 编辑） MCP 工具：子代理可以访问来自配置的 MCP 服务器的 MCP 工具。当省略 字段时，子代理继承主线程可用的所有 MC"},{"id":"/cli/agent-teams","title":"Agent Teams：多智能体协作","body":"Agent Teams：多智能体协作 Agent Teams 让你协调多个 CodeBuddy Code 实例组成团队协作，通过共享任务列表、成员间消息通信和集中式管理完成复杂任务。该功能目前存在 。 Agent Teams 让你协调多个 CodeBuddy Code 实例共同工作。一个会话作为团队领导（team lead），负责协调工作、分配任务和汇总成果；其余成员（teammates）各自独立工作，拥有自己的上下文窗口，并通过消息系统直接相互沟通。 与 不同的是，子代理在单一会话内运行、只能将结果报告给主代理；而 Agent Teams 的成员之间可以直接通信，你也可以绕过领导直接与任意成员对话。 何时使用 Agent Teams Agent Teams 在并行探索能创造真正价值的任务中最为有效。典型场景包括： 研究与评审：多个成员同时调研问题的不同方面，然后共享和质疑彼此的发现 新模块开发：每个成员负责独立的模块，互不干扰 竞争性假设调试：成员并行测试不同假设，更快收敛到正确答案 跨层协调：前端、后端、测试各由不同成员负责，同步推进 Agent Teams 会带来额外的协调开销，Token 消耗也显著高于单会话。当成员能独立工作时效果最好。对于顺序执行的任务、同文件编辑或依赖关系复杂的工作，单会话或子代理更合适。 与子代理的对比 子代理 Agent Teams : : : 上下文 独立上下文窗口，结果返回给调用者 独立上下文窗口，完全独立 通信 只能向主代理报告结果 成员之间可直接发送消息 协调 主代理管理所有工作 共享任务列表，成员自主认领 适用场景 聚焦型任务，只关心最终结果 需要讨论和协作的复杂工作 Token 消耗 较低：结果汇总回主上下文 较高：每个成员是独立实例 简单来说：需要快速执行的独立子任务用子代理，需要成员之间相互沟通和协调的复杂任务用 Agent Teams。 创建你的第一个团队 用自然语言告诉 CodeBuddy 你想要什么样的团队。CodeBuddy 会根据你的描述自动创建团队、生成成员、分配任务。 CodeBuddy 会： 1. 创建团队和共享任务列表 2. 为每个角色生成独立的成员 3. 协调各成员的工作 4. 汇总最终成果 团队创建完成后，终端会显示所有成员及其当前状态。你可以通过 的方式直接与任意成员对话。 团队创建后的界面 创建成功后，你会看到类似如下信息： 随后领导通过 Agent 工具生成成员，每个成员以 的形式展示，并以不同颜色标识。 控制你的团队 用自然语言告诉领导你的意图，它会处理团队协调、任务分配和工作委派。 与成员交互 你可以直接与任何成员对话，无需通过领导中转。 @提及补全：在输入框中输入 触发成员名称的 Tab 自动补全。支持模糊搜索，输入部分名称即可匹配。下拉菜单中会以成员各自的颜色显示名称，并标注状态（如 ）。选择成员后输入消息即可直接发送。 @all 广播：输入 可向所有成员同时发送消息，相当于广播。当成员数量大于 1 时， 选项会出现在补全列表的最前面。 提示：已完成任务的成员也会显示在 补全列表中。选择一个已完成的成员并发送消息，可以重新唤醒它继续工作。 实时状态栏 输入框下方会显示团队状态栏，展示各成员的工作状态： 表示正在工作 表示已完成 表示失败 表示已取消或被终止 每个成员名称以其分配的颜色渲染，并实时显示 Token 消耗和工具调用次数。当打开补全下拉菜单时，状态栏会自动隐藏以避免遮挡。 成员焦点导航 在输入框为空时，按 进入成员切换模式，使用方向键选择成员，回车确认切换： 快捷键 功能 : : ↓ 进入成员切换模式 ←/→ 在成员之间切换选择 Enter 确认并切换到选中成员的视图 Esc 取消选择，退出切换模式 Ctrl+O 返回主视图（团队领导） 聚焦成员后： 终端会显示该成员的完整对话历史、实时进度和 Token 消耗 输入框自动切换为向该成员发送消息的模式，直接输入即可发送 使用 可将消息路由回主代理（团队领导） 提示：焦点导航是查看成员工作详情的最便捷方式。相比 只能发送消息，焦点导航还能浏览成员的历史对话和当前工作状态。 指定成员和模型 CodeBuddy 会根据任务自动决定生成多少成员，也可以明确指定： 要求成员在实施前提交计划 对于复杂或高风险的任务，可以要求成员在实施前先提交计划： 成员完成计划后，会向领导发送计划审批请求。领导审核后批准或拒绝（附带反馈）。被拒绝的成员会保持计划模式，修改后重新提交。 委派模式 默认情况下，领导可能会自己动手实现任务，而不是等成员完成。按 可以切换到委派模式（Delegate Mode），限制领导只能使用协调工具（生成成员、发送消息、管理任务），不直接修改代码。 适合你希望领导专注于任务拆分、分"},{"id":"/cli/skills","title":"CodeBuddy Code Skills （技能系统）","body":"CodeBuddy Code Skills （技能系统） Skills 是 CodeBuddy Code 的扩展能力系统，允许您创建专业的领域知识和工作流模板，让 AI 助手能够更专业地处理特定类型的任务。 什么是 Skills Skills 类似于为 AI 助手提供的\"专业培训\"。通过 Skill，您可以： 封装专业知识：将特定领域的最佳实践和操作流程封装成可复用的技能 提供工作流模板：定义标准化的任务处理流程，提高工作效率 扩展 AI 能力：让 AI 助手能够处理更专业、更复杂的任务 团队协作共享：项目级 Skills 可以在团队成员间共享专业知识 Skills vs Slash Commands 特性 Skills Slash Commands 触发方式 AI 模型自动识别并调用 用户手动输入命令 使用场景 专业领域任务处理 快捷操作和工作流 权限控制 支持工具白名单限制 无特殊权限控制 工作目录 支持自定义基础目录 使用当前工作目录 可见性 对用户透明，AI 自动决策 用户主动发起 简单来说： Slash Commands 是用户主动调用的快捷方式 Skills 是 AI 根据任务需求自动选择的专业能力 创建 Skills 目录结构 Skills 通过在特定目录中创建 文件来定义： 1. 项目级 Skills： （项目根目录下） 2. 用户级 Skills： （用户主目录下） 每个 Skill 一个独立的目录，包含 文件： SKILL.md 格式 Skill 文件使用 Markdown 格式，支持 YAML Frontmatter 定义元数据： Frontmatter 字段 字段 必填 说明 示例 否 Skill 名称，未指定时使用目录名 否 Skill 描述，帮助 AI 理解何时使用 否 允许使用的工具白名单，逗号分隔 否 设置为 时，Skill 不会出现在 Skill 工具中，只能通过 手动触发 否 设置为 时，Skill 从 菜单中隐藏，仅供 AI 内部调用或其他 Skill 引用，默认 否 设置为 时，Skill 在独立的 subagent 上下文中执行 否 指定 subagent 类型，仅在 时有效 执行 Shell 命令 与 一样，Skills 也支持在 SKILL.md 中使用 command 语法内联执行 Shell 命令。当 Skill 被触发时（无论是 AI 自动调用还是用户通过 手动触发），这些命令会被执行，输出结果会替换到 Skill 内容中，供 AI 后续分析。 示例： 支持的特性 参数替换：在 Shell 命令执行前， 会被替换为用户传入的参数 文件引用：Shell 命令执行后， 引用会被处理并注入文件内容 错误隔离：单个命令执行失败不会影响其他命令，失败的命令会被替换为空字符串 💡 处理管道： 替换 → command 执行 → 引用处理，与斜杠命令的处理顺序一致。 Context Fork 使 Skill 在隔离的子代理上下文中运行，不访问对话历史。 可用 Agent 类型 类型 说明 通用（默认） 只读工具，优化代码库探索 规划和分析 自定义 中定义的 agent 隐藏 Skill（user invocable） 使 Skill 从 菜单中隐藏，适用于： 背景知识类 Skill（如项目规范、编码标准） 仅供其他 Skill 或 AI 内部引用的辅助 Skill 这类 Skill 会被加载到 AI 的上下文中，但用户无法通过 菜单直接调用。 执行流程 1. 创建新的隔离上下文 2. 子代理接收 Skill 内容作为提示 3. 字段决定执行环境 4. 结果返回主对话 注意： 只适用于包含明确任务的 Skill。仅有指导方针没有具体任务时，不会产生有意义的输出。 使用示例 示例 1：PDF 处理 Skill 文件： 使用：当用户询问 \"帮我提取这个 PDF 的内容\" 时，AI 会自动识别需要 PDF 处理能力并调用该 Skill。 示例 2：数据分析 Skill 文件： 示例 3：代码审查 Skill 文件： AI 如何选择 Skills AI 根据以下因素决定是否调用 Skill： 1. 任务匹配度：任务描述与 Skill description 的相关性 2. 工具需求：任务所需工具是否在 allowed tools 范围内 3. 上下文相关性：当前对话上下文是否适合使用该 Skill 4. Skill 来源：项目级 Skills 优先于用户级 Skills 权限控制 allowed tools 白名单 通过 字段限制 Skill 可以使用的工具： 支持的工具模式匹配： 只允许 git 相关命令 只允许编辑特定路径文件 工作目录限制 每个 Skill 都有自己的 （SKILL.md 所"},{"id":"/cli/hooks-guide","title":"Hooks 入门指南","body":"Hooks 入门指南 学习如何通过注册 shell 命令来自定义和扩展 CodeBuddy Code 的行为 建议先阅读 ，了解所有事件、输入输出结构与安全要求。本指南聚焦于实际操作演练与常见示例，帮助你迅速在 CodeBuddy Code 项目中启用 Hooks 功能。 注意：Hook 功能目前处于 Beta 阶段，仍在持续打磨，请留意后续版本更新。 现在你已掌握在 CodeBuddy Code 中启用 hooks 的核心流程。更多事件字段细节、决策控制和安全注意事项请查阅 。祝你构建出既强大又安全的自动化工作流！"},{"id":"/cli/plugins","title":"创建插件","body":"创建插件 插件让你可以通过自定义技能、代理、钩子和 MCP 服务器来扩展 CodeBuddy Code 的功能。本指南涵盖如何创建你自己的插件。 要安装已有的插件，请参阅 。完整的技术规范请参考 。 何时使用插件 vs 独立配置 CodeBuddy Code 支持两种添加自定义技能、代理和钩子的方式： 方式 技能名称 适用场景 独立配置（ 目录） 个人工作流、项目特定定制、快速实验 插件（含 的目录） 团队共享、社区分发、版本化发布、跨项目复用 使用独立配置的场景： 为单个项目定制 CodeBuddy Code 配置是个人的，不需要共享 在打包为插件之前实验技能或钩子 需要简短的技能名称，如 或 使用插件的场景： 需要与团队或社区共享功能 需要在多个项目中使用相同的技能/代理 需要版本控制和便捷的更新机制 通过市场分发 可以接受命名空间化的技能名称如 （命名空间防止插件间冲突） 提示：先在 中使用独立配置快速迭代，准备共享时再 。 快速开始 本快速开始将引导你创建一个包含自定义技能的插件。你将创建一个清单文件（定义插件的配置文件）、添加一个技能，并使用 参数在本地测试。 前提条件 已 CodeBuddy Code 如果看不到 命令，请将 CodeBuddy Code 更新到最新版本。参见 获取升级说明。 创建你的第一个插件 第 1 步：创建插件目录 每个插件都有自己的目录，包含清单文件和你的技能、代理或钩子。现在创建一个： 第 2 步：创建插件清单 清单文件位于 ，定义插件的身份信息：名称、描述和版本。CodeBuddy Code 使用这些元数据在插件管理器中展示你的插件。 在插件目录内创建 目录： 然后创建 ，内容如下： 字段 用途 唯一标识符和技能命名空间。技能以此为前缀（如 ） 在插件管理器中浏览或安装插件时显示 使用 跟踪发布 可选。用于归属标注 更多字段如 、 和 ，参见 。 第 3 步：添加技能 技能放在 目录中。每个技能是一个包含 文件的文件夹。文件夹名称成为技能名称，并以插件命名空间为前缀（在名为 的插件中， 创建 ）。 在插件目录中创建技能目录： 然后创建 ，内容如下： 第 4 步：测试你的插件 使用 参数运行 CodeBuddy Code 以加载你的插件： 启动后，尝试你的新技能： 你会看到 CodeBuddy 回复一个问候语。运行 可以看到你的技能列在插件命名空间下。 为什么要命名空间？ 插件技能始终带有命名空间（如 ），以防止多个插件中同名技能产生冲突。要更改命名空间前缀，请更新 中的 字段。 第 5 步：添加技能参数 通过接受用户输入使技能更加动态。 占位符捕获用户在技能名称后提供的任何文本。 更新你的 文件： 运行 以获取更改，然后用你的名字尝试技能： CodeBuddy 会按名字问候你。更多关于向技能传递参数的信息，参见 。 你已成功创建并测试了一个包含以下关键组件的插件： 插件清单（ ）：描述插件的元数据 技能目录（ ）：包含你的自定义技能 技能参数（ ）：捕获用户输入实现动态行为 参数适用于开发和测试。当你准备与他人共享插件时，参见 。 插件结构概述 你已经创建了一个包含技能的插件，但插件还可以包含更多内容：自定义代理、钩子、MCP 服务器和 LSP 服务器。 常见错误：不要将 、 、 或 放在 目录内。只有 放在 内。所有其他目录必须在插件根目录层级。 目录 位置 用途 插件根目录 包含 清单 插件根目录 Markdown 格式的斜杠命令 插件根目录 自定义代理定义 插件根目录 包含 文件的代理技能 插件根目录 事件处理器 插件根目录 MCP 服务器配置 插件根目录 LSP 服务器配置（代码智能） 插件根目录 插件启用时添加到 Bash 工具 的可执行文件 插件根目录 插件启用时应用的默认 示例完整结构： 开发更复杂的插件 掌握了基础插件后，你可以创建更复杂的扩展。 添加技能 插件可以包含 来扩展 CodeBuddy 的能力。技能是模型调用的：CodeBuddy 会根据任务上下文自动使用它们。 在插件根目录添加 目录，其中包含带有 文件的技能文件夹： 每个 需要包含 和 字段的 frontmatter，后跟指令： 安装插件后，运行 加载技能。完整的技能编写指南，包括渐进式披露和工具限制，参见 。 添加命令 插件可以提供自定义斜杠命令，用户可以手动触发。命令定义为 Markdown 文件。 示例： 命令会以 的格式注册。 详细说明请参考 。 添加 Hooks Hooks 允许在特定事件发生时自动执行操作。命令通过标准输入接收 hook 输入的 JSON 数据，可以使用 提取字段。 示例： 详细说明请参考 。 添加 LSP 服务器 对于常见语言如 TypeScript、Python 和 Rust"},{"id":"/cli/plugin-marketplaces","title":"插件市场（Plugin Marketplaces）","body":"插件市场（Plugin Marketplaces） 插件市场（Plugin Marketplace）是一个插件目录文件，用于分发和管理 CodeBuddy Code 扩展。通过市场，你可以发现并安装来自不同来源的插件，无需自己构建。 核心功能 集中发现：在一个地方浏览来自多个来源的插件 版本管理：自动跟踪和更新插件版本 自动更新：支持启用自动更新，定期同步市场内容 团队分发：在组织内共享必需的插件 灵活来源：支持 GitHub 仓库、Git URL、本地路径和 HTTP URL 两步流程：先添加市场，再安装具体插件 官方市场 官方市场在 CodeBuddy Code 启动时自动可用。运行 并进入发现标签页浏览可用插件。 安装官方市场的插件 使用以下命令从官方市场安装插件： 例如，安装 GitHub 集成： 添加市场 使用 命令从不同来源添加市场。 💡 快捷方式：可以使用 代替 ， 代替 GitHub 仓库 添加包含 文件的 GitHub 仓库，使用 格式： 其他 Git 主机 添加来自 GitLab、Bitbucket 或其他 Git 服务的仓库： 使用 HTTPS： 使用 SSH： 指定特定分支或标签： 本地路径 添加本地目录或 文件（用于开发和测试）： 远程 URL 通过 HTTP(S) URL 添加托管的 文件： ⚠️ 注意：URL 型市场相比 Git 型市场有一些限制。如果安装插件时遇到\"路径未找到\"错误，参见 安装插件 添加市场后，你可以直接安装插件（默认安装到用户作用域）： 选择安装作用域 使用交互式界面选择 ： 1. 运行 打开插件管理器 2. 进入发现标签页 3. 按 Enter 选择一个插件，查看作用域选项： 用户作用域（默认）：为你自己在所有项目中安装 项目作用域：为所有协作者在此仓库中安装（添加到 ） 本地作用域：仅为你自己在此仓库中安装（不与协作者共享） 托管作用域：由管理员通过 安装（不可修改） 📌 提示：运行 进入已安装标签页，查看按作用域分组的插件 管理已安装的插件 运行 并进入已安装标签页来查看、启用、禁用或卸载插件。输入文本筛选插件列表。 快速管理命令 禁用插件（不卸载）： 重新启用已禁用的插件： 完全卸载插件： 指定特定作用域： 无需重启应用更改 安装、启用或禁用插件后，运行 无需重启即可加载所有更改： CodeBuddy Code 重新加载所有活跃插件，并显示插件数、技能数、代理数、钩子数、插件 MCP 服务器数和插件 LSP 服务器数的统计。 管理市场 通过交互式 界面或命令行管理市场。 交互式界面管理 运行 并进入市场标签页来： 查看所有已添加的市场及其来源和状态 添加新市场 更新市场列表以获取最新插件 移除不再需要的市场 命令行管理 列出所有已配置的市场： 刷新市场的插件列表： 移除市场： ⚠️ 警告：移除市场将卸载从该市场安装的所有插件 配置自动更新 CodeBuddy Code 可以在启动时自动更新市场及其已安装的插件。启用市场自动更新后，CodeBuddy Code 会刷新市场数据并将已安装插件更新到最新版本。如果任何插件被更新，你会看到提示运行 的通知。 通过 UI 为单个市场切换自动更新： 1. 运行 打开插件管理器 2. 选择市场 3. 从列表中选择一个市场 4. 选择启用自动更新或禁用自动更新 官方市场默认启用自动更新。第三方和本地开发市场默认禁用自动更新。 禁用所有自动更新： 设置 环境变量可以禁用 CodeBuddy Code 和所有插件的自动更新。参见 。 保持插件自动更新，禁用 CodeBuddy 自动更新： 设置 和 ： 这样你可以手动管理 CodeBuddy Code 更新，同时自动接收插件更新。 官方市场内容 官方市场包含多个类别的插件： 代码智能 代码智能插件启用 CodeBuddy Code 内置的 LSP 工具，让 AI 能够跳转到定义、查找引用、查看类型错误等。这些插件配置 连接，与 VS Code 的代码智能相同。 这些插件要求在你的系统上安装语言服务器二进制文件。如果已经安装了语言服务器，打开项目时 CodeBuddy Code 可能会提示你安装对应的插件。 语言 插件 所需二进制文件 C/C++ C Go Java Kotlin Lua PHP Python Rust Swift TypeScript 你也可以为其他语言 ⚠️ 注意：如果在 错误标签页中看到 ，请从上表中安装所需的二进制文件。 代码智能插件的作用 安装代码智能插件并且语言服务器二进制文件可用后，CodeBuddy Code 获得两个能力： 自动诊断：每次编辑后，语言服务器会自动分析更改并报告错误和警告。CodeBuddy Code 可以看到类型错误、缺失的导入和语法问题，"},{"id":"/cli/checkpointing","title":"检查点","body":"检查点 概述 自动跟踪并回退 CodeBuddy 的编辑，快速恢复不需要的更改。 CodeBuddy Code 在您工作时会自动跟踪 CodeBuddy 对文件的编辑，让您能够快速撤销更改，并在出现问题时回退到之前的状态。 常见使用场景 检查点在以下情况下特别有用： 探索替代方案：尝试不同的实现方式，而不会丢失起始点 从错误中恢复：快速撤销引入 bug 或破坏功能的更改 功能迭代：在知道可以恢复到可用状态的前提下，放心地进行各种尝试 另请参阅 键盘快捷键和会话控制 使用 访问检查点"},{"id":"/cli/worktree","title":"Git Worktree 支持","body":"Git Worktree 支持 在独立工作区中运行 CodeBuddy,实现并行开发和安全隔离。 概述 Git worktree 允许在同一仓库中同时拥有多个工作目录,每个目录可以检出不同的分支。CodeBuddy Code 利用这一特性提供: 并行开发:在不影响主工作区的情况下进行实验性开发 安全隔离:AI 的所有更改都在独立目录中进行 零存储开销:worktree 共享 Git 对象,不会复制整个仓库 子代理隔离:支持多个 AI 子代理在独立 worktree 中并行工作 tmux 集成:可选在独立的 tmux 会话中运行 非 Git 支持:通过 WorktreeCreate/WorktreeRemove hooks，SVN、Perforce 等项目也能使用 worktree 隔离 快速开始 在会话中创建 已启动 CodeBuddy Code 会话后,可以通过自然语言请求创建 worktree: AI 会自动调用 工具创建隔离工作目录并切换过去。 注意:只有明确提到 \"worktree\" 时才会触发,说 \"帮我开一个分支\" 或 \"修复这个 bug\" 不会自动创建 worktree。 CLI 参数 参数 说明 示例 : : : 创建并进入 worktree 或 指定基础分支（需配合 ） 或 在 tmux 会话中运行（需要安装 tmux） 使用传统 tmux 模式（不使用 popup） 工作流程 创建 Worktree 当使用 参数启动时: 1. CodeBuddy 在 目录下创建新的 worktree 2. 确定基础分支: 如果指定了 ，基于远程分支 如果指定了 ，基于本地分支 如果未指定，默认基于远程默认分支（通常是 或 ） 3. 自动创建对应的分支(如 ) 4. 将工作目录切换到 worktree 5. 执行初始化(复制设置、创建符号链接、复制 文件等) 分支不存在时的行为： 如果指定的分支（远程或本地）不存在，会打印警告并自动降级到远程默认分支继续创建 不会中断启动流程 退出时的选择 当你退出 worktree 会话时，CodeBuddy 会检测变更并提供选项： 保留 Worktree：保留所有更改和分支，可以稍后继续 删除 Worktree：清理 worktree 和关联分支 保留但退出 tmux：（tmux 模式）保留 worktree 但关闭 tmux 会话 变更检测 退出前，CodeBuddy 会检测： 未提交的文件变更 未推送的提交 如果没有任何变更，worktree 会自动清理。 配置 在 中配置 worktree 行为: 配置项 配置项 说明 默认值 : : : 从主仓库符号链接到 worktree 的目录 符号链接目录可以避免在每个 worktree 中重复安装依赖,节省时间和磁盘空间。 同步本地忽略文件(.worktreeinclude) 、 等本地配置文件通常被 排除,但新 worktree 中同样需要它们才能正常运行。 解决方式:在仓库根目录创建 文件,列出需要复制的文件(语法与 相同): 每次创建新 worktree 时,这些文件会自动从主仓库根目录复制过去。复用已有 worktree 时不会重新复制。 提示: 应该提交到 Git,这样团队成员都能受益。 Hook based Worktree 默认情况下，worktree 功能依赖 Git 内置的 命令。对于使用 SVN、Perforce 或没有版本控制的项目，可以通过配置 WorktreeCreate / WorktreeRemove hooks 来使用 worktree 隔离功能。 决策优先级 核心规则： Hook 优先于 Git：配置了 WorktreeCreate hook 后，即使在 Git 仓库中也走 hook，不走 创建失败不降级：WorktreeCreate hook 失败时不会回退到 git worktree，直接报错 删除失败不阻塞：WorktreeRemove hook 失败只记录警告，不阻止退出流程 配置方式 在 （项目级）或 （全局）中配置： 两个 hook 独立配置——可以只配 WorktreeCreate 不配 WorktreeRemove（此时退出时不会自动清理，会提示手动删除目录）。 输入数据（stdin） Hook 脚本通过 stdin 接收 JSON 格式的上下文数据。 WorktreeCreate 输入： 字段 说明 : : worktree 名称（用户指定或系统自动生成） 当前工作目录 当前会话 ID 对话记录文件路径 WorktreeRemove 输入： 字段 说明 : : 要删除的 worktree 绝对路径 输出与 Exit Code WorktreeCreate： stdout：必须输出创建好的"},{"id":"/cli/remote-control","title":"远程控制（Remote Control）","body":"远程控制（Remote Control） Beta：远程控制功能目前处于 Beta 阶段，功能和接口可能会在后续版本中发生变化。欢迎试用并反馈问题。 通过 Remote Control，您可以从手机、平板或任意浏览器远程访问本地运行的 CodeBuddy Code 会话。会话始终在您的本机执行，Web 界面只是一个远程窗口。 概述 Remote Control 在本地启动一个 Gateway 服务，通过 Cloudflare Tunnel 或局域网暴露一个 Web UI，让您可以从任何设备连接到正在运行的 CodeBuddy Code 会话。 使用 Remote Control，您可以： 远程使用完整的本地环境：文件系统、MCP 服务器、工具配置全部保持可用 通过 Web UI 与 Agent 交互：在浏览器中发送消息、查看对话、监控工具执行 从多设备接入：手机扫码即可连接，支持局域网和公网访问 通过终端管理会话：在终端和 Web 端同时工作，对话保持同步 前置条件 已安装并登录 CodeBuddy Code（运行 后使用 登录） 若需要公网访问，需安装 （可选） 启动远程控制 在 CodeBuddy Code 会话中使用 命令启动远程控制服务： 启动成功后，终端会显示连接信息： 连接方式 Gateway 启动后，有以下几种方式从其他设备连接： 扫描二维码：用手机扫描终端中显示的二维码，直接打开 Web UI 复制 Web UI 链接：将带有认证 token 的 URL 在任意浏览器中打开 局域网访问：同一网络中的设备可直接访问 Local 地址（如 ） 子命令 命令 说明 : : 启动 Gateway（默认带 Tunnel） 查看当前 Gateway 状态 停止 Gateway 重新生成认证 token 启动带 Tunnel 的 Gateway 网络模式 Gateway 支持两种网络模式，适应不同的使用场景： Tunnel 模式（默认） 通过 Cloudflare Quick Tunnel 自动分配一个临时公网域名（ ），无需任何额外配置即可从公网访问。 适用场景： 从外部网络（如手机移动网络）远程访问 不想配置端口转发或 VPN 需要安装 ： 局域网模式 当 未安装或 Tunnel 启动失败时，Gateway 自动回退到局域网模式。此模式下，仅同一网络中的设备可以访问。 默认监听端口： 监听地址：默认 （仅本机），可通过 监听所有网络接口 安全机制 认证 Gateway 启动时会自动生成一个随机密码（token），访问 Web UI 和 API 均需要通过认证。支持以下认证方式： 方式 说明 : : URL 参数 ，适合快速分享链接 Cookie 登录后自动设置，后续访问无需重复认证 Bearer Token ，适合 API 调用 密码可通过 命令重新生成。重新生成后，之前的密码立即失效。 登录限流 为防止暴力破解，认证中间件内置了登录限流机制： 每分钟最多允许 2 次失败尝试 每小时额外允许 12 次失败尝试 超出限制后将暂时拒绝登录请求 权限 通过远程控制执行的任务自动以 模式运行，即工具执行不需要逐一审批。这是因为远程场景下无法进行交互式审批。请确保仅将访问链接分享给受信任的人。 CORS 策略 Gateway 默认允许以下来源的跨域请求： 本地回环地址（ 、 、 ） Tunnel 分配的公网地址 通过 配置的额外来源 Web UI Web UI 提供了完整的 CodeBuddy Code 交互界面，包括： 对话界面：发送消息、查看 Agent 回复、监控工具调用 终端面板：内置 Web 终端，直接在浏览器中操作远程终端 实例管理：查看和管理多个 CodeBuddy Code 实例 主题切换：支持亮色/暗色主题 多语言：支持中英文界面切换 Web UI 基于 ACP（Agent Client Protocol）与本地 Agent 通信，保证了与终端交互完全一致的体验。 配置 Settings 配置 在 中可以配置 Gateway 相关选项： 配置键 说明 默认值 : : : 认证模式， 或 自定义密码。为空时首次启动自动生成 自动生成 额外允许的 CORS 来源列表 ACP 最大并发连接数 ACP Session Token 有效期（毫秒） （24 小时） 环境变量 环境变量 说明 : : 额外的 CORS 允许来源（逗号分隔） 实例管理 当您在多个项目目录中运行 CodeBuddy Code 时，每个实例会自动注册到本地实例注册表（ ）。Web UI 的实例管理面板可以查看所有活跃的实例，并在它们之间切换。 实例信息包括： 工作目录 本地/Tunnel 地址 操作系统和架构 启动时间和运行状态 第三方平台集成（We"},{"id":"/cli/web-ui","title":"Web UI","body":"Web UI CodeBuddy Code 提供内置的 Web UI，在浏览器中提供完整的交互界面。当您以 serve 模式启动或开启远程控制时，Web UI 自动可用。 概述 Web UI 提供与终端界面相同的核心能力，并针对浏览器进行了可视化布局优化： 对话：发送消息、查看对话、实时监控工具执行 终端：内嵌终端，支持分屏布局（最多 4 个面板） Workers：管理 CLI Worker 进程和 Daemon 守护进程 日志：独立日志查看器，支持多种日志类型和关键词搜索 远程控制：连接微信和企业微信渠道 监控：系统资源指标和各 Worker 进程级内存/运行时间指标 任务：浏览任务模版并创建定时任务 插件：管理插件安装和插件市场 设置：配置主题、语言、模型和权限模式 文档：浏览 CLI 文档，支持全文搜索 API 文档：查看交互式 Swagger UI，方便 HTTP API 探索 访问 Web UI 方式一：Serve 模式 使用 参数启动 CodeBuddy Code： 然后在浏览器中打开： 方式二：远程控制 在已有的 CodeBuddy Code 会话中启动 Gateway： 终端会显示二维码和 URL。用手机扫码或在浏览器中打开 URL。详见 文档。 认证方式 Web UI 支持两种认证模式： 模式 设置 说明 : : : 免认证（默认） 无需密码 密码认证 启动时终端显示密码 认证方式（以下任一方式均可）： URL 参数： — 通过 URL 自动登录 登录页面：输入终端显示的密码 Bearer Token： ，用于 API 访问 在 中配置： 功能详解 对话视图 默认视图，用于与 Agent 交互。核心功能： 富文本消息渲染：Markdown、语法高亮代码块、表格、图片 工具执行展示：内联查看工具调用、参数和结果 权限管理：在浏览器中直接批准或拒绝工具权限 问答面板：回答 Agent 的多选问题 任务进度：实时监控后台任务和 Team 进度 会话管理：新建对话、浏览历史、切换会话 终端视图 基于 xterm.js 的内嵌终端： 分屏布局：支持水平和垂直分屏，最多 4 个面板 独立会话：每个面板有独立的 PTY 会话 持久连接：终端会话在页面刷新后保持 自适应调整：窗口大小变化时面板自动调整 文档视图 在 Web UI 中直接浏览 CLI 文档： 全文搜索：基于 MiniSearch 搜索所有文档 多语言：自动跟随 UI 语言设置（中文/英文） 目录导航：根据文档标题自动生成，带滚动追踪 内部跳转：文档链接在查看器内导航（SPA 模式） API 文档：快速链接到 的交互式 Swagger UI 实例管理 管理多个 CodeBuddy Code 实例： 实例列表：查看所有运行中的实例及其工作目录和状态 快速切换：一键切换实例 手动添加：通过 URL 添加远程实例 隧道支持：通过 Cloudflare Tunnel 访问实例 设置 主题：浅色、深色或跟随系统（自动检测） 语言：中文、英文或跟随系统（自动检测） 模型：从可用选项中选择 AI 模型 权限模式：默认、接受编辑、跳过权限或规划模式 API 文档 HTTP 服务运行时，可在以下地址访问交互式 API 探索器： Swagger UI 提供以下功能： 浏览所有可用的 REST API 端点 查看请求/响应 Schema 直接在浏览器中测试 API 调用 在 下载 OpenAPI 3.1 规范 完整的 API 参考请见 。 移动端支持 Web UI 完全响应式，支持移动设备： 侧边栏：小屏幕上折叠为滑出式抽屉 PWA 支持：添加到主屏幕获得类原生应用体验 触控优化：所有交互针对触摸操作优化 扫码访问：终端扫码即可在手机上打开 快捷键 快捷键 操作 : : 发送消息 输入换行 停止运行中的 Agent 技术细节 框架：React 18 + Zustand 状态管理 通信：ACP 协议，基于 HTTP/SSE（非 WebSocket） 样式：Tailwind CSS + CSS 变量主题 终端：xterm.js + fit addon 搜索：MiniSearch 客户端全文搜索 Markdown：react markdown + remark gfm + 语法高亮 相关文档 — 通过 Gateway 和 Tunnel 启动 Web UI — 完整的 REST API 文档 — IDE 集成的 Agent Client Protocol — 配置选项"},{"id":"/cli/scheduled-tasks","title":"定时任务","body":"定时任务 CodeBuddy Code 支持在会话中创建和管理定时任务，可以按照设定的时间表重复执行指令，或者在未来某个时间点触发一次性操作。常见用途包括：定期检查构建状态、轮询任务完成情况、在特定时间点提醒自己等。 注意：定时任务是会话级别的。任务只在 CodeBuddy Code 运行期间有效，退出后自动清除。 创建一次性提醒 如果只需要在未来某个时间点提醒一次，可以直接用自然语言描述： 这类任务会在指定时间触发一次，执行完毕后自动删除。 任务执行机制 执行时机 任务只会在会话空闲时触发，即系统没有在处理其他请求的时候。如果正好在执行某个操作，触发时间会顺延到操作完成后。 时间偏移（Jitter） 系统会对任务的触发时间添加少量随机偏移，以避免大量任务同时执行带来的拥堵： 循环任务：最多延迟周期时长的 10%（上限 15 分钟） 一次性任务：对于整点和半点任务，最多提前 90 秒执行 例如，设置 执行的任务，实际触发时间可能在整点后的 0 6 分钟内随机分布。 自动过期 循环任务在创建 3 天后自动过期删除，过期前会最后触发一次。 如果需要任务持续更长时间，可以在过期后重新创建，或者改用外部调度方案（如 GitHub Actions 等）。 Cron 表达式参考 需要「每周一早上 10 点」「每月 1 号」这类精确时间，直接告诉 AI 你的需求，它会自动转成 cron 表达式并创建任务： AI 回复时会告诉你实际使用的 cron 表达式和执行频率，方便确认是否符合预期。 格式： 常用表达式： 表达式 含义 每 5 分钟 每 15 分钟 每小时整点 每天上午 9 点 工作日上午 9 点 每月 1 日午夜 每周五下午 6:30 字段说明： 字段 取值范围 特殊符号 分钟 0–59 （任意）、 （每 N 分钟）、 （列举）、 （范围） 小时 0–23 同上 日期 1–31 同上 月份 1–12 同上 周几 0–6 0 或 7 = 周日，1 = 周一，依此类推 注意事项 事项 说明 会话绑定 任务随会话存在，CodeBuddy Code 退出后任务消失，不会写入磁盘 循环任务上限 每个会话最多同时存在 50 个定时任务 最小间隔 1 分钟（秒级设置会被自动向上取整） 任务过期 循环任务 3 天后自动清除 不补跑 会话中断期间错过的任务不会补发执行 禁用定时任务 如果需要完全关闭定时任务功能，可以设置环境变量： 启用后， 技能不再可用， 、 、 工具也会被禁用。 相关文档"},{"id":"/cli/wecom-bot-setup","title":"企业微信智能机器人接入指南","body":"企业微信智能机器人接入指南 通过 命令，您可以将 CodeBuddy Code 快速接入企业微信智能机器人，实现远程消息驱动。采用 WebSocket 长连接 主动连接方式，无需公网 IP，配置最为简洁。 前置条件 已注册企业微信账户 CodeBuddy Code 已安装： 已完成登录认证： 后执行 2. 配置环境变量 在启动 CodeBuddy CLI 前，设置以下环境变量： 可选配置 环境变量 说明 默认值 AI Bot ID（必填） — AI Bot Secret（必填） — WebSocket 服务地址（私有化部署时使用） 持久化配置（可选） 将环境变量添加到 shell 启动文件中，每次启动时自动生效： 4. 面板操作说明 操作 说明 / 选择客户端条目 / Vim 风格导航（等同于上下方向键） 连接（ 状态）或断开（ / 状态） 退出面板（操作进行中时不响应） 5. 验证接入 连接建立后，可通过以下方式验证 Bot 是否正常工作。 方式一：直接对话 1. 打开企业微信客户端（桌面端或移动端） 2. 在消息列表中找到你创建的机器人 3. 发送测试消息（如「你好」），确认 Bot 有回复 方式二：群组对话 1. 将机器人添加到群聊 2. 在群组中通过 @机器人名称 发送消息 3. Bot 会响应被 @ 的消息 6. 消息处理流程和状态指示 消息处理全流程 用户发送消息到 Bot 后的处理流程： 流式状态指示机制 利用企微流式消息（ stream 类型）的全量替换特性： 1. 立即回复：收到用户消息后，立即发送 的流式消息，内容为\"正在处理，请稍候...\" 2. 原位替换：Agent 处理完成后，用同一个 发送 + 最终结果 3. 企微客户端收到 后，用全量内容替换之前显示的\"正在处理...\" 参考： —— stream.content 为全量内容，每次发送替换上一次的显示。 用户看到的效果 阶段 聊天窗口显示 说明 消息发送后 \"正在处理，请稍候...\" 流式消息占位，表示 Bot 正在处理 处理完成后 最终回复内容 \"正在处理...\"被最终结果原位替换 与之前方案的区别 方面 旧方案（文本消息 ack） 新方案（流式消息替换） \"正在处理...\" 永久保留在聊天记录 被最终结果原位替换 聊天记录 2 条消息（ack + 结果） 1 条消息（仅最终结果） 状态指示 有 有 超时处理 流式消息超时：6 分钟（从首次发送 stream 开始计时） 安全超时：5 分钟（预留 1 分钟余量） 超时回退：如果 Agent 处理超过 5 分钟，自动回退到异步推送（ ，24 小时有效期） 回调超时：收到消息回调后需在 5 秒内发送回复（流式占位消息满足此要求） 7. 工作原理 关键特性 连接方式：WebSocket 长连接（客户端主动连接，无需公网 IP） 认证机制：启动时发送 帧，携带 + 完成鉴权 消息接收：企业微信服务器通过 帧实时推送用户消息 消息回复：通过 帧以流式方式返回 Agent 回复 心跳保活：每 30 秒发送一次 帧保持连接活跃 自动重连：连接断开后按指数退避策略自动重连，最长延迟 60 秒 8. 常见问题 环境变量未配置 症状：在 面板中选择 后显示错误 解决方案： 1. 确认已设置 和 2. 执行 验证环境变量是否生效 3. 重新启动 CodeBuddy CLI 4. 再次执行 尝试连接 连接失败 可能原因及排查： 1. Bot ID 或 Secret 错误 确认从企业微信后台复制的值完全一致（注意末尾是否有空格） 确认 AI Bot 应用状态正常，未被停用 2. 网络连接问题 检查是否能访问 如使用私有化部署，确认 设置正确 尝试在浏览器中测试网络连接： 3. CLI 日志查看 查看终端输出的错误日志 执行 后保持在主界面，观察连接过程中的输出 连接后消息无响应 排查步骤： 1. 执行 确认 状态为 2. 如状态为 ，重新连接 3. 检查 CLI 终端日志是否有错误信息 4. 确认 CodeBuddy CLI 进程仍在运行（未被中断或退出） CLI 重启后需要重新连接 连接状态是临时的，不会持久化。每次重启 CodeBuddy CLI 后，需要重新执行 并选择 建立连接。 自动连接方案（如需每次启动自动连接）： 将以下内容添加到启动脚本或 shell 配置文件中： 其中 参数表示启动时自动执行指定命令。 应用提示\"Token 过期\"或\"Secret 无效\" 这通常表示 Bot 的 Secret 已失效或被重新生成。解决方案： 1. 登录企业微信管理后台，进入 Bot 详情页 2. 在「API 配置」区域重新生成 Secret 3. 更新环境变量 4. 重启 CodeBuddy CLI 并重新连接 相关文档 "},{"id":"/cli/channels","title":"Channels：将外部事件推送到会话中 [Beta]","body":"Channels：将外部事件推送到会话中 [Beta] Beta 功能：Channels 目前处于 Beta 阶段，功能和接口可能会根据反馈进行调整。 Channel 是一种 MCP 服务器，可以将消息、告警和 Webhook 推送到你正在运行的 CodeBuddy Code 会话中，让 CodeBuddy Code 在你不在终端时也能对外部事件做出反应。 Channel 可以是双向的：CodeBuddy Code 读取事件后通过同一 channel 回复，就像一个聊天桥。事件仅在会话打开时到达，如需持续运行，可以在后台进程或持久终端中运行 CodeBuddy Code。 你可以通过安装插件或使用内置 channel 来启用。微信、Telegram、Discord 以及 fakechat 演示都已支持。 当 CodeBuddy Code 通过 channel 回复时，终端会显示工具调用和确认（如\"sent\"），实际回复内容出现在对应的聊天平台上。 本页涵盖： ：微信、Telegram、Discord 以及 fakechat 设置 ：使用微信 channel 快速体验 ：发送者白名单和配对流程 ：为团队和企业启用 channel 要构建自己的 channel，请参阅 。 支持的 Channel 微信（内置） 微信 channel 是 CodeBuddy Code 内置的，无需安装插件。通过微信 ClawBot 实现双向消息通信，支持文本、图片和文件收发。 前提条件： 微信版本 iOS 8.0.70 及以上 在微信中启用 ClawBot 插件（微信 → 我 → 设置 → 插件 → ClawBot） 扫码绑定： 1. 在 CodeBuddy Code 中执行 或 选择 wechat 2. 终端显示二维码（如果二维码显示异常，会提供浏览器链接） 3. 用微信扫描二维码并确认 4. 绑定成功后自动开始接收消息 使用： 绑定后，在微信 ClawBot 对话中发送消息，消息会自动出现在 CodeBuddy Code 会话中： CodeBuddy Code 会处理消息并通过 工具回复，回复内容出现在微信中。 支持的消息类型： 类型 接收 发送 文本 支持 支持 图片 支持（自动下载解密到本地） 支持（自动加密上传到 CDN） 文件 支持 支持 凭证管理： 扫码成功后凭证保存在 。下次启动时自动使用已保存的凭证，无需重新扫码。 Telegram 需要安装插件。查看完整 。 1. 在 Telegram 中通过 创建一个 bot，获取 token 2. 安装插件： 3. 配置 token： 4. 启动： 5. 向 bot 发消息获取配对码，执行 完成配对 Discord 需要安装插件。查看完整 。 1. 在 创建应用和 bot 2. 启用 Message Content Intent，邀请 bot 到服务器 3. 安装插件： 4. 配置 token： 5. 启动： 6. DM bot 获取配对码，执行 完成配对 fakechat（演示） fakechat 是官方支持的演示 channel，在 localhost 上运行一个聊天 UI，无需认证和外部服务。 打开 即可开始聊天。 快速开始 以微信 channel 为例，快速体验完整的双向通信流程： 第 1 步：确保 ClawBot 已启用 在微信中打开 我 → 设置 → 插件，找到 ClawBot 并启用。 第 2 步：扫码绑定 启动 CodeBuddy Code，执行： 终端显示二维码。用微信扫描并确认绑定。 第 3 步：发送消息 在微信 ClawBot 对话中发送： 消息到达 CodeBuddy Code 会话，显示为： CodeBuddy Code 执行任务后通过 工具回复，回复内容出现在微信中。 第 4 步：发送图片 在微信中发一张截图给 ClawBot，CodeBuddy Code 会自动下载并识别图片内容。你可以要求它编辑图片并发回： CodeBuddy Code 使用 ImageEdit 工具处理图片，然后通过 将编辑后的图片发送回微信。 安全机制 微信 微信 channel 通过 ClawBot 的扫码认证机制保证安全。只有扫码绑定的微信账号可以发送消息，其他人的消息会被静默丢弃。 凭证（包含 bottoken 和 accountid）保存在本地，权限设为 600（仅所有者可读写）。 插件 Channel Telegram 和 Discord 等插件 channel 维护一个发送者白名单。通过配对流程添加信任的发送者： 1. 向 bot 发送任意消息 2. bot 回复配对码 3. 在 CodeBuddy Code 中确认配对码 4. 发送者 ID 加入白名单 白名单同时控制 。通过 "},{"id":"/cli/daemon","title":"Daemon 模式与后台会话","body":"Daemon 模式与后台会话 Daemon 模式让 CodeBuddy Code 以后台常驻服务的方式运行，不依赖终端窗口。启动后提供完整的 HTTP API 和 Web UI，随时接受请求。 核心价值：把 CLI 从\"用完即走\"变成\"随时待命\"。 概念 概念 说明 Worker 运行中的 CLI 进程，通过 PID 文件注册在 Daemon 后台常驻的 HTTP 服务进程（ 模式），通过 管理 后台会话 (bg) 通过 启动的非交互式任务，自动输出日志到文件 Daemon 管理 启动 Daemon Daemon 启动后以 detached 进程运行，父进程立即退出。本地地址默认免密访问，非本地地址自动开启密码认证。 幂等启动：多次执行 不会创建多个 daemon。如果已有 daemon 在运行，会直接返回现有 daemon 的信息。 查看状态 停止 / 重启 后台会话 启动后台任务 后台会话以 模式运行（无 TUI + 跳过权限确认），stdout/stderr 重定向到 。 进程管理命令 HTTP API 所有 Worker 和 Daemon 管理能力通过 REST API 暴露，Web UI 的 Workers 页面基于这些 API 构建。 详见 中的 Workers & Daemon 章节。 示例 Web UI 模式启动后，Web UI 提供三个管理页面： Workers — Worker 进程管理和 Daemon 控制 Logs — 独立日志查看器，支持 Worker 选择、日志类型切换、关键词搜索 Metrics — 系统资源监控和各 Worker 进程级指标 日志体系 日志 API 支持 4 种类型，按优先级自动选择： 类型 路径 内容 触发条件 所有模块的 Info/Warn/Error 始终（默认优先） 进程 stdout/stderr 仅 bg/daemon 详细调试信息 需 对话历史 始终 PID 文件注册表 每个 CLI 进程启动时在 注册 PID 文件： PID 文件内容： 进程存活通过 检测，手动远程 Worker 通过心跳超时检测（2 分钟）。 环境变量 变量 说明 Worker 类型（interactive / bg / daemon） 后台会话显示名称 后台会话日志路径 认证模式（none / password） 使用场景 开发服务器常驻 日常开发时启动一次 daemon，之后通过浏览器或 API 随时与 AI 交互，不用每次都打开终端。 CI/CD 自动化后端 在 CI 流水线中启动 daemon 作为 Agent 服务，其他步骤通过 HTTP API 调用它执行代码审查、测试生成等任务。 多人共享 Agent 一台开发机上启动 daemon 绑定局域网地址，团队成员通过 Web UI 共同使用同一个 Agent 环境。 后台批量任务 用 同时启动多个后台会话处理不同任务，通过 / / 管理。 微信/企业微信机器人后端 daemon 常驻运行作为聊天机器人的后端服务，通过长连接接收消息。 IDE 扩展后端 IDE 插件通过 ACP 协议连接到 daemon，提供 AI 编程辅助，避免每次打开 IDE 都重新启动 CLI 进程。 与 serve 的区别 特性 生命周期 跟随终端，关闭终端则退出 后台常驻，独立于终端 启动方式 前台运行 fork detached 子进程 管理方式 Ctrl+C 停止 多次启动 每次创建新进程 幂等，只维护一个 daemon 典型用途 临时开发调试 长期运行的服务"},{"id":"/cli/security","title":"安全","body":"安全 了解 CodeBuddy Code 的安全防护措施和安全使用最佳实践。 安全方法 安全基础 您的代码安全至关重要。CodeBuddy Code 将安全作为核心构建，遵循腾讯的全面安全计划开发。 基于权限的架构 CodeBuddy Code 默认使用严格的只读权限。当需要额外操作（编辑文件、运行测试、执行命令）时，CodeBuddy Code 会请求明确的权限。用户可以控制是一次性批准操作还是自动允许。 我们将 CodeBuddy Code 设计得透明且安全。例如，我们在执行 bash 命令之前需要批准，让您拥有直接控制权。这种方法使用户和组织能够直接配置权限。 有关详细的权限配置，请参阅 。 内置保护 为了降低智能代理系统中的风险： 沙箱化 bash 工具: 隔离 bash 命令的文件系统和网络访问，减少权限提示的同时保持安全性。使用 启用以定义 CodeBuddy Code 可以自主工作的边界 写入访问限制: CodeBuddy Code 只能写入其启动的文件夹及其子文件夹——没有明确权限不能修改父目录中的文件。虽然 CodeBuddy Code 可以读取工作目录外的文件（对访问系统库和依赖项很有用）,但写入操作严格限制在项目范围内，创建了清晰的安全边界 提示疲劳缓解：支持按用户、按代码库或按组织将频繁使用的安全命令加入白名单 接受编辑模式：批量接受多个编辑，同时保持对具有副作用的命令的权限提示 用户责任 CodeBuddy Code 只拥有您授予它的权限。您有责任在批准之前审查建议的代码和命令的安全性。 防范提示注入 提示注入是一种攻击技术，攻击者试图通过插入恶意文本来覆盖或操纵 AI 助手的指令。CodeBuddy Code 包含多种针对这些攻击的防护措施： 核心保护 权限系统：敏感操作需要明确批准 上下文感知分析：通过分析完整请求检测潜在有害指令 输入清理：通过处理用户输入防止命令注入 命令阻止列表：默认阻止从网络获取任意内容的风险命令，如 和 。当明确允许时，请注意 隐私保护 我们实施了多项保护措施来保护您的数据，包括： 敏感信息的有限保留期 限制访问用户会话数据 有关完整详情,请查看我们的 和 。 额外保护措施 网络请求批准：发出网络请求的工具默认需要用户批准 隔离的上下文窗口: Web 获取使用单独的上下文窗口，以避免注入潜在的恶意提示 信任验证：首次运行代码库和新的 MCP 服务器需要信任验证 注意： 使用 标志非交互式运行时，信任验证被禁用 命令注入检测：可疑的 bash 命令即使之前已加入白名单也需要手动批准 失败关闭匹配：不匹配的命令默认需要手动批准 自然语言描述：复杂的 bash 命令包含解释以便用户理解 安全凭据存储: API 密钥和令牌经过加密。参见 <Warning Windows WebDAV 安全风险: 在 Windows 上运行 CodeBuddy Code 时,我们建议不要启用 WebDAV 或允许 CodeBuddy Code 访问可能包含 WebDAV 子目录的路径,如 。 %20service%20is%20deprecated)由于安全风险。启用 WebDAV 可能允许 CodeBuddy Code 触发对远程主机的网络请求,绕过权限系统。 </Warning 处理不受信任内容的最佳实践: 1. 批准前审查建议的命令 2. 避免将不受信任的内容直接传输到 CodeBuddy 3. 验证对关键文件的建议更改 4. 使用虚拟机(VM)运行脚本和进行工具调用，特别是在与外部 Web 服务交互时 <Warning 虽然这些保护措施显著降低了风险，但没有系统能完全免疫所有攻击。在使用任何 AI 工具时，始终保持良好的安全实践。 </Warning MCP 安全 CodeBuddy Code 允许用户配置模型上下文协议(MCP)服务器。允许的 MCP 服务器列表在源代码中配置，作为工程师检入源代码控制的 CodeBuddy Code 设置的一部分。 我们鼓励编写您自己的 MCP 服务器或使用您信任的提供商的 MCP 服务器。您可以为 MCP 服务器配置 CodeBuddy Code 权限。CodeBuddy 不管理或审计任何 MCP 服务器。 详见 。 沙箱安全 CodeBuddy Code 支持 Bash 沙箱功能，将 bash 命令与您的文件系统和网络隔离： 沙箱隔离级别 文件系统隔离：通过 Read/Edit 权限控制文件访问 网络隔离：通过 WebFetch 权限控制网络访问 命令隔离：某些命令可以配置为在沙箱外运行 沙箱配置 沙箱限制 平台支持：目前仅支持 macOS 和 Linux 性能影响：沙箱化可能略微影响命令执行性能 兼容性：某些工具可能在沙箱中无法正常工作 详见 了解"},{"id":"/cli/iam","title":"身份和访问管理","body":"身份和访问管理 了解如何为组织中的 CodeBuddy Code 配置用户身份验证、授权和访问控制。 认证方法 快速开始 根据你的场景选择认证方式： 场景 推荐方式 如何获取凭据 : : : 个人开发者 企业/团队（OAuth 集成） CI/CD 已有 OAuth token 直接使用已有 token 第三方模型服务 + 从第三方服务商获取 当多个认证方式同时配置时，按以下优先级生效：CODEBUDDYAUTHTOKEN apiKeyHelper CODEBUDDYAPIKEY 企业用户：OAuth 认证 适用于企业/团队集成，通过 OAuth 2.0 获取 token。 目前仅介绍 Client Credentials 授权方式，适用于服务端应用和 CI/CD 场景。 前提条件：企业用户需要先购买 CodeBuddy 旗舰版才能使用 OAuth 认证。详见 。 第 1 步：创建应用，获取 Client ID 和 Secret 参考 完成： 1. 创建企业应用 2. 获取 Client ID 和 Client Secret 第 2 步：创建获取 token 的脚本 第 3 步：配置 apiKeyHelper 在 或项目 中配置： 配置完成后即可使用 命令。 apiKeyHelper 获取的 token 默认缓存 5 分钟，可通过 环境变量调整（单位：毫秒）。 认证方式详解 CODEBUDDYAPIKEY 静态 API Key，适用于大部分场景。 特性 说明 : : 环境变量 认证类型 API Key（X Api Key 请求头） 适用场景 个人开发、第三方模型服务 ⚠️ 注意：使用 API Key 时，必须同时配置 环境变量！ 版本 配置值 : : 海外版 不设置（默认） 中国版 iOA 版 CODEBUDDYAUTHTOKEN 已获取的 OAuth Bearer Token，适用于 CI/CD 或已有 token 的场景。 特性 说明 : : 环境变量 认证类型 Bearer Token（Authorization 请求头） 适用场景 CI/CD 自动化、已有 OAuth token 也可以在 settings.json 中配置： apiKeyHelper 通过脚本动态获取 token，适用于 OAuth 集成或需要定期刷新 token 的场景。 特性 说明 : : 配置方式 settings.json 的 字段 认证类型 Bearer Token（由脚本返回） 缓存机制 默认 5 分钟，可通过 配置 适用场景 OAuth Client Credentials、Vault 集成、token 自动刷新 脚本要求： 将 token 输出到标准输出（stdout） 以退出码 0 表示成功 脚本执行超时时间为 30 秒 配置示例： 从 Vault 获取 token 示例： 详细的认证配置请参考 。 访问控制和权限 我们支持细粒度权限，以便您可以精确指定代理允许执行的操作（例如运行测试、运行 linter)和不允许执行的操作（例如更新云基础设施）。这些权限设置可以检入版本控制并分发给组织中的所有开发人员，也可以由各个开发人员自定义。 权限系统 CodeBuddy Code 使用分层权限系统来平衡功能和安全性： 工具类型 示例 需要批准 \"是，不再询问\"行为 : : : : 只读 文件读取、LS、Grep 否 N/A Bash 命令 Shell 执行 是 按项目目录和命令永久记住 文件修改 编辑/写入文件 是 会话结束前有效 配置权限 您可以使用 查看和管理 CodeBuddy Code 的工具权限。此 UI 列出所有权限规则及其来源的 settings.json 文件。 Allow 规则将允许 CodeBuddy Code 使用指定的工具，无需进一步手动批准。 Ask 规则将在 CodeBuddy Code 尝试使用指定工具时询问用户确认。Ask 规则优先于 allow 规则。 Deny 规则将阻止 CodeBuddy Code 使用指定工具。Deny 规则优先于 allow 和 ask 规则。 Additional directories 将 CodeBuddy 的文件访问扩展到初始工作目录之外的目录。 Default mode 控制 CodeBuddy 在遇到新请求时的权限行为。 权限规则使用格式： 或 仅工具名称的规则匹配该工具的任何使用。例如，将 添加到 allow 规则列表将允许 CodeBuddy Code 使用 Bash 工具而无需用户批准。 权限模式 CodeBuddy Code 支持几种权限模式，可以在 中设置为 : 模式 描述 : : 标准行为 首次使用每个工具时提示权限 自动接受会话的文件编辑权限 计划模式 Co"},{"id":"/cli/bash-sandboxing","title":"Bash 沙箱","body":"Bash 沙箱 了解 CodeBuddy Code 的沙箱化 Bash 工具如何提供文件系统和网络隔离，实现更安全、更自主的智能体执行。 概述 CodeBuddy Code 具有原生沙箱功能，为智能体执行提供更安全的环境，同时减少持续的权限提示。沙箱不需要为每个 bash 命令请求权限，而是预先创建定义好的边界，让 CodeBuddy Code 可以在降低风险的情况下更自由地工作。 沙箱化 Bash 工具使用操作系统级原语来强制执行文件系统和网络隔离。 为什么沙箱很重要 传统的基于权限的安全性需要持续的用户批准才能执行 bash 命令。虽然这提供了控制，但可能导致： 审批疲劳：重复点击\"批准\"可能导致用户对批准的内容关注度降低 降低生产力：持续的中断会减慢开发工作流程 有限的自主性：在等待批准时，CodeBuddy Code 无法高效工作 沙箱通过以下方式解决这些挑战： 1. 定义清晰的边界：明确指定 CodeBuddy Code 可以访问哪些目录和网络主机 2. 减少权限提示：沙箱内的安全命令不需要批准 3. 保持安全性：访问沙箱外资源的尝试会立即触发通知 4. 实现自主性: CodeBuddy Code 可以在定义的限制内更独立地运行 <Warning 有效的沙箱需要同时具备文件系统和网络隔离。没有网络隔离，受损的智能体可能会窃取敏感文件（如 SSH 密钥）。没有文件系统隔离，受损的智能体可能会后门系统资源以获得网络访问。配置沙箱时，确保你的配置设置不会在这些系统中创建绕过方式非常重要。 </Warning 工作原理 文件系统隔离 沙箱化 Bash 工具将文件系统访问限制在特定目录： 默认写入行为：对当前工作目录及其子目录具有读写访问权限 默认读取行为：对整个计算机具有读取访问权限，除了某些被拒绝的目录 阻止访问：未经明确许可，无法修改当前工作目录之外的文件 可配置：通过设置定义自定义的允许和拒绝路径 网络隔离 网络访问通过在沙箱外运行的代理服务器控制： 域限制：只能访问批准的域 用户确认：新的域请求会触发权限提示 自定义代理支持：高级用户可以对出站流量实施自定义规则 全面覆盖：限制适用于命令生成的所有脚本、程序和子进程 操作系统级强制执行 沙箱化 Bash 工具利用操作系统安全原语： Linux: 使用 进行隔离 macOS：使用 Seatbelt 进行沙箱强制执行 这些操作系统级限制确保 CodeBuddy Code 命令生成的所有子进程都继承相同的安全边界。 入门 启用沙箱 你可以通过运行 斜杠命令来启用沙箱： 这将使用默认设置激活沙箱化 Bash 工具，允许访问当前工作目录，同时阻止访问敏感的系统位置。 配置沙箱 通过 文件自定义沙箱行为。完整的配置参考请参阅 。 <Tip 并非所有命令都能开箱即用地与沙箱兼容。以下一些注意事项可能帮助你充分利用沙箱： 许多 CLI 工具需要访问某些主机。当你使用这些工具时，它们会请求访问某些主机的权限。授予权限将允许它们现在和将来访问这些主机，使它们能够在沙箱内安全执行。 与在沙箱中运行不兼容。如果你正在运行 ,请考虑使用 与在沙箱中运行不兼容。考虑在 中指定 以强制其在沙箱外运行。 </Tip <Note CodeBuddy Code 包含一个有意设置的逃生舱机制，允许在必要时在沙箱外运行命令。当命令因沙箱限制（如网络连接问题或不兼容的工具）而失败时，CodeBuddy 会被提示分析失败，并可能使用 参数重试命令。使用此参数的命令会经过正常的 CodeBuddy Code 权限流程，需要用户权限才能执行。这允许 CodeBuddy Code 处理某些工具或网络操作无法在沙箱约束内运行的边缘情况。 你可以通过在 中设置 来禁用此逃生舱。禁用后, 参数会被完全忽略,所有命令必须在沙箱中运行或明确列在 中。 </Note 沙箱自动批准 在 AcceptEdits 权限模式下，CodeBuddy Code 提供了沙箱自动批准功能，进一步减少权限提示： 工作原理 当启用沙箱自动批准时，满足以下所有条件的 Bash 命令将自动批准执行，无需用户确认： 1. 当前处于 AcceptEdits 权限模式 2. 沙箱已启用 ( ) 3. 自动批准配置已开启 ( ) 4. 命令将在沙箱中运行 （不在 列表中） 5. 未使用 dangerouslyDisableSandbox 参数 配置示例 在 中启用沙箱自动批准： 使用场景 自动批准 （无需用户确认）: 需要批准 （以下情况仍需用户确认）: 安全保障 沙箱自动批准在保持安全的同时提升效率： ✅ 只在沙箱环境内：只有沙箱化的命令才能自动批准 ✅ 文件系统隔离：命令只能访问允许的目录 ✅ 网络隔离：命令只能访问批准的域名 ✅ 可配置边界：通过 排除高"},{"id":"/cli/cli-reference","title":"CLI 参考","body":"CLI 参考 CodeBuddy Code 命令行工具完整参考手册，包含所有命令和参数说明。 CLI 命令 命令 说明 示例 : : : 启动交互式 REPL 带初始提示词启动 REPL 通过 SDK 查询后退出 处理管道内容 继续最近的对话 通过 SDK 继续对话 通过 ID 恢复会话 更新到最新版本 配置 Model Context Protocol (MCP) 服务器 参见 启动 Daemon 守护进程 停止 Daemon 查看 Daemon 状态 重启 Daemon 列出所有活跃 Worker 进程 查看 Worker 日志 附加到后台 Worker 终止 Worker 进程 CLI 参数 自定义 CodeBuddy Code 行为的命令行参数： 参数 说明 示例 : : : 添加额外的工作目录供 CodeBuddy 访问（验证每个路径是否存在） 通过 JSON 动态定义自定义 （格式见下文） 除了 外,无需提示用户即可允许的工具列表 除了 外,应禁止使用的工具列表 限制可用的内置工具集（白名单）。空字符串 禁用所有内置工具， 使用全部工具，或指定逗号分隔的工具名 , 打印响应后退出,不进入交互模式 从 JSON 文件或 JSON 字符串加载额外的设置配置 指定要加载的设置源,逗号分隔（可选值: , , ）。默认: 用自定义文本替换整个系统提示词（在交互和打印模式下都可用） 从文件加载系统提示词,替换默认提示词(仅打印模式) 在默认系统提示词末尾追加自定义文本（在交互和打印模式下都可用） 指定打印模式的输出格式(选项: , , ) 指定打印模式的输入格式(选项: , ) 使用 JSON Schema 验证结构化输出。示例: 在输出中包含部分流式事件（需要 和 ) 启用详细日志记录,显示完整的轮次输出(在打印和交互模式下都有助于调试) 限制非交互模式下的代理轮次数 使用别名设置当前会话的模型，如最新模型的别名（ 或 ）或模型全名 设置文生图功能使用的模型 ID 设置图生图功能使用的模型 ID 以指定的 开始 指定在非交互模式下处理权限提示的 MCP 工具 通过 ID 恢复特定会话,或在交互模式下选择 加载当前目录中最近的对话 / 跳过权限提示（谨慎使用） 或 启动时自动连接到 IDE（如果恰好有一个有效的 IDE 可用且打开了当前工作目录） 在沙箱中运行 CodeBuddy（详见下方 ) 启用调试模式,支持可选的类别过滤 在独立的 git worktree 中运行（详见 ） 或 在 tmux 会话中运行（与 配合使用） 从本地目录加载插件（用于开发/测试），可指定多个路径。详见 后台运行会话（detached 模式），日志输出到 。详见 后台会话名称（与 配合使用，便于通过 / / 查找） 启动 HTTP 服务（Web UI、REST API、ACP 协议） 重要提示：在使用 参数进行非交互式执行时,涉及文件读写、命令执行、网络请求等操作通常需要添加 （或 )参数才能执行，否则操作会被阻止。 <Tip 参数特别适用于脚本和自动化，允许您以编程方式解析 CodeBuddy 的响应。 </Tip Agents 参数格式 参数接受定义一个或多个自定义子代理的 JSON 对象。每个子代理需要一个唯一的名称（作为键）和一个包含以下字段的定义对象： 字段 必需 说明 : : : 是 何时应调用子代理的自然语言描述 是 指导子代理行为的系统提示词 否 子代理可以使用的特定工具数组（如 )。省略则继承所有工具 否 要使用的模型别名: 、 或 。省略则使用默认子代理模型 示例： 有关创建和使用子代理的更多详细信息，请参见 。 系统提示词参数 CodeBuddy Code 提供三个自定义系统提示词的参数，每个参数用途不同： 参数 行为 模式 使用场景 : : : : 替换整个默认提示词 交互 + 打印模式 完全控制 CodeBuddy 的行为和指令 用文件内容替换 仅打印模式 从文件加载提示词以确保可重现性和版本控制 追加到默认提示词 交互 + 打印模式 添加特定指令同时保留默认 CodeBuddy Code 行为 何时使用： ：当您需要完全控制 CodeBuddy 的系统提示词时使用。这会移除所有默认 CodeBuddy Code 指令，给您一个空白画布。 ：当您想从文件加载自定义提示词时使用，适用于团队一致性或版本控制的提示词模板。 ：当您想添加特定指令同时保留 CodeBuddy Code 的默认功能时使用。这是大多数用例的最安全选项。 <Note 和 互斥。不能同时使用这两个参数。 </Note <Tip 对于大多数用例，建议使用 ,因为它在添加自定义需求的同时保留了 CodeBuddy Code 的内置功能。仅当需要完全控制系统提"},{"id":"/cli/hooks","title":"Hook 参考指南","body":"Hook 参考指南 版本要求：本文档针对 CodeBuddy Code v1.16.0 及以上版本中提供的 Claude Code Hooks 兼容实现。 功能状态：Hook 功能当前处于 Beta 阶段，接口和行为可能在未来版本中调整。 Hook（钩子）允许你在 CodeBuddy Code 的会话生命周期内插入自定义脚本或命令，实现自动化校验、环境初始化、合规检查等高级能力。我们的实现完全兼容 Claude Code Hooks 规范，支持相同的事件类型、输入输出结构以及安全特性。 配置 CodeBuddy Code hooks 存储在你的设置文件中： 作用域 文件路径 说明 用户级 适用于所有项目 项目级 对项目成员共享的配置 项目本地 本地未提交配置 企业策略 集成发布的策略文件 受企业统一管理 配置合并规则：来自不同作用域的 hooks 会合并而非覆盖。同一事件的所有匹配 hooks 都会并行执行。 结构 Hooks 按匹配器组织，每个匹配器可以有多个 hooks: 关键字段： matcher：用于匹配工具名称的正则表达式模式，区分大小写（仅适用于 PreToolUse 和 PostToolUse) 简单字符串匹配： 会匹配任何包含 \"Write\" 的工具名（如 、 ） 精确匹配：使用 仅匹配 Write 工具 多工具匹配： 或 匹配所有工具：以下三种方式等效 使用 字符 使用空字符串 省略 matcher 字段 hooks：当模式匹配时执行的 hooks 数组 type: Hook 执行类型 用于 shell 命令，或 用于基于 LLM 的评估 command: （对于 type: ）要执行的 shell 命令（可以使用 环境变量）。在 macOS/Linux 上使用用户默认 shell（ ）执行，在 Windows 上强制使用 Git Bash 执行（不支持 cmd.exe 或 PowerShell），因此命令需兼容 bash 语法 prompt: （对于 type: ）发送给 LLM 进行评估的提示词（仅支持 、 、 事件） timeout: （可选）hook 运行多长时间（以秒为单位）后取消该特定 hook 对于不使用匹配器的事件（如 UserPromptSubmit、Stop 和 SubagentStop)，你可以省略 matcher 字段： 项目特定的 Hook 脚本 你可以使用环境变量 （仅在 CodeBuddy Code 生成 hook 命令时可用）来引用存储在项目中的脚本： 提示：如果你的 hook 脚本是 Python 文件，请显式使用 来调用，而不是直接执行 文件。因为在 Windows 上即使脚本包含 shebang 行（ ），Git Bash 也不一定能正确识别： 插件 Hooks 插件可以提供与用户和项目 hooks 无缝集成的 hooks。启用插件时，插件 hooks 会自动与你的配置合并。 插件 hooks 的工作方式： 插件 hooks 在插件的 文件中定义，或在 hooks 字段提供的自定义路径的文件中定义 当插件启用时，其 hooks 会与用户和项目 hooks 合并 来自不同来源的多个 hooks 可以响应同一事件 插件 hooks 使用 环境变量来引用插件文件 插件 hook 配置示例： 基于提示词的 Hooks 除了 bash 命令 hooks（ ），CodeBuddy Code 还支持基于提示词的 hooks（ ），使用 LLM 来评估是否允许或阻止某个操作。 支持的事件：目前仅支持 、 和 三种事件。 基于提示词的 hooks 如何工作 基于提示词的 hooks 不是执行 bash 命令，而是： 1. 将 hook 输入和你的提示词发送给快速 LLM（Haiku） 2. LLM 使用包含决策的结构化 JSON 响应 3. CodeBuddy Code 自动处理决策 支持的事件 事件 用途 智能决定 CodeBuddy 是否应继续工作 使用 LLM 协助验证用户提示 做出上下文感知的权限决策 与 Command Hook 的比较 特性 Command Hooks Prompt Hooks 执行方式 运行 bash 脚本 查询 LLM 决策逻辑 你在代码中实现 LLM 评估上下文 设置复杂性 需要脚本文件 只需配置提示词 上下文感知 受脚本逻辑限制 自然语言理解 性能 快速（本地执行） 较慢（API 调用） 适用场景 确定性规则 上下文感知决策 配置 字段： type：必须为 prompt：发送给 LLM 的提示词文本 使用 作为 hook 输入 JSON 的占位符，会被直接替换 如果不存在 ，输入 JSON 会以 格式追加到提示词末尾 timeout: （可选） 超时时间"},{"id":"/cli/plugins-reference","title":"CodeBuddy 插件参考文档","body":"CodeBuddy 插件参考文档 完整的 CodeBuddy 插件系统技术参考，包括组件规范、CLI 命令和开发工具。 插件是一个自包含的组件目录，用于扩展 CodeBuddy 的自定义功能。插件组件包括技能 (Skills)、代理 (Agents)、钩子 (Hooks)、MCP 服务器和 LSP 服务器。 name: agent name description: 代理的专长和调用时机 model: sonnet effort: medium maxTurns: 20 disallowedTools: Write, Edit 二、插件安装作用域 安装插件时，选择一个作用域来决定插件的可用范围： 作用域 设置文件 使用场景 : : : 个人插件，所有项目可用（默认） 团队插件，通过版本控制共享 项目特定插件，被 gitignore 托管设置 托管插件（只读，仅支持更新） 插件使用与其他 CodeBuddy 配置相同的作用域系统。详见 。 三、插件清单架构（plugin.json） （或 ）文件定义插件的元数据和配置。本节记录所有支持的字段和选项。 清单是可选的。如果省略，CodeBuddy 会自动发现 中的组件，并从目录名派生插件名称。当需要提供元数据或自定义组件路径时使用清单。 完整架构示例 必需字段 如果包含清单， 是唯一必需字段。 字段 类型 描述 示例 string 唯一标识符（kebab case，无空格） 此名称用于组件命名空间。例如在 UI 中，插件 的代理 将显示为 。 元数据字段 字段 类型 描述 示例 string 语义化版本。如果在 marketplace 条目中也设置了， 优先。只需在一处设置。 string 插件用途简述 object 作者信息 string 文档 URL string 源代码 URL string 许可证标识符 , array 发现标签 组件路径字段 字段 类型 描述 示例 string \\ array 自定义命令文件/目录（替换默认 ） 或 string \\ array 自定义代理文件（替换默认 ） string \\ array 自定义技能目录（替换默认 ） string \\ array \\ object 钩子配置路径或内联配置 string \\ array \\ object MCP 配置路径或内联配置 string \\ array 自定义输出样式文件/目录（替换默认 ） string \\ array \\ object LSP 配置路径或内联配置 object 启用时提示用户配置的值。详见 见下方 array 消息注入的频道声明。详见 见下方 用户配置 字段声明在插件启用时 CodeBuddy 提示用户输入的值。用此替代要求用户手动编辑 。 键必须是有效标识符。每个值可作为 在 MCP 和 LSP 服务器配置、钩子命令中替换，以及（仅非敏感值）在技能和代理内容中替换。值也作为 环境变量导出到插件子进程。 非敏感值存储在 的 中。敏感值存储到系统密钥链（或在密钥链不可用时存储到 ）。密钥链存储与 OAuth 令牌共享，总限制约 2 KB，因此敏感值应保持较小。 频道 字段允许插件声明一个或多个消息频道，用于向对话中注入内容。每个频道绑定到插件提供的一个 MCP 服务器。 字段是必需的，必须匹配插件 中的一个键。可选的按频道 使用与顶层相同的 schema，允许在启用插件时提示输入 bot token 或 owner ID。 路径行为规则 对于 、 、 和 ，自定义路径会替换默认目录。如果清单指定了 ，则不会扫描默认的 目录。Hooks、MCP servers 和 LSP servers 对处理多个来源有不同的语义。 所有路径必须相对于插件根目录并以 开头 自定义路径中的组件使用相同的命名和命名空间规则 可以将多个路径指定为数组 要保留默认目录并添加更多路径，在数组中包含默认目录： 路径示例: 环境变量 CodeBuddy 提供两个变量用于引用插件路径。两者都在技能内容、代理内容、钩子命令、MCP 或 LSP 服务器配置中的任何位置进行内联替换。两者也作为环境变量导出到钩子进程和 MCP 或 LSP 服务器子进程。 ：插件安装目录的绝对路径。用于引用插件捆绑的脚本、二进制文件和配置文件。此路径在插件更新时会变化，因此写入此处的文件不会在更新后保留。 兼容性：同时支持 变量名以兼容 Claude Code 插件。 ：用于插件状态的持久化目录，在更新后保留。用于已安装的依赖项（如 或 Python 虚拟环境）、生成的代码、缓存以及任何需要跨插件版本持久化的文件。首次引用时自动创建该目录。 兼容性：同时支持 变量名。 持久化数据目录 目录解析为 ，其中 是插件标识符， 、 、 、 和 之外的"},{"id":"/cli/costs","title":"成本管理","body":"成本管理 通过多场景模型选择和异步压缩策略优化成本，在保证效果的同时实现更快的响应速度和更低的使用成本。 CodeBuddy Code 每次交互都会消耗 Token。成本因代码库大小、查询复杂度和对话长度而异。本文档介绍如何追踪成本、多场景模型机制和降低 Token 消耗。 追踪成本 使用 /cost 命令 命令提供当前会话的详细 Token 使用统计： 使用 /context 命令 命令可以分析当前上下文的占用情况，查看不同类型上下文的大小分布： 通过 可以快速识别哪些内容占用了大量上下文空间，从而有针对性地优化。 多场景模型机制 不同的任务场景对模型能力的要求不同。简单的文件搜索、快速查询等任务使用轻量级模型即可完成；复杂的架构设计、多步骤推理等任务需要更强大的推理模型。 通过为不同场景自动选择不同的模型，可以实现： 效果最优：复杂任务使用高能力模型，确保质量 速度更快：简单任务使用轻量模型，响应更迅速 成本更低：避免在简单任务上使用昂贵的高端模型 场景类型 场景类型 说明 典型用例 : : : 默认模型，平衡性能与成本 一般编程任务、代码编写 轻量快速模型，低成本高速度 文件搜索、简单查询、快速操作 推理增强模型，强大分析能力 复杂分析、架构决策、多步骤推理 自动模型选择 CodeBuddy Code 会根据任务类型自动选择合适的场景模型。当子代理执行时，系统会根据用户当前选择的主模型，自动解析出对应的场景模型。 例如， 等轻量级子代理会自动使用 模型，在保证功能的同时降低成本、提升速度。 Agent 工具支持通过 参数指定场景类型： ：继承父模型，适用于一般任务 ：快速且低成本，适用于简单搜索、快速文件操作 ：增强推理能力，适用于复杂分析、架构决策 降低 Token 消耗 Token 成本随上下文大小增长：CodeBuddy Code 处理的上下文越大，消耗的 Token 越多。CodeBuddy Code 通过 Prompt 缓存（减少重复内容如系统提示的成本）和自动压缩（在接近上下文限制时压缩对话历史）自动优化成本。 以下策略帮助你保持较小的上下文，降低每条消息的成本。 主动管理上下文 使用 检查当前 Token 使用情况。 任务间清理：切换到不相关的工作时使用 重新开始。过时的上下文会在后续每条消息中浪费 Token。清理前使用 以便之后通过 返回。 添加自定义压缩指令： 告诉 CodeBuddy Code 在压缩时保留什么内容。 你也可以在 CODEBUDDY.md 中自定义压缩行为： 异步压缩策略 当对话历史接近上下文限制时，系统会自动进行压缩： 自动触发：当上下文接近限制时自动启动压缩 后台执行：压缩过程在后台异步执行，不阻塞用户操作 智能摘要：保留关键信息，压缩冗余内容 无缝衔接：用户无感知，获得\"无限上下文\"体验 压缩时会保留以下关键信息：代码变更记录、重要决策点、用户明确的偏好和指示、当前任务的关键上下文。 选择合适的模型 根据任务复杂度选择模型。使用 在会话中切换模型，或在 中设置默认值。 简单任务使用 lite：文件搜索、快速查询、代码格式化 复杂任务使用 reasoning：架构设计、性能优化、复杂调试 一般任务使用 default：日常编码、功能实现 减少 MCP 服务器开销 每个 MCP 服务器会将工具定义添加到上下文中，即使处于空闲状态。运行 查看已配置的服务器。 优先使用 CLI 工具： 、 、 等工具比 MCP 服务器更节省上下文，因为它们不会添加持久的工具定义。CodeBuddy Code 可以直接运行 CLI 命令，无需额外开销。 禁用未使用的服务器：运行 查看并禁用未使用的服务器。 将详细操作委托给子代理 运行测试、获取文档或处理日志文件可能消耗大量上下文。将这些操作委托给子代理，详细输出保留在子代理的上下文中，只有摘要返回主对话。 编写精确的提示 模糊的请求如\"改进这个代码库\"会触发大范围扫描。精确的请求如\"为 auth.ts 中的 login 函数添加输入验证\"让 CodeBuddy Code 能够以最少的文件读取高效工作。 复杂任务的高效工作方式 对于较长或更复杂的工作，以下习惯有助于避免因走错方向而浪费 Token： 复杂任务使用计划模式：按 Shift+Tab (macOS/Linux) 或 Alt+M (Windows) 进入计划模式。CodeBuddy Code 会探索代码库并提出方案供你批准，避免初始方向错误时的昂贵返工。 尽早纠正方向：如果 CodeBuddy Code 开始走错方向，按 Escape 立即停止。使用 或双击 Escape 将对话和代码恢复到之前的检查点。 提供验证目标：在提示中包含测试用例、截图或预期输出。当 CodeBuddy Code 能够"},{"id":"/cli/tools-reference","title":"工具参考","body":"工具参考 CodeBuddy Code 可用工具的完整参考，包括权限要求。 CodeBuddy Code 内置一系列工具来帮助理解和修改代码库。下表中的工具名称即为 、 和 中使用的标识符。 工具 说明 需要权限 : : : 生成具有独立上下文窗口的 来处理任务 否 向用户提出多选问题，收集需求或澄清歧义 是 在你的环境中执行 Shell 命令。参见 是 在当前会话内调度定时或一次性任务（退出后失效）。参见 否 按 ID 取消定时任务 否 列出当前会话中所有定时任务 否 执行通过 发现的延迟加载工具 否 对文件进行精确的字符串替换编辑 是 切换到计划模式，在编码前设计实现方案 否 创建隔离的 并切换到其中 是 提交计划供用户审批并退出计划模式 是 基于 glob 模式查找文件 否 在文件内容中搜索正则表达式模式 否 基于文本指令编辑或修改已有图片 是 根据文本描述生成图片 是 退出 worktree 会话并返回原始目录 是 通过语言服务器提供代码智能。文件编辑后自动报告类型错误和警告。还支持跳转定义、查找引用、获取类型信息、列出符号、查找实现、追踪调用层级等导航操作。需要 及其语言服务器二进制文件 否 在单个原子操作中对同一文件执行多步编辑 是 修改 Jupyter notebook 单元格内容 是 读取文件内容，支持图片、PDF 和 Jupyter notebook 否 在 中向队友发送消息 否 在主对话中执行 否 执行自定义 是 返回符合 JSON Schema 的结构化输出 否 创建新任务到任务列表 否 获取特定任务的完整详情 否 列出所有任务及其当前状态 否 获取后台任务或子代理的输出 否 按 ID 终止正在运行的后台任务 否 更新任务状态、依赖、详情或删除任务 否 创建 以协调多个代理协作 否 删除 Agent 团队及其任务目录 否 搜索并加载延迟加载的工具，支持内置工具和 否 获取指定 URL 的内容并进行 AI 分析 是 执行网络搜索 是 创建或覆盖文件 是 权限规则可通过 命令或在 中配置。另请参阅 。 工具别名 部分工具拥有别名，可在权限规则中互换使用： 工具 别名 : : Bash 工具行为 Bash 工具在独立进程中执行每条命令，具有以下持久化特性： 工作目录在命令间保持不变。设置 可在每次命令后重置到项目目录。 环境变量不会持久化。一条命令中的 不会在下一条命令中生效。 在启动 CodeBuddy Code 前激活你的 virtualenv 或 conda 环境。要使环境变量在 Bash 命令间持久化，启动前设置 指向一个 shell 脚本，或使用 动态填充。 沙箱模式 Bash 工具支持 ，可限制文件系统和网络访问。启用沙箱时，命令在受限环境中执行，防止未授权的系统访问。 通过 参数可逐条命令绕过沙箱（需要用户审批）。 后台执行 通过 参数可将命令在后台运行，使用 工具读取输出。适用于长时间运行的构建、测试等场景。 延迟加载工具 部分工具（如通过 提供的工具）采用延迟加载机制。这些工具不会在初始工具列表中出现，需要通过 发现和激活。一旦激活，工具在会话剩余时间内保持可用。 通过产品配置可以将内置工具设置为延迟加载： 另请参阅 ：权限系统、规则语法和工具特定规则 ：为子代理配置工具访问权限 ：在工具执行前后运行自定义命令 ：通过 MCP 服务器扩展可用工具 ：使用 CronCreate 调度自动化任务 ：多代理协作的团队系统"},{"id":"/cli/channels-reference","title":"Channels 参考 [Beta]","body":"Channels 参考 [Beta] Beta 功能：Channels 目前处于 Beta 阶段，协议和接口可能会根据反馈进行调整。 Channel 是一种特殊的 MCP 服务器，可以将外部事件（Webhook、聊天消息、监控告警等）推送到 CodeBuddy Code 会话中，让 CodeBuddy Code 对终端外部发生的事情做出反应。 概述 Channel 运行在与 CodeBuddy Code 相同的机器上，通过 stdio 与 CodeBuddy Code 通信。CodeBuddy Code 将其作为子进程启动。 典型的使用场景： 聊天平台（Telegram、Discord）：插件本地运行，轮询平台 API 获取新消息，转发给 CodeBuddy Code Webhook（CI、监控）：服务器监听本地 HTTP 端口，接收外部系统的 POST 请求，推送给 CodeBuddy Code Channel 分为两种模式： 模式 说明 单向 只转发事件给 CodeBuddy Code（告警、Webhook），在本地会话中处理 双向 额外暴露 reply 工具，让 CodeBuddy Code 可以回复消息 使用 Channel 启动 使用 参数指定要加载的 channel： 开发模式 自定义 channel 在初始阶段使用 标志来测试。此标志允许任何 channel 运行，无需在允许列表中： 此标志仅绕过允许列表检查， 组织策略仍然生效。一旦 channel 提交到官方市场并通过安全审查，就会被添加到允许列表，之后可以直接使用 加载。 会话中的 Channel 消息 Channel 消息以 标签的形式注入到 CodeBuddy Code 的上下文中： 在 TUI 中，channel 消息以友好格式显示： 设置 在 中可以控制 channel 功能： 设为 可完全禁用 channel 功能。 构建 Channel 基本要求 一个 channel server 需要： 1. 声明 capability，让 CodeBuddy Code 注册通知监听器 2. 发送 事件 3. 通过 stdio transport 连接（CodeBuddy Code 将其作为子进程启动） 最小示例：Webhook 接收器 注册到 ： Server 配置选项 字段 类型 说明 必填。始终为 。声明后 CodeBuddy Code 注册通知监听器 可选。始终为 。声明此 channel 可以接收权限中继请求 双向 channel 需要。始终为 。标准 MCP 工具能力 推荐。注入到 system prompt，告诉 CodeBuddy Code 如何处理此 channel 的事件 通知格式 发送 通知时，params 包含两个字段： 字段 类型 说明 事件内容，成为 标签的正文 可选。每个键值对成为 标签的属性。键名仅允许字母、数字和下划线，包含连字符或其他字符的键会被静默丢弃 示例： 到达 CodeBuddy Code 时的格式： 暴露 Reply 工具 双向 channel 需要暴露标准 MCP 工具让 CodeBuddy Code 回复消息： 发送者安全管控 未设防的 channel 是 prompt 注入攻击向量。任何能访问你端点的人都可以向 CodeBuddy Code 注入文本。 在调用 之前，必须检查发送者身份： 重要：始终基于发送者身份（ ）而非聊天室身份（ ）进行验证。在群聊中，这两个值不同，按群组验证会让群内任何人都能向会话注入消息。 权限中继 当 CodeBuddy Code 调用需要审批的工具（如 、 、 ）时，本地终端会打开权限对话框。双向 channel 可以选择同时接收这个提示，让你在远程设备上审批或拒绝。 本地终端和远程 channel 的对话框同时打开，先到的回答生效，另一个自动关闭。 启用权限中继 在 Server 构造器中添加 ： 权限请求字段 CodeBuddy Code 发送 ，包含以下字段： 字段 说明 5 个小写字母（排除 ），用于匹配回复 CodeBuddy Code 要使用的工具名，如 、 工具调用的可读描述 工具参数的 JSON 字符串，截断到 200 字符 发送裁决 你的 channel 需要发送 通知： 处理入站裁决 在入站消息处理器中识别 或 格式的回复： 打包为插件 将 channel 包装为插件可以方便分享和安装。用户通过 安装，然后用 启用。 参考 ：完整的双向 channel 实现，包含 Web UI、文件附件和 reply 工具 ：channel 基于 MCP 协议实现"},{"id":"/cli/http-api","title":"CodeBuddy Code HTTP API <sup>Beta</sup>","body":"CodeBuddy Code HTTP API <sup Beta</sup Beta: 此 API 处于 Beta 阶段，接口可能会有调整。欢迎反馈意见。 CodeBuddy Code 提供两套公开接口，面向开发者构建 Agent 应用： REST API ( ) — 无状态 HTTP 请求/响应，适合 Webhook 接入、管理操作、简单查询 ACP ( ) — 有状态流式协议（JSON RPC over SSE），适合构建完整 Agent 客户端应用 快速开始 启动 HTTP 服务 API 文档（Swagger UI） 服务启动后访问： 交互式文档: OpenAPI 规范: Swagger UI 提供所有公开端点的交互式测试界面。 验证服务正常 API 分层 层级 路由前缀 兼容性承诺 说明 公开 REST API 语义化版本，不做破坏性变更 本文档覆盖的内容 公开 ACP 协议 遵循 ACP 规范 完整对话能力，参见 内部 RPC 不保证兼容性 CLI 内部使用，不对外开放 认证 支持两种模式（环境变量 控制）： 模式 值 说明 无认证 （默认） 本地开发用，不需要认证 密码认证 远程访问时自动开启 密码认证支持以下方式（任一通过即可）： 响应格式 所有 端点使用统一的信封格式： 端点概览 系统 方法 端点 说明 GET 健康检查 GET 环境信息（版本、OS、CWD 等） GET 系统资源指标 + 实例进程指标 GET 环境变量（对齐 E2B envd） 认证 方法 端点 说明 GET 获取认证状态 POST 密码登录，返回 token Runs（Agent 执行） 方法 端点 说明 POST 发起 Agent 执行（异步，返回 runId） GET 查询执行状态 GET SSE 流式获取执行结果 POST 取消执行 Webhooks（第三方平台接入） 方法 端点 说明 GET 平台 URL 验证（企微等） POST 平台消息 Webhook 入口 支持的平台： 、 （企业微信）、 （微信客服） 会话 方法 端点 说明 GET 获取会话列表（支持 cwd 查询参数） DELETE 删除会话 POST 重命名会话 GET ⚠️ 已废弃，使用 代替 GET ⚠️ 已废弃 PTY（终端） 方法 端点 说明 POST 创建 PTY 会话 GET 列出 PTY 会话 GET 查询 PTY 会话 DELETE 销毁 PTY 会话 GET SSE 流式获取 PTY 输出（替代 WebSocket） POST 发送 PTY 输入（对齐 E2B Process.SendInput） POST 调整 PTY 大小（对齐 E2B Process.Update） WebSocket PTY 双向数据传输（兼容保留） Workers & Daemon Worker 是运行中的 CLI 进程（interactive / bg / daemon），通过 PID 文件注册表管理。 方法 端点 说明 GET 获取所有活跃 Worker 列表 POST 手动添加远程 Worker GET 获取 Worker 详情（按 PID 或名称） GET 获取 Worker 日志（支持多类型） DELETE 终止 Worker 进程 GET 查询 Daemon 状态 POST 启动 Daemon POST 停止 Daemon POST 重启 Daemon Workers 查询参数: — 按类型过滤（interactive / bg / daemon / daemon worker） — 仅返回本地 Worker（远程代理调用时使用） 日志类型参数 ( ): — 遥测日志（ ） — 进程 stdout/stderr（bg/daemon 日志） — 调试日志（ ，需 ） — 对话历史摘要 — 只返回最后 N 行 不传 type 时自动选择最佳来源（telemetry process debug transcript） Channels（远程控制） 方法 端点 说明 GET 获取客户端列表 POST 启动客户端 POST 停止客户端 POST 创建微信实例 POST 创建企微实例 文件系统（E2B 兼容） 文件内容操作（对齐 E2B envd HTTP 端点）： 方法 端点 说明 GET 下载文件（对齐 E2B envd GET /files） POST 上传文件（对齐 E2B envd POST /files） POST 合并多文件（对齐 E2B envd POST /files/compose） 文件操作（对齐 E2B filesystem.proto）： 方法 端点 说明 POST 获取文件/目录信息（对齐 Filesystem.Stat） POST 列出目录内容"},{"id":"/cli/sdk","title":"CodeBuddy Agent SDK","body":"CodeBuddy Agent SDK 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.0 及以上版本。 功能状态：SDK 当前处于 Preview 阶段，接口和行为可能在未来版本中调整。 ::: warning 重要：环境隔离 SDK 默认不加载任何文件系统配置，包括 、 、MCP 服务器、子代理、斜杠命令、Rules 和 Skills。这是与 CLI 直接使用的关键区别，确保 SDK 应用的行为完全由代码控制，具有可预测性和一致性。 如需加载这些配置，请使用 选项显式指定。详见 章节。 ::: CodeBuddy Agent SDK 允许你在应用程序中以编程方式控制 CodeBuddy Agent。支持 TypeScript/JavaScript 和 Python，可实现自动化任务执行、自定义权限控制、构建 AI 驱动的开发工具等场景。 为什么使用 SDK CodeBuddy Agent SDK 让你能够以编程方式访问 CodeBuddy 的全部能力，而不仅仅是通过命令行交互。 超越命令行的能力 程序化控制：在你的应用程序中嵌入 AI 编程助手，实现自动化工作流 自定义交互：构建符合你需求的用户界面和交互方式 批量处理：对多个文件或项目执行批量 AI 操作 集成现有系统：将 AI 能力无缝集成到 CI/CD、IDE 插件或其他开发工具中 精细化控制 权限管控：通过 回调实现企业级权限策略 行为定制：使用 Hook 系统拦截和修改 Agent 行为 资源限制：控制 token 消耗、执行时间和费用预算 会话管理：持久化和恢复对话上下文 扩展能力 自定义 Agent：创建专门化的子 Agent 处理特定领域任务 MCP 集成：接入自定义工具和服务 多模型支持：灵活切换和配置不同的 AI 模型 你可以构建什么 开发工具增强 IDE 插件：为 VS Code、JetBrains 等 IDE 构建智能编程助手 代码审查工具：自动化代码质量检查和安全扫描 文档生成器：自动生成 API 文档、README 和代码注释 自动化工作流 CI/CD 集成：在流水线中执行智能代码分析和修复 测试生成：自动生成单元测试和集成测试 重构助手：批量执行代码重构和迁移任务 企业应用 内部开发平台：构建企业级 AI 编程平台 知识库问答：基于代码库的智能问答系统 培训工具：交互式编程学习和代码评审系统 功能概览 消息流式传输：实时接收系统消息、助手响应和工具调用结果 多轮对话：支持跨多次推理调用的对话上下文保持 会话管理：通过会话 ID 继续或恢复现有对话 权限控制：细粒度的工具访问权限管理 Hook 系统：在工具执行前后插入自定义逻辑 自定义 Agent：定义专门化的子 Agent 处理特定任务 MCP 集成：支持配置自定义 MCP 服务器扩展功能 安装 ::: code group ::: 环境要求 语言 版本要求 TypeScript/JavaScript Node.js = 18.20 Python Python = 3.10 认证配置 使用已有登录凭据 如果你已经在终端中通过 命令完成了交互式登录，SDK 会自动使用该认证信息，无需额外配置。 使用 API Key 如果未登录或需要使用不同的凭据，可以通过 API Key 认证： 获取 API Key： 版本 获取地址 : : 海外版 <https://www.codebuddy.ai/profile/keys 中国版 <https://copilot.tencent.com/profile/ iOA 版 <https://tencent.sso.copilot.tencent.com/profile/keys 注意：使用 时，必须根据版本正确配置 环境变量： 海外版：不设置（默认） 中国版： iOA 版： 详见 。 也可以在代码中通过 选项传递： ::: code group ::: 企业用户：OAuth Client Credentials 目前仅介绍 Client Credentials 授权方式，适用于服务端应用和 CI/CD 场景。 前提条件：企业用户需要先购买 CodeBuddy 旗舰版才能使用 OAuth 认证。详见 。 企业用户需要先通过 OAuth 2.0 Client Credentials 流程获取 access token，然后传入 SDK。 第 1 步：创建应用获取凭据 参考 创建应用并获取 Client ID 和 Client Secret。 第 2 步：获取 token 并调用 SDK ::: code group ::: 详细的认证配置说明请参阅 。 其他环境变量 变量名 说明 必需 CodeBuddy CLI 可执行文件路径 可选 如果未"},{"id":"/cli/sdk-python","title":"Python SDK 参考","body":"Python SDK 参考 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.0 及以上版本。 本文档提供 Python SDK 的完整 API 参考。有关快速入门和使用示例，请参阅 。 Requirements 依赖 版本要求 Python = 3.10 CodeBuddy CLI 已安装 异步运行时：SDK 基于 ，所有 API 都是异步的。 Installation 推荐使用 进行依赖管理： 或使用 pip： 环境变量 变量名 说明 必需 CodeBuddy CLI 可执行文件路径 可选 如果未设置，SDK 会按以下顺序查找 CLI： 1. 环境变量 2. SDK 包内置的二进制文件 3. 开发环境 monorepo 路径 认证配置 SDK 支持使用已有登录凭据、API Key 或 OAuth Client Credentials 认证，详见 。 Functions query() 主要 API 入口，创建一个查询并返回消息异步迭代器。 参数： 参数 类型 说明 查询提示词或用户消息流 配置选项（可选） 自定义传输层（可选） 返回值： 消息异步迭代器 示例： Client Class CodeBuddySDKClient 用于双向交互式对话的客户端类。支持多轮对话、中断和动态控制。 方法： connect() 连接到 CodeBuddy。 query() 发送用户消息。 receiveresponse() 接收消息直到收到 ResultMessage。 receivemessages() 接收所有消息（不会自动停止）。 disconnect() 断开连接。 上下文管理器支持： mcpserverstatus() 获取 MCP 服务器连接状态。 Authentication SDK 提供独立的认证 API，采用 two phase 设计：先获取登录 URL，再等待用户完成认证。 authenticate() 启动认证流程，返回 对象。 参数： 参数 类型 说明 认证方法标识（默认 ） 预定义环境名 自定义端点 URL（与 environment 互斥） CLI 可执行文件路径 额外环境变量 用户完成登录的超时时间（秒，默认 300） 返回值： — 携带登录 URL 的可等待对象 示例： AuthFlow 认证流程对象，由 返回。实现了 协议，可直接 。 属性： 属性 类型 说明 登录 URL（已登录时为空字符串） 认证方法标识 方法： wait() 等待用户完成认证。 cancel() 取消认证流程并释放资源。 logout() 登出并清除缓存的认证令牌。 示例： Unstable API 警告：以下 API 处于实验阶段，接口可能在未来版本中变更。 interrupt() 发送中断信号。 setpermissionmode() 动态修改权限模式。 setmodel() 动态修改模型。 Types CodeBuddyAgentOptions 完整配置选项： 字段 类型 说明 自动允许的工具白名单 禁止使用的工具黑名单 系统提示词配置 MCP 服务器配置 权限模式 继续最近的会话 要恢复的会话 ID 最大对话轮数 指定模型 备用模型 工作目录 CLI 可执行文件路径 环境变量 额外的 CLI 参数 stderr 回调 Hook 配置 包含部分消息 分叉会话 自定义 Agent 设置来源 权限回调函数 最大思考 token 数（已废弃，请使用 ） 思考模式配置： 、 或 模型推理努力程度 PermissionMode 值 说明 默认模式，所有操作需确认 自动批准文件编辑 规划模式，仅允许读取 跳过所有权限检查 PermissionResult CanUseTool AgentDefinition McpServerConfig HookEvent HookMatcher HookCallback SettingSource 控制 SDK 从哪些文件系统位置加载配置。 值 说明 位置 全局用户设置 项目共享设置 项目本地设置 默认行为：当 未指定时，SDK 不加载任何文件系统配置。这提供了完全干净的运行环境。 AppendSystemPrompt Message Types Message 所有消息类型的联合： SystemMessage UserMessage AssistantMessage ResultMessage StreamEvent ContentBlock Input Types AskUserQuestionInput AskUserQuestionQuestion AskUserQuestionOption Errors 所有异常都继承自 。 CodeBuddySDKError CLIC"},{"id":"/cli/sdk-typescript","title":"TypeScript SDK 参考","body":"TypeScript SDK 参考 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.0 及以上版本。 本文档提供 TypeScript SDK 的完整 API 参考。有关快速入门和使用示例，请参阅 。 Requirements 依赖 版本要求 Node.js = 18.0.0 TypeScript = 5.0.0（推荐） 运行时支持： Node.js（推荐） Bun Deno Installation 或使用其他包管理器： 环境变量 变量名 说明 必需 CodeBuddy CLI 可执行文件路径 可选 认证配置 SDK 支持使用已有登录凭据、API Key 或 OAuth Client Credentials 认证，详见 。 Functions query() 主要 API 入口，创建一个查询并返回消息流。 参数： 参数 类型 说明 查询提示词或用户消息流 配置选项（可选） 返回值： 扩展了 的接口 Query 接口 Constants Errors Unstable V2 API 警告：以下 API 处于实验阶段，接口可能在未来版本中变更。 unstablev2createSession() 创建新的交互式会话。 unstablev2resumeSession() 恢复现有会话。 unstablev2prompt() 单次查询便捷函数。 unstablev2authenticate() 发起交互式登录流程，支持多环境认证（海外版、国内版等）。 参数： 字段 类型 说明 认证 URL 回调，用于打开浏览器或显示链接 预定义环境（与 endpoint 二选一） 自定义 endpoint URL（用于 selfhosted，与 environment 二选一） 认证方法 ID，默认 'external' 超时时间（毫秒），默认 300000 CLI 可执行文件路径（可选） 环境变量（可选） 返回值： 用户信息对象，包含 userId、userName、userNickname、token 等字段 示例： 行为说明： 如果已有有效 token，直接返回用户信息，不会触发登录流程 否则通过 回调通知用户打开登录链接 登录成功后 token 会被缓存，下次调用自动复用 unstablev2logout() 登出并清除缓存的认证 token，下次调用 将重新登录。 参数： 字段 类型 说明 预定义环境（与 endpoint 二选一） 自定义 endpoint URL（与 environment 二选一） CLI 可执行文件路径（可选） 环境变量（可选） 示例： Session 接口 SessionOptions Types Options 完整配置选项： 字段 类型 说明 用于取消请求 运行时 运行时参数 CLI 路径 工作目录 额外的目录 环境变量 指定模型 备用模型 最大思考 token 数（已废弃，请使用 ） 思考模式配置： 、 或 模型推理努力程度 允许的工具白名单 禁止的工具黑名单 权限回调函数 权限模式 允许跳过权限 权限提示工具名 继续最近的会话 要恢复的会话 ID 恢复到特定消息位置 持久化会话 分叉会话 自定义 Agent Hook 配置 输出格式 系统提示词 包含部分消息 最大对话轮数 MCP 服务器配置 严格 MCP 配置 沙箱设置 配置源，控制加载哪些文件系统配置。默认不加载任何配置 SettingSource 控制 SDK 从哪些文件系统位置加载配置。 值 说明 位置 全局用户设置 项目共享设置 项目本地设置 默认行为：当 未指定时，SDK 不加载任何文件系统配置。这提供了完全干净的运行环境。 PermissionMode PermissionResult CanUseTool AgentDefinition ModeInfo ModelInfo McpServerConfig HookEvent HookCallback HookJSONOutput Message Types Message 所有消息类型的联合： SystemMessage UserMessage AssistantMessage ResultMessage ContentBlock Usage Input Types AskUserQuestionInput AskUserQuestionQuestion AskUserQuestionOption ToolInputMap 相关文档 快速入门和使用示例 详细的 Hook 配置说明 MCP 服务器配置指南"},{"id":"/cli/sdk-hooks","title":"SDK Hook 系统","body":"SDK Hook 系统 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.0 及以上版本。 本文档介绍如何在 SDK 中使用 Hook 系统，在工具执行前后插入自定义逻辑。 概述 Hook 允许你在 CodeBuddy 的会话生命周期内插入自定义逻辑，实现： 工具调用前的校验和拦截 工具执行后的日志记录 用户提交内容的审查 会话开始/结束时的初始化和清理 创建与清理时的自定义流程 支持的事件 事件 触发时机 工具执行前 工具执行成功后 用户提交消息时 主 Agent 响应结束时 子 Agent 结束时 上下文压缩前 创建隔离 时 删除隔离 时 文件修改后自动创建检查点时 Hook 配置 通过 选项配置 Hook。每个事件可以有多个 matcher，每个 matcher 可以有多个 hook 回调。 基本结构 ::: code group ::: HookMatcher 结构 字段 类型 说明 匹配模式,支持正则表达式。 或空字符串匹配所有 回调函数数组 超时时间（TypeScript 毫秒，Python 秒） Matcher 模式 精确匹配： 只匹配 Bash 工具 正则匹配： 匹配 Edit 或 Write 通配符： 或 匹配所有工具 前缀匹配： 匹配所有 MCP 工具 事件类型 PreToolUse 工具执行前触发，可以阻止执行或修改输入。 ::: code group ::: PostToolUse 工具执行成功后触发，可以添加额外上下文。 ::: code group ::: UserPromptSubmit 用户提交消息时触发，可以添加上下文或阻止处理。 ::: code group ::: Stop / SubagentStop Agent 响应结束时触发，可以阻止停止并要求继续。 ::: code group ::: unstableCheckpoint（实验性） 文件修改后（Write/Edit/MultiEdit 工具执行成功）自动触发，提供文件快照和变更统计信息。 ::: warning 实验性 API 此 Hook 为实验性功能，API 可能在未来版本中发生变化。 ::: ::: code group ::: Checkpoint 数据结构： : 检查点唯一标识符 : 人类可读标签（通常为用户提示） : 创建时间戳 : 文件路径到版本信息的映射 : 文件绝对路径 : 版本号 : 备份文件名 : 备份时间戳 : 文件变更统计 : 变更的文件路径列表 : 新增行数 : 删除行数 Hook 输入 Hook 回调接收的输入结构因事件类型而异。 公共字段 PreToolUse / PostToolUse 输入 UserPromptSubmit 输入 Stop / SubagentStop 输入 WorktreeCreate 输入示例： WorktreeRemove 输入示例： unstableCheckpoint 输入 Hook 输出 Hook 回调返回的输出控制后续行为。 基本输出字段 字段 类型 说明 / 是否继续执行（默认 true） 设为 阻止操作 阻止原因 当 为 false 时显示的停止消息 隐藏输出 PreToolUse 特殊输出 可以修改工具输入： ::: code group ::: 示例 完整示例：Bash 命令审计 ::: code group ::: 示例：限制文件修改范围 ::: code group ::: 示例：文件修改追踪（Checkpoint Hook） ::: code group ::: 相关文档 快速入门和使用示例 canUseTool 回调 CLI Hook 完整参考 完整 API 参考 完整 API 参考"},{"id":"/cli/sdk-permissions","title":"SDK 权限控制","body":"SDK 权限控制 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.0 及以上版本。 本文档介绍如何在 SDK 中实现权限控制，包括权限模式、canUseTool 回调和工具白名单/黑名单。 概述 CodeBuddy Agent SDK 提供多种权限控制机制： 机制 说明 适用场景 权限模式 全局控制权限行为 快速设置整体策略 canUseTool 回调 运行时动态审批 交互式权限确认 工具白名单/黑名单 声明式工具过滤 静态策略配置 权限模式 通过 （TypeScript）或 （Python）设置全局权限行为。 可用模式 模式 说明 默认模式，所有工具操作需要确认 自动批准文件编辑，其他操作仍需确认 规划模式，仅允许只读工具 跳过所有权限检查（谨慎使用） 初始配置 ::: code group ::: 动态修改权限模式 使用 Session/Client API 可以在运行时动态修改权限模式： ::: code group ::: canUseTool 回调 回调在工具需要权限确认时触发，允许你实现自定义的权限逻辑。 回调签名 ::: code group ::: 完整示例：交互式审批 ::: code group ::: 修改工具输入 可以在 中修改工具的输入参数： ::: code group ::: 处理 AskUserQuestion 当 AI 需要向用户提问时，会调用 工具。你需要在 中处理这个工具。 输入结构 返回答案 ::: code group ::: 工具白名单/黑名单 SDK 提供多种工具过滤机制： 选项 说明 优先级 内置工具白名单，从根本上限制可用工具集 最高 允许使用的工具（支持模式匹配） 中 禁止使用的工具（支持模式匹配） 中 tools：内置工具白名单 使用 选项从根本上限制 CodeBuddy 可使用的内置工具集： ::: code group ::: allowedTools/disallowedTools：工具过滤 使用 和 进行更细粒度的工具过滤，支持模式匹配： ::: code group ::: 常用工具名称 工具名 功能 读取文件 写入文件 编辑文件 文件模式匹配 内容搜索 执行 Shell 命令 子 Agent 任务 获取网页内容 网络搜索 搜索延迟加载的工具 最佳实践 1. 默认使用 模式：提供最完整的权限控制 2. 只读任务使用 模式： 3. 结合白名单精确控制： 4. 危险命令使用 ： 5. 生产环境避免 ：该模式会跳过所有权限检查 相关文档 快速入门和使用示例 更细粒度的工具控制 完整 API 参考 完整 API 参考"},{"id":"/cli/sdk-sessions","title":"SDK 会话管理","body":"SDK 会话管理 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.0 及以上版本。 本文档介绍如何在 SDK 中管理会话，包括获取会话 ID、恢复会话、分叉会话和多轮对话。 概述 会话（Session）是 CodeBuddy 的核心概念，用于： 保持对话上下文：多轮对话中 AI 能记住之前的内容 支持会话恢复：可以从上次中断的地方继续 支持会话分叉：从某个点创建分支，探索不同方向 每个会话都有一个唯一的 ，可以用于后续恢复。 获取会话 ID 会话开始时，SDK 会返回一个 类型的初始化消息,其中包含 。 使用 query API ::: code group ::: 使用 v2 Session API (TypeScript) 使用 Client API (Python) 恢复会话 使用之前保存的 可以恢复会话，继续之前的对话。 使用 resume 选项 ::: code group ::: 继续最近的会话 使用 / 选项可以自动继续最近的会话： ::: code group ::: 多轮对话 多轮对话允许在同一个会话中进行多次交互，保持上下文连贯。 TypeScript：使用 query API 每次新的 query 调用使用 恢复会话： TypeScript：使用 v2 Session API v2 API 提供更简洁的多轮对话体验： Python：使用 CodeBuddySDKClient 相关文档 快速入门和使用示例 权限模式和 canUseTool 完整 API 参考 完整 API 参考"},{"id":"/cli/sdk-custom-tools","title":"SDK Custom Tools Guide","body":"SDK Custom Tools Guide 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.24 及以上版本。 功能状态：SDK Custom Tools 是 CodeBuddy Agent SDK 的一项 Preview 功能。 本文档介绍如何在 CodeBuddy Agent SDK 中创建和使用自定义工具。自定义工具允许你定义专属的功能，让 Agent 能够调用它们来完成特定任务。 概述 Custom Tools 是 CodeBuddy Agent SDK 提供的一种通过 MCP（Model Context Protocol）创建自定义工具的方式。与配置外部 MCP 服务器不同，Custom Tools 允许你直接在应用程序中定义工具，无需单独的进程或服务器。 核心优势 内进程执行：工具在应用程序内执行，无需创建独立进程 类型安全：支持 TypeScript 完整的类型检查和类型推断 简化部署：无需单独部署 MCP 服务器，一切随应用部署 紧密集成：与应用程序共享内存和状态 零额外依赖：利用现有的 SDK 基础设施 快速开始 TypeScript 创建一个简单的计算器工具： Python Python SDK 使用装饰器模式定义工具： 创建自定义工具 TypeScript 基本工具定义 TypeScript 完整示例：文件分析工具 Python 装饰器模式 多个工具管理 TypeScript Python 类型安全 TypeScript 使用 Zod 模式 Zod 提供运行时类型验证和强大的类型推断： Python 类型注解 Python SDK 使用 装饰器定义工具，支持简单类型映射或 JSON Schema： 完整示例：数据库查询工具 TypeScript Python 完整示例：API 集成工具 TypeScript Python 选择性地允许工具 你可以选择性地允许特定工具被调用： TypeScript Python 错误处理 TypeScript API 调用错误处理 Python API 调用错误处理 最佳实践 1. 使用明确的参数类型和描述 为工具参数提供清晰的类型和描述，帮助 Agent 理解如何调用工具： 2. 提供有意义的错误反馈 始终返回明确的错误信息，以便 Agent 和用户理解发生了什么： 3. 验证输入参数 确保输入符合预期的格式和范围： 相关文档 更多资源"},{"id":"/cli/sdk-mcp","title":"SDK MCP Integration Guide","body":"SDK MCP Integration Guide 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.24 及以上版本。 功能状态：SDK MCP 支持是 CodeBuddy Agent SDK 的一项 Preview 功能。 本文档介绍如何在 CodeBuddy Agent SDK 中集成和使用 MCP（Model Context Protocol）服务器，为你的应用程序扩展自定义工具和功能。 概述 MCP 服务器允许你将自定义工具、资源和提示集成到 CodeBuddy Agent SDK 中。通过 SDK，你可以以编程方式启用这些工具，从而为你的 AI 工作流添加特定领域的功能。 核心概念 MCP 服务器：提供工具、资源和提示的独立进程或服务 工具：MCP 服务器暴露的可执行函数 资源：MCP 服务器提供的可读取的数据或文件 提示：MCP 服务器提供的模板化提示词 支持的传输类型 CodeBuddy Agent SDK 支持三种 MCP 服务器通信方式： 传输类型 使用场景 说明 STDIO 本地工具 通过标准输入输出与本地进程通信 HTTP/SSE 远程服务 通过 HTTP 流式传输或 Server Sent Events 与远程服务通信 SDK MCP IDE/SDK 集成 由外部 SDK（如 IDE 扩展）注册的 MCP 服务器 配置 MCP 服务器 支持两种配置方式： 1. 对象格式：直接在代码中定义服务器配置 2. 文件路径字符串：指向一个 MCP 配置文件（JSON 格式） 对象格式 使用 选项配置 MCP 服务器。配置支持 STDIO、HTTP 和 SSE 传输类型。 TypeScript： Python： 文件路径格式 也可以传入一个 MCP 配置文件路径。配置文件为 JSON 格式，结构与 CLI 参数一致。 TypeScript： Python： 配置文件格式示例（ ）： 注意：使用文件路径格式时，不支持 SDK MCP 类型（ ）的服务器配置。SDK MCP 服务器仅在对象格式中可用。 服务器配置详解 STDIO 配置 STDIO 服务器通过标准输入输出与本地进程通信，适用于本地工具。 常见用例： HTTP 配置 HTTP 服务器通过 HTTP 流式传输与远程服务通信。 SSE 配置 SSE 服务器通过 Server Sent Events 与远程服务通信。 权限管理 MCP 工具支持精细化的权限控制。通过 回调，你可以决定哪些工具可以被使用。 工具权限模式 特定工具的权限控制 使用 MCP 工具 配置完 MCP 服务器后，Agent 会自动发现这些服务器提供的工具，并在需要时调用它们。 自动工具发现 处理工具结果 实例：数据库查询 MCP 服务器 以下是一个完整的示例，展示如何创建和使用数据库 MCP 服务器。 创建 MCP 服务器 dbmcpserver.py： 在 SDK 中使用 TypeScript： Python： 实例：API 集成 MCP 服务器 以下示例展示如何创建一个通过 HTTP 连接到多个 API 的 MCP 服务器。 服务器实现 apimcpserver.py： 在 SDK 中使用 实例：远程 SSE 服务器 SSE 服务器适用于需要实时数据流或事件推送的场景。 错误处理 在处理 MCP 服务器连接时，监控初始化状态并识别失败的连接： 检查服务器初始化状态 TypeScript： Python： 相关文档 更多资源"},{"id":"/cli/sdk-demos","title":"SDK 示例项目","body":"SDK 示例项目 本文档介绍 CodeBuddy Agent SDK 的官方示例项目，帮助你快速了解 SDK 的各种使用场景。 示例仓库 所有示例代码托管在官方仓库： 仓库地址：<https://cnb.cool/codebuddy/agent sdk demos 示例概览 示例 语言 核心功能 适用场景 quick start TypeScript 基础 API、消息流、Hooks SDK 入门 multi turn session TypeScript 多轮对话、会话恢复 交互式应用 research assistant Python 多 Agent 协作 复杂任务分解 profile builder TypeScript 网络搜索、文档生成 信息收集 chat demo TypeScript WebSocket、流式响应 Web 应用 mail assistant TypeScript MCP 协议、自定义工具 业务系统对接 spreadsheet assistant TypeScript Electron IPC 桌面应用 环境准备 前置条件 或 Node.js 18+ Python 3.10+（Python 示例） 已完成 CodeBuddy CLI 登录认证 安装 SDK ::: code group ::: 认证方式 SDK 支持多种认证方式： 1. 复用 CLI 登录态：如果已通过 命令登录，SDK 自动使用现有凭据 2. API Key 认证：通过环境变量配置 详细的认证配置请参阅 基础示例 quick start：SDK 入门 演示 API 的基本用法，包括消息流处理和 Hooks 机制。 运行示例： multi turn session：多轮对话 演示 Session API 实现多轮对话和会话恢复。 运行示例： 进阶示例 research assistant：多 Agent 协作 Python 示例，展示如何定义多个专业化子 Agent 协作完成复杂任务。 工作流程： 1. 主 Agent 将研究请求拆分为子任务 2. 研究员 使用 WebSearch 搜索信息，保存到 3. 数据分析师 从研究笔记提取数据，生成图表到 4. 报告撰写者 整合内容，生成 PDF 报告到 运行示例： profile builder：信息收集与文档生成 演示 WebSearch 工具和文档生成能力。 运行示例： Web 应用集成 chat demo：流式响应架构 演示如何将 SDK 集成到 Web 应用，通过 WebSocket 实现流式响应。 架构： 服务端封装： 运行示例： mail assistant：MCP 工具扩展 演示通过 MCP 协议扩展 Agent 能力，实现邮件系统操作。 运行示例： 桌面应用集成 spreadsheet assistant：Electron 集成 演示在 Electron 应用中通过 IPC 集成 SDK。 主进程： 渲染进程： 运行示例： Hooks 安全控制 所有示例都支持通过 Hooks 实现安全控制： 相关文档 SDK 完整介绍 TypeScript API 详细文档 Python API 详细文档 MCP 服务器配置 多 Agent 协作详解"},{"id":"/cli/release-notes/README","title":"Release Notes","body":"Release Notes CodeBuddy Code 的版本发布说明，面向终端用户的功能更新和改进。 📖 关于 Release Notes Release Notes 记录了每个版本的用户可见变更，包括： ✨ 新功能 🔧 改进优化 🐛 问题修复 与 CHANGELOG.md 的区别： Release Notes：面向终端用户，强调功能价值和用户体验 CHANGELOG：面向开发者，记录技术细节和代码变更 📋 版本历史 <! 新版本自动添加到此处 2026 04 07 2026 04 05 2026 04 05 2026 04 04 2026 04 03 2026 04 03 2026 04 03 2026 04 03 2026 04 03 2026 04 02 2026 04 01 2026 04 01 2026 03 31 2026 03 31 2026 03 30 2026 03 30 2026 03 28 2026 03 26 2026 03 26 2026 03 25 2026 03 25 2026 03 25 2026 03 24 2026 03 23 2026 03 23 2026 03 19 2026 03 18 2026 03 18 2026 03 17 2026 03 17 2026 03 16 2026 03 15 2026 03 13 2026 03 13 2026 03 13 2026 03 12 2026 03 12 2026 03 12 2026 03 12 2026 03 11 2026 03 11 2026 03 11 2026 03 09 2026 03 07 2026 03 06 2026 03 06 2026 03 05 2026 03 05 2026 03 03 2026 03 03 2026 03 02 2026 02 28 2026 02 28 2026 02 28 2026 02 26 2026 02 26 2026 02 25 2026 02 24 2026 02 19 2026 02 19 2026 02 14 2026 02 14 2026 02 13 2026 02 13 2026 02 12 2026 02 12 2026 02 11 2026 02 11 2026 02 11 2026 02 10 2026 02 10 2026 02 09 2026 02 08 2026 02 06 2026 02 05 2026 02 04 2026 02 04 2026 02 04 2026 02 03 2026 02 03 2026 02 02 2026 02 02 2026 02 02 2026 01 31 2026 01 31 2026 01 30 2026 01 30 2026 01 29 2026 01 28 2026 01 28 2026 01 28 2026 01 27 2026 01 27 2026 01 27 2026 01 27 2026 01 27 2026 01 27 2026 01 26 2026 01 26 2026 01 25 2026 01 25 2026 01 24 2026 01 23 2026 01 23 2026 01 23 2026 01 23 2026 01 23 2026 01 22 2026 01 22 2026 01 22 2026 01 22 2026 01 21 2026 01 21 2026 01 21 2026 01 21 2026 01 21 2026 01 20 2026 01 20 2026 01 20 2026 01 20 2026 01 19 2026 01 18 2026 01 17 2026 01 17 2026 01 16 2026 01 15 2026 01 15 2026 01 15 2026 01 14 2026 01 14 2026 01 13 2026 01 12 2026 01 09 2026 01 09 2026 01 08 2026 01 08 2026 01 07 2026 01 06 2026 01 06 2026 01 05 2026 01 05 2026 01 04 2025 12 31 2025 12 30 2025 12 29 2025 12 26 2025 12 25 2024 12 24 2025 12 24 2025 12 23 2025 12 23 2025 12 23 2025 12 22 2025 12 20 2025 12 19 2025 12 19 2025 12 19 2025 12 16 2025 12 15 2025 12 12 2025 12 1"},{"id":"/cli/release-notes/v2.79.0","title":"🚀 CodeBuddy Code v2.79.0 发布","body":"🚀 CodeBuddy Code v2.79.0 发布 ✨ 新功能 Daemon 常驻模式与后台会话 新增 Daemon 守护进程支持，可通过 命令管理后台运行的 CLI 实例。同时支持 参数在后台启动任务，配合 命令对后台任务进行全生命周期管理。 Web UI Workers 与日志管理 Web UI 新增 Workers 页面，可视化管理所有 Worker 进程和 Daemon，支持启停、终止操作。同时新增独立日志查看器，支持 4 种日志类型（遥测/进程/调试/对话）切换、关键词搜索和语法高亮。 系统监控视图 Web UI 新增 Metrics 页面，展示系统 CPU、内存、磁盘使用概览以及各实例进程级资源指标（RSS、Heap、运行时长），支持 8 秒自动轮询刷新，帮助随时掌握资源状态。 编辑器体验全面升级 标签增强：支持拖拽排序、固定标签（Pin）、溢出滚动箭头，以及增强右键菜单（复制路径、在文件树中定位、关闭右侧、关闭已保存） 面包屑导航：编辑器顶部显示文件路径层级，点击可快速切换同级文件 快速打开：支持 Cmd+P / Ctrl+P 快速搜索并打开文件 文件预览：支持图片（缩放/拖拽/棋盘格背景）、Markdown、PDF、SVG 预览和二进制文件信息页 状态栏：底部显示光标位置、选区信息、语言类型等编辑状态 最近文件：空编辑器页面展示最近打开文件列表 🔧 改进优化 执行阶段追踪：Loading 状态栏新增细粒度执行阶段显示（preparing / waiting for model / streaming / processing / running tool），帮助了解 Agent 当前正在做什么 后台任务支持扩展：stream json 和 headless 模式现已支持后台任务，仅 print 模式（ ）保持原有限制 设置页面重构：重构为数据驱动的设置面板，支持通过 REST API 读写用户级设置，包含开关、选择、文本输入、JSON 编辑等控件，操作后有保存反馈提示 代码块优化：复制按钮改为悬停浮动显示，去除语言标签栏，界面更简洁 菜单交互改进：斜杠命令、@ 文件补全、+ 功能面板现支持点击外部自动关闭 🐛 问题修复 命令补全菜单：修复输入命令参数时补全菜单仍然显示的问题，光标离开命令名区域后菜单会正确关闭 指标采集：修复多实例场景下 metrics 接口的循环调用问题 会话工作目录：修复 Web UI 会话工作目录设置为 URL 而非实际路径的问题"},{"id":"/cli/release-notes/v2.78.1","title":"🚀 CodeBuddy Code v2.78.1 发布","body":"🚀 CodeBuddy Code v2.78.1 发布 🐛 问题修复 Agent 解析修复：修复队列排空和 Agent 唤醒时使用错误 Agent 的问题，现在统一使用 session 关联的 Agent，确保任务调度更加准确可靠 模型字段修复：修复 reasoningitem 和普通 item 的 model 字段取值问题，使用实际模型响应信息替代可能为空的值，确保模型信息完整准确 🔧 改进优化 企业微信回复增强：增强 chatId 解析能力，支持从 chatId 字符串提取路由信息；优化工具返回格式为结构化 JSON，提升消息处理的可靠性"},{"id":"/cli/release-notes/v2.78.0","title":"🚀 CodeBuddy Code v2.78.0 发布","body":"🚀 CodeBuddy Code v2.78.0 发布 ✨ 新功能 Agent Teams Web UI 支持 全新的 Agent Teams Web UI 体验，让您可以在浏览器中直观地管理和监控多 Agent 协作任务： 实时进度追踪：Team 成员的运行状态、token 使用量、工具调用次数通过 SSE 实时推送，在任务面板中一目了然 成员对话查看：点击任意成员即可查看其完整对话历史，支持实时流式更新 智能消息展示：收到的消息显示 ，发出的消息显示 ，每个成员拥有专属颜色标识 刷新状态恢复：页面刷新后自动恢复 Team 状态和成员对话，无需手动重连 完整国际化：新增 13 个 Team 相关的中英文翻译 🔧 改进优化 权限系统重构：重构 ACP 权限广播机制，支持 Web UI 页面刷新后恢复权限对话框，修复跨端权限同步问题 问卷下发优化：AskUserQuestion 改为通过 interruption 广播协议下发，避免多连接场景下问卷发送到错误客户端 上下文压缩改进：采用同步 compact 流程替代手动截断，提升上下文管理的可靠性 频道消息队列：微信/企业微信频道新增消息队列机制，避免 Agent 运行期间并发消息丢失 选项兼容处理：TUI 和 Web UI 问卷面板增加对纯字符串选项数组的防御性处理 🐛 问题修复 命令补全修复：修复输入斜杠命令后跟参数时补全菜单消失的问题，现在输入如 时仍能正确显示命令补全建议 命令建议修复：修复光标进入参数区域后命令补全仍然显示的问题"},{"id":"/cli/release-notes/v2.77.1","title":"🚀 CodeBuddy Code v2.77.1 发布","body":"🚀 CodeBuddy Code v2.77.1 发布 🔧 改进优化 图片 blob 引用还原：新增环境变量 ，设置为 后可在 模式流式输出中将图片 blob 引用自动还原为完整 base64 数据，方便下游系统集成 微信/企微权限回复体验优化：移除权限操作后的机械确认消息，改为由 Agent 后续动作作为隐式反馈，对话更自然流畅 🐛 问题修复 微信/企微消息路由修复：修复权限回复中\"始终允许\"指令因检查顺序问题被错误识别的 bug，确保权限指令优先正确处理"},{"id":"/cli/release-notes/v2.77.0","title":"🚀 CodeBuddy Code v2.77.0 发布","body":"🚀 CodeBuddy Code v2.77.0 发布 ✨ 新功能 插件系统全面升级 插件系统迎来重大增强，显著提升了插件的安装、管理和扩展能力： 多来源安装：支持通过 npm 包和 Git 仓库子目录安装插件，灵活适配不同的插件分发方式 MCP Bundle 支持：支持从远程 URL 或本地文件加载预打包的 MCP 服务（.mcpb/.dxt/.zip），简化 MCP 服务集成 Output Style 扩展：插件可以提供自定义输出样式，个性化 Agent 的输出表现 默认 Agent 配置：插件支持通过 设置默认 Agent，作为最低优先级 base layer PATH 自动注入：启用插件的 目录自动注入到 Bash 工具的 PATH 中 用户配置选项：插件支持定义 字段，安装时交互式收集用户配置 依赖解析：支持 DFS 闭包算法解析插件传递依赖，含循环检测 插件安全与管理 市场名称保护：四层防御机制防止第三方冒充官方市场 企业策略服务：通过 managed settings 控制插件启用/禁用，满足企业合规需求 参数：支持从本地目录加载插件，方便开发和测试 命令：无需重启即可重新加载所有插件组件 命令：四层校验插件目录结构和 manifest 有效性 🔧 改进优化 Venus 端点兼容适配器：支持 Venus OpenAI 兼容代理端点的 Prompt 缓存注入和请求字段清理，模型适配器与端点适配器可叠加使用 SDK MCP 工具过滤器：确保权限和 deny 规则正确应用于 SDK 注册的自定义工具 🐛 问题修复 AskPanel 竞态修复：修复 doneAsk/rejectAsk 与 approve/reject 的调用顺序问题，避免工具在获得答案前继续执行 图片消息类型修复： 使用正确的 类型替换图片占位，避免类型不匹配 📝 文档更新 插件市场文档：全面更新插件市场使用指南 CLI 文档更新：更新 CLI 参考、环境变量、HTTP API、斜杠命令等多篇文档的中英文版本"},{"id":"/cli/release-notes/v2.76.0","title":"🚀 CodeBuddy Code v2.76.0 发布","body":"🚀 CodeBuddy Code v2.76.0 发布 ✨ 新功能 GLM 5v Turbo 模型上线：新增 GLM 5v Turbo 多模态视觉模型，支持图片理解能力，让 AI 助手能够分析和理解图片内容，同步上线国内版和 iOA 版 🐛 问题修复 模型 temperature 配置修复：修复部分模型的温度参数（temperature）被错误地硬编码为默认值 1 的问题，现在正确读取产品配置中各模型指定的 temperature 值，确保模型以最佳参数运行"},{"id":"/cli/release-notes/v2.75.0","title":"🚀 CodeBuddy Code v2.75.0 发布","body":"🚀 CodeBuddy Code v2.75.0 发布 🔧 改进优化 微信实例 ID 动态更新：微信客户端扫码认证后，自动将临时实例 ID 更新为真实 ID，确保后续消息回复能正确路由到对应的微信账号 微信消息发送错误检查：消息发送接口增加返回值校验，发送失败时抛出明确的错误信息，便于问题排查"},{"id":"/cli/release-notes/v2.74.0","title":"🚀 CodeBuddy Code v2.74.0 发布","body":"🚀 CodeBuddy Code v2.74.0 发布 ✨ 新功能 侧问题命令 /btw 在 Agent 工作过程中，使用 快速提出侧问题，无需中断当前任务。答案基于已有上下文即时生成，适合在复杂任务中随时确认细节或获取补充信息。 🔧 改进优化 渠道会话建议确认：通过微信/企业微信渠道完成一轮对话后，自动生成后续建议并等待用户确认后再执行，避免不必要的自动操作 🐛 问题修复 AskUserQuestion 面板稳定性：修复当模型返回的选项数据不完整时，问答面板可能崩溃的问题"},{"id":"/cli/release-notes/v2.73.0","title":"🚀 CodeBuddy Code v2.73.0 发布","body":"🚀 CodeBuddy Code v2.73.0 发布 ✨ 新功能 Channel 建议确认 通过微信/企业微信渠道完成一轮对话后，系统会自动生成下一步操作建议并发送给用户确认，回复 y 即可继续执行，让渠道交互更加流畅自然。 🔧 改进优化 微信/企微权限三选项：权限请求提示从 升级为 ，支持记住选择，减少重复确认 修复权限卡死：微信/企微中回复非选项内容时不再卡死，自动拒绝当前权限并将输入作为新消息处理 上下文压缩优化：压缩前自动清理超过 1 小时的旧工具结果，实测可节省 80%+ 的压缩输入 token，显著降低压缩成本 图片内容剥离：压缩前自动将图片替换为占位符，避免无意义的图片 token 进入摘要 压缩提示词增强：改进 9 章节结构化摘要格式，提高压缩质量和信息保留率 JSON 修复增强：使用 jsonrepair 库替换自定义修复逻辑，支持修复中文引号、缺失逗号、截断 JSON 等更多畸形场景，减少不必要的模型重试 🐛 问题修复 渠道消息斜杠命令：修复从微信等渠道发送的斜杠命令因被标签包裹而无法正确识别的问题 队列消息命令保留：消息队列处理时保留斜杠命令，等 agent 空闲后通过正常管道执行，避免命令被吞掉"},{"id":"/cli/release-notes/v2.72.0","title":"🚀 CodeBuddy Code v2.72.0 发布","body":"🚀 CodeBuddy Code v2.72.0 发布 ✨ 新功能 文件变更面板 Web UI 新增 Changes 视图，让你可以实时查看 Agent 修改的所有文件。点击文件即可打开 Monaco Diff 编辑器，以语法高亮的方式对比查看每个文件的具体变更内容。 Checkpoint 回退 新增强大的代码回退能力，支持三种灵活的回退模式： 按文件撤回：精确撤回单个文件的修改 按回退点回退：回到之前的某个对话节点 多模式选择：仅回退代码、仅回退对话、或全部回退 🔧 改进优化 Diff 查看体验升级：从自定义 diff 算法迁移到 Monaco DiffEditor，支持语法高亮，大文件查看更流畅 文件图标优化：消除图标加载时的闪烁问题，文件列表展示更顺滑 会话状态恢复：刷新页面后自动恢复文件变更面板状态，不丢失上下文 实时变更通知：Agent 修改文件后，所有已连接的客户端都会实时收到变更通知 插件管理 API：新增公开 REST API 管理插件的安装、卸载、启用和禁用 配置管理 API：新增公开 REST API 查询和修改配置，支持按作用域操作 剪贴板兼容性增强：macOS 图片粘贴新增 JXA NSPasteboard 后备方案，兼容企业微信等第三方截图工具 消息通知优化：优化微信和企微 Channel 中工具操作的中文描述，更易理解"},{"id":"/cli/release-notes/v2.71.1","title":"🚀 CodeBuddy Code v2.71.1 发布","body":"🚀 CodeBuddy Code v2.71.1 发布 🔧 改进优化 SDK MCP 超时机制：将固定超时替换为 AbortSignal 取消机制，支持长时间运行的 MCP 工具调用，避免复杂工具因超时被意外中断 推理模型配置：启用 thinking 模式时自动默认 effort 为 high，确保模型实际产出推理输出 产品配置修复：修正模型配置中 reasoning 字段的拼写错误"},{"id":"/cli/release-notes/v2.71.0","title":"🚀 CodeBuddy Code v2.71.0 发布","body":"🚀 CodeBuddy Code v2.71.0 发布 ✨ 新功能 Web UI 代码编辑器 Web UI 新增文件浏览和代码编辑功能，让你可以直接在浏览器中查看和编辑项目文件： 目录树导航：左侧面板展示项目文件结构，快速定位文件 多标签编辑：同时打开多个文件，在标签间自由切换 Monaco Editor：集成 VS Code 同款编辑器引擎，支持语法高亮 自动保存：编辑内容自动保存，无需手动操作 文件拖拽移动：支持拖拽文件进行移动操作 键盘快捷键：支持常用快捷键，提升编辑效率 🔧 改进优化 流式超时时间优化：将流式响应超时和首 token 超时默认值从 2 分钟提升至 10 分钟，减少复杂任务中因模型响应较慢导致的超时中断。仍可通过 和 环境变量自定义"},{"id":"/cli/release-notes/v2.70.1","title":"CodeBuddy Code v2.70.1 发布","body":"CodeBuddy Code v2.70.1 发布 🔒 安全修复 CORS 跨域攻击防护 修复了本地 Gateway 服务（ ）存在的跨域请求安全漏洞。此前，恶意网页可通过 JavaScript 跨域访问用户本地 localhost 服务，执行 Agent 命令或窃取输出数据。 主要修复内容： 替换框架默认的 为精确白名单机制，仅允许 localhost、127.0.0.1 和 Tunnel URL 的跨域请求 新增 Host 头验证中间件，防止 DNS Rebinding 攻击 修复 SSE 流式端点的 CORS 通配符漏洞 默认绑定地址从 改为 ，避免服务暴露到局域网 🔧 改进优化 自定义跨域规则：支持通过环境变量 （逗号分隔）或 Settings 配置 自定义允许的跨域源，满足特殊场景需求"},{"id":"/cli/release-notes/v2.70.0","title":"🚀 CodeBuddy Code v2.70.0 发布","body":"🚀 CodeBuddy Code v2.70.0 发布 ✨ 新功能 内置命令模型驱动调用 AI 模型现在可以通过 Skill 工具直接执行部分内置斜杠命令（如 /clear、/model、/config、/resume、/gateway 等），让 WebChat、微信等非终端场景也能由模型代理执行命令，无需用户手动输入斜杠命令。 /model、/config、/resume 等命令新增 子命令，支持以文本方式列出可用选项 通过 字段统一控制内置命令和自定义命令是否允许模型调用 🔧 改进优化 实例注册地址简化：将 localUrl/tunnelUrl 合并为统一的 url 字段，后端自动确定最佳可达地址，简化配置 权限确认框稳定性：使用 useSyncExternalStore 替代 useEffect 订阅模式，彻底解决权限确认框偶发不显示的竞态问题 会话权限模式保持：修复多实例场景下切换会话时权限模式被重置的问题"},{"id":"/cli/release-notes/v2.69.0","title":"🚀 CodeBuddy Code v2.69.0 发布","body":"🚀 CodeBuddy Code v2.69.0 发布 ✨ 新功能 E2B 兼容 API 全面对齐 E2B 开放协议，让 CodeBuddy Code 可作为 E2B 兼容的沙箱环境使用： 文件系统 API：新增 和 端点，支持文件读写、目录操作、文件监听等完整文件系统功能 进程管理 API：新增 端点，支持进程启动（PTY/管道）、输入输出流、信号发送等全生命周期管理 系统指标与环境变量 API：新增 和 端点，提供 CPU/内存/磁盘使用指标和环境变量查询 🔧 改进优化 PTY 终端增强：新增 SSE 输出流、HTTP 输入发送、HTTP resize 端点，提供 WebSocket 之外的纯 HTTP 替代方案 终端 Web UI 重构：前端终端组件从 WebSocket 迁移到 SSE + HTTP 通信，提升跨平台兼容性 分布式追踪：基于 Hook 机制重构 trace 链路，支持 SDK 传递 traceId 实现端到端追踪，每次工具调用自动创建子 Span WeChat 多实例支持：支持同时连接多个 WeChat 机器人实例，自动路由消息到正确的客户端 WeChat 媒体消息：支持接收和发送图片、文件、语音、视频消息 中文引号修复：自动修复模型输出中的中文引号，避免工具调用 JSON 解析失败 🔒 安全修复 企业微信 SSRF 防护：企业微信机器人媒体下载添加 URL 白名单校验，确保仅限企微官方 CDN 域名，防止服务端请求伪造攻击"},{"id":"/cli/release-notes/v2.68.0","title":"🚀 CodeBuddy Code v2.68.0 发布","body":"🚀 CodeBuddy Code v2.68.0 发布 ✨ 新功能 Web UI 文档查看器 在 Web UI 中新增文档浏览功能，无需离开工作界面即可查阅 CLI 使用文档： 支持全文搜索，快速定位所需内容 中英文切换，满足不同语言偏好 目录导航和 TOC，方便浏览长文档 API Reference 快捷链接，直接跳转到 Swagger UI 支持在新标签页中独立全屏打开 构建时自动打包 CLI 文档，支持离线查看 🔧 改进优化 HTTP API 标准化：所有公开端点统一到 前缀，支持版本控制；内部端点迁移到 ，结构更清晰 API 文档：新增 Swagger UI（ ）和 OpenAPI 规范（ ），方便开发者探索和调试 API 统一响应格式：公开端点采用标准 / 信封格式，提升 API 一致性 ACP 端点迁移：ACP 协议端点从 迁移到 ，与 REST API 统一路由前缀 凭证存储优化：WeChat 和 WeCom 凭证统一为单文件 格式，支持自动迁移旧格式 API 响应兼容：Web UI 适配统一信封格式，确保 REST 端点响应正确解析 🐛 问题修复 确认框显示：修复 AskUserQuestion 确认框偶发不显示的问题，解决路由导航中的竞态条件 文档链接格式：修正 Channels 文档中 localhost 链接的格式"},{"id":"/cli/release-notes/v2.67.0","title":"🚀 CodeBuddy Code v2.67.0 发布","body":"🚀 CodeBuddy Code v2.67.0 发布 ✨ 新功能 企业微信 Channel Bridge 企业微信 AI Bot 消息现在可以通过 channel 系统直接注入 Agent 会话，支持使用 WeComReply 工具回复 markdown 格式消息，同时支持群聊和私聊场景。 多实例接入与管理 WeChat 和 WeCom 均支持同时连接多个 bot 实例 通过 面板交互式添加和管理连接 WeChat 直接扫码绑定，WeCom 输入 Bot ID + Secret 后自动连接，凭证持久化到磁盘 Web UI 远程控制管理 新增远程控制页面，支持可视化管理渠道连接（连接/断开/解绑/删除），包括 WeChat QR 扫码和 WeCom 表单添加。 企业微信媒体消息支持 WeComReply 工具新增图片、文件、视频等媒体消息的上传与发送能力 支持接收用户发送的图片和文件消息，自动下载解密 改进微信客服的图片和文件消息处理 🔧 改进优化 环境变量控制最大轮次：支持通过 和 环境变量分别控制主 Agent 和子 Agent 的最大执行轮次 企业微信媒体解密：对齐官方 SDK 使用 AES 256 CBC 算法，增加格式自动检测 🐛 问题修复 Rewind 虚假 diff：修复 compact 后 rewind 显示不存在的文件变更问题，compact 消息现在正确继承文件快照状态 PTY 文件描述符泄漏：PTY service 和后台任务的 fd 清理逻辑增强，确保异常路径下也能正确释放资源"},{"id":"/cli/release-notes/v2.66.2","title":"🚀 CodeBuddy Code v2.66.2 发布","body":"🚀 CodeBuddy Code v2.66.2 发布 🐛 问题修复 模型设置同步：修复通过 SDK/控制信号设置模型时选项未同步更新的问题，确保模型选择在所有读取路径上保持一致"},{"id":"/cli/release-notes/v2.66.1","title":"🚀 CodeBuddy Code v2.66.1 发布","body":"🚀 CodeBuddy Code v2.66.1 发布 🔧 改进优化 Channel 权限中继：支持通过 Channel（如微信）确认工具权限请求，声明了权限中继能力的 Channel 不再强制自动批准，而是将确认请求转发给用户 微信权限确认：工具执行需要权限时，通过微信消息发送自然语言确认请求，用户回复 y/n 即可批准或拒绝 微信问答支持：AskUserQuestion 工具在微信中可发送问题选项，用户回复编号或自由文本选择答案 微信计划确认：ExitPlanMode 时自动读取计划摘要并展示给用户，在微信中确认后再开始执行 🐛 问题修复 微信 Channel 回复工具：修复偶发找不到回复工具的问题，消除连接过程中的竞速条件 微信问答重复提示：修复 AskUserQuestion 同时发送问答消息和权限确认消息的问题 微信问答参数解析：修复问答参数为 JSON 字符串时未正确解析的问题"},{"id":"/cli/release-notes/v2.66.0","title":"🚀 CodeBuddy Code v2.66.0 发布","body":"🚀 CodeBuddy Code v2.66.0 发布 ✨ 新功能 思考模式默认开启 全局默认启用 thinking 模式，无需手动配置即可获得更强的推理能力，复杂代码分析和多步骤任务处理更加精准。 🐛 问题修复 Token 计数器：修复右下角 token 计数器始终显示 0 的问题 状态栏成本显示：修复状态栏脚本接收到错误成本数据的问题 状态栏初始化：修复状态栏首次渲染时可能不显示的问题 上下文百分比：修复上下文使用百分比在接近上限时显示不准确的问题 内存泄漏：修复状态栏管理器订阅未正确清理的问题"},{"id":"/cli/release-notes/v2.65.1","title":"🚀 CodeBuddy Code v2.65.1 发布","body":"🚀 CodeBuddy Code v2.65.1 发布 🐛 问题修复 无头模式执行稳定性 移除 headless 模式下固定 60 秒强制退出逻辑，避免长时间运行的 CLI、SDK 或自动化脚本在任务尚未完成时被提前终止。 长耗时请求不再因为固定超时被误中断 提升非交互调用场景下的执行稳定性 更适合持续运行或等待外部响应的自动化流程"},{"id":"/cli/release-notes/v2.65.0","title":"🚀 CodeBuddy Code v2.65.0 发布","body":"🚀 CodeBuddy Code v2.65.0 发布 ✨ 新功能 Channel 消息通道 支持通过 MCP 协议接收外部消息源（如企业微信机器人、微信客服等），实现多通道消息汇聚和处理。 启动界面自动显示已配置的 Channel 列表 对话中以友好格式展示 Channel 来源消息 支持发送者白名单和权限中继等安全管控机制 🔧 改进优化 非交互模式后台任务管控：在 headless、SDK、print 模式下自动禁用后台执行参数，避免非交互环境中产生无法管理的后台任务 🐛 问题修复 后台任务 PTY 泄漏：修复后台任务被终止时未释放 PTY 文件描述符的问题，避免长时间运行后系统资源耗尽"},{"id":"/cli/release-notes/v2.64.2","title":"🚀 CodeBuddy Code v2.64.2 发布","body":"🚀 CodeBuddy Code v2.64.2 发布 🔧 改进优化 登录方式简化：移除启动时的内网环境嗅探逻辑，所有登录方式（含 iOA）始终显示，无需等待网络检测 国内版模型排序：调整国内版模型列表中 glm 5.0 系列的显示顺序，提升选择体验 🐛 问题修复 上下文压缩重复触发：修复压缩完成后立即再次触发压缩的问题，避免不必要的重复压缩循环，提升长对话稳定性 会话持久化异常：修复大工具结果外部化后误同步回内存导致模型无法理解工具输出的问题，确保工具结果正确保存和读取"},{"id":"/cli/release-notes/v2.64.1","title":"🚀 CodeBuddy Code v2.64.1 发布","body":"🚀 CodeBuddy Code v2.64.1 发布 🐛 问题修复 终端分屏稳定性：修复分屏操作导致终端被意外重置的问题，PTY session 仅在用户主动关闭面板时销毁 消息气泡过滤：修复用户消息气泡中偶现系统内部标签内容的问题，确保界面展示干净"},{"id":"/cli/release-notes/v2.64.0","title":"🚀 CodeBuddy Code v2.64.0 发布","body":"🚀 CodeBuddy Code v2.64.0 发布 ✨ 新功能 Web UI 全面增强 Web UI 迎来全面升级，带来焕然一新的使用体验： 全新界面风格：重新设计的侧边栏导航、状态栏和登录页面，统一视觉风格和交互体验 多视图支持：新增历史会话、任务管理、插件管理等视图，信息组织更清晰 品牌加载动画：新增猫爪品牌加载动画，替换通用 spinner 终端优化：支持终端标题显示，主题切换时自动刷新配色 实例管理增强：优化实例管理面板布局和交互 跨会话切换： 命令支持跨会话切换，Web UI 同步更新 🔧 改进优化 大工具结果外部化：工具返回超过 50KB 的结果时，自动保存到磁盘并在对话历史中保留摘要，防止长时间运行会话的内存无限增长 Agent 任务内存清理：定时清理已完成任务记录和过期 Team 成员会话引用，修复长时间运行场景下的内存泄漏 诊断面板增强： 面板新增内存使用量和任务统计信息，便于排查资源问题 TLS 验证跳过：修复无代理场景下禁用 TLS 验证不生效的问题 子代理工具重命名：将 Task 工具重命名为 Agent，命名更准确地反映功能定位 ACP 流优化：POST stream 延迟关闭机制，解决 tunnel 场景下通知丢失问题 Gateway 安全提示：新增风险提示和网络访问配置引导 消息队列修复：取消请求时保留队列消息，避免排队消息丢失 Token 用量修复：修复压缩后百分比虚高导致重复压缩的问题 Rewind 修复：优先使用修改前的文件状态进行恢复，提升回退准确性 🐛 问题修复 问答确认框显示：修复偶发的 AskUserQuestion 确认框\"看不见\"问题，确保导航前服务状态就绪 📝 文档更新 新增 v2.62.1 v2.63.4 共 6 个版本的发布说明 新增环境变量参考文档 更新 HTTP API、设置、故障排除等文档"},{"id":"/cli/release-notes/v2.63.5","title":"🚀 CodeBuddy Code v2.63.5 发布","body":"🚀 CodeBuddy Code v2.63.5 发布 🔧 改进优化 遥测控制：支持通过环境变量禁用遥测数据上报，提升隐私保护灵活性 图片格式识别：支持通过文件魔数（magic bytes）检测图片 MIME 类型，当文件扩展名与实际内容不匹配时仍能正确识别格式"},{"id":"/cli/release-notes/v2.63.4","title":"🚀 CodeBuddy Code v2.63.4 发布","body":"🚀 CodeBuddy Code v2.63.4 发布 🔧 改进优化 SDK 场景稳定性：禁用 SDK 模式下的 CLI 自动更新，防止进程重启导致后续请求瞬间返回，提升 SDK 集成场景的可靠性 会话恢复可靠性：修复重新初始化会话时历史消息未正确清理导致的消息消费异常，确保会话恢复后消息处理正常 子代理进度显示优化：将子代理和 Team 成员进度中的 token 统计从累计消耗量改为当前上下文窗口大小，更直观地反映实时上下文使用情况 E2E 测试增强：客户端自动响应 AskUserQuestion，命令名验证支持 Unicode 字符"},{"id":"/cli/release-notes/v2.63.3","title":"🚀 CodeBuddy Code v2.63.3 发布","body":"🚀 CodeBuddy Code v2.63.3 发布 🔧 改进优化 Subagent 上下文压缩修复：修复子代理（Subagent）在上下文压缩后无法恢复运行的问题，确保长对话场景下子代理执行的稳定性 上下文压缩质量提升：修复压缩过程中内部标签可能泄漏到摘要内容的问题，提升压缩后上下文的准确性"},{"id":"/cli/release-notes/v2.63.2","title":"🚀 CodeBuddy Code v2.63.2 发布","body":"🚀 CodeBuddy Code v2.63.2 发布 🔧 改进优化 超时重试增强：首 token 超时支持最多 2 次重试并增加线性延迟（2s/4s），提高网络波动场景下的恢复成功率 消息队列处理：修复超时错误处理后队列中累积的用户消息无法被处理的问题，确保对话流畅性 状态一致性：修复错误处理中状态重置逻辑的竞态条件，确保重试和队列处理的正确性"},{"id":"/cli/release-notes/v2.63.1","title":"🚀 CodeBuddy Code v2.63.1 发布","body":"🚀 CodeBuddy Code v2.63.1 发布 🐛 问题修复 Malformed JSON 上下文污染修复：修复当 AI 模型偶发生成格式错误的工具调用参数时，错误重试提示未被及时清理的问题。此前，该提示消息会在后续每轮对话中被重复发送给模型，造成上下文污染和不必要的 token 消耗。修复后，重试提示会在下一轮对话中自动清理，保持对话上下文的整洁"},{"id":"/cli/release-notes/v2.63.0","title":"🚀 CodeBuddy Code v2.63.0 发布","body":"🚀 CodeBuddy Code v2.63.0 发布 ✨ 新功能 禁用 TLS 验证 支持通过产品功能开关禁用 HTTPS 请求的 TLS 证书验证，适用于使用自签名证书或内部 CA 证书的私有化部署环境，无需额外配置系统证书即可正常连接。 🔧 改进优化 插件市场埋点：新增插件市场操作埋点，支持追踪市场添加/删除/刷新、插件安装/卸载/启用/禁用等用户行为，帮助优化插件生态体验 Centrifugo 连接策略：关闭 Centrifugo 自动连接，改为按需手动启动，减少不必要的网络开销 配置面板精简：移除 /config 面板中不再使用的 Wecom 配置项，界面更加清爽 🐛 问题修复 自动重试竞态修复：修复网络错误自动重试时， 事件过早触发导致父任务误判子代理失败的问题 超时时间优化：将流式传输超时和首 token 超时从 60 秒提升至 120 秒，减少弱网环境下的误断连 上下文压缩稳定性：修复压缩过程中 abort 信号级联导致会话卡死的问题，提升长对话场景下的可靠性"},{"id":"/cli/release-notes/v2.62.1","title":"🚀 CodeBuddy Code v2.62.1 发布","body":"🚀 CodeBuddy Code v2.62.1 发布 🔧 改进优化 上下文压缩优化：重构压缩摘要注入机制，压缩后的上下文以更结构化的方式恢复，提升长对话中的上下文连贯性；同时提高了自动压缩触发阈值，减少不必要的压缩中断；压缩过程不再混入系统规则和记忆内容，确保摘要更精准 SDK 通信稳定性：修复多个 SDK 通信层的稳定性问题，包括并发写入交错、断连后权限请求挂起、中断响应不完整等；Python SDK 增强了 JSON 缓冲区的容错能力，JS SDK 改进了背压处理机制 企微机器人交互体验：使用流式消息替代静态文本展示处理状态，完成后自动替换为最终结果，聊天记录更加整洁 📝 文档更新 企微机器人文档导航：统一相关文档的侧边栏标题，修复中文版重复条目"},{"id":"/cli/release-notes/v2.62.0","title":"🚀 CodeBuddy Code v2.62.0 发布","body":"🚀 CodeBuddy Code v2.62.0 发布 ✨ 新功能 Delegate Tool 支持（实验性） 新增 DelegateTool 工具，允许 Agent 调用由外部客户端（如 Web UI、IDE 插件）注册的委托工具，实现 UI 查询和 UI 控制等功能。这为 CodeBuddy Code 与外部工具链的集成提供了更灵活的扩展能力。 🔧 改进优化 远程控制重构：将 命令统一为通用 命令，支持多种长连接客户端的统一管理，新增交互式 UI 面板快速选择客户端连接 远程控制本地命令快速执行：新增快速检测本地命令的机制，避免为 、 等本地命令显示不必要的等待提示 模型兼容性增强：新增 OpenAI 模型适配器，自动处理不兼容参数；Gemini 适配器增加 JSON Schema 字段清理，修复工具参数导致的 400 错误 流超时处理优化：将默认流超时从 30 秒调整为 60 秒，新增智能检测避免已完成响应被误判为超时 Bash 工具描述优化：对复杂命令提供更清晰的说明示例，细化危险命令列表 记忆路径结构：项目记忆目录对齐标准路径结构，修复菜单中路径显示不完整的问题 🐛 问题修复 ACP 会话管理：修复 newSession 请求默认复用旧会话的问题，改用 continue 字段显式控制会话复用行为 AbortController 泄漏：统一使用 防止长会话中监听器累积告警"},{"id":"/cli/release-notes/v2.61.3","title":"🚀 CodeBuddy Code v2.61.3 发布","body":"🚀 CodeBuddy Code v2.61.3 发布 🔧 改进优化 启动稳定性提升：修复 CLI 启动时认证初始化超时和远程控制服务异步初始化导致的启动失败问题，提升冷启动成功率 Moonshot 模型兼容性：优化 tool message content 解析逻辑，避免将普通字符串数组（如文件路径列表）错误转换为 content block，提升 Moonshot 模型的工具调用稳定性 插件更新机制优化：改用 fetch + reset 策略替代 pull，解决插件 Git 仓库本地与远端分叉时更新失败的问题 SDK 交互能力修复：修复 SDK 模式下交互式工具（如 AskUserQuestion）被意外禁用的问题，同时确保 Print 模式下正确禁用交互式工具 Web 搜索升级：迁移到新版搜索 API，优化响应解析和错误处理 🐛 问题修复 第三方 API 连接修复：修复使用 模式连接第三方 API 时 Authorization 头被误删导致 401 错误的问题，同时过滤 系列头避免 400 错误"},{"id":"/cli/release-notes/v2.61.2","title":"🚀 CodeBuddy Code v2.61.2 发布","body":"🚀 CodeBuddy Code v2.61.2 发布 🔧 改进优化 企业微信 AI Bot WebSocket 兼容性：将 WebSocket 实现迁移到 W3C 标准 API，同时支持 Bun 和 Node.js 双运行时，提升跨平台兼容性 企业微信 AI Bot 自动连接：新增 启动参数，启动时自动连接企业微信 AI Bot，无需手动执行 命令"},{"id":"/cli/release-notes/v2.61.1","title":"🚀 CodeBuddy Code v2.61.1 发布","body":"🚀 CodeBuddy Code v2.61.1 发布 🔧 改进优化 SDK 版本更新：升级 Agent SDK JS 至 0.3.81，保持 SDK 与 CLI 的版本同步"},{"id":"/cli/release-notes/v2.61.0","title":"🚀 CodeBuddy Code v2.61.0 发布","body":"🚀 CodeBuddy Code v2.61.0 发布 ✨ 新功能 记忆系统全面升级 快捷键记忆保存： 快捷键现在将记忆保存到 CODEBUDDY.md，支持选择 Project 或 User 两种作用域，更灵活地管理个人和项目级偏好 Auto Memory 独立控制：新增 管理面板，支持独立开关 Auto Memory，也可通过 面板切换 Typed Memory（实验性）：支持 4 种结构化记忆类型（user/feedback/project/reference）和 YAML frontmatter 格式，让记忆更有条理 /memory 命令参数调用：支持通过参数直接保存记忆，无需导航到管理页面 🔧 改进优化 工具搜索与执行解耦：ToolSearch 改为返回完整参数 schema 由代理执行，保持上下文前缀稳定以提升 KV 缓存命中率 上下文管理优化：降低 token 使用量告警阈值，使上下文压缩更早触发，减少因上下文过长导致的对话质量下降 Shell 性能优化：优化 PTY fd 泄漏检测机制，避免阻塞事件循环 企业微信机器人超时修复：采用两阶段回复机制避免 30s 流式超时问题，长时间运行的 Agent 任务可正常返回结果 Web UI 会话同步：在 Web UI 中执行 /clear 或新建对话时，CLI 终端视图同步刷新 文件路径补全：Web UI 输入框支持 @ 触发文件路径补全，选中后自动添加空格 提示词建议：Web UI 支持显示 CLI 端生成的 prompt suggestion，按 Tab 快速采纳 🐛 问题修复 工具调用重试：修复模型返回不合法 JSON 参数时直接报 400 错误的问题，现在会告知模型具体的 JSON 解析错误并自动重试 子代理 Hook 隔离：跳过子代理 session 的 Stop/UserPromptSubmit hooks 执行，避免子代理触发主 session 专用的钩子逻辑 SubagentStop Hook 竞态修复：防止多检测路径并发导致 hook 重复触发 权限通配符匹配：修复 等通配符权限规则无法匹配包含路径参数的命令的问题 Web UI 清空会话：修复 /clear 后触发重复 render 循环导致的异常 斜杠指令加载：修复通过 tunnel 访问时斜杠指令列表无法加载的问题"},{"id":"/cli/release-notes/v2.60.0","title":"🚀 CodeBuddy Code v2.60.0 发布","body":"🚀 CodeBuddy Code v2.60.0 发布 ✨ 新功能 企业微信机器人远程控制 支持通过企业微信 AI Bot 长连接远程控制 CodeBuddy Agent，无需公网 IP，使用 命令即可快速接入。同时将远程控制模块重构为可扩展的多客户端注册架构，方便后续接入更多 IM 平台。 🔧 改进优化 自定义模型认证错误优化：自定义模型返回 401 错误时，不再触发自动登出，并提供针对性的 API Key 检查提示；当指定模型不存在时，自动列出当前账户可用的模型列表 恢复会话面板：当前正在使用的会话会以绿色高亮显示并带有勾号标记，方便快速识别 Web 端命令处理：移除客户端侧斜杠命令拦截，统一由服务端处理命令逻辑 🐛 问题修复 图片历史还原：修复图片 blob 引用追踪时序问题，确保历史图片去重判断正确，避免模型收到未解析的 blob 引用 嵌套 Skills 加载：修复包含子 Skills 的目录无法被发现和加载的问题，同时增加扫描深度上限以支持更深层嵌套结构 跳过内部请求头：修复 CODEBUDDYSKIPINTERNALHEADERS 环境变量不生效的问题，确保连接第三方网关时内部请求头被正确清理 Tracing 初始化：修复部分用户终端出现 \"No API key provided for OpenAI tracing exporter\" 报错的问题"},{"id":"/cli/release-notes/v2.59.0","title":"🚀 CodeBuddy Code v2.59.0 发布","body":"🚀 CodeBuddy Code v2.59.0 发布 ✨ 新功能 Hook 驱动的 Worktree 支持 为 SVN、Perforce 等非 Git 版本控制系统提供隔离工作区能力。通过 和 Hook 事件，您可以完全自定义 worktree 的创建和清理逻辑，不再局限于 Git 仓库： 即使在 Git 仓库中，若配置了 Hook，也会优先使用 Hook based 方式 Hook based worktree 退出时始终显示保留/删除菜单，避免非 Git 项目因缺少 Git 命令导致异常 Worktree 指定基础分支 参数现在支持配套使用 来指定基础分支： 支持远程分支（ ）和本地分支（ ）两种格式 分支不存在时自动降级到远程默认分支并打印警告，不中断启动流程 工具同步支持 参数 🔧 改进优化 Plan 模式审批：修复 ExitPlanMode 工具在 Web UI 中审批时无法正确显示 plan 内容的问题，现在用户可以在审批弹窗中看到完整的计划内容和权限请求列表 图片读取去重优化：修复同一路径图片被修改后重新读取时被错误去重的问题，现在能正确识别文件更新并返回最新图片内容 Worktree Hook 兼容性：补齐 和 的 SDK 协议与文档说明，确保自定义 worktree hook 能接收完整上下文并稳定接入 🐛 问题修复 ACP 连接清理：修复新建聊天时旧连接未正确清理，导致广播消息重复渲染的问题"},{"id":"/cli/release-notes/v2.58.0","title":"🚀 CodeBuddy Code v2.58.0 发布","body":"🚀 CodeBuddy Code v2.58.0 发布 ✨ 新功能 微信客服 & 企业微信远程网关 新增微信客服（WeChat KF）和企业微信（WeCom）平台接入能力，支持通过 Webhook 回调接收消息并主动回复。微信客服适配器包含回调签名校验、AES 加解密、syncmsg 消息拉取、客服账号自动创建等完整能力。 🔧 改进优化 Python SDK 认证增强：新增独立认证 API（ / ），支持 two phase 登录流程，重构控制请求机制支持请求 响应匹配和超时处理 Python SDK 类型完善：新增 、 、 等类型定义 SDK 错误诊断改进：Python SDK 新增启动崩溃检测和 stderr 捕获，JS SDK 改进进程退出原因追踪和错误类型导出 Headless 模式稳定性：重构模块导出为三层结构，消除 headless 构建中的 IoC 解析失败 隧道连接优化：强制使用 HTTP/2 替代 QUIC 提升兼容性，支持 detached cloudflared 进程跨会话复用，新增 tunnel state.json 管理多端口并发隧道 插件市场自动更新：市场详情页新增启用/禁用自动更新开关，内置市场默认开启，第三方市场默认关闭 配置缓存隔离：修复 CLI 临时参数（如 ）污染配置缓存的问题 Web UI 改进：历史回放支持展示用户消息中的图片并新增放大查看，子代理支持折叠/展开，工具调用统一可点击 Web UI Bun SFE 兼容：支持将静态文件嵌入 Bun 单文件可执行程序，兼容扁平模式下的资源加载 Gateway 命令体验：启动 Gateway 服务时显示 Loading 动画，防止用户重复操作 任务进度显示优化：优化 loading box 中任务和队友描述的文本截断，避免长文本溢出 🎨 界面优化 暗色主题视觉优化：调暗并统一了暗色模式下各组件的边框颜色，使其在暗色背景下更加柔和自然 🐛 问题修复 Hooks 执行挂起：修复 hook 脚本启动后台进程时导致执行挂起的问题 SubagentStop Hook：修复回调中 transcriptpath 指向不存在文件的问题 子代理交互：修复子代理中 AskUserQuestion 被自动批准导致无法在主界面显示问题面板的问题 Compact 历史链：修复 compact agent 因历史截断导致上下文不完整的问题，修正多条 assistant 消息场景下的分组错误 工具审批导航：修复确认框消失后输入框不可见的渲染问题 模型同步：修复 Web UI 切换模型后 CLI 未同步更新的问题"},{"id":"/cli/release-notes/v2.57.1","title":"🚀 CodeBuddy Code v2.57.1 发布","body":"🚀 CodeBuddy Code v2.57.1 发布 🔧 改进优化 无头模式定时任务能力补齐 无头模式现已补齐定时任务相关能力的导出。在脚本、SDK 和服务端集成场景中，可以更直接地使用定时任务功能，减少额外封装和接入成本。 支持在无头集成场景中直接访问定时任务相关能力 让脚本、SDK 与交互式 CLI 的能力边界更加一致"},{"id":"/cli/release-notes/v2.57.0","title":"🚀 CodeBuddy Code v2.57.0 发布","body":"🚀 CodeBuddy Code v2.57.0 发布 ✨ 新功能 Remote Gateway（Beta） 全新的远程控制功能，支持通过 Cloudflare Tunnel 从任意设备远程访问您的 CodeBuddy Code CLI 会话。内置完整的 Web UI，包含： 远程终端面板，支持分屏布局和实时 WebSocket 通信 交互式问答面板，可在 Web UI 中直接回答 Agent 提问 对话压缩和 Team 进度的可视化展示 安全认证和多客户端同步 定时任务 支持创建定时任务，让 CodeBuddy 按计划自动执行重复性工作。通过简单的 cron 表达式即可设定执行周期，支持查看和取消已创建的任务。 🔧 改进优化 Hook 输出折叠配置：新增 设置项，可通过 面板控制 Hook 输出默认是否折叠 首 token 超时检测优化：改为检测模型有意义的输出，避免服务器心跳导致超时检测失效，并增强重试机制稳定性 子代理 MCP 继承：子代理现在可以正确使用父代理配置的 MCP 服务器工具 Fish shell 键盘兼容：修复在 Fish shell 3.4+ 搭配 Kitty keyboard protocol 终端中按键无响应的问题 工具搜索参数优化：增强参数描述，提供更好的使用指引 🐛 问题修复 API 错误响应处理：修复 API 返回错误时（如频率限制）UI 卡住的问题 MCP OAuth 认证：修复 OAuth Provider 缓存查找失败的问题，确保认证流程稳定可靠 内存泄漏警告：修复长时间运行时 abort 监听器超出上限导致的 MaxListenersExceededWarning 流式输出格式：修复 JSON 输出的格式和完整性问题 Hooks 中文编码：修复 Windows 上 Hook 修改工具参数时中文内容乱码的问题"},{"id":"/cli/release-notes/v2.56.1","title":"🚀 CodeBuddy Code v2.56.1 发布","body":"🚀 CodeBuddy Code v2.56.1 发布 🐛 问题修复 对话压缩显示：修复压缩对话组的完成判断逻辑，改为检查是否包含 assistant 回复而非固定消息数量，避免在特殊情况下压缩状态显示异常"},{"id":"/cli/release-notes/v2.56.0","title":"🚀 CodeBuddy Code v2.56.0 发布","body":"🚀 CodeBuddy Code v2.56.0 发布 ✨ 新功能 Worktree PR 支持 支持从 CNB (Code Nebula Buddy) 平台 PR 链接创建 worktree，包括 cnb.woa.com 和 cnb.cool 等域名。在 worktree 中可以直接基于 PR 进行代码审查和修改。 🔧 改进优化 新增 GPT 5.4 模型：支持 272K 输入、128K 输出，具备推理和图片能力 MCP 面板优化：移除边框，按配置来源分组展示服务器列表，支持诊断信息展示，界面更加清晰直观 模型兼容性层：新增模型兼容性处理器，自动适配 Gemini、Moonshot 等第三方模型的 API 请求格式差异，减少手动配置 错误诊断增强：改进模型请求和 SDK Transport 的错误日志，支持流式错误响应体读取和进程关闭原因捕获，便于排查问题 工具搜索优化：将搜索和激活操作拆分为独立参数，提升调用清晰度；未匹配的工具名自动回退模糊搜索 用户查询标识：为用户消息添加标签包裹，帮助模型更准确地区分用户实际查询与系统上下文内容 📝 文档更新 MCP 环境变量扩展文档：新增环境变量扩展使用文档，包含语法说明、配置字段支持、示例和常见用例"},{"id":"/cli/release-notes/v2.55.1","title":"🚀 CodeBuddy Code v2.55.1 发布","body":"🚀 CodeBuddy Code v2.55.1 发布 🔧 改进优化 MCP 环境变量默认值：MCP 配置新增 语法支持，当环境变量未设置时自动使用指定的默认值，简化 MCP 服务器配置流程 Worktree 初始化优化：改进 symlink 创建逻辑，支持文件和目录类型自动检测及冲突处理；优化 文件处理，提升大型仓库性能 Hooks Windows 路径兼容：修复 Windows 上 Git Bash 执行 hook 时路径使用反斜杠导致的解析问题，统一转换为 Unix 风格路径 🐛 问题修复 SDK 认证修复：修复登录时认证 URL 被错误覆盖的问题 环境配置保护：修复用户通过 或 显式设置的网络环境被自动覆盖的问题 SessionStart hook 竞态修复：修复首轮消息可能在 SessionStart hook 完成前被处理，导致注入的上下文丢失的问题"},{"id":"/cli/release-notes/v2.55.0","title":"🚀 CodeBuddy Code v2.55.0 发布","body":"🚀 CodeBuddy Code v2.55.0 发布 ✨ 新功能 Git Worktree 支持 全新的 Worktree 功能让你可以在独立的工作目录中并行开发，互不干扰： 使用 参数启动隔离的开发环境，安全地进行实验性修改 配合 参数在独立的 tmux 会话中运行，适合长时间任务 Agent 可通过 EnterWorktree 工具在会话中动态创建和进入 worktree 子代理任务自动继承 worktree 工作目录，确保文件操作路径正确 支持 和 事件钩子，可自定义 VCS 集成 退出时自动检测变更，提供清晰的操作选项，无变更的 worktree 自动清理 🔧 改进优化 工具搜索优化：ToolSearch 支持搜索和激活双模式，搜索模式下分层展示已激活工具和候选工具，激活模式下支持按名称精确激活 状态栏折行显示：状态栏长文本支持自动折行，不再截断隐藏超出部分 Diff 宽字符适配：修复 Diff 视图中包含中文、Emoji 等宽字符时折行位置不准确的问题 消息识别优化：优化用户消息识别逻辑，排除框架自动发送的队友消息"},{"id":"/cli/release-notes/v2.54.0","title":"🚀 CodeBuddy Code v2.54.0 发布","body":"🚀 CodeBuddy Code v2.54.0 发布 ✨ 新功能 Skills 嵌套子目录 支持在 目录中使用子目录来组织 Skills。嵌套的 Skill 会自动生成冒号分隔的限定名称（如 ），同时也支持短名称匹配，让 Skills 管理更加灵活有序。 🔧 改进优化 启动优化：避免 PromptContext 初始化过程中的重复执行，并发请求复用同一初始化结果，提升启动速度 模型选择优化：改进不同代理模式下的模型选择机制，提升配置灵活性 MCP 配置环境变量展开：MCP 服务器配置中的 占位符会自动替换为对应环境变量值，支持 stdio 的 command/args/env 和 SSE/HTTP 的 url/headers 字段，缺失的变量保留原样并生成诊断提示 上下文压缩稳定性：修复自动压缩流程中消息入队导致压缩不执行的问题，增强中断等待的健壮性；修复压缩过程中内部续行消息在聊天界面异常展示的问题 Vim 词移动增强：Vim 模式和快捷键的词移动（w/b/e）现在正确支持中日韩字符，每个 CJK 字符视为独立词 Gzip 压缩判断优化：当用户配置了自定义 API 地址或模型使用自定义 URL 时自动跳过 gzip 压缩，避免第三方服务不支持 gzip 导致请求失败 Hook 输出编码修复：修复在中文 Windows 系统上，Hook 脚本的错误信息显示为乱码的问题 /skills 面板增强：Skills 面板现在同时展示自定义斜杠命令，分组标题包含来源目录路径；Token 计数改为只统计描述部分，避免对上下文占用产生误解 截断重试优化：当工具调用参数过长导致输出被截断时，重试提示会根据工具类型给出具体的拆分建议；修复可能导致无限重试的循环问题 远程控制稳定性：优化 WebSocket 适配器实现和会话处理逻辑，提升连接稳定性 任务面板刷新：修复任务详情视图在任务状态更新时未同步刷新的问题 🐛 问题修复 Plan 确认框显示：修复退出 Plan 模式确认框中错误显示 \"Loading plan...\" 的问题，现在会正确加载并展示 Plan 内容 Custom Agents 来源显示：修复 命令中插件来源的 Custom Agent 显示 的问题"},{"id":"/cli/release-notes/v2.53.0","title":"🚀 CodeBuddy Code v2.53.0 发布","body":"🚀 CodeBuddy Code v2.53.0 发布 ✨ 新功能 企业微信远程控制 支持通过企业微信远程控制 CLI，实现移动端任务下发和结果推送。随时随地通过手机管理你的开发任务，不再局限于终端前操作。 🔧 改进优化 MCP 动态工具更新：支持 MCP 服务器的 通知，工具列表变化时自动刷新，无需重启或手动重连 Reasoning Effort 配置：在 /config 面板新增 Reasoning Effort 设置项，支持 auto/low/medium/high/xhigh 五个级别，自定义模型推理深度 状态栏增强：新增会话名称、权限模式、上下文窗口使用情况等字段，支持多行渲染，样式优化 LSP 服务器懒加载：LSP 服务器默认采用懒加载模式，仅在首次使用时启动，减少启动时资源占用 错误追踪增强：WebSearch 和 ImageGen 工具在 API 调用失败时，错误信息中包含 requestId，便于问题定位 非交互模式优化：改进 print 模式下工具权限被拒绝时的提示信息，提供清晰的绕过指引 文件自动补全刷新：修复输入 时无法提示新增文件的问题，文件列表缓存会在过期后自动刷新 Skill 工具结果优化：改进 Skill 和斜杠命令执行后的结果消息格式，使返回内容更清晰 Hook 输入处理器：新增 扩展点，支持在 Hook 执行前注入上下文字段 ACP 错误处理：改进 ACP 模式下的错误信息传输，客户端可获取更详细的错误状态码 🐛 问题修复 对话历史恢复：修复执行 compact 后 resume 会话时丢失压缩前上下文的问题 Team 中断信号隔离：子代理不再监听主 Session 的 abort 信号，避免内部操作误杀 Teammate 工具确认框冲突：修复多个 Teammate 同时请求权限时确认框互相覆盖的问题 消息投递可靠性：优化 Teammate 消息投递重试机制，未就绪时保持消息未读状态等待下次轮询 空闲唤醒机制：Teammate 空闲时收到消息会自动唤醒 Agent，不再卡在队列中 全局锁超时：工具审批全局锁增加 30 秒超时保护，防止死锁"},{"id":"/cli/release-notes/v2.52.6","title":"🚀 CodeBuddy Code v2.52.6 发布","body":"🚀 CodeBuddy Code v2.52.6 发布 🔧 改进优化 模型请求日志增强：新增请求生命周期完整日志，包含请求发送、首 Token 到达、流式传输进度、完成/错误/超时等关键节点，支持通过 requestId 和 agent 名称快速定位问题 消除运行时警告：修复长对话中出现的 MaxListenersExceededWarning 警告，封装统一的中止控制器管理工具，提升长会话下的稳定性 Hook 消息渲染增强：Hook 消息现在会根据执行状态（成功/阻断/警告/错误）显示不同的图标和颜色，并支持展开/折叠查看详细内容，提升可读性"},{"id":"/cli/release-notes/v2.52.5","title":"🚀 CodeBuddy Code v2.52.5 发布","body":"🚀 CodeBuddy Code v2.52.5 发布 🔧 改进优化 图片历史优化 对话历史中的图片数据通过 BlobStore 去重存储，仅最近 N 轮保留完整图片，更早轮次自动替换为文本占位符，显著降低上下文 token 消耗。同一轮对话中重复读取相同图片时返回引用提示而非重复发送完整数据。 主题系统重构 扩展主题色彩体系，支持语义化颜色（如 success、warning、error、info 等），增强终端颜色兼容性。新增 ChalkFactory 智能检测终端能力，自动适配颜色级别，支持色盲友好主题。 Gzip 压缩兼容修复：修复企业地址登录时请求体被错误压缩的问题，仅在 SaaS 和 iOA 环境下启用 gzip 压缩 自定义模型 URL 处理：自动为自定义模型的 URL 补全 后缀，用户无需手动拼接完整路径 Bash 超时配置：支持通过 settings env 动态配置 Bash 工具超时时间 🐛 问题修复 Hooks 命令执行：修复 等包含引号的 hook 命令执行失败的问题 登出竞态修复：修复登出过程中异步操作未及时终止，导致 session 被重新写回的问题 会话压缩标识修正：修复异步上下文压缩后会话身份被误判的问题，确保压缩消息正确归属主会话"},{"id":"/cli/release-notes/v2.52.4","title":"🚀 CodeBuddy Code v2.52.4 发布","body":"🚀 CodeBuddy Code v2.52.4 发布 🔧 改进优化 首 token 超时检测 新增请求发出后首个响应数据的超时检测机制，超时后自动断开并重试，避免长时间无响应的等待。同时将流数据监控间隔从 10 秒缩短至 1 秒，提升异常连接的检测速度。支持通过 和 环境变量自定义超时时间。 请求压缩 支持对 API 请求体进行 gzip 压缩，减少网络带宽消耗，提升慢速网络下的响应速度。 CLI 子命令别名：为 、 、 添加 简写别名，为 和 添加 选项 macOS 代码签名：修复 macOS 26+ 上因缺少 TeamIdentifier 导致多实例运行时被系统终止的问题 MCP 工具钩子修复：解决 MCP 工具的 PreToolUse/PostToolUse 钩子无法正确触发的问题 工具调用截断重试：优化模型输出超限导致工具调用参数被截断时的重试机制，提升重试成功率 Hook 权限确认提示优化：PreToolUse Hook 返回 ask 决策时，将决策原因以警告样式展示在权限确认框中 粘贴行为优化：粘贴文本内容时不再自动检测是否为图片路径并转换，粘贴的文字始终原样插入 Shell 配置统一：移除对 PowerShell 和 CMD 的支持，统一要求 Windows 用户使用 Git Bash 模型升级：将 Gemini Pro 模型从 3.0 版本升级至 3.1 版本 🐛 问题修复 输入历史导航：修复按上键浏览历史时，滚动到以 开头的条目后无法继续滚动的问题 工具权限拒绝渲染：修复 PreToolUse hook 拒绝和权限规则拒绝时工具调用无法在 UI 中正常渲染的问题 命令解析：修复 Bash 工具在命令包含未定义环境变量时无法正确识别命令根的问题 子命令路由：修复使用别名调用子命令时路由路径错误的问题"},{"id":"/cli/release-notes/v2.52.3","title":"🚀 CodeBuddy Code v2.52.3 发布","body":"🚀 CodeBuddy Code v2.52.3 发布 🔧 改进优化 Gemini 生图模型：新增 Gemini 3.0 Pro Image、Gemini 3.1 Flash Image、Gemini 2.5 Flash Image 三个生图模型，支持文生图和图生图功能 Ctrl+D 退出优化：Ctrl+D 仅在输入框为空且没有进行中的对话时才触发双击退出流程，避免误操作 Windows Shell 兼容性：修复 Windows 环境下 Shell 路径选择逻辑和 shell snapshot 功能，确保优先使用 Git Bash，改进配置文件检测和编码处理，正确识别 fish、tcsh 等非 POSIX shell MCP 配置增强： 参数同时支持文件路径和直接 JSON 格式；非项目作用域的 MCP 服务器跳过审批检查，减少不必要的确认操作 依赖升级：升级 OpenAI Agents SDK 至 0.5.2，OpenAI SDK 至 v6 🐛 问题修复 插件列表显示：修复缓存清除后插件 skills 无法正确加载的问题"},{"id":"/cli/release-notes/v2.52.2","title":"🚀 CodeBuddy Code v2.52.2 发布","body":"🚀 CodeBuddy Code v2.52.2 发布 🔧 改进优化 自定义令牌认证：支持从 ACCPRODUCTCONFIG 环境变量中识别 custom token 认证配置，修复配置已加载但同步未完成时的认证回退问题 会话加载性能优化： 命令加载历史会话时使用并行读取，减少等待时间 插件加载提速：并行化插件加载流程，多插件场景下启动速度提升数倍 🐛 问题修复 /doctor 命令：修复 session 为空时可能导致属性访问错误的问题 SDK Python 构建脚本：更新 goreleaser 输出目录路径以匹配 headless 构建产物命名，移除未使用的导入"},{"id":"/cli/release-notes/v2.52.1","title":"🚀 CodeBuddy Code v2.52.1 发布","body":"🚀 CodeBuddy Code v2.52.1 发布 🔧 改进优化 启动与稳定性 版本查询秒回： / 不再触发完整初始化流程，响应速度大幅提升 管道环境兼容：在非 TTY 环境下执行子命令时不再等待 stdin 输入，避免流程卡住 认证超时保护：网络不通时认证初始化会自动超时，不再导致 CLI 无限等待 团队成员切换体验优化 即时切换：使用左右方向键即时切换团队成员视图，无需回车确认，操作更流畅 快捷进入/退出：按下键进入选择模式并默认选中 @main，按上键或 Esc 退出 输入历史隔离：历史导航与成员选择模式互不干扰，清空输入框自动退出历史导航 SDK 改进 Python SDK MCP Server 简化：可直接传入 server 对象，无需手动构造字典 JS SDK 可执行文件配置：支持通过 和 自定义 CLI 可执行文件路径和参数 内部请求头过滤：支持通过 环境变量清理内部请求头，避免干扰第三方 API 网关 🐛 问题修复 Skill 加载：修复插件中的 Skill 偶发无法加载的问题，确保初始化顺序正确 Skill 调用：修复 的 Skill 无法被模型自动调用的问题 Team 成员颜色：修复并发生成 Team 成员时颜色索引重复的问题 子代理并发稳定性：修复大量并发子代理时产生的 MaxListenersExceededWarning"},{"id":"/cli/release-notes/v2.52.0","title":"🚀 CodeBuddy Code v2.52.0 发布","body":"🚀 CodeBuddy Code v2.52.0 发布 ✨ 新功能 团队视图切换 支持通过方向键在不同团队成员视图之间快速切换。按 进入切换模式， 选择成员， 确认切换到成员视图，实时查看对话历史和工作进度。切换时自动同步高亮预览和输入框边框颜色，让你随时掌握每个成员的工作状态 Headless 模式 新增轻量级 headless 构建（体积减少 45%），支持 、 、 快速启动，适用于 CI/CD 管道和自动化集成场景 🔧 改进优化 启动性能大幅提升：优化启动流程，Application.start() 耗时降低 96%，内存占用减少 31%，启动体验更加流畅 Bun 原生优化：使用 Bun 原生 API 替代第三方依赖（PTY、glob、semver 等），提升运行时性能 依赖精简：移除不再需要的依赖项，减小安装体积 认证时序修复：确保认证在 API 调用前完成，消除冷启动时偶发的 401 错误 模型排序优化：调整国内版默认模型优先级顺序，常用模型更容易选择 命令执行稳定性：优化命令执行与环境初始化流程，减少异常情况下的执行中断 认证体验增强：增强 API Key Helper 获取令牌过程的健壮性，提升认证流程稳定性 错误处理升级：将错误处理从字符串匹配升级为自定义错误类，提升错误识别的可靠性 流超时自动重试：当模型流式响应超时时自动重试，无需手动操作。支持通过环境变量 自定义超时时间 命令建议过滤：不可直接调用的 Skill 不再出现在斜杠命令建议列表中，保持菜单整洁 🐛 问题修复 团队成员工具权限确认：修复团队成员执行工具时跳过权限确认的问题，现在团队成员会正确继承主 Agent 的权限模式；权限确认框中显示成员名称和专属颜色，便于区分来源 插件 MCP 配置兼容：修复插件 不支持扁平格式的问题，现在同时兼容包装格式和扁平格式 团队成员状态显示：修复团队成员正常完成任务后因清理流程被错误标记为失败的问题，已完成的成员现在正确显示完成状态"},{"id":"/cli/release-notes/v2.51.2","title":"🚀 CodeBuddy Code v2.51.2 发布","body":"🚀 CodeBuddy Code v2.51.2 发布 🔧 改进优化 新增模型支持：添加 Gemini 3.0 Pro 和 Gemini 3.0 Flash 模型配置，您现在可以在模型选择中使用这两款 Google 最新一代模型，享受更强的推理能力和更快的响应速度"},{"id":"/cli/release-notes/v2.51.1","title":"🚀 CodeBuddy Code v2.51.1 发布","body":"🚀 CodeBuddy Code v2.51.1 发布 🔧 改进优化 Ctrl+N/P 快捷键映射：支持使用 Ctrl+N/Ctrl+P 替代方向键 ↓/↑，在输入框、选择菜单、确认面板等所有场景中均可使用，为习惯 Emacs 键位的用户提供更顺畅的操作体验 Loading 状态 Token 展示优化：修复主 agent 等待 subagent 时 token 显示为 0 的问题，现在能正确展示实时流式 token 变化；subagent 和 Team 成员进度行均支持实时流式 token 展示 会话级授权同步：在子代理执行过程中选择\"本次会话不再询问\"时，授权现在会同步到主会话和所有子代理，避免重复弹出相同的权限确认 MCP 连接超时保护：为 MCP 服务器连接等待添加超时机制，防止在 headless 模式下因服务器无响应而无限挂起 Team 通知机制优化：重构后台任务完成通知，改用邮箱延迟去重机制，避免重复通知干扰对话流；修复队列消息丢失发送者身份的问题 新增模型支持：添加 GPT 5.3 Codex 模型配置 Agent Teams 设置显示：设置面板中 Agent Teams 默认状态现在正确显示为开启 🐛 问题修复 自定义命令覆盖内置命令：修复自定义斜杠命令和 Skill 无法覆盖同名内置命令的问题，现在按项目级 用户级 内置的优先级正确覆盖 启动界面渲染：修复欢迎 Banner 重复渲染以及信任对话框与 Banner 内容重叠的显示问题 后台任务查询：修复后台 Agent 启动后通过 TaskOutput 查询时报 \"not found\" 的问题"},{"id":"/cli/release-notes/v2.51.0","title":"🚀 CodeBuddy Code v2.51.0 发布","body":"🚀 CodeBuddy Code v2.51.0 发布 🎉 新功能 记忆目录摘要 系统提示词中新增记忆文件列表摘要，展示文件名、大小、修改日期及首行标题。AI 助手现在可以一眼看到您有哪些记忆文件，并按需加载相关内容，避免将所有记忆文件内容塞入上下文，大幅节省 Token 消耗。 记忆文件自动清理 会话历史清理时同步清理过期记忆文件，复用相同的保留期配置。再也不用担心 目录无限增长了。 🔧 改进优化 Skills 支持内联 Shell 命令：Skills 的 SKILL.md 现在支持 ! 语法执行 Shell 命令，与斜杠命令保持一致的处理管道，让 Skills 编写更加灵活 Skill 斜杠命令分发：支持通过 或 直接调用已注册的 Skill，未匹配到内置命令时自动回退到 Skill 查找，提升命令使用的流畅度 斜杠命令菜单优化：描述过长时自动截断，避免菜单项跨多行显示，界面更整洁 YAML 解析增强：支持折叠块标量语法（ 、 ），正确将多行描述折叠为单行 模型系数更新：更新各模型的计费系数至最新值，新增部分模型支持，计费更准确 🐛 问题修复 确认框滚动修复：修复权限确认框、计划确认框和编辑确认框内容超过终端高度时滚动条自动跳到顶部的问题，长内容确认体验更顺畅 自定义子代理工具继承：修复自定义子代理在未配置工具列表时会继承创建子代理能力的问题，避免意外的递归调用"},{"id":"/cli/release-notes/v2.50.7","title":"🚀 CodeBuddy Code v2.50.7 发布","body":"🚀 CodeBuddy Code v2.50.7 发布 🔧 改进优化 Team 成员焦点导航 使用 Team 协作时，现在可以通过 Shift+↑/↓ 在各成员之间切换视图，实时查看成员的对话历史、执行进度和 Token 消耗情况，按 Ctrl+O 可快速返回主视图。 成员消息直达：聚焦到某个成员后，输入框自动切换为向该成员发送消息模式，使用 @main 可将消息路由回主代理 消息路由增强：SendMessage 工具支持 \"main\" 别名，用户消息注入成员会话时不再添加多余的 XML 包装 🐛 问题修复 子代理 AbortSignal 监听器泄漏：修复子代理中 abort 事件监听器在错误的 AbortSignal 上注册和移除的问题，消除级联中断时的异常报错 成员会话恢复：修复子代理重启时订阅丢失导致 0 token 的问题，修复 agentend 事件竞态条件"},{"id":"/cli/release-notes/v2.50.6","title":"🚀 CodeBuddy Code v2.50.6 发布","body":"🚀 CodeBuddy Code v2.50.6 发布 🔧 改进优化 高危命令识别规则优化：大幅减少误杀率，细化 CRITICAL/HIGH/MEDIUM 三级风险判定规则。常见开发命令如 、 、 、 等不再被错误拦截，提升日常开发流畅度 权限规则安全分层：将 allow 规则按来源区分为可信（用户设置）和不可信（项目设置），防止恶意仓库通过项目配置文件注入权限规则绕过安全检查，增强供应链安全防护 安全白名单扩展：新增 50+ 常见开发工具命令到安全白名单，涵盖构建工具、测试框架、包管理器、代码质量工具等，减少不必要的授权弹窗 子代理模型配置优化：为 MiniMax M2.5 和 Kimi K2.5 模型补充 relatedModels 配置，确保子代理在使用这些模型时能正确选择对应的轻量级和推理模型变体 🐛 问题修复 进程僵死修复：修复关闭终端后进程不退出且 100% CPU 占用的问题 Shell 句柄泄漏修复：修复多处 Shell 执行句柄未正确释放的问题，防止 PTY 文件描述符泄漏 node pty fd 泄漏修复：检测并在 dispose 时关闭 node pty 内部泄漏的额外 ptmx 文件描述符 诊断增强：在 /doctor 面板中添加 Active PTYs 计数，便于检测潜在的 PTY 泄漏"},{"id":"/cli/release-notes/v2.50.5","title":"🚀 CodeBuddy Code v2.50.5 发布","body":"🚀 CodeBuddy Code v2.50.5 发布 ✨ 新功能 Bash 专用子代理 新增 Bash 内置子代理，专注于命令行任务执行。当 AI 需要执行 git 操作、运行构建工具、执行测试等终端任务时，会自动调用轻量级 Bash 子代理快速完成，提升命令执行效率。 命令安全检测 新增 Bash 命令注入检测机制，自动识别并拦截包含反引号替换、 命令替换、换行符注入等潜在危险构造的命令，增强终端操作安全性。 🔧 改进优化 子代理工具配置优化：调整 Plan 子代理工具集，新增团队协作工具支持；精简 Explore 子代理工具，减少不必要的工具加载 子代理标签显示优化：子代理名称统一使用前景色文字显示，视觉更简洁一致"},{"id":"/cli/release-notes/v2.50.4","title":"🚀 CodeBuddy Code v2.50.4 发布","body":"🚀 CodeBuddy Code v2.50.4 发布 🔧 改进优化 后台任务体验升级 后台 Agent 现在自动创建轻量级团队，通过 SendMessage 回传结果，无需再使用 TaskOutput 手动轮询。后台任务完成后自动通知主 Agent，整体交互更流畅。UI 进度展示也进行了统一，后台任务纳入 TeammateProgressView 集中展示。 启动性能优化：优化首次启动时的初始化流程，并行化注册流程，启动速度提升约 10% 终端渲染优化：统一所有动画组件为全局单一时钟驱动，减少独立定时器导致的终端闪动 消息渲染修复：修复消息完成后不显示、需要 resize 终端才能看到的问题 内存泄漏修复：修复 导致内部输出缓冲区无限累积的问题 任务清理修复：修复失败的子任务未被正确清理导致进度显示残留的问题 🐛 问题修复 Bash 工具输出修复：修复 Bash 工具执行结果下方偶尔出现多余空白行的问题"},{"id":"/cli/release-notes/v2.50.3","title":"🚀 CodeBuddy Code v2.50.3 发布","body":"🚀 CodeBuddy Code v2.50.3 发布 🐛 问题修复 模块加载兼容性修复：修复 在某些打包环境下因 不可用导致模块加载失败的问题，提升运行时兼容性"},{"id":"/cli/release-notes/v2.50.2","title":"🚀 CodeBuddy Code v2.50.2 发布","body":"🚀 CodeBuddy Code v2.50.2 发布 🔧 改进优化 MCP Remote 传输类型：新增 传输类型支持，允许通过远程 HTTP 连接 MCP 服务器，扩展了 MCP 的连接方式 构建速度提升：切换到 Rspack 拷贝插件并将 patch 脚本并行化，加快项目构建速度 任务进度显示优化：已完成的子任务在全部执行完毕后自动清除，避免大量已完成条目累积占据屏幕空间，保持界面整洁 🐛 问题修复 粘贴 URL 误判修复：修复粘贴以 或 开头的 URL 时被错误识别为文件路径的问题"},{"id":"/cli/release-notes/v2.50.1","title":"🚀 CodeBuddy Code v2.50.1 发布","body":"🚀 CodeBuddy Code v2.50.1 发布 🔧 改进优化 文档导航优化：将 Agent Teams 文档移至 Sub Agents 之后，使导航结构更符合功能关联性，方便用户按逻辑顺序查阅文档 🐛 问题修复 配置文件注释保留：修复保存 MCP 配置时 mcpServers 字段下的 JSONC 注释丢失的问题，确保用户在配置文件中添加的注释不会被意外删除"},{"id":"/cli/release-notes/v2.50.0","title":"🚀 CodeBuddy Code v2.50.0 发布","body":"🚀 CodeBuddy Code v2.50.0 发布 ✨ 新功能 Agent Teams 多智能体协作 全新的 Team 功能让多个 Agent 可以协同工作，通过 TeamCreate、TeamDelete、SendMessage 等工具实现任务分配和消息传递。Agent 工具扩展支持 teammate 生成，TaskList 支持团队任务协调，适用于复杂项目的并行处理场景。可通过环境变量灵活控制 Team 功能的启用与关闭。 🔧 改进优化 子代理任务展示优化：后台任务以 样式展示实时进度，同步任务进度集成到 loading spinner 中，界面更简洁 任务完成通知增强：通知消息包含执行时长、工具调用次数和 token 用量等统计信息，方便了解任务执行情况 后台任务资源清理：子代理结束时自动清理关联的后台 shell 任务，避免资源泄漏 TaskOutput 超时调整：默认超时从 30s 提升到 120s，默认阻塞等待完成，减少超时中断 延迟加载工具修复：修复延迟加载工具通过搜索激活后仍报 \"Tool not found\" 的问题，未激活时自动激活并提示重试 工具搜索结果优化：搜索结果改为简洁文本格式，未展开时即可看到工具名称和描述 MCP 服务器管理改进：修复移除 MCP 服务器后配置未实际删除的问题；SDK 注册的 MCP 服务器现在会在初始化时自动连接并立即可用 SDK 参数格式统一：JS 和 Python SDK 的 CLI 参数格式标准化为 风格 Plan Mode 交互优化：拒绝计划时区分\"继续规划\"和\"退出规划模式\"两种操作，避免被困在不可恢复的规划循环中 队列消息显示优化：支持中文字符宽度感知的智能截断，自适应终端宽度 Memory 功能默认启用：将 Memory 功能的默认值调整为开启状态 🐛 问题修复 依赖注入稳定性：修复单例组件在循环依赖场景下可能被重复实例化的问题"},{"id":"/cli/release-notes/v2.49.7","title":"🚀 CodeBuddy Code v2.49.7 发布","body":"🚀 CodeBuddy Code v2.49.7 发布 ✨ 新功能 GLM 5.0 模型支持 新增 GLM 5.0 大语言模型，支持 200K 上下文窗口和 48K 输出 token，为国内版和 iOA 版用户提供更强大的推理能力选择。"},{"id":"/cli/release-notes/v2.49.6","title":"🚀 CodeBuddy Code v2.49.6 发布","body":"🚀 CodeBuddy Code v2.49.6 发布 🔧 改进优化 SDK MCP 初始化时序优化：修复 SDK 模式下 MCP 服务器注册与 prompt 处理的竞态问题，确保 MCP 工具在 prompt 处理前完成就绪，避免工具调用失败 Headless 模式检测改进：优化 headless 模式识别逻辑，支持 ACP 模式和非 TTY 环境的自动检测 MCP 配置文件路径支持：SDK 的 mcpServers 参数新增支持文件路径字符串格式，简化配置方式 ACP SDK 升级：升级 ACP SDK 至 0.14.1 版本，修复终端输出字节限制参数类型兼容性问题 CI 配置优化：为 bot 配置添加 npcName 参数支持"},{"id":"/cli/release-notes/v2.49.5","title":"🚀 CodeBuddy Code v2.49.5 发布","body":"🚀 CodeBuddy Code v2.49.5 发布 🔧 改进优化 MCP 服务器就绪检测：修复 SDK 模式下 MCP 工具在初始化时可能未就绪的问题，确保工具在首次调用时已完全初始化 构建优化：移除 Bun 编译中不再需要的构建标志，简化二进制打包流程 🐛 问题修复 会话压缩挂起修复：修复了 ACP 会话在压缩消息日志后可能永久挂起的问题，增加了超时保护机制防止异常情况下的永久阻塞 会话历史恢复：修复查找最后消息 ID 时未正确跳过自定义消息项的问题，避免恢复会话时定位到错误的消息位置"},{"id":"/cli/release-notes/v2.49.3","title":"🚀 CodeBuddy Code v2.49.3 发布","body":"🚀 CodeBuddy Code v2.49.3 发布 🔧 改进优化 模型错误提示优化：当模型不可用时，自动展示当前账号支持的模型列表，方便用户快速切换到可用模型 错误处理：优化了被封装的模型行为错误（ModelBehaviorError）的处理逻辑，确保工具调用失败时能够正确识别并重试 MCP 服务器就绪检测：修复 SDK 模式下 MCP 工具在初始化时可能未就绪的问题"},{"id":"/cli/release-notes/v2.49.2","title":"🚀 CodeBuddy Code v2.49.2 发布","body":"🚀 CodeBuddy Code v2.49.2 发布 🔧 改进优化 跨会话任务列表共享 支持通过环境变量 在不同会话间共享任务列表，便于多终端协作和持续任务追踪。 示例： 日期格式优化 系统信息中的日期显示现在包含星期信息，使用更友好的格式，提升可读性。例如： 。 🐛 问题修复 会话切换权限保持 修复切换会话时权限模式未保留的问题，确保切换后延续当前的权限设置。之前切换会话后权限模式会意外重置，现在会正确保持。 拦截器重试机制 修复了当模型响应拦截器触发自动重试时，视图层仍然输出原有失败结果的问题。现在拦截器启动重试后，会正确抑制失败结果的输出，仅显示重试后的成功响应。 ACP 流式模式中断优化 中断状态竞态条件：修复 ACP 流式模式下中断状态因共享 RunState 被后续运行修改导致的竞态问题，改用事件快照缓存中断状态 结果消息查找：改进最终助手消息查找逻辑，支持从响应输出中反向搜索已完成消息，并在未找到时回退到会话历史 🔨 构建优化 构建工具升级：升级 goreleaser、bun、uv 至最新版本 Bun 编译优化：启用字节码编译和 ESM 格式，提升启动性能"},{"id":"/cli/release-notes/v2.49.1","title":"🚀 CodeBuddy Code v2.49.1 发布","body":"🚀 CodeBuddy Code v2.49.1 发布 🔒 安全加固 沙箱配置文件保护：沙箱模式下自动禁止写入 CodeBuddy 配置文件（settings.json），防止通过注入 hooks 实现沙箱逃逸攻击；文件系统拒绝规则同步应用到 Write、Edit 等文件操作工具，确保安全策略全面一致 🔧 改进优化 会话列表过滤：过滤子代理和压缩分支会话，确保会话列表和最近会话仅展示用户真实会话 SDK 文档修复：修复认证配置链接中的括号格式问题 🐛 问题修复 会话历史定位：修复了切换会话或恢复历史时， 可能错误指向无 ID 的自定义消息（如摘要、主题）导致对话链断裂的问题"},{"id":"/cli/release-notes/v2.49.0","title":"🚀 CodeBuddy Code v2.49.0 发布","body":"🚀 CodeBuddy Code v2.49.0 发布 ✨ 新功能 使用洞察报告 新增 命令，生成 AI 驱动的使用洞察分析报告。报告涵盖交互风格、项目领域、摩擦点、亮点、改进建议等多个维度，帮助您更好地了解和优化自己的 AI 协作模式。支持在浏览器中查看 HTML 格式的可视化报告。 🔧 改进优化 统计数据准确性：优化 token 用量统计逻辑，正确区分主会话与子代理会话，修复工具调用 token 遗漏问题 进度显示：支持自定义进度文本，在 loading 状态中实时展示当前处理进度 自定义模型配置：修复自定义模型错误继承全局关联模型配置的问题，确保行为符合预期 记忆系统：优化记忆上下文提示词，精简表述并新增隐式记忆源支持，提升跨会话记忆召回能力 多语言支持增强：所有子 Agent 现在会正确遵循用户的语言设置进行回复 UI 刷新优化：优化工具执行完成后的终端刷新策略，增加防抖机制减少不必要的渲染 内存优化：子 Agent 任务完成后自动释放会话历史和引用，减少内存占用 Grep 搜索：自动修正搜索模式参数，避免不必要的调用失败；兼容 ripgrep 正则语法 文件读取：读取目录时返回目录列表，帮助快速定位目标文件 🐛 问题修复 工具错误处理：改进工具未找到时的错误提示和处理逻辑 Headless 模式：修复使用非默认 agent 时流式输出阻塞的问题，确保 completion 信号正确发送 工具结果显示：修复 Edit 等工具执行完成后输出不显示，需要手动调整终端大小才能看到的问题 会话恢复列表：移除会话恢复面板中不必要的 agent 类型过滤，允许恢复所有有效会话"},{"id":"/cli/release-notes/v2.48.1","title":"🚀 CodeBuddy Code v2.48.1 发布","body":"🚀 CodeBuddy Code v2.48.1 发布 🔧 改进优化 环境变量认证冲突检测：当设置了 或 环境变量时，/login 命令会自动检测并提示冲突解决方案；认证失败时显示更详细的诊断信息，帮助快速定位问题 子代理消息标识：修复子代理 user 消息在流式输出时缺少父工具标识的问题，客户端现可正确区分主代理和子代理的消息 MCP prompt 命令格式统一：统一 MCP prompt 与斜杠命令的上下文拼接格式，确保模型能正确理解命令来源和参数 📝 文档更新 Prompt Hooks 文档：完善基于提示词的 Hooks 功能文档，新增支持事件说明、配置示例和最佳实践指南"},{"id":"/cli/release-notes/v2.48.0","title":"🚀 CodeBuddy Code v2.48.0 发布","body":"🚀 CodeBuddy Code v2.48.0 发布 ✨ 新功能 图生图工具（ImageEdit） 新增 工具，支持基于已有图片进行 AI 编辑和修改： 支持风格转换、添加元素、修改颜色等图片编辑操作 使用 命令切换图生图模型 通过 环境变量或 设置项配置默认模型 Prompt Hook 新增基于 LLM 的 Hook 类型，支持使用自然语言定义触发条件，实现更灵活的工作流控制。 🔧 改进优化 图片 API 重构：提取共享的 模块，统一文生图和图生图的 API 调用逻辑 模型标签系统：引入 和 模型标签，支持同一模型同时具备多种图像生成能力 Hook 配置面板：支持显示和管理 Prompt Hook，优化阻断信息的展示方式 Token 计算准确性： 命令现在只统计实际启用的工具，排除被禁用的内置工具和 MCP 工具 Plan 模式权限继承：Plan 模式下保留进入前的权限设置，支持 \"plan + bypass\" 等组合模式，子代理同样继承此权限配置 热更新系统优化：在低 FD 限制的容器环境中自动检测并优化热更新行为，支持 完全禁用热更新 Windows 路径提示：在 Windows 平台添加使用正斜杠的提示，避免反斜杠导致路径解析错误 WorkBuddy 配置分离：WorkBuddy 现在使用独立的 配置目录，与 CLI 的 分离 🐛 问题修复 ACP 取消处理：优化取消请求的事件传递机制，确保会话能正确响应取消操作 MCP 非交互模式：修复 ACP 模式下 MCP 工具未正确识别为非交互模式的问题 记忆上下文注入：修复记忆提示注入时缺少系统标签的问题 目录扫描：修复软链接目录下文件相对路径计算不正确的问题"},{"id":"/cli/release-notes/v2.47.0","title":"🚀 CodeBuddy Code v2.47.0 发布","body":"🚀 CodeBuddy Code v2.47.0 发布 ✨ 新功能 跨会话记忆功能 新增实验性记忆功能，支持 Agent 在会话间保持持久化记忆。您可以通过 设置面板或 配置项启用此功能。同时支持团队记忆模式，将记忆存储在项目目录下便于团队共享。 🔧 改进优化 command:// URI 处理：优化 ACP 协议中 command:// 资源链接的处理，正确转换为斜杠命令格式并回显原始内容块 命令推送过滤：修复内置命令被错误推送到 IDE 的问题，现在只推送用户自定义命令、skills 和特定内置命令 文件路径搜索：优化重复字符查询的匹配精度，避免误匹配分散的字符 SSH 远程剪贴板：修复在 Linux + SSH 远程环境下 Ctrl+Y 复制到剪贴板失败的问题，通过实现 OSC 52 协议支持远程终端剪贴板操作 会话恢复历史控制：优化 SDK 恢复会话时的历史回放逻辑，通过 信号让 CLI 智能判断是否需要回放历史消息，提升 resume 场景的使用体验 🐛 问题修复 管道输入：修复使用管道传递输入时内容无法被读取的问题（如 ） Stop Hooks 执行时机：修复当工具需要用户确认时 Stop Hooks 被错误执行的问题，现在只有在没有待审批工具时才会触发"},{"id":"/cli/release-notes/v2.46.0","title":"🚀 CodeBuddy Code v2.46.0 发布","body":"🚀 CodeBuddy Code v2.46.0 发布 ✨ 新功能 语言设置 在 中新增 Language 选项，您可以设置首选的响应语言，CodeBuddy Code 将使用您指定的语言进行回复，让交流更加自然流畅。 🔧 改进优化 复制快捷键：新增 Ctrl+Y 快捷键，可快速复制最后一条 AI 回复到剪贴板，方便您快速获取代码片段或重要信息 Shell 命令执行优化：优化命令执行机制，仅在需要加载额外环境配置时才使用 eval 包装，保持默认情况下的原有行为，提升命令执行的稳定性"},{"id":"/cli/release-notes/v2.45.1","title":"🚀 CodeBuddy Code v2.45.1 发布","body":"🚀 CodeBuddy Code v2.45.1 发布 🔧 改进优化 登录界面优化：调整登录方式顺序，将 iOA 登录放置到最后并标注仅限腾讯内部员工使用，让新用户更容易找到适合自己的登录方式 文档完善：在快速入门文档中添加四种登录方式的详细说明，帮助用户了解各登录方式的适用场景 SDK 版本更新：同步更新 SDK JS 至 0.3.40，SDK Python 至 0.3.38"},{"id":"/cli/release-notes/v2.45.0","title":"🚀 CodeBuddy Code v2.45.0 发布","body":"🚀 CodeBuddy Code v2.45.0 发布 ✨ 新功能 工具搜索与延迟加载 新增 ToolSearch 工具，支持通过自然语言搜索可用工具。MCP 服务器现在支持 配置，将工具延迟到需要时才加载，有效减少上下文消耗并提高工具选择准确性。 环境变量模型配置 支持通过环境变量灵活配置模型，方便在 CI/CD 环境和脚本中使用： ：覆盖默认代理模型 ：配置 lite 变体模型 ：配置 reasoning 变体模型 ：配置子代理模型 ：启用扩展思考并设置 token 预算 SDK Commands 订阅 SDK 新增 和 方法，支持获取和实时订阅 CLI 可用命令列表变更。 🔧 改进优化 Skill Fork 上下文：支持 配置，使 Skill 在独立的子代理上下文中执行 Agent 类型指定：新增 字段，可指定执行 Skill 的子代理类型 图片粘贴优化：增加剪贴板读取重试机制，扩展 macOS 图片格式检测，支持更多截图工具 错误恢复增强：当模型返回无效工具名时，系统会提示模型检查并重试 界面简化：将 \"Plan Mode\" 简化为 \"Plan\"，使界面更简洁 🐛 问题修复 ACP 多轮对话：修复第二轮 prompt 直接返回结果、缺少 sessionUpdate 事件的问题 插件加载去重：修复插件 skills、agents、commands 在菜单中重复显示的问题"},{"id":"/cli/release-notes/v2.44.1","title":"🚀 CodeBuddy Code v2.44.1 发布","body":"🚀 CodeBuddy Code v2.44.1 发布 🔧 改进优化 Skill/Command 调用控制：新增 配置项，支持将 skill 或 command 设置为仅手动触发模式，避免被模型自动调用，让您对 AI 的行为有更精细的控制 子代理中断处理：优化 Task 子代理被用户中断时的行为，现在会返回清晰的中断提示和可恢复的 Agent ID，支持通过 参数继续任务，中断不再意味着丢失进度 Plan 子代理能力增强：Plan 子代理现在可以使用 Write、Edit、MultiEdit 工具编辑 plan 文件，让计划模式更加灵活实用 媒体内容错误自动恢复：当图片过大、格式无效或数量过多导致请求失败时，系统会自动移除问题内容并提供压缩建议，让对话能够继续进行 WebFetch 工具增强：增强对 SPA 页面的支持，当页面主体内容为空时自动提取 meta 标签信息，更好地理解现代 Web 应用 自定义 Headers 合并优化：修复 HTTP headers 合并时的大小写敏感问题，现在会正确覆盖同名但大小写不同的 header allowed tools 格式支持：自定义 Skill 和 Command 的 字段现在同时支持逗号分隔字符串和 YAML 数组两种格式，配置更灵活 输入框优化：修复消息发送时序问题，确保消息完全发送后再清空输入 🐛 问题修复 自定义请求头解析：修复换行符判断逻辑，确保多行 header 配置能够被正确解析 文档链接：修正沙箱文档链接指向正确的文件 📝 文档更新 SDK 示例文档：新增 SDK 演示页面，提供 TypeScript SDK 的使用示例和最佳实践 技能与命令文档：更新技能和斜杠命令的相关文档说明"},{"id":"/cli/release-notes/v2.44.0","title":"CodeBuddy Code v2.44.0 发布","body":"CodeBuddy Code v2.44.0 发布 ✨ 新功能 会话标题同步 支持将会话主题（Topic）通过 ACP 协议同步给 IDE，便于在标签页或侧边栏显示有意义的会话名称。当 AI 助手识别出会话主题后，IDE 可以自动更新对应的标签页标题，让用户更容易识别和管理多个并行会话。 🔧 改进优化 SDK 版本更新：同步更新 SDK JS 至 0.3.37，SDK Python 至 0.3.35"},{"id":"/cli/release-notes/v2.43.1","title":"🚀 CodeBuddy Code v2.43.1 发布","body":"🚀 CodeBuddy Code v2.43.1 发布 ✨ 新功能 任务管理工具重构 将原有的单一任务管理工具拆分为 5 个独立工具，提供更精细的任务控制能力： TaskCreate：创建新任务 TaskGet：获取任务详情 TaskUpdate：更新任务状态 TaskList：列出所有任务 TaskStop：停止任务执行 Skill 工具增强 Skill 工具现在支持直接执行斜杠命令，新增 参数用于传递命令参数，让技能调用更加灵活。 🔧 改进优化 计划模式增强：新增 命令用于预览当前计划文件内容，优化计划模式下的权限控制 Shell 环境快照：执行命令时自动捕获用户 shell 配置（函数、别名、选项），确保命令在用户熟悉的环境中运行 Shell 环境文件支持：新增 环境变量，支持在命令执行前自动加载指定的环境文件 提示词优化：优化 Agent 提示词模板，提升回复简洁性 文件搜索优化：精简硬编码忽略规则，优先依赖项目 .gitignore 配置 Grep 工具：新增 参数别名，提升使用便捷性 子代理配置：新增 参数，支持控制代理执行轮次"},{"id":"/cli/release-notes/v2.43.0","title":"🚀 CodeBuddy Code v2.43.0 发布","body":"🚀 CodeBuddy Code v2.43.0 发布 ✨ 新功能 任务管理工具重构 将原有的单一任务管理工具拆分为 5 个独立工具，提供更精细的任务控制能力： TaskCreate：创建新任务 TaskGet：获取任务详情 TaskUpdate：更新任务状态 TaskList：列出所有任务 TaskStop：停止任务执行 Skill 工具增强 Skill 工具现在支持直接执行斜杠命令，新增 参数用于传递命令参数，让技能调用更加灵活。 🔧 改进优化 计划模式增强：新增 命令用于预览当前计划文件内容，优化计划模式下的权限控制 Shell 环境快照：执行命令时自动捕获用户 shell 配置（函数、别名、选项），确保命令在用户熟悉的环境中运行 Shell 环境文件支持：新增 环境变量，支持在命令执行前自动加载指定的环境文件 提示词优化：优化 Agent 提示词模板，提升回复简洁性 文件搜索优化：精简硬编码忽略规则，优先依赖项目 .gitignore 配置 Grep 工具：新增 参数别名，提升使用便捷性 子代理配置：新增 参数，支持控制代理执行轮次"},{"id":"/cli/release-notes/v2.42.3","title":"🚀 CodeBuddy Code v2.42.3 发布","body":"🚀 CodeBuddy Code v2.42.3 发布 🔧 改进优化 会话摘要与主题持久化 AI 摘要生成：自动为会话生成 AI 摘要，在 列表中展示更友好的描述，帮助您快速识别和恢复历史会话 主题持久化：终端标题现在会保存到会话历史，方便后续查看和管理 非交互模式支持：新增 参数，支持在非交互模式下启用会话追踪功能 会话追踪配置细粒度控制 将会话追踪功能拆分为两个独立的环境变量，支持更灵活的配置： ：控制是否生成会话摘要 ：控制是否保存会话主题 这允许您根据实际需求单独启用或禁用特定功能。"},{"id":"/cli/release-notes/v2.42.1","title":"🚀 CodeBuddy Code v2.42.1 发布","body":"🚀 CodeBuddy Code v2.42.1 发布 🔧 改进优化 启动性能监控：新增启动时间分析器，可在 面板查看各阶段耗时，帮助诊断启动缓慢问题 WSL 环境支持：自动检测 WSL 环境并提示模型使用正确的 Linux 路径格式，提升 WSL 用户体验 路径兼容性：修复模型在非 Windows 平台发送 Windows 风格路径时的解析问题，避免路径错误 SDK 版本更新：同步更新 SDK JS 至 0.3.32，SDK Python 至 0.3.30"},{"id":"/cli/release-notes/v2.42.0","title":"🚀 CodeBuddy Code v2.42.0 发布","body":"🚀 CodeBuddy Code v2.42.0 发布 ✨ 新功能 MCP 配置支持 JSONC 格式 MCP 配置文件现在支持 JSONC (JSON with Comments) 格式，让配置文件更易于维护： 支持单行注释 ( ) 支持多行注释 ( ) 支持尾随逗号 🔧 改进优化 Python 3.10 支持：Agent SDK 扩展了兼容的 Python 版本范围，现已支持 Python 3.10 ACP 会话控制：修复了通过 SDK 设置模型和权限模式的功能 工具调用稳定性：当模型返回不完整的工具调用参数时，自动检测并请求模型重新生成，提升对话稳定性 会话 Fork 增强：支持更多参数组合方式，可通过 或 指定源会话 命令消息格式：统一斜杠命令和技能的消息标签格式，新增 标签支持参数提取 数据追踪准确性：修复 prompt suggestion 与主对话数据混淆的问题 🐛 问题修复 Hook 输出显示：修复 hook 执行后显示多余 JSON 原始数据的问题 软链接支持：修复 rules 目录下软链接文件无法正确加载的问题，并增加循环引用防护"},{"id":"/cli/release-notes/v2.41.8","title":"🚀 CodeBuddy Code v2.41.8 发布","body":"🚀 CodeBuddy Code v2.41.8 发布 🔧 改进优化 Print 模式输出优化：在 print 模式下静默通知类消息，避免污染 agent 输出流，让脚本集成更加干净 配置结构简化：移除冗余的 deploymentType 配置字段，简化产品配置结构 🐛 问题修复 自定义请求头解析：修复换行符判断逻辑，确保多行 header 配置能够被正确解析 SDK 系统提示词传递：修复 v2 Session API 中 参数未正确传递的问题 SDK 会话加载竞态条件：修复多窗口场景下并发调用 和 时的竞态条件问题，防止会话数据不一致 📝 文档更新 环境变量文档：新增 功能开关说明，用于控制图片生成功能 发版说明：新增 v2.40.0 至 v2.41.7 版本的中英文发版说明 SDK 文档：完善 hooks、permissions、TypeScript SDK 等文档内容"},{"id":"/cli/release-notes/v2.41.7","title":"🚀 CodeBuddy Code v2.41.7 发布","body":"🚀 CodeBuddy Code v2.41.7 发布 🔧 改进优化 Checkpoint 性能优化：将 checkpoint 文件读取改为异步并行处理，避免阻塞事件循环，提升响应性能 会话恢复优化：改进 session/load 流程，确保历史消息和 artifact 恢复在响应发送后执行，修复多连接场景下的重复发送问题 SDK 工具参数传递：修复 allowedTools/disallowedTools 参数格式，确保正确传递多个工具名称 Python SDK 流缓冲区：增加 100MB 缓冲区限制，防止 MCP 服务返回大 JSON 响应时出错 SDK 版本追踪：SDK 在与 CLI 通信时会自动注入 User Agent 请求头，包含 SDK 版本和运行时信息，便于后端服务追踪和诊断 SDK 版本更新：同步更新 SDK JS 至 0.3.29，SDK Python 至 0.3.27 📝 文档更新 SDK Custom Tools 文档：修复 Python SDK 示例中 tool 装饰器的错误用法，改为从包直接导入并使用正确的装饰器语法"},{"id":"/cli/release-notes/v2.41.6","title":"🚀 CodeBuddy Code v2.41.6 发布","body":"🚀 CodeBuddy Code v2.41.6 发布 🔧 改进优化 输入提交优化：修复在输入斜杠命令时无法按回车提交的问题，现在可以正常提交命令或将无效命令作为普通消息发送 热更新优化：修复 plugins 目录热更新时可能触发 等系统目录变更事件的问题，提升稳定性 上下文压缩：优化历史记录处理逻辑，过滤分支历史确保压缩准确性 工具描述模板：优化工具描述中的引号格式，提升可读性 SDK 版本更新：同步更新 SDK JS 至 0.3.28，SDK Python 至 0.3.26"},{"id":"/cli/release-notes/v2.41.5","title":"🚀 CodeBuddy Code v2.41.5 发布","body":"🚀 CodeBuddy Code v2.41.5 发布 🐛 问题修复 热更新稳定性提升：修复 plugins 目录热更新时可能触发 等系统目录变更事件的问题，确保热更新功能更加稳定可靠 🔧 改进优化 会话锁机制优化：将 session lock 的获取延迟到实际使用时，减少锁泄漏风险，同时支持 fork 操作无需获取锁，提升会话管理的灵活性 SDK 同步更新：SDK JS 更新至 0.3.27，SDK Python 更新至 0.3.25"},{"id":"/cli/release-notes/v2.41.4","title":"🚀 CodeBuddy Code v2.41.4 发布","body":"🚀 CodeBuddy Code v2.41.4 发布 🔧 改进优化 SDK 版本同步：更新 SDK JS 至 0.3.26，SDK Python 至 0.3.24，保持 SDK 与 CLI 版本同步"},{"id":"/cli/release-notes/v2.41.3","title":"🚀 CodeBuddy Code v2.41.3 发布","body":"🚀 CodeBuddy Code v2.41.3 发布 🔧 改进优化 新增 Kimi K2.5 模型：支持 Kimi K2.5 模型，具备工具调用、图像理解和推理能力，为用户提供更多模型选择 参数校验优化：改进工具参数校验错误提示，提供更清晰的错误信息，帮助快速定位问题 类型自动转换：支持字符串形式的数字参数自动转换，提升与不同模型的兼容性 热更新通知优化：用户级 settings.json 热更新时不再显示通知，减少不必要的干扰"},{"id":"/cli/release-notes/v2.41.2","title":"🚀 CodeBuddy Code v2.41.2 发布","body":"🚀 CodeBuddy Code v2.41.2 发布 🔧 改进优化 SDK 版本更新：同步更新 SDK JS 至 0.3.24，SDK Python 至 0.3.22"},{"id":"/cli/release-notes/v2.41.1","title":"🚀 CodeBuddy Code v2.41.1 发布","body":"🚀 CodeBuddy Code v2.41.1 发布 🔧 改进优化 会话管理优化：SDK 重构 sessionId 参数，改为自动生成，简化 API 调用流程，开发者无需手动管理 sessionId SDK 版本更新：同步更新 SDK JS 至 0.3.23，SDK Python 至 0.3.21"},{"id":"/cli/release-notes/v2.41.0","title":"🚀 CodeBuddy Code v2.41.0 发布","body":"🚀 CodeBuddy Code v2.41.0 发布 ✨ 新功能 配置热更新 现在修改 Skills、记忆文件（CODEBUDDY.md）、配置文件等后，无需重启 CLI 即可自动生效。告别频繁的重启操作，让工作流更加顺畅。 🔧 改进优化 工具白名单：新增 选项，支持限制 CodeBuddy 可使用的内置工具集。可设置为空字符串禁用所有内置工具，或指定逗号分隔的工具列表，让工具使用更可控 📝 文档更新 环境配置说明：为 SDK、ACP 和 IAM 文档添加 环境变量配置指引，帮助不同版本用户正确配置认证环境"},{"id":"/cli/release-notes/v2.40.1","title":"🚀 CodeBuddy Code v2.40.1 发布","body":"🚀 CodeBuddy Code v2.40.1 发布 🐛 问题修复 图片生成工具：修复 Windows 系统下输出目录路径解析错误的问题，现在可以正确生成图片到指定目录 输入建议：修复从建议菜单选择后消息重复发送的问题，提升交互体验"},{"id":"/cli/release-notes/v2.40.0","title":"🚀 CodeBuddy Code v2.40.0 发布","body":"🚀 CodeBuddy Code v2.40.0 发布 ✨ 新功能 SDK 延迟控制请求同步 SDK 新增延迟控制请求同步功能，让您可以在发送消息前灵活设置权限模式和模型选项。这一改进为 SDK 用户提供了更灵活的 API 调用方式，方便在消息发送前进行配置调整。 使用示例： 🔧 改进优化 SDK 版本同步：SDK JS 更新至 0.3.20，SDK Python 更新至 0.3.18，同步支持新的延迟控制请求功能"},{"id":"/cli/release-notes/v2.39.0","title":"🚀 CodeBuddy Code v2.39.0 发布","body":"🚀 CodeBuddy Code v2.39.0 发布 ✨ 新功能 图片生成工具 新增 工具，让 AI 助手可以直接根据文本描述生成图片。支持自定义尺寸、风格、质量等多种参数，为创意工作流提供更多可能性。 文生图模型切换：通过 命令查看和切换可用的文生图模型 CLI 参数支持：启动时使用 参数指定默认模型 配置持久化：在用户配置中设置 作为默认文生图模型 🔧 改进优化 配置面板优化：将 Env Route 选项移至开发者模式，通过 或 激活，简化常规配置界面 输入提交修复：修复在输入斜杠命令时无法按回车提交的问题，现在可以正常提交命令或将无效命令作为普通消息发送 工具描述优化：改进工具描述中的引号格式，提升可读性 SDK 版本更新：同步更新 SDK JS 至 0.3.19，SDK Python 至 0.3.17"},{"id":"/cli/release-notes/v2.38.2","title":"🚀 CodeBuddy Code v2.38.2 发布","body":"🚀 CodeBuddy Code v2.38.2 发布 🔧 改进优化 路径解析优化：使用 PathUtils 统一 WASM 文件和证书文件的路径解析逻辑，支持从 EMBEDFS 加载嵌入资源，提升不同部署环境下的兼容性 🐛 问题修复 控制台输出：修复特定场景下控制台输出模式解析异常的问题"},{"id":"/cli/release-notes/v2.38.1","title":"🚀 CodeBuddy Code v2.38.1 发布","body":"🚀 CodeBuddy Code v2.38.1 发布 🔧 改进优化 命令安全检查简化：移除未使用的命令黑名单功能，精简代码结构，提升代码可维护性 SDK 版本同步：同步更新 SDK JS 至 0.3.17，SDK Python 至 0.3.15"},{"id":"/cli/release-notes/v2.38.0","title":"🚀 CodeBuddy Code v2.38.0 发布","body":"🚀 CodeBuddy Code v2.38.0 发布 ✨ 新功能 子 Agent 模型变体 Agent 工具新增 参数，支持指定 、 等模型变体。您可以根据任务复杂度选择合适的模型： ：适用于简单搜索、快速文件操作等轻量任务 ：适用于复杂分析、架构决策和多步骤问题求解 🔧 改进优化 Checkpoint Hook 统计优化：优化文件变更统计计算，通过对比备份文件与当前文件提供准确的增删行数 Shell 编码处理：优化终端输出的字符编码解码逻辑，改善 Windows 环境下中文等非 ASCII 字符的显示效果 SDK 版本更新：同步更新 SDK JS 至 0.3.16，SDK Python 至 0.3.14 📝 文档更新 环境要求：明确 Node.js 最低版本为 18.20+ 开发文档：完善 CODEBUDDY.md，补充开发命令、目录结构说明和构建流程细节 文档同步：同步 CLI 文档到 IDE docs 目录，新增费用说明文档等"},{"id":"/cli/release-notes/v2.37.20","title":"🚀 CodeBuddy Code v2.37.20 发布","body":"🚀 CodeBuddy Code v2.37.20 发布 🔧 改进优化 模型临时切换：在模型选择面板按 键可仅对当前会话生效，不修改用户配置，方便临时测试不同模型 model 参数优化：命令行 参数现在正确覆盖项目级配置，当前会话立即生效 上下文压缩优化：压缩时过滤规则和记忆内容，避免将配置指令压缩进摘要，压缩后自动重新注入完整规则，保持 AI 行为一致性 配置面板精简：隐藏开发者选项，需通过 访问，让配置界面更简洁"},{"id":"/cli/release-notes/v2.37.19","title":"🚀 CodeBuddy Code v2.37.19 发布","body":"🚀 CodeBuddy Code v2.37.19 发布 🔧 改进优化 SDK 版本同步：更新 JavaScript/TypeScript SDK 至 0.3.14，Python SDK 至 0.3.12，保持 SDK 与 CLI 版本同步，确保最佳兼容性"},{"id":"/cli/release-notes/v2.37.18","title":"🚀 CodeBuddy Code v2.37.18 发布","body":"🚀 CodeBuddy Code v2.37.18 发布 🐛 问题修复 登录流程优化：修复登录方式映射配置问题,提升登录界面的交互体验和可用性 🔧 改进优化 SDK 版本更新：同步更新 SDK JS 至 0.3.13,SDK Python 至 0.3.11,保持与最新 SDK 的兼容性"},{"id":"/cli/release-notes/v2.37.17","title":"🚀 CodeBuddy Code v2.37.17 发布","body":"🚀 CodeBuddy Code v2.37.17 发布 🔧 改进优化 SDK 版本同步更新：SDK JS 更新至 0.3.12，SDK Python 更新至 0.3.10，确保与 CLI 版本保持同步"},{"id":"/cli/release-notes/v2.37.16","title":"🚀 CodeBuddy Code v2.37.16 发布","body":"🚀 CodeBuddy Code v2.37.16 发布 🔧 改进优化 配置更新：将机器人配置文件纳入构建流程，确保配置同步更新 🐛 问题修复 企业版登录兼容性：修复用户切换企业版 URL 登录时模型列表不一致的问题，确保 endpoint 变更后配置正确加载"},{"id":"/cli/release-notes/v2.37.15","title":"🚀 CodeBuddy Code v2.37.15 发布","body":"🚀 CodeBuddy Code v2.37.15 发布 🐛 问题修复 退出登录流程优化 修复了退出登录后 token 未正确清理的问题,确保认证拦截器正确处理登出状态,避免后续请求使用过期凭证。 HTTP 拦截器增强 改进认证 HTTP 拦截器的错误处理和状态同步机制,提升认证流程的稳定性和可靠性。"},{"id":"/cli/release-notes/v2.37.14","title":"🚀 CodeBuddy Code v2.37.14 发布","body":"🚀 CodeBuddy Code v2.37.14 发布 ✨ 新功能 SDK 动态配置 API 新增 和 方法，让开发者可以动态获取当前可用的权限模式和模型列表。同时， 和 现在仅影响当前会话，不再持久化到配置文件，让多会话场景下的配置管理更加灵活。 模型切换快捷键 支持 Option/Alt + P 快速切换模型，无需进入设置即可快速切换到合适的模型。 🔧 改进优化 用户提示增强：添加更多内置提示，帮助用户了解快捷键和操作技巧 输出限制统一：将各类工具的 token 限制统一为 20000，图片内容不受此限制；Read 工具支持 环境变量自定义 启动性能优化：优化认证和服务配置初始化流程，提升 CLI 冷启动速度 插件市场安装：优化市场和插件安装流程，显著减少首次安装和自动更新的等待时间 异步文件操作：将自定义命令、Agent 和 Skill 的加载改为异步并行处理 Git 信息收集：优化仓库扫描逻辑，采用异步并行处理提升性能 🐛 问题修复 Diff 渲染稳定性：修复了工具调用参数解析时因空字符串或不完整 JSON 导致的渲染崩溃问题"},{"id":"/cli/release-notes/v2.37.13","title":"🚀 CodeBuddy Code v2.37.13 发布","body":"🚀 CodeBuddy Code v2.37.13 发布 🔧 改进优化 企业版认证优化 优化企业 ID 获取时序，确保企业模型列表在用户登录后能够正确加载，改善企业用户的使用体验。 自定义认证修复 修复在自定义认证环境下，认证状态变化时导致 token 丢失的问题，确保认证流程的稳定性和可靠性。"},{"id":"/cli/release-notes/v2.37.12","title":"🚀 CodeBuddy Code v2.37.12 发布","body":"🚀 CodeBuddy Code v2.37.12 发布 🎨 界面优化 应用图标更新：更新 Work 应用图标，提升视觉一致性 🔧 改进优化 活动栏增强：新增活动栏组件，支持更丰富的导航和交互功能 设置服务优化：重构设置服务，提供更灵活的配置管理能力 历史记录缓存：新增历史缓存服务，改善会话历史的加载和管理体验 进程池管理：引入 ACP 进程池，提升多会话场景下的资源利用效率 Mermaid 图表：增强 Mermaid 图表渲染，支持更多图表类型和交互 国际化完善：补充中英文界面文案"},{"id":"/cli/release-notes/v2.37.11","title":"🚀 CodeBuddy Code v2.37.11 发布","body":"🚀 CodeBuddy Code v2.37.11 发布 📦 维护性更新 本次为维护性版本发布，主要包含： SDK 版本同步更新 内部依赖优化"},{"id":"/cli/release-notes/v2.37.10","title":"🚀 CodeBuddy Code v2.37.10 发布","body":"🚀 CodeBuddy Code v2.37.10 发布 🔧 改进优化 登录方式优化：简化登录选项为\"Chinese Site\"、\"International Site\"和\"Enterprise Domain\"，国内站点登录会自动根据网络环境选择最佳认证方式，提升登录体验"},{"id":"/cli/release-notes/v2.37.9","title":"🚀 CodeBuddy Code v2.37.9 发布","body":"🚀 CodeBuddy Code v2.37.9 发布 🔧 改进优化 侧边栏交互优化：支持拖拽调整宽度，新增会话管理操作按钮，让界面操作更加灵活便捷 User Agent 标识：ACP 进程启动时自动设置包含版本信息的 User Agent 请求头，便于服务端识别客户端版本 配置同步优化：为产品配置同步添加节流+防抖机制，减少高频调用造成的性能开销 日志增强：增加流式消息处理和配置缓存过期的调试日志，便于问题排查"},{"id":"/cli/release-notes/v2.37.8","title":"🚀 CodeBuddy Code v2.37.8 发布","body":"🚀 CodeBuddy Code v2.37.8 发布 🔧 改进优化 会话状态管理优化：优化 lastMessageId 在异步压缩时的更新机制，确保长对话场景下消息 ID 关联正确，提升会话恢复的可靠性"},{"id":"/cli/release-notes/v2.37.7","title":"🚀 CodeBuddy Code v2.37.7 发布","body":"🚀 CodeBuddy Code v2.37.7 发布 ✨ 新功能 红包封面推广：帮助面板新增「码到成功」红包封面领取入口，根据国内/国际版自动显示对应链接，助您在新年期间领取专属红包封面"},{"id":"/cli/release-notes/v2.37.6","title":"🚀 CodeBuddy Code v2.37.6 发布","body":"🚀 CodeBuddy Code v2.37.6 发布 🔧 改进优化 会话恢复增强：支持显示通过 命令生成的会话，用户不再丢失压缩后的会话历史"},{"id":"/cli/release-notes/v2.37.5","title":"🚀 CodeBuddy Code v2.37.5 发布","body":"🚀 CodeBuddy Code v2.37.5 发布 🐛 问题修复 ACP 会话模型设置：修复通过 SDK 切换模型后，后续对话仍使用旧模型的问题，现在模型切换会立即生效"},{"id":"/cli/release-notes/v2.37.4","title":"🚀 CodeBuddy Code v2.37.4 发布","body":"🚀 CodeBuddy Code v2.37.4 发布 ✨ 新功能 自定义 Session ID SDK 现在支持在创建会话时指定自定义 session ID，便于外部系统追踪和管理会话。这对于需要将 CodeBuddy 会话与业务系统集成的场景非常有用。 🐛 问题修复 会话历史加载：修复会话重连后历史消息无法正确显示的问题，改用 ACP session/load 机制加载历史 模型选择同步：修复模型 ID 映射问题，正确处理 SDK 返回的 modelId 字段 模型持久化：优化模型选择的持久化逻辑，确保用户选择在会话重连后保持一致 会话订阅栈溢出：防止 session 被重复订阅时导致的递归栈溢出问题 Stop Hook 序列化：移除未使用的 result 字段，避免序列化循环引用导致的错误 🔧 改进优化 工具步骤展示：优化工具调用列表的布局和动画效果，提升视觉体验"},{"id":"/cli/release-notes/v2.37.3","title":"🚀 CodeBuddy Code v2.37.3 发布","body":"🚀 CodeBuddy Code v2.37.3 发布 🔧 改进优化 Electron 桌面应用体验优化 单实例锁：防止应用多开，第二个实例会自动聚焦现有窗口 macOS 窗口行为：关闭窗口时隐藏而非退出，符合 macOS 应用规范 Dock 图标清理：修复子进程在 macOS Dock 中显示多余图标的问题 SDK API 增强 权限模式动态切换：Session API 新增 和 方法，支持在会话中动态切换权限模式 Plan 模式优化：切换到 plan 模式时返回 plan 文件路径，便于 SDK 获取和展示 历史消息处理：优化 Query API 中 resume + prompt 场景下的历史消息处理流程 消息列表交互优化 时间线排序：优化消息与工具调用的时间线排序，支持工具调用分组显示 反馈功能：新增消息点赞和点踩按钮，支持用户反馈 图片预览：用户消息图片支持点击放大预览，带有平滑动画效果 复制功能：改进助手消息复制逻辑，支持复制完整回复组；用户消息支持双击复制"},{"id":"/cli/release-notes/v2.37.2","title":"🚀 CodeBuddy Code v2.37.2 发布","body":"🚀 CodeBuddy Code v2.37.2 发布 🔧 改进优化 ACP 认证增强 在 authenticate 响应中返回用户信息，客户端可获取当前登录用户的 ID、用户名和昵称 修复已登录用户再次调用认证接口时无法弹出登录页面的问题 异步上下文压缩 引入异步上下文压缩机制，当对话历史达到临界阈值时自动触发后台压缩，提升长对话场景下的响应性能。 SDK 连接性能优化 优化连接池机制，支持并发查询场景下的预热连接复用，显著降低首次消息延迟 增加 选项，将 CLI 启动时间提前到预热阶段 增加会话锁机制，避免同一会话 ID 被并发恢复导致的数据混乱 其他改进 ACP 会话模型隔离：修复切换模型时影响全局配置的问题，现在模型切换仅影响当前会话 插件卸载清理：修复卸载插件后 MCP 配置仍然残留的问题，卸载时会自动清理相关配置 网络错误处理：优化 print 模式下网络错误自动重试逻辑，避免异常退出 SDK 性能优化：优化了会话恢复和用户交互流程，提升了 SDK 响应速度和稳定性 会话存储：支持跨项目目录搜索会话，新增 meta 文件分离存储 认证流程：优化认证机制，新增用户信息查询接口 服务模式：增强服务器模式策略功能"},{"id":"/cli/release-notes/v2.37.1","title":"🚀 CodeBuddy Code v2.37.1 发布","body":"🚀 CodeBuddy Code v2.37.1 发布 🔧 改进优化 认证 API 增强 新增 API，支持清除缓存的认证 token，让您可以方便地切换用户或环境。同时， 现在会自动检测已有有效认证，避免重复登录，提升使用体验。 Checkpoint Hook 新增实验性 Hook，支持在文件修改后自动触发。该 Hook 提供文件快照和变更统计信息，便于追踪文件变更历史和实现自动化审计，为代码质量管理提供更强大的支持。 Session API Hooks 支持 V2 Session API 现在支持配置 Hooks，可在会话中拦截和控制工具执行。这让您能够更灵活地定制会话行为，实现更精细的执行控制。"},{"id":"/cli/release-notes/v2.37.0","title":"🚀 CodeBuddy Code v2.37.0 发布","body":"🚀 CodeBuddy Code v2.37.0 发布 ✨ 新功能 SDK 认证 API 新增实验性认证接口，支持 SDK 独立完成登录流程： 支持多种认证环境（external、internal、iOA、cloudhosted、selfhosted） 自动检测已登录状态，避免重复登录 通过回调通知登录 URL，支持自定义浏览器打开逻辑 🔧 改进优化 React 状态管理：重构消息状态更新逻辑，使用不可变操作替代直接修改，符合 React 最佳实践，提升组件渲染稳定性"},{"id":"/cli/release-notes/v2.36.3","title":"🚀 CodeBuddy Code v2.36.3 发布","body":"🚀 CodeBuddy Code v2.36.3 发布 🔧 改进优化 跨平台兼容性提升：优化 Shell 执行在 Windows 系统下的路径处理，修复包含空格路径导致的执行问题 权限匹配增强：改进复杂 Shell 命令的权限规则匹配，支持 、 、 、 等操作符组合的命令解析，使权限规则能够准确匹配组合命令中的各个子命令 输入菜单响应优化：修复菜单状态检测延迟导致的快捷键冲突问题，提升命令和文件建议菜单的响应速度 历史记录过滤：优化会话历史加载时的消息展示 🐛 问题修复 循环依赖修复：修复模块间循环引用问题，通过延迟获取依赖改善服务隔离 📝 文档更新 SDK 文档修正：修正自定义工具导入路径， 和 应直接从 导入 SDK 版本要求更新：将文档中的 CodeBuddy Agent SDK 版本要求从 v0.2.0 更新为 v0.1.24"},{"id":"/cli/release-notes/v2.33.1","title":"🚀 CodeBuddy Code v2.33.1 发布","body":"🚀 CodeBuddy Code v2.33.1 发布 🔧 改进优化 会话上下文类型优化：重构会话、检查点和上下文管理的类型定义，增强输入项处理和历史记录工具的类型安全性 命令权限检查：优化白名单命令链的权限判断，当所有子命令都在安全白名单中时直接放行，无需额外确认 Memory 加载器：修复暂时禁用的子目录 Memory 加载方法导致的编译警告"},{"id":"/cli/release-notes/v2.33.0","title":"🚀 CodeBuddy Code v2.33.0 发布","body":"🚀 CodeBuddy Code v2.33.0 发布 ✨ 新功能 模型选择记忆 打开模型面板时自动定位到当前使用的模型，无需手动滚动查找。 🔧 改进优化 LSP 位置转换：修正编辑器行列号与 LSP 服务器之间的坐标转换逻辑，代码跳转、引用查找等操作现在能够准确定位 消息队列稳定性：修复用户在 Agent 执行期间发送的消息可能丢失的问题，确保消息在多轮对话中正确保留 输入建议优化：添加防抖机制，减少不必要的请求，提升输入体验 性能优化：减少组件不必要的重渲染，提升界面响应速度 稳定性提升：修复空列表场景下的潜在崩溃问题 子目录规则支持：支持在项目子目录中放置 CODEBUDDY.md 文件，操作该目录下的文件时自动触发相应规则 文件扩展名兼容：新增对 扩展名的支持（CODEBUDDY.mdc、AGENTS.mdc） Glob 匹配优化：启用 matchBase 模式， 等简单模式现在能够匹配任意目录层级下的文件 条件规则注入增强：文件操作工具执行时自动触发条件规则匹配 🐛 问题修复 上下文压缩：修复压缩过程中中断会话时错误显示中断消息的问题 📝 文档更新 工具文档：新增 NotebookEdit、LSP、TaskOutput 工具说明 CLI 参数：新增 和 参数文档"},{"id":"/cli/release-notes/v2.32.0","title":"🚀 CodeBuddy Code v2.32.0 发布","body":"🚀 CodeBuddy Code v2.32.0 发布 ✨ 新功能 Prompt 建议 在 Agent 完成对话后，CodeBuddy 会自动预测您下一步可能的操作，并以灰色文本形式显示在输入区域。按 Enter 直接发送建议，按 Tab 进入编辑模式，让您的工作流更加顺畅。 🔧 改进优化 上下文管理：修复 MCP 工具信息收集时的异常处理逻辑，提升系统稳定性 配置系统：优化默认值合并逻辑，修复不同配置层级的加载问题 后台任务管理：优化任务注册机制，支持选择性状态监控，减少资源开销 文件搜索工具：增强文件路径匹配算法和 Git 忽略规则处理，提升搜索准确性 错误处理：改进网络错误日志记录，增强问题排查能力 📝 文档更新 MCP 配置文档：更新 MCP 配置文件位置说明，增加基于优先级的配置文件解析机制"},{"id":"/cli/release-notes/v2.31.2","title":"🚀 CodeBuddy Code v2.31.2 发布","body":"🚀 CodeBuddy Code v2.31.2 发布 🔧 改进优化 会话历史记录增强：每条历史消息现在会自动记录产生时的工作目录，便于追溯消息来源 空闲提示通知：用户输入后等待 60 秒无操作时，自动发送终端通知提醒用户，避免遗忘正在进行的任务 MCP 配置路径一致性：修复 toggle manager 在读写配置时的路径优先级逻辑，确保与 config store 行为保持一致 OSC 通知协议优化：调整终端协议优先级，为 iTerm 提供专用的 OSC 9 支持，提升兼容性体验 通知消息简化：移除通知消息中的产品名称前缀，让消息更加简洁清晰 计划模式优化：改进计划审批流程和存储机制，提升使用体验 MCP 配置系统：优化 MCP 配置作用域架构，提升配置隔离性和安全性 文档优化：移除文档中的冗余目录结构，简化文档内容 🐛 问题修复 目录信任匹配：修复递归信任模式无法匹配目录本身的问题，确保目录信任功能正常工作"},{"id":"/cli/release-notes/v2.31.1","title":"CodeBuddy Code v2.31.1 发布","body":"CodeBuddy Code v2.31.1 发布 🔧 改进优化 文件搜索工具：优化 glob 模式处理逻辑，提升模式标准化的准确性 Shell 兼容性提示：在环境信息和命令执行提示中添加默认 Shell 类型，确保生成的命令与用户 Shell 语法兼容 插件市场 Git 操作优化：禁用 Git 凭证提示和交互式 SSH 认证，改善无人值守环境下的插件安装体验 🐛 问题修复 文件权限检查：修复工作区内文件读取时需要重复授权的问题，现在已信任的工作区目录会自动递归信任其所有子文件"},{"id":"/cli/release-notes/v2.31.0","title":"🚀 CodeBuddy Code v2.31.0 发布","body":"🚀 CodeBuddy Code v2.31.0 发布 ✨ 新功能 ACP HTTP 传输协议 新增 Streamable HTTP 传输模式，为 ACP 协议提供更灵活的集成方式： 支持通过 HTTP 端点使用 ACP 协议 可通过 参数启用 提供配套的客户端 SDK，方便快速集成 反馈命令 新增 命令，快速提交反馈或 bug 报告，自动打开浏览器并预填会话信息。 会话历史 API 端点支持获取历史会话的对话消息列表，方便 IDE 集成开发。 插件管理界面增强 全新的插件管理体验，新增 6 个功能 tabs： Discover/Browse：发现和浏览可用插件 Installed：管理已安装插件 Marketplaces：管理插件市场源 Errors：查看详细错误诊断，支持 20+ 种错误类型分类 新增 命令，验证插件有效性 🔧 改进优化 新增模型支持：支持 Kimi K2 Thinking 推理模型 UI 渲染性能：优化终端界面渲染，提升消息显示流畅度 服务代理：Hook 脚本可通过服务代理调用网关服务 LSP 集成：改进 Windows 平台兼容性，修复路径空格问题，增强 C 等语言服务器兼容性 权限管理：优化 Plan 模式下安全命令的自动审批逻辑 Checkpoint 对比：支持对比磁盘文件与快照的差异统计 对话恢复：在恢复选择器中显示检查点时间信息 工作区规则：优化规则注入标签，改进 AI 规则识别能力 🐛 问题修复 规则导入：修复 时被导入规则被错误跳过的问题 上下文压缩：修复压缩后工具审批请求仍弹窗的问题 📝 文档更新 ACP 文档：补充传输协议选择和 HTTP 传输使用说明 环境变量：补充 mTLS、Shell、模型等环境变量配置说明 插件文档：更新插件系统使用说明和错误处理指南"},{"id":"/cli/release-notes/v2.30.1","title":"🚀 CodeBuddy Code v2.30.1 发布","body":"🚀 CodeBuddy Code v2.30.1 发布 🔧 改进优化 文件搜索工具：优化了搜索逻辑，提升了代码可读性和执行效率"},{"id":"/cli/release-notes/v2.30.0","title":"🚀 CodeBuddy Code v2.30.0 发布","body":"🚀 CodeBuddy Code v2.30.0 发布 ✨ 新功能 内置插件市场 新增 CodeBuddy 官方插件市场，提供官方推荐的优质插件，方便用户快速发现和安装。 🔧 改进优化 对话压缩展示：改进对话压缩功能的界面展示，提供更清晰的视觉反馈 文件搜索分页：为 Glob 工具添加 和 参数支持，支持对大型搜索结果进行分页处理 内容搜索分页：为 Grep 工具添加 参数并优化 处理，提升搜索结果的灵活性 API Key 配置：支持通过 settings 配置 API Key，提供更灵活的认证方式 MCP 配置路径显示：改进 MCP 服务器配置文件路径的显示逻辑，正确显示所有配置范围的路径信息 MCP 服务管理：已禁用的 MCP 服务现在可以查看详情页面 工具权限控制：优化工具权限审批流程，增强对特定工具操作的安全控制能力 目录授信优化：用户可以在目录授信提示中选择信任当前目录、信任父目录或递归信任所有子目录，避免对子目录重复授权 Checkpoint 协议优化：提取通用数据结构，减少代码重复，优化会话数据结构和恢复对话 UI"},{"id":"/cli/release-notes/v2.29.0","title":"🚀 CodeBuddy Code v2.29.0 发布","body":"🚀 CodeBuddy Code v2.29.0 发布 ✨ 新功能 会话恢复支持 新增会话恢复功能，支持在 IDE 集成场景下无缝恢复和切换已有会话，提升跨会话工作流的连续性和效率。 LSP 插件支持 新增 Language Server Protocol 插件支持，为 AI 提供实时代码智能功能： 理解代码结构、类型定义和函数签名 支持跨文件的符号跳转和引用查找 提升代码分析的准确性和效率 🔧 改进优化 身份认证性能：优化认证流程，减少不必要的配置检查，提升启动速度 UI 组件优化：改进加载状态显示组件，提升渲染效率和代码结构 子代理追踪：增强子代理任务执行的内部追踪机制，提升事件流处理准确性 🐛 问题修复 会话管理：修复 CLI Agent 会话 ID 管理问题，提升会话持久化和恢复的稳定性 启动命令：修复 命令无法正常执行的问题 网络异常处理：修复子 agent 执行时网络异常导致的错误传播问题，提升任务执行稳定性 待办列表：优化 命令的数据加载逻辑，支持从文件系统恢复待办列表 MCP 连接：改进 MCP 服务器连接机制，支持自定义超时配置，提升连接可靠性 📝 文档更新 身份认证：重构 IAM 文档结构，添加快速开始指南和场景化认证配置示例 插件开发：更新插件开发文档，添加 LSP 配置指南和使用示例 版本说明：新增 v2.28.1 版本发布说明文档 文档索引：更新 CLI 文档索引映射"},{"id":"/cli/release-notes/v2.28.1","title":"🚀 CodeBuddy Code v2.28.1 发布","body":"🚀 CodeBuddy Code v2.28.1 发布 🐛 问题修复 双击 ESC 回退功能：修复输入框为空时连续按两次 ESC 键无法正确触发对话回退功能的问题，现在可以正常使用快捷键快速进入对话回退面板"},{"id":"/cli/release-notes/v2.28.0","title":"🚀 CodeBuddy Code v2.28.0 发布","body":"🚀 CodeBuddy Code v2.28.0 发布 ✨ 新功能 代码安全审查命令：新增 命令，可进行专业的代码安全审查，识别潜在安全漏洞 条件规则加载：支持根据文件操作自动加载相关规则，通过 字段配置匹配模式 模块化规则管理：支持在 目录下组织规则文件，可使用子目录分类管理 本地记忆配置：新增 文件支持个人偏好设置，不会提交到版本控制 AI 模型扩展：新增 GLM 4.6V 和 DeepSeek V3.2 模型支持 Homebrew 安装：macOS/Linux 用户可通过 直接安装 🔧 改进优化 自定义命令渲染：改进命令模板解析，支持内联 Bash 命令执行 记忆加载机制：优化规则触发方式，提升加载效率 MCP 工具列表：增强服务器工具获取稳定性 错误信息优化：提升错误提示可读性，便于问题定位 日志记录增强：设置管理新增详细日志，方便问题排查 Homebrew 更新检测：支持正确检测 Homebrew 安装版本的更新 MCP 输出限制：改进工具输出大小计算方式 MCP 超时配置：支持通过环境变量配置连接超时 🐛 问题修复 代理工具配置：修复 compact 代理的文件读取能力配置问题 Windows IDE 连接：改进 Windows 平台 IDE 进程检测，提升连接稳定性"},{"id":"/cli/release-notes/v2.27.3","title":"🚀 CodeBuddy Code v2.27.3 发布","body":"🚀 CodeBuddy Code v2.27.3 发布 🔧 改进优化 MCP 服务器状态显示：改进待审批服务器的状态展示，更清晰地了解连接状态 自动更新稳定性：优化更新锁机制，避免极端情况下的更新循环 文件搜索一致性：统一文件忽略规则管理，提升搜索结果的准确性 界面响应优化：简化输出面板布局，提升界面响应速度 🐛 问题修复 复杂任务处理：修复子任务因执行限制导致无法完成的问题，现在可以处理更复杂的多步骤任务 上下文压缩质量：改进上下文压缩时的文件读取能力，提升压缩后的内容准确性 子任务稳定性：修复子任务中消息意外转发的问题，提升任务执行的隔离性 SDK 模式优化：改进权限拒绝时的处理逻辑，提升 SDK 集成体验"},{"id":"/cli/release-notes/v2.27.2","title":"🚀 CodeBuddy Code v2.27.2 发布","body":"🚀 CodeBuddy Code v2.27.2 发布 🐛 问题修复 Alpine Linux 兼容性修复：解决在 Alpine 等 musl 系统上运行时的崩溃问题，提升跨平台稳定性 MCP 连接优化：修复并发连接请求导致的传输层冲突问题，提升连接稳定性 命令执行优化：改进一次性命令的 MCP 初始化逻辑，减少不必要的连接开销"},{"id":"/cli/release-notes/v2.27.1","title":"🚀 CodeBuddy Code v2.27.1 发布","body":"🚀 CodeBuddy Code v2.27.1 发布 🔧 改进优化 错误信息展示优化：提升错误信息的准确性和可读性，帮助您更快定位和解决问题 网络连接增强：自动识别网络波动并进行重试，提升服务稳定性和可用性 界面显示改进：统一工具调用结果和异步任务完成通知的展示效果，提供更一致的交互体验 🐛 问题修复 文件路径建议优化：修复文件搜索时路径建议不准确的问题，提升输入效率 输入体验改进：消除交互式输入时建议列表闪烁现象，提供更流畅的输入体验 启动速度提升：解决插件市场初始化时的阻塞问题，加快启动响应速度 Token 统计准确性：修复 token 计算逻辑，确保使用量统计的准确性 错误诊断增强：改进错误信息提取和显示机制，提供更详细和有用的错误诊断信息 网络重试优化：完善超时和连接中断的处理策略，减少因网络波动导致的操作失败"},{"id":"/cli/release-notes/v2.27.0","title":"🚀 CodeBuddy Code v2.27.0 发布","body":"🚀 CodeBuddy Code v2.27.0 发布 ✨ 新功能 对话回退：新增 命令，支持将对话回退到之前的某个消息点，可选择仅回退对话、仅回退代码或同时回退两者 文件检查点：支持在会话中自动创建文件检查点，可在回退时恢复文件到之前的状态 插件市场自动更新：支持为插件市场启用自动更新功能，启动时自动同步市场内容，后台异步执行不影响启动速度 🔧 改进优化 快捷键增强：新增双击 ESC 快捷键激活回退功能，当输入框为空时连续按两次 ESC 可快速进入对话回退面板 🐛 问题修复 插件配置解析修复：修复插件市场配置解析问题，支持多种配置格式，提升配置兼容性 构建脚本权限修复：修复 wheel 包构建过程中二进制文件可执行权限丢失的问题"},{"id":"/cli/release-notes/v2.26.0","title":"🚀 CodeBuddy Code v2.26.0 发布","body":"🚀 CodeBuddy Code v2.26.0 发布 ✨ 新功能 Skills 面板：新增 命令，可快速查看已加载的所有 Skills（包括用户级、项目级和插件级），并显示预估 token 消耗，帮助您更好地管理和优化上下文使用 🔧 改进优化 上下文信息展示优化：优化 命令的 skills 和自定义命令展示方式，按作用域分组并按 token 使用量排序，让您清晰了解上下文消耗详情 任务列表持久化：会话中的任务列表现在会自动保存，确保在上下文压缩后仍能保持完整的任务状态，让长时间会话管理更可靠 终端和编辑器支持扩展：新增对 Kitty、Alacritty 终端以及 Zed 编辑器的自动识别支持；扩展 JetBrains 全系列 IDE 识别能力（包括 IntelliJ IDEA、WebStorm、PhpStorm、GoLand、Rider、CLion、RubyMine、DataGrip 等） 工具调用稳定性提升：增强工具名称匹配能力，提高 Agent 工具调用的成功率和准确性 代码对比体验增强：改进差异对比视图中的文本高亮显示，让代码审查更轻松高效 代码体积优化：移除未使用的内部工具，减少程序体积 🐛 问题修复 子代理事件处理：修复子代理任务结果事件重复传播到主会话的问题，提升多代理协作的稳定性"},{"id":"/cli/release-notes/v2.25.1","title":"🚀 CodeBuddy Code v2.25.1 发布","body":"🚀 CodeBuddy Code v2.25.1 发布 ✨ 新功能 SDK 系统提示词配置：SDK 支持通过配置选项自定义系统提示词，灵活控制 AI 助手的行为和响应风格 🔧 改进优化 文件搜索性能优化：新增搜索结果去重和节流机制，大幅提升大型代码库的搜索响应速度 大仓库支持增强：添加文件和目录数量限制保护机制，防止超大仓库导致内存问题 目录浏览优化：搜索结果现在优先展示目录，方便快速定位项目结构 错误信息展示改进：优化身份认证错误的诊断信息，帮助更快定位和解决问题 工具控制优化：改进会话级别的工具禁用机制，提供更精细的功能控制 🐛 问题修复 流式响应处理修复：修复响应为空时的异常处理，提升错误提示准确性 MCP 权限批量设置：支持使用通配符语法一次性批准服务器的所有工具，简化权限管理流程 多行输入导航修复：修正多行文本输入时 Home/End 键的光标定位行为 编辑器错误提示优化：改进外部编辑器打开失败时的错误提示逻辑 搜索超时优化：文件搜索超时调整为 30 秒，防止僵尸进程占用系统资源"},{"id":"/cli/release-notes/v2.25.0","title":"🚀 CodeBuddy Code v2.25.0 发布","body":"🚀 CodeBuddy Code v2.25.0 发布 ✨ 新功能 计划模式工具：Agent 在执行复杂任务前可主动进入规划阶段，帮助您更好地理解和确认执行计划 模型支持升级：新增对更强大推理模型的支持，提供更长的上下文窗口和更强的推理能力 🔧 改进优化 错误诊断增强：认证失败时提供更详细的错误信息，帮助快速定位和解决问题；优化请求追踪功能，便于排查完整的请求链路 MCP 工具权限管理：支持在项目级别保存工具权限设置，使用\"不再询问\"选项后在整个项目中生效，提升多项目工作流效率 Agent 面板优化：更清晰地展示不同类型的 Agent；改进命令搜索排序算法，让您更快找到想要的命令；扩展外部编辑器支持范围，提供更好的错误提示 输入体验提升：优化输入提示框的响应速度和流畅度；改进反向搜索功能的显示效果，提升交互体验 🐛 问题修复 会话上下文：修复代理服务中上下文传递问题，确保对话信息正确保留和传递 大文件读取：增加文件读取的 token 数量检查，避免读取超大日志文件时超出模型上下文限制导致的错误"},{"id":"/cli/release-notes/v2.24.0","title":"🚀 CodeBuddy Code v2.24.0 发布","body":"🚀 CodeBuddy Code v2.24.0 发布 ✨ 新功能 内置插件市场：支持通过产品配置预置官方推荐的插件市场，启动时自动安装，让用户更方便地发现和使用优质插件 🔧 改进优化 后台任务执行：重构任务管理模块，提升后台任务执行的稳定性和可靠性 待办事项体验：优化待办事项状态更新机制，提升界面响应速度 🐛 问题修复 工具权限检查：修复在 SDK 模式下工具权限检查失效的问题，确保工具调用安全 外部编辑器粘贴：修复从外部编辑器粘贴内容时的文本处理问题，改善输入体验 子代理工具继承：修复子代理配置中的工具继承逻辑，确保正确获取默认工具权限 上下文裁剪时机：优化对话历史裁剪策略，避免超出模型上下文限制导致的错误"},{"id":"/cli/release-notes/v2.23.5","title":"🚀 CodeBuddy Code v2.23.5 发布","body":"🚀 CodeBuddy Code v2.23.5 发布 🔧 改进优化 斜杠命令权限控制：支持为自定义命令配置工具细粒度权限，提升命令执行安全性和灵活性 🐛 问题修复 ACP 模式权限请求：修复在 ACP 协议模式下工具调用权限请求失效的问题，确保工具执行前正确获得用户授权 Subagent 工具访问：修复 MCP 服务器名称包含特殊字符时子代理工具访问失败的问题，提升多代理协作稳定性 工具权限隔离：优化子代理工具权限管理，确保每个代理获得正确的工具访问权限"},{"id":"/cli/release-notes/v2.23.0","title":"🚀 CodeBuddy Code v2.23.0 发布","body":"🚀 CodeBuddy Code v2.23.0 发布 ✨ 新功能 SDK 权限控制：SDK 现支持工具调用权限管理，客户端可以审批或拒绝工具执行请求 交互式问答：SDK 支持 AskUserQuestion 工具，AI 助手可在执行任务时向用户提问并获取反馈 🔧 改进优化 文件搜索性能大幅提升：优化大型仓库下的 @ 文件搜索体验，解决连续输入导致的卡顿问题 后台预加载机制：文件列表在空闲时自动预加载，首次搜索响应更快 智能查询结果：使用 requestId 机制丢弃过期请求，防止结果闪烁 代码规范统一：清理代码中的第三方品牌引用，统一使用产品标准命名 🐛 问题修复 修复首次搜索卡死：首次查询若预加载未完成则异步加载，不阻塞界面响应 修复 Windows 路径匹配：确保所有路径统一为 POSIX 风格，避免匹配失败 修复定时器泄漏：确保超时定时器在所有退出路径上正确清理 修复 Windows .gitignore 规则识别：正确识别以 开头的根规则"},{"id":"/cli/release-notes/v2.23.4","title":"🚀 CodeBuddy Code v2.23.4 发布","body":"🚀 CodeBuddy Code v2.23.4 发布 🔧 改进优化 上下文统计增强： 命令现在会显示 MCP 工具的 token 占用情况，帮助用户更全面地了解上下文使用详情 界面渲染优化：提升终端界面渲染性能和显示稳定性，增强会话状态处理的可靠性 🐛 问题修复 修复首次登录问题：修复首次使用 API Key 认证时无法正确登录的问题 凭证验证增强：增加凭证存在性检查，当凭证获取失败时自动回退到其他认证方式 路径解析改进：支持配置路径中的 展开，提升配置便利性 流式输出优化：修复流式输出时消息标识符重复的问题 会话恢复稳定性：增强空值检查，避免特定场景下的运行时错误 模块加载优化：解决产品配置管理模块的循环依赖问题"},{"id":"/cli/release-notes/v2.23.3","title":"🚀 CodeBuddy Code v2.23.3 发布","body":"🚀 CodeBuddy Code v2.23.3 发布 🔧 改进优化 稳定性提升：常规维护性更新，提升系统稳定性"},{"id":"/cli/release-notes/v2.23.2","title":"🚀 CodeBuddy Code v2.23.2 发布","body":"🚀 CodeBuddy Code v2.23.2 发布 ✨ 新功能 模型支持扩展：新增 GLM 4.7 模型支持，为用户提供更多模型选择"},{"id":"/cli/release-notes/v2.22.0","title":"🚀 CodeBuddy Code v2.22.0 发布","body":"🚀 CodeBuddy Code v2.22.0 发布 ✨ 新功能 SDK 集成增强：新增 SDK 与 CLI 之间的双向通信能力，支持控制信号传递 灵活权限控制：SDK 可以接管工具执行权限，实现自定义权限策略 钩子系统扩展：支持 SDK 注册工具执行钩子，实现自定义拦截和处理逻辑 🔧 改进优化 界面体验提升：优化终端加载框的显示效果，提升视觉呈现和交互体验 🐛 问题修复 输出兼容性增强：修复 SDK 和管道模式下终端控制序列干扰 JSON 输出的问题，确保数据格式正确 搜索准确性提升：改进文件忽略规则匹配逻辑，提升文件搜索的准确性"},{"id":"/cli/release-notes/v2.21.0","title":"🚀 CodeBuddy Code v2.21.0 发布","body":"🚀 CodeBuddy Code v2.21.0 发布 ✨ 新功能 新增模型支持：添加 GPT 5.2 模型，为您提供更强大的推理能力和更智能的代码辅助 🔧 改进优化 加载状态优化：改进终端加载提示的显示效果，让等待过程更加清晰直观 🐛 问题修复 命令执行稳定性：修复子进程调用时可能出现的进程挂起问题，提升命令执行的可靠性"},{"id":"/cli/release-notes/v2.20.1","title":"🚀 CodeBuddy Code v2.20.1 发布","body":"🚀 CodeBuddy Code v2.20.1 发布 🐛 问题修复 CLI 模式判断优化：修复非交互命令（如 install、update）在终端下的输出显示问题 首次安装兼容：修复二进制首次安装时路径检测失败的问题，确保首次安装体验更顺畅 图片内容传输：修复流式输出中图片内容的转换处理，确保图片数据正确显示 🔧 改进优化 任务进度显示：优化任务进度条的视觉效果，更清晰地展示任务执行状态 工具加载增强：改进动态工具的加载时序，确保子代理能正确使用所有可用工具 会话管理稳定性：提升会话生命周期管理的稳定性和性能 输入交互体验：改进终端输入处理，提供更稳定的交互体验 连接可靠性：优化协议通信逻辑，提升连接稳定性"},{"id":"/cli/release-notes/v2.20.0","title":"🚀 CodeBuddy Code v2.20.0 发布","body":"🚀 CodeBuddy Code v2.20.0 发布 ✨ 新功能 使用统计命令：新增 命令，轻松查看您的使用情况，包括 Token 使用量、会话时长、模型调用次数等核心数据 多维度统计视图：支持按模型分类查看使用情况，可在 7 天、30 天和全部时间范围之间灵活切换 可视化图表：提供直观的 ASCII 条形图，清晰展示各模型的使用占比 🔧 改进优化 会话管理增强：优化会话历史记录的存储和清理机制，提升会话管理的稳定性和可靠性 交互体验提升：改进确认框、输入提示框和会话面板的交互体验，操作更流畅便捷 键盘操作优化：增强键盘快捷键的响应稳定性和准确性，提升操作效率 安装检测改进：优化不同环境下的安装方式识别准确性，减少环境相关问题 代理框架升级：更新 OpenAI agents SDK 至最新版本，提升整体稳定性和性能 🐛 问题修复 上下文显示问题：修复 autocompact 禁用时仍显示 buffer 信息的问题，现在显示逻辑更符合预期 Linux 兼容性：解决在旧版 Linux 系统上启动时可能遇到的动态库加载错误 主题显示优化：修正色盲模式下的主题颜色显示效果，改善视觉体验 响应完整性：确保任务结束时总是返回结果消息，避免客户端无法正确退出的问题 错误信息增强：改进错误日志记录，提供更详细的调试信息，便于问题排查"},{"id":"/cli/release-notes/v2.19.2","title":"🚀 CodeBuddy Code v2.19.2 发布","body":"🚀 CodeBuddy Code v2.19.2 发布 🔧 改进优化 对话历史管理：提升对话历史管理效率，优化内存使用，支持更长的对话会话 会话状态管理：优化会话状态管理逻辑，提升多会话切换时的响应速度和稳定性 代码健壮性：完善内部类型定义，提升代码的类型安全性和可维护性 扩展系统增强：改进工具调用前后的钩子执行机制，为插件开发提供更好的扩展性 消息展示优化：优化对话消息的组织和展示逻辑，提升交互体验的流畅度 全新视觉主题：采用全新的品牌绿色配色方案，提升产品视觉识别度 Logo 设计升级：优化终端 Logo 显示效果，采用简洁清爽的机器人头像风格"},{"id":"/cli/release-notes/v2.19.1","title":"🚀 CodeBuddy Code v2.19.1 发布","body":"🚀 CodeBuddy Code v2.19.1 发布 🔧 改进优化 ACP 协议优化：完善命令过滤机制和输出展示，提升协议兼容性和界面清爽度 图片读取支持：Read 工具现在可以直接读取和显示图片文件，支持更丰富的文件处理场景 界面加载优化：简化会话加载状态管理，提升界面响应速度和稳定性 🐛 问题修复 工具审批界面：修复 ACP 协议模式下审批界面信息显示不全的问题，提升信息可读性 Hook 集成机制：改进工具执行 Hook 调用，确保自定义脚本能正确处理工具参数 退出流程完善：修复命令行退出时会话事件未正确触发的问题 终端兼容性：修复在 Windows 和 Linux 部分终端中粘贴大量文本时的兼容性问题"},{"id":"/cli/release-notes/v2.19.0","title":"🚀 CodeBuddy Code v2.19.0 发布","body":"🚀 CodeBuddy Code v2.19.0 发布 ✨ 新功能 会话重命名：新增 命令，支持快速重命名当前会话，可直接传参或通过交互式面板操作 输入撤销：新增 快捷键支持，可随时撤销输入框中的文本编辑 🔧 改进优化 会话恢复面板：优化会话恢复界面，提供更直观的会话管理体验 连接诊断增强：改进网络连接断开场景的诊断信息，便于问题排查"},{"id":"/cli/release-notes/v2.18.0","title":"🚀 CodeBuddy Code v2.18.0 发布","body":"🚀 CodeBuddy Code v2.18.0 发布 ✨ 新功能 API 密钥缓存支持：提高凭据管理的响应速度和效率，减少频繁认证的等待时间。支持通过环境变量 自定义缓存刷新间隔 🔧 改进优化 UI 性能优化：减少界面不必要的重新渲染，提升交互流畅度 粘贴功能增强：提升文本粘贴的处理速度和稳定性 命令显示优化：智能控制命令元数据长度，提升长提示词场景下的性能 模型选择更新：扩展可用模型列表，提供更多选择 🐛 问题修复 MCP OAuth 认证流程修复：解决授权后需要手动重连的问题，提升认证体验 终端兼容性提升：修复在 tmux 环境中代码高亮显示异常的问题"},{"id":"/cli/release-notes/v2.17.0","title":"🚀 CodeBuddy Code v2.17.0 发布","body":"🚀 CodeBuddy Code v2.17.0 发布 ✨ 新功能 IDE 集成增强：新增 IDE 差异确认视图和交互面板，支持在 IDE 中直观审查代码变更 智能确认流程：引入 IDE 确认服务和拦截器，提升工具调用的安全性和用户体验 终端标题自动更新：CLI 会根据对话上下文智能更新终端标题，帮助用户在多个终端窗口中快速识别工作内容 Windows 终端键盘增强：改进 Windows 终端的键盘输入处理，增强多行编辑支持。新增 Windows Terminal 自动配置功能，支持 Shift+Enter 换行快捷键 🔧 改进优化 工具调用界面优化：改进文件读取和搜索工具的展示方式，提供更清晰的信息呈现 权限管理增强：为文件操作工具添加明确的权限确认流程，提升安全性 搜索体验优化：改进文件搜索工具的权限检查机制，在可信目录下提供更流畅的使用体验 界面交互改进：提升终端界面的多选和输入组件交互体验 快捷键调整：将展开详细记录的快捷键从 Ctrl+R 调整为 Ctrl+O，避免与终端反向搜索功能冲突 历史消息展示优化：改进对话记录的展示效果，提供更清晰的查看体验 更新通知改进：优化版本更新通知的显示机制，提升稳定性 🐛 问题修复 ACP 协议兼容性：修复 ACP 模式下会话被错误终止的问题，确保消息流正常传输 自定义模型加载：改进配置文件读取错误处理，提升自定义模型加载的稳定性 消息显示修复：修复历史对话中未完成的消息在新对话中重复出现的问题 管道输入稳定性：改进命令行管道输入的数据读取机制，避免数据丢失 Token 统计准确性：改进模型响应处理的健壮性，避免统计异常 Vim 模式输入：修复 Vim NORMAL 模式下意外输入文本的问题，现在能正确拦截所有输入 Vim 两字符命令：修复 、 、 、 、 、 、 、 、 等命令的处理，支持超时自动取消 工具执行容错：提升多工具并发执行的容错性，单个工具失败不影响其他工具结果"},{"id":"/cli/release-notes/v2.16.0","title":"CodeBuddy Code v2.16.0 发布","body":"CodeBuddy Code v2.16.0 发布 ✨ 新功能 输入历史反向搜索：支持 快捷键在命令历史中进行交互式搜索，快速定位和重用之前的输入内容 🔧 改进优化 输入体验升级：重构输入框状态管理，提升响应速度和交互流畅度 粘贴功能优化：改进剪贴板粘贴体验，更好地处理图片和大文本内容 命令快捷设置： 命令支持直接输入模型 ID 快速切换 更新策略智能化：根据包管理器自动选择最优更新方式 诊断信息完善：Doctor 面板显示自动更新状态和包管理器信息 🐛 问题修复 修复 ACP 模式下终端输出干扰通信的问题 修复反向搜索删除关键词后状态异常的问题 修复子代理消息传递不完整的问题 修复命令执行时可能出现的异常"},{"id":"/cli/release-notes/v2.15.1","title":"CodeBuddy Code v2.15.1 发布","body":"CodeBuddy Code v2.15.1 发布 🔧 改进优化 消息调试增强：为流式输出添加时间戳字段，便于调试和性能分析 代码架构优化：改进消息处理逻辑结构，提升代码可维护性和复用性 Vim 模式操作优化：改进单词移动逻辑，提升光标导航的准确性和流畅度 🐛 问题修复 状态管理优化：修复用户中断操作后状态被异步事件覆盖的问题，确保中断状态正确保持"},{"id":"/cli/release-notes/v2.15.0","title":"🚀 CodeBuddy Code v2.15.0 发布","body":"🚀 CodeBuddy Code v2.15.0 发布 ✨ 新功能 终端通知系统：当终端在后台运行时，AI 助手完成任务后会发送系统通知提醒你查看结果 🔧 改进优化 代理配置增强：支持 NOPROXY 环境变量，可以指定哪些域名不走代理 Vim 模式导航优化：改进 命令的准确性，在单词间移动更加流畅 诊断面板优化：设置信息显示更清晰，复杂配置提供摘要视图 TODO 工具增强：任务列表解析更稳定，容错性更好 🐛 问题修复 子代理执行稳定性：修复连续执行多个子代理时可能出现的响应中断问题 安全更新：修复依赖包中的高危安全漏洞，提升整体安全性 /clear 命令改进：使用清屏命令后，权限模式设置不再被意外重置"},{"id":"/cli/release-notes/v2.14.1","title":"🚀 CodeBuddy Code v2.14.1 发布","body":"🚀 CodeBuddy Code v2.14.1 发布 🔧 改进优化 CLI 交互体验优化：改进命令行界面的交互流程和用户反馈机制，提升操作流畅度 会话管理增强：提升会话中断处理的稳定性和响应能力，减少意外中断影响 Vim 模式完善：优化 Vim 模式下的键盘操作和上下文管理，提供更流畅的编辑体验 工具执行优化：改进工具调用和结果处理的性能与准确性，加快任务响应速度"},{"id":"/cli/release-notes/v2.14.0","title":"CodeBuddy Code v2.14.0 发布","body":"CodeBuddy Code v2.14.0 发布 ✨ 新功能 Vim 编辑器模式：新增 Vim 风格编辑支持，提供 NORMAL 和 INSERT 模式切换，支持标准 Vim 导航和编辑命令，让习惯 Vim 的用户获得熟悉的编辑体验 IDE 选择交互：新增 命令，提供可视化界面选择和管理 IDE 连接，更便捷地控制多 IDE 协作场景 🔧 改进优化 终端模拟优化：改进 Bun 运行时下的终端模拟模块，提升兼容性 Windows 中文显示增强：改进命令输出的字符编码处理，增强 Windows 平台中文显示兼容性 第三方服务兼容性增强：改进运行时 polyfill 机制，提升与第三方服务的兼容性 错误处理增强：改进日志刷新机制的安全性，避免服务未初始化时的错误 IDE 检测增强：改进终端环境识别逻辑，提升 IDE 集成稳定性 环境变量处理优化：改进 环境变量的布尔值解析逻辑，提升配置准确性 🐛 问题修复 命令执行优化：规范化系统命令执行参数，防止意外输出干扰正常流程 IDE 上下文清理：修复 IDE 断开连接后选择内容残留问题，确保会话上下文正确重置 并发工具状态修复：修复多工具并发执行时状态流转异常的问题 消息去重优化：修复消息组重复添加导致的界面显示异常"},{"id":"/cli/release-notes/v2.13.0","title":"🚀 CodeBuddy Code v2.13.0 发布","body":"🚀 CodeBuddy Code v2.13.0 发布 ✨ 新功能 Token 分析命令：新增 命令，可查看当前会话中各模块的 token 使用分布，帮助了解上下文消耗情况 IDE 自动连接：CLI 启动时自动检测本地 IDE 并建立通信连接，状态栏实时显示连接状态 Ripgrep 配置选项：新增 环境变量，可选择使用系统安装的 ripgrep 或内置版本 🔧 改进优化 加载界面优化：改进工具调用结果和加载提示的显示样式，提升视觉体验 模型输出配置：支持通过环境变量动态调整模型输出限制 Skill 加载加速：优化技能扫描机制，提升启动速度 Shell 兼容性增强：改进默认 shell 配置，提升跨平台稳定性 🐛 问题修复 命令执行反馈：修复自定义命令执行时缺少运行状态提示的问题 IDE 文件提示：改进文件打开提示逻辑，未选中内容时也会正确提示 编码检测优化：改进系统编码检测机制，避免错误输出干扰"},{"id":"/cli/release-notes/v2.12.0","title":"🚀 CodeBuddy Code v2.12.0 发布","body":"🚀 CodeBuddy Code v2.12.0 发布 ✨ 新功能 独立主题选择面板：新增 命令，提供交互式主题选择面板，支持 dark、light、colorblind friendly、ANSI 等多种主题变体 主题实时预览：在主题面板中实时预览不同主题的效果，轻松找到适合您的配色方案 用户反馈调查：新增用户体验反馈调查功能，帮助我们更好地了解您的使用体验 输出样式管理：支持自定义 AI 响应的输出格式，满足个性化需求 🔧 改进优化 主题系统重构：独立的主题管理面板提供更专业的配置体验 终端兼容性增强：提升旧版 iTerm 终端的识别和支持能力 文件搜索增强：支持搜索隐藏文件和目录，不再错过重要配置文件 构建优化：改进应用启动速度，响应更加迅速 反馈调查优化：提升反馈组件的响应性能和用户体验 🐛 问题修复 错误重试优化：改进上下文过长错误的识别机制，减少不必要的重试，提升会话稳定性 Skill 配置解析：修复 skill 配置文件中多行文本解析失败的问题"},{"id":"/cli/release-notes/v2.11.0","title":"🚀 CodeBuddy Code v2.11.0 发布","body":"🚀 CodeBuddy Code v2.11.0 发布 ✨ 新功能 Sub agent 模型选择：支持在调用子任务时动态选择模型，可根据任务复杂度灵活调整，优化成本和性能 Sub agent 会话恢复：支持在已有上下文基础上恢复之前的子任务会话，适用于分阶段分析和迭代优化场景 🔧 改进优化 项目级对话记忆增强：支持级联加载上级目录的 CODEBUDDY.md 文件，自动继承项目上下文 交互式命令支持增强：改进终端命令的交互式处理能力，提升命令执行的稳定性和用户体验 终端显示效果优化：增强终端输出的颜色和格式保留，提升视觉体验 退出体验优化：改进 ESC 双击退出逻辑，增加超时时间并添加视觉反馈提示 对话记忆优化：改进对话历史加载机制，提升上下文管理效率 插件加载稳定性提升：单个命令加载失败不再影响其他命令的正常使用 输入体验优化：改进对特殊字符和表情符号的支持，提升编辑流畅度 🐛 问题修复 图片粘贴修复：修复图片粘贴时格式识别问题，确保图片正确上传 响应稳定性提升：修复模型输出超长时可能出现的循环重试问题 配置合并修复：修复配置项合并时的去重问题，避免重复配置条目 编辑器交互修复：解决外部编辑器返回内容处理异常的问题 插件路径修复：修复本地目录类型插件的安装路径识别问题"},{"id":"/cli/release-notes/v2.10.1","title":"🚀 CodeBuddy Code v2.10.1 发布","body":"🚀 CodeBuddy Code v2.10.1 发布 🐛 问题修复 键盘输入优化：改进终端键盘输入处理逻辑，提升输入响应稳定性"},{"id":"/cli/release-notes/v2.10.0","title":"🚀 CodeBuddy Code v2.10.0 发布","body":"🚀 CodeBuddy Code v2.10.0 发布 ✨ 新功能 沙箱管理命令：新增 斜杠命令，可以快速启用或禁用 Bash 命令的沙箱保护模式 🔧 改进优化 ACP 协议模式优化：改进 ACP 模式下的模型信息展示，提供更清晰的运行状态 沙箱架构升级：优化 Bash 命令执行的沙箱机制，提升执行性能和系统稳定性 终端交互增强：改进键盘输入处理和命令解析，提升终端响应速度和输入准确性 文件引用体验提升：使用 引用文件时自动显示文件名和大小 启动性能优化：非交互模式下跳过不必要的初始化步骤，加快启动速度 配置查询优化：自动合并多层级配置并返回最终结果，使用更便捷 界面性能提升：精简登录界面组件，优化渲染性能 权限控制增强：改进 Skill 工具的权限匹配逻辑 🐛 问题修复 ACP 协议权限请求：修复子任务执行工具时权限请求无法正常触发的问题 调试日志完善：确保调试日志正确写入对应的会话文件 消息队列稳定性：修复消息处理时的格式问题，提升显示稳定性 错误处理增强：改进工具参数为空时的容错能力"},{"id":"/cli/release-notes/v2.9.0","title":"🚀 CodeBuddy Code v2.9.0 发布","body":"🚀 CodeBuddy Code v2.9.0 发布 ✨ 新功能 认证成功通知：新增用户登录成功后的 Hook 通知事件，支持在认证完成时触发自定义脚本，实现登录后的自动化工作流"},{"id":"/cli/release-notes/v2.8.6","title":"🚀 CodeBuddy Code v2.8.6 发布","body":"🚀 CodeBuddy Code v2.8.6 发布 🔧 改进优化 终端输入处理增强：改进跨平台输入解析机制，提升终端使用的稳定性和兼容性 粘贴体验优化：完善大段文本粘贴处理，自动识别粘贴模式，提升文本输入便捷性 消息处理机制优化：重构内部消息队列，提升对话响应速度和系统稳定性 界面渲染性能提升：优化应用主界面和聊天视图的渲染效率，提供更流畅的交互体验 命令执行流程简化：优化终端命令执行逻辑，提升执行效率 🐛 问题修复 协议模式配置保持：修复客户端协议模式下多轮会话中配置丢失的问题，确保会话稳定性 tmux 剪贴板粘贴：修复在 tmux 终端环境中无法粘贴剪贴板图片的问题"},{"id":"/cli/release-notes/v2.8.5","title":"🚀 CodeBuddy Code v2.8.5 发布","body":"🚀 CodeBuddy Code v2.8.5 发布 📚 文档增强 GitLab CI/CD 集成指南：新增完整的 CI/CD 集成文档，帮助您在 GitLab 流水线中轻松使用 CodeBuddy Code，包含详细的配置示例、使用场景说明和常见问题解决方案"},{"id":"/cli/release-notes/v2.8.4","title":"🚀 CodeBuddy Code v2.8.4 发布","body":"🚀 CodeBuddy Code v2.8.4 发布 🔧 改进优化 类型定义优化：改进代码组织结构，提升长期维护效率 🐛 问题修复 权限模式同步：修复子任务执行时权限设置未能正确应用的问题，确保批量操作权限控制的一致性"},{"id":"/cli/release-notes/v2.8.3","title":"🚀 CodeBuddy Code v2.8.3 发布","body":"🚀 CodeBuddy Code v2.8.3 发布 🔧 改进优化 Gemini 模型支持扩展：新增 Gemini 3.0 Pro 模型支持，为你提供更强大的推理能力和更大的上下文窗口，胜任更复杂的编程任务 文件处理智能优化：自动识别并跳过超大文件的引用处理，有效避免性能问题，提升大型项目的响应速度 代码架构稳定性增强：优化中间件依赖注入机制、服务初始化流程和会话类型定义，提升系统运行稳定性和代码维护性 会话管理体验提升：改进会话恢复面板的数据处理逻辑，提供更流畅的会话管理体验 权限控制可靠性：完善目录信任状态管理，让权限控制更精准、更可靠 🐛 问题修复 远程执行环境连接稳定性：优化认证令牌处理机制，提升连接沙箱和远程执行环境时的稳定性 Shell 命令兼容性：改进命令执行环境，支持需要终端交互的工具命令，提升各类命令的执行成功率"},{"id":"/cli/release-notes/v2.8.2","title":"🚀 CodeBuddy Code v2.8.2 发布","body":"🚀 CodeBuddy Code v2.8.2 发布 🔧 改进优化 对话上下文增强：改进对话消息处理机制，确保完整的上下文信息在多轮对话中正确保留和传递，提升 AI 响应的连贯性和准确性"},{"id":"/cli/release-notes/v2.8.1","title":"🚀 CodeBuddy Code v2.8.1 发布","body":"🚀 CodeBuddy Code v2.8.1 发布 🔧 改进优化 Plan 模式重构：采用全新的 Sub Agent 架构重构 Plan 模式，提供更智能、更稳定的任务规划和执行能力 智能模型图片检测：自动检测模型图片支持能力，在模型不支持时智能处理图片输入，提升跨模型使用的流畅度 运行环境健康检查：启动时自动检测 Node.js 版本，提前规避环境兼容性问题，确保工具稳定运行 ACP 协议体验增强：创建会话时自动推送命令列表，支持智能补全；优化认证方式，根据网络环境自动推荐最佳登录选项 权限命令风险调整：优化 sudo/su 等提权命令的风险分级策略，减少不必要的二次确认，在保障安全的前提下提升效率 🐛 问题修复 Git 操作安全增强：优化危险命令检测规则，更精准地识别和拦截强制推送、删除分支等高风险 Git 操作 Windows 路径兼容：修复 Windows 系统下的路径大小写敏感问题，提升跨平台文件操作的稳定性 非交互模式工具控制：修复用户问答工具在非交互模式下的行为逻辑，确保自动化流程顺畅执行 专享版环境适配：修复专享版环境识别异常，确保配置加载的正确性 剪贴板检测兼容性：临时调整剪贴板检测策略，解决部分环境下的误触发问题，提升使用体验"},{"id":"/cli/release-notes/v2.8.0","title":"🚀 CodeBuddy Code v2.8.0 发布","body":"🚀 CodeBuddy Code v2.8.0 发布 ✨ 新功能 编辑器原生集成：支持通过 ACP 协议与 Zed 等编辑器深度集成，带来更流畅的 AI 辅助开发体验 智能安全防护：引入五级命令风险分级系统，覆盖文件操作、Git 管理、容器控制等 9 大类场景，高风险操作自动拦截确认，让 AI 自动化更安心 🔧 改进优化 危险操作智能识别：优化风险评估策略，自动识别可能丢失数据的 Git 操作并提升风险等级，主分支保护更严格 安全模式增强：改进权限绕过模式的安全检查，交互场景下极高风险操作仍需确认，兼顾自动化与安全 视觉提示升级：高风险命令确认界面使用警告色高亮，一眼识别潜在危险操作 文档解析效率提升：优化 Markdown 文件处理性能，加载速度更快 🐛 问题修复 安全审批机制加固：修复高风险命令可能跳过确认的漏洞，确保所有危险操作都经过用户授权 提示模板优化：消除系统提示中的重复内容，提升 AI 响应的准确性"},{"id":"/cli/release-notes/v2.7.0","title":"🚀 CodeBuddy Code v2.7.0 发布","body":"🚀 CodeBuddy Code v2.7.0 发布 ✨ 新功能 Token 计数器显示控制：新增显示开关设置，可以根据个人偏好选择显示或隐藏 Token 使用统计信息 🔧 改进优化 会话标识符规则优化：放宽会话 ID 的格式限制，支持更灵活的自定义会话标识 统计准确性提升：改进工具执行状态的统计逻辑，确保使用数据的准确性 🐛 问题修复 消息处理可靠性增强：增强消息类型校验机制，避免非法数据导致的处理异常 错误反馈机制优化：改进异常信息的传递流程，提供更清晰的错误提示 主题适配体验优化：优化颜色显示算法，自动适配暗色和亮色主题，提升视觉舒适度"},{"id":"/cli/release-notes/v2.6.1","title":"🚀 CodeBuddy Code v2.6.1 发布","body":"🚀 CodeBuddy Code v2.6.1 发布 🔧 改进优化 错误处理增强：改进服务端请求错误处理机制，提升错误信息的准确性和可读性，让问题排查更加高效 🐛 问题修复 图片粘贴功能优化：优化剪贴板图片读取机制，改进多文件粘贴支持，提升图片粘贴的稳定性和可靠性 插件市场去重：修复插件市场加载时可能出现重复条目的问题，现在会自动过滤名称和来源相同的市场，提升界面整洁度"},{"id":"/cli/release-notes/v2.6.0","title":"🚀 CodeBuddy Code v2.6.0 发布","body":"🚀 CodeBuddy Code v2.6.0 发布 ✨ 新功能 GPT 5.1 系列模型：新增 GPT 5.1、GPT 5.1 codex、GPT 5.1 codex mini 三个模型选项，提供更大的上下文窗口（支持 272K tokens 输入）和更强的推理能力，适合处理复杂的代码分析和长文档任务"},{"id":"/cli/release-notes/v2.5.0","title":"🚀 CodeBuddy Code v2.5.0 发布","body":"🚀 CodeBuddy Code v2.5.0 发布 ✨ 新功能 会话分支管理：支持在恢复会话时创建新的分支，帮助你更好地组织和管理不同的对话主题 消息回放确认：在非交互模式下自动回显你的输入内容，确保命令执行前能够二次确认 自定义代理配置：允许你通过配置文件定义专属的 AI 助手行为和能力 系统提示词个性化：支持自定义或扩展系统提示词，让 AI 助手更符合你的工作习惯 设置加载控制：灵活指定从哪些来源加载配置（用户级/项目级/临时设置），满足不同场景需求 外部配置导入：支持从文件或 JSON 字符串加载额外设置，便于配置共享和复用 🔧 改进优化 命令执行更灵活：可通过环境变量自定义 Bash 命令的超时时间和输出长度，适应不同任务需求 详细日志模式：新增详细输出开关，帮助你深入了解 AI 助手的执行过程 流式消息增强：在流式输出模式下支持查看完整的增量消息，提供更透明的执行反馈 成本统计美化：改进使用成本统计的展示格式，信息对齐更清晰易读 配置加载优化：添加产品配置缓存机制，提升启动速度和运行性能 🐛 问题修复 MCP 服务器交互优化：解决非交互模式下 MCP 服务器审批导致的阻塞问题，现可预先配置免审批服务器 终端兼容性改善：修复部分终端环境下的粘贴模式异常和 ESC 键延迟问题，输入体验更流畅 更新服务稳定性：优化自动更新检查机制，避免重复安装，确保更新过程可靠稳定"},{"id":"/cli/release-notes/v2.4.0","title":"🚀 CodeBuddy Code v2.4.0 发布","body":"🚀 CodeBuddy Code v2.4.0 发布 ✨ 新功能 任务执行轮次控制：新增 命令行参数，让您可以精确控制 AI 助手的执行轮次，避免无限循环，提升任务执行的可控性 🔧 改进优化 执行能力提升：默认最大执行轮次从 100 提升至 500，为复杂任务提供更充足的处理空间，减少因轮次限制导致的任务中断 外部编辑器集成：新增 Ctrl+G 快捷键支持，可快速调用 VSCode、Sublime Text 等外部编辑器编辑长文本，提升输入体验 日志保存优化：改进日志落盘机制，确保进程退出时所有日志信息完整保存，方便问题排查 会话管理优化：改进历史会话列表展示，自动过滤内部子代理会话，让会话列表更清晰 🐛 问题修复 Native 版本命令兼容性：修复 命令在 Native 环境中无法正常运行的问题 遥测数据准确性：修复工具调用遥测数据中标识信息缺失问题，确保数据完整上报 自动更新稳定性：增强多进程场景下的自动更新锁机制，避免更新冲突 子代理中断问题：修复使用子代理时无法响应中断指令的问题，提升交互体验"},{"id":"/cli/release-notes/v2.3.1","title":"🚀 CodeBuddy Code v2.3.1 发布","body":"🚀 CodeBuddy Code v2.3.1 发布 🔧 改进优化 文件编辑稳定性：优化字符串替换逻辑，提升处理特殊字符时的准确性和可靠性 插件市场体验：改进插件源识别能力，提供更友好的错误提示，降低配置门槛 Skills 调试体验：优化技能加载日志输出，更清晰地展示技能来源，便于问题排查 工具系统灵活性：支持根据运行环境动态控制工具可用性，提升系统适应性 命令输入效率：改进斜杠命令自动补全，精确匹配优先显示，加快命令输入 界面渲染性能：优化列表组件 key 属性策略，提升终端界面的稳定性和流畅度 图片粘贴兼容性：增强 cmd+v 粘贴图片功能，改进 Windows 系统兼容性 配置界面专业性：优化 Hooks 配置面板的提示文案，提升产品质感 🐛 问题修复 Hooks 文档完善：更新 Hooks 使用指南，改进文档结构和示例，让配置更简单"}]
+[{"id":"/cli/overview","title":"概述","body":"概述 腾讯云智能编程助手 让代码开发更智能、更高效 CodeBuddy Code 是基于腾讯云 AI 技术的智能编程工具，深度集成腾讯云生态，提供从代码编写到项目部署的全链路 AI 辅助。 为什么选择 CodeBuddy Code？ 🚀 用自然语言驱动整个开发运维生命周期 CodeBuddy Code 让您能够用自然语言描述需求，自动化完成从代码编写、测试、调试到部署的全链路开发任务，实现极致的自动化效率提升。无论是简单的代码修改还是复杂的架构重构，都能通过对话式交互轻松完成。 🔧 终端原生，无缝集成 熟悉的环境：直接在您熟悉的命令行环境中获得 AI 辅助，无需切换开发工具或学习新界面 原生体验：完美融入现有的开发工作流，支持所有主流操作系统和终端 零学习成本：保持原有的开发习惯，AI 助手静默工作在后台 ⚡ 开箱即用的强大能力 内置工具链：集成文件编辑、命令运行、Git 操作、测试执行等核心开发工具 智能提交：自动生成规范的提交信息，支持代码审查和变更管理 灵活扩展：通过 MCP (模型上下文协议) 轻松集成第三方工具和服务 自定义开发工具：根据项目需求定制专属的开发助手 🛠️ Unix 哲学的 AI 集成 管道友好：像 和 一样，原生支持管道输入进行智能分析 脚本集成：完美融入 shell 脚本和自动化工具链 组合能力：与现有 Unix 工具无缝组合，构建强大的 AI 驱动工作流 标准输入输出：遵循 Unix 标准，支持重定向和管道操作 快速体验 环境要求 Node.js 18.0+ 一键安装 开始使用 下一步操作 📚 深入了解 详细的设置和使用指南 扩展思考、图片粘贴、 resume 等功能 在你喜欢的编辑器中使用 🔧 配置和扩展 模型上下文协议集成 内置命令参考 配置文件、环境变量、工具设置 🚀 高级用法 GitHub Actions CI/CD 集成 SDK 开发 扩展和自定义 企业部署 容器化部署 🆘 获取帮助 常见问题解决 完整命令行参考 交互模式 键盘快捷键和技巧 反馈和支持 📧 技术支持：codebuddy@tencent.com 🌐 🌐"},{"id":"/cli/quickstart","title":"快速入门指南","body":"快速入门指南 欢迎使用 CodeBuddy Code！这份指南将帮助您在 5 分钟内上手，体验自然语言驱动的编程助手。 🎯 开始之前 系统要求 Node.js：版本 18.20 或更高 操作系统: macOS、Linux 或 Windows 验证环境 ⚡ 极速安装 npm 全局安装 原生安装器（Beta） ⚠️ Beta 功能：原生安装器目前处于 Beta 阶段。我们推荐您尝试使用，以获得更快速、独立的安装体验。 原生安装器提供独立的 CodeBuddy 安装，无需 Node.js 环境。 下载并安装： 优势： ✅ 无需 Node.js 依赖 ✅ 安装和启动速度更快 验证安装 🔐 登录认证 首次使用 CodeBuddy Code 时，您需要完成登录认证。启动后会显示登录方式选择界面： 登录方式说明 登录方式 适用场景 说明 Chinese Site 国内用户 通过腾讯云国内站 (copilot.tencent.com) 进行认证，支持国内主流模型 International Site 海外用户 通过腾讯云国际站 (codebuddy.ai) 进行认证，支持海外主流模型 Enterprise Domain 专享版/私有化部署 连接企业专享版或自建的 CodeBuddy 服务，需要输入企业提供的服务地址 iOA 腾讯内部员工 通过腾讯 iOA 零信任系统进行认证，仅限腾讯内部员工使用 使用 键选择登录方式，按 确认后会自动打开浏览器完成认证。 🚀 首次体验 1. 进入项目目录 2. 启动交互模式 您将看到欢迎界面： 提示：如果您希望 CodeBuddy Code 始终使用特定语言回复（如简体中文），可以在启动后运行 命令设置 Language 选项。 3. 初始化项目上下文（强烈推荐） 在正式开始对话之前，强烈建议先使用 命令初始化项目上下文： 为什么 /init 如此重要？ 📊 效果提升： ✅ 理解更准确：预先构建项目知识图谱，AI 能更准确理解代码结构和业务逻辑 ✅ 响应更快速：避免重复扫描文件，后续对话响应速度显著提升 ✅ 建议更精准：基于全局视图提供更符合项目架构的建议 ✅ 减少误判：了解项目依赖关系，避免提出不兼容的修改方案 💰 成本优化： ✅ Token 消耗更少：一次性建立上下文，避免每次对话都重新分析 ✅ 减少重复请求：预加载关键信息，减少 30 50% 的上下文 Token 开销 ✅ 更高效的对话：每轮对话携带更少的冗余信息，整体成本更低 最佳实践： 4. 尝试第一个对话 CodeBuddy 会自动扫描您的项目文件，并提供详细的结构分析。 💡 核心使用模式 交互式对话模式 最自然的使用方式，适合探索性开发： 典型对话示例： 单次命令模式 适合脚本化和自动化场景： 重要提示：使用 参数进行单次执行时,如果操作需要访问文件、执行命令等授权操作,必须添加 （或 ) 参数。 项目级操作 处理复杂的跨文件任务： 快捷键 基础导航 快捷键 功能 浏览命令历史 查看后台任务（当有运行中任务时） 命令自动补全 清空输入（按两次） / 返回上级菜单 退出程序 退出程序（输入框为空且无进行中对话时，连按两次） 权限和模式 快捷键 功能 (macOS/Linux) 或 (Windows) 切换权限模式（default → bypass → accept → plan） 编辑功能 快捷键 功能 展开/收起详细输出（在对话中） 使用外部编辑器编辑提示词 发送消息 换行（多行输入） 换行（反斜杠转义） 插入换行（多行输入） 面板操作 快捷键 功能 在面板中导航选项 选择当前项 切换选择（多选面板） 终止选中的后台任务 专用功能 快捷键 功能 Vim风格的上下导航（部分面板支持） 查看思考详情面板 当终端显示“Thinking”指示时，可用 打开完整推理内容,再按 退出。 🎓 进阶学习 恭喜您完成快速入门！接下来推荐阅读： 学习扩展思考、图片分析等高级功能 在 VS Code、JetBrains 中使用 掌握所有内置命令 扩展自定义工具 💬 获取帮助 遇到问题？我们随时为您提供支持： 🐛 📧 技术支持：codebuddy@tencent.com 📚 🌐 现在开始，让 AI 成为您的编程伙伴！🚀"},{"id":"/cli/installation","title":"CodeBuddy Code 安装指南","body":"CodeBuddy Code 安装指南 安装方式 📦 使用包管理器安装 Node.js 包管理器 前置要求: Node.js 18.20 或更高版本 选择你喜欢的包管理器执行以下命令: ::: code group ::: Homebrew (macOS/Linux) 无需 Node.js，直接安装: ::: code group ::: 验证安装 安装完成后,运行以下命令验证是否安装成功: ⚙️ 使用原生二进制安装（Beta） ⚠️ Beta 测试阶段 原生二进制安装目前处于 Beta 测试阶段，功能仍在完善中。 如遇到任何问题，请在 提交问题报告，或联系技术支持（codebuddy@tencent.com）。 特性说明 原生二进制安装相比 npm 版本提供以下特性： 单一可执行文件，无需额外依赖 无需 Node.js 运行时 改进的自动更新机制 支持平台 macOS (Apple Silicon M1/M2/M3 或 Intel x8664) Linux (arm64 或 x8664) Windows (x8664) 从 npm 版本迁移 如果你已经通过 npm 安装了 CodeBuddy Code，可以使用以下命令迁移到原生二进制版本： 全新安装 ::: code group ::: 验证安装 安装脚本会自动下载最新版本并配置环境变量。安装完成后，运行以下命令验证： 如果命令不可用,请手动将安装路径添加到环境变量 : ::: code group ::: 📁 配置目录 CodeBuddy Code 默认将配置文件存储在以下目录: 平台 默认配置目录 macOS / Linux Windows 配置目录内容 自定义配置目录 通过设置环境变量 可以自定义配置目录位置: 这在以下场景中非常有用: 多个 CodeBuddy 实例需要独立配置 企业环境中需要统一管理配置位置 与其他使用 CodeBuddy 引擎的应用（如 WorkBuddy）共存时避免配置冲突 🔄 更新 自动更新 CodeBuddy Code 默认会自动保持最新状态，以确保你拥有最新的功能和安全修复。 关闭自动更新 如需关闭自动更新，可设置环境变量： 手动更新 使用以下命令手动更新到最新版本： 命令会自动检测你的安装方式并执行相应的更新操作。 使用包管理器更新 如果 命令未能成功更新，你也可以使用包管理器重新安装： 或使用其他包管理器（pnpm、yarn、bun）执行相应的安装命令。 🔧 故障排查 命令不可用 问题： 安装后提示 解决方案： 1. 检查安装路径是否在 环境变量中： 2. 将 CodeBuddy 安装路径添加到 （参考上方 如需完全清理,可删除配置目录: macOS / Linux: 💡 提示: 如果你使用了 环境变量自定义了配置目录，请删除对应的目录。"},{"id":"/cli/common-workflows","title":"常见工作流","body":"常见工作流 学习 CodeBuddy Code 的常见工作流程。 本文档中的每个任务都包含清晰的说明、示例命令和最佳实践，帮助您充分利用 CodeBuddy Code。 理解新代码库 快速了解代码库概况 假设您刚加入一个新项目，需要快速了解其结构。 步骤： 1. 导航到项目根目录 2. 启动 CodeBuddy Code 3. 询问高层次概览 4. 深入了解特定组件 最佳实践： 从宏观问题开始，然后缩小到特定领域 询问项目中使用的编码规范和模式 请求项目特定术语的词汇表 查找相关代码 假设您需要定位与特定功能相关的代码。 步骤： 1. 请 CodeBuddy 查找相关文件 2. 了解组件如何交互 3. 理解执行流程 最佳实践： 对要查找的内容要具体 使用项目中的领域语言 重构代码 假设您需要更新旧代码以使用现代模式和实践。 步骤： 1. 识别需要重构的遗留代码 2. 获取重构建议 3. 安全地应用更改 4. 验证重构 最佳实践： 请 CodeBuddy 解释现代方法的好处 需要时请求更改保持向后兼容性 以小的、可测试的增量进行重构 使用计划模式进行安全的代码分析 计划模式指示 CodeBuddy 通过只读操作分析代码库来创建计划，非常适合探索代码库、规划复杂更改或安全地审查代码。 何时使用计划模式 多步骤实现：当您的功能需要编辑许多文件时 代码探索：当您想在更改任何内容之前彻底研究代码库时 交互式开发：当您想与 CodeBuddy 就方向进行迭代时 如何使用计划模式 在会话期间开启计划模式 您可以在会话期间使用快捷键切换权限模式来切换到计划模式： macOS/Linux：按 Shift+Tab Windows：按 Alt+M 如果您处于普通模式，按快捷键将首先切换到自动接受模式，终端底部会显示 。再次按快捷键将切换到计划模式,显示 。 以计划模式启动新会话 要以计划模式启动新会话，使用 参数： 在计划模式下运行\"无头\"查询 您也可以使用 直接在计划模式下运行查询（即在 中）: 示例： 规划复杂重构 CodeBuddy 将分析当前实现并创建全面的计划。使用后续问题进行完善： 将计划模式配置为默认 查看 了解更多配置选项。 处理测试 假设您需要为未覆盖的代码添加测试。 步骤： 1. 识别未测试的代码 2. 生成测试脚手架 3. 添加有意义的测试用例 4. 运行并验证测试 最佳实践： 要求涵盖边缘情况和错误条件的测试 适当时请求单元测试和集成测试 让 CodeBuddy 解释测试策略 创建合并请求 假设您需要为更改创建一个文档完善的合并请求。 步骤： 1. 总结您的更改 2. 使用 CodeBuddy 生成 MR 3. 审查并完善 4. 添加测试详情 最佳实践： 直接让 CodeBuddy 为您创建 MR 提交前审查 CodeBuddy 生成的 MR 让 CodeBuddy 强调潜在的风险或考虑因素 处理文档 假设您需要为代码添加或更新文档。 步骤： 1. 识别未文档化的代码 2. 生成文档 3. 审查并增强 4. 验证文档 最佳实践： 指定您想要的文档风格(JSDoc、docstrings 等） 在文档中要求示例 为公共 API、接口和复杂逻辑请求文档 处理图片 假设您需要处理代码库中的图片，并希望 CodeBuddy 帮助分析图片内容。 步骤： 1. 将图片添加到对话中 您可以使用以下任一方法： 1. 将图片拖放到 CodeBuddy Code 窗口中 2. 复制图片并用 ctrl+v 粘贴到 CLI 中（不要使用 cmd+v) 3. 向 CodeBuddy 提供图片路径。例如：\"分析这张图片： /path/to/your/image.png\" 2. 让 CodeBuddy 分析图片 3. 使用图片提供上下文 4. 从视觉内容获取代码建议 最佳实践： 当文本描述不清楚或繁琐时使用图片 包含错误、UI 设计或图表的截图以获得更好的上下文 您可以在对话中处理多张图片 图片分析适用于图表、截图、原型设计等 引用文件和目录 使用 @ 快速包含文件或目录，无需等待 CodeBuddy 读取它们。 步骤： 1. 引用单个文件 这会在对话中包含文件的完整内容。 2. 引用目录 这会提供带有文件信息的目录列表。 3. 引用 MCP 资源（暂不支持） 这会使用 @server:resource 格式从连接的 MCP 服务器获取数据。详见 。 最佳实践： 文件路径可以是相对路径或绝对路径 @ 文件引用会将文件目录及父目录中的 CODEBUDDY.md 添加到上下文 目录引用显示文件列表，而不是内容 您可以在单条消息中引用多个文件（例如，\"@file1.js 和 @file2.js\") 使用扩展思考 假设您正在处理复杂的架构决策、具有挑战性的 bug"},{"id":"/cli/interactive-mode","title":"交互模式","body":"交互模式 CodeBuddy Code 交互式会话中的完整键盘快捷键、输入模式和交互功能参考。 键盘快捷键 <Note 键盘快捷键可能因平台和终端而异。在交互式会话中输入问号 可查看您环境中可用的快捷键。 </Note 通用控制 快捷键 描述 上下文 CodeBuddy 支持 : : : : 取消当前输入或生成 标准中断 ✅ 支持 退出 CodeBuddy Code 会话（输入框为空且无进行中对话时） EOF 信号，连按两次退出 ✅ 支持 清除终端屏幕 保留对话历史 ✅ 支持 切换详细输出 显示详细的工具使用和执行信息 ✅ 支持 反向搜索命令历史 交互式搜索之前的命令 ✅ 支持 (macOS/Linux) 或 (Windows) 从剪贴板粘贴图片 粘贴图片或图片文件路径 ✅ 支持 导航命令历史 调用之前的输入 ✅ 支持 + 回退代码/对话 将代码和/或对话恢复到之前的状态 (需在输入框为空时连续按两次) ✅ 支持 切换思考模式 在思考开启和思考关闭之间切换 ✅ 支持 (macOS/Linux) 或 (Windows) 切换权限模式 在自动接受模式、计划模式和普通模式之间切换 ✅ 支持 (macOS) 或 (Windows/Linux) 切换模型 快速打开模型选择面板 ✅ 支持 说明： + 回退功能已支持：当输入框内容为空时，连续按两次 ESC 键可激活 功能，快速回退代码或对话到之前的状态 键在 CodeBuddy Code 中主要用于自动补全，扩展思考模式的切换功能部分支持 (macOS/Linux) 或 (Windows) 用于切换权限模式，包括普通模式、自动接受编辑模式、跳过权限模式和计划模式。注意：在 Windows 上必须使用 ， 不起作用 多行输入 方法 快捷键 上下文 CodeBuddy 支持 : : : : 快速转义 + 在所有终端中工作 ✅ 支持 macOS 默认 macOS 上的默认设置 ✅ 支持 终端设置 执行 后 ✅ 支持 控制序列 多行的换行字符 ✅ 支持 粘贴模式 直接粘贴 用于代码块、日志 ✅ 支持 <Tip 在终端设置中配置您首选的换行行为。运行 为 iTerm2 和 VS Code 终端安装 Shift+Enter 绑定。 </Tip 快速命令 快捷键 描述 注释 CodeBuddy 支持 : : : : 在开头 记忆快捷方式 添加到 CODEBUDDY.md 提示选择文件 ✅ 支持 在开头 斜杠命令 参见 ✅ 支持 在开头 Bash 模式 直接运行命令并将执行输出添加到会话 ✅ 支持 文件路径提及 触发文件路径自动补全 ✅ 支持 编辑快捷键 快捷键 描述 CodeBuddy 支持 : : : 移动到行首 ✅ 支持 移动到行尾 ✅ 支持 删除从光标到行尾 ✅ 支持 删除从行首到光标 ✅ 支持 删除前一个单词 ✅ 支持 复制最后一条 AI 回复到剪贴板 ✅ 支持 删除前一个单词 ✅ 支持 删除下一个单词 ✅ 支持 移动到上一个单词 ✅ 支持 移动到下一个单词 ✅ 支持 移动到行首 ✅ 支持 移动到行尾 ✅ 支持 打开外部编辑器编辑提示词 ✅ 支持 Vim 编辑器模式 使用 命令启用 vim 风格编辑,或通过 永久配置。 模式切换 命令 操作 从模式 CodeBuddy 支持 : : : : 进入 NORMAL 模式 INSERT ✅ 支持 在光标前插入 NORMAL ✅ 支持 在行首插入 NORMAL ✅ 支持 在光标后插入 NORMAL ✅ 支持 在行尾插入 NORMAL ✅ 支持 在下方打开新行 NORMAL ✅ 支持 在上方打开新行 NORMAL ✅ 支持 导航 （NORMAL 模式） 命令 操作 CodeBuddy 支持 : : : / / / 向左/下/上/右移动 ✅ 支持 下一个单词 ✅ 支持 单词末尾 ✅ 支持 上一个单词 ✅ 支持 行首 ✅ 支持 行尾 ✅ 支持 第一个非空白字符 ✅ 支持 输入开始 ✅ 支持 输入结束 ✅ 支持 编辑 （NORMAL 模式） 命令 操作 CodeBuddy 支持 : : : 删除字符 ✅ 支持 删除行 ✅ 支持 删除到行尾 ✅ 支持 / / 删除单词/到末尾/到开头 ✅ 支持 修改行 ✅ 支持 修改到行尾 ✅ 支持 / / 修改单词/到末尾/到开头 ✅ 支持 重复上次修改 ✅ 支持 命令历史 CodeBuddy Code 为当前会话维护命令历史： 历史记录按工作目录存储 使用 开启全新对话（旧对话可通过 恢复） 使用 Up/Down 方向键导航 （参见上面的键盘快捷键） 注意：历史扩展 （ ) 默认禁用 使用 Ctrl+R 反向搜索 按 交互式搜索您的命令历史： 1. 开始搜索：按 激活反向历史搜索 2. 输入查询：输入文本以在之前的命令中搜索 "},{"id":"/cli/headless","title":"无头模式 （Headless Mode)","body":"无头模式 （Headless Mode) 以编程方式运行 CodeBuddy Code,无需交互式 UI 概述 无头模式允许您通过命令行脚本和自动化工具以编程方式运行 CodeBuddy Code,无需任何交互式 UI。 无头模式也支持定时任务相关能力。在脚本、SDK 或服务端集成场景中，可以使用 、 、 等工具来创建、查看和取消定时任务。 ⚠️ 重要提示： （或 ) 是非交互模式的必需参数。在使用 参数进行非交互式执行时，必须添加此参数才能执行需要授权的操作（文件读写、命令执行、网络请求等）,否则这些操作会被阻止。仅在受信任的环境和明确的任务场景下使用此参数。详见 。 基本用法 CodeBuddy Code 的主要命令行接口是 （或 ) 命令。使用 （或 ) 标志在非交互模式下运行并打印最终结果： 配置选项 无头模式利用 CodeBuddy Code 中所有可用的 CLI 选项。以下是用于自动化和脚本编写的关键选项： 标志 描述 示例 : : : , 在非交互模式下运行 指定输出格式 （ , , ) , 通过会话 ID 恢复对话 , 继续最近的对话 启用详细日志记录 追加到系统提示词 （仅与 配合使用） 允许的工具列表,空格分隔或<br / <br / 逗号分隔的字符串 <br / <br / 拒绝的工具列表,空格分隔或<br / <br / 逗号分隔的字符串 <br / <br / 从 JSON 文件或 JSON 字符串加载额外的设置配置 指定要加载的设置源（可选值: , , ） 从 JSON 文件加载 MCP 服务器 用于处理权限提示的 MCP 工具 （仅与 配合使用） ❌ 不支持 说明： 功能当前不支持。 有关 CLI 选项和功能的完整列表，请参阅 文档。 多轮对话 对于多轮对话，您可以恢复对话或从最近的会话继续： 输出格式 文本输出 （默认） JSON 输出 返回包含元数据的结构化数据： 响应格式： 流式 JSON 输出 在收到每条消息时流式传输： 每个对话都以初始 系统消息开始,然后是用户和助手消息列表,最后是包含统计信息的最终 系统消息。每条消息都作为单独的 JSON 对象发出。 结构化 JSON 输出 要获得符合特定架构的输出，请使用 和 以及 定义。响应包括关于请求的元数据（会话 ID、使用情况等），结构化输出在 字段中。 此示例从 auth.py 中提取函数名称并将其作为字符串数组返回： 提示：使用 之类的工具来解析响应并提取特定字段： 输入格式 文本输入 （默认） 流式 JSON 输入 通过 提供的消息流,其中每条消息代表一个用户轮次。这允许在不重新启动 二进制文件的情况下进行多轮对话，并允许在模型处理请求时向模型提供指导。 每条消息都是一个 JSON \"用户消息\" 对象,遵循与输出消息模式相同的格式。消息使用 格式进行格式化,其中每行输入都是一个完整的 JSON 对象。流式 JSON 输入需要 和 。 Agent 集成示例 SRE 事件响应机器人 自动化安全审查 多轮法律助手 最佳实践 使用 JSON 输出格式 进行程序化解析响应： 优雅地处理错误 检查退出代码和 stderr: 使用会话管理 在多轮对话中维护上下文 考虑超时 对于长时间运行的操作： 遵守速率限制 在进行多个请求时，通过在调用之间添加延迟 使用 在非交互模式下执行需要授权的操作： ⚠️ 重要提示： （或 ) 是非交互模式的必需参数。在使用 参数进行非交互式执行时，必须添加此参数才能执行需要授权的操作（文件读写、命令执行、网络请求等）,否则这些操作会被阻止。仅在受信任的环境和明确的任务场景下使用此参数。详见 。 相关资源 完整的 CLI 文档 常见用例的分步指南 交互式会话功能 工具权限和访问控制 提示：无头模式非常适合 CI/CD 管道、自动化脚本和 agent 集成。将其与 MCP 服务器结合使用以扩展功能。"},{"id":"/cli/troubleshooting","title":"故障排查与最佳实践","body":"故障排查与最佳实践 本文档涵盖常见问题解决方案和使用优化建议。 常见问题 额度共享 CLI、CodeBuddy IDE 和 CodeBuddy Plugin 共享同一账号的资源配额。 JetBrains IDE 中 ESC 键不生效 JetBrains 终端对 ESC 键处理不同，改用 或 。 操作 标准终端 JetBrains 终端 退出/取消 或 模型切换 serve 模式网络访问问题 局域网 IP 访问报 症状：使用 启动后，通过局域网 IP（如 ）访问时，浏览器报 （未发送任何数据）。 原因：HTTP 服务默认监听 （本地回环地址），只接受本机连接。使用局域网 IP 访问时，请求到达了机器但被服务拒绝。 解决方案：启动时添加 参数，使服务监听所有网络接口： 非回环地址启动时会自动启用密码认证，密码在控制台输出中可见。 确认服务监听状态 可以通过以下命令检查服务是否正确监听： 若显示 — 只接受本机连接 若显示 或 — 接受所有网络连接 从 Claude Code 迁移 迁移内容 目录/文件 说明 自定义 agents 配置 斜杠命令定义 专业技能定义 → AI 指令和记忆文档 方案一：符号链接（推荐） 共享配置，修改一处两边生效。 方案二：复制文件 独立配置，互不影响。 插件 Skills 一键安装 Claude Code 插件中的 Skills 支持一键安装，安装后自动加载。 验证迁移 成本优化 核心原则 新任务用 开启新会话 长对话用 压缩历史 用 引用文件，避免粘贴代码 会话管理命令 命令 功能 查看 Token 消耗 开启新会话 压缩历史 恢复旧对话 成本对比 方式 输入 Token 相对成本 单会话连续 10 个任务 50,000 高 每个任务新会话 15,000 低 定期 25,000 中 推荐做法 ✓ 新任务开新会话 ✓ 每 20 30 轮用 ✓ 用 引用文件 ✓ 精简提问 避免做法 ✗ 同一会话处理多个无关任务 ✗ 对话超过 30 轮不清理 ✗ 重复粘贴已知代码 更多帮助："},{"id":"/cli/best-practices","title":"CodeBuddy Code 最佳实践","body":"CodeBuddy Code 最佳实践 从环境配置到并行扩展，掌握让 CodeBuddy Code 发挥最大效能的技巧与模式。 CodeBuddy Code 是一个智能编程环境。与传统的问答式助手不同，CodeBuddy Code 能够读取文件、执行命令、修改代码，无论您是在旁观察、适时引导，还是离开去做其他事，它都能自主解决问题。 这将改变您的工作方式——您不再需要自己编写代码然后请求审查，而是描述目标，让 CodeBuddy Code 去探索、规划并实现。 本指南汇集了在各类代码库、语言和环境中经过验证的实践模式。 给 CodeBuddy Code 验证自己工作的方法 核心建议：提供测试用例、截图或预期输出，让 CodeBuddy Code 能够自我检验。这是提升效果最立竿见影的方法。 当 CodeBuddy Code 能够验证自己的工作时，表现会显著提升——无论是运行测试、对比截图，还是校验输出结果。 如果没有明确的成功标准，它可能产出看似正确但实际无效的代码。这时您就成了唯一能发现问题的人，每个错误都需要您亲自排查。 策略 改进前 改进后 提供验证标准 \"写一个检查手机号格式的函数\" \"写一个 validatePhone 函数。测试用例：13812345678 返回 true，12345 返回 false，138 1234 5678 返回 false。实现后运行测试\" 视觉验证 UI 变更 \"优化一下这个表格的样式\" \"[粘贴截图] 按这个设计稿实现。完成后截图对比原图，列出差异并修复\" 解决根本原因 \"编译报错了\" \"编译失败，错误信息：[粘贴错误]。找出根本原因并修复，不要只是绕过错误。修复后确认编译通过\" 验证手段可以是测试套件、linter，或者一个检查输出的 Bash 命令。花点时间让验证足够可靠，值得。 在提示中提供具体上下文 核心建议：指令越精确，后续纠正就越少。 CodeBuddy Code 能推断意图，但不会读心。引用具体文件，说明约束条件，指向示例代码。 策略 改进前 改进后 限定任务范围 \"给 userservice.py 加测试\" \"给 userservice.py 写测试，重点覆盖用户注销的边缘情况，不要用 mock\" 指向来源 \"为什么 OrderProcessor 的接口设计这么奇怪？\" \"查一下 OrderProcessor 的 git 历史，总结这个接口是怎么演变成现在这样的\" 引用现有模式 \"加一个搜索组件\" \"看看 src/components 里现有组件是怎么写的，特别是 ProductCard.vue 这个例子。按同样的模式实现一个搜索组件，支持关键词高亮和历史记录。只用项目里已有的依赖\" 描述症状 \"登录有 bug\" \"用户反馈 token 过期后重新登录会失败。查一下 src/auth/ 的认证流程，重点看 token 刷新逻辑。先写个能复现问题的测试，再修复\" 模糊提示在探索阶段也有用，允许反复尝试。像 这样的提示，往往能发现一些你没想到的问题。 提供丰富内容 核心建议：用 引用文件，粘贴截图，或通过管道输入数据。 您可以通过多种方式向 CodeBuddy Code 提供丰富的上下文： 用 引用文件：CodeBuddy Code 在回复前会先读取文件，不用您描述代码在哪 直接粘贴图片：复制/粘贴或拖放图片到输入框 提供 URL：文档和 API 参考的链接。用 可以允许常用域名 管道输入数据：运行 直接把文件内容喂给它 让 CodeBuddy Code 自己取：告诉它用 Bash 命令、MCP 工具或读文件来获取所需上下文 配置您的环境 一些简单的配置步骤，就能让 CodeBuddy Code 在所有会话中更加高效。 设置首选语言 如果您希望 CodeBuddy Code 始终使用特定语言回复（如简体中文），可以通过 命令设置 Language 选项： 或者直接在 中配置： 设置后，CodeBuddy Code 会使用指定语言进行所有回复和解释，技术术语和代码标识符保持原样。留空则自动根据您的输入语言判断。 编写有效的 CODEBUDDY.md 核心建议：运行 基于当前项目结构生成初始 CODEBUDDY.md，然后逐步完善。 CODEBUDDY.md 是 CodeBuddy Code 每次对话开始时都会读取的特殊文件，里面包含常用命令、代码风格和工作流规则。它为 CodeBuddy Code 提供了无法从代码本身推断出的持久上下文。 命令会分析您的代码库，检测构建系统、测试框架和代码模式，为您生成一个可以继续完善的基础版本。 CODEBUDDY.md 没有固定格式，保持简短、易读就好。例如： CODEBUDDY.md 每次会话都会加载，所以只放那些普遍适用的内容。对于只在"},{"id":"/cli/settings","title":"设置配置","body":"设置配置 CodeBuddy Code 使用分层配置系统，让您能够在不同级别进行个性化定制，从个人偏好到团队标准，再到项目特定需求。 配置文件 文件是配置 CodeBuddy Code 的官方机制，支持分层设置： 用户设置 定义在 ，应用于所有项目 项目设置 保存在项目目录中： 用于检入源代码控制并与团队共享的设置 用于不检入的设置，适合个人偏好和实验。CodeBuddy Code 会自动配置 git 忽略此文件 完整配置示例 可用设置 支持以下选项： 配置键 描述 示例 : : : 首选响应语言，设置后 CodeBuddy Code 将使用指定语言进行回复。留空则自动根据用户输入判断语言 自定义脚本，在 中执行，生成认证值。此值将作为模型请求的 和 头发送 文生图功能使用的模型 ID 图生图功能使用的模型 ID 根据最后活动日期本地保留聊天记录的时长(默认:30 天) 应用于每个会话的环境变量 是否在 git 提交和拉取请求中包含 署名(默认: ） 权限配置，见下表 配置在工具执行前后运行的自定义命令。见 禁用所有 覆盖 CodeBuddy Code 使用的默认模型 覆盖主线程使用的 agent 名称（内置或自定义 agent），应用该 agent 的 system prompt、工具限制和模型配置。优先级： → → → 配置自定义状态行以显示上下文。见 启用 Prompt 建议功能，在 Agent 完成对话后自动预测下一步操作（默认： ） Reasoning effort 级别配置，控制模型推理的深度。可选值： 、 、 、 。留空时使用产品配置默认值。可通过 面板切换，选择 等效于清除此设置 [Experimental] 记忆功能配置，见 权限设置 配置键 描述 示例 : : : 数组,允许工具使用。注意: Bash 规则使用前缀匹配,不是正则表达式 数组,在工具使用时询问确认 数组,拒绝工具使用。用于排除 CodeBuddy Code 访问敏感文件。注意: Bash 模式是前缀匹配,可以被绕过(参见 ) CodeBuddy 可以访问的额外 打开 CodeBuddy Code 时的默认 设置为 以防止激活 模式。这会禁用 和 命令行标志 记忆功能配置 记忆功能允许 CodeBuddy Code 在会话之间保持持久化记忆，自动管理项目上下文和学习历史。 配置键 描述 示例 : : : 是否启用 Auto Memory 功能（默认： ）。Auto Memory 允许 CodeBuddy 自动管理跨会话的持久化记忆，存储在 目录 是否启用 Typed Memory 模式（默认： ）。启用后使用 4 种记忆类型（user/feedback/project/reference）+ YAML frontmatter 格式管理记忆 是否启用记忆相关性选择（默认： ）。启用后根据用户查询自动选择最多 5 个相关记忆注入上下文 是否启用后台记忆提取（默认： ）。启用后在对话结束时自动从对话中提取值得记住的信息 是否启用团队记忆模式（默认： ）。启用后，项目记忆存储在项目目录下，便于团队共享 团队用户 ID，用于隔离不同用户的记忆。默认自动获取（git user.name 系统用户名） 配置示例： 记忆存储位置： 个人模式（默认）： 团队模式： 全局记忆： 也可以通过 命令在设置面板中启用此功能。 Bash沙箱设置 配置高级沙箱行为。沙箱将 bash 命令与您的文件系统和网络隔离。详见 。 文件系统和网络限制通过 Read、Edit 和 WebFetch 权限规则配置，而非通过这些沙箱设置。 配置键 描述 示例 : : : 启用 bash 沙箱(仅限 macOS/Linux)。默认:false 在沙箱环境中自动批准 bash 命令。默认:true 应在沙箱外运行的命令 允许通过 参数在沙箱外运行命令。设置为 时，完全禁用 沙箱中可访问的 Unix 套接字路径（用于 SSH 代理等） 允许绑定到 localhost 端口(仅限 macOS)。默认: false 如果您希望使用自己的代理,使用的 HTTP 代理端口。如果未指定,CodeBuddy 将运行自己的代理 如果您希望使用自己的代理,使用的 SOCKS5 代理端口。如果未指定,CodeBuddy 将运行自己的代理 为无特权的 Docker 环境启用较弱的沙箱(仅限 Linux)。降低安全性。 默认:false 配置示例： 文件系统访问通过 Read/Edit 权限控制： Read deny 规则阻止沙箱中的文件读取 Edit allow 规则允许文件写入（除默认值外，如当前工作目录） Edit deny 规则阻止允许路径内的写入 注意：沙箱默认将 CodeBuddy 配置文件（ 、 ）加入"},{"id":"/cli/models","title":"models.json 配置指南","body":"models.json 配置指南 概述 是一个配置文件，用于自定义模型列表和控制模型下拉列表的显示。该配置支持两个级别： 用户级: 全局配置，适用于所有项目 项目级: 项目特定配置，优先级高于用户级 配置文件位置 用户级配置 项目级配置 配置优先级 配置合并优先级从高到低： 1. 项目级 models.json 2. 用户级 models.json 3. 内置默认配置 项目级配置会覆盖用户级配置中的相同模型定义（基于 字段匹配）。 字段：项目级完全覆盖用户级，不进行合并。 配置结构 配置字段说明 models 类型： 定义自定义模型列表。可以添加新模型或覆盖内置模型配置。 LanguageModel 字段 字段 类型 必填 说明 string ✓ 模型唯一标识符 string 模型显示名称 string 模型供应商 （如 OpenAI, Google) string API 密钥，支持环境变量引用（见下方安全配置说明） number 最大输入 token 数 number 最大输出 token 数 string API 端点 URL，支持环境变量引用 (必须是接口完整路径,一般以 结尾） number 采样温度，范围 0 2，值越高输出越随机，值越低输出越确定 boolean 是否支持工具调用 boolean 是否支持图片输入 boolean 是否支持推理模式 重要说明： 目前仅支持 OpenAI 接口格式的 API 字段必须是接口完整路径,一般以 结尾 例如: 或 安全配置：使用环境变量引用 为避免 API 密钥明文存储在配置文件中， 和 字段支持环境变量引用语法 。 语法格式： 配置示例： 设置环境变量： 使用系统 Keychain（macOS）： 注意事项： 环境变量在 CLI 启动时解析 如果环境变量不存在，将保留原始占位符（会导致 API 调用失败） 建议将 文件权限设置为 （仅所有者可读写） 不要将包含实际密钥的配置文件提交到版本控制系统 availableModels 类型： 控制模型下拉列表中显示哪些模型。只有在此数组中列出的模型 ID 才会在 UI 中显示。 如果未配置或为空数组，则显示所有模型 配置后，只显示列出的模型 ID 可以同时包含内置模型和自定义模型的 ID 使用场景 1. 添加自定义模型 在用户级或项目级添加新的模型配置： 2. 覆盖内置模型配置 修改内置模型的默认参数： 3. 限制可用模型列表 只在下拉列表中显示特定模型： 4. 项目特定配置 为特定项目使用不同的模型或 API 端点： 项目 A ( ): 热重载 配置文件支持热重载： 文件变更会被自动检测 使用 1 秒防抖延迟避免频繁重载 配置更新后会自动同步到应用 监听的文件： （用户级） （项目级） 标签系统 通过 添加的模型会自动标记 标签，便于在 UI 中识别和过滤。 合并策略 配置使用 策略： 相同 ID 的模型配置会被覆盖 不同 ID 的模型会被追加 项目级配置优先于用户级配置 过滤在所有合并完成后执行 示例配置 API 端点 URL 格式说明 必须使用完整路径： 所有自定义模型的 字段一般以 结尾。 ✅ 正确示例： ❌ 错误示例： OpenRouter 平台配置示例 使用 OpenRouter 访问多种模型： DeepSeek 平台配置示例 使用 DeepSeek 模型： 完整示例 故障排查 配置未生效 1. 检查 JSON 格式是否正确 2. 确认文件路径是否正确 3. 查看日志输出确认配置是否被加载 4. 确认环境变量中的 API 密钥是否已设置 模型未在列表中显示 1. 检查模型 ID 是否在 中列出 2. 确认 配置是否正确 3. 验证必填字段 （ , , ) 是否都已提供 热重载未触发 配置文件变更有 1 秒防抖延迟 确保文件确实被保存到磁盘 检查文件监听是否正常启动 （查看调试日志）"},{"id":"/cli/memory","title":"管理 CodeBuddy 的记忆","body":"管理 CodeBuddy 的记忆 了解如何通过不同的记忆位置和最佳实践来管理 CodeBuddy Code 跨会话的记忆。 CodeBuddy Code 可以跨会话记住您的偏好，例如代码风格指南和工作流程中的常用命令。 确定记忆类型 CodeBuddy Code 提供四种分层结构的记忆位置，每种都有不同的用途： 记忆类型 位置 用途 使用场景示例 共享范围 用户记忆 适用于所有项目的个人偏好 代码风格偏好、个人工具快捷方式 仅限本人（所有项目） 用户规则 模块化的个人规则 个人编码习惯、常用工作流 仅限本人（所有项目） 项目记忆 或 项目的团队共享指令 项目架构、编码标准、常用工作流程 通过源代码管理与团队成员共享 项目规则 模块化的、按主题划分的项目指令 语言特定指南、测试规范、API 标准 通过源代码管理与团队成员共享 项目记忆（本地） 个人的项目特定偏好 您的沙箱 URL、首选测试数据 仅限本人（当前项目） 所有记忆文件在启动 CodeBuddy Code 时自动加载到上下文中。加载顺序如下： 1. 用户级：加载 等主文件及 下的所有规则 2. 项目级主文件：从当前工作目录向上递归加载所有 和 3. 项目级规则：仅加载当前工作目录的 下的规则（不加载父目录的规则） 4. 子目录记忆：当 CodeBuddy 操作子目录中的文件时，动态加载该子目录的 5. 本地记忆：加载 提示：CODEBUDDY.local.md 文件会自动添加到 .gitignore，非常适合存储不应提交到版本控制的私有项目特定偏好。 CODEBUDDY.md 导入 CODEBUDDY.md 文件可以使用 语法导入其他文件。以下示例导入了 3 个文件： 支持相对路径和绝对路径。特别是，导入用户主目录中的文件是一种方便的方式，让团队成员可以提供不会提交到仓库的个人指令。导入是 CODEBUDDY.local.md 的替代方案，在多个 git worktree 之间工作得更好。 为避免潜在冲突，代码块和代码范围内的导入不会被解析。 导入的文件可以递归导入其他文件，最大深度为 5 层。您可以通过运行 命令查看已加载的记忆文件。 CodeBuddy 如何查找记忆 CodeBuddy Code 递归读取记忆：从当前工作目录开始，CodeBuddy Code 向上递归到根目录（但不包括根目录 ），并读取找到的任何 CODEBUDDY.md 或 CODEBUDDY.local.md 文件。这在大型仓库中特别方便，当您在 目录中运行 CodeBuddy Code，并且在 和 两处都有记忆时。 CodeBuddy 还会发现当前工作目录下子树中嵌套的 CODEBUDDY.md。这些文件不会在启动时加载，只有当 CodeBuddy 读取这些子树中的文件时才会包含。 使用 管理记忆 在会话中使用 斜杠命令，打开记忆管理面板。在该面板中你可以： 打开 Auto Memory 目录 打开 索引文件 切换 Auto Memory 开关 设置项目记忆 假设您想设置一个 CODEBUDDY.md 文件来存储重要的项目信息、约定和常用命令。项目记忆可以存储在 或 中。 使用以下命令为您的代码库引导一个 CODEBUDDY.md： 提示： 包含常用命令（构建、测试、lint）以避免重复搜索 记录代码风格偏好和命名约定 添加项目特定的重要架构模式 CODEBUDDY.md 记忆既可用于与团队共享的指令，也可用于个人偏好 使用 实现模块化规则 对于较大的项目，您可以使用 目录将指令组织到多个文件中。这允许团队维护专注的、组织良好的规则文件，而不是一个庞大的 CODEBUDDY.md。 基本结构 将 markdown 文件放在项目的 目录中： 中的所有 文件都会自动作为项目记忆加载，优先级与 相同。 注意：项目级规则仅从当前工作目录（workDir）的 加载，不会加载父目录的规则文件夹。这确保规则的作用域清晰明确。 规则控制字段 规则文件支持以下 YAML frontmatter 字段来控制加载和应用行为： 字段 类型 默认值 说明 boolean 是否加载此规则。设为 时规则完全不加载 boolean 是否始终应用此规则 string/string[] 触发规则的文件路径 glob 模式 规则类型判定 规则类型由 和 共同决定： alwaysApply paths 规则类型 行为 （默认） 任意 ALWAYS 始终注入到上下文 有值 MANUAL（条件触发） 仅在操作匹配文件时触发 无 不支持 规则不会加载 示例 始终应用的规则（默认行为）： 条件触发规则： 禁用规则（临时关闭）： 注意： 字段不仅限于 目录，在所有记忆文件（包括 CODEBUDDY.md、CODEBUDDY.local.md）"},{"id":"/cli/statusline","title":"状态行配置","body":"状态行配置 为 CodeBuddy Code 创建自定义状态行以显示上下文信息 通过自定义状态行让 CodeBuddy Code 更具个性化，状态行显示在 CodeBuddy Code 界面的底部，类似于 Oh my zsh 等 shell 中的终端提示符(PS1)的工作方式。 创建自定义状态行 您可以选择以下方式之一： 运行 让 CodeBuddy Code 帮助您设置自定义状态行。默认情况下,它会尝试复制您终端的提示符,但您可以向 CodeBuddy Code 提供有关所需行为的额外说明,例如 直接在您的 中添加 命令： 工作原理 状态行在对话消息更新时更新 更新最多每 300ms 运行一次 命令输出的第一行 stdout 成为状态行文本 支持 ANSI 颜色代码来设置状态行样式 CodeBuddy Code 通过 stdin 以 JSON 格式向您的脚本传递有关当前会话的上下文信息（模型、目录等） JSON 输入结构 您的状态行命令通过 stdin 接收 JSON 格式的结构化数据： 示例脚本 简单状态行 Git 感知状态行 带颜色的中文状态行 显示成本和统计信息 Python 示例 Node.js 示例 助手函数方法 对于更复杂的 bash 脚本，您可以创建助手函数： 完整的中文示例 高级示例 显示当前时间和会话时长 根据成本显示不同颜色 提示 保持状态行简洁 它应该适合一行 使用 emoji（如果您的终端支持）和颜色使信息易于浏览 在 Bash 中使用 进行 JSON 解析（参见上面的示例） 通过使用模拟 JSON 输入手动运行脚本来测试您的脚本： 如果需要，考虑缓存昂贵的操作（如 git status) 确保脚本输出是有效的 UTF 8,以正确显示中文和 emoji 常用 ANSI 颜色代码 故障排查 状态行不显示 检查脚本是否可执行： 确保脚本输出到 stdout（不是 stderr) 验证 JSON 路径正确： 中文或 emoji 显示乱码 确保终端支持 UTF 8 编码 检查脚本文件保存为 UTF 8 格式 在脚本开头添加： 颜色不显示 检查终端是否支持 ANSI 颜色 确保使用 来解释转义序列 验证颜色代码是否正确 Git 信息不显示 确保在 git 仓库中运行 检查 git 命令是否在 PATH 中 验证有权限读取 目录 脚本执行缓慢 缓存昂贵的操作（如 git status) 避免在状态行脚本中进行网络请求 使用后台进程更新缓存的信息 配置示例 用户级配置 在 中： 项目级配置 在 中： 这允许不同项目使用不同的状态行样式。 实用工具推荐 jq: JSON 解析工具，必备 bc：用于浮点数计算（成本比较） git：显示分支和状态信息 date：显示时间信息 安装： 相关资源 了解完整的配置选项 了解更多自定义功能 使用 快速配置 通过自定义状态行，让 CodeBuddy Code 更符合您的工作风格"},{"id":"/cli/terminal-config","title":"优化终端配置","body":"优化终端配置 CodeBuddy Code 在合适的终端配置下能发挥最佳性能。按照以下指南优化您的使用体验。 🎨 主题和外观 CodeBuddy Code 无法控制您终端的主题，这由您的终端应用程序处理。您可以随时通过 命令将 CodeBuddy Code 的主题与终端主题匹配。 如需进一步自定义 CodeBuddy Code 界面本身，您可以配置 在终端底部显示上下文信息，如当前模型、工作目录或 git 分支等。 ⌨️ 换行输入 在 CodeBuddy Code 中输入换行符有以下几种方式： Ctrl+J:跨平台快捷键，在多行输入时按 Ctrl+J 即可插入换行 快速转义:输入 后按 Enter 即可创建换行 Shift+Enter:通过 命令自动配置（推荐） 配置 Shift+Enter（推荐）: 在 CodeBuddy Code 中运行 命令，自动配置 Shift+Enter 快捷键。 支持的终端： macOS: iTerm2, Terminal.app IDE: VSCode, Cursor, Windsurf, Zed, CodeBuddy JetBrains: PyCharm, IntelliJ IDEA, WebStorm, PhpStorm, GoLand, Rider, CLion, RubyMine, AppCode, DataGrip 终端模拟器: Ghostty, WezTerm, Kitty, Alacritty, Hyper, Tabby, Warp Windows: Windows Terminal 配置 Option+Enter(VS Code、iTerm2 或 macOS Terminal.app): 对于 Mac Terminal.app: 1. 打开 设置 → 描述文件 → 键盘 2. 勾选\"将 Option 用作 Meta 键\" 对于 iTerm2 和 VS Code 终端： 1. 打开 Settings → Profiles → Keys 2. 在\"General\"下，将 Left/Right Option 键设置为\"Esc+\" 🔔 通知设置 通过合适的通知配置，让您在 CodeBuddy 完成任务时不会错过： iTerm 2 系统通知 为 iTerm 2 配置任务完成时的提醒： 1. 打开 iTerm 2 偏好设置 2. 导航到 Profiles → Terminal 3. 启用\"Silence bell\"和 Filter Alerts → “Send escape sequence generated alerts” 4. 设置您偏好的通知延迟 注意：这些通知功能仅适用于 iTerm 2,在 macOS 默认终端中不可用。 自定义通知 Hook 如需高级通知处理，您可以创建 来运行自己的逻辑。 📝 处理大量输入 在处理大量代码或长指令时： 避免直接粘贴:CodeBuddy Code 可能无法很好地处理非常长的粘贴内容 使用基于文件的工作流:将内容写入文件并要求 CodeBuddy 读取它 注意 VS Code 的限制:VS Code 终端特别容易截断长粘贴内容 ⌨️ Vim 模式 CodeBuddy Code 支持部分 Vim 快捷键，可以通过 命令启用,或通过 配置。 支持的功能子集包括： 模式切换： （切换到 NORMAL 模式）、 / 、 / 、 / （切换到 INSERT 模式） 导航： / / / 、 / / 、 / / 、 / 编辑： 、 / / / / 、 / / / / 、 （重复）"},{"id":"/cli/env-vars","title":"环境变量参考","body":"环境变量参考 CodeBuddy Code 支持通过环境变量来控制其行为。这些变量可以在启动前设置，也可以在 的 字段中配置以应用到每个会话。 提示：所有环境变量也可以在 的 字段中设置，这样可以自动为每个会话应用，或为整个团队推出配置。 认证相关 环境变量 说明 API 密钥。设置此密钥用于模型接口调用。在非交互模式 ( ) 下始终使用此密钥 CodeBuddy 平台认证令牌，用于所有平台接口调用 自定义 HTTP 请求头。格式： ，多个请求头用换行符或 分隔 API 端点和代理 环境变量 说明 覆盖 API 端点地址，通常与 配合使用 网络环境配置（ 用于中国版， 用于 iOA 企业版） / HTTP 代理服务器地址 / HTTPS 代理服务器地址 / 绕过代理的域和 IP 列表（逗号分隔，如 ） 模型配置 环境变量 说明 覆盖默认代理模型 后台任务使用的小型快速模型 复杂推理任务使用的大型模型 子代理使用的模型 启用扩展思考并设置思考过程的 token 预算。默认禁用 Bash 工具配置 环境变量 说明 长时间运行 bash 命令的默认超时（默认：120000） bash 输出在内存中保留的最大字符数（默认：30000，上限：150000）。超出部分会被中间截断（保留 head 20% + tail 80%），完整输出会自动保存到磁盘 模型可为长时间运行的 bash 命令设置的最大超时（默认：600000） 工具输出外部化 环境变量 说明 工具结果外部化的大小阈值（KB），超过此阈值的非 bash 工具结果会被保存到磁盘并替换为占位符（默认：50） 说明：Bash 工具的输出外部化由 控制，当输出超过该值发生截断时，完整输出自动流式写入磁盘。 主要影响其他工具（如 MCP 工具）的大输出处理。详见 章节。 工具和功能开关 环境变量 说明 设置为 禁用热更新系统 设置为 跳过内置插件市场加载 设置为 或 启用第三方插件市场自动更新（默认：禁用） 冒号分隔的本地插件目录路径列表（等同于 ），插件的 目录会自动注入到 设置为 或 禁用图片生成功能 设置为 或 禁用图片编辑功能 设置为 或 禁用 MCP 工具延迟加载 设置为 或 显示所有延迟工具的完整描述 设置为 禁用计划任务 设置为 在 模式流式输出中将图片 blob 引用还原为完整 base64 数据。适用于需要直接获取图片数据的下游集成场景 上下文和内存 环境变量 说明 设置自动压缩触发的上下文容量百分比（1 100）。默认由产品配置决定（通常 70 92%）。使用更低的值（如 ）来更早压缩 设置为 禁用自动内存，设置为 启用 设置为 或 启用记忆功能 设置为 或 启用分类记忆模式 设置为 或 启用团队记忆模式 团队记忆模式下的用户 ID MCP (Model Context Protocol) 环境变量 说明 MCP 服务器连接的超时时间（毫秒） MCP 工具执行的超时时间（毫秒） MCP 工具响应中允许的最大 token 数（默认：20000） 性能和输出 环境变量 说明 设置大多数请求的最大输出 token 数 覆盖文件读取的默认 token 限制（默认：20000） 流式响应中两个数据块之间允许的最大静默时间（毫秒）（默认：120000） 等待第一个模型输出的最大时间（毫秒）（默认：120000） 文件系统和配置 环境变量 说明 自定义 CodeBuddy Code 存储配置和数据文件的位置 调试日志目录 容器沙箱镜像（默认： ） 设置为 使用系统安装的 而不是 CodeBuddy Code 附带的 Shell 配置 环境变量 说明 覆盖自动 shell 检测。支持的值： 、 、 、 包装所有 shell 命令的命令前缀（如用于日志或审计） Windows 下显式指定 Git Bash 路径 显式指定 PowerShell 可执行文件路径（优先于自动检测） 控制 PowerShell 工具启用状态。Windows 上默认启用，设为 可禁用 在执行每个 shell 命令前自动 source 的环境文件路径 UI 和交互 环境变量 说明 设置为 禁用自动终端标题更新 设置为 禁用提示建议 设置为 启用演示模式：隐藏邮箱和组织 安全和认证 环境变量 说明 mTLS 客户端证书文件路径 ⚠️ 暂未支持 mTLS 客户端私钥文件路径 ⚠️ 暂未支持 mTLS 加密私钥的密码（可选）⚠️ 暂未支持 遥测和报告 环境变量 说明 设置为 禁用遥测 设置为 禁用错误报告 设置为 禁用自动更新 设置为 禁用 命令 任务和后台工作 环境变量 说明 设置为 禁用所有后台任务功能 Agent 执行控制 环境变量 说明 主 Agent 的最大执行轮次。优先级：CLI 此环境变量 默认值 (5"},{"id":"/cli/ide-integrations","title":"IDE 集成","body":"IDE 集成 CodeBuddy Code 支持两种与编辑器集成的方式，属于同一层级的 IDE 集成能力： 1. 通过 ACP (Agent Client Protocol) 协议作为通用「智能体服务端」被 IDE 调用 2. 通过 启动参数和 斜杠命令，作为「IDE 插件的后端伴生进程」进行深度集成 集成方式一：ACP 协议集成 适用于 Zed 等支持 ACP 的编辑器，将 CodeBuddy Code 作为通用 Agent Server 使用。 支持的编辑器 Zed 编辑器 通过 ACP 协议完整集成，支持： 项目上下文感知 工具操作代理（文件读写、终端命令） 权限请求交互 实时流式响应 配置详见： 集成方式二：IDE 插件集成 （ / ) 适用于 VS Code / Cursor / Windsurf / JetBrains 系列 IDE，通过插件 + 本地 MCP 服务器的方式集成。IDE 侧插件负责： 创建并维护 MCP 连接 （SSE / WebSocket) 将工作区信息、选区等上下文通过 MCP 协议传给 CodeBuddy 暴露 / / / 等 IDE 能力给 CodeBuddy 调用 启动参数 当您在终端中直接启动 CodeBuddy 时，可以通过 参数让 CLI 主动尝试连接当前工作目录对应的 IDE： 行为说明： CodeBuddy 会在当前用户目录下扫描由 IDE 插件创建的锁文件，检测可用的 IDE 实例 仅当 IDE 的工作区包含当前目录时才认为是「有效 IDE」 优先连接「工作区匹配且进程链路为当前终端上游」的 IDE 连接成功后，CLI 会通过 IDE MCP 服务器获得： 文件/差异预览 （openFile / openDiff) 诊断信息 （getDiagnostics) 选区变化通知 （selectionchanged) 只是在「您从 IDE 终端手动启动 CLI」时的一种快捷连接方式，不负责真正启动 IDE 或插件。 斜杠命令 当您在 CodeBuddy 的交互式界面中使用 IDE 插件集成时，可以通过 命令查看和管理当前 IDE 连接状态： 典型用途包括： 查看当前是否已连接 IDE、连接的是哪一个 IDE 在存在多个可用 IDE 时，选择要连接的实例 手动断开或重新建立与 IDE 的 MCP 连接 具体交互行为由 IDE 集成 UI 决定，但整体定位是「管理 IDE 集成状态」而不是直接发起聊天。 选择哪种集成方式？ 如果您的编辑器原生支持 ACP（例如 Zed），推荐使用 ACP 协议集成： 使用 启动 由编辑器负责会话 UI 和工具代理 如果您使用 VS Code / Cursor / JetBrains 等，通过插件市场安装 CodeBuddy 插件，则推荐使用 / 插件集成： 插件负责启动 CodeBuddy 进程并建立 MCP 连接 CLI 侧通过 / 与 IDE 建立和管理连接 两种方式在「集成层级」上是等价的，都是让 CodeBuddy 作为外部 Agent 与 IDE 深度协作，只是接入协议和 UI 承载方不同。 未来计划 后续版本将提供更多增强功能： 更友好的 DIFF 展示与修改确认流程 （结合 IDE diff 预览） 在 IDE 插件中提供更丰富的上下文选择与可视化 更多编辑器和 IDE 的官方集成 相关文档 详细的 ACP 配置指南 命令行参数说明 包含 等会话命令总览"},{"id":"/cli/acp","title":"ACP 协议集成","body":"ACP 协议集成 ACP (Agent Client Protocol) 是 Zed 编辑器推出的一种通用智能体协议，使智能体的核心功能（服务端）和用户界面（客户端）解耦，允许用户自由选择不同的智能体服务端和客户端进行搭配使用。 CodeBuddy Code 原生支持 ACP 协议，可以作为智能体服务端与支持 ACP 的编辑器无缝集成。 快速开始 启动 ACP 模式 使用 参数启动 CodeBuddy Code 的 ACP 服务器： Zed 编辑器集成 配置步骤 打开 Zed 配置文件（ ），添加以下配置： 随后即可在 Zed 侧边栏创建 CodeBuddy Code Thread，开始使用。 配置说明 command：指定 CodeBuddy Code 的命令路径（确保 在 PATH 中可用） args：使用 启用 ACP 协议模式 env：可选的环境变量配置，例如： 注意：使用 时，必须根据版本正确配置 ： 海外版：不设置（默认） 中国版： iOA 版： 详见 。 ACP 协议特性 认证信息扩展 CodeBuddy Code 在 响应的 字段中返回用户信息： 客户端可以利用这些信息提供更好的用户体验，例如显示当前登录用户、个性化界面等。 工具代理机制 ACP 协议支持客户端代理部分工具操作，提升性能和安全性： 文件操作代理：基于客户端的 和 能力 终端操作代理：基于客户端的 能力 当客户端声明支持这些能力时，CodeBuddy Code 会自动将相关工具调用代理给客户端执行。 命令列表推送 CodeBuddy Code 会在创建新会话时自动向客户端推送可用的 Slash 命令列表（ ），让客户端能够： 提供命令自动补全功能 显示命令提示和帮助信息 动态更新可用命令 命令列表会自动过滤掉本地命令（如 、 ）和客户端专属命令（如 、 ），只推送适用于 ACP 模式的命令。 Agent Teams 协议扩展 CodeBuddy Code 通过 的 字段扩展 ACP 协议，支持 Agent Teams 多智能体协作的实时状态推送。 Team 状态事件 通过 推送以下事件类型： 成员状态变化 ( )： Team 创建 ( ) / 删除 ( )： 成员流式消息 成员的实时消息（文本、工具调用）通过标准 ACP 事件推送，附加 标记来标识消息来源： 客户端收到带 标记的事件后，应将其路由到对应成员的对话时间线，而非主对话区。 页面刷新恢复 页面刷新后， 的 完成后会自动推送当前 Team 状态（ 事件），客户端无需单独请求。 在订阅成员 session 时会自动重放其完整历史，因此成员的对话数据也通过 ACP SSE 完整恢复，无需额外 HTTP API。 其他编辑器支持 ACP 是开放协议，理论上任何支持 ACP 的编辑器都可以集成 CodeBuddy Code。配置方式与 Zed 类似： 故障排除 连接失败 问题: Zed 无法连接到 CodeBuddy 解决方法: 1. 确认 命令可用： 2. 测试 ACP 模式启动： 3. 检查配置文件 JSON 格式是否正确 工具调用失败 问题：文件操作或命令执行报错 解决方法: 1. 检查工作目录权限 2. 查看 CodeBuddy 日志 相关链接 查看所有命令行参数 更多编辑器集成方式 协议详细文档 通过 ACP 协议，让 CodeBuddy Code 融入您喜爱的编辑器 🚀"},{"id":"/cli/gitlab-ci-cd","title":"CodeBuddy Code GitLab CI/CD 集成","body":"CodeBuddy Code GitLab CI/CD 集成 概述 CodeBuddy Code 支持与 GitLab CI/CD 深度集成，让您能够在 CI/CD 流水线中使用 AI 辅助完成代码审查、自动化实现和智能优化等任务。该集成基于 CodeBuddy Code CLI 构建，可在 GitLab CI 作业中以编程方式使用 AI 能力。 工作原理 CodeBuddy Code 利用 GitLab CI/CD 在隔离的作业中运行 AI 任务，并通过 MR 提交结果： 1. 事件驱动编排: GitLab 监听您选择的触发器（例如 Issue、MR 或评论中提及 @codebuddy)。作业收集上下文和代码库信息，构建提示并运行 CodeBuddy Code。 2. 沙箱执行：每次交互都在具有严格网络和文件系统规则的容器中运行。CodeBuddy Code 强制执行工作区范围的权限约束写入。每个变更都通过 MR 流转，审查者可以看到差异，审批流程仍然适用。 配置指南 快速配置 最快的入门方式是在 .gitlab ci.yml 中添加一个最小化的作业，并将 API 密钥设置为受保护的变量。 步骤 1：添加受保护的 CI/CD 变量 进入 GitLab 项目的 设置 → CI/CD → 变量，添加以下环境变量： 认证配置： 在 GitLab 项目的 设置 → CI/CD → 变量 中添加以下环境变量： CODEBUDDYAPIKEY （必需） 用于模型接口调用的 API 密钥 配置时勾选： ✅ 受保护 （Protect variable)、✅ 已屏蔽 （Mask variable) 可选配置： CODEBUDDYINTERNETENVIRONMENT 网络环境配置（中国版用户需要设置为 ,iOA 用户设置为 ) CODEBUDDYBASEURL 自定义模型服务的基础 URL（需兼容 OpenAI 接口协议） GITLABACCESSTOKEN GitLab 项目访问令牌（需具有 api 范围） 用于 CodeBuddy 创建/更新 MR 和评论 如不配置，默认使用 配置时勾选： ✅ 受保护、✅ 已屏蔽 📖 完整配置指南：根据您的账号类型，查看对应的配置方法和 API KEY 获取地址： iOA 账号用户（公司内部）：参考 中国版用户：参考 海外版用户：参考 每个章节包含完整的环境变量配置方法和 API KEY 获取地址。 步骤 2：在 .gitlab ci.yml 中添加 CodeBuddy 作业 添加作业和 API 密钥变量后，通过 CI/CD → 流水线手动运行作业进行测试，或从 MR 触发它，让 CodeBuddy 在分支中提出更新并在需要时创建 MR。 手动配置（推荐用于生产环境） 如果您需要更精细的控制： 1. 添加 GitLab API 操作的项目凭据: 默认使用 CIJOBTOKEN,或创建具有 api 范围的项目访问令牌 如果使用 PAT,将其存储为 GITLABACCESSTOKEN（已屏蔽） 2. 在 .gitlab ci.yml 中添加 CodeBuddy 作业（参见上面的示例） 3. （可选）启用提及驱动的触发器: 为\"评论(notes)\"添加项目 Webhook 到您的事件监听器（如果使用） 让监听器在评论包含 @codebuddy 时调用流水线触发 API,传递 AIFLOWINPUT 和 AIFLOWCONTEXT 等变量 使用示例 将 Issue 转化为 MR 在 Issue 评论中： CodeBuddy 分析 Issue 和代码库，在分支中编写变更，并创建 MR 供审查。 获取实现帮助 在 MR 讨论中： CodeBuddy 提出变更方案，添加适当的缓存代码，并更新 MR。 快速修复 Bug 在 Issue 或 MR 评论中： CodeBuddy 定位 Bug,实现修复，并更新分支或创建新的 MR。 最佳实践 CODEBUDDY.md 配置 在仓库根目录创建 CODEBUDDY.md 文件，定义编码标准、审查标准和项目特定规则。CodeBuddy 在运行期间会读取此文件，并在提出变更时遵循您的约定。 示例 CODEBUDDY.md: 安全考虑 永远不要将敏感信息提交到仓库！ 始终使用 GitLab CI/CD 变量： 将敏感配置添加为已屏蔽的变量（如有需要，标记为受保护） 限制作业权限和网络出口 像审查其他贡献者一样审查 CodeBuddy 的 MR 性能优化 保持 CODEBUDDY.md 简洁明了 提供清晰的 Issue/MR 描述以减少迭代 配置合理的作业超时以避免失控运行 在 Runner 中缓存 npm 和包安装（如果可能） CI 成本控制 使用 CodeBuddy Code 与 "},{"id":"/cli/devcontainer","title":"CodeBuddy Code 开发容器","body":"CodeBuddy Code 开发容器 CodeBuddy Code 开发容器提供了一个预配置、安全的开发环境，适合需要一致性和隔离性工作空间的团队使用。它与 Visual Studio Code 的 Dev Containers 扩展以及类似工具无缝集成。 四步快速开始 1. 安装 VS Code 和 Remote Containers 扩展 2. 参考下方配置详解在工作区创建 目录及相关文件 3. 在 VS Code 中打开仓库 4. 当提示时，点击 \"Reopen in Container\"（或使用命令面板：Cmd+Shift+P → \"Remote Containers: Reopen in Container\"） 🚀 安装 CodeBuddy Code（推荐方案） 方案 1：使用 Dev Containers Feature（推荐） Dev Containers Feature 是在 Dev Container 中安装 CodeBuddy Code 的推荐方式。它提供自动版本管理、与其他特性配置一致、简化维护等优势。 优势： ✅ 自动版本管理 轻松升级到最新版本或固定特定版本 ✅ 配置一致性 与其他 Dev Containers 特性采用相同配置方式 ✅ 简化维护 无需在 Dockerfile 中管理复杂的安装逻辑 ✅ 团队共享 易于在团队中统一配置 配置方法： 在 中的 字段添加配置： 固定特定版本： 使用默认最新版本： 方案 2：在 Dockerfile 中手动安装 如果需要更多控制或特殊场景，可在 Dockerfile 中手动安装。详见下方 Dockerfile 部分。 1. devcontainer.json 控制容器设置、管理扩展、配置卷挂载。 包含 Dev Containers Feature 的完整示例： 关键配置说明： 声明使用 CodeBuddy Code Dev Containers Feature，支持版本管理 使用最新版本（可替换为具体版本号如 \"2.16.0\"） 注意：使用 Feature 方式时，Dockerfile 中无需 参数 2. Dockerfile 定义容器镜像、指定安装的工具。 使用 Feature 时的简化 Dockerfile 如使用上方 Dev Containers Feature 安装 CodeBuddy Code，Dockerfile 可以更简洁（无需 参数和手动安装命令）： 如果你选择使用 Dev Containers Feature 方式（推荐），可以参考下方\"简化版 Dockerfile\"。如需在 Dockerfile 中手动安装，可参考\"完整版 Dockerfile\"。 简化版 Dockerfile（推荐配合 Feature 使用）： 手动安装方式的完整 Dockerfile 如需完全控制安装过程，可在 Dockerfile 中手动安装 CodeBuddy Code（此方案不使用 Dev Containers Feature）： 注意： 若使用此方式，devcontainer.json 中的 需包含 参数,且 字段中不应包含 CodeBuddy Code Feature。 3. init firewall.sh 建立网络安全规则。 安全特性 容器实现了多层安全防护： 精确访问控制：限制出站连接到白名单域名（npm registry、GitHub、CodeBuddy API 等） 允许的出站连接：防火墙允许出站 DNS 和 SSH 连接 默认拒绝策略：阻止所有其他外部网络访问 启动验证：容器初始化时验证防火墙规则 隔离：创建与主系统分离的安全开发环境 重要安全提示 虽然开发容器提供了实质性的保护，但没有系统能够完全免疫所有攻击。当使用 （或 ) 执行时，开发容器无法阻止恶意项目窃取容器内可访问的任何内容，包括 CodeBuddy Code 凭证。我们建议仅在处理可信仓库时使用开发容器。 始终保持良好的安全实践并监控 CodeBuddy 的活动。 无人值守操作 容器增强的安全措施（隔离和防火墙规则）允许您运行 （或 ) 来绕过权限提示，实现无人值守操作。 自定义选项 开发容器配置设计灵活，可根据需求调整： 根据工作流添加或删除 VS Code 扩展 为不同硬件环境调整资源分配 调整网络访问权限 自定义 shell 配置和开发工具 使用场景 1. 安全的客户项目开发 使用开发容器隔离不同客户的项目，确保代码和凭证永不混合。 2. 团队快速入职 新团队成员可在几分钟内获得完全配置的开发环境，所有必要的工具和设置都已预装。 3. 一致的 CI/CD 环境 在 CI/CD 流水线中镜像您的开发容器配置，确保开发和生产环境匹配。 相关资源 📖 🔗"},{"id":"/cli/mcp","title":"MCP (Model Context Protocol) 使用文档","body":"MCP (Model Context Protocol) 使用文档 概述 MCP (Model Context Protocol) 是一个开放标准，允许 CodeBuddy 与外部工具和数据源进行集成。通过 MCP，您可以扩展 CodeBuddy 的功能，连接到各种外部服务、数据库、API 等。 核心概念 MCP 服务器 MCP 服务器是提供工具、资源和提示的独立进程，CodeBuddy 通过不同的传输协议与这些服务器通信。 MCP Prompts 集成 MCP 服务器可以提供 Prompts（提示模板）,这些 Prompts 会自动转换为 CodeBuddy 的斜杠命令。当 MCP 服务器连接后： 服务器提供的 Prompts 会自动注册为斜杠命令 命令名称格式为： 支持动态参数，通过交互式界面收集用户输入 命令执行时会调用 MCP 服务器的 接口获取完整内容 支持实时监听配置变更，自动更新可用命令列表 传输类型 STDIO：通过标准输入输出与本地进程通信 SSE：通过 Server Sent Events 与远程服务通信 HTTP：通过 HTTP 流式传输与远程服务通信 配置作用域 user：全局用户配置，应用于所有项目 project：项目级配置，应用于特定项目 local：本地配置，仅应用于当前会话或工作区 对于同名服务（即在多个作用域有同名配置），生效的优先级为： 安全审批机制 项目作用域的 MCP 服务器在首次连接时需要用户审批，以确保安全性。系统会显示服务器详细信息，用户可以选择批准或拒绝连接。 非交互模式（ p/ print）下的审批 在非交互模式（如使用 参数)下,由于无法通过 UI 进行审批,需要通过 参数预先配置允许的 MCP 服务器： 工具权限管理 MCP 工具支持完整的权限管理系统，可以精确控制哪些工具可以被使用： 权限规则类型 权限系统支持三种规则类型（按优先级排序）： 1. 拒绝规则 （deny) 阻止使用指定工具（最高优先级） 2. 询问规则 （ask) 使用工具前需要用户确认（覆盖允许规则） 3. 允许规则 （allow) 允许工具使用而无需手动批准 MCP 权限规则格式 重要：MCP 权限不支持通配符 （) 服务器级权限 匹配指定服务器提供的任何工具 服务器名是在 CodeBuddy 中配置的名称 工具级权限 匹配指定服务器的特定工具 配置示例 批准服务器的所有工具 仅批准特定工具 拒绝特定工具 配置文件 配置文件位置 配置文件使用优先级机制，系统会按优先级顺序查找第一个存在的文件进行读取。写入时，如果文件已存在，会写入第一个存在的文件；如果都不存在，会创建最高优先级的文件。 USER 作用域 优先级顺序（从高到低）： 1. （推荐） 2. （已废弃） 3. （旧版配置文件） 读取规则：系统会按上述顺序查找第一个存在的文件并读取其内容。 写入规则： 如果上述文件中存在任意一个，写入第一个存在的文件 如果都不存在，创建 （最高优先级） PROJECT 作用域 优先级顺序（从高到低）： 1. （推荐） 2. （已废弃） 读取规则：系统会按上述顺序查找第一个存在的文件并读取其内容。 写入规则： 如果上述文件中存在任意一个，写入第一个存在的文件 如果都不存在，创建 （最高优先级） LOCAL 作用域 local 作用域的配置实际上保存在 user 作用域的配置文件中，通过 字段来区分不同项目的 local 配置。 文件路径： 使用的是 JSON Pointer 语法，用于指向 JSON 文档中的特定位置。关于 JSON Pointer 的详细说明，请参考：https://datatracker.ietf.org/doc/html/rfc6901 注意： 系统不会合并同一个作用域的多个配置文件内容，只会使用第一个存在的文件 示例见下方配置文件格式说明。 配置文件格式 MCP 配置文件支持 JSONC (JSON with Comments) 格式，允许在配置中添加注释，提升可读性和可维护性。 JSONC 支持的特性 单行注释：使用 添加行内或行尾注释 多行注释：使用 添加块注释 尾随逗号：数组和对象的最后一个元素后可以添加逗号 基础配置格式 带注释的完整示例 注意： 标准 JSON 格式文件仍然完全兼容 解析错误时会提供清晰的错误提示 json { \"mcpServers\": { \"python tools\": { \"type\": \"stdio\", \"command\": \"${PYTHONPATH: python}\", \"args\": [ \" m\", \"mymcpserver\", \" config\", \"${CONFIGDIR: /etc/config}\" ], \"env\": { \"PYTHONPAT"},{"id":"/cli/slash-commands","title":"CodeBuddy Code 斜杠命令 （Slash Commands)","body":"CodeBuddy Code 斜杠命令 （Slash Commands) CodeBuddy Code 支持斜杠命令，允许您在聊天中执行特殊操作、管理会话以及自定义常用工作流。 内置斜杠命令 （Built in Slash Commands) 这些命令用于管理您的 CodeBuddy Code 会话。以下是当前的支持情况： 命令 参数 CodeBuddy 支持情况 描述 : : ✅ 支持 显示帮助信息，并提供反馈渠道的指引。 ✅ 支持 开启全新对话（旧对话可通过 恢复）。 ✅ 支持 登录到您的账号。 ✅ 支持 退出当前的账号。 ✅ 支持 检查 CodeBuddy Code 的状态和环境。 ✅ 支持 显示当前仓库和会话的状态。 ✅ 支持 添加工作目录。指定要添加的目录路径。 ✅ 支持 管理实验性 AI 智能体 ✅ 支持 快速提问，不中断当前 Agent 工作流。适用于在 Agent 执行任务时临时提出简短问题，答案基于已有上下文生成。 ✅ 支持 压缩上下文。 ✅ 支持 查看或修改本地配置。不带参数时打开交互式面板， 列出当前设置， 读取设置， 修改设置。 ✅ 支持 计算当前会话的上下文 token 分布情况。 ✅ 支持 显示会话的成本和 Token 使用情况。 ✅ 支持 初始化一个新的 CodeBuddy 存储库。 ✅ 支持 管理 MCP 连接。 ✅ 支持 管理长期记忆 ✅ 支持 切换或查看当前使用的 AI 模型。不带参数时打开交互式选择界面， 列出可用模型，带模型名称参数时直接切换到指定模型（如 ）。 ✅ 支持 切换或查看当前使用的文生图模型。不带参数时打开交互式选择界面， 列出可用模型，带模型 ID 参数时直接切换到指定模型。 ✅ 支持 切换或查看当前使用的图生图模型。不带参数时打开交互式选择界面， 列出可用模型，带模型 ID 参数时直接切换到指定模型。 ✅ 支持 管理工具权限和工作区目录访问权限。 ✅ 支持 预览当前计划模式下的计划文件内容。 ✅ 支持 在浏览器中打开升级页面，查看高级功能和订阅选项。 ✅ 支持 列出和管理后台任务。 ✅ 支持 配置 Shift+Enter 快捷键绑定，用于在输入框中插入换行符。 ✅ 支持 显示当前会话中的待办事项列表。 ✅ 支持 配置终端状态行显示，可以显示会话信息、模型状态等。 ✅ 支持 执行当前分支的代码安全审查，由高级安全工程师进行焦点式的安全审查以识别高置信度的安全漏洞。 ✅ 支持 打开主题选择面板，可选择和预览不同的终端主题(dark、light、colorblind friendly、ANSI 等）。 ✅ 支持 导出当前对话到文件或剪贴板。 ✅ 支持 打开反馈页面，提交 Bug 报告或功能建议。 ✅ 支持 恢复之前的会话。不带参数时打开交互式面板， 列出所有会话，带 session id 时直接切换到指定会话。 ✅ 支持 回退对话到之前的某个消息点，可选择仅回退对话、仅回退代码或同时回退两者。详见 。 ✅ 支持 管理 Bash 命令沙箱模式，控制命令执行的安全策略。详见 。 ✅ 支持 显示使用统计信息，包括 Token 使用量、模型调用次数、会话时长等详细数据，支持总览和按模型分类两个视图。 ✅ 支持 管理 IDE 集成状态。可以查看当前连接的 IDE、切换 IDE 连接或断开连接。详见 。 ✅ 支持 管理插件和插件市场。不带参数时打开交互式界面,支持 、 、 、 、 等操作。详见 。 ✅ 支持 验证插件目录结构和 manifest 有效性。不带参数时验证当前目录。详见 。 ✅ 支持 重新加载所有插件（Skills、Agents、Hooks、MCP/LSP 服务器等）,无需重启。 ✅ 支持 查看当前已加载的所有 Skills,包括用户级、项目级和插件级 Skills,并显示预估 token 数量。详见 。 ✅ 支持 生成 AI 驱动的使用洞察报告,分析您的 CodeBuddy Code 使用模式、交互风格、项目领域、摩擦点等多个维度,并生成可在浏览器中查看的 HTML 报告。 description: \"为我的项目运行单元测试并报告结果。\" argument hint: \"[test file]\" allowed tools: Bash(npm run:) model: gemini 3.1 pro description: \"代码审查\" argument hint: \"[pr number] [priority] [assignee]\" 请审查 PR #$1，优先级为 $2，并分配给 $3 进行最终确认。 重点检查以下方面： 代码风格和最佳实践 性能影响 安全问题 测试覆盖率 markdown description: \"修复代码问题\" argument hint: \"[is"},{"id":"/cli/keybindings","title":"自定义快捷键","body":"自定义快捷键 通过 keybindings 配置文件自定义 CodeBuddy Code 的键盘快捷键。 CodeBuddy Code 支持自定义键盘快捷键。运行 命令创建或打开位于 的配置文件。 上下文（Contexts） 每个绑定块指定一个 context，决定快捷键在何时生效： Context 说明 : : 在应用的任何位置生效 聊天输入框获得焦点时 文本输入框处于活跃状态时 终端视图处于活跃状态时 自动补全菜单显示时 确认/权限对话框显示时 搜索命令历史时 (Ctrl+R) 任务/代理在前台运行时 设置面板打开时 命令面板打开时 选择/列表组件获得焦点时 工具权限对话框显示时 帮助页面打开时 插件对话框打开时 Diff 对话框打开时 消息选择器 (rewind) 打开时 按键语法 修饰键 使用 分隔符组合修饰键： 或 — Control 键 、 或 — Alt/Option 键 — Shift 键 、 或 — Meta/Command 键 示例： 弦序列（Chords） 弦序列是用空格分隔的连续按键组合： 弦序列有 1000ms 超时。如果超时未完成第二步，弦序列将被取消。 特殊按键 或 — Escape 键 或 — Enter 键 — Tab 键 — 空格键 、 、 、 — 方向键 、 — 删除键 解绑默认快捷键 将动作设为 以解绑默认快捷键： 解绑弦序列的所有组合后，可以将前缀键用作单键绑定： 如果只解绑了部分弦序列，按下前缀键仍会进入弦等待模式。 保留快捷键 以下快捷键不可重新绑定： 快捷键 原因 : : Ctrl+C 硬编码的中断/取消 Ctrl+D 硬编码的退出 Ctrl+M 在终端中等同于 Enter（两者都发送 CR） 终端冲突 某些快捷键可能与终端复用器冲突： 快捷键 冲突 : : Ctrl+B tmux 前缀键（按两次发送） Ctrl+A GNU screen 前缀键 Ctrl+Z Unix 进程挂起 (SIGTSTP) Web UI 可视化配置 除了编辑 JSON 文件，你还可以在 Web UI 中通过可视化界面管理快捷键： 1. 在侧边栏点击 快捷键 导航项，或使用 URL 2. 使用搜索框按名称、按键或上下文筛选快捷键 3. 点击编辑按钮（铅笔图标）录制新的快捷键组合 4. 录制对话框会实时显示冲突检测 5. 用户自定义的绑定以左侧高亮边框标记 6. 点击重置按钮可恢复单个绑定为默认值 REST API Web UI 通过 REST API 管理快捷键： 端点 方法 说明 : : : GET 获取所有快捷键（默认 + 用户 + 合并） PUT 保存用户快捷键配置 POST 重置为默认值（删除用户配置） POST 验证配置（不保存） 验证 CodeBuddy Code 会验证你的快捷键配置并对以下情况显示警告： 解析错误（无效的 JSON 或结构） 无效的上下文名称 保留快捷键冲突 终端复用器冲突 同一上下文中的重复绑定"},{"id":"/cli/sub-agents","title":"子代理","body":"子代理 在 CodeBuddy Code 中创建和使用专门的 AI 子代理，用于特定任务工作流和改进的上下文管理。 CodeBuddy Code 中的自定义子代理是专门的 AI 助手，可以被调用来处理特定类型的任务。它们通过提供具有自定义系统提示、工具和独立上下文窗口的特定任务配置，实现更高效的问题解决。 什么是子代理？ 子代理是预配置的 AI 人格，CodeBuddy Code 可以将任务委派给它们。每个子代理： 具有特定的目的和专业领域 使用与主对话分离的自己的上下文窗口 可以配置为允许使用特定工具 包含指导其行为的自定义系统提示 当 CodeBuddy Code 遇到与子代理专业领域相匹配的任务时，它可以将该任务委派给专门的子代理，该子代理独立工作并返回结果。 主要优势 优势 说明 : : 上下文保留 每个子代理在自己的上下文中运行，防止主对话被污染，并使其专注于高级目标。 专业化知识 子代理可以使用特定领域的详细说明进行微调，从而提高指定任务的成功率。 可重用性 创建后，子代理可以在不同项目中使用，并与您的团队共享以实现一致的工作流。 灵活的权限 每个子代理可以具有不同的工具访问级别，允许您将强大的工具限制为特定的子代理类型。 快速开始 要创建您的第一个子代理： 1. 打开子代理界面 运行以下命令： 2. 选择\"创建新代理\" 选择是创建项目级别还是用户级别的子代理 3. 定义子代理 推荐：先使用 AI 生成，然后自定义以使其成为您自己的 详细描述您的子代理，包括何时应该使用它 选择您想要授予访问权限的工具，或留空以继承所有工具 界面会显示所有可用工具 如果您使用 AI 生成，也可以按 在自己的编辑器中编辑系统提示 4. 保存并使用 您的子代理现在可用。CodeBuddy Code 会在适当时自动使用它，或者您可以显式调用它： 子代理配置 文件位置 子代理存储为具有 YAML 前置内容的 Markdown 文件，位置有两个： 类型 位置 范围 优先级 : : : : 项目子代理 在当前项目中可用 最高 用户子代理 在所有项目中可用 较低 当子代理名称冲突时，项目级别的子代理优先于用户级别的子代理。 插件代理 可以提供与 CodeBuddy Code 无缝集成的自定义子代理。插件代理的工作方式与用户定义的代理相同，并在 界面中显示。 插件代理位置：插件在其 目录中包含代理（或插件清单中指定的自定义路径）。 使用插件代理： 插件代理与您的自定义代理一起显示在 中 可以显式调用：\"使用 security plugin 中的 code reviewer 代理\" 可以在适当时由 CodeBuddy Code 自动调用 可以通过 界面进行管理（查看、检查） 有关创建插件代理的详细信息，请参阅 。 基于 CLI 的配置 您也可以使用 CLI 标志动态定义子代理，该标志接受 JSON 对象： 优先级：CLI 定义的子代理的优先级低于项目级别的子代理，但高于用户级别的子代理。 用例：此方法适用于： 快速测试子代理配置 不需要保存的会话特定子代理 需要自定义子代理的自动化脚本 在文档或脚本中共享子代理定义 有关 JSON 格式和所有可用选项的详细信息，请参阅 。 文件格式 每个子代理在具有以下结构的 Markdown 文件中定义： 配置字段 字段 必需 描述 : : : 是 使用小写字母和连字符的唯一标识符 是 子代理目的的自然语言描述 否 特定工具的逗号分隔列表。如果省略，继承主线程中的所有工具 否 用于此子代理的模型。可以是模型别名（ 、 等）或 以使用主对话的模型。如果省略，默认为配置的子代理模型 否 子代理的权限模式。有效值: 、 、 、 、 。控制子代理如何处理权限请求 否 子代理启动时自动加载的技能名称，逗号分隔 模型选择 字段允许您控制子代理使用的 ： 模型别名：使用可用别名之一，如 、 、 、 等 ：使用与主对话相同的模型（对于一致性很有用） 省略：如果未指定，使用为子代理配置的默认模型 注意：当您希望子代理适应主对话的模型选择，确保整个会话中的功能和响应风格一致时，使用 特别有用。 可用工具 子代理可以被授予访问 CodeBuddy Code 任何内部工具的权限。有关可用工具的完整列表，请参阅 。 提示：推荐：使用 命令修改工具访问权限 它提供了一个交互式界面，列出所有可用工具，包括任何连接的 MCP 服务器工具，使选择所需工具变得更容易。 您有两个选项来配置工具： 省略 字段以继承主线程中的所有工具（默认），包括 MCP 工具 指定单个工具作为逗号分隔列表以获得更精细的控制（可以手动编辑或通过 编辑） MCP 工具：子代理可以访问来自配置的 MCP 服务器的 MCP 工具。当省略 字段时，子代理继承主线程可用的所有 MC"},{"id":"/cli/agent-teams","title":"Agent Teams：多智能体协作","body":"Agent Teams：多智能体协作 Agent Teams 让你协调多个 CodeBuddy Code 实例组成团队协作，通过共享任务列表、成员间消息通信和集中式管理完成复杂任务。该功能目前存在 。 Agent Teams 让你协调多个 CodeBuddy Code 实例共同工作。一个会话作为团队领导（team lead），负责协调工作、分配任务和汇总成果；其余成员（teammates）各自独立工作，拥有自己的上下文窗口，并通过消息系统直接相互沟通。 与 不同的是，子代理在单一会话内运行、只能将结果报告给主代理；而 Agent Teams 的成员之间可以直接通信，你也可以绕过领导直接与任意成员对话。 何时使用 Agent Teams Agent Teams 在并行探索能创造真正价值的任务中最为有效。典型场景包括： 研究与评审：多个成员同时调研问题的不同方面，然后共享和质疑彼此的发现 新模块开发：每个成员负责独立的模块，互不干扰 竞争性假设调试：成员并行测试不同假设，更快收敛到正确答案 跨层协调：前端、后端、测试各由不同成员负责，同步推进 Agent Teams 会带来额外的协调开销，Token 消耗也显著高于单会话。当成员能独立工作时效果最好。对于顺序执行的任务、同文件编辑或依赖关系复杂的工作，单会话或子代理更合适。 与子代理的对比 子代理 Agent Teams : : : 上下文 独立上下文窗口，结果返回给调用者 独立上下文窗口，完全独立 通信 只能向主代理报告结果 成员之间可直接发送消息 协调 主代理管理所有工作 共享任务列表，成员自主认领 适用场景 聚焦型任务，只关心最终结果 需要讨论和协作的复杂工作 Token 消耗 较低：结果汇总回主上下文 较高：每个成员是独立实例 简单来说：需要快速执行的独立子任务用子代理，需要成员之间相互沟通和协调的复杂任务用 Agent Teams。 创建你的第一个团队 用自然语言告诉 CodeBuddy 你想要什么样的团队。CodeBuddy 会根据你的描述自动创建团队、生成成员、分配任务。 CodeBuddy 会： 1. 创建团队和共享任务列表 2. 为每个角色生成独立的成员 3. 协调各成员的工作 4. 汇总最终成果 团队创建完成后，终端会显示所有成员及其当前状态。你可以通过 的方式直接与任意成员对话。 团队创建后的界面 创建成功后，你会看到类似如下信息： 随后领导通过 Agent 工具生成成员，每个成员以 的形式展示，并以不同颜色标识。 控制你的团队 用自然语言告诉领导你的意图，它会处理团队协调、任务分配和工作委派。 与成员交互 你可以直接与任何成员对话，无需通过领导中转。 @提及补全：在输入框中输入 触发成员名称的 Tab 自动补全。支持模糊搜索，输入部分名称即可匹配。下拉菜单中会以成员各自的颜色显示名称，并标注状态（如 ）。选择成员后输入消息即可直接发送。 @all 广播：输入 可向所有成员同时发送消息，相当于广播。当成员数量大于 1 时， 选项会出现在补全列表的最前面。 提示：已完成任务的成员也会显示在 补全列表中。选择一个已完成的成员并发送消息，可以重新唤醒它继续工作。 实时状态栏 输入框下方会显示团队状态栏，展示各成员的工作状态： 表示正在工作 表示已完成 表示失败 表示已取消或被终止 每个成员名称以其分配的颜色渲染，并实时显示 Token 消耗和工具调用次数。当打开补全下拉菜单时，状态栏会自动隐藏以避免遮挡。 成员焦点导航 在输入框为空时，按 进入成员切换模式，使用方向键选择成员，回车确认切换： 快捷键 功能 : : ↓ 进入成员切换模式 ←/→ 在成员之间切换选择 Enter 确认并切换到选中成员的视图 Esc 取消选择，退出切换模式 Ctrl+O 返回主视图（团队领导） 聚焦成员后： 终端会显示该成员的完整对话历史、实时进度和 Token 消耗 输入框自动切换为向该成员发送消息的模式，直接输入即可发送 使用 可将消息路由回主代理（团队领导） 提示：焦点导航是查看成员工作详情的最便捷方式。相比 只能发送消息，焦点导航还能浏览成员的历史对话和当前工作状态。 指定成员和模型 CodeBuddy 会根据任务自动决定生成多少成员，也可以明确指定： 要求成员在实施前提交计划 对于复杂或高风险的任务，可以要求成员在实施前先提交计划： 成员完成计划后，会向领导发送计划审批请求。领导审核后批准或拒绝（附带反馈）。被拒绝的成员会保持计划模式，修改后重新提交。 委派模式 默认情况下，领导可能会自己动手实现任务，而不是等成员完成。按 可以切换到委派模式（Delegate Mode），限制领导只能使用协调工具（生成成员、发送消息、管理任务），不直接修改代码。 适合你希望领导专注于任务拆分、分"},{"id":"/cli/skills","title":"CodeBuddy Code Skills （技能系统）","body":"CodeBuddy Code Skills （技能系统） Skills 是 CodeBuddy Code 的扩展能力系统，允许您创建专业的领域知识和工作流模板，让 AI 助手能够更专业地处理特定类型的任务。 什么是 Skills Skills 类似于为 AI 助手提供的\"专业培训\"。通过 Skill，您可以： 封装专业知识：将特定领域的最佳实践和操作流程封装成可复用的技能 提供工作流模板：定义标准化的任务处理流程，提高工作效率 扩展 AI 能力：让 AI 助手能够处理更专业、更复杂的任务 团队协作共享：项目级 Skills 可以在团队成员间共享专业知识 Skills vs Slash Commands 特性 Skills Slash Commands 触发方式 AI 模型自动识别并调用 用户手动输入命令 使用场景 专业领域任务处理 快捷操作和工作流 权限控制 支持工具白名单限制 无特殊权限控制 工作目录 支持自定义基础目录 使用当前工作目录 可见性 对用户透明，AI 自动决策 用户主动发起 简单来说： Slash Commands 是用户主动调用的快捷方式 Skills 是 AI 根据任务需求自动选择的专业能力 创建 Skills 目录结构 Skills 通过在特定目录中创建 文件来定义： 1. 项目级 Skills： （项目根目录下） 2. 用户级 Skills： （用户主目录下） 每个 Skill 一个独立的目录，包含 文件： SKILL.md 格式 Skill 文件使用 Markdown 格式，支持 YAML Frontmatter 定义元数据： Frontmatter 字段 字段 必填 说明 示例 否 Skill 名称，未指定时使用目录名 否 Skill 描述，帮助 AI 理解何时使用 否 允许使用的工具白名单，逗号分隔 否 设置为 时，Skill 不会出现在 Skill 工具中，只能通过 手动触发 否 设置为 时，Skill 从 菜单中隐藏，仅供 AI 内部调用或其他 Skill 引用，默认 否 设置为 时，Skill 在独立的 subagent 上下文中执行 否 指定 subagent 类型，仅在 时有效 执行 Shell 命令 与 一样，Skills 也支持在 SKILL.md 中使用 command 语法内联执行 Shell 命令。当 Skill 被触发时（无论是 AI 自动调用还是用户通过 手动触发），这些命令会被执行，输出结果会替换到 Skill 内容中，供 AI 后续分析。 示例： 支持的特性 参数替换：在 Shell 命令执行前， 会被替换为用户传入的参数 文件引用：Shell 命令执行后， 引用会被处理并注入文件内容 错误隔离：单个命令执行失败不会影响其他命令，失败的命令会被替换为空字符串 💡 处理管道： 替换 → command 执行 → 引用处理，与斜杠命令的处理顺序一致。 Context Fork 使 Skill 在隔离的子代理上下文中运行，不访问对话历史。 可用 Agent 类型 类型 说明 通用（默认） 只读工具，优化代码库探索 规划和分析 自定义 中定义的 agent 隐藏 Skill（user invocable） 使 Skill 从 菜单中隐藏，适用于： 背景知识类 Skill（如项目规范、编码标准） 仅供其他 Skill 或 AI 内部引用的辅助 Skill 这类 Skill 会被加载到 AI 的上下文中，但用户无法通过 菜单直接调用。 执行流程 1. 创建新的隔离上下文 2. 子代理接收 Skill 内容作为提示 3. 字段决定执行环境 4. 结果返回主对话 注意： 只适用于包含明确任务的 Skill。仅有指导方针没有具体任务时，不会产生有意义的输出。 使用示例 示例 1：PDF 处理 Skill 文件： 使用：当用户询问 \"帮我提取这个 PDF 的内容\" 时，AI 会自动识别需要 PDF 处理能力并调用该 Skill。 示例 2：数据分析 Skill 文件： 示例 3：代码审查 Skill 文件： AI 如何选择 Skills AI 根据以下因素决定是否调用 Skill： 1. 任务匹配度：任务描述与 Skill description 的相关性 2. 工具需求：任务所需工具是否在 allowed tools 范围内 3. 上下文相关性：当前对话上下文是否适合使用该 Skill 4. Skill 来源：项目级 Skills 优先于用户级 Skills 权限控制 allowed tools 白名单 通过 字段限制 Skill 可以使用的工具： 支持的工具模式匹配： 只允许 git 相关命令 只允许编辑特定路径文件 工作目录限制 每个 Skill 都有自己的 （SKILL.md 所"},{"id":"/cli/hooks-guide","title":"Hooks 入门指南","body":"Hooks 入门指南 学习如何通过注册 shell 命令来自定义和扩展 CodeBuddy Code 的行为 建议先阅读 ，了解所有事件、输入输出结构与安全要求。本指南聚焦于实际操作演练与常见示例，帮助你迅速在 CodeBuddy Code 项目中启用 Hooks 功能。 注意：Hook 功能目前处于 Beta 阶段，仍在持续打磨，请留意后续版本更新。 现在你已掌握在 CodeBuddy Code 中启用 hooks 的核心流程。更多事件字段细节、决策控制和安全注意事项请查阅 。祝你构建出既强大又安全的自动化工作流！"},{"id":"/cli/plugins","title":"创建插件","body":"创建插件 插件让你可以通过自定义技能、代理、钩子和 MCP 服务器来扩展 CodeBuddy Code 的功能。本指南涵盖如何创建你自己的插件。 要安装已有的插件，请参阅 。完整的技术规范请参考 。 何时使用插件 vs 独立配置 CodeBuddy Code 支持两种添加自定义技能、代理和钩子的方式： 方式 技能名称 适用场景 独立配置（ 目录） 个人工作流、项目特定定制、快速实验 插件（含 的目录） 团队共享、社区分发、版本化发布、跨项目复用 使用独立配置的场景： 为单个项目定制 CodeBuddy Code 配置是个人的，不需要共享 在打包为插件之前实验技能或钩子 需要简短的技能名称，如 或 使用插件的场景： 需要与团队或社区共享功能 需要在多个项目中使用相同的技能/代理 需要版本控制和便捷的更新机制 通过市场分发 可以接受命名空间化的技能名称如 （命名空间防止插件间冲突） 提示：先在 中使用独立配置快速迭代，准备共享时再 。 快速开始 本快速开始将引导你创建一个包含自定义技能的插件。你将创建一个清单文件（定义插件的配置文件）、添加一个技能，并使用 参数在本地测试。 前提条件 已 CodeBuddy Code 如果看不到 命令，请将 CodeBuddy Code 更新到最新版本。参见 获取升级说明。 创建你的第一个插件 第 1 步：创建插件目录 每个插件都有自己的目录，包含清单文件和你的技能、代理或钩子。现在创建一个： 第 2 步：创建插件清单 清单文件位于 ，定义插件的身份信息：名称、描述和版本。CodeBuddy Code 使用这些元数据在插件管理器中展示你的插件。 在插件目录内创建 目录： 然后创建 ，内容如下： 字段 用途 唯一标识符和技能命名空间。技能以此为前缀（如 ） 在插件管理器中浏览或安装插件时显示 使用 跟踪发布 可选。用于归属标注 更多字段如 、 和 ，参见 。 第 3 步：添加技能 技能放在 目录中。每个技能是一个包含 文件的文件夹。文件夹名称成为技能名称，并以插件命名空间为前缀（在名为 的插件中， 创建 ）。 在插件目录中创建技能目录： 然后创建 ，内容如下： 第 4 步：测试你的插件 使用 参数运行 CodeBuddy Code 以加载你的插件： 启动后，尝试你的新技能： 你会看到 CodeBuddy 回复一个问候语。运行 可以看到你的技能列在插件命名空间下。 为什么要命名空间？ 插件技能始终带有命名空间（如 ），以防止多个插件中同名技能产生冲突。要更改命名空间前缀，请更新 中的 字段。 第 5 步：添加技能参数 通过接受用户输入使技能更加动态。 占位符捕获用户在技能名称后提供的任何文本。 更新你的 文件： 运行 以获取更改，然后用你的名字尝试技能： CodeBuddy 会按名字问候你。更多关于向技能传递参数的信息，参见 。 你已成功创建并测试了一个包含以下关键组件的插件： 插件清单（ ）：描述插件的元数据 技能目录（ ）：包含你的自定义技能 技能参数（ ）：捕获用户输入实现动态行为 参数适用于开发和测试。当你准备与他人共享插件时，参见 。 插件结构概述 你已经创建了一个包含技能的插件，但插件还可以包含更多内容：自定义代理、钩子、MCP 服务器和 LSP 服务器。 常见错误：不要将 、 、 或 放在 目录内。只有 放在 内。所有其他目录必须在插件根目录层级。 目录 位置 用途 插件根目录 包含 清单 插件根目录 Markdown 格式的斜杠命令 插件根目录 自定义代理定义 插件根目录 包含 文件的代理技能 插件根目录 事件处理器 插件根目录 MCP 服务器配置 插件根目录 LSP 服务器配置（代码智能） 插件根目录 插件启用时添加到 Bash 工具 的可执行文件 插件根目录 插件启用时应用的默认 示例完整结构： 开发更复杂的插件 掌握了基础插件后，你可以创建更复杂的扩展。 添加技能 插件可以包含 来扩展 CodeBuddy 的能力。技能是模型调用的：CodeBuddy 会根据任务上下文自动使用它们。 在插件根目录添加 目录，其中包含带有 文件的技能文件夹： 每个 需要包含 和 字段的 frontmatter，后跟指令： 安装插件后，运行 加载技能。完整的技能编写指南，包括渐进式披露和工具限制，参见 。 添加命令 插件可以提供自定义斜杠命令，用户可以手动触发。命令定义为 Markdown 文件。 示例： 命令会以 的格式注册。 详细说明请参考 。 添加 Hooks Hooks 允许在特定事件发生时自动执行操作。命令通过标准输入接收 hook 输入的 JSON 数据，可以使用 提取字段。 示例： 详细说明请参考 。 添加 LSP 服务器 对于常见语言如 TypeScript、Python 和 Rust"},{"id":"/cli/plugin-marketplaces","title":"插件市场（Plugin Marketplaces）","body":"插件市场（Plugin Marketplaces） 插件市场（Plugin Marketplace）是一个插件目录文件，用于分发和管理 CodeBuddy Code 扩展。通过市场，你可以发现并安装来自不同来源的插件，无需自己构建。 核心功能 集中发现：在一个地方浏览来自多个来源的插件 版本管理：自动跟踪和更新插件版本 自动更新：支持启用自动更新，定期同步市场内容 团队分发：在组织内共享必需的插件 灵活来源：支持 GitHub 仓库、Git URL、本地路径和 HTTP URL 两步流程：先添加市场，再安装具体插件 官方市场 官方市场在 CodeBuddy Code 启动时自动可用。运行 并进入发现标签页浏览可用插件。 安装官方市场的插件 使用以下命令从官方市场安装插件： 例如，安装 GitHub 集成： 添加市场 使用 命令从不同来源添加市场。 💡 快捷方式：可以使用 代替 ， 代替 GitHub 仓库 添加包含 文件的 GitHub 仓库，使用 格式： 其他 Git 主机 添加来自 GitLab、Bitbucket 或其他 Git 服务的仓库： 使用 HTTPS： 使用 SSH： 指定特定分支或标签： 本地路径 添加本地目录或 文件（用于开发和测试）： 远程 URL 通过 HTTP(S) URL 添加托管的 文件： ⚠️ 注意：URL 型市场相比 Git 型市场有一些限制。如果安装插件时遇到\"路径未找到\"错误，参见 安装插件 添加市场后，你可以直接安装插件（默认安装到用户作用域）： 选择安装作用域 使用交互式界面选择 ： 1. 运行 打开插件管理器 2. 进入发现标签页 3. 按 Enter 选择一个插件，查看作用域选项： 用户作用域（默认）：为你自己在所有项目中安装 项目作用域：为所有协作者在此仓库中安装（添加到 ） 本地作用域：仅为你自己在此仓库中安装（不与协作者共享） 托管作用域：由管理员通过 安装（不可修改） 📌 提示：运行 进入已安装标签页，查看按作用域分组的插件 管理已安装的插件 运行 并进入已安装标签页来查看、启用、禁用或卸载插件。输入文本筛选插件列表。 快速管理命令 禁用插件（不卸载）： 重新启用已禁用的插件： 完全卸载插件： 指定特定作用域： 无需重启应用更改 安装、启用或禁用插件后，运行 无需重启即可加载所有更改： CodeBuddy Code 重新加载所有活跃插件，并显示插件数、技能数、代理数、钩子数、插件 MCP 服务器数和插件 LSP 服务器数的统计。 管理市场 通过交互式 界面或命令行管理市场。 交互式界面管理 运行 并进入市场标签页来： 查看所有已添加的市场及其来源和状态 添加新市场 更新市场列表以获取最新插件 移除不再需要的市场 命令行管理 列出所有已配置的市场： 刷新市场的插件列表： 移除市场： ⚠️ 警告：移除市场将卸载从该市场安装的所有插件 配置自动更新 CodeBuddy Code 可以在启动时自动更新市场及其已安装的插件。启用市场自动更新后，CodeBuddy Code 会刷新市场数据并将已安装插件更新到最新版本。如果任何插件被更新，你会看到提示运行 的通知。 通过 UI 为单个市场切换自动更新： 1. 运行 打开插件管理器 2. 选择市场 3. 从列表中选择一个市场 4. 选择启用自动更新或禁用自动更新 官方市场默认启用自动更新。第三方和本地开发市场默认禁用自动更新。 禁用所有自动更新： 设置 环境变量可以禁用 CodeBuddy Code 和所有插件的自动更新。参见 。 保持插件自动更新，禁用 CodeBuddy 自动更新： 设置 和 ： 这样你可以手动管理 CodeBuddy Code 更新，同时自动接收插件更新。 官方市场内容 官方市场包含多个类别的插件： 代码智能 代码智能插件启用 CodeBuddy Code 内置的 LSP 工具，让 AI 能够跳转到定义、查找引用、查看类型错误等。这些插件配置 连接，与 VS Code 的代码智能相同。 这些插件要求在你的系统上安装语言服务器二进制文件。如果已经安装了语言服务器，打开项目时 CodeBuddy Code 可能会提示你安装对应的插件。 语言 插件 所需二进制文件 C/C++ C Go Java Kotlin Lua PHP Python Rust Swift TypeScript 你也可以为其他语言 ⚠️ 注意：如果在 错误标签页中看到 ，请从上表中安装所需的二进制文件。 代码智能插件的作用 安装代码智能插件并且语言服务器二进制文件可用后，CodeBuddy Code 获得两个能力： 自动诊断：每次编辑后，语言服务器会自动分析更改并报告错误和警告。CodeBuddy Code 可以看到类型错误、缺失的导入和语法问题，"},{"id":"/cli/checkpointing","title":"检查点","body":"检查点 概述 自动跟踪并回退 CodeBuddy 的编辑，快速恢复不需要的更改。 CodeBuddy Code 在您工作时会自动跟踪 CodeBuddy 对文件的编辑，让您能够快速撤销更改，并在出现问题时回退到之前的状态。 常见使用场景 检查点在以下情况下特别有用： 探索替代方案：尝试不同的实现方式，而不会丢失起始点 从错误中恢复：快速撤销引入 bug 或破坏功能的更改 功能迭代：在知道可以恢复到可用状态的前提下，放心地进行各种尝试 另请参阅 键盘快捷键和会话控制 使用 访问检查点"},{"id":"/cli/worktree","title":"Git Worktree 支持","body":"Git Worktree 支持 在独立工作区中运行 CodeBuddy,实现并行开发和安全隔离。 概述 Git worktree 允许在同一仓库中同时拥有多个工作目录,每个目录可以检出不同的分支。CodeBuddy Code 利用这一特性提供: 并行开发:在不影响主工作区的情况下进行实验性开发 安全隔离:AI 的所有更改都在独立目录中进行 零存储开销:worktree 共享 Git 对象,不会复制整个仓库 子代理隔离:支持多个 AI 子代理在独立 worktree 中并行工作 tmux 集成:可选在独立的 tmux 会话中运行 非 Git 支持:通过 WorktreeCreate/WorktreeRemove hooks，SVN、Perforce 等项目也能使用 worktree 隔离 快速开始 在会话中创建 已启动 CodeBuddy Code 会话后,可以通过自然语言请求创建 worktree: AI 会自动调用 工具创建隔离工作目录并切换过去。 注意:只有明确提到 \"worktree\" 时才会触发,说 \"帮我开一个分支\" 或 \"修复这个 bug\" 不会自动创建 worktree。 CLI 参数 参数 说明 示例 : : : 创建并进入 worktree 或 指定基础分支（需配合 ） 或 在 tmux 会话中运行（需要安装 tmux） 使用传统 tmux 模式（不使用 popup） 工作流程 创建 Worktree 当使用 参数启动时: 1. CodeBuddy 在 目录下创建新的 worktree 2. 确定基础分支: 如果指定了 ，基于远程分支 如果指定了 ，基于本地分支 如果未指定，默认基于远程默认分支（通常是 或 ） 3. 自动创建对应的分支(如 ) 4. 将工作目录切换到 worktree 5. 执行初始化(复制设置、创建符号链接、复制 文件等) 分支不存在时的行为： 如果指定的分支（远程或本地）不存在，会打印警告并自动降级到远程默认分支继续创建 不会中断启动流程 退出时的选择 当你退出 worktree 会话时，CodeBuddy 会检测变更并提供选项： 保留 Worktree：保留所有更改和分支，可以稍后继续 删除 Worktree：清理 worktree 和关联分支 保留但退出 tmux：（tmux 模式）保留 worktree 但关闭 tmux 会话 变更检测 退出前，CodeBuddy 会检测： 未提交的文件变更 未推送的提交 如果没有任何变更，worktree 会自动清理。 配置 在 中配置 worktree 行为: 配置项 配置项 说明 默认值 : : : 从主仓库符号链接到 worktree 的目录 符号链接目录可以避免在每个 worktree 中重复安装依赖,节省时间和磁盘空间。 同步本地忽略文件(.worktreeinclude) 、 等本地配置文件通常被 排除,但新 worktree 中同样需要它们才能正常运行。 解决方式:在仓库根目录创建 文件,列出需要复制的文件(语法与 相同): 每次创建新 worktree 时,这些文件会自动从主仓库根目录复制过去。复用已有 worktree 时不会重新复制。 提示: 应该提交到 Git,这样团队成员都能受益。 Hook based Worktree 默认情况下，worktree 功能依赖 Git 内置的 命令。对于使用 SVN、Perforce 或没有版本控制的项目，可以通过配置 WorktreeCreate / WorktreeRemove hooks 来使用 worktree 隔离功能。 决策优先级 核心规则： Hook 优先于 Git：配置了 WorktreeCreate hook 后，即使在 Git 仓库中也走 hook，不走 创建失败不降级：WorktreeCreate hook 失败时不会回退到 git worktree，直接报错 删除失败不阻塞：WorktreeRemove hook 失败只记录警告，不阻止退出流程 配置方式 在 （项目级）或 （全局）中配置： 两个 hook 独立配置——可以只配 WorktreeCreate 不配 WorktreeRemove（此时退出时不会自动清理，会提示手动删除目录）。 输入数据（stdin） Hook 脚本通过 stdin 接收 JSON 格式的上下文数据。 WorktreeCreate 输入： 字段 说明 : : worktree 名称（用户指定或系统自动生成） 当前工作目录 当前会话 ID 对话记录文件路径 WorktreeRemove 输入： 字段 说明 : : 要删除的 worktree 绝对路径 输出与 Exit Code WorktreeCreate： stdout：必须输出创建好的"},{"id":"/cli/remote-control","title":"远程控制（Remote Control）","body":"远程控制（Remote Control） Beta：远程控制功能目前处于 Beta 阶段，功能和接口可能会在后续版本中发生变化。欢迎试用并反馈问题。 通过 Remote Control，您可以从手机、平板或任意浏览器远程访问本地运行的 CodeBuddy Code 会话。会话始终在您的本机执行，Web 界面只是一个远程窗口。 概述 Remote Control 在本地启动一个 Gateway 服务，通过 Cloudflare Tunnel 或局域网暴露一个 Web UI，让您可以从任何设备连接到正在运行的 CodeBuddy Code 会话。 使用 Remote Control，您可以： 远程使用完整的本地环境：文件系统、MCP 服务器、工具配置全部保持可用 通过 Web UI 与 Agent 交互：在浏览器中发送消息、查看对话、监控工具执行 从多设备接入：手机扫码即可连接，支持局域网和公网访问 通过终端管理会话：在终端和 Web 端同时工作，对话保持同步 前置条件 已安装并登录 CodeBuddy Code（运行 后使用 登录） 若需要公网访问，需安装 （可选） 启动远程控制 在 CodeBuddy Code 会话中使用 命令启动远程控制服务： 启动成功后，终端会显示连接信息： 连接方式 Gateway 启动后，有以下几种方式从其他设备连接： 扫描二维码：用手机扫描终端中显示的二维码，直接打开 Web UI 复制 Web UI 链接：将带有认证 token 的 URL 在任意浏览器中打开 局域网访问：同一网络中的设备可直接访问 Local 地址（如 ） 子命令 命令 说明 : : 启动 Gateway（默认带 Tunnel） 查看当前 Gateway 状态 停止 Gateway 重新生成认证 token 启动带 Tunnel 的 Gateway 网络模式 Gateway 支持两种网络模式，适应不同的使用场景： Tunnel 模式（默认） 通过 Cloudflare Quick Tunnel 自动分配一个临时公网域名（ ），无需任何额外配置即可从公网访问。 适用场景： 从外部网络（如手机移动网络）远程访问 不想配置端口转发或 VPN 需要安装 ： 局域网模式 当 未安装或 Tunnel 启动失败时，Gateway 自动回退到局域网模式。此模式下，仅同一网络中的设备可以访问。 默认监听端口： 监听地址：默认 （仅本机），可通过 监听所有网络接口 安全机制 认证 Gateway 启动时会自动生成一个随机密码（token），访问 Web UI 和 API 均需要通过认证。支持以下认证方式： 方式 说明 : : URL 参数 ，适合快速分享链接 Cookie 登录后自动设置，后续访问无需重复认证 Bearer Token ，适合 API 调用 密码可通过 命令重新生成。重新生成后，之前的密码立即失效。 登录限流 为防止暴力破解，认证中间件内置了登录限流机制： 每分钟最多允许 2 次失败尝试 每小时额外允许 12 次失败尝试 超出限制后将暂时拒绝登录请求 权限 通过远程控制执行的任务自动以 模式运行，即工具执行不需要逐一审批。这是因为远程场景下无法进行交互式审批。请确保仅将访问链接分享给受信任的人。 CORS 策略 Gateway 默认允许以下来源的跨域请求： 本地回环地址（ 、 、 ） Tunnel 分配的公网地址 通过 配置的额外来源 Web UI Web UI 提供了完整的 CodeBuddy Code 交互界面，包括： 对话界面：发送消息、查看 Agent 回复、监控工具调用 终端面板：内置 Web 终端，直接在浏览器中操作远程终端 实例管理：查看和管理多个 CodeBuddy Code 实例 主题切换：支持亮色/暗色主题 多语言：支持中英文界面切换 Web UI 基于 ACP（Agent Client Protocol）与本地 Agent 通信，保证了与终端交互完全一致的体验。 配置 Settings 配置 在 中可以配置 Gateway 相关选项： 配置键 说明 默认值 : : : 认证模式， 或 自定义密码。为空时首次启动自动生成 自动生成 额外允许的 CORS 来源列表 ACP 最大并发连接数 ACP Session Token 有效期（毫秒） （24 小时） 环境变量 环境变量 说明 : : 额外的 CORS 允许来源（逗号分隔） 实例管理 当您在多个项目目录中运行 CodeBuddy Code 时，每个实例会自动注册到本地实例注册表（ ）。Web UI 的实例管理面板可以查看所有活跃的实例，并在它们之间切换。 实例信息包括： 工作目录 本地/Tunnel 地址 操作系统和架构 启动时间和运行状态 第三方平台集成（We"},{"id":"/cli/web-ui","title":"Web UI","body":"Web UI CodeBuddy Code 提供内置的 Web UI，在浏览器中提供完整的交互界面。当您以 serve 模式启动或开启远程控制时，Web UI 自动可用。 概述 Web UI 提供与终端界面相同的核心能力，并针对浏览器进行了可视化布局优化： 对话：发送消息、查看对话、实时监控工具执行 终端：内嵌终端，支持分屏布局（最多 4 个面板） Workers：管理 CLI Worker 进程和 Daemon 守护进程 日志：独立日志查看器，支持多种日志类型和关键词搜索 远程控制：连接微信和企业微信渠道 监控：系统资源指标和各 Worker 进程级内存/运行时间指标 任务：浏览任务模版并创建定时任务 插件：管理插件安装和插件市场 设置：配置主题、语言、模型和权限模式 文档：浏览 CLI 文档，支持全文搜索 API 文档：查看交互式 Swagger UI，方便 HTTP API 探索 访问 Web UI 方式一：Serve 模式 使用 参数启动 CodeBuddy Code： 然后在浏览器中打开： 方式二：远程控制 在已有的 CodeBuddy Code 会话中启动 Gateway： 终端会显示二维码和 URL。用手机扫码或在浏览器中打开 URL。详见 文档。 认证方式 Web UI 支持两种认证模式： 模式 设置 说明 : : : 免认证（默认） 无需密码 密码认证 启动时终端显示密码 认证方式（以下任一方式均可）： URL 参数： — 通过 URL 自动登录 登录页面：输入终端显示的密码 Bearer Token： ，用于 API 访问 在 中配置： 功能详解 对话视图 默认视图，用于与 Agent 交互。核心功能： 富文本消息渲染：Markdown、语法高亮代码块、表格、图片 工具执行展示：内联查看工具调用、参数和结果 权限管理：在浏览器中直接批准或拒绝工具权限 问答面板：回答 Agent 的多选问题 任务进度：实时监控后台任务和 Team 进度 会话管理：新建对话、浏览历史、切换会话 终端视图 基于 xterm.js 的内嵌终端： 分屏布局：支持水平和垂直分屏，最多 4 个面板 独立会话：每个面板有独立的 PTY 会话 持久连接：终端会话在页面刷新后保持 自适应调整：窗口大小变化时面板自动调整 文档视图 在 Web UI 中直接浏览 CLI 文档： 全文搜索：基于 MiniSearch 搜索所有文档 多语言：自动跟随 UI 语言设置（中文/英文） 目录导航：根据文档标题自动生成，带滚动追踪 内部跳转：文档链接在查看器内导航（SPA 模式） API 文档：快速链接到 的交互式 Swagger UI 实例管理 管理多个 CodeBuddy Code 实例： 实例列表：查看所有运行中的实例及其工作目录和状态 快速切换：一键切换实例 手动添加：通过 URL 添加远程实例 隧道支持：通过 Cloudflare Tunnel 访问实例 设置 主题：浅色、深色或跟随系统（自动检测） 语言：中文、英文或跟随系统（自动检测） 模型：从可用选项中选择 AI 模型 权限模式：默认、接受编辑、跳过权限或规划模式 API 文档 HTTP 服务运行时，可在以下地址访问交互式 API 探索器： Swagger UI 提供以下功能： 浏览所有可用的 REST API 端点 查看请求/响应 Schema 直接在浏览器中测试 API 调用 在 下载 OpenAPI 3.1 规范 完整的 API 参考请见 。 移动端支持 Web UI 完全响应式，支持移动设备： 侧边栏：小屏幕上折叠为滑出式抽屉 PWA 支持：添加到主屏幕获得类原生应用体验 触控优化：所有交互针对触摸操作优化 扫码访问：终端扫码即可在手机上打开 快捷键 快捷键 操作 : : 发送消息 输入换行 停止运行中的 Agent 技术细节 框架：React 18 + Zustand 状态管理 通信：ACP 协议，基于 HTTP/SSE（非 WebSocket） 样式：Tailwind CSS + CSS 变量主题 终端：xterm.js + fit addon 搜索：MiniSearch 客户端全文搜索 Markdown：react markdown + remark gfm + 语法高亮 相关文档 — 通过 Gateway 和 Tunnel 启动 Web UI — 完整的 REST API 文档 — IDE 集成的 Agent Client Protocol — 配置选项"},{"id":"/cli/scheduled-tasks","title":"定时任务","body":"定时任务 CodeBuddy Code 支持在会话中创建和管理定时任务，可以按照设定的时间表重复执行指令，或者在未来某个时间点触发一次性操作。常见用途包括：定期检查构建状态、轮询任务完成情况、在特定时间点提醒自己等。 注意：定时任务是会话级别的。任务只在 CodeBuddy Code 运行期间有效，退出后自动清除。 创建一次性提醒 如果只需要在未来某个时间点提醒一次，可以直接用自然语言描述： 这类任务会在指定时间触发一次，执行完毕后自动删除。 任务执行机制 执行时机 任务只会在会话空闲时触发，即系统没有在处理其他请求的时候。如果正好在执行某个操作，触发时间会顺延到操作完成后。 时间偏移（Jitter） 系统会对任务的触发时间添加少量随机偏移，以避免大量任务同时执行带来的拥堵： 循环任务：最多延迟周期时长的 10%（上限 15 分钟） 一次性任务：对于整点和半点任务，最多提前 90 秒执行 例如，设置 执行的任务，实际触发时间可能在整点后的 0 6 分钟内随机分布。 自动过期 循环任务在创建 3 天后自动过期删除，过期前会最后触发一次。 如果需要任务持续更长时间，可以在过期后重新创建，或者改用外部调度方案（如 GitHub Actions 等）。 Cron 表达式参考 需要「每周一早上 10 点」「每月 1 号」这类精确时间，直接告诉 AI 你的需求，它会自动转成 cron 表达式并创建任务： AI 回复时会告诉你实际使用的 cron 表达式和执行频率，方便确认是否符合预期。 格式： 常用表达式： 表达式 含义 每 5 分钟 每 15 分钟 每小时整点 每天上午 9 点 工作日上午 9 点 每月 1 日午夜 每周五下午 6:30 字段说明： 字段 取值范围 特殊符号 分钟 0–59 （任意）、 （每 N 分钟）、 （列举）、 （范围） 小时 0–23 同上 日期 1–31 同上 月份 1–12 同上 周几 0–6 0 或 7 = 周日，1 = 周一，依此类推 注意事项 事项 说明 会话绑定 任务随会话存在，CodeBuddy Code 退出后任务消失，不会写入磁盘 循环任务上限 每个会话最多同时存在 50 个定时任务 最小间隔 1 分钟（秒级设置会被自动向上取整） 任务过期 循环任务 3 天后自动清除 不补跑 会话中断期间错过的任务不会补发执行 禁用定时任务 如果需要完全关闭定时任务功能，可以设置环境变量： 启用后， 技能不再可用， 、 、 工具也会被禁用。 相关文档"},{"id":"/cli/wecom-bot-setup","title":"企业微信智能机器人接入指南","body":"企业微信智能机器人接入指南 通过 命令，您可以将 CodeBuddy Code 快速接入企业微信智能机器人，实现远程消息驱动。采用 WebSocket 长连接 主动连接方式，无需公网 IP，配置最为简洁。 前置条件 已注册企业微信账户 CodeBuddy Code 已安装： 已完成登录认证： 后执行 2. 配置环境变量 在启动 CodeBuddy CLI 前，设置以下环境变量： 可选配置 环境变量 说明 默认值 AI Bot ID（必填） — AI Bot Secret（必填） — WebSocket 服务地址（私有化部署时使用） 持久化配置（可选） 将环境变量添加到 shell 启动文件中，每次启动时自动生效： 4. 面板操作说明 操作 说明 / 选择客户端条目 / Vim 风格导航（等同于上下方向键） 连接（ 状态）或断开（ / 状态） 退出面板（操作进行中时不响应） 5. 验证接入 连接建立后，可通过以下方式验证 Bot 是否正常工作。 方式一：直接对话 1. 打开企业微信客户端（桌面端或移动端） 2. 在消息列表中找到你创建的机器人 3. 发送测试消息（如「你好」），确认 Bot 有回复 方式二：群组对话 1. 将机器人添加到群聊 2. 在群组中通过 @机器人名称 发送消息 3. Bot 会响应被 @ 的消息 6. 消息处理流程和状态指示 消息处理全流程 用户发送消息到 Bot 后的处理流程： 流式状态指示机制 利用企微流式消息（ stream 类型）的全量替换特性： 1. 立即回复：收到用户消息后，立即发送 的流式消息，内容为\"正在处理，请稍候...\" 2. 原位替换：Agent 处理完成后，用同一个 发送 + 最终结果 3. 企微客户端收到 后，用全量内容替换之前显示的\"正在处理...\" 参考： —— stream.content 为全量内容，每次发送替换上一次的显示。 用户看到的效果 阶段 聊天窗口显示 说明 消息发送后 \"正在处理，请稍候...\" 流式消息占位，表示 Bot 正在处理 处理完成后 最终回复内容 \"正在处理...\"被最终结果原位替换 与之前方案的区别 方面 旧方案（文本消息 ack） 新方案（流式消息替换） \"正在处理...\" 永久保留在聊天记录 被最终结果原位替换 聊天记录 2 条消息（ack + 结果） 1 条消息（仅最终结果） 状态指示 有 有 超时处理 流式消息超时：6 分钟（从首次发送 stream 开始计时） 安全超时：5 分钟（预留 1 分钟余量） 超时回退：如果 Agent 处理超过 5 分钟，自动回退到异步推送（ ，24 小时有效期） 回调超时：收到消息回调后需在 5 秒内发送回复（流式占位消息满足此要求） 7. 工作原理 关键特性 连接方式：WebSocket 长连接（客户端主动连接，无需公网 IP） 认证机制：启动时发送 帧，携带 + 完成鉴权 消息接收：企业微信服务器通过 帧实时推送用户消息 消息回复：通过 帧以流式方式返回 Agent 回复 心跳保活：每 30 秒发送一次 帧保持连接活跃 自动重连：连接断开后按指数退避策略自动重连，最长延迟 60 秒 8. 常见问题 环境变量未配置 症状：在 面板中选择 后显示错误 解决方案： 1. 确认已设置 和 2. 执行 验证环境变量是否生效 3. 重新启动 CodeBuddy CLI 4. 再次执行 尝试连接 连接失败 可能原因及排查： 1. Bot ID 或 Secret 错误 确认从企业微信后台复制的值完全一致（注意末尾是否有空格） 确认 AI Bot 应用状态正常，未被停用 2. 网络连接问题 检查是否能访问 如使用私有化部署，确认 设置正确 尝试在浏览器中测试网络连接： 3. CLI 日志查看 查看终端输出的错误日志 执行 后保持在主界面，观察连接过程中的输出 连接后消息无响应 排查步骤： 1. 执行 确认 状态为 2. 如状态为 ，重新连接 3. 检查 CLI 终端日志是否有错误信息 4. 确认 CodeBuddy CLI 进程仍在运行（未被中断或退出） CLI 重启后需要重新连接 连接状态是临时的，不会持久化。每次重启 CodeBuddy CLI 后，需要重新执行 并选择 建立连接。 自动连接方案（如需每次启动自动连接）： 将以下内容添加到启动脚本或 shell 配置文件中： 其中 参数表示启动时自动执行指定命令。 应用提示\"Token 过期\"或\"Secret 无效\" 这通常表示 Bot 的 Secret 已失效或被重新生成。解决方案： 1. 登录企业微信管理后台，进入 Bot 详情页 2. 在「API 配置」区域重新生成 Secret 3. 更新环境变量 4. 重启 CodeBuddy CLI 并重新连接 相关文档 "},{"id":"/cli/channels","title":"Channels：将外部事件推送到会话中 [Beta]","body":"Channels：将外部事件推送到会话中 [Beta] Beta 功能：Channels 目前处于 Beta 阶段，功能和接口可能会根据反馈进行调整。 Channel 是一种 MCP 服务器，可以将消息、告警和 Webhook 推送到你正在运行的 CodeBuddy Code 会话中，让 CodeBuddy Code 在你不在终端时也能对外部事件做出反应。 Channel 可以是双向的：CodeBuddy Code 读取事件后通过同一 channel 回复，就像一个聊天桥。事件仅在会话打开时到达，如需持续运行，可以在后台进程或持久终端中运行 CodeBuddy Code。 你可以通过安装插件或使用内置 channel 来启用。微信、Telegram、Discord 以及 fakechat 演示都已支持。 当 CodeBuddy Code 通过 channel 回复时，终端会显示工具调用和确认（如\"sent\"），实际回复内容出现在对应的聊天平台上。 本页涵盖： ：微信、Telegram、Discord 以及 fakechat 设置 ：使用微信 channel 快速体验 ：发送者白名单和配对流程 ：为团队和企业启用 channel 要构建自己的 channel，请参阅 。 支持的 Channel 微信（内置） 微信 channel 是 CodeBuddy Code 内置的，无需安装插件。通过微信 ClawBot 实现双向消息通信，支持文本、图片和文件收发。 前提条件： 微信版本 iOS 8.0.70 及以上 在微信中启用 ClawBot 插件（微信 → 我 → 设置 → 插件 → ClawBot） 扫码绑定： 1. 在 CodeBuddy Code 中执行 或 选择 wechat 2. 终端显示二维码（如果二维码显示异常，会提供浏览器链接） 3. 用微信扫描二维码并确认 4. 绑定成功后自动开始接收消息 使用： 绑定后，在微信 ClawBot 对话中发送消息，消息会自动出现在 CodeBuddy Code 会话中： CodeBuddy Code 会处理消息并通过 工具回复，回复内容出现在微信中。 支持的消息类型： 类型 接收 发送 文本 支持 支持 图片 支持（自动下载解密到本地） 支持（自动加密上传到 CDN） 文件 支持 支持 凭证管理： 扫码成功后凭证保存在 。下次启动时自动使用已保存的凭证，无需重新扫码。 Telegram 需要安装插件。查看完整 。 1. 在 Telegram 中通过 创建一个 bot，获取 token 2. 安装插件： 3. 配置 token： 4. 启动： 5. 向 bot 发消息获取配对码，执行 完成配对 Discord 需要安装插件。查看完整 。 1. 在 创建应用和 bot 2. 启用 Message Content Intent，邀请 bot 到服务器 3. 安装插件： 4. 配置 token： 5. 启动： 6. DM bot 获取配对码，执行 完成配对 fakechat（演示） fakechat 是官方支持的演示 channel，在 localhost 上运行一个聊天 UI，无需认证和外部服务。 打开 即可开始聊天。 快速开始 以微信 channel 为例，快速体验完整的双向通信流程： 第 1 步：确保 ClawBot 已启用 在微信中打开 我 → 设置 → 插件，找到 ClawBot 并启用。 第 2 步：扫码绑定 启动 CodeBuddy Code，执行： 终端显示二维码。用微信扫描并确认绑定。 第 3 步：发送消息 在微信 ClawBot 对话中发送： 消息到达 CodeBuddy Code 会话，显示为： CodeBuddy Code 执行任务后通过 工具回复，回复内容出现在微信中。 第 4 步：发送图片 在微信中发一张截图给 ClawBot，CodeBuddy Code 会自动下载并识别图片内容。你可以要求它编辑图片并发回： CodeBuddy Code 使用 ImageEdit 工具处理图片，然后通过 将编辑后的图片发送回微信。 安全机制 微信 微信 channel 通过 ClawBot 的扫码认证机制保证安全。只有扫码绑定的微信账号可以发送消息，其他人的消息会被静默丢弃。 凭证（包含 bottoken 和 accountid）保存在本地，权限设为 600（仅所有者可读写）。 插件 Channel Telegram 和 Discord 等插件 channel 维护一个发送者白名单。通过配对流程添加信任的发送者： 1. 向 bot 发送任意消息 2. bot 回复配对码 3. 在 CodeBuddy Code 中确认配对码 4. 发送者 ID 加入白名单 白名单同时控制 。通过 "},{"id":"/cli/daemon","title":"Daemon 模式与后台会话","body":"Daemon 模式与后台会话 Daemon 模式让 CodeBuddy Code 以后台常驻服务的方式运行，不依赖终端窗口。启动后提供完整的 HTTP API 和 Web UI，随时接受请求。 核心价值：把 CLI 从\"用完即走\"变成\"随时待命\"。 概念 概念 说明 Worker 运行中的 CLI 进程，通过 PID 文件注册在 Daemon 后台常驻的 HTTP 服务进程（ 模式），通过 管理 后台会话 (bg) 通过 启动的非交互式任务，自动输出日志到文件 Daemon 管理 启动 Daemon Daemon 启动后以 detached 进程运行，父进程立即退出。本地地址默认免密访问，非本地地址自动开启密码认证。 幂等启动：多次执行 不会创建多个 daemon。如果已有 daemon 在运行，会直接返回现有 daemon 的信息。 查看状态 停止 / 重启 后台会话 启动后台任务 后台会话以 模式运行（无 TUI + 跳过权限确认），stdout/stderr 重定向到 。 进程管理命令 HTTP API 所有 Worker 和 Daemon 管理能力通过 REST API 暴露，Web UI 的 Workers 页面基于这些 API 构建。 详见 中的 Workers & Daemon 章节。 示例 Web UI 模式启动后，Web UI 提供三个管理页面： Workers — Worker 进程管理和 Daemon 控制 Logs — 独立日志查看器，支持 Worker 选择、日志类型切换、关键词搜索 Metrics — 系统资源监控和各 Worker 进程级指标 日志体系 日志 API 支持 4 种类型，按优先级自动选择： 类型 路径 内容 触发条件 所有模块的 Info/Warn/Error 始终（默认优先） 进程 stdout/stderr 仅 bg/daemon 详细调试信息 需 对话历史 始终 PID 文件注册表 每个 CLI 进程启动时在 注册 PID 文件： PID 文件内容： 进程存活通过 检测，手动远程 Worker 通过心跳超时检测（2 分钟）。 环境变量 变量 说明 Worker 类型（interactive / bg / daemon） 后台会话显示名称 后台会话日志路径 认证模式（none / password） 使用场景 开发服务器常驻 日常开发时启动一次 daemon，之后通过浏览器或 API 随时与 AI 交互，不用每次都打开终端。 CI/CD 自动化后端 在 CI 流水线中启动 daemon 作为 Agent 服务，其他步骤通过 HTTP API 调用它执行代码审查、测试生成等任务。 多人共享 Agent 一台开发机上启动 daemon 绑定局域网地址，团队成员通过 Web UI 共同使用同一个 Agent 环境。 后台批量任务 用 同时启动多个后台会话处理不同任务，通过 / / 管理。 微信/企业微信机器人后端 daemon 常驻运行作为聊天机器人的后端服务，通过长连接接收消息。 IDE 扩展后端 IDE 插件通过 ACP 协议连接到 daemon，提供 AI 编程辅助，避免每次打开 IDE 都重新启动 CLI 进程。 与 serve 的区别 特性 生命周期 跟随终端，关闭终端则退出 后台常驻，独立于终端 启动方式 前台运行 fork detached 子进程 管理方式 Ctrl+C 停止 多次启动 每次创建新进程 幂等，只维护一个 daemon 典型用途 临时开发调试 长期运行的服务"},{"id":"/cli/security","title":"安全","body":"安全 了解 CodeBuddy Code 的安全防护措施和安全使用最佳实践。 安全方法 安全基础 您的代码安全至关重要。CodeBuddy Code 将安全作为核心构建，遵循腾讯的全面安全计划开发。 基于权限的架构 CodeBuddy Code 默认使用严格的只读权限。当需要额外操作（编辑文件、运行测试、执行命令）时，CodeBuddy Code 会请求明确的权限。用户可以控制是一次性批准操作还是自动允许。 我们将 CodeBuddy Code 设计得透明且安全。例如，我们在执行 bash 命令之前需要批准，让您拥有直接控制权。这种方法使用户和组织能够直接配置权限。 有关详细的权限配置，请参阅 。 内置保护 为了降低智能代理系统中的风险： 沙箱化 bash 工具: 隔离 bash 命令的文件系统和网络访问，减少权限提示的同时保持安全性。使用 启用以定义 CodeBuddy Code 可以自主工作的边界 写入访问限制: CodeBuddy Code 只能写入其启动的文件夹及其子文件夹——没有明确权限不能修改父目录中的文件。虽然 CodeBuddy Code 可以读取工作目录外的文件（对访问系统库和依赖项很有用）,但写入操作严格限制在项目范围内，创建了清晰的安全边界 提示疲劳缓解：支持按用户、按代码库或按组织将频繁使用的安全命令加入白名单 接受编辑模式：批量接受多个编辑，同时保持对具有副作用的命令的权限提示 用户责任 CodeBuddy Code 只拥有您授予它的权限。您有责任在批准之前审查建议的代码和命令的安全性。 防范提示注入 提示注入是一种攻击技术，攻击者试图通过插入恶意文本来覆盖或操纵 AI 助手的指令。CodeBuddy Code 包含多种针对这些攻击的防护措施： 核心保护 权限系统：敏感操作需要明确批准 上下文感知分析：通过分析完整请求检测潜在有害指令 输入清理：通过处理用户输入防止命令注入 命令阻止列表：默认阻止从网络获取任意内容的风险命令，如 和 。当明确允许时，请注意 隐私保护 我们实施了多项保护措施来保护您的数据，包括： 敏感信息的有限保留期 限制访问用户会话数据 有关完整详情,请查看我们的 和 。 额外保护措施 网络请求批准：发出网络请求的工具默认需要用户批准 隔离的上下文窗口: Web 获取使用单独的上下文窗口，以避免注入潜在的恶意提示 信任验证：首次运行代码库和新的 MCP 服务器需要信任验证 注意： 使用 标志非交互式运行时，信任验证被禁用 命令注入检测：可疑的 bash 命令即使之前已加入白名单也需要手动批准 失败关闭匹配：不匹配的命令默认需要手动批准 自然语言描述：复杂的 bash 命令包含解释以便用户理解 安全凭据存储: API 密钥和令牌经过加密。参见 <Warning Windows WebDAV 安全风险: 在 Windows 上运行 CodeBuddy Code 时,我们建议不要启用 WebDAV 或允许 CodeBuddy Code 访问可能包含 WebDAV 子目录的路径,如 。 %20service%20is%20deprecated)由于安全风险。启用 WebDAV 可能允许 CodeBuddy Code 触发对远程主机的网络请求,绕过权限系统。 </Warning 处理不受信任内容的最佳实践: 1. 批准前审查建议的命令 2. 避免将不受信任的内容直接传输到 CodeBuddy 3. 验证对关键文件的建议更改 4. 使用虚拟机(VM)运行脚本和进行工具调用，特别是在与外部 Web 服务交互时 <Warning 虽然这些保护措施显著降低了风险，但没有系统能完全免疫所有攻击。在使用任何 AI 工具时，始终保持良好的安全实践。 </Warning MCP 安全 CodeBuddy Code 允许用户配置模型上下文协议(MCP)服务器。允许的 MCP 服务器列表在源代码中配置，作为工程师检入源代码控制的 CodeBuddy Code 设置的一部分。 我们鼓励编写您自己的 MCP 服务器或使用您信任的提供商的 MCP 服务器。您可以为 MCP 服务器配置 CodeBuddy Code 权限。CodeBuddy 不管理或审计任何 MCP 服务器。 详见 。 沙箱安全 CodeBuddy Code 支持 Bash 沙箱功能，将 bash 命令与您的文件系统和网络隔离： 沙箱隔离级别 文件系统隔离：通过 Read/Edit 权限控制文件访问 网络隔离：通过 WebFetch 权限控制网络访问 命令隔离：某些命令可以配置为在沙箱外运行 沙箱配置 沙箱限制 平台支持：目前仅支持 macOS 和 Linux 性能影响：沙箱化可能略微影响命令执行性能 兼容性：某些工具可能在沙箱中无法正常工作 详见 了解"},{"id":"/cli/iam","title":"身份和访问管理","body":"身份和访问管理 了解如何为组织中的 CodeBuddy Code 配置用户身份验证、授权和访问控制。 认证方法 快速开始 根据你的场景选择认证方式： 场景 推荐方式 如何获取凭据 : : : 个人开发者 企业/团队（OAuth 集成） CI/CD 已有 OAuth token 直接使用已有 token 第三方模型服务 + 从第三方服务商获取 当多个认证方式同时配置时，按以下优先级生效：CODEBUDDYAUTHTOKEN apiKeyHelper CODEBUDDYAPIKEY 企业用户：OAuth 认证 适用于企业/团队集成，通过 OAuth 2.0 获取 token。 目前仅介绍 Client Credentials 授权方式，适用于服务端应用和 CI/CD 场景。 前提条件：企业用户需要先购买 CodeBuddy 旗舰版才能使用 OAuth 认证。详见 。 第 1 步：创建应用，获取 Client ID 和 Secret 参考 完成： 1. 创建企业应用 2. 获取 Client ID 和 Client Secret 第 2 步：创建获取 token 的脚本 第 3 步：配置 apiKeyHelper 在 或项目 中配置： 配置完成后即可使用 命令。 apiKeyHelper 获取的 token 默认缓存 5 分钟，可通过 环境变量调整（单位：毫秒）。 认证方式详解 CODEBUDDYAPIKEY 静态 API Key，适用于大部分场景。 特性 说明 : : 环境变量 认证类型 API Key（X Api Key 请求头） 适用场景 个人开发、第三方模型服务 ⚠️ 注意：使用 API Key 时，必须同时配置 环境变量！ 版本 配置值 : : 海外版 不设置（默认） 中国版 iOA 版 CODEBUDDYAUTHTOKEN 已获取的 OAuth Bearer Token，适用于 CI/CD 或已有 token 的场景。 特性 说明 : : 环境变量 认证类型 Bearer Token（Authorization 请求头） 适用场景 CI/CD 自动化、已有 OAuth token 也可以在 settings.json 中配置： apiKeyHelper 通过脚本动态获取 token，适用于 OAuth 集成或需要定期刷新 token 的场景。 特性 说明 : : 配置方式 settings.json 的 字段 认证类型 Bearer Token（由脚本返回） 缓存机制 默认 5 分钟，可通过 配置 适用场景 OAuth Client Credentials、Vault 集成、token 自动刷新 脚本要求： 将 token 输出到标准输出（stdout） 以退出码 0 表示成功 脚本执行超时时间为 30 秒 配置示例： 从 Vault 获取 token 示例： 详细的认证配置请参考 。 访问控制和权限 我们支持细粒度权限，以便您可以精确指定代理允许执行的操作（例如运行测试、运行 linter)和不允许执行的操作（例如更新云基础设施）。这些权限设置可以检入版本控制并分发给组织中的所有开发人员，也可以由各个开发人员自定义。 权限系统 CodeBuddy Code 使用分层权限系统来平衡功能和安全性： 工具类型 示例 需要批准 \"是，不再询问\"行为 : : : : 只读 文件读取、LS、Grep 否 N/A Bash 命令 Shell 执行 是 按项目目录和命令永久记住 文件修改 编辑/写入文件 是 会话结束前有效 配置权限 您可以使用 查看和管理 CodeBuddy Code 的工具权限。此 UI 列出所有权限规则及其来源的 settings.json 文件。 Allow 规则将允许 CodeBuddy Code 使用指定的工具，无需进一步手动批准。 Ask 规则将在 CodeBuddy Code 尝试使用指定工具时询问用户确认。Ask 规则优先于 allow 规则。 Deny 规则将阻止 CodeBuddy Code 使用指定工具。Deny 规则优先于 allow 和 ask 规则。 Additional directories 将 CodeBuddy 的文件访问扩展到初始工作目录之外的目录。 Default mode 控制 CodeBuddy 在遇到新请求时的权限行为。 权限规则使用格式： 或 仅工具名称的规则匹配该工具的任何使用。例如，将 添加到 allow 规则列表将允许 CodeBuddy Code 使用 Bash 工具而无需用户批准。 权限模式 CodeBuddy Code 支持几种权限模式，可以在 中设置为 : 模式 描述 : : 标准行为 首次使用每个工具时提示权限 自动接受会话的文件编辑权限 计划模式 Co"},{"id":"/cli/bash-sandboxing","title":"Bash 沙箱","body":"Bash 沙箱 了解 CodeBuddy Code 的沙箱化 Bash 工具如何提供文件系统和网络隔离，实现更安全、更自主的智能体执行。 概述 CodeBuddy Code 具有原生沙箱功能，为智能体执行提供更安全的环境，同时减少持续的权限提示。沙箱不需要为每个 bash 命令请求权限，而是预先创建定义好的边界，让 CodeBuddy Code 可以在降低风险的情况下更自由地工作。 沙箱化 Bash 工具使用操作系统级原语来强制执行文件系统和网络隔离。 为什么沙箱很重要 传统的基于权限的安全性需要持续的用户批准才能执行 bash 命令。虽然这提供了控制，但可能导致： 审批疲劳：重复点击\"批准\"可能导致用户对批准的内容关注度降低 降低生产力：持续的中断会减慢开发工作流程 有限的自主性：在等待批准时，CodeBuddy Code 无法高效工作 沙箱通过以下方式解决这些挑战： 1. 定义清晰的边界：明确指定 CodeBuddy Code 可以访问哪些目录和网络主机 2. 减少权限提示：沙箱内的安全命令不需要批准 3. 保持安全性：访问沙箱外资源的尝试会立即触发通知 4. 实现自主性: CodeBuddy Code 可以在定义的限制内更独立地运行 <Warning 有效的沙箱需要同时具备文件系统和网络隔离。没有网络隔离，受损的智能体可能会窃取敏感文件（如 SSH 密钥）。没有文件系统隔离，受损的智能体可能会后门系统资源以获得网络访问。配置沙箱时，确保你的配置设置不会在这些系统中创建绕过方式非常重要。 </Warning 工作原理 文件系统隔离 沙箱化 Bash 工具将文件系统访问限制在特定目录： 默认写入行为：对当前工作目录及其子目录具有读写访问权限 默认读取行为：对整个计算机具有读取访问权限，除了某些被拒绝的目录 阻止访问：未经明确许可，无法修改当前工作目录之外的文件 可配置：通过设置定义自定义的允许和拒绝路径 网络隔离 网络访问通过在沙箱外运行的代理服务器控制： 域限制：只能访问批准的域 用户确认：新的域请求会触发权限提示 自定义代理支持：高级用户可以对出站流量实施自定义规则 全面覆盖：限制适用于命令生成的所有脚本、程序和子进程 操作系统级强制执行 沙箱化 Bash 工具利用操作系统安全原语： Linux: 使用 进行隔离 macOS：使用 Seatbelt 进行沙箱强制执行 这些操作系统级限制确保 CodeBuddy Code 命令生成的所有子进程都继承相同的安全边界。 入门 启用沙箱 你可以通过运行 斜杠命令来启用沙箱： 这将使用默认设置激活沙箱化 Bash 工具，允许访问当前工作目录，同时阻止访问敏感的系统位置。 配置沙箱 通过 文件自定义沙箱行为。完整的配置参考请参阅 。 <Tip 并非所有命令都能开箱即用地与沙箱兼容。以下一些注意事项可能帮助你充分利用沙箱： 许多 CLI 工具需要访问某些主机。当你使用这些工具时，它们会请求访问某些主机的权限。授予权限将允许它们现在和将来访问这些主机，使它们能够在沙箱内安全执行。 与在沙箱中运行不兼容。如果你正在运行 ,请考虑使用 与在沙箱中运行不兼容。考虑在 中指定 以强制其在沙箱外运行。 </Tip <Note CodeBuddy Code 包含一个有意设置的逃生舱机制，允许在必要时在沙箱外运行命令。当命令因沙箱限制（如网络连接问题或不兼容的工具）而失败时，CodeBuddy 会被提示分析失败，并可能使用 参数重试命令。使用此参数的命令会经过正常的 CodeBuddy Code 权限流程，需要用户权限才能执行。这允许 CodeBuddy Code 处理某些工具或网络操作无法在沙箱约束内运行的边缘情况。 你可以通过在 中设置 来禁用此逃生舱。禁用后, 参数会被完全忽略,所有命令必须在沙箱中运行或明确列在 中。 </Note 沙箱自动批准 在 AcceptEdits 权限模式下，CodeBuddy Code 提供了沙箱自动批准功能，进一步减少权限提示： 工作原理 当启用沙箱自动批准时，满足以下所有条件的 Bash 命令将自动批准执行，无需用户确认： 1. 当前处于 AcceptEdits 权限模式 2. 沙箱已启用 ( ) 3. 自动批准配置已开启 ( ) 4. 命令将在沙箱中运行 （不在 列表中） 5. 未使用 dangerouslyDisableSandbox 参数 配置示例 在 中启用沙箱自动批准： 使用场景 自动批准 （无需用户确认）: 需要批准 （以下情况仍需用户确认）: 安全保障 沙箱自动批准在保持安全的同时提升效率： ✅ 只在沙箱环境内：只有沙箱化的命令才能自动批准 ✅ 文件系统隔离：命令只能访问允许的目录 ✅ 网络隔离：命令只能访问批准的域名 ✅ 可配置边界：通过 排除高"},{"id":"/cli/cli-reference","title":"CLI 参考","body":"CLI 参考 CodeBuddy Code 命令行工具完整参考手册，包含所有命令和参数说明。 CLI 命令 命令 说明 示例 : : : 启动交互式 REPL 带初始提示词启动 REPL 通过 SDK 查询后退出 处理管道内容 继续最近的对话 通过 SDK 继续对话 通过 ID 恢复会话 更新到最新版本 配置 Model Context Protocol (MCP) 服务器 参见 启动 Daemon 守护进程 停止 Daemon 查看 Daemon 状态 重启 Daemon 列出所有活跃 Worker 进程 查看 Worker 日志 附加到后台 Worker 终止 Worker 进程 CLI 参数 自定义 CodeBuddy Code 行为的命令行参数： 参数 说明 示例 : : : 添加额外的工作目录供 CodeBuddy 访问（验证每个路径是否存在） 通过 JSON 动态定义自定义 （格式见下文） 除了 外,无需提示用户即可允许的工具列表 除了 外,应禁止使用的工具列表 限制可用的内置工具集（白名单）。空字符串 禁用所有内置工具， 使用全部工具，或指定逗号分隔的工具名 , 打印响应后退出,不进入交互模式 从 JSON 文件或 JSON 字符串加载额外的设置配置 指定要加载的设置源,逗号分隔（可选值: , , ）。默认: 用自定义文本替换整个系统提示词（在交互和打印模式下都可用） 从文件加载系统提示词,替换默认提示词(仅打印模式) 在默认系统提示词末尾追加自定义文本（在交互和打印模式下都可用） 指定打印模式的输出格式(选项: , , ) 指定打印模式的输入格式(选项: , ) 使用 JSON Schema 验证结构化输出。示例: 在输出中包含部分流式事件（需要 和 ) 启用详细日志记录,显示完整的轮次输出(在打印和交互模式下都有助于调试) 限制非交互模式下的代理轮次数 使用别名设置当前会话的模型，如最新模型的别名（ 或 ）或模型全名 设置文生图功能使用的模型 ID 设置图生图功能使用的模型 ID 以指定的 开始 指定在非交互模式下处理权限提示的 MCP 工具 通过 ID 恢复特定会话,或在交互模式下选择 加载当前目录中最近的对话 / 跳过权限提示（谨慎使用） 或 启动时自动连接到 IDE（如果恰好有一个有效的 IDE 可用且打开了当前工作目录） 在沙箱中运行 CodeBuddy（详见下方 ) 启用调试模式,支持可选的类别过滤 在独立的 git worktree 中运行（详见 ） 或 在 tmux 会话中运行（与 配合使用） 从本地目录加载插件（用于开发/测试），可指定多个路径。详见 后台运行会话（detached 模式），日志输出到 。详见 后台会话名称（与 配合使用，便于通过 / / 查找） 启动 HTTP 服务（Web UI、REST API、ACP 协议） 重要提示：在使用 参数进行非交互式执行时,涉及文件读写、命令执行、网络请求等操作通常需要添加 （或 )参数才能执行，否则操作会被阻止。 <Tip 参数特别适用于脚本和自动化，允许您以编程方式解析 CodeBuddy 的响应。 </Tip Agents 参数格式 参数接受定义一个或多个自定义子代理的 JSON 对象。每个子代理需要一个唯一的名称（作为键）和一个包含以下字段的定义对象： 字段 必需 说明 : : : 是 何时应调用子代理的自然语言描述 是 指导子代理行为的系统提示词 否 子代理可以使用的特定工具数组（如 )。省略则继承所有工具 否 要使用的模型别名: 、 或 。省略则使用默认子代理模型 示例： 有关创建和使用子代理的更多详细信息，请参见 。 系统提示词参数 CodeBuddy Code 提供三个自定义系统提示词的参数，每个参数用途不同： 参数 行为 模式 使用场景 : : : : 替换整个默认提示词 交互 + 打印模式 完全控制 CodeBuddy 的行为和指令 用文件内容替换 仅打印模式 从文件加载提示词以确保可重现性和版本控制 追加到默认提示词 交互 + 打印模式 添加特定指令同时保留默认 CodeBuddy Code 行为 何时使用： ：当您需要完全控制 CodeBuddy 的系统提示词时使用。这会移除所有默认 CodeBuddy Code 指令，给您一个空白画布。 ：当您想从文件加载自定义提示词时使用，适用于团队一致性或版本控制的提示词模板。 ：当您想添加特定指令同时保留 CodeBuddy Code 的默认功能时使用。这是大多数用例的最安全选项。 <Note 和 互斥。不能同时使用这两个参数。 </Note <Tip 对于大多数用例，建议使用 ,因为它在添加自定义需求的同时保留了 CodeBuddy Code 的内置功能。仅当需要完全控制系统提"},{"id":"/cli/hooks","title":"Hook 参考指南","body":"Hook 参考指南 版本要求：本文档针对 CodeBuddy Code v1.16.0 及以上版本中提供的 Claude Code Hooks 兼容实现。 功能状态：Hook 功能当前处于 Beta 阶段，接口和行为可能在未来版本中调整。 Hook（钩子）允许你在 CodeBuddy Code 的会话生命周期内插入自定义脚本或命令，实现自动化校验、环境初始化、合规检查等高级能力。我们的实现完全兼容 Claude Code Hooks 规范，支持相同的事件类型、输入输出结构以及安全特性。 配置 CodeBuddy Code hooks 存储在你的设置文件中： 作用域 文件路径 说明 用户级 适用于所有项目 项目级 对项目成员共享的配置 项目本地 本地未提交配置 企业策略 集成发布的策略文件 受企业统一管理 配置合并规则：来自不同作用域的 hooks 会合并而非覆盖。同一事件的所有匹配 hooks 都会并行执行。 结构 Hooks 按匹配器组织，每个匹配器可以有多个 hooks: 关键字段： matcher：用于匹配工具名称的正则表达式模式，区分大小写（仅适用于 PreToolUse 和 PostToolUse) 简单字符串匹配： 会匹配任何包含 \"Write\" 的工具名（如 、 ） 精确匹配：使用 仅匹配 Write 工具 多工具匹配： 或 匹配所有工具：以下三种方式等效 使用 字符 使用空字符串 省略 matcher 字段 hooks：当模式匹配时执行的 hooks 数组 type: Hook 执行类型 用于 shell 命令，或 用于基于 LLM 的评估 command: （对于 type: ）要执行的 shell 命令（可以使用 环境变量）。在 macOS/Linux 上使用用户默认 shell（ ）执行，在 Windows 上强制使用 Git Bash 执行（不支持 cmd.exe 或 PowerShell），因此命令需兼容 bash 语法 prompt: （对于 type: ）发送给 LLM 进行评估的提示词（仅支持 、 、 事件） timeout: （可选）hook 运行多长时间（以秒为单位）后取消该特定 hook 对于不使用匹配器的事件（如 UserPromptSubmit、Stop 和 SubagentStop)，你可以省略 matcher 字段： 项目特定的 Hook 脚本 你可以使用环境变量 （仅在 CodeBuddy Code 生成 hook 命令时可用）来引用存储在项目中的脚本： 提示：如果你的 hook 脚本是 Python 文件，请显式使用 来调用，而不是直接执行 文件。因为在 Windows 上即使脚本包含 shebang 行（ ），Git Bash 也不一定能正确识别： 插件 Hooks 插件可以提供与用户和项目 hooks 无缝集成的 hooks。启用插件时，插件 hooks 会自动与你的配置合并。 插件 hooks 的工作方式： 插件 hooks 在插件的 文件中定义，或在 hooks 字段提供的自定义路径的文件中定义 当插件启用时，其 hooks 会与用户和项目 hooks 合并 来自不同来源的多个 hooks 可以响应同一事件 插件 hooks 使用 环境变量来引用插件文件 插件 hook 配置示例： 基于提示词的 Hooks 除了 bash 命令 hooks（ ），CodeBuddy Code 还支持基于提示词的 hooks（ ），使用 LLM 来评估是否允许或阻止某个操作。 支持的事件：目前仅支持 、 和 三种事件。 基于提示词的 hooks 如何工作 基于提示词的 hooks 不是执行 bash 命令，而是： 1. 将 hook 输入和你的提示词发送给快速 LLM（Haiku） 2. LLM 使用包含决策的结构化 JSON 响应 3. CodeBuddy Code 自动处理决策 支持的事件 事件 用途 智能决定 CodeBuddy 是否应继续工作 使用 LLM 协助验证用户提示 做出上下文感知的权限决策 与 Command Hook 的比较 特性 Command Hooks Prompt Hooks 执行方式 运行 bash 脚本 查询 LLM 决策逻辑 你在代码中实现 LLM 评估上下文 设置复杂性 需要脚本文件 只需配置提示词 上下文感知 受脚本逻辑限制 自然语言理解 性能 快速（本地执行） 较慢（API 调用） 适用场景 确定性规则 上下文感知决策 配置 字段： type：必须为 prompt：发送给 LLM 的提示词文本 使用 作为 hook 输入 JSON 的占位符，会被直接替换 如果不存在 ，输入 JSON 会以 格式追加到提示词末尾 timeout: （可选） 超时时间"},{"id":"/cli/plugins-reference","title":"CodeBuddy 插件参考文档","body":"CodeBuddy 插件参考文档 完整的 CodeBuddy 插件系统技术参考，包括组件规范、CLI 命令和开发工具。 插件是一个自包含的组件目录，用于扩展 CodeBuddy 的自定义功能。插件组件包括技能 (Skills)、代理 (Agents)、钩子 (Hooks)、MCP 服务器和 LSP 服务器。 name: agent name description: 代理的专长和调用时机 model: sonnet effort: medium maxTurns: 20 disallowedTools: Write, Edit 二、插件安装作用域 安装插件时，选择一个作用域来决定插件的可用范围： 作用域 设置文件 使用场景 : : : 个人插件，所有项目可用（默认） 团队插件，通过版本控制共享 项目特定插件，被 gitignore 托管设置 托管插件（只读，仅支持更新） 插件使用与其他 CodeBuddy 配置相同的作用域系统。详见 。 三、插件清单架构（plugin.json） （或 ）文件定义插件的元数据和配置。本节记录所有支持的字段和选项。 清单是可选的。如果省略，CodeBuddy 会自动发现 中的组件，并从目录名派生插件名称。当需要提供元数据或自定义组件路径时使用清单。 完整架构示例 必需字段 如果包含清单， 是唯一必需字段。 字段 类型 描述 示例 string 唯一标识符（kebab case，无空格） 此名称用于组件命名空间。例如在 UI 中，插件 的代理 将显示为 。 元数据字段 字段 类型 描述 示例 string 语义化版本。如果在 marketplace 条目中也设置了， 优先。只需在一处设置。 string 插件用途简述 object 作者信息 string 文档 URL string 源代码 URL string 许可证标识符 , array 发现标签 组件路径字段 字段 类型 描述 示例 string \\ array 自定义命令文件/目录（替换默认 ） 或 string \\ array 自定义代理文件（替换默认 ） string \\ array 自定义技能目录（替换默认 ） string \\ array \\ object 钩子配置路径或内联配置 string \\ array \\ object MCP 配置路径或内联配置 string \\ array 自定义输出样式文件/目录（替换默认 ） string \\ array \\ object LSP 配置路径或内联配置 object 启用时提示用户配置的值。详见 见下方 array 消息注入的频道声明。详见 见下方 用户配置 字段声明在插件启用时 CodeBuddy 提示用户输入的值。用此替代要求用户手动编辑 。 键必须是有效标识符。每个值可作为 在 MCP 和 LSP 服务器配置、钩子命令中替换，以及（仅非敏感值）在技能和代理内容中替换。值也作为 环境变量导出到插件子进程。 非敏感值存储在 的 中。敏感值存储到系统密钥链（或在密钥链不可用时存储到 ）。密钥链存储与 OAuth 令牌共享，总限制约 2 KB，因此敏感值应保持较小。 频道 字段允许插件声明一个或多个消息频道，用于向对话中注入内容。每个频道绑定到插件提供的一个 MCP 服务器。 字段是必需的，必须匹配插件 中的一个键。可选的按频道 使用与顶层相同的 schema，允许在启用插件时提示输入 bot token 或 owner ID。 路径行为规则 对于 、 、 和 ，自定义路径会替换默认目录。如果清单指定了 ，则不会扫描默认的 目录。Hooks、MCP servers 和 LSP servers 对处理多个来源有不同的语义。 所有路径必须相对于插件根目录并以 开头 自定义路径中的组件使用相同的命名和命名空间规则 可以将多个路径指定为数组 要保留默认目录并添加更多路径，在数组中包含默认目录： 路径示例: 环境变量 CodeBuddy 提供两个变量用于引用插件路径。两者都在技能内容、代理内容、钩子命令、MCP 或 LSP 服务器配置中的任何位置进行内联替换。两者也作为环境变量导出到钩子进程和 MCP 或 LSP 服务器子进程。 ：插件安装目录的绝对路径。用于引用插件捆绑的脚本、二进制文件和配置文件。此路径在插件更新时会变化，因此写入此处的文件不会在更新后保留。 兼容性：同时支持 变量名以兼容 Claude Code 插件。 ：用于插件状态的持久化目录，在更新后保留。用于已安装的依赖项（如 或 Python 虚拟环境）、生成的代码、缓存以及任何需要跨插件版本持久化的文件。首次引用时自动创建该目录。 兼容性：同时支持 变量名。 持久化数据目录 目录解析为 ，其中 是插件标识符， 、 、 、 和 之外的"},{"id":"/cli/costs","title":"成本管理","body":"成本管理 通过多场景模型选择和异步压缩策略优化成本，在保证效果的同时实现更快的响应速度和更低的使用成本。 CodeBuddy Code 每次交互都会消耗 Token。成本因代码库大小、查询复杂度和对话长度而异。本文档介绍如何追踪成本、多场景模型机制和降低 Token 消耗。 追踪成本 使用 /cost 命令 命令提供当前会话的详细 Token 使用统计： 使用 /context 命令 命令可以分析当前上下文的占用情况，查看不同类型上下文的大小分布： 通过 可以快速识别哪些内容占用了大量上下文空间，从而有针对性地优化。 多场景模型机制 不同的任务场景对模型能力的要求不同。简单的文件搜索、快速查询等任务使用轻量级模型即可完成；复杂的架构设计、多步骤推理等任务需要更强大的推理模型。 通过为不同场景自动选择不同的模型，可以实现： 效果最优：复杂任务使用高能力模型，确保质量 速度更快：简单任务使用轻量模型，响应更迅速 成本更低：避免在简单任务上使用昂贵的高端模型 场景类型 场景类型 说明 典型用例 : : : 默认模型，平衡性能与成本 一般编程任务、代码编写 轻量快速模型，低成本高速度 文件搜索、简单查询、快速操作 推理增强模型，强大分析能力 复杂分析、架构决策、多步骤推理 自动模型选择 CodeBuddy Code 会根据任务类型自动选择合适的场景模型。当子代理执行时，系统会根据用户当前选择的主模型，自动解析出对应的场景模型。 例如， 等轻量级子代理会自动使用 模型，在保证功能的同时降低成本、提升速度。 Agent 工具支持通过 参数指定场景类型： ：继承父模型，适用于一般任务 ：快速且低成本，适用于简单搜索、快速文件操作 ：增强推理能力，适用于复杂分析、架构决策 降低 Token 消耗 Token 成本随上下文大小增长：CodeBuddy Code 处理的上下文越大，消耗的 Token 越多。CodeBuddy Code 通过 Prompt 缓存（减少重复内容如系统提示的成本）和自动压缩（在接近上下文限制时压缩对话历史）自动优化成本。 以下策略帮助你保持较小的上下文，降低每条消息的成本。 主动管理上下文 使用 检查当前 Token 使用情况。 任务间清理：切换到不相关的工作时使用 重新开始。过时的上下文会在后续每条消息中浪费 Token。清理前使用 以便之后通过 返回。 添加自定义压缩指令： 告诉 CodeBuddy Code 在压缩时保留什么内容。 你也可以在 CODEBUDDY.md 中自定义压缩行为： 异步压缩策略 当对话历史接近上下文限制时，系统会自动进行压缩： 自动触发：当上下文接近限制时自动启动压缩 后台执行：压缩过程在后台异步执行，不阻塞用户操作 智能摘要：保留关键信息，压缩冗余内容 无缝衔接：用户无感知，获得\"无限上下文\"体验 压缩时会保留以下关键信息：代码变更记录、重要决策点、用户明确的偏好和指示、当前任务的关键上下文。 选择合适的模型 根据任务复杂度选择模型。使用 在会话中切换模型，或在 中设置默认值。 简单任务使用 lite：文件搜索、快速查询、代码格式化 复杂任务使用 reasoning：架构设计、性能优化、复杂调试 一般任务使用 default：日常编码、功能实现 减少 MCP 服务器开销 每个 MCP 服务器会将工具定义添加到上下文中，即使处于空闲状态。运行 查看已配置的服务器。 优先使用 CLI 工具： 、 、 等工具比 MCP 服务器更节省上下文，因为它们不会添加持久的工具定义。CodeBuddy Code 可以直接运行 CLI 命令，无需额外开销。 禁用未使用的服务器：运行 查看并禁用未使用的服务器。 将详细操作委托给子代理 运行测试、获取文档或处理日志文件可能消耗大量上下文。将这些操作委托给子代理，详细输出保留在子代理的上下文中，只有摘要返回主对话。 编写精确的提示 模糊的请求如\"改进这个代码库\"会触发大范围扫描。精确的请求如\"为 auth.ts 中的 login 函数添加输入验证\"让 CodeBuddy Code 能够以最少的文件读取高效工作。 复杂任务的高效工作方式 对于较长或更复杂的工作，以下习惯有助于避免因走错方向而浪费 Token： 复杂任务使用计划模式：按 Shift+Tab (macOS/Linux) 或 Alt+M (Windows) 进入计划模式。CodeBuddy Code 会探索代码库并提出方案供你批准，避免初始方向错误时的昂贵返工。 尽早纠正方向：如果 CodeBuddy Code 开始走错方向，按 Escape 立即停止。使用 或双击 Escape 将对话和代码恢复到之前的检查点。 提供验证目标：在提示中包含测试用例、截图或预期输出。当 CodeBuddy Code 能够"},{"id":"/cli/tools-reference","title":"工具参考","body":"工具参考 CodeBuddy Code 可用工具的完整参考，包括权限要求。 CodeBuddy Code 内置一系列工具来帮助理解和修改代码库。下表中的工具名称即为 、 和 中使用的标识符。 工具 说明 需要权限 : : : 生成具有独立上下文窗口的 来处理任务 否 向用户提出多选问题，收集需求或澄清歧义 是 在你的环境中执行 Shell 命令。参见 是 在当前会话内调度定时或一次性任务（退出后失效）。参见 否 按 ID 取消定时任务 否 列出当前会话中所有定时任务 否 执行通过 发现的延迟加载工具 否 对文件进行精确的字符串替换编辑 是 切换到计划模式，在编码前设计实现方案 否 创建隔离的 并切换到其中 是 提交计划供用户审批并退出计划模式 是 基于 glob 模式查找文件 否 在文件内容中搜索正则表达式模式 否 基于文本指令编辑或修改已有图片 是 根据文本描述生成图片 是 退出 worktree 会话并返回原始目录 是 通过语言服务器提供代码智能。文件编辑后自动报告类型错误和警告。还支持跳转定义、查找引用、获取类型信息、列出符号、查找实现、追踪调用层级等导航操作。需要 及其语言服务器二进制文件 否 在单个原子操作中对同一文件执行多步编辑 是 修改 Jupyter notebook 单元格内容 是 在 Windows 上执行 PowerShell 命令。仅 Windows 可用，参见 是 读取文件内容，支持图片、PDF 和 Jupyter notebook 否 在 中向队友发送消息 否 在主对话中执行 否 执行自定义 是 返回符合 JSON Schema 的结构化输出 否 创建新任务到任务列表 否 获取特定任务的完整详情 否 列出所有任务及其当前状态 否 获取后台任务或子代理的输出 否 按 ID 终止正在运行的后台任务 否 更新任务状态、依赖、详情或删除任务 否 创建 以协调多个代理协作 否 删除 Agent 团队及其任务目录 否 搜索并加载延迟加载的工具，支持内置工具和 否 获取指定 URL 的内容并进行 AI 分析 是 执行网络搜索 是 创建或覆盖文件 是 权限规则可通过 命令或在 中配置。另请参阅 。 工具别名 部分工具拥有别名，可在权限规则中互换使用： 工具 别名 : : 、 Bash 工具行为 Bash 工具在独立进程中执行每条命令，具有以下持久化特性： 工作目录在命令间保持不变。设置 可在每次命令后重置到项目目录。 环境变量不会持久化。一条命令中的 不会在下一条命令中生效。 在启动 CodeBuddy Code 前激活你的 virtualenv 或 conda 环境。要使环境变量在 Bash 命令间持久化，启动前设置 指向一个 shell 脚本，或使用 动态填充。 沙箱模式 Bash 工具支持 ，可限制文件系统和网络访问。启用沙箱时，命令在受限环境中执行，防止未授权的系统访问。 通过 参数可逐条命令绕过沙箱（需要用户审批）。 后台执行 通过 参数可将命令在后台运行，使用 工具读取输出。适用于长时间运行的构建、测试等场景。 PowerShell 工具行为 PowerShell 工具仅在 Windows 上可用，提供原生 PowerShell 命令执行能力。 与 Bash 工具的关系 有 Git Bash 时：Bash 工具和 PowerShell 工具同时可用，模型根据场景选择合适的工具 无 Git Bash 时：Bash 工具自动禁用，PowerShell 工具成为唯一的 shell 工具 macOS/Linux 上 PowerShell 工具不可用 版本适配 PowerShell 工具自动检测 PowerShell 版本，优先使用 PowerShell 7+（pwsh），其次使用 Windows PowerShell 5.1。prompt 中的语法指导会根据版本差异自动调整（如 操作符仅 7+ 支持）。 安全检查 PowerShell 工具内置安全检查器，覆盖代码注入、下载执行、提权操作、系统破坏等危险模式。危险命令（如 、 ）会被阻止，系统修改类命令需要用户确认。 环境变量 环境变量 说明 显式指定 PowerShell 路径（优先于自动检测） 设为 禁用 PowerShell 工具 延迟加载工具 部分工具（如通过 提供的工具）采用延迟加载机制。这些工具不会在初始工具列表中出现，需要通过 发现和激活。一旦激活，工具在会话剩余时间内保持可用。 通过产品配置可以将内置工具设置为延迟加载： 另请参阅 ：权限系统、规则语法和工具特定规则 ：为子代理配置工具访问权限 ：在工具执行前后运行自定义命令 ：通过 MCP 服务器扩展可用工具 ：使用 CronCreate 调度自动化任务 ：多代理协作的团队系统"},{"id":"/cli/channels-reference","title":"Channels 参考 [Beta]","body":"Channels 参考 [Beta] Beta 功能：Channels 目前处于 Beta 阶段，协议和接口可能会根据反馈进行调整。 Channel 是一种特殊的 MCP 服务器，可以将外部事件（Webhook、聊天消息、监控告警等）推送到 CodeBuddy Code 会话中，让 CodeBuddy Code 对终端外部发生的事情做出反应。 概述 Channel 运行在与 CodeBuddy Code 相同的机器上，通过 stdio 与 CodeBuddy Code 通信。CodeBuddy Code 将其作为子进程启动。 典型的使用场景： 聊天平台（Telegram、Discord）：插件本地运行，轮询平台 API 获取新消息，转发给 CodeBuddy Code Webhook（CI、监控）：服务器监听本地 HTTP 端口，接收外部系统的 POST 请求，推送给 CodeBuddy Code Channel 分为两种模式： 模式 说明 单向 只转发事件给 CodeBuddy Code（告警、Webhook），在本地会话中处理 双向 额外暴露 reply 工具，让 CodeBuddy Code 可以回复消息 使用 Channel 启动 使用 参数指定要加载的 channel： 开发模式 自定义 channel 在初始阶段使用 标志来测试。此标志允许任何 channel 运行，无需在允许列表中： 此标志仅绕过允许列表检查， 组织策略仍然生效。一旦 channel 提交到官方市场并通过安全审查，就会被添加到允许列表，之后可以直接使用 加载。 会话中的 Channel 消息 Channel 消息以 标签的形式注入到 CodeBuddy Code 的上下文中： 在 TUI 中，channel 消息以友好格式显示： 设置 在 中可以控制 channel 功能： 设为 可完全禁用 channel 功能。 构建 Channel 基本要求 一个 channel server 需要： 1. 声明 capability，让 CodeBuddy Code 注册通知监听器 2. 发送 事件 3. 通过 stdio transport 连接（CodeBuddy Code 将其作为子进程启动） 最小示例：Webhook 接收器 注册到 ： Server 配置选项 字段 类型 说明 必填。始终为 。声明后 CodeBuddy Code 注册通知监听器 可选。始终为 。声明此 channel 可以接收权限中继请求 双向 channel 需要。始终为 。标准 MCP 工具能力 推荐。注入到 system prompt，告诉 CodeBuddy Code 如何处理此 channel 的事件 通知格式 发送 通知时，params 包含两个字段： 字段 类型 说明 事件内容，成为 标签的正文 可选。每个键值对成为 标签的属性。键名仅允许字母、数字和下划线，包含连字符或其他字符的键会被静默丢弃 示例： 到达 CodeBuddy Code 时的格式： 暴露 Reply 工具 双向 channel 需要暴露标准 MCP 工具让 CodeBuddy Code 回复消息： 发送者安全管控 未设防的 channel 是 prompt 注入攻击向量。任何能访问你端点的人都可以向 CodeBuddy Code 注入文本。 在调用 之前，必须检查发送者身份： 重要：始终基于发送者身份（ ）而非聊天室身份（ ）进行验证。在群聊中，这两个值不同，按群组验证会让群内任何人都能向会话注入消息。 权限中继 当 CodeBuddy Code 调用需要审批的工具（如 、 、 ）时，本地终端会打开权限对话框。双向 channel 可以选择同时接收这个提示，让你在远程设备上审批或拒绝。 本地终端和远程 channel 的对话框同时打开，先到的回答生效，另一个自动关闭。 启用权限中继 在 Server 构造器中添加 ： 权限请求字段 CodeBuddy Code 发送 ，包含以下字段： 字段 说明 5 个小写字母（排除 ），用于匹配回复 CodeBuddy Code 要使用的工具名，如 、 工具调用的可读描述 工具参数的 JSON 字符串，截断到 200 字符 发送裁决 你的 channel 需要发送 通知： 处理入站裁决 在入站消息处理器中识别 或 格式的回复： 打包为插件 将 channel 包装为插件可以方便分享和安装。用户通过 安装，然后用 启用。 参考 ：完整的双向 channel 实现，包含 Web UI、文件附件和 reply 工具 ：channel 基于 MCP 协议实现"},{"id":"/cli/http-api","title":"CodeBuddy Code HTTP API <sup>Beta</sup>","body":"CodeBuddy Code HTTP API <sup Beta</sup Beta: 此 API 处于 Beta 阶段，接口可能会有调整。欢迎反馈意见。 CodeBuddy Code 提供两套公开接口，面向开发者构建 Agent 应用： REST API ( ) — 无状态 HTTP 请求/响应，适合 Webhook 接入、管理操作、简单查询 ACP ( ) — 有状态流式协议（JSON RPC over SSE），适合构建完整 Agent 客户端应用 快速开始 启动 HTTP 服务 API 文档（Swagger UI） 服务启动后访问： 交互式文档: OpenAPI 规范: Swagger UI 提供所有公开端点的交互式测试界面。 验证服务正常 API 分层 层级 路由前缀 兼容性承诺 说明 公开 REST API 语义化版本，不做破坏性变更 本文档覆盖的内容 公开 ACP 协议 遵循 ACP 规范 完整对话能力，参见 内部 RPC 不保证兼容性 CLI 内部使用，不对外开放 认证 支持两种模式（环境变量 控制）： 模式 值 说明 无认证 （默认） 本地开发用，不需要认证 密码认证 远程访问时自动开启 密码认证支持以下方式（任一通过即可）： 响应格式 所有 端点使用统一的信封格式： 端点概览 系统 方法 端点 说明 GET 健康检查 GET 环境信息（版本、OS、CWD 等） GET 系统资源指标 + 实例进程指标 GET 环境变量（对齐 E2B envd） 认证 方法 端点 说明 GET 获取认证状态 POST 密码登录，返回 token Runs（Agent 执行） 方法 端点 说明 POST 发起 Agent 执行（异步，返回 runId） GET 查询执行状态 GET SSE 流式获取执行结果 POST 取消执行 Webhooks（第三方平台接入） 方法 端点 说明 GET 平台 URL 验证（企微等） POST 平台消息 Webhook 入口 支持的平台： 、 （企业微信）、 （微信客服） 会话 方法 端点 说明 GET 获取会话列表（支持 cwd 查询参数） DELETE 删除会话 POST 重命名会话 GET ⚠️ 已废弃，使用 代替 GET ⚠️ 已废弃 PTY（终端） 方法 端点 说明 POST 创建 PTY 会话 GET 列出 PTY 会话 GET 查询 PTY 会话 DELETE 销毁 PTY 会话 GET SSE 流式获取 PTY 输出（替代 WebSocket） POST 发送 PTY 输入（对齐 E2B Process.SendInput） POST 调整 PTY 大小（对齐 E2B Process.Update） WebSocket PTY 双向数据传输（兼容保留） Workers & Daemon Worker 是运行中的 CLI 进程（interactive / bg / daemon），通过 PID 文件注册表管理。 方法 端点 说明 GET 获取所有活跃 Worker 列表 POST 手动添加远程 Worker GET 获取 Worker 详情（按 PID 或名称） GET 获取 Worker 日志（支持多类型） DELETE 终止 Worker 进程 GET 查询 Daemon 状态 POST 启动 Daemon POST 停止 Daemon POST 重启 Daemon Workers 查询参数: — 按类型过滤（interactive / bg / daemon / daemon worker） — 仅返回本地 Worker（远程代理调用时使用） 日志类型参数 ( ): — 遥测日志（ ） — 进程 stdout/stderr（bg/daemon 日志） — 调试日志（ ，需 ） — 对话历史摘要 — 只返回最后 N 行 不传 type 时自动选择最佳来源（telemetry process debug transcript） Channels（远程控制） 方法 端点 说明 GET 获取客户端列表 POST 启动客户端 POST 停止客户端 POST 创建微信实例 POST 创建企微实例 文件系统（E2B 兼容） 文件内容操作（对齐 E2B envd HTTP 端点）： 方法 端点 说明 GET 下载文件（对齐 E2B envd GET /files） POST 上传文件（对齐 E2B envd POST /files） POST 合并多文件（对齐 E2B envd POST /files/compose） 文件操作（对齐 E2B filesystem.proto）： 方法 端点 说明 POST 获取文件/目录信息（对齐 Filesystem.Stat） POST 列出目录内容"},{"id":"/cli/sdk","title":"CodeBuddy Agent SDK","body":"CodeBuddy Agent SDK 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.0 及以上版本。 功能状态：SDK 当前处于 Preview 阶段，接口和行为可能在未来版本中调整。 ::: warning 重要：环境隔离 SDK 默认不加载任何文件系统配置，包括 、 、MCP 服务器、子代理、斜杠命令、Rules 和 Skills。这是与 CLI 直接使用的关键区别，确保 SDK 应用的行为完全由代码控制，具有可预测性和一致性。 如需加载这些配置，请使用 选项显式指定。详见 章节。 ::: CodeBuddy Agent SDK 允许你在应用程序中以编程方式控制 CodeBuddy Agent。支持 TypeScript/JavaScript 和 Python，可实现自动化任务执行、自定义权限控制、构建 AI 驱动的开发工具等场景。 为什么使用 SDK CodeBuddy Agent SDK 让你能够以编程方式访问 CodeBuddy 的全部能力，而不仅仅是通过命令行交互。 超越命令行的能力 程序化控制：在你的应用程序中嵌入 AI 编程助手，实现自动化工作流 自定义交互：构建符合你需求的用户界面和交互方式 批量处理：对多个文件或项目执行批量 AI 操作 集成现有系统：将 AI 能力无缝集成到 CI/CD、IDE 插件或其他开发工具中 精细化控制 权限管控：通过 回调实现企业级权限策略 行为定制：使用 Hook 系统拦截和修改 Agent 行为 资源限制：控制 token 消耗、执行时间和费用预算 会话管理：持久化和恢复对话上下文 扩展能力 自定义 Agent：创建专门化的子 Agent 处理特定领域任务 MCP 集成：接入自定义工具和服务 多模型支持：灵活切换和配置不同的 AI 模型 你可以构建什么 开发工具增强 IDE 插件：为 VS Code、JetBrains 等 IDE 构建智能编程助手 代码审查工具：自动化代码质量检查和安全扫描 文档生成器：自动生成 API 文档、README 和代码注释 自动化工作流 CI/CD 集成：在流水线中执行智能代码分析和修复 测试生成：自动生成单元测试和集成测试 重构助手：批量执行代码重构和迁移任务 企业应用 内部开发平台：构建企业级 AI 编程平台 知识库问答：基于代码库的智能问答系统 培训工具：交互式编程学习和代码评审系统 功能概览 消息流式传输：实时接收系统消息、助手响应和工具调用结果 多轮对话：支持跨多次推理调用的对话上下文保持 会话管理：通过会话 ID 继续或恢复现有对话 权限控制：细粒度的工具访问权限管理 Hook 系统：在工具执行前后插入自定义逻辑 自定义 Agent：定义专门化的子 Agent 处理特定任务 MCP 集成：支持配置自定义 MCP 服务器扩展功能 安装 ::: code group ::: 环境要求 语言 版本要求 TypeScript/JavaScript Node.js = 18.20 Python Python = 3.10 认证配置 使用已有登录凭据 如果你已经在终端中通过 命令完成了交互式登录，SDK 会自动使用该认证信息，无需额外配置。 使用 API Key 如果未登录或需要使用不同的凭据，可以通过 API Key 认证： 获取 API Key： 版本 获取地址 : : 海外版 <https://www.codebuddy.ai/profile/keys 中国版 <https://copilot.tencent.com/profile/ iOA 版 <https://tencent.sso.copilot.tencent.com/profile/keys 注意：使用 时，必须根据版本正确配置 环境变量： 海外版：不设置（默认） 中国版： iOA 版： 详见 。 也可以在代码中通过 选项传递： ::: code group ::: 企业用户：OAuth Client Credentials 目前仅介绍 Client Credentials 授权方式，适用于服务端应用和 CI/CD 场景。 前提条件：企业用户需要先购买 CodeBuddy 旗舰版才能使用 OAuth 认证。详见 。 企业用户需要先通过 OAuth 2.0 Client Credentials 流程获取 access token，然后传入 SDK。 第 1 步：创建应用获取凭据 参考 创建应用并获取 Client ID 和 Client Secret。 第 2 步：获取 token 并调用 SDK ::: code group ::: 详细的认证配置说明请参阅 。 其他环境变量 变量名 说明 必需 CodeBuddy CLI 可执行文件路径 可选 如果未"},{"id":"/cli/sdk-python","title":"Python SDK 参考","body":"Python SDK 参考 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.0 及以上版本。 本文档提供 Python SDK 的完整 API 参考。有关快速入门和使用示例，请参阅 。 Requirements 依赖 版本要求 Python = 3.10 CodeBuddy CLI 已安装 异步运行时：SDK 基于 ，所有 API 都是异步的。 Installation 推荐使用 进行依赖管理： 或使用 pip： 环境变量 变量名 说明 必需 CodeBuddy CLI 可执行文件路径 可选 如果未设置，SDK 会按以下顺序查找 CLI： 1. 环境变量 2. SDK 包内置的二进制文件 3. 开发环境 monorepo 路径 认证配置 SDK 支持使用已有登录凭据、API Key 或 OAuth Client Credentials 认证，详见 。 Functions query() 主要 API 入口，创建一个查询并返回消息异步迭代器。 参数： 参数 类型 说明 查询提示词或用户消息流 配置选项（可选） 自定义传输层（可选） 返回值： 消息异步迭代器 示例： Client Class CodeBuddySDKClient 用于双向交互式对话的客户端类。支持多轮对话、中断和动态控制。 方法： connect() 连接到 CodeBuddy。 query() 发送用户消息。 receiveresponse() 接收消息直到收到 ResultMessage。 receivemessages() 接收所有消息（不会自动停止）。 disconnect() 断开连接。 上下文管理器支持： mcpserverstatus() 获取 MCP 服务器连接状态。 Authentication SDK 提供独立的认证 API，采用 two phase 设计：先获取登录 URL，再等待用户完成认证。 authenticate() 启动认证流程，返回 对象。 参数： 参数 类型 说明 认证方法标识（默认 ） 预定义环境名 自定义端点 URL（与 environment 互斥） CLI 可执行文件路径 额外环境变量 用户完成登录的超时时间（秒，默认 300） 返回值： — 携带登录 URL 的可等待对象 示例： AuthFlow 认证流程对象，由 返回。实现了 协议，可直接 。 属性： 属性 类型 说明 登录 URL（已登录时为空字符串） 认证方法标识 方法： wait() 等待用户完成认证。 cancel() 取消认证流程并释放资源。 logout() 登出并清除缓存的认证令牌。 示例： Unstable API 警告：以下 API 处于实验阶段，接口可能在未来版本中变更。 interrupt() 发送中断信号。 setpermissionmode() 动态修改权限模式。 setmodel() 动态修改模型。 Types CodeBuddyAgentOptions 完整配置选项： 字段 类型 说明 自动允许的工具白名单 禁止使用的工具黑名单 系统提示词配置 MCP 服务器配置 权限模式 继续最近的会话 要恢复的会话 ID 最大对话轮数 指定模型 备用模型 工作目录 CLI 可执行文件路径 环境变量 额外的 CLI 参数 stderr 回调 Hook 配置 包含部分消息 分叉会话 自定义 Agent 设置来源 权限回调函数 最大思考 token 数（已废弃，请使用 ） 思考模式配置： 、 或 模型推理努力程度 PermissionMode 值 说明 默认模式，所有操作需确认 自动批准文件编辑 规划模式，仅允许读取 跳过所有权限检查 PermissionResult CanUseTool AgentDefinition McpServerConfig HookEvent HookMatcher HookCallback SettingSource 控制 SDK 从哪些文件系统位置加载配置。 值 说明 位置 全局用户设置 项目共享设置 项目本地设置 默认行为：当 未指定时，SDK 不加载任何文件系统配置。这提供了完全干净的运行环境。 AppendSystemPrompt Message Types Message 所有消息类型的联合： SystemMessage UserMessage AssistantMessage ResultMessage StreamEvent ContentBlock Input Types AskUserQuestionInput AskUserQuestionQuestion AskUserQuestionOption Errors 所有异常都继承自 。 CodeBuddySDKError CLIC"},{"id":"/cli/sdk-typescript","title":"TypeScript SDK 参考","body":"TypeScript SDK 参考 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.0 及以上版本。 本文档提供 TypeScript SDK 的完整 API 参考。有关快速入门和使用示例，请参阅 。 Requirements 依赖 版本要求 Node.js = 18.0.0 TypeScript = 5.0.0（推荐） 运行时支持： Node.js（推荐） Bun Deno Installation 或使用其他包管理器： 环境变量 变量名 说明 必需 CodeBuddy CLI 可执行文件路径 可选 认证配置 SDK 支持使用已有登录凭据、API Key 或 OAuth Client Credentials 认证，详见 。 Functions query() 主要 API 入口，创建一个查询并返回消息流。 参数： 参数 类型 说明 查询提示词或用户消息流 配置选项（可选） 返回值： 扩展了 的接口 Query 接口 Constants Errors Unstable V2 API 警告：以下 API 处于实验阶段，接口可能在未来版本中变更。 unstablev2createSession() 创建新的交互式会话。 unstablev2resumeSession() 恢复现有会话。 unstablev2prompt() 单次查询便捷函数。 unstablev2authenticate() 发起交互式登录流程，支持多环境认证（海外版、国内版等）。 参数： 字段 类型 说明 认证 URL 回调，用于打开浏览器或显示链接 预定义环境（与 endpoint 二选一） 自定义 endpoint URL（用于 selfhosted，与 environment 二选一） 认证方法 ID，默认 'external' 超时时间（毫秒），默认 300000 CLI 可执行文件路径（可选） 环境变量（可选） 返回值： 用户信息对象，包含 userId、userName、userNickname、token 等字段 示例： 行为说明： 如果已有有效 token，直接返回用户信息，不会触发登录流程 否则通过 回调通知用户打开登录链接 登录成功后 token 会被缓存，下次调用自动复用 unstablev2logout() 登出并清除缓存的认证 token，下次调用 将重新登录。 参数： 字段 类型 说明 预定义环境（与 endpoint 二选一） 自定义 endpoint URL（与 environment 二选一） CLI 可执行文件路径（可选） 环境变量（可选） 示例： Session 接口 SessionOptions Types Options 完整配置选项： 字段 类型 说明 用于取消请求 运行时 运行时参数 CLI 路径 工作目录 额外的目录 环境变量 指定模型 备用模型 最大思考 token 数（已废弃，请使用 ） 思考模式配置： 、 或 模型推理努力程度 允许的工具白名单 禁止的工具黑名单 权限回调函数 权限模式 允许跳过权限 权限提示工具名 继续最近的会话 要恢复的会话 ID 恢复到特定消息位置 持久化会话 分叉会话 自定义 Agent Hook 配置 输出格式 系统提示词 包含部分消息 最大对话轮数 MCP 服务器配置 严格 MCP 配置 沙箱设置 配置源，控制加载哪些文件系统配置。默认不加载任何配置 SettingSource 控制 SDK 从哪些文件系统位置加载配置。 值 说明 位置 全局用户设置 项目共享设置 项目本地设置 默认行为：当 未指定时，SDK 不加载任何文件系统配置。这提供了完全干净的运行环境。 PermissionMode PermissionResult CanUseTool AgentDefinition ModeInfo ModelInfo McpServerConfig HookEvent HookCallback HookJSONOutput Message Types Message 所有消息类型的联合： SystemMessage UserMessage AssistantMessage ResultMessage ContentBlock Usage Input Types AskUserQuestionInput AskUserQuestionQuestion AskUserQuestionOption ToolInputMap 相关文档 快速入门和使用示例 详细的 Hook 配置说明 MCP 服务器配置指南"},{"id":"/cli/sdk-hooks","title":"SDK Hook 系统","body":"SDK Hook 系统 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.0 及以上版本。 本文档介绍如何在 SDK 中使用 Hook 系统，在工具执行前后插入自定义逻辑。 概述 Hook 允许你在 CodeBuddy 的会话生命周期内插入自定义逻辑，实现： 工具调用前的校验和拦截 工具执行后的日志记录 用户提交内容的审查 会话开始/结束时的初始化和清理 创建与清理时的自定义流程 支持的事件 事件 触发时机 工具执行前 工具执行成功后 用户提交消息时 主 Agent 响应结束时 子 Agent 结束时 上下文压缩前 创建隔离 时 删除隔离 时 文件修改后自动创建检查点时 Hook 配置 通过 选项配置 Hook。每个事件可以有多个 matcher，每个 matcher 可以有多个 hook 回调。 基本结构 ::: code group ::: HookMatcher 结构 字段 类型 说明 匹配模式,支持正则表达式。 或空字符串匹配所有 回调函数数组 超时时间（TypeScript 毫秒，Python 秒） Matcher 模式 精确匹配： 只匹配 Bash 工具 正则匹配： 匹配 Edit 或 Write 通配符： 或 匹配所有工具 前缀匹配： 匹配所有 MCP 工具 事件类型 PreToolUse 工具执行前触发，可以阻止执行或修改输入。 ::: code group ::: PostToolUse 工具执行成功后触发，可以添加额外上下文。 ::: code group ::: UserPromptSubmit 用户提交消息时触发，可以添加上下文或阻止处理。 ::: code group ::: Stop / SubagentStop Agent 响应结束时触发，可以阻止停止并要求继续。 ::: code group ::: unstableCheckpoint（实验性） 文件修改后（Write/Edit/MultiEdit 工具执行成功）自动触发，提供文件快照和变更统计信息。 ::: warning 实验性 API 此 Hook 为实验性功能，API 可能在未来版本中发生变化。 ::: ::: code group ::: Checkpoint 数据结构： : 检查点唯一标识符 : 人类可读标签（通常为用户提示） : 创建时间戳 : 文件路径到版本信息的映射 : 文件绝对路径 : 版本号 : 备份文件名 : 备份时间戳 : 文件变更统计 : 变更的文件路径列表 : 新增行数 : 删除行数 Hook 输入 Hook 回调接收的输入结构因事件类型而异。 公共字段 PreToolUse / PostToolUse 输入 UserPromptSubmit 输入 Stop / SubagentStop 输入 WorktreeCreate 输入示例： WorktreeRemove 输入示例： unstableCheckpoint 输入 Hook 输出 Hook 回调返回的输出控制后续行为。 基本输出字段 字段 类型 说明 / 是否继续执行（默认 true） 设为 阻止操作 阻止原因 当 为 false 时显示的停止消息 隐藏输出 PreToolUse 特殊输出 可以修改工具输入： ::: code group ::: 示例 完整示例：Bash 命令审计 ::: code group ::: 示例：限制文件修改范围 ::: code group ::: 示例：文件修改追踪（Checkpoint Hook） ::: code group ::: 相关文档 快速入门和使用示例 canUseTool 回调 CLI Hook 完整参考 完整 API 参考 完整 API 参考"},{"id":"/cli/sdk-permissions","title":"SDK 权限控制","body":"SDK 权限控制 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.0 及以上版本。 本文档介绍如何在 SDK 中实现权限控制，包括权限模式、canUseTool 回调和工具白名单/黑名单。 概述 CodeBuddy Agent SDK 提供多种权限控制机制： 机制 说明 适用场景 权限模式 全局控制权限行为 快速设置整体策略 canUseTool 回调 运行时动态审批 交互式权限确认 工具白名单/黑名单 声明式工具过滤 静态策略配置 权限模式 通过 （TypeScript）或 （Python）设置全局权限行为。 可用模式 模式 说明 默认模式，所有工具操作需要确认 自动批准文件编辑，其他操作仍需确认 规划模式，仅允许只读工具 跳过所有权限检查（谨慎使用） 初始配置 ::: code group ::: 动态修改权限模式 使用 Session/Client API 可以在运行时动态修改权限模式： ::: code group ::: canUseTool 回调 回调在工具需要权限确认时触发，允许你实现自定义的权限逻辑。 回调签名 ::: code group ::: 完整示例：交互式审批 ::: code group ::: 修改工具输入 可以在 中修改工具的输入参数： ::: code group ::: 处理 AskUserQuestion 当 AI 需要向用户提问时，会调用 工具。你需要在 中处理这个工具。 输入结构 返回答案 ::: code group ::: 工具白名单/黑名单 SDK 提供多种工具过滤机制： 选项 说明 优先级 内置工具白名单，从根本上限制可用工具集 最高 允许使用的工具（支持模式匹配） 中 禁止使用的工具（支持模式匹配） 中 tools：内置工具白名单 使用 选项从根本上限制 CodeBuddy 可使用的内置工具集： ::: code group ::: allowedTools/disallowedTools：工具过滤 使用 和 进行更细粒度的工具过滤，支持模式匹配： ::: code group ::: 常用工具名称 工具名 功能 读取文件 写入文件 编辑文件 文件模式匹配 内容搜索 执行 Shell 命令 子 Agent 任务 获取网页内容 网络搜索 搜索延迟加载的工具 最佳实践 1. 默认使用 模式：提供最完整的权限控制 2. 只读任务使用 模式： 3. 结合白名单精确控制： 4. 危险命令使用 ： 5. 生产环境避免 ：该模式会跳过所有权限检查 相关文档 快速入门和使用示例 更细粒度的工具控制 完整 API 参考 完整 API 参考"},{"id":"/cli/sdk-sessions","title":"SDK 会话管理","body":"SDK 会话管理 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.0 及以上版本。 本文档介绍如何在 SDK 中管理会话，包括获取会话 ID、恢复会话、分叉会话和多轮对话。 概述 会话（Session）是 CodeBuddy 的核心概念，用于： 保持对话上下文：多轮对话中 AI 能记住之前的内容 支持会话恢复：可以从上次中断的地方继续 支持会话分叉：从某个点创建分支，探索不同方向 每个会话都有一个唯一的 ，可以用于后续恢复。 获取会话 ID 会话开始时，SDK 会返回一个 类型的初始化消息,其中包含 。 使用 query API ::: code group ::: 使用 v2 Session API (TypeScript) 使用 Client API (Python) 恢复会话 使用之前保存的 可以恢复会话，继续之前的对话。 使用 resume 选项 ::: code group ::: 继续最近的会话 使用 / 选项可以自动继续最近的会话： ::: code group ::: 多轮对话 多轮对话允许在同一个会话中进行多次交互，保持上下文连贯。 TypeScript：使用 query API 每次新的 query 调用使用 恢复会话： TypeScript：使用 v2 Session API v2 API 提供更简洁的多轮对话体验： Python：使用 CodeBuddySDKClient 相关文档 快速入门和使用示例 权限模式和 canUseTool 完整 API 参考 完整 API 参考"},{"id":"/cli/sdk-custom-tools","title":"SDK Custom Tools Guide","body":"SDK Custom Tools Guide 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.24 及以上版本。 功能状态：SDK Custom Tools 是 CodeBuddy Agent SDK 的一项 Preview 功能。 本文档介绍如何在 CodeBuddy Agent SDK 中创建和使用自定义工具。自定义工具允许你定义专属的功能，让 Agent 能够调用它们来完成特定任务。 概述 Custom Tools 是 CodeBuddy Agent SDK 提供的一种通过 MCP（Model Context Protocol）创建自定义工具的方式。与配置外部 MCP 服务器不同，Custom Tools 允许你直接在应用程序中定义工具，无需单独的进程或服务器。 核心优势 内进程执行：工具在应用程序内执行，无需创建独立进程 类型安全：支持 TypeScript 完整的类型检查和类型推断 简化部署：无需单独部署 MCP 服务器，一切随应用部署 紧密集成：与应用程序共享内存和状态 零额外依赖：利用现有的 SDK 基础设施 快速开始 TypeScript 创建一个简单的计算器工具： Python Python SDK 使用装饰器模式定义工具： 创建自定义工具 TypeScript 基本工具定义 TypeScript 完整示例：文件分析工具 Python 装饰器模式 多个工具管理 TypeScript Python 类型安全 TypeScript 使用 Zod 模式 Zod 提供运行时类型验证和强大的类型推断： Python 类型注解 Python SDK 使用 装饰器定义工具，支持简单类型映射或 JSON Schema： 完整示例：数据库查询工具 TypeScript Python 完整示例：API 集成工具 TypeScript Python 选择性地允许工具 你可以选择性地允许特定工具被调用： TypeScript Python 错误处理 TypeScript API 调用错误处理 Python API 调用错误处理 最佳实践 1. 使用明确的参数类型和描述 为工具参数提供清晰的类型和描述，帮助 Agent 理解如何调用工具： 2. 提供有意义的错误反馈 始终返回明确的错误信息，以便 Agent 和用户理解发生了什么： 3. 验证输入参数 确保输入符合预期的格式和范围： 相关文档 更多资源"},{"id":"/cli/sdk-mcp","title":"SDK MCP Integration Guide","body":"SDK MCP Integration Guide 版本要求：本文档针对 CodeBuddy Agent SDK v0.1.24 及以上版本。 功能状态：SDK MCP 支持是 CodeBuddy Agent SDK 的一项 Preview 功能。 本文档介绍如何在 CodeBuddy Agent SDK 中集成和使用 MCP（Model Context Protocol）服务器，为你的应用程序扩展自定义工具和功能。 概述 MCP 服务器允许你将自定义工具、资源和提示集成到 CodeBuddy Agent SDK 中。通过 SDK，你可以以编程方式启用这些工具，从而为你的 AI 工作流添加特定领域的功能。 核心概念 MCP 服务器：提供工具、资源和提示的独立进程或服务 工具：MCP 服务器暴露的可执行函数 资源：MCP 服务器提供的可读取的数据或文件 提示：MCP 服务器提供的模板化提示词 支持的传输类型 CodeBuddy Agent SDK 支持三种 MCP 服务器通信方式： 传输类型 使用场景 说明 STDIO 本地工具 通过标准输入输出与本地进程通信 HTTP/SSE 远程服务 通过 HTTP 流式传输或 Server Sent Events 与远程服务通信 SDK MCP IDE/SDK 集成 由外部 SDK（如 IDE 扩展）注册的 MCP 服务器 配置 MCP 服务器 支持两种配置方式： 1. 对象格式：直接在代码中定义服务器配置 2. 文件路径字符串：指向一个 MCP 配置文件（JSON 格式） 对象格式 使用 选项配置 MCP 服务器。配置支持 STDIO、HTTP 和 SSE 传输类型。 TypeScript： Python： 文件路径格式 也可以传入一个 MCP 配置文件路径。配置文件为 JSON 格式，结构与 CLI 参数一致。 TypeScript： Python： 配置文件格式示例（ ）： 注意：使用文件路径格式时，不支持 SDK MCP 类型（ ）的服务器配置。SDK MCP 服务器仅在对象格式中可用。 服务器配置详解 STDIO 配置 STDIO 服务器通过标准输入输出与本地进程通信，适用于本地工具。 常见用例： HTTP 配置 HTTP 服务器通过 HTTP 流式传输与远程服务通信。 SSE 配置 SSE 服务器通过 Server Sent Events 与远程服务通信。 权限管理 MCP 工具支持精细化的权限控制。通过 回调，你可以决定哪些工具可以被使用。 工具权限模式 特定工具的权限控制 使用 MCP 工具 配置完 MCP 服务器后，Agent 会自动发现这些服务器提供的工具，并在需要时调用它们。 自动工具发现 处理工具结果 实例：数据库查询 MCP 服务器 以下是一个完整的示例，展示如何创建和使用数据库 MCP 服务器。 创建 MCP 服务器 dbmcpserver.py： 在 SDK 中使用 TypeScript： Python： 实例：API 集成 MCP 服务器 以下示例展示如何创建一个通过 HTTP 连接到多个 API 的 MCP 服务器。 服务器实现 apimcpserver.py： 在 SDK 中使用 实例：远程 SSE 服务器 SSE 服务器适用于需要实时数据流或事件推送的场景。 错误处理 在处理 MCP 服务器连接时，监控初始化状态并识别失败的连接： 检查服务器初始化状态 TypeScript： Python： 相关文档 更多资源"},{"id":"/cli/sdk-demos","title":"SDK 示例项目","body":"SDK 示例项目 本文档介绍 CodeBuddy Agent SDK 的官方示例项目，帮助你快速了解 SDK 的各种使用场景。 示例仓库 所有示例代码托管在官方仓库： 仓库地址：<https://cnb.cool/codebuddy/agent sdk demos 示例概览 示例 语言 核心功能 适用场景 quick start TypeScript 基础 API、消息流、Hooks SDK 入门 multi turn session TypeScript 多轮对话、会话恢复 交互式应用 research assistant Python 多 Agent 协作 复杂任务分解 profile builder TypeScript 网络搜索、文档生成 信息收集 chat demo TypeScript WebSocket、流式响应 Web 应用 mail assistant TypeScript MCP 协议、自定义工具 业务系统对接 spreadsheet assistant TypeScript Electron IPC 桌面应用 环境准备 前置条件 或 Node.js 18+ Python 3.10+（Python 示例） 已完成 CodeBuddy CLI 登录认证 安装 SDK ::: code group ::: 认证方式 SDK 支持多种认证方式： 1. 复用 CLI 登录态：如果已通过 命令登录，SDK 自动使用现有凭据 2. API Key 认证：通过环境变量配置 详细的认证配置请参阅 基础示例 quick start：SDK 入门 演示 API 的基本用法，包括消息流处理和 Hooks 机制。 运行示例： multi turn session：多轮对话 演示 Session API 实现多轮对话和会话恢复。 运行示例： 进阶示例 research assistant：多 Agent 协作 Python 示例，展示如何定义多个专业化子 Agent 协作完成复杂任务。 工作流程： 1. 主 Agent 将研究请求拆分为子任务 2. 研究员 使用 WebSearch 搜索信息，保存到 3. 数据分析师 从研究笔记提取数据，生成图表到 4. 报告撰写者 整合内容，生成 PDF 报告到 运行示例： profile builder：信息收集与文档生成 演示 WebSearch 工具和文档生成能力。 运行示例： Web 应用集成 chat demo：流式响应架构 演示如何将 SDK 集成到 Web 应用，通过 WebSocket 实现流式响应。 架构： 服务端封装： 运行示例： mail assistant：MCP 工具扩展 演示通过 MCP 协议扩展 Agent 能力，实现邮件系统操作。 运行示例： 桌面应用集成 spreadsheet assistant：Electron 集成 演示在 Electron 应用中通过 IPC 集成 SDK。 主进程： 渲染进程： 运行示例： Hooks 安全控制 所有示例都支持通过 Hooks 实现安全控制： 相关文档 SDK 完整介绍 TypeScript API 详细文档 Python API 详细文档 MCP 服务器配置 多 Agent 协作详解"},{"id":"/cli/release-notes/README","title":"Release Notes","body":"Release Notes CodeBuddy Code 的版本发布说明，面向终端用户的功能更新和改进。 📖 关于 Release Notes Release Notes 记录了每个版本的用户可见变更，包括： ✨ 新功能 🔧 改进优化 🐛 问题修复 与 CHANGELOG.md 的区别： Release Notes：面向终端用户，强调功能价值和用户体验 CHANGELOG：面向开发者，记录技术细节和代码变更 📋 版本历史 <! 新版本自动添加到此处 2026 04 08 2026 04 08 2026 04 07 2026 04 07 2026 04 05 2026 04 05 2026 04 04 2026 04 03 2026 04 03 2026 04 03 2026 04 03 2026 04 03 2026 04 02 2026 04 01 2026 04 01 2026 03 31 2026 03 31 2026 03 30 2026 03 30 2026 03 28 2026 03 26 2026 03 26 2026 03 25 2026 03 25 2026 03 25 2026 03 24 2026 03 23 2026 03 23 2026 03 19 2026 03 18 2026 03 18 2026 03 17 2026 03 17 2026 03 16 2026 03 15 2026 03 13 2026 03 13 2026 03 13 2026 03 12 2026 03 12 2026 03 12 2026 03 12 2026 03 11 2026 03 11 2026 03 11 2026 03 09 2026 03 07 2026 03 06 2026 03 06 2026 03 05 2026 03 05 2026 03 03 2026 03 03 2026 03 02 2026 02 28 2026 02 28 2026 02 28 2026 02 26 2026 02 26 2026 02 25 2026 02 24 2026 02 19 2026 02 19 2026 02 14 2026 02 14 2026 02 13 2026 02 13 2026 02 12 2026 02 12 2026 02 11 2026 02 11 2026 02 11 2026 02 10 2026 02 10 2026 02 09 2026 02 08 2026 02 06 2026 02 05 2026 02 04 2026 02 04 2026 02 04 2026 02 03 2026 02 03 2026 02 02 2026 02 02 2026 02 02 2026 01 31 2026 01 31 2026 01 30 2026 01 30 2026 01 29 2026 01 28 2026 01 28 2026 01 28 2026 01 27 2026 01 27 2026 01 27 2026 01 27 2026 01 27 2026 01 27 2026 01 26 2026 01 26 2026 01 25 2026 01 25 2026 01 24 2026 01 23 2026 01 23 2026 01 23 2026 01 23 2026 01 23 2026 01 22 2026 01 22 2026 01 22 2026 01 22 2026 01 21 2026 01 21 2026 01 21 2026 01 21 2026 01 21 2026 01 20 2026 01 20 2026 01 20 2026 01 20 2026 01 19 2026 01 18 2026 01 17 2026 01 17 2026 01 16 2026 01 15 2026 01 15 2026 01 15 2026 01 14 2026 01 14 2026 01 13 2026 01 12 2026 01 09 2026 01 09 2026 01 08 2026 01 08 2026 01 07 2026 01 06 2026 01 06 2026 01 05 2026 01 05 2026 01 04 2025 12 31 2025 12 30 2025 12 29 2025 12 26 2025 12 25 2024 12 24 2025 12 24 2025 12 23 2025 12 23 2025 12 23 2025 12 22 2025 12 20 2025 12 19 2025 12 19 2025 12 19 2025 12 1"},{"id":"/cli/release-notes/v2.81.0","title":"🚀 CodeBuddy Code v2.81.0 发布","body":"🚀 CodeBuddy Code v2.81.0 发布 ✨ 新功能 命令面板 支持 Cmd+Shift+P (Mac) / Ctrl+Shift+P (Windows) 打开全局命令面板，模糊搜索命令、视图导航和操作，快速访问各项功能。 全局快捷键 新增 5 个全局快捷键，覆盖命令面板、侧边栏切换、终端切换、新建对话和打开设置，提升操作效率。 Toast 通知系统 新增统一的 Toast 通知组件，替代之前静默吞噬的错误处理方式，确保重要信息不会被遗漏。 Error Boundary 新增全局错误边界组件，防止单个组件崩溃导致整个页面白屏，提升应用稳定性。 工具过程折叠 Agent 执行完成后，工具调用过程自动折叠为摘要行，保持对话界面整洁，需要时可按需展开查看细节。 🔧 改进优化 确认对话框统一：新增 ConfirmDialog 组件，统一全局确认交互体验 状态栏优化：补全所有视图标题，增加模型名和连接状态显示，信息一目了然 无障碍增强：添加全局焦点样式、ARIA 角色标注、disabled 状态规范，提升无障碍体验 移动端适配：InputBox 安全区域适配、iOS 点击高亮修复、PWA manifest 支持 设计系统升级：新增交互状态 CSS 变量、Tailwind 设计 token 扩展，提升视觉一致性 边框对比度修复：修复浅色/深色主题边框几乎不可见的问题 插件市场来源校验：新增 cnb.cool 和 cnb.woa.com 为可信来源，扩展插件安装渠道 ACP 协议合规：移除不合规的自定义消息类型，严格遵循 ACP 规范 默认 Agent 配置：支持通过 的 字段指定默认 agent 🐛 问题修复 Compact 后 Agent 恢复：修复上下文压缩后 session 错误使用 compact agent 的问题，确保后续对话正常恢复 AskUserQuestion 输入规范化：修复模型返回错误字段名或格式时的兼容性问题，在工具层和 UI 层多点防御"},{"id":"/cli/release-notes/v2.80.0","title":"🚀 CodeBuddy Code v2.80.0 发布","body":"🚀 CodeBuddy Code v2.80.0 发布 ✨ 新功能 Windows PowerShell 原生支持 新增原生 PowerShell 命令执行工具，自动检测 PowerShell 7+ 和 Windows PowerShell 5.1 版本并适配语法指导。未安装 Git Bash 时，PowerShell 自动成为唯一 shell 工具，不再崩溃退出。内置 24 项安全验证，覆盖代码注入、下载执行、提权操作等危险模式。 Memory 系统全面升级 Typed Memory 默认启用，使用 4 种记忆类型（user/feedback/project/reference）结构化管理跨会话记忆 根据用户查询自动选择最相关的记忆注入上下文，让 AI 更了解你的项目和偏好 超过 1 天的记忆附带陈旧警告，使用记忆中的文件路径或函数名前会提醒先验证是否仍存在 支持对话结束后自动提取记忆（需在设置中手动启用） GLM 5.1 模型 新增 GLM 5.1 及 GLM 5.1 ioa 模型配置。 🔧 改进优化 Windows 进程管理增强：使用 taskkill 进程树终止替代简单 kill，提升 Windows 上的进程清理可靠性 Windows 退出码语义：正确解释 robocopy、xcopy 等 Windows 工具的非标准退出码 JSON 参数修复增强：修复 LLM 输出中 被误用为 导致工具调用参数解析失败的问题 插件更新容错：插件安装路径丢失时自动探测或重新安装，避免更新失败 评价面板交互：评价面板打开时仅拦截评分按键，不再禁用整个输入框 请求兼容性：移除尾部无 toolcalls 的 assistant 消息，兼容更多 OpenAI 兼容 API 企微群聊优化：支持带 @机器人名 前缀的群聊消息权限回复、群聊自动跳过\"下一步建议\"、区分群聊/私聊欢迎语、权限确认消息添加 [请回复确认] 前缀 🐛 问题修复 终端资源泄漏：修复进程退出时 Web UI 终端 PTY 会话未被清理的问题，防止系统 PTY 设备耗尽 AskUserQuestion 防御性改进：修复空问题/空选项时组件未正确处理的问题，增加自动拒绝无效问题和过滤空标签选项"},{"id":"/cli/release-notes/v2.79.1","title":"🚀 CodeBuddy Code v2.79.1 发布","body":"🚀 CodeBuddy Code v2.79.1 发布 ✨ 新功能 Daemon 常驻模式与后台会话 新增 Daemon 守护进程支持，可通过 命令管理后台运行的 CLI 实例。同时支持 参数在后台启动任务，配合 命令对后台任务进行全生命周期管理。 Web UI Workers 与日志管理 Web UI 新增 Workers 页面，可视化管理所有 Worker 进程和 Daemon，支持启停、终止操作。同时新增独立日志查看器，支持 4 种日志类型（遥测/进程/调试/对话）切换、关键词搜索和语法高亮。 系统监控视图 Web UI 新增 Metrics 页面，展示系统 CPU、内存、磁盘使用概览以及各实例进程级资源指标（RSS、Heap、运行时长），支持 8 秒自动轮询刷新，帮助随时掌握资源状态。 编辑器体验全面升级 标签增强：支持拖拽排序、固定标签（Pin）、溢出滚动箭头，以及增强右键菜单（复制路径、在文件树中定位、关闭右侧、关闭已保存） 面包屑导航：编辑器顶部显示文件路径层级，点击可快速切换同级文件 快速打开：支持 Cmd+P / Ctrl+P 快速搜索并打开文件 文件预览：支持图片（缩放/拖拽/棋盘格背景）、Markdown、PDF、SVG 预览和二进制文件信息页 状态栏：底部显示光标位置、选区信息、语言类型等编辑状态 最近文件：空编辑器页面展示最近打开文件列表 🔧 改进优化 执行阶段追踪：Loading 状态栏新增细粒度执行阶段显示（preparing / waiting for model / streaming / processing / running tool），帮助了解 Agent 当前正在做什么 后台任务支持扩展：stream json 和 headless 模式现已支持后台任务，仅 print 模式（ ）保持原有限制 设置页面重构：重构为数据驱动的设置面板，支持通过 REST API 读写用户级设置，包含开关、选择、文本输入、JSON 编辑等控件，操作后有保存反馈提示 代码块优化：复制按钮改为悬停浮动显示，去除语言标签栏，界面更简洁 菜单交互改进：斜杠命令、@ 文件补全、+ 功能面板现支持点击外部自动关闭 🐛 问题修复 命令补全菜单：修复输入命令参数时补全菜单仍然显示的问题，光标离开命令名区域后菜单会正确关闭 指标采集：修复多实例场景下 metrics 接口的循环调用问题 会话工作目录：修复 Web UI 会话工作目录设置为 URL 而非实际路径的问题 📝 文档更新 Daemon 使用文档：新增 Daemon 常驻模式完整使用指南 API 文档补充：补充 Workers、Daemon、Metrics 等新增 API 端点文档 ACP 协议文档：更新 ACP 协议文档，补充 Team 状态推送等新特性说明 发布说明同步：同步 v2.77.0 v2.79.0 发布说明到 IDE 文档站"},{"id":"/cli/release-notes/v2.79.0","title":"🚀 CodeBuddy Code v2.79.0 发布","body":"🚀 CodeBuddy Code v2.79.0 发布 ✨ 新功能 Daemon 常驻模式与后台会话 新增 Daemon 守护进程支持，可通过 命令管理后台运行的 CLI 实例。同时支持 参数在后台启动任务，配合 命令对后台任务进行全生命周期管理。 Web UI Workers 与日志管理 Web UI 新增 Workers 页面，可视化管理所有 Worker 进程和 Daemon，支持启停、终止操作。同时新增独立日志查看器，支持 4 种日志类型（遥测/进程/调试/对话）切换、关键词搜索和语法高亮。 系统监控视图 Web UI 新增 Metrics 页面，展示系统 CPU、内存、磁盘使用概览以及各实例进程级资源指标（RSS、Heap、运行时长），支持 8 秒自动轮询刷新，帮助随时掌握资源状态。 编辑器体验全面升级 标签增强：支持拖拽排序、固定标签（Pin）、溢出滚动箭头，以及增强右键菜单（复制路径、在文件树中定位、关闭右侧、关闭已保存） 面包屑导航：编辑器顶部显示文件路径层级，点击可快速切换同级文件 快速打开：支持 Cmd+P / Ctrl+P 快速搜索并打开文件 文件预览：支持图片（缩放/拖拽/棋盘格背景）、Markdown、PDF、SVG 预览和二进制文件信息页 状态栏：底部显示光标位置、选区信息、语言类型等编辑状态 最近文件：空编辑器页面展示最近打开文件列表 🔧 改进优化 执行阶段追踪：Loading 状态栏新增细粒度执行阶段显示（preparing / waiting for model / streaming / processing / running tool），帮助了解 Agent 当前正在做什么 后台任务支持扩展：stream json 和 headless 模式现已支持后台任务，仅 print 模式（ ）保持原有限制 设置页面重构：重构为数据驱动的设置面板，支持通过 REST API 读写用户级设置，包含开关、选择、文本输入、JSON 编辑等控件，操作后有保存反馈提示 代码块优化：复制按钮改为悬停浮动显示，去除语言标签栏，界面更简洁 菜单交互改进：斜杠命令、@ 文件补全、+ 功能面板现支持点击外部自动关闭 🐛 问题修复 命令补全菜单：修复输入命令参数时补全菜单仍然显示的问题，光标离开命令名区域后菜单会正确关闭 指标采集：修复多实例场景下 metrics 接口的循环调用问题 会话工作目录：修复 Web UI 会话工作目录设置为 URL 而非实际路径的问题"},{"id":"/cli/release-notes/v2.78.1","title":"🚀 CodeBuddy Code v2.78.1 发布","body":"🚀 CodeBuddy Code v2.78.1 发布 🐛 问题修复 Agent 解析修复：修复队列排空和 Agent 唤醒时使用错误 Agent 的问题，现在统一使用 session 关联的 Agent，确保任务调度更加准确可靠 模型字段修复：修复 reasoningitem 和普通 item 的 model 字段取值问题，使用实际模型响应信息替代可能为空的值，确保模型信息完整准确 🔧 改进优化 企业微信回复增强：增强 chatId 解析能力，支持从 chatId 字符串提取路由信息；优化工具返回格式为结构化 JSON，提升消息处理的可靠性"},{"id":"/cli/release-notes/v2.78.0","title":"🚀 CodeBuddy Code v2.78.0 发布","body":"🚀 CodeBuddy Code v2.78.0 发布 ✨ 新功能 Agent Teams Web UI 支持 全新的 Agent Teams Web UI 体验，让您可以在浏览器中直观地管理和监控多 Agent 协作任务： 实时进度追踪：Team 成员的运行状态、token 使用量、工具调用次数通过 SSE 实时推送，在任务面板中一目了然 成员对话查看：点击任意成员即可查看其完整对话历史，支持实时流式更新 智能消息展示：收到的消息显示 ，发出的消息显示 ，每个成员拥有专属颜色标识 刷新状态恢复：页面刷新后自动恢复 Team 状态和成员对话，无需手动重连 完整国际化：新增 13 个 Team 相关的中英文翻译 🔧 改进优化 权限系统重构：重构 ACP 权限广播机制，支持 Web UI 页面刷新后恢复权限对话框，修复跨端权限同步问题 问卷下发优化：AskUserQuestion 改为通过 interruption 广播协议下发，避免多连接场景下问卷发送到错误客户端 上下文压缩改进：采用同步 compact 流程替代手动截断，提升上下文管理的可靠性 频道消息队列：微信/企业微信频道新增消息队列机制，避免 Agent 运行期间并发消息丢失 选项兼容处理：TUI 和 Web UI 问卷面板增加对纯字符串选项数组的防御性处理 🐛 问题修复 命令补全修复：修复输入斜杠命令后跟参数时补全菜单消失的问题，现在输入如 时仍能正确显示命令补全建议 命令建议修复：修复光标进入参数区域后命令补全仍然显示的问题"},{"id":"/cli/release-notes/v2.77.1","title":"🚀 CodeBuddy Code v2.77.1 发布","body":"🚀 CodeBuddy Code v2.77.1 发布 🔧 改进优化 图片 blob 引用还原：新增环境变量 ，设置为 后可在 模式流式输出中将图片 blob 引用自动还原为完整 base64 数据，方便下游系统集成 微信/企微权限回复体验优化：移除权限操作后的机械确认消息，改为由 Agent 后续动作作为隐式反馈，对话更自然流畅 🐛 问题修复 微信/企微消息路由修复：修复权限回复中\"始终允许\"指令因检查顺序问题被错误识别的 bug，确保权限指令优先正确处理"},{"id":"/cli/release-notes/v2.77.0","title":"🚀 CodeBuddy Code v2.77.0 发布","body":"🚀 CodeBuddy Code v2.77.0 发布 ✨ 新功能 插件系统全面升级 插件系统迎来重大增强，显著提升了插件的安装、管理和扩展能力： 多来源安装：支持通过 npm 包和 Git 仓库子目录安装插件，灵活适配不同的插件分发方式 MCP Bundle 支持：支持从远程 URL 或本地文件加载预打包的 MCP 服务（.mcpb/.dxt/.zip），简化 MCP 服务集成 Output Style 扩展：插件可以提供自定义输出样式，个性化 Agent 的输出表现 默认 Agent 配置：插件支持通过 设置默认 Agent，作为最低优先级 base layer PATH 自动注入：启用插件的 目录自动注入到 Bash 工具的 PATH 中 用户配置选项：插件支持定义 字段，安装时交互式收集用户配置 依赖解析：支持 DFS 闭包算法解析插件传递依赖，含循环检测 插件安全与管理 市场名称保护：四层防御机制防止第三方冒充官方市场 企业策略服务：通过 managed settings 控制插件启用/禁用，满足企业合规需求 参数：支持从本地目录加载插件，方便开发和测试 命令：无需重启即可重新加载所有插件组件 命令：四层校验插件目录结构和 manifest 有效性 🔧 改进优化 Venus 端点兼容适配器：支持 Venus OpenAI 兼容代理端点的 Prompt 缓存注入和请求字段清理，模型适配器与端点适配器可叠加使用 SDK MCP 工具过滤器：确保权限和 deny 规则正确应用于 SDK 注册的自定义工具 🐛 问题修复 AskPanel 竞态修复：修复 doneAsk/rejectAsk 与 approve/reject 的调用顺序问题，避免工具在获得答案前继续执行 图片消息类型修复： 使用正确的 类型替换图片占位，避免类型不匹配 📝 文档更新 插件市场文档：全面更新插件市场使用指南 CLI 文档更新：更新 CLI 参考、环境变量、HTTP API、斜杠命令等多篇文档的中英文版本"},{"id":"/cli/release-notes/v2.76.0","title":"🚀 CodeBuddy Code v2.76.0 发布","body":"🚀 CodeBuddy Code v2.76.0 发布 ✨ 新功能 GLM 5v Turbo 模型上线：新增 GLM 5v Turbo 多模态视觉模型，支持图片理解能力，让 AI 助手能够分析和理解图片内容，同步上线国内版和 iOA 版 🐛 问题修复 模型 temperature 配置修复：修复部分模型的温度参数（temperature）被错误地硬编码为默认值 1 的问题，现在正确读取产品配置中各模型指定的 temperature 值，确保模型以最佳参数运行"},{"id":"/cli/release-notes/v2.75.0","title":"🚀 CodeBuddy Code v2.75.0 发布","body":"🚀 CodeBuddy Code v2.75.0 发布 🔧 改进优化 微信实例 ID 动态更新：微信客户端扫码认证后，自动将临时实例 ID 更新为真实 ID，确保后续消息回复能正确路由到对应的微信账号 微信消息发送错误检查：消息发送接口增加返回值校验，发送失败时抛出明确的错误信息，便于问题排查"},{"id":"/cli/release-notes/v2.74.0","title":"🚀 CodeBuddy Code v2.74.0 发布","body":"🚀 CodeBuddy Code v2.74.0 发布 ✨ 新功能 侧问题命令 /btw 在 Agent 工作过程中，使用 快速提出侧问题，无需中断当前任务。答案基于已有上下文即时生成，适合在复杂任务中随时确认细节或获取补充信息。 🔧 改进优化 渠道会话建议确认：通过微信/企业微信渠道完成一轮对话后，自动生成后续建议并等待用户确认后再执行，避免不必要的自动操作 🐛 问题修复 AskUserQuestion 面板稳定性：修复当模型返回的选项数据不完整时，问答面板可能崩溃的问题"},{"id":"/cli/release-notes/v2.73.0","title":"🚀 CodeBuddy Code v2.73.0 发布","body":"🚀 CodeBuddy Code v2.73.0 发布 ✨ 新功能 Channel 建议确认 通过微信/企业微信渠道完成一轮对话后，系统会自动生成下一步操作建议并发送给用户确认，回复 y 即可继续执行，让渠道交互更加流畅自然。 🔧 改进优化 微信/企微权限三选项：权限请求提示从 升级为 ，支持记住选择，减少重复确认 修复权限卡死：微信/企微中回复非选项内容时不再卡死，自动拒绝当前权限并将输入作为新消息处理 上下文压缩优化：压缩前自动清理超过 1 小时的旧工具结果，实测可节省 80%+ 的压缩输入 token，显著降低压缩成本 图片内容剥离：压缩前自动将图片替换为占位符，避免无意义的图片 token 进入摘要 压缩提示词增强：改进 9 章节结构化摘要格式，提高压缩质量和信息保留率 JSON 修复增强：使用 jsonrepair 库替换自定义修复逻辑，支持修复中文引号、缺失逗号、截断 JSON 等更多畸形场景，减少不必要的模型重试 🐛 问题修复 渠道消息斜杠命令：修复从微信等渠道发送的斜杠命令因被标签包裹而无法正确识别的问题 队列消息命令保留：消息队列处理时保留斜杠命令，等 agent 空闲后通过正常管道执行，避免命令被吞掉"},{"id":"/cli/release-notes/v2.72.0","title":"🚀 CodeBuddy Code v2.72.0 发布","body":"🚀 CodeBuddy Code v2.72.0 发布 ✨ 新功能 文件变更面板 Web UI 新增 Changes 视图，让你可以实时查看 Agent 修改的所有文件。点击文件即可打开 Monaco Diff 编辑器，以语法高亮的方式对比查看每个文件的具体变更内容。 Checkpoint 回退 新增强大的代码回退能力，支持三种灵活的回退模式： 按文件撤回：精确撤回单个文件的修改 按回退点回退：回到之前的某个对话节点 多模式选择：仅回退代码、仅回退对话、或全部回退 🔧 改进优化 Diff 查看体验升级：从自定义 diff 算法迁移到 Monaco DiffEditor，支持语法高亮，大文件查看更流畅 文件图标优化：消除图标加载时的闪烁问题，文件列表展示更顺滑 会话状态恢复：刷新页面后自动恢复文件变更面板状态，不丢失上下文 实时变更通知：Agent 修改文件后，所有已连接的客户端都会实时收到变更通知 插件管理 API：新增公开 REST API 管理插件的安装、卸载、启用和禁用 配置管理 API：新增公开 REST API 查询和修改配置，支持按作用域操作 剪贴板兼容性增强：macOS 图片粘贴新增 JXA NSPasteboard 后备方案，兼容企业微信等第三方截图工具 消息通知优化：优化微信和企微 Channel 中工具操作的中文描述，更易理解"},{"id":"/cli/release-notes/v2.71.1","title":"🚀 CodeBuddy Code v2.71.1 发布","body":"🚀 CodeBuddy Code v2.71.1 发布 🔧 改进优化 SDK MCP 超时机制：将固定超时替换为 AbortSignal 取消机制，支持长时间运行的 MCP 工具调用，避免复杂工具因超时被意外中断 推理模型配置：启用 thinking 模式时自动默认 effort 为 high，确保模型实际产出推理输出 产品配置修复：修正模型配置中 reasoning 字段的拼写错误"},{"id":"/cli/release-notes/v2.71.0","title":"🚀 CodeBuddy Code v2.71.0 发布","body":"🚀 CodeBuddy Code v2.71.0 发布 ✨ 新功能 Web UI 代码编辑器 Web UI 新增文件浏览和代码编辑功能，让你可以直接在浏览器中查看和编辑项目文件： 目录树导航：左侧面板展示项目文件结构，快速定位文件 多标签编辑：同时打开多个文件，在标签间自由切换 Monaco Editor：集成 VS Code 同款编辑器引擎，支持语法高亮 自动保存：编辑内容自动保存，无需手动操作 文件拖拽移动：支持拖拽文件进行移动操作 键盘快捷键：支持常用快捷键，提升编辑效率 🔧 改进优化 流式超时时间优化：将流式响应超时和首 token 超时默认值从 2 分钟提升至 10 分钟，减少复杂任务中因模型响应较慢导致的超时中断。仍可通过 和 环境变量自定义"},{"id":"/cli/release-notes/v2.70.1","title":"CodeBuddy Code v2.70.1 发布","body":"CodeBuddy Code v2.70.1 发布 🔒 安全修复 CORS 跨域攻击防护 修复了本地 Gateway 服务（ ）存在的跨域请求安全漏洞。此前，恶意网页可通过 JavaScript 跨域访问用户本地 localhost 服务，执行 Agent 命令或窃取输出数据。 主要修复内容： 替换框架默认的 为精确白名单机制，仅允许 localhost、127.0.0.1 和 Tunnel URL 的跨域请求 新增 Host 头验证中间件，防止 DNS Rebinding 攻击 修复 SSE 流式端点的 CORS 通配符漏洞 默认绑定地址从 改为 ，避免服务暴露到局域网 🔧 改进优化 自定义跨域规则：支持通过环境变量 （逗号分隔）或 Settings 配置 自定义允许的跨域源，满足特殊场景需求"},{"id":"/cli/release-notes/v2.70.0","title":"🚀 CodeBuddy Code v2.70.0 发布","body":"🚀 CodeBuddy Code v2.70.0 发布 ✨ 新功能 内置命令模型驱动调用 AI 模型现在可以通过 Skill 工具直接执行部分内置斜杠命令（如 /clear、/model、/config、/resume、/gateway 等），让 WebChat、微信等非终端场景也能由模型代理执行命令，无需用户手动输入斜杠命令。 /model、/config、/resume 等命令新增 子命令，支持以文本方式列出可用选项 通过 字段统一控制内置命令和自定义命令是否允许模型调用 🔧 改进优化 实例注册地址简化：将 localUrl/tunnelUrl 合并为统一的 url 字段，后端自动确定最佳可达地址，简化配置 权限确认框稳定性：使用 useSyncExternalStore 替代 useEffect 订阅模式，彻底解决权限确认框偶发不显示的竞态问题 会话权限模式保持：修复多实例场景下切换会话时权限模式被重置的问题"},{"id":"/cli/release-notes/v2.69.0","title":"🚀 CodeBuddy Code v2.69.0 发布","body":"🚀 CodeBuddy Code v2.69.0 发布 ✨ 新功能 E2B 兼容 API 全面对齐 E2B 开放协议，让 CodeBuddy Code 可作为 E2B 兼容的沙箱环境使用： 文件系统 API：新增 和 端点，支持文件读写、目录操作、文件监听等完整文件系统功能 进程管理 API：新增 端点，支持进程启动（PTY/管道）、输入输出流、信号发送等全生命周期管理 系统指标与环境变量 API：新增 和 端点，提供 CPU/内存/磁盘使用指标和环境变量查询 🔧 改进优化 PTY 终端增强：新增 SSE 输出流、HTTP 输入发送、HTTP resize 端点，提供 WebSocket 之外的纯 HTTP 替代方案 终端 Web UI 重构：前端终端组件从 WebSocket 迁移到 SSE + HTTP 通信，提升跨平台兼容性 分布式追踪：基于 Hook 机制重构 trace 链路，支持 SDK 传递 traceId 实现端到端追踪，每次工具调用自动创建子 Span WeChat 多实例支持：支持同时连接多个 WeChat 机器人实例，自动路由消息到正确的客户端 WeChat 媒体消息：支持接收和发送图片、文件、语音、视频消息 中文引号修复：自动修复模型输出中的中文引号，避免工具调用 JSON 解析失败 🔒 安全修复 企业微信 SSRF 防护：企业微信机器人媒体下载添加 URL 白名单校验，确保仅限企微官方 CDN 域名，防止服务端请求伪造攻击"},{"id":"/cli/release-notes/v2.68.0","title":"🚀 CodeBuddy Code v2.68.0 发布","body":"🚀 CodeBuddy Code v2.68.0 发布 ✨ 新功能 Web UI 文档查看器 在 Web UI 中新增文档浏览功能，无需离开工作界面即可查阅 CLI 使用文档： 支持全文搜索，快速定位所需内容 中英文切换，满足不同语言偏好 目录导航和 TOC，方便浏览长文档 API Reference 快捷链接，直接跳转到 Swagger UI 支持在新标签页中独立全屏打开 构建时自动打包 CLI 文档，支持离线查看 🔧 改进优化 HTTP API 标准化：所有公开端点统一到 前缀，支持版本控制；内部端点迁移到 ，结构更清晰 API 文档：新增 Swagger UI（ ）和 OpenAPI 规范（ ），方便开发者探索和调试 API 统一响应格式：公开端点采用标准 / 信封格式，提升 API 一致性 ACP 端点迁移：ACP 协议端点从 迁移到 ，与 REST API 统一路由前缀 凭证存储优化：WeChat 和 WeCom 凭证统一为单文件 格式，支持自动迁移旧格式 API 响应兼容：Web UI 适配统一信封格式，确保 REST 端点响应正确解析 🐛 问题修复 确认框显示：修复 AskUserQuestion 确认框偶发不显示的问题，解决路由导航中的竞态条件 文档链接格式：修正 Channels 文档中 localhost 链接的格式"},{"id":"/cli/release-notes/v2.67.0","title":"🚀 CodeBuddy Code v2.67.0 发布","body":"🚀 CodeBuddy Code v2.67.0 发布 ✨ 新功能 企业微信 Channel Bridge 企业微信 AI Bot 消息现在可以通过 channel 系统直接注入 Agent 会话，支持使用 WeComReply 工具回复 markdown 格式消息，同时支持群聊和私聊场景。 多实例接入与管理 WeChat 和 WeCom 均支持同时连接多个 bot 实例 通过 面板交互式添加和管理连接 WeChat 直接扫码绑定，WeCom 输入 Bot ID + Secret 后自动连接，凭证持久化到磁盘 Web UI 远程控制管理 新增远程控制页面，支持可视化管理渠道连接（连接/断开/解绑/删除），包括 WeChat QR 扫码和 WeCom 表单添加。 企业微信媒体消息支持 WeComReply 工具新增图片、文件、视频等媒体消息的上传与发送能力 支持接收用户发送的图片和文件消息，自动下载解密 改进微信客服的图片和文件消息处理 🔧 改进优化 环境变量控制最大轮次：支持通过 和 环境变量分别控制主 Agent 和子 Agent 的最大执行轮次 企业微信媒体解密：对齐官方 SDK 使用 AES 256 CBC 算法，增加格式自动检测 🐛 问题修复 Rewind 虚假 diff：修复 compact 后 rewind 显示不存在的文件变更问题，compact 消息现在正确继承文件快照状态 PTY 文件描述符泄漏：PTY service 和后台任务的 fd 清理逻辑增强，确保异常路径下也能正确释放资源"},{"id":"/cli/release-notes/v2.66.2","title":"🚀 CodeBuddy Code v2.66.2 发布","body":"🚀 CodeBuddy Code v2.66.2 发布 🐛 问题修复 模型设置同步：修复通过 SDK/控制信号设置模型时选项未同步更新的问题，确保模型选择在所有读取路径上保持一致"},{"id":"/cli/release-notes/v2.66.1","title":"🚀 CodeBuddy Code v2.66.1 发布","body":"🚀 CodeBuddy Code v2.66.1 发布 🔧 改进优化 Channel 权限中继：支持通过 Channel（如微信）确认工具权限请求，声明了权限中继能力的 Channel 不再强制自动批准，而是将确认请求转发给用户 微信权限确认：工具执行需要权限时，通过微信消息发送自然语言确认请求，用户回复 y/n 即可批准或拒绝 微信问答支持：AskUserQuestion 工具在微信中可发送问题选项，用户回复编号或自由文本选择答案 微信计划确认：ExitPlanMode 时自动读取计划摘要并展示给用户，在微信中确认后再开始执行 🐛 问题修复 微信 Channel 回复工具：修复偶发找不到回复工具的问题，消除连接过程中的竞速条件 微信问答重复提示：修复 AskUserQuestion 同时发送问答消息和权限确认消息的问题 微信问答参数解析：修复问答参数为 JSON 字符串时未正确解析的问题"},{"id":"/cli/release-notes/v2.66.0","title":"🚀 CodeBuddy Code v2.66.0 发布","body":"🚀 CodeBuddy Code v2.66.0 发布 ✨ 新功能 思考模式默认开启 全局默认启用 thinking 模式，无需手动配置即可获得更强的推理能力，复杂代码分析和多步骤任务处理更加精准。 🐛 问题修复 Token 计数器：修复右下角 token 计数器始终显示 0 的问题 状态栏成本显示：修复状态栏脚本接收到错误成本数据的问题 状态栏初始化：修复状态栏首次渲染时可能不显示的问题 上下文百分比：修复上下文使用百分比在接近上限时显示不准确的问题 内存泄漏：修复状态栏管理器订阅未正确清理的问题"},{"id":"/cli/release-notes/v2.65.1","title":"🚀 CodeBuddy Code v2.65.1 发布","body":"🚀 CodeBuddy Code v2.65.1 发布 🐛 问题修复 无头模式执行稳定性 移除 headless 模式下固定 60 秒强制退出逻辑，避免长时间运行的 CLI、SDK 或自动化脚本在任务尚未完成时被提前终止。 长耗时请求不再因为固定超时被误中断 提升非交互调用场景下的执行稳定性 更适合持续运行或等待外部响应的自动化流程"},{"id":"/cli/release-notes/v2.65.0","title":"🚀 CodeBuddy Code v2.65.0 发布","body":"🚀 CodeBuddy Code v2.65.0 发布 ✨ 新功能 Channel 消息通道 支持通过 MCP 协议接收外部消息源（如企业微信机器人、微信客服等），实现多通道消息汇聚和处理。 启动界面自动显示已配置的 Channel 列表 对话中以友好格式展示 Channel 来源消息 支持发送者白名单和权限中继等安全管控机制 🔧 改进优化 非交互模式后台任务管控：在 headless、SDK、print 模式下自动禁用后台执行参数，避免非交互环境中产生无法管理的后台任务 🐛 问题修复 后台任务 PTY 泄漏：修复后台任务被终止时未释放 PTY 文件描述符的问题，避免长时间运行后系统资源耗尽"},{"id":"/cli/release-notes/v2.64.2","title":"🚀 CodeBuddy Code v2.64.2 发布","body":"🚀 CodeBuddy Code v2.64.2 发布 🔧 改进优化 登录方式简化：移除启动时的内网环境嗅探逻辑，所有登录方式（含 iOA）始终显示，无需等待网络检测 国内版模型排序：调整国内版模型列表中 glm 5.0 系列的显示顺序，提升选择体验 🐛 问题修复 上下文压缩重复触发：修复压缩完成后立即再次触发压缩的问题，避免不必要的重复压缩循环，提升长对话稳定性 会话持久化异常：修复大工具结果外部化后误同步回内存导致模型无法理解工具输出的问题，确保工具结果正确保存和读取"},{"id":"/cli/release-notes/v2.64.1","title":"🚀 CodeBuddy Code v2.64.1 发布","body":"🚀 CodeBuddy Code v2.64.1 发布 🐛 问题修复 终端分屏稳定性：修复分屏操作导致终端被意外重置的问题，PTY session 仅在用户主动关闭面板时销毁 消息气泡过滤：修复用户消息气泡中偶现系统内部标签内容的问题，确保界面展示干净"},{"id":"/cli/release-notes/v2.64.0","title":"🚀 CodeBuddy Code v2.64.0 发布","body":"🚀 CodeBuddy Code v2.64.0 发布 ✨ 新功能 Web UI 全面增强 Web UI 迎来全面升级，带来焕然一新的使用体验： 全新界面风格：重新设计的侧边栏导航、状态栏和登录页面，统一视觉风格和交互体验 多视图支持：新增历史会话、任务管理、插件管理等视图，信息组织更清晰 品牌加载动画：新增猫爪品牌加载动画，替换通用 spinner 终端优化：支持终端标题显示，主题切换时自动刷新配色 实例管理增强：优化实例管理面板布局和交互 跨会话切换： 命令支持跨会话切换，Web UI 同步更新 🔧 改进优化 大工具结果外部化：工具返回超过 50KB 的结果时，自动保存到磁盘并在对话历史中保留摘要，防止长时间运行会话的内存无限增长 Agent 任务内存清理：定时清理已完成任务记录和过期 Team 成员会话引用，修复长时间运行场景下的内存泄漏 诊断面板增强： 面板新增内存使用量和任务统计信息，便于排查资源问题 TLS 验证跳过：修复无代理场景下禁用 TLS 验证不生效的问题 子代理工具重命名：将 Task 工具重命名为 Agent，命名更准确地反映功能定位 ACP 流优化：POST stream 延迟关闭机制，解决 tunnel 场景下通知丢失问题 Gateway 安全提示：新增风险提示和网络访问配置引导 消息队列修复：取消请求时保留队列消息，避免排队消息丢失 Token 用量修复：修复压缩后百分比虚高导致重复压缩的问题 Rewind 修复：优先使用修改前的文件状态进行恢复，提升回退准确性 🐛 问题修复 问答确认框显示：修复偶发的 AskUserQuestion 确认框\"看不见\"问题，确保导航前服务状态就绪 📝 文档更新 新增 v2.62.1 v2.63.4 共 6 个版本的发布说明 新增环境变量参考文档 更新 HTTP API、设置、故障排除等文档"},{"id":"/cli/release-notes/v2.63.5","title":"🚀 CodeBuddy Code v2.63.5 发布","body":"🚀 CodeBuddy Code v2.63.5 发布 🔧 改进优化 遥测控制：支持通过环境变量禁用遥测数据上报，提升隐私保护灵活性 图片格式识别：支持通过文件魔数（magic bytes）检测图片 MIME 类型，当文件扩展名与实际内容不匹配时仍能正确识别格式"},{"id":"/cli/release-notes/v2.63.4","title":"🚀 CodeBuddy Code v2.63.4 发布","body":"🚀 CodeBuddy Code v2.63.4 发布 🔧 改进优化 SDK 场景稳定性：禁用 SDK 模式下的 CLI 自动更新，防止进程重启导致后续请求瞬间返回，提升 SDK 集成场景的可靠性 会话恢复可靠性：修复重新初始化会话时历史消息未正确清理导致的消息消费异常，确保会话恢复后消息处理正常 子代理进度显示优化：将子代理和 Team 成员进度中的 token 统计从累计消耗量改为当前上下文窗口大小，更直观地反映实时上下文使用情况 E2E 测试增强：客户端自动响应 AskUserQuestion，命令名验证支持 Unicode 字符"},{"id":"/cli/release-notes/v2.63.3","title":"🚀 CodeBuddy Code v2.63.3 发布","body":"🚀 CodeBuddy Code v2.63.3 发布 🔧 改进优化 Subagent 上下文压缩修复：修复子代理（Subagent）在上下文压缩后无法恢复运行的问题，确保长对话场景下子代理执行的稳定性 上下文压缩质量提升：修复压缩过程中内部标签可能泄漏到摘要内容的问题，提升压缩后上下文的准确性"},{"id":"/cli/release-notes/v2.63.2","title":"🚀 CodeBuddy Code v2.63.2 发布","body":"🚀 CodeBuddy Code v2.63.2 发布 🔧 改进优化 超时重试增强：首 token 超时支持最多 2 次重试并增加线性延迟（2s/4s），提高网络波动场景下的恢复成功率 消息队列处理：修复超时错误处理后队列中累积的用户消息无法被处理的问题，确保对话流畅性 状态一致性：修复错误处理中状态重置逻辑的竞态条件，确保重试和队列处理的正确性"},{"id":"/cli/release-notes/v2.63.1","title":"🚀 CodeBuddy Code v2.63.1 发布","body":"🚀 CodeBuddy Code v2.63.1 发布 🐛 问题修复 Malformed JSON 上下文污染修复：修复当 AI 模型偶发生成格式错误的工具调用参数时，错误重试提示未被及时清理的问题。此前，该提示消息会在后续每轮对话中被重复发送给模型，造成上下文污染和不必要的 token 消耗。修复后，重试提示会在下一轮对话中自动清理，保持对话上下文的整洁"},{"id":"/cli/release-notes/v2.63.0","title":"🚀 CodeBuddy Code v2.63.0 发布","body":"🚀 CodeBuddy Code v2.63.0 发布 ✨ 新功能 禁用 TLS 验证 支持通过产品功能开关禁用 HTTPS 请求的 TLS 证书验证，适用于使用自签名证书或内部 CA 证书的私有化部署环境，无需额外配置系统证书即可正常连接。 🔧 改进优化 插件市场埋点：新增插件市场操作埋点，支持追踪市场添加/删除/刷新、插件安装/卸载/启用/禁用等用户行为，帮助优化插件生态体验 Centrifugo 连接策略：关闭 Centrifugo 自动连接，改为按需手动启动，减少不必要的网络开销 配置面板精简：移除 /config 面板中不再使用的 Wecom 配置项，界面更加清爽 🐛 问题修复 自动重试竞态修复：修复网络错误自动重试时， 事件过早触发导致父任务误判子代理失败的问题 超时时间优化：将流式传输超时和首 token 超时从 60 秒提升至 120 秒，减少弱网环境下的误断连 上下文压缩稳定性：修复压缩过程中 abort 信号级联导致会话卡死的问题，提升长对话场景下的可靠性"},{"id":"/cli/release-notes/v2.62.1","title":"🚀 CodeBuddy Code v2.62.1 发布","body":"🚀 CodeBuddy Code v2.62.1 发布 🔧 改进优化 上下文压缩优化：重构压缩摘要注入机制，压缩后的上下文以更结构化的方式恢复，提升长对话中的上下文连贯性；同时提高了自动压缩触发阈值，减少不必要的压缩中断；压缩过程不再混入系统规则和记忆内容，确保摘要更精准 SDK 通信稳定性：修复多个 SDK 通信层的稳定性问题，包括并发写入交错、断连后权限请求挂起、中断响应不完整等；Python SDK 增强了 JSON 缓冲区的容错能力，JS SDK 改进了背压处理机制 企微机器人交互体验：使用流式消息替代静态文本展示处理状态，完成后自动替换为最终结果，聊天记录更加整洁 📝 文档更新 企微机器人文档导航：统一相关文档的侧边栏标题，修复中文版重复条目"},{"id":"/cli/release-notes/v2.62.0","title":"🚀 CodeBuddy Code v2.62.0 发布","body":"🚀 CodeBuddy Code v2.62.0 发布 ✨ 新功能 Delegate Tool 支持（实验性） 新增 DelegateTool 工具，允许 Agent 调用由外部客户端（如 Web UI、IDE 插件）注册的委托工具，实现 UI 查询和 UI 控制等功能。这为 CodeBuddy Code 与外部工具链的集成提供了更灵活的扩展能力。 🔧 改进优化 远程控制重构：将 命令统一为通用 命令，支持多种长连接客户端的统一管理，新增交互式 UI 面板快速选择客户端连接 远程控制本地命令快速执行：新增快速检测本地命令的机制，避免为 、 等本地命令显示不必要的等待提示 模型兼容性增强：新增 OpenAI 模型适配器，自动处理不兼容参数；Gemini 适配器增加 JSON Schema 字段清理，修复工具参数导致的 400 错误 流超时处理优化：将默认流超时从 30 秒调整为 60 秒，新增智能检测避免已完成响应被误判为超时 Bash 工具描述优化：对复杂命令提供更清晰的说明示例，细化危险命令列表 记忆路径结构：项目记忆目录对齐标准路径结构，修复菜单中路径显示不完整的问题 🐛 问题修复 ACP 会话管理：修复 newSession 请求默认复用旧会话的问题，改用 continue 字段显式控制会话复用行为 AbortController 泄漏：统一使用 防止长会话中监听器累积告警"},{"id":"/cli/release-notes/v2.61.3","title":"🚀 CodeBuddy Code v2.61.3 发布","body":"🚀 CodeBuddy Code v2.61.3 发布 🔧 改进优化 启动稳定性提升：修复 CLI 启动时认证初始化超时和远程控制服务异步初始化导致的启动失败问题，提升冷启动成功率 Moonshot 模型兼容性：优化 tool message content 解析逻辑，避免将普通字符串数组（如文件路径列表）错误转换为 content block，提升 Moonshot 模型的工具调用稳定性 插件更新机制优化：改用 fetch + reset 策略替代 pull，解决插件 Git 仓库本地与远端分叉时更新失败的问题 SDK 交互能力修复：修复 SDK 模式下交互式工具（如 AskUserQuestion）被意外禁用的问题，同时确保 Print 模式下正确禁用交互式工具 Web 搜索升级：迁移到新版搜索 API，优化响应解析和错误处理 🐛 问题修复 第三方 API 连接修复：修复使用 模式连接第三方 API 时 Authorization 头被误删导致 401 错误的问题，同时过滤 系列头避免 400 错误"},{"id":"/cli/release-notes/v2.61.2","title":"🚀 CodeBuddy Code v2.61.2 发布","body":"🚀 CodeBuddy Code v2.61.2 发布 🔧 改进优化 企业微信 AI Bot WebSocket 兼容性：将 WebSocket 实现迁移到 W3C 标准 API，同时支持 Bun 和 Node.js 双运行时，提升跨平台兼容性 企业微信 AI Bot 自动连接：新增 启动参数，启动时自动连接企业微信 AI Bot，无需手动执行 命令"},{"id":"/cli/release-notes/v2.61.1","title":"🚀 CodeBuddy Code v2.61.1 发布","body":"🚀 CodeBuddy Code v2.61.1 发布 🔧 改进优化 SDK 版本更新：升级 Agent SDK JS 至 0.3.81，保持 SDK 与 CLI 的版本同步"},{"id":"/cli/release-notes/v2.61.0","title":"🚀 CodeBuddy Code v2.61.0 发布","body":"🚀 CodeBuddy Code v2.61.0 发布 ✨ 新功能 记忆系统全面升级 快捷键记忆保存： 快捷键现在将记忆保存到 CODEBUDDY.md，支持选择 Project 或 User 两种作用域，更灵活地管理个人和项目级偏好 Auto Memory 独立控制：新增 管理面板，支持独立开关 Auto Memory，也可通过 面板切换 Typed Memory（实验性）：支持 4 种结构化记忆类型（user/feedback/project/reference）和 YAML frontmatter 格式，让记忆更有条理 /memory 命令参数调用：支持通过参数直接保存记忆，无需导航到管理页面 🔧 改进优化 工具搜索与执行解耦：ToolSearch 改为返回完整参数 schema 由代理执行，保持上下文前缀稳定以提升 KV 缓存命中率 上下文管理优化：降低 token 使用量告警阈值，使上下文压缩更早触发，减少因上下文过长导致的对话质量下降 Shell 性能优化：优化 PTY fd 泄漏检测机制，避免阻塞事件循环 企业微信机器人超时修复：采用两阶段回复机制避免 30s 流式超时问题，长时间运行的 Agent 任务可正常返回结果 Web UI 会话同步：在 Web UI 中执行 /clear 或新建对话时，CLI 终端视图同步刷新 文件路径补全：Web UI 输入框支持 @ 触发文件路径补全，选中后自动添加空格 提示词建议：Web UI 支持显示 CLI 端生成的 prompt suggestion，按 Tab 快速采纳 🐛 问题修复 工具调用重试：修复模型返回不合法 JSON 参数时直接报 400 错误的问题，现在会告知模型具体的 JSON 解析错误并自动重试 子代理 Hook 隔离：跳过子代理 session 的 Stop/UserPromptSubmit hooks 执行，避免子代理触发主 session 专用的钩子逻辑 SubagentStop Hook 竞态修复：防止多检测路径并发导致 hook 重复触发 权限通配符匹配：修复 等通配符权限规则无法匹配包含路径参数的命令的问题 Web UI 清空会话：修复 /clear 后触发重复 render 循环导致的异常 斜杠指令加载：修复通过 tunnel 访问时斜杠指令列表无法加载的问题"},{"id":"/cli/release-notes/v2.60.0","title":"🚀 CodeBuddy Code v2.60.0 发布","body":"🚀 CodeBuddy Code v2.60.0 发布 ✨ 新功能 企业微信机器人远程控制 支持通过企业微信 AI Bot 长连接远程控制 CodeBuddy Agent，无需公网 IP，使用 命令即可快速接入。同时将远程控制模块重构为可扩展的多客户端注册架构，方便后续接入更多 IM 平台。 🔧 改进优化 自定义模型认证错误优化：自定义模型返回 401 错误时，不再触发自动登出，并提供针对性的 API Key 检查提示；当指定模型不存在时，自动列出当前账户可用的模型列表 恢复会话面板：当前正在使用的会话会以绿色高亮显示并带有勾号标记，方便快速识别 Web 端命令处理：移除客户端侧斜杠命令拦截，统一由服务端处理命令逻辑 🐛 问题修复 图片历史还原：修复图片 blob 引用追踪时序问题，确保历史图片去重判断正确，避免模型收到未解析的 blob 引用 嵌套 Skills 加载：修复包含子 Skills 的目录无法被发现和加载的问题，同时增加扫描深度上限以支持更深层嵌套结构 跳过内部请求头：修复 CODEBUDDYSKIPINTERNALHEADERS 环境变量不生效的问题，确保连接第三方网关时内部请求头被正确清理 Tracing 初始化：修复部分用户终端出现 \"No API key provided for OpenAI tracing exporter\" 报错的问题"},{"id":"/cli/release-notes/v2.59.0","title":"🚀 CodeBuddy Code v2.59.0 发布","body":"🚀 CodeBuddy Code v2.59.0 发布 ✨ 新功能 Hook 驱动的 Worktree 支持 为 SVN、Perforce 等非 Git 版本控制系统提供隔离工作区能力。通过 和 Hook 事件，您可以完全自定义 worktree 的创建和清理逻辑，不再局限于 Git 仓库： 即使在 Git 仓库中，若配置了 Hook，也会优先使用 Hook based 方式 Hook based worktree 退出时始终显示保留/删除菜单，避免非 Git 项目因缺少 Git 命令导致异常 Worktree 指定基础分支 参数现在支持配套使用 来指定基础分支： 支持远程分支（ ）和本地分支（ ）两种格式 分支不存在时自动降级到远程默认分支并打印警告，不中断启动流程 工具同步支持 参数 🔧 改进优化 Plan 模式审批：修复 ExitPlanMode 工具在 Web UI 中审批时无法正确显示 plan 内容的问题，现在用户可以在审批弹窗中看到完整的计划内容和权限请求列表 图片读取去重优化：修复同一路径图片被修改后重新读取时被错误去重的问题，现在能正确识别文件更新并返回最新图片内容 Worktree Hook 兼容性：补齐 和 的 SDK 协议与文档说明，确保自定义 worktree hook 能接收完整上下文并稳定接入 🐛 问题修复 ACP 连接清理：修复新建聊天时旧连接未正确清理，导致广播消息重复渲染的问题"},{"id":"/cli/release-notes/v2.58.0","title":"🚀 CodeBuddy Code v2.58.0 发布","body":"🚀 CodeBuddy Code v2.58.0 发布 ✨ 新功能 微信客服 & 企业微信远程网关 新增微信客服（WeChat KF）和企业微信（WeCom）平台接入能力，支持通过 Webhook 回调接收消息并主动回复。微信客服适配器包含回调签名校验、AES 加解密、syncmsg 消息拉取、客服账号自动创建等完整能力。 🔧 改进优化 Python SDK 认证增强：新增独立认证 API（ / ），支持 two phase 登录流程，重构控制请求机制支持请求 响应匹配和超时处理 Python SDK 类型完善：新增 、 、 等类型定义 SDK 错误诊断改进：Python SDK 新增启动崩溃检测和 stderr 捕获，JS SDK 改进进程退出原因追踪和错误类型导出 Headless 模式稳定性：重构模块导出为三层结构，消除 headless 构建中的 IoC 解析失败 隧道连接优化：强制使用 HTTP/2 替代 QUIC 提升兼容性，支持 detached cloudflared 进程跨会话复用，新增 tunnel state.json 管理多端口并发隧道 插件市场自动更新：市场详情页新增启用/禁用自动更新开关，内置市场默认开启，第三方市场默认关闭 配置缓存隔离：修复 CLI 临时参数（如 ）污染配置缓存的问题 Web UI 改进：历史回放支持展示用户消息中的图片并新增放大查看，子代理支持折叠/展开，工具调用统一可点击 Web UI Bun SFE 兼容：支持将静态文件嵌入 Bun 单文件可执行程序，兼容扁平模式下的资源加载 Gateway 命令体验：启动 Gateway 服务时显示 Loading 动画，防止用户重复操作 任务进度显示优化：优化 loading box 中任务和队友描述的文本截断，避免长文本溢出 🎨 界面优化 暗色主题视觉优化：调暗并统一了暗色模式下各组件的边框颜色，使其在暗色背景下更加柔和自然 🐛 问题修复 Hooks 执行挂起：修复 hook 脚本启动后台进程时导致执行挂起的问题 SubagentStop Hook：修复回调中 transcriptpath 指向不存在文件的问题 子代理交互：修复子代理中 AskUserQuestion 被自动批准导致无法在主界面显示问题面板的问题 Compact 历史链：修复 compact agent 因历史截断导致上下文不完整的问题，修正多条 assistant 消息场景下的分组错误 工具审批导航：修复确认框消失后输入框不可见的渲染问题 模型同步：修复 Web UI 切换模型后 CLI 未同步更新的问题"},{"id":"/cli/release-notes/v2.57.1","title":"🚀 CodeBuddy Code v2.57.1 发布","body":"🚀 CodeBuddy Code v2.57.1 发布 🔧 改进优化 无头模式定时任务能力补齐 无头模式现已补齐定时任务相关能力的导出。在脚本、SDK 和服务端集成场景中，可以更直接地使用定时任务功能，减少额外封装和接入成本。 支持在无头集成场景中直接访问定时任务相关能力 让脚本、SDK 与交互式 CLI 的能力边界更加一致"},{"id":"/cli/release-notes/v2.57.0","title":"🚀 CodeBuddy Code v2.57.0 发布","body":"🚀 CodeBuddy Code v2.57.0 发布 ✨ 新功能 Remote Gateway（Beta） 全新的远程控制功能，支持通过 Cloudflare Tunnel 从任意设备远程访问您的 CodeBuddy Code CLI 会话。内置完整的 Web UI，包含： 远程终端面板，支持分屏布局和实时 WebSocket 通信 交互式问答面板，可在 Web UI 中直接回答 Agent 提问 对话压缩和 Team 进度的可视化展示 安全认证和多客户端同步 定时任务 支持创建定时任务，让 CodeBuddy 按计划自动执行重复性工作。通过简单的 cron 表达式即可设定执行周期，支持查看和取消已创建的任务。 🔧 改进优化 Hook 输出折叠配置：新增 设置项，可通过 面板控制 Hook 输出默认是否折叠 首 token 超时检测优化：改为检测模型有意义的输出，避免服务器心跳导致超时检测失效，并增强重试机制稳定性 子代理 MCP 继承：子代理现在可以正确使用父代理配置的 MCP 服务器工具 Fish shell 键盘兼容：修复在 Fish shell 3.4+ 搭配 Kitty keyboard protocol 终端中按键无响应的问题 工具搜索参数优化：增强参数描述，提供更好的使用指引 🐛 问题修复 API 错误响应处理：修复 API 返回错误时（如频率限制）UI 卡住的问题 MCP OAuth 认证：修复 OAuth Provider 缓存查找失败的问题，确保认证流程稳定可靠 内存泄漏警告：修复长时间运行时 abort 监听器超出上限导致的 MaxListenersExceededWarning 流式输出格式：修复 JSON 输出的格式和完整性问题 Hooks 中文编码：修复 Windows 上 Hook 修改工具参数时中文内容乱码的问题"},{"id":"/cli/release-notes/v2.56.1","title":"🚀 CodeBuddy Code v2.56.1 发布","body":"🚀 CodeBuddy Code v2.56.1 发布 🐛 问题修复 对话压缩显示：修复压缩对话组的完成判断逻辑，改为检查是否包含 assistant 回复而非固定消息数量，避免在特殊情况下压缩状态显示异常"},{"id":"/cli/release-notes/v2.56.0","title":"🚀 CodeBuddy Code v2.56.0 发布","body":"🚀 CodeBuddy Code v2.56.0 发布 ✨ 新功能 Worktree PR 支持 支持从 CNB (Code Nebula Buddy) 平台 PR 链接创建 worktree，包括 cnb.woa.com 和 cnb.cool 等域名。在 worktree 中可以直接基于 PR 进行代码审查和修改。 🔧 改进优化 新增 GPT 5.4 模型：支持 272K 输入、128K 输出，具备推理和图片能力 MCP 面板优化：移除边框，按配置来源分组展示服务器列表，支持诊断信息展示，界面更加清晰直观 模型兼容性层：新增模型兼容性处理器，自动适配 Gemini、Moonshot 等第三方模型的 API 请求格式差异，减少手动配置 错误诊断增强：改进模型请求和 SDK Transport 的错误日志，支持流式错误响应体读取和进程关闭原因捕获，便于排查问题 工具搜索优化：将搜索和激活操作拆分为独立参数，提升调用清晰度；未匹配的工具名自动回退模糊搜索 用户查询标识：为用户消息添加标签包裹，帮助模型更准确地区分用户实际查询与系统上下文内容 📝 文档更新 MCP 环境变量扩展文档：新增环境变量扩展使用文档，包含语法说明、配置字段支持、示例和常见用例"},{"id":"/cli/release-notes/v2.55.1","title":"🚀 CodeBuddy Code v2.55.1 发布","body":"🚀 CodeBuddy Code v2.55.1 发布 🔧 改进优化 MCP 环境变量默认值：MCP 配置新增 语法支持，当环境变量未设置时自动使用指定的默认值，简化 MCP 服务器配置流程 Worktree 初始化优化：改进 symlink 创建逻辑，支持文件和目录类型自动检测及冲突处理；优化 文件处理，提升大型仓库性能 Hooks Windows 路径兼容：修复 Windows 上 Git Bash 执行 hook 时路径使用反斜杠导致的解析问题，统一转换为 Unix 风格路径 🐛 问题修复 SDK 认证修复：修复登录时认证 URL 被错误覆盖的问题 环境配置保护：修复用户通过 或 显式设置的网络环境被自动覆盖的问题 SessionStart hook 竞态修复：修复首轮消息可能在 SessionStart hook 完成前被处理，导致注入的上下文丢失的问题"},{"id":"/cli/release-notes/v2.55.0","title":"🚀 CodeBuddy Code v2.55.0 发布","body":"🚀 CodeBuddy Code v2.55.0 发布 ✨ 新功能 Git Worktree 支持 全新的 Worktree 功能让你可以在独立的工作目录中并行开发，互不干扰： 使用 参数启动隔离的开发环境，安全地进行实验性修改 配合 参数在独立的 tmux 会话中运行，适合长时间任务 Agent 可通过 EnterWorktree 工具在会话中动态创建和进入 worktree 子代理任务自动继承 worktree 工作目录，确保文件操作路径正确 支持 和 事件钩子，可自定义 VCS 集成 退出时自动检测变更，提供清晰的操作选项，无变更的 worktree 自动清理 🔧 改进优化 工具搜索优化：ToolSearch 支持搜索和激活双模式，搜索模式下分层展示已激活工具和候选工具，激活模式下支持按名称精确激活 状态栏折行显示：状态栏长文本支持自动折行，不再截断隐藏超出部分 Diff 宽字符适配：修复 Diff 视图中包含中文、Emoji 等宽字符时折行位置不准确的问题 消息识别优化：优化用户消息识别逻辑，排除框架自动发送的队友消息"},{"id":"/cli/release-notes/v2.54.0","title":"🚀 CodeBuddy Code v2.54.0 发布","body":"🚀 CodeBuddy Code v2.54.0 发布 ✨ 新功能 Skills 嵌套子目录 支持在 目录中使用子目录来组织 Skills。嵌套的 Skill 会自动生成冒号分隔的限定名称（如 ），同时也支持短名称匹配，让 Skills 管理更加灵活有序。 🔧 改进优化 启动优化：避免 PromptContext 初始化过程中的重复执行，并发请求复用同一初始化结果，提升启动速度 模型选择优化：改进不同代理模式下的模型选择机制，提升配置灵活性 MCP 配置环境变量展开：MCP 服务器配置中的 占位符会自动替换为对应环境变量值，支持 stdio 的 command/args/env 和 SSE/HTTP 的 url/headers 字段，缺失的变量保留原样并生成诊断提示 上下文压缩稳定性：修复自动压缩流程中消息入队导致压缩不执行的问题，增强中断等待的健壮性；修复压缩过程中内部续行消息在聊天界面异常展示的问题 Vim 词移动增强：Vim 模式和快捷键的词移动（w/b/e）现在正确支持中日韩字符，每个 CJK 字符视为独立词 Gzip 压缩判断优化：当用户配置了自定义 API 地址或模型使用自定义 URL 时自动跳过 gzip 压缩，避免第三方服务不支持 gzip 导致请求失败 Hook 输出编码修复：修复在中文 Windows 系统上，Hook 脚本的错误信息显示为乱码的问题 /skills 面板增强：Skills 面板现在同时展示自定义斜杠命令，分组标题包含来源目录路径；Token 计数改为只统计描述部分，避免对上下文占用产生误解 截断重试优化：当工具调用参数过长导致输出被截断时，重试提示会根据工具类型给出具体的拆分建议；修复可能导致无限重试的循环问题 远程控制稳定性：优化 WebSocket 适配器实现和会话处理逻辑，提升连接稳定性 任务面板刷新：修复任务详情视图在任务状态更新时未同步刷新的问题 🐛 问题修复 Plan 确认框显示：修复退出 Plan 模式确认框中错误显示 \"Loading plan...\" 的问题，现在会正确加载并展示 Plan 内容 Custom Agents 来源显示：修复 命令中插件来源的 Custom Agent 显示 的问题"},{"id":"/cli/release-notes/v2.53.0","title":"🚀 CodeBuddy Code v2.53.0 发布","body":"🚀 CodeBuddy Code v2.53.0 发布 ✨ 新功能 企业微信远程控制 支持通过企业微信远程控制 CLI，实现移动端任务下发和结果推送。随时随地通过手机管理你的开发任务，不再局限于终端前操作。 🔧 改进优化 MCP 动态工具更新：支持 MCP 服务器的 通知，工具列表变化时自动刷新，无需重启或手动重连 Reasoning Effort 配置：在 /config 面板新增 Reasoning Effort 设置项，支持 auto/low/medium/high/xhigh 五个级别，自定义模型推理深度 状态栏增强：新增会话名称、权限模式、上下文窗口使用情况等字段，支持多行渲染，样式优化 LSP 服务器懒加载：LSP 服务器默认采用懒加载模式，仅在首次使用时启动，减少启动时资源占用 错误追踪增强：WebSearch 和 ImageGen 工具在 API 调用失败时，错误信息中包含 requestId，便于问题定位 非交互模式优化：改进 print 模式下工具权限被拒绝时的提示信息，提供清晰的绕过指引 文件自动补全刷新：修复输入 时无法提示新增文件的问题，文件列表缓存会在过期后自动刷新 Skill 工具结果优化：改进 Skill 和斜杠命令执行后的结果消息格式，使返回内容更清晰 Hook 输入处理器：新增 扩展点，支持在 Hook 执行前注入上下文字段 ACP 错误处理：改进 ACP 模式下的错误信息传输，客户端可获取更详细的错误状态码 🐛 问题修复 对话历史恢复：修复执行 compact 后 resume 会话时丢失压缩前上下文的问题 Team 中断信号隔离：子代理不再监听主 Session 的 abort 信号，避免内部操作误杀 Teammate 工具确认框冲突：修复多个 Teammate 同时请求权限时确认框互相覆盖的问题 消息投递可靠性：优化 Teammate 消息投递重试机制，未就绪时保持消息未读状态等待下次轮询 空闲唤醒机制：Teammate 空闲时收到消息会自动唤醒 Agent，不再卡在队列中 全局锁超时：工具审批全局锁增加 30 秒超时保护，防止死锁"},{"id":"/cli/release-notes/v2.52.6","title":"🚀 CodeBuddy Code v2.52.6 发布","body":"🚀 CodeBuddy Code v2.52.6 发布 🔧 改进优化 模型请求日志增强：新增请求生命周期完整日志，包含请求发送、首 Token 到达、流式传输进度、完成/错误/超时等关键节点，支持通过 requestId 和 agent 名称快速定位问题 消除运行时警告：修复长对话中出现的 MaxListenersExceededWarning 警告，封装统一的中止控制器管理工具，提升长会话下的稳定性 Hook 消息渲染增强：Hook 消息现在会根据执行状态（成功/阻断/警告/错误）显示不同的图标和颜色，并支持展开/折叠查看详细内容，提升可读性"},{"id":"/cli/release-notes/v2.52.5","title":"🚀 CodeBuddy Code v2.52.5 发布","body":"🚀 CodeBuddy Code v2.52.5 发布 🔧 改进优化 图片历史优化 对话历史中的图片数据通过 BlobStore 去重存储，仅最近 N 轮保留完整图片，更早轮次自动替换为文本占位符，显著降低上下文 token 消耗。同一轮对话中重复读取相同图片时返回引用提示而非重复发送完整数据。 主题系统重构 扩展主题色彩体系，支持语义化颜色（如 success、warning、error、info 等），增强终端颜色兼容性。新增 ChalkFactory 智能检测终端能力，自动适配颜色级别，支持色盲友好主题。 Gzip 压缩兼容修复：修复企业地址登录时请求体被错误压缩的问题，仅在 SaaS 和 iOA 环境下启用 gzip 压缩 自定义模型 URL 处理：自动为自定义模型的 URL 补全 后缀，用户无需手动拼接完整路径 Bash 超时配置：支持通过 settings env 动态配置 Bash 工具超时时间 🐛 问题修复 Hooks 命令执行：修复 等包含引号的 hook 命令执行失败的问题 登出竞态修复：修复登出过程中异步操作未及时终止，导致 session 被重新写回的问题 会话压缩标识修正：修复异步上下文压缩后会话身份被误判的问题，确保压缩消息正确归属主会话"},{"id":"/cli/release-notes/v2.52.4","title":"🚀 CodeBuddy Code v2.52.4 发布","body":"🚀 CodeBuddy Code v2.52.4 发布 🔧 改进优化 首 token 超时检测 新增请求发出后首个响应数据的超时检测机制，超时后自动断开并重试，避免长时间无响应的等待。同时将流数据监控间隔从 10 秒缩短至 1 秒，提升异常连接的检测速度。支持通过 和 环境变量自定义超时时间。 请求压缩 支持对 API 请求体进行 gzip 压缩，减少网络带宽消耗，提升慢速网络下的响应速度。 CLI 子命令别名：为 、 、 添加 简写别名，为 和 添加 选项 macOS 代码签名：修复 macOS 26+ 上因缺少 TeamIdentifier 导致多实例运行时被系统终止的问题 MCP 工具钩子修复：解决 MCP 工具的 PreToolUse/PostToolUse 钩子无法正确触发的问题 工具调用截断重试：优化模型输出超限导致工具调用参数被截断时的重试机制，提升重试成功率 Hook 权限确认提示优化：PreToolUse Hook 返回 ask 决策时，将决策原因以警告样式展示在权限确认框中 粘贴行为优化：粘贴文本内容时不再自动检测是否为图片路径并转换，粘贴的文字始终原样插入 Shell 配置统一：移除对 PowerShell 和 CMD 的支持，统一要求 Windows 用户使用 Git Bash 模型升级：将 Gemini Pro 模型从 3.0 版本升级至 3.1 版本 🐛 问题修复 输入历史导航：修复按上键浏览历史时，滚动到以 开头的条目后无法继续滚动的问题 工具权限拒绝渲染：修复 PreToolUse hook 拒绝和权限规则拒绝时工具调用无法在 UI 中正常渲染的问题 命令解析：修复 Bash 工具在命令包含未定义环境变量时无法正确识别命令根的问题 子命令路由：修复使用别名调用子命令时路由路径错误的问题"},{"id":"/cli/release-notes/v2.52.3","title":"🚀 CodeBuddy Code v2.52.3 发布","body":"🚀 CodeBuddy Code v2.52.3 发布 🔧 改进优化 Gemini 生图模型：新增 Gemini 3.0 Pro Image、Gemini 3.1 Flash Image、Gemini 2.5 Flash Image 三个生图模型，支持文生图和图生图功能 Ctrl+D 退出优化：Ctrl+D 仅在输入框为空且没有进行中的对话时才触发双击退出流程，避免误操作 Windows Shell 兼容性：修复 Windows 环境下 Shell 路径选择逻辑和 shell snapshot 功能，确保优先使用 Git Bash，改进配置文件检测和编码处理，正确识别 fish、tcsh 等非 POSIX shell MCP 配置增强： 参数同时支持文件路径和直接 JSON 格式；非项目作用域的 MCP 服务器跳过审批检查，减少不必要的确认操作 依赖升级：升级 OpenAI Agents SDK 至 0.5.2，OpenAI SDK 至 v6 🐛 问题修复 插件列表显示：修复缓存清除后插件 skills 无法正确加载的问题"},{"id":"/cli/release-notes/v2.52.2","title":"🚀 CodeBuddy Code v2.52.2 发布","body":"🚀 CodeBuddy Code v2.52.2 发布 🔧 改进优化 自定义令牌认证：支持从 ACCPRODUCTCONFIG 环境变量中识别 custom token 认证配置，修复配置已加载但同步未完成时的认证回退问题 会话加载性能优化： 命令加载历史会话时使用并行读取，减少等待时间 插件加载提速：并行化插件加载流程，多插件场景下启动速度提升数倍 🐛 问题修复 /doctor 命令：修复 session 为空时可能导致属性访问错误的问题 SDK Python 构建脚本：更新 goreleaser 输出目录路径以匹配 headless 构建产物命名，移除未使用的导入"},{"id":"/cli/release-notes/v2.52.1","title":"🚀 CodeBuddy Code v2.52.1 发布","body":"🚀 CodeBuddy Code v2.52.1 发布 🔧 改进优化 启动与稳定性 版本查询秒回： / 不再触发完整初始化流程，响应速度大幅提升 管道环境兼容：在非 TTY 环境下执行子命令时不再等待 stdin 输入，避免流程卡住 认证超时保护：网络不通时认证初始化会自动超时，不再导致 CLI 无限等待 团队成员切换体验优化 即时切换：使用左右方向键即时切换团队成员视图，无需回车确认，操作更流畅 快捷进入/退出：按下键进入选择模式并默认选中 @main，按上键或 Esc 退出 输入历史隔离：历史导航与成员选择模式互不干扰，清空输入框自动退出历史导航 SDK 改进 Python SDK MCP Server 简化：可直接传入 server 对象，无需手动构造字典 JS SDK 可执行文件配置：支持通过 和 自定义 CLI 可执行文件路径和参数 内部请求头过滤：支持通过 环境变量清理内部请求头，避免干扰第三方 API 网关 🐛 问题修复 Skill 加载：修复插件中的 Skill 偶发无法加载的问题，确保初始化顺序正确 Skill 调用：修复 的 Skill 无法被模型自动调用的问题 Team 成员颜色：修复并发生成 Team 成员时颜色索引重复的问题 子代理并发稳定性：修复大量并发子代理时产生的 MaxListenersExceededWarning"},{"id":"/cli/release-notes/v2.52.0","title":"🚀 CodeBuddy Code v2.52.0 发布","body":"🚀 CodeBuddy Code v2.52.0 发布 ✨ 新功能 团队视图切换 支持通过方向键在不同团队成员视图之间快速切换。按 进入切换模式， 选择成员， 确认切换到成员视图，实时查看对话历史和工作进度。切换时自动同步高亮预览和输入框边框颜色，让你随时掌握每个成员的工作状态 Headless 模式 新增轻量级 headless 构建（体积减少 45%），支持 、 、 快速启动，适用于 CI/CD 管道和自动化集成场景 🔧 改进优化 启动性能大幅提升：优化启动流程，Application.start() 耗时降低 96%，内存占用减少 31%，启动体验更加流畅 Bun 原生优化：使用 Bun 原生 API 替代第三方依赖（PTY、glob、semver 等），提升运行时性能 依赖精简：移除不再需要的依赖项，减小安装体积 认证时序修复：确保认证在 API 调用前完成，消除冷启动时偶发的 401 错误 模型排序优化：调整国内版默认模型优先级顺序，常用模型更容易选择 命令执行稳定性：优化命令执行与环境初始化流程，减少异常情况下的执行中断 认证体验增强：增强 API Key Helper 获取令牌过程的健壮性，提升认证流程稳定性 错误处理升级：将错误处理从字符串匹配升级为自定义错误类，提升错误识别的可靠性 流超时自动重试：当模型流式响应超时时自动重试，无需手动操作。支持通过环境变量 自定义超时时间 命令建议过滤：不可直接调用的 Skill 不再出现在斜杠命令建议列表中，保持菜单整洁 🐛 问题修复 团队成员工具权限确认：修复团队成员执行工具时跳过权限确认的问题，现在团队成员会正确继承主 Agent 的权限模式；权限确认框中显示成员名称和专属颜色，便于区分来源 插件 MCP 配置兼容：修复插件 不支持扁平格式的问题，现在同时兼容包装格式和扁平格式 团队成员状态显示：修复团队成员正常完成任务后因清理流程被错误标记为失败的问题，已完成的成员现在正确显示完成状态"},{"id":"/cli/release-notes/v2.51.2","title":"🚀 CodeBuddy Code v2.51.2 发布","body":"🚀 CodeBuddy Code v2.51.2 发布 🔧 改进优化 新增模型支持：添加 Gemini 3.0 Pro 和 Gemini 3.0 Flash 模型配置，您现在可以在模型选择中使用这两款 Google 最新一代模型，享受更强的推理能力和更快的响应速度"},{"id":"/cli/release-notes/v2.51.1","title":"🚀 CodeBuddy Code v2.51.1 发布","body":"🚀 CodeBuddy Code v2.51.1 发布 🔧 改进优化 Ctrl+N/P 快捷键映射：支持使用 Ctrl+N/Ctrl+P 替代方向键 ↓/↑，在输入框、选择菜单、确认面板等所有场景中均可使用，为习惯 Emacs 键位的用户提供更顺畅的操作体验 Loading 状态 Token 展示优化：修复主 agent 等待 subagent 时 token 显示为 0 的问题，现在能正确展示实时流式 token 变化；subagent 和 Team 成员进度行均支持实时流式 token 展示 会话级授权同步：在子代理执行过程中选择\"本次会话不再询问\"时，授权现在会同步到主会话和所有子代理，避免重复弹出相同的权限确认 MCP 连接超时保护：为 MCP 服务器连接等待添加超时机制，防止在 headless 模式下因服务器无响应而无限挂起 Team 通知机制优化：重构后台任务完成通知，改用邮箱延迟去重机制，避免重复通知干扰对话流；修复队列消息丢失发送者身份的问题 新增模型支持：添加 GPT 5.3 Codex 模型配置 Agent Teams 设置显示：设置面板中 Agent Teams 默认状态现在正确显示为开启 🐛 问题修复 自定义命令覆盖内置命令：修复自定义斜杠命令和 Skill 无法覆盖同名内置命令的问题，现在按项目级 用户级 内置的优先级正确覆盖 启动界面渲染：修复欢迎 Banner 重复渲染以及信任对话框与 Banner 内容重叠的显示问题 后台任务查询：修复后台 Agent 启动后通过 TaskOutput 查询时报 \"not found\" 的问题"},{"id":"/cli/release-notes/v2.51.0","title":"🚀 CodeBuddy Code v2.51.0 发布","body":"🚀 CodeBuddy Code v2.51.0 发布 🎉 新功能 记忆目录摘要 系统提示词中新增记忆文件列表摘要，展示文件名、大小、修改日期及首行标题。AI 助手现在可以一眼看到您有哪些记忆文件，并按需加载相关内容，避免将所有记忆文件内容塞入上下文，大幅节省 Token 消耗。 记忆文件自动清理 会话历史清理时同步清理过期记忆文件，复用相同的保留期配置。再也不用担心 目录无限增长了。 🔧 改进优化 Skills 支持内联 Shell 命令：Skills 的 SKILL.md 现在支持 ! 语法执行 Shell 命令，与斜杠命令保持一致的处理管道，让 Skills 编写更加灵活 Skill 斜杠命令分发：支持通过 或 直接调用已注册的 Skill，未匹配到内置命令时自动回退到 Skill 查找，提升命令使用的流畅度 斜杠命令菜单优化：描述过长时自动截断，避免菜单项跨多行显示，界面更整洁 YAML 解析增强：支持折叠块标量语法（ 、 ），正确将多行描述折叠为单行 模型系数更新：更新各模型的计费系数至最新值，新增部分模型支持，计费更准确 🐛 问题修复 确认框滚动修复：修复权限确认框、计划确认框和编辑确认框内容超过终端高度时滚动条自动跳到顶部的问题，长内容确认体验更顺畅 自定义子代理工具继承：修复自定义子代理在未配置工具列表时会继承创建子代理能力的问题，避免意外的递归调用"},{"id":"/cli/release-notes/v2.50.7","title":"🚀 CodeBuddy Code v2.50.7 发布","body":"🚀 CodeBuddy Code v2.50.7 发布 🔧 改进优化 Team 成员焦点导航 使用 Team 协作时，现在可以通过 Shift+↑/↓ 在各成员之间切换视图，实时查看成员的对话历史、执行进度和 Token 消耗情况，按 Ctrl+O 可快速返回主视图。 成员消息直达：聚焦到某个成员后，输入框自动切换为向该成员发送消息模式，使用 @main 可将消息路由回主代理 消息路由增强：SendMessage 工具支持 \"main\" 别名，用户消息注入成员会话时不再添加多余的 XML 包装 🐛 问题修复 子代理 AbortSignal 监听器泄漏：修复子代理中 abort 事件监听器在错误的 AbortSignal 上注册和移除的问题，消除级联中断时的异常报错 成员会话恢复：修复子代理重启时订阅丢失导致 0 token 的问题，修复 agentend 事件竞态条件"},{"id":"/cli/release-notes/v2.50.6","title":"🚀 CodeBuddy Code v2.50.6 发布","body":"🚀 CodeBuddy Code v2.50.6 发布 🔧 改进优化 高危命令识别规则优化：大幅减少误杀率，细化 CRITICAL/HIGH/MEDIUM 三级风险判定规则。常见开发命令如 、 、 、 等不再被错误拦截，提升日常开发流畅度 权限规则安全分层：将 allow 规则按来源区分为可信（用户设置）和不可信（项目设置），防止恶意仓库通过项目配置文件注入权限规则绕过安全检查，增强供应链安全防护 安全白名单扩展：新增 50+ 常见开发工具命令到安全白名单，涵盖构建工具、测试框架、包管理器、代码质量工具等，减少不必要的授权弹窗 子代理模型配置优化：为 MiniMax M2.5 和 Kimi K2.5 模型补充 relatedModels 配置，确保子代理在使用这些模型时能正确选择对应的轻量级和推理模型变体 🐛 问题修复 进程僵死修复：修复关闭终端后进程不退出且 100% CPU 占用的问题 Shell 句柄泄漏修复：修复多处 Shell 执行句柄未正确释放的问题，防止 PTY 文件描述符泄漏 node pty fd 泄漏修复：检测并在 dispose 时关闭 node pty 内部泄漏的额外 ptmx 文件描述符 诊断增强：在 /doctor 面板中添加 Active PTYs 计数，便于检测潜在的 PTY 泄漏"},{"id":"/cli/release-notes/v2.50.5","title":"🚀 CodeBuddy Code v2.50.5 发布","body":"🚀 CodeBuddy Code v2.50.5 发布 ✨ 新功能 Bash 专用子代理 新增 Bash 内置子代理，专注于命令行任务执行。当 AI 需要执行 git 操作、运行构建工具、执行测试等终端任务时，会自动调用轻量级 Bash 子代理快速完成，提升命令执行效率。 命令安全检测 新增 Bash 命令注入检测机制，自动识别并拦截包含反引号替换、 命令替换、换行符注入等潜在危险构造的命令，增强终端操作安全性。 🔧 改进优化 子代理工具配置优化：调整 Plan 子代理工具集，新增团队协作工具支持；精简 Explore 子代理工具，减少不必要的工具加载 子代理标签显示优化：子代理名称统一使用前景色文字显示，视觉更简洁一致"},{"id":"/cli/release-notes/v2.50.4","title":"🚀 CodeBuddy Code v2.50.4 发布","body":"🚀 CodeBuddy Code v2.50.4 发布 🔧 改进优化 后台任务体验升级 后台 Agent 现在自动创建轻量级团队，通过 SendMessage 回传结果，无需再使用 TaskOutput 手动轮询。后台任务完成后自动通知主 Agent，整体交互更流畅。UI 进度展示也进行了统一，后台任务纳入 TeammateProgressView 集中展示。 启动性能优化：优化首次启动时的初始化流程，并行化注册流程，启动速度提升约 10% 终端渲染优化：统一所有动画组件为全局单一时钟驱动，减少独立定时器导致的终端闪动 消息渲染修复：修复消息完成后不显示、需要 resize 终端才能看到的问题 内存泄漏修复：修复 导致内部输出缓冲区无限累积的问题 任务清理修复：修复失败的子任务未被正确清理导致进度显示残留的问题 🐛 问题修复 Bash 工具输出修复：修复 Bash 工具执行结果下方偶尔出现多余空白行的问题"},{"id":"/cli/release-notes/v2.50.3","title":"🚀 CodeBuddy Code v2.50.3 发布","body":"🚀 CodeBuddy Code v2.50.3 发布 🐛 问题修复 模块加载兼容性修复：修复 在某些打包环境下因 不可用导致模块加载失败的问题，提升运行时兼容性"},{"id":"/cli/release-notes/v2.50.2","title":"🚀 CodeBuddy Code v2.50.2 发布","body":"🚀 CodeBuddy Code v2.50.2 发布 🔧 改进优化 MCP Remote 传输类型：新增 传输类型支持，允许通过远程 HTTP 连接 MCP 服务器，扩展了 MCP 的连接方式 构建速度提升：切换到 Rspack 拷贝插件并将 patch 脚本并行化，加快项目构建速度 任务进度显示优化：已完成的子任务在全部执行完毕后自动清除，避免大量已完成条目累积占据屏幕空间，保持界面整洁 🐛 问题修复 粘贴 URL 误判修复：修复粘贴以 或 开头的 URL 时被错误识别为文件路径的问题"},{"id":"/cli/release-notes/v2.50.1","title":"🚀 CodeBuddy Code v2.50.1 发布","body":"🚀 CodeBuddy Code v2.50.1 发布 🔧 改进优化 文档导航优化：将 Agent Teams 文档移至 Sub Agents 之后，使导航结构更符合功能关联性，方便用户按逻辑顺序查阅文档 🐛 问题修复 配置文件注释保留：修复保存 MCP 配置时 mcpServers 字段下的 JSONC 注释丢失的问题，确保用户在配置文件中添加的注释不会被意外删除"},{"id":"/cli/release-notes/v2.50.0","title":"🚀 CodeBuddy Code v2.50.0 发布","body":"🚀 CodeBuddy Code v2.50.0 发布 ✨ 新功能 Agent Teams 多智能体协作 全新的 Team 功能让多个 Agent 可以协同工作，通过 TeamCreate、TeamDelete、SendMessage 等工具实现任务分配和消息传递。Agent 工具扩展支持 teammate 生成，TaskList 支持团队任务协调，适用于复杂项目的并行处理场景。可通过环境变量灵活控制 Team 功能的启用与关闭。 🔧 改进优化 子代理任务展示优化：后台任务以 样式展示实时进度，同步任务进度集成到 loading spinner 中，界面更简洁 任务完成通知增强：通知消息包含执行时长、工具调用次数和 token 用量等统计信息，方便了解任务执行情况 后台任务资源清理：子代理结束时自动清理关联的后台 shell 任务，避免资源泄漏 TaskOutput 超时调整：默认超时从 30s 提升到 120s，默认阻塞等待完成，减少超时中断 延迟加载工具修复：修复延迟加载工具通过搜索激活后仍报 \"Tool not found\" 的问题，未激活时自动激活并提示重试 工具搜索结果优化：搜索结果改为简洁文本格式，未展开时即可看到工具名称和描述 MCP 服务器管理改进：修复移除 MCP 服务器后配置未实际删除的问题；SDK 注册的 MCP 服务器现在会在初始化时自动连接并立即可用 SDK 参数格式统一：JS 和 Python SDK 的 CLI 参数格式标准化为 风格 Plan Mode 交互优化：拒绝计划时区分\"继续规划\"和\"退出规划模式\"两种操作，避免被困在不可恢复的规划循环中 队列消息显示优化：支持中文字符宽度感知的智能截断，自适应终端宽度 Memory 功能默认启用：将 Memory 功能的默认值调整为开启状态 🐛 问题修复 依赖注入稳定性：修复单例组件在循环依赖场景下可能被重复实例化的问题"},{"id":"/cli/release-notes/v2.49.7","title":"🚀 CodeBuddy Code v2.49.7 发布","body":"🚀 CodeBuddy Code v2.49.7 发布 ✨ 新功能 GLM 5.0 模型支持 新增 GLM 5.0 大语言模型，支持 200K 上下文窗口和 48K 输出 token，为国内版和 iOA 版用户提供更强大的推理能力选择。"},{"id":"/cli/release-notes/v2.49.6","title":"🚀 CodeBuddy Code v2.49.6 发布","body":"🚀 CodeBuddy Code v2.49.6 发布 🔧 改进优化 SDK MCP 初始化时序优化：修复 SDK 模式下 MCP 服务器注册与 prompt 处理的竞态问题，确保 MCP 工具在 prompt 处理前完成就绪，避免工具调用失败 Headless 模式检测改进：优化 headless 模式识别逻辑，支持 ACP 模式和非 TTY 环境的自动检测 MCP 配置文件路径支持：SDK 的 mcpServers 参数新增支持文件路径字符串格式，简化配置方式 ACP SDK 升级：升级 ACP SDK 至 0.14.1 版本，修复终端输出字节限制参数类型兼容性问题 CI 配置优化：为 bot 配置添加 npcName 参数支持"},{"id":"/cli/release-notes/v2.49.5","title":"🚀 CodeBuddy Code v2.49.5 发布","body":"🚀 CodeBuddy Code v2.49.5 发布 🔧 改进优化 MCP 服务器就绪检测：修复 SDK 模式下 MCP 工具在初始化时可能未就绪的问题，确保工具在首次调用时已完全初始化 构建优化：移除 Bun 编译中不再需要的构建标志，简化二进制打包流程 🐛 问题修复 会话压缩挂起修复：修复了 ACP 会话在压缩消息日志后可能永久挂起的问题，增加了超时保护机制防止异常情况下的永久阻塞 会话历史恢复：修复查找最后消息 ID 时未正确跳过自定义消息项的问题，避免恢复会话时定位到错误的消息位置"},{"id":"/cli/release-notes/v2.49.3","title":"🚀 CodeBuddy Code v2.49.3 发布","body":"🚀 CodeBuddy Code v2.49.3 发布 🔧 改进优化 模型错误提示优化：当模型不可用时，自动展示当前账号支持的模型列表，方便用户快速切换到可用模型 错误处理：优化了被封装的模型行为错误（ModelBehaviorError）的处理逻辑，确保工具调用失败时能够正确识别并重试 MCP 服务器就绪检测：修复 SDK 模式下 MCP 工具在初始化时可能未就绪的问题"},{"id":"/cli/release-notes/v2.49.2","title":"🚀 CodeBuddy Code v2.49.2 发布","body":"🚀 CodeBuddy Code v2.49.2 发布 🔧 改进优化 跨会话任务列表共享 支持通过环境变量 在不同会话间共享任务列表，便于多终端协作和持续任务追踪。 示例： 日期格式优化 系统信息中的日期显示现在包含星期信息，使用更友好的格式，提升可读性。例如： 。 🐛 问题修复 会话切换权限保持 修复切换会话时权限模式未保留的问题，确保切换后延续当前的权限设置。之前切换会话后权限模式会意外重置，现在会正确保持。 拦截器重试机制 修复了当模型响应拦截器触发自动重试时，视图层仍然输出原有失败结果的问题。现在拦截器启动重试后，会正确抑制失败结果的输出，仅显示重试后的成功响应。 ACP 流式模式中断优化 中断状态竞态条件：修复 ACP 流式模式下中断状态因共享 RunState 被后续运行修改导致的竞态问题，改用事件快照缓存中断状态 结果消息查找：改进最终助手消息查找逻辑，支持从响应输出中反向搜索已完成消息，并在未找到时回退到会话历史 🔨 构建优化 构建工具升级：升级 goreleaser、bun、uv 至最新版本 Bun 编译优化：启用字节码编译和 ESM 格式，提升启动性能"},{"id":"/cli/release-notes/v2.49.1","title":"🚀 CodeBuddy Code v2.49.1 发布","body":"🚀 CodeBuddy Code v2.49.1 发布 🔒 安全加固 沙箱配置文件保护：沙箱模式下自动禁止写入 CodeBuddy 配置文件（settings.json），防止通过注入 hooks 实现沙箱逃逸攻击；文件系统拒绝规则同步应用到 Write、Edit 等文件操作工具，确保安全策略全面一致 🔧 改进优化 会话列表过滤：过滤子代理和压缩分支会话，确保会话列表和最近会话仅展示用户真实会话 SDK 文档修复：修复认证配置链接中的括号格式问题 🐛 问题修复 会话历史定位：修复了切换会话或恢复历史时， 可能错误指向无 ID 的自定义消息（如摘要、主题）导致对话链断裂的问题"},{"id":"/cli/release-notes/v2.49.0","title":"🚀 CodeBuddy Code v2.49.0 发布","body":"🚀 CodeBuddy Code v2.49.0 发布 ✨ 新功能 使用洞察报告 新增 命令，生成 AI 驱动的使用洞察分析报告。报告涵盖交互风格、项目领域、摩擦点、亮点、改进建议等多个维度，帮助您更好地了解和优化自己的 AI 协作模式。支持在浏览器中查看 HTML 格式的可视化报告。 🔧 改进优化 统计数据准确性：优化 token 用量统计逻辑，正确区分主会话与子代理会话，修复工具调用 token 遗漏问题 进度显示：支持自定义进度文本，在 loading 状态中实时展示当前处理进度 自定义模型配置：修复自定义模型错误继承全局关联模型配置的问题，确保行为符合预期 记忆系统：优化记忆上下文提示词，精简表述并新增隐式记忆源支持，提升跨会话记忆召回能力 多语言支持增强：所有子 Agent 现在会正确遵循用户的语言设置进行回复 UI 刷新优化：优化工具执行完成后的终端刷新策略，增加防抖机制减少不必要的渲染 内存优化：子 Agent 任务完成后自动释放会话历史和引用，减少内存占用 Grep 搜索：自动修正搜索模式参数，避免不必要的调用失败；兼容 ripgrep 正则语法 文件读取：读取目录时返回目录列表，帮助快速定位目标文件 🐛 问题修复 工具错误处理：改进工具未找到时的错误提示和处理逻辑 Headless 模式：修复使用非默认 agent 时流式输出阻塞的问题，确保 completion 信号正确发送 工具结果显示：修复 Edit 等工具执行完成后输出不显示，需要手动调整终端大小才能看到的问题 会话恢复列表：移除会话恢复面板中不必要的 agent 类型过滤，允许恢复所有有效会话"},{"id":"/cli/release-notes/v2.48.1","title":"🚀 CodeBuddy Code v2.48.1 发布","body":"🚀 CodeBuddy Code v2.48.1 发布 🔧 改进优化 环境变量认证冲突检测：当设置了 或 环境变量时，/login 命令会自动检测并提示冲突解决方案；认证失败时显示更详细的诊断信息，帮助快速定位问题 子代理消息标识：修复子代理 user 消息在流式输出时缺少父工具标识的问题，客户端现可正确区分主代理和子代理的消息 MCP prompt 命令格式统一：统一 MCP prompt 与斜杠命令的上下文拼接格式，确保模型能正确理解命令来源和参数 📝 文档更新 Prompt Hooks 文档：完善基于提示词的 Hooks 功能文档，新增支持事件说明、配置示例和最佳实践指南"},{"id":"/cli/release-notes/v2.48.0","title":"🚀 CodeBuddy Code v2.48.0 发布","body":"🚀 CodeBuddy Code v2.48.0 发布 ✨ 新功能 图生图工具（ImageEdit） 新增 工具，支持基于已有图片进行 AI 编辑和修改： 支持风格转换、添加元素、修改颜色等图片编辑操作 使用 命令切换图生图模型 通过 环境变量或 设置项配置默认模型 Prompt Hook 新增基于 LLM 的 Hook 类型，支持使用自然语言定义触发条件，实现更灵活的工作流控制。 🔧 改进优化 图片 API 重构：提取共享的 模块，统一文生图和图生图的 API 调用逻辑 模型标签系统：引入 和 模型标签，支持同一模型同时具备多种图像生成能力 Hook 配置面板：支持显示和管理 Prompt Hook，优化阻断信息的展示方式 Token 计算准确性： 命令现在只统计实际启用的工具，排除被禁用的内置工具和 MCP 工具 Plan 模式权限继承：Plan 模式下保留进入前的权限设置，支持 \"plan + bypass\" 等组合模式，子代理同样继承此权限配置 热更新系统优化：在低 FD 限制的容器环境中自动检测并优化热更新行为，支持 完全禁用热更新 Windows 路径提示：在 Windows 平台添加使用正斜杠的提示，避免反斜杠导致路径解析错误 WorkBuddy 配置分离：WorkBuddy 现在使用独立的 配置目录，与 CLI 的 分离 🐛 问题修复 ACP 取消处理：优化取消请求的事件传递机制，确保会话能正确响应取消操作 MCP 非交互模式：修复 ACP 模式下 MCP 工具未正确识别为非交互模式的问题 记忆上下文注入：修复记忆提示注入时缺少系统标签的问题 目录扫描：修复软链接目录下文件相对路径计算不正确的问题"},{"id":"/cli/release-notes/v2.47.0","title":"🚀 CodeBuddy Code v2.47.0 发布","body":"🚀 CodeBuddy Code v2.47.0 发布 ✨ 新功能 跨会话记忆功能 新增实验性记忆功能，支持 Agent 在会话间保持持久化记忆。您可以通过 设置面板或 配置项启用此功能。同时支持团队记忆模式，将记忆存储在项目目录下便于团队共享。 🔧 改进优化 command:// URI 处理：优化 ACP 协议中 command:// 资源链接的处理，正确转换为斜杠命令格式并回显原始内容块 命令推送过滤：修复内置命令被错误推送到 IDE 的问题，现在只推送用户自定义命令、skills 和特定内置命令 文件路径搜索：优化重复字符查询的匹配精度，避免误匹配分散的字符 SSH 远程剪贴板：修复在 Linux + SSH 远程环境下 Ctrl+Y 复制到剪贴板失败的问题，通过实现 OSC 52 协议支持远程终端剪贴板操作 会话恢复历史控制：优化 SDK 恢复会话时的历史回放逻辑，通过 信号让 CLI 智能判断是否需要回放历史消息，提升 resume 场景的使用体验 🐛 问题修复 管道输入：修复使用管道传递输入时内容无法被读取的问题（如 ） Stop Hooks 执行时机：修复当工具需要用户确认时 Stop Hooks 被错误执行的问题，现在只有在没有待审批工具时才会触发"},{"id":"/cli/release-notes/v2.46.0","title":"🚀 CodeBuddy Code v2.46.0 发布","body":"🚀 CodeBuddy Code v2.46.0 发布 ✨ 新功能 语言设置 在 中新增 Language 选项，您可以设置首选的响应语言，CodeBuddy Code 将使用您指定的语言进行回复，让交流更加自然流畅。 🔧 改进优化 复制快捷键：新增 Ctrl+Y 快捷键，可快速复制最后一条 AI 回复到剪贴板，方便您快速获取代码片段或重要信息 Shell 命令执行优化：优化命令执行机制，仅在需要加载额外环境配置时才使用 eval 包装，保持默认情况下的原有行为，提升命令执行的稳定性"},{"id":"/cli/release-notes/v2.45.1","title":"🚀 CodeBuddy Code v2.45.1 发布","body":"🚀 CodeBuddy Code v2.45.1 发布 🔧 改进优化 登录界面优化：调整登录方式顺序，将 iOA 登录放置到最后并标注仅限腾讯内部员工使用，让新用户更容易找到适合自己的登录方式 文档完善：在快速入门文档中添加四种登录方式的详细说明，帮助用户了解各登录方式的适用场景 SDK 版本更新：同步更新 SDK JS 至 0.3.40，SDK Python 至 0.3.38"},{"id":"/cli/release-notes/v2.45.0","title":"🚀 CodeBuddy Code v2.45.0 发布","body":"🚀 CodeBuddy Code v2.45.0 发布 ✨ 新功能 工具搜索与延迟加载 新增 ToolSearch 工具，支持通过自然语言搜索可用工具。MCP 服务器现在支持 配置，将工具延迟到需要时才加载，有效减少上下文消耗并提高工具选择准确性。 环境变量模型配置 支持通过环境变量灵活配置模型，方便在 CI/CD 环境和脚本中使用： ：覆盖默认代理模型 ：配置 lite 变体模型 ：配置 reasoning 变体模型 ：配置子代理模型 ：启用扩展思考并设置 token 预算 SDK Commands 订阅 SDK 新增 和 方法，支持获取和实时订阅 CLI 可用命令列表变更。 🔧 改进优化 Skill Fork 上下文：支持 配置，使 Skill 在独立的子代理上下文中执行 Agent 类型指定：新增 字段，可指定执行 Skill 的子代理类型 图片粘贴优化：增加剪贴板读取重试机制，扩展 macOS 图片格式检测，支持更多截图工具 错误恢复增强：当模型返回无效工具名时，系统会提示模型检查并重试 界面简化：将 \"Plan Mode\" 简化为 \"Plan\"，使界面更简洁 🐛 问题修复 ACP 多轮对话：修复第二轮 prompt 直接返回结果、缺少 sessionUpdate 事件的问题 插件加载去重：修复插件 skills、agents、commands 在菜单中重复显示的问题"},{"id":"/cli/release-notes/v2.44.1","title":"🚀 CodeBuddy Code v2.44.1 发布","body":"🚀 CodeBuddy Code v2.44.1 发布 🔧 改进优化 Skill/Command 调用控制：新增 配置项，支持将 skill 或 command 设置为仅手动触发模式，避免被模型自动调用，让您对 AI 的行为有更精细的控制 子代理中断处理：优化 Task 子代理被用户中断时的行为，现在会返回清晰的中断提示和可恢复的 Agent ID，支持通过 参数继续任务，中断不再意味着丢失进度 Plan 子代理能力增强：Plan 子代理现在可以使用 Write、Edit、MultiEdit 工具编辑 plan 文件，让计划模式更加灵活实用 媒体内容错误自动恢复：当图片过大、格式无效或数量过多导致请求失败时，系统会自动移除问题内容并提供压缩建议，让对话能够继续进行 WebFetch 工具增强：增强对 SPA 页面的支持，当页面主体内容为空时自动提取 meta 标签信息，更好地理解现代 Web 应用 自定义 Headers 合并优化：修复 HTTP headers 合并时的大小写敏感问题，现在会正确覆盖同名但大小写不同的 header allowed tools 格式支持：自定义 Skill 和 Command 的 字段现在同时支持逗号分隔字符串和 YAML 数组两种格式，配置更灵活 输入框优化：修复消息发送时序问题，确保消息完全发送后再清空输入 🐛 问题修复 自定义请求头解析：修复换行符判断逻辑，确保多行 header 配置能够被正确解析 文档链接：修正沙箱文档链接指向正确的文件 📝 文档更新 SDK 示例文档：新增 SDK 演示页面，提供 TypeScript SDK 的使用示例和最佳实践 技能与命令文档：更新技能和斜杠命令的相关文档说明"},{"id":"/cli/release-notes/v2.44.0","title":"CodeBuddy Code v2.44.0 发布","body":"CodeBuddy Code v2.44.0 发布 ✨ 新功能 会话标题同步 支持将会话主题（Topic）通过 ACP 协议同步给 IDE，便于在标签页或侧边栏显示有意义的会话名称。当 AI 助手识别出会话主题后，IDE 可以自动更新对应的标签页标题，让用户更容易识别和管理多个并行会话。 🔧 改进优化 SDK 版本更新：同步更新 SDK JS 至 0.3.37，SDK Python 至 0.3.35"},{"id":"/cli/release-notes/v2.43.1","title":"🚀 CodeBuddy Code v2.43.1 发布","body":"🚀 CodeBuddy Code v2.43.1 发布 ✨ 新功能 任务管理工具重构 将原有的单一任务管理工具拆分为 5 个独立工具，提供更精细的任务控制能力： TaskCreate：创建新任务 TaskGet：获取任务详情 TaskUpdate：更新任务状态 TaskList：列出所有任务 TaskStop：停止任务执行 Skill 工具增强 Skill 工具现在支持直接执行斜杠命令，新增 参数用于传递命令参数，让技能调用更加灵活。 🔧 改进优化 计划模式增强：新增 命令用于预览当前计划文件内容，优化计划模式下的权限控制 Shell 环境快照：执行命令时自动捕获用户 shell 配置（函数、别名、选项），确保命令在用户熟悉的环境中运行 Shell 环境文件支持：新增 环境变量，支持在命令执行前自动加载指定的环境文件 提示词优化：优化 Agent 提示词模板，提升回复简洁性 文件搜索优化：精简硬编码忽略规则，优先依赖项目 .gitignore 配置 Grep 工具：新增 参数别名，提升使用便捷性 子代理配置：新增 参数，支持控制代理执行轮次"},{"id":"/cli/release-notes/v2.43.0","title":"🚀 CodeBuddy Code v2.43.0 发布","body":"🚀 CodeBuddy Code v2.43.0 发布 ✨ 新功能 任务管理工具重构 将原有的单一任务管理工具拆分为 5 个独立工具，提供更精细的任务控制能力： TaskCreate：创建新任务 TaskGet：获取任务详情 TaskUpdate：更新任务状态 TaskList：列出所有任务 TaskStop：停止任务执行 Skill 工具增强 Skill 工具现在支持直接执行斜杠命令，新增 参数用于传递命令参数，让技能调用更加灵活。 🔧 改进优化 计划模式增强：新增 命令用于预览当前计划文件内容，优化计划模式下的权限控制 Shell 环境快照：执行命令时自动捕获用户 shell 配置（函数、别名、选项），确保命令在用户熟悉的环境中运行 Shell 环境文件支持：新增 环境变量，支持在命令执行前自动加载指定的环境文件 提示词优化：优化 Agent 提示词模板，提升回复简洁性 文件搜索优化：精简硬编码忽略规则，优先依赖项目 .gitignore 配置 Grep 工具：新增 参数别名，提升使用便捷性 子代理配置：新增 参数，支持控制代理执行轮次"},{"id":"/cli/release-notes/v2.42.3","title":"🚀 CodeBuddy Code v2.42.3 发布","body":"🚀 CodeBuddy Code v2.42.3 发布 🔧 改进优化 会话摘要与主题持久化 AI 摘要生成：自动为会话生成 AI 摘要，在 列表中展示更友好的描述，帮助您快速识别和恢复历史会话 主题持久化：终端标题现在会保存到会话历史，方便后续查看和管理 非交互模式支持：新增 参数，支持在非交互模式下启用会话追踪功能 会话追踪配置细粒度控制 将会话追踪功能拆分为两个独立的环境变量，支持更灵活的配置： ：控制是否生成会话摘要 ：控制是否保存会话主题 这允许您根据实际需求单独启用或禁用特定功能。"},{"id":"/cli/release-notes/v2.42.1","title":"🚀 CodeBuddy Code v2.42.1 发布","body":"🚀 CodeBuddy Code v2.42.1 发布 🔧 改进优化 启动性能监控：新增启动时间分析器，可在 面板查看各阶段耗时，帮助诊断启动缓慢问题 WSL 环境支持：自动检测 WSL 环境并提示模型使用正确的 Linux 路径格式，提升 WSL 用户体验 路径兼容性：修复模型在非 Windows 平台发送 Windows 风格路径时的解析问题，避免路径错误 SDK 版本更新：同步更新 SDK JS 至 0.3.32，SDK Python 至 0.3.30"},{"id":"/cli/release-notes/v2.42.0","title":"🚀 CodeBuddy Code v2.42.0 发布","body":"🚀 CodeBuddy Code v2.42.0 发布 ✨ 新功能 MCP 配置支持 JSONC 格式 MCP 配置文件现在支持 JSONC (JSON with Comments) 格式，让配置文件更易于维护： 支持单行注释 ( ) 支持多行注释 ( ) 支持尾随逗号 🔧 改进优化 Python 3.10 支持：Agent SDK 扩展了兼容的 Python 版本范围，现已支持 Python 3.10 ACP 会话控制：修复了通过 SDK 设置模型和权限模式的功能 工具调用稳定性：当模型返回不完整的工具调用参数时，自动检测并请求模型重新生成，提升对话稳定性 会话 Fork 增强：支持更多参数组合方式，可通过 或 指定源会话 命令消息格式：统一斜杠命令和技能的消息标签格式，新增 标签支持参数提取 数据追踪准确性：修复 prompt suggestion 与主对话数据混淆的问题 🐛 问题修复 Hook 输出显示：修复 hook 执行后显示多余 JSON 原始数据的问题 软链接支持：修复 rules 目录下软链接文件无法正确加载的问题，并增加循环引用防护"},{"id":"/cli/release-notes/v2.41.8","title":"🚀 CodeBuddy Code v2.41.8 发布","body":"🚀 CodeBuddy Code v2.41.8 发布 🔧 改进优化 Print 模式输出优化：在 print 模式下静默通知类消息，避免污染 agent 输出流，让脚本集成更加干净 配置结构简化：移除冗余的 deploymentType 配置字段，简化产品配置结构 🐛 问题修复 自定义请求头解析：修复换行符判断逻辑，确保多行 header 配置能够被正确解析 SDK 系统提示词传递：修复 v2 Session API 中 参数未正确传递的问题 SDK 会话加载竞态条件：修复多窗口场景下并发调用 和 时的竞态条件问题，防止会话数据不一致 📝 文档更新 环境变量文档：新增 功能开关说明，用于控制图片生成功能 发版说明：新增 v2.40.0 至 v2.41.7 版本的中英文发版说明 SDK 文档：完善 hooks、permissions、TypeScript SDK 等文档内容"},{"id":"/cli/release-notes/v2.41.7","title":"🚀 CodeBuddy Code v2.41.7 发布","body":"🚀 CodeBuddy Code v2.41.7 发布 🔧 改进优化 Checkpoint 性能优化：将 checkpoint 文件读取改为异步并行处理，避免阻塞事件循环，提升响应性能 会话恢复优化：改进 session/load 流程，确保历史消息和 artifact 恢复在响应发送后执行，修复多连接场景下的重复发送问题 SDK 工具参数传递：修复 allowedTools/disallowedTools 参数格式，确保正确传递多个工具名称 Python SDK 流缓冲区：增加 100MB 缓冲区限制，防止 MCP 服务返回大 JSON 响应时出错 SDK 版本追踪：SDK 在与 CLI 通信时会自动注入 User Agent 请求头，包含 SDK 版本和运行时信息，便于后端服务追踪和诊断 SDK 版本更新：同步更新 SDK JS 至 0.3.29，SDK Python 至 0.3.27 📝 文档更新 SDK Custom Tools 文档：修复 Python SDK 示例中 tool 装饰器的错误用法，改为从包直接导入并使用正确的装饰器语法"},{"id":"/cli/release-notes/v2.41.6","title":"🚀 CodeBuddy Code v2.41.6 发布","body":"🚀 CodeBuddy Code v2.41.6 发布 🔧 改进优化 输入提交优化：修复在输入斜杠命令时无法按回车提交的问题，现在可以正常提交命令或将无效命令作为普通消息发送 热更新优化：修复 plugins 目录热更新时可能触发 等系统目录变更事件的问题，提升稳定性 上下文压缩：优化历史记录处理逻辑，过滤分支历史确保压缩准确性 工具描述模板：优化工具描述中的引号格式，提升可读性 SDK 版本更新：同步更新 SDK JS 至 0.3.28，SDK Python 至 0.3.26"},{"id":"/cli/release-notes/v2.41.5","title":"🚀 CodeBuddy Code v2.41.5 发布","body":"🚀 CodeBuddy Code v2.41.5 发布 🐛 问题修复 热更新稳定性提升：修复 plugins 目录热更新时可能触发 等系统目录变更事件的问题，确保热更新功能更加稳定可靠 🔧 改进优化 会话锁机制优化：将 session lock 的获取延迟到实际使用时，减少锁泄漏风险，同时支持 fork 操作无需获取锁，提升会话管理的灵活性 SDK 同步更新：SDK JS 更新至 0.3.27，SDK Python 更新至 0.3.25"},{"id":"/cli/release-notes/v2.41.4","title":"🚀 CodeBuddy Code v2.41.4 发布","body":"🚀 CodeBuddy Code v2.41.4 发布 🔧 改进优化 SDK 版本同步：更新 SDK JS 至 0.3.26，SDK Python 至 0.3.24，保持 SDK 与 CLI 版本同步"},{"id":"/cli/release-notes/v2.41.3","title":"🚀 CodeBuddy Code v2.41.3 发布","body":"🚀 CodeBuddy Code v2.41.3 发布 🔧 改进优化 新增 Kimi K2.5 模型：支持 Kimi K2.5 模型，具备工具调用、图像理解和推理能力，为用户提供更多模型选择 参数校验优化：改进工具参数校验错误提示，提供更清晰的错误信息，帮助快速定位问题 类型自动转换：支持字符串形式的数字参数自动转换，提升与不同模型的兼容性 热更新通知优化：用户级 settings.json 热更新时不再显示通知，减少不必要的干扰"},{"id":"/cli/release-notes/v2.41.2","title":"🚀 CodeBuddy Code v2.41.2 发布","body":"🚀 CodeBuddy Code v2.41.2 发布 🔧 改进优化 SDK 版本更新：同步更新 SDK JS 至 0.3.24，SDK Python 至 0.3.22"},{"id":"/cli/release-notes/v2.41.1","title":"🚀 CodeBuddy Code v2.41.1 发布","body":"🚀 CodeBuddy Code v2.41.1 发布 🔧 改进优化 会话管理优化：SDK 重构 sessionId 参数，改为自动生成，简化 API 调用流程，开发者无需手动管理 sessionId SDK 版本更新：同步更新 SDK JS 至 0.3.23，SDK Python 至 0.3.21"},{"id":"/cli/release-notes/v2.41.0","title":"🚀 CodeBuddy Code v2.41.0 发布","body":"🚀 CodeBuddy Code v2.41.0 发布 ✨ 新功能 配置热更新 现在修改 Skills、记忆文件（CODEBUDDY.md）、配置文件等后，无需重启 CLI 即可自动生效。告别频繁的重启操作，让工作流更加顺畅。 🔧 改进优化 工具白名单：新增 选项，支持限制 CodeBuddy 可使用的内置工具集。可设置为空字符串禁用所有内置工具，或指定逗号分隔的工具列表，让工具使用更可控 📝 文档更新 环境配置说明：为 SDK、ACP 和 IAM 文档添加 环境变量配置指引，帮助不同版本用户正确配置认证环境"},{"id":"/cli/release-notes/v2.40.1","title":"🚀 CodeBuddy Code v2.40.1 发布","body":"🚀 CodeBuddy Code v2.40.1 发布 🐛 问题修复 图片生成工具：修复 Windows 系统下输出目录路径解析错误的问题，现在可以正确生成图片到指定目录 输入建议：修复从建议菜单选择后消息重复发送的问题，提升交互体验"},{"id":"/cli/release-notes/v2.40.0","title":"🚀 CodeBuddy Code v2.40.0 发布","body":"🚀 CodeBuddy Code v2.40.0 发布 ✨ 新功能 SDK 延迟控制请求同步 SDK 新增延迟控制请求同步功能，让您可以在发送消息前灵活设置权限模式和模型选项。这一改进为 SDK 用户提供了更灵活的 API 调用方式，方便在消息发送前进行配置调整。 使用示例： 🔧 改进优化 SDK 版本同步：SDK JS 更新至 0.3.20，SDK Python 更新至 0.3.18，同步支持新的延迟控制请求功能"},{"id":"/cli/release-notes/v2.39.0","title":"🚀 CodeBuddy Code v2.39.0 发布","body":"🚀 CodeBuddy Code v2.39.0 发布 ✨ 新功能 图片生成工具 新增 工具，让 AI 助手可以直接根据文本描述生成图片。支持自定义尺寸、风格、质量等多种参数，为创意工作流提供更多可能性。 文生图模型切换：通过 命令查看和切换可用的文生图模型 CLI 参数支持：启动时使用 参数指定默认模型 配置持久化：在用户配置中设置 作为默认文生图模型 🔧 改进优化 配置面板优化：将 Env Route 选项移至开发者模式，通过 或 激活，简化常规配置界面 输入提交修复：修复在输入斜杠命令时无法按回车提交的问题，现在可以正常提交命令或将无效命令作为普通消息发送 工具描述优化：改进工具描述中的引号格式，提升可读性 SDK 版本更新：同步更新 SDK JS 至 0.3.19，SDK Python 至 0.3.17"},{"id":"/cli/release-notes/v2.38.2","title":"🚀 CodeBuddy Code v2.38.2 发布","body":"🚀 CodeBuddy Code v2.38.2 发布 🔧 改进优化 路径解析优化：使用 PathUtils 统一 WASM 文件和证书文件的路径解析逻辑，支持从 EMBEDFS 加载嵌入资源，提升不同部署环境下的兼容性 🐛 问题修复 控制台输出：修复特定场景下控制台输出模式解析异常的问题"},{"id":"/cli/release-notes/v2.38.1","title":"🚀 CodeBuddy Code v2.38.1 发布","body":"🚀 CodeBuddy Code v2.38.1 发布 🔧 改进优化 命令安全检查简化：移除未使用的命令黑名单功能，精简代码结构，提升代码可维护性 SDK 版本同步：同步更新 SDK JS 至 0.3.17，SDK Python 至 0.3.15"},{"id":"/cli/release-notes/v2.38.0","title":"🚀 CodeBuddy Code v2.38.0 发布","body":"🚀 CodeBuddy Code v2.38.0 发布 ✨ 新功能 子 Agent 模型变体 Agent 工具新增 参数，支持指定 、 等模型变体。您可以根据任务复杂度选择合适的模型： ：适用于简单搜索、快速文件操作等轻量任务 ：适用于复杂分析、架构决策和多步骤问题求解 🔧 改进优化 Checkpoint Hook 统计优化：优化文件变更统计计算，通过对比备份文件与当前文件提供准确的增删行数 Shell 编码处理：优化终端输出的字符编码解码逻辑，改善 Windows 环境下中文等非 ASCII 字符的显示效果 SDK 版本更新：同步更新 SDK JS 至 0.3.16，SDK Python 至 0.3.14 📝 文档更新 环境要求：明确 Node.js 最低版本为 18.20+ 开发文档：完善 CODEBUDDY.md，补充开发命令、目录结构说明和构建流程细节 文档同步：同步 CLI 文档到 IDE docs 目录，新增费用说明文档等"},{"id":"/cli/release-notes/v2.37.20","title":"🚀 CodeBuddy Code v2.37.20 发布","body":"🚀 CodeBuddy Code v2.37.20 发布 🔧 改进优化 模型临时切换：在模型选择面板按 键可仅对当前会话生效，不修改用户配置，方便临时测试不同模型 model 参数优化：命令行 参数现在正确覆盖项目级配置，当前会话立即生效 上下文压缩优化：压缩时过滤规则和记忆内容，避免将配置指令压缩进摘要，压缩后自动重新注入完整规则，保持 AI 行为一致性 配置面板精简：隐藏开发者选项，需通过 访问，让配置界面更简洁"},{"id":"/cli/release-notes/v2.37.19","title":"🚀 CodeBuddy Code v2.37.19 发布","body":"🚀 CodeBuddy Code v2.37.19 发布 🔧 改进优化 SDK 版本同步：更新 JavaScript/TypeScript SDK 至 0.3.14，Python SDK 至 0.3.12，保持 SDK 与 CLI 版本同步，确保最佳兼容性"},{"id":"/cli/release-notes/v2.37.18","title":"🚀 CodeBuddy Code v2.37.18 发布","body":"🚀 CodeBuddy Code v2.37.18 发布 🐛 问题修复 登录流程优化：修复登录方式映射配置问题,提升登录界面的交互体验和可用性 🔧 改进优化 SDK 版本更新：同步更新 SDK JS 至 0.3.13,SDK Python 至 0.3.11,保持与最新 SDK 的兼容性"},{"id":"/cli/release-notes/v2.37.17","title":"🚀 CodeBuddy Code v2.37.17 发布","body":"🚀 CodeBuddy Code v2.37.17 发布 🔧 改进优化 SDK 版本同步更新：SDK JS 更新至 0.3.12，SDK Python 更新至 0.3.10，确保与 CLI 版本保持同步"},{"id":"/cli/release-notes/v2.37.16","title":"🚀 CodeBuddy Code v2.37.16 发布","body":"🚀 CodeBuddy Code v2.37.16 发布 🔧 改进优化 配置更新：将机器人配置文件纳入构建流程，确保配置同步更新 🐛 问题修复 企业版登录兼容性：修复用户切换企业版 URL 登录时模型列表不一致的问题，确保 endpoint 变更后配置正确加载"},{"id":"/cli/release-notes/v2.37.15","title":"🚀 CodeBuddy Code v2.37.15 发布","body":"🚀 CodeBuddy Code v2.37.15 发布 🐛 问题修复 退出登录流程优化 修复了退出登录后 token 未正确清理的问题,确保认证拦截器正确处理登出状态,避免后续请求使用过期凭证。 HTTP 拦截器增强 改进认证 HTTP 拦截器的错误处理和状态同步机制,提升认证流程的稳定性和可靠性。"},{"id":"/cli/release-notes/v2.37.14","title":"🚀 CodeBuddy Code v2.37.14 发布","body":"🚀 CodeBuddy Code v2.37.14 发布 ✨ 新功能 SDK 动态配置 API 新增 和 方法，让开发者可以动态获取当前可用的权限模式和模型列表。同时， 和 现在仅影响当前会话，不再持久化到配置文件，让多会话场景下的配置管理更加灵活。 模型切换快捷键 支持 Option/Alt + P 快速切换模型，无需进入设置即可快速切换到合适的模型。 🔧 改进优化 用户提示增强：添加更多内置提示，帮助用户了解快捷键和操作技巧 输出限制统一：将各类工具的 token 限制统一为 20000，图片内容不受此限制；Read 工具支持 环境变量自定义 启动性能优化：优化认证和服务配置初始化流程，提升 CLI 冷启动速度 插件市场安装：优化市场和插件安装流程，显著减少首次安装和自动更新的等待时间 异步文件操作：将自定义命令、Agent 和 Skill 的加载改为异步并行处理 Git 信息收集：优化仓库扫描逻辑，采用异步并行处理提升性能 🐛 问题修复 Diff 渲染稳定性：修复了工具调用参数解析时因空字符串或不完整 JSON 导致的渲染崩溃问题"},{"id":"/cli/release-notes/v2.37.13","title":"🚀 CodeBuddy Code v2.37.13 发布","body":"🚀 CodeBuddy Code v2.37.13 发布 🔧 改进优化 企业版认证优化 优化企业 ID 获取时序，确保企业模型列表在用户登录后能够正确加载，改善企业用户的使用体验。 自定义认证修复 修复在自定义认证环境下，认证状态变化时导致 token 丢失的问题，确保认证流程的稳定性和可靠性。"},{"id":"/cli/release-notes/v2.37.12","title":"🚀 CodeBuddy Code v2.37.12 发布","body":"🚀 CodeBuddy Code v2.37.12 发布 🎨 界面优化 应用图标更新：更新 Work 应用图标，提升视觉一致性 🔧 改进优化 活动栏增强：新增活动栏组件，支持更丰富的导航和交互功能 设置服务优化：重构设置服务，提供更灵活的配置管理能力 历史记录缓存：新增历史缓存服务，改善会话历史的加载和管理体验 进程池管理：引入 ACP 进程池，提升多会话场景下的资源利用效率 Mermaid 图表：增强 Mermaid 图表渲染，支持更多图表类型和交互 国际化完善：补充中英文界面文案"},{"id":"/cli/release-notes/v2.37.11","title":"🚀 CodeBuddy Code v2.37.11 发布","body":"🚀 CodeBuddy Code v2.37.11 发布 📦 维护性更新 本次为维护性版本发布，主要包含： SDK 版本同步更新 内部依赖优化"},{"id":"/cli/release-notes/v2.37.10","title":"🚀 CodeBuddy Code v2.37.10 发布","body":"🚀 CodeBuddy Code v2.37.10 发布 🔧 改进优化 登录方式优化：简化登录选项为\"Chinese Site\"、\"International Site\"和\"Enterprise Domain\"，国内站点登录会自动根据网络环境选择最佳认证方式，提升登录体验"},{"id":"/cli/release-notes/v2.37.9","title":"🚀 CodeBuddy Code v2.37.9 发布","body":"🚀 CodeBuddy Code v2.37.9 发布 🔧 改进优化 侧边栏交互优化：支持拖拽调整宽度，新增会话管理操作按钮，让界面操作更加灵活便捷 User Agent 标识：ACP 进程启动时自动设置包含版本信息的 User Agent 请求头，便于服务端识别客户端版本 配置同步优化：为产品配置同步添加节流+防抖机制，减少高频调用造成的性能开销 日志增强：增加流式消息处理和配置缓存过期的调试日志，便于问题排查"},{"id":"/cli/release-notes/v2.37.8","title":"🚀 CodeBuddy Code v2.37.8 发布","body":"🚀 CodeBuddy Code v2.37.8 发布 🔧 改进优化 会话状态管理优化：优化 lastMessageId 在异步压缩时的更新机制，确保长对话场景下消息 ID 关联正确，提升会话恢复的可靠性"},{"id":"/cli/release-notes/v2.37.7","title":"🚀 CodeBuddy Code v2.37.7 发布","body":"🚀 CodeBuddy Code v2.37.7 发布 ✨ 新功能 红包封面推广：帮助面板新增「码到成功」红包封面领取入口，根据国内/国际版自动显示对应链接，助您在新年期间领取专属红包封面"},{"id":"/cli/release-notes/v2.37.6","title":"🚀 CodeBuddy Code v2.37.6 发布","body":"🚀 CodeBuddy Code v2.37.6 发布 🔧 改进优化 会话恢复增强：支持显示通过 命令生成的会话，用户不再丢失压缩后的会话历史"},{"id":"/cli/release-notes/v2.37.5","title":"🚀 CodeBuddy Code v2.37.5 发布","body":"🚀 CodeBuddy Code v2.37.5 发布 🐛 问题修复 ACP 会话模型设置：修复通过 SDK 切换模型后，后续对话仍使用旧模型的问题，现在模型切换会立即生效"},{"id":"/cli/release-notes/v2.37.4","title":"🚀 CodeBuddy Code v2.37.4 发布","body":"🚀 CodeBuddy Code v2.37.4 发布 ✨ 新功能 自定义 Session ID SDK 现在支持在创建会话时指定自定义 session ID，便于外部系统追踪和管理会话。这对于需要将 CodeBuddy 会话与业务系统集成的场景非常有用。 🐛 问题修复 会话历史加载：修复会话重连后历史消息无法正确显示的问题，改用 ACP session/load 机制加载历史 模型选择同步：修复模型 ID 映射问题，正确处理 SDK 返回的 modelId 字段 模型持久化：优化模型选择的持久化逻辑，确保用户选择在会话重连后保持一致 会话订阅栈溢出：防止 session 被重复订阅时导致的递归栈溢出问题 Stop Hook 序列化：移除未使用的 result 字段，避免序列化循环引用导致的错误 🔧 改进优化 工具步骤展示：优化工具调用列表的布局和动画效果，提升视觉体验"},{"id":"/cli/release-notes/v2.37.3","title":"🚀 CodeBuddy Code v2.37.3 发布","body":"🚀 CodeBuddy Code v2.37.3 发布 🔧 改进优化 Electron 桌面应用体验优化 单实例锁：防止应用多开，第二个实例会自动聚焦现有窗口 macOS 窗口行为：关闭窗口时隐藏而非退出，符合 macOS 应用规范 Dock 图标清理：修复子进程在 macOS Dock 中显示多余图标的问题 SDK API 增强 权限模式动态切换：Session API 新增 和 方法，支持在会话中动态切换权限模式 Plan 模式优化：切换到 plan 模式时返回 plan 文件路径，便于 SDK 获取和展示 历史消息处理：优化 Query API 中 resume + prompt 场景下的历史消息处理流程 消息列表交互优化 时间线排序：优化消息与工具调用的时间线排序，支持工具调用分组显示 反馈功能：新增消息点赞和点踩按钮，支持用户反馈 图片预览：用户消息图片支持点击放大预览，带有平滑动画效果 复制功能：改进助手消息复制逻辑，支持复制完整回复组；用户消息支持双击复制"},{"id":"/cli/release-notes/v2.37.2","title":"🚀 CodeBuddy Code v2.37.2 发布","body":"🚀 CodeBuddy Code v2.37.2 发布 🔧 改进优化 ACP 认证增强 在 authenticate 响应中返回用户信息，客户端可获取当前登录用户的 ID、用户名和昵称 修复已登录用户再次调用认证接口时无法弹出登录页面的问题 异步上下文压缩 引入异步上下文压缩机制，当对话历史达到临界阈值时自动触发后台压缩，提升长对话场景下的响应性能。 SDK 连接性能优化 优化连接池机制，支持并发查询场景下的预热连接复用，显著降低首次消息延迟 增加 选项，将 CLI 启动时间提前到预热阶段 增加会话锁机制，避免同一会话 ID 被并发恢复导致的数据混乱 其他改进 ACP 会话模型隔离：修复切换模型时影响全局配置的问题，现在模型切换仅影响当前会话 插件卸载清理：修复卸载插件后 MCP 配置仍然残留的问题，卸载时会自动清理相关配置 网络错误处理：优化 print 模式下网络错误自动重试逻辑，避免异常退出 SDK 性能优化：优化了会话恢复和用户交互流程，提升了 SDK 响应速度和稳定性 会话存储：支持跨项目目录搜索会话，新增 meta 文件分离存储 认证流程：优化认证机制，新增用户信息查询接口 服务模式：增强服务器模式策略功能"},{"id":"/cli/release-notes/v2.37.1","title":"🚀 CodeBuddy Code v2.37.1 发布","body":"🚀 CodeBuddy Code v2.37.1 发布 🔧 改进优化 认证 API 增强 新增 API，支持清除缓存的认证 token，让您可以方便地切换用户或环境。同时， 现在会自动检测已有有效认证，避免重复登录，提升使用体验。 Checkpoint Hook 新增实验性 Hook，支持在文件修改后自动触发。该 Hook 提供文件快照和变更统计信息，便于追踪文件变更历史和实现自动化审计，为代码质量管理提供更强大的支持。 Session API Hooks 支持 V2 Session API 现在支持配置 Hooks，可在会话中拦截和控制工具执行。这让您能够更灵活地定制会话行为，实现更精细的执行控制。"},{"id":"/cli/release-notes/v2.37.0","title":"🚀 CodeBuddy Code v2.37.0 发布","body":"🚀 CodeBuddy Code v2.37.0 发布 ✨ 新功能 SDK 认证 API 新增实验性认证接口，支持 SDK 独立完成登录流程： 支持多种认证环境（external、internal、iOA、cloudhosted、selfhosted） 自动检测已登录状态，避免重复登录 通过回调通知登录 URL，支持自定义浏览器打开逻辑 🔧 改进优化 React 状态管理：重构消息状态更新逻辑，使用不可变操作替代直接修改，符合 React 最佳实践，提升组件渲染稳定性"},{"id":"/cli/release-notes/v2.36.3","title":"🚀 CodeBuddy Code v2.36.3 发布","body":"🚀 CodeBuddy Code v2.36.3 发布 🔧 改进优化 跨平台兼容性提升：优化 Shell 执行在 Windows 系统下的路径处理，修复包含空格路径导致的执行问题 权限匹配增强：改进复杂 Shell 命令的权限规则匹配，支持 、 、 、 等操作符组合的命令解析，使权限规则能够准确匹配组合命令中的各个子命令 输入菜单响应优化：修复菜单状态检测延迟导致的快捷键冲突问题，提升命令和文件建议菜单的响应速度 历史记录过滤：优化会话历史加载时的消息展示 🐛 问题修复 循环依赖修复：修复模块间循环引用问题，通过延迟获取依赖改善服务隔离 📝 文档更新 SDK 文档修正：修正自定义工具导入路径， 和 应直接从 导入 SDK 版本要求更新：将文档中的 CodeBuddy Agent SDK 版本要求从 v0.2.0 更新为 v0.1.24"},{"id":"/cli/release-notes/v2.33.1","title":"🚀 CodeBuddy Code v2.33.1 发布","body":"🚀 CodeBuddy Code v2.33.1 发布 🔧 改进优化 会话上下文类型优化：重构会话、检查点和上下文管理的类型定义，增强输入项处理和历史记录工具的类型安全性 命令权限检查：优化白名单命令链的权限判断，当所有子命令都在安全白名单中时直接放行，无需额外确认 Memory 加载器：修复暂时禁用的子目录 Memory 加载方法导致的编译警告"},{"id":"/cli/release-notes/v2.33.0","title":"🚀 CodeBuddy Code v2.33.0 发布","body":"🚀 CodeBuddy Code v2.33.0 发布 ✨ 新功能 模型选择记忆 打开模型面板时自动定位到当前使用的模型，无需手动滚动查找。 🔧 改进优化 LSP 位置转换：修正编辑器行列号与 LSP 服务器之间的坐标转换逻辑，代码跳转、引用查找等操作现在能够准确定位 消息队列稳定性：修复用户在 Agent 执行期间发送的消息可能丢失的问题，确保消息在多轮对话中正确保留 输入建议优化：添加防抖机制，减少不必要的请求，提升输入体验 性能优化：减少组件不必要的重渲染，提升界面响应速度 稳定性提升：修复空列表场景下的潜在崩溃问题 子目录规则支持：支持在项目子目录中放置 CODEBUDDY.md 文件，操作该目录下的文件时自动触发相应规则 文件扩展名兼容：新增对 扩展名的支持（CODEBUDDY.mdc、AGENTS.mdc） Glob 匹配优化：启用 matchBase 模式， 等简单模式现在能够匹配任意目录层级下的文件 条件规则注入增强：文件操作工具执行时自动触发条件规则匹配 🐛 问题修复 上下文压缩：修复压缩过程中中断会话时错误显示中断消息的问题 📝 文档更新 工具文档：新增 NotebookEdit、LSP、TaskOutput 工具说明 CLI 参数：新增 和 参数文档"},{"id":"/cli/release-notes/v2.32.0","title":"🚀 CodeBuddy Code v2.32.0 发布","body":"🚀 CodeBuddy Code v2.32.0 发布 ✨ 新功能 Prompt 建议 在 Agent 完成对话后，CodeBuddy 会自动预测您下一步可能的操作，并以灰色文本形式显示在输入区域。按 Enter 直接发送建议，按 Tab 进入编辑模式，让您的工作流更加顺畅。 🔧 改进优化 上下文管理：修复 MCP 工具信息收集时的异常处理逻辑，提升系统稳定性 配置系统：优化默认值合并逻辑，修复不同配置层级的加载问题 后台任务管理：优化任务注册机制，支持选择性状态监控，减少资源开销 文件搜索工具：增强文件路径匹配算法和 Git 忽略规则处理，提升搜索准确性 错误处理：改进网络错误日志记录，增强问题排查能力 📝 文档更新 MCP 配置文档：更新 MCP 配置文件位置说明，增加基于优先级的配置文件解析机制"},{"id":"/cli/release-notes/v2.31.2","title":"🚀 CodeBuddy Code v2.31.2 发布","body":"🚀 CodeBuddy Code v2.31.2 发布 🔧 改进优化 会话历史记录增强：每条历史消息现在会自动记录产生时的工作目录，便于追溯消息来源 空闲提示通知：用户输入后等待 60 秒无操作时，自动发送终端通知提醒用户，避免遗忘正在进行的任务 MCP 配置路径一致性：修复 toggle manager 在读写配置时的路径优先级逻辑，确保与 config store 行为保持一致 OSC 通知协议优化：调整终端协议优先级，为 iTerm 提供专用的 OSC 9 支持，提升兼容性体验 通知消息简化：移除通知消息中的产品名称前缀，让消息更加简洁清晰 计划模式优化：改进计划审批流程和存储机制，提升使用体验 MCP 配置系统：优化 MCP 配置作用域架构，提升配置隔离性和安全性 文档优化：移除文档中的冗余目录结构，简化文档内容 🐛 问题修复 目录信任匹配：修复递归信任模式无法匹配目录本身的问题，确保目录信任功能正常工作"},{"id":"/cli/release-notes/v2.31.1","title":"CodeBuddy Code v2.31.1 发布","body":"CodeBuddy Code v2.31.1 发布 🔧 改进优化 文件搜索工具：优化 glob 模式处理逻辑，提升模式标准化的准确性 Shell 兼容性提示：在环境信息和命令执行提示中添加默认 Shell 类型，确保生成的命令与用户 Shell 语法兼容 插件市场 Git 操作优化：禁用 Git 凭证提示和交互式 SSH 认证，改善无人值守环境下的插件安装体验 🐛 问题修复 文件权限检查：修复工作区内文件读取时需要重复授权的问题，现在已信任的工作区目录会自动递归信任其所有子文件"},{"id":"/cli/release-notes/v2.31.0","title":"🚀 CodeBuddy Code v2.31.0 发布","body":"🚀 CodeBuddy Code v2.31.0 发布 ✨ 新功能 ACP HTTP 传输协议 新增 Streamable HTTP 传输模式，为 ACP 协议提供更灵活的集成方式： 支持通过 HTTP 端点使用 ACP 协议 可通过 参数启用 提供配套的客户端 SDK，方便快速集成 反馈命令 新增 命令，快速提交反馈或 bug 报告，自动打开浏览器并预填会话信息。 会话历史 API 端点支持获取历史会话的对话消息列表，方便 IDE 集成开发。 插件管理界面增强 全新的插件管理体验，新增 6 个功能 tabs： Discover/Browse：发现和浏览可用插件 Installed：管理已安装插件 Marketplaces：管理插件市场源 Errors：查看详细错误诊断，支持 20+ 种错误类型分类 新增 命令，验证插件有效性 🔧 改进优化 新增模型支持：支持 Kimi K2 Thinking 推理模型 UI 渲染性能：优化终端界面渲染，提升消息显示流畅度 服务代理：Hook 脚本可通过服务代理调用网关服务 LSP 集成：改进 Windows 平台兼容性，修复路径空格问题，增强 C 等语言服务器兼容性 权限管理：优化 Plan 模式下安全命令的自动审批逻辑 Checkpoint 对比：支持对比磁盘文件与快照的差异统计 对话恢复：在恢复选择器中显示检查点时间信息 工作区规则：优化规则注入标签，改进 AI 规则识别能力 🐛 问题修复 规则导入：修复 时被导入规则被错误跳过的问题 上下文压缩：修复压缩后工具审批请求仍弹窗的问题 📝 文档更新 ACP 文档：补充传输协议选择和 HTTP 传输使用说明 环境变量：补充 mTLS、Shell、模型等环境变量配置说明 插件文档：更新插件系统使用说明和错误处理指南"},{"id":"/cli/release-notes/v2.30.1","title":"🚀 CodeBuddy Code v2.30.1 发布","body":"🚀 CodeBuddy Code v2.30.1 发布 🔧 改进优化 文件搜索工具：优化了搜索逻辑，提升了代码可读性和执行效率"},{"id":"/cli/release-notes/v2.30.0","title":"🚀 CodeBuddy Code v2.30.0 发布","body":"🚀 CodeBuddy Code v2.30.0 发布 ✨ 新功能 内置插件市场 新增 CodeBuddy 官方插件市场，提供官方推荐的优质插件，方便用户快速发现和安装。 🔧 改进优化 对话压缩展示：改进对话压缩功能的界面展示，提供更清晰的视觉反馈 文件搜索分页：为 Glob 工具添加 和 参数支持，支持对大型搜索结果进行分页处理 内容搜索分页：为 Grep 工具添加 参数并优化 处理，提升搜索结果的灵活性 API Key 配置：支持通过 settings 配置 API Key，提供更灵活的认证方式 MCP 配置路径显示：改进 MCP 服务器配置文件路径的显示逻辑，正确显示所有配置范围的路径信息 MCP 服务管理：已禁用的 MCP 服务现在可以查看详情页面 工具权限控制：优化工具权限审批流程，增强对特定工具操作的安全控制能力 目录授信优化：用户可以在目录授信提示中选择信任当前目录、信任父目录或递归信任所有子目录，避免对子目录重复授权 Checkpoint 协议优化：提取通用数据结构，减少代码重复，优化会话数据结构和恢复对话 UI"},{"id":"/cli/release-notes/v2.29.0","title":"🚀 CodeBuddy Code v2.29.0 发布","body":"🚀 CodeBuddy Code v2.29.0 发布 ✨ 新功能 会话恢复支持 新增会话恢复功能，支持在 IDE 集成场景下无缝恢复和切换已有会话，提升跨会话工作流的连续性和效率。 LSP 插件支持 新增 Language Server Protocol 插件支持，为 AI 提供实时代码智能功能： 理解代码结构、类型定义和函数签名 支持跨文件的符号跳转和引用查找 提升代码分析的准确性和效率 🔧 改进优化 身份认证性能：优化认证流程，减少不必要的配置检查，提升启动速度 UI 组件优化：改进加载状态显示组件，提升渲染效率和代码结构 子代理追踪：增强子代理任务执行的内部追踪机制，提升事件流处理准确性 🐛 问题修复 会话管理：修复 CLI Agent 会话 ID 管理问题，提升会话持久化和恢复的稳定性 启动命令：修复 命令无法正常执行的问题 网络异常处理：修复子 agent 执行时网络异常导致的错误传播问题，提升任务执行稳定性 待办列表：优化 命令的数据加载逻辑，支持从文件系统恢复待办列表 MCP 连接：改进 MCP 服务器连接机制，支持自定义超时配置，提升连接可靠性 📝 文档更新 身份认证：重构 IAM 文档结构，添加快速开始指南和场景化认证配置示例 插件开发：更新插件开发文档，添加 LSP 配置指南和使用示例 版本说明：新增 v2.28.1 版本发布说明文档 文档索引：更新 CLI 文档索引映射"},{"id":"/cli/release-notes/v2.28.1","title":"🚀 CodeBuddy Code v2.28.1 发布","body":"🚀 CodeBuddy Code v2.28.1 发布 🐛 问题修复 双击 ESC 回退功能：修复输入框为空时连续按两次 ESC 键无法正确触发对话回退功能的问题，现在可以正常使用快捷键快速进入对话回退面板"},{"id":"/cli/release-notes/v2.28.0","title":"🚀 CodeBuddy Code v2.28.0 发布","body":"🚀 CodeBuddy Code v2.28.0 发布 ✨ 新功能 代码安全审查命令：新增 命令，可进行专业的代码安全审查，识别潜在安全漏洞 条件规则加载：支持根据文件操作自动加载相关规则，通过 字段配置匹配模式 模块化规则管理：支持在 目录下组织规则文件，可使用子目录分类管理 本地记忆配置：新增 文件支持个人偏好设置，不会提交到版本控制 AI 模型扩展：新增 GLM 4.6V 和 DeepSeek V3.2 模型支持 Homebrew 安装：macOS/Linux 用户可通过 直接安装 🔧 改进优化 自定义命令渲染：改进命令模板解析，支持内联 Bash 命令执行 记忆加载机制：优化规则触发方式，提升加载效率 MCP 工具列表：增强服务器工具获取稳定性 错误信息优化：提升错误提示可读性，便于问题定位 日志记录增强：设置管理新增详细日志，方便问题排查 Homebrew 更新检测：支持正确检测 Homebrew 安装版本的更新 MCP 输出限制：改进工具输出大小计算方式 MCP 超时配置：支持通过环境变量配置连接超时 🐛 问题修复 代理工具配置：修复 compact 代理的文件读取能力配置问题 Windows IDE 连接：改进 Windows 平台 IDE 进程检测，提升连接稳定性"},{"id":"/cli/release-notes/v2.27.3","title":"🚀 CodeBuddy Code v2.27.3 发布","body":"🚀 CodeBuddy Code v2.27.3 发布 🔧 改进优化 MCP 服务器状态显示：改进待审批服务器的状态展示，更清晰地了解连接状态 自动更新稳定性：优化更新锁机制，避免极端情况下的更新循环 文件搜索一致性：统一文件忽略规则管理，提升搜索结果的准确性 界面响应优化：简化输出面板布局，提升界面响应速度 🐛 问题修复 复杂任务处理：修复子任务因执行限制导致无法完成的问题，现在可以处理更复杂的多步骤任务 上下文压缩质量：改进上下文压缩时的文件读取能力，提升压缩后的内容准确性 子任务稳定性：修复子任务中消息意外转发的问题，提升任务执行的隔离性 SDK 模式优化：改进权限拒绝时的处理逻辑，提升 SDK 集成体验"},{"id":"/cli/release-notes/v2.27.2","title":"🚀 CodeBuddy Code v2.27.2 发布","body":"🚀 CodeBuddy Code v2.27.2 发布 🐛 问题修复 Alpine Linux 兼容性修复：解决在 Alpine 等 musl 系统上运行时的崩溃问题，提升跨平台稳定性 MCP 连接优化：修复并发连接请求导致的传输层冲突问题，提升连接稳定性 命令执行优化：改进一次性命令的 MCP 初始化逻辑，减少不必要的连接开销"},{"id":"/cli/release-notes/v2.27.1","title":"🚀 CodeBuddy Code v2.27.1 发布","body":"🚀 CodeBuddy Code v2.27.1 发布 🔧 改进优化 错误信息展示优化：提升错误信息的准确性和可读性，帮助您更快定位和解决问题 网络连接增强：自动识别网络波动并进行重试，提升服务稳定性和可用性 界面显示改进：统一工具调用结果和异步任务完成通知的展示效果，提供更一致的交互体验 🐛 问题修复 文件路径建议优化：修复文件搜索时路径建议不准确的问题，提升输入效率 输入体验改进：消除交互式输入时建议列表闪烁现象，提供更流畅的输入体验 启动速度提升：解决插件市场初始化时的阻塞问题，加快启动响应速度 Token 统计准确性：修复 token 计算逻辑，确保使用量统计的准确性 错误诊断增强：改进错误信息提取和显示机制，提供更详细和有用的错误诊断信息 网络重试优化：完善超时和连接中断的处理策略，减少因网络波动导致的操作失败"},{"id":"/cli/release-notes/v2.27.0","title":"🚀 CodeBuddy Code v2.27.0 发布","body":"🚀 CodeBuddy Code v2.27.0 发布 ✨ 新功能 对话回退：新增 命令，支持将对话回退到之前的某个消息点，可选择仅回退对话、仅回退代码或同时回退两者 文件检查点：支持在会话中自动创建文件检查点，可在回退时恢复文件到之前的状态 插件市场自动更新：支持为插件市场启用自动更新功能，启动时自动同步市场内容，后台异步执行不影响启动速度 🔧 改进优化 快捷键增强：新增双击 ESC 快捷键激活回退功能，当输入框为空时连续按两次 ESC 可快速进入对话回退面板 🐛 问题修复 插件配置解析修复：修复插件市场配置解析问题，支持多种配置格式，提升配置兼容性 构建脚本权限修复：修复 wheel 包构建过程中二进制文件可执行权限丢失的问题"},{"id":"/cli/release-notes/v2.26.0","title":"🚀 CodeBuddy Code v2.26.0 发布","body":"🚀 CodeBuddy Code v2.26.0 发布 ✨ 新功能 Skills 面板：新增 命令，可快速查看已加载的所有 Skills（包括用户级、项目级和插件级），并显示预估 token 消耗，帮助您更好地管理和优化上下文使用 🔧 改进优化 上下文信息展示优化：优化 命令的 skills 和自定义命令展示方式，按作用域分组并按 token 使用量排序，让您清晰了解上下文消耗详情 任务列表持久化：会话中的任务列表现在会自动保存，确保在上下文压缩后仍能保持完整的任务状态，让长时间会话管理更可靠 终端和编辑器支持扩展：新增对 Kitty、Alacritty 终端以及 Zed 编辑器的自动识别支持；扩展 JetBrains 全系列 IDE 识别能力（包括 IntelliJ IDEA、WebStorm、PhpStorm、GoLand、Rider、CLion、RubyMine、DataGrip 等） 工具调用稳定性提升：增强工具名称匹配能力，提高 Agent 工具调用的成功率和准确性 代码对比体验增强：改进差异对比视图中的文本高亮显示，让代码审查更轻松高效 代码体积优化：移除未使用的内部工具，减少程序体积 🐛 问题修复 子代理事件处理：修复子代理任务结果事件重复传播到主会话的问题，提升多代理协作的稳定性"},{"id":"/cli/release-notes/v2.25.1","title":"🚀 CodeBuddy Code v2.25.1 发布","body":"🚀 CodeBuddy Code v2.25.1 发布 ✨ 新功能 SDK 系统提示词配置：SDK 支持通过配置选项自定义系统提示词，灵活控制 AI 助手的行为和响应风格 🔧 改进优化 文件搜索性能优化：新增搜索结果去重和节流机制，大幅提升大型代码库的搜索响应速度 大仓库支持增强：添加文件和目录数量限制保护机制，防止超大仓库导致内存问题 目录浏览优化：搜索结果现在优先展示目录，方便快速定位项目结构 错误信息展示改进：优化身份认证错误的诊断信息，帮助更快定位和解决问题 工具控制优化：改进会话级别的工具禁用机制，提供更精细的功能控制 🐛 问题修复 流式响应处理修复：修复响应为空时的异常处理，提升错误提示准确性 MCP 权限批量设置：支持使用通配符语法一次性批准服务器的所有工具，简化权限管理流程 多行输入导航修复：修正多行文本输入时 Home/End 键的光标定位行为 编辑器错误提示优化：改进外部编辑器打开失败时的错误提示逻辑 搜索超时优化：文件搜索超时调整为 30 秒，防止僵尸进程占用系统资源"},{"id":"/cli/release-notes/v2.25.0","title":"🚀 CodeBuddy Code v2.25.0 发布","body":"🚀 CodeBuddy Code v2.25.0 发布 ✨ 新功能 计划模式工具：Agent 在执行复杂任务前可主动进入规划阶段，帮助您更好地理解和确认执行计划 模型支持升级：新增对更强大推理模型的支持，提供更长的上下文窗口和更强的推理能力 🔧 改进优化 错误诊断增强：认证失败时提供更详细的错误信息，帮助快速定位和解决问题；优化请求追踪功能，便于排查完整的请求链路 MCP 工具权限管理：支持在项目级别保存工具权限设置，使用\"不再询问\"选项后在整个项目中生效，提升多项目工作流效率 Agent 面板优化：更清晰地展示不同类型的 Agent；改进命令搜索排序算法，让您更快找到想要的命令；扩展外部编辑器支持范围，提供更好的错误提示 输入体验提升：优化输入提示框的响应速度和流畅度；改进反向搜索功能的显示效果，提升交互体验 🐛 问题修复 会话上下文：修复代理服务中上下文传递问题，确保对话信息正确保留和传递 大文件读取：增加文件读取的 token 数量检查，避免读取超大日志文件时超出模型上下文限制导致的错误"},{"id":"/cli/release-notes/v2.24.0","title":"🚀 CodeBuddy Code v2.24.0 发布","body":"🚀 CodeBuddy Code v2.24.0 发布 ✨ 新功能 内置插件市场：支持通过产品配置预置官方推荐的插件市场，启动时自动安装，让用户更方便地发现和使用优质插件 🔧 改进优化 后台任务执行：重构任务管理模块，提升后台任务执行的稳定性和可靠性 待办事项体验：优化待办事项状态更新机制，提升界面响应速度 🐛 问题修复 工具权限检查：修复在 SDK 模式下工具权限检查失效的问题，确保工具调用安全 外部编辑器粘贴：修复从外部编辑器粘贴内容时的文本处理问题，改善输入体验 子代理工具继承：修复子代理配置中的工具继承逻辑，确保正确获取默认工具权限 上下文裁剪时机：优化对话历史裁剪策略，避免超出模型上下文限制导致的错误"},{"id":"/cli/release-notes/v2.23.5","title":"🚀 CodeBuddy Code v2.23.5 发布","body":"🚀 CodeBuddy Code v2.23.5 发布 🔧 改进优化 斜杠命令权限控制：支持为自定义命令配置工具细粒度权限，提升命令执行安全性和灵活性 🐛 问题修复 ACP 模式权限请求：修复在 ACP 协议模式下工具调用权限请求失效的问题，确保工具执行前正确获得用户授权 Subagent 工具访问：修复 MCP 服务器名称包含特殊字符时子代理工具访问失败的问题，提升多代理协作稳定性 工具权限隔离：优化子代理工具权限管理，确保每个代理获得正确的工具访问权限"},{"id":"/cli/release-notes/v2.23.0","title":"🚀 CodeBuddy Code v2.23.0 发布","body":"🚀 CodeBuddy Code v2.23.0 发布 ✨ 新功能 SDK 权限控制：SDK 现支持工具调用权限管理，客户端可以审批或拒绝工具执行请求 交互式问答：SDK 支持 AskUserQuestion 工具，AI 助手可在执行任务时向用户提问并获取反馈 🔧 改进优化 文件搜索性能大幅提升：优化大型仓库下的 @ 文件搜索体验，解决连续输入导致的卡顿问题 后台预加载机制：文件列表在空闲时自动预加载，首次搜索响应更快 智能查询结果：使用 requestId 机制丢弃过期请求，防止结果闪烁 代码规范统一：清理代码中的第三方品牌引用，统一使用产品标准命名 🐛 问题修复 修复首次搜索卡死：首次查询若预加载未完成则异步加载，不阻塞界面响应 修复 Windows 路径匹配：确保所有路径统一为 POSIX 风格，避免匹配失败 修复定时器泄漏：确保超时定时器在所有退出路径上正确清理 修复 Windows .gitignore 规则识别：正确识别以 开头的根规则"},{"id":"/cli/release-notes/v2.23.4","title":"🚀 CodeBuddy Code v2.23.4 发布","body":"🚀 CodeBuddy Code v2.23.4 发布 🔧 改进优化 上下文统计增强： 命令现在会显示 MCP 工具的 token 占用情况，帮助用户更全面地了解上下文使用详情 界面渲染优化：提升终端界面渲染性能和显示稳定性，增强会话状态处理的可靠性 🐛 问题修复 修复首次登录问题：修复首次使用 API Key 认证时无法正确登录的问题 凭证验证增强：增加凭证存在性检查，当凭证获取失败时自动回退到其他认证方式 路径解析改进：支持配置路径中的 展开，提升配置便利性 流式输出优化：修复流式输出时消息标识符重复的问题 会话恢复稳定性：增强空值检查，避免特定场景下的运行时错误 模块加载优化：解决产品配置管理模块的循环依赖问题"},{"id":"/cli/release-notes/v2.23.3","title":"🚀 CodeBuddy Code v2.23.3 发布","body":"🚀 CodeBuddy Code v2.23.3 发布 🔧 改进优化 稳定性提升：常规维护性更新，提升系统稳定性"},{"id":"/cli/release-notes/v2.23.2","title":"🚀 CodeBuddy Code v2.23.2 发布","body":"🚀 CodeBuddy Code v2.23.2 发布 ✨ 新功能 模型支持扩展：新增 GLM 4.7 模型支持，为用户提供更多模型选择"},{"id":"/cli/release-notes/v2.22.0","title":"🚀 CodeBuddy Code v2.22.0 发布","body":"🚀 CodeBuddy Code v2.22.0 发布 ✨ 新功能 SDK 集成增强：新增 SDK 与 CLI 之间的双向通信能力，支持控制信号传递 灵活权限控制：SDK 可以接管工具执行权限，实现自定义权限策略 钩子系统扩展：支持 SDK 注册工具执行钩子，实现自定义拦截和处理逻辑 🔧 改进优化 界面体验提升：优化终端加载框的显示效果，提升视觉呈现和交互体验 🐛 问题修复 输出兼容性增强：修复 SDK 和管道模式下终端控制序列干扰 JSON 输出的问题，确保数据格式正确 搜索准确性提升：改进文件忽略规则匹配逻辑，提升文件搜索的准确性"},{"id":"/cli/release-notes/v2.21.0","title":"🚀 CodeBuddy Code v2.21.0 发布","body":"🚀 CodeBuddy Code v2.21.0 发布 ✨ 新功能 新增模型支持：添加 GPT 5.2 模型，为您提供更强大的推理能力和更智能的代码辅助 🔧 改进优化 加载状态优化：改进终端加载提示的显示效果，让等待过程更加清晰直观 🐛 问题修复 命令执行稳定性：修复子进程调用时可能出现的进程挂起问题，提升命令执行的可靠性"},{"id":"/cli/release-notes/v2.20.1","title":"🚀 CodeBuddy Code v2.20.1 发布","body":"🚀 CodeBuddy Code v2.20.1 发布 🐛 问题修复 CLI 模式判断优化：修复非交互命令（如 install、update）在终端下的输出显示问题 首次安装兼容：修复二进制首次安装时路径检测失败的问题，确保首次安装体验更顺畅 图片内容传输：修复流式输出中图片内容的转换处理，确保图片数据正确显示 🔧 改进优化 任务进度显示：优化任务进度条的视觉效果，更清晰地展示任务执行状态 工具加载增强：改进动态工具的加载时序，确保子代理能正确使用所有可用工具 会话管理稳定性：提升会话生命周期管理的稳定性和性能 输入交互体验：改进终端输入处理，提供更稳定的交互体验 连接可靠性：优化协议通信逻辑，提升连接稳定性"},{"id":"/cli/release-notes/v2.20.0","title":"🚀 CodeBuddy Code v2.20.0 发布","body":"🚀 CodeBuddy Code v2.20.0 发布 ✨ 新功能 使用统计命令：新增 命令，轻松查看您的使用情况，包括 Token 使用量、会话时长、模型调用次数等核心数据 多维度统计视图：支持按模型分类查看使用情况，可在 7 天、30 天和全部时间范围之间灵活切换 可视化图表：提供直观的 ASCII 条形图，清晰展示各模型的使用占比 🔧 改进优化 会话管理增强：优化会话历史记录的存储和清理机制，提升会话管理的稳定性和可靠性 交互体验提升：改进确认框、输入提示框和会话面板的交互体验，操作更流畅便捷 键盘操作优化：增强键盘快捷键的响应稳定性和准确性，提升操作效率 安装检测改进：优化不同环境下的安装方式识别准确性，减少环境相关问题 代理框架升级：更新 OpenAI agents SDK 至最新版本，提升整体稳定性和性能 🐛 问题修复 上下文显示问题：修复 autocompact 禁用时仍显示 buffer 信息的问题，现在显示逻辑更符合预期 Linux 兼容性：解决在旧版 Linux 系统上启动时可能遇到的动态库加载错误 主题显示优化：修正色盲模式下的主题颜色显示效果，改善视觉体验 响应完整性：确保任务结束时总是返回结果消息，避免客户端无法正确退出的问题 错误信息增强：改进错误日志记录，提供更详细的调试信息，便于问题排查"},{"id":"/cli/release-notes/v2.19.2","title":"🚀 CodeBuddy Code v2.19.2 发布","body":"🚀 CodeBuddy Code v2.19.2 发布 🔧 改进优化 对话历史管理：提升对话历史管理效率，优化内存使用，支持更长的对话会话 会话状态管理：优化会话状态管理逻辑，提升多会话切换时的响应速度和稳定性 代码健壮性：完善内部类型定义，提升代码的类型安全性和可维护性 扩展系统增强：改进工具调用前后的钩子执行机制，为插件开发提供更好的扩展性 消息展示优化：优化对话消息的组织和展示逻辑，提升交互体验的流畅度 全新视觉主题：采用全新的品牌绿色配色方案，提升产品视觉识别度 Logo 设计升级：优化终端 Logo 显示效果，采用简洁清爽的机器人头像风格"},{"id":"/cli/release-notes/v2.19.1","title":"🚀 CodeBuddy Code v2.19.1 发布","body":"🚀 CodeBuddy Code v2.19.1 发布 🔧 改进优化 ACP 协议优化：完善命令过滤机制和输出展示，提升协议兼容性和界面清爽度 图片读取支持：Read 工具现在可以直接读取和显示图片文件，支持更丰富的文件处理场景 界面加载优化：简化会话加载状态管理，提升界面响应速度和稳定性 🐛 问题修复 工具审批界面：修复 ACP 协议模式下审批界面信息显示不全的问题，提升信息可读性 Hook 集成机制：改进工具执行 Hook 调用，确保自定义脚本能正确处理工具参数 退出流程完善：修复命令行退出时会话事件未正确触发的问题 终端兼容性：修复在 Windows 和 Linux 部分终端中粘贴大量文本时的兼容性问题"},{"id":"/cli/release-notes/v2.19.0","title":"🚀 CodeBuddy Code v2.19.0 发布","body":"🚀 CodeBuddy Code v2.19.0 发布 ✨ 新功能 会话重命名：新增 命令，支持快速重命名当前会话，可直接传参或通过交互式面板操作 输入撤销：新增 快捷键支持，可随时撤销输入框中的文本编辑 🔧 改进优化 会话恢复面板：优化会话恢复界面，提供更直观的会话管理体验 连接诊断增强：改进网络连接断开场景的诊断信息，便于问题排查"},{"id":"/cli/release-notes/v2.18.0","title":"🚀 CodeBuddy Code v2.18.0 发布","body":"🚀 CodeBuddy Code v2.18.0 发布 ✨ 新功能 API 密钥缓存支持：提高凭据管理的响应速度和效率，减少频繁认证的等待时间。支持通过环境变量 自定义缓存刷新间隔 🔧 改进优化 UI 性能优化：减少界面不必要的重新渲染，提升交互流畅度 粘贴功能增强：提升文本粘贴的处理速度和稳定性 命令显示优化：智能控制命令元数据长度，提升长提示词场景下的性能 模型选择更新：扩展可用模型列表，提供更多选择 🐛 问题修复 MCP OAuth 认证流程修复：解决授权后需要手动重连的问题，提升认证体验 终端兼容性提升：修复在 tmux 环境中代码高亮显示异常的问题"},{"id":"/cli/release-notes/v2.17.0","title":"🚀 CodeBuddy Code v2.17.0 发布","body":"🚀 CodeBuddy Code v2.17.0 发布 ✨ 新功能 IDE 集成增强：新增 IDE 差异确认视图和交互面板，支持在 IDE 中直观审查代码变更 智能确认流程：引入 IDE 确认服务和拦截器，提升工具调用的安全性和用户体验 终端标题自动更新：CLI 会根据对话上下文智能更新终端标题，帮助用户在多个终端窗口中快速识别工作内容 Windows 终端键盘增强：改进 Windows 终端的键盘输入处理，增强多行编辑支持。新增 Windows Terminal 自动配置功能，支持 Shift+Enter 换行快捷键 🔧 改进优化 工具调用界面优化：改进文件读取和搜索工具的展示方式，提供更清晰的信息呈现 权限管理增强：为文件操作工具添加明确的权限确认流程，提升安全性 搜索体验优化：改进文件搜索工具的权限检查机制，在可信目录下提供更流畅的使用体验 界面交互改进：提升终端界面的多选和输入组件交互体验 快捷键调整：将展开详细记录的快捷键从 Ctrl+R 调整为 Ctrl+O，避免与终端反向搜索功能冲突 历史消息展示优化：改进对话记录的展示效果，提供更清晰的查看体验 更新通知改进：优化版本更新通知的显示机制，提升稳定性 🐛 问题修复 ACP 协议兼容性：修复 ACP 模式下会话被错误终止的问题，确保消息流正常传输 自定义模型加载：改进配置文件读取错误处理，提升自定义模型加载的稳定性 消息显示修复：修复历史对话中未完成的消息在新对话中重复出现的问题 管道输入稳定性：改进命令行管道输入的数据读取机制，避免数据丢失 Token 统计准确性：改进模型响应处理的健壮性，避免统计异常 Vim 模式输入：修复 Vim NORMAL 模式下意外输入文本的问题，现在能正确拦截所有输入 Vim 两字符命令：修复 、 、 、 、 、 、 、 、 等命令的处理，支持超时自动取消 工具执行容错：提升多工具并发执行的容错性，单个工具失败不影响其他工具结果"},{"id":"/cli/release-notes/v2.16.0","title":"CodeBuddy Code v2.16.0 发布","body":"CodeBuddy Code v2.16.0 发布 ✨ 新功能 输入历史反向搜索：支持 快捷键在命令历史中进行交互式搜索，快速定位和重用之前的输入内容 🔧 改进优化 输入体验升级：重构输入框状态管理，提升响应速度和交互流畅度 粘贴功能优化：改进剪贴板粘贴体验，更好地处理图片和大文本内容 命令快捷设置： 命令支持直接输入模型 ID 快速切换 更新策略智能化：根据包管理器自动选择最优更新方式 诊断信息完善：Doctor 面板显示自动更新状态和包管理器信息 🐛 问题修复 修复 ACP 模式下终端输出干扰通信的问题 修复反向搜索删除关键词后状态异常的问题 修复子代理消息传递不完整的问题 修复命令执行时可能出现的异常"},{"id":"/cli/release-notes/v2.15.1","title":"CodeBuddy Code v2.15.1 发布","body":"CodeBuddy Code v2.15.1 发布 🔧 改进优化 消息调试增强：为流式输出添加时间戳字段，便于调试和性能分析 代码架构优化：改进消息处理逻辑结构，提升代码可维护性和复用性 Vim 模式操作优化：改进单词移动逻辑，提升光标导航的准确性和流畅度 🐛 问题修复 状态管理优化：修复用户中断操作后状态被异步事件覆盖的问题，确保中断状态正确保持"},{"id":"/cli/release-notes/v2.15.0","title":"🚀 CodeBuddy Code v2.15.0 发布","body":"🚀 CodeBuddy Code v2.15.0 发布 ✨ 新功能 终端通知系统：当终端在后台运行时，AI 助手完成任务后会发送系统通知提醒你查看结果 🔧 改进优化 代理配置增强：支持 NOPROXY 环境变量，可以指定哪些域名不走代理 Vim 模式导航优化：改进 命令的准确性，在单词间移动更加流畅 诊断面板优化：设置信息显示更清晰，复杂配置提供摘要视图 TODO 工具增强：任务列表解析更稳定，容错性更好 🐛 问题修复 子代理执行稳定性：修复连续执行多个子代理时可能出现的响应中断问题 安全更新：修复依赖包中的高危安全漏洞，提升整体安全性 /clear 命令改进：使用清屏命令后，权限模式设置不再被意外重置"},{"id":"/cli/release-notes/v2.14.1","title":"🚀 CodeBuddy Code v2.14.1 发布","body":"🚀 CodeBuddy Code v2.14.1 发布 🔧 改进优化 CLI 交互体验优化：改进命令行界面的交互流程和用户反馈机制，提升操作流畅度 会话管理增强：提升会话中断处理的稳定性和响应能力，减少意外中断影响 Vim 模式完善：优化 Vim 模式下的键盘操作和上下文管理，提供更流畅的编辑体验 工具执行优化：改进工具调用和结果处理的性能与准确性，加快任务响应速度"},{"id":"/cli/release-notes/v2.14.0","title":"CodeBuddy Code v2.14.0 发布","body":"CodeBuddy Code v2.14.0 发布 ✨ 新功能 Vim 编辑器模式：新增 Vim 风格编辑支持，提供 NORMAL 和 INSERT 模式切换，支持标准 Vim 导航和编辑命令，让习惯 Vim 的用户获得熟悉的编辑体验 IDE 选择交互：新增 命令，提供可视化界面选择和管理 IDE 连接，更便捷地控制多 IDE 协作场景 🔧 改进优化 终端模拟优化：改进 Bun 运行时下的终端模拟模块，提升兼容性 Windows 中文显示增强：改进命令输出的字符编码处理，增强 Windows 平台中文显示兼容性 第三方服务兼容性增强：改进运行时 polyfill 机制，提升与第三方服务的兼容性 错误处理增强：改进日志刷新机制的安全性，避免服务未初始化时的错误 IDE 检测增强：改进终端环境识别逻辑，提升 IDE 集成稳定性 环境变量处理优化：改进 环境变量的布尔值解析逻辑，提升配置准确性 🐛 问题修复 命令执行优化：规范化系统命令执行参数，防止意外输出干扰正常流程 IDE 上下文清理：修复 IDE 断开连接后选择内容残留问题，确保会话上下文正确重置 并发工具状态修复：修复多工具并发执行时状态流转异常的问题 消息去重优化：修复消息组重复添加导致的界面显示异常"},{"id":"/cli/release-notes/v2.13.0","title":"🚀 CodeBuddy Code v2.13.0 发布","body":"🚀 CodeBuddy Code v2.13.0 发布 ✨ 新功能 Token 分析命令：新增 命令，可查看当前会话中各模块的 token 使用分布，帮助了解上下文消耗情况 IDE 自动连接：CLI 启动时自动检测本地 IDE 并建立通信连接，状态栏实时显示连接状态 Ripgrep 配置选项：新增 环境变量，可选择使用系统安装的 ripgrep 或内置版本 🔧 改进优化 加载界面优化：改进工具调用结果和加载提示的显示样式，提升视觉体验 模型输出配置：支持通过环境变量动态调整模型输出限制 Skill 加载加速：优化技能扫描机制，提升启动速度 Shell 兼容性增强：改进默认 shell 配置，提升跨平台稳定性 🐛 问题修复 命令执行反馈：修复自定义命令执行时缺少运行状态提示的问题 IDE 文件提示：改进文件打开提示逻辑，未选中内容时也会正确提示 编码检测优化：改进系统编码检测机制，避免错误输出干扰"},{"id":"/cli/release-notes/v2.12.0","title":"🚀 CodeBuddy Code v2.12.0 发布","body":"🚀 CodeBuddy Code v2.12.0 发布 ✨ 新功能 独立主题选择面板：新增 命令，提供交互式主题选择面板，支持 dark、light、colorblind friendly、ANSI 等多种主题变体 主题实时预览：在主题面板中实时预览不同主题的效果，轻松找到适合您的配色方案 用户反馈调查：新增用户体验反馈调查功能，帮助我们更好地了解您的使用体验 输出样式管理：支持自定义 AI 响应的输出格式，满足个性化需求 🔧 改进优化 主题系统重构：独立的主题管理面板提供更专业的配置体验 终端兼容性增强：提升旧版 iTerm 终端的识别和支持能力 文件搜索增强：支持搜索隐藏文件和目录，不再错过重要配置文件 构建优化：改进应用启动速度，响应更加迅速 反馈调查优化：提升反馈组件的响应性能和用户体验 🐛 问题修复 错误重试优化：改进上下文过长错误的识别机制，减少不必要的重试，提升会话稳定性 Skill 配置解析：修复 skill 配置文件中多行文本解析失败的问题"},{"id":"/cli/release-notes/v2.11.0","title":"🚀 CodeBuddy Code v2.11.0 发布","body":"🚀 CodeBuddy Code v2.11.0 发布 ✨ 新功能 Sub agent 模型选择：支持在调用子任务时动态选择模型，可根据任务复杂度灵活调整，优化成本和性能 Sub agent 会话恢复：支持在已有上下文基础上恢复之前的子任务会话，适用于分阶段分析和迭代优化场景 🔧 改进优化 项目级对话记忆增强：支持级联加载上级目录的 CODEBUDDY.md 文件，自动继承项目上下文 交互式命令支持增强：改进终端命令的交互式处理能力，提升命令执行的稳定性和用户体验 终端显示效果优化：增强终端输出的颜色和格式保留，提升视觉体验 退出体验优化：改进 ESC 双击退出逻辑，增加超时时间并添加视觉反馈提示 对话记忆优化：改进对话历史加载机制，提升上下文管理效率 插件加载稳定性提升：单个命令加载失败不再影响其他命令的正常使用 输入体验优化：改进对特殊字符和表情符号的支持，提升编辑流畅度 🐛 问题修复 图片粘贴修复：修复图片粘贴时格式识别问题，确保图片正确上传 响应稳定性提升：修复模型输出超长时可能出现的循环重试问题 配置合并修复：修复配置项合并时的去重问题，避免重复配置条目 编辑器交互修复：解决外部编辑器返回内容处理异常的问题 插件路径修复：修复本地目录类型插件的安装路径识别问题"},{"id":"/cli/release-notes/v2.10.1","title":"🚀 CodeBuddy Code v2.10.1 发布","body":"🚀 CodeBuddy Code v2.10.1 发布 🐛 问题修复 键盘输入优化：改进终端键盘输入处理逻辑，提升输入响应稳定性"},{"id":"/cli/release-notes/v2.10.0","title":"🚀 CodeBuddy Code v2.10.0 发布","body":"🚀 CodeBuddy Code v2.10.0 发布 ✨ 新功能 沙箱管理命令：新增 斜杠命令，可以快速启用或禁用 Bash 命令的沙箱保护模式 🔧 改进优化 ACP 协议模式优化：改进 ACP 模式下的模型信息展示，提供更清晰的运行状态 沙箱架构升级：优化 Bash 命令执行的沙箱机制，提升执行性能和系统稳定性 终端交互增强：改进键盘输入处理和命令解析，提升终端响应速度和输入准确性 文件引用体验提升：使用 引用文件时自动显示文件名和大小 启动性能优化：非交互模式下跳过不必要的初始化步骤，加快启动速度 配置查询优化：自动合并多层级配置并返回最终结果，使用更便捷 界面性能提升：精简登录界面组件，优化渲染性能 权限控制增强：改进 Skill 工具的权限匹配逻辑 🐛 问题修复 ACP 协议权限请求：修复子任务执行工具时权限请求无法正常触发的问题 调试日志完善：确保调试日志正确写入对应的会话文件 消息队列稳定性：修复消息处理时的格式问题，提升显示稳定性 错误处理增强：改进工具参数为空时的容错能力"},{"id":"/cli/release-notes/v2.9.0","title":"🚀 CodeBuddy Code v2.9.0 发布","body":"🚀 CodeBuddy Code v2.9.0 发布 ✨ 新功能 认证成功通知：新增用户登录成功后的 Hook 通知事件，支持在认证完成时触发自定义脚本，实现登录后的自动化工作流"},{"id":"/cli/release-notes/v2.8.6","title":"🚀 CodeBuddy Code v2.8.6 发布","body":"🚀 CodeBuddy Code v2.8.6 发布 🔧 改进优化 终端输入处理增强：改进跨平台输入解析机制，提升终端使用的稳定性和兼容性 粘贴体验优化：完善大段文本粘贴处理，自动识别粘贴模式，提升文本输入便捷性 消息处理机制优化：重构内部消息队列，提升对话响应速度和系统稳定性 界面渲染性能提升：优化应用主界面和聊天视图的渲染效率，提供更流畅的交互体验 命令执行流程简化：优化终端命令执行逻辑，提升执行效率 🐛 问题修复 协议模式配置保持：修复客户端协议模式下多轮会话中配置丢失的问题，确保会话稳定性 tmux 剪贴板粘贴：修复在 tmux 终端环境中无法粘贴剪贴板图片的问题"},{"id":"/cli/release-notes/v2.8.5","title":"🚀 CodeBuddy Code v2.8.5 发布","body":"🚀 CodeBuddy Code v2.8.5 发布 📚 文档增强 GitLab CI/CD 集成指南：新增完整的 CI/CD 集成文档，帮助您在 GitLab 流水线中轻松使用 CodeBuddy Code，包含详细的配置示例、使用场景说明和常见问题解决方案"},{"id":"/cli/release-notes/v2.8.4","title":"🚀 CodeBuddy Code v2.8.4 发布","body":"🚀 CodeBuddy Code v2.8.4 发布 🔧 改进优化 类型定义优化：改进代码组织结构，提升长期维护效率 🐛 问题修复 权限模式同步：修复子任务执行时权限设置未能正确应用的问题，确保批量操作权限控制的一致性"},{"id":"/cli/release-notes/v2.8.3","title":"🚀 CodeBuddy Code v2.8.3 发布","body":"🚀 CodeBuddy Code v2.8.3 发布 🔧 改进优化 Gemini 模型支持扩展：新增 Gemini 3.0 Pro 模型支持，为你提供更强大的推理能力和更大的上下文窗口，胜任更复杂的编程任务 文件处理智能优化：自动识别并跳过超大文件的引用处理，有效避免性能问题，提升大型项目的响应速度 代码架构稳定性增强：优化中间件依赖注入机制、服务初始化流程和会话类型定义，提升系统运行稳定性和代码维护性 会话管理体验提升：改进会话恢复面板的数据处理逻辑，提供更流畅的会话管理体验 权限控制可靠性：完善目录信任状态管理，让权限控制更精准、更可靠 🐛 问题修复 远程执行环境连接稳定性：优化认证令牌处理机制，提升连接沙箱和远程执行环境时的稳定性 Shell 命令兼容性：改进命令执行环境，支持需要终端交互的工具命令，提升各类命令的执行成功率"},{"id":"/cli/release-notes/v2.8.2","title":"🚀 CodeBuddy Code v2.8.2 发布","body":"🚀 CodeBuddy Code v2.8.2 发布 🔧 改进优化 对话上下文增强：改进对话消息处理机制，确保完整的上下文信息在多轮对话中正确保留和传递，提升 AI 响应的连贯性和准确性"},{"id":"/cli/release-notes/v2.8.1","title":"🚀 CodeBuddy Code v2.8.1 发布","body":"🚀 CodeBuddy Code v2.8.1 发布 🔧 改进优化 Plan 模式重构：采用全新的 Sub Agent 架构重构 Plan 模式，提供更智能、更稳定的任务规划和执行能力 智能模型图片检测：自动检测模型图片支持能力，在模型不支持时智能处理图片输入，提升跨模型使用的流畅度 运行环境健康检查：启动时自动检测 Node.js 版本，提前规避环境兼容性问题，确保工具稳定运行 ACP 协议体验增强：创建会话时自动推送命令列表，支持智能补全；优化认证方式，根据网络环境自动推荐最佳登录选项 权限命令风险调整：优化 sudo/su 等提权命令的风险分级策略，减少不必要的二次确认，在保障安全的前提下提升效率 🐛 问题修复 Git 操作安全增强：优化危险命令检测规则，更精准地识别和拦截强制推送、删除分支等高风险 Git 操作 Windows 路径兼容：修复 Windows 系统下的路径大小写敏感问题，提升跨平台文件操作的稳定性 非交互模式工具控制：修复用户问答工具在非交互模式下的行为逻辑，确保自动化流程顺畅执行 专享版环境适配：修复专享版环境识别异常，确保配置加载的正确性 剪贴板检测兼容性：临时调整剪贴板检测策略，解决部分环境下的误触发问题，提升使用体验"},{"id":"/cli/release-notes/v2.8.0","title":"🚀 CodeBuddy Code v2.8.0 发布","body":"🚀 CodeBuddy Code v2.8.0 发布 ✨ 新功能 编辑器原生集成：支持通过 ACP 协议与 Zed 等编辑器深度集成，带来更流畅的 AI 辅助开发体验 智能安全防护：引入五级命令风险分级系统，覆盖文件操作、Git 管理、容器控制等 9 大类场景，高风险操作自动拦截确认，让 AI 自动化更安心 🔧 改进优化 危险操作智能识别：优化风险评估策略，自动识别可能丢失数据的 Git 操作并提升风险等级，主分支保护更严格 安全模式增强：改进权限绕过模式的安全检查，交互场景下极高风险操作仍需确认，兼顾自动化与安全 视觉提示升级：高风险命令确认界面使用警告色高亮，一眼识别潜在危险操作 文档解析效率提升：优化 Markdown 文件处理性能，加载速度更快 🐛 问题修复 安全审批机制加固：修复高风险命令可能跳过确认的漏洞，确保所有危险操作都经过用户授权 提示模板优化：消除系统提示中的重复内容，提升 AI 响应的准确性"},{"id":"/cli/release-notes/v2.7.0","title":"🚀 CodeBuddy Code v2.7.0 发布","body":"🚀 CodeBuddy Code v2.7.0 发布 ✨ 新功能 Token 计数器显示控制：新增显示开关设置，可以根据个人偏好选择显示或隐藏 Token 使用统计信息 🔧 改进优化 会话标识符规则优化：放宽会话 ID 的格式限制，支持更灵活的自定义会话标识 统计准确性提升：改进工具执行状态的统计逻辑，确保使用数据的准确性 🐛 问题修复 消息处理可靠性增强：增强消息类型校验机制，避免非法数据导致的处理异常 错误反馈机制优化：改进异常信息的传递流程，提供更清晰的错误提示 主题适配体验优化：优化颜色显示算法，自动适配暗色和亮色主题，提升视觉舒适度"},{"id":"/cli/release-notes/v2.6.1","title":"🚀 CodeBuddy Code v2.6.1 发布","body":"🚀 CodeBuddy Code v2.6.1 发布 🔧 改进优化 错误处理增强：改进服务端请求错误处理机制，提升错误信息的准确性和可读性，让问题排查更加高效 🐛 问题修复 图片粘贴功能优化：优化剪贴板图片读取机制，改进多文件粘贴支持，提升图片粘贴的稳定性和可靠性 插件市场去重：修复插件市场加载时可能出现重复条目的问题，现在会自动过滤名称和来源相同的市场，提升界面整洁度"},{"id":"/cli/release-notes/v2.6.0","title":"🚀 CodeBuddy Code v2.6.0 发布","body":"🚀 CodeBuddy Code v2.6.0 发布 ✨ 新功能 GPT 5.1 系列模型：新增 GPT 5.1、GPT 5.1 codex、GPT 5.1 codex mini 三个模型选项，提供更大的上下文窗口（支持 272K tokens 输入）和更强的推理能力，适合处理复杂的代码分析和长文档任务"},{"id":"/cli/release-notes/v2.5.0","title":"🚀 CodeBuddy Code v2.5.0 发布","body":"🚀 CodeBuddy Code v2.5.0 发布 ✨ 新功能 会话分支管理：支持在恢复会话时创建新的分支，帮助你更好地组织和管理不同的对话主题 消息回放确认：在非交互模式下自动回显你的输入内容，确保命令执行前能够二次确认 自定义代理配置：允许你通过配置文件定义专属的 AI 助手行为和能力 系统提示词个性化：支持自定义或扩展系统提示词，让 AI 助手更符合你的工作习惯 设置加载控制：灵活指定从哪些来源加载配置（用户级/项目级/临时设置），满足不同场景需求 外部配置导入：支持从文件或 JSON 字符串加载额外设置，便于配置共享和复用 🔧 改进优化 命令执行更灵活：可通过环境变量自定义 Bash 命令的超时时间和输出长度，适应不同任务需求 详细日志模式：新增详细输出开关，帮助你深入了解 AI 助手的执行过程 流式消息增强：在流式输出模式下支持查看完整的增量消息，提供更透明的执行反馈 成本统计美化：改进使用成本统计的展示格式，信息对齐更清晰易读 配置加载优化：添加产品配置缓存机制，提升启动速度和运行性能 🐛 问题修复 MCP 服务器交互优化：解决非交互模式下 MCP 服务器审批导致的阻塞问题，现可预先配置免审批服务器 终端兼容性改善：修复部分终端环境下的粘贴模式异常和 ESC 键延迟问题，输入体验更流畅 更新服务稳定性：优化自动更新检查机制，避免重复安装，确保更新过程可靠稳定"},{"id":"/cli/release-notes/v2.4.0","title":"🚀 CodeBuddy Code v2.4.0 发布","body":"🚀 CodeBuddy Code v2.4.0 发布 ✨ 新功能 任务执行轮次控制：新增 命令行参数，让您可以精确控制 AI 助手的执行轮次，避免无限循环，提升任务执行的可控性 🔧 改进优化 执行能力提升：默认最大执行轮次从 100 提升至 500，为复杂任务提供更充足的处理空间，减少因轮次限制导致的任务中断 外部编辑器集成：新增 Ctrl+G 快捷键支持，可快速调用 VSCode、Sublime Text 等外部编辑器编辑长文本，提升输入体验 日志保存优化：改进日志落盘机制，确保进程退出时所有日志信息完整保存，方便问题排查 会话管理优化：改进历史会话列表展示，自动过滤内部子代理会话，让会话列表更清晰 🐛 问题修复 Native 版本命令兼容性：修复 命令在 Native 环境中无法正常运行的问题 遥测数据准确性：修复工具调用遥测数据中标识信息缺失问题，确保数据完整上报 自动更新稳定性：增强多进程场景下的自动更新锁机制，避免更新冲突 子代理中断问题：修复使用子代理时无法响应中断指令的问题，提升交互体验"},{"id":"/cli/release-notes/v2.3.1","title":"🚀 CodeBuddy Code v2.3.1 发布","body":"🚀 CodeBuddy Code v2.3.1 发布 🔧 改进优化 文件编辑稳定性：优化字符串替换逻辑，提升处理特殊字符时的准确性和可靠性 插件市场体验：改进插件源识别能力，提供更友好的错误提示，降低配置门槛 Skills 调试体验：优化技能加载日志输出，更清晰地展示技能来源，便于问题排查 工具系统灵活性：支持根据运行环境动态控制工具可用性，提升系统适应性 命令输入效率：改进斜杠命令自动补全，精确匹配优先显示，加快命令输入 界面渲染性能：优化列表组件 key 属性策略，提升终端界面的稳定性和流畅度 图片粘贴兼容性：增强 cmd+v 粘贴图片功能，改进 Windows 系统兼容性 配置界面专业性：优化 Hooks 配置面板的提示文案，提升产品质感 🐛 问题修复 Hooks 文档完善：更新 Hooks 使用指南，改进文档结构和示例，让配置更简单"}]