guardAI 正式开源：为 AI 编码时代装上"项目骨架守卫"

guardAI 正式开源：为 AI 编码时代装上"项目骨架守卫"

AI 能写代码了，但谁来管它写出来的代码长什么样？广西维烯网络给出的答案是 guardAI——一个专注于"结构级 + 资产级"代码规范门禁的开源工具，已在 GitHub / Gitee 双平台开源，当前版本 v0.6.1。

AI 写代码的三类无声腐蚀

在大模型辅助编码成为日常的今天，团队普遍遇到三个问题：

1. 骨架漂移——AI 在长会话中"顺手"自建 utils2、common 等野目录，项目结构逐渐失控；
2. 重复造轮子——AI 忘记项目里已有的封装，同一个上传方法被重写了 4~8 遍；
3. 规范衰减——注入给 AI 的团队规范，随着会话变长被逐步稀释。

这三类问题不报错、不崩溃，却在无声中腐蚀项目质量，等发现时往往已积重难返。

核心理念：确定性引擎裁判，AI 只做装配

guardAI 的设计哲学是**"引擎裁判，AI 装配"**：合规判断交给确定性引擎，结果稳定、可复现；AI 负责分析与建议，发挥语义理解优势。一句话——AI 是检察官，不是法官。

六大确定性检查器

一条 guardAI check 命令跑完全部检查：

模块	检查内容	能抓什么
structure	目录白名单 + 落位规则	AI 自建野目录、文件放错层
duplicate	双通道近似重复检测	复制粘贴改名、换皮重写
secret	敏感文件/目录/内容三道闸	硬编码密钥、私钥入库
doc	公共 API 文档注释	public 成员缺文档摘要
sql	SQL 拼接构造	字符串插值拼 SQL 的注入隐患
perf	数据访问性能	N+1 查询、SELECT * 全列扫描

每个违规项都附带**【给 AI 的修复指令】**，可以直接交给 AI 照着修，修完复检归零。

AI 层三步：审查、装配、学习

在确定性引擎之上，guardAI 提供三个 AI 增强命令（可选，需配置模型 KEY，支持 OpenAI 协议 / Anthropic / 本地 Ollama 三类接入，密钥走环境变量、不落文件）：

• review：语义审查——对代码改动做命名、注释、分层、复用层面的审查，输出中文报告，默认只报告不拦截；
• init --ai：装配顾问——用大模型分析仓库结构，生成白名单与豁免建议，再过确定性校验兜底，守住"首跑零误报"铁律；
• learn：规则发现员——从审查素材中提炼候选规则，人工确认后沉淀为团队规则资产。

五个真实项目实测

guardAI 在 5 个真实项目上完成了横向实测，其中包括 2 个千文件级仓库：

• 最大的受测仓库 1439 个 C# 文件，全量双检（结构 + 重复）67 秒完成，CI 可接受；
• 首跑零误报：5 个项目首检问题全部通过配置或豁免归零，存量代码不轰炸，只拦新增；
• 自研框架 WitchC 作为基准场，违规闭环 220 → 7 → 0；
• 检测语言覆盖 C# / Java / Kotlin / TypeScript / JavaScript / Go / Python，按扩展名自动分发；
• 317 项单元测试全部通过。

获取方式

guardAI 提供 Windows / Linux 双端自包含单文件，零运行时依赖，解压即用：

• GitHub：https://github.com/ingkele/guardAI （Releases 页面下载）
• Gitee：https://gitee.com/ingkele/guardAI

十个命令覆盖完整工作流：init / check / strict / review / learn / doctor / ui / mcp / index / search，支持 CI、pre-commit、AI hook 一键装配。

写在最后

guardAI 是广西维烯网络"AI 智能赋能"业务线的自研基础设施——我们在自己的 AI 编码实践中踩过的坑，变成了这套工具里的每一个检查器。选择开源，是因为它解决的正是每一个正在用 AI 写代码的团队都会遇到的问题。

如果您的团队也在拥抱 AI 编码，欢迎试用 guardAI 并反馈建议，也欢迎通过联系我们页面交流 AI 时代的工程化实践。