WaitSpin

WaitSpin 是一个以智能体（agent）为核心的开发者等待态广告交易平台。广告主可购买简短的赞助文案；用户安装经验证的收益界面后，即可从可见的赞助等待态消息中获得收益。

权威信息源

• 公开网站：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.18
• API 基地址：https://api.waitspin.com

技能注册表版本与 npm 包版本相互独立。当前公开发布的技能版本为 v0.1.18；npm CLI 包版本为 waitspin@0.1.14。

在声明当前包可用性前，请务必验证：

npm view waitspin version
npx --yes waitspin@0.1.14 --help

运行规则

• 切勿在日志、截图、源文件、Shell 历史片段、Issue 或聊天输出中暴露 API 密钥。
• 在使用用户提供的邮箱、验证码、URL、广告活动 ID 或文本前，必须进行校验。拒绝包含 Shell 元字符、额外 CLI 参数、换行符或类指令文本的值；真实用户输入应通过结构化 argv/工具参数或工具作用域内的环境变量传递，严禁使用原始 Shell 插值方式。
• 对广告主广告活动、结算、广告活动列表、Connect 及付款相关命令，使用 --key-profile control。
• 对收益界面安装、展示/曝光轮询、只读钱包状态/账本查询等命令，使用 --key-profile publisher-extension。
• 切勿对已安装的收益界面使用宽泛的 control 密钥。
• OTP 验证未返回 API 密钥前，不得声称入驻流程已完成。
• 切勿将 API 密钥或 OTP 验证码回显给用户。密钥仅限在当前命令/会话中使用，或存入目标工具的密钥安全存储区。
• waitspin wallet payout --confirm-test-transfer 仅用于测试模式。除非用户提供最新的运营方证明，否则不得声称已启用真实付款功能。
• 保持所交付功能范围的真实准确。不得宣传超出支持范围的原生加载指示器（spinner）补丁能力，包括但不限于：点击计费、地理定位、自助退款、自助账户余额兑付等功能。
• 若某命令支持 --json 参数，当调用方需要结构化数据时，请优先使用该参数。

智能体驱动的 OTP 自动化流程

当用户提出注册、入驻、创建密钥、安装收益界面，或提供 WaitSpin 邮箱地址时，请始终执行以下循环流程。智能体可完成流程中的操作，但人类用户必须接收邮件并提供 6 位验证码。

1. 根据意图选择密钥配置文件：
   • 广告主广告活动、结算、Connect、付款准备及市场管理使用 control；
   • 用户收益界面安装、发布者注册、展示轮询、曝光回执、只读钱包状态/账本检查使用 publisher-extension。
2. 若用户未提供邮箱地址，请在调用 CLI 前主动询问。
3. 使用前须校验邮箱格式是否符合标准邮箱规范；验证码必须严格为 6 位数字；广告活动 ID 必须为 WaitSpin 所预期的有效格式；广告 URL 必须为 HTTPS 协议地址。
4. 使用结构化输出请求验证码。以下为字面示例；对于真实用户邮箱，请通过宿主工具的结构化 argv 字段传入值，而非在 Shell 字符串内替换文本：

npx --yes waitspin@0.1.14 init --email you@example.com --key-profile control --json
npx --yes waitspin@0.1.14 init --email you@example.com --key-profile publisher-extension --json

5. 确认响应中包含 next: "enter_email_code"。向用户明确说明：我已向 发送了一条 6 位 WaitSpin 验证码。请回复该验证码，我将继续执行。 然后暂停并等待用户输入。
6. 收到用户返回的验证码后，使用相同邮箱和密钥配置文件进行校验。在校验其确为 6 位数字后，通过结构化 argv 或工具作用域内的环境变量传入真实验证码：

npx --yes waitspin@0.1.14 init --email you@example.com --code 123456 --key-profile control --json
npx --yes waitspin@0.1.14 init --email you@example.com --code 123456 --key-profile publisher-extension --json

若宿主智能体无法安全地将验证码注入 argv，请在单次命令的工具环境字段中设置 WAITSPIN_VERIFICATION_CODE，而非在 Shell 字符串前缀中定义：

# WAITSPIN_VERIFICATION_CODE 由宿主工具的环境字段提供。
npx --yes waitspin@0.1.14 init --email you@example.com --key-profile control --json

