剪贴板历史kuangre123/dsh-clipboard-history

dsh-clipboard-history

一个 DeepSeek Harness（dsh）
插件：在后台监测系统剪贴板，保存多条剪贴内容的可调用历史记录。

功能

- 监测剪贴板：在后台轮询系统剪贴板（macOS 用 pbpaste、Linux 用 xclip、
Windows 用 PowerShell），把每一次文本变化记录进持久化历史文件。
- 持久化：历史保存在 $DSH_HOME/clipboard-history.json，重启后不丢失。
- 为 agent 暴露五个工具：

| 工具 | 用途 |
|---|---|
| clipboard_list | 列出最近的历史条目（id、时间、大小、预览）。 |
| clipboard_get | 按 id 取回某一条的完整文本。 |
| clipboard_current | 立即读取当前剪贴板内容。 |
| clipboard_copy | 把文本写入系统剪贴板并记入历史。 |
| clipboard_clear | 清空历史（不影响当前系统剪贴板）。 |

安装

dsh 的插件管理依赖 pnpm（缺失时先通过 corepack 启用）
corepack enable

从 npm 安装（发布后）
dsh plugin --profile web add dsh-clipboard-history

或从本地目录安装
dsh plugin --profile web add file:/绝对路径/dsh-clipboard-history

然后重启 web 应用（dsh web）以加载新的 host 插件。

dsh plugin 命令会把参数转发给 profile 目录内的 pnpm，并自动对账
dsh.profile.bundles：由于本包声明了
"dsh": { "bundle": { "patch": "./cordis.patch.yml" } }，它会被加入 profile 的
patch 层栈。

配置

编辑 profile 的 cordis.patch.yml 里对应的行（或 bundle 插入的 config 块）即可调参：

- id: clipboard-history
config:
pollIntervalMs: 700   # 剪贴板轮询间隔（毫秒）
maxHistory: 200       # 最多保留的条目数
maxEntryChars: 50000  # 单条最多存储的字符数
previewChars: 160     # clipboard_list 中预览的长度
historyFile: clipboard-history.json  # 相对 DSH home 的路径
poll: true            # 设为 false 可关闭后台监测

说明与限制

- 仅支持文本。图片 / 文件剪贴板会被忽略（读取为空文本）。
- macOS 为主要目标平台；Linux 需要 xclip，Windows 使用 PowerShell。
- 插件运行在 host 进程中，因此无需原生插件即可访问当前登录用户的剪贴板。