Releases: op7418/CodePilot
CodePilot v0.48.2
CodePilot v0.48.2
v0.48 系列稳定性修复版 — 主要修复了第三方服务商配置和对话管理的几个关键问题,建议所有 v0.48.x 用户升级。
修复问题
- 第三方服务商设为默认后无法使用:设置阿里云百炼、智谱、OpenRouter 等第三方服务商为默认后,新对话首条消息报 "No provider credentials available" 或进程崩溃的问题。根因是 UI 上的"当前选中"标记被错误地当作"启用/禁用"过滤,导致用户明确设置的默认服务商被忽略
- 编辑第三方服务商后测试连接失败:之前前端会把编辑对话框里显示的遮罩密钥(
***xxx)原样发送给服务器做测试,导致一律 401。现在未改动时后端自动从数据库读取真实密钥 - 重命名对话点了没反应:macOS / Windows 上点击左侧会话列表三点菜单 → 重命名对话后,输入框无法打开的问题(Electron 禁用了 window.prompt)
- 诊断页面的误导性警告:Claude Code 诊断日志中出现的 "Provider is inactive, re-resolving" 警告实际上是代码逻辑 bug,会让用户误以为配置有问题。已清除
- 切换认证方式后测试使用旧凭证:服务商编辑对话框切换 API Key / Auth Token 时的状态迁移不一致,可能导致测试连接使用错误凭证
新增功能
- 编辑时可以直接测试连接:编辑已有服务商时,未改动 API Key 也能直接点"测试连接",自动使用已保存的密钥。之前这种场景按钮是禁用的,用户必须重新输入一遍密钥才能测
- 主动清除已存 API Key:服务商编辑对话框新增"清除已存密钥"按钮,支持撤销。之前一旦保存就无法删除已存密钥,只能重新输入新值覆盖
优化改进
- 会话重命名改用应用内对话框,支持 Enter 提交、Esc 取消、打开时自动全选原标题方便直接替换
- 测试连接按钮状态对齐完整的密钥生命周期:无密钥禁用、保留原密钥可测、标记清除后禁用(避免测试旧密钥却保存新状态的误导性成功)
- 服务商编辑对话框的 API Key 输入框在编辑态显示"已保存,留空则沿用原密钥"提示,不再泄露遮罩字符串
下载地址
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.48.1
CodePilot v0.48.1
v0.48.0 发布后的紧急修复,解决 Runtime 选择、看板渲染、数据库约束等问题。
修复问题
- 修复了只配置第三方服务商(如智谱、Kimi)时,自动模式错误选择 Claude Code 引擎导致无法使用的问题
- 修复了 Native 引擎下大量请求被误判为"空响应"的问题
- 修复了看板面板中 Widget 样式丢失、内容被裁切的问题
- 修复了删除会话时可能出现的数据库外键约束错误
- 修复了 OpenAI Codex API 连接超时没有明确提示的问题,现在会建议配置代理
- 修复了更新通知弹窗在每次启动时重复弹出的问题
优化改进
- Runtime 选择现在精确匹配请求使用的服务商凭据,不再被无关服务商干扰
- 显式选择 Claude Code 引擎时始终尊重用户选择,不再因凭据检查误判
- 服务商过期引用(如删除服务商后的残留绑定)现在正确回退到可用服务商
下载地址
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.48.0
CodePilot v0.48.0
全新 Agent 引擎架构:无需安装 Claude Code CLI 即可完整使用,同时支持 OpenAI 授权登录。
新增功能
- 双 Agent 引擎可选:AI SDK 引擎(开箱即用,支持多服务商)和 Claude Code 引擎(通过 CLI 驱动,完整命令行能力),可在设置中自由切换
- OpenAI 授权登录:ChatGPT Plus/Pro 用户可在服务商设置中通过 OAuth 登录,直接使用 GPT-5.4、GPT-5.4-Mini、GPT-5.3-Codex 等模型
- 输入框下方新增 Agent 引擎状态标记,显示当前实际使用的引擎,hover 可查看详情并跳转设置
- 首次打开自动检测系统语言,中文系统自动切换为中文界面
优化改进
- 首次设置引导优化:Claude Code CLI 标记为"可选",新用户无需安装 CLI 即可开始使用
- 内置工具全量注册:通知、素材管理、仪表盘、记忆搜索、CLI 工具管理等 29 个工具始终可用,不再依赖关键词触发
- 内置工具(codepilot_* 系列)跳过权限审批,减少不必要的确认弹窗
- 系统提示词全面升级:参考 Claude Code 和 OpenCode 的提示词体系,提升代码生成质量
- MCP 工具完整支持:外部 MCP 服务器的工具在 AI SDK 引擎下也能正常使用
- 错误监控扩展:新增 Native 引擎专属错误类别和 Sentry 上报,便于问题定位
修复问题
- 修复了文件回退(Rewind)可能丢失会话前未提交修改的问题
- 修复了中断对话在 Claude Code 引擎下不生效的问题
- 修复了带附件消息在多轮对话中丢失的问题
- 修复了 OpenAI OAuth 登录成功页在 token 交换失败时仍显示成功的问题
- 修复了 OAuth callback 服务器监听所有网卡的安全问题,改为仅监听 localhost
下载地址
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.47.0
CodePilot v0.47.0
服务商系统全面治理,新增连接测试和匿名错误上报,品牌重定位为多模型 AI Agent 桌面客户端。
新增功能
- 服务商配置新增"测试连接"按钮:填完 API Key 后立即验证是否能连通,不用发消息才发现配置有误
- 服务商配置新增引导面板:显示计费模式标签、API Key 获取链接、配置注意事项
- 新增匿名错误上报(Sentry):帮助开发者定位高频问题,默认开启,可在设置中关闭
- 新增服务商模型管理 API:支持为每个服务商自定义添加/删除模型
- 新增小米 MiMo 服务商(按量付费 + Token Plan 两种模式)
修复问题
- 修复智谱 GLM、Moonshot、OpenRouter、百炼等 6 个服务商的认证方式配置错误,大幅减少首次连接失败
- 修复用户终端 Claude Code 的 settings.json 配置覆盖 CodePilot 服务商选择的问题
- 修复运行时报错缺少恢复操作建议的问题,现在会显示"重新获取 Key"等可点击链接
- 修复模型选择下拉框出现横向滚动条的问题
- 修复"管理服务商"按钮跳转到通用设置而非服务商页面的问题
- 修复 Kimi 使用了错误的认证头(Bearer 而非 X-Api-Key)的问题
优化改进
- 品牌重定位:从"Claude Code 桌面 GUI"更新为"多模型 AI Agent 桌面客户端"
- README 全面重构(中/英/日三语):新增下载量和 Stars badges,下载区前置,17+ 服务商表格
- 服务商系统新增 Zod Schema 校验:防止无效配置上线,新增 61 个自动化测试
- 服务商配置页去除 230 行重复代码,统一为单一数据源
- 官网服务商文档更新:修正国内服务商表格,新增各服务商注意事项
- GitHub About 描述和联系方式更新
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示,在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商(Anthropic / OpenRouter / 智谱 / Kimi / Ollama 等)
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot v0.46.0
CodePilot v0.46.0
新增 Ollama 本地模型支持,优化工具调用展示和推理内容(Thinking)的显示与保留。
新增功能
- 新增 Ollama 服务商预设:一键接入本地模型,无需 API 密钥
- 新增推理内容(Thinking)流式展示:支持实时查看模型的推理过程
- 工具调用展示全面重构:分组折叠、状态指示、运行中工具实时输出
修复问题
- 修复中断或出错时已展示的推理内容(Thinking)在完成态消失的问题
- 修复远程桥接(Telegram/Discord/飞书)静默丢弃推理内容的问题
- 修复未注册工具(MCP 工具、插件工具等)在操作列表中不显示名称的问题
- 修复 auth_token 认证方式未显式清空 API Key 导致部分服务商连接失败的问题
优化改进
- 服务商文档新增 Ollama 配置指南(中英双语)
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示,在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商(Anthropic / OpenRouter / Ollama 等)
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot v0.45.1
CodePilot v0.45.1
新增默认侧边面板设置、小米 MiMo Token Plan 渠道,以及 Buddy 头像本地化等修复。
新增功能
- 新增「默认侧边面板」设置:可选择新对话时自动打开文件树、看板、Git 或不打开
- 新增小米 MiMo Token Plan 服务商预设,支持订阅套餐方式使用
修复问题
- 修复 Buddy 头像在部分网络环境下无法加载的问题(图片改为本地打包)
- 修复 Windows 安装包下载链接指向错误文件名的问题
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示,在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商(Anthropic / OpenRouter 等)
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot v0.45.0
CodePilot v0.45.0
内存优化专项:全面治理客户端内存占用,涵盖缓存淘汰、流式加载、懒加载、消息窗口化等多项改进。同时包含上下文管理系统和 CLI 升级能力。
新增功能
- 新增上下文管理系统:自动测量 token 用量、智能压缩长对话、改进的上下文回退策略
- 新增 CLI 版本检测和一键升级功能,在设置页直接管理 Claude Code CLI
- 新增系统代理自动透传,VPN/代理用户无需手动配置即可正常使用
优化改进
- 代码高亮缓存(Shiki)加入 LRU 淘汰策略,不再随代码块种类无限增长
- 侧边面板(文件预览、Git、文件树、看板、助理)改为按需加载,未打开时不占用内存
- Markdown 渲染引擎及插件改为懒加载,仅在实际需要渲染时才加载
- 终端输出加入 500KB 硬上限,长时间运行的命令不再无限累积内存
- 聊天消息列表加入 300 条滑动窗口,超出部分自动卸载、上翻时按需重新加载
- 文件预览改为流式读取,不再将整个大文件加载到内存中
- 大文件(>10MB)的图片、视频、音频预览改为流式传输
- 图片上传后立即释放 base64 数据,仅在发送给 AI 时按需从磁盘读取
- 图片引用缓存加入容量上限(50 条)和自动淘汰
- 流式会话管理器中的定时器全部纳入统一追踪,会话结束时确保清理
- 工具输出预览窗口从 5000 字符缩减至 2000 字符
修复问题
- 修复多张图片引用时保留策略错误的问题,现在正确保留最新的图片
- 修复上下文压缩后 token 预算计算不准确的问题
- 修复压缩器模型回退和服务商解析的问题
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示,在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商(Anthropic / OpenRouter 等)
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot v0.44.1
CodePilot v0.44.1
v0.44.0 热修复:修复切换会话时模型选择器跳到错误模型的问题,以及若干界面优化。
修复问题
- 修复切换会话时,模型选择器短暂显示上一个会话的模型再跳回正确值的问题
- 修复分栏视图中切换会话同样会出现模型跳动的问题
- 修复全局默认模型属于其他服务商时,可能被错误应用到当前会话的问题
- 移除设置页中的"重置伙伴"按钮(测试功能,不应出现在正式版)
优化改进
- 看板面板默认宽度从 640px 调整为 480px,减少对聊天区域的占用
- 模型解析逻辑统一为共享函数,主聊天页和分栏视图行为一致
- 新增 11 个模型解析回归测试,覆盖跨服务商、空配置、已删除服务商等边界场景
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示,在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商(Anthropic / OpenRouter 等)
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot v0.44.0
CodePilot v0.44.0
Buddy 游戏化全面升级:3D 视觉体系、心跳双模式、后台通知、调度器健壮性修复,以及 54 个新增测试。
新增功能
- Buddy 宠物全面使用 3D Fluent Emoji 图片替代系统 emoji,覆盖 Wizard 揭晓、聊天空状态、新建聊天入口、侧栏推广卡、看板 Buddy 卡
- 稀有度渐变背景和胶囊标签,视觉上从灰/绿/蓝/紫/金区分 5 个等级
- 助理空会话展示 Buddy 3D 形象(有 Buddy)或 3D 蛋图(无 Buddy),非助理项目保持 CodePilot logo
- 看板 Buddy 卡重新设计:紧凑状态行、进化按钮反馈、设置按钮内联
- 心跳系统支持"软心跳"模式:在普通对话中自然顺带做日常检查,不打断用户
- 后台无窗口时(tray-only 模式),定时任务通知仍能弹出系统通知,点击恢复窗口
- 定时任务调度器支持冷启动自动恢复(不再依赖首次聊天触发)
- Buddy 重置时自动清理 soul.md 中的旧性格描述
修复问题
- 修复心跳指令可能混入普通对话的问题
- 修复 Buddy 领养引导和心跳检查可能同时触发的冲突
- 修复工作区内 symlink 可以绕过路径校验读取外部文件的安全漏洞
- 修复 session-only 循环任务到期后每 10 秒重复执行的问题
- 修复 session-only 任务无法列出和取消的问题
- 修复 session-only 任务失败后不退避、不自动禁用的问题
- 修复 low/normal 优先级通知被静默吞掉的问题
- 修复 MCP 工具硬编码 localhost:3000 导致 worktree 和打包环境失效的问题
- 修复自动记忆提取的"本轮已写入"检查失效的问题
- 修复记忆提取计数器跨会话串线的问题
- 修复 cron 表达式解析器对周/月级调度计算错误的问题(扩展到 4 年扫描)
- 修复不可能的 cron 表达式(如 2 月 30 日)会设置错误执行时间的问题
优化改进
- 心跳触发判定统一到服务端 API,前端不再重复实现
- 通知系统新增服务端队列,前端 5 秒轮询显示 Toast + 系统通知
- Electron 通知优先走 IPC 原生桥(支持点击回到窗口),浏览器 Notification 仅作开发模式 fallback
- 定时任务创建和调度共用同一份 cron/interval 解析函数,消除重复实现
- 新增 54 个单元测试覆盖 cron 解析、记忆提取计数器、心跳标记清理、通知队列、后台通知解析
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示,在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商(Anthropic / OpenRouter 等)
- 推荐安装 Claude Code CLI 以获得完整功能
CodePilot v0.43.1
CodePilot v0.43.1
v0.43.0 热修复:修复可视化组件流式输出时中文显示为乱码、看板刷新按钮对 CLI 数据源不生效的问题。
修复问题
- 修复可视化组件在流式输出时中文字符显示为
\uXXXX转义码的问题 - 修复看板刷新按钮对 CLI 数据源类型的组件不生效的问题
下载地址
macOS
Windows
安装说明
macOS: 下载 DMG → 拖入 Applications → 首次启动如遇安全提示,在系统设置 > 隐私与安全中点击"仍要打开"
Windows: 下载 exe 安装包 → 双击安装
系统要求
- macOS 12.0+ / Windows 10+ / Linux (glibc 2.31+)
- 需要配置 API 服务商(Anthropic / OpenRouter 等)
- 推荐安装 Claude Code CLI 以获得完整功能