供应商指南

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（或同一路由器：PC 有线 + PDA 无线亦可），浏览器打开 `https://kk666.cn/pda` 或装 KK 盘点收银 App，登录商户账号 4. 用激光头 / 摄像头扫 PC 上的配对码（`KKP:` 开头）→ 出现绿点「搭档在线」 5. 之后扫货出单，小票自动发到 PC 打印机静默出纸

两种码别混： 工作台「扫码登录」二维码是登录 handoff；托盘「显示配对二维码」才是 `KKP:` 打印配对。

注意

安卓盘点机 / Chrome：配对 + 打印通；网页版首次可能弹出「允许访问局域网」须点允许
iPhone Safari：因浏览器混合内容限制，配对不了局域网代理 → 用 Chrome 或安卓盘点机 / 原生 App
PC 内网 IP 变了：重新扫一次配对码即可
防误打：配对带 token 校验；PC 托盘「重置配对 token」后 PDA 须重新扫码
出单成功但没纸：单已保存；检查搭档是否运行、局域网打印是否开、PDA 是否显示「离线」

PDA 连不上 9123 / 绿点变黄（现场三步）

先分清两条路：

PC 网页打标签 → `127.0.0.1:9123`（仅本机，不需要开局域网打印）
PDA 出小票 → `局域网IP:9123`（必须「局域网打印：开」+ 扫 `KKP`）
绿点后又提示超时/连不上：多半是探活偶发失败（WiFi、防火墙、有线与 WiFi 隔离），配对信息通常还在

台式机管理员 CMD 三步自检（工作台 → 打印设置 页也有同样卡片，可对着客户机操作）：

1. `netstat -ano | findstr :9123` → 应看到 `0.0.0.0:9123` 或 `*:9123` 为 LISTENING；没有则托盘开「局域网打印」 2. `ipconfig` 看以太网的 `192.168.x.x`，必须与托盘配对窗 / KKP 码里的 IP 一致；若是 `10.x` / `172.x` 或陌生虚拟网卡，先断 VPN/虚拟网卡，重开「显示配对二维码」再扫 3. 用 PDA 浏览器打开 `http://<配对IP>:9123/health`：能出 JSON 才算局域网真通。PC 本机 `127.0.0.1:9123` 通、PDA 不通 → 防火墙或 WiFi↔有线隔离（不是休眠）

防火墙与路由器： Windows 入站放行 TCP 9123（专用网络）；360/火绒放行「KK档口搭档」。勿访客 WiFi；关 AP 隔离。PC 用机时段睡眠改「从不」。

聚水潭 / 旺店通等同机： 它们常用菜鸟端口 13528，一般不抢 9123，可先保留。若虚拟网卡导致配对 IP 不对，按上面第 2 步核对；仅当 netstat 显示 9123 被其它进程占用时再查冲突。