Reorganize MatrixShop docs structure

54895y · 54895y · commit 984bff23701a · 2026-04-02T19:08:15.000+08:00
diff --git a/docs/matrixshop/_category_.json b/docs/matrixshop/_category_.json
@@ -3,6 +3,6 @@
   "position": 1,
   "link": {
     "type": "generated-index",
-    "description": "MatrixShop 插件使用文档"
+    "description": "按入门、配置、模块、更新日志与详细模块页整理的 MatrixShop 文档。"
   }
 }
diff --git a/docs/matrixshop/configuration/_category_.json b/docs/matrixshop/configuration/_category_.json
@@ -0,0 +1,8 @@
+{
+  "label": "配置与系统",
+  "position": 3,
+  "link": {
+    "type": "generated-index",
+    "description": "配置结构、经济模块、数据库、SystemShop 资源、绑定与遥测说明。"
+  }
+}
diff --git a/docs/matrixshop/configuration/bindings-and-ui.mdx b/docs/matrixshop/configuration/bindings-and-ui.mdx
@@ -1,6 +1,8 @@
 ---
 title: 绑定与 UI
 description: MatrixShop 的命令绑定、菜单布局与动作执行规则。
+slug: /matrixshop/bindings-and-ui
+sidebar_position: 6
 ---
 
 # 绑定与 UI
diff --git a/docs/matrixshop/configuration/bindings-help-and-hints.mdx b/docs/matrixshop/configuration/bindings-help-and-hints.mdx
@@ -1,6 +1,8 @@
 ---
 title: Help、Help-Key 与 Hint-Keys
 description: MatrixShop 中绑定命令的多行帮助、描述键和提示键的配置规则。
+slug: /matrixshop/bindings-help-and-hints
+sidebar_position: 7
 ---
 
 # Help、Help-Key 与 Hint-Keys
diff --git a/docs/matrixshop/configuration/bstats-and-telemetry.mdx b/docs/matrixshop/configuration/bstats-and-telemetry.mdx
@@ -1,7 +1,8 @@
 ---
 title: bStats 与遥测
 description: MatrixShop 当前集成的 bStats 统计项、隐私范围和关闭方式。
-sidebar_position: 11
+slug: /matrixshop/bstats-and-telemetry
+sidebar_position: 9
 ---
 
 # bStats 与遥测
diff --git a/docs/matrixshop/configuration/configuration-structure.mdx b/docs/matrixshop/configuration/configuration-structure.mdx
@@ -1,6 +1,8 @@
 ---
 title: 配置结构
 description: MatrixShop 顶层配置、模块目录和入口文件的详细结构说明。
+slug: /matrixshop/configuration-structure
+sidebar_position: 1
 ---
 
 # 配置结构
diff --git a/docs/matrixshop/configuration/database-and-storage.mdx b/docs/matrixshop/configuration/database-and-storage.mdx
@@ -1,6 +1,8 @@
 ---
 title: 数据库与存储
 description: MatrixShop 的 JDBC 优先与文件回退设计。
+slug: /matrixshop/database-and-storage
+sidebar_position: 5
 ---
 
 # 数据库与存储
diff --git a/docs/matrixshop/configuration/economy-examples.mdx b/docs/matrixshop/configuration/economy-examples.mdx
@@ -1,6 +1,8 @@
 ---
 title: 经济配置实战示例
 description: MatrixShop 中 Vault、PlayerPoints 和自定义占位符货币的常见配置写法。
+slug: /matrixshop/economy-examples
+sidebar_position: 4
 ---
 
 # 经济配置实战示例
diff --git a/docs/matrixshop/configuration/economy-reference.mdx b/docs/matrixshop/configuration/economy-reference.mdx
@@ -1,6 +1,8 @@
 ---
 title: 货币字段参考
 description: Economy/currency.yml 的字段、动作语法和占位符说明。
+slug: /matrixshop/economy-reference
+sidebar_position: 3
 ---
 
 # 货币字段参考
diff --git a/docs/matrixshop/configuration/economy.mdx b/docs/matrixshop/configuration/economy.mdx
@@ -1,6 +1,8 @@
 ---
 title: 经济模块
 description: MatrixShop 的统一货币定义、优先级规则和模块配置方式。
+slug: /matrixshop/economy
+sidebar_position: 2
 ---
 
 # 经济模块
diff --git a/docs/matrixshop/configuration/system-shop.mdx b/docs/matrixshop/configuration/system-shop.mdx
@@ -1,6 +1,8 @@
 ---
 title: SystemShop
 description: SystemShop 的分类、goods 仓库、刷新配置与后台维护流程。
+slug: /matrixshop/system-shop
+sidebar_position: 8
 ---
 
 # SystemShop
diff --git a/docs/matrixshop/getting-started/_category_.json b/docs/matrixshop/getting-started/_category_.json
@@ -0,0 +1,8 @@
+{
+  "label": "开始使用",
+  "position": 2,
+  "link": {
+    "type": "generated-index",
+    "description": "首次部署、常用命令、权限与常见问题入口。"
+  }
+}
diff --git a/docs/matrixshop/getting-started/commands-and-permissions.mdx b/docs/matrixshop/getting-started/commands-and-permissions.mdx
@@ -1,6 +1,8 @@
 ---
 title: 命令与权限
 description: MatrixShop 的玩家指令、管理员指令与权限节点。
