AtomCode eski sürümleri ve tüm sürümler

AtomCode v5.2.4 Release Notes
发布日期：2026-10-22
v5.2.4 聚焦于长任务的持续执行与恢复能力（/goal 中断恢复、运行中切换会话、后台继续工作），MCP 工具 schema 按需加载以降低上下文占用，并新增只读 IDE 语言服务桥接、手机访问 WebUI 与自定义 Provider 请求头；同时改善终端输入与长内容阅读体验、收紧插件与技能权限边界，并修复流式响应截断、执行轮数误判等多项问题。

⚠️ Behavior Changes（注意行为变化）
- 旧版终端界面 atomcode-tuix 退役：所有命令统一使用当前终端界面（TUI），旧的 --classic 启动参数与配置中的 ui.screen 选择项已移除，使用这些入口的脚本需相应调整。
- /worktree done 语义明确：只切回主检出并返回结果，不再自动把 worktree 改动合并/ squash 回主分支。
✨ 新增功能（Features）
长任务执行与恢复
- /goal 中断恢复与暂停检查点：长时间运行的任务可恢复执行，暂停时保留检查点；持续保留已完成工作、验证证据和待回答的问题，恢复后上下文不丢失。
- 目标状态可视化：区分执行、恢复、验证与完成状态，以状态标签展示目标进度；跨回合累计展示任务耗时与 token 用量，避免把验证中的回复误报为任务完成。
- 运行中切换会话：在终端切换历史会话时，正在执行的会话可留在后台继续工作，不必等待长任务结束。
- 委派轮数遵循配置：主任务与委派任务正确处理无限轮数设置；显式设置预算时在耗尽后汇总已有进度，避免复杂任务因隐含轮数上限提前停止。
MCP 按需加载
- 大型工具 schema 按需加载（默认启用）：MCP 大型工具 schema 通过 mcp_search 搜索后按需加载，减少每轮全量发送的上下文开销；支持放宽匹配数量并保留 schema 预算。
- 单个 MCP 服务重连：支持从服务详情面板重连单个 MCP server；重连过程可取消、不阻塞运行时响应，并如实展示服务启动中的状态。
IDE 语言服务桥接
- 只读 IDE 语言通道：新增与 VSCode 等编辑器的只读语言服务桥接，可利用编辑器已有的类型信息、定义跳转、引用查找与诊断能力；支持发现 IDE 窗口并查看桥接连接状态，未连接 IDE 时仍可使用原有文件与代码检索工具。
WebUI 远程访问
- 手机访问 WebUI：支持通过 HTTPS 中继从手机访问 WebUI，设备可处于不同网络、无需 VPN；局域网访问可在终端展示二维码，并同步修正远程访问指引。
Provider 接入
- 自定义 HTTP 请求头：账号级支持配置自定义 HTTP 请求头，适配需要特殊鉴权或网关头的接入方式。
- DeepSeek Messages 协议：新增可选的 DeepSeek Messages 协议支持。
- 思考强度档位：WebUI 接受模型声明支持的思考强度档位（包括 xhigh），保存模型设置后 live 会话即时同步。
终端输入与阅读
- 自定义换行快捷键：支持可配置的换行快捷键，恢复反斜杠加 Enter 换行并新增菜单入口；改善 Shift+Backspace、重复编辑按键与 Emacs 编辑行为，Ctrl+D 不再误伤草稿。
- 终端阅读器与视口翻页：新增阅读模式与视口翻页，长输出阅读更容易；手动导航时停止边缘自动滚动。
- 吉祥物图像：新增终端图像显示的吉祥物，支持点击切换图片，不支持图形协议的终端自动回退。
权限与安全
- 静态工具 allow/deny 策略：支持用户级和项目级 JSON 工具策略配置，可预批准插件 hook 命令。
- 技能 allowed-tools 预授权：技能 frontmatter 支持 allowed-tools 字段（含 allowed_tools 别名），为调用回合预授权匹配的工具；未列出的工具仍按常规审批处理，显式 deny 与敏感操作安全边界继续生效。
- 技能目录扩展：支持配置额外的技能根目录，并暴露技能加载诊断信息便于排查。
会话与上下文
- 分层记忆：记忆系统新增分层上下文、条目元数据与可恢复的 TTL 管理。
- 本地跨会话消息：新增本地跨会话消息能力，可向其他会话传递信息。
- 统一文件与历史引用：跨平台统一文件引用与历史引用（文件 / 会话分类提及）。
🛠 修复（Fixes）
流式响应稳定性
- 移除持续进展响应的默认总时长限制：修复长推理在 600 秒处被截断（dropped_before_terminal）的问题；统一首内容超时处理，改进断流后的有界续接与错误诊断，恢复耗尽时明确保留失败状态。
- 恢复预算共享：跨恢复层共享请求重试预算，避免重复消耗。
长任务与恢复
- /goal 证据与诊断：修复流失败诊断、验证证据保留与评估不确定性处理，目标命令完成前不再接受新的条件输入；目标标签变更与并发工作互不干扰。
- 委派与追问：修复追问（steering）问题后活动任务中断不再继续的问题。
- Rewind 更稳健：隔离缺失的检查点、保护快照根目录；诊断信息保留在日志中，失败提示更简洁。
MCP
- stdio 帧边界校验：在分配内存前先校验 stdio 消息帧大小，防止单条超大消息导致内存暴涨。
- 连接校验：校验保留的 MCP 连接，服务面板刷新按范围进行。
WebUI
- 技能列表刷新：重新打开技能菜单时刷新列表，不再显示过期缓存。
- 目录弹窗：修复切换工作目录弹窗中「创建」按钮被最近项目遮挡且无法滚动的问题。
- 共享问题同步：在终端回答的共享问题同步从网页解除等待；运行中的终端会话无需等待完成即可挂载查看。
- 会话分享：解除活动分享时不再遗留存活绑定；重启内嵌服务器时关闭旧 HTTP 连接。
- 实时 Provider 同步：保存模型设置后同步更新 live 会话，修复服务商 ID 修改后模型标签仍显示旧 ID 的问题。
终端渲染 / Windows 兼容
- Windows 输入加固：硬化 Windows 控制台输入与鼠标设置，拒绝不支持的管道输入后再接管屏幕；报告控制台句柄到终端诊断。
- 剪贴板串行访问：串行化 Windows 剪贴板访问，避免图片提示解码崩溃；新增可选的剪贴板崩溃诊断。
- 路径处理：修正 Windows 下主目录、规则与 hooks 的路径处理；修复非 root 用户残留 sudo 环境导致的主目录误判。
- MobaXterm：改善 MobaXterm 下的本地渲染效果。
- 代码块显示：长代码行换行显示、不再截断命令；代码块使用背景分组，复制时不再带装饰竖线（修复 ghostty 下的竖线复制问题），语言标签更醒目。
- 输入细节：修复 Todo 四项紧凑显示不全、补全在编辑或召回历史后不刷新、队列消息边界在紧凑预览中被破坏等问题；移除输入框鼠标选区带来的干扰。
- 失败状态灯：回合失败后保留红色状态灯；区分目标验证中与已完成的回复。
Provider / 网络
- 请求输入画像：新增 provider 输入画像，按模型约束调整请求内容；诊断中报告 provider 输入尺寸。
- 配置保真：旧 provider 的自定义 header 在投影与解析后保持不变。
- web_search 安全：禁用重定向并强制 HTTPS。
会话与配置
- 存储绑定：配置重载时保留会话的真实存储绑定，修复目录变化后的租约不匹配（LeaseMismatch）报错。
- 压缩来源标注：压缩保留的历史消息与摘要标明来源，避免被模型误读为新指令。
- 启动性能：减少并并行化 Git 初始化探测；自动升级准备不再阻塞终端启动；恢复的历史布局从尾部渐进渲染，首帧更快。
- 自动升级：安装回退版本从发布清单解析，修复 fallback 版本仍固定在旧版本的问题。
Plugin
- hook 脚本入口校验：插件 hook 校验脚本入口，信任与插件包内容绑定，支持经校验的脚本包装器；保留 hook argv 参数，支持通道类 hook 路径。
- 复制安全：拒绝符号链接与 Windows junction，目录复制分阶段安全进行，避免路径逃逸。
- 兼容状态：显示不兼容插件的提示状态。
- 性能：git 探测从每次操作一次降为每进程一次。
Agent / 工具
- grep 结果限额：限制保留的预览条数与总结果字节数，防止大结果集撑爆内存。
- LSP 消息边界：缓冲前先校验消息头大小；IDE 桥接受 vscode-userdata 存储。
- 审查委托：跨委托保留用户指令，审查不再丢失原始要求。
- VSCode 守护进程：避免接管外部的 daemon 进程。
- 凭据提示：Git 终端凭据提示与 bash git 凭据失败提示更明确，便于模型自行诊断授权问题。
- AtomGit 仓库查找：明确仓库发现与查询错误提示，支持查找公开仓库。
其他
- open_file 鸿蒙适配：鸿蒙 PC 上改用设备自身的 aa 命令打开链接。
- 离线发现：清理过期的对端队列、忽略离线的发现条目。
🔧 重构（Refactoring）
- 退役 atomcode-tuix：旧终端前端代码整体移除，命令由 TUI 接管并验证替换完整性，安装体积与维护面显著缩小。
📚 文档（Docs）
- 新增 IDE 语言桥接、DeepSeek Messages、分层记忆、本地跨会话消息、MCP 工具搜索、技能发现与静态权限模型等文档；更新 hooks、MCP、WebUI 远

AtomCode v5.2.3 Release Notes
发布日期：2026-10-13
v5.2.3 聚焦于网络中断恢复与终端交互体验：回复断流自动续接、静默超时后刷新连接池并限制重试总等待，同时补齐对话滚动条、复制、SSH 显示与 WebUI 数学公式渲染，修复历史会话恢复后命令失效和配置/凭据处理问题。

✨ 新增功能（Features）
Anthropic 原生缓存
- 原生 Prompt Caching：为工具、system 和对话历史设置最多 4 个缓存断点，跳过 thinking 块并保留签名，提升缓存命中率
- 用量解析补齐：正确累计流式输入与缓存用量，缺失字段保留已有数值，避免重复计数
回复断流自动续接
- 从已确认进度续接：连接重置、提前断开或 provider 流式空闲超时时，若当前请求已有正文或上一批工具已全部执行成功，且断流处没有新的工具调用或参数片段，可自动续接一次
- 不重复执行工具：续接中相同工具、相同参数与工作目录的已完成有副作用调用复用已确认结果
- 进度可见：恢复过程与超时恢复共用预算，支持取消，并在终端和 WebUI 显示恢复提示
静默超时连接恢复
- 刷新连接池：等待响应头超时且允许重试时，最多刷新一次连接池，避免继续复用已失效的连接
- 重试总预算：建立请求的重试与退避共用总等待预算，默认最多 180 秒，耗尽后停止自动重试；覆盖 OpenAI 兼容、Responses 和 Anthropic 请求
终端交互
- 对话滚动条：新增会话滚动条，支持点击和拖拽定位，空闲到底部时自动隐藏
- 复制更可靠：复制等待移出界面线程，修复 Linux 剪贴板复制、选择高亮残留与复制失败提示
- 置顶提问：用户消息滚出视口后，顶部固定显示当前回合提问的一行摘要，方便长对话中定位上下文；复制与导出保持原文
- 请求状态更明确：区分思考输出、等待重试倒计时、重新请求和持续无输出；Ctrl+O 直接展开/隐藏已收到的实时思考，展开时保持底部跟随
- 后台任务等待去重：同一任务连续无新输出的轮询合并为可展开的等待记录并显示检查次数，新输出、完成和失败独立保留
WebUI
- 数学公式渲染：支持行内与块级 TeX 公式（KaTeX）渲染；代码和货币文本保持原样，无法渲染的公式保留原始文本
- /webui --port 生效：TUI 中 /webui 支持 --port、--host、--no-open 参数，端口被占用时自动顺延探测
- 会话计数一致：项目侧栏计数与展开列表共用可见性规则，闲置空会话不再计数，fork 分支只计一次；添加工作区时复用已打开的会话，避免重复创建
记忆与偏好
- 完整查看记忆：/memory 在可换行、滚动、翻页的阅读面板中完整显示全局、项目和本地记忆，长工作流不再被截断；模型注入仍保留原有预算限制
- 模型偏好保存：按模型持久化思考开关与推理强度，重启后恢复；保存时校验模型支持的档位
命令与技能
- 命令与技能边界清晰：同名命令和技能按各自入口解析，内置命令保持优先，修复插件 command 覆盖同名 skill 的问题
- 斜杠命令可发现：插件命令出现在斜杠菜单中，输入历史支持召回斜杠命令
其他
- 编辑失败提示更简洁：原文未匹配时默认显示简短原因，点击展开完整错误和当前文件文本；模型仍收到完整恢复信息
🛠 修复（Fixes）
会话与命令
- 历史会话命令恢复：恢复历史会话后，/goal、/loop、/queue、/policy 和 /worktree 保持可用；新建会话、切换项目和重建运行时也保留同一命令入口
- worktree 使用当前项目：/worktree 根据当前会话目录操作 Git 仓库，避免恢复会话或 /cd 后仍操作启动时的仓库
Provider / 网络
- 静默连接恢复：等待响应头超时后刷新连接池并共享重试预算（见新增功能），改善「响应中断 / Connection reset by peer」与「网络连接失败」类问题
- OpenAI 兼容流续接：传输中断后从已确认的工具结果继续，不丢弃已完成的进度
终端渲染 / 兼容
- SSH 显示：恢复 Linux 和 SSH 下的吉祥物显示，清理通知中的终端控制字符
- 链接交互：修复 cmux 中链接悬停手形不稳定，以及选择文字后链接信息丢失
- 右键菜单：右键菜单不再随鼠标释放意外关闭
- 滚动条几何稳定：修复抓住端点滑块时跳动，以及动态任务面板导致的滚动条位置变化
- 显示细节：回复首尾多余空行不再占据展示空间；编辑不匹配信息折叠展开不再隐藏恢复细节
Windows 兼容
- Bash 工具优先级：优先使用 Git Bash 的 POSIX 工具，避免 find、sort 被 System32 同名程序抢占导致 GNU 语义失效
- 端口顺延：WebUI 默认端口落在 Windows 保留范围（错误 10013）时继续顺延探测，不再直接启动失败
任务与凭据
- 任务异常不再误报成功：one-shot Agent 的任务 panic、异常取消或缺失回合终态返回明确内部错误，保留已产生的内容和工具结果；终端、无界面、网页及 ACP 补齐失败映射
- 配置文件校验：显式指定的配置文件不存在时明确报错，覆盖交互、无界面和 ACP 入口；不再误报为 URL 错误
- 凭据脱敏：录制输出脱敏覆盖带引号的密钥内容
- 签名能力校验：源码构建缺少官方网关签名能力时明确拒绝请求，避免进程崩溃
🔧 重构（Refactoring）
- provider 客户端可替换：Anthropic 与 OpenAI 兼容 provider 的 HTTP 客户端支持在超时恢复时重建连接池，为静默连接恢复提供基础
📚 文档（Docs）
- README（中英文）补充 /webui --port、--host、--no-open 的用法说明与端口顺延规则
- 站点文档与搜索索引同步更新至 v5.2.3

AtomCode v5.2.2 Release Notes
发布日期：2026-10-10
v5.2.2（同源版本 v5.2.0，覆盖自 v5.1.0 以来的全部改动）聚焦于架构与终端界面的重构：运行时重写为分层结构，所有前端共用同一个运行时，会话改为可完整恢复的事件记录；全新的全屏终端界面成为默认，设置、模型、MCP、插件、后台会话都收进了面板。

