@minniexcode/codex-switch 0.1.0 → 0.1.2

package/docs/codex-switch-command-design.md

@@ -1,14 +1,14 @@
 # codex-switch 命令设计说明
 
 > 状态说明：这份文档是历史跨版本参考，不是当前 release contract。
-> 当前事实源请改看 [`docs/cli-usage.md`](./cli-usage.md)、[`docs/PRD/codex-switch-prd-v0.1.0.md`](./PRD/codex-switch-prd-v0.1.0.md)、[`docs/Design/codex-switch-v0.1.0-design.md`](./Design/codex-switch-v0.1.0-design.md)。
+> 当前事实源请改看 [`docs/cli-usage.md`](./cli-usage.md)、[`docs/PRD/codex-switch-prd-v0.1.1.md`](./PRD/codex-switch-prd-v0.1.1.md)、[`docs/Design/codex-switch-v0.1.1-design.md`](./Design/codex-switch-v0.1.1-design.md)。
 
 ## 文档信息
 
 - 文档类型：命令设计文档
 - 适用范围：`codex-switch` MVP
 - 关联文档：
-  - [`PRD/codex-switch-prd.md`](./PRD/codex-switch-prd.md)
+  - [`PRD/codex-switch-prd-v0.1.0.md`](./PRD/codex-switch-prd-v0.1.0.md)
   - [`codex-switch-technical-architecture.md`](./codex-switch-technical-architecture.md)
 
 ## 1. 文档目标

package/docs/codex-switch-product-overview.md

@@ -4,15 +4,17 @@
 
 这份文档介绍当前活跃产品事实源下的 `codex-switch` 产品定位。
 
-当前 release contract 以这些文档为准：
+当前稳定 release contract 以这些文档为准：
 
-- [`cli-usage.md`](./cli-usage.md)
-- [`PRD/codex-switch-prd-v0.1.0.md`](./PRD/codex-switch-prd-v0.1.0.md)
-- [`Design/codex-switch-v0.1.0-design.md`](./Design/codex-switch-v0.1.0-design.md)
+- [`cli-usage.md`](./cli-usage.md)
+- [`PRD/codex-switch-prd-v0.1.0.md`](./PRD/codex-switch-prd-v0.1.0.md)
+- [`PRD/codex-switch-prd-v0.1.1.md`](./PRD/codex-switch-prd-v0.1.1.md)
+- [`PRD/codex-switch-prd-v0.1.2.md`](./PRD/codex-switch-prd-v0.1.2.md)（规划中）
+- [`Design/codex-switch-v0.1.2-design.md`](./Design/codex-switch-v0.1.2-design.md)（规划中）
 
 ## 产品概述
 
-`codex-switch` 是一个本地 provider 管理 CLI，用于管理和切换目标 Codex runtime 的 provider/profile 配置，同时把工具自己的管理态保存在独立 tool home 下。
+`codex-switch` 是一个本地 provider 管理 CLI，用于管理和切换目标 Codex runtime 的 provider/model-provider 路由配置，同时把工具自己的管理态保存在独立 tool home 下。
 
 它不是旧 `setup` 小工具，也不是围绕单目录 `~/.codex` 组织全部状态的脚本集合。
 
@@ -48,11 +50,11 @@ target Codex runtime：
 
 ## 核心使用流程
 
-Direct 主路径：
+Direct 主路径：
 
 ```bash
 codexs init
-codexs add <provider> --profile <name> --api-key <key>
+codexs add <provider> --model <model> --api-key <key> [--base-url <url>]
 codexs switch <provider>
 codexs status
 codexs doctor
@@ -63,7 +65,7 @@ Copilot 主路径：
 ```bash
 codexs init
 codexs login copilot
-codexs add <provider> --copilot --profile <name>
+codexs add <provider> --copilot --model <model>
 codexs switch <provider>
 codexs status
 codexs doctor
@@ -78,9 +80,12 @@ codexs migrate
 
 ## 当前产品判断
 
-`0.1.0` 的重点不是再加新命令，而是让用户在 README、help 和输出第一屏就能理解：
+`0.1.1` 的重点不是再加新命令，而是让用户在 README、help 和输出第一屏就能理解：
 
-- fresh install 应先走什么
-- Copilot 路径和 direct 路径有什么区别
-- `migrate` 何时才该使用
-- `status` / `doctor` 如何帮助定位下一步
+- fresh install 应先走什么
+- Copilot 路径和 direct 路径有什么区别
+- `migrate` 何时才该使用
+- `status` / `doctor` 如何帮助定位下一步
+- 当前运行态是用顶层 `model` 与 `model_provider` 选择活动路由
+
+`0.1.2` 是规划中的 Copilot runtime 修复线，不是当前已发布包版本。当前实现边界是：Copilot 路径要求 Node.js `>=20`，受管安装默认固定到 `@github/copilot-sdk@1.0.2`，运行时会额外拒绝过旧版本和 prerelease 版本，并在真正创建 client 或 session 时验证 SDK API shape；本地 bridge 仍然只是面向 simple text-oriented turns 的 experimental bridge。Direct provider 路径继续支持 Node.js `>=18`。

package/docs/codex-switch-product-research.md

@@ -2,7 +2,7 @@
 
 ## 背景与当前结论
 
-这份文档的定位不是正式 PRD，而是 `codex-switch` 的前置分析稿。它用于整合当前对参考项目、产品边界和技术方向的判断，并为后续单独编写 `PRD/codex-switch-prd.md` 提供输入。
+这份文档的定位不是正式 PRD，而是 `codex-switch` 的前置分析稿。它用于整合当前对参考项目、产品边界和技术方向的判断，并为后续单独编写 `PRD/codex-switch-prd-v0.1.0.md` 提供输入。
 
 当前已经相对明确、可以先锁定的基础结论如下：
 
@@ -317,7 +317,7 @@ Rust / Zig 不是不能做，而是当前收益不足。只有在下面这些诉
 
 ## 后续 PRD 输入项
 
-以下内容应留给后续单独的 `PRD/codex-switch-prd.md` 详细展开，这次只列为输入清单，不在本稿中定死：
+以下内容应留给后续单独的 `PRD/codex-switch-prd-v0.1.0.md` 详细展开，这次只列为输入清单，不在本稿中定死：
 
 - 目标用户和典型场景
   - 例如个人多 provider 用户、需要让 AI 执行切换命令的开发者、需要本地安全回滚的用户