qqyumidi
dsh-clipboard-history
DSH clipboard history manager: monitor system clipboard, searchable persisted history, Web panel + agent tools
- Stars
- 0
- Language
- JavaScript
- Created
- Aug 16, 2026
- Updated
- Aug 16, 2026
Introduction
dsh-clipboard-history
监控系统剪贴板,保留可搜索的历史记录,并提供 Web 面板与 Agent 工具。
DeepSeek Harness(DSH)剪贴板历史管理器:持续监听系统剪贴板(macOS pbpaste/pbcopy、Linux xclip/wl-paste、Windows PowerShell),把复制过的内容按时间存入 ~/.dsh/clipboard-history.json(上限 500 条),Web 会话标题栏提供「📋 剪贴板」入口打开面板 —— 搜索、点击复制、单条删除、暂停/恢复、清空;同时向 Agent 注册 clipboard_get / clipboard_history_search / clipboard_copy / clipboard_history_delete 四个模型工具。
安装
dsh plugin --profile web add "file:$HOME/dsh-clipboard-history"
dsh web # 重启使 profile 生效
或直接从 GitHub 安装:
dsh plugin --profile web add github:qqyumidi/dsh-clipboard-history
dsh web
卸载:
dsh plugin --profile web remove @dsh-external/dsh-clipboard-history
使用
- 会话标题栏右侧「📋 剪贴板」按钮打开面板。
- 面板内:搜索框过滤历史;点击条目内容或「📋 复制」把该条复制回系统剪贴板;「🗑 删除」移除单条;顶部可暂停/恢复监听、清空全部。
- Agent 工具:
clipboard_get(读当前剪贴板)、clipboard_history_search(搜历史)、clipboard_copy(写入剪贴板)、clipboard_history_delete(按 id 删除一条)。
数据
- 历史文件:
~/.dsh/clipboard-history.json - 上限:500 条,超出后丢弃最旧记录
- 轮询间隔:1.5s
结构
dsh-clipboard-history/
├── package.json # dsh.bundle.patch + dsh.client.platform
├── cordis.patch.yml # insert 插件行
└── lib/
├── index.js # Host:轮询/持久化/HTTP API/工具注册
└── client.js # Client:会话头部按钮 + 浮动面板
说明
- Host 与 Client 通过
webServer注册的/clipboard-api/*HTTP 端点通信(静态 bundle 没有动态插件的harness.handle/host.call)。 - 动态插件版(
cordis_define)与本静态版功能等价;历史文件同一份,可无缝切换。
License
MIT