koishi-plugin-p-draw 1.6.7 → 1.6.8

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.8",
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
  ### ⑥ 权限与日志
@@ -417,6 +418,11 @@ workflowPresets:
417
418
  aliases: [基础, base] # 指令别名(可选)
418
419
  positivePromptNodeId: '6' # 节点 ID 可留空,插件会自动识别
419
420
  negativePromptNodeId: '7'
421
+ 换背景:
422
+ path: data/p-draw/workflows/12-new-scene.json
423
+ aliases: [换背景, scene]
424
+ price: 1400
425
+ warning: 该工作流对主体分离能力有限,可能与主体相连的部分一并保留;如效果不理想,建议更换构图或参考图后重试。
420
426
  极速4步:
421
427
  path: data/p-draw/workflows/03-dmdx.json
422
428
  aliases: [极速, fast]
@@ -426,6 +432,23 @@ workflowPresets:
426
432
  defaultWorkflowPreset: 基础文生图
427
433
  ```
428
434
 
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
+
429
452
  ### 指令用法
430
453
 
431
454
  ```
@@ -439,8 +462,8 @@ defaultWorkflowPreset: 基础文生图
439
462
  ```
440
463
  ✅ 基础文生图(别名:基础、base)
441
464
  节点 9 个 · 正面 #6 · 负面 #7 · 尺寸 #5
442
- ❌ 图生图(别名:i2i)
443
- 不可用:需要图片输入(LoadImage),当前版本不支持图生图
465
+ ✅ 图生图(别名:i2i) 🖼 需带参考图 1000 P/张
466
+ 节点 11 个 · 正面 #4 · 负面 #5 · 尺寸 #6
444
467
  ```
445
468
 
446
469
  选了不可用的预设会**直接拒绝并说明原因**,不会静默失败或跑错工作流。
@@ -453,12 +476,12 @@ defaultWorkflowPreset: 基础文生图
453
476
  | 03 | DMDX 4-Step Speed Run | 19 | 文本 | ⏳ 需 DMDX LoRA(`dmdx_student_final_comfy.safetensors`) |
454
477
  | 04 | Three-Stage High-Quality | 26 | 文本 | ✅ 可用(已转好并实测) |
455
478
  | 01 | 1.5x Upscale | 20 | 文本 | ✅ 可用(见下方依赖) |
456
- | 05 | Tiled Upscale | 45 | 图片 | ⏳ 已转好,需 `4x_NMKD-Siax_200k.pth`(放 `models/upscale_models`) |
479
+ | 05 | Tiled Upscale | 45 | 图片 | ✅ 可用(分块重绘放大,约 4 分钟,输出约 2 倍分辨率) |
457
480
  | 08 | T2I + ControlNet + Face/Hand Repair | 60 | 文本 + 控制图 | ✅ 可用(已裁成单输出;ControlNet 分支默认旁路,需检测器 + SAM 模型) |
458
- | 02 | ControlNet Precision Control | 32 | 图片 | ❌ 需图生图 |
481
+ | 02 | ControlNet Precision Control | 32 | 图片 | ✅ 可用(**VACE 深度控制**,需带参考图;依赖见下) |
459
482
  | 06 | i2i + ControlNet + Face/Hand Repair | 52 | 图片 | ✅ 可用(已裁成单输出;WD14 打标器已剔除,重绘幅度建议 0.4–0.6) |
460
483
  | 07 | Image-to-Image | 19 | 图片 | ✅ 可用(已裁成单输出;`Qwen3VLProcessor` 已剔除,需配 `denoise`) |
461
- | 10 | Anima-Edit LoRA / IC | 52 | 图片 | ❌ 需图生图 |
484
+ | 10 | Anima-Edit LoRA / IC | 52 | 图片 | ✅ 可用(**参考图编辑**:改服装/细节、保角色;背景基本沿用原图) |
462
485
 
463
486
  判断依据是自动体检的结果:**只要 JSON 里出现 `LoadImage` 一类节点,就判定为需要图片输入**。所以 05/08 到底能不能用,取决于你导出时是「从空 latent 开始」还是「从图开始」——`画图 工作流` 会直接告诉你。
464
487
 
