@researai/deepscientist 1.5.17 → 1.6.0

package/docs/zh/01_SETTINGS_REFERENCE.md

@@ -17,7 +17,7 @@
 | 文件 | 页面分类 | 作用 |
 | --- | --- | --- |
 | `~/DeepScientist/config/config.yaml` | Runtime | 运行时主配置：主目录、daemon、UI、日志、Git、技能同步、云链接、ACP 等 |
-| `~/DeepScientist/config/runners.yaml` | Models | Runner 配置：`codex` / `claude` 的二进制、模型、审批策略、沙箱与重试策略 |
+| `~/DeepScientist/config/runners.yaml` | Models | Runner 配置：`codex` / `claude` / `kimi` / `opencode` 的二进制、模型默认值、权限/沙箱、重试与环境变量 |
 | `~/DeepScientist/config/connectors.yaml` | Connectors | QQ、Telegram、Discord、Slack、Feishu、WhatsApp、Lingzhu 等连接器配置 |
 | `~/DeepScientist/config/plugins.yaml` | Extensions | 插件发现、启用、禁用与信任策略 |
 | `~/DeepScientist/config/mcp_servers.yaml` | MCP | 外部 MCP 服务，不包含内置 `memory`、`artifact`、`bash_exec` |
@@ -109,11 +109,11 @@ acp:
 
 - 类型：`string`
 - 默认值：`codex`
-- 允许值：当前页面预设为 `codex`、`claude`
+- 允许值：`codex`、`claude`、`kimi`、`opencode`
 - 页面标签：`Default runner`
 - 作用：当项目没有单独覆盖 runner 时，默认走这里指定的 runner。
 - 何时修改：只有在你真的接通并启用了其他 runner 时才需要改。
-- 注意事项：当前仓库的真实主路径仍然是 `codex`；`claude` 仍是预留位。
+- 注意事项：新 quest 会继承这里的默认值；已有 quest 可以在项目设置里单独覆盖。只有当目标 runner 已启用并通过 `ds doctor` 时再切换。
 
 **`default_locale`**
 
@@ -200,6 +200,37 @@ acp:
 - 页面标签：`Default start mode`
 - 作用：决定 `ds` 默认打开 Web、TUI，或两者同时打开。
 
+### TUI debug 启动开关
+
+TUI debug 不是持久配置项，而是一次性启动级诊断开关。它用于检查当前 TUI surface、输入路由、Web 对照页和渲染摘要。
+
+启动方式：
+
+```bash
+ds --tui --debug
+ds --tui --debug --debug-log /tmp/deepscientist_tui_debug.jsonl
+```
+
+环境变量：
+
+- `TUI_DEBUG=1`
+- `DEEPSCIENTIST_TUI_DEBUG=1`
+- `TUI_DEBUG_LOG=/tmp/deepscientist_tui_debug.jsonl`
+- `DEEPSCIENTIST_TUI_DEBUG_LOG=/tmp/deepscientist_tui_debug.jsonl`
+
+默认日志路径：
+
+```text
+/tmp/deepscientist_tui_debug.jsonl
+```
+
+安全要求：
+
+- config editor buffer、password/secret/token 字段会在 debug JSONL 中脱敏。
+- debug JSONL 可以附到 issue 或回归报告里，但仍建议先搜索确认没有真实 token。
+- 终端录屏、tmux 日志或 `script` transcript 会捕获真实屏幕内容，不属于 debug JSONL 脱敏范围。
+- Web 端目前没有同级 `?debug=1` inspector；TUI 只提供 `web_analog` 对照。
+
 ### Logging
 
 **`logging.level`**
@@ -427,10 +458,32 @@ acp:
 
 ### 摘要
 
-`runners.yaml` 定义项目实际由哪个 runner 执行，以及 runner 的模型默认值、审批策略、沙箱策略和失败重试策略。在当前开源版本中：
+`runners.yaml` 定义 DeepScientist 实际调用哪个 CLI runner、默认模型怎么选、失败后如何重试，以及不同 runner 的专属透传参数。
+
+当前内建 runner 有四种：
+
+- `codex`
+  - OpenAI Codex CLI 路径，也包括已经在 Codex 里配置好的 provider-backed profile
+- `claude`
+  - Claude Code CLI 路径，也包括已经能在 Claude Code 里工作的 Anthropic 或兼容网关配置
+- `kimi`
+  - 官方 Kimi Code CLI 路径，也包括已经在 `~/.kimi` 中工作的登录态和配置
+- `opencode`
+  - OpenCode CLI 路径，也包括直接在 OpenCode 里管理的 provider/model 配置
 
