# @ai-ecoverse/slicc-clipboard 中文文档

规范地址：https://npmcn.com/package/%40ai-ecoverse/slicc-clipboard/

版本：1\.1\.1
npm 元数据更新时间：2026-10-23T11:27:31.668Z
中文译文更新时间：2026-11-05T21:52:41.941Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ai-ecoverse/slicc-clipboard
原文对照：https://npmcn.com/package/%40ai-ecoverse/slicc-clipboard/?lang=original
项目主页：https://github.com/ai-ecoverse/slicc-clipboard#readme
源码仓库：https://github.com/ai-ecoverse/slicc-clipboard

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：37.1 kB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：0 个
- 首次发布：2026-10-13T16:04:32.755Z
- 最新版本发布：2026-10-23T07:52:46.667Z
- 近 30 天下载量：15076（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

sLICC的 pbcopy, pbpaste, xclip, xsel, wl- copy and wl- paste, 作为 POSIX 的 s 脚本在 / dev/ clipboard 上, 以及 SLICC 和任何主机的 sccopy and scpaste

## 安装

```sh
npm install @ai-ecoverse/slicc-clipboard
```

也可以使用：`pnpm add @ai-ecoverse/slicc-clipboard`、`yarn add @ai-ecoverse/slicc-clipboard`、`bun add @ai-ecoverse/slicc-clipboard`

## README

# 剪贴板

