Skip to main content

w_tools_cli 1.5.0 copy "w_tools_cli: ^1.5.0" to clipboard
w_tools_cli: ^1.5.0 copied to clipboard

w_tools 的接入工具:init 生成聚合入口 / 暂存层 / AGENTS 片段,doctor 检查消费方是否遵守接入约定。

Changelog #

1.5.0 #

Added #

  • 新增 R9 项目禁用 API:.w_tools_doctor.yaml 的 banned 支持 literal / regex、paths / ignore、use / reason 与 level。
  • 支持 // w_tools:ignore R9 reason: ... / // w_tools:ignore-file R9 reason: ...,没有 reason 不生效。
  • init 会把有效 banned 生成到 AGENTS;explain 会提示当前项目禁用项。
  • README 增加 5 分钟上手、命令决策表、升级后重新生成、退出码与 R9/banned 说明;init / doctor / list / explain 的 --help 补示例。

Changed #

  • 消费方 AGENTS 模板补充 WTextVariant 不够用时的处理顺序:先 variant + style,项目内重复抽本地 helper,稳定跨页面语义再提库内 variant。
  • 组件目录同步 WText 的 variant 边界说明。
  • 消费方 AGENTS 模板统一间距入口:SizedBox 用 WSizeBox,Padding 用 WPadding,EdgeInsets 用 num.allPadding;不再推荐 num.heightBox / widthBox / squareBox。

1.4.0 #

Changed #

  • 消费方 AGENTS 模板补充 Form 直接字段、WImage、弹层与轻提示规则;修正不存在的 WnnToast 引用。
  • 消费方 AGENTS 不再放完整按钮代码,仅保留决策规则;完整模板留在 docs/agents/button.md。
  • 组件目录同步 Form 的 WForm / 直接字段 / WFormFieldStyle 入口,移除旧 App helper 名称。
  • 升级 w_tools_cli 后,消费方需重新执行 dart run w_tools_cli:init(或 --check-drift)以更新 AGENTS 片段。
  • 修复 init 生成的 w_tools_ui 约束仍为 ^2.1.0:同步到 ^3.0.0,避免新项目解析到旧 UI。
  • 消费方 AGENTS 与组件目录补充 w_tools_api 的 DioRegistry / WTokenInterceptor / WLogInterceptor 网络规则。
  • 消费方 AGENTS 与组件目录补充 w_tools_app 的 WApp.start / 插件依赖 / WLanguage / WRouteObserver 启动规则。
  • 消费方 AGENTS 与组件目录补充 w_tools_core 的 WStorage.init / 明文存储 / WValidator 与 WRegExp 分工规则。
  • 消费方 AGENTS 与组件目录补充 w_tools_qr 的 WQrView / WQrController / restartScan 扫码规则。
  • 消费方 AGENTS 与组件目录补充 w_tools_map 的 WMap / WMapZone / WMapItemMapper 地图规则,仅在 --with-map 时生成。
  • 新增 example/:命令演示与基于临时 demo_project 的可复现 init / check-drift / doctor / context / list / explain 流程;脚本自动准备依赖并清理临时目录。
  • DoctorConfig.copyWith 支持覆盖 colorMinCount / ignore。

1.3.0 #

Added #

  • 新增 w_tools_async 子包支持:init --profile=full 默认导出, --no-async 可关闭;toolkit / pubspec 片段同步。

1.2.0 #

