如何实时看见项目依赖关系sentrux Treemap可视化完全教程让架构腐化无处遁形【免费下载链接】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 Agent 每次会话修改几十个文件时你还能看清项目的依赖关系吗sentrux 是一个纯 Rust 实现的实时架构传感器通过交互式 Treemap 依赖图可视化毫秒级扫描代码库的每个文件与每条依赖边并用 0–10000 的连续质量信号Quality Signal量化架构健康度让架构腐化无处遁形。本教程面向新手带你三步完成安装、读懂 Treemap、掌握质量门禁轻松上手这款代码依赖可视化神器 为什么你需要看见依赖关系 用 AI 辅助开发时Agent 每次会话都会修改几十个文件你在终端里看到的只是一行行Modified src/foo.rs——但你看不到这个文件在依赖图中的位置看不到它刚刚创建了一个循环依赖也看不到三个模块悄悄依赖上了一个本应内部的文件。这就是架构腐化的典型过程症状后果循环依赖增多构建顺序未定义改动难以隔离测试复杂度集中在上帝文件Agent 无法有效推理改一处坏三处依赖链过深底层一行修改层层传导传统方案是先规划架构再让 AI 实现但没有对生成代码的持续观测就没有反馈回路。你不需要更好的计划你需要一个传感器——sentrux 正是这个缺失的架构传感器。三步安装并打开实时 Treemap sentrux 是单一二进制文件无运行时依赖通过 tree-sitter 插件内置支持52 种语言Rust、Python、Go、TypeScript 等跨 macOS / Linux / Windows。第 1 步安装macOSbrew install sentrux/tap/sentruxLinux执行 install.sh 安装脚本即可完成安装。Windows从 Releases 下载对应平台二进制即可。第 2 步打开项目sentrux # 打开 GUI——实时 treemap 依赖图 sentrux /path/to/project # 直接扫描指定目录第 3 步观察窗口打开后你的整个项目以 Treemap矩形树图呈现。sentrux 内置文件监视器Agent 每修改一个文件对应色块会发光脉冲并自动重算布局与评分——你第一次可以看见AI 正在对架构做什么。如何读懂 Treemap色块、依赖边与发光信号 Treemap 的读法其实很简单每个色块 一个文件面积大小可切换为代码行数、圈复杂度、热度等指标由布局引擎 sentrux-core/src/layout/treemap_layout.rs 计算正方形化布局连接色块的线 依赖边包括 import 依赖、函数调用、类继承三种关系图悬停 / 点选文件可聚焦其全部上下游依赖spotlight 高亮一眼看清改这个文件会波及谁文件被 Agent 修改时会发光配合 sentrux-core/src/renderer/heat_overlay.rs 的热力渲染最近改动的区域一目了然。扫描结果被固化为不可变的快照结构文件树 三张依赖图 入口点在扫描、布局、渲染三个线程间共享因此大型项目也能毫秒级刷新。核心数据结构定义在 sentrux-core/src/core/snapshot.rs。质量信号5 个根因指标一个连续评分 光看见还不够还要能度量。sentrux 不堆砌 20 个症状型指标而是只保留 5 个图论层面的根因指标合成 0–10000 的连续质量信号指标衡量什么理论来源模块化 Modularity依赖图能否分解为独立模块Newman 模块度 Q无环性 Acyclicity循环依赖数量无环依赖原则 (ADP)深度 Depth最长依赖链层级分层架构理论均衡性 Equality复杂度是否过度集中基尼系数冗余度 Redundancy结构重复与浪费信息论设计上刻意避开了 A–F 字母评级存在可钻营的边界也避免了假优化刷分——只有真实的架构改进才能提升信号。完整推导见 docs/quality-signal-design.md指标实现位于 sentrux-core/src/metrics/。用质量门禁让退化无处遁形 sentrux 把看见变成拦截sentrux gate --save . # Agent 会话前保存架构基线 sentrux gate . # 会话后对比——质量退化直接拦截 sentrux check . # CI 友好的规则检查退出码 0/1配合规则引擎把架构决策写成项目根的.sentrux/rules.toml例如max_cycles 0零循环依赖、no_god_files true禁止上帝文件、分层[[layers]]与[[boundaries]]边界约束。规则校验逻辑在 sentrux-core/src/metrics/rules/checks.rsCI 中跑一条sentrux check .即可守门。进阶接入 AI Agent闭合反馈回路 sentrux 自带 MCP Server让 Claude Code、Cursor 等 Agent 直接读取结构健康度。在 MCP 配置中加入{ mcpServers: { sentrux: { command: sentrux, args: [--mcp] } } }典型工作流会话前session_start()存基线 → Agent 写码 →session_end()对比信号若从 7342 跌到 6891 立即得到 Quality degraded 告警。9 个工具scan / health / evolution / dsm / test_gaps 等让 Agent 从盲改变成照镜子改实现代码质量的递归自我改进。MCP 服务端实现见 sentrux-core/src/app/mcp_server/Claude 技能示例见 claude-plugin/skills/scan/SKILL.md。快速上手清单 ✅✅ 安装一条 brew / curl 命令✅ 运行sentrux打开实时 Treemap 依赖图✅ 学会看色块面积、依赖边、发光脉冲三个信号✅ 盯住质量信号数值退化立刻可见✅ 用sentrux gate在 Agent 会话前后做基线对比✅ 可选接入 MCP让 Agent 自己对着传感器改进架构腐化从来不是突然发生的而是一行行悄悄长出来的。现在你有了实时依赖 Treemap、连续质量信号和 CI 门禁——传感器已就位架构腐化无处遁形。【免费下载链接】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），仅供参考