@researai/deepscientist 1.5.16 → 1.5.17

package/docs/en/91_DEVELOPMENT.md

@@ -179,6 +179,243 @@ match = service.resolve_binary("example-binary", preferred_tools=("example",))
 - keep clear source reporting such as `tinytex` versus `path`
 - add tests for registration, status, and binary resolution
 
+## Extending Core Runtime
+
+This section is the maintainer checklist for adding one new built-in MCP tool, one new skill, or one new connector.
+
+Keep the extension shape close to the repository's existing registries and contracts. Do not invent a parallel path when the current registry or prompt system already covers the need.
+
+### Add a built-in MCP tool
+
+Public MCP surface must stay limited to:
+
+- `memory`
+- `artifact`
+- `bash_exec`
+
+Do not add a new public namespace such as `git`, `connector`, or `runtime_tool`.
+
+If you need new Git behavior, add it under `artifact`.
+If you need new durable shell behavior, add it under `bash_exec`.
+
+#### Files to change
+
+- `src/deepscientist/mcp/server.py`
+  - add the new `@server.tool(...)` handler under `build_memory_server(...)`, `build_artifact_server(...)`, or `build_bash_exec_server(...)`
+- `src/deepscientist/mcp/context.py`
+  - only if the new tool needs extra quest/runtime context wiring
+- `src/deepscientist/runners/codex.py`
+  - if the tool should appear in built-in MCP approval policy defaults, add it under `_BUILTIN_MCP_TOOL_APPROVALS`
+- `docs/en/07_MEMORY_AND_MCP.md`
+  - update user-visible semantics if the tool changes how the namespace should be used
+- `docs/en/14_PROMPT_SKILLS_AND_MCP_GUIDE.md`
+  - update the built-in MCP description if the tool meaning materially changes
+
+#### Implementation rules
+
+1. Keep the handler thin. Put durable state changes in the underlying service layer such as `ArtifactService`, `MemoryService`, or `BashExecService`.
+2. Use `McpContext` for quest-local paths instead of reconstructing runtime state ad hoc.
+3. Use read-only annotations for non-mutating tools.
+4. If the tool changes durable quest state but does not itself send a user-visible message, follow the existing artifact watchdog pattern in `mcp/server.py`.
+5. Do not bypass the current namespace meaning. Example: do not hide shell execution inside `artifact`.
+
+#### Minimum test checklist
+
+- `tests/test_mcp_servers.py`
+  - namespace wiring and tool call behavior
+- `tests/test_memory_and_artifact.py`
+  - if the tool changes artifact or memory semantics
+- `tests/test_daemon_api.py`
+  - if API payloads or quest projections depend on the new tool's outputs
+
+### Add a skill
+
+Skills are discovered from disk. The canonical location is:
+
+- `src/skills/<skill_id>/SKILL.md`
+
+The runtime discovers skills through:
+
+- `src/deepscientist/skills/registry.py`
+
+The prompt builder projects them through:
+
+- `src/deepscientist/prompts/builder.py`
+- `src/deepscientist/skills/installer.py`
+
+#### Minimal skill shape
+
+Create a directory:
+
+```text
+src/skills/<skill_id>/
+```
+
+and add:
+
+```md
+---
+name: my-skill
+description: One-line purpose statement.
+skill_role: stage
+skill_order: 60
+---
+
+# My Skill
+...
+```
+
+Supported `skill_role` values are:
+
+- `stage`
+- `companion`
+- `custom`
+
+Optional projected agent files:
+
+- `src/skills/<skill_id>/agents/openai.yaml`
+- `src/skills/<skill_id>/agents/claude.md`
+
+#### Files to change
+
+- `src/skills/<skill_id>/SKILL.md`
+  - required
+- `src/deepscientist/skills/registry.py`
+  - update `_DEFAULT_STAGE_SKILLS` or `_DEFAULT_COMPANION_SKILLS` if this is a canonical built-in stage or companion skill rather than an ad hoc custom one
+- `src/deepscientist/prompts/builder.py`
+  - update `STAGE_MEMORY_PLAN` if the skill is a real stage that needs a first-class memory retrieval plan
+- `docs/en/14_PROMPT_SKILLS_AND_MCP_GUIDE.md`
+  - update the skill guide if the public workflow shape changed
+
+#### Skill rules
+
+1. Put execution discipline inside `SKILL.md`, not inside a central Python stage scheduler.
+2. Reuse the existing prompt contract language:
+   - interaction discipline
+   - tool discipline
+   - stage purpose
+   - completion or handoff rules
+3. If the skill is a canonical stage, give it a stable place in the stage order and memory plan.
+4. If the skill is only auxiliary, prefer `skill_role: companion` or `custom` rather than bloating the canonical stage chain.
+5. Remember that `SkillInstaller` mirrors skills into the active Codex/Claude projection trees. Keep paths and file names stable.
+
+#### Minimum test checklist
+
+- `tests/test_stage_skills.py`
+  - stage ordering and canonical skill availability
+- `tests/test_skill_contracts.py`
+  - frontmatter and skill contract expectations
+- `tests/test_prompt_builder.py`
+  - prompt builder output and visible skill path blocks
+
+### Add a connector
+
+Connectors have three distinct layers:
+
+1. config and validation
+2. inbound / outbound transport adaptation
+3. optional background runtime lifecycle
+
+For a simple connector, changing only one layer is usually not enough.
+
+#### Core files to inspect first
+
+- config defaults:
+  - `src/deepscientist/config/models.py`
+- config validation and live test behavior:
+  - `src/deepscientist/config/service.py`
+- connector profile support:
+  - `src/deepscientist/connector/connector_profiles.py`
+- inbound/outbound adaptation:
+  - `src/deepscientist/bridges/base.py`
+  - `src/deepscientist/bridges/connectors.py`
+  - `src/deepscientist/bridges/builtins.py`
+- channel delivery:
+  - `src/deepscientist/channels/base.py`
+  - `src/deepscientist/channels/builtins.py`
+- daemon lifecycle:
+  - `src/deepscientist/daemon/app.py`
+- API endpoints:
+  - `src/deepscientist/daemon/api/router.py`
+  - `src/deepscientist/daemon/api/handlers.py`
+- optional prompt fragment:
+  - `src/prompts/connectors/<connector>.md`
+
+#### Step-by-step connector checklist
+
+1. Add default config in `src/deepscientist/config/models.py`.
+   - If it is a system connector, add it to `SYSTEM_CONNECTOR_NAMES`.
+   - Add its default payload under `default_connectors()`.
+2. Add validation and config test behavior in `src/deepscientist/config/service.py`.
+   - validate required tokens, ids, transport, and live probe behavior
+3. Decide whether it is profileable.
+   - If yes, add a spec in `src/deepscientist/connector/connector_profiles.py`
+4. Add or extend a bridge in `src/deepscientist/bridges/connectors.py`.
+   - subclass `BaseConnectorBridge`
+   - implement inbound parsing and outbound formatting / delivery as needed
+5. Register the bridge in `src/deepscientist/bridges/builtins.py`.
+6. Register a channel in `src/deepscientist/channels/builtins.py`.
+   - use `GenericRelayChannel` when the standard relay flow is enough
+   - add a dedicated channel class only when the connector needs special outbound behavior
+7. If the connector needs a long-running runtime such as polling, gateway, QR session, or long connection:
+   - add the service class under `src/deepscientist/channels/`
+   - add daemon state fields in `DaemonApp.__init__`
+   - wire startup in `DaemonApp._start_background_connectors()`
+   - wire shutdown in `DaemonApp._stop_background_connectors()`
+8. If the connector needs custom web/API flows beyond the generic inbound route:
+   - update `src/deepscientist/daemon/api/router.py`
+   - update `src/deepscientist/daemon/api/handlers.py`
+9. If the connector needs connector-specific prompt behavior:
+   - add `src/prompts/connectors/<connector>.md`
+   - the prompt builder will load it automatically when the connector is active or bound
+10. Add user docs if it is a public connector.
+
+#### Connector rules
+
+1. Prefer the generic bridge/channel model. Do not special-case a connector inside unrelated quest logic.
+2. Keep transport adaptation in bridges and delivery/runtime behavior in channels.
+3. Do not add a connector-specific public MCP namespace.
+4. If the connector is public, keep route and status behavior consistent with the existing `/api/connectors/...` surface.
+5. If it is only a relay connector, try `GenericRelayChannel` first before writing a bespoke channel class.
+
+#### Minimum test checklist
+
+- `tests/test_connector_config_validation.py`
+  - config shape and required fields
+- `tests/test_connector_bridges.py`
+  - inbound parse and outbound formatting
+- connector-specific tests such as:
+  - `tests/test_telegram_connector.py`
+  - `tests/test_weixin_connector.py`
+  - `tests/test_qq_connector.py`
+  - `tests/test_whatsapp_local_session.py`
+  - or a new connector-specific test file
+- `tests/test_daemon_api.py`
+  - if new routes, status payloads, or connector availability behavior changed
+
+### Quick extension map
+
+Use this when you only need the shortest file-level reminder:
+
+- new MCP tool:
+  - `src/deepscientist/mcp/server.py`
+  - maybe `src/deepscientist/runners/codex.py`
+  - tests: `test_mcp_servers.py`
+- new skill:
+  - `src/skills/<skill_id>/SKILL.md`
+  - maybe `src/deepscientist/skills/registry.py`
+  - maybe `src/deepscientist/prompts/builder.py`
+  - tests: `test_stage_skills.py`, `test_skill_contracts.py`, `test_prompt_builder.py`
+- new connector:
+  - `src/deepscientist/config/models.py`
+  - `src/deepscientist/config/service.py`
+  - maybe `src/deepscientist/connector/connector_profiles.py`
+  - `src/deepscientist/bridges/*`
+  - `src/deepscientist/channels/*`
+  - maybe `src/deepscientist/daemon/app.py`
+  - maybe `src/prompts/connectors/<connector>.md`
+  - tests: connector validation + bridge + daemon/API coverage
+
 ## Documentation Rules
 
 When behavior changes:

