dsh-excel-kit

当一个工作簿膨胀到上百兆，默认做法——把整个 xlsx 读进内存再描述、过滤或透视——会让任何推理管线的上下文预算迅速崩溃。dsh-excel-kit 用纯流式引擎替代了这种全量加载：惰性 zip 解压缩、逐行 SAX 解析 worksheet XML、共享字符串表按 8 MB 分块刷盘并配小型 LRU 缓存。整个流程内存有界，实测 133 MiB 文件 describe 峰值 RSS 增量仅 153 MiB，pivot 低至 36 MiB。

插件暴露三个只读工具：excel_describe 对工作簿和各列做类型分布、非空率、数值 min/max/mean 及样本行画像；excel_filter 支持 eq、ne、gt、gte、lt、lte、contains、in、between 九种条件筛选，默认上限 100 行、硬顶 500；excel_pivot 按用户指定的行列分组，对值列做 count、sum、mean、min、max 聚合，默认上限 50 组。日期列通过 numFmtId 识别并输出 ISO 字符串，科学计数法、布尔、内联字符串、空单元格均有处理。结果超过 32 KB 阈值时经 ctx.spillStore 持久化，单次响应不会撑爆模型上下文。

如果你在 dsh（DeepSeek Harness）上需要让模型查看大 Excel、跑一次筛选或生成一张小透视表，又不想引入 pandas、不想全量加载、不想有任何写入或格式副作用，dsh-excel-kit 正好补上这一块。它不是 BI 替代品，而是一个轻量、只读、低内存的推理时表格分析层。