\r \r

PSD 批量修改导出\r

\r 通用 PSD 批量导出工具。任何 PSD + 任何 Excel → 一键 PNG。\r \r

安装\r

\r

# 方式一：ClawHub 安装（推荐）\r
clawhub install luis1213899/psd-batch-export\r
\r
# 方式二：解压 ZIP 到任意目录，进入 scripts/ 运行\r
cd psd-batch-export/scripts/\r
python batch_from_excel.py 名单.xlsx 模板.psd output/\r
```\r
\r
## 快速开始\r
\r
```bash\r
# 预览\r
python batch_from_excel.py 名单.xlsx 模板.psd --dry-run\r
\r
# 导出\r
python batch_from_excel.py 名单.xlsx 模板.psd output/ --color 0 0 0 --size 54\r
```\r
python batch_from_excel.py 名单.xlsx 模板.psd output/ --cols 姓名,学校,赛区\r
```\r
\r
## 流程\r
\r
Excel + PSD → [batch_from_excel] → 批量PSD → 批量PNG(300DPI)\r
\r
## 三个脚本\r
\r
| 脚本 | 用途 |\r
|------|------|\r
| [batch_from_excel.py](./scripts/batch_from_excel.py) | 一键流程 |\r
| [psd_text_editor.py](./scripts/psd_text_editor.py) | PSD文本二进制修改 |\r
| [render_psd_batch.py](./scripts/render_psd_batch.py) | PSD→PNG渲染 |\r
\r
## 参数\r
\r
| 参数 | 说明 | 默认 |\r
|------|------|------|\r
| `--font` | 字体路径 | 系统黑体 |\r
| `--color R G B` | 文字颜色 | PSD原色 |\r
| `--size N` | 字号 | PSD原字号 |\r
| `--align` | 对齐 | center |\r
| `--dpi` | 输出DPI | 300 |\r
| `--cols` | 列映射 | 自动匹配 |\r
\r
## 自动列匹配\r
\r
1. 精确包含匹配\r
2. 同义词：名字↔姓名、学校↔school、赛区↔division\r
3. 按 PSD 图层顺序对应 Excel 列顺序\r
\r
## 字体\r
\r
字体合集：[百度网盘](https://pan.baidu.com/s/16mr469ucSXcNpm-6GD_QeA) 提取码 `kxrv`\r
\r
下载后解压到 [fonts/](./fonts/) 目录即可自动生效。\r
\r
```bash\r
# 或使用自动下载\r
python fonts/download_fonts.py --all\r
```\r
\r
## 限制\r
\r
- 新文本字节数 ≤ 原文字节数（超出自动截断）\r
- 依赖: `psd-tools`, `Pillow`, `pandas`, `openpyxl`\r