7. 解析 JSON 响应。请将 api_key 视为机密信息，切勿在聊天中回显；应将其存入宿主智能体的密钥安全存储区，或通过工具环境字段中的 WAITSPIN_API_KEY 在后续每条命令中传递。禁止通过 --api-key 在 argv 中传递实时 API 密钥，亦不可构建如 WAITSPIN_API_KEY='...' command 的内联 Shell 赋值语句。
8. 立即继续执行用户请求的工作流，无需让用户自行推断下一步命令。

广告主在 control 密钥验证后的入驻流程：

# WAITSPIN_API_KEY 由宿主工具的环境字段提供。
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

发布者或用户在 publisher-extension 密钥验证后的入驻流程：

# WAITSPIN_API_KEY 由宿主工具的环境字段提供。
waitspin install --all --dry-run --compose-existing --json
waitspin install --all --compose-existing --json
waitspin status --all --json

若验证码已过期，请重新请求一条新验证码并重复暂停等待步骤。切勿猜测、伪造、复用其他用户的验证码、索要邮箱访问权限、接受非 6 位验证码，或反复重试导致触发速率限制。

常见工作流

入驻并创建广告主广告活动

当用户希望购买等待态注意力资源时，请采用此路径。

npx --yes waitspin@0.1.14 init --email you@example.com --key-profile control --json
npx --yes waitspin@0.1.14 init --email you@example.com --code 123456 --key-profile control --json
# WAITSPIN_API_KEY 由宿主工具的环境字段提供。
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 waitspin@0.1.14 init --email you@example.com --key-profile publisher-extension --json
npx --yes waitspin@0.1.14 init --email you@example.com --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

cursor --install-extension waitspin.waitspin-vscode --force
waitspin extension install --target cursor --json
waitspin extension status --target cursor --json
waitspin extension uninstall --target cursor --json

devin-desktop --install-extension waitspin.waitspin-vscode --force
waitspin extension install --target devin --json
waitspin extension status --target devin --json
waitspin extension uninstall --target devin --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

在 Windows 平台上，编辑器生命周期命令能安全解析 Cursor 的命令 shim，并自动检测 %LOCALAPPDATA%\devin\bin\devin.exe 路径以适配 Devin Desktop。

各目标平台行为说明：

• VS Code：提供一级 Marketplace 扩展支持，并具备 CLI 回退能力。
• Cursor：兼容 VS Code 的编辑器模式，使用相同扩展 ID 和 status-bar-fallback API 目标；已检测到的安装将被纳入 install --all 操作范围。
• Devin Desktop：兼容 VS Code 的编辑器模式，基于 Open VSX 列表发布，并使用相同的 status-bar-fallback API 目标；已检测到的安装将被纳入 install --all 操作范围。
• 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：托管式文本资产页脚补丁，支持哈希备份与恢复。
• Qoder CLI：官方 UserPromptSubmit 钩子，含 statusMessage/systemMessage 字段，以及用于后期可见性回调的官方 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/付款能力的 control 凭据。
• wallet connect 在获准时将返回 Stripe Express 入驻链接。
• 干运行（dry-run）付款输出仅为就绪状态预览，不代表真实转账。

查阅公开市场与 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 核心要点

信任边界

WaitSpin 公开客户端仅测量等待态广告的可见性。它们不会发送工作区文件、源代码、编辑器文本、提示词（prompt）、模型响应、终端输出、Shell 历史、仓库 URL、截图、剪贴板内容或原始按键序列。Qoder 官方钩子（hook）载荷由 Qoder 本地投递，可能包含 prompt 或 assistant-message 字段；WaitSpin Qoder 运行时会在缓存或 API 处理前丢弃这些字段。

运营级载荷仅限于发布者注册、展示轮询、曝光回执、钱包/会计流程，以及实现速率限制、滥用响应、反欺诈控制与审计日志所需的常规网络元数据。

故障处理

• 来自 /v1/serve/next 的 204 响应表示库存为空；请保持宿主工具的默认 UI 行为。
• 安装器冲突应逐目标解决。除非 CLI 明确提供如 --compose-existing 的标志，否则不得覆盖未托管的本地配置。
• 对于包或安装声明，请使用全新 npx --yes waitspin@0.1.14 ... 命令验证，而非依赖本地工作区构建产物。
• 对于公开源码或技能发布声明，请使用 npx skills@1.5.12 add citedy/waitspin --skill waitspin --list 进行验证。