Add MatrixShop 1.3.0 release notes

Author: 54895y

docs/matrixshop/bstats-and-telemetry.mdx

@@ -75,7 +75,7 @@ enabled: false
 源码构建后，MatrixShop 当前会输出带重定位 bStats 的运行产物：
 
 ```text
-build/libs/MatrixShop-1.2.0-all.jar
+build/libs/MatrixShop-1.3.0-all.jar
 ```
 
 `org.bstats` 已被重定位到插件私有包名下，避免和其他同样使用 bStats 的插件产生类冲突。

docs/matrixshop/commands-and-permissions.mdx

@@ -84,17 +84,27 @@ description: MatrixShop 的玩家指令、管理员指令与权限节点。
 | `/matrixshopadmin status` | `matrixshop.admin.status` | 查看经济、数据库、模块与迁移状态 |
 | `/matrixshopadmin module list` | `matrixshop.admin.module` | 查看模块启用情况 |
 | `/matrixshopadmin module <enable\|disable\|toggle> <id>` | `matrixshop.admin.module` | 切换模块开关 |
+| `/matrixshopadmin refresh list [category]` | `matrixshop.admin.refresh` | 查看当前系统商店分类的刷新区域与状态 |
+| `/matrixshopadmin refresh run <category> [icon]` | `matrixshop.admin.refresh` | 立即执行某个分类或图标槽位的刷新 |
+| `/matrixshopadmin goods ui [page]` | `matrixshop.admin.goods` | 打开 goods 仓库分页浏览 UI |
+| `/matrixshopadmin goods save <price> [buy-max] [product-id]` | `matrixshop.admin.goods` | 将当前主手物品保存为 goods 仓库商品 |
+| `/matrixshopadmin goods add <category> <product-id>` | `matrixshop.admin.goods` | 将已保存商品挂到指定系统商店分类 |
+| `/matrixshopadmin goods select <category> <product-id>` | `matrixshop.admin.goods` | 选中某个分类下的商品作为当前编辑目标 |
+| `/matrixshopadmin goods edit <price\|buy-max\|currency\|name\|item\|remove> ...` | `matrixshop.admin.goods` | 编辑已选中的系统商店商品 |
 
 ## 权限节点
 
 核心权限定义集中在 `Permissions.kt`：
 
 - 总管理：`matrixshop.admin`
+- 管理员细分：`matrixshop.admin.reload` / `sync` / `status` / `module` / `refresh` / `goods`
+- 管理记录：`matrixshop.admin.record.view.others` / `record.export`
+- 管理他人业务：`matrixshop.admin.auction.manage.others` / `chestshop.manage.others`
 - Menu：`matrixshop.menu.use`
 - SystemShop：`matrixshop.systemshop.use`
 - PlayerShop：`matrixshop.playershop.use` / `sell` / `manage.own`
 - GlobalMarket：`matrixshop.globalmarket.use` / `sell` / `manage.own`
-- Auction：`matrixshop.auction.use` / `sell` / `bid` / `buyout` / `manage.own`
+- Auction：`matrixshop.auction.use` / `sell` / `bid` / `buyout` / `manage.own` / `claim`
 - Cart：`matrixshop.cart.use` / `checkout` / `clear`
 - Record：`matrixshop.record.use` / `detail.self` / `stats.self`
 - Transaction：`matrixshop.transaction.use`

docs/matrixshop/index.mdx

@@ -10,13 +10,16 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
 
 当前最新修复版本为：
 
+- [1.3.0 发布说明](./release-notes-1-3-0)
 - [1.2.0 发布说明](./release-notes-1-2-0)
 
 ## 当前版本状态
 
 - 已完成首发所需的核心业务链
 - 默认文案、帮助输出和主要模块反馈已统一进语言系统
 - 支持 SQLite / MySQL，JDBC 不可用时自动回退到文件后端
+- `SystemShop` 已支持 goods 仓库、商品组、随机池和定时刷新基础能力
+- 已集成 `bStats`，可统计模块和基础配置分布
 - 默认文档以 `main` 分支和当前默认资源文件为准
 
 ## 当前实现的模块
@@ -56,16 +59,17 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
 如果你第一次接触 MatrixShop，推荐顺序是：
 
 1. [快速开始](./quick-start)
