diff --git a/docs/_extra/index.html b/docs/_extra/index.html
new file mode 100644
index 000000000..70235262f
--- /dev/null
+++ b/docs/_extra/index.html
@@ -0,0 +1,51 @@
+<!DOCTYPE html>
+<!--
+  Site root redirect (overrides whatever Sphinx generates from `_toc.yml`'s
+  ``root:`` directive). Copied verbatim into ``_build/html/index.html`` via
+  ``html_extra_path``, which fires after the build, so it wins.
+
+  Why hard-coded here:
+  - We want ``/`` to land on v2 (the recommended version) regardless of any
+    drift in jupyter-book / Sphinx defaults across upgrades.
+  - The v1 → v2 legacy redirect stubs at ``/<lang>/...`` paths are produced
+    by ``scripts/generate_v1_redirects.py`` and are NOT touched by this file.
+  - localStorage["preferred-language"] (set by _static/language.js on every
+    docs page) is honored so a returning Chinese reader lands on /v2/zh/.
+-->
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>AgentScope Java</title>
+  <meta name="robots" content="noindex" />
+  <link rel="canonical" href="https://java.agentscope.io/v2/en/intro.html" />
+  <!-- JS-disabled fallback: meta refresh straight to v2 English intro. -->
+  <meta http-equiv="refresh" content="0; url=v2/en/intro.html" />
+  <script>
+    (function () {
+      try {
+        var languages = ["en", "zh"];
+        var preferred = null;
+        try { preferred = localStorage.getItem("preferred-language"); } catch (e) {}
+        if (!preferred || languages.indexOf(preferred) === -1) {
+          var nav = (navigator.language || navigator.userLanguage || "").toLowerCase();
+          if (nav.indexOf("zh") === 0) {
+            preferred = "zh";
+          }
+        }
+        if (!preferred || languages.indexOf(preferred) === -1) {
+          preferred = "en";
+        }
+        location.replace("v2/" + preferred + "/intro.html");
+      } catch (e) {
+        location.replace("v2/en/intro.html");
+      }
+    })();
+  </script>
+</head>
+<body>
+  <p style="font-family: system-ui, sans-serif; max-width: 32em; margin: 4em auto; padding: 0 1em; color: #444;">
+    Redirecting to <a href="v2/en/intro.html">AgentScope Java 2.0 documentation</a>&hellip;
+  </p>
+</body>
+</html>
diff --git a/docs/v2/en/intro.md b/docs/v2/en/intro.md
index ac37d8bbe..827281d12 100644
--- a/docs/v2/en/intro.md
+++ b/docs/v2/en/intro.md
@@ -32,7 +32,6 @@ hide-toc: true
         </div>
         <div class="hs-window__tabs">
           <div class="hs-tab active" data-panel="en-harness">HarnessAgent</div>
-          <div class="hs-tab" data-panel="en-react">ReActAgent</div>
         </div>
       </div>
       <div class="hs-code-panel" id="en-harness"><pre><span class="kw">var</span> agent = <span class="ty">HarnessAgent</span>.builder()
@@ -44,17 +43,10 @@ hide-toc: true
     .build();
 agent.call(msg, <span class="ty">RuntimeContext</span>.builder()
     .sessionId(<span class="str">"demo"</span>).userId(<span class="str">"alice"</span>).build()).block();</pre></div>
-      <div class="hs-code-panel" id="en-react" style="display:none"><pre><span class="kw">var</span> agent = <span class="ty">ReActAgent</span>.builder()
-    .name(<span class="str">"assistant"</span>)
-    .sysPrompt(<span class="str">"You are a helpful assistant."</span>)
-    .model(<span class="str">"qwen-plus"</span>)            <span class="cm">// resolved via ModelRegistry; also "openai:gpt-4o" / "anthropic:claude-..."</span>
-    .toolkit(toolkit)
-    .build();
-<span class="cm">// streamEvents emits typed AgentEvent step by step — drives UI and HITL directly</span>
-agent.streamEvents(messages).blockLast();</pre></div>
       <div class="hs-install">
-        <code>io.agentscope:agentscope-harness</code>
-        <button class="hs-copy-btn" data-copy="io.agentscope:agentscope-harness">Copy Maven coords</button>
+        <code>io.agentscope:agentscope-harness:${agentscope.version}</code>
+        <button class="hs-copy-btn"
+                data-copy="&lt;dependency&gt;&#10;    &lt;groupId&gt;io.agentscope&lt;/groupId&gt;&#10;    &lt;artifactId&gt;agentscope-harness&lt;/artifactId&gt;&#10;    &lt;version&gt;${agentscope.version}&lt;/version&gt;&#10;&lt;/dependency&gt;">Copy Maven XML</button>
       </div>
     </div>
   </div>
diff --git a/docs/v2/zh/intro.md b/docs/v2/zh/intro.md
index 34e789233..dafca8e4a 100644
--- a/docs/v2/zh/intro.md
+++ b/docs/v2/zh/intro.md
@@ -32,7 +32,6 @@ hide-toc: true
         </div>
         <div class="hs-window__tabs">
           <div class="hs-tab active" data-panel="zh-harness">HarnessAgent</div>
-          <div class="hs-tab" data-panel="zh-react">ReActAgent</div>
         </div>
       </div>
       <div class="hs-code-panel" id="zh-harness"><pre><span class="kw">var</span> agent = <span class="ty">HarnessAgent</span>.builder()
@@ -44,17 +43,10 @@ hide-toc: true
     .build();
 agent.call(msg, <span class="ty">RuntimeContext</span>.builder()
     .sessionId(<span class="str">"demo"</span>).userId(<span class="str">"alice"</span>).build()).block();</pre></div>
-      <div class="hs-code-panel" id="zh-react" style="display:none"><pre><span class="kw">var</span> agent = <span class="ty">ReActAgent</span>.builder()
-    .name(<span class="str">"assistant"</span>)
-    .sysPrompt(<span class="str">"You are a helpful assistant."</span>)
-    .model(<span class="str">"qwen-plus"</span>)            <span class="cm">// ModelRegistry 解析；也支持 "openai:gpt-4o" / "anthropic:claude-..."</span>
-    .toolkit(toolkit)
-    .build();
-<span class="cm">// streamEvents 逐步发出类型化 AgentEvent，直接驱动 UI 与 HITL</span>
-agent.streamEvents(messages).blockLast();</pre></div>
       <div class="hs-install">
-        <code>io.agentscope:agentscope-harness</code>
-        <button class="hs-copy-btn" data-copy="io.agentscope:agentscope-harness">复制 Maven 坐标</button>
+        <code>io.agentscope:agentscope-harness:${agentscope.version}</code>
+        <button class="hs-copy-btn"
+                data-copy="&lt;dependency&gt;&#10;    &lt;groupId&gt;io.agentscope&lt;/groupId&gt;&#10;    &lt;artifactId&gt;agentscope-harness&lt;/artifactId&gt;&#10;    &lt;version&gt;${agentscope.version}&lt;/version&gt;&#10;&lt;/dependency&gt;">复制 Maven XML</button>
       </div>
     </div>
   </div>