package/docs/en/README.md

@@ -39,7 +39,9 @@ This page is the shortest path to the right document.
 - [05 TUI Guide](./05_TUI_GUIDE.md)
   Read this if your main surface is the terminal and you want one end-to-end path through `ds --tui`, quests, connectors, and cross-surface work.
 - [15 Codex Provider Setup](./15_CODEX_PROVIDER_SETUP.md)
-  Read this when you want to run DeepScientist through MiniMax, GLM, Volcengine Ark, Alibaba Bailian, or another Codex profile.
+  Read this when you want to run DeepScientist through MiniMax, GLM, Volcengine Ark, Alibaba Bailian Coding Plan, or another Codex profile.
+- [21 Local Model Backends Guide](./21_LOCAL_MODEL_BACKENDS_GUIDE.md)
+  Read this if you want to run DeepScientist through local OpenAI-compatible backends such as vLLM, Ollama, or SGLang.
 - [12 Guided Workflow Tour](./12_GUIDED_WORKFLOW_TOUR.md)
   Follow the real product flow from landing page to workspace, step by step.
 - [02 Start Research Guide](./02_START_RESEARCH_GUIDE.md)
@@ -90,6 +92,8 @@ This page is the shortest path to the right document.
   Start here for diagnostics and common runtime problems.
 - [15 Codex Provider Setup](./15_CODEX_PROVIDER_SETUP.md)
   Check this if the problem is likely in your Codex profile, provider endpoint, API key, or model configuration.
