v0.2.2

本版版本号

v0.2.2

本版变更

升级配置合并

• 修复旧插件清单缺少 plugin:ai_cosplay 等新增配置节时，升级报 No section 并中断的问题
• 新增配置节及键正常补入，已有用户值和自定义配置保持保留
• 更新配置合并支持 UTF-8 BOM

更新事务与恢复

• 更新请求及暂存由实际执行切换的 helper 清理，避免引导进程重复清理
• 复制失败并成功恢复备份后，记录 rolled_back，不再遗留 switching
• 回滚失败时保留请求、暂存及切换状态，并明确记录失败原因
• 启动恢复同时检查安装版本和健康状态，避免将仍在运行的旧版本误判为升级成功
• 找不到回滚备份时明确报错，不再声称回滚成功

Windows 启动器

• 停止旧启动器时同时匹配根目录与归档路径，修复启动器改名后无法识别旧进程的问题
• 增加正在运行的启动器改名归档、停止进程及清理归档的实际 Windows 回归

修复与兼容性影响

• 本版修复 v0.2.1 更新器缺陷，不改变插件 2.0 的声明式装配和热插拔协议
• 保留已有插件开关、配置值与自定义键，不要求手工补齐新增配置节
• 从旧版本首次升级时，旧引导进程仍可能打印一次 apply.json 已不存在的清理日志；应结合新 helper 的 apply_success 与 healthy 状态判断结果

升级注意事项

• v0.2.1 升级失败后，优先检查并下载 v0.2.2，避免反复应用同一份 v0.2.1 更新包
• 升级前备份会话与插件配置；认证凭据按原有安全规则单独保管
• 若日志包含 apply_rollback_failed 或 recover_failed，保留 updates/ 中的备份、状态和日志，不手工清空恢复材料
• Python 版本要求仍为 3.10+

实际执行的验证结果

本地验证环境为 Windows / Python 3.12；发布提交的远端检查及发布资产构建结果见本版本关联的 GitHub Actions。

更新器修复后的本地全量 CI：36 项通过，1 项真实模型专项验收按配置跳过
新增升级事务及 Windows 进程回归：8 个用例通过
已发布的 v0.2.1 更新包：在隔离旧版本安装中复现升级失败
v0.2.0 / v0.2.1 -> v0.2.2：真实更新包、旧引导器、新 helper、配置保留和健康检查均通过
v0.2.2 Windows 更新包与完整包：本地构建通过
单元测试清单：2482 个用例（平台相关跳过以各任务日志为准）

v0.2.1

本版版本号

v0.2.1

本版变更

插件 2.0 声明式装配与热插拔

• 统一通过插件身份文件、插口片段和工厂声明装配贡献，移除旧注册通道与重复清单
• 支持插件启用、禁用、配置应用、源码重载和目录移除后的资源撤回
• 活跃回合与插件请求结束后再应用变更，避免执行中释放资源
• 装配失败时恢复旧运行代；设置页显示待应用、成功或失败状态与具体原因
• 修复连续排队卸载可能恢复已卸载插件的问题
• 修复默认开启的 Web UI 插件关闭后无法重新启用的问题

会话、上下文与后台任务

• 修复新建子智能体标签在刷新或重启后无法恢复内容的问题，关闭标签同步清除前端记录
• 增加子智能体连续忙碌时长展示，完善后台任务完成通知的排队、去重与投递
• 唤醒任务隔离普通会话历史，保留当前任务所需的系统与插件提示
• 优化压缩摘要与近期完整轮次的保留策略，增加上下文用量圆环
• 模型连接在首个流式片段前断开时支持有限重试
• 单次文件替换的内容行数与目标跨度均限制为 120 行

界面与启动

• 优化用户确认面板的日间配色、选项和按钮样式，统一日夜模式尺寸
• 修复极简模式设置保存按钮背景与当前会话标签高亮
• 修复启动控制台中文乱码，完善启动输出编码处理

工程与安全

• 收紧目录浏览边界，防止超出允许文件系统范围
• 主动内容媒体按纯文本返回，并禁止浏览器 MIME 嗅探
• 完善循环依赖检查、门禁超时处理与测试网络请求检查
• 覆盖率统计纳入插件与工程脚本，修复全新检出与 Python 3.10 环境的 CI 问题
• 插件 2.0 专题文档合并为插口协议、实现与验证两份，移除已完成的交接过程文档

修复与兼容性影响

• 插件自有贡献与资源支持热插拔；内核及宿主实现的更换需要重启生效
• 自定义插件须使用当前声明式协议，旧注册接口不再保留
• 本次不迁移旧格式的子智能体标签记录；新建标签按新格式保存与恢复
• 延迟配置应用失败时保留已保存配置，运行时继续使用旧代，界面明确提示应用失败
• extend / wrap 的组合装配尚未实现，不属于本次可用能力

升级注意事项

