feat(timer): 循环训练组进度改为圆环分段弧 + 信息气泡三行合一

- progress-ring 新增 sets/currentSet/resting/successColor 属性, 圆环外圈绘制分段弧(已完成=主色/当前=呼吸光点/休息下一组=绿),单组模式零渲染 - timer 删除顶部 circuit-bar 进度面板,布局骨架三模式统一 - 呼吸环淡化(描边 0.55→0.20,柔光渐变强度减半) - 目标卡与提示气泡合并为 info-bubble,状态文案(撑住/休息中/已暂停)并入气泡顶部
2026-08-12 09:39:41 +08:00
parent 0464eeaba6
commit 05c4763e49
18 changed files with 720 additions and 497 deletions
@@ -0,0 +1,45 @@
+// 一次性脚本：清除小程序/云函数中的调试 console.* 输出
+// 安全策略：
+//  1) 箭头函数体 `const x = (e) => console.xxx(...)` → 替换为 `const x = () => {}`
+//  2) 独立 console 语句整行删除（含无分号情况）
+//  3) 收敛多余空行（>=3 个连续换行压成 2 个）
+// 删除后由调用方逐个 node --check 验证语法。
+const fs = require('fs')
+
+const files = [
+  '/Users/liubleed/Documents/wx_pbzc/utils/cloud.js',
+  '/Users/liubleed/Documents/wx_pbzc/utils/storage.js',
+  '/Users/liubleed/Documents/wx_pbzc/utils/voice.js',
+  '/Users/liubleed/Documents/wx_pbzc/utils/theme.js',
+  '/Users/liubleed/Documents/wx_pbzc/app.js',
+  '/Users/liubleed/Documents/wx_pbzc/pages/leaderboard/leaderboard.js',
+  '/Users/liubleed/Documents/wx_pbzc/pages/timer/timer.js',
+  '/Users/liubleed/Documents/wx_pbzc/pages/settings/settings.js',
+  '/Users/liubleed/Documents/wx_pbzc/cloudfunctions/leaderboard/index.js',
+]
+
+const INDEP = /^\s*console\.(log|warn|error|debug)\(.*\)\s*;?\s*$/
+const ARROW = /^(\s*const\s+\w+\s*=\s*\([^)]*\)\s*=>\s*)console\.(log|warn|error|debug)\(/
+
+let total = 0
+for (const f of files) {
+  if (!fs.existsSync(f)) { console.log('SKIP (missing):', f); continue }
+  const lines = fs.readFileSync(f, 'utf8').split('\n')
+  const out = []
+  let removed = 0
+  for (const line of lines) {
+    const a = line.match(ARROW)
+    if (a) {
+      out.push(a[1].replace(/=>\s*$/, '=> {}'))
+      removed++
+      continue
+    }
+    if (INDEP.test(line)) { removed++; continue }
+    out.push(line)
+  }
+  const cleaned = out.join('\n').replace(/\n{3,}/g, '\n\n')
+  fs.writeFileSync(f, cleaned)
+  total += removed
+  console.log(`cleaned ${removed}  ${f.replace('/Users/liubleed/Documents/wx_pbzc/', '')}`)
+}
+console.log('TOTAL removed:', total)
@@ -0,0 +1,20 @@
+# 2026-08-06
+
+## 记录页新增「里程碑」tab — 设计已锁定（尚未写代码）
+
+用户要求：在 records 页「记录日历 / 趋势」后加第三个 tab「里程碑」，展示用户锻炼旅程中的里程碑事件。
+**关键决策（用户逐项确认）：**
+- 语义=**「第一次完成任务」**，不做累计/极值（明确否决"累计X小时/累计N次""单次最久""最长连续N天"这类历史最佳）。
+- 排序=**倒序**（最新里程碑在最上）。
+- 范围=**5 家族克制版+模式首秀**：
+  1. `first_train` 第一次训练 → min(record.date)
+  2. `badge` ×7 勋章首解锁（复用 config.trainingDayBadges 的 name/iconWhite）→ 第 N 个去重训练日=解锁日
+  3. `first_duration` 时长首突破，门槛 config.milestoneFirsts.durations=[60,180,300,600]s → 正序第一条 duration≥T 的记录日期
+  4. `first_streak` 连续首突破，门槛 config.milestoneFirsts.streaks=[7,14,30] → 正序扫去重日期，连段首次达 N 的当天
+  5. 模式首秀：`first_circuit`（首条 mode==='circuit'）、`first_plan`（首条 day>=1 的计划训练）
+- 节点**不可点**（纯展示）。
+- 视觉：竖向时间线（实色圆+白图标+右侧卡），顶部汇总卡+底部"下一个目标"条；空态复用页面级 totalSessions===0 引导。
+
+**架构（待实现）：** 新建 `utils/milestones.js` 纯函数 `computeMilestones(records)` → 倒序事件数组；改 records.js/wxml/wxss（contentMode 增 'milestone'）；config 增 milestoneFirsts。全部从现有 training_records 推导，**零存储/云函数改动**。
+**图标：** 节点用 *White 变体（playWhite/boltWhite/formWhite/各 badgeWhite 等）；timeWhite、repeatWhite 实现时各加一行或复用现有白图标。注意组件 style isolation 陷阱——图标色烤死在 SVG，必须用 *White。
+**状态：用户选择「再调整一下」，暂未批准写代码。** 下一步：与用户敲定文案/门槛/配色后实现。
@@ -0,0 +1,22 @@
+# 2026-08-07
+
+## 里程碑 tab 设计校正：时长维度改为「单次最长时间」
+
+用户纠正先前理解偏差：时长里程碑要的是**单次最长时间（个人最佳）**，不是"首次突破 X 分钟"的阈值事件。
+这其实与用户最初原话"什么时间单次坚持最长"一致；之前被带偏成 `first_duration` 阈值家族。
+
+**校正后的家族（6 类）：**
+1. `first_train` 第一次训练 → min(record.date)
+2. `badge` ×7 勋章首解锁（复用 config.trainingDayBadges）→ 第 N 个去重训练日=解锁日
+3. `longest_plank` **单次坚持最久**（个人最佳）→ argmax(duration)，取该记录日期+时长；**含循环**（circuit 的 record.duration=workTotal 已排除休息，公平）。属「个人最佳」类，与其余「第一次」类并列。
+4. `first_streak` 第一次连续打卡 N 天 → 门槛 config.milestoneFirsts.streaks=[7,14,30]
+5. 模式首秀：`first_circuit`、`first_plan`
+
+**config 变化：** `milestoneFirsts` 去掉 `durations`（不再有时长阈值）；仅保留 `streaks:[7,14,30]`。
+`longest_plank` 无需阈值配置，直接取全量记录 max(duration)。
+
+**待定细节（已向用户提出）：** `longest_plank` 是「1 个节点=当前历史最长（若被刷新则更新日期）」，还是「每次刷新纪录都记一个节点（PR 进阶时间线）」？默认按前者（最贴合"单次最长时间"语义）。
+
+## 顺带诊断：模拟器 vs 正式版连续打卡不一致
+
+streak 是本地缓存计数器（`current_streak`），`validateStreak` 普通启动只信任旧 count、不重算；`recomputeStreak` 仅删记录/云端恢复时跑。模拟器与真机是两套隔离存储沙箱，且 streak 不随记录并集自动对齐 → 4天 vs 2天属预期差异。根治=启动即 `recomputeStreak()`。用户尚未批准改代码。
@@ -0,0 +1,102 @@
+# 2026-08-11
+
+## 首页顶部问候区加入用户头像与昵称
+- 在 `pages/index` 顶部问候区（"准备好了吗"）左侧新增圆形头像 + 昵称（昵称默认"运动达人"）。
+- 数据来自 `storage.getProfile()`（{ nickname, avatarUrl }），在 `refresh()` 中读取，每次 onShow 刷新（settings 改完回首页即更新）。
+- 头像圆形裁剪用双保险：外层 `overflow:hidden` + 内层 `image border-radius:50%`；无头像回退 `icons.peopleFill` 人形占位。
+- 改动文件：index.wxml（greeting-row 结构）、index.wxss（横向 flex 布局 + 头像样式）、index.js（data 加 nickName/avatarUrl、refresh 读取 profile）。`node --check` 通过。
+
+## 首页问候区样式调整（同一轮）
+- 删除原来的 emoji/success 状态小图标（greeting-icon），昵称嵌入问候句前置并加逗号：`{昵称}，准备好了吗？` / `{昵称}，太棒了！`（完成态）。
+- 昵称默认"运动达人"。删除 .greeting-nickname / .greeting-text / .greeting-icon 旧样式，标题与昵称同行同字号（40rpx 加粗）。头像仍在左、副标题在下。grep 确认无旧类名残留。
+
+## 循环训练秒数步进改为 ±10 秒
+- `pages/index/index.wxml` 循环训练弹窗：「每组时长」(hold) 与「组间休息」(rest) 的 stepper `data-delta` 由 ±5 改为 ±10；组数、每周目标（非秒数）不变。
+- JS `onCircuitStep` 的 bounds（hold 下限5 / rest 下限0）无需改，越界自动 clamp。
+
+## 首页 index 整体改版（参考 plank-training.html，方案 B 橙色系）
+- 结构重构（纯视觉/布局，不动训练/记录/设置逻辑）：全宽橙渐变 `hero`（头像+昵称+按小时时间问候+「时长」敢不敢来挑战+🔥真实连胜）→ `quest-card` 进度点地图（白卡负 margin 上浮叠 hero，圆点+连线，done/now/final 三态，末节点🏆）→ `dial` 虚线刻度环+呼吸动画（目标时长+预计千卡）→ CTA「立即挑战+时长」带脉冲 → 次级入口自由/循环。
+- 取消每日语录模块（用户要求）。
+- 配色：方案 B，hero 渐变用 `var(--primary)→var(--primary-light)`，随主题切换变色，保持橙色品牌。
+- hero 用 `margin:-24rpx -24rpx 0` 抵消 container 内边距实现全宽；opacity-only 动画避免 transform 破坏弹窗定位。节点地图自适应：计划天数<=8 画每天节点，>8 退化为 5 里程碑节点。
+- JS 新增 `greetText/streakText/questNodes/questTip/estKcal` 字段 + `_greetByHour()`/`_buildQuestMap()`；移除 `useSegments/planDays/planProgress`。`node --check` 通过；grep 确认旧类名(greeting-/header-card/streak-/segment-/milestone-/target-/useSegments 等)零残留。
+- 注意：改版前已先 `git commit`（938a7d1）。本次改版尚未提交，待用户预览确认后再提交。
+
+## 首页改版微调（同一轮）
+- 千卡估算修正：从 4 千卡/分钟 降至保守 2.2 千卡/分钟（1分30秒≈3千卡），仅作激励参考非精确值。
+- 删除「预计消耗」后「· 核心力量 +1」文案；整行放大（24→28rpx，数字 30rpx）。
+- 连胜文案「🔥 已连续 N 天打卡」从 hero 底部独立行移到顶部头像+昵称行内（昵称下方），新增 `.hero-user` 纵向堆叠容器。
+
+## 首页改版微调（第2轮）
+- 千卡恢复 4 千卡/分钟（用户确认）。
+- 删除「今天还没开始，现在就稳住核心」整段（含已完成态「今日已完成 N 秒」），同步删除 `.today-status`/`.done-text`/`.pending-text` 样式；CTA 按钮仍用 `todayDone` 切换「立即挑战/再战一次」文案。
+- 连胜文案从「昵称下方」改为「昵称同一行后面」：`.hero-user` 改 `flex-direction: row` + `align-items:center` + `gap:14rpx`，`.hero-social` 上间距归零。
+
+## 首页改版微调（第3轮）
+- 计时环整体放大：`.dial` 280→320rpx；计时数字设计字号 84→96（`index.js` 数据默认值 + `_readFontScale` 的 DESIGN 常量，clamp 上限同步 96），`.dial-time` max-width 240→280rpx 防溢出。
+- 删除连胜前 🔥 图标（WXML `hero-social` 改为纯文案）。
+- 连胜字号与昵称对齐：`.hero-social` 26→28rpx（与 `.hero-greet` 一致）。
+
+## 首页改版微调（第4轮）
+- 进度地图(`quest-card`)与「立即挑战」CTA 按钮等宽：`.quest-card` 左右 margin 由 24rpx 改为 0（容器自身 24rpx 内边距已让两者贴合内容区边缘），保留 `margin-top:-56rpx` 上浮叠 hero。
+
+## 训练页(timer)改版（参照用户截图，方案：var(--primary) 主题色 + 无顶部栏）
+- 顶部栏按用户要求取消（不画 sound/pause 图标行）。
+- `components/progress-ring` 扩展：canvas `_draw()` 新增秒刻度层（ticks 属性=秒数，cap 60；四分位加粗、其余细灰）；环内新增 `subText`（副标题，如"目标 30秒"）；移除组件内 statusText 渲染（状态词改由 timer 页在环下方显示）。
+- timer.wxml：progress-ring 传 `ticks="{{ringTicks}}"` `subText="{{ringSubText}}"`；原 hint-section 替换为「环下方状态词 timer-status + 目标信息卡 goal-card(✅今日目标 X · 第N天 ›，静态箭头) + 运行提示 timer-tip」。
+- timer.js 新增派生字段 ringTicks/ringSubText/statusText/goalLine/runningTip，在 _init/_initCircuit/onStart/onPause/onStopCancel/onTrainAgain/各 onTick/onGoalReached 中计算下发；新增 `_durationText(sec)` 语音化时长(45→"45秒",90→"1分30")。
+- timer.wxss：新增 .timer-status/.goal-card/.timer-tip 样式；.timer-page 改 justify-content flex-start + .controls margin-top:auto（按钮贴底）；删除旧 hint-section/hint-row/hint-text/running-pulse/completed-bounce 样式。
+- 状态机(idle/running/paused/completed/circuit/free)、计时逻辑、循环 FSM、呼吸环、彩带、完成弹窗、结束确认弹窗全部保留。node --check 通过；grep 确认 hint-*/status-text/running-pulse/completed-bounce 零残留。改版尚未提交。
+
+## 训练页姿态提示醒目化（气泡卡片）
+- 用户要求训练中的姿态提示更醒目。原 `timer-tip` 仅为 26rpx 灰字无修饰。
+- 改为「气泡卡片」：白底 + 主色左边框(8rpx) + 圆角 + 轻投影 + 顶部小三角指向圆环 + 左侧人物主题色图标(peopleFill) + 文字放大(26→30rpx 加粗)；持续 tipPulse 呼吸动画(scale 1↔1.03)。
+- 语义分级：tipType=posture(默认/主色)｜phase(循环阶段,主色)｜done(目标达成,成功色+successFill 图标)。timer.js 在 _init/_initCircuit/onTrainAgain(默认 posture+peopleFill)、single onTick(goalReached→done/successFill 否则 posture/peopleFill)、onGoalReached(done)、circuit onTick(phase/peopleFill) 设置 tipType+tipIcon。
+- 图标用现成 `peopleFill`(主题色人物,白底醒目)，done 用 `successFill`；不手画新增 path(规避 SVG data-URI 色烤死/渲染风险)。node --check 通过；字段引用一致。改版(含前次 timer 重构)于 commit 0464eea 提交。
+
+## 训练页圆环放大 + 环内间距调整
+- 用户反馈圆环与中间时钟太贴近。timer.wxml 中 progress-ring `size` 360→420、ringWidth 保持 22（环整体放大、环内边到时钟间隙约 23→53rpx 提升）。
+- timer.wxss 呼吸光晕同步放大（breathe-ring-1/2/3：520/440/380 → 620/540/460rpx），确保光晕仍罩在更大环外侧。
+
+## 训练页呼吸光环 + 光晕增强（明显可见）
+- 用户要求光晕与呼吸明显可见。新增 `.breath-aura` 呼吸光环：进度环外侧 488rpx 直径、6rpx 主色描边(0.55 alpha) + 40rpx 外辉光 + inset 28rpx 内辉光；@keyframes auraBreathe 2.8s 慢呼吸(scale 0.9↔1.06, opacity 0.5↔0.95)，running 切 auraBreatheFast 1.3s。timer.wxml 在 ring-wrapper 内 progress-ring 前新增该 view（带 fast 类切换，completed 态 wx:if 隐藏）。
+- 现有径向光晕透明度大幅调高：base 0.10→0.20、ring-2 0.14→0.26、ring-3 0.18→0.34，淡出半径 65%→62~68%。
+- 纯 CSS transform/opacity 动画，不碰 canvas/进度环组件/状态机；z-index:0 在 progress-ring 之下、可见带在环外侧无遮挡；transform 仅作用于光环自身，不影响 fixed 弹窗（现有 breathe-ring 同机制已验证）。
+- 已渲染动画预览 widget 演示可见度。未提交，待用户预览确认。
+
+## 训练页呼吸光环柔和化 + 圆环下方整体下移
+- 光环柔和化：scale 幅度 0.9↔1.06 缩至 0.96↔1.04、opacity 峰值 0.95/1.0 降到 0.85/0.9、节奏放慢（idle 2.8s→4s、running 1.3s→2.4s）。
+- 圆环下方元素（状态词/目标卡/提示）整体下移：.ring-wrapper 加 margin-bottom:44rpx；.controls margin-top:auto 贴底不受影响。
+
+## progress-ring 刻度四分位对齐修复（bug）
+- 现象：ticks(=训练时长,cap 60)不被 4 整除时,长刻度按 `i % round(ticks/4)===0` 判定落点,只有顶部(12点,i=0)正中,其余 3 根偏到 96°/102°/198° 等。
+- 修复：长刻度改精确画在 12/3/6/9 点 4 个正方向(不依赖 tick 索引整除)；短刻度在靠近四分位(角度差<一格 stepDeg=360/ticks)处跳过,避免与长刻度双线重叠。ticks 是否整除 4 都对齐正中。
+- node --check 通过。未提交。
+
+## 首页时间圆环改为大字流光时间（无圆环）
+- 用户认为 index 计时环用处不大，去掉圆环，目标时长改用大字「渐变流光动感数字」显示（选中的风格）。
+- index.wxml：删 `.dial` 圆环整块，改 `<text class="time-display">{{todayTargetText}}</text>` + `<text class="time-label">今日目标时长</text>`，保留「预计消耗 X 千卡」。
+- index.wxss：删 `.dial/.dial::before/.dial-time/.dial-label/@keyframes ringBreathe`；新增 `.time-display`(120rpx/900/letter-spacing -2rpx/tabula-nums + 渐变 background-clip:text + timeShimmer 3s 流光, 跟随 var(--primary)/var(--primary-light) 主题色) 与 `.time-label`。含 `color: var(--primary)` 兜底。
+- index.js：删 `targetTimeFontSize` 字段与 `_readFontScale()` 方法(onLoad 调用一并移除)——那是给圆环内数字防系统字号缩放溢出的专用逻辑,无圆环不需要。
+- grep 确认无 `dial` 类残留(仅 hero::after 的 radial-gradient 误匹配"dial"子串、与圆环无关);node --check 通过。未提交。
+
+## 训练页布局：时钟居中 + 按钮贴底留白
+- 用户要求：把底部 3 个按钮（开始／暂停·结束／继续·结束）下移到屏幕底部（以底部 toolbar 为基础），留出空间，时钟(进度环)挪到中间区域。
+- 确认 timer 不是 tabBar 页面（tab 仅 index/records/leaderboard/settings），无需额外预留 tabBar 高度；"底部 toolbar"指屏幕底部区域。
+- 结构改动 timer.wxml：将 `ring-wrapper` + `timer-status` + `goal-card` + `timer-tip` 整体包进新 `<view class="middle-area">`，controls 仍在外部独立贴底。
+- 样式 timer.wxss：新增 `.middle-area { flex:1; width:100%; display:flex; flex-direction:column; align-items:center; justify-content:center; min-height:0; }`，使整组(进度环+状态/目标/提示)在剩余高度内垂直居中，与底部按钮之间自然留白；.controls 仍 `margin-top:auto` 贴底。circuit-bar 保持顶部。
+- 纯布局重构，未动进度环组件/状态机/计时逻辑/动画。未提交。
+
+## 首页布局：时钟居中 + 3 按钮贴底（修正）
+- 误判：上轮把同样的"中间展示区"思路套到了训练页(timer)。用户截图与反馈(`@image#1`)是首页 index，把 3 个按钮(再战一次/自由训练/循环训练)推到屏幕底部(贴近 tab bar)、时钟(00:30)挪到中间区域。
+- 撤销对 timer 的误改：timer.wxml 移除 `middle-area` 开闭标签，timer.wxss 删除 `.middle-area` 规则；grep 确认 timer 无 `middle-area` 残留。
+- index 改动：index.wxml 根容器加 `index-page` 类（不动全局 `.container`，仅本页面升级为 flex 列）。index.wxss 新增 `.index-page{display:flex;flex-direction:column;}`；`.timer-wrap` 改为 `flex:1;display:flex;flex-direction:column;align-items:center;justify-content:center;min-height:0;text-align:center`（垂直居中"00:30 + 今日目标时长 + 预计消耗 千卡"）；`.action-buttons` 加 `margin-top:auto`（贴底）。hero 的负 margin 与 quest-card 的 -56rpx 上浮叠在 flex 列里仍生效。
+- 效果：hero+quest 在顶 → 中间留白 + 时钟居中 → 留白 → 3 按钮贴底紧挨 tab bar 上方。
+- 未提交。
+
+## 首页时间字体改为 Saira Condensed 900（base64 内联）
+- 用户认为 Orbitron 不够硬朗，从 6 款硬朗字体对比中选择 Saira Condensed 900。
+- **关键修复**：微信小程序 `@font-face` 的 `src:url('./local.woff2')` 本地相对路径**不可靠**（devtools 可能假性生效、真机回退系统字体）。之前 Orbitron 用本地路径加载，用户反馈"区别很大"=字体实际没加载。**治本方案**：把 woff2 转 base64 data URI 直接内联到 `@font-face` 的 `src`，不依赖任何外部文件/网络，devtools 和真机一致。
+- app.wxss `@font-face`：`src:url('data:font/woff2;charset=utf-8;base64,<24KB>')`，font-family:'Saira Condensed', font-weight:900。原 woff2 文件（17.7KB）已删除，不再随包冗余。
+- index.wxss `.time-display`：`font-family:'Saira Condensed','Arial Narrow',sans-serif`；`font-weight:900`；`letter-spacing:2rpx`(Saira Condensed 偏窄,小间距即可)。渐变流光 + drop-shadow 阴影不变。
+- node --check 通过。未提交。
@@ -0,0 +1,64 @@
+# 2026-08-12 工作日志
+
+## 循环训练页遮挡问题分析与 redesign 规划
+- 读取 `pages/timer/timer.wxml/wxss/js`，定位循环训练态（circuit mode）布局。
+- 问题根因：`.timer-page` 为 `flex column` 且 `min-height: 100vh` 但无滚动，中间圆环 420rpx + 多层呼吸环 488/620rpx + 顶部卡片 + 状态文字 + 目标卡 + 提示气泡的总高度在小屏/大字体下容易超过视口；底部 `.controls` 用 `margin-top: auto` 贴底，结果会被内容顶出可视区域或被安全区截断。
+- 规划方案（未改代码）：
+  1. 圆环从 420rpx 缩到 340rpx，呼吸环同步缩小。
+  2. 顶部卡片内嵌组进度条，组数/阶段/配置摘要合一，减少一层垂直空间。
+  3. 状态文字与圆环内副标题、目标卡与姿态提示错位排布，避免信息重复。
+  4. 底部控件固定高度 + `padding-bottom: calc(32rpx + env(safe-area-inset-bottom))`，保证始终在安全区上方可见。
+  5. 整体改为 `justify-content: space-between` 的 flex 布局，顶部-中部-底部三大块按可用空间分配。
+- 已输出 SVG 线框图，待确认后再落地代码。
+
+## 方案修正（用户反馈：timer 页是公用页面，仅循环模式有组进度条）
+- 用户指出原规划把页面当"恒有顶部卡片"设计，切换模式重心会跳。
+- 修订方案（未改代码）：**组进度从独立顶部面板改为「圆环外圈分段弧」**——
+  - 在 `progress-ring` canvas 里加 sets/currentSet/isResting 属性，track 环外侧画一圈分段弧（已完成=主色、进行中=主色+端点光点、未开始=浅灰、休息时下一段=success 绿）。
+  - 单组/自由模式不传 sets → 不渲染分段弧，页面结构与现状完全一致，零影响。
+  - 圆环内副标题循环模式显示「第 X/Y 组」，单组显示「目标 X」。
+  - 组数 >15 时退化为圆环下方细线进度条。
+  - 顶部 circuit-bar 面板（wxml 20-53 行、wxss 15-225 行）整个删除，垂直空间全部还给圆环区与底部控件，从根上解决遮挡。
+- 已确认 `components/progress-ring` 为 canvas 2d 实现（_draw() 内 ctx.arc/stroke），扩分段弧同套 API，可行。
+
+## 落地：循环训练组进度改造（用户批准后实施）
+- **`components/progress-ring/progress-ring.js`**：
+  - 新增属性 `sets/currentSet/resting/successColor`（sets<=0 时零渲染，单组/自由模式不受影响）。
+  - 新增 `_drawSetArcs(pulse)`：track 环外侧画分段弧（arcR = radius + ringWidth/2 + 3rpx，弧宽 8rpx，段间隔 2.5°）。三态：已完成=primaryColor、进行中=primaryColor+端点光点、休息时下一段=successColor('#00B578')，未开始=trackColor。
+  - 呼吸动画用 `canvas.requestAnimationFrame` 循环（周期 1.6s，sin 相位），只清外圈环带（clip 环形避免碰内圈倒计时弧）；paused 时冻结为静态；`detached` 时 cancel。
+  - `_draw()` 末尾补调 `_drawSetArcs(_setPulsePhase || 0.6)`，保证每秒全量重绘后分段弧仍在。
+- **`pages/timer/timer.wxml`**：删除整个 `circuit-bar` 面板（原 18-53 行）；`<progress-ring>` 新增 `sets="{{totalSets}}" currentSet="{{currentSet}}" resting="{{isResting}}"`。
+- **`pages/timer/timer.js`**：删除 `circuitDots/circuitShowDots/circuitTotalWork/dotsDone/dotsActive/dotsNext` 字段与 DOTS_MAX 点阵构建；onTick 由 dots* 改为 `ringSubText: 第 X/Y 组`；_initCircuit 的 ringSubText 改为 `共 X 组 · 休息 Y 秒`（rest=0 省略休息段），goalLine 保持 `每组 X · 共 Y 组`。
+- **`pages/timer/timer.wxss`**：删除全部 circuit 样式（.circuit-bar/.circuit-dots/.circuit-track/.circuit-meta/.circuit-count/.circuit-phase/.circuit-sub 等）。
+- **落地时的设计决策**：组数上限 50（_int clamp），环形 360° 空间充裕，50 段也不挤线（旧 DOTS_MAX=15 是横向卡片宽度受限），故**不做数量降级**；原方案"组数>15 退化线性条"在环形下无必要。
+- 验证：node --check 通过；grep 无残留代码引用（仅注释说明文字）。
+
+## 呼吸环淡化（用户反馈"圆线条太明显"）
+- `timer.wxss` 的 `.breath-aura`：border 6rpx/0.55 → 4rpx/0.20；box-shadow 外层 40rpx/0.45 → 30rpx/0.22、内层 28rpx/0.22 → 20rpx/0.10；auraBreathe 透明度 0.55↔0.85 → 0.30↔0.50，fast 版 0.6↔0.9 → 0.34↔0.55。
+- `.breathe-ring` 三档径向渐变强度：0.20/0.26/0.34 → 0.13/0.17/0.22，柔光更淡雅，不与倒计时环抢视觉。
+
+## 目标卡与提示气泡轻量化（用户反馈"两个提示框不好看"）
+- 问题：`.goal-card` 是白底卡片+右箭头，看起来像可点按钮但无 tap；`.timer-tip` 是白底气泡+左侧绿条+上方小三角+呼吸阴影，与目标卡叠在一起视觉噪音大。
+- `timer.wxml`：删除 `.goal-card` 中的右箭头 `goal-arrow`。
+- `timer.wxss`：
+  - `.goal-card` 改为轻量胶囊标签：`inline-flex`、主色 8% 淡底、无边框无阴影、圆角 999rpx；padding 24→14rpx/24rpx；图标 40→32rpx；文字 28→26rpx、权重 600→500、主色。
+  - `.timer-tip` 改为药丸标签：去掉 `border-left`、小三角、box-shadow、tipPulse 呼吸动画；背景主色 8% 淡底（done 态 success 10%）；padding 20/32→12/24rpx；圆角 999rpx；图标 40→30rpx；文字 30→26rpx、权重 600→500。
+- 验证：grep 无 `goal-arrow/tipPulse/timer-tip::before/border-left: 8rpx` 残留。
+
+## 目标卡 + 提示气泡合并为单气泡（用户反馈"字体小了、能否合并、页面三模式公用"）
+- 新结构 `.info-bubble`（timer.wxml/wxss）：一张主色 8% 淡底圆角卡，两行——
+  - 上 `info-line--goal`：target 图标 + goalLine，26rpx/500/主色（静态摘要，常驻）
+  - 分隔线 `info-divider`（1rpx 主色 14% 淡线，仅提示出现时渲染）
+  - 下 `info-line--tip`：tipIcon + runningTip，30rpx/600/`--text`（动态提示，比目标行大一号突出）；`--done` 态 success 绿
+- 三模式共用同一容器：单组/自由/循环都走 info-bubble；循环休息/暂停时 runningTip='' → 分隔线与提示行整体消失，气泡自动收缩只留目标行，布局不跳。
+- 旧 `.goal-card/.goal-icon/.goal-text/.timer-tip/.timer-tip-icon/.timer-tip-text` 全部删除，grep 无残留。
+
+## 状态文案并入信息气泡（用户反馈"撑住"等硬编码文案能否整合进气泡）
+- 背景：环下方 `.timer-status`（statusText：准备开始/撑住/休息中/已暂停）是独立一行，用户希望圆环下只留一张卡。
+- `timer.wxml`：删除 `.timer-status` 行，气泡改为三行结构——上 `info-line--status`（小圆点 + statusText）+ 恒显分隔线 + 中 `info-line--goal` + 提示行（条件渲染）。
+- `timer.wxss`：`.timer-status` 样式删除，新增 `.info-line--status/.info-status-dot/.info-status-text`：
+  - 状态行 32rpx/700，小圆点 14rpx 用 `background: currentColor` 跟随状态色（纯 CSS，规避 SVG 图标烤死问题）。
+  - 配色：`status--running`=主色（圆点呼吸 1.6s）；休息时 `status` 字段仍是 running，靠 `isResting` 追加 `info-line--rest` 覆盖为 success 绿（呼吸 1.8s）；`status--paused/idle`=text-secondary 灰，paused 圆点冻结动画。
+  - `.info-bubble` margin-top 24→40rpx（承接原 timer-status 间距）、padding 20→24rpx。
+- 关键机制备忘：**resting 时 status 字段值仍是 'running'**，状态行转绿必须靠 `isResting` 单独加类，不能只看 status。
+- 验证：grep 无 `timer-status` 代码残留（仅注释文字），js 未改动。
@@ -8,6 +8,7 @@
 - **系统字体缩放致文字溢出固定盒**（真机重现、模拟器不重现）：`getAppBaseInfo().host.env==='devtools'` 时跳过补偿，真机/PC 才把字号 `÷factor` 并 clamp。凡文字进固定圆/方盒且靠 `overflow:hidden` 裁切，都要考虑。
 - **云函数写库必须 `{ data: {...} }` 包裹**（wx-server-sdk 2.6.3）：`set/update/add` 漏包裹报 `parameter.data should be object`。读操作 `get()` 无此限制。
 - **自定义组件宿主默认 inline**：页面给 `<ui-card>` 等标签加 `border`/`transform`/`box-shadow` 会碎裂或静默失效（仅 `ui-card` 已修 `:host{display:block}`）。描边优先用 `box-shadow:0 0 0 Nrpx` 并补 `border-radius`，别用 `border`。跨组件边界的 `nth-child` 选择器一律失效，交错延迟由页面传 `index` 驱动。
+- **@font-face 本地路径不可靠**：微信小程序 `@font-face` 的 `src:url('./local.woff2')` 本地相对路径在真机上不生效（devtools 可能假性生效），字体静默回退系统字体。**唯一可靠方案**：把 woff2 转 base64 data URI 内联到 `src:url('data:font/woff2;charset=utf-8;base64,...')`，不依赖外部文件/网络。`wx.loadFontFace` 需配 downloadFile 域名白名单且网络不稳，同样不推荐。
 - **隐私协议在 MP 后台配置，不在 app.json**：`chooseAvatar` 属隐私接口，需在小程序管理后台「设置→服务内容声明→用户隐私保护指引」声明「用户信息(头像/昵称)」。代码里（app.json）看不到隐私配置是正常的；判断隐私合规**先确认后台指引状态**，别只看代码就下"审核风险"结论。已上架运行 = 后台已配好。`__usePrivacyCheck__:true` 仅本地调试用，正式版非必须。
 - **App.onLaunch 的 async/await 不阻塞首屏**：微信框架是「非阻塞生命周期调度」——onLaunch 被调用但页面 onLoad/onShow 并行推进，不等 onLaunch 内 Promise resolve。所以 app.js 里 `await cloud.pullAll()` 不会卡首屏，只是 await 之后的同步逻辑延迟执行。判断启动性能**别把 onLaunch 的 await 当阻塞**。
 - **代码审查避免过度判断**：给本项目做问题分析时，勿把"合理设计选择/优化建议"拔高成"问题/风险"。已被纠错的判断：①隐私协议缺失（实为后台配置，代码看不到）②onLaunch await 阻塞启动（机制理解错）③组件默认 isolated 不一致（实为合理分层）。下结论前先核实机制事实，区分"真 bug / 可优化 / 合理设计"。
@@ -0,0 +1,45 @@
+# 文风 DNA（默认模板）
+适用：产品功能更新介绍 / 终端用户向
+来源：无历史文章，使用默认模板兜底（2026-08-04）
+
+## 1. 语气温度
+温暖、像朋友安利，不端着、不官方腔。
+
+## 2. 人称
+第二人称「你」为主；「我们」指开发团队。
+
+## 3. 句式节奏
+短句为主（15 字内），复杂处拆成 2-3 句。
+
+## 4. 段落长度
+每段 2-4 行，移动端一眼扫完，不堆大段。
+
+## 5. 标题风格
+利益点 / 数字前置，如「这次更新，给你 3 个新惊喜」。
+
+## 6. 开头方式
+直接抛痛点或好处，1 句切入，不寒暄、不写「大家好」。
+
+## 7. 小标题
+动作 / 利益导向，前加 emoji（✨🏆📈 等）增强扫读。
+
+## 8. 列表呈现
+功能点用短列表，每点按「做了什么 + 对你意味着什么」展开。
+
+## 9. 用词
+口语化，少术语；必要术语用一句话白话解释。
+
+## 10. 结尾
+行动召唤：引导更新 / 体验，留一句鼓励收尾。
+
+## 11. emoji 使用
+适度点缀小标题与关键句，不堆砌、不喧宾夺主。
+
+## 12. 故事感
+轻量：可加一句用户场景（如「坚持打卡第 7 天，想看看自己进步了吗？」）。
+
+## 13. 证据 / 可信度
+用具体功能名 + 真实使用场景，避免过度吹捧。
+
+## 14. 节奏结构
+先总（一句话更新概览）→ 分（功能块）→ 总（召唤行动）。