ComfyUI 官方工作流模板

workflow_templates

This repo hosts the official ComfyUI workflow templates and subgraph blueprints.

Overview

| Content | Description | Location |
| Workflow Templates | Full standalone workflows for the template picker | templates/, packages/ |
| Subgraph Blueprints | Reusable node components that appear in the node palette | blueprints/, packages/blueprints/ |
| Template Site | Astro SSG that showcases templates at comfy.org/workflows | site/ |

The repository uses a package-per-media structure for Python distribution:

- packages/core – manifest + loader helpers shipped as comfyui-workflow-templates-core
- packages/media_* – workflow template JSON + preview assets for each media type
- packages/blueprints – subgraph blueprint JSON + preview assets as comfyui-subgraph-blueprints
- packages/meta and the root pyproject.toml – the comfyui-workflow-templates meta package

Template Site (site/)

The site/ directory contains an independent Astro static site that provides a browsable, searchable interface for all workflow templates. It includes AI-generated descriptions, i18n support (11 languages), SEO optimization, and automated content pipelines. See site/AGENTS.md for full documentation.

bash
cd site
pnpm install
pnpm run dev       # Start dev server at localhost:4321
pnpm run build     # Production build (runs prebuild pipeline automatically)

Deployment Environments

The template site is deployed to four environments via GitHub Actions:

main merge (version bump)
  └─ PyPI publish ─► deploy-site.yml ─► Production (approved only)

Once per day (00:00 UTC)
  └─ cron-rebuild-site.yml         ─► Production         (prod API, approved only)

Once per day (00:00 UTC)
  └─ preview-cron.yml
       ├─ main (prod API)          ─► Preview Prod        (prod API, all workflows)
       └─ main (test API)          ─► Preview Test        (test API, all workflows)

PR opened/updated
  ├─ preview-site.yml              ─► PR Preview (one-off)
  └─ preview-cron.yml (label)      ─► PR Preview (daily, requires "preview-cron" label)

| Environment | Workflow | API | Status Filter | Vercel Flag | Alias Secret | Trigger |
| Production | deploy-site.yml | Production | approved only | --prod | — | PyPI publish / manual |
| Production | cron-rebuild-site.yml | Production | approved only | --prod | — | Once per day (00:00 UTC) |
| Preview Prod | preview-cron.yml (main, prod) | Production | None (all) | preview | VERCEL_PREVIEW_ALIAS | Once per day (00:00 UTC) |
| Preview Test | preview-cron.yml (main, test) | Test | None (all) | preview | VERCEL_PREVIEW_TEST_ALIAS | Once per day (00:00 UTC) |
| PR Preview | preview-site.yml | Configurable | None (all) | preview | — | PR changes |
| PR Preview | preview-cron.yml (PR) | Test | None (all) | preview | — | Once per day (00:00 UTC) |

Status filtering is controlled by the PUBLIC_APPROVED_ONLY environment variable at build time. When set to 'true', only workflows with status: 'approved' from the hub API index endpoint are included in the build. Preview environments omit this flag to show all workflows (pending, approved, rejected, deprecated) for internal review.

Quick Start

| Task | Commands |
| Add a workflow template |

……（后略，见原文）