-
Notifications
You must be signed in to change notification settings - Fork 130
Add Chinese release publishing flow and Automation package #72
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.
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
Merged
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,38 @@ | ||
| # 更新日志 | ||
|
|
||
| 本文件记录面向用户和集成方的重要变化。完整的发布叙事、升级说明和下载入口见对应版本的中文发布说明；实现证据和测试门禁见技术发布说明。 | ||
|
|
||
| ## [0.4.0] - 2026-08-04 | ||
|
|
||
| ### 新增 | ||
|
|
||
| - 新增实验性 Windows 自动化接口，支持 `describe`、`status`、`plan`、`sync`、`switch`、`restore` 和 `prune`。 | ||
| - 新增独立 SQLite Home 支持，以及按 Codex Home 保存的 Windows GUI SQLite Home 配置。 | ||
| - 新增独立 Automation ZIP；单文件 GUI 和包含全部工具的 Windows ZIP 保持可用。 | ||
|
|
||
| ### 变更 | ||
|
|
||
| - Windows GUI 与自动化接口改为共享 Application 用例，Core 继续统一负责配置、rollout、SQLite、备份、恢复、锁和 WSL 安全策略。 | ||
| - 新备份使用 metadata v2 记录 SQLite Home 和数据库文件，同时继续支持旧版托管备份。 | ||
| - GitHub Release 正文改为读取随版本 tag 入库的中文发布说明。 | ||
|
|
||
| ### 修复 | ||
|
|
||
| - 修复多文件写入部分成功后无法可靠补偿的问题；失败和取消现在会按事务记录回滚。 | ||
| - SQLite 提交结果无法确认时改为保守恢复，不再把不确定状态报告为成功。 | ||
| - 强化锁所有权恢复、SQLite 快照恢复和 WSL UNC 路径安全诊断。 | ||
|
|
||
| ### 安全 | ||
|
|
||
| - 写操作在目标修改前创建绑定备份，并保留崩溃恢复信息。 | ||
| - 自动化接口的写操作默认只生成计划；实际执行需要 `--apply`、匹配的计划文件和 SHA-256 摘要。 | ||
| - 自动化路径拒绝 `auth.json`、符号链接、reparse point 和非绝对路径。 | ||
|
|
||
| ### 升级说明 | ||
|
|
||
| - v0.3.1 / v0.3.2 Windows GUI 可以通过内置更新升级，但内置更新只替换单文件 GUI。 | ||
| - 升级不要求手动迁移配置；需要自动化接口的用户应单独下载 Automation ZIP 或 Windows 完整包。 | ||
|
|
||
| [中文发布说明](docs/release-notes/v0.4.0-zh.md) · [技术发布说明](docs/RELEASE_NOTES_V0.4.0.md) · [完整变更对比](https://github.com/Dailin521/codex-provider-sync/compare/v0.3.2...v0.4.0) | ||
|
|
||
| 更早版本见 [GitHub Releases](https://github.com/Dailin521/codex-provider-sync/releases)。 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,70 @@ | ||
| # 自动化接口快速开始 | ||
|
|
||
| `CodexProviderSync.Automation.exe` 是供脚本、持续集成（CI）和 AI Agent 调用的实验性 Windows 接口。普通桌面用户不需要它，直接使用 `CodexProviderSync.exe` 即可。 | ||
|
|
||
| 自动化接口包包含： | ||
|
|
||
| - `CodexProviderSync.Automation.exe` | ||
| - `automation-protocol-v0.4.schema.json` | ||
| - 本说明文件 | ||
|
|
||
| 接口每次运行只向标准输出写入一份协议 `0.4` JSON；诊断信息写入标准错误。所有路径都必须是绝对路径。 | ||
|
|
||
| ## 只读命令 | ||
|
|
||
| ```powershell | ||
| # 查看协议能力和安全要求 | ||
| .\CodexProviderSync.Automation.exe describe | ||
|
|
||
| # 查看当前 Provider、rollout 和 SQLite 状态 | ||
| .\CodexProviderSync.Automation.exe status ` | ||
| --codex-home C:\Users\you\.codex | ||
| ``` | ||
|
|
||
| ## 先生成计划 | ||
|
|
||
| 写命令默认不会修改数据。以下示例生成一份同步计划： | ||
|
|
||
| ```powershell | ||
| $planResponse = .\CodexProviderSync.Automation.exe plan ` | ||
| --operation sync ` | ||
| --codex-home C:\Users\you\.codex ` | ||
| --provider openai | ConvertFrom-Json | ||
|
|
||
| $planPath = 'C:\Temp\codex-provider-sync-plan.json' | ||
| $planJson = $planResponse.data | ConvertTo-Json -Depth 100 -Compress | ||
| $utf8NoBom = New-Object System.Text.UTF8Encoding($false) | ||
| [System.IO.File]::WriteAllText($planPath, $planJson, $utf8NoBom) | ||
| $planDigest = $planResponse.data.digest | ||
| ``` | ||
|
|
||
| 请先检查返回的计划、警告和目标列表。计划会绑定当前输入与目标状态，具有有效期，并且只能使用一次。 | ||
|
|
||
| ## 明确执行计划 | ||
|
|
||
| 确认计划无误后，使用同一组操作参数，并同时提供 `--apply`、计划文件和计划摘要： | ||
|
|
||
| ```powershell | ||
| .\CodexProviderSync.Automation.exe sync ` | ||
| --codex-home C:\Users\you\.codex ` | ||
| --provider openai ` | ||
| --apply ` | ||
| --plan $planPath ` | ||
| --plan-digest $planDigest | ||
| ``` | ||
|
|
||
| 如果目标状态在计划生成后发生变化，执行会被拒绝，需要重新生成计划。同步和切换仍遵循 Core 的备份、事务、回滚、锁和 WSL UNC 安全规则。 | ||
|
|
||
| ## 支持的命令 | ||
|
|
||
| | 命令 | 用途 | | ||
| | --- | --- | | ||
| | `describe` | 查看协议能力和安全要求 | | ||
| | `status` | 只读检查当前状态 | | ||
| | `plan` | 为写操作生成计划 | | ||
| | `sync` | 同步历史会话元数据 | | ||
| | `switch` | 切换 Provider/model 后同步 | | ||
| | `restore` | 恢复托管备份 | | ||
| | `prune` | 清理旧的托管备份 | | ||
|
|
||
| 完整参数、安全限制和返回结构见项目 [README](../README.md) 与 `automation-protocol-v0.4.schema.json`。协议 `0.4` 仍处于 1.0 之前的实验阶段，未来可能发生不兼容变更。 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Once this release is tagged, the README and packaged assets advertise
CodexProviderSync.Automation.exe, but the repository's mandatory operator guide still states that no Automation executable is shipped. AGENTS-aware tools will therefore treat the newly published interface as unavailable; either update the operator contract as part of this change or do not publish the executable.AGENTS.md reference: AGENTS.md:L22-L24
Useful? React with 👍 / 👎.