前阵子有同学说让我介绍下 Obsidian，我说近期没有这个计划。

不过想了下，最近产出的文章、视频、skill 越来越多，确实需要 Obsidian 这类工具来管理了。之前试过 ima，用起来还行，但就是无法真正喜欢上。折腾的性格摆在那——我还是更适合 Obsidian 这种更自由的工具。

所以接下来会新开一个系列，把自己学习和使用 Obsidian 的经验教训总结出来。这篇是第一篇，先讲清楚 Obsidian 是什么、跟 AI 工具怎么接，后续再深入具体配置和工作流。希望对有同样需求的同学有帮助。

Obsidian 是什么

一个本地优先的笔记软件，纯粹、快、离线也能跑。

它的核心概念叫 vault，说白了就是你电脑上一个普通文件夹。你在 Obsidian 里创建的所有笔记、图片、附件都放在这个文件夹里，每个 .md 文件就是一篇笔记。数据全部存成纯文本 Markdown 文件，不锁格式。

文件夹就是你的知识库。你哪天不想用 Obsidian 了，直接用 VS Code 打开 vault 文件夹也能读全部笔记。你哪天不想用 Obsidian 了，直接用 VS Code 打开文件夹也能读全部笔记。obsidian.md 现在是这个领域最主流的工具之一，GitHub 上社区插件列表仓库有 18.7k stars，生态很大。

核心能力其实不多：

Markdown 编辑。支持 Obsidian Flavored Markdown——也就是标准 Markdown 上加了特制语法（wikilinks 的双链 [[]]、embed、callout 块、properties 元数据这些）。写起来比纯 Markdown 顺手，但不锁格式。

本地优先。所有笔记存在你本地文件夹里，不经过任何云端。同步通过 iCloud / Sync / Git 自己选。

插件系统。社区插件超过 4700 个，从日历到看板到 AI 什么都有。插件用 HTML + CSS + JS 写，开发者够友好。

Graph View / 双向链接。这是 Obsidian 打出名气的东西——笔记之间通过 [[]] 链接后，能自动生成关系图谱。虽然说实话日常写作用到的次数不多，但偶尔看看还挺有意思。

AI 接入：OpenCode + Obsidian

目前 Obsidian 跟 AI 工具对接最直接的方案，是把 OpenCode 嵌到 Obsidian 里。

mtymek/opencode-obsidian 这个插件做的就是这件事（GitHub 上 985 stars）。它在 Obsidian 侧边栏里嵌入 OpenCode 的 Web 界面，等于你的笔记工具里直接跑了一个 OpenCode。

安装前提：OpenCode CLI 已安装 + Bun 已安装。

装法分两种情况：

普通用户（推荐用 BRAT）：先从社区插件商店装 BRAT（Beta Reviewers Auto-update Tool），然后在 BRAT 设置里添加 mtymek/opencode-obsidian，装完启用就行。BRAT 会自动检查更新。

开发者手动装：把仓库克隆到 vault 目录下的 .obsidian/plugins/obsidian-opencode/，然后 bun install && bun run build，再到 Obsidian 设置里启用。

装完之后：

• 点击侧边栏的终端图标，或者按 Cmd/Ctrl+Shift+O 打开面板
• OpenCode 的服务会在你打开面板时自动启动
• 可以在设置里改端口、主机名、是否自动启动

you 可以直接在面板里让 OpenCode 读当前笔记、做摘要、改写内容、生成提纲。插件还支持把当前打开的笔记和选中文本作为上下文注入到 OpenCode 里——虽然目前还是实验功能，新建会话时可能不生效，但日常工作够用。

Windows 注意

如果在 Windows 上 OpenCode 提示找不到 opencode 命令，需要手动设置路径。先运行 where opencode.cmd 找到完整路径，然后填到插件设置里：C:\Users\{用户名}\AppData\Roaming\npm\opencode.cmd。原因是 Electron 和 Obsidian 在 Windows 上不会完整继承系统的 PATH 环境变量。

我目前的工作流

说下我现在的用法。

日常笔记用 Obsidian 写，项目文档也放 vault 里——架构设计、API 文档、踩坑记录都扔进去。

写代码的时候用 OpenCode，装了 opencode-obsidian 插件后，侧边栏直接拉起来就能用。遇到新需求先在 Obsidian 里写个笔记想清楚，然后转到旁边面板让 OpenCode 执行。需要参考之前写的设计文档时，OpenCode 可以直接读 vault 里 Markdown 文件的内容。

整理笔记的时候也用它——选中几段散落的笔记扔给 OpenCode，让它整理成结构化的文档。不用切窗口，不用复制粘贴，全在 Obsidian 里搞定。

装还是不装

如果你主要用 OpenCode 写代码、同时在 Obsidian 里做笔记，opencode-obsidian 能省掉来回切窗口的麻烦。

如果你不写代码、只用 Obsidian 做知识管理，那装不装区别不大——社区里那些 AI 写摘要、做标注的插件可能更适合你。

评论区聊聊你现在用 Obsidian 跟什么 AI 工具接，踩过什么坑。如果你有什么想让我在后续文章里写的，也直接说。

聊聊你现在用 Obsidian 跟什么 AI 工具接，踩过什么坑。