Ewald
db88ad982a
- nodes.py: MajoorSaveImage (PNG with generation_time_ms in text chunks) and MajoorSaveVideo (MP4 via PyAV, GIF, WebP with metadata persistence) - extractors_png.py: read generation_time_ms from PNG text chunks - extractors.py: extract generation_time_ms from merged EXIF data into metadata dict - extractors_video.py: extract generation_time_ms from ffprobe format tags - messageCenter.js: add generation-time-persistence tip and topbar MFV button announcement - CHANGELOG.md: document topbar MFV button and custom nodes - README.md: add Custom Nodes section with input tables - docs/CUSTOM_NODES.md: full node reference and extraction pipeline docs - docs/DOCUMENTATION_INDEX.md: add CUSTOM_NODES.md entry
5.8 KiB
5.8 KiB
Majoor Assets Manager - Documentation Index
Welcome to the documentation hub for Majoor Assets Manager for ComfyUI.
Current Version: 2.4.5 Last Updated: April 7, 2026
Quick Start
New users
- Installation Guide - Install and set up the extension
- User Guide (HTML) - Visual walkthrough with screenshots
- Hotkeys & Shortcuts - Essential keyboard shortcuts
- Basic Search - Find assets quickly
Returning users
- AI Features Guide - AI-assisted search and enrichment features
- Viewer Feature Tutorial - Floating viewer and analysis tools
- Changelog - Recent releases and fixes
- Architecture Map - Backend boundaries and refactor guide
Privacy And Offline Use
- PRIVACY_OFFLINE.md - Dedicated privacy, offline, and token explanation page
- AI_FEATURES.md - Local AI processing, model downloads, offline behavior, and token clarification
- SECURITY_ENV_VARS.md - Remote access security, API token behavior, and safe defaults
- SETTINGS_CONFIGURATION.md - UI security settings and token storage behavior
Documentation Categories
Getting Started
| Document | Description |
|---|---|
| INSTALLATION.md | Detailed installation and network-drive guidance |
| user_guide.html | Full visual user guide |
| HOTKEYS_SHORTCUTS.md | Keyboard shortcuts |
| SHORTCUTS.md | Extra gestures and shortcuts |
Core Features
| Document | Description |
|---|---|
| SEARCH_FILTERING.md | Full-text search, filters, and sorting |
| VIEWER_FEATURE_TUTORIAL.md | Viewer, MFV, and analysis tools |
| FLOATING_VIEWER_WORKFLOW_SIDEBAR.md | Node Parameters sidebar in Floating Viewer |
| RATINGS_TAGS_COLLECTIONS.md | Ratings, tags, and collections |
| DRAG_DROP.md | Drag and drop behavior |
| AI_FEATURES.md | Semantic search, auto-tags, and enrichment |
| CUSTOM_NODES.md | MajoorSaveImage & MajoorSaveVideo node reference |
Plugin System
| Document | Description |
|---|---|
| PLUGIN_QUICK_REFERENCE.md | Quick start for plugin development |
| PLUGIN_SYSTEM_DESIGN.md | Full plugin architecture design |
| PLUGIN_SYSTEM_IMPLEMENTATION_SUMMARY.md | Implementation status and details |
Configuration And Security
| Document | Description |
|---|---|
| PRIVACY_OFFLINE.md | Dedicated privacy, offline behavior, and token clarification guide |
| SETTINGS_CONFIGURATION.md | UI and runtime settings, index DB path, env vars |
| SECURITY_ENV_VARS.md | Environment variables and security model |
| THREAT_MODEL.md | Threats, mitigations, and residual risk |
| ARCHITECTURE_MAP.md | Package responsibilities and internal boundaries |
Maintenance And Development
| Document | Description |
|---|---|
| DB_MAINTENANCE.md | Database maintenance, recovery, and configurable index directory |
| TESTING.md | Tests, reports, and quality gate |
| API_REFERENCE.md | Backend endpoint reference |
| CONTRIBUTING.md | Developer onboarding and contribution guidelines |
| adr/ | Architecture Decision Records |
Frontend Architecture
| Document | Description |
|---|---|
| FRONTEND_IMPERATIVE_DESIGN.md | Design rationale for imperative modules |
| FRONTEND_LIFECYCLE_CONVENTIONS.md | Component lifecycle conventions |
| VUE_MIGRATION_PLAN.md | Vue 3 migration plan (archival) |
| node-stream-reactivation.md | Node Stream feature reactivation guide |
Historical Documents
| Document | Description |
|---|---|
| PLAN_REFACTO_COMPLET_MAJOOR_ASSETS_MANAGER.md | V1 refactoring completion plan (archival) |
| PLAN_REFACTO_V2_LONG_TERME.md | V2 long-term refactoring plan (archival) |
Quality And Verification
Use the canonical gate from the repo root:
python scripts/run_quality_gate.py
Useful variants:
python scripts/run_quality_gate.py --python-only --skip-tests
tox -e quality
npm run test:js
The quality gate enforces:
- UTF-8 text files without BOM
rufflinting on changed Python files during the migration windowmypybanditpip-audit- xenon/radon complexity checks
- backend tests
- frontend tests
npm audit
Security Note
The backend keeps a compatibility-first local security model:
- loopback writes remain allowed by default
- remote writes are denied unless explicitly authorized
MAJOOR_REQUIRE_AUTH=1switches to strict token-auth for local writes too
Current releases also support a Settings-first remote setup flow:
Recommended Remote LAN Setupis the preferred one-click LAN path- the current browser session exposes its state through the runtime
Write auth:indicator inside Assets Manager
That nuance is intentional and is the documented target behavior for current releases.