工具猿

Appearance

词元中心 ​

管理路径： /charitable（底部 Tab 切换：密钥 / 提供商 / 渠道）

词元中心是公益路由系统的统一管理入口，将原本分散的「密钥管理」「提供商管理」「渠道管理」三个页面合并为一个带底部标签切换的单页面应用。

核心功能与服务 ​

1. 密钥管理（Keys 标签） ​

  • 从认证文件同步：将 CPA /auth-files 中的认证文件完整镜像到 cpa_auth_detail。

    • 写入完整 auth_value，auth_info.file_name 必填，source=auth_file_sync。
    • 状态映射：disabled=false -> status=1，disabled=true -> status=0。
    • 按规范化 base_url 匹配提供商，多条命中时取 update_at 最新，其次更大 provider_id。
    • 匹配不到且能解析 base_url 时自动创建提供商；同 base_url 仅创建一次（同步并发用锁去重，导入复用内存列表）。
    • 凭证带显式 base_url 时只按 URL 精确匹配，绝不回落到同类型名称（例如 cli-chat-proxy.grok.com 不会绑到 api.x.ai）；未命中则新建，名称带 host 提示。
    • 同步按文件独立处理：单条 4xx/5xx 记失败并继续，不整批中断；提供商创建失败不阻断密钥写入（可无 provider_id 入库），失败明细展示后端错误码。
    • 大批量默认同串行写入（concurrency=1），SQLite 单连接 + busy 重试，降低 database is locked 导致的 500；失败明细区分硬失败与“已导入未绑提供商”警告。
    • 无显式 base_url 时才用类型名称/别名匹配默认提供商。
    • 同步为手动触发，带进度条；不删除中心多余记录，不联动删除 CPA。
    • 去重：优先 auth_index；缺失时按 auth_info.file_name 回查已有中心记录并复用其 auth_index，避免 token 刷新后重复建行。
    • 已有中心 param / probe_policy / remark 默认保留。

  • 同步请求配置到认证文件：将中心侧提供商/密钥的请求参数字段级写回 CPA /auth-files。

    • 入口命名：
      • “从 CPA 导入认证文件”：认证文件 → cpa_auth_detail
      • “同步请求配置到认证文件”：提供商/密钥参数 → 认证文件
      • “保存并同步请求配置”：编辑单个认证文件账号时使用
    • 已有文件：调用 authFilesApi.patchFields()，只更新 headers / proxy_url / prefix / priority；disabled 单独走 setStatus()。
    • 不存在的文件：才允许用完整 JSON（saveJsonObject）创建；创建底稿可来自 auth_value，但后续同步不再用旧 auth_value 覆盖 Token。
    • Header 合并优先级：认证文件原始 Header → 提供商 Header → 密钥 Header。
    • 管理中心写入的 Header 记录在 auth_info.managed_header_keys；下次同步时删除“上次由中心写入、现已从配置移除”的 Header，并保留文件原本自带的 Header。
    • 同步元数据（非敏感）：managed_header_keys、last_pushed_at、source_modtime（兼容旧字段 source_modified）。
    • 提供商保存成功后不会静默自动同步，而是提示关联认证文件数量，用户可选择“稍后同步”或“同步请求配置”，确认后再批量字段级更新并展示影响账号 / 请求头变更 / 失败明细。

  • 账号/认证文件导入：通过「导入」粘贴或上传 Codex/Xai 等认证 JSON，写入 cpa_auth_detail。

    • 完整 auth_value + auth_info.file_name；默认不自动推送到 CPA。
    • 同名 file_name 走 upsert 覆盖更新，复用已有 auth_index，并保留中心 param / probe_policy / remark。

  • 批量探测抽屉：工具栏「探测全部筛选结果」与多选「批量探测」打开配置弹窗，可设并发度与策略，并滚动显示账号探测进度。

  • 密钥 CRUD：新增、编辑、删除密钥条目。

  • 密钥字段：API Key、协议类型（OpenAI / Anthropic / Gemini / Responses 多选）、状态、优先级、关联提供商、内容备注、自定义参数（JSON）。

  • 批量操作：批量启用 / 禁用 / 删除选中密钥。

  • 密钥显示切换：明文 / 脱敏切换（Eye 图标按钮）。

  • 全参查看：查看密钥的完整合并参数（继承渠道 → 提供商 → 本地）。

  • 悬停预览：鼠标悬停行时弹出 Merged Param 浮层，展示合并后的完整参数 JSON，支持一键复制和推送到 CPA。

  • 发送到 CPA：将当前密钥作为新提供商条目推送到 CPA 的 OpenAI Provider 列表。

2. 提供商管理（Providers 标签） ​

  • 提供商列表：展示提供商 ID、名称、Base URL、协议、状态、优先级、创建时间。
  • 提供商编辑：点击编辑弹出 Sheet 抽屉，配置 API Key、协议类型、状态、优先级、Provider ID、内容、备注和参数。
  • 参数编辑器：可视化的键值对编辑器，支持嵌套结构。
  • 探测（Probe）功能：
    • 每行提供「探测」按钮（CheckCircle 图标）。
    • 探测抽屉中可配置 Proxy URL。
    • 测试密钥可用性：向提供商发送最小化聊天请求，展示 HTTP 状态码。
    • 拉取模型：调用 /v1/models 获取可用模型列表。
    • 模型发现面板：勾选需要加入配置的模型，支持搜索和全选。
    • 模型详细配置：模型别名（alias）、Vision（图片输入）支持、Thinking JSON 配置。
    • 自动测试模型：应用选中的模型后自动逐个发送测试请求，显示各模型的状态码徽章。
    • 保存到提供商：将 Proxy URL 和模型配置写入提供商的 param JSON，该提供商下的所有密钥共享这些配置。

3. 渠道管理（Channels 标签） ​

  • 渠道列表：展示渠道 ID、名称、状态、URL、创建/更新时间。
  • 渠道 CRUD：新增、编辑、删除渠道。
  • 渠道参数：可视化参数编辑器，配置渠道级继承参数。

界面交互与 UI 元素 ​

  • 底部 Tab 栏：三个标签按钮（密钥 / 提供商 / 渠道），当前激活标签高亮显示。
  • 内容面板：根据选中标签切换对应子页面内容，共享同一页面容器。
  • 表格：统一表格组件，支持选择框、分页、状态徽章。
  • Sheet 抽屉：从右侧滑出的编辑表单，带保存/取消底部操作栏。
  • Modal 弹窗：删除确认、全参查看、重复密钥处理等场景。
  • Tooltip 浮层：悬停行时显示合并参数详情（Portal 渲染，跟随鼠标）。

相关文档 ​