不要再让 AI 重新发明你已经摸索过的轮子。

vibebook plugin 把你过去的 Claude Code 与 VS Code Copilot Chat 会话整理成一本可检索的笔记，记录决定、死胡同与修复方案。每周跑一次 /vibebook 整理素材，做任何不平凡的任务前跑一次 /vibebook-recall 把相关的过去工作翻出来。

Claude Code 插件独立运行 · 无外部服务 MIT

安装在 GitHub 上查看

它解决的痛点

你每一次 AI 编程会话都是一次性的。下一次会话、下一个 agent、明天早上 — 没人记得你昨天调过什么 bug。它们重新推导每一个架构决策、重新踩每一个 macOS 怪坑、重新读你已经解释过两遍的代码。

你的 Claude Code 会话历史就在 ~/.claude/projects/。 vibebook 读它、整理它，让未来的会话可以站在这些素材之上。

两个 slash 命令

`/vibebook`

扫描 ~/.claude/projects/ 与 Copilot Chat 历史,把每个会话整理成两类按项目分组的产物:

chronicles — 一个工作线一份,带 AI 优先的 frontmatter（files_touched、commits、 decisions、blockers、status）加四段式正文（Context / What worked / Dead ends / Open questions）。
topics — 一个子系统一份,反向链接到贡献的 chronicle。

根据 cwd 自动判断项目;在非项目目录里会问你要不要做全量整理。

`/vibebook-recall`

开始新工作之前的三阶段渐进式 recall。专门为 AI agent 廉价消费而设计:

第一阶段 — 项目的 topic 列表（约 5 KB）。
第二阶段 — 单个 topic 下的 chronicle frontmatter（不含正文）。
第三阶段 — 真正需要的那几篇 chronicle 读全文。

调用代价很低,Claude 可以在每个"我们好像之前做过……"的瞬间不假思索地触发第一阶段。

recall 究竟做什么 — 一个说明性场景

Recall 不是你需要记着主动调用的功能。是 Claude 在感觉 "这事儿好像和过去的工作有重叠" 时自己伸手去翻的工具。想象你对 Claude 说:

> 这个集成测试已经 flaky 一周了,帮我修一下

你没问"我们以前遇到过吗"。你只是要一个修复。但 Claude 把"flaky 测试"识别成 recall 的触发词,先跑一次 /vibebook-recall 第一阶段 — 5 KB 的 topic 列表,几乎免费。第一阶段返回里有一个 flaky-tests topic,关联两篇 chronicle。Claude 钻进相关那篇,拿到一份结构化摘要:

上次的真实根因 — 测试假设 UTC;CI runner 时区是 America/Los_Angeles。下午 4 点到午夜之间才 fail, 看起来像随机。
当时 ship 的修复 — 把日期断言包进固定时区的 helper;commit a1b2c3d。
已经走过的死胡同 — 给共享 fixture 加 mutex(无效,不是竞态);把网络超时调到 30 秒 (无效,根本没网络);二分依赖找回归点(无效,问题早于可疑升级)。
留下的开放问题 — 同文件还有三个测试用 new Date(),迟早会踩同一个坑。

于是 Claude 直接告诉你:

据 chronicle flaky-test-investigation:这个 suite 在三月份也 flaky,根因是
时区假设。mutex / 超时 / 二分依赖三条路当时已经试过排除掉了。
要不要我直接套用同款固定时区修复,顺手把 chronicle 里标记的另外
三处可疑调用也提前修了?

最后这段才是 recall 值得自动调用的理由。如果没有它, Claude 会重新走同样的死胡同 — git log 会显示"修了 flaky 测试"的 commit,但 commit message 不会记你排除掉了什么。Chronicle 把两半都保留下来, recall 在 Claude 烧上下文重新探索之前就把它们摆出来。

安装

在 Claude Code 里两条命令:

/plugin marketplace add june9593/vibebook-plugin
/plugin install vibebook

就这样。开任何一个 Claude Code 会话,跑 /vibebook 整理本机会话,或者 /vibebook-recall 翻过去的笔记。不需要 npm install,不需要外部服务,数据全部留在 ~/.vibebook/。

写到哪里

所有产物都在 ~/.vibebook/session-repo/ 下:

raw_sessions/<tool>/<project>/<date>/*.{md,raw.json} — 渲染过的会话副本
book/<project>/{chronicle,topics}/*.md — 整理出来的笔记本
.vibebook/index.json — 单个会话条目索引
.vibebook/index.book.json — chronicle / topic 目录

插件不会创建或修改 .git/ 或可选 npm CLI 的任何配置文件 — 那些是跨设备同步工具的领地,装了 npm CLI 才有。

跨设备同步(可选)

要把会话带到多台机器之间,装可选的 vibebook npm CLI:

npm i -g vibebook
vibebook init

它把 ~/.vibebook/session-repo/ 同步到一个私有的 GitHub repo。插件和 npm CLI 在同一个 spool 路径上协作,条目用 sessionId 做 key — 装其中一个、两个都装、或者都不装, 按你需要选。

vibebook npm CLI →

Memex 接力(可选)

如果你想要原子化的 Zettelkasten 卡片(一张卡一个 insight, 带反向链接、自动整理、孤儿检测),vibebook 把这部分交给 memex。装上之后,/vibebook 会主动问你"chronicles 写完之后要不要顺手跑一次 /memex-retro"。 /vibebook-recall 也会把 memex 的目录折叠进第一阶段,让 agent 一次 triage 看到两层。

memex 是可选的 — vibebook 没它也能正常运转,只是少了原子卡这一层。

项目链接

MIT 许可证 · 22 个测试用例覆盖 autonomy、scan、orchestrator、 config 容错 · 自包含的 386 KB esbuild bundle,运行时不需要 npm install。