5分钟装好sentrux:一条命令打开你的代码实时架构Treemap(macOS/Linux/Windows完整指南)
【免费下载链接】sentruxReal-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improvement of code quality. Pure Rust.项目地址: https://gitcode.com/gh_mirrors/se/sentrux
sentrux 是一款纯 Rust 实现的代码实时架构传感器,一条命令即可打开你项目的实时架构 Treemap:每个文件是一块砖,每条依赖是一条线,AI Agent 一边写代码,地图一边更新,质量分数实时跳动。它支持 macOS、Linux、Windows 三大平台、52 种编程语言,无需安装任何运行时依赖——5 分钟后,你就能亲眼看见自己代码库的"健康分"。
什么是 sentrux:给 AI 编程装上的"架构传感器"
你可能已经习惯了用 Claude Code、Cursor 等 AI Agent 写代码:一个会话改几十个文件,你只看到终端里滚动的Modified src/foo.rs——但那个文件在依赖图里的位置变了没有?它刚制造了一个循环依赖,你根本看不见。
sentrux 要解决的正是这个"失控"问题:
| 能力 | 说明 |
|---|---|
| 可视化 | 实时 Treemap + 依赖连线,文件被修改时会"发光"提示 |
| 度量 | 5 个根因指标(模块化、无环性、深度、均衡度、冗余度),输出 0–10000 的连续质量分 |
| 治理 | 规则引擎 + 质量门禁(gate),拦截架构退化 |
用一句话说:sentrux 是传感器,你的规则是标准,AI Agent 是执行器——反馈回路就此闭合。设计文档见 docs/quality-signal-design.md,架构理念可参考 docs/pro-architecture.md。
sentrux 安装前准备:确认你的系统环境
sentrux 是单一二进制文件,安装前只需确认操作系统与架构:
| 平台 | 支持情况 |
|---|---|
| macOS (Apple Silicon) | ✅ Homebrew 一键安装 |
| Linux (x86_64 / aarch64) | ✅ curl 脚本一键安装 |
| Windows (x86_64) | ✅ 下载sentrux.exe即用 |
| macOS (Intel x86_64) | ⚠️ 暂无预编译包,需源码构建 |
脚本会自动检测 OS 与 CPU 架构并下载对应产物,逻辑可参考 install.sh。
macOS 安装 sentrux:Homebrew 一条命令
打开终端,执行:
brew install sentrux/tap/sentrux完成后验证:
sentrux --versionLinux 安装 sentrux:curl 脚本一键装
curl -fsSL https://raw.githubusercontent.com/sentrux/sentrux/main/install.sh | sh脚本会自动找到最新版本,下载对应二进制并安装到/usr/local/bin(无写权限时会自动请求sudo)。整个过程通常不到 1 分钟。
Windows 安装 sentrux:下载单文件即开即用
在 PowerShell 中执行:
curl -L -o sentrux.exe https://github.com/sentrux/sentrux/releases/latest/download/sentrux-windows-x86_64.exe也可以直接到项目 Releases 页面下载 Windows 版本。把sentrux.exe放到任意目录,双击或命令行运行即可——不需要安装 .NET、Node 或其他任何运行时。
首次运行:打开你的第一个实时架构 Treemap
进入任意一个项目目录:
sentrux # 打开当前目录的 GUI sentrux /path/to/project # 或指定任意项目路径界面打开的瞬间,你会看到三样东西(如上图):
- 左侧:Core / Architecture / Test 三组质量等级(A–F 制),cycles、coupling、cohesion 等 14 个维度一目了然;
- 中间:按大小铺满画面的实时 Treemap,每个色块是一个文件,依赖关系用连线绘制;
- 右侧:Activity 面板,实时滚动 Agent 或你正在修改的文件。
下面是 AI Agent 构建项目时的实况演示——注意看 Treemap 如何随代码生成而"生长",顶部质量分实时变化:
进阶玩法:5 个常用命令让 sentrux 融入工作流
| 命令 | 作用 |
|---|---|
sentrux | 打开 GUI,实时 Treemap |
sentrux check . | 检查架构规则(CI 友好,退出码 0/1) |
sentrux gate --save . | Agent 会话前保存质量基线 |
sentrux gate . | 会话结束后对比,拦截架构退化 |
sentrux --mcp | 以 MCP 服务器模式运行,供 AI Agent 调用 |
让 AI Agent 实时"看见"架构——把下面配置加入 Cursor / Windsurf / OpenCode 等任意 MCP 客户端:
{ "mcpServers": { "sentrux": { "command": "sentrux", "args": ["--mcp"] } } }配置完成后,Agent 就能在会话开始时保存基线、结束时对比质量分,退化一目了然。Claude Code 用户可直接安装官方插件(定义见 claude-plugin/skills/scan/SKILL.md)。
常见问题排查:sentrux 装不上或打不开怎么办
1. Linux 下 GUI 启动失败(GPU 问题)sentrux 会自动尝试多个图形后端(Vulkan → GL → 回退)。若仍无法启动,可手动指定:
WGPU_BACKEND=vulkan sentrux # 强制 Vulkan WGPU_BACKEND=gl sentrux # 强制 OpenGL2. 升级到最新版本
brew update && brew upgrade sentrux # macOS # Linux:重新执行上面的 curl 安装脚本即可,它总是拉取最新版3. 想尝鲜?从源码构建(需 Rust 工具链)
git clone https://gitcode.com/gh_mirrors/se/sentrux cd sentrux && cargo build --release写在最后:5 分钟之后,你的代码有了"仪表盘"
从执行第一条命令到看见自己的实时架构 Treemap,整个过程不超过 5 分钟。sentrux 的价值不在于"装好",而在于之后每一次 AI 会话中你都能回答那个问题——"这一轮改动,我的架构是变好了还是变坏了?"
- 完整功能与多语言支持说明:README.md(另有 中文、日文、德文版本)
- 语言插件机制:plugins/(每个语言 = 一个
plugin.toml+tags.scm,零 Rust 代码即可扩展) - 核心实现:sentrux-core/src/analysis/(解析器、依赖图、插件加载器)
装上它,让"代码质量"第一次变得看得见。🚀
【免费下载链接】sentruxReal-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improvement of code quality. Pure Rust.项目地址: https://gitcode.com/gh_mirrors/se/sentrux
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考