exstruct
将Excel文件高效转换为结构化JSON/YAML数据的提取引擎。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：exstruct。 它的用途是：将Excel文件高效转换为结构化JSON/YAML数据的提取引擎。 完整的 Skill 内容见：https://321skill.com/skills/exstruct/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我把这份销售报表Excel文件转换成结构化的JSON，我需要里面的表格数据和所有图表注释。’，它会调用ExStruct，以‘standard’或‘verbose’模式运行，输出一个包含单元格、检测到的表格区域、形状文本及图表信息的JSON文件，方便你进一步分析或导入数据库。
介绍
ExStruct是一个专为处理Excel文件设计的结构化数据提取引擎。它解决了从复杂Excel工作簿（包含单元格、形状、图表、表格等）中提取结构化信息的难题，尤其适用于需要将Excel数据输入到LLM、RAG管道或自动化脚本中的场景。
使用ExStruct非常简单，通过pip安装后，即可通过命令行或Python API调用。它提供多种输出模式，从轻量级的OOXML解析到功能完整的Excel COM集成，并能将结果输出为JSON、YAML等多种格式。用户可以根据环境（Windows/Linux/macOS）和需求选择最合适的提取深度。
这个工具非常适合数据分析师、后端开发者和需要处理大量Excel报告的业务人员。无论是为了构建知识库进行数据预处理，还是为了自动化报表分析流程，ExStruct都能提供可靠的结构化数据源。
需要注意的是，在非Windows环境下，部分高级功能（如通过COM提取带格式的形状）需要依赖LibreOffice运行时才能达到最佳效果。如果环境中没有Excel COM或LibreOffice，它会自动回退到基础的OOXML解析模式，确保流程不会中断。
核心特点
与简单读取单元格的库不同，ExStruct能深度提取Excel中的形状、图表、SmartArt、打印区域等非表格元素，并提供了针对LLM/RAG管道优化的结构化输出和可调整的启发式表格检测算法。
注意事项
在无COM且无LibreOffice运行时的Linux/macOS环境下，无法提取合并单元格、形状和图表等高级元素。
常见问题
ExStruct支持哪些Excel文件格式？
主要支持.xlsx和.xlsm格式。在COM或LibreOffice环境下支持更广。
如何在服务器（无图形界面）上使用ExStruct？
在Linux/macOS服务器上，可以安装LibreOffice运行时以启用‘libreoffice’模式来获取更丰富的提取结果，否则将使用基础的‘light’模式。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/exstruct/raw/index.md 读取 exstruct 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/exstruct/raw/index.md（查看排版版本）