The unanchored `tools/` pattern matched that directory at any depth, stripping the ExifTool/FFProbe adapters out of published packages and causing ModuleNotFoundError at startup. Anchored to /tools/ so only the root-level dev-scripts folder is excluded. Bump to 2.5.3.
108 lines
4.8 KiB
Markdown
108 lines
4.8 KiB
Markdown
# Majoor Assets Manager - Documentation Index
|
|
|
|
Welcome to the documentation hub for **Majoor Assets Manager** for ComfyUI.
|
|
|
|
Majoor is best understood as one workflow:
|
|
|
|
1. **Browse** your ComfyUI media library.
|
|
2. **Inspect** prompts, metadata, workflows, and visual details.
|
|
3. **Reuse** useful assets and workflow context back in ComfyUI.
|
|
|
|
**Current Version**: 2.5.3
|
|
**Last Updated**: September 27, 2026
|
|
|
|
## Start Here
|
|
|
|
| Goal | Read This |
|
|
| --- | --- |
|
|
| Install the extension | **[Installation Guide](INSTALLATION.md)** |
|
|
| Learn the daily workflow | **[User Guide (HTML)](../user_guide.html)** |
|
|
| Find assets quickly | **[Search & Filtering](SEARCH_FILTERING.md)** |
|
|
| Learn shortcuts | **[Hotkeys & Shortcuts](HOTKEYS_SHORTCUTS.md)** |
|
|
| See what changed | **[Changelog](../CHANGELOG.md)** |
|
|
|
|
## Browse
|
|
|
|
Use these docs for the main library experience: grid browsing, search, organization, and file actions.
|
|
|
|
| Document | Description |
|
|
| --- | --- |
|
|
| **[SEARCH_FILTERING.md](SEARCH_FILTERING.md)** | Full-text search, filters, sorting, and discovery |
|
|
| **[WORKFLOWS.md](WORKFLOWS.md)** | Workflow tab library: save, import, load, inspect, categorize, thumbnail, and tag workflows |
|
|
| **[RATINGS_TAGS_COLLECTIONS.md](RATINGS_TAGS_COLLECTIONS.md)** | Ratings, tags, collections, and organization |
|
|
| **[DRAG_DROP.md](DRAG_DROP.md)** | Drag to canvas, staging, OS drag-out, clean export, ZIP download |
|
|
| **[COLLECT_FILES.md](COLLECT_FILES.md)** | Bundle an asset, its workflow, prompt text, and media inputs into a ZIP |
|
|
| **[DB_MAINTENANCE.md](DB_MAINTENANCE.md)** | Index database reset, recovery, and index directory configuration |
|
|
|
|
## Inspect
|
|
|
|
Use these docs when you want to understand how an asset was made or compare outputs.
|
|
|
|
| Document | Description |
|
|
| --- | --- |
|
|
| **[MFV_GUIDE.md](MFV_GUIDE.md)** | Majoor Floating Viewer: live review, compare modes, pins, streams |
|
|
| **[VIEWER_FEATURE_TUTORIAL.md](VIEWER_FEATURE_TUTORIAL.md)** | Viewer tools, analysis overlays, media controls |
|
|
| **[GRAPH_MAP.md](GRAPH_MAP.md)** | Workflow graph navigation and node detail inspection |
|
|
| **[FLOATING_VIEWER_WORKFLOW_SIDEBAR.md](FLOATING_VIEWER_WORKFLOW_SIDEBAR.md)** | Node Parameters sidebar in the Floating Viewer |
|
|
|
|
## Reuse
|
|
|
|
Use these docs for moving assets and workflow information back into ComfyUI.
|
|
|
|
| Document | Description |
|
|
| --- | --- |
|
|
| **[WORKFLOWS.md](WORKFLOWS.md)** | Save, import, load, inspect, and organize reusable ComfyUI workflows |
|
|
| **[DRAG_DROP.md](DRAG_DROP.md)** | Load assets onto nodes or canvas, stage files to input |
|
|
| **[COLLECT_FILES.md](COLLECT_FILES.md)** | Export a reproducible bundle (workflow + prompt + inputs) for sharing or archiving |
|
|
| **[CUSTOM_NODES.md](CUSTOM_NODES.md)** | Majoor Save Image, Majoor Save Video, and Majoor GenInfo Override node reference |
|
|
| **[SHORTCUTS.md](SHORTCUTS.md)** | Quick gestures such as S+Drag and L+Drop |
|
|
|
|
## Advanced Features
|
|
|
|
These are powerful capabilities, but they are not required for the basic Browse / Inspect / Reuse workflow.
|
|
|
|
| Document | Description |
|
|
| --- | --- |
|
|
| **[AI_FEATURES.md](AI_FEATURES.md)** | Semantic search, visual similarity, auto-tags, captions, vector backfill |
|
|
| **[PRIVACY_OFFLINE.md](PRIVACY_OFFLINE.md)** | Local AI behavior, model downloads, offline use, token clarification |
|
|
| **[SETTINGS_CONFIGURATION.md](SETTINGS_CONFIGURATION.md)** | Runtime settings, UI settings, index path overrides, environment variables |
|
|
| **[SECURITY_ENV_VARS.md](SECURITY_ENV_VARS.md)** | Remote access security, API tokens, safe defaults |
|
|
| **[THREAT_MODEL.md](THREAT_MODEL.md)** | Threats, mitigations, and residual risk |
|
|
| **[API_REFERENCE.md](API_REFERENCE.md)** | Backend endpoint reference |
|
|
|
|
## Development And Architecture
|
|
|
|
| Document | Description |
|
|
| --- | --- |
|
|
| **[ARCHITECTURE_MAP.md](ARCHITECTURE_MAP.md)** | Package responsibilities and internal boundaries |
|
|
| **[TESTING.md](TESTING.md)** | Tests, reports, and quality gate |
|
|
| **[CONTRIBUTING.md](CONTRIBUTING.md)** | Developer onboarding and contribution guidance |
|
|
| **[DEPENDENCY_POLICY.md](DEPENDENCY_POLICY.md)** | Runtime, optional, and contributor dependency rules |
|
|
| **[adr/](adr/)** | Architecture Decision Records |
|
|
|
|
## Plugin System
|
|
|
|
| Document | Description |
|
|
| --- | --- |
|
|
| **[PLUGIN_QUICK_REFERENCE.md](PLUGIN_QUICK_REFERENCE.md)** | Quick start for plugin development |
|
|
| **[PLUGIN_SYSTEM_DESIGN.md](PLUGIN_SYSTEM_DESIGN.md)** | Full plugin architecture design |
|
|
| **[PLUGIN_SYSTEM_IMPLEMENTATION_SUMMARY.md](PLUGIN_SYSTEM_IMPLEMENTATION_SUMMARY.md)** | Implementation status and details |
|
|
|
|
## Quality And Verification
|
|
|
|
Use the canonical gate from the repo root:
|
|
|
|
```bash
|
|
python scripts/run_quality_gate.py
|
|
```
|
|
|
|
Useful variants:
|
|
|
|
```bash
|
|
python scripts/run_quality_gate.py --python-only --skip-tests
|
|
tox -e quality
|
|
npm run test:js
|
|
```
|
|
|
|
The quality gate covers backend tests, frontend tests, linting, typing, dependency checks, and security scans.
|