Wake

这是什么？适合谁？

Wake（iAmCorey/Wake）是一个原生桌面应用，把你机器上所有 coding-agent 会话汇集到一处——浏览、全文搜索、几秒内恢复任何对话。用 Rust + GPUI 构建（gpui 0.2 + gpui-component 0.5），macOS 优先；v0.2.5 起支持 Linux（实验），v0.2.7 起支持 Windows（实验）。

它解决的问题：你的 Agent 历史散落在 ~/.claude、~/.codex 和十几个私有目录里。Wake 只读地读取所有这些目录，给你一个快速的统一窗口。一切留在本地，只有你明确检查更新时才联系 GitHub。

核心能力：

• 统一浏览——按 Agent/项目分组，live file watching 增量更新
• 全文搜索（⌘K / Ctrl+K）——SQLite FTS5 trigram 索引，CJK 文本和代码子串（如 useEffect(）同样搜得准，直接跳到对话里匹配的那条消息
• 逐条消息渲染——用户/助手气泡、可折叠工具调用簇、思考摘要、tree-sitter 代码高亮（30+ 语言）
• 一键恢复——在原始项目目录重新打开会话（claude --resume、codex resume…）
• 管理——星标/置顶（存 Wake 自己的库，原文件不动）、导出 Markdown、删除（系统回收站 + tombstone）

适合人群：同时用多个 coding agent 的开发者；想找回「上周那个已经调通的会话」的人；需要跨会话搜索一段代码片段的人。

隐私立场：Agent 数据目录只读打开，从不写别的工具的文件；从不读凭证文件；无后台网络请求（唯一网络动作是用户主动的更新检查）。

准备工作

1. macOS 14+（主平台）；Linux beta；Windows beta。
2. 成本：MIT 开源，完全免费。
3. 安装方式：从 latest release 下载 Wake-<version>-macos.zip（Universal Binary），解压拖入 Applications；或从源码构建（需 Rust 工具链）。
4. Gatekeeper 注意：app 是 ad-hoc 签名的，首次启动需右键 → Open，或 xattr -d com.apple.quarantine Wake.app。
5. 时间预算：下载安装 2 分钟；首次索引约 5 秒（约 310 会话 / 800MB JSONL 的参考机器）。

快速上手（3 步）

第一步：安装

# 从 release 下载 Wake-<version>-macos.zip 解压拖入 Applications
# 或从源码构建：
git clone https://github.com/iAmCorey/Wake && cd Wake
scripts/make-app.sh          # 构建 dist/Wake.app
open dist/Wake.app

第二步：首次扫描

打开 Wake，它会只读扫描 ~/.claude、~/.codex 等目录，把所有会话分组展示。索引存 ~/Library/Application Support/wake/wake.db，可随时从零重建。

第三步：搜索并恢复

按 ⌘K（Windows/Linux Ctrl+K）全文搜索，比如输入一个你记得的函数名；点击结果跳到对应消息；点「恢复」在原始项目目录重新打开会话。

成功判定：你能在几秒内从一个只记得片段（如 useEffect(）的旧会话里定位并恢复它，而不是去十几个目录里手动翻 JSONL。

初级用法

支持的 Agent 数据源

Claude Code（~/.claude/projects/**/*.jsonl）、Codex CLI（sessions + state_5.sqlite 只读）、Qoder、Copilot CLI、Cursor（CLI transcripts）、OpenCode、Kiro、Gemini CLI、Pi、Oh My Pi、Grok Build、Kimi Code、Antigravity CLI、DeepSeek Harness（zstd 压缩日志透明解码）等。

管理操作

• 星标/置顶存 Wake 自己的库，原文件不动
• 导出 Markdown
• 删除走系统回收站 + tombstone，保证删掉的会话不再回来

高级玩法

跨 Agent 统一搜索

Wake 的价值在「多 Agent」：同一个问题你可能在 Claude Code 和 Codex 里都试过。一次搜索跨所有 Agent 会话命中，代码子串和 CJK 文本同等精度。

从源码构建 Universal Binary

rustup target add aarch64-apple-darwin x86_64-apple-darwin
scripts/make-app.sh --universal

便携式数据层

WAKE_HOME=/path cargo run -p wake 把所有 adapter 指向另一个 home 目录，适合便携安装和测试。数据层与渲染完全解耦（wake-core 无 UI 依赖）。

小技巧

1. 搜索代码子串：trigram 索引让 useEffect(、getServerSideProps 这类片段精确命中，比按自然语言搜更可靠。
2. 星标当书签：置顶星标存自己的库，原会话文件不动，重建索引也不丢。
3. 导出留档：重要会话导出 Markdown 归档。
4. 暗色主题：WAKE_THEME=dark 强制暗色（默认跟随系统）。
5. 增量扫描：mtime-based 增量扫描，后续启动瞬时，不必担心每次全量重建。

常见踩坑

踩坑 1：首次启动被 Gatekeeper 拦

• 现象：双击 app 提示无法打开。
• 原因：release 是 ad-hoc 签名，macOS Gatekeeper 默认拦截。
• 解决：右键 → Open；或 xattr -d com.apple.quarantine Wake.app。

踩坑 2：Windows SmartScreen 拦截

• 现象：Windows 下双击 Wake.exe 被 SmartScreen 挡。
• 原因：二进制未签名。
• 解决：点「More info → Run anyway」；Windows 支持仍是 beta。

踩坑 3：加密的 Agent 数据读不到

• 现象：Cursor IDE 聊天、Windsurf、Trae 的会话不出现。
• 原因：这些产品加密本地数据，Wake 无法解析。
• 解决：这类数据源本身不受支持（README 已列明）；用它们 CLI 形式的 transcript。

踩坑 4：删除的会话又出现

• 现象：删了某个会话，重新扫描又回来了。
• 原因：直接删了 Wake 的索引但没走它的删除逻辑（或反之）。
• 解决：用 Wake 的删除（系统回收站 + tombstone），tombstone 保证删掉的会话不再索引。

踩坑 5：以为会写回 Agent 数据

• 现象：担心 Wake 污染 ~/.claude。
• 原因：误解读写模式。
• 解决：Wake 对所有 Agent 数据目录只读，从写入别的工具文件；自己的状态只存 wake.db。

常见问题 FAQ

Q1: Wake 会把我的会话上传吗？

A: 不会。所有数据本地索引，唯一网络动作是用户主动点击的更新检查（查 GitHub Release 元数据）。凭证文件（auth.json 等）从不读取。

Q2: 支持哪些 Agent？

A: Claude Code、Codex CLI、Qoder、Copilot CLI、Cursor CLI、OpenCode、Kiro、Gemini CLI、Pi、Oh My Pi、Grok Build、Kimi Code、Antigravity CLI、DeepSeek Harness 等；Cursor IDE/Windsurf/Trae 因加密不受支持。

Q3: 性能如何？

A: 参考机器（约 310 会话、800MB JSONL）全量索引约 5 秒，后续启动瞬时（mtime 增量），搜索亚毫秒级。

Q4: 我的星标/置顶会丢吗？

A: 不会。星标和置顶存独立表，重建索引时保留。

Q5: Linux / Windows 能用吗？

A: 能，但均为实验支持。数据层、渲染、搜索在 Linux 完全测试通过；终端恢复目标和桌面集成使用里程较少。Windows 支持终端恢复到 Windows Terminal/PowerShell/CMD/Alacritty/WezTerm。

进阶学习建议

掌握基础后，建议深入：

1. 多 Agent 工作流复盘：每天结束时用 Wake 的全文搜索回顾当天跨 Claude Code/Codex 的会话，提炼可复用的 prompt 和踩坑，沉淀成自己的 AGENTS.md。
2. 代码片段检索驱动的复用：养成「先搜 Wake 再重写」的习惯——很多你准备重写的函数其实上周在另一个项目里已经调通了。
3. 导出 + 知识库归档：把高价值会话导出 Markdown，配合 Heimdall 之类的记忆工具形成跨仓库知识复利。

参考链接

• 官方仓库
• 最新 Release
• GPUI（Zed 的 UI 框架）

最后更新：2026-08-27 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成