dsh-sd-bridge-guard

node verify-integrity.mjs              # 本机 vs 随包清单，终端彩色表格
node verify-integrity.mjs --remote     # 再比对仓库最新版（列出新增/更新/移除）
node verify-integrity.mjs --md         # Markdown 表格（贴 issue / 回复用）
node verify-integrity.mjs --json       # 机器可读

• 新设置 vlmReview（默认 true）：C 档是否启用视觉模型审核。设为 false → 生成的命令带 -NoVlmReview → 不探活、不冷启动、不加载模型、不打分（连参考图「画风=一致」的识别也不调模型），直接按迭代次数出满 N 张弹多选让你自己挑。适合「不想让本机模型介入审核」的场景。
• 新设置 vlmModel（默认 qwen3.6-fable）：审核用哪个模型，会写成 -VlmModel "<模型名>" 传给脚本。⚠️ 本机现在的模型是 qwen3-vl:8b / qwen3.5:latest / qwen2.5-coder:7b / qwen2.5-abliterate:14b，没有 qwen3.6-fable，Ollama 官方库里也查不到这个名字（registry.ollama.ai/v2/library/qwen3.6-fable 返回 404）——要么 ollama create qwen3.6-fable -f Modelfile 自建/导入，要么把插件页这一项改成已有的视觉模型；脚本在「指定模型不在本机」时会打印「本机枚举到哪些 + 怎么拉/怎么建」并回退到第一个 vl/vision 模型，不阻断出图。
• 审核范围扩到整条肢体：问句从「脸 + 手」变成三类——① 脸部（对称/无多余/五官错位/畸形融化）② 手部（五指齐全/多指少指/扭曲粘连）③ 肢体（手臂与腿是否各两条、左右对称、多肢少肢、关节反向错位、四肢畸形粘连、躯干与四肢比例失衡）。
• 详情见 CHANGELOG.md。

版本更新内容（v0.9.19 · 2026-10-15）

插件页多一个开关：自动抠图要不要跑，你自己选。

• 新设置 maskAutoSegment（默认 true）：C 档是否允许自动抠图（YOLO-World + SAM 现算蒙版）。

• 修掉截图里那个「抠图脚本没有输出」：真机复现了——cuda 下检测模型会把 python 进程直接崩掉

• 抠图失败不再让表单空着：以前只留一句「蒙版栏保持可编辑，请你填 box:/路径/区域名」（用户不知道填什么）；

• 详情见 CHANGELOG.md。

版本更新内容（v0.9.18 · 2026-10-15）

本地视觉模型可以彻底关掉：插件设置 vlmAutoStart。

• 设为 false 时，sd_inject 生成的 C 档命令会在末尾追加 -NoVlmStart：视觉模型服务没起就跳过质检（出满 N 张让你自己挑），绝不偷偷在你机器上拉起 ollama serve。默认 true（= 没起就冷启动，见 v0.9.17）。
• 两种关法：① 插件设置 vlmAutoStart: false（写进 profile 的 cordis.patch.yml，需重启 dsh 生效）；② 单条命令上带 -NoVlmStart（立即生效，只影响这一次）。
• 已经关掉本地服务时，行为与「视觉模型本来就不可用」完全一致：照常出图，只是没有脸/手自动打分。

版本更新内容（v0.9.17 · 2026-10-15）

本地视觉模型自动冷启动；C 档跑完产物目录只留成品。

• 视觉模型冷启动：脸/手质检与「画风=一致」的参考图识别都靠本机 Ollama 上的 qwen3-vl:8b。以前它没起就静默降级（素体只出一张、最终出图变成「出满 N 张让你自己挑」）——你看到的就是「插件没质检」。现在：没起就自动 ollama serve 并轮询到就绪（默认 60s，-VlmStartTimeout 可调；-NoVlmStart 关掉），失败只降级不阻断。本机实测：Ollama 停着 → 冷启动 7.9 秒就绪 → 枚举到 qwen3-vl:8b。
• 显存提醒：8G 卡上 SD 常驻时 8B 视觉模型装不进显存（会走 CPU / 部分卸载），这时会明确告诉你「本次质检会明显变慢」，而不是让你以为卡死。
• 跑完只留成品：premask-*.png、它的 _overlay.png、命中率总览图这类中间图，以前会堆在产物目录里；现在跑完自动清理（逐个打印「已清理中间图: xxx」），命中率总览图默认写进迭代临时目录随目录一起清。要留图排查加 -KeepWorkFiles，会把清单列给你。
• 详情见 CHANGELOG.md。

版本更新内容（v0.9.16 · 2026-10-15）

抠图不再被显存打挂；衣服蒙版不再只留一块；新增「蒙版命中率体检」——蒙版准不准不用再靠人眼猜。

