@researai/deepscientist 1.5.14 → 1.5.16

package/docs/en/20_WORKSPACE_MODES_GUIDE.md

@@ -0,0 +1,250 @@
+# 20 Workspace Modes Guide: Copilot vs Autonomous
+
+This page explains the two normal project-start modes in DeepScientist:
+
+- `Copilot`
+- `Autonomous`
+
+Use this when:
+
+- you are about to create a new project
+- you are unsure which launch mode to choose
+- you want to understand why one project waits for you while another starts moving immediately
+
+If you only want the shortest install-and-launch path, read [00 Quick Start](./00_QUICK_START.md) first.
+
+If you want the exact startup payload and form field contract, read [02 Start Research Guide](./02_START_RESEARCH_GUIDE.md) after this page.
+
+## 1. One-sentence summary
+
+- `Copilot`: quiet start, user-directed, stops after the current requested unit unless you ask it to continue
+- `Autonomous`: standard DeepScientist, keeps pushing the quest forward on its own
+
+## 2. Where You Choose This
+
+On the home / projects surface, start a new project and then choose the start style:
+
+- `Copilot Mode`
+- `Autonomous Mode`
+
+Current UI wording may appear in two layers:
+
+- outer launcher step: `Start Research` or `Start Experiment`
+- mode picker title: `Choose the start style`
+
+After that choice, the two flows diverge.
+
+## 3. Copilot Mode
+
+### 3.1 What it is
+
+Copilot mode is the user-directed workspace.
+
+It is for cases where you want DeepScientist to help actively, but you still want to steer each unit of work:
+
+- inspect a repo
+- read a paper
+- debug code
+- design an experiment
+- check a running process
+- rewrite a section
+- summarize a result
+
+The system should not assume that one request means “run the whole autonomous research loop”.
+
+### 3.2 What happens after creation
+
+After you create a Copilot project:
+
+- the project is created
+- the quest stays idle
+- the agent waits for your first real instruction
+
+In practical terms:
+
+- there is no immediate autonomous launch
+- no baseline / experiment / writing loop starts just because the project exists
+- the first substantial action begins when you send the first message
+
+### 3.3 Continuation behavior
+
+Copilot mode is intentionally conservative about continuation.
+
+After the current requested unit is complete, DeepScientist should normally:
+
+- summarize what changed
+- preserve context durably
+- wait for your next message or `/resume`
+
+This is the right mode when you want:
+
+- tight human control
+- short request-scoped help
+- less background churn
+- clearer handoff points
+
+### 3.4 Good fit
+
+Choose `Copilot` when:
+
+- you want to inspect before launching expensive work
+- the task is still ambiguous
+- you expect to iterate interactively
+- you want DeepScientist to behave more like a strong research IDE partner than a long-running autonomous operator
+
+### 3.5 Bad fit
+
+Avoid `Copilot` when:
+
+- you already know the quest should keep running for hours
+- you want detached experiments, monitoring, and follow-up routing without repeated user nudges
+- the goal is full quest ownership, not request-by-request collaboration
+
+## 4. Autonomous Mode
+
+### 4.1 What it is
+
+Autonomous mode is the standard DeepScientist path.
+
+It is meant for quests where the system should keep making ordinary route choices on its own and continue until the next real checkpoint is reached.
+
+This is the right mode for:
+
+- baseline establishment
+- long experiments
+- analysis campaigns
+- durable writing / finalize loops
+- connector-facing project progress over time
+
+### 4.2 What happens after creation
+
+After you create an Autonomous project:
+
+- the quest is created
+- the first turn is launched immediately
+- the system begins turning the startup contract into real work
+
+This may mean:
+
+- reading the baseline and references
+- checking environment and constraints
+- preparing scripts
+- selecting the next route
+- launching detached `bash_exec` work
+
+### 4.3 Continuation behavior
+
+Autonomous mode has two practical continuation regimes.
+
+#### A. No real long-running external task yet
+
+If no real long-running external task exists yet, DeepScientist should not park.
+
+It should keep using the next turns to:
+
+- prepare the real task
+- launch the real task
+- or make a durable route decision about what the real next task must be
+
+This is the “active preparation / launch” phase.
+
+#### B. A real long-running external task is already active
+
+Once a real detached task is already running, continuation changes shape.
+
+At that point, DeepScientist should not busy-loop through rapid model turns just to imitate continuous execution.
+
+Instead:
+
+- the real work should remain alive in detached `bash_exec` sessions or the runtime process they launched
+- agent turns become lower-frequency monitoring / synthesis passes
+- the current default monitoring cadence is roughly every `240` seconds
+
+This is the “background progress monitoring” phase.
+
+### 4.4 Good fit
+
+Choose `Autonomous` when:
+
+- the quest should keep moving on its own
+- you expect real long-running experiment or analysis work
+- you want DeepScientist to keep routing after milestones
+- you want the standard research-operating-system behavior
+
+### 4.5 Bad fit
+
+Avoid `Autonomous` when:
+
+- you only want a quiet project shell first
+- you want to inspect the repo manually before any real movement
+- you want every next unit to be explicitly user-directed
+
+## 5. The Most Important Practical Difference
+
+The easiest way to remember the split is:
+
+- `Copilot` asks: “What single useful unit should I help with right now?”
+- `Autonomous` asks: “What is the next real quest step, and how do I keep the quest moving?”
+
+That difference matters more than the labels themselves.
+
+## 6. How Resume Works
+
+Both modes preserve context durably, but they resume differently.
+
+On later turns, DeepScientist now carries a compact resume spine that can include:
+
+- the latest durable user message
+- the latest assistant checkpoint
+- the latest run summary
+- recent memory cues
+- current `bash_exec` state
+
+But the continuation policy still differs:
+
+- `Copilot`: resume only when you speak again or explicitly resume
+- `Autonomous`: keep going unless a real blocker or explicit waiting state applies
+
+## 7. Choosing Quickly
+
+Use this fast rule:
+
+1. If you want the project to wait quietly until you tell it what to do, choose `Copilot`.
+2. If you want DeepScientist to begin turning the quest contract into real work immediately, choose `Autonomous`.
+3. If you are unsure, start with `Copilot`; you can still move into longer-running work once the route is clearer.
+
+## 8. Common Misunderstandings
+
+### “Autonomous means it should always spin rapidly”
+
+No.
+
+Autonomous means the quest should keep moving.
+
+When there is no real long-running task yet, that can mean rapid preparation / launch turns.
+When a real long-running task is already active, it should usually mean lower-frequency monitoring, not constant model churn.
+
+### “Copilot means it cannot run experiments”
+
+Also no.
+
+Copilot can still help launch, inspect, analyze, and write.
+The difference is that it should not assume long autonomous continuation unless you ask for it.
+
+### “The two modes only change wording”
+
+No.
+
+They affect:
+
+- initial launch behavior
+- continuation policy
+- when the quest parks
+- how much autonomous routing is appropriate
+
+## 9. Related Docs
+
+- [00 Quick Start](./00_QUICK_START.md)
+- [02 Start Research Guide](./02_START_RESEARCH_GUIDE.md)
+- [12 Guided Workflow Tour](./12_GUIDED_WORKFLOW_TOUR.md)
+- [14 Prompt, Skills, and MCP Guide](./14_PROMPT_SKILLS_AND_MCP_GUIDE.md)

