组件世界 WidgetStore

做你的第一个组件世界应用

用静态网页 + 组件世界 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 个,审核时会看)。

每个应用的文件放在它自己的独立网址 https://<slug>.youos.link 上(和组件世界不是同一个网站,应用之间也互相隔开);用户还是在 widgetstore.net/apps/<slug> 打开你的应用。所以 slug 只能用小写字母、数字和单个连字符,不能以连字符结尾,www、mail、cdn 这类像平台服务的名字也不能用。

4. 发布

widgetstore app publish --slug my-app   # 第一次:新建应用(网址 widgetstore.net/apps/my-app)
widgetstore app publish                 # 之后每次:一个新版本

每个版本都会自动检查(清单、文件类型、大小、可疑代码),第一次上架和权限有变化时人工审核,一般一天内。审核通过后自动上线;在开发者中心可以灰度(只给一部分人)和回滚。

5. 收益与提现

  • 用户每次付费,你得 50%。用户「购买」的火花对应的部分可以提现,签到等赠送的火花对应的部分只计数;给自己的应用付费不分成。
  • 收入冻结 30 天(这期间可以给用户退款),之后满 500,000 火花(约 50 美元)可以申请提现。提现由我们人工审核、人工打款。

规则

不能冒充组件世界或其他品牌,不能索要密码、银行卡或验证码,扣火花前要说清楚用户能得到什么;存用户数据要提供隐私政策。违反规则的应用会被下架。

最后更新:2026年11月19日