我开源了一个插件:得到大脑的笔记自动同步进你的本地知识库

关注「EHS知行」，持续获取 AI 实战与管理方法

开源实战系列：做成一件事，走给你看

先说这个东西是什么：我写了一个开源插件 Dedao KB Sync，装进 Obsidian，它会把得到大脑里的课程笔记、听书心得，自动同步成本地 Markdown——30 多个知识库，15 分钟搬完，之后自动更新。代码在 GitHub，已上架 Obsidian 官方插件商店，谁都能装。

它解决的问题一句话：得到大脑的笔记只能在它的 App 里看，不能导出，笔记资产像存在别人的保险柜。有了这个插件，得到里学的东西进了我自己的知识库——写作时全文检索，备课随手引用，App 关掉笔记还在。

如果你也用得到学习、在 Obsidian 或本地文档里攒知识库，这篇对你有用。后面讲它怎么来的：站在一个现成开源插件上写清需求、让 AI 干活、按闸口验收，不到一周发了四个版本、上架官方商店。

一、为什么要做这个项目

我的主业是安全，不是开发。但我所有的写作、备课、做课，都发生在 Obsidian 里；而学习，几乎都发生在得到里——课程笔记、听书心得、划过的重点，得到大脑都帮我收着。

最早我是手动搬的。写文章要用某个观点，打开得到 App 找到那条笔记，复制，切回电脑，粘贴。干了两个星期我就受不了了：这不是在搬笔记，这是在给 App 打工。

后来我算了笔账：得到大脑里躺着三十多个知识库——24 个自建的，7 个订阅博主的——笔记只会越攒越多。手动搬不可能搬完；不搬，这些内容就永远是别人服务器上的数据，变不成我自己的资产。

需求就一句话：让得到大脑的内容，自己走进我的 Obsidian。

二、这个项目是怎么开展的

起点要先交代：这个项目不是从零开始的。社区里原本就有一个开源插件，叫 Dedao KB Sync，它已经能把得到大脑的知识库笔记同步进 Obsidian——方向是对的，我不用从零造轮子。但它有几个地方实现不了我要的：

2. 同步不稳——手动点同步，经常被后台任务吞掉，点了没反应；
4. 不能挑库——它一股脑全拉，我只想同步自己选的那几个；
6. 语音笔记只有音频——转写文字进不了笔记；
8. 同步间隔锁死最小 5 分钟——得到接口有月度配额，这么跑纯粹在烧配额。

这四个"实现不了"，就是我要做的事。整个项目展开是两条线：一条线看产品，做成了哪些功能；一条线看过程，它怎么被设计、验证、发布出来。

先看第一条线：最后做成了哪些功能

2. 稳定的一键同步。
   手动点同步就真同步，还被完整记录，不再被后台任务吞掉；
4. 只同步我勾选的库。
   没勾的库，一个字节都不动；
6. 语音笔记带着转写原文进笔记。
   音频文件不下，vault 不会被 MP3 撑爆；
8. 博主内容自动归档。
   按"知识库/博主/日期"落位成笔记，原文和摘要都在；
10. 同步间隔 8 档随便选。
    从 5 分钟到 1 周，适配接口的月度配额。

还有第六个功能——把转写和原始内容合并进主笔记——正卡在半路：它涉及删除旧文件，我们给它单独立了授权闸口，没确认就不动。这不是进度慢，是不该删的东西一个都不能错删。

再看第二条线：它是怎么被设计出来的

第一步，写 PRD。照项目库里的 PRD 模板，填四块东西：项目定义（解决什么问题、不做什么）、功能图（每个功能一行：定义是什么、给谁用、做到什么程度算完）、成功场景与验收标准、质量闸门。我的 PRD 里连"别人怎么用起来"都写了进去：干净 vault 装上插件、选 1 个知识库点同步，15 分钟内必须出第一条笔记、错误数为 0；陌生用户照着 README 装，10 分钟内要能装完。半页到两页纸，写清楚就够了——PRD 不是给老板看的，是给 AI 下活的。

第二步，AI 干活。接口怎么调、被限流了怎么退避、设置页怎么搭、619 个自动化测试怎么写，AI 结对干完。我全程没写几行代码。

第三步，按闸口验证。PRD 里立了三道闸口：资料闸——项目文件齐不齐、状态真不真；发布闸——四连测试（类型检查/代码规范/测试/构建）全绿，加上 Obsidian 真机加载、关键同步路径逐条核验；上架闸——README 英文章节齐、四个版本号文件一致、发布包三件套齐全。任何一道不过，就暂缓发布，把欠账写回状态文件，绝不硬发。8 月 23 日，我在自己的真实 vault 里验收了核心同步功能，确认了才放行。

第四步，上传开源。九步发布清单走完：开分支→README 英文化→版本号对齐→跑测试→提 PR 合并→打 tag→GitHub Actions 自动打出安装包→核对三件套→提交社区目录审核。不到一周，从 1.0.3 连发到 1.0.6 四个版本。

第五步，被人使用。过了社区审核，任何人都能在 Obsidian 插件商店搜到装上；用出问题走 issue 提，我修完发新版。发布不是终点，是循环的开始。

三、开源之前，我卡了自己三道隐私红线

代码要公开给所有人看，所以上传之前我给自己立了三条规矩：

2. 密钥不进仓库。
   得到大脑的接口凭证这类东西，只放本机配置，代码、文档、提交记录里都不能出现；
4. 真实笔记不进测试。
   测试用编造的样例数据，不把我自己的笔记内容打包进去；
6. 权限如实申报。
   插件只做同步这一件事，是什么功能就申报什么功能，不夹带、不越界。

这三道关比任何功能都重要——开源是把代码亮给别人看，你的疏忽也会被一起看见。

四、GitHub 是个好东西

这次完整走了一遍开源发布，我才体会到它的好：

打个标签，发布流水线自动打包、自动校验，全世界都能下载；用户用出问题，走 issue 提，修完发新版，有据可查；社区审核相当于免费请了一轮安全体检。

最重要的一条：开源出去，这个插件就不再只是我的工具。谁有新需求，都可以在它基础上接着长功能——就像我当初站在别人的代码上一样。开源的规矩就是这样：前人把肩膀借给你，你把肩膀借给后人。

五、这条路，你也可以走

回顾整个项目，其实就四步：

2. 找到肩膀。
   看看现成插件、官方接口做到了哪一步，缺的才是你要做的；
4. 写清楚需求。
   照 PRD 模板填四块：定义、功能图、验收标准、闸门，写清楚就够；
6. 让 AI 干活，按闸口验收。
   代码测试交给 AI，你只管真机试用、挑刺、拍板；
8. 干净地开源。
   密钥、真实数据、越界权限，一样都别带上去。

想要东西的，评论区留言"插件"，我把两个东西一起发你：①这个插件的安装方式（动手快的直接在 Obsidian 插件商店搜 Dedao KB Sync）；②我这份 PRD（已去掉本机路径的脱敏版）——照着它，把需求换成你自己的，AI 就能开工。

#AI实践 #Obsidian #开源 #效率工具