architecture.data-model
当前材料不足以确认 OneDocs 的代码级数据模型。本页区分已提供资料中出现的模型配置概念与尚未得到仓库源码验证的实体、关系和持久化实现，避免把用户指南中的字段误当作数据库结构。
Purpose and Scope
本页的目标是记录模型配置相关的数据形态及其证据边界，而不是复述模型选择或操作教程。提供的资料是一份《模型配置》用户指南摘录；没有仓库路径、源码、迁移文件、运行时文件引用基址或可读取的实体定义。因此无法完成通常意义上的架构数据模型参考，包括表结构、主外键、序列化格式及跨服务的数据流。
关于供应商选择、API Key 填写、模型推荐及本地运行地址，请参阅《模型配置》和《本地模型部署》；这些用户操作不等同于已验证的内部数据模型。
Overview
所提供的《模型配置》资料提到：用户从供应商列表选择供应商，填写 API Key，可选填 Base URL，并选择具体模型；还描述了输入模型名称并添加自定义模型的操作。资料称保存后配置会持久化到本地，但未给出存储位置、存储格式或实现代码。以下仅将这些内容视为界面及文档层面的字段描述，不推导实体或数据库列。
Architecture
实现细节未在所提供的源码中找到。 无法验证任何类、模块、服务、存储组件及其调用关系，因此不绘制可能被误读为真实代码架构的 Mermaid 组件图。要建立架构图，须先取得仓库源码，并核对配置界面、状态管理、模型调用适配器以及实际持久化代码。
已知配置数据的边界
| 文档层面的项目 | 资料中描述的用途 | 不能据此推断的内容 |
|---|---|---|
| 供应商 | 从供应商列表选择 | 是否存在供应商实体、枚举或独立存储表 |
| API Key | 填写供应商提供的密钥；资料将其标为必填 | 实际验证规则、加密方式、存储位置，或免费供应商是否也要求密钥 |
| Base URL | 资料将其标为非必填，并称默认使用官方地址 | 默认值的具体来源、覆盖优先级及 URL 校验规则 |
| 模型 | 选择具体模型 | 内部模型 ID、与供应商的关联键或配置版本 |
| 自定义模型名称 | 用户在自定义模型区域输入名称 | 是否保存为独立记录、是否去重及如何与 API 请求映射 |
特别需要注意：同一摘录称 OneDocs 内置免费模型无需 API Key，却又在通用配置步骤中将 API Key 标为必填。现有资料没有说明两者的条件关系，不能将该表格直接转写成全局数据约束。
Core Flow
资料仅能支持用户可见的顺序：进入设置中的模型页面，选择供应商，填写配置，然后点击保存；自定义模型另有输入名称和添加操作。无法确认保存按钮对应的函数、校验顺序、失败处理、写入时机、重新加载行为，以及模型调用如何读取这些值。由于没有经过源码验证的组件和箭头，本页不提供伪造的时序图。
Data Model / Persistence
摘录声称配置保存后会在本地持久化，但没有指出是浏览器存储、桌面应用配置文件还是数据库，也未提供模式定义。API Key 是否以明文保存、是否与其他配置共用记录、如何迁移或删除数据，均未知。自定义模型是否随供应商配置一起保存亦未证实。在取得实现文件之前，不能给出 ER 图、字段类型、默认值或一致性保证。
Usage Examples
No code example available. 所提供材料不是仓库源码，无法提取并以真实文件路径和行号归属的代码片段；本页不会生成示例配置、调用代码或虚构来源链接。
Configuration Options
以下是所提供用户指南的表述，不是经过实现代码确认的配置项默认值：
| 项目 | 资料中的必填性 | 资料中的默认行为 | 源码核验状态 |
|---|---|---|---|
| API Key | 标为必填 | 未说明；内置免费模型另称无需 API Key | 未核验 |
| Base URL | 标为可选 | 称默认使用官方地址，未列出每个供应商的值 | 未核验 |
| 模型 | 标为必填 | 未说明 | 未核验 |
| 自定义模型名称 | 添加自定义模型时输入 | 未说明 | 未核验 |
资料还给出了 Ollama 和 LM Studio 的用户指南层面默认地址，分别为 http://localhost:11434/v1 与 http://localhost:1234/v1。无法确定它们是否也是程序代码中的默认值。
API Reference
Implementation details not found in source. 没有可核验的接口、方法签名、参数类型、返回值或异常定义，因此不提供 API 签名或端点清单。
Professional Notes
失败、边界和安全
摘录建议在 API Key 无效时检查复制内容、供应商和额度，也提及免费模型可能暂时不可用；这属于用户建议，并非已验证的错误类型、重试策略或错误映射。密钥保存及传输路径未知，不能据此作出安全保证。对并发更新、覆盖策略、缓存失效、离线场景和损坏配置的恢复方式，现有资料同样没有实现证据。
待核验事项
若要把本页升级为源码级架构文档，需要读取实际配置界面及其状态定义、供应商与模型定义、保存和加载实现、存储模式或迁移，以及覆盖这些流程的测试；再核对字段条件约束、默认值、敏感信息处理和调用链。未获得这些证据前，不应将上面的用户指南描述解释为内部模型契约。
Related Links
- 《模型配置》：当前提供的用户指南摘录；未提供可引用的仓库文件路径或正式页面地址。
- 《本地模型部署》：摘录中提及的相关指南；未提供可核验的页面地址。