Update MatrixShop release docs

Author: 54895y

docs/matrixshop/commands-and-permissions.mdx

@@ -22,8 +22,10 @@ description: MatrixShop 的玩家指令、管理员指令与权限节点。
 - `/chestshop`
 - `/trade`
 - `/market`
+- `/cart`
+- `/record`
 
-是否注册，取决于模块或具体 `shops/*.yml` 的 `Bindings.Commands.Register`。
+是否注册，取决于模块级或商店级配置中的 `Bindings.Commands.Register`。
 
 ## 玩家命令
 
@@ -44,9 +46,8 @@ description: MatrixShop 的玩家指令、管理员指令与权限节点。
 - `auction:<shop-id>`
 - `transaction:<shop-id>`
 - `menu:<shop-id>`
-- `cart:<shop-id>`
-- `record:<shop-id>`
-- `chestshop:<shop-id>`
+- `cart:<view-id>`
+- `record:<view-id>`
 
 ### 模块命令
 
@@ -56,7 +57,7 @@ description: MatrixShop 的玩家指令、管理员指令与权限节点。
 | PlayerShop | `/playershop open [player]`、`/playershop edit`、`/playershop upload <price> [amount]` |
 | GlobalMarket | `/market open`、`/market upload <price> [amount]`、`/market manage` |
 | Auction | `/auction open`、`/auction upload <english\|dutch> <start> [buyout\|end] [duration]`、`/auction bid <id> [price]`、`/auction buyout <id>` |
-| ChestShop | `/chestshop create <buy\|sell\|dual> <price> [sell-price] [amount]`、`/chestshop edit`、`/chestshop stock`、`/chestshop history` |
+| ChestShop | `/chestshop open`、`/chestshop create <buy\|sell\|dual> <price> [sell-price] [amount]`、`/chestshop edit`、`/chestshop stock`、`/chestshop history` |
 | Transaction | `/trade request <player>`、`/trade accept`、`/trade money <amount>`、`/trade exp <amount>`、`/trade ready`、`/trade confirm` |
 | Cart | `/cart open`、`/cart checkout [valid_only]`、`/cart clear`、`/cart remove <slot>` |
 | Record | `/record open [keyword]`、`/record detail <id>`、`/record filter [module\|all]`、`/record income`、`/record expense` |

docs/matrixshop/configuration-structure.mdx

@@ -120,7 +120,7 @@ Database:
 - `Cart/`
 - `Record/`
 
-每个模块目录通常包含：
+大多数模块目录包含：
 
 - `settings.yml`
 - `shops/*.yml`
@@ -131,6 +131,12 @@ Database:
 - `ChestShop/signs.yml`
 - `Record/retention.yml`
 
+并且有三个模块已经不再使用 `shops/*.yml`：
+
+- `ChestShop`
+- `Cart`
+- `Record`
+
 ## `settings.yml` 和 `shops/*.yml` 的分工
 
 ### `settings.yml`
@@ -157,8 +163,23 @@ Database:
 例如：
 
 - `PlayerShop/shops/default.yml` -> `default`
-- `Cart/shops/cart.yml` -> `cart`
-- `Record/shops/record.yml` -> `record`
+- `GlobalMarket/shops/default.yml` -> `default`
+- `Auction/shops/default.yml` -> `default`
+- `Transaction/shops/default.yml` -> `default`
+
+### 不使用 `shops/*.yml` 的模块
+
+这三个模块当前采用“模块级入口 + UI 文件”的结构：
+
+- `ChestShop`
+- `Cart`
+- `Record`
+
+它们的入口命令、帮助文本和行为控制主要来自：
+
+- `settings.yml`
+- `ui/*.yml`
+- 以及模块自身的运行时上下文
 
 ## 从哪里继续读
 

docs/matrixshop/faq.mdx

@@ -24,6 +24,12 @@ currency: 'vault'
 - `auction`
 - `transaction`
 
+以下模块当前不依赖 `shops/*.yml` 作为主入口：
+
+- `chestshop`
+- `cart`
+- `record`
+
 ## `/ms open <id>` 打不开或提示歧义怎么办
 
 如果多个模块里出现了同名 `shopId`，就不要再用短写法，直接改成显式前缀：
