taxue-dsh-artisan：DeepSeek Harness 一體化視覺創作工具鏈

前言¶

DeepSeek Harness (DSH) 插件生態強調模塊化與集成。在視覺創作場景下，往往需要先調用反推插件獲取提示詞，再調用生圖插件生成圖像，流程割裂且成本較高。taxue-dsh-artisan（taxue 畫師）通過整合原生工具鏈，將提示詞反推、審計優化、色卡提取與多供應商生圖能力集於一身，支持工具間的串聯調用。

該插件由 taxueseek 維護，採用 MIT 許可證，旨在爲開發者提供一條從參考圖到生成圖的標準化路徑。

核心功能¶

插件內置四個原生工具，涵蓋從分析到生成的全流程：

• reverse_prompt：本地反推提示詞。不僅輸出描述，還直出可直接生圖的完整提示詞，包含畫幅建議、優化方向與風格引導。支持 6-block 結構化協議轉譯與 9 個量化還原錨點。
• optimize_prompt：本地提示詞審計。對提示詞進行結構審計、風格風險檢測與單變量優化建議。
• extract_palette：本地確定性色卡提取。基於 Oklab 顏色空間 K-Means 算法，對 PNG 參考圖提取主色、輔色、點綴色及暗部/高光錨點色，保證結果確定性。
• generate_image：遠程生圖工具。支持 Google Gemini、OpenAI、字節 Seedream、xAI Grok 及 ChatGPT 訂閱等多種供應商。

工作原理與特性¶

提示詞反推與優化¶

reverse_prompt 摒棄了原 Forge 的任務包模式，採用直出策略。模型讀取圖像後，直接生成可直接粘貼到生圖工具的 prompt 字段，而非需要模型二次執行的元指令。輸出包含：
* prompt：完整提示詞。
* optimization_advice：可執行的優化方向。
* aspect_ratio：根據真實像素換算的畫幅建議（如 9:16）。
* quality_gate / risk_flags：質量門與風險檢測。

插件內置了 9 個視覺還原錨點，包括畫幅錨點、氣質錨點、風格錨點、構圖錨點等，通過量化約束提升生成圖對參考圖的還原度。

Token 優化¶

相比舊版工具鏈，taxue-dsh-artisan 在 Token 使用上有明顯優化：
* 減少注入體：直出提示詞減少了約 44% 的元數據注入體（從 3863 字節降至約 2178 字節）。
* 簡化鏈路：調用鏈路從原來的 8-24 步縮短爲 2-3 步。

確定性色卡提取¶

extract_palette 僅對 8-bit 非隔行 PNG 文件生效。算法使用固定迭代輪數的 K-Means，輸出包含 hex 值、佔比及明度錨點。若需處理 JPEG/WebP，需先用本地命令轉換爲 PNG。

圖控圖支持¶

generate_image 支持參考圖引導。默認情況下，reference_assets 僅用於結果卡片中的對比預覽，不參與生成。顯式設置 use_reference_images: true 後，插件會將參考圖內聯編碼進請求：
* Google Gemini：作爲 input_image 內容塊。
* OpenAI / Seedream / codex：以 data URL 數組走 image 字段。
* Grok：以 data URL 數組走 image_url 字段。

安裝與配置¶

安裝插件¶

在 DSH 環境中執行以下命令安裝插件：

dsh plugin --profile web add taxue-dsh-artisan

安裝完成後，重啓 dsh web，在 設置 → 插件 → taxue 畫師 中配置供應商與 API Key（憑證寫入不回傳前端）。

憑證與供應商配置¶

插件支持以下供應商，配置環境變量：

憑證路由規則：
* Grok 和 codex 優先使用訂閱（Grok 使用 /v1/images/generations，codex 使用 /backend-api/codex），未登錄訂閱時回退到 API Key。
* Grok 不支持 size/quality/style 參數，只支持 aspect_ratio 與 resolution。
* Grok 出圖時效約 5-60 秒，超時可使用後臺運行模式。

保存設置¶

generate_image 支持配置生成圖落盤路徑。
* 在設置中填入絕對路徑，生成圖將保存至該目錄。
* 留空則保存至默認 ~/Downloads/。
* 每張生成圖會附帶一個同名的 .json sidecar 文件，記錄提示詞、模型與時間戳，便於溯源。

使用示例¶

反推與生圖串聯¶

調用 reverse_prompt 獲取完整提示詞後，直接將其作爲參數傳遞給 generate_image：

{
  "tool": "generate_image",
  "arguments": {
    "prompt": "基於上一步獲取的完整提示詞...",
    "provider": "openai",
    "reference_assets": "/path/to/reference.png"
  }
}

開啓圖控圖¶

若需讓生成圖更貼近參考圖，需顯式開啓參考圖內聯：

{
  "tool": "generate_image",
  "arguments": {
    "prompt": "...",
    "provider": "grok",
    "use_reference_images": true,
    "reference_assets": "/path/to/reference.png"
  }
}

確定性色卡提取¶

調用 extract_palette 獲取參考圖的配色方案：

{
  "tool": "extract_palette",
  "arguments": {
    "image_path": "/path/to/image.png"
  }
}

注意事項¶

1. 圖控圖默認關閉：爲了防止誤傳圖片，use_reference_images 默認爲 false，必須顯式設置爲 true 纔會上傳參考圖。
2. 色卡格式限制：extract_palette 僅支持 8-bit 非隔行 PNG。使用 JPEG 或 WebP 需先轉換爲 PNG。
3. 輸出語言：reverse_prompt 和 optimize_prompt 的 output_language 參數支持 zh-CN（默認）、en 和 bilingual。
4. 異步後臺：generate_image 支持 run_in_background 參數，避免因生成時間過長導致超時中斷。

該插件將原本分散的視覺創作工具鏈整合爲單一實體，適合需要在 DeepSeek Harness 中進行高精度圖像還原與風格遷移的開發場景。