Usage Guide

入门使用指南

从安装到捕获与恢复，
结合界面说明，
详细讲解 ThreadKeeper 的基本操作。

目录
  1. 安装与首次启动
  2. 主界面说明
  3. 捕获会话
  4. AI 摘要确认与备注
  5. 会话列表说明
  6. 恢复会话
  7. 设置界面功能
  8. 快捷键一览
  9. 实用技巧

1安装与首次启动

支持 Windows 和 macOS。
只需运行下载的安装文件，无需任何专业知识。

Windows 安装

  1. 从首页下载 ThreadKeeper.Setup.0.1.0.exe
  2. 双击下载的 exe 文件运行
  3. 按照屏幕上的指示完成安装
  4. 从桌面或开始菜单启动 ThreadKeeper

如果出现 SmartScreen 警告：
请点击"更多信息"→"运行"。
由于未获取代码签名证书所以会显示此警告，
但可以安全使用。

macOS 安装

  1. 从首页下载 ThreadKeeper-0.1.0.dmg
  2. 双击打开 dmg 文件
  3. 将 ThreadKeeper 拖拽到 Applications 文件夹
  4. 从 Launchpad 或 Applications 文件夹启动 ThreadKeeper

如果出现"未验证的开发者"警告：
请前往 系统设置 → 隐私与安全性 → 点击"仍然打开"。
由于未获取 Apple 公证所以会显示此警告，
但可以安全使用。

首次启动时的操作

首次启动 ThreadKeeper 时，
会要求设置 AI 供应商。
使用 AI 摘要功能需要注册 API 密钥。

还没有 API 密钥的用户：
Google Gemini 有免费额度，
可以立即开始使用。
→ 查看 AI 设置指南

即使跳过 API 密钥设置，
捕获和手动恢复功能仍可使用。
仅 AI 摘要功能会被关闭。

2主界面说明

启动后将显示主窗口。
所有操作都可以从这里进行。

ThreadKeeper
会话列表
捕获
设置
API 设计调研与 Slack 沟通
2026/02/21 14:32 · 窗口 ×4 · 标签页 ×8
恢复 →
React 组件重构
2026/02/21 10:15 · 窗口 ×6 · 标签页 ×15
恢复 →
在 YouTube 观看 AWS 讲解视频
2026/02/20 18:40 · 窗口 ×2 · 标签页 ×5
恢复 →

会话列表

过去捕获的会话
按时间从新到旧排列。
AI 生成的标题、日期时间、
记录的窗口和标签页数量
一目了然。

捕获按钮

点击即可立即记录
当前 PC 的状态。
也可通过快捷键执行。

恢复 →

位于每个会话右侧的按钮。
只需点击，
即可恢复该时刻的应用和标签页。

设置按钮

可进行 AI 供应商切换、
快捷键更改等
各种设置。

3捕获会话

想要记录当前状态时，
只需按下快捷键。

捕获方法

可通过以下任一方式进行捕获。

捕获完成
已扫描的内容
窗口 ×5
标签页 ×12
剪贴板
最近文件 ×3

捕获记录的内容

提示：捕获可以反复执行。
在每个工作节点进行记录，
之后可以更方便地选择想要回到的时间点。

4AI 摘要确认与备注

捕获后 AI 会立即分析工作内容。
自动为您摘要"做了什么"。

AI 摘要确认
AI 自动摘要
「看起来您正在使用 Gemini 调研 API 设计，
同时在 Slack 上与团队成员沟通。
VSCode 中还打开了认证相关的代码。」
这个摘要正确吗？
是
修改
✎ 备注：认证的错误处理尚未完成。明天继续。

此界面可以做的事

未设置 AI 的情况下：
不会生成摘要，标题会自动以
"日期时间 + 窗口数"的格式显示。
也可以手动输入标题和备注。

5会话列表说明

解说主界面中会话列表的
各项目的含义。

会话详情
API 设计调研与 Slack 沟通
2026/02/21 14:32
打开的应用
VSCode
auth-handler.ts — ThreadKeeper
Slack
#dev-team — Slack
Chrome
8 tabs
浏览器标签页
Gemini — API Design Best Practices
MDN — Fetch API
... 另外 6 项
备注
认证的错误处理尚未完成。明天继续。
恢复 →

会话卡片显示的信息

点击会话卡片可展开详情，
查看打开的应用和标签页列表。

6恢复会话

只需按下恢复按钮。
即可恢复那一刻的工作环境。

恢复步骤

  1. 从主界面的会话列表中找到想要恢复的会话
  2. 点击"恢复 →"按钮
  3. 应用启动和浏览器标签页重新打开将自动执行

可恢复的内容

当前版本的限制：
不支持恢复滚动位置和窗口大小。
不支持恢复浏览器表单输入内容。
需要已安装相应的应用程序。

提示：恢复可以反复执行。
对同一会话反复恢复没有问题。
也可以用作"每天早上从这个环境开始"的
模板式用法。

7设置界面功能

从主界面的"设置"按钮
可以更改各种设置。

AI 供应商

设置使用的 AI 供应商和
API 密钥。
支持 Gemini / OpenAI / Anthropic /
Ollama。

AI 模型

可以按供应商
选择使用的模型。
轻量级模型响应更快。

快捷键

可以自定义
捕获的快捷键。
默认为 Ctrl+Shift+S。

数据存储位置

可以查看会话数据的存储位置。
默认路径：
Windows: %APPDATA%\ThreadKeeper\
macOS: ~/Library/Application Support/ThreadKeeper/

语言设置

更改应用显示语言。支持 日本語 · English · Français · Italiano · 中文（5种语言）。

关于更换供应商：
切换供应商后，
过去的会话数据将保持不变。
可以随时自由更改。

8快捷键一览

记住这些会很方便的键盘快捷键。

操作 Windows macOS
捕获会话 Ctrl + Shift + S Cmd + Shift + S

提示：快捷键可以从设置界面更改。
如果与其他应用的按键冲突，请自定义设置。

9实用技巧

介绍一些让 ThreadKeeper
更好用的小技巧。

下班前捕获

在一天结束时进行捕获，
第二天早上就不用再纠结"昨天做到哪了？"。
AI 的摘要会成为"来自昨天自己的交接备忘"。

切换任务时捕获

当有插入任务时，先捕获当前工作再去处理。
插入任务结束后通过"恢复 →"
可以瞬间回到原来的工作环境。

善用备注

捕获时留下"下次从 XX 开始""XX 等待确认"等
简短备注，恢复时就能立即上手。
请把它当作留给未来自己的留言来使用。

不用 AI 也能使用

即使不设置 API 密钥，
捕获和恢复的基本功能也能正常运行。
建议先不用 AI 试试看，
觉得好用的话再添加 AI 摘要功能。

使用 Ollama 离线运行

如果不想将任何数据发送到外部，
使用 Ollama 可以完全离线运行。
详情请参阅 AI 设置指南。