Dedao Brain Sync

⭐ 官方推荐｜得到大脑 / Get笔记 🔄 Obsidian 双向同步

中文 | English

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

想了解这个项目的由来和背景，可以阅读这篇文章：我做的得到大脑OB插件，上架官网了😃。

---

🎉 1.6.0 最新更新

• 🔄 本地修改可自动回传：自动同步可选择“本地修改自动上传”，同步目录中已关联的文字笔记会安全回传；两端同时修改时保留双方内容，交给手动同步处理冲突。
• 📝 本地草稿一次上传并归档：同步目录中新建的 Markdown 文字笔记可自动创建到得到大脑，写回 uid 后移动到规范路径；目标文件已存在时保留原文件并明确报错，不会覆盖。
• 📚 知识库归属不会丢：在 知识库/<名称>/ 中新建的草稿会加入对应的可写云端知识库；无法确认归属或知识库只读时停止上传，避免产生无归属笔记。
• 🎛️ 自动同步设置更直接：下载与上传合并到同一个自动同步区域，用一个开关决定“仅下载”或“下载并上传”；空结果也会给出明确反馈。
• 🧪 工具链更新：升级测试与构建依赖，包括 Vitest 5，并继续验证 OpenAPI 和 Web API 的鉴权行为。

这是一次双向同步能力更新。自动上传默认关闭且需要 OpenAPI；升级后可在“自动同步”中按需开启“本地修改自动上传”。

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

---

✨ 为什么好用

• 🔄 真正双向同步：得到大脑 → Obsidian 持续同步；同步目录中的本地文字笔记可自动新建或回传修改，也支持手动选择 Markdown 创建笔记。
• 🧠 不只是一次性导出：把笔记同步成独立 Markdown 文件，持续进入你的本地知识库，而不是导出完就结束。
• ⚡ 同步稳定可续传：支持增量同步、同步断点、最近 N 天、指定日期、指定笔记、指定知识库等多种范围控制。
• 🔎 直接在 Obsidian 搜得到大脑：侧边栏全文搜索，命中后可直接打开本地笔记或一键同步到本地。
• 🖱️ 选中文字即可搜索：编辑器中选中文字，通过右键菜单直接发起得到大脑搜索。
• 📚 知识库同步更完整：支持指定知识库同步，也可通过命令一次同步全部已订阅知识库。
• 🗂️ 本地结构可控：支持分类目录、文件名前缀、按创建日期组织路径，以及已有笔记的路径迁移 / 回迁。
• 🏷️ 筛选更丰富：可按更新时间、起始日期、笔记类型、标签、知识库等条件控制同步范围。
• ⏱️ 自动同步：支持定时同步和启动时同步，可选择仅下载或同时上传同步目录中的本地修改。
• 📜 同步过程可追溯：保留最近 30 天同步历史，包括范围、耗时、状态以及逐篇新增 / 更新 / 跳过 / 失败结果。
• 📱 桌面端 + 移动端：插件本身不是 Desktop Only；OpenAPI 模式适合桌面和移动端 Obsidian。

🧰 功能一览

🖼️ 截图

⚙️ 设置页面

统一配置鉴权、目标文件夹、同步方式、附件、自动同步及同步历史。

🔎 搜索侧边栏

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

📦 安装

💜 通过 Obsidian 社区插件

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

🛠️ 手动安装

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

<your-vault>/.obsidian/plugins/getnote-importer/

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

插件 ID 仍为 getnote-importer，用于兼容 Obsidian 社区历史 listing 和旧版数据；显示名称已统一为 Dedao Brain Sync。

🔑 获取 API 凭证

⚠️ 得到大脑 OpenAPI 当前需要 得到大脑 PRO 会员。免费用户无法通过 OpenAPI 获取完整数据，可在桌面端尝试 Web 模式。

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

🟢 OpenAPI 模式（推荐长期使用）

1. 打开得到大脑。
2. 进入 设置 → 开放平台。
3. 创建应用并获取 Token 与 Client ID。
4. 在 设置 → Dedao Brain Sync 中选择 OpenAPI 鉴权并填写凭证。
5. 点击测试连接确认可用。

🟡 Web 模式（桌面端快速使用）

桌面版 Obsidian 可以使用插件内的 Web 登录流程获取会话 Token，并在会话失效时尝试自动刷新；也仍然支持手动粘贴 Token。

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

Web Token 属于浏览器会话凭证，可能过期。如果出现 401、403 或会话过期提示，请重新登录或刷新 Token。Web 自动登录 / 自动续期依赖桌面环境，移动端建议优先使用 OpenAPI。

🔄 使用