• SAM 显存自适应 + 兜底：同一个参考图、同一条命令，22:10 抠得出、23:16 直接 CUDA out of memory（A1111 常驻，ViT-L 要更多显存）→ 旧代码报 ok:false，你看到的就是「蒙版没生效」，而且时好时坏。现在：剩余显存 ≥4.5G 才全分辨率上 cuda、3.0–4.5G 降到 640px、<3.0G 直接走 CPU；SAM 万一还是挂，用检测框生成粗蒙版（与人物剪影相交、必要时裁到躯干带）兜底，不再整条失败。
• 衣服连通块合并：旧逻辑「只留最大连通块」，同一件衣服被 SAM 拆开时会丢掉袖子/裙摆那一侧；现在按「≥ 最大块 18% 且总覆盖 ≤32%」保留同件的多块。
• 新增 sd-mask-qa.py 蒙版命中率体检：拿「参考图 / 本次蒙版 / 本次成品」逐像素判 命中 / 命中未改 / 外溢 / 正确保留，外加「疑似漏掉衣料」标记，输出数字 + 一张总览图（绿=已改 / 黄=未改 / 红=外溢 / 品红=疑似漏检）。C-1b 出图后自动跑，产品旁边落一张 qa-<成品名>.png。
• 想测蒙版，用中性提示词就够（例如「把衣服换成红色长裙」）：蒙版外的残留衣料就是漏检。用「脱衣」类提示词反而自带陷阱 —— 模型会主动画「半脱的衣服」，那看着像漏检，其实那块像素已经改过（实测数字：蒙版内已改 72.9%、蒙版外被改仅 0.03%）。
• 详情见 CHANGELOG.md。

版本更新内容（v0.9.15 · 2026-10-15）

修 C 档蒙版不完善：四周（背景）这条路径整条是死的（换背景/自动判成换背景时，拿不到蒙版 → 原图等于白给）。

• 根因（真跑确认）：New-RegionMask 里 $rects 从未初始化 —— $rects += @{...} 从 $null 起步拿到的是 Hashtable 不是数组，环形要加第 4 块矩形时直接抛 Item has already been added. Key in dictionary: 'Y'；异常打断整句 → 蒙版为空 → 落到 C-1a。单矩形形状（上半/下半/中间/box）只是碰巧还能用，所以之前的「像素校验」全绿、坑一直藏着。
• 修：函数开头补 $rects = @()，删掉 $rects = $rects 空操作。
• 区域蒙版改按「参考图的最终出图尺寸」生成：以前按表单比例/画质画蒙版、出图尺寸再被参考图覆写、蒙版再被缩放一次 —— 传 boxpx:x,y,w,h（像素）时区域整个错位。现在 C-1a / C-1b 共用 Get-RefOutputSize，蒙版在画之前就把尺寸定好；只有「你自己带的蒙版图」才走缩放对齐。
• 补真跑回归：新 test-region-mask.ps1 用 AST 抽出真函数、逐种蒙版量白像素（四周（背景） 修复前抛异常、修复后 51.3%），smoke-skill.mjs 会 spawn 它 —— 以前这个函数只有源码正则，一行都没真跑过，这就是它能一路发版的原因。
• 详情见 CHANGELOG.md。

版本更新内容（v0.9.14 · 2026-10-15）

修「图生图和原图完全没关系」（三条根因一起修，并且用数字证明底图真的在生效）：

• 底图不再被偷偷换掉：以前图生图时「底图」留空，脚本会静默抓「输出目录最新一张」——常抓到无关文件（截图、别的产物）。现在没底图就停下来报错，并告诉你三种填法；只有你显式填「最近」才用最新一张。
• 附件引用也能当底图：图片 sha256:…、xxx.png [8a34ca32]、带说明文字的无后缀路径，都会被正确解析（脚本会去输出目录、ref、DSH 附件目录里按哈希找图）。
• 图生图尺寸跟参考图走：不再拿表单的 9:16 / 480p 去压参考图（1024×1024 被压成 480×853 会重新构图）；一致 模式下 denoising 过高也会被收敛（高于 0.65 会把原图洗掉，要大改请用「替换 + 蒙版」）。
• 蒙版支持精确坐标框：mask 除了区域名，还可以传 box:x,y,w,h（0-1 归一化）或 boxpx:x,y,w,h（像素）；蒙版尺寸与出图尺寸不一致时自动缩放对齐，不再错位。
• 实测数字：同 seed 同提示词，img2img 距参考图 11.05/255，txt2img 对照 52.7/255 —— 底图在起作用；蒙版重绘时未蒙版区（脸/头发/背景）平均差 0.00。
• 详情见 CHANGELOG.md。

版本更新内容（v0.9.13 · 2026-10-15）

任务类型改由对话判断，并直接替你选好蒙版；文生图时「底图 / 蒙版」两项锁定。

