DeepSeek Harness 插件：把手機端 Local Dream 的本地 NPU 生圖接進對話

DeepSeek Harness（DSH）採用插件化架構，將擴展能力通過對話接口暴露給智能體。dsh-localdream 插件旨在解決本地模型推理的接入問題。它把手機端 Local Dream 的本地 NPU 生圖能力接進對話流，支持文生圖、圖生圖、放大與分塊重繪。整個流程只跟本機 loopback 通信，不走雲端，不計費且無內容審查。

安裝與啓用¶

插件運行期零依賴，不需要 npm install，也不會污染宿主環境。

git clone https://github.com/133563825as-ai/dsh-localdream.git ~/dsh-localdream

dsh plugin --profile web add link:~/dsh-localdream

安裝後需要重啓 DSH 才能生效。可以通過以下命令驗證：

dsh --profile web --dump-config | grep -A3 dsh-localdream

核心能力¶

該插件主要提供以下能力：

接入手機端 Local Dream 本地 NPU 生圖：利用手機硬件進行推理。
文生圖：通過自然語言描述生成圖片。
圖生圖：基於輸入圖片進行重繪。
四倍放大：對圖片進行分辨率提升。
分塊重繪：對圖片局部區域進行修改（UltraFix 模式）。
運行期零依賴：不依賴任何外部包。
離線、不計費、無內容審查：所有計算在本地完成。
適配任意模型：無預設畫風，支持 Local Dream 後端支持的任意模型。

前置條件¶

手機端安裝 Local Dream，版本需在 3.0.0-alpha.3 及以上。
必須手動在 App 裏打開受控模式。這是插件工作的前提：
> Local Dream → 模型列表右上角 ⋮ → 設備互聯 → 受控模式區塊 → 「進入受控模式」
插件會使用 Local Dream 暴露的兩個端口：
- 127.0.0.1:8808：控制口（JSON API）
- 127.0.0.1:8081：生成口（native 後端）

工具使用¶

插件提供了六個主要工具，用於控制生圖流程。

1. ld_status¶

用於檢查受控模式狀態、當前模型、後端狀態及已裝模型清單。出圖前建議先運行此命令。

2. ld_draw¶

文生圖或圖生圖的核心命令。

// 文生圖
ld_draw({ prompt: '雨夜少女', aspectRatio: '3:4' })

// 使用模板
ld_draw({ template: '雨夜少女' })

3. ld_enhance¶

處理圖片增強與重繪。

// 四倍放大
ld_enhance({ mode: 'upscale', image: '...' })

// 分塊重繪
ld_enhance({ mode: 'ultrafix', image: '...', prompt: '...' })

4. ld_config¶

查看與修改容器裏的使用偏好、per-model 參數預設。

// 查看當前配置
ld_config({ action: 'show' })

// 設置默認寬高比
ld_config({ action: 'set', key: 'defaultAspectRatio', value: '3:4' })

// 重置某個配置項
ld_config({ action: 'reset', key: '' })

5. ld_prompt¶

管理提示詞模板。

// 保存模板
ld_prompt({ action: 'save', name: '雨夜少女', prompt: '...', aspectRatio: '3:4', steps: 30 })

// 列出所有模板
ld_prompt({ action: 'list' })

配置與限制¶

配置文件位置¶

所有配置與提示詞模板都保存在 <DSH_HOME>/localdream/ 目錄下（通常是 /root/.dsh/localdream/），包含 settings.json、models.json、prompts/ 目錄等。這些都是普通 JSON 文件，可直接編輯。

重要限制¶

不支持 *_turbo 模型：這類模型內存消耗大，容易導致進程崩潰。
UltraFix 支持範圍：僅支持 SD1.5 QNN 與 SDXL QNN 後端。其他後端會報錯。
尺寸換算：width / height 字段無效，真正決定尺寸的是 aspect_ratio。長邊固定爲模型基準尺寸，短邊按比例換算後向 8 的倍數取整。
圖生圖輸入圖尺寸：輸入圖尺寸必須與 aspectRatio 的換算值一致，否則會報錯。

適用場景與注意¶

此插件適合需要本地化、離線生成圖片的場景。由於依賴手機端 Local Dream 的受控模式，使用時需確保手機與電腦在同一網絡環境（或通過 loopback 連接），且手機屏幕保持常亮以防止系統回收後臺進程。