Obsidian 插件：一键打开 Cursor 当知识库

Obsidian 管笔记，Cursor 管改文件、全局搜索和对着整库提问。两边其实对着同一套 Markdown 文件夹，差的是来回切窗口、在 Finder 里找库路径。那吒（maoxiaoke）写的 Open Obsidian To IDE 就干一件事：在 Obsidian 侧栏点一下电缆图标，把当前库当成项目打开到 VS Code、Cursor、Windsurf，或者你自己指定的编辑器。

仓库：maoxiaoke/open-obsidian-to-ide。插件清单里显示名是 Open in IDE，id 是 open-obsidian-to-ide，版本 1.0.0，MIT，要求 Obsidian ≥ 0.15.0，且 isDesktopOnly: true（手机用不了）。作者站：nazha.co。

为什么要把笔记库丢进 Cursor

Obsidian 库就是一个目录。Cursor 打开这个目录之后，笔记会进工作区索引：跨文件搜索、多文件改名、让 Agent 对着整库问「这篇和那篇怎么串起来」，都比在 Obsidian 里一块块复制要直接。常见用法是：日常还在 Obsidian 写、链、画脑图；要批量改结构、补代码块、或者让模型扫一遍知识库时，点一下进 Cursor。

它不做双向同步，Cursor 里也不会嵌一套 Obsidian 预览。点一下等于在本机执行一次「用指定编辑器打开这个 vault 路径」。README 写过「当前文件」，源码实际只取 vault.adapter.basePath，打开的是整个库，不会跳到你正在看的那一篇，也不会同步光标位置。

社区商店搜不到，怎么装

写到现在（仓库 2025 年创建，v1.0.0），作者明确说还没进 Obsidian 社区插件商店。设置里搜 Open in IDE 或 Open Obsidian To IDE 大概率没有这一只。商店里另有一个 Open in Cursor（awaken233），能开当前文件并跳光标，和这一只不是同一个项目，别装混。

GitHub Releases 目前是空的，仓库里也只有 main.ts，没有预编译的 main.js。BRAT 一般拉 Release 里的构建产物，对这个仓库多半装不上。官方路径就是自己 clone 再编译。

先在 Obsidian 设置，第三方插件，关掉受限模式，允许社区插件。
终端进库的插件目录：

bash

cd /path/to/your-vault/.obsidian/plugins
git clone https://github.com/maoxiaoke/open-obsidian-to-ide.git
cd open-obsidian-to-ide

进入该目录后，按仓库 README 安装 Node 依赖，再跑 package.json 里的 build 脚本（esbuild 生产构建）。成功后目录里应出现 main.js；没有这个文件时 Obsidian 加载会失败。本机需要已安装 Node.js。

重启 Obsidian。在第三方插件列表里启用 Open in IDE。侧栏会出现一根电缆图标（ribbon 用的是 cable）。

先改成 Cursor，再点图标

默认编辑器是 VS Code。要用 Cursor 得先改设置。点图标之前先打开设置里的 Open Obsidian To IDE。下拉框有四项：

VS Code（默认）：macOS 上执行 open -n -b com.microsoft.VSCode --args，后面跟库路径
Cursor：调用 cursor 命令，参数就是库路径
Windsurf：调用 /Applications/Windsurf.app/Contents/MacOS/Electron，加上库路径
Custom Command：你填的可执行文件，空格分隔的额外参数，库路径接在最后

选 Cursor 后点侧栏电缆，会先弹出 Notice，类似 Opening in cursor: 路径。插件给进程补了一段 PATH（含 /opt/homebrew/bin），并设置 VSCODE_CWD 为库目录。Cursor 需要已经装好命令行工具：在 Cursor 命令面板里找 Install cursor command in PATH。没装的话会失败，Notice 会让你去看开发者控制台。

自定义编辑器示例：想用 Zed，Command 填 zed（或绝对路径），Arguments 留空即可，库路径会自动跟在后面。路径里有空格时，插件会对特殊字符做转义。

目前只覆盖 macOS

README 写明：现在支持 macOS，Windows 和 Linux 还在路上。源码也按 macOS 在写：VS Code 走 open -b com.microsoft.VSCode，Windsurf 写死了 Applications 下的路径。Windows 上这套命令跑不通。桌面端以外的 Obsidian（平板、手机）会被 isDesktopOnly 挡住。

其他限制也值得提前知道：

没有命令面板命令。onload 只注册了 ribbon 和设置页，没有 addCommand。不能给打开 IDE 绑快捷键，只能点侧栏图标。
一次只开一个编辑器。下拉框是单选，要换就改设置再点。
失败时看控制台。退出码非 0 会 Notice 一句 Error opening in 对应编辑器。常见原因：没装对应 CLI、Windsurf 不在默认路径、自定义命令空着。
不要当同步工具。两边同时改同一篇 Markdown，冲突还是文件层面的事。Obsidian 开着时 Cursor 写盘后会刷新，这是文件系统行为，不是插件做的。

和「在 Cursor 里当知识库」怎么配合

插件只负责开门。进了 Cursor 之后，自己决定怎么用这堆笔记：

把库根目录当工作区，必要时加一个 .cursorignore，把 .obsidian 目录、附件大图、同步冲突文件排除掉，少干扰索引。
提问时点名文件夹或用 @ 带上某篇，比「你自己看整个库」稳。
改完结构（文件名、双链、模板）再回 Obsidian 看图谱和反向链接；图谱、Dataview 还是 Obsidian 的强项。

源码和 issue 都在 GitHub。商店上架、跨平台、打开当前文件这些，得看作者后续发不发 Release。现在能用的就是：macOS 上编译一次，设置里选 Cursor，点电缆。

点了没反应时先查这几处

电缆图标点了没打开，先看 Obsidian 右上角 Notice，再开开发者工具看报错。按源码，失败几乎都出在 spawn 那一步：

设置还停在 VS Code，却以为会开 Cursor。改完下拉框不用重启，再点一次即可。
cursor 命令不在 PATH 里。终端里先执行一次 cursor --version，不通就回 Cursor 里装 CLI。
Windsurf 没装在 /Applications/Windsurf.app。换路径的话，改用 Custom Command，把可执行文件写进去。
插件开关开了但侧栏没有电缆：确认不是在手机或平板上；桌面端重启一次，并看 .obsidian/plugins/open-obsidian-to-ide 里有没有编译出来的 main.js。

这一只插件的定位很窄：少一次手找路径。知识库怎么索引、怎么提问，还是进 Cursor 之后的事。