• 对话层：你只要说「用SD插件绘制一个银发少女」——对话判定为文生图（C-0），表单里的底图与蒙版会直接锁定（灰掉、不可编辑，提示写明「文生图：不需要底图/蒙版，已锁定」），省得误填。
• 你说「把这张图的衣服换成红色连衣裙」并给一张图 —— 对话判定为图生图（C-1），并把底图与蒙版区域一起提交（换衣服 → 下半（衣服）；换脸 → 上半（脸）；换背景 → 四周（背景）），表单里这两项已按对话的结论预填，你仍可手改；模式切回文生图再切回来，蒙版值不会丢。
• 只改画风 / 整体贴近参考图（不替换）→ 对话不提交蒙版，走 C-1a 整图 img2img（denoising 0.4-0.5 保画风）。
• 底层：sd_inject 工具新增 task / refImage / mask 三个参数，会写进生成的命令与启动器参数（-Mode / -InitImage / -MaskSpec），复制命令出去也照样带。
• ⚠️ 工具的参数定义是 dsh 启动时载入的：这一版新增的参数要重启 dsh 才能在会话里生效（脚本侧已全部就绪）。
• 详情见 CHANGELOG.md。

版本更新内容（v0.9.12 · 2026-10-15）

C 档从「填一堆参数抽奖」变成有决策树的出图流程——专门解决「换个衣服结果连画风都变了」：

| 你想干的事 | 表单怎么填 | 脚本走哪条路 | | --- | --- | --- | | 纯文字出图 | 模式 = 文生图 | C-0：忽略底图与蒙版，用完整提示词直出 | | 拿参考图改，画风要保持 | 模式 = 图生图、底图 = 参考图（或填「最近」= 输出目录最新一张）、画风 = 一致（自动检测参考图）、模型 = 一致（照参考图） | C-1a：从参考图自动检测画风/主体/模型（PNG 元数据 → 本地视觉模型 → A1111 反推）并写进提示词，denoising 0.4-0.5 贴底图 | | 换衣服 / 换脸 / 换背景 | 模式 = 图生图 + 蒙版 = 下半（衣服）（脸 / 四周（背景）/ 反选…）；或蒙版留「无」但在提示词里写「把衣服换成…」→ 自动选区域 | C-1b 蒙版重绘：只重画蒙版区，未蒙版区域像素级原样保留（实测差异 0.00）→ 画风/背景不会跟着变 |

• 新增表单开关：模式（文生图 / 图生图）、蒙版（无 / 上半脸 / 下半衣服 / 中间 / 四周背景 / 反选，或直接填蒙版图路径）；画风与模型各加了 「一致」 档。
• 自动检测的优先级：参考图自带 A1111 元数据（模型 + 原提示词/负向词，一致性最强）→ 本地视觉模型判画风 → A1111 反推标签（动漫图走 deepdanbooru、照片走 clip）。
• 「一致」不是嘴上说：换衣服时脚本会把参考图里衣服类标签剥掉（dress/skirt/kimono…）再合并，其余（画风、脸、头发、背景）全部保留。
• 图生图没填底图会自动用输出目录最新一张；实在没有会用红字告诉你原因，不会偷偷改成文生图。
• 蒙版重绘默认 fill=0 填充（实测 fill=2「潜空间噪声」会在蒙版区留满噪点）、按参考图原生尺寸出图。
• 详情见 CHANGELOG.md。

版本更新内容（v0.9.11 · 2026-10-15）

修「选了二次元，画出来却不是二次元」—— 表单里的画风档位以前有的没词、有的不切模型：

• 「二次元」这一档以前完全没有映射（Get-StylePrompt 里没有它的分支），它又是默认档 → 选了等于没选；现在补上正统二次元词（线稿 + 赛璐璐平涂 + 动漫眼，负向压 3D/照片感），另补「国风 / 赛博朋克」和「厚涂 / 水彩 / 像素风」的正向词，12 个档位全部有映射。
• 「二次元」现在会强制切回动漫底：画风切模型是持久的（用过「写实」→ 停在 majicMIX、用过「彩色哥特」→ 停在 SemiRealMix），旧规则不会切回来 —— 这就是「二次元画不出来」的真正原因。现在选二次元会自动切到 AWPainting（本机动漫默认；找不到就依次找 anything / ReVAnimated / dark sushi）。
• 模型下拉首项直接显示真实当前模型：（当前模型：SemiRealMix.safetensors…），一眼看出「看着二次元、其实还在写实底上」。
• 默认档位也会注入画风词了（以前不动下拉就没词）；反复切画风不再堆逗号（以前连切几次会出现 hair,,, anime style）。
• 实拍对比（同 seed 同提示词）：修复后是干净线稿赛璐璐的二次元脸，故障时是半写实/3D 娃娃脸 —— 见 SD-Picture\anime-after-fix_001.png 与 anime-before-fix_001.png。
• 详情见 CHANGELOG.md。

版本更新内容（v0.9.10 · 2026-10-15）

修外部用户报的 「SD 出了图，但工作区里一张成品都没有」：

