@researai/deepscientist 1.5.9 → 1.5.12

package/docs/en/15_CODEX_PROVIDER_SETUP.md

@@ -0,0 +1,284 @@
+# 15 Codex Provider Setup
+
+DeepScientist does not implement separate provider adapters for MiniMax, GLM, Volcengine Ark, or Alibaba Bailian.
+
+Instead, it reuses the same Codex CLI setup that already works in your terminal.
+
+The recommended order is always:
+
+1. make Codex itself work first
+2. confirm `codex` or `codex --profile <name>` works in a terminal
+3. run `ds doctor`
+4. run `ds` or `ds --codex-profile <name>`
+
+## Three supported patterns
+
+### 1. Default OpenAI login path
+
+Use this when your Codex CLI works through the standard OpenAI login flow.
+
+```bash
+codex --login
+ds doctor
+ds
+```
+
+### 2. One-off provider profile
+
+Use this when you already have a named Codex profile such as `minimax`, `glm`, `ark`, or `bailian`.
+
+```bash
+codex --profile minimax
+ds doctor --codex-profile minimax
+ds --codex-profile minimax
+```
+
+This is the simplest path. You do not need to edit `runners.yaml` just to try one provider-backed session.
+
+### 3. Persistent provider profile
+
+Use this when you want DeepScientist to keep using the same profile by default.
+
+```yaml
+codex:
+  enabled: true
+  binary: codex
+  config_dir: ~/.codex
+  profile: minimax
+  model: inherit
+  model_reasoning_effort: xhigh
+  approval_policy: on-request
+  sandbox_mode: workspace-write
+```
+
+Important:
+
+- keep `model: inherit` for provider-backed Codex profiles unless you are certain the provider accepts the explicit model id you plan to send
+- DeepScientist will reuse the same `~/.codex/config.toml` and environment that your terminal Codex already uses
+
+## Provider matrix
+
+| 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` |
+| 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 |
+
+## OpenAI
+
+### What to prepare
+
+- a normal Codex CLI install
+- a successful `codex --login` or `codex` interactive first-run setup
+
+### DeepScientist commands
+
+```bash
+ds doctor
+ds
+```
+
+### Persistent runner config
+
+```yaml
+codex:
+  enabled: true
+  binary: codex
+  config_dir: ~/.codex
+  profile: ""
+  model: gpt-5.4
+```
+
+## MiniMax
+
+MiniMax is the clearest profile-based case. Its official Codex CLI guide configures a custom Codex provider and sets `requires_openai_auth = false`.
+
+Official doc:
+
+- <https://platform.minimaxi.com/docs/coding-plan/codex-cli>
+
+### What to prepare
+
+- Codex CLI installed
+- `MINIMAX_API_KEY` available in the shell that starts Codex and DeepScientist
+- a working Codex profile in `~/.codex/config.toml`
+
+### 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`.
+
+```toml
+[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.minimax]
+model = "codex-MiniMax-M2.5"
+model_provider = "minimax"
+```
+
+Then:
+
+```bash
+export MINIMAX_API_KEY="..."
+codex --profile minimax
+```
+
+### DeepScientist commands
+
+```bash
+ds doctor --codex-profile minimax
+ds --codex-profile minimax
+```
+
+### Persistent runner config
+
+```yaml
+codex:
+  enabled: true
+  binary: codex
+  config_dir: ~/.codex
+  profile: minimax
+  model: inherit
+```
+
+## GLM
+
+GLM documents the Coding Plan as an OpenAI-compatible coding endpoint rather than a dedicated Codex login flow.
+
+Official docs:
+
+- <https://docs.bigmodel.cn/cn/coding-plan/tool/others>
+- <https://docs.bigmodel.cn/cn/coding-plan/faq>
+
+### Official provider values
+
+- Base URL: `https://open.bigmodel.cn/api/coding/paas/v4`
+- API key: your GLM Coding Plan key
+- Model: `GLM-4.7` for the documented path, or `GLM-5` where supported
+
+### Recommended Codex adaptation
+
+GLM does not currently publish a separate Codex CLI page in the same style as MiniMax. The practical DeepScientist path is:
+
+1. create a Codex profile in `~/.codex/config.toml` that points to the GLM coding endpoint above
+2. make sure `codex --profile glm` works in a terminal first
+3. run DeepScientist with the same profile
+
+### DeepScientist commands
+
+```bash
+ds doctor --codex-profile glm
+ds --codex-profile glm
+```
+
+### Persistent runner config
+
+```yaml
+codex:
+  enabled: true
+  binary: codex
+  config_dir: ~/.codex
+  profile: glm
+  model: inherit
+```
+
+## Volcengine Ark
+
+Volcengine Ark explicitly lists Codex CLI as a supported coding tool.
+
+Official doc:
+
+- <https://www.volcengine.com/docs/82379/1925114?lang=zh>
+
+### Official provider values
+
+- OpenAI-compatible Base URL: `https://ark.cn-beijing.volces.com/api/coding/v3`
+- Supported coding models: `doubao-seed-code-preview-latest`, `ark-code-latest`
+- Use the Coding Plan key and the exact Coding Plan endpoint
+
+### Recommended Codex adaptation
+
+Create a Codex profile that targets the Ark coding endpoint and test it directly first:
+
+```bash
+codex --profile ark
+```
+
+Then start DeepScientist with the same profile:
+
+```bash
+ds doctor --codex-profile ark
+ds --codex-profile ark
+```
+
+### Persistent runner config
+
+```yaml
+codex:
+  enabled: true
+  binary: codex
+  config_dir: ~/.codex
+  profile: ark
+  model: inherit
+```
+
+## Alibaba Bailian
+
+Bailian documents Coding Plan as an OpenAI-compatible coding endpoint. It requires the Coding Plan-specific key and endpoint, not the generic platform endpoint.
+
+Official docs:
+
+- <https://help.aliyun.com/zh/model-studio/other-tools-coding-plan>
+- <https://help.aliyun.com/zh/model-studio/coding-plan-faq>
+
+### Official provider values
+
+- OpenAI-compatible Base URL: `https://coding.dashscope.aliyuncs.com/v1`
+- API key: Coding Plan-specific key, typically `sk-sp-...`
+- Model: choose a Coding Plan-supported model from the current Bailian overview
+
+### Recommended Codex adaptation
+
+Create a Codex profile that points to the Bailian Coding Plan endpoint and test it directly first:
+
+```bash
+codex --profile bailian
+```
+
+Then start DeepScientist with the same profile:
+
+```bash
+ds doctor --codex-profile bailian
+ds --codex-profile bailian
+```
+
+### Persistent runner config
+
+```yaml
+codex:
+  enabled: true
+  binary: codex
+  config_dir: ~/.codex
+  profile: bailian
+  model: inherit
+```
+
+## Troubleshooting checklist
+
+If a provider-backed profile still fails in DeepScientist:
+
+1. run `codex --profile <name>` manually first
+2. confirm the provider API key is present in the same shell
+3. confirm the provider-specific Base URL is the Coding Plan endpoint, not the generic API endpoint
+4. keep DeepScientist runner `model: inherit` unless you need an explicit override
+5. run `ds doctor --codex-profile <name>`
+6. only after that run `ds --codex-profile <name>`

