OpenBitFun Mini Apps 小应用完全指南:把任何想法变成可复用的小工具
【免费下载链接】OpenBitFunOpenBitFun combines a high-performance agent runtime written in Rust with a polished desktop application. It pairs the depth of a Code Agent with open, general-purpose capabilities for work beyond software development.项目地址: https://gitcode.com/gh_mirrors/bit/OpenBitFun
OpenBitFun Mini Apps 是内置于 OpenBitFun 桌面应用中的轻量小应用体系:你可以一键安装现成的小工具,也可以直接对 AI 说"帮我做一个番茄钟小应用",让智能体为你写出界面、编译并上架,几分钟内就能把任何想法变成可反复使用的小工具。本指南面向新手,帮助你快速玩转 Mini App。
Mini App 是什么:装在 AI 桌面里的轻应用
Mini App 是运行在 OpenBitFun 内部的一种轻量应用,可以理解成"装在 AI 工作台里的小程序":
- 🧩界面 + 数据 + 智能体工作流:每个小应用都有独立界面,可读写自己的数据,还能调用模型补全、聊天等 AI 能力
- 🔒权限最小化:每个应用在自己的 meta.json 中声明所需权限(文件读写、命令白名单、网络访问),没有申请的能力一律不可用
- 🔁可复用:安装一次,随时打开;也可以生成定制草稿,实时预览改动后再应用
- 🤖AI 全程可参与:智能体可以帮你查看、创建、修改、删除小应用,甚至帮你提交到市场审核
完整的官方能力清单见 feature.miniapps.md。
先看看内置的小应用长什么样
OpenBitFun 自带了几个内置示例,展示 Mini App 能覆盖的多样性——从休闲游戏到开发者工具:
- 🃏每日占卜:每天翻一张卡片,纯展示型小应用
- ⚫五子棋 Gomoku:经典对战游戏,展示交互型应用
- 🔍正则 Playground:可视化正则匹配过程,展示工具型应用
在桌面应用中,Mini App 入口位于侧边导航栏,与 AI Assistant、Task Board 并列,随时可达:
三步上手:安装、打开、使用
使用流程非常简单:
- 打开 Mini Apps:点击侧边栏的 Mini App 入口(或直接在对话中说"打开 Mini Apps")
- 选择来源:进入"市场"浏览社区发布的应用,进入"已安装"管理本地应用,或选择"创建"发起一个新的
- 打开应用:按页面提示操作即可,智能体还能替你完成安装、更新、授权等操作
💡 小提示:直接对 AI 说"带我去小应用市场",它会先找到对应功能,确认目标后再替你打开。
最快上手方法:让 AI 帮你写出一个小应用
这是 Mini App 最有趣的玩法——不需要写代码,也不需要构建工具。智能体通过专用工具链(InitMiniApp创建骨架 → 通用文件工具编写源码 →FinalizeMiniApp编译发布)完成整个流程,直接在客户端内编译并保存。
试试这些说法:
- "创建一个番茄钟小应用"
- "做一个记录每天喝水次数的工具"
- "把已有小应用的按钮改成圆角"
- "创建一个统计我的 Git 提交频率的小应用"
智能体会先澄清几个关键问题(解决什么问题、要不要读工作区文件、要不要联网、要不要持久化状态),然后生成一个权限最小、明暗主题和双语都可用的小应用。开发流程与成功标准详见内置的 miniapp-dev 技能文档 与 API 参考。
一个 Mini App 由哪些文件组成
了解结构后,你可以更放心地让 AI 修改应用。以仓库内的 Git Graph 示例 为例,一个典型小应用包含:
| 文件 | 作用 |
|---|---|
| meta.json | 名称、图标、描述与权限声明 |
| source/index.html | 界面骨架 |
| source/ui.js | 前端逻辑,通过window.app调用宿主能力 |
| source/worker.js | 可选的后台逻辑,可引入 npm 依赖 |
| storage.json | 应用自身的键值存储 |
以 Git Graph 的权限声明为例,它只申请了必要的文件读取、git命令白名单和 Node Worker,网络访问完全关闭——这就是"最小权限"原则的实际样子。
📌 架构层面,Mini App 的 UI 运行在 iframe 中,后台 Worker 由 Rust 宿主管理,前后端通过 JSON-RPC 协同。想深入了解可阅读 架构与源码入口文档。
从想法到上架:定制与发布
- 定制草稿:对已安装应用发起定制,智能体生成草稿并实时预览,你可以随时"应用"或"丢弃",还能查看版本历史、回滚到旧版本
- 版本同步:市场应用支持更新到发布版本,
expectedVersion机制防止误覆盖你的本地修改 - 发布到市场:当你明确要求时,智能体可以调用
PublishMiniApp把完成的小应用提交到市场审核;市场端还支持收藏、评分与撤回
市场服务的部署配置可参考 miniapp-market 部署目录。
进一步探索:相关资料导航
- 📖 功能文档:feature.miniapps.md
- 🛠️ 开发技能:MiniApp/Skills/miniapp-dev/(含 设计指南 与 API 参考)
- 📚 示例源码:MiniApp/Demo/git-graph/ 与 MiniApp/Demo/icon-design-system/
- 🧪 产品内置参考样例:references/examples
现在就可以试试:在对话框里输入"帮我做一个番茄钟小应用",看 AI 如何把想法变成工具 ✨
【免费下载链接】OpenBitFunOpenBitFun combines a high-performance agent runtime written in Rust with a polished desktop application. It pairs the depth of a Code Agent with open, general-purpose capabilities for work beyond software development.项目地址: https://gitcode.com/gh_mirrors/bit/OpenBitFun
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考