自建站点模型同步 (Model Sync)
针对自建管理面板（New API, AxonHub, Octopus 等）站长的自动化工具。能够自动从上游供应商拉取最新模型列表并更新到你的渠道配置中，确保同步无忧。
功能概述
- 🔄 跨平台自动同步：支持 New API、AxonHub、Octopus 等多种系统，按设定间隔自动执行同步。
- 🎯 灵活同步策略：支持全部同步、手动选择渠道同步、或仅针对上次失败的任务进行重试。
- ⚡ 智能限流保护：内置限流算法，在批量同步几十个甚至上百个渠道时，避免因请求过快被上游站点判定为攻击。
- 📊 实时进度监控：同步过程中可实时查看每个渠道的同步状态、HTTP 状态码及耗时。
- 📜 详尽历史记录：保留每次同步的结果，对比同步前后的模型列表变化，便于追溯。
支持的系统类型
| 系统类型 | 同步逻辑 |
|---|---|
| New API / DoneHub / Veloera | 调用 /api/channel/fetch_models (GET) 获取上游，再更新渠道配置。 |
| Octopus | 调用 /api/v1/channel/fetch-model (POST) 获取上游模型。 |
| AxonHub | 通过 AxonHub 管理接口自动读取并同步渠道关联的模型列表。 |
前置要求
在开始同步前，你需要在 基础设置 -> 自建站点管理 中完成对应系统的连接配置（Base URL、Admin Token 或 账号密码）。
提示
配置完成后，在设置页面选择 “模型列表同步” 即可进入任务管理界面。
核心操作流程
1. 手动执行任务
在“模型同步”页面，你可以：
- 执行全部：扫描所有已启用的渠道并触发同步。
- 执行所选：在表格中勾选特定的渠道进行局部更新。
- 仅重试失败项：针对上次网络波动导致失败的渠道进行快速修补。
2. 查看执行结果
同步表格会展示以下关键字段：
- 状态：成功、失败或进行中。
- 旧模型列表：同步前渠道已有的模型。
- 新模型列表：从上游接口实时获取到的模型。
- 错误信息：如果失败，会展示具体的错误码（如 401, 429, 500）和原因。
3. 配置自动化选项
在 设置 -> 模型列表同步 面板中，你可以自定义同步行为：
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| 执行间隔 | 6 - 12 小时 | 自动同步的时间频率，不建议设置得过于频繁。 |
| 并发数量 | 1 - 3 | 同时进行的同步任务数。渠道多时建议保持在 2 以内。 |
| 速率限制 (RPM) | 20 | 每分钟允许的最大请求数，用于保护上游站点。 |
| 最大重试次数 | 3 | 任务失败后的自动重试次数。 |
常见问题
| 问题 | 解决方案 |
|---|---|
| 同步后模型列表没有变化 | 请检查上游站点是否真的更新了模型，或者该渠道的 API Key 是否有权限读取模型列表。 |
| 频繁出现 429 错误 | 请降低“每分钟请求数”或增加“执行间隔”。 |
| 无法获取 AxonHub 的模型 | 请确认 AxonHub 的管理员账号拥有足够的权限，且 Base URL 填写正确。 |
| 同步导致部分模型丢失 | 默认情况下，同步会覆盖现有的模型列表。如果你有自定义模型（非上游返回），请在同步后手动补录或使用白名单策略（Beta）。 |