npx uniflow-plugin pack # → <id>-<version>.uniplugin(同时刷新 dist/)
npx uniflow-plugin validate x.uniplugin- 打包是确定性的(固定时间戳与文件顺序):同样的源码打出同样的字节、同样的 sha256。
- 分发有两条路:上架插件商店(推荐,见下一节),或把
.uniplugin直接发给用户,用户在插件库「已安装 › 从文件添加」或拖进插件库。安装对话框显示名字、版本、作者、大小、 权限(按风险标色)、UniMind 能调用哪些命令,第三方插件有醒目的「未经审核,只安装你信任的来源」提示。 - 安装后立即生效:命令注册进 UniMind,面板可以打开,不用重启、不用更新应用。
- 已安装的插件在插件库里可以:开关、打开、详情、导出(原样导出成 .uniplugin)、移除(数据保留)。
上架插件商店
UniFlow 桌面端侧边栏的「插件」就是插件商店,内容来自 UniFlow 网站。上架流程:
- 登录 开发者中心,创建开发者资料(handle、显示名、头像、网站、支持邮箱)。
- 新建插件:填插件 id(必须等于
plugin.json的id,全商店唯一、先到先得)与分类。 - 编辑商店页:中英文名称、一句话介绍、详细介绍(Markdown)、强调色、支持与隐私政策链接;上传素材:
素材 规格 用在哪 Banner 16:7,至少 1600×700,推荐 2400×1050,PNG / JPEG / WebP ≤ 5MB 首页大幅轮播、编辑精选卡片、详情页顶部。左下角约 45% 宽 × 40% 高会叠加图标、名字、一句话和按钮,重要内容放右侧与上部,那一块保持干净 图标 1:1,至少 256×256(推荐 1024×1024) 列表、详情页、已安装 截图 16:10,至少 1200×750(推荐 1600×1000),最多 8 张,每张可写中英文说明 详情页画廊 - 提交版本:上传
uniflow-plugin pack打出的.uniplugin与更新说明。服务端用与应用安装时同一套规则校验包, 还会检查:manifest.id等于条目 id、版本号高于已通过的最高版本、同一时间只有一个待审核版本。 - 审核:UniFlow 团队按安全模型与审核规范的清单审核(重点看新增的权限、给 UniMind 的命令说明、确认卡片是否说实话)。 通过后插件自动上架,用户在商店里立刻能看到、装上即用;驳回会附上理由,改完再提交。
- 更新:提交更高版本号的包,审核通过后,已安装的用户在商店「已安装」里看到「更新」(新增的权限在更新确认里标红)。 你可以随时把插件下架(已安装的用户照常使用,商店不再展示)或重新上架。
商店里显示的评分、评论与安装数来自真实用户;官方插件、认证开发者有对应标记。
更新
- 发新版:
version必须升;用户添加新文件时对话框显示「更新 1.2.0 → 1.3.0」,新增的权限单独标红。 - 降级:允许但会警告(旧版本可能读不懂新数据)。
- 数据格式要向前兼容,见存储 · 数据迁移。
- 需要新版宿主能力时写
minAppVersion,旧版 UniFlow 会拒绝安装并说明原因。
官方插件与「官方」标记
官方插件随应用内置(插件库「可添加的官方插件」里一键添加回来)。它们的包的 sha256 登记在应用的官方清单里: 导出再添加回来依然是「官方」;改过一个字节就不是了,且不能再用官方插件的 id —— 想基于官方插件改一个自己的版本, 复制源码、换一个 id 发布即可。