@wangxt0223/codex-switcher 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.6.0 - 2026-04-12
+
+- Refactored core model from profile-based switching to `env + account` with built-in `default=~/.codex`.
+- Added env/account command groups: `env {list|create|use|remove|current|path}` and `account {list|add|remove|login|use|logout|current}`.
+- Added per-env account auth slots at `~/.codex-switcher/env-accounts/<env>/<account>/auth.json`.
+- Same-env account switch now swaps `auth.json` only and ignores `--sync`.
+- `list` now shows usage columns with API-first fetch and local sessions fallback, and appends source marker `(api|local)`.
+- Updated Chinese/English README and plugin docs to match the new env/account flow.
+- Updated upgrade and manual checklist docs to remove legacy profile terminology.
+
 ## 0.5.1 - 2026-04-12
 
 - Added `version: <semver>` output in `codex-sw check` for quick runtime version verification.

package/README.en.md

@@ -2,8 +2,8 @@
 
 [中文](README.md) | English
 
-`codex-switcher` is a lightweight profile switcher for Codex CLI and Codex App.
-It isolates accounts by running each profile in its own `CODEX_HOME` directory.
+`codex-switcher` is a lightweight switcher for Codex CLI and Codex App.
+It now uses an `env + account` model: env for shared data, account for isolated `auth.json`.
 
 ## Background
 
@@ -21,7 +21,8 @@ The following is based on observed local behavior and filesystem layout:
 - Session/history/state data is also stored under the same `CODEX_HOME` (for example `history.jsonl`, `sessions/`, `state_*.sqlite`).
 - So when multiple accounts share one `CODEX_HOME`, auth/session data can overwrite or contaminate each other.
 
-`codex-switcher` solves this by assigning each account its own `CODEX_HOME` (`~/.codex-profiles/<profile>`) and switching that directory for CLI/App operations.
+`codex-switcher` solves this by decoupling shared data from auth credentials.  
+Built-in `env=default` maps to `~/.codex`, and same-env account switch only swaps `auth.json`.
 
 ## Install
 
@@ -42,25 +43,22 @@ codex-switcher check
 ## Quick start
 
 ```bash
-codex-switcher add work
-codex-switcher add personal
+codex-switcher account login personal --env default
+codex-switcher account login work --env default
+codex-switcher account use personal --env default
 
-codex-switcher use work --sync
-codex-switcher login --sync
-codex-switcher exec -- login status
-
-codex-switcher switch personal --sync
-codex-switcher app use personal
+codex-switcher env create project-a --empty
+codex-switcher account login corp --env project-a
+codex-switcher account use corp --env project-a
 ```
 
 ## Sync options
 
-- `login --sync`: sync `~/.codex` into the target profile (excluding `auth.json`).
-- `use/switch --sync`: sync current CLI profile into target profile (excluding `auth.json`).
-- `--no-sync`: keep strict isolation without data copy (default).
+- Same-env account switch only replaces `auth.json`; no shared data sync is needed.
+- `account login --sync` (cross-env setup) can sync default-env data into target env (excluding `auth.json`).
 - `use/switch` defaults to `--launch=auto`: on an interactive terminal, `codex` starts automatically after switch.
 - `use/switch --launch`: launch `codex` CLI immediately after switching.
-- `use/switch --no-launch`: switch CLI pointer only, without launching `codex`.
+- `use/switch --no-launch`: switch account pointer only, without launching `codex`.
 - `use/switch -- <codex args...>`: run `codex` with args right after switch (implies launch).
 
 ## Command reference

package/README.md

@@ -3,7 +3,7 @@
 中文 | [English](README.en.md)
 
 `codex-switcher` 是一个面向 Codex CLI 与 Codex App 的轻量账号切换工具。
-它通过为每个 profile 使用独立的 `CODEX_HOME` 目录实现账号隔离。
+它基于 `env + account` 模型管理账号：`env` 共享数据目录，`account` 管理独立 `auth.json`。
 
 ## 项目背景
 
@@ -18,7 +18,8 @@
 简单说就是：Codex 会把“账号登录态 + 会话历史 + 一些本地状态”都放在 `CODEX_HOME` 这个目录里（默认一般是 `~/.codex`）。  
 如果两个账号共用同一个目录，就很容易出现你登我下、我登你下，或者历史数据串在一起的问题。
 
