@researai/deepscientist 1.5.2 → 1.5.4

package/docs/en/00_QUICK_START.md

@@ -39,6 +39,28 @@ If `uv` is missing on your machine, `ds` will bootstrap a local copy automatical
 
 By default, the DeepScientist home is `~/DeepScientist` on macOS and Linux, and `%USERPROFILE%\\DeepScientist` on Windows. You can override it with `ds --home <path>`.
 
+If you want to use the current working directory as the DeepScientist home directly, run:
+
+```bash
+ds --here
+```
+
+This is equivalent to `ds --home "$PWD"`.
+
+If you install from a source checkout and want another default base path for the bundled CLI tree, use:
+
+```bash
+bash install.sh --dir /data/DeepScientist
+```
+
+If you already have a populated DeepScientist home and need to move it to another path later, use:
+
+```bash
+ds migrate /data/DeepScientist
+```
+
+The migration command prints the absolute source and target paths, stops the managed daemon, asks for a double confirmation, verifies the copied tree, updates launcher wrappers, and removes the old path only after the migration succeeds.
+
 By default, the web UI is served at:
 
 ```text

package/docs/en/01_SETTINGS_REFERENCE.md

@@ -44,7 +44,7 @@ Connector-specific setup guides:
 ```yaml
 home: ~/DeepScientist
 default_runner: codex
-default_locale: zh-CN
+default_locale: en-US # or zh-CN, initialized from the browser on first web launch
 daemon:
   session_restore_on_start: true
   max_concurrent_quests: 1
@@ -67,6 +67,14 @@ skills:
   sync_global_on_init: true
   sync_quest_on_create: true
   sync_quest_on_open: true
+bootstrap:
+  codex_ready: false
+  codex_last_checked_at: null
+  codex_last_result: {}
+  locale_source: browser
+  locale_initialized_from_browser: true
+  locale_initialized_at: 2026-03-18T00:00:00+00:00
+  locale_initialized_browser_locale: en-US
 connectors:
   auto_ack: true
   milestone_push: true
@@ -108,10 +116,11 @@ acp:
 **`default_locale`**
 
 - Type: `string`
-- Default: `zh-CN`
+- Default: initialized from the browser language on the first web launch, then persisted as `zh-CN` or `en-US`
 - Allowed values: `zh-CN`, `en-US`
 - UI label: `Default locale`
-- Meaning: default prompt and UI language preference.
+- Meaning: default language preference used by prompts and runtime copy.
+- Notes: after the first browser-driven initialization, changing this field in `Settings` makes it a manual override and DeepScientist will not auto-follow the browser again.
 
 ### Daemon policy
 
