dsh-generate-image：通過本地 Codex CLI 生成與編輯圖片

DSH 生態強調“一切皆插件”。當智能體需要處理視覺內容時，傳統的做法要麼依賴昂貴的雲端 API，要麼需要複雜的本地部署。dsh-generate-image 插件解決了“讓模型畫圖”這一具體痛點，它複用你本機已登錄的 Codex 環境，把圖像生成能力直接暴露給 DeepSeek 模型。

是什麼¶

• 定位：DeepSeek Harness 插件。
• 維護者：zemul。
• 核心價值：通過本地 OpenAI Codex CLI 實現文生圖與圖生圖，無需額外 API Key 或構建步驟。

核心功能¶

• 文生圖與圖生圖：向 Harness 模型暴露 generate_image 工具。支持 generate_image(prompt) 生成全新圖片，以及 generate_image(prompt, inputImage) 傳入已有圖片路徑進行編輯。
• 零依賴與零構建：純 JS 實現，不依賴任何 npm 包，安裝後無需構建即可直接運行。
• 結果定位：通過目錄快照 diff 定位新生成的圖片，不依賴解析模型輸出文本。
• 安全與認證：支持超時與信號保護，複用 Codex 登錄（OAuth），無需提供 API Key。

安裝與啓用¶

使用 npx 命令安裝（無需本機安裝 dsh CLI，npx 會自動拉取官方 dsh）：

npx -y @deepseek-ai/dsh plugin --profile web add github:zemul/dsh-generate-image

本包沒有任何生命週期腳本，pnpm 不會要求構建授權。若仍提示構建授權，需在 profile 的 pnpm-workspace.yaml 中加入：

allowBuilds:
  dsh-generate-image: true

重啓 GUI 後生效。

典型用法¶

模型在對話中直接調用即可：

• 文生圖：

    generate_image("生成一張賽博朋克風格的城市夜景圖，霓虹燈紫藍配色")

• 圖生圖：

    generate_image("把 ./assets/hero.png 的背景換成漸變星空，保留前景主體", "./assets/hero.png")

工具返回生成圖片的絕對路徑，模型與用戶可直接引用。

適用場景與注意¶

• 前置條件：
  • 需要本地 Codex CLI 登錄（OAuth），使用 Codex 內置 image_gen 工具。
  • 消耗 Codex/ChatGPT 賬號額度（生圖比文本貴）。
  • 需要 Node.js >= 18。
• 文件存儲：
  • 圖片默認存儲在 $CODEX_HOME/generated_images/（默認 ~/.codex）。
  • 插件會拷貝一份到輸出目錄（默認工作目錄）。
• 運行權限：插件以當前 dsh 進程權限運行。安裝前請檢查源碼與許可證（MIT）。

短結尾¶

本插件爲 DSH 插件生態引入了本地視覺能力。它通過 Codex CLI 橋接，解決了模型“畫圖”的需求。更多細節請參考 GitHub 倉庫 或 DSH 目錄頁。