Update Matrix economy and skills docs

Author: 54895y

docs/matrix-agent-skills/direct-link-examples.mdx

@@ -31,6 +31,13 @@ Then generate a MatrixShop config pack for a survival server with:
 - ChestShop enabled
 ```
 
+如果你要覆盖整个 Matrix 系列配置与 Kether 脚本，直接发这个：
+
+```text
+Install and use this Matrix Series config skill:
+https://github.com/54895y/MatrixAgentSkills/tree/main/matrix-series-config
+```
+
 ## Claude / Gemini / Cline / Roo / Continue
 
 这类 agent 更适合直接吃 raw prompt。
@@ -65,6 +72,19 @@ Migrate this UltimateShop config into MatrixShop SystemShop files.
 Keep the result in current MatrixShop structure.
 ```
 
+如果你的目标是同时生成 `MatrixLib / MatrixShop / MatrixStorage` 配置和 Kether 脚本，可以直接发：
+
+```text
+Use this Matrix Series config prompt pack:
+https://raw.githubusercontent.com/54895y/MatrixAgentSkills/main/portable/matrix-series-config.md
+
+Generate:
+- MatrixLib/Economy/currency.yml
+- MatrixStorage/Warehouse/settings.yml unlock rules
+- MatrixShop SystemShop and Auction currency references
+- related Kether conditions
+```
+
 ## AIChat
 
 AIChat 不建议直接投 skill，建议导入知识库。

docs/matrix-agent-skills/matrix-series-config.mdx

@@ -0,0 +1,39 @@
+---
+title: Matrix Series Config
+description: 覆盖 MatrixLib、MatrixShop、MatrixStorage、MatrixAuth、MatrixCook 与 Kether 的统一配置 skill。
+---
+
+# Matrix Series Config
+
+`matrix-series-config` 是 `MatrixAgentSkills` 中的新通用 skill。
+
+它的目标不是只生成 `MatrixShop`，而是处理整个 Matrix 系列的配置工作：
+
+- `MatrixLib`
+- `MatrixShop`
+- `MatrixStorage`
+- `MatrixAuth`
+- `MatrixCook`
+
+## 能做什么
+
+- 生成或修改 Matrix 系列 YAML 配置
+- 生成共享货币文件 `MatrixLib/Economy/currency.yml`
+- 输出 `MatrixStorage` 的邮箱/仓库解锁规则
+- 输出 `MatrixShop` 的商店配置与货币 key 引用
+- 输出 `MatrixAuth` 和 `MatrixCook` 的基础配置
+- 生成可落地的 Kether 条件与动作脚本
+
+## 当前关键规则
+
+- `MatrixLib` 是共享货币定义入口
+- `MatrixShop` 与 `MatrixStorage` 只引用货币 key
+- `MatrixStorage` 支持多条件、多价格、多货币解锁
+- Kether 只在当前插件真实支持的配置区块里输出
+
+## 适合的请求
+
+- “帮我生成 MatrixLib、MatrixShop、MatrixStorage 三端同步的货币配置”
+- “帮我写 MatrixStorage 的邮箱扩容和仓库扩容规则”
+- “给我一套 Matrix 系列配置，并带上 Kether 条件”
+- “把多个 Matrix 插件的配置一起整理成当前结构”

docs/matrix-agent-skills/overview.mdx

@@ -14,6 +14,7 @@ description: Matrix 系列插件的公开 skill、prompt pack 与知识库仓库
 当前首个可用包：
 
 - `matrixshop-config`
+- `matrix-series-config`
 
 ## 目标
 
@@ -29,14 +30,17 @@ description: Matrix 系列插件的公开 skill、prompt pack 与知识库仓库
 
 ### 原生 skill
 
+- `matrix-series-config`
 - `matrixshop-config`
 
 ### 通用 prompt
 
+- `portable/matrix-series-config.md`
 - `portable/matrixshop-config.md`
 
 ### AIChat 知识库
 
+- `aichat/matrix-series-config-kb.md`
 - `aichat/matrixshop-config-kb.md`
 
 ## 适用范围
@@ -50,11 +54,21 @@ description: Matrix 系列插件的公开 skill、prompt pack 与知识库仓库
 - `SystemShop / PlayerShop / GlobalMarket / Auction / ChestShop / Transaction / Cart / Record`
 - MatrixShop 当前支持的配置字段和输出约束
 
+当前 `matrix-series-config` 进一步覆盖：
+
+- `MatrixLib` 共享货币配置
+- `MatrixShop` 当前配置模型
+- `MatrixStorage` 邮箱、仓库、扩容解锁与方块仓库配置
+- `MatrixAuth` 基础配置、向导和 EasyBot 配置
+- `MatrixCook` 锅具、配方、燃料和分类配置
+- Matrix 系列可落地的 Kether 条件与动作脚本
+
 ## 推荐阅读
 
 1. [按 Agent 安装](./install-by-agent)
 2. [直接发给 Agent 的示例](./direct-link-examples)
