前言¶
在 DeepSeek Harness（DSH）里和模型对话时，常见动作是把刚在别处复制的报错、JSON 或片段贴进输入框。常规做法是切窗口、选中、复制、再切回 DSH 粘贴。Windows 自带 Win+V 也能翻历史，但和对话输入框、模型侧读取并不是同一套流程。dsh-clipboard 是社区维护的 DSH 插件，在本机记录文本剪贴板历史，在输入框旁提供引用入口，并通过 MCP 让模型按索引读取最近复制的内容。下面介绍它的定位、组成、安装与使用方式。
这是什么¶
插件仓库：hezhaochao/dsh-clipboard，维护者 hezhaochao，SkillHub 分类为「记忆」。当前 package.json 版本为 0.1.1，许可证 MIT。
它面向 DSH 0.2.x（engines.dsh 声明为 >=0.2.0-rc.1 <0.3.0-0），README 写明已在 v0.2.1-rc.3 上完成安装、配置树组合与卸载验证。历史数据只写入本机 ~/.dsh/dsh-clipboard/history.jsonl，不联网上传。
解决什么问题¶
复制完成后，在 DSH 输入框旁点「引用」，从列表选一条即可插回输入框，少一轮窗口切换。对话里也可以说「把刚才复制的报错贴进来」，模型通过 MCP 工具 recent / get 读取同一份本机历史，而不依赖你手动再粘贴一次。
核心功能与组成¶
三部分协同工作（与 README 架构说明一致）：
- PowerShell 轮询器：DSH 启动时拉起，单实例锁守护；约每 1.5s 读取系统剪贴板文本，有变化才追加到
history.jsonl。 - 宿主侧
lib/index.js：注册本地路由/dsh-clipboard/history（供网页组件）与/clear（清空）；挂载 MCP 桥接，暴露clipboard_recent、clipboard_get（模型侧名称形如mcp__clipboard__<名>）。 - 客户端
lib/client.js：输入框旁引用按钮、历史列表、点选插入；失败时回退为复制。另监听输入框paste，把粘贴写入 localStorage，作为轮询器未运行时的兜底。
MCP 工具
| 工具 | 作用 |
|---|---|
recent |
列出最近 N 条历史（时间、索引、单行预览） |
get |
按索引取全文（0 为最新） |
存储与隐私规则（README 原文）
- 仅捕获文本；图片、文件忽略；单条上限 8000 字符；最多保留 50 条；4 小时自动过期。
- 本地路由只服务 DSH 自己的网页；模型仅在调用 MCP 工具时才会读到历史内容。
平台
- 系统级捕获与 MCP 完整能力要求 Windows 10/11（轮询器为 PowerShell 5.1）。
- 非 Windows：客户端组件仍可用（粘贴记录兜底）；系统捕获与 MCP 会明确报错。
安装与启用¶
从 GitHub 安装（请将 <你的 profile> 换成实际 profile 名）：
dsh plugin --profile <你的 profile> add github:hezhaochao/dsh-clipboard
本地开发调试可使用 link（README 注明 link 不会自动装 peer，需在 profile 目录补 pnpm add @deepseek-ai/dsh-mcp-client）：
dsh plugin --profile <你的 profile> add link:"<本仓库绝对路径>"
安装后完全退出 DSH（含托盘）再重启。peer 依赖 @deepseek-ai/dsh-mcp-client，正常渠道安装会自动带上。
典型用法¶
经过上面的步骤重启 DSH 后，可按 README 顺序操作：
- 确认输入框旁出现引用按钮。
- 平时正常复制文本即可，插件自动追加历史，无需额外配置。
- 点引用 → 查看时间与内容预览 → 点某条插入输入框；列表支持刷新与清空全部历史。
- 在对话中直接说明要把「刚才复制的内容」贴进上下文，由模型调用 MCP
get（索引 0 为最新）。
清空历史会删除文件与记录；若复制过密码、验证码等敏感文本，建议及时使用清空功能。
适用场景与注意¶
适合谁：在 Windows 上长期开着 DSH（含托盘），频繁把外部复制的内容送进对话或交给模型处理的开发者。
运行与信任：插件以当前 DSH 进程权限运行，轮询器在 DSH 运行期间才捕获系统剪贴板；DSH 未启动时复制的内容不会被轮询器记入。安装前请阅读仓库源码与 MIT 许可证，自行评估是否纳入工作环境。
已知限制（README）
- 轮询间隔 1.5s，极快连续复制可能漏记中间态。
- 个别应用的私有剪贴板格式可能无法被
Get-Clipboard取到文本，该轮会跳过。 - 与 Windows Win+V 历史互不影响。
社区插件目录见 SkillHub：dsh-clipboard；该站点为社区目录，与 DeepSeek / 幻方无官方从属关系。完整说明与 issue 入口见 GitHub 仓库。
