MIT ライセンスの DSH プラグイン。ローカルの Windows 版 Photoshop を 7 つのツールとして AI に渡し、一括切り抜き、93 個の名前付き操作、任意の ExtendScript、ドライランを提供します。処理はすべて自分のマシン内で完結します。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-21
ライセンス
MIT
01どんなタスクに使えるのか?
DeepSeek Harness から、フォルダ内の画像をまとめて切り抜く
出力フォルダに透過 PNG-24 が並び、画像ごとに 1 行のレポート(サイズ、アルファチャンネル、実測したソフトエッジのピクセル数)が出て、最後に成功・失敗・スキップの件数が付きます
動画から取り出したフレーム、商品写真、イラストから被写体を取り出したいが、1 枚ずつ手作業でマスクを切りたくない人
順序を持つ長い Photoshop 操作をまとめて実行し、あとから一度に取り消せるようにする
計画全体が 1 つの undo ステップになり、実行前にローカルで操作名を検証するので誤字は Photoshop を動かす前にエラーで返り、ドライランはレイヤーの参照だけを解決してピクセルは一切変更しません
レタッチ工程をスクリプト化していて、AI がレイヤーを間違えたときに安全に戻せる足場が欲しい人
同じ操作セットを多数のファイルに適用し、元ファイルには手を付けない
各ファイルは「開く → 計画を実行 → 出力フォルダに保存 → 保存せずに閉じる」の順で処理され、失敗したファイルは記録したうえでバッチは最後まで続きます
レイヤーの書き出し、リサイズ、形式変換といった本番バッチで、1 枚の不良で全体を止めたくない人
02DeepSeek Harness への導入方法
前提条件
- Windows が必要です。Photoshop の COM オートメーション経由で動かすため、macOS / Linux は対象外です。
- ローカルに Adobe Photoshop がインストールされていること。README は Photoshop 2026 / 27.0 で検証済みで、「選択主体」には Photoshop 2020 以降が必要としています。
- `tools` サービスを登録した DSH プロファイル。検証済みは `web` で、Node.js 20 以降(DSH 本体の要件)が必要です。
- それ以外は不要です。ffmpeg も Python もサードパーティ依存もありません。
インストール手順
- 01
DSH Web では GitHub のソースから入れます:`dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop`。ビルドは不要で、読み込み可能な `lib/` がリポジトリに含まれているため 1 コマンドで済みます。
$ dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop
- 02
別のプロファイルなら名前を差し替えます:`dsh plugin --profile tui add github:better-rain/dsh-plugin-photoshop`。
$ dsh plugin --profile tui add github:better-rain/dsh-plugin-photoshop
- 03
`dsh web` を再起動します。常駐型なので、再起動後の新しいセッションから Photoshop を動かせます。
$ dsh web
- 04
$ npm に公開済みのバージョンがある場合に限り、短い `dsh plugin --profile web add dsh-plugin-photoshop` も使えます。README は当面 GitHub ソースのコマンドを使うよう案内しています。
導入成功の確認
- 再起動後に assistant へ `photoshop_status` の実行を頼んでください。Photoshop のバージョンとビルド、起動中かどうか、開いているドキュメント、この環境に「選択主体」と「背景を削除」があるかを報告します。
ロールバック
- `dsh plugin --profile web remove dsh-plugin-photoshop` で削除します。プロファイル名は実際に導入したものに合わせてください。
03DSH 統合と能力の範囲
DSH ネイティブプラグインです。`dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop` でプロファイルに自分の行を追加し、`dsh web` を再起動すると、以後の新しいセッションで 7 つの `photoshop_*` ツールと `photoshop` スキルが使えます。プラグインはホスト側で動作し、サードパーティ依存はありません。
`photoshop_status` による環境の自己診断
引数もドキュメントも不要です→Photoshop のバージョンとビルド、すでに起動しているか、どのドキュメントが開いているか、このバージョンに「選択主体」と「背景を削除」があるかを報告します。Photoshop 関連の操作が理由もなく失敗するときは、まずこれを実行するよう README が案内しています
`photoshop_inspect` によるドキュメントとレイヤーツリーの読み取り
Photoshop で開いているドキュメント→各ドキュメントのサイズ、解像度、カラーモード、ビット深度、カラープロファイル、ディスク上のパス、未保存の変更の有無、アクティブレイヤー、選択範囲、履歴の位置、チャンネル / パス / ガイドの数に加え、レイヤーツリー全体をインデックスパス(`0.1`)と名前パス(`Header/Title`)の 2 通りで示します
`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`→アルファ付き PNG-24、画像ごとの 1 行レポート、そしてアルファチャンネルの検証。実際には透過していないファイルは `NO ALPHA` と明記され、成功したように見えるだけの出力は通りません
PNG を出力フォルダに書き込み、フォルダがなければ作成しますPhotoshop が起動していなければ起動します。コールドスタートには 1 分以上かかることがあります出力した PNG をすべてデコードし、完全透明・完全不透明・部分透明のピクセル数を数えます`photoshop_batch` による複数ファイルへの同一計画の適用
`paths`、`ops`、`output_dir` と、出力形式・接尾辞・上書き・再帰・上限の各オプション→入力ファイルごとに 1 つの出力ファイルを作ります。計画には `open`、`new_document`、`close`、`save_as` を書けず、これらが含まれると理由付きで拒否されます(開く・保存する・閉じるはバッチ側の責務です)
入力ファイルごとに出力フォルダへ 1 つの出力ファイルを書き込みます失敗したファイルを記録したまま、バッチの残りを処理し続けます`photoshop_apply` の 93 個の名前付き操作とドライラン
9 つのグループ(document、layer、adjust、filter、select、paint、action、history、metadata)から選んだ順序付きの操作リスト。`dry_run: true` も指定できます→操作列全体が 1 つの undo ステップとして適用されます。操作名の誤字は Photoshop を動かす前に `Unknown operation "gausian_blur". Did you mean gaussian_blur` として返り、失敗時には何番目の操作か、操作名、理由、すでに成功した操作を報告します
Photoshop で開いているドキュメントを変更します。Ctrl+Z 1 回で計画全体を取り消せますスクリプト実行中は Photoshop のダイアログを一時的に抑制し、終了後に元の設定値へ戻します`photoshop_run_jsx` による ExtendScript の脱出口
ExtendScript のソース文字列→スクリプトの戻り値。実行中の Photoshop で `DoJavaScript()` 経由で動くため、一括リサイズ、録画済み .atn アクションの実行、レイヤーの合成、ドキュメント情報の読み取りも、内蔵操作を待たずに済みます
Photoshop 内で任意のスクリプトを実行するため、呼び出し側が書いたことは何でも起こりえます
04誰に向いているのか?使うべきでない場面は?
向いている用途
- 動画から取り出したフレーム、商品写真、イラストから被写体を取り出したいが、1 枚ずつ手作業でマスクを切りたくない人
- レタッチ工程をスクリプト化していて、AI がレイヤーを間違えたときに安全に戻せる足場が欲しい人
- レイヤーの書き出し、リサイズ、形式変換といった本番バッチで、1 枚の不良で全体を止めたくない人
不向きな用途
- 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 を起動します。スクリプト実行中はダイアログを一時的に抑制し、終了後すぐに元の設定値へ戻します。
MIT · 正式リリースはまだありません(リポジトリ作成 2026-09-12、最終プッシュ 2026-09-15)
06よくある質問
DeepSeek Harness にはどう導入しますか?
DSH Web で `dsh plugin --profile web add github:better-rain/dsh-plugin-photoshop` を実行します。ビルド不要の 1 コマンドで、読み込み可能な `lib/` がリポジトリに含まれています。その後 `dsh web` を再起動してください。常駐型なので、以後の新しいセッションで 7 つの `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 のバージョンとビルド、起動中かどうか、開いているドキュメント、このバージョンに「選択主体」と「背景を削除」があるかを報告します。読み取り専用なので、理由の分からない失敗のときに最初に呼ぶのに向いています。
画像がどこかへ送信されることはありますか?
ありません。README は非ネットワークを明記しており、テレメトリもアカウントもアップロードもなく、処理はすべてローカルの Photoshop 内で完結します。触れる外部リソースは自分のディスクだけで、しかも指定した出力フォルダにしか書き込みません。
07関連する DSH ワークフロー
dsh-agent-teams
by nanmicoder
DeepSeek Harness 用の AgentTeams プラグイン
dsh-blender-plugin
by sixtysevenlf
DeepSeek Harness から Blender を TCP 経由でリアルタイム操作するプラグインです。ビューポート取得、任意角度レンダー、探索、レンダリング計測、安全な軽量化、ヘッドレス実行などに対応します。
dsh-free-search
by dddmuc
DeepSeek Harness 向け無料 Web 検索(DuckDuckGo、API キー不要)
dsh-bili-scroll
by c1overzz
Bilibiliの動画を定期的に探して字幕を確認し、日次レポートを作成します。必要に応じて、あなた宛てのコメントも投稿できます。
08データと出典
让 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`)。
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-21。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
