mirror of
https://github.com/willmiao/ComfyUI-Lora-Manager.git
synced 2026-08-28 16:31:28 -03:00
Will Miao
574dfbbe55
Add LORA_MANAGER_SETTINGS_DIR env var and standalone --settings-path to pin the settings location (settings.json, cache/, wildcards/, backups/, logs/, stats/) to an arbitrary directory. The override takes precedence over portable mode and the platform user config dir, and skips legacy migration, so sandboxed dev/E2E runs no longer need to write settings.json in the repo root or collide with the real instance. standalone.py pre-scans argv for --settings-path at import time because the settings location is resolved before main() parses arguments. SettingsManager portable-switch migration is a no-op while the directory is pinned. Update the lora-manager-e2e skill (prefer --settings-path sandboxing; start_server.py passes it through) and the lora-manager-runtime-context skill (document precedence; inspect script honors the override).
81 lines
5.0 KiB
Markdown
81 lines
5.0 KiB
Markdown
---
|
|
name: lora-manager-runtime-context
|
|
description: Inspect ComfyUI LoRA Manager runtime configuration and local diagnostic state. Use when debugging LoRA Manager issues that require locating or reading settings.json, active library paths, model metadata JSON sidecars, recipe metadata JSON files, example image folders, SQLite caches, symlink maps, download history, aria2 state, or other cache files under the LoRA Manager user config directory.
|
|
---
|
|
|
|
# LoRA Manager Runtime Context
|
|
|
|
## Core Rules
|
|
|
|
- Treat runtime state as local user data. Prefer read-only inspection unless the user explicitly asks for mutation.
|
|
- Never print secret-like settings values. Redact keys containing `key`, `token`, `secret`, `password`, `auth`, or `credential`, including `civitai_api_key`.
|
|
- Resolve paths from the runtime configuration before guessing. Settings-directory precedence (highest first):
|
|
1. **Explicit override** — env `LORA_MANAGER_SETTINGS_DIR` or standalone `--settings-path` (also accepted by the inspect script as `--settings-path DIR`). Pins EVERYTHING (`settings.json`, `cache/`, `wildcards/`, `backups/`, `logs/`, `stats/`) under the given directory; bypasses portable mode and the user config dir. Common when inspecting a sandboxed/E2E instance.
|
|
2. **Portable** — repository `<repo-root>/settings.json` with `"use_portable_settings": true` (or `LORA_MANAGER_PORTABLE=1`): settings dir = `<repo-root>`.
|
|
3. **Default** — `~/.config/ComfyUI-LoRA-Manager` on this machine (`platformdirs.user_config_dir("ComfyUI-LoRA-Manager", appauthor=False)`).
|
|
- Use the active library when selecting per-library caches and paths. Read `active_library` from settings; fall back to `default` if missing.
|
|
- Normalize and expand `~` before comparing paths. Symlinks are common in this repo.
|
|
|
|
## Quick Start
|
|
|
|
Use the bundled helper for a safe first pass:
|
|
|
|
```bash
|
|
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py summary
|
|
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py caches
|
|
```
|
|
|
|
The script redacts sensitive settings, opens SQLite databases read-only, and reports inaccessible or locked databases as warnings.
|
|
|
|
For focused checks:
|
|
|
|
```bash
|
|
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py recipes
|
|
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py model --path /path/to/model.safetensors
|
|
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py sqlite --db /path/to/cache.sqlite --limit 3
|
|
```
|
|
|
|
To inspect a sandboxed/E2E instance that pins its settings directory:
|
|
|
|
```bash
|
|
# --settings-path DIR (or LORA_MANAGER_SETTINGS_DIR) works with every subcommand:
|
|
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py \
|
|
--settings-path /tmp/opencode/<plan>-e2e/settings summary
|
|
```
|
|
|
|
## Runtime Path Rules
|
|
|
|
- Settings directory: resolve via `py/utils/settings_paths.py` — `get_settings_dir()` honors the `LORA_MANAGER_SETTINGS_DIR` / programmatic override first, then portable mode, then `platformdirs.user_config_dir("ComfyUI-LoRA-Manager", appauthor=False)`. The inspect script mirrors this precedence in `resolve_settings_path()`.
|
|
- Settings file: `<settings_dir>/settings.json`.
|
|
- Cache root: `<settings_dir>/cache`.
|
|
- Canonical cache files:
|
|
- Model cache: `cache/model/<active_library>.sqlite`.
|
|
- Recipe cache: `cache/recipe/<active_library>.sqlite`.
|
|
- Model update cache: `cache/model_update/<active_library>.sqlite`.
|
|
- Recipe FTS: `cache/fts/recipe_fts.sqlite`.
|
|
- Tag FTS: `cache/fts/tag_fts.sqlite`.
|
|
- Symlink map: `cache/symlink/symlink_map.json`.
|
|
- Download history: `cache/download_history/downloaded_versions.sqlite`.
|
|
- aria2 state: `cache/aria2/downloads.json`.
|
|
- Legacy cache locations may exist; prefer canonical paths unless diagnosing migrations.
|
|
|
|
## Data Location Rules
|
|
|
|
- Model roots come from `settings.folder_paths` and the active library payload under `settings.libraries[active_library]`.
|
|
- Model metadata JSON sidecars live next to the model file as `<model basename>.metadata.json`.
|
|
- Recipes root is `settings.recipes_path` when it is a non-empty string. If empty, use the first configured LoRA root plus `/recipes`.
|
|
- Recipe JSON files are named `*.recipe.json` under the recipes root and may be nested in folders.
|
|
- Example image root is `settings.example_images_path`.
|
|
- If multiple libraries are configured, example images are stored under `<example_images_path>/<sanitized_library>/<sha256>/`; otherwise they are under `<example_images_path>/<sha256>/`.
|
|
|
|
## Useful Cache Tables
|
|
|
|
- Model cache: `models`, `model_tags`, `hash_index`, `excluded_models`.
|
|
- Recipe cache: `recipes`, `cache_metadata`.
|
|
- Model update cache: `model_update_status`, `model_update_versions`.
|
|
- Tag FTS cache: `tags`, `fts_metadata`, plus FTS internal tables.
|
|
- Recipe FTS cache: `recipe_rowid`, `fts_metadata`, plus FTS internal tables.
|
|
- Download history: `downloaded_model_versions`.
|
|
|
|
Prefer querying only counts, schema, and a few sample rows unless the user asks for full output.
|