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 的介面）

    選中後 API 位址（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》。用不到可以跳過。