Sheetsmith 是一个基于 pandas 的轻量级命令行工具,专注于 CSV/Excel 文件的预览、描述、筛选、转换和格式转换。CLI 位于 skills/sheetsmith/scripts/sheetsmith.py,可自动加载 CSV/TSV/Excel 文件,报告结构元数据,执行 pandas 表达式并安全写回结果。
主要命令:summary 打印行列数、dtype 分布、缺失数据列及头尾预览,可用 --rows 控制行数、--tail 预览尾部;describe 运行 pandas.DataFrame.describe(include='all'),可用 --include 定制、--percentiles 添加百分位;preview 快速表格化查看首行或尾行;filter 通过 --query 传入 pandas 查询字符串(如 state == 'CA' and population > 1e6),可打印或配合 --output 写出新文件,--sample 随机抽样;transform 用 --expr 创建新列(如 total = quantity * price),--rename old:new 重命名、--drop column 删除列,通过 --output 或 --inplace 持久化;convert 在 CSV/TSV/Excel 间转换,必须指定 --output 及目标扩展名,Excel 使用 openpyxl,CSV 默认保留逗号,TSV 使用制表符。
使用方式:将表格放入工作区或用完整路径引用,运行 python3 skills/sheetsmith/scripts/sheetsmith.py <command> <path>。修改数据时提供 --output new-file 保存副本,或 --inplace 覆盖源文件。依赖 pandas、openpyxl、xlrd、tabulate。
限制:脚本仅在显式 --inplace 时覆盖原文件;更多示例见 references/usage.md。