-`codex-switcher` 做的事情其实不复杂：给每个账号分一个独立目录（`~/.codex-profiles/<profile>`），然后在你执行命令或启动 App 时自动切到对应目录。这样每个账号的数据都各管各的，切换也就稳定了。
+`codex-switcher` 做的事情其实不复杂：把“共享数据”和“账号凭证”解耦。  
+默认 `env=default` 对应 `~/.codex`，同一 env 下切换账号只替换 `auth.json`，不动共享数据目录里的其它文件。
 
 ## 安装
 
@@ -39,56 +40,30 @@ codex-switcher check
 ## 快速开始
 
 ```bash
-codex-switcher add work
-codex-switcher add personal
+codex-switcher account login personal --env default
+codex-switcher account login work --env default
+codex-switcher account use personal --env default
 
-codex-switcher use work --sync
-codex-switcher login --sync
-codex-switcher exec -- login status
-
-codex-switcher switch personal --sync
-codex-switcher app use personal
+codex-switcher env create project-a --empty
+codex-switcher account login corp --env project-a
+codex-switcher account use corp --env project-a
 ```
 
 ## 同步选项
 
-- `login --sync`：将 `~/.codex` 同步到目标 profile（不包含 `auth.json`）。
-- `use/switch --sync`：将当前 CLI profile 同步到目标 profile（不包含 `auth.json`）。
-- `--no-sync`：不进行数据同步（默认）。
-- `use/switch` 默认 `--launch=auto`：交互终端中切换后会自动启动 `codex` CLI。
+- 同一 env 下切账号：只替换 `auth.json`，不进行共享数据同步。
+- `account login --sync`（跨 env 场景）：可将默认 env 数据同步到目标 env（不含 `auth.json`）。
+- 兼容命令 `use/switch` 默认 `--launch=auto`：交互终端中切换后会自动启动 `codex` CLI。
 - `use/switch --launch`：切换后立即启动 `codex` CLI。
-- `use/switch --no-launch`：仅切换当前 CLI profile，不启动 `codex` CLI。
+- `use/switch --no-launch`：仅切换账号指针，不启动 `codex` CLI。
 - `use/switch -- <codex args...>`：切换后直接执行 `codex` 参数（隐式启用 launch）。
 
 ## 命令参考
 
-命令默认用 `codex-switcher`，你也可以继续使用兼容别名 `codex-sw`。
-
-| 分类 | 命令 | 说明 |
-| --- | --- | --- |
-| Profile 管理 | `codex-switcher add <profile>` | 新建 profile |
-| Profile 管理 | `codex-switcher remove <profile> [--force]` | 删除 profile |
-| Profile 管理 | `codex-switcher list` | 列出所有 profile |
-| Profile 管理 | `codex-switcher current [cli\|app]` | 查看当前 CLI / App profile |
-| Profile 管理 | `codex-switcher status` | 查看当前 profile 登录状态 |
-| Profile 管理 | `codex-switcher use <profile> [--sync\|--no-sync] [--launch\|--no-launch] [-- <codex args...>]` | 切换当前 CLI profile，可选立即启动 `codex` |
-| Profile 管理 | `codex-switcher switch <profile> [--sync\|--no-sync] [--launch\|--no-launch] [-- <codex args...>]` | `use` 的等价命令 |
-| 数据迁移 | `codex-switcher import-default <profile> [--with-auth] [--force]` | 从 `~/.codex` 导入数据到 profile |
-| CLI 登录态 | `codex-switcher login [profile] [--sync\|--no-sync]` | 登录指定或当前 CLI profile |
-| CLI 登录态 | `codex-switcher logout [profile]` | 登出指定或当前 CLI profile |
-| CLI 登录态 | `codex-switcher exec -- <codex args...>` | 在当前 CLI profile 下执行 codex 命令 |
-| CLI 登录态 | `codex-switcher env [profile]` | 输出指定 profile 的 `CODEX_HOME` |
-| App 控制 | `codex-switcher app open [profile]` | 用指定 profile 启动 App |
-| App 控制 | `codex-switcher app use <profile>` | 切换 App profile（等价于 open） |
-| App 控制 | `codex-switcher app logout [profile]` | 登出 App profile |
-| App 控制 | `codex-switcher app status` | 查看 App 运行状态 |
-| App 控制 | `codex-switcher app stop` | 停止由工具启动的 App 进程 |
-| App 控制 | `codex-switcher app current` | 查看当前 App profile |
-| 系统维护 | `codex-switcher check` | 基础环境与状态检查 |
-| 系统维护 | `codex-switcher doctor [--fix]` | 诊断并可选自动修复 |
-| 系统维护 | `codex-switcher recover [--dry-run]` | 恢复损坏的 current 指针 |
-| 系统维护 | `codex-switcher init [--shell zsh\|bash] [--dry-run]` | 初始化 PATH 与快捷命令 |
-| 系统维护 | `codex-switcher upgrade [--dry-run]` | 升级到最新版本 |
+完整命令说明请查看插件文档：
+
+- 中文：`plugins/codex-switcher/README.md`
+- English：`plugins/codex-switcher/README.en.md`
 
 ## 开发
 

