photoshop-automator

Photoshop Automator 是一款专为 Adobe Photoshop 设计的本地自动化桥接工具，通过 COM/ExtendScript 技术实现与 PS 的深度集成。该技能提供六大核心命令：runScript 允许直接执行原始 ExtendScript 代码以完成复杂文档操作；updateText 可精准定位并更新特定文本图层内容；createLayer 支持创建具有自定义透明度和混合模式的新艺术图层；applyFilter 提供高斯模糊等专业滤镜的一键应用；playAction 能够回放预录制的 Photoshop 动作集；export 则可将文档导出为高质量的 PNG 或 JPEG 格式。

该技能的显著优势在于其纯粹的原生集成能力。作为零外部依赖的解决方案，它仅利用 Node.js 内置模块与操作系统原生命令（Windows 的 cscript 和 macOS 的 osascript）进行通信，确保了极高的执行效率和安全性。跨平台支持覆盖了绝大多数设计师的工作环境，而直接调用 ExtendScript 引擎的能力使其能够访问 Photoshop 的全部自动化接口，远超普通 API 的限制。

然而，该技能也存在明显局限。首要限制是强制依赖本地 Adobe Photoshop 安装，且仅支持 Windows 和 macOS 平台，Linux 用户无法使用。其次，ExtendScript 引擎基于 ECMAScript 3 标准，开发者必须避免使用现代 JavaScript 特性如 const/let、箭头函数和模板字符串，这增加了代码编写复杂度。此外，部分数字参数（如半径、透明度）缺乏内置范围验证，不当输入可能导致脚本错误。当 Photoshop 存在模态对话框（如保存窗口）时，COM 操作会挂起或失败，需要用户手动干预。

该技能特别适合需要批量处理 PSD 文件的专业设计师、广告制作团队、电商运营人员以及开发自动化工作流的开发者。对于经常需要更新模板文本、批量应用滤镜或导出多格式文件的用户，能显著提升效率。

使用风险主要包括：runScript 命令具有完整的本地文件系统访问权限，可读写删除本地文件，需确保脚本来源可信；COM 通信机制在 PS 弹出模态窗口时会阻塞，可能导致操作超时；临时脚本文件虽在操作后清理，但异常中断可能留下残留文件；ES3 语法限制要求用户具备特定时代的 JavaScript 知识，现代开发者需要适应。

核心用法

Photoshop Automator Skill 是一款面向专业设计师的自动化桥接工具，通过 ExtendScript (JSX) 引擎与 Photoshop 的 COM 接口通信，支持 Windows 和 macOS 双平台。用户可通过自然语言指令触发五大核心功能：执行原始 ExtendScript 代码 (runScript)、按名称更新文本图层 (updateText)、创建自定义艺术图层 (createLayer)、应用高斯模糊等专业滤镜 (applyFilter)、播放录制的动作集 (playAction)，以及导出高质量 PNG/JPEG (export)。

该 Skill 采用系统命令（cscript/osascript）作为桥梁，将生成的 JSX 代码写入临时文件后交由 Photoshop 执行，实现与宿主应用的深度集成。

显著优点

• 原生性能：直接调用 Photoshop 内部 ExtendScript 引擎，而非外部 API，执行效率接近原生操作
• 功能全面：覆盖从基础文本替换到复杂动作播放的完整自动化场景
• 零依赖架构：无外部 npm 依赖，彻底规避供应链攻击风险
• 跨平台支持：Windows/macOS 双系统原生兼容
• 输入防护：使用 JSON.stringify 对用户输入进行转义，降低代码注入风险

潜在局限

• 语法严格受限：仅支持 ES3 语法（var、function、字符串拼接），现代 JavaScript 特性（const/let、箭头函数、模板字符串）均不可用
• GUI 阻塞风险：Photoshop 若存在模态对话框（保存窗口、错误弹窗），COM 操作将挂起或失败
• 单文档假设：命令默认操作"活动文档"，需确保目标 PSD 已打开
• T3 来源级别：由个人开发者维护，非企业级背书，长期维护存在不确定性
• 无超时机制：spawnSync 未设置超时，Photoshop 卡死时可能导致无限等待

适合人群

• 平面设计师：需要批量更新 PSD 模板中的文本、价格、日期等变量内容
• 电商运营：自动化生成 SKU 主图、详情页切片导出
• 营销团队：基于模板快速产出多尺寸社交媒体素材
• 开发者：构建基于 Photoshop 的自动化工作流 pipeline

常规风险

| 风险类型 | 具体表现 | 缓解措施 |

|---------|---------|---------|

| 系统命令执行 | 通过 `cscript`/`osascript` 启动子进程 | 固定参数、输入转义，属功能必需 |

| 文件系统访问 | ExtendScript 引擎可直接读写 `File`/`Folder` | SKILL.md 已明确声明，需用户审查脚本 |

| 临时文件残留 | `.jsx`/`.vbs` 临时文件可能清理失败 | 使用唯一文件名，执行后强制 `unlinkSync` |

| 代码拼接注入 | 字符串拼接生成 ExtendScript | `JSON.stringify` 转义，风险可控 |

| 路径遍历 | `export` 命令可能接受恶意路径 | 建议增加路径白名单验证 |

综合评估

该 Skill 是一款功能专业、架构清晰的 Photoshop 自动化工具，评分 72/A 级表明其安全基线良好。核心风险（系统命令执行、临时文件操作）均为实现功能所必需，且已通过文档声明和输入转义进行有效控制。适合具备基础安全意识的设计师和开发者使用，但需注意 ES3 语法限制和 GUI 阻塞问题。建议用户在使用 runScript 命令时严格审查脚本内容，避免执行来源不明的 ExtendScript 代码。