CommunityImagegithub.com

photoshop

Automate Photoshop via COM+JSX. Use when P图/效果图/合成.

What is photoshop?

photoshop is a Claude Code agent skill that automate Photoshop via COM+JSX. Use when P图/效果图/合成.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dsffs488/dsh-agent-skills/tree/HEAD/skills/media-ops/references/photoshop

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Photoshop Automation (按需)

需要云端生图/改图模型时,选型与价格查 model-package 技能(改图默认档 qwen-image-edit-plus 0.20 元/张;能本机 PS/ComfyUI 干就本机)。

Adobe Photoshop 2026 (v27.x) is installed at D:\ps\Adobe Photoshop 2026\Photoshop.exe — NOT under Program Files. Drive the OPEN PS instance through its COM interface and JSX (".NETDoJavaScript") channel. Loads only when the user asks to work with Photoshop / 效果图 / P图.

效果图工作流选择(用户偏好)

做效果图/P图时,优先用多模态视觉模型驱动全流程(看图→定位→绘制→验收),不要用纯文本模型绕 API 做坐标中转——后者慢、易返工。

  • 首选:让用户在 app 顶部把当前会话切到 TokenPlus 的 qwen/qwen-3.8-max(已验证支持视觉输入,base_url=https://<LLM_GATEWAY_HOST>/v1),完事切回 flash。这是用户明示的升档路径("直接升档不就行了吗")。
  • 备选:不能切会话时用 DeepSeek 官方视觉实验模型裸调当几何定位器(现行多模态默认=模型包① deepseek-v4.1-flash),效率低于多模态会话。
  • 执行通道:PIL/OpenCV 直接画(快速出图)或 PS COM+JSX(甲方后期要反复改图时)。PS 必须已打开。

连接与探测 (本机已验证通道)

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$ps = New-Object -ComObject Photoshop.Application
Write-Host ("PS版本: " + $ps.Version)
# JSX 写文件回读验证 (最稳写法:JSX内不弹窗、不传参)
$jsx = 'var f = new File("D:/ps/probe.txt"); f.open("w"); f.write(app.version + "|docs=" + app.documents.length); f.close(); "OK"'
$r = $ps.DoJavaScript($jsx)

定位主程序 — 别猜路径

本机 PS 装在 D:\ps\, 不在一级默认目录。找真实路径用进程:

Get-Process | Where-Object {$_.ProcessName -match 'Photoshop'} | Select-Object Id, Path

JSX 通道 vs COM 属性

  • 读版本/文档数用 COM 属性最省事 ($ps.Version / $ps.Documents.Count)。
  • 驱动图层编辑、裁剪、导出用 DoJavaScript('<jsx>')。JSX 里 app.activeDocument 拿当前文档, ExportDocument/saveAs 落盘。
  • 写文件回读是验证 JSX 最稳的方式: JSX 内 new File(path) 写文本, COM 同步返回标记, 外再 cat 确认。避免 JSX 返回复杂对象解析问题。

DoJavaScript 参数陷阱

  • 别用 alert() 在 JSX 里弹窗验证 — 会弹真实 GUI 对话框卡住 PS, COM 后续调用返回 RPC_E_SERVERCALL_RETRYLATER (0x8001010A, message filter: application busy), 必须用户手动关掉对话框才恢复。写文件回读替代弹窗。
  • 传参给 DoJavaScript 的 .NET 类型重载易报 "指定转换无效"。无参字符串 (默认类型) 最稳, 复杂参数放弃重载直接写进 JSX 字符串。

必要前置

  • PS 必须已打开 (COM 连的是运行实例, 不是后台服务)。用户没开时先让用户打开。

效果图定位坐标(P图前置)

做效果图前先确定 P 的精确位置:降采样到≤1200宽→视觉模型标点(折线给所有转折点)→映射×k 回原图→绘制→vision 验收迭代。完整工作流见 references/vision-coordinate-location.md(含 BGR 颜色陷阱、灯带绘制参数、findContours 不可靠警告)。

scripts

  • scripts/probe.ps1 — 连接+版本+文档数探测, 首次接入必跑。
  • references/vision-coordinate-location.md — 视觉模型辅助定位坐标 + 灯带绘制要点。

PS 自动启动(截图定位实测, 2026-10-09)

COM 只能连已运行实例。用户没开 PS 时别喊人, 直接拉起并保持拥有权:

Start-Process "D:\ps\Adobe Photoshop 2026\Photoshop.exe"
# 轮询实例就绪(首次启动慢, 授权/加载可能 30-60s):
$ok = $false; foreach ($i in 1..60) {
  try { $ps = New-Object -ComObject Photoshop.Application; $null = $ps.Version; $ok = $true; break }
  catch { Start-Sleep -Seconds 2 }
}
if (-not $ok) { throw "PS 启动超时, 检查授权弹窗/登录" }
  • 探活里 throw 前先截图确认是否有首启弹窗(EULA/字体登录)挡着——有弹窗让用户点一次, 点完无需重启轮询。
  • 顺手补记 launch 状态到当次输出, 下次可直接 New-Object 免启动。

ComfyUI → PS 真人P图联合流水线(2026-10-09 定案)

真人 P 图接单统一链路: ComfyUI 本地出图(照片不出本机红线)→ PS COM+JSX 精修收尾。分工:

环节工具说明
主生成/批量ComfyUI(工具\AI\ComfyUI)换背景/换衣服/脸部微调/换脸;扩散模型无系统提示词, 不羞涩不拒绝
精修复收PS COM+JSX边缘融合/瑕疵/液化/最终交付品质收尾

铁律: 客户照片不做任何云端 API 上传(ComfyUI 只在本地, PS 只加载本地文件不联网)。多张锁同一人=同一 seed+同一 base 模型+低步数变体, 不许跨图重新识别。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Related Skills