Dedao Brain Sync

最好用的 【得到大脑 🔄 Obsidian】 插件

中文 | English

把得到大脑（原Get笔记）里的灵感、摘录、链接、录音和 AI 总结与 Obsidian 双向同步，变成可长期整理、搜索和链接的本地 Markdown 知识库。

想了解这个项目的由来和背景，可以阅读这篇文章：为什么要做得到大脑 Obsidian 插件。

---

🎉 1.4.4 最新更新

• 🧭 完整设置入口更准确：只有从左侧栏“同步得到大脑”打开按时间同步面板时，才显示“打开完整设置”；从设置页或命令面板进入时不再出现重复入口。

1.4.3 及更早版本的核心改进仍在生效（按创建日期整理、部分失败状态、知识库同步和安全写入等）。

README 仅保留当前版本的核心亮点；完整版本历史请查看 GitHub Releases。

---

为什么好用

• 真正双向同步：从得到大脑拉取笔记到 Obsidian，也可以手动选择本地 Markdown 上传到得到大脑。
• 不是一次性导出：官方导出是离线 HTML；本插件把笔记同步成独立 Markdown 文件，并在后续同步中持续更新。
• 同步稳定可续传：支持增量同步、按时间同步、按笔记同步、按知识库同步、定时同步、启动时同步和同步断点。
• 过滤器更丰富：可按更新时间、同步起始日期、最大天数、笔记类型、标签、手动选择的笔记或知识库范围控制本次同步。
• 两种鉴权模式：PRO 用户可用 OpenAPI 鉴权长期稳定同步；也支持临时鉴权复用网页版会话快速试用。
• 详尽同步日志：保留最近同步记录，展示方式、参数、过滤条件、耗时、状态和逐篇新增/更新/跳过/失败明细。
• 文件可读：按笔记类型归档，优先使用标题命名，支持日期时间前缀和 frontmatter 元数据。
• 录音友好：API 返回音频和转写时，会保存音频附件和转写内容。
• 移动端兼容：网络请求使用 Obsidian requestUrl，适合桌面端和移动端 Obsidian。

功能

截图

设置页面：选择鉴权模式、配置目标文件夹与自动同步，并从同一入口执行下载、上传和查看日志。

OpenAPI 搜索侧边栏：在 Obsidian 侧边栏直接搜索得到大脑笔记，命中后一键打开本地笔记或同步到本地。

安装

通过 Obsidian 社区插件

1. 打开 设置 -> 第三方插件 -> 浏览。
2. 搜索 Dedao Brain Sync、得到大脑 或原名 GetNote / Get笔记。
3. 安装并启用插件。

手动安装

1. 从 最新版本 下载 main.js、manifest.json、styles.css。
2. 放入：

<your-vault>/.obsidian/plugins/dedao-brain-sync/

3. 重启 Obsidian 并启用 Dedao Brain Sync。

插件目录名为 getnote-importer（与 manifest.json 中的 id 一致，保持与历史 listing 的兼容性），仓库本身已重命名为 obsidian-dedao-brain-sync。旧版 GetNote Importer 的本地 data.json 会在首次启动时自动迁移。

获取 API 凭证

注意：得到大脑（原Get笔记）OpenAPI 需要 得到大脑PRO 会员。我们与 得到大脑团队确认过，OpenAPI 运营成本较高，目前仅对付费会员开放。如果你是免费用户，OpenAPI 接口不会返回数据。

凭证只保存在本地 Obsidian 插件数据中，用于访问你选择的接口模式。

OpenAPI 模式（推荐长期使用）

1. 打开得到大脑应用。
2. 进入 设置 -> 开放平台。
3. 创建应用，复制 Token 和 Client ID。
4. 在 设置 -> 得到大脑（原Get笔记）Sync 中选择 OpenAPI鉴权（会员），粘贴两个值。
5. 也可以使用设置页的 OAuth 按钮自动获取凭证。

Web 模式（手动 Token）

如果你的账号无法使用 OpenAPI，可以选择 临时鉴权。这个模式复用浏览器里已经登录的得到大脑网页版会话，不需要 Client ID。

