Reorganize the user guide and improve documentation navigation

docs/developer-guide/_meta.json

@@ -2,7 +2,7 @@
   {
     "type": "file",
     "name": "index",
-    "label": "概览"
+    "label": "内容导航"
   },
   {
     "type": "dir",

docs/guide/_meta.json

@@ -2,17 +2,18 @@
   {
     "type": "file",
     "name": "index",
-    "label": "概览"
+    "label": "内容导航"
   },
   {
     "type": "section-header",
     "label": "入门"
   },
   "prepare",
+  "demo",
   {
     "type": "dir",
     "name": "install",
-    "label": "安装",
+    "label": "快速安装",
     "collapsed": true
   },
   {
@@ -24,9 +25,16 @@
   {
     "type": "dir",
     "name": "use",
-    "label": "功能文档",
+    "label": "常用模块",
     "collapsed": true
   },
+  {
+    "type": "dir",
+    "name": "shop",
+    "label": "商城模块",
+    "collapsed": true
+  },
+  "faq",
   {
     "type": "dir-section-header",
     "name": "contribution",

docs/guide/demo.md

@@ -0,0 +1,17 @@
+---
+title: 在线体验
+description: 通过 Halo 演示环境体验站点前台和管理后台。
+---
+
+无需安装或部署，即可访问以下演示环境体验 Halo：
+
+- 站点地址：<https://demo.halocms.site>
+- 管理后台：<https://demo.halocms.site/console>
+- 用户名：`demo`
+- 密码：`P@ssw0rd123..`
+
+:::warning 注意
+演示环境仅供功能体验，请勿上传或填写敏感信息。
+:::
+
+如需在本地搭建体验环境，请参考[《如何在本地快速体验 Halo》](https://www.halo.run/archives/halo-local-quickstart)。

docs/guide/use/faq.md → docs/guide/faq.md

@@ -15,7 +15,7 @@ description: Halo 使用常见问题：产品定位、数据库结构、找回
 ### 忘记密码怎么办？
 
 1. 站点管理员已经配置好邮件通知，并且用户已完成电子邮箱验证时，可以点击登录页面的 `找回密码` 链接，填写邮箱后，系统将向该邮箱发送密码重置链接，用户可通过该链接重置密码；
-2. 如果不满足上述条件，或者密码重置邮件不能发送成功，请直接联系具有用户管理权限的管理员进行密码重置操作，管理员可参考文档[修改用户密码](./users#修改用户密码)部分修改指定用户的密码；
+2. 如果不满足上述条件，或者密码重置邮件不能发送成功，请直接联系具有用户管理权限的管理员进行密码重置操作，管理员可参考文档[修改用户密码](./use/users#修改用户密码)部分修改指定用户的密码；
 3. 如果系统没有任何一个能够正常登录控制台且具有用户管理权限的管理员账号，则用户需要通过更新数据库记录的方式重置指定用户的密码。
 
    :::info 参考 SQL 语句
@@ -109,7 +109,7 @@ docker run \
   registry.fit2cloud.com/halo/halo-pro:2.26 \
 ```
 
-更多 Docker 相关的教程请参考：[使用 Docker 部署 Halo](../install/docker.mdx)
+更多 Docker 相关的教程请参考：[使用 Docker 部署 Halo](./install/docker.mdx)
 
 ### 如何查看运行日志？
 
@@ -127,7 +127,7 @@ docker run \
 
 前台样式不正常或者丢失有很多种问题的可能，最快捷定位问题的方式就是打开浏览器控制台查看具体请求的错误，以下列出了部分导致出现该问题的常见原因：
 
-1. `外部访问地址` 与实际访问地址不一致。也可能是开启了 https 之后，无法正常加载 http 资源，将 [外部访问地址](../install/config.md#halo-独有配置) 改为 https 协议即可。
+1. `外部访问地址` 与实际访问地址不一致。也可能是开启了 https 之后，无法正常加载 http 资源，将 [外部访问地址](./install/config.md#halo-独有配置) 改为 https 协议即可。
 2. Nginx 配置了静态资源缓存，但没有设置 `proxy_pass`，参考如下：
 
    ```nginx

docs/guide/prepare.md

@@ -1,26 +1,70 @@
 ---
 title: 写在前面
-description: Halo 部署前必读：社区版与付费版、软硬件环境、域名与 HTTPS 等准备事项。
+description: 了解 Halo、发行版本、应用生态，以及部署前所需的软硬件环境。
 ---
 
+<div class="rp-project-header">
+  <p align="center">
+    <a href="https://www.halo.run" target="_blank" rel="noopener noreferrer"><img width="100" src="https://www.halo.run/logo" alt="Halo logo" class="no-zoom" /></a>
+  </p>
+
+  <p align="center"><b>Halo</b> [ˈheɪloʊ]，强大易用的开源建站工具。</p>
+
+  <p align="center" class="rp-project-header__badges">
+    <a href="https://github.com/halo-dev/halo/releases"><img alt="GitHub release" src="https://img.shields.io/github/release/halo-dev/halo.svg?style=flat-square&include_prereleases" class="no-zoom" /></a>
+    <a href="https://hub.docker.com/r/halohub/halo"><img alt="Docker pulls" src="https://img.shields.io/docker/pulls/halohub/halo?style=flat-square" class="no-zoom" /></a>
+    <a href="https://github.com/halo-dev/halo/commits"><img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/halo-dev/halo.svg?style=flat-square" class="no-zoom" /></a>
+    <a href="https://github.com/halo-dev/halo/actions"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/halo-dev/halo/halo.yaml?branch=main&style=flat-square" class="no-zoom" /></a>
+    <a href="https://codecov.io/gh/halo-dev/halo"><img alt="Codecov percentage" src="https://img.shields.io/codecov/c/github/halo-dev/halo/main?style=flat-square&token=YsRUg9fall" class="no-zoom" /></a>
+  </p>
+</div>
+
+## Halo 是什么？
+
+Halo 是一款强大易用的开源建站工具，从个人博客、知识库，到企业官网、在线商城，Halo 都能助您轻松实现，一站式满足您的多样化建站需求。
+
+<a href="https://www.bilibili.com/video/BV15x4y1U7RU" target="_blank" rel="noopener noreferrer" class="rp-image-link" aria-label="播放 Halo 介绍视频" title="播放 Halo 介绍视频"><img src="https://www.halo.run/upload/dashboard-2026-03-26-5.png" alt="Halo 管理后台界面" class="no-zoom" /><span class="rp-image-link__play" aria-hidden="true"><svg viewBox="0 0 24 24" focusable="false"><path fill="currentColor" d="M5.669 4.76a1.47 1.47 0 0 1 2.04-1.177c1.062.453 3.442 1.532 6.462 3.276c3.021 1.744 5.146 3.266 6.069 3.958c.788.59.79 1.763.001 2.355c-.914.687-3.013 2.191-6.07 3.956c-3.06 1.766-5.412 2.832-6.464 3.28a1.467 1.467 0 0 1-2.038-1.177c-.138-1.141-.396-3.734-.396-7.236c0-3.5.257-6.092.396-7.235" /></svg></span></a>
+
 ## 发行版本
 
-Halo 的发行版本主要区分为两个大类别，即 **Halo 社区版** 和 **Halo 付费版**。
+Halo 的发行版本主要分为两个大类别，即**Halo 社区版**和 **Halo 付费版**。
+
+Halo 付费版包含专业版和商城版，是[**凌霞软件**](https://www.lxware.cn/)旗下的商业产品，致力于为企业、团体或有进阶需求的个人用户提供定制化和特定场景的功能支持。
+
+关于三个版本的详细区别，请查阅[**版本对比**](https://www.lxware.cn/halo)。
+
+在后续的文档中，除非特别说明，将使用付费版统称 Halo 专业版和 Halo 商城版。
+
+### Halo 社区版
+
+Halo 社区版开源免费，遵循 GPL-3.0 协议，适合个人开发者、技术爱好者和开源项目。
 
-Halo 付费版包括专业版和商城版，是[凌霞软件](https://www.lxware.cn?code=mcYhwMkn)旗下的商业产品，为企业/团体/或进阶个人使用者提供了诸多定制化和特定场景的功能支持。
+- 零成本搭建博客、作品集、技术文档站
+- 提供超过 100 款免费主题和插件
 
-版本区别可查阅 [方案对比](https://www.lxware.cn/halo?code=mcYhwMkn)
+### Halo 专业版
 
-在后续的文档中，使用付费版统称 Halo 专业版 和 Halo 商城版，除非特别说明。
+Halo 专业版在社区版基础上，集成多项适用于专业场景的功能：
 
-## 在线体验
+- 移动端 App：随时随地管理内容
+- AI 智能建站：快速生成专业站点
+- 手机号验证登录：提升安全性与用户体验
+- 全站私有化部署：保障数据主权
+- 付费主题与插件市场：提供精品主题，以及 SEO 优化、付费阅读、AI 助手等付费插件
 
-- 环境地址：<https://demo.halocms.site>
-- 后台地址：<https://demo.halocms.site/console>
-- 用户名：`demo`
-- 密码：`P@ssw0rd123..`
+### Halo 商城版
 
-或者也可以参考 [《如何在本地快速体验 Halo》](https://www.halo.run/archives/halo-local-quickstart) 在本地搭建体验环境。
+Halo 商城版在专业版基础上，提供在线商城功能：
+
+- 一体化在线商城：覆盖商品管理、订单处理和支付对接流程
+- 面向中国商家：集成微信支付、支付宝等本土支付方式
+- 支持品牌官网、内容管理和线上店铺一站式建设
+
+## 应用生态
+
+- **应用市场**：提供丰富的站点主题与功能插件，前往 [Halo 应用市场](https://www.halo.run/store/apps)了解详情。
+- **成为开发者**：支持自主发布并管理应用，参阅[应用市场开发者入驻及应用创建指南](https://www.halo.run/archives/halo-app-store-developer-onboarding-app-creation)。
+- **社区资源**：访问 [Awesome Halo](https://github.com/halo-sigs/awesome-halo)，了解 Halo 相关的精选资源。
 
 ## 环境要求
 
@@ -143,3 +187,17 @@ Halo 目前支持以下数据库：
 用于扩展 Halo 功能的软件包。插件独立于 Halo 核心应用，可以单独安装、升级、卸载。
 
 相关使用文档：[插件管理相关功能说明](../guide/use/plugins.md)
+
+## 许可证
+
+Halo 使用 [GPL-3.0](https://github.com/halo-dev/halo/blob/main/LICENSE) 协议开源，使用和分发时请遵守开源协议。
+
+## 贡献者
+
+欢迎参与 Halo 项目建设，具体方式请参阅 [Halo 贡献指南](https://github.com/halo-dev/halo/blob/main/CONTRIBUTING.md)。
+
+<a href="https://github.com/halo-dev/halo/graphs/contributors"><img src="https://opencollective.com/halo/contributors.svg?width=890&button=false" alt="Halo 项目贡献者" /></a>
+
+## 项目状态
+
+![Halo 项目活跃度](https://repobeats.axiom.co/api/embed/ad008b2151c22e7cf734d2688befaa795d593b95.svg "Halo 项目活跃度")

docs/guide/use/shop/customer-center.md → docs/guide/shop/customer-center.md

@@ -4,7 +4,7 @@ description: Halo 商城顾客在个人中心管理收货地址、优惠券和
 ---
 
 :::note 仅限 Halo 商城版
-限 [Halo 商城版](../../prepare.md#发行版本) 可用。
+限 [Halo 商城版](../prepare.md#发行版本) 可用。
 :::
 
 顾客登录后，可以访问 `/uc`，从个人中心管理自己的收货地址、优惠券和订单。

docs/guide/use/shop/index.mdx → docs/guide/shop/index.mdx

@@ -1,13 +1,13 @@
 ---
-title: 商城
+title: 商城模块
 description: Halo 商城版功能概览：开店、商品、支付发货与前台路由等用户指南索引。
 overview: true
 ---
 
 import { Tab, Tabs } from "@rspress/core/theme";
 
 :::note 仅限 Halo 商城版
-限 [Halo 商城版](../../prepare.md#发行版本) 可用。
+限 [Halo 商城版](../prepare.md#发行版本) 可用。
 :::
 
 商城模块是 Halo 商城版的一项功能，支持用户基于 Halo 站点创建店铺，上架多种类型的货品，配置商品支付和发货方式。为实体商品、虚拟商品、链接商品等销售场景提供完备的电商解决方案。

docs/guide/use/shop/marketing.md → docs/guide/shop/marketing.md

@@ -4,7 +4,7 @@ description: 使用 Halo 商城的折扣和优惠券功能设置活动规则、
 ---
 
 :::note 仅限 Halo 商城版
-限 [Halo 商城版](../../prepare.md#发行版本) 可用。
+限 [Halo 商城版](../prepare.md#发行版本) 可用。
 :::
 
 登录 Halo 控制台，进入 **商店 -> 营销**。商城提供 **折扣** 和 **优惠券** 两类营销工具。

docs/guide/use/shop/prepare.mdx → docs/guide/shop/prepare.mdx

@@ -7,8 +7,8 @@ description: 启用 Halo 商城前：商城版安装激活、合规资质与支
 
 在开始使用商城功能之前，需要先确定以下条件是否已满足：
 
-- 正常安装 [Halo 商城版](../../install/index.md)
-- 激活 [Halo 商城版许可证](../activate.md)
+- 正常安装 [Halo 商城版](../install/index.md)
+- 激活 [Halo 商城版许可证](../use/activate.md)
 - 根据当地法律法规，满足开设网络商店的资质与要求
 - 开通支付平台账户，目前支持：
   - [支付宝官方接口](https://open.alipay.com/)
@@ -29,4 +29,4 @@ description: 启用 Halo 商城前：商城版安装激活、合规资质与支
 这些页面无需主题提供对应的模板文件即可访问，使用的是系统内置的模板文件。如果当前激活的主题提供了对应的模板文件，则会优先使用主题提供的模板文件。
 :::
 
-你可以根据需求，将这些页面路径添加到[网站菜单](../menus.md)中。
+你可以根据需求，将这些页面路径添加到[网站菜单](../use/menus.md)中。

docs/guide/use/shop/settings.md → docs/guide/shop/settings.md

@@ -4,7 +4,7 @@ description: 配置 Halo 商城的联系方式、询价跳转、小程序首页
 ---
 
 :::note 仅限 Halo 商城版
-限 [Halo 商城版](../../prepare.md#发行版本) 可用。
+限 [Halo 商城版](../prepare.md#发行版本) 可用。
 :::
 
 登录 Halo 控制台，进入 **商店 -> 设置**。支付方式和销售渠道分别参见[支付方式](./payments.mdx)与[销售渠道](./sales-channels.mdx)，本页介绍其余设置。

docs/guide/use/_meta.json

@@ -14,12 +14,5 @@
   "users",
   "settings",
   "backup",
-  "mobile-app",
-  {
-    "type": "dir",
-    "name": "shop",
-    "label": "商城",
-    "collapsed": true
-  },
-  "faq"
+  "mobile-app"
 ]

docs/guide/use/common.md

@@ -1,5 +1,5 @@
 ---
-title: 基础说明
+title: 概念说明
 description: Halo 建站入门：登录注册、控制台、角色分类与站点基础概念说明。
 ---
 

docs/guide/use/index.md

@@ -1,5 +1,5 @@
 ---
-title: 功能文档
-description: Halo 功能操作总览，涵盖文章、页面、附件、菜单、主题、插件、应用市场、用户权限、站点设置、备份恢复及商城管理。
+title: 常用模块
+description: Halo 基础功能操作总览，涵盖文章、页面、附件、菜单、主题、插件、应用市场、用户权限、站点设置及备份恢复。
 overview: true
 ---

docs/guide/use/user-center.md

@@ -84,4 +84,4 @@ Halo 默认为个人中心提供了管理个人文章的功能，每个用户都
 
 ## 商城
 
-Halo 商城版会在个人中心增加订单、收货地址和优惠券功能，使用方法参见[商城客户中心](./shop/customer-center.md)。
+Halo 商城版会在个人中心增加订单、收货地址和优惠券功能，使用方法参见[商城客户中心](../shop/customer-center.md)。

docs/index.mdx

@@ -97,7 +97,7 @@ import { Link } from "@rspress/core/runtime";
           <Link to={{pathname: '/guide/use/plugins'}}><span className="topic-link__icon" aria-hidden="true"><PhPuzzlePieceDuotone width={18} height={18} /></span><span>插件</span></Link>
           <Link to={{pathname: '/guide/use/attachments'}}><span className="topic-link__icon" aria-hidden="true"><PhPaperclipDuotone width={18} height={18} /></span><span>附件</span></Link>
           <Link to={{pathname: '/guide/use/settings'}}><span className="topic-link__icon" aria-hidden="true"><PhGearDuotone width={18} height={18} /></span><span>系统设置</span></Link>
-          <Link to={{pathname: '/guide/use/faq'}}><span className="topic-link__icon" aria-hidden="true"><PhQuestionDuotone width={18} height={18} /></span><span>常见问题</span></Link>
+          <Link to={{pathname: '/guide/faq'}}><span className="topic-link__icon" aria-hidden="true"><PhQuestionDuotone width={18} height={18} /></span><span>常见问题</span></Link>
         </nav>
         <Link className="topic-group__all" to={{pathname: '/guide/use/'}}>查看全部功能文档<span aria-hidden="true">→</span></Link>
       </article>
@@ -127,7 +127,7 @@ import { Link } from "@rspress/core/runtime";
       <span>查看常见问题，或到社区论坛提问。</span>
     </div>
     <nav aria-label="帮助资源">
-      <Link to={{pathname: '/guide/use/faq'}}>常见问题</Link>
+      <Link to={{pathname: '/guide/faq'}}>常见问题</Link>
       <a href="https://github.com/orgs/halo-dev/discussions" target="_blank" rel="noreferrer">GitHub <span aria-hidden="true">↗</span></a>
       <a href="https://bbs.halo.run" target="_blank" rel="noreferrer">社区论坛 <span aria-hidden="true">↗</span></a>
     </nav>

edgeone.json

@@ -4,6 +4,36 @@
   "outputDirectory": "./build",
   "nodeVersion": "24.18.0",
   "redirects": [
+    {
+      "source": "/guide/use/shop",
+      "destination": "/guide/shop",
+      "statusCode": 301
+    },
+    {
+      "source": "/guide/use/shop/*",
+      "destination": "/guide/shop/:splat",
+      "statusCode": 301
+    },
+    {
+      "source": "/guide/use/faq",
+      "destination": "/guide/faq",
+      "statusCode": 301
+    },
+    {
+      "source": "/user-guide/shop",
+      "destination": "/guide/shop",
+      "statusCode": 301
+    },
+    {
+      "source": "/user-guide/shop/*",
+      "destination": "/guide/shop/:splat",
+      "statusCode": 301
+    },
+    {
+      "source": "/user-guide/faq",
+      "destination": "/guide/faq",
+      "statusCode": 301
+    },
     {
       "source": "/next/getting-started/install/*",
       "destination": "/guide/install/:splat",

i18n.json

@@ -0,0 +1,8 @@
+{
+  "overview.filterPlaceholderText": {
+    "zh": "搜索内容"
+  },
+  "overview.filterNoResultText": {
+    "zh": "未找到匹配的内容"
+  }
+}

rstack.config.ts

@@ -39,6 +39,9 @@ define.doc(async () => {
     route: {
       cleanUrls: true,
     },
+    mediumZoom: {
+      selector: ".rspress-doc img:not(.no-zoom)",
+    },
     markdown: {
       showLineNumbers: true,
       link: {

theme/components/EditLink.tsx

@@ -0,0 +1,25 @@
+import { Link, useEditLink } from "@rspress/core/theme-original";
+import MingcuteEdit3Line from "~icons/mingcute/edit-3-line";
+
+interface EditLinkProps {
+  isOutline?: boolean;
+}
+
+export function EditLink({ isOutline = false }: EditLinkProps) {
+  const editLink = useEditLink();
+
+  if (!editLink) {
+    return null;
+  }
+
+  const className = isOutline
+    ? "rp-outline__action-row rp-edit-link"
+    : "rp-edit-link rp-edit-link--footer";
+
+  return (
+    <Link href={editLink.link} className={className}>
+      <MingcuteEdit3Line aria-hidden="true" />
+      <span>{editLink.text}</span>
+    </Link>
+  );
+}