docs: add optional fields for supported platforms and AstrBot version range in plugin metadata

Author: Soulter

en/dev/star/plugin-new.md

@@ -53,6 +53,54 @@ You can add a `logo.png` file in the plugin directory as the plugin's logo. Plea
 
 You can modify (or add) the `display_name` field in the `metadata.yaml` file to serve as the plugin's display name in scenarios like the plugin marketplace, making it easier for users to read.
 
+### Declare Supported Platforms (Optional)
+
+You can add a `support_platforms` field (`list[str]`) to `metadata.yaml` to declare which platform adapters your plugin supports. The WebUI plugin page will display this field.
+
+```yaml
+support_platforms:
+  - telegram
+  - discord
+```
+
+The values in `support_platforms` must be keys from `ADAPTER_NAME_2_TYPE`. Currently supported:
+
+- `aiocqhttp`
+- `qq_official`
+- `telegram`
+- `wecom`
+- `lark`
+- `dingtalk`
+- `discord`
+- `slack`
+- `kook`
+- `vocechat`
+- `weixin_official_account`
+- `satori`
+- `misskey`
+- `line`
+
+### Declare AstrBot Version Range (Optional)
+
+You can add an `astrbot_version` field in `metadata.yaml` to declare the required AstrBot version range for your plugin. The format follows dependency specifiers in `pyproject.toml` (PEP 440), and must not include a `v` prefix.
+
+```yaml
+astrbot_version: ">=4.16,<5"
+```
+
+Examples:
+
+- `>=4.17.0`
+- `>=4.16,<5`
+- `~=4.17`
+
+If you only want to declare a minimum version, use:
+
+- `>=4.17.0`
+
+If the current AstrBot version does not satisfy this range, the plugin will be blocked from loading with a compatibility error.
+In the WebUI installation flow, you can choose to "Ignore Warning and Install" to bypass this check.
+
 ### Debugging Plugins
 
 AstrBot uses a runtime plugin injection mechanism. Therefore, when debugging plugins, you need to start the AstrBot main application.

zh/dev/star/plugin.md

@@ -228,6 +228,54 @@ async def on_message(self, event: AstrMessageEvent):
 
 你可以修改(或添加) `metadata.yaml` 文件中的 `display_name` 字段，作为插件在插件市场等场景中的展示名，以方便用户阅读。
 
+### 声明支持平台（Optional）
+
+你可以在 `metadata.yaml` 中新增 `support_platforms` 字段（`list[str]`），声明插件支持的平台适配器。WebUI 插件页会展示该字段。
+
+```yaml
+support_platforms:
+  - telegram
+  - discord
+```
+
+`support_platforms` 中的值需要使用 `ADAPTER_NAME_2_TYPE` 的 key，目前支持：
+
+- `aiocqhttp`
+- `qq_official`
+- `telegram`
+- `wecom`
+- `lark`
+- `dingtalk`
+- `discord`
+- `slack`
+- `kook`
+- `vocechat`
+- `weixin_official_account`
+- `satori`
+- `misskey`
+- `line`
+
+### 声明 AstrBot 版本范围（Optional）
+
+你可以在 `metadata.yaml` 中新增 `astrbot_version` 字段，声明插件要求的 AstrBot 版本范围。格式与 `pyproject.toml` 依赖版本约束一致（PEP 440），且不要加 `v` 前缀。
+
+```yaml
+astrbot_version: ">=4.16,<5"
+```
+
+可选示例：
+
+- `>=4.17.0`
+- `>=4.16,<5`
+- `~=4.17`
+
+如果你只想声明最低版本，可以直接写：
+
+- `>=4.17.0`
+
+当当前 AstrBot 版本不满足该范围时，插件会被阻止加载并提示版本不兼容。
+在 WebUI 安装插件时，你可以选择“无视警告，继续安装”来跳过这个检查。
+
 ### 消息事件的监听
 
 事件监听器可以收到平台下发的消息内容，可以实现指令、指令组、事件监听等功能。