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