主题
打包工作台
页面定位
打包工作台是打包管理里的现场装包页面。
它解决的不是“板件有没有做完”，而是“已经分拣出来的板件，接下来应该怎么装进包裹、什么时候封包、怎么打印标签、出异常时怎么继续往下做”。
如果说“分拣工作台”是在把板件从生产结果里挑出来，那么“打包工作台”就是在把这些板件真正装进可交付的包裹。
菜单路径
打包管理 → 打包管理 → 打包工作台
建议你先看哪里
如果你是第一次接触这个页面，建议不要从上到下硬读，而是先按自己遇到的问题进入对应章节：
这张图是帮你快速定位阅读入口：打包工作台功能很多，但现场人员通常只会被某一个问题卡住，先跳到对应章节，效率更高。
页面整体在做什么
从实际页面行为来看，打包工作台通常遵循下面这条主线：
这张图帮助你建立对页面的整体认识：先建立当前订单上下文（如果是大型订单，还会受打包组划分限制），再往当前包裹里持续加板，合适时封包，再继续下一包。理解这条主线后，再看各区块就不容易乱。
什么是打包组模式？
如果一个订单非常大（例如全屋定制），系统支持在订单详情页提前把它划分成多个“打包组”。 一旦订单被划分了打包组，打包工作台的规则会发生一些变化：
- 强制按组打包：工人扫码时，系统不仅校验板件是否属于该订单，还会严格限制当前只能扫描属于同一个打包组的板件。
- 防混包拦截：如果当前正在打第一组的板件，你扫了一块第二组的板件，系统会直接拦截并语音报错（“不属于当前打包组”）。
- 按组验收：必须把当前组的所有包裹打完，系统才会播报“打包组完成”。 这个模式能有效防止现场把不同车次的板件混装。
页面布局
顶部操作栏
| 功能 | 说明 |
|---|---|
| 板件 ID 输入框 | 输入板件 ID 并回车加入包裹，也可直接用扫码枪扫描；如果符合工厂配置的订单号前缀规则，也会被当成订单号处理 |
| 加入 | 手动触发一次加入动作，常用于调试扫码枪或键盘录入 |
| 切换订单 | 清空当前工作台上下文，退出后可通过历史记录恢复；扫码 002/orange 也能触发 |
| 全屏 | 全屏显示工作台，适合现场大屏或工位屏幕 |
| 配置 | 设置语音播报、铃声提示、屏幕提示以及多订单筛选项 |
| 历史记录 | 查看并恢复之前做过的打包任务 |
| 我的工作量 | 打开个人工作量抽屉，查看当前打包人的累计工作量 |
| 打印包裹码 | 实际行为是先对当前未封包包裹执行封包，再弹出打印标签 |
| 二维码 | 展示快捷操作二维码（封包 / 切换订单 / 下载打包清单） |
| 下载打包清单 | 下载当前订单的打包清单 Excel |
左上：打包单概况
这里展示当前订单的背景信息，方便你确认自己是不是在给正确的订单打包。
| 信息 | 说明 |
|---|---|
| 订单编号 | 当前正在打包的订单 |
| 包装方式 | 当前使用的打包方式 |
| 渠道名称 | 订单来源渠道 |
| 交付地址 | 送货地址 |
| 房间数 | 订单包含的房间数量 |
| 柜体数 | 订单包含的柜体数量 |
| 板件数 | 已打包数量 / 总板件数量 |
中间：待打包板件区
这里是你“挑板入包”的主操作区。
手动打包开关：点击「开启/关闭手动打包」切换手动模式。开启后，现场人员可以不依赖扫码枪，而是在列表里直接点按钮把板件加入包裹。
打包方式按钮：
- 自由打包：由操作人自己决定包裹怎么建、板件怎么装
- 按房间打包：同一房间的板件优先打进同类包裹
- 按柜体打包：同一柜体的板件优先打进同类包裹
分组标签：页面会按照当前模式，把待打包板件按房间或柜体分组，点击标签可快速切换到对应板件区域。
板件列表：
| 字段 | 说明 |
|---|---|
| 序号 | 行号 |
| 板件 ID | 板件唯一编号 |
| 房间名称 | 所属房间 |
| 柜体名称 | 所属柜体 |
| 板件名称 | 点击后可查看面积统计与更完整明细 |
| 尺寸 | 长 × 宽 × 厚 |
| 备注 | 其他补充说明 |
| 加入包裹 | 手动打包开启后，可直接点击加入当前包裹 |
右上：打包进度与当前包裹
这部分解决的是“我现在打到哪了、这个包里装了什么”。
进度看板：以超大字号显示当前订单累计已打包数量与总板件数量，例如 301/619。现场人员不用翻列表，抬头就能知道还剩多少。
当前包裹：展示正在装配中的包裹：
- 包裹名称：例如
X1-南次卧 #1 - 板件列表：当前已经加入该包裹的板件
- 移除：发现装错时，可先从当前包裹中移除
右下：已打包裹列表
这里展示已经形成的包裹，便于打印、复查和后续调整。
| 字段 | 说明 |
|---|---|
| 序号 | 包裹序号 |
| 包裹名称 | 如 X1-南次卧 #1 |
| 包裹序号 | 同名包裹下的自然顺序 |
| 打包状态 | 进行中 / 已完成 |
| 成件数量 | 当前包裹内板件数量 |
| 操作 | 打印标签、删除、查看明细等 |
首次进入与自动恢复
实际使用中，这个页面并不一定每次都是“空白开始”。当前实现会先看路由里是否带了订单编号：如果是从打包单管理等页面点“继续打包”进入，就直接加载指定订单；如果没有指定订单，系统会尝试恢复当前登录人最近一次未完成的打包订单。
这张图说明两个关键点：
- 自动恢复按当前登录人的最近打包记录判断，不是恢复全厂任意人的任务；
- 第一块板件或订单号都能建立当前订单上下文，板件命中多个订单时才需要人工确认。
打包方式详解
三种打包方式没有绝对的“谁更高级”，区别在于：包裹是按什么规则组织。
这张图帮助你先做模式判断。模式一旦选错，后面的包裹结构、自动归组和操作节奏都会跟着错；如果你已经扫出了一个未封包包裹，则要先封包后才能切换模式。
自由打包
最灵活，适合特殊场景：
- 点击“自由打包”
- 扫码或手动选择板件加入包裹
- 系统会用第一块板件所在房间作为新包裹名称
- 如果后续加入其他房间板件，包裹名称会自动合并多个房间名
- 装满后手动封包并打印标签
适用场景：客户临时要求、异形件单独处理、现场需要人工决定如何拆包合包。
注意
当前实现里，自由打包不是先手动输入一个包裹名称再开始装板，而是由系统根据已加入板件的房间名自动维护包裹名称；自由打包也不会因为某个房间或柜体扫完而自动封包。
按房间打包
最适合安装现场按空间找货：
- 点击“按房间打包”
- 系统按房间展示待打包板件
- 选择当前要打包的房间
- 持续扫描该房间板件加入包裹
- 板件较多时，系统会形成
#1、#2等连续包裹
适用场景：客户按房间安装，搬运和现场找板效率更高。
按柜体打包
更强调单个柜体成套交付：
- 点击“按柜体打包”
- 系统按柜体分组板件
- 选择一个柜体开始装包
- 将该柜体相关板件集中打成包裹
适用场景：柜体独立运输、独立安装，或需要明确按柜体交接。
扫码打包主流程
扫码打包是最核心、最常用的操作方式。实际流程并不是“随便一扫就进包”，而是先判断当前工作台有没有订单上下文，再校验板件是否属于当前订单、是否符合当前打开包裹的规则。
这张图重点解释“为什么有时一扫就成功，有时系统会拦你”：因为系统不仅看有没有扫到板件，还会看订单是否一致、当前未封包包裹是否允许接收这块板件、当前板件是否属于当前正在操作的打包组（如果订单启用了打包组），以及多订单候选是否需要人工确认。
封包与切换订单限制
现场最容易疑惑的两个问题是：
- 为什么我明明想切换订单，系统却不让我切？
- 为什么有时候扫完几块板件，系统就直接弹出打印标签？
它们背后其实是同一套控制逻辑：当前打包人只要还有一个未封包包裹，工作台就会优先围绕这个包裹继续操作；按房间/按柜体模式在对应分组扫完时，还会自动触发封包。
这张图能帮助你理解一个非常重要的现场规则：切换模式或切换订单之前，先把手上的包裹处理干净。这样做是为了避免不同分组、不同订单的板件混包，也防止标签和实物对不上。
扫码快捷指令
除了扫板件，现场还可能用特定控制码触发快捷动作：
- 绿色条码：封包
- 橙色条码：切换订单
- 下载条码：下载打包清单
你可以把它理解成“扫码枪也能代替部分按钮点击”，适合高频、少手动操作的现场工位。
手动打包
当二维码损坏、表面污染、扫码枪异常，或者现场临时需要人工指定板件时，可以启用手动打包。
这张图说明：手动打包不是日常默认方式，而是扫码失败时的兜底手段。是否需要输入授权码，取决于工厂配置里有没有设置手动打包授权码。
授权码
手动打包授权码通常在 系统管理 → 工厂配置 中设置。如果工厂没有配置授权码，开启手动打包时不会弹出授权校验；如果已经配置，建议只交给确实需要现场兜底处理的人。
播报配置
点击顶部的“播报配置”按钮，可以设置扫码成功或失败时的现场反馈方式。此类配置一般会保存在当前浏览器本地，所以同一台工位电脑下次打开时通常会延续上次设置。
播报模式
- 内容播报（TTS）：语音播报板件信息。
- 可选择播报字段：订单编号、订单名称、房间名称、房间序号、柜体名称、板件名称等。
- 可调节语速、音量、音调。
- 异形板件语音播报（新增）：在配置抽屉中新增了 【异形播报】 开关（对应的底层配置为
speakSpecialShape）。开启后，如果扫描到的板件属于非标或特殊切角的“异形板件”，系统将自动从串行播放队列中取出专属的“异形”提示音进行播报，防止因工人漏看屏幕而导致物理装配和分包错误。 - 铃声提示：通过音效区分成功与失败。
- 模式切换语音：切换打包方式（自由打包、按房间打包、按柜体打包）时，系统会播放对应模式的专属语音提示，帮助现场人员在不看屏幕的情况下确认当前已切换到正确的打包模式。
- 打包组专项语音：如果订单启用了打包组，系统会根据进度播报“不属于当前打包组”、“打包组划分未完成”、“打包组完成”等专项提示音，防止跨组混包。
铃声配置
| 配置项 | 说明 |
|---|---|
| 成功铃声 | 识别成功时播放的音效 |
| 失败铃声 | 识别失败时播放的音效 |
附加选项
| 配置项 | 说明 |
|---|---|
| 扫码成功时播报包裹板件数量（1~99） | 扫描成功后追加播报当前包裹件数，帮助现场判断是否快到封包时机 |
多订单筛选
当同一个板件 ID 可能命中多个订单时，系统会弹出候选订单供你确认。为了减少误选，页面提供了两个常用筛选开关：
| 配置项 | 说明 |
|---|---|
| 跳过已扫描过的订单 | 优先过滤已经扫过或已处理过的订单 |
| 跳过未下生产单的订单 | 过滤尚未进入生产环节的订单 |
这张图要帮你理解：这些筛选项不是强制业务规则，而是为了让候选订单更“干净”，减少现场误点。
屏幕提示
开启后，扫描成功时屏幕中央会以大字显示房间序号等关键信息，适合噪音大、语音不清晰的现场环境。
历史记录
点击顶部的“历史记录”按钮，可以查看当前登录人自己操作过的打包任务，并在需要时一键恢复工作。
常见用途：
- 查看自己之前做过哪些打包任务
- 按“打包中 / 已完成”筛选自己的历史记录
- 显示订单编号、开始时间、完成时间、打包员、包裹总数、当前进度等信息
- 点击某个任务卡片，恢复之前的打包现场
如果你是换班、断电重启、浏览器刷新后继续工作，这个入口很有用；但它不是全厂公共任务池，而是个人历史记录抽屉。
缺件上报
如果在打包过程中发现板件缺失、现场找不到对应实物，或者确认当前订单短时间内无法继续装包，可以直接在工作台内发起缺件上报。
适用场景
- 分拣已完成，但打包时发现某块板件实际缺失
- 封包前核对清单时发现板件未回流
- 同一订单大部分已完成，只剩少量板件长期无法补齐
操作效果
上报后，这个订单会进入统一的缺件跟进流程，后续可由管理人员在缺件上报管理或打包单管理中继续处理，而不是让现场人员一直卡在同一订单上反复补扫。
当前实现里，缺件记录按来源区分：打包工作台上报的记录会标记为打包来源；只有当该订单后续真正满足“全部板件都已封包、所有包裹快照一致、打包单被系统判定完成”时，这条打包来源的缺件记录才会被自动清除。
我的工作量
顶部操作栏支持打开“我的工作量”抽屉，查看当前打包人员的个人工作量汇总。
常见用途：
- 打包员工随时确认自己当日或当前批次的完成量
- 班组长核对个人产出与现场包裹进度是否一致
- 与财务结算页面中的计件数据交叉核对
需要注意的是，这里的工作量不是“每扫一块板就立刻入账”的临时计数，而是在订单真正打包完成后，由系统按该订单下各包裹的打包记录统一汇总生成。
包裹标签
打印标签
最常见的打印路径是：
- 在已打包裹列表中找到目标包裹
- 点击“打印”按钮
- 打印机输出热敏标签
- 将标签贴到对应包裹上
标签内容
标签通常会包含：
- 包裹名称
- 包裹序号
- 订单信息
- 板件数量
- 二维码（便于后续追踪或复核）
标签尺寸
可在 系统管理 → 工厂配置 中设置，例如：
- 默认宽度：100mm
- 默认高度：70mm
包裹板件调整
现场并不是每次都能一次打对。已封包的包裹如果后续发现装错、漏装或需要补装，系统支持对包裹里的板件做调整。
内容变更检测
当包裹封包后，如果其中板件被重新分拣、移出或插入，系统会把该包裹标记为“内容已变更”。此时再打印标签时，系统会提醒你：当前标签对应的快照已经不是最新内容。
查看包裹明细
在已打包裹列表中点击包裹，可查看包裹内的板件明细，例如：
- 板件 ID
- 房间、柜体、名称、尺寸等基础信息
- 每块板件对应的操作按钮
拣出板件
将板件从已封包包裹中移出：
- 点击已打包裹列表中的目标包裹
- 在明细里找到需要移出的板件
- 点击“拣出”
- 板件回到待打包区域，包裹状态标记为“内容已变更”
插入板件
将新的板件插入到已封包包裹中：
- 在待打包板件列表中选择目标板件
- 选择要插入的已封包包裹
- 确认插入操作
- 板件进入目标包裹，包裹状态变为“内容已变更”
重新封包
包裹内容变更后，建议重新封包并重新打印标签：
- 打印标签时，系统提示包裹内容已变更
- 确认重新封包，系统刷新包裹快照
- 打印新标签并替换旧标签
只有当订单下所有板件都已经进入已封包包裹，并且所有包裹的当前内容与封包快照一致时，系统才会把整张打包单判定为完成。完成时会同步生成打包工作量，并触发后续发货单创建和齐套检测。
注意
包裹板件调整后，务必重新打印标签，确保标签内容与实际包裹一致。
常见场景
场景一：按房间连续打包一个订单
这张图适合新人理解“一个订单并不是一次只打一个总包”，而是可能会按房间连续形成多个包裹。
场景二：某块板件二维码损坏
- 开启手动打包功能
- 如果工厂配置了授权码，就先输入授权码；如果没配，可直接进入手动模式
- 在列表中找到该板件
- 点击“加入包裹”手动添加
- 继续正常封包
场景三：打包过程中发现装错板
- 在“当前包裹”区域找到装错的板件
- 点击“移除”先把它移出
- 再把该板件加入正确包裹
- 如错误发生在已封包包裹，则进入包裹明细中调整并重新打印标签
常见问题
Q：为什么我扫描别的订单板件，系统却不让我切过去？
因为当前工作台已经在一个订单上下文里。扫描别的订单板件时，系统会先按当前订单校验，所以会提示“板件不属于当前订单”。如果确实要换订单，可以先确认当前包裹已处理清楚，再点击“切换订单”或扫描 002/orange 清空当前上下文，然后再扫描新订单。
Q：为什么我扫到一半，系统提示板件不属于当前包裹？
通常说明你当前使用的是“按房间打包”或“按柜体打包”，而这块板件不属于当前包裹对应的分组。先确认当前模式、当前包裹名称与板件归属是否一致。
Q：为什么我一进页面就直接看到上次的订单？
因为系统会自动恢复最近未完成的打包任务，避免你每次都重新开始。如果你确实要换订单，先确认当前包裹已封包，再执行切换。
注意事项
- 先确认打包方式：自由打包、按房间、按柜体三种模式会直接影响后续包裹结构。
- 封包前核对当前包裹：不要只看进度数字，也要看包裹里具体装了哪些板件。
- 切换订单前先封包：这是现场避免混包的关键习惯。
- 及时打印并替换标签：尤其是内容已变更的包裹，旧标签不能继续使用。
- 手动打包仅作兜底：能扫码就尽量扫码，减少人工误加板件的风险。
- 缺件不要硬拖现场节奏：确认短时间内补不回来的板件，应及时转入缺件上报流程。