前言¶
在 DeepSeek Harness（DSH）里跑智能体或调试会话时，经常需要临时记下 API 路径、待办或一段草稿，却不想切到系统记事本或外部笔记应用。浏览器标签页一多，上下文也容易丢。社区插件 dsh-plugin-scratchpad（维护者 wake2008dingtalk-sys，目录分类为「记忆」）在 Harness 客户端左侧栏增加一个 Scratchpad（中文界面为「随手便签」）入口，点击后在主栏打开多行便签，内容只写入当前浏览器的 localStorage，不上传服务器。下面介绍它的定位、能力与安装方式。
这是什么¶
dsh-plugin-scratchpad 是一个 DSH bundle 插件：通过 cordis.patch.yml 向宿主注册插件行，客户端在全局侧栏面板列表（sidebar.panellist，id scratchpad，order 20）增加一项图标，与内置插件、日程等入口并列；点击后由宿主 ctx.layout.selectPanel() 选中中央面板（main，key scratchpad）。宿主侧 index.js 仅导出空的 apply()，界面与交互在纯 JavaScript 的 client.js 中实现，不依赖 Harness Client 包导入，经浏览器模块加载器注册。
源码与说明见 GitHub：wake2008dingtalk-sys/dsh-plugin-scratchpad。社区目录页：SkillHub 插件条目。许可证为 MIT。
核心功能¶
侧栏与主面板¶
- 左侧栏增加 Scratchpad 图标；侧栏负责按钮样式，选中逻辑走 Harness 布局 API。
- 主栏提供多行便签输入区，带实时字符计数和 Clear（清空）操作。
本地持久化¶
便签通过浏览器 localStorage 保存，数据不离开本机。换浏览器或清站点数据会丢失内容，需自行备份重要笔记。
国际化与主题¶
界面文案经 dsh Client 的 locale 服务路由，提供 locale/en.json 与 locale/zh.json，侧栏标签与面板随当前语言切换。样式仅使用 dsh 主题 token（--dsw-alias-*），与客户端主题一致。
安装与启用¶
本仓库是 DSH bundle 包：package.json 声明 dsh.bundle.patch 与 dsh.client web 模块。安装前请将仓库下载或解压到本机某一目录（README 允许 clone 或 download；勿在文档中把 clone 当作唯一方式，但安装命令指向的是该目录的绝对路径）。
在 DSH 会话中，用插件管理器指向该目录安装：
plugin_manager install_bundle target=<absolute path to this repository>
插件管理器会把包链入当前 profile、选中 bundle 并应用。全新安装可通过 HMR 激活，一般无需重启进程。安装完成后，左侧栏会出现 Scratchpad 图标，点击即可打开便签面板。
卸载：
plugin_manager remove_bundle @local/sidebar-scratchpad
npm 包名为 @local/sidebar-scratchpad（package.json 版本 1.0.0）。
典型用法¶
- 按上文命令完成
install_bundle。 - 在 Harness Web 客户端左侧栏找到 Scratchpad / 随手便签图标并点击。
- 在中央面板输入临时笔记；关闭页面或刷新后，同一浏览器下内容仍从
localStorage恢复。 - 需要清空当前便签时使用面板上的 Clear。
无额外配置文件或环境变量；行为以 README 与 client.js 为准。
适用场景与注意¶
适合：在同一 DSH Web 会话中快速记调试信息、命令片段、会话要点，且希望数据留在本机、不经过插件服务端。
兼容说明：README 标明在 DeepSeek Harness 0.2.1-rc.5（developer preview）上构建验证；所依赖的 client slot 契约可能在后续版本变化，升级 Harness 后若侧栏或面板异常，需对照上游变更与插件仓库 Issue。
安全与信任：插件以当前 DSH 进程及浏览器上下文运行；安装前应阅读 index.js、client.js、cordis.patch.yml 与许可证。本插件仅使用 localStorage，不涉及远程上报，但仍属社区第三方 bundle，非 DeepSeek / 幻方官方组件。SkillHub 等社区目录为独立站点，与官方无从属关系。
结尾¶
dsh-plugin-scratchpad 把「随手记」收进 Harness 左侧栏与主栏，用本地存储完成记忆类需求，实现路径清晰、卸载命令明确。需要详情或提 Issue 时，可访问 GitHub 仓库 与 SkillHub 目录页。