package/docs/en/README.md

@@ -4,6 +4,8 @@ DeepScientist is not just a long-running autonomous scientific discovery system.
 
 2 minutes to install. 2 minutes to bind Weixin. 2 minutes to launch. Extremely fast and easy to use.
 
+Local Web access now starts without a password gate by default. If you want a generated 16-character browser password for one launch, run `ds --auth true`; DeepScientist then prints the password in the terminal and the browser can reuse the stored login after the first successful entry.
+
 It is also a workshop-style collaboration environment: let it keep moving autonomously, or step in anytime to collaborate, edit code, run the terminal yourself, or keep notes and plans in a Notion-style workspace.
 
 Use DeepScientist anywhere: on the server through TUI, in the browser through Web, on the phone through Weixin or QQ, and even on glasses through Rokid Glasses.
@@ -30,6 +32,10 @@ This page is the shortest path to the right document.
 
 - [00 Quick Start](./00_QUICK_START.md)
   Start here if you want to install DeepScientist, launch it locally, and create your first project.
+- [20 Workspace Modes Guide](./20_WORKSPACE_MODES_GUIDE.md)
+  Read this if you want to choose correctly between Copilot and Autonomous before creating a project.
+- [19 Local Browser Auth](./19_LOCAL_BROWSER_AUTH.md)
+  Read this if you want to understand the local password prompt, where to find the password, and how to disable it.
 - [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)
