sentrux 使用教程
从入门到精通的完整指南
sentrux 简介
sentrux是一个用纯Rust编写的代码质量传感器，专为AI编码Agent设计，帮助AI生成的代码保持架构质量。它通过5个图论维度（模块性、无环性、深度、均衡性、冗余度）计算一个综合质量分数，采用几何均值算法确保不可被博弈。支持52种编程语言，提供实时架构可视化、质量门禁、规则引擎、会话差异对比等功能。支持MCP协议集成，可直接被Claude Code、Cursor等AI编码工具调用，形成传感器-信号-控制器-执行器的反馈闭环。
详细功能介绍
【工具简介】sentrux是一个纯Rust编写的代码架构质量传感器，通过5个图论指标为AI编码Agent提供实时质量反馈。
【核心功能】
① 五维质量评分：基于模块性、无环性、深度、均衡性、冗余度5个图论维度计算综合质量分数，采用几何均值算法不可博弈
② 实时架构可视化：生成代码库的实时树状图，展示文件依赖关系，文件变更时自动高亮
③ 质量门禁：通过sentrux check命令在CI/CD中设置质量门槛，阻止质量下降的代码合并
④ MCP协议集成：支持Claude Code、Cursor、Windsurf等MCP客户端直接调用，AI Agent可自动感知代码质量变化
⑤ 52种语言支持：基于Tree-sitter插件架构，无需语言特定代码即可解析52种编程语言
【适用场景】
【快速入门】
【优缺点分析】
优点：
缺点：
【适合人群】
1Sentrux入门教程：AI代码质量传感器
入门10分钟
一、工具简介
Sentrux是纯Rust编写的代码质量传感器，专为AI编码Agent设计，通过5个图论维度评估代码架构质量，支持52种语言和MCP协议集成。
二、快速开始
①访问Sentrux的GitHub仓库，查看安装说明
②根据系统环境下载对应二进制文件或通过包管理器安装
③在项目根目录运行sentrux init初始化配置文件
三、核心功能演示
①质量评分：在项目目录执行sentrux analyze命令，工具从模块性、无环性、深度、均衡性、冗余度五个维度扫描代码结构，输出综合质量分数。分数采用几何均值算法，确保各维度均衡发展才能获得高分。
②实时可视化：运行sentrux viz启动可视化服务，浏览器打开后可看到项目的模块依赖图、层级结构和质量热力图，直观发现架构问题区域。
③MCP集成：在Claude Code或Cursor的配置文件中添加Sentrux的MCP服务地址，AI编码工具即可在生成代码时实时调用Sentrux评估质量，自动避免产生架构劣化的代码。
四、实际使用案例
场景一：团队使用AI Agent批量重构遗留代码，接入Sentrux后设置质量门禁，要求每次提交的质量分数不得低于基线。运行两周后，模块耦合度降低40%，代码可维护性显著提升。
场景二：独立开发者在Claude Code中集成Sentrux，每次AI生成代码时自动评分。发现AI倾向于创建过深的嵌套结构，调整提示词后代码质量分数从65分提升到88分。
五、常见问题FAQ
为什么用几何均值而不是算术平均？
几何均值对短板更敏感，一个维度极差会大幅拉低总分，防止通过刷高某个维度来掩盖问题，确保架构均衡发展。
支持哪些编程语言？
支持52种语言，包括Python、JavaScript、TypeScript、Java、Go、Rust、C++等主流语言，完整列表见官方文档。
评分标准会变化吗？
核心算法稳定，团队可根据项目需求在配置文件中自定义各维度权重。
六、小贴士
- 建议在CI流程中加入sentrux check命令，自动拦截质量下降的代码
- 首次分析后记录基线分数，后续对比可量化改进效果
- 搭配规则引擎使用，可针对特定维度设置强制约束