package/docs/macos-manual-checklist.md

@@ -5,19 +5,19 @@ Run this checklist on a macOS machine with Codex.app installed.
 ## Setup
 
 - [ ] `codex-sw check` returns `check: ok`
-- [ ] `codex-sw add work` and `codex-sw add personal` succeed
+- [ ] `codex-sw account add work --env default` and `codex-sw account add personal --env default` succeed
 
 ## CLI isolation
 
-- [ ] `codex-sw use work && codex-sw login`
-- [ ] `codex-sw use personal && codex-sw login`
-- [ ] `codex-sw status` shows both profiles logged in when selected as current
+- [ ] `codex-sw account use work --env default && codex-sw login`
+- [ ] `codex-sw account use personal --env default && codex-sw login`
+- [ ] `codex-sw status` shows both accounts logged in when selected as current env/account
 
 ## App switching
 
 - [ ] `codex-sw app use work` opens App
-- [ ] `codex-sw app current` prints `work`
-- [ ] `codex-sw app use personal` restarts App under `personal`
+- [ ] `codex-sw app current` prints `default/work`
+- [ ] `codex-sw app use personal` restarts App under `default/personal`
 - [ ] `codex-sw app status` reports running when app is open
 - [ ] `codex-sw app stop` stops managed app process
 
@@ -30,5 +30,6 @@ Run this checklist on a macOS machine with Codex.app installed.
 ## Security checks
 
 - [ ] `~/.codex-switcher` permission is `700`
-- [ ] `~/.codex-profiles` permission is `700`
+- [ ] `~/.codex-envs` permission is `700`
+- [ ] `~/.codex-switcher/env-accounts` permission is `700`
 - [ ] no tokens are visible in `~/.codex-switcher/switcher.log`

package/docs/upgrade.md

@@ -23,7 +23,7 @@ codex-sw check
 
 ## Recovery
 
-If pointers are corrupted or profile directories are missing:
+If pointers are corrupted, or env/account data directories are missing:
 
 ```bash
 codex-sw recover

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wangxt0223/codex-switcher",
-  "version": "0.5.1",
-  "description": "Profile-based account switcher for Codex CLI and Codex App using isolated CODEX_HOME directories.",
+  "version": "0.6.0",
+  "description": "Env + account switcher for Codex CLI and Codex App with shared env data and per-account auth.",
   "license": "MIT",
   "author": "wangxt",
   "homepage": "https://github.com/wangxt/codex-switcher",
@@ -13,7 +13,8 @@
     "codex",
     "codex-cli",
     "account-switch",
-    "profile",
+    "env",
+    "account",
     "codex-home"
   ],
   "bin": {

package/plugins/codex-switcher/README.en.md

@@ -2,115 +2,88 @@
 
 [中文](README.md) | English
 
-Profile-based account switcher for Codex CLI and Codex App.
+`codex-switcher` now uses an **env + account** model for Codex CLI / Codex App switching.
 
-## Core idea
+## Core Model
 
-- One profile = one isolated `CODEX_HOME` directory: `~/.codex-profiles/<profile>`
-- CLI commands run under selected CLI profile
-- App is restarted under selected App profile
-- Current pointers are stored in `~/.codex-switcher/current_cli` and `~/.codex-switcher/current_app`
+- Built-in default env: `default`, mapped to `~/.codex` (override via `CODEX_SWITCHER_DEFAULT_HOME`).
+- Custom env data root: `~/.codex-envs/<env>/home` (shared history/sessions/config data).
+- Account auth root: `~/.codex-switcher/env-accounts/<env>/<account>/auth.json`.
+- Switching accounts in the same env only swaps `auth.json`; no sync is needed.
+- Current pointers:
+  - `~/.codex-switcher/current_cli_env`
+  - `~/.codex-switcher/current_cli_account`
+  - `~/.codex-switcher/current_app_env`
+  - `~/.codex-switcher/current_app_account`
 
 ## Commands
 
 ```bash
