Codex 管理中心

Windows 本地桌面工具，用一个界面管理 Codex 官方账号与第三方 API 配置、执行切换健康检查，并在不改变旧会话的前提下读取和导出会话接续信息。

状态

• 已验证：Tauri 2 + React 19 桌面壳、Rust 会话索引、PowerShell 服务商事务后端和 Python 会话预览/导出已集成。
• 已验证：服务商切换具备互斥、事务日志、加密备份、失败回滚和崩溃恢复；会话索引与正文只读访问。
• 已验证：默认窗口为 820 × 580，正式安装版已完成服务商、健康检查和会话管理三页实机验收。
• 边界：项目面向 Windows 本机使用，不提供云端账号同步，也不上传 Codex 配置、凭据或会话正文。

核心能力

• 在官方账号登录与多个第三方 API 配置之间安全切换。
• 对实际 CODEX_HOME 配置、凭据、Codex 自检、唯一写入方、事务和恢复能力进行健康检查。
• 通过 Rust 快速读取并缓存 Codex 会话列表。
• 只读查看最近两小时或完整的 user/assistant 对话，并将一个或多个会话整理成一份接续索引文件。

仓库结构

路径	职责
Codex管理中心Next/	Tauri、React 和 Rust 桌面应用；负责界面、IPC 与会话列表缓存
Codex服务商切换/	服务商配置、认证文件、事务、备份、回滚和健康检查的唯一写入模块
Codex会话接续助手/	会话正文只读预览、隐私过滤和接续文件导出
docs/	产品边界、架构、测试与本机发布说明

旧 Tkinter 管理中心、升级备份、桌面快捷方式和其他本机恢复资料不属于正式源码仓库，不会上传。

开发环境

• Windows 10/11
• Node.js 20 或更新版本
• Rust stable（MSVC 工具链）
• Python 3.11；构建发布 sidecar 时需要 PyInstaller

cd Codex管理中心Next
npm ci
npm run tauri:dev

tauri:dev 会从两个相邻的后端模块同步受控资源。不要直接修改 src-tauri/backend/ 下的生成副本。

验证与发布

完整命令见 docs/testing.md；架构和安全边界见 docs/architecture.md。本机 NSIS 发布使用：

cd Codex管理中心Next
npm run tauri:build

文档

从 docs/INDEX.md 查找各主题的权威说明。各模块的特殊维护规则保存在对应目录的 AGENTS.md。