본문으로 건너뛰기
M

dsh-getnote

magicbaobaoli/dsh-getnote

A local-first Markdown panel for a 得到大脑 / Get笔记 vault: folder tree, tag cloud, full-text search, and a renderer for tables, timelines, Obsidian wikilinks and image attachments. Recording notes get an audio player with drag seeking and a timestamped transcript. Notes are plain .md files on disk, so a synced vault stays readable offline; cloud sync is optional, and deleted notes go to a restorable trash. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.

설치

dsh plugin --profile web add github:magicbaobaoli/dsh-getnote

README

dsh-getnote — 把「得到大脑」接进 DeepSeek Harness

左侧栏一个入口,中央一块面板。既直接操作得到大脑(原 Get笔记 / biji.com)的云端内容(看、改、删、打标签、语义召回、生成分享链接), 也把一切镜像成本地 Markdown 文件(离线可读、可搜索、可以用 @路径 喂给对话)。

自动同步默认需要你亲手开一次,开了之后就不用再管:只要 DSH 开着,它自己按时拉新笔记。

本地优先:笔记是磁盘上的纯 Markdown,会员到期之后,已经同步下来的内容照常能读能写能搜。 云端的 OAuth 登录和 API Key 都是可选增强。

两条通道,用哪条取决于你有什么

通道你需要做的事说明
登录得到大脑(OAuth)在「同步」页点一次「登录得到大脑」,浏览器授权一次授权,之后自动续期。推荐,不用去控制台
API Key(官方 Open API)去 openapi.biji.com 控制台建个人应用,拿 API Key + Client ID,填进「设置 → 云端接入」长期凭证,不依赖浏览器

面板会自动挑:配了 Key 就优先用 Key,Key 被服务端拒绝(401 / 未授权)就静默回落到登录通道, 并在设置页用黄色横幅告诉你「Key 被拒了,现在走的是登录通道」——不会让你看到「已接入」却满屏报错。 换 Key 或清凭证会重置这个判断,重新试。

配额:官方 Open API 读 1000/天、写 200/天;登录通道实测宽得多。自动同步有增量模式, 连续两页没有变化就提前收工,不会把配额烧在读旧笔记上。

功能

笔记(离线,完全不联网)

  • 目录树(按知识库/主题分)、标签云、全文搜索
  • 左栏可整理:目录与标签都能新建(标题行最右侧的「+」)、都能右键删除。 右键后「删除」与「取消」直接出现在被点的那一行里(占据计数徽章的位置), 不用去别处找按钮;点「删除」还会再弹一次确认框,再点「删除」才真删。 目录非空时拒绝删除,会告诉你还剩几篇笔记——点一下垃圾桶就把几十篇送进回收站是灾难
  • 三种排序,目录与标签各自独立:按最近修改(默认,按目录/标签下最新一篇的时间算)、 按名称、按条数。两个排序按钮各管各的,选择分别记在浏览器本地,下次打开还是它。 分开的理由是它们用法不同——目录十来个、按名称找;标签几十个、按条数看热点,共用一个 开关的话调标签顺序会把目录顺序一起改掉
  • Markdown 阅读:标题、列表、任务列表、表格、引用、代码围栏、链接
  • Obsidian 双链:正文里的 [[另一篇笔记]] / [[目标|显示文字]] 是可点的,点了直接跳到那篇笔记; ![[图片.png]] 会就地显示图片(按文件名在本文附件里找)
  • 编辑保存(不留 .bak:保存前的内容已经进版本历史,多留一份副本只会在库里堆看不见的垃圾)、 新建(YYYY-MM-DD-标题.md)、删除进 .trash/
  • 回收站页签:删除的笔记能看见、能一键恢复(撞名时自动改名,绝不覆盖)、能永久清空
  • 图片附件直接显示,不用切到文件管理器;播放器标题会自动去掉 _<note_id>_audio 这种机器后缀
  • 「复制引用」把绝对路径复制成 @path,直接粘到对话里让 DSH 读

云端(联网,直接操作得到大脑)

  • 笔记列表 + 分页加载
  • 语义搜索(官方 recall,按意思找,不是本地那个子串搜索)
  • 打开一篇笔记看详情,录音笔记带原始音频播放器
  • 改标题 / 改正文,保存即回写云端,并顺手刷新本地那份 .md
  • 按知识库筛选(顶上一排知识库 chip),新建云端笔记(可指定知识库)
  • 加标签 / 点标签上的 × 删标签、创建分享链接(可排除音频)
  • 把本地改动推回云端:以前只能「云端 → 本地」单向,本地改完没法送回去; 现在详情页有一个推送按钮(会二次确认,推的是正文与标题)