@@ -1074,7 +1083,7 @@ servers:
 ```yaml
 # config.yaml
 default_runner: codex
-default_locale: zh-CN
+default_locale: en-US
 ui:
   host: 0.0.0.0
   port: 20999

package/docs/en/99_ACKNOWLEDGEMENTS.md

@@ -11,6 +11,7 @@ We especially thank the following projects for their ideas, research direction,
 - AlphaEvolve
 - OpenEvolve
 - EvoScientist
+- Orchestra-Research/AI-Research-SKILLs
 
 These projects have been important references for thinking about automated research, open-ended exploration, evolutionary search, experiment organization, and long-horizon research agents.
 

package/docs/images/connectors/discord-setup-overview.svg

@@ -0,0 +1,52 @@
+<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="#F7F7FF"/>
+  <rect x="40" y="40" width="1200" height="640" rx="28" fill="#FFFFFF" stroke="#DADCFB" stroke-width="2"/>
+  <circle cx="110" cy="108" r="34" fill="#5865F2"/>
+  <path d="M124.6 96.6c-2.4-1.8-4.8-3-7.4-3.8-.1 0-.2 0-.2.1-.3.6-.6 1.2-.9 1.9-2.8-.4-5.5-.4-8.2 0-.3-.6-.6-1.3-.9-1.9-.1-.1-.1-.1-.2-.1-2.6.8-5.1 2-7.4 3.8-.1 0-.1.1-.1.1-4.5 6.7-5.7 13.2-5.1 19.6 0 .1 0 .1.1.2 3.1 2.3 6.2 3.7 9.2 4.7.1 0 .2 0 .2-.1.7-1 1.3-2 1.8-3 .1-.1 0-.2-.1-.2-1-.4-1.9-.8-2.8-1.4-.1 0-.1-.2 0-.2.2-.1.4-.3.6-.4h.1c6 2.7 12.5 2.7 18.5 0h.1c.2.1.4.3.6.4.1.1.1.2 0 .2-.9.5-1.8 1-2.8 1.4-.1 0-.1.1-.1.2.5 1 1.1 2 1.8 3 .1.1.1.1.2.1 3-.9 6.1-2.4 9.2-4.7.1 0 .1-.1.1-.2.7-7.4-1.1-13.8-5.1-19.6 0 0 0-.1-.1-.1ZM104.8 112.5c-1.8 0-3.3-1.6-3.3-3.7s1.4-3.7 3.3-3.7c1.8 0 3.3 1.6 3.3 3.7-.1 2-1.5 3.7-3.3 3.7Zm14.4 0c-1.8 0-3.3-1.6-3.3-3.7s1.4-3.7 3.3-3.7c1.8 0 3.3 1.6 3.3 3.7s-1.4 3.7-3.3 3.7Z" fill="#fff"/>
+  <text x="164" y="98" fill="#0F172A" font-family="Arial, sans-serif" font-size="34" font-weight="700">Discord Setup Flow</text>
+  <text x="164" y="138" fill="#475569" font-family="Arial, sans-serif" font-size="20">Developer Portal -&gt; Bot token + Application ID -&gt; invite bot -&gt; one DM or mention</text>
+
+  <rect x="72" y="198" width="340" height="414" rx="26" fill="#FBFBFF" stroke="#D7D9FE" stroke-width="2"/>
+  <rect x="98" y="224" width="90" height="34" rx="17" fill="#EDE9FE"/>
+  <text x="122" y="246" fill="#4338CA" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 1</text>
+  <text x="98" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Create the app</text>
+  <rect x="98" y="324" width="288" height="76" rx="18" fill="#fff" stroke="#E3E5FF"/>
+  <text x="122" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Developer Portal</text>
+  <text x="122" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">General Information + Bot tab</text>
+  <rect x="98" y="416" width="288" height="92" rx="18" fill="#EEF2FF"/>
+  <text x="122" y="446" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Copy two values</text>
+  <text x="122" y="474" fill="#4338CA" font-family="Arial, sans-serif" font-size="16">bot_token</text>
+  <text x="122" y="498" fill="#4338CA" font-family="Arial, sans-serif" font-size="16">application_id</text>
+  <rect x="98" y="524" width="288" height="60" rx="18" fill="#fff" stroke="#E3E5FF"/>
+  <text x="122" y="560" fill="#475569" font-family="Arial, sans-serif" font-size="16">Enable bot user and keep Gateway mode</text>
+
+  <rect x="470" y="198" width="340" height="414" rx="26" fill="#FBFCFF" stroke="#DADCFB" stroke-width="2"/>
+  <rect x="496" y="224" width="90" height="34" rx="17" fill="#DBEAFE"/>
+  <text x="520" y="246" fill="#1D4ED8" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 2</text>
+  <text x="496" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Fill Settings</text>
+  <rect x="496" y="324" width="288" height="220" rx="18" fill="#fff" stroke="#DFE4FD"/>
+  <text x="520" y="356" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Connector fields</text>
+  <text x="520" y="390" fill="#334155" font-family="Arial, sans-serif" font-size="17">Enabled: on</text>
+  <text x="520" y="422" fill="#334155" font-family="Arial, sans-serif" font-size="17">transport: gateway</text>
+  <text x="520" y="454" fill="#334155" font-family="Arial, sans-serif" font-size="17">bot_token: paste from Bot tab</text>
+  <text x="520" y="486" fill="#334155" font-family="Arial, sans-serif" font-size="17">application_id: paste from General Info</text>
+  <text x="520" y="518" fill="#334155" font-family="Arial, sans-serif" font-size="17">guild_allowlist: optional</text>
+  <rect x="496" y="560" width="288" height="24" rx="12" fill="#111827"/>
+
+  <rect x="868" y="198" width="340" height="414" rx="26" fill="#FCFCFF" stroke="#DADCFB" stroke-width="2"/>
+  <rect x="894" y="224" width="90" height="34" rx="17" fill="#DCFCE7"/>
+  <text x="918" y="246" fill="#166534" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 3</text>
+  <text x="894" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Invite and verify</text>
+  <rect x="894" y="324" width="288" height="76" rx="18" fill="#fff" stroke="#E4E7FD"/>
+  <text x="918" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Generate one real event</text>
+  <text x="918" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Invite bot, then send one DM or @mention</text>
+  <rect x="894" y="416" width="288" height="76" rx="18" fill="#fff" stroke="#E4E7FD"/>
+  <text x="918" y="444" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Back to DeepScientist</text>
+  <text x="918" y="470" fill="#475569" font-family="Arial, sans-serif" font-size="16">Use the discovered target, not a guessed id</text>
+  <rect x="894" y="508" width="288" height="76" rx="18" fill="#ECFDF5"/>
+  <text x="918" y="536" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Final actions</text>
+  <text x="918" y="564" fill="#166534" font-family="Arial, sans-serif" font-size="16">Check -&gt; Send probe</text>
+
+  <path d="M423 406H455" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+  <path d="M821 406H853" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+</svg>

package/docs/images/connectors/feishu-setup-overview.svg

@@ -0,0 +1,53 @@
+<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="#F8FCFF"/>
+  <rect x="40" y="40" width="1200" height="640" rx="28" fill="#FFFFFF" stroke="#D7E7FF" stroke-width="2"/>
+  <rect x="76" y="74" width="68" height="68" rx="18" fill="#fff" stroke="#D7E7FF"/>
+  <path d="M104.3 112.1c18.1 0 33.9-10 42.1-24.8.3-.5.6-1 .9-1.5-.4.8-.9 1.5-1.4 2.2-.2.2-.4.4-.6.7-.2.3-.5.6-.8.8-.2.2-.4.4-.6.6-.4.4-.9.8-1.3 1.2-.2.2-.5.4-.8.6-.3.3-.6.5-.9.7l-.6.4-.6.4c-.5.3-1 .5-1.5.7-.4.2-.8.4-1.2.5-.5.2-1 .4-1.6.5-.8.2-1.6.4-2.3.5-.6.1-1.2.2-1.8.2-.7 0-1.4 0-2.1-.1-.7-.1-1.3-.1-2-.2-.5-.1-1-.2-1.5-.3l-.8-.2c-.7-.2-1.4-.4-2.1-.6-.3-.1-.7-.2-1-.3-.5-.2-1.1-.3-1.6-.5-.4-.1-.8-.3-1.3-.4-.4-.1-.8-.3-1.2-.4l-1.3-.5c-.3-.1-.7-.2-1-.4l-.9-.3c-.5-.2-1-.4-1.4-.6l-.8-.3-.9-.4-.9-.4-1.2-.5-1.3-.6c-.5-.2-.9-.4-1.4-.6l-1.1-.5c-20.4-10.2-38.7-23.9-54.2-40.6-.5-.5-1.3-.5-1.8 0-.2.2-.3.5-.3.9v17.3c0 3.6 1.8 6.9 4.8 8.8 14.3 9.5 31.1 14.5 48.2 14.5Z" fill="#3370FF"/>
+  <path d="M118.7 88.7c-1.9-3.1-1.1-7 .8-9.5 8.1-7.8 12.9-19.1 11.9-31.4C129.9 28.5 114 13.6 94.2 12.2 70.2 10.6 50 29.7 50 53.5v51.1c0 2.1 1.7 3.8 3.8 3.8h12.5c2.1 0 3.8-1.7 3.8-3.8V84.9c0-.6.1-1.2.2-1.8.8-3.7 3.9-6.6 7.8-6.8 4.1-.3 7.9 2.4 9 6.3l.7 2.5 5.9 21.6c.5 1.6 1.9 2.8 3.6 2.8h14.8c2.8 0 4.7-3 3.3-5.5l-12.2-23.1-.1-.2Zm-19.1-14.2c-8.6 1.1-15.9-6.2-14.8-14.9.7-5.9 5.4-10.6 11.3-11.4 8.6-1.1 15.9 6.2 14.8 14.8-.7 5.9-5.4 10.7-11.3 11.5Z" fill="#00D6B9"/>
+  <path d="M151.6 52.4c-6.8-3.3-14.5-4-21.8-2-.3.1-.6.2-.9.3l-.6.2c-.4.1-.9.3-1.2.4-.8.3-1.6.6-2.4 1-.8.4-1.5.8-2.2 1.2-.8.5-1.5.9-2.1 1.5-.5.4-1 .8-1.4 1.3-.5.5-1 .9-1.5 1.4l-.9.8-1.3 1.3-1 1-.8.8-.9.9-.8.8-1.4 1.4-.9.8-.3.3c-.2.1-.3.3-.5.5l-.3.3-.3.3c-3.4 3.1-7.2 5.8-11.2 8l1.2.5.9.4.9.4.9.3 1 .4 1.3.5c.4.1.8.3 1.2.4.5.2.9.3 1.4.5.5.2 1 .3 1.6.5.3.1.7.2 1 .3.7.2 1.4.4 2.1.6l.8.2c.5.1 1 .2 1.5.3.6.1 1.3.2 2 .2.7.1 1.4.1 2.1.1.6 0 1.2-.1 1.8-.2.8-.1 1.6-.3 2.3-.5.6-.1 1.1-.3 1.6-.5.4-.1.8-.3 1.2-.5.5-.2 1-.4 1.5-.7l.6-.4.6-.4c.3-.2.6-.4.9-.7.3-.2.5-.4.8-.6.5-.4.9-.8 1.3-1.2.2-.2.4-.4.6-.6.3-.3.5-.6.8-.8.2-.2.4-.5.6-.7.6-.7 1-1.4 1.4-2.2l.5-1 4.6-9.3.1-.1c1.5-3.3 3.6-6.3 6.1-8.8Z" fill="#133C9A"/>
+  <text x="164" y="98" fill="#0F172A" font-family="Arial, sans-serif" font-size="34" font-weight="700">Feishu / Lark Setup Flow</text>
+  <text x="164" y="138" fill="#475569" font-family="Arial, sans-serif" font-size="20">Open Platform -&gt; App ID + App Secret -&gt; long connection -&gt; one DM or @mention -&gt; probe</text>
+
+  <rect x="72" y="198" width="340" height="414" rx="26" fill="#FBFDFF" stroke="#D8E8FF" stroke-width="2"/>
+  <rect x="98" y="224" width="90" height="34" rx="17" fill="#DBEAFE"/>
+  <text x="122" y="246" fill="#1D4ED8" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 1</text>
+  <text x="98" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Create the app</text>
+  <rect x="98" y="324" width="288" height="84" rx="18" fill="#fff" stroke="#E0ECFF"/>
+  <text x="122" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Feishu Open Platform</text>
+  <text x="122" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Credentials page + app installation</text>
+  <rect x="98" y="424" width="288" height="84" rx="18" fill="#F0F9FF"/>
+  <text x="122" y="452" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Copy two values</text>
+  <text x="122" y="480" fill="#0369A1" font-family="Arial, sans-serif" font-size="16">app_id</text>
+  <text x="122" y="502" fill="#0369A1" font-family="Arial, sans-serif" font-size="16">app_secret</text>
+  <rect x="98" y="524" width="288" height="60" rx="18" fill="#fff" stroke="#E0ECFF"/>
+  <text x="122" y="560" fill="#475569" font-family="Arial, sans-serif" font-size="16">Install the app into the target tenant</text>
+
+  <rect x="470" y="198" width="340" height="414" rx="26" fill="#FCFDFF" stroke="#D8E8FF" stroke-width="2"/>
+  <rect x="496" y="224" width="90" height="34" rx="17" fill="#DCFCE7"/>
+  <text x="520" y="246" fill="#166534" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 2</text>
+  <text x="496" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Fill Settings</text>
+  <rect x="496" y="324" width="288" height="220" rx="18" fill="#fff" stroke="#E0ECFF"/>
+  <text x="520" y="356" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Connector fields</text>
+  <text x="520" y="390" fill="#334155" font-family="Arial, sans-serif" font-size="17">Enabled: on</text>
+  <text x="520" y="422" fill="#334155" font-family="Arial, sans-serif" font-size="17">transport: long_connection</text>
+  <text x="520" y="454" fill="#334155" font-family="Arial, sans-serif" font-size="17">app_id: paste from platform</text>
+  <text x="520" y="486" fill="#334155" font-family="Arial, sans-serif" font-size="17">app_secret: paste from platform</text>
+  <text x="520" y="518" fill="#334155" font-family="Arial, sans-serif" font-size="17">require_mention_in_groups: optional</text>
+  <rect x="496" y="560" width="288" height="24" rx="12" fill="#111827"/>
+
+  <rect x="868" y="198" width="340" height="414" rx="26" fill="#FBFDFF" stroke="#D8E8FF" stroke-width="2"/>
+  <rect x="894" y="224" width="90" height="34" rx="17" fill="#FDE68A"/>
+  <text x="918" y="246" fill="#92400E" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 3</text>
+  <text x="894" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Start one chat</text>
+  <rect x="894" y="324" width="288" height="84" rx="18" fill="#fff" stroke="#E0ECFF"/>
+  <text x="918" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Generate one event</text>
+  <text x="918" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Send one DM or @mention in Feishu</text>
+  <rect x="894" y="424" width="288" height="84" rx="18" fill="#fff" stroke="#E0ECFF"/>
+  <text x="918" y="452" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Back to DeepScientist</text>
+  <text x="918" y="478" fill="#475569" font-family="Arial, sans-serif" font-size="16">Wait until discovered targets appear</text>
+  <rect x="894" y="524" width="288" height="60" rx="18" fill="#FEFCE8"/>
+  <text x="918" y="560" fill="#92400E" font-family="Arial, sans-serif" font-size="16">Check -&gt; Send probe</text>
+
+  <path d="M423 406H455" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+  <path d="M821 406H853" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+</svg>

package/docs/images/connectors/slack-setup-overview.svg

@@ -0,0 +1,51 @@
+<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="#FCF8FC"/>
+  <rect x="40" y="40" width="1200" height="640" rx="28" fill="#FFFFFF" stroke="#E7D7E7" stroke-width="2"/>
+  <circle cx="110" cy="108" r="34" fill="#4A154B"/>
+  <path d="M103.1 93.3c0-3 2.4-5.5 5.5-5.5 3 0 5.5 2.5 5.5 5.5v5.5h-5.5c-3.1 0-5.5-2.5-5.5-5.5Zm-10.8 10.8h5.5v5.5c0 3.1-2.5 5.5-5.5 5.5-3.1 0-5.5-2.4-5.5-5.5 0-3 2.4-5.5 5.5-5.5Zm21.8 0h5.5c3 0 5.5 2.5 5.5 5.5 0 3.1-2.5 5.5-5.5 5.5-3.1 0-5.5-2.4-5.5-5.5v-5.5Zm-5.5 16.3v-5.5h5.5c3 0 5.5 2.5 5.5 5.5 0 3.1-2.5 5.5-5.5 5.5-3.1 0-5.5-2.4-5.5-5.5Zm-10.8-10.8v-5.5h5.5c3 0 5.5 2.5 5.5 5.5v16.3c0 3.1-2.5 5.5-5.5 5.5-3.1 0-5.5-2.4-5.5-5.5v-16.3Zm16.3-10.8v-5.5c0-3 2.4-5.5 5.5-5.5 3 0 5.5 2.5 5.5 5.5 0 3-2.5 5.5-5.5 5.5h-5.5Zm-16.3 0H92.3c-3.1 0-5.5-2.5-5.5-5.5 0-3 2.4-5.5 5.5-5.5 3 0 5.5 2.5 5.5 5.5v5.5Z" fill="#fff"/>
+  <text x="164" y="98" fill="#0F172A" font-family="Arial, sans-serif" font-size="34" font-weight="700">Slack Setup Flow</text>
+  <text x="164" y="138" fill="#475569" font-family="Arial, sans-serif" font-size="20">Slack app dashboard -&gt; Socket Mode -&gt; xoxb + xapp -&gt; one mention -&gt; probe</text>
+
+  <rect x="72" y="198" width="340" height="414" rx="26" fill="#FFFDFE" stroke="#E9D9E9" stroke-width="2"/>
+  <rect x="98" y="224" width="90" height="34" rx="17" fill="#F3E8FF"/>
+  <text x="122" y="246" fill="#6B21A8" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 1</text>
+  <text x="98" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Prepare the app</text>
+  <rect x="98" y="324" width="288" height="84" rx="18" fill="#fff" stroke="#EEE2EE"/>
+  <text x="122" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Slack App dashboard</text>
+  <text x="122" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Basic Information + Socket Mode</text>
+  <rect x="98" y="424" width="288" height="84" rx="18" fill="#FDF4FF"/>
+  <text x="122" y="452" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Copy two tokens</text>
+  <text x="122" y="480" fill="#6B21A8" font-family="Arial, sans-serif" font-size="16">Bot User OAuth Token: xoxb-...</text>
+  <text x="122" y="502" fill="#6B21A8" font-family="Arial, sans-serif" font-size="16">App-Level Token: xapp-...</text>
+  <rect x="98" y="524" width="288" height="60" rx="18" fill="#fff" stroke="#EEE2EE"/>
+  <text x="122" y="560" fill="#475569" font-family="Arial, sans-serif" font-size="16">Install app into the target workspace</text>
+
+  <rect x="470" y="198" width="340" height="414" rx="26" fill="#FFFCFF" stroke="#E7D7E7" stroke-width="2"/>
+  <rect x="496" y="224" width="90" height="34" rx="17" fill="#FDE68A"/>
+  <text x="520" y="246" fill="#92400E" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 2</text>
+  <text x="496" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Fill Settings</text>
+  <rect x="496" y="324" width="288" height="220" rx="18" fill="#fff" stroke="#EEE2EE"/>
+  <text x="520" y="356" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Connector fields</text>
+  <text x="520" y="390" fill="#334155" font-family="Arial, sans-serif" font-size="17">Enabled: on</text>
+  <text x="520" y="422" fill="#334155" font-family="Arial, sans-serif" font-size="17">transport: socket_mode</text>
+  <text x="520" y="454" fill="#334155" font-family="Arial, sans-serif" font-size="17">bot_token: xoxb-...</text>
+  <text x="520" y="486" fill="#334155" font-family="Arial, sans-serif" font-size="17">app_token: xapp-...</text>
+  <text x="520" y="518" fill="#334155" font-family="Arial, sans-serif" font-size="17">require_mention_in_groups: recommended</text>
+  <rect x="496" y="560" width="288" height="24" rx="12" fill="#111827"/>
+
+  <rect x="868" y="198" width="340" height="414" rx="26" fill="#FFFDFF" stroke="#E7D7E7" stroke-width="2"/>
+  <rect x="894" y="224" width="90" height="34" rx="17" fill="#DCFCE7"/>
+  <text x="918" y="246" fill="#166534" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 3</text>
+  <text x="894" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Mention and verify</text>
+  <rect x="894" y="324" width="288" height="84" rx="18" fill="#fff" stroke="#EEE2EE"/>
+  <text x="918" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Generate one event</text>
+  <text x="918" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Mention the app or send one DM in Slack</text>
+  <rect x="894" y="424" width="288" height="84" rx="18" fill="#fff" stroke="#EEE2EE"/>
+  <text x="918" y="452" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Use discovered target</text>
+  <text x="918" y="478" fill="#475569" font-family="Arial, sans-serif" font-size="16">Let runtime fill the channel or DM id first</text>
+  <rect x="894" y="524" width="288" height="60" rx="18" fill="#ECFDF5"/>
+  <text x="918" y="560" fill="#166534" font-family="Arial, sans-serif" font-size="16">Check -&gt; Send probe</text>
+
+  <path d="M423 406H455" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+  <path d="M821 406H853" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+</svg>

package/docs/images/connectors/telegram-setup-overview.svg

@@ -0,0 +1,55 @@
+<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="#F6FBFF"/>
+  <rect x="40" y="40" width="1200" height="640" rx="28" fill="#FFFFFF" stroke="#D6EAF8" stroke-width="2"/>
+  <circle cx="110" cy="108" r="34" fill="#26A5E4"/>
+  <path d="M125.4 88.5L118.2 123.1C117.7 125.5 116.4 126 114.5 124.9L103.3 116.7L97.9 121.9C97.3 122.5 96.8 123 95.5 123L96.3 111.6L117.2 92.7C118.1 91.9 117 91.4 115.8 92.1L90 108.4L78.9 104.9C76.5 104.1 76.4 102.4 79.4 101.2L122.6 84.5C124.6 83.8 126.4 85 125.4 88.5Z" fill="#fff"/>
+  <text x="164" y="98" fill="#0F172A" font-family="Arial, sans-serif" font-size="34" font-weight="700">Telegram Setup Flow</text>
+  <text x="164" y="138" fill="#475569" font-family="Arial, sans-serif" font-size="20">BotFather -&gt; DeepScientist polling -&gt; one DM -&gt; discovered target -&gt; probe</text>
+
+  <rect x="72" y="198" width="340" height="414" rx="26" fill="#F8FCFF" stroke="#B9DFF6" stroke-width="2"/>
+  <rect x="98" y="224" width="90" height="34" rx="17" fill="#E0F2FE"/>
+  <text x="122" y="246" fill="#0C4A6E" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 1</text>
+  <text x="98" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Open BotFather</text>
+  <rect x="98" y="324" width="288" height="68" rx="18" fill="#fff" stroke="#D4EAF7"/>
+  <text x="122" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Use /newbot</text>
+  <text x="122" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Create bot name + username</text>
+  <rect x="98" y="408" width="288" height="68" rx="18" fill="#fff" stroke="#D4EAF7"/>
+  <text x="122" y="436" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Copy bot_token</text>
+  <text x="122" y="462" fill="#475569" font-family="Arial, sans-serif" font-size="16">Keep the full token from BotFather</text>
+  <rect x="98" y="492" width="288" height="92" rx="18" fill="#EAF7FF"/>
+  <text x="122" y="522" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Official docs</text>
+  <text x="122" y="550" fill="#0369A1" font-family="Arial, sans-serif" font-size="16">core.telegram.org/bots</text>
+  <text x="122" y="574" fill="#0369A1" font-family="Arial, sans-serif" font-size="16">core.telegram.org/bots/tutorial</text>
+
+  <rect x="470" y="198" width="340" height="414" rx="26" fill="#F9FBFF" stroke="#CBDCF8" stroke-width="2"/>
+  <rect x="496" y="224" width="90" height="34" rx="17" fill="#EDE9FE"/>
+  <text x="520" y="246" fill="#4338CA" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 2</text>
+  <text x="496" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Fill Settings</text>
+  <rect x="496" y="324" width="288" height="200" rx="18" fill="#fff" stroke="#D8E2F4"/>
+  <text x="520" y="356" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Connector fields</text>
+  <text x="520" y="390" fill="#334155" font-family="Arial, sans-serif" font-size="17">Enabled: on</text>
+  <text x="520" y="422" fill="#334155" font-family="Arial, sans-serif" font-size="17">transport: polling</text>
+  <text x="520" y="454" fill="#334155" font-family="Arial, sans-serif" font-size="17">bot_token: paste from BotFather</text>
+  <text x="520" y="486" fill="#334155" font-family="Arial, sans-serif" font-size="17">command_prefix: /</text>
+  <text x="520" y="518" fill="#334155" font-family="Arial, sans-serif" font-size="17">require_mention_in_groups: optional</text>
+  <rect x="496" y="544" width="288" height="40" rx="14" fill="#111827"/>
+  <text x="594" y="570" fill="#fff" font-family="Arial, sans-serif" font-size="18" font-weight="700">Save first</text>
+
+  <rect x="868" y="198" width="340" height="414" rx="26" fill="#FBFCFF" stroke="#D8E2F4" stroke-width="2"/>
+  <rect x="894" y="224" width="90" height="34" rx="17" fill="#DCFCE7"/>
+  <text x="918" y="246" fill="#166534" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 3</text>
+  <text x="894" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Send one DM</text>
+  <rect x="894" y="324" width="288" height="68" rx="18" fill="#fff" stroke="#E1EAF7"/>
+  <text x="918" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Telegram message</text>
+  <text x="918" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Send /start or /help to the bot</text>
+  <rect x="894" y="408" width="288" height="68" rx="18" fill="#fff" stroke="#E1EAF7"/>
+  <text x="918" y="436" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Back to Settings</text>
+  <text x="918" y="462" fill="#475569" font-family="Arial, sans-serif" font-size="16">Pick the discovered target instead of typing ids</text>
+  <rect x="894" y="492" width="288" height="92" rx="18" fill="#ECFDF5"/>
+  <text x="918" y="522" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Final check</text>
+  <text x="918" y="550" fill="#166534" font-family="Arial, sans-serif" font-size="16">1. Click Check</text>
+  <text x="918" y="574" fill="#166534" font-family="Arial, sans-serif" font-size="16">2. Click Send probe</text>
+
+  <path d="M423 406H455" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+  <path d="M821 406H853" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+</svg>

package/docs/images/connectors/whatsapp-setup-overview.svg

@@ -0,0 +1,51 @@
+<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="#F7FFF9"/>
+  <rect x="40" y="40" width="1200" height="640" rx="28" fill="#FFFFFF" stroke="#D7F1DF" stroke-width="2"/>
+  <circle cx="110" cy="108" r="34" fill="#25D366"/>
+  <path d="M126.4 108.3c-.4-.2-2.4-1.2-2.8-1.3-.4-.1-.6-.2-.9.2-.3.4-1.1 1.3-1.3 1.6-.2.3-.5.3-.9.1-.4-.2-1.7-.6-3.3-2-.8-.8-1.4-1.5-1.7-2-.2-.4 0-.6.2-.8l.6-.7c.2-.3.3-.4.4-.7.1-.3.1-.5 0-.7-.1-.2-.9-2.2-1.2-3-.3-.8-.7-.7-.9-.7H112c-.3 0-.7.1-1 .5-.4.4-1.4 1.4-1.4 3.4 0 2 1.5 3.9 1.7 4.2.2.3 2.8 4.3 7 6 .9.4 1.6.7 2.3.8 1 .3 1.9.3 2.6.2.8-.1 2.4-1 2.8-1.9.3-.9.3-1.8.2-2 0-.2-.4-.3-.8-.5Zm-7.5 10.2h-.1c-2.7 0-5.3-.7-7.6-2.1l-.5-.3-5.6 1.5 1.5-5.5-.3-.6c-1.5-2.4-2.3-5.1-2.3-7.9 0-8.3 6.7-15 15-15 4 0 7.8 1.6 10.7 4.4 2.8 2.9 4.4 6.7 4.4 10.7 0 8.3-6.7 15-15 15Z" fill="#fff"/>
+  <text x="164" y="98" fill="#0F172A" font-family="Arial, sans-serif" font-size="34" font-weight="700">WhatsApp Setup Flow</text>
+  <text x="164" y="138" fill="#475569" font-family="Arial, sans-serif" font-size="20">DeepScientist local session -&gt; choose QR or pairing code -&gt; persist session -&gt; one real message</text>
+
+  <rect x="72" y="198" width="340" height="414" rx="26" fill="#FBFFFC" stroke="#D6F3DE" stroke-width="2"/>
+  <rect x="98" y="224" width="90" height="34" rx="17" fill="#DCFCE7"/>
+  <text x="122" y="246" fill="#166534" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 1</text>
+  <text x="98" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Choose local path</text>
+  <rect x="98" y="324" width="288" height="84" rx="18" fill="#fff" stroke="#E1F5E7"/>
+  <text x="122" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Preferred transport</text>
+  <text x="122" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Use local_session, not Meta Cloud by default</text>
+  <rect x="98" y="424" width="288" height="84" rx="18" fill="#ECFDF5"/>
+  <text x="122" y="452" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Pick login mode</text>
+  <text x="122" y="480" fill="#166534" font-family="Arial, sans-serif" font-size="16">QR browser</text>
+  <text x="122" y="502" fill="#166534" font-family="Arial, sans-serif" font-size="16">or pairing code on headless machines</text>
+  <rect x="98" y="524" width="288" height="60" rx="18" fill="#fff" stroke="#E1F5E7"/>
+  <text x="122" y="560" fill="#475569" font-family="Arial, sans-serif" font-size="16">Keep session_dir stable</text>
+
+  <rect x="470" y="198" width="340" height="414" rx="26" fill="#FBFFFC" stroke="#D6F3DE" stroke-width="2"/>
+  <rect x="496" y="224" width="90" height="34" rx="17" fill="#DBEAFE"/>
+  <text x="520" y="246" fill="#1D4ED8" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 2</text>
+  <text x="496" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Fill Settings</text>
+  <rect x="496" y="324" width="288" height="220" rx="18" fill="#fff" stroke="#E1F5E7"/>
+  <text x="520" y="356" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Connector fields</text>
+  <text x="520" y="390" fill="#334155" font-family="Arial, sans-serif" font-size="17">Enabled: on</text>
+  <text x="520" y="422" fill="#334155" font-family="Arial, sans-serif" font-size="17">transport: local_session</text>
+  <text x="520" y="454" fill="#334155" font-family="Arial, sans-serif" font-size="17">auth_method: qr_browser or pairing_code</text>
+  <text x="520" y="486" fill="#334155" font-family="Arial, sans-serif" font-size="17">session_dir: keep default unless isolated</text>
+  <text x="520" y="518" fill="#334155" font-family="Arial, sans-serif" font-size="17">command_prefix: /</text>
+  <rect x="496" y="560" width="288" height="24" rx="12" fill="#111827"/>
+
+  <rect x="868" y="198" width="340" height="414" rx="26" fill="#FBFFFC" stroke="#D6F3DE" stroke-width="2"/>
+  <rect x="894" y="224" width="90" height="34" rx="17" fill="#FDE68A"/>
+  <text x="918" y="246" fill="#92400E" font-family="Arial, sans-serif" font-size="18" font-weight="700">Step 3</text>
+  <text x="894" y="292" fill="#0F172A" font-family="Arial, sans-serif" font-size="28" font-weight="700">Login and verify</text>
+  <rect x="894" y="324" width="288" height="84" rx="18" fill="#fff" stroke="#E1F5E7"/>
+  <text x="918" y="352" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Complete local login</text>
+  <text x="918" y="378" fill="#475569" font-family="Arial, sans-serif" font-size="16">Scan QR or confirm the pairing code flow</text>
+  <rect x="894" y="424" width="288" height="84" rx="18" fill="#fff" stroke="#E1F5E7"/>
+  <text x="918" y="452" fill="#0F172A" font-family="Arial, sans-serif" font-size="18" font-weight="700">Send one real message</text>
+  <text x="918" y="478" fill="#475569" font-family="Arial, sans-serif" font-size="16">Wait for a discovered target before probing</text>
+  <rect x="894" y="524" width="288" height="60" rx="18" fill="#FEFCE8"/>
+  <text x="918" y="560" fill="#92400E" font-family="Arial, sans-serif" font-size="16">Check -&gt; Send probe</text>
+
+  <path d="M423 406H455" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+  <path d="M821 406H853" stroke="#94A3B8" stroke-width="8" stroke-linecap="round"/>
+</svg>

package/docs/images/lingzhu/lingzhu-openclaw-config.svg

@@ -0,0 +1,17 @@
+<svg width="1400" height="880" viewBox="0 0 1400 880" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="1400" height="880" rx="36" fill="#F5F1EA"/>
+  <rect x="90" y="70" width="1220" height="740" rx="28" fill="#1F2430"/>
+  <text x="130" y="130" fill="#F4EFE7" font-size="34" font-family="Courier New, monospace" font-weight="700">Generated OpenClaw config snippet</text>
+  <text x="130" y="190" fill="#B8C3CC" font-size="24" font-family="Courier New, monospace">{</text>
+  <text x="170" y="230" fill="#B8C3CC" font-size="24" font-family="Courier New, monospace">"gateway": { "port": 18789, "http": { "endpoints": { "chatCompletions": { "enabled": true }}}},</text>
+  <text x="170" y="280" fill="#B8C3CC" font-size="24" font-family="Courier New, monospace">"plugins": { "entries": { "lingzhu": { "enabled": true, "config": {</text>
+  <text x="210" y="330" fill="#C8D7E0" font-size="24" font-family="Courier New, monospace">"authAk": "&lt;auth_ak&gt;",</text>
+  <text x="210" y="372" fill="#C8D7E0" font-size="24" font-family="Courier New, monospace">"agentId": "main",</text>
+  <text x="210" y="414" fill="#C8D7E0" font-size="24" font-family="Courier New, monospace">"includeMetadata": true,</text>
+  <text x="210" y="456" fill="#C8D7E0" font-size="24" font-family="Courier New, monospace">"requestTimeoutMs": 60000,</text>
+  <text x="210" y="498" fill="#C8D7E0" font-size="24" font-family="Courier New, monospace">"defaultNavigationMode": "0", "enableFollowUp": true,</text>
+  <text x="210" y="540" fill="#C8D7E0" font-size="24" font-family="Courier New, monospace">"followUpMaxCount": 3, "sessionMode": "per_user",</text>
+  <text x="210" y="582" fill="#C8D7E0" font-size="24" font-family="Courier New, monospace">"sessionNamespace": "lingzhu", "maxImageBytes": 5242880</text>
+  <text x="170" y="632" fill="#B8C3CC" font-size="24" font-family="Courier New, monospace">}}}}</text>
+  <text x="130" y="690" fill="#F0D9B5" font-size="22" font-family="Arial, sans-serif">DeepScientist generates the full snippet in Settings so you can copy it directly.</text>
+</svg>

package/docs/images/lingzhu/lingzhu-platform-values.svg

@@ -0,0 +1,16 @@
+<svg width="1400" height="760" viewBox="0 0 1400 760" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="1400" height="760" rx="36" fill="#F4EFE7"/>
+  <rect x="90" y="80" width="1220" height="600" rx="28" fill="#FCFAF7" stroke="#D8D0C3"/>
+  <text x="130" y="150" fill="#2B2926" font-size="34" font-family="Arial, sans-serif" font-weight="700">Values to paste into the Lingzhu platform</text>
+
+  <rect x="130" y="210" width="1140" height="120" rx="22" fill="#E3EBEE" stroke="#A8BBC2"/>
+  <text x="165" y="260" fill="#314048" font-size="26" font-family="Arial, sans-serif" font-weight="700">SSE URL</text>
+  <text x="165" y="302" fill="#52616C" font-size="22" font-family="Arial, sans-serif">http://&lt;public-ip-or-domain&gt;:18789/metis/agent/api/sse</text>
+
+  <rect x="130" y="370" width="1140" height="120" rx="22" fill="#F1E5D8" stroke="#C8B99E"/>
+  <text x="165" y="420" fill="#3A352F" font-size="26" font-family="Arial, sans-serif" font-weight="700">Authorization / AK</text>
+  <text x="165" y="462" fill="#5B554E" font-size="22" font-family="Arial, sans-serif">Bearer &lt;the same auth_ak generated in DeepScientist&gt;</text>
+
+  <rect x="130" y="530" width="1140" height="100" rx="22" fill="#F7F2EC" stroke="#D8D0C3"/>
+  <text x="165" y="588" fill="#685F56" font-size="22" font-family="Arial, sans-serif">Reminder: devices need a public IP or public domain. Do not fill 127.0.0.1 here.</text>
+</svg>

package/docs/images/lingzhu/lingzhu-settings-overview.svg

@@ -0,0 +1,30 @@
+<svg width="1400" height="900" viewBox="0 0 1400 900" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="1400" height="900" rx="36" fill="#F5F1EA"/>
+  <rect x="70" y="70" width="1260" height="760" rx="28" fill="#FCFAF7" stroke="#D8D0C3"/>
+  <text x="110" y="140" fill="#2B2926" font-size="36" font-family="Arial, sans-serif" font-weight="700">Lingzhu Settings Overview</text>
+  <text x="110" y="182" fill="#7A7268" font-size="20" font-family="Arial, sans-serif">Fill endpoint, generate AK, then paste the public SSE URL and AK into the Lingzhu platform.</text>
+
+  <rect x="110" y="230" width="360" height="220" rx="24" fill="#F0E6D8" stroke="#C8B99E"/>
+  <text x="140" y="285" fill="#3A352F" font-size="28" font-family="Arial, sans-serif" font-weight="700">1. Gateway endpoint</text>
+  <text x="140" y="332" fill="#5B554E" font-size="20" font-family="Arial, sans-serif">- local_host</text>
+  <text x="140" y="365" fill="#5B554E" font-size="20" font-family="Arial, sans-serif">- gateway_port</text>
+  <text x="140" y="398" fill="#5B554E" font-size="20" font-family="Arial, sans-serif">- public_base_url</text>
+
+  <rect x="520" y="230" width="360" height="220" rx="24" fill="#DDE7EA" stroke="#A8BBC2"/>
+  <text x="550" y="285" fill="#2F3941" font-size="28" font-family="Arial, sans-serif" font-weight="700">2. Auth and identity</text>
+  <text x="550" y="332" fill="#52616C" font-size="20" font-family="Arial, sans-serif">- auth_ak</text>
+  <text x="550" y="365" fill="#52616C" font-size="20" font-family="Arial, sans-serif">- agent_id</text>
+  <text x="550" y="398" fill="#52616C" font-size="20" font-family="Arial, sans-serif">- system_prompt</text>
+
+  <rect x="930" y="230" width="290" height="220" rx="24" fill="#E8D7D7" stroke="#C4A8A8"/>
+  <text x="960" y="285" fill="#433232" font-size="28" font-family="Arial, sans-serif" font-weight="700">3. Probe</text>
+  <text x="960" y="332" fill="#685454" font-size="20" font-family="Arial, sans-serif">Run local health</text>
+  <text x="960" y="365" fill="#685454" font-size="20" font-family="Arial, sans-serif">then SSE smoke test</text>
+
+  <rect x="110" y="510" width="1110" height="250" rx="24" fill="#FBF7F2" stroke="#D8D0C3"/>
+  <text x="140" y="565" fill="#2B2926" font-size="28" font-family="Arial, sans-serif" font-weight="700">Generated values</text>
+  <text x="140" y="610" fill="#5B554E" font-size="20" font-family="Arial, sans-serif">- Local health URL: http://127.0.0.1:18789/metis/agent/api/health</text>
+  <text x="140" y="645" fill="#5B554E" font-size="20" font-family="Arial, sans-serif">- Local SSE URL: http://127.0.0.1:18789/metis/agent/api/sse</text>
+  <text x="140" y="680" fill="#5B554E" font-size="20" font-family="Arial, sans-serif">- Public SSE URL: http://&lt;public-ip&gt;:18789/metis/agent/api/sse</text>
+  <text x="140" y="715" fill="#5B554E" font-size="20" font-family="Arial, sans-serif">- OpenClaw config snippet and probe curl are generated below the form.</text>
+</svg>

package/docs/zh/00_QUICK_START.md

@@ -39,6 +39,28 @@ DeepScientist 现在使用 `uv` 管理锁定的本地 Python 运行时。如果
 
 默认情况下，DeepScientist home 在 macOS / Linux 上是 `~/DeepScientist`，在 Windows 上是 `%USERPROFILE%\\DeepScientist`。如果你希望放到别的路径，可以直接使用 `ds --home <path>`。
 
+如果你希望直接把“当前工作目录”作为 DeepScientist home，可以运行：
+
+```bash
+ds --here
+```
+
+它等价于 `ds --home "$PWD"`。
+
+如果你是从源码仓库安装，并希望把默认的 CLI 安装基路径改到别的位置，可以使用：
+
+```bash
+bash install.sh --dir /data/DeepScientist
+```
+
+如果你已经有一个正在使用的 DeepScientist home，之后又想安全迁移到别的路径，可以使用：
+
+```bash
+ds migrate /data/DeepScientist
+```
+
+`ds migrate` 会先显示当前绝对路径和目标绝对路径，停止托管 daemon，要求二次确认，校验复制结果，并在确认迁移成功后才删除旧路径。
+
 默认情况下，网页会运行在：
 
 ```text

