koishi-plugin-p-draw 1.6.7 → 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.
package/index.js CHANGED
@@ -50,7 +50,7 @@ const CONFIG_GROUPS = {
50
50
  'activeArtistPreset', 'artistPresets', 'fixedCharacters',
51
51
  ],
52
52
  queue: ['queueEnabled', 'queueMaxRequests', 'batchMax'],
53
- pricing: ['price', 'multiPrice', 'couponPrice', 'couponAskTimeout', 'adminUsers'],
53
+ pricing: ['price', 'multiPrice', 'couponPrice', 'couponAskTimeout', 'workflowConfirm', 'workflowConfirmTimeout', 'adminUsers'],
54
54
  access: ['adminOnly', 'allowedUserIds', 'blockedUserIds', 'allowedGroupIds', 'blockedGroupIds', 'outputLogs'],
55
55
  workflow: [
56
56
  'customWorkflowEnabled', 'customWorkflowPath', 'skipQualityPrefixForCustomWorkflow',
@@ -151,6 +151,8 @@ exports.Config = Schema.object({
151
151
  multiPrice: Schema.number().default(900).description('多人指令单张消耗的 P 点'),
152
152
  couponPrice: Schema.number().default(3000).description('提示词优化券单价(可被 data/p-shop.json 覆盖)'),
153
153
  couponAskTimeout: Schema.number().default(60).description('优化券确认等待时间(秒)'),
154
+ workflowConfirm: Schema.boolean().default(true).description('画图前先报点数明细并等用户确认(默认开)'),
155
+ workflowConfirmTimeout: Schema.number().default(60).description('点数确认的等待时间(秒)'),
154
156
  adminUsers: Schema.array(Schema.string()).default([]).description('免 P 点管理员用户 ID'),
155
157
  }).description('⑤ P 点与优化券').collapse(),
156
158
 
@@ -192,6 +194,7 @@ exports.Config = Schema.object({
192
194
  denoise: Schema.number().description('图生图的重绘幅度 0–1(1=整张重绘)。只对需要图片输入的工作流有意义'),
193
195
  imageNodeId: Schema.string().description('图片输入节点 ID(LoadImage)。留空则自动使用工作流里的图片节点'),
194
196
  price: Schema.number().description('该预设每张消耗的 P 点(留空沿用全局 price / multiPrice)'),
197
+ warning: Schema.string().description('该预设被使用时报给用户的提醒(留空不提醒),例如换背景类的能力边界说明'),
195
198
  overrideModel: Schema.boolean().description('是否把 unetName 写进这个工作流的模型节点(留空沿用全局)'),
196
199
  modelLoaderNodeId: Schema.string().description('该预设的模型加载节点 ID(留空沿用全局)'),
197
200
  }).description('预设')).default({}).description('工作流预设:key=预设名。指令里用 `--工作流 <名称>` 或名称/别名开头选择(如 `画图 极速:1girl`)'),
