@researai/deepscientist 1.5.15 → 1.5.16

package/docs/zh/00_QUICK_START.md

@@ -13,7 +13,7 @@
 
 本文中的截图直接使用当前在线页面 `deepscientist.cc:20999` 作为示例。你本地运行后的页面 `127.0.0.1:20999` 通常会与它保持一致或非常接近。
 
-当前平台支持：DeepScientist 目前完整支持 Linux 和 macOS。原生 Windows 支持目前仍处于实验阶段；如果你希望获得最接近 Linux 的终端行为，仍然建议优先使用 WSL2。
+当前平台支持：DeepScientist 目前完整支持 Linux 和 macOS。原生 Windows 支持目前仍处于实验阶段（强烈建议优先使用 WSL2，尤其是在你希望获得最接近 Linux 的终端行为时）。
 
 ## 安全建议：先隔离，再启动
 
@@ -60,7 +60,7 @@
 
 ## 1. 先安装 Node.js，再安装 DeepScientist
 
-DeepScientist 目前完整支持 Linux 和 macOS。原生 Windows 支持目前仍处于实验阶段；如果你希望获得更接近 Linux 的 shell 行为，仍然建议优先使用 WSL2。
+DeepScientist 目前完整支持 Linux 和 macOS。原生 Windows 支持目前仍处于实验阶段（强烈建议优先使用 WSL2，尤其是在你希望获得更稳定、更接近 Linux 的 shell 行为时）。
 
 在安装 DeepScientist 本身之前，请先从 Node.js 官方页面安装 Node.js：
 
@@ -85,6 +85,15 @@ DeepScientist 依赖一个可用的 Codex CLI。它会优先使用你机器上
 npm install -g @openai/codex
 ```
 
+最稳妥的做法是立刻验证命令是否真的可用：
+
+```bash
+which codex
+codex --login
+```
+
+如果 `which codex` 没有输出，问题通常不是 DeepScientist 本身，而是 npm 全局 bin 目录没有正确进入 shell 的 PATH。先修复 PATH，再重新执行 `npm install -g @openai/codex`。
+
 如果你后面还要在本地编译论文 PDF，可以再运行：
 
 ```bash
@@ -148,18 +157,21 @@ ds --codex /absolute/path/to/codex --codex-profile m27
 
 这里的 `m27` 是本仓库统一使用的 MiniMax profile 示例名。MiniMax 官方页面当前示例名是 `m21`，但 profile 名只是本地别名；如果你自己用了别的名字，就把命令里的名字一起改掉。
 
-DeepScientist 会在启动前强制做一次真实的 Codex hello 探测。默认情况下，`~/DeepScientist/config/runners.yaml` 里的 runner 模型还是 `gpt-5.4`。如果你的 profile 希望模型由 profile 自己决定，请把 `runners.yaml` 里的 `model` 改成 `inherit`；或者直接使用 `--codex-profile <name>`，让这一轮启动自动继承 profile 对应的模型。
+DeepScientist 会在启动前强制做一次真实的 Codex hello 探测。当前 `~/DeepScientist/config/runners.yaml` 里的默认 runner 模型已经是 `inherit`。如果你的旧配置里还固定写着某个显式模型，而你的 provider 又希望模型由 profile 自己决定，请把 `model` 改成 `inherit`；或者直接使用 `--codex-profile <name>`，让这一轮启动自动继承 profile 对应的模型。
 
 MiniMax 额外说明：
 
 - 如果当前最新版 `@openai/codex` 和 MiniMax 走不通，直接安装 `npm install -g @openai/codex@0.57.0`
+- 如果 DeepScientist 在启动时检测到 MiniMax profile，但当前 Codex CLI 不是 `0.57.0`，现在会在交互式终端里主动提示是否自动安装 `0.57.0`
 - 先创建 MiniMax `Coding Plan Key`
-- 在当前 shell 里先执行 `unset OPENAI_API_KEY` 和 `unset OPENAI_BASE_URL`
+- 如果你要单独在终端里验证 `codex --profile <name>`，先在当前 shell 里执行 `unset OPENAI_API_KEY` 和 `unset OPENAI_BASE_URL`
 - 使用 `https://api.minimaxi.com/v1`
 - MiniMax 官方 Codex CLI 页面当前给出的 `codex-MiniMax-*` 模型名，在本地用提供的 key 实测并不能稳定通过 Codex CLI
