如何通过 BRAT 安装 SurfSense Obsidian 插件并同步笔记库【免费下载链接】SurfSenseOpen-source NotebookLM alternative. Research the open web with live data(Reddit, YT, IG, TikTok, Indeed, Google Search, Maps etc) through one platform, API or MCP server. Join our Discord: https://discord.gg/ejRNvftDp9项目地址: https://gitcode.com/GitHub_Trending/su/SurfSenseSurfSense 通过一个运行在 Obsidian 内部的插件同步你的笔记库插件在 Obsidian 里监听笔记的创建、编辑、重命名和删除通过 HTTPS 把变更推送到 SurfSense云端SurfSense Cloud和自托管部署都适用桌面端和移动端行为一致。完成本文操作后你的.md笔记、frontmatter、[[wiki links]]、标签和 vault 路径元数据都会被索引进 SurfSense可以在任意 SurfSense chat 中与 GitHub、Slack、Linear 等其他知识源一起被检索。判断整体任务是否完成看 SurfSense 的Connectors列表中是否出现了名为Obsidian - lt;vault的连接器行。准备条件已装好 Obsidian桌面或移动端并已打开目标 vault。已有一个可用的 SurfSense 实例SurfSense Cloud或按仓库 docker 安装文档 / 手动安装文档 部署的自托管实例且 Obsidian 所在设备能通过网络访问到它的后端地址。一个 SurfSense API token。在 SurfSense Web 端可从Connectors → Obsidian对话框或User settings → API access创建个人访问 token文档同时提到在 user settings section 中粘贴 API token 完成插件配置。被索引的内容范围以插件文档为准内容类型说明Markdown files笔记内容.mdFrontmatter标题、标签、别名、日期等 YAML 元数据Wiki links笔记间链接[[note]]Tags行内标签和 frontmatter 标签Vault metadata用于深链和同步状态的 vault 与路径元数据通过 BRAT 安装插件推荐路径BRAT 是一个社区插件管理器SurfSense 插件目前没有进入官方社区商店文档推荐通过 BRAT 安装 beta 插件在 Obsidian 中打开Settings → Community plugins安装 BRAT插件 IDobsidian42-brat。打开 BRAT 设置点击Add beta plugin按钮。粘贴仓库地址https://github.com/MODSetter/SurfSense/仓库文档中同一仓库也写作MODSetter/SurfSense两者指向同一仓库。选择最新的插件版本点击 Add plugin。打开Settings → SurfSense确认出现 SurfSense 插件自己的配置面板即表示安装成功。如果 BRAT 路径不可用文档和 插件 README 还给出手动侧载sideload作为替代路径从打了插件版本 tag 的最新 GitHub release 下载main.js、manifest.json、styles.csstag 使用不带v前缀的版本号例如0.1.0与manifest.json中的version字段一致把三个文件复制到vault/.obsidian/plugins/surfsense/重启 Obsidian 并启用插件。官方社区商店的申请文档标注为 in progress暂时不能直接从商店安装。配置插件并触发首次同步在 Obsidian 中打开Settings → SurfSense按插件文档的设置表填写设置项值 / 说明Server URLSurfSense Cloud 填https://surfsense.com文档示例自托管填你的后端地址。文档提示如果你的 SurfSense 主域名启用了/api/v1重写也可以填主域名否则填直连的后端 URLAPI token上一步准备的个人访问 tokenSearch space / Workspace选择这个 vault 要同步进的目标 workspaceVault name默认取 Obsidian 的 vault 名称多 vault 用户可手动改名Sync modeAuto文档推荐或ManualExclude patterns要跳过的文件夹/文件的 glob 模式例如.trash、_attachments、templates/**Include attachments默认关闭开启后才会同步非.md文件填好 Server URL、API token 并选择 Workspace 后如果 Sync mode 为Auto首次同步会自动开始。验证同步成功SurfSense Web 端的Connectors列表中出现Obsidian - lt;vault连接器行这是成功条件。文档说明该连接器行会在插件首次成功调用/obsidian/connect时自动创建之后也可以在 Web 端Connectors → Obsidian中管理或删除它。多 vault 场景下每个启用了插件的 vault 都会成为 SurfSense 中独立的连接器行行名即 vault 名可按 vault 逐一核对。同步语义上插件会实时同步笔记的新建、编辑、重命名和删除启动时会做初始扫描并与服务器上的 manifest 对账因此插件离线期间对 vault 的修改在恢复后仍会被同步上传队列是持久化的崩溃或断网期间不会丢失变更。从旧版 Obsidian 连接器迁移如果你之前用的是旧版legacyObsidian 连接器架构文档给出的迁移顺序是在 SurfSense 中删除旧的 legacy Obsidian 连接器。按本文上面的步骤安装并配置插件。运行首次插件同步确认新的Obsidian - lt;vault连接器处于活动状态。文档对此有明确警告删除 legacy 连接器的同时会删除该连接器索引过的所有文档所以必须在插件同步完成并验证通过之后才去删除旧连接器。同步不出现文件或连接报错时检查什么Plugin connects but no files appear有连接但没有文件出现确认插件指向的 Workspace 正确从插件设置里手动触发一次同步确认 API token 有效且未过期。自托管 URL 问题使用 Obsidian 所在设备能访问到的公开或局域网后端地址实例位于 TLS 之后时确认 URL/证书对该设备有效。Unauthorized / 401 错误在 SurfSense 中重新生成并粘贴新的 API token确认 token 属于你正在同步的同一账户和 workspace。Cannot reach server URL确认后端地址从 Obsidian 设备可达自托管部署检查防火墙与反向代理规则除非 SurfSense 与 Obsidian 运行在同一台机器上否则避免使用 localhost。限制与下一步移动端iOS/Android可用但同步发生在应用处于前台期间以及应用关闭时再同步一次由于移动系统会激进挂起后台应用移动端同步接近实时但不是即时实时编辑以桌面端为准。笔记在 SurfSense 中按 note 存为文档行删除笔记时是软删除而非硬删除目的是让已有的 chat 引用继续有效。同步完成后笔记即可在 SurfSense chat 中与其他连接器一起被检索chat 中的引用会经由obsidian://open?vault…file…深链直接跳回 Obsidian 里对应的笔记。更多背景如插件上传了哪些字段、隐私边界可参考 Obsidian 连接器文档 和 插件 README。【免费下载链接】SurfSenseOpen-source NotebookLM alternative. Research the open web with live data(Reddit, YT, IG, TikTok, Indeed, Google Search, Maps etc) through one platform, API or MCP server. Join our Discord: https://discord.gg/ejRNvftDp9项目地址: https://gitcode.com/GitHub_Trending/su/SurfSense创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考