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消耗的开发者。