更新日志（Changelog）

本项目所有重要变更记录于此。格式参考 Keep a Changelog， 版本号遵循 语义化版本。

0.10.0 - 2026-07-05

本版重点：

• 品牌官网上线：基于 VitePress 的项目官网，含落地页 / 下载页 / 常见问题与托管的双语使用文档，经 GitHub Pages 自动部署。
• 项目国际化：README 与使用文档全面双语化（英文默认 + 中文）。
• 可定制的代码建议输出：可约束 AI 建议的写法、并自定义其生成的评审草稿评论排版（设置 → Agent → 策略）。

除对外呈现外，桌面应用新增了可定制的代码建议输出；其余桌面应用与 CLI 的功能行为较 0.9.0 基本无变化，仅含一处启动期小修复。

✨ 新增

• 品牌官网：面向用户的项目官网正式上线（https://huhamhire.github.io/code-meeseeks/）。
  • 落地页：一句话定位 + 深浅自适应的产品截图 + 核心特性 + 模型生态展示 + 跳转 Releases 的下载入口。
  • 下载页：按访问者操作系统自动推荐对应安装包，GUI 与 CLI 分栏；CLI 提供 macOS / Linux 一键安装脚本；下载信息运行期取最新 Release，并有构建期静态兜底以抵御接口限流。
  • 常见问题（FAQ）独立成页。
  • 托管使用文档：官网直接从仓库使用文档构建渲染，中英文双语、随文档更新同步，且站内搜索支持中文界面。
  • 部署与发版解耦：官网经独立流水线部署到 GitHub Pages，不占用应用 / CLI 的发版流程。
• 项目文档国际化：对外文档全面双语化（英文为默认 / 兜底、中文对照）。
  • README 拆分为英文（默认）与中文两份，顶部可互相切换。
  • 使用文档双语化——英文为正本、中文为对照镜像，官网按语言分别渲染。
• 可定制的代码建议输出（设置 → Agent → 策略，均在内联弹窗中编辑）：
  • 建议规范（code_suggestion_spec）：注入 /improve、/review、/ask 的自由文本，用于约束每条建议的结构（如 问题 / 分析 / 建议）——软约束，模型通常会遵守。
  • 建议排版（code_suggestion_layout）：评审草稿评论的确定性 Markdown 模板，支持 <TITLE> / <SUGGESTIONS> / <HOME> / <PR> / <MODEL> 占位符。留空则使用默认排版——建议正文上方是一行可点击的「AI 建议」链接 + 模型名（默认草稿评论前缀因此从此前的纯 [AI 建议] 变为该形式）。

🔧 修复

• 启动时仅 ping 当前激活的连接，不再遍历所有已配置连接：非激活连接的身份无界面消费方，遍历 ping 只会增加启动期网络请求，并让不可达的连接在每次启动时反复告警。切换激活连接时仍会按需刷新其身份。

0.9.0 - 2026-07-02

本版重点：

• 外部集成与 CLI：开启本机 API 把 PR 浏览与评审 Agent 操作开放给外部集成，并提供跨平台命令行工具 meebox

✨ 新增

• 外部集成 · 本地 API 服务：设置新增「集成」分区，可开启一个本机 API 服务，将 PR 浏览与评审 Agent 操作以接口形式开放给外部 agent / 工具 / 脚本集成。
  • 默认关闭；开启即强制访问令牌鉴权，令牌可一键生成 / 显示 / 复制 / 重新生成。
  • 监听地址可自定义：默认仅本机可达，按需可开放到局域网（开放时给出安全提示）。
  • 开放浏览（当前身份 / PR 列表 / 详情 / diff / 动态 / 提交 / 评审人）、评审 Agent（状态 / 历史 / 自动评审 / 指令 / 对话 / 中断）与评审写动作（通过 / 需修改 / 发评论）；不开放合并与变更类 Agent 工具（publish 等）。
• 外部集成 · 命令行工具 meebox：随发布提供 Windows / macOS / Linux 跨平台命令行客户端，经本地 API 服务浏览 PR、操作评审 Agent 并执行评审写动作（approve / needswork / comment），便于脚本与外部 agent 集成。PR 列表精简且支持分页；PR 关联命令用 --pr <id>；连接信息须显式提供（flag / 环境变量 / cli.yaml），不读 GUI 主配置。
• PR 列表发现分类未读圆点：某发现分类（待我评审 / 我创建 等）下有新的待处理 PR 时，在该分类标签后加未读圆点，一眼看出哪类有新进展；圆点始终基于活跃 PR，即便当前处于「已关闭」视图也正确反映活跃分类的未读。
• 「我创建的」PR 通知：针对本人创建的 PR 新增三类系统通知——收到他人新评论、被评审标记「需修改」、出现合并冲突；通知分区提供独立开关、默认开启。
• 命令回显气泡：在评审 Agent 面板直接发起 /review、/describe、/improve、/ask 等命令时，命令即时以用户气泡回显在其结果卡片之上，贴合对话习惯；编排 / AutoPilot 派发的子任务不回显，避免与编排会话的用户消息重复。
• 按提交发起评审 Agent：在 Diff 视图将变更范围切到某个提交后，评审 Agent 面板直接键入的 /describe、/review、/improve、/ask（含自然语言提问）会自动限定在该提交自身改动（parent..sha）而非 PR 全量；输入栏以范围 chip 标示当前提交，chip 选中态源自视图选择，点击可临时禁用（不删除、切到别的提交自动复位），与 Diff 选区 chip 交互一致。同一时刻仅一个 scope 生效：选中 Diff 行时以选区为准、暂挂提交范围，取消选区后自动还原。运行中与完成的评审结果卡均展示所限定提交的范围徽标。一键自动评审仍作用于 PR 全量。

