SuperAPI AI 工具集

audit-imports

通用与其它

查看项目

更新于 10-16 06:45

技能介绍

audit-imports 是一个审计导入规范的工具,针对 XL1 技能片段检查导入卫生。默认只输出报告,只有传入 --fix 才编辑文件,且仅限机械性检查。

检查范围限定在 plugins/xl1-skills/skills 下的技能 markdown 与 xl1-scaffold 脚本的 templates,忽略其他内容,不修改 src/ 下的应用代码。所依据的规则包括:优先使用四个根 barrel(@xyo-network/sdk-js、@xyo-network/xl1-sdk、@xyo-network/chain-sdk、@xyo-network/react-chain-client-sdk)以利 tree shaking;仅当符号未被 barrel 重新导出时才回退到子包;同一符号在所有技能中应来自同一包;技能引用的包必须能通过脚手架模板安装。

调用方式为 /audit-imports [check] [--fix]。不传参数运行全部六项检查:barrels(缺失于根 barrel 的符号)、inverse(根 barrel 已覆盖却仍走子包)、consistency(同一符号跨技能来源不一致)、subpaths(未在 exports 中声明的子路径)、usage(片段内未使用或疑似缺失的导入)、scaffold(技能引用但未出现在任何模板中的包)。--fix 仅对 barrels、inverse、consistency 应用编辑。执行分三阶段:先本地收集导入清单,再并行抓取各包在 npm 注册表和 unpkg 上的导出信息并缓存到 /tmp(24 小时内复用,可 --refresh 强制刷新),最后并行运行各检查并输出带统计表的报告。

限制:subpaths、usage、scaffold 不自动修复,需人工判断;带 // audit-imports: ignore 的行跳过;类型导入同样检查;若多项检查产生同一编辑以 barrels 为准。网络取包失败会记录为 Unverified。具体安装命令与更多用法细节资料暂未提供。