SLICC 的剪贴板命令 : `pbcopy`, (中文(简体) ), `pbpaste`, (中文(简体) ), `xclip`, (中文(简体) ), `xsel`, (中文(简体) ), `wl-copy` 财务报告和审定财务报表 `wl-paste`作为 POSIX `sh` 内核上的脚本 `/dev/clipboard` 字符设备。 切出剪贴板工具的程序, 例如 `gh` 结束 [自动取款机/剪贴板](https://github.com/atotto/clipboard)找到他们要找的人.

`sccopy` (挂到剪贴板上)和 `scpaste` (stdout 的剪贴板) 随处可见: 在 SLICC 中 `pbcopy` 财务报告和审定财务报表 `pbpaste`,并在 macOS 上, Linux 和 Windows 上,它们向平台自己的剪贴板工具(参见 [在主机上](https://npmcn.com/package/%40ai-ecoverse/slicc-clipboard/#readme-on-a-host)) (中文(简体) ).

内核从嵌入器中解答设备 `clipboard` 钩子,七分之一 `navigator.clipboard` 在7页。 它需要前面有7个分页,以及Chrome的剪贴板阅读权限. 仅文.

## 安装

在 SLICC 中,软件包在 `slicc.commands`,所以安装它让他们进入 `/usr/bin`数字 :

```sh
pnpm add -g @ai-ecoverse/slicc-clipboard
```

它需要塑料内核1.75.0或更晚(`engines.slicc-kernel`) (中文(简体) ). 在一个老的内核上,没有 `/dev/clipboard`,每个命令除外 `-h` 失败 `<cmd>: /dev/clipboard not available (needs slicc-kernel >= 1.75.0)` 并在它读出或写出任何内容之前1号出口.

## 图标

| 命令 | 副本 | 粘贴 |
| --- | --- | --- |
| `pbcopy` | 静态 |  |
| `pbpaste` |  | 显示 |
| `xclip` | `-i`, (中文(简体) ), `-in`: stdin, 或命名的文件 | `-o`, (中文(简体) ), `-out` |
| `xsel` | `-i`, (中文(简体) ), `--input`: 标准 | `-o`, (中文(简体) ), `--output` |
| `wl-copy` | stdin, 或空格加起来的参数 |  |
| `wl-paste` |  | ,然后是新线 |
| `sccopy` | 静态 |  |
| `scpaste` |  | 显示 |

-   **xclip :** `-selection` (或 `-se`, (中文(简体) ), `-sel`,(...) 取 `clipboard`, (中文(简体) ), `primary` 或者说 `secondary`,或其中任何前缀(`c`, (中文(简体) ), `clip`, (中文(简体) ), `p`);所有三个都是一个剪贴板 `primary` 默认值. `-rmlastnl` (或 `-r`)在被复制或粘贴的结尾处放出一行新行. 名为文件 `-` 是 stdin, 而 xclip 没有 `--`,所以一个文件,名字从 `-` 需要一个路径( n)`./-notes.txt`) (中文(简体) ). 无 `-i` 或者说 `-o`, xclip 副本, 除非 stdin是终端; 然后粘贴 。 员额 `-i` 财务报告和审定财务报表 `-o`,最后一个获胜,在粘贴时文件会被忽略.
-   **xsel:** `-b`编号 :`--clipboard`, (中文(简体) ), `-p`编号 :`--primary` 财务报告和审定财务报表 `-s`编号 :`--secondary` 都意味着一个剪贴板. `-c`编号 :`--clear` 取出空来. `-n`编号 :`--nodetach` 被接受而无所作为。 没有模式, xsel 副本, 除非 stdin 是终端; 然后粘贴 。 员额 `-i`, (中文(简体) ), `-o` 财务报告和审定财务报表 `-c`最后一个赢了 不需要其他论点.
-   **wl-副本 :** `-n`编号 :`--trim-newline` 将一行新线放入尾端. `-c`编号 :`--clear` 空出剪贴板。 选项可能随时可能出现,直到 `--`。 。 。 .
-   **粘贴:** `-n`编号 :`--no-newline` 离开它添加的新线.
-   **缩写,缩写:** 与 `pbcopy` 财务报告和审定财务报表 `pbpaste`在他们自己的名字.
-   **帮助 :** `-h` 财务报告和审定财务报表 `--help` (单位:千美元)`-help` 用于xclip)打印用法行到 stdout并退出 0.

未知的选项( 或一个参数命令不取) 打印命令的错误及其用法行到 stderr 并退出 2 。 当设备失败时, 命令打印 `name:` 和错误给 stderr 的信息,并退出 1;例如,当标签不在前面时:

```
pbcopy: Permission denied
pbcopy: the clipboard needs seven's tab in front, with clipboard access allowed
```

## 在主机上

在有节点24或稍后的机器上:

```sh
npm install -g @ai-ecoverse/slicc-clipboard
printf 'hello\n' | sccopy
scpaste
```

或没有安装, `npx -p @ai-ecoverse/slicc-clipboard sccopy`。仅限 `sccopy` 财务报告和审定财务报表 `scpaste` 安装( 软件包) `bin`中,小节点脚本 `host/`);东道主自己的 `pbcopy`, (中文(简体) ), `xclip` 而其余的则永无阴影。 他们交给平台的剪贴板工具,第一个打开 `PATH`数字 :

| 平台 | `sccopy` | `scpaste` |
| --- | --- | --- |
| 马科斯 | `pbcopy` | `pbpaste` |
| Linux, 在 Wayland 下 (中文(简体) )`WAYLAND_DISPLAY` 组) | `wl-copy` | `wl-paste --no-newline` |
| Linux, X11 软件 | `xclip -selection clipboard -i`,则 `xsel --clipboard --input` | `xclip -selection clipboard -o`,则 `xsel --clipboard --output` |
| 窗口 | 动力壳 `Set-Clipboard` | 动力壳 `Get-Clipboard -Raw` |