♻️ 变更

• 评审 Agent 的 /ask（本机 agentic CLI 提供方）注入代码检索指引：引导以只读搜索定向查符号 / 只读所需行段替代整文件通读与全仓扫描，在保留读真实文件深度的同时，降低探索轮次与 token 消耗。
• 「追问数量」上限现同时约束自由对话 Agent（会话即委派）的自动 /ask：此前该上限仅作用于评审微流程的条件追问，自由规划循环仅受「Agent 最大步数」约束、可连续多次 /ask（每次均为一次成本较高的 agentic 探索）；现自由对话中的 /ask 亦按「追问数量」封顶（始终生效，与「自动追问」开关无关），避免探索成本失控。
• 状态栏不再常态显示 pr-agent 版本号（减少常态噪声），仅在其不可用时保留告警提示；版本号改在设置「关于」页的运行环境信息中展示。
• 「我创建的」分类下的「待处理」筛选并入存在合并冲突的 PR：作者视角下有冲突的 PR 需其跟进解决（即便评审已通过），故一并计入待处理。
• PR 列表的状态二级筛选改为宽度自适应胶囊：一行容得下即不换行，容纳不下时换行并按每行项数均分撑满整行，消除换行后右侧留白参差。
• 评审 Agent 派生的临时工作树内部分支不再使用固定的品牌化名称，改为与 PR 关联的 pr-<localId>/head、pr-<localId>/base（分层命名贴合平台 PR 引用惯例）：消除产出中可辨识的固定行为特征，同时保证该内部分支名不会漏入对外发布的评审内容。

🔧 修复

• 修复 PR 列表分组标题背景色、Windows 窗口右上角控制按钮此前不随主题（编辑器配色主题）变化的问题；现二者均跟随当前主题派生配色，深浅 / 主题切换实时生效。
• 修复点开带「@我 / 回复我」未读计数的 PR 后，标题处的未读计数 chip 不立即消除、需等下一轮轮询才清零的问题：标为已读时同步乐观清零该计数（此前仅清未读圆点，遗漏了计数 chip）。
• 修复德语等界面下设置页左侧导航的长标签（如「通知」）溢出被裁切的问题；现长标签自动换行完整显示。

0.8.0 - 2026-06-30

本版重点：

• 消息通知：系统通知（新 PR / 评论回复 / 被 @）+ macOS dock 角标 + 授权引导
• 评论体验优化：emoji 反应、@ 提及补全、图片附件、表情代码渲染——评论 / 回复 / 行内 / 草稿一致
• 命令面板：Ctrl/Cmd+Shift+P 归口常用操作
• 已关闭 PR 浏览与按 URL 打开：查看历史 PR、补充评论 / 补跑评审
• 评审规则增强：规则目录递归、多规则按 Ruleset 分段注入
• 2026 主题配色 与 PR 列表点名计数

✨ 新增

• 评论体验优化：评论列表、回复、行内（代码行）评论与草稿编辑保持一致的撰写与互动体验。
  • emoji 反应：评论（含行内评论）下方展示已有 emoji 反应（含计数与本人标记），可点选添加 / 取消；GitLab / Bitbucket 支持搜索挑选更多表情，GitHub 为其固定表情集——随平台能力提供，不支持的平台自动隐藏。
  • @提及自动补全：撰写评论 / 回复时输入 @ 可从本 PR 参与者（评论与提交作者）中选择补全；仍可自由手打任意用户名。
  • 图片附件：撰写评论 / 回复 / 行内评论 / 草稿时可粘贴图片或点输入框右上角的图片按钮选取上传，自动插入正文（随平台能力提供，不支持的平台隐藏入口）。
  • 表情代码渲染：评论正文里的 :tada: 等表情代码按内置表情集渲染为对应 emoji（代码块与未知代码原样保留）。
• 消息通知：新增「通知」设置分区，可开启系统通知并按事件类型分别控制——收到新的 PR、收到评论回复、评论中被 @。
  • Windows / macOS 弹原生系统通知；是否显示遵循操作系统的通知设置，关闭后自动静默。
  • Windows 通知带发起人头像、按 PR / 评论 / 回复区分的类型标记，并显示所在仓库。
  • 仅对「待处理」的 PR 弹通知——已批准 / 已标记需修改的 PR 不再打扰。
  • 点击通知直接定位：新 PR 打开该 PR；内联评论跳到 Diff 对应代码行，顶层评论打开该 PR 的对话标签。
  • 批量动态时最多单独弹 5 条，更多折叠为一条「查看更多最新动态」提示，点击打开主界面查看，避免通知刷屏。
  • macOS dock 图标显示待你回应的评论计数角标。
  • macOS 通知设置提供「打开系统通知设置」按钮，便于在系统层授予通知权限（macOS 不允许应用代为开启）。