-- 当前本地实测可用的模型名是 `MiniMax-M2.7`
+- 当前本地实测可用于 DeepScientist 的模型名是 `MiniMax-M2.7` 和 `MiniMax-M2.5`
+- 如果你要走 `m25`，请使用 `MiniMax-M2.5`，不要写成 `codex-MiniMax-M2.5`
 - DeepScientist 现在可以在 probe 和运行时自动适配 MiniMax profile-only 的 `model_provider` / `model` 配置形态
-- 如果你还希望终端里的 `codex --profile <name>` 也直接可用，再在 `~/.codex/config.toml` 顶层补上 `model_provider = "minimax"` 和 `model = "MiniMax-M2.7"`
+- 当 provider 设置了 `requires_openai_auth = false` 时，DeepScientist 也会自动移除冲突的 `OPENAI_*` 认证环境变量
+- 如果你还希望终端里的 `codex --profile <name>` 也直接可用，再在 `~/.codex/config.toml` 顶层补上 `model_provider = "minimax"`，以及对应的顶层 `model`，例如 `MiniMax-M2.7` 或 `MiniMax-M2.5`
 - 当 DeepScientist 检测到旧版 Codex CLI 不支持 `xhigh` 时，会自动把它降级成 `high`
 
 ## 3. 启动本地运行时
@@ -200,13 +212,14 @@ ds --port 21000
 
 这会把网页界面放到 `21000` 端口。
 
-默认情况下，本地网页地址是：
+默认情况下，DeepScientist 启动时不会开启本地浏览器密码门禁。
 
-```text
-http://127.0.0.1:20999
-```
-
-如果浏览器没有自动打开，就手动访问这个地址。
+- 如果浏览器没有自动打开，就手动访问普通本地地址，例如 `http://127.0.0.1:20999`
+- 如果你想在某次启动里启用本地浏览器密码，可以用 `ds --auth true`
+- 在启用密码模式的启动中，终端会直接打印这次启动生成的密码
+- 如果当前浏览器还没有登录，本地首页会先弹出密码框，再继续显示后续界面
+- 第一次成功进入后，浏览器会保存这次本地登录，之后再次访问通常不需要重复输入
+- 如果你之后忘了某次启用密码启动的密码，可以回到启动终端查看，或者执行 `ds --status`
 
 ## 4. 打开首页
 
@@ -220,10 +233,18 @@ http://127.0.0.1:20999
 
 你最先会看到两个入口：
 
-- `Start Research`：创建一个新项目，并立刻开始新的研究任务
+- `Start Research` 或 `Start Experiment`：进入新项目创建流程
 - `Open Project`：重新打开已有项目
 
-第一次使用时，先点击 `Start Research`。
+第一次使用时，先点击 `Start Research` 或 `Start Experiment`。
+
+这里有一个重要变化：
+
+- 现在系统会先让你选择启动方式
+- `Copilot`：先创建一个安静待命的项目，等你发第一条明确指令
+- `Autonomous`：标准版 DeepScientist，创建后直接开始推进
+
+如果你还不确定该选哪一个，先看 [20 工作区模式指南](./20_WORKSPACE_MODES_GUIDE.md)。
 
 ## 5. 用一个真实示例创建第一个项目
 
@@ -236,7 +257,7 @@ http://127.0.0.1:20999
 - 研究在混合正确 / 错误社会信号下，如何实现更强的 truth-preserving collaboration
 - 使用两个本地推理端点提高吞吐量
 
-点击 `Start Research`，打开启动弹窗。
+点击 `Start Research` / `Start Experiment`，然后选择 `Autonomous Mode`，再进入下面这条标准创建流程。
 
 ![Start Research 弹窗](../images/quickstart/01-start-research.png)
 

package/docs/zh/01_SETTINGS_REFERENCE.md

@@ -52,6 +52,7 @@ daemon:
 ui:
   host: 0.0.0.0
   port: 20999
+  auth_enabled: false
   auto_open_browser: true
   default_mode: both
 logging:
@@ -172,6 +173,17 @@ acp:
 - 作用：本地 UI 服务监听端口。
 - 何时修改：端口冲突时。
 
