Revos：AI生成代码的架构检查工具

Revos 是一款面向 AI 辅助软件开发的开源架构治理工具，旨在解决现代团队在使用 AI 编码工具时面临的架构漂移问题。它通过扫描代码库、构建依赖图、检测架构违规，并提供解释和修复建议，帮助开发者在高速生成代码的同时保持项目的架构质量。

Revos 的核心理念是：代码可以编译通过，测试可以全部通过，但项目的架构可能在不知不觉中恶化。常见的问题包括 UI 组件直接导入数据库客户端、领域代码依赖框架、控制器直接访问数据库、客户端代码导入服务端模块、循环依赖等。Revos 旨在尽早捕获这些问题。

Revos 的使用非常简单，可以通过 npx 直接运行：npx @revoscli/cli scan https://github.com/fastapi/fastapi --report all，也可以全局安装后使用。它支持扫描本地项目、公共 GitHub 仓库以及子目录。项目初始化时可以选择预设配置，包括 clean-architecture、nextjs、nestjs、laravel、fastapi 等，或使用 --auto 自动检测。

Revos 当前支持 TypeScript（含 TSX、React、Next.js、NestJS、Express）、Laravel/PHP 以及 Python（含 FastAPI、Django、Flask）等语言和框架。它能够检测循环依赖、非法导入等问题，并生成 Markdown 或 JSON 格式的报告。在 CI 中，可以设置 --fail-on high 使流水线在发现高严重性问题时失败。

需要注意的是，Revos 目前处于早期 Alpha 阶段，定位为“AI 时代的架构护栏”，而不是成熟静态分析工具的替代品。它适用于检测常见的架构漂移、保持框架边界清晰、让 CI 在严重架构问题上失败、帮助团队审查 AI 生成的代码，并清晰解释架构问题。

Revos 的路线图包括支持 SARIF 输出以集成 GitHub Code Scanning、更好的单体仓库可视化、改进误报过滤、更多框架预设、HTML 报告以及更多真实世界的仓库基准测试。项目采用 MIT 许可证，可在 GitHub 上获取。