• PR 列表点名计数：当未读评论中有 @ 你 / 回复你时，列表项标题前的未读圆点升级为显示条数的计数标记（封顶「10+」），一眼看出有多少条待你回应的评论；仅新分配 / 新提交导致的未读仍显示圆点。
• 关于页系统信息：设置「关于」页新增操作系统（平台 + 版本）与 CPU 架构信息，并提供「复制信息」按钮一键复制全部运行环境信息，便于反馈问题时附带环境。
• 已关闭 PR 浏览与补充评审：侧栏新增「已关闭」范围切换，查看历史退场（已合并 / 关闭 / 不再需你评审）的 PR；进入时按需加载。
  • 已合并 / 仍开放的 PR 可补充评论、补跑 AI 评审（源分支已删的合并 PR 按提交定位 diff）；仅不再提供合并 / 审批等改动操作。
  • 已关闭（declined）的 PR 仅供浏览。
• 按 URL 打开 PR：命令面板新增「打开 URL」（快捷键 mac ⌘⇧U / 其余 Ctrl+Shift+U），粘贴 / 输入当前平台的 PR 链接即可打开（自动忽略尾缀），用于查看未正式被请求参与评审的他人 PR，含已合并 / 已关闭的 PR。
  • 已在列表或历史中的 PR 直接定位；新链接会鉴权拉取后存入历史（随相同生命周期到期清理），无权限 / 链接无效即提示。
• 命令面板：标题栏新增命令输入框（Ctrl/Cmd+Shift+P 唤起），快速执行常用操作并归口分散功能。
  • PR 类命令：查看各发现分类（待我评审 / 我创建 等，随平台能力）、查看已关闭、按 URL 打开、分类筛选（待处理 / 全部 / 冲突 / 可合并 等）、切换 PR 列表。
  • 评审类命令：运行自动评审、切换 AutoPilot、切换对话面板。
  • 设置类命令：切换显示语言 / 主题 / 模型、切换代理、打开设置 / 关于 / DevTools。
  • 命令按领域前缀分类（PR / 评审 / 设置）、两级选择（如「切换主题」展开主题列表）；非英语界面附英文名且始终支持中英文检索，匹配处高亮。
  • 打开时默认选中上次用过的命令，回车即重复。
  • 常用操作支持快捷键（开合 PR 列表 / 对话面板、运行自动评审、DevTools），命令面板内显示对应键位。
• Agent 上下文目录新增 README 说明文件：介绍各文件用途并指向项目主页，便于用第三方编辑器了解与维护该目录。

♻️ 变更

• 默认主题（跟随系统）改用 2026 系列配色：深色 / 浅色分别采用 Dark 2026 / Light 2026，启动闪屏同步对齐；已自定义主题的设置不受影响。
• 退场（已合并 / 关闭 / 不再需你评审）的 PR 数据迁出活跃目录、独立归档存放，归档保留与到期自动清理策略保持不变。
• Agent 的 SOUL（人格定义）文件改由应用统一管理：每次加载自动对齐到内置模版、本地改动不再保留，以便随版本统一更新 Agent 行为基线（AGENTS / MEMORY / USER 与规则仍归你所有、可自由改写）。
• 评审规则增强：规则目录支持子目录递归组织、自动加载全部规则文件；同一 PR 命中的多条规则不再只取首条，而是按 Ruleset 分段一并注入评审（按 priority 排序、单次封顶 20 条），命中提示改为显示条数、可预览全部命中规则。
• PR 列表的状态二级筛选随发现分类细化：「待处理」反映「本人尚未评审」，仅在「待我评审」分类、以及支持「需修改」评审态的平台（GitHub / Bitbucket）的「我创建的」等分类下保留；GitLab（二元审批、无「需修改」）的非「待我评审」分类不再展示无意义的「待处理」。
• Agent 目录的示例规则改为仅在首次初始化时生成；删除后不再被重新创建，便于清理不需要的示例。

🔧 修复

• 修复将 Agent 上下文目录指向自定义或新位置后该目录未被初始化、加载为空的问题；现在无论经设置或直接修改配置变更，目录在使用前都会自动补齐 SOUL / AGENTS 等上下文模版。
• 修复运行中的 AI 任务、其 PR 被自动移入「已关闭」后，点击状态栏的执行指示无法定位并打开该 PR 会话的问题；现可正确跳转到「已关闭」分类、选中该 PR 并打开会话。
• 修复状态栏「待审 PR」计数把「我创建的」等并非待我评审的 PR 也计入的问题；现仅统计需我评审且本人尚未处理的 PR。
• 修复部分平台（尤以 Bitbucket）上他人回复评论 / 在评论中 @你 时常常不弹通知的问题；现对待处理（待我评审 / 我创建）的 PR 可靠跟踪评论变化，回复与提及均会及时提醒。
• 修复点击系统通知无法定位到已归档 PR（如运行中任务的 PR 刚被移入「已关闭」）的问题；现可正确跳转到「已关闭」分类、选中该 PR 并按类型打开对应位置。
• 修复正在查看某 PR 的变更（Diff）时，该 PR 收到新的评论回复，内嵌评论却需切换到其它 PR 再切回才刷新的问题；现在轮询发现回复 / 提及后会即时刷新当前打开的评论。

