AI 配置与故障排查

应用本身不附带密钥，也不代管账号；用的是你自己的供应商与密钥。

添加供应商

1. 打开 设置 → 模型与供应商。
2. 点「添加供应商」，填名称与类型：OpenAI 兼容、Anthropic 兼容，或「其他」手动配置。
3. 填 Base URL 与密钥；密钥用 Windows DPAPI 加密后保存，界面只显示末 4 位。
4. 添加模型 ID 与显示名，选一个默认模型；需要时再配备用链。

免费模型目录

站内 免费模型 页与 /api/free-models.json 只提供可选的接入信息（名称、接口类型、是否需要密钥），不是必填项；目录为空也能完全手动配置。

故障排查

• 提示未配置默认模型：到 设置 → 模型与供应商 选一个默认模型；单个任务也可以单独指定模型。
• 401 / 403：密钥错误或无权限，重新填密钥；注意不要带上多余空格。
• 404：Base URL 路径不对。OpenAI 兼容通常以 /v1 结尾，以供应商文档为准。
• 超时 / 连不上：检查网络、代理与 DNS；断网时写作不受影响。
• 429：触发供应商限流，降低并发或稍后再试。
• 返回内容无法解析：换一个模型或检查该供应商是否兼容所选接口类型。

所有失败都只影响候选生成，正文不会被改动。

隐私

密钥只存本机、用当前 Windows 用户作用域加密；候选请求直接发往你配置的供应商，不经过本站。详见隐私与数据。