Lianke Print Box

该 Skill 借助 lk-print CLI 操控链科云打印盒，可查询设备与打印机/扫描仪信息、提交本地文件或 URL 文件的打印任务并指定纸张、颜色、双面、页数等参数、轮询任务状态与取消任务，以及创建、查询和删除扫描任务。使用前需安装 CLI 并配置 ApiKey、DeviceId、DeviceKey 凭据；打印任务异步执行，建议间隔轮询结果。

nullying

热度 82.07

最近更新 2026-05-11 17:29:59

分类：自动化依赖：代码执行 / 读写文件 / 第三方 API应用场景：自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add ai-lk-print-box

Metadata

name: lianke-print-box
description: 链科云打印盒 - 通过 lk-print CLI 远程打印和扫描。需要先运行 lk-print auth 配置 ApiKey/DeviceId/DeviceKey 凭据（或通过环境变量提供）。当用户需要打印文件、查询打印机状态、提交打印任务、扫描文档时使用此 Skill。NOT for: 本地打印机直接操作、非链科设备。
metadata: {"openclaw":{"emoji":"🖨️","primaryEnv":"ApiKey","requires":{"bins":["lk-print"]},"install":[{"id":"uv","kind":"uv","package":"git+https://github.com/liankenet/ai-lk-print-box.git","bins":["lk-print"],"label":"Install lk-print (uv)"}]}}

链科云打印盒 Skill

通过 lk-print CLI 操作链科云打印盒，远程控制打印机和扫描仪。

When to Use

✅ USE this skill when:

用户要打印文件（PDF、图片、Office文档）
查询打印机状态或打印任务状态
扫描文档
管理云打印盒设备

When NOT to Use

❌ DON'T use this skill when:

操作本地直连打印机（非云打印盒）
非链科设备

Setup

# 全局安装（注册 lk-print 到 PATH）
uv tool install git+https://github.com/liankenet/ai-lk-print-box.git

# 一次性认证
lk-print auth --api-key <YOUR_API_KEY> --device-id <YOUR_DEVICE_ID> --device-key <YOUR_DEVICE_KEY>

# 验证
lk-print auth --status

凭据获取：ApiKey 从 https://open.liankenet.com 注册，DeviceId/DeviceKey 扫描设备二维码获取

打印流程

1. 确认设备在线

lk-print device
# 检查 data.info.online: 1=在线, 0=离线, null=从未开机

2. 获取打印机列表

# USB 打印机（推荐）
lk-print printers

# 全部打印机(含网络)
lk-print printers --type 3

# JSON 格式
lk-print printers --json

从输出中获取 hash_id（后续命令需要）。

3. 获取打印机参数（可选，用于了解打印机能力）

lk-print printer-params <hash_id>
# 返回支持的纸张、颜色、双面等能力

4. 提交打印任务

# 打印本地文件（默认 A4 黑白）
lk-print print /path/to/file.pdf

# 打印 URL 文件
lk-print print https://example.com/doc.pdf

# 指定参数
lk-print print file.pdf --paper-size 9 --color 2 --copies 3

# 双面打印
lk-print print file.pdf --duplex 2

# 横向打印
lk-print print file.pdf --orientation 2

# 指定页数范围
lk-print print file.pdf --page-range "1,3,5-10"

# 指定打印机
lk-print print file.pdf --printer <hash_id>

5. 查询任务状态

lk-print job-status <task_id>
# task_state: READY=排队, PARSING=解析, SENDING=发送, SUCCESS=完成, FAILURE=失败

取消打印

lk-print cancel-job <task_id>

扫描流程

# 1. 列出扫描仪
lk-print scanners

# 2. 查看扫描参数
lk-print scanner-params <scanner_id>

# 3. 创建扫描任务
lk-print scan <scanner_id>
lk-print scan <scanner_id> --color-mode RGB24 --format PDF --size A4

# 4. 查询扫描结果
lk-print scan-status <task_id>

# 5. 删除扫描任务
lk-print scan-delete <task_id>

参数速查

纸张 (--paper-size)

值	纸张	值	纸张
9	A4	11	A5
70	A6	1	Letter
5	Legal	13	B5

缩放 (--scale)

值	说明
`fit`	自适应（默认）
`fitw`	宽度优先
`fith`	高度优先
`fill`	拉伸全图
`cover`	裁剪铺满
`none`	原始大小
`90%`	自定义百分比

Notes

打印任务是异步的，print 命令返回 task_id，需用 job-status 查询结果
查询状态建议间隔 10秒 轮询
未指定打印机时默认使用第一台 USB 打印机
JSON 格式输出便于程序解析（--json）