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 连接），且手机屏幕保持常亮以防止系统回收后台进程。