本文技术栈速览设想一个没有角标的聊天应用：消息来了，图标毫无变化，用户永远不会知道有新信息。再设想一个角标滥用成灾的应用：每个图标上挂着"99+"，用户对红点彻底免疫。两种极端之间，是角标这门"注意力管理"的艺术——角标存在的全部意义，是把用户的注意力精准地指向"哪里有事"。角标的价值可以拆成两半：红点（圆点角标）说"有"，数字角标说"有多少"。前者是"注意力开关"（一眼扫过去就知道要不要点开看看

本文技术栈速览设想一个没有角标的聊天应用：消息来了，图标毫无变化，用户永远不会知道有新信息。再设想一个角标滥用成灾的应用：每个图标上挂着"99+"，用户对红点彻底免疫。两种极端之间，是角标这门"注意力管理"的艺术——角标存在的全部意义，是把用户的注意力精准地指向"哪里有事"。角标的价值可以拆成两半：红点（圆点角标）说"有"，数字角标说"有多少"。前者是"注意力开关"（一眼扫过去就知道要不要点开看看

离线可读与读取门槛低。二维码是"离线可读"的信息载体，本文用 qr_flutter 实现了完整的二维码生成器：输入实时生成、前景/背景色自定义、纠错等级 L/M/Q/H 切换、尺寸调节、模拟扫码与保存。底层原理讲透了两把锁——纠错锁（Reed-Solomon 冗余，容错率 7%~30%）与容量锁（版本 × 纠错 × 编码模式共同决定字节上限）。默认纠错 M、长内容升版本、能放短链别放长文本、视觉设

离线可读与读取门槛低。二维码是"离线可读"的信息载体，本文用 qr_flutter 实现了完整的二维码生成器：输入实时生成、前景/背景色自定义、纠错等级 L/M/Q/H 切换、尺寸调节、模拟扫码与保存。底层原理讲透了两把锁——纠错锁（Reed-Solomon 冗余，容错率 7%~30%）与容量锁（版本 × 纠错 × 编码模式共同决定字节上限）。默认纠错 M、长内容升版本、能放短链别放长文本、视觉设

把Rating核心能力收成一张图，便于回顾：fill:#333;important;important;fill:none;color:#333;color:#333;important;fill:none;fill:#333;height:1em;Rating 评分组件值: rating 0~stars刻度: stars + stepSize面孔: indicator 输入/只读事件: onCh

把Rating核心能力收成一张图，便于回顾：fill:#333;important;important;fill:none;color:#333;color:#333;important;fill:none;fill:#333;height:1em;Rating 评分组件值: rating 0~stars刻度: stars + stepSize面孔: indicator 输入/只读事件: onCh

一个状态机idleloadingsuccesserror四态严控迁移，请求结束必须离开loading；一对时机请求发出立刻显示、请求结束立刻消失，必要时加最小展示时长防闪屏；一套守卫按钮禁用 + 入口状态判断双重防重复，请求序号比对防竞态；一句人话无内置文案，转圈旁边必须配一句说明加载意图的文字。转圈的意义，在于告诉用户：系统没有沉默，它在工作。骨架屏：内容轮廓已知的页面用色块占位替代转圈，首屏体

一个状态机idleloadingsuccesserror四态严控迁移，请求结束必须离开loading；一对时机请求发出立刻显示、请求结束立刻消失，必要时加最小展示时长防闪屏；一套守卫按钮禁用 + 入口状态判断双重防重复，请求序号比对防竞态；一句人话无内置文案，转圈旁边必须配一句说明加载意图的文字。转圈的意义，在于告诉用户：系统没有沉默，它在工作。骨架屏：内容轮廓已知的页面用色块占位替代转圈，首屏体

数据单一来源progress 是唯一真相源，百分比、已下载量、剩余时间全部由它推导，不存副本。样式即数据type/strokeWidth/color 走状态绑定，运行时可调，响应式地表达进度形态。平滑交给框架enableSmoothEffect 负责插值补帧，业务侧只做低频推进，避免高频重绘。确定给数字，不确定给动画可确定总量的任务用 Progress，未知时长的操作用 LoadingProgre

数据单一来源progress 是唯一真相源，百分比、已下载量、剩余时间全部由它推导，不存副本。样式即数据type/strokeWidth/color 走状态绑定，运行时可调，响应式地表达进度形态。平滑交给框架enableSmoothEffect 负责插值补帧，业务侧只做低频推进，避免高频重绘。确定给数字，不确定给动画可确定总量的任务用 Progress，未知时长的操作用 LoadingProgre