返回目录

dsh-plugin-photoshop

精选清单收录维护状态: 活跃

better-rain/dsh-plugin-photoshop

让 DeepSeek Harness 的 AI 直接驱动你本机的 Photoshop:批量抠图、批量处理、任意 PS 脚本。7 个工具、93 个操作、零依赖。

前往 GitHub
$ dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop

14

星标

1

Fork

JavaScript

语言

MIT

许可证

2026-09-12

创建于

2026-09-15

最近推送

MIT 协议的 DSH 插件,用七个工具把本机 Windows Photoshop 交给 AI:批量抠图、93 个具名操作、任意 ExtendScript 与干跑预览,所有像素都在你自己的机器上处理。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-21

许可证

MIT

01它能帮你完成什么?

  • 在 DeepSeek Harness 里把整个文件夹的图批量抠出主体

    输出目录里得到带透明通道的 PNG-24,每张图一行报告(尺寸、alpha 通道、实测的软边缘像素数),末尾给出成功、失败、跳过的计数

    要从视频抽帧、商品图或插画里取主体,又不想一张张手动做蒙版的人

  • 把一长串有先后顺序的 Photoshop 操作一次跑完,同时保留整体撤销

    整个计划只占一个 undo 步;执行前在本地校验操作名,拼错就当场报错而不是白跑一趟 Photoshop;干跑会解析每个图层引用,但一个像素都不改

    把修图流程脚本化的人——AI 认错图层时,需要一个能安全退回去的抓手

  • 把同一套操作套到一批文件上,同时不动原图

    每个文件都是「打开 → 执行计划 → 存到输出目录 → 不保存关闭」,失败的文件被记录下来,批次继续往下跑

    导出图层、改尺寸、转格式这类生产批次,一个坏帧不该中断整批

02如何接入 DeepSeek Harness?

前置条件

  • Windows。插件通过 COM 自动化接口驱动 Photoshop,macOS 与 Linux 不支持。
  • 本机已安装 Adobe Photoshop。README 在 Photoshop 2026 / 27.0 上完整验证,并说明「选择主体」需要 Photoshop 2020 及以上。
  • 注册了 `tools` 服务的 DSH profile,`web` 是已验证的那个;Node.js 需要 20 或更高(DSH 本体已要求)。
  • 其他都不需要:无需 ffmpeg、无需 Python、无任何第三方依赖。

安装步骤

  1. 01

    在 DSH Web 里从 GitHub 源安装:`dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop`。一条命令、无需构建——仓库里已包含可直接加载的 `lib/`。

    $ dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop

  2. 02

    换个 profile 就换名字:`dsh plugin --profile tui add github:better-rain/dsh-plugin-photoshop`。

    $ dsh plugin --profile tui add github:better-rain/dsh-plugin-photoshop

  3. 03

    重启 `dsh web`。插件是常驻的,之后每个新会话都能驱动 Photoshop。

    $ dsh web

  4. 04

    只有该版本已在 npm 发布后,才能用更短的 `dsh plugin --profile web add dsh-plugin-photoshop`;README 说目前请用上面的 GitHub 源命令。

    $ dsh plugin --profile web add dsh-plugin-photoshop

验证接入成功

  • 重启后让 assistant 跑一次 `photoshop_status`:它会报出 Photoshop 的版本与 build、是否已经在运行、当前打开了哪些文档,以及这个版本有没有「选择主体」和「移除背景」命令。

回滚

  • 用 `dsh plugin --profile web remove dsh-plugin-photoshop` 卸载,profile 名换成你实际安装的那个。

03DSH 适配与能力边界

DSH 适配原生运行时

DSH 原生插件:`dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop` 把插件行写进 profile,重启 `dsh web` 之后,每个新会话里都有七个 `photoshop_*` 工具和一个 `photoshop` 技能。插件跑在 host 平面,零第三方依赖。

  • `photoshop_status` 环境自检

    不需要参数,也不需要打开文档→Photoshop 的版本与 build、是否已经在运行、当前打开了哪些文档、这个版本有没有「选择主体」和「移除背景」命令;README 建议在 Photoshop 相关操作莫名失败时先跑它

  • `photoshop_inspect` 文档与图层树读取

    一个在 Photoshop 里打开的文档→每个文档的尺寸、分辨率、色彩模式、位深、色彩配置文件、磁盘路径、是否有未保存修改、活动图层、选区、历史记录位置与通道 / 路径 / 参考线数量,以及完整的图层树,按索引路径(`0.1`)和名称路径(`Header/Title`)两种方式标识

  • `photoshop_cutout` 批量抠图

    `paths`(图片文件或文件夹)与 `output_dir`,另有 `mode`(`select-subject` 或 `remove-background`)、`recursive`、`trim`、`feather_px`、`contract_px`、`mask_blur_px`、`max_side`、`suffix`、`overwrite`、`limit`、`timeout_ms`→带 alpha 的 PNG-24、每张图一行报告,以及对 alpha 通道的校验——真没变透明就直接写 `NO ALPHA`,不让假成功的文件混过去

    把 PNG 写进输出目录,目录不存在时自动创建Photoshop 没开着时会启动它——冷启动可能要一分钟以上解码每一张输出 PNG,统计完全透明、完全不透明与部分透明的像素数
  • `photoshop_batch` 一批文件跑同一套操作

    `paths`、`ops`、`output_dir`,以及输出格式、后缀、覆盖、递归、数量上限等选项→每个输入文件对应一个输出文件;计划里不允许出现 `open`、`new_document`、`close`、`save_as`——打开、保存、关闭由批次自己负责,带上这四个会被明确拦下并说明原因

    每个输入文件向输出目录写一个输出文件单张失败会被记录,批次继续往下跑
  • `photoshop_apply` 93 个具名操作与干跑

    按顺序排列的操作列表,取自九个分组(document、layer、adjust、filter、select、paint、action、history、metadata),可加 `dry_run: true`→整串操作作为一个 undo 步生效;拼错操作名时当场返回 `Unknown operation "gausian_blur". Did you mean gaussian_blur`,不用白跑一趟 Photoshop;失败时报告第几个操作、操作名、错误原因,以及已经成功应用了哪些

    修改 Photoshop 里当前打开的文档,按一次 Ctrl+Z 可撤销整个计划脚本执行期间临时抑制 Photoshop 弹窗,结束后恢复原来的偏好值
  • `photoshop_run_jsx` ExtendScript 逃生舱

    一段 ExtendScript 源码→脚本自己的返回值,通过 `DoJavaScript()` 在运行中的 Photoshop 里执行——批量改尺寸、跑录制好的 .atn 动作、合成图层、读取文档信息,都不必等插件内置对应功能

    在 Photoshop 里执行任意脚本,因此它能做调用方写下的任何事

