SuperAPI AI 工具集

paywall-editor

编程与开发

查看项目

更新于 10-16 05:29

技能介绍

用途

Superwall Paywall Editor 用于从命令行构建和编辑实时的 Superwall 付费墙。付费墙在浏览器编辑器中构建,该编辑器通过经过身份验证的中继暴露其工具;本技能从 CLI 驱动这一中继——与 MCP 网关使用的是完全相同的接口——因此你调用的每个工具都在用户已打开的实时浏览器会话中运行。

何时使用

  • 用户想要构建、编辑或审查 Superwall 付费墙、引导流程(onboarding)或 web2app 流程。
  • 用户粘贴配对码并要求你接管编辑。
  • 用户询问“你现在能运行哪些工具?”——应通过浏览器发现,而不是凭记忆回答。

使用方式:先附加,再发现

切勿凭记忆假设工具名称或签名。浏览器是唯一事实来源,其工具集会随版本发布而变化。

  1. 向用户索取编辑器 UI 中显示的配对码。
  2. 附加会话:scripts/sw-editor.sh attach <pairing-code>
  3. 发现当前可用工具:scripts/sw-editor.sh tools
  4. 调用工具: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 分钟后过期,并在分离时轮换。请用户向你展示当前配对码。

限制

本技能依赖浏览器编辑器会话和配对码,配对码会过期和轮换;工具集由浏览器端定义并随版本变化,必须实时发现。资料未提供其他平台支持、收费或价格信息。