0.7.0 - 2026-06-27

本版重点：

• 深色 / 浅色主题与外观体系：主题切换、编辑器配色主题、自定义等宽字体与字号
• AI 评审运行参数：评审任务并发、上下文长度、Agent 策略（自动追问 / 代码建议数量）
• PR 列表未读标记
• Agent 对话增强：选区引用附带显示、思考过程 markdown 排版、/merge 直接合并
• 本机 agentic CLI 编排提速
• 代码平台接入层领域化重构（行为不变）

✨ 新增

• 主题与外观
  • 深色 / 浅色主题切换：可选浅色、深色或跟随系统，界面即时切换、重启保留。
  • 编辑器配色主题：内置多款可选（VS Code 2026 / Modern、高对比，以及 GitHub、Monokai、Dracula、Nord、Solarized 等），可跟随应用主题或单独指定。
  • 编辑器字体与字号：自定义等宽字体（可多个候选）与字号，编辑器及全应用等宽文本（diff / 评论 / 代码块）一并生效。
• AI 评审运行参数
  • 评审任务并发：在设置页「AI」分区调整同时执行的评审任务数（1~8），即时生效、无需重启。
  • 上下文长度：在设置页「AI」分区设置裁剪输入内容的上下文长度上限（32k~1M 的习惯档位），让长 PR 完整入 prompt；对本地 CLI 模式不生效。
  • Agent 策略：在设置页「智能体」分区新增策略组——「自动追问」（关闭后评审直接总结、不再条件追问，省 token）与「代码建议数量」（统一约束 /review·/improve·/ask 单次生成的代码建议数量，2~8）。
• PR 列表
  • 未读标记：PR 新进入待审列表（新分配 / 请求你评审），或自上次查看后有新 commit 推送、有人 @ 你 / 回复你，列表项会标一个未读圆点；打开 PR 即清除。
• Agent 对话
  • 提问引用附带显示：带 Diff 选区代码提问时，引用的代码在消息气泡下方折叠展示（评论建议引用沿用复评卡片上的定位徽标）。
  • 思考过程支持预格式化排版：思考 / 判读内容按 markdown 渲染（代码块 / 列表 / 换行）。
  • 新增 /merge 指令：满足合并条件的 PR 可在对话中直接合并，触发前弹二次确认。

♻️ 变更

• 本机 agentic CLI 模式下 Agent 编排的自有步骤（路由 / 追问判读 / 评审总结）响应更快：每步不再加载用不到的 API 调用栈，降低每次响应的固定启动延迟，对话与自动评审整体更跟手。
• 配置面板改为左右分区布局：左侧分区导航（常规 / 连接 / AI / 关于）、右侧按分区归类展示配置项，替代此前单列平铺；分区结构为后续扩展（主题、编辑器风格、上下文窗口等）预留。
• 代码平台接入层基于领域设计重构（行为不变）：为后续平台接入与维护打基础。
  • 按连接、PR 操作、评论、用户与媒体四个领域拆分为独立服务，职责更清晰、便于按领域独立维护与测试。
  • 各平台的连接与代理配置统一收口到连接层，新增代码平台可按领域分步接入。
  • 平台连接相关的状态提示（如版本不支持原因）改为按界面语言本地化。

🔧 修复

• 并排 diff 在窗口较窄自动降为统一布局时，滚动条总览标尺的删除标记丢失、只剩新增的绿色；现按实际布局正确区分红/绿。
• 窗口尺寸与最大化状态现可跨重启记住（此前调整尺寸或最大化后关窗常丢失）。
• 高分屏开启缩放时，默认窗口尺寸可能超出屏幕范围；现按当前显示器可用区域自适应并居中显示。
• 本地状态目录下偶发残留的临时文件会随每次运行持续累积；现于启动时自动清理。

0.6.0 - 2026-06-23

本版重点：

• /ask 复评闭环：对评审建议发起复评、自动取代 / 关闭原评论
• /ask 结构化分段输出与完整文件上下文
• Agent 会话中途输入与「计划」面板
• Diff 体验增强：选区引用提问、按变更范围 / 单 commit 查看、冲突文件标注、删除行评论、滚动条总览标尺
• PR「活动」时间线
• 前后端基于领域设计的重大重构（行为不变）与 Agent 编排提速

✨ 新增

• Agent 评审与对话
  • /ask 复评闭环：对 /review、/improve 的代码评论建议（finding）发起「复评」，按裁决（取代 / 保留 / 撤销）自动取代或关闭原评论；自动评审微流程亦可由 judge 触发复评。
  • /ask 结构化分段输出：自由问答按「结论 / 分析解读 / 建议」三段着色呈现，针对代码的建议可定位行号、采纳为行内评论。
  • CLI 模式 /ask 取完整文件上下文：本机 CLI 接管时可读取仓库完整文件作答，读取前清空仓库自带 agent 指令文件以防注入污染。
  • 会话「中途输入」与「计划」面板：运行期间再输入消息即时入队并重排后续行动；规划 Agent 维护可视的 todo 计划，随会话持久化、切 PR / 重启自动恢复。
  • run 卡片展示「模型实际交互规模」：呈现提示缓存命中量与模型交互轮次，避免本机 CLI 多轮累加的 token 用量被误读为超限。
