这是 Mini Office 的官方插件源。客户端通过 GitHub API 读取根目录的 index.json，
拿到插件列表后一键安装。
不需要服务器、不需要审核后台。发布一个插件 = 提交一个目录 + push。
.
├── index.json # 客户端唯一入口（由
6472
脚本生成，不要手改）
├── plugins/ # 源码：一个目录一个插件
│ ├── pack-gov-doc/
│ │ ├── manifest.json
│ │ └── templates/gov-letter.docx
│ ├── theme-office-2003/
│ │ └── manifest.json
│ ├── theme-wps/
│ │ └── manifest.json
│ └── theme-office-365/
│ └── manifest.json
├── packages/ # 产物：打包出的 .moext，必须提交
│ ├── mini-office.pack-gov-doc-1.0.0.moext
│ ├── mini-office.theme-office-2003-1.0.0.moext
│ ├── mini-office.theme-wps-1.0.0.moext
│ └── mini-office.theme-office-365-1.0.0.moext
├── scripts/
│ ├── build-index.mjs # 打包全部插件 + 计算 SHA-256 + 生成 index.json
│ └── make-template.mjs # 生成公文模板 docx（二进制不适合手工维护）
└── .github/workflows/
└── release.yml # 打 tag 后自动打包、提交产物、发 Release 镜像
.moext 产物必须提交进仓库：客户端通过 raw.githubusercontent.com 下载。
GitHub Release 资产不可用——下载会 302 到 objects.githubusercontent.com，
该域不返回 CORS 头，WebView 里的 fetch 会被拦截。Release 只作人工下载镜像。
| 插件 | 类型 | 说明 |
|---|---|---|
mini-office.pack-gov-doc |
功能（宏 + 模板） | 公文排版助手：套用公文版式、三线表、横向页面、冻结表头、表头底纹；附党政机关公文模板 |
mini-office.theme-office-2003 |
主题 | Windows XP / Office 2003 Luna 风格：米黄底、直角凸起控件、紧凑密度、经典菜单栏 |
mini-office.theme-wps |
主题 | WPS Office 观感：冷灰分区、小圆角、默认密度 |
mini-office.theme-office-365 |
主题 | Microsoft 365 Fluent 观感：中性灰、扁平控件、舒适密度 |
功能插件不写代码，contributes.commands 里是 JSON 描述的宏步骤，由客户端按白名单解释执行。
操作清单见主仓库的 docs/plugin-macros.md。
npm install
node scripts/build-index.mjs --owner lq0910 --repo mini-office-plugins脚本会：
- 扫描
plugins/*/manifest.json； - 打包为
packages/<id>-<version>.moext； - 计算 SHA-256 与体积；
- 写出
index.json，download指向 raw 地址。
打包固定了 zip 条目时间戳，同一份源码重复打包得到完全相同的字节与哈希。 这一点很重要：否则每次重新打包哈希都会变，索引里的校验值与仓库里的包对不上， 客户端安装时会报"插件包校验失败"。
正常发布就是一次普通提交：
node scripts/build-index.mjs
git add index.json packages
git commit -m "feat: 新增 xxx 插件"
git push origin main推送后 raw 上即可下载，客户端「刷新列表」就能看到。
打 tag 是可选动作，只用于生成 Release 镜像：
git tag v1
git push origin v1.github/workflows/release.yml 会：
- 打包全部插件到
packages/； - 把
index.json与packages/提交回main（无变化则跳过）； - 创建 Release 并把
packages/*.moext作为附件上传（仅镜像，客户端不读）。
- 新建
plugins/<名字>/manifest.json，参考现有插件； - 本地跑一次
build-index.mjs，确认能通过打包（清单字段缺失会直接报错）； - 在 Mini Office 里用「安装本地插件」选择生成的
.moext，先自测效果； - 提交
plugins/、packages/、index.json并推送。
模板之类的二进制资源用脚本生成，不要手工提交改动的二进制：
node scripts/make-template.mjs-
permissions必须是[]——声明式插件不执行代码。 -
tokens只能写--mo-*白名单内的令牌；写--mo-doc-*会被拒绝， 因为它会改变文档画布的字体度量，进而改变分页与打印结果。 -
必填令牌：
--mo-bg、--mo-surface、--mo-surface-2、--mo-text-primary、--mo-text-muted、--mo-line。 -
正文与背景对比度需 ≥ 4.5:1，次要文字 ≥ 3:1。
-
chrome只接受枚举值：键 取值 toolbarmodern/classic-two-row/ribboncontrolShapeflat/beveled/roundeddensitycompact/default/comfortabletitlebarflat/gradient其中
classic-two-row会让应用在标题栏下渲染一行经典菜单栏（文件 / 编辑 / 视图 / 工具 / 帮助）。
完整字段定义见 mini-office 仓库的 packages/plugin-api/src/index.ts，
发布流程详解见 docs/plugin-publishing.md。
客户端在安装前会做这些检查，任何一项不通过都不会写入：
- 清单必填字段与
engines版本范围； - 声明式插件权限必须为空；
- 主题令牌白名单与对比度；
- 包内条目数与解压体积上限（防压缩炸弹）；
- 路径穿越（
..、绝对路径、反斜杠）； - 下载包的 SHA-256 与索引一致。
各插件在其 manifest.json 的 license 字段声明。当前均为 MIT。