Publish stable API docs for Matrix plugin series

Author: 54895y

docs/matrixauth/developer-api.md

@@ -5,7 +5,12 @@ description: MatrixAuth 当前开发者入口、代码树与 Javadoc 生成方
 
 # MatrixAuth 开发者 API
 
-MatrixAuth 当前没有单独拆分稳定 `api/` 包，开发者文档应优先参考这些分层：
+MatrixAuth 当前稳定公开层：
+
+- `com.y54895.matrixauth.api`
+- `com.y54895.matrixauth.api.model`
+
+内部代码主要仍按这些分层组织：
 
 - `MatrixAuth`
 - `command/`
@@ -27,6 +32,7 @@ src/main/kotlin/com/y54895/matrixauth/
 ├─ hook/
 ├─ listener/
 ├─ metrics/
+├─ api/
 ├─ service/
 └─ util/
 ```

docs/matrixauth/overview.md

@@ -16,9 +16,9 @@ MatrixAuth 是一个基于 TabooLib 6 的混合登录与档案管理插件，目
 
 ## 当前发布
 
-- 当前版本：`1.0.2`
-- 前置版本：`MatrixLib 1.4.0`
-- 发布说明：[1.0.2 发布说明](./release-notes-1-0-2)
+- 当前版本：`1.1.0`
+- 前置版本：`MatrixLib 1.5.0`
+- 发布说明：[1.1.0 发布说明](./release-notes-1-1-0)
 - 遥测说明：[bStats 与遥测](./bstats-and-telemetry)
 - 开发者 API：[开发者 API](./developer-api)
 

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

@@ -0,0 +1,19 @@
+---
+title: MatrixAuth 1.1.0 发布说明
+description: MatrixAuth 1.1.0 稳定 API 命名空间说明。
+---
+
+# MatrixAuth 1.1.0 发布说明
+
+发布日期：`2026-04-05`
+
+## 本次更新
+
+- 新增稳定 `com.y54895.matrixauth.api` 命名空间。
+- 新增 immutable snapshot：
+  - `MatrixAuthPlayerDataSnapshot`
+  - `MatrixAuthProfileSnapshot`
+  - `MatrixAuthLinkedAccountSnapshot`
+  - `MatrixAuthHookStatusSnapshot`
+- 新增 `MatrixAuthApi` facade。
+- 新增 Dokka Javadoc 生成。

docs/matrixcook/developer-api.mdx

@@ -5,10 +5,17 @@ description: MatrixCook 当前开发者入口、公开 API 包与 Javadoc 生成
 
 # MatrixCook 开发者 API
 
-MatrixCook 当前公开 API 主要集中在 `dev.lensocraft.cookly.api` 命名空间。
+MatrixCook 当前稳定公开层：
+
+- `dev.lensocraft.cookly.api`
+- `dev.lensocraft.cookly.api.data`
+- `dev.lensocraft.cookly.api.event`
+- `dev.lensocraft.cookly.api.hook`
+- `dev.lensocraft.cookly.api.runtime`
 
 推荐入口：
 
+- `MatrixCookApi`
 - `NameManager`
 - `CookerConfig`
 - `RecipeConfig`
@@ -26,7 +33,8 @@ src/main/kotlin/dev/lensocraft/cookly/
 │  ├─ NameManager.kt
 │  ├─ data/
 │  ├─ event/
-│  └─ hook/
+│  ├─ hook/
+│  └─ runtime/
 ├─ command/
 ├─ listener/
 ├─ manager/

docs/matrixcook/overview.mdx

@@ -19,9 +19,9 @@ MatrixCook 是一套围绕“锅具、配方、燃料、放置状态”构建的
 
 ## 当前发布
 
-- 当前版本：`1.1.2`
-- 前置版本：`MatrixLib 1.4.0`
-- 发布说明：[1.1.2 发布说明](./release-notes-1-1-2)
+- 当前版本：`1.2.0`
+- 前置版本：`MatrixLib 1.5.0`
+- 发布说明：[1.2.0 发布说明](./release-notes-1-2-0)
 - 遥测说明：[bStats 与遥测](./bstats-and-telemetry)
 - 开发者 API：[开发者 API](./developer-api)
 

docs/matrixcook/release-notes-1-2-0.mdx

@@ -0,0 +1,17 @@
+---
+title: MatrixCook 1.2.0 发布说明
+description: MatrixCook 1.2.0 稳定 API 命名空间说明。
+---
+
+# MatrixCook 1.2.0 发布说明
+
+发布日期：`2026-04-05`
+
+## 本次更新
+
+- 正式把 `dev.lensocraft.cookly.api.*` 视为稳定 API 命名空间。
+- 新增 `MatrixCookApi` facade。
+- 新增 `api.runtime` 快照：
+  - `MatrixCookRegistrySnapshot`
+  - `MatrixCookPlacedCookerSnapshot`
+- 新增 Dokka Javadoc 生成。

docs/matrixlib/index.mdx

@@ -15,16 +15,16 @@ slug: /matrixlib
 
 ## 当前发布
 
-- 当前版本：`1.4.0`
-- 依赖坐标：`com.y54895.matrixlib:matrixlib-api:1.4.0`
-- 发布说明：[1.4.0 发布说明](/docs/matrixlib/release-notes-1-4-0)
+- 当前版本：`1.5.0`
+- 依赖坐标：`com.y54895.matrixlib:matrixlib-api:1.5.0`
+- 发布说明：[1.5.0 发布说明](/docs/matrixlib/release-notes-1-5-0)
 - 遥测说明：[bStats 与遥测](/docs/matrixlib/bstats-and-telemetry)
 - 更新器说明：[自动更新与审批](/docs/matrixlib/updater-and-approval)
 - 开发者 API：[开发者 API](/docs/matrixlib/developer-api)
 
 ## 推荐阅读
 
-1. [1.4.0 发布说明](/docs/matrixlib/release-notes-1-4-0)
+1. [1.5.0 发布说明](/docs/matrixlib/release-notes-1-5-0)
 2. [自动更新与审批](/docs/matrixlib/updater-and-approval)
 3. [开发者 API](/docs/matrixlib/developer-api)
 4. [bStats 与遥测](/docs/matrixlib/bstats-and-telemetry)

docs/matrixlib/release-notes-1-5-0.mdx

@@ -0,0 +1,28 @@
+---
+title: MatrixLib 1.5.0 发布说明
+description: MatrixLib 1.5.0 稳定 API 命名空间与开发者文档说明。
+---
+
+# MatrixLib 1.5.0 发布说明
+
+发布日期：`2026-04-05`
+
+## 本次更新
+
+- 为 MatrixLib 公开层补充稳定 API 文档与 KDoc。
+- 补齐 Dokka Javadoc 生成与 `javadocJar` 产物。
+- 将 Matrix 系列稳定 API 基线提升到 `matrixlib-api:1.5.0`。
+
+## 稳定命名空间
+
+- `com.y54895.matrixlib.api.action`
+- `com.y54895.matrixlib.api.brand`
+- `com.y54895.matrixlib.api.compat`
+- `com.y54895.matrixlib.api.console`
+- `com.y54895.matrixlib.api.economy`
+- `com.y54895.matrixlib.api.hologram`
+- `com.y54895.matrixlib.api.menu`
+- `com.y54895.matrixlib.api.metrics`
+- `com.y54895.matrixlib.api.resource`
+- `com.y54895.matrixlib.api.text`
+- `com.y54895.matrixlib.api.update`

docs/matrixshop/developer-api.mdx

@@ -5,7 +5,13 @@ description: MatrixShop 当前开发者入口、代码树与 Javadoc 生成方
 
 # MatrixShop 开发者 API
 
-MatrixShop 当前没有单独拆分稳定 `api/` 包，开发者文档应优先参考这些分层：
+MatrixShop 当前稳定公开层：
+
+- `com.y54895.matrixshop.api`
+- `com.y54895.matrixshop.api.model`
+- `com.y54895.matrixshop.api.warehouse`
+
+内部代码仍主要按这些分层组织：
 
 - `MatrixShop`
 - `core/command`
@@ -22,6 +28,7 @@ MatrixShop 当前没有单独拆分稳定 `api/` 包，开发者文档应优先
 ```text
 src/main/kotlin/com/y54895/matrixshop/
 ├─ MatrixShop.kt
