Publish current ComfyUI O1Key code baseline

Replace the prior release tree with the current plugin, frontend, tests, and documentation. Document retired node IDs and the public Gitea update source.
2026-09-24 19:56:48 +08:00
parent 3e337722ab
commit ba920f2b66
183 changed files with 49496 additions and 9934 deletions
@@ -0,0 +1,13 @@
+# Node implementation rules
+
+These instructions apply to `nodes/` and override broader guidance where more specific.
+
+- Preserve released node IDs, input IDs, output order, and widget ordering unless a tested workflow migration is included.
+- Root `NODE_CLASS_MAPPINGS` in `../__init__.py` is the canonical public registry. Keep `nodes/__init__.py` exports synchronized with it.
+- V1 and V3 nodes currently coexist. Follow the API style already used by the target node; do not migrate unrelated nodes opportunistically.
+- V3 `node_id` must match the root mapping key. Return `io.NodeOutput` from V3 execution methods.
+- Validate user inputs before uploads or paid API calls. Check interruption during polling, retries, and long downloads.
+- Do not store API keys or resolved authorization data in node attributes that can enter serialized workflows.
+- Put reusable HTTP behavior, retry logic, uploads, media validation, and response parsing in `clients/` or `utils/`.
+- If widget layout changes, update `../web/js/migrateWorkflow.js` and add a regression test for legacy `widgets_values`.
+- Add new node tests under `../tests/` and run them through `../tests/run_all.py`.