如何积累你的个人方法库：learn-from-materials 方法卡索引、检索与比较完整教程

为什么你需要一个"个人方法库" 📚

learn-from-materials是一个把 PDF、书籍、论文等资料转化为可追溯、可测验、可做笔记的学习网页的开源工具。除了生成学习页，它还内置了一套跨材料的方法库机制：每读完一份材料，工具会把其中可复用的方法论提取成方法卡（method card），再支持你把不同材料的方法卡建立跨材料索引、用中文关键词检索、并导出两张卡的比较记录。

下面用一条"提取 → 索引 → 检索 → 比较"的主线，带你从零搭建自己的方法库。

一、先认识方法卡：每个方法 8 个关键维度 🗂️

方法卡保存在每份材料知识库根目录的methods.json中（如 methods-demo.learnkb/methods.json），每张卡包含：

工具会同时自动生成一份人类可读的patterns.md（见 patterns.md），方便直接浏览卡片内容；没有可复用方法的材料会如实标记status: "none"，不会强行编造卡片。

二、构建跨材料方法库索引：两条命令搞定 🚀

当你已有多份材料的知识库后，只需运行索引命令，工具会把各库的methods.json快照合并进一个method-index.json（不修改原知识库）：

# 首次：把多个材料的方法文件合并为索引 python3 scripts/methods.py index book-a.learnkb/methods.json book-b.learnkb/methods.json --output method-index.json # 增量：新材料接入已有索引，生成新版本索引 python3 scripts/methods.py index new-book.learnkb/methods.json --previous method-index.json --output method-index-next.json

索引中的每张卡以libraryId/id@version为键（示例见 method-index.json），并记录内容 SHA-256 哈希。几个值得记住的机制：

• 旧版本不会被静默覆盖：内容或证据变化时递增版本号，新旧快照可同时共存于累积索引
• 同 ID 同版本的冲突快照会被拒绝，而不是悄悄替换
• 综合方法必须有血缘：跨材料合成的新卡需带evidence: "synthesis"和至少两个版本化的父方法引用

三、中文关键词检索方法卡：像查字典一样找方法 🔍

python3 scripts/methods.py search --index method-index.json --query "问题边界" --limit 10

检索基于tags、名称、摘要等字段做确定性关键词匹配，同时支持英文单词和中文双字组合。两个实用提醒：

• 支持中英文混查，例如--query "problem boundary"或--query "问题边界"
• "没搜到"只表示没有关键词命中，不代表库中没有相关方法；拿到候选后要人工阅读卡片，核对前提与适用边界

四、比较与综合：同名方法不等于同一方法 ⚖️

python3 scripts/methods.py compare --index method-index.json library-a/map@1.0.0 library-b/map@1.0.0 --output comparison.json

compare会把选中的卡片导出供你逐维度对比：目的、前提、步骤顺序、输入输出、检查项、证据与限制。分析时建议区分三种关系：

• 等价方法：保留各自独立的版本化身份与全部出处，记录等价而非抹掉来源
• 互补方法：设计成有序工作流，写清每个交接点、假设与失败条件
• 冲突方法：保留分歧与各自适用条件，不要强行统一

当你确实要做"综合"时，请创建新卡：新 ID、evidence: "synthesis"、至少两个父方法引用，并放入独立的派生方法集——索引会拒绝未解析的父引用和循环引用。

五、把方法库养好的 3 个习惯 ✅

1. 保持 tags 用你自己的话：tags 是检索入口，写"止损""复盘"这类你会实际输入的词，比写学术术语更好用
2. 材料更新后重新校验：索引建卡时不做二次核验；原文内容哈希变化后，应用候选方法前先回到原知识库核对引文
3. 让比较记录留档：comparison.json导出到方法库旁边，下次材料升级时可以直接对比新旧版本差异

从第一份材料的方法卡，到跨材料的索引与比较，这套流程全部离线完成、无需网络。完整的协议说明见 method-library.md，演示效果可打开 methods-library-demo.html 查看绑定方法库后的学习页。