DeepSeek Harness（DSH）採用插件化架構，爲智能體開發提供了擴展能力。當智能體需要處理圖像或操作本地桌面時，直接集成原生圖形界面工具通常較爲繁瑣。dsh-photocraft 是一個社區插件，通過 MCP 協議將 PhotoCraft 的圖像編輯能力與桌面自動化功能橋接到 DSH，使智能體能夠執行圖片編輯、圖層管理、調色、添加文字形狀、運行濾鏡以及操作原生桌面畫布和截圖。
這是一個獨立社區集成項目，非 PhotoCraft 或 DeepSeek 官方插件。該插件本身不包含編輯器二進制文件，也不包含生成式 AI 模型，而是通過腳本安裝並鏈接官方 PhotoCraft 運行時。
安裝與啓用¶
安裝前需確認環境滿足要求：DSH 版本需兼容 ^0.2.0-rc.2，PowerShell 版本必須爲 PowerShell 7（pwsh），且系統需有可用的桌面會話。
1. 安裝插件包¶
在 PowerShell 7 中執行以下命令添加插件：
dsh plugin --profile web add github:DASHAN-0079/dsh-photocraft#v0.2.0
2. 安裝原生 PhotoCraft 運行時¶
插件依賴本地安裝的 PhotoCraft。執行插件包內的安裝腳本：
$dshRoot = if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path ([Environment]::GetFolderPath('UserProfile')) '.dsh' }
& "$dshRoot/profiles/web/node_modules/dsh-photocraft/scripts/Install-PhotoCraft.ps1"
腳本會根據系統自動下載並校驗 SHA-256 後安裝 PhotoCraft 到指定目錄。安裝完成後需重啓 DSH 並創建新會話。注意：Linux、Windows ARM64 和無桌面會話的服務器不在支持範圍。
3. 配置環境變量¶
若需自定義安裝路徑或控制端口，需在啓動 DSH 前設置以下環境變量：
PHOTOCRAFT_DSH_HOME：默認爲%LOCALAPPDATA%\dsh-photocraft（Windows）或~/Library/Application Support/dsh-photocraft（macOS）。安裝器與插件必須使用同一路徑。PHOTOCRAFT_DSH_PWSH：指定 PowerShell 7 可執行文件路徑，默認爲pwsh。PHOTOCRAFT_DSH_PORT：指定桌面本機控制端口，默認爲17878。
使用方法¶
工作區路徑¶
所有輸入圖片和輸出文件應存放在工作區目錄中：
* Windows: %LOCALAPPDATA%\dsh-photocraft\workspace
* macOS: ~/Library/Application Support/dsh-photocraft/workspace
插件中的相對路徑均基於此目錄。
工具分類¶
該插件提供兩套工具集，分別對應無界面操作和桌面交互：
mcp__photocraft__*: 用於無界面編輯、保存、批處理、預覽、切換和關閉文檔。mcp__photocraft_ui__*: 用於桌面編輯、界面檢查、畫筆鼠標事件、菜單操作和截圖。
兩個後端擁有獨立文檔會話。要在無界面端打開文檔，需先在桌面端保存並關閉，再由無界面端打開。斷開 MCP 連接不會關閉桌面窗口。
典型示例¶
示例 1：創建宣傳圖
智能體可使用以下指令：
使用 PhotoCraft 創建一張 1200×800 的宣傳圖，背景深藍，白色標題“週末攝影展”，加入黃色圓形裝飾。生成預覽，保存 poster.pcraft 和 poster.png。
示例 2：調整圖片參數
用 PhotoCraft 打開 workspace 中的 input.jpg，提高亮度和對比度，縮放到寬度 1600 像素，保持比例，導出 output.jpg，不覆蓋原圖。
適用場景與注意¶
適用場景：
* DSH 智能體需要處理圖片文件（如生成宣傳圖、調整截圖質量）。
* 需要利用 PhotoCraft 的圖層、濾鏡和文本排版功能。
* 需要控制桌面環境進行截圖或簡單的鼠標交互。
注意事項：
* 系統限制：本版僅支持 Windows x64 和 macOS Intel / Apple Silicon。不支持 Linux、Windows ARM64 以及無桌面會話的服務器環境。
* 安全渲染：默認使用 --safe-gpu 模式，在 CPU 上渲染，以確保兼容性和穩定性。
* 權限要求：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
* 版本依賴：依賴 PowerShell 7，不支持 Windows PowerShell 5.1。
