OKNote
初步使用指南

🤖 AI 配置指南

OKNote 的 AI 功能遍布各个模块：笔记总结、翻译、生成图表、邮件摘要、AI 起草回复、周报月报……它们共用一套 AI 配置。配置一次，全部解锁，只需要一个大模型服务商的 API Key。

一、三分钟完成配置

打开 设置（⌘,）→ AI 配置：

  1. 选服务商：下拉列表里内置了主流服务商的预设——

    类型 服务商
    国内 DeepSeek、智谱 GLM、Kimi（月之暗面）、通义千问、豆包（火山引擎）、硅基流动、腾讯混元、百度文心
    国际 OpenAI、Anthropic Claude、Google Gemini、xAI Grok、OpenRouter、Mistral、Groq
    本地 / 自定义 Ollama、LM Studio、自定义（任何 OpenAI 兼容接口）

    选中后接口地址（Base URL）自动填好，一般不用改。

  2. 填 API Key：粘贴你在服务商官网申请的 Key（下面教你申请）。

  3. 选模型：输入框会给出该服务商的推荐模型，点选即可。

  4. 点「测试」：连接成功会显示模型响应和耗时；失败请检查 Key 是否正确、账户是否有余额。

  5. 保存。完成！

🔒 你的 API Key 使用 AES-256 加密后存储在你自己的服务器上，不会外泄给任何第三方。

二、API Key 怎么申请

各家流程大同小异：官网注册 → 开放平台 / API 控制台 → 创建 API Key → 复制。举两个例子：

DeepSeek（国内推荐，性价比高）

  1. 打开 platform.deepseek.com，注册并登录。
  2. 左侧菜单进入「API Keys」，点「创建 API Key」。
  3. 复制生成的 sk- 开头的 Key（只显示一次），充值少量金额即可长期使用。

OpenAI

  1. 打开 platform.openai.com，登录后进入「API keys」。
  2. 「Create new secret key」，复制保存。

智谱（open.bigmodel.cn）、Kimi（platform.moonshot.cn）、通义（阿里云百炼控制台）等同理，在各自开放平台的「API Key」页面创建即可。

Ollama 本地模型（完全免费、数据不出机器）

  1. 在服务器（或本机）安装 Ollama：ollama.com 下载安装。
  2. 终端执行 ollama pull qwen3（或其它你喜欢的模型）。
  3. OKNote 中服务商选「Ollama（本地）」，Base URL 默认 http://localhost:11434，不需要 API Key，模型名填你拉取的模型，测试即可。

说明：本地模型（Ollama / LM Studio）、自定义服务商、配置多个服务商等属于高级能力，随授权版本开放；如果选项带锁标识，说明当前版本未包含。

三、进阶：分模块使用不同的 AI

设置页里有一个 「分模块独立配置」 开关（随授权版本开放）。打开后可以分别为：

  • 笔记 / 周报 AI —— 笔记总结、翻译、图表、任务周报月报
  • 邮件 AI —— 邮件摘要、分类、AI 起草回复

配置不同的服务商或模型。典型玩法：笔记用能力强的大模型保证周报质量，邮件摘要用便宜快速的小模型跑量。不开启时全部功能统一走一套配置，同样够用。

团队部署时，管理员还可以选择共享自己的 AI 配置给全体成员，成员无需各自申请 Key。

四、配置好了，去哪用？——全模块 AI 功能地图

模块 功能 入口
笔记 总结笔记 / 提取标签 / 译为英文 / 译为日文 / 生成图表 / 自由问答 打开任意笔记，点右下角 ✨ 悬浮球打开 AI 面板
笔记 把 AI 回答写进笔记 AI 面板中点「插入到笔记」
邮件 AI 摘要（批量归纳分类邮件） 邮件侧栏 → 智能视图 → AI 摘要
邮件 AI 起草回复（支持自定义指令） 打开邮件 → 「AI 起草回复」
任务 AI 快速建任务（自然语言 / 语音） 计划视图右下角 AI 悬浮按钮
任务 AI 生成周报 / 月报 报告视图 → 「生成报告」

其中笔记 AI 面板值得展开说说：它的「对话」模式会以当前笔记内容为上下文回答问题——打开一篇长会议记录，直接问"这篇里我需要跟进哪些事？"；「生成图表」能从笔记里的数据自动生成柱状图/折线图/饼图并插入正文。

五、常见问题

  • 点 AI 功能提示「未配置」？ 回到 设置 → AI 配置 完成配置并测试通过；如果开了分模块配置，确认对应模块（笔记 或 邮件）也各自配置了。
  • 测试连接失败？ 依次检查：Key 是否复制完整、服务商账户是否有余额、服务器网络能否访问该服务商接口（国际服务商需要相应的网络环境）。
  • 想换模型？ 随时回设置页改模型名保存即可，立即生效。

接下来两篇是给管理员的进阶配置：《🔑 购买后：把授权激活到这台服务器》和《🌐 公网访问：用自己的域名 + Cloudflare》。用不到可以跳过。