+- [21 Local Model Backends Guide](./21_LOCAL_MODEL_BACKENDS_GUIDE.md)
+  Check this if the problem is specifically about local OpenAI-compatible backends and whether they support `/v1/responses`.
 - [01 Settings Reference](./01_SETTINGS_REFERENCE.md)
   Check this if the problem is likely caused by config, credentials, or connector setup.
 
@@ -98,12 +102,12 @@ This page is the shortest path to the right document.
 - [90 Architecture](./90_ARCHITECTURE.md)
   High-level system contracts and repository structure.
 - [91 Development](./91_DEVELOPMENT.md)
-  Maintainer-facing workflow and implementation notes.
+  Maintainer-facing workflow, implementation notes, and the concrete checklists for adding MCP tools, skills, and connectors.
 
 ## Community
 
 Welcome to join the WeChat group for discussion.
 
 <p align="center">
-  <img src="../../assets/readme/wechat.jpg" alt="DeepScientist WeChat group" width="360" />
+  <img src="../../assets/readme/wechat4.jpg" alt="DeepScientist WeChat group" width="360" />
 </p>

package/docs/zh/00_QUICK_START.md

@@ -37,7 +37,7 @@
 
 - 安装好 Node.js `>=18.18` 和 npm `>=9`；请优先参考官方页面安装：https://nodejs.org/en/download
 - 一条已经可用的 Codex 路径：
