用途:审计 ComfyUI 前端代码中违反分层架构导入规则的地方。它使用 ESLint 的 import-x/no-restricted-paths 规则,发现跨层引用,帮助在提交 PR、迁移文件或重构前确认层级边界。
层级规则(自底向上):base → platform → workbench → renderer。每层只能导入其下方层级,renderer 可导入所有下层,base 不能导入任何上层。
运行方式:
- 快速查看违规: pnpm lint 2>&1 | grep 'import-x/no-restricted-paths' -B1 | head -200
- 收集 base/、platform/、workbench/ 的完整结构化报告: pnpm eslint src/base/ src/platform/ src/workbench/ --no-error-on-unmatched-pattern --rule '{"import-x/no-restricted-paths": "warn"}' --format compact 2>&1 | grep 'no-restricted-paths' | sort
结果解读:每个违规行显示包含错误导入的文件、越界的导入路径,以及指出违规层级对的消息。可按 base→platform、base→workbench、base→renderer、platform→workbench、platform→renderer、workbench→renderer 分组。
适用场景:新增跨层导入的 PR 前检查;审计并规划既有违规的迁移;层级间移动文件后确认未引入新违规。
修复策略:将导入目标下移;在下层定义接口并通过依赖注入或注册模式在上层实现;将导入文件上移;提取共享逻辑到 base/ 或共享工具。
限制:资料未提供其自动化程度、集成方式、性能数据或收费信息,仅说明基于现有 ESLint 规则运行与人工分组修复。