Release 1.5.3 macOS packaging and UI updates

Author: Cmochance

.gitignore

@@ -10,6 +10,7 @@
 # Local temp/test outputs
 *.log
 tmp/
+.tmp/
 .venv/
 .pytest_cache/
 __pycache__/
@@ -19,5 +20,6 @@ src-tauri/target/
 src-tauri/gen/
 local_doc/
 agent/
+codex_history/
 .codex/
 docs/

CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 1.5.3 - 2026-04-27
+
+- Added real update checks against the configured GitHub latest-release JSON endpoint.
+- Added automatic new-version prompting when the latest release is newer than the running app.
+- Fixed update version parsing so historical two-part tags such as `1.5` compare as `1.5.0` instead of failing.
+- Added macOS `.pkg` packaging alongside `.app` and `.dmg`.
+- Standardized future release records on full three-part semantic versions.
+
+## 1.5.2 - 2026-04-21
+
+- Windows installer uploaded as `codex_switch_1.5.2_x64-setup.exe`.
+- Historical note: this asset was uploaded under the non-standard GitHub Release tag `1.5`.
+
+## 1.5.1 - 2026-04-21
+
+- Windows installer uploaded as `codex_switch_1.5.1_x64-setup.exe`.
+- Historical note: this asset was uploaded under the non-standard GitHub Release tag `1.5`.
+
+## 1.5.0 - 2026-04-20
+
+- Added normalized installation and version-control release.
+- Uploaded macOS DMG and Windows installer assets.
+- Historical note: the GitHub Release tag was created as `1.5`; future release tags should use full semantic versions such as `1.5.3`.
+
 ## 1.4.2 - 2026-04-16
 
 - Added the new local release after GitHub tag `1.4.1`.

README.md

@@ -1,113 +1,146 @@
-# Codex Account Switch
+# Codex 账号切换工具
 
-中文文档: [README.zh-CN.md](./README.zh-CN.md)
+Codex 账号切换工具是一个本地桌面应用，用来在同一台机器上管理多个 Codex 账号。它通过本地账号备份目录保存不同账号状态，支持切换当前账号、查看账号状态和额度信息，并提供 macOS 与 Windows 原生 Tauri 桌面界面。
 
-This repository packages a local multi-account Codex switching workflow: macOS now keeps the retained command-line flow under `macOS-backup/`, with `macOS-backup/install.sh` acting as a compatibility entry that prefers the native desktop runtime when available and falls back to the legacy shell flow, while Windows uses a native desktop app.
+`macOS-backup/` 里的 shell 脚本仍然保留，作为兼容旧流程的入口；当前主要方向是原生桌面端。
 
-## Features
+## 当前功能
 
-- Automatically save the current active account after login, then switch accounts with one click
-- Close the Codex desktop app before switching and relaunch it afterward when needed
-- Use the Windows control panel for switching, login, opening folders, adding profiles, and related actions
+- 仪表盘：显示当前账号、账号总数、可用账号和待登录账号数量。
+- 账号页：每页 4 张账号卡片，支持切换、登录刷新、重命名、删除或清空、打开账号目录、编辑 Base URL。
+- 运行时页：先放置运行时可视化界面，后续再接入更多后端能力。
+- 设置页：包含语言、主题、端口、开机自启占位、更新地址、配置备份、版本、许可证、检查更新和 GitHub 入口。
+- 引导页：展示添加账号、登录、切换账号的基础流程。
+- 支持多套浅色和深色主题、中英文界面，以及没有 Tauri API 时的本地预览数据。
 
-## Platform support
+部分设置项和运行时条目目前只完成前端界面，后续再接入后端。
 
-- macOS: compatibility shell scripts under [`macOS-backup/`](./macOS-backup)
-- Windows: the `.exe` desktop application from the repository release
+## 平台支持
 
-## Repository layout
+- macOS：原生 Tauri 桌面端，同时保留 `macOS-backup/` 下的兼容脚本。
+- Windows：原生 Tauri 桌面端，通过 Release 中的 `.exe` 分发。
 
