做你的第一個組件世界應用
用靜態網頁 + 組件世界 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日