创意软件AI代理集成

ComfyUI workflow draft builder

comfy.workflow_draft 是只读草案生成器，用于把基础参数转成可审查的 ComfyUI API-like workflow JSON。它接受 task_type、prompt、negative_prompt、width、height、seed、steps、cfg、sampler、scheduler、denoise、scale_by 等参数。

返回结构包含：

• valid：草案是否通过本仓库 workflow_validate。
• workflow：API-like workflow JSON 草案。
• validation_report：完整校验报告。
• warnings、safety_notes、next_steps：说明草案边界和后续人工确认步骤。

所有 draft 都带 StarBridgeDraftMetadata 节点，标记 production_ready=false、queue_submission=disabled、model_policy=placeholder_only。模型、源图、mask、upscale model 都使用 placeholder，不使用真实模型路径、真实图片路径或真实输出目录。

运行前配置

真实安装路径不要写进 GitHub。每台电脑用环境变量或本地 .env 管理：

本地输出、报告、图片、DWG、PSD、缓存和日志应放在 output/、scratch/ 或其他本机私有目录，并保持在 Git 提交之外。

ComfyUI safe workflow loop

本轮 ComfyUI 闭环只开放安全层能力，不真实调用生成队列：

• comfyui.workflow_validate：只读校验 API-format workflow JSON，检查 node id、class_type、inputs、核心 link、输出节点和 prompt 节点，并返回 valid、errors、warnings、node_count、detected_models、missing_or_suspicious_fields。
• comfyui.workflow_build_plan：为 txt2img、img2img、inpaint、upscale 生成 dry-run plan，包含 task_type、input_requirements、workflow_requirements、safety_notes、expected_outputs、blocked_reasons。
• comfy.workflow_draft：为 txt2img、img2img、inpaint、upscale 生成 API-like workflow JSON 草案，并立即用 workflow_validate 校验。
• comfy.workflow_compose：把安全 placeholder 模块组合成 API-like graph，覆盖 checkpoint、prompt encode、latent、load image、VAE encode、KSampler、decode、save、upscale、inpaint mask 等基础模块。
• img2img、inpaint、upscale 当前支持 draft workflow；不会读取本机图片、模型目录或 ComfyUI output，也不会提交 /prompt。
• 校验输出会经过 StarBridge sanitizer，真实路径、用户名和模型路径会脱敏。

公开示例：

ComfyUI workflow graph composer

comfy.workflow_compose 是只读 graph composer，用固定安全模块组合 ComfyUI API-like workflow：

• checkpoint_loader_placeholder
• positive_prompt_encode
• negative_prompt_encode
• empty_latent_image
• load_image_placeholder
• vae_encode_placeholder
• ksampler
• vae_decode
• save_image_placeholder
• upscale_placeholder
• inpaint_mask_placeholder

返回结构包含 valid、workflow、validation_report、warnings、safety_notes、next_steps。所有 composed workflow 都带 StarBridgeDraftMetadata，其中 draft=true、safe_placeholder=true、queue_submission=disabled。Composer 不读取文件系统、不联网、不提交队列，只生成可审查 JSON。

ComfyUI workflow template registry

workflow_template_registry 在 graph composer 之上增加一层公开模板索引，目前注册：

Registry 文件位于 examples/comfy_bridge/templates/workflow_template_registry.json。每个模板只声明 template_id、version、task_type、composer modules、required inputs、placeholder policy、validation status、safety level 和 notes；不引用真实模型、真实图片或真实输出目录。

新增 MCP safe read-only tools：

• comfy.workflow_template_list：列出模板和 lint 状态。
• comfy.workflow_template_get：按 template_id 返回单个模板。
• comfy.workflow_from_template：用模板调用安全 graph composer，返回 placeholder-only workflow。

这三个 tool 不读取用户文件路径、不联网、不提交 ComfyUI queue；输出 workflow 仍带 StarBridgeDraftMetadata、safe_placeholder=true、production_ready=false、queue_submission=disabled。