90 lines
3.1 KiB
Markdown
90 lines
3.1 KiB
Markdown
# 使用文档
|
||
|
||
> 📅 文档更新：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` |
|
||
|
||
---
|
||
|
||
*本文档随功能更新持续维护*
|