Skip to main content
T

dsh-desk-kit

tera-dark/dsh-desk-kit

Reminders, quick notes with screenshots, a bookmark grid and an encrypted vault in one sidebar tab, plus 27 agent tools, global search, and backup export/import; data stays local in ~/.dsh/desk-kit. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.

Install

dsh plugin --profile web add github:tera-dark/dsh-desk-kit

README

dsh-desk-kit · 随手台

给 DSH 的一个插件:把定时提醒、随手便签、网页收藏、加密保险库放在一个手机式的面板里, 另带 27 个 Agent 工具,让模型能自己把话记进你的随手台。

数据只落在本机 ~/.dsh/desk-kit/(可用 DSH_HOME 改根目录)。默认不发网络请求;只有你打开「网页用网站图标」、配置分类模型,或主动粘贴网页图片时,才会访问对应站点。

dsh plugin --profile desktop add github:Tera-Dark/dsh-desk-kit

30 秒上手

装完重启 DSH,从这几个地方打开(有哪个用哪个):

入口什么时候用
侧栏「随手台」标签页日常主入口(需 dsh-better-sidebar)
会话顶栏的剪贴板图标正聊着天,顺手记一句
Ctrl/Cmd + Shift + K手已经在键盘上
输入框敲 /desk-kit同上,不用记快捷键
设置 → 插件 → 随手台卡片找不到入口时最符合直觉的地方
右下角浮标没装侧栏插件时的兜底

打开后最上面就是一个输入框,说人话就行。存完会在顶部弹一条分类提示: 明确写着进了「便签 / 提醒 / 网页 / 保险库」、成功状态、事项标题和时间摘要, 几秒后自己淡出;想反悔可以直接点「撤销」,分错了还能点「转存到」。

你说它做的
帮我记一下,明天下午四点喂猫粮提醒:2026-11-19 16:00(一次性,到点提醒)
明天10点提醒我交电费提醒:2026-11-19 10:00(一次性,到点提醒)
每天晚上9点提醒我吃药提醒:每天 21:00
周一到周五 8点半 打卡提醒:工作日 08:30
记一下 周末去修耳机便签
https://example.com 这站不错,用来查资料网页:名字取域名,用途进备注
示例站点账号 demo_user 密码 abc123保险库:标题取域名,账号密码加密落盘

只有网址没有密码 / 账号 → 归「网页」;必须真拿到凭据值才进保险库。


手机快捷录入(可选)

手机通过 DSH Pocket / DSH Mobile 访问后,可以把下面这个地址加到主屏:

https://你的DSH地址/?dk=capture

打开后会直接进随手台首页、聚焦输入框;处理完自动把 dk 参数从地址栏抹掉, 刷新或再次点主屏图标不会反复弹。也可以带一段预填文本:

https://你的DSH地址/?dk=capture&text=记一下周末修耳机

注意:桌面端随手台只接受本机 Host/Origin,直接用手机打开 http://电脑局域网IP:3080 会被 403。请使用会重写 Host/Origin 的移动网关 (例如 DSH Pocket),或自己的回环隧道。


四个分类

分类能做什么
提醒一次/每天/每周/每月/每年/农历生日;默认准时,可手动提前 1~10080 分钟;到点弹卡片,可「稍后 10/30/60 分」或「今天不再提」
便签随手记;标签、置顶、完成、归档、垃圾箱;长文自动进「长期资料」并折叠;编辑时可逐张保留/删除图片
网页手机桌面式的格子(首字 + 按域名算的底色);自动归一化网址、去 tracking 参数、同网址去重、按分类分组、常用置顶
保险库账号/密码/备用码/任意长文,AES-256-GCM 加密落盘;可归入「合集」集中查看;列表只显示标题,点「显示」才解密,明文 30 秒自动收起

四类之间可以互转:存完提示里有「分错了?转存到」,每条记录右侧也有 ⇄ 图标。 转存先建新、成功才删旧;带密码的保险库条目不许转到明文分类。


保险库合集:把同类条目收在一起

保险库条目多了以后,一条条翻很费劲。新建/编辑条目时可以填一个合集名字, 列表顶部会出现合集按钮和条数,点一下就只看这一类。

  • 一层,不嵌套:合集就是名字,不建文件夹树,也不用手动维护目录;
  • 可拖拽排序:选中某个合集后,拖条目左侧的 ≡ 手柄上下挪;手机上没有拖拽,用 ↑↓ 按钮;
  • 搜索仍跨合集:搜索框会同时匹配标题和合集名,不受当前筛选限制;
  • 不改变加密:合集名和排序号只存在 vault.json 的明文元数据里,正文和附件照样加密;
  • 超过 3 个自动收起:先露 3 个和「更多 N」,点一下展开全部分类,不让一屏全是胶囊;
  • 页头分开摆:条数/合集数/加密状态在左,「新条目 / 附件」在右;条目本身也是「标题一行、动作一行」, 长邮箱、长网址不会再被一排按钮挤成几段。

比如 15 条订阅链接可以都填「梯子订阅」,点一下合集就只看这 15 条,顺序也能按常用程度排; 谷歌账号也可以统一放进「谷歌账号」合集。


附件:截完图直接粘贴