• 根因：迭代中间图写在系统 temp，而 DSH 的 workspace-write 沙箱 ACL 只允许写会话工作区；插件又是用 cmd start 拉起独立窗口跑的（不经过会给 TMP/TEMP 改道的受限子进程）→ GetTempPath() 落在不可写目录 → 出图落盘被拒 → 脚本判到失败就 exit 1，而把成品复制进 -OutDir 的那几行全在迭代之后，于是工作区永远是空的。
• 修法一（脚本）：迭代目录改为工作区优先 + 逐级兜底——-IterDir（新参数）→ \.sd-inject-iter → 脚本目录 → 系统 temp；每一级都用真实探针写入验证（只看「存在」会把被 ACL 拒写的目录误判成可用）；全不可写就明确报错并列出试过哪些路径。-OutDir 也提前探活，不可写立刻说清原因，不让你等十几分钟。
• 修法二（插件）：拉起的窗口里先把 TMP/TEMP/TMPDIR 指到工作区的 .dsh-tmp，并在 C 档命令里显式带上 -IterDir "<工作区>\.sd-inject-iter" —— 从源头保证中间产物落在可写位置。
• 附带加固：清理残留目录时对不存在/不可写的候选先判存在再扫（-ErrorActionPreference='Stop' 下不再中断流程）；系统 temp 取不到时用 TEMP/TMP/USERPROFILE 兜底（个别受限宿主里 GetTempPath() 可能返回空）。
• 真机验收：启动器实跑确认 TEMP 被钉到 <工作区>\.dsh-tmp；抽 shipped 真代码跑「不可写候选 → 跳过并回落工作区」；真出图落进 <工作区>\.sd-inject-iter\iter-*\（img2img (denoising=0.5)）；负例早失败；双 Parser + npm test 全绿。
• 详情见 CHANGELOG.md。

版本更新内容（v0.9.9 · 2026-10-15）

C 档图生图现在真的能用（0.9.8 只解开了 Denoising 的锁，底图来源还是个坑）：

• 问题：填了 Denoising 也出不了图生图 —— 老的素体阶段在「本地视觉模型不可用」（Ollama 没开）或「枚举不到 vl 模型」时一张图都不出，而图生图的底图只认素体产物 → 静默降级成文生图。
• 修复一：素体阶段不再空手。质检不可用时改为「照常出一张素体底图，只是不跑脸/手质检迭代」，底图随时可供图生图使用。
• 修复二：表单新增「底图：」栏（可留空，旁边有「浏览…」选图）：

• 修复三：只要拿得到底图 + Denoising > 0 就一定走图生图；填了底图但忘填 Denoising 时按图生图默认 0.55 兜底；-NoIterate 且没填底图会明确提示原因。
• 真机验收：素体阶段在无质检环境下照样产出底图，图生图阶段日志出现 模式: img2img (denoising=0.5)；表单新增行不挤压原有布局。
• 详情见 CHANGELOG.md。

版本更新内容（v0.9.8 · 2026-10-15）

本次是修 bug版本，只动 C 档参数表单里那个「看得到、改不了」的 Denoising：

• 问题：C 档 sd-inject.ps1 参数表的 Denoising 一栏永远是灰的（禁用），既下拉不动也手填不了；就算填了也不生效。
• 根因（三段全废）：① 表单在素体自检迭代之前弹出，那时 -HasBaseImage 传参恒为 $false，旧代码据此把控件 Enabled = $false → 每次都灰；② 解析段在同一条件下直接 $den = 0；③ 最终出图硬编码 -InitImage "" -Denoising 0。
• 修复后怎么用：表单里 Denoising 恒可编辑（下拉或手填 0-0.95）：

• 详情见 CHANGELOG.md。

版本更新内容（v0.9.7 · 2026-10-15）

本次是「整理打包」版本，重点是让用户一句话就能改参数重出图，并把本机全部权重资源整理成可复现清单：

• 新增「C 档选项表」（A 档出图后自动罗列；2026-10-16 起不含画风，画风由 C 档表单档位写进正向提示词）：sd_txt2img / sd_img2img / sd_inpaint 三个出图工具都新增返回字段 quickOptions——一张 Markdown 表，把 C 档参数表单里的 画风 / 模型 / LoRA / 比例 / 画质 / 迭代 / Denoising 全量可选项一次列全。A 档每次出图后，这张表会自动贴到图片下方，用户直接回一句「4 号画风 + majicMIX + 3:4 + 1024p，再来一张」即可快速重出图，不用自己回忆参数名。
• 用户自调画风进入 C 档画风选项（sd-inject.ps1 参数表单）：

