返回目錄

dsh-psd-batch-studio

精選清單收錄維護狀態: 活躍

vinkwork/dsh-psd-batch-studio

由 Genca(縉嘉集團,上海縉嘉科技有限公司)VinkWork 團隊開源的 DSH 外掛:PSD 主圖模板批次套 SKU、畫布微調、整批匯出。VinkWork 核心產品:VinkClaw.com。

前往 GitHub專案首頁
$ git clone https://github.com/vinkwork/dsh-psd-batch-studio.git

16

星數

1

Fork

JavaScript

語言

NOASSERTION

授權條款

2026-11-05

建立於

2026-11-16

最近推送

帶側邊欄工作台與兩個 agent 工具的外掛:把 SKU 去背圖套進 PSD 主圖範本,並在本機整批匯出 JPG/PNG(可選 ZIP)。

DSH 整合

原生執行環境

作者聲明

安全稽核

未稽核

最後核實

2026-11-15

授權條款

NOASSERTION

01它能幫你完成什麼?

  • 用一套 PSD 主圖範本加一個資料夾的 SKU 去背圖,批次產出整套商品主圖

    每個 SKU 一張 JPG/PNG,依範本原始解析度輸出,可另行打包成 ZIP

    已有 PSD 主圖範本、需要批次產出變體的電商設計與營運團隊

  • 讓 agent 在 Host 端無人值守跑完整個 SKU 目錄

    成品 JPG/PNG(可選 ZIP)寫入工作階段工作區,並回傳輸出目錄與前 50 個檔名

    需要夜間批次出圖或串接商品資料庫的營運與自動化團隊

  • 把批次出圖從設計端交接給營運,不必排隊等設計

    營運、代營運或店長用設計師交付的 PSD 與槽位規則自行批次出圖

    從設計團隊接收範本的電商營運、代營運與店長

02如何將外掛接入 DeepSeek Harness?

先決條件

  • DeepSeek Harness(含外掛管理器),dsh `0.2.0-rc.2` 以上(`dsh.engines.dsh >= 0.2.0-rc.2`)
  • Node.js 20+(建置與 Host 端 agent 工具需要)
  • 安裝時要能連上 npm registry:agent 工具相依於 `@napi-rs/canvas` 的平台預編譯套件
  • 不需要安裝 Photoshop

安裝步驟

  1. 01

    在外掛管理器執行 `plugin_manager install_bundle, target = dsh-psd-batch-studio`(README 建議從 npm 安裝;固定版本用 `dsh-psd-batch-studio@0.2.6`)

  2. 02

    或從 GitHub 安裝:`plugin_manager install_bundle, target = github:vinkwork/dsh-psd-batch-studio`——pnpm 會把相依鎖定在安裝當下的 commit,儲存庫更新後要重新安裝才生效

  3. 03

    外掛管理器不支援 GitHub spec 時:`git clone https://github.com/vinkwork/dsh-psd-batch-studio.git`、在複製下來的目錄執行 `npm install`,再執行 `plugin_manager install_bundle, target = /絕對路徑/dsh-psd-batch-studio`

    $ git clone https://github.com/vinkwork/dsh-psd-batch-studio.git

  4. 04

    安裝後重新整理 Harness 頁面

  5. 05

    `client.js` / `server.js` 已隨儲存庫提交,安裝不需要先建置;改過原始碼再執行 `npm run build`

    $ npm run build

驗證整合成功

  • 側邊欄出現批次替換主圖的圖示
  • agent 端出現 `psd_inspect` 與 `psd_batch_render` 兩個工具
  • 從側邊欄開啟工作台、載入 `.psd` / `.psb` 後,左側出現圖層樹,自動辨識的商品槽位以虛線框標出

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

