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.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:magicbaobaoli/dsh-getnote
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
左侧栏一个入口,中央一块面板。既直接操作得到大脑(原 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,
但它是录音的转写附件,混进列表会让人点「笔记」却打开转写。
安装
从索引源安装(推荐)
- 打开 DSH 的插件页,切到发现标签(若没有,先在插件设置里打开「自定义插件索引」)
- 添加索引源,填这个地址:
https://magicbaobaoli.github.io/dsh-getnote/index.json - 找到「得到大脑」,点安装
从 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
Links
More in this category
tt-a1i/archify#integrations/deepseek-harness★ 97127
Generate validated, self-contained interactive architecture, workflow, sequence, data-flow, and lifecycle diagrams from repositories or system descriptions.
dream-num/dsh-univer-office★ 728
Give DeepSeek Harness a real office environment. Univer Office Plugin brings spreadsheets, docs, slides, canvases, relational tables, and more into one runtime — with connected data, validation, versioned changes, and isolated worktrees for multi-agent collaboration.
Roland0511/dsh-marktext★ 702
WYSIWYG Markdown editor in the DSH right sidebar, built on MarkText's muya engine: open a .md file, edit it as a rendered document, and save back through ctx.fs with a version guard.
ECNU/EduWork#dsh-knowledge-studio★ 370
A workspace-based Studio for source-grounded reports, slides, tables, mind maps, quizzes, flashcards, audio and video, using DSH models and shared artifact services. Office generation requires Python 3.12+ with its dependencies and DSH_OFFICE_PYTHON configured; media rendering requires Chromium, and local ASR additionally requires whisper.cpp and a model.
PerryLink/dsh-industry-research★ 219
Deterministic industry research reports for DeepSeek Harness — company and industry research flows produce structured, verifiable reports from staged evidence.
joeseesun/qiaomu-ui-learn-dsh★ 85
Browse UI design references and interaction examples, take design quizzes, and export learning notes as Markdown.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.