v0.4.1 是针对 v0.4.0 的性能修复版本，重点缓解大量历史会话或大型 rollout 文件场景下同步变慢的问题。相较 v0.4.0，本版本减少了重复进程启动、文件扫描和事务日志读取，但整体速度不一定超过更早版本。升级不改变配置、认证方式或自动化协议。
🔧 主要修复
- 缓解大量历史会话同步变慢：减少批量处理时的重复进程启动、文件扫描和事务日志读取。
- 活跃会话不再中断其余同步：扫描期间仍在写入的 rollout 会被列为已跳过，其他历史会话继续处理。
- 备份统计更加可靠：备份大小和文件数量会在提交、恢复或回滚后刷新；刷新失败会明确显示警告。
- 保持兼容性：配置、认证方式、自动化协议和旧版托管备份均不需要迁移。
📦 下载
| 使用场景 | 下载 | 更新方式 |
|---|---|---|
| 只需要 Windows GUI | 单文件 GUI | 支持软件内自动更新 |
| AI Agent（也可用于脚本或 CI） | Windows x64 自动化接口包 | 手动下载更新 |
| GUI 与自动化接口都需要 | Windows x64 完整包 | 手动下载更新 |
当前 Windows 程序尚未进行代码签名，首次运行可能出现 SmartScreen 的“发布者未知”提示。请确认文件来自本项目 GitHub Release，并按需使用 SHA-256 校验下载内容。
⬆️ 升级说明
- v0.4.0 Windows GUI 用户可以直接使用内置更新：每天首次启动会自动检查稳定版，也可以点击“检查更新”。
- 内置更新只升级 GUI，不会安装
CodexProviderSync.Automation.exe或协议描述文件；自动化接口用户请手动下载对应 ZIP。 - 升级不要求迁移
config.toml、SQLite 数据库或已有托管备份。更新后建议先点击“刷新”或运行codex-provider status，核对路径与 Provider。 - 同步、切换或恢复前仍建议关闭 Codex、Codex App 和 app-server，以避免 SQLite 被占用或活跃 rollout 被跳过。
🛡 兼容性与安全边界
- 工具不负责登录、认证或切换账号，不会修改
auth.json，也不会复制凭据到备份或测试夹具。 - 工具只同步会话可见性相关元数据，不改写对话正文、消息历史、会话标题、
updated_at或encrypted_content。 - 写操作仍在修改目标前创建托管备份，并保留事务记录、失败回滚和崩溃恢复能力。
- checked apply 仍会在执行前重新验证目标状态；Windows 进程仍不会通过 WSL UNC 路径直接修改 SQLite。
⚙️ AI 自动化接口（实验性）
只使用 Windows GUI 的用户可以跳过本节。该接口主要供 AI Agent 调用，也可用于脚本和 CI。v0.4.1 没有更改自动化协议版本；describe、status、plan、sync、switch、restore 和 prune 的调用方式保持兼容。本版本继续提供独立 Automation ZIP，其中包含可执行文件、协议 schema 和中文快速说明。
⚠️ 重要说明
- 如果结果显示
Skipped locked rollout files，说明活跃会话仍持有一个或多个 rollout 文件，或在扫描期间继续写入；其余历史会话已继续处理。结束对应会话后再次同步即可完成改写。 \\wsl.localhost\...和\\wsl$\...SQLite Home 在 Windows 中仅用于安全诊断；请进入对应 WSL 发行版，使用 Linux 路径运行 CLI。- 含
encrypted_content的会话跨 Provider 或账号后，通常只能恢复列表可见性；继续对话或执行 compact 仍可能出现invalid_encrypted_content。 - Codex Desktop 首屏可能只显示最近 50 条会话；本工具不会修改
updated_at来改变排序。
🔍 验证结果
- 已通过 Node 和 .NET 自动化测试；发布工作流已完成版本一致性检查、Windows 构建、资产打包和 SHA-256 校验。