dsh-clipboard
把文本写入系统剪贴板的 DSH 插件。零依赖、纯 ESM JavaScript、无需构建。
简介
注册一个工具 clipboard_write，接收任意文本并写入系统剪贴板，方便 agent 把生成的结果直接交给用户粘贴使用（例如复制命令、代码片段、URL、密钥等）。
执行结果始终返回规范 JSON 值，任何失败都不抛异常：
{ "ok": true, "bytes": 42, "tool": "pbcopy" }
{ "ok": false, "bytes": 42, "tool": null, "error": "no clipboard tool available (install xclip or xsel): ..." }安装
dsh plugin --profile <profile-name> add dsh-clipboard
# 本地开发：
dsh plugin --profile <profile-name> add file:./plugins/dsh-clipboard平台依赖
| 平台 | 实现 | 是否需要安装 |
|---|---|---|
| macOS | pbcopy（/usr/bin/pbcopy） |
免装，系统自带 |
| Windows | clip |
免装，系统自带 |
| Linux | xclip（优先）或 xsel |
需要安装其一：sudo apt install xclip 或 sudo apt install xsel；两者都没装时工具返回 ok: false 并提示安装 |
注意：Linux 下需要可用的 X11/Wayland 会话（
DISPLAY/WAYLAND_DISPLAY）。无图形会话（如纯 SSH、CI 容器）会写入失败。
使用场景
- 让 agent 把生成的一行命令、SQL、JSON、代码片段直接放进剪贴板，用户粘贴即用。
- 复制临时 token / URL / 文件路径，省去手动选中。
- 作为多步工作流里的“交接输出”步骤。
自检
插件挂载时自动写入一次 clipboard-probe-<时间戳>；macOS 上会用 pbpaste 读回比对，Linux/Windows 只报告写入结果。日志前缀 [dsh-clipboard]。
License
MIT