单据条形码

要解决的问题

跟进单号、入库单号这类单据号在系统里通常只是一段文本，人工核对既慢又容易错。另一个现实问题是：不少条码库生成的是位图，放进打印样式后容易模糊、扫不出来；还有些库默认码制不是 CODE128，仓库扫描枪不认。这个技能把「单据号 → 可打印条码」这条链路收敛成一套固定做法。

核心能力与关键步骤

它基于 JsBarcode，默认输出 CODE128，内容限定为可见 ASCII，空串直接拒绝。渲染时默认带可读文字（displayValue: true），只有用户显式关闭才隐藏。条码画在浏览器的 canvas 或 svg 上再走打印，不依赖任何仓库私有组件，交付的是一段可复用的 SVG/Canvas 用法片段。

Agent 侧的步骤很明确：

• 实现渲染函数，单据号输入框失焦即生成；
• 自测时拿样例单号在手机上扫一遍（有条件的话）；
• 打印样式单独处理，避免缩放导致条码模糊。

适用边界与注意点

• 只做 CODE128，不会顺手输出 QR 或其它码制；
• 内容必须是可见 ASCII，含中文或控制字符会触发库报错，此时要给出可读提示而不是静默失败；
• 打印前确认条码区域对比度足够，宽度随内容长度自适应，长单号注意别挤到边界外；
• 库抛出的异常不要吞掉，把原因说清楚。