barcode2

极速数据条码生成识别（Jisu Barcode）

基于条码生成识别 API 的 OpenClaw 技能，支持：

生成多种类型条形码（EAN13、EAN8、CODE11、CODE128、CODE39、CODE93、GS1128、I25、ISBN、MSI、UPCA、UPCE、CODEBAR 等），返回 base64 图片内容；
从条形码图片（URL 或 base64）中识别出条码类型与编号。

使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/barcode/

环境变量配置

# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"

脚本路径

脚本文件：skills/barcode/barcode.py

使用方式

当前脚本提供 2 个子命令：

generate：条码生成（/barcode/generate）
read：条码识别（/barcode/read）

1. 条码生成（/barcode/generate）

python3 skills/barcode/barcode.py generate '{
  "type": "ean13",
  "barcode": "6901236341056",
  "fontsize": 12,
  "dpi": 72,
  "scale": 2,
  "height": 40
}'

请求字段：

字段名	类型	必填	说明
type	string	是	条码类型，如 `ean13` 等
barcode	string	是	条码号
fontsize	string/int	是	字号
dpi	string/int	是	DPI
scale	string/int	是	比例
height	string/int	是	高度

返回字段（result）：

字段名	类型	说明
type	string	条码类型（如 EAN13 等）
fontsize	string	字号
dpi	string	DPI
scale	string	比例
height	string	高度
barcode	string	条码图片 base64 内容

2. 条码识别（/barcode/read）

python3 skills/barcode/barcode.py read '{
  "barcode": "https://api.jisuapi.com/barcode/barcode/1471602033673149.png"
}'

请求字段：

字段名	类型	必填	说明
barcode	string	是	支持 base64 或可访问的条码图片 URL，图片文件最大支持 500K

返回字段：

result 为数组，每个元素包含：

字段名	类型	说明
type	string	条码类型
number	string	条码内容

常见错误码

业务错误码（来源于官网文档）：

代号	说明
201	条码类型不正确
202	条码号为空
203	条码不正确
206	条码地址不正确
210	没有信息

系统错误码：

代号	说明
101	APPKEY 为空或不存在
102	APPKEY 已过期
103	APPKEY 无请求此数据权限
104	请求超过次数限制
105	IP 被禁止
106	IP 请求超过限制
107	接口维护中
108	接口已停用

在 OpenClaw 中的推荐用法

用户提问：「帮我生成一个 EAN13 条形码图片」「帮我识别这个条形码里的编号」。
对于生成需求：根据用户提供的条码号与类型构造 generate 请求，从返回的 barcode 字段中获取 base64 图片内容，供前端直接展示或保存为 PNG；
对于识别需求：将条码图片 URL 或 base64 作为 barcode 参数调用 read，遍历返回数组，读取每条记录的 type/number 回答给用户。