独立图文步骤见：Web 模式手动 Token 指南。

复制 Token 的步骤：

1. 用 Chrome 或 Edge 打开 https://www.biji.com/note 并登录。
2. 打开浏览器开发者工具：Windows/Linux 按 F12 或 Ctrl + Shift + I；Mac 按 Command + Option + I。
3. 切到 Network 面板，并选择 Fetch/XHR 过滤。
4. 刷新网页版，或打开笔记列表 / 任意一篇笔记，让页面发起接口请求。
5. 在请求列表里点开名称类似 notes?... 或 list?... 的请求；右侧 Headers 里的 Host 通常是 get-notes.luojilab.com。
6. 在 Request Headers 下复制完整的 Authorization 值。
7. 粘贴到 设置 -> 得到大脑（原Get笔记）Sync -> 临时鉴权 的 Token 输入框。
8. 点击 测试连接，成功后再执行 按时间同步 或 按笔记同步。

这个值通常以 Bearer eyJ... 开头；插件支持粘贴完整 Bearer ...，也支持只粘贴 JWT token。不要把 OpenAPI 的 gk_... Token 粘贴到临时鉴权里。Web Token 是浏览器会话凭证，可能过期；如果返回 401、403 或 Web Token 已过期，请刷新网页版并重新复制 Authorization header。

使用

从得到大脑同步到 Obsidian

在设置页点击 按时间同步，或在命令面板运行：

Dedao Brain Sync: 同步笔记

下载同步默认采用保守策略：如果本地已经存在同一篇笔记，插件会跳过它，不覆盖你在 Obsidian 里的内容。需要重新拉取某篇远端笔记时，直接删除本地对应文件后重新同步；只要远端笔记仍存在，插件会把它作为本地缺失笔记重新创建。

选择远端笔记同步

点击 按笔记同步，从远端列表中勾选需要同步的笔记。适合专题整理、项目清理或一次性补同步。

按知识库同步

点击 按知识库同步，选择具体知识库后同步该知识库下的内容。这个入口是手动触发，不会自动扩散到定时同步。

定时同步

开启定时同步后，插件会按设定间隔从得到大脑同步到 Obsidian。定时同步只下载远端变化，不会上传本地笔记。

从 Obsidian 上传到得到大脑

在设置页点击 从 Obsidian 上传到得到大脑 区域里的 按笔记上传，选择本地目录和一篇或多篇 Markdown 文件后上传。

上传是创建型同步：

• 没有正文的笔记会跳过。
• 已有 uid 且能确认远端存在的笔记会跳过，避免重复创建。
• 不会覆盖得到大脑里的已有内容。
• 不会被定时同步自动触发。

输出结构

默认情况下，笔记写入目标文件夹。

vault/
└── 得到大脑/
    ├── 纯文本/
    │   └── 会议记录.md
    ├── 链接笔记/
    │   └── 2026-04-30_文章摘录.md
    ├── 录音长录/
    │   ├── 录音摘要.md
    │   └── asset/
    │       ├── 录音摘要.mp3
    │       └── 录音摘要.md
    └── 其他/
        └── 未识别类型.md

每个 Markdown 文件都会写入 frontmatter，后续同步会用其中的 uid 识别同一条远端笔记。

---
uid: "1908723638246504120"
title: "会议记录"
created: 2026-04-30 12:45:24
modified: 2026-04-30 13:00:07
source: 得到大脑
note_type: recorder_audio
tags: ["work"]
---

文件命名规则

非法字符（\ / : * ? " < > |）会自动移除。

文件名前缀

可以在文件名开头追加日期/时间模式。可用占位符：

示例：

插件会用笔记 created_at 时间戳替换占位符。占位符大小写敏感：mm 表示分钟，MM 表示月份。

按创建日期整理路径

“按创建日期整理路径”开关与“文件名前缀”放在同一组文件组织设置中。开启后可填写 YYYY、MM、DD 和分隔符组成的格式，默认是 YYYY/MM。日期始终取笔记的 created / created_at；历史笔记后来被更新，也仍然属于原创建日期，更新时间不会改变目录。

