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 上獲取。