package/docs/en/99_ACKNOWLEDGEMENTS.md

@@ -13,8 +13,11 @@ We especially thank the following projects for their ideas, research direction,
 - EvoScientist
 - Orchestra-Research
 - Orchestra-Research/AI-Research-SKILLs
+- Overleaf / overleaf/overleaf
+- Monaco Editor / microsoft/monaco-editor
+- Novel / steven-tey/novel
 
-These projects have been important references for thinking about automated research, open-ended exploration, evolutionary search, experiment organization, and long-horizon research agents.
+These projects have been important references for thinking about automated research, open-ended exploration, evolutionary search, experiment organization, long-horizon research agents, collaborative LaTeX editing workflows, browser-based code editing experiences, and rich notebook-style writing interactions.
 
 ## Personal acknowledgements
 

package/docs/en/README.md

@@ -0,0 +1,83 @@
+# DeepScientist Docs
+
+DeepScientist is not just a long-running autonomous scientific discovery system. It is also a persistent research map that lives on your own machine.
+
+2 minutes to install. 2 minutes to bind Weixin. 2 minutes to launch. Extremely fast and easy to use.
+
+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.
+
+## News
+
+- `2026/03/24`: DeepScientist officially releases `v1.5`.
+- `2026/02/01`: the DeepScientist paper is available on [OpenReview](https://openreview.net/forum?id=cZFgsLq8Gs) for `ICLR 2026`.
+
+## More From ResearAI
+
+AI Scientist and AutoFigure projects worth exploring alongside DeepScientist:
+
+| Project | What it does |
+|---|---|
+| [AutoFigure](https://github.com/ResearAI/AutoFigure) | generate paper-ready figures |
+| [AutoFigure-Edit](https://github.com/ResearAI/AutoFigure-Edit) | editable vector paper figures |
+| [DeepReviewer-v2](https://github.com/ResearAI/DeepReviewer-v2) | review papers and drafts |
+| [Awesome-AI-Scientist](https://github.com/ResearAI/Awesome-AI-Scientist) | curated AI scientist landscape |
+
+This page is the shortest path to the right document.
+
+## If you are new
+
+- [00 Quick Start](./00_QUICK_START.md)
+  Start here if you want to install DeepScientist, launch it locally, and create your first project.
+- [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.
+- [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)
+  Read this next if you want to understand each field in the `Start Research` dialog and what it actually submits.
+
+## If you want to launch a project well
+
+- [02 Start Research Guide](./02_START_RESEARCH_GUIDE.md)
+  Explains the current frontend fields, derived contract fields, and practical examples.
+- [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)
+  Read this first if you care about the license boundary, server safety, fabricated outputs, connector leakage, and public exposure risk.
+
+## If you want to collaborate through external surfaces
+
+- [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)
+  Use QQ as a practical collaboration surface for progress, commands, and milestone delivery.
+- [04 Lingzhu Connector Guide](./04_LINGZHU_CONNECTOR_GUIDE.md)
+  Bind Lingzhu / Rokid Glasses to DeepScientist.
+
+## If you want to understand how the system works
+
+- [13 Core Architecture Guide](./13_CORE_ARCHITECTURE_GUIDE.md)
+  Read this first if you want a user-facing overview of launcher, daemon, quests, Canvas, memory, and connectors.
+- [14 Prompt, Skills, and MCP Guide](./14_PROMPT_SKILLS_AND_MCP_GUIDE.md)
+  Read this when you want the real turn-time structure: prompt assembly order, stage skills, and built-in MCP tool families.
+- [06 Runtime and Canvas](./06_RUNTIME_AND_CANVAS.md)
+  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.
+
+## If something is broken
+
+- [09 Doctor](./09_DOCTOR.md)
+  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.
+- [01 Settings Reference](./01_SETTINGS_REFERENCE.md)
+  Check this if the problem is likely caused by config, credentials, or connector setup.
+
+## If you are developing DeepScientist
+
+- [90 Architecture](./90_ARCHITECTURE.md)
+  High-level system contracts and repository structure.
+- [91 Development](./91_DEVELOPMENT.md)
+  Maintainer-facing workflow and implementation notes.

package/docs/images/weixin/weixin-plugin-entry.svg

@@ -0,0 +1,33 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720" fill="none">
+  <rect width="1280" height="720" rx="32" fill="#FAFBFF"/>
+  <rect x="40" y="40" width="1200" height="640" rx="28" fill="#FFFFFF" stroke="#DAE2F3" stroke-width="2"/>
+  <circle cx="108" cy="108" r="34" fill="#2563EB"/>
+  <path d="M92 108C92 99.16 99.16 92 108 92C116.84 92 124 99.16 124 108C124 116.84 116.84 124 108 124C99.16 124 92 116.84 92 108Z" fill="#fff" fill-opacity=".2"/>
+  <path d="M101 116V100H115" stroke="#fff" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/>
+  <text x="164" y="98" fill="#0F172A" font-family="Arial, sans-serif" font-size="34" font-weight="700">WeChat Version And Plugin Entry Check</text>
+  <text x="164" y="138" fill="#475569" font-family="Arial, sans-serif" font-size="20">Reference precheck from the personal WeChat guide before you bind in DeepScientist</text>
+
+  <rect x="88" y="196" width="492" height="430" rx="28" fill="#F8FAFF" stroke="#D5DDF0" stroke-width="2"/>
+  <text x="120" y="252" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Compatibility checklist</text>
+  <rect x="120" y="292" width="428" height="88" rx="20" fill="#EEF2FF"/>
+  <text x="150" y="326" fill="#3730A3" font-family="Arial, sans-serif" font-size="20" font-weight="700">WeChat for iOS</text>
+  <text x="150" y="356" fill="#334155" font-family="Arial, sans-serif" font-size="18">Use 8.0.70 or newer if you need the plugin entry.</text>
+  <rect x="120" y="398" width="428" height="180" rx="20" fill="#fff" stroke="#E1E7F5"/>
+  <text x="150" y="434" fill="#0F172A" font-family="Arial, sans-serif" font-size="20" font-weight="700">Expected path in the reference flow</text>
+  <text x="150" y="474" fill="#334155" font-family="Arial, sans-serif" font-size="18">1. Me</text>
+  <text x="150" y="508" fill="#334155" font-family="Arial, sans-serif" font-size="18">2. Settings</text>
+  <text x="150" y="542" fill="#334155" font-family="Arial, sans-serif" font-size="18">3. Plugins</text>
+  <text x="150" y="576" fill="#475569" font-family="Arial, sans-serif" font-size="16">If this entry is missing, update WeChat first.</text>
+
+  <rect x="640" y="168" width="520" height="486" rx="34" fill="#ECFDF5" stroke="#C3EED3" stroke-width="2"/>
+  <rect x="760" y="204" width="280" height="420" rx="42" fill="#FFFFFF" stroke="#D7EAD9" stroke-width="2"/>
+  <rect x="786" y="246" width="228" height="42" rx="16" fill="#DCFCE7"/>
+  <text x="847" y="273" fill="#166534" font-family="Arial, sans-serif" font-size="20" font-weight="700">WeChat</text>
+  <rect x="786" y="318" width="228" height="54" rx="18" fill="#F8FAFC"/>
+  <text x="818" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18">Me</text>
+  <rect x="786" y="388" width="228" height="54" rx="18" fill="#F8FAFC"/>
+  <text x="818" y="422" fill="#0F172A" font-family="Arial, sans-serif" font-size="18">Settings</text>
+  <rect x="786" y="458" width="228" height="54" rx="18" fill="#DCFCE7" stroke="#22C55E"/>
+  <text x="818" y="492" fill="#166534" font-family="Arial, sans-serif" font-size="18" font-weight="700">Plugins</text>
+  <text x="702" y="616" fill="#475569" font-family="Arial, sans-serif" font-size="17">DeepScientist still binds from its own QR modal.</text>
+</svg>

package/docs/images/weixin/weixin-qr-confirm.svg

@@ -0,0 +1,30 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720" fill="none">
+  <rect width="1280" height="720" rx="32" fill="#F7FBF8"/>
+  <rect x="40" y="40" width="1200" height="640" rx="28" fill="#FFFFFF" stroke="#D7E9DC" stroke-width="2"/>
+  <circle cx="108" cy="108" r="34" fill="#16A34A"/>
+  <path d="M97 108L105 116L119 100" stroke="#fff" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/>
+  <text x="164" y="98" fill="#0F172A" font-family="Arial, sans-serif" font-size="34" font-weight="700">Weixin QR Login Confirmation</text>
+  <text x="164" y="138" fill="#475569" font-family="Arial, sans-serif" font-size="20">One QR image in the modal, phone-side confirmation, automatic persistence</text>
+
+  <rect x="86" y="190" width="484" height="456" rx="28" fill="#FBFCFF" stroke="#DCE4F4" stroke-width="2"/>
+  <text x="118" y="244" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">DeepScientist modal</text>
+  <rect x="158" y="288" width="340" height="340" rx="26" fill="#fff" stroke="#CBD5E1" stroke-width="2"/>
+  <rect x="198" y="328" width="260" height="260" fill="#111827"/>
+  <rect x="220" y="350" width="60" height="60" fill="#fff"/>
+  <rect x="378" y="350" width="60" height="60" fill="#fff"/>
+  <rect x="220" y="508" width="60" height="60" fill="#fff"/>
+  <rect x="300" y="430" width="40" height="40" fill="#fff"/>
+  <rect x="364" y="494" width="28" height="28" fill="#fff"/>
+  <text x="136" y="660" fill="#475569" font-family="Arial, sans-serif" font-size="17">The popup only needs the QR image and a short hint.</text>
+
+  <rect x="708" y="164" width="472" height="500" rx="36" fill="#ECFDF5" stroke="#C6EDD2" stroke-width="2"/>
+  <rect x="846" y="202" width="196" height="414" rx="34" fill="#FFFFFF" stroke="#D3E7D6" stroke-width="2"/>
+  <text x="889" y="242" fill="#166534" font-family="Arial, sans-serif" font-size="22" font-weight="700">Phone</text>
+  <rect x="874" y="284" width="140" height="82" rx="18" fill="#DCFCE7"/>
+  <text x="908" y="332" fill="#166534" font-family="Arial, sans-serif" font-size="18" font-weight="700">Scan</text>
+  <rect x="874" y="392" width="140" height="82" rx="18" fill="#BBF7D0"/>
+  <text x="896" y="440" fill="#166534" font-family="Arial, sans-serif" font-size="18" font-weight="700">Confirm login</text>
+  <rect x="874" y="500" width="140" height="82" rx="18" fill="#86EFAC"/>
+  <text x="895" y="548" fill="#14532D" font-family="Arial, sans-serif" font-size="18" font-weight="700">Saved automatically</text>
+  <text x="742" y="638" fill="#475569" font-family="Arial, sans-serif" font-size="17">DeepScientist persists the returned token and account ids.</text>
+</svg>

package/docs/images/weixin/weixin-quest-media-flow.svg

@@ -0,0 +1,44 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720" fill="none">
+  <rect width="1280" height="720" rx="32" fill="#FFFDF8"/>
+  <rect x="40" y="40" width="1200" height="640" rx="28" fill="#FFFFFF" stroke="#EBDCC1" stroke-width="2"/>
+  <circle cx="108" cy="108" r="34" fill="#F59E0B"/>
+  <path d="M108 90V126" stroke="#fff" stroke-width="8" stroke-linecap="round"/>
+  <path d="M90 108H126" stroke="#fff" stroke-width="8" stroke-linecap="round"/>
+  <text x="164" y="98" fill="#0F172A" font-family="Arial, sans-serif" font-size="34" font-weight="700">Quest-Local Weixin Media Flow</text>
+  <text x="164" y="138" fill="#475569" font-family="Arial, sans-serif" font-size="20">Inbound media is copied into the quest. Outbound media should come from a real local file.</text>
+
+  <rect x="76" y="196" width="308" height="424" rx="28" fill="#F8FAFC" stroke="#DCE3EA" stroke-width="2"/>
+  <text x="112" y="250" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">WeChat user</text>
+  <rect x="112" y="300" width="236" height="70" rx="20" fill="#DCFCE7"/>
+  <text x="148" y="342" fill="#166534" font-family="Arial, sans-serif" font-size="18" font-weight="700">Send text / image / video / file</text>
+  <rect x="112" y="396" width="236" height="164" rx="20" fill="#fff" stroke="#DDE6EE"/>
+  <text x="138" y="432" fill="#334155" font-family="Arial, sans-serif" font-size="17">Image message</text>
+  <text x="138" y="464" fill="#334155" font-family="Arial, sans-serif" font-size="17">Video message</text>
+  <text x="138" y="496" fill="#334155" font-family="Arial, sans-serif" font-size="17">File message</text>
+  <text x="138" y="536" fill="#475569" font-family="Arial, sans-serif" font-size="16">Media-only inbound events are kept.</text>
+
+  <rect x="486" y="154" width="308" height="508" rx="28" fill="#F9FBFF" stroke="#D8E2F4" stroke-width="2"/>
+  <text x="516" y="214" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">DeepScientist runtime</text>
+  <rect x="516" y="262" width="248" height="76" rx="20" fill="#E0E7FF"/>
+  <text x="548" y="308" fill="#3730A3" font-family="Arial, sans-serif" font-size="19" font-weight="700">Download / decrypt / normalize</text>
+  <rect x="516" y="362" width="248" height="92" rx="20" fill="#fff" stroke="#E0E7F3"/>
+  <text x="548" y="398" fill="#334155" font-family="Arial, sans-serif" font-size="17">Copy into quest userfiles</text>
+  <text x="548" y="428" fill="#334155" font-family="Arial, sans-serif" font-size="17">Write manifest.json</text>
+  <rect x="516" y="480" width="248" height="122" rx="20" fill="#EEF2FF"/>
+  <text x="548" y="518" fill="#3730A3" font-family="Arial, sans-serif" font-size="17">Reply path</text>
+  <text x="548" y="548" fill="#334155" font-family="Arial, sans-serif" font-size="16">Text uses context_token</text>
+  <text x="548" y="576" fill="#334155" font-family="Arial, sans-serif" font-size="16">Media uploads use a real local file path</text>
+
+  <rect x="896" y="196" width="308" height="424" rx="28" fill="#FFFBEB" stroke="#F4DEAB" stroke-width="2"/>
+  <text x="928" y="250" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Quest files</text>
+  <rect x="928" y="300" width="244" height="220" rx="20" fill="#fff" stroke="#F0E1B8"/>
+  <text x="952" y="338" fill="#92400E" font-family="Arial, sans-serif" font-size="17" font-weight="700">userfiles/weixin/&lt;batch&gt;/</text>
+  <text x="952" y="376" fill="#334155" font-family="Arial, sans-serif" font-size="16">manifest.json</text>
+  <text x="952" y="408" fill="#334155" font-family="Arial, sans-serif" font-size="16">001-image.png</text>
+  <text x="952" y="440" fill="#334155" font-family="Arial, sans-serif" font-size="16">002-video.mp4</text>
+  <text x="952" y="472" fill="#334155" font-family="Arial, sans-serif" font-size="16">003-report.pdf</text>
+  <text x="952" y="512" fill="#475569" font-family="Arial, sans-serif" font-size="16">Durable files the quest can read later</text>
+
+  <path d="M396 408H470" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+  <path d="M808 408H882" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+</svg>

package/docs/images/weixin/weixin-settings-bind.svg

@@ -0,0 +1,57 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720" fill="none">
+  <rect width="1280" height="720" rx="32" fill="#F7FBF8"/>
+  <rect x="40" y="40" width="1200" height="640" rx="28" fill="#FFFFFF" stroke="#D7E9DC" stroke-width="2"/>
+  <circle cx="108" cy="108" r="34" fill="#22C55E"/>
+  <path d="M92 108C92 99.16 99.16 92 108 92C116.84 92 124 99.16 124 108C124 116.84 116.84 124 108 124C99.16 124 92 116.84 92 108Z" fill="#fff" fill-opacity=".18"/>
+  <path d="M100 116L108 101L116 116H100Z" fill="#fff"/>
+  <text x="164" y="98" fill="#0F172A" font-family="Arial, sans-serif" font-size="34" font-weight="700">DeepScientist Weixin Bind Flow</text>
+  <text x="164" y="138" fill="#475569" font-family="Arial, sans-serif" font-size="20">Settings -&gt; Connectors -&gt; WeChat -&gt; Bind -&gt; QR login -&gt; auto-saved connector</text>
+
+  <rect x="72" y="196" width="368" height="430" rx="28" fill="#F7FBF8" stroke="#CFE5D5" stroke-width="2"/>
+  <rect x="102" y="228" width="104" height="36" rx="18" fill="#DCFCE7"/>
+  <text x="129" y="251" fill="#166534" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 1</text>
+  <text x="102" y="304" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Open WeChat card</text>
+  <rect x="102" y="338" width="308" height="188" rx="22" fill="#fff" stroke="#DDEBE1"/>
+  <text x="126" y="370" fill="#0F172A" font-family="Arial, sans-serif" font-size="19" font-weight="700">DeepScientist</text>
+  <text x="126" y="402" fill="#334155" font-family="Arial, sans-serif" font-size="17">Settings</text>
+  <text x="126" y="434" fill="#334155" font-family="Arial, sans-serif" font-size="17">Connectors</text>
+  <text x="126" y="466" fill="#334155" font-family="Arial, sans-serif" font-size="17">WeChat</text>
+  <rect x="126" y="488" width="160" height="28" rx="14" fill="#111827"/>
+  <text x="157" y="507" fill="#fff" font-family="Arial, sans-serif" font-size="15" font-weight="700">Bind WeChat</text>
+  <text x="102" y="572" fill="#475569" font-family="Arial, sans-serif" font-size="17">DeepScientist generates the QR itself.</text>
+  <text x="102" y="598" fill="#475569" font-family="Arial, sans-serif" font-size="17">No manual token form is required.</text>
+
+  <rect x="456" y="196" width="368" height="430" rx="28" fill="#FBFCFF" stroke="#D7E3F5" stroke-width="2"/>
+  <rect x="486" y="228" width="104" height="36" rx="18" fill="#E0E7FF"/>
+  <text x="513" y="251" fill="#4338CA" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 2</text>
+  <text x="486" y="304" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Scan and confirm</text>
+  <rect x="498" y="344" width="140" height="140" rx="18" fill="#fff" stroke="#CBD5E1" stroke-width="2"/>
+  <rect x="520" y="366" width="96" height="96" fill="#111827"/>
+  <rect x="534" y="380" width="22" height="22" fill="#fff"/>
+  <rect x="580" y="380" width="22" height="22" fill="#fff"/>
+  <rect x="534" y="426" width="22" height="22" fill="#fff"/>
+  <rect x="566" y="412" width="14" height="14" fill="#fff"/>
+  <rect x="594" y="426" width="8" height="8" fill="#fff"/>
+  <rect x="666" y="344" width="124" height="220" rx="28" fill="#ECFDF5" stroke="#BBF7D0"/>
+  <rect x="684" y="370" width="88" height="140" rx="18" fill="#FFFFFF" stroke="#D1E7D6"/>
+  <text x="699" y="402" fill="#0F172A" font-family="Arial, sans-serif" font-size="17" font-weight="700">WeChat</text>
+  <text x="699" y="438" fill="#334155" font-family="Arial, sans-serif" font-size="14">Scan QR</text>
+  <text x="699" y="462" fill="#334155" font-family="Arial, sans-serif" font-size="14">Confirm login</text>
+  <text x="699" y="486" fill="#334155" font-family="Arial, sans-serif" font-size="14">Wait for save</text>
+  <text x="486" y="596" fill="#475569" font-family="Arial, sans-serif" font-size="17">The phone completes the confirmation.</text>
+
+  <rect x="840" y="196" width="368" height="430" rx="28" fill="#F8FCFF" stroke="#CDE5EC" stroke-width="2"/>
+  <rect x="870" y="228" width="104" height="36" rx="18" fill="#CCFBF1"/>
+  <text x="897" y="251" fill="#0F766E" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 3</text>
+  <text x="870" y="304" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Connector saved</text>
+  <rect x="870" y="340" width="308" height="200" rx="22" fill="#fff" stroke="#D8EAEE"/>
+  <text x="896" y="376" fill="#0F172A" font-family="Arial, sans-serif" font-size="19" font-weight="700">Saved binding</text>
+  <text x="896" y="416" fill="#334155" font-family="Arial, sans-serif" font-size="17">enabled: true</text>
+  <text x="896" y="448" fill="#334155" font-family="Arial, sans-serif" font-size="17">transport: ilink_long_poll</text>
+  <text x="896" y="480" fill="#334155" font-family="Arial, sans-serif" font-size="17">bot_token: persisted</text>
+  <text x="896" y="512" fill="#334155" font-family="Arial, sans-serif" font-size="17">account_id + login_user_id</text>
+  <text x="870" y="586" fill="#475569" font-family="Arial, sans-serif" font-size="17">DeepScientist starts long polling automatically.</text>
+
+  <path d="M444 410H452" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+  <path d="M828 410H836" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+</svg>