劳动力投入计划

要解决什么问题

施工项目往往先有一份进度计划（分项工程、起止日期），但劳动力投入表通常要手工把「今天需要哪些工种、多少人」从进度里拆出来，还要对照企业内部的分项工程—工种对应关系。工期一长，按日还是按月列表头也不统一，Excel 里还容易乱码。

技能如何工作

本技能以用户提供的进度计划（.xlsx 或 .csv）为输入，并引用内置的分项工程-工种对应关系表（可通过 --mapping 指向自定义 JSON）。

核心流程包括：

• 读取与校验：自动映射列名，计算总工期；工程类型可从列名、文件名或「工程类别」列推断（默认建筑工程）。
• 工种匹配：对「分项工程」做精确、包含、模糊（difflib，相似度 ≥ 0.4）三级匹配；未匹配项会提示并尝试去掉括号后重试。
• 人数与时间分配：内部按日计算；人数优先用「班组人数」列，否则用工程量 × 定额工日，再否则主要/辅助工种默认班组（--main-crew / --aux-crew）。
• CSV 输出：总工期 ≤ 62 天默认按日表头，> 62 天默认按月；可用 --granularity day|month|auto 覆盖。编码为 UTF-8 BOM，便于 Excel 直接打开。

适用边界与注意

进度计划至少需要「分项工程」「开始日期」「结束日期」三列；可选列（工程量、定额工日、班组人数等）越完整，人数估算越准。工种名称必须能在对应关系表中命中，否则该行无法自动配工种。输出前建议核对：日期范围覆盖全周期、合计行与各工种之和一致、未匹配分项是否已处理。