04适合谁?何时不该用?

适合

  • 要从视频抽帧、商品图或插画里取主体,又不想一张张手动做蒙版的人
  • 把修图流程脚本化的人——AI 认错图层时,需要一个能安全退回去的抓手
  • 导出图层、改尺寸、转格式这类生产批次,一个坏帧不该中断整批

不适合

  • 只支持 Windows:插件走 Photoshop 的 COM 自动化接口,README 明确 macOS / Linux 不支持。
  • 需要在同一台机器上装好 Adobe Photoshop。README 在 Photoshop 2026 / 27.0 上完整验证,并说明「选择主体」需要 Photoshop 2020 及以上。
  • 有一部分 Photoshop 能力用不到,README 把它们当作实测结论列出:整个「修边」菜单、Neural Filters、生成式填充、Camera Raw 滤镜、低版本上缺失的命令,以及「播放录制动作」(会弹出无法从脚本端关闭的对话框)。当前安装缺什么,`photoshop_status` 会直接列出来。

05兼容性、维护与安全提示

  • 只支持 Windows:插件走 Photoshop 的 COM 自动化接口,README 明确 macOS / Linux 不支持。
  • 需要在同一台机器上装好 Adobe Photoshop。README 在 Photoshop 2026 / 27.0 上完整验证,并说明「选择主体」需要 Photoshop 2020 及以上。
  • 有一部分 Photoshop 能力用不到,README 把它们当作实测结论列出:整个「修边」菜单、Neural Filters、生成式填充、Camera Raw 滤镜、低版本上缺失的命令,以及「播放录制动作」(会弹出无法从脚本端关闭的对话框)。当前安装缺什么,`photoshop_status` 会直接列出来。
  • 第一次调用时如果 Photoshop 没开着,它会启动 Photoshop;脚本执行期间会临时抑制弹窗,结束后立即恢复原来的偏好值。
2026-09-122026-09-15作者未说明

MIT · 尚无正式发布(仓库创建于 2026-09-12,最后一次推送 2026-09-15)

06常见问题

在 DeepSeek Harness 里怎么装?

在 DSH Web 里执行 `dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop`,一条命令、无需构建,因为仓库里已带可直接加载的 `lib/`;然后重启 `dsh web`。插件是常驻的,之后每个新会话都有那七个 `photoshop_*` 工具和 `photoshop` 技能。

对本机环境有什么要求?

Windows,以及本机装好的 Adobe Photoshop。README 在 Photoshop 2026 / 27.0 上完整验证,并说明「选择主体」需要 Photoshop 2020 及以上。Node.js 20 或更高是 DSH 本体自带的,另外无需 ffmpeg、无需 Python、无任何第三方依赖。

会覆盖或关闭我自己的文件吗?

不会。它打开的每个文档都以「不保存」关闭,输出只写到你指定的目录;已存在的输出默认跳过,只有传 `overwrite: true` 才覆盖;你自己打开的文档永远不会被它关闭。想先确认安全,可以给 `photoshop_apply` 加 `dry_run: true`。

怎么确认这台机器真的能用?

先让它跑 `photoshop_status`:报出 Photoshop 的版本与 build、是否在运行、当前打开了哪些文档,以及这个版本有没有「选择主体」和「移除背景」。它是只读的,所以 Photoshop 相关操作莫名失败时,这是最安全的第一调用。

图片会被上传到别的地方吗?

不会。README 写明不联网:没有遥测、不需要账号、不上传任何数据,所有处理都在本机 Photoshop 里完成。它唯一碰的外部资源是你自己的磁盘,而且只写到你指定的输出目录。

08数据与来源

  • 作者声明github.com6cb817c1f086…

    让 DeepSeek Harness 里的 AI **直接驱动你本机的 Adobe Photoshop**:批量抠图、批量处理、跑任意 PS 脚本,不用你手动一张张点。

  • 作者声明github.com6cb817c1f086…

    一个常驻的 DSH 插件,给 AI 装上 7 个工具,用来驱动**你本机的** Adobe Photoshop

  • 作者声明github.com6cb817c1f086…

    dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop

  • 作者声明github.com6cb817c1f086…

    插件名 `dsh-plugin-photoshop` 不含官方包前缀,走的是 DSH 的公开插件规范(导出 `apply(ctx)` + `cordis.patch.yml`)。

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-21。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。