koishi-plugin-p-draw 1.6.8 → 1.6.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/readme.md +83 -51
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "koishi-plugin-p-draw",
3
3
  "description": "p点-绘图,连接本地 ComfyUI 生图。支持自然语言优化、尺寸选择、画师组、固定角色、生成队列,需要配合 p-qiandao 使用",
4
- "version": "1.6.8",
4
+ "version": "1.6.9",
5
5
  "main": "index.js",
6
6
  "files": [
7
7
  "index.js",
package/readme.md CHANGED
@@ -307,6 +307,26 @@ llmChannels:
307
307
  | `qwen_3_06b_base.safetensors` | `ComfyUI/models/text_encoders/` | 文本编码器,与 Base 模型共用 |
308
308
  | `qwen_image_vae.safetensors` | `ComfyUI/models/vae/` | VAE,与 Base 模型共用 |
309
309
 
310
+ #### 各工作流的额外模型
311
+
312
+ 除了上面三个核心文件,下面这些按需下载(不用的工作流可以不装):
313
+
314
+ | 文件 | 目标目录 | 大小 | 用于 |
315
+ |---|---|---|---|
316
+ | `4x_NMKD-Siax_200k.pth` | `models/upscale_models/` | 63.9MB | 05 分块放大 |
317
+ | `face_yolov8n.pt` / `hand_yolov8s.pt` | `models/ultralytics/bbox/` | 5.9 / 21.5MB | 08、06 修脸修手 |
318
+ | `PitHandDetailer-v2-Test-v9c.pt` | `models/ultralytics/segm/` | 53.6MB | 08、06 手部精细分割 |
319
+ | `sam_vit_b_01ec64.pth` | `models/sams/` | 357.7MB | 08、06 的 SAM 分割 |
320
+ | `person_yolov8m-seg.pt` | `models/ultralytics/segm/` | 52.3MB | 11、12 人物抠图 |
321
+ | `anima-vace-depth.safetensors` | `models/controlnet/` | 568.3MB | 02 VACE 深度控制 |
322
+ | `anima-lllite-depth-1.safetensors` | `models/model_patches/` + `models/controlnet/` | 7.5MB | 02 的 LLLite 备选方案 |
323
+ | `AnimaEditV1.safetensors` | `models/loras/` | 210.1MB | 10 参考图编辑(**必需**) |
324
+ | `dmdx_student_final_comfy.safetensors` | `models/loras/` | 138.2MB | 03 DMDX 四步极速 |
325
+
326
+ > **检测器类模型要放两份**:Impact Pack 只读 ComfyUI 安装目录下的 `models/ultralytics/{bbox,segm}`,而 `/models` 接口看到的是共享目录。两份都放最省事。
327
+ >
328
+ > `DepthAnythingV2Preprocessor` 的 `ckpt_name` 是可选输入,**不显式指定就会去下 1.3GB 的 Large 版**(而且那个下载是同步阻塞的,连 interrupt 都杀不掉)。工作流里已经写死 `depth_anything_v2_vits.pth`(94.6MB),模型放 `custom_nodes/comfyui_controlnet_aux/ckpts/depth-anything/Depth-Anything-V2-Small/`。
329
+
310
330
  **8G 显存(如 4060)推荐 GGUF Q8_0**:需要先安装 [ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF) 插件。插件按 `unetName` 后缀自动选择加载器——`.gguf` 用 `UnetLoaderGGUF`,其余用 `UNETLoader`;也可用 `useGgufUnet` 强制指定。
311
331
 
312
332
  推荐参数:
@@ -432,23 +452,23 @@ workflowPresets:
432
452
  defaultWorkflowPreset: 基础文生图
433
453
  ```
434
454
 
435
- ### 画图前点数确认
436
-
437
- 默认开启(`workflowConfirm`)。每次画图前会先发一条明细,等用户回复「是」才真正开始,回复「否」或超时都不扣点:
438
-
439
- ```
440
- 本次任务需要 1800 P 点
441
- · 工作流:精修(1800 P/张 × 1 张)
442
- · 参考图:1 张(已上传)
443
- · 提醒:该工作流对主体分离能力有限,可能与主体相连的部分一并保留;如效果不理想,建议更换构图或参考图后重试。
444
-
445
- 回复「是」开始绘制,回复「否」取消(60 秒内)
446
- ```
447
-
448
- - 管理员免扣费,不会询问
449
- - 平台不支持交互确认时自动跳过
450
- - 「提醒」那一行来自预设的 `warning` 字段,留空就不显示。换背景类工作流建议填一条通用说明(不要把具体画面元素写死)
451
-
455
+ ### 画图前点数确认
456
+
457
+ 默认开启(`workflowConfirm`)。每次画图前会先发一条明细,等用户回复「是」才真正开始,回复「否」或超时都不扣点:
458
+
459
+ ```
460
+ 本次任务需要 1800 P 点
461
+ · 工作流:精修(1800 P/张 × 1 张)
462
+ · 参考图:1 张(已上传)
463
+ · 提醒:该工作流对主体分离能力有限,可能与主体相连的部分一并保留;如效果不理想,建议更换构图或参考图后重试。
464
+
465
+ 回复「是」开始绘制,回复「否」取消(60 秒内)
466
+ ```
467
+
468
+ - 管理员免扣费,不会询问
469
+ - 平台不支持交互确认时自动跳过
470
+ - 「提醒」那一行来自预设的 `warning` 字段,留空就不显示。换背景类工作流建议填一条通用说明(不要把具体画面元素写死)
471
+
452
472
  ### 指令用法
453
473
 
454
474
  ```
@@ -468,7 +488,7 @@ defaultWorkflowPreset: 基础文生图
468
488
 
469
489
  选了不可用的预设会**直接拒绝并说明原因**,不会静默失败或跑错工作流。
470
490
 
471
- ### 10 个工作流的可用性对照
491
+ ### 12 个工作流的可用性对照
472
492
 
473
493
  | # | 工作流 | 节点 | 起点 | 当前版本 |
474
494
  |---|---|---|---|---|
@@ -482,6 +502,8 @@ defaultWorkflowPreset: 基础文生图
482
502
  | 06 | i2i + ControlNet + Face/Hand Repair | 52 | 图片 | ✅ 可用(已裁成单输出;WD14 打标器已剔除,重绘幅度建议 0.4–0.6) |
483
503
  | 07 | Image-to-Image | 19 | 图片 | ✅ 可用(已裁成单输出;`Qwen3VLProcessor` 已剔除,需配 `denoise`) |
484
504
  | 10 | Anima-Edit LoRA / IC | 52 | 图片 | ✅ 可用(**参考图编辑**:改服装/细节、保角色;背景基本沿用原图) |
505
+ | 11 | 换背景(自建) | 16 | 图片 | ✅ 可用(蒙版重绘:保留构图与主体,只重绘背景) |
506
+ | 12 | 换新场景(自建) | 23 | 图片 | ✅ 可用(抠主体 + 新场景生成 + 合成融合,构图也可换) |
485
507
 
486
508
  判断依据是自动体检的结果:**只要 JSON 里出现 `LoadImage` 一类节点,就判定为需要图片输入**。所以 05/08 到底能不能用,取决于你导出时是「从空 latent 开始」还是「从图开始」——`画图 工作流` 会直接告诉你。
487
509
 
@@ -496,6 +518,7 @@ defaultWorkflowPreset: 基础文生图
496
518
  | [ControlAltAI-Nodes](https://github.com/gseth/ControlAltAI-Nodes) | `FluxResolutionNode` | 按兆像素/比例计算尺寸 |
497
519
  | [rgthree-comfy](https://github.com/rgthree/rgthree-comfy) | `Seed (rgthree)` | 08 等图的种子节点 |
498
520
  | [ComfyUI-Advanced-ControlNet-Anima](https://github.com/TaihoC/ComfyUI-Advanced-ControlNet-Anima)(`feat/anima-vace-controlnet` 分支) | `ACN_ControlNetLoaderAdvanced` / `ACN_AdvancedControlNetApply` | 02 的 VACE 深度控制 |
521
+ | [ComfyUI-Cosmos-Reference](https://github.com/Mirumo0u0/ComfyUI-Cosmos-Reference) | `ApplyCosmosReferenceLatent` | 10 的参考图编辑 |
499
522
 
500
523
  > **02 的 VACE 深度控制要点**(实测得出,容易踩坑):
501
524
  > 1. 权重:`TaihoC/Anima-ControlNet-VACE-Depth` 的 `anima-vace-depth.safetensors`(568MB)放 `models/controlnet`
@@ -542,39 +565,48 @@ defaultWorkflowPreset: 基础文生图
542
565
  - **管理员在全局关闭时自动免费优化**(不耗券);`无优化` 原样模式不消耗、不询问。平台不支持交互确认时退回自动消耗逻辑。
543
566
  - **未使用优化的提示**:单人生图没走 LLM 优化时会明确提示原因——未配置 LLM、未消耗优化券、或 `无优化` 原样模式;多人指令强依赖 LLM 规划,未配置 `llmBaseUrl`/`llmModel` 时会直接提示「多人指令需要 LLM 规划」。
544
567
  - 本地模型不一定认识新角色,可用 `添加角色` 手动补充角色 tags。
568
+
569
+ ## 更新日志
570
+
571
+ ### 1.6.8
572
+
573
+ **新功能:画图前报点数明细并等确认**
574
+
575
+ - 每次画图前先发一条明细,回复「是」才开始,回复「否」或超时都不扣点:
576
+ ```
577
+ 本次任务需要 1800 P 点
578
+ · 工作流:精修(1800 P/张 × 1 张)
579
+ · 参考图:1 张(已上传)
580
+ · 提醒:<预设 warning 字段的内容>
581
+
582
+ 回复「是」开始绘制,回复「否」取消(60 秒内)
583
+ ```
584
+ - 等待时间**全局统一**(`workflowConfirmTimeout`,默认 60 秒),对所有工作流生效,在插件配置里改。
585
+ - 管理员免扣费,不询问;平台不支持交互确认时自动跳过,不会卡住。
586
+ - 预设新增 `warning` 字段,用于换背景这类有已知能力边界的工作流。
587
+
588
+ **修复**
589
+
590
+ - 图生图 / 重绘类工作流被判「正负面节点有歧义」:条件经过 `InpaintModelConditioning` 之类的中转节点时,反查会同时命中正负两组文本节点。现在优先只从采样器出发,并且只沿同名输入继续走。
591
+ - 图生图工作流被误判为不可用:体检原先要求工作流必须有可写尺寸的空 latent 节点,但图生图的 latent 来自 `VAEEncode`。现在只在**没有图片输入**时才要求它。
592
+
593
+ **配置**
594
+
595
+ | 项 | 默认 | 说明 |
596
+ |---|---|---|
597
+ | `workflowConfirm` | `true` | 画图前报价并等确认 |
598
+ | `workflowConfirmTimeout` | `60` | 确认等待秒数(全局统一) |
599
+
600
+ **文档**
601
+
602
+ - 补充 02(VACE 深度控制)、05(分块放大)、10(参考图编辑)、11(换背景)、12(新场景合成)的实测结论、依赖与踩坑要点。
603
+ - 说明 ComfyUI 自带的 `ReferenceLatent` 与 Advanced-ControlNet 的 `ACN_ReferenceControlNet` 对 Anima **均静默失效**,不要用。
545
604
 
546
- ## 更新日志
547
-
548
- ### 1.6.8
549
-
550
- **新功能:画图前报点数明细并等确认**
551
-
552
- - 每次画图前先发一条明细,回复「是」才开始,回复「否」或超时都不扣点:
553
- ```
554
- 本次任务需要 1800 P 点
555
- · 工作流:精修(1800 P/张 × 1 张)
556
- · 参考图:1 张(已上传)
557
- · 提醒:<预设 warning 字段的内容>
558
-
559
- 回复「是」开始绘制,回复「否」取消(60 秒内)
560
- ```
561
- - 等待时间**全局统一**(`workflowConfirmTimeout`,默认 60 秒),对所有工作流生效,在插件配置里改。
562
- - 管理员免扣费,不询问;平台不支持交互确认时自动跳过,不会卡住。
563
- - 预设新增 `warning` 字段,用于换背景这类有已知能力边界的工作流。
564
-
565
- **修复**
566
-
567
- - 图生图 / 重绘类工作流被判「正负面节点有歧义」:条件经过 `InpaintModelConditioning` 之类的中转节点时,反查会同时命中正负两组文本节点。现在优先只从采样器出发,并且只沿同名输入继续走。
568
- - 图生图工作流被误判为不可用:体检原先要求工作流必须有可写尺寸的空 latent 节点,但图生图的 latent 来自 `VAEEncode`。现在只在**没有图片输入**时才要求它。
569
-
570
- **配置**
571
-
572
- | 项 | 默认 | 说明 |
573
- |---|---|---|
574
- | `workflowConfirm` | `true` | 画图前报价并等确认 |
575
- | `workflowConfirmTimeout` | `60` | 确认等待秒数(全局统一) |
605
+ ### 1.6.9
576
606
 
577
- **文档**
607
+ 纯文档补全,代码无改动:
578
608
 
579
- - 补充 02(VACE 深度控制)、05(分块放大)、10(参考图编辑)、11(换背景)、12(新场景合成)的实测结论、依赖与踩坑要点。
580
- - 说明 ComfyUI 自带的 `ReferenceLatent` 与 Advanced-ControlNet 的 `ACN_ReferenceControlNet` 对 Anima **均静默失效**,不要用。
609
+ - 「可用性对照」表加入 11(换背景)与 12(换新场景),表头改为 12 个工作流。
610
+ - 自定义节点包表补上 `ComfyUI-Cosmos-Reference`(10 的参考图编辑需要)。
611
+ - 新增「各工作流的额外模型」清单:9 个模型文件的目录、大小、用途一次列全。
612
+ - 补充两条易踩的坑:检测器类模型要放两份(Impact Pack 只读安装目录);`DepthAnythingV2Preprocessor` 不显式指定 `ckpt_name` 会去下 1.3GB 的 Large 版。