AI API 配置与智能接入

1. 模块目标

AI API 配置页对应 tab_welcome.py 中的 AIConfigPanel。它的作用不是直接执行空间分析，而是为后续智能能力统一提供模型平台接入层。

当前职责包括：

  • 保存不同提供商的 API Key、Base URL、模型名称和可选 Endpoint ID。
  • 设置默认平台。
  • 支持解绑、切换和状态反馈。
  • 将配置写入统一配置文件，供后续 AI 助手、报告解释、自动化分析与文档辅助能力调用。

2. 当前支持的界面结构

2.1 ProviderCard

ProviderCard 是平台提供商选择卡片。它负责：

  • 展示平台名称与摘要描述。
  • 响应点击事件。
  • 根据当前选择状态切换边框和背景样式。

2.2 AIConfigPanel

AIConfigPanel 是实际的配置表单容器，核心状态包括：

  • selected_provider：当前选中的平台 key。
  • provider_cards：卡片实例映射。
  • default_provider_combo：默认平台下拉框。
  • api_input：API Key 输入框。
  • base_url_input：Base URL 输入框。
  • model_input：模型名称输入框。
  • endpoint_input：需要接入点 ID 时使用。

3. 参数语义

参数 含义 典型用途
API Key 身份认证密钥 调用模型服务
Base URL 提供商接口根地址 对接代理层、私有网关或平台 API
模型名称 具体模型 ID 控制推理模型选择
Endpoint ID 平台接入点标识 适用于火山方舟等需要 endpoint 的平台
默认平台 系统默认模型源 供后续模块自动读取

4. 配置流程

  1. 在卡片区选择目标平台。
  2. 填写 API Key。
  3. 视平台情况填写 Base URL、模型名称和 Endpoint ID。
  4. 可选设置默认平台。
  5. 点击保存。

如果平台要求 Endpoint ID 但未填写，保存时会被拒绝。

5. 代码接口

文档页不直接操作配置文件，而是通过下列接口完成：

  • load_ai_config()
  • get_provider_config(provider)
  • bind_provider(...)
  • unbind_provider(provider)
  • set_default_provider(provider)

这些接口使 UI 与配置持久化解耦，便于后续扩展更多平台或切换存储策略。

6. 当前意义

当前版本中，AI API 页主要发挥两类作用：

  • 为平台未来的 AI 报告解释、参数建议、自动化分析预留接入。
  • 提供统一的多平台配置位置，避免用户在不同模块里重复填写。

因此，它属于系统基础设施页，而不是单独的分析模块。