-- `codex`：主路径，默认启用。
-- `claude`：TODO / 预留条目，默认禁用，暂时不能运行。
+Settings 页面只负责把 DeepScientist 映射到一个已经可用的 CLI runner。Gemini、Ollama、MiniMax、GLM、百炼等 provider 的详细接入仍然先在对应 CLI 中完成：
+
+- Codex provider / profile：见 [15 Codex Provider 配置](./15_CODEX_PROVIDER_SETUP.md)
+- Claude Code / Anthropic-compatible / Ollama：见 [24 Claude Code 配置指南](./24_CLAUDE_CODE_PROVIDER_SETUP.md)
+- OpenCode / Gemini / Ollama：见 [25 OpenCode 配置指南](./25_OPENCODE_PROVIDER_SETUP.md)
+- vLLM、Ollama、SGLang 等本地模型后端总览：见 [21 本地模型后端指南](./21_LOCAL_MODEL_BACKENDS_GUIDE.md)
+
+推荐验证顺序永远是：
+
+1. 先让底层 CLI 自己能跑通，例如 `codex exec ...`、`claude -p ...`、`opencode run ...`
+2. 再在 Settings 里填写 `binary`、`config_dir`、`profile` / `model` 和 `env`
+3. 点击 `Test` 或运行 `ds doctor --runner <name>`
+4. 最后再启动真实 quest
 
 ### 结构
 
@@ -440,25 +493,63 @@ codex:
   binary: codex
   config_dir: ~/.codex
   profile: ""
-  model: gpt-5.4
+  model: inherit
   model_reasoning_effort: xhigh
   approval_policy: never
   sandbox_mode: danger-full-access
   retry_on_failure: true
-  retry_max_attempts: 5
-  retry_initial_backoff_sec: 1.0
-  retry_backoff_multiplier: 2.0
-  retry_max_backoff_sec: 8.0
-  mcp_tool_timeout_sec: 180000
+  retry_max_attempts: 7
+  retry_initial_backoff_sec: 10.0
+  retry_backoff_multiplier: 6.0
+  retry_max_backoff_sec: 1800.0
+  mcp_tool_timeout_sec: 172800
   env: {}
 claude:
   enabled: false
   binary: claude
   config_dir: ~/.claude
   model: inherit
-  model_reasoning_effort: ""
+  permission_mode: bypassPermissions
+  mcp_timeout_ms: 172800000
+  mcp_tool_timeout_ms: 172800000
+  retry_on_failure: true
+  retry_max_attempts: 4
+  retry_initial_backoff_sec: 10.0
+  retry_backoff_multiplier: 4.0
+  retry_max_backoff_sec: 600.0
+  env: {}
+  status: supported
+kimi:
+  enabled: false
+  binary: kimi
+  config_dir: ~/.kimi
+  model: inherit
+  agent: ""
+  thinking: false
+  yolo: true
+  mcp_tool_timeout_ms: 172800000
+  retry_on_failure: true
+  retry_max_attempts: 4
+  retry_initial_backoff_sec: 10.0
+  retry_backoff_multiplier: 4.0
+  retry_max_backoff_sec: 600.0
+  env: {}
+  status: supported
+opencode:
+  enabled: false
+  binary: opencode
+  config_dir: ~/.config/opencode
+  model: inherit
+  default_agent: ""
+  variant: ""
+  mcp_timeout_ms: 172800000
+  retry_on_failure: true
+  retry_max_attempts: 4
+  retry_initial_backoff_sec: 10.0
+  retry_backoff_multiplier: 4.0
+  retry_max_backoff_sec: 600.0
   env: {}
