MatrixStorage/RELEASE_POST_BBCODE.txt at main · MatrixPlugin/MatrixStorage · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
[center][size=6][b]MatrixStorage[/b][/size][/center]
[center][size=4]Matrix 系列统一仓储插件 / 储存库插件[/size][/center]
[center][size=3]当前发布版本：1.1.0[/size][/center]

[hr]

[b]插件简介[/b]

MatrixStorage 是 Matrix 系列的统一仓储插件，围绕玩家邮箱、个人仓库、待收区、位置型实体仓库和外部仓库投递工作。

当前实现已接入原版方块仓库，以及 CraftEngine、ItemsAdder、Nexo 的自定义方块与家具仓库，同时支持与 MatrixShop 进行外部仓库投递对接。

[b]核心功能[/b]

[list]
[*]玩家邮箱系统，支持玩家互寄与系统邮件
[*]支持文本内容、主手物品附件、Vault 金额附件
[*]个人仓库与待收区，总览页统一管理
[*]实体仓库系统，支持 location 型坐标仓库记录
[*]支持原版方块仓库
[*]支持 CraftEngine / ItemsAdder / Nexo 自定义方块与家具仓库
[*]支持仓库格子解锁与邮箱格子解锁
[*]每条解锁规则支持多条件、多价格、多货币同时扣费
[*]可与 MatrixShop 对接，承接外部仓库投递
[*]支持 sqlite / mysql / redis / yaml 四种后端
[/list]

[b]Wiki / 相关地址[/b]

[list]
[*]插件文档：[url]https://54895y.github.io/docs/matrixstorage[/url]
[*]项目仓库：[url]https://github.com/54895y/MatrixStorage[/url]
[*]GitHub Releases：[url]https://github.com/54895y/MatrixStorage/releases[/url]
[*]Issue 地址：[url]https://github.com/54895y/MatrixStorage/issues[/url]
[/list]

[b]Skills 使用方法[/b]

如果你希望使用 AI 生成 MatrixStorage 的邮箱、仓库、扩容规则，或同时联动 MatrixLib / MatrixShop 的共享货币配置，可以使用公开的 MatrixAgentSkills：

[list]
[*]Matrix Series Config 文档：[url]https://54895y.github.io/docs/matrix-agent-skills/matrix-series-config[/url]
[*]Codex / OpenAI Skills：
[url]https://github.com/54895y/MatrixAgentSkills/tree/main/matrix-series-config[/url]
[*]Claude / Gemini / Cline / Roo / Continue 通用 Prompt：
[url]https://raw.githubusercontent.com/54895y/MatrixAgentSkills/main/portable/matrix-series-config.md[/url]
[*]AIChat 知识库入口：
[url]https://raw.githubusercontent.com/54895y/MatrixAgentSkills/main/aichat/matrix-series-config-kb.md[/url]
[/list]

推荐使用方式：

[list=1]
[*]把对应的 Skill 或 Prompt 链接发给你的 AI Agent
[*]说明你要生成 MatrixStorage 的邮箱、仓库、扩容或实体仓库配置
[*]如果涉及货币结算，可以同时让 Agent 规划 MatrixLib / MatrixShop / MatrixStorage 三端同步的货币配置
[/list]

[b]更新日志[/b]

当前代码基线重点如下：

[list]
[*]当前发布版本已升级到 1.1.0
[*]共享货币定义已统一来自 MatrixLib
[*]新增通过 MatrixLib 共享 API 注册的 bStats 遥测
[*]新增通过 MatrixLib 共享更新器参与 GitHub Releases 更新检查与审批下载
[*]新增稳定 API 命名空间 com.y54895.matrixstorage.api / api.model
[*]MatrixLib / MatrixShop / MatrixStorage 三端会同步 Economy/currency.yml
[*]仓库与邮箱支持多条件、多价格、多货币解锁格子
[*]玩家总览页可直接执行容量扩容
[*]支持玩家邮箱、个人仓库、待收区与实体仓库总览
[*]支持 MatrixShop 外部仓库桥接，当前提供 store / openWarehouse / pendingCount 能力
[*]已接入 CraftEngine、ItemsAdder、Nexo 的自定义方块与家具仓库
[*]支持 sqlite / mysql / redis / yaml 四后端
[/list]

[b]bStats 图表[/b]

[list]
[*]Plugin ID：30559
[*]storage_backend：当前仓储状态后端
[*]matrixshop_bridge：MatrixShop 桥接是否就绪
[*]warehouse_definition_count：仓库定义数量
[*]mailbox_count：邮箱消息数量
[*]block_warehouse_count：实体仓库数量
[*]warehouse_definition_sources：仓库定义来源分布
[/list]

[b]预留图表位[/b]

[list]
[*]unlock_rule_count
[*]placement_mode_distribution
[*]pending_delivery_target
[/list]

[b]GitHub Issue 提交问题[/b]

[list]
[*]项目地址：[url]https://github.com/54895y/MatrixStorage[/url]
[*]Issue 地址：[url]https://github.com/54895y/MatrixStorage/issues[/url]
[/list]

如果你在使用过程中遇到以下问题，欢迎直接提交 Issue：

[list]
[*]邮箱收发异常
[*]仓库内容异常或丢失
[*]扩容规则配置问题
[*]实体仓库交互异常
[*]MatrixShop 桥接问题
[*]自定义方块插件兼容问题
[*]新功能建议
[/list]

提交 Issue 时建议附带以下信息：

[list]
[*]服务端核心与版本
[*]MatrixStorage 版本
[*]MatrixLib 版本
[*]是否安装 MatrixShop / CraftEngine / ItemsAdder / Nexo
[*]控制台报错日志
[*]相关配置文件片段
[*]复现步骤
[/list]

[hr]
[right][size=2][color=red]VibeCoding 声明：本插件在开发过程中使用了 AI / Vibe Coding 作为辅助工具，但实际功能收敛、配置结构、兼容性边界与发布内容仍以仓库代码、文档和实机测试结果为准；如发现问题，请优先通过 GitHub Issues 提交反馈。[/color][/size][/right]