組件世界 WidgetStore - Notion 小組件、動態圖示、個人起始頁與個人主頁

做你的第一個組件世界應用

用靜態網頁 + 組件世界 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日