# WebUp Cloud 插件与主题开发文档 适用扩展 API 版本 1。在管理后台打开「插件与主题」,选择自己制作的 ZIP,上传并校验,然后点击「启用此版本」。启用的插件出现在用户工作台的「扩展工具」。启用的主题应用到首页和用户工作台。 ## 通用清单 将 UTF-8 编码的 `manifest.json` 放在 ZIP 根目录: ```json { "apiVersion": 1, "type": "plugin", "id": "studio.word-counter", "version": "1.0.0", "name": "文字统计", "description": "在工作台统计字符和词数。" } ``` | 字段 | 要求 | | --- | --- | | `apiVersion` | 整数 `1` | | `type` | `plugin` 或 `theme` | | `id` | 最长 64 字符,以小写英文字母开头。后续可用小写字母、数字及由 `.` 或 `-` 隔开的段。建议使用开发者前缀 | | `version` | 最长 32 字符。三段式非负整数,例如 `1.0.0`,每段除 `0` 外不加前导零 | | `name` | 展示名称,最长 80 字符 | | `description` | 可选说明,最长 500 字符 | ZIP 最大 512 KiB。插件只打包 `manifest.json` 和 `index.html`,主题只打包 `manifest.json` 和 `theme.json`。选中两个文件打包,别把外层目录、依赖或隐藏文件一起压进去。清单最多 8 KiB,HTML 最多 256 KiB,主题 JSON 最多 16 KiB,均按解压后的大小计。 ## 开发插件 插件在工作台中的独立页面运行。把 HTML、样式和脚本构建成一个 `index.html`。用 `