-codex-switcher add <profile>
-codex-switcher remove <profile> [--force]
+codex-switcher env list
+codex-switcher env create <env> [--empty|--from-default|--from-env <src>]
+codex-switcher env use <env> [--target cli|app|both]
+codex-switcher env remove <env> [--force]
+codex-switcher env current [cli|app]
+codex-switcher env path [env]
+
+codex-switcher account list [--env <env>]
+codex-switcher account add <account> [--env <env>]
+codex-switcher account remove <account> [--env <env>] [--force]
+codex-switcher account login <account> [--env <env>] [--target cli|app|both] [--sync|--no-sync]
+codex-switcher account use <account> [--env <env>] [--target cli|app|both] [--sync|--no-sync]
+codex-switcher account logout [account] [--env <env>] [--target cli|app|both]
+codex-switcher account current [cli|app]
+
 codex-switcher list
-codex-switcher import-default <profile> [--with-auth] [--force]
-codex-switcher use <profile> [--sync|--no-sync] [--launch|--no-launch] [-- <codex args...>]
-codex-switcher switch <profile> [--sync|--no-sync] [--launch|--no-launch] [-- <codex args...>]
-codex-switcher current [cli|app]
 codex-switcher status
-
+codex-switcher current [cli|app]
 codex-switcher exec -- <codex args...>
-codex-switcher login [profile] [--sync|--no-sync]
-codex-switcher logout [profile]
-codex-switcher env [profile]
+codex-switcher login [account] [--sync|--no-sync]
+codex-switcher logout [account]
 
-codex-switcher app open [profile]
-codex-switcher app use <profile>
-codex-switcher app logout [profile]
+codex-switcher app open [account] [-- <app args...>]
+codex-switcher app use <account> [-- <app args...>]
+codex-switcher app logout [account]
 codex-switcher app status
 codex-switcher app stop
-
-codex-switcher init [--shell zsh|bash]
-codex-switcher upgrade [--dry-run]
-codex-switcher recover
-codex-switcher check
-codex-switcher doctor [--fix]
+codex-switcher app current
 ```
 
-## Typical flow
+## Typical Flow
 
 ```bash
