refactor: strengthen architecture CI gates and runtime contracts

app/api/context.py

@@ -5,24 +5,24 @@ from typing import cast
 
 from fastapi import Depends, Request
 
-from app.application.messaging.chat import AsyncAgentChatRepository, AsyncUnitOfWork
-from app.application.outbox import AsyncOutboxTransaction
 from app.application.configuration import (
     ApiRuntimeConfig,
     get_api_runtime_config_snapshot,
 )
+from app.application.messaging.chat import AsyncAgentChatRepository, AsyncUnitOfWork
+from app.application.outbox import AsyncOutboxTransaction
 from app.application.subscription.delete import SubscribeDeletionRepository
 from app.application.subscription.identity import SubscribeIdentityDeletionRepository
 from app.application.subscription.mutation import (
     SubscriptionHistoryMutationRepository,
     SubscriptionMutationRepository,
 )
+from app.runtime.tasks import TaskRegistry, get_task_registry
 from app.startup.composition.context import (
     AgentChatRuntime,
     HostRuntime,
     SubscriptionRuntime,
 )
-from app.runtime.tasks import TaskRegistry, get_task_registry
 
 
 def get_host_runtime(request: Request) -> HostRuntime:

app/api/data.py

@@ -5,7 +5,6 @@ from __future__ import annotations
 from collections.abc import AsyncGenerator, Callable, Generator
 from typing import Any
 
-
 SessionProvider = Callable[[], Generator[Any, None, None]]
 AsyncSessionProvider = Callable[[], AsyncGenerator[Any, None]]
 RepositoryFactory = Callable[[Any], Any]

app/api/dependencies/agent.py

@@ -4,15 +4,15 @@ from fastapi import Depends
 from sqlalchemy.ext.asyncio import AsyncSession
 
 from app.api.context import (
-    get_agent_chat_runtime,
     get_agent_chat_repository,
+    get_agent_chat_runtime,
     get_agent_chat_transaction,
     get_async_session,
     get_host_runtime,
 )
 from app.application.messaging.chat import (
-    AgentChatService,
     AgentChatPersistenceService,
+    AgentChatService,
     AsyncAgentChatRepository,
     AsyncUnitOfWork,
 )

app/api/dependencies/subscription.py

@@ -9,25 +9,33 @@ from sqlalchemy.orm import Session
 from app.adapters.external.server import MoviePilotServerHelper
 from app.api.context import (
     get_async_session,
+    get_background_task_registry,
     get_host_runtime,
     get_subscription_history_repository,
     get_subscription_outbox,
     get_subscription_repository,
     get_subscription_transaction,
     get_sync_session,
+    resolve_background_task_registry,
 )
 from app.application.outbox import AsyncOutboxTransaction
 from app.application.scheduling import start_scheduler_job
 from app.application.servarr import ServarrSubscriptionService
 from app.application.subscription.delete import (
     AsyncUnitOfWork as DeleteUnitOfWork,
+)
+from app.application.subscription.delete import (
     DeleteSubscribeCommand,
     SubscribeDeletionRepository,
 )
