feat(matrix): add missing Matrix constant and update docs (#7368)

* feat(matrix): 添加 Matrix 平台适配器支持及更新文档

* feat(matrix): 添加 Matrix 平台图标和教程链接

Author: stevessr

astrbot/core/pipeline/waking_check/stage.py

@@ -22,6 +22,7 @@
     "qq_official_webhook": lambda e: e.get_sender_id(),
     "lark": lambda e: f"{e.get_sender_id()}%{e.get_group_id()}",
     "misskey": lambda e: f"{e.get_session_id()}_{e.get_sender_id()}",
+    "matrix": lambda e: f"{e.get_sender_id()}_{e.get_group_id() or e.get_session_id()}",
 }
 
 

astrbot/core/star/filter/platform_adapter_type.py

@@ -22,6 +22,7 @@ class PlatformAdapterType(enum.Flag):
     SATORI = enum.auto()
     MISSKEY = enum.auto()
     LINE = enum.auto()
+    MATRIX = enum.auto()
     ALL = (
         AIOCQHTTP
         | QQOFFICIAL
@@ -38,6 +39,7 @@ class PlatformAdapterType(enum.Flag):
         | SATORI
         | MISSKEY
         | LINE
+        | MATRIX
     )
 
 
@@ -57,6 +59,7 @@ class PlatformAdapterType(enum.Flag):
     "satori": PlatformAdapterType.SATORI,
     "misskey": PlatformAdapterType.MISSKEY,
     "line": PlatformAdapterType.LINE,
+    "matrix": PlatformAdapterType.MATRIX,
 }
 
 

dashboard/src/assets/images/platform_logos/matrix.svg

@@ -38,6 +38,8 @@ export function getPlatformIcon(name) {
     return new URL('@/assets/images/platform_logos/misskey.png', import.meta.url).href
   } else if (name === 'line') {
     return new URL('@/assets/images/platform_logos/line.png', import.meta.url).href
+  } else if (name === 'matrix') {
+    return new URL('@/assets/images/platform_logos/matrix.svg', import.meta.url).href
   }
 }
 
@@ -65,6 +67,7 @@ export function getTutorialLink(platformType) {
     "satori": "https://docs.astrbot.app/platform/satori/llonebot.html",
     "misskey": "https://docs.astrbot.app/platform/misskey.html",
     "line": "https://docs.astrbot.app/platform/line.html",
+    "matrix": "https://docs.astrbot.app/platform/matrix.html",
   }
   return tutorialMap[platformType] || "https://docs.astrbot.app";
 }
@@ -107,6 +110,7 @@ export function getPlatformDisplayName(platformId) {
     vocechat: 'vocechat (VoceChat)',
     satori: 'satori (Satori)',
     line: 'line (LINE)',
+    matrix: 'matrix (Matrix)',
   };
   return displayNameMap[platformId] || platformId;
 }

dashboard/src/utils/platformUtils.js

@@ -3,6 +3,27 @@
 > [!TIP]
 > 该平台适配器由社区([stevessr](https://github.com/stevessr)) 维护。如果您觉得有帮助，请支持开发者，给该仓库点一个 Star。❤️
 
+## 部署 Matrix 服务器
+
+Matrix 是一个 IM 协议，有着丰富的服务端实现。
+
+请在 [Matrix Server](https://matrix.org/ecosystem/servers/)查看可用的服务端。
+
+
+
+## 支持的基本消息类型
+
+
+| 消息类型     | 是否支持接收 | 是否支持发送 | 备注                                           |
+| ------------ | ------------ | ------------ | ---------------------------------------------- |
+| 文本         | 是           | 是           |                                                |
+| 图片*        | 是           | 是           |                                                |
+| 语音*        | 是           | 是           |                                                |
+| 视频*        | 是           | 是           |                                                |
+| 文件*        | 是           | 是           |                                                |
+| 投票         | 是           | 否           |                                                |
+*: 会持久化到本地，插件会按配置清理，在发送前会进行上传操作，超过服务器允许大小的上传将会失败
+
 ## 安装 astrbot_plugin_matrix_adapter 插件
 
 进入 AstrBot WebUI 的插件市场，搜索 `astrbot_plugin_matrix_adapter`，点击安装。
@@ -13,7 +34,11 @@
 
 ## 配置
 
-请参考该仓库的 [README.md](https://github.com/stevessr/astrbot_plugin_matrix_adapter?tab=readme-ov-file#astrbot-matrix-adapter-%E6%8F%92%E4%BB%B6) 进行配置。
+- **`matrix_homeserver` (必填)`**: 你的 matrix 服务器实例的完整URL地址,支持域名委托自动探测。例如官方实例`https://matrix.org`
+- **`matrix_user_id`**: 你的 matrix 完整用户名。如 `@username:homeserver.com`
+- **`matrix_auth_method` (必填)** : 你的登陆方式，可选`password`,`token`,`oauth2`,`qr`推荐使用`password`或`oauth2/qr`模式 (oauth2/qr 模式下请确保用于认证/扫码的设备回调可以访问到 astrbot 配置的公开地址)
+
+更多请参考该仓库的 [README.md](https://github.com/stevessr/astrbot_plugin_matrix_adapter?tab=readme-ov-file#astrbot-matrix-adapter-%E6%8F%92%E4%BB%B6) 进行配置。
 
 ## 问题提交