用途:将培训数据文件中的年份整体平移(例如为新年度的课程材料更新),会同时修改文件名和文件内容。适用于把年份更新到当前课程年份,以及为 Power BI、Excel 或数据分析培训材料准备新年度数据。
主要能力:CSV 文件会扫描带引号的字符串,识别其中的年份并只对引号内的年份做平移,从而保护未加引号的数值字段(如 StoreKey、CustomerKey、ProductKey 等);能处理订单号(如 "202401011CS952" → "202501011CS952")和 DD/MM/YYYY 格式日期,并重命名文件名中含年份的 CSV。XLSX 文件会平移名称为 "Year" 或类似列中 2000–2099 范围内的数值单元格;若无 Year 列,则扫描所有单元格中的独立年份值,但不重命名 XLSX 文件。脚本按年份从高到低处理,避免同一文件内多年度重复平移;修改前始终在目标文件夹内创建 _backup/ 备份;保留 CSV 的 UTF-8 编码。
使用方式: python "<skill-path>/scripts/shift_year.py" "<folder-path>" [--shift N] [--dry-run] 其中 folder-path 为包含数据文件的目录,--shift N 为平移年数(默认 1,负数表示向前平移),--dry-run 只预览将重命名或修改的内容而不改动文件系统,不创建备份。建议先执行 dry-run 预览,确认无误后再正式运行并抽样检查输出;满意后备份文件夹可删除。
限制:--dry-run 不会创建备份;正式运行会先建 _backup/ 再修改文件。文件若混有跨领域且形似年份的值(产品代码、版本号、客户生日、含四位年份的自由文本注释)可能误匹配,应先在 dry-run 中核对并按需调整范围或平移量。资料未提供额外平台、收费或性能信息。