+├─ api/
 ├─ core/
 │  ├─ action/
 │  ├─ command/

docs/matrixshop/index.mdx

@@ -10,7 +10,7 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
 
 当前最新版本入口：
 
-- [1.6.2 发布说明](./release-notes-1-6-2)
+- [1.7.0 发布说明](./release-notes-1-7-0)
 - [1.5.0 发布说明](./release-notes-1-5-0)
 - [更新日志总览](./release-notes)
 
@@ -70,7 +70,7 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
 如果你第一次接触 MatrixShop，推荐顺序是：
 
 1. [快速开始](./quick-start)
-2. [1.6.2 发布说明](./release-notes-1-6-2)
+2. [1.7.0 发布说明](./release-notes-1-7-0)
 3. [bStats 与遥测](./bstats-and-telemetry)
 4. [开发者 API](./developer-api)
 5. [1.5.0 发布说明](./release-notes-1-5-0)
@@ -110,7 +110,7 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
 
 ### 更新日志
 
-- [1.6.2 发布说明](./release-notes-1-6-2)
+- [1.7.0 发布说明](./release-notes-1-7-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)
@@ -128,7 +128,7 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
 
 如果你是从 `1.0.0` 升级，请先看：
 
-- [1.6.2 发布说明](./release-notes-1-6-2)
+- [1.7.0 发布说明](./release-notes-1-7-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)