fix: fix web api prcess url & optmize doc image load performence (#3003)

docs/docs/getting-started/cli-quickstart.md

@@ -21,6 +21,24 @@ uv pip install dbgpt-app
 pip install dbgpt-app
 ```
 
+:::tip Using a PyPI Mirror
+For faster downloads, specify a mirror when installing:
+
+```bash
+uv pip install dbgpt-app --index-url https://pypi.tuna.tsinghua.edu.cn/simple  # uv
+
+pip install dbgpt-app -i https://pypi.tuna.tsinghua.edu.cn/simple              # pip
+```
+
+Alternatively, set an environment variable to apply the mirror to **all** installs in the current shell session:
+
+```bash
+export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple   # uv
+
+export PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple  # pip
+```
+:::
+
 :::info What's included
 The default installation includes the **core framework** (CLI, FastAPI, SQLAlchemy, Agent),
 **OpenAI-compatible LLM support** (also works with Kimi, Qwen, MiniMax, Z.AI),

docs/docs/installation/index.md

@@ -26,7 +26,7 @@ DB-GPT offers three recommended installation paths. Pick the one that matches ho
 
 For MacOS / Linux users — choose this if you want the fewest steps to install, quickly launch the latest DB-GPT from source with automated environment setup and dependency installation.
 
-### CLI Install
+### CLI Install (Recommended)
 
 Choose this if you want to install DB-GPT directly from PyPI and use the `dbgpt` command to set up profiles interactively.
 

docs/docs/overview.mdx

@@ -58,6 +58,11 @@ import TabItem from "@theme/TabItem";
             <div className="quickstart-ns-body">
               <span className="quickstart-ns-label">Install the package</span>
               <CommandCopyCard command={`pip install dbgpt-app`} />
+              <div className="quickstart-tip">
+                <span className="quickstart-tip-icon">🌏</span>
+                <span className="quickstart-tip-text">Users in China region can use a mirror for faster downloads:</span>
+                <CommandCopyCard command={`pip install dbgpt-app -i https://pypi.tuna.tsinghua.edu.cn/simple`} />
+              </div>
             </div>
           </div>
           <div className="quickstart-ns">

docs/docs/use_cases.mdx

@@ -57,7 +57,7 @@ DB-GPT helps teams turn data questions into SQL, code, charts, dashboards, repor
 ## Featured scenarios
 
 <img
-  src="https://github.com/user-attachments/assets/ff9beb32-7db5-487a-bd81-d4489d853ea5"
+  src="/img/agentic_data/dbgpt_playgroup.png"
   alt="DB-GPT welcome page"
   className="showcase-hero-image"
 />
@@ -69,7 +69,7 @@ DB-GPT helps teams turn data questions into SQL, code, charts, dashboards, repor
 Use DB-GPT to plan tasks, break work into steps, call tools, and complete end-to-end analysis workflows.
 
 <img
-  src="https://github.com/user-attachments/assets/4921fa40-20f7-4a9c-b908-c0b4e7caa9d6"
+  src="/img/agentic_data/csv_data_analysis.jpg"
   alt="Agentic data analysis showcase"
   className="showcase-hero-image"
 />
@@ -80,12 +80,12 @@ Generate SQL and code to query data, clean datasets, compute metrics, and produc
 
 <div className="showcase-dual-grid">
   <img
-    src="https://github.com/user-attachments/assets/aeebc2b8-6c50-4ebb-96fd-07b860faa044"
+    src="/img/agentic_data/agentic_gen_code.png"
     alt="Agentic code generation"
     className="showcase-hero-image"
   />
   <img
-    src="https://github.com/user-attachments/assets/da45de20-3768-4f0d-ab20-e939ddf21361"
+    src="/img/agentic_data/agentic_sql_query.png"
     alt="SQL query generation"
     className="showcase-hero-image"
   />
@@ -107,12 +107,12 @@ Package domain knowledge, analysis methods, and execution workflows into reusabl
 
 <div className="showcase-dual-grid">
   <img
-    src="https://github.com/user-attachments/assets/39f39c36-a014-4a2e-8e14-b3af3f1d2f1c"
+    src="/img/skill/import_github_skill_.png"
     alt="Import GitHub skill"
     className="showcase-hero-image"
   />
   <img
-    src="https://github.com/user-attachments/assets/21864e9f-2179-4f6f-910f-18463ec2b46e"
+    src="/img/agentic_data/agent_browse_use.jpg"
     alt="Agent browse skill usage"
     className="showcase-hero-image"
   />
@@ -123,7 +123,7 @@ Package domain knowledge, analysis methods, and execution workflows into reusabl
 Run code and tools in isolated environments for safer, more reliable analysis.
 
 <img
-  src="https://github.com/user-attachments/assets/bfbd78e0-15e2-42ac-876f-5b91847aadc1"
+  src="/img/agentic_data/sanbox_running.png"
   alt="Sandboxed execution"
   className="showcase-hero-image"
 />

docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/cli-quickstart.md

@@ -26,6 +26,24 @@ uv pip install dbgpt-app
 pip install dbgpt-app
 ```
 
+:::tip 配置 PyPI 镜像源
+如果下载速度较慢，可在安装时指定镜像源加速：
+
+```bash
+uv pip install dbgpt-app --index-url https://pypi.tuna.tsinghua.edu.cn/simple  # uv
+
+pip install dbgpt-app -i https://pypi.tuna.tsinghua.edu.cn/simple              # pip
+```
+
+也可以通过环境变量，让当前终端会话中的**所有**安装命令自动使用镜像源：
+
+```bash
+export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple   # uv
+
+export PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple  # pip
+```
+:::
+
 :::info 默认包含内容
 默认安装会包含 **核心框架**（CLI、FastAPI、SQLAlchemy、Agent）、**OpenAI 兼容 LLM 支持**（也适用于 Kimi、Qwen、MiniMax、Z.AI）、**DashScope / Tongyi** 支持、**RAG 文档解析** 和 **ChromaDB** 向量存储。
 

docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/installation/index.md

@@ -26,7 +26,7 @@ DB-GPT 提供三种推荐安装方式。你可以根据自己的使用方式和
 
 MacOS / Linux 用户，如果你想以最少步骤完成安装，从源码快速启动最新版 DB-GPT，自动完成环境配置和依赖安装，选择这种方式。
 
-### CLI 安装
+### CLI 安装（推荐）
 
 如果你想直接通过 PyPI 安装 DB-GPT，并用 `dbgpt` 命令交互式配置 provider profile，选择这种方式。
 

docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/overview.mdx

@@ -58,6 +58,11 @@ import TabItem from "@theme/TabItem";
             <div className="quickstart-ns-body">
               <span className="quickstart-ns-label">安装包</span>
               <CommandCopyCard command={`pip install dbgpt-app`} />
+              <div className="quickstart-tip">
+                <span className="quickstart-tip-icon">🌏</span>
+                <span className="quickstart-tip-text">中国用户可使用国内镜像源加速下载：</span>
+                <CommandCopyCard command={`pip install dbgpt-app -i https://pypi.tuna.tsinghua.edu.cn/simple`} />
+              </div>
             </div>
           </div>
           <div className="quickstart-ns">

docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/use_cases.mdx

@@ -57,7 +57,7 @@ DB-GPT 帮助团队把数据问题转化为 SQL、代码、图表、仪表盘、
 ## 典型场景
 
 <img
-  src="https://github.com/user-attachments/assets/ff9beb32-7db5-487a-bd81-d4489d853ea5"
+  src="/img/agentic_data/dbgpt_playgroup.png"
   alt="DB-GPT 欢迎页"
   className="showcase-hero-image"
 />
@@ -69,7 +69,7 @@ DB-GPT 帮助团队把数据问题转化为 SQL、代码、图表、仪表盘、
 使用 DB-GPT 规划任务、拆解步骤、调用工具，并完成端到端的数据分析流程。
 
 <img
-  src="https://github.com/user-attachments/assets/4921fa40-20f7-4a9c-b908-c0b4e7caa9d6"
+  src="/img/agentic_data/csv_data_analysis.jpg"
   alt="Agentic 数据分析示例"
   className="showcase-hero-image"
 />
@@ -80,12 +80,12 @@ DB-GPT 帮助团队把数据问题转化为 SQL、代码、图表、仪表盘、
 
 <div className="showcase-dual-grid">
   <img
-    src="https://github.com/user-attachments/assets/aeebc2b8-6c50-4ebb-96fd-07b860faa044"
+    src="/img/agentic_data/agentic_gen_code.png"
     alt="Agentic 代码生成"
     className="showcase-hero-image"
   />
   <img
-    src="https://github.com/user-attachments/assets/da45de20-3768-4f0d-ab20-e939ddf21361"
+    src="/img/agentic_data/agentic_sql_query.png"
     alt="SQL 查询生成"
     className="showcase-hero-image"
   />
@@ -107,12 +107,12 @@ DB-GPT 帮助团队把数据问题转化为 SQL、代码、图表、仪表盘、
 
 <div className="showcase-dual-grid">
   <img
-    src="https://github.com/user-attachments/assets/39f39c36-a014-4a2e-8e14-b3af3f1d2f1c"
+    src="/img/skill/import_github_skill_zh.png"
     alt="导入 GitHub skill"
     className="showcase-hero-image"
   />
   <img
-    src="https://github.com/user-attachments/assets/21864e9f-2179-4f6f-910f-18463ec2b46e"
+    src="/img/agentic_data/agent_browse_use.jpg"
     alt="Agent 浏览技能使用示例"
     className="showcase-hero-image"
   />
@@ -123,7 +123,7 @@ DB-GPT 帮助团队把数据问题转化为 SQL、代码、图表、仪表盘、
 在隔离环境中运行代码与工具，让分析过程更加安全、可靠。
 
 <img
-  src="https://github.com/user-attachments/assets/bfbd78e0-15e2-42ac-876f-5b91847aadc1"
+  src="/img/agentic_data/sanbox_running.png"
   alt="沙箱执行"
   className="showcase-hero-image"
 />

docs/src/css/custom.css

@@ -1249,6 +1249,41 @@ a.overview-card:hover {
   border-color: rgba(111, 191, 168, 0.20);
 }
 
+/* Quickstart tip (e.g. China mirror hint) */
+.quickstart-tip {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.35rem 0.5rem;
+  margin-top: 0.65rem;
+  padding: 0.55rem 0.85rem;
+  border-radius: 8px;
+  background: rgba(37, 194, 160, 0.05);
+  border: 1px dashed rgba(37, 194, 160, 0.22);
+  font-size: 0.82rem;
+  line-height: 1.5;
+}
+
+.quickstart-tip-icon {
+  font-size: 1rem;
+  flex-shrink: 0;
+}
+
+.quickstart-tip-text {
+  color: var(--ifm-font-color-secondary);
+  flex-shrink: 0;
+}
+
+.quickstart-tip .command-copy-card {
+  width: 100%;
+  margin: 0.2rem 0 0;
+}
+
+[data-theme='dark'] .quickstart-tip {
+  background: rgba(111, 191, 168, 0.05);
+  border-color: rgba(111, 191, 168, 0.18);
+}
+
 /* ─── End Quick Start Tabs layout ─── */
 
 .showcase-grid {