# dsh-qwen-paint

> DSH 插件 / DeepSeek Harness：视频 / 生图 / TTS 全能 · 本机运行（QQ 交流群 454707710）。0.32.1 两轮审计加固：ASR 音频路径围栏（只认出图目录内文件）、按包名安装也能执行引导脚本、草图台四事件点按、错误响应消毒收口；视频链清单化 + 生图/TTS 契约对账（改图自动报差异）；生图/视频/混合三模式界面各不同；批量出图带幂等保护（重试不重出）；Qwen3-TTS 语音克隆与可接 ASR 自动字幕；本机实测秒数；会话级模型驻留、显存建议、参数来源表、预设绑定、加载器盘点等本机端点。文生视频 / 图生视频（Wan 2.2 / XT-5B）与图→音→视频混合、导入音频直接合进成片（音轨合成），文生图与 1–16 张参考图编辑、圈选重绘（羽化 / 边缘融合 / 外扩 / 反选 / 重绘强度可调）/ 元素移除 / 四向扩图 / 高清放大，Qwen3-TTS 语音合成（独立 generate_speech，参考音频可复刻音色），模型无关角色参考；草图台手绘参考；生成记录可检索（菜单最上面「历史」，SQLite 索引、软删除不动磁盘文件）。CPU 也能跑：自动识别 AVX2 / AVX512 / AVX512-BF16 指令集并给五档加速（含 --cpu 强制纯 CPU）、按物理核钉线程，任务结束可选自动卸载模型内存；安装入口是常驻的图形化引导面板。对外提供脱敏状态快照与端点目录供外部集成。提供可选、默认关闭的模型自动下载包：视频模型 --video-models、核显档位 --igpu-download、生图主模型 --tier，按服务器权威 size + sha256 双校验；音频权重不自动下载，缺件给明确清单。经本机 ComfyUI 调用，数据仅走 127.0.0.1 回环（联网参考图检索默认拒绝、须逐次同意），无需 API 密钥、零调用费用。Windows / Linux，NVIDIA / Intel Arc / AMD / 核显共享内存，含 8 GB 低内存档位。

本站是 `dsh-qwen-paint` 的静态文档页，供搜索引擎与 AI Agent 抓取。插件本身是运行在用户本机的 DSH bundle（按本地目录安装），**不是 Web 服务**：本站没有 HTTP API、没有 OpenAPI 规范、没有 MCP server，也不收集或转发任何用户数据。因此本站不声明 `ai-plugin.json` / OpenAPI / MCP manifest —— 伪造这些信号会让 Agent 误以为存在可远程调用的服务。

## 是什么

- 面向 DeepSeek Harness (DSH) 的本地**视频 / 生图 / TTS 全能**生成与编辑插件，版本 0.32.1，MIT 许可；三大能力并列主推，不是「只做生图」。
- 经本机 ComfyUI 调用 Qwen-Image 2.1 / 官方 Turbo 模型；结果落盘并在会话界面内直接呈现。
- 工具：`draw_image`（文生图 / 1–16 张参考图编辑）、`inpaint_image`（局部重绘）、`remove_image`（元素移除）、`outpaint_image`（四向扩图）、`upscale_image`（高清放大）、`generate_video`（文生 / 图生视频）、`generate_speech`（独立 Qwen3-TTS 语音合成）、`generate_hybrid`（图→音→视频混合）。
- 平台：Windows / Linux；NVIDIA / Intel Arc / AMD 显卡，以及核显 / 共享显存与 8 GB 低内存档位。
- 兼容：DSH >= 0.2.0-rc.2，Node.js >= 18.0.0。

## 可选模型自动下载包（默认关闭）

- **有视频模型自动下载包**：`node scripts/setup.mjs --video-models`。默认不装、需你显式执行；官方仓库文件清单运行时动态列举、由你选档位；多源轮询 + 断点续传 + 服务器权威 size + sha256 双校验，不合格删除。
- 同类还有 `--igpu-download`（核显档位，默认关闭）与 `--tier full|lite`（生图主模型）。`--check` 永远只读、绝不下载。
- 音频模型权重**不自动下载**：缺件时给明确清单，由你自行放置。

## 怎么安装

- 本包**已发布到 npm**（`dsh-qwen-paint`，当前 `0.32.1`）：`dsh plugin add dsh-qwen-paint` 按包名安装；本地目录形式用于开发调试。
- 命令：`dsh plugin --profile desktop add link:<本插件目录的绝对路径>`
- 使用 `desktop` profile 前需先完全退出 DSH；无构建步骤，`lib/` 即最终运行代码。

## 可选核显型号（0.2.0 追加）

- 安装脚本提供 `--list-igpu`（列出全部型号，零联网零下载）、`--igpu <id>`（指定型号）与 `--igpu-download`（唯一下载开关）三个入口；覆盖 AMD Radeon 780M / 680M / 760M / 660M / 8060S 与 Intel Iris Xe 96EU / UHD / Arc 140V / 140T / B390 共 10 档。
- **自动下载默认关闭**：只有显式加 `--igpu-download` 才下推荐模型；`--check` 永远不下载；下载后按服务器权威 size + sha256 双校验，不合格删除。
- 后端建议：AMD 消费级核显 → DirectML，Intel 核显 → OpenVINO，仅 Ryzen AI Max+ 395 / Radeon 8060S（gfx1151）有 AMD 官方 Windows ROCm 原生支持。插件**不自动更换 PyTorch 后端**。
- ⚠ 型号清单里的出图秒数来自用户清单 / 社区公开的 **SD / SDXL / Z-Image-Turbo 等其它模型**，未经本插件实测、不可与 Qwen-Image 2.1 指标直接比较，也不替换速度门槛；本轮未做任何核显硬件实测。