+slug: /matrixshop/commands-and-permissions
+sidebar_position: 2
 ---
 
 # 命令与权限
diff --git a/docs/matrixshop/getting-started/faq.mdx b/docs/matrixshop/getting-started/faq.mdx
@@ -1,6 +1,8 @@
 ---
 title: 常见问题
 description: MatrixShop 当前实现的常见误区与排错入口。
+slug: /matrixshop/faq
+sidebar_position: 3
 ---
 
 # 常见问题
diff --git a/docs/matrixshop/getting-started/quick-start.mdx b/docs/matrixshop/getting-started/quick-start.mdx
@@ -1,6 +1,8 @@
 ---
 title: 快速开始
 description: 首次部署 MatrixShop、生成默认配置并验证基本指令。
+slug: /matrixshop/quick-start
+sidebar_position: 1
 ---
 
 # 快速开始
diff --git a/docs/matrixshop/index.mdx b/docs/matrixshop/index.mdx
@@ -8,10 +8,10 @@ description: MatrixShop 当前模块化实现的总览与阅读入口。
 
 MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当前主线版本已经具备正式部署所需的核心模块、统一命令体系、统一菜单框架、统一权限校验、统一经济模块和 JDBC 优先的数据层。
 
-当前最新修复版本为：
+当前最新版本入口：
 
 - [1.3.0 发布说明](./release-notes-1-3-0)
-- [1.2.0 发布说明](./release-notes-1-2-0)
+- [更新日志总览](./release-notes)
 
 ## 当前版本状态
 
@@ -54,22 +54,61 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
 - 每个模块默认配置的完整示例与字段解读
 - UI 配置和动作语法
 
-## 开始阅读
+## 文档结构
+
+当前文档按这五组整理：
+
+1. [开始使用](./quick-start)
+2. [配置与系统](./configuration-structure)
+3. [模块与机制](./modules-overview)
+4. [更新日志](./release-notes)
+5. [商店与模块详解](./shop-types)
+
+## 推荐阅读顺序
 
 如果你第一次接触 MatrixShop，推荐顺序是：
 
 1. [快速开始](./quick-start)
 2. [1.3.0 发布说明](./release-notes-1-3-0)
-3. [1.2.0 发布说明](./release-notes-1-2-0)
-4. [1.1.1 发布说明](./release-notes-1-1-1)
-5. [1.1.0 发布说明](./release-notes-1-1-0)
-6. [配置结构](./configuration-structure)
-7. [经济模块](./economy)
-8. [命令与权限](./commands-and-permissions)
-9. [数据库与存储](./database-and-storage)
-10. [bStats 与遥测](./bstats-and-telemetry)
-11. [模块总览](./modules-overview)
-12. [商店与模块详解](./shop-types)
+3. [配置结构](./configuration-structure)
+4. [经济模块](./economy)
+5. [命令与权限](./commands-and-permissions)
+6. [数据库与存储](./database-and-storage)
+7. [模块总览](./modules-overview)
+8. [商店与模块详解](./shop-types)
+
+## 分类导览
+
+### 开始使用
+
+- [快速开始](./quick-start)
+- [命令与权限](./commands-and-permissions)
+- [常见问题](./faq)
+
+### 配置与系统
+
+- [配置结构](./configuration-structure)
+- [经济模块](./economy)
+- [货币字段参考](./economy-reference)
+- [经济配置实战示例](./economy-examples)
+- [数据库与存储](./database-and-storage)
+- [绑定与 UI](./bindings-and-ui)
+- [Help、Help-Key 与 Hint-Keys](./bindings-help-and-hints)
+- [SystemShop 配置](./system-shop)
+- [bStats 与遥测](./bstats-and-telemetry)
+
+### 模块与机制
+
+- [模块总览](./modules-overview)
+- [PlayerShop、GlobalMarket、Auction](./player-economy-modules)
+- [Menu、ChestShop、Transaction、Cart、Record](./interaction-modules)
+
+### 更新日志
+
+- [1.3.0 发布说明](./release-notes-1-3-0)
+- [1.2.0 发布说明](./release-notes-1-2-0)
+- [1.1.1 发布说明](./release-notes-1-1-1)
+- [1.1.0 发布说明](./release-notes-1-1-0)
 
 ## 发布前建议
 
diff --git a/docs/matrixshop/modules/_category_.json b/docs/matrixshop/modules/_category_.json
@@ -0,0 +1,8 @@
+{
+  "label": "模块与机制",
+  "position": 4,
+  "link": {
+    "type": "generated-index",
+    "description": "从模块职责和玩法机制理解 MatrixShop 当前主线结构。"
+  }
+}
diff --git a/docs/matrixshop/modules/interaction-modules.mdx b/docs/matrixshop/modules/interaction-modules.mdx
@@ -1,6 +1,8 @@
 ---
 title: Menu、ChestShop、Transaction、Cart、Record
 description: 交互类模块的职责、命令和边界。
