astrbot_plugin_imagestudio/database/models.py

499 行
17 KiB
Python

"""Lightweight SQL table metadata for ImageStudio."""
from __future__ import annotations
from dataclasses import dataclass, field
@dataclass(frozen=True)
class ColumnSpec:
name: str
nullable: bool = True
sensitive: bool = False
@dataclass(frozen=True)
class TableSpec:
name: str
primary_key: str
columns: tuple[ColumnSpec, ...] = field(default_factory=tuple)
def column_names(self) -> list[str]:
return [column.name for column in self.columns]
def sensitive_columns(self) -> list[str]:
return [column.name for column in self.columns if column.sensitive]
TABLES: tuple[TableSpec, ...] = (
TableSpec(
"character_profiles",
"profile_id",
(
ColumnSpec("profile_id", nullable=False),
ColumnSpec("owner_user_id"),
ColumnSpec("name", nullable=False),
ColumnSpec("status", nullable=False),
ColumnSpec("metadata_json"),
),
),
TableSpec(
"profile_workflows",
"workflow_id",
(
ColumnSpec("workflow_id", nullable=False),
ColumnSpec("profile_id", nullable=False),
ColumnSpec("workflow_type", nullable=False),
ColumnSpec("status", nullable=False),
ColumnSpec("current_node_id"),
),
),
TableSpec(
"workflow_nodes",
"node_id",
(
ColumnSpec("node_id", nullable=False),
ColumnSpec("workflow_id", nullable=False),
ColumnSpec("node_key", nullable=False),
ColumnSpec("status", nullable=False),
ColumnSpec("metadata_json"),
),
),
TableSpec(
"generation_tasks",
"task_id",
(
ColumnSpec("task_id", nullable=False),
ColumnSpec("profile_id"),
ColumnSpec("workflow_id"),
ColumnSpec("node_id"),
ColumnSpec("task_type", nullable=False),
ColumnSpec("status", nullable=False),
ColumnSpec("model_route"),
ColumnSpec("progress", nullable=False),
ColumnSpec("idempotency_key"),
ColumnSpec("request_json"),
ColumnSpec("result_json"),
ColumnSpec("error_message"),
ColumnSpec("metadata_json"),
),
),
TableSpec(
"generation_images",
"image_id",
(
ColumnSpec("image_id", nullable=False),
ColumnSpec("profile_id"),
ColumnSpec("workflow_id"),
ColumnSpec("node_id"),
ColumnSpec("task_id"),
ColumnSpec("batch_id"),
ColumnSpec("image_uri", nullable=False),
ColumnSpec("thumbnail_uri"),
ColumnSpec("positive_prompt"),
ColumnSpec("negative_prompt"),
ColumnSpec("model_used"),
ColumnSpec("model_route"),
ColumnSpec("is_selected", nullable=False),
ColumnSpec("is_archived", nullable=False),
ColumnSpec("metadata_json"),
),
),
TableSpec(
"workflow_history",
"history_id",
(
ColumnSpec("history_id", nullable=False),
ColumnSpec("profile_id"),
ColumnSpec("workflow_id", nullable=False),
ColumnSpec("node_id"),
ColumnSpec("image_id"),
ColumnSpec("branch_name", nullable=False),
ColumnSpec("action", nullable=False),
ColumnSpec("title"),
ColumnSpec("prompt"),
ColumnSpec("metadata_json"),
),
),
TableSpec(
"workflow_branches",
"branch_id",
(
ColumnSpec("branch_id", nullable=False),
ColumnSpec("workflow_id", nullable=False),
ColumnSpec("branch_name", nullable=False),
ColumnSpec("base_branch_name"),
ColumnSpec("base_node_id"),
ColumnSpec("status", nullable=False),
ColumnSpec("metadata_json"),
),
),
TableSpec(
"workflow_generation_rounds",
"round_id",
(
ColumnSpec("round_id", nullable=False),
ColumnSpec("workflow_id", nullable=False),
ColumnSpec("node_id", nullable=False),
ColumnSpec("branch_name", nullable=False),
ColumnSpec("round_kind", nullable=False),
ColumnSpec("round_number", nullable=False),
ColumnSpec("display_code", nullable=False),
ColumnSpec("parent_round_id"),
ColumnSpec("status", nullable=False),
ColumnSpec("requested_count", nullable=False),
ColumnSpec("idempotency_key"),
ColumnSpec("prompt_snapshot_json"),
ColumnSpec("reference_snapshot_json"),
ColumnSpec("feedback_snapshot_json"),
ColumnSpec("metadata_json"),
),
),
TableSpec(
"workflow_generation_candidates",
"candidate_id",
(
ColumnSpec("candidate_id", nullable=False),
ColumnSpec("origin_round_id", nullable=False),
ColumnSpec("candidate_index", nullable=False),
ColumnSpec("generation_status", nullable=False),
ColumnSpec("image_id"),
ColumnSpec("current_task_id"),
ColumnSpec("source_candidate_id"),
ColumnSpec("model_route"),
ColumnSpec("provider_id"),
ColumnSpec("provider_model"),
ColumnSpec("prompt_snapshot_json"),
ColumnSpec("failure_json"),
ColumnSpec("metadata_json"),
),
),
TableSpec(
"workflow_round_candidate_pool",
"round_id,candidate_id",
(
ColumnSpec("round_id", nullable=False),
ColumnSpec("candidate_id", nullable=False),
ColumnSpec("display_index", nullable=False),
ColumnSpec("display_code", nullable=False),
ColumnSpec("pool_state", nullable=False),
ColumnSpec("preference_status", nullable=False),
ColumnSpec("preference_reason"),
ColumnSpec("is_final", nullable=False),
ColumnSpec("metadata_json"),
),
),
TableSpec(
"character_profile_cards",
"card_id",
(
ColumnSpec("card_id", nullable=False),
ColumnSpec("profile_id", nullable=False),
ColumnSpec("workflow_id", nullable=False),
ColumnSpec("branch_name", nullable=False),
ColumnSpec("version", nullable=False),
ColumnSpec("status", nullable=False),
ColumnSpec("persona_document", nullable=False),
ColumnSpec("idempotency_key"),
ColumnSpec("metadata_json"),
),
),
TableSpec(
"character_profile_card_assets",
"asset_id",
(
ColumnSpec("asset_id", nullable=False),
ColumnSpec("card_id", nullable=False),
ColumnSpec("asset_role", nullable=False),
ColumnSpec("image_id", nullable=False),
ColumnSpec("image_uri", nullable=False),
ColumnSpec("metadata_json"),
),
),
TableSpec(
"material_categories",
"category_id",
(
ColumnSpec("category_id", nullable=False),
ColumnSpec("name", nullable=False),
ColumnSpec("parent_id"),
ColumnSpec("category_type", nullable=False),
ColumnSpec("sort_order", nullable=False),
),
),
TableSpec(
"materials",
"material_id",
(
ColumnSpec("material_id", nullable=False),
ColumnSpec("category_id"),
ColumnSpec("display_name", nullable=False),
ColumnSpec("image_uri"),
ColumnSpec("recognition_status", nullable=False),
),
),
TableSpec(
"advanced_material_imports",
"import_id",
(
ColumnSpec("import_id", nullable=False),
ColumnSpec("category_id"),
ColumnSpec("display_name", nullable=False),
ColumnSpec("source_image_uri", nullable=False),
ColumnSpec("source_thumbnail_uri"),
ColumnSpec("status", nullable=False),
ColumnSpec("recognition_prompt"),
ColumnSpec("recognition_negative_prompt"),
ColumnSpec("recognition_tags_json"),
ColumnSpec("recognition_result_json"),
ColumnSpec("recognition_model_route"),
ColumnSpec("prompt_revision", nullable=False),
ColumnSpec("current_attempt_id"),
ColumnSpec("accepted_material_id"),
ColumnSpec("idempotency_key"),
ColumnSpec("created_by"),
ColumnSpec("error_json"),
ColumnSpec("metadata_json"),
),
),
TableSpec(
"advanced_material_validation_attempts",
"attempt_id",
(
ColumnSpec("attempt_id", nullable=False),
ColumnSpec("import_id", nullable=False),
ColumnSpec("attempt_number", nullable=False),
ColumnSpec("status", nullable=False),
ColumnSpec("adjustment_text"),
ColumnSpec("prompt", nullable=False),
ColumnSpec("negative_prompt"),
ColumnSpec("model_route"),
ColumnSpec("provider_id"),
ColumnSpec("provider_model"),
ColumnSpec("task_id"),
ColumnSpec("validation_image_uri"),
ColumnSpec("validation_thumbnail_uri"),
ColumnSpec("seed"),
ColumnSpec("width"),
ColumnSpec("height"),
ColumnSpec("usage_json"),
ColumnSpec("fidelity_score"),
ColumnSpec("decision"),
ColumnSpec("decision_notes"),
ColumnSpec("error_json"),
ColumnSpec("metadata_json"),
ColumnSpec("completed_at"),
ColumnSpec("decided_at"),
),
),
TableSpec(
"advanced_materials",
"material_id",
(
ColumnSpec("material_id", nullable=False),
ColumnSpec("import_id", nullable=False),
ColumnSpec("accepted_attempt_id", nullable=False),
ColumnSpec("category_id"),
ColumnSpec("display_name", nullable=False),
ColumnSpec("source_image_uri", nullable=False),
ColumnSpec("source_thumbnail_uri"),
ColumnSpec("validation_image_uri", nullable=False),
ColumnSpec("validation_thumbnail_uri"),
ColumnSpec("prompt", nullable=False),
ColumnSpec("negative_prompt"),
ColumnSpec("tags_json"),
ColumnSpec("priority", nullable=False),
ColumnSpec("status", nullable=False),
ColumnSpec("capsule_json"),
ColumnSpec("metadata_json"),
ColumnSpec("accepted_at", nullable=False),
ColumnSpec("archived_at"),
),
),
TableSpec(
"advanced_style_sources",
"source_id",
(
ColumnSpec("source_id", nullable=False),
ColumnSpec("import_id", nullable=False),
ColumnSpec("sort_order", nullable=False),
ColumnSpec("is_primary", nullable=False),
ColumnSpec("source_image_uri", nullable=False),
ColumnSpec("source_thumbnail_uri"),
ColumnSpec("status", nullable=False),
ColumnSpec("recognition_model_route"),
ColumnSpec("provider_id"),
ColumnSpec("provider_model"),
ColumnSpec("task_id"),
ColumnSpec("recognition_prompt"),
ColumnSpec("recognition_negative_prompt"),
ColumnSpec("recognition_tags_json"),
ColumnSpec("recognition_result_json"),
ColumnSpec("error_json"),
ColumnSpec("metadata_json"),
ColumnSpec("completed_at"),
ColumnSpec("excluded_at"),
),
),
TableSpec(
"advanced_style_consensus_runs",
"consensus_id",
(
ColumnSpec("consensus_id", nullable=False),
ColumnSpec("import_id", nullable=False),
ColumnSpec("revision", nullable=False),
ColumnSpec("status", nullable=False),
ColumnSpec("task_id"),
ColumnSpec("model_route"),
ColumnSpec("provider_id"),
ColumnSpec("provider_model"),
ColumnSpec("source_ids_json"),
ColumnSpec("prompt"),
ColumnSpec("negative_prompt"),
ColumnSpec("tags_json"),
ColumnSpec("result_json"),
ColumnSpec("error_json"),
ColumnSpec("metadata_json"),
ColumnSpec("completed_at"),
),
),
TableSpec(
"advanced_style_validation_cases",
"case_id",
(
ColumnSpec("case_id", nullable=False),
ColumnSpec("attempt_id", nullable=False),
ColumnSpec("import_id", nullable=False),
ColumnSpec("case_key", nullable=False),
ColumnSpec("sort_order", nullable=False),
ColumnSpec("status", nullable=False),
ColumnSpec("task_id"),
ColumnSpec("content_prompt", nullable=False),
ColumnSpec("final_prompt", nullable=False),
ColumnSpec("negative_prompt"),
ColumnSpec("model_route"),
ColumnSpec("provider_id"),
ColumnSpec("provider_model"),
ColumnSpec("seed"),
ColumnSpec("width"),
ColumnSpec("height"),
ColumnSpec("validation_image_uri"),
ColumnSpec("validation_thumbnail_uri"),
ColumnSpec("usage_json"),
ColumnSpec("style_review_json"),
ColumnSpec("fidelity_score"),
ColumnSpec("error_json"),
ColumnSpec("metadata_json"),
ColumnSpec("completed_at"),
),
),
TableSpec(
"audit_logs",
"audit_id",
(
ColumnSpec("audit_id", nullable=False),
ColumnSpec("actor_id"),
ColumnSpec("action", nullable=False),
ColumnSpec("target_type", nullable=False),
ColumnSpec("target_id"),
),
),
TableSpec(
"config_snapshots",
"snapshot_id",
(
ColumnSpec("snapshot_id", nullable=False),
ColumnSpec("reason", nullable=False),
ColumnSpec("actor_id"),
ColumnSpec("config_json", nullable=False, sensitive=True),
),
),
TableSpec(
"wardrobe_items",
"wardrobe_item_id",
(
ColumnSpec("wardrobe_item_id", nullable=False),
ColumnSpec("profile_id", nullable=False),
ColumnSpec("material_id", nullable=False),
ColumnSpec("wardrobe_category", nullable=False),
ColumnSpec("tags_json"),
ColumnSpec("season"),
ColumnSpec("style"),
ColumnSpec("is_favorite", nullable=False),
ColumnSpec("usage_count", nullable=False),
ColumnSpec("last_used_at"),
),
),
TableSpec(
"advanced_wardrobe_items",
"wardrobe_item_id",
(
ColumnSpec("wardrobe_item_id", nullable=False),
ColumnSpec("profile_id", nullable=False),
ColumnSpec("material_id", nullable=False),
ColumnSpec("wardrobe_category", nullable=False),
ColumnSpec("tags_json"),
ColumnSpec("season"),
ColumnSpec("style"),
ColumnSpec("is_favorite", nullable=False),
ColumnSpec("usage_count", nullable=False),
ColumnSpec("last_used_at"),
),
),
TableSpec(
"integration_logs",
"integration_log_id",
(
ColumnSpec("integration_log_id", nullable=False),
ColumnSpec("integration_name", nullable=False),
ColumnSpec("action", nullable=False),
ColumnSpec("status", nullable=False),
ColumnSpec("request_json"),
ColumnSpec("response_json"),
ColumnSpec("error_message"),
),
),
TableSpec(
"backend_capability_profiles",
"capability_profile_id",
(
ColumnSpec("capability_profile_id", nullable=False),
ColumnSpec("provider_id", nullable=False),
ColumnSpec("model_id", nullable=False),
ColumnSpec("dialect", nullable=False),
ColumnSpec("status", nullable=False),
ColumnSpec("capabilities_json"),
ColumnSpec("probe_result_json"),
),
),
2026-07-06 01:53:03 +08:00
TableSpec(
"model_providers",
"provider_id",
(
ColumnSpec("provider_id", nullable=False),
ColumnSpec("display_name", nullable=False),
ColumnSpec("provider_type", nullable=False),
ColumnSpec("base_url", nullable=False),
ColumnSpec("api_key_env_var", sensitive=True),
2026-07-06 01:53:03 +08:00
ColumnSpec("api_key_secret_ref", sensitive=True),
ColumnSpec("extra_headers_json", sensitive=True),
2026-07-06 01:53:03 +08:00
),
),
TableSpec(
"model_routes",
"route_id",
(
ColumnSpec("route_id", nullable=False),
ColumnSpec("route_name", nullable=False),
ColumnSpec("provider_id", nullable=False),
ColumnSpec("model_id", nullable=False),
ColumnSpec("modality", nullable=False),
),
),
)
def table_spec(table_name: str) -> TableSpec | None:
normalized = str(table_name or "").strip()
return next((table for table in TABLES if table.name == normalized), None)