koishi-plugin-p-draw 1.6.6 → 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
 
@@ -189,7 +191,10 @@ exports.Config = Schema.object({
189
191
  samplerName: Schema.string().description('该预设固定采样器'),
190
192
  scheduler: Schema.string().description('该预设固定调度器'),
191
193
  overrideParameters: Schema.boolean().description('用上面的参数覆盖工作流内取值'),
194
+ denoise: Schema.number().description('图生图的重绘幅度 0–1(1=整张重绘)。只对需要图片输入的工作流有意义'),
195
+ imageNodeId: Schema.string().description('图片输入节点 ID(LoadImage)。留空则自动使用工作流里的图片节点'),
192
196
  price: Schema.number().description('该预设每张消耗的 P 点(留空沿用全局 price / multiPrice)'),
197
+ warning: Schema.string().description('该预设被使用时报给用户的提醒(留空不提醒),例如换背景类的能力边界说明'),
193
198
  overrideModel: Schema.boolean().description('是否把 unetName 写进这个工作流的模型节点(留空沿用全局)'),
194
199
  modelLoaderNodeId: Schema.string().description('该预设的模型加载节点 ID(留空沿用全局)'),
195
200
  }).description('预设')).default({}).description('工作流预设:key=预设名。指令里用 `--工作流 <名称>` 或名称/别名开头选择(如 `画图 极速:1girl`)'),
@@ -273,9 +278,11 @@ const {
273
278
  MULTI_PERSON_NEGATIVE_TAGS, buildMultiPersonPlanPrompt, parseMultiPersonPlan,
274
279
  renderMultiPersonCharacter, multiPersonAutoSize,
275
280
  } = require('./lib/multi')
281
+ const { fileURLToPath } = require('url')
276
282
  const { buildComfyClient } = require('./lib/http')
277
283
  const { createOutboundFetch, normalizeProxyUrl, proxySupportAvailable } = require('./lib/net')
278
284
  const { buildLlmChain, hasLlm, buildChatBody, runLlmChain } = require('./lib/llm')