-  status: reserved_todo
+  status: supported
 ```
 
 ### 页面可编辑字段
@@ -466,156 +557,186 @@ claude:
 **`enabled`**
 
 - 类型：`boolean`
-- 默认值：`codex=true`，`claude=false`
 - 页面标签：`Enabled`
-- 作用：决定这个 runner 是否可被选中与实际执行。
+- 作用：这个 runner 是否可被选中与执行。
+- 实际建议：只有当对应 CLI binary 和认证路径已经在这台机器上跑通时再启用。
 
 **`binary`**
 
 - 类型：`string`
-- 默认值：`codex` 或 `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`。
+- 默认值：
+  - `codex -> codex`
+  - `claude -> claude`
+  - `opencode -> opencode`
+- `Test` 行为：检查该 binary 是否真的存在于 `PATH` 或显式路径上。
 
 **`config_dir`**
 
 - 类型：`string`
-- 默认值：`~/.codex` 或 `~/.claude`
 - 页面标签：`Config directory`
-- 作用：runner 的全局配置目录，通常存放认证和全局配置。
+- 作用：runner 的全局配置目录，通常存放认证和全局设置。
+- 默认值：
+  - `codex -> ~/.codex`
+  - `claude -> ~/.claude`
+  - `kimi -> ~/.kimi`
+  - `opencode -> ~/.config/opencode`
 
 **`profile`**
 
 - 类型：`string`
-- 默认值：`""`
 - 页面标签：`Codex profile`
-- 作用：可选的 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>`。
+- 适用 runner：`codex`
+- 作用：可选的 Codex profile，会透传成 `codex --profile <name>`。
+- 适用场景：你已经在 Codex 自己那里配置好了 provider-backed profile。
 
 **`model`**
 
 - 类型：`string`
-- 默认值：`codex=gpt-5.4`，`claude=inherit`
 - 页面标签：`Default model`
-- 作用：项目和单次请求没有覆盖时的默认模型。
-- 启动说明：DeepScientist 的 Codex 就绪探测会优先使用这里配置的模型。如果你的 Codex 账号无法访问它，DeepScientist 会自动回退到当前 Codex 默认模型，并持久化为 `model: inherit`。
-- provider-profile 说明：当 `profile` 已设置时，通常推荐使用 `model: inherit`，让 Codex profile 自己决定 provider 侧模型。
+- 作用：当 quest 或单次请求没有覆盖时，默认使用哪个模型。
+- 默认值：四个 runner 都是 `inherit`。
+- 推荐规则：
+  - 如果希望 CLI 自己决定 provider/model，就保持 `inherit`
+  - 只有在你明确要让 DeepScientist 每次 turn 都强制指定模型时，才写死
 
 **`model_reasoning_effort`**
 
 - 类型：`string`
-- 默认值：`codex=xhigh`
 - 页面标签：`Reasoning effort`
+- 适用 runner：`codex`
+- 作用：Codex 默认推理强度。
 - 允许值：`""`、`minimal`、`low`、`medium`、`high`、`xhigh`
-- 作用：默认推理强度。
-- 推荐：当前仓库的 Codex 默认就是 `xhigh`。
-- 兼容性说明：当 DeepScientist 检测到 Codex CLI 低于 `0.63.0` 时，会在启动探测和实际 runner 命令里自动把 `xhigh` 降级成 `high`。这也覆盖了 MiniMax 当前推荐的 `@openai/codex@0.57.0` 路径。
 
 **`approval_policy`**
 
 - 类型：`string`
-- 默认值：`never`
 - 页面标签：`Approval policy`
+- 适用 runner：`codex`
+- 作用：Codex 的高权限审批策略。
 - 允许值：`never`、`on-failure`、`on-request`、`untrusted`
-- 作用：控制高权限动作如何申请许可。
-- 运行说明：launcher 现在默认以 YOLO 模式启动 Codex。若要临时关闭，可显式传 `ds --yolo false`，这会恢复到 `approval_policy=on-request` 与 `sandbox_mode=workspace-write`。
 
 **`sandbox_mode`**
 
 - 类型：`string`
-- 默认值：`danger-full-access`
 - 页面标签：`Sandbox mode`
+- 适用 runner：`codex`
+- 作用：Codex 的文件系统 / 进程沙箱模式。
 - 允许值：`read-only`、`workspace-write`、`danger-full-access`
