快速开始
快速开始
部署一个可复用的 Base，让新 AI 产品直接接入。
这一组文档只做一件事：让你在最短时间里跑通一条完整调用链。
你会得到的不是“一个 demo 页面”，而是一个已经具备产品边界的最小系统：
- 一个可复用的 Base
- 一条模型记录
- 一个
product_id - 一个可给终端用户使用的
user_token - 一个能成功调到 Base 的
UserClient
你不需要为每个新产品单独创建后端。新项目完全可以先只写 client，再接入已经部署好的 Base。
你最终会得到什么
完成这组步骤后，你会得到一套稳定调用链：
产品前端 / 插件 / App你的产品只拿
product_id + user_token，先把体验做出来。UserClient读取
models()，再调用 text()、stream()、image() 等 service。VisibleBase Base校验 token，读取模型目录，再通过
default() + match() 决定真实调用方式。真实 providerOpenAI、Claude、Gemini、私有模型或内部 AI Gateway。
推荐路径
- 现在怎么用：先用
products/server和products/client跑通一条完整链路 - 创建 Base：创建 Base，并在启动服务时自动初始化默认数据库
- 添加模型：把模型作为数据库数据写入
- 签发 user_token：给产品用户一个调用凭证
- 连接 client：在产品侧用
UserClient调 Base
你应该按哪条线走
只想先体验一次完整调用
从模板开始最快。你可以先确认 Base、product、token 和 UserClient 的链路都通了，再回过头看细节。
准备从自己的项目开始直接从 new Base() 开始，把数据库、模型、token 和 client 接到你自己的仓库里。
这条 quickstart 默认假设
- Base 默认数据库在
./.base/visiblebase.sqlite - model 来自数据库，不在运行时代码里注册
- 所有 product 当前默认共享同一套 active models
- service 的默认 query fallback 由代码里的
default()决定