@qzsy/rivet-cli

Rivet 命令行工具（Node.js），对接线上平台 https://rivet.b.nps.qzsyzn.com。

安装

npm install -g @qzsy/rivet-cli

安装后使用 rivet 命令（与 Go 版 CLI 命令名一致）。

npm 上的 rivet-cli 名称已被占用，本包发布为 @qzsy/rivet-cli（@qzsy 组织 scope 包）。

快速开始

rivet config init
rivet login
rivet create my-app
cd my-app
# 编辑 frontend / backend / db …
rivet save . --project my-app
cd frontend && npm run build
rivet upload ./frontend/dist --domain rivet-my-app --project my-app

默认地址

| 项 | 默认值 | |----|--------| | API | https://rivet.b.nps.qzsyzn.com | | Web | https://rivet.b.nps.qzsyzn.com |

覆盖方式：rivet config set api <url>、RIVET_API_BASE 环境变量、或全局 --api。

常用命令

| 命令 | 说明 | |------|------| | rivet config init | 写入生产环境配置 | | rivet login | 浏览器登录 | | rivet create <name> | 创建项目并生成本地骨架 | | rivet save <dir> --project <name> | 部署 Worker + SQL | | rivet upload <dist> --domain <sub> | 上传静态站并绑域 | | rivet bind <domain> <hash> | 绑定子域 | | rivet projects | 列出项目 |

凭证与配置保存在 ~/.rivet/，与 Go 版 CLI 兼容。

发布到 npm（维护者）

cd packages/rivet-cli
.\scripts\publish.ps1

常见 E403 原因：

1. OTP 必须是 Authenticator 的 6 位码（不是 8 位恢复码）。
2. 不要先带 --otp 直接 npm publish：prepublishOnly 会先跑 tsc，OTP 30 秒内会过期。应先 npm run build，再立刻 npm publish --otp=XXXXXX --ignore-scripts（脚本已按此流程处理）。
3. 仍失败时：重新 npm login --registry https://registry.npmjs.org，或在 npm Access Tokens 创建 Granular Access Token（对 @qzsy 有 Publish 权限，勾选 Bypass 2FA），写入 ~/.npmrc 的 //registry.npmjs.org/:_authToken=...。

与 Go CLI 的关系

仓库内 cmd/rivet 为 Go 实现；本包为纯 Node 实现，便于 npm install -g 分发，无需安装 Go。