huashu-excel：DeepSeek Harness 里让每个数字都能追溯的 Excel 分析流程

它是做什么的？

huashu-excel 是 DeepSeek Harness（DSH）的 Excel 数据分析插件，把「给我一份 Excel，交一份专业报告」变成一条可追溯的流水线。它解决的是 AI 做数据分析时算错却不报错、数字交付出去无法回答「这个数你怎么算的」这一根本问题。核心能力覆盖体检、清洗、对齐、分析、对账、交付、验图、质控八个环节，让每个数字都能回溯到原始单元格。由 alchaincyf 维护，采用 MIT 协议，依赖仅 openpyxl，CSV 路径与报告生成连它都不需要。

核心功能

• 脏表体检：先读原始单元格再动数据，列出表头位置、两级表头、混在数据区的汇总小计行、重复行、合并单元格、文本型数字、缺失值写法不统一等全部问题，一个都不猜。
• 表内对账：把表里自带的「合计」「小计」行当成免费校验和，用清洗后的明细交叉验证，连差 10 块钱的手填错误也能揪出来。
• 八步标准作业流程：体检 → 清洗 → 对齐 → 分析 → 对账 → 交付 → 验图 → 质控，每一步可追溯、可回放。
• 交付前质控闸门：master check 不通过就不给数字，另派一个没参与创作的 agent 从原始数据重算，专门拆自己的台。
• 独立校验脚本：体检、数字校验、图表校验、Word 文档校验均可脱离 agent 单独运行，退出码非零即表示有问题。
• 环境自适应：开工时探测所处环境能力，能并行就并行分析，只能串行就轮转视角，跑不了脚本就转成在 Excel 里怎么点的说明。

怎么使用这个插件？

在 DSH 中启用后直接说人话即可，插件会按意图选择流程：「帮我分析下这份销售表」走完整八步，「这两个数怎么对不上」只跑体检加对账，「这个表有多少行是脏的」只跑体检，「这个数你怎么算出来的」做对账与口径回溯，「给我做份报告」则产出图表、洞察和 html/xlsx/docx 任选格式。它会在开工时先探测环境能力，再决定并行还是串行；交付前必须通过 master check，不通过就不会把数字写进任何交付物。这套流程跨 agent 通用，也可以完全不装，把方法论文档当资料直接读。

报错怎么排查？

校验脚本以退出码报错：数字校验脚本退出码为 1 表示存在对不上的项，图表校验脚本退出码为 1 表示图画错了，Word 文档校验脚本退出码为 1 表示换台机器打开会走样。遇到这类报错时，按官方说明逐项修复对应环节，在问题解决之前不要把相关数字写进交付物。