自建站点模型同步

针对自建管理面板（New API, AxonHub, Octopus 等）站长的自动化工具。能够自动从上游供应商拉取最新模型列表并更新到你的渠道配置中，确保同步无忧。

模型列表同步界面

功能概述

🔄 跨平台自动同步：支持 New API、AxonHub、Octopus 等多种系统，按设定间隔自动执行同步。
🎯 灵活同步策略：支持全部同步、手动选择渠道同步、或仅针对上次失败的任务进行重试。
⚡ 智能限流保护：内置限流算法，在批量同步几十个甚至上百个渠道时，避免因请求过快被上游站点判定为攻击。
📊 实时进度监控：同步过程中可实时查看每个渠道的同步状态、HTTP 状态码及耗时。
📜 详尽历史记录：保留每次同步的结果，对比同步前后的模型列表变化，便于追溯。

支持的系统类型

系统类型	同步逻辑
New API / DoneHub / Veloera	调用 `GET /api/channel/fetch_models` 获取上游，再更新渠道配置。
Octopus	调用 `POST /api/v1/channel/fetch-model` 获取上游模型。
AxonHub	通过 AxonHub 管理接口自动读取并同步渠道关联的模型列表。

前置要求

在开始同步前，你需要在 基础设置 -> 自建站点管理 中完成对应系统的连接配置（Base URL、管理员令牌 Admin Token 或账号密码）。

提示

配置完成后，在设置页面选择 “模型列表同步” 即可进入任务管理界面。

核心操作流程

1. 手动执行任务

在“模型同步”页面，你可以：

执行全部：同步当前管理站点中的渠道，并跳过已开启跳过设置的渠道；手动点击此按钮也会遵守跳过设置。
执行所选：同步所有勾选的渠道，包括已设置跳过的渠道。全选后点击此按钮也一样，不会改变已保存的跳过设置。
仅重试失败项：针对上次网络波动导致失败的渠道进行快速修补。

如果某个渠道无法获取模型列表，或你希望保留它现有的模型，可在执行历史或手动执行列表中开启“跳过自动同步和‘执行全部’”。修改后立即保存，并显示保存中、成功或失败提示。自动同步和“执行全部”将不再获取或更新它的模型，执行历史会记录该渠道及跳过原因。跳过数单独统计，不计入已执行数、成功数或失败数。

也可以在渠道管理的“编辑规则”弹窗中调整同一个开关，可视化和 JSON 模式均可使用。弹窗中的修改随规则一起保存；点击“取消”不会生效。

跳过设置只对当前管理站点的这个渠道生效，其他站点不受影响，也会随渠道配置一起备份。如需临时同步，可使用“执行所选”或“同步此渠道”，无需先关闭跳过设置。

执行历史中的“已跳过”显示当次跳过的渠道；手动执行列表中的“仅看设置为跳过的渠道”显示当前设置。修改开关不会改变过去的执行结果。运行进度、页面完成提示和自动任务通知都会显示跳过数。如果全部渠道都被跳过，会明确提示“全部跳过，未获取或更新模型”，并保留每个渠道的记录；“仅重试失败项”不会执行这些跳过的渠道。

2. 查看执行结果

同步表格会展示以下关键字段：

状态：成功、失败或已跳过；跳过的渠道会显示原因。
旧模型列表：同步前渠道已有的模型。
新模型列表：从上游接口实时获取到的模型。
错误信息：如果失败，会展示具体的错误码（如 401, 429, 500）和原因。

3. 配置自动化选项

在 设置 -> 模型列表同步 面板中，你可以自定义同步行为：

配置项	推荐值	说明
执行间隔	6 - 12 小时	自动同步的时间频率，不建议设置得过于频繁。
并发数量	1 - 3	同时进行的同步任务数。渠道多时建议保持在 2 以内。
每分钟请求数（RPM）	20	每分钟允许的最大请求数，用于保护上游站点。
最大重试次数	3	任务失败后的自动重试次数。

常见问题

问题	解决方案
同步后模型列表没有变化	请检查上游站点是否真的更新了模型，或者该渠道的 API Key 是否有权限读取模型列表。
频繁出现 429 错误	请降低“每分钟请求数”或增加“执行间隔”。
无法获取 AxonHub 的模型	请确认 AxonHub 的管理员账号拥有足够的权限，且 Base URL 填写正确。
同步导致部分模型丢失	默认情况下，同步会覆盖现有的模型列表。如果你有自定义模型（非上游返回），请在同步后手动补录或使用白名单策略（测试版）。