原生 DSH 外掛套件,透過外掛管理器的 `plugin_manager install_bundle` 安裝 —— 側邊欄工作台頁面,加上兩個 Host 端 agent 工具 `psd_inspect` 與 `psd_batch_render`

  • `.psd` / `.psb` 範本工作台

    一個 PSD/PSB 主圖範本→可逐層開關可見性的圖層樹,以及在互動畫布上即時預覽的合成結果

  • 商品槽位辨識與商品群組

    圖層樹,以及面積、位置、長寬比與命名規則→自動建議的商品槽位,也可手動標記或取消

    同一商品的「原層 + 陰影/高光副本」會組成一個商品群組,一起隱藏,商品只畫一次
  • 批次適配與畫布微調

    多張 PNG / JPG / WebP SKU 去背圖→完整放入、依高度、依寬度、填滿裁切四種適配方式,加上對齊與佔比,以及每個 SKU 的位移、縮放與角度

    目前的微調可一鍵同步到全部 SKU
  • 整批匯出

    已適配的商品槽位與已匯入的 SKU 佇列→每個 SKU 一張 JPG 或 PNG,依範本原始解析度輸出,可另行打包 ZIP

  • agent 工具 `psd_inspect` / `psd_batch_render`

    範本路徑、SKU 目錄、輸出目錄、格式 / 適配 / 對齊方式,以及逐 SKU 的調整參數→`psd_inspect` 回傳範本尺寸、圖層樹(名稱/階層/可見性/邊界/圖層 id)、自動辨識的槽位與文字層樣式;`psd_batch_render` 回傳成品檔案與 `suppressed` 清單

    兩個工具的路徑都相對於目前工作階段的工作目錄解析,並拒絕越界路徑`psd_batch_render` 預設 JPG、品質 92,回傳輸出目錄和前 50 個檔名

04適合誰?何時不該用?

適合

  • 已有 PSD 主圖範本、需要批次產出變體的電商設計與營運團隊
  • 需要夜間批次出圖或串接商品資料庫的營運與自動化團隊
  • 從設計團隊接收範本的電商營運、代營運與店長