+slug: /matrixshop/interaction-modules
+sidebar_position: 3
 ---
 
 # Menu、ChestShop、Transaction、Cart、Record
diff --git a/docs/matrixshop/modules/modules-overview.mdx b/docs/matrixshop/modules/modules-overview.mdx
@@ -1,6 +1,8 @@
 ---
 title: 模块总览
 description: MatrixShop 各模块职责、默认文件和详细文档入口。
+slug: /matrixshop/modules-overview
+sidebar_position: 1
 ---
 
 # 模块总览
diff --git a/docs/matrixshop/modules/player-economy-modules.mdx b/docs/matrixshop/modules/player-economy-modules.mdx
@@ -1,6 +1,8 @@
 ---
 title: PlayerShop、GlobalMarket、Auction
 description: 三个主要经济模块的配置入口与行为差异。
+slug: /matrixshop/player-economy-modules
+sidebar_position: 2
 ---
 
 # PlayerShop、GlobalMarket、Auction
diff --git a/docs/matrixshop/release-notes/_category_.json b/docs/matrixshop/release-notes/_category_.json
@@ -0,0 +1,8 @@
+{
+  "label": "更新日志",
+  "position": 5,
+  "link": {
+    "type": "doc",
+    "id": "matrixshop/release-notes/index"
+  }
+}
diff --git a/docs/matrixshop/release-notes/index.mdx b/docs/matrixshop/release-notes/index.mdx
@@ -0,0 +1,23 @@
+---
+title: 更新日志
+description: MatrixShop 各版本发布说明、升级重点与验证结果汇总。
+slug: /matrixshop/release-notes
+sidebar_position: 0
+---
+
+# 更新日志
+
+这一组页面集中收纳 MatrixShop 的版本发布说明。
+
+如果你准备升级，建议按从新到旧的顺序阅读：
+
+1. [1.3.0 发布说明](./release-notes-1-3-0)
+2. [1.2.0 发布说明](./release-notes-1-2-0)
+3. [1.1.1 发布说明](./release-notes-1-1-1)
+4. [1.1.0 发布说明](./release-notes-1-1-0)
+
+## 阅读建议
+
+- 想看当前最新功能和验证结果：先看 [1.3.0 发布说明](./release-notes-1-3-0)
+- 想看管理员商品维护流历史变化：继续看 [1.2.0 发布说明](./release-notes-1-2-0)
+- 想回看 `1.1.x` 的收口和修复：看 [1.1.1](./release-notes-1-1-1) 与 [1.1.0](./release-notes-1-1-0)
diff --git a/docs/matrixshop/release-notes/release-notes-1-1-0.mdx b/docs/matrixshop/release-notes/release-notes-1-1-0.mdx
@@ -1,6 +1,8 @@
 ---
 title: 1.1.0 发布说明
 description: MatrixShop 1.1.0 的正式发布内容、升级重点和兼容说明。
+slug: /matrixshop/release-notes-1-1-0
+sidebar_position: 4
 ---
 
 # MatrixShop 1.1.0 发布说明
diff --git a/docs/matrixshop/release-notes/release-notes-1-1-1.mdx b/docs/matrixshop/release-notes/release-notes-1-1-1.mdx
@@ -1,6 +1,8 @@
 ---
 title: 1.1.1 发布说明
 description: MatrixShop 1.1.1 的修复内容、升级建议和验证结果。
+slug: /matrixshop/release-notes-1-1-1
+sidebar_position: 3
 ---
 
 # MatrixShop 1.1.1 发布说明
diff --git a/docs/matrixshop/release-notes/release-notes-1-2-0.mdx b/docs/matrixshop/release-notes/release-notes-1-2-0.mdx
@@ -1,6 +1,8 @@
 ---
 title: 1.2.0 发布说明
 description: MatrixShop 1.2.0 的新增功能、管理员商品维护流程和验证结果。
+slug: /matrixshop/release-notes-1-2-0
+sidebar_position: 2
 ---
 
 # MatrixShop 1.2.0 发布说明
diff --git a/docs/matrixshop/release-notes/release-notes-1-3-0.mdx b/docs/matrixshop/release-notes/release-notes-1-3-0.mdx
@@ -1,6 +1,8 @@
 ---
 title: 1.3.0 发布说明
 description: MatrixShop 1.3.0 的 goods 仓库、定时刷新、后台维护流和验证结果。
+slug: /matrixshop/release-notes-1-3-0
+sidebar_position: 1
 ---
 
 # MatrixShop 1.3.0 发布说明
diff --git a/sidebars.ts b/sidebars.ts

Original file line number	Diff line number	Diff line change
`@@ -3,6 +3,6 @@`
`3`	`3`	`"position": 1,`
`4`	`4`	`"link": {`
`5`	`5`	`"type": "generated-index",`
`6`		`- "description": "MatrixShop 插件使用文档"`
	`6`	`+ "description": "按入门、配置、模块、更新日志与详细模块页整理的 MatrixShop 文档。"`
`7`	`7`	`}`
`8`	`8`	`}`