用途
Superwall Paywall Editor 用于从命令行构建和编辑实时的 Superwall 付费墙。付费墙在浏览器编辑器中构建,该编辑器通过经过身份验证的中继暴露其工具;本技能从 CLI 驱动这一中继——与 MCP 网关使用的是完全相同的接口——因此你调用的每个工具都在用户已打开的实时浏览器会话中运行。
何时使用
- 用户想要构建、编辑或审查 Superwall 付费墙、引导流程(onboarding)或 web2app 流程。
- 用户粘贴配对码并要求你接管编辑。
- 用户询问“你现在能运行哪些工具?”——应通过浏览器发现,而不是凭记忆回答。
使用方式:先附加,再发现
切勿凭记忆假设工具名称或签名。浏览器是唯一事实来源,其工具集会随版本发布而变化。
- 向用户索取编辑器 UI 中显示的配对码。
- 附加会话:
scripts/sw-editor.sh attach <pairing-code> - 发现当前可用工具:
scripts/sw-editor.sh tools - 调用工具:
scripts/sw-editor.sh call <tool-name> --args '<json>'
完整 CLI 参考见 references/cli.md。
如何构建和编辑
- 工作流、构建顺序以及何时使用哪个工具:
references/workflow.md - 原生 sw-* 元素(multiple-choice、indicator、drawer、picker、lottie、navigation):
references/native-elements.md - 设计标准、审查检查点、排版和转化原则:
references/design.md
编排规则
- 始终先附加会话,再做其他任何事。
tools、call、status、release都要求已附加的会话。 - 在调用本会话中尚未使用过的工具之前,先运行
tools确认其存在并读取当前参数模式。工具定义在浏览器包中——更新后的编辑器会发布新增或重命名的工具,而本技能无需任何改动。 - 每 2–3 次修改后使用
get_screenshot(如果工具列表中存在)进行验证。不要盲目操作。 - 对现有结构,优先使用语义化工具(
update_styles、set_text_content、set_dynamic_value、move_nodes),而不是重新运行write_html。参见references/workflow.md。 - 当 UI 表示语义化控件时,优先使用原生 sw-* 元素,而不是手工用
<div>重建。参见references/native-elements.md。 - 用户完成后释放会话:
scripts/sw-editor.sh release。
出错时
session_not_ready:浏览器断开或重新加载。请用户把编辑器标签页调回来,然后重新附加(配对码会轮换——需要用户重新读给你)。session_locked:已有另一个客户端附加。用户可能从另一个 MCP 客户端附加,或之前的 CLI 附加未释放。用户可从编辑器 UI 分离,然后你可以重试。unauthorized:控制器令牌已过期——使用新的配对码重新附加。attach_failed:请提供有效的当前 pairingCode:配对码约 10 分钟后过期,并在分离时轮换。请用户向你展示当前配对码。
限制
本技能依赖浏览器编辑器会话和配对码,配对码会过期和轮换;工具集由浏览器端定义并随版本变化,必须实时发现。资料未提供其他平台支持、收费或价格信息。