dsh-clipboard-history

English | 中文

一个 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 进程中，因此无需原生插件即可访问当前登录用户的剪贴板。