@@ -60,6 +66,15 @@ currency: 'vault'
 - `Bindings.Commands.Register`
 - 独立命令关键字本身
 
+## 为什么 `/cart`、`/record` 能直接使用，但不需要 `shops/*.yml`
+
+因为这两个模块当前已经改成“模块级入口 + UI 文件”模型：
+
+- `Cart/settings.yml` + `Cart/ui/*.yml`
+- `Record/settings.yml` + `Record/ui/*.yml`
+
+它们仍然支持独立命令和帮助输出，但不再通过 `shops/*.yml` 划分主入口。
+
 ## SystemShop 为什么没有数据库表
 
 因为当前 SystemShop 是纯配置驱动模块，不依赖 JDBC 运行表。真正大量落表的是拍卖、市场、玩家商店、购物车、箱店和记录系统。

docs/matrixshop/index.mdx

@@ -6,7 +6,14 @@ description: MatrixShop 当前模块化实现的总览与阅读入口。
 
 # MatrixShop 文档
 
-MatrixShop 是一个模块化交易插件。当前代码已经围绕统一命令、统一菜单框架、统一权限校验和 JDBC 优先的数据层完成了第一批核心模块。
+MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当前主线版本已经具备正式部署所需的核心模块、统一命令体系、统一菜单框架、统一权限校验和 JDBC 优先的数据层。
+
+## 当前版本状态
+
+- 已完成首发所需的核心业务链
+- 默认文案、帮助输出和主要模块反馈已统一进语言系统
+- 支持 SQLite / MySQL，JDBC 不可用时自动回退到文件后端
+- 默认文档以 `main` 分支和当前默认资源文件为准
 
 ## 当前实现的模块
 
@@ -34,7 +41,7 @@ MatrixShop 是一个模块化交易插件。当前代码已经围绕统一命令
 - 真实目录结构与文件职责
 - 命令绑定、独立命令与 `shopId` 解析规则
 - SQLite / MySQL / 文件回退行为
-- 各交易模块的当前能力边界
+- 各模块当前能力和配置边界
 - 每个模块默认配置的完整示例与字段解读
 - UI 配置和动作语法
 
@@ -48,3 +55,11 @@ MatrixShop 是一个模块化交易插件。当前代码已经围绕统一命令
 4. [数据库与存储](./database-and-storage)
 5. [模块总览](./modules-overview)
 6. [商店与模块详解](./shop-types)
+
+## 发布前建议
+
+如果你准备直接部署到正式服务器，建议至少先完成这三项检查：
+
+1. 先执行一次 `/matrixshopadmin status`
+2. 确认 `database.yml`、`module.yml` 和主要模块 `settings.yml` 已按你的服设完成调整
+3. 逐个验证你实际会开放给玩家的入口命令和菜单绑定

docs/matrixshop/modules-overview.mdx

@@ -16,10 +16,10 @@ description: MatrixShop 各模块职责、默认文件和详细文档入口。
 | `player-shop` | 玩家个人商店 | `PlayerShop/settings.yml`、`PlayerShop/shops/default.yml` | [PlayerShop](./shop-types/player-shop) |
 | `global-market` | 全服共享市场 | `GlobalMarket/settings.yml`、`GlobalMarket/shops/default.yml` | [GlobalMarket](./shop-types/global-market) |
 | `auction` | 拍卖行 | `Auction/settings.yml`、`Auction/shops/default.yml` | [Auction](./shop-types/auction) |
-| `chestshop` | 箱子商店 | `ChestShop/settings.yml`、`ChestShop/shops/default.yml` | [ChestShop](./shop-types/chest-shop) |
+| `chestshop` | 箱子商店 | `ChestShop/settings.yml`、`ChestShop/signs.yml`、`ChestShop/ui/*.yml` | [ChestShop](./shop-types/chest-shop) |
 | `transaction` | 面对面交易 | `Transaction/settings.yml`、`Transaction/shops/default.yml` | [Transaction](./shop-types/transaction) |