• 触发话术写进技能与本文档：新对话第一句说「打开SD插件」、出图要求前加「用SD插件绘制」，能明显提高插件与生图工具被命中的成功率（详见下节）。
• 新增 docs/models-loras.md：本机全部 checkpoint / VAE / LoRA / 嵌入的清单，每条都带 HF 镜像直链（hf-mirror.com）+ sha256，另附国内自调 LoRA 的来源站点与落盘位置。
• 新增实拍图：C 档参数表单截图 + 5 张本次随机测试实出图（见下「效果图」）。
• 测试：npm test 全绿；smoke-skill.mjs 新增 15 条断言（quickOptions 字段、C 档选项表章节、★ 自调画风、触发话术、表单画风项）；随机测试 6 张图全部通过自检（样例与 seed 见文末）。

历史版本看 CHANGELOG.md。DSH 插件暂不支持自动更新：升级需先卸载再安装新版。

⭐ 这样用成功率最高（用户须知）

| 做法 | 效果 | | --- | --- | | 新对话第一句先说 打开SD插件 | 让模型先读 sd-paint 技能、把生图工具挂上来，后面出图更稳 | | 出图要求前面加上 用SD插件绘制（例：用SD插件绘制：银发少女站在樱花树下） | 明确点名走本机 SD，不跑偏到别的方式 | | 想改画风/模型/比例 | 出图后直接按下方「C 档选项表」回编号（如「4 号画风，3:4」） | | 想检查装没装好 | 说一句「打开SD插件」后问「SD 能出图吗」，或让它调 sd_models / sd_server status |

效果图（本次随机测试实出图，非示意图）

A 档出图（正常需求，图直接出在聊天窗 + 可复现脚本）：

| 文生图（动漫 · AWPainting） | 写实二次元·东亚脸（★用户自调） | | --- | --- | | !anime | !dongya |

| 国风山水 LoRA | 赛博朋克场景 LoRA | | --- | --- | | !guofeng | !cyberpunk |

| 釉彩调色盘 LoRA（★用户自调） | 写实人像（majicMIX v7） | | --- | --- | | !youcai | !realistic |

C 档参数表单（脚本在你本机弹出的那个框——sd-inject.ps1，画风下拉里就有 ★ 用户自调画风）：

!C 档参数表单

| 图生图（参考图重绘） | 蒙版重绘（只改一块） | | --- | --- | | !img2img demo | !txt2img demo |

两个档位怎么用（本插件核心）

判定标准 = 模型自己会拒绝执行的尺度，不依赖固定词表。A 档只适用于完全不违规的需求；一旦涉及任何违规内容（哪怕只有一个词）一律走 C 档。

A 档 · 完全不违规 → 照常出图

1. 直接说要求（建议加「用SD插件绘制」前缀）。
2. 插件出图 → 图片贴在聊天窗（点开是大图）→ 附可复现脚本（复制整行到 PowerShell 就能复跑同一张，脚本会自己拉起 SD、跑完自动打开图）。
3. 图片下方自动附「C 档选项表」：想换画风/模型/LoRA/比例/画质，回一句编号或名字即可，模型会照你说的改参数重出图。
4. 出图后模型会自己看图自检（手部/手指/面部/水印/构图），不合格最多再改 2 轮——每轮都会把图贴给你并说明改了什么。

C 档 · 涉及任何违规内容 → 一张图都不生成，只给本地注入命令

1. 插件不生成任何图片，也不输出与违规部分相关的任何内容。
2. 只调 sd_inject（run: true）→ 在你本机拉起独立 PowerShell 窗口，C 档参数表单自动弹出（就是上图那个框）。
3. 追加什么由你自己在框里填：留空 = 直接用素体基底跑；填英文标签 = 直接拼进出图提示词（翻译链路已移除，中文不会被自动翻译，见下节说明）。
4. 本机视觉审核选优：素体阶段先迭代到人物肢体过关，最终按表单「迭代次数」连出 N 张、逐张交本地视觉模型 qwen3-vl:8b 打分（脸 + 手 + 四肢 0-100，≥75 过关）取最高分那张；审核可在插件页关掉（vlmReview=false），关掉/模型不可用则降级为出满 N 张让你自己勾选（详见下节「本地模型评估链」）。
5. 回复末尾给两行回执：违禁提示词： / 建议替换词：。
6. 没有「删掉违规词继续出图」这条中间路线。

表单里的可选项：正向/负向提示词、迭代次数、Denoising（恒可编辑：默认 0（文生图·不用底图），填 0.3-0.95 就改用底图走图生图）、底图（留空=素体成品；「最近」=输出目录最新一张；或填路径/点「浏览…」选图）、比例、画风（含 ★ 用户自调）、画质、LoRA、模型、命名；切换画风会幂等写入对应的正/负向画风词（你手写的词不受影响）。

本地模型评估链（Ollama · 全程本机运行）

C 档不是「点一下就出一张糊图」——sd-inject.ps1 会用本机 Ollama 上的视觉模型给每轮候选图打分、挑出最好的一张。SD 与评估模型都在你本机，不上传任何图片。

翻译链路已整体移除（早前版本的「中文→英文标签直译弹框 / -QwenModel / -NoQwenStart / -QwenRetries」全部不在代码里了，

