xlsx_workbench

AI 驱动的 Excel 文件分析工作台。把 xlsx 文件放进来，用自然语言描述需求，Claude Code 自动完成数据探索、图表生成和条件导出，结果写入 output/。

前置条件

工具	说明
Claude Code	唯一的使用入口，本工作台不提供其他界面
uv	Python 包管理器，用于安装依赖和运行脚本
Python ≥ 3.11	由 uv 自动管理，无需手动安装

快速开始

# 1. 克隆或下载本项目
git clone <repo-url>
cd xlsx_workbench

# 2. 安装依赖
uv sync

# 3. 在项目目录启动 Claude Code
claude

然后把你的 xlsx 文件放入 data/ 目录，在对话框里直接描述需求即可。

想直接试试效果？ 项目自带示例数据 data/销售合同表.xlsx，启动后可直接用于练习，无需准备自己的文件。

目录结构

xlsx_workbench/
├── data/           # 放置你的 xlsx 输入文件
├── output/         # 分析结果自动写入此处（图表、CSV）
├── .claude/
│   └── skills/     # 内置分析技能脚本
├── CLAUDE.md       # Agent 行为配置（无需修改）
├── pyproject.toml  # 项目依赖声明
└── uv.lock         # 依赖锁定文件

示例数据

项目自带 data/销售合同表.xlsx，可直接用于体验，无需准备自己的文件。

字段	类型	说明
合同ID	文本	唯一标识（UUID）
客户ID	文本	客户唯一标识
合同类型	分类	购买合同 / 长期协议订单 / 长期协议 / 服务协议
总金额	整数	合同金额（元）
合同付款类型	分类	一次性付款 / 分期付款
注册时间	日期	客户注册日期
购买数量	整数	本次合同购买件数
合同签约时间	日期	合同签订日期
购买的产品	整数	产品编号（1–7）
是否已经交货	分类	是 / 否

共 668 条合同记录，无缺失值，覆盖多种合同类型与付款方式，适合探索、画图、筛选全流程练习。

使用方式

第一步：准备数据

项目自带示例数据，可直接跳到第二步。若使用自己的文件，将 xlsx 复制到 data/ 目录即可：

data/
└── 销售合同表.xlsx   ← 自带示例，可直接使用

第二步：启动 Claude Code

在项目根目录打开终端，执行：

claude

第三步：用自然语言提需求

直接在对话框输入你的分析需求，无需任何命令。以下示例均基于自带的销售合同表：

探索数据结构

看看销售合同表.xlsx 有哪些字段，数据概况是怎样的

画图

用柱状图对比各合同类型的数量
画出各月签约合同的总金额趋势折线图

筛选导出

筛选出总金额超过100万的合同，导出为 CSV
找出合同数最多的前10个客户

连续分析（同一文件的后续分析，Claude 会记住上下文）

再把这10个客户的合同总金额做个汇总

查看结果

所有生成的文件都在 output/ 目录，每次分析结束后 Claude 会列出清单：

output/销售合同表_合同类型_bar.png  — 各合同类型数量柱状图
output/top10_clients.csv           — 合同数前10名客户明细

内置 Skills

Skill	触发关键词	能做什么
explore-xlsx	探索、概况、有哪些列、缺失、分布、相关性	查看 sheet 结构、列类型、数值统计、缺失值、相关性矩阵
chart-xlsx	画图、折线、柱状、散点、趋势、可视化	生成折线图、柱状图、散点图，输出 PNG
export-xlsx	筛选、排序、导出、前N名、条件过滤	按条件筛选行、排序后导出 CSV

大文件说明

数据行数超过 50,000 行时，Claude 会自动抽样 10,000 行进行分析，并在结果中注明。如需全量分析，请告知 Claude。

常见问题

Q：中文显示乱码怎么办？ 无需手动处理。脚本统一使用 -X utf8 参数运行，Windows 下中文输出正常。

Q：分析结果太多，想清空 output/ 重新开始？ 切换新文件或说"重新开始"时，Claude 会检测到新主题，并询问是否清空 output/，确认即可。

Q：能分析多个 xlsx 文件吗？ 每次分析针对 data/ 下的一个文件。切换文件时，在对话里说明新文件名即可。

Q：想做 Skills 不支持的分析怎么办？ 直接描述需求，Claude 会临时编写 Python 脚本完成分析，结果同样写入 output/。

许可证

LICENSE。