from __future__ import annotations import tempfile import unittest from pathlib import Path from backend.routes.dashboard_routes import get_dashboard_summary from backend.routes.branch_routes import create_workflow_branch, list_workflow_branches, switch_workflow_branch from backend.routes.image_routes import ( archive_image, delete_image, get_image, list_node_images, select_image, ) from backend.routes.job_routes import cancel_job, get_job, list_jobs, retry_job from backend.routes.media_routes import fetch_media, sign_media from backend.routes.node_routes import ( generate_node, get_node, list_workflow_nodes, select_node_image, update_node, ) from backend.routes.profile_routes import ( create_profile, create_quick_profile_draft, delete_profile, get_profile, list_profiles, update_profile, ) from backend.routes.settings_routes import ( diff_settings, get_current_settings, get_settings_schema, validate_settings, ) from backend.routes.storage_routes import get_storage_status from backend.routes.ui_routes import get_ui_bootstrap from backend.routes.web_routes import get_web_manifest from backend.routes.workflow_routes import ( archive_workflow, create_profile_workflow, get_workflow, list_profile_workflows, start_workflow, ) from backend.services.dashboard_service import DashboardService from backend.services.image_service import ImageService from backend.services.media_service import MediaService from backend.services.profile_service import ProfileService from backend.services.queue_service import QueueService from backend.services.settings_service import SettingsService from backend.services.ui_service import UiService from backend.services.web_hosting_service import WebHostingService from backend.services.workflow_service import WorkflowService from core.audit_service import AuditService from core.config_service import ConfigService from core.identity import RequestContext from database.db_helper import Database, DatabaseSettings, SqliteSettings from database.repositories.image_repository import ImageRepository from database.repositories.job_repository import JobRepository from database.repositories.profile_repository import ProfileRepository from database.repositories.workflow_repository import WorkflowRepository class S2RouteTests(unittest.TestCase): def setUp(self): self.tmp = tempfile.TemporaryDirectory() self.root = Path(self.tmp.name) self.config_path = self.root / "config.yaml" images_path = (self.root / "images").as_posix() thumbnails_path = (self.root / "thumbnails").as_posix() materials_path = (self.root / "materials").as_posix() temp_path = (self.root / "temp").as_posix() self.config_path.write_text( f""" plugin: name: astrbot_plugin_imagestudio display_name: ImageStudio Test version: 3.0.1-test features: quick_profile: true workspace: true material_library: true wardrobe: false api_discovery: false storage: images_path: "{images_path}" thumbnails_path: "{thumbnails_path}" materials_path: "{materials_path}" temp_path: "{temp_path}" """, encoding="utf-8", ) for folder in ("images", "thumbnails", "materials", "temp"): (self.root / folder).mkdir(parents=True, exist_ok=True) (self.root / "images" / "sample.bin").write_bytes(b"12345") (self.root / "materials" / "sample.bin").write_bytes(b"abc") db_path = self.root / "imagestudio.db" self.database = Database(DatabaseSettings(sqlite=SqliteSettings(path=str(db_path)))) self.database.initialize() self.config_service = ConfigService(self.config_path) self.audit_service = AuditService(self.database) self.profile_repository = ProfileRepository(self.database) self.workflow_repository = WorkflowRepository(self.database) self.image_repository = ImageRepository(self.database) self.job_repository = JobRepository(self.database) self.profile_service = ProfileService( repository=self.profile_repository, audit_service=self.audit_service, ) self.workflow_service = WorkflowService( workflow_repository=self.workflow_repository, profile_repository=self.profile_repository, audit_service=self.audit_service, ) self.image_service = ImageService( image_repository=self.image_repository, workflow_repository=self.workflow_repository, audit_service=self.audit_service, ) self.queue_service = QueueService( repository=self.job_repository, audit_service=self.audit_service, ) self.settings_service = SettingsService(self.config_service) self.media_service = MediaService(self.config_service) self.web_hosting_service = WebHostingService() self.ctx = RequestContext.from_astrbot( username="admin", user_id="user_001", permissions={ "can_write", "can_manage_config", "can_manage_materials", "can_retry_tasks", }, ) def tearDown(self): self.tmp.cleanup() def test_ui_bootstrap_returns_v3_contract(self): response = get_ui_bootstrap( self.ctx, UiService(self.config_service), ) self.assertTrue(response["ok"]) self.assertEqual(response["request_id"], self.ctx.request_id) data = response["data"] self.assertEqual(data["plugin_name"], "astrbot_plugin_imagestudio") self.assertEqual(data["display_name"], "ImageStudio Test") self.assertEqual(data["plugin_version"], "3.0.1-test") self.assertEqual(data["dashboard_user"], "admin") self.assertTrue(data["permissions"]["can_read"]) self.assertTrue(data["permissions"]["can_manage_config"]) self.assertFalse(data["feature_flags"]["wardrobe"]) self.assertEqual( data["api_base"], "/api/v1/plugins/extensions/astrbot_plugin_imagestudio", ) def test_ui_bootstrap_requires_authentication(self): anonymous = RequestContext() response = get_ui_bootstrap(anonymous, UiService(self.config_service)) self.assertFalse(response["ok"]) self.assertEqual(response["error_code"], "UNAUTHORIZED") self.assertEqual(response["request_id"], anonymous.request_id) def test_dashboard_summary_uses_real_counts(self): profile = self.profile_service.create_profile({"name": "莉娅"}, self.ctx) detail = self.workflow_service.create_workflow( profile.profile_id, { "workflow_type": "single_image", "display_name": "单图流", }, self.ctx, ) self.image_service.create_image( { "node_id": detail.nodes[0].node_id, "image_uri": "storage://images/sample.png", "thumbnail_uri": "storage://thumbnails/sample.webp", }, self.ctx, ) response = get_dashboard_summary( self.ctx, DashboardService(self.database, self.config_service), ) self.assertTrue(response["ok"]) data = response["data"] self.assertEqual(data["plugin_status"], "running") self.assertEqual(data["active_profiles"], 1) self.assertEqual(data["queue"], {"pending": 0, "running": 0, "failed": 0, "dead_letter": 0}) self.assertEqual(len(data["recent_images"]), 1) self.assertGreaterEqual(data["storage"]["total_bytes"], 8) def test_dashboard_summary_uses_real_queue_counts(self): self.queue_service.create_task({"status": "queued"}, self.ctx) self.queue_service.create_task({"status": "running"}, self.ctx) self.queue_service.create_task({"status": "failed"}, self.ctx) self.queue_service.create_task({"status": "dead_letter"}, self.ctx) response = get_dashboard_summary( self.ctx, DashboardService(self.database, self.config_service), ) self.assertTrue(response["ok"]) self.assertEqual( response["data"]["queue"], {"pending": 1, "running": 1, "failed": 1, "dead_letter": 1}, ) self.assertEqual(len(response["data"]["recent_jobs"]), 4) def test_profile_crud_routes_return_wrapped_responses(self): created = create_profile( self.ctx, { "name": "莉娅", "description": "银白发少女", "default_model_route": "image_low", }, self.profile_service, ) self.assertTrue(created["ok"]) profile_id = created["data"]["profile_id"] self.assertEqual(created["data"]["name"], "莉娅") listed = list_profiles(self.ctx, {"page": "1", "page_size": "20"}, self.profile_service) self.assertTrue(listed["ok"]) self.assertEqual(listed["data"]["total"], 1) self.assertEqual(listed["data"]["items"][0]["profile_id"], profile_id) detail = get_profile(self.ctx, profile_id, self.profile_service) self.assertTrue(detail["ok"]) self.assertEqual(detail["data"]["description"], "银白发少女") updated = update_profile( self.ctx, profile_id, {"name": "莉娅 Nova", "style_prompt": "anime impasto"}, self.profile_service, ) self.assertTrue(updated["ok"]) self.assertEqual(updated["data"]["name"], "莉娅 Nova") deleted = delete_profile(self.ctx, profile_id, self.profile_service) self.assertTrue(deleted["ok"]) self.assertEqual(deleted["data"]["status"], "deleted") missing = get_profile(self.ctx, profile_id, self.profile_service) self.assertFalse(missing["ok"]) self.assertEqual(missing["error_code"], "RESOURCE_NOT_FOUND") def test_profile_write_routes_require_write_permission(self): read_only = RequestContext.from_astrbot(username="viewer", user_id="viewer_001") response = create_profile(read_only, {"name": "莉娅"}, self.profile_service) self.assertFalse(response["ok"]) self.assertEqual(response["error_code"], "FORBIDDEN") def test_quick_profile_draft_route_returns_preview(self): response = create_quick_profile_draft( self.ctx, { "questionnaire": { "name": "莉娅", "identity": "魔法学院学生", "personality": ["温柔", "安静"], "hair_color": "银白色", "hairstyle": "长发", "eye_color": "蓝色", "style": "二次元厚涂", "clothing_keywords": ["白色上衣", "蓝色短裙"], } }, ) self.assertTrue(response["ok"]) self.assertTrue(response["data"]["draft_id"].startswith("draft_")) preview = response["data"]["profile_preview"] self.assertEqual(preview["name"], "莉娅") self.assertIn("魔法学院学生", preview["base_prompt"]) self.assertIn("银白色 hair", preview["appearance_prompt"]) def test_job_routes_list_detail_cancel_and_retry(self): profile = self.profile_service.create_profile({"name": "Nova"}, self.ctx) workflow = self.workflow_service.create_workflow( profile.profile_id, {"workflow_type": "single_image", "display_name": "Job workflow"}, self.ctx, ) running_task = self.queue_service.create_task( { "profile_id": profile.profile_id, "workflow_id": workflow.workflow.workflow_id, "node_id": workflow.nodes[0].node_id, "status": "running", "model_route": "image_low", "request": {"prompt": "portrait"}, }, self.ctx, ) failed_task = self.queue_service.create_task( { "profile_id": profile.profile_id, "workflow_id": workflow.workflow.workflow_id, "node_id": workflow.nodes[0].node_id, "status": "failed", "error_message": "mock failure", }, self.ctx, ) listed = list_jobs( self.ctx, {"workflow_id": workflow.workflow.workflow_id, "page": "1", "page_size": "10"}, self.queue_service, ) self.assertTrue(listed["ok"]) self.assertEqual(listed["data"]["total"], 2) failed_only = list_jobs(self.ctx, {"status": "failed"}, self.queue_service) self.assertTrue(failed_only["ok"]) self.assertEqual(failed_only["data"]["items"][0]["task_id"], failed_task.task_id) detail = get_job(self.ctx, running_task.task_id, self.queue_service) self.assertTrue(detail["ok"]) self.assertEqual(detail["data"]["status"], "running") cancelled = cancel_job(self.ctx, running_task.task_id, self.queue_service) self.assertTrue(cancelled["ok"]) self.assertEqual(cancelled["data"]["status"], "cancelled") retried = retry_job(self.ctx, failed_task.task_id, self.queue_service) self.assertTrue(retried["ok"]) self.assertEqual(retried["data"]["status"], "queued") self.assertIsNone(retried["data"]["error_message"]) not_retryable = retry_job(self.ctx, failed_task.task_id, self.queue_service) self.assertFalse(not_retryable["ok"]) self.assertEqual(not_retryable["error_code"], "TASK_NOT_RETRYABLE") def test_job_write_routes_require_write_permission(self): task = self.queue_service.create_task({"status": "running"}, self.ctx) read_only = RequestContext.from_astrbot(username="viewer", user_id="viewer_001") response = cancel_job(read_only, task.task_id, self.queue_service) self.assertFalse(response["ok"]) self.assertEqual(response["error_code"], "FORBIDDEN") def test_settings_schema_current_validate_and_diff(self): self.config_path.write_text( """ plugin: name: astrbot_plugin_imagestudio display_name: ImageStudio Test version: 3.0.1-test features: quick_profile: true database: backend: postgresql postgresql: enabled: true dsn: "postgresql://user:secret@example.local/db" password: "secret" security: integration_token_set: true """, encoding="utf-8", ) schema = get_settings_schema(self.ctx, self.settings_service) self.assertTrue(schema["ok"]) self.assertEqual(schema["data"]["schema_version"], "3.0") self.assertIn("database", [section["key"] for section in schema["data"]["sections"]]) current = get_current_settings(self.ctx, self.settings_service) self.assertTrue(current["ok"]) config = current["data"]["config"] self.assertEqual(config["database"]["postgresql"]["dsn"], "***MASKED***") self.assertEqual(config["database"]["postgresql"]["password"], "***MASKED***") self.assertTrue(config["security"]["integration_token_set"]) validation = validate_settings( self.ctx, {"config": {"database": {"backend": "postgresql", "postgresql": {"enabled": True}}}}, self.settings_service, ) self.assertTrue(validation["ok"]) self.assertTrue(validation["data"]["valid"]) self.assertEqual(validation["data"]["warnings"][0]["field"], "database.postgresql") diff = diff_settings( self.ctx, { "config": { "database": { "backend": "postgresql", "postgresql": {"dsn": "postgresql://changed", "password": ""}, } } }, self.settings_service, ) self.assertTrue(diff["ok"]) sensitive_changes = [item for item in diff["data"]["changes"] if item["sensitive"]] self.assertTrue(sensitive_changes) self.assertNotIn("secret", str(diff["data"]["changes"])) def test_settings_manage_routes_require_config_permission(self): read_only = RequestContext.from_astrbot(username="viewer", user_id="viewer_001") response = validate_settings(read_only, {"config": {}}, self.settings_service) self.assertFalse(response["ok"]) self.assertEqual(response["error_code"], "FORBIDDEN") def test_settings_current_masks_absolute_paths(self): response = get_current_settings(self.ctx, self.settings_service) self.assertTrue(response["ok"]) storage = response["data"]["config"]["storage"] self.assertEqual(storage["images_path"], "***PATH***") self.assertEqual(storage["thumbnails_path"], "***PATH***") self.assertNotIn(str(self.root), str(response["data"])) def test_storage_status_and_media_signing_do_not_expose_real_paths(self): response = get_storage_status(self.ctx, self.media_service) self.assertTrue(response["ok"]) roots = {item["root"]: item for item in response["data"]["roots"]} self.assertIn("images", roots) self.assertEqual(roots["images"]["uri_prefix"], "storage://images/") self.assertGreaterEqual(roots["images"]["bytes"], 5) self.assertNotIn(str(self.root), str(response["data"])) signed = sign_media( self.ctx, {"uri": "storage://images/sample.bin"}, self.media_service, ) self.assertTrue(signed["ok"]) self.assertTrue(signed["data"]["url"].startswith("/api/v1/plugins/extensions/")) self.assertNotIn(str(self.root), str(signed["data"])) fetched = fetch_media( RequestContext(), {"token": signed["data"]["token"]}, self.media_service, ) self.assertTrue(fetched["ok"]) self.assertEqual(fetched["data"]["uri"], "storage://images/sample.bin") self.assertEqual(fetched["data"]["size_bytes"], 5) self.assertNotIn(str(self.root), str(fetched["data"])) def test_media_signing_rejects_unsafe_or_missing_uri(self): unsafe = sign_media( self.ctx, {"uri": "storage://images/../config.yaml"}, self.media_service, ) self.assertFalse(unsafe["ok"]) self.assertEqual(unsafe["error_code"], "FORBIDDEN") missing = sign_media( self.ctx, {"uri": "storage://images/missing.png"}, self.media_service, ) self.assertFalse(missing["ok"]) self.assertEqual(missing["error_code"], "MEDIA_NOT_FOUND") def test_web_manifest_returns_public_mounts_without_local_paths(self): response = get_web_manifest(self.ctx, self.web_hosting_service) self.assertTrue(response["ok"]) self.assertEqual( response["data"]["standalone_web"]["url"], "/api/v1/plugins/extensions/astrbot_plugin_imagestudio/web", ) self.assertIn("built", response["data"]["plugin_page"]) self.assertNotIn(str(self.root), str(response["data"])) self.assertNotIn("C:\\", str(response["data"])) def test_workflow_node_image_routes_return_wrapped_responses(self): profile = self.profile_service.create_profile({"name": "Nova"}, self.ctx) created_workflow = create_profile_workflow( self.ctx, profile.profile_id, {"workflow_type": "single_image", "display_name": "Single image"}, self.workflow_service, ) self.assertTrue(created_workflow["ok"]) workflow = created_workflow["data"]["workflow"] node = created_workflow["data"]["nodes"][0] workflow_id = workflow["workflow_id"] node_id = node["node_id"] self.assertEqual(workflow["workflow_type"], "single_image") self.assertEqual(node["node_key"], "virtual_single_image") listed_workflows = list_profile_workflows(self.ctx, profile.profile_id, self.workflow_service) self.assertTrue(listed_workflows["ok"]) self.assertEqual([item["workflow_id"] for item in listed_workflows["data"]], [workflow_id]) started = start_workflow(self.ctx, workflow_id, self.workflow_service) self.assertTrue(started["ok"]) self.assertEqual(started["data"]["status"], "running") detail = get_workflow(self.ctx, workflow_id, self.workflow_service) self.assertTrue(detail["ok"]) self.assertEqual(detail["data"]["workflow"]["status"], "running") self.assertEqual(detail["data"]["nodes"][0]["node_id"], node_id) listed_nodes = list_workflow_nodes(self.ctx, workflow_id, self.workflow_service) self.assertTrue(listed_nodes["ok"]) self.assertEqual(listed_nodes["data"][0]["node_id"], node_id) updated_node = update_node( self.ctx, node_id, {"prompt": "portrait, clean line art", "model_route": "image_low"}, self.workflow_service, ) self.assertTrue(updated_node["ok"]) self.assertEqual(updated_node["data"]["prompt"], "portrait, clean line art") generated = generate_node( self.ctx, node_id, {"prompt_patch": "white shirt", "model_route": "image_low", "count": 2}, self.workflow_service, ) self.assertTrue(generated["ok"]) self.assertIsNone(generated["data"]["task_id"]) self.assertEqual(generated["data"]["node_status"], "queued") queued_node = get_node(self.ctx, node_id, self.workflow_service) self.assertTrue(queued_node["ok"]) self.assertEqual(queued_node["data"]["status"], "queued") self.assertTrue(queued_node["data"]["metadata"]["queue_placeholder"]) first_image = self.image_service.create_image( {"node_id": node_id, "image_uri": "storage://images/first.png"}, self.ctx, ) second_image = self.image_service.create_image( {"node_id": node_id, "image_uri": "storage://images/second.png"}, self.ctx, ) selected_by_node = select_node_image( self.ctx, node_id, {"image_id": first_image.image_id}, self.image_service, self.workflow_service, ) self.assertTrue(selected_by_node["ok"]) self.assertTrue(selected_by_node["data"]["is_selected"]) selected_by_image = select_image(self.ctx, second_image.image_id, self.image_service) self.assertTrue(selected_by_image["ok"]) self.assertTrue(selected_by_image["data"]["is_selected"]) self.assertFalse(get_image(self.ctx, first_image.image_id, self.image_service)["data"]["is_selected"]) self.assertEqual( get_node(self.ctx, node_id, self.workflow_service)["data"]["selected_image_id"], second_image.image_id, ) visible_images = list_node_images(self.ctx, node_id, {}, self.image_service) self.assertTrue(visible_images["ok"]) self.assertEqual( {image["image_id"] for image in visible_images["data"]}, {first_image.image_id, second_image.image_id}, ) archived = archive_image(self.ctx, second_image.image_id, self.image_service) self.assertTrue(archived["ok"]) self.assertTrue(archived["data"]["is_archived"]) visible_after_archive = list_node_images(self.ctx, node_id, {}, self.image_service) self.assertEqual([image["image_id"] for image in visible_after_archive["data"]], [first_image.image_id]) all_images = list_node_images( self.ctx, node_id, {"include_archived": "true"}, self.image_service, ) self.assertEqual( {image["image_id"] for image in all_images["data"]}, {first_image.image_id, second_image.image_id}, ) deleted = delete_image(self.ctx, first_image.image_id, self.image_service) self.assertTrue(deleted["ok"]) missing = get_image(self.ctx, first_image.image_id, self.image_service) self.assertFalse(missing["ok"]) self.assertEqual(missing["error_code"], "RESOURCE_NOT_FOUND") archived_workflow = archive_workflow(self.ctx, workflow_id, self.workflow_service) self.assertTrue(archived_workflow["ok"]) self.assertEqual(archived_workflow["data"]["status"], "archived") def test_workflow_and_node_write_routes_require_write_permission(self): profile = self.profile_service.create_profile({"name": "Nova"}, self.ctx) read_only = RequestContext.from_astrbot(username="viewer", user_id="viewer_001") denied_workflow = create_profile_workflow( read_only, profile.profile_id, {"workflow_type": "single_image", "display_name": "Denied"}, self.workflow_service, ) self.assertFalse(denied_workflow["ok"]) self.assertEqual(denied_workflow["error_code"], "FORBIDDEN") workflow = self.workflow_service.create_workflow( profile.profile_id, {"workflow_type": "single_image", "display_name": "Allowed"}, self.ctx, ) denied_generate = generate_node( read_only, workflow.nodes[0].node_id, {"model_route": "image_low"}, self.workflow_service, ) self.assertFalse(denied_generate["ok"]) self.assertEqual(denied_generate["error_code"], "FORBIDDEN") def test_workflow_branch_routes_wrap_responses(self): profile = self.profile_service.create_profile({"name": "Nova"}, self.ctx) workflow = self.workflow_service.create_workflow( profile.profile_id, {"workflow_type": "character_fast", "display_name": "Fast"}, self.ctx, ) created = create_workflow_branch( self.ctx, workflow.workflow.workflow_id, {"branch_name": "alt_pose"}, self.workflow_service, ) self.assertTrue(created["ok"]) self.assertEqual(created["data"]["branch_name"], "alt_pose") listed = list_workflow_branches(self.ctx, workflow.workflow.workflow_id, self.workflow_service) self.assertTrue(listed["ok"]) self.assertEqual([branch["branch_name"] for branch in listed["data"]], ["alt_pose"]) switched = switch_workflow_branch( self.ctx, workflow.workflow.workflow_id, {"branch_name": "alt_pose"}, self.workflow_service, ) self.assertTrue(switched["ok"]) self.assertEqual(switched["data"]["current_branch"], "alt_pose") read_only = RequestContext.from_astrbot(username="viewer", user_id="viewer_001") denied = create_workflow_branch( read_only, workflow.workflow.workflow_id, {"branch_name": "denied"}, self.workflow_service, ) self.assertFalse(denied["ok"]) self.assertEqual(denied["error_code"], "FORBIDDEN") if __name__ == "__main__": unittest.main()