daShangDao_psiWebApp/USAGE.md

使用文档

📅 文档更新：2026-06-07

---

一、波次管理 — 套装书条码打印

1.1 功能概述

波次扫描中遇到套装书（主书 + 副书组合）时，选中后会弹出套装书选择对话框，确认后自动打印条码。条码格式为 {isbn}-{副标识}（如 9787000000000-01）。

1.2 套装书操作流程

1. 扫描书籍 ISBN → 若为套装书（is_suit=1），自动弹出 "选择套装书" 对话框
2. 从列表中选择对应套装书，或添加自定义项（需填写副ISBN）
3. 点击 "确认选择" → 自动生成并打印条码

1.3 条码打印 — 调试模式

首次打印条码时会弹出 C-Lodop 打印设置对话框（调试模式），可在其中调整：

• 纸张尺寸（默认 60mm × 30mm）
• 打印机选择
• 打印方向、边距等参数

调试模式触发规则：

场景	行为
首次打印套装书条码	弹出调试对话框 → 确认后永久记录，后续不再弹出
后续打印套装书条码	直接打印，不再弹出对话框
手动点击"打印调试"按钮（搜索栏）	固定使用测试号 9787000000000-01 生成条码 → 弹出调试对话框

重置调试模式： 清除浏览器 localStorage 中的 printFlag 即可让调试标记失效，下次打印重新弹出调试框：

localStorage.removeItem('printFlag')

（可在浏览器开发者工具 → Application → Local Storage 中操作）

---

二、波次管理 — 界面说明

2.1 波次页布局

区域	内容
顶部搜索栏	ISBN 搜索、仓库选择、小车选择、容量、品相、固定货号、打印调试按钮
左侧面板	拍照区域（Camera 组件）
中间面板	书籍信息预览（可编辑本数、自设价格）
右侧面板	照片预览
底部列表	已扫描书籍列表

2.2 操作步骤

1. 选择小车 → 在搜索栏下拉框中选择要操作的小车
2. 扫描 ISBN → 在搜索框输入或扫码枪扫描 ISBN
3. 拍照（alt+a） → 拍摄书籍照片
4. 创建波次（alt+x） → 将已扫描的书籍创建为波次任务
5. 继续扫描 → 追加更多书籍到已有波次

---

三、C-Lodop 打印设置

3.1 服务要求

• 本地需运行 C-Lodop 打印服务（默认地址 http://localhost:8000）
• 如果未启动，点击"打印调试"或打印条码时会提示"加载 C-Lodop 失败"并引导下载

3.2 条码打印机配置

1. 进入 打印机管理 页面
2. 在 "条码打印机" 下拉框中选择对应打印机
3. 点击 "确定" 保存（存储于 localStorage.printer_barcode）

3.3 常见问题

问题	排查
点击打印无反应	检查 C-Lodop 服务是否运行（浏览器访问 http://localhost:8000）
提示"请先配置条码打印机"	进入打印机管理页面选择并保存打印机
条码打印位置偏移	使用调试模式打开打印设置对话框，调整边距参数
想重新弹出调试框	清除 localStorage.printFlag

---

本文档随功能更新持续维护