核心功能
Foam Notes 是一款在 VS Code 中运行的开源个人知识管理系统，采用标准 Markdown 文件配合 Wikilink 语法实现笔记互联。
显著优点
1. 数据完全自主可控：纯 Markdown 格式存储，不依赖私有数据库，笔记可无缝迁移至任何支持 Markdown 的工具
2. 双向链接与知识图谱：[[note-name]] 语法自动建立双向关联，内置图谱可视化功能帮助发现知识间的隐藏联系
3. 丰富的自动化脚本：提供 12+ 个 Python 脚本覆盖笔记生命周期——从创建模板、智能标签建议、Wikilink 自动补全到笔记重命名时的全库链接更新
4. 灵活的模板系统：支持 Markdown 和 JavaScript 双模板格式，可按变量动态生成笔记结构和元数据
5. 与 VS Code 生态深度整合：直接复用 Git、代码片段、远程开发等成熟功能，适合开发者工作流
潜在局限
1. 学习曲线陡峭：需要理解 Wikilink、Frontmatter、Backlink 等概念，非技术用户上手难度较高
2. 依赖 VS Code：必须在 VS Code 中操作，移动端体验缺失（对比 Obsidian 的跨平台原生应用）
3. 插件生态薄弱：相比 Obsidian 数千款插件，Foam 的功能扩展主要依赖 VS Code 通用扩展
4. 图谱功能基础：可视化能力较为简单，缺乏 Obsidian 的 3D 图谱、Canvas 白板等功能
适合人群
- 已深度使用 VS Code 的开发者和技术写作者
- 重视数据格式开放性、排斥封闭存储系统的用户
- 需要 Git 版本控制笔记的协作场景
- 希望笔记与代码项目同环境管理的用户
常规风险
- 手动配置 workspace 路径时可能误操作其他目录
--force和--auto-apply等批量操作标志建议在--dry-run预览后再执行- 笔记重命名/删除操作会级联修改其他文件，建议配合 Git 进行版本保护
使用建议
优先通过 init_templates.py 初始化工作空间模板，建立每日笔记习惯，善用 suggest_wikilinks.py 和 suggest_tags.py 自动化链接补全，定期使用 graph_summary.py 分析知识网络健康度。