供应商指南

KK 档口搭档（Windows / macOS）

本地托盘/菜单栏助理，按 scene 分发到不同打印机；双平台下载、三场景映射与排错；v1.4+ 局域网配对 PDA/盘点机扫码出纸。

作用

KK 档口搭档是常驻您电脑的小工具。网页或工作台发起打印时，助理会按 打印类型（小票 / 标签 / 配货单）自动选择对应纸张和打印机，静默出纸，无需每次手动选纸。

Windows：最小化到系统托盘
macOS：图标在菜单栏（Dock 默认隐藏）

适用：热敏小票机、标签机（50×30 等隙缝纸）、A4 激光等多机并存的环境。

下载与安装

登录后进入：

工作台 → 顶部头像 → 偏好设置 → 打印设置
或 商品 → 打货码 弹窗底部「安装 / 配置档口搭档」
或 客户码打印预览 里的「档口搭档设置」

页面按当前系统自动展示 Windows 或 macOS（Apple 芯片 arm64 / Intel x64 分架构）安装包。下载链接约 5 分钟有效，过期请回到打印设置页重新获取。

平台	安装包	说明
Windows	`.exe` 安装程序	默认开机自启，托盘右键可退出/设置
macOS Apple 芯片	`-arm64.dmg`	拖入「应用程序」；若提示已损坏：`xattr -cr /Applications/KKPrintAssistant.app` 后右键打开
macOS Intel	`-x64.dmg`	同上，Intel Mac 须下 x64 包

三类打印任务 → 打印机

在 托盘或菜单栏 → KK 档口搭档 → 打印机设置 里，分别为小票、标签、配货单指定打印机：

类型	用于	推荐设备
小票	取货核销小票	热敏小票机（76/80mm 卷纸）
标签	SKU 货码、客户码、报单条码	标签机（隙缝标签纸）
配货单	报单拣货单/配货单	A4 激光或宽纸热敏

打印设置 页有同样说明，并显示当前连接状态（绿点 = 助理已就绪）。

工作流程

1. 安装并启动助理（Windows 看托盘 / macOS 看菜单栏） 2. 在网页点「打印」「打印 N 张」时，优先交给本地助理出纸 3. 助理未启动时，网页会改走系统打印对话框（需手动选打印机）

从哪里会触发

操作	打印类型
取货核销小票	小票
商品「打码」、客户 KKC 标签	标签
报单「打印拣货单/配货单」	配货单

标签预览须点 「打印 N 张」 才出纸；仅「预览」不会自动打印。

排错

问题	解决方法
网页打不出也不弹窗	确认助理已启动；打印设置页应显示「已连接」
macOS 提示「已损坏」或「无法打开」	终端 `xattr -cr /Applications/KKPrintAssistant.app`；右键应用 → 打开；确认下载了正确架构（arm64 / x64）
标签却出 A4	「标签」类任务未绑定标签机，请在助理设置里指定
出纸错位	检查打印机进纸；助理设置可调边距偏移
改了设置不生效	保存后退出助理再重新打开
下载链接失效	回到打印设置页重新获取

局域网配对：PDA / 盘点机扫码出纸（v1.4+）

v1.4 起支持 PDA / 盘点机扫码后直接走档口 PC 的打印机，不用云、不用蓝牙绑打印机。

配对步骤

1. 档口 PC 助理托盘 → 局域网打印：开 2. 托盘 → 显示配对二维码… → 弹出二维码窗口 3. PDA / 盘点机和 PC 连同一个 WiFi，浏览器打开 `https://kk.h-sh.com/pda` 登录商户账号 4. 用激光头 / 摄像头扫 PC 上的配对码（KKP: 开头）→ 页面顶部出现绿点「已配对打印代理」 5. 之后扫货出单，小票自动发到 PC 打印机静默出纸

注意

安卓盘点机 / Chrome：配对 + 打印通；首次可能弹出「允许访问局域网」须点允许
iPhone Safari：因浏览器混合内容限制，配对不了局域网代理 → 用 Chrome 或回档口打印
PC 内网 IP 变了：重新扫一次配对码即可
防误打：配对带 token 校验；PC 托盘「重置配对 token」后 PDA 须重新扫码
防火墙：Windows 第一次开关须放行 9123 端口入站
路由器 AP 隔离：访客 WiFi 或开启「终端隔离」会导致 PDA 连不上 PC，请用同一内网
出单成功但没纸：单已保存；检查搭档是否运行、局域网打印是否开、PDA 页是否显示「离线」