⬇️ 从得到大脑同步到 Obsidian

在设置页发起同步，或在命令面板运行：

Dedao Brain Sync: 同步笔记

可以进一步选择按时间、按笔记或按知识库执行同步。

🌐 同步全部订阅知识库

命令面板提供独立命令，可一次同步全部已订阅知识库。知识库列表会分页获取，避免只处理首屏订阅内容。

🔎 搜索得到大脑

• 点击搜索 Ribbon，在 Obsidian 侧边栏直接搜索远端笔记。
• 已经同步到本地的结果可以直接打开。
• 本地不存在时可以一键同步。
• 在编辑器中选中文字，右键可直接发起搜索。

🕒 定时同步

开启自动同步后，插件会按设定间隔从得到大脑同步到 Obsidian，也可设置启动时同步。启用“本地修改自动上传”后，同一轮还会处理同步目录（含子目录）中新建或修改的文字笔记。

自动上传默认关闭，仅支持 OpenAPI。它不会传播删除；若本地与远端同时修改，会保留两端内容并提示使用手动同步选择版本。

⬆️ 从 Obsidian 创建到得到大脑

在设置页或命令面板打开本地上传，选择一个或多个 Markdown 文件。

手动上传是 选择型、创建型，与自动同步中的本地修改回传相互独立：

• 目前主要支持 plain_text 和 link 类型。
• 已有 uid 且确认远端仍存在的笔记会跳过，避免重复创建。
• 不会自动覆盖得到大脑已有笔记。
• 同步目录中已关联文字笔记的修改，可由“本地修改自动上传”处理。
• 上传标签会去重，并限制数量。

📁 输出结构

默认目标目录为 得到大脑，实际结构会根据笔记类型、知识库和日期路径设置变化。

vault/
└── 得到大脑/
    ├── 2026/
    │   └── 08/
    │       ├── 纯文本/
    │       │   └── 会议记录.md
    │       ├── 链接笔记/
    │       │   └── 一篇文章.md
    │       └── 知识库/
    │           └── 我的知识库/
    │               └── 专题笔记.md
    └── ...

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

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

🏷️ 文件命名与日期路径

✏️ 文件名前缀

支持日期 / 时间占位符：

例如：YYYY-MM-DD → 2026-08-30_会议记录.md

📅 按创建日期整理路径

开启后可使用类似 YYYY/MM 的目录规则：

得到大脑/2026/08/纯文本/会议记录.md

日期取笔记的创建时间，而不是更新时间。修改或关闭日期路径时，插件会先预检，再迁移 / 回迁历史文件与相关附件。

迁移支持重复执行；遇到目标冲突、无效元数据、共享附件或可能导致链接失效的情况时，会优先跳过，而不是强行覆盖。

⚙️ 主要设置

🔒 隐私

• 🔐 API 凭证保存在本地 Obsidian 插件数据中。
• 🏠 插件不依赖额外的第三方中转后端。
• ⬇️ 下载同步的数据从得到大脑直接写入你的 vault。
• ⬆️ 手动上传只发送你明确选择的 Markdown；启用“本地修改自动上传”后，会发送同步目录（含子目录）中符合条件的新建或已修改文字笔记。
• 📎 附件只从得到大脑接口返回的地址下载。
• 🛡️ 本地路径迁移遇到冲突或无法安全处理的文件时，会优先跳过而不是覆盖。

⚠️ 已知限制

• OpenAPI 依赖得到大脑开放平台可用性，并需要 PRO 权限。
• Web 模式依赖网页版接口和登录会话，接口变化或 Token 失效都可能影响使用。
• Web 自动登录 / Token 刷新主要面向桌面端。
• 手动上传目前是创建型；自动上传可回传同步目录中已关联纯文本笔记的标题、正文和标签修改。
• 手动上传主要支持纯文本与链接类型；自动上传仅支持 OpenAPI 下的纯文本笔记。
• 部分附件能力取决于得到大脑详情接口是否返回有效附件地址。
• 得到大脑接口字段发生变化时，部分类型的解析可能需要插件跟进适配。

👨‍💻 开发

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

发布前会检查类型、Lint、测试、构建以及版本号一致性。

发布产物：

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

💬 支持与反馈

• 🐛 Bug：GitHub Issues
• 💡 功能建议：GitHub Issues
• 📝 用户问题收集：Dedao Brain Sync 需求问题收集问卷

如果这个插件对你有帮助，欢迎点一个 ⭐ Star。

👋 关于作者

企业 AI 从业者，野生 AI 博主，AGI 信徒，AI 发烧友。

欢迎通过 GitHub Issue、反馈问卷或公众号继续交流。

📄 License

MIT