摘要

模型配置从全局设置中读取；未显式配置时，部分 provider 默认启用。复合 id 使用 providerId|modelId 形式，解析函数在 modelSettings.js 中集中维护。

关键词

modelSettings;provider;localStorage

扩展阅读与维护提示

本篇围绕「模型配置存储与默认启用策略」组织材料。仓库内与主题最直接相关的检索词包括：modelSettings、provider、localStorage。建议在阅读正文所列片段后，用 IDE 全局搜索这些符号，沿 import 与调用栈向上追问「谁在什么时机调用」，而不是只记住单文件路径。

摘要所概括的要点为：模型配置从全局设置中读取；未显式配置时，部分 provider 默认启用。复合 id 使用 providerId|modelId 形式，解析函数在 modelSettings.js 中集中维护。落地到排障时，可把现象粗分为三类交叉验证：配置是否按预期写入持久化介质；WPS COM 上下文是否可用（例如是否缺少 ActiveDocument）；以及网络与证书策略是否拦截了 fetch。本篇涉及的模块通常只覆盖其中一两类，需要与相邻篇目拼成完整拼图。

教程文件名「05-shezhi-moxing-yu-gongyingshang-lianlu.md」仅用于导航与排序，不等价于源码模块名。若正文中的行号与本地分支不一致，多半因合并导致行偏移，此时应以函数名、导出名为锚重新检索；团队若维护了生成脚本，可在变更大段源码后重新运行以保持摘录大致对齐。

本文刻意避免对产品能力做营销式承诺：所述行为均以当前仓库可见实现为准。若组织策略要求离线或内网模型，应在网关、证书与代理层收口，而不是假设加载项能绕过浏览器安全模型。

若你同时阅读 docs/chayuan-llm-chain-series，可先对照其中的总体链路图理解「请求从 UI 到 chatApi」的次序，再回到本教程看数据结构、默认值与修改风险面；两者互补，不重复堆砌功能列表。

正文

1. 读取与默认值

getModelConfig 合并了 enabled 与 modelSeries 字段，并对 DEFAULT_ENABLED_PROVIDERS 中的 id 应用默认开启逻辑。

阅读源码摘录时，请把它当作「定位入口」而非完整实现：同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前，建议用最小文档手工走一遍相关助手或对话框，并观察任务清单与日志中的字段是否与预期一致，再决定是否做数据迁移或配置重置。

// src/utils/modelSettings.js 第14-55行
// 默认在察元AI助理中开启的模型（ChatGPT、Ollama、千问、DeepSeek、百度云千帆）
const DEFAULT_ENABLED_PROVIDERS = ['OPENAI', 'OLLAMA', 'DEEPSEEK', 'baidu-qianfan', 'aliyun-bailian']

/**
 * 获取所有模型配置
 */
export function getAllModelConfigs() {
  const settings = loadGlobalSettings()
  return settings[STORAGE_KEY] || {}
}

/**
 * 获取指定模型的配置
 * @param {string} modelId - 模型ID
 * @returns {object} 模型配置对象
 */
export function getModelConfig(modelId) {
  const configs = getAllModelConfigs()
  const raw = configs[modelId]
  const defaultEnabled = DEFAULT_ENABLED_PROVIDERS.includes(
    String(modelId || '').trim()
  ) || DEFAULT_ENABLED_PROVIDERS.includes(
    String(modelId || '').trim().toLowerCase()
  )
  if (raw) {
    const modelSeries = raw.modelSeries || raw.models || []
    return {
      apiKey: raw.apiKey || '',
      apiUrl: raw.apiUrl || '',
      enabled: raw.enabled !== undefined ? !!raw.enabled : defaultEnabled,
      modelSeries,
      models: modelSeries
    }
  }
  return {
    apiKey: '',
    apiUrl: '',
    enabled: defaultEnabled,
    modelSeries: [],
    models: []
  }
}

2. 复合 id 解析

parseModelCompositeId 用竖线分隔 provider 与 model，供 chatApi 与任务运行器统一解析。

阅读源码摘录时，请把它当作「定位入口」而非完整实现：同一函数可能在其他分支还有早退条件或 try/catch。修改默认行为前，建议用最小文档手工走一遍相关助手或对话框，并观察任务清单与日志中的字段是否与预期一致，再决定是否做数据迁移或配置重置。

// src/utils/modelSettings.js 第445-454行
/** 解析 compositeId 为 { providerId, modelId } */
export function parseModelCompositeId(compositeId) {
  if (!compositeId || typeof compositeId !== 'string') return null
  const idx = compositeId.indexOf('|')
  if (idx < 0) return null
  return {
    providerId: compositeId.slice(0, idx),
    modelId: compositeId.slice(idx + 1)
  }
}