-codex-switcher add work
-codex-switcher add personal
-
-codex-switcher use work --sync
-codex-switcher login --sync
-codex-switcher exec -- login status
-
-codex-switcher switch personal --sync
-codex-switcher app use personal
+# 1) Login two accounts under default env (default=~/.codex)
+codex-switcher account login personal --env default
+codex-switcher account login work --env default
+
+# 2) Same-env account switch (auth.json swap only)
+codex-switcher account use personal --env default
+codex-switcher account use work --env default
+
+# 3) Create a dedicated env and switch accounts there
+codex-switcher env create project-a --empty
+codex-switcher account login corp --env project-a
+codex-switcher account use corp --env project-a
 ```
 
-## Migrate Existing App/CLI Data
-
-If your existing data is in `~/.codex`, import it into a profile first:
+## list Output
 
-```bash
-codex-switcher import-default work
-```
+`codex-switcher list` prints:
 
-This copies records/projects/history but excludes `auth.json` by default.
-If you want to carry login state too:
+`ENV / ACCOUNT / EMAIL / PLAN / 5H USAGE / WEEKLY USAGE / LAST ACTIVITY`
 
-```bash
-codex-switcher import-default work --with-auth
-```
+Usage data strategy:
 
-## Sync Behavior
+- API first (`chatgpt.com/backend-api/wham/usage`)
+- Auto fallback to local `sessions/*.jsonl` on API failure
+- `LAST ACTIVITY` appends source marker `(api)` or `(local)`
 
-- `login --sync`: overwrite sync from default `~/.codex` to target profile, excluding `auth.json`.
-- `use/switch --sync`: overwrite sync from current CLI profile to target profile, excluding `auth.json`.
-- `--no-sync`: explicit no-sync mode (default behavior).
-- `use/switch` defaults to `--launch=auto`: in interactive terminals, `codex` starts right after switching.
-- `use/switch --launch`: launch `codex` CLI immediately after switching profile.
-- `use/switch --no-launch`: switch pointer only without launching `codex`.
-- `use/switch -- <codex args...>`: run `codex` with provided args after switch (implies launch).
+## Compatibility Commands
 
-Examples:
-
-```bash
-codex-switcher login work --sync
-codex-switcher switch personal --sync
-codex-switcher use work --no-sync
-```
-
-## Upgrade
-
-```bash
-codex-switcher upgrade
-```
-
-## Notes
-
-- Codex App is single-instance on macOS; switching App profile requires restart.
-- `codex-switcher app stop` only stops app instances started and tracked by `codex-switcher`.
-- `codex-switcher app open/use <profile>` requires that profile already exists and is logged in.
-- `--sync` uses overwrite strategy (not merge): source overwrites target for all files except `auth.json`.
-- `codex-switcher status` exit codes:
-  - `0`: both current profiles logged in
-  - `1`: at least one current profile not logged in
-  - `2`: pointer/profile integrity issue (run `codex-switcher recover`)
+Legacy commands (`add/remove/use/switch/login/logout/import-default`) are kept and mapped to the new model.
 
 ## Validation
 
 ```bash
 ./plugins/codex-switcher/scripts/test-switcher.sh
 ```
-
-## Compatibility command
-
-`codex-sw` is kept as a compatibility entrypoint and maps to the same implementation.

package/plugins/codex-switcher/README.md

@@ -2,115 +2,88 @@
 
 中文 | [English](README.en.md)
 
-为 Codex CLI 与 Codex App 提供基于 profile 的账号切换能力。
+为 Codex CLI 与 Codex App 提供基于 **env + account** 的账号切换能力。
 
 ## 核心设计
 
-- 一个 profile 对应一个独立 `CODEX_HOME`：`~/.codex-profiles/<profile>`
-- CLI 命令在当前 CLI profile 下执行
-- App 在当前 App profile 下重启
-- 当前指针存储在 `~/.codex-switcher/current_cli` 与 `~/.codex-switcher/current_app`
+- 内置默认 env：`default`，对应 `~/.codex`（可由 `CODEX_SWITCHER_DEFAULT_HOME` 覆盖）。
+- 自定义 env 数据目录：`~/.codex-envs/<env>/home`（共享 history/sessions/config 等数据）。
+- 账号凭证目录：`~/.codex-switcher/env-accounts/<env>/<account>/auth.json`（每账号独立 auth）。
+- 同一 env 下切账号只替换 `auth.json`，不做 sync。
+- 当前指针：
+  - `~/.codex-switcher/current_cli_env`
+  - `~/.codex-switcher/current_cli_account`
+  - `~/.codex-switcher/current_app_env`
+  - `~/.codex-switcher/current_app_account`
 
 ## 命令
 
 ```bash
-codex-switcher add <profile>
-codex-switcher remove <profile> [--force]
+codex-switcher env list
+codex-switcher env create <env> [--empty|--from-default|--from-env <src>]
+codex-switcher env use <env> [--target cli|app|both]
+codex-switcher env remove <env> [--force]
+codex-switcher env current [cli|app]
+codex-switcher env path [env]
+
+codex-switcher account list [--env <env>]
+codex-switcher account add <account> [--env <env>]
+codex-switcher account remove <account> [--env <env>] [--force]
+codex-switcher account login <account> [--env <env>] [--target cli|app|both] [--sync|--no-sync]
+codex-switcher account use <account> [--env <env>] [--target cli|app|both] [--sync|--no-sync]
+codex-switcher account logout [account] [--env <env>] [--target cli|app|both]
+codex-switcher account current [cli|app]
+
 codex-switcher list
-codex-switcher import-default <profile> [--with-auth] [--force]
-codex-switcher use <profile> [--sync|--no-sync] [--launch|--no-launch] [-- <codex args...>]
-codex-switcher switch <profile> [--sync|--no-sync] [--launch|--no-launch] [-- <codex args...>]
-codex-switcher current [cli|app]
 codex-switcher status
-
+codex-switcher current [cli|app]
 codex-switcher exec -- <codex args...>
-codex-switcher login [profile] [--sync|--no-sync]
-codex-switcher logout [profile]
-codex-switcher env [profile]
+codex-switcher login [account] [--sync|--no-sync]
+codex-switcher logout [account]
 
-codex-switcher app open [profile]
-codex-switcher app use <profile>
-codex-switcher app logout [profile]
+codex-switcher app open [account] [-- <app args...>]
+codex-switcher app use <account> [-- <app args...>]
+codex-switcher app logout [account]
 codex-switcher app status
 codex-switcher app stop
-
-codex-switcher init [--shell zsh|bash]
-codex-switcher upgrade [--dry-run]
-codex-switcher recover
-codex-switcher check
-codex-switcher doctor [--fix]
+codex-switcher app current
 ```
 
 ## 典型流程
 
 ```bash
-codex-switcher add work
-codex-switcher add personal
-
-codex-switcher use work --sync
-codex-switcher login --sync
-codex-switcher exec -- login status
-
-codex-switcher switch personal --sync
-codex-switcher app use personal
+# 1) 默认 env(default=~/.codex) 下登录两个账号
+codex-switcher account login personal --env default
+codex-switcher account login work --env default
+
+# 2) 同 env 切账号（仅替换 auth.json）
+codex-switcher account use personal --env default
+codex-switcher account use work --env default
+
+# 3) 新建业务 env，并在该 env 下登录/切换账号
+codex-switcher env create project-a --empty
+codex-switcher account login corp --env project-a
+codex-switcher account use corp --env project-a
 ```
 
-## 迁移已有数据
+## list 输出
 
-如果你原本在 `~/.codex` 下使用 Codex，可先导入到某个 profile：
+`codex-switcher list` 默认输出：
 
-```bash
-codex-switcher import-default work
-```
-
-默认会迁移记录/项目等数据，但不包含 `auth.json`。
-如需连登录态一起导入：
-
-```bash
-codex-switcher import-default work --with-auth
-```
+`ENV / ACCOUNT / EMAIL / PLAN / 5H USAGE / WEEKLY USAGE / LAST ACTIVITY`
 
-## 同步行为
+其中用量数据策略为：
 
-- `login --sync`：从默认 `~/.codex` 覆盖同步到目标 profile，排除 `auth.json`。
-- `use/switch --sync`：从当前 CLI profile 覆盖同步到目标 profile，排除 `auth.json`。
-- `--no-sync`：显式关闭同步（默认行为）。
-- `use/switch` 默认 `--launch=auto`：交互终端中切换后自动启动 `codex` CLI。
-- `use/switch --launch`：切换后立即以目标 profile 启动 `codex` CLI。
-- `use/switch --no-launch`：切换后只更新 profile 指针，不启动 `codex` CLI。
-- `use/switch -- <codex args...>`：切换后执行指定 `codex` 参数（等价于隐式 `--launch`）。
+- 默认优先 API（`chatgpt.com/backend-api/wham/usage`）
+- API 失败自动回退本地 `sessions/*.jsonl`
+- `LAST ACTIVITY` 列会追加 `(api)` 或 `(local)` 标记来源
 
-示例：
-
-```bash
-codex-switcher login work --sync
-codex-switcher switch personal --sync
-codex-switcher use work --no-sync
-```
-
-## 升级
-
-```bash
-codex-switcher upgrade
-```
-
-## 说明
+## 兼容命令
 
-- macOS 下 Codex App 是单实例；切换 App profile 需要重启。
-- `codex-switcher app stop` 仅停止由 `codex-switcher` 启动并跟踪的 App 进程。
-- `codex-switcher app open/use <profile>` 要求该 profile 已存在且已登录。
-- `--sync` 为覆盖策略（不是合并）：源目录覆盖目标目录，`auth.json` 除外。
-- `codex-switcher status` 返回码：
-  - `0`：当前 CLI/App profile 均已登录
-  - `1`：至少一个当前 profile 未登录
-  - `2`：指针或 profile 完整性异常（可执行 `codex-switcher recover`）
+`add/remove/use/switch/login/logout/import-default` 仍保留兼容入口，内部映射到新模型。
 
 ## 验证
 
 ```bash
 ./plugins/codex-switcher/scripts/test-switcher.sh
 ```
-
-## 兼容命令
-
-`codex-sw` 作为兼容入口保留，行为与 `codex-switcher` 一致。