1Panel-dev · wanghe-fit2cloud · Aug 28, 2026 · Aug 21, 2026 · Aug 21, 2026 · Aug 21, 2026
diff --git a/docs/css/extra.css b/docs/css/extra.css
@@ -2,6 +2,12 @@
   --md-primary-fg-color: #005EEB;
 }
 
+/*.md-content img {*/
+/*    border-radius: 0  0 10px 10px;*/
+/*    box-shadow: 0 2px 8px rgba(0,0,0,0.1);*/
+/*}*/
+
+
 .progress-label {
   position: absolute;
   text-align: center;
@@ -150,9 +156,10 @@
 /* 不添加浏览器导航栏的图片样式 */
 .md-content img:not(.browser-mockup img) {
   display: block;
-  box-shadow: 0 0.1em .5em 0 rgba(0, 0, 0, 0.4);
+  box-shadow: 0 6px 16px -2px rgba(0, 0, 0, 0.15);
   border: none;
-  border-radius: 4px;
+  border-radius: 10px;
+  margin: 0 0 1em 0;
 }
 
 .browser-mockup.none {
@@ -173,7 +180,7 @@
   border-top: 2em solid rgba(230, 230, 230, 0.8);
   box-shadow: 0 0.1em .5em 0 rgba(0, 0, 0, 0.4);
   position: relative;
-  border-radius: 4px 4px 4px 4px;
+  border-radius: 10px;
   max-width: 1200px;
   margin: 0 auto;
 }

diff --git a/docs/dev_manual/api_manual.md b/docs/dev_manual/api_manual.md
@@ -62,7 +62,7 @@
 
     - `API-Key`：面板 API 接口密钥。
     - `UnixTimestamp`：当前时间戳，秒级。
-    - `1panel` / `1panel:`：固定签名内容前缀。
+    - `1panel` / `1panel`：固定签名内容前缀。
 
 ### 2.3 Go 示例
 

diff --git a/docs/faq/faq.md b/docs/faq/faq.md
@@ -12,5 +12,5 @@
 
 !!! note ""
 
-    - 1Panel 基于 Golang 语言编写，可执行文件大小约 40MB、运行时占用系系统内存约 150MB
+    - 1Panel 基于 Golang 语言编写，可执行文件大小约 40MB、运行时占用系统内存约 150MB
     - 1Panel 基于 Docker 来部署管理其他应用，对系统的侵入影响非常小
diff --git a/docs/faq/openclaw.md b/docs/faq/openclaw.md
@@ -10,7 +10,7 @@
 !!! note ""
     OpenClaw 支持通过 1Panel 的智能体功能快速部署，具体可参考 [安装部署文档](../user_manual/appstore/openclaw.md)。
 
-## 如何通过 Ollama 运行本地模型？
+## 3 如何通过 Ollama 运行本地模型？
 
 
 !!! note ""

diff --git a/docs/faq/operating_system.md b/docs/faq/operating_system.md
@@ -24,7 +24,7 @@
     - 更新 systemd 管理，支持 systemd 后问题即可解决
     - 参考文档：[Systemd support is now available in WSL!](https://devblogs.microsoft.com/commandline/systemd-support-is-now-available-in-wsl/)
 
-## 3 使用 Fedora 37 安装面板后打开防火墙发现面板创建的端口规则未效果
+## 3 使用 Fedora 37 安装面板后打开防火墙发现面板创建的端口规则未生效
 
 !!! note ""
     **Fedora 37 默认区域不是 public 导致的，可以通过以下命令手动将默认区域设置为 public**

diff --git a/docs/img/ai/agent_channel_qq.png b/docs/img/ai/agent_channel_qq.png
diff --git a/docs/img/ai/agent_config_model.png b/docs/img/ai/agent_config_model.png
diff --git a/docs/img/ai/agent_create.png b/docs/img/ai/agent_create.png
diff --git a/docs/img/ai/agent_list.png b/docs/img/ai/agent_list.png
diff --git a/docs/img/ai/agent_overview.png b/docs/img/ai/agent_overview.png
diff --git a/docs/img/ai/agent_settings_other.png b/docs/img/ai/agent_settings_other.png
diff --git a/docs/img/ai/agent_skills_market.png b/docs/img/ai/agent_skills_market.png
diff --git a/docs/img/ai/ai_agent_normal.png b/docs/img/ai/ai_agent_normal.png
diff --git a/docs/img/ai/ai_gateway_api_key_create.png b/docs/img/ai/ai_gateway_api_key_create.png
diff --git a/docs/img/ai/ai_gateway_compliance_fenzu.png b/docs/img/ai/ai_gateway_compliance_fenzu.png
diff --git a/docs/img/ai/ai_gateway_compliance_shenheyangben.png b/docs/img/ai/ai_gateway_compliance_shenheyangben.png
diff --git a/docs/img/ai/ai_gateway_import_account.png b/docs/img/ai/ai_gateway_import_account.png
diff --git a/docs/img/ai/ai_gateway_smart_routing_sample.png b/docs/img/ai/ai_gateway_smart_routing_sample.png
diff --git a/docs/img/ai/ai_gateway_smart_routing_sample_juece.png b/docs/img/ai/ai_gateway_smart_routing_sample_juece.png
diff --git a/docs/img/ai/ai_gateway_smart_routing_sample_tongji.png b/docs/img/ai/ai_gateway_smart_routing_sample_tongji.png
diff --git a/docs/img/ai/ai_gateway_smart_routing_sample_yulan.png b/docs/img/ai/ai_gateway_smart_routing_sample_yulan.png
diff --git a/docs/img/ai/ai_gateway_usage_new_diaoyongrizhi.png b/docs/img/ai/ai_gateway_usage_new_diaoyongrizhi.png
diff --git a/docs/img/ai/ai_gateway_usage_new_fenbu.png b/docs/img/ai/ai_gateway_usage_new_fenbu.png
diff --git a/docs/img/ai/ai_gateway_usage_new_paihangbang.png b/docs/img/ai/ai_gateway_usage_new_paihangbang.png
diff --git a/docs/img/ai/create_mcp_server.png b/docs/img/ai/create_mcp_server.png
diff --git a/docs/img/ai/gpu_acceleration.png b/docs/img/ai/gpu_acceleration.png
diff --git a/docs/img/ai/gpu_monitor.png b/docs/img/ai/gpu_monitor.png
diff --git a/docs/img/ai/mcp_server_config.png b/docs/img/ai/mcp_server_config.png
diff --git a/docs/img/ai/mcp_website.png b/docs/img/ai/mcp_website.png
diff --git a/docs/img/ai/model_pull.png b/docs/img/ai/model_pull.png
diff --git a/docs/img/ai/model_run.png b/docs/img/ai/model_run.png
diff --git a/docs/img/ai/overview.png b/docs/img/ai/overview.png
diff --git a/docs/img/ai/skills_hub_import_github.png b/docs/img/ai/skills_hub_import_github.png
diff --git a/docs/img/ai/skills_hub_import_url.png b/docs/img/ai/skills_hub_import_url.png
diff --git a/docs/img/ai/skills_hub_list_pending.png b/docs/img/ai/skills_hub_list_pending.png
diff --git a/docs/img/ai/skills_hub_risk.png b/docs/img/ai/skills_hub_risk.png
diff --git a/docs/img/ai/skills_hub_targets.png b/docs/img/ai/skills_hub_targets.png
diff --git a/docs/img/ai/skills_hub_upload.png b/docs/img/ai/skills_hub_upload.png
diff --git a/docs/img/ai/vllm_create.png b/docs/img/ai/vllm_create.png
diff --git a/docs/installation/online_installation.md b/docs/installation/online_installation.md
@@ -125,4 +125,3 @@
     登录 1Panel Web 控制台，在页面右下角点击 **【检查更新】** 进行在线升级。
 
 ![在线升级检查更新](../img/installation/检查更新.png)
-{: .browser-mockup}
diff --git a/docs/installation/online_upgrade.md b/docs/installation/online_upgrade.md
@@ -2,4 +2,3 @@
 	登录 1Panel Web 控制台，在页面右下角点击 **【检查更新】** 进行在线升级。
 
 ![img.png](../img/installation/检查更新.png)
-{: .browser-mockup}
diff --git a/docs/user_manual/ai/agent.md b/docs/user_manual/ai/agent.md
@@ -13,20 +13,26 @@ schema_type: TechArticle
 !!! note ""
     1Panel 在 **AI -> 智能体** 中集中安装和管理受支持的智能体应用。当前页面包含智能体列表、模型账号，以及按智能体类型和版本动态显示的配置能力。
 
+![智能体列表](../../img/ai/agent_list.png)
+
 ## 1 使用前提
 
-- Docker 服务和应用商店状态正常。
-- 已准备要使用的模型服务及 API Key；也可以先在 **AI -> 模型管理 -> 模型账号** 中创建账号。
-- 服务器可以访问智能体应用镜像和所需的软件源。
-- 对外开放 WebUI 或频道前，已完成防火墙、域名、HTTPS 和访问控制配置。
+!!! note ""
+    - Docker 服务和应用商店状态正常。
+    - 已准备要使用的模型服务及 API Key；也可以先在 **AI -> 模型管理 -> 模型账号** 中创建账号。
+    - 服务器可以访问智能体应用镜像和所需的软件源。
+    - 对外开放 WebUI 或频道前，已完成防火墙、域名、HTTPS 和访问控制配置。
 
 ## 2 安装智能体
 
-1. 进入 **AI -> 智能体**。
-2. 点击 **安装**，选择页面当前支持的智能体类型。
-3. 填写名称、应用版本、WebUI 端口、认证信息和允许访问地址。
-4. 选择或新建模型账号，并根据需要配置模型池和备用模型。
-5. 确认参数后提交任务，在任务日志中查看安装结果。
+![创建智能体](../../img/ai/agent_create.png)
+
+!!! note ""
+    1. 进入 **AI -> 智能体**。
+    2. 点击 **创建**，选择页面当前支持的智能体类型。
+    3. 填写名称、应用版本、WebUI 端口、认证信息和允许访问地址。
+    4. 选择或新建模型账号，并根据需要配置模型池和备用模型。
+    5. 确认参数后提交任务，在任务日志中查看安装结果。
 
 !!! warning "访问地址"
     允许访问地址需要使用 `http://` 或 `https://` 开头的域名或 IP；只填写可信来源，避免把智能体管理界面直接暴露到公网。
@@ -36,31 +42,45 @@ schema_type: TechArticle
 !!! note ""
     智能体列表支持查看状态和版本，并根据当前状态执行概览、配置、终端、对话、启动、停止、重启、升级和删除等操作。不同智能体类型支持的按钮可能不同。
 
+![AI Agent日常管理](../../img/ai/ai_agent_normal.png)
+
 ### 3.1 概览
 
 !!! note ""
     概览展示运行状态、主模型、频道数量、技能数量、定时任务数量和会话数量等摘要。页面数据取决于智能体类型及其版本是否支持对应接口。
 
+![概览](../../img/ai/agent_overview.png)
+
 ### 3.2 模型
 
 !!! note ""
     模型页用于选择主模型、维护可用模型和备用模型。修改模型账号时，可以选择是否同步更新关联智能体的配置文件。
 
+![模型配置](../../img/ai/agent_config_model.png)
+
 ### 3.3 频道
 
 !!! note ""
     频道配置按智能体类型提供微信、企业微信、钉钉、飞书、QQ、Telegram、Discord 等接入项。实际可用频道、插件要求和字段由当前智能体版本决定；保存频道配置后，系统可能自动重启容器使配置生效。
 
+![QQ 频道配置](../../img/ai/agent_channel_qq.png)
+
 ### 3.4 技能与角色
+!!! note ""
+    - **技能**：查看内置、外部和工作区技能，并从页面支持的技能来源搜索和安装。
+    - **角色**：维护智能体工作区中的角色 Markdown 文件。保存后按页面提示重启容器。
 
-- **技能**：查看内置、外部和工作区技能，并从页面支持的技能来源搜索和安装。
-- **角色**：维护智能体工作区中的角色 Markdown 文件。保存后按页面提示重启容器。
+![技能市场](../../img/ai/agent_skills_js.png)
 
-### 3.5 设置
 
+![技能市场](../../img/ai/agent_skills_market.png)
+
+### 3.5 设置
 !!! note ""
     设置页包含安全、其他和配置文件等标签，可配置认证方式、时区、浏览器开关、NPM 源等。直接编辑配置文件前建议先备份；保存后需要重启的配置以页面提示为准。
 
+![设置-其他](../../img/ai/agent_settings_other.png)
+
 ## 4 多节点与批量操作
 
 !!! info "企业版能力"

diff --git a/docs/user_manual/ai/benchmark.md b/docs/user_manual/ai/benchmark.md
@@ -8,7 +8,6 @@
     该功能属于 [1Panel 企业版](https://1panel.cn/enterprise.html)。
 
 ![基准测试](../../img/ai/ai_benchmark_list.jpg)
-{: .original}
 
 ## 1 前置条件
 
@@ -31,7 +30,6 @@
     创建成功后，系统会启动后台任务执行基准测试，并可通过任务日志查看执行过程。
 
 ![创建基准测试](../../img/ai/ai_benchmark_create.jpg)
-{: .original}
 
 !!! info "基础参数"
     - **服务地址**：目标模型服务地址，例如 `http://127.0.0.1:4000`
@@ -59,7 +57,6 @@
     点击任务名称可打开详情抽屉，查看基础信息、运行配置、结果指标、启动命令和原始结果。
 
 ![基准测试详情](../../img/ai/ai_benchmark_detail.jpg)
-{: .original}
 
 !!! info "核心指标"
     - **上下文长度**：输入 Token 与输出 Token 上限之和
Original file line number	Diff line number	Diff line change
Expand Up		@@ -125,4 +125,3 @@
		登录 1Panel Web 控制台，在页面右下角点击【检查更新】进行在线升级。

		![在线升级检查更新](../img/installation/检查更新.png)
		{: .browser-mockup}
Original file line number	Diff line number	Diff line change
Expand Up		@@ -2,4 +2,3 @@
		登录 1Panel Web 控制台，在页面右下角点击【检查更新】进行在线升级。

		![img.png](../img/installation/检查更新.png)
		{: .browser-mockup}