Agent Instructions

处理 CTMS 桌面端任务前，必须先阅读 docs/desktop-project-plan.md。桌面端任务包括但不限于 Tauri、macOS、Windows、桌面打包、桌面存储、文件集成、系统通知和桌面端安全边界。

桌面端仅限该计划书中的第一阶段和第二阶段。除非先明确修改计划书，否则不要实现离线功能、本地业务数据存储、内嵌后端服务或离线同步。

分支与发布治理

处理代码提交、分支同步、版本晋级、正式发布或生产热修复前，必须先阅读：

必须遵守以下规则：

CTMS 网页端和桌面端属于同一个产品，共用 dev、main、release 分支，不创建 web-dev、desktop-dev、web-release、desktop-release 等长期平行分支。
默认晋级路径为短期任务分支进入 dev，再由 dev 晋级到 main，最后由 main 发布到 release。
Agent 创建分支时默认使用 codex/<任务名称>；分支必须从最新 dev 创建，并在合并到 dev 后删除。
codex/ctms-desktop 仅是当前桌面端临时集成分支。Tauri 基线合并到 dev 后，不得继续将其作为长期桌面主线。
生产热修复从 release 创建，合并到 release 后必须依次回合并到 main 和 dev。
网页端和桌面端必须使用同一个语义化版本号、正式标签和源代码提交。修改客户端版本时使用 frontend/package.json 中的 version:set 和 version:check 命令。
平台差异必须收敛在 frontend/src/runtime/ 之后，不能通过长期分支或复制业务代码维护桌面差异。
未经用户明确要求，不执行提交、推送、合并、变基、打标签、删除分支或强制更新远程分支。
执行用户明确要求的 Git 操作前，先检查工作区和目标分支，只暂存本次任务相关文件，不覆盖或撤销用户已有改动。
分支治理规则发生变化时，必须同步更新上述治理文档，不能只修改 AGENTS.md。