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

Author: Soulter

zh/dev/star/plugin-new.md

@@ -53,6 +53,54 @@ git clone 插件仓库地址
 
 可以修改(或添加) `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 安装插件时，你可以选择“无视警告，继续安装”来跳过这个检查。
+
 ### 调试插件
 
 AstrBot 采用在运行时注入插件的机制。因此，在调试插件时，需要启动 AstrBot 本体。