Releases: op7418/CodePilot
Releases · op7418/CodePilot
CodePilot v0.55.1
CodePilot v0.55.1
⚠️ 本系列是一次大规模重构更新，底层改动面很大。 v0.55.1 在 v0.55.0 基础上修复了"内测版收不到正式版更新提示"等问题；如果你仍在意稳定性、不想冒险踩坑，可以继续观察后续修订版本。在重构正式版 v0.55.0（多执行引擎 / 上下文用量可视化 / Codex 账号原生能力）基础上的修订版，主要修复了 0.55.0-preview 内测用户收不到正式版更新提示的问题。
修复问题
- 内测版收不到正式版更新提示 — 之前装了 0.55.0-preview 内测版的用户，应用检查更新时会把正式版误判成"和当前版本一样"，导致不弹更新提示。现在内测版能正确识别出正式版更新（修复并入 0.55.1 后，之后版本的更新检测也一并修正）。
重构正式版主要内容（自上一个正式版 0.54.0 起，首次升级的用户可一并了解）
- 多执行引擎，可整体切换也可按会话切换 — 同一个应用里支持 Anthropic Claude Code、CodePilot 自建 Native、OpenAI Codex 三种执行引擎；可设全局默认，也能在单个对话里临时切换。
- 上下文用量可视化 — 聊天里实时看到本次对话占用了多少上下文、还剩多少，并按来源（系统提示 / 工作区规则 / 技能 / 记忆 / 工具 / MCP）分解。
- OpenAI Codex 账号原生能力打通 — 用 Codex 账号登录后，助理记忆、Widget 可视化、定时任务 + 到点通知、Dashboard、CLI 工具在 Codex 引擎下也能用；接不了的能力会如实标注为不支持。
- 集中修复内测反馈问题 — macOS 菜单栏图标看不清、Windows 生成命令是 bash 语法 / 安装无法选目录 / 服务商编辑窗口关闭按钮贴脸 / Codex 无法启动、OpenRouter + Opus 会话被静默换成 Sonnet、小米 MiMo 型号被改回默认、飞书桥接后台刷错误日志等。
已知问题
以下问题已记录、不影响主流程，正在跟进（欢迎到 GitHub Issues 反馈复现细节）：
- Windows 上服务商编辑窗口右上角关闭按钮在个别情况下点击无反应（仍在 Windows 真机验证中）。
- 个别用户反馈流式回复期间继续追加消息进队列的行为异常（核查中）。
- MCP 在设置页能看到，但运行时模型调不到，需要把 MCP 配置到项目路径才识别（排查中）。
反馈入口：欢迎在 GitHub Issues 提交问题与复现步骤。
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商（Anthropic / OpenRouter 等）
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot v0.55.0
CodePilot v0.55.0
⚠️ 本版是一次大规模重构更新，底层改动面很大，可能存在尚未发现的问题。如果你更在意稳定性、不想冒险踩坑，建议先不升级、等后续修订版本再更新。重构完成的正式版：多执行引擎（Claude Code / 自建 Native / OpenAI Codex）、上下文用量可视化、Codex 账号原生能力全部落地为稳定版，并集中修复了 macOS 视觉与托盘、Windows 安装与交互、服务商型号映射等内测反馈问题。
新增功能
- 多执行引擎，可整体切换也可按会话切换 — 同一个应用里支持 Anthropic Claude Code、CodePilot 自建 Native、OpenAI Codex 三种执行引擎；可以设全局默认，也能在单个对话的输入框下方临时切换，互不影响。
- 上下文用量可视化 — 聊天里能实时看到本次对话占用了多少上下文、还剩多少，并按来源（系统提示 / 工作区规则 / 技能 / 记忆 / 工具 / MCP）分解，长对话不再"用着用着突然被截断也不知道为什么"。
- OpenAI Codex 账号原生能力打通 — 用 Codex 账号登录后，助理记忆、Widget 可视化、定时任务 + 到点通知、Dashboard、CLI 工具这些内置能力在 Codex 引擎下也能用；接不了的能力会如实标注为不支持，而不是假装可用。
修复问题
- OpenRouter + Opus 会话被静默换成 Sonnet — 之前用 OpenRouter（Claude Code 引擎）选了 Opus 的老会话，重新打开后顶部会显示成 Sonnet，继续发送也真的用了 Sonnet。现在会正确认出你当初选的模型，显示和发送都回到 Opus。
- 小米 MiMo 型号被改回默认 — 修复 MiMo 自定义型号在某些情况下被改回默认型号的问题；现在你设过的型号会保留，默认型号也对齐到 MiMo-V2.5-Pro。
- 中断任务后输入框发不出消息 — 之前中断一个正在运行的任务后，再在输入框输入内容点发送会没反应。现在中断后可以正常继续发送。
- 完全访问权限每条消息都要二次确认 — 开启完全访问权限后，之前每次发送都要再点一次"已了解，继续发送"。现在只在开启该权限时确认一次，之后连续发送不再被打断。
- macOS 菜单栏图标看不清 — 菜单栏（顶部状态栏）的 CodePilot 图标改用专门的单色模板图标，浅色 / 深色模式下都清晰。
- Windows 生成的命令是 bash 语法 — 在 Windows 上，模型生成的脚本命令默认按 PowerShell 输出，不再默认给只能在 macOS/Linux 跑的 bash 命令。
- Windows 安装无法选择目录 — Windows 安装包恢复可以选择安装位置。
- Windows 服务商编辑窗口关闭按钮贴着系统按钮 — 编辑服务商的全屏窗口里，应用内的关闭按钮让出系统窗口控制区，不再和系统的"×"贴脸误点。
- Windows 上 Codex 无法启动 — 修复 Windows 下 Codex 启动报
spawn EINVAL、无法登录 / 无法使用的问题。 - 飞书桥接后台刷错误日志 — 修复开启飞书桥接后后台每分钟重复刷错误、污染日志的问题。
优化改进
- Codex 启动更稳更快 — 同时装了多个版本的 Codex 时会自动选最新的可用版本；遇到坏的 / 旧的二进制会快速失败并给出明确原因，不再卡住几十秒。
- 设置页打开更干净 — 打开设置概览时不再对不存在的虚拟 Codex 账号发无效的模型请求，消除后台报错噪音。
- macOS 平台质感 — 窗口、顶部栏、侧栏、输入区等按 macOS 原生材质与悬停效果做了平台化处理，页面内容本身不分叉。
已知问题
以下问题已记录、不影响主流程，正在跟进（欢迎到 GitHub Issues 反馈复现细节）：
- Windows 上服务商编辑窗口右上角关闭按钮在个别情况下点击无反应（仍在 Windows 真机验证中）。
- 个别用户反馈流式回复期间继续追加消息进队列的行为异常（核查中）。
- MCP 在设置页能看到，但运行时模型调不到，需要把 MCP 配置到项目路径才识别（排查中）。
反馈入口：欢迎在 GitHub Issues 提交问题与复现步骤。
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商（Anthropic / OpenRouter 等）
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot 0.55.0-preview.5 internal preview
CodePilot 0.55.0-preview.5 internal preview
This is a tester-only prerelease from the refactor branch.
- Not a stable
v*release. - Marked as GitHub prerelease and
--latest=false. - The app update check uses GitHub
/releases/latest, so this entry is intentionally excluded from upgrade notifications.
Test focus
- Existing data compatibility after installing over 0.54.x or older preview packages.
- Codex runtime startup and model loading.
- Claude Code runtime model loading and first message.
- macOS tray icon visibility in light/dark mode.
- Windows command generation uses PowerShell by default.
Report P0/P1 issues with
- OS version and CPU architecture.
- CodePilot version shown in About.
- Runtime selected and model/provider.
- Repro steps, screenshot, and logs when available.
CodePilot v0.54.0
CodePilot v0.54.0
本版本补齐服务商生态：新增 DeepSeek 独立预设，OpenAI OAuth 加入 GPT-5.5，小米 MiMo 两个套餐升级到 V2.5-Pro，同时修掉切换服务商时的环境变量残留问题。
新增功能
- DeepSeek 服务商 — 在服务商列表里新增 DeepSeek 独立预设，走官方 Anthropic 兼容端点
api.deepseek.com/anthropic，只需填 Key 即用。默认主模型 DeepSeek V4 Pro，Haiku 档位映射到更便宜的 DeepSeek V4 Flash，压缩/总结这类辅助调用能自动走便宜档 - OpenAI OAuth 支持 GPT-5.5 — ChatGPT Plus/Pro 授权登录后，模型下拉里新增 GPT-5.5（排在 GPT-5.4 之上），新会话未指定模型时默认用 GPT-5.5
修复问题
- 切换服务商时环境变量残留 — 之前如果用户在系统环境里设过 DeepSeek 文档里的
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK/CLAUDE_CODE_EFFORT_LEVEL，切到其它服务商后这两个变量仍会带到子进程里，影响其它服务商的请求行为。现在切换服务商时会连同这两个 key 一起清掉，避免跨服务商污染
优化改进
- 小米 MiMo 升级到 V2.5-Pro — 按量付费和 Token Plan 两个预设里的默认模型从
mimo-v2-pro全部切到mimo-v2.5-pro，界面上显示名也同步更新为 MiMo-V2.5-Pro
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商（Anthropic / OpenRouter 等）
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot v0.53.0
CodePilot v0.53.0
设计 Agent 新增 OpenAI GPT Image 2 图像生成能力，同时给 Nano Banana 和 GPT Image 都加上"第三方兼容 API"选项——有中转代理的用户不用再改代码。配套补齐模型选择、实时模型标识、2K/4K 尺寸支持、第三方连接测试等一圈可见性改进。
新增功能
- OpenAI GPT Image 2 图像生成 — 设计 Agent 的服务商列表里新增 OpenAI (Image) 一档，支持 GPT Image 2 / 1.5 / 1 / 1-mini 四个模型。GPT Image 2 尺寸按官方规格算真实的像素比：1:1/16:9/9:16/3:2/2:3/4:3/3:4/4:5/5:4/21:9 十个比例 × 1K/2K/4K 三档分辨率，每一档都会尊重你选的比例而不是套用老三档（1024×1024 / 1536×1024 / 1024×1536）。支持参考图（垫图）走
/v1/images/edits端点，连续编辑不再被丢弃 - 媒体服务商第三方兼容 — Nano Banana 和 GPT Image 都多了"Third-party"预设，只需要填 Base URL 和 Key，其他配置完全照搬官方。现在可以把图像生成走自己架设的 OpenAI 兼容 / Gemini 兼容代理
- 当前图像模型实时显示 — 聊天里的"图片生成"卡片右上角会显示当前要用的模型和服务商（比如"GPT Image 2 · OpenAI (Image)"）。当默认服务商缺 Key 或被改过类型时会显示琥珀色提示，点一下跳到设置页
- "图片生成默认"服务商标记 — 同时配了多个图像服务商的用户，现在可以在设置里一键把某一行设为"用于图片生成"。点某个服务商下的模型胶囊按钮会自动把那一行标为默认
优化改进
- 设计 Agent 选型更确定 — 原先同时配置多个图像服务商时由数据库行顺序决定用哪个，行为不可控。现在走"显式 providerId → 模型名家族前缀 → 用户设定的默认 → 优先 Gemini 兼容"四步优先级，每一步都可预测
- 第三方媒体服务商连接测试正确路由 — 之前 OpenAI/Gemini 图像服务商的"测试连接"按钮跑的是 Anthropic
/v1/messages探针，对这两个服务永远失败。现在 OpenAI Image 走GET /v1/models+ Bearer，Gemini Image 走GET /v1beta/models?key=...，第三方配置也能真实验证 - 服务商 Base URL 精确匹配加上协议隔离 — 加入 GPT Image 后
https://api.openai.com/v1同时属于多个预设。之前聊天用的 openai-compatible 服务商在这个 URL 下会错误继承 GPT Image 模型目录，现在精确匹配会检查协议一致性 - 第三方媒体服务商强制要求 Base URL — 创建和编辑时如果 OpenAI/Gemini Image 的 Base URL 为空会被拦下并提示。之前留空会静默回落到官方端点，让"第三方配置"形同虚设
- 失效默认图像服务商有清理入口 — 默认图像服务商的行被删除、类型被改成非媒体类型、或 Key 被清空时，服务商设置页会显示一条琥珀色提示 + 清除按钮。后端也会在删除/改类型时自动清理设置，两边兜底
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商（Anthropic / OpenRouter 等）
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot v0.52.1
CodePilot v0.52.1
修复 v0.52.0 升级后"欢迎页关了还弹"的死循环 + 补齐 Artifact 卡片和预览面板的中文本地化。有用户反馈过卡在欢迎页的强烈建议升级。
修复问题
- 升级后"欢迎页关了还弹"死循环 — v0.52.0 升级后有用户反馈每次新建对话、延续老对话都会跳回欢迎页。尤其是没有手动加过服务商、直接用 Claude Code 的用户，点"添加服务商"没反应、点"跳过"也关不掉。根因是首次引导的"已完成"标记在三张卡都已完成 / 跳过的情况下没被补上，以及从欢迎页点"添加服务商"跳转到设置页时的哈希被全局中间件吞掉。本版从后端和前端两层都做了归一化：老用户升级后第一次打开就会自愈，以后点"跳过并进入"或"添加服务商"不再复发
- 点"添加服务商"真的跳到服务商设置页 — 之前点这个按钮会跳到
/settings#providers，但被欢迎页的全局哈希拦截器重新吞回去，视觉上像"点了没反应"。现在能直接落到服务商管理页，SettingsLayout 自己处理#providers哈希路由 - 服务商卡片跳过后显示矛盾 — 卡片右上角已经是灰色 Skipped 状态 chip，但卡片内容里还渲染着一个蓝色的"添加服务商"主按钮，两种状态对不上。跳过后的卡片现在显示"已跳过，可在 设置 › 服务商 里随时添加"+ 一个小链接，整体视觉一致
- Artifact 卡片 + 预览面板按钮漏做中文翻译 — v0.52.0 新加的聊天里 AI 修改文件时的 Artifact 卡片（"预览" / "导出截图"两个按钮）、预览面板头部的 Tab 栏（"编辑" / "源码" / "预览"）以及头部工具按钮（"保存" / "复制内容" / "导出长图" / "关闭预览"）在中文界面里全部还是英文。本版 12 个 key 补齐中文翻译
优化改进
- 欢迎页持久化用 await + keepalive 加固 — 之前点"添加服务商"后先 fire-and-forget 写入"已完成"标记再跳转，有小概率请求在页面卸载时被中止，下次启动还弹。现在跳转前明确 await 这次写入，并加
keepalive: true双保险 - 欢迎页手动打开时不再被自动关闭 — 当三张卡都已完成 / 跳过时手动从其他入口（比如跳过过的服务商卡片里的"打开服务商设置"）打开欢迎页，之前会 800ms 后自动消失（因为统一触发了 auto-close）。现在只有本次会话里从 "还没完成" 推进到 3/3 才会自动关，手动打开的会保留
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商（Anthropic / OpenRouter 等）
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot v0.52.0
CodePilot v0.52.0
Artifact 预览面板升级：AI 生成的 React 组件和表格现在可以在侧栏直接看、Markdown 可以直接改，HTML 一键导出长图。长文档预览从 1000 行放宽到 50000 行。
新增功能
- Artifact 支持 React 组件预览（.jsx / .tsx） — AI 在聊天里生成或修改
.jsx/.tsx时，聊天里会出现 Artifact 卡片；点击 "Open preview" 在侧栏看到实时渲染结果。支持 React hooks、Tailwind utility 和react/react-dom/lucide-react等白名单依赖。第一版聚焦"单文件 React 组件"，多文件项目 /@/路径别名 / CSS import 这类复杂场景会明确提示"当前不支持"，不会无声失败 - Artifact 支持 CSV / TSV 表格预览 — AI 生成或写入的
.csv/.tsv文件在聊天里会有卡片，文件树里点击也默认进入表格视图。支持点列头排序、一键导出 CSV / JSON - Markdown 文件直接在预览面板里编辑 — 之前只能看不能改；现在
.md/.mdx/.txt打开后可以在 "Edit" 视图直接用 CodeMirror 6 编辑，1 秒停笔后自动保存到磁盘，不用切到 Obsidian。Tab 缩进、⌘S 主动保存、深色主题跟随系统都已支持 - HTML Artifact 一键导出长图 — 预览 HTML 时标题栏有"导出长图"按钮，一次把整页渲染成 PNG（超过视口高度也能完整抓到），直接下载到本地。同一张卡片在聊天里也能导出
- 文件树新建文件 / 文件夹 — 文件树任务分割线下方有 VS Code 风格的 "New Markdown" / "New Folder" 按钮；点击某个文件夹会高亮选中，之后新建的文件会落到这个文件夹里
- 聊天里 AI 修改过的文件变成 Artifact 卡片 — 以前 AI 修改多个文件时只是一行小字 "Modified 3 files"，现在每个可预览的文件（Markdown / HTML / JSX / TSX / CSV / TSV）都是一张独立卡片，带 Created / Modified 状态 chip + "Open preview" 按钮，非预览类文件收进底部一行 "Also modified: ..." 不占空间
- 文件写入 / 删除 / 改名 / 新建文件夹四套 API —
.md编辑靠它保存；删除走系统回收站（不是真删），误操作可以在访达/资源管理器的回收站恢复；路径安全检查统一走 symlink 拒绝 + 真实路径比对，不允许跨工作区写入
修复问题
- 快速切换多个
.tsx文件时预览错乱 — 之前点 A.tsx 看到 A，切到 B.tsx 还是 A；根源是 Sandpack 运行入口没有按文件重建。现在每个文件有独立 provider 实例 + 内容哈希，切换即时生效 - 文件预览首帧闪旧内容 — 点击新文件时面板会短暂显示上一个文件的内容再切到新的。现在内容会在新路径加载前被清空，不会再闪
- Markdown 自动保存偶尔把 A 文件的内容写到 B 路径 — 快速切文件时的罕见 race condition，现在保存前先确认"当前预览的文件"和"编辑器里的文件"一致才写入
- 预览文件请求能跟随符号链接到工作区外 — 即使工作区本身是 symlink 也能兼容，但如果目标文件自身是 symlink 则拒绝访问，防止信息泄露
优化改进
- Markdown 预览上限从 1000 行 / ~30KB 放宽到 50000 行 / 10MB — 真实长文档（论文、长篇博客、大段 changelog）可以完整打开。超过上限时会在顶部显示截断提示，明确告诉你看到的是前 N 行
- 预览列表加截断提示横幅 — 文件太大被截断时有一行黄色提示说明原因（按行数 / 按字节），而不是静默显示不完整的内容
- 二进制文件预览时给占位说明 — 打开 PNG / 字体 / 可执行文件不会再看到一串乱码，会显示"该文件是二进制格式，无法作为文本预览"
- 代码高亮缓存从聊天到预览共享 — 之前聊天和预览各用一套无上限的 Shiki 高亮器缓存，长会话后占内存。现在合并到同一个 10 个 highlighter + 200 个 token 结果的 LRU 上
- Preview 面板现在支持聊天里提取的内联内容 — 为后续"AI 直接在聊天里出内联表格 / HTML 片段"铺垫好了数据模型（PreviewSource 联合类型）
- 聊天 AI 生成的文件路径自动解析 — 有些工具返回的是相对路径，以前点击卡片会 404；现在会和当前工作目录拼接后再打开
- 新建文件 / 编辑器 / 表格 / Sandpack 都是按需加载 — 不打开预览的场景不会多吃首屏 bundle
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商（Anthropic / OpenRouter 等）
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot v0.51.1
CodePilot v0.51.1
修复长会话在上下文压缩之后 Claude Code 引擎下的严重行为异常：工具调用被模型以纯文本形式写入聊天、反复触发自动压缩、压缩状态不更新等问题。强烈建议所有使用 Claude Code 引擎且会话偏长的用户升级。
修复问题
- 压缩后模型不再调用工具，而是把工具调用写成文本 — 这是最严重的一个问题。到会话中段（通常是第一次自动压缩或手动
/compact之后），模型会开始输出类似(used Read: {"file_path":"..."})这样的纯文本，工具实际上没有执行，聊天气泡里只是在"叙述"它本该做的事情。本版从压缩时的历史重写机制入手彻底修复 - 手动
/compact之后反复被自动压缩 — 之前压缩只是把摘要写入数据库，但 Claude Code SDK 会继续用它自己的完整历史做 resume，摘要实际上没有被模型看到，下一轮又会命中上下文上限再次触发压缩。现在压缩成功后会强制切换到"摘要 + 最近消息 + 当前提问"的新会话，SDK 会从干净的状态继续 /compact的"上下文已压缩..."系统提示被错误写入对话历史 — 这条本意是给用户看的消息被保存成了 assistant 消息，之后模型每轮都会看到它，多次压缩后甚至会被下一次压缩连同正文一起总结进新摘要。现在这条提示只在当轮通过 SSE 推给前端，不再进数据库- 对话很短时使用
/compact的"新消息不多"提示同样被错误持久化 — 同上处理，只推前端不入库 - 压缩成功后前端"已压缩"指示器偶尔不翻转 — 之前反应式压缩（上下文超长时后台自动触发的压缩重试）走的状态事件格式与前端期待的不一致，导致
hasSummary不更新。三条压缩路径的事件格式现在收敛到同一个 helper，前端一致识别 - 反应式压缩成功后新 SDK 会话未持久化 — 超长上下文触发的自动压缩重试如果成功，下一轮应该走新的 SDK 会话继续；之前没有把新 session id 写回数据库，下一轮又会走 fallback 全量历史，等于压缩白做。现在反应式压缩也会持久化新 session id
- 二次手动
/compact重复总结已压缩内容 — 第二次/compact之前会把已经被上次压缩覆盖过的全部历史再喂给摘要器一次，不仅浪费 token，还可能让新摘要里重复或偏移原内容。现在只会压缩"上次 boundary 之后的新消息"
优化改进
- 压缩覆盖边界改用 SQLite rowid，不再用秒级时间戳。之前在消息写入速度足够快时（比如自动压缩和当前用户消息同秒落库），基于时间戳的边界判断可能把一条未被摘要的用户消息当成"已覆盖"误丢；rowid 是单调递增的，彻底消除了这类歧义
- 长会话再次压缩时覆盖边界只会前进、不会回退。任何"降级路径"（比如拿不到消息元数据时）都会保留原有边界而非重置为 0，避免之前刚建立的边界被意外清除
- 新增技术交接文档
docs/handover/compact-coverage-boundary.md，记录压缩覆盖边界的所有不变量、数据库 schema、三条压缩路径的写法，供后续维护
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商（Anthropic / OpenRouter 等）
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot v0.51.0
CodePilot v0.51.0
支持 Claude Opus 4.7（1M 上下文 + xhigh 推理），升级 Agent SDK 至 0.2.111 并落地新能力；输入框加入结构化 @ 文件/文件夹引用和拖拽识别；新增全局搜索（会话 / 消息 / 文件三类）。
新增功能
- Claude Opus 4.7 作为默认 Opus 模型 — 首方 Anthropic 下默认 1M 上下文，新增 xhigh 推理档位。启用 extended thinking 时会自动切到 adaptive+summarized，让思考过程在 UI 上可见
- @ 文件 / 文件夹 结构化引用 — 输入框敲
@唤起选择器（视觉上与/命令、CLI 工具、模型选择器统一），可选择文件或文件夹；选中后以 chip 展示，发送时作为结构化元数据一起送出，LLM 能直接读取被引用的目录内容摘要 - 文件夹拖拽识别 — 从 Finder 拖文件夹到输入框，现在会被正确识别为
@directorymention 并插入 chip；之前会变成一个 0 字节的空附件 - 全局搜索对话框 — 侧栏搜索按钮唤起，默认同时搜会话 / 消息 / 文件；支持
session:/message:/file:前缀缩小范围；点击消息结果直达对应会话位置，点击文件结果直达文件 - 对话结束原因 Chip — 当一轮对话因 prompt_too_long / blocking_limit / max_turns 等特殊原因结束时，末尾显示状态 chip，并附可操作按钮（压缩后重试、启用 1M 上下文、切换到 Sonnet、打开 hook 设置等 8 个动作，按终止原因匹配）
- 订阅配额 Banner — 使用 claude.ai 订阅时遇到配额预警或拒绝，聊天页顶部显示倒计时 banner，按会话可关闭
- 上下文指示器精确化 — 指示器现在用 SDK 返回的真实 usage 字段（input_tokens + cache_read + cache_creation），不再走 char-based 估算；tooltip 上新增数据来源标记
修复问题
- 新聊天首轮的思考片段、结束原因 chip、订阅 banner 在页面从
/chat跳到/chat/[id]后正确保留显示，之前首轮这些状态会被吃掉 - 使用
/compact或压缩失败后不小心在关闭窗口外重试的问题 — 现在 compress_and_retry 窗口会被后续的 /compact 或 compress_only 动作明确关闭 - 空 base_url 的遗留 Anthropic 第三方 provider（GLM、Kimi、MiniMax 等）不会再因为协议校验错误被误判；第三方 Anthropic 代理选择推理强度时会弹出提示说明该参数在该运行时会被忽略
- Bedrock / Vertex provider 的 base_url 缺省不会再被 provider-doctor 报错
- @ 选择器的文件夹和文件图标统一为中性配色（之前是主题蓝，与其他 popover 不一致）；Files 头换成和技能选择器一致的分组标签
- 新聊天中当工作目录在
/tmp、外部盘或挂载盘时，@ 选择器不会再被错误拒绝（之前只认 $HOME 下的路径）
优化改进
- 全局搜索性能 — 在历史会话较多（30+）的本地库上，默认 all-mode 每次键入不再扫描所有会话的工作目录，改为按 resolved 路径去重后只扫最近 5 个唯一 workspace；
file:/files:前缀放宽到 15 个。跨 10+ 项目找文件时需要显式用file:前缀才能覆盖更广 - Claude Agent SDK 升级 至 0.2.111（从 0.2.62 跨越 49 个版本），带来 TerminalReason、RateLimitEvent、精确 context usage 等新能力；AI SDK Anthropic 同步升级到 3.0.70
- Turbopack 构建期 NFT 警告从 16 条降到 1 条（通过 outputFileTracingExcludes + 静态 JSON import + 移除 db 层动态 require）；剩余 1 条是 instrumentation 和 /api/files/suggest 共享 chunk 的已知限制，不影响实际运行
已知限制
@文件/@文件夹暂不识别含空格的路径（如docs/Product Spec.md），picker 插入和拖拽都会在第一个空格处截断；含空格的目录/文件只能作为普通文本提到，chip 不显示、不发送结构化元数据。下个小版本单独修- E2E 自动化覆盖本版收窄到核心路径（≈44 条通过 / ≈112 条 skipped）；layout / plugins / settings / skills 等 describe 块在新 UI 下 selectors 已全面失效，已明确
test.describe.skip待重写。单元测试 1084 条、smoke 6 条全绿，核心主路径覆盖仍在，但上述区域的视觉/布局回归短期内靠手动 / CDP 抽查 - 全局搜索 all-mode 只覆盖最近 5 个唯一 workspace，跨更多项目找文件需要显式使用
file:前缀；未来计划引入文件索引替代每次递归扫盘
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商（Anthropic / OpenRouter / OpenAI 等）
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot v0.50.3
CodePilot v0.50.3
Agent 引擎选择简化 + 入口引导收敛。此版本把 0.50.2 后冒出的 FileTree 崩溃、OpenAI OAuth 用户被错误拦截、阿里云百炼缺 Qwen 3.6 Plus 等问题一次性清掉；同时落地了之前积累已久的改动：Agent 引擎去掉"自动"选项、发消息时没配置服务商直接引导去设置中心。cc-switch 纯用户升级后首次发消息会被引导去添加 CodePilot 服务商，这是本版的主要行为变化，见下方说明。
新增功能
- 阿里云百炼增加 Qwen 3.6 Plus 模型（#483）：替换原有 Qwen 3.5 Plus。已经在会话里显式选过旧模型名的用户，下次发消息时模型选择器会自动回到默认，手动重选即可
- 没配置服务商时自动打开引导：首次安装或没在 CodePilot 里添加过任何服务商的用户，发消息时不会再出一条莫名其妙的"No provider credentials"错误，而是直接弹出 SetupCenter 的服务商卡片引导添加
改进体验
- Agent 引擎选择从三项变两项：设置页的"Agent 内核"下拉只剩 Claude Code 和 AI SDK 两项，删掉了原先含义模糊的"自动"选项。原先选"自动"的用户，首次打开设置页时会按当前环境自动迁移到具体值（装了 Claude Code CLI → Claude Code，没装 → AI SDK），持久化写回，之后不再变动
- 聊天页引擎标识同步：右侧聊天页的引擎 badge 不再出现"Agent: Auto"，读到 legacy 'auto' 值会立即按同一规则折算显示具体引擎
- 错误提示统一引导到"设置 → 服务商"：Claude Code CLI 的 "Not logged in · Please run /login" 和 CodePilot 自己的"No provider credentials available"两种错误，现在统一归类为"未配置服务商"，文案一致、都带"打开设置"按钮，不再让用户看到
/login这种在 CodePilot 里走不通的引导 - OpenAI OAuth 登录 / 登出同步 SetupCenter：之前 OAuth 登录成功、设置面板的 Provider 卡片不会实时翻绿；登出后也不会回灰。现在两条路径都立即更新
修复问题
- 打开聊天页时 FileTree 崩溃（0.50.2 回归）：Next.js 16 + Turbopack 生产构建在某种编译模式下会对解构默认参数里的
new Set()报ReferenceError: defaultExpanded is not defined。将默认值提到模块顶层常量 - OpenAI OAuth 用户发消息被 412 拦截：本版新加的"入口拦截"最初漏识别 OpenAI OAuth 这个虚拟服务商，导致用 OAuth 登录的用户一律被错误引导去配服务商。现补上 OAuth 存在性判定
- Bedrock / Vertex 供应商被误判为"未配置"：新 UI 把路由 flag 存到
env_overrides_json，旧代码只读extra_env。改成和 resolver 一样的env_overrides_json || extra_env优先级 + JSON 解析 - SetupCenter 对只装了 Claude Code CLI 的用户显示"服务商已配置"：这些用户被新的入口拦截挡住，但 SetupCenter 还告诉他们"provider 已完成"，陷入无可操作的死循环。现在两边判定口径对齐
- OAuth 登出后 Provider 卡片不降级：之前只能升 completed 不能降 not-configured，登出后 SetupCenter 继续显示绿色假态
- legacy 'auto' 迁移可能把装了 CLI 的用户错写成 AI SDK：迁移逻辑之前依赖异步 hook 状态，首次加载时 hook 还是 null 会被误判为 "CLI 未装"。改为迁移分支内直接查一次
/api/claude-status，状态查询失败时不持久化，保留旧值待下次重试
重要行为变化（cc-switch 用户必读）
从 0.50.3 起，CodePilot 的"有没有可用服务商"判定不再把 ~/.claude/settings.json（cc-switch / 手动编辑）视作有效服务商。如果你之前纯靠 cc-switch 管理 Claude Code 凭据、从未在 CodePilot 设置里添加过任何服务商，升级后首次发消息会被引导去"设置 → 服务商"添加一个 CodePilot 自己的服务商记录。
这是为了让 CodePilot 的每个请求都能精确地知道该走哪个服务商的凭据，避免之前 cc-switch 代理模式下占位符 token 被错当成真凭据而导致的各种诡异失败。你仍可以继续用 cc-switch 管理 Claude Code CLI 本身的凭据——两者是独立的。
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示，在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商（Anthropic / OpenRouter / OpenAI 等）
- 推荐安装 Claude Code CLI 以获得完整功能