-   **文本, 以 = 字节表示 :** UTF -8和一条后继的新线 在往返途中幸存了下来 `scpaste` 没有增加什么。 在macOS上, `pbcopy` 财务报告和审定财务报表 `pbpaste` 运行与 `LANG` 财务报告和审定财务报表 `LC_ALL` 设置为 `en_US.UTF-8`在窗口上, `powershell.exe` (次数) `pwsh.exe`读取stdin并写出stdout作为原始的UTF-8字节,而不是通过控制台代码页; `clip.exe` 没有使用,因为它操纵 非ASCII。 在韦兰下, `wl-copy` 财务报告和审定财务报表 `wl-paste` 先来,然后 `xclip` 财务报告和审定财务报表 `xsel` (通过XWayland). 其他Unix系统作为Linux处理.
-   **喷发:** 工具以固定的正弦运行,没有外壳. `sccopy` 不等待背景过程 `xclip`, (中文(简体) ), `xsel` 财务报告和审定财务报表 `wl-copy` 留下来为剪贴板服务.
-   **错误 :** 没有工具 `PATH`, (中文(简体) ), `sccopy: no clipboard tool found (tried xclip, xsel)` (在那个平台上尝试过的名字) 到Stderr,出口1。 一个失败的工具 它的积分通过,1号出口. `-h` 财务报告和审定财务报表 `--help` 打印 `usage: sccopy` (或 `scpaste`)到 stdout并退出 0; 任何其他参数打印 `sccopy: unknown option: <arg>` 和使用线到 stderr, 以及出口 2.

**在SLICC中 `sh` 命令获胜.** 包裹有两样 `bin` 财务报告和审定财务报表 `slicc.commands`名称 `sccopy` 财务报告和审定财务报表 `scpaste`内核忽略了软件包的 `bin` 当同一软件包在 `slicc.commands` (其内容为: `bin` 在其所附的命令根部),所以 `/usr/bin/sccopy` 总是 `bin/sccopy`生物的底片没有显示 `bin` 链接 `PATH`,然后 `pnpm add -g`,生物清除 `$PNPM_HOME/bin` 链接 pnpm 为每个名称制作一个软件包, 并同时声明 `bin` 财务报告和审定财务报表 `slicc.commands`,因此,SLICC无节点可运行的节点脚本从不阴影 `sh` 这些.

## 设备

剧本所依赖的 `/dev/clipboard` (硅-内核1.75.0及后):

-   读取给剪贴板的文字为UTF-8,从一个快照,然后是EOF.
-   每个打开的文件写入缓冲器;副本发生在 `close()`. 科鲁蒂尔斯 `cat` 将错误报告为写入错误, 因此脚本总是通过 `cat`从来没有一个外壳内置.
-   超过 1 MiB 的复制失败 `EFBIG`,无效的 UTF-8 为 `EILSEQ`,拒绝(不是在前面的标签,或者不允许) `EACCES`,没有剪贴板的嵌入器 `ENOTSUP`,其他东西 `EIO`Coreutils只看到错误,所以命令会打印它的信息(`Permission denied`, (中文(简体) ), `Not supported`, (中文(简体) ), `File too large`, (中文(简体) ), `Illegal byte sequence`, (中文(简体) ), `I/O error`),不是钩子. 之后 `Permission denied`,他们增加了第二行 说做什么.

复制或粘贴 NUL 字节不支持:文本在需要修剪时会通过 shell 变量.

## 发展

```sh
npm install
npm run lint
npm test
npm run test:unit
```