-- 作用：控制 runner 的文件系统/进程访问权限。
 
-**`env`**
+**`permission_mode`**
 
-- 类型：`mapping<string, string>`
-- 默认值：`{}`
-- 页面入口：
-  - 全局设置：可在 `runners` 结构化表单中直接编辑 `env`
-  - 项目设置：`Project settings -> Codex environment`
-- 项目设置行为：
-  - 点击 `Add` 新增一行环境变量
-  - 默认会显示 `OPENAI_BASE_URL` 和 `OPENAI_API_KEY`
-  - 修改后不会自动保存，需要手动点击 `Save env vars`
-  - 空值会被忽略，不会注入到 Codex 进程
-- 作用：DeepScientist 启动 Codex run 时，额外传入给 Codex 的环境变量。
-- 常见用途：需要 API Key 或自定义 Base URL 的 provider-backed Codex 配置。
-
-**`retry_on_failure`**
-
-- 类型：`boolean`
-- 默认值：`true`
-- 页面标签：`Retry on failure`
-- 作用：遇到失败时是否自动重试当前 turn。
+- 类型：`string`
+- 页面标签：`Permission mode`
+- 适用 runner：`claude`
+- 作用：Claude Code 的 `--permission-mode`。
+- 常见值：`default`、`bypassPermissions`、`dontAsk`、`acceptEdits`、`delegate`、`plan`
+- 本地自动化的推荐默认值：`bypassPermissions`
 
-**`retry_max_attempts`**
+**`mcp_timeout_ms`**
 
 - 类型：`number`
-- 默认值：`5`
-- 页面标签：`Max attempts`
-- 作用：一个 turn 的最大尝试次数上限。
-- 注意事项：DeepScientist 运行时会把该值硬限制在最多 `5`。
+- 适用 runner：`claude`、`opencode`
+- 作用：
+  - `claude`：MCP server 启动超时，会透传为 `MCP_TIMEOUT`
+  - `opencode`：启动时从每个 MCP server 拉取 tools 的超时
+- 说明：OpenCode 的 `mcp_timeout_ms` 不是工具执行超时。
 
-**`retry_initial_backoff_sec`**
+**`mcp_tool_timeout_ms`**
 
 - 类型：`number`
-- 默认值：`1.0`
-- 页面标签：`Initial backoff (s)`
-- 作用：第一次重试前等待多久。
+- 适用 runner：`claude`、`kimi`
+- 作用：
+  - `claude`：单次 MCP 工具超时，会透传为 `MCP_TOOL_TIMEOUT`
+  - `kimi`：MCP 工具执行超时，会写入 `.kimi/config.toml` 的 `mcp.client.tool_call_timeout_ms`
 
-**`retry_backoff_multiplier`**
+**`agent`**
 
-- 类型：`number`
-- 默认值：`2.0`
-- 页面标签：`Backoff multiplier`
-- 作用：指数退避倍数。例如 `1s -> 2s -> 4s -> 8s`。
+- 类型：`string`
+- 页面标签：`Kimi agent`
+- 适用 runner：`kimi`
+- 作用：可选的 Kimi agent，会透传成 `kimi --agent <name>`。
+- 只有当相同 agent 名在你直接运行 Kimi CLI 时已经确认有效，再填写这里。
 
-**`retry_max_backoff_sec`**
+**`thinking`**
 
-- 类型：`number`
-- 默认值：`8.0`
-- 页面标签：`Max backoff (s)`
-- 作用：指数退避增长后的最大等待时间上限。
+- 类型：`boolean`
+- 页面标签：`Thinking mode`
+- 适用 runner：`kimi`
+- 作用：是否默认给 Kimi 追加 `--thinking`。
 
-**`status`**
+**`yolo`**
+
+- 类型：`boolean`
+- 页面标签：`Yolo mode`
+- 适用 runner：`kimi`
+- 作用：是否默认给 Kimi 追加 `--yolo`，让它不要停下来等待交互式确认。
+- 本地无人值守自动化的推荐默认值：`true`
+
+**`default_agent`**
 
 - 类型：`string`
