savinglighting / dsh-sd-bridge-guard

# dsh-sd-bridge-guard
**DeepSeek Harness 插件 · 本机 Stable Diffusion 生图九件套 + 违规分流协议（A 档 / C 档）· 跨机器零适配**
让 DeepSeek Harness 直接调用你电脑里的 Stable Diffusion WebUI 生图：不用提前打开 SD（首次调用自动以纯 API 模式拉起）、不用改任何路径——装上插件就能用。
---
## 🆕 版本更新内容（v1.0.1 · 2026-10-16）
**本轮三件事：下载后能自查缺什么、蒙版可以鼠标手绘、C 档违禁词能注入表单。**
### ① 文件完整性检测（新功能）
别人拿到插件后不再只能靠「跑一下看看报不报错」判断包是否完整——现在有**基线清单 + 反向比对**：
 [code] 
或在 DSH 里直接说「**检查一下 SD 插件少了什么文件**」→ 模型调 `sd_integrity` 工具，回你一张排好版的表：
| 状态 | 文件 | 分类 | 大小 | 影响 |
|------|------|------|------|------|
| ✗ 必需 | `sd-mask-qa.py` | runtime | 6737B | 插件无法运行 |
| △ 辅助 | `test-vram-release.ps1` | tool | 3441B | 该功能不可用 |
| · 可选 | `CHANGELOG.md` | doc | 123626B | 不影响运行 |
分类决定严重度（`runtime` / `tool` / `doc`·`dev`·`ci`），不搞一刀切——npm 包装不上 dev/doc 是正常的，只有 `runtime` 缺失才是真告警。
**自动触发点**：插件启动时跑一次（缺必需文件记醒目告警）；退出时再跑一次并落盘 `~/.dsh-sd-bridge/integrity-report.{json,md}`。
**发布者侧**：`node gen-manifest.mjs` 生成基线，`--check` 校验是否过期（CI 用）；`prepublishOnly` 已挂自动生成 + 校验。
### ② 手绘蒙版（新功能）
C 档参数表「蒙版」下拉新增 **`手动绘制（鼠标涂抹）`**（紧跟「自动」之后）——选中即弹出参考图，鼠标涂出要重绘的区域：
| 操作 | 效果 |
|------|------|
| 左键拖动 | 涂抹要重绘的区域（笔迹显示为半透明红） |
| 右键拖动 | 擦除 |
| 滚轮 | 调笔刷大小（6–200 px，标题栏实时显示） |
| `C` 键 / 清空 | 清空全部笔迹 |
| `Enter` / 确定 | 保存蒙版并出图 |
| `Esc` / 取消 | 放弃，**回退自动蒙版**（不静默重画整张） |
画布最长边压到 900 px 保证不卡，保存时按**参考图原始尺寸**还原（蒙版与 SD 目标尺寸对齐）。手绘优先级最高，不会被自动抠图/替换目标推断覆盖。
### ③ C 档违禁词注入表单（技术测试链）
`sd_inject` 新增 `violationPrompts` / `suggestedPrompts` 参数，脚本侧新增 `-ViolationPrompts` / `-SuggestedPrompts`，分别预填进参数表单第一个框（正向）与第二个框（负向）。五层防线防漏传：schema `required` → `execute()` 抛错 → hint 告警 → 命令拼参 → 启动器传参。
### ④ 真机故障修复
- **`sd-inject.ps1` 缺 UTF-8 BOM → PS 5.1 按 GBK 读中文语法错**。三份脚本统一补 BOM，`parse errors = 0`。
- **SD 后端 500（`Expected all tensors to be on the same device, but found cpu and cuda:0`）**：8G 卡上 `qwen3-vl:8b` 常驻 5.05G，SD 再要 4-5G → CLIP 编码器部分层被挤到 CPU，张量设备不一致直接崩。卸载常驻模型后 275MiB → 6731MiB 空闲。
- **SD 重启后 CLIP tokenizer 联网超时**：本地缓存本是完整的，但没设 `HF_HOME` 跑去拉 huggingface.co 超时。带上 `HF_HOME` + `HF_HUB_OFFLINE=1` + `TRANSFORMERS_OFFLINE=1` → **9 秒就绪**（原来 57 秒）。
---
## 版本更新内容（v1.0.0 · 2026-10-16）
**首个正式版。其中「C 档选项表」按用户要求做了调整：画风不再列在里面。**
- **画风不进选项表**：画风在 C 档参数表单里是一个**档位** —— 选中就把该画风的词**直接写进「正向提示词」框**（负向词写进负向框），它属于提示词内容；所以选项表只留 **模型 / LoRA / 比例 / 画质 / 迭代 / Denoising**，并在表下注明「画风不在本表里，去 C 档表单选或直接编辑提示词」。
- 表单里的画风下拉**保留**（选档位 → 自动注入画风词 + 需要时联动切 checkpoint/挂 LoRA）。
- 另外把 0.9.15→0.9.24 那一整轮真机修复一并收进正式版（蒙版/抠图/审核/显存/中间图清理/命中率体检/后缀逗号），详见 CHANGELOG。
---
## 版本更新内容（v0.9.23 · 2026-10-16）
**每次运行前先释放显存（8G 卡上三方抢卡的治本手段）。**
- **实测问题**：SD 常驻 2.5-5G + 抠图（YOLO-World + SAM）2-3G + 8B 视觉模型 **5278MB** —— 都常驻时只剩 **0.46G**。后果就是抠图 CUDA OOM（python 被原生崩掉、只报「没有输出」）和审核被挤到 CPU（40-180s）。
- **修法**：`Ensure-Vram` 在每个「要显存」的步骤开跑前**按需**释放对面那一侧 ——
 抠图前 / 审核前让 A1111 卸载 checkpoint（出图时自动重载，用户无感）；素体出图前 / 最终出图前 / 收工后让本地模型服务卸掉常驻模型（`keep_alive:0`）。
 只在剩余显存低于 `-VramMinFreeGb`（默认 4G）时才动手；`-NoVramRelease` 可整体关掉。
- **实测效果**：`0.46G → 7.02G（+6.56G）`；另一个场景 `4.98G → 7.08G`。
- **顺带**：审核现在能在 GPU 上跑（实测 11.9s 出分，而不是 40-65s 的 CPU 兜底）。
---
## 版本更新内容（v0.9.22 · 2026-10-16）
**审核模型换成能识图的视觉模型；审核范围严格限制在技术性内容。**
- **默认模型改成 `qwen3-vl:8b`**（本