QCBOX 盒型库 · 使用教程

网页版能力，AI 里直接用

• · 盒型库、参数体系、刀线算法与 网页版智能刀模 完全同源；
• · 生成结果直接置入 Illustrator，省去「网页导出 → 手动置入」的往返；
• · 盒型与参数由服务端下发，新增盒型多数情况无需升级插件。

环境要求

• · Illustrator CC 2020（v24.0）及以上（CEP 11，清单要求 CSXS 11.0）；
• · 可访问 https://qc.caibox.top（出站 HTTPS 443）；
• · 本地仅写入 ~/.qcb-sync/（会话）与系统临时目录（PDF 中转）。

macOS

1. 1. 把下载的 qcb-cep-*.zip 解压到本机（例如「下载」文件夹）
2. 2. 双击 install-mac.command（首次若被 Gatekeeper 拦截：右键 → 打开 → 仍要打开）
3. 3. 脚本自动完成：放行未签名扩展加载 → 复制扩展 → 校验 → 检测 Illustrator
4. 4. 若 Illustrator 正在运行，按 Cmd + Q 完全退出后重新打开
5. 5. 菜单 窗口 → 扩展 → QCBOX 盒型库

Windows

1. 1. 把下载的 qcb-cep-*.zip 解压到本机
2. 2. 双击 install-win.bat（SmartScreen 拦截时：更多信息 → 仍要运行）
3. 3. 脚本自动完成：写注册表 PlayerDebugMode=1 → 复制扩展 → 校验 → 检测 Illustrator
4. 4. 完全退出 Illustrator 后重新打开
5. 5. 菜单 窗口 → 扩展 → QCBOX 盒型库

面板顶部按分类选择盒型（双插盒、扣底盒、挂钩盒、手提盒、飞机盒、手提袋、异型盒、纸箱…），与服务端盒型库同步，新增盒型无需升级插件。

输入长(L)、宽(W)、高(H)与纸厚(T)；纸厚直接影响折痕带、锁扣与出血等自动推导，请按实际用纸填写。

按盒型展开细节参数（插舌长、防尘翼、粘位宽、锁扣/竖向锁扣、安全缺口、指甲位等），参数与网页版 /box 完全同源。

点「生成」后由服务端出图（PDF 刀线层），面板自动把刀线置入当前 Illustrator 文档，可直接进入排版/拼版。

批量：当前盒型 × 多尺寸

• · 面板第 3 步「批量尺寸」：粘贴多行（每行 长 宽 高 纸厚，可含表头，纸厚省略用当前纸厚，逗号/空格/制表符均可）；
• · 点「解析」显示合法份数与问题行，最多 60 份；
• · 点「批量生成并置入（N 份）」逐份出图并**依次置入当前 Illustrator 文档**（3 列自动排布），面板显示进度，失败份不中断；
• · 盒型 = 当前选中盒型；纸厚与细节参数默认取面板当前值，每行按自身尺寸推导自动项。

报价：带当前盒型与尺寸直达

• · 面板底部橙色「报价」按钮（橙底白字加粗），右侧可填数量（默认 1、自动记忆上次）；
• · 点击后在默认浏览器打开 https://qc.caibox.top/quote，自动带入 盒型识别 + 长宽高 + 纸厚 + 数量；
• · 盒型按结构精确对应报价计费盒型（如 双插盒1→双插盒、飞机盒1→飞机盒、天地盖-V→天地盖盒），报价页仍可手动改；
• · 未登录也能算价，提交订单时才需要登录。

企业策略与签名 ZXP

未签名扩展通过 CEP 官方调试机制（PlayerDebugMode）加载。若企业策略不允许，可改走签名分发：申请 Adobe 开发者证书（.p12）→ ZXPSignCmd -sign top.caibox.qcb.sync qcb-cep.zxp cert.p12 密码 → 用户用 ZXP Installer / ExManCmd 安装，无需 PlayerDebugMode。现有扩展目录可直接用于签名。

升级与卸载

升级：用新包重跑一次安装脚本（覆盖旧版）→ 重启 Illustrator，会话与设备绑定保留。卸载：删除扩展目录，可选把 PlayerDebugMode 改回 0， ~/.qcb-sync/ 可一并删除。盒型与参数由服务端下发（catalogVersion），多数情况无需升级插件。