零成本使用Obsidian和OpenCode搭建本地知识库

前提需要安装node

第一步：装 Node.js

输入：

node -v
1.如果显示版本号，说明你装过了，直接跳过。

如果没有，去  https://nodejs.org 下载安装包，一路下一步就行。

第二步：装  OpenCode
终端输入：npm install -g opencode-ai

装完之后，输入  opencode 进入界面。

输入 /models，你会看到几款可用的模型。

第三步：装 Obsidian
去  https://obsidian.md 下载安装。

第四步：装 BRAT 插件
这一步和下一步是关键。跟着做就行。

Obsidian 左下角 → 设置 → 第三方插件 → 关闭安全模式。

点击「社区插件市场」→ 搜索 BRAT → 安装 → 启用。

BRAT 是什么？你可以把它理解成一个「插件商店的plus版」。Obsidian 官方商店里的插件是审核过的正式版，但有些好用的插件还在测试阶段，没进官方商店。BRAT 就是用来装这些测试版插件的。

第五步：装 OpenCode-Obsidian 插件
点开 BRAT 插件的「选项」→ 往下滑 → 点击「Add Beta Plugin」。

输入这个地址：https://github.com/mtymek/opencode-obsidian
1.点「Add Plugin」，等它装完。

踩坑：

如果你看到 "Executable not found at 'opencode'" 尽管 opencode 已经安装：

1. 查找你的opencode.cmd路径：

   where opencode.cmd

2. 在插件设置中配置完整路径：

   C:\Users\{username}\AppData\Roaming\npm\opencode.cmd

这是由于Electron/Obsidian在Windows上没有完全继承PATH。

解决方案如下：

1、回到 Obsidian 的设置界面，开启​ Use custom command 旁边的开关

2、修改 Custom command

您需要将 Custom command 的内容替换为一条完整的启动命令。

请注意，由于您使用的是 Windows 系统，Obsidian 底层调用的是 CMD 命令提示符。在 Windows 环境下，最稳妥的写法是将 Custom command 直接设置为以下完整字符串（请务必核对路径与您截图中 where 命令查到的一致）：

"你的opencode.cmd路径" serve --port 14096 --hostname 127.0.0.1 --cors app://obsidian.md

为什么后面要加一长串参数？

• serve: 这才是告诉 OpenCode “我要启动一个本地 Web 服务”的关键指令 。

• --port 14096 和 --hostname 127.0.0.1: 确保服务器的端口和地址，与 Obsidian 设置面板里填写的完全一致 。

• --cors app://obsidian.md: 这是极其重要的一步，它允许 Obsidian 的网页界面跨域访问这个本地服务，否则嵌入侧边栏会一片空白 。