# Jisu Barcode

> 使用极速数据条码生成识别 API，可按指定类型与参数生成条形码图片（base64），或识别条形码图片中的编码内容。

- Skill: `dvcrn/jisu-barcode` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dvcrn/jisu-barcode`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/jisu-barcode/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/jisu-barcode

---


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

基于 [条码生成识别 API](https://www.jisuapi.com/api/barcode/) 的 OpenClaw 技能，支持：

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

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

## 环境变量配置

```bash
# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"
```

## 脚本路径

脚本文件：`skill/barcode/barcode.py`

## 使用方式

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

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

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

```bash
python3 skill/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）

```bash
python3 skill/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 中的推荐用法

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