理解 VisibleBase
理解 VisibleBase
先建立一个 Base 多个 client 的心智，再去接入真实产品。
概念页不是额外的理论层，而是帮你先把 VisibleBase 的边界看清楚。
如果一开始就把它当成“另一个后端框架”或“对外统一 provider API 的网关”，后面的接入方式、产品拆分和权限边界都会走偏。
先看这张图
多个产品 client网页、插件、App、桌面工具、客户 Demo 都可以是独立产品。
product_id + user_token + UserClient一个长期运行的 Base集中管理模型目录、provider key、service 路由、usage 和 hooks。
你自己的业务系统继续负责用户、订阅、订单、余额和业务数据，不被 Base 接管。
上游模型与网关OpenAI、Claude、Gemini、私有模型，或你自己的 AI Gateway。
推荐阅读顺序
Step 1产品模型
先理解为什么是“一个 Base，多个产品”，以及什么应该留在 Base，什么继续放在产品侧。
Step 2架构总览看清一次请求从 client 到 Base，再到真实 provider 的完整调用链。
Step 3token 模型分清 admin_secret_key 和 user_token 的边界，避免把管理密钥带进前端。
理解哪些能力应该只在可信后端出现，哪些能力可以暴露给终端产品。
Step 5usage 与计费理解 usage、限额、扣费和 hooks 应该如何接到你自己的商业系统里。
什么时候应该先读概念页
- 你准备让多个 AI 产品共用一套底层能力
- 你想知道
product_id、user_token和模型目录各自扮演什么角色 - 你不确定 Base、业务后端、AI Gateway 的边界应该怎么划
如果你现在只想先跑通一条调用链，直接去 快速开始 更合适。