首次配置

旗鱼不内置 AI 大模型——你需要配置一个 AI 服务的 API，就像给手机装上 SIM 卡才能打电话一样。

别担心，基础模型配置通常只需要几分钟；网页搜索可以接着配置，也可以稍后补上。

什么是 API Key

API Key 是 AI 服务商提供给你的一串密钥，用来验证你的身份。你可以把它理解为一张「AI 会员卡」——有了它，旗鱼就能调用 AI 服务来思考和回答问题。

大多数 AI 服务按使用量计费（类似手机话费），实际费用取决于使用频率。建议在服务商后台关注余额或设置预算提醒。

推荐方案：DeepSeek

如果你是第一次接触 AI API，推荐从 DeepSeek 开始：

• 国产服务，注册简单，无需翻墙
• 价格极低（约 1 元 / 百万 tokens）
• 综合能力好，适合绝大多数日常任务

旗鱼支持几十种 AI 服务商（OpenAI、Claude、通义千问、Gemini 等），你可以随时切换或同时配置多个。这里以 DeepSeek 为例演示，其他服务商的流程类似。

第一步：注册 DeepSeek 并获取 API Key

1. 打开 DeepSeek 开放平台
2. 点击右上角「注册」，用手机号完成注册
3. 登录后，进入控制台
4. 在左侧菜单点击「API Keys」
5. 点击「创建 API Key」，起一个名字（比如「旗鱼」）
6. 复制生成的 API Key — 这串以 sk- 开头的文字就是你的密钥

请妥善保管 API Key，不要分享给他人。如果不小心泄露了，可以在 DeepSeek 控制台删除旧的并重新创建。

7. 新注册用户可能有免费额度。如果余额不足，按控制台提示充值即可

第二步：在旗鱼中配置

1. 打开旗鱼应用
2. 点击左下角的 ⚙️ 设置 图标（齿轮形状）
3. 在设置页面找到 「AI 模型配置」 区域
4. 点击 「新增」 按钮
5. 在服务商列表中选择 「DeepSeek」 — 系统会自动填入 API 地址和默认模型
6. 在 API Key 输入框中，粘贴你刚才复制的 API Key
7. 模型选择 deepseek-v4-flash-vision-exp（默认已选好，能看图）
8. 点击 「保存」

第三步：设为当前使用

保存后，你会在模型列表中看到刚才创建的配置。点击它右侧的 「使用」 按钮（或勾选图标），将它设为当前正在使用的模型。

设置完成！旗鱼现在已经可以思考了。

推荐搭配：启用网页搜索（博查，强烈推荐）

配置搜索引擎后，Agent 可以实时搜索网络信息，不再局限于模型的训练数据。博查是专为 AI 场景设计的国内搜索服务，无需翻墙、延迟低。

获取博查 API Key

1. 打开 博查开放平台
2. 注册并登录（支持手机号）
3. 进入控制台创建 API Key 并复制
4. 新注册用户可能有免费额度；实际消耗取决于查询次数

在旗鱼中配置博查

1. 打开 设置 → 网页搜索
2. 搜索引擎选择 「Bocha（博查）」
3. 粘贴 API Key
4. 保存

配置完成后，AI 在需要查询实时信息时会自动调用博查搜索。

验证模型配置是否成功

回到主界面，在对话框中输入一句话试试，比如：

你好，请做一下自我介绍

如果 AI 能正常回复，说明配置成功了。

如果没有回复或报错：

• 检查 API Key 是否复制完整（以 sk- 开头）
• 检查 DeepSeek 账户余额是否充足
• 如果你在公司网络内，可能需要配置代理（见下方「网络代理」章节）

其他常用服务商

除了 DeepSeek，以下是其他常用的 AI 服务商，都可以在旗鱼中一键配置：

你可以配置多个模型，日常用便宜的（DeepSeek），复杂任务切换到强力模型（Claude Opus 5、GPT-5.6），在旗鱼顶部的模型选择器中一键切换。

本地部署（Ollama）

如果你想完全免费、不联网使用 AI，可以用 Ollama 在本地运行模型：

1. 前往 ollama.com 下载并安装 Ollama
2. 在终端中运行 ollama run qwen3.5:9b 下载并启动一个模型
3. 在旗鱼中新增 AI 配置，选择「Ollama」模板
4. API Key 留空，模型填 qwen3.5:9b
5. 保存并设为当前使用

本地模型的效果取决于你的电脑配置。建议至少 16GB 内存。GPU 加速能显著提升体验。

网络代理

如果你需要通过代理访问海外 AI 服务（如 OpenAI、Claude），可以在 AI 配置中单独设置代理：

1. 编辑对应的 AI 配置
2. 在「代理」字段填入代理地址，例如 http://127.0.0.1:7890
3. 保存即可

代理设置是按配置独立的——你可以让 DeepSeek 直连、OpenAI 走代理，互不影响。

下一步

配置完成！接下来 认识界面，熟悉旗鱼的各个功能区域。