Back to directory

dsh-plugin-photoshop

In a curated listMaintenance: Active

better-rain/dsh-plugin-photoshop

Batch-remove backgrounds / cut out subjects in the user's own Photoshop and run arbitrary Photoshop operation plans or ExtendScript, with dry-run and environment self-check.

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

14

stars

1

forks

JavaScript

Language

MIT

License

2026-09-12

Created

2026-09-15

Last push

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

  1. 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

  2. 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

  3. 03

    Restart `dsh web`. The plugin is resident, so every new session after the restart can drive Photoshop.

    $ dsh web

  4. 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

DSH integrationNative runtime

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.
2026-09-122026-09-15Not specified by the author

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.

08Data and sources

  • Author-claimedgithub.com6cb817c1f086…

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

  • Author-claimedgithub.com6cb817c1f086…

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

  • Author-claimedgithub.com6cb817c1f086…

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

  • Author-claimedgithub.com6cb817c1f086…

    插件名 `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.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.