@researai/deepscientist 1.5.12 → 1.5.13

package/bin/ds.js

@@ -36,11 +36,15 @@ const pythonCommands = new Set([
 const UPDATE_PACKAGE_NAME = String(packageJson.name || '@researai/deepscientist').trim() || '@researai/deepscientist';
 const UPDATE_CHECK_TTL_MS = 12 * 60 * 60 * 1000;
 
-const optionsWithValues = new Set(['--home', '--host', '--port', '--quest-id', '--mode', '--proxy', '--codex-profile']);
+const optionsWithValues = new Set(['--home', '--host', '--port', '--quest-id', '--mode', '--proxy', '--codex-profile', '--codex']);
 
-function buildCodexOverrideEnv({ yolo = false, profile = null } = {}) {
+function buildCodexOverrideEnv({ yolo = false, profile = null, binary = null } = {}) {
   const normalizedProfile = typeof profile === 'string' ? profile.trim() : '';
+  const normalizedBinary = typeof binary === 'string' ? binary.trim() : '';
   const overrides = {};
+  if (normalizedBinary) {
+    overrides.DEEPSCIENTIST_CODEX_BINARY = normalizedBinary;
+  }
   if (!yolo) {
     if (normalizedProfile) {
       overrides.DEEPSCIENTIST_CODEX_PROFILE = normalizedProfile;
@@ -103,6 +107,7 @@ Launcher flags:
   --proxy <url>         Use an outbound HTTP/WS proxy for npm and Python runtime traffic
   --yolo                Run Codex in YOLO mode: approval_policy=never and sandbox_mode=danger-full-access
   --codex-profile <id>  Run DeepScientist with a specific Codex profile, for example \`m27\`
+  --codex <path>        Run DeepScientist with a specific Codex executable path for this launch
   --quest-id <id>       Open the TUI on one quest directly
 
 Update:
@@ -981,6 +986,7 @@ function parseLauncherArgs(argv) {
   let skipUpdateCheck = false;
   let yolo = false;
   let codexProfile = null;
+  let codexBinary = null;
 
   if (args[0] === 'ui') {
     args.shift();
@@ -1001,6 +1007,7 @@ function parseLauncherArgs(argv) {
     else if (arg === '--skip-update-check') skipUpdateCheck = true;
     else if (arg === '--yolo') yolo = true;
     else if (arg === '--codex-profile' && args[index + 1]) codexProfile = args[++index];
+    else if (arg === '--codex' && args[index + 1]) codexBinary = args[++index];
     else if (arg === '--host' && args[index + 1]) host = args[++index];
     else if (arg === '--port' && args[index + 1]) port = Number(args[++index]);
     else if (arg === '--home' && args[index + 1]) home = path.resolve(args[++index]);
@@ -1027,6 +1034,7 @@ function parseLauncherArgs(argv) {
     skipUpdateCheck,
     yolo,
     codexProfile,
+    codexBinary,
   };
 }
 
@@ -2321,6 +2329,10 @@ function normalizePythonCliArgs(args, home) {
       index += 1;
       continue;
     }
+    if (arg === '--codex') {
+      index += 1;
+      continue;
+    }
     normalized.push(arg);
   }
   return ['--home', home, ...normalized];
@@ -4002,7 +4014,11 @@ async function launcherMain(rawArgs) {
 
   const pythonRuntime = ensurePythonRuntime(home);
   const runtimePython = pythonRuntime.runtimePython;
-  const codexOverrideEnv = buildCodexOverrideEnv({ yolo: options.yolo, profile: options.codexProfile });
+  const codexOverrideEnv = buildCodexOverrideEnv({
+    yolo: options.yolo,
+    profile: options.codexProfile,
+    binary: options.codexBinary,
+  });
   ensureInitialized(home, runtimePython);
   if (await maybeHandleStartupUpdate(home, rawArgs, options)) {
     return true;
@@ -4083,6 +4099,7 @@ async function main() {
     const codexOverrideEnv = buildCodexOverrideEnv({
       yolo: args.includes('--yolo'),
       profile: readOptionValue(args, '--codex-profile'),
+      binary: readOptionValue(args, '--codex'),
     });
     if (positional.value === 'run' || positional.value === 'daemon') {
       maybePrintOptionalLatexNotice(home);

package/docs/en/00_QUICK_START.md

@@ -79,7 +79,7 @@ npm install -g @researai/deepscientist
 
 This installs the `ds` command globally.
 
-DeepScientist depends on a working Codex CLI. The npm package tries to bring the bundled Codex dependency with it, but if `codex` is still missing afterward, repair it explicitly:
+DeepScientist depends on a working Codex CLI. It prefers the `codex` already available on your machine and only falls back to the bundled npm dependency when no local Codex path is available. If `codex` is still missing afterward, repair it explicitly:
 
 ```bash
 npm install -g @openai/codex
@@ -124,25 +124,44 @@ ds doctor
 If you already use a named Codex profile for MiniMax, GLM, Volcengine Ark, Alibaba Bailian, or another provider-backed path, verify that profile first in a terminal:
 
 ```bash
-codex --profile minimax
+codex --profile m27
 ```
 
 Then run DeepScientist through the same profile:
 
 ```bash
-ds doctor --codex-profile minimax
+ds doctor --codex-profile m27
 ```
 
 and later:
 
 ```bash
-ds --codex-profile minimax
+ds --codex-profile m27
 ```
 
-Replace `minimax` with the real profile name you created, such as `m27`, `glm`, `ark`, or `bailian`.
+If you need one specific Codex binary for this run, add `--codex` too:
+
+```bash
+ds doctor --codex /absolute/path/to/codex --codex-profile m27
+ds --codex /absolute/path/to/codex --codex-profile m27
+```
+
+`m27` is the MiniMax profile name used consistently in this repo. MiniMax's own page currently uses `m21`, but the profile name is only a local alias; if you created a different name, use that same name in all commands.
 
 DeepScientist blocks startup until Codex can pass a real hello probe. By default, the runner model in `~/DeepScientist/config/runners.yaml` is `gpt-5.4`. If your profile expects the model to come from the profile itself, use `model: inherit` in `runners.yaml`, or simply launch with `--codex-profile <name>` and let that session inherit the profile-defined model.
 
+MiniMax note:
+
+- if the current `@openai/codex` latest does not work with MiniMax, install `npm install -g @openai/codex@0.57.0`
+- create a MiniMax `Coding Plan Key` first
+- clear `OPENAI_API_KEY` and `OPENAI_BASE_URL` in the current shell before exporting `MINIMAX_API_KEY`
+- use `https://api.minimaxi.com/v1`
+- the `codex-MiniMax-*` model names shown on MiniMax's current Codex CLI page did not pass reliably through Codex CLI in local testing with the provided key
+- the locally verified working model name is `MiniMax-M2.7`
+- DeepScientist can auto-adapt MiniMax's profile-only `model_provider` / `model` config shape during probe and runtime
+- if you also want plain terminal `codex --profile <name>` to work directly, add `model_provider = "minimax"` and `model = "MiniMax-M2.7"` at the top level of `~/.codex/config.toml`
+- DeepScientist automatically downgrades `xhigh` to `high` when it detects an older Codex CLI that does not support `xhigh`
+
 ## 3. Start the Local Runtime
 
 Run:

package/docs/en/01_SETTINGS_REFERENCE.md

@@ -430,6 +430,8 @@ claude:
 - UI label: `Binary`
 - Meaning: command name or absolute path used to launch the runner.
 - `Test` behavior: checks whether the binary is on `PATH`.
+- Resolution order for `codex`: env override, explicit path, local `PATH`, then bundled fallback.
+- One-off note: you can temporarily override this with `ds --codex /absolute/path/to/codex`.
 - First-run note: DeepScientist does not finish Codex authentication for you. Before the first `ds`, make sure `codex --login` (or `codex`) has completed successfully.
 - Repair note: if the bundled dependency is missing after `npm install -g @researai/deepscientist`, install Codex explicitly with `npm install -g @openai/codex`.
 
@@ -448,6 +450,7 @@ claude:
 - Meaning: optional Codex profile name passed through as `codex --profile <name>`.
 - Use this when your Codex CLI is already configured for a provider-backed setup such as MiniMax, GLM, Volcengine Ark, or Alibaba Bailian.
 - One-off note: you can also leave this field empty and launch with `ds --codex-profile <name>`.
+- Combined note: one-off profile and binary overrides can be combined as `ds --codex /absolute/path/to/codex --codex-profile <name>`.
 
 **`model`**
 
@@ -465,6 +468,7 @@ claude:
 - UI label: `Reasoning effort`
 - Allowed values: `""`, `minimal`, `low`, `medium`, `high`, `xhigh`
 - Meaning: default reasoning intensity.
+- Compatibility note: when DeepScientist detects a Codex CLI older than `0.63.0`, it automatically downgrades `xhigh` to `high` for the startup probe and runner command. This covers MiniMax's currently recommended `@openai/codex@0.57.0` path.
 
 **`approval_policy`**
 

package/docs/en/09_DOCTOR.md

@@ -21,7 +21,7 @@ Use `ds doctor` when DeepScientist does not start cleanly after installation.
    Provider-backed profile path:
 
    ```bash
-   codex --profile minimax
+   codex --profile m27
    ```
 
    If `codex` is missing, repair it explicitly with:
@@ -63,7 +63,7 @@ Use `ds doctor` when DeepScientist does not start cleanly after installation.
 
 ### Codex is missing
 
-Run the package install again so the bundled Codex dependency is present:
+DeepScientist prefers the `codex` already available on your machine and only uses the bundled dependency as fallback. If neither is present, run the package install again so the bundled Codex dependency is present:
 
 ```bash
 npm install -g @researai/deepscientist
@@ -92,11 +92,18 @@ Finish login once, then rerun `ds doctor`.
 Run DeepScientist with the same profile explicitly:
 
 ```bash
-ds doctor --codex-profile minimax
-ds --codex-profile minimax
+ds doctor --codex-profile m27
+ds --codex-profile m27
 ```
 
-Replace `minimax` with your real profile name such as `m27`, `glm`, `ark`, or `bailian`.
+If your working Codex CLI is not the one on `PATH`, point DeepScientist at it explicitly:
+
+```bash
+ds doctor --codex /absolute/path/to/codex --codex-profile m27
+ds --codex /absolute/path/to/codex --codex-profile m27
+```
+
+`m27` is the MiniMax profile name used consistently in this repo. MiniMax's own page currently uses `m21`, but the profile name is only a local alias; if you created a different name, use that same name in both commands.
 
 Also check:
 
@@ -104,6 +111,18 @@ Also check:
 - the profile points at the provider's Coding Plan endpoint, not the generic API endpoint
 - `~/DeepScientist/config/runners.yaml` uses `model: inherit` if the provider expects the model to come from the profile itself
 
+MiniMax-specific note:
+
+- if MiniMax fails on the current `@openai/codex` latest, install `npm install -g @openai/codex@0.57.0`
+- create a MiniMax `Coding Plan Key` first
+- clear `OPENAI_API_KEY` and `OPENAI_BASE_URL` in the current shell before exporting `MINIMAX_API_KEY`
+- use `https://api.minimaxi.com/v1`
+- the `codex-MiniMax-*` model names shown on MiniMax's current Codex CLI page did not pass reliably through Codex CLI in local testing with the provided key
+- the locally verified working model name is `MiniMax-M2.7`
+- DeepScientist can auto-adapt MiniMax's profile-only `model_provider` / `model` config shape during probe and runtime
+- if you also want plain terminal `codex --profile <name>` to work directly, put `model_provider = "minimax"` and `model = "MiniMax-M2.7"` at the top level of `~/.codex/config.toml`
+- DeepScientist automatically downgrades `xhigh` to `high` when it detects a Codex CLI older than `0.63.0`
+
 ### The configured Codex model is unavailable
 
 DeepScientist blocks startup until Codex passes a real startup hello probe. In the current release, that probe first uses the runner model configured in:

package/docs/en/15_CODEX_PROVIDER_SETUP.md

@@ -25,12 +25,19 @@ ds
 
 ### 2. One-off provider profile
 
-Use this when you already have a named Codex profile such as `minimax`, `glm`, `ark`, or `bailian`.
+Use this when you already have a named Codex profile such as `m27`, `glm`, `ark`, or `bailian`.
 
 ```bash
-codex --profile minimax
-ds doctor --codex-profile minimax
-ds --codex-profile minimax
+codex --profile m27
+ds doctor --codex-profile m27
+ds --codex-profile m27
+```
+
+If you need one specific Codex binary for this run, use:
+
+```bash
+ds doctor --codex /absolute/path/to/codex --codex-profile m27
+ds --codex /absolute/path/to/codex --codex-profile m27
 ```
 
 This is the simplest path. You do not need to edit `runners.yaml` just to try one provider-backed session.
@@ -61,7 +68,7 @@ Important:
 | Provider | Official docs | Codex login needed | What DeepScientist should use |
 |---|---|---|---|
 | OpenAI | use the normal Codex setup | Yes | no profile; run `ds` |
-| MiniMax | [MiniMax Codex CLI](https://platform.minimaxi.com/docs/coding-plan/codex-cli) | No | your Codex profile, for example `ds --codex-profile minimax` |
+| MiniMax | [MiniMax Codex CLI](https://platform.minimaxi.com/docs/coding-plan/codex-cli) | No | your Codex profile, for example `ds --codex-profile m27` |
 | GLM | [GLM Coding Plan: Other Tools](https://docs.bigmodel.cn/cn/coding-plan/tool/others) | No | a Codex profile that targets the GLM coding endpoint |
 | Volcengine Ark | [Ark Coding Plan Overview](https://www.volcengine.com/docs/82379/1925114?lang=zh) | No | a Codex profile that targets the Ark coding endpoint |
 | Alibaba Bailian | [Bailian Coding Plan: Other Tools](https://help.aliyun.com/zh/model-studio/other-tools-coding-plan) | No | a Codex profile that targets the Bailian coding endpoint |
@@ -99,15 +106,65 @@ Official doc:
 
 - <https://platform.minimaxi.com/docs/coding-plan/codex-cli>
 
+### Verified compatibility note
+
+Checked against MiniMax's current Codex CLI doc and local compatibility validation on 2026-03-25:
+
+- MiniMax's Codex CLI page currently recommends `@openai/codex@0.57.0`
+- the Coding Plan endpoint to use is `https://api.minimaxi.com/v1`
+- MiniMax's official page uses `m21` as the profile name, but that profile name is only a local alias; this repo uses `m27` consistently in examples
+- the `codex-MiniMax-*` model names shown on MiniMax's page did not pass reliably through Codex CLI in local testing with the provided key
+- the locally verified working path was `MiniMax-M2.7` + `m27` + `model: inherit` + Codex CLI `0.57.0`
+- the current `@openai/codex` latest release still does not line up cleanly with MiniMax's current guide
+
+If you want the most reproducible DeepScientist + MiniMax path today, use Codex CLI `0.57.0`.
+
 ### What to prepare
 
-- Codex CLI installed
+- Codex CLI `0.57.0`
+- a MiniMax `Coding Plan Key`
 - `MINIMAX_API_KEY` available in the shell that starts Codex and DeepScientist
+- the current shell cleared of `OPENAI_API_KEY` and `OPENAI_BASE_URL`
 - a working Codex profile in `~/.codex/config.toml`
 
+### Install Codex CLI `0.57.0`
+
+The simplest path is to pin the global Codex install:
+
+```bash
+npm install -g @openai/codex@0.57.0
+codex --version
+```
+
+Expected output:
+
+```text
+codex-cli 0.57.0
+```
+
+If you want to keep another Codex version elsewhere, create a small wrapper script and point `runners.codex.binary` at that absolute path.
+
 ### Codex-side setup
 
-MiniMax's official page provides a real Codex custom-provider example. The profile name is yours to choose. Use `minimax` below as an example; if you already created `m27`, keep using `m27`.
+Use `https://api.minimaxi.com/v1`, not `https://api.minimax.io/v1`.
+
+MiniMax's doc requires clearing the OpenAI environment variables first:
+
+```bash
+unset OPENAI_API_KEY
+unset OPENAI_BASE_URL
+export MINIMAX_API_KEY="..."
+```
+
+MiniMax's official page uses `m21` as the example profile name. Since the profile name is only a local alias, this repo rewrites that example to `m27`.
+
+The important difference is the model name:
+
+- MiniMax's page currently shows `codex-MiniMax-M2.5`
+- in local testing, direct MiniMax API calls worked with `MiniMax-M2.7`
+- with the same key, `codex-MiniMax-M2.5` and `codex-MiniMax-M2.7` both failed through Codex CLI
+
+So the config below is the currently recommended DeepScientist working configuration:
 
 ```toml
 [model_providers.minimax]
@@ -120,23 +177,50 @@ request_max_retries = 4
 stream_max_retries = 10
 stream_idle_timeout_ms = 300000
 
-[profiles.minimax]
-model = "codex-MiniMax-M2.5"
+[profiles.m27]
+model = "MiniMax-M2.7"
+model_provider = "minimax"
+```
+
+What DeepScientist supports now:
+
+- if you use this profile-only MiniMax config with Codex CLI `0.57.0`, DeepScientist automatically promotes the selected profile's `model_provider` and `model` to the top level inside its probe/runtime copy of `.codex/config.toml`
+- this means DeepScientist can start even when plain terminal `codex --profile m27` still fails on that exact profile-only shape
+
+If you want plain terminal `codex --profile <name>` to work too, use the explicit top-level compatibility form instead:
+
+```toml
+model = "MiniMax-M2.7"
+model_provider = "minimax"
+approval_policy = "never"
+sandbox_mode = "workspace-write"
+
+[model_providers.minimax]
+name = "MiniMax Chat Completions API"
+base_url = "https://api.minimaxi.com/v1"
+env_key = "MINIMAX_API_KEY"
+wire_api = "chat"
+requires_openai_auth = false
+request_max_retries = 4
+stream_max_retries = 10
+stream_idle_timeout_ms = 300000
+
+[profiles.m27]
+model = "MiniMax-M2.7"
 model_provider = "minimax"
 ```
 
 Then:
 
 ```bash
-export MINIMAX_API_KEY="..."
-codex --profile minimax
+codex --profile m27
 ```
 
 ### DeepScientist commands
 
 ```bash
-ds doctor --codex-profile minimax
-ds --codex-profile minimax
+ds doctor --codex-profile m27
+ds --codex-profile m27
 ```
 
 ### Persistent runner config
@@ -144,12 +228,26 @@ ds --codex-profile minimax
 ```yaml
 codex:
   enabled: true
-  binary: codex
+  binary: /tmp/codex057-wrapper
   config_dir: ~/.codex
-  profile: minimax
+  profile: m27
   model: inherit
+  model_reasoning_effort: high
 ```
 
+If you already pinned your global `codex` binary to `0.57.0`, you can set `binary: codex` instead. The absolute wrapper path here is only to make the version choice explicit.
+
+If you do not want to persist that path in `runners.yaml`, you can keep `binary: codex` there and launch ad hoc with:
+
+```bash
+ds --codex /absolute/path/to/codex --codex-profile m27
+```
+
+DeepScientist now does two MiniMax-specific compatibility steps for the `0.57.0` path:
+
+- it downgrades `xhigh` to `high` automatically when the Codex CLI does not support `xhigh`
+- it auto-adapts MiniMax's profile-only `model_provider` / `model` shape inside the temporary DeepScientist Codex home when needed
+
 ## GLM
 
 GLM documents the Coding Plan as an OpenAI-compatible coding endpoint rather than a dedicated Codex login flow.

package/docs/zh/00_QUICK_START.md

@@ -79,7 +79,7 @@ npm install -g @researai/deepscientist
 
 这一步会把 `ds` 命令安装到你的机器上。
 
-DeepScientist 依赖一个可用的 Codex CLI。npm 包会尽量把随包的 Codex 依赖一起装好，但如果安装完成后 `codex` 仍然不可用，请显式修复：
+DeepScientist 依赖一个可用的 Codex CLI。它会优先使用你机器上已经可用的 `codex`，只有在本机找不到时才回退到 npm 包内置的依赖。如果安装完成后 `codex` 仍然不可用，请显式修复：
 
 ```bash
 npm install -g @openai/codex
@@ -124,25 +124,44 @@ ds doctor
 如果你已经在 MiniMax、GLM、火山方舟、阿里百炼或其他 provider 上配置了一个命名的 Codex profile，请先在终端里确认这个 profile 本身可用：
 
 ```bash
-codex --profile minimax
+codex --profile m27
 ```
 
 然后用同一个 profile 去跑 DeepScientist：
 
 ```bash
-ds doctor --codex-profile minimax
+ds doctor --codex-profile m27
 ```
 
 之后启动：
 
 ```bash
-ds --codex-profile minimax
+ds --codex-profile m27
 ```
 
-把这里的 `minimax` 替换成你真实的 profile 名，例如 `m27`、`glm`、`ark`、`bailian`。
+如果你这一轮还想强制指定某一个 Codex 可执行文件，也可以一起加上 `--codex`：
+
+```bash
+ds doctor --codex /absolute/path/to/codex --codex-profile m27
+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 对应的模型。
 
+MiniMax 额外说明：
+
+- 如果当前最新版 `@openai/codex` 和 MiniMax 走不通，直接安装 `npm install -g @openai/codex@0.57.0`
+- 先创建 MiniMax `Coding Plan Key`
+- 在当前 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 现在可以在 probe 和运行时自动适配 MiniMax profile-only 的 `model_provider` / `model` 配置形态
+- 如果你还希望终端里的 `codex --profile <name>` 也直接可用，再在 `~/.codex/config.toml` 顶层补上 `model_provider = "minimax"` 和 `model = "MiniMax-M2.7"`
+- 当 DeepScientist 检测到旧版 Codex CLI 不支持 `xhigh` 时，会自动把它降级成 `high`
+
 ## 3. 启动本地运行时
 
 运行：

package/docs/zh/01_SETTINGS_REFERENCE.md

@@ -444,6 +444,8 @@ claude:
 - 页面标签：`Binary`
 - 作用：启动 runner 时使用的命令名或绝对路径。
 - `Test` 行为：检查该二进制是否在 `PATH` 上。
+- `codex` 的解析顺序：环境变量覆盖、显式路径、本机 `PATH`、最后才是 bundled fallback。
+- 临时使用说明：你也可以直接用 `ds --codex /absolute/path/to/codex` 临时覆盖这里的设置。
 - 首次使用说明：DeepScientist 不会替你完成 Codex 认证。第一次运行 `ds` 前，必须先确保 `codex --login`（或 `codex`）已经成功完成。
 - 修复说明：如果执行 `npm install -g @researai/deepscientist` 之后 bundled Codex 依赖仍然缺失，请显式安装 `npm install -g @openai/codex`。
 
@@ -462,6 +464,7 @@ claude:
 - 作用：可选的 Codex profile 名称，会直接透传为 `codex --profile <name>`。
 - 当你的 Codex CLI 已经配置成 MiniMax、GLM、火山方舟、阿里百炼或其他 provider-backed 路径时，就在这里填写。
 - 临时使用说明：如果你不想持久化写配置，也可以保持这里为空，直接使用 `ds --codex-profile <name>` 启动。
+- 组合使用说明：如果你还想临时指定 Codex 可执行文件，也可以组合成 `ds --codex /absolute/path/to/codex --codex-profile <name>`。
 
 **`model`**
 
@@ -480,6 +483,7 @@ claude:
 - 允许值：`""`、`minimal`、`low`、`medium`、`high`、`xhigh`
 - 作用：默认推理强度。
 - 推荐：当前仓库的 Codex 默认就是 `xhigh`。
+- 兼容性说明：当 DeepScientist 检测到 Codex CLI 低于 `0.63.0` 时，会在启动探测和实际 runner 命令里自动把 `xhigh` 降级成 `high`。这也覆盖了 MiniMax 当前推荐的 `@openai/codex@0.57.0` 路径。
 
 **`approval_policy`**
 

package/docs/zh/09_DOCTOR.md

@@ -21,7 +21,7 @@
    provider-backed profile 路径：
 
    ```bash
-   codex --profile minimax
+   codex --profile m27
    ```
 
    如果 `codex` 缺失，请显式修复：
@@ -65,7 +65,7 @@
 
 ### 没有安装 Codex
 
-重新安装 DeepScientist，让随包的 Codex 依赖一起装好：
+DeepScientist 会优先使用你机器上已有的 `codex`，只有本机不可用时才回退到随包依赖。如果两者都不可用，就重新安装 DeepScientist，让随包的 Codex 依赖一起装好：
 
 ```bash
 npm install -g @researai/deepscientist
@@ -94,11 +94,18 @@ codex --login
 请显式让 DeepScientist 使用同一个 profile：
 
 ```bash
-ds doctor --codex-profile minimax
-ds --codex-profile minimax
+ds doctor --codex-profile m27
+ds --codex-profile m27
 ```
 
-把这里的 `minimax` 换成你的真实 profile 名，例如 `m27`、`glm`、`ark`、`bailian`。
+如果你当前能用的是另一个不在 `PATH` 上的 Codex，可执行文件路径也可以一起显式传给 DeepScientist：
+
+```bash
+ds doctor --codex /absolute/path/to/codex --codex-profile m27
+ds --codex /absolute/path/to/codex --codex-profile m27
+```
+
+这里的 `m27` 是本仓库统一使用的 MiniMax profile 示例名。MiniMax 官方页面当前示例名是 `m21`，但 profile 名只是本地别名；如果你自己用了别的名字，就把命令里的名字一起改掉。
 
 同时检查：
 
@@ -106,6 +113,18 @@ ds --codex-profile minimax
 - 该 profile 指向的是 provider 的 Coding Plan endpoint，而不是普通通用 API endpoint
 - 如果模型应该由 profile 自己决定，请在 `~/DeepScientist/config/runners.yaml` 中使用 `model: inherit`
 
+MiniMax 补充说明：
+
+- 如果 MiniMax 在当前最新版 `@openai/codex` 上失败，直接安装 `npm install -g @openai/codex@0.57.0`
+- 先创建 MiniMax `Coding Plan Key`
+- 在当前 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 现在可以在 probe 和运行时自动适配 MiniMax profile-only 的 `model_provider` / `model` 配置形态
+- 如果你还希望终端里的 `codex --profile <name>` 也直接可用，再在 `~/.codex/config.toml` 顶层补上 `model_provider = "minimax"` 和 `model = "MiniMax-M2.7"`
+- 当 DeepScientist 检测到 Codex CLI 版本低于 `0.63.0` 时，会自动把 `xhigh` 降级成 `high`
+
 ### 当前配置的 Codex 模型不可用
 
 DeepScientist 会在启动前强制做一次真实的 Codex hello 探测。当前版本里，这个探测会先使用：

package/docs/zh/15_CODEX_PROVIDER_SETUP.md

@@ -25,12 +25,19 @@ ds
 
 ### 2. 临时使用 provider profile
 
-如果你已经有一个可用的 Codex profile，例如 `minimax`、`glm`、`ark`、`bailian`，最简单的方式就是直接在启动 `ds` 时透传它。
+如果你已经有一个可用的 Codex profile，例如 `m27`、`glm`、`ark`、`bailian`，最简单的方式就是直接在启动 `ds` 时透传它。
 
 ```bash
-codex --profile minimax
-ds doctor --codex-profile minimax
-ds --codex-profile minimax
+codex --profile m27
+ds doctor --codex-profile m27
+ds --codex-profile m27
+```
+
+如果你这一轮要强制指定某一个 Codex 可执行文件，也可以这样：
+
+```bash
+ds doctor --codex /absolute/path/to/codex --codex-profile m27
+ds --codex /absolute/path/to/codex --codex-profile m27
 ```
 
 这是最简单的路径。只是临时试用某个 provider 时，不需要先改 `runners.yaml`。
@@ -62,7 +69,7 @@ codex:
 | Provider | 官方文档 | 是否需要 Codex 登录 | DeepScientist 应该怎么用 |
 |---|---|---|---|
 | OpenAI | 正常 Codex 配置即可 | 是 | 不需要 profile，直接 `ds` |
-| MiniMax | [MiniMax Codex CLI](https://platform.minimaxi.com/docs/coding-plan/codex-cli) | 否 | 使用你自己的 Codex profile，例如 `ds --codex-profile minimax` |
+| MiniMax | [MiniMax Codex CLI](https://platform.minimaxi.com/docs/coding-plan/codex-cli) | 否 | 使用你自己的 Codex profile，例如 `ds --codex-profile m27` |
 | GLM | [GLM Coding Plan：其他工具](https://docs.bigmodel.cn/cn/coding-plan/tool/others) | 否 | 使用一个指向 GLM coding endpoint 的 Codex profile |
 | 火山方舟 | [Ark Coding Plan 总览](https://www.volcengine.com/docs/82379/1925114?lang=zh) | 否 | 使用一个指向 Ark coding endpoint 的 Codex profile |
 | 阿里百炼 | [百炼 Coding Plan：其他工具](https://help.aliyun.com/zh/model-studio/other-tools-coding-plan) | 否 | 使用一个指向 Bailian coding endpoint 的 Codex profile |
@@ -100,15 +107,65 @@ MiniMax 是最典型的 profile 模式。它的官方 Codex CLI 文档直接给
 
 - <https://platform.minimaxi.com/docs/coding-plan/codex-cli>
 
+### 已验证的兼容性说明
+
+按 2026-03-25 对 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`
+- 当前最新版 `@openai/codex` 和 MiniMax 官方文档并不能稳定直接对齐
+
+如果你现在要走最稳的 DeepScientist + MiniMax 路径，建议直接使用 Codex CLI `0.57.0`。
+
 ### 需要准备什么
 
-- 已安装 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/config.toml` 中已经配置好的 Codex profile
 
+### 安装 Codex CLI `0.57.0`
+
+最直接的方式是把全局 Codex 安装固定到 `0.57.0`：
+
+```bash
+npm install -g @openai/codex@0.57.0
+codex --version
+```
+
+预期输出：
+
+```text
+codex-cli 0.57.0
+```
+
+如果你还想保留另一个 Codex 版本，也可以单独写一个 wrapper 脚本，再把 `runners.codex.binary` 指向那个绝对路径。
+
 ### Codex 侧配置
 
-MiniMax 官方页面给了真实的 Codex custom provider 示例。profile 名称由你自己决定。下面用 `minimax` 作为示例；如果你已经配置成 `m27`，就继续使用 `m27`。
+请使用 `https://api.minimaxi.com/v1`，不要用 `https://api.minimax.io/v1`。
+
+MiniMax 官方文档要求在配置前先清理 OpenAI 环境变量：
+
+```bash
+unset OPENAI_API_KEY
+unset OPENAI_BASE_URL
+export MINIMAX_API_KEY="..."
+```
+
+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 都会失败
+
+因此，下面给的是当前 DeepScientist 推荐的可运行配置：
 
 ```toml
 [model_providers.minimax]
@@ -121,23 +178,50 @@ request_max_retries = 4
 stream_max_retries = 10
 stream_idle_timeout_ms = 300000
 
-[profiles.minimax]
-model = "codex-MiniMax-M2.5"
+[profiles.m27]
+model = "MiniMax-M2.7"
+model_provider = "minimax"
+```
+
+DeepScientist 现在对它的支持方式是：
+
+- 如果你使用的是这类 profile-only MiniMax 配置，再配合 Codex CLI `0.57.0`，DeepScientist 会在自己的 probe / 运行时临时 `.codex/config.toml` 里，把所选 profile 的 `model_provider` 和 `model` 自动提升到顶层
+- 这意味着即使终端里原样执行 `codex --profile m27` 还会失败，DeepScientist 也可以先兼容跑起来
+
+如果你还希望终端里的 `codex --profile <name>` 也直接可用，请使用显式顶层兼容写法：
+
+```toml
+model = "MiniMax-M2.7"
+model_provider = "minimax"
+approval_policy = "never"
+sandbox_mode = "workspace-write"
+
+[model_providers.minimax]
+name = "MiniMax Chat Completions API"
+base_url = "https://api.minimaxi.com/v1"
+env_key = "MINIMAX_API_KEY"
+wire_api = "chat"
+requires_openai_auth = false
+request_max_retries = 4
+stream_max_retries = 10
+stream_idle_timeout_ms = 300000
+
+[profiles.m27]
+model = "MiniMax-M2.7"
 model_provider = "minimax"
 ```
 
 然后执行：
 
 ```bash
-export MINIMAX_API_KEY="..."
-codex --profile minimax
+codex --profile m27
 ```
 
 ### DeepScientist 命令
 
 ```bash
-ds doctor --codex-profile minimax
-ds --codex-profile minimax
+ds doctor --codex-profile m27
+ds --codex-profile m27
 ```
 
 ### 持久化 runner 配置
@@ -145,12 +229,26 @@ ds --codex-profile minimax
 ```yaml
 codex:
   enabled: true
-  binary: codex
+  binary: /tmp/codex057-wrapper
   config_dir: ~/.codex
-  profile: minimax
+  profile: m27
   model: inherit
+  model_reasoning_effort: high
 ```
 
+如果你已经把全局 `codex` 固定到 `0.57.0`，也可以把 `binary` 写回 `codex`。这里写绝对路径只是为了明确避免误用系统里其他版本的 Codex。
+
+如果你不想把这个路径持久化写进 `runners.yaml`，也可以保留 `binary: codex`，然后在启动时临时加：
+
+```bash
+ds --codex /absolute/path/to/codex --codex-profile m27
+```
+
+DeepScientist 现在会为 MiniMax 的 `0.57.0` 路径额外做两层兼容：
+
+- 当检测到旧版 Codex CLI 不支持 `xhigh` 时，自动把 `xhigh` 降级成 `high`
+- 当检测到 MiniMax 使用 profile-only 的 `model_provider` / `model` 配置形态时，在临时 DeepScientist Codex home 里自动补齐顶层字段
+
 ## GLM
 
 GLM 的官方文档把 Coding Plan 描述成 OpenAI-compatible 的 coding endpoint，而不是单独的 Codex 登录流程。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@researai/deepscientist",
-  "version": "1.5.12",
+  "version": "1.5.13",
   "description": "DeepScientist is not just a fully open-source autonomous scientific discovery system. It is also a research map that keeps growing from every round.",
   "license": "Apache-2.0",
   "files": [
@@ -38,6 +38,7 @@
     "@openai/codex": "^0.114.0",
     "ink": "npm:@jrichman/ink@6.4.6",
     "ink-gradient": "^3.0.0",
+    "qrcode": "^1.5.4",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "string-width": "^8.1.0"

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepscientist"
-version = "1.5.12"
+version = "1.5.13"
 description = "DeepScientist Core skeleton"
 readme = "README.md"
 requires-python = ">=3.11"

package/src/deepscientist/__init__.py

@@ -5,4 +5,4 @@ __all__ = ["__version__"]
 try:
     __version__ = _package_version("deepscientist")
 except PackageNotFoundError:  # pragma: no cover - source checkout fallback
-    __version__ = "1.5.12"
+    __version__ = "1.5.13"

package/src/deepscientist/cli.py

@@ -39,6 +39,7 @@ def build_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(prog="ds", description="DeepScientist Core skeleton")
     parser.add_argument("--home", default=None, help="Override DeepScientist home")
     parser.add_argument("--proxy", default=None, help="Explicit outbound HTTP/WS proxy, for example `http://127.0.0.1:7890`.")
+    parser.add_argument("--codex", default=None, help="Override the Codex executable path for this invocation.")
 
     subparsers = parser.add_subparsers(dest="command", required=True)
 
@@ -475,6 +476,8 @@ def migrate_command(home: Path, target: str) -> int:
 def main(argv: list[str] | None = None) -> int:
     parser = build_parser()
     args = parser.parse_args(argv)
+    if args.codex:
+        os.environ["DEEPSCIENTIST_CODEX_BINARY"] = str(args.codex)
     configure_runtime_proxy(args.proxy)
     home = resolve_home(args)
 

package/src/deepscientist/codex_cli_compat.py

@@ -0,0 +1,117 @@
+from __future__ import annotations
+
+import json
+import re
+import subprocess
+import tomllib
+from functools import lru_cache
+
+_MIN_XHIGH_SUPPORTED_VERSION = (0, 63, 0)
+_CODEX_VERSION_PATTERN = re.compile(r"codex-cli\s+(\d+)\.(\d+)\.(\d+)", re.IGNORECASE)
+
+
+def parse_codex_cli_version(text: str) -> tuple[int, int, int] | None:
+    match = _CODEX_VERSION_PATTERN.search(str(text or ""))
+    if not match:
+        return None
+    return tuple(int(part) for part in match.groups())
+
+
+@lru_cache(maxsize=32)
+def codex_cli_version(binary: str) -> tuple[int, int, int] | None:
+    normalized = str(binary or "").strip()
+    if not normalized:
+        return None
+    try:
+        result = subprocess.run(
+            [normalized, "--version"],
+            check=False,
+            capture_output=True,
+            text=True,
+            timeout=10,
+        )
+    except (OSError, subprocess.TimeoutExpired):
+        return None
+    return parse_codex_cli_version(f"{result.stdout}\n{result.stderr}")
+
+
+def format_codex_cli_version(version: tuple[int, int, int] | None) -> str:
+    if version is None:
+        return ""
+    return ".".join(str(part) for part in version)
+
+
+def normalize_codex_reasoning_effort(
+    reasoning_effort: str | None,
+    *,
+    resolved_binary: str | None,
+) -> tuple[str | None, str | None]:
+    normalized = str(reasoning_effort or "").strip()
+    if not normalized:
+        return None, None
+    if normalized.lower() != "xhigh":
+        return normalized, None
+
+    version = codex_cli_version(str(resolved_binary or ""))
+    if version is None or version >= _MIN_XHIGH_SUPPORTED_VERSION:
+        return normalized, None
+
+    version_text = format_codex_cli_version(version)
+    return (
+        "high",
+        (
+            f"Codex CLI {version_text} does not support `xhigh`; "
+            "DeepScientist downgraded reasoning effort to `high` automatically."
+        ),
+    )
+
+
+def adapt_profile_only_provider_config(
+    config_text: str,
+    *,
+    profile: str,
+) -> tuple[str, str | None]:
+    normalized_profile = str(profile or "").strip()
+    if not normalized_profile or not str(config_text or "").strip():
+        return config_text, None
+    try:
+        parsed = tomllib.loads(config_text)
+    except tomllib.TOMLDecodeError:
+        return config_text, None
+
+    profiles = parsed.get("profiles")
+    if not isinstance(profiles, dict):
+        return config_text, None
+    profile_payload = profiles.get(normalized_profile)
+    if not isinstance(profile_payload, dict):
+        return config_text, None
+
+    prefix_lines: list[str] = []
+    injected_fields: list[str] = []
+    if "model_provider" not in parsed:
+        model_provider = str(profile_payload.get("model_provider") or "").strip()
+        if model_provider:
+            prefix_lines.append(f"model_provider = {json.dumps(model_provider, ensure_ascii=False)}")
+            injected_fields.append("model_provider")
+    if "model" not in parsed:
+        model = str(profile_payload.get("model") or "").strip()
+        if model:
+            prefix_lines.append(f"model = {json.dumps(model, ensure_ascii=False)}")
+            injected_fields.append("model")
+
+    if not prefix_lines:
+        return config_text, None
+
+    adapted = (
+        "# BEGIN DEEPSCIENTIST PROFILE COMPAT\n"
+        + "\n".join(prefix_lines)
+        + "\n# END DEEPSCIENTIST PROFILE COMPAT\n\n"
+        + config_text.lstrip()
+    )
+    return (
+        adapted,
+        (
+            f"DeepScientist promoted `{normalized_profile}` profile "
+            f"{', '.join(injected_fields)} to the top level for Codex compatibility."
+        ),
+    )

package/src/deepscientist/config/service.py

@@ -3,11 +3,14 @@ from __future__ import annotations
 import json
 import os
 import subprocess
+import tempfile
+from shutil import copy2
 from copy import deepcopy
 from pathlib import Path
 from urllib.error import URLError
 from urllib.request import Request
 
+from ..codex_cli_compat import adapt_profile_only_provider_config, normalize_codex_reasoning_effort
 from ..connector.connector_profiles import PROFILEABLE_CONNECTOR_NAMES, list_connector_profiles, normalize_connector_config
 from ..connector_runtime import build_discovered_target, infer_connector_transport
 from ..home import repo_root
@@ -486,6 +489,7 @@ This page edits `{home_text}/config/runners.yaml`.
 - `claude` remains TODO / reserved in the current open-source release and is not runnable yet
 - set `codex.profile` only when your Codex CLI uses a named provider profile such as `m27`
 - when you launch DeepScientist ad hoc with a provider profile, you can also use `ds --codex-profile <name>`
+- when you want a one-off Codex binary override, you can also use `ds --codex /absolute/path/to/codex`
 - keep `codex.model_reasoning_effort: xhigh` unless you explicitly want a lighter default
 - keep `codex.retry_on_failure: true` so transient Codex failures can resume automatically
 - keep retry timing near `10s / 6x / 1800s max` so Codex backs off exponentially and the last retry waits about 30 minutes
@@ -1206,6 +1210,31 @@ Use **Test** when the file exposes runtime dependencies.
             resolved[env_key] = str(value)
         return resolved
 
+    def _prepare_codex_probe_home(
+        self,
+        *,
+        config_dir: str,
+        profile: str,
+    ) -> tuple[str, str | None, tempfile.TemporaryDirectory[str] | None]:
+        expanded = Path(config_dir).expanduser()
+        config_path = expanded / "config.toml"
+        if not config_path.exists():
+            return str(expanded), None, None
+
+        original_text = read_text(config_path)
+        adapted_text, warning = adapt_profile_only_provider_config(original_text, profile=profile)
+        if warning is None:
+            return str(expanded), None, None
+
+        temp_home = tempfile.TemporaryDirectory(prefix="ds-codex-probe-")
+        temp_root = Path(temp_home.name)
+        for filename in ("auth.json",):
+            source_path = expanded / filename
+            if source_path.exists():
+                copy2(source_path, temp_root / filename)
+        write_text(temp_root / "config.toml", adapted_text)
+        return str(temp_root), warning, temp_home
+
     def _codex_missing_binary_guidance(self, config: dict) -> list[str]:
         profile = self._codex_profile_name(config)
         guidance = [
@@ -1221,7 +1250,9 @@ Use **Test** when the file exposes runtime dependencies.
             )
         else:
             guidance.append("Run `codex --login` (or `codex`) once and finish authentication before starting DeepScientist.")
-        guidance.append("If you use a custom Codex path, set `runners.codex.binary` to that absolute executable path.")
+        guidance.append(
+            "If you use a custom Codex path, either set `runners.codex.binary` or launch with `ds --codex /absolute/path/to/codex`."
+        )
         return guidance
 
     def _codex_probe_failure_guidance(self, config: dict) -> tuple[list[str], list[str]]:
@@ -1326,11 +1357,15 @@ Use **Test** when the file exposes runtime dependencies.
         profile = self._codex_profile_name(config)
         requested_model = self._codex_requested_model(config)
         raw_reasoning_effort = config.get("model_reasoning_effort")
-        reasoning_effort = (
+        requested_reasoning_effort = (
             str(raw_reasoning_effort).strip()
             if raw_reasoning_effort is not None and str(raw_reasoning_effort).strip()
             else ("xhigh" if raw_reasoning_effort is None else None)
         )
+        reasoning_effort, reasoning_effort_warning = normalize_codex_reasoning_effort(
+            requested_reasoning_effort,
+            resolved_binary=resolved_binary,
+        )
         details: dict[str, object] = {
             "binary": binary,
             "resolved_binary": resolved_binary,
@@ -1342,6 +1377,7 @@ Use **Test** when the file exposes runtime dependencies.
             "approval_policy": str(config.get("approval_policy") or "on-request"),
             "sandbox_mode": str(config.get("sandbox_mode") or "workspace-write"),
             "reasoning_effort": reasoning_effort,
+            "requested_reasoning_effort": requested_reasoning_effort,
             "model_fallback_attempted": False,
             "model_fallback_used": False,
             "checked_at": checked_at,
@@ -1365,9 +1401,20 @@ Use **Test** when the file exposes runtime dependencies.
         env = os.environ.copy()
         env.update(self._codex_runner_env(config))
         config_dir = str(config.get("config_dir") or "~/.codex").strip()
+        probe_home_handle: tempfile.TemporaryDirectory[str] | None = None
+        compatibility_warnings: list[str] = []
         if config_dir:
-            env["CODEX_HOME"] = str(Path(config_dir).expanduser())
+            prepared_home, profile_config_warning, probe_home_handle = self._prepare_codex_probe_home(
+                config_dir=config_dir,
+                profile=profile,
+            )
+            env["CODEX_HOME"] = prepared_home
+            if profile_config_warning:
+                compatibility_warnings.append(profile_config_warning)
         prompt = "Reply with exactly HELLO."
+        if reasoning_effort_warning:
+            compatibility_warnings.append(reasoning_effort_warning)
+        base_warnings: list[str] = list(compatibility_warnings)
 
         def run_probe_once(model_for_command: str) -> tuple[list[str], subprocess.CompletedProcess[str] | None, subprocess.TimeoutExpired | None]:
             command = self._build_codex_probe_command(
@@ -1406,7 +1453,7 @@ Use **Test** when the file exposes runtime dependencies.
             return {
                 "ok": False,
                 "summary": "Codex startup probe timed out.",
-                "warnings": [],
+                "warnings": base_warnings,
                 "errors": [
                     "Codex did not answer the startup hello probe within 90 seconds.",
                     *self._codex_probe_failure_guidance(config)[0],
@@ -1463,7 +1510,7 @@ Use **Test** when the file exposes runtime dependencies.
                     return {
                         "ok": True,
                         "summary": "Codex startup probe completed with Codex default model fallback.",
-                        "warnings": [fallback_warning],
+                        "warnings": [*base_warnings, fallback_warning],
                         "errors": [],
                         "details": details,
                         "guidance": [
@@ -1483,7 +1530,7 @@ Use **Test** when the file exposes runtime dependencies.
                 "probe_command": command,
             }
         )
-        warnings: list[str] = []
+        warnings: list[str] = list(base_warnings)
         errors: list[str] = []
         if not ok:
             errors.append("Codex did not complete the startup hello probe successfully.")

package/src/deepscientist/runners/codex.py

@@ -11,11 +11,12 @@ from pathlib import Path
 from typing import Any
 
 from ..artifact import ArtifactService
+from ..codex_cli_compat import adapt_profile_only_provider_config, normalize_codex_reasoning_effort
 from ..config import ConfigManager
 from ..gitops import export_git_graph
 from ..prompts import PromptBuilder
 from ..runtime_logs import JsonlLogger
-from ..shared import append_jsonl, ensure_dir, generate_id, read_yaml, resolve_runner_binary, utc_now, write_json, write_text
+from ..shared import append_jsonl, ensure_dir, generate_id, read_text, read_yaml, resolve_runner_binary, utc_now, write_json, write_text
 from ..web_search import extract_web_search_payload
 from .base import RunRequest, RunResult
 
@@ -920,7 +921,10 @@ class CodexRunner:
             command.extend(["--model", normalized_model])
         if request.approval_policy:
             command.extend(["-c", f'approval_policy="{request.approval_policy}"'])
-        reasoning_effort = request.reasoning_effort
+        reasoning_effort, _ = normalize_codex_reasoning_effort(
+            request.reasoning_effort,
+            resolved_binary=resolved_binary or self.binary,
+        )
         if reasoning_effort:
             command.extend(["-c", f'model_reasoning_effort="{reasoning_effort}"'])
         tool_timeout_sec = self._positive_timeout_seconds(resolved_runner_config.get("mcp_tool_timeout_sec"))
@@ -945,6 +949,7 @@ class CodexRunner:
         target = ensure_dir(workspace_root / ".codex")
         resolved_runner_config = runner_config if isinstance(runner_config, dict) else self._load_runner_config()
         configured_home = str(resolved_runner_config.get("config_dir") or os.environ.get("CODEX_HOME") or str(Path.home() / ".codex"))
+        profile = str(resolved_runner_config.get("profile") or "").strip()
         source = Path(configured_home).expanduser()
         for filename in ("config.toml", "auth.json"):
             source_path = source / filename
@@ -953,6 +958,10 @@ class CodexRunner:
                 if source_path.resolve() == target_path.resolve():
                     continue
                 shutil.copy2(source_path, target_path)
+        config_path = target / "config.toml"
+        if profile and config_path.exists():
+            adapted_text, _ = adapt_profile_only_provider_config(read_text(config_path), profile=profile)
+            write_text(config_path, adapted_text)
         ensure_dir(target / "skills")
         quest_skills_root = quest_root / ".codex" / "skills"
         if quest_skills_root.exists():

package/src/deepscientist/runners/runtime_overrides.py

@@ -18,6 +18,7 @@ def _as_bool_env(name: str) -> bool:
 
 
 def codex_runtime_overrides() -> dict[str, str]:
+    binary = _as_text(os.environ.get("DEEPSCIENTIST_CODEX_BINARY") or os.environ.get("DS_CODEX_BINARY"))
     approval_policy = _as_text(os.environ.get("DEEPSCIENTIST_CODEX_APPROVAL_POLICY"))
     sandbox_mode = _as_text(os.environ.get("DEEPSCIENTIST_CODEX_SANDBOX_MODE"))
     profile = _as_text(os.environ.get("DEEPSCIENTIST_CODEX_PROFILE"))
@@ -28,6 +29,8 @@ def codex_runtime_overrides() -> dict[str, str]:
         sandbox_mode = sandbox_mode or "danger-full-access"
 
     overrides: dict[str, str] = {}
+    if binary:
+        overrides["binary"] = binary
     if approval_policy:
         overrides["approval_policy"] = approval_policy
     if sandbox_mode:

package/src/skills/baseline/references/artifact-payload-examples.md

@@ -0,0 +1,39 @@
+# Artifact Payload Examples
+
+Use this reference when the `baseline` stage needs a stable payload shape without re-expanding the main skill body.
+
+## Route or blocked decision
+
+Keep these fields when route choice or blocking status matters:
+
+- `kind`
+- `action`
+- `reason`
+- `baseline_id`
+- `baseline_variant_id` when relevant
+- `evidence_paths`
+- `next_direction`
+
+## Accepted baseline
+
+Keep these fields when writing the accepted baseline artifact:
+
+- `kind`
+- `baseline_id`
+- `baseline_kind`
+- `path`
+- `task`
+- `dataset`
+- `primary_metric`
+- `metrics_summary`
+- `default_variant_id` when relevant
+- `baseline_variants` when relevant
+- `environment`
+- `source`
+- `summary`
+
+## Rules
+
+- keep payloads compact but audit-friendly
+- do not omit the trusted comparison surface just because one headline metric exists
+- do not publish a blocked or verification-incomplete baseline payload as if it were accepted

package/src/tui/dist/lib/connectorConfig.js

@@ -0,0 +1,90 @@
+export const CONNECTOR_ORDER = [
+    'qq',
+    'weixin',
+    'lingzhu',
+    'telegram',
+    'discord',
+    'slack',
+    'feishu',
+    'whatsapp',
+];
+const CONNECTOR_LABELS = {
+    qq: 'QQ',
+    weixin: 'Weixin',
+    lingzhu: 'Lingzhu',
+    telegram: 'Telegram',
+    discord: 'Discord',
+    slack: 'Slack',
+    feishu: 'Feishu',
+    whatsapp: 'WhatsApp',
+};
+const CONNECTOR_SUBTITLES = {
+    qq: 'Save App ID and App Secret, then wait for the first private QQ message to discover the target.',
+    weixin: 'Start QR login, scan with WeChat, and let DeepScientist save the connector automatically.',
+    lingzhu: 'Generate the Rokid binding values here, then copy them into the Lingzhu platform and save once.',
+    telegram: 'Guided setup not added in TUI yet. Use raw connectors config if needed.',
+    discord: 'Guided setup not added in TUI yet. Use raw connectors config if needed.',
+    slack: 'Guided setup not added in TUI yet. Use raw connectors config if needed.',
+    feishu: 'Guided setup not added in TUI yet. Use raw connectors config if needed.',
+    whatsapp: 'Guided setup not added in TUI yet. Use raw connectors config if needed.',
+};
+const GUIDED_CONNECTORS = new Set(['qq', 'weixin', 'lingzhu']);
+const LINGZHU_EXAMPLE_AUTH_AKS = new Set(['abcd1234-abcd-abcd-abcd-abcdefghijkl']);
+export function connectorLabel(name) {
+    const normalized = String(name || '').trim().toLowerCase();
+    return CONNECTOR_LABELS[normalized] || (normalized ? normalized[0].toUpperCase() + normalized.slice(1) : 'Connector');
+}
+export function connectorSubtitle(name) {
+    const normalized = String(name || '').trim().toLowerCase();
+    return CONNECTOR_SUBTITLES[normalized] || 'Connector settings.';
+}
+export function supportsGuidedConnector(name) {
+    const normalized = String(name || '').trim().toLowerCase();
+    return GUIDED_CONNECTORS.has(normalized);
+}
+export function maskSecret(value) {
+    const text = String(value || '').trim();
+    if (!text) {
+        return '';
+    }
+    if (text.startsWith('$')) {
+        return text;
+    }
+    if (text.length <= 8) {
+        return '*'.repeat(text.length);
+    }
+    return `${text.slice(0, 4)}${'*'.repeat(Math.max(0, text.length - 8))}${text.slice(-4)}`;
+}
+export function createLingzhuAk() {
+    const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+    const segments = [8, 4, 4, 4, 12];
+    const totalLength = segments.reduce((sum, size) => sum + size, 0);
+    const bytes = typeof crypto !== 'undefined' && typeof crypto.getRandomValues === 'function'
+        ? crypto.getRandomValues(new Uint8Array(totalLength))
+        : Uint8Array.from({ length: totalLength }, () => Math.floor(Math.random() * 256));
+    let index = 0;
+    return segments
+        .map((size) => {
+        let segment = '';
+        for (let offset = 0; offset < size; offset += 1) {
+            segment += chars[bytes[index] % chars.length];
+            index += 1;
+        }
+        return segment;
+    })
+        .join('-');
+}
+export function resolveLingzhuAuthAk(value) {
+    const normalized = String(value || '').trim();
+    return LINGZHU_EXAMPLE_AUTH_AKS.has(normalized) ? '' : normalized;
+}
+export function looksLikeWeixinQrImageUrl(value) {
+    const text = String(value || '').trim();
+    if (!text) {
+        return false;
+    }
+    if (text.startsWith('data:image/') || text.startsWith('blob:')) {
+        return true;
+    }
+    return /^https?:\/\/.+\.(png|jpg|jpeg|gif|webp|svg)(?:$|[?#])/i.test(text);
+}

package/src/tui/dist/lib/qr.js

@@ -0,0 +1,21 @@
+export async function renderQrAscii(content) {
+    const normalized = String(content || '').trim();
+    if (!normalized) {
+        return '';
+    }
+    const qrModule = (await import('qrcode'));
+    try {
+        return await qrModule.toString(normalized, {
+            type: 'utf8',
+            errorCorrectionLevel: 'M',
+            margin: 0,
+        });
+    }
+    catch {
+        return qrModule.toString(normalized, {
+            type: 'utf8',
+            errorCorrectionLevel: 'M',
+            margin: 2,
+        });
+    }
+}

package/src/tui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepscientist-tui",
-  "version": "1.5.12",
+  "version": "1.5.13",
   "private": true,
   "type": "module",
   "main": "dist/index.js",
@@ -12,6 +12,7 @@
   "dependencies": {
     "ink": "npm:@jrichman/ink@6.4.6",
     "ink-gradient": "^3.0.0",
+    "qrcode": "^1.5.4",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "string-width": "^8.1.0"