Communitygithub.com

citedy/waitspin

WaitSpin 公共客戶端原始碼、信任邊界、OpenAPI 與來源證明。

waitspin 是什麼?

WaitSpin 是一個以 AI 代理為中心的廣告市場,專注於開發者等待狀態。廣告主可以購買簡短的贊助行,而使用者則能安裝經過驗證的收益表面,並從可見的贊助等待狀態訊息中獲利。此技能支援 VS Code、Cursor、Claude Code、GitHub Copilot CLI、MiMo Code 等多種開發工具平台。它透過安全的 OTP 驗證流程進行用戶註冊,並區分「控制」與「發布者擴充套件」兩種金鑰配置檔,以確保權限最小化。其核心功能包括廣告活動管理、收益表面安裝、錢包餘額查詢與付款準備,並嚴格遵守信任邊界,不傳輸工作區檔案、原始碼或編輯器內容。

相容平台✓Claude Code~Codex CLI✓Cursor✓Antigravity✓OpenCode
npx skills add citedy/waitspin

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 位數驗證碼。

  1. 根據意圖選擇金鑰配置檔:
    • control 用於廣告主廣告活動、結帳、Connect、付款準備和市場管理。
    • publisher-extension 用於使用者收益表面安裝、發佈者註冊、輪詢提供、曝光收據、以及唯讀錢包狀態/帳本檢查。
  2. 如果使用者未提供電子郵件,請在呼叫 CLI 之前要求提供電子郵件地址。
  3. 在使用前,將電子郵件驗證為標準的電子郵件地址。將 OTP 驗證碼驗證為恰好 6 位數字,將廣告活動 ID 驗證為預期的 WaitSpin ID,將廣告 URL 驗證為 HTTPS URL。
  4. 使用結構化輸出請求驗證碼。將以下內容視為字面範例;對於真實的使用者電子郵件,請透過主機工具的結構化 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
  1. 確認回應包含 next: "enter_email_code"。明確告知使用者:我已將一個 6 位數的 WaitSpin 驗證碼傳送至 <email>。回覆該驗證碼,我將繼續。 然後停止並等待使用者。
  2. 當使用者回覆驗證碼時,使用相同的電子郵件和金鑰配置檔進行驗證。在驗證其確實為 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
  1. 解析 JSON 回應。將 api_key 保密;請勿在聊天中回顯它。將其儲存在主機代理的密鑰儲存中,或透過工具環境欄位中的 WAITSPIN_API_KEY 傳遞給每個後續指令。請勿使用 --api-key 在 argv 中傳遞即時 API 金鑰,也請勿建立內聯 shell 賦值,例如 WAITSPIN_API_KEY='...' command。
  2. 立即繼續執行請求的工作流程。不要讓使用者自行找出下一個指令。

對於控制金鑰驗證後的廣告主入職流程:

# 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-fallback API 目標的 VS Code 相容編輯器模式。
  • Devin Desktop:使用 Open VSX 列表和相同 status-bar-fallback API 目標的 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:官方 UserPromptSubmit hook,包含 statusMessage/systemMessage 以及用於後續可見性回呼的官方 Stop hook。
  • 獨立的 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/campaignscampaigns:write建立廣告活動草稿和待處理的區塊購買
GET/v1/campaignscampaigns:read列出帳戶的廣告活動
POST/v1/blocks/checkoutblocks:purchase建立或重複使用 Stripe Checkout URL
POST/v1/publishers/registerpublishers:write註冊支援的使用者安裝
POST/v1/serve/nextserve:read擷取下一個贊助訊息或接收 204
POST/v1/events/impressionevents:write記錄帶有收據的可見曝光
GET/v1/wallet/statuswallet:read讀取餘額、Connect 狀態和付款資格
POST/v1/wallet/connectconnect:manage建立或重新整理 Stripe Express 入職連結
GET/v1/wallet/ledgerwallet:read讀取傳送、沖正、保留和付款帳本
POST/v1/wallet/payoutsconnect: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 進行驗證。

相關技能