@visiblebase/manager

@visiblebase/manager 是 VisibleBase 的交互式终端代理。

它把管理侧和用户侧的常见操作收口到一个 visiblebase 命令里，适合本地调试、初始化 Base、管理多个 server、查看模型以及直接体验产品侧调用。

安装

npm i -g @visiblebase/manager

如果你正在这个仓库里开发 manager，可以直接执行：

npm run build:manager

这个命令会先构建本地 packages/manager，再自动把它重新安装到你机器的全局环境里；构建成功后，visiblebase 命令会立即切到这次本地构建的版本。

使用

visiblebase

启动后会先显示当前 CLI 版本，然后进入交互式终端界面。你可以：

• 没有 server 时先添加 server
• 统一通过 Manage Servers 管理多个 Base server
• 以 Admin 身份管理 env、models、products、accounts、usage、payment
• 以 User 身份登录并直接体验 chat、models、service 调用
• 直接创建 Stripe 充值并在浏览器里完成支付

添加 server 时需要填写：

• base_url
• admin_secret_key

添加成功后，这个 server 会自动成为当前 active server。

更新

如果你已经全局安装了 visiblebase，后续可以直接执行：

visiblebase update

在 visiblebase 仓库里运行时，它会优先使用当前 workspace 重新构建并刷新全局安装；普通环境下则会更新到 npm 上的最新版本。

如果 Base 启用了 payment.stripe，manager 会显示它暴露出来的 env requirements。常见的 Stripe 配置包括：

• STRIPE_SECRET_KEY
• STRIPE_WEBHOOK_SECRET

如果没有单独配置 STRIPE_SUCCESS_URL / STRIPE_CANCEL_URL，Stripe 服务会优先基于 VISIBLEBASE_BASE_URL，再回退到当前请求 origin 自动生成默认 success / cancel 页面。

在 Admin -> Payment 里，manager 也会直接显示当前 server 对应的 Stripe webhook endpoint， 你可以把它原样复制到 Stripe Dashboard：

• {base_url}/v1/payment.stripe/webhook

依赖关系

• @visiblebase/manager 负责终端里的交互入口
• @visiblebase/client 负责真正的 SDK 调用边界

文档

• 仓库首页：visiblebase
• 文档目录：homepage/content/docs