sheet-tools v1.0.0 — 表格批处理（合并 / 拆分 / 套模板 / 清洗 / 格式互转）
======================================================================

纯本地运行：**不联网、不需要 API Key、不用装任何第三方库**（不用 openpyxl、不用 pandas）。
有 Python 3 就能跑，只用标准库 —— xlsx 本质是 zip + XML，脚本自己读写。

目录结构
--------
  SKILL.md            给 AI 看的使用说明（装到 WorkBuddy / CodeBuddy 的 skills 目录即可）
  scripts/table.py    主脚本
  README.txt          本文件

最快上手
--------
  # 1) 先看表结构（只读，不动文件）
  python scripts/table.py info 表.xlsx

  # 2) 预览会做什么
  python scripts/table.py merge 表1.xlsx 表2.xlsx --out 合并.xlsx

  # 3) 真的写盘
  python scripts/table.py merge 表1.xlsx 表2.xlsx --out 合并.xlsx --apply

常用命令
--------
  # 整个目录的 xlsx 合并成一个，并加一列记录来源文件
  python scripts/table.py merge 目录/ --recursive --ext .xlsx --add-source \
    --out 合并.xlsx --apply

  # 按「部门」这一列拆成多个文件
  python scripts/table.py split 表.xlsx --by 部门 --out-dir 按部门 --apply

  # 批量套模板生成工资条（模板里写 {{姓名}} 这种占位符）
  python scripts/table.py fill 工资条模板.xlsx 员工名单.xlsx \
    --name "{{姓名}}-{{月份}}" --out-dir 工资条 --apply

  # 清洗：去空格 + 去重 + 日期归一化
  python scripts/table.py clean 表.xlsx --trim --dedupe --date-cols 入职日期 \
    --out 干净.xlsx --apply

  # csv 转 xlsx（加 --bom 则 Excel 打开中文不乱码）
  python scripts/table.py convert 表.csv --to xlsx --apply

安全
----
  * 不加 --apply 就只是预览，一个文件都不写
  * 结果一律写到 --out / --out-dir 指定的新位置，**不会覆盖输入文件**
  * 套模板前会先检查占位符和数据列是否对得上，缺列会直接中止、不生成半成品

已知边界
--------
  * 只处理数据，不保留样式（字体 / 颜色 / 边框 / 合并单元格 / 公式 / 图表都会丢）
  * Excel 日期会读成 2026-03-05 这种文本
  * 不支持老版 .xls（先另存为 .xlsx 或 .csv）
  * 建议几万行以内；几十万行以上请用数据库或 pandas

全部参数见 SKILL.md，或运行：
  python scripts/table.py info --help
  python scripts/table.py fill --help

有问题 / 要定制 / 想找人做
--------------------------
  加微信：zip678972
  墨屿 MOYU · https://888888888888.top
