DeepSeek Harness 插件：dsh-codex-media

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。DeepSeek 的多模態模型（如 deepseek-v4-flash-vision-exp）原生支持圖片輸入與理解，能夠直接處理粘貼的圖片。但對於圖片的生成與編輯，通常需要額外的 API 調用或複雜的本地部署。本插件提供了一個解決方案：利用本機已登錄 ChatGPT Plus 的 Codex CLI 來處理圖片的生成與編輯任務。

dsh-codex-media 是一個爲 DeepSeek Harness (DSH) 設計的 Codex 擴展。它通過 MCP (Model Context Protocol) 協議註冊四個工具，讓 DSH 能夠調用本機的 Codex CLI 執行生圖、改圖、剪貼板存盤以及委託獨立任務。插件由 yujianjian1013 維護，遵循 MIT 許可證。

核心功能¶

插件包含以下核心能力：

生圖 (generate_image)：調用 Codex 託管的 image_generation 模型，將生成的圖片輸出到指定路徑。
改圖 (edit_image)：支持帶參考圖重繪。參考圖接受本地路徑、SHA256 附件 ID 或剪貼板輸入。
剪貼板圖片存盤 (clipboard_to_image)：將剪貼板中的圖片保存到本地。在 Windows 上需配合 PowerShell 單線程模式 (pwsh -STA) 使用；非 Windows 平臺該輸入源不可用，其餘功能正常。
Codex 子代理 (codex_task)：將一段獨立的非圖處理任務（如讀寫文件、執行命令）交給本地 Codex 執行，以節省 DeepSeek 的 token 消耗。

安裝與啓用¶

安裝前請確保環境滿足以下依賴：

DeepSeek Harness (DSH) >= 0.1.0-rc.6
Node.js >= 22.19
本機已安裝並登錄 ChatGPT 的 Codex CLI（生圖和改圖功能需要 Plus 訂閱額度）
系統爲 Windows（剪貼板功能需要 PowerShell 單線程模式支持）

安裝命令如下：

dsh plugin --profile web add github:yujianjian1013/dsh-codex-media

安裝完成後，需在 DSH 的 cordis.patch.yml 中添加 MCP 服務器配置，否則工具無法註冊。參考配置如下：

- insert:
    - id: mcp-codexmedia
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: codexmedia
        transport: stdio
        command: node
        args: !!js '(() => { const { createRequire } = process.getBuiltinModule("node:module"); const home = process.env.DSH_HOME || ((process.env.USERPROFILE || "") + "/.dsh"); return [createRequire(home + "/profiles/web/package.json").resolve("dsh-codex-media/mcp/server.mjs")]; })()'

修改配置後，重啓 dsh web 並刷新頁面即可生效。

典型用法¶

識圖：直接使用 DeepSeek 的多模態模型。粘貼圖片後，模型會將其作爲 image block 接收，無需插件介入。
生圖：在對話中直接說“畫一隻……”。模型會識別意圖並調用 generate_image 工具。
改圖：粘貼一張參考圖，然後說“把它改成……”。模型會調用 edit_image 工具進行重繪。
剪貼板存盤：在對話中說“把剪貼板圖片存到 X”。模型會調用 clipboard_to_image 工具保存圖片。
Codex 子代理：對於代碼任務，直接說“請幫我讀取並修改 /path/to/file”。模型會調用 codex_task 工具，由本地 Codex 執行。

注意事項¶

費用：生圖和改圖功能消耗 ChatGPT 訂閱的圖像額度，而非 DeepSeek 的 token。
存儲：生成的圖片默認保存在 ~\.codex\generated_images 目錄下，建議定期清理。
連接穩定性：當 Codex 連接 chatgpt.com 時，如果 WebSocket 偶發重置（錯誤碼 10054），插件會自動降級並嘗試 HTTPS 重試，屬於正常現象。

生態背景¶

DeepSeek Harness 的生態強調「一切皆插件」。本插件通過 GitHub 維護，可在技能中心目錄查看，與 DeepSeek 官方無直接隸屬關係。