收录范围
Scope · v1第一阶段只做「可信来源的插件目录」：把权限声明与校验值做扎实，让每一个条目都可核实。
v1 提供
· 官方插件、官方维护插件、官方审核插件
· 插件元数据（PluginManifest）：名称、版本、作者、许可、来源
· 版本列表与不可变的历史版本文件
· 权限声明：逐条列出插件需要的能力
· 兼容性声明：插件声明支持的 CetaMesh 版本
· 短时签名下载：安装前必须校验 SHA256
权限模型
Permissions插件必须逐条声明它需要的能力。没有「全部权限」这种默认值：未声明的能力不会被授予，未知能力默认拒绝。
| 权限 | 含义 | 类型 |
|---|---|---|
| network | 发起网络请求。 | 能力 |
| filesystem.read | 读取用户选择的文件。 | 文件系统 |
| filesystem.write | 写入或修改用户选择的文件。 | 文件系统 |
| clipboard | 读写剪贴板内容。 | 能力 |
| notifications | 发送系统通知。 | 能力 |
| device | 访问设备信息，或参与设备网络中的本地能力。 | 能力 |
| tasks | 创建、更新任务。 | 能力 |
| memory | 读写记忆。 | 能力 |
| shell | 命令执行类能力（词表预留，是否可授予由客户端版本决定）。 | 能力 |
下载与校验
Distribution & Verification插件包由 CetaMesh Server 通过 Nginx 静态目录提供，不经过网站进程转发；下载地址是短时签名链接，泄露后也会很快失效。
客户端读取 Registry→读取插件元数据→检查兼容性→展示权限
申请下载授权→短时签名地址→Nginx 直接返回 ZIP→校验 SHA256 后安装
SHA256 不匹配时必须拒绝安装。已发布的版本不可覆盖：文件名始终包含版本号 （weather-1.0.0.zip、weather-1.1.0.zip）， 不接受 weather.zip 这类会被反复覆盖的命名。
| 接口 / 路径 | 用途 | 提供方 |
|---|---|---|
| /api/v1/plugins | 插件列表（仅含已发布内容） | CetaMesh Lighthouse |
| /api/v1/plugins/<slug>/versions | 版本列表与下载授权入口 | CetaMesh Lighthouse |
| /plugins/packages/<slug>/<version>/<file> | 插件包（短时签名，Nginx 静态直出，不经 Next.js） | CetaMesh Server |
Plugins · 插件扩展
想接的插件还没有？先看看文档里的插件清单规范。