AI Setup Guide

各 AI 供应商
设置指南

使用 ThreadKeeper 的 AI 摘要功能,
需要任一 AI 供应商的 API 密钥。
请选择供应商,按照步骤进行设置。

Google Gemini 设置

有免费额度,响应速度快。
最推荐首次使用的用户选择此供应商。
推荐模型:Gemini 2.0 Flash Lite

1访问 Google AI Studio

访问 https://aistudio.google.com/
使用 Google 账户登录。

2获取 API 密钥

  1. 点击左侧菜单的"Get API key"
  2. 点击"Create API key"按钮
  3. 选择项目(如没有则新建)
  4. 复制显示的 API 密钥

API 密钥可能只显示一次。
请务必复制并保存在安全的地方。

3在 ThreadKeeper 中设置

打开 ThreadKeeper 的设置界面,
在"AI 供应商"中选择"Google Gemini"。
粘贴复制的 API 密钥并保存。

// 配置文件示例(settings.json) { "ai_provider": "gemini", "ai_model": "gemini-2.0-flash-lite", "api_key": "AIza..." }

关于免费额度:Gemini API 有每分钟 15 次请求、
每日 token 上限的限制。
ThreadKeeper 的正常使用完全在免费额度范围内。

OpenAI 设置

支持 GPT-4o / GPT-4o mini。
适用于需要高精度摘要的场景。
API 使用按量收费。

1访问 OpenAI Platform

访问 https://platform.openai.com/
创建账户或登录。

2创建 API 密钥

  1. 点击右上角图标 → "API keys"
  2. 点击"Create new secret key"
  3. 输入名称(例如:ThreadKeeper)
  4. 复制显示的密钥

API 密钥仅在创建时显示一次。
如果丢失需要重新创建。

3设置支付方式

从 Settings → Billing 注册支付方式。
可使用信用卡或借记卡。

4在 ThreadKeeper 中设置

在 ThreadKeeper 的设置界面选择"OpenAI",
粘贴 API 密钥并保存。

// 配置文件示例(settings.json) { "ai_provider": "openai", "ai_model": "gpt-4o-mini", "api_key": "sk-..." }

费用参考:使用 GPT-4o mini 时,
每次摘要约 0.01〜0.03 日元。
每天使用 10 次,月费也不到 10 日元。

Anthropic 设置

支持 Claude 3.5 Sonnet / 3.5 Haiku。
以自然流畅的日语摘要著称。
API 使用按量收费。

1访问 Anthropic Console

访问 https://console.anthropic.com/
创建账户或登录。

2创建 API 密钥

  1. 点击左侧菜单的"API Keys"
  2. 点击"Create Key"
  3. 输入名称(例如:ThreadKeeper)
  4. 复制显示的密钥

3充值额度

从 Settings → Billing 购买额度。
最低可从 $5 起充值。

4在 ThreadKeeper 中设置

在 ThreadKeeper 的设置界面选择"Anthropic",
粘贴 API 密钥并保存。

// 配置文件示例(settings.json) { "ai_provider": "anthropic", "ai_model": "claude-3-5-haiku-latest", "api_key": "sk-ant-..." }

费用参考:使用 Claude 3.5 Haiku 时,
每次摘要约 0.02〜0.05 日元。

Ollama 设置

完全离线、完全免费运行。
数据绝不会发送到外部。
需要 PC 具备一定的硬件配置。

1安装 Ollama

https://ollama.com/
下载并安装 Windows 版。

2下载模型

打开命令提示符或 PowerShell,
运行以下命令。

# 推荐:轻量高速 ollama pull gemma3:4b # 需要高质量摘要时 ollama pull llama3.2 # 擅长中文/日文的模型 ollama pull qwen2.5:7b

所需配置:4B 模型建议
RAM 8GB 以上。
7B 模型建议 RAM 16GB 以上以获得良好体验。

3启动 Ollama

安装 Ollama 后
会自动在后台启动。
如果任务栏显示 Ollama 图标即表示正常运行。

4在 ThreadKeeper 中设置

在 ThreadKeeper 的设置界面选择"Ollama"。
无需 API 密钥。只需设置模型名称即可完成。

// 配置文件示例(settings.json) { "ai_provider": "ollama", "ai_model": "gemma3:4b", "ollama_url": "http://localhost:11434" }

使用 Ollama 时,模型下载可能需要
几分钟到几十分钟。
仅首次需要等待,之后可离线即时使用。

通用注意事项

API 密钥管理
API 密钥保存在 ThreadKeeper 的配置文件中,
仅在本地存储。
不会发送至 ThreadKeeper 的服务器。
请不要与他人共享 API 密钥。

发送的数据
发送给 AI 的仅有打开的应用标题、
浏览器标签页的标题和 URL、
以及剪贴板的前 200 个字符。
不会发送文件内容或密码。
使用 Ollama 时不会有任何外部数据发送。

切换供应商
可以随时从设置界面更改供应商。
会话数据不依赖于供应商,
切换后过去的数据仍然保留。