OpenCode + Obsidian 本地知识库：能用，但“完全免费、装完即用”已经不准确
这个组合很吸引人：Obsidian负责本地Markdown笔记，OpenCode负责AI，再装一个插件，把AI直接嵌进侧栏。 AH-0046给出的方案方向成立，但到2026年8月，有几个细节必须修正。 ## 先把名字弄对 原文给出的仓库是 mtymek/opencode-obsidian。 重新核验GitHub后，仓库仍存在、未归档，许可证是MIT。README明确写着：这是第三方OpenCo
OpenCode + Obsidian 本地知识库：能用，但“完全免费、装完即用”已经不准确
这个组合很吸引人：Obsidian负责本地Markdown笔记，OpenCode负责AI，再装一个插件，把AI直接嵌进侧栏。
AH-0046给出的方案方向成立，但到2026年8月，有几个细节必须修正。
先把名字弄对
原文给出的仓库是 mtymek/opencode-obsidian。
重新核验GitHub后，仓库仍存在、未归档，许可证是MIT。README明确写着：这是第三方OpenCode plugin for Obsidian，作者不隶属于OpenCode或Obsidian。
安装条件比原教程多一个关键项：Bun
当前README要求：Obsidian Desktop、OpenCode CLI、Bun。普通用户推荐通过BRAT安装beta插件。
原教程写了Node、OpenCode、Obsidian和BRAT，却没有把Bun列入当前前置条件。对Windows用户，这不是小细节。
“笔记本地”是真的，“AI处理完全本地”不一定
Obsidian的Markdown文件可以保存在自己的磁盘上，这很重要：可迁移、可备份、不被单一知识库平台锁死、任何文本工具都能读取。
但如果OpenCode连接的是云端模型，选中的笔记或上下文仍可能被发送给模型provider处理。
所以这两句话完全不同：我的笔记文件存本地；我的AI推理从不离开设备。
第一句可以成立。第二句取决于本地模型/云模型、provider的数据政策和插件实际注入的上下文。
“完全免费”也要拆开
OpenCode是开源Agent，但模型推理来自不同provider。当前OpenCode流程会让用户连接provider，再查看实际可用模型。
某个阶段、某个provider、某个模型可以有free档，但不等于安装OpenCode以后永久拥有无限免费模型。模型目录、免费额度和provider政策都是动态事实。
这个插件现在适合装吗？
适合愿意排错的人尝试，但不能把beta状态藏起来。
当前GitHub Issues里能看到很具体的问题：Windows通过npm全局安装OpenCode后，插件可能找不到 opencode.cmd；中文/CJK vault路径存在编码问题报告；某些版本有server health检查问题；会话恢复逻辑仍有人提出改进需求。
这就是为什么开源教程不能只看README happy path。真正研究还要看Issues。
更稳的安装顺序
- 先装Obsidian并确认vault正常。
- 独立安装OpenCode并在终端跑通，确认provider和模型可用。
- 安装Bun。
- 通过BRAT安装
mtymek/opencode-obsidian。 - 首次只用十几篇无敏感信息的测试vault，验证启动、读取、写入、Windows路径和会话行为。
- 再定义隐私边界：哪些目录允许AI读取？是否允许整库检索？使用云provider还是本地模型？
真正值得留下的是架构，不是“白嫖”
这个组合真正有价值的地方，是把知识资产和AI运行层分开。
Markdown属于你。AI模型可以换。插件可以换。
未来OpenCode不好用，你仍然能换其他助手，而不需要先把知识从封闭数据库里搬出来。
本地优先的数据格式 + 可替换AI执行层，比“省20美元订阅”更有长期意义。