Question 1

Vibe Knowledge 是什么？

Accepted Answer

Vibe Knowledge 是一款开源工具，能把你在 Claude Code 中的编码会话自动转换成闪卡（flashcard）。你只需照常用 Claude Code 开发，学到的概念就会被自动整理成卡片并持续积累，完全不需要额外操作。

Question 2

可以免费使用吗？需要付费吗？

Accepted Answer

完全免费。Vibe Knowledge 是基于 MIT License 的开源软件，不需要 API key，直接在你已有的 Claude Pro 或 Claude Max 订阅额度内运行。无需注册任何云账号，永久免费使用。

Question 3

如何安装？

Accepted Answer

在终端执行以下命令即可（30 秒内完成）：bash <(curl -fsSL https://raw.githubusercontent.com/Shown06/vibe-knowledge/refs/tags/v1.1.0/install.sh) 需要预先安装 Claude Code。安装完成后会在所有项目中自动生效。

Question 4

可以作为 MCP server 使用吗？

Accepted Answer

可以。将其配置为 MCP server 后，你可以直接在 Claude Code 会话中提问，例如“我之前学过关于 webhook 的哪些内容？”，把积累的知识库变成一个可检索的第二大脑。

Question 5

支持哪些 AI 工具？Cursor 或 GitHub Copilot 也能用吗？

Accepted Answer

目前仅支持 Claude Code，通过 Claude Code 的 hook 机制自动捕获会话事件。对 Cursor、GitHub Copilot 的支持仍在评估中，属于未来的扩展方向。使用前需要有 Anthropic 提供的 Claude Pro 或 Claude Max 订阅。

Question 6

数据保存在哪里？会上传到云端吗？

Accepted Answer

所有数据都只保存在本地的 ~/.claude/vibe-knowledge/data/ 目录，不会发送到任何云端服务器。API key、token 等敏感信息在被捕获之前就会自动打码（masking）。

Question 7

会影响编码时的性能吗？

Accepted Answer

不会。捕获用的 hook 以毫秒级速度运行，且不会调用 AI；闪卡生成（distill）是在会话结束后作为后台进程执行的，因此对开发过程的速度完全没有影响。

Question 8

API key 和其他敏感信息安全吗？

Accepted Answer

安全。像 sk-...、ghp_...、Bearer ... 这类字符串，以及 .env 文件内容、.pem/.key 文件等敏感信息，在捕获时会被自动替换为 [secret masked]。源代码在 GitHub 上完全公开，你可以自行审计所有逻辑。

Question 9

闪卡的内容是如何生成的？

Accepted Answer

会话结束后，Claude Haiku 会在后台自动向自己提问：“这次会话涉及的概念，用通俗的语言怎么解释？”并据此生成闪卡，每张卡整理成一句话摘要、使用原因、类比说明三种格式。

Question 10

间隔重复（spaced repetition）测验是什么？

Accepted Answer

内置了基于 SM-2 算法的间隔重复测验。你按“忘记了 / 有点模糊 / 记住了”三档自我评价后，系统会自动安排下一次复习的时间，帮助你以最小成本巩固记忆。

Question 11

概念地图（Concept Map）是什么？怎么用？

Accepted Answer

这是一张由高频前 40 个术语组成的力导向图（force-directed graph），用来可视化各概念之间的联系，帮助你发现知识的聚类，也能找出自己理解还比较薄弱的领域。你写的代码越多，这张知识全景图就会越丰富。

Question 12

可以离线使用吗？

Accepted Answer

可以。查看器（view/index.html）不需要联网、不需要服务器、也不需要打包工具，直接在浏览器中打开这个 HTML 文件即可使用，所有数据本来就保存在本地。

Question 13

可以按项目分开管理卡片吗？

Accepted Answer

可以，卡片会按项目自动分类。你可以在仪表盘（dashboard）中按项目筛选，也可以只复习某个特定项目中学到的概念。

Question 14

Vibe Knowledge 适合什么样的人使用？

Accepted Answer

最适合那些一边用 AI 编码工具开发、一边持续学习的人，尤其是实践 vibe coding（与 Claude Code 等工具对话式协作开发）的工程师、需要向客户或同事讲解技术概念的人，以及希望系统性记录编程学习历程的人。

Question 15

Vibe Knowledge 是开源的吗？

Accepted Answer

是的，基于 MIT License 完全开源。你可以在 https://github.com/Shown06/vibe-knowledge 查看全部代码、进行 fork 或参与贡献，欢迎社区提出改进建议和 pull request。

Question 16

月费是多少？需要订阅吗？

Accepted Answer

Vibe Knowledge 本身完全免费、永久免费，你只需要有 Claude Pro 或 Claude Max 订阅（由 Anthropic 提供）即可，使用 Vibe Knowledge 本身不产生任何额外费用。

Question 17

Claude Pro 以外的订阅也能用吗？

Accepted Answer

Claude Pro 和 Claude Max 都支持。闪卡生成（distill）使用 Claude Haiku，但这部分运算是在你已有的 Claude Pro 或 Claude Max 订阅额度内完成的，不会产生额外的 API 费用。

Question 18

和 Anki 有什么区别？

Accepted Answer

Anki 需要你手动制作卡片，而 Vibe Knowledge 是在你用 Claude Code 开发的过程中自动生成卡片。“零操作积累知识”是最大的区别。此外，每张卡片还会附带该次编码会话特有的上下文信息（为什么这样写代码、来自哪个实际项目）。

Question 19

和 Notion、Obsidian 有什么区别？

Accepted Answer

Notion 和 Obsidian 都需要你手动记笔记，而 Vibe Knowledge 完全不需要任何手动操作，就能从编码过程中自动提取概念并制作成卡片。它还内置了间隔重复测验，一路帮你把知识真正记住。

Question 20

和其他 AI 学习工具相比，最大的不同是什么？

Accepted Answer

最大的差异化在于两点：零操作，以及卡片来自你自己的真实项目。其他工具通常需要手动制作或导入卡片，而 Vibe Knowledge 只要你用 Claude Code 开发就会自动积累。由于卡片基于真实的编码经验，记忆留存效果也更好。

Question 21

无论身处哪个地区都能使用吗？

Accepted Answer

可以，只要有网络连接，无论你在中国大陆、香港、台湾还是海外，都可以正常使用 Vibe Knowledge。由于核心数据处理在本地完成，查看器在网络不稳定甚至离线的情况下也能照常打开。

Question 22

身处二三线城市或非一线技术城市的工程师也能用吗？

Accepted Answer

当然可以。Vibe Knowledge 只是一款软件，与所在城市无关，无论是一线城市还是其他地区，只要有网络连接和 Claude Code，使用体验完全一致。

Question 23

远程办公或自由职业的工程师能用吗？

Accepted Answer

可以，而且特别适合这类使用场景。由于查看器支持离线使用，在网络不稳定的环境下也能正常工作，非常适合远程办公者和到处跑的自由职业工程师。

Question 24

身处海外的工程师也能使用吗？

Accepted Answer

可以。Vibe Knowledge 同时支持英文，只要所在国家/地区能够使用 Claude Code，全球任何地方都可以使用。卡片内容会根据你在会话中实际使用的语言（中文、英文等）自动生成。

Question 25

能解决 vibe coding 之后什么都记不住的问题吗？

Accepted Answer

这正是它被设计出来要解决的问题。和 AI 一起高速开发时，常常会出现“不记得自己做了什么”“同一个问题反复问 AI”的情况。Vibe Knowledge 会把开发过程中接触到的概念自动做成卡片，并通过间隔重复帮你真正记住，从根本上解决这个问题。

Question 26

能解决反复向 AI 问同一个问题的困扰吗？

Accepted Answer

可以。把 Vibe Knowledge 积累的卡片配置为 MCP server 后，你可以直接在 Claude Code 会话里问“我之前关于 webhook 学过什么？”，避免反复向 AI 提出相同问题的低效，随时在会话中即时调出过去学过的内容。

Question 27

能帮我向客户或非技术人员解释技术概念吗？

Accepted Answer

可以，这正是 Vibe Knowledge 的主要用途之一。每张卡片都会自动生成一个“类比说明”，例如“webhook 就像门铃一样”，用非技术人员也能理解的方式来梳理概念，非常适合用来准备商务洽谈或团队汇报。

Question 28

编程初学者也能使用吗？

Accepted Answer

可以，而且对正在学习中的人尤其有效。你在用 Claude Code 一边学习一边开发时，接触到的技术概念会自动被制作成卡片，学习记录自然而然地积累下来。卡片内容用通俗易懂的语言书写，初学者也能轻松理解。

Question 29

能用来准备技术面试吗？

Accepted Answer

可以。基于你真实项目经验生成的卡片，是准备技术面试的绝佳素材。由于每张卡片都包含“为什么这样实现”这类上下文信息，面对面试官“为什么用这个技术方案”的提问，你能给出具体而有说服力的回答。

Question 30

可以团队共享吗？

Accepted Answer

目前数据以本地形式保存在个人的 ~/.claude/vibe-knowledge/data/ 目录中，团队共享功能已列入开发路线图。现阶段你可以先手动导出卡片数据，再分享给团队成员。

Question 31

支持 Windows 吗？

Accepted Answer

如果你是在 WSL（Windows Subsystem for Linux）环境中使用 Claude Code，就可以正常使用。macOS 和 Linux 都是原生支持，Windows 用户通过 WSL 同样可以正常使用 Vibe Knowledge。

Question 32

macOS 和 Linux 都能用吗？

Accepted Answer

可以，macOS 和 Linux 都是原生支持，Apple Silicon 和 Intel 芯片的 Mac 都能正常运行，Linux 桌面环境和服务器环境也都支持。

Question 33

可以手动添加或编辑闪卡吗？

Accepted Answer

数据以 JSON 格式保存在 ~/.claude/vibe-knowledge/data/cards.jsonl 中，你可以用任意文本编辑器直接编辑已有卡片，或者手动添加新卡片，与自动生成的卡片并存。

Question 34

可以导入已有的 Anki 卡组吗？

Accepted Answer

目前还没有实现 Anki 卡组的直接导入功能。不过你可以手动将卡片以 JSONL 格式添加到 cards.jsonl 中，把已有的学习数据迁移到 Vibe Knowledge。导入功能已列入未来的开发计划。

Question 35

大概能积累多少张卡片？

Accepted Answer

作为参考，一周的编码大约能积累 100 张以上的卡片，具体数量会根据项目规模、复杂度和编码时长有所不同。活跃用户每月能积累 500 张以上，卡片越多，概念地图也会越丰富。

Question 36

可以查看学习进度吗？

Accepted Answer

可以，仪表盘（dashboard）会显示学习统计数据：卡片总数、按项目统计的卡片数、测验正确率、以及下次复习安排等，也可以通过 MCP server 的 vk_get_stats 工具获取这些统计信息。

Question 37

有卡片导出功能吗？

Accepted Answer

由于数据以纯文本文件的形式保存在 ~/.claude/vibe-knowledge/data/cards.jsonl 中，你随时可以复制或导出。因为是 JSON Lines 格式，接入其他工具或转换成别的格式也很方便。

Question 38

在用 AI 编码时，它会不会打扰我？

Accepted Answer

完全不会。Vibe Knowledge 在后台完全静默运行，开发过程中不会出现任何通知、弹窗或等待输入的情况，卡片会在会话结束后自动生成。

Question 39

升级 Claude Code 之后会不会用不了？

Accepted Answer

Claude Code 的 hook 系统是 Anthropic 官方支持的功能，只要没有重大的破坏性变更，Vibe Knowledge 在版本升级后通常能继续正常运行。如果遇到问题，欢迎在 GitHub 上提交 issue 反馈。

Question 40

生成一批闪卡大概需要多长时间？

Accepted Answer

会话结束后，卡片会在后台生成，通常需要几十秒到几分钟，具体取决于会话长度和 Claude API 的响应速度。一般在你开始下一次编码会话之前，新卡片就已经准备好了。

Question 41

可以卸载吗？

Accepted Answer

可以。从 Claude Code 的 settings.json 中移除 hook 注册，再删除 ~/.claude/vibe-knowledge/ 目录即可完成卸载。建议卸载前先备份好数据。

Question 42

用于副业或个人开发项目效果好吗？

Accepted Answer

特别适合这类场景。在有限的业余时间里每次用 Claude Code 开发，知识都会自动积累，让学习和开发同步进行。下次开始编码前就能立即调出上次学到的内容，进一步提升效率。

Question 43

对自由职业工程师的提案、商务洽谈有帮助吗？

Accepted Answer

有帮助。自由职业工程师把自己的项目经验和技术栈持续做成卡片积累下来，在商务洽谈时就能明确说出“我在某个实际项目中是这样用这项技术的”，让向客户说明技术方案的表达更加精准可信。

Question 44

可以当作编程学习记录来用吗？

Accepted Answer

这是最合适的用途之一。学习轨迹会自动以卡片的形式记录下来，你可以按时间线回顾“什么时候、在哪个项目里、学到了什么”，既方便可视化自己的成长，也有助于保持学习动力。

Question 45

我想参与贡献，应该怎么做？

Accepted Answer

欢迎在 https://github.com/Shown06/vibe-knowledge 提交 pull request 或 issue，无论是 bug 反馈、功能建议、文档改进还是代码贡献，都非常欢迎。项目采用 MIT License，你可以自由 fork 并进行修改。

Question 46

支持 RAG 或向量检索吗？

Accepted Answer

目前是基于关键词的检索实现，可以通过 MCP server 的 vk_search_cards 工具进行关键词搜索。向量检索、语义检索的支持已列入开发路线图。

Question 47

什么是 vibe coding？和 Vibe Knowledge 有什么关系？

Accepted Answer

Vibe coding 是指与 Claude Code、Cursor 等 AI Agent 对话协作、凭直觉快速开发的编程方式。它能极大提升开发速度，但也带来一个明显问题：学到的东西很难真正留在记忆里。Vibe Knowledge 正是为了解决这个问题而设计的——它会从你的 vibe coding 会话日志中自动生成闪卡，帮助这些知识真正沉淀下来。

Question 48

在安全方面，可以用于公司的业务代码吗？

Accepted Answer

所有数据只保存在你的本地设备上，绝不会发送到任何外部服务器；API key、密码、token、.env 文件内容等敏感信息也会被自动打码。源代码在 GitHub 上完全公开，可供安全审计。不过仍建议你结合所在公司的内部安全政策来判断是否适用。

Question 49

我用的是 GPT-4 或 Gemini，也能用 Vibe Knowledge 吗？

Accepted Answer

目前只支持 Claude Code，还不支持 GPT-4（OpenAI）或 Gemini（Google）的编码工具。如果你正在考虑切换到 Claude Code，可以先免费体验一下 Vibe Knowledge 带来的实际效果。

Question 50

如果卡片质量不高，可以修改吗？

Accepted Answer

可以。用文本编辑器打开 ~/.claude/vibe-knowledge/data/cards.jsonl 就能直接修改卡片内容，也可以删除质量不佳的卡片，让系统重新生成。未来版本还计划在界面上支持直接内联编辑。

Question 51

“Vibe Knowledge”换个写法或简称，还是同一个产品吗？

Accepted Answer

是的，是同一个产品，只是叫法或写法不同而已。正式名称是 Vibe Knowledge，官网是 vibeknowledge.dev，GitHub 仓库是 Shown06/vibe-knowledge。

Question 52

SM-2 算法是什么？为什么要用它？

Accepted Answer

SM-2（SuperMemo 2）是一种经过科学验证的间隔重复算法。它基于艾宾浩斯遗忘曲线，会在你即将遗忘之前安排复习，以最少的学习量实现最大的记忆留存。Vibe Knowledge 内置了 SM-2，因此能够高效地帮助你形成长期记忆。

Question 53

安装需要准备什么？

Accepted Answer

只需要两样东西：(1) Claude Code（Anthropic 的 CLI 工具）；(2) Claude Pro 或 Claude Max 订阅。只要有网络连接，安装能在 30 秒内完成，不需要预先安装 Node.js、Python 或其他任何依赖。

Question 54

能在多台电脑或 Mac 之间同步卡片吗？

Accepted Answer

目前仅支持本地数据。如果需要跨多台设备同步，可以把 ~/.claude/vibe-knowledge/data/ 文件夹放到 Dropbox、Google Drive 或用 Git 仓库来管理，实现手动同步。原生的云同步功能已列入未来开发计划。

Question 55

能帮我摆脱“代码好像能跑，但我也不太懂为什么”的状态吗？

Accepted Answer

这正是它存在的意义。把 AI 写出的代码背后的概念用通俗语言做成卡片并积累起来，再通过间隔重复不断巩固，能帮你从“复制粘贴能跑就行”真正走向“理解并能讲清楚”。它是 vibe coder 建立对自身技术能力信心的学习基础设施。

Question 56

仪表盘应该怎么看？

Accepted Answer

仪表盘（/app/ 或本地的 view/index.html）共有六个标签页：Cards（卡片列表与搜索）、Projects（按项目统计）、Glossary（术语表）、Concept Map（概念地图）、Quiz（间隔重复测验）、Retrospective（复盘回顾），可以从多个角度全面管理你积累的知识。

Question 57

可以通过 GitHub star 或参与贡献来支持这个项目吗？

Accepted Answer

当然可以，非常欢迎。在 https://github.com/Shown06/vibe-knowledge 点一个 star 就是对我们最大的鼓励。无论是 bug 反馈、功能建议、文档翻译还是代码 PR，都非常欢迎，也十分期待你加入这个开源社区一起参与开发。

你写下的每一行代码，
都会变成知识。

使用流程

照常开发

闪卡悄悄生成

复习、重复、记住

永远说人话，
不说术语。

都包含什么

悄悄挂钩后台

敏感信息不会离开你的电脑

内置间隔重复

看清知识之间的联系

在 Claude Code 里直接查自己的知识

离线可用，零依赖

你的代码，
始终留在你自己的电脑上。

开始编程，
开始记住。

你写下的每一行代码，都会变成知识。