invoice-processor 是一个用于发票自动化处理的技能，通过 AI 视觉模型从发票文件（PDF、JPG、JPEG、PNG）中提取结构化信息，并生成格式化的 Excel 报告。当用户提到“处理发票”“识别发票”“提取发票信息”“发票转Excel”等说法，或需要处理发票文件、转换发票格式时，可自动触发。
使用前需在该技能目录创建 .env 文件并设置 GLM_API_KEY，密钥来自 https://open.bigmodel.cn/。建议先运行环境检查：python .claude/skills/invoice-processor/scripts/check_env.py，它会验证 API Key 是否设置以及 aiohttp、PyMuPDF、openpyxl 等依赖是否安装。
识别发票时运行 invoice_ocr.py，默认处理 invoices 目录并输出 invoice_results.json，也可用 -i 指定输入路径、-o 指定输出 JSON。该脚本会扫描发票文件、将 PDF 转为 200 DPI 图像、最多并发处理 5 个文件，提取类型、号码、日期、买方与卖方名称、不含税金额、含税金额、税额、明细等 9 个字段，并保存成功或错误状态。前置依赖为 .env 中的 GLM_API_KEY 以及 aiohttp、PyMuPDF。
生成 Excel 时运行 convert_to_excel.py，默认读取 invoice_results.json 并输出 invoice_results.xlsx，同样支持 -i 与 -o 自定义路径。它会生成含 12 列的格式化 Excel，并在转换成功后自动删除输入 JSON。该步骤依赖 openpyxl。
注意：项目目录包含中文等非 ASCII 字符时，必须使用从项目根目录开始的完整相对路径（如 .claude/skills/invoice-processor/scripts/...），否则会出现编码错误；命令请使用 Unix 风格（ls 而非 dir）。GLM API 限制为 5 个并发请求、每个请求 60 秒超时；图像最大 5MB、6000x6000 像素；PDF 会自动转图像并清理临时文件。更多设计原则、定制选项与架构说明见 README.md。