☰
5分钟装好sentrux:一条命令打开你的代码实时架构Treemap(macOS/Linux/Windows完整指南)
2026/9/27 11:14:54 网站建设 项目流程

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 --version

Linux 安装 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 # 强制 OpenGL

2. 升级到最新版本

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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询