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 | 「标签」类任务未绑定标签机，请在助理设置里指定 |
| 出纸错位 | 检查打印机进纸；助理设置可调边距偏移 |
| 改了设置不生效 | 保存后退出助理再重新打开 |
| 下载链接失效 | 回到打印设置页重新获取 |
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 是否显示「离线」
先分清两条路：
- 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 被其它进程占用时再查冲突。
- 扫码与条码：[库存扫码与进销存](/help/merchant-inventory-scan)
- 工作台现场卡片：偏好设置 → 打印设置（两 Tab 均有「PDA 连不上 9123」对照）