Added #

  • init 生成 lib/app/ui/app_bars.dart、app_boxes.dart、app_buttons.dart、 app_card.dart 与 app_scaffold.dart:标准页面默认使用 AppScaffold, AppBar / 盒子 / 按钮样式统一走 AppBars.style / AppBoxes / AppButtons, 重复卡片用 AppCard。lib/app/design_system/ 只保留待上移组件。 AppBoxes.card / warning 跟随主题;AppCard 默认使用 AppBoxes.card(context), 支持 clipBehavior。
  • AGENTS / 暂存层规范补充:真按钮用 WButton,任意 child/卡片点击用 WPressable。
  • toolkit 导出 AppScaffold/AppBars/AppButtons;AGENTS / lib/app/ui/README.md 增加页面与按钮规范。
  • 固定 lib/app/ui/ 与 lib/app/design_system/:R2/R4/R5 与 init 使用同一套路径。
  • init --no-ui:不生成 lib/app/ui/ 与 design_system/,不导出 w_tools_ui,AGENTS 不写 UI 规则。
  • init --profile=minimal|ui|api|full:按能力组合生成 toolkit 与依赖片段。
  • init --no-instructions:不生成/不检查 AGENTS 等 AI 指令文件,优先于 --targets。
  • help 明确 UI 生成条件;text 输出 profile / features / targets;R8 文档说明跳过 UI starter。
  • init 报告 profile / targets 切换后遗留的 UI 与指令文件(stale),但不会自动删除。
  • R5 / context 只统计 .dart 暂存文件,不再把 design_system/README.md 算作缺 // STAGED。
  • R4 同时检查 lib/app/ui/ 与 design_system/,项目 UI 也不得依赖业务层;R3 对这两层豁免硬编码色。
  • lib/app/ui/ 下的 App* 与 README 视为 starter:自定义后不算 drift,也不会被 init / --check-drift 覆盖。
  • 新增 tool/check_templates_compile.dart,CI 用 Flutter analyze 编译检查生成的 UI starter。
  • 迁移:旧版生成的 design_system/app_*.dart 移到 lib/app/ui/; toolkit 的 export 改为 ../ui/...。

1.1.1 #

Changed #

  • init 生成的 pubspec 片段把 w_tools_ui 约束更新到 ^2.0.0 (配合 w_tools_ui 1.2.0 的 String.toImage 增强)。

1.1.0 #

Added #

  • dart run w_tools_cli:context:输出项目事实(已装版本、toolkit 导出、暂存层、 规则、当前检查结果),支持 --format=json|markdown|prompt 与 --max-tokens。
  • dart run w_tools_cli:list / :explain:内置组件目录查询(来源 catalog/components.yaml,生成 catalog.g.dart),避免凭记忆造组件名。
  • init --json:机器可读的初始化结果。
  • init --targets=agents,claude,cursor,copilot:同一份指令写到多个 agent 文件; cursor 新文件带 frontmatter。--lang=zh|en 生成中英文指令; .w_tools_doctor.yaml 的 ai.targets / ai.language 可作为默认值。
  • 生成物头部带 generated by w_tools_cli x.y.z,doctor 的 R8 检查是否过期。
  • doctor 新增 R7(toolkit 与 pubspec 依赖一致)、R8(生成物版本)。
  • doctor --format=markdown:可直接粘给 AI / PR 评论的摘要。
  • doctor --json 的 issue 增加结构化 fix(run / edit),AI 可直接执行; 没有 fix 时继续用 hint。

Changed #

  • init 的 AGENTS/CLAUDE 片段升级为 AI 工作流(context → list/explain → doctor)。
  • 5 个入口共用 CLI runner,--version / --help 行为一致; list / explain 支持 --format=json。
  • 规则注册表统一到 doctorRules,新增规则只改一处;规则间共享文件读取缓存。
  • R7 不再重复报告聚合包 w_tools(由 R1 负责)。

Fixed #

  • 生成的指令会代入真实项目名(不再留下 <app> 占位符)。
  • R8 不再把用户手写的 CLAUDE.md / copilot 文件当成生成物误报。
  • init 的 pubspec 片段在已有 dependencies / dev_dependencies 时只追加缩进行, 避免复制出重复的顶层 key。

1.0.0 #

首次发布:init / doctor(R1~R6)、模板生成与 .w_tools_doctor.yaml。

0
likes
0
points
4.08k
downloads

Publisher

unverified uploader

Weekly Downloads

w_tools 的接入工具:init 生成聚合入口 / 暂存层 / AGENTS 片段,doctor 检查消费方是否遵守接入约定。

Homepage
Repository (GitHub)
View/report issues

Topics

#dart #tooling #cli

License

unknown (license)

Dependencies

args, path, yaml

More

Packages that depend on w_tools_cli