• Diff 阅览
  • 选中代码引用进提问：选中若干行后作为隐式上下文随提问注入模型、可一键忽略，删除行与未改动行同样可引用。
  • 按「变更范围」查看：可切换查看全部变更或某个 commit 的变更，点击 commit 本地渲染只读 diff、不再跳浏览器。
  • 文件树标注合并冲突文件：有冲突的 PR 对会冲突的文件标琥珀色三角警示图标，无需逐文件试合并即可定位。
  • 给「删除行」新增行内评论 / 草稿：并排视图下 base 侧（删除 / 上下文行）也可 hover「+」创建。
  • 滚动条总览标尺：把增 / 改 / 删与「有评论的行」投影到滚动条旁，拖动即可快速定位。
• PR 详情与协作
  • 「评论」标签页演进为「活动」时间线（GitHub / Bitbucket）：评论、提交更新、评审决断归并为一条时间线，并可直接发不锚定文件的 summary 评论；GitLab 保持纯评论视图。
  • PR 头部展示 reviewer 头像栈：按评审状态排序展示评审者头像、带决断角标，超出折叠为「+n」下拉。
  • 详情标签页国际化与左右布局：整面板按界面语言出文案，改为左描述 / 右时间线 + 评审者列表、窄宽响应式堆叠。
• 连接 / LLM 配置模态退出拦截：有未提交改动时关闭弹确认框，避免误丢未保存内容。

♻️ 变更

• 前后端基于领域设计的重大重构（可维护性，行为不变）：按领域边界重组前后端代码，划清模块职责与依赖方向。
  • 前端：组件按 common（基础 UI）/ layout（应用骨架）/ features（业务领域）分层，业务逻辑下沉所属领域，超大组件（ChatPane / SettingsModal / DiffView 等）拆为「容器 + 领域组件 + hooks」。
  • 后端：抽出 IPC 服务层、按领域分组 Agent 服务、解耦运行队列；Agent 引擎抽出可插拔「步骤」抽象统一记步与用量累计，编排提示词外置为资源文件。
  • 对外接口、界面与交互行为均不变。
• Agent 编排响应提速（对用户行为不变）：条件追问并行派发、追问判读瘦身为轻量路由、编排链路统一低推理 + 判读输出封顶，并把全局稳定系统前缀接入 Anthropic 1h 提示缓存，整体延迟与成本下降。
• 复评 /ask 取代 / 撤销改为静默自动关闭原 finding，「取代」裁决把建议提升为可采纳的代码反馈卡，前端仅只读展示关闭态与「查看复评」导航。
• agent「评审总结」聚焦 PR 整体结论：只吃每条追问的结论而非完整答案明细，输出 PR 级整体结论、不复制明细。
• PR 提交列表 / 活动时间线按 first-parent 过滤合入的他人提交，只保留本 PR 自产提交；镜像未就位时回退不丢信息。
• 评审 / Diff 界面交互打磨（一批小优化）：评审总结卡与 finding 卡统一样式行距、可折叠卡整行标题即展开并带过渡动画、点击复评引用徽标定位并高亮原卡、危险按钮统一为高饱和红、设置模态复用首启向导左右布局，及移除「已达并发上限」横幅、隐藏 /review「评估工作量」段等。

🔧 修复

