插件能做的三件事
插件声明的命令直接进入 UniMind 的工具清单。只读命令模型可以直接调用;会改数据的命令先弹确认卡片,用户点了确认才执行,而且可以撤销。
以标签页打开的界面,React 或原生 TypeScript 都行。用与应用相同的设计令牌和 Tailwind 预设,深浅色自动跟随。
声明一个后台命令,插件启用期间由应用按间隔(至少 30 分钟)代为执行 —— 比如每 6 小时刷新一次日历订阅。

从想法到上架
一个命令生成项目,保存即热重载,打包后在控制台提交。
- 三步上手
生成项目
脚手架生成 plugin.json、命令、面板、中英文文案和测试。纯 TypeScript 与 React + Tailwind 两种模板可选。
$ npx uniflow-plugin init my-timer$ cd my-timer && npm install边写边试
每次保存自动构建。在 UniKnow 侧边栏「插件 › 开发者 › 加载开发中的插件」选中 dist/,改代码即热重载,命令立刻出现在 UniMind 里。
$ npm run dev # 保存即重新构建$ npm test打包提交
在开发者控制台上传包、填好商店页、配上 banner,提交审核。通过后自动上架,所有用户都能在侧边栏「插件」里找到。
$ npm run pack# → my-timer-1.0.0.unipluginSDK 即将发布到 npm。在那之前,快速开始文档写了怎样用本机的 SDK 目录运行同样的命令。
安全是默认值
插件能碰到的一切都经过应用,用户始终知道它能做什么。
沙箱隔离
代码运行在独立源的 iframe 与 Web Worker 里,CSP 禁止一切网络请求和外部资源,只能经 ctx 与应用打交道。
最小权限
12 项权限按需声明,没声明的能力在 ctx 上根本不存在。安装时权限翻译成人话、按风险标色。
用户说了算
模型发起的写操作都要用户在确认卡片上点确认,卡片如实描述将要发生的事,每一步都能撤销。
人工审核
每个版本上架前都由 UniKnow 团队审核:新增的权限、给 UniMind 的命令说明、确认卡片是否说实话。
每个版本的上架流程
从提交到用户收到更新,每一步都有记录。
- 1提交 .uniplugin
- 2自动校验(与安装同一套规则)
- 3人工审核
- 4上架插件商店
- 5用户一键更新
从官方插件学起
闪卡、考试规划、日历同步都是标准的 SDK 工程,与你用 init 生成的项目结构相同。导读逐个拆解了它们是怎么写的。






