BYOK 设置指南 - 配置你的 AI 提供方
第 36 章：BYOK 设置指南 — 配置你的 AI 提供方
把 BYOK（Bring Your Own Key）想成自带咖啡豆到有意式浓缩咖啡机的咖啡馆——SeaMeet 提供提取和分析引擎，你提供 AI 访问凭据。这让你的数据直接在你和你选择的 AI 提供方之间流动，没有第三方中继。
本章引导你设置两个必需组件：AI 摘要密钥（Gemini）和 AI 助手提供方（GitHub Copilot 或 Claude Code）。它还涵盖一个常让新订户惊喜的好处——你的 BYOK Pro 计划还包含通过 GitHub 的免费跨设备同步，而不只是 AI 访问。
包含 GitHub Sync
从 v2.1.x 开始，每个 BYOK Pro 订阅都附带通过你自己的私有 GitHub 仓库的笔记和 wiki 跨设备同步——无额外费用、每工作区一个仓库、无存储限制。同步以前在升级界面上是隐形的；现在它在 Pre-Subscribe 价值英雄、Plan 卡片、BYOK Explainer FAQ 和 Sync 设置界面上都被展示出来。
它与专门的 Sync Pro 计划有何不同：BYOK 仅通过你自己的 GitHub 同步轻量级文本（笔记 + wiki）。Sync Pro 是单独管理的服务，通过 SeaMeet 的基础设施同步一切——笔记、音频、视频和截图。大多数 BYOK 用户只需要已经包含的文本同步。
完整介绍见 第 38 章：GitHub 同步。
本章目标
读完本章后，你将能够：
- 理解需要哪些密钥及为什么
- 从 Google AI Studio 获取免费 Gemini API 密钥
- 安装并配置 GitHub Copilot CLI（免费等级）
- 或者安装并配置 Claude Code CLI
- 设置与订阅捆绑的 GitHub 同步（第 38 章）
- 验证两个组件都在工作
- 在需要时更新或移除密钥
概览：你需要什么
BYOK 有两个配置组件——加上一个你不必配置的捆绑好处：
┌─────────────────────────────────────────────────────────────┐
│ BYOK 组件 │
├──────────────────────┬──────────────────────────────────────┤
│ A. AI 摘要 │ Gemini API 密钥（必需） │
│ （必需） │ 驱动：转录、摘要、 │
│ │ 行动项、决议、章节 │
├──────────────────────┼──────────────────────────────────────┤
│ B. AI 助手 │ GitHub Copilot CLI ← 或 → │
│ （至少需要一个） │ Claude Code CLI │
│ │ 驱动：截图分析、 │
│ │ 自定义 AI 查询 │
├──────────────────────┼──────────────────────────────────────┤
│ C. GitHub Sync │ 包含在 BYOK Pro 中 │
│ （捆绑、可选） │ 每工作区一个私有 GitHub 仓库。 │
│ │ 跨设备同步笔记 + wiki。 │
│ │ 设置：第 38 章。 │
└──────────────────────┴──────────────────────────────────────┘
你必须配置 A 和 B 中至少一个选项，才能让所有 AI 功能工作。C 是可选的但已经付费——准备好跨设备同步时随时打开它。
价值主张回顾
每月 $4.99 的 BYOK Pro 覆盖什么：
- 隐私 — 数据直接从你的设备到 Google / Anthropic / OpenAI；SeaMeet 服务器从不看到它。
- 质量 — 为每项工作挑选最佳模型。
- 成本控制 — 直接向提供方付费；大多数用户停留在 Gemini 的免费等级。
- 主权 — 密钥住在你的 OS 钥匙串中；随时撤销。
- 免费 & 私有同步 — 把笔记和 wiki 备份到你自己的私有 GitHub 仓库。
你将在应用中看到这些
这五个好处在每个 BYOK 升级触点上通过共享的 BYOK Value Hero 被加强——在 Pre-Subscribe 解释器、订阅后收据、Settings → AI、当免费用户点击 AI 门控功能（转录、摘要、行动项、笔记合成、wiki 列表、截图 AI）时出现的 Locked Feature Cards，以及 Sync 设置提醒横幅上。
A 部分：AI 摘要 — Gemini API 密钥
为何 Gemini？
SeaMeet 使用 Google 的 Gemini 模型进行音频转录、会议摘要、行动项提取和相关 AI 输出。Gemini API 有慷慨的免费等级，覆盖典型会议工作负载。
获取你的 Gemini API 密钥
- 打开浏览器并前往 Google AI Studio（aistudio.google.com/apikey）
- 如提示请用你的 Google 账户登录
- 点击 Create API Key
- 当被问及时选择或创建 Google Cloud 项目
- 复制生成的密钥（它以
AIza…开头）
免费等级： Gemini 的免费等级允许大量 API 调用每天。对于典型的会议录音用法（每周几小时音频），免费等级对大多数用户足够。
隐私： 你的音频被直接发送到 Google 的 API 进行转录。如果这对你的用例是担忧，请查看 Google 的 AI 数据使用政策。
在 SeaMeet 中输入你的密钥
在设置向导期间（订阅后第一次）：
- 订阅后向导自动打开
- 第 1 步显示 AI 摘要部分
- 把你的 Gemini 密钥粘贴到输入字段
- 密钥自动验证——你会看到：
- ✅ 绿色勾号：密钥有效
- ❌ 红色 X：密钥无效或复制不正确——检查并重新粘贴
- 点击 Next 继续到 AI 助手设置
之后，通过设置：
- 打开 设置（⚙️）
- 导航到 AI → API Keys
- 找到 AI 摘要 部分
- 点击 Edit 或粘贴到 Gemini 密钥字段
- 点击 Save — 密钥自动验证
测试和移除密钥
在 API Keys 设置中：
- Test 按钮 — 对 Google 的 API 验证密钥
- Remove 按钮 — 删除存储的密钥；AI 摘要功能在你添加新密钥之前不可用
如果密钥验证失败，它会自动被清除以防止存储坏密钥。只需粘贴新的。
B 部分：AI 助手提供方
你至少需要一个 AI 助手提供方。SeaMeet 当前支持两个：
| 提供方 | 费用 | 限制 | 最适合 |
|---|---|---|---|
| GitHub Copilot CLI | 免费（Copilot Free 计划） | 50 次聊天/月 | 入门、轻度使用 |
| Claude Code CLI | 付费（Claude Pro 或 Max） | 更高限制 | 定期使用、进阶用户 |
你可以同时安装两者并从 Settings → AI 切换。
选项 1：GitHub Copilot CLI（免费）
GitHub Copilot CLI 是 SeaMeet 用作其 AI 助手的命令行工具。免费 GitHub Copilot 等级包含每月 50 次助手请求——足够偶尔的截图分析和 AI 查询。
步骤 1：安 装 GitHub Copilot CLI
选择匹配你系统的方法：
Windows (winget)：
winget install GitHub.cli
macOS (Homebrew)：
brew install gh
Linux (apt)：
sudo apt install gh
注意： SeaMeet 在设置 UI 中每个命令旁显示复制按钮——你可以不打字复制确切命令。其他 Linux 发行版见 GitHub CLI 安装文档。
步骤 2：用 GitHub 认证
安装后，打开终端并运行：
gh auth login
按提示登录你的 GitHub 账户。这把 CLI 链接到你的 GitHub 账户并启用 Copilot 功能。
步骤 3：在 SeaMeet 中检测
- 在 SeaMeet 的 API Keys 设置中（或 Settings → AI → API Keys）：
- 找到 AI Agent 部分 → GitHub Copilot 磁贴
- 点击 Refresh (🔄)
- SeaMeet 扫描已安装的 CLI
- 如找到：出现 ✅ "Detected" 状态
- 如未找到：检查你的安装并重复
50 次聊天/月 限制： 免费 Copilot 计划对入门足够慷慨，但如果你频繁使用 AI 助手可能触及限制。你可以升级到 GitHub Copilot Pro，或切换到 Claude Code CLI 以获得更高限制。
选项 2：Claude Code CLI（付费）
Claude Code 是 Anthropic 的 CLI 工具。它需要 Claude Pro 或 Max 订阅，但比免费 Copilot 等级有更高使用限制。
步骤 1：安装 Claude Code CLI
Windows (PowerShell)：
irm https://claude.ai/install.ps1 | iex
macOS / Linux：
curl -fsSL https://claude.ai/install.sh | sh
SeaMeet 的设置 UI 为每个安装命令显示复制按钮。
步骤 2：认证
安装后，打开终端并运行：
claude auth
用你的 Anthropic 账户登录（需要 Claude Pro 或 Max 计划）。
步骤 3：在 SeaMeet 中检测
- 在 Settings → AI → API Keys → AI Agent → Claude Code 磁贴
- 点击 Refresh (🔄) 以检测已安装的 CLI
- 找到时出现 ✅ "Detected"
选择你的默认提供方
如果你同时安装了 Copilot 和 Claude，SeaMeet 让你选择默认使用哪个：
- 进入 Settings → AI → API Keys
- 在 AI Agent 部分，两个磁贴都会显示为已检测
- 使用单选按钮或选择器挑选活动提供方
- 所选提供方用于所有 AI 助手请求
你可以随时从 Settings 切换提供方。
验证一切工作
设置后，做一次快速端到端检查：
测试 AI 摘要：
- 在库中打开任意录音
- 点击 AI Insights → Generate Summary
- 如完成无错误：✅ Gemini 密钥工作
测试 AI 助手：
- 用 SeaMeet 截图
- 在截图查看器中打开它
- 点击 AI 分析标签并提问
- 如得到响应：✅ AI 助手提供方工作
更新密钥
更新你的 Gemini 密钥：
- Settings → AI → API Keys → AI Summary → Edit
- 清除旧密钥并粘贴新的
- 点击 Save
更新你的助手提供方：
- 如密钥已过期，重新运行 CLI 安装/认证步骤
- 在 SeaMeet 中点击 Refresh 以重新检测
快速参考
┌────────────────────────────────────────────────────────────┐
│ BYOK 设置指南 │
│ 快速参考 │
├────────────────────────────────────────────────────────────┤
│ Gemini 密钥来源 │ aistudio.google.com/apikey（免费） │
│ Gemini 免费等级 │ 慷慨 — 足够典型使用 │
│ 输入密钥 │ Settings → AI → API Keys → AI Summary │
├────────────────────────────────────────────────────────────┤
│ Copilot 安装 │ winget / brew / apt（免费） │
│ Copilot 认证 │ gh auth login │
│ Copilot 限制 │ 50 次聊天/月（免费等级） │
├────────────────────────────────────────────────────────────┤
│ Claude 安装 │ curl/irm 安装脚本（付费） │
│ Claude 认证 │ claude auth │
│ Claude 需要 │ Claude Pro 或 Max 订阅 │
├────────────────────────────────────────────────────────────┤
│ 检测提供方 │ Settings → AI → API Keys → Refresh 🔄 │
│ 切换提供方 │ AI Agent 部分的单选按钮 │
│ 测试 AI 摘要 │ 打开录音 → Generate Summary │
└────────────────────────────────────────────────────────────┘
相关章节
- 第 31 章：实时转录 · 第 32 章：AI 提取 · 第 33 章：AI 摘要模板 · 第 34 章：编辑 AI 结果 — 全部由你的 Gemini 密钥驱动
- 第 35 章：订阅与计费 — 计划管理和计费门户
- 第 37 章：Copilot — 使用 GitHub Copilot CLI 作为你的 AI 助手
- 第 38 章：GitHub Sync — 与你的 BYOK Pro 计划捆绑的跨设备同步
最后更新：2026-06-04
Published: