1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Wake |
| 作者/维护者 | Corey Chiu（个人开发者，GitHub 账号 iAmCorey） |
| 来源链接 | https://github.com/iAmCorey/Wake（技能位于 skills/wake 子目录） |
| 许可证 | MIT（GitHub API 确认） |
| GitHub Stars | 886（应用整体，非技能本身热度，来自 GitHub API） |
| Forks | 59（来自 GitHub API） |
| 最新版本 | v0.6.1（2026-09-11 发布，来自 GitHub API） |
| 安装方式 | 先安装 Wake 桌面应用（macOS 优先，Linux/Windows 为实验性支持），运行一次建立会话索引后，将 skills/wake 复制进对应 Agent 的 skills 目录即可 |
2. 功能介绍与亮点
Wake 是一个只读的本机 AI 编码 Agent 会话检索工具：它把散落在 ~/.claude、~/.codex 等十余个私有目录中的历史会话统一索引，配套的 wake-cli 命令行让 Agent 在对话中直接查询“之前讨论过什么、为什么这么决定、上次做到哪、某个报错是否见过”。
核心能力：
- 跨会话检索：
wake-cli search基于 SQLite FTS5 三元组索引做全文检索，支持中日韩文本与代码片段（如useEffect(）匹配； - 按项目列会话：
wake-cli sessions --project可按 Agent 类型、时间范围、星标等条件过滤； - 精确定位：搜索结果自带
wake://session/<key>#<seq>引用，可直接跳转到命中消息所在的上下文，免去手动翻找长对话记录； - 纯读不改：SKILL.md 明确声明“一切只读，不会修改或删除任何会话”，命令集不含任何写操作。
亮点：全部处理在本地完成，索引与查询均不出网（仅检查更新时联系 GitHub）；文档把退出码语义、分页方式、边界情况（如“无匹配”不算失败）都写得清楚，减少 Agent 误判；近三周内已发布多个版本，维护节奏密集。
3. 适用场景
所属分类：元技能与 Agent 增强
适合以下场景：长期维护同一项目、需要回顾“某个技术决策为什么这么做”的开发者；日常在 Claude Code、Codex 等多个编码 Agent 之间切换、担心上下文丢失的用户；调试时想确认“这个报错之前是否出现过、当时怎么解决的”；团队交接时需要快速找到某次会话中止的位置。不适合完全不使用本机编码 Agent、或只用云端托管会话（不落地到本机文件）的工具链。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 官方文档明确读取 ~/.claude/projects/**/*.jsonl，并提供可选的 wake-mcp 只读 MCP Server 供 Claude Code 直接调用 |
| Codex | ✅ 原生支持 | 官方文档明确读取 ~/.codex/sessions 及状态数据库，同样支持 wake-mcp 接入 |
| OpenClaw | ✅ 原生支持 | 官方文档明确读取 ~/.openclaw/agents/*/agent/openclaw-agent.sqlite（含 OPENCLAW_STATE_DIR 环境变量适配） |
| Hermes Agent | ✅ 原生支持 | 官方文档明确读取 ~/.hermes/state.db 及各 profile 状态库（含 HERMES_HOME 环境变量适配） |
四个目标生态均有官方文档逐一列出的读取路径与验证依据，同时明确支持列表之外的 Copilot CLI、Cursor、Gemini CLI 等也可读取（部分字段缺失以“—“标注），透明度高。
5. 推荐理由
编码 Agent 的历史会话是一种 Git 记录不到的知识资产——之前尝试过什么方案、为什么放弃、某个约定是怎么定下来的，都只存在于对话记录里。Wake 把这些散落在不同 Agent 私有目录里的会话统一成一个可全文检索的本地索引，且四个目标生态原生打通，避免了逐个 Agent 分别查历史的麻烦。技能本身只读、不联网、无需任何凭据，风险面很小，配合官方桌面应用可以直接投入日常使用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 应用创建仅约 3.5 周即获 886 星（该数字反映整个桌面应用而非本技能自身），并获科技媒体 AlphaSignal、The Daily Commit 及开发者社区 dev.to 三个独立来源报道 |
| 可用性 | 8 | SKILL.md 文档详尽（含退出码语义、分页方式、边界情况说明），近三周内已发布多个版本、维护密集，免费无付费依赖；但需先安装桌面应用并完成一次建索引，Linux/Windows 支持仍是实验阶段，故不给满分 |
| 安全性 | 9 | 纯读取本机会话文件，无写入无删除；不要求任何 API Key 或凭据；除检查更新外不联网；开源、MIT 许可、代码可审计；SKILL.md 与脚本中未发现可疑指令 |
综合评分：8.0（三项均值）
7. 跟同类 Skills 相比的优势
| Skill | 核心机制 | 与 Wake 的差异 |
|---|---|---|
| session-viewer-openclaw-agent-skills | 把单次 Agent 会话渲染成一份静态 HTML 文件，便于复盘 | 定位是“导出单份记录”，不提供跨会话全文检索或多 Agent 统一索引；Wake 面向“在十余种 Agent 的历史里找到那一段” |
| claude-mem | 本地优先的持久记忆系统，自动压缩上下文并在新会话开始时主动注入 | 是“自动喂给 Agent 看”的主动记忆机制，处理的是压缩后的摘要；Wake 是“按需查询原始会话记录”，两者解决的是记忆的不同阶段（自动注入 vs 手动溯源） |
| supermemory-supermemoryai-supermemory | 面向个性化上下文的记忆基础设施，跨会话记住用户偏好 | 关注的是用户偏好与交互模式的长期沉淀；Wake 关注的是完整会话记录本身的可检索性，不做偏好抽象 |
Wake 的差异化在于“原始会话记录的全文检索器”这一定位：不对内容做摘要或改写，检索结果可直接跳转回原始上下文，且是目前索引中少数对 OpenClaw 与 Hermes Agent 都给出官方读取路径说明的同类工具。
8. 用户评价
该技能所依附的 Wake 应用目前以 GitHub 仓库自身文档与科技媒体报道为主（AlphaSignal、The Daily Commit 均以功能介绍为主，未见具体使用体验的评价性文字），第三方平台尚无具名用户评价。
9. 其他补充
Wake 支持跨机器同步：可在设置中添加远程主机（SSH alias 或 user@host），将其他机器上的会话镜像展示并支持一键生成可粘贴的 ssh 续接命令。仓库同时提供 wake-mcp——一个只读 MCP Server，可让 Claude Code、Codex、Cursor 等任意 MCP 客户端直接检索历史、按项目列出近期会话、分页读取完整记录。
10. 安装使用方式
- 从 Wake 仓库 下载并安装桌面应用（macOS 优先，Linux 需 deb 包或 tarball，Windows 与
Wake.exe同目录），启动一次以建立本机会话索引； - 将
skills/wake目录复制到对应 Agent 的 skills 目录（如 Claude Code 的~/.claude/skills/）； - 确认命令行工具可用：
command -v wake-cli或直接定位/Applications/Wake.app/Contents/MacOS/wake-cli； - 在对话中提及“之前聊过”“为什么这么做”“上次做到哪”等诉求时，Agent 会自动调用
wake-cli sessions或wake-cli search查询； - 如需让 Agent 通过 MCP 直接接入，可在 Wake 设置的 Connect 面板复制配置片段，或运行
wake-mcp setup。
11. 注意事项
- 使用前必须先运行过一次 Wake 桌面应用完成索引构建，技能本身不会主动安装或启动该应用；
- Linux 与 Windows 支持标注为实验性，稳定性可能不及 macOS；
- 远程会话同步依赖对方机器使用各 Agent 的默认路径，非默认路径（如自定义
CODEX_HOME）在远程机器上不会被识别，且暂不支持远程 Windows 机器； - Cursor IDE 聊天、Windsurf、Trae 因本地数据加密，Amp、Factory（Droid）、Warp 因会话存于云端，均不在 Wake 的读取范围内。