中级Claude Code

条形码生成 Skill:制作 SKU 与 EAN 标签

用这个条形码生成器 Skill,把已有 SKU、EAN 或 UPC 编号转成 PNG 标签图片。助手可以调用随包 Python 脚本选择格式、保存图片并核对编码,适合准备商品识别和仓库标签;从单张样例开始确认编号正确,再按需要扩展批量处理、库存关联和打印流程。

浏览量
0
复制次数
0
收藏
0
01

条形码生成器如何把商品编号变成 PNG

这项 Skill 接收商品编号、条码格式和保存位置,再通过 Python 脚本生成图片,支持 Code128、Code39、EAN 和 UPC。内部 SKU 包含字母和数字时,可以先用 Code128 生成样张,再到实际仓库设备中核对识别结果。

条码图片承载的是你提供的编号,不会分配 GS1 编号,也不会自动建立库存对应关系。随包脚本每次处理一张图片;需要更多标签时,可以另加 CSV 循环、ZIP 打包和打印机版式处理,把单张生成扩展成适合团队的工作流程。

02

是否适合你的店铺

如果店铺已有商品 SKU,只差把编号做成仓库能扫描的标签,Barcode Generator 就适合这一步。它可以把陶瓷杯的颜色款、服装的尺码款等已有编号转成条形码 PNG,供拣货、盘点或包装标签使用;商品编号的分配和库存记录仍由现有系统管理。

01

把已有 SKU 做成仓库识别标签

对含字母、数字或连字符的内部 SKU,可以先生成一张 Code128 样例并解码核对,再安排批量打印。本页案例解码后得到的编号与输入一致;接入仓库时,还要确认扫码设备和库存软件将这个值对应到正确商品。

02

已有 EAN/UPC 编号时再制作零售条码

销售渠道要求 EAN 或 UPC 时,应使用已经分配给商品的编号。生成后把编码与商品档案核对,特别注意底层库可能重算校验位;制作条码图片不等于完成编号注册,也不能代替平台对编号的接受规则。

03

批量商品和固定标签尺寸需要额外处理

批量生成需要在单张脚本外增加循环或辅助代码,本页案例就是用这种方式处理多个 SKU 并打包 ZIP。固定标签尺寸、标签排版和打印队列应交给适合的打印流程处理,让生成图片与实际贴标衔接起来。

03

使用前的特殊要求

开始运行前,先准备下方业务资料及软件环境。

Python 运行环境

运行前准备Python 3、虚拟环境,以及 python-barcode 与图片依赖。

已确认的商品编号

运行前准备有权使用的有效编号;生成图片不会注册商品编码。

输出目录与扫码检查

运行前准备新的输出目录,以及用于核对结果的扫码器或解码工具。

04

安装

安装完整 Skill 包,再使用上面准备好的店铺资料开始任务。

把下面的指令复制给电脑上的 Codex 或 Claude Code,让助手下载 Skill、配置 Python 环境并生成示例条码。想自己操作终端时,可切换到另一种安装方式。

  1. 打开能访问本机文件和终端的 Codex 或 Claude Code。
  2. 复制下方指令发给正在使用的应用,由助手选择该应用的安装目录。
  3. 查看返回的安装路径和文件检查结果;需要时新建会话,再要求助手使用已安装的 Skill。
请在这台电脑上安装 barcode-generator,并完成一次示例运行。下载、安装和验证命令请直接执行。 1. 将原作者仓库 https://github.com/AIDotNet/MoYuCode.git 下载到新的临时目录,切换到提交 9fa0412ff1d57ca3216835637773ac975cae1009。Skill 位于 skills/tools/barcode-generator。先阅读其中的 SKILL.md 和脚本,再执行。 2. 复制完整 barcode-generator 文件夹,保留目录结构,并附上仓库 LICENSE。如果你是 Codex,安装到 ~/.agents/skills/barcode-generator;如果你是 Claude Code,安装到 ~/.claude/skills/barcode-generator。只安装到我当前使用的应用。如果目标目录已存在,先检查并说明差异,再决定是否替换。 3. 检查 Python 3,在已安装的 Skill 目录内创建 .venv,安装 python-barcode[images]==0.16.1 和 Pillow==11.3.0。后续统一使用这个虚拟环境的 Python,按本机操作系统选择可执行文件路径。 4. 读取安装后的 SKILL.md,用 scripts/barcode_generator.py 将 CCT-MUG-BLUE-001 生成为 Code128。新建输出目录,并通过 --output 指定 PNG 路径。检查实际保存的文件名,确认 PNG 可以打开。如果有独立条码解码工具,再解码并核对结果是否等于 CCT-MUG-BLUE-001;否则分别报告图片生成和解码检查的状态。 5. 最后告诉我 Skill 的绝对安装路径、来源提交、Python 路径、示例图片路径和实际检查结果;说明如何在当前应用调用它,并给一条换成我自己的 SKU 生成标签的后续指令。
05