音频

  • 录音笔记的音频地址在 attachments[type=audio].url(一个会过期的签名 URL), 所以播放器不直连 CDN,而是走 /getnote/audio?url= 代理:签名不暴露给浏览器、 支持 Range 请求(能拖进度条)、白名单限制域名(防止这个端点变成开放代理)
  • 本地库里的录音也能直接播:笔记同目录 asset/ 下形如 <标题>_<note_id>_audio.mp3 的附件,会显示成「本地录音」播放器,走 /getnote/asset?path= 读磁盘(同样支持 Range)。认领靠 note_id,所以 本地标题和云端标题不一样也能对上
  • 进度条是自绘的(不是原生 <input type=range>):整条轨道都是可点区域, 点哪跳哪,按住拖动跟随,松手才真正 seek
  • 逐字稿按「时间戳 + 说话人 + 内容」分条排版,中文长文自动折行,不是塞进等宽代码块

读笔记更省事

  • 本文大纲:打开一篇长笔记(录音转写那种几十段),阅读区顶部有一张可折叠的大纲卡, 点哪一节就滚到哪一节。围栏代码块里的 # 不算标题,否则逐字稿里会冒出一堆点不动的假条目
  • 关联笔记(反查双链):底部列出「哪些笔记引用了这一篇」,点了直接跳过去。 匹配刻意放宽:完整路径、去扩展名的路径、文件名、标题,任一相等就算引用
  • 搜索增强:支持 tag:标签、dir:目录、#标签 限定,多个词是取交集(不是「或」), 结果按「正文命中次数 + 标题命中」排序,每条笔记卡右侧显示命中次数,点开能看到带行号的命中片段
  • 快捷新建模板:「+」展开四种模板——日记 / 读书笔记 / 会议记录 / 随手记, 预填日期与标签。日期按本地时区算,不是 UTC(否则晚上八点后新建会变成「明天」)

改笔记更省事

  • 单篇推拉:笔记头有两个按钮,一个把这一篇的本地改动推到云端,一个从云端拉最新版覆盖这一篇。 只处理眼前这篇,不跑整轮同步(整轮要翻页扫全部笔记,很慢)
  • 冲突比对:云端和本地都改过时,同步会把两份都留下来。冲突页签左右并排列出 「我的本地版」和「云端版」,一键采纳任一边。哪一份是哪一份是按语义算的、不是按文件名猜的: .conflicts/ 里 __<原名> 的留档装的是本地版,__cloud-<原名> 的装的是云端版(早期手工 抢救时存进去的),两种命名历史上并存过,混为一谈会让「用我的本地版」把云端内容写回正本。 采纳前会先给当前正本存一份历史,不会丢内容
  • 冲突页签常驻:不管有没有待处理,页签一直在右边;只有未处理的数量挂在旁边当角标, 处理一条减一,全处理完角标消失。处理过的收进「已处理」折叠区,随时能展开翻回去看、 也能「退回未处理」
  • 批量操作:列表卡左上角有勾选框(悬停显形),选中若干篇后出现批量栏—— 批量加标签、批量移目录、批量移入回收站。移目录保留原文件名(日期前缀是归档约定,不丢)
  • 版本历史:每次保存/删除前自动留快照,每篇保留最近 10 版。笔记头的时钟按钮能翻历史、 预览任意一版、一键恢复(恢复前会先把当前版本也存一版)

数据可携带

  • 整库导出/导入 zip:导出把整个库(笔记 + 附件 + 主题配置)打成一个 zip; 导入默认「同名时另存一份」,也可以选「跳过同名」。ZIP 是自己实现的,文件名按 UTF-8 标记, 中文名在 Windows 资源管理器里不会乱码
  • 只在面板打开时同步:自动同步的开关之一。开了之后,面板关着就不发请求、不烧配额

用起来更顺手

  • 键盘快捷键:Ctrl/Cmd+K 搜、Ctrl/Cmd+N 新建、J/K 上下翻笔记、Esc 退出输入
  • 字号三档:阅读区正文可以调小/标准/大三档,标题字号跟着等比缩放(不是只放大正文)
  • 骨架屏:首屏加载时显示三栏形状的占位,不是一片空白;系统开了「减少动态效果」时占位不闪
  • 面板主题色:设置里选一个颜色,左栏最深、中栏浅、右栏接近白——只让你选色相,明度由代码锁死, 所以不管选什么颜色,三栏层次都不会乱。选色时整面板实时预览,点「应用」才保存
  • 刷新键反馈:点刷新会转三圈,成功变绿、失败变红,五秒后复原
  • 再点一次就收起:中栏里已经打开的那条笔记,再点一次就收起,右栏回到空白。 笔记页与云端页都支持(只作用于列表卡片的点击——新建后自动打开、保存后刷新详情这些 内部动作仍然是「打开」,在那里折起来是 bug 而不是功能)
  • 三种界面语言:中文 / English / Nederlands,设置页一张「语言」卡就能切,切换即刻生效。 「自动」跟随 DSH 自己的语言;选了具体语言就以那个为准,不会被宿主语言顶回去

