photoshop-automator

🎨 专业级 Photoshop 自动化批处理助手

编辑精选
设计榜 #35

基于 COM 桥接的 Adobe Photoshop 专业自动化工具,支持图层操作、滤镜应用和动作回放,助力设计师实现高效批处理。

收藏
11.5k
安装
2.7k
版本
v1.2.4
CLS 安全性认证2026-05-03
点击查看完整报告 >

使用说明

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 是一款面向专业设计工作流的自动化工具,通过 Windows VBScript(cscript)与 macOS AppleScript(osascript)桥接 Adobe Photoshop 的 ExtendScript 引擎,实现对 CS6 至 2026+ 版本的完整自动化控制。

主要功能模块包括:

  • runScript: 执行原生 ExtendScript(ES3)代码,支持复杂文档操作
  • updateText: 按名称精准定位文本图层并即时更新内容
  • createLayer: 创建带自定义透明度与混合模式的新图层
  • applyFilter: 应用高斯模糊等专业滤镜效果
  • playAction: 播放已录制的 Photoshop 动作(.atn)
  • export: 导出高质量 PNG/JPEG 成品

技术约束:ExtendScript 引擎仅支持 ES3 语法,严禁使用 const/let、箭头函数、模板字符串等现代 JS 特性。

显著优点

1. 零依赖架构:项目无任何 npm 第三方包,完全基于 Node.js 内置模块,彻底规避供应链攻击与 CVE 漏洞风险
2. 跨平台兼容:原生支持 Windows 与 macOS 双系统,自动适配对应脚本宿主

3. 直接 COM 桥接:绕过复杂 SDK,通过系统级脚本宿主直接驱动 Photoshop,响应速度快

4. 临时文件规范:动态生成的 .jsx/.vbs 文件使用随机时间戳命名,执行后立即清理,不残留敏感数据

5. 无网络暴露:代码零外部 API 调用,杜绝数据外泄风险

潜在局限

1. ES3 语法限制:现代 JavaScript 开发者需适应 20 年前的语法标准,增加脚本编写成本
2. GUI 阻塞风险:Photoshop 若存在模态对话框(保存窗口、错误弹窗),COM 操作将挂起或失败

3. T3 来源可信度:个人开发者维护,虽 GitHub 仓库活跃但缺乏企业级背书,需持续关注更新动态

4. 无沙箱隔离runScript 命令可执行任意 ExtendScript,理论上具备完整文件系统访问权限(File/Folder 对象)

5. 错误信息简略:当前仅通过输出字符串匹配判断成败,未细分 Photoshop 未安装、脚本语法错误等场景

适合人群

  • 需批量处理 PSD 模板的设计师与工作室
  • 构建自动化出版工作流的开发者
  • 熟悉 ExtendScript/AppleScript 的资深创意技术用户
  • 对供应链安全敏感、希望规避第三方依赖的企业环境

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 任意代码执行 | 中 | `runScript` 接受用户输入的 ExtendScript,虽为功能必需,但需人工审查防止恶意文件操作 |
| 系统命令注入 | 低 | 参数经 `JSON.stringify` 转义,无注入漏洞,但依赖用户输入可信代码 |
| 文件系统越权 | 低 | ExtendScript 引擎可直接读写磁盘,建议仅运行经审核的脚本 |
| 进程挂起 | 低 | Photoshop 模态对话框阻塞 COM 通信,需用户手动干预 |

安全建议:生产环境使用时应启用代码审查流程,对 runScript 的输入实施白名单校验,并监控 GitHub 仓库更新以获取安全补丁。

photoshop-automator 内容

手动下载zip · 4.2 kB
handler.jstext/javascript
请选择文件