Upstash 命令行工具
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/upstash-skills-upstash-cli。
技能介绍
要解决什么问题
Upstash 把 Redis、向量索引、全文搜索和 QStash 都放在托管 API 后面。控制台适合手工点选,但在 CI、运维脚本或 AI Agent 里,你需要稳定、可解析的接口:不能弹交互式登录,也希望成功与失败有统一形态。官方 upstash CLI 正是按这个前提设计的——走 Upstash Developer API,命令全部非交互,标准输出为 JSON,错误以 { "error": "..." } 写到 stderr 并退出码 1。
技能如何工作
认证可按机器一次 upstash login 写入 ~/.config/upstash/config.json,也可用环境变量、工作目录 .env,或 --email / --api-key;优先级为命令行 > 环境变量 > .env > 已保存配置。代理场景建议用只读 API Key,变更会在 API 层失败,与控制台行为一致。
按产品用资源 ID 旗标区分目标:--db-id(Redis)、--index-id(Vector / Search)、--qstash-id、--team-id。Redis 覆盖多区域创建与运维、备份,以及通过 --db-url / --db-token(或 UPSTASH_REDIS_REST_*)执行的 REST exec——与 Developer API Key 是两条路径。Vector 侧需关心区域、相似度(COSINE / EUCLIDEAN / DOT_PRODUCT)、索引类型(DENSE / SPARSE / HYBRID)及嵌入模型;HYBRID 托管嵌入时 --dimension-count 0。文档约定用 jq 抽字段、删除类操作先 --dry-run、redis get 在不需要密码时用 --hide-credentials。
适用边界与注意点
本技能描述的是 Developer API 驱动的管理能力,不是把 Upstash 控制台 UI 原样搬进对话。Redis 数据面的 REST 执行依赖实例的 REST URL 与 token,通常从 upstash redis get --db-id 的 endpoint / rest_token 取得。涉及删库、移除成员等不可逆操作时,务必先 dry-run;需要把输出接进管道或后续步骤时,以 JSON stdout 为契约解析。
使用场景
- 在部署流水线里用 JSON 输出列出并核对某区域的 Redis 实例 database_id
- Agent 只需查询 Upstash 资源清单时,用只读 API Key 调用 redis list 避免误删
- 新建 HYBRID 向量索引前,对照文档设置相似度与 --dimension-count 0 等参数
- 删除 QStash 或团队成员前先 upstash 命令加 --dry-run 确认影响范围
适合人员
- 负责 Serverless Redis 的 SRE,需要把实例创建、备份与区域信息写进 Ansible 或 GitHub Actions
- 做 RAG 的后端工程师,要在 eu-west-1 / us-east-1 上通过 CLI 管理 Vector 索引与嵌入模型选项
- 编写自动化运维 Agent 的平台同学,要求 Upstash 调用全程非交互且输出可 jq 解析
- 多环境共用 Upstash 的团队负责人,需用 --team-id 与认证优先级规则统一脚本与本地 .env