同步(自动或手动)

  • 自动同步:开关 + 间隔(5 分钟 ~ 12 小时)。DSH 启动 20 秒后第一次跑,之后每分钟查一次 「到点没有」,到点才真的发请求。失败静默(原因留在面板里),不刷错误提示
  • 手动「立即同步」= 增量;「全量扫描」额外能发现云端已删除的笔记(慢、费配额,所以不自动)
  • 增量同步遇到连续两页没变化就停,不全量扫
  • 结果分列显示:拉取 / 保留本地 / 保留本地(接管)/ 冲突 / 移入回收站 / 失败

导入(旧的一次性 OAuth 全量导入,仅在没有 API Key 时作为兜底出现)

设置

  • 笔记库目录可指定任意路径(默认 $DSH_HOME/dsh-getnote/vault)
  • 空库时扫描常见位置并建议(不擅自切换)已有的归档目录
  • 云端凭证状态、打码后的 Key、凭证文件路径
  • 界面语言:自动 / 中文 / English / Nederlands,存在 host 设置里(多开窗口、换机器都以它为准)

同步怎么决定「该不该动你的文件」

这是整个插件最容易毁数据的地方,规则写死如下——一律偏向保住用户的东西:

情况行为
本地没有这篇新建
本地有、且没改过覆盖成云端最新(不留 .bak,那份内容就是我们自己上轮写的)
本地改过、云端没改保留本地,只更新记账
两边都改本地版另存 .conflicts/,正文写云端版,备份失败就整篇不覆盖
本地已有 note_id 但同步引擎没见过它判定为你手写的,原样保留并标记 adopted;以后云端再改也只往 .conflicts/ 另存
云端删了、本地改过保留本地,只在面板标「云端已删除」,不替你做主

写入前会先解析出真实的绝对路径(resolveInside 返回的是对象,不是字符串——这里踩过坑, 把它当字符串用会让每一篇都判成「本地不存在」从而无条件覆盖)。

界面

三栏是从深到浅的同一条蓝,越往里越亮,眼睛自然从「我在哪」滑到「我读什么」:

栏配色内容
左深蓝 #0a2a52 → #071d3b目录树、标签云,一律白字
中浅蓝 #c5daf3 → #b6cfee笔记列表,深蓝文字
右近白蓝 #f7fbff阅读区 / 编辑区,深灰蓝正文

深蓝填充上的字一律白:左栏、右栏、以及云端/同步/冲突/设置四个整页,都显式写了 --dsw-alias-label-primary-foreground。漏掉这一行的话,主按钮、选中的 chip、选中的知识库 会落到应用默认的深色前景上——白底页面里看着还凑合,一旦填成深蓝就变成「深字压深底」, 几乎读不出来。

实现方式不是给每个元素改颜色,而是在各栏容器上局部重定义 --dsw-alias-* 主题变量: 自定义属性沿 DOM 继承,栏内所有用 token 的字色、底色、边框色自动跟着变。以后调色只改 一组变量,不会漏掉某个还在用旧 token 的角落。云端/同步/设置三个整页复用右栏那套浅色。