-| `cart` | 购物车 | `Cart/settings.yml`、`Cart/shops/cart.yml` | [Cart](./shop-types/cart) |
-| `record` | 账本记录 | `Record/settings.yml`、`Record/shops/record.yml` | [Record](./shop-types/record) |
+| `cart` | 购物车 | `Cart/settings.yml`、`Cart/ui/*.yml` | [Cart](./shop-types/cart) |
+| `record` | 账本记录 | `Record/settings.yml`、`Record/retention.yml`、`Record/ui/*.yml` | [Record](./shop-types/record) |
 
 ## 应该先读哪些页
 
@@ -36,15 +36,15 @@ description: MatrixShop 各模块职责、默认文件和详细文档入口。
 先看：
 
 1. 对应模块的 `settings.yml` 是否启用、是否有权限条件。
-2. 对应 `shops/*.yml` 的文件名是否和你打开的 `shopId` 一致。
+2. 如果该模块使用 `shops/*.yml`，确认文件名是否和你打开的 `shopId` 一致。
 3. 模块页里记录的默认命令别名和 UI 文件是否匹配。
 
 ### 如果你在做中文化或重做界面
 
 先看：
 
 1. [绑定与 UI](./bindings-and-ui)
-2. 对应模块页中的 `shops/*.yml`
+2. 对应模块页中的 `shops/*.yml` 或 `ui/*.yml`
 3. 对应模块的 `ui/*.yml`
 
 ## 当前模块边界
@@ -55,6 +55,6 @@ description: MatrixShop 各模块职责、默认文件和详细文档入口。
 - `PlayerShop`、`GlobalMarket`、`Auction` 主要是运行时上架数据。
 - `ChestShop` 有箱子、库存、告示牌这套线下交互。
 - `Transaction` 不是商品市场，而是面对面交换。
-- `Cart` 和 `Record` 是辅助模块，不是独立销售市场。
+- `Cart` 和 `Record` 是辅助模块，不是独立销售市场，也不再使用 `shops/*.yml` 作为主入口。
 
 如果你准备直接改字段，请进入 [商店与模块详解](./shop-types) 下的具体模块页。

docs/matrixshop/quick-start.mdx

@@ -33,13 +33,19 @@ plugins/MatrixShop/
 └─ Record/
 ```
 
-每个模块目录下至少会有：
+大多数模块目录下会包含：
 
 - `settings.yml`
 - `shops/*.yml`
 - `ui/*.yml`
 
-`shops/*.yml` 的文件名就是当前实现里的 `shopId`。
+但有三个例外：
+
+- `ChestShop/`：不再使用 `shops/*.yml`，只保留 `settings.yml`、`signs.yml` 和 `ui/*.yml`
+- `Cart/`：不再使用 `shops/*.yml`，只保留 `settings.yml` 和 `ui/*.yml`
+- `Record/`：不再使用 `shops/*.yml`，只保留 `settings.yml`、`retention.yml` 和 `ui/*.yml`
+
+对于仍然使用 `shops/*.yml` 的模块，文件名就是当前实现里的 `shopId`。
 
 ## 3. 先做的三项检查
 
@@ -71,7 +77,7 @@ modules:
 
 ### 检查绑定命令
 
-模块命令不是写死的。它们会从各模块 `settings.yml` 和 `shops/*.yml` 里的 `Bindings.Commands` 读取。
+模块命令不是全部写死的。它们会从各模块 `settings.yml` 和 `shops/*.yml` 里的 `Bindings.Commands` 读取。
 
 例如默认情况下：
 
@@ -80,6 +86,8 @@ modules:
 - `/chestshop`
 - `/trade`
 - `/market`
+- `/cart`
+- `/record`
 
 都可能在启动时注册成独立命令。
 
@@ -95,6 +103,8 @@ modules:
 /ms open systemshop:weapon
 /auction open
 /market open
+/cart help
+/record help
 ```
 
-如果你能正常打开系统商店、拍卖行和市场页面，说明基础配置已经生效。
+如果你能正常打开系统商店、拍卖、市场、购物车和记录页面，说明基础配置已经生效。