+**`ui.auth_enabled`**
+
+- 类型：`boolean`
+- 默认值：`false`
+- 页面标签：`Require local password`
+- 作用：为 Web 工作区和所有 `/api/*` 路由启用本地 16 位浏览器访问密码。
+- 行为：
+  - `true`：`ds` 会在终端打印这次启动生成的密码；如果浏览器里没有有效登录态，就必须先输入密码；登录成功后会在浏览器中持久化。
+  - `false`：关闭本地密码门禁，保持普通本地地址直连行为。
+- CLI 覆盖：`ds --auth true` 或 `ds --auth false`
+
 **`ui.auto_open_browser`**
 
 - 类型：`boolean`
@@ -274,6 +286,7 @@ acp:
 - 默认值：`true`
 - 页面标签：`Sync project skills on create`
 - 作用：创建项目时，把技能镜像到项目本地 `.codex/skills` / `.claude/agents`。
+- Prompt 说明：同时会初始化 quest 本地的受管 prompt 镜像 `.codex/prompts/`。
 
 **`skills.sync_quest_on_open`**
 
@@ -281,6 +294,26 @@ acp:
 - 默认值：`true`
 - 页面标签：`Sync project skills on open`
 - 作用：打开已有项目时刷新本地技能镜像。
+- Prompt 说明：会刷新当前 DeepScientist home 下已发现 quest 的本地技能与 prompt 镜像。
+
+受管 prompt 行为：
+
+- `.codex/prompts/` 现在应被视为“当前 active prompt 树”的受管副本，而不是长期手工维护的 override。
+- 每次真实 runner turn 开始前，DeepScientist 都会把 quest 本地 active prompt 树和仓库当前 `src/prompts/` 做比较，并自动修复漂移。
+- 如果 active prompt 树与仓库源不同，系统会先把旧树备份到 `.codex/prompt_versions/<backup_id>/`，再写入新的 active 副本。
+- 这个运行前同步是针对“本次 turn 实际使用的 quest_root”执行的，所以即使 quest 不在默认 `home/quests` 下面，也仍然会更新。
+- 运行时覆盖：`ds daemon --prompt-version latest` 使用当前受管 active prompt；`ds daemon --prompt-version <official_version>` 会优先选择该正式版本号下最新的一份 prompt 备份。
+- 如果你不是想用“这个正式版本下最新的一份”，而是想精确回放某一次备份，也仍然可以直接传 `.codex/prompt_versions/` 里的精确目录名。
+- 同样的覆盖也支持一次性 CLI run：`ds run --prompt-version <official_version> ...`。
+
+受管 auto-continue 行为：
+
+- `workspace_mode = copilot`
+  - 完成当前请求单元后，DeepScientist 通常停驻，等待下一条用户消息或 `/resume`
+- `workspace_mode = autonomous`
+  - 如果真实外部长任务还没跑起来，就继续用后续 turns 做准备、启动或耐久路由
+  - 一旦真实外部长任务已经在跑，auto-continue 就切成低频巡检，默认大约每 `240` 秒一轮
+- auto-continue prompt 现在还会带上一个紧凑的 resume spine：最近用户消息、最近 assistant checkpoint、最近 run 摘要、少量 memory cues，以及当前 `bash_exec` 状态
 
 ### Connector policy
 

package/docs/zh/02_START_RESEARCH_GUIDE.md