• 升级前备份会话数据与插件配置；认证凭据按原有安全规则单独保管
• 升级后重启 GUI 或 Web 服务，并刷新页面以加载新前端资源
• 自定义插件升级前核对 docs/plan/plugin-slots-protocol.md
• 旧格式子智能体标签无法恢复时，关闭旧标签并重新打开对应子会话
• Python 版本要求仍为 3.10+

实际执行的验证结果

发布准备在 Windows / Python 3.12 上执行。下列升级前远端验证对应提交 a346f3b；发布提交的最终远端结果见本版本关联的 GitHub Actions。

VERSION / current_version() / pyproject / README 徽章 / UI 版本：0.2.1
本地全量 CI：36 项通过，1 项真实模型专项验收按配置跳过
check_readme.py / check_ui_js.py：通过
tests.test_update + tests.test_classic_adapter：136 项通过
Windows 更新包、完整包：本地构建通过
README 截图：1440×1000 白天模式桌面窗口，v0.2.1，规定的会话与面板状态已核对
升级前提交的 GitHub CI：Ubuntu / Python 3.10、3.12 全部通过
升级前提交的 GitHub Windows GUI / Gitee 镜像同步：通过
单元测试清单：2474 个用例（平台相关跳过以各任务日志为准）
插件启停、失败恢复、子会话标签与主题：已完成隔离回归
真实模型截图流程已执行；语音合成完成及实际听感、跨平台 GUI 未作完整验收

v0.2.0

本版版本号

v0.2.0

本版变更

插件 2.0 装配

• 增加启动插口树、SlotTree/SlotRegistry、动态插口与默认实现绑定
• 增加插件装配覆盖、工具/UI/设置/路由/事件贡献登记与卸载回滚
• 拆分 boot、host、shell、tool 组件和运行期插口
• 完善 PluginContext、插件路径、插件设置树、UI 树和会话门控
• 调整上下文源、提示词章节、请求尾部和工具管道接入方式

AI 角色扮演

• ai_speak 更名为 ai_cosplay，工具名改为 ai_speek
• 人物身份迁入 plugin-config.ini
• 设置页改为表单，支持多行身份配置
• 播放器增加 pending 状态，支持滚动重启和媒体错误重试
• 标题生成失败时使用用户消息兜底

推理与界面

• 推理档位增加 low，支持 low / high / max，默认 high
• 思考深度按钮显示当前档位
• 修复极简模式下后台任务与子智能体面板背景
• 修复思考深度菜单被字幕覆盖
• 设置页异步请求增加当前视图校验，避免旧响应覆盖当前标签
• 压缩摘要按 Markdown 展示，压缩指令强制 ## 标题与 - 条目

认证与启动

• 已登录页面每小时调用 /auth/status，服务端重新下发会话 Cookie
• GUI 启动时检测旧 AI Agent 占用端口，强制结束进程树后重启
• 关闭 GUI 窗口时先停止 Web 服务，再销毁窗口
• 登录页使用自定义空密码校验，错误提示位于输入框下方
• 环境信息加入 Python 与 Node 版本，移除独立 env_probe 工具

工程

• 工具总数调整为 67
• 新增端口清理模块及独立测试
• 更新 catalog、工具文档、测试和复杂度文档

修复与兼容性影响

• ai_speek 替代旧工具名；仍引用 ai_speak 的外部配置或脚本需要改名
• env_probe 已移除；需要环境信息时使用系统提示词中的操作系统、Python、Node 和会话信息
• 默认推理档位为 high；已有会话保存的 max 或 low 继续生效
• 已落盘的旧压缩摘要保持原内容，下一次压缩才会按新 Markdown 规则生成
• 会话 Cookie 采用每小时滑动续期；服务进程重启会使内存会话失效，需要重新登录
• 现有 data/ 会话记录格式保持兼容；旧插件名 ai_speak 的配置需迁移为 ai_cosplay

升级注意事项

• 升级前备份 data/ 与 plugins.ini
• 将 plugins.ini 中的 ai_speak 插件项迁移为 ai_cosplay
• 升级后重启 GUI 或 Web 服务，使新前端资源和认证逻辑生效
• 首次启动如出现登录页，使用现有访问密码登录
• Python 版本要求仍为 3.10+
• 发布包必须包含本文件 docs/releases/v0.2.0.md，否则 release.yml 会拒绝创建 Release

实际执行的验证结果

VERSION / current_version() / pyproject / APP_VERSION：0.2.0
tests.test_update + tests.test_classic_adapter：136 项通过
tests.test_web_auth：26 项通过
tests.test_gui_launcher：9 项通过
tests.test_port_cleanup：4 项通过
check_readme.py：通过（2182 用例）
ruff：受影响 Python 文件通过
check_ui_js.py：通过
check_silent_except.py：通过
check_complexity.py：通过
gen_complexity_md.py --check：通过

v0.1.6

视觉操作 2.0

