跳到主要内容

Skills — 积木报表生成器

1. 功能介绍​

jimureport 是 Claude Code 的 AI Skill（积木报表生成器），支持通过自然语言描述报表需求或提供报表截图，自动生成积木报表（包括数据报表、打印报表、分组报表、循环报表、数据填报等全类型），并通过 API 自动创建到积木报表系统中。

核心能力：

  • 支持按照截图原样生成报表：提供报表截图/图片，AI 自动识别表格布局、字段和样式，还原生成对应报表
  • 可视化 Excel 设计器风格，支持自由布局、合并单元格、多 Sheet
  • 数据绑定：#{数据集编码.字段名} 模板语法
  • 支持数据填报（submitForm）
  • 精细打印控制：纸张大小、边距、方向
  • CSS/JS/Python 增强能力

下载地址： https://github.com/jeecgboot/skills

2. 前置条件​

  • 积木报表系统已部署并可访问
  • 已获取系统的 X-Access-Token（参考 Token 获取方式）
  • Claude Code 已安装 jimureport Skill

3. 使用方式​

在 Claude Code 中直接用自然语言描述报表需求，或提供报表截图即可。以下是触发关键词：

创建积木报表、积木报表、jmreport、做一个可视化报表、
Excel报表、数据填报、积木设计器、create jimureport、visual report

4. 两种使用场景​

4.1 场景A：从自然语言描述生成报表​

适用于从零开始创建新报表。

帮我创建一个员工月度考勤报表，包含姓名、部门、
出勤天数、迟到次数、早退次数、加班时长等字段，
按部门分组统计，底部显示合计行

AI 会自动：

  1. 分析需求，规划表格布局
  2. 设计表头、数据行、合计行
  3. 配置合并单元格和样式
  4. 通过 API 创建到系统中

4.2 场景B：从截图还原生成报表​

适用于已有纸质或电子报表，需要在系统中还原。

直接提供报表截图/图片，AI 会自动：

  1. 识别表格布局和结构
  2. 提取字段名称和数据格式
  3. 分析样式（边框、对齐、字体、颜色等）
  4. 还原生成对应的积木报表

5. 数据绑定语法​

积木报表使用模板语法进行数据绑定：

语法说明示例
#{数据集.字段}绑定数据集字段#{employee.name}
${变量名}系统变量/参数${current_date}
=SUM()聚合函数=SUM(#{sales.amount})
=AVG()平均值函数=AVG(#{sales.amount})
=COUNT()计数函数=COUNT(#{order.id})

6. 实战示例​

6.1 创建销售月报​

第一步：描述需求

创建一个销售月报，包含：
- 标题：XX公司2026年销售月报
- 表头：序号、产品名称、规格型号、单价、数量、金额
- 按产品分类分组
- 每组小计，底部合计
- A4纸横向打印

第二步：AI 询问配置

请提供以下信息：
1. 积木报表后端地址（如 http://localhost:8085）
2. X-Access-Token

第三步：AI 展示配置摘要

## 报表配置摘要
- 名称：XX公司2026年销售月报
- 纸张：A4 横向
- 布局：合并单元格标题 + 分组数据行 + 合计行

| 列 | 字段 | 宽度 | 对齐 |
|----|------|------|------|
| A | 序号 | 60px | 居中 |
| B | 产品名称 | 200px | 左对齐 |
| C | 规格型号 | 150px | 左对齐 |
| D | 单价 | 100px | 右对齐 |
| E | 数量 | 80px | 居中 |
| F | 金额 | 120px | 右对齐 |

确认生成？(y/n)

第四步：自动生成

确认后，AI 自动通过 API 创建报表，返回访问地址。

6.2 截图还原示例​

请根据这张截图还原生成积木报表
[粘贴报表截图]

AI 会分析截图中的表格结构、字段、样式，自动还原为积木报表。

6.3 更多提示词示例​

基础数据报表：

创建一个库存盘点报表，包含物料编码、物料名称、规格、
仓库、库存数量、盘点数量、差异数量，底部显示汇总

数据填报表单：

创建一个费用报销填报表，包含报销人、部门、报销日期，
明细行有费用类型、金额、备注，支持在线填报提交

复杂布局报表：

创建一个学生成绩单，标题合并居中，包含学号、姓名、
语文、数学、英语、物理、化学、总分、排名，
按班级分组，每班显示平均分

7. 支持的报表类型​

报表类型说明适用场景
数据列表标准表格展示明细查询、数据导出
分组统计按字段分组汇总分类统计、部门汇总
交叉报表行列交叉统计多维分析、矩阵展示
数据填报在线表单填报数据采集、审批表单
套打报表套打模板设计发票、快递单、合同

8. 与 Online 报表的区别​

对比项积木报表（jimureport）Online 报表（cgreport）
设计方式Excel 可视化设计器SQL + 配置
适用场景复杂布局、精细样式控制快速配置、简单列表展示
布局能力自由布局、合并单元格、多 Sheet固定列表布局
数据填报支持不支持
打印控制精细控制（纸张/边距/方向）基础打印
学习成本较低（类似 Excel 操作）需了解 SQL
Skill 名称jimureportjeecg-onlreport

积木报表侧重复杂布局和精细样式控制，Online 报表侧重快速配置和简单数据展示。两者互补，可根据实际需求选择使用。

9. Token 获取方式​

  1. 打开积木报表系统并登录
  2. 按 F12 打开浏览器开发者工具
  3. 切换到 Network 标签页
  4. 点击任意请求，在 Request Headers 中找到 X-Access-Token
  5. 复制完整的 Token 值

10. 安装方法​

将 Skill 目录复制到 Claude Code 的 skills 目录：

# macOS / Linux
cp -r jimureport ~/.claude/skills/

# Windows
xcopy jimureport %USERPROFILE%\.claude\skills\jimureport\ /E /I

11. 常见问题​

11.1 截图还原的精度如何？​

AI 会尽可能还原截图中的表格结构和样式，包括合并单元格、字体大小、对齐方式、边框样式等。复杂的装饰性样式可能需要在设计器中手动微调。

11.2 生成的报表可以绑定真实数据吗？​

可以。AI 生成的报表默认使用示例数据，创建后可以在积木报表设计器中配置数据集，使用 #{数据集.字段} 语法绑定真实数据。

11.3 支持导出 PDF/Excel 吗？​

支持。积木报表本身支持导出为 PDF、Excel、Word 等格式，AI 生成的报表同样具备这些能力。