Skip to main content
苏小强 CLI 用于在 superun 项目和本地目录之间同步文件，终端命令是 sxq。你可以在熟悉的 IDE 或 AI 编程智能体中修改项目，再把改动推送回 superun、生成预览并正式上线。
苏小强 CLI 与 superun 产品内的 AI 助手“苏小强”名称相同，但不是同一个东西。产品内的苏小强负责咨询和使用帮助；sxq 命令负责从终端管理项目。
它是 项目开发和发布工具，不能替代用于操作线上业务数据和接口的 superun CLI。

​
准备工作

你需要：
  • Node.js 18 或更高版本；
  • 目标 superun 项目的访问权限；
  • 项目的 sessionId，可以在 superun 项目页面的 URL 中找到。

​
安装并登录

sxq login 会打开浏览器授权，并将临时凭证换成 PAT。从 v1.1.2 起，登录凭证默认保存在 macOS 钥匙串、Windows 凭据管理器或 Linux Secret Service 中，并按 API 基础 URL 隔离。已有 token 仍可通过以下命令导入：
已有 PAT 可用 sxq login --pat 隐藏输入，或用 sxq login --stdin 从标准输入导入；在线校验成功后才替换本地凭证。SUPERUN_PAT 优先于本地凭证，设置后执行 sxq login 只校验该环境变量，不打开浏览器、不保存到本地。空值或格式错误会报错；要使用本地凭证，请先取消该环境变量。PAT 不建议通过命令行参数传递，以免进入命令历史。 无会话 D-Bus 的无界面 Linux 环境会回退到本地明文凭证文件并提示，Unix 文件权限为 0600。凭证库已锁定、无法读取或损坏时，CLI 会报错，不会自动改用明文文件；请解锁或修复凭证库，也可以从密钥管理工具注入 SUPERUN_PAT。安装 CLI 时需保留 npm optional dependencies，以便加载对应平台的原生凭证库模块。 系统凭证库可用但没有凭证时，请重新登录；CLI 不会读取或迁移旧版明文 token，并会清理当前环境的旧明文登录凭证。sxq logout 只删除当前 API 环境在所选存储中的登录凭证，不撤销服务端 PAT；如果设置了 SUPERUN_PAT，还需自行取消该环境变量。

​
个人访问令牌（PAT）

在账号里可以创建、设置有效期并删除 个人访问令牌（以产品内入口为准），供 CLI、脚本或第三方工具以你的身份调用开放接口。
  • 创建时可选择 30 / 90 / 365 天，或 永久。
  • 明文令牌 只在创建时显示一次，请立即复制保存；之后列表里不再展示明文。
  • 在账号里删除令牌后，已写入 CLI 或 SUPERUN_PAT 的旧值会失效，需要重新创建并登录。
  • sxq logout 只清理本机凭证，不会作废服务端令牌；要停用某条令牌，请到账号里删除。
把已有令牌交给 CLI 的方式见上一节（sxq login --pat、--stdin 或 SUPERUN_PAT）。

​
CLI 版本更新

从 v1.1.1 起，CLI 每天首次执行命令时检查 npm 升级策略。latest 提示新版本；若当前版本低于维护者设置的 required，CLI 会自动升级后重新执行原命令。sxq upgrade、sxq logout、--version 和 --help 始终可直接执行。网络异常时沿用缓存策略；没有缓存时放行。该策略无法约束尚未包含升级门禁的旧版 CLI。

​
关联并拉取项目

创建一个空目录，把它关联到远端项目，然后拉取文件：
关联时会校验代码同步权限和项目可见性。项目必须完成样式选择，阶段至少为 2（演示）；阶段缺失、无效或低于 2 时拒绝关联，原有绑定保持不变。首次拉取为全量拉取，之后为增量拉取并进行三方合并。

​
修改并推送代码

完成本地修改后，把改动推送回 superun：
sxq push 会先拉取远端变化。如果文件无法自动合并，命令会中止，并在文件中写入 Git 风格的 <<<<<<<、======= 和 >>>>>>> 冲突标记。 处理全部冲突、删除标记并测试后，再次运行 sxq push。项目 .gitignore 匹配的文件，以及 node_modules、dist、.git 等内置忽略项不会同步。

​
预览和正式上线

触发 debug 编译并等待预览地址：
确认预览无误后，正式上线待发布版本：
只查看发布状态，不触发上线：
sxq deploy 会改变线上应用，并可能产生云服务费用。确认前请检查关联项目、预览结果和目标区域。

​
执行数据库迁移

在 supabase/migrations/ 下创建以下格式的迁移文件：
前缀必须是严格的 14 位 yyyyMMddHHmmss 时间戳，例如：
时间戳前缀用于确定迁移回放顺序，在同一个项目中必须唯一。禁止使用 Unix 时间戳、带分隔符的日期、缩短日期或其他位数的前缀。创建迁移前先检查已有文件名；如果时间戳已存在，请生成一个更晚的时间戳，不要复用。 然后执行远端还不存在的迁移：
CLI 会先拉取远端基线并找出待执行迁移。只要任一新增 SQL 文件名没有严格的 14 位时间戳前缀，或待执行迁移与其他待执行迁移、远端已有迁移复用了时间戳，整批任务就会在执行任何 SQL 前中止。校验通过后才按时间戳升序执行，遇到第一个失败后停止。迁移成功后，服务端会自动将文件保存为项目附件。不要通过 sxq push 推送迁移文件，CLI 会直接拦截。

​
命令速查

在 CI 或 AI 智能体中，可以为需要确认的命令添加 -y。在非交互环境中，CLI 会直接报错并给出提示，不会一直等待输入。

npm 上的苏小强 CLI

查看已发布的软件包和当前版本。

源代码

阅读完整参考资料或提交问题。