-- 默认值：`claude=reserved_todo`
-- 页面标签：`Status note`
-- 作用：写给操作者的备注，例如 `reserved_todo`、`experimental`、`disabled_by_policy`。
+- 页面标签：`Default agent`
+- 适用 runner：`opencode`
+- 作用：可选的 OpenCode agent，会透传成 `opencode run --agent <name>`。
+- 只有当相同 agent 名在你直接运行 OpenCode CLI 时已经确认有效，再填写这里。
 
-### 配置文件补充字段
+**`variant`**
+
+- 类型：`string`
+- 页面标签：`Variant`
+- 适用 runner：`opencode`
+- 作用：可选的 OpenCode provider-specific `--variant`。
+- 只有你的 OpenCode provider 官方明确支持时才填写。
 
-这些字段存在于 `runners.yaml`，但不一定都在页面上显式强调。
+**`env`**
+
+- 类型：`mapping<string, string>`
+- 页面标签：`Environment variables`
+- 作用：只对该 runner 注入的额外环境变量。
+- 常见示例：
+  - Codex：`OPENAI_API_KEY`、`OPENAI_BASE_URL`
+  - Claude：`ANTHROPIC_API_KEY`、`ANTHROPIC_BASE_URL`、`CLAUDE_CODE_MAX_OUTPUT_TOKENS`
+  - Kimi：通常保持为空；只有你的本地 Kimi CLI 路径明确需要额外环境变量时再填写
+  - OpenCode：只有当你的 OpenCode provider 配置需要额外环境变量时才填写
+
+**`retry_on_failure` / `retry_max_attempts` / `retry_initial_backoff_sec` / `retry_backoff_multiplier` / `retry_max_backoff_sec`**
+
+- 类型：`boolean` / `number`
+- 作用：runner 的自动重试策略。
+- 默认差异：
+  - `codex` 的退避更激进
+  - `claude` / `kimi` / `opencode` 的默认梯度更短
 
 **`mcp_tool_timeout_sec`**
 
 - 类型：`number`
-- 默认值：`180000`
-- 作用：允许 runner 等待较长时间的 MCP 工具调用，例如耗时较久的 `bash_exec(await)`。
+- 适用 runner：`codex`
+- 作用：MCP 工具最大等待时间，主要针对长时间 `bash_exec`。
 
-**`env`**
+**`status`**
 
-- 类型：`mapping[string, string]`
-- 默认值：`{}`
-- 页面位置：Runner 卡片底部的环境变量编辑器。
-- 作用：只对该 runner 注入的环境变量覆盖。
+- 类型：`string`
+- 作用：写给操作者的备注。
+- 当前实际含义：
+  - `codex`、`claude`、`kimi`、`opencode`：可用的内建路径
 
 ### 常见建议
 
-- 第一版部署一般保持 `codex.enabled: true`、`claude.enabled: false`。
-- 当前版本不要把 `default_runner` 从 `codex` 改走。
-- 如果你不希望任何自动审批，才把 `approval_policy` 调成更严格模式。
-- 如果项目经常需要长时间工具调用，不要随意把 `mcp_tool_timeout_sec` 改小。
+- 优先选择你本机已经跑通、也最符合当前 provider 配置的 runner。
+- 如果你想走最稳妥路径，用 `codex`。
+- 如果 Claude Code 在本机已经直接可用，且你希望走 Anthropic / Claude 原生路径，用 `claude`。
+- 如果官方 Kimi Code CLI 在本机已经直接可用，且你希望走独立的 Moonshot 原生路径，用 `kimi`。
+- 如果你的 provider/model 组合在 OpenCode 里已经工作最好，用 `opencode`。
+- 现在可以安全把 `default_runner` 从 `codex` 切走，只要目标 runner 已启用并且能通过 `ds doctor`。
+- 新 quest 会跟随 `config.default_runner`。
+- 老 quest 可以在项目设置里单独覆盖 runner。
+- 如果工作流依赖长时间 `bash_exec`，不要随意把 `mcp_tool_timeout_sec` 调小。
+- 对 Kimi 来说，更关键的是 `mcp_tool_timeout_ms`，因为上游默认值比 DeepScientist 常见的长时间 `bash_exec` 等待要短得多。
+- 对 Claude 来说，默认单工具超时已经很大；更常见的问题是 MCP server 启动超时，可以用 `mcp_timeout_ms` 调整。
+- 对 OpenCode 来说，`mcp_timeout_ms` 只影响 MCP 工具发现 / 启动，不影响单次 MCP 调用执行时长。
+
 
 ## `connectors.yaml`
 

