Skip to content

Commit c87578c

Browse files
54895y54895y
committed
Expand MatrixAgentSkills migration docs
1 parent 8d98ae4 commit c87578c

8 files changed

Lines changed: 261 additions & 4 deletions

‎docs/matrix-agent-skills/aichat-knowledge-base.mdx‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,8 @@ AIChat 更适合：
3030
- `根据我的生存服需求生成 MatrixShop 的 module.yml、Economy/currency.yml 和一个 SystemShop 武器商店`
3131
- `给我一套支持点券的 Auction、GlobalMarket 和 PlayerShop 配置`
3232
- `我要一个不使用 shops 目录的 ChestShop、Cart、Record 配置`
33-
- `把这份旧 Malkuth 配置迁移成 MatrixShop 当前格式`
33+
- `把这份 UltimateShop 配置迁移成 MatrixShop 当前格式`
34+
- `把这份 EconomyShopGUI 配置迁移成 MatrixShop 当前格式`
3435

3536
## 当前知识覆盖
3637

‎docs/matrix-agent-skills/anti-inflation-prompt-templates.mdx‎

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
---
2+
title: 防经济膨胀提示词模板
3+
description: 用于生成更稳健的 MatrixShop 配置的经济平衡提示词模板。
4+
---
5+
6+
# 防经济膨胀提示词模板
7+
8+
这一页不是教 agent 写某个固定配置，而是给你一组更实用的提示词模板，让生成出来的 MatrixShop 配置更不容易造成经济膨胀。
9+
10+
## 使用建议
11+
12+
如果你只说：
13+
14+
- `帮我生成商店配置`
15+
16+
agent 很容易给你一套“能用但偏松”的商城配置。
17+
18+
如果你明确补上经济约束，结果会稳定很多。
19+
20+
## 模板 1：基础防膨胀
21+
22+
```text
23+
根据我的生存服需求生成 MatrixShop 配置。
24+
要求：
25+
- 默认货币使用 vault
26+
- SystemShop 只卖基础资源，不高价回收
27+
- 不要让商店同时承担高额回购和高频产出
28+
- 拍卖和玩家市场保留玩家定价空间
29+
- 所有默认价格偏保守
30+
- 给出 module.yml、Economy/currency.yml 和一个 SystemShop 示例分类
31+
```
32+
33+
## 模板 2：限制回购型经济
34+
35+
```text
36+
生成 MatrixShop 配置，目标是防止经济膨胀。
37+
要求：
38+
- SystemShop 允许出售基础物资给玩家
39+
- 不允许高利润回购刷钱
40+
- 如果需要回购，价格必须显著低于玩家获取成本
41+
- 产出性物品不要放在高频回购列表
42+
- 输出时说明哪些商品不建议做回购
43+
```
44+
45+
## 模板 3：拍卖与市场主导
46+
47+
```text
48+
生成一套偏玩家市场主导的 MatrixShop 配置。
49+
要求：
50+
- SystemShop 只做保底供应
51+
- 稀有资源不要由系统商店稳定卖出
52+
- GlobalMarket 和 Auction 作为主要交易出口
53+
- 默认价格避免压死玩家市场
54+
- 给出推荐的模块开关与价格策略
55+
```
56+
57+
## 模板 4：点券与金币分层
58+
59+
```text
60+
帮我设计一套不容易通货膨胀的 MatrixShop 配置。
61+
要求：
62+
- 日常材料使用 vault
63+
- 特殊商品和限时商品使用点券
64+
- 点券商品不要直接参与高额回购
65+
- 输出 Economy/currency.yml 和至少两个模块示例
66+
```
67+
68+
## 模板 5：开服初期保守定价
69+
70+
```text
71+
根据开服初期的生存服需求生成 MatrixShop 配置。
72+
要求：
73+
- 整体价格保守
74+
- 不开放容易破坏物价的高价回购
75+
- 系统商店只补基础生存物资
76+
- 玩家商店和全球市场后期承担主要流通
77+
- 请在结果里标出最容易导致经济膨胀的几个风险点
78+
```
79+
80+
## 模板 6：让 agent 主动审查风险
81+
82+
```text
83+
帮我生成 MatrixShop 配置，并顺带做一次经济风险审查。
84+
要求：
85+
- 输出完整配置
86+
- 单独列出可能导致经济膨胀的商品、回购项和模块组合
87+
- 对每个风险点给出更保守的替代方案
88+
```
89+
90+
## 推荐做法
91+
92+
最稳定的提问方式通常是三段式：
93+
94+
1. 你的服务器类型
95+
2. 你的经济目标
96+
3. 你的风险约束
97+
98+
例如：
99+
100+
```text
101+
我的服务器是长期生存服。
102+
我希望玩家市场活跃，但系统商店仍能提供基础物资。
103+
请帮我生成 MatrixShop 配置，并避免高额回购导致经济膨胀。
104+
```

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

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,16 @@ Generate:
5555
- SystemShop/shops/weapon.yml
5656
```
5757

58+
如果你的目标是迁移其他商店插件配置，也可以直接这样发：
59+
60+
```text
61+
Use this MatrixShop config prompt pack:
62+
https://raw.githubusercontent.com/54895y/MatrixAgentSkills/main/portable/matrixshop-config.md
63+
64+
Migrate this UltimateShop config into MatrixShop SystemShop files.
65+
Keep the result in current MatrixShop structure.
66+
```
67+
5868
## AIChat
5969

6070
AIChat 不建议直接投 skill，建议导入知识库。

‎docs/matrix-agent-skills/install-by-agent.mdx‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,8 @@ AIChat 不建议直接导入 Codex skill。
5050

5151
- `根据我的生存服需求生成 MatrixShop 的 module.yml、Economy/currency.yml 和一个 SystemShop 分类`
5252
- `帮我生成一个拍卖模块配置，要求使用点券作为默认货币`
53-
- `把下面这份旧 Malkuth 配置迁移成 MatrixShop 当前格式`
53+
- `把下面这份 UltimateShop 配置迁移成 MatrixShop 当前格式`
54+
- `把下面这份 EconomyShopGUI 配置迁移成 MatrixShop 当前格式`
5455

5556
## 为什么分三种入口
5657

‎docs/matrix-agent-skills/matrixshop-config.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,6 @@ description: 基于当前 MatrixShop 配置模型的专用 skill 说明。
9696

9797
- 从零生成 MatrixShop 配置
9898
- 生成某个模块的默认配置
99-
- 把旧 Malkuth 配置迁移成 MatrixShop
99+
- 把其他商店插件配置迁移成 MatrixShop
100100
- 解释某个字段应该放在 `settings.yml` 还是 `shops/*.yml`
101101
- 生成 bindings、help、hint 相关配置

‎docs/matrix-agent-skills/migrating-other-shop-plugins.mdx‎

Lines changed: 137 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,137 @@
1+
---
2+
title: 迁移其他商店插件配置
3+
description: 将其他商店插件配置迁移到 MatrixShop 的建议路径和提示词模板。
4+
---
5+
6+
# 迁移其他商店插件配置
7+
8+
这一页讨论的不是“怎么照抄原插件结构”，而是：
9+
10+
如何把其他商店插件的配置迁移成 MatrixShop 当前主线支持的结构。
11+
12+
## 常见迁移来源
13+
14+
当前最值得优先支持的来源有：
15+
16+
- `UltimateShop`
17+
- `EconomyShopGUI`
18+
- `Shopkeepers`
19+
- `QuickShop`
20+
21+
## 迁移原则
22+
23+
### 1. 不保留源插件的目录结构
24+
25+
迁移目标应该是 MatrixShop 当前支持的目录，而不是保留源插件键名。
26+
27+
例如：
28+
29+
- 静态分类商店 -> `SystemShop`
30+
- 玩家上架市场 -> `PlayerShop / GlobalMarket / Auction`
31+
- 箱子和告示牌商店 -> `ChestShop`
32+
33+
### 2. 以功能归类，不以插件名归类
34+
35+
不要把：
36+
37+
- `UltimateShop`
38+
- `EconomyShopGUI`
39+
40+
简单当作“旧版商城配置”整体照搬。
41+
42+
应该先识别它们的实际能力，再映射到：
43+
44+
- `SystemShop`
45+
- `PlayerShop`
46+
- `GlobalMarket`
47+
- `ChestShop`
48+
49+
### 3. 把货币层拆出来
50+
51+
如果源插件把货币写在每个页面或商品里，迁移时要按 MatrixShop 规则重组：
52+
53+
1. 商品级
54+
2. 商店级
55+
3. 模块级
56+
4. 默认 `vault`
57+
58+
## 具体建议
59+
60+
### UltimateShop -> MatrixShop
61+
62+
最常见的映射目标是：
63+
64+
- `SystemShop/settings.yml`
65+
- `SystemShop/shops/*.yml`
66+
67+
映射思路：
68+
69+
- 源分类 -> `shops/<category>.yml`
70+
- 商品显示 -> `name / lore / material / item`
71+
- 价格 -> `goods.<id>.price`
72+
- 限购 -> `goods.<id>.buy-max`
73+
- 页面标题和布局 -> `Title / layout / icons / template`
74+
75+
推荐提示词：
76+
77+
```text
78+
把下面这份 UltimateShop 配置迁移成 MatrixShop 的 SystemShop。
79+
要求：
80+
- 输出目标文件路径
81+
- 使用 MatrixShop 当前目录结构
82+
- 不保留 UltimateShop 原键名
83+
- 如果货币需要统一，优先放到 shop 级或模块级
84+
```
85+
86+
### EconomyShopGUI -> MatrixShop
87+
88+
最常见的映射目标也是：
89+
90+
- `SystemShop/settings.yml`
91+
- `SystemShop/shops/*.yml`
92+
93+
映射思路：
94+
95+
- 商店页 -> 一个 `shops/<page>.yml`
96+
- GUI 排列 -> `layout` 和 `icons`
97+
- 商品 -> `goods`
98+
99+
推荐提示词：
100+
101+
```text
102+
把下面这份 EconomyShopGUI 配置迁移成 MatrixShop 的 SystemShop。
103+
要求：
104+
- 每个页面生成一个 shops/*.yml
105+
- 价格和限购转换为 MatrixShop goods 结构
106+
- 不要输出 EconomyShopGUI 原始键名
107+
```
108+
109+
### QuickShop -> MatrixShop
110+
111+
这类物理箱店不要迁到 `SystemShop`。
112+
113+
更合理的目标是：
114+
115+
- `ChestShop/settings.yml`
116+
- `ChestShop/signs.yml`
117+
- `ChestShop/ui/*.yml`
118+
119+
推荐提示词：
120+
121+
```text
122+
把这份 QuickShop 需求迁移成 MatrixShop ChestShop 配置。
123+
要求：
124+
- 使用 MatrixShop 当前的 ChestShop 结构
125+
- 不输出 shops/*.yml
126+
- 保留箱子店、告示牌和展示物的行为设计
127+
```
128+
129+
## 输出建议
130+
131+
让 agent 做迁移时，建议始终要求它：
132+
133+
1. 先给出目标文件路径
134+
2. 再给出完整 YAML
135+
3. 如果存在不支持的源功能，只写一小段差异说明
136+
137+
这样输出最容易直接落地。

‎docs/matrix-agent-skills/overview.mdx‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,4 +55,6 @@ description: Matrix 系列插件的公开 skill、prompt pack 与知识库仓库
5555
1. [按 Agent 安装](./install-by-agent)
5656
2. [直接发给 Agent 的示例](./direct-link-examples)
5757
3. [MatrixShop Config Skill](./matrixshop-config)
58-
4. [AIChat 知识库入口](./aichat-knowledge-base)
58+
4. [迁移其他商店插件配置](./migrating-other-shop-plugins)
59+
5. [防经济膨胀提示词模板](./anti-inflation-prompt-templates)
60+
6. [AIChat 知识库入口](./aichat-knowledge-base)

‎sidebars.ts‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,8 @@ const sidebars: SidebarsConfig = {
1515
'matrix-agent-skills/install-by-agent',
1616
'matrix-agent-skills/direct-link-examples',
1717
'matrix-agent-skills/matrixshop-config',
18+
'matrix-agent-skills/migrating-other-shop-plugins',
19+
'matrix-agent-skills/anti-inflation-prompt-templates',
1820
'matrix-agent-skills/aichat-knowledge-base',
1921
],
2022
},

0 commit comments

Comments
 (0)