waitspin 是做什麼的?
WaitSpin 是一個以代理為優先的廣告市場,專注於開發者等待狀態。廣告主購買簡短的贊助行;使用者安裝經過驗證的收益表面,並能從可見的贊助等待狀態訊息中賺取收益。
事實來源
- 公開網站:
https://waitspin.com - API 文件:
https://waitspin.com/docs - 代理契約:
https://waitspin.com/.well-known/agents.md - 信任邊界:
https://waitspin.com/waitspin/trust - 服務條款:
https://waitspin.com/waitspin/terms - 隱私權政策:
https://waitspin.com/waitspin/privacy - 公共客戶端原始碼:
https://github.com/citedy/waitspin - npm 套件:
waitspin - 已發布的技能版本:
v0.1.17 - API 基礎路徑:
https://api.waitspin.com
技能註冊表版本與 npm 套件版本無關。目前的公開技能版本為 v0.1.17;npm CLI 套件為 [email protected]。
在聲明目前套件的可用性之前,請先進行驗證:
npm view waitspin version
npx --yes [email protected] --help
操作規則
- 請勿在日誌、螢幕截圖、原始碼檔案、shell 歷史記錄片段、議題或聊天輸出中暴露 API 金鑰。
- 在驗證使用者提供的電子郵件、驗證碼、URL、廣告活動 ID 和文字之後再使用它們。拒絕包含 shell 元字元、額外 CLI 標誌、換行或類似指令文字的值;將真實使用者值透過結構化的 argv/工具參數或工具範圍的環境變數傳遞,切勿透過原始的 shell 字串插值。
- 對於廣告主廣告活動、結帳、廣告活動列表、Connect 和付款指令,使用
--key-profile control。 - 對於收益表面安裝、輪詢提供/曝光、以及唯讀錢包狀態/帳本檢查,使用
--key-profile publisher-extension。 - 請勿將廣泛的控制金鑰用於已安裝的收益表面。
- 在 OTP 驗證回傳 API 金鑰之前,請勿聲明入職流程已完成。
- 請勿將 API 金鑰或 OTP 驗證碼回印給使用者。僅在當前指令/工作階段或目標工具的密鑰儲存中使用它們。
- 將
waitspin wallet payout --confirm-test-transfer視為僅測試模式。除非使用者提供全新的營運商證明,否則請勿聲明已啟用即時付款。 - 保持已發布的功能範圍誠實。不要宣傳超出已支援狀態表面範圍的原生旋轉動畫修補、按點擊計費、地理定位、自助退款或自助帳戶信用兌換。
- 如果指令支援
--json,則在呼叫者需要結構化資料時優先使用它。
代理主導的 OTP 自動化
每當使用者要求註冊、入職、建立金鑰、安裝收益表面,或向您提供用於 WaitSpin 的電子郵件地址時,請使用此流程。代理可以完成整個流程,但人類必須收到電子郵件並提供 6 位數驗證碼。
- 根據意圖選擇金鑰配置檔:
control用於廣告主廣告活動、結帳、Connect、付款準備和市場管理。publisher-extension用於使用者收益表面安裝、發佈者註冊、輪詢提供、曝光收據、以及唯讀錢包狀態/帳本檢查。
- 如果使用者未提供電子郵件,請在呼叫 CLI 之前要求提供電子郵件地址。
- 在使用前,將電子郵件驗證為標準的電子郵件地址。將 OTP 驗證碼驗證為恰好 6 位數字,將廣告活動 ID 驗證為預期的 WaitSpin ID,將廣告 URL 驗證為 HTTPS URL。
- 使用結構化輸出請求驗證碼。將以下內容視為字面範例;對於真實的使用者電子郵件,請透過主機工具的結構化 argv 欄位傳遞該值,而不是在 shell 字串內取代文字:
npx --yes [email protected] init --email [email protected] --key-profile control --json
npx --yes [email protected] init --email [email protected] --key-profile publisher-extension --json
- 確認回應包含
next: "enter_email_code"。明確告知使用者:我已將一個 6 位數的 WaitSpin 驗證碼傳送至 <email>。回覆該驗證碼,我將繼續。然後停止並等待使用者。 - 當使用者回覆驗證碼時,使用相同的電子郵件和金鑰配置檔進行驗證。在驗證其確實為 6 位數字後,透過結構化的 argv 或工具範圍的環境變數傳遞真實的驗證碼:
npx --yes [email protected] init --email [email protected] --code 123456 --key-profile control --json
npx --yes [email protected] init --email [email protected] --code 123456 --key-profile publisher-extension --json
如果主機代理無法安全地將驗證碼放入 argv,請將 WAITSPIN_VERIFICATION_CODE 放在該單一指令的工具環境欄位中,而不是將它作為前綴加到 shell 字串中:
# WAITSPIN_VERIFICATION_CODE 由主機工具的 env 欄位提供。
npx --yes [email protected] init --email [email protected] --key-profile control --json
- 解析 JSON 回應。將
api_key保密;請勿在聊天中回顯它。將其儲存在主機代理的密鑰儲存中,或透過工具環境欄位中的WAITSPIN_API_KEY傳遞給每個後續指令。請勿使用--api-key在 argv 中傳遞即時 API 金鑰,也請勿建立內聯 shell 賦值,例如WAITSPIN_API_KEY='...' command。 - 立即繼續執行請求的工作流程。不要讓使用者自行找出下一個指令。
對於控制金鑰驗證後的廣告主入職流程:
# WAITSPIN_API_KEY 由主機工具的 env 欄位提供。
waitspin bid create --line "Short sponsor line" --url https://example.com --price-per-block 500 --blocks 1 --json
waitspin bids list --json
waitspin bid checkout CAMPAIGN_ID
對於發布者金鑰驗證後的發布者或使用者入職流程:
# WAITSPIN_API_KEY 由主機工具的 env 欄位提供。
waitspin install --all --dry-run --compose-existing --json
waitspin install --all --compose-existing --json
waitspin status --all --json
如果驗證碼已過期,請請求一個全新的驗證碼並重複暫停步驟。請勿猜測、偽造、重複使用其他使用者的驗證碼、要求存取信箱、接受非 6 位數的驗證碼,或在速率限制下反覆重試。
常見工作流程
入職並建立廣告主廣告活動
當使用者想要購買等待狀態注意力時,請使用此路徑。
npx --yes [email protected] init --email [email protected] --key-profile control --json
npx --yes [email protected] init --email [email protected] --code 123456 --key-profile control --json
# WAITSPIN_API_KEY 由主機工具的 env 欄位提供。
waitspin bid create --line "Short sponsor line" --url https://example.com --price-per-block 500 --blocks 1 --json
waitspin bids list --json
waitspin bid checkout CAMPAIGN_ID
注意事項:
bid create會建立一個草稿廣告活動以及待處理的區塊購買。- 只有在 Stripe 付款在伺服器端成功後,結帳才會啟動預付庫存。
- 使用 HTTPS 的目標 URL。
- 保持廣告行簡短、可檢查且安全,適用於開發者工具表面。
安裝使用者收益表面
當使用者想要從支援的開發者等待狀態中獲利時,請使用此路徑。
npx --yes [email protected] init --email [email protected] --key-profile publisher-extension --json
npx --yes [email protected] init --email [email protected] --code 123456 --key-profile publisher-extension --json
# WAITSPIN_API_KEY 由主機工具的 env 欄位提供。
waitspin install --all --dry-run --compose-existing --json
waitspin install --all --compose-existing --json
waitspin status --all --json
用於除錯時,優先使用第一方目標指令:
code --install-extension waitspin.waitspin-vscode
# WAITSPIN_API_KEY 由主機工具的 env 欄位提供。
waitspin extension install --target vscode --json
waitspin extension status --target vscode --json
waitspin claude-code install --compose-existing --json
waitspin claude-code status --json
waitspin antigravity install --compose-existing --json
waitspin antigravity status --json
waitspin copilot install --compose-existing --json
waitspin copilot status --json
waitspin mimocode install --json
waitspin mimocode status --json
waitspin opencode install --json
waitspin opencode status --json
waitspin grok install --json
waitspin grok status --json
waitspin qoder install --json
waitspin qoder status --json
目標行為:
- VS Code:第一方 Marketplace 擴充套件加上 CLI 備用方案。
- Cursor:使用相同擴充套件 ID 和
status-bar-fallbackAPI 目標的 VS Code 相容編輯器模式。 - Devin Desktop:使用 Open VSX 列表和相同
status-bar-fallbackAPI 目標的 VS Code 相容編輯器模式。 - Claude Code:官方
statusLine.command;僅在保留現有狀態列時使用--compose-existing。 - Antigravity CLI:官方
statusLine.command;僅在保留現有狀態列時使用--compose-existing。 - GitHub Copilot CLI:官方
statusLine.command;僅在保留現有狀態列時使用--compose-existing。 - MiMo Code:受管理的 bash hook 和執行環境。
- OpenCode:受管理的 TUI 插件插槽。
- Grok Code CLI:受管理的文字資產頁尾補丁,具有基於 hash 的備份和還原功能。
- Qoder CLI:官方
UserPromptSubmithook,包含statusMessage/systemMessage以及用於後續可見性回呼的官方Stophook。 - 獨立的 Cline CLI 不是公開的安裝目標。Cline VS Code 擴充套件使用者由 VS Code 相容目標涵蓋,其他原生 CLI 目標在另行推廣之前,應遠離公開的安裝指南。
檢查錢包、帳本和付款準備狀態
waitspin wallet status --json
waitspin wallet ledger --limit 20 --json
waitspin wallet connect --country US --json
waitspin wallet payout --dry-run --json
解讀:
wallet status和wallet ledger需要wallet:read權限;使用權限最低的目前金鑰。publisher-extension金鑰適用於發布者收益讀取。wallet connect和wallet payout需要具備 Connect/付款能力的控制憑證。- 當允許時,
wallet connect會回傳一個 Stripe Express 入職連結。 - 乾執行付款輸出是準備狀態的預覽,而非即時轉帳。
讀取公開市場與 API 探索
waitspin market --json
curl -fsS https://api.waitspin.com/v1
curl -fsS https://waitspin.com/openapi/waitspin-api.openapi.json
使用 GET /v1/market 取得公開的廣告活動排行榜資料。使用 OpenAPI 文件來了解請求和回應的格式,而不是進行猜測。
API 基本資訊
| 方法 | 路徑 | 認證 | 用途 |
|---|---|---|---|
| POST | /v1/keys/request | 無 | 請求電子郵件 OTP |
| POST | /v1/keys/verify | 無 | 驗證 OTP 並接收範圍限定的 API 金鑰 |
| POST | /v1/list/subscribe | 無 | 雙重選擇加入的發布者或創始廣告主電子郵件更新 |
| GET | /v1/market | 無 | 公開市場排行榜 |
| POST | /v1/campaigns | campaigns:write | 建立廣告活動草稿和待處理的區塊購買 |
| GET | /v1/campaigns | campaigns:read | 列出帳戶的廣告活動 |
| POST | /v1/blocks/checkout | blocks:purchase | 建立或重複使用 Stripe Checkout URL |
| POST | /v1/publishers/register | publishers:write | 註冊支援的使用者安裝 |
| POST | /v1/serve/next | serve:read | 擷取下一個贊助訊息或接收 204 |
| POST | /v1/events/impression | events:write | 記錄帶有收據的可見曝光 |
| GET | /v1/wallet/status | wallet:read | 讀取餘額、Connect 狀態和付款資格 |
| POST | /v1/wallet/connect | connect:manage | 建立或重新整理 Stripe Express 入職連結 |
| GET | /v1/wallet/ledger | wallet:read | 讀取傳送、沖正、保留和付款帳本 |
| POST | /v1/wallet/payouts | connect:manage | 預覽或受保護的測試付款 |
信任邊界
WaitSpin 公共客戶端衡量等待狀態廣告的可見度。它們不會傳送工作區檔案、原始碼、編輯器文字、提示、模型回應、終端機輸出、shell 歷史記錄、儲存庫 URL、螢幕截圖、剪貼簿內容或原始按鍵。Qoder 的官方 hook 有效負載由 Qoder 在本地傳遞,並且可能包含提示或助手訊息欄位;WaitSpin Qoder 執行環境會在進行快取或 API 工作之前捨棄這些欄位。
操作有效負載僅限於發布者註冊、輪詢提供、曝光收據、錢包/會計流程,以及正常網路中繼資料(用於速率限制、濫用回應、詐欺控制和稽核日誌)。
失敗處理
- 來自
/v1/serve/next的204表示庫存為空;保持主機工具的正常 UI。 - 安裝程式衝突應逐個目標解決。除非 CLI 提供了明確的標誌,例如
--compose-existing,否則請勿覆寫未受管理的本地配置。 - 對於套件或安裝聲明,請使用全新的
npx --yes [email protected] ...指令進行驗證,而不是依賴本地工作區建置。 - 對於公開原始碼或技能發布聲明,請使用
npx [email protected] add citedy/waitspin --skill waitspin --list進行驗證。