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

​
准备工作

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

​
安装并登录

sxq login 会打开浏览器完成授权。也可以使用已有 token：

​
关联并拉取项目

创建一个空目录，把它关联到远端项目，然后拉取文件：
关联时会校验项目是否属于当前账号。首次拉取为全量拉取，之后为增量拉取并进行三方合并。

​
修改并推送代码

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

​
预览和正式上线

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

​
执行数据库迁移

在 supabase/migrations/ 下创建以下格式的迁移文件：
建议使用时间戳作为前缀，例如：
然后执行远端还不存在的迁移：
迁移按文件名顺序执行，遇到第一个失败后停止。迁移成功后，服务端会自动将文件保存为项目附件。不要通过 sxq push 推送迁移文件，CLI 会直接拦截。

​
命令速查

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

npm 上的苏小强 CLI

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

源代码

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