-  - 默认 OpenAI 登录路径：`codex --login`（或 `codex`）
+  - 默认 OpenAI 登录路径：`codex login`（或直接运行 `codex`）
   - provider-backed 路径：一个已经可用的 Codex profile，例如 `minimax`、`glm`、`ark`、`bailian`
 - 模型或 API 凭证
 - 如果任务比较重，准备好 GPU 或远程服务器
@@ -47,6 +47,7 @@
 
 如果你还在选择合适的 Coding Plan / 订阅方案，可以先看这些官方页面：
 
+- 如果你只是想先有一个简单直接的推荐起点，优先从 GPT-5.4 + `xhigh` reasoning effort 开始；如果你更偏向 Google 路线，可以使用 Gemini 3 Pro，对应模型名 `gemini-3-pro-preview`。
 - ChatGPT 定价：https://openai.com/chatgpt/pricing/
 - ChatGPT Plus 帮助页：https://help.openai.com/en/articles/6950777-what-is-chatgpt-plus%3F.eps
 - MiniMax Coding Plan：https://platform.minimaxi.com/docs/guides/pricing-codingplan
@@ -54,6 +55,8 @@
 - 阿里百炼 Coding Plan：https://help.aliyun.com/zh/model-studio/coding-plan
 - 火山引擎 Ark Coding Plan：https://www.volcengine.com/docs/82379/1925115?lang=zh
 
+如果你要通过阿里百炼使用 Qwen，请只使用百炼 **Coding Plan** endpoint。普通百炼 / DashScope 平台的 Qwen API，不在当前 Codex-backed DeepScientist 支持范围内。
+
 如果你准备使用 provider-backed 的 Codex profile，而不是默认 OpenAI 登录流，请继续看：
 
 - [15 Codex Provider 配置](./15_CODEX_PROVIDER_SETUP.md)
@@ -89,7 +92,7 @@ npm install -g @openai/codex
 
 ```bash
 which codex
-codex --login
+codex login
 ```
 
 如果 `which codex` 没有输出，问题通常不是 DeepScientist 本身，而是 npm 全局 bin 目录没有正确进入 shell 的 PATH。先修复 PATH，再重新执行 `npm install -g @openai/codex`。
@@ -111,10 +114,10 @@ ds latex install-runtime
 运行：
 
 ```bash
-codex --login
+codex login
 ```
 
-如果你的 Codex CLI 版本没有 `--login`，就运行：
+如果你更喜欢交互式首次配置，就运行：
 
 ```bash
 codex
@@ -130,7 +133,7 @@ ds doctor
 
 ### 2.2 provider-backed 的 Codex profile 路径
 
-如果你已经在 MiniMax、GLM、火山方舟、阿里百炼或其他 provider 上配置了一个命名的 Codex profile，请先在终端里确认这个 profile 本身可用：
+如果你已经在 MiniMax、GLM、火山方舟、阿里百炼 Coding Plan 或其他 provider 上配置了一个命名的 Codex profile，请先在终端里确认这个 profile 本身可用：
 
 ```bash
 codex --profile m27
@@ -204,6 +207,19 @@ ds --here
 
 它等价于 `ds --home "$PWD/DeepScientist"`。
 