## CPU 指令集识别与加速档（0.3.0 追加）

- **可选、默认关**：配置项 `cpuAccel` 五档 —— `off`（默认，一个参数都不加）/ `safe`（`--preview-method none` + 线程钉物理核）/ `balanced`（`+ --use-pytorch-cross-attention`）/ `max`（`+ --bf16-unet --bf16-text-enc`，仅当实测有 AVX512-BF16）/ `force-cpu`（`--cpu`，自动摘掉显存参数与 GPU 专属注意力内核，并把 `QwenImage21Cache.device` 改成 `cpu`）。
- **识别口径**：Linux 读 `/proc/cpuinfo` 的 `flags`（本机实测，标 `isaVerified: true`）；Windows / macOS 上 Node 读不到 procfs，退化为型号推断并标注「未实测」；型号也认不出时能力给 `null` 而**不是** `false` —— 「不知道」不等于「不支持」。
- **线程数**走 `OMP_NUM_THREADS` / `MKL_NUM_THREADS` / `OPENBLAS_NUM_THREADS` 环境变量，钉的是**物理**核心数；GGUF 加载器**没有** `n_threads` 输入（`UnetLoaderGGUF.INPUT_TYPES` 只有 `unet_name`）。
- **合并规则**：启动参数按 ComfyUI argparse 的**互斥组**裁决（同组只留最后一个）—— 同时挂两个不是「后者生效」，是进程启动即退出。
- 本机端点：`GET /api/qwen-paint/cpu-profile`（画像 + 五档各自在本机的真实参数）、`POST /api/qwen-paint/cpu-accel`（选档，落 `uiState`）；均仅本机请求，响应不含绝对路径。
- 目标机实测入口：`node scripts/cpu-probe.mjs [--bench] [--dump-config]` —— 纯只读，借 ComfyUI 自带 python 问 PyTorch 的 CPU capability，不装包、不下模型、不重启。

## 生成历史（0.3.1 追加）

- 每次生成（图 / 视频 / 音频）写一条记录到 `<outputDir>/.qwen-paint-history.db`（SQLite，Node 内置 `node:sqlite`，零外部依赖）；**只存相对 `outputDir` 的路径**，不把本机绝对路径写进库。
- 界面入口：菜单最上面「历史 → 生成历史」，支持关键词 / 类型 / 日期筛选、分页、看大图、复制路径。
- 删除是**软删除**（库里 `deleted=1`），**绝不删除用户磁盘上的图片 / 视频 / 音频文件**。
- Agent 工具 `list_generated_images`（`keyword` / `kind` / `date_from` / `date_to` / `limit` / `offset`），纯本地只读、不调用 ComfyUI。
- 本机端点：`GET /api/qwen-paint/history`、`GET /api/qwen-paint/history/stats`、`POST /api/qwen-paint/history/delete`；均仅本机请求，写操作要求 POST + `application/json`。
- **Node 版本口径**：持久化需要 **Node >= 22.5**；更低版本 `available: false` / `persistent: false`，只能读既有记忆日志做内存过滤，界面与工具都会明说「未持久化」。`package.json` 的 `engines` 仍为 `>=18.0.0`（不因这一个可选能力抬高整包门槛）。

## 网络边界

- 出图数据（提示词与图片）只发往本机 `127.0.0.1` / `localhost` / `::1` 的 ComfyUI，由 `lib/net-guard.js` 在代码层强制。
- 无需任何 API 密钥，不产生调用费用。
- 本站为纯静态 HTML：无后端、无表单、无登录、无第三方统计脚本。

## 文档

- [README.md](https://github.com/yanfei0725/dsh-qwen-paint/blob/main/README.md): 完整能力说明、参数与排错
- [INSTALL.md](https://github.com/yanfei0725/dsh-qwen-paint/blob/main/INSTALL.md): 安装步骤与 profile 选择
- [仓库版 llms.txt](https://github.com/yanfei0725/dsh-qwen-paint/blob/main/llms.txt): 给直接读取仓库的 Agent 的概览
- [package.json](https://github.com/yanfei0725/dsh-qwen-paint/blob/main/package.json): 版本、dsh 字段、兼容性与发布文件清单
- [cordis.patch.yml](https://github.com/yanfei0725/dsh-qwen-paint/blob/main/cordis.patch.yml): DSH bundle 补丁
- [LICENSE](https://github.com/yanfei0725/dsh-qwen-paint/blob/main/LICENSE): MIT

## 不提供

- HTTP API、OpenAPI 规范、MCP server、`ai-plugin.json`：本地插件没有可远程调用的网络服务。
- 任何在线生图端点：出图只在本机 ComfyUI 进行。
- **不是「不支持视频」**：文生视频 / 图生视频、独立 TTS 工具、以及视频模型自动下载包（`--video-models`）都随插件提供；本节「不提供」只指**没有可远程调用的在线推理服务**，以及**默认不会替你下载任何权重**。