Aveyx 用离线检查拦截 AI 改码风险
Aveyx v3.0.1 是 MIT 开源的离线 CLI 和 MCP 服务,可沿依赖链定位受影响的测试,并通过语法树检查跳过断言等测试篡改行为。它还支持凭据扫描、配置保护、改动快照和推送前拦截。
AI 深度解读
AI 编程助手改完代码,测试全绿,可能只是因为它加了 it.skip,或者用 || exit 0 吞掉了失败状态。Aveyx v3.0.1 作者的做法是把部分提示词约束变成可在本地执行的检查,再给助手提供改动影响范围和精简后的代码上下文。
对前端和全栈开发者,最容易拿来试的是两件事:改共享模块前先找受影响的测试,审查改动时再检查测试有没有被绕过。原文给出了可执行的命令,实际覆盖率和误报率还得用自己的仓库验证。
改一个共享模块,哪些测试该跟着跑?
aveyx impact <file> 从被修改的文件往回找引用者,还会沿着引用链继续往上追,最后列出受影响的测试文件。比如日期工具被公共组件调用,公共组件又被多个页面引用,页面测试也可能出现在结果里。作者称它能处理 ESM、CJS、再导出和动态 import()。
aveyx compact 用抽象语法树(AST)去掉函数体,保留函数签名、类型和按 PageRank 选出的调用方信息。让助手梳理接口或调用关系时,可以先给这份精简视图。排查日期边界、异步时序这类依赖具体实现的问题时,再打开对应函数体。
测试全绿,怎么检查有没有被绕过?
aveyx review --strict 用 Babel AST 检查可疑篡改,同时扫描凭据、检查受保护的配置,结果以 OASIS SARIF 2.1.0 输出。测试返回的是这次执行的结果,代码审查还能追问测试是否被跳过、失败是否被吞掉。aveyx audit-bugs 检查 SQL 注入、命令注入和 React Hook 泄漏等模式,aveyx scan-secrets 则可以单独扫描凭据。
aveyx install-hooks --pre-push 把检查接到本地推送前。做高风险重构时,作者还提供了 aveyx checkpoint 和 aveyx rollback,用于创建原子快照和回滚,快照范围包括 .env 和 Git hooks。
本地怎么跑,助手怎么接?
Aveyx 采用 MIT 许可,要求 Node 20+,以 ESM 运行,只有 3 个 @babel/* 运行时依赖。作者称工具运行时完全离线。aveyx-mcp 通过标准输入输出(stdio)提供 MCP 服务,包含 10 个工具和 44 条提示词。
原文用下面两条命令初始化项目并运行诊断。
npx aveyx init
npx aveyx doctor
第一行的 npx 在本地缺少对应包且缓存未命中时可能联网下载,离线部署需要事先准备依赖。
我的判断
我最认同把「测试绿了」和「测试有没有被改成永远绿」放进两道检查。提示词适合告诉助手测试应该怎么写,CI 负责实际运行测试,AST 规则可以补查跳过测试、吞掉退出码这类结构化模式。本地 hook 能提前反馈,团队要统一执行的规则仍适合放进 CI。
受影响测试列表能不能用于缩减 CI 测试范围,是另一回事。原文没讲清路径别名、运行时拼出的导入路径或框架约定能解析到什么程度,也没给出漏检率、误报率、上下文节省量或对照实验。减少上下文开销和拦截违规改动,目前都是作者的功能说明和经验判断。
能拿来做什么
- 修改公共组件或 Node 工具函数前,先用
aveyx impact <file>找一批优先跑的测试,合并前继续走仓库原有的测试流程。 - 在临时分支加一个
it.skip,再改一次受保护的配置,跑aveyx review --strict,确认规则能命中团队关心的改动,再决定是否接入 CI。 - 让助手梳理跨文件调用关系时,先给它
aveyx compact的输出。定位到具体函数后,再提供完整实现和对应测试。