开发文档

从项目，到预览与上线。

官网、Agent 与 CLI，按你的工作流开始。

检查项目了解支持与适配范围 →连接 Agent安装 CLI 与本地 MCP →管理账户管理身份与访问 →

01 / 安装与客户端兼容

下载本地 CLI；原生 Agent 客户端组合仍待验收。

接入方式与开放状态

CLI 0.5 提供静态检查、源码选择和受控三步发布入口。具体动作取决于服务端开放状态；npm 尚未发布，Codex、Claude Code 和 Cursor 原生安装组合仍待验收。

客户端兼容与受验版本

客户端	接入方式	受验版本	安装包
Codex	BB Skill / stdio MCP / CLI	尚未验收	本地包，未上架
Claude Code	BB Skill / stdio MCP / CLI	尚未验收	本地包，未上架
Cursor	BB Skill / stdio MCP / CLI	尚未验收	本地包，未上架

查看本地检查报告 ↗下载 CLI 0.5 本地包 SHA256

本地验收包 · Node ≥ 22.12 · 原生客户端待验

本地安装与卸载

先核对下载包的 SHA256，再安装到独立目录。以下命令在下载目录执行，不使用全局安装或修改 MCP 配置。

shasum -a 256 brainbrawn-cli-0.5.0.tgz

本地包 SHA256

a67a1ba713745984c899c0c610153d4b7043359c83c91d3c900adb0cf95ce7dc

确认摘要一致后安装依赖；此步需要 npm 包源可访问，并禁用安装脚本。

mkdir brainbrawn-cli-local
npm install --prefix ./brainbrawn-cli-local --ignore-scripts --no-audit --no-fund ./brainbrawn-cli-0.5.0.tgz
node ./brainbrawn-cli-local/node_modules/@brainbrawn/cli/dist/main.js version

本地受验环境为 macOS arm64、Node 26.11.0、npm 11.20.0；其他系统和客户端组合仍待验收。

默认只读凭证不授予写入能力。源码上传和发布需要独立范围与浏览器确认，不能用模型自述代替授权。

本地 MCP 由客户端启动，使用明确获授权的项目目录。以下是进程命令，尚不是三客户端受验配置。

node ./brainbrawn-cli-local/node_modules/@brainbrawn/cli/dist/main.js mcp serve --stdio --workdir /absolute/canonical/project

产品 Skill 位于本地包 integrations/skills/brainbrawn-deploy；配置模板仅供核对，不自动覆盖个人配置。

移除独立目录内的 CLI 包；已有服务端凭证仍需在账户页面撤销。

npm uninstall --prefix ./brainbrawn-cli-local --ignore-scripts --no-audit --no-fund @brainbrawn/cli

配置保护与后续接入

本地包版本与摘要已可核对。三客户端受验版本、安装范围、配置合并与卸载指引仍待验收；不自动覆盖已有 MCP 或 Skill 配置。

远程 MCP/OAuth 属于后续增强。传入远程 workdir 不代表允许读取或上传你的电脑文件。

02 / 当前交付范围

账户与项目已联调本地 CLI可下载云端发布待开放

已接入能力与待开放范围

当前以本地联调为主。账户、项目与三步发布模型已接入；源码接收、构建与真实云端发布以连接服务的实际能力为准。

真实邮件、付费购买和原生客户端组合尚未完成验收；本地测试通过不代表真实云端已开放。

打开 Console →

03 / 目标部署流程

选择项目
查看预览
正式发布

Agent 与 Console 的协作方式

官网可独立选择项目、查看预览并确认发布；Agent 和 CLI 使用同一套操作与权限。构建与版本细节按需查看。

六个 MCP 工具的当前范围

目录检查静态检查

bb_app_inspect

已有引用仅核对，不创建

bb_app_create

操作状态原操作与发布进度

bb_deployment_status

预览部署提交代码，官网确认

bb_deploy_preview

构建日志服务待接入

bb_build_logs

生产发布官网确认入口

bb_publish

工具入口和实际执行能力分别核对；服务端未开放时明确返回不可用。元数据或任务受理成功不代表已上线。

04 / 账户与授权

同一账户，按授权范围访问。

账户、凭证与项目权限

Console、CLI 和 MCP 使用同一账户与资源归属。切换租户、退出或会话失效时清除旧页面数据；应用域不接收平台管理 Cookie。

本地 CLI 只读取明确获授权的项目范围。平台凭证保存在本地受限文件，不进入 Skill、源码、配置示例或日志。

05 / 正式发布确认

Preview 与 Production 分别授权。

在控制台核对预览版本与影响，再确认正式发布；以服务端结果为准。

生产批准的范围与有效期

Preview Token 不包含生产发布、增加预算或付款权限。生产批准绑定 App、环境、产物、配置与迁移摘要、预算上限及有效期。

已有明确批准且范围不变时复用；目标或影响越界时重新授权。Agent 的 confirmed=true、工具文字或模型自述不能代替批准。

06 / 源码与构建

固定源码，核对每次构建结果。

源码保护、重试与取消规则

上传前展示源码范围，排除 .env、密钥、node_modules、缓存与 .git 内部文件。构建引用固定快照或 Commit，不把变化中的分支头当作确定版本。

任务受理不等于成功；超时或断开先核对原操作，不重复启动。关闭 Agent 或页面只停止本地等待，不代表远端任务已取消。

07 / 支持范围

面向受支持的 JS/TS Web 与 PWA 项目。

运行时、数据库与兼容边界

范围	目标与边界
Static / PWA	HTML、CSS、JavaScript 与受支持的前端构建产物；离线行为需单独验证。
Dynamic	受适配的 JavaScript / TypeScript Fetch handler；首个目标组合为 React、Vite 与 Hono。
d1 / none	D1 或无数据库。Preview 与 Production 的数据、Secrets 和访问分别绑定。

不是通用 Node.js 主机，不承诺任意 Python、Go、OCI 镜像或持久文件系统。检查结果须区分支持、需适配与未知；升级套餐不能解决 Runtime 不兼容。

08 / 数据保护与退出

发布、数据与退出分别管理。

备份、回滚与迁出规则

发布回滚不自动还原数据；Schema 不兼容时阻止回滚。SQLite 到 D1 的代码适配不隐式导入本地数据或写生产库。