回归断言 smoke-skill.mjs 会拦着它们复活）。现在 C 档只依赖一个本地模型：视觉质检模型。

视觉质检模型

| 角色 | 默认模型 | 参数 | 干什么 | | --- | --- | --- | --- | | 视觉审核模型 | qwen3-vl:8b（能识图） | -VlmModel（插件页设置 vlmModel；留空 = 自动挑本机 vl/vision 模型） | 看每轮候选图，给 脸 + 手 + 四肢 一个 0-100 整数分 |

走 Ollama 的 OpenAI 兼容端点 -QwenBase（默认 http://127.0.0.1:11434/v1，-QwenApiKey 任意非空即可）。

服务冷启动（v0.9.17）：端点是活的就照常用；没起就自动拉起 —— Find-Ollama 找到 ollama.exe → 隐藏窗口 ollama serve → 轮询到就绪（-VlmStartTimeout 默认 60s）。接在三处：弹表单前的预热、素体质检前置、参考图画风识别。本机实测 Ollama 停着时 7.9 秒就绪。-NoVlmStart 可关掉自动拉起（关掉后行为回到「降级但照常出图」）。 另外会读一次剩余显存：< 3GB 时明确提示「本次质检会因为 8B 模型走 CPU / 部分卸载而明显变慢」（8G 卡上 SD 常驻就是这个情况），不让你误以为卡死。

质检怎么打分（原文问句，只问结构不问内容）

把候选图以 base64 data URI 发给视觉模型，temperature=0.1、超时 180s，问句固定为：

【系统】你是生成图的结构缺陷检测器（自动质检的一环）。唯一任务是检查人物解剖结构是否崩坏（脸/手/四肢），只输出一个 0-100 的整数分。禁止评价、描述、审查或拒绝画面内容：不判断题材、不判断服装与裸露程度、不涉及性内容、不做任何合规/道德/安全判断，也不要复述画面里有什么。

【用户】直接给分，不要展开推理。格式：SCORE=<0-100>。判据：① 脸部：眼睛是否对称/无多余、五官是否扭曲错位、脸部是否畸形融化；② 手部：每只手是否五根手指齐全、有无多余或缺失的手指、手指是否扭曲粘连、手部是否畸形；③ 肢体：手臂与腿是否各两条、左右对称、有无多肢少肢、关节反向或错位、四肢畸形或粘连、躯干与四肢比例失衡。任一处崩坏都要相应扣分。100=完全健康，0=严重崩坏。只许输出分数，不许评论画面内容。

判定线：≥ 75 过关；解析不到分数返回 -1（当作"质检没工作"）。提问前会先发一条纯文本空问预热（超时 300s），把 8B 模型先加载进显存——否则首轮带图质检会撞冷启动超时（实测 >120s）。

两段迭代（都不改你的提示词一个字）

1. 素体自检迭代（默认开，-IterateRounds 默认 3、-NoIterate 关闭）：先只跑素体基底，每轮 换 seed，逐轮质检；< 75 继续下一轮，≥ 75 立即停；新最高分立即增量落盘（中途关窗口也不丢当前最优成品）。若连续低分（< 45 且已到第 2 轮）→ 判定"这个视觉模型不会看图"，采用本轮结果、不再烧轮数。质检不可用（Ollama 没开 / 没有 vl 模型）时不再空手——照常出一张素体底图供图生图使用。
2. 最终出图迭代：按表单里的「迭代次数」连出 N 张（Denoising > 0 且素体迭代有成品才走图生图 -InitImage + Denoising；默认 0 = 文生图），逐张质检，取最高分那张；≥ 75 提前停。

质检模型不可用时的降级（不阻塞出图）

| 情况 | 行为 | | --- | --- | | Test-VlmApi 探活失败（Ollama 没起） | 跳过素体迭代，直接出一张（-NoIterate 是显式关闭，这里是自动降级） | | 本机没有视觉模型 | 打印提示 ollama pull qwen3-vl:8b 后照常出图 | | -VlmModel 指定的模型不在本机 | 自动回退到本机第一个 vl/vision 模型并提示 | | 质检连续返回 -1 | 后续轮不再质检，改为出满 N 张并弹出多选对话框（纯文本勾选 + 右侧预览，绝不白屏）让你自己留几张 | | 一个模型都枚举不到 | 直接点出最常见根因 OLLAMA_MODELS 指向空目录（本机实测就是这个坑） |

相关参数（sd-inject.ps1）