package/docs/zh/01_SETTINGS_REFERENCE.md

@@ -44,7 +44,7 @@
 ```yaml
 home: ~/DeepScientist
 default_runner: codex
-default_locale: zh-CN
+default_locale: en-US # 或 zh-CN，首次打开 Web 时会按浏览器语言初始化
 daemon:
   session_restore_on_start: true
   max_concurrent_quests: 1
@@ -67,6 +67,14 @@ skills:
   sync_global_on_init: true
   sync_quest_on_create: true
   sync_quest_on_open: true
+bootstrap:
+  codex_ready: false
+  codex_last_checked_at: null
+  codex_last_result: {}
+  locale_source: browser
+  locale_initialized_from_browser: true
+  locale_initialized_at: 2026-03-18T00:00:00+00:00
+  locale_initialized_browser_locale: en-US
 connectors:
   auto_ack: true
   milestone_push: true
@@ -109,11 +117,12 @@ acp:
 **`default_locale`**
 
 - 类型：`string`
-- 默认值：`zh-CN`
+- 默认值：首次打开 Web 时按浏览器语言初始化，随后会落盘为 `zh-CN` 或 `en-US`
 - 允许值：`zh-CN`、`en-US`
 - 页面标签：`Default locale`
-- 作用：影响系统 prompt 的默认语言倾向以及部分 UI 默认文案。
-- 何时修改：希望整个系统默认说中文还是英文时修改。
+- 作用：影响系统 prompt 与运行时文案默认使用的语言。
+- 何时修改：希望整个系统固定偏向中文或英文时修改。
+- 注意事项：第一次浏览器初始化完成后，如果你在 `Settings` 手动修改这里，DeepScientist 会把它视为用户显式选择，后续不再自动跟随浏览器覆盖。
 
 ### Daemon policy
 
@@ -1107,7 +1116,7 @@ servers:
 ```yaml
 # config.yaml
 default_runner: codex
-default_locale: zh-CN
+default_locale: en-US
 ui:
   host: 0.0.0.0
   port: 20999

package/docs/zh/99_ACKNOWLEDGEMENTS.md

@@ -11,6 +11,7 @@ DeepScientist 的构思、架构设计与实现过程中，受到了许多优秀
 - AlphaEvolve
 - OpenEvolve
 - EvoScientist
+- Orchestra-Research/AI-Research-SKILLs
 
 这些项目在自动化科研、开放式探索、进化式搜索、实验组织与智能研究代理等方向上的探索，为 DeepScientist 的设计提供了重要参照。