企业官网建设流程全解析

零Rust代码支持新语言：用tree-sitter插件为sentrux添加第53种语言的完整开发指南

【免费下载链接】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 编写的单一二进制即可扫描项目结构、计算 0–10000 的架构健康分，并帮助 AI Agent 形成代码质量改进的反馈闭环。它内置 52 种语言支持，而最巧妙的设计是：二进制里没有任何语言知识——所有语言都来自 tree-sitter 插件。这意味着你不需要写一行 Rust，就能为 sentrux 添加第 53 种语言。本文就是这份完整开发指南。

一、先懂原理：零Rust代码的插件架构如何实现

sentrux 把二进制做成了一个"通用平台"：语言识别、结构提取、语义规则全部外置到插件文件里。运行时加载器从~/.sentrux/plugins/<语言名>/发现插件，动态加载编译好的语法库，注册进全局语言注册表（详见 sentrux-core/src/analysis/plugin/mod.rs）。

启动时插件会经历严格校验：解析清单、编译查询、校验 ABI 版本、测试编译语法（实现见 sentrux-core/src/analysis/plugin/loader.rs）。任何一步失败，插件被跳过并记录日志，绝不影响其他语言——这就是"零 Rust 代码"背后的稳定性。

二、插件解剖：3个文件必须掌握的插件三件套

一个语言插件就是一个目录，只有三类文件：

以官方 Python 插件为例，plugins/python/plugin.toml 只需声明extensions = ["py"]、语法来源与capabilities = ["functions", "classes", "imports"]；而 plugins/python/queries/tags.scm 用几行 S 表达式就能捕获类定义、函数定义和 import 语句。社区插件同样轻量，比如 plugins/gdscript/plugin.toml 甚至附带了 plugins/gdscript/tests/sample.gd 测试样本。

三、4步实操：从零到加载你的新语言

第1步｜生成插件模板

一条命令 scaffold 出完整目录结构（模板生成逻辑在 sentrux-bin/src/main_impl.rs）：

sentrux plugin init my-lang

它会在~/.sentrux/plugins/my-lang/下创建grammars/、queries/、tests/目录，并写入带 TODO 提示的 [plugin.toml] 骨架和 tags.scm 注释。

第2步｜编辑 plugin.toml 清单

把extensions改成真实扩展名（不带点），填写该语言 tree-sitter 语法仓库地址，确认abi_version = 14与语法库匹配。清单字段的完整定义参见 sentrux-core/src/analysis/plugin/manifest.rs。

第3步｜编译语法库

拉取该语言的 tree-sitter 语法仓库，在仓库目录内执行：

tree-sitter generate cc -shared -o grammars/linux-x86_64.so src/parser.c

macOS 输出darwin-arm64.dylib，Windows 输出.dll——文件名由平台决定，清单会自动校验。

第4步｜编写 tags.scm 查询

这是唯一需要"写代码"的环节，但只是声明式查询。模板注释里已给出必需捕获：@func.def/@func.name（函数）、@class.def（类）、@import.path（导入）；若声明了calls能力，还需@call.name。清单校验器会逐一核对能力与捕获是否匹配（见 manifest.rs 中的validate_query_captures）。

四、plugin validate：一键自检你的新插件

写完不用猜，直接验证：

sentrux plugin validate ~/.sentrux/plugins/my-lang sentrux plugin list

validate会输出清单解析结果、捕获匹配情况和语法库是否存在；list则显示最终加载成功的所有插件及版本号。能出现在 list 里，说明你的第 53 种语言已经正式接入。

五、进阶：用 [semantics] 打磨语言专属语义

想要更精细的分析，可在 plugin.toml 中配置[semantics]段（可选，有默认值）：

• 测试识别：test_prefixes = ["test_"]、test_dir_prefixes = ["tests/"]让 sentrux 认出测试文件，喂给测试缺口分析；
• 复杂度计算：branch_nodes/nesting_nodes指定该语言里哪些节点计入圈复杂度（Python 插件的完整示例见 plugins/python/plugin.toml 第 61–69 行）；
• 项目约定：manifest_files（如pyproject.toml）、ignored_dirs（如venv、node_modules）排除噪音目录；
• 入口识别：entry_point_patterns（如__main__）帮助定位程序入口。

这些字段全部集中在 plugins/python/plugin.toml 中，是现成的抄写模板——照着改成你语言的答案即可。

写在最后：你的语言，你的插件

整个流程回顾：plugin init生成模板 → 改清单 → 编译语法 → 写查询 →plugin validate验收。全程0 行 Rust，却能让 sentrux 的实时 treemap、健康分和规则引擎立刻理解你的新语言。想参考更多语言插件的写法，plugins/ 目录里 52 个官方插件都是开源范本。🚀

【免费下载链接】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