@researai/deepscientist 1.5.15 → 1.5.17

package/docs/zh/00_QUICK_START.md

@@ -13,7 +13,7 @@
 
 本文中的截图直接使用当前在线页面 `deepscientist.cc:20999` 作为示例。你本地运行后的页面 `127.0.0.1:20999` 通常会与它保持一致或非常接近。
 
-当前平台支持：DeepScientist 目前完整支持 Linux 和 macOS。原生 Windows 支持目前仍处于实验阶段；如果你希望获得最接近 Linux 的终端行为，仍然建议优先使用 WSL2。
+当前平台支持：DeepScientist 目前完整支持 Linux 和 macOS。原生 Windows 支持目前仍处于实验阶段（强烈建议优先使用 WSL2，尤其是在你希望获得最接近 Linux 的终端行为时）。
 
 ## 安全建议：先隔离，再启动
 
@@ -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,13 +55,15 @@
 - 阿里百炼 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)
 
 ## 1. 先安装 Node.js，再安装 DeepScientist
 
-DeepScientist 目前完整支持 Linux 和 macOS。原生 Windows 支持目前仍处于实验阶段；如果你希望获得更接近 Linux 的 shell 行为，仍然建议优先使用 WSL2。
+DeepScientist 目前完整支持 Linux 和 macOS。原生 Windows 支持目前仍处于实验阶段（强烈建议优先使用 WSL2，尤其是在你希望获得更稳定、更接近 Linux 的 shell 行为时）。
 
 在安装 DeepScientist 本身之前，请先从 Node.js 官方页面安装 Node.js：
 
@@ -85,6 +88,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
@@ -102,10 +114,10 @@ ds latex install-runtime
 运行：
 
 ```bash
-codex --login
+codex login
 ```
 
-如果你的 Codex CLI 版本没有 `--login`，就运行：
+如果你更喜欢交互式首次配置，就运行：
 
 ```bash
 codex
@@ -121,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
@@ -148,18 +160,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. 启动本地运行时
@@ -192,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
@@ -200,13 +228,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 +249,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 +273,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)
 
@@ -413,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

@@ -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
 
@@ -446,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/02_START_RESEARCH_GUIDE.md

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

package/docs/zh/05_TUI_GUIDE.md

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

package/docs/zh/09_DOCTOR.md

@@ -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,19 +119,25 @@ 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 补充说明：
 
 - 如果 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`
+- 如果 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 模型不可用
 
@@ -149,7 +163,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 +247,7 @@ git config --global user.email "you@example.com"
 ## 说明
 
 - `ds docker` 保留为兼容别名，但正式命令是 `ds doctor`。
-- 默认浏览器访问地址是 `http://127.0.0.1:20999`。
+- 默认情况下，浏览器访问地址保持普通本地形式，例如 `http://127.0.0.1:20999`。
+- 如果启用了本地浏览器密码模式，首页会先弹出密码框，再继续进入工作区。
+- 你可以回到启动终端查看当前密码，或者执行 `ds --status`。
+- 默认情况下不会出现密码弹窗；如果你想在某次启动中启用本地浏览器密码模式，可以使用 `ds --auth true`。

package/docs/zh/14_PROMPT_SKILLS_AND_MCP_GUIDE.md

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