配置 AI 接口

1. 以自部署管理员登录，在设置中打开 AI 服务配置。
2. 选择协议：OpenAI 兼容、Anthropic 或 OpenAI Responses；填写供应商 Base URL、密钥与模型。
3. 可先获取模型列表；获取失败仍可手填模型。若使用合法内网模型，先保存精确主机或主机加端口允许列表，不支持通配符。
4. 点测试。测试会发出真实的最小模型请求，可能产生少量费用，不替换当前配置。
5. 测试成功后保存。修改任何字段、超过 10 分钟、重启服务或一次保存尝试后，都需重新测试。

完整的 AI_API_BASE_URL 与 AI_API_KEY 环境变量优先于界面设置，此时界面只读。普通成员只看是否配置，不能读写实例密钥。更换 Base URL 时须重新提供 Key。

未配置 AI 仍能导入和编辑 Skill，保留 SKILL.md 的显式元数据，状态为未分析。分析失败不伪造结果，也不覆盖已有资料。

Skill 建立云端作者记录后，服务器会在后台分析，再准备头像；GUI 导入与 CLI/同步建立的作者记录采用同一规则，导入不再等待 AI。APP 关闭也能继续，打开后的列表与详情会自动刷新。只在本机或只有账号同步条目、尚未建立作者记录的 Skill 不在此扫描范围。

默认每 30 秒扫描最多 10 项，串行处理，繁忙时可能需要更多周期。手动编辑过的资料与标签保留；已有分析资料或图片的副本不重新分析或付费绘图。分析临时失败会退避，最多尝试 5 次，之后可使用手动「AI 分析」。额度不足只等待，不消耗失败次数。未配置服务时暂停，管理员补配后会处理积压。

后台分析最多使用实例每日 AI 额度的一半；自部署实例的后台分析不占用作者个人额度。只有头像服务或 AI 并发槽不足时，先按原始资料生成头像，之后补配 AI 会继续分析，不重画。缺少源内容或服务配置时每小时再检查。导入后显示「正在后台分析」表示已安排后台处理；服务器明确标记有待处理任务时，列表每 30 秒刷新，连续 20 次无变化后停止，用户操作或窗口重新聚焦时恢复。

升级时会保守保留旧的未分析资料：与完整版本快照不同，或没有完整快照可比对的资料，不由后台自动覆盖；已有非空标签也会保留。因此部分旧 Skill 可能仍需手动整理。

额度与重新分析

管理员可设置实例与个人每日次数，按 UTC 换日；这是请求次数上限，不是金额上限。设置为 0 禁止消费。测试请求不计入分析次数，供应商仍可能计费。

批量重新分析先预览数量、额度和费用，确认后仅处理可覆盖部分。人工编辑的标签保留；取消不能撤回已发出的付费请求。APP 退出后的批次续接不作保证。

无实例 AI 接口时可考虑 本机 Claude Code。供应商密钥与 Skill 运行用的 个人钥匙 是不同配置。