dsh-notepad
Manifest validAdds a notepad to the DSH Web UI that floats as an edge-snapping, resizable card or docks into the real bottom layout row, switchable at runtime with shared text and images; notes auto-save (text in l
DSH 记事本插件
DSH(DeepSeek Harness)Web 界面上的记事本,两种摆放模式随时切换,同一个笔记两处共享:
- 悬浮模式(默认):浮动卡片,拖动标题行移动,松手时靠近哪一边就吸附到哪一边——上、下、左、右四边都能停,拖出窗外则收成贴边把手。
- 停靠模式:挂在框架真实布局的底栏(
shell.bottom),上方三栏自动变矮,永不遮挡。
两个模式各有切换按钮:悬浮卡片标题栏的「停靠到底部」图标、底栏标题行的「脱离为悬浮卡片」图标。

上图为设计示意图,实际配色与字号以运行中的 DSH 主题为准。
功能
- 模式开关:悬浮 ↔ 底部停靠一键切换,文字与图片完全共享,切换时正在进行的内容会先落盘,不会丢。
- 自动编号:点工具栏「编号」把当前行变成
1.并开启自动编号——回车自动续号(2.、3.…),在空的编号项上回车则结束列表;支持1.与1)两种写法,缩进层级跟着保留。开启后工具栏会多出「重新编号」,一键把所有编号行按缩进分组重排成 1、2、3…(插入或删除过条目后特别好用)。 - 待办:
- [ ]/- [x]行就是待办。点「待办」把当前行转成待办(已勾选则取消勾选),回车自动补下一条未勾选项;点「清单 n/m」弹出全部待办,点一行即可勾选/取消,源码里的标记同步改写,弹层底部还能「清除已完成」一次删掉所有勾选过的条目。 - 四边自动吸附:拖动中实时比较到四边的距离,≤64px 时贴边(左/右贴 x,上/下贴 y),边框与圆角随之贴合。
- 待办面板:点「清单 n/m」在正文上方展开可交互的待办面板——勾选框直接勾选(源码里的
- [ ]/- [x]同步改写),点文字跳到笔记里对应那一行,面板头还能「清除已完成」。 - 图片链接(超链接式):每张缩略图带一个
#abcd标签,点标签(或缩略图上的链接按钮)就在光标处插入[[img:abcd]];光标停在这个标记里时对应缩略图会高亮描边,再点标签则直接跳到已有的标记处。 - 复制图片:缩略图悬停出现「复制」按钮,直接把图片字节写进剪贴板(环境不支持时退化为复制那串链接标记)。
- 自由移动:标题行 40px 是拖拽把手,面板任意停在画面中间也行;位置随窗口夹紧,不会跑出可视区。
- 四边都能改尺寸:上/下/左/右四条边各有一条 6px 热区——拖哪条边就改哪个方向,对边保持不动(所以拖左边/上边时面板会跟着走);右下角另有 14px 热区可同时改宽高。260×180 起,上限随窗口自适应。
- 可以拖出窗口外:把卡片往窗外一带(超出窗口 ≥40px),松手就收成贴着窗口边的一条把手(32px 厚),既不遮挡内容又随时能点回来;窗口内的四边吸附照常保留。
- 可收起:标题行右上角收起按钮 → 变成 44×44 小方块,小方块本身也能拖动吸附到任意边,点一下展开(拖动过就不会误触展开)。
- 图片:三个入口——标题栏图片按钮、直接拖进卡片、
Ctrl+V粘贴截图。超过 1600px 或 900KB 的自动缩放到 1600px 内并转 WebP。 - 图片查看:右侧缩略图栏,点开全屏大图预览,
Esc或点背景关闭;缩略图右上角小叉删除。 - 自动保存:文字 250ms 防抖存
localStorage,图片 Blob 存IndexedDB(不占localStorage配额);底部实时显示「已保存 / 保存中」与字数、图片数。 - 跟随主题:颜色全部取自
--dsw-alias-*主题变量;文案走 Client locale 服务,中英双语。
安装
从 GitHub 安装
dsh plugin --profile desktop add github:879745uhjun/dsh-notepad
装好后刷新 Web 页面即可看到卡片。
从本地目录安装
在已安装 DSH 的 profile 中用插件管理器安装本目录:
plugin_manager install_bundle target: <本仓库路径> enabled: true
插件会写入 profile 的 node_modules 并注册到 dsh.profile.bundles。装好后刷新 Web 页面即可看到卡片。
结构
| 文件 | 作用 |
|---|---|
package.json | 包清单;dsh.bundle.patch 指向 cordis.patch.yml,dsh.client 声明 Web 端注入 |
cordis.patch.yml | 向 profile 组合插入一行 dsh-notepad |
index.js | host 半边,空实现(插件只需客户端渲染) |
client.js | 客户端全部逻辑:同时注册 shell.overlay(悬浮卡片)与 shell.bottom(底部停靠)、共享状态、吸附、拖拽、图片、持久化、样式、locale |
locale/zh.json、locale/en.json | Plugin Manager / 设置页读取的插件名称与描述 |
icon.svg | 插件图标 |
design-schematic.png | 本文档顶部的界面示意图 |
实现要点
- 两个槽同时注册:
shell.overlay(悬浮)与shell.bottom(停靠)。两个组件都常驻挂载,只渲染当前模式的那一个;shell.bottom的内容渲染成null时不占高度(槽说明里写明的行为),所以切到悬浮模式底栏会完全让出空间。 - 文字与图片放在一个模块级 store 里(
subscribe+emit),两处界面共享同一份数据;切模式时先把未落盘的内容同步写一次,避免丢字。 - 挂载在
shell.overlay:框架唯一的全窗口悬浮层,条目默认可点击(pointer-events由每条自己开启)。 - 坐标直接用视口坐标(
left/top),只把顶部标题栏那条--dsh-frame-chrome-top让开,避免压住可拖动窗口的标题栏。 - 吸附判定:
nearestEdge()比较四边距离取最近者,snapTo()只改对应那一轴,另一轴保持原位——所以可以贴着上边缘靠右、也可以贴着左边靠下。 - 拖动过程中位置写进
useRef,松手时用最终坐标判定吸附,避免 React 状态滞后导致的“差一点没吸上”。 - 边缘缩放时记录“对边”坐标(rightEdge/bottomEdge),每帧用
对边 - 新尺寸反推新位置,缩到下限时对边不会漂移。 - 大图预览用
position: fixed覆盖视口,不受卡片尺寸限制。 - 不引入任何
@deepseek-ai/dsh-client-*包,React 由浏览器模块表提供,避免和宿主重复加载。
测试
插件是浏览器模块(window.__ModuleLoader__.load),Node 里无法 import,所以测试直接从 client.js 切出纯函数再求值——测的就是要发布的那份源码,不存在测试副本与实现漂移。改名或删函数会让测试直接报错。
npm test # 等价于 node --test "test/**/*.test.mjs"(Node 24 下不能传目录)
| 文件 | 覆盖 |
|---|---|
test/lines.test.mjs | 编号续号 continueLine、startTodo、toggleTodoAt、parseTodos、clearDoneTodos、renumberAll |
test/snap.test.mjs | 吸附取边 nearestEdge、snapTo(四边、阈值边界、平局、标题栏偏移) |
test/extract-source.test.mjs | 切片器自身:字符串/模板/注释里的 {``} 不会截断、缺函数报错、括号不配对报错 |
test/helpers/extract-source.mjs | 按名字从源码切片并求值(引号与注释感知),缺函数即失败 |
共 27 个用例,零依赖。故意把 SNAP 从 64 改成 40 时,正好两个阈值用例失败,说明断言真的咬住了实现。
没覆盖的部分(都不是纯函数):吸附的“松手释放判定” settle()(读 livePos ref 与 bounds() 里的 innerWidth/getComputedStyle)、拖拽与四边缩放的指针流程、光标相关逻辑(selectionStart/scrollTop)、IndexedDB 图片存储、canvas 压缩与 ClipboardItem、以及两个界面的 React 渲染。要测这些得引入 DOM/IDB 模拟环境;下一步最小改法是把 settle() 的决策抽成纯函数 resolveRelease(pos, size, box)。
工具
tools/push-via-api.mjs —— 当 github.com:443 不通、git push 超时而 api.github.com 可用时,用 GitHub REST Git Data API 把当前提交写到远端:
node tools/push-via-api.mjs --repo <owner>/<name> --branch main # 真推
node tools/push-via-api.mjs --repo <owner>/<name> --branch main --dry-run # 只校验,不写
- 逐字节复现本地提交(blob / tree / parents / message / 作者与提交时间),远端 sha 与本地 HEAD 完全相同;任一处不匹配就在动 ref 之前中止
- 空仓库需要
--bootstrap(REST 的 blob 接口在空仓库上返回 409) - 不内置 token:读
GH_TOKEN/GITHUB_TOKEN,否则调用gh auth token - 推送成功后会执行
git update-ref refs/remotes/origin/<branch>——REST API 不更新本地跟踪引用,不补这一步git status会一直显示幻影ahead N,看起来像没推上去 --dry-run已验证可用:逐个比对 blob sha、tree sha,并报告远端分支是否已等于 HEAD
已知限制
- 真正的“浮在窗口外”做不到:插件渲染的是网页内容,浏览器只能在自身窗口内绘制,框架还用
overflow:hidden裁掉越界部分。要让界面浮在桌面上,得创建独立的原生窗口——那超出插件契约(需要改 DSH 本体)。所以这里提供的是“贴边收成把手”的近似方案:看上去挂在窗外,实际是窗口内最外侧的一条。 - 悬浮卡片会盖住下方内容(这是浮层的固有属性);放在边缘、收成把手或小方块可把影响降到最小。
shell.overlay之上还有框架自己的遮罩(例如左侧栏抽屉展开时),那时卡片暂时点不到,关掉抽屉即可。shell.bottom是单占位槽;停靠模式下它由本插件占用,若将来官方也往这一行注册内容,两者会互相顶替(后注册者优先)。- 图片按 Blob 存 IndexedDB,属于浏览器本地数据,不随 DSH profile 迁移。
Comments
Loading…
Similar plugins
by boogoo619
Workspace-wide sticky notes on an infinite canvas: notes are plain Markdown files, created manually, captured from conversations, or distilled by the AI, and can be handed back as context; ships 12 mo
★ 3
↓ 270/wk
MIT
JavaScript
Nov 9, 2026
dsh plugin --profile web add dsh-noteboardA notebook inside DeepSeek Harness: one page, typeset as you write, with suggestions, structure and translation at the edge of the page.
★ 0
MIT
JavaScript
dsh plugin --profile web add @tyouter/dsh-notesby zhxnix
WYSIWYG Markdown notes editor in the DSH right sidebar, with tabbed documents, table editing, chat integration, assistant read/write tools, and local file export.
★ 0
MIT
JavaScript
Nov 1, 2026
dsh plugin --profile web add dsh-madedownby liaoangbo-droid
Sticky notes wall in the sidebar: rich text, images, ink, drag-to-reorder, per-note alarms, and scheduled delivery of a note into a session. Its read-only /state and /media routes have no authenticati
★ 40
MIT
JavaScript
Nov 13, 2026
dsh plugin --profile web add dsh-notewallby Shrbuz
Floating notes for the dsh web GUI: keep commands, credentials and snippets at hand, insert any note into the composer, save any selection as a note
★ 7
↓ 56/wk
Apache-2.0
JavaScript
Sep 18, 2026
dsh plugin --profile web add dsh-web-notesDockable Markdown preview for the DSH Web UI: side-by-side with the conversation, a per-session recently-read .md list, local relative-path images render in place, and clicking an in-chat .md referenc
★ 0
dsh plugin --profile web add dsh-md-preview