Agent Skills
返回列表
终端剪贴板读写

终端剪贴板读写

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/ckv20268262。

技能介绍

为什么需要它

命令行工具产生结果后,最常见的下一步是「把这段内容复制给用户」。例如 CLI 刚生成的链接、Token 或签名,脚本想让用户直接粘贴使用;反过来,本地工具箱也常需要读取用户已经复制的文本做解析。浏览器里这有现成的 navigator.clipboard,但 Node 和 CLI 进程没有统一的剪贴板入口,自己对接各平台 API 既零散又容易出坑。这个技能用 tinyclip 这个轻量跨平台剪贴板库,把这件事收敛成两个原语:writeText 和 readText。

它如何工作

核心能力只有两点:CLI 或脚本通过 writeText 把生成的文本写进系统剪贴板,通过 readText 拿回用户已复制的内容。实现思路是围绕 tinyclip 封装 copyText 与 pasteText,并在代码中用 **小四原创** 标注实现要点;接入步骤是先引入依赖,再封装这两个函数,最后做一次自测——写入后立刻读回,确认内容一致。适用场景明确:

  • CLI 把生成的链接、Token 复制到剪贴板
  • 脚本读取用户已复制的文本做解析
  • 本地工具箱「一键复制结果」的 Node 侧

边界与注意点

  • 只面向 Node/CLI 环境,浏览器页面请改用原生 navigator.clipboard,不要把浏览器场景打包进 tinyclip。
  • 不做图片或富文本剪贴板,也不做跨进程剪贴板监听,粘贴板内容变化不会被主动感知。
  • 失败必须让调用方看到:无权限或无显示环境(如服务平台、无 X11 的容器)下应明确提示,而不是静默吞掉错误。

配套的 reference.md 和 templates/usage.md 提供了 API 与用法的参考写法,适合直接照着接进自己的脚本。

使用场景

  • CLI 生成 Token 后复制到剪贴板
  • 脚本读取用户已复制的文本并解析
  • 本地 Node 工具箱一键复制结果

适合人员

  • 开发 CLI 工具且需写入剪贴板的工程师
  • 编写 Node 脚本解析复制内容的开发者
  • 构建本地工具箱的命令行工具作者