核心用法
PSD Automator 是一款面向设计团队的跨平台自动化工具，专注于解决 Photoshop 文档（PSD/PSB）中文本图层的批量替换问题。其架构分为任务协议层与双引擎执行层：macOS 端采用 AppleScript 调用 Photoshop，Windows 端通过 PowerShell COM 接口驱动，确保命令行与聊天渠道（含钉钉）均可无弹窗触发。
典型工作流为：用户通过自然语言或 JSON 任务文件提交需求 → 系统解析 exactPath 或 fileHint 定位目标文件 → 按 edits[] 逐条替换指定 layerName 的文本 → 可选导出 PNG（单图或切片模式）→ 返回结果至聊天窗口。Phase 2 引入 OpenClaw 子代理路由，实现多机分布式执行。
关键 CLI 包括 build-index.js（构建本地 PSD 索引缓存）与 run-task.js（支持 --dry-run 预演）。自然语言指令示例：「把 20260225工位名牌.psd 的姓名改成琳琳，座右铭改成步履不前，保存成 png 放置在桌面」。
显著优点
1. 零交互自动化：禁用 Photoshop 全部对话框，适合 CI/CD 与聊天机器人集成。
2. 风格锁定：替换后自动保持原字体与字号，避免设计走样。
3. 安全机制完备：强制 dry-run 预演、写入前 .bak 备份、标准化错误码（如 E_FILE_AMBIGUOUS 阻断模糊匹配）。
4. 跨平台统一协议：同一套 JSON 任务描述，自动路由至 Mac 或 Windows 引擎。
5. 钉钉原生支持：输出自动附加 [DINGTALK_IMAGE]/[DINGTALK_FILE] 标记，实现图片/压缩包直发。
潜在局限
- 截图理解未支持：无法基于视觉相似度自动定位图层，必须提供准确的
layerName。 - 依赖本地 Photoshop：需目标机器预装完整版 PS，无法脱离 Adobe 生态。
- 路径敏感：Windows/macOS 路径桥接需显式配置
pathBridgeMode，中文路径偶发编码问题。 - 并发瓶颈：Phase 2 子代理模式未明确说明多任务队列调度，高并发场景可能阻塞。
适合人群
- 电商/营销设计团队：需批量生成带变量文案的活动海报、工牌、证书。
- 运维与自动化工程师：需将 PSD 处理嵌入流水线，替代人工打开 Photoshop。
- 钉钉重度用户：希望群内指令直接产出可下载的设计资产。
常规风险
- 本地文件系统风险：脚本具备文件读写权限，误操作
root路径可能扫描敏感目录。 - Photoshop 稳定性：COM/AppleScript 偶发无响应，需配合超时监控。
- 备份与回滚：
.bak机制仅保留一份历史，复杂迭代需外部版本控制补充。 - 图层名漂移：设计稿迭代导致
layerName变更，任务失败率上升，需配套索引刷新策略。