Dedao Brain Sync

中文 | English

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

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

---

🎉 1.4.2 最新更新

• 🧩 选择弹窗时间展示统一：按笔记、知识库等选择弹窗共用同一套相对时间格式，空时间不再显示异常内容。
• 🎨 界面样式兼容性增强：收紧复选框和侧栏按钮的 CSS 选择器，在保持现有外观的同时减少对 Obsidian 主题样式的干扰。
• 🧹 代码与样式清理：清理解析器、设置页和搜索视图里的静态检查告警，并减少不必要的样式覆盖，保持现有行为不变。
• ⚙️ 运行时与构建链更新：更新 Preact、TypeScript、ESLint 等兼容版本，并扩充同步边界测试，提升后续维护稳定性。

1.4.1 的核心改进仍在生效（干净的笔记卡片预览、知识库下拉刷新、标签白名单归一化和设置页定时器清理等）。

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

---

为什么好用

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

功能

功能	说明
增量同步	新增本地缺失的笔记；本地已存在的笔记默认跳过，不覆盖
搜索侧边栏	在 Obsidian 侧边栏用 OpenAPI 全文检索得到大脑笔记，命中后一键「打开本地笔记」或「同步到本地」
按时间同步	按起始日期或最近 N 天拉取得到大脑笔记
按笔记同步	从远端列表中勾选要同步的笔记
按知识库同步	手动选择订阅知识库，将该知识库下的内容同步到本地
定时同步	按设定间隔同步，并可限定知识库、笔记类型和标签
启动时同步	Obsidian 启动时自动执行一次下载同步
本地上传	从 Obsidian 选择目录和 Markdown 文件，手动创建到得到大脑
两种鉴权	支持 OpenAPI 鉴权和临时 Web 鉴权，覆盖长期使用与快速试用场景
丰富过滤器	支持时间范围、最近天数、同步断点、笔记类型、标签、手动选择笔记、知识库范围等过滤
类型归档	纯文本、链接、录音、本地音频、其他分别归档
同步日志	展示每次同步的方式、参数、过滤条件、处理数量、耗时和逐条结果

截图

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

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"]
---

文件命名规则

情况	示例
有标题	会议记录.md
无标题	这是笔记的第一段文字.md
加日期前缀	2026-04-30_会议记录.md
同名不同笔记	会议记录-2.md

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

文件名前缀

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

占位符	含义	示例
YYYY	4 位年份	2026
MM	2 位月份	04
DD	2 位日期	30
HH	2 位小时（24 小时制）	14
mm	2 位分钟	30
ss	2 位秒	05

示例：

前缀	生成的文件名
YYYY-MM-DD	2026-04-30_会议记录.md
YYYYMMDD_HHmm	20260430_1430_会议记录.md
YYYY-MM-DD	2026-04-30_.md（无标题时用正文前文）

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

设置项

设置项	说明	默认值
API Token	得到大脑开放平台 Token	空
Client ID	得到大脑开放平台 Client ID	空
目标文件夹	vault 内同步目标目录	得到大脑
文件名前缀	日期时间前缀格式，如 YYYY-MM-DD	空
自动同步范围	定时同步只拉最近 N 天内更新的笔记，0 表示不限	30
同步起始日期	手动同步的绝对起始日期	空
定时同步	后台自动同步开关	关闭
同步间隔	定时同步间隔（分钟）	30
启动时同步	Obsidian 启动时自动同步一次	开启
同步笔记类型	限制本同步方式处理的笔记类型	全部类型
同步标签	标签白名单；空表示同步全部标签；下拉可多选，未匹配项可在搜索框直接新增	空
定时同步的知识库	限定定时同步要拉取的知识库范围；空表示不过滤	空
下载附件	总开关；关闭则不下载任何附件	开启
附件分类	单独控制图片 / 音频 / 视频 / 文档是否下载	全部开启
重置同步断点	在定时同步页可重置 lastSyncEndTimestamp，重新从同步起始日期开始拉取	—

同步模型

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

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