-from app.application.subscription.identity import DeleteSubscriptionsByIdentityCommand
-from app.application.subscription.identity import SubscribeIdentityDeletionRepository
+from app.application.subscription.identity import (
+    DeleteSubscriptionsByIdentityCommand,
+    SubscribeIdentityDeletionRepository,
+)
 from app.application.subscription.mutation import (
     AsyncUnitOfWork as MutationUnitOfWork,
+)
+from app.application.subscription.mutation import (
     SubscriptionHistoryMutationRepository,
     SubscriptionMutationRepository,
     SubscriptionMutationService,
@@ -36,10 +44,9 @@ from app.application.subscription.query import SubscriptionQueryService
 from app.application.subscription.search import SearchSubscriptionsCommand
 from app.runtime.events import eventmanager
 from app.runtime.log import logger
+from app.runtime.tasks import TaskRegistry
 from app.schemas.types import EventType
 from app.startup.composition.context import HostRuntime
-from app.api.context import get_background_task_registry, resolve_background_task_registry
-from app.runtime.tasks import TaskRegistry
 
 
 async def _publish_subscribe_deleted(

app/api/dependencies/workflow.py

@@ -16,7 +16,7 @@ from app.application.workflow import (
     WorkflowQueryService,
     get_workflow_manager,
 )
-from app.runtime.config import global_vars
+from app.runtime.stop import runtime_stop_state
 from app.startup.composition.context import HostRuntime
 
 
@@ -36,7 +36,7 @@ def get_workflow_mutation_command(
         load_event=workflow_manager.load_workflow_events,
         remove_event=workflow_manager.remove_workflow_event,
         refresh_event=workflow_manager.update_workflow_event,
-        stop_running=global_vars.stop_workflow,
+        stop_running=runtime_stop_state.stop_workflow,
         delete_cache=lambda workflow_id: system_config.delete(
             f"WorkflowCache-{workflow_id}"
         ),
@@ -52,7 +52,7 @@ def get_workflow_definition_command(
     return WorkflowDefinitionCommand(
         repository=runtime.workflow.repository(db),
         unit_of_work=runtime.persistence.async_transaction(db),
-        stop_running=global_vars.stop_workflow,
+        stop_running=runtime_stop_state.stop_workflow,
         async_delete_cache=lambda workflow_id: system_config.async_delete(
             f"WorkflowCache-{workflow_id}"
         ),

app/api/endpoints/agent.py

@@ -7,8 +7,8 @@ import shutil
 import time
 import uuid
 from collections import deque
-from queue import Empty, Queue
 from pathlib import Path
+from queue import Empty, Queue
 from threading import Lock
 from typing import Any, AsyncIterator, Awaitable, Callable, Optional, Union
 
@@ -16,15 +16,58 @@ import aiofiles
 from fastapi import Depends, File, Form, HTTPException, Request, UploadFile, status
 from fastapi.responses import FileResponse, StreamingResponse
 
+from app.agent.contracts import ReplyMode, build_display_message
+from app.agent.mcp import agent_mcp_manager
+from app.agent.runtime_loader import get_moviepilot_agent_type
+from app.api.dependencies.agent import (
+    get_agent_chat_persistence,
+    get_agent_chat_service,
+)
+from app.api.dependencies.auth import get_current_active_user
+from app.api.presentation.sse import build_sse_error_response, build_sse_response
+from app.api.principal import ApiPrincipal
+from app.api.response import ResponseAPIRouter
+from app.application.agent import (
+    get_running_agent_manager,
+    is_audio_input_available,
+    transcribe_audio,
+)
+from app.application.commands import get_command, get_commands
+from app.application.configuration import get_api_runtime_config_snapshot
+from app.application.messaging.agent import (
+    agent_interaction_manager,
+    attach_web_agent_edit_queue,
+    attach_web_agent_message_queue,
+    build_agent_choice_button_rows,
+    create_web_agent_background_task,
+    detach_web_agent_edit_queue,
+    detach_web_agent_message_queue,
+    is_web_agent_message_for_user,
+    normalize_web_agent_button_rows,
+    parse_agent_choice_callback,
+)
+from app.application.messaging.chat import (
+    AgentChatPersistenceService,
+    AgentChatRecord,
+    AgentChatService,
+    get_configured_agent_chat_persistence,
+    get_configured_agent_chat_service,
+)
+from app.application.messaging.router import has_pending_interaction
+from app.application.security.user import get_configured_user_id_lookup
+from app.chain.message import MessageChain
 from app.runtime.execution import run_in_threadpool
+from app.runtime.localization import LocaleHelper
+from app.runtime.log import logger
+from app.runtime.stop import runtime_stop_state
 from app.schemas.agent import AgentChatDisplaySaveRequest as _SchemaAgentChatDisplaySaveRequest
 from app.schemas.agent import AgentChatSessionDetail as _SchemaAgentChatSessionDetail
 from app.schemas.agent import AgentChatSessionSummary as _SchemaAgentChatSessionSummary
 from app.schemas.agent import AgentChatUploadAttachment as _SchemaAgentChatUploadAttachment
 from app.schemas.agent import AgentMcpServerListData as _SchemaAgentMcpServerListData
+from app.schemas.agent import AgentMcpServersSaveRequest as _SchemaAgentMcpServersSaveRequest
 from app.schemas.agent import AgentMcpServerTestRequest as _SchemaAgentMcpServerTestRequest
 from app.schemas.agent import AgentMcpServerTestResult as _SchemaAgentMcpServerTestResult
-from app.schemas.agent import AgentMcpServersSaveRequest as _SchemaAgentMcpServersSaveRequest
 from app.schemas.agent import AgentSessionStopData as _SchemaAgentSessionStopData
 from app.schemas.agent import AgentWebCallbackData as _SchemaAgentWebCallbackData
 from app.schemas.agent import AgentWebCommandInfo as _SchemaAgentWebCommandInfo
@@ -32,52 +75,7 @@ from app.schemas.message import AgentWebChatRequest as _SchemaAgentWebChatReques
 from app.schemas.message import AgentWebChoiceRequest as _SchemaAgentWebChoiceRequest
 from app.schemas.message import Message as _SchemaMessage
 from app.schemas.response import Response as _SchemaResponse
-from app.api.response import ResponseAPIRouter
-from app.api.presentation.sse import build_sse_error_response, build_sse_response
-from app.agent.contracts import ReplyMode, build_display_message
-from app.agent.mcp import agent_mcp_manager
-from app.agent.runtime_loader import get_moviepilot_agent_type
-from app.application.agent import (
-    get_running_agent_manager,
-    is_audio_input_available,
-    transcribe_audio,
-)
-from app.chain.message import MessageChain
-from app.application.commands import get_command, get_commands
-from app.runtime.config import global_vars
-from app.api.principal import ApiPrincipal
-from app.api.dependencies.agent import (
-    get_agent_chat_persistence,
-    get_agent_chat_service,
-)
-from app.api.dependencies.auth import get_current_active_user
-from app.application.messaging.chat import (
-    AgentChatRecord,
-    AgentChatPersistenceService,
-    AgentChatService,
-    get_configured_agent_chat_service,
-    get_configured_agent_chat_persistence,
-)
-from app.application.security.user import get_configured_user_id_lookup
-from app.application.configuration import get_api_runtime_config_snapshot
-from app.application.messaging.agent import (
-    attach_web_agent_message_queue,
-    attach_web_agent_edit_queue,
-    create_web_agent_background_task,
-    detach_web_agent_message_queue,
-    detach_web_agent_edit_queue,
-    is_web_agent_message_for_user,
-)
-from app.application.messaging.agent import agent_interaction_manager
-from app.application.messaging.agent import (
-    build_agent_choice_button_rows,
-    normalize_web_agent_button_rows,
-    parse_agent_choice_callback,
-)
-from app.application.messaging.router import has_pending_interaction
-from app.runtime.localization import LocaleHelper
-from app.runtime.log import logger
-from app.schemas.types import EventType, NotificationChannel
+from app.schemas.types import NotificationChannel
 
 router = ResponseAPIRouter()
 
@@ -2274,7 +2272,7 @@ async def _web_agent_stream_impl(
                 {"session_id": session_id},
                 locale=locale,
             )
-            while not global_vars.is_system_stopped:
+            while not runtime_stop_state.is_system_stopped:
                 if await request.is_disconnected():
                     disconnected = True
                     break

app/api/endpoints/anilist.py

@@ -2,13 +2,13 @@ from typing import Annotated, Optional
 
 from fastapi import Depends, Query
 
-from app.schemas.context import MediaPerson as _SchemaMediaPerson
-from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
+from app.adapters.web.security.access import verify_token
 from app.api.response import ResponseAPIRouter
 from app.chain.anilist import AniListChain
 from app.domain.context import MediaInfo
-from app.adapters.web.security.access import verify_token
+from app.schemas.context import MediaPerson as _SchemaMediaPerson
+from app.schemas.token import TokenPayload as _SchemaTokenPayload
+from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
 
 router = ResponseAPIRouter()
 

app/api/endpoints/anthropic.py

@@ -5,15 +5,15 @@ from typing import AsyncIterator, List, Optional
 from fastapi import APIRouter, Depends, Header, Security
 from fastapi.responses import JSONResponse
 
-from app.schemas.openai import AnthropicErrorDetail as _SchemaAnthropicErrorDetail
-from app.schemas.openai import AnthropicErrorResponse as _SchemaAnthropicErrorResponse
-from app.schemas.openai import AnthropicMessagesRequest as _SchemaAnthropicMessagesRequest
-from app.schemas.openai import AnthropicMessagesResponse as _SchemaAnthropicMessagesResponse
-from app.schemas.openai import AnthropicTextBlock as _SchemaAnthropicTextBlock
+from app.adapters.web.security.access import anthropic_api_key_header
+from app.api.context import (
+    get_background_task_registry_compat,
+    resolve_background_task_registry,
+)
 from app.api.endpoints.openai import (
     MODEL_ID,
-    _is_manager_unavailable,
     _is_manager_queue_full,
+    _is_manager_unavailable,
     _run_managed_agent,
 )
 from app.api.openai_utils import (
@@ -24,12 +24,12 @@ from app.api.openai_utils import (
 from app.api.presentation.sse import build_sse_response, encode_named_event
 from app.application.agent import get_running_agent_manager
 from app.application.configuration import get_api_runtime_config_snapshot
-from app.adapters.web.security.access import anthropic_api_key_header
-from app.api.context import (
-    get_background_task_registry_compat,
-    resolve_background_task_registry,
-)
 from app.runtime.tasks import TaskRegistry
+from app.schemas.openai import AnthropicErrorDetail as _SchemaAnthropicErrorDetail
+from app.schemas.openai import AnthropicErrorResponse as _SchemaAnthropicErrorResponse
+from app.schemas.openai import AnthropicMessagesRequest as _SchemaAnthropicMessagesRequest
+from app.schemas.openai import AnthropicMessagesResponse as _SchemaAnthropicMessagesResponse
+from app.schemas.openai import AnthropicTextBlock as _SchemaAnthropicTextBlock
 
 ANTHROPIC_ERROR_RESPONSES = {
     400: {"model": _SchemaAnthropicErrorResponse, "description": "请求格式错误"},

app/api/endpoints/auth.py

@@ -3,12 +3,12 @@ from typing import Any
 from fastapi import Depends, HTTPException
 from pydantic import BaseModel
 
+from app.api.dependencies.auth import get_auth_service
+from app.api.response import RAW_RESPONSE_OPENAPI_KEY, ResponseAPIRouter
+from app.application.plugin.runtime import get_plugin_manager
+from app.application.security.auth import AuthService, consume_plugin_auth_ticket
 from app.schemas.token import Token as _SchemaToken
 from app.schemas.user import AuthProviderInfo as _SchemaAuthProviderInfo
-from app.api.response import RAW_RESPONSE_OPENAPI_KEY, ResponseAPIRouter
-from app.application.security.auth import AuthService, consume_plugin_auth_ticket
-from app.application.plugin.runtime import get_plugin_manager
-from app.api.dependencies.auth import get_auth_service
 
 router = ResponseAPIRouter()
 

app/api/endpoints/bangumi.py

@@ -1,14 +1,14 @@
-from typing import List, Any, Optional
+from typing import Any, List, Optional
 
 from fastapi import Depends
 
-from app.schemas.context import MediaPerson as _SchemaMediaPerson
-from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
+from app.adapters.web.security.access import verify_token
 from app.api.response import ResponseAPIRouter
 from app.chain.bangumi import BangumiChain
 from app.domain.context import MediaInfo
-from app.adapters.web.security.access import verify_token
+from app.schemas.context import MediaPerson as _SchemaMediaPerson
+from app.schemas.token import TokenPayload as _SchemaTokenPayload
+from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
 
 router = ResponseAPIRouter()
 

app/api/endpoints/dashboard.py

@@ -1,8 +1,20 @@
 from pathlib import Path
-from typing import Any, List, Optional, Annotated
+from typing import Annotated, Any, List, Optional
 
 from fastapi import Depends
 
+from app.adapters.system.host import SystemUtils
+from app.adapters.web.security.access import verify_apitoken
+from app.api.context import get_api_runtime_config, resolve_api_runtime_config
+from app.api.dependencies.auth import get_current_active_superuser
+from app.api.dependencies.history import get_dashboard_query_service
+from app.api.response import ResponseAPIRouter
+from app.application.configuration import ApiRuntimeConfig
+from app.application.dashboard import DashboardQueryService
+from app.application.directory import DirectoryHelper
+from app.application.scheduling import get_scheduler
+from app.chain.dashboard import DashboardChain
+from app.chain.storage import StorageChain
 from app.runtime.execution import run_in_threadpool
 from app.schemas.dashboard import DashboardMemoryInfo as _SchemaDashboardMemoryInfo
 from app.schemas.dashboard import DashboardSystemInfo as _SchemaDashboardSystemInfo
@@ -13,19 +25,7 @@ from app.schemas.dashboard import ScheduleProgress as _SchemaScheduleProgress
 from app.schemas.dashboard import Statistic as _SchemaStatistic
 from app.schemas.dashboard import Storage as _SchemaStorage
 from app.schemas.response import Response as _SchemaResponse
-from app.api.response import ResponseAPIRouter
-from app.chain.dashboard import DashboardChain
-from app.chain.storage import StorageChain
-from app.api.context import get_api_runtime_config, resolve_api_runtime_config
-from app.application.configuration import ApiRuntimeConfig
-from app.adapters.web.security.access import verify_apitoken
-from app.api.dependencies.auth import get_current_active_superuser
-from app.api.dependencies.history import get_dashboard_query_service
-from app.application.dashboard import DashboardQueryService
 from app.schemas.types import StorageAction
-from app.application.directory import DirectoryHelper
-from app.application.scheduling import get_scheduler
-from app.adapters.system.host import SystemUtils
 
 router = ResponseAPIRouter()
 

app/api/endpoints/discover.py

@@ -2,17 +2,17 @@ from typing import Any, List, Optional
 
 from fastapi import Depends
 
-from app.schemas.event import DiscoverMediaSource as _SchemaDiscoverMediaSource
-from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
+from app.adapters.web.security.access import verify_token
 from app.api.response import ResponseAPIRouter
 from app.chain.bangumi import BangumiChain
 from app.chain.douban import DoubanChain
 from app.chain.tmdb import TmdbChain
 from app.runtime.events import eventmanager
-from app.adapters.web.security.access import verify_token
+from app.schemas.event import DiscoverMediaSource as _SchemaDiscoverMediaSource
 from app.schemas.event import DiscoverSourceEventData
+from app.schemas.token import TokenPayload as _SchemaTokenPayload
 from app.schemas.types import ChainEventType, MediaType
+from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
 
 router = ResponseAPIRouter()
 

app/api/endpoints/douban.py

@@ -2,14 +2,14 @@ from typing import Any, List, Optional
 
 from fastapi import Depends
 
-from app.schemas.context import MediaPerson as _SchemaMediaPerson
-from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
+from app.adapters.web.security.access import verify_token
 from app.api.response import ResponseAPIRouter
 from app.chain.douban import DoubanChain
 from app.domain.context import MediaInfo
-from app.adapters.web.security.access import verify_token
+from app.schemas.context import MediaPerson as _SchemaMediaPerson
+from app.schemas.token import TokenPayload as _SchemaTokenPayload
 from app.schemas.types import MediaType
+from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
 
 router = ResponseAPIRouter()
 

app/api/endpoints/download.py

@@ -1,7 +1,26 @@
-from typing import Any, List, Annotated, Optional, Union
+from typing import Annotated, Any, List, Optional, Union
 
-from fastapi import Depends, Body
+from fastapi import Body, Depends
 
+from app.adapters.web.security.access import verify_token
+from app.api.dependencies.auth import get_current_active_user
+from app.api.dependencies.site import get_site_sync_query_service
+from app.api.principal import ApiPrincipal
+from app.api.response import ResponseAPIRouter
+from app.application.configuration import get_configured_system_config
+from app.application.directory import DirectoryHelper
+from app.application.security.url import SecurityUtils
+from app.application.site.query import (
+    SiteQueryService,
+    get_configured_site_query_service,
+)
+from app.chain.download import DownloadChain
+from app.chain.media import MediaChain
+from app.domain.context import Context, MediaInfo, MusicInfo, SubtitleInfo, TorrentInfo
+from app.domain.media import is_music_media_source, normalize_music_type
+from app.domain.meta.metabase import MetaBase
+from app.domain.meta.metamusic import MetaMusic
+from app.domain.metainfo import MetaInfo
 from app.schemas.common import ServiceClientInfo as _SchemaServiceClientInfo
 from app.schemas.download import DownloadAddedData as _SchemaDownloadAddedData
 from app.schemas.download import DownloadDirectory as _SchemaDownloadDirectory
@@ -13,24 +32,6 @@ from app.schemas.system import TorrentInfo as _SchemaTorrentInfo
 from app.schemas.token import TokenPayload as _SchemaTokenPayload
 from app.schemas.transfer import DownloaderTorrent as _SchemaDownloaderTorrent
 from app.schemas.transfer import MusicInfo as _SchemaMusicInfo
-from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
-from app.api.response import ResponseAPIRouter
-from app.chain.download import DownloadChain
-from app.chain.media import MediaChain
-from app.domain.context import Context, MediaInfo, MusicInfo, SubtitleInfo, TorrentInfo
-from app.domain.meta.metabase import MetaBase
-from app.domain.meta.metamusic import MetaMusic
-from app.domain.metainfo import MetaInfo
-from app.adapters.web.security.access import verify_token
-from app.api.principal import ApiPrincipal
-from app.application.configuration import get_configured_system_config
-from app.application.site.query import (
-    SiteQueryService,
-    get_configured_site_query_service,
-)
-from app.api.dependencies.auth import get_current_active_user
-from app.api.dependencies.site import get_site_sync_query_service
-from app.application.directory import DirectoryHelper
 from app.schemas.types import (
     MUSIC_ENTITY_RECORDING,
     MediaSource,
@@ -38,8 +39,7 @@ from app.schemas.types import (
     MusicTargetEntityType,
     SystemConfigKey,
 )
-from app.domain.media import is_music_media_source, normalize_music_type
-from app.application.security.url import SecurityUtils
+from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
 
 router = ResponseAPIRouter()
 

app/api/endpoints/history.py

@@ -1,33 +1,21 @@
 import time
 from collections.abc import Coroutine
-from typing import List, Any, Callable, Optional
+from typing import Any, Callable, List, Optional
 
 from fastapi import Depends
 
-from app.schemas.common import BatchProgressKeyData as _SchemaBatchProgressKeyData
-from app.schemas.common import ProgressKeyData as _SchemaProgressKeyData
-from app.schemas.history import BatchTransferHistoryRedoRequest as _SchemaBatchTransferHistoryRedoRequest
-from app.schemas.history import TransferHistory as _SchemaTransferHistory
-from app.schemas.history import TransferHistoryPage as _SchemaTransferHistoryPage
-from app.schemas.response import Response as _SchemaResponse
-from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.schemas.history import DownloadHistory as _SchemaDownloadHistory
-from app.api.response import ResponseAPIRouter
+from app.adapters.web.security.access import verify_token
 from app.agent.contracts import ReplyMode
-from app.application.agent import get_running_agent_manager
 from app.agent.prompt.transfer_redo import (
     build_batch_manual_redo_prompt,
     build_manual_redo_prompt,
 )
-from app.runtime.config import global_vars
 from app.api.context import (
     get_api_runtime_config,
     get_background_task_registry,
     resolve_api_runtime_config,
     resolve_background_task_registry,
 )
-from app.application.configuration import ApiRuntimeConfig
-from app.adapters.web.security.access import verify_token
 from app.api.dependencies.auth import (
     get_current_active_manage_user,
     get_current_active_superuser,
@@ -37,14 +25,26 @@ from app.api.dependencies.history import (
     get_history_query_service,
     get_transfer_history_mutation_command,
 )
-from app.runtime.progress import AsyncProgressHelper
+from app.api.response import ResponseAPIRouter
+from app.application.agent import get_running_agent_manager
+from app.application.configuration import ApiRuntimeConfig
 from app.application.history import (
     DownloadHistoryMutationCommand,
     HistoryQueryService,
     TransferHistoryMutationCommand,
 )
+from app.runtime.config import global_vars
 from app.runtime.log import logger
+from app.runtime.progress import AsyncProgressHelper
 from app.runtime.tasks import TaskRegistry
+from app.schemas.common import BatchProgressKeyData as _SchemaBatchProgressKeyData
+from app.schemas.common import ProgressKeyData as _SchemaProgressKeyData
+from app.schemas.history import BatchTransferHistoryRedoRequest as _SchemaBatchTransferHistoryRedoRequest
+from app.schemas.history import DownloadHistory as _SchemaDownloadHistory
+from app.schemas.history import TransferHistory as _SchemaTransferHistory
+from app.schemas.history import TransferHistoryPage as _SchemaTransferHistoryPage
+from app.schemas.response import Response as _SchemaResponse
+from app.schemas.token import TokenPayload as _SchemaTokenPayload
 
 router = ResponseAPIRouter()
 

app/api/endpoints/llm.py

@@ -3,11 +3,11 @@ from typing import Any, Dict, List, Optional, Union
 from fastapi import Depends, Request, Response
 from fastapi.responses import HTMLResponse
 
+from app.agent.llm.gateway import resolve_llm_provider_runtime
+from app.api.dependencies.auth import get_current_active_superuser_async
+from app.api.response import ResponseAPIRouter
 from app.schemas.common import ManageRequest as _SchemaManageRequest
 from app.schemas.response import Response as _SchemaResponse
-from app.api.response import ResponseAPIRouter
-from app.api.dependencies.auth import get_current_active_superuser_async
-from app.agent.llm.gateway import resolve_llm_provider_runtime
 
 router = ResponseAPIRouter()
 

app/api/endpoints/login.py

@@ -1,22 +1,22 @@
 from datetime import timedelta
-from typing import Any, List, Annotated
+from typing import Annotated, Any, List
 
 from fastapi import Depends, Form, HTTPException, Request, Response
-from fastapi.security import OAuth2PasswordRequestForm
 from fastapi.responses import JSONResponse
+from fastapi.security import OAuth2PasswordRequestForm
 
+from app.adapters.web.security.access import set_or_refresh_resource_token_cookie
+from app.api.context import get_api_runtime_config, resolve_api_runtime_config
+from app.api.response import RAW_RESPONSE_OPENAPI_KEY, ResponseAPIRouter
+from app.application.configuration import ApiRuntimeConfig, get_configured_system_config
+from app.application.image import WallpaperHelper
+from app.application.security.token import create_access_token
+from app.application.site.sites import SitesHelper  # pylint: disable=import-error,no-name-in-module
+from app.chain.user import MfaRequired, UserChain
 from app.schemas.response import Response as _SchemaResponse
 from app.schemas.token import MfaChallenge as _SchemaMfaChallenge
 from app.schemas.token import Token as _SchemaToken
 from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.api.response import RAW_RESPONSE_OPENAPI_KEY, ResponseAPIRouter
-from app.chain.user import MfaRequired, UserChain
-from app.adapters.web.security.access import set_or_refresh_resource_token_cookie
-from app.application.security.token import create_access_token
-from app.api.context import get_api_runtime_config, resolve_api_runtime_config
-from app.application.configuration import ApiRuntimeConfig, get_configured_system_config
-from app.application.site.sites import SitesHelper  # pylint: disable=import-error,no-name-in-module
-from app.application.image import WallpaperHelper
 from app.schemas.types import SystemConfigKey
 
 router = ResponseAPIRouter()

app/api/endpoints/mcp.py

@@ -1,8 +1,13 @@
-from typing import List, Any, Dict, Annotated, Union
+from typing import Annotated, Any, Dict, List, Union
 
 from fastapi import Depends, HTTPException, Request
 from fastapi.responses import JSONResponse, Response
 
+from app.adapters.web.security.access import verify_apikey
+from app.agent.tools.manager import moviepilot_tool_manager
+from app.api.response import RAW_RESPONSE_OPENAPI_KEY, ResponseAPIRouter
+from app.runtime.log import logger
+from app.runtime.version import get_app_version
 from app.schemas.mcp import MCP_JSONRPC_REQUEST_SCHEMA as _SchemaMCP_JSONRPC_REQUEST_SCHEMA
 from app.schemas.mcp import McpJsonRpcError as _SchemaMcpJsonRpcError
 from app.schemas.mcp import McpJsonRpcResponse as _SchemaMcpJsonRpcResponse
@@ -11,11 +16,6 @@ from app.schemas.mcp import McpToolInfo as _SchemaMcpToolInfo
 from app.schemas.mcp import ToolCallData as _SchemaToolCallData
 from app.schemas.mcp import ToolCallRequest as _SchemaToolCallRequest
 from app.schemas.response import Response as _SchemaResponse
-from app.api.response import RAW_RESPONSE_OPENAPI_KEY, ResponseAPIRouter
-from app.agent.tools.manager import moviepilot_tool_manager
-from app.adapters.web.security.access import verify_apikey
-from app.runtime.version import get_app_version
-from app.runtime.log import logger
 
 router = ResponseAPIRouter()
 

app/api/endpoints/media.py

@@ -5,36 +5,36 @@ from uuid import UUID
 from fastapi import Depends, Query
 from pydantic import BeforeValidator
 
+from app.adapters.web.security.access import verify_apitoken, verify_token
+from app.api.dependencies.auth import (
+    get_current_active_superuser,
+    get_current_active_user,
+)
+from app.api.response import ResponseAPIRouter
+from app.application.configuration import get_api_runtime_config_snapshot
+from app.chain.media import MediaChain
+from app.chain.scraping import ScrapingChain
+from app.chain.tmdb import TmdbChain
+from app.domain.context import Context, MusicInfo
+from app.domain.media import is_music_media_source, normalize_music_type, parse_media_source_selection
+from app.domain.meta.metabase import MetaBase
+from app.domain.meta.metamusic import MetaMusic
+from app.domain.metainfo import MetaInfo, MetaInfoPath
+from app.schemas.category import CategoryConfig
 from app.schemas.category import CategoryConfig as _SchemaCategoryConfig
 from app.schemas.category import MediaCategoryMap as _SchemaMediaCategoryMap
 from app.schemas.context import MediaEpisodeGroup as _SchemaMediaEpisodeGroup
 from app.schemas.context import MediaPerson as _SchemaMediaPerson
 from app.schemas.context import MediaSearchResults as _SchemaMediaSearchResults
 from app.schemas.context import MediaSeason as _SchemaMediaSeason
+from app.schemas.event import MediaSourceInfo as _SchemaMediaSourceInfo
+from app.schemas.media import normalize_media_source, resolve_media_identity
 from app.schemas.response import Response as _SchemaResponse
 from app.schemas.token import TokenPayload as _SchemaTokenPayload
+from app.schemas.types import MUSIC_ENTITY_RECORDING, MediaSource, MediaType
 from app.schemas.workflow import Context as _SchemaContext
 from app.schemas.workflow import FileItem as _SchemaFileItem
 from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
-from app.api.response import ResponseAPIRouter
-from app.chain.media import MediaChain
-from app.chain.scraping import ScrapingChain
-from app.chain.tmdb import TmdbChain
-from app.application.configuration import get_api_runtime_config_snapshot
-from app.domain.context import Context, MusicInfo
-from app.domain.meta.metabase import MetaBase
-from app.domain.meta.metamusic import MetaMusic
-from app.domain.metainfo import MetaInfo, MetaInfoPath
-from app.adapters.web.security.access import verify_token, verify_apitoken
-from app.api.dependencies.auth import (
-    get_current_active_superuser,
-    get_current_active_user,
-)
-from app.schemas.category import CategoryConfig
-from app.schemas.event import MediaSourceInfo as _SchemaMediaSourceInfo
-from app.schemas.types import MUSIC_ENTITY_RECORDING, MediaSource, MediaType
-from app.domain.media import is_music_media_source, normalize_music_type, parse_media_source_selection
-from app.schemas.media import normalize_media_source, resolve_media_identity
 
 router = ResponseAPIRouter()
 

app/api/endpoints/mediaserver.py

@@ -2,32 +2,32 @@ from typing import Any, List, Optional
 
 from fastapi import Depends, HTTPException, status
 
+from app.adapters.web.security.access import verify_token
+from app.api.dependencies.history import get_mediaserver_query_service
+from app.api.response import ResponseAPIRouter
+from app.application.configuration import get_configured_system_config
+from app.application.mediaserver import (
+    MediaServerQueryService,
+    get_mediaserver_configs,
+)
+from app.chain.download import DownloadChain
+from app.chain.mediaserver import MediaServerChain
+from app.domain.context import MediaInfo
+from app.domain.metainfo import MetaInfo
 from app.schemas.common import ServiceClientInfo as _SchemaServiceClientInfo
+from app.schemas.media import build_media_key, resolve_media_identity
 from app.schemas.mediaserver import ExistMediaInfo as _SchemaExistMediaInfo
 from app.schemas.mediaserver import MediaServerExistingEpisodes as _SchemaMediaServerExistingEpisodes
 from app.schemas.mediaserver import MediaServerExistsData as _SchemaMediaServerExistsData
 from app.schemas.mediaserver import MediaServerLibrary as _SchemaMediaServerLibrary
 from app.schemas.mediaserver import MediaServerPlayData as _SchemaMediaServerPlayData
 from app.schemas.mediaserver import MediaServerPlayItem as _SchemaMediaServerPlayItem
+from app.schemas.mediaserver import NotExistMediaInfo
 from app.schemas.mediaserver import NotExistMediaInfo as _SchemaNotExistMediaInfo
 from app.schemas.response import Response as _SchemaResponse
 from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
-from app.api.response import ResponseAPIRouter
-from app.chain.download import DownloadChain
-from app.chain.mediaserver import MediaServerChain
-from app.domain.context import MediaInfo
-from app.domain.metainfo import MetaInfo
-from app.adapters.web.security.access import verify_token
-from app.application.configuration import get_configured_system_config
-from app.application.mediaserver import (
-    MediaServerQueryService,
-    get_mediaserver_configs,
-)
-from app.api.dependencies.history import get_mediaserver_query_service
-from app.schemas.mediaserver import NotExistMediaInfo
 from app.schemas.types import MediaSource, MediaType, SystemConfigKey
-from app.schemas.media import build_media_key, resolve_media_identity
+from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
 
 router = ResponseAPIRouter()
 

app/api/endpoints/message.py

@@ -7,6 +7,23 @@ from typing import Annotated, Any, List, Optional, Protocol, Union
 from fastapi import Depends, Request
 from starlette.responses import PlainTextResponse
 
+from app.adapters.external.wechat_crypt import WXBizMsgCrypt
+from app.adapters.web.security.access import verify_apitoken, verify_token
+from app.api.context import get_background_task_registry, resolve_background_task_registry
+from app.api.dependencies.agent import get_message_query_service
+from app.api.dependencies.auth import get_current_active_superuser
+from app.api.principal import ApiPrincipal
+from app.api.response import ResponseAPIRouter
+from app.application.configuration import (
+    get_api_runtime_config_snapshot,
+    get_configured_system_config,
+)
+from app.application.messaging.message import MessageQueryService
+from app.application.notification import get_notification_configs
+from app.chain.message import MessageChain
+from app.runtime.config import global_vars
+from app.runtime.log import logger
+from app.runtime.tasks import TaskRegistry
 from app.schemas.message import MessageClearBefore as _SchemaMessageClearBefore
 from app.schemas.message import MessageClearData as _SchemaMessageClearData
 from app.schemas.message import MessageClearScope as _SchemaMessageClearScope
@@ -16,24 +33,7 @@ from app.schemas.message import SubscriptionMessage as _SchemaSubscriptionMessag
 from app.schemas.message import WebMessageItem as _SchemaWebMessageItem
 from app.schemas.response import Response as _SchemaResponse
 from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.api.response import ResponseAPIRouter
-from app.chain.message import MessageChain
-from app.runtime.config import global_vars
-from app.adapters.web.security.access import verify_token, verify_apitoken
-from app.api.principal import ApiPrincipal
-from app.application.configuration import (
-    get_api_runtime_config_snapshot,
-    get_configured_system_config,
-)
-from app.api.dependencies.agent import get_message_query_service
-from app.api.dependencies.auth import get_current_active_superuser
-from app.application.messaging.message import MessageQueryService
-from app.application.notification import get_notification_configs
-from app.runtime.log import logger
-from app.adapters.external.wechat_crypt import WXBizMsgCrypt
 from app.schemas.types import NotificationChannel, SystemConfigKey
-from app.api.context import get_background_task_registry, resolve_background_task_registry
-from app.runtime.tasks import TaskRegistry
 
 router = ResponseAPIRouter()
 

app/api/endpoints/mfa.py

@@ -4,10 +4,37 @@ MFA (Multi-Factor Authentication) API 端点
 """
 
 import json
-from typing import Any, Annotated, Optional
+from typing import Annotated, Any, Optional
 
-from fastapi import Depends, HTTPException, Body, Request, Response
+from fastapi import Body, Depends, HTTPException, Request, Response
 
+from app.adapters.web.security.access import set_or_refresh_resource_token_cookie
+from app.api.dependencies.auth import (
+    get_current_active_user,
+    get_current_active_user_async,
+    get_passkey_service,
+    get_user_service,
+)
+from app.api.principal import ApiPrincipal
+from app.api.response import RAW_RESPONSE_OPENAPI_KEY, ResponseAPIRouter
+from app.application.security.auth import get_configured_auth_service
+from app.application.security.otp import OtpUtils
+from app.application.security.passkey import (
+    PasskeyChallengeStore,
+    PassKeyHelper,
+    PassKeyRegistrationOriginMismatchError,
+    PassKeyRegistrationVerificationError,
+)
+from app.application.security.passkeys import (
+    PasskeyService,
+)
+from app.application.security.token import verify_password
+from app.application.security.user import (
+    UserService,
+    get_configured_user_id_lookup,
+    get_configured_user_name_lookup,
+)
+from app.runtime.log import logger
 from app.schemas.mcp import BaseModel as _SchemaBaseModel
 from app.schemas.mcp import JsonData as _SchemaJsonData
 from app.schemas.mfa import MfaStatusData as _SchemaMfaStatusData
@@ -17,33 +44,6 @@ from app.schemas.mfa import PasskeyStartData as _SchemaPasskeyStartData
 from app.schemas.response import Response as _SchemaResponse
 from app.schemas.token import Token as _SchemaToken
 from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.api.response import RAW_RESPONSE_OPENAPI_KEY, ResponseAPIRouter
-from app.adapters.web.security.access import set_or_refresh_resource_token_cookie
-from app.application.security.token import verify_password
-from app.application.security.auth import get_configured_auth_service
-from app.application.security.user import UserService
-from app.application.security.user import (
-    get_configured_user_id_lookup,
-    get_configured_user_name_lookup,
-)
-from app.application.security.passkeys import (
-    PasskeyService,
-)
-from app.api.principal import ApiPrincipal
-from app.api.dependencies.auth import (
-    get_current_active_user,
-    get_current_active_user_async,
-    get_user_service,
-    get_passkey_service,
-)
-from app.application.security.passkey import (
-    PassKeyHelper,
-    PassKeyRegistrationOriginMismatchError,
-    PassKeyRegistrationVerificationError,
-    PasskeyChallengeStore,
-)
-from app.runtime.log import logger
-from app.application.security.otp import OtpUtils
 
 router = ResponseAPIRouter()
 

app/api/endpoints/music.py

@@ -2,6 +2,18 @@ from typing import Annotated, Optional
 
 from fastapi import Depends, HTTPException, Query
 
+from app.adapters.web.security.access import verify_token
+from app.api.dependencies.auth import get_current_active_superuser_async
+from app.api.response import ResponseAPIRouter
+from app.chain.listenbrainz import (
+    LISTENBRAINZ_CHART_RANGES,
+    LISTENBRAINZ_FRESH_MAX_DAYS,
+    LISTENBRAINZ_FRESH_SORTS,
+)
+from app.chain.media import MediaChain
+from app.chain.musicbrainz import MusicBrainzChain
+from app.chain.recommend import RecommendChain
+from app.domain.context import MusicAlbumInfo, MusicArtistInfo, MusicInfo
 from app.schemas.music import MusicAlbumInfo as _SchemaMusicAlbumInfo
 from app.schemas.music import MusicArtistInfo as _SchemaMusicArtistInfo
 from app.schemas.music import MusicRecognitionCacheData as _SchemaMusicRecognitionCacheData
@@ -9,19 +21,7 @@ from app.schemas.music import MusicRecognizeRequest as _SchemaMusicRecognizeRequ
 from app.schemas.response import Response as _SchemaResponse
 from app.schemas.token import TokenPayload as _SchemaTokenPayload
 from app.schemas.transfer import MusicInfo as _SchemaMusicInfo
-from app.api.response import ResponseAPIRouter
-from app.chain.media import MediaChain
-from app.chain.recommend import RecommendChain
 from app.schemas.types import MediaSource, MediaType
-from app.domain.context import MusicAlbumInfo, MusicArtistInfo, MusicInfo
-from app.adapters.web.security.access import verify_token
-from app.api.dependencies.auth import get_current_active_superuser_async
-from app.chain.listenbrainz import (
-    LISTENBRAINZ_CHART_RANGES,
-    LISTENBRAINZ_FRESH_MAX_DAYS,
-    LISTENBRAINZ_FRESH_SORTS,
-)
-from app.chain.musicbrainz import MusicBrainzChain
 
 router = ResponseAPIRouter()
 

app/api/endpoints/notification.py

@@ -2,11 +2,11 @@ from typing import Any, Dict
 
 from fastapi import Depends
 
-from app.schemas.common import ManageRequest as _SchemaManageRequest
-from app.schemas.response import Response as _SchemaResponse
+from app.api.dependencies.auth import get_current_active_superuser
 from app.api.response import ResponseAPIRouter
 from app.chain.notification import NotificationChain
-from app.api.dependencies.auth import get_current_active_superuser
+from app.schemas.common import ManageRequest as _SchemaManageRequest
+from app.schemas.response import Response as _SchemaResponse
 
 router = ResponseAPIRouter()
 

app/api/endpoints/openai.py

@@ -8,6 +8,23 @@ from fastapi import APIRouter, Depends, Request, Security
 from fastapi.responses import JSONResponse
 from fastapi.security import HTTPAuthorizationCredentials
 
+from app.adapters.web.security.access import openai_bearer_scheme
+from app.agent.contracts import ReplyMode
+from app.agent.runtime_loader import get_moviepilot_agent_type
+from app.api.context import (
+    get_background_task_registry_compat,
+    resolve_background_task_registry,
+)
+from app.api.openai_utils import (
+    build_completion_payload,
+    build_prompt,
+    build_responses_input,
+    build_session_id,
+)
+from app.api.presentation.sse import build_sse_response, encode_data_event
+from app.application.agent import get_running_agent_manager
+from app.application.configuration import get_api_runtime_config_snapshot
+from app.runtime.tasks import TaskRegistry
 from app.schemas.openai import OpenAIChatCompletionResponse as _SchemaOpenAIChatCompletionResponse
 from app.schemas.openai import OpenAIChatCompletionsRequest as _SchemaOpenAIChatCompletionsRequest
 from app.schemas.openai import OpenAIErrorDetail as _SchemaOpenAIErrorDetail
@@ -19,24 +36,7 @@ from app.schemas.openai import OpenAIResponsesOutputText as _SchemaOpenAIRespons
 from app.schemas.openai import OpenAIResponsesRequest as _SchemaOpenAIResponsesRequest
 from app.schemas.openai import OpenAIResponsesResponse as _SchemaOpenAIResponsesResponse
 from app.schemas.openai import OpenAIUsage as _SchemaOpenAIUsage
-from app.api.openai_utils import (
-    build_completion_payload,
-    build_prompt,
-    build_responses_input,
-    build_session_id,
-)
-from app.api.presentation.sse import build_sse_response, encode_data_event
-from app.agent.runtime_loader import get_moviepilot_agent_type
-from app.application.agent import get_running_agent_manager
-from app.agent.contracts import ReplyMode
-from app.application.configuration import get_api_runtime_config_snapshot
-from app.adapters.web.security.access import openai_bearer_scheme
 from app.schemas.types import NotificationChannel
-from app.api.context import (
-    get_background_task_registry_compat,
-    resolve_background_task_registry,
-)
-from app.runtime.tasks import TaskRegistry
 
 OPENAI_ERROR_RESPONSES = {
     400: {"model": _SchemaOpenAIErrorResponse, "description": "请求格式错误"},

app/api/endpoints/plugin.py

@@ -9,11 +9,48 @@ from fastapi import Depends, Header, HTTPException, Security
 from starlette import status
 from starlette.responses import StreamingResponse
 
+from app.adapters.external.market import PluginHelper
+from app.adapters.external.server import MoviePilotServerHelper
+from app.adapters.system.plugin.package import PluginPackageManager
+from app.adapters.web.security.access import (
+    resource_token_cookie,
+    verify_resource_token,
+    verify_token,
+)
+from app.api.context import get_background_task_registry, resolve_background_task_registry
+from app.api.dependencies.auth import (
+    get_current_active_superuser,
+    get_current_active_superuser_async,
+)
+from app.api.dependencies.plugin import (
+    get_plugin_config_command,
+)
+from app.api.principal import ApiPrincipal
+from app.api.response import ResponseAPIRouter
+from app.application.commands import init_commands
+from app.application.configuration import get_api_runtime_config_snapshot, get_configured_system_config
+from app.application.plugin.config import PluginConfigCommand
+from app.application.plugin.folders import remove_plugin_from_folders
+from app.application.plugin.install import PluginInstallCommand
+from app.application.plugin.routes import register_plugin_api, remove_plugin_api
+from app.application.plugin.runtime import PluginRuntime, get_plugin_manager
+from app.application.scheduling import remove_plugin_job, update_plugin_job
+from app.runtime.cache import async_fresh
 from app.runtime.execution import run_in_threadpool
+from app.runtime.extensions.plugin.contracts import (
+    PluginDashboardError,
+    PluginNotFoundError,
+)
+from app.runtime.log import logger
+from app.runtime.tasks import TaskRegistry
 from app.schemas.common import JsonObject as _SchemaJsonObject
+from app.schemas.exception import (
+    PersistenceUnavailableError,
+    PluginMutationRejectedError,
+)
 from app.schemas.plugin import Plugin as _SchemaPlugin
-from app.schemas.plugin import PluginDashboard as _SchemaPluginDashboard
 from app.schemas.plugin import PluginCloneRequest as _SchemaPluginCloneRequest
+from app.schemas.plugin import PluginDashboard as _SchemaPluginDashboard
 from app.schemas.plugin import PluginDashboardMetaItem as _SchemaPluginDashboardMetaItem
 from app.schemas.plugin import PluginFoldersData as _SchemaPluginFoldersData
 from app.schemas.plugin import PluginRating as _SchemaPluginRating
@@ -26,45 +63,7 @@ from app.schemas.plugin import PluginRuntimeSummary as _SchemaPluginRuntimeSumma
 from app.schemas.plugin import PluginSidebarNavItem as _SchemaPluginSidebarNavItem
 from app.schemas.response import Response as _SchemaResponse
 from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.api.response import ResponseAPIRouter
-from app.application.plugin.folders import remove_plugin_from_folders
-from app.application.plugin.routes import register_plugin_api, remove_plugin_api
-from app.application.plugin.install import PluginInstallCommand
-from app.application.plugin.config import PluginConfigCommand
-from app.application.commands import init_commands
-from app.application.scheduling import remove_plugin_job, update_plugin_job
-from app.runtime.cache import async_fresh
-from app.application.configuration import get_api_runtime_config_snapshot
-from app.application.plugin.runtime import PluginRuntime, get_plugin_manager
-from app.runtime.extensions.plugin.contracts import (
-    PluginDashboardError,
-    PluginNotFoundError,
-)
-from app.adapters.web.security.access import (
-    resource_token_cookie,
-    verify_resource_token,
-    verify_token,
-)
-from app.api.principal import ApiPrincipal
-from app.application.configuration import get_configured_system_config
-from app.api.dependencies.auth import (
-    get_current_active_superuser,
-    get_current_active_superuser_async,
-)
-from app.api.dependencies.plugin import (
-    get_plugin_config_command,
-)
-from app.adapters.external.server import MoviePilotServerHelper
-from app.adapters.external.market import PluginHelper
-from app.adapters.system.plugin.package import PluginPackageManager
-from app.schemas.exception import (
-    PersistenceUnavailableError,
-    PluginMutationRejectedError,
-)
-from app.runtime.log import logger
 from app.schemas.types import SystemConfigKey
-from app.api.context import get_background_task_registry, resolve_background_task_registry
-from app.runtime.tasks import TaskRegistry
 
 router = ResponseAPIRouter()
 _plugin_release_refresh_tasks: set[asyncio.Task] = set()

app/api/endpoints/recommend.py

@@ -2,17 +2,17 @@ from typing import Any, Awaitable, List, Optional
 
 from fastapi import Depends, HTTPException, status
 
-from app.schemas.event import RecommendMediaSource as _SchemaRecommendMediaSource
-from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.schemas.transfer import MusicInfo as _SchemaMusicInfo
-from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
+from app.adapters.web.security.access import verify_token
 from app.api.response import ResponseAPIRouter
 from app.chain.recommend import RecommendChain
 from app.runtime.events import eventmanager
-from app.adapters.web.security.access import verify_token
-from app.schemas.exception import TMDbException
+from app.schemas.event import RecommendMediaSource as _SchemaRecommendMediaSource
 from app.schemas.event import RecommendSourceEventData
+from app.schemas.exception import TMDbException
+from app.schemas.token import TokenPayload as _SchemaTokenPayload
+from app.schemas.transfer import MusicInfo as _SchemaMusicInfo
 from app.schemas.types import ChainEventType
+from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
 
 router = ResponseAPIRouter()
 

app/api/endpoints/search.py

@@ -4,25 +4,25 @@ import time
 from typing import Any, AsyncIterator, Iterator, List, Optional
 from uuid import uuid4
 
-from fastapi import Depends, Body, Request
+from fastapi import Body, Depends, Request
 from fastapi.responses import StreamingResponse
 
+from app.adapters.web.security.access import verify_resource_token, verify_token
+from app.api.response import ResponseAPIRouter
+from app.application.security.url import SecurityUtils
+from app.chain.search import SearchChain
+from app.domain.media import normalize_music_type
+from app.runtime.localization import LocaleHelper
+from app.runtime.log import logger
+from app.schemas.media import resolve_media_identity
 from app.schemas.response import Response as _SchemaResponse
 from app.schemas.search import SearchLastContextData as _SchemaSearchLastContextData
 from app.schemas.search import SearchRecommendStatusData as _SchemaSearchRecommendStatusData
 from app.schemas.search import SubtitleInfo as _SchemaSubtitleInfo
 from app.schemas.system import TorrentInfo as _SchemaTorrentInfo
 from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.schemas.workflow import Context as _SchemaContext
-from app.api.response import ResponseAPIRouter
-from app.chain.search import SearchChain
-from app.adapters.web.security.access import verify_resource_token, verify_token
-from app.runtime.localization import LocaleHelper
-from app.runtime.log import logger
 from app.schemas.types import MediaSource, MediaType
-from app.domain.media import normalize_music_type
-from app.schemas.media import resolve_media_identity
-from app.application.security.url import SecurityUtils
+from app.schemas.workflow import Context as _SchemaContext
 
 router = ResponseAPIRouter()
 

app/api/endpoints/site.py

@@ -1,31 +1,9 @@
-from typing import List, Any, Dict, Optional
+from typing import Annotated, Any, Dict, List, Optional
 
 from fastapi import Depends, HTTPException
-from typing import Annotated
 
-from app.schemas.common import JsonObject as _SchemaJsonObject
-from app.schemas.response import Response as _SchemaResponse
-from app.schemas.site import SiteAuth as _SchemaSiteAuth
-from app.schemas.site import SiteCategory as _SchemaSiteCategory
-from app.schemas.site import SiteCookieUpdate as _SchemaSiteCookieUpdate
-from app.schemas.site import SiteIconData as _SchemaSiteIconData
-from app.schemas.site import SiteMappingData as _SchemaSiteMappingData
-from app.schemas.site import SiteStatistic as _SchemaSiteStatistic
-from app.schemas.site import SiteUserData as _SchemaSiteUserData
-from app.schemas.system import TorrentInfo as _SchemaTorrentInfo
-from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.schemas.workflow import Site as _SchemaSite
-from app.api.response import ResponseAPIRouter
-from app.application.site.mutation import SiteMutationCommand
-from app.application.site.query import SiteQueryService
-from app.api.endpoints.plugin import register_plugin_api
-from app.chain.site import SiteChain
-from app.chain.torrents import TorrentsChain
-from app.application.commands import init_commands
-from app.application.plugin.runtime import get_plugin_manager
 from app.adapters.web.security.access import verify_token
-from app.api.principal import ApiPrincipal
-from app.application.configuration import get_configured_system_config
+from app.api.context import get_background_task_registry, resolve_background_task_registry
 from app.api.dependencies.auth import (
     get_current_active_manage_user,
     get_current_active_manage_user_async,
@@ -37,13 +15,34 @@ from app.api.dependencies.site import (
     get_site_query_service,
     get_site_sync_query_service,
 )
-from app.application.site.sites import SitesHelper  # pylint: disable=import-error,no-name-in-module
-from app.runtime.log import logger
+from app.api.endpoints.plugin import register_plugin_api
+from app.api.principal import ApiPrincipal
+from app.api.response import ResponseAPIRouter
+from app.application.commands import init_commands
+from app.application.configuration import get_configured_system_config
+from app.application.plugin.runtime import get_plugin_manager
 from app.application.scheduling import get_scheduler
-from app.schemas.types import SystemConfigKey, MediaType
+from app.application.site.mutation import SiteMutationCommand
+from app.application.site.query import SiteQueryService
+from app.application.site.sites import SitesHelper  # pylint: disable=import-error,no-name-in-module
+from app.chain.site import SiteChain
+from app.chain.torrents import TorrentsChain
 from app.domain import site as site_rules
-from app.api.context import get_background_task_registry, resolve_background_task_registry
+from app.runtime.log import logger
 from app.runtime.tasks import TaskRegistry
+from app.schemas.common import JsonObject as _SchemaJsonObject
+from app.schemas.response import Response as _SchemaResponse
+from app.schemas.site import SiteAuth as _SchemaSiteAuth
+from app.schemas.site import SiteCategory as _SchemaSiteCategory
+from app.schemas.site import SiteCookieUpdate as _SchemaSiteCookieUpdate
+from app.schemas.site import SiteIconData as _SchemaSiteIconData
+from app.schemas.site import SiteMappingData as _SchemaSiteMappingData
+from app.schemas.site import SiteStatistic as _SchemaSiteStatistic
+from app.schemas.site import SiteUserData as _SchemaSiteUserData
+from app.schemas.system import TorrentInfo as _SchemaTorrentInfo
+from app.schemas.token import TokenPayload as _SchemaTokenPayload
+from app.schemas.types import MediaType, SystemConfigKey
+from app.schemas.workflow import Site as _SchemaSite
 
 router = ResponseAPIRouter()
 

app/api/endpoints/storage.py

@@ -7,22 +7,22 @@ from typing import Any, Dict, List, Optional
 from fastapi import Depends, HTTPException
 from starlette.responses import FileResponse, Response
 
-from app.schemas.common import ManageRequest as _SchemaManageRequest
-from app.schemas.response import Response as _SchemaResponse
-from app.schemas.workflow import FileItem as _SchemaFileItem
-from app.api.response import ResponseAPIRouter
-from app.chain.media import MediaChain
-from app.chain.storage import StorageChain
-from app.chain.transfer import TransferChain
-from app.application.configuration import get_api_runtime_config_snapshot
-from app.api.principal import ApiPrincipal
 from app.api.dependencies.auth import (
     get_current_active_manage_user,
     get_current_active_superuser,
 )
-from app.runtime.progress import ProgressHelper
-from app.schemas.types import ProgressKey
+from app.api.principal import ApiPrincipal
+from app.api.response import ResponseAPIRouter
+from app.application.configuration import get_api_runtime_config_snapshot
+from app.chain.media import MediaChain
+from app.chain.storage import StorageChain
+from app.chain.transfer import TransferChain
 from app.foundation import text as text_tools
+from app.runtime.progress import ProgressHelper
+from app.schemas.common import ManageRequest as _SchemaManageRequest
+from app.schemas.response import Response as _SchemaResponse
+from app.schemas.types import ProgressKey
+from app.schemas.workflow import FileItem as _SchemaFileItem
 
 router = ResponseAPIRouter()
 

app/api/endpoints/subscribe.py

@@ -1,47 +1,14 @@
-from typing import List, Any, Annotated, Optional
+from typing import Annotated, Any, List, Optional
 
 import cn2an
-from fastapi import Request, Depends, HTTPException, Header
+from fastapi import Depends, Header, HTTPException, Request
 
-from app.schemas.common import IdData as _SchemaIdData
-from app.schemas.response import Response as _SchemaResponse
-from app.schemas.subscribe import SubscrbieInfo as _SchemaSubscrbieInfo
-from app.schemas.subscribe import SubscribeShare as _SchemaSubscribeShare
-from app.schemas.subscribe import SubscribeShareStatistics as _SchemaSubscribeShareStatistics
-from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
-from app.schemas.workflow import Subscribe as _SchemaSubscribe
-from app.api.response import ResponseAPIRouter
+from app.adapters.external.server import MoviePilotServerHelper
+from app.adapters.web.security.access import verify_apitoken, verify_token
 from app.api.context import (
     get_background_task_registry,
     resolve_background_task_registry,
 )
-from app.chain.subscribe import SubscribeChain
-from app.runtime.events import eventmanager
-from app.domain.context import MediaInfo
-from app.domain.metainfo import MetaInfo
-from app.adapters.web.security.access import verify_token, verify_apitoken
-from app.application.subscription.delete import (
-    DeleteSubscribeCommand,
-    SubscribeDeletionActor,
-)
-from app.application.subscription.identity import (
-    DeleteSubscriptionsByIdentityCommand,
-)
-from app.application.subscription.search import (
-    SearchSubscriptionsCommand,
-    SubscribeSearchActor,
-)
-from app.api.principal import ApiPrincipal
-from app.application.subscription.query import SubscriptionQueryService
-from app.application.subscription.mutation import (
-    SubscriptionActor,
-    SubscriptionMutationService,
-)
-from app.application.configuration import (
-    get_api_runtime_config_snapshot,
-    get_configured_system_config,
-)
 from app.api.dependencies.auth import (
     get_current_active_user,
     get_current_active_user_async,
@@ -50,23 +17,56 @@ from app.api.dependencies.subscription import (
     get_delete_subscribe_command,
     get_delete_subscriptions_by_identity_command,
     get_search_subscriptions_command,
-    get_subscription_query_service,
     get_subscription_mutation_service,
+    get_subscription_query_service,
     get_subscription_sync_mutation_service,
 )
-from app.adapters.external.server import MoviePilotServerHelper
+from app.api.principal import ApiPrincipal
+from app.api.response import ResponseAPIRouter
+from app.application.configuration import (
+    get_api_runtime_config_snapshot,
+    get_configured_system_config,
+)
 from app.application.scheduling import get_scheduler
+from app.application.subscription.delete import (
+    DeleteSubscribeCommand,
+    SubscribeDeletionActor,
+)
+from app.application.subscription.identity import (
+    DeleteSubscriptionsByIdentityCommand,
+)
+from app.application.subscription.mutation import (
+    SubscriptionActor,
+    SubscriptionMutationService,
+)
+from app.application.subscription.query import SubscriptionQueryService
+from app.application.subscription.search import (
+    SearchSubscriptionsCommand,
+    SubscribeSearchActor,
+)
+from app.chain.subscribe import SubscribeChain
+from app.domain.context import MediaInfo
+from app.domain.metainfo import MetaInfo
+from app.runtime.events import eventmanager
 from app.runtime.tasks import TaskRegistry
+from app.schemas.common import IdData as _SchemaIdData
 from app.schemas.event import SubscribeModifiedEventData
+from app.schemas.media import normalize_media_source, resolve_media_identity
+from app.schemas.response import Response as _SchemaResponse
+from app.schemas.subscribe import SubscrbieInfo as _SchemaSubscrbieInfo
+from app.schemas.subscribe import SubscribeShare as _SchemaSubscribeShare
+from app.schemas.subscribe import SubscribeShareStatistics as _SchemaSubscribeShareStatistics
+from app.schemas.token import TokenPayload as _SchemaTokenPayload
 from app.schemas.types import (
     MUSIC_ENTITY_ALBUM,
     MUSIC_ENTITY_RECORDING,
+    EventType,
     MediaSource,
     MediaType,
-    EventType,
     SystemConfigKey,
 )
-from app.schemas.media import normalize_media_source, resolve_media_identity
+from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
+from app.schemas.workflow import Subscribe as _SchemaSubscribe
 
 router = ResponseAPIRouter()
 

app/api/endpoints/system.py

@@ -6,25 +6,76 @@ import zipfile
 from collections import deque
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Optional, Union, Annotated
-from urllib.parse import urljoin, urlparse
+from typing import Annotated, Any, Optional, Union
+from urllib.parse import urlparse
 
 import aiofiles
 import anyio
 import pillow_avif  # noqa: F401  # pylint: disable=unused-import  # AVIF 注册副作用
 from anyio import Path as AsyncPath
-from app.application.site.sites import SitesHelper  # pylint: disable=import-error,no-name-in-module
-from fastapi import Body, Depends, HTTPException, Header, Request, Response
+from fastapi import Body, Depends, Header, HTTPException, Request, Response
 from fastapi.responses import StreamingResponse
 
+from app.adapters.external.market import (
+    PLUGIN_MARKET_WIKI_URL,
+    extract_plugin_market_repos_from_wiki,
+    merge_plugin_market_repos,
+    split_plugin_market_repo_urls,
+)
+from app.adapters.external.server import MoviePilotServerHelper
+from app.adapters.network.http import AsyncRequestUtils, RequestUtils
+from app.adapters.system import rust as rust_accel
+from app.adapters.system.update import system_update_manager
+from app.adapters.web.security.access import verify_apitoken, verify_resource_token, verify_token
+from app.api.dependencies.auth import (
+    get_current_active_superuser,
+    get_current_active_superuser_async,
+    get_current_active_user_async,
+)
+from app.api.principal import ApiPrincipal
+from app.api.response import ResponseAPIRouter
+from app.application.backup import DatabaseBackupInProgressError
+from app.application.configuration import (
+    get_configured_system_config,
+    get_runtime_settings,
+)
+from app.application.database import get_database_governance
+from app.application.image import ImageHelper
+from app.application.messaging.message import MessageHelper
+from app.application.module import get_module_manager
+from app.application.network import NetworkTestService
+from app.application.plugin.runtime import plugin_system_config_mutation
+from app.application.rules import RuleHelper
+from app.application.scheduling import get_scheduler
+from app.application.security.url import SecurityUtils
+from app.application.site.sites import SitesHelper  # pylint: disable=import-error,no-name-in-module
+from app.chain.media import MediaChain
+from app.chain.mediaserver import MediaServerChain
+from app.chain.search import SearchChain
+from app.domain.metainfo import MetaInfo
+from app.foundation.crypto import HashUtils
+from app.foundation.environment import is_free_threaded_runtime, is_gil_enabled
+from app.foundation.url import UrlUtils
+from app.runtime.events import eventmanager
+from app.runtime.execution import run_in_threadpool_to_completion
+from app.runtime.localization import LocaleHelper
+from app.runtime.log import logger
+from app.runtime.progress import AsyncProgressHelper
+from app.runtime.scheduling import TimerUtils
+from app.runtime.state import SystemHelper
+from app.runtime.stop import runtime_stop_state
+from app.runtime.config import global_vars
+from app.runtime.version import get_app_version, get_frontend_version
 from app.schemas.common import JsonObject as _SchemaJsonObject
 from app.schemas.common import JsonObjectList as _SchemaJsonObjectList
 from app.schemas.common import TimeData as _SchemaTimeData
 from app.schemas.common import ValueData as _SchemaValueData
+from app.schemas.event import ConfigChangeEventData
+from app.schemas.exception import PluginMutationRejectedError
 from app.schemas.response import Response as _SchemaResponse
-from app.schemas.system import NetTestTarget as _SchemaNetTestTarget
 from app.schemas.system import DatabaseBackupArtifactData as _SchemaDatabaseBackupArtifactData
 from app.schemas.system import DatabaseBackupVerificationData as _SchemaDatabaseBackupVerificationData
+from app.schemas.system import NetTestTarget as _SchemaNetTestTarget
 from app.schemas.system import PluginMarketSyncData as _SchemaPluginMarketSyncData
 from app.schemas.system import PluginMarketSyncRequest as _SchemaPluginMarketSyncRequest
 from app.schemas.system import RuleTestData as _SchemaRuleTestData
@@ -33,58 +84,7 @@ from app.schemas.system import SystemModuleListData as _SchemaSystemModuleListDa
 from app.schemas.system import SystemUpdateStatus as _SchemaSystemUpdateStatus
 from app.schemas.system import TorrentInfo as _SchemaTorrentInfo
 from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.api.response import ResponseAPIRouter
-from app.chain.media import MediaChain
-from app.chain.mediaserver import MediaServerChain
-from app.chain.search import SearchChain
-from app.chain.system import SystemChain
-from app.runtime.config import global_vars
-from app.runtime.events import eventmanager
-from app.domain.metainfo import MetaInfo
-from app.application.module import get_module_manager
-from app.adapters.web.security.access import verify_apitoken, verify_resource_token, verify_token
-from app.api.principal import ApiPrincipal
-from app.application.configuration import (
-    get_configured_system_config,
-    get_runtime_settings,
-)
-from app.application.backup import DatabaseBackupInProgressError
-from app.application.database import get_database_governance
-from app.application.plugin.runtime import plugin_system_config_mutation
-from app.api.dependencies.auth import (
-    get_current_active_superuser,
-    get_current_active_superuser_async,
-    get_current_active_user_async,
-)
-from app.application.image import ImageHelper
-from app.runtime.localization import LocaleHelper
-from app.adapters.external.market import (
-    PLUGIN_MARKET_WIKI_URL,
-    extract_plugin_market_repos_from_wiki,
-    merge_plugin_market_repos,
-    split_plugin_market_repo_urls,
-)
-from app.application.messaging.message import MessageHelper
-from app.runtime.progress import AsyncProgressHelper
-from app.runtime.scheduling import TimerUtils
-from app.application.rules import RuleHelper
-from app.adapters.external.server import MoviePilotServerHelper
-from app.runtime.state import SystemHelper
-from app.runtime.log import logger
-from app.runtime.execution import run_in_threadpool_to_completion
-from app.application.scheduling import get_scheduler
-from app.schemas.event import ConfigChangeEventData
-from app.schemas.exception import PluginMutationRejectedError
-from app.schemas.types import SystemConfigKey, EventType
-from app.foundation.crypto import HashUtils
-from app.foundation.environment import is_free_threaded_runtime, is_gil_enabled
-from app.adapters.network.http import RequestUtils, AsyncRequestUtils
-from app.adapters.system import rust as rust_accel
-from app.adapters.system.update import system_update_manager
-from app.application.security.url import SecurityUtils
-from app.application.network import NetworkTestService
-from app.foundation.url import UrlUtils
-from app.runtime.version import get_app_version, get_frontend_version
+from app.schemas.types import EventType, SystemConfigKey
 
 router = ResponseAPIRouter()
 
@@ -1042,7 +1042,7 @@ async def get_progress(
 
     async def event_generator():
         try:
-            while not global_vars.is_system_stopped:
+            while not runtime_stop_state.is_system_stopped:
                 if await request.is_disconnected():
                     break
                 detail = await progress.get(locale=locale)
@@ -1233,7 +1233,7 @@ async def get_message(
 
     async def event_generator():
         try:
-            while not global_vars.is_system_stopped:
+            while not runtime_stop_state.is_system_stopped:
                 if await request.is_disconnected():
                     break
                 detail = message.get(role)
@@ -1314,7 +1314,7 @@ async def _get_logging_impl(
                 initial_stat = await log_path.stat()
                 initial_size = initial_stat.st_size
                 # 实时监听新日志，使用更短的轮询间隔
-                while not global_vars.is_system_stopped:
+                while not runtime_stop_state.is_system_stopped:
                     if await request.is_disconnected():
                         break
                     # 检查文件是否有新内容
@@ -1413,7 +1413,7 @@ async def latest_version(_: _SchemaTokenPayload = Depends(verify_token)):
     version_res = await AsyncRequestUtils(
         proxies=get_runtime_settings().get("PROXY"),
         headers=get_runtime_settings().get("GITHUB_HEADERS"),
-    ).get_res(f"https://api.github.com/repos/jxxghp/MoviePilot/releases")
+    ).get_res("https://api.github.com/repos/jxxghp/MoviePilot/releases")
     if version_res is not None and version_res.status_code == 200:
         ver_json = version_res.json()
         if ver_json:

app/api/endpoints/tmdb.py

@@ -1,21 +1,20 @@
-from typing import List, Any, Optional
+from typing import Any, List, Optional
 
 from fastapi import Depends
 
+from app.adapters.web.security.access import verify_token
+from app.api.dependencies.auth import get_current_active_superuser_async
+from app.api.response import ResponseAPIRouter
+from app.application.configuration import get_api_runtime_config_snapshot, get_configured_system_config
+from app.chain.tmdb import TmdbChain
 from app.schemas.context import MediaPerson as _SchemaMediaPerson
 from app.schemas.response import Response as _SchemaResponse
+from app.schemas.tmdb import TmdbEpisode as _SchemaTmdbEpisode
 from app.schemas.tmdb import TmdbRecognitionCacheData as _SchemaTmdbRecognitionCacheData
 from app.schemas.tmdb import TmdbSeason as _SchemaTmdbSeason
 from app.schemas.token import TokenPayload as _SchemaTokenPayload
-from app.schemas.tmdb import TmdbEpisode as _SchemaTmdbEpisode
-from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
-from app.api.response import ResponseAPIRouter
-from app.chain.tmdb import TmdbChain
-from app.application.configuration import get_api_runtime_config_snapshot
-from app.adapters.web.security.access import verify_token
-from app.application.configuration import get_configured_system_config
-from app.api.dependencies.auth import get_current_active_superuser_async
 from app.schemas.types import MediaType, SystemConfigKey
+from app.schemas.workflow import MediaInfo as _SchemaMediaInfo
 
 router = ResponseAPIRouter()
 

app/api/endpoints/torrent.py

@@ -2,24 +2,24 @@ from typing import Optional
 
 from fastapi import Depends
 
-from app.schemas.cache import TorrentCacheData as _SchemaTorrentCacheData
-from app.schemas.cache import TorrentReidentifyData as _SchemaTorrentReidentifyData
-from app.schemas.response import Response as _SchemaResponse
-from app.api.response import ResponseAPIRouter
-from app.chain.media import MediaChain
-from app.chain.torrents import TorrentsChain
-from app.application.configuration import get_api_runtime_config_snapshot
 from app.api.dependencies.auth import (
     get_current_active_superuser,
     get_current_active_superuser_async,
 )
+from app.api.response import ResponseAPIRouter
+from app.application.configuration import get_api_runtime_config_snapshot
+from app.application.torrent_cache import TorrentCacheRecognitionService
+from app.chain.media import MediaChain
+from app.chain.torrents import TorrentsChain
+from app.foundation.crypto import HashUtils
+from app.schemas.cache import TorrentCacheData as _SchemaTorrentCacheData
+from app.schemas.cache import TorrentReidentifyData as _SchemaTorrentReidentifyData
+from app.schemas.media import resolve_media_identity
+from app.schemas.response import Response as _SchemaResponse
 from app.schemas.types import (
     MediaSource,
     MusicTargetEntityType,
 )
-from app.foundation.crypto import HashUtils
-from app.schemas.media import resolve_media_identity
-from app.application.torrent_cache import TorrentCacheRecognitionService
 
 router = ResponseAPIRouter()
 

app/api/endpoints/transfer.py

@@ -1,34 +1,33 @@
 from pathlib import Path
-from typing import Any, List, Annotated, Optional
+from typing import Annotated, Any, List, Optional
 
 from fastapi import Depends
 
+from app.adapters.web.security.access import verify_apitoken, verify_token
+from app.api.dependencies.auth import get_current_active_manage_user
+from app.api.dependencies.history import get_transfer_history_lookup_service
+from app.api.response import ResponseAPIRouter
+from app.application.configuration import get_api_runtime_config_snapshot
+from app.application.directory import DirectoryHelper
+from app.application.history import TransferHistoryLookupService
+from app.chain.media import MediaChain
+from app.chain.transfer import TransferChain
+from app.runtime.log import logger
+from app.runtime.stop import runtime_stop_state
 from app.schemas.common import NameData as _SchemaNameData
 from app.schemas.response import Response as _SchemaResponse
+from app.schemas.system import TransferDirectoryConf as _SchemaTransferDirectoryConf
 from app.schemas.token import TokenPayload as _SchemaTokenPayload
 from app.schemas.transfer import EpisodeFormat as _SchemaEpisodeFormat
 from app.schemas.transfer import EpisodeFormatRecommendData as _SchemaEpisodeFormatRecommendData
+from app.schemas.transfer import EpisodeFormatRecommendItem, ManualTransferItem
 from app.schemas.transfer import ManualTransferHistoryInfo as _SchemaManualTransferHistoryInfo
 from app.schemas.transfer import ManualTransferResultData as _SchemaManualTransferResultData
 from app.schemas.transfer import ManualTransferTargetPath as _SchemaManualTransferTargetPath
-from app.schemas.system import TransferDirectoryConf as _SchemaTransferDirectoryConf
 from app.schemas.transfer import TransferJob as _SchemaTransferJob
-from app.schemas.workflow import FileItem as _SchemaFileItem
-from app.api.response import ResponseAPIRouter
-from app.chain.media import MediaChain
-from app.chain.transfer import TransferChain
-from app.runtime.config import global_vars
-from app.application.configuration import get_api_runtime_config_snapshot
-from app.adapters.web.security.access import verify_token, verify_apitoken
-from app.api.dependencies.auth import get_current_active_manage_user
-from app.api.dependencies.history import get_transfer_history_lookup_service
-from app.application.directory import DirectoryHelper
-from app.application.history import TransferHistoryLookupService
-from app.runtime.log import logger
 from app.schemas.types import MediaType
 from app.schemas.workflow import FileItem
-from app.schemas.transfer import ManualTransferItem
-from app.schemas.transfer import EpisodeFormatRecommendItem
+from app.schemas.workflow import FileItem as _SchemaFileItem
 
 router = ResponseAPIRouter()
 
@@ -102,7 +101,7 @@ async def remove_queue(
     """
     TransferChain().remove_from_queue(fileitem)
     # 取消整理
-    global_vars.stop_transfer(fileitem.path)
+    runtime_stop_state.stop_transfer(fileitem.path)
     return _SchemaResponse(success=True)
 
 
@@ -398,7 +397,7 @@ def _execute_manual_transfer(
     elif transer_item.fileitem:
         src_fileitems = [transer_item.fileitem]
     else:
-        return _SchemaResponse(success=False, message=f"缺少参数")
+        return _SchemaResponse(success=False, message="缺少参数")
 
     dedup_fileitems: List[FileItem] = []
     seen_paths = set()

app/api/endpoints/user.py

@@ -2,23 +2,23 @@ import base64
 import re
 from typing import Annotated, Any, List, Union
 
-from fastapi import Body, Depends, HTTPException, UploadFile, File
+from fastapi import Body, Depends, File, HTTPException, UploadFile
 
+from app.api.dependencies.auth import (
+    get_current_active_superuser_async,
+    get_current_active_user_async,
+    get_user_service,
+)
+from app.api.response import ResponseAPIRouter
+from app.application.security.token import PasswordTooLongError, get_password_hash
+from app.application.security.user import UserService
+from app.application.security.userconfig import get_configured_user_configuration
 from app.schemas.common import FileNameData as _SchemaFileNameData
 from app.schemas.common import ValueData as _SchemaValueData
 from app.schemas.response import Response as _SchemaResponse
 from app.schemas.user import User as _SchemaUser
 from app.schemas.user import UserCreate as _SchemaUserCreate
 from app.schemas.user import UserUpdate as _SchemaUserUpdate
-from app.api.response import ResponseAPIRouter
-from app.application.security.token import PasswordTooLongError, get_password_hash
-from app.application.security.user import UserService
-from app.api.dependencies.auth import (
-    get_current_active_superuser_async,
-    get_current_active_user_async,
-    get_user_service,
-)
-from app.application.security.userconfig import get_configured_user_configuration
 
 router = ResponseAPIRouter()
 

app/api/endpoints/webhook.py

@@ -1,13 +1,13 @@
-from typing import Any, Annotated
+from typing import Annotated, Any
 
 from fastapi import Depends, Request
 
-from app.schemas.response import Response as _SchemaResponse
-from app.api.response import ResponseAPIRouter
-from app.chain.webhook import WebhookChain
 from app.adapters.web.security.access import verify_apitoken
 from app.api.context import get_background_task_registry, resolve_background_task_registry
+from app.api.response import ResponseAPIRouter
+from app.chain.webhook import WebhookChain
 from app.runtime.tasks import TaskRegistry
+from app.schemas.response import Response as _SchemaResponse
 
 router = ResponseAPIRouter()
 

app/api/endpoints/workflow.py

@@ -1,22 +1,8 @@
-from typing import List, Any, Optional
+from typing import Any, List, Optional
 
 from fastapi import Depends
 
-from app.schemas.response import Response as _SchemaResponse
-from app.schemas.workflow import NameValueOption as _SchemaNameValueOption
-from app.schemas.workflow import PluginWorkflowActionGroup as _SchemaPluginWorkflowActionGroup
-from app.schemas.workflow import Workflow as _SchemaWorkflow
-from app.schemas.workflow import WorkflowActionDefinition as _SchemaWorkflowActionDefinition
-from app.schemas.workflow import WorkflowShare as _SchemaWorkflowShare
-from app.api.response import ResponseAPIRouter
-from app.application.workflow import (
-    WorkflowDefinitionCommand,
-    WorkflowMutationCommand,
-    WorkflowQueryService,
-    get_workflow_manager,
-)
-from app.chain.workflow import WorkflowChain
-from app.application.plugin.runtime import get_plugin_manager
+from app.adapters.external.server import MoviePilotServerHelper
 from app.api.dependencies.auth import (
     get_current_active_manage_user,
     get_current_active_manage_user_async,
@@ -26,8 +12,22 @@ from app.api.dependencies.workflow import (
     get_workflow_mutation_command,
     get_workflow_query_service,
 )
-from app.adapters.external.server import MoviePilotServerHelper
-from app.schemas.types import EventType, EVENT_TYPE_NAMES
+from app.api.response import ResponseAPIRouter
+from app.application.plugin.runtime import get_plugin_manager
+from app.application.workflow import (
+    WorkflowDefinitionCommand,
+    WorkflowMutationCommand,
+    WorkflowQueryService,
+    get_workflow_manager,
+)
+from app.chain.workflow import WorkflowChain
+from app.schemas.response import Response as _SchemaResponse
+from app.schemas.types import EVENT_TYPE_NAMES, EventType
+from app.schemas.workflow import NameValueOption as _SchemaNameValueOption
+from app.schemas.workflow import PluginWorkflowActionGroup as _SchemaPluginWorkflowActionGroup
+from app.schemas.workflow import Workflow as _SchemaWorkflow
+from app.schemas.workflow import WorkflowActionDefinition as _SchemaWorkflowActionDefinition
+from app.schemas.workflow import WorkflowShare as _SchemaWorkflowShare
 
 router = ResponseAPIRouter()
 

app/api/presentation/sse.py

@@ -6,7 +6,6 @@ from typing import Any
 
 from fastapi.responses import StreamingResponse
 
-
 SSE_HEADERS = {
     "Cache-Control": "no-cache, no-transform",
     "Connection": "keep-alive",

app/api/response.py

@@ -11,7 +11,6 @@ from starlette.responses import Response as StarletteResponse
 from app.schemas.common import JsonData
 from app.schemas.response import Response, ValidationIssue
 
-
 ERROR_RESPONSES: dict[int, dict[str, Any]] = {
     400: {"model": Response[None], "description": "请求错误"},
     401: {"model": Response[None], "description": "未认证"},

app/api/servarr.py

@@ -1,8 +1,19 @@
-from typing import List, Optional, Annotated
+from typing import Annotated, List, Optional
 
-from fastapi import APIRouter, HTTPException, Depends
+from fastapi import APIRouter, Depends, HTTPException
 
+from app.adapters.web.security.access import verify_apikey
+from app.api.dependencies.subscription import get_servarr_subscription_service
+from app.api.response import ERROR_RESPONSES
+from app.application.servarr import ServarrSubscription, ServarrSubscriptionService
+from app.chain.media import MediaChain
+from app.chain.subscribe import SubscribeChain
+from app.chain.tvdb import TvdbChain
+from app.domain.context import MediaInfo
+from app.domain.metainfo import MetaInfo
+from app.runtime.version import get_app_version
 from app.schemas.response import Response as _SchemaResponse
+from app.schemas.servarr import RadarrMovie, SonarrSeries
 from app.schemas.servarr import RadarrMovie as _SchemaRadarrMovie
 from app.schemas.servarr import ServarrIdResponse as _SchemaServarrIdResponse
 from app.schemas.servarr import ServarrLanguageProfile as _SchemaServarrLanguageProfile
@@ -11,19 +22,7 @@ from app.schemas.servarr import ServarrRootFolder as _SchemaServarrRootFolder
 from app.schemas.servarr import ServarrSystemStatus as _SchemaServarrSystemStatus
 from app.schemas.servarr import ServarrTag as _SchemaServarrTag
 from app.schemas.servarr import SonarrSeries as _SchemaSonarrSeries
-from app.api.response import ERROR_RESPONSES
-from app.chain.media import MediaChain
-from app.chain.subscribe import SubscribeChain
-from app.chain.tvdb import TvdbChain
-from app.domain.context import MediaInfo
-from app.domain.metainfo import MetaInfo
-from app.application.servarr import ServarrSubscription, ServarrSubscriptionService
-from app.adapters.web.security.access import verify_apikey
-from app.api.dependencies.subscription import get_servarr_subscription_service
-from app.schemas.servarr import RadarrMovie
-from app.schemas.servarr import SonarrSeries
 from app.schemas.types import MediaSource, MediaType
-from app.runtime.version import get_app_version
 
 arr_router = APIRouter(tags=["servarr"], responses=ERROR_RESPONSES)
 

app/api/servcookie.py

@@ -9,15 +9,15 @@ from fastapi import APIRouter, Body, Depends, Header, HTTPException, Path, Reque
 from fastapi.responses import PlainTextResponse
 from fastapi.routing import APIRoute
 
+from app.api.response import ERROR_RESPONSES
+from app.application.configuration import get_api_runtime_config_snapshot
+from app.foundation.crypto import CryptoJsUtils, HashUtils
+from app.runtime.log import logger
 from app.schemas.servcookie import CookieActionResponse as _SchemaCookieActionResponse
 from app.schemas.servcookie import CookieData as _SchemaCookieData
 from app.schemas.servcookie import CookieDecryptedPayload as _SchemaCookieDecryptedPayload
 from app.schemas.servcookie import CookieEncryptedPayload as _SchemaCookieEncryptedPayload
 from app.schemas.servcookie import CookiePassword as _SchemaCookiePassword
-from app.api.response import ERROR_RESPONSES
-from app.application.configuration import get_api_runtime_config_snapshot
-from app.runtime.log import logger
-from app.foundation.crypto import CryptoJsUtils, HashUtils
 
 
 class GzipRequest(Request):