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消耗的開發者。