mirror of https://github.com/aiclientproxy/proxycast.git synced 2026-09-24 23:10:56 +08:00

Files

T

coso 267bbf75e3 feat: add documentation system with Docus framework

- Add complete documentation structure with 25+ markdown files
- Add introduction, user guide, provider configs, API reference
- Add troubleshooting and development guides
- Add disclaimer for legal use
- Add GitHub Actions workflow for auto-deploying docs to GitHub Pages
- Bump version to v0.11.0

2025-12-17 13:10:58 +08:00

2.6 KiB

Raw Blame History

title, description, navigation

title

description

navigation

凭证池

管理多个 AI 服务凭证

icon
i-heroicons-key

凭证池

凭证池用于管理多个 AI 服务凭证，支持负载均衡和故障转移。

池管理界面

凭证列表

显示所有已添加的凭证：

字段	说明
名称	凭证标识名称
Provider	凭证类型
状态	有效/过期/错误
优先级	负载均衡优先级
操作	编辑/删除/测试

状态指示

🟢 有效: 凭证可正常使用
🟡 即将过期: Token 即将过期，需要刷新
🔴 已过期: Token 已过期
⚪ 未验证: 尚未验证凭证有效性

添加凭证

自动检测

ProxyCast 会自动检测以下位置的凭证：

~/.kiro/credentials.json          # Kiro Claude
~/.config/gemini-cli/oauth_creds.json  # Gemini CLI
~/.config/qwen/credentials.json   # Qwen

点击 刷新凭证 重新扫描。

从文件加载

点击 添加凭证
选择 从文件加载
选择凭证文件
确认 Provider 类型

手动输入

点击 添加凭证
选择 手动输入
选择 Provider 类型
填写凭证信息：

OAuth 类型 (Kiro/Gemini/Qwen):

Access Token
Refresh Token
过期时间

API Key 类型 (OpenAI/Claude Custom):

API Key
Base URL（可选）

负载均衡配置

策略选择

策略	说明
轮询 (Round Robin)	依次使用每个凭证
优先级 (Priority)	按优先级顺序使用
随机 (Random)	随机选择凭证
最少使用 (Least Used)	优先使用请求数最少的凭证

优先级设置

为每个凭证设置优先级（1-100）：

数值越小优先级越高
相同优先级按策略选择
优先级为 0 表示禁用

健康检查

启用健康检查后：

定期验证凭证有效性
自动跳过失效凭证
凭证恢复后自动重新启用

配置选项：

选项	默认值	说明
检查间隔	60s	健康检查频率
失败阈值	3	连续失败次数后标记为不健康
恢复阈值	1	成功次数后恢复健康状态

凭证操作

测试凭证

点击测试按钮验证凭证：

发送测试请求
显示测试结果
更新凭证状态

刷新 Token

对于 OAuth 凭证：

自动刷新：Token 过期前自动刷新
手动刷新：点击刷新按钮

删除凭证

点击删除按钮
确认删除操作
凭证从池中移除

::alert{type="warning"} 删除凭证不会删除本地凭证文件，只是从 ProxyCast 中移除。 ::

2.6 KiB Raw Blame History

凭证池