✨ 新增功能（Features）
全新架构与运行时
- 分层运行时：运行时按「智能体循环 / 能力装配 / 编码运行时」分层重写，旧引擎整体退役；终端、网页、VS Code、ACP 共用同一个运行时，各端行为一致。
- 会话事件化：会话改为逐条事件记录，撤销、回退、压缩都作为新记录追加，不改写历史，中断或崩溃后可以完整恢复。
全新终端界面（默认开启）
- 全屏界面：直接运行 atomcode 即打开新版全屏界面，旧界面可用 --classic 或配置 [ui] screen 切回。
- 鼠标操作：支持点击、双击选词、三击选行、右键菜单，跨屏拖拽选中并自动滚动，链接和文件路径点击即可打开。
- 会话标识：终端标题和标签页显示会话名，并标出哪个会话在等你。
设置与管理面板化
- /config 设置面板：包含设置 / Config / Status / Usage / Stats，可查看额度、每日用量和各模型用量。
- /provider 账号与模型管理：保存后自动检测连通性，添加模型时可按 Ctrl+F 从服务端拉取模型列表选择。
- /mcp 面板：逐个启用、停用 MCP 服务器。
- /toolbox / /plugin / /status：在会话中开关单个工具、管理插件、查看登录账号与订阅到期时间。
后台会话与团队协作
- /background（/bg）：把当前会话放到后台继续跑，可分组查看、切换、取回；后台会话在团队面板中列出，空输入框按 ↓ 直接进入。
- /review 后台评审：默认在后台评审，不占用当前对话。
- 后台提问前移：后台会话的提问会出现在前台，可就地作答。
- 团队面板：列出主会话、成员和子代理的状态、耗时与上下文用量；成员会话会保存，重启后随主会话一起恢复；拆分成员容量与子代理并发上限，并讲清成员生命周期（空闲也占名额，用完需 stop）。
会话管理增强
- /resume 增强：可预览会话最后聊了什么，按两次 Ctrl+D 删除会话；项目文件夹改名后会话不再丢失。
- 回退与回溯：双击 Esc 打开回退面板；在 Git 仓库里 /rewind 默认就能连代码一起回退（设 ATOMCODE_CODE_REWIND=0 可关闭）。
新增与增强命令
- /changelog：在面板里查看各版本更新内容（概览与 Issues 两个页签），升级后首次启动提示一行亮点。
- /worktree：新建独立工作副本并切换过去。
- /diff 与 /diff git：查看本会话和工作区的改动。
- /loop 5m：按固定间隔循环执行。
- /todo add、/todo clear：直接修改计划。
- /cost：按模型分列 token 账单。
- /copy 与 /copy code：默认复制最后一条回复全文，/copy code [N|all] 复制代码块。
- /raw：把整段对话输出到终端自己的屏幕，方便用终端自带的跨屏选择。
- !cmd 与 ✻ Done 行：在本机直接执行命令，回显 ! 打头、输出紧贴命令，跑完收一行 ✻ Done 汇总耗时。
- /cd：目录跟着会话走，支持书签和最近目录。
- 其余命令补齐：新界面支持 /proxy、/schedule、/openrouter、/app、/webui、/sync，/upgrade 可就地升级并重启；Ctrl+Z 挂起回到 shell，fg 返回；斜杠菜单按使用频率排序。
WebUI 模型配置重做
- 按服务商分组：一张卡片填完服务商和模型，保存后自动检测连通性。
- 推理强度档位：可为模型设置可选的推理强度档位与默认档位，聊天里的档位选择据此出现。
- 启动引导：服务没在运行时，桌面应用显示启动引导；atomcode webui 新增 --no-open 参数。
模型与思考强度
- 快速切换：F2 / Shift+F2 快速切换模型，切换后可直接选择思考强度；/effort 只列出当前模型支持的档位。
- 思维链保留：保留 GLM、Qwen 的思维链；流式解析识别 vLLM 的 reasoning 字段，思考按服务端使用的名字回传。
- OpenRouter：授权过就不再每次跳浏览器，已下架的模型不再出现在列表里。
交互体验优化
- 输入框：支持粘贴截图和图片路径，大段粘贴自动折叠；Ctrl+R 搜索本项目的输入历史；Ctrl+X 中断当前回合并立即发出排队的消息。
- 工具展示：写入和编辑文件的工具调用直接展开显示 diff；/changelog、技能上下文等面板内容折叠展示。
- sudo / ssh 密码输入：工具里的 sudo、ssh 会在输入框里请你输入密码，不再卡住。
🛠 修复（Fixes）
权限 & 安全
- 读取凭据、密钥、.env 等敏感文件前先请求审批；工具策略中加固了解析后的凭据路径。
- 委派出去的子代理有明确边界。
- 工具调用与结果之间不再夹注入消息——切到严格 provider 的会话不再每请求 400。
稳定性
- 重复调用熔断更温和：不再把「等长任务」当死循环误判，可用 [coding] repeat_stop_rounds 调整阈值。
- 图片预算：一次请求带的图片数量有上限并自动压缩（单张约 512KB，413 时减半重发），不再因请求过大失败；预算按 4 张一步裁剪，不再打穿提示词缓存。
- token 统计：按请求累加的 token 改用 u64，跨过 u32::MAX 不再饱和失真；回合结束的缓存命中率与花费按本轮每次请求累加。
- bash 后台进程的输出与结束更可靠：后台进程在命令返回后照常写输出不被杀，Windows 上命令正常结束不再误杀拉起的进程，bash_kill 能停掉作业留下的进程。
- MCP 外部输入边界加固，单个 MCP server 故障不再导致整个会话崩溃。
Provider / 网络
- 正确识别网关误标与模型权限探测响应，避免把合法响应当校验错误。
- 浅色终端可读：[ui] theme 接入新 TUI，256 色按对比度取色。
- 登录连接失败时区分「解析器配置不可读」并给出对应指引；i18n auto 模式根据系统语言兜底并跳过通用 locale。
终端渲染 / Windows 兼容
- Windows 传统控制台、颜色、按键与框线全面兼容：VT 输出先开启、宽字符不写最后一列、超宽行不再把整屏顶上去、豆腐块与吉祥物正常显示。
- 控制台画不了新界面时自动退回经典界面并说明原因，不再被 TERM 环境变量骗过。
- Windows 上 Ctrl+C 选区复制不再被取消操作拦截；VS Code / JediTerm 上不再请求 Kitty 键盘协议，按 Esc 不再打出 [27u。
- 鸿蒙 PC 适配：鼠标默认留给终端、滚轮翻页、Ctrl+V 由终端粘贴文字、欢迎页按键提示与剪贴板提示更准确。
- 修复表格渲染不完整、链接边界越界吞入尾随字符、思考正文颜色落错槽位等问题。
升级器
- Windows 上 /upgrade 不再因旧版本进程占用而「拒绝访问」：自动换空槽位、清理残留，第一步被拒时提示指向安全软件。
WebUI
- 登录不再静默失败：授权页打开情况、失败原因、webui 重启都在页面上说清。
- 旧内核浏览器（Chromium 99 起）可正常使用；无 token 打开时给出引导页。
- 会话被另一个 atomcode 占用时说清是哪种情况，同步模式可复制一份继续。
- atomcode webui 启动失败或服务停止即退出（非零），并把绑定与退出原因写进日志。
- 接口失败不再当成功数据，审批没送达不再静默关卡片。
TUI 交互
- 回合进行中被拒的命令说清要等这一轮、按 Esc 可先停；/compact 说明会在回合后执行。
- 面板打开时滚动对话不再卷走面板；问询在屏时往回翻对话，问题钉在底部不再被卷走。
- 中断提示、/model 选中项、右键菜单位置等展示细节修正；skill 调用输出按序整理、不再重复回显。
🔧 重构（Refactoring）
- 运行时与前端分离：引入 atomcode-harness / atomcode-host-api / atomcode-tui 新 crate，旧 atomcode-clix 退役；产品身份、宿主插件与配置层改由宿主传入（PrepareOptions.identity / host_plugins），用户级 mcp.json 与 mcp_auth.toml 可由宿主自行保管。
- 配置收敛：服务商账号与模型的增改删收进 atomcode-config::provider_book，TUI 与 WebUI 统一走它。
📚 文档（Docs）
- CHANGELOG 补齐 v4.22.3 以来各版本的概览、发布日期与对应里程碑 Issues。
- 新增架构与 TUI 设计相关的 ADR 文档、MCP 面板设计与 hooks 文档更新。
🧹 工程 / 构建
- 清理 Windows / macOS 构建警告（未用导入、链接输出、crossterm 警告）。
- 新增 gate

AtomCode v5.2.1 Release Notes
发布日期：2026-10-01
v5.2.1 是一个回退修复版本：将代码基线整体回退到 v5.1.0，版本号升至 5.2.1，并同步修正站点文档中的版本展示。遇到 v5.2.0 问题的用户建议升级到此版本。

⚠️ Behavior Changes（注意行为变化）
- 回退到 v5.1.0 行为基线：v5.2.0 引入的改动已全部撤回，产品行为恢复到与 v5.1.0 一致。v5.2.0 新增的界面与快捷键不再可用，包括：新版 atomcode --tui 界面（Ctrl+O 推理显示切换、Ctrl+T 工具输出分组、Ctrl+G 鼠标移交）、经典界面的 Ctrl+O 工具输出/推理显示开关、Windows 下 Ctrl+Alt+V 粘贴剪贴板图片。剪贴板图片粘贴统一回到 /paste 命令方式。
🛠 修复（Fixes）
稳定性
- 回退至 v5.1.0 稳定基线：将代码整体回退到 v5.1.0（72b538e8c），规避 v5.2.0 引入的问题
📚 文档（Docs）
- 站点 getting-started 横幅中的版本号由 5.1.0 更正为 5.2.1

AtomCode v5.2.0 Release Notes
发布日期：2026-10-01
v5.2.0 是本年度最大的一次版本更新，核心是全新 TUI 成为默认界面（建立在"一切皆插件"的新运行时之上）、异步 Agent 团队、后台会话、可配置的安全授权模型与多语言界面；同时在 MCP 管理、工具输出治理、Provider 连通性与启动性能上做了大量加固。

⚠️ Behavior Changes（注意行为变化）
- 默认界面切换：直接运行 atomcode（不带参数）现在打开新的全屏 TUI；旧的 tuix 界面移至 --classic 参数保留，功能仍然可用。
- 装配链移除：coding runtime 只保留行清单（parts::prepare → runtime::mount）这一条装配路径，原先的 ATOMCODE_ENGINE 引擎选择开关与手写中间件链已删除，不存在第二套装配或引擎回退。
- 授权语义收紧（安全）：[permissions] allow 配置规则不再等同于"人工当场批准"。此前配置放行与人工点允许产生的授权凭据无法区分，导致在 credential_shell = "strict" 下配置化的 Bash(curl *) 放行会连带解开凭据闸门。现在便利闸门只问"是否已决"，安全边界只认"由人批准"。

✨ 新增功能（Features）
全新 TUI（默认界面）
- 全屏新界面：基于自研布局引擎的新 TUI，支持 flex 布局、绘制原语、终端能力探测与鼠标交互；首次以 --tui 启动时在开场提示末尾列出按键说明
- 审批可视化：屏幕内直接完成审批（无需 yolo 模式即可真实使用）；审批答完后默认收成一行 ● bash … → 允许一次，可点击展开查看详情
- 工具调用折叠：写/改类工具调用不折叠、直接展开画 diff；点一个调用只展开这一个；折叠调用与在跑的一组调用共用同一套展开逻辑
- 后台会话面板：/bg 会话放到后台继续跑，面板分组查看、切换、召回、丢弃；状态栏显示后台在跑数量；空输入框按 → 打开后台面板；后台干完的结果回到发起它的那段对话
- 提问面板：完整兑现 request_user_input 承诺——多选、自己输入、纯文字题、批量分页；输入行支持光标移动就地改错
- 思考强度控制：/effort 改用面板自己的列表（不再是弹窗）；/model 切换后若新模型声明了思考强度则递上档位选择；角色可声明自己的思考档位
- 回合结束条：显示结束时刻、耗时、轮数、工具数与缓存命中（如 ✻ Nailed it 21:42 · 12.5s · 1 轮 · 0 工具 · 2.70K tokens · 98% cached）
- 面板化界面：/agents、/cd、/diff、/view、/proxy 不再弹窗，改为底部内联面板；引导与配对向导也画在底部
- 会话共享：/webui、/sync、/desktop、/app（扫码把会话给手机）在新界面中可用；经典界面专属功能会明确提示暂住 --classic
- 其他增强：单击对话中的链接直接在浏览器打开；发出去模型未回复时按 Esc 可把那句话撤回输入框并从对话中移除；! shell 模式对齐经典界面（框变色、底部提示、输出边跑边画）；Ctrl+T 展开档连同已答审批一起展开；Ctrl+B 中断当前轮并让排队输入立刻执行
"一切皆插件"运行时（plexus）
- 新运行时 crate：引入 atomcode-plexus——面向行的可组合运行时，每个面板、每个工具、每条命令都是一行
- 能力即行：工具、技能、斜杠命令、MCP 服务器、审批闸门、压缩策略、人格（persona）、code_review、tool-web 等都以行注册，可在运行中替换或卸载单个行
- 运行时布局：atomcode-tui 提出运行时布局词汇表，模态可在运行中替换整行插件；斜杠命令由行贡献，UI 只负责发现、显示与分发
- 目录收口：可按名字收口目录——卸载、替换单个工具，MCP 也能逐个挑选；会话进行中可关闭/放回单个工具
异步 Agent 团队
- 团队运行时：多角色异步并行协作，补齐产品化 14 个角色，并发上限、事件有序分发与优雅取消
- 角色与模型：角色声明自己的思考档位，成员按角色跑；委派子 agent 可指定 provider 与模型
- 安全边界：委派出去的 agent 有硬边界——不跑 shell、不再委派、敏感路径与越界写直接拒绝；Worker 作用域按参数计算
- 团队面板：实时展示各成员的角色、模型、活动状态与真实输出 token；队列中成员详情可见
- 借力 Claude Code 三条：角色是数据、同伴消息非用户来源、Worker 各得独立 worktree
后台会话（/bg）
- 会话放到后台：/bg <任务> 与 /background 让会话在后台继续跑，不占用当前对话
- 后台问询：后台会话挂着的问询可在前台就地答复，或按需取回；前台答掉后台问询会当场报列表
- 结果回落：后台干完的结果以"另一个会话"身份回到发起它的那段对话；/review 默认在后台会话里跑
- 退出提示：后台还在跑时退出会先问一次；未回收的后台结果在退出时留一行提示
安全与授权
- 授权说清是谁批的：ToolExec 的布尔 pre_approved 替换为三态 Authorization（No / Presumed / ByPerson），便利闸门与安全边界各自问自己该问的
- 凭据不外泄：Provider 错误链中的请求地址会去掉凭据，不再进入屏幕、会话日志与 atomcode.log
- 审批授权精确化：/live/permission 的"始终允许"只授给真正在等的那次审批涉及的工具
- 凭据管理：/logout 真正删除凭据（删键而非写空值）；清凭据时先把会话从共享中收掉
- 启动安全提示：绕过审批、root、离线、未信任插件钩子四条启动提示在默认屏上恢复显示
MCP 管理
- 面板与命令：/mcp 面板支持列表、详情、启停、认证状态展示；新增 McpAct 动作枚举与对应命令
- 就地写回：仅修改单个服务器的停用状态，就地写回配置文件
- 认证与停用状态：McpServerState 增加"需要认证"与"已停用"两个变体
- 未接端口提示：未挂 MCP 面板时给出明确文案，并区分"筛空了"与"本来就没配"
工具与配置
- 工具输出截断可配：[tools.output] threshold_bytes 可在 config.toml 配置截断阈值，截断提示标注"第几段/共几段"
- fetch_output 分页修正：按字符边界分页，中文输出的页边不再劈出乱码；limit 0 读取默认一页
- /config 完善：新增 ui.mouse 开关（关闭后交还终端做选择，方便复制）；支持恢复默认
- /todo 增强：/todo add <任务> 与 /todo clear 让用户在回合之间直接改计划，无需重写对话；列出计划清单含已完成项
- /loop 节奏可控：/loop 5m 由人指定节奏
- 工作树：/worktree <名字> 开一个自己的 checkout 再换过去干活；进入自己的 checkout 后只围写、不围读
- /cost 恢复：按模型分列的 token 账单（不再是 /context 别名）
- 工具循环熔断：默认 stop 阈值 4→5，去掉第 3 次打扰提醒，停止文案更友好可操作
多语言界面（i18n）
- i18n crate 抽取：屏幕所说的每一句话都走词表，抽出独立叶子 crate，两张表一个 locale
- 文案补齐：MCP 面板 24 条文案、/mcp、屏幕提示等中英文齐备
其他
- 会话桶持久标记：文件夹改名不再丢会话，/resume 跨桶时把当前文件夹钉到会话所在桶
- 工具输出落盘：超长工具输出落盘而非塞满上下文
- 敏感路径审批：只读工具在触碰凭据、密钥、.env 前先走审批闸门
- 系统通知：两个开关真正生效
- /compact 增强：摘要由对话模型按焦点撰写并计入会话用量
- /init 归行：失败的压缩会明确说话
🛠 修复（Fixes）
TUI / 终端渲染
- 一帧性能：不再走完整个会话——滚动一帧从 20.7ms 降至 0.72ms（debug）；一帧只物化屏幕那几行、只编码改动的行；结算块记住自己的行数，滚动只花一屏
- 布局与重叠：工具执行进度条计入布局计算，不再与正文错位或残留幽灵块；面板浮在布局上不再挤走对话
- 滚动与输入：滚轮/↑↓ 滚动对话、ctrl+p/n 翻历史；Ctrl+O 在每个收键阶段都能切换详细模式
- 折叠一致性：点一个工具调用只展开这一个；折叠调用与在跑的一组调用共用同一展开逻辑；意图行用正文色、命令行退成灰色
- 审批面板：矮屏时优先保住选项行，不再被长命令挤掉；审批卡画出命令全文
- muted 可读性：灰色文本在 Catppuccin Mocha 等配色下不再与正文一样亮；思考折叠行自带展开/收起提示，正文改用更暗一档
- 限流提示：对齐经典界面——等待中说中文、窗口用尽带剩余时间与去路、别家 429 不再留空
- 渲染细节：圆角标签间距、长任务预览换行、批量编辑 diff 显示、空答案光标位置、无 unicode 终端键名不再说错
- 模型与状态行：/model 记录新选择后重标 providers 列表；状态行的 provider 前缀只认会话自己的那一行；同名模型时状态行

AtomCode v5.1.0 Release Notes
发布日期：2026-09-18
v5.1.0 聚焦于 OpenRouter 免费模型一键接入、代码回滚（Code Rewind）以 opt-in 开关重新启用、Bash 后台任务与权限预授权规则、OpenAI Responses API 支持，以及会话恢复提速、TUI 状态栏与终端渲染的大幅打磨，另修复多项 Provider 流式稳定性与安全问题。

⚠️ Behavior Changes（注意行为变化）
- 代码回滚（Code Rewind）默认关闭：/rewind 相关能力现由环境变量 ATOMCODE_CODE_REWIND=1|true|on|yes 显式启用（默认关闭），需要使用时请设置该变量。
- 裸 bash 调用 AtomGit API 不再单独拦截：移除了 AtomgitBashGate，此类调用改由通用审批/凭证守卫覆盖。
- npm 平台包改为独立包名发布：平台子包更名为 @atomgit.com/atomcode-{os}-{arch} 并补齐 bin 字段；如曾遇到升级后 atomcode 命令丢失，升级到本版本即可修复。
✨ 新增功能（Features）
OpenRouter 一键接入
- /openrouter [key] 命令：不带参数走浏览器 OAuth（PKCE）授权，带参数直接使用已有 API Key；授权 URL 会在终端显示，浏览器未自动打开时也可手动访问。
- 自动发现免费模型：接入后自动拉取并按能力过滤（tool-use + 文本输出）Top 5 免费模型落盘配置，额度用尽或新用户未领 CodingPlan 时会引导跳转。
- 额度用尽提示：额度耗尽时 nudge 引导接入 OpenRouter 免费模型，ESC 可取消连接流程。
代码回滚（Code Rewind，opt-in）
- 受控重新启用：捕获受磁盘下限（≥2 GiB 可用空间）与快照总预算（500 MiB）双重熔断保护；自动跳过大文件与构建/依赖目录。
- 存储去重：通过 Git alternates 共享真实仓库对象，不再全量复制。
- /rewind purge 与容量报告：支持手动清理回滚存储，超预算时自动跳过并告警；/rewind purge 需显式 opt-in 确认。
Bash 后台任务
- bash_start / bash_poll / bash_kill 三个新工具：可启动脱离前台超时上限的后台任务，跨工具调用存活，模型通过轮询获取增量输出；输出按尾部有界截断（256 KiB），并发上限 64，孤儿进程由平台进程组/作业对象兜底回收。
- 门控一致：后台命令与前台 bash 走同一套工作区 / 凭证 / 推送标签中间件，无法绕过审批。
权限预授权（[permissions]）
- 用户声明的 allow/deny 规则：语法与 Claude Code 的 permissions.allow/deny 兼容（如 Bash(git *)、Read(~/.zshrc)、mcp__server__tool），从 CC settings.json 复制即可用；deny 优先，allow 永不作用于敏感路径。
- 「总是允许所有 Bash」审批选项：审批面板新增 allow-all-bash 危险选项，会话内对前后台 Bash 一致生效；重新弹出的审批会透明展示授权原因，bash 命令支持 Tab 折叠/展开查看完整命令。
Provider 支持
- OpenAI Responses API：新增 /v1/responses wire 适配器（系统消息→instructions、工具/工具结果的 Responses 编码、response.* SSE 流解码），与 chat/completions 共享连接池、TLS 与重试语义。
- Ollama 上下文钉住：ATOMCODE_OLLAMA_NUM_CTX 显式钉住运行时窗口，避免声明窗口与守护进程默认不一致。
- OpenCode Zen 兼容：请求自动补发 x-opencode-session 头。
Agent / 工具
- 代码图谱支持 Kotlin：list_symbols / read_symbol / trace_callers 等工具新增 .kt / .kts 支持。
- 索引超限可操作报错：codeintel 索引扫描增加目录排除与文件数 / 字节数上限（默认 20k 文件 / 256 MiB），超限时返回明确指引而非静默空图（#1538）。
- edit_file 匹配失败回传现场：匹配失败时返回文件当前对应片段，帮助模型自我纠正。
- list_sessions 新工具：枚举本项目历史会话（标题/时间/大小），补上 recall 只搜内容的缺口。
- /worklog 每日工作复盘：跨项目汇总当日完成的回合、耗时与工具使用，生成固定模板的工作小结。
- AtomGit 工具扩展：atomgit_issue 新增 update / close 能力；atomgit_pr 新增 list_mine（列当前用户 PR）与 update（改 PR）能力。
- 弱模型容错：request_user_input 的 mode 可省略、按 options 自动推断；signpost 只报任务动作，静默注入内容，减少弱模型朗读系统提示。
会话与记忆
- 机器本地记忆层（local tier）：记忆新增 local 级别（global > project > local），存于 .atomcode/local/ 并自动 gitignore，适合本机独有、不希望提交的事实。
- 会话轨迹端点：daemon 新增只读 session transcript 端点，可回溯未压缩的完整轨迹（#1538）。
TUI
- 状态栏 cache% 命中率：实时显示当前回合缓存命中率，resume / -c 后从会话 meta 恢复累计，回合结束后持久保留上一轮比例；缓存占比改为金色高亮。
- 状态栏改版：左组配色 + 竖线分隔 + 宽度自适应降级；按需展示模型所属渠道（同名才显示）；推理型模型首次思考显式显示 Thinking，spinner 增加 tok/s（按当前生成阶段计算）。
- 运行指示灯：运行中工具圆点白↔灰呼吸灯（~1.2s），完成转绿；footer 完成的 subagent 填充空槽而非消失，始终显示全部 3 个。
- 无框对齐表格：低对比度分段分隔线，列对齐的表格渲染。
- /copy 增强：无代码块时提示用 /copy msg 复制整条回复。
- 模式切换键可配置：ui.mode_switch_key 支持 shift_tab / tab，鸿蒙平台默认 Tab。
CLI / Headless
- resume <id> 跨项目切换：按会话 ID 恢复时自动切入会话所属目录。
- 配置项扩展：network.upstream_retry_max_attempts（上游重试次数，0–20，配合 Retry-After 缓解中转站瞬时 503 断流）可经 /config 调整；整数型配置项支持清空恢复默认。
Daemon / 安全
- --no-auth 启动选项：支持关闭 daemon 鉴权；同时新增纵深防御——「未鉴权 + 非本机绑定」默认拒绝启动，需显式设置环境变量确认。
- 端口占用提示：daemon 启动失败时明确指向被 IDE 插件占用的 13456 端口。
🛠 修复（Fixes）
稳定性 / 会话
- -c / resume 启动提速：先只扫当前 bucket、未命中再全量，并行化 catalog 扫描使 /resume 列表提速 ~4x；跳过 sidecar 解析并收敛目录日志。
- 未知 context_window 兜底：模型切换后用保守窗口兜底，避免超窗 400。
- 空取消不再污染下一回合：preserve 模式只保留有产出的回合。
- todo 列表 sidecar 持久化：compaction 后模型与 VSCode 面板不再丢失 todo。
- 溢出压缩豁免最近的 read_file：刚读过的文件不再被折成一行摘要。
- 截断与工具调用同轮时 finish_reason 不再丢 length；截断续写检测在 re-dump 后不再盲目续写，避免弱模型空烧 token。
- /loop 熔断：空/无语义目标连续无进展时熔断，不再死循环。
Provider / 网络
- 首字节超时与逐 token idle 超时分离（phase-aware 看门狗）：prefill 阶段用 first_token 预算（慢本地模型不再被误杀），四家 provider 统一收拢到一处；子代理 / team / review / CLI provider 全部接上 first_token_timeout。
- 流式 index 上界防护：Anthropic content_block 与 OpenAI tool_call 的 index 加上界，防恶意 index 导致 OOM。
- 良性 EOF 不再误报中断：流已完成后的 close_notify EOF、stop_reason 后的良性 EOF 不再报「响应中断」。
- 部分响应中断提示可操作：明确告知「直接回复即可继续，无需重开会话」；流式空闲超时的重连提示指向 ATOMCODE_STREAM_TIMEOUT_SECS，prefill 重连提示指向 first_t

Release v5.0.9

AtomCode v5.0.8 Release Notes
发布日期：2026-08-20
v5.0.8 聚焦于 TUI 文本选择与拖拽体验（双击选词、三击选行、工具块复制、拖拽卡顿消除）、Plugin Hook 事件补齐（PostToolUseFailure / Stop / StopFailure）、WebUI 交互打磨（项目级新建会话、通知去重、局域网访问修复），并新增 Zhipu Coding Plan 与 Ollama 支持、可配置品牌名及输出截断防护等多项稳定性改进。

⚠️ Behavior Changes（注意行为变化）
- TUI 鼠标捕获改为默认关闭（opt-in）：此前在受支持终端（kitty、WezTerm、iTerm2、Windows Terminal 等）上默认启用应用级鼠标捕获，现改为默认关闭，回归终端原生的鼠标选择 / 复制 / 粘贴 / 双击行为，在各终端表现一致。需要应用级鼠标选择（双击选词、跨区块复制、点击定位光标）时，设置环境变量 ATOMCODE_MOUSE_SGR=1 重新启用（dumb 等不支持的终端即使开启也会被硬性拦截；OSC52 键盘复制不受影响，仍按白名单默认开启）。

✨ 新增功能（Features）
TUI 文本选择
- 双击选词 / 三击选行：双击选中单词（CJK 连续文字按整体选中）、三击选中整行（含软换行链），选中即复制
- 工具块可拖拽选中复制：bash 命令、输出与工具头均可拖拽选中并复制，复制内容自动剔除 ● / └ / ⎿ 等装饰性锚点字符，保留命令与输出原文
WebUI
- 项目内新建会话：工作区项目行以 (N) 内联展示会话数，hover 项目行出现「在此目录新建对话」按钮，可直接在该项目目录开启新会话（不收起已展开的项目树）
Provider / 网络
- Zhipu Coding Plan 预设：新增 Zhipu Coding Plan 一键预设，指向 Coding Plan 专属端点（/api/coding/paas/v4），与普通智谱 token 端点区分，使用同一 ZHIPUAI_API_KEY
- /provider 支持 Ollama：添加 / 编辑 provider 的协议切换由 OpenAI ↔ Anthropic 两值变为 OpenAI → Anthropic → Ollama 三值循环；切到 Ollama 时自动补全本地端点 http://localhost:11434 并隐藏 API Key 字段（用户已填写的地址不会被覆盖或清空）
Agent / 工具
- read_file 多段读取：新增 ranges 参数，一次调用读取多个不连续行区间，减少弱模型的分页往返；所有区间共享单个输出预算，超限时提示剩余区间可继续请求
- 大文件大纲精准跳转：文件大纲（skeleton）为每个符号标注精确的 offset / limit，并给出可直接套用的 read_file 调用形态，模型无需猜测行号
Code Review
- 审查进度显示：/code-review 进度行实时显示 round X/N 与累计 findings 数，审查过程可感知
Plugin 生态
- 新增 PostToolUseFailure 事件：工具调用失败（is_error）时触发，插件可区分工具成功与失败，payload / 改写语义与 PostToolUse 一致
- 新增 Stop / StopFailure 事件：每回合结束时恰好触发其一——正常结束（含安全熔断、用户取消、限流暂停）触发 Stop，因 API / Provider 出错（ProviderError / Timeout）结束触发 StopFailure；payload 携带 stop_reason、transcript_path 与 stop_hook_active，atomcode hooks CLI 子命令同步支持测试这些事件
配置
- 可配置品牌名：[ui] brand_name / [ui] oauth_provider_name（或环境变量 ATOMCODE_BRAND_NAME / ATOMCODE_OAUTH_PROVIDER_NAME）可自定义界面与 CLI --help 中展示的品牌名和 OAuth 登录名，{brand} / {oauth} 占位符在 i18n 文案与命令描述中统一替换
🛠 修复（Fixes）
TUI / 终端渲染
- edit_file「未匹配」类错误弱化为黄色警告：可自愈的失败（bash 退出码失败、edit_file 未匹配 / 文件未修改等）改用警告色显示，不再呈现红色硬错误；真正的工具分发失败（参数解析错误等）仍为红色
- 带圈数字按全宽计数：①–⑳ 按 2 格全宽字形计算宽度，修复带圈数字与后续字符（如「③的」）重叠
- 用量提示过期守卫：滚动窗口重置后，右下角「Token 使用量」提示不再滞留不消失（按距上次拉取的时长与重置剩余时间比对，时区无关）
- 滚动后误判双击：滚动 / 重排（SIGWINCH）后清除上次点击记录，同一坐标的点击不再被误判为双击
- 选中改用实心主题色背景：文本选中由 SGR-7 反显改为实心主题色背景（深色主题深蓝、浅色主题浅蓝，NO_COLOR 时回退反显），避免选中区内不同前景色导致背景碎片化
- 消除拖拽选择卡顿：合并连续拖拽事件，拖到末尾不再越来越卡
WebUI
- 项目行「+」新建后不再收起：在新项目目录新建会话时不再闪收已展开的项目树
- 修复「加载中」僵尸行：其他目录项目在重载覆盖后不再永久卡在「加载中」
- 命令通知去重：恢复 / 确认失败等命令通知在尾部的通知连续段内去重，daemon 不可达时不再刷屏堆叠（真实内容出现后重置，后续真实重复仍会显示）
- 局域网 HTTP 访问修复：crypto.randomUUID 在非安全上下文（局域网明文 HTTP）不可用导致发消息崩溃的问题，改为带 getRandomValues 回退的 UUID v4 生成
会话
- /resume 占用会话自动 fork：交互式 /resume 命中被其他运行时占用的会话时，自动复制一份继续（对齐 --continue 行为）；复制失败（如源会话尚未完成格式收敛）时降级为熟悉的「in use」提示
Agent / 上下文
- 工具调用截断守卫：模型在 finish_reason=length 输出截断时发出的工具调用（参数可能不完整）一律不执行，并以错误结果引导模型拆分写入（先写首段、再以 edit_file 追加），避免半截命令 / 文件被落盘
- use_skill 携带技能安装路径：模型调用目录型技能时，展开内容附带安装路径提示，可直接解析技能自带的 scripts/ / references/，无需再在工作目录中重新搜索
📚 文档（Docs）
- README（中英）重构安装章节：新增官方安装脚本（PowerShell install.ps1 / shell install.sh，支持 ATOMCODE_VERSION / ATOMCODE_PREFIX 覆盖）、WebUI 前端构建步骤、官方 CodingPlan 闭源签名与自建二进制差异说明
- hooks 文档补充 post_tool_use_failure / stop / stop_failure 事件说明

AtomCode v5.0.7 Release Notes
发布日期：2026-08-19
v5.0.7 聚焦于 WebUI 交互体验与模型管理能力、推理强度（reasoning effort）配置、凭据安全策略加固、Docker/NAS 部署方案，以及大量终端渲染、流式同步与跨端稳定性修复。

⚠️ Behavior Changes（注意行为变化）
- 默认回合上限调整：普通 coding 回合的默认模型轮次上限由 200 调整为不设上限（[coding] max_rounds = 0）；精确无进展防护仍然独立生效，需要额外保护时可通过 [coding].max_rounds 或 ATOMCODE_TURN_MAX_ROUNDS 显式设置。
- Goal 模式轮次/时长默认值调整：goal 模式独立轮次上限默认由 200 调整为 300（并按套餐调用额度调整），墙钟时长上限默认关闭（0）。

✨ 新增功能（Features）
WebUI 图形界面
- 任务完成浏览器通知：任务结束时在浏览器弹出系统通知，支持最短时长、仅后台提醒与跨标签页去重等配置
- 可安装浏览器应用（PWA）：支持将 WebUI 安装为独立应用（含应用图标与 manifest）
- 持久化 Todo 进度面板：新增常驻 todo 进度面板，跨回合展示任务清单状态
- 回合统计与产物展示：聊天布局展示回合耗时统计，并列出回合生成的产物文件
- 模型与供应商管理：在设置中管理供应商账号、发现并添加模型、复用已有账号、查看内置预置配置
- 会话侧边栏增强：项目内会话扁平化分组、会话预览与列表刷新优化
- 版式与字号可调：优化视觉层次，字号改为 rem 缩放、支持调节
- 消息时间展示：展示用户/助手消息的发送时间（持久化每回合 started_at）
Provider / 模型
- 推理强度（reasoning effort）配置：可为模型配置推理强度（low / medium / high / max），并按端点能力声明可选等级
- /provider 推理强度多选：TUI 的 /provider 支持按端点支持的等级多选配置
- 每模型重试次数配置：支持在 config.toml 中配置 provider 429 重试次数（retry_max_attempts）
- CodingPlan 模型策略：强制管理 CodingPlan 模型的策略与推理强度等级
TUI 终端界面
- 会话预览：在会话选择器中直接预览选中会话的内容
- 语义化转录选择：新增语义化的转录文本选择与操作
- 鼠标交互增强：支持指针（鼠标）选择、命中现有选择器动作、保守鼠标终端能力
- 软换行感知导航：Up/Down 支持软换行感知的视觉行导航
- 重复粘贴展开长文本：连续粘贴时自动展开长文本输入
Docker / 部署
- docker-compose 一键部署：新增 docker-compose 方案，支持 NAS（群晖 / 威联通等）/服务器常驻运行 daemon，含崩溃自动重启、健康检查、数据与项目目录持久化
- 多架构镜像构建：支持 amd64 + arm64 双架构镜像构建与推送（build-multiarch.sh）
- 安全默认：容器默认仅绑定本机端口，并补充反向代理 + TLS + token 鉴权安全警告
安全
- 可配置凭据 Shell 防护策略：新增 credential shell guard 策略（off / prompt / strict），支持持久化「始终允许」授权与审批谓词
- 敏感路径传播：敏感路径子块阻断传播，同时保留同级正常输出
其他
- /init 本地化提示：/init 支持按语言生成本地化提示（中/英），并可配置自定义提示文件
- 退出码区分：区分命令退出码失败与用户中断，向模型传递准确的结果语义
- 子代理路由改进：改进子代理的模型路由与故障恢复
- Review 范围钉住：review 的 path confine 支持 review-scope allowlist，将检查范围钉住在变更文件集上

🛠 修复（Fixes）
WebUI
- 修复侧边栏列表刷新闪烁、会话切换闪动与作用域切换跳级问题
- 修复 IME 输入法组合输入被覆盖、组合状态丢失的问题
- 修复忙碌回合缺少加载指示、首个输出前无等待动画的问题
- 修复删除会话后工作区计数不更新的问题
- 修复回合统计在回合完成前即显示的问题
- 修复历史回合时间戳丢失的问题
- 修复浏览器通知权限未主动请求的问题
- 修复中文相对时间标签不完整的问题
- 修复 todo 面板生命周期、用户输入响应按传输通道路由的问题
TUI 终端渲染
- 修复旧终端上 provider 菜单标记与面板样式降级问题
- 修复终端 resize 后 footer 不稳定、命中图未重新发布、拖拽未中止的问题
- 修复输入焦点恢复后未重绘的问题
- 修复模态搜索导航语义、文本字段光标编辑对齐问题
- 修复暗色主题下有序列表标记对比度、复选框标记样式问题
- 修复 Windows 上 markdown 表格渲染不稳定的问题
- 修复 prompt 历史未按项目隔离的问题
- 修复会话恢复缺少上限约束与取消能力的问题
- 修复 Orca 终端下 OSC 背景查询跳过的问题
Agent / 运行时
- 修复并发编辑冲突：同一文件的编辑串行化，防止互相覆盖
- 修复流式超时后安全续跑、部分流恢复的边界问题
- 移除模型可见的轮次压力提示，避免弱模型被轮次倒计时误导
- 修复用户取消后活动计划未退出、steer 确认未协调的问题
- 修复空 evaluator 响应被误判为失败的问题
- 修复显式 no-verification 请求未被遵守的问题
Provider / 网络
- 修复 system 消息顺序未归一化的问题（兼容 Qwen / vLLM 等严格模板，多 system 消息正确合并前置）
- 修复 OpenAI 工具 schema 归一化问题
- 修复 loopback 流量被错误发送到代理的问题
- 修复代理配置未从当前发行版配置读取的问题
- 修复 reasoning_effort_levels 仅在选择器生效、未在请求值上强制的问题
Plugin / Skills
- 修复 home 目录下插件 scope 重复枚举的问题（Issue #1400）
- 修复别名去重时丢失 scope 身份的问题
- 修复迁移后的配置树被误判为第三方而非产品原生的问题
- 修复插件重载提示文案错误的问题
编辑器集成
- 修复 VSCode 会话标签页标题过长挤压关闭按钮的问题
- 修复 JetBrains 模型切换下拉框默认项缺少背景高亮的问题
其他
- 修复 daemon 无法打开会话工作区之外产物文件的问题
- 修复图像粘贴在用户输入响应中未预处理的问题
- 修复代码检视 serde_json map 键顺序断言、覆盖脚手架过滤器等内部问题

📚 文档（Docs）
- 更新架构文档（core 退役后的模块图与说明）
- 新增 NAS docker-compose 一键部署文档与多架构镜像构建文档
- 更新官网文档站中英文页面（配置、登录方式、WebUI、常见问题、快捷键等）
- 更新配置示例（retry_max_attempts、默认回合上限说明）

AtomCode v5.0.6 Release Notes
发布日期：2026-08-12
v5.0.6 聚焦于异步 Agent 团队运行时（里程碑）、基于本地语言服务器的语义代码智能（LSP）、TUI 交互式配置面板与 daemon 本地 token 安全认证，同时围绕 WebUI / TUI 交互体验、MCP 稳定性、Goal 进度保留与多项安全加固进行了全面修复。

⚠️ Behavior Changes（注意行为变化）
- 模型定价估算移除：/cost 不再显示美元费用估算；provider / model 配置中的 pricing 字段不再生效（配置中残留的字段将被忽略）。

✨ 新增功能（Features）
异步 Agent 团队（里程碑新功能）
- 异步团队运行时：新增多角色（planner / architect / implementer / reviewer / security 等 14 个角色）异步并行协作的团队模式，支持并发上限、事件有序分发与优雅取消（里程碑新功能）
- 团队面板：TUI 实时展示各成员的角色、模型、活动状态与真实输出 token 消耗；队列中成员的详情可见
- 团队健壮性：成员可跨 /model 切换存活，事件顺序串行化，worker 作用域加固
语义代码智能（LSP）
- lsp 工具：opt-in 只读语义查询，支持 definition / references / hover / diagnostics 四类操作，按需惰性启动本机已有语言服务器，不可用时优雅降级（不阻塞回合）
- 服务器配置：[lsp.servers] 可自定义服务器命令与参数，auto_detect 自动探测本机已安装语言服务器
TUI 配置面板
- 交互式 /config 面板：可搜索的半屏配置编辑器，支持布尔 / 枚举 / 整数设置项编辑与重置，并标注各设置的生效时机（即时 / 下回合 / 重启后）
- Provider 表单增强：窄屏下 provider 字段保持可编辑
安全
- daemon 本地 token 认证：daemon 生成 0600 权限的 token 文件，VSCode / JetBrains 读取后以 Authorization: Bearer 访问，加固本地 daemon 通信
- 凭据策略恢复：凭据拦截后提供结构化恢复动作（外部完成 / 跳过步骤 / 结束任务等），WebUI 新增策略干预卡片
- 凭据提取拦截扩展：新增 ssh / scp / sftp、sh / bash / zsh / perl / ruby 等命令与 *_webhook 标识符识别
视觉能力
- 可配置视觉能力：provider / model 支持 supports_vision 显式覆盖，自定义模型 ID 与兼容网关可手动指定图片输入能力（默认按模型名自动检测）
- VSCode 图片灯箱预览：点击用户消息图片全屏预览，支持多图导航（← / →、ESC 关闭）
WebUI
- Steer 徽章：同步模式下的 steer 在自己的气泡上显示徽章直至折叠
- Todo 标题：工具行展示 todo 标题
- 移动端换行：composer 支持移动端换行输入
其他
- /resume 回放上限配置：ui.history_replay_max_rows 控制恢复时回放到终端 scrollback 的视觉行数上限（0 = 完整回放，默认按终端自动选择）
- MCP server instructions：读取服务器指令，以独立不可信边界注入模型请求，不写入会话快照
- Provider 预设：完成小米 MiMo 预设（默认端点 + MIMO_API_KEY），新增 OpenCode Zen（OpenAI 兼容）预设
- Referral 周导航：邀请汇总面板支持按周前后翻页查看历史邀请 / 活跃 / 结算数据
- read_file 分页：默认最多返回 300 行并附续读指引，引导模型从偏移处继续读取而非重复全读
- Goal 模式同步：移动端 Goal 模式与 TUI 同步，daemon health check 暴露 goal 能力
🛠 修复（Fixes）
安全
- $ATOMCODE_HOME 迁移后，auth.toml 凭据守卫随配置目录生效，不再因路径变化漏守
- 新增 dd 原始设备写入门禁与紧凑形式关键重定向检测
- 凭据策略拒绝在终端表面结构化展示，恢复决策前后关联一致（修复拒绝路径的展示与关联一致性；新增能力部分见 Features 的「凭据策略恢复」）
WebUI
- 活跃回合 / 切换模型期间输入自动排队，不再丢失提示词
- 同步模式 steer 不再弹回 composer
- steer 保持同模型时不再反复提示切换模型
TUI / 终端渲染
- 任务面板在 agent 运行时保持可见，并发任务进度稳定
- 恢复的历史回放增加有界限制，长会话恢复更流畅
- 通用 Web 终端（如 JumpServer）默认使用传统键位上报，Kitty 键盘协议仅对兼容终端启用（可用 ATOMCODE_KITTY=1/0 强制开关）
- 修复提示类输入前缀保留、圆形标签间距、长任务预览换行、批量编辑 diff 显示、空答案光标位置等渲染问题
MCP
- HTTP 响应体增加 10 MB 上限，杜绝无界分配
- stdio 请求使用共享 deadline，断线超时恢复加固
- 工具调用前释放注册表锁，避免死锁
Goal
- 跨恢复 / 压缩保留目标进度，暂停时清除 held turn
- 恢复上下文有界、锚点来源门控、用户暂停后仍可继续
Telemetry
- 队列事件支持恢复与重试，丢弃不可发送段、共享隔离上限、回收孤儿标记
Session
- 会话自动命名与对话显示跳过注入的 system-reminder 消息，避免内部提醒混入用户视图
Daemon / IDE
- provider 重载时 mid-turn live steer 不再被拒绝
- /chat 会话可跨 workspace 桶继续
- token 文件 0600 原子创建，daemon / VSCode / JetBrains 的 token 读取与失效处理一致
其他
- 插件 hooks 兼容 Claude Code settings 风格的包装格式
- DeepSeek V4 不再强制工具选择，避免 provider 丢弃工具调用；规划阶段对 DeepSeek 的强制 todo 也改为温和提示，避免过度约束
- 工具调用 JSON 含未转义引号时仍可正确恢复
- 恢复启动时同步升级检查：新版本可在本次启动即应用，无需两次重启（恢复 v5.0.4 之前的同步升级检查行为）
📚 文档（Docs）
- README 中英双语版本徽章与 Kitty 键盘协议终端兼容性说明
- MCP 文档补充 server instructions 与 stdio / HTTP 传输行为说明
- config.example.toml 更新（小米 MiMo 示例、history_replay_max_rows、移除失效的 auto_copy_on_select）
- 项目简介补充中英双语说明，LSP 工具与权限引用同步更新

AtomCode v5.0.5 Release Notes
发布日期：2026-08-07
v5.0.5 聚焦于持久化目标（Goal）生命周期、实时转向与下一轮提示建议、MCP 与文件工具增强、TUI 交互打磨（目录选择器、快捷键体系），以及多项跨平台（Windows）兼容性与稳定性修复。

✨ 新增功能（Features）
Goal 持久化目标
- 阶段感知的持久目标：目标从启动到结束经历明确阶段（进行中 / 已暂停 / 达上限暂停 / 已达成 / 已结束），达成后仍保持注册，TUI 持续显示目标徽章
- Esc 暂停目标：Esc 暂停进行中的目标，下一条用户消息自动恢复，无需重新输入目标条件
- 达成后继续对话：目标达成后在下一条用户消息时自动重新参与，由模型判定是继续 / 新任务 / 闲聊
- 轮数预算替代时间上限：目标轮数预算取自计划配额，预算用尽时提示「继续对话即推进」，不再硬性卡时间上限
Live Steering 实时转向与提示建议
- 回合中实时转向：agent 执行期间继续输入即可作为实时转向并入当前回合，TUI 与 WebUI 同步生效
- 下一轮提示建议：回合自然结束后采样「用户最可能输入的下一条消息」，TUI 空输入框一键接受
- WebUI 草稿恢复：未确认的实时转向在回合取消 / 会话切换时自动恢复为可编辑草稿，不丢失输入
MCP
- JSONC 注释支持：.mcp.json 配置允许 // 与 /* … */ 注释，编辑器中粘贴的带注释配置可直接生效
- 工具名规范化：MCP 服务器 / 工具名含空格、冒号或中文时自动规范化为合法的 OpenAI 函数名，不再导致整请求 400（超长名附稳定哈希后缀保持唯一）
- 协议协商与请求标注：MCP 协议版本协商改进，HTTP 传输请求正确标注
文件工具
- GBK/GB18030 原位编辑：edit_file 支持直接编辑 GBK/GB18030 编码文件并按原编码写回，中文 Windows 场景不再被转成 UTF-8
- 路径不存在提示：read_file / glob 等工具在路径不存在时给出最近存在的祖先目录及条目，便于模型自行恢复
配置
- 服务端地址可配置：平台、CodingPlan API、更新清单、下载源、relay、插件市场等所有服务端地址均支持环境变量覆盖，自托管部署无需改源码
- CodingPlan 前缀可配置：provider 前缀可通过 ATOMCODE_CODINGPLAN_PROVIDER_PREFIX 调整，并兼容识别历史 AtomGit-* 配置键
- 按模型 api_key：CodingPlan models-v2 数据支持按模型下发独立 api_key
- Todo 急切规划策略：新增 [tools.todo] eager 配置（auto / preferred / always），可让新任务强制或优先使用 todowrite 建立任务清单
TUI
- 目录选择器重构：/cd 目录选择器支持搜索、Tab 补全，并聚合会话目录与最近目录
- 快捷键体系增强：Tab / Shift+Tab 切换执行模式、F2 / Shift+F2 切换模型、Ctrl+R 反向搜索输入历史、Ctrl+T 切换 reasoning_effort、Ctrl+J 换行、Ctrl+V / Ctrl+Alt+V 粘贴文本或图片
review 子命令
- --no-coverage 支持：atomcodex review 新增 --no-coverage 跳过覆盖率复检，并优化复检范围（上限 8 个文件、按信号优先级排序）
🛠 修复（Fixes）
Goal
- 暂停 / 恢复生命周期正确保持：暂停不丢目标，恢复时重置无进展计数与截止时间
- 目标结束后正确恢复回合统计分隔线，避免残留状态串扰后续轮次
- 修复目标徽章时钟重置时机、轮数预算饱和计算等问题
终端渲染 / TUI
- 修复暗色面板文本对比度与浅色终端下输入提示可读性
- 快捷键帮助文案与实际快捷键对齐
- 目录选择器当前目录标记去重、输入期间保持最新输出可见
- 修复旧版 conhost 窗口尺寸变化时的重排问题
Provider / 网络
- 首个瞬态 429 静默重试，避免重复横幅刷屏
- 网关首字节（TTFB）超时保护，网关接受连接但无响应时不再无限挂起
- hyper IncompleteMessage 纳入可重试分类
- Anthropic 强制工具调用时抑制不兼容的 thinking 模式，兼容扩展 / 自适应思考
会话 / 持久化
- 修复 Windows 上会话 transcript 追加因 LockFileEx 权限不足失败（os error 5）
- 安全软件短暂占用文件时自动重试打开 / 加锁
- Rewind 账本升级至 v2（工作区树可选），旧账本仍可正常读取
Agent / 工具
- 符号工具不再把「类型不支持」记成调用失败；缺失文件对不支持类型仍保持错误
- 宽松整数参数校验：拒绝分数、无穷与超出精确范围的浮点
- request_user_input 多选勾选项与自定义输入合并保留，不再丢弃已勾选项
权限 & 安全
- 阻止通过 bash 工具提取凭据（含凭据重试循环），要求改用凭据感知工具或用户手动完成认证步骤
- 调度任务 id 校验，阻止路径逃逸读写 schedules 目录之外的文件
WebUI
- 结构化输入弹窗点击背景不再意外关闭，daemon 接受响应后才关闭
- 首次登录时正确解析 provider
VSCode 扩展
- 修复窗口重开后请求排队失效：窗口重开后旧回合仍在 daemon 运行时的消息正确入队，旧回合结束后自动重放队列
Skills
- 设置 ATOMCODE_HOME 后，用户级 .atomcode 下的 skills / commands 目录正确重定向到新配置根目录
📚 文档（Docs）
- 重写 docs/mcp.md：按当前代码更新 MCP 配置、传输与工具说明
- README 更新快捷键说明与目录选择器行为描述
- docs/config.example.toml 新增 [tools.todo] 配置示例

AtomCode v5.0.4 Release Notes
发布日期：2026-08-04
v5.0.4 聚焦于本地定时任务（schedule）能力、流中断时部分输出保留、Provider 错误引导优化、TUI 输入与渲染体验改进，以及 IDE 插件守护进程可靠性提升。

⚠️ Behavior Changes（注意行为变化）
- Code Rewind（代码回滚）临时禁用：为保护磁盘空间，v5.0.4 暂停工作区代码快照与回滚能力；对话级 Rewind（/rewind、回退历史轮次）不受影响，可正常使用。

✨ 新增功能（Features）
本地定时任务（里程碑新功能）
- atomcode schedule 命令：新增 add / list / remove / enable / disable / sync 子命令，管理本地定时任务
- 多种调度频率：支持每日（HH:MM）、每周（N@HH:MM）、每小时、间隔分钟（30m）与 cron 表达式
- 操作系统级调度注册：自动写入 macOS launchd / Linux systemd / Windows 计划任务，机器重启后依然按时触发
- 无人值守安全执行：定时触发的会话默认拒绝高风险 bash 命令，防止无人看管时执行危险操作；任务运行后按级别通知
- 定时会话隔离：定时任务产生的会话不会出现在日常 /resume 与侧边栏历史列表，避免刷屏
- /schedule 命令：TUI 中直接查看定时任务列表
TUI 输入体验
- Ctrl+R 反向历史搜索：readline 风格搜索历史命令，输入即过滤、可跳转更早匹配、Enter 采纳、Esc 恢复草稿
- /rewind 命令：将回退点选择器从双 Esc 手势扩展为显式命令，直接打开对话回退选择
执行约束
- 每轮执行限制：用户以自然语言说明「不要运行任何命令 / 不要编译 / 不要测试 / 不要执行脚本」时，该轮工具调用会被强制拦截，避免误解意图
IDE 与 WebUI
- 登录后自动同步模型：OAuth 登录成功后自动领取 CodingPlan 并同步模型列表，VS Code / JetBrains 插件无需再手动执行 /codingplan
- WebUI 结构化提问：/chat 会话可交互回答单选 / 多选 / 文本形式的结构化问题
记忆与配置
- 项目记忆目录可覆盖：新增 ATOMCODE_PROJECT_MEMORY_DIR 环境变量，可自定义项目级记忆文件（默认 .atomcode）的存储位置
🛠 修复（Fixes）
Provider / 网络
- 流中断保留部分输出：已产出内容的响应流断开时不再盲目重放请求（避免重复输出或重复执行工具），安全保留已生成的部分回复并可继续
- 透明重连增强：仅收到元数据（尚未产出正文）的断流最多自动重连 3 次，网关抖动下更稳定
- 网络错误提示优化：Windows 连接重置（os error 10054）时提示检查公司网络 / 代理 / VPN 设置
- CodingPlan 引导：账号无 CodingPlan 权限（HTTP 403）时给出明确提示并引导重新登录领取
- 配置保存竞争修复：保存配置不再基于过期 revision，保留其他进程的并发编辑
TUI / 终端渲染 / Windows 兼容
- 暗色主题可读性：限流提示等 muted 文本改用主题感知配色，暗色终端下不再与背景融为一体
- 流式渲染优化：流式文本按块增量处理，长输出渲染更平稳
- Windows 剪贴板图片：兼容 PixPin / Snipaste / 系统截图工具生成的 DIB 格式，/paste 粘贴图片不再报「剪贴板中没有图片」
- 渲染重叠修复：工具执行进度条计入布局计算，不再与正文错位或残留幽灵块
- 控制台窗口闪烁：Windows 下启动守护进程不再闪现黑色命令窗口
WebUI
- 可删除空闲的当前会话：删除前自动切换到新会话，不再被「当前会话」限制
- 侧边栏滚动保持：切换会话时列表自动滚动到目标项，不再丢失位置
- 活跃回合防切换：回合进行中切换会话会被拒绝并保持原会话，避免状态错乱
- 删除会话即时生效：侧边栏删除后本地移除该行，无需整表重载
IDE 插件（JetBrains / VS Code）
- 守护进程版本自愈：检测到运行中的守护进程与插件捆绑构建不一致（版本或二进制哈希）时，自动停止旧进程并启动正确版本
- JetBrains 守护进程解压保护：防止捆绑二进制被意外覆盖
定时任务健壮性
- 修复 launchd 安装非幂等、plist XML 未转义、systemd ExecStart 未加引号、非法星期未拒绝、列表在无调度器环境下的降级展示等跨平台问题
会话与撤销
- Rewind 持久化加固：回退点持久化有界化，异常中断后可恢复历史
- 会话修复能力：presentation 文件缺失时可通过接口检查并修复会话
- 回合中会话切换保护：活跃回合期间 resume / 新建会话 / 切换目录统一返回繁忙，避免并发状态破坏
🔧 重构（Refactoring）
- 启动提速：模型目录元数据刷新改为异步执行，不再阻塞启动关键路径；启动时不再同步检查并应用升级，改由后台进程完成
- JetBrains 守护进程生命周期：引入统一 Supervisor 管理守护进程的连接、启动与版本替换

AtomCode v5.0.3 Release Notes
发布日期：2026-07-30
v5.0.3 是 AtomCode 架构升级里程碑版本，正式退役 atomcode-core crate（~72k 行代码迁移至 capabilities/kernel/daemon），新增 Provider 账号与模型配置体系、Tool 产出物系统（Artifact）、安全回滚（Rewind）、回合上限检查点等重大功能，并修复了大量 Provider 网络、TUI 渲染、WebUI 同步路径和跨平台兼容性问题。

✨ 新增功能（Features）
Provider 账号与模型配置体系
- Provider 预设注册表：内置预设厂商列表，支持一键添加常见 Provider（DeepSeek、Ollama、OpenAI Compatible 等），含预设 base_url 和认证方式
- Provider 账号与模型配置：新增 [provider_account] / [model_profile] 配置模型，支持多账号管理和按模型选择器切换
- CodingPlan schema 适配：CodingPlan 账号按「账号 + 模型」分组展示，消费者通过 resolve_model 获取活动模型
- TUI /provider 面板全面重设计：全新的面板式管理界面，含「账号」和「模型」两个 tab，支持添加/编辑 Provider 账号、配置模型、自定义名称和协议切换
- 厂商预设快速添加：在「账号」tab 列表展示未配置的预设厂商，点击即可快速添加
- API Key 收集：添加模型时自动提示输入对应 API Key
- 新增 TaoToken 厂商预设：支持通过 TaoToken 服务接入
模型定价与成本归因
- Models.dev 定价解析：从 models.dev 获取并解析模型定价信息，/cost 命令按 Provider 和模型准确归属用量与费用
Tool 产出物系统（Artifact）
- ArtifactStore：内容寻址的 tool 输出存储，确保每次输出的唯一性和可溯源性
- ArtifactMiddleware：通过 ToolMiddleware::after 钩子实现确定性预览和产物收集
- fetch_output 工具：支持分页检索已归档的 tool 产出物
- 会话集成：ArtifactMiddleware + fetch_output 在有活动 session 时自动挂载
Safe Rewind 回滚
- 安全回滚工作流：支持用户安全地回滚到历史状态，保留上下文完整性
- Workspace checkpoint 基础：为回滚提供工作区检查点支持
回合上限检查点
- 检查点问询：回合上限从硬错误改为交互式检查点，用户可选择继续或停止
- [coding] max_rounds 配置项：TOML 配置支持设置最大轮次上限
Agent / Persona 增强
- WORKFLOW 意图对齐：新增 UNDERSTAND 步骤，在正式开始工作前确认对任务的理解，减少误解和返工
- 进度提示（Signpost）：在工具调用批次前输出进度提示，提升用户对 Agent 正在做什么的感知
- Subtask 进展透明：实时展示子任务进度，footer 固定显示当前进度状态
内容安全边界
- 内容安全过滤：Coding 系统提示中加入安全边界（涉政/涉黄/涉暴），始终生效，确保输出合规
TUI
- 用户输入背景块：用户输入区域增加背景色块，视觉上更清晰区分输入与输出区域
- 模型切换快捷键：支持通过快捷键快速在模型间循环切换
- Session 删除自动清理：删除会话时自动清理对应的 artifacts 目录
WebUI
- Sync 模式 /compact：新增 /live/compact 端点，WebUI 同步模式下可直接发起手动压缩操作
- VL 图片持久化：VL 预处理图片以 display-only sidecar 方式持久化，刷新后仍可见，且零上下文开销
Headless CLI
- Shell 自动补全：新增 shell completions，支持 bash/zsh/fish/powershell 等主流 shell
/skills
- 贪婪多技能匹配：/skills 命令支持贪婪匹配多个 skill 名称片段，一次性加载多个匹配的技能
- 已加载回显：加载后回显已启用的 skill 名称列表
平台兼容性
- Bash askpass 支持：ssh/sudo 等交互式密码命令可正常使用，不再因非交互等待超时而放弃
- Windows SChannel 默认后端：Windows 平台默认使用 native-tls（SChannel）作为 TLS 后端，绕过 rustls 指纹拦截导致的连接失败
- HarmonyOS bash 回退：HarmonyOS 系统上 bash 不可用时自动回退到 sh
🛠 修复（Fixes）
Provider / 网络
- TLS BadRecordMac 恢复：修复 OPEN 路径上 TLS BadRecordMac 错误导致的连接中断
- Provider 切换同步守卫：轮次运行中拒绝 Provider 切换，修复跨窗口模型选择不一致
- MCP stdio 服务恢复：stdio 模式下的 MCP 服务器进程退出后自动恢复
- Rate limit 重试合并：统一 Provider 限流重试逻辑，减少误报
- 不支持的 Gateway Provider 启动恢复：启动时正确处理不支持的 gateway provider，不再崩溃
- Provider schema 迁移间隙闭合：完成 schema 感知迁移中的配置读取间隙修复
- 配置边界补齐：所有 config.providers 读取统一经过 schema 感知边界
- Provider 状态修复：TUI 正确区分 Provider 可用性状态，避免误报「未配置」
- 厂商预设 Quick-add 过滤：排除含 gateway 且无端点的预设，仅展示可直接添加的厂商
TUI
- CJK 图表对齐：修复中文/日文等宽字符在表格/图表中对齐偏移问题
- 插件含 CJK 描述中止修复：插件描述包含 CJK 字符时不再导致中止
- 原生 Provider 恢复与列表：重启后正确恢复原生 Provider 并列入模型选择器
- 会话保持在对应模型：已打开的会话在模型变更后仍保持原有模型
- 背景通知延迟：背景通知延迟到轮次结束后展示，避免干扰当前操作
- Rewind 界面修复：Rewind 加载状态不进入滚动记录，弹窗间距优化
- 粘贴支持：Provider 表单和 request_user_input 面板中支持粘贴
- /resume 并行 tool 分组恢复：/resume 后并行工具批次正确分组展示
- 附件延续缩进填充：附件延续行以面板背景色填充缩进，视觉更整洁
- 面板颜色匹配：/resume 选择色在插件/Provider 面板中保持一致
- Split_skill_names 花括号修复：修复坏合并丢失的闭合花括号
- Provider 添加后保持面板打开：添加 Provider 账号后不自动关闭面板
TUIX
- 摘要重复错误修复：中断 summary 不再重复显示已在上方显示的错误原因
- 终端滚动稳定：修复多次滚动回退累积导致的空屏和滚动位置不正确
- Footer 上下文用量刷新：/login 采纳活动 Provider 新配置后 footer 正确刷新
- 初始上下文窗口显示：首次展示时正确显示上下文窗口大小
- Tab 切换不提交运行中工具：Tab 切换 mode 时不会错误提交正在运行的工具
- Streaming 用户输入保持：工具运行且流式生成时，用户编辑的输入内容保持可见
- 自动 Tool folding 保持静默：自动折叠的工具保持静默展示，不影响界面
- Subagent 活动高亮：子代理活动在界面中正确高亮区分
- Clipboard 图片提示短暂：剪贴板图片提示只在初次粘贴时短暂显示
- 滚动条跨 live spinner 保持：live spinner 刷新前后滚动位置不变
- 自动模式下显示用户输入提示：auto 模式下正确展示用户输入提示
- Provider 新建配置后 login 采纳：/login 正确使用活动 Provider 新配置（含 context_window）
WebUI
- VL 图片 sidecar 修复：/chat 路径上正确持久化 VL 处理后的图片，WebUI 贴图在同步 TUI 显示空框的问题已修复
- 移动端 composer 控件重叠：移动端下 composer 控件不再重叠
- 同步路径消息发送优化：同步模式下 optimistically 展示已发送消息，无需等待确认
- 同步路径图片上传：同步路径上传图片时展示原始消息+图片而非 VL caption
- /models 统一目录：CodingPlan 新 schema 模型不再从选择器消失
- SSE 广播模型保持：多窗口 SSE 广播时正确保持用户选择的模型
- MCP readiness 等待：headless runtime 首次轮次前等待 MCP readiness
- 响应式加宽与暗色边框：内容列响应式加宽，暗色模式表格边框对比度提升
- 创建 sessions dir 前置：stash dis

AtomCode v5.0.2 Release Notes
发布日期：2026-07-24
v5.0.2 聚焦于自定义指令（Custom Commands） 的完善——args 字段真正生效、渲染与键值生成落地，同时带来了 WebUI 多窗口体验优化、Provider/TLS 连接韧性加固、Config 容错能力提升以及安装脚本的 PATH 匹配修复。

✨ 新增功能（Features）
自定义指令 (Custom Commands)
- args 字段真实生效：自定义指令配置中的 args 字段从前端注册到后端分发（dispatch）全链路打通，指令可以声明所需的参数并正确传递
- 渲染与键值生成：自定义指令支持在 TUI 中渲染参数提示（${ARGUMENTS} 占位符），并自动生成唯一的键值（hotkey），用户可通过键值快速触发
WebUI
- 项目删除：WebUI 支持删除项目

🛠 修复（Fixes）
自定义指令 (Custom Commands)
- Render 链式替换递归损坏：修复 ${ARGUMENTS} → $ARGUMENTS 归一化后链式替换递归问题，防止用户输入含 placeholder 字面量时被轮回替换
- 修复未知命令静默失败回归：恢复 CmdUnknownCommand 错误渲染，未知命令不再被静默吞掉
- 补齐 Required+空参数分发路径：补齐 Required 模式下空参数的拒绝路径测试，确保空参数不触发 submit
Config / Provider
- 无效 Provider 隔离：启动时校验失败的 [providers.<name>] 段被隔离，不影响启动
- 写入路径容错：/model 等写入操作时不再因磁盘残留无效 provider 段报「配置保存失败」——写入路径也容错，且原样保留无效段（不丢失）
- 单坏证书不 abort 整个 HTTP Client：单个 OS 根证书被 rustls 拒绝时不再导致全部 Provider 启动失败，改为跳过坏证书继续构建
TLS / 网络
- TLS 1.2 降级重试：AtomGit 连接在 TLS 1.3 握手失败时自动以 TLS 1.2 重试（仅握手阶段降级，使用现代密码套件），提升 CDN/中间件兼容性
WebUI
- Session 加载竞态修复：修复 WebUI 中 Session 加载时的竞态条件，避免丢失会话状态
- Model Selector 下拉时暂停轮询：下拉菜单打开时暂停模型列表自动轮询，防止切换中断
- 项目切换状态同步：WebUI 切换项目时，正确同步 TUI 和 daemon 的项目状态，确保会话一致性
安装脚本
- PATH 匹配修复：install.sh 和 install.ps1 中 PATH 检测从子串匹配改为完整条目匹配，修复因假阳性跳过添加 install 目录导致新终端找不到 atomcode 命令的问题

📚 文档（Docs）
- 自定义指令教程：README 新增自定义命令完整教程，涵盖路径配置、args 行为说明、插件作用域
- 示例冲突修复：修正 README 中自定义指令示例与内置 /review 命令的冲突

AtomCode v5.0.1 Release Notes
发布日期：2026-07-24
v5.0.1 是一个里程碑版本，正式上线交互式多轮提问（request_user_input） 能力，Agent 可在关键决策点以选择/文本形式主动询问用户；子代理（Subagent） 新增作用域门控与并发配置；MCP 项目信任管理支持在项目层级信任/屏蔽 MCP 服务器；TUI 新增 /view 内联文件查看、/cost 命令、宽表渲染、欢迎吉祥物；WebUI 新增 Accept Edits 模式与 SSE 实时同步；引入 AtomGit 标签中间件自动标记 git push；插件钩子信任 通过内容哈希保护 CC hooks 安全；网络层支持 macOS/Windows 系统代理读取；完整退役 legacy bridge crate，完成 capabilities 迁移与原生 session 收敛。

✨ 新增功能（Features）
交互式提问（Interactive Questions）
- 多轮批处理提问：Agent 可将多个问题以批处理表单同时询问用户，Tab 导航切换，逐项回答后统一提交
- TUI 面板：编号选项 + 逐项描述 + Enter 选择 + 独立提交行，支持单/多选/自由文本三种模式
- WebUI UserInputCard：SSE 实时推送用户输入请求，支持单/多选/自由文本/批处理
- Persona 桥接：Agent 在需要用户决策时自动引导至 request_user_input，脑暴式开放问题也纳入
- Custom 标记：每个问题可配置是否显示自由文本行（custom flag），默认启用
- Bypass 模式：ATOMCODE_REQUEST_USER_INPUT=0 可关闭此功能，自动跳过提问
- Persona 批量引导：nudge 模型将同类用户问题合并为一次批处理提问
子代理（Subagent）增强
- WorkerScopeGate 作用域门控：子代理写入操作被限制在指定作用域内，防止越权修改
- 作用域验证：每个子代理任务必须显式声明作用域，缺失即拒绝（fail closed）
- 并发/超时配置：[subagent] max_concurrent/timeout 配置生效，控制子代理并行度与执行时限
- 委派纪律：主 Agent 委派子任务时遵循纪律性 prompt，避免过度拆分
- 默认开启：ATOMCODE_SUBAGENT task tool 默认启用
MCP 项目信任管理
- 项目级信任存储：MCP 服务器可按项目信任/屏蔽，未信任项目的 MCP 服务器永不连接/启动
- /mcp trust|untrust 命令：TUI 和 CLI 均支持信任/取消信任操作，并显示被屏蔽的服务器
- WebUI 信任按钮：项目 MCP 服务器旁增加信任按钮 + 被屏蔽提示
- JSONC 注释支持：.mcp.json 支持 JSONC 格式（可加注释或临时禁用某服务器）
- Live 重载：/live/mcp/trust 实时刷新信任状态，下一轮生效
TUI 增强
- /view 内联文件查看：模糊搜索文件 + 固定高度内联面板（类似 /diff 风格），Ctrl+C 退出，最多显示 5 个文件
- /diff 增强：文件列表最多 5 行 + "更多文件"滚动指示器，面板自适应内容高度
- /resume 重设计：插件风格 chrome + 双行条目，键盘图例显示删除/重命名快捷键
- /usage 中轮次运行：作为滚动文字快照运行，跳过不必要的概览网关请求
- /cost 命令恢复：独立命令显示本地 Token 消耗（不限模型）
- /todo add <task>：确定性地追加任务，描述最多 2 行
- 实时 Token 计数器：Spinner 区域显示实时 Token 计数，长轮次不再"看起来卡死"
- 宽表渲染：收窄列 + 自动折行保住网格（借鉴 Codex 降级策略），修复无前导竖线 GFM 表格渲染
- 欢迎吉祥物：13×6 高分辨率 ASCII 吉祥物 + 溢出安全双列布局，非现代终端模拟器自动隐藏
- Ctrl+Alt+V：Windows Terminal 备选图片粘贴快捷键
- 输入历史位置：上下键浏览历史时显示当前位置指示
- QR 登录回退：优先显示链接供点击，按 c 复制完整 URL
WebUI 增强
- Accept Edits 模式：支持接受编辑模式切换 + SSE 实时同步
- 批处理提问 Stepper：多问题顺序步骤器 → 单次批量回答
- 搜索框重设计：支持字符高亮 + 固定定位，修复 IME 输入拦截
- 外部模型 429 处理：不再误报为 CodingPlan 超额，渲染去 CodingPlan 化 + 时长本地化
- 主题滚动条：深色模式下修复白色滚动条
- 用户消息同步：TUI 用户输入实时同步到 WebUI 显示
VS Code 集成
- Todo 进度面板：新增 Todo 进度跟踪面板
- 聊天字体：尊重 chat 字体设置，输入框使用等宽字体
- 守护进程端口恢复：被卡住的守护进程退出后自动恢复端口
AtomGit 标签中间件
- GitPushLabelMiddleware：git push 后自动为仓库添加 atomcode 标签
- Compound 命令检测：识别复合/环境前缀命令中的 git push
- 标签工具：新增 repo_labels / set_labels / ensure_label 工具操作
- 容错锁：poison-tolerant mutex，无 panic 合约
网络与系统代理
- macOS 系统代理读取：通过 scutil 读取系统静态代理配置
- Windows 注册表代理读取：解析 Windows 注册表中的系统代理
- FollowSystem 模式：proxy.mode = "FollowSystem" 自动跟随 OS 系统代理
- ALL_PROXY 优先：显式 ALL_PROXY 环境变量高于系统代理
- 代理策略扩展：Token 刷新客户端同样遵循代理策略
插件钩子信任
- 内容哈希信任存储：每个插件的 CC hooks 按内容哈希逐项信任
- Hooks 解析：识别 hooks/hooks.json 中声明的文件钩子并去重
- 升级兼容：已存在的插件钩子在升级后自动保留（不破坏内联钩子）
- 启动通知：TUI 启动时显示未信任插件钩子提示
- cli plugin trust/untrust：CLI 支持插件信任/取消信任操作
Vision / OCR
- VL 识别状态：表面 VL 识别状态信息 + 失败时恢复图片
- 连续会话保留：图片预处理结果在会话恢复后保持
- TUI VL 识别恢复：通过运行时 ImagePreprocessor seam 恢复 TUI 图片识别
Skills 技能系统
- SkillFirstHook：DeepSeek 等场景下首轮优先提示使用技能
- 技能目录注入：技能目录注入 v2 coding prompt，同时保留 budget-gate 与 source-rank 双路径
- 反绕过框架：codex 风格 prompt 框架，匹配技能时不再走临时方案
内核与运行时
- effective_input_limit：预留输出预算 + 估算边际，防止超限
- SendSyntheticMessage：新增内核命令原语
- 文件级 tracing：文件输出 tracing subscriber，用于可观测性
- Overflow 守卫：收紧溢出 needle 消除假阳性，覆盖更多上游超限错误
安装
- MSYS/MinGW/Cygwin 支持：install.sh + 站点 Windows 标签页
🛠 修复（Fixes）
Provider / 网络
- 401 错误原因透出：Claude/ollama HTTP 错误显示真实鉴权原因，而非 bare "HTTP 401:"
- Reasoning Effort 拒后自愈：Gateway 拒绝 reasoning_effort 时给出友好错误 + session 自愈
- 工具调用不丢失：Gateway 发送 finish_reason:"" 时不再丢弃空块的工具调用
- Provider 卸载异步：create_provider 在异步运行时执行，避免阻塞 3 个调用方
- 非 CodingPlan 429 透出：外部模型限流提示去 CodingPlan 化，标准化错误抽取
- 限流暂停修正：只在真实 5h 窗口耗尽时暂停，不在健康窗口误触发
- Provider 重载保护：阻塞式重载增加保护防止死锁
TUI / 终端渲染
- QR 码渲染修复：Windows 终端 QR 码渲染 + 对比度，block glyph 清理，强制重置 renderer 在 QR modal 绘制时
- Bash 运行状态：恢复 bash 运行状态上方间距，spinner 时钟括号平衡
- Streaming 渲染增强：Streaming 菜单选择遵守、输入输出渲染加固、live spinner 安全清理
- 会话过渡：避免阻塞会话过渡，关闭文件提及菜单后清理
- /status 静默崩溃：修复 TUI /status 静默崩溃 + 命令输出同步到 WebUI
- 模态框缩放：Modal 激活时清屏防滚动污染，80 列终端向导面板宽度限制
- 

AtomCode v5.0.0 Release Notes
发布日期：2026-07-17
v5.0.0 是 AtomCode 的重大版本更新，引入了用量统计（/usage）、离线模式、持久化任务面板、底部审批面板、模式切换系统、插件管理器重构、记忆工具、并发只读工具执行等核心新能力，以及多项终端渲染优化。

⚠️ Behavior Changes（注意行为变化）
- /cost 命令替换为 /usage：旧的 /cost 显示已退役，由功能更全面的 /usage 用量统计命令替代
- todo 工具合并到 todowrite：todo 和 todowrite 合并为单一工具，两种调用形态（对用户无直接影响，但模型行为统一）
- /issue 和 fixissue 功能移除：删除了核心中的 atomgit 相关功能和 /issue 命令
- 工具输出上限降至 64KB：单个工具输出上限从 256KB 降至 64KB，超出部分头尾截断，有助于减轻长会话上下文膨胀
- v1 引擎完全退役：移除遗留的 v1 AgentLoop 引擎、DaemonTurnExecutor、v1 工具脚手架，--engine 标志不再需要

✨ 新增功能（Features）
/usage 用量统计
- 用量统计命令：/usage 命令打开用量统计弹窗，替代旧的 /cost 显示
- 用量概览：60 天用量统计摘要，包含连续使用天数、总对话数、总 Token 消耗等指标
- 热力图日历：Claude Code 风格热力图，展示每日活动强度，支持深浅色主题
- 折线图趋势：盲文折线图展示每日 Token 用量趋势
- 进度条总览：用量进度条展示当前周期的使用量
- 分模型统计：按模型分别展示用量统计表格
- Ctrl+C 一键复制：用量数据一键复制到剪贴板
- 国际化支持：完整中英文文案
离线模式
- 自动离线检测：web_search 连接失败时自动切换为离线模式
- 手动离线配置：ATOMCODE_OFFLINE=on 环境变量或 OfflineMode 配置项
- 离线工具裁剪：离线时自动移除 web_fetch、web_search 工具
- 离线环境提示：TUI 和守护进程启动时显示离线环境标识
- 跳过自动更新：离线时跳过插件市场和二进制自动更新
- 禁用遥测：离线模式下自动禁用遥测上报
持久化任务面板
- 底部任务面板：任务面板固定在输入框上方，实时显示当前任务列表
- 持久化状态：任务列表面板跨会话持久化，支持 resume 后恢复
- 增量更新：todowrite 支持增量更新单条任务，弱模型也能正确维护
- 自动续跑：未完成任务自动触发续跑，防止模型中途漂移
- 完成即标记：任务完成后自动标记为完成，不再重复提示
- /todo clear：一键清空所有任务
- 任务对账：每轮注入待办锚点，对账兜底弱模型漂移
插件管理器重构
- 插件详情页：支持查看已安装插件的详细信息、版本、作用域
- 市场详情页：查看市场详情，包含自动更新开关、卸载等操作
- 搜索过滤：插件列表支持搜索框过滤，类似 HTML 输入框的交互
- 已安装标识：市场中已安装的插件显示绿色勾选标记
- 安装作用域：显示插件安装的作用域（用户/项目）
- 更新插件：支持强制重新安装/克隆插件以更新
- 卸载确认：卸载插件时弹出黄色确认框，防止误操作
- 移除市场：移除市场时自动卸载该市场下的所有插件
- 禁止移除官方市场：保护官方市场不被误移除
- 扁平列表布局：2 行展示，包含描述和状态，取消星级评分改用分类标签
- 安装即关闭：安装成功后自动关闭插件管理器弹窗
底部审批面板
- 输入框下方审批：审批面板从独立弹窗改为输入框下方紧凑面板
- 方向键选择：支持方向键上下选择审批选项，回车确认
- Esc/Yan 操作：支持 Esc 取消、Y 确认等快捷键
- 审批标题：审批卡片显示正在审批的操作名称
- 目录级授权：工作区外写入的"总是允许"改为目录级授权（类似 Codex grant_root），工作区外破坏性 Bash（rm/mv/cp/dd/重定向）弹审批
模式切换系统
- 统一模式枚举：新增统一的执行模式（Mode）枚举，包含 Build、AcceptEdits、Auto、Plan 四种模式
- Tab 切换：运行中也能用 Tab/Shift+Tab 切换模式
- /auto 命令：新增 /auto 命令，切换到 Auto 模式（自动 bypass 审批）
- 模式徽标：统一左侧模式徽标显示（⏸ Plan / ⏵⏵ Auto）
- i18n 标签：完整中英文模式标签
- accept edits 模式：编辑免审批，仅 bash 仍询问，对齐 Claude Code（对应 AcceptEdits 模式变体，通过 Tab 循环切换进入）
并发只读工具
- 并行执行：只读工具（如 read_file、grep、glob）并发执行，最多 4 个并行
- 智能分类：parallel_safe() 分类系统，自动判断工具是否可并行
- 只读 Bash 并行：cd <path> && <read-only> 等只读 Bash 命令也支持并行
- 批次标签：并行批次显示 in parallel 标签，实际并发时才显示
- Steer 机制：中间轮次产生的工具调用自动折叠到当前轮次显示，长任务续跑时上下文更清晰
LLM 记忆工具
- 新 memory 工具：模型可调用 memory 工具（remember/forget/list）持久化学习
- 自动去重：append_deduped 跳过完全重复的记忆条目
- /remember /forget 命令：用户可直接在 TUI 中管理记忆
- Persona 提示：系统提示引导模型使用记忆工具记录非显而易见的发现
/init 智能初始化
- LLM 驱动初始化：/init 改为由 LLM 分析仓库后自动生成 AGENTS.md，替代静态生成器
- INIT_PROMPT：提示模型分析仓库结构、约定和配置，写出高质量的项目指令文件
桌面应用 /desktop
- /desktop 命令：检测并启动 AtomCode 桌面应用，未安装时显示下载链接
- 跨平台检测：支持 macOS 和 Windows 桌面应用检测
- open_file 支持 URL：open_file 工具新增支持 http:// / https:// URL 打开
终端渲染优化
- 像素风吉祥物：欢迎页新增像素风吉祥物，支持 9 格宽 + 右上瞳孔
- 数据驱动欢迎页：双栏欢迎页，左侧吉祥物，右侧数据驱动使用提示
- 智能提示池：欢迎页随机展示使用提示，包含 15 条命令说明
- Bash 命令折行：Bash 命令按 shell 边界智能折行渲染，洋红 $ 前缀
- Diff 渲染优化：新增行号列、+N −M 紧凑摘要、⋮ hunk 间隔、25 行截断，红绿按主题色柔化，整体类似 GitHub 风格差异展示
- 工具块呼吸感：工具块前留 1 空行，增加视觉呼吸感
- 限速 spinner：限制 spinner 帧率，不再随 Token 洪水乱转
引擎稳定性
- Kernel 原生路径：守护进程新增 kernel 原生运行时路径（ATOMCODE_DAEMON_ENGINE=kernel）
- 流空闲重连：流空闲超时自动重连（最多 5 次），Codex 对齐
- 超窗应急压缩：超窗请求发送前先应急压缩，而非只警告后硬发
其他新增
- WebUI 改进：边栏显示 MCP 服务器状态、登录状态指示器
- Bash 安全增强：AST 树解析的 is_read_only_bash 分类器，替代手写规则；系统临时目录视为可写；git 丢弃未提交工作的命令触发审批
- MCP 权限增强：destructiveHint:true 覆盖 readOnlyHint（审批不跳过）
- Plan 模式 MCP 授权持久化：跨 respawn 保留
- Hook 测试命令：atomcode hook test 命令行，支持完整 hook 执行
- JetBrains 插件本地化：齿轮菜单标签本地化
- 跨 Agent 技能发现：~/.agents/skills 和 .agents/skills 目录支持
- 窄窗口适配：超宽 Token 簇级折断 + 路径 ~/ 缩短
🛠 修复（Fixes）
TUI 渲染
- 修复浅色主题 Markdown 行内代码/标题颜色丢失问题
- 修复 256 色 SGR（38;5;N / 48;5;N）解析支持
- 修复 Solarized Dark 等深色主题下模态标签栏颜色异常
- 修复 diff 中未变化 Context 行颜色暗淡问题
- 修复 input caret 在 Windows Terminal 上满行时超出右边缘
- 修复欢迎页提示在 resize 时重新滚动的问题
- 修复吉祥物半块透明显示 + 非 Unicode 终端省略
- 修复 plan 模式徽标 ⏸ 前的残留字形
- 修复 thinking spinner 半月圆太大问题
- 修复多行 diff 中 dashes 开头的行不被删除的问题
- 修复 resize 时 stale approval_block_rows 计数吃掉正文的问题
- 修复实时 bash 在 commit 时渲染块绕过静态分支路径
插件管理器
- 修复 Add Marketplace 输入框光标列偏移
- 修复插件子页面之间 Tab 切

AtomCode v4.26.0 Release Notes
发布日期：2026-07-09
v4.26.0 引入了自主循环引擎（/loop）、子 Agent 并行执行（TaskTool）、通用于所有客户端的审批模式（Build/Plan/Bypass），大幅增强了 WebUI 的斜杠命令、项目管理、会话内搜索等交互能力，新增对话导出（/save）和任务清单系统（/todo），并深度优化了上下文压缩策略。

✨ 新增功能（Features）
/loop 自主循环引擎
- /loop 命令：支持自定步调和固定间隔两种循环模式，由模型自主控制执行节奏
- TUI 循环控制：UI 底部状态行显示循环状态和轮数，支持 /loop stop 停止
- 循环上限：支持配置最大循环轮数，防止无限执行
Agent / 工具
- TaskTool 子 Agent 执行：支持将子任务派发给隔离上下文的子 Agent，支持 Explore（只读）和 Worker（可编辑）两种模式，默认 3 个并发，15 分钟超时保护
- 强/弱档位路由：按模型能力自动选择 fast/capable 档位，支持 /model 切换后重新解析
- 子 Agent 实时进度：每个子任务在 TUI 上显示当前动作和描述，支持可配置超时
- 敏感路径保护：子 Agent 自动拒绝访问凭据、~/.ssh、.env 等敏感路径
- 子任务崩溃展示：子 Agent 崩溃（JoinError）不再静默吞掉，而是作为错误结果展示
/save 对话导出
- 对话导出：/save 命令将当前对话完整导出为 Markdown 文件
- 路径保护：展开 ~ 路径、拒绝覆盖非 Markdown 文件
/todo 任务清单系统
- 任务清单工具：todowrite 工具以无状态全量列表方式管理任务，每轮自动注入当前清单作为 system-reminder
- TUI 紧凑渲染：以字形列表块（glyph list）紧凑展示，底部 footer 显示 N/M 进度指示
- /todo 命令：重新打印当前任务清单，循环模式下也持续显示进度
- 环境开关：通过 ATOMCODE_TODO 环境变量或 config.ui.todo 控制启用
审批模式（跨客户端通⽤）
- 三种模式：Build（默认，需要审批）、Plan（只读探索和规划）、Bypass（自动审批所有工具调用）
- Plan 模式系统提示：注入只读模式提示，自动拒绝所有改动类工具调用
- WebUI 模式选择器：WebUI 内置 Build/Plan/Bypass 切换 UI
- VSCode 模式支持：支持 Build 模式审批和 Plan 只读模式
- 桌面↔App 双向同步：模式变更在桌面端和 App 端实时同步
WebUI 交互能力增强
- 斜杠命令系统：完整的斜杠命令解析、注册、分发机制，前台命令（/plan、/build、/model、/cd 等）和后端命令（/undo、/compact、/whoami、/status 等）均支持
- 项目管理：侧边栏项目选择器，可浏览各项目的完整会话历史，支持"打开其他目录"操作
- 会话内消息搜索：在当前会话中按关键词搜索消息并反查定位到原文
- 消息发送时间标记：每条消息显示发送时间，智能格式（今天→HH:MM、昨天→昨天+时间、更早→月/日/年+时间）
- CD 更新当前目录：/cd 命令更新工作目录并反馈确认
- 滚动跟随优化：仅当位于底部时自动跟随流式输出，并提供跳到底部按钮
- 技能菜单：/skills 打开仅显示技能的浏览器（而非重置到首页）
守护进程（Daemon）斜杠命令
- POST /command 执行器：统一的无状态斜杠命令后端，支持 /undo、/compact、/context、/whoami、/status、/config、/diff、/cost、/todo、/remember、/forget、/memory
/context 上下文统计
- /context 命令：支持查看当前会话的详细上下文使用统计
Provider / 模型
- 上下文窗口档位展示：在 prompt 中显示 128K/256K/512K/1M 等上下文窗口分档
- /provider 编辑 context_window：/provider add & edit 支持设置 context_window
- DeepSeek 执行纪律：强化验证钩子，git diff、ls、cat 等只读命令不再被视为有效的构建验证
终端渲染 / TUI
- Todo 进度指示器：底部专用 footer 行显示 task + N/M 进度（循环模式下持续可见）
- 子任务渲染：清理后的子任务渲染——描述头 + 每个子任务的模型/状态行
- 调整大小时保持 Markdown 状态：保留流式代码块的 fence 上下文
Apple App（移动端）
- 登录网关：App 登录门控 + 8h 滑动过期自动关机
- 安全认证：App 端与桌面端间的安全认证与双向鉴权
- 会话名显示：App 端正确显示当前会话名称
- /app 命令：启用 /app 命令，退出时自动清理 App 服务器
VSCode 扩展
- 审批模式：支持 Build/Plan/Bypass 三种模式，包括审批卡片的 UI 同步
- 环境检测与守护进程客户端：增强的守护进程连接管理和环境变量检测
其他新特性
- grep 流式处理：按文件流式读取而非一次性全读内存，匹配数上限准确报告
- Locale 规范化：bash 子进程自动规范化 UTF-8 locale 设置
- 路径归一化：Windows/macOS 路径大小写不敏感处理
- 终端输出净化：bash 工具输出送到模型前做净化处理
- 技能目录识别：插件和技能文件的所属路径识别更准确
- 精选插件列表截断：TUI 首次安装时精选插件列表限制为 5 条

🛠 修复（Fixes）
WebUI
- 侧边栏项目作用域：按物理项目桶而非可变 working_dir 划分侧边栏，正确显示各项目的完整会话历史
- 模式切换通知：仅在模式成功切换后显示通知
- /undo 命令：发送 project_hash，仅在撤销数 > 0 时重载，防止会话切换时误重载
- CD 反馈：/cd 更新 cwd + 反馈，保护 dispatch/reload 失败，重置技能菜单查询
- 滚动跟随：仅当在底部时自动跟随发送消息，不因仅排队消息而触发滚动
- 审批卡片闪烁：修复 Plan 模式下切换审批模式时审批卡片闪烁的问题
- Bot 审查修复：处理代码审查的多轮 P1~P3 反馈，包括搜索稳定性、时间戳格式、死代码删除等
/loop 循环
- 停不掉修复（P0）：修复 /loop stop 在 turn streaming 期间停不掉的问题
- UI 卡死修复（P0）：修复自定步调停止或 round 上限后 UI 卡死在 Streaming 状态的问题
- 完整停止路径：/loop stop、/clear、替换命令均正确清除循环状态
- 间隔模式轮数上限：固定间隔模式正确遵守配置的 max_rounds
缓存与压缩
- 模型不再烦新对话：压缩后告知模型不要提示用户"开启新对话"
- 窗口感知：针对当前模型窗口计算利用率压力，不是硬编码值
- 上下文保留：保留最近工作上下文而非仅活跃轮，摘要输入规模有界
SubAgent
- 会话 ID 复用：子 Agent 复用父会话 ID，修复 GLM 并发 fan-out 的问题
- 子任务完成渲染：修复子任务完成时不高亮重复渲染的问题
Daemon
- 桶对称保存：修复 undo/compact 写入与加载时桶不一致导致的幽灵副本问题
- 前端排走索引修复：修复 /compact 对 display/turn 锚点做前移除时索引计算错误的问题
TUI / 终端渲染
- Tofu 渲染修复：ASCII 降级装饰性字形（□ tofu），支持 cell 级兜底
- 恢复上下文表尺：重启对话后重新挂起上下文表尺，/context 不再卡在 100%
- /save 路径规范化：展开 ~ + 拒绝覆盖非 Markdown 文件
- Todo 渲染：todowrite 在 /resume 后正确渲染为样式块，进行中的 todo 不再显示为 ! 警告
- 任务块拆分：按行首边界而非内联 <task 拆分任务块
- Bash 提示：显示 !bash footer 提示 + 使 !cmd 可通过上箭头回叫
- /copy msg：恢复转写后的最后回复
- 双 Esc 撤销冷却：修复快速连按 Esc 造成多重撤销的问题
Provider / 网络
- 代理默认：默认跟随系统代理设置，环境代理开箱即用
- 图片降级：修复纯文本模型对话中图片导致异常的问题，自动将图片转为文本描述
- 上下文窗口：溢出恢复时仅保留活跃轮，最大限度压缩以适应
会话管理
- macOS 路径大小写折叠：修复 macOS 上路径大小写敏感导致的会话加载问题（带一次性桶迁移）
- Session ID 绑定：修复 daemon v1、WebUI/Live 视觉预处理和辅助 LLM 调用的 session-id 绑定
其他
- Telemetry 隐私：从工具调用失败遥测中脱敏 secrets
- Edit 缩进：统一缩进为字符数而非字节数
- Grep 天花板统计：报告匹配数（而非总行数）的上限
- 任务 JSON 拒绝提示：子 Agent dispa

AtomCode v4.25.9 Release Notes
发布日期：2026-07-04
本版本聚焦于终端体验增强与稳定性改进：新增终端标签栏状态圆点，让您无需切换窗口即可一眼判断 Agent 状态；AI 会话自动命名功能上线，告别晦涩的 session-ts 占位符；同时修复了 Windows 平台的多项兼容性问题与 ACP 连接稳定性问题。

⚠️ Behavior Changes（注意行为变化）
- 终端标签栏标题默认显示状态圆点：现在终端标签栏/窗口标题会默认显示 🟢（空闲）/ 🟡（忙碌）/ 🔴（待确认）状态圆点。如果您的终端渲染 emoji 为豆腐块，可通过 ui.terminal_status_glyph = false 关闭。
- AI 会话自动命名默认开启：首次对话完成后，AI 会自动为会话生成一个可读的名称（如“修复登录报错”），替代原有的 session-时间戳 占位符。可通过 ui.ai_session_naming = false 关闭，或通过环境变量 ATOMCODE_AI_SESSION_NAMING=0 禁用。
- Ctrl+O 提示时机调整：实时输出提示（"Press Ctrl+o to show real-time output"）现在在工具调用开始时显示，而非结束后，让您能在命令运行期间就开启实时输出。
✨ 新增功能（Features）
终端渲染
- 终端标签栏状态圆点：在终端标签栏/窗口标题前缀一个按状态变化的彩色圆点（🟢 空闲 / 🟡 忙碌 / 🔴 待确认），让您无需切换到 AtomCode 窗口即可感知任务状态。可通过 ui.terminal_status_glyph 配置开关（默认开启）。
- 会话名显示在终端标题：终端标签栏标题现在会显示当前会话的名称（而非遗留的旧版本号），新窗口默认显示 atomcode v4.25.9。
Agent / 工具
- AI 会话自动命名：首次对话完成后，AI 会根据对话内容自动为会话生成一个简短、有意义的名称（最多 6 个词，40 字符），显示在 /resume 选择器和终端标题中。支持中英文，自动去除引号/标签/控制字符。可通过 ui.ai_session_naming 配置开关（默认开启）。
- > nul 自动重写为 /dev/null：在 Windows Git Bash 环境下，模型常用的 > nul 输出丢弃写法会创建一个无法删除的 nul 文件。现在工具会自动将 > nul 重写为 >/dev/null，避免产生垃圾文件。bash 工具描述也已更新，引导模型使用正确的语法。
WebUI
- AI 会话重命名广播：AI 自动生成的会话名称会通过实时流广播到所有 WebUI 标签页，每个标签页仅当自己正在查看的会话被改名时才更新标题，避免串台。
🛠 修复（Fixes）
ACP 连接稳定性
- 修复 catch-all 拦截审批响应导致会话崩溃：修复了 ACP 协议中 catch-all 消息处理器错误地拦截了 session/request_permission 的响应消息，导致每次审批（即使是“允许”）都返回“未处理消息”错误，进而断开整个 ACP 连接并清空客户端线程的严重问题。现在响应消息会正确路由到等待的审批处理器。
- 审批失败不再断开连接：handle_approval 的往返失败（如用户取消/ESC/发送意外消息）现在会优雅地拒绝该工具调用并继续当前轮次，而不是传播错误导致整个 ACP 连接断开。
终端渲染 / Windows 兼容
- 修复 /cd 路径泄露 \\?\ 前缀：修复了 Windows 上 /cd 命令后工作目录、状态栏、WebUI 页脚显示 \\?\C:\... 原始路径的问题。现在所有路径都会统一去除 Windows 的 verbatim 前缀。
- 修复 /cd 选择器重复显示相同目录：修复了 recent_dirs.txt 中同时存在 \\?\C:\... 和 C:\... 两种形式时，目录选择器会显示两个相同目录的问题。现在加载时会自动去重。
- 修复浏览器打开失败（打开文件夹而非浏览器）：修复了 Windows 上 OAuth 登录时 explorer.exe <url> 在某些情况下（如冷启动浏览器）会打开一个文件资源管理器文件夹窗口而非浏览器的问题。现在使用 ShellExecuteW 直接调用默认浏览器，更可靠。
- 修复 Git Bash 下 > nul 创建无法删除的文件：见新增功能说明。
- 修复实时流 eprintln 污染 TUI：修复了 WebUI 实时同步路径中残留的 eprintln 调试输出写入终端，导致 TUI 界面被污染的问题。所有诊断输出已改用文件日志。
会话管理
- 修复 /compact 在思考模型上可能挂起：修复了使用思考模型（如 GLM-5.2）时，/compact 命令的摘要 LLM 调用可能因模型长时间隐藏推理而挂起 20 分钟以上的问题。现在设置了 120 秒的硬超时，超时后自动降级为温和的就地压缩策略，并提示用户超时原因。
- 修复紧急溢出恢复在思考模型上冻结：修复了上下文溢出时的紧急恢复（Tier-2 摘要）同样可能被思考模型挂起的问题，现在也应用了 120 秒超时保护。
其他修复
- 修复 AI 会话重命名实际不生效：修复了 AI 会话重命名的守卫逻辑错误地拒绝了所有 AI 生成的名称（因为会话已被首次消息截断命名），导致该功能完全静默失效的问题。现在 AI 名称会正确覆盖首次截断的占位符名称。
- 修复 /rename 在 WebUI 下作用域错误：修复了 WebUI 中 /rename 命令的 AI 重命名广播缺少 session_id，导致所有标签页的标题都被错误更新的问题。
🔧 重构（Refactoring）
- 终端标题逻辑提取为纯函数：将终端标题的生成逻辑（状态圆点映射、名称截断、控制字符清洗）提取到独立的 title.rs 模块，便于单元测试和维护。
- AI 会话命名逻辑提取为核心模块：将 AI 会话命名的纯逻辑（提示词构建、输出清洗、守卫判断）提取到 atomcode-core 的 session_title.rs 模块，便于跨组件复用和测试。
📚 文档（Docs）
- 修复了 README 中捐赠二维码的图片路径（多余空格）和错误 alt 文本。
- 新增了终端状态圆点的设计与实现文档。

AtomCode v4.25.8 Release Notes
发布日期：2026-06-30
本版本聚焦于移动端远程访问、代码审查质量提升、VS Code 扩展国际化、以及多项稳定性与用户体验改进。

⚠️ Behavior Changes（注意行为变化）
- 代码块自动复制默认关闭：config.ui.auto_copy_code_blocks 默认值为 false，不再自动复制 AI 回复中的代码块到剪贴板。用户可通过 ATOMCODE_AUTO_COPY 环境变量或配置文件手动开启。显式 /copy 命令不受影响。
- /status 命令输出结构调整：登录状态行移至最前，Token 行移除（移至 /cost），CodingPlan 过期时显示清晰的重新登录提示。
- Windows Shell 描述修正：当 Git Bash 可用时，bash 工具描述和系统提示中的 Shell: 行现在如实报告为 bash，而非之前的 cmd.exe，避免模型使用错误的语法。
- /app 命令默认隐藏：/app 移动端远程访问命令默认不显示在命令菜单和补全中，需设置 ATOMCODE_ENABLE_APP=1 环境变量启用。
✨ 新增功能（Features）
移动端远程访问
- /app 命令（隐藏）：新增 /app 命令，通过反向 WSS 隧道将当前 TUI 会话暴露给 GitCode 移动 App，支持任意网络下的双向实时同步、工具审批、远程命令执行和模型同步。/app stop 断开连接。
- 自动下载 relay-client：首次使用 /app 时，自动从 GitCode Release 下载并校验 atomcode-relay-client 二进制，支持 SHA256 校验和版本管理。
Agent / 工具
- Agent Client Protocol (ACP) 支持：新增 atomcode acp 子命令，使 AtomCode 可作为 ACP Agent 通过 stdio 被外部编辑器或编排器驱动。支持 initialize、session/new、session/prompt、session/cancel 及权限审批流程。
- 代码审查质量提升：
- 新增 --context-window 标志，允许为审查 Agent 设置自定义上下文窗口大小。
- 新增 --no-web 标志，禁用 web_search 工具，适用于无网络环境。
- 新增 --graph-max-files 标志，当仓库索引文件数超过阈值时自动降级，跳过代码图谱构建，避免大仓库超时。
- 新增影响面计划（Impact Plan），在审查任务中注入符号变更和生命周期契约检查，引导模型优先探索高风险区域。
- 新增轮次预算压力钩子（Round Budget Hook），在 --max-rounds 限制下，模型接近轮次上限时提示其优先提交已发现的发现。
- 新增覆盖率兜底机制：首次审查后，对零发现的变更文件进行二次聚焦审查，提升大 diff 的召回率。
- @-mention 目录下钻补全：在 TUI 和 WebUI 中输入 @ 后，选择目录可继续下钻浏览子目录和文件，提升文件引用效率。
- 输入历史导航：在 TUI 输入框中，光标位于行首时按 ↑/↓ 可浏览历史输入记录。
- /review 等命令国际化描述：为 /app、/sync、/review、/goal、/proxy 命令添加了中英文描述。
- Agent 提示优化：
- 为 GLM/DeepSeek 等弱指令遵循模型添加了强制的工具纪律块（TOOL DISCIPLINE），明确禁止用 shell 执行文件操作。
- 恢复 v2 端口丢失的三个行为护栏：反谄媚、禁止 bash 修改文件、坚持完成。
- 恢复注释密度规则，限制新注释数量，保留现有中文注释。
- 将“最小化工具调用”改为“最小化往返次数”，避免与并行工具调用建议矛盾。
- 将 REPRODUCE 步骤改为条件性执行，仅当存在可运行的复现命令时才执行。
WebUI
- 会话导出为 Markdown：在侧边栏和表头菜单中新增“导出 Markdown”按钮，可将完整会话（含用户消息、AI 回复、工具调用及结果）导出为 .md 文件。
- 复制按钮增强：助手消息新增复制按钮，可复制整轮对话内容（含工具调用）。用户消息也新增了复制按钮。
- @-mention 菜单滚动：@-mention 弹出菜单现在支持键盘导航时自动滚动到当前选中项。
- / 和 @ 命令菜单统一选择态颜色：统一了斜杠命令菜单和 @-mention 菜单的选中态背景色和强调色。
VS Code 扩展
- 国际化（i18n）支持：
- 扩展清单（package.json）使用 %key% 占位符，并提供了英文和简体中文的 package.nls.json 文件。
- 扩展运行时字符串使用 vscode.l10n.t 进行本地化。
- Webview UI 使用 TypeScript 目录和 I18nProvider，根据 VS Code 语言环境渲染中文或英文界面。
- 快速操作（Quick Actions）的提示文本根据语言环境切换。
- @-mention 文件引用：在 VS Code 扩展的 Webview 输入框中支持 @ 触发工作区文件搜索和补全，支持目录下钻。
- 输入历史导航：在 VS Code 扩展的 Webview 输入框中支持 ↑/↓ 浏览输入历史。
- Artifact 渲染：Webview 支持 Artifact 的块级渲染，包括代码、diff 和 Markdown 内容的独立展示。
- 流式 Markdown 修复：修复了流式输出时未闭合代码块的渲染问题，并保护内联代码中的 fence 标记不被错误解析。
Provider / 网络
- Provider 身份标识：所有 Provider 适配器（OpenAI、Anthropic、Ollama）现在发送产品级 User-Agent（atomcode/<version>）和 x-atomcode-session-id 头，便于网关进行流量归因和前缀缓存亲和性。
- skip_tls_verify 支持：Provider 配置新增 skip_tls_verify 字段，允许为自签名/内部网关禁用 TLS 证书验证。
- user_agent 配置项：Provider 配置新增 user_agent 字段，允许覆盖 HTTP 请求的 User-Agent。
- CodingPlan 请求重试：claim-v2、status-v2 等 CodingPlan API 调用在遇到瞬态传输错误时自动重试，提升稳定性。
终端渲染 / Windows 兼容
- Windows Git Bash 检测增强：改进了 Windows 下 Git Bash 的检测逻辑，支持从 git.exe 路径推导、注册表查询以及非 C: 盘安装的 Git。
- Windows WSL 别名排除：bash 工具检测时排除 WindowsApps 目录下的 WSL 执行别名，避免误用 WSL。
- Windows 浏览器打开修复：修复了 Windows 下通过 explorer.exe 打开含 & 符号的 URL 失败的问题。
- WebUI 图片历史展示修复：修复了 WebUI 中图片历史展示的问题，并恢复了 V2 Live 模式下的图片显示。
LiveSession 增强
- 断线恢复进行中回合：LiveSession 新增 join_with_replay 方法，晚加入的视图（如手机重连）可获取当前进行中回合的事件回放，避免丢失进度。
- 会话持久化增强：V2 Live 模式下，在回合开始、流式过程中和结束时均会持久化会话到磁盘，防止硬杀导致整轮会话丢失。
- 远程命令：手机 App 可通过 /live/command 请求桌面 TUI 执行只读信息类命令（/status、/cost、/whoami、/diff），输出通过 CommandOutput 事件广播。
- 取消运行中回合：新增 /live/cancel 端点，任一视图（手机/WebUI/TUI）均可取消正在运行的回合。
缓存稳定性
- 锚定压缩（Anchored Compaction）：压缩摘要现在以锚定标记（<!-- atomcode:anchor v1 -->）开头，后续压缩会更新而非重写该摘要，避免逐次退化。仅当有非锚定新内容时才触发压缩。
- 代码图性能优化：CodeGraph 新增 by_name 索引，将 find_by_name 从 O(nodes) 扫描优化为 O(candidates) 哈希查找。build_from_files 使用精确的 caller id 重建，修复了跨文件同名符号的调用者归属错误。
🛠 修复（Fixes）
Agent / 工具
- 修复重试退避不可取消：所有重试退避（空响应、限流、API 错误）现在均可被取消令牌中断，用户按 Esc/Ctrl+C 可立即停止等待。
- 修复死内核报告：当内核在 prompt 发送前已死亡时，ACP 和 V2 引擎正确报告错误，而非伪造 end_turn 成功。
- 修复 ~ 路径展开：read_file、glob、list_directory 等工具和代码图工具现在统一通过共享的 pathutil 展开 ~/ 路径，与 shell 行为一致。
- 修复 MCP 工具参数截断：MCP 工具参数详情显示上限从 2

AtomCode v4.25.7 Release Notes
发布日期：2026-06-30
本版本聚焦于限流体验重构——当 CodingPlan 5 小时窗口耗尽时，不再粗暴红字报错，而是优雅暂停并显示恢复时间，近期窗口自动续跑。同时引入密码弹窗（sudo/SSH askpass 支持）、统一代理策略、会话原子写入、Windows 兼容性强化及多项稳定性修复。

⚠️ 注意行为变化
- 限流（429）体验重构：v2 引擎收到 5 小时窗口限流时，按 reset 剩余时间分流——≤2 分钟自动等待续跑，>2 分钟优雅暂停并显示恢复时间，保住已产出内容，不再红字报错。非 CodingPlan 用户行为不变。
- 上下文百分比始终显示：TUI 底部上下文使用率（%）不再只在 ≥90% 时出现，现在始终显示，方便观察接近自动压缩阈值（~70%）的趋势。
- Esc 撤销上一轮：空闲且输入框为空时，连按两次 Esc 可撤销上一轮（2 秒窗口内）。首次 Esc 会显示提示。
- Ctrl-C 取消默认保留中断内容：新配置项 keep_interrupted_context = true（默认），取消时保留部分工作并注入中断标记，下一轮可继续。设为 false 恢复旧版撤销行为。
- WebUI 字号调大：对话区、输入框、代码块等字号统一增大，提升可读性。
- JetBrains 插件移除 JCEF 硬依赖：通过反射调用 JCEF API，兼容无 JCEF 的 IDE 环境。

✨ 新增功能（Features）
Agent / 工具
- 限流暂停-自愈：v2 引擎收到 429 时，通过宿主 RateLimitHook 查询 CodingPlan 窗口，≤2 分钟自动等待续跑，>2 分钟优雅暂停。支持 OPEN 和 mid-stream 两种 429 场景。
- 输出截断自动续跑：模型输出因 token 限制截断时，自动注入续写提示继续生成（上限 2 次），不再静默结束回合。
- 误路由答案恢复：当模型答案被网关误放入 reasoning 通道时，自动提升为正文内容，用户不再看到空白回复。
- read_file 支持视觉模型：read_file 工具新增 vision 模式，视觉模型读取图片文件时返回 base64 图像而非"Binary file"文本。
- web_search 显示来源域名：TUI 中 web_search 结果行显示来源域名（如 eol.cn, gaokao.com +2），替代通用行数统计。
- todo 更新显示任务标题：todo update 工具调用行显示任务名称而非仅 ID（如 #4 Write tests → completed）。
- Goal 模式增强：新增轮数/时长上限（goal_max_rounds/goal_max_duration_secs）、连续无产出熔断、并行编辑文件追踪、评估器失败回退到默认 provider。
- 输出截断警告延迟：截断后若自动续跑成功则不发出警告，仅在无法恢复时提示。
Provider / 网络
- 统一代理策略：新增 [network.proxy] 配置，支持 follow_system / default_proxy / no_proxy 三种模式，所有出站 HTTP 客户端（provider、MCP、web_fetch、telemetry、self-update）统一遵守。
- Retry-After HTTP-date 解析：provider 层支持解析 HTTP-date 格式的 Retry-After 头（如 Anthropic 某些 429 响应），用于限流自愈。
- /proxy 命令：TUI 新增 /proxy 命令，交互式切换代理模式。
终端渲染 / Windows 兼容
- 密码弹窗（Askpass）：Unix 下新增 sudo/SSH 密码弹窗——子进程请求密码时弹出掩码输入框，密码不进入输入历史。支持 5 分钟缓存。
- Esc Esc 撤销：空闲空输入框时连按两次 Esc 撤销上一轮，首次 Esc 显示提示。
- Conhost 滚动提示：经典 Windows 控制台（conhost）启动时显示一次提示，告知任务执行中无法上滚，建议使用 Windows Terminal。
- Windows shell 兼容性：自动检测 Git Bash/MSYS2 bash，优先使用 bash 执行命令；仅当 bash 不可用时回退 cmd.exe 并拦截不兼容的 bash 语法（$()、<<<、< <()）。
- Windows GBK 编码修复：自动设置 PYTHONUTF8=1 环境变量，修复 Python 子进程在 GBK 编码下的 UnicodeDecodeError。
- Windows 路径 JSON 修复：工具参数 JSON 中未转义的 Windows 路径（如 D:\test\foo.py）自动修复，防止 \t/\f 被误解析。
- JSON 修复中间件：新增 RepairToolArgsMiddleware，自动修复模型输出的 JSON 参数（尾逗号、单引号、未转义引号/换行、Markdown 围栏等），降低弱模型工具调用失败率。
- 文件系统门控超时：权限门控的路径规范化操作增加 3 秒超时，防止挂载卡死导致整个回合冻结。
- Spinner 不闪烁工具名：工具执行期间 footer spinner 不再闪烁工具名，保持思考词一致。
WebUI
- 限流暂停卡片：WebUI 渲染限流暂停为暗色中性卡片（非红色错误），显示恢复时间，保留已完成内容。
- 会话切换同步：WebUI 侧栏切换会话时广播给同步模式的 TUI，TUI 加载该会话历史并切换工作目录。
- 同步开关重连：WebUI 重新开启同步时先广播当前会话给 TUI，再启动实时流，避免 TUI 被孤立。
- 新建会话同步控制：WebUI 新建会话时仅当 sync 开启才广播，sync 关闭时不牵连 TUI 新建。
- 字号调大：对话区、输入框、代码块等字号统一增大，提升可读性。
- GFM 删除线禁用：禁用 Markdown 波浪号删除线解析，避免 ~ 被误识别（issue #825）。
LiveSession 增强
- TUI→WebUI 会话切换同步：TUI 本地切换会话（/new、/session、/resume 选择历史会话等）后双向同步到 WebUI，补齐此前只有 WebUI→TUI 的单向同步缺口。
- 会话切换自回声守卫：避免广播回流导致双重渲染。
- 限流事件实时广播：RateLimited 事件通过 LiveWire 广播到 WebUI，渲染暂停卡片。
缓存稳定性
- 会话原子写入：SessionManager::save 使用原子写入（临时文件 + rename），防止部分写入损坏会话文件。
- 输入历史并发写入保护：InputHistory::append 增加文件锁，防止并发写入导致数据损坏。
- 粘贴内容历史回放：Up-arrow 回放历史时恢复粘贴内容（[Pasted #N] 占位符），不再发送字面占位符（issue #843）。
Plugin
- JetBrains 插件：官方 JetBrains 插件已上架 Marketplace，支持 IntelliJ IDEA / WebStorm / PyCharm / GoLand。
- JetBrains 移除 JCEF 硬依赖：通过反射调用 JCEF API，兼容无 JCEF 的 IDE 环境。
- JetBrains Artifact 流式渲染：修复 Artifact 代码块流式渲染，支持增量更新和围栏长度自适应。
权限 & 安全
- 信号安全终端恢复：Unix 下安装 SIGTERM/SIGINT/SIGHUP 信号处理器，被信号杀死时恢复终端（退出 raw mode、关闭 bracketed paste、弹出 Kitty 键盘协议），防止 shell 出现乱码。

🛠 修复（Fixes）
Agent / 工具
- 429 限流死锁修复：修复 429 WaitAndRetry 可能导致的活锁，增加 MAX_RATE_LIMIT_WAITS（5 次）安全熔断。
- Goal 模式修复：修复 goal 结束时未清除导致下一轮"僵尸复活"的问题；修复 MaxContinuations 计入无产出计数器；修复评估器失败时回退到默认 provider。
- 并行编辑测试隔离：parallel_edit 测试使用独立临时目录，避免共享 temp_dir 导致构建探测误判。
- Agent 循环修复：修复 truncation recovery、增量输出控制、spinner/stall UX 等问题。
- SubAgent 子回合修复：修复子 agent 推理内容被错误提升为正文的问题。
终端渲染 / Windows 兼容
- 粘贴内容丢失修复：修复历史回溯时粘贴内容发送的是 [Pasted #N] 占位符而非正文的问题（issue #843）。
- Windows 控制台窗口频闪修复：抑制 daemon 路径残留 spawn 的控制台窗口频闪。
- Windows cmd.exe 引号修复：修复 cmd.exe 下引号被吞的问题，提示模型使用 cmd.exe 语法。
- Windows 路径修复：修复工具调用参数中 Windows 路径的 JSON 转义问题（D:\test → D:<TAB>est）。
- 信号杀死终端恢复

AtomCode v4.25.6 Release Notes
发布日期：2026-06-25
v4.25.6 带来 WebUI 全面焕新（Landing 欢迎页、Skills/MCP 菜单、会话搜索、工具行内样式）、JetBrains 插件大幅增强（欢迎引导页、剪贴板图片、文件拖拽、JCEF 可选依赖）、TUI /cd 选择器实时过滤、并行编辑逐文件进度、LiveSession 同步全面强化，以及大量稳定性修复——Windows 兼容、Provider 重连、MCP 信任持久化、自动压缩升级等。

✨ 新增功能（Features）
WebUI
- Landing 欢迎页面：首次加载显示欢迎语与快捷操作 chip（/code-review、Explain code、Run tests），提升新用户引导体验
- Skills 菜单：侧栏新增技能列表展示与点击插入
- MCP 服务器面板：侧栏新增 MCP 按钮，弹出面板展示服务器名称、连接状态、工具数量
- 会话搜索弹窗：侧栏搜索按钮打开居中模态弹窗，支持 Esc 关闭与点击遮罩关闭，打开自动聚焦输入框
- Tool 调用行内极简样式：按工具类型（文件/搜索/编辑/终端/网页）显示图标与运行状态（完成✓ / 失败✗ / 进行中 spinner）
- 会话列表按日期分组：今天/昨天/更早分组展示，移除旧 GroupBy
- 新会话首发即时显示：发送首条消息立即以消息前 10 字作为临时标题出现在侧栏，落盘后刷新为真实标题
- 输入区 subbar 键盘提示行：Enter 发送 · Shift+Enter 换行
- 账号登录/退出整合：头像保留在侧栏底部，退出登录移入设置菜单
- 同步图标对齐：sync 按钮改用 Lucide arrow-left-right SVG 图标
- 工具审批弹窗 UI 统一：品牌色 + 菱形 logo + 衬线标题，按钮收敛为单色强调样式
JetBrains 插件
- 欢迎页面和启动引导：首次启动自动显示欢迎页（仅一次），包含快速开始、选中代码操作、输入命令、文档链接，支持中英文切换
- 剪贴板图片粘贴为附件：支持多渠道提取剪贴板图片（AWT Transferable、CopyPasteManager、系统剪贴板、macOS NSPasteboard），统一转 PNG 格式并检测大小限制，支持缩略图预览与点击查看大图
- 文件拖拽上传：支持从系统拖拽文件到输入区，优先尝试文件列表/uri-list
- IDE 主题色动态跟随：面板背景/边框/前景色改用 UIUtil/UIManager 动态获取，跟随 IDE 主题切换
- 轮次摘要：流式消息末尾显示本轮时长、tokens 用量、工具调用统计
- Home 按钮：ToolWindow 标题栏 + Tools 菜单添加回到首页入口
- 命令弹窗增强：编辑器 Action 重构，命令弹出体验优化
- 中文本地化：界面中文文案补充与优化
TUI
- /cd 选择器实时过滤：打字即按 query（大小写不敏感子串）实时过滤最近目录列表，↑↓ 在过滤结果内移动；Enter 进入高亮最近目录，无匹配时回落为输入路径
- /cd 选择器支持直接输入路径：支持直接键入路径而非仅从列表选择，resolve_cd 认 ~\ 反斜杠
- 并行编辑逐文件实时进度：子代理按真实完成顺序实时显示 ↻/✓/✗ 状态，默认可见（不再需要 Ctrl+O 开启）
LiveSession 同步增强
- WebUI ↔ TUI 会话双向跟随：webui 切到已存在会话时，TUI 同步加载该会话历史与工作目录，三端落同一会话；发起端带 alreadyViewing 护栏避免广播回流抹掉本地历史

🛠 修复（Fixes）
Provider / 网络
- v2 流式首个事件前断流透明重开：首个 SSE 事件到达前断流时自动重试一次，对齐 v1 行为
- 连接重置加固重连：网关在读 SSE 响应体中途断连时（Windows os error 10054），重试次数 2→3 并加入短退避，失败时显示中文友好提示「网络连接中断…可重试」，不再裸抛原始错误链
- 网关签名器每次请求现取 token：/login 后同步聊天不再报「认证已过期」
- 区分 SSE 格式错误与空响应：重试提示文案更精确
WebUI
- Token cookie 按端口区分：多实例（如 VSCode + standalone）不再互相覆盖 cookie 致 401
- 同步开关状态写回 URL ?sync 参数：刷新后保持开/关状态，不再关闭后刷新又被开启
- 技能/MCP 下拉菜单无法滚动：scroll 事件捕获阶段过早关闭菜单——修复后正常滚动
- 切换工作目录不再每次都新建会话：/cd 切换目录后保持当前会话
- Sync 模式下 TUI /cd 同步到 webui 工作目录显示：新增 WorkingDir wire 事件，前端面包屑与侧栏路径跟随
- 新会话落地页只在无 sessionId 时显示：避免已有会话时闪屏
- 搜索弹窗加宽并适配手机端：移动端操作体验优化
JetBrains 插件
- 移除对 com.intellij.modules.jcef 的硬依赖：通过反射调用 JCEF API，JCEF 成为可选能力——不再因缺少 JCEF 导致插件加载失败，优雅降级不影响核心功能
- 适配新版 JCEF API：移除已弃用方法和导入，兼容 IntelliJ 2026.x
- UI 主题与签名配置优化：Plugin metadata、签名配置、settings 状态适配更新
- 删除会话/无会话时恢复显示欢迎页：不再卡在空白页面
Windows 兼容
- edit_file/search_replace 容错 CRLF：read_file 抹掉的 \r 不再让编辑永久失配
- Glob 识别 pattern 中的绝对路径：G:\path\to\* 等 Windows 绝对路径正确解析，不再误判「不存在」
- Bash 输出按控制台 OEM 编码解码：中文 Windows 控制台 GBK 输出（如 keytool）正确显示而非 ◇◇◇
- 控制台抑制扩展到全部 v2 spawn 点：不再每次对话闪控制台窗口，涉及 bash、cc_hooks、ast_grep、atomgit、open_file、LSP 客户端、skill 执行、MCP oauth 等所有子进程
MCP
- .mcp.json 的 trust/autoApprove 真正生效：v2 引擎补移植信任与自动批准子系统——受信服务器返回 Safe（不弹审批），autoApprove 按工具名而非 args 持久
- 「总是」对 MCP 持久：always_grant_scope 按工具名固化，不再每次按 args 重弹
- /setup 安装 MCP 写对路径：写到 .mcp.json（加载器读取路径），不再写进读不到的 .atomcode/mcp.json
TUI 稳定性
- Resize 无条件清 scrollback：长会话不再叠重复输出（#709 收尾）
- /cd 后重建 SessionManager：/resume 正确列出新项目的历史会话
- /quit 退不出去修复：退出链加 watchdog（8s deadline）+ bridge 内核 teardown 有界（5s 超时 + abort），任一环卡死不再阻止退出
- 超窗/空白轮可观测性：上下文利用率 >=90% 时显示百分比（如 170%）；空白推理轮提示「按 Ctrl+O 查看推理」；发送前对 >= 窗口的请求预警，节省后续多次空重试
- 限定自定义命令文件大小：防止启动时 OOM
缓存与压缩
- 自动压缩高水位升级为抽干+摘要：利用率 >=85% 时自动执行与 /compact 相同的抽干+摘要策略，不再只折叠工具结果——长会话上下文不再一路爬升
- 自动压缩防抖：超窗粘贴场景下预估算抽干后残留是否仍超窗口 85%，是则退回廉价 stub，不再付 LLM 摘要代价
- 压缩进度提示：Auto/Overflow 压缩时显示「compacting…」进度
- 自动降量后立即刷新上下文用量：用量百分比即时更新
Agent / 工具
- 停止时彻底中止多轮 turn 循环：Cancel 不再仅中断当前步骤，而是中止整轮循环
- Edit 移植 v1 空白容错 fuzzy 回退：tab/空格不一致也能改成功，不再逼模型写脚本
- Read 移植 v1 GBK 解码 + 二进制恢复提示：兼容 GBK 编码文件，二进制文件给出恢复建议
- Web_fetch 回填 forge 源码页主导代码块抽取：提升代码托管平台页面抓取质量
- 统一宽松数字解析策略：拒绝负数/NaN 而非静默归零
- 使用 SHA-256 替代 DefaultHasher：获取进程间稳定的缓存键
- PreToolUse hook allow 跳过审批：已授权插件不再重复弹审批
- 处理预发布版本号后缀：version_check 正确识别 pre-release 版本
- 审批 parse 失败时要求重新 review：避免错误批准
- -y bypass 跨 v1 runtime 传播：Relaunch 后仍保持无需确认
其他
- Session 重命名后发送对话名称不被覆盖：重命名后保留自定义名称
- 冻结天粒度日期锚点进 persona：补齐 round-1 日期信息（对齐 v1）
- TUI 

AtomCode v4.25.5 Release Notes
发布日期：2026-06-23
v4.25.5 是一个紧急修复版本，聚焦于两处关键问题：CC Hooks 插件 hook 因启动失败误阻塞所有对话 / 工具的回归问题，以及 v2 引擎下网关偶发返回空响应导致 turn 静默终止的问题。

🛠 修复（Fixes）
CC Hooks / 插件
- 修复 exit-2 hook 启动失败导致的全局阻塞：当插件 hook 因脚本路径不解析（如 python3 "$CLAUDE_PLUGIN_ROOT/x.py" → Python can't open file → exit 2）、命令未找到、Python 模块缺失等启动失败场景退出代码 2 时，之前被 CC 合约解释为故意「block」从而阻塞每一次 prompt 和工具调用。现在通过捕获 stderr 并检测解释器/Shell 启动失败特征（can't open file、command not found、ModuleNotFoundError、ImportError 等），区分「有意的阻止」（有实际输出内容）和「hook 启动失败」（静默跳过）。仅当 hook 输出真实的阻止原因时才阻塞 turn，broken hook 不再 wedges 用户
Provider / 网络
- 修复 v2 引擎偶发空响应中止 turn 的问题：部分 OpenAI-compatible 网关（atomgit→DeepSeek 路径）偶发返回状态码 200 但内容完全为空（stream 打开后直接 Done，无文本、无工具调用、无 reasoning），v2 引擎此前将其视为正常 Stop，导致 turn 在当前任务中间静默结束。现在通过 saw_stream_content 标记检测到零内容完成时，自动重试最多 5 次（1/1/2/2/3s 前置退避，可取消），重试期间显示可见警告「模型返回空响应，N 秒后重试……」。全部耗尽后以 ProviderError 失败（而非无声的 Stopped），保留会话快照，用户可直接重发
其他修复
- 管理员权限警告文案优化：将提示从「请在 /codingplan 中配置信任目录」改为「建议改用普通权限、并在受限的工作目录中运行 AtomCode」，更清晰指引用户避免以管理员身份运行

AtomCode v4.25.4 Release Notes
发布日期：2026-06-23
v4.25.4 聚焦于 CC Hooks v2 引擎接入（里程碑新功能）、LiveSession Turn 取消、atomcodex 遥测上报、JetBrains 插件增强，以及大量终端渲染、Provider/网络、WebUI 和跨平台兼容性修复。

✨ 新增功能（Features）
CC Hooks v2 引擎接入（里程碑新功能）
- 外部 hooks 完整移植：将 CC 外部 hook 引擎完整移植到 v2/kernel 架构，新增 CCExternalHooks 模块（约 1000 行），同时实现 LifecycleHooks（session_start / session_end / user_prompt_submit）和 ToolMiddleware（PreToolUse / PostToolUse）两套接口
- CC 合约兼容：支持 CC PascalCase 与原有 snake_case 两种事件名，仅有 exit 2 阻塞执行（exit 0/1 正常继续），超时/启动失败/异常输出静默跳过不阻塞 turn
- 插件内联 CC hooks（M2b）：插件可在 plugin.json 中声明内联 CC hooks，v2 引擎通过桥接层（bridge::gather_plugin_cc_hooks）自动加载并注册到 coding agent
- prepare_with_plugin_hooks：新增入口点，驱动层将插件 CC hooks 线程化传入，支持模型切换/reload 后存活
LiveSession 增强
- Turn 取消能力：LiveSession 新增 cancel_current_turn 方法，协调器在 turn 运行时注入 CancellationToken，TUI Ctrl+C / Esc 优先通过 LiveSession 取消同步 turn
- 退出保护：/quit /exit 在 streaming 状态下先取消 turn 再退出，避免强制关闭导致状态残留
- WebUI 停止按钮适配：根据同步模式自动调用 postLiveStop() 或 stopChat()
Telemetry / 遥测
- atomcodex 遥测上报：code 和 review 子命令新增 LLM 遥测数据上报，新增 tel.rs（约 200 行），遵循 4 级退出机制（DO_NOT_TRACK、环境变量、--no-telemetry、config 开关），退出时自动 flush 队列到磁盘
JetBrains 插件改进
- JBCefMessageView 重构：大幅重写 JetBrains 消息视图（增加约 360 行），改进 JS 交互与渲染性能
- StreamEventHandler：新增 SSE 流式事件处理器（约 170 行），提升响应性能
- CefLoadHandler：用 onLoadEnd 替代 Timer 轮询检测 JS 就绪状态，移除 forceReady 兜底机制，简化状态管理
- 单元测试：新增 ChatPanelHelpersTest（约 160 行）
TUI 交互增强
- /copy 命令：新增 /copy、/copy N、/copy all 命令，支持复制上一条回复中的代码块到剪贴板
- 多行用户消息视觉优化：连续多行输入以块形式展示，首行 ❯ 标记、续行 ▎ 彩色竖线（Windows/无 Unicode 字体回退 ASCII |）
- 代码块自动复制：代码块渲染完成后自动复制原始内容到剪贴板（可通过 ATOMCODE_AUTO_COPY=0 关闭）

🛠 修复（Fixes）
WebUI
- 警告作为一等事件：非致命警告（如 compaction advisory）不再硬塞为红色 [错误] 助理回复，改为独立 amber 色 notice 展示，新增中英文 i18n 文案（chat.warning）
- DEBUG eprintln 污染修复：移除 /webui live 路径（forwarder、coordinator、SessionSwitched、daemon live_api）遗留的 [DEBUG] eprintln 脚手架，全部改为文件级 trace 日志（tuix_trace! / ctrace!），修复终端被 DEC Special Graphics 莫吉巴淹没问题
- todo 工具展示优化：WebUI 中 todo add 显示任务描述，update 显示 #id → status，新增批次内序号前缀（#1, #2…）
终端渲染
- CJK/Emoji 表格边框对齐：修复 Markdown 表格中 CJK 字符和 Emoji 导致列边框错位的问题（#708），涉及 markdown.rs（约 150 行）和 width.rs（约 140 行）CJK 宽度计算优化
- Windows 粘贴合并：Windows Terminal / conhost 长文本分段粘贴（bracketed paste）合并为一个 [Pasted #N]，避免一次 Ctrl+V 出现数十个粘贴占位符（新增 coalesce_paste()，约 160 行单元测试覆盖）
- 斜杠命令参数粘贴展开：修复 /goal 等参数化斜杠命令中粘贴占位符未展开的问题——agent 不再收到字面 [Pasted #N] 字符串
- Kitty CSI-u 泄漏修复：移除 REPORT_EVENT_TYPES，防止 CSI-u 释放报告泄漏到输入框，干扰后续输入
- Kitty panic 键盘状态清理：panic hook 中清理 Kitty 键盘标志位，panic=abort 跳过 Drop 时确保终端状态一致；restore_terminal_if_tui() 增加全量 panic-safe 恢复序列
- 菜单切换 CJK 残影清除：菜单切换时强制清除 CJK 残影字符残留
- /skills 搜索改进：使用子串匹配（contains）替代前缀匹配（starts_with），搜索技能时能匹配名称中包含关键词的 skill（#686）
- 模型切换后状态栏刷新：切换模型后状态栏上下文窗口立刻跟随更新，无需等到下一轮对话（UiState::on_model_window_changed，覆盖 /model 选择器、磁盘配置重载、webui 镜像切换三种场景）
Provider / 网络
- v2 max_tokens 发送：修复 v2 引擎不发送 max_tokens 导致上游隐形 small-cap 截断长回复（finish_reason=length）的问题。BridgeConfig 新增 max_tokens 字段，三适配器（Anthropic/Ollama/OpenAI-compat）补齐与 v1 一致的 fallback 算法
- usage 缺失时上下文压力估算：部分网关不返回 usage.prompt 时，自动降级为基于请求字节量估算上下文利用率（Message::estimate_tokens()，~4 bytes/token，图片≈1600 tok），防止自动压缩永不触发导致上下文无界增长
- 401 认证友好提示：v2 引擎中 atomgit-gateway 401 错误不再裸抛上游原文，改为 i18n 友好提示「认证已过期，请执行 /login 重新登录」或「Authentication expired — please run /login to sign in again」
- bash 输出终端过滤：stdout/stderr 数据块增加 sanitize_terminal_output 过滤，防止终端转义序列泄漏
JSON 修复
- 控制字符转义：LLM 产出工具调用参数中的未转义字面控制字符（\n \r \t 等）转义为合法 JSON escape 序列（escape_unescaped_control_chars_in_strings），所有工具均受益。新增多个单元测试覆盖 repair_tool_args（#619）
- 修复工具详情文件名显示：修复 repair_tool_args 修复 JSON 后，format_tool_detail 中文件名等详情在 UI 中不显示的问题
Referral / 营销页面
- 手机号格式校验：支付弹窗新增手机号格式校验，支持大陆手机号或 +国家码 国际手机号
- SID 持久化降级：增加 localStorage 降级读取和认证失败 900ms 后重试一次，覆盖新 tab / 移动端恢复场景
- Toast 样式优化：支持 error 类型展示（红色边框），支持字段级和服务端错误分类展示（bad_request / auth / network / server / unknown），ARIA 可访问性改进（role="status" + aria-live="polite"）
- 预发布环境标识：header 新增橙色预发布标识
其他修复
- CLI 插件安装支持裸名称：atomcode plugin install <plugin> 支持不带 @marketplace 后缀的裸插件名，自动解析市场；多市场匹配时给出列表提示（行为与 TUI 的 /plugin install 一致）
- todo 工具返回值增强：add 返回完整任务列表，update 

AtomCode v4.25.3 Release Notes
发布日期：2026-06-20
v4.25.3 聚焦于写入审批模型恢复与增强、Windows 终端鼠标交互全面修复、以及 JetBrains IDE（JediTerm）兼容性改进。

✨ 新增功能（Features）
写入审批增强
- Workspace-aware 自动审批：工作区内非敏感写入操作自动批准，不再每次弹出审批提示
- 敏感路径保护：对 ~/.ssh、.env、/etc 等敏感路径的写入操作始终提示审批，且不可被"总是允许"跳过，修复 v2 中相对路径绕过敏感路径检测的安全问题
- "总是允许" per 规范路径：工作区外出站写入的"总是允许"按规范路径粒度缓存，而非按工具名全局授予；search_replace / parallel_edit_files 保持按工具粒度
🛠 修复（Fixes）
Windows 终端鼠标交互
- 原生鼠标交互全面恢复：移除对 Windows 控制台模式的主动管理，conhost 和 Windows Terminal 上的拖拽选择、复制、粘贴、滚轮均恢复原生行为；conhost 上点击暂停行为回归（Esc 可取消、Enter 可复制）
- conhost 鼠标滚轮修复：滚轮事件正确回退给 conhost 原生窗口滚动，而非应用的空操作处理器
- QuickEdit 文档修正：明确 ENABLE_QUICK_EDIT_MODE 关闭会破坏 Windows Terminal 文本选择
JetBrains IDE / JediTerm
- 修复 JediTerm 鼠标移动乱码：不再在 JediTerm 上启用 Kitty 键盘协议，修复 DevEco Studio / IDEA 中鼠标移动导致输入框出现坐标乱码的问题
- 修复 panic 路径 Kitty 协议残留：panic 时正确弹出 Kitty 键盘增强标记，避免残留协议污染父 shell
写入审批
- 修复"总是允许"退化为"允许一次"：edit_file / write_file 等文件编辑工具的"总是允许"现在正确按工具粒度缓存，不再因参数不同而重复提示
📚 文档（Docs）
- Slash-command 参考文档同步：README 表格从 23 条命令补全至 48 条，按类别分组；新增 /goal、/effort、/review、/paste、/exit 等缺失命令文档；移除已废弃的 /copy 命令
- 新增 Mode & autonomy 特性说明：/plan、/build、/goal、/review 工作模式文档
- 微信通道插件文档：新增 /wechat 插件安装说明（AtomCode-Channel 市场官方插件）

AtomCode v4.25.2 Release Notes
发布日期：2026-06-19
v4.25.2 是 AtomCode 自 v2 引擎启用以来的重大里程碑版本：全新的 Engine v2 堆栈正式成为默认引擎，覆盖 plan mode、/undo、/goal、/background 等全场景能力；同时引入 /review 内置代码审查、AtomGit 平台原生集成等重量级新功能，并对 MCP 客户端、Compaction 等进行了系统性增强。

✨ 新增功能（Features）
Engine v2 新引擎堆栈（里程碑新功能）
- Engine v2 成为默认引擎：基于全新 atomcode-kernel 内核、atomcode-capabilities 能力层、atomcode-coding 编码代理与 atomcode-bridge 桥接层的 v2 堆栈正式切换为默认引擎
- Plan mode 支持：v2 引擎下的 Plan 模式（原为 degraded warning）
- /undo 支持：v2 引擎下的撤销操作（原返回 UndoFailed）
- /goal 支持：v2 引擎下的持久化 goal 指令
- /background 支持：v2 引擎下的后台任务
- !cmd local-shell passthrough：v2 引擎下本地命令透传执行
- Claude Code 兼容的 hook 合约：ToolMiddleware 决策与原子能力对齐
/review 内置代码审查（里程碑新功能）
- 内置代码审查：在 /review 命令中直接使用代码审查 agent，无需离开当前对话
- 语言审查规则引擎：内置多语言审查规则（50+ 语言），随产品同步更新
- 自定义任务与 JSON 输出：--append-system-prompt[-file] 追加模式、fix 建议字段、用量累加
- diff 行号标注：审查结果直接标注 diff 行号，定位更精准
- 变更文件清单驱动：自动识别变更文件并驱动覆盖面，内置 persona 单一来源强化
AtomGit 平台集成
- atomgit_repo 工具：仓库列表/查看/创建/删除/Fork 操作
- atomgit_pr 工具：PR 管理（列表/查看/创建）及常用 client 方法
- atomgit_issue 工具：Issue 管理（列表/查看/创建/标签），三件套统一注册
/goal 命令增强
- 持久化 goal 状态行：专属 footer 行显示当前 goal 轮次与状态
- Engine v2 完整支持：v2 引擎下的 /goal 全流程支持
- 可中断设计：通过 esc、ctrl+c、/goal clear 中断活跃 goal
- 等待输入模式：/goal 等待显式输入文本而非直接运行选中内容
MCP 客户端
- MCP 客户端能力（L1）：支持 stdio / HTTP / OAuth 三种传输协议的 MCP 客户端
- Streamable-HTTP 会话：Mcp-Session-Id 识别与 DELETE 关闭
其他功能
- memory 用户驱动记忆：用户驱动的持久化 recall/memory 能力（L1）
- 会话持久化与跨会话 recall：session 持久化 + 跨会话记忆力（L1）
- web_fetch 增强：markdown 输出格式、可选 max_chars（无默认截断）、real browser UA
- 敏感路径读取防护：自动拦截 SSH keys / .env / credentials 等敏感文件读取
- Compaction 溢出压缩：溢出时自动压缩旧轮次为 LLM 摘要（OverflowCompaction），加 focused summary、telemetry
- codeintel 编码工具集：符号列表/读取（12 种语言，tree-sitter）、代码图分析、LSP diagnostics、blast radius 影响范围分析
- 容量/令牌显示改进：K/M 后缀格式化令牌数
- 并行编辑工具：edit_file ToolBatch 分组与事件回调
- 编辑工具 compact diff 摘要：TUI 简化展示、快速理解修改内容
- Plan mode per-turn 提醒：Plan 模式下轮次提示注入
🛠 修复（Fixes）
TUI
- /clear 正确刷新新会话：不再是仅清屏
- 图文混合发送：图片后文本不再延迟显示；登录后模型名即时更新
- 图像附件去重：消除图片附件的冗余显示
- 取消操作回滚：cancel = undo，不回填/保留
- esc/ctrl+c 中断挂起：流打开阶段的挂起 turn 可中断
- 用户文本+图片分组：阻止 viewport 溢出
- streaming-stall 提示：20s 超时后显示"slow response"提示
- footer 显示计费令牌+缓存命中：而非原始重发 context 量
- markdown 表格暗色主题可见性：修复表格边框不可见
- 输入框高度约束：长粘贴文本不会溢出屏幕，上限 6 行
- /resume 闪烁消除：通过 DECSET 2026 信封消除闪烁
- /goal 的 turn separator：仅当 goal 活跃时推迟 separator
- footer 重绘：body scroll 后同 tick 刷新，无延迟
- 键入草稿保留：取消 prompt 后恢复之前键入的内容
- spinner 时钟稳定：batch 模式 + streaming-stall 提示下时钟不乱
- VL 失败恢复：多图场景下丢失原文的问题
WebUI
- Tool call 行去重：修复 /live 订阅泄漏导致的行重复
- SSE 连接重连：session_switched 后自动订阅新 LiveSession
- 侧边栏刷新：发送消息后 200ms 侧边栏同步更新
- 会话同步：新建会话时侧边栏自动同步
i18n
- /goal 命令输出本地化：help/status/clear 完整中英文
- 引擎 v2 provider-init 错误本地化：网关鉴权错误信息中文化
- atomcode --help 本地化：根据 config/env 语言设置显示
Provider / 网络
- stale keep-alive 连接恢复：修复"open failed"/"无法对话"类问题
- stream timeout 提升：120s → 300s，环境可配置
- 多系统消息合并：OpenAI-compat/Ollama 三端
- reasoning 保留：所有 stream-end 路径保留 reasoning，去除占位符
- DeepSeek V4 Flash 兼容：non-prose REASONING_PLACEHOLDER
安全
- web_fetch SSRF 修复：关闭 DNS-rebinding TOCTOU + IPv4-compatible IPv6 SSRF
- atomgit clone 参数消毒：拒绝 leading-dash 参数注入
- 越权路径防护：外部路径 Enumerate 操作需用户确认
其他
- 编辑工具重复调用：约束 edit_file 重复调用 + TUI 双条展示问题
- /quit 需执行两次：添加 shutdown_requested 标志位修复流式处理时的问题
- 技能递归发现：多级嵌套目录下的 SKILL.md 正确加载
- approval 超时：交互式审批挂起等待应答（不再超时自动拒绝）+ 收起超时遗留审批行
- 对话审批重触发：取消的 tool approval 在 /model 切换后不再重触发
- truncate_generic 边界 panic：共创大赛反馈的边界条件修复
- atomcode workspace 依赖对齐：fmt_tokens 实现回退与调用路径修复

AtomCode v4.25.1 Release Notes
发布日期：2026-06-12
v4.25.1 聚焦于图片附件与推理强度控制、可插拔搜索引擎后端、进程内 daemon 模式、TUI /view 文件查看器、微信桥接（Milestone 1/2），以及大量 Agent 健壮性与 WebUI 交互修复。

✨ 新增功能（Features）
/view 文件查看命令
- /view <filepath> 命令：在 TUI 浮层窗口中查看文件内容，支持限界读取（8 MiB）、溢出裁剪、resize 后重绘，拒绝非普通文件（FIFO/设备）
WebUI 增强
- 图片附件：聊天中支持上传/粘贴图片，以 base64 发送请求，在用户消息中显示图片预览
- 推理强度选择器：新增推理强度（Reasoning Effort）选择器 UI，支持默认/High/Max 三级，通过 /live/reasoning_effort 接口同步
- ANSI 颜色渲染：Markdown 代码块支持 ANSI 转义序列渲染，添加 16 色 CSS 样式
- 本地斜杠命令：新增 login/logout/whoami/status/config/reload 等本地斜杠命令，带 display_messages 持久化
- 动态技能菜单：daemon 注入的动态技能出现在 / 斜杠菜单中
daemon / 服务器
- 进程内 daemon 模式：atomcode daemon 不再依赖同目录的 atomcode-daemon 独立二进制，改为进程内直接启动 Web 服务器（类似 /webui 模式），支持 --idle-timeout 及 ATOMCODE_DAEMON_IDLE_TIMEOUT 环境变量
网络工具
- 可插拔 web_search 后端：DuckDuckGo 不再是硬编码后端，新增 [web_search] 配置块，支持 provider = "exa" | "duckduckgo"，默认 Exa（无需 VPN 即可访问）；搜索失败时优雅降级引导至 web-access skill
推荐 / 邀请系统
- 邀请链接路径格式：支持 /invite/{code} 路径格式的邀请链接（兼容原有查询参数），生成链接时自动使用新格式
- 数据更新时间统一：面板数据使用 API 返回的 refreshed_at 统一展示更新时间，移除硬编码的"刚刚"
- 收款信息弹窗：新增收款信息查看/编辑弹窗，支持 light mode 样式，toast 通知移至顶部
TUI 交互提升
- 工具审批默认 Enter：审批提示中 Allow(once) 芯片标记为绿色 ↵ 默认入口，用户可直接 Enter 批准，无需寻找快捷键
- emoji 表格对齐：遗留符号区 emoji（☀☎✂等）从 1 列拓宽至 2 列，修复 Markdown 表格中 emoji 导致的错列；跨平台自适应（Windows legacy conhost 保持 1 列）
微信桥接（Milestone 1/2）
- 微信通道：新增 WeChat Instant Link (iLink) 桥接通道，包含扫码登录、消息透传、会话/权限状态管理、SSE 流式通信、审批权限 FSM 编排等基础设施
上下文管理
- collapse_committed 压缩：新增幂等、已提交的 collapse_committed 上下文压缩策略（替代旧的 microcompact），更安全地实现缓存友好的历史压缩

🛠 修复（Fixes）
Agent / 工具
- plan mode 回合提示：每轮注入 turn_reminder，确保模型只规划不实现（不再在回复中写入完整代码实现）
- 推理思考持久化：修复 DeepSeek V4 Flash 最终回答显示 "(no reasoning recorded)"——真正保存推理内容，消除上下文中的占位符污染
- 余额不足 fail-fast：上游返回余额不足/insufficient_quota/402 时立即报错并透传真实原因，不再重试 3 次
- web_fetch SSRF 加固：修复 DNS 重绑定 TOCTOU 漏洞——通过 resolve_to_addrs 锁定已验证 IP；阻止 IPv4 兼容 IPv6 地址（::127.0.0.1）绕过安全检查
- @-mention 文件索引 CPU 100%：限制递归遍历上限为 50,000 条目，跳过 home 目录/文件系统根目录的完整遍历
- 上下文压缩越界：修复 keep_recent_turns=0 时 compact_old_tool_results_in_place 数组越界 panic
TUI / 终端渲染
- @-mention 文件索引 TTL 刷新：新增 3 秒 STALE_TTL 机制，会话中新建的文件可在 @ 菜单中被发现，不再需要 /cd 重启
- 审批芯片真彩色：Allow/Always/Deny 芯片使用精确真彩色 RGB（绿色 #30D158 / 蓝色 #2BB8E0 / 红色 #FF453A），消除终端主题色板导致的辨识模糊
- 工具名换行高亮：审批提示中换行继续行正确追踪工具名边界，不丢失粗体高亮
- 审批耗时行内换行：修复窄窗口下工具耗时行换行时丢失时长显示的问题
- /view 文件查看器加固：拒绝 FIFO/设备文件、上限 8 MiB 磁盘读取、长文件名溢出裁剪、终端 resize 后覆盖重绘
- JediTerm 整行紧凑重绘：修复 DevEco 终端 CJK 行列渲染
命令 / CLI
- /wechat 命令门控：修复插件命令 /wechat（keyed weixin:wechat）因精确键匹配失败而不触发、泄漏为纯文本的问题，改用 resolve() 支持 bare-name 识别
- Always 权限作用域：edit_file / write_file / search_replace 的 Always 批准从全局缩窄为特定文件——按 [A] 只跳过对同一文件的重复审批
- Windows verbatim 路径哈希：消除 \\?\ 前缀导致的会话路径不统一，WebUI 与 TUI 会话可正确归入同一 bucket
- CLI 遥测与换行：修复异常退出路径上遥测未刷新、EOF 换行缺失
WebUI / VSCode 扩展
- LiveSession 数据丢失：交换 _sessionRuntimes.delete() 与 _client.deleteSession() 顺序——先执行服务端删除，成功后清理本地状态，防止网络失败时数据丢失
- LiveSession 遥测 mode：修复 /live 端点未提取 SessionMode 导致 telemetry envelope.mode 始终为 None
- ECONNREFUSED 重连竞态：重连后检查 controller.signal.aborted 避免竞争条件
- 流错误恢复：onError 中设置 srt.errorMessage 以支持持久化流错误恢复
- 闭包陈旧引用：sendMessage 中统一使用 stateRef.current 避免闭包捕获过期状态
- artifact 事件路由：onArtifactStart/Content/End 改为定向发送至对应面板，而非广播
- 会话切换同步：修复 panelReady 与 sessionId 绑定在会话切换时的同步问题
- 消息加载竞态：引入 messagesPromise 异步缓存避免竞态条件
- 面板控制事件广播：clearChat/generationStopped/focusInput 改为广播发送，确保多面板场景一致
daemon / 服务器
- M1/M2/M3 校准：构建 ctx 使用实际 provider_name 而非 config.default_provider，非默认模型获得正确上下文窗口策略；LiveSession 保留 turn_stats；延迟创建 snapshot 避免长会话 O(N) 克隆
- post_turn hook 上下文：补充 session_id 和 turn_number 字段
- 会话快照持久化：修复 Web 工具中会话快照的持久化保存
其他
- 邀请页文案：精简京东 E 卡规则文案，更新奖励计算周期为每月结算

📚 文档（Docs）
- README 命令列表：中英文 README 新增 /view 命令条目
- 站点文档：中英文斜杠命令页面（slash-commands.html）新增 /view 命令说明

AtomCode v4.25.0 Release Notes
发布日期：2026-06-06
v4.25.0 聚焦于 ! Bash 直接执行模式、DeepSeek V4 推理强度控制、前缀缓存稳定性优化、MCP 工具审批增强、WebUI 交互与视觉升级，以及多项 Windows 兼容性修复。

✨ 新增功能（Features）
! Bash 直接执行模式
- 核心实现：输入行以 ! 开头即直接在本地 shell 执行命令，不启动 LLM 轮次
- 上下文注入：执行结果以 <bash-input>/<bash-stdout>/<bash-stderr> 标签注入对话，模型在下一次真实消息时可见
- Bash 工具重构：提取 run_shell 执行内核，bash_execute（模型调用）与 ! 模式（用户调用）共享底层，消除重复逻辑
- 输出安全：XSS 防护——输出中的 HTML 标签自动转义，大输出按字符/行数截断
- 单调 call_id：LocalShell 使用单调计数器保证 call_id 唯一性
DeepSeek V4 reasoning_effort 推理强度控制
- /effort 命令升级：三级循环（off → high → max），TUI 状态栏与 spinner 同步显示当前级别
- Provider 侧门控：仅 DeepSeek V4 系列模型生效，其余模型显示"不适用"提示
- 配置支持：ProviderConfig 新增 reasoning_effort 字段，加载时校验合法值
MCP 工具审批增强
- 服务级信任：配置 trust: true 整服务端自动审批
- 逐工具永久授权：配置 autoApprove 列表，或 UI "永久允许此工具"一键写入 .mcp.json
- 失败服务可见：/mcp 状态列表展示连接失败的服务及错误信息，不再静默消失
@-mention 文件索引异步化
- 后台线程扫描：build_async() 不阻塞事件循环
- 浅层预扫描：根目录直接子节点秒级可用，首次 @ 不卡顿
- /cd 后索引重置：FileIndex::reset() 切换根目录、清缓存、取消后台扫描，下次 @ 在新目录重建
- gitignore 一致：浅层扫描与完整扫描应用相同 gitignore 过滤，无闪现消失
WebUI 增强
- 对话消息重构：按时间序交错展示 text/tool（与 TUI 一致），不再将所有工具折叠到消息头部
- 工具调用展示：每种工具类型提取关键参数作为摘要（文件路径、命令、搜索模式等）
- 模型选择器：支持文字过滤，匹配 provider 名、type 和 model
- 暖色主题：亮色主题从冷灰切换到暖米色调，视觉更舒适
- 数据刷新时间：Referral 面板显示相对时间（"3 分钟前"），而非固定"刚刚"
LiveSession 同步增强
- /cd 跨视图同步：WebUI /cd 切换工作目录时，TUI 自动跟随切换并开新会话
- 三端统一：LiveSession 与 TUI/WebUI 当前会话统一，修复 #561（三端历史分离）
- 去重 + 延迟加载：SessionMode::Webui 去重合并，会话历史延迟加载避免无谓读盘
TUI 交互
- 菜单改进：/ 命令菜单唤醒后不被版本检查/空闲重绘覆盖
- Session 删除：/session 选择器支持 Ctrl+D 删除会话（二次确认），删除后自动定位
- 工具名显示：MCP 工具名以中点 · 分隔服务端与工具名，视觉更清晰
- 工具调用渲染：名称加粗、详情灰色，多样式行排版
管理员/root 检测
- 启动警告：检测以管理员/root 身份运行时，TUI 顶部横幅 + headless 模式 stderr 警告
429 限流分类
- 配额耗尽 429 不可重试：识别月度配额耗尽（非瞬时限流），避免无意义重试延长冷却

🛠 修复（Fixes）
缓存稳定性（前缀缓存）
- 渲染级 drop 路径延迟到持久压缩阈值：修复 build_messages 在 80% 预算时触发 drop，导致摘要随轮次滑动、前缀缓存每几轮断裂的问题（实测占 v4.25.0 剩余缓存未命中的 50.8%）
Windows 兼容性
- Hook 系统：使用 shell_command() 替代硬编码 sh -c，Windows 上走 cmd.exe /C
- 子进程输出解码：OEM 代码页自动检测 + CJK 回退（UTF-8 Beta 模式下 cmd.exe 资源串仍为 GBK 等原始编码）
- 控制台代码页警告：启动时检测输入代码页非 UTF-8，提示 IME 可能乱码并建议使用 Windows Terminal
- 清单 XML：修正 supportedOS 结构
- 自升级跨盘：robust_rename 检测跨设备错误自动回退到 copy，修复 staging 与安装目录在不同盘时升级失败
终端背景检测
- DA1 锚定：OSC 11 查询后追加 DA1 查询作为排空锚点，彻底消除 SSH/tmux 下 OSC 11 回复泄漏到输入框的问题，不再依赖固定超时
滚动与渲染
- 移除 smooth 动画：消除 bash 长命令执行时输入框频闪
- BSU/ESU 包裹：patched frame 正确包裹 Sync Update 序列，修复 patched 帧后光标重定位丢失
TUI
- Spinner effort 提示读取 ctx（匹配状态栏），而非 state
- Caret 重定位：patched frame 后重新定位光标，不仅限于光标移动时
WebUI
- --host 0.0.0.0 时移除多余的 127.0.0.1 绑定行
认证与安全
- 热路径时间戳：SystemTime::now().unwrap() 替换为安全处理，消除 panic 风险
- AtomCode 自身配置目录写入自动审批：is_under_atomcode_home() 同时检查原始路径与规范路径
- 敏感目录保护：.ssh / .aws / .gnupg 写入拦截（移除 .config，避免误杀合法操作）
自回归失控检测
- RunawayDetector：连续重复字符超过阈值自动终止轮次，防止 token 浪费
MCP
- OAuth token 刷新与登录：修复 Windows 代码页处理
Referral
- 未认证时先渲染静态区再显示登录态，修复空白页
- refreshedAt 时间戳展示
构建
- CLI 主函数改为显式大栈线程运行，避免 Windows 1MB 默认栈溢出

AtomCode v4.24.2 Release Notes
发布日期：2026-06-04
v4.24.2 聚焦于撤销（/undo）能力、缓存稳定性、同步（LiveSession）健壮性、WebUI 交互体验打磨，以及多项跨平台兼容性修复。

✨ 新增功能（Features）
/undo 撤销命令
- 核心实现：支持撤销到任意历史轮次，保留上下文完整性
- 命令支持：/undo 命令，自动处理并发安全与边界情况
- 事件支持：撤销成功/失败均有明确的事件反馈，headless CLI 同步适配
- i18n：完整中英文文案与命令描述
LiveSession 增强
- 模型双向同步：WebUI ↔ TUI 实时同步当前模型，同步模式下拉框自动跟随
- 审批通道稳固：审批通道整回合保持注册，修复同回合第二个工具被秒拒
- 会话门控：同步模式按会话门控实时事件，避免实时输出串进当前打开的其它会话
Session 恢复
- 轮次统计还原：恢复对话时还原轮次分隔线与每轮 token 使用量 / 工具调用统计
图形交互
- 图片粘贴识别：TUI 输入时识别手敲 / Windows 粘贴的图片路径为图片附件
- 构建工具升级：WebUI 升级 Vite 5 → 8（Rolldown），适配 HarmonyOS 构建
遥测
- 启动上报：进程内 webui 启动以 webui 模式上报 OpenAtomcode
- Mode 区分：WebUI chat 上报 mode 区分为 webui
Referral
- 结算规则：更新为双周结算，优化 period 组件样式与文案
- 品牌用语：品牌用语更新，周标签国际化

🛠 修复（Fixes）
WebUI
- /webui 用 TUI 当前会话播种 LiveSession，续聊后直接落到该会话
- 进程内 webui 默认端口错开到 13457，修复 VSCode 守护进程 / 首页 401 / 无响应
- 清除对端 / 回合结束后残留的审批卡片，修复任务已完成 webui 仍卡住
- 实时同步模式下会话门控，修复从侧栏打开其它历史会话时实时输出串页
- 同步模式模型下拉实时跟随 TUI 切换
缓存稳定性（前缀缓存）
- 缓存稳定性优化：优化对话上下文管理策略，显著提升连续对话的响应速度与缓存效率
Agent / 工具
- 限流重试：采纳网关给出的冷却时长，避免过早重试反而延长冷却
- Windows 路径转义：仅对单反斜杠路径生效，修复多行 content 换行被破坏
- Windows 敏感路径保护：系统敏感路径写入拦截
文件搜索
- Glob：显式指向 .atomcode / .claude 等 skip 目录时能搜到文件
- Grep：修复 Windows 路径分隔符导致的噪声目录跳过失效
Headless CLI
- 处理 ConversationTruncated 和 UndoFailed 事件
Referral
- 优化安装完成记录的持久化机制，防止数据丢失

AtomCode v4.24.1 Release Notes
发布日期：2026-06-03
🎉 新里程碑：WebUI 正式发布
v4.24.1 是一次重大版本更新，带来了完整的 Web 图形界面、TUI ↔ WebUI 实时同步、技能快捷菜单、推荐邀请系统、Plugin 多市场与自动安装、Provider 管理重构等核心能力。同时修复了大量终端渲染稳定性和兼容性问题。

✨ 新增功能（Features）
WebUI 图形界面（里程碑新功能）
- 完整 Web 应用：基于 Preact + Vite + Tailwind 构建的两栏布局聊天界面，支持流式渲染、工具执行展示、Markdown 渲染（含表格/代码块/列表）
- 侧栏系统：通栏侧栏，支持收起/展开、会话历史列表（显示时间）、搜索、CC 风格新建、头像显示、会话重命名/删除
- 远程访问：进程内 atomcode webui 子命令 + TUI /webui 命令启动 Web 服务端，集成蒲公英(Oray PGY)远程访问替代 Tailscale
- 设置面板：深浅主题切换、中英语言切换、模型配置（增删改）、Provider 排序/编辑、工作目录切换器
- 鉴权安全：敏感路由 Token 鉴权，仅页面+资源+health 端点公开
- 图片支持：聊天支持上传/粘贴图片（Vision + VL 兜底）、2MB 大小限制、历史缩略图展示
- 文件管理：@ 文件选择器（附件菜单 + 目录树，支持进入子目录/返回上级/新建文件夹）、目录选择器
- 落地页：空会话居中落地页、项目建议、刷新恢复防闪屏（restoring 态）
- 模型管理：独立弹窗添加/编辑模型、同名模型附加 Provider 消歧、上下文窗口选择（AtomGit 锁定）、名称唯一性校验
- 执行中排队：运行时可继续输入并排队消息
- 引导提示：无技能时提示如何添加
TUI ↔ WebUI 实时同步（LiveSession）
- LiveSession 总线：协调器骨架（单写者 turn、广播扇出、晚加入快照）+ 阶段性实现三个阶段
- 阶段①：公共类型与总线骨架
- 阶段②：Daemon 端 AppState 持有 LiveSession、SSE 快照+广播、消息投递、TUI /sync 附着
- 阶段③：交互式审批（/live 推 permission_request + POST /live/permission）、AgentEvent 映射转发、全局当前 LiveSession
- /webui 自动开启同步：TUI 自动附着 + 浏览器 sync=1 默认开
- 同步会话持久化：独立 Session（每轮落盘、稳定 id、/live 暴露 session_id）
$ 技能菜单（指令补全）
- 在输入框中输入 $ 触发技能列表菜单（MenuKind::Skill）
- Tab 补全技能名，Enter 直接调用
- 提交后分发为 skill invocation
- 菜单渲染仅显示 bare name
推荐邀请系统（Referral）
- 完整的邀请追踪系统（referral tracking）
- 落地页从安装命令改为邀请链接
- 结算方式切换为现金提现 + 反作弊规则
- 安装脚本验证邀请码格式
- 主题切换、中英文切换、动效与移动端导航适配
- 安装命令 UI 重新设计 + 浅色主题
Provider 管理重构
- /provider add 合并模板导入，自动识别 curl/JSON/TOML 格式
- 手动填写改为 Base URL 优先，类型自动预填
- 模板步仅接收模板，Base URL 归入手动填写
- 名字优先取主域名而非子域
- $VAR / 环境变量名形式的 API key 视为占位符
Plugin 生态增强
- 多市场引导启动（multi-marketplace bootstrap），支持 Git 子目录源
- 启动时自动同步官方市场（marketplace），检查 git 可用性并给出友好提示
- 插件缺失目录时自动重新 clone，而非报错失败
- 完整的 git 错误链展示，支持按插件名安装/卸载
- Claude Code 桥接集成：加载 Claude Code 已安装插件，避免重复安装
包管理器分发（distro-pm）
- 新增 distro-pm feature 和 is_package_managed 辅助判断
- HarmonyBrew 包管理器场景下短路自更新（self-update），跳过分发升级 spawn
- 升级/启动提示适配 HarmonyBrew 文案（中英文 i18n）
缓存与遥测
- 所有请求携带 x-atomcode-session-id 用于网关亲和性
- Session ID 统一：agent 驱动、datalog 记录、持久化绑定
- 会话重置时重新生成 session id，SetMessages 不重置
- 缩放 microcompact 阈值随窗口动态调整
破坏性命令防护
- Bash 工具拦截 ORM 迁移 schema 重置类破坏性命令，防止误操作
崩溃日志
- Panic 时同步落盘崩溃日志到 ~/.atomcode/logs/panic.log，便于问题定位
安装脚本
- 安装脚本（install.sh / install.ps1）自动获取最新版本号，改用免版本号 raw 地址
Daemon 层
- 抽 run_server 为库函数，二进制变薄壳
- 嵌入式 webui 静态资源（rust-embed）+ SPA fallback
- GET /skills 端点列 user-invocable 技能（token 保护）
- GET /fs/list 目录列举端点
- /chat 改用交互式权限 + SSE 转发 permission_request
- 权限桥接通道 PermissionResponders
其他
- -y / --dangerously-skip-permissions 短选项支持（BYPASS 徽标从黄改红）
- Hook 系统：Webhook + 异步批量支持（社区贡献）
- SubAgent 框架：AgentTool（invoke_subagent）、SubAgentRunner（取消/早退/截断）、工具沙箱

🛠 修复（Fixes）
终端渲染 / Windows 兼容
- 经典 conhost resize 闪退修复——改用 ED2 清屏替代 ED3 避开崩溃；on_resize 增加 RSZ 阶段诊断日志定位
- 仅在 CodingPlan provider 激活时显示漂移警告
- AltScreenRenderer 缺 pop_approval_prompt 修复 Windows "Waiting for approval" 残留
- dark-theme 下工具调用 header/result 行的色彩层次恢复
- 并行工具组子行在深色主题下变暗的问题
WebUI
- 会话菜单在底部时向上展开，避免被视口裁切
- 连续审批时第二个审批卡片不弹出导致任务卡死
- 同步评审修正：卸载中止 live 流、发送同步置 busy、按钮状态文案
- 刷新恢复会话时抑制新建落地页消除闪屏
- 移动端设置菜单被抽屉裁剪
- 编辑模型时支持修改名称
- 输入法组字回车误触发全量修复
- 代码块 Copy 按钮定位到右上角
- 工具完成状态统一显示「完成」，不再显示耗时
- Markdown 表格/列表/段落样式补全
- 模型下拉只保留 model 名（provider 移到 hover）
- favicon 改为本地内置，脱离外网 CDN 依赖
- 历史会话显示时剥离 daemon 注入的 VL 标注块
Sync / Live
- 重复附着 LiveSession 导致 TUI 同步内容双重渲染
- VL 预处理移到 coordinator 共享层，修复 TUI 也丢图
- daemon live/sync 路径补回 VL 预处理
- 先回显用户消息再做 VL 预处理，带图发送不再卡顿
- live/sync 发送消息带上选中 provider
Plugin
- 状态文件缺失/手动删除已安装插件目录的稳健恢复
- 处理 installed_plugins.json 中陈旧的条目
- 使用 load_skills_dir pub(crate) 使插件加载器测试可编译
- Claude Code 桥接：作用域优先级、相对路径、可测试性
Coding Plan
- 月度额度耗尽时按 quota_exhausted 判定，抑制 0% 滚动窗口误导
缓存
- 会话 id 在 conversation reset 时重新生成，SetMessages 不重置
- Prompt prefix 稳定性优化，缓存命中率 ~79% → ~96%
Provider
- OAuth access_token 回退场景下的防泄露守卫
- /provider 编辑/新建模型支持选择上下文窗口（AtomGit 锁定）
其他
- Ctrl+C 现在可以在输入非空时取消 guide subagent
- UserPromptSubmit hook 失败不再阻塞会话
- 无 setsid 二进制环境的后台模式修复
- 斜杠命令执行后回填输入框，且不弹出命令列表
- handle_plugin_job_event 调用点 state 可变性不匹配导致编译失败
- 

AtomCode v4.24.0 Release
发布日期：2026-06-01
✨ 新增功能（Features）
Hook 系统
- hook：全面引入 Hook 扩展框架 —— 支持 13 个扩展点（Message / Turn / Tool / Session / System 级别），含 webhook 异步回调、脚本执行与异步批量处理；附带 hooks.toml 配置与示例脚本（auto_commit / code_review / log_tool_calls）。
- hook：UserPromptSubmit hook 失败不再阻塞对话，降级为警告继续执行。
Bash 后台模式
- bash：一等公民后台模式 run_in_background —— 通过 setsid(2) 系统调用将命令摘到独立会话，不依赖 setsid 二进制，跨平台可用（Windows 用 DETACHED_PROCESS 对齐，鸿蒙 PC 自动用 sh）。返回 pid + 日志路径，dev server / watcher 直接走后台，不再自搓 nohup &。
插件系统
- plugin：交互式 /plugin 管理器模态框 —— 支持按名称安装/卸载插件，每次启动自动同步 marketplace。
- plugin：多 marketplace 引导 + 自动安装 —— 官方 registry 作为默认 marketplace，支持 git-subdir 源，跳过未知源类型。
- plugin：兼容 Claude Code 已安装插件 —— 读取 installed_plugins.json，自动发现 Claude Code marketplace 安装的 skills/commands，免重复安装；AtomCode 原生插件优先级更高。
- plugin：已安装插件提示优化 —— 重复安装时给出友好重装指引，不再只报 "already installed"。
- plugin：robust auto-install recovery —— 自动安装后正确触发 hook，手动删除插件目录后 installed_plugins.json 条目不再残留。
项目指令文件
- instructions：支持 AGENTS.md 开放标准 —— 在 .atomcode.md > ATOMCODE.md > AGENTS.md > CLAUDE.md > claude.md 查找链中新增 AGENTS.md，已有 AGENTS.md 的项目无需另建文件即可被 AtomCode 自动识别。
/guide 向导命令
- guide：新增 /guide 斜杠命令 —— 作为 /skills ask 的快捷入口，自动安装 ask skill，自动审批插件文件读取。
- guide：英文知识库 + i18n 支持 —— 16 篇英文知识文件、命令菜单与工具定义多语言适配，/guide 按用户查询语言回复。
/provider 提供商配置
- provider：手动填写改为 Base URL 优先、类型自动预填。
- provider：模板导入合并 —— /provider add 自动识别 curl / JSON / TOML 格式。
CLI
- cli：新增 -y 短选项，等价 --dangerously-skip-permissions；SKIP 徽章重命名为 BYPASS，颜色改为红色。
VSCode 扩展
- vscode：Add to Chat 支持可点击代码引用 —— 显示 file:line-range 格式，点击跳转到文件对应行，仅选中时添加上下文，发送选区内容而非整个文件。
- site：新增 VSCode 插件专区页面 + Plugins 导航链接。
🛠 修复（Fixes）
终端渲染 / TUI
- tuix：流式 / 工具执行时输入框不再闪动 —— 改用逐行 EL 取代整屏 ED 0 擦除，页脚由 render_diff 原子重绘全权负责。
- tuix：含 Tab 缩进的粘贴文本输入光标错位修复 —— wrap_with_cursor 把 \t 按 SOFT_TAB_WIDTH 计列，与渲染端一致。
- tuix：出错的轮次显示「✗ 已中断」而非「✓ Nailed it」成功横幅。
- tuix：guide spinner 更新改走 BSU 包络，消除输入框闪烁。
- tuix：guide 流式回答不再把 "Querying guide…" spinner 留在滚动区。
- tuix：并行工具组子行在深色主题下变暗，恢复层次。
- tuix：dark-theme 下 tool-call header 与 result line 色彩层级修正。
- tuix：Esc 取消后斜杠命令回填输入框，且不弹出命令列表。
- tuix：/provider 识别行显示 base_url，手动 Base URL 改为必填前置步。
- tuix：/provider 名字优先取主域名而非子域。
- tuix：/provider 把 $VAR / 环境变量名形式的 API key 视为占位符。
- tuix：/provider 模板导入读取展开后的粘贴内容。
- tui：AltScreenRenderer 缺失 pop_approval_prompt 导致 Windows "Waiting for approval" 残留行修复。
- tui：剥离粘贴输入中的 shell prompt 字符。
- tui：修复 handle_plugin_job_event 调用点 state 可变性不匹配导致编译失败。
缓存与压缩
- cache：稳定 prompt 前缀，缓存命中率 ~79% → ~96%；长对话不再逐轮跌至 ~10%。
- ctx：token-aware 压缩 keep-floor —— 按 token 上限而非固定消息数截断，解决 reasoning 密集模型（deepseek-v4 / Kimi / Moonshot）在 128K 窗口下 reasoning 累积超限导致流式超时。
安全
- provider：OAuth access_token fallback 防御不可信 base_url —— 阻止恶意 base_url 窃取 Authorization 头。
- ParallelEditFiles：审核安全漏洞修复 —— 与 edit_file 对齐两层审核检查（敏感路径检测 + 工作区外写入检测），敏感路径升级为 RequireApprovalAlways 防止 session grant 绕过。
编码计划
- coding-plan：月度额度耗尽时按 quota_exhausted 判定，抑制 0% 滚动窗口误导。
Prompt 与 Agent
- prompt：约束 agent 不越界扫兄弟目录、不再误写 ~/.claude。
- Ctrl+C 现在可取消 guide subagent，即使输入框有内容。
工具与运行时
- bash：Windows 上不再预设 bash 语法，如实报告 shell（cmd.exe）。
- auto-commit：commit 消息文件数改用实际 staged 文件数，与 git commit 真正提交的文件一致。
- skill：允许名称包含大写字母和斜杠 —— normalize_skill_name() 统一转小写 + / 转 -，查找时大小写不敏感。
- plugin：Claude Code bridge 改进 —— 作用域优先级、相对路径、可测试性。
- self_update：HarmonyOS 自动升级取 ohos-arm64，不再被静态 linux-arm64 覆盖。
- site：鸿蒙检测优先于 Windows；剪贴板复制更健壮。

AtomCode v4.23.3 Release Notes
发布日期：2026-05-28

✨ 新增功能（Features）
- npm：自动版本检测 —— 构建脚本支持从远端 Cargo.toml 自动识别版本号，发版无需再手改 package.json。
- homebrew：发布打包脚本 —— 新增 package-tar-gz.sh，一键产出 Homebrew Tap 所需的归档。

🛠 修复（Fixes）
1. 终端渲染 / Windows 兼容
- tuix：render_diff 包裹 DECSET 2026 + 隐藏光标，消除输入框闪烁。
- tuix：CJK 区域下启用 width_cjk，修复 Windows + pwsh7 conhost 的字符重影。
- tuix：将 width_cjk 自动探测范围收窄到「Windows + CJK ACP」，并彻底去掉 GetACP 自动投票，改为纯 opt-in。
- tuix：用哨兵值回填失效的 prev_cells，避免宽度不一致时残留孤儿字符。
- tuix：Pondering 等动画 tick 不再直写终端，改走 render_diff 的 BSU 包络。
- tuix：1M token 窗口显示为 1m，不再是易引发误解的 1000k。
- md：strip_md_for_width 与 render_inline 使用同一解析器，杜绝两处展开不一致。
- md：表格分隔行按单元格数渲染，不再按字符数错位。
- tool/bash：在 Windows 上以 OEM 代码页作为 fallback 解码子进程输出，修复中文乱码。
2. 合并/login 与/codingplan，去除掉/codingplan
- codingplan：月度配额耗尽时收敛为单行「本月用量已耗尽，等 Nd 后再使用」。
- codingplan：/status 的时长单位与 /login 对齐，共用 format_duration_secs。
- codingplan：legacy 路径下 window_quota_exhausted 时不再显示令人困惑的「0% 用量」一行。
- codingplan：移除「领取」措辞，并隐藏各 tier 的失败行。
- commands：/codingplan 已合并进 /login，统一入口。
3. 工具与运行时
- tool/read：自动剥离尾部 {…} 占位符，并扩大 “Did you mean” 模糊匹配范围。
- tuix：斜杠命令进入输入历史，↑ 可重新调出。
- web_search：drop 时 kill curl 子进程，并叠加 20s tokio 超时兜底。
- turn：validate_args 拒绝工具调用时不再出现重复的 “Re-issue” 包装。
- ctx：上下文压缩引入 token 感知的 keep-floor，限制 reasoning 密集回合的体积。
- cli：uninstall 子命令启动时跳过自动更新，避免卸载流程被打断。

📦 升级方式
npm
npm i -g @atomgit.com/atomcode@4.23.3
Homebrew
brew upgrade atomcode
已安装版本可直接启动触发自动更新
atomcode