@researai/deepscientist 1.5.3 → 1.5.4

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

@@ -42,7 +42,7 @@ DeepScientist 现在使用 `uv` 管理锁定的本地 Python 运行时。如果
 如果你希望直接把“当前工作目录”作为 DeepScientist home，可以运行：
 
 ```bash
-ds --hero
+ds --here
 ```
 
 它等价于 `ds --home "$PWD"`。

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 的设计提供了重要参照。
 

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "@researai/deepscientist",
-  "version": "1.5.3",
+  "version": "1.5.4",
   "description": "Local-first research operating system with a Python runtime and npm launcher",
   "license": "MIT",
   "files": [
     "AGENTS.md",
     "README.md",
-    "docs/en/",
-    "docs/zh/",
+    "docs/",
     "install.sh",
     "uv.lock",
     "assets/branding/",
@@ -36,7 +35,12 @@
     "research": "bin/ds.js"
   },
   "dependencies": {
-    "@openai/codex": "^0.114.0"
+    "@openai/codex": "^0.114.0",
+    "ink": "npm:@jrichman/ink@6.4.6",
+    "ink-gradient": "^3.0.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "string-width": "^8.1.0"
   },
   "scripts": {
     "ds": "node ./bin/ds.js",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepscientist"
-version = "1.5.3"
+version = "1.5.4"
 description = "DeepScientist Core skeleton"
 readme = "README.md"
 requires-python = ">=3.11"

package/src/deepscientist/__init__.py

@@ -5,4 +5,4 @@ __all__ = ["__version__"]
 try:
     __version__ = _package_version("deepscientist")
 except PackageNotFoundError:  # pragma: no cover - source checkout fallback
-    __version__ = "1.5.3"
+    __version__ = "1.5.4"

package/src/deepscientist/bridges/base.py

@@ -8,9 +8,10 @@ from hashlib import sha256
 from typing import Any
 from urllib.error import URLError
 from urllib.parse import parse_qs
-from urllib.request import Request, urlopen
+from urllib.request import Request
 
 from ..connector_runtime import parse_conversation_id
+from ..network import urlopen_with_proxy as urlopen
 
 
 @dataclass

package/src/deepscientist/bridges/connectors.py

@@ -8,8 +8,9 @@ from hmac import new as hmac_new
 from pathlib import Path
 from typing import Any
 from urllib.error import HTTPError
-from urllib.request import Request, urlopen
+from urllib.request import Request
 
+from ..network import urlopen_with_proxy as urlopen
 from ..shared import append_jsonl, ensure_dir, utc_now
 from .base import BaseConnectorBridge, BridgeWebhookResult
 

package/src/deepscientist/channels/discord_gateway.py

@@ -5,12 +5,12 @@ import platform
 import threading
 from pathlib import Path
 from typing import Any, Callable
-from urllib.request import Request, urlopen
+from urllib.request import Request
 
 from websockets.exceptions import ConnectionClosed
-from websockets.sync.client import connect as websocket_connect
 
 from ..connector_runtime import format_conversation_id
+from ..network import urlopen_with_proxy as urlopen, websocket_connect_with_proxy as websocket_connect
 from ..shared import read_json, utc_now, write_json
 
 

package/src/deepscientist/channels/qq_gateway.py

@@ -5,13 +5,13 @@ import threading
 import time
 from pathlib import Path
 from typing import Any, Callable
-from urllib.request import Request, urlopen
+from urllib.request import Request
 
 from websockets.exceptions import ConnectionClosed
-from websockets.sync.client import connect as websocket_connect
 
 from ..bridges.connectors import QQConnectorBridge
 from ..connector_runtime import format_conversation_id
+from ..network import urlopen_with_proxy as urlopen, websocket_connect_with_proxy as websocket_connect
 from ..qq_profiles import qq_profile_label
 from ..shared import read_json, utc_now, write_json
 

package/src/deepscientist/channels/slack_socket.py

@@ -4,12 +4,12 @@ import json
 import threading
 from pathlib import Path
 from typing import Any, Callable
-from urllib.request import Request, urlopen
+from urllib.request import Request
 
 from websockets.exceptions import ConnectionClosed
-from websockets.sync.client import connect as websocket_connect
 
 from ..connector_runtime import format_conversation_id
+from ..network import urlopen_with_proxy as urlopen, websocket_connect_with_proxy as websocket_connect
 from ..shared import read_json, utc_now, write_json
 
 

package/src/deepscientist/channels/telegram_polling.py

@@ -4,9 +4,10 @@ import json
 import threading
 from pathlib import Path
 from typing import Any, Callable
-from urllib.request import Request, urlopen
+from urllib.request import Request
 
 from ..connector_runtime import format_conversation_id
+from ..network import urlopen_with_proxy as urlopen
 from ..shared import read_json, utc_now, write_json
 
 

package/src/deepscientist/cli.py

@@ -9,7 +9,7 @@ import sys
 import webbrowser
 from pathlib import Path
 from urllib.error import URLError
-from urllib.request import Request, urlopen
+from urllib.request import Request
 
 from .artifact import ArtifactService
 from .config import ConfigManager
@@ -18,6 +18,7 @@ from .doctor import render_doctor_report, run_doctor
 from .home import default_home, ensure_home_layout, repo_root
 from .memory import MemoryService
 from .migration import migrate_deepscientist_root
+from .network import configure_runtime_proxy, urlopen_with_proxy as urlopen
 from .prompts import PromptBuilder
 from .quest import QuestService
 from .registries import BaselineRegistry
@@ -37,6 +38,7 @@ def _local_ui_url(host: str, port: int) -> str:
 def build_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(prog="ds", description="DeepScientist Core skeleton")
     parser.add_argument("--home", default=None, help="Override DeepScientist home")
+    parser.add_argument("--proxy", default=None, help="Explicit outbound HTTP/WS proxy, for example `http://127.0.0.1:7890`.")
 
     subparsers = parser.add_subparsers(dest="command", required=True)
 
@@ -473,6 +475,7 @@ def migrate_command(home: Path, target: str) -> int:
 def main(argv: list[str] | None = None) -> int:
     parser = build_parser()
     args = parser.parse_args(argv)
+    configure_runtime_proxy(args.proxy)
     home = resolve_home(args)
 
     if args.command == "init":

package/src/deepscientist/config/models.py

@@ -56,6 +56,10 @@ def default_config(home: Path) -> dict:
             "codex_ready": False,
             "codex_last_checked_at": None,
             "codex_last_result": {},
+            "locale_source": "default",
+            "locale_initialized_from_browser": False,
+            "locale_initialized_at": None,
+            "locale_initialized_browser_locale": None,
         },
         "connectors": {
             "auto_ack": True,
@@ -91,9 +95,9 @@ def default_runners() -> dict:
             "sandbox_mode": "workspace-write",
             "retry_on_failure": True,
             "retry_max_attempts": 5,
-            "retry_initial_backoff_sec": 1.0,
-            "retry_backoff_multiplier": 2.0,
-            "retry_max_backoff_sec": 8.0,
+            "retry_initial_backoff_sec": 10.0,
+            "retry_backoff_multiplier": 6.0,
+            "retry_max_backoff_sec": 1800.0,
             # Increase MCP tool timeout so codex can wait for long `bash_exec(mode='await', ...)`
             # or other durable MCP calls without prematurely timing out.
             # Mirrors DS_2027's `codex.mcp_tool_timeout_sec` default.

package/src/deepscientist/config/service.py

@@ -6,7 +6,7 @@ import subprocess
 from copy import deepcopy
 from pathlib import Path
 from urllib.error import URLError
-from urllib.request import Request, urlopen
+from urllib.request import Request
 
 from ..connector_profiles import PROFILEABLE_CONNECTOR_NAMES, normalize_connector_config
 from ..connector_runtime import infer_connector_transport
@@ -29,6 +29,7 @@ from ..qq_profiles import (
     normalize_qq_connector_config,
     qq_profile_label,
 )
+from ..network import urlopen_with_proxy as urlopen
 from ..shared import read_json, read_text, read_yaml, resolve_runner_binary, run_command, sha256_text, utc_now, which, write_text, write_yaml
 from .models import (
     CONFIG_NAMES,
@@ -386,7 +387,7 @@ This page edits `{home_text}/config/runners.yaml`.
 - `claude` remains TODO / reserved in the current open-source release and is not runnable yet
 - keep `codex.model_reasoning_effort: xhigh` unless you explicitly want a lighter default
 - keep `codex.retry_on_failure: true` so transient Codex failures can resume automatically
-- keep retry timing near `1s / 2x / 8s max` unless you have a strong reason to slow recovery down
+- keep retry timing near `10s / 6x / 1800s max` so Codex backs off exponentially and the last retry waits about 30 minutes
 - DeepScientist hard-limits one turn to at most `5` total attempts, even if the config says more
 
 ## Test behavior
@@ -1320,11 +1321,20 @@ Use **Test** when the file exposes runtime dependencies.
         prepared = deepcopy(payload)
         if name == "config":
             prepared.pop("reports", None)
+            return self._normalize_config_payload(prepared)
         if name == "plugins":
             prepared = self._normalize_plugins_payload(prepared)
         elif name == "mcp_servers":
             prepared = self._normalize_mcp_payload(prepared)
         defaults = default_payload(name, self.home)
+        if name == "runners":
+            normalized = self._deep_merge(defaults, prepared)
+            codex = normalized.get("codex")
+            if isinstance(codex, dict) and self._looks_like_legacy_codex_retry_profile(codex):
+                codex["retry_initial_backoff_sec"] = 10.0
+                codex["retry_backoff_multiplier"] = 6.0
+                codex["retry_max_backoff_sec"] = 1800.0
+            return normalized
         if name == "connectors":
             normalized = deepcopy(defaults)
             for connector_name, connector_payload in prepared.items():
@@ -1358,6 +1368,46 @@ Use **Test** when the file exposes runtime dependencies.
             return normalized
         return self._deep_merge(defaults, prepared)
 
+    def _normalize_config_payload(self, payload: dict) -> dict:
+        defaults = default_payload("config", self.home)
+        normalized = self._deep_merge(defaults, payload)
+        bootstrap = normalized.get("bootstrap") if isinstance(normalized.get("bootstrap"), dict) else {}
+        raw_bootstrap = payload.get("bootstrap") if isinstance(payload.get("bootstrap"), dict) else {}
+        default_locale = str(defaults.get("default_locale") or "").strip()
+        current_locale = str(normalized.get("default_locale") or "").strip()
+        locale_source = str(raw_bootstrap.get("locale_source") or "").strip().lower()
+        locale_initialized_from_browser = bool(
+            raw_bootstrap.get("locale_initialized_from_browser", bootstrap.get("locale_initialized_from_browser", False))
+        )
+
+        if locale_source not in {"default", "browser", "user"}:
+            if current_locale and current_locale != default_locale:
+                locale_source = "user"
+            elif locale_initialized_from_browser:
+                locale_source = "browser"
+            else:
+                locale_source = "default"
+
+        if locale_source == "browser":
+            locale_initialized_from_browser = True
+
+        bootstrap["locale_source"] = locale_source
+        bootstrap["locale_initialized_from_browser"] = locale_initialized_from_browser
+        bootstrap["locale_initialized_at"] = bootstrap.get("locale_initialized_at")
+        bootstrap["locale_initialized_browser_locale"] = bootstrap.get("locale_initialized_browser_locale")
+        normalized["bootstrap"] = bootstrap
+        return normalized
+
+    @staticmethod
+    def _looks_like_legacy_codex_retry_profile(payload: dict) -> bool:
+        try:
+            initial = float(payload.get("retry_initial_backoff_sec"))
+            multiplier = float(payload.get("retry_backoff_multiplier"))
+            max_backoff = float(payload.get("retry_max_backoff_sec"))
+        except (TypeError, ValueError):
+            return False
+        return abs(initial - 1.0) < 1e-9 and abs(multiplier - 2.0) < 1e-9 and abs(max_backoff - 8.0) < 1e-9
+
     def _normalize_plugins_payload(self, payload: dict) -> dict:
         normalized = deepcopy(payload)
         if "load_paths" not in normalized and isinstance(normalized.get("search_paths"), list):

package/src/deepscientist/daemon/api/handlers.py

@@ -954,7 +954,7 @@ npm --prefix src/ui run build</pre>
     def latex_compile(self, project_id: str, folder_id: str, body: dict) -> dict:
         return self.app.latex_service.compile(
             project_id,
-            unquote(folder_id),
+            folder_id,
             compiler=body.get("compiler"),
             main_file_id=body.get("main_file_id"),
             stop_on_first_error=body.get("stop_on_first_error"),
@@ -968,13 +968,13 @@ npm --prefix src/ui run build</pre>
             limit = int(limit_raw)
         except ValueError:
             limit = 10
-        return self.app.latex_service.list_builds(project_id, unquote(folder_id), limit=limit)
+        return self.app.latex_service.list_builds(project_id, folder_id, limit=limit)
 
     def latex_build(self, project_id: str, folder_id: str, build_id: str) -> dict:
-        return self.app.latex_service.get_build(project_id, unquote(folder_id), build_id)
+        return self.app.latex_service.get_build(project_id, folder_id, build_id)
 
     def latex_build_pdf(self, project_id: str, folder_id: str, build_id: str) -> tuple[int, dict, bytes]:
-        payload, file_name = self.app.latex_service.get_build_pdf(project_id, unquote(folder_id), build_id)
+        payload, file_name = self.app.latex_service.get_build_pdf(project_id, folder_id, build_id)
         headers = {
             **self._asset_headers("application/pdf"),
             "Content-Disposition": f'inline; filename="{file_name}"',
@@ -982,11 +982,11 @@ npm --prefix src/ui run build</pre>
         return 200, headers, payload
 
     def latex_build_log(self, project_id: str, folder_id: str, build_id: str) -> tuple[int, dict, bytes]:
-        text = self.app.latex_service.get_build_log_text(project_id, unquote(folder_id), build_id)
+        text = self.app.latex_service.get_build_log_text(project_id, folder_id, build_id)
         return 200, self._asset_headers("text/plain; charset=utf-8"), text.encode("utf-8")
 
     def latex_archive(self, project_id: str, folder_id: str) -> tuple[int, dict, bytes]:
-        payload, file_name = self.app.latex_service.create_sources_archive(project_id, unquote(folder_id))
+        payload, file_name = self.app.latex_service.create_sources_archive(project_id, folder_id)
         headers = {
             **self._asset_headers("application/zip"),
             "Content-Disposition": f'attachment; filename="{file_name}"',