You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit f4b8f77
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: README.md
+66-8Lines changed: 66 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,6 +25,19 @@ The core objective of this project is not merely to replicate the classic UI/UX,
25
25
26
26
<details>
27
27
28
+
<summary><strong>1.2.0: MOSS-Image generation, layout guidance, and sidebar reliability (new functionality/compatibility)</strong></summary>
29
+
30
+
- Added native `MOSS-Image Base` and `MOSS-Image SFT` text-to-image presets with matching model selection, host prerequisite checks, and Skip Layer Guidance (SLG) controls.
31
+
- Added experimental Layout guidance for ordered object, character, and text boxes, with a canvas preview, input validation, and PNG Info restoration.
32
+
- MOSS uses the official sampling defaults; prompt enhancement remains unavailable, negative prompts start empty, and automatic encoder selection prefers int8_convrot. See the preset notes below for these differences.
33
+
- Improved sidebar startup when browser storage is blocked or unavailable, and kept MOSS parameters and layout drafts consistent across profile changes and parameter restoration.
34
+
- Added source compatibility checks for Core 0.42, Frontend 1.59.1, and workflow templates 0.11.96. Real GPU checks covered Base/SFT generation, Layout, preview actions, and saved PNG restoration with the tested int8 model combinations.
35
+
- Updated frontend development tooling, including Vite 8.3.5. This release also includes the provider-request and local-file access protections documented in 1.1.3 and 1.1.4 below.
36
+
37
+
</details>
38
+
39
+
<details>
40
+
28
41
<summary><strong>1.1.4: Embedding folder and translation file access protection (bugfix/security)</strong></summary>
29
42
30
43
- The optional `embedding_directory` input on the RookieUI A1111 CLIP Text Encode nodes now accepts only a ComfyUI-registered embeddings folder or one of its subfolders. Embedding names come from ComfyUI's own embeddings list, and other filesystem paths are rejected instead of scanned.
@@ -75,7 +88,7 @@ The core objective of this project is not merely to replicate the classic UI/UX,
75
88
<summary><strong>Frontend test files no longer shipped to browsers (stability/performance)</strong></summary>
76
89
77
90
- The frontend test suite no longer lives inside the directory this pack registers with ComfyUI. ComfyUI publishes every JavaScript file beneath a registered web directory and its frontend imports all of them, so those files were previously fetched and executed by every browser on every page load, where they failed to resolve their test-runner imports.
78
-
-Files served by this pack dropped from 114 to 73, all of them runtime modules. The wasted requests, the console errors they produced, and the exposure of the internal test layout to anyone reading the extension listing are all removed.
91
+
-That cleanup reduced the served file set from 114 to 73runtime modules at the time; later features add their own runtime modules. The wasted test requests and browser import errors were removed.
79
92
- A guard now fails if any test file or test directory reappears under the served directory. It reads the registered directory name from the package rather than assuming it, so changing that declaration cannot move the served tree out from under the check.
80
93
- The registered directory name is unchanged, so existing installations keep resolving the same extension path. The shipped module set and its cache-busting revision token are untouched.
81
94
@@ -666,6 +679,7 @@ If your host or Manager install path does not automatically install custom-node
666
679
- Stable Diffusion family prompt semantics parity through RookieUI-owned encoder nodes, including parser modes, `BREAK`, `AND`, scheduling slices, alternate scheduling, attention markers, old-emphasis compatibility, weighted conditioning, and embeddings / textual inversion tokens
667
680
- Official non-SD template translation for shipped txt2img presets, including family-specific parameter mapping such as `shift`, `flux_guidance`, and `prompt_enhancement_enabled` where the official workflow requires them
668
681
- Official txt2img profiles include `Qwen-Image 2.1` and newer lanes such as `Flux.1 Krea Dev`, `Flux.2 Dev`, `Ideogram v4`, and `Krea-2 Turbo`, with official encoder/model/LoRA prerequisites surfaced through the normal model selector contract
682
+
-`MOSS-Image Base` and `MOSS-Image SFT` add native text-to-image generation, an SLG toggle, and experimental box-based Layout guidance; their supported controls and default differences are described below
669
683
- Krea-2 Turbo prompt enhancement is enabled by default on its local txt2img profile; turning it off preserves and encodes the original prompt without adding the host text-generation stage
670
684
- Z-Image Turbo can use official model-patch ControlNet workflows through host `model_patches` inventory when the required ComfyUI nodes and patch files are available
671
685
- ComfyUI-native prompt submission with host API-node usage-source attribution, embedded A1111-style `parameters` metadata, and separate RookieUI origin metadata
@@ -739,15 +753,57 @@ If your host or Manager install path does not automatically install custom-node
739
753
740
754
- SD1.5, SDXL, Pony, Illustrious, and Noob use RookieUI's Stable Diffusion parity text-encode path for A1111-style prompt semantics, single-node conditioning composition, parser-mode selection, old-emphasis compatibility, and inventory-aware embeddings / textual inversion handling
741
755
- Official non-SD template presets now surface family-specific controls only when the upstream workflow exposes them, including `Shift`, `Flux Guidance`, and `Prompt Enhancement`
742
-
-Fixed template-owned encoder bundles keep `Text Encoder` controls hidden on the shipped official non-SD preset matrix instead of implying a user-selectable pairing that the official template does not expose
756
+
-Profiles with fixed template-owned encoder bundles keep `Text Encoder` controls hidden; MOSS exposes a selector limited to its supported generation encoders
743
757
- Qwen Image 2.1 profiles use the authored prompt directly; dedicated prompt enhancement models cannot be selected as generation text encoders
744
758
- Model inventory includes current ComfyUI postprocessing-related catalog categories such as upscale models, latent upscalers, and background-removal models; some categories are diagnostic-only until a shipped RookieUI surface uses them directly
745
759
- Clip Skip remains editable in UI; some profiles may ignore it at execution time
- Existing shipped profiles remain aligned to `comfyui-workflow-templates` 0.11.54; the Qwen Image 2.1 profiles use the 0.11.66 template source contract. Workflow families outside the shipped profile list are not implied support.
763
+
The `MOSS-Image Base` and `MOSS-Image SFT` text-to-image presets use native ComfyUI loaders and
764
+
FLUX.2 latents. Their controls are enabled only when the running host exposes MOSS encoding,
765
+
the required nodes and samplers, and matching installed models. The source contract targets
- Install the matching `moss_image_base` or `moss_image_sft` BF16/int8_convrot diffusion model in
769
+
`models/diffusion_models`, a generic `qwen3.5_9b` BF16/int8_convrot/w4a8_gptq encoder in
770
+
`models/text_encoders`, and `flux2-vae_small.safetensors` or `flux2-vae.safetensors` in `models/vae`.
771
+
Keep official filenames; subfolders are supported. Qwen Image 2.1 prompt-enhancer encoders cannot
772
+
substitute for the MOSS generation encoder.
773
+
- Defaults are 1024×1024, 25 steps, CFG 2.5 and `er_sde` / `simple`. Dimensions must be divisible by
774
+
16 within RookieUI's existing limits. Base enables Skip Layer Guidance (SLG) by default; SFT
775
+
disables it. The checkbox overrides either default and is preserved in saved PNG metadata.
776
+
- These sampling defaults follow the official 0.11.96 templates, with deliberate differences:
777
+
prompt enhancement is unavailable (the ordinary official Base/SFT templates enable it), the
778
+
negative prompt starts empty, and the seed starts at `-1` for random generation. Automatic
779
+
encoder selection prefers int8_convrot, then BF16, then w4a8_gptq; the official templates preselect
780
+
w4a8_gptq. VAE selection prefers `flux2-vae_small.safetensors`, then `flux2-vae.safetensors`.
781
+
- Positive and negative prompts go directly to the native encoder. Prompt enhancement, A1111
782
+
prompt compilation, LoRAs, Hires, ControlNet, ADetailer and img2img are unavailable for these
783
+
profiles. PNG Info restores supported parameters to Txt2Img and explains unsupported transfers.
784
+
- Model-name admission does not verify file contents or establish every quantization's runtime
785
+
compatibility. Review the [official MOSS-Image model and Apache 2.0 license](https://github.com/OpenMOSS/MOSS-Image/tree/52b87fca23acedc399d062d593bec388aee9926a).
786
+
- Real GPU checks covered Base/SFT, ordinary generation and Layout, using int8_convrot diffusion
787
+
models, `qwen3.5_9b_int8_convrot.safetensors`, and `flux2-vae.safetensors` on Core 0.42 with
788
+
Frontend 1.59.1 and templates 0.11.96. BF16 and w4a8_gptq selections were not live-qualified;
789
+
these checks do not reproduce every official default or qualify every admitted model variant.
790
+
791
+
The optional experimental **Layout guidance** control authors up to 32 ordered object, character
792
+
or text boxes. Enter normalized `y0, x0, y1, x1` coordinates from 0 to 1000 with a positive area;
793
+
the preview follows the selected output width and height. Text boxes preserve literal rendered
794
+
text, and an optional palette accepts up to eight comma-separated `#RRGGBB` colors. Captions are
795
+
limited to 2,048 Unicode characters, rendered text to 1,024, and the layout to 128 KiB of UTF-8 JSON.
796
+
Invalid drafts show an error and prevent generation. Disabling Layout retains the editable draft;
797
+
empty or disabled layouts use the ordinary authored positive prompt.
798
+
799
+
Layout defaults SLG on for both Base and SFT. An explicit SLG choice survives Layout toggles and
800
+
parameter restoration. Native conditioning uses centered pixel boxes derived from the same output
801
+
dimensions, with no additional custom node or bounding-box output image. PNG Info restores the
802
+
original layout fields to txt2img. Layout guidance is experimental and does not guarantee exact
- Earlier shipped profiles remain aligned to `comfyui-workflow-templates` 0.11.54; Qwen Image 2.1 uses the 0.11.66 source contract, and MOSS uses 0.11.96. Workflow families outside the shipped profile list are not implied support.
751
807
- These presets follow official template defaults or source-backed mode values for width, height, steps, CFG, sampler, and scheduler, and they keep template-owned encoder bundles hidden when the official workflow hard-codes those pairings.
752
808
- Family-specific controls are preserved where the official workflows require them:
@@ -786,17 +842,17 @@ If your host or Manager install path does not automatically install custom-node
786
842
787
843
<br>
788
844
789
-
-Shipped official non-SD template workflows now accept prompt-inline LoRA syntax such as `<lora:model_name:1>` on their native template runtime path instead of treating inline LoRAs as Stable Diffusion-only behavior.
845
+
-Supported official non-SD template workflows accept prompt-inline LoRA syntax such as `<lora:model_name:1>` on their native template runtime path. MOSS-Image profiles do not support LoRAs and reject inline LoRA requests.
790
846
- RookieUI extracts inline LoRA activations from the prompt, creates model-only `Load LoRA` nodes, and chains them immediately after the official `Load Diffusion Model` path before submitting the final ComfyUI workflow JSON to the host.
791
847
- When a preset has an enabled official template LoRA, RookieUI preserves it first and appends prompt-inline LoRAs after it. This means the effective order is:
792
848
-`Load Diffusion Model`
793
849
- template-owned `Load LoRA` nodes
794
850
- prompt-inline `Load LoRA` nodes
795
-
- This support applies to shipped official non-SD template txt2img and image-edit builders.
851
+
- This support applies to compatible official non-SD template txt2img and image-edit builders; it excludes MOSS-Image.
796
852
797
853
Simple usage:
798
854
799
-
1. Select a shipped official non-SD preset.
855
+
1. Select a shipped official non-SD preset that supports LoRAs.
800
856
2. Type prompt-inline LoRA syntax directly in the prompt, for example `<lora:example_model:1>`.
801
857
3. Generate normally; RookieUI will append the corresponding model-only `Load LoRA` nodes automatically before the host run.
802
858
@@ -809,7 +865,7 @@ Behavior and limits:
809
865
### Model Support
810
866
811
867
- Stable Diffusion family
812
-
- Official non-SD template preset families: `Anima`, `Chroma`, `ERNIE-Image`, `Flux.1`, `Flux.2`, `HiDream i1`, `Ideogram`, `Krea-2`, `Longcat Image`, `Qwen-Image`, and `Z-Image`
-`Z-Image` also covers the Lumina/Z-Image naming lineage used by the official host templates and RookieUI aliases
814
870
815
871
Prompt semantics note:
@@ -981,6 +1037,8 @@ Behavior and compatibility:
981
1037
- The general tested source envelope covers ComfyUI Core 0.34, its bundled frontend 1.51.9, standalone frontend 1.54.1, and `comfyui-workflow-templates` 0.11.54; this is a pinned compatibility basis rather than a blanket claim for every future host build.
982
1038
- Qwen Image 2.1 has a separate scoped source contract for Core 0.37 (bundled frontend 1.53.6), standalone frontend 1.55.12, and workflow templates 0.11.66. That contract covers the Qwen node, template graph, and affected frontend API surfaces; it does not imply that unrelated newer template workflows are supported.
983
1039
- Additional source-contract checks cover Core 0.39.0, standalone frontend 1.57.0, and workflow templates 0.11.76; live compatibility remains scoped to the tested environments described here.
1040
+
- An additive source contract covers Core 0.42, standalone frontend 1.59.1, and workflow templates 0.11.96 without replacing the general compatibility basis. MOSS Base/SFT generation and Layout were checked on a real GPU with the int8 model combinations listed above, using an official Frontend 1.59.1 build from its source CI. This is a scoped host/model result, not qualification of every model variant or a statement that all older hosts support MOSS.
1041
+
- Existing SD generation and native Flux.2 Klein PNG workflow replay were also checked on that newer host. Legacy A1111-form restoration for Klein remains unsupported.
984
1042
- SD1.5 default generation and saved PNG prompt readback have also been checked on Core 0.38.0 with CyberRealistic V9 FP16.
985
1043
- RookieUI registers its sidebar through the current ComfyUI frontend sidebar-tab surface when available, including cleanup for stale RookieUI tab instances during re-registration.
986
1044
- Older or reduced host surfaces can still fall back to the legacy launcher path instead of failing the extension bootstrap.
0 commit comments