@@ -43,6 +49,8 @@ This page is the shortest path to the right document.
 
 - [02 Start Research Guide](./02_START_RESEARCH_GUIDE.md)
   Explains the current frontend fields, derived contract fields, and practical examples.
+- [20 Workspace Modes Guide](./20_WORKSPACE_MODES_GUIDE.md)
+  Use this when the main question is not “how do I fill the form?” but “should this project start as Copilot or Autonomous?”.
 - [01 Settings Reference](./01_SETTINGS_REFERENCE.md)
   Use this when you need to configure runners, connectors, runtime defaults, or home paths.
 - [11 License And Risk Notice](./11_LICENSE_AND_RISK.md)
@@ -50,6 +58,12 @@ This page is the shortest path to the right document.
 
 ## If you want to collaborate through external surfaces
 
+- [16 Telegram Connector Guide](./16_TELEGRAM_CONNECTOR_GUIDE.md)
+  Bind Telegram through the built-in polling runtime and continue quests from bot chats.
+- [17 WhatsApp Connector Guide](./17_WHATSAPP_CONNECTOR_GUIDE.md)
+  Bind WhatsApp through the local-session runtime and continue quests from local chat sessions.
+- [18 Feishu Connector Guide](./18_FEISHU_CONNECTOR_GUIDE.md)
+  Bind Feishu through the built-in long-connection runtime and continue quests from bot chats.
 - [10 Weixin Connector Guide](./10_WEIXIN_CONNECTOR_GUIDE.md)
   Bind personal WeChat through DeepScientist's built-in QR login and iLink runtime.
 - [03 QQ Connector Guide](./03_QQ_CONNECTOR_GUIDE.md)
@@ -67,6 +81,8 @@ This page is the shortest path to the right document.
   Explains how the daemon, workspace, canvas, and connector views fit together.
 - [07 Memory and MCP](./07_MEMORY_AND_MCP.md)
   Explains memory, artifacts, and built-in MCP behavior.
+- [19 External Controller Guide](./19_EXTERNAL_CONTROLLER_GUIDE.md)
+  Shows how to build optional outer-orchestration guards on top of mailbox and `quest_control` without patching core runtime code.
 
 ## If something is broken
 
@@ -83,3 +99,11 @@ This page is the shortest path to the right document.
   High-level system contracts and repository structure.
 - [91 Development](./91_DEVELOPMENT.md)
   Maintainer-facing workflow and implementation notes.
+
+## Community
+
+Welcome to join the WeChat group for discussion.
+
+<p align="center">
+  <img src="../../assets/readme/wechat.jpg" alt="DeepScientist WeChat group" width="360" />
+</p>

package/docs/zh/00_QUICK_START.md

@@ -13,7 +13,7 @@
 
 本文中的截图直接使用当前在线页面 `deepscientist.cc:20999` 作为示例。你本地运行后的页面 `127.0.0.1:20999` 通常会与它保持一致或非常接近。
 