• 源分支 merge 目标分支后，变更页 diff 混入目标分支的已有改动。(#107，感谢 @csj2000)
• /ask 的结构化分段 / 引用上下文 / 复评裁决指令此前对模型不生效。
• 复评「取代」裁决的改进建议改为可直接发布的替代评论，不再是关于评论的元讨论。
• 失败 / 取消的任务不再产出无意义的 finding 卡。
• CLI 模式 /ask 在仓库自带 agent 指令文件被版本管理时整体失败。
• 本地镜像缺 PR head sha（源分支被删 / 强推）导致 diff / 评审失败且不自愈。
• 消除 PR 切换 / 刷新 / 标签页切换时的多处渲染抖动与闪烁。
• 消除 Monaco 控制台 Missing requestHandler 噪音报错。
• 评审总结偶发被截断 / 回落「无法解析建议」。
• 拉取变更文件列表偶发失败（ENOENT … diff-base.json）。
• 合并已合并 / 已关闭的 PR 时报错不友好。
• 补齐 PR 评审状态 chip、Agent 步骤行等写死文案的国际化。
• 设置页手动「检查更新」结果即时同步到状态栏。
• PR 详情 / 评论页正文限宽居中、reviewers 列表排序稳定。

0.5.0 - 2026-06-17

本版重点：

• 可委派的高阶 Agent（会话 Agent 化 + AutoPilot 后台预评审）
• 无边框窗口 + 自绘标题栏
• 重型组件加载抖动、评论嵌套展示等体验打磨

✨ 新增

• 高阶 Agent（会话 Agent 化 + AutoPilot 预评审）：在 PR 评审中引入可委派的智能体，随 LLM 配置自动可用、无需单独启用开关。
  • 一键自动评审：对当前 PR 跑「描述 → 评审 →（仅严重问题）追问 → 总结」微流程，给出非约束性建议（建议通过 / 修改 / 人工复核）并汇总为「评审总结」卡片。
  • 对话即委派：聊天框输入自然语言，规划 Agent 按需调用只读工具完成请求，与 PR 无关的请求礼貌拒绝、运行中可随时停止。
  • AutoPilot 后台预评审：对「待我评审」且「待处理」的新 PR 自动预评审，建议落入列表徽标、总结落入会话；写操作经逐项授权 + 红线校验把关（默认仅开放只读工具）。
  • 评审状态可视化：PR 列表项展示蓝色「执行中」旋转指示或评审建议 ★（覆盖纯思考阶段），AutoPilot 触发的评审打机器人标记。
  • 并行多问：规划 Agent 可在一轮内并行派发多个 /ask。
  • 评审步骤 token 用量可见：每个推理步右侧分步展示本步 token 用量（不累计）。
  • Agent 上下文目录：以 SOUL / AGENTS / MEMORY / USER 与 rules/ 构成 Agent 的人格与知识来源，默认落 ~/.code-meeseeks/agent、首启幂等补齐模版。
• 无边框窗口 + 自绘标题栏（VS Code 风）：去掉系统原生标题栏、渲染层自绘 36px 标题栏、深色主题贯通到底，窗控按钮交由系统绘制保留原生行为，标题栏展示品牌名与当前 PR 标题。
• 设置页新增「关于 & 反馈」入口：GitHub 仓库 / 提交 Issue / Releases 三个外链。

♻️ 变更

• 重型组件加载抖动收敛：切换 PR / 文件时 diff（Monaco）、会话内容等重型区域统一盖延迟 loading、就绪后一次性 reveal，缓存命中的快切换零闪。
• 移除独立 ollama provider，统一经 openai-compatible 接入本地 Ollama（自带兼容端点、更标准），旧配置自动迁移；openai-compatible 标记为已验证。
• 评论嵌套展示统一（评论 tab + 行内）：回复满 5 层拉平为同层级、嵌套改「左竖线缩进」扁平样式。
• describe「文件变更」分类默认折叠，避免输出过长。
• 评审总结不再硬截断：summary_max_chars 仅作软约束，已生成内容完整保留。
• 一批 UI 细节：评审建议星标改为四角 sparkle ✦、统一 PR 列表状态 chip 带高消除行高漂移、/ask 问题末尾追加语言要求改善按界面语言作答。

🔧 修复

• 修复 PR diff 基准随目标分支漂移导致的「修改被撤回」误判。
• 修复 Windows 控制台中文日志乱码。
• 修复 finding 锚点解析在文件路径含方括号（如 a/[m-123]/x.ts）时出错。
• 修复 Anthropic provider 的自建 / 中转 base_url 此前不生效。(#65，感谢 @dnvyrn)
• 本地镜像 clone/fetch 被打断留下的残缺镜像现可自动重建自愈。
• 清空 PR 执行历史时一并清掉列表评审建议 ★，自动评审完成后 ★ 即时更新。
• PR「提交」数角标排除源分支合入目标分支带来的提交与 merge 提交。
• 补 walkthrough 文件分类标题（Miscellaneous / Formatting / Dependencies）的中 / 日 / 德译文。
• 消除评论页 poll / 刷新触发的渲染抖动。

0.4.0 - 2026-06-14

本版重点：

• 接入 GitLab（gitlab.com + Self-Managed，CE / EE）
• 评审交互与渲染打磨（拒绝折叠、草稿锚点对齐、评论内嵌附件图片、GitHub / GitLab 评论编辑删除）
• 连接 Base URL 放宽
• Windows 升级安装健壮性（per-machine 提权 + 绕过旧卸载器）

⚠️ Windows 安装说明：本版为 per-machine 安装（所有用户 / Program Files），安装器双击即弹 UAC 提权运行；安装后的应用以普通权限启动。从旧版升级会自动清理旧安装，无需手动卸载。

✨ 新增

• GitLab 接入（gitlab.com + Self-Managed，CE / EE，REST API v4）：MR 发现、diff 评论读 / 发 / 改 / 删 / 回复、合并、clone（PAT / SSH）、头像 / 附件代理；设置页与首启向导可新增 GitLab 连接（Base URL 可留空默认 gitlab.com）。
  • CE / EE 审批降级：经 /metadata 探测 edition——EE 支持通过 / 撤销，CE 无 API 审批、UI 灰显（GitLab 审批二元、无「需修改」）。

♻️ 变更

• 连接 Base URL 放宽：GitHub Enterprise / GitLab Self-Managed 可直接填实例地址（如 https://ghe.example.com），/api/v3、/api/v4 自动补全；github.com / gitlab.com 留空即用默认。
• 拒绝代码反馈 / 改进建议后卡片自动折叠置灰、仅保留头部与锚点行（含撤销入口），降低已决断项视觉占用。
• 本地 CLI 类 LLM provider 标注「实验性」：提示其依赖上游 CLI（claude / codex 等）、稳定性不作保证。
• 设置页连接 / LLM 预设卡片显示对应品牌类型图标避免误配；危险按钮实底改为饱和红提高警示力；Windows 安装页不再展开空白的文件日志列表、仅留进度条。

🔧 修复

• 修复 GitHub / GitLab 无法编辑 / 删除自己的评论。
• 修复 Bitbucket 评论内嵌附件图片不渲染。
• 修复代码建议草稿区的锚定行与最终发布落点不一致。
• 评论内嵌图片代理失败时降级为「浏览器打开」链接，不再显示破图标。
• 修复 Windows 升级安装卡死 /「无法关闭」。

0.3.1 - 2026-06-11

🔧 修复

• 修复 macOS 分发版「本地 CLI」provider（claude / codex）经 Finder / Dock 启动时因 PATH 不全而失效。(#21)

0.3.0 - 2026-06-11

本版重点：

• 界面国际化（四语 + 即时切换）
• Mermaid 架构图渲染
• 版本更新检测
• /improve 与 /describe 思路建议段等 pr-agent 能力扩展
• 修复首启同步、子进程树清理与安装 / 升级健壮性

⚠️ Windows 用户升级注意：若已安装早期版本（含 0.3.0-alpha.1 及更早），升级到本版前请先手动卸载旧版（设置 → 应用 → Code Meeseeks → 卸载，或安装目录下的 Uninstall Code Meeseeks.exe），完成后再运行新安装器；否则覆盖安装可能长时间卡住或弹出「Code Meeseeks 无法关闭」。原因：早期版本运行时会在安装目录写入上万个 Python 字节码（.pyc）缓存文件，使覆盖升级时「卸载旧版」一步需逐个删除海量小文件、极慢甚至卡死。本版起运行时不再写入这些缓存，之后的升级可正常覆盖、无需手动卸载。

✨ 新增

• 多语言界面（i18n）：接入 react-i18next，全部 GUI 文本与主进程面向用户文案覆盖简体中文 / English / 日本語 / Deutsch 四语；pr-agent 输出模板渲染期翻译同步语言感知。
  • 语言选择：设置页与首启向导下拉选择、即时生效，AI 回复语言随之（下次运行起）。
  • 语言解析：config.language 为空时按操作系统偏好语言匹配，默认 / 兜底为 en-US。
  • 按需懒加载：默认语言静态进入口，其余语言切换时才拉取（ja-JP / de-DE 为机器初稿）。
• Mermaid 架构图渲染：markdown 中的 mermaid 代码块渲染为图形，覆盖 PR 描述 / 评论 / chat 评审输出，点击进入模态预览（缩放 / 平移 / 适应窗口），渲染失败回退原始代码块。
• 版本更新检测：启动时及设置页查 GitHub Releases 最新稳定版比对，有新版在状态栏提示并可点击前往下载（仅检测、不自动安装），走配置的出站代理、可关闭。
• 启用 /improve 指令：逐行代码改进建议（带 1-10 重要度评分），输出落独立 improve.md 与 /review 分流。
• /describe 架构图与思路建议段：统一启用 GFM 使社区版 /describe 选择性输出 mermaid 架构图；并注入「思路建议」段——2-4 个替代实现方案（各自折叠）+ 倾向性推荐。
• describe 排版优化：架构图、文件变更各自独立成段配色块标题，文件变更按分类折叠。
• 清空执行历史：chat 面板标题栏新增垃圾桶按钮，清空当前 PR 的执行历史。

🔧 修复

• 安装 / 升级健壮性：减少安装目录小文件数，缓解升级卸载缓慢 / 卡死（已装早期版本仍需先手动卸载）。
• 修复取消 / 超时 / 退出时 litellm 等孙进程变孤儿。
• 修复活动连接无缓存身份时首启「看似未触发远端同步」。

0.2.0 - 2026-06-09

本版重点：

• 接入 GitHub（github.com + GitHub Enterprise Server）与多平台适配抽象
• 评审任务并发执行
• 启动显著提速
• 移除 Docker 运行策略，收敛到内嵌运行时

✨ 新增

• GitHub 适配（github.com + GitHub Enterprise Server，REST API v3）：PR 发现、diff 评论读写、行内评论、审批（通过 / 需修改 / 撤销）、合并；审批按平台能力降级，自己作者的 PR 审批按钮灰显。
• 多平台适配抽象基线：PlatformAdapter 能力描述符 + 评论线程字段，UI 据能力位显 / 隐 / 灰，不在调用处写平台判断。
• PR 发现分类：GitHub 对齐仪表盘四类（待我评审 / 我创建 / 指派我 / 提及我），Bitbucket 增两类；结果本地缓存、按标签本地过滤。
• 评审任务并发执行：队列改为可配置并发（每个 run 独立 worktree + 子进程），多个 PR 评审可并行，并发数由 pr_agent.max_concurrency 控制（1~8，默认 2）。
• 本地 CLI 模型 provider（cli）：把评审请求转交本机已安装并授权的命令行工具（Claude Code / Codex CLI），凭据与计费由该 CLI 自理。
• 单活动连接模型：PR 列表与状态栏只反映当前活动连接，切换后归档旧连接的 PR。
• 新增面向用户的使用说明文档（docs/guide/）：安装与首次使用、平台 / LLM / 代理配置、配置文件参考、自定义评审规则。
• 合并按钮等待态，防止重复点击。

♻️ 变更

• 启动提速：新增启动闪屏即时呈现 logo + spinner；Monaco 改懒加载，渲染入口包 ~10MB → ~2.6MB；pr-agent 探测移出建窗关键路径。
• 全仓内部命名统一为 Bitbucket，去除 BBS / BB 等歧义缩写（纯改名）。
• 架构设计文档目录 docs/modules/ → docs/arch/。
• 日志增强：dev 控制台改 logfmt 单行（按级别上色，文件仍 JSON）；渲染层未捕获错误经 IPC 回传 main 一并落日志。

🗑️ 移除

• 移除 Docker 运行策略：嵌入式运行时 + 系统 local-cli 已覆盖全部场景，pr_agent.strategy 不再接受 docker。

🔧 修复

• 修复模型返回多行自由文本值导致 pr-agent YAML 解析失败、/review 崩溃。
• 修复删除文件的行号片段渲染崩溃。
• 修复首启向导平台卡视觉错位。

🔒 安全

• GitHub 图片代理仅对可信的 GitHub / GHE 资产域附带 PAT，避免凭据被带往第三方域。
• 升级 nx 至 22.7.5 并修复 minimatch ReDoS（high）依赖告警。

0.1.0 - 2026-06-08

面向 Reviewer 个人 的本地化、半自动 AI 代码评审桌面客户端， 基于社区版 pr-agent 构建：拉取待评审 PR、本地跑 AI 生成评审意见， 逐条确认 / 编辑后再发布到代码平台。决策权在人、规则在本地、数据在本地。

✨ 新增

• 平台接入与 PR 发现
  • Bitbucket Server / Data Center 接入（REST API v1，>= 7.0）。
  • 轮询自动发现作为 Reviewer 的待评审 Open PR；按仓库分组、状态过滤、搜索。
  • 首启配置向导：引导配置代码平台连接 +（可选）LLM；缺有效连接时下次启动仍回向导。
  • 单例锁：二次启动聚焦已有窗口，不再多开。
• 本地 Diff 阅读
  • bare 镜像（按需 clone / fetch）+ Monaco 并排 / 内联 diff。
  • 文件树、行内评论、git blame、跨文件代码搜索。
  • GitHub 风格未变更段折叠。
• AI 评审（pr-agent）
  • 对话式驱动 /describe、/review、/ask，输出结构化成可操作的 findings。
  • 评审任务队列：串行执行、排队任务在 chat 内可见、随时取消、失败重试。
  • finding 行号锚点可点击跳转到 Diff 对应行。
  • 真实 token 用量采集（输入 / 输出分列）。
  • LLM 未配置时 chat 面板给出明确提示并禁用输入。
• 评审 → 发布闭环
  • findings → 草稿池 → 行内编辑（Monaco view zone）→ 单条 / 批量发布到远端。
  • 发布后远端评论自动刷新；重复发布幂等（发完即删本地草稿）。
  • 自己作者的远端评论支持回复 / 编辑 / 删除。
  • 远端可合并时一键合并 PR；审批 / 合并远端失败时弹 toast 提示，不再静默。
• 个性化规则
  • 每位 Reviewer 维护自己的规则目录（markdown + frontmatter），按项目 / 仓库 / 目标分支命中后注入评审。
• 多 LLM Provider
  • 适配并实测验证：OpenAI、Anthropic、DeepSeek、阿里百炼（通义千问）、火山方舟（豆包）。
  • 厂商原厂模型只填型号名即用（按 provider 自动补 litellm 前缀）。
  • ollama / openai-compatible 理论可行（待验证）。
  • 设置页连接 / LLM / 代理可视化 CRUD（草稿态「写入不启用」，保存或显式启用才应用）。
  • 出站 HTTP 代理：LLM 调用 / 代码平台 / git HTTPS 统一走代理，本地地址自动直连。
• 运行时与打包
  • 内嵌可重定位 Python + 固定版本 pr-agent，开箱即用，无需自装 Python / Docker（Docker 模式可选）。
  • 桌面安装包：Windows x64（NSIS）、macOS arm64（dmg，ad-hoc 签名、未公证）。
  • 对 pr-agent 的无侵入补丁体系：二进制安全 diff、新模型兼容、YAML 容错、token 用量采集等。
• 隐私与数据
  • 本地优先：除调用所配置的 LLM API 与代码平台外不向第三方上报数据。
  • 配置 / 状态 / 日志固定在 ~/.code-meeseeks/；仓库镜像目录可配置。

🔧 修复

• 修复只读安装目录（如 C:\Program Files）下 pr-agent 启动告警。

---

许可证：Apache-2.0。打包内含第三方组件（pr-agent、Electron 等），各按其许可证分发，见 NOTICE。