前言¶
在开发基于 DeepSeek Harness (DSH) 的智能体应用时，频繁的复制粘贴操作容易导致历史内容丢失，或需要回溯之前的文本片段。dsh-clipboard-history 插件解决了这一痛点。它持续监控系统的剪贴板，将复制过的内容按时间顺序存入持久化文件，并提供 Web 面板与 Agent 工具供调用。
插件定位¶
该插件属于 DSH 生态的「记忆」分类，由开发者 qqyumidi 维护。它是一个功能等价的动态与静态插件，核心价值在于将系统剪贴板转化为可检索、可管理的结构化历史记录。
核心功能¶
- 系统剪贴板监控
支持 macOS (pbpaste/pbcopy)、Linux (xclip/wl-paste) 以及 Windows PowerShell。 - 持久化存储
历史记录上限为 500 条，超出后自动丢弃最旧的记录。数据存储在~/.dsh/clipboard-history。 - Web 面板操作
通过会话标题栏的「📋 剪贴板」按钮打开。支持搜索过滤、单条复制回系统、删除单条、暂停/恢复监听以及清空历史。 - Agent 工具注册
为模型注册了四个工具接口：
-clipboard_get：读取当前剪贴板内容
-clipboard_history_search：搜索历史记录
-clipboard_copy：将内容写入剪贴板
-clipboard_history_delete：按 ID 删除历史记录
安装与启用¶
通过官方命令安装，并重启 Web 服务以使配置生效。
dsh plugin --profile web add github:qqyumidi/dsh-clipboard-history
dsh web
典型用法¶
- Web 端操作：点击会话标题栏右侧的「📋 剪贴板」按钮打开面板，在搜索框输入关键词过滤，点击条目即可复制，或点击「🗑 删除」移除单条。
- Agent 端操作：直接调用
clipboard_get工具获取当前剪贴板内容，或使用clipboard_history_search查询历史记录。
技术细节¶
- 通信机制：Host 与 Client 通过 HTTP 端点
/clipboard-api/*进行通信。 - 轮询间隔：插件以 1.5 秒为间隔轮询系统剪贴板变化。
- 文件结构：静态版与动态版功能等价，历史文件路径为
~/.dsh/clipboard-history。
注意事项¶
- 本插件以当前 DSH 进程的权限运行，安装前请检查源码与许可证（MIT）。
- 历史记录上限为 500 条，旧记录会被自动覆盖。
结语¶
该插件通过将系统剪贴板本地化与结构化，降低了智能体开发中管理文本历史的门槛。更多细节可参考 GitHub 仓库。