-当前平台支持：DeepScientist 目前仅支持 Linux 和 macOS，当前版本暂不支持 Windows。
+当前平台支持：DeepScientist 目前完整支持 Linux 和 macOS。原生 Windows 支持目前仍处于实验阶段（强烈建议优先使用 WSL2，尤其是在你希望获得最接近 Linux 的终端行为时）。
 
 ## 安全建议：先隔离，再启动
 
@@ -60,7 +60,7 @@
 
 ## 1. 先安装 Node.js，再安装 DeepScientist
 
-DeepScientist 目前仅支持 Linux 和 macOS。
+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
 
@@ -409,8 +442,8 @@ codex:
   profile: ""
   model: gpt-5.4
   model_reasoning_effort: xhigh
-  approval_policy: on-request
-  sandbox_mode: workspace-write
+  approval_policy: never
+  sandbox_mode: danger-full-access
   retry_on_failure: true
   retry_max_attempts: 5
   retry_initial_backoff_sec: 1.0
@@ -488,19 +521,35 @@ claude:
 **`approval_policy`**
 
 - 类型：`string`
-- 默认值：`on-request`
+- 默认值：`never`
 - 页面标签：`Approval policy`
 - 允许值：`never`、`on-failure`、`on-request`、`untrusted`
 - 作用：控制高权限动作如何申请许可。
+- 运行说明：launcher 现在默认以 YOLO 模式启动 Codex。若要临时关闭，可显式传 `ds --yolo false`，这会恢复到 `approval_policy=on-request` 与 `sandbox_mode=workspace-write`。
 
 **`sandbox_mode`**
 
 - 类型：`string`
-- 默认值：`workspace-write`
+- 默认值：`danger-full-access`
 - 页面标签：`Sandbox mode`
 - 允许值：`read-only`、`workspace-write`、`danger-full-access`
 - 作用：控制 runner 的文件系统/进程访问权限。
 
+**`env`**
+
+- 类型：`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`

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/03_QQ_CONNECTOR_GUIDE.md

@@ -20,6 +20,7 @@
 - 在 QQ 中使用 `/new`、`/use latest`、`/status` 等命令
 - 在 `Settings` 页面看到自动检测到的 `openid`
 - 从 `Settings` 页面执行非破坏性的连接测试
+- 当 QQ 绑定到 quest 时，在每次主实验完成后自动收到按指标生成的时间线图片
 
 ### 部署前检查清单
 
@@ -221,6 +222,24 @@ QQ readiness is healthy, but no OpenID has been learned yet. Save credentials, t
 - 再次点击“发送测试消息”时，不再提示 target 为空
 - 如果当前已经有最新项目，普通文本会自动进入该项目；如果还没有项目，则优先返回帮助信息
 
+## 5.3 主实验指标图自动推送
+
+当 QQ 是当前 quest 的绑定连接器时，DeepScientist 现在会在每次主实验完成后自动发送指标时间线图片。
+
+当前行为：
+
+- 每个指标生成一张图
+- 如果 baseline 存在该指标，会画一条横向虚线作为 baseline 参考线
+- 系统会自动判断该指标是“越高越好”还是“越低越好”
+- 超过 baseline 的点会额外标星
+- 最新点使用莫兰迪深红色填充
+- 较早的点使用莫兰迪深蓝色填充
+- 如果指标有多个，DeepScientist 会按顺序发送，并在相邻两张图之间间隔约 2 秒
+
+这些图来自 quest 本地生成的文件，并会作为 QQ 原生图片自动发送。
+
+如果你想关闭这项自动推送，可以在 QQ 连接器配置中关闭 `auto_send_main_experiment_png`。
+
 ### 5.2 报错提示速查
 
 | 提示 | 代表什么 | 应该怎么做 |

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`。