# 使用文档

> 📅 文档更新：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` |

---

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