不適合

  • 授權條款為附帶額外條件的修改版 Apache License 2.0:允許商業使用,包含企業內部使用、作為其他應用程式的後端或企業應用開發平台;但營運多租戶服務,或移除、修改前端著作權資訊、專案名稱與 Genca/VinkWork 署名,需要上海縉嘉科技有限公司(Genca)的書面商業授權。v0.1.2 及更早版本仍依 PolyForm Noncommercial 1.0.0 發布。
  • 0.2.5 不可用:README 說明該版本的 agent 工具在所有 dsh 版本上都註冊不起來(#7),裝完看不到 `psd_inspect` / `psd_batch_render` 時先確認版本,從 npm 安裝請鎖定 0.2.6。同一個 profile 也不要同時掛兩份本外掛,它們共用同一個 `psd-batch-studio` 項目。
  • 文字層使用 PSD 裡的點陣像素,暫不支援在工具裡改文案、字型;斜角和浮雕、內陰影為近似或跳過,描邊、投影、光暈為近似。一次處理一個範本(換範本時 SKU 佇列會保留),幾百 MB 的 PSB 需要幾百 MB 記憶體;Host 工具相依於 `@napi-rs/canvas`,某個平台載入不了原生套件時頁面工作台仍可用,agent 工具不可用。

05相容性、維護與安全提醒

  • 授權條款為附帶額外條件的修改版 Apache License 2.0:允許商業使用,包含企業內部使用、作為其他應用程式的後端或企業應用開發平台;但營運多租戶服務,或移除、修改前端著作權資訊、專案名稱與 Genca/VinkWork 署名,需要上海縉嘉科技有限公司(Genca)的書面商業授權。v0.1.2 及更早版本仍依 PolyForm Noncommercial 1.0.0 發布。
  • 0.2.5 不可用:README 說明該版本的 agent 工具在所有 dsh 版本上都註冊不起來(#7),裝完看不到 `psd_inspect` / `psd_batch_render` 時先確認版本,從 npm 安裝請鎖定 0.2.6。同一個 profile 也不要同時掛兩份本外掛,它們共用同一個 `psd-batch-studio` 項目。
  • 文字層使用 PSD 裡的點陣像素,暫不支援在工具裡改文案、字型;斜角和浮雕、內陰影為近似或跳過,描邊、投影、光暈為近似。一次處理一個範本(換範本時 SKU 佇列會保留),幾百 MB 的 PSB 需要幾百 MB 記憶體;Host 工具相依於 `@napi-rs/canvas`,某個平台載入不了原生套件時頁面工作台仍可用,agent 工具不可用。
2026-11-052026-11-13v0.2.5

NOASSERTION · 最新發布 v0.2.5(2026-11-06),README 標註該版本不可用、npm 安裝目標為 0.2.6 · 最後推送 2026-11-13

06常見問題

怎麼在 DeepSeek Harness 裡安裝 DSH PSD Batch Studio?

在外掛管理器執行 `plugin_manager install_bundle, target = dsh-psd-batch-studio`(README 建議從 npm 安裝,固定版本用 `dsh-psd-batch-studio@0.2.6`);也可以改成 `target = github:vinkwork/dsh-psd-batch-studio`,或複製儲存庫後 `npm install` 再用本機絕對路徑安裝。裝完請重新整理 Harness 頁面:側邊欄出現批次替換主圖的圖示,agent 端出現兩個工具。

外掛裝好了,但 agent 裡沒有 `psd_inspect` / `psd_batch_render`,該怎麼排查?

先確認版本不是 0.2.5——該版本的工具 schema 不符合 dsh 的要求,在所有 dsh 版本上都註冊不起來(#7),請升級。同時確認同一個 profile 沒有掛兩份本外掛(例如舊的本機安裝加 GitHub 版),它們共用同一個 `psd-batch-studio` 項目。

安裝時出現 `ERR_PNPM_UNEXPECTED_STORE`,是外掛的問題嗎?

不是,這是本機環境問題:profile 的 `node_modules` 曾用另一個大版本的 pnpm 安裝過(例如終端機裡的 pnpm 10,而 Harness 桌面版用內建的 pnpm 11),兩者的 store 不能混用。把 `~/.dsh/profiles/<profile>/node_modules` 移開備份,再在 Harness 裡重新安裝即可,之後不要用終端機裡的 pnpm 往 profile 目錄裝東西。

PSD 範本和 SKU 素材會上傳到網路上嗎?

不會。PSD 解析與合成都在本機完成(頁面內或 Host 程序),README 說明沒有網路請求、沒有埋點、不上傳素材;唯一需要連線的是安裝時存取 npm registry,因為 agent 工具相依於 `@napi-rs/canvas` 的平台預編譯套件。

一次批次會產出什麼,還需要安裝 Photoshop 嗎?

不需要 Photoshop。一次執行會依範本原始解析度替每個 SKU 輸出一張 JPG 或 PNG,可打包 ZIP;`psd_batch_render` 預設 JPG、品質 92,回傳輸出目錄和前 50 個檔名。文字層使用 PSD 裡的點陣像素,工具裡改不了文案和字型;一次也只處理一個範本,換範本時 SKU 佇列會保留。

08資料與來源

  • 作者聲明github.combedc613d9dd4…

    一个 [DeepSeek Harness](https://github.com/deepseek-ai) 插件,用来批量生产电商商品主图:

  • 作者聲明github.combedc613d9dd4…

    - DeepSeek Harness(带插件管理器),dsh `0.2.0-rc.2` 及以上(`dsh.engines.dsh >= 0.2.0-rc.2`)。

  • 作者聲明github.combedc613d9dd4…

    安装后刷新 Harness 页面:侧边栏出现「主图批量替换」图标,agent 侧出现两个工具。

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-15。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。