w_tools_cli 1.20.40
w_tools_cli: ^1.20.40 copied to clipboard
w_tools 的接入工具:init 生成聚合入口 / 暂存层 / AGENTS 片段,doctor 检查接入约定,upgrade 抬依赖版本。
1.20.40 #
Changed #
- catalog 删除
WRetryInterceptor的Retry-After/retryOnUnknownErrors说明,WLogInterceptor删除replace*参数说明;6.1.0 收敛为更小的功能面。 init的w_tools_api约束保持^6.1.0(同版本内收敛)。
1.20.39 #
Changed #
- catalog 同步
w_tools_api6.1 的 LRU / TTL 语义:淘汰不再强制中断在途请求, 显式 dispose / clearCache 仍 force。 - 同步日志超大 body 限量和 retry 退避取消行为。
1.20.38 #
Changed #
- catalog 补
WPage分页边界:page只支持 1-based 页码分页,offset / cursor 用WApiClient.send手工构造;同步WApiClient.page非法page/pageSize的ArgumentError说明。
1.20.37 #
Changed #
- catalog 同步
w_tools_api6.1:WTokenInterceptor.shouldRefresh、WApiClient.send/page按请求覆盖信封、WLogInterceptor错误响应片段。 init的w_tools_api约束保持^6.1.0(同版本内补齐 6.1 条目)。
1.20.36 #
Changed #
- catalog 同步
w_tools_api6.1:信封空 body、DioRegistry.replace、downloadResponse/readTotalFromResponse、日志脱敏追加语义、Retry-After/retryOnUnknownErrors、WMetric.attempt。 init的w_tools_api约束抬到^6.1.0。
1.20.35 #
Changed #
- catalog / explain / init 模板同步
w_tools_api6.0:WApiConfig→WApiSettings、WApiMetricsInterceptor→WMetricsInterceptor、WApiMetric→WMetric;删除空壳数据层与 日志友好提示。 init的w_tools_api约束抬到^6.0.0。
1.20.34 #
Changed #
- catalog / explain 同步
WApiMetricsInterceptor/WApiMetric。 init的w_tools_api约束抬到^5.6.0。
1.20.33 #
Changed #
- catalog / explain 同步
WApiResponse/WApiClient.send/WApiEnvelopeParser.authFailureCodes。 init的w_tools_api约束抬到^5.5.0。
1.20.30 #
Changed #
catalog/templates同步w_tools_api5.3.0 的WApiClient/WApiEnvelopeParser/WPage/WRetryInterceptor条目。init的w_tools_api约束抬到^5.3.0。
1.20.26 #
Changed #
- catalog 补
WListViewSliver.overlap的 hit test pitfall 与WImageSlots原始 Base64 字符串提示。
1.20.21 #
Changed #
- catalog 同步
WImageSlots只保留 builder(删除placeholder/emptyWidget/errorWidget固定 Widget 入口)。
1.20.19 #
Changed #
- catalog 同步
WWidgetExtension精简(6 个物理 padding 删除、withBottomBarSpaceOf改名withBottomSafeSpaceOf)。
1.20.17 #
Changed #
- catalog 把
WButtonStyles合并到WButtonStyleSet(WButtonStyleSet.of(context));WButton的示例 / pitfalls 同步。
1.20.16 #
Changed #
- catalog 移除
WTextStyleExtension/WUiWidgetExtension(ui 11.0 删除,后者合并到WWidgetExtension);WWidgetExtensionusage 补toPressable。
1.20.15 #
Changed #
- catalog / entrypoints / AGENTS 模板移除
WClipRRect(ui 11.0 删除,改用 FlutterClipRRect); 同步w_tools_ui约束^11.0.0。
1.20.14 #
Changed #
- catalog 补
WAppBar阴影 / 两侧布局、WBadge.offset、WTabBar交互参数、WScaffold.bottomNavigationBarSafeArea、WButton.tooltip/isSelected; 同步w_tools_ui约束^10.5.0。
1.20.13 #
Changed #
- catalog 补
WScaffold抽屉 / 底部面板透传与WNavBar.onBeforeTap示例 / pitfalls; 同步w_tools_ui约束^10.4.0。
1.20.12 #
Changed #
- catalog 补
WText.rich、WBadge.count/dot、WTabBarStyle标签颜色与WNavBar.safeArea示例 / pitfalls;同步w_tools_ui约束^10.3.0。
1.20.9 #
Changed #
init生成的lib/app/ui/README.md补主题接入说明:withWTextStyles与WImageTheme(slots: ...),避免消费方漏装语义字体 / 图片兜底。
1.20.8 #
Changed #
init写入的w_tools_async约束同步到^6.7.0(WAsyncController.reload())。explain/ catalog 推荐reload();retry()标为 deprecated。
1.20.7 #
Changed #
init写入的w_tools_async约束同步到^6.6.0(WAsyncStrings.loading/ 默认视图liveRegion)。explain/ catalog / AGENTS 模板补充loading文案与默认可访问性语义。
1.20.6 #
Changed #
init写入的w_tools_async约束同步到^6.5.0(分页 footer 状态机)。explain/ catalog / AGENTS 模板补充WAsyncPagedFooterStatus/footerStatus。
1.20.5 #
Changed #
init写入的w_tools_async约束同步到^6.4.0(取消竞态修复 /settle/replaceData/listWithToken/ retry 退避与观测)。explain/ catalog / AGENTS 模板补充WAsync.settle、WAsyncController.replaceData/listWithToken、WAsync.retry的retryDelayBuilder/onRetry。
1.20.2 #
Changed #
feedback status(text / json)新增公开 Issue 日额度:date / used / max / remaining / 预算文件路径。feedback submit额度耗尽的错误补上「已用 / 上限 / 剩余」、max_issues_per_day配置路径、 默认值 5 和预算文件路径,便于直接排查 / 调整。
1.20.0 #
1.19.1 #
Changed #
init的w_tools_async约束同步到^6.2.0(refresh 可重入、sliver 错误条上移、 新增WAsyncPagedController.replaceData)。
1.19.0 #
Added #
- 新增
upgrade:把pubspec.yaml里的w_tools/w_tools_*抬到 hosted 上的最新版本。--check只读(有落后 / lock 落后 exit 1,可进 CI);--dry-run打印 diff 不写; 默认写入后跑pub get,失败还原 pubspec 并 exit 2。- 只动
w_tools*,其它依赖(含刻意钉死的版本)与 pubspec 注释一律不动;跨 major 默认只报告,--major/--only=<包>才写;0.x 包跨 minor 按跨 major 处理。 - 查最新走
PUB_HOSTED_URL(默认 pub.dev,认HTTP(S)_PROXY),输出里带实际源。 context的commands加upgrade/upgradeCheck,AI 能直接发现这条入口。
- 消费方 AGENTS 片段加一条「升级依赖」路由;
AI_PROMPTS.md的 F-2 第 1 步改用upgrade。
1.18.2 #
1.18.0 #
Changed #
- 消费方 AI_PROMPTS 与 AGENTS 对齐:固定前缀补
doctor --format=json(0 error)、test//tool//integration_test/下 dev-only import 例外、L-1 反馈开启片段;§3 自检清单补 doctor 与生成物清单。 - 修正与 catalog 冲突的 C-1
validatorSettings说法;E-1 / §2 的explainexit 1 补「匹配到多个」; I-1 的集成测试命令改为可直接执行(flutter test integration_test/dart test test), J-1 明确以git diff或用户贴的 diff 为审查输入。 - 升级场景:migration 说明改为 CHANGELOG 优先(
docs/不随包发布),示例更新到 ui-8.0 / form-6.0; F-2 明确先改 pubspec 约束并 pub get(普通pub upgrade不跨 major);聚合包说明不再暗示「保持现状」即可通过 doctor R1。 - README / templates README:固定前缀例外补 L-1,场景清单补 L-1,§3 不再称「文末」。
- 新增两个场景:M-1 接入 / 体检(按 doctor 报告一次修一条规则,直到 0 error)、 N-1 小改动(单文件 / 小范围,先给最小改法再动手);固定前缀的开发者称谓按项目类型渲染 (纯 Dart 项目不再写「Dart / Flutter 开发者」)。
feedback status --json在通道 disabled 时附带enableHint,AI 不用再猜开启方式。- 消费方 AGENTS 片段重做:
init写入AGENTS.md/CLAUDE.md/ cursor / copilot 的片段从 280 行 / 11.6k 字符 降到 72 行 / 4.2k 字符,固定四段:怎么用 w_tools→硬规则→组件约定(每包一行)→完成前。 - 硬规则上移并带 doctor 规则号(R1 / R2 / R4 / R5 / R9);R2 的 import 例外(toolkit、
lib/app/ui/、lib/app/design_system/、test|tool|integration_test下的w_tools_cli/figma/device/e2e) 从 R2 的同一份常量渲染 —— 此前「业务代码只 import 聚合入口」是绝对值,和 R2 白名单、generated 的app_*.dart互相矛盾。 - 每个启用的包只留一行:主入口清单 + 一句话规则 +
explain入口;逐 API 细节从 AGENTS 删除 (WImage尺寸约束、WTextvariant 顺序、WNavBarvsync 等仍在 catalogpitfalls/explain,不丢事实)。 - 反馈段 68 行 → 3 行(默认关闭),完整流程指向
.w_tools/AI_PROMPTS.md的 L-1;删除templates/agents/{zh,en}/feedback.md。 - Figma / 设备段改为路由:命令以
packages/figma/README.md、figma --help、docs/agents/device-testing.md为唯一来源,AGENTS 不再维护第二份命令清单。 - 删除内联 doctor 规则速查表(
## 检查项);规则清单与启用状态由doctor --format=json提供。 ## 完成前的 analyze / test 跟随项目类型,纯 Dart 项目不再被要求跑flutter。
Fixed #
## 项目规则从标记块内移到块外:新建指令文件时追加一次,init不再覆盖项目自己的规则; 此前它既是块内生成内容(重跑即丢),又会把所有组件约定吞进自己的标题下。- 普通
init(不带--force)原地刷新指令文件标记块时,若块内内容与模板不同(手改 / 换 profile), 先写AGENTS.md.bak再覆盖并给 warning(此前静默丢失);README 的--force语义同步改成与实现一致。 - R8 改为按标记块内容比对(版本号本身不算漂移):CLI 升版本但模板没变时不再给所有消费方报 warn;
没有
.w_tools/init.json时仍按版本标记比对。.w_tools/init.json新增可选figmaInstall。 - cursor target 的
.cursor/rules/w_tools.mdc显式写alwaysApply: true:没有它时规则会落到 「Agent Requested」,由 agent 自己决定读不读,接入约定等于没生效。
Tooling #
tool/agent_budget.dart新增--json(机器可读快照:schema / generator / rows / feedback) 与--record(写入docs/metrics/agents_budget.jsonl,一个 CLI 版本一行、幂等 upsert);--check增加「当前版本已记录」校验,版本抬了没记录会失败。- 周检
.github/workflows/release-status.yml用scripts/agents_budget_trend.py把预算趋势 渲染成 Markdown 表写进 job summary;只读历史,不跑 Dart、不需要外网。
Tests #
templates_fresh_test.dart新增结构预算门禁:full / minimal / en 的行数与字符数、段落顺序、 反馈行数、zh/en 组件符号集合一致、项目规则占位必须在块外。- 预算数据化到
catalog/agent_budget.yaml(抬预算 = 一处显式 diff),tool/agent_budget.dart量渲染结果并在 preflight 的agents budget步打印余量表;测试直接复用同一实现。 - 新增
scripts/check_agents_routing.py:AGENTS 模板每条 bullet 必须有锚 (explain X/ 路径 / 规则号 / 命令 / 占位符),否则要写<!-- no-anchor: 理由 -->显式豁免。 - R8 新增「版本升了但内容没变 → pass」「块内被手改 → 报内容不同」用例。
1.17.1 #
Fixed #
init生成w_tools_cli的 dev 约束改用当前 CLI 版本(^1.17.1);此前停在^1.16.0。init_test改为读packages/cli/pubspec.yaml校验cliConstraint,不再硬编码过期值。
1.17.0 #
Breaking #
feedback submit没有可用通道时由 exit 0 改为 exit 4(什么都没写);依赖旧退出码的脚本 / CI 要改。--issue不再绕过开关:feedback.enabled: false时退出 2(项目根是 w_tools 仓库时除外)。- 配置键
feedback.issue改名feedback.enabled;旧键仍兼容,同时出现时enabled优先。
Changed #
- 反馈通道改为一套判定(
submit/status/path/search/lint共用): 项目根是 w_tools 仓库 → 写该仓库docs/feedback/;开启feedback.enabled且本机有 w_tools 检出 (path / git 依赖)→ 写那个仓库的台账,不建 Issue;没有本地检出才建 Issue;否则跳过。 此前path认本地台账、submit却按「项目根是不是仓库」判,路径依赖的消费方会自相矛盾。 - 开关改名
feedback.enabled(默认 false);旧键feedback.issue仍兼容,enabled优先。doctor --print-config输出同步(旧键以注释保留)。 --issue不再绕过开关:未开启反馈时--issue退出 2,不再是一条隐式覆盖路径; 本机有台账时--issue仍可明确要求公开 Issue。--ledger需要本机 w_tools 仓库检出。- 跳过不再是「成功」:
feedback submit没有可用通道时退出 4 并打印「什么都没写」, JSON 带mode: skipped/exitCode: 4;AI / CI 不能再把「没提交」当成功。 feedback status在issue通道下附带gh可用性(installed/authenticated/ready), 不必等提交才发现 gh 没装。feedback lint在本机没有台账时输出「跳过」而不是✓ 待处理 0 条(假绿);search在无本地台账时 提示加--gh,不再静默返回空。- 建 Issue 的正文不再带台账元数据(
### [待处理] …+- 状态变更:…),预填链接同步。 - pub cache 里的 git 依赖(
~/.pub-cache/git/…)不当作「本机 w_tools 库」:不往缓存里写台账, 按「没有本地仓库」处理(缓存会被pub cache repair清掉,写进去等于写丢)。 - 新增
feedback.ledger: <路径>(相对项目根或绝对路径):仓库 clone 在别处、依赖解析不到时 也能命中本机台账;指向的不是 w_tools 仓库会在 stderr 提示一次并忽略(不静默写错地方)。 - 公开 Issue 加每日额度:
feedback.max_issues_per_day(默认 5,0 = 不限)。CLI 没有会话概念, 用日额度兜住「一次会话 3–5 条」;计数在.w_tools/feedback_budget.json(跨天重置、删了归零), 本地台账不占额度;额度耗尽 exit 2,--json带issueBudgetUsed/issueBudgetMax。 - 从消费方写本机 w_tools 检出时,stderr 提醒「该仓库工作区会变脏,提交前记得 commit / discard」,
--json带dirtiesRepo。
Fixed #
init的w_tools_device约束同步到^0.3.1(w_tools_device已发 0.3.1,上一版仍写^0.3.0)。
Docs #
templates/agents/{zh,en}/feedback.md:写明「本地台账优先 → Issue → 跳过(exit 4)」、开关硬门禁、 8 个必填字段、Issue 公开需脱敏;补feedback.ledger的用法。templates/ai/consumer-prompts{,.en}.md:新增场景L-1 记一条反馈(先feedback status, disabled 就停;查重 → 8 字段草稿 → 默认路由提交;不贴密钥、不超 3–5 条)。docs/agents/cli.md的 AI 闭环标明记反馈是L-1。- 消费方 AGENTS 模板补公开 Issue 日额度、以及「写本机台账会弄脏 w_tools 工作区」的提醒。
docs/agents/cli.md、docs/feedback/README.md、packages/cli/README.md、根AGENTS.md同步路由与退出码; 删掉「消费方在本地日志做缓冲」这句与实现不一致的描述。context --format=prompt增加一行反馈路由提示(先feedback status,disabled 时不要提交)。
1.16.1 #
Changed #
- catalog / templates:同步
w_tools_toast2.1(新增WToast.showModal;WToast条目补 「showCustomDialog默认关不掉且点击穿透」的陷阱与正确用法);init的 toast 约束同步到^2.1.0。
1.16.0 #
Changed #
- catalog / templates / context:同步
w_tools_qr2.0(WQrController归调用方、WQrOverlayStyle、WQrScanResult、移除WQrViewState);WQrController升为 teach, 旧名保留为 aliases 供explain兜底;capability 摘要改为WQrView + WQrController(重扫 restart)。 init的w_tools_device版本约束同步到^0.3.0。list --package=device的提示改为指向docs/agents/device-testing.md(此前指向不存在的device.md)。doctor:未启用的规则(默认关闭的 R6、以及用户显式关闭的规则)现在统一以status: skipped+skipReason: 未在 rules 中启用出现在--format=json/ human / markdown 输出里,不再整条从rules数组消失;counts与退出码不受影响。
Docs #
templates/agents/{zh,en}/async.md:补「WAsync的state是ValueListenable、不是Rx, 页面里其它 Rx 状态的Obx仍要保留」;分页补「页号读page/hasLoadedMoreThanOnePage, 不要用data.length变大去猜」。templates/agents/{zh,en}/app.md:插件onInit里注册 GetX 服务用registerService(w_tools_app_getx),不要写Future<void> onInit() => Get.putAsync(...)(会注册到void)。
1.15.1 #
Fixed #
- catalog:
WLanguage/WLocaleConfig/WAppTheme归属改为w_tools_app(w_tools_app_getxre-export)。 - 同步
w_tools_app_getx版本约束到^2.0.0、w_tools_app到^3.1.0(init 生成的 pubspec 与versions.dart)。 - catalog/templates:修正
WApiConfig的不可编译 usage;补齐WTokenInterceptor/WLogInterceptor/WLogPart教学条目(WLogPart升为 teach);versions.dart同步w_tools_api到^5.1.0。 - 同步
w_tools_ui版本约束到^8.0.0(init 生成的 pubspec 与versions.dart)。 - 同步
w_tools_async版本约束到^6.0.0(init 生成的 pubspec 与versions.dart)。 - catalog:修正
WAsyncTheme的sliverLoadingBuilder示例(返回非滚动 Widget),并把WAsyncOptions/WAsyncActivity/WCancelToken从合并条目拆成可独立explain的条目。 - catalog:补充
WAsyncState.list与WAsyncPagedController.changes用法。
1.15.0 #
Fixed #
- 同步子包版本约束:
w_tools_form改为^6.0.0(catalog / init 模板 /versions.dart一起更新)。
Changed #
- 同步 form 组件目录与 init 模板:
WFormBorderConfig→WFormBorderStyle(新增borderStyle:用法), 新增WFormThemeData条目,WFormButton标注为WFormFieldButton<String>别名,WFormValidatorSettings改为不可变写法,bordered: false的 message 改为渲染在字段下方,phone()更新为hkPhone()。 - 重构
init生成的.w_tools/AI_PROMPTS.md,结构对齐维护者提示词手册: 「新手先看这里 → 0 固定前缀 → 填空说明 → 一个填好的例子 → 1 场景选择 → A~K 场景 → 2 输出不对时 → 3 AI 完成后你必须检查 → 4 维护这份文档」。 读者是使用 w_tools 的 Dart / Flutter 开发者(对提示词不熟),不是 agent。 - 场景编号从
C-A~C-K改为「族字母-工序号」:A-1、B-1……;有先后关系的大任务拆成多轮, 每轮一个可判断的产物——A-1只读计划 →A-2实现、E-1审计 →E-2修复、F-1计划 →F-2分文件替换 →F-3验证。旧编号对应:C-A→A-1、C-B→B-1、C-C→C-1、C-D→D-1、C-E→E-1、C-F→F-1、C-G→G-1、C-H→H-1、C-I→I-1、C-J→J-1、C-K→K-1。 - 新增「填空说明」占位符表、「一个填好的例子」、「从现象反查」、「输出不对时加一句话」、 「AI 提到的组件先用 explain 核一遍」、「默认工作流(分轮次)」。
- 固定前缀改为按项目上下文渲染:规则文件名来自本次 targets,工具链命令按 pubspec 的
flutter依赖在flutter/dart间切换,依赖说明区分具体子包与旧聚合包, toolkit 入口写真实package:<name>/...;纯 Dart 与--targets=claude不再拿到错误指令。 - 选场景元提示改为两段式:先选编号,再只读该场景填占位符;K-1 明确不贴固定前缀;
A-2 / E-2 / F-2 补同会话 / 交接材料;默认工作流补
F-3。 - 升级场景按子包版本填写(不再假设单一 w_tools 版本);
E-1补 ui / toast / app / async 入口、P0/P1/P2 定义与 explain 查旧 API 步骤;自检表要求标✅/N/A/❌。 - 自检表收敛为全文唯一一份(§3),各场景正文不再另抄;默认输出契约上收到固定前缀, 场景块只写差异。
- 模板头部写明「生成物 +
init --force无备份」,并提示项目自有提示词另存。 init/doctor/context/explain/feedback的 help、运行提示、doctor fix 与 example 统一写dart run w_tools_cli:w_tools <cmd>;兼容入口只在 dispatcher 说明里保留。doctorR1 文案改为“根包已不再聚合 app / map / qr”,地图改指向w_tools_map_google。doctorR8 纳入.w_tools/AI_PROMPTS.md;--write-config的 help 与docs/conventions.md改为“已存在报错,加--force覆盖”。context的 commands 补list/explain;list在 prompt/json 下也给出工具包教学入口;feedback search拒绝未知包;explain多匹配改为退出 1,JSON 增加ambiguous。AI_PROMPTS的升级场景改为按包和版本查找 migration,不再只写<pkg>-<major>.md。- catalog 给
WAsync补tryRun/run/map/retry方法别名,explain可精确命中。 - 抽出
ProjectPubspec/GeneratedFiles/ConditionalTemplate,统一 pubspec 读取、 生成物清单与@if渲染;生成器拒绝行内 marker,并修 Windows 相对路径分隔符。 init --force不再覆盖.w_tools_doctor.yaml;新增init --force-config显式覆盖 项目配置,覆盖前按.bak/.bak.<timestamp>备份,连续覆盖不丢旧备份。doctor --write-config --force复用同一轮转备份逻辑;help / README / conventions 写明.bak与.bak.<timestamp>。
Fixed #
- 裁剪后不再出现悬空引用:
A-1的lib/app/ui/、E-1的能力清单、F-1的 migration 文档出处、I-1的 device 段都改成按能力裁剪或条件句;H-1的编号跳号已消除。 doctor统一写--format=json,不再与 AGENTS 的--json混用。--targets=claude|cursor|copilot时 AI_PROMPTS 不再引用未生成的AGENTS.md。- 纯 Dart 项目不再生成
flutter analyze/flutter test/flutter pub upgrade。 - 子包 import 规则与 AGENTS / doctor R2 例外对齐:toolkit、
lib/app/ui/、lib/app/design_system/允许直接 importpackage:w_tools_*。 context在仓库检出、workspace 包不在pubspec.lock时不再显示“(无)”。
Added #
- AI_PROMPTS 契约测试补齐:每个 feature 关闭后不得引用被裁掉的场景编号、填空表存在、
固定前缀自足、
I-1不再指向不存在的 device 段。 check_prompt_docs.py把packages/cli/templates/ai/*.md纳入提示词手册级检查 (flag / 占位符 / 场景编号双向);场景标题正则收紧为「必须带点」,避免## A filled-in example被误判成场景 A;§1同时接受中英文标题。- 测试覆盖 AI_PROMPTS 的 targets / 纯 Dart / 聚合包上下文渲染,以及未知占位符不泄漏。
- 新增 CLI-001~012 回归测试:旧入口扫描、R1/R8、context commands、list prompt/json、 feedback search、explain 多匹配、migration 路径、仓库检出文案、生成器行内 marker。
- 新增 CLI-DOC-001~005 回归测试:
--force保留配置、--force-config备份/轮转、 check/drift 对配置的行为。
1.14.0 #
Changed #
- 未捕获异常不再以「255 + 栈」结束:统一输出错误信封,配置 / 文件问题退出码 2,
外部工具 / 未知问题退出码 3;
explain/context/doctor的错误在--json下也输出 JSON。 doctor --print-config/--write-config支持--json;--force必须配合--write-config。explain --format=prompt补「不要用于」段,和 text 格式对齐。list/explain/doctor/feedback path|status|search的 JSON 输出补schema/schemaVersion。feedback的包清单补app_getx/map_google,path与submit共用同一份; 本地查重不再把README.md/TEMPLATE.md当反馈。feedback submit --issue:gh未安装 / 未登录退出码改为 3(外部不可用),不再抛栈。init的toolkit_entry必须是项目内相对路径,拒绝绝对路径与..。init生成的 toolkit / UI starter / device 模板统一改用w_tools_cli:w_tools <cmd>。- doctor 缓存
SourceFile、R4 单次遍历;R3 的Color(...)与 R6 的单位不再匹配字符串字面量 (fromHex('#...')仍按字符串匹配)。 list --package=<工具包>给出docs/agents/ README 的专门提示。
Fixed #
feedback --ledger在索引缺失时先失败,不再留下「有台账、没索引」的半截状态。init的needsPubspec/ 下一步提示改由InitReport.pubspecNeeded驱动,不再解析提示文案。
1.13.0 #
Changed #
init生成的w_tools_ui约束同步到^7.0.0,UI 模板补充WImageTheme/WImageSlots/WImageSource.resolve规则。init生成的w_tools_map_google约束同步到^2.0.0(WMapConfig→WMapOptions)。init生成的全部子包约束改为与仓库当前版本完全一致;修正w_tools_device仍生成^0.1.4(当前 0.2.0)的漂移,测试覆盖全部subpackageConstraints与 device。context在 w_tools 仓库检出内标记repoCheckout并跳过消费方 doctor, 不再把根包聚合依赖误报成 6 个 error。explain读取pubspec.lock,输出包版本与对应版本的 pub.devAPI 文档; 仓库文档链接仍指向main,但会与包版本并列展示。- catalog 的
WButton示例不再默认推荐WButtonStyles,并补「项目页面优先 AppButtons」pitfall。 init的 zh / en async 模板统一分页规则为WAsyncPagedController(中文版此前仍写 「loadMore 自己维护」),与仓库docs/agents/async.md对齐。context在仓库检出、没有可匹配的已安装包时输出「已安装:(无)」,不再打印空值。- catalog 的
WText说明把WTextConfig标成「已移除」,让文档门禁能识别这是删除说明而不是推荐。
1.12.0 #
1.11.1 #
Fixed #
- Figma AGENTS 模板补全
fetch file/fetch images/get/me/usage/cache/budget/help/version命令,并同步templates.g.dart。
1.11.0 #
1.10.0 #
Added #
init默认生成.w_tools/AI_PROMPTS.md:消费者版 AI 任务提示词。- 新增
--ai-prompts / --no-ai-prompts;--no-instructions时自动关闭。 - AI 提示词纳入
--check/--check-drift/ manifest,升级后可发现缺失或漂移。 - 消费者提示词覆盖新页面计划、列表分页、表单、接口、审计、升级、调试、测试与自检; form / api 场景按项目启用能力条件生成。
- 文件开头增加“先选场景”速查表与“让 AI 帮我选场景”的新手元提示词。
- 场景表随 form / api 能力裁剪;
--ai-prompts与--no-ai-prompts冲突时报错。 - 已有项目升级后
init --check会报告 AI_PROMPTS 缺失;运行一次 init 或用--no-ai-prompts关闭。
Fixed #
- 消费方 form AGENTS 模板移除已删除的字段
config说明。
1.9.17 #
Fixed #
- 新增统一入口
dart run w_tools_cli:w_tools <command>;旧的 6 个 bin 保留兼容。 init的 app/map 依赖片段更新为w_tools_app_getx+w_tools_map_google。- 统一退出码约定:
0成功 ·1findings ·2参数/配置 ·3外部不可用。 init --check --force不再写.w_tools_doctor.yaml/ 生成.bak;只报 drift。- 自定义
toolkit_entry现在会同步进 AGENTS 的 import 路径。 feedback --json的缺字段/参数错误也输出 JSON(ok:false)。- 参数解析错误在
--json下输出 JSON,而不是只写 stderr。 - 修正
init --help/ README 的 device 生成物描述与反馈命令表。
1.9.16 #
修复 #
- 移除
tool/device_smoke.dart默认生成;Tab 冒烟移到packages/device/example/tool/device_smoke.dart, 不再假定 5 个 tab / 94% 高度。 docs/agents/device-testing.md模板改为通用设备命令/矩阵,移除 GetX、bootstrap 路径、会员卡等业务假设。- 旧
--device-test/tool/device_smoke生成物只提示 stale,不自动删除。 feedback path --json在消费方返回kind=disabled/path=null,不再返回旧本地收件箱路径。- 根
AGENTS.md的消费方反馈说明改为“默认关闭;feedback.issue: true后--issue”,移除--local/ 预填链接。 init旧设备文档提示按当前 device 状态给出--device --force-starters或--force-starters。--device-testdeprecation 警告进入warnings(JSON 可见),不再只写 stderr。
1.9.15 #
变更 #
--device-test标记为 deprecated:仍可传入(不会 unknown option),但只按--device生成设备工具并提示;不再生成通用 UI keep-alive integration_test。--device只生成设备工具,并补w_tools_device依赖;keep-alive 示例移到packages/ui/example/integration_test/+docs/recipes/keepalive-integration-test.md。- 旧版生成物
integration_test/app_keepalive_smoke_test.dart仅提示 stale,不自动删除; 旧docs/agents/device-testing.md若仍含--device-test,init会提示用--force-starters更新。
1.9.14 #
修复 #
- 严格判定 w_tools 仓库:必须
pubspec name=w_tools+packages/cli+docs/feedback/; 消费方自带docs/feedback/不再被误写。 - 包名白名单:拒绝
foo等未知包,避免污染台账索引。 feedback submit无通道时在读取正文前直接跳过;--linked-issue=<n>写台账关联 issue。- 新增
feedback status查看 ledger / issue / disabled。 - 错误提示改为
feedback submit --template(不再指向消费方不存在的仓库文件)。 --issue文档明确需要已安装 gh(gh 读取 token 或登录态)。init检测到w_tools_device依赖时自动生成设备 starter /docs/agents/device-testing.md;--no-device可关闭,禁用时给出提示。context.commands暴露deviceList/deviceShot/deviceForeground(安装 device 时), 并把 feedback 命令改为feedbackStatus/feedbackSubmit。- device README / pubspec 描述增加平台支持矩阵(iOS 真机仅 list/shot)。
1.9.13 #
新增 #
feedback submit默认策略:本地docs/feedback/存在 → 直接写台账;否则.w_tools_doctor.yaml的feedback.issue: true→ 建 Issue;都不满足 → 跳过(exit 0)。feedback submit --ledger:仅 w_tools 仓库检出可用,直接追加docs/feedback/<包>.md, 自动创建缺失包的台账并更新索引待处理数量。feedback submit --issue:显式创建 Issue(覆盖配置);--gh保留为别名。.w_tools_doctor.yaml新增feedback.issue(默认 false);生成 AGENTS 改为“默认关闭”。
1.9.12 #
新增 #
feedback submit:校验必填字段,默认生成 GitHub 预填 issue 链接(不上传);--gh直接建 issue,--local离线写收件箱,--json机器可读。feedback search:本地台账/收件箱查重;--gh同时搜 GitHub issues。templates/agents的使用反馈改为search → submit闭环,收尾必查。- 新增
.github/ISSUE_TEMPLATE/feedback.md;docs/agents/cli.md/ feedback 台账说明同步。
1.9.11 #
改进 #
init生成的子包约束同步本轮大版本:core ^3.0、ui ^5.0、form ^4.0、api ^5.0、 app ^2.0、map ^2.0、toast ^2.0、async ^3.0;新增--reset。init始终沿用.w_tools/init.json的 profile/targets/lang,--force不再静默重置; 收尾按状态给 next actions,不再无条件doctor。init --json带 schema/schemaVersion/needsPubspec/nextActions,文件条目改为{path, note}。doctor的rules:开关对 R1–R5/R7/R8 真正生效;R7 fix 使用真实版本约束;--write-config冲突退出码改为 2。list无匹配退出码改为 1;feedback缺子命令给出用法并退出 2;统一--format/--json。context --json;doctor issue 带fix;prompt 只列 w_tools/直接依赖并按优先级截断。- 文本扫描统一去掉块注释 / raw string;
ignore支持**;R3 识别 8 位 alpha 颜色。 feedback lint校验已修复版本号 / 不修理由。- 组件目录:
WRoute条目改为WRouteStack,移除已删除的 UI 组件引用。 - 新增
docs/agents/cli.md。
1.9.9 #
新增 #
.w_tools/init.json记录generator(写这份 manifest 的 CLI 版本);老文件没有该字段也能读。validatePackageName/inboxFile提出为可测函数,补 bin 层入参校验测试 (../evil/ 大小写 / 空值;收件箱路径固定)。
1.9.8 #
改进 #
context.commands新增feedback/feedbackLint:AI 走「先拿事实」时也能发现反馈入口schema/context.v1.json补install属性(此前 additionalProperties 让它不报错但契约缺失)scripts/check_feedback.sh:缺.dart_tool/package_config.json时 exit 2(原来 exit 0 静默跳过, 等于 CI 假绿);提示先跑dart pub get
发布 #
- 首次打 tag
v1.9.8;消费方可用ref: v1.9.8代替 40 位 sha
1.9.7 #
改进 #
feedback lint:已确认条目必须链 issue(#123或链接),否则报错packages/cli/README.md新增feedback命令说明(命令怎么选表 + 子命令表)
1.9.6 #
修复 #
feedback lint --include-inbox:仓库检出时不再跳过本项目收件箱(此前该参数实际无效)feedback path --package=:校验包名(^[a-z0-9_]+$),防../穿越lintLibrary:索引里列了不存在的文件、或有文件没进索引,都会报错
改进 #
lint新增--stale-days=<n>(默认 30,0 关闭):待处理超期给警告(不影响退出码)- 字段检查改为按行首
- 字段:匹配(允许「命令 / 输入」「影响(…)」这类后缀), 不再因为正文里出现关键词就过关 - 索引正则允许数字(
e2e这类包名此前被误判「没进索引」) scripts/check_feedback.sh退化为薄包装:规则只在 Dart lint 里实现一次(避免两套规则漂移)
1.9.5 #
新增 #
w_tools_cli:feedback path [--package=<包>]:输出反馈该写到哪个文件 (库侧<repo>/docs/feedback/<包>.md,或本项目收件箱docs/agents/feedback.md)。w_tools_cli:feedback lint [--include-inbox]:校验字段齐全、状态合法、已闭环带版本号、 索引数量一致;AI 写完反馈可自检。- AGENTS 模板改用
feedback path取路径;「完成前」加一条 lint 自检。
1.9.4 #
新增 #
context --format=json新增install段:packageRoot/repoRoot/isRepoCheckout/feedbackDir。AI 据此判断「库侧 docs/feedback/ 在不在本机」,不用猜路径。- AGENTS 的「使用反馈」一节改为先跑上面这条命令取
feedbackDir;为空就只写本地收件箱。
1.9.3 #
改进 #
- AGENTS 的「完成前」清单新增一条:本次用过
w_tools_*且有卡点 → 写一条到docs/agents/feedback.md。把「记反馈」变成收尾动作,比单独一节更容易被执行。
1.9.2 #
新增 #
init生成的 AGENTS 里新增「使用反馈(给 AI)」一节:任何新项目装完 w_tools 就有 「遇到问题 → 写docs/agents/feedback.md收件箱 → 维护者同步到docs/feedback/<包>.md」的指引, 不用每个项目手抄一遍。
1.9.1 #
改进 #
init --device生成的镜像示例改名为tool/gradle-mirror.init.gradle.example: 它是「复制到~/.gradle/init.gradle才生效」的示例,原名容易被误认为已自动生效。 文档里的旧路径docs/templates/…一并修正。
1.9.0 #
1.9.10 #
Fixed #
init与 doctor 共用ProjectLayout(唯一路径来源);init现在会读.w_tools_doctor.yaml的toolkit_entry,不再与 doctor 的检查路径分叉。init --check只把用户可见生成物算作缺失:内部.w_tools/init.json与可选的.w_tools_doctor.yaml不再让 CI 假红;--check也不再写 manifest,--check-drift不会因 CLI 升级而永久失败。doctor --write-config --force覆盖前写.bak(此前会静默抹掉项目维护的 palette / banned / ignore)。feedback lint --stale-days=0真正关闭 stale 检查;非法值 exit 2 而不是静默回退 30。- R2 在
test//tool//integration_test/放行w_tools_{cli,figma,device,e2e}:tool/main_e2e.dart按文档必须直接 importw_tools_e2e;lib/仍报错。--include-tests一并扫描integration_test/。
Changed #
catalog/components.yaml成为唯一来源:gen_catalog同时生成catalog.g.dart与docs/modules/components.md的 §1~§9 表格;catalog_test校验表格新鲜度与每个别名可被explain找到(补上WStepFlow)。- 子包约束表同步
ui 3.1.0/form 2.1.0/api 1.0.2/map 1.3.0。
1.8.1 #
Changed #
- device/E2E AI 入口明确:
w_tools_e2e只放tool/main_e2e.dart,生产main.dart不 import。 .w_tools_init.json在普通 init 时始终更新(不受 --force 限制);--check 只比对。- 旧版无 marker toolkit 首次 --force 迁移时,自动把模板外的 export 追加到
w_tools:end之后,并保留.bak。
1.8.0 #
新增 #
init --device:生成设备验证脚手架(integration_test/app_smoke_test.dart、tool/device_smoke.dart、docs/agents/device-testing.md、tool/gradle-mirror.init.gradle)。init --force-starters(--force-ui别名):显式覆盖 UI / device starter,覆盖前写.bak。
修复 #
init --force不再覆盖 UI / device starter;只刷新生成物与配置。init --force覆盖.w_tools_doctor.yaml前先备份.bak。- doctor R2 / ProjectFacts 的包名正则支持数字(如
w_tools_e2e)。 - doctor 的
// w_tools:ignore/ignore-file支持 R2~R9;R3 只在未被忽略的命中上计阈值,R1 暂不支持。
Changed #
- 设备 starter 的
--force语义改为--force-starters。 toolkit.dart使用w_tools:begin/end标记块;--force只更新块内,保留项目追加项。- 新增
.w_tools_init.json记录 init flags;--check默认回放上次参数,避免参数不同导致假 drift。
1.7.2 #
1.7.1 #
Changed #
init --figma模板升级到w_tools_figma ^0.3.0,补充 frames / spec 深度 / tokens map / diff --if-stale。
1.6.1 #
Changed #
- AGENTS UI 片段补充
lib/app/ui/是项目永久 UI 层、不走 STAGED、不计划上移。 - banned 段落增加 R9 只匹配已登记 pattern 的边界说明;英文输出改为英文标题与说明。
- AGENTS base 明确先判断永久 UI 层 / 暂存层;英文 banned 条目使用 use / reason 标签。
- AGENTS closing 自动生成 doctor 规则速查表;CLI 示例改用真实
Image.asset禁用场景;CONTRIBUTING 补充 grep 检查经验。 - DoctorRule 内置中英文 summary,AGENTS 规则表与规则定义单一来源;base 去掉 no-ui 下的具体 UI 组件名。
- base 的 UI 分层说明移回 ui 片段;R3/R4 改用 TextScan,跳过行尾注释。
- doctor 规则表 summary 只描述规则;R6/R9 启用状态改由表头说明,避免 summary 混入项目状态。
- 修正 R9 示例 id 为
no-raw-image,文档索引与 AGENTS 维护说明同步为 R1~R9。 - README / conventions 增加无 CLI 时 grep 与 R1/R2/R4/R9 的映射,明确
--include-tests与 R4 的覆盖边界。 - AGENTS base 补充上移候选要求(默认值/测试/CHANGELOG)与 API 参数 ≤ 3 的形状建议。
- base 明确 CHANGELOG 由包维护者在进入 w_tools 时补;文档补充 doctor 文本级/字符串边界说明;补英文模板测试。
1.6.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补示例。 - R9 预编译 regex / 缓存 glob;banned 文档说明文本级匹配边界。
- AGENTS 模板按 app / form / api / async 能力裁剪;ui README 图片示例改用
WImage.asset。 context区分 pubspec / doctor 配置解析错误,并按项目类型输出flutter/dart命令;explain支持--root并兜底坏配置。- 新增 init 单项开关
--no-form/--no-app/--no-api;区分 pubspec.lock 解析错误。 - 抽出
ProjectFacts,让 context 与 R5/R7 共用 toolkit / 暂存层 / 依赖事实;新增--no-toast。 - AGENTS 模板拆成 base + feature 片段(ui / form / api / app / async / toast / core / qr / map / closing),去掉 full / no_ui 两套大模板。
- init 能力参数统一为
--<feature>/--no-<feature>;新增--map/--no-map,保留--with-map兼容别名。 - init 的 feature help 从注册表生成;所有 feature 正反参数冲突统一报错,JSON features 改用
toJson()。 context --format=json增加schema标识与 v1 JSON Schema;采用新增字段兼容、破坏性变化才 bump 的策略。- context schema 测试使用
json_schema校验真实toJson()输出,并用包根定位 schema 文件。 - 内部模型收敛:InitFeatures 改为 Set
- 命令层统一通过
ProjectFiles.loadConfig读取.w_tools_doctor.yaml,减少重复异常处理。 - R6 / R9 共用
TextScan文本扫描,统一跳过整行注释与行号计算。 - R9 预过滤无效 banned 条目,避免每个源文件行重复 validate。
- R6/R9 跳过行尾
//注释;R2 同时检查export package:w_tools_*。
Changed #
- 消费方 AGENTS 模板补充
WTextVariant不够用时的处理顺序:先variant + style,项目内重复抽本地 helper,稳定跨页面语义再提库内 variant。 - 组件目录同步
WText的 variant 边界说明。 - 消费方 AGENTS 模板统一间距入口:
SizedBox用WSizeBox,Padding用WPadding,EdgeInsets用num.allPadding;不再推荐num.heightBox/widthBox/squareBox。
1.5.0 #
- 已发布版本(此前的模板与文档修正;不含 1.6.0 的 R9 / schema / feature registry)。
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。