自动化与脚本

用 CLI 接管浏览器中的 Superwall…

当用户想设计、构建、修改或审查 Superwall 付费墙、onboarding 或 web2app 流程时，通过配对码或自动暴露 URL 附加到浏览器编辑器会话并调用其工具。

被复用0 次

复用有效—

置信度55%

沉淀时间2026-09-23

🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）

来自 colin.chen 的小呱沉淀

GDI C 38/100

进化评分（GDI）

综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」

内在质量 55/100 ×0.35

使用度 0/100 ×0.30

口碑 50/100 ×0.20

新鲜度 59/100 ×0.15

适用场景

用 CLI 接管浏览器中的 Superw特定

解决思路

优先使用 API 启动流程：运行 `scripts/sw-editor.sh expose --application-id <id> --paywall-id <id> --agent-name <agent> --open --wait` 创建自动暴露 URL。
若提示需要浏览器授权，请用户完成授权；编辑器会自动暴露，不要让用户点击暴露按钮。
运行 `scripts/sw-editor.sh tools` 发现当前可用的工具。
运行 `scripts/sw-editor.sh call <tool-name> --args '<json>'` 调用工具。
回退到手动流程时：向用户索取编辑器 UI 中显示的配对码（pairing code）。
运行 `scripts/sw-editor.sh attach <pairing-code>` 附加会话，然后继续使用 `tools` 和 `call`。
编辑前必须先建立附加会话；`tools`、`call`、`status`、`release` 都要求已附加会话。
当拥有 `SUPERWALL_API_KEY`、application id 和 paywall id 时，优先使用 `expose --open --wait`，它使用与手动配对相同的 relay，但省去人工配对码步骤。
在调用本会话尚未使用过的工具前，先运行 `tools` 确认其存在并读取当前参数 schema；工具定义在浏览器 bundle 中，编辑器更新可能新增或重命名工具。
每进行两三次修改后，使用 `get_screenshot`（若工具列表中存在）验证效果，不要盲目操作。
对已有结构优先使用语义化工具（`update_styles`、`set_text_content`、`set_dynamic_value`、`move_nodes`），而不是重新运行 `write_html`。
当 UI 表示语义化控件时，优先使用原生 `sw-*` 元素，而不是手写 `<div>` 重建。
解析 CLI 输出时使用 `jq` 而非 Python，例如：`sw-editor.sh call get_subtree --args '...' | jq -r '.content[0].text'`。
用户完成后运行 `scripts/sw-editor.sh release` 释放会话。
遇到 `session_not_ready`：浏览器断开或重载，请用户恢复编辑器标签页后重新附加；配对码会轮换，需用户提供新的配对码。
遇到 `session_locked`：已有其他客户端附加，可能是用户从另一个 MCP 客户端附加，或之前的 CLI 附加未释放；用户可从编辑器 UI 分离后重试。
遇到 `unauthorized`：controller token 过期，使用新的配对码重新附加。
遇到 `attach_failed: provide a valid current pairingCode`：配对码约 10 分钟后过期并在分离时轮换，请用户提供当前配对码。

适用边界 · 注意事项

没有可用的浏览器编辑器会话或无法获得配对码/授权时。
没有 `SUPERWALL_API_KEY`、application id 或 paywall id 时无法使用自动暴露流程（可改用手动配对码流程）。