@@ -472,12 +495,37 @@ defaultWorkflowPreset: 基础文生图
472
495
  | [Comfy-WaveSpeed](https://github.com/chengzeyi/Comfy-WaveSpeed) | `EnhancedLoadDiffusionModel` | 官方图的模型加载节点 |
473
496
  | [ControlAltAI-Nodes](https://github.com/gseth/ControlAltAI-Nodes) | `FluxResolutionNode` | 按兆像素/比例计算尺寸 |
474
497
  | [rgthree-comfy](https://github.com/rgthree/rgthree-comfy) | `Seed (rgthree)` | 08 等图的种子节点 |
498
+ | [ComfyUI-Advanced-ControlNet-Anima](https://github.com/TaihoC/ComfyUI-Advanced-ControlNet-Anima)(`feat/anima-vace-controlnet` 分支) | `ACN_ControlNetLoaderAdvanced` / `ACN_AdvancedControlNetApply` | 02 的 VACE 深度控制 |
499
+
500
+ > **02 的 VACE 深度控制要点**(实测得出,容易踩坑):
501
+ > 1. 权重:`TaihoC/Anima-ControlNet-VACE-Depth` 的 `anima-vace-depth.safetensors`(568MB)放 `models/controlnet`
502
+ > 2. 深度源用 `DepthAnythingV2Preprocessor`,**必须显式指定** `ckpt_name`,否则默认下 1.3GB 的 Large 模型
503
+ > 3. **正/负面条件必须从 `CLIPTextEncode` 直连采样器**,只取 `ACN_AdvancedControlNetApply` 的第 3 个输出(MODEL)。若把条件也走 ACN 的输出,等于双重注入,画面会严重过曝发白
504
+ > 4. `strength` 建议 0.8–0.9;`cfg≈3.0`、`beta57`、30 步
505
+
506
+ > **10 的参考图编辑要点**(实测得出):
507
+ > 1. 需要 `ComfyUI-Cosmos-Reference`(`ApplyCosmosReferenceLatent`)+ **`AnimaEditV1.safetensors`(210MB)编辑 LoRA**。只装前者会出满图条纹伪影——LoRA 才是"如何理解参考图"的部分
508
+ > 2. `ApplyCosmosReferenceLatent` 在 API 格式下的输入名是 `latent`(不是 `ref_latents`)
509
+ > 3. 参考图**必须先缩放到与生成完全相同的尺寸**(用 `ImageScale`),否则报 `Expected size 152 but got size 144`
510
+ > 4. ComfyUI 自带的 `ReferenceLatent`、Advanced-ControlNet 的 `ACN_ReferenceControlNet` 对 Anima **全部静默失效**(像素与无参考图完全一致),不要用
511
+ > 5. 能力边界:服装/发色/细节可改、角色可保留,但**背景场景会大幅沿用参考图**——想换场景用下面的「换背景」
512
+ >
513
+ > **只想换背景?用 `11-bg-swap.json`(不用串联两个工作流)**:
514
+ > 人物分割(`segm/person_yolov8m-seg.pt`)→ 合并蒙版 → 反相得背景蒙版 → 收缩 8px + 羽化 12px → `InpaintModelConditioning` 只重绘背景。
515
+ > 人物像素完全保留,背景按提示词全新生成。串联两个工作流会二次编解码掉画质,且白白多跑一遍。
516
+ >
517
+ > **换个完全不同的场景?用 `12-new-scene.json`(人物抠图 + 新场景合成)**:
518
+ > 人物分割 → 蒙版 → 把人物缩放到生成尺寸 → 另起一段纯文生图生成新场景 → `ImageCompositeMasked` 贴进去 → 再走一遍 `denoise 0.35` 融合光影。
519
+ > 和 11 的分工:**11 保留原构图只换背景(同一地点换氛围),12 把人物搬到全新场景(换地点)**。
520
+ > ⚠️ 已知限制:`person_yolov8m-seg` 会把人物和她相连的前景结构(例图里的石栏杆)当成一个整体,自动分割**分不开**;SAM 精修反而贴得更紧。要完全干净需要用户提供蒙版。
521
+ >
522
+ > **参数要点(实测踩过)**:`GrowMask` 的 `expand` 必须是**正值**(向人物内侧扩张)。用负值会在人物外圈留一圈原图 → 明显光晕。默认 `+10`,配合 `FeatherMask 8`。`SegmDetectorSEGS` 的 `dilation` 别开太大(10 会让人物蒙版往下渗、把前景结构一起保护住),默认 `6`。
475
523
 
476
524
  > `XB_UNetNameBroadcaster`(在 XB_ToolBox 里)依赖极重(easyocr / whisper / diffusers…),**不建议装**。它只是给模型加载节点传一个字符串,删掉该节点、直接在加载节点的下拉框里选模型即可。
477
525
 
478
526
  01 实测流程:装上 RES4LYF + Comfy-WaveSpeed + ControlAltAI-Nodes,删掉 `XB_UNetNameBroadcaster`,把模型选成自己的,导出 API 即可。**插件会自动把 `unetName` 注入模型节点**(见 `workflowOverrideModel`),所以后续换模型不用再改 JSON。
479
527
 
480
- 图生图能力(图片上传 + `LoadImage` 注入 + 重绘幅度)尚未实现,所以 ❌ 的四个目前只能等后续版本。
528
+ 图生图能力(图片上传 + `LoadImage` 注入 + 重绘幅度)已实现,所以上面 9 个都能用;只剩 10 还缺外部节点包。
481
529
 
482
530
  ## 注意
483
531
 
@@ -494,3 +542,39 @@ defaultWorkflowPreset: 基础文生图
494
542
  - **管理员在全局关闭时自动免费优化**(不耗券);`无优化` 原样模式不消耗、不询问。平台不支持交互确认时退回自动消耗逻辑。
495
543
  - **未使用优化的提示**:单人生图没走 LLM 优化时会明确提示原因——未配置 LLM、未消耗优化券、或 `无优化` 原样模式;多人指令强依赖 LLM 规划,未配置 `llmBaseUrl`/`llmModel` 时会直接提示「多人指令需要 LLM 规划」。
496
544
  - 本地模型不一定认识新角色,可用 `添加角色` 手动补充角色 tags。
545
+
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` | 确认等待秒数(全局统一) |
576
+
577
+ **文档**
578
+
579
+ - 补充 02(VACE 深度控制)、05(分块放大)、10(参考图编辑)、11(换背景)、12(新场景合成)的实测结论、依赖与踩坑要点。
580
+ - 说明 ComfyUI 自带的 `ReferenceLatent` 与 Advanced-ControlNet 的 `ACN_ReferenceControlNet` 对 Anima **均静默失效**,不要用。