sentrux

sentrux 是一个纯 Rust 的架构传感器，实时观察你的代码库，把结构健康度合成为一个 0-10000 的质量分。它出现在「为你推荐」信息流里，被形容为一张「活地图」，在 AI 智能体不断改代码时避免项目结构崩坏：它先扫描文件与依赖链，把五个底层指标揉成一个综合评分，再通过 MCP 把信号喂给智能体。它的主张很简单，智能体以机器速度写代码，没有传感器，代码库就会以机器速度腐坏。

核心功能

• 一个评分、五个根因：模块度、无环性、深度、均衡性与冗余，用几何平均合成——作者称这很难被「刷分」。
• 实时树状图：sentrux 打开一个 GUI，随智能体写代码实时更新，而不是看 diff 或终端输出。
• MCP 集成：九个 MCP 工具让 Claude Code、Cursor、Codex 或 OpenCode 查询评分并依据退化做门禁。
• 规则引擎：.sentrux/rules.toml 编码分层、边界与约束，把架构意图变成机器可读的等级。
• 会话门禁：会话前 sentrux gate --save、会话后 sentrux gate，逐次捕捉退化。
• CI 友好：sentrux check . 以 0 或 1 退出，可在 CI 里拦截坏合并。
• 52 种语言：语言知识全部放在 plugin.toml 加 tags.scm 查询文件里，新增语言完全不需要写 Rust。

适用场景

谁应该使用？

• 带长期 Claude Code / Codex 会话的团队负责人：一周智能体协作后失去了对代码库的信任。
• 平台工程师：希望在 CI 里加一个关于「结构」而非仅仅「测试」的质量门禁。
• 重构规划者：动手前先看清耦合、循环依赖与上帝文件。
• 拥抱 vibe coding 但仍想要逃生通道的人：在架构变得不可读之前能及时收手。

解决的问题

1. 没有反馈回路的语境腐坏：智能体不知道代码何时不再贴合系统，因此无法自我修正。
2. 以规格为先的工作流：产出一堆 markdown，却对实际交付的代码毫无可见性。
3. 测试套件只抓行为不抓架构：此前没有工具能就「这次改动是否符合成长的系统」闭合回路。

定价方案

sentrux 免费且开源，MIT 许可证，没有付费档，只需支付自己的算力。

优势对比

1. 纯 Rust、单文件：无运行时依赖，放进仓库或容器都轻松。
2. 天生语言无关：语言逻辑全部数据驱动，扩展不等于改编译器。
3. 与语境腐坏工具不同：sentrux 给智能体一个关于代码库健康度的外部真相源，而非去管理上下文窗口。

用户评价

"区别在于：智能体以前是猜代码为什么不对劲，现在有一个明确目标——把你的冗余分降到 1000 以下。这种直接性省了 token，也让自我改进落到实处。" — 独立承包商，社区评测转述

"0-10000 评分设计上很难刷分。它能否经受住对抗性推高，才是值得观察的点。" — MCP 汇总中的从业者注记

快速开始

1. 安装：brew install sentrux/tap/sentrux（macOS）、curl 安装脚本（Linux）、发行版二进制（Windows）。
2. 打开 GUI：sentrux 或 sentrux /path/to/project。
3. 建立基线：智能体会话前 sentrux gate --save .。
4. 会话后对比：sentrux gate .，或在 CI 里用 sentrux check . 做门禁。
5. 接入智能体：把 MCP 客户端指向 sentrux 服务，让智能体看到实时评分。

一手资料：sentrux.dev、sentrux GitHub 仓库、其 MCP 集成文档。

常见问题

sentrux 会跑测试或检查功能吗？

不会。它通过静态分析测量结构（依赖、文件组织、架构）。正确性仍靠测试套件，所以两者要一起用。

不用 AI 智能体也能用吗？

可以。跑 sentrux 可视化、CI 里 sentrux check 执行规则、sentrux gate 追踪质量随时间变化。

52 种语言意味着什么？

语言能力来自 tree-sitter 中 plugin.toml 引用的插件。二进制本身是通用的，所以加语言无需 Rust 代码。

评分由什么驱动？

五个指标用几何平均合成，单一指标被刻意抬高不太可能带起整体结果。

替代方案

• LangGraph：编排智能体工作流逻辑，与代码结构感知处在不同层。
• CrewAI：搭建多智能体团队，不用于度量代码库。
• OpenCode：一个智能体 CLI，sentrux 可以向它回传结构反馈。

使用技巧

1. 先设基线：会话前 gate --save 才让会话后的 gate 有意义。
2. 为你自己的栈写规则：默认约束可能过松或过紧；规则引擎才是架构意图该待的地方。
3. 别跳过功能测试：sentrux 只看结构，务必搭配真实测试套件。

总结

sentrux 是给机器速度编码装上机器速度调速器的传感器。它不替代规划或测试，而是补上这两者都无法覆盖的空隙。如果你的代码库正被智能体逐日重塑，一个评分加一个 MCP 钩子，是低成本阻止它滑向「必须重写」的办法。