order-image-xlsx-cli

把订单截图文件夹识别成 Excel。输出文件默认保存到图片同级目录，文件名为 订单信息.xlsx。

安装

本地安装测试：

npm install -g /path/to/order-image-xlsx-cli

发布到 npm 后：

npm install -g order-image-xlsx-cli

使用

order-image-xlsx "/path/to/订单截图文件夹"

这就是一键启动命令：CLI 会先做环境检测，能自动安装的依赖会自动安装，然后开始识别。

常用参数：

order-image-xlsx preflight "/path/to/订单截图文件夹"
order-image-xlsx preflight "/path/to/订单截图文件夹" --fix
order-image-xlsx "/path/to/订单截图文件夹" --debug-json
order-image-xlsx "/path/to/订单截图文件夹" --output "/path/to/订单信息.xlsx"
order-image-xlsx "/path/to/订单截图文件夹" --backend local --model-size mobile

前置检测

完整检测：

order-image-xlsx preflight "/path/to/订单截图文件夹"

检测并自动修复可修复项：

order-image-xlsx preflight "/path/to/订单截图文件夹" --fix

会检查：

• Node.js 版本
• 包内核心文件是否完整
• 缓存目录是否可写
• 图片文件夹是否存在、是否包含支持的图片格式
• Python 3.10-3.12 是否可用
• 私有 Python 虚拟环境是否存在
• pip 是否可用
• Pillow 是否已安装
• PaddleOCR/PaddlePaddle 是否已安装
• macOS Vision OCR / swiftc 是否可用
• 当前参数最终会走 Vision、local PaddleOCR 还是 API 后端

自动安装逻辑

• npm 安装后会自动创建私有 Python 虚拟环境，并安装基础依赖 Pillow。
• macOS 默认优先使用系统 Vision OCR，速度快，不需要安装 PaddleOCR。
• Windows/Linux，或者显式使用 --backend local 时，CLI 会自动安装 PaddleOCR 和 PaddlePaddle。
• PaddleOCR 模型会在首次本地 OCR 时自动下载到用户缓存目录。

也可以提前安装本地 OCR 依赖并预下载模型：

order-image-xlsx setup --local --preload-models

或者一次性准备全部本地能力：

order-image-xlsx setup --all

诊断

order-image-xlsx doctor

运行环境

• Node.js 18+
• Python 3.10-3.12

CLI 会自动查找 python3.12、python3.11、python3.10、python3、python。Windows 会优先查找 py -3.12、py -3.11、py -3.10。

如果找不到 Python，CLI 会在 preflight 阶段直接提示对应系统的安装命令，例如 Windows 的 winget install Python.Python.3.12 或 macOS 的 brew install [email protected]。

如果需要指定 Python：

ORDER_IMAGE_XLSX_PYTHON=/path/to/python order-image-xlsx setup --local

缓存目录默认位置：

• macOS/Linux: ~/.order-image-xlsx
• Windows: %LOCALAPPDATA%\\order-image-xlsx

可以通过 ORDER_IMAGE_XLSX_HOME 修改。