极速数据条码生成识别（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回答给用户。