Sentinel：55秒對映任意程式碼庫，無需雲服務，零依賴

For developers who want AI to understand their codebase — without uploading to the cloud, Sentinel 提供了一種全新解決方案。這是一款本地、零依賴的程式碼庫掃描器，能夠將任何倉庫轉化為結構化的、token高效的智慧資訊，供AI編碼代理（如Claude Code、Cline、Codex等）使用。

核心功能

Sentinel 的核心在於其極致的速度和簡潔性。它利用Python標準庫，無需任何額外依賴，即可在55秒內完成對25,000個檔案的掃描（如Kubernetes倉庫）。掃描後，它會生成一系列關鍵輸出：

• 健康評分：從可維護性、執行時複雜度、測試訊號、安全性等維度綜合評估，並附詳細分解。
• 熱點與風險：識別超大型檔案、TODO密度、文件漂移等問題，並給出可操作建議。
• 入口點檢測：智慧識別執行時入口點（如Go二進位制檔案），並給予額外權重。
• 代理提示：生成可直接複製貼上的提示詞，用於Cline、Claude Code等工具。
• 上下文包：緊湊的專案簡介，約2500 token，取代數小時的檔案閱讀。

效能表現

Sentinel 的掃描速度令人印象深刻：

• Python庫（234檔案，42K行）：0.16秒，健康評分86%。
• FastAPI框架（約1000檔案，約200K行）：4.56秒，健康評分74%。
• Kubernetes倉庫（25432檔案，6,007,991行）：55秒，健康評分74%。
• Ladybird瀏覽器引擎（約40K檔案，約1.4M行）：約40秒。

所有掃描完全在本地進行，無雲服務參與。

安裝與使用

安裝極為簡單：pip install git+https://github.com/Ntooxx/Sentinel.git。Windows使用者可雙擊install.ps1。安裝後，project-sentinel命令即可全域性使用。

常用命令包括：

• scan：分析專案結構、風險、熱點。
• dashboard：啟動瀏覽器GUI，提供視覺化操作介面。
• report：生成Markdown或HTML報告。
• prompt：生成面向AI代理的下一步提示詞。
• ask：用自然語言詢問專案相關問題。

技術亮點

Sentinel 在專案名稱解析、目的推斷等方面展現了精巧的設計。它採用五級回退機制解析專案名稱，避免將“Sponsors”等無關詞誤認為專案名。目的推斷同樣使用六級回退鏈，確保返回有意義的結果。此外，它還具備文本安全過濾功能，自動移除HTML標籤、Markdown連結等噪聲資訊。

開發者生態

Sentinel 包含197個測試，全部透過，測試執行時間僅9.3秒。它易於擴充套件，歡迎貢獻。專案遵循開源協議，提供了詳細的貢獻指南和行為準則。

總之，Sentinel 為AI代理理解程式碼庫提供了一種高效、安全、本地化的解決方案，特別適合關注隱私和Token消耗的開發者。