深色区的文字是写死的白(#fff / .86 / .66 三档),不用主题色推导——推导出来的 浅色在换到墨绿、酒红主题时会偏成淡绿淡粉,反而不如白字干净。

主题色只让选一个色相,明度由代码锁死:左栏最深、中栏浅一档、右栏接近白,层次是 算出来的而不是让用户自己配。开放三个输入框的话,一旦有人填出「左栏比右栏还淡」的组合, 整个界面的空间感就散了。选色时整个面板实时预览,点「应用」才落盘。

扫描与列表会跳过 .conflicts、.trash、.history、asset 这些内部目录:前三个是不该 被当成笔记的副本、回收站与历史快照,asset 里的 _transcript.md 虽然也是 markdown, 但它是录音的转写附件,混进列表会让人点「笔记」却打开转写。

安装

从索引源安装(推荐)

  1. 打开 DSH 的插件页,切到发现标签(若没有,先在插件设置里打开「自定义插件索引」)
  2. 添加索引源,填这个地址:https://magicbaobaoli.github.io/dsh-getnote/index.json
  3. 找到「得到大脑」,点安装

从 GitHub 直接装

dsh plugin --profile <你的 profile> add github:magicbaobaoli/dsh-getnote

本地开发

plugin_manager action:install_bundle target:"<绝对路径>/dsh-getnote"

装完重启 DSH,左侧栏出现大脑图标。

数据在哪

内容位置
笔记设置里的 vaultRoot,默认 $DSH_HOME/dsh-getnote/vault
设置$DSH_HOME/dsh-getnote.json
云端凭证(API Key)$DSH_HOME/dsh-getnote/cloud.json(0600)
登录令牌(OAuth)$DSH_HOME/dsh-getnote/auth.json(0600,仅 host 可读)
同步记账$DSH_HOME/dsh-getnote/state.json(每篇的路径与指纹)
冲突备份<库根>/.conflicts/(同名时带 __cloud- 前缀的是云端版留档)
回收站<库根>/.trash/

DSH_HOME 默认是 ~/.dsh。

结构

lib/index.js      host 入口:/getnote/* 路由、双通道选择、自动同步定时器
lib/vault.js      文件层:扫描、frontmatter、读写、搜索、回收站、附件认领
lib/settings.js   设置、云端凭证、同步记账的持久化(原子写)
lib/openapi.js    官方 Open API 客户端 + 字段归一化(normalizeNote / extractAudio)
lib/mcp-cloud.js  把登录通道包成与 openapi.js 相同的接口(含音频字段桥接)
lib/biji.js       OAuth(PKCE)与 MCP JSON-RPC 客户端
lib/cloud-sync.js 同步引擎:四分支决策、指纹、Markdown 渲染、推送
lib/archive.js    整库 zip 导出/导入(自实现 ZIP 读写,UTF-8 文件名)
lib/history.js    笔记版本历史(每篇最近 10 版,恢复前先存当前版)
lib/sync.js       旧的一次性全量导入
lib/client.js     浏览器产物:sidebar.panellist 入口 + main 面板(笔记/云端/同步/冲突/设置/回收站)
locale/           三本界面字典(zh / en / nl)与插件元数据
test/             六套离线测试,不联网

测试

node test/vault.test.mjs     # 70 项:文件层、frontmatter、搜索语法、双链反查、大纲、冲突解析、回收站、目录/标签增删、块列表标签改写
node test/sync.test.mjs      # 66 项:同步引擎(重点验「什么情况下不该动用户文件」)
node test/host.test.mjs      # 179 项:全部 /getnote/* 路由、凭证、白名单、SSRF 防护、Range、批量、历史、归档、目录标签增删、冲突采纳方向
node test/client.test.mjs    # 398 项:UI 结构、Markdown 渲染、播放器、逐字稿、双链、13 项功能接线、错误边界、排序与右键菜单、深色填充白字、三语字典一致性、语言切换、卡片再点收起
node test/archive.test.mjs   # 57 项:ZIP 读写互通性(用 Python zipfile 交叉验证)、导入合并策略
node test/history.test.mjs   # 46 项:版本历史快照、恢复、上限裁剪、非法路径拒绝

六套共 816 项,全部离线运行,不需要网络也不需要真实凭证。

边界

  • 云端写入只动你自己的笔记。不做企业代授权场景的适配。
  • 录音卡(GetSeed 硬件)的专用接口是 fail-closed 的,普通个人账号调用会 403;这类笔记 走通用笔记接口照样能读能播。
  • 录音类笔记的 ASR 原文原样保留,不做改写。
  • 同步是「云端 → 本地」的镜像 + 面板里的显式「推送」。没有自动的双向同步: 本地文件被外部手改成什么样,插件不会猜你的意图替你回写云端。
  • API Key 那条通道用的是得到大脑官方 Open API,该接口仅对会员开放; 会员到期后登录通道可能失效,但已经同步到本地的 Markdown 永远能读。
  • 批量操作是「逐篇执行、不整体回滚」:20 篇里 1 篇失败,另外 19 篇照样做完, 失败的会在结果里列出来,重试只影响那几篇。
  • 删目录只允许删空目录(既没有 .md 也没有子目录)。这条不是保守,是故意的: 左栏一个右键加一个确认框,误触的概率远高于用户真想把整个目录连内容一起删掉。
  • 删标签是「从所有笔记的 frontmatter 里抹掉这个名字」,笔记本身一篇都不会动。
  • 冲突处理的状态记在 .conflicts/.resolved.json 里,跟着库走:整库 zip 导出再导入到 另一台机器,处理过的冲突仍然是已处理。留档文件本身永不自动删除,随时能退回未处理。
  • 版本历史存在库里的 .history/ 目录,不进笔记列表;它和 .trash/、.conflicts/ 一样 不会被当成笔记扫描。

许可

MIT

관련 플러그인