-- [`macOS-backup/`](./macOS-backup): retained macOS compatibility installer, native desktop bridge scripts, and legacy shell fallback
-- [`src-tauri/`](./src-tauri/): Rust/Tauri runtime root
-  - [`src-tauri/win/front/`](./src-tauri/win/front/): Windows desktop frontend shell
-  - [`src-tauri/mac/front/`](./src-tauri/mac/front/): macOS desktop frontend shell
-  - [`src-tauri/shared/front/`](./src-tauri/shared/front/): shared frontend bridge modules and font assets
-  - [`src-tauri/win/runtime/`](./src-tauri/win/runtime/): Windows-only runtime code
-  - [`src-tauri/mac/runtime/`](./src-tauri/mac/runtime/): macOS-only runtime code
-  - [`src-tauri/shared/runtime/`](./src-tauri/shared/runtime/): shared CLI, models, errors, and runtime logic
-  - [`src-tauri/shared/platform/`](./src-tauri/shared/platform/): cross-platform lifecycle hook layer
-  - [`src-tauri/shared/commands/`](./src-tauri/shared/commands/): shared Tauri command handlers
-  - [`src-tauri/src/`](./src-tauri/src/): crate entrypoints kept for Cargo/Tauri conventions
-- [`examples/account_backup/demo/`](./examples/account_backup/demo/): placeholder `auth.json` template
-- [`docs/`](./docs/): implementation and security notes
-- [`windows/`](./windows/): historical Windows note
+平台专属逻辑优先放在 `src-tauri/mac/**` 或 `src-tauri/win/**` 下。`src-tauri/shared/**` 只放共享前端模块、命令契约、运行时模型和中立的跨平台逻辑。
 
-## macOS installation
+## 仓库结构
+
+- `src-tauri/`：Rust 与 Tauri 应用根目录。
+- `src-tauri/mac/front/`：macOS HTML 壳、样式和窗口控制。
+- `src-tauri/win/front/`：Windows HTML 壳、样式和窗口控制。
+- `src-tauri/shared/front/`：共享前端状态、渲染、动作、主题、国际化和 Tauri 桥接。
+- `src-tauri/mac/runtime/`：macOS 运行时集成。
+- `src-tauri/win/runtime/`：Windows 运行时集成。
+- `src-tauri/shared/runtime/`：共享模型、账号数据处理、更新检查、路径、元数据和切换核心逻辑。
+- `src-tauri/shared/commands/`：暴露给前端的 Tauri 命令处理层。
+- `macOS-backup/`：旧 shell 流程和桌面桥接的兼容安装、卸载脚本。
+- `examples/account_backup/demo/`：示例 `auth.json` 模板。
+- `scripts/`：版本同步、macOS 产物布局和 macOS `.pkg` 生成脚本。
+
+生成文件不进仓库。前端网页构建输出放在 `dist/web/`，macOS 桌面端打包产物直接落到 `dist/` 根目录。
+
+## 开发
+
+安装依赖：
 
 ```bash
-cd ~/.../Codex_Account_Switch
-bash macOS-backup/install.sh
-source ~/.zshrc
+npm install
 ```
 
-The compatibility installer supports three modes:
+启动前端和 Tauri 开发应用：
 
-- `auto` (default): prefer the native desktop installer when a macOS runtime binary is available, otherwise fall back to the legacy shell installer
-- `desktop`: require the native desktop installer path and fail if it cannot be found
-- `legacy`: force the original shell-based `codex-switch.sh` flow
+```bash
+npm run tauri:dev
+```
 
-Examples:
+只构建前端：
 
 ```bash
-bash macOS-backup/install.sh --mode auto
-bash macOS-backup/install.sh --mode desktop
-bash macOS-backup/install.sh --mode legacy
+npm run build
 ```
 
-In desktop mode, the installer:
+运行 Rust 测试：
 
-- delegates to the native `codex_switch` installer
-- keeps the real runtime under `~/.codex/account_backup/macos/`
-- writes the managed `~/.codex/bin/codex` shim through the native runtime
-- injects a PATH hook into `~/.zshrc` so the managed shim is available in the shell
+```bash
+npm run test:rust
+```
 
-In legacy mode, the installer keeps the original shell behavior:
+## 桌面端打包
 
