Files
kunail0804-ComfyUI-Scene-Co…/docs
e49c282879 perf: KB caching, compiled index, lazy loading, parallel resolution (#38) (#142)
* perf: KB load-once cache, compiled index, lazy loading, parallel resolution (#38)

Closes #130, #131, #132, #133, #134.

- Loader node routes through a process-wide KnowledgeBaseLoader cache so the KB
  loads once per (path, version) and is reused across run() calls.
- Normalized lookup table compiled once per KB (per NSFW gating) and reused across
  resolves instead of rebuilt per resolve_scene. normalize_concept moved to
  knowledge_base (re-exported from the resolver).
- Incremental per-category lazy file loading behind KnowledgeBaseLoader.
- Optional parallel per-concept resolution (thread pool), merged in exact
  discovery order; deterministic and threshold-gated (default sequential).
- Performance regression guard (generous ceilings + relative ratio). Refreshed
  docs/benchmarks.md (resolution 57.6us -> 17.8us).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs(changelog): note V2 performance improvements (#38)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: kunail0804 <kunail0804@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-13 18:51:42 +02:00
..

Documentation

Project documentation is maintained primarily in the GitHub Wiki, and the authoritative specification is MASTER_SPEC.md at the repository root.

This docs/ directory holds documentation that is not part of the wiki — for example design notes, developer guides, and generated references added in later phases.

Where to look

  • Overview & vision — wiki Overview and Vision
  • Requirements — wiki Requirements and Success Criteria
  • Architecture & pipeline — wiki Architecture and Pipeline
  • Data model & schemas — wiki Data Model, Scene JSON and Schemas
  • Knowledge Base — wiki Knowledge Base
  • Contributing — CONTRIBUTING.md