怎么给结果
面板里任意位置 Ctrl+V(截好的图)立刻存成一条便签,提示里带撤销
便签页 → 新便签 → 粘贴 / 拖文件挂在草稿上,写完字一起保存
便签页 →「附件」/「读剪贴板」文件选择器(任意格式),或直接读系统剪贴板
保险库 → 新条目 → 粘贴 /「附件」和正文一起加密,点「显示」才看得到
便签 → 编辑 →「图片/附件」区图片作为独立单位显示,点右上角 × 可单独删掉,保存后才清原件
  • 缩略图 64px,点开看大图(Esc 关闭),右下角直接下载;非图片显示扩展名。
  • 从别处复制图片:有文件就按文件存;网页图片(只有 <img> 地址)交给宿主下载后落盘; 如果剪贴板里只有一个本地路径,会明确提示「浏览器读不到这个文件」,不会再把这行路径当文字粘进便签。
  • 单个 24MB,每条最多 12 个;保险库名下的附件落盘前整块加密。
  • 附件原件在 ~/.dsh/desk-kit/blobs/,不在导出的 JSON 里 —— 完整备份要连目录一起拷。

搜索与清理

首页快搜:一个输入框搜全库 —— 便签(正文/标签)、提醒(标题/备注)、网页(标题/网址/备注/分类)、 附件(文件名)、保险库(标题)。中英别名互通:搜「脸书」也能命中写着 Facebook 的条目。

  • 结果只给「哪一类 + 命中字段 + 一小段摘要」,不会拼出第二份正文。
  • 保险库默认只搜标题;标题没命中时可以点「在内容里再找一次」,显式解密后在内存里比对, 结果只回「保险库 · 内容命中」,不回传字段值。
  • 点结果直接去对应页面:便签带着关键词进便签页;保险库会自动滚到那条并展开,30 秒后收起。
  • 保险库可以按「合集」收拢同类条目;搜索会同时匹配标题和合集名。

便签页顶部的搜索框也走同一套跨库逻辑,适合已经在便签页时直接找。

清理在 设置 →「存储与清理」:

存储与清理                       共 24.8MB
附件        ████████████████░  21.9MB
便签/提醒   █░░░░░░░░░░░░░░░░   1.4MB
保险库      █░░░░░░░░░░░░░░░░   1.5MB
垃圾箱                            3 条待清
保留                    [7天] [30天] [90天] [不清]
这些会被自动清掉(想留就先恢复):
  网页   example.com            下次清理就清掉
  便签   登录页改版,留着对比        还有 4 天
  • 清三种东西:过期垃圾箱记录(连附件原件)、宿主已不存在的附件、传上来一天没挂上的临时附件。
  • 保险库不参与自动清理(删即不可恢复);保留 0 天 = 不自动清。
  • 自动清理每 6 小时最多一次(DSH 开着时),也可以点「现在清理」立刻跑。

安全边界(先说清楚,别高估)

谁能拿到吗
局域网里的其他设备不能 — 接口只认回环地址,来源不对直接 403
你浏览的网页不能 — 无 CORS 放行;写操作要自定义头 x-desk-kit,跨源过不了预检
随手翻 vault.json只有密文
能读 ~/.dsh/desk-kit/ 的人能解密 — vault.key 与密文同目录。这是当前设计的天花板
本地其它程序能 — 同权限进程可以读文件、也可以调接口
同步盘 / 云备份会跟着走 — 不要把这个目录放进 OneDrive/iCloud

完整版(含「想更稳该做什么」)见 docs/SECURITY.md。


Agent 工具(27 个)

分组工具
一句话入口desk_capture
便签desk_note_add desk_note_list desk_note_update desk_note_delete desk_note_restore desk_note_purge desk_note_complete
提醒desk_reminder_add desk_reminder_list desk_reminder_checkin desk_reminder_delete desk_reminder_restore desk_reminder_purge desk_due
保险库desk_secret_add desk_secret_list desk_secret_get desk_secret_delete
网页desk_link_add desk_link_list desk_link_delete
附件desk_file_add desk_file_list
查找 / 维护desk_search desk_cleanup desk_item_move

对 Agent 说这些话就会命中:「记一下:周末去修耳机」「提醒我每天 9 点吃药」「我今天打卡了」 「把某站账号 demo_user / 密码 xxx 存起来」「把那张截图存起来」「我之前记过什么?」


数据目录与备份

~/.dsh/desk-kit/        # 默认;DSH_HOME 可改根目录
├── data.json   便签 + 提醒 + 网页 + 附件元信息 + 告警(明文,可 cat/diff)
├── vault.json  保险库条目(每条独立 AES-256-GCM 密文)
├── vault.key   主密钥材料(0600;丢了 vault.json 就解不开)
└── blobs/      附件原件(普通 .bin,保险库名下 .enc)

设置页可以「导出为 JSON」;提醒和便签是明文,保险库导出的是密文。 导出不含附件原件,换机器要连 blobs/ 一起拷,并且带上 vault.key。


开发自测

npm test            # 存储 / 分拣 / 农历 / 客户端渲染 / 归属 / AI 分类 / 入口
npm run test:host   # 桩掉 webServer,真起 HTTP:API、27 个工具、附件、转存、清理、导入
npm run test:installed  # 按装好的样子加载一遍
npm run test:ui     # 真浏览器里点一遍:粘贴截图 → 缩略图 → 大图 → Esc → 搜索 → 提醒 Enter → 深链录入 → 分类提示自动消失

需要 react / react-dom:从 DSH profile 里取,没有就装在本仓库。

改客户端改 src/client/*.js,不要直接改 client.js —— 后者是拼接产物:

npm run build        # src/client/*.js → client.js(按文件名顺序拼)
npm run build:check  # 只看「产物是否与源码一致」,npm test 会自动先跑它

宿主只加载 client.js 一个文件(单文件 bundle,不能 import),所以用拼接换可维护性, 不引入打包器、不引入运行时依赖。


变更历史

逐版本的「为什么 + 验收」都在 CHANGELOG.md。当前版本 1.22.0。

Related plugins