开始使用:三个店铺任务

以下是主要功能的用例提示词,可以直接复制使用。

01

制作内部 SKU 标签

制作内部 SKU 标签,输出解码结果与 SKU 一致的 Code128 PNG。 SKU 文本和新的输出路径。

查看 Prompt 和变量收起 Prompt 和变量
使用已核对的 barcode-generator 脚本,把 [INPUT] 编码为 Code128,写入新目录。传入 --output,报告实际路径并解码核对。不要分配零售 GTIN。

需要替换的变量

[INPUT]
SKU 文本和新的输出路径。
02

渲染已有 EAN 编号

渲染已有 EAN 编号,输出PNG,以及输入值与编码值的比对。 已分配的 EAN 及预期校验位。

查看 Prompt 和变量收起 Prompt 和变量
用 --format ean13 和 --output 在新目录渲染 [INPUT]。将解码数字与获批商品编号逐位比对,包括校验位;若被修正,明确指出,不要静默接受。

需要替换的变量

[INPUT]
已分配的 EAN 及预期校验位。
03

导出前检查编码

导出前检查编码,输出编码文本或校验错误;不传 --output 不会生成图片。 待检查的值及条码格式。

查看 Prompt 和变量收起 Prompt 和变量
使用已核对的脚本检查 [INPUT],不传 --output。记录编码结果或错误,说明 --width、--height 等参数不受支持,不要声称已保存图片。

需要替换的变量

[INPUT]
待检查的值及条码格式。
06

实际使用案例:给陶瓷杯生成可识别的商品标签

模拟店铺 Cedar & Cart Demo 要为陶瓷杯生成 Code128 标签,SKU 为 CCT-MUG-BLUE-001,不涉及真实顾客数据。

使用步骤与 Prompt

  1. 准备下方案例输入资料,保留商品、政策和经营记录中的金额、单位及时间口径。
  2. 为商品清单中的三个 SKU 生成 Code128 标签,逐张解码核对编号,再把标签和对应关系交给仓库试印。
  3. 提交下方完整 Prompt,查看右侧主要产物;需要交接给同事时,下载包含全部交付文件的压缩包。

案例输入资料:business-inputs.zip

Use the barcode-generator Skill.

We need warehouse labels for the three SKUs in the supplied catalog. Create one Code128 PNG per SKU with a readable label and adequate quiet zones. Decode every generated image and check that its value exactly matches the catalog. Deliver the three label images and a short matching report so the warehouse team can print a sample sheet.

The attached business materials are:
- inputs/catalog.csv

Deliver a complete result.md report that the operations team can read, plus any finished files needed for this task. Keep supporting calculations and evidence with the deliverables. Write the report in English; use the requested target language for customer-facing copy. The business datasets are fictional examples unless the brief explicitly names a live public website.

运行结果

下方直接展示本次 Prompt 产生的主要文件,保留实际输出语言。

Create a readable label for a ceramic mug

案例中的商家经营资料为模拟数据;涉及网站检查时,报告中的页面观察来自所列公开网址。

07

输出能用到哪一步,还需核对什么

把生成文件或估算结果用于店铺前,先核对下方使用限制。

批量与尺寸

脚本逐个生成 PNG;批量导出与缩放需辅助代码。

GS1 注册

生成条码图片不会分配或注册 GS1 编号。

实体打印检查

用于发货前,核对扫码结果并试印实体标签。