-   `npm run lint`: Biome,无评论检查和其他 [分页共享网络](https://github.com/ai-ecoverse/slicc-shared-web) 检查, `shellcheck -s sh` 财务报告和审定财务报表 `dash -n` 在每个剧本上.
-   `npm test`: 综合测试 `test/integration/`内核测试 `@ai-ecoverse/slicc-kernel/node` 用活活活活活活活活活活活活活活活 `clipboard` 真正的钩子 `/dev/clipboard`:gh 的命令行,来回行走,UTF-8,一个空剪贴板,所有8个选项, `EACCES`, (中文(简体) ), `EIO`, (中文(简体) ), `ENOTSUP`, (中文(简体) ), `EFBIG`, (中文(简体) ), `EILSEQ`,在 `users: 'enforce'`1.7.4.0,没有 `/dev/clipboard` (作为依赖者) `slicc-kernel-without-clipboard`),和一个读取 npm 的内核 `bin` 条目,在哪里 `sccopy` 财务报告和审定财务报表 `scpaste` 一定还是 `sh` 这些. `test/integration/host.test.mjs` 运行 `host/` 对抗假 `pbcopy`, (中文(简体) ), `pbpaste`, (中文(简体) ), `wl-copy`, (中文(简体) ), `wl-paste`, (中文(简体) ), `xclip`, (中文(简体) ), `xsel`, (中文(简体) ), `powershell.exe` 财务报告和审定财务报表 `pwsh.exe` 临时 `PATH`,并强制通过平台 `run({ platform })`,所以每个分支在任意的机器上都检查: 被选中的工具,它的argv,它的 stdin and stdout, macOS上的 UTF-8 语言, Windows 上的 PowerShell 脚本, 倒计时器, 一个失败的工具的 stderr, 一个空 `PATH` 和争论错误。 在 Linux 下方的 CI 上, 并带有 X 显示器, 它也会绕行 UTF-8 , 一条正后方的新线和一个空剪贴板通过 real `xclip` 财务报告和审定财务报表 `xsel` 当它们被安装, 跳过, 说为什么,其他任何地方. `test/integration/repo.test.mjs` 检查工作流程、发布配置和什么 `npm pack` 舰只.
-   `npm run test:unit`: 单位测试 `test/unit/`。它们将每个脚本运行在破折叠和shash下,对照使用临时文件作为设备的脚本副本(运出脚本总是使用) `/dev/clipboard`),以及 `scripts/cover.mjs` 转动出击 `xtrace` 包含在 `coverage/unit/lcov.info`,旁边的节点覆盖 `host/`,其测试使用假工具 `PATH`。承诺前的钩子希望100%覆盖已改变的线路.

CI为 `.github/workflows/ci.yml`,唯一的工作流程,运行 [塑料-共享网络管道](https://github.com/ai-ecoverse/slicc-shared-web#pipeline) 在devDependency的版本,仅在Linux上: `npm run lint`,则 `npm test` 分出两块硬币 然后拉出克劳德和克德克思的评论 合并队列需要 `ci / integration` 财务报告和审定财务报表 `ci / review`在推动 `main`,语义发布,并通过可信赖的出版发布到npm,来源于 `ci.yml`。 。 。 .

## 许可证

阿帕奇 - 2.0

## 常见问题

### @ai-ecoverse/slicc-clipboard 是什么？

sLICC的 pbcopy, pbpaste, xclip, xsel, wl- copy and wl- paste, 作为 POSIX 的 s 脚本在 / dev/ clipboard 上, 以及 SLICC 和任何主机的 sccopy and scpaste

### 如何安装 @ai-ecoverse/slicc-clipboard？

在项目目录运行 npm install @ai-ecoverse/slicc-clipboard，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 sccopy、scpaste，可以用 npx sccopy 直接运行。

### @ai-ecoverse/slicc-clipboard 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ai-ecoverse\_\_slicc-clipboard 是否存在。

### @ai-ecoverse/slicc-clipboard 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @ai-ecoverse/slicc-clipboard 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ai-ecoverse/slicc-clipboard 可以商用吗？

@ai-ecoverse/slicc-clipboard 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @ai-ecoverse/slicc-clipboard 的下载量有多少？

根据 npm 官方下载统计，@ai-ecoverse/slicc-clipboard 在 2026/10/05 – 2026/11/03 这 30 天内被下载 15,076 次，日均约 503 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @ai-ecoverse/slicc-clipboard 还在维护吗？

最新版本 1\.1\.1 发布于 2026/10/23（15 天前）；至今共发布 7 个版本，其中过去 12 个月发布了 7 个；首次发布于 2026/10/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。