+重要提醒：
+
+- 如果你是通过 `ds --here` 或显式的 `--home <path>` 启动 DeepScientist，后续像 `ds --status`、`ds --stop` 这样的管理命令，也应该使用同一个 DeepScientist home
+- 如果你是通过 `DEEPSCIENTIST_HOME` 或 `DS_HOME` 环境变量固定 home，只要后续命令继续使用同一个环境变量配置，也可以
+- 否则 CLI 可能会回退到默认的 `~/DeepScientist`，从而把一个实际上可访问的 daemon 误判成“不是当前 home 下的受管 daemon”
+
+例如，当你使用的是非默认 home 时，应这样执行：
+
+```bash
+ds --status --home /path/to/DeepScientist
+ds --stop --home /path/to/DeepScientist
+```
+
 如果你想换一个端口，可以运行：
 
 ```bash
@@ -434,6 +450,39 @@ ds --stop
 
 这会停止当前本地 DeepScientist daemon。
 
+卸载代码和运行时，但保留本地数据：
+
+```bash
+ds uninstall
+```
+
+如果你使用的是非默认 home，可以显式指定：
+
+```bash
+ds uninstall --home /path/to/DeepScientist --yes
+```
+
+这会删除 launcher wrapper、本地运行时代码，以及 install-local 安装树，但会保留：
+
+- `quests/`
+- `memory/`
+- `config/`
+- `logs/`
+- `plugins/`
+- `cache/`
+
+如果你是通过 npm 安装的，并且还想把全局 npm 包本体一起移除，请在 `ds uninstall` 之后再执行：
+
+```bash
+npm uninstall -g @researai/deepscientist
+```
+
+如果你真的想把本地数据一起删掉，请在卸载后手动删除 DeepScientist home：
+
+```bash
+rm -rf /path/to/DeepScientist
+```
+
 运行诊断：
 
 ```bash

package/docs/zh/01_SETTINGS_REFERENCE.md

@@ -479,7 +479,7 @@ claude:
 - `Test` 行为：检查该二进制是否在 `PATH` 上。
 - `codex` 的解析顺序：环境变量覆盖、显式路径、本机 `PATH`、最后才是 bundled fallback。
 - 临时使用说明：你也可以直接用 `ds --codex /absolute/path/to/codex` 临时覆盖这里的设置。
-- 首次使用说明：DeepScientist 不会替你完成 Codex 认证。第一次运行 `ds` 前，必须先确保 `codex --login`（或 `codex`）已经成功完成。
+- 首次使用说明：DeepScientist 不会替你完成 Codex 认证。第一次运行 `ds` 前，必须先确保 `codex login`（或直接运行 `codex`）已经成功完成。
 - 修复说明：如果执行 `npm install -g @researai/deepscientist` 之后 bundled Codex 依赖仍然缺失，请显式安装 `npm install -g @openai/codex`。
 
 **`config_dir`**

package/docs/zh/09_DOCTOR.md

@@ -15,7 +15,7 @@
    默认 OpenAI 路径：
 
    ```bash
-   codex --login
+   codex login
    ```
 
    provider-backed profile 路径：
@@ -30,7 +30,7 @@
    npm install -g @openai/codex
    ```
 
-   如果你的 Codex CLI 版本没有 `--login`，就运行 `codex` 并在交互式界面里完成认证。
+   如果你更喜欢交互式首次配置，就运行 `codex` 并在交互式界面里完成认证。
 
 3. 先直接尝试启动：
 
@@ -57,10 +57,18 @@
 - 必需配置文件是否有效
 - 当前开源版本是否仍然使用 `codex` 作为可运行 runner
 - Codex CLI 是否存在并通过启动探测
+- 最近一次 quest 真实运行失败是否已经能指向已知的 provider / 协议 / retry 问题
 - 是否已经具备可选的本地 `pdflatex` 运行时，以便编译论文 PDF
 - Web / TUI bundle 是否存在
 - 当前 Web 端口是否空闲，或者是否已运行正确的 daemon
 
+现在 `ds doctor` 会尽量把失败项渲染成更可执行的结构：
+
+- `Problem`：出了什么问题
+- `Why`：为什么系统认为它是这个问题
+- `Fix`：现在应该先做什么修复动作
+- `Evidence`：命中的 quest/run/request 线索
+
 ## 常见修复方式
 
 ### 没有安装 Codex
@@ -82,10 +90,10 @@ npm install -g @openai/codex
 运行：
 
 ```bash
-codex --login
+codex login
 ```
 
-如果你的 Codex CLI 版本没有 `--login`，就运行 `codex` 并在交互式界面里完成认证。
+如果你更喜欢交互式首次配置，就运行 `codex` 并在交互式界面里完成认证。
 
 先完成一次登录，再重新执行 `ds doctor`。
 
@@ -111,6 +119,7 @@ ds --codex /absolute/path/to/codex --codex-profile m27
 
 - 启动 DeepScientist 的这个 shell 中，provider API key 仍然可见
 - 该 profile 指向的是 provider 的 Coding Plan endpoint，而不是普通通用 API endpoint
+- 如果你走的是阿里百炼上的 Qwen，只能使用百炼 Coding Plan endpoint；普通百炼 / DashScope 平台的 Qwen API 这里不支持
 - 如果模型应该由 profile 自己决定，请在 `~/DeepScientist/config/runners.yaml` 中使用 `model: inherit`
 
 MiniMax 补充说明：
@@ -127,6 +136,8 @@ MiniMax 补充说明：
 - 当 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`
