本地优先与 BYOK
这篇文档解决什么问题
说明 Think Matrix 作为本地优先的多模型AI工作台，如何存放你的 API Key 和对话，以及「本地优先」「BYOK」对你意味着什么。
适合谁读
- 关心数据隐私与 Key 安全的用户
- 在对比 Cloud Sync、Premium 备份前需要理解差异的用户
核心概念
本地优先
- 对话、历史列表、分组、提问记录 默认保存在本机浏览器（IndexedDB）
- 平台默认不托管你的聊天正文
- 换浏览器、清缓存、重装系统可能导致本机记录丢失 — 请用 Pro 导出或 Premium 备份
BYOK（Bring Your Own Key）
- 你自备各模型厂商的 API Key
- 聊天请求由浏览器直连厂商 API（BYOK）
- 模型调用费用由你直接向 DeepSeek、通义、智谱等服务商支付
- Think Matrix 订阅/买断的是客户端能力（多列对比、汇总、导出、备份等），不含模型额度
数据存在哪里？
| 数据 | 默认位置 | 说明 |
|---|---|---|
| 对话与消息 | 本机 | 本地优先主路径 |
| API Key | 本机 | 默认不上传服务端 |
| 账户、订阅、许可证 | 服务端 | 登录与权益校验 |
| 模型目录 | 服务端下发 | 全站统一的模型列表 |
| 侧栏显示哪些模型 | 本机 | 你的个人偏好 |
| 用户反馈 | 服务端 | 登录后提交，管理端保留 |
API Key 会上传吗？
默认不会。 Key 保存在本机。
可选能力： 若你主动开启 Cloud Sync 并勾选同步 API Key 类别，才会按云同步规则加密处理。默认构建下不向服务端上传 Key 密文（服务端 Key 上传需单独 feature flag，默认关闭）。
对话会默认上云吗？
不会。 云同步是独立付费能力（Cloud Sync），需你在设置中主动开启后才会同步所选类别到多设备。
Cloud Sync 不等于 Premium 的 .tmbackup 或 Markdown zip — 前者是自动多设备同步，后者是你手动导出/导入的文件。
常见误解
| 误解 | 事实 |
|---|---|
| 买了 Premium 就有 Cloud Sync | Premium 是本地整库备份；Cloud Sync 另购（Founder 赠 12 个月除外） |
| 订阅含模型费 | 不含；Key 自管，费用直付服务商 |
| 平台能看我的聊天记录 | 默认不能；对话在本机，除非你开启云同步上传快照 |
当前版本边界
- 无对话内容公开分享页；分享指分享官网链接
- 自定义指令可经设置 API 同步，但设置 UI 暂无独立编辑入口（实现细节，不影响本地优先承诺）