-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)
-5. [配置结构](./configuration-structure)
-6. [经济模块](./economy)
-7. [命令与权限](./commands-and-permissions)
-8. [数据库与存储](./database-and-storage)
-9. [bStats 与遥测](./bstats-and-telemetry)
-10. [模块总览](./modules-overview)
-11. [商店与模块详解](./shop-types)
+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)
 
 ## 发布前建议
 
@@ -77,6 +81,7 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
 
 如果你是从 `1.0.0` 升级，请先看：
 
+- [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)

docs/matrixshop/quick-start.mdx

@@ -19,6 +19,7 @@ description: 首次部署 MatrixShop、生成默认配置并验证基本指令
 
 如果你正在从 `1.0.0` 升级，请先阅读：
 
+- [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)

docs/matrixshop/release-notes-1-3-0.mdx

@@ -0,0 +1,124 @@
+---
+title: 1.3.0 发布说明
+description: MatrixShop 1.3.0 的 goods 仓库、定时刷新、后台维护流和验证结果。
+---
+
+# MatrixShop 1.3.0 发布说明
+
+发布时间：`2026-04-02`
+
+## 版本定位
+
+`1.3.0` 是在 `1.2.0` 管理能力基础上，继续把 `SystemShop` 的 goods 仓库、分类复用和定时刷新能力做成可部署版本的功能更新。
+
+这一版的重点不再只是“快速改商品”，而是把系统商店商品定义整理成一套可复用、可抽样、可按计划刷新的资源结构。
+
+## 本版本重点
+
+### Goods 仓库成为主流程
+
+`SystemShop` 当前推荐把商品定义集中放在：
+
+```text
+SystemShop/goods/*.yml
+```
+
+这套仓库现在支持三种资源：
+
+- `product`
+- `group`
+- `pool`
+
+它们分别用于：
+
+- 定义单个可售卖商品
+- 复用一组商品 id
+- 为刷新区域提供带权重的随机候选池
+
+分类文件 `SystemShop/shops/*.yml` 现在可以直接引用这些 goods id，而不必继续把大量商品定义内联在分类页里。
+
+### 后台维护流改成仓库式管理
+
+管理员商品维护流程当前已经拆分为：
+
+1. 先把主手物品保存到 goods 仓库
+2. 再把已保存商品挂到目标分类
+3. 需要时继续编辑价格、限购、货币或物品本体
+
+当前命令：
+
+```text
+/matrixshopadmin goods ui [page]
+/matrixshopadmin goods save <price> [buy-max] [product-id]
+/matrixshopadmin goods add <category> <product-id>
+/matrixshopadmin goods select <category> <product-id>
+/matrixshopadmin goods edit <price|buy-max|currency|name|item|remove> ...
+```
+
+默认资源也新增了三份后台 UI：
+
+- `SystemShop/ui/goods-browser.yml`
+- `SystemShop/ui/goods-editor.yml`
+- `SystemShop/ui/goods-shops.yml`
+
+### 新增定时刷新基础能力
+
+`SystemShop` 当前已经支持把刷新规则挂在：
+
+```text
+icons.<char>.refresh
+```
+
+可配置内容包括：
+
+- Quartz 风格 `Cron`
+- `Timezone`
+- `Same-For-Players-In-Group`
+- `groups.<id>.Match-Script`
+- `groups.<id>.Random-Refresh`
+- `groups.<id>.Pick`
+- `groups.<id>.Pool-Ref`
+- `groups.<id>.goods`
+
+这意味着同一个分类页中的某个 `mode: goods` 区域，可以按定时任务切换展示商品，并根据玩家匹配到的分组使用不同的商品集合或随机池。
+
+后台刷新命令：
+
+```text
+/matrixshopadmin refresh list [category]
+/matrixshopadmin refresh run <category> [icon]
+```
+
+### bStats 遥测已接入
+
+`1.3.0` 也包含了带重定位的 `bStats` 集成，用于统计基础部署信息和模块分布。
+
+当前文档页已经单独列出：
+
+- 上报的指标范围
+- 不会上报的内容
+- 关闭方式
+
+## 升级说明
+
+这一版没有引入必须执行的数据迁移步骤，但如果你从旧配置升级，建议注意：
+
+- 旧版在 `shops/*.yml` 中内联 `goods.<id>` 的写法仍可读取
+- 新配置建议把商品拆到 `SystemShop/goods/*.yml`
+- 如果要启用刷新区域，请先准备对应的 `Kind: pool` 或静态 `goods` / `group` 引用
+- 默认 `weapon` 分类已经附带一段关闭状态的刷新示例，可直接按需打开
+
+## 验证
+
+本版本发布前已完成：
+
+- `./gradlew build`
+- `paper-1.21.8` smoke boot
+- `paper-1.21.11` smoke boot
+
+## 相关链接
+
+- [GitHub Releases](https://github.com/54895y/MatrixShop/releases)
+- [1.3.0 GitHub Release](https://github.com/54895y/MatrixShop/releases/tag/v1.3.0)
+- [CHANGELOG](https://github.com/54895y/MatrixShop/blob/main/CHANGELOG.md)
+- [1.2.0 发布说明](./release-notes-1-2-0)

docs/matrixshop/shop-types/system-shop.mdx

@@ -1,6 +1,6 @@
 ---
 title: SystemShop
-description: SystemShop 的默认配置、goods 目录、分类引用和管理员维护方式。
+description: SystemShop 的默认配置、goods 仓库、分类引用、刷新能力和管理员维护方式。
 ---
 
 # SystemShop
@@ -16,6 +16,9 @@ description: SystemShop 的默认配置、goods 目录、分类引用和管理
 - `SystemShop/shops/material.yml`
 - `SystemShop/ui/shop.yml`
 - `SystemShop/ui/confirm.yml`
+- `SystemShop/ui/goods-browser.yml`
+- `SystemShop/ui/goods-editor.yml`
+- `SystemShop/ui/goods-shops.yml`
 
 ## `SystemShop/settings.yml`
 
@@ -328,6 +331,17 @@ icons:
 - `goods add` 只负责把商品 id 引用进分类文件的 `goods:`
 - `goods edit remove` 只会把商品从当前分类下架，不会删除 `goods` 仓库里的文件
 
+### 后台 UI 文件
+
+这三份 UI 文件用于后台 goods 维护：
+
+- `SystemShop/ui/goods-browser.yml`
+  - goods 仓库分页浏览页
+- `SystemShop/ui/goods-editor.yml`
+  - 单个 goods 的价格、限购、上架和主手物品同步页
+- `SystemShop/ui/goods-shops.yml`
+  - 某个 goods 的分类挂载选择页
+
 ## 你应该怎么改
 
 - 想新增一个分类：复制一份 `shops/weapon.yml`，改文件名，再把 `ui/shop.yml` 的按钮指过去。

docs/matrixshop/system-shop.mdx

@@ -1,6 +1,6 @@
 ---
 title: SystemShop
-description: SystemShop 的分类、goods 目录配置与确认流程。
+description: SystemShop 的分类、goods 仓库、刷新配置与后台维护流程。
 ---
 
 # SystemShop
@@ -14,6 +14,9 @@ SystemShop 的主要文件是：
 - `SystemShop/shops/*.yml`
 - `SystemShop/ui/shop.yml`
 - `SystemShop/ui/confirm.yml`
+- `SystemShop/ui/goods-browser.yml`
+- `SystemShop/ui/goods-editor.yml`
+- `SystemShop/ui/goods-shops.yml`
 
 默认主分类来自顶层 `config.yml`：
 
@@ -121,6 +124,15 @@ entries:
 - `/matrixshopadmin refresh list [category]`
 - `/matrixshopadmin refresh run <category> [icon]`
 
+后台 UI 文件分别负责：
+
+- `goods-browser.yml`
+  - 展示 goods 仓库分页列表，并从列表进入编辑
+- `goods-editor.yml`
+  - 调整价格、限购、主手物品同步和上架入口
+- `goods-shops.yml`
+  - 选择某个 goods 当前挂载到哪些系统商店分类
+
 ## 刷新区域
 
 当前已经实现一套 SystemShop 刷新基础能力，刷新规则直接挂在 `icons.<char>.refresh` 下。