w_tools_cli 1.0.0
w_tools_cli: ^1.0.0 copied to clipboard
w_tools 的接入工具:init 生成聚合入口 / 暂存层 / AGENTS 片段,doctor 检查消费方是否遵守接入约定。
Changelog #
1.0.0 #
首次发布。
Added #
dart run w_tools_cli:init:把接入约定装进消费方项目 —— 生成聚合入口lib/app/w/toolkit.dart、暂存层lib/app/design_system/README.md、AGENTS.md片段 (标记块<!-- w_tools:begin -->,重复执行原地更新)与.w_tools_doctor.yaml(全注释,不改变行为)。--check只检查缺失(内容不同只提示、不算失败),--check-drift把「模板已过期」也判失败,--force才覆盖,--no-qr/--with-map控制导出范围。init输出的 pubspec 片段会自动识别已有dependencies/dev_dependenciessection,只给「追加的缩进行」,避免复制出重复的顶层 key。dart run w_tools_cli:doctor:扫描消费方项目并报出违反接入约定的地方:R1依赖了聚合包w_tools(会拖进 google_maps_flutter)R2业务代码直接 importpackage:w_tools_*或聚合包package:w_tools/(聚合入口与暂存层除外;//注释里的 import 不算)R3硬编码语义色(调色板必须项目自己配置,默认空 → 跳过)R4暂存层 import 了data//modules//routes//services/R5暂存层文件缺// STAGED:标记R6使用了禁用的尺寸单位.h/.r(项目专用,默认关;warn,--strict才失败) 支持--json、--strict、--only=R1,R2、--include-tests。
doctor --print-config/--write-config:打印或落盘带注释的默认配置.w_tools_doctor.yaml;内容由代码默认值渲染(不是手写模板),test/config_render_test.dart保证「打印出来的 = 实际默认值」。- 模板唯一来源是
templates/,构建期由dart run tool/gen_templates.dart生成lib/src/init/templates.g.dart,test/templates_fresh_test.dart拦截漂移。