用途
Excel Data Analyzer 用于分析杂乱、非结构化的 Excel 文件，帮助用户识别数据结构、数据质量问题、格式不一致以及统计模式，并生成包含可操作建议的 Markdown 报告，为后续数据清洗和改进提供依据。
主要能力
数据结构检测
自动识别列名与数据类型（整数、浮点、字符串、日期、邮箱、布尔、混合类型），统计每个工作表的行列数、不同值数量，并提供示例值以便快速查看。
数据质量分析
检测缺失值的数量与百分比，标记缺失率超过 50% 的列；识别包含不一致类型的列；发现前后空格、大小写不一致、数字被存储为文本等格式问题。
统计摘要
对数值列生成最小值、最大值、均值、中位数、标准差，并基于 3 倍标准差规则检测异常值，同时输出出现频率最高的前 10 个值及其计数。对文本列统计最小、最大、平均长度以及值频率分布。
质量评分
根据缺失表头（-10 分）、高缺失率列（-15 分）、格式不一致（-10 分）、重复列名（-15 分）等规则，为每个工作表及整个工作簿计算 0-100 的质量评分。
多工作表支持
分析工作簿中的所有工作表，提供每个工作表的质量评分、逐表列分析以及整个工作簿的总体质量评分。
使用方式
首次使用前需安装依赖：
cd /path/to/excel-data-analyzer/scripts
bun install
基本分析命令：
bun run analyze_excel.ts data.xlsx
默认生成 data_analysis.md 报告。可自定义输出路径：
bun run analyze_excel.ts data.xlsx --output reports/audit.md
适用场景
适用于需要在数据清洗前快速了解 Excel 文件质量状况的场景，例如评估数据可用性、定位需要重点处理的列、发现格式与类型问题、识别异常值，以及为数据治理提供优先级建议。
限制
该工具仅生成分析报告，不执行数据清洗；分析基于文本层面，不解释业务上下文；统计方法假设数值数据用于定量分析；异常值检测采用简单的 3-sigma 规则，并非稳健方法。