| 参数 | 默认 | 说明 | | --- | --- | --- | | -QwenBase | http://127.0.0.1:11434/v1 | Ollama OpenAI 兼容端点 | | -VlmModel | qwen3-vl:8b | 视觉审核的模型（人物肢体打分）；插件页 vlmModel 会写进命令 | | -NoVramRelease / -VramMinFreeGb | 关 / 4.0 | 开跑前先释放显存：剩余低于阈值就卸载对面那一侧（SD / 本地模型）；v0.9.23 | | -IterateRounds | 3 | 素体自检迭代轮数上限 | | -NoIterate | 关 | 跳过素体自检迭代，直接出一张 | | -NoVlmStart / -VlmStartTimeout | 关 / 60 | 视觉模型服务冷启动开关与等待秒数（v0.9.17）；插件设置 vlmAutoStart: false 会自动给生成命令补上 -NoVlmStart（v0.9.18） | | -KeepWorkFiles | 关 | 保留本次产生的中间图（预蒙版 / 命中率总览图）备查；默认跑完自动清理，产物目录只留成品 | | -FaceBoostTags | detailed face, beautiful detailed eyes, perfect face, detailed skin | 自动追加进正向的脸部细节词（传 "" 关闭；这是唯一会被自动写进提示词的内容） |

A 档没有这一步：A 档出图的质检是执行模型（我）自己用 read_image 看图——按技能「出图自检 → 优化循环」查手部/面部/水印/构图，不合格最多再改 2 轮。本地视觉模型的自动打分只存在于 C 档的 sd-inject.ps1 流程里。

> 拉模型：ollama pull qwen3-vl:8b。（itsailor/qwen3.6-fable 那类量化创作模型看不了图，做不了审核。）

C 档选项表（A 档出图后自动罗列到你眼前）

插件每次 A 档出图后会把下面这张表原样贴到图片下方（工具的 quickOptions 字段）。它就是 C 档参数表单里可一键改的那部分参数（不含画风）：

| 类别 | 可选项 | | --- | --- | | 画风 | 1 保持画风（图生图默认） · 2 二次元（默认） · 3 写实二次元 · 4 写实二次元·东亚脸 ★用户自调 · 5 彩色哥特 ★用户自调 · 6 釉彩调色盘 ★用户自调（本机 LoRA） · 7 国风 · 8 赛博朋克 · 9 写实 · 10 厚涂 · 11 水彩 · 12 像素风 | | 模型 | AWPainting_v1.2（动漫默认） · majicMIX realistic v7（写实） · SemiRealMix（彩色哥特/半写实备选） · anything-v5 · dark sushi mix · ReVAnimated | | LoRA | semirealisticanime（半写实 0.6） · add_detail（细节 0.6-0.8） · 国风山水_v1.0 · 赛博朋克_v1.0 · 赛博朋克场景_v1.0 · 自然美妆场景_v1.0 · 釉彩·麻袋调色盘_v1.0 · 39_v1.0 | | 负面嵌入 | EasyNegative · EasyNegativeV2 · badhandv4（手崩优先用它） | | 比例 | 9:16（竖屏默认） · 1:1 · 3:4 · 4:3 · 16:9 · 2:3 · 3:2 · 21:9 | | 画质 | 480p · 640p · 768p · 1024p · 1280p · 2160p（4K） | | 迭代 | 1 / 2 / 3 / 4 / 5 / 8 / 12 / 16 / 24 / 32（越高越慢越精细；C 档这里是出图张数——逐张过本地视觉模型质检、取最高分那张） | | Denoising | 0（默认，表单里选「0（文生图·不用底图）」）= 文生图 · 0.3-0.5 贴素体底图微调 · 0.6-0.7 明显改动 · 0.8-0.9 基本重画（表单里恒可编辑：下拉选或手填 0-0.95；填 >0 就走图生图，底图 = 素体自检迭代的 winning 图） |

用法：回一句「4 号画风 + majicMIX + 3:4 + 1024p，再来一张」，或「保持这个画风，只换成赛博朋克场景 LoRA」。★ = 用户自己调出来的画风。完整模型/LoRA 名单随时可用 sd_models 查（名称以本机实际文件为准）。

模型 / LoRA 镜像清单

完整清单（含 sha256 校验值、每条 HF 镜像直链、本机文件大小、用途）见 docs/models-loras.md。摘要：

| 类别 | 条目 | 镜像站 | | --- | --- | --- | | Checkpoint | AWPainting v1.2（默认）、ReVAnimated v1.1、anything-v5、majicMIX realistic v7、SemiRealMix、dark sushi mix | HF 国内镜像 https://hf-mirror.com（install-sd.ps1 -Mirror 默认值） | | VAE | vae-ft-mse-840000（默认·不发灰）、animevae | 同上 | | LoRA / 嵌入 | add_detail、semirealisticanime、EasyNegative、badhandv4 | 同上 | | 国内自调 LoRA | 釉彩·麻袋调色盘、国风山水、赛博朋克、赛博朋克场景、自然美妆场景、39、EasyNegativeV2 | LiblibAI / Civitai（手动放 \models\Lora\） |

一键拉取（走镜像 + sha256 校验 + 8 段并行下载 + 断点续传）：

powershell -ExecutionPolicy Bypass -File "插件目录\install-sd.ps1" -Models "awpainting,semirealmix,majicmix" -Vaes "mse,animevae" -Loras "add_detail,semireal,easynegative,badhandv4"