package/docs/zh/02_START_RESEARCH_GUIDE.md

@@ -67,12 +67,14 @@ https://arxiv.org/abs/2602.00428
 
 `Runtime constraints`
 
+下面这段只是教程参考，不是 DeepScientist 的默认端点配置。粘贴前请把端点、API key 和模型名替换成你自己的真实运行时。
+
 ```text
 - Keep the task definition and evaluation protocol aligned with the official baseline unless a change is explicitly justified.
-- Use two OpenAI-compatible local inference endpoints for throughput:
-  - `http://127.0.0.1:8004/v1`
-  - `http://127.0.0.1:8008/v1`
-- Use API key `1234` and model `/model/gpt-oss-120b` on both endpoints.
+- Use two OpenAI-compatible inference endpoints for throughput:
+  - `http://127.0.0.1:<port-a>/v1`
+  - `http://127.0.0.1:<port-b>/v1`
+- Use your actual API key `<YOUR_API_KEY>` and model `<YOUR_MODEL>` on both endpoints.
 - Keep generation settings close to the baseline unless a justified adjustment is required.
 - Implement asynchronous execution, automatic retry on request failure, and resumable scripts.
 - Split requests across both endpoints so throughput stays high without overloading the service.
@@ -93,7 +95,7 @@ https://arxiv.org/abs/2602.00428
 如果 `Reusable baseline` 留空，且 `Research intensity` 选择 `Balanced`，当前前端会自动推导：
 
 - `scope = baseline_plus_direction`
-- `baseline_mode = restore_from_url`
+- `baseline_mode = auto`
 - `resource_policy = balanced`
 - `time_budget_hours = 24`
 - `git_strategy = semantic_head_plus_controlled_integration`
@@ -147,6 +149,18 @@ type StartResearchTemplate = {
 
 这几项已经不再由用户逐个填写，而是由 `research_intensity` 和是否选中 `baseline_id` 自动推导。
 
+现在还新增了 3 个显式启动控制项：
+
+- `baseline_source_mode`
+- `execution_start_mode`
+- `baseline_acceptance_target`
+
+它们不是替代自动推导字段，而是更强的用户侧路线偏好，用来告诉 agent：
+
+- baseline 应优先验证本地已有系统、附着可复用 baseline、从源码复现、修复已有 baseline，还是先别把 baseline 当前置主线
+- 是否应先输出一个有边界的计划并等待批准，再进入重型执行
+- baseline 至少要达到什么强度，quest 才应该进入 idea 与 experiment
+
 ### 自动推导字段
 
 ```ts
@@ -330,6 +344,12 @@ type StartResearchContractFields = {
 - `user_gated`
   - 只有真正依赖用户偏好时，才允许阻塞式决策请求
 
+等待状态可见性：
+
+- 当运行时有意停驻 quest 时，Studio 会显示 **等待反馈** 横幅，已绑定 connector 也会收到对应提醒。
+- 如果 `decision_policy=autonomous`，paper bundle checkpoint 这类普通等待状态会被自动转换回继续执行，并以 **自动继续** 形式显式提示，而不是静默阻塞。
+- 真正需要用户输入的情况仍可在 autonomous 模式下等待，例如凭据、隐私/数据外发边界、高额外部成本或最终任务完成审批。
+
 关于 workspace mode 的实际含义：
 
 - DeepScientist 还会区分用户导向的 `copilot` 模式和默认的 `autonomous` 模式。
@@ -427,6 +447,7 @@ type StartResearchContractFields = {
 额外规则：
 
 - 如果选中了 `baseline_id`，推导得到的 `baseline_mode` 会强制变成 `existing`
+- 如果显式设置了 `baseline_source_mode`，应把它当作更强的路线偏好，而把 `baseline_mode` 视为较粗粒度的推导摘要
 
 ## Prompt 编译行为