285
+ const { uploadImageToComfy, decodeDataUrl, guessContentType } = require('./lib/image')
279
286
  exports.apply = async function apply(ctx, rawConfig) {
280
287
  // 配置统一摊平成扁平 cfg:同时接受新的分组写法和老版本的扁平写法
281
288
  const { config: cfg, legacy } = normalizeConfig(rawConfig)
@@ -423,8 +430,7 @@ exports.apply = async function apply(ctx, rawConfig) {
423
430
  }
424
431
 
425
432
  // 体检:这个预设现在能不能真的跑(能否从纯文本启动)
426
- function inspectPreset(preset) {
427
- return inspectWorkflowFile(preset.path, {
433
+ function inspectPreset(preset) { return inspectWorkflowFile(preset.path, {
428
434
  positivePromptNodeId: preset.positivePromptNodeId || '',
429
435
  negativePromptNodeId: preset.negativePromptNodeId || '',
430
436
  resolutionNodeId: preset.resolutionNodeId || '',
@@ -444,6 +450,81 @@ exports.apply = async function apply(ctx, rawConfig) {
444
450
  return { ok: true, preset }
445
451
  }
446
452
 
453
+ // ---------------- 图生图:从消息取图 → 下载 → 上传到 ComfyUI ----------------
454
+
455
+ // 消息里带的图片地址(http / file / base64 / data: 都可能有)
456
+ function messageImageSources(session) {
457
+ const sources = []
458
+ try {
459
+ const message = session?.event?.message
460
+ if (!message) return sources
461
+ for (const element of h.select(message, 'img')) {
462
+ const src = element?.attrs?.src || element?.attrs?.url
463
+ if (src) sources.push(String(src))
464
+ }
465
+ } catch (e) { /* ignore */ }
466
+ return sources
467
+ }
468
+
469
+ async function fetchImageBuffer(src) {
470
+ const text = String(src || '')
471
+ const dataUrl = decodeDataUrl(text)
472
+ if (dataUrl) return dataUrl
473
+ if (/^base64:\/\//i.test(text)) {
474
+ const decoded = decodeDataUrl('data:image/png;base64,' + text.slice('base64://'.length))
475
+ if (decoded) return decoded
476
+ throw new Error('base64 图片解码失败')
477
+ }
478
+ if (/^file:\/\//i.test(text)) {
479
+ const filePath = fileURLToPath(text)
480
+ return { buffer: await fsp.readFile(filePath), contentType: guessContentType(filePath) }
481
+ }
482
+ if (/^https?:\/\//i.test(text)) {
483
+ const res = await outboundFetch(text, {})
484
+ if (!res.ok) throw new Error(`HTTP ${res.status}`)
485
+ const buffer = Buffer.from(await res.arrayBuffer())
486
+ const headerType = res.headers && typeof res.headers.get === 'function' ? res.headers.get('content-type') : ''
487
+ return { buffer, contentType: headerType || guessContentType(text) }
488
+ }
489
+ throw new Error('不支持的图片来源')
490
+ }
491
+
492
+ // 判断当前要用的工作流是否吃图片,并把消息里的图准备好
493
+ async function prepareImageInputs(session, preset) {
494
+ let needsImage = false
495
+ try {
496
+ if (preset) {
497
+ needsImage = Boolean(inspectPreset(preset)?.analysis?.imageInputClasses?.length)
498
+ } else if (cfg.customWorkflowEnabled && cfg.customWorkflowPath) {
499
+ const report = inspectWorkflowFile(cfg.customWorkflowPath, cfg, workflowOpts())
500
+ needsImage = Boolean(report?.analysis?.imageInputClasses?.length)
501
+ }
502
+ } catch (e) { /* 读不到就当不需要 */ }
503
+
504
+ if (!needsImage) return { ok: true, files: [], needsImage: false }
505
+
506
+ const sources = messageImageSources(session)
507
+ if (!sources.length) {
508
+ return {
509
+ ok: false,
510
+ needsImage: true,
511
+ message: '这个工作流需要图片输入:请把参考图和指令一起发送(例如:发一张图 + 「画图 重绘:保持角色,换成水彩风格」)。',
512
+ }
513
+ }
514
+
515
+ const files = []
516
+ for (const src of sources) {
517
+ try {
518
+ const { buffer, contentType } = await fetchImageBuffer(src)
519
+ files.push(await uploadImageToComfy(outboundFetch, baseUrl(), { buffer, contentType }))
520
+ } catch (e) {
521
+ return { ok: false, needsImage: true, message: `图片处理失败:${e.message}` }
522
+ }
523
+ }
524
+ if (cfg.outputLogs) logger.info(`[p-draw] 已上传 ${files.length} 张参考图:${files.join(', ')}`)
525
+ return { ok: true, files, needsImage: true }
526
+ }
527
+
447
528
  // A4:自定义工作流(Aesthetic 1.1)默认跳过质量前缀注入
448
529
  function shouldSkipQualityPrefix() {
449
530
  return Boolean(cfg.customWorkflowEnabled && cfg.skipQualityPrefixForCustomWorkflow)
@@ -653,7 +734,8 @@ exports.apply = async function apply(ctx, rawConfig) {
653
734
  const aliases = (preset.aliases || []).length ? `(别名:${preset.aliases.join('、')})` : ''
654
735
  const unit = presetPrice(preset)
655
736
  const priceTag = unit != null ? ` ${unit} P/张` : ' 默认价'
656
- lines.push(`${report.ok ? '✅' : '❌'} ${preset.name}${aliases}${priceTag}`)
737
+ const imageTag = report.needsImage ? ' 🖼 需带参考图' : ''
738
+ lines.push(`${report.ok ? '✅' : '❌'} ${preset.name}${aliases}${imageTag}${priceTag}`)
657
739
  if (report.ok) {
658
740
  const analysis = report.analysis
659
741
  const pos = report.targets.positive.map(id => `#${id}`).join('、')
@@ -1005,6 +1087,10 @@ exports.apply = async function apply(ctx, rawConfig) {
1005
1087
  modelParams: overrideKeys,
1006
1088
  overrideModel: baseCfg.workflowOverrideModel !== false,
1007
1089
  modelLoaderNodeId: baseCfg.modelLoaderNodeId || '',
1090
+ images: overrides.images || [],
1091
+ denoise: overrides.denoise != null ? overrides.denoise
1092
+ : (preset && preset.denoise != null && preset.denoise !== '' ? Number(preset.denoise) : undefined),
1093
+ imageNodeId: (preset && preset.imageNodeId) || '',
1008
1094
  }))
1009
1095
 
1010
1096
  const clientId = crypto.randomUUID()
@@ -2246,10 +2332,16 @@ exports.apply = async function apply(ctx, rawConfig) {
2246
2332
  // 预设可单独定价,未配置则用全局 price
2247
2333
  const unitPrice = presetPrice(activePreset) ?? Math.max(0, Number(cfg.price) || 0)
2248
2334
  // 命令级参数优先于预设 / modelParams / 全局配置(见 runComfyGenerate)
2335
+ // 图生图:工作流吃图时先把消息里的图下好、传到 ComfyUI;没带图就直接拦下(不扣点)
2336
+ const imagePlan = await prepareImageInputs(session, activePreset)
2337
+ if (!imagePlan.ok) return imagePlan.message
2338
+
2249
2339
  const tuningOverrides = Object.assign(
2250
2340
  activePreset ? { preset: activePreset } : {},
2251
2341
  parsedTuning.steps != null ? { steps: parsedTuning.steps } : {},
2252
2342
  parsedTuning.cfg != null ? { cfg: parsedTuning.cfg } : {},
2343
+ parsedTuning.denoise != null ? { denoise: parsedTuning.denoise } : {},
2344
+ imagePlan.files.length ? { images: imagePlan.files } : {},
2253
2345
  )
2254
2346
  if (cfg.outputLogs && (parsedTuning.steps != null || parsedTuning.cfg != null)) {
2255
2347
  logger.info(`[p-draw] 命令级参数覆盖:steps=${parsedTuning.steps ?? '-'} cfg=${parsedTuning.cfg ?? '-'}`)
@@ -2268,6 +2360,26 @@ exports.apply = async function apply(ctx, rawConfig) {
2268
2360
  const userNegativePrompt = promptSections.negative
2269
2361
  if (!userPrompt) return session.text('.no-prompt')
2270
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
+
2271
2383
  // ComfyUI 就绪
2272
2384
  const ready = await ensureComfyuiReady()
2273
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/image.js ADDED
@@ -0,0 +1,81 @@
1
+ // 图生图用的图片搬运:把聊天里的图片下载下来,再上传到 ComfyUI 的 input 目录。
2
+ // 只做纯逻辑 + 一个注入的 fetch,方便单测。
3
+
4
+ function guessContentType(name) {
5
+ const ext = String(name || '').toLowerCase().split('.').pop()
6
+ if (ext === 'jpg' || ext === 'jpeg') return 'image/jpeg'
7
+ if (ext === 'webp') return 'image/webp'
8
+ if (ext === 'gif') return 'image/gif'
9
+ if (ext === 'bmp') return 'image/bmp'
10
+ return 'image/png'
11
+ }
12
+
13
+ // data:image/png;base64,xxxx → { buffer, contentType }
14
+ function decodeDataUrl(source) {
15
+ const text = String(source || '')
16
+ const match = text.match(/^data:([^;,]+)?(;base64)?,([\s\S]*)$/i)
17
+ if (!match) return null
18
+ const contentType = match[1] || 'image/png'
19
+ const isBase64 = Boolean(match[2])
20
+ try {
21
+ const buffer = isBase64
22
+ ? Buffer.from(match[3], 'base64')
23
+ : Buffer.from(decodeURIComponent(match[3]), 'binary')
24
+ return { buffer, contentType }
25
+ } catch (e) {
26
+ return null
27
+ }
28
+ }
29
+
30
+ // 组装 multipart/form-data(不引第三方依赖)
31
+ function buildMultipart(fields, file) {
32
+ const boundary = `----pdraw${Date.now().toString(16)}${Math.random().toString(16).slice(2, 8)}`
33
+ const chunks = []
34
+ for (const [name, value] of Object.entries(fields || {})) {
35
+ chunks.push(Buffer.from(
36
+ `--${boundary}\r\nContent-Disposition: form-data; name="${name}"\r\n\r\n${value}\r\n`,
37
+ 'utf8',
38
+ ))
39
+ }
40
+ const contentType = file.contentType || guessContentType(file.filename)
41
+ chunks.push(Buffer.from(
42
+ `--${boundary}\r\nContent-Disposition: form-data; name="image"; filename="${file.filename}"\r\nContent-Type: ${contentType}\r\n\r\n`,
43
+ 'utf8',
44
+ ))
45
+ chunks.push(file.buffer)
46
+ chunks.push(Buffer.from(`\r\n--${boundary}--\r\n`, 'utf8'))
47
+ return { body: Buffer.concat(chunks), contentType: `multipart/form-data; boundary=${boundary}` }
48
+ }
49
+
50
+ // 上传到 ComfyUI,返回 LoadImage 节点可直接用的文件名(可能带子目录)
51
+ async function uploadImageToComfy(fetchImpl, baseUrl, { buffer, filename, contentType, subfolder = 'pdraw', overwrite = 'true' }) {
52
+ if (!Buffer.isBuffer(buffer) || !buffer.length) throw new Error('图片内容为空')
53
+ // 没给文件名时生成唯一名,避免并发时互相覆盖
54
+ const fallback = `pdraw_${Date.now()}_${Math.random().toString(16).slice(2, 8)}.png`
55
+ const safeName = String(filename || fallback).replace(/[\\/:*?"<>|]/g, '_')
56
+ const { body, contentType: headerValue } = buildMultipart(
57
+ { type: 'input', subfolder, overwrite },
58
+ { buffer, filename: safeName, contentType },
59
+ )
60
+ const res = await fetchImpl(`${String(baseUrl).replace(/\/+$/, '')}/upload/image`, {
61
+ method: 'POST',
62
+ headers: { 'Content-Type': headerValue },
63
+ body,
64
+ })
65
+ if (!res.ok) {
66
+ const detail = await res.text().catch(() => '')
67
+ throw new Error(`上传图片失败:HTTP ${res.status}${detail ? ' ' + detail.slice(0, 120) : ''}`)
68
+ }
69
+ const data = await res.json()
70
+ const name = data && data.name
71
+ if (!name) throw new Error('上传图片失败:ComfyUI 没有返回文件名')
72
+ const sub = data.subfolder ? String(data.subfolder).replace(/^\/+|\/+$/g, '') : ''
73
+ return sub ? `${sub}/${name}` : name
74
+ }
75
+
76
+ module.exports = {
77
+ guessContentType,
78
+ decodeDataUrl,
79
+ buildMultipart,
80
+ uploadImageToComfy,
81
+ }
package/lib/parse.js CHANGED
@@ -159,6 +159,8 @@ const CFG_LIMIT = { min: 0, max: 30 }
159
159
 
160
160
  const STEPS_PATTERN = /(?<!\S)--(?:steps|步数)\s*(?:=|=|:|:)?\s*(\d+)/i
161
161
  const CFG_PATTERN = /(?<!\S)--(?:cfg|强度)\s*(?:=|=|:|:)?\s*(\d+(?:\.\d+)?)/i
162
+ // 重绘幅度(图生图用):--denoise 0.6 / --重绘 0.6 / --重绘幅度 0.6
163
+ const DENOISE_PATTERN = /(?<!\S)--(?:denoise|重绘幅度|重绘率|重绘)\s*(?:=|=|:|:)?\s*(\d+(?:\.\d+)?)/i
162
164
 
163
165
  // 与 parseSeed 一致的剥离清理:去掉 token 后收拢多余分隔符与空白
164
166
  function stripMatchedToken(prompt, match) {
@@ -188,7 +190,15 @@ function parseStepsCfg(text) {
188
190
  if (Number.isFinite(value) && value >= CFG_LIMIT.min) cfg = Math.min(value, CFG_LIMIT.max)
189
191
  }
190
192
 
191
- return { steps, cfg, prompt }
193
+ let denoise = null
194
+ const denoiseMatch = prompt.match(DENOISE_PATTERN)
195
+ if (denoiseMatch) {
196
+ const value = Number(denoiseMatch[1])
197
+ prompt = stripMatchedToken(prompt, denoiseMatch)
198
+ if (Number.isFinite(value) && value >= 0) denoise = Math.min(value, 1)
199
+ }
200
+
201
+ return { steps, cfg, denoise, prompt }
192
202
  }
193
203
 
194
204
  // 工作流预设选择:--工作流 名称 / --workflow 名称,或开头裸写名称/别名(如「极速:描述」)
@@ -348,6 +358,7 @@ module.exports = {
348
358
  CFG_LIMIT,
349
359
  STEPS_PATTERN,
350
360
  CFG_PATTERN,
361
+ DENOISE_PATTERN,
351
362
  stripMatchedToken,
352
363
  parseStepsCfg,
353
364
  matchPreset,
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}`)
@@ -343,6 +360,18 @@ function customWorkflow(cfg, prompt, negativePrompt, width, height, steps, cfgVa
343
360
  // 模型名注入:让 unetName / p-draw 模型 对自定义工作流也生效
344
361
  const modelResult = applyModelOverride(workflow, cfg, opts)
345
362
 
363
+ // 图片输入(图生图):工作流需要图却没给 → 明确报错,不要静默跑出个错的图
364
+ const imageResult = applyImageInputs(workflow, opts.images, opts)
365
+ if (imageResult.reason === 'missing-image') {
366
+ const names = imageResult.loaders.map(loader => `#${loader.id} ${loader.classType}`).join('、')
367
+ throw new Error(`这个工作流需要图片输入(${names}),请随指令带一张参考图再发送`)
368
+ }
369
+ if (String(imageResult.reason).startsWith('node-not-found')) {
370
+ throw new Error(`配置的图片节点 ID「${opts.imageNodeId}」不存在于工作流中`)
371
+ }
372
+ // 重绘幅度:只在显式给出时覆盖,保留多段工作流各段自己的 denoise
373
+ applyDenoise(workflow, opts.denoise)
374
+
346
375
  for (const nodeId of targets.positive) {
347
376
  if (workflow[nodeId] && workflow[nodeId].inputs) workflow[nodeId].inputs.text = prompt
348
377
  }
@@ -463,6 +492,69 @@ function applyModelOverride(workflow, cfg, opts = {}) {
463
492
  return { applied: true, loaders, targets, model, reason: '' }
464
493
  }
465
494
 
495
+ // 体检:这个工作流能不能在「纯文本」模式下跑,需要什么额外输入
496
+ // 找出工作流里的图片输入节点(LoadImage 等)
497
+ function findImageLoaderNodes(workflow) {
498
+ const found = []
499
+ for (const [nodeId, node] of Object.entries(workflow)) {
500
+ if (!node || typeof node !== 'object') continue
501
+ const classType = String(node.class_type || '')
502
+ if (!IMAGE_INPUT_RE.test(classType)) continue
503
+ const inputs = node.inputs
504
+ if (!inputs || typeof inputs !== 'object') continue
505
+ const inputName = 'image' in inputs
506
+ ? 'image'
507
+ : (Object.keys(inputs).find(key => typeof inputs[key] === 'string') || 'image')
508
+ found.push({ id: String(nodeId), classType, inputName })
509
+ }
510
+ return found
511
+ }
512
+
513
+ // 把已上传到 ComfyUI 的图片文件名写进 LoadImage 节点。
514
+ // 多个 LoadImage 时按顺序分配;imageNodeId 可指定只改一个。
515
+ function applyImageInputs(workflow, images, opts = {}) {
516
+ const loaders = findImageLoaderNodes(workflow)
517
+ const provided = (Array.isArray(images) ? images : []).filter(Boolean)
518
+
519
+ if (!loaders.length) {
520
+ return { applied: false, loaders, targets: [], reason: provided.length ? 'no-loader' : 'not-needed' }
521
+ }
522
+ if (!provided.length) {
523
+ return { applied: false, loaders, targets: [], reason: 'missing-image' }
524
+ }
525
+
526
+ const pinned = cleanNodeId(opts.imageNodeId)
527
+ let targets = loaders
528
+ if (pinned) {
529
+ targets = loaders.filter(loader => loader.id === pinned)
530
+ if (!targets.length) return { applied: false, loaders, targets: [], reason: `node-not-found:${pinned}` }
531
+ }
532
+
533
+ targets.forEach((loader, index) => {
534
+ const value = provided[index] || provided[provided.length - 1]
535
+ if (value) workflow[loader.id].inputs[loader.inputName] = value
536
+ })
537
+ return { applied: true, loaders, targets, reason: '' }
538
+ }
539
+
540
+ // 重绘幅度:只写给采样器节点(有 denoise 输入的),用于图生图。
541
+ // 不传就不动 —— 多段工作流各段自己的 denoise 才不会被压平。
542
+ function applyDenoise(workflow, denoise) {
543
+ if (denoise === undefined || denoise === null || denoise === '') return { applied: false, count: 0 }
544
+ const value = Number(denoise)
545
+ if (!Number.isFinite(value)) return { applied: false, count: 0 }
546
+ let count = 0
547
+ for (const node of Object.values(workflow)) {
548
+ if (!node || typeof node !== 'object') continue
549
+ if (!/sampler/i.test(String(node.class_type || ''))) continue
550
+ const inputs = node.inputs
551
+ if (!inputs || typeof inputs !== 'object' || !('denoise' in inputs)) continue
552
+ inputs.denoise = value
553
+ count += 1
554
+ }
555
+ return { applied: count > 0, count }
556
+ }
557
+
466
558
  // 体检:这个工作流能不能在「纯文本」模式下跑,需要什么额外输入
467
559
  function analyzeWorkflow(workflow) {
468
560
  const classes = Object.values(workflow).map(node => String((node && node.class_type) || ''))
@@ -505,13 +597,16 @@ function inspectWorkflowFile(workflowPath, cfg = {}, opts = {}) {
505
597
  report.analysis = analyzeWorkflow(workflow)
506
598
  const targets = resolveCustomNodeTargets(workflow, cfg)
507
599
  report.targets = targets
600
+ // 需要图片输入不算「不可用」——现在支持图生图,只要指令里带图就能跑
601
+ report.needsImage = report.analysis.imageInputClasses.length > 0
508
602
  if (targets.errors.length) {
509
603
  report.error = targets.errors.join(';')
510
604
  return report
511
605
  }
512
- if (!report.analysis.canRunTextOnly) {
606
+ // 图生图工作流的 latent 来自 VAEEncode,没有空 latent 节点,不能因此判为不可用
607
+ if (!report.analysis.hasLatentStart && !report.needsImage) {
513
608
  report.error = report.analysis.requires.length
514
- ? `需要${report.analysis.requires.join('、')},当前版本不支持图生图`
609
+ ? `需要${report.analysis.requires.join('、')},且工作流里找不到可写入尺寸的 latent 节点`
515
610
  : '工作流里找不到可写入尺寸的 latent 节点(缺少文生图起点)'
516
611
  return report
517
612
  }
@@ -558,6 +653,9 @@ module.exports = {
558
653
  MODEL_LOADER_INPUTS,
559
654
  findModelLoaders,
560
655
  applyModelOverride,
656
+ findImageLoaderNodes,
657
+ applyImageInputs,
658
+ applyDenoise,
561
659
  analyzeWorkflow,
562
660
  inspectWorkflowFile,
563
661
  }
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.6",
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
  ### ⑥ 权限与日志
@@ -384,6 +385,24 @@ p-draw:
384
385
  - [ ] 替换工作流 JSON 后,在 `customWorkflowReloadOnChange: true` 下无需重启插件即生效。
385
386
  - [ ] `p-draw 诊断` 能显示实际工作流路径、更新时间与实际解析到的节点 ID。
386
387
 
388
+ ### 图生图(带参考图)
389
+
390
+ 需要图片输入的工作流(图生图、分块放大、ControlNet)现在可以直接用:**把参考图和指令一起发**即可。
391
+
392
+ ```
393
+ [发一张图] + 画图 重绘:保持角色,换成水彩风格
394
+ ```
395
+
396
+ 插件会自动完成:从消息里取图 → 下载 → 上传到 ComfyUI 的 `input/pdraw/` → 把返回的文件名写进工作流的 `LoadImage` 节点。
397
+
398
+ - **没带图时会直接拒绝并提示**,既不扣点也不会跑出一张错的图
399
+ - `--重绘 0.6` / `--重绘幅度 0.6` 可临时指定重绘幅度(0–1,越大改动越大)
400
+ - 预设里可固定 `denoise`(重绘幅度)与 `imageNodeId`(多个 `LoadImage` 时指定改哪个)
401
+ - 传多张图时按顺序分配给多个 `LoadImage` 节点(ControlNet 多分支用)
402
+ - 上传文件名带时间戳,并发不会互相覆盖
403
+
404
+ `画图 工作流` 里会用「🖼 需带参考图」标出这类预设。
405
+
387
406
  ## 工作流预设
388
407
 
389
408
  > 下面片段按字段名展示,实际写在 `workflow:` 分组下(见「配置说明」的分组示例)。
@@ -399,6 +418,11 @@ workflowPresets:
399
418
  aliases: [基础, base] # 指令别名(可选)
400
419
  positivePromptNodeId: '6' # 节点 ID 可留空,插件会自动识别
401
420
  negativePromptNodeId: '7'
421
+ 换背景:
422
+ path: data/p-draw/workflows/12-new-scene.json
423
+ aliases: [换背景, scene]
424
+ price: 1400
425
+ warning: 该工作流对主体分离能力有限,可能与主体相连的部分一并保留;如效果不理想,建议更换构图或参考图后重试。
402
426
  极速4步:
403
427
  path: data/p-draw/workflows/03-dmdx.json
404
428
  aliases: [极速, fast]
@@ -408,6 +432,23 @@ workflowPresets:
408
432
  defaultWorkflowPreset: 基础文生图
409
433
  ```
410
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
+
411
452
  ### 指令用法
412
453
 
413
454
  ```
@@ -421,8 +462,8 @@ defaultWorkflowPreset: 基础文生图
421
462
  ```
422
463
  ✅ 基础文生图(别名:基础、base)
423
464
  节点 9 个 · 正面 #6 · 负面 #7 · 尺寸 #5
424
- ❌ 图生图(别名:i2i)
425
- 不可用:需要图片输入(LoadImage),当前版本不支持图生图
465
+ ✅ 图生图(别名:i2i) 🖼 需带参考图 1000 P/张
466
+ 节点 11 个 · 正面 #4 · 负面 #5 · 尺寸 #6
426
467
  ```
427
468
 
428
469
  选了不可用的预设会**直接拒绝并说明原因**,不会静默失败或跑错工作流。
@@ -431,16 +472,16 @@ defaultWorkflowPreset: 基础文生图
431
472
 
432
473
  | # | 工作流 | 节点 | 起点 | 当前版本 |
433
474
  |---|---|---|---|---|
434
- | 09 | Text-to-Image Baseline | 17 | 文本 | ✅ 可用 |
435
- | 03 | DMDX 4-Step Speed Run | 19 | 文本 | ✅ 可用(设 `steps: 4`、低 CFG) |
436
- | 04 | Three-Stage High-Quality | 26 | 文本 | ✅ 可用(多段采样+放大) |
475
+ | 09 | Text-to-Image Baseline | 17 | 文本 | ✅ 可用(已转好并实测) |
476
+ | 03 | DMDX 4-Step Speed Run | 19 | 文本 | ⏳ 需 DMDX LoRA(`dmdx_student_final_comfy.safetensors`) |
477
+ | 04 | Three-Stage High-Quality | 26 | 文本 | ✅ 可用(已转好并实测) |
437
478
  | 01 | 1.5x Upscale | 20 | 文本 | ✅ 可用(见下方依赖) |
438
- | 05 | Tiled Upscale | 45 | 视导出而定 | ⚠️ 同上 |
479
+ | 05 | Tiled Upscale | 45 | 图片 | ✅ 可用(分块重绘放大,约 4 分钟,输出约 2 倍分辨率) |
439
480
  | 08 | T2I + ControlNet + Face/Hand Repair | 60 | 文本 + 控制图 | ✅ 可用(已裁成单输出;ControlNet 分支默认旁路,需检测器 + SAM 模型) |
440
- | 02 | ControlNet Precision Control | 32 | 图片 | ❌ 需图生图 |
441
- | 06 | i2i + ControlNet + Face/Hand Repair | 52 | 图片 | ❌ 需图生图 |
442
- | 07 | Image-to-Image | 19 | 图片 | ❌ 需图生图 |
443
- | 10 | Anima-Edit LoRA / IC | 52 | 图片 | ❌ 需图生图 |
481
+ | 02 | ControlNet Precision Control | 32 | 图片 | ✅ 可用(**VACE 深度控制**,需带参考图;依赖见下) |
482
+ | 06 | i2i + ControlNet + Face/Hand Repair | 52 | 图片 | ✅ 可用(已裁成单输出;WD14 打标器已剔除,重绘幅度建议 0.4–0.6) |
483
+ | 07 | Image-to-Image | 19 | 图片 | ✅ 可用(已裁成单输出;`Qwen3VLProcessor` 已剔除,需配 `denoise`) |
484
+ | 10 | Anima-Edit LoRA / IC | 52 | 图片 | ✅ 可用(**参考图编辑**:改服装/细节、保角色;背景基本沿用原图) |
444
485
 
445
486
  判断依据是自动体检的结果:**只要 JSON 里出现 `LoadImage` 一类节点,就判定为需要图片输入**。所以 05/08 到底能不能用,取决于你导出时是「从空 latent 开始」还是「从图开始」——`画图 工作流` 会直接告诉你。
446
487
 
@@ -454,12 +495,37 @@ defaultWorkflowPreset: 基础文生图
454
495
  | [Comfy-WaveSpeed](https://github.com/chengzeyi/Comfy-WaveSpeed) | `EnhancedLoadDiffusionModel` | 官方图的模型加载节点 |
455
496
  | [ControlAltAI-Nodes](https://github.com/gseth/ControlAltAI-Nodes) | `FluxResolutionNode` | 按兆像素/比例计算尺寸 |
456
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`。
457
523
 
458
524
  > `XB_UNetNameBroadcaster`(在 XB_ToolBox 里)依赖极重(easyocr / whisper / diffusers…),**不建议装**。它只是给模型加载节点传一个字符串,删掉该节点、直接在加载节点的下拉框里选模型即可。
459
525
 
460
526
  01 实测流程:装上 RES4LYF + Comfy-WaveSpeed + ControlAltAI-Nodes,删掉 `XB_UNetNameBroadcaster`,把模型选成自己的,导出 API 即可。**插件会自动把 `unetName` 注入模型节点**(见 `workflowOverrideModel`),所以后续换模型不用再改 JSON。
461
527
 
462
- 图生图能力(图片上传 + `LoadImage` 注入 + 重绘幅度)尚未实现,所以 ❌ 的四个目前只能等后续版本。
528
+ 图生图能力(图片上传 + `LoadImage` 注入 + 重绘幅度)已实现,所以上面 9 个都能用;只剩 10 还缺外部节点包。
463
529
 
464
530
  ## 注意
465
531
 
@@ -476,3 +542,39 @@ defaultWorkflowPreset: 基础文生图
476
542
  - **管理员在全局关闭时自动免费优化**(不耗券);`无优化` 原样模式不消耗、不询问。平台不支持交互确认时退回自动消耗逻辑。
477
543
  - **未使用优化的提示**:单人生图没走 LLM 优化时会明确提示原因——未配置 LLM、未消耗优化券、或 `无优化` 原样模式;多人指令强依赖 LLM 规划,未配置 `llmBaseUrl`/`llmModel` 时会直接提示「多人指令需要 LLM 规划」。
478
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 **均静默失效**,不要用。