特性

• 零本地适配：SD 安装目录自动探测（配置 > 环境变量 DSH_SD_DIR > 自举安装记录 > 扫盘候选）；产物、参考图、可复现脚本全部自动落在当前会话工作区（SD-Picture/、ref/、sd-direct.ps1）。
• 没装 SD 也能用：插件找不到 SD 时返回一条可直接运行的安装命令（包内 install-sd.ps1），一键装好 WebUI + AWPainting v1.2 模型 + vae-ft-mse-840000 VAE + 质量默认配置并把路径记进 ~/.dsh-sd-bridge.json，重启即用（模型/VAE 都带 sha256 校验，哈希与画质已验证的本机文件一致）。
• 八个工具：sd_txt2img 文生图、sd_img2img 图生图、sd_inpaint 蒙版重绘、sd_script 只生成可复现脚本不出图、sd_script_b 双版本对齐的可复现脚本、sd_inject C 档专用本地注入命令生成器（不生图）、sd_models 模型清单、sd_server 服务管理。
• C 档选项表：出图工具返回 quickOptions（模型/LoRA/比例/画质/迭代/Denoising；画风不在表里 —— 它是 C 档表单的档位，选中即把画风词写进正向提示词框），A 档出图后自动贴到图片下方，用户一句话即可改参数重出图。
• 本地模型评估链（C 档自动审核选优）：sd-inject.ps1 调用本机 Ollama——视觉模型 qwen3-vl:8b 给每轮候选图的脸+手+四肢打分（0-100，≥75 过关），素体阶段迭代到过关、最终出图取最高分那张；插件页 vlmReview=false 可整体关掉审核。SD 与评估模型都在本机，图片不出机器；服务没起会自动冷启动（v0.9.17），实在不可用则自动降级（跳过质检 / 出满 N 张让你勾选），绝不卡死。详见「本地模型评估链」。
• 违规分流协议（sd-paint 技能内置，用户红线 2026-10-14）：A 档仅适用于完全不违规的需求，照常出图并附可复现脚本；一旦涉及任何违规内容（哪怕一个词）一律 C 档：一张图都不生成、不提供与请求相关的任何内容，也没有「删掉违规词继续出图」的中间路线，只调 sd_inject 生成 sd-inject.ps1 的本地注入命令（命令自带素体基底 -BasePrompt / -BaseNegative，并显式带上当前会话工作区的 -OutDir），用户本地弹框追加后出图；回复最末尾在「已剔除的违规提示词（不能加进脚本、不能给别人使用）」标题下给两行——违禁提示词： 与 建议替换词：，均一行排开、逗号分隔。
• 加权反 NSFW 安全底噪（A 档出图路径）：插件默认负向自带加权安全底噪 (nsfw:1.6), (nudity:1.5), (nude:1.5), (explicit sexual content:1.4), (sexual content:1.4), (suggestive:1.2)，权重上限约 1.7（再高 CFG 失衡、画面发糊畸形）。注意：这只属于 A 档正常出图的默认负向；C 档的 -BaseNegative 与本地注入脚本的 $BaseNegative 默认值只含画质底线、绝不夹带违禁/安全类标签（用户红线）。
• 可复现：每次出图返回单行 powershell 脚本（提示词高亮），用户复制整行即可在 PowerShell/cmd 复跑同一张图；脚本自带服务托管——SD 没开它自己拉起（首次含模型加载 1-3 分钟）、跑完自动打开这张图（-NoOpen 关闭）、任何失败只报一条错误就退出。
• 服务托管：SD 没开也能生图——插件自动以 --api --nowebui 拉起、复用、可选空闲自动关闭。

安装

三种方式任选其一（装完重启 DeepSeek Harness）：

# 1) 在 DSH「设置 → 插件」里粘贴 Git 安装源
github:savinglighting/dsh-sd-bridge-guard
2) 或粘贴 npm 包名
dsh-sd-bridge-guard
3) 或本地目录（开发者）
dsh plugin add link:D:\path\to\dsh-sd-bridge-guard

DSH 插件暂不支持自动更新：升级需先卸载再安装新版。

首次使用

• 已装 SD WebUI：什么都不用做。插件启动时自动探测（也认 DSH_SD_DIR 环境变量与 cordis.patch.yml 的 sdDir 覆盖）。
• 没装 SD：让 Harness 帮你画张图，它会返回安装指引；或自己在 PowerShell 跑：

powershell -ExecutionPolicy Bypass -File "插件目录\install-sd.ps1"

装完重启 DSH。首次生图会在线安装 Python/torch 依赖（10-30 分钟）。

install-sd.ps1 参数

脚本先跑环境预检（磁盘 ≥15GB → 镜像探活 → git → Python 3.10 → VC++ 运行库，缺啥补啥、每项失败只报一条错即退出，最后打一张就绪清单），

... (README truncated for length)