便签 · DSH Scratchpad
给 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