@@ -326,9 +326,16 @@ type StartResearchContractFields = {
 
 - `autonomous`
   - 普通路线由 agent 自行决定
+  - 一轮结束后默认继续：如果真实长时间外部任务还没跑起来，就继续准备或启动；一旦真实长任务已经在跑，后台监控应切成低频，而不是亚分钟轮询
 - `user_gated`
   - 只有真正依赖用户偏好时，才允许阻塞式决策请求
 
+关于 workspace mode 的实际含义：
+
+- DeepScientist 还会区分用户导向的 `copilot` 模式和默认的 `autonomous` 模式。
+- 在 `copilot` 下，当前请求单元完成后通常应该停驻，等待下一条用户消息或 `/resume`。
+- 在 `autonomous` 下，不能因为“当前还没有长任务在跑”就停住；系统应继续推进，直到下一个真实长任务被准备好或启动起来。
+
 ### 启动模式
 
 **`launch_mode`**

package/docs/zh/05_TUI_GUIDE.md

@@ -58,6 +58,7 @@ ds --stop
 含义：
 
 - `ds`：启动 daemon，打印本地 Web 地址，尝试打开浏览器，然后退出。
+  如果你是用 `ds --auth true` 启动，DeepScientist 也会同时打印这次启动生成的本地浏览器密码。
 - `ds --tui`：启动 daemon，并进入终端工作区。
 - `ds --both`：同时开 Web 和 TUI。
 - `ds --status`：查看 daemon 状态。
@@ -71,6 +72,11 @@ ds --stop
 - 当前本地 Web 地址
 - 当前有哪些 quest 可以切换
 
+如果本地浏览器密码模式是开启的，那么终端里打印出来的 Web 地址就是你应该优先使用的地址。
+
+- 第一次优先打开终端里打印的完整 URL
+- 当 TUI 已经拿到本地密码 token 时，`Ctrl+O` 重新打开 Web 也会带上同一个 token
+
 如果欢迎区显示的是 `request mode`，说明你还没有绑定 quest。
 
 这时正确动作不是直接输入普通文本，而是先做下面两件事之一：

package/docs/zh/09_DOCTOR.md

@@ -116,13 +116,16 @@ ds --codex /absolute/path/to/codex --codex-profile m27
 MiniMax 补充说明：
 
 - 如果 MiniMax 在当前最新版 `@openai/codex` 上失败，直接安装 `npm install -g @openai/codex@0.57.0`
+- 如果 DeepScientist 在启动时检测到 MiniMax profile，但当前 Codex CLI 不是 `0.57.0`，现在会在交互式终端里主动提示是否自动安装 `0.57.0`
 - 先创建 MiniMax `Coding Plan Key`
-- 在当前 shell 里先执行 `unset OPENAI_API_KEY` 和 `unset OPENAI_BASE_URL`
+- 如果你要单独在终端里验证 `codex --profile <name>`，先在当前 shell 里执行 `unset OPENAI_API_KEY` 和 `unset OPENAI_BASE_URL`
 - 使用 `https://api.minimaxi.com/v1`
 - MiniMax 官方 Codex CLI 页面当前给出的 `codex-MiniMax-*` 模型名，在本地用提供的 key 实测并不能稳定通过 Codex CLI
-- 当前本地实测可用的模型名是 `MiniMax-M2.7`
+- 当前本地实测可用于 DeepScientist 的模型名是 `MiniMax-M2.7` 和 `MiniMax-M2.5`
+- 如果你要走 `m25`，请使用 `MiniMax-M2.5`，不要写成 `codex-MiniMax-M2.5`
 - DeepScientist 现在可以在 probe 和运行时自动适配 MiniMax profile-only 的 `model_provider` / `model` 配置形态
-- 如果你还希望终端里的 `codex --profile <name>` 也直接可用，再在 `~/.codex/config.toml` 顶层补上 `model_provider = "minimax"` 和 `model = "MiniMax-M2.7"`
+- 当 provider 设置了 `requires_openai_auth = false` 时，DeepScientist 也会自动移除冲突的 `OPENAI_*` 认证环境变量
+- 如果你还希望终端里的 `codex --profile <name>` 也直接可用，再在 `~/.codex/config.toml` 顶层补上 `model_provider = "minimax"`，以及对应的顶层 `model`，例如 `MiniMax-M2.7` 或 `MiniMax-M2.5`
 - 当 DeepScientist 检测到 Codex CLI 版本低于 `0.63.0` 时，会自动把 `xhigh` 降级成 `high`
 
 ### 当前配置的 Codex 模型不可用
@@ -149,7 +152,7 @@ ds doctor
 curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
 
-如果你在 Windows PowerShell：
+如果你在 Windows PowerShell（但日常使用 DeepScientist 仍然强烈建议优先使用 WSL2）：
 
 ```powershell
 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
@@ -233,4 +236,7 @@ git config --global user.email "you@example.com"
 ## 说明
 
 - `ds docker` 保留为兼容别名，但正式命令是 `ds doctor`。
-- 默认浏览器访问地址是 `http://127.0.0.1:20999`。
+- 默认情况下，浏览器访问地址保持普通本地形式，例如 `http://127.0.0.1:20999`。
+- 如果启用了本地浏览器密码模式，首页会先弹出密码框，再继续进入工作区。
+- 你可以回到启动终端查看当前密码，或者执行 `ds --status`。
+- 默认情况下不会出现密码弹窗；如果你想在某次启动中启用本地浏览器密码模式，可以使用 `ds --auth true`。

package/docs/zh/14_PROMPT_SKILLS_AND_MCP_GUIDE.md

@@ -56,6 +56,14 @@ DeepScientist 不是靠一份静态大 prompt 工作的。
 - `SKILL.md`：定义各个阶段的执行纪律
 - `mcp/server.py`：定义内建工具面
 
+受管 quest-local prompt 镜像：
+
+- DeepScientist 仍然会优先读取 `quest_root/.codex/prompts/` 下存在的 prompt 片段。
+- 但这棵树现在是“自动维护的受管副本”，不再默认视为永久手工 fork。
+- 每次真实 runner turn 开始前，DeepScientist 都会把当前 active quest-local prompt 树与仓库 `src/prompts/` 做比较；只要仓库源变了，或者 quest 本地副本漂移了，就会刷新 active 副本。
+- 刷新之前，旧的 active prompt 树会先备份到 `quest_root/.codex/prompt_versions/<backup_id>/`。
+- 所以默认情况下，旧 quest 也会吃到最新 prompt 合同；如果你需要回放历史 prompt，再显式选择某个备份版本。
+
 ## 3. 一轮 prompt 是怎么组装的
 
 当前运行时大致按下面顺序组装 turn prompt：
@@ -72,11 +80,12 @@ DeepScientist 不是靠一份静态大 prompt 工作的。
 10. research delivery policy
 11. paper and evidence snapshot
 12. 如果是 retry turn，则加入 retry recovery packet
-13. interaction style
-14. priority memory for this turn
-15. recent conversation window
-16. current turn attachments
-17. current user message
+13. 如果是 auto-continue turn，则加入 resume context spine
+14. interaction style
+15. priority memory for this turn
+16. recent conversation window
+17. current turn attachments
+18. current user message
 
 这个顺序不是随便排的。
 
@@ -210,6 +219,16 @@ builder 会直接把这些 quest 文件读进 prompt：
 - `src/deepscientist/prompts/builder.py`
 - 当前 quest 所处的 stage skill
 
+它现在还明确承载了 continuation 的模式分叉：
+
+- `workspace_mode = copilot`
+  - 以当前请求为单位提供帮助
+  - 做完这一小段之后，通常停驻，等待下一条用户消息或 `/resume`
+- `workspace_mode = autonomous`
+  - 默认继续往前推进
+  - 如果真实长任务还没跑起来，就继续用接下来的 turns 做准备、启动或耐久决策
+  - 一旦真实长任务已经在跑，后台 auto-continue 就切成低频巡检
+
 ### 4.8 Interaction style
 
 这个 block 决定这轮该怎么“说话”。
@@ -229,7 +248,27 @@ builder 会直接把这些 quest 文件读进 prompt：
 - 写作阶段
 - 等待用户决策的阶段
 
-### 4.9 Priority memory
+它现在也编码了 auto-continue 的节奏分叉：
+
+- autonomous 下，如果还在准备 / 启动真实长任务，可以较快地连续推进
+- 如果真实外部长任务已经在跑，则默认切成低频检查，默认大约每 `240` 秒一轮
+- copilot 模式则通常在当前请求单元完成后停驻，不继续自动扩展
+
+### 4.9 Resume context spine
+
+现在在 auto-continue turn 中，prompt 会额外注入一个紧凑的 resume spine，避免模型只凭一个 stage 名称硬续。
+
+里面包括：
+
+- 最近一条持久化用户消息
+- 最近一条 assistant checkpoint
+- 最近一条 run result 摘要
+- 少量最近 memory cues
+- 当前 `bash_exec` 状态，包括是否有长时间 shell 会话正在运行
+
+这也是为什么 auto-continue 能更贴着“最新用户意图 + 最新检查点”继续，而不是漂回泛泛的 stage narration。
+
+### 4.10 Priority memory
 
 DeepScientist 不是随机往 prompt 里塞 memory 的。
 
@@ -246,22 +285,33 @@ DeepScientist 不是随机往 prompt 里塞 memory 的。
 
 agent 不应该在每一轮都看到完全同一批 memory。
 
-## 5. 哪些 prompt 可以本地覆盖
+## 5. 本地 active prompt 与历史版本
 
-当前支持按 quest 在下面路径覆盖 prompt 片段：
+当前 quest 的 active prompt 树仍在这些路径下：
 
 - `.codex/prompts/system.md`
 - `.codex/prompts/contracts/shared_interaction.md`
 - `.codex/prompts/connectors/<connector>.md`
 
-也就是说：
+仓库默认 prompt 仍然在 `src/prompts/`。
+
+但现在有一个关键变化：
+
+- `.codex/prompts/` 不应再理解为长期手工维护的 override 树。
+- 每次真实运行前，DeepScientist 都会把 active quest-local copy 修回当前仓库 prompt 真相。
+- 所以如果你手工改了 active copy，这种改动会在下次运行时被视为漂移：先备份，再替换。
+- 历史 prompt 会保存在 `.codex/prompt_versions/<backup_id>/`。
+
+如果你确实想让某个 quest 临时按旧 prompt 跑，启动时优先传正式版本号即可：
+
+- `ds daemon --prompt-version <official_version>`
+- `ds run --prompt-version <official_version> ...`
 
-- 仓库默认 prompt 在 `src/prompts/`
-- quest 私有覆盖在 `.codex/prompts/`
+DeepScientist 会把它解析成“该正式版本号下最新的一份 prompt 备份”。如果你想精确回放某一次具体备份，而不是该版本下最新的一份，也仍然可以直接传备份目录名。
 
-只有当某个 quest 确实需要局部特殊合同，才建议这样覆盖。
+如果只是想继续使用当前受管 active prompt，就用 `latest`。
 
-如果这个改动应该影响整个产品，就不该做 quest-local override，而应该直接改仓库默认 prompt。
+如果这个改动应该影响正常未来行为，就不该只改 quest-local active copy，而应该直接改仓库默认 prompt。
 
 ## 6. Skills 是怎么分层的
 

package/docs/zh/15_CODEX_PROVIDER_SETUP.md

@@ -62,7 +62,7 @@ codex:
 
 - 对 provider-backed 的 Codex profile，建议优先使用 `model: inherit`
 - 除非你非常确定该 provider 接受你要显式传入的模型名，否则不要再额外硬写一个模型
-- DeepScientist 会复用你终端里同一个 `~/.codex/config.toml` 与环境变量
+- DeepScientist 现在会在 `.ds/codex-home` 下启动一个隔离的运行时 home，但会先继承你配置的 `~/.codex` 里的 auth、config、skills、agents 与 prompts
 
 ## Provider 一览
 
@@ -109,13 +109,13 @@ MiniMax 是最典型的 profile 模式。它的官方 Codex CLI 文档直接给
 
 ### 已验证的兼容性说明
 
-按 2026-03-25 对 MiniMax 官方 Codex CLI 页面和本地兼容性测试的核对结果：
+按 2026-04-04 对 MiniMax 官方 Codex CLI 页面和本地兼容性测试的核对结果：
 
 - MiniMax 官方 Codex CLI 页面当前建议使用 `@openai/codex@0.57.0`
 - MiniMax 当前应使用的 Coding Plan endpoint 是 `https://api.minimaxi.com/v1`
 - MiniMax 官方页面示例 profile 名是 `m21`，但 profile 名本身只是本地别名；本仓库统一用 `m27` 作为示例名
 - MiniMax 官方页面当前给出的 `codex-MiniMax-*` 模型名，在本地使用你提供的 key 实测并不能稳定通过 Codex CLI
-- 本地实测能稳定跑通的组合是 `MiniMax-M2.7` + `m27` + `model: inherit` + Codex CLI `0.57.0`
+- 本地实测 DeepScientist 可稳定跑通的组合包括 `MiniMax-M2.7` + `m27` + Codex CLI `0.57.0`，以及 `MiniMax-M2.5` + `m25` + Codex CLI `0.57.0`
 - 当前最新版 `@openai/codex` 和 MiniMax 官方文档并不能稳定直接对齐
 
 如果你现在要走最稳的 DeepScientist + MiniMax 路径，建议直接使用 Codex CLI `0.57.0`。
@@ -125,7 +125,7 @@ MiniMax 是最典型的 profile 模式。它的官方 Codex CLI 文档直接给
 - 已安装 Codex CLI `0.57.0`
 - 已创建 MiniMax `Coding Plan Key`
 - 在启动 Codex 和 DeepScientist 的 shell 中可见的 `MINIMAX_API_KEY`
-- 当前 shell 已清理 `OPENAI_API_KEY` 和 `OPENAI_BASE_URL`
+- 如果你要单独在终端里验证 `codex --profile <name>`，当前 shell 需要先清理 `OPENAI_API_KEY` 和 `OPENAI_BASE_URL`
 - `~/.codex/config.toml` 中已经配置好的 Codex profile
 
 ### 安装 Codex CLI `0.57.0`
@@ -145,6 +145,8 @@ codex-cli 0.57.0
 
 如果你还想保留另一个 Codex 版本，也可以单独写一个 wrapper 脚本，再把 `runners.codex.binary` 指向那个绝对路径。
 
+现在如果 DeepScientist 在启动时检测到 MiniMax profile，但当前 `codex` 版本不是 `0.57.0`，在交互式终端里会主动提示是否自动安装 `@openai/codex@0.57.0`。
+
 ### Codex 侧配置
 
 请使用 `https://api.minimaxi.com/v1`，不要用 `https://api.minimax.io/v1`。
@@ -157,15 +159,19 @@ unset OPENAI_BASE_URL
 export MINIMAX_API_KEY="..."
 ```
 
+如果你是在终端里单独验证 `codex --profile <name>`，就按上面的方式处理。
+如果你走的是 DeepScientist 路径，那么当所选 provider 明确写了 `requires_openai_auth = false` 时，DeepScientist 现在会在 startup probe 和真实 runner 执行时自动剥离 `OPENAI_API_KEY` 和 `OPENAI_BASE_URL`。
+
 MiniMax 官方页面示例 profile 名是 `m21`。由于 profile 名只是本地别名，本仓库统一改写成 `m27`。
 
 先说明差异：
 
 - 官方页面当前展示的是 `codex-MiniMax-M2.5`
-- 但本地实测里，直接请求 MiniMax API 能稳定跑通的是 `MiniMax-M2.7`
-- 同一把 key 下，`codex-MiniMax-M2.5` / `codex-MiniMax-M2.7` 通过 Codex CLI 都会失败
+- 但本地实测里，直接请求 MiniMax API 能稳定跑通的是 `MiniMax-M2.7` 和 `MiniMax-M2.5`
+- 可复现的 DeepScientist 路径是：`MiniMax-M2.7` 配 `m27`，以及 `MiniMax-M2.5` 配 `m25`
+- 对 `m25` 这条路径，请使用 `MiniMax-M2.5`，不要写成 `codex-MiniMax-M2.5`
 
-因此，下面给的是当前 DeepScientist 推荐的可运行配置：
+因此，下面给的是当前 DeepScientist 推荐配置：
 
 ```toml
 [model_providers.minimax]
@@ -183,9 +189,19 @@ model = "MiniMax-M2.7"
 model_provider = "minimax"
 ```
 
+如果你想走同样的 DeepScientist 路径但使用 `m25`，保持上面的 provider 配置不变，再把 profile 写成：
+
+```toml
+[profiles.m25]
+model = "MiniMax-M2.5"
+model_provider = "minimax"
+```
+
 DeepScientist 现在对它的支持方式是：
 
-- 如果你使用的是这类 profile-only MiniMax 配置，再配合 Codex CLI `0.57.0`，DeepScientist 会在自己的 probe / 运行时临时 `.codex/config.toml` 里，把所选 profile 的 `model_provider` 和 `model` 自动提升到顶层
+- 如果你使用的是这类 profile-only MiniMax 配置，再配合 Codex CLI `0.57.0`，DeepScientist 会在自己的 probe / 运行时临时 `config.toml` 副本里，把所选 profile 的 `model_provider` 和 `model` 自动提升到顶层
+- 对 provider-backed 的 MiniMax profile，DeepScientist 会强制使用 `model: inherit`，避免再被硬编码的 OpenAI 模型覆盖
+- 当 `requires_openai_auth = false` 时，DeepScientist 会自动移除冲突的 `OPENAI_API_KEY` 和 `OPENAI_BASE_URL`
 - 这意味着即使终端里原样执行 `codex --profile m27` 还会失败，DeepScientist 也可以先兼容跑起来
 
 如果你还希望终端里的 `codex --profile <name>` 也直接可用，请使用显式顶层兼容写法：
@@ -248,6 +264,7 @@ DeepScientist 现在会为 MiniMax 的 `0.57.0` 路径额外做两层兼容：
 
 - 当检测到旧版 Codex CLI 不支持 `xhigh` 时，自动把 `xhigh` 降级成 `high`
 - 当检测到 MiniMax 使用 profile-only 的 `model_provider` / `model` 配置形态时，在临时 DeepScientist Codex home 里自动补齐顶层字段
+- 当 provider 明确声明 `requires_openai_auth = false` 时，自动移除冲突的 `OPENAI_*` 认证环境变量
 
 ## GLM