claude-obsidian 的 LYT 原子笔记模板实战指南从一屏笔记到 MOC 互联知识图谱【免费下载链接】claude-obsidianSelf-organizing AI second brain for Obsidian Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathys LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian导读本文以 claude-obsidian 仓库中的 LYT 原子笔记模板 为骨架系统讲解在 LYTLinking Your Thinking方法论模式下如何创建一张合格的原子笔记从前置元数据frontmatter逐字段解析到一个想法、一屏容纳的拆分原则再到通过 Sources 证据链与 See also 关联链把笔记接入知识图谱。同时结合 wiki-mode 技能、路由脚本 与 方法论模式指南 的源码实现说明笔记为什么平铺在wiki/notes/、MOC 为什么只是导航枢纽并给出可复制的模式切换与路由预览命令。读完你将掌握 LYT 模式下的笔记规范、模板字段语义以及 claude-obsidian 如何把模板约束落实为可校验、可审计的归档路径。一、模板速览一份完整的 LYT 原子笔记长什么样仓库中 atomic-template.md 是 LYT 模式创建新概念笔记时的结构蓝本全文如下占位符以{{...}}标记创建时由 Agent 或用户填充--- type: note title: {{title}} status: seed created: {{date}} updated: {{date}} tags: - note mocs: - [[{{primary-moc}}]] --- # {{title}} (One atomic idea, claim, or observation. Should fit on one screen; if it grows past that, split into two notes and link them.) ## Sources - [[{{source-1}}]] - (external citation, if any) ## See also - [[{{related-note}}]]模板极短但每一行都是方法论约束YAML 前置区声明这张笔记是什么、处于什么状态、挂在哪个 MOC 下正文区强制要求一个想法 来源证据 相关链接。下面逐层拆解。二、Frontmatter 字段级解析type: note声明笔记类型。claude-obsidian 的页面 schema 将 wiki 内的页面分为 source、entity、concept、session、question 等可路由类型见 scripts/wiki-mode.py 中对VALID_TYPES的定义而 LYT 原子笔记统一使用note类型——因为在 LYT 模式下无论内容源自文献、人物还是概念最终都以原子笔记的形态平铺归档不再按来源类型分目录。title: {{title}}与# {{title}}标题在 frontmatter 与正文 H1 中重复出现这是 Obsidian 生态的惯例frontmatter 中的title供插件、索引与检索使用正文 H1 供阅读与图谱展示。标题建议直接陈述这一页的原子观点例如Source-grounded notes而不是笔记。status: seed状态机字段模板默认seed种子。示例仓库中的 Source-grounded notes 示例 则使用了evergreen长青状态。这暗示一条生命周期路径seed刚播下、待打磨→ 迭代 →evergreen成熟、可长期引用。created/updated两个时间戳与之配合构成最简单的成熟度审计线索。tags: [note]模板默认只打note一个标签。建议按需补充主题标签如#compounding、#claude但不要为了分类而堆叠标签——LYT 的导航主要靠 MOC 链接而非标签树。mocs: [ [[{{primary-moc}}]] ]这是 LYT 模式最具辨识度的字段每张原子笔记必须声明自己归属于哪个 Map of Content内容地图。它与正文的## See also一起构成向上导航与平级关联两张网。注意mocs是复数列表一张笔记可以挂在多个 MOC 下但模板建议至少有一个primary-moc主 MOC避免孤儿笔记。三、正文结构原子性、证据与关联一个想法一屏容纳模板正文第一行的注释是 LYT 的核心纪律One atomic idea, claim, or observation. Should fit on one screen; if it grows past that, split into two notes and link them.即一张笔记只承载一个原子想法、论断或观察一旦内容超过一屏就应该拆成多张笔记并用双链连接。这与 Zettelkasten 的每卡一思一脉相承但 LYT 用可在一屏内阅读作为更可操作的判定标准。拆分的产物之间通过## See also建立显式链接保证拆分不破坏知识的连通性。## Sources证据链[[{{source-1}}]]指向仓库内已归档的源笔记如wiki/sources/下的文献页把观点与出处绑定这正是 claude-obsidian 强调的source-grounded来源扎根原则——示例笔记 Source-grounded notes 就声明a note states what its evidence supports and links back to [[Example Source]](external citation, if any)是外部引用的占位符说明该笔记允许保留站外出处标注但仓库以内部双链为首要证据形式。## See also相关链接列出与该笔记密切相关的其他笔记{{related-note}}。与mocs向上挂靠不同See also表达的是平级或跨簇关联二者共同织成图谱中的边。四、模板背后的方法论为什么笔记平铺、MOC 只是枢纽wiki-mode 技能 的模式路由表对 LYT 的定位是一句话lyt— Atomic notes underwiki/notes/, connected through MOCs.原子笔记放在wiki/notes/下通过 MOC 连接。配套的 moc-template.md 用引言把这一设计讲得更透A Map of Content (MOC) links into a cluster of related atomic notes. It is a navigation hub, not a container. Notes are not stored under this MOC; they live flat underwiki/notes/and are reached by following these links.MOC 是指向一组相关原子笔记的链接枢纽不是容器。笔记并不存放在 MOC 之下而是平铺在wiki/notes/中通过链接抵达。这带来两个关键推论归档路径与逻辑结构解耦物理上所有原子笔记平铺在wiki/notes/逻辑上靠 MOC 组织主题簇。新增笔记永远只需平铺 挂 MOC两步不存在该放进哪个子目录的决策负担MOC 是可演化的导航层moc-template 的章节Why this MOC exists、Core notes、Adjacent MOCs、Open questions / frontier表明MOC 本身也是一张关于组织的笔记可以随知识簇的生长而增删链接甚至由Open questions反推出还缺哪些原子笔记。五、源码级落地路由如何保证一切进 notes/模板约束是纸面规范真正保证归档一致性的是 scripts/wiki-mode.py 中的路由逻辑。默认配置中的 LYT 目录在 DEFAULT_CONFIG 中LYT 模式只有两个文件夹键lyt: { moc_folder: wiki/mocs/, notes_folder: wiki/notes/, },对应的校验约束定义在 claude_obsidian/mode_config.pylyt: (moc_folder, notes_folder),validate_wiki_folder要求目录必须是wiki/下的规范路径、以/结尾、禁止绝对路径与..穿越mode_config.py从配置源头杜绝笔记被路由到 vault 之外的路径注入风险。路由函数类型无关的平铺route_path 中 LYT 分支的注释直接点明设计意图elif mode lyt: notes cfg[config][lyt][notes_folder] # All atomic notes flat in wiki/notes/; routing is the same regardless of type result notes _markdown_filename(slug)也就是说在 LYT 模式下source、entity、concept、session、question 等所有内容类型都路由到同一个wiki/notes/平铺目录文件名由内容名 slug 化而来。这与 Generic 模式按wiki/sources/、wiki/entities/、wiki/concepts/分类型归档形成鲜明对照——模板里的type: note正是这一路由策略的元数据印证。测试验证test_wiki_mode.py 中的test_lyt_routing明确断言def test_lyt_routing(): cfg dict(wm.DEFAULT_CONFIG) cfg[mode] lyt src wm.route_path(lyt, source, Karpathy essay, cfg) ent wm.route_path(lyt, entity, Andrej Karpathy, cfg) con wm.route_path(lyt, concept, Compounding Vault, cfg) assert_true(lyt source goes to notes/, src.startswith(wiki/notes/), hintsrc) assert_true(lyt entity goes to notes/, ent.startswith(wiki/notes/), hintent) assert_true(lyt concept goes to notes/, con.startswith(wiki/notes/), hintcon)三类不同来源的内容全部断言落在wiki/notes/下证明模板统一 路由统一不是文档口号而是被测试固化的行为契约。测试还覆盖了route --mode lyt source X的 CLI 预览即使 vault 当前处于 generic 模式也能用--mode参数预览LYT 路由结果而不写任何配置test_wiki_mode.py。六、实操把 vault 切到 LYT 模式并创建第一张原子笔记1. 查看当前模式python3 scripts/wiki-mode.py --vault vault get python3 scripts/wiki-mode.py --vault vault config无配置文件时默认generic属正常状态见 docs/methodology-modes-guide.md 的Missing config说明。2. 预览 LYT 路由不写入任何配置python3 scripts/wiki-mode.py --vault vault route --mode lyt concept Compounding Vault输出类似wiki/notes/compounding-vault.md。--mode仅用于预览不会改动.vault-meta/mode.json——这正是上面测试覆盖的行为。3. 通过事务切换模式模式切换是一次受审计的配置事务默认 dry-run。按 wiki-mode 技能 的流程# 第一步生成预览计划dry-run python3 scripts/claude-obsidian.py mode set lyt --vault vault \ --generated-at ISO-UTC时间戳 --operation-id mode-reviewed # 第二步审阅输出的 approved_plan_sha256 后应用同一计划 python3 scripts/claude-obsidian.py mode set lyt --vault vault \ --generated-at ISO-UTC时间戳 --operation-id mode-reviewed \ --approved-plan-sha256 审阅后的SHA256 --apply要点两次命令必须使用相同的--generated-at与--operation-id切换只影响未来新内容的归档去向不会批量建目录、移动旧笔记或改写既有双链docs/methodology-modes-guide.md 明确Bulk reorganization is a separate migration project。4. 按模板落笔以模板为骨架填充确定主 MOC 名称 → 填入{{title}}/{{date}}/{{primary-moc}}→ 用一两句话写下原子观点 → 在## Sources链接出处笔记 → 在## See also链接相邻笔记。若写作中发现观点超过一屏按模板注释拆成两张笔记并互相链接。5. 新模式下首笔操作后运行确定性 lint方法论模式指南 建议切换模式后的第一次写入用仓库的确定性 linterlint_engine 相关脚本校验新布局及早发现模板字段缺失或双链悬空。七、配套 MOC 模板给原子笔记一个家原子笔记的mocs字段要求它挂靠一张内容地图因此 LYT 模式的第二个模板 moc-template.md 与之成对使用。其结构为Why this MOC exists一段话说明该知识簇服务什么问题Core notes指向簇内核心原子笔记的链接列表Adjacent MOCs关联其他内容地图形成跨簇导航Open questions / frontier记录该簇尚未回答的问题反推还需要哪些原子笔记。创建流程建议先按 moc-template 建好主 MOC路由到wiki/mocs/再逐张按 atomic-template 创建原子笔记路由到wiki/notes/并在笔记的mocs中回指。如此往复图谱的边就自然生长出来。八、边界与注意事项模板是结构指引不是覆盖权wiki-mode 技能声明Use the templates undertemplates/as structural guidance, not authority to overwrite user conventions——模板约束字段语义与归档去向但不应机械覆盖用户已有的书写习惯LYT 模式不改变证据规则方法论模式是新笔记归档偏好不提升任何笔记的权威性、新鲜度或置信度docs/methodology-modes-guide.mdMode is organizational metadata, not evidence切换非迁移从 Generic/PARA 切到 LYT 后旧笔记原地不动新旧布局并存属预期状态真正的迁移必须作为独立项目规划包含完整 move map、链接改写计划、哈希校验与回滚方案路由是建议路由器输出的是建议路径技能可以基于用户更具体的项目/区域/MOC 覆盖之但最终写入必须经过一次操作事务operation transaction审计。结语LYT 原子笔记模板是 claude-obsidian 中内容形态与归档机制的接缝处模板把原子性、来源扎根、MOC 挂靠写进字段结构路由脚本把平铺归档固化为代码逻辑测试再把类型无关的 notes/ 平铺钉死为行为契约。读懂这一层你就同时掌握了模板用法、LYT 方法论在工程中的落地方式以及如何安全地在 vault 间切换方法论模式——这正是把 Obsidian 双链笔记库升级为自组织 AI 第二大脑的第一块基石。进一步阅读wiki-mode 技能、方法论模式指南、MOC 模板、路由脚本、路由测试。【免费下载链接】claude-obsidianSelf-organizing AI second brain for Obsidian Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathys LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考