核心用法
Foam Notes 是一套完整的个人知识管理工具链，基于标准 Markdown 文件和 [[wikilink]] 语法构建。该技能提供 10+ 个 Python 脚本，覆盖笔记生命周期的各个环节：从初始化模板、创建/重命名/删除笔记，到智能建议 wikilink 和标签、分析知识图谱结构、管理每日笔记。
关键工作流：
- 创建：
create_note.py从模板生成笔记，支持自定义目录 - 链接：
suggest_wikilinks.py自动识别可链接的文本，支持交互式或批量应用 - 发现：
find_backlinks.py和graph_summary.py揭示笔记间的隐含关系 - 组织：
search_tags.py、list_tags.py、suggest_tags.py构建多维度分类体系 - 维护：
rename_note.py自动更新全库引用，delete_note.py安全删除并修复断链
显著优点
1. 开放标准：纯 Markdown + wikilink，与 Obsidian、GitLab 等工具互操作，无厂商锁定
2. VS Code 原生：深度集成编辑器生态，利用 IntelliSense、Git、扩展市场
3. 智能自动化：suggest_* 系列脚本基于内容分析主动建议链接和标签，降低认知负担
4. 图谱能力：内置反向引用发现和可视化支持，促进意外知识连接（serendipity）
5. 可编程模板：支持 JavaScript 模板引擎，实现上下文感知的动态内容生成
潜在局限
- 依赖 VS Code：非 VS Code 用户无法使用 Foam 扩展功能，纯 CLI 脚本功能有限
- 插件生态弱：相比 Obsidian 数千插件，Foam 扩展性依赖通用 VS Code 扩展
- 无实时同步：需自行配置 Git 或其他同步方案，无内置端到端加密
- 移动端缺失：无官方移动端应用，依赖第三方 Markdown 编辑器
- 学习曲线：需要理解 wikilink、frontmatter、backlink 等概念才能发挥价值
适合人群
- 已在 VS Code 中工作的开发者、技术写作者
- 偏好开放文件格式、担心数据锁定的知识管理实践者
- 需要版本控制（Git）管理笔记历史的用户
- 希望从 Obsidian 迁移到更轻量、更开放工具的用户
常规风险
- 数据完整性：
rename_note.py和delete_note.py修改大量文件，建议配合 Git 使用；--force标志可能误操作 - 路径遍历：所有脚本接受
--foam-root参数，需验证路径合法性避免越权访问 - 模板执行：JavaScript 模板可能执行任意代码，需审查
.foam/templates/*.js来源 - 建议准确性：自动标签/链接建议基于简单文本匹配，可能产生误报，需人工审核
- 备份策略：
--backup仅移至.foam/trash/，非持久备份，重要数据需独立备份方案