@@ -2357,6 +2360,26 @@ exports.apply = async function apply(ctx, rawConfig) {
2357
2360
  const userNegativePrompt = promptSections.negative
2358
2361
  if (!userPrompt) return session.text('.no-prompt')
2359
2362
 
2363
+ // 点数确认:先报明细(多少点、来自哪个工作流),用户同意再画。
2364
+ // 管理员免扣费,没有需要确认的花费,直接放过。
2365
+ if (cfg.workflowConfirm && !isAdmin && typeof session.prompt === 'function') {
2366
+ const totalCost = count * unitPrice
2367
+ const presetName = activePreset ? activePreset.name : '内置默认工作流'
2368
+ const lines = [
2369
+ `本次任务需要 ${totalCost} P 点`,
2370
+ `· 工作流:${presetName}(${unitPrice} P/张 × ${count} 张)`,
2371
+ ]
2372
+ if (imagePlan.files.length) lines.push(`· 参考图:${imagePlan.files.length} 张(已上传)`)
2373
+ const presetWarning = activePreset ? String(activePreset.warning || '').trim() : ''
2374
+ if (presetWarning) lines.push(`· 提醒:${presetWarning}`)
2375
+ lines.push('', `回复「是」开始绘制,回复「否」取消(${cfg.workflowConfirmTimeout} 秒内)`)
2376
+ await session.send(lines.join('\n'))
2377
+ const reply = await session.prompt(cfg.workflowConfirmTimeout * 1000).catch(() => null)
2378
+ if (normalizeConfirm(reply) !== true) {
2379
+ return session.text('.workflow-confirm-cancelled')
2380
+ }
2381
+ }
2382
+
2360
2383
  // ComfyUI 就绪
2361
2384
  const ready = await ensureComfyuiReady()
2362
2385
  if (!ready.ok) return ready.message
package/lib/i18n.js CHANGED
@@ -99,6 +99,7 @@ const zhCN = {
99
99
  'coupon-use-confirmed': '已消耗 {0} 张提示词优化券,本次每张图都会使用 LLM 优化。',
100
100
  'coupon-use-cancelled': '已取消本次生图(未使用提示词优化券)。',
101
101
  'coupon-cancelled': '未收到有效回复,本次操作已取消。',
102
+ 'workflow-confirm-cancelled': '已取消,本次未生成、也未扣 P 点。',
102
103
  'coupon-ask-buy': '提示词优化券不足(需 {0} 张,现有 {1} 张)。\n提示词优化券价格:{2} P/张,本次共需 {3} P。\n是否购买并使用?\n(回复「是」购买 / 回复「否」不购买)',
103
104
  'coupon-buy-warn': '不使用提示词优化券的话,生成的图可能不好看。\n是否仍要购买并使用提示词优化券?\n(回复「是」购买 / 回复「否」直接生图)',
104
105
  'coupon-bought-used': '已购买 {0} 张提示词优化券(扣除 {1} P),并消耗 {0} 张用于本次 LLM 优化。',
package/lib/workflows.js CHANGED
@@ -214,10 +214,14 @@ function findResolutionNodeIds(workflow) {
214
214
  // 从任意带 positive/negative 输入的节点(KSampler、KSamplerAdvanced、ClownsharKSampler_Beta
215
215
  // 等所有采样器)沿连线反查,找到真正的文本编码节点。
216
216
  // 不写死采样器类名,否则 RES4LYF / 自定义采样器都会识别不到。
217
- function conditioningTextNodeIds(workflow, inputName, textNodes) {
217
+ // samplerOnly=true 时只从采样器节点出发反查。
218
+ // 图生图/重绘类工作流里 InpaintModelConditioning 之类的中转节点也有 positive/negative 输入,
219
+ // 若把它们和采样器一起当起点,两条链会同时命中正负两组文本节点 → 被判成"有歧义"。
220
+ function conditioningTextNodeIds(workflow, inputName, textNodes, samplerOnly = false) {
218
221
  const pending = []
219
222
  for (const node of Object.values(workflow)) {
220
223
  if (!node || typeof node !== 'object') continue
224
+ if (samplerOnly && !/sampler/i.test(String(node.class_type || ''))) continue
221
225
  const link = node.inputs && node.inputs[inputName]
222
226
  if (Array.isArray(link) && link.length) pending.push(String(link[0]))
223
227
  }
@@ -234,6 +238,14 @@ function conditioningTextNodeIds(workflow, inputName, textNodes) {
234
238
  const node = workflow[nodeId]
235
239
  const inputs = node && node.inputs
236
240
  if (!inputs || typeof inputs !== 'object') continue
241
+ // 中转节点(如 InpaintModelConditioning)同时有 positive 和 negative:
242
+ // 只沿着同名的那个输入继续走,否则正负两条链会互相污染
243
+ const sameName = inputs[inputName]
244
+ if (Array.isArray(sameName) && sameName.length) {
245
+ const sourceId = String(sameName[0])
246
+ if (workflow[sourceId]) pending.push(sourceId)
247
+ continue
248
+ }
237
249
  for (const value of Object.values(inputs)) {
238
250
  if (Array.isArray(value) && value.length) {
239
251
  const sourceId = String(value[0])
@@ -253,7 +265,12 @@ function resolveCustomNodeTargets(workflow, cfg = {}) {
253
265
  const explicitNegative = cleanNodeId(cfg.negativePromptNodeId)
254
266
 
255
267
  function resolveTextNode(explicit, inputName, label) {
256
- if (!explicit) return conditioningTextNodeIds(workflow, inputName, textNodes)
268
+ if (!explicit) {
269
+ // 优先只从采样器反查:图生图/重绘工作流里的条件中转节点容易造成正负混淆
270
+ const fromSampler = conditioningTextNodeIds(workflow, inputName, textNodes, true)
271
+ if (fromSampler.length) return fromSampler
272
+ return conditioningTextNodeIds(workflow, inputName, textNodes)
273
+ }
257
274
  const available = textNodes.map(id => nodeLabel(workflow, id)).join('\n ') || '(无)'
258
275
  if (!workflow[explicit]) {
259
276
  errors.push(`配置的${label}节点 ID「${explicit}」不存在于工作流中。可用文本编码节点:\n ${available}`)
@@ -586,7 +603,8 @@ function inspectWorkflowFile(workflowPath, cfg = {}, opts = {}) {
586
603
  report.error = targets.errors.join(';')
587
604
  return report
588
605
  }
589
- if (!report.analysis.hasLatentStart) {
606
+ // 图生图工作流的 latent 来自 VAEEncode,没有空 latent 节点,不能因此判为不可用
607
+ if (!report.analysis.hasLatentStart && !report.needsImage) {
590
608
  report.error = report.analysis.requires.length
591
609
  ? `需要${report.analysis.requires.join('、')},且工作流里找不到可写入尺寸的 latent 节点`
592
610
  : '工作流里找不到可写入尺寸的 latent 节点(缺少文生图起点)'
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.7",
4
+ "version": "1.6.9",
5
5
  "main": "index.js",
6
6
  "files": [
7
7
  "index.js",
package/readme.md CHANGED
@@ -106,6 +106,7 @@ plugins:
106
106
  |----|------|
107
107
  | `price` / `multiPrice` | 单张 / 多人单张消耗的 P 点 |
108
108
  | `couponPrice` / `couponAskTimeout` | 提示词优化券单价(默认 3000,可被 `data/p-shop.json` 覆盖)与确认等待时间(秒) |
109
+ | `workflowConfirm` / `workflowConfirmTimeout` | 画图前先报点数明细并等用户确认(默认 `true` / 60 秒)。管理员免扣费不询问;平台不支持交互时自动跳过 |
109
110
  | `adminUsers` | 免 P 点管理员用户 ID |
110
111
 
111
112
  ### ⑥ 权限与日志
@@ -306,6 +307,26 @@ llmChannels:
306
307
  | `qwen_3_06b_base.safetensors` | `ComfyUI/models/text_encoders/` | 文本编码器,与 Base 模型共用 |
307
308
  | `qwen_image_vae.safetensors` | `ComfyUI/models/vae/` | VAE,与 Base 模型共用 |
308
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
+
309
330
  **8G 显存(如 4060)推荐 GGUF Q8_0**:需要先安装 [ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF) 插件。插件按 `unetName` 后缀自动选择加载器——`.gguf` 用 `UnetLoaderGGUF`,其余用 `UNETLoader`;也可用 `useGgufUnet` 强制指定。
310
331
 
311
332
  推荐参数:
@@ -417,6 +438,11 @@ workflowPresets:
417
438
  aliases: [基础, base] # 指令别名(可选)
418
439
  positivePromptNodeId: '6' # 节点 ID 可留空,插件会自动识别
419
440
  negativePromptNodeId: '7'
441
+ 换背景:
442
+ path: data/p-draw/workflows/12-new-scene.json
443
+ aliases: [换背景, scene]
444
+ price: 1400
445
+ warning: 该工作流对主体分离能力有限,可能与主体相连的部分一并保留;如效果不理想,建议更换构图或参考图后重试。
420
446
  极速4步:
421
447
  path: data/p-draw/workflows/03-dmdx.json
422
448
  aliases: [极速, fast]
@@ -426,6 +452,23 @@ workflowPresets:
426
452
  defaultWorkflowPreset: 基础文生图
427
453
  ```
428
454
 
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
+
429
472
  ### 指令用法
430
473
 
431
474
  ```
@@ -439,13 +482,13 @@ defaultWorkflowPreset: 基础文生图
439
482
  ```
440
483
  ✅ 基础文生图(别名:基础、base)
441
484
  节点 9 个 · 正面 #6 · 负面 #7 · 尺寸 #5
442
- ❌ 图生图(别名:i2i)
443
- 不可用:需要图片输入(LoadImage),当前版本不支持图生图
485
+ ✅ 图生图(别名:i2i) 🖼 需带参考图 1000 P/张
486
+ 节点 11 个 · 正面 #4 · 负面 #5 · 尺寸 #6
444
487
  ```
445
488
 
446
489
  选了不可用的预设会**直接拒绝并说明原因**,不会静默失败或跑错工作流。
447
490
 
448
- ### 10 个工作流的可用性对照
491
+ ### 12 个工作流的可用性对照
449
492
 
450
493
  | # | 工作流 | 节点 | 起点 | 当前版本 |
451
494
  |---|---|---|---|---|
@@ -453,12 +496,14 @@ defaultWorkflowPreset: 基础文生图
453
496
  | 03 | DMDX 4-Step Speed Run | 19 | 文本 | ⏳ 需 DMDX LoRA(`dmdx_student_final_comfy.safetensors`) |
454
497
  | 04 | Three-Stage High-Quality | 26 | 文本 | ✅ 可用(已转好并实测) |
455
498
  | 01 | 1.5x Upscale | 20 | 文本 | ✅ 可用(见下方依赖) |
456
- | 05 | Tiled Upscale | 45 | 图片 | ⏳ 已转好,需 `4x_NMKD-Siax_200k.pth`(放 `models/upscale_models`) |
499
+ | 05 | Tiled Upscale | 45 | 图片 | ✅ 可用(分块重绘放大,约 4 分钟,输出约 2 倍分辨率) |
457
500
  | 08 | T2I + ControlNet + Face/Hand Repair | 60 | 文本 + 控制图 | ✅ 可用(已裁成单输出;ControlNet 分支默认旁路,需检测器 + SAM 模型) |
458
- | 02 | ControlNet Precision Control | 32 | 图片 | ❌ 需图生图 |
501
+ | 02 | ControlNet Precision Control | 32 | 图片 | ✅ 可用(**VACE 深度控制**,需带参考图;依赖见下) |
459
502
  | 06 | i2i + ControlNet + Face/Hand Repair | 52 | 图片 | ✅ 可用(已裁成单输出;WD14 打标器已剔除,重绘幅度建议 0.4–0.6) |
460
503
  | 07 | Image-to-Image | 19 | 图片 | ✅ 可用(已裁成单输出;`Qwen3VLProcessor` 已剔除,需配 `denoise`) |
461
- | 10 | Anima-Edit LoRA / IC | 52 | 图片 | ❌ 需图生图 |
504
+ | 10 | Anima-Edit LoRA / IC | 52 | 图片 | ✅ 可用(**参考图编辑**:改服装/细节、保角色;背景基本沿用原图) |
505
+ | 11 | 换背景(自建) | 16 | 图片 | ✅ 可用(蒙版重绘:保留构图与主体,只重绘背景) |
506
+ | 12 | 换新场景(自建) | 23 | 图片 | ✅ 可用(抠主体 + 新场景生成 + 合成融合,构图也可换) |
462
507
 
463
508
  判断依据是自动体检的结果:**只要 JSON 里出现 `LoadImage` 一类节点,就判定为需要图片输入**。所以 05/08 到底能不能用,取决于你导出时是「从空 latent 开始」还是「从图开始」——`画图 工作流` 会直接告诉你。
464
509
 
@@ -472,12 +517,38 @@ defaultWorkflowPreset: 基础文生图
472
517
  | [Comfy-WaveSpeed](https://github.com/chengzeyi/Comfy-WaveSpeed) | `EnhancedLoadDiffusionModel` | 官方图的模型加载节点 |
473
518
  | [ControlAltAI-Nodes](https://github.com/gseth/ControlAltAI-Nodes) | `FluxResolutionNode` | 按兆像素/比例计算尺寸 |
474
519
  | [rgthree-comfy](https://github.com/rgthree/rgthree-comfy) | `Seed (rgthree)` | 08 等图的种子节点 |
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 的参考图编辑 |
522
+
523
+ > **02 的 VACE 深度控制要点**(实测得出,容易踩坑):
524
+ > 1. 权重:`TaihoC/Anima-ControlNet-VACE-Depth` 的 `anima-vace-depth.safetensors`(568MB)放 `models/controlnet`
525
+ > 2. 深度源用 `DepthAnythingV2Preprocessor`,**必须显式指定** `ckpt_name`,否则默认下 1.3GB 的 Large 模型
526
+ > 3. **正/负面条件必须从 `CLIPTextEncode` 直连采样器**,只取 `ACN_AdvancedControlNetApply` 的第 3 个输出(MODEL)。若把条件也走 ACN 的输出,等于双重注入,画面会严重过曝发白
527
+ > 4. `strength` 建议 0.8–0.9;`cfg≈3.0`、`beta57`、30 步
528
+
529
+ > **10 的参考图编辑要点**(实测得出):
530
+ > 1. 需要 `ComfyUI-Cosmos-Reference`(`ApplyCosmosReferenceLatent`)+ **`AnimaEditV1.safetensors`(210MB)编辑 LoRA**。只装前者会出满图条纹伪影——LoRA 才是"如何理解参考图"的部分
531
+ > 2. `ApplyCosmosReferenceLatent` 在 API 格式下的输入名是 `latent`(不是 `ref_latents`)
532
+ > 3. 参考图**必须先缩放到与生成完全相同的尺寸**(用 `ImageScale`),否则报 `Expected size 152 but got size 144`
533
+ > 4. ComfyUI 自带的 `ReferenceLatent`、Advanced-ControlNet 的 `ACN_ReferenceControlNet` 对 Anima **全部静默失效**(像素与无参考图完全一致),不要用
534
+ > 5. 能力边界:服装/发色/细节可改、角色可保留,但**背景场景会大幅沿用参考图**——想换场景用下面的「换背景」
535
+ >
536
+ > **只想换背景?用 `11-bg-swap.json`(不用串联两个工作流)**:
537
+ > 人物分割(`segm/person_yolov8m-seg.pt`)→ 合并蒙版 → 反相得背景蒙版 → 收缩 8px + 羽化 12px → `InpaintModelConditioning` 只重绘背景。
538
+ > 人物像素完全保留,背景按提示词全新生成。串联两个工作流会二次编解码掉画质,且白白多跑一遍。
539
+ >
540
+ > **换个完全不同的场景?用 `12-new-scene.json`(人物抠图 + 新场景合成)**:
541
+ > 人物分割 → 蒙版 → 把人物缩放到生成尺寸 → 另起一段纯文生图生成新场景 → `ImageCompositeMasked` 贴进去 → 再走一遍 `denoise 0.35` 融合光影。
542
+ > 和 11 的分工:**11 保留原构图只换背景(同一地点换氛围),12 把人物搬到全新场景(换地点)**。
543
+ > ⚠️ 已知限制:`person_yolov8m-seg` 会把人物和她相连的前景结构(例图里的石栏杆)当成一个整体,自动分割**分不开**;SAM 精修反而贴得更紧。要完全干净需要用户提供蒙版。
544
+ >
545
+ > **参数要点(实测踩过)**:`GrowMask` 的 `expand` 必须是**正值**(向人物内侧扩张)。用负值会在人物外圈留一圈原图 → 明显光晕。默认 `+10`,配合 `FeatherMask 8`。`SegmDetectorSEGS` 的 `dilation` 别开太大(10 会让人物蒙版往下渗、把前景结构一起保护住),默认 `6`。
475
546
 
476
547
  > `XB_UNetNameBroadcaster`(在 XB_ToolBox 里)依赖极重(easyocr / whisper / diffusers…),**不建议装**。它只是给模型加载节点传一个字符串,删掉该节点、直接在加载节点的下拉框里选模型即可。
477
548
 
478
549
  01 实测流程:装上 RES4LYF + Comfy-WaveSpeed + ControlAltAI-Nodes,删掉 `XB_UNetNameBroadcaster`,把模型选成自己的,导出 API 即可。**插件会自动把 `unetName` 注入模型节点**(见 `workflowOverrideModel`),所以后续换模型不用再改 JSON。
479
550
 
480
- 图生图能力(图片上传 + `LoadImage` 注入 + 重绘幅度)尚未实现,所以 ❌ 的四个目前只能等后续版本。
551
+ 图生图能力(图片上传 + `LoadImage` 注入 + 重绘幅度)已实现,所以上面 9 个都能用;只剩 10 还缺外部节点包。
481
552
 
482
553
  ## 注意
483
554
 
@@ -494,3 +565,48 @@ defaultWorkflowPreset: 基础文生图
494
565
  - **管理员在全局关闭时自动免费优化**(不耗券);`无优化` 原样模式不消耗、不询问。平台不支持交互确认时退回自动消耗逻辑。
495
566
  - **未使用优化的提示**:单人生图没走 LLM 优化时会明确提示原因——未配置 LLM、未消耗优化券、或 `无优化` 原样模式;多人指令强依赖 LLM 规划,未配置 `llmBaseUrl`/`llmModel` 时会直接提示「多人指令需要 LLM 规划」。
496
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 **均静默失效**,不要用。
604
+
605
+ ### 1.6.9
606
+
607
+ 纯文档补全,代码无改动:
608
+
609
+ - 「可用性对照」表加入 11(换背景)与 12(换新场景),表头改为 12 个工作流。
610
+ - 自定义节点包表补上 `ComfyUI-Cosmos-Reference`(10 的参考图编辑需要)。
611
+ - 新增「各工作流的额外模型」清单:9 个模型文件的目录、大小、用途一次列全。
612
+ - 补充两条易踩的坑:检测器类模型要放两份(Impact Pack 只读安装目录);`DepthAnythingV2Preprocessor` 不显式指定 `ckpt_name` 会去下 1.3GB 的 Large 版。