+- 如果 provider 返回 `tool call result does not follow tool call (2013)`，应优先把它当作 tool call / tool result 顺序错误，而不是普通网络抖动
+- 如果 provider 返回 `invalid function arguments json string` 或 `failed to parse tool call arguments` 这类错误，应该先修正 tool 调用串行化/参数编码路径，再继续重试
 
 ### 当前配置的 Codex 模型不可用
 

package/docs/zh/15_CODEX_PROVIDER_SETUP.md

@@ -2,6 +2,8 @@
 
 DeepScientist 不会为 MiniMax、GLM、火山方舟、阿里百炼单独实现一套 provider 适配器。
 
+如果你要使用阿里百炼上的 Qwen，需要特别注意：DeepScientist 只支持 **Coding Plan** 这条路径，不支持普通百炼 / DashScope 平台的 Qwen API。
+
 它复用的是你本机已经能正常工作的 Codex CLI 配置。
 
 推荐顺序始终是：
@@ -18,7 +20,7 @@ DeepScientist 不会为 MiniMax、GLM、火山方舟、阿里百炼单独实现
 如果你的 Codex CLI 走的是标准 OpenAI 登录流，就用这一条。
 
 ```bash
-codex --login
+codex login
 ds doctor
 ds
 ```
@@ -63,6 +65,7 @@ codex:
 - 对 provider-backed 的 Codex profile，建议优先使用 `model: inherit`
 - 除非你非常确定该 provider 接受你要显式传入的模型名，否则不要再额外硬写一个模型
 - DeepScientist 现在会在 `.ds/codex-home` 下启动一个隔离的运行时 home，但会先继承你配置的 `~/.codex` 里的 auth、config、skills、agents 与 prompts
+- 如果当前生效 provider 使用的是 `wire_api = "chat"`，DeepScientist 现在会在启动探测时自动检查所选 Codex binary 是否正好是 `0.57.0`
 
 ## Provider 一览
 
@@ -72,14 +75,14 @@ codex:
 | 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 |
+| 阿里百炼 | [百炼 Coding Plan：其他工具](https://help.aliyun.com/zh/model-studio/other-tools-coding-plan) | 否 | 使用一个指向 Bailian Coding Plan endpoint 的 Codex profile；不要使用普通百炼 / DashScope Qwen API |
 
 ## OpenAI
 
 ### 需要准备什么
 
 - 正常安装的 Codex CLI
-- 已成功执行过一次 `codex --login`，或者在 `codex` 交互界面里完成首次认证
+- 已成功执行过一次 `codex login`，或者在 `codex` 交互界面里完成首次认证
 
 ### DeepScientist 命令
 
@@ -202,6 +205,7 @@ DeepScientist 现在对它的支持方式是：
 - 如果你使用的是这类 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`
+- 对 MiniMax 这类 `Codex CLI 0.57.0 + wire_api = \"chat\"` 的会话，DeepScientist 现在会额外注入一个兼容约束，明确要求 Codex 把 MCP 工具调用串行化，一次只发一个 tool call，而不是把多个 tool call 打包进同一轮回复
 - 这意味着即使终端里原样执行 `codex --profile m27` 还会失败，DeepScientist 也可以先兼容跑起来
 
 如果你还希望终端里的 `codex --profile <name>` 也直接可用，请使用显式顶层兼容写法：
@@ -351,6 +355,11 @@ codex:
 
 阿里百炼的 Coding Plan 官方文档也是 OpenAI-compatible endpoint 路径。它特别强调：必须使用 Coding Plan 专属 key 和 endpoint，而不是普通平台 endpoint。
 
+对 Qwen 这条路径，需要额外记住：
+
+- 支持：走百炼 **Coding Plan** 的 Qwen
+- 不支持：普通百炼 / DashScope 平台的 Qwen API
+
 官方文档：
 
 - <https://help.aliyun.com/zh/model-studio/other-tools-coding-plan>