ruibaby · Apr 15, 2026 · Apr 15, 2026
diff --git a/docs/getting-started/first-post.md b/docs/getting-started/first-post.md
@@ -1,6 +1,6 @@
 ---
 title: 第一篇文章
-description: 安装完成后，如何写下第一篇文章。
+description: Halo 安装后写第一篇文章：进入控制台、编辑发布、分类标签与前台访问。
 ---
 
 <!-- markdownlint-disable MD034 -->

diff --git a/docs/getting-started/install/1panel.md b/docs/getting-started/install/1panel.md
@@ -1,6 +1,6 @@
 ---
 title: 使用 1Panel 部署
-description: 使用 1Panel 部署
+description: 通过 1Panel 安装 Halo：应用商店或容器方式部署与访问说明。
 ---
 
 import DockerArgs from "./slots/_docker-args.md"

diff --git a/docs/getting-started/install/bt-panel.md b/docs/getting-started/install/bt-panel.md
@@ -1,6 +1,6 @@
 ---
 title: 使用宝塔面板部署
-description: 使用宝塔面板部署
+description: 通过宝塔面板部署 Halo：环境要求、站点与反向代理配置说明。
 ---
 
 ::::info

diff --git a/docs/getting-started/install/cloud/alibaba-cloud-computenest.md b/docs/getting-started/install/cloud/alibaba-cloud-computenest.md
@@ -1,6 +1,6 @@
 ---
 title: 阿里云计算巢部署
-description: 使用阿里云计算巢服务部署 Halo
+description: 通过阿里云计算巢服务部署与管理 Halo 实例的说明。
 ---
 
 阿里云计算巢提供了软件与资源的一体化交付的完善基础能力，助力服务商、开发者的提升服务能力和降低运营成本。计算巢已经支持快速部署 Halo 社区版。

diff --git a/docs/getting-started/install/cloud/alibaba-cloud-market.md b/docs/getting-started/install/cloud/alibaba-cloud-market.md
@@ -1,6 +1,6 @@
 ---
 title: 阿里云云市场部署
-description: 使用阿里云云市场镜像部署 Halo
+description: 使用阿里云云市场 Halo 镜像快速创建实例与初始化说明。
 ---
 
 阿里云云市场提供围绕云计算产品的软件应用及服务，包括数据与 API、专业服务、基础软件、建站小程序、企业应用、安全、AI 与大数据计算、开发与运维、解决方案以及 IoT 十大类目市场，商品数量达上万种。

diff --git a/docs/getting-started/install/cloud/tencent-cloud-lighthouse.md b/docs/getting-started/install/cloud/tencent-cloud-lighthouse.md
@@ -1,6 +1,6 @@
 ---
 title: 腾讯云轻量应用模板
