Add MatrixShop bStats documentation

Author: 54895y

docs/matrixshop/bstats-and-telemetry.mdx

@@ -0,0 +1,77 @@
+---
+title: bStats 与遥测
+description: MatrixShop 当前集成的 bStats 统计项、隐私范围和关闭方式。
+sidebar_position: 11
+---
+
+# bStats 与遥测
+
+MatrixShop 当前已经集成 `bStats`，用于统计插件的安装量和基础配置分布。
+
+当前插件 id 为：
+
+```text
+30502
+```
+
+## 当前会上报什么
+
+当前版本只上报配置和模块层面的聚合数据：
+
+- `database_backend`
+- `configured_database_backend`
+- `enabled_module_count`
+- `enabled_modules`
+- `systemshop_category_count`
+- `systemshop_goods_count`
+- `economy_currency_count`
+- `economy_currency_modes`
+
+这些图表分别反映：
+
+- 当前实际使用的数据后端
+- 配置中声明的数据后端
+- 当前启用的模块数量
+- 各模块是否启用
+- SystemShop 分类数量
+- SystemShop goods 仓库数量
+- 经济模块里配置的货币数量
+- 货币模式分布，例如 `vault`、`playerpoints`、`placeholder`
+
+## 当前不会上报什么
+
+当前实现不会通过 bStats 上报以下内容：
+
+- 玩家名
+- UUID
+- 聊天内容
+- 交易记录内容
+- 商品具体 NBT 或物品内容
+- 数据库连接地址、用户名或密码
+- 服务器自定义业务数据
+
+## 如何关闭
+
+`bStats` 的总开关由服务端公共配置控制。首次启动后，通常会在这里生成配置：
+
+```text
+plugins/bStats/config.yml
+```
+
+关闭方式通常是把其中的：
+
+```yaml
+enabled: false
+```
+
+然后重启服务端。
+
+## 对部署的影响
+
+源码构建后，MatrixShop 当前会输出带重定位 bStats 的运行产物：
+
+```text
+build/libs/MatrixShop-1.2.0-all.jar
+```
+
+`org.bstats` 已被重定位到插件私有包名下，避免和其他同样使用 bStats 的插件产生类冲突。

docs/matrixshop/faq.mdx

@@ -92,3 +92,11 @@ plugins/MatrixShop/Economy/currency.yml
 ## SystemShop 为什么没有数据库表
 
 因为当前 SystemShop 是纯配置驱动模块，不依赖 JDBC 运行表。真正大量落表的是拍卖、市场、玩家商店、购物车、箱店和记录系统。
+
+## MatrixShop 会不会发送遥测数据
+
+会。当前版本集成了 `bStats`，但只发送聚合级的配置和模块统计，不发送玩家交易明细或敏感配置。
+
+详细说明见：
+
+- [bStats 与遥测](./bstats-and-telemetry)

docs/matrixshop/index.mdx

@@ -63,8 +63,9 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
 6. [经济模块](./economy)
 7. [命令与权限](./commands-and-permissions)
 8. [数据库与存储](./database-and-storage)
-9. [模块总览](./modules-overview)
-10. [商店与模块详解](./shop-types)
+9. [bStats 与遥测](./bstats-and-telemetry)
+10. [模块总览](./modules-overview)
+11. [商店与模块详解](./shop-types)
 
 ## 发布前建议
 

docs/matrixshop/quick-start.mdx

@@ -13,6 +13,10 @@ description: 首次部署 MatrixShop、生成默认配置并验证基本指令
 4. 按需修改 `module.yml`、`database.yml` 和 `Economy/currency.yml`。
 5. 重新启动，或使用管理员命令重载。
 
+如果你关心统计或隐私说明，继续看：
+
+- [bStats 与遥测](./bstats-and-telemetry)
+
 如果你正在从 `1.0.0` 升级，请先阅读：
 
 - [1.2.0 发布说明](./release-notes-1-2-0)