Communitygithub.com

citedy/waitspin

WaitSpin 公共客户端源码、信任边界、OpenAPI 及出处。

waitspin 是什么?

WaitSpin 是一个面向开发者的基于 Agent 的广告市场,专门利用开发者工作流中的等待状态(如加载、构建过程)来展示赞助信息。广告商可以购买简短的赞助宣传语,而用户则可以通过安装经过验证的盈利表面(如 VS Code 扩展、Claude Code 插件等)来获得收益。该技能通过 `waitspin` npm CLI 包实现,支持一键式 OTP 自动化、广告活动创建、盈利表面安装以及钱包和支付就绪状态检查。它遵循严格的安全规则,例如通过结构化环境变量而非 shell 插值传递 API 密钥,并提供了一个清晰的信任边界,确保不发送工作区文件或源代码。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

waitspin 是做什么的?

WaitSpin 是一个面向开发者等待状态的、以 Agent 为先的广告市场。广告商购买简短的赞助行;用户安装经过验证的盈利表面,并从可见的赞助等待状态消息中获利。

权威来源

  • 公共网站:https://waitspin.com
  • API 文档:https://waitspin.com/docs
  • Agent 合约: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,当调用方需要结构化数据时优先使用它。

Agent 主导的 OTP 自动化

每当用户要求注册、加入、创建密钥、安装盈利表面或向你提供 WaitSpin 电子邮件地址时,使用此循环。Agent 可以完成流程,但用户必须收到电子邮件并提供 6 位数的验证码。

  1. 从意图中选择密钥配置文件:
    • 对于广告商活动、结账、Connect、支付就绪和市场管理,使用 control。
    • 对于用户盈利表面安装、发布者注册、投放轮询、展示收据和只读钱包状态/账本检查,使用 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"。准确地告诉用户:我已向 <email> 发送了一个 6 位数的 WaitSpin 验证码。回复该验证码,我将继续。 然后停止并等待用户。
  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

如果宿主 Agent 无法安全地将验证码放入 argv,则将 WAITSPIN_VERIFICATION_CODE 放在该单个命令的工具环境字段中,而不是将其作为前缀放在 shell 字符串中:

# WAITSPIN_VERIFICATION_CODE 由宿主工具的环境字段提供。
npx --yes [email protected] init --email [email protected] --key-profile control --json
  1. 解析 JSON 响应。将 api_key 保密;不要在聊天中回显。将其存储在宿主 Agent 的密钥存储中,或通过每个后续命令的工具环境字段中的 WAITSPIN_API_KEY 传递。不要使用 --api-key 在 argv 中传递实时的 API 密钥,也不要构建诸如 WAITSPIN_API_KEY='...' command 之类的内联 shell 赋值。
  2. 立即继续执行请求的工作流。不要让用户弄清楚下一个命令。

对于控制密钥验证后的广告商注册:

# WAITSPIN_API_KEY 由宿主工具的环境字段提供。
waitspin bid create --line "简短的赞助行" --url https://example.com --price-per-block 500 --blocks 1 --json
waitspin bids list --json
waitspin bid checkout CAMPAIGN_ID

对于发布者或用户在发布者扩展验证后的注册:

# WAITSPIN_API_KEY 由宿主工具的环境字段提供。
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 由宿主工具的环境字段提供。
waitspin bid create --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 由宿主工具的环境字段提供。
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 由宿主工具的环境字段提供。
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 钩子和运行时。
  • OpenCode:托管的 TUI 插件插槽。
  • Grok Code CLI:托管的文本资产页脚补丁,带有基于哈希的备份和恢复。
  • Qoder CLI:带有 statusMessage/systemMessage 的官方 UserPromptSubmit 钩子,以及用于后续可见性回调的官方 Stop 钩子。
  • 独立的 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 的官方钩子有效载荷由 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 进行验证。

相关技能