-3. [MatrixShop Config Skill](./matrixshop-config)
-4. [迁移其他商店插件配置](./migrating-other-shop-plugins)
-5. [防经济膨胀提示词模板](./anti-inflation-prompt-templates)
-6. [AIChat 知识库入口](./aichat-knowledge-base)
+3. [Matrix Series Config Skill](./matrix-series-config)
+4. [MatrixShop Config Skill](./matrixshop-config)
+5. [迁移其他商店插件配置](./migrating-other-shop-plugins)
+6. [防经济膨胀提示词模板](./anti-inflation-prompt-templates)
+7. [AIChat 知识库入口](./aichat-knowledge-base)

docs/matrixshop/configuration/configuration-structure.mdx

@@ -111,7 +111,13 @@ Database:
 
 ### `Economy/currency.yml`
 
-这是 MatrixShop 当前的统一货币定义文件。
+这是 Matrix 系列当前的共享货币定义文件，主入口位于：
+
+```text
+plugins/MatrixLib/Economy/currency.yml
+```
+
+运行时会同步到 `MatrixShop` 与 `MatrixStorage` 的同路径文件。
 
 ```yaml
 vault:

docs/matrixshop/configuration/economy-reference.mdx

@@ -1,13 +1,14 @@
 ---
 title: 货币字段参考
-description: Economy/currency.yml 的字段、动作语法和占位符说明。
+description: MatrixLib 共享货币配置的字段、动作语法和占位符说明。
 slug: /matrixshop/economy-reference
 sidebar_position: 3
 ---
 
 # 货币字段参考
 
-这页只讲 `plugins/MatrixShop/Economy/currency.yml` 的字段规则。  
+这页只讲 `plugins/MatrixLib/Economy/currency.yml` 的字段规则。  
+运行时它会同步到 `MatrixShop` 与 `MatrixStorage` 的同路径文件。  
 如果你想直接照抄配置，请看 [经济配置实战示例](./economy-examples)。
 
 ## 文件结构

docs/matrixshop/configuration/economy.mdx

@@ -7,7 +7,7 @@ sidebar_position: 2
 
 # 经济模块
 
-MatrixShop 当前已经引入独立的经济模块，用来统一管理货币定义和交易动作。
+MatrixShop 当前通过 `MatrixLib` 的共享经济模块统一管理货币定义和交易动作。
 
 它和旧版“每个商店自己随便写货币逻辑”的思路不同，当前版本采用的是：
 
@@ -18,7 +18,8 @@ MatrixShop 当前已经引入独立的经济模块，用来统一管理货币定
 ## 核心结论
 
 - `Economy` 是核心模块，始终启用，不支持关闭。
-- 默认货币定义文件是 `plugins/MatrixShop/Economy/currency.yml`
+- 默认货币定义文件是 `plugins/MatrixLib/Economy/currency.yml`
+- 运行时会同步到 `plugins/MatrixShop/Economy/currency.yml` 与 `plugins/MatrixStorage/Economy/currency.yml`
 - 支持的货币模式：
   - `vault`
   - `playerpoints`
@@ -33,7 +34,7 @@ MatrixShop 当前已经引入独立的经济模块，用来统一管理货币定
 ## 默认文件
 
 ```text
-plugins/MatrixShop/Economy/currency.yml
+plugins/MatrixLib/Economy/currency.yml
 ```
 
 默认资源示例：
@@ -237,7 +238,7 @@ Currency:
 
 推荐做法是：
 
-1. 在 `Economy/currency.yml` 里统一定义货币
+1. 在 `MatrixLib/Economy/currency.yml` 里统一定义货币
 2. 在模块、商店或商品里只写 key
 
 也就是说，优先写：
@@ -249,6 +250,16 @@ Currency:
 
 而不是在每个商店文件里重复写整段货币动作。
 
+## 三端同步
+
+当前货币配置会在运行时同步以下三个文件：
+
+- `plugins/MatrixLib/Economy/currency.yml`
+- `plugins/MatrixShop/Economy/currency.yml`
+- `plugins/MatrixStorage/Economy/currency.yml`
+
+推荐把 `MatrixLib` 视为主入口，但如果你修改了三者中的任意一份，再执行重载，也会按最新修改时间重新同步。
+
 ## 管理与排查
 
 建议先执行：

docs/matrixshop/getting-started/faq.mdx

@@ -9,12 +9,17 @@ sidebar_position: 3
 
 ## 现在货币应该写在哪里
 
-当前版本已经重新引入统一货币定义文件：
+当前版本已经把统一货币定义入口收敛到 `MatrixLib`：
 
 ```text
