34 KiB
A7 · main.py 插件入口 + backend/routes 路由层 + 权限矩阵
审计范围(实际逐行读过的文件):
main.py、backend/route_registry.py、adapters/astrbot_adapter.py、core/identity.py、core/security.py、core/media_proxy.py、backend/routes/(common.pyparams.pyprofile_routes.pyworkflow_routes.pynode_routes.pyround_routes.pyjob_routes.pyimage_routes.pymedia_routes.pylog_routes.pyhistory_routes.pysettings_routes.pydata_backup_routes.pywardrobe_routes.pyintegration_routes.pyadvanced_material_routes.pyprompt_routes.pyevent_routes.py,其余 17 个文件通过脚本提取 def+guard 全量比对)、backend/dto/common.py、backend/dto/job_dto.py、backend/dto/workflow_round_dto.py、backend/services/profile_service.py、workflow_service.py、workflow_round_service.py、resource_access_service.py、image_service.py、queue_service.py、media_service.py、generation_service.py(权限相关片段)、prompt_governance_service.py、wardrobe_service.py、profile_document_import_service.py、model_provider_bootstrap.py、database/db_helper.py(Database 构造)、frontend/shared/api/client.ts、frontend/shared/api/endpoints.ts已按要求忽略
.tmp/、release/、node_modules/、__pycache__/、web/assets/、pages/imagestudio/assets/。
摘要
PERMISSION_MATRIX 只是一张声明式清单——dispatch_extension_request() 从头到尾没有读过 RouteMatch.permission,真正的鉴权全靠每个 handler 里手写的 require_*(ctx)。我用脚本把 169 条 RouteSpec 与 handler 内实际调用的 require_* 逐条比对,声明与实现在权限"类别"上基本对得上(这点做得不错),但矩阵本身在运行时被上游架空:main.py 的桥接层给任何登录用户无条件发放 can_write / can_manage_config / can_manage_materials / can_retry_tasks 全部四项,于是六级权限矩阵在生产路径上塌缩成"登录 / 未登录"两级。
更严重的是归属校验的覆盖不完整:profile 与 round 两条链路正确接入了 owner 校验(ProfileService._require_owner / ResourceAccessService.require_node),而 workflow / node / image / job / history 五条链路的 service 方法根本不接收 ctx,任何登录用户凭 ID 即可读写他人的工作流、节点、图片与任务队列(GET jobs 甚至直接返回他人完整的生成请求体)。
此外还有三个结构性问题:客户端可自带 content_permissions / entrypoint 绕过成人内容路由闸门;所有 service 构造都发生在 require_* 之前(未授权请求即可触发重型 provider 初始化 + DB 写入,且构造期异常逃出 handle_request 直接 500);157 个 handler 是完全同构的三行样板 + 22 个各自为政的 _create_*_service() 工厂。
发现
[P0-致命] 桥接层给所有登录用户发放全部权限,PERMISSION_MATRIX 在运行时被架空
- 位置:
main.py:104、main.py:2337 - 问题:
_request_context_from_astrbot_request()只要能取到 username/user_id,就把BRIDGE_PERMISSIONS(四项全部)塞进RequestContext.permissions。而 AstrBot Plugin Page 桥接(register_bridge_api→_make_bridge_handler)是前端真正走的通路。结果config(改配置、导入配置、回滚快照、恢复备份、轮换 private-companion token)、materials、retry三档权限与read完全等价。 - 代码:
# main.py:104 BRIDGE_PERMISSIONS = frozenset( {"can_write", "can_manage_config", "can_manage_materials", "can_retry_tasks"} ) # main.py:2333-2344 # AstrBot authenticates extension routes before invoking the plugin, but # PluginRequest currently exposes only the authenticated username. Grant # the capabilities that exist today explicitly instead of a wildcard so a # future permission cannot become enabled accidentally. permissions = BRIDGE_PERMISSIONS if username or user_id else frozenset() return RequestContext.from_astrbot( username=username, user_id=user_id, client_ip=_client_ip(request), source="astrbot_plugin_page", permissions=permissions, ) - 影响:任意一个 AstrBot WebUI 普通登录用户可以:
POST settings/save改数据库后端/模型密钥环境变量名、POST settings/rollback、POST backups/{id}/restore覆盖全量数据、POST integrations/private-companion/token/rotate轮换外部集成令牌、POST jobs/failed/clear清空他人失败队列。route_registry.py里config(22 条)、materials(38 条)、retry(8 条)三档共 68 条路由的权限边界形同虚设。同时因为没人拥有can_manage_all_profiles,ResourceAccessService._can_access的管理员分支是死代码。 - 修复建议:
- 从 AstrBot 请求上下文里真正解析角色/权限(
_attr(request, "roles")/request.user.permissions等,按 AstrBot 版本探测),映射成 ImageStudio 的四项能力;探测不到时降级为最小集frozenset()(只读),而不是最大集。 - 在
config.yaml增加显式的管理员白名单(security.admin_usernames/security.material_managers),_request_context_from_astrbot_request据此授予can_manage_config/can_manage_materials/can_manage_all_profiles。 - 把
permission真正接进分发器(见下一条),让矩阵成为强制点而非注释。
- 从 AstrBot 请求上下文里真正解析角色/权限(
[P0-致命] dispatch_extension_request 从不检查 RouteMatch.permission,矩阵与实现只靠人工同步
- 位置:
adapters/astrbot_adapter.py:171-187 - 问题:分发器解析出
match.permission后直接丢弃,立刻match.handler(...)。鉴权 100% 依赖每个 handler 内部手写require_*。仓库里没有任何测试或启动断言校验"RouteSpec.permission== handler 实际 guard",runtime_health()只校验路由唯一性与权限名已知,不校验一致性。 - 代码:
对照def dispatch_extension_request(ctx, method, path, *, query=None, payload=None) -> dict[str, Any]: match = resolve_route(method, path) if match is None: return error_response(...) return match.handler(*_handler_args(match, ctx, query or {}, payload or {})) # ↑ match.permission 从未被使用route_registry.py:365-377:def assert_unique_routes() -> None: ... # 只查重复 def assert_known_permissions() -> None: ... # 只查权限名拼写 - 影响:新增一条路由时只要忘写
require_write(ctx),就是一个静默的未授权写接口,CI 与runtime_health()都不会报警。当前 169 条路由靠人工维持一致(我逐条比对确认目前没有漏挂),但这是一次疏忽即破防的结构。同时_register_route()虽然把permission=传给 AstrBot,但真正生效的桥接注册_bridge_registration_routes()是<path:endpoint>通配符,不携带任何权限元数据(main.py:1753-1758)。 - 修复建议:在分发器里做集中式强制:
handler 内的from backend.route_registry import permission_requirement from backend.dto.common import ErrorCode, error_response def dispatch_extension_request(ctx, method, path, *, query=None, payload=None): match = resolve_route(method, path) if match is None: ... rule = permission_requirement(match.permission) if rule["auth_required"] and not ctx.is_authenticated: return error_response(error_code=ErrorCode.UNAUTHORIZED, message="...", request_id=ctx.request_id) required = rule.get("required_permissions") or ([rule["required_permission"]] if rule["required_permission"] else []) missing = [p for p in required if not ctx.has_permission(p)] if missing: return error_response(error_code=ErrorCode.FORBIDDEN, message="...", details={"permissions": missing}, request_id=ctx.request_id) return match.handler(...)require_*保留为纵深防御,并补一个测试:遍历ROUTES,用 AST 断言每个 handler 体内存在与声明等价的 guard。
[P0-致命] workflow / node / image / job / history 五条链路无归属校验(IDOR)
-
位置:
backend/routes/workflow_routes.py:21-32、50-61、backend/routes/node_routes.py:81-92、backend/routes/job_routes.py:19-41、backend/routes/image_routes.py:22-52、backend/routes/history_routes.py:36-50 -
问题:profile 路由(
ProfileService.get_profile(profile_id, ctx)→_require_owner)和 round 路由(WorkflowRoundService._node_and_workflow(node_id, ctx)→ResourceAccessService.require_node)都做了归属校验;但 workflow / node / image / job / history 的 service 方法签名里根本没有 ctx,路由层也没有额外校验。 -
代码:
# backend/routes/workflow_routes.py:50-61 —— 只校验"已登录" def get_workflow(ctx, workflow_id, service=None) -> dict: workflow_service = service or _create_workflow_service() def action() -> dict[str, Any]: require_authenticated(ctx) return workflow_service.get_workflow(workflow_id).to_dict() # ← 无 ctx return handle_request(ctx, action) # backend/services/workflow_service.py:146-150 def list_workflows(self, profile_id: str) -> list[ProfileWorkflow]: # ← 无 ctx self._ensure_profile_exists(profile_id) # 只判存在,不判归属 return self.workflow_repository.list_workflows(profile_id) def get_workflow(self, workflow_id: str) -> WorkflowDetail: # ← 无 ctx workflow = self.workflow_repository.get_workflow(workflow_id) # backend/services/workflow_service.py:650-654 def get_node(self, node_id: str) -> WorkflowNode: # ← 无 ctx # backend/routes/job_routes.py:29-35 —— 列表参数里没有任何 owner 维度 result = queue_service.list_jobs( status=..., workflow_id=..., profile_id=..., page=..., page_size=... ).to_dict() # backend/routes/image_routes.py:34-40 —— 同样没有 owner 维度 result = image_service.list_images(profile_id=..., workflow_id=..., ...)对照做对了的那条链路:
# backend/services/workflow_round_service.py:1108-1114 node = ( self.resource_access_service.require_node(node_id, ctx) if ctx is not None else self.workflow_repository.get_node(node_id) ) -
影响:任意登录用户可枚举/读取/修改他人资源:
GET profiles/{他人profile_id}/workflows、GET workflows/{id}、PUT workflows/{id}、POST workflows/{id}/start|cancel|archive|execute-character(execute-character 直接花对方的模型额度出图);POST profiles/{他人profile_id}/workflows在他人档案下建工作流(create_workflow只调_ensure_profile_exists);GET nodes/{id}、PUT nodes/{id}、POST nodes/{id}/generate;GET jobs(无任何过滤,GenerationTask.to_dict()含request全量生成请求,即他人的完整提示词、参考图 URI、模型路由,见backend/dto/job_dto.py:38);GET images(无 owner 过滤,仅按metadata.quarantined过滤受限图)。
行为还自相矛盾:
GET nodes/{id}能读到他人节点,而GET nodes/{id}/rounds会正确 404——同一个节点两种答案。 -
修复建议:把已存在的
ResourceAccessService推广到这五条链路,而不是每处重造:WorkflowService.list_workflows/get_workflow/get_node/list_nodes增加ctx: RequestContext | None = None,非 None 时走ResourceAccessService.require_workflow/require_node;QueueService.list_jobs/ImageService.list_images增加owner_user_id过滤参数,路由层传ctx.actor_id(拥有can_manage_all_profiles时传None);HistoryService.list_workflow_history/save_workflow_snapshot前置require_workflow(workflow_id, ctx);- 补一个"越权矩阵"测试:用户 A 建资源,用户 B 对 169 条路由逐条请求,断言全部 404/403。
[P1-严重] 客户端自带 content_permissions / entrypoint,可绕过成人内容路由闸门
- 位置:
backend/services/generation_service.py:2366-2375、2352-2353、1497-1504;入口backend/routes/node_routes.py:132-146 - 问题:
POST nodes/{node_id}/generate的 payload 原样透传给GenerationService.generate_node,而路由裁决所依赖的"用户是否被允许成人内容"直接从请求体里取,从未与ctx校验。 - 代码:
# backend/services/generation_service.py:2366-2375 def _permission_context(payload: dict[str, Any]) -> dict[str, Any]: configured = payload.get("content_permissions") if isinstance(payload.get("content_permissions"), dict) else {} result = { **configured, "adult_user_allowed": bool(configured.get("adult_user_allowed", payload.get("adult_user_allowed", False))), "quota_allowed": bool(configured.get("quota_allowed", payload.get("quota_allowed", True))), } ... # backend/services/generation_service.py:2352-2353 def _entrypoint(payload: dict[str, Any]) -> str: value = _optional_text(payload.get("entrypoint") or payload.get("platform") or payload.get("source")) or "web" # backend/services/prompt_governance_service.py:262-267 —— 消费点 entry_allowed = bool((self.config.get("entrypoints") or {}).get(entrypoint, False)) user_allowed = bool(permissions.get("adult_user_allowed", False)) group_allowed = bool(permissions.get("adult_group_allowed", group_id is None)) quota_allowed = bool(permissions.get("quota_allowed", True)) if not all((enabled, entry_allowed, user_allowed, group_allowed, quota_allowed)): return self._decision(..., "adult_route_permission_denied", ...) - 影响:只要服务端
prompt_governance.routing.adult_auto_route_enabled为 true,任意登录用户 POST{"content_permissions": {"adult_user_allowed": true, "adult_group_allowed": true, "quota_allowed": true}, "entrypoint": "<配置里放行的任一入口>"}即可让adult_allowed级别的提示词自动路由到 nsfw_route,同时quota_allowed: true还能绕过配额判定。聊天侧是对的(chat_workflow_service.py:70/686/761由服务端_content_permissions(config, chat)生成),唯独 Web 路由这条缺失。 - 修复建议:在路由层剥离客户端提供的这两个字段,由服务端重建:
# node_routes.generate_node / round_routes 内 sanitized = {k: v for k, v in request_payload.items() if k not in {"content_permissions", "adult_user_allowed", "adult_group_allowed", "quota_allowed", "entrypoint", "platform", "source"}} sanitized["entrypoint"] = "web" sanitized["content_permissions"] = build_content_permissions(load_config_payload(), ctx)build_content_permissions复用chat_workflow_service._content_permissions的逻辑,按ctx.actor_id查配置白名单。
[P1-严重] 所有 service 在 require_* 之前构造:未授权即可触发重型初始化 + DB 写入,且构造期异常逃出 handle_request
- 位置:
backend/routes/node_routes.py:139-140、backend/routes/round_routes.py:28、137-162、backend/routes/node_routes.py:315-390、backend/routes/common.py:12-16 - 问题:每个 handler 的固定写法是"先在函数体里造 service,再把
require_*放进闭包action"。于是鉴权发生在最贵的操作之后。_create_generation_service()会:读load_config_payload()、建Database、调sync_generation_provider_from_config()(向数据库 upsert provider/route 行)、构造 provider runtime 与多个 governance service。 - 代码:
而# backend/routes/node_routes.py:132-146 def generate_node(ctx, node_id, payload=None, service=None, generation_service=None) -> dict: workflow_service = service or _create_workflow_service() resolved_generation_service = generation_service or (None if service else _create_generation_service()) # ← 鉴权之前 request_payload = payload or {} def action() -> dict[str, Any]: require_write(ctx) # ← 鉴权在这里,已经太晚 # backend/routes/round_routes.py:21-33 —— 一个只读接口也走全量 provider 初始化 def list_node_rounds(ctx, node_id, query=None, service=None, media_service=None) -> dict: round_service = service or _create_round_service() # → create_generation_service() → sync_..._from_config() ... def action(): require_authenticated(ctx) # backend/routes/node_routes.py:327-328 config_payload = load_config_payload() sync_generation_provider_from_config(model_provider_service, config_payload) # 写库handle_request的 try 只包住callback:# backend/routes/common.py:12-16 def handle_request(ctx, callback): try: return success_response(callback(), request_id=ctx.request_id) except Exception as exc: return response_from_exception(exc, request_id=ctx.request_id) - 影响:
- 未授权资源消耗:未登录/无权限用户狂刷
GET nodes/x/rounds或POST nodes/x/generate,每次请求都触发一轮配置解析 + provider 表写入,SQLite 写锁争用(db_helper.py:166timeout=30s)会拖垮整个插件; - 500 泄漏:service 构造发生在 try 之外,配置损坏/数据库锁死/provider 参数非法时异常直接穿透
dispatch_extension_request(该函数也无 try)→dispatch_bridge_request→ AstrBot Quart,返回带 traceback 的 500,而不是规范的{"ok": false, ...}; - 只读接口产生写副作用,违反 HTTP 语义。
- 未授权资源消耗:未登录/无权限用户狂刷
- 修复建议:
- 把 service 构造挪进
action闭包(最小改动,一行位置调整 × 157 处,可脚本化); - 或按下面 P2「样板代码」条目引入
@route(permission=...)装饰器,由装饰器统一"先鉴权 → 再懒构造 service → 再统一异常包装"; sync_generation_provider_from_config从请求路径移出,改为启动时执行一次 + 配置变更事件触发(initialize_runtime_database已经调过一次);dispatch_extension_request外层加兜底 try,任何逃逸异常也转成UNKNOWN_ERROR响应。
- 把 service 构造挪进
[P1-严重] POST profiles/{profile_id}/archive 实际执行的是删除
- 位置:
backend/routes/profile_routes.py:109-114,注册于backend/route_registry.py:69 - 问题:
archive_profile直接把调用转给delete_profile,语义与端点名、与前端profileArchive按钮的用户预期完全不符。 - 代码:
对照 workflow 侧是真归档(# backend/routes/profile_routes.py:101-114 def delete_profile_via_post(ctx, profile_id, payload=None, service=None) -> dict: return delete_profile(ctx, profile_id, service) def archive_profile(ctx, profile_id, service=None) -> dict: return delete_profile(ctx, profile_id, service) # ← "归档" == "删除"workflow_routes.py:106-111→_set_workflow_status(..., "archived", ...))。 - 影响:前端
profileArchive(frontend/shared/api/endpoints.ts:11)标注为"归档",用户点击后档案被repository.soft_delete()置为status="deleted",随后get_profile会对status == "deleted"抛 404 —— 该档案及其下所有工作流从 UI 彻底消失且无归档列表可恢复。归档与删除是两种不同的用户意图,被合并成一种破坏性操作。 - 修复建议:
并确认def archive_profile(ctx, profile_id, service=None) -> dict: profile_service = service or _create_profile_service() def action() -> dict: require_write(ctx) return profile_service.update_profile(profile_id, {"status": "archived"}, ctx).to_dict() return handle_request(ctx, action)ProfileService.get_profile/ProfileRepository.list对archived状态可查(list_profiles已支持status参数)。
[P2-中等] 所有错误一律 HTTP 200,UNAUTHORIZED/FORBIDDEN/NOT_FOUND 无法被 HTTP 层识别
- 位置:
backend/dto/common.py:58-72、main.py:2439-2452 - 问题:
error_response()返回普通 dict,_to_bridge_response()也只是把它包成{"status": "error", ...},全程没有任何 HTTP 状态码映射。 - 代码:
# main.py:2439-2452 def _to_bridge_response(response: dict[str, Any]) -> dict[str, Any]: if response.get("ok"): return {"status": "ok", "message": "", "data": response.get("data"), "request_id": response.get("request_id")} return {"status": "error", "message": str(response.get("message") or "request failed"), "data": response, "request_id": response.get("request_id")} # ← 无论 UNAUTHORIZED / FORBIDDEN / RESOURCE_NOT_FOUND / UNKNOWN_ERROR,AstrBot 都按 200 返回 - 影响:AstrBot 侧的访问日志、反向代理限流、监控告警、浏览器 devtools 全部看到 200,权限拒绝与服务器内部错误在 HTTP 层不可观测;前端
client.ts:96里的!response.ok分支在桥接模式下永远不触发,只能靠 body 判定。安全审计("谁被拒绝了多少次")无法从访问日志得出。 - 修复建议:给
ErrorCode建立状态码映射表并在_to_bridge_response/_to_media_http_response层构造带状态码的响应:
桥接返回ERROR_STATUS = {ErrorCode.UNAUTHORIZED: 401, ErrorCode.FORBIDDEN: 403, ErrorCode.RESOURCE_NOT_FOUND: 404, ErrorCode.VALIDATION_FAILED: 422, ErrorCode.UPLOAD_TOO_LARGE: 413, ErrorCode.UNKNOWN_ERROR: 500}Response(json.dumps(body), status=ERROR_STATUS.get(code, 200), content_type="application/json");前端unwrapApiResponse已能同时处理两种包装,改动是向后兼容的。
[P2-中等] handle_request 吞掉全部异常且不写日志,未知错误无从定位
- 位置:
backend/routes/common.py:12-16、backend/dto/common.py:75-83 - 问题:任何非
ApiError异常都被转成UNKNOWN_ERROR / "服务器内部错误",details只留一个异常类名,既不 logging 也不保留 traceback。157 个 handler 全部走这一条路径。 - 代码:
# backend/dto/common.py:75-83 def response_from_exception(exc: Exception, request_id: str | None = None) -> dict[str, Any]: if isinstance(exc, ApiError): return exc.to_response(request_id=request_id) return error_response( error_code=ErrorCode.UNKNOWN_ERROR, message="服务器内部错误", details={"exception": exc.__class__.__name__}, # ← 只有类名 request_id=request_id, ) - 影响:生产环境出现
KeyError/sqlite3.OperationalError时,运维只能看到"服务器内部错误 + KeyError",没有文件行号、没有 request_id 关联的堆栈,排障必须靠复现。项目自带LogService(logs/errors端点)却没有被这条路径喂数据。 - 修复建议:
同时把未捕获异常落一条import logging logger = logging.getLogger("imagestudio.routes") def handle_request(ctx, callback): try: return success_response(callback(), request_id=ctx.request_id) except ApiError as exc: logger.info("api_error request_id=%s code=%s", ctx.request_id, exc.error_code) return exc.to_response(request_id=ctx.request_id) except Exception as exc: logger.exception("unhandled route error request_id=%s actor=%s", ctx.request_id, ctx.actor_id) return response_from_exception(exc, request_id=ctx.request_id)LogService错误日志,让GET logs/errors真正有内容。
[P2-中等] 分页之后再过滤,total 与页大小失真
- 位置:
backend/routes/job_routes.py:36-38、backend/routes/image_routes.py:45-49 - 问题:service 已按
page/page_size从数据库分页取回,路由层再对当前页做可见性过滤,然后用当前页的隐藏数去修正全局 total。 - 代码:
# backend/routes/job_routes.py:36-38 if not ctx.has_permission("can_manage_materials"): visible = [item for item in result["items"] if item.get("metadata", {}).get("source") != "advanced_material"] result = {**result, "items": visible, "total": max(int(result.get("total") or 0) - (len(result["items"]) - len(visible)), 0)} # backend/routes/image_routes.py:45-49 visible = [item for item in payload["items"] if not _is_restricted_image(item)] payload["restricted_hidden"] = len(payload["items"]) - len(visible) payload["items"] = visible payload["total"] = max(len(visible), int(payload.get("total") or 0) - payload["restricted_hidden"]) - 影响:
total是全表计数(JobListResult.total来自repository.list()的第二个返回值),减去的却只是当前页被隐藏的条数 → 分页器页数算错;每页实际条数少于page_size且各页不等长;极端情况下某一页全是受限项,前端会显示空页却还有下一页。用户看到"共 87 条"但翻完只有 40 条。 - 修复建议:把可见性下推到仓储层的 WHERE 条件:
JobRepository.list(..., exclude_sources=("advanced_material",));ImageRepository.list_images(..., include_restricted: bool),SQL 里过滤metadata->>'quarantined'/gallery_visibility。 这样total与分页天然一致,路由层只剩权限判定,不再做数据裁剪。
[P2-中等] ProfileService._require_owner 不认管理员权限,与 ResourceAccessService._can_access 语义相反
- 位置:
backend/services/profile_service.py:160-169vsbackend/services/resource_access_service.py:80-84 - 问题:同一套归属判定,两处实现规则不同——一处认
can_manage_all_profiles/*,另一处只认actor_id相等。 - 代码:
# backend/services/profile_service.py:160-169 def _require_owner(self, profile: CharacterProfile, ctx: RequestContext) -> None: if ctx.actor_id and ctx.actor_id == profile.owner_user_id: return raise ApiError(ErrorCode.RESOURCE_NOT_FOUND, "角色档案不存在", {"profile_id": profile.profile_id}) # backend/services/resource_access_service.py:80-84 @staticmethod def _can_access(owner_user_id: str | None, ctx: RequestContext) -> bool: if ctx.has_permission("can_manage_all_profiles") or ctx.has_permission("*"): return True return bool(ctx.actor_id and owner_user_id and ctx.actor_id == owner_user_id) - 影响:即使按 P0-1 的建议把
can_manage_all_profiles正确授予管理员,GET profiles/{id}/PUT profiles/{id}/DELETE profiles/{id}依然会对管理员 404,而GET nodes/{id}/rounds却放行——管理能力在两条链路上表现相反,运维无法完成跨用户支持工单。连RequestContext.system()(permissions={"*"})在 profile 路径上也会被拒。 - 修复建议:删掉
_require_owner,ProfileService改为注入/复用ResourceAccessService._can_access同一份判定(或把该静态方法提到core/security.py作为唯一实现can_access_owner(owner_user_id, ctx)),两处共用。
[P2-中等] 157 个 handler 是同构样板 + 22 个各自为政的 service 工厂 + 30 处 Database(load_database_settings())
- 位置:
backend/routes/全目录;典型对照backend/routes/settings_routes.py:16-164、backend/routes/data_backup_routes.py:9-28、backend/routes/wardrobe_routes.py:89-106 - 问题:每个 handler 都是同一个五行骨架(
service = service or _create_X()→def action(): require_*(ctx); return svc.foo(...)→return handle_request(ctx, action));每个路由模块自己写一份_create_*_service(),每份都Database(load_database_settings())+AuditService(database)+ 一堆 repository 手工装配。统计:return handle_request157 处,Database(load_database_settings())30 处,_create_*_service工厂 22 个。node_routes._create_workflow_service、workflow_routes._create_workflow_service、history_routes里的同名装配是逐字重复的三份代码。 - 代码:
# backend/routes/settings_routes.py:42-53 与 56-67 与 70-81 …… 仅函数名和一行调用不同 def validate_settings(ctx, payload, service=None) -> dict: settings_service = service or SettingsService() def action() -> dict[str, Any]: require_config_manager(ctx) return settings_service.validate(payload) return handle_request(ctx, action) # backend/routes/data_backup_routes.py:9-11 —— 为了压行改用元组副作用,可读性极差 def list_backups(ctx:RequestContext,service:DataBackupService|None=None)->dict: instance=service or DataBackupService() return handle_request(ctx,lambda:(require_config_manager(ctx),instance.list_backups())[1]) # backend/routes/wardrobe_routes.py:94-96 —— 同样的元组 hack return handle_request(ctx, lambda: (require_permission(ctx, "can_manage_materials"), wardrobe_service.save_template(profile_id, payload, ctx))[1]) - 影响:新增路由的成本与出错面都被放大——P0-2 的越权、P1 的"构造在鉴权前"正是因为骨架靠复制粘贴而非统一封装才会成片出现;改一处横切逻辑(日志、审计、限流、状态码)要动 157 个地方。三份重复的
WorkflowService装配意味着任何依赖变更要改三处,漏一处就是运行时 TypeError。(guard, call())[1]的写法把"鉴权"伪装成表达式的一部分,静态检查与人眼 review 都极易漏看。 - 修复建议:
- 引入统一装饰器,把"鉴权 → 懒构造 service → 异常包装"收敛到一处:
handler 退化成一行业务调用,# backend/routes/common.py def route(permission: str, factory: Callable[[], Any] | None = None): def decorator(fn): @functools.wraps(fn) def wrapper(ctx, *args, service=None, **kwargs): def action(): enforce(ctx, permission) # 复用 route_registry.permission_requirement svc = service or (factory() if factory else None) return fn(ctx, *args, service=svc, **kwargs) return handle_request(ctx, action) return wrapper return decoratorpermission参数与RouteSpec.permission可用测试断言强制一致(顺带闭合 P0-2)。 - 建
backend/routes/container.py,提供get_workflow_service()/get_image_service()/get_queue_service()等进程级单例或按 request 缓存的工厂,删掉 22 份重复装配与 30 处Database(load_database_settings())。 - 用普通
def action()替换data_backup_routes.py/wardrobe_routes.py里的(guard, call())[1]元组写法。
- 引入统一装饰器,把"鉴权 → 懒构造 service → 异常包装"收敛到一处:
[P3-轻微] public_token 权限档与实际暴露面不符,且 media/fetch 绕过分发器不留审计
- 位置:
backend/route_registry.py:28、173,main.py:329-332、main.py:1753-1758 - 问题:矩阵里
public_token声明auth_required: False,但真正的注册路径是通配符桥接(/{PLUGIN_NAME}/<path:endpoint>,不携带权限元数据),media/fetch与其余 168 条路由共用 AstrBot 的同一层鉴权——项目自己在media_routes.py:56-63的注释里也承认/api/plug请求需要登录态。同时该端点在dispatch_bridge_request里被提前拦截,完全不经过dispatch_extension_request。 - 代码:
# main.py:329-332 if dispatch_method == "GET" and normalize_extension_path(dispatch_endpoint) == "media/fetch": file_response = await _to_media_file_response(dispatch_query) if file_response is not None: return file_response # ← 不经过路由解析、不经过 handle_request、无审计 # main.py:1753-1758 —— 通配符注册,permission 字段在这条路径上不存在 def _bridge_registration_routes() -> list[dict[str, str]]: path = f"/{PLUGIN_NAME}/<path:endpoint>" return [{"method": method, "path": path, "endpoint": ""} for method in sorted({r.method for r in ROUTES})] - 影响:矩阵读起来像"这里有一个免鉴权端点",实际不是,误导后续维护者对暴露面的判断;反过来若哪天 AstrBot 放开
/api/plug的鉴权,这条提前返回路径会真的变成公开文件读取(token 由MediaProxyHMAC 签名 + 300s TTL 保护,core/media_proxy.py:24的进程随机密钥算是兜住了,但重启后旧 token 全失效也意味着签名 URL 不能持久化分发)。另外该路径不产生任何访问记录。 - 修复建议:把
public_token的描述改为"签名 token + 宿主鉴权",或在_to_media_file_response前补一次ctx.is_authenticated判定使其与声明一致;同时在提前返回前记一条LogService媒体访问日志(含 request_id、actor、uri)。
[P3-轻微] node_routes._bool 与 params.as_bool 重复,images/{id}/moderation-review 无前端调用方
- 位置:
backend/routes/node_routes.py:399-402vsbackend/routes/params.py:60-82;backend/route_registry.py:135vsfrontend/shared/api/endpoints.ts - 问题:
node_routes自带一份布尔转换,与公共params.as_bool(value, non_string_truthiness=True)语义完全等价却各写一遍;POST images/{image_id}/moderation-review(materials权限)在endpoints.ts全表里没有对应条目,前端无任何调用方。
- 代码:
# backend/routes/node_routes.py:399-402 def _bool(value: Any) -> bool: if isinstance(value, str): return value.strip().lower() in {"1", "true", "yes", "on"} return bool(value) # backend/routes/params.py:74-82 —— 已有等价实现 def as_bool(value, *, default=False, non_string_truthiness=False) -> bool: ... - 影响:两份布尔语义未来会漂移(例如公共版本新增
"y"token 而 node_routes 版本不跟);受限图片复核能力做了后端却在 UI 上不可达,_is_restricted_image隔离的图片实际上没有人工放行入口。 - 修复建议:
node_routes.get_node_dependency_context改用as_bool(params.get("include_draft"), non_string_truthiness=True)并删除_bool;确认moderation-review是否应在图库详情里补一个"管理员复核"操作,否则从ROUTES移除以缩小暴露面。