-description: 使用腾讯云轻量应用服务器的应用模板部署 Halo
+description: 腾讯云轻量应用服务器应用模板一键部署 Halo 的步骤说明。
 ---
 
 腾讯云目前已经在轻量应用服务器的应用模板中添加了 Halo 的模板镜像，选择应用模板购买服务器之后就预装了 Halo 和 [1Panel](https://1panel.cn/)。

diff --git a/docs/getting-started/install/config.md b/docs/getting-started/install/config.md
@@ -1,6 +1,6 @@
 ---
 title: 配置说明
-description: Halo 的运行配置说明文档
+description: Halo 运行时配置：环境变量、端口、数据库连接与工作目录等说明。
 ---
 
 在前面的部署文档中，为了保证部署流程的简洁，只说明了运行所必须的配置，但除了运行之外，Halo 还提供了不少其他的配置以及我们所使用的 Web 框架的配置，这个文档我们将详细介绍 Halo 的完整配置。

diff --git a/docs/getting-started/install/docker-compose.md b/docs/getting-started/install/docker-compose.md
@@ -1,6 +1,6 @@
 ---
 title: 使用 Docker Compose 部署
-description: 使用 Docker Compose 部署
+description: 使用 Docker Compose 部署 Halo：推荐方式、compose 配置与持久化卷说明。
 ---
 
 ```mdx-code-block

diff --git a/docs/getting-started/install/docker.md b/docs/getting-started/install/docker.md
@@ -1,6 +1,6 @@
 ---
 title: 使用 Docker 部署
-description: 使用 Docker 部署
+description: 使用 Docker 单容器运行 Halo：镜像、端口映射与数据目录挂载要点。
 ---
 
 import DockerArgs from "./slots/_docker-args.md"

diff --git a/docs/getting-started/install/helm.md b/docs/getting-started/install/helm.md
@@ -1,6 +1,6 @@
 ---
 title: 使用 Helm 部署
-description: 使用 Helm Chart 在 Kubernetes 集群中部署
+description: 使用 Helm Chart 在 Kubernetes 集群中安装与升级 Halo 的说明。
 ---
 
 import DockerArgs from "./slots/_docker-args.md"

diff --git a/docs/getting-started/install/jar-file.md b/docs/getting-started/install/jar-file.md
@@ -1,5 +1,6 @@
 ---
 title: 使用 JAR 文件部署
+description: 使用 JAR 与 Java 运行 Halo：数据库要求、启动参数与生产环境建议。
 ---
 
 :::info

diff --git a/docs/getting-started/install/offline.md b/docs/getting-started/install/offline.md
@@ -1,6 +1,6 @@
 ---
 title: 使用离线包部署
-description: 使用离线包在离线环境部署
+description: 在无公网或受限网络环境使用离线包部署 Halo 的步骤说明。
 ---
 
 import DockerArgs from "./slots/_docker-args.md"

diff --git a/docs/getting-started/install/other/nginxproxymanager.md b/docs/getting-started/install/other/nginxproxymanager.md
@@ -1,6 +1,6 @@
 ---
 title: Nginx Proxy Manager 反向代理
-description: 使用 Nginx Proxy Manager 管理 Halo 服务的反向代理
+description: 使用 Nginx Proxy Manager 为 Halo 配置域名转发与 SSL 证书说明。
 ---
 
 ## Halo 部署

diff --git a/docs/getting-started/install/other/traefik.md b/docs/getting-started/install/other/traefik.md
@@ -1,6 +1,6 @@
 ---
 title: Traefik 反向代理
-description: 使用 Traefik 管理 Halo 服务的反向代理
+description: Traefik 为 Halo 提供反向代理与 HTTPS 的路由与证书配置说明。
 ---
 
 ## Halo 部署

diff --git a/docs/getting-started/install/podman.md b/docs/getting-started/install/podman.md
@@ -1,6 +1,6 @@
 ---
 title: 使用 Podman 部署
-description: 使用 Podman 部署
+description: 使用 Podman 运行 Halo：与 Docker 类似的容器部署与持久化说明。
 ---
 
 import DockerArgs from "./slots/_docker-args.md"

diff --git a/docs/getting-started/migrate-from-1.x.md b/docs/getting-started/migrate-from-1.x.md
@@ -1,6 +1,6 @@
 ---
 title: 从 Halo 1.x 迁移
-description: 从 Halo 1.x 迁移的完整指南和注意事项
+description: Halo 1.5/1.6 迁移至 2.x：官方迁移插件、主题兼容与数据备份注意事项。
 ---
 
 因为 Halo 2.0 的底层架构变动，无法兼容 1.x 的数据，导致无法平滑升级，所以需要进行数据迁移。为此，我们提供了从 Halo 1.5 / 1.6 版本迁移的插件。在进行迁移之前，**有几点注意事项和要求，如果你目前无法满足，建议先暂缓迁移。**

diff --git a/docs/getting-started/prepare.md b/docs/getting-started/prepare.md
@@ -1,6 +1,6 @@
 ---
 title: 写在前面
-description: 在开始前，你需要了解的事项
+description: Halo 部署前必读：社区版与付费版、软硬件环境、域名与 HTTPS 等准备事项。
 ---
 
 ## 发行版本

diff --git a/docs/getting-started/setup.md b/docs/getting-started/setup.md
@@ -1,6 +1,6 @@
 ---
 title: 初始化
-description: 首次安装的初始化指南
+description: Halo 首次初始化向导：站点标题、管理员用户名、邮箱与密码设置说明。
 ---
 
 通过之前的安装文档，你已经成功安装了 Halo，在首次访问网站的时候会自动跳转到初始化页面，你需要完成这个步骤才能正常使用 Halo。

diff --git a/docs/user-guide/activate.md b/docs/user-guide/activate.md
@@ -1,6 +1,6 @@
 ---
 title: 许可证激活
-description: 介绍如何激活 Halo 付费版
+description: Halo 付费版许可证购买、部署与激活流程，含专业版与商城版说明。
 ---
 
 :::note

diff --git a/docs/user-guide/app-store.md b/docs/user-guide/app-store.md
@@ -1,6 +1,6 @@
 ---
 title: 应用市场
-description: 内置应用市场的使用说明
+description: 在 Console 内置应用市场安装 Halo 主题与插件，含账号绑定与更新说明。
 ---
 
 为了方便使用者安装应用市场的主题和插件，我们提供了一个内置到 Console 的应用市场插件，可以更加方便在 Console 直接安装主题和插件。并且此插件从 Halo 2.10 开始已经预设到 Halo 中，无需手动安装。

diff --git a/docs/user-guide/attachments.md b/docs/user-guide/attachments.md
@@ -1,6 +1,6 @@
 ---
 title: 附件
-description: 附件管理相关功能说明
+description: Halo 附件与存储策略：本地上传、策略管理及对象存储等扩展方式。
 ---
 
 ## 存储策略

diff --git a/docs/user-guide/backup.md b/docs/user-guide/backup.md
@@ -1,6 +1,6 @@
 ---
 title: 备份与恢复
-description: 备份与恢复功能说明
+description: Halo 控制台一键备份与恢复全站数据，含异步任务与商城版注意事项。
 ---
 
 从 Halo 2.8 开始，Halo 内置了备份和恢复的功能，可以在 Console 中一键备份和恢复完整的数据。

diff --git a/docs/user-guide/common.md b/docs/user-guide/common.md
@@ -1,6 +1,6 @@
 ---
 title: 基础说明
-description: Halo 中的基本概念说明
+description: Halo 建站入门：登录注册、控制台、角色分类与站点基础概念说明。
 ---
 Halo 作为一款好用又强大的开源建站工具，配合上不同的模板与插件，可以很好地帮助你构建你心中的理想站点。它可以是你公司的官方网站，可以是你的个人博客，也可以是团队共享的知识库，甚至可以是一个论坛、一个商城。
 

diff --git a/docs/user-guide/faq.md b/docs/user-guide/faq.md
@@ -1,6 +1,6 @@
 ---
 title: 常见问题
-description: 使用上的常见问题
+description: Halo 使用常见问题：产品定位、数据库结构、找回密码与故障排查。
 ---
 
 ### Halo 是什么？

diff --git a/docs/user-guide/menus.md b/docs/user-guide/menus.md
@@ -1,6 +1,6 @@
 ---
 title: 菜单
-description: 菜单管理相关功能说明
+description: Halo 网站导航菜单：多菜单组、主菜单、菜单项与排序配置说明。
 ---
 
 菜单功能用于管理网站上的导航菜单，目前 Halo 支持配置多个菜单组。

diff --git a/docs/user-guide/pages.md b/docs/user-guide/pages.md
@@ -1,6 +1,6 @@
 ---
 title: 页面
-description: 页面管理相关功能说明
+description: Halo 自定义页面：关于页、联系页等独立页面与别名 URL 访问说明。
 ---
 
 页面与文章类似，同样包含页面标题和富文本形式的页面内容。与文章不同的是页面无法设置所属分类和标签信息，一般用于站点中单一展示功能的页面，例如常见的站点关于页面、联系我们页面等。

diff --git a/docs/user-guide/plugins.md b/docs/user-guide/plugins.md
@@ -1,6 +1,6 @@
 ---
 title: 插件
-description: 插件管理相关功能说明
+description: Halo 插件安装、启用与卸载，及应用市场等获取渠道的管理指南。
 ---
 
 插件是用于扩展 Halo 功能的软件包。插件独立于 Halo 核心应用，可以单独安装、升级、卸载。

diff --git a/docs/user-guide/posts.md b/docs/user-guide/posts.md
@@ -1,6 +1,6 @@
 ---
 title: 文章
-description: 文章管理相关功能说明
+description: Halo 文章编辑发布：编辑器、分类标签、定时发布与回收站等操作。
 ---
 ## 新建文章
 

diff --git a/docs/user-guide/settings.md b/docs/user-guide/settings.md
@@ -1,6 +1,6 @@
 ---
 title: 站点设置
-description: 站点设置相关功能说明
+description: Halo 站点设置：基本信息、文章展示、评论、用户与 SEO 等控制台项。
 ---
 
 ## 基本设置

diff --git a/docs/user-guide/shop/console-home.mdx b/docs/user-guide/shop/console-home.mdx
@@ -1,6 +1,6 @@
 ---
 title: 控制台首页
-description: 商城控制台首页相关使用文档。
+description: Halo 商城控制台首页：运营数据、指引与商店信息一览说明。
 ---
 
 控制台的商店首页主要用于查看运营数据、指引、商店数据等信息。

diff --git a/docs/user-guide/shop/index.mdx b/docs/user-guide/shop/index.mdx
@@ -1,6 +1,6 @@
 ---
 title: 商城
-description: 商城相关的使用文档。
+description: Halo 商城版功能概览：开店、商品、支付发货与前台路由等用户指南索引。
 ---
 
 import Tabs from '@theme/Tabs';

diff --git a/docs/user-guide/shop/orders.mdx b/docs/user-guide/shop/orders.mdx
@@ -1,6 +1,6 @@
 ---
 title: 订单管理
-description: 商城订单管理相关使用文档。
+description: Halo 商城订单：查看详情、填写物流发货与订单处理操作说明。
 ---
 
 ![](/img/user-guide/shop/preview-console-orders.png)

diff --git a/docs/user-guide/shop/payments.mdx b/docs/user-guide/shop/payments.mdx
@@ -1,6 +1,6 @@
 ---
 title: 支付方式
-description: 商城支付方式相关使用文档。
+description: Halo 商城支付：支付宝、微信、Stripe、易支付及手动收款等方式配置。
 ---
 
 import Tabs from '@theme/Tabs';

diff --git a/docs/user-guide/shop/prepare.mdx b/docs/user-guide/shop/prepare.mdx
@@ -1,6 +1,6 @@
 ---
 title: 写在前面
-description: 在开始使用商城功能之前，你需要了解的事项
+description: 启用 Halo 商城前：商城版安装激活、合规资质与支付宝/微信支付准备。
 ---
 
 ## 前提条件

diff --git a/docs/user-guide/shop/products.mdx b/docs/user-guide/shop/products.mdx
@@ -1,6 +1,6 @@
 ---
 title: 产品管理
-description: 商城产品管理相关使用文档。
+description: Halo 商城产品：创建实体/虚拟商品、定价库存、图片与描述等配置说明。
 ---
 
 import Tabs from '@theme/Tabs';

diff --git a/docs/user-guide/shop/sales-channels.mdx b/docs/user-guide/shop/sales-channels.mdx
@@ -1,6 +1,6 @@
 ---
 title: 销售渠道
-description: 商城销售渠道相关使用文档。
+description: Halo 商城销售渠道：区分终端与支付绑定，创建与管理渠道说明。
 ---
 
 import Tabs from '@theme/Tabs';

diff --git a/docs/user-guide/shop/theme-dev.mdx b/docs/user-guide/shop/theme-dev.mdx
@@ -1,5 +1,6 @@
 ---
 title: 商城主题开发
+description: Halo 商城页面主题定制：内置模板、示例主题仓库与二次开发参考。
 ---
 
 默认情况下，我们已经在 Halo 本身内置了一套默认的商城模板，如果当前主题没有提供对应的模板文件，则会使用内置的模板文件。

diff --git a/docs/user-guide/shop/virtual-delivery.mdx b/docs/user-guide/shop/virtual-delivery.mdx
@@ -1,6 +1,6 @@
 ---
 title: 虚拟交付
-description: 商城虚拟交付相关使用文档。
+description: Halo 商城虚拟商品：文件下载与卡密交付的配置及发货流程说明。
 ---
 
 在 Halo 2.23 中，我们完善了虚拟产品的发货功能，目前支持文件资源下载、卡密发货。

diff --git a/docs/user-guide/themes.md b/docs/user-guide/themes.md
@@ -1,6 +1,6 @@
 ---
 title: 主题
-description: 主题管理相关功能说明
+description: Halo 主题安装与切换、应用市场获取及模板与站点变量配置说明。
 ---
 
 主题包含了各种站点页面模板的资源包。用户访问 Halo 站点浏览到的内容及样式，由 Halo 管理端所配置使用的主题所决定。

diff --git a/docs/user-guide/user-center.md b/docs/user-guide/user-center.md
@@ -1,6 +1,6 @@
 ---
 title: 个人中心
-description: 关于个人中心的功能说明
+description: Halo 个人中心（/uc）：资料、认证方式与会话及与 Console 的入口说明。
 ---
 
 从 Halo 2.11 开始，除了 Console 管理控制台，我们新增加了个人中心，用于管理和用户相关的所有功能。有了个人中心之后，也可以让网站有更多的使用和开发场景。

diff --git a/docs/user-guide/users.md b/docs/user-guide/users.md
@@ -1,6 +1,6 @@
 ---
 title: 用户与权限
-description: 用户管理、权限配置相关功能说明
+description: Halo 用户与 RBAC：多用户、角色权限、密码与会话等管理说明。
 ---
 
 ## 概览

diff --git a/versioned_docs/version-2.23/getting-started/first-post.md b/versioned_docs/version-2.23/getting-started/first-post.md
@@ -1,6 +1,6 @@
 ---
 title: 第一篇文章
-description: 安装完成后，如何写下第一篇文章。
+description: Halo 安装后写第一篇文章：进入控制台、编辑发布、分类标签与前台访问。
 ---
 
 <!-- markdownlint-disable MD034 -->

diff --git a/versioned_docs/version-2.23/getting-started/install/1panel.md b/versioned_docs/version-2.23/getting-started/install/1panel.md
@@ -1,6 +1,6 @@
 ---
 title: 使用 1Panel 部署
-description: 使用 1Panel 部署
+description: 通过 1Panel 安装 Halo：应用商店或容器方式部署与访问说明。
 ---
 
 import DockerArgs from "./slots/_docker-args.md"

diff --git a/versioned_docs/version-2.23/getting-started/install/bt-panel.md b/versioned_docs/version-2.23/getting-started/install/bt-panel.md
@@ -1,6 +1,6 @@
 ---
 title: 使用宝塔面板部署
-description: 使用宝塔面板部署
+description: 通过宝塔面板部署 Halo：环境要求、站点与反向代理配置说明。
 ---
 
 ::::info

diff --git a/...ed_docs/version-2.23/getting-started/install/cloud/alibaba-cloud-computenest.md b/...ed_docs/version-2.23/getting-started/install/cloud/alibaba-cloud-computenest.md
@@ -1,6 +1,6 @@
 ---
 title: 阿里云计算巢部署
-description: 使用阿里云计算巢服务部署 Halo
+description: 通过阿里云计算巢服务部署与管理 Halo 实例的说明。
 ---
 
 阿里云计算巢提供了软件与资源的一体化交付的完善基础能力，助力服务商、开发者的提升服务能力和降低运营成本。计算巢已经支持快速部署 Halo 社区版。

diff --git a/versioned_docs/version-2.23/getting-started/install/cloud/alibaba-cloud-market.md b/versioned_docs/version-2.23/getting-started/install/cloud/alibaba-cloud-market.md
@@ -1,6 +1,6 @@
 ---
 title: 阿里云云市场部署
-description: 使用阿里云云市场镜像部署 Halo
+description: 使用阿里云云市场 Halo 镜像快速创建实例与初始化说明。
 ---
 
 阿里云云市场提供围绕云计算产品的软件应用及服务，包括数据与 API、专业服务、基础软件、建站小程序、企业应用、安全、AI 与大数据计算、开发与运维、解决方案以及 IoT 十大类目市场，商品数量达上万种。

diff --git a/...ned_docs/version-2.23/getting-started/install/cloud/tencent-cloud-lighthouse.md b/...ned_docs/version-2.23/getting-started/install/cloud/tencent-cloud-lighthouse.md
@@ -1,6 +1,6 @@
 ---
 title: 腾讯云轻量应用模板
-description: 使用腾讯云轻量应用服务器的应用模板部署 Halo
+description: 腾讯云轻量应用服务器应用模板一键部署 Halo 的步骤说明。
 ---
 
 腾讯云目前已经在轻量应用服务器的应用模板中添加了 Halo 的模板镜像，选择应用模板购买服务器之后就预装了 Halo 和 [1Panel](https://1panel.cn/)。

diff --git a/versioned_docs/version-2.23/getting-started/install/config.md b/versioned_docs/version-2.23/getting-started/install/config.md
@@ -1,6 +1,6 @@
 ---
 title: 配置说明
-description: Halo 的运行配置说明文档
+description: Halo 运行时配置：环境变量、端口、数据库连接与工作目录等说明。
 ---
 
 在前面的部署文档中，为了保证部署流程的简洁，只说明了运行所必须的配置，但除了运行之外，Halo 还提供了不少其他的配置以及我们所使用的 Web 框架的配置，这个文档我们将详细介绍 Halo 的完整配置。

diff --git a/versioned_docs/version-2.23/getting-started/install/docker-compose.md b/versioned_docs/version-2.23/getting-started/install/docker-compose.md
@@ -1,6 +1,6 @@
 ---
 title: 使用 Docker Compose 部署
-description: 使用 Docker Compose 部署
+description: 使用 Docker Compose 部署 Halo：推荐方式、compose 配置与持久化卷说明。
 ---
 
 ```mdx-code-block

diff --git a/versioned_docs/version-2.23/getting-started/install/docker.md b/versioned_docs/version-2.23/getting-started/install/docker.md
@@ -1,6 +1,6 @@
 ---
 title: 使用 Docker 部署
-description: 使用 Docker 部署
+description: 使用 Docker 单容器运行 Halo：镜像、端口映射与数据目录挂载要点。
 ---
 
 import DockerArgs from "./slots/_docker-args.md"