-plugins/MatrixShop/Economy/currency.yml
+plugins/MatrixLib/Economy/currency.yml
 ```
 
+运行时会同步到：
+
+- `plugins/MatrixShop/Economy/currency.yml`
+- `plugins/MatrixStorage/Economy/currency.yml`
+
 推荐写法是引用货币 key，而不是在每个业务配置里重复写整段货币逻辑。
 
 优先级如下：

docs/matrixshop/getting-started/quick-start.mdx

@@ -12,7 +12,7 @@ sidebar_position: 1
 1. 将 `MatrixShop.jar` 放入服务端 `plugins/` 目录。
 2. 如果你准备使用 `vault` 货币，确保服务器安装了可用的 Vault 经济提供者。
 3. 启动一次服务器，让插件生成默认资源文件。
-4. 按需修改 `module.yml`、`database.yml` 和 `Economy/currency.yml`。
+4. 按需修改 `module.yml`、`database.yml` 和 `MatrixLib/Economy/currency.yml`。
 5. 重新启动，或使用管理员命令重载。
 
 如果你关心统计或隐私说明，继续看：
@@ -21,6 +21,7 @@ sidebar_position: 1
 
 如果你正在从 `1.0.0` 升级，请先阅读：
 
+- [1.6.0 发布说明](./release-notes-1-6-0)
 - [1.5.0 发布说明](./release-notes-1-5-0)
 - [1.4.0 发布说明](./release-notes-1-4-0)
 - [1.3.0 发布说明](./release-notes-1-3-0)
@@ -105,12 +106,14 @@ modules:
 
 ### 检查经济模块
 
-默认经济定义文件在：
+默认共享货币定义文件在：
 
 ```text
-plugins/MatrixShop/Economy/currency.yml
+plugins/MatrixLib/Economy/currency.yml
 ```
 
+运行时它会同步到 `MatrixShop` 和 `MatrixStorage` 的同路径文件。
+
 建议至少确认：
 
 - `vault` 是否可用

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

@@ -0,0 +1,47 @@
+---
+title: MatrixShop 1.6.0
+description: MatrixShop 1.6.0 的共享货币模块迁移、MatrixLib 依赖升级与测试结果。
+slug: /matrixshop/release-notes-1-6-0
+---
+
+# MatrixShop 1.6.0
+
+## 变更摘要
+
+- 货币模块正式迁移到 `MatrixLib`
+- `MatrixShop` 现在通过共享经济 API 读取货币配置
+- 货币定义主入口改为 `plugins/MatrixLib/Economy/currency.yml`
+- 运行时会与 `MatrixStorage` 同步 `Economy/currency.yml`
+- 依赖 `MatrixLib` 升级到 `1.1.0`
+
+## 配置影响
+
+业务配置里的货币 key 引用规则不变：
+
+- 商品级 `currency`
+- 商店级 `Currency.Key`
+- 模块级 `Currency.Key`
+
+变化点只在于：
+
+- 货币定义不再以 `MatrixShop` 为主入口
+- 不建议继续把整段货币动作逻辑写进商店业务配置
+
+## 测试结果
+
+本次版本已完成：
+
+- `./gradlew build`
+- `Paper 1.21.11` smoke boot 通过
+
+额外验证：
+
+- 共享货币文件已在 `MatrixLib / MatrixShop / MatrixStorage` 三端生成并保持一致
+
+## 升级建议
+
+升级到 `1.6.0` 后，优先检查：
+
+1. `MatrixLib` 是否已升级到 `1.1.0`
+2. `plugins/MatrixLib/Economy/currency.yml` 是否为你想要的最新货币定义
+3. `/matrixshopadmin status` 中的经济提供者状态是否正常

docs/matrixstorage/installation.mdx

@@ -24,16 +24,26 @@ description: MatrixStorage 的安装步骤、前置和可选依赖。
 ## 默认配置文件
 
 ```text
+plugins/MatrixLib/
+└─ Economy/currency.yml
+
 plugins/MatrixStorage/
 ├─ config.yml
 ├─ database.yml
 ├─ module.yml
 ├─ messages.yml
+├─ Economy/currency.yml
 ├─ Mailbox/settings.yml
 ├─ Warehouse/settings.yml
 └─ BlockWarehouse/settings.yml
 ```
 
+运行时会同步这三份货币配置：
+
+- `plugins/MatrixLib/Economy/currency.yml`
+- `plugins/MatrixShop/Economy/currency.yml`
+- `plugins/MatrixStorage/Economy/currency.yml`
+
 ## 启动确认
 
 启动成功后，控制台会显示：
@@ -42,4 +52,3 @@ plugins/MatrixStorage/
 - 邮件数量
 - 实体仓库数量
 - `MatrixShop` 桥接状态
-