开启后的规范路径会在日期之后保留现有分类层级：

• 普通笔记：得到大脑/2026/07/纯文本/笔记.md
• 知识库笔记：得到大脑/2026/07/知识库/知识库名称/笔记.md

开启、关闭或把格式从 A 改成 B 时，点击“应用”会先显示提示；确认后先保存目标设置，再立即在本地迁移历史笔记和这些笔记实际引用的相邻附件。关闭会立即回迁到不含日期的原分类路径。若保存设置失败，迁移不会开始；若迁移中断，目标设置会保留，可通过“应用”或“重新整理现有文件”继续恢复。此过程不会请求得到大脑、不会执行全量同步，也不会修改同步断点。

迁移可幂等重跑：“重新整理现有文件”会按当前设置再次检查，已经位于目标路径的文件保持不变。日期层之后会保留每篇笔记现有的完整分类或自定义目录。任何目标冲突、无效元数据、缺失或共享附件，以及会因移动而失效的外部路径链接，都会按笔记整体跳过，不生成重名副本、不覆盖已有文件，也不改写其他笔记；迁移失败时会尝试回滚该笔记已经完成的移动。远端同步只按当前设置为新笔记选择路径，不负责迁移历史文件，也不会改变现有的本地覆盖/跳过约定。

设置项

同步模型

下载方向默认把得到大脑视为远端来源：

1. 扫描目标目录，从 frontmatter 构建 uid -> file 索引。
2. 从 OpenAPI 或 Web API 获取笔记列表。
3. 按更新时间、起始日期、最大天数、同步断点、笔记类型、手动选择范围或知识库范围过滤。
4. 为新笔记创建文件。
5. 当 updated_at 变化时更新文件。
6. 当显示标题变化时重命名文件。
7. 在同步日志中记录每条笔记的结果。
8. 定时同步保存最后处理笔记的时间作为下次断点。

上传方向是手动、选择型、创建型同步：

1. 用户选择本地目录和 Markdown 文件。
2. 插件解析标题、正文和 frontmatter。
3. 空正文、已确认存在的远端笔记、不支持的类型会跳过。
4. 可上传内容会在得到大脑创建为新笔记。
5. 上传结果会进入同步日志。

隐私

• 插件不依赖额外后端服务。
• API 凭证保存在本地 Obsidian 插件数据中。
• 下载同步时，笔记数据从得到大脑获取后直接写入你的 vault。
• 手动上传时，只有你选择的本地 Markdown 会发送到得到大脑。
• 音频附件只会从 API 返回的 HTTPS 地址下载。

已知限制

• 插件依赖得到大脑 OpenAPI / Web API 的可用性和响应格式。
• OpenAPI 需要 PRO 会员；临时鉴权依赖浏览器会话，可能过期。
• 音频下载只有在详情接口返回有效 HTTPS 音频附件时才会生效。
• 下载同步默认不会覆盖本地已存在的同一篇笔记；如果要重新拉取远端内容，请先删除本地对应文件再同步。
• 上传同步当前是创建型，不覆盖远端已有内容，也不会自动上传。
• 同步标签下拉默认显示本地缓存中的标签；首次打开设置页时插件会自动从首屏 20 条笔记里提取标签作为种子数据，运行一次同步后会被更全的标签列表覆盖。

开发

npm install
npm run typecheck
npm run lint
npm test
npm run build

发布产物从仓库根目录生成：

• main.js
• manifest.json
• styles.css

GitHub release workflow 会在上传产物前验证：类型检查、lint、测试、构建，以及 tag 和 manifest 版本一致性。

支持

• Bug 反馈：GitHub Issues

• 功能建议：GitHub Issues

• 用户问题收集：Dedao-Brain-Sync 需求问题收集问卷

• 如果插件帮到了你，欢迎给项目一个 star

关于作者

企业 AI 从业者，野生 AI 博主，AGI 信徒，AI 发烧友。欢迎通过项目 issue、反馈问卷或公众号继续交流。

许可证

MIT