Skip to content
dsh marketplace

dsh-scratchpad

Verified

@chaiyahang/dsh-scratchpad · v0.2.6 · MIT · Web UI

Scratchpad panel for DeepSeek Harness: tagged notes, image and file attachments, Markdown preview with clickable tasks, send-to-chat with real attachments, a wake-up shortcut, JSON export/import, and Agent tools over Host-side storage.

Install

dsh plugin add @chaiyahang/dsh-scratchpad

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

便签 · DSH Scratchpad

test npm npm downloads license

给 DeepSeek Harness 的左栏便签插件：随手记、边写边存，Agent 也能读写。

要求 DSH >=0.2.1-rc.2；版本变化见 CHANGELOG。

功能

  • 左侧栏入口：点击打开便签面板，⌘⇧S 唤起聚焦，⌘⇧N 直接新建，⌘⇧F 聚焦搜索
  • 多条便签：边写边存、置顶、搜索、删除二次确认，删错 7 天内可撤销，回收站可随时恢复或彻底删除
  • 附件：图片/文件，支持选择、拖拽、粘贴；图片预览，文件下载
  • Markdown 预览：标题、强调、代码、列表、引用，链接可点击；- [ ] 待办可勾选并写回原文
  • 发送到对话：一键送入当前输入框，图片/文件作为真实附件一并带上
  • 标签：最多 12 个/条，列表按标签筛选
  • 导入导出：单个 JSON（附件以 base64 内嵌），导入为合并语义
  • Agent 工具：scratchpad_list / read / create / append / update / delete

安装

把 PROFILE 换成你的 profile 名（例如 desktop）。从 npm：

dsh plugin --profile PROFILE add @chaiyahang/dsh-scratchpad@latest

从 GitHub（跟随默认分支）：

dsh plugin --profile PROFILE add github:Chaiyahang/dsh-scratchpad

或让插件管理器安装本地目录：plugin_manager install_bundle /路径/到/dsh-scratchpad。装完刷新页面。

从本地 link: 安装切换到 npm 时，pnpm add <包名> 会保留原来的 link；请用上面的 @latest，或先 dsh plugin --profile PROFILE remove @chaiyahang/dsh-scratchpad 再安装。

使用

操作 方式
唤起 ⌘⇧S / 点击左栏「便签」
新建 「新建便签」或 ⌘/Ctrl + Enter
标签 编辑器下方输入，回车/逗号确认，Backspace 删最后一个
预览 工具栏「预览」，勾选待办会写回 - [x]
发到对话 卡片纸飞机，或编辑器「发到对话」
备份 列表右上「导出 / 导入」

Agent 工具

工具 用途
scratchpad_list 列出便签，按文本/标签过滤
scratchpad_read 读全文、标签与附件绝对路径
scratchpad_create 新建（可带标签、置顶）
scratchpad_append 追加一段
scratchpad_update 重写正文，可选替换标签
scratchpad_delete 删除便签及附件文件

数据与限制

  • 数据在 ~/.dsh/scratchpad/（notes.json + files/），不经过外部网络；卸载不清除
  • 每次写入前自动轮转 notes.json.bak；文件损坏时自动留档为 notes.json.corrupt-* 并从备份恢复
  • 图片直接预览；其他附件一律下载，不在浏览器内打开
  • 附件是真实文件，Agent 读取时拿到绝对路径；Markdown 渲染不执行 HTML
  • UI 保存会检测其他改动（另一窗口或 Agent）：冲突时面板让用户选择「保留我的版本 / 改用已保存版本」，不会静默覆盖；Agent 工具之间仍是最后写入优先
  • 删除为软删除：面板立即隐藏，7 天后连同附件文件一并清理；面板内「回收站」可查看、恢复或彻底删除，Agent 的删除同样可在此期间撤销
  • 导入只有合并模式；数据仅本机，不跨设备同步
  • composer 不接受附件时（子会话、类型不支持等），附件名会以文本形式保留

开发与发布

node --check index.js && node --check client.js
npm test

打 v* tag 推送后，.github/workflows/publish.yml 通过 npm Trusted Publishing（OIDC）自动发布，并以 CHANGELOG 对应版本段落为 notes 创建 GitHub Release；首次启用需在 npm 包设置登记仓库与工作流，并设置仓库变量 NPM_TRUSTED_PUBLISHING=true。

链接

MIT