前言¶
在使用 DSH(DeepSeek Harness)编写内容时,经常遇到这样的场景:刚想好一句话,按回车就送进了模型;或者把想法记在别的笔记应用里,切回来时上下文已经凉了。这个插件在 composer 工具栏加一个入口,把草稿格固定在输入框旁边,回车只换行,内容只存本机 localStorage。
这是什么¶
dsh-composer-scratchpad 是一个客户端插件,作者为 br0caz。它的核心是输入框边上的一块草稿格:点工具栏那支铅笔,弹出一个纯净文本框,先把灵感写进去,回车只换行,永远不会发出去。想好了再自己挪进输入框。
解决什么问题¶
- 避免误触:直接敲进输入框,一行回车就把半成品发出去了;
- 保留上下文:写进别的笔记应用再切回来,上下文已经凉了;
- 状态一致:内容仅存本机
localStorage,所有会话共用同一份,切会话、切项目、刷新、重启都不丢。
核心功能¶
- 在 composer 工具栏增加一个入口:挂载点为客户端插槽
conversation.input.right,由@deepseek-ai/dsh-client-ui-conversation提供,位于模型选择器左边。 - 纯净文本框:没有文件夹、没有标签、没有多页、没有发送按钮。
- 只换行:键盘事件在面板内就地截断,不进主编辑器的提交链路。
- 可调整大小:拖动右下角把手可改变面板尺寸,双击把手回到默认 380×220。
- 内容提示:图标右上角小点表示里面还有内容。
- 数据存储:只写本机
localStorage,键名为dsh-composer-scratchpad(历史键名dsh-memo-pad:*),不联网、不进会话、不上传。
安装与启用¶
桌面端 / 网页端(图形界面)¶
在侧栏插件面板里添加 GitHub 源:
github:br0caz/dsh-composer-scratchpad
命令行¶
dsh plugin --profile web add github:br0caz/dsh-composer-scratchpad
走 npm(发布之后)¶
包还没发到 npm,上面两条走的是 GitHub 源。等 dsh-composer-scratchpad 上架 npm 之后,才可以只写包名:
dsh plugin --profile web add dsh-composer-scratchpad
装完重启内核(客户端模块清单在启动期生成)。从源码或本地路径装时,改完 client.js 还要 Ctrl+Shift+R 硬刷新一次——客户端 bundle 带 cache-control: immutable,普通刷新不会重新拉。
运行环境¶
- 宿主:DSH Web 端(
dsh web)或桌面端;桌面端跑的仍是profiles/web这一套 - DSH 版本:
>= 0.2.0(见engines.dsh)。0.2.1-rc.2实测正常,更早版本未验证 - 挂载点:客户端插槽
conversation.input.right,由@deepseek-ai/dsh-client-ui-conversation提供 - 浏览器:任何支持
localStorage的浏览器;桌面端内嵌 WebView 同样可用 - Node:
>= 18,只用于npm test;插件本身运行不需要 Node - 网络:不需要。零依赖、无构建步骤、不发起任何请求
排查工具栏没有铅笔图标¶
装上后工具栏没有铅笔图标,就按这个顺序排查:
- 重启内核——客户端模块清单在启动期生成,热装不会自动进清单;
Ctrl+Shift+R硬刷新——客户端 bundle 带cache-control: immutable,普通刷新拉不到新的;dsh plugin list --profile web确认插件真的进了bundles;- 都没有就核对宿主版本,
conversation.input.right在这个版本里是否还存在。
典型用法¶
| 操作 | 结果 |
|---|---|
| 点铅笔图标 | 打开 / 收起面板 |
Esc 或点面板外 |
收起 |
Enter |
只换行(键盘事件在面板内就地截断,不进主编辑器的提交链路) |
| 拖动右下角把手 | 左拖变宽、上拖变高(面板贴着工具栏往上弹) |
| 双击把手 | 回到默认 380×220 |
| 图标右上角小点 | 表示里面还有内容 |
第一次打开时会浮出一句「可拖动调整大小」,2.4 秒淡出。判据是教到会为止:拖过一次就永不再提;没拖过最多提 3 次。
适用场景与注意¶
适合需要在 composer 旁边快速草拟内容,但还没有决定是否发送给模型的人。
面板配色只按深色主题写过(#2a2b2f),浅色主题下会难看——那是外观问题,不是装错了。
内容不进工作区文件,AI 读不到(同样是有意的:这是你的草稿,不是给模型的上下文)。
插件以当前 dsh 进程权限运行,安装前应检查源码与许可证(MIT)。
短结尾¶
dsh-composer-scratchpad 只做一件事:你还没决定发不发的那一句话。适合需要临时草稿格的开发者,安装后即可在 composer 工具栏使用。
- 目录页:https://www.skillhub.cn/plugins/br0caz/dsh-composer-scratchpad
- GitHub:https://github.com/br0caz/dsh-composer-scratchpad