KK搭档（原名 KK档口搭档）是常驻档口电脑的主程序：即时消息提醒、订单/报单相关静默出纸、本机扫码枪、局域网打印代理。
| 层级 | 名称 | 说明 |
|---|---|---|
| 主程序（核心） | KK搭档 | IM、订单出纸、扫码枪、9123 打印代理 |
| 可选 | KK收银 | 盘点机/手机开单（App 或 /pda）；热敏小票时接搭档打印 |
| 可选 | KK经理 | 本机 AI；托盘按需安装运行时，没装不影响打印与消息 |
- Windows：最小化到系统托盘
- macOS：图标在菜单栏（Dock 默认隐藏）
打印适用于热敏小票机、标签机（50×30 等隙缝纸）、A4 激光等多机并存的环境。工作台发起打印时，按 打印类型（小票 / 标签 / 配货单）自动选纸、选打印机。订单出纸与 KK收银出小票共用同一套打印代理，不是两套引擎。
回复仍在工作台的即时会话里完成。KK搭档负责在电脑上提醒，避免档口不打开网页就漏消息。
| 类型 | 内容 |
|---|---|
| 私信 | 采购商在平台即时会话里发来的消息 |
| 平台通知 | 平台发给本店的通知 |
| 报单 | 报单状态更新 |
有新消息时：弹出气泡、按类型播放不同提示音、图标闪动。有未读时，Windows 托盘图标会交替闪；macOS 菜单栏同时有角标。
怎么开
- 安装并保持 KK搭档在运行（Windows 看托盘，macOS 看菜单栏）
- 工作台 → 顶部头像 → 偏好设置 → 打印设置 → 绑定桌面消息通知
- 在托盘或菜单栏里可以查看消息、按类型改提示音并试听、暂停提醒或解除绑定
未绑定，或关掉了 KK搭档时，消息仍在工作台里，只是电脑不会响。托盘或帮助菜单里的 检查更新 可看是否有新版本，有则按提示下载升级。
| 你的情况 | 建议 |
|---|---|
| 只要消息 / 订单出纸 / 扫码枪 | 只装 KK搭档主包（默认） |
| 盘点机/手机收银，暂不打热敏 | 装 KK收银（App 或打开 /pda）即可，可不装搭档 |
| 收银且要局域网热敏小票 | KK搭档（开局域网打印 + 扫打印配对码）+ KK收银 |
| 已在用其它厂的 AI Agent | 主包可选；用 开放 API，不必装 KK经理 |
| 需要本机 KK经理 | 先装主包 → 托盘 安装 KK经理…（约 300MB） |
| 已经装过 KK经理 | 以后只更新主包即可，运行时还在本机 |
独立收银产品：安卓 安装页 或浏览器 https://kk666.cn/pda。开单、扫货、结单不强制装 KK经理。
要打局域网热敏小票时：电脑上运行 KK搭档 → 托盘 局域网打印：开 → 显示打印配对码 → 用 KK收银扫 KKP:（不要和登录码搞混）。
下载后点安装包，弹出 「禁止安装程序」，下面只有 「完成」。点「完成」不会去打开开关。下载列表里若叫 file.apk，那就是 KK收银，巴枪浏览器把文件名丢掉了。已经装过旧版的不要卸载，打开开关后覆盖。
枪上还没被别的软件锁住
- 点「完成」关掉这个框
- 设置 → 安全。打开「未知来源」。看到「禁止安装应用程序」就关掉
- 没有这两项：设置 → 应用和通知 → 特殊应用权限 → 安装未知应用 → 下载 → 允许。设置里搜「未知」或「安装」最快
- 回到下载，再点安装包
枪上已经装过别的仓管或收银软件
那个软件可能把自己设成了设备管理员，把再装别的程序关掉。KK收银可以和它同时留在枪上，不用先卸载。
- 设置 → 安全 → 设备管理器，取消激活那个仓管或收银软件。取消不掉就打开那个软件，把「禁止安装其他应用」或「专机」关掉
- 再按上一节打开未知来源，或给「下载」允许安装
- 设备管理器那一项是灰的、取消不了：这台枪被设成了那个软件的设备主人，设置里打不开。得恢复出厂，或用数据线从电脑安装
托盘：未安装时点 安装 KK经理…；已安装点 KK经理…。须先登录商户账号。日/周 KK算力额度按认证档位以后台配置为准（对照 认证权益对照）。
能做的：大白话查店、改价、上下架、补图、上新款；报表在窗口右边栏打开；可接微信（KK搭档要开着）。
公网一页装齐入口：安装中心（免登录，默认只下 KK搭档主包；页内另有 KK经理 / KK收银说明）。
也可登录后进入：
- 工作台 → 顶部头像 → 偏好设置 → 打印设置
- 或 商品 → 打货码 弹窗底部「安装 / 配置 KK搭档」
页面按当前系统自动展示 主包（Windows / macOS Apple 芯片 / Intel）。下载链接约 5 分钟有效，过期请刷新页面。
| 包 | 平台 | 说明 |
|---|---|---|
| KK搭档主包 | Windows .exe / macOS -arm64.dmg / -x64.dmg | 消息、出纸、扫码；默认下这个 |
| KK经理运行时（可选） | .zip | 托盘「安装 KK经理」自动下载；说明见 安装中心 |
| KK收银 App（可选） | 安卓 .apk | 收银安装页（也可从 安装中心 进入） |
macOS 若提示已损坏：终端执行 xattr -cr /Applications/KK搭档.app（旧版也可能是 KK档口搭档.app），再右键应用 → 打开。
在 托盘或菜单栏 → 打印机设置 里，分别为小票、标签、配货单指定打印机：
| 类型 | 用于 | 推荐设备 |
|---|---|---|
| 小票 | 取货核销小票 | 热敏小票机（76/80mm 卷纸） |
| 标签 | SKU 货码、客户码、报单条码 | 标签机（隙缝标签纸） |
| 配货单 | 报单拣货单/配货单 | A4 激光或宽纸热敏 |
打印设置 页有同样说明，并显示当前连接状态（绿点 = 助理已就绪）。
- 安装并启动助理（Windows 看托盘 / macOS 看菜单栏）
- 在网页点「打印」「打印 N 张」时，优先交给本地助理出纸
- 助理未启动时，网页会改走系统打印对话框（需手动选打印机）
| 操作 | 打印类型 |
|---|---|
| 取货核销小票 | 小票 |
| 商品「打标签」、客户 KKC 标签 | 标签 |
| 报单「打印拣货单/配货单」 | 配货单 |
标签预览须点 「打印 N 张」 才出纸；仅「预览」不会自动打印。
| 问题 | 解决方法 |
|---|---|
| 网页打不出也不弹窗 | 确认助理已启动；打印设置页应显示「已连接」 |
| 装不上，或装上了仍弹出系统打印 | 多半是 360、火绒、电脑管家拦住了程序或本机 9123。见下方 Windows 安全软件 |
| macOS 提示「已损坏」或「无法打开」 | 应用名是 KK档口搭档（路径 /Applications/KK档口搭档.app，不是旧名 KKPrintAssistant）。终端执行 xattr -cr /Applications/KK档口搭档.app，再右键图标 → 打开。并确认：Apple 芯片下 arm64 包，Intel 下 x64 包 |
| 标签却出 A4 | 「标签」类任务未绑定标签机，请在助理设置里指定 |
| 出纸错位 | 检查打印机进纸；助理设置可调边距偏移 |
| 改了设置不生效 | 保存后退出助理再重新打开 |
| 下载链接失效 | 回到打印设置页重新获取 |
电脑上有 360、火绒、腾讯电脑管家 一类软件时，KK搭档经常两步都过不去。
安装很难成功。 安装包会被拦截、隔离或删掉，装到一半失败，或装完没有托盘图标。到该软件的隔离区 / 信任区，把 KK搭档的安装包和程序恢复并设为信任，再装一次。装完看任务栏右下角有没有托盘图标。没有图标就是没在运行。
装上了，打印仍弹出系统打印框。 网页出纸先找本机 127.0.0.1:9123 上的 KK搭档，由它按已经指定的小票、标签、配货单打印机静默出纸。安全软件把程序结束掉，或拦住这个端口，网页就认为搭档不在，改走系统打印。系统打印不会用搭档里指定的那台机器，所以像没装一样。
- 在安全软件里信任「KK搭档」，允许开机启动，不要在「优化 / 清理」时结束它
- 放行本机 TCP 9123
- 打开托盘，确认小票、标签、配货单三台打印机已指定
- 工作台 → 打印设置 应显示已连接。仍是未连接，就是还被拦住
电脑上的小票机仍走 KK搭档：同一 WiFi 扫配对码，网页报单和收银共用这台打印机。盘点机旁边的蓝牙小票机，在 KK收银设置里选「蓝牙小票机」，由 PDA 直接出纸。
KK收银 App（2.1.27+）在设置 → 小票出口，电脑小票机与蓝牙小票机共用输出方式：
| 方式 | 适用 | 说明 |
|---|---|---|
| 图文版（默认） | 较新的热敏机、链路稳 | 完整版式（店招、明细表、小程序码图）；电脑经 KK搭档打 HTML，蓝牙再转光栅 |
| 文本版 | 老热敏、断页/乱码 | 金额「xx.xx元」；票尾档口 H5 二维码。蓝牙=ESC/POS；电脑=等宽 HTML 经 KK搭档 |
何时改文本版： 出纸第一页正常、下一页乱码，或打不全、空白一大截。选「文本版」后试打验证（试打页含 KK货源 · KK收银 品牌行）。
- 档口 PC 上 KK搭档托盘 → 局域网打印：开
- 托盘 → KK收银 → 显示打印配对码…
- 盘点机/手机与 PC 连同一个 WiFi，打开
https://kk666.cn/pda或装 KK收银 App，登录商户账号 - 扫 PC 上的配对码（
KKP:开头）→ 出现绿点「搭档在线」 - 之后扫货出单，小票自动发到 PC 打印机静默出纸
两种码别混： 「KK收银扫码登录」是登录 handoff；「显示打印配对码」才是 KKP: 打印配对。
- 安卓盘点机 / Chrome：配对 + 打印通；网页版首次可能弹出「允许访问局域网」须点允许
- iPhone Safari：因浏览器混合内容限制，配对不了局域网代理 → 用 Chrome 或安卓盘点机 / 原生 App
- PC 内网 IP 变了：重新扫一次打印配对码即可
- 防误打：配对带 token 校验；托盘「重置打印配对 token」后须重新扫码
- 出单成功但没纸：单已保存；检查 KK搭档是否运行、局域网打印是否开、KK收银是否显示「离线」
先分清两条路：
- PC 网页打标签 →
127.0.0.1:9123（仅本机，不需要开局域网打印） - KK收银出小票 →
局域网IP:9123（必须「局域网打印：开」+ 扫KKP） - 绿点后又提示超时/连不上：多半是探活偶发失败（WiFi、防火墙、有线与 WiFi 隔离），配对信息通常还在
台式机管理员 CMD 三步自检（工作台 → 打印设置 页也有同样卡片）：
netstat -ano | findstr :9123→ 应看到0.0.0.0:9123或*:9123为 LISTENING；没有则托盘开「局域网打印」ipconfig看以太网的192.168.x.x，必须与托盘配对窗 / KKP 码里的 IP 一致；若不对，重开「显示打印配对码」再扫- 用盘点机浏览器打开
http://<配对IP>:9123/health：能出 JSON 才算局域网真通。PC 本机通、盘点机不通 → 防火墙或 WiFi↔有线隔离
防火墙与路由器： Windows 入站放行 TCP 9123。360、火绒、电脑管家要信任「KK搭档」，否则本机打印也会退回系统打印框，见 Windows 安全软件。勿访客 WiFi；关 AP 隔离。
聚水潭 / 旺店通等同机： 常用端口 13528，一般不抢 9123。
- 扫码与条码：库存扫码与进销存
- 工作台：偏好设置 → 打印设置（KK搭档 / KK收银 两 Tab）