前言¶
在 DeepSeek Harness（DSH）里和 Agent 协作时，上下文、待办和参考材料往往散落在对话里：关掉会话就不方便找回，模型侧也没有一个稳定的「本机笔记」入口。浏览器书签或外部笔记可以记，但和「发到当前对话」「让 Agent 直接读路径」之间还要复制粘贴。
下面介绍维护者 Chaiyahang 发布的 dsh-scratchpad（npm 包名 @chaiyahang/dsh-scratchpad）。它是 DSH 的客户端便签插件，数据落在本机 ~/.dsh/scratchpad/，并提供一组 Host 侧 Agent 工具，便于人和 Agent 共用同一套便签。插件当前为 Beta，要求 DSH >=0.2.1-rc.2；社区目录分类为「记忆」，GitHub 星标为 1。
这是什么¶
dsh-scratchpad 给 DeepSeek Harness 增加左侧栏「便签」面板：随手记、边写边存，支持标签、Markdown 预览与待办勾选、图片/文件附件，以及一键送入当前对话输入框。Agent 可通过 scratchpad_list、scratchpad_read、scratchpad_create 等工具读写同一份存储，不依赖外部网络同步。
许可证为 MIT；最新发布版本见 npm 与仓库 CHANGELOG（资料中 package.json 所示版本为 0.2.4）。
核心功能¶
界面与快捷操作¶
- 左栏点击「便签」打开面板；快捷键
⌘⇧S唤起并聚焦输入框（Windows/Linux 上通常为 Ctrl 组合键，以 DSH 客户端实际绑定为准）。 - 多条便签：边写边存、置顶、搜索、删除需二次确认。
- 新建：「新建便签」或
⌘/Ctrl + Enter。
内容与附件¶
- Markdown 预览：标题、强调、代码、列表、引用；
- [ ]待办可在预览中勾选，写回为- [x]。 - 附件：图片/文件，支持选择、拖拽、粘贴；图片可预览，文件可下载。附件为真实文件，Agent 读取时得到绝对路径；Markdown 渲染不执行 HTML。
标签与筛选¶
- 每条便签最多 12 个标签；在编辑器下方输入，回车或逗号确认，Backspace 删除最后一个。
- 列表可按标签筛选。
与对话联动¶
- 发送到对话：卡片上的纸飞机图标，或编辑器内「发到对话」，将内容送入当前输入框；图片/文件作为真实附件一并带上。若当前 composer 不接受附件（子会话、类型不支持等），附件名会以文本形式保留。
导入导出¶
- 列表右上角「导出 / 导入」：单个 JSON，附件以 base64 内嵌；导入为合并语义，不会覆盖式替换全部数据。
Agent 工具¶
| 工具 | 用途 |
|---|---|
scratchpad_list |
列出便签，按文本/标签过滤 |
scratchpad_read |
读全文、标签与附件绝对路径 |
scratchpad_create |
新建（可带标签、置顶） |
scratchpad_append |
追加一段 |
scratchpad_update |
重写正文，可选替换标签 |
scratchpad_delete |
删除便签及附件文件 |
UI 与 Agent 同时修改同一条便签时，以最后写入为准。
安装与启用¶
安装前请自行查看仓库源码与 MIT 许可证；插件在 DSH 进程权限下运行，便签与附件均在本机目录。
把 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
装完后刷新 DSH 页面。若曾用本地 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_append，整段重写用 scratchpad_update。具体参数以 DSH 工具 schema 为准。
数据位置与限制¶
- 数据目录：
~/.dsh/scratchpad/（notes.json+files/），不经过外部网络；卸载插件不会清除这些数据。 - 导入仅有合并模式；不跨设备同步。
- 市场收录：README 注明等待 dshopen 收录；社区目录页为 skillhub 插件页，与 DeepSeek / 幻方无官方从属关系，属于 DSH「一切皆插件」生态中的独立条目。
结尾¶
dsh-scratchpad 把「本机便签 + 对话发送 + Agent 工具」收进 DSH 左栏，适合需要本地记忆、待办 Markdown 和附件与 Agent 共享路径的开发者。安装与问题反馈可参考：
- 目录页：https://www.skillhub.cn/plugins/Chaiyahang/dsh-scratchpad
- 仓库：https://github.com/Chaiyahang/dsh-scratchpad
- Issues：https://github.com/Chaiyahang/dsh-scratchpad/issues
