做你的第一个组件世界应用
用静态网页 + 组件世界 SDK 做一个小应用:组件世界登录、火花付费(你得 50%)、AI、数据保存;用电脑版命令行或任何 coding agent 开发,一条命令发布到应用市场。
组件世界的应用市场里的应用,都是一个普通的网页(HTML / JS / CSS)加上我们的 SDK。托管免费,用户用组件世界账号登录、用火花付费,用户在你的应用里花的火花你得 50%。
1. 准备
- 电脑版(下载)自带命令行
widgetstore:在「Agents → 命令行」里安装并连接账号。 - 也可以不装:在开发者中心新建应用、上传 zip。
- 用 coding agent(Claude Code、Codex、Cursor、我们的 Agents)的话,先让它读 AGENTS.md。
2. 生成模板
widgetstore app init my-app --template sparks # blank / sparks / ai
cd my-app
widgetstore app dev # http://127.0.0.1:5178/
本机预览会模拟组件世界:假的用户、假的火花(确认框照样弹,不会真扣)、假的 AI。
3. 清单和 SDK
根目录的 widgetstore.app.json:
{ "name": "My App", "version": "1.0.0", "entry": "index.html", "icon": "icon.svg",
"permissions": ["login", "sparks", "storage"], "network": [] }
页面里引入 https://widgetstore.net/apps/sdk/v1.js,然后:
await ws.ready(); // 语言、主题
const { user } = await ws.login(); // 昵称、头像、只在你的应用里有效的匿名 ID
await ws.sparks.charge({ amount: 50, reason: '解锁高级主题' }); // 用户确认后才扣
const { text } = await ws.ai.run({ prompt: '写一句早安' }); // 按用量扣用户的火花
await ws.storage.set('notes', ['…']); // 每个用户自己的数据,最多 512 KB
应用跑在单独的安全沙箱里,读不到用户在组件世界的登录信息和其它数据;要访问外部网站,把域名写进 network(最多 5 个,审核时会看)。
4. 发布
widgetstore app publish --slug my-app # 第一次:新建应用(网址 widgetstore.net/apps/my-app)
widgetstore app publish # 之后每次:一个新版本
每个版本都会自动检查(清单、文件类型、大小、可疑代码),第一次上架和权限有变化时人工审核,一般一天内。审核通过后自动上线;在开发者中心可以灰度(只给一部分人)和回滚。
5. 收益与提现
- 用户每次付费,你得 50%。用户「购买」的火花对应的部分可以提现,签到等赠送的火花对应的部分只计数;给自己的应用付费不分成。
- 收入冻结 30 天(这期间可以给用户退款),之后满 500,000 火花(约 50 美元)可以申请提现。提现由我们人工审核、人工打款。
规则
不能冒充组件世界或其他品牌,不能索要密码、银行卡或验证码,扣火花前要说清楚用户能得到什么;存用户数据要提供隐私政策。违反规则的应用会被下架。
最后更新:2026年11月15日