MIT DSH plugin that turns the local Windows Photoshop into seven AI tools — batch subject cutouts, 93 named operations, arbitrary ExtendScript and dry-run previews — with every pixel processed on your own machine.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-11-21
License
MIT
01What can it help you accomplish?
Cut subjects out of a whole folder of images without masking them one by one
Transparent PNG-24 files in the output directory, one report line per image with its size, alpha channel and measured soft-edge pixel count, and a succeeded / failed / skipped tally for the run
People pulling characters out of extracted video frames, product shots or illustrations who would otherwise mask every image by hand
Run a long ordered list of Photoshop operations and still undo all of it in one keystroke
The whole plan as a single undo step, a local pre-flight check that rejects a misspelled operation name before Photoshop is touched, and a dry run that resolves every layer reference while changing zero pixels
Operators who script repeatable retouching passes and need a safe way back when the AI picks the wrong layer
Apply the same operation set across a batch of files while leaving the originals alone
One output file per input, each produced by opening, running the plan, saving into the output directory and closing without saving — with failing files logged and the rest of the batch still running
Production batches such as layer export, resizing or format conversion, where one bad frame must not abort the run
02How to install into DeepSeek Harness
Prerequisites
- Windows — the plugin drives Photoshop through its COM automation interface; macOS and Linux are not supported.
- A locally installed Adobe Photoshop. The README verifies Photoshop 2026 / 27.0 and notes that Select Subject needs Photoshop 2020 or newer.
- A DSH profile that registers the `tools` service; `web` is the verified one, and Node.js 20 or newer is required (DSH itself already needs it).
- Nothing else: no ffmpeg, no Python, no third-party dependencies.
Installation steps
- 01
In DSH Web install from the GitHub source: `dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop`. One command and no build step, because the repo already ships a loadable `lib/`.
$ dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop
- 02
On a different profile, swap the name: `dsh plugin --profile tui add github:better-rain/dsh-plugin-photoshop`.
$ dsh plugin --profile tui add github:better-rain/dsh-plugin-photoshop
- 03
Restart `dsh web`. The plugin is resident, so every new session after the restart can drive Photoshop.
$ dsh web
- 04
The shorter `dsh plugin --profile web add dsh-plugin-photoshop` only works once that version is published on npm; the README says to use the GitHub source command for now.
$ dsh plugin --profile web add dsh-plugin-photoshop
Verify the integration
- After the restart, have the assistant run `photoshop_status`: it reports the Photoshop version and build, whether Photoshop is already running, which documents are open, and whether Select Subject and Remove Background exist on this install.
Rollback
- Remove it with `dsh plugin --profile web remove dsh-plugin-photoshop`, using the profile you installed into.
03DSH integration and capability boundaries
Native DSH plugin: `dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop` writes its own row into the profile, and after `dsh web` restarts the seven `photoshop_*` tools and a `photoshop` skill are there in every new session. It runs in the host plane with zero third-party dependencies.
`photoshop_status` environment self-check
Nothing — no document is needed→Photoshop version and build, whether it is already running, which documents are open, and whether this version has the Select Subject and Remove Background commands; the README says to run it first when a Photoshop call fails for no obvious reason
`photoshop_inspect` document and layer tree readout
A document open in Photoshop→For each document its size, resolution, colour mode, bit depth, colour profile, path, unsaved-changes flag, active layer, selection, history position and channel / path / guide counts, plus the full layer tree addressed by index path (`0.1`) and name path (`Header/Title`)
`photoshop_cutout` batch subject cutout
`paths` (files or folders) and `output_dir`, plus `mode` (`select-subject` or `remove-background`), `recursive`, `trim`, `feather_px`, `contract_px`, `mask_blur_px`, `max_side`, `suffix`, `overwrite`, `limit` and `timeout_ms`→PNG-24 with alpha, one report line per image, and an alpha-channel check that prints `NO ALPHA` instead of letting a file that never became transparent pass as a success
writes PNG files into the output directory, creating it when it does not existlaunches Photoshop when it is not already running — a cold start can take a minute or moredecodes every output PNG to count fully transparent, fully opaque and partially transparent pixels`photoshop_batch` same plan over many files
`paths`, `ops`, `output_dir` and the output format / suffix / overwrite / recursive / limit options→One output file per input, and a plan that may not contain `open`, `new_document`, `close` or `save_as` — the batch owns opening, saving and closing, and rejects those four with an explanation
writes one output file per input into the output directoryrecords a failing file and keeps processing the rest of the batch`photoshop_apply` 93 named operations with dry run
An ordered operation list drawn from nine groups (document, layer, adjust, filter, select, paint, action, history, metadata), optionally with `dry_run: true`→The whole plan applied as one undo step, an immediate local error such as `Unknown operation "gausian_blur". Did you mean gaussian_blur` instead of a wasted Photoshop round trip, and on failure the operation index, name, reason and what already succeeded
modifies the document that is open in Photoshop; one Ctrl+Z reverts the entire plantemporarily suppresses Photoshop dialogs while the script runs, then restores the original preference values`photoshop_run_jsx` ExtendScript escape hatch
An ExtendScript source string→Whatever the script returns, executed through `DoJavaScript()` in the running Photoshop — so batch resizing, recorded .atn actions, layer compositing or reading document data do not have to wait for a built-in operation
executes arbitrary script inside Photoshop, so it can do anything the caller writes
04Who is it for? When not to use it?
Good for
- People pulling characters out of extracted video frames, product shots or illustrations who would otherwise mask every image by hand
- Operators who script repeatable retouching passes and need a safe way back when the AI picks the wrong layer
- Production batches such as layer export, resizing or format conversion, where one bad frame must not abort the run
Not for
- Windows only: the plugin talks to Photoshop over its COM automation interface, and the README states that macOS and Linux are not supported.
- It needs Adobe Photoshop installed on the same machine. The README verifies Photoshop 2026 / 27.0 and says the Select Subject command needs Photoshop 2020 or newer.
- Several Photoshop features stay out of reach and the README lists them as measured facts: the whole Layer > Matting menu, Neural Filters, Generative Fill, the Camera Raw filter, commands missing on older versions, and playing recorded actions because that opens a dialog script cannot close. `photoshop_status` lists what is unavailable on the current install.
05Compatibility, maintenance and safety notes
- Windows only: the plugin talks to Photoshop over its COM automation interface, and the README states that macOS and Linux are not supported.
- It needs Adobe Photoshop installed on the same machine. The README verifies Photoshop 2026 / 27.0 and says the Select Subject command needs Photoshop 2020 or newer.
- Several Photoshop features stay out of reach and the README lists them as measured facts: the whole Layer > Matting menu, Neural Filters, Generative Fill, the Camera Raw filter, commands missing on older versions, and playing recorded actions because that opens a dialog script cannot close. `photoshop_status` lists what is unavailable on the current install.
- It starts Photoshop when the first call arrives and Photoshop is closed, and it temporarily suppresses Photoshop dialogs while a script runs; the original preference values are restored afterwards.
MIT · no tagged release yet (repo created 2026-09-12, last push 2026-09-15)
06Frequently asked questions
How do I install it in DeepSeek Harness?
Run `dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop` in DSH Web — one command, no build, because the repo ships a loadable `lib/` — then restart `dsh web`. The plugin is resident, so every new session afterwards has the seven `photoshop_*` tools and the `photoshop` skill.
What does it need on my machine?
Windows and a locally installed Adobe Photoshop. The README verifies Photoshop 2026 / 27.0 and says Select Subject needs Photoshop 2020 or newer. Node.js 20 or newer comes with DSH already, and there is no ffmpeg, no Python and no third-party dependency to install.
Will it overwrite or close my files?
No. Every document it opens is closed without saving and output only goes to the directory you name, existing outputs are skipped unless you pass `overwrite: true`, and documents you opened yourself are never closed. If you want to be sure before a real run, add `dry_run: true` to `photoshop_apply`.
How do I check that the environment actually works?
Ask for `photoshop_status` first: it reports the Photoshop version and build, whether Photoshop is running, which documents are open, and whether Select Subject and Remove Background exist on this install. It is read-only, so it is the safe first call when something fails without an obvious reason.
Does it send my images anywhere?
No. The README states it does not go online: no telemetry, no account, no uploads — all processing happens in the local Photoshop. The only outside reach is your own disk, which it writes to only in the output directory you specify.
07Related DSH workflows
dsh-agent-teams
by nanmicoder
AgentTeams 多智能体团队协作插件:自然语言驱动建团队、拉成员、拆任务声明依赖、成员间消息直达,Web 右上角活动面板
dsh-blender-plugin
by sixtysevenlf
Adds tools for Blender scene editing, viewport capture, render profiling, headless work, and verification.
dsh-free-search
by dddmuc
DSH 免费搜索插件,执行联网检索。
dsh-bili-scroll
by c1overzz
Schedules Bilibili discovery, reads subtitles, writes daily reports, and optionally posts a comment tagging you.
08Data and sources
让 DeepSeek Harness 里的 AI **直接驱动你本机的 Adobe Photoshop**:批量抠图、批量处理、跑任意 PS 脚本,不用你手动一张张点。
一个常驻的 DSH 插件,给 AI 装上 7 个工具,用来驱动**你本机的** Adobe Photoshop
dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop
插件名 `dsh-plugin-photoshop` 不含官方包前缀,走的是 DSH 的公开插件规范(导出 `apply(ctx)` + `cordis.patch.yml`)。
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-21. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.
