v0.4.1-zh.md

August 7, 2026 · View on GitHub

v0.4.1 面向拥有大量历史会话或大型 rollout 文件的用户，显著减少 Windows 同步过程中的重复进程启动、文件扫描和事务日志读取，同时完善备份统计与发布包交付。升级不改变配置、认证或自动化协议。

🚀 升级后，你可以

更快地同步大量历史会话：Windows Node CLI 会复用同一个改写 worker，Core 也减少重复内容扫描和事务日志校验。
更可靠地看到备份占用信息：备份文件数和大小会被缓存，并在提交、恢复或回滚结束后刷新；刷新失败会明确显示警告。
按使用场景选择下载包：普通用户继续下载单文件 GUI，自动化用户可单独下载 Automation ZIP，也可下载包含全部工具的 Windows 完整包。

📦 下载

使用场景	下载	更新方式
只需要 Windows GUI	单文件 GUI	支持软件内自动更新
脚本、CI 或 AI Agent	Windows x64 自动化接口包	手动下载更新
GUI 与自动化接口都需要	Windows x64 完整包	手动下载更新

查看全部 SHA-256 校验值

当前 Windows 程序尚未进行代码签名，首次运行可能出现 SmartScreen 的“发布者未知”提示。请确认文件来自本项目 GitHub Release，并按需使用 SHA-256 校验下载内容。

⬆️ 升级说明

v0.4.0 Windows GUI 用户可以直接使用内置更新：每天首次启动会自动检查稳定版，也可以点击“检查更新”。
内置更新只升级 GUI，不会安装 CodexProviderSync.Automation.exe 或协议描述文件；自动化用户请手动下载对应 ZIP。
升级不要求迁移 config.toml、SQLite 数据库或已有托管备份。更新后建议先点击“刷新”或运行 codex-provider status 核对路径与 Provider。
同步、切换或恢复前仍建议关闭 Codex Desktop、Codex App 和 app-server，以避免 SQLite 被占用或活跃 rollout 被跳过。

🛡 安全保障

工具不负责登录、认证或切换账号，不会修改 auth.json，也不会复制凭据到备份或测试夹具。
工具只同步会话可见性相关元数据，不改写对话正文、消息历史、会话标题、updated_at 或 encrypted_content。
写操作仍在目标修改前创建托管备份，并保留事务记录、失败回滚和崩溃恢复能力。
checked apply 仍会在执行前重新验证目标状态；Windows 进程仍不会通过 WSL UNC 路径直接修改 SQLite。

⚙️ 自动化接口（实验性）

普通桌面用户可以跳过本节。v0.4.1 没有更改自动化协议版本；describe、status、plan、sync、switch、restore 和 prune 的调用方式保持兼容。新的独立 Automation ZIP 包含可执行文件、协议 schema 和中文快速说明。

⚠️ 重要说明

如果结果显示 Skipped locked rollout files，说明活跃会话在同步期间仍在写入；其余历史会话已继续处理。结束对应会话后再次同步即可完整改写。
\\wsl.localhost\... 和 \\wsl$\... SQLite Home 在 Windows 中仅用于安全诊断；请进入对应 WSL 发行版，用 Linux 路径运行 CLI。
含 encrypted_content 的会话跨 Provider 或账号后，通常只能恢复列表可见性；继续对话或 compact 仍可能出现 invalid_encrypted_content。
Codex Desktop 首屏可能只显示最近 50 条会话；本工具不会修改 updated_at 来改变排序。

🔍 验证结果

PR #75 的 Node CLI 验证通过 207 项测试；100 个 rollout 文件的本地基准仅使用一个 Windows worker，约 1.1 秒完成。
v0.4.1 发布准备验证通过 385 项 .NET 测试（1 项按环境跳过）和 210 项 Node 测试，Release 构建为 0 警告、0 错误。
GitHub Actions ci 已在合并提交前通过；Release 工作流还会再次校验版本一致性、完整测试、Windows 发布构建、打包内容和 SHA-256 文件。

查看 v0.4.0 到 v0.4.1 的完整代码变更。