-- copies `macOS-backup/codex-switch.sh` to `~/.codex/account_backup/codex-switch.sh`
-- creates `~/.codex/account_backup/a` through `~/.codex/account_backup/d`
-- writes the example auth template into any missing `~/.codex/account_backup/<profile>/auth.json`
-- copies the current `~/.codex/auth.json` to `~/.codex/account_backup/a/auth.json` when available
-- initializes profile `a` as the active profile if a real root auth file exists and no active profile is set yet
-- injects a `codex()` wrapper into `~/.zshrc`
+Tauri 2 没有提供 bundle 输出目录配置。macOS 打包脚本会在运行 Tauri 前，把 `src-tauri/target/release/bundle/macos` 和 `src-tauri/target/release/bundle/dmg` 准备成指向 `dist/` 的链接。Tauri 仍然写入它自己的固定 bundle 路径，但实际 `.app` 和 `.dmg` 会直接落到 `dist/`；`.pkg` 生成脚本也直接写入 `dist/`。
 
-## Windows installation
+本地测试阶段只打包 `.app`：
 
-- Download the latest `.exe` desktop application from this repository's Releases page
+```bash
+npm run tauri:build:macos-app
+```
 
-## Local macOS packaging
+`.app` 写入 `dist/` 后，会删除构建过程中生成的裸 macOS 可执行中间产物。
 
-To generate a drag-install `.dmg` locally:
+最终发布阶段打包 `.dmg` 和 `.pkg`：
 
 ```bash
-npm run tauri:build:macos-dmg
+npm run tauri:build:macos-release
 ```
 
-The build outputs land at:
+最终发布流程会把 `.app` 作为打包输入，随后从 `dist/` 中移除 `.app`，只把发布用安装包保留在 `dist/` 根目录。`dist/` 根目录里的旧版本 `.dmg` 和 `.pkg` 会移动到 `dist/history/` 下对应的版本命名文件夹中；重复构建当前版本时会替换当前根目录安装包，不再额外备份。
 
-- `src-tauri/target/release/bundle/macos/codex_switch.app`
-- `src-tauri/target/release/bundle/macos/codex_switch_*.dmg`
-
-## macOS usage
+预期本地产物结构：
 
 ```text
-Open Terminal
-codex switch list   List available accounts
-codex switch a      Switch to the account under folder a
-codex switch b      Switch to the account under folder b
+dist/
+  codex_switch_<version>_<arch>.dmg
+  codex_switch_<version>_<arch>.pkg
+  history/
+    v<old-version>/
+      ...
+  web/
+    ...
+```
+
+## 版本与发布
+
+- 项目版本保存在 `package.json`，并同步到 Tauri 和 Cargo 元数据。
+- GitHub Release 标签使用完整语义版本号，例如 `1.5.3`。
+- 每个补丁版本单独创建一个 Release 标签。
+- 不要把补丁版本产物上传到旧的两段式标签下，例如不要继续把 `1.5.x` 上传到 `1.5`。
+- macOS 安装包作为 Release 资产发布，不提交到 Git。
+
+常用命令：
+
+```bash
+npm run version:sync
+npm run version:set -- 1.5.4
 ```
 
-If you want to add profiles beyond the default `a` through `d`, create the target folder manually first, put a valid `auth.json` inside it, and then run the switch command.
+## macOS 兼容脚本
 
-## macOS uninstall
+通过兼容入口安装：
+
+```bash
+bash macOS-backup/install.sh
+source ~/.zshrc
+```
+
+支持三种模式：
+
+- `auto`：优先尝试原生桌面运行时，找不到时回退到 legacy shell 流程。
+- `desktop`：强制使用原生桌面运行时。
+- `legacy`：强制使用原来的 shell 版 `codex-switch.sh` 流程。
+
+卸载：
 
 ```bash
 bash macOS-backup/uninstall.sh
 bash macOS-backup/uninstall.sh --remove-script
 source ~/.zshrc
 ```
 
-The compatibility uninstaller also supports `--mode auto|desktop|legacy`.
+卸载脚本只移除受管理的命令接入层，不会删除账号备份目录；账号目录需要时手动清理。
+
+## Windows 安装
+
+在仓库 Releases 页面下载最新 Windows `.exe`。
+
+## 账号数据
 
-- In desktop mode it removes the native shell hook first, then delegates to the native runtime uninstaller.
-- In legacy mode it removes the original shell wrapper block.
-- The default uninstall removes only managed command hooks. It does not delete your account folders unless you remove them manually.
+账号数据只保存在本机。导出的配置或账号备份可能包含 API Key 或认证数据，只应保存在可信设备上。