前言¶
DeepSeek Harness (DSH) 的核心設計理念之一是“一切皆插件”。在模型推理場景中，開發者常面臨視覺理解與圖片生成的需求。現有的一些視覺插件往往僅提供讀圖能力，缺乏生成與編輯功能。VisionForge 是一款基於開源插件改造的 DSH 插件，它不僅補全了視覺理解的閉環，還增加了圖片生成與編輯的能力，旨在爲 DSH 提供一套輕量、統一的視覺處理方案。
核心功能¶
VisionForge 提供了從視覺理解到圖片生成的全鏈路能力，主要包括：
- 粘貼即讀：在官方視覺模型下，圖片粘貼進輸入框會顯示原生預覽；在純文本模型下，插件會接管粘貼內容，自動轉換爲本地路徑並調用視覺引擎解析。
- 多提供商視覺引擎：支持 Qwen、OpenAI 兼容端點、Anthropic、Gemini、Antigravity、Claude、Kimi 等多種視覺引擎。支持故障轉移鏈，一個密鑰失敗會自動輪換下一個。
- 圖片生成與編輯：提供
visionforge_generate_image用於生成圖片，visionforge_edit_image用於圖片編輯（如換裝、換背景、多圖融合）。 - 圖片放大與下載：生成的圖片在對話中以 90px 縮略圖展示。點擊圖片可使用系統圖片查看器放大原圖；點擊「保存圖片 N」可下載到 D 盤根目錄（無 D 盤則存用戶目錄）。
- 解析優先級：支持「官方優先」（先嚐試官方視覺模型，失敗才走插件）和「插件優先」兩種模式。
- 引擎翻譯器（自定義引擎）：內置引擎之外，無需改代碼即可添加 Google Gemini、Imagen 等任意廠商引擎。
- 畫質與提示詞增強：支持分辨率詞表（4K/2K/1080P），圖生圖時自動追加保護性約束（如保持面部特徵、不加水印）。
- 統一目錄與緩存清理：生成圖緩存、粘貼原圖緩存全部收斂固定目錄。生成圖與粘貼緩存超過 3 天會自動過期清理。
- 本地迴環服務：預覽與下載走本機固定端口，不依賴提供商的臨時 OSS 鏈接。
安裝與配置¶
插件通過 npm 安裝。安裝前請確保已卸載舊版 @liustack/modlens，避免兩套插件同時註冊同名工具。
# 安裝
npx -y @deepseek-ai/dsh plugin --profile desktop add @lr611/visionforge
# 若存在舊版，先移除
npx -y @deepseek-ai/dsh plugin --profile desktop remove @liustack/modlens
安裝完成後，進入 DSH 設置 → 內置插件 → VisionForge 配置 卡片。選擇引擎（如 Qwen），填入 API 密鑰、接口地址、模型，保存後生效。
使用示例¶
- 讀圖：把圖片複製粘貼進輸入框。根據解析優先級設置，插件會自動處理圖片路徑並調用視覺模型解析。
- 生成圖片：在對話中輸入指令，例如“生成一張田間的稻草人”。模型調用
visionforge_generate_image，對話內出現縮略圖，點擊放大或保存。 - 編輯圖片：粘貼 1–3 張圖，輸入指令“把女生的衣服換成白色 JK 裙”。模型調用
visionforge_edit_image，生成帶預覽與下載的編輯結果。
注意事項¶
- 環境要求：DSH Desktop v2.0.17 / DSH harness 0.2.0-rc.2（2026-10 實測）。DSH 大版本更新可能改變插件接口，升級後請重新驗證。
- 版本兼容：插件只與 harness 版本相關，官方桌面端與第三方桌面端只要 harness 版本相同，功能無實質差異，但推薦使用官方 DSH Desktop。
- 歷史版本：歷史版本必須與 harness 版本匹配，例如在 harness 0.2.0-rc.2 上直接安裝舊版本可能因 peerDependencies 不兼容而加載失敗。