• 持续视觉帧与视野聚焦
• 随机单点校准与 32px 校验
• 聚焦区域最小 10×10
• 聚焦移动不再强制 check_points
• 授权、用户接管与闭眼状态同步
• 眼睛按钮改为图标，闭眼时隐藏

桌面工具

• 迁移 vision_app / vision_window / vision_eye
• 迁移 vision_type_into / vision_keyboard
• 迁移 vision_wait / vision_find / vision_click_text
• 迁移 vision_mouse / vision_open
• 统一要求视觉授权
• 日志写入与轮转

修复

• 修复视觉日志路径
• 修复 Alt+Tab 回退误报
• 修复 Win 键假成功
• 修复视觉聚焦失败
• 修复眼睛按钮显示状态

v0.1.5

v0.1.5

本版变更

• 新增会话历史分页：首屏只加载最新一页，向上滚动按需加载更早轮次。
• /api/chat/history 新增可选 before / meta / page 契约；旧客户端忽略新字段仍可正常渲染。
• 历史页按用户轮次锚点分页，before 排他，页面只包含完整轮次；真实会话遍历验证无漏页、无重复。
• 附件按页合并进缓存，加载旧页不会清除已渲染页的图片。
• 经典界面支持向上加载、失败重试、深色加载状态，以及输入框外侧的快速回到底部按钮。
• 长工具报文超过 100000 字符时延迟展开，减少首屏 DOM 文本量。
• 全项目术语统一：Round / Turn / Pass、Web UI、工具往返等，文档与代码注释同步。
• 后台任务输出缓冲区裁剪时回退游标，避免裁剪后读取为空或错位。
• --media-root 现在真正限制 /api/media；未配置时使用全部可见根。
• /api/chat/stop 返回当前活跃回合的 run_id。

修复与兼容性

• /api/chat/history 的 items / context_layout / todo_list / ok 保持兼容；分页字段为可选增量。
• 未修改内核事件格式、会话落盘格式和 SSE 续传语义。
• 配置文件无需迁移。

升级注意

• 版本号更新为 v0.1.5。
• 使用现有安装方式覆盖升级即可；更新包仍会合并 *.ini 用户配置。
• 历史分页只影响经典界面投影层，子会话历史接口保持原有行为。

验证

• 全量 CI：29 步通过，1 项环境跳过（真实模型验收未启用）。
• 单元测试：1937 通过。
• 覆盖率门禁：通过。
• 会话历史分页真实会话遍历：6 页 / 7 条用户消息 / 7 条唯一消息，无重复、无缺失。
• 界面截图验证：首屏一页、向上翻页后增加旧页、快速回底按钮可用。

v0.1.4

新增

• HTTP 鉴权、登录会话、API Token、CSRF 与桌面 bootstrap
• 鉴权文件支持 Windows DACL、权限校验与自动回退
• Token issue/revoke 使用线程锁与跨进程文件锁

修复

• 登录页关闭按钮仅在 GUI 显示
• 修复 README 对动态鉴权目录的漏判

v0.1.3

v0.1.3

本版变更

• 设置保存改为信令通知：活动会话重新拉取会话级设置，非活动会话切换时强制刷新
• 设置页与全局控件各自拉取并重绘，避免用全局默认覆盖会话级推理档位
• 插件配置保存增加跨标签页通知
• 版本升级至 0.1.3，同步 README、截图与测试文档
• 合并重复规则，统一架构优先级与授权门

兼容性

• 设置广播不再携带配置值，只作为刷新信号
• 更新包语义保持不变：普通文件覆盖，*.ini 合并用户配置

验证

• CI：Python 3.10 / 3.12 均通过
• Release：通过
• Windows GUI：通过
• 单元测试：1878 个通过

v0.1.2

Full Changelog: v0.1.1...v0.1.2

v0.1.1

架构重构

• 拆分全部超阈值函数，删除复杂度豁免登记表
• 复杂度门禁改为超阈值直接失败，不再保留白名单
• 抽出 composer layout，后台任务、子 Agent、输入区布局归属统一

子 Agent 修复

• 子 Agent 系统提示词改用角色工具视图
• 子 Agent 上下文尾部支持角色可见性声明
• session_* 与 ai_speak 不再出现在子 Agent 提示词
• 修复批次回滚、状态同步、启动失败传播和并发收尾

链路修复

• 修复 Web 路由拆分后的 GET/POST 分派
• 修复上下文布局的角色工具视图
• 修复写盘门控、上下文统计与历史回显回归

验证

• 全量 CI：30 步，通过 29，跳过 1（真实模型验收环境未开启）
• 单元测试：1867 个通过
• 覆盖率：agent/core 91.4%，agent/subagent 89.6%
• 复杂度：0 文件 / 0 函数超阈值
• 验收：batch a-f、phase3、mvp2、web 通过

v0.1.0 首个基座版本

Full Changelog: https://github.com/diky87688973/ai-agent/commits/v0.1.0