mirror of
https://git.datalinker.icu/ltdrdata/ComfyUI-Manager
synced 2025-12-08 21:54:26 +08:00
Remove package-level caching in cnr_utils and node_package modules to enable proper dynamic custom node installation and version switching without ComfyUI server restarts. Key Changes: - Remove @lru_cache decorators from version-sensitive functions - Remove cached_property from NodePackage for dynamic state updates - Add comprehensive test suite with parallel execution support - Implement version switching tests (CNR ↔ Nightly) - Add case sensitivity integration tests - Improve error handling and logging API Priority Rules (manager_core.py:1801): - Enabled-Priority: Show only enabled version when both exist - CNR-Priority: Show only CNR when both CNR and Nightly are disabled - Prevents duplicate package entries in /v2/customnode/installed API - Cross-match using cnr_id and aux_id for CNR ↔ Nightly detection Test Infrastructure: - 8 test files with 59 comprehensive test cases - Parallel test execution across 5 isolated environments - Automated test scripts with environment setup - Configurable timeout (60 minutes default) - Support for both master and dr-support-pip-cm branches Bug Fixes: - Fix COMFYUI_CUSTOM_NODES_PATH environment variable export - Resolve test fixture regression with module-level variables - Fix import timing issues in test configuration - Register pytest integration marker to eliminate warnings - Fix POSIX compliance in shell scripts (((var++)) → $((var + 1))) Documentation: - CNR_VERSION_MANAGEMENT_DESIGN.md v1.0 → v1.1 with API priority rules - Add test guides and execution documentation (TESTING_PROMPT.md) - Add security-enhanced installation guide - Create CLI migration guides and references - Document package version management 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
7.4 KiB
7.4 KiB
ComfyUI Manager Documentation Index
Last Updated: 2025-11-04 Purpose: Navigate all project documentation organized by purpose and audience
📖 Quick Links
- Getting Started: README.md
- User Documentation: docs/
- Test Documentation: tests/glob/
- Contributing: CONTRIBUTING.md
- Development: CLAUDE.md
📚 Documentation Structure
Root Level
| Document | Purpose | Audience |
|---|---|---|
| README.md | Project overview and quick start | Everyone |
| CONTRIBUTING.md | Contribution guidelines | Contributors |
| CLAUDE.md | Development guidelines for AI-assisted development | Developers |
| JSON_REFERENCE.md | JSON file schema reference | Developers |
User Documentation (docs/)
| Document | Purpose | Language |
|---|---|---|
| docs/README.md | Documentation overview | English |
| docs/PACKAGE_VERSION_MANAGEMENT.md | Package version management guide | English |
| docs/SECURITY_ENHANCED_INSTALLATION.md | Security features for URL installation | English |
| docs/en/cm-cli.md | CLI usage guide | English |
| docs/en/use_aria2.md | Aria2 download configuration | English |
| docs/ko/cm-cli.md | CLI usage guide | Korean |
Package Documentation
| Package | Document | Purpose |
|---|---|---|
| comfyui_manager | comfyui_manager/README.md | Package overview |
| common | comfyui_manager/common/README.md | Common utilities documentation |
| data_models | comfyui_manager/data_models/README.md | Data model generation guide |
| glob | comfyui_manager/glob/CLAUDE.md | Glob module development guide |
| js | comfyui_manager/js/README.md | JavaScript components |
Test Documentation (tests/)
| Document | Purpose | Status |
|---|---|---|
| tests/TEST.md | Testing overview | ✅ |
| tests/glob/README.md | Glob API endpoint tests | ✅ Translated |
| tests/glob/TESTING_GUIDE.md | Test execution guide | ✅ |
| tests/glob/TEST_INDEX.md | Test documentation unified index | ✅ Translated |
| tests/glob/TEST_LOG.md | Test execution log | ✅ Translated |
Node Database
| Document | Purpose |
|---|---|
| node_db/README.md | Node database information |
🔒 Internal Documentation (docs/internal/)
CLI Migration (docs/internal/cli_migration/)
Historical documentation for CLI migration from legacy to glob module (completed).
| Document | Purpose |
|---|---|
| README.md | Migration plan overview |
| CLI_COMPATIBILITY_ANALYSIS.md | Legacy vs Glob compatibility analysis |
| CLI_IMPLEMENTATION_CONTEXT.md | Implementation context |
| CLI_IMPLEMENTATION_TODO.md | Implementation checklist |
| CLI_PURE_GLOB_MIGRATION_PLAN.md | Technical migration specification |
| CLI_GLOB_API_REFERENCE.md | Glob API reference |
| CLI_IMPLEMENTATION_CONSTRAINTS.md | Migration constraints |
| CLI_TESTING_CHECKLIST.md | Testing checklist |
| CLI_SHOW_LIST_REVISION.md | show_list implementation plan |
Test Planning (docs/internal/test_planning/)
Internal test planning documents (in Korean).
| Document | Purpose | Language |
|---|---|---|
| TEST_PLAN_ADDITIONAL.md | Additional test scenarios | Korean |
| COMPLEX_SCENARIOS_TEST_PLAN.md | Complex multi-version test scenarios | Korean |
📋 Documentation by Audience
For Users
- README.md - Start here
- docs/en/cm-cli.md - CLI usage
- docs/PACKAGE_VERSION_MANAGEMENT.md - Version management
For Contributors
- CONTRIBUTING.md - Contribution process
- CLAUDE.md - Development guidelines
- comfyui_manager/data_models/README.md - Data model workflow
For Developers
- CLAUDE.md - Development workflow
- comfyui_manager/glob/CLAUDE.md - Glob module guide
- JSON_REFERENCE.md - Schema reference
- docs/PACKAGE_VERSION_MANAGEMENT.md - Package management internals
For Testers
- tests/TEST.md - Testing overview
- tests/glob/TEST_INDEX.md - Test documentation index
- tests/glob/TESTING_GUIDE.md - Test execution guide
🔄 Documentation Maintenance
When to Update
- README.md: Project structure or main features change
- CLAUDE.md: Development workflow changes
- Test Documentation: New tests added or test structure changes
- User Documentation: User-facing features change
- This Index: New documentation added or reorganized
Documentation Standards
- Use clear, descriptive titles
- Include "Last Updated" date
- Specify target audience
- Provide examples where applicable
- Keep language simple and accessible
- Translate user-facing docs to Korean when possible
🗂️ File Organization
comfyui-manager/
├── DOCUMENTATION_INDEX.md (this file)
├── README.md
├── CONTRIBUTING.md
├── CLAUDE.md
├── JSON_REFERENCE.md
├── docs/
│ ├── README.md
│ ├── PACKAGE_VERSION_MANAGEMENT.md
│ ├── SECURITY_ENHANCED_INSTALLATION.md
│ ├── en/
│ │ ├── cm-cli.md
│ │ └── use_aria2.md
│ ├── ko/
│ │ └── cm-cli.md
│ └── internal/
│ ├── cli_migration/ (9 files - completed migration docs)
│ └── test_planning/ (2 files - Korean test plans)
├── comfyui_manager/
│ ├── README.md
│ ├── common/README.md
│ ├── data_models/README.md
│ ├── glob/CLAUDE.md
│ └── js/README.md
├── tests/
│ ├── TEST.md
│ └── glob/
│ ├── README.md
│ ├── TESTING_GUIDE.md
│ ├── TEST_INDEX.md
│ └── TEST_LOG.md
└── node_db/
└── README.md
Total Documentation Files: 36 files organized across 6 categories
Translation Status:
- ✅ Core user documentation: English
- ✅ CLI guide: English + Korean
- ✅ Test documentation: English (translated from Korean)
- 📝 Internal planning docs: Korean (preserved as-is for historical reference)