常见问题

从条码格式、表格批量生成到打印与编号排错,下面回答把标签用于实际店铺前常遇到的问题。

SKU 标签应该选 Code128、EAN-13 还是 UPC-A?

店内仓库使用 CCT-MUG-BLUE-001 这类包含字母、数字和连字符的 SKU 时,可以先选 Code128,本次脚本测试保留了完整编号。如果零售渠道要求 GTIN,应使用已分配给商品的编号,并选择对方接受的 EAN-13、UPC-A 等格式;内部 SKU 与零售商品编号承担的任务不同。

库存系统还要建立“条码值—商品款式”的对应关系。图片能被扫描,并不等于系统会找到正确商品。先生成一个样本,解码核对,再用仓库实际扫码设备录入库存软件,确认对应商品正确后再处理整个目录。

可以从 Excel 或 CSV 批量生成条形码吗?

可以在原脚本外增加批量辅助程序。原始命令一次生成一张图片,没有直接导入 Excel、批量队列或导出 ZIP 的入口;本次商家案例由助手补写辅助脚本,生成 3 个 SKU 的图片并打包,随后逐张解码核对。

准备表格时一行放一个 SKU,把编号列设为文本,避免导出时丢失前导零。可以要求助手检查空行、重复值和不合法编号,使用独立文件名,并输出“输入编号—图片路径”的对应表。先用少量商品验证;当前案例没有测出最大批量数量或生产吞吐量。

生成 UPC 或 EAN 图片,就等于获得可上架的商品条码了吗?

不是。Barcode Generator 负责把编号绘制成图片,不会分配 GS1 编号,也不会替你向零售商登记企业或商品。商品已有合法分配的编号时,应使用原编号;需要新编号时,先向相应 GS1 机构或销售渠道确认要求,再生成图片。

店内拣货、盘点标签可以围绕内部 SKU 设计;向外部零售渠道供货时,则应先确认对方的编号、标签及商品变体要求。不能因为新图片能扫描,就把原有商品编号换成随意生成的一串数字。

为什么条码 PNG 能解码,打印后却扫不出来?

先区分编码错误与印刷问题。用解码器读取原 PNG,确认内容与 SKU 一致;如果原图正确,再检查打印是否拉伸了比例、裁掉两侧留白,或把条线缩得太细。同时检查黑白对比、污渍、折痕及扫码器是否启用了对应格式。

当前原脚本没有标签纸排版或 400×100 尺寸控制入口,这部分需要标签软件或另加辅助程序处理。先按计划使用的实体尺寸打印少量样本,再用真实设备试扫。本次测试证明的是数字图片可解码,没有认证特定打印机、耗材和扫码设备的组合。

为什么生成的 EAN 或 Code39 内容可能与输入不一样?

底层条码库会按格式处理编码。本次测试中,EAN 可能重新计算最后一位校验码,Code39 可能追加校验字符。因此,命令执行成功不代表图片中的编号一定与原输入完全相同。

应同时比对三项:商品资料中的正式编号、传给脚本的文本、图片独立解码后的内容。有差异时先暂停该商品导出,再判断是原编号、所选格式还是校验设置造成的。结果表中保留预期值,不要直接用库自动修正的数字覆盖商品主数据。

这个 Skill 能导出 SVG、PDF 标签页或打印机专用文件吗?

当前核对的脚本通过 ImageWriter 保存 PNG,没有原生 SVG 开关、PDF 标签页排版器或打印机语言导出功能。需要这些格式时,应单独增加转换或排版步骤,并明确哪些能力是后来补上的。

可以从实际打印要求反推输出:先确定标签纸规格、实体尺寸、打印分辨率、文字位置和每款打印份数,再检查排版是否保留了可识别的条线与留白。仓库需要日常稳定打印时,把编号或生成图片交给现有标签软件,通常比围绕这个脚本重新搭建打印系统更直接。

暂无评论。

发表评论

请先为每一项打分,再分享你的真实使用体验。

任务有效性
安装与使用难度
稳定性与边界
文档清晰度
首次获得有效结果

原始页面未公开评分、评价、Product Hunt 投票、Stars、Forks、安装或下载数量。