首次设置与模型配置

是什么

首次设置与模型配置是知文AI 能开工的前提。首次启动应用会进入「首次设置」引导——只要引导没完成，每次启动都会回到引导页。引导带你依次完成五件事：授权激活 → 文本模型 → Embedding → 默认身份 → 资料整理。

核心是两组模型配置：大语言模型（写公文、做 PPT、速办对话全靠它）和 Embedding（知识库与记忆检索的前提）。引导里跳过、或之后想改，都可以在「设置 → 模型与检索」里随时配置——引导页与设置页用的是同一组配置。

怎么用

1. 跟随首次设置引导

   首次启动自动进入引导页，左侧五步导航可自由跳转，右上角有「暂不设置，进入工作台」。注意：跳过只是把步骤标记为「已跳过」，没激活/没验证的事实状态仍在——进工作台后 AI 功能依旧不可用。

   

2. 添加大语言模型端点，五种模式怎么选

   打开「设置 → 模型与检索」，在「大语言模型」卡片的「API 格式」下拉里选一种模式：

   填 URL + Key 的三种（接 API 服务）：OpenAI Chat（chat_completions）／OpenAI Responses（/v1/responses）／Anthropic Messages（/v1/messages）——都要填 Base URL + API Key + 模型名，适用于自购 API 额度或单位网关。

   免 URL/Key 的两种（用已有订阅）：Claude 订阅——依赖本机终端已运行 claude 完成登录；ChatGPT 订阅——点「使用 ChatGPT 登录」走浏览器授权。选择后 Base URL / API Key 两行自动隐藏。

   

   

3. 选默认模型、保存并做真实验证

   点「获取列表」从端点拉取模型清单，点选回填默认模型；再点「保存并设为默认」。保存和「测试连通」都不代表模型能真实生成——最后务必点「真实验证已保存模型」，发起一次最小真实生成，验证徽章变绿才算配好。

   

4. 配置 Embedding（知识库与记忆的前提）

   在「Embedding」卡片填 Base URL / API Key / 模型 / 向量维度四项，点「保存 Embedding」，同样可做真实验证。不配 Embedding，知识库无法入库、速办回答不会带来源引用。

   

5. 可选：配置视觉模型

   「视觉模型」卡片默认「跟随大语言模型」，一般无需改动。需要单独的识图模型时选「自定义」（仅支持 OpenAI Chat 与 Anthropic Messages 两种格式）；用不上可选「关闭」。视觉模型用于 PPT 的「AI识图」和 PDF 模板风格提取。

   

使用技巧

• 已有 Claude / ChatGPT 账号就用订阅模式。不用再买 API 额度，选对应订阅格式、完成本机登录即可，Base URL 和 Key 都不用填。
• 切换 API 格式会清空模型列表缓存。这是故意的——防止把 A 端点的模型名单错配到 B 端点。换格式后重新点「获取列表」即可。
• 改配置即时生效。模型设置保存后按会话热读取，不用重启应用；多端点时在列表上点「设为默认」随时切换。