astrbot_plugin_imagestudio/backend/services/orphan_media_service.py
2026-07-06 03:22:13 +08:00

46 行
1.8 KiB
Python

"""Find storage files that are not referenced by database records."""
from __future__ import annotations
from typing import Any
from backend.services.media_index_service import MediaIndexService
from database.db_helper import Database
class OrphanMediaService:
def __init__(self, database: Database, media_index_service: MediaIndexService):
self.database = database
self.media_index_service = media_index_service
def scan(self, *, root: str | None = None, limit: int = 500) -> dict[str, Any]:
references = self._referenced_uris()
index = self.media_index_service.index_files(root=root, limit=limit)
orphans = [item for item in index["items"] if item["uri"] not in references]
return {
"root": root,
"total_indexed": len(index["items"]),
"total_files": index["total"],
"index_truncated": index["truncated"],
"referenced_uri_count": len(references),
"orphan_count": len(orphans),
"orphans": orphans,
}
def _referenced_uris(self) -> set[str]:
refs: set[str] = set()
conn = self.database.connect()
try:
for table, columns in (
("generation_images", ("image_uri", "thumbnail_uri")),
("materials", ("image_uri", "thumbnail_uri")),
("character_profiles", ("avatar_image_uri",)),
):
for row in conn.execute(f"SELECT {', '.join(columns)} FROM {table}").fetchall():
for column in columns:
uri = str(row[column] or "").strip()
if uri.startswith("storage://"):
refs.add(uri)
finally:
conn.close()
return refs