Rabetbase CLI - Vibe Coding研发套件
一句话定位
Rabetbase CLI 是 Lovrabet平台扩展开发套件，让开发者不必到Lovrabet工作台做各种点击操作，直接在习惯的Codex、Cursor、ClaudeCode、Trae等CLI/IDE中通过自然语言完成95%的操作。包括：获取数据集信息、开发函数、编写SQL、开发页面、增量分析DB、生成/修改标准页面……
如何怎么使用
| 操作目标 | prompt |
|---|---|
| 我该敲哪个命令查数据集？ | “我接手订单管理页面，帮我先摸清订单相关的数据结构、字段、关联关系，并告诉我前端怎么接入。” |
| 我该怎么创建 SQL？ | “我想做一个按月统计订单金额的查询。先帮我看有没有现成能力可复用；没有的话再设计 SQL、校验字段和风险。” |
| 我该怎么推 BFF？ | “帮我检查当前项目本地和远端 BFF 是否一致。如果我要新增客户看板接口，先给我方案和影响预览，确认后再推送。” |
| 我该怎么排查项目状态？ | “帮我检查当前项目是否已经绑定 Lovrabet 应用，认证是否有效，有问题的话按影响程度列出修复建议。” |
| 我该怎么同步菜单？ | “帮我把当前页面菜单同步到平台。先预览会改哪些菜单、资源和线上入口，等我确认后再执行。” |
近期命令面提醒
- 平台应用发现统一使用
rabetbase app list --remote。 - 当前工作目录默认应用绑定统一使用
rabetbase workspace use --app <name>。 rabetbase app remote和rabetbase app use已从研发态 CLI 移除；AI 与脚本应直接使用新入口。
AI调用Rabetbase-CLI会做什么
当你用自然语言提出需求后，AI 会把它拆成可验证的研发动作。
- 理解目标：识别你要做的是页面接入、数据查询、SQL、BFF、菜单、排障还是部署。
- 读取真实上下文：通过 CLI 获取当前项目、应用、数据集、API、SQL 或 BFF 状态，避免靠猜。
- 选择实现路径：优先使用标准 SDK 和现有平台能力；确实不够时再考虑 SQL 或 BFF。
- 预览风险：只读动作直接执行；写入、推送、删除等动作先给你看影响范围和 dry-run 结果。
- 执行与验证：你确认后再执行写入，并把执行结果、失败原因和下一步建议反馈出来。
提供哪些能力
Rabetbase 的价值不是“多一个命令行工具”，而是让 AI 能可靠地接入 Lovrabet 平台真实上下文，把研发动作从后台点选和复制粘贴，变成可追踪、可校验、可自动化的协作流程。
| 维度 | 没有 Rabetbase 体系时 | 使用 Rabetbase + AI 后 |
|---|---|---|
| 数据与接口对齐 | 人手动找数据集、字段、接口和调用方式；表结构变化后容易漏改。 | AI 直接读取平台真实结构，先确认字段、关联和操作能力，再给出接入方案。 |
| 工具链与上下文 | IDE、控制台、SQL 工具、接口测试工具来回切换，上下文靠人复制。 | AI 在同一个任务里拉取上下文、分析问题、生成方案和验证结果。 |
| 自定义 SQL | 字段靠猜，SQL 散落在多处，问题常在联调或上线后暴露。 | AI 先查是否可复用，再基于真实字段设计查询，执行前做校验和风险提示。 |
| BFF 与本地调试 | 脚本改完才推远端验证，反馈链路长。 | AI 先检查本地与远端状态，给出差异、影响范围和预览，再等人确认执行。 |
| 安全与确认 | 靠人工记住哪些动作危险，容易误删、误推或误改配置。 | AI 读取 CLI 的风险等级，只读动作自动完成，高风险写入必须先说明影响并等待确认。 |
适合直接复制的 Prompt
下面这些不是命令，而是你可以直接发给 AI 的需求描述。AI 会自己决定需要调用哪些 CLI 能力。
| 场景 | Prompt 示例 |
|---|---|
| 接手新页面 | “我现在要做订单管理页面。请先帮我摸清订单相关数据集、字段、关联关系和可用操作，再给我前端接入建议。不要猜字段，先查真实结构。” |
| 写统计查询 | “我想按月统计订单金额。请先判断标准 filter 或已有 SQL 能不能满足；如果不能，再设计自定义 SQL，并在推送前做字段校验和风险检查。” |
| 开发 BFF | “我要新增一个客户看板接口。请先查现有 BFF 有没有类似能力，避免重复实现；然后给出实现方案、本地文件变更和推送预览。” |
| 排查问题 | “这个页面数据不对。请从当前应用配置、数据集字段、接口定义、SQL/BFF 状态逐层排查，并把每一步证据列出来。” |
| 发布前检查 | “我要把这次改动发布前过一遍。请检查本地与平台状态是否一致，列出会影响哪些 API、SQL、BFF 或菜单，并先给我 dry-run 结果。” |
| 团队资产盘点 | “帮我盘点这个应用里的数据集、SQL 和 BFF 资产，找出重复能力、命名不一致、长期未维护或可复用的部分。” |
文档导航
当前知识库已按 4 个分组整理。根文档负责说明使用心智；具体操作、命令细节和排障路径留给 AI 和维护者在子文档中查阅。
| 分组 | 适合什么时候看 |
|---|---|
| 入门与上手 | 想让 AI 帮你完成安装、登录、初始化、Claude Code 实战或本地调试时。 |
| 核心研发能力 | 涉及 API、数据集、BFF、自定义 SQL、代码生成或菜单同步时。 |
| 维护、安全与参考 | 需要排障、理解配置项、风险等级、安全确认或命令细节时。 |
| 资料与案例 | 对照控制台能力、查看 FAQ、Changelog、录屏资料或专题 QA 时。 |
第一次使用时怎么说
如果你还没有准备好项目，可以直接把下面这句话发给 AI：
“帮我检查这个项目是否已经具备 Rabetbase 开发条件。需要的话，请帮我完成安装、登录、项目初始化和应用绑定；过程中如果涉及授权或高风险写入，先告诉我为什么需要，再等我确认。”