dsh-clipboard：零依赖写入系统剪贴板

在开发智能体工作流时，Agent 生成的内容往往需要用户手动复制粘贴。dsh-clipboard 解决了这个问题，允许 Agent 直接把结果写入系统剪贴板，用户无需选中，直接粘贴即可使用。

插件简介¶

这是一个由 ZhijiangTang 维护的 DSH 插件。它注册了一个名为 clipboard_write 的工具，核心特点是零依赖、纯 ESM JavaScript、无需构建。

核心功能¶

• 跨平台支持：支持 macOS、Windows 和 Linux 系统。
• 规范返回：执行结果始终返回规范 JSON。包含 ok（布尔值）、bytes（写入字节数）、tool（使用的系统工具名称）和 error（仅在失败时出现）字段。任何失败都不会抛异常。
• 自动自检：插件挂载时会自动写入一次自检文本，日志前缀为 [dsh-clipboard]。

安装与启用¶

通过 DSH 官方命令安装：

dsh plugin --profile <profile-name> add dsh-clipboard

典型用法¶

Agent 生成一行命令、SQL、JSON 或代码片段后，调用 clipboard_write。用户无需手动选中，直接粘贴即可使用。

返回示例：

{ "ok": true,  "bytes": 42, "tool": "pbcopy" }
{ "ok": false, "bytes": 42, "tool": null, "error": "no clipboard tool available (install xclip or xsel): ..." }

适用场景与注意事项¶

• 适用场景：
  • 让 Agent 把生成的命令、SQL、JSON、代码片段直接放进剪贴板。
  • 复制临时 token、URL 或文件路径。
  • 作为多步工作流里的“交接输出”步骤。
• 注意事项：
  • Linux 环境要求：需要可用的 X11 或 Wayland 会话（环境变量 DISPLAY 或 WAYLAND_DISPLAY）。在纯 SSH 会话或 CI 容器中会写入失败。
  • 系统依赖：依赖系统自带或安装的 pbcopy（macOS）、clip（Windows）、xclip 或 xsel（Linux）。

总结¶

这个插件通过极简的依赖和规范的数据返回，降低了智能体与外部系统的交互成本。安装前建议检查源码与许可证。源码与文档可查看 GitHub。