mirror of
https://github.com/jxxghp/MoviePilot.git
synced 2026-11-08 19:40:04 +08:00
e47d7defe7
全局日志等级是一个开关，调试单个插件时只能整体下调。一旦下调，被调试插件那几行 日志会淹没在其他几十个插件与宿主自身的 DEBUG 输出里，找不出来；不下调又什么都 看不见。插件实例数量只会继续增长，这个矛盾不会自己消失。 因此把等级下放到实例：plugininstance 行加 log_level / log_expires_at 两列，本体与 分身共用同一张表、同一套语义。等级落在实例自己那一行而不是另起一张按实例 ID 索引 的表——它和业务参数一样是用户按实例设置的东西，同一个生命周期，实例被删时应当随行 一起消失。清除覆盖后若本体行只剩一对身份列，整行按 carries_only_identity 回收，与 清空业务参数同一规则。 覆盖带失效时间，因为它是调试设置不是长期配置：开了 DEBUG 忘记关，下次谁也想不起 某个插件为什么一直在刷日志。过期判定在读取时惰性执行并就地清理，不另起后台线程去 扫一张最多几十条的表。expires_at 在写入侧先归一到 UTC 再分发给缓存与落盘两处：客户端 提交的时间可能不带时区，两处各按进程时区折算一次，就会与读取口返回的 UTC 值差出一个 时区，表现为「提交的失效时刻和读回来的对不上」。 运行期用 ContextVar 在宿主自己控制的四类调用点绑定当前实例——构造与 init_plugin、 事件处理器、定时服务回调、插件声明的 HTTP 端点——而不是沿用 logger() 已有的栈帧内省。 内省认的是栈顶的模块与类，插件通过宿主公共方法转发调用时栈顶是宿主而不是发起调用的 插件，会把日志记到错误的来源上；分身更甚：分身共享源码，类的 __qualname__ 保持源类名 不变，内省根本分不出是哪一个分身在打日志。内省结果继续只用于文件路由，不参与等级判定。 等级过滤必须排在全局等级判定之前。官方现状是先按全局等级短路、之后才做内省，先短路 就会把实例调低的等级挡在门外，后面再怎么识别来源都看不到这条日志。 回调在注册时被捕获、稍后才由调度器或 FastAPI 调用，那时已经不在任何绑定作用域内， 故这两处改用 wrap_for_plugin_instance 把绑定包进回调自身；同一实例重复包装直接返回 原对象，避免插件缓存声明时包装链随重载次数无限增长。 进程内覆盖表按实例 ID 常驻，删分身时必须一并清掉：只删库里那一行的话，同一进程内用 相同后缀重建的分身会继承上一个分身的等级，界面显示「跟随全局」而实际仍按旧等级输出。 进程重启后反向从库预热缓存。 迁移链在 F1 之后追加：c4e1a7b9d2f6（3.0.35）-> 487f7e681955（3.0.36 加两列）。 顺带补了 agent 策略里缺失的 media.classification.policy.get 的 template 字段说明： 少了它，api_mcp_schema.json 与技能文档的两个生成脚本都跑不起来。
83 lines
2.9 KiB
Python
83 lines
2.9 KiB
Python
"""插件实例日志等级查询与设置接口。"""
|
|
|
|
from typing import Any
|
|
|
|
from fastapi import Depends, HTTPException
|
|
|
|
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.plugin.runtime import get_plugin_manager
|
|
from app.schemas.plugin import PluginInstanceLogLevelOverview as _SchemaPluginInstanceLogLevelOverview
|
|
from app.schemas.plugin import PluginInstanceLogLevelUpdateRequest as _SchemaPluginInstanceLogLevelUpdateRequest
|
|
from app.schemas.response import Response as _SchemaResponse
|
|
|
|
router = ResponseAPIRouter()
|
|
|
|
|
|
@router.get( # type: ignore[misc]
|
|
"/loglevel/{plugin_id}",
|
|
summary="查询插件全部实例的日志等级设置",
|
|
response_model=_SchemaResponse[_SchemaPluginInstanceLogLevelOverview],
|
|
)
|
|
def plugin_instance_log_levels(
|
|
plugin_id: str,
|
|
_: ApiPrincipal = Depends(get_current_active_superuser),
|
|
) -> Any:
|
|
"""
|
|
查询插件全部实例（含本体）当前的日志等级设置
|
|
"""
|
|
try:
|
|
levels = get_plugin_manager().get_plugin_instance_log_levels(plugin_id)
|
|
except LookupError as error:
|
|
raise HTTPException(status_code=404, detail=str(error)) from error
|
|
return _SchemaResponse(
|
|
success=True,
|
|
data={"plugin_id": plugin_id, "instances": levels},
|
|
)
|
|
|
|
|
|
@router.put( # type: ignore[misc]
|
|
"/loglevel/{plugin_id}/{instance_id}",
|
|
summary="设置插件实例的日志等级覆盖",
|
|
response_model=_SchemaResponse[None],
|
|
)
|
|
def set_plugin_instance_log_level(
|
|
plugin_id: str,
|
|
instance_id: str,
|
|
update: _SchemaPluginInstanceLogLevelUpdateRequest,
|
|
_: ApiPrincipal = Depends(get_current_active_superuser),
|
|
) -> Any:
|
|
"""
|
|
设置指定插件实例的日志等级覆盖，运行期立即生效，不随全局日志等级变更
|
|
"""
|
|
try:
|
|
get_plugin_manager().set_plugin_instance_log_level(
|
|
plugin_id, instance_id, update.level, update.expires_at
|
|
)
|
|
except LookupError as error:
|
|
raise HTTPException(status_code=404, detail=str(error)) from error
|
|
except ValueError as error:
|
|
raise HTTPException(status_code=400, detail=str(error)) from error
|
|
return _SchemaResponse(success=True)
|
|
|
|
|
|
@router.delete( # type: ignore[misc]
|
|
"/loglevel/{plugin_id}/{instance_id}",
|
|
summary="清除插件实例的日志等级覆盖",
|
|
response_model=_SchemaResponse[None],
|
|
)
|
|
def clear_plugin_instance_log_level(
|
|
plugin_id: str,
|
|
instance_id: str,
|
|
_: ApiPrincipal = Depends(get_current_active_superuser),
|
|
) -> Any:
|
|
"""
|
|
清除指定插件实例的日志等级覆盖，立即回落全局等级，重复调用保持幂等
|
|
"""
|
|
try:
|
|
get_plugin_manager().clear_plugin_instance_log_level(plugin_id, instance_id)
|
|
except LookupError as error:
|
|
raise HTTPException(status_code=404, detail=str(error)) from error
|
|
return _SchemaResponse(success=True)
|