Skip to content

docs: clarify v1.0.3 release notes #105

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Dailin521 merged 1 commit into from
Sep 15, 2026
Merged

docs: clarify v1.0.3 release notes #105

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 39 additions & 21 deletions docs/release-notes/v1.0.3-zh.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,34 +2,52 @@

# v1.0.3：会话同步与更新体验改进

此版本让 Provider 切换后的历史会话同步更可靠，也让桌面版更新更直接。
这次更新解决了“少量异常会话拖住整次同步”的问题，也让桌面版更新更快、更由你决定。已有 Codex 数据、配置和备份会保留。

## 会话同步
## 🚀 升级后，你可以

- 支持最高 **128 MiB** 的会话首行元数据。
- 单个会话的首行编码、格式或大小有问题时，跳过该会话并显示原因；正常会话继续同步或切换。
- 问题会话关联的 SQLite 索引保持不变。修复数据后重新预览即可纳入。
- 修复非法 UTF-8、数组形式的 `payload`、复杂 JSON 以及 CRLF 边界导致的错误处理。
- Provider 字节等长时继续原地更新；其他有效会话使用流式复制，聊天正文保持不变。
- **让正常会话继续同步**：遇到格式、编码、大小或占用有问题的会话时，工具会跳过该会话并告诉你原因，不再让其他正常会话一起停下。
- **处理更大的会话元数据**：支持最高 **128 MiB** 的会话首行。修复异常数据后重新预览，即可将它重新纳入同步。
- **自行决定何时安装更新**：每天首次启动约 5 秒后检查更新；下载完成后，是否重启安装由你决定，不再因当前同步、Watch 或恢复状态禁用安装。

## 桌面版更新
## 📦 下载

- 每天首次启动后约 **5 秒**自动检查一次更新；也可随时手动检查。
- 下载完成后是否重启安装由你决定。存储状态、同步写入、Watch 或恢复状态不会再禁用安装按钮。
- 更新不会替换 Codex 的会话、配置或备份数据。
| 使用场景 | 下载 | 更新方式 |
| --- | --- | --- |
| 日常使用 | `CodexProviderSync-1.0.3-windows-x64-setup.exe` | 安装后可在应用内检查、下载并确认安装更新 |
| 便携使用 | `CodexProviderSync-1.0.3-windows-x64-portable.zip` | 手动下载，完整解压后运行 `Codex Provider Sync.exe` |

## 使用提示
[查看发布页、校验文件和下载](https://github.com/Dailin521/codex-provider-sync/releases/tag/v1.0.3)

- “部分完成”表示正常会话已经继续处理。格式或大小问题请处理数据后重新预览；会话仍被占用或文件发生变化时，停止写入后再同步。
- Provider 信息一致后仍无法继续的旧会话，请查看 Codex 的具体报错；加密内容或模型兼容问题可能需要回到原 Provider / 账号，或新建会话。
- Windows x64 提供安装版和便携 ZIP。便携版请完整解压后运行。
## ⬆️ 升级说明

## 下载
1. 已安装 1.0.2 的用户可直接检查更新；下载完成后点击“重启并安装”。
2. 也可以退出旧程序后手动运行安装包。便携版请完整解压新 ZIP，不要只替换其中一个 EXE。
3. 不需要删除 Codex 配置、数据库、会话或备份。升级后可先打开“更新”页检查版本，再按原来的方式同步或切换 Provider。

- 安装版：`CodexProviderSync-1.0.3-windows-x64-setup.exe`
- 便携版：`CodexProviderSync-1.0.3-windows-x64-portable.zip`
- [官方 Release](https://github.com/Dailin521/codex-provider-sync/releases/tag/v1.0.3) 提供校验文件。
## 🗂 会话同步怎么处理

本版为未签名 Windows x64 Electron 包。macOS/Linux Electron、npm 和 Legacy 包独立发布。
- 出现“部分完成”时，正常会话已经完成；展开明细可看到被跳过的文件和原因。
- 格式、编码或大小问题：处理文件后重新预览，再同步。
- 文件仍被 Codex 占用或在操作中发生变化：结束相关会话后，再运行一次同步。
- Provider 信息已经一致但旧会话仍不能继续，请查看 Codex 的具体报错；原账号的加密内容或模型兼容问题仍可能需要回到原 Provider / 账号，或新建会话。

[使用说明](../../README.md) · [桌面指南](../README_DESKTOP_ZH.md) · [更新日志](../../CHANGELOG.md)
## 🔒 数据处理方式

- 工具只更新会话和索引中的 Provider 信息，不读取 `auth.json`，也不修改聊天正文、`updated_at` 或 `encrypted_content`。
- 实际写入前会创建备份；需要撤回时可以使用备份恢复。
- Provider 名称字节长度相同时直接更新元数据；其他正常会话保持聊天正文不变地复制更新。

## ⚠️ 使用前知道这些

- 超过 128 MiB、BOM 或 UTF-16 等不支持格式的首行，需要先处理后才能同步。
- 同步 Provider 信息不能保证跨 Provider 继续会话或 compact；它也不能解除原账号加密内容的访问限制。
- 本版提供 Windows x64 Electron 安装版和便携版；其他平台和旧版独立发布。

## 🔍 本版验证

- 覆盖正常会话与异常会话混合、归档会话、大首行、预览后变化及同步后恢复。
- Windows 安装版和便携版均完成隔离数据的 Sync → Restore 验收。
- 发布页附带安装包校验文件、更新元数据和构件说明，供下载后核对。

[使用说明](https://github.com/Dailin521/codex-provider-sync#readme) · [桌面版指南](https://github.com/Dailin521/codex-provider-sync/blob/main/docs/README_DESKTOP_ZH.md) · [完整变更对比](https://github.com/Dailin521/codex-provider-sync/compare/v1.0.2...v1.0.3)
Loading