Daily Notes AI 配置指南

本指南说明如何在应用中配置 AI 功能，以及如何从各服务商获取 API Key 并填入设置。

---

一、前置条件

• 激活账号：未激活用户仅能使用本地功能。请先在设置页顶部点击「激活」，完成基础会员激活后即可使用「自定义模式」配置 AI。
• Plus 模式：若使用「Plus 模式」（后端统一 AI），需为 Plus 会员，且后端需在 .env 中配置 AI_MODEL 与 AI_VISION_MODEL。

---

二、应用内配置步骤

1. 打开设置
   在应用侧边栏或主导航中进入 设置（路由：/settings）。
2. 选择 AI 服务策略
   
   • Plus 模式：使用后端统一 AI 服务（需 Plus 会员）。
   • 自定义模式：使用本机配置的 AI 服务商（需至少基础会员）。
3. 在自定义模式下选择 AI 服务提供商
   在「AI 服务提供商」中选择其一：阿里云百炼、Google Gemini、智普 AI、豆包 AI。
4. 填写该服务商的配置项
   选择提供商后，下方会展开配置表单，请按需填写：
   • API Key（必填）：从对应服务商控制台获取。
   • Endpoint（可选）：留空则使用该服务商默认端点。
   • 模型名称（可选）：留空则使用默认模型。
   • 视觉模型名称（可选）：用于图片识别，留空则使用默认。
   • 语音模型名称（可选）：用于音频转录，留空则使用默认或未配置。
   保存方式：输入框失焦或修改后会自动持久化，并触发 AI 服务重建。
5. 其他 AI 相关设置
   
   • 图片解析提示词：在「图片解析提示词」折叠项中可编辑，作为 AI 解析图片时的系统提示词，留空则使用内置模板。
   • 上传图片后自动解析：开关控制新上传图片是否自动走 AI 解析。

---

三、各服务商 API Key 获取步骤

1. Google Gemini：如何新建 API 密钥

官方页面（需 Google 账号登录）

• API 密钥管理：https://aistudio.google.com/app/apikey
• 中文说明：https://ai.google.dev/gemini-api/docs/api-key?hl=zh-cn

步骤一：登录并打开 API 密钥页

使用 Google 账号登录 Google AI Studio，在左侧菜单点击 「API 密钥」，进入 API 密钥管理页。

图：Google AI Studio 左侧为 Dashboard / API 密钥 / 项目 等，主区域有「创建 API 密钥」按钮及密钥列表表头。

步骤二：点击「创建 API 密钥」

在页面主区域点击 「创建 API 密钥」 按钮，会弹出创建密钥的对话框。

步骤三：在弹窗中命名并选择项目

在弹窗中完成以下两项后点击 「创建密钥」：

• 为密钥命名：可保留默认「Gemini API Key」或输入自定义名称（如「Daily Notes」）。
• 项目：从下拉框选择要关联的 Google Cloud 项目；若无项目，可先选「创建新项目」或在 Google Cloud 控制台新建后再选。

图：弹窗中包含「为密钥命名」输入框和「项目」下拉框，底部为「取消」「创建密钥」按钮。

步骤四：复制并保存密钥

创建成功后，密钥会仅显示一次，请立即复制并保存到安全处。若未复制就关闭，需删除该密钥后重新创建。

若列表中已有密钥，可在对应行点击 「复制 API 密钥」 再次复制。

图：密钥列表每一行有「复制 API 密钥」按钮，点击即可复制该密钥。

在本应用中的填写

• 将复制的密钥（形如 AIza...）粘贴到本应用 设置 → AI → 自定义模式 → Google Gemini 的 API Key 一栏。
• Endpoint、模型名称、视觉模型、语音模型可留空，将使用默认（如 gemini-pro、gemini-1.5-flash 等）。

---

2. 阿里云百炼（DashScope）：如何新建 API 密钥

获取阿里云模型密钥

1. 注册账号：若无阿里云账号，需首先注册。

   如遇问题，请参见注册阿里云账号。

2. 开通阿里云百炼：使用阿里云主账号前往阿里云百炼大模型服务平台，阅读并同意协议后，将自动开通阿里云百炼，如果未弹出服务协议，则表示您已经开通。

   如果开通服务时提示“您尚未进行实名认证”，请先进行实名认证。

3. 获取 API Key：前往密钥管理页面，单击创建 API Key，即可通过 API KEY 调用大模型。

在本应用中的填写

• 将复制的 API Key（灵积控制台生成的格式，或若使用 AccessKey 则为 AccessKeyID:AccessKeySecret）填入本应用 设置 → AI → 自定义模式 → 阿里云百炼 的 API Key 一栏。
• 默认端点：https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions，可留空使用默认。

---

3. 智谱 AI

官方入口（需智谱账号登录）

• 开放平台：https://open.bigmodel.cn/
• API Key 管理：https://open.bigmodel.cn/usercenter/apikeys
• 未登录会跳转登录页：https://open.bigmodel.cn/login

操作步骤概要

1. 打开 智谱 AI 开放平台，注册/登录账号。
2. 完成实名认证后可获得免费额度（新用户约 100 万 token，实名后另有额度）。
3. 进入 个人中心 → API Key 管理。
4. 点击 「创建 API Key」，复制生成的 Key。

在本应用中的填写

• 将 Key（格式多为 xxx.xxx）填入「智谱 AI」的 API Key。
• 默认端点：https://open.bigmodel.cn/api/paas/v4/chat/completions，可留空。

---

4. 豆包 AI（火山方舟）

官方入口（需火山引擎账号登录）

• 火山引擎：https://www.volcengine.com/
• 豆包/方舟相关文档：https://www.volcengine.com/docs/82379/1142195

操作步骤概要

1. 登录 火山引擎，完成实名认证。
2. 顶部菜单 「产品」 → 「大模型」 → 进入 「火山方舟」。
3. 左侧 「API Key 管理」 → 点击 「创建 API Key」，命名后创建并复制密钥。
4. 在 「开通管理」 中为需要的大模型开通对应服务。

在本应用中的填写

• 将创建的 API Key 填入「豆包 AI」的 API Key。
• 默认端点：https://ark.cn-beijing.volces.com/api/v3/chat/completions，可留空使用默认。

---

五、常见问题

• 提示「无法连接到 AI 服务」
  检查：网络、代理/VPN、设置中的 Endpoint 与 API Key 是否正确；若使用自定义 Endpoint，确认地址可访问。
• 提示「需要激活基础会员才能使用 AI 功能」
  请在设置页完成「激活」（基础会员）后再使用自定义 AI。
• Plus 模式不可选
  Plus 模式仅对 Plus 会员开放，且依赖后端环境变量 AI_MODEL、AI_VISION_MODEL 等配置。