Skip to content

Commit 4d516a5

Browse files
54895y54895y
committed
Add Matrix plugin release and telemetry docs
1 parent 9d38eb1 commit 4d516a5

19 files changed

Lines changed: 404 additions & 31 deletions

‎docs/intro.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,12 @@ title: 插件 Wiki
66

77
当前已经收录：
88

9+
- [MatrixLib](/docs/matrixlib)
910
- [MatrixAgentSkills](/docs/matrix-agent-skills/overview)
1011
- [MatrixAuth](/docs/matrixauth/overview)
1112
- [MatrixCook](/docs/matrixcook/overview)
1213
- [MatrixShop](/docs/matrixshop)
14+
- [MatrixStorage](/docs/matrixstorage)
1315

1416
## 文档约定
1517

‎docs/matrixauth/bstats-and-telemetry.md‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
title: MatrixAuth bStats 与遥测
3+
description: MatrixAuth 当前 bStats 图表与预留指标位。
4+
---
5+
6+
# MatrixAuth bStats 与遥测
7+
8+
- Plugin ID: `30578`
9+
- 注册入口：`MatrixLib` `MatrixBStats`
10+
11+
## 当前图表
12+
13+
| Chart ID | 类型 | 含义 |
14+
| --- | --- | --- |
15+
| `default_login_mode` | SimplePie | 默认登录模式分布 |
16+
| `storage_backend` | SimplePie | 当前配置存储后端 |
17+
| `api_fallback` | SimplePie | Mojang API 回退策略 |
18+
| `easybot_http` | SimplePie | EasyBot HTTP 接口是否启用 |
19+
| `mcmmo_profile_sync` | SimplePie | mcMMO 档案同步是否启用 |
20+
| `bedrock_identity_policy` | SimplePie | 基岩身份保留策略 |
21+
| `hook_count` | SingleLineChart | 当前启用挂钩数量 |
22+
| `enabled_hooks` | AdvancedPie | 当前启用挂钩分布 |
23+
24+
## 预留图表位
25+
26+
| 预留 Chart ID | 计划用途 |
27+
| --- | --- |
28+
| `profile_storage_mode` | 统计未来档案存储分层策略 |
29+
| `active_account_types` | 统计档案当前激活账号类型分布 |
30+
| `guide_delivery_mode` | 统计引导提示的文本 / 点击 / 指令分发模式 |

‎docs/matrixauth/overview.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,13 @@ MatrixAuth 是一个基于 TabooLib 6 的混合登录与档案管理插件，目
1414
- 支持玩家向导、点击聊天操作、基岩版纯指令提醒。
1515
- 支持管理员通过 `/matrixauth admin ...` 强制维护其他玩家档案。
1616

17+
## 当前发布
18+
19+
- 当前版本：`1.0.1`
20+
- 前置版本：`MatrixLib 1.3.0`
21+
- 发布说明：[1.0.1 发布说明](./release-notes-1-0-1)
22+
- 遥测说明：[bStats 与遥测](./bstats-and-telemetry)
23+
1724
## 当前定位
1825

1926
MatrixAuth 现在已经不再把玩家档案存到 EasyBot 侧。档案数据只保存在插件自己的数据库中，EasyBot 只负责查询和展示。

‎docs/matrixauth/release-notes-1-0-1.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: MatrixAuth 1.0.1 发布说明
3+
description: MatrixAuth 1.0.1 telemetry 与依赖升级说明。
4+
---
5+
6+
# MatrixAuth 1.0.1 发布说明
7+
8+
发布日期：`2026-04-05`
9+
10+
## 本次更新
11+
12+
- 新增通过 MatrixLib 共享 API 注册的 `bStats` 遥测。
13+
- 版本依赖统一提升到 `MatrixLib 1.3.0`。
14+
- README 与文档入口补齐 release / telemetry 页面。
15+
16+
## 当前图表
17+
18+
- `default_login_mode`
19+
- `storage_backend`
20+
- `api_fallback`
21+
- `easybot_http`
22+
- `mcmmo_profile_sync`
23+
- `bedrock_identity_policy`
24+
- `hook_count`
25+
- `enabled_hooks`
26+
27+
## 验证记录
28+
29+
- `bash ./gradlew build`

‎docs/matrixcook/bstats-and-telemetry.mdx‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: MatrixCook bStats 与遥测
3+
description: MatrixCook 当前 bStats 图表与预留指标位。
4+
---
5+
6+
# MatrixCook bStats 与遥测
7+
8+
- Plugin ID: `30558`
9+
- 注册入口：`MatrixLib` `MatrixBStats`
10+
11+
## 当前图表
12+
13+
| Chart ID | 类型 | 含义 |
14+
| --- | --- | --- |
15+
| `storage_backend` | SimplePie | 当前锅具状态存储后端 |
16+
| `cooker_count` | SingleLineChart | 已加载锅具数量 |
17+
| `recipe_count` | SingleLineChart | 已加载配方数量 |
18+
| `fuel_count` | SingleLineChart | 已加载燃料数量 |
19+
| `category_count` | SingleLineChart | 已加载分类数量 |
20+
| `placed_cooker_count` | SingleLineChart | 已放置锅具数量 |
21+
| `placed_cooker_states` | AdvancedPie | 已放置锅具状态分布 |
22+
23+
## 预留图表位
24+
25+
| 预留 Chart ID | 计划用途 |
26+
| --- | --- |
27+
| `hologram_provider` | 统计全息提供者分布 |
28+
| `placed_sources` | 统计原版 / CraftEngine / ItemsAdder 放置来源 |
29+
| `batch_cooking_usage` | 统计批量烹饪启用率 |

