PrintLinkPrintLink 用户文档
把打印能力接进业务系统的完整指南：安装 Agent、网页调用打印与预览、接入 SDK、接口参考、部署与运维、故障排查。
最后更新
PrintLink 是装在连接打印机的那台电脑上的打印服务（打印 Agent）。 业务系统通过它直接调用打印机出纸：静默打印、打开预览窗口、按打印机 真实能力出纸，不需要浏览器打印对话框，也不需要任何插件。
<script src="http://127.0.0.1:17888/sdk/printlink.js"></script>
<script type="module">
const client = new PrintLink.PrintLinkClient({ appName: '我的业务系统' });
await client.connect();
await client.ensureAuthorized(); // 首次由本机用户确认授权
const { queues } = await client.listPrinters();
await client.compose({ queueId: queues[0].queueId }).addPdf(pdfBytes).printAndWait();
</script>完整可运行示例见快速上手。
开始使用
核心功能
按「你要做成什么事」组织，每页只讲怎么用和常见坑。
打印
静默出纸、等待打印结果、取消任务、查询任务列表。
预览
打开预览窗口让用户确认后再出纸，以及预览里的改纸张、调布局。
打印参数
份数、纸张、单双面、彩色/黑白、质量、纸张类型等选项。
打印机与配置档
选打印机、看实时状态、读真实能力、保存常用配置。
扫描
列扫描仪、发起扫描、桌面确认与取回成品。
接入开发
接入方式
script 标签、npm 包、React、Vue 3 四种写法与生命周期。
内容来源
PDF、图片、模板文档、网页各怎么打，该选哪种。
组合打印
多种内容排进同一条任务：一次预览、一次打印、一张纸。
Hiprint 模板
已有 vue-plugin-hiprint 模板的迁移与能力边界。
接口参考
API 总览
连接、授权、打印、预览、打印机、扫描的全部方法与参数。
事件订阅
任务进度、打印机状态、授权结果等实时通知。
权限
每个方法需要什么权限，怎么申请、怎么被收回。
错误码
全部错误码的含义、分类与是否可重试。
HTTP 接口
不用 WebSocket 的移动端与服务端接入方式。
部署与运维
部署拓扑
打印机不在用户电脑上时，局域网与远程连接怎么选。
局域网打印工作站
一台机器接打印机、多台终端共享出纸的配置步骤。
受控远程连接
经 VPN 或反向代理访问的适用范围与责任边界。
安全
谁能连接、能做什么、怎么收回授权。
故障排查
打不出来、卡住、打错格式时按顺序查什么。
日志与日志包
日志设置、占用管理与导出日志包求助。
企业部署
静默安装、机器策略与集中管控。