‎docs/matrixcook/overview.mdx‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,13 @@ MatrixCook 是一套围绕“锅具、配方、燃料、放置状态”构建的
1717
- PlaceholderAPI、DecentHolograms、CMI 等可选集成
1818
- Folia / Paper / 混合核心兼容调度
1919

20+
## 当前发布
21+
22+
- 当前版本：`1.1.1`
23+
- 前置版本：`MatrixLib 1.3.0`
24+
- 发布说明：[1.1.1 发布说明](./release-notes-1-1-1)
25+
- 遥测说明：[bStats 与遥测](./bstats-and-telemetry)
26+
2027
## 当前目录
2128

2229
首次启动后，插件会在 `plugins/MatrixCook/` 下生成这些目录和示例文件：

‎docs/matrixcook/release-notes-1-1-1.mdx‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
title: MatrixCook 1.1.1 发布说明
3+
description: MatrixCook 1.1.1 telemetry 与依赖升级说明。
4+
---
5+
6+
# MatrixCook 1.1.1 发布说明
7+
8+
发布日期：`2026-04-05`
9+
10+
## 本次更新
11+
12+
- 新增通过 MatrixLib 共享 API 注册的 `bStats` 遥测。
13+
- 版本依赖统一提升到 `MatrixLib 1.3.0`。
14+
- README 与文档入口补齐 release / telemetry 页面。
15+
16+
## 当前图表
17+
18+
- `storage_backend`
19+
- `cooker_count`
20+
- `recipe_count`
21+
- `fuel_count`
22+
- `category_count`
23+
- `placed_cooker_count`
24+
- `placed_cooker_states`
25+
26+
## 验证记录
27+
28+
- `bash ./gradlew build`

‎docs/matrixlib/_category_.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"label": "MatrixLib",
3+
"position": 1,
4+
"link": {
5+
"type": "generated-index",
6+
"description": "MatrixLib 的共享前置、发布说明与 telemetry 文档。"
7+
}
8+
}

‎docs/matrixlib/bstats-and-telemetry.mdx‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
title: MatrixLib bStats 与遥测
3+
description: MatrixLib 当前承接的 bStats 图表与预留指标位。
4+
---
5+
6+
# MatrixLib bStats 与遥测
7+
8+
- Plugin ID: `30557`
9+
- 注册入口：`com.y54895.matrixlib.api.metrics.MatrixBStats`
10+
11+
## 当前图表
12+
13+
| Chart ID | 类型 | 含义 |
14+
| --- | --- | --- |
15+
| `configured_currency_count` | SingleLineChart | 当前已配置货币数量 |
16+
| `currency_modes` | AdvancedPie | 货币模式分布 |
17+
| `currency_setup` | SimplePie | 单货币 / 多货币部署类型 |
18+
19+
## 预留图表位
20+
21+
| 预留 Chart ID | 计划用途 |
22+
| --- | --- |
23+
| `downstream_plugin_count` | 统计当前安装的 Matrix 系列下游插件数量 |
24+
| `resource_sync_targets` | 统计共享资源同步目标分布 |
25+
| `compat_bridge_modes` | 统计兼容桥接启用情况 |

‎docs/matrixlib/index.mdx‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
title: MatrixLib
3+
description: Matrix 系列共享前置与运行时基础层总览。
4+
slug: /matrixlib
5+
---
6+
7+
# MatrixLib
8+
9+
`MatrixLib` 是 Matrix 系列插件的共享前置插件，当前统一承接：
10+
11+
- `branding / console / text / yaml / menu / compat / action / economy`
12+
- 共享 `Economy/currency.yml` 货币定义与同步
13+
- 共享 `bStats` API `MatrixBStats`
14+
- MatrixAuth / MatrixCook / MatrixShop / MatrixStorage 的 telemetry 运行时依赖
15+
16+
## 当前发布
17+
18+
- 当前版本：`1.3.0`
19+
- 依赖坐标：`com.y54895.matrixlib:matrixlib-api:1.3.0`
20+
- 发布说明：[1.3.0 发布说明](/docs/matrixlib/release-notes-1-3-0)
21+
- 遥测说明：[bStats 与遥测](/docs/matrixlib/bstats-and-telemetry)
22+
23+
## 推荐阅读
24+
25+
1. [1.3.0 发布说明](/docs/matrixlib/release-notes-1-3-0)
26+
2. [bStats 与遥测](/docs/matrixlib/bstats-and-telemetry)
27+
28+
## 后续文档预留
29+
30+
- 共享菜单 API 说明
31+
- 共享 YAML / 文本 API 说明
32+
- 共享 economy API 说明
33+
- 共享 compat / runtime bridge 说明

0 commit comments

Comments
 (0)