skill-calorie 0.2.2 → 0.2.4

package/dist/render/sportDocs.js

@@ -1,540 +1,413 @@
-/** #109 · 运动/身体域全文档装配（数据→区块→填充器）。
+/** #109 · 运动域全文档装配（数据→区块→填充器）；#452 换融合版式；**#523 去分隔符形状化 ＋ 文案去冗余**。
  *
- * 范围（47 页同质之运动/身体域，t71 口径「新版已有」）：`calorie.view.exercise`
- * （exercise_summary 汇总＋趋势＋分布＋力量/有氧筛选子集）／`calorie.view.exercise-goal`
- * （exercise_goal_view）／`calorie.view.weight`（weight_dashboard）／
- * `calorie.view.weight-history`（weight_history 子集）／`calorie.view.weight-compare`
- * （weight_compare 子集）／`calorie.view.weight-review`（weight_review）／
- * `calorie.view.volatility`（weight_volatility_v2）／`calorie.view.body-composition`
- * （body_composition_view）／`calorie.view.body-measure`（body_measurements_view）。
- * 不碰：exercise_cardio／distribution／recap／review／strength／trend 6 项需移植（→ #111），
- * 训练计划/向导（→ #86），体脂/围度对比 helpers（无 CLI 键，随组合分析消费），
- * 缺口/组合/异常/禁忌（→ #110），饮食域（#108 已关）。
+ * 范围（#353 后：身体两页已迁 `src/body/bodyDocs.ts`，本件只留运动两页）：`calorie.view.exercise`
+ * （汇总：KPI 四格／每日消耗折线／类型消耗分布／逐日与按类型明细）／`calorie.view.exercise-goal`
+ * （对照目标：环卡／判决胶囊／差距文案）。不碰：运动 6 项需移植（→ #111）、训练计划与向导（→ #86）、
+ * 缺口/组合/异常/禁忌（→ #110）、饮食域（#108 已关）。体重五页在 `src/weight/plateDocs.ts`（#294）。
  *
- * 做法（#104 §4 用法）：内容 = base-paint/blocks 12 区块（B-01 壳／B-02 KPI／B-03 表／
- * B-04 图／B-05 列表／B-08 折叠／B-09 参数表单／B-11 复制区），文档 = fillTemplate 包裹
- * （资产裸文本＋填充器包裹；sharedCss = buildStyleSheet().css + blocksCss()，不走 extraCss；
- * 图表页另加 CHARTS-HELPERS＋buildChartsHelpersJs，图表 CSS 由其运行时注入）。
- * 复制文本一律 buildDataText（#77 契约，技能侧不自产第二套序列化）：指标页走 stat 投影，
- * 行级页（体成分/围度记录）走 list 投影。本层不做取数（数据由调用方 dispatch 备齐），
- * 不返空（缺失由数据层抛 missing-data）。
+ * #452 融合（地图 #156 第 3 票，形状照已验样板 #423）：① 页头写人话（无命令键／票号／工序词）；
+ * ② 汇总页四块逐块判空，长窗口**截断明示**；③ 目标页环取 `min(pct,100)`＋判决胶囊两态，目标缺席
+ * 走专门空态不画空环；④ 口径行走 #420 `renderCaliberLine`；⑤ 来源脚注走 #422；⑥ 可打印走
+ * `assembleDocPage` 的 `printable` 透传位（#448）。
+ *
+ * ── #523 三样债（分隔符／机器词／重复事实）＋ 手机端同档，本件落法 ──
+ *   ① **分隔符**：可见文本零硬串分隔符（探针口径见 #508）。落点四处——
+ *      · 页头眉标 `运动 · 汇总` → `运动汇总`（类别＋页族两个字都在，只是不用 `·` 串）；
+ *      · `<title>` 的品牌 `·` → 空格（照 #401 样板先例）；
+ *      · KPI 卡 `detail` 槽的 `·` 串 → 一条事实只写一处（另一条撤给同页别的卡，不是删）；
+ *      · 页脚来源行**不再走 `src/shared/sourceLine.ts`**（那件的 `·` 串是跨场景共用位，
+ *        本族改用 `sportUi.factStrip()` 的键值行承接；共用层口径统一归 **#470**，本票吸收其一角）；
+ *      · 口径行里 `；` 串 → 每条事实一个 `renderCaliberLine`（公共层既有件，不重造形状）。
+ *   ② **机器词上屏**：来源名从库表名改成读者看得懂的话；`月／日` 这类数值列走显示层取整。
+ *   ③ **重复事实**：窗口与天数只在窗口条／H1 各出现一次；截断三数拆成一句一事
+ *      （表标题只报本窗天数，可见行数与被截天数只住截断明示一句）；类型分布由柱状图改分布条
+ *      （长分类名在 x 轴上重叠越界）；目标页「已达成」只住判决胶囊一处，环下键值行已撤
+ *      （目标／实际／差额只在数值四格一处）。#523 返修落点。
+ *      **返修 R5（终审席 P2-7／P2-8，I1／I2）**：① 逐日表的表题不再复读窗口天数——表题收成
+ *      「按日消耗」，天数只留页头窗口条一处（被截窗把本窗天数并进截断明示那一句）；
+ *      ② 两张表的三个数值列都带上单位（「2 次」「800 卡」「90 分钟」），与同页分布条／折叠体同一种写法。
+ *   ④ **手机端同档**：页内形状件的 820 段＋触摸面在 `src/exercise/sportUi.ts`（本件正文首项放它的样式）。
+ *
+ * 取数仍由调用方备齐（`home/exercise.ts`／`render/planPlate.ts`）；本层不查库、不返空。
  */
-import { blocksCss, renderChartBlock, renderCopyBlock, renderDataTable, renderDisclosure, renderKpiGrid, renderListRows, renderPageShell, renderParamForm, } from 'base-paint/blocks';
-import { buildChartsHelpersJs, buildDataText, buildSharedHelpersJs, buildStyleSheet, fillTemplate } from 'base-paint';
-import { inferCategory } from '../fetch/exercise.js';
+import { renderCaliberLine, renderChartBlock, renderDataTable, renderDisclosure, renderDistributionRows, renderKpiGrid, renderListRows, renderTocBlock, } from 'base-paint/blocks';
+import { escapeHtml } from 'base-paint';
+import { assembleDocPage, metricsOf } from '../shared/docPage.js';
+import { copyArea, copyLog } from '../shared/copyArea.js';
+import { emptyGuide } from '../shared/emptyGuide.js';
+import { commandLine } from '../shared/writeParts.js';
+import { nowStamp } from './receipt.js';
+import { inferCategory } from '../exercise/exerciseStore.js';
+import { exerciseUiCss, factStrip, fmtNum, windowStrip } from '../exercise/sportUi.js';
 /** envelope 头（值冻结对齐 cli/keys.ts ENVELOPE_VERSION／CALORIE_SKILL；测试钉死一致）。 */
 const DOC_VERSION = '0.1.0';
 const DOC_SKILL = 'calorie';
-/** 内容页壳（裸标记＋CONTENT 槽；包裹约定：资产裸文本＋填充器包裹，标记不得预包裹）。
- *  wrap 带 ilife-page 兼容既有 --html 断言。 */
-const DOC_SHELL = '<!doctype html>\n<html lang="zh-CN">\n<head>\n<meta charset="utf-8">\n' +
-    '<meta name="viewport" content="width=device-width,initial-scale=1">\n' +
-    '<title>卡路里·运动身体</title>\n<!--SHARED-CSS-->\n</head>\n<body>\n' +
-    '<div class="wrap ilife-page">\n<!--CONTENT-->\n</div>\n<!--SHARED-HELPERS-->\n</body>\n</html>';
-/** 图表页壳（多一个 CHARTS-HELPERS 标记，图表 CSS 由 charts helpers 运行时注入）。 */
-const DOC_SHELL_CHARTS = '<!doctype html>\n<html lang="zh-CN">\n<head>\n<meta charset="utf-8">\n' +
-    '<meta name="viewport" content="width=device-width,initial-scale=1">\n' +
-    '<title>卡路里·运动身体</title>\n<!--SHARED-CSS-->\n</head>\n<body>\n' +
-    '<div class="wrap ilife-page">\n<!--CONTENT-->\n</div>\n<!--SHARED-HELPERS-->\n<!--CHARTS-HELPERS-->\n</body>\n</html>';
-function assemble(title, eyebrow, subtitle, content, charts) {
-    const assets = {
-        sharedCssText: buildStyleSheet().css + '\n' + blocksCss(),
-        sharedHelpersJs: buildSharedHelpersJs(),
-    };
-    if (charts)
-        assets.chartsHelpersJs = buildChartsHelpersJs();
-    const body = renderPageShell({
-        title,
-        ...(eyebrow ? { eyebrow } : {}),
-        ...(subtitle ? { subtitle } : {}),
-        content,
+/** 本文件各页共用的 head 标题（整页模板住 `src/shared/docPage.ts`，标题走参数）。
+ *  #523：品牌名里的 `·` 去掉——`·` 是分隔符债，`<title>` 也是可见文本（探针按 `#401` 样板加了这条锁）。 */
+const DOC_TITLE = '卡路里 运动';
+/** 逐日明细表最多摆几行（超上限**逐条明示**：表标题只报本窗天数，可见行数只报这一截）。
+ *  口径取全仓既有上限写法（`copyArea` 的 100 条 caption 同数），不静默截数。 */
+const DAILY_CAP = 100;
+/** 分布条最多列几类（#523 返修）：类型名的柱状图 x 轴在 9 个长分类名下互相重叠、右端越出画布
+ *  （`把手式蝴蝶机飞鸟` 8 个字以 `x≈288` 居中，横跨约 248～328，画布宽只有 320），故柱状图不再画，
+ *  改走公共层 `renderDistributionRows`（名称 ｜ 条 ｜ 数值，HTML 横排，全称照印、窄屏自然换行）。
+ *  其余逐条仍归下方「按类型明细」表（条给一眼，表给逐条）。 */
+const DIST_TOP = 8;
+/** 人话眉标（页头不许出现命令键；两页各一句）。
+ *  #523：`运动 · 汇总` 的 `·` 去掉——类别（运动）与页族（汇总）两个字都在，只是不拿符号串。
+ *  #523 返修 R3：眉标原来与 H1（`运动汇总`）**逐字全同**——#552 把 H1 的日期摘掉之后两者撞成同一个串，
+ *  视觉复评 R2 在汇总族两页各记 −5「眉标与 H1 逐字同名」。现眉标退回**类别词**「运动」、页族「汇总」
+ *  由 H1 承载：两件事实都还在页头，眉标不再复读页名（与明细族「眉标＝运动记录／H1＝运动记录明细」同构）。 */
+const SUMMARY_EYEBROW = '运动';
+const GOAL_EYEBROW = '运动对照目标';
+/** 来源脚注上给**读者看**的来源名：可见文本零 snake_case（库表名只留在复制日志的「来源」段里，
+ *  那是给复核的人照抄用的技术原件，不上页面）。
+ *  #552 去文：SOURCE_LOGGED 已删（运动汇总来源块整块消失后本件只剩目标页用 SOURCE_GOAL；
+ *  用户裁决“口径/来源块消失”——见票面判据）。 */
+const SOURCE_GOAL = '每日目标 ＋ 运动记录';
+/** 数值的展示写形一律走 `sportUi.fmtNum()`（显示层取整，见 #523）；本件不再另立一个 `fmt`。 */
+/** 窗内天数（闭区间；只做天数差，不当取数口径）。 */
+function daysIn(start, end) {
+    return Math.round((Date.parse(end) - Date.parse(start)) / 86400000) + 1;
+}
+/** 日期链的展示写形：`起 ~ 止`（`~` 是日期区间的既有写法，见 #508 的豁免清单，不算并列分隔符）。 */
+const rangeText = (start, end) => start + ' ~ ' + end;
+function shell(c) { return '<section id="' + c.id + '">' + c.html + '</section>'; }
+/** 页面级小件的类名（融合件：#421／#452 的页内构件都落这一族；样式随 `pageShell` 区落盘）。 */
+function part(name) { return 'ilife-block-' + name; }
+/** 页内导航：锚点清单由卡片表派生（不手抄第二份 id）。 */
+function tocOf(cards) {
+    return renderTocBlock({ items: cards.map((c) => ({ id: c.id, text: c.label })) });
+}
+/** 页内一张卡（锚点 id ＋ 区块 HTML）——页内导航与正文都吃它。 */
+function card(id, label, html) { return { id, label, html }; }
+/** 来源脚注（#523 形状化 ＋ #460 诚实口径）：键值行「数据来源／窗口／窗口天数」，
+ *  `·` 串已去（口径归 #470）；取数面无条数字段，天数不再冒充条数，第三格如实报天。 */
+function footFacts(source, start, end, days) {
+    return factStrip([
+        { k: '数据来源', v: source },
+        { k: '窗口', v: start + ' → ' + end },
+        { k: '窗口天数', v: '共 ' + fmtNum(days, 0) + ' 天' },
+    ]);
+}
+/** 复制区（两页共用）：三格式数据 ＋ 复制日志（命令／来源／时刻／版本）。 */
+function docCopy(env, command, source) {
+    return copyArea({
+        data: { envelope: env },
+        log: { envelope: env, copyLog: copyLog({ command, source, actionAt: nowStamp(), version: DOC_VERSION }) },
     });
-    return fillTemplate({ template: charts ? DOC_SHELL_CHARTS : DOC_SHELL, assets, content: body }).html;
 }
-function copyBlock(title, input) {
-    return renderCopyBlock({ title, dataText: buildDataText(input) });
+/** 壳内正文顺序（两页共用）：页内样式 → 锚点导航 → 卡片 → 口径行 → 来源脚注 → 复制区。
+ *  页内样式恒为第一项（`assembleDocPage` 没有页内 CSS 入口，做法同 `src/weight/weightUi.ts`）。 */
+function pageBody(cards, caliber, source, copy) {
+    return [
+        exerciseUiCss(),
+        tocOf(cards),
+        cards.map(shell).join(''),
+        caliber.map((t) => renderCaliberLine(t)).join(''),
+        source,
+        copy,
+    ].join('');
 }
-function fmt(n) {
-    if (n === null || n === undefined)
-        return '—';
-    return String(n);
+/* ══════════ 一、运动汇总（exercise_summary.html 的 mode=summary 一支：KPI＋折线＋分布＋明细） ══════════ */
+/** KPI 四格（#523 去重复事实：四条各报一件事，同一个数不在两张卡上各写一遍）。
+ *  窗口三处（H1／窗口条／页脚）已各有一份，卡里不再复读。 */
+function summaryKpi(v) {
+    const r = v.review;
+    return [
+        { label: '总消耗', value: fmtNum(r.totalBurned, 0), unit: '卡' },
+        { label: '总时长', value: fmtNum(r.totalMinutes, 0), unit: '分钟',
+            detail: '每次平均 ' + fmtNum(r.totalMinutes / Math.max(1, r.sessions), 0) + ' 分钟' },
+        { label: '次数', value: String(r.sessions), unit: '次', detail: '活跃 ' + r.activeDays + ' 天' },
+        { label: '日均', value: fmtNum(v.avgBurnedPerLoggedDay, 0), unit: '卡', detail: '按有记录的天数算' },
+    ];
 }
-/** 复制投影 stat-metrics 只收确定数字（冻结口径：null/undefined 不进投影；随 #108 诸盘纯数字 metrics 同理）。 */
-function metricsOf(obj) {
-    const out = {};
-    for (const [k, v] of Object.entries(obj)) {
-        if (v !== null && v !== undefined)
-            out[k] = v;
+/** #389 · 汇总页目标对照位（目标／对比目标在汇总页的落点）。
+ *  口径复用目标页同一套（每日目标＋完成度＋差额经 `home/exercise.ts` 的目标公开接口来，不在本件重算）。
+ *  形状守 #452／#552：只加一张卡（`sec-goal`），不加口径行、不加来源脚注，故汇总页口径行仍 0、来源仍无。
+ *  存量直构造（未带目标字段）回 null＝不加卡，旧快照逐字节不变；显式 null＝未设目标，走未设指引。 */
+function goalCard(v) {
+    if (!('dailyGoal' in v))
+        return null;
+    const daily = v.dailyGoal ?? null;
+    const total = v.goalTotal ?? null;
+    const pct = v.goalPct ?? null;
+    const gap = v.goalGap ?? null;
+    const achieved = v.goalAchieved ?? null;
+    if (daily === null || total === null || pct === null || gap === null || achieved === null) {
+        return card('sec-goal', '目标对照', '<h2 style="margin:0;font-size:15px;font-weight:700">目标对照</h2>' + emptyGuide({
+            icon: '🎯', text: '还没设每日运动消耗目标',
+            hint: '先说一句「定运动目标」把每日运动消耗目标定下来，再看对照。',
+        }));
     }
-    return out;
+    const verdict = '<span class="' + part('verdict') + ' ' + (achieved ? 'ok' : 'no') + '">'
+        + (achieved ? '✓ 已达成目标' : '✕ 还差 ' + fmtNum(Math.abs(gap), 0) + ' 卡') + '</span>';
+    return card('sec-goal', '目标对照', '<h2 style="margin:0;font-size:15px;font-weight:700">目标对照</h2>'
+        + renderKpiGrid([
+            { label: '目标', value: fmtNum(total, 0), unit: '卡' },
+            { label: '实际', value: fmtNum(v.review.totalBurned, 0), unit: '卡' },
+            { label: '完成度', value: fmtNum(pct) + '%' },
+            { label: '差额', value: fmtNum(Math.abs(gap), 0), unit: '卡', detail: gap >= 0 ? '超出目标' : '还差这么多' },
+        ]) + verdict);
+}
+/** 逐日表的截断口径（一处算）：**表题只报这张表是什么**，天数与截断三数全住截断明示那一句。
+ *  #523 返修：原来 caption 与 `sui-note` 把「表被截断、看折线」各说一遍，现拆成一句一事。
+ *  **R5 打回项 I2（终审席 P2-8）**：表题原来写「按日消耗（本窗共 N 天）」，那个 N 天与**页头窗口条
+ *  右端那颗「N 天」胶囊是同一条事实**（同一页说两遍）。现表题收成「按日消耗」，天数只留页头窗口条
+ *  一处；被截窗里本窗天数并进截断明示那一句（「本窗共 N 天 ＋ 显示最近 100 天 ＋ 其余 M 天」三数同句），
+ *  读者在一个句子里就能对齐「窗共几天／表列几天／少了几」。
+ *  返回的 `note` 只在超上限时出，且**必带「截断」二字**（#452 的回归判据读它）。 */
+function truncation(days) {
+    if (days <= DAILY_CAP)
+        return { visible: false, note: '' };
+    return {
+        visible: true,
+        note: '逐日表已截断：本窗共 ' + days + ' 天，显示最近 ' + DAILY_CAP + ' 天，其余 ' + (days - DAILY_CAP) + ' 天见上方折线',
+    };
 }
-/* ── 运动总览（exercise_summary.html 对照：汇总＋每日趋势＋类型分布＋力量/有氧筛选子集） ── */
-export function buildExerciseDoc(v) {
+/** 逐日消耗表：窗内**每天都有一行**（无记录日留空，不断 0）；超上限时只摆最近一截并明示。
+ *  表标题不再复读窗口（窗口住页头窗口条与 H1），也不复读写法说明（住页底口径行）。
+ *  单元格走 `fmtNum`——库里的 `153.60000000000002` 那样的原值不上屏。
+ *  **R5 打回项 I1（终审席 P2-7）**：消耗列原来是裸数（`1250`），而同页分布条写「1250 卡」——
+ *  一页两套单位写法、读者还要自己猜这一列是卡还是分钟。现单元格直接带单位「1250 卡」，
+ *  与该页分布条／折叠体同一种写法（同族记录级明细页的四列本来就带单位，两族由此一致）。 */
+function seriesCard(v) {
+    if (v.series.length === 0)
+        return null;
+    const rows = v.series.map((d) => ({
+        date: d.date, burn: d.exerciseKcal === null ? '—' : fmtNum(d.exerciseKcal, 0) + ' 卡',
+    }));
+    const cut = truncation(rows.length);
+    const table = renderDataTable({
+        columns: [{ key: 'date', label: '日期' }, { key: 'burn', label: '消耗', align: 'right' }],
+        rows: cut.visible ? rows.slice(rows.length - DAILY_CAP) : rows,
+        caption: '按日消耗',
+        emptyText: '本窗无按日消耗',
+    });
+    return {
+        id: 'sec-series', label: '按日消耗',
+        html: (cut.note === '' ? '' : '<p class="sui-note">' + escapeHtml(cut.note) + '</p>') + table,
+    };
+}
+/** 按类型明细表（力量／有氧筛选子集：同窗不同类直出，无类切换页）。
+ *  #523：表标题只留类数，删掉「力量／有氧筛选子集同窗直出」那句读者用不上的工序话；
+ *  数值一律走显示层取整（库里 `1680.8000000000004` 那样的原值不上屏）。
+ *  **R5 打回项 I1**：三列数值原来都是裸数（次数 `2`、消耗 `800`、时长 `90`）且表头不带单位，
+ *  读者要自己猜这两列是卡还是分钟；现与逐日表、分布条、折叠体统一成「值 ＋ 单位」
+ *  （折叠体本来就写「2 次」「2200 卡」，三处同一写法）。 */
+function typeCard(v) {
+    const byType = v.review.byType;
+    if (byType.length === 0)
+        return null;
+    return {
+        id: 'sec-type',
+        label: '按类型明细',
+        html: renderDataTable({
+            columns: [
+                { key: 'type', label: '类型' }, { key: 'cat', label: '分类' }, { key: 'sessions', label: '次数', align: 'right' },
+                { key: 'burned', label: '消耗', align: 'right' }, { key: 'minutes', label: '时长', align: 'right' },
+            ],
+            rows: byType.map((t) => ({
+                type: t.type, cat: inferCategory(t.type), sessions: t.sessions + ' 次',
+                burned: fmtNum(t.burned, 0) + ' 卡', minutes: fmtNum(t.minutes, 0) + ' 分钟',
+            })),
+            caption: '按类型明细（共 ' + byType.length + ' 类）',
+            emptyText: '本窗无类型明细',
+        }),
+    };
+}
+/** 汇总页的卡片清单（页内导航与正文走**同一份清单**，锚点不会指到不存在的 id）：
+ *  四格 KPI ／ 目标对照 ／ 每日消耗折线 ／ 类型消耗分布 ／ 逐日明细 ／ 按类型明细 ／ 按分类汇总，逐块判空。 */
+function summaryCards(v) {
     const r = v.review;
-    const parts = [renderKpiGrid([
-            { label: '总消耗', value: String(r.totalBurned), unit: '卡', detail: v.start + ' ~ ' + v.end },
-            { label: '总时长', value: String(r.totalMinutes), unit: '分钟' },
-            { label: '次数', value: String(r.sessions), unit: '次', detail: '活跃 ' + r.activeDays + ' 天' },
-            {
-                label: '日均', value: fmt(v.avgBurnedPerLoggedDay), unit: '卡',
-                detail: '数列合计 ' + v.totalBurnedSeries + ' 卡 · 有数 ' + v.activeDays + ' 天',
-            },
-        ])];
-    let charts = false;
-    const loggedDays = v.series.filter((d) => d.exerciseKcal !== null);
-    if (loggedDays.length > 0) {
-        parts.push(renderChartBlock({
+    const cards = [{ id: 'sec-kpi', label: '核心数字', html: '<h2 style="margin:0;font-size:15px;font-weight:700">核心数字</h2>' + renderKpiGrid(summaryKpi(v)) }];
+    const goal = goalCard(v);
+    if (goal !== null)
+        cards.push(goal);
+    const logged = v.series.filter((d) => d.exerciseKcal !== null);
+    if (logged.length > 0) {
+        cards.push(card('sec-trend', '每日消耗', renderChartBlock({
             kind: 'line',
             title: '每日消耗',
             input: {
-                items: v.series.map((d) => ({ label: d.date.slice(5), value: d.exerciseKcal })),
-                options: { markLine: { value: v.avgBurnedPerLoggedDay ?? undefined, label: '日均' } },
+                items: v.series.map((d) => ({ label: (v.start.slice(0, 4) !== v.end.slice(0, 4) ? d.date : d.date.slice(5)), value: d.exerciseKcal })),
+                options: { markLine: { value: v.avgBurnedPerLoggedDay ?? undefined, label: '日均' }, showDots: true },
             },
-        }));
-        charts = true;
+        })));
     }
     if (r.byType.length > 0) {
-        parts.push(renderChartBlock({
-            kind: 'bar',
-            title: '类型消耗分布',
-            input: { items: r.byType.map((t) => ({ label: t.type + ' ' + t.sessions + '次', value: t.burned })) },
-        }));
-        charts = true;
+        // #523 返修：类型消耗分布不再画柱状图（长分类名在 x 轴上重叠越界），改走分布条——
+        // 全称照印、窄屏自然换行；只列消耗最高的这几类，超上限时用一句注明去向（该句只出现一次）。
+        const top = [...r.byType].sort((a, b) => b.burned - a.burned).slice(0, DIST_TOP);
+        const max = top.length === 0 || !Number.isFinite(top[0].burned) || top[0].burned <= 0 ? 0 : top[0].burned;
+        const distNote = r.byType.length > DIST_TOP
+            ? '<p class="sui-note">' + escapeHtml('只列消耗最高的 ' + DIST_TOP + ' 类，逐类消耗见下方按类型明细表') + '</p>'
+            : '';
+        cards.push(card('sec-dist', '类型消耗分布', '<h2 style="margin:0;font-size:15px;font-weight:700">类型消耗分布</h2>' + renderDistributionRows({
+            rows: top.map((t) => ({
+                label: t.type,
+                value: fmtNum(t.burned, 0) + ' 卡',
+                pct: max === 0 ? 0 : Math.max(0, Math.min(100, (t.burned / max) * 100)),
+            })),
+        }) + distNote));
     }
-    parts.push(renderDataTable({
-        columns: [
-            { key: 'date', label: '日期' },
-            { key: 'burn', label: '消耗', align: 'right' },
-        ],
-        rows: v.series.map((d) => ({ date: d.date, burn: d.exerciseKcal })),
-        caption: '按日消耗（' + v.start + ' ~ ' + v.end + '，无记录日留空，不断 0）',
-        emptyText: '本窗无按日消耗',
-    }));
-    parts.push(renderDataTable({
-        columns: [
-            { key: 'type', label: '类型' },
-            { key: 'cat', label: '分类' },
-            { key: 'sessions', label: '次数', align: 'right' },
-            { key: 'burned', label: '消耗', align: 'right' },
-            { key: 'minutes', label: '时长', align: 'right' },
-        ],
-        rows: r.byType.map((t) => ({
-            type: t.type, cat: inferCategory(t.type), sessions: t.sessions, burned: t.burned, minutes: t.minutes,
-        })),
-        caption: '按类型明细（力量/有氧筛选子集：同窗不同类直出，无类切换页）',
-        emptyText: '本窗无类型明细',
-    }));
+    const series = seriesCard(v);
+    if (series !== null)
+        cards.push(series);
+    const type = typeCard(v);
+    if (type !== null)
+        cards.push(type);
     const cats = Object.entries(r.byCategory);
     if (cats.length > 0) {
-        parts.push(renderDisclosure({
+        cards.push(card('sec-cat', '按分类汇总', renderDisclosure({
             title: '按分类汇总（共 ' + cats.length + ' 类）',
             contentHtml: renderListRows({
-                items: cats.map(([cat, s]) => ({ left: cat, main: s.sessions + ' 次', right: s.burned + ' 卡' })),
+                items: cats.map(([cat, s]) => ({ left: cat, main: s.sessions + ' 次', right: fmtNum(s.burned, 0) + ' 卡' })),
             }),
-        }));
+        })));
     }
-    parts.push(copyBlock('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: 'calorie.view.exercise',
-            data: {
-                metrics: metricsOf({
-                    totalBurned: r.totalBurned, totalMinutes: r.totalMinutes, sessions: r.sessions,
-                    activeDays: r.activeDays, totalBurnedSeries: v.totalBurnedSeries,
-                    avgBurnedPerLoggedDay: v.avgBurnedPerLoggedDay, seriesActiveDays: v.activeDays,
-                }),
-            },
-        },
-    }));
-    return assemble('运动总览 ' + v.start + ' ~ ' + v.end, 'calorie.view.exercise · 运动身体域', '类型分布/力量有氧明细同窗直出（交互筛选归宿主）', parts.join(''), charts);
+    return cards;
 }
-/* ── 运动目标（exercise_goal_view.html 对照：目标 vs 实际＋完成度＋达成判定） ── */
-export function buildExerciseGoalDoc(v) {
-    const parts = [renderKpiGrid([
-            { label: '区间', value: v.start + ' ~ ' + v.end, detail: v.days + ' 天 · 日均目标 ' + v.dailyGoal + ' 卡' },
-            { label: '目标', value: String(v.goalTotal), unit: '卡' },
-            { label: '实际', value: String(v.actual), unit: '卡', detail: v.achieved ? '已达成' : '未达成' },
-            {
-                label: '完成度', value: v.pct === null ? '—' : String(v.pct) + '%',
-                detail: '差 ' + v.gap + ' 卡', status: v.achieved ? 'ok' : 'warn',
-            },
-        ])];
-    parts.push(renderChartBlock({
-        kind: 'bar',
-        title: '目标 vs 实际',
-        input: { items: [{ label: '目标', value: v.goalTotal }, { label: '实际', value: v.actual }] },
-    }));
-    parts.push(copyBlock('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: 'calorie.view.exercise-goal',
-            data: {
-                metrics: metricsOf({
-                    dailyGoal: v.dailyGoal, goalTotal: v.goalTotal, actual: v.actual,
-                    pct: v.pct, gap: v.gap, achieved: v.achieved ? 1 : 0, days: v.days,
-                }),
-            },
+/* #552 去文：summaryCalibers 整函数删（仅此处用；用户裁决“口径/来源块消失”——见票面判据）。 */
+function summaryEnvelope(v) {
+    const r = v.review;
+    return {
+        version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: '运动汇总',
+        data: {
+            metrics: metricsOf({
+                totalBurned: r.totalBurned, totalMinutes: r.totalMinutes, sessions: r.sessions,
+                activeDays: r.activeDays, totalBurnedSeries: v.totalBurnedSeries,
+                avgBurnedPerLoggedDay: v.avgBurnedPerLoggedDay, seriesActiveDays: v.activeDays,
+                dailyGoal: v.dailyGoal ?? undefined, goalTotal: v.goalTotal ?? undefined,
+                goalPct: v.goalPct ?? undefined, goalGap: v.goalGap ?? undefined,
+            }),
         },
-    }));
-    return assemble('运动目标 ' + v.start + ' ~ ' + v.end, 'calorie.view.exercise-goal · 运动身体域', v.achieved ? '已达成（实际 ≥ 目标）' : '未达成（还差 ' + Math.abs(v.gap) + ' 卡）', parts.join(''), true);
+    };
 }
-/* ── 体重盘（weight_dashboard.html 对照：首末＋均值＋变化趋势＋目标差距） ── */
-export function buildWeightDoc(w) {
-    const t = w.trend;
-    const parts = [renderKpiGrid([
-            { label: '体重盘', value: t.firstWeight + ' → ' + t.lastWeight + ' kg', detail: t.firstDate + ' ~ ' + t.lastDate },
-            { label: '均值', value: String(t.avgWeight), unit: 'kg', detail: '共 ' + t.recordCount + ' 条 · 极值 ' + t.minWeight + '~' + t.maxWeight },
-            {
-                label: '变化', value: (t.changeKg >= 0 ? '+' : '') + t.changeKg + ' kg',
-                detail: '趋势' + t.trendCn + ' · 日均 ' + t.dailyChangeG + ' g',
-            },
-            {
-                label: '距目标', value: w.gapKg === null ? '—' : (w.gapKg >= 0 ? '+' : '') + w.gapKg + ' kg',
-                detail: w.weightGoal === null ? '未设体重目标' : '目标 ' + w.weightGoal + ' kg' + (w.deadline ? ' · 截止 ' + w.deadline : ''),
-            },
-        ])];
-    let charts = false;
-    if (t.logs.length > 0) {
-        parts.push(renderChartBlock({
-            kind: 'line',
-            title: '体重曲线',
-            input: { items: t.logs.map((l) => ({ label: l.date.slice(5), value: l.weightKg })) },
-        }));
-        charts = true;
+/** 运动汇总整页（只读页：数据由调用方 `buildExerciseView` 备齐；零记录走空态指引）。
+ *  #552 去文（用户裁决“标题无日期；副题元素消失；口径/来源块消失”——见票面判据）：
+ *  标题只留“运动汇总”（窗口由 windowStrip 承载）；副题整行删（传 subtitle:null）；
+ *  口径/来源整块消失（pageBody 传 [] 与空串）。 */
+export function buildExerciseDoc(v, cmd) {
+    const env = summaryEnvelope(v);
+    const copy = docCopy(env, cmd ?? commandLine('calorie.view.exercise', { start: v.start, end: v.end }), 'exercise_log（只读汇总）');
+    const title = '运动汇总';
+    if (v.series.length === 0) {
+        // 零窗（装配层构造）＝一整页空态指引：不留空 KPI 卡、不出空折线。
+        return assembleDocPage({
+            docTitle: DOC_TITLE, title, eyebrow: SUMMARY_EYEBROW, subtitle: '本段时间没有运动记录',
+            content: exerciseUiCss() + '<section id="sec-empty">' + emptyGuide({
+                icon: '🏃', text: '本段时间没有运动记录',
+                hint: '先说一句「记运动」把这一次补上，或把窗口换成最近 7 天再看。',
+            }) + '</section>',
+            printable: true,
+        }) + copy;
     }
-    parts.push(renderDataTable({
-        columns: [
-            { key: 'date', label: '日期' },
-            { key: 'kg', label: '体重', align: 'right' },
-            { key: 'note', label: '备注' },
-        ],
-        rows: t.logs.map((l) => ({ date: l.date, kg: l.weightKg, note: l.note })),
-        caption: '体重记录（' + t.firstDate + ' ~ ' + t.lastDate + '，共 ' + t.recordCount + ' 条）',
-        emptyText: '本窗无体重记录',
-    }));
-    parts.push(copyBlock('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: 'calorie.view.weight',
-            data: {
-                metrics: metricsOf({
-                    recordCount: t.recordCount, avgWeight: t.avgWeight,
-                    maxWeight: t.maxWeight, minWeight: t.minWeight,
-                    firstWeight: t.firstWeight, lastWeight: t.lastWeight,
-                    changeKg: t.changeKg, dailyChangeG: t.dailyChangeG,
-                    weightGoal: w.weightGoal, gapKg: w.gapKg,
-                }),
-            },
-        },
-    }));
-    return assemble('体重盘 ' + w.start + ' ~ ' + w.end, 'calorie.view.weight · 运动身体域', '趋势' + t.trendCn, parts.join(''), charts);
+    const cards = summaryCards(v);
+    return assembleDocPage({
+        docTitle: DOC_TITLE, title, eyebrow: SUMMARY_EYEBROW,
+        subtitle: null,
+        // 窗口条（#523）：起止两枚日期块 ＋ 天数胶囊，替掉原来挤在副标题／表标题里的 `·` 串。
+        // #552 去文：窗口只由 windowStrip 承载（用户裁决“窗口由 windowStrip 承载”——见票面判据）。
+        content: windowStrip(v.start, v.end, daysIn(v.start, v.end) + ' 天')
+            + pageBody(cards, [], '', copy),
+        charts: true, printable: true,
+    });
 }
-/* ── 体重历史（weight_history.html 对照：曲线＋全量记录表；18 词多窗口子集直出） ── */
-export function buildWeightHistoryDoc(h) {
-    const asc = [...h.rows].reverse();
-    const parts = [renderKpiGrid([
-            { label: '体重历史', value: h.range, detail: '共 ' + h.rows.length + ' 条' },
-            {
-                label: '变化',
-                value: h.change ? (h.change.delta >= 0 ? '+' : '') + h.change.delta + ' kg' : '—',
-                detail: h.change ? h.change.spanDays + ' 天 · 日均 ' + h.change.dailyAvg + ' kg' : '单点无变化',
-            },
-        ])];
-    let charts = false;
-    if (asc.length > 0) {
-        parts.push(renderChartBlock({
-            kind: 'line',
-            title: '体重曲线',
-            input: { items: asc.map((r) => ({ label: r.date.slice(5), value: r.weight_kg })) },
-        }));
-        charts = true;
-    }
-    parts.push(renderDataTable({
-        columns: [
-            { key: 'date', label: '日期' },
-            { key: 'time', label: '时间' },
-            { key: 'kg', label: '体重', align: 'right' },
-            { key: 'bmi', label: 'BMI', align: 'right' },
-            { key: 'note', label: '备注' },
-        ],
-        rows: h.rows.map((r) => ({
-            date: r.date, time: r.time ?? '', kg: r.weight_kg, bmi: r.bmi ?? '', note: r.note ?? '',
-        })),
-        caption: '体重历史 ' + h.range + '（共 ' + h.rows.length + ' 条）',
-        emptyText: '本窗无体重记录',
-    }));
-    parts.push(copyBlock('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: 'calorie.view.weight-history',
-            data: {
-                metrics: metricsOf({
-                    rows: h.rows.length,
-                    spanDays: h.change?.spanDays, first: h.change?.first, last: h.change?.last,
-                    delta: h.change?.delta, dailyAvg: h.change?.dailyAvg,
-                }),
-            },
-        },
-    }));
-    return assemble('体重历史 ' + h.range, 'calorie.view.weight-history · 运动身体域', null, parts.join(''), charts);
+/** 环卡：`min(pct,100)` 给环，实际百分比由文字承载（超额不把环画爆）。
+ *  #523 返修：环下那行「目标／实际／差距」键值行已撤——这三个数在下方「数值对照」四格各有一处，
+ *  环旁只留判决胶囊（同一事实一页一处；「差距／差额」两名一数也随之收成「差额」一名）。
+ *  环心只留百分比读数，判语（已达成／还需再练）只住胶囊一处。 */
+function ringCard(v, pct) {
+    const deg = Math.max(0, Math.min(100, Math.min(pct, 100)));
+    return '<div class="' + part('ring-card') + '">'
+        + '<div class="' + part('ring-wrap') + '" role="img" aria-label="运动目标完成度 ' + fmtNum(v.pct) + '%">'
+        + '<div style="position:absolute;inset:0;border-radius:50%;background:conic-gradient(var(--blue) 0 ' + deg + '%, var(--line) ' + deg + '% 100%)"></div>'
+        + '<div class="' + part('ring-center') + '">'
+        + '<div class="' + part('ring-pct') + '">' + fmtNum(v.pct) + '%</div>'
+        + '</div></div>'
+        + '<div class="' + part('ring-side') + '">'
+        + verdictPill(v)
+        + '</div></div>';
 }
-/* ── 体重对比（weight_compare.html 对照：两期均值差＋节奏＋分期明细；18 场景子集直出） ── */
-const COMPARE_COLUMNS = [
-    { key: 'period', label: '期别' },
-    { key: 'range', label: '区间' },
-    { key: 'avg', label: '均值', align: 'right' },
-    { key: 'first', label: '期首', align: 'right' },
-    { key: 'last', label: '期末', align: 'right' },
-    { key: 'change', label: '变化', align: 'right' },
-];
-export function buildWeightCompareDoc(v) {
-    const c = v.compare;
-    const parts = [renderKpiGrid([
-            {
-                label: '体重对比', value: (c.avgDiff >= 0 ? '+' : '') + c.avgDiff + ' kg',
-                detail: c.direction === 'down' ? '下降' : '上升',
-            },
-            { label: '本期', value: String(c.currentPeriod.avgWeight), unit: 'kg', detail: v.start + ' ~ ' + v.end },
-            { label: '对比期', value: String(c.comparePeriod.avgWeight), unit: 'kg', detail: v.compareStart + ' ~ ' + v.compareEnd },
-            { label: '节奏', value: c.speedLabel },
-        ])];
-    const rowOf = (name, s, range) => ({
-        period: name, range, avg: s.avgWeight, first: s.firstWeight, last: s.lastWeight, change: s.changeKg,
-    });
-    parts.push(renderDataTable({
-        columns: [...COMPARE_COLUMNS],
-        rows: [
-            rowOf('本期', c.currentPeriod, v.start + ' ~ ' + v.end),
-            rowOf('对比期', c.comparePeriod, v.compareStart + ' ~ ' + v.compareEnd),
-        ],
-        caption: '两期对比（均值差 ' + (c.avgDiff >= 0 ? '+' : '') + c.avgDiff + ' kg）',
-        emptyText: '对比期无数据',
-    }));
-    parts.push(copyBlock('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: 'calorie.view.weight-compare',
-            data: {
-                metrics: {
-                    avgDiff: c.avgDiff,
-                    currentAvg: c.currentPeriod.avgWeight, compareAvg: c.comparePeriod.avgWeight,
-                    currentChange: c.currentPeriod.changeKg, compareChange: c.comparePeriod.changeKg,
-                },
-            },
-        },
-    }));
-    return assemble('体重对比', 'calorie.view.weight-compare · 运动身体域', '本期 ' + v.start + ' ~ ' + v.end + ' vs 对比期 ' + v.compareStart + ' ~ ' + v.compareEnd, parts.join(''), false);
+/** 判决胶囊：达成 `ok`／未达成 `no`（两态同一个类的两个档）。 */
+function verdictPill(v) {
+    const text = v.achieved ? '✓ 已达成目标' : '✕ 还差 ' + fmtNum(Math.abs(v.gap), 0) + ' 卡';
+    return '<span class="' + part('verdict') + ' ' + (v.achieved ? 'ok' : 'no') + '">' + text + '</span>';
 }
-/* ── 体重复核（weight_review.html 对照：当前＋目标＋差距＋预计达成＋调整建议） ── */
-export function buildWeightReviewDoc(v) {
-    const m = v.milestone;
-    const parts = [renderKpiGrid([
-            { label: '体重复核', value: String(m.currentWeight), unit: 'kg', detail: m.currentDate },
-            {
-                label: '目标体重', value: String(m.weightGoal), unit: 'kg',
-                detail: m.deadline ? '截止 ' + m.deadline : '无截止',
-            },
-            { label: '差距', value: (m.gapKg >= 0 ? '+' : '') + m.gapKg + ' kg' },
-            {
-                label: '预计达成', value: m.estDate ?? '—',
-                detail: m.estDays === null || m.estDays === undefined ? m.status : m.estDays + ' 天 · ' + m.status,
-            },
-        ])];
-    parts.push(renderListRows({
-        items: [
-            { left: '状态', main: m.status },
-            {
-                left: '日均变化', main: m.actualDailyChangeKg === null ? '—（记录不足）' : String(m.actualDailyChangeKg) + ' kg/天',
-            },
-            {
-                left: '热量调整', main: m.calorieAdjustment === null ? '—' : String(m.calorieAdjustment) + ' 卡',
-            },
-        ],
-    }));
-    parts.push(copyBlock('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: 'calorie.view.weight-review',
-            data: {
-                metrics: metricsOf({
-                    currentWeight: m.currentWeight, weightGoal: m.weightGoal,
-                    gapKg: m.gapKg, actualDailyChangeKg: m.actualDailyChangeKg,
-                    estDays: m.estDays, calorieAdjustment: m.calorieAdjustment,
-                }),
-            },
-        },
-    }));
-    return assemble('体重复核 ' + v.today, 'calorie.view.weight-review · 运动身体域', m.status, parts.join(''), false);
+/** 目标页数值四格（本页「目标／实际／完成度／差额」唯一的落点：环只给一眼的完成度，逐项对照全在这里）。
+ *  #523 返修：判决只住胶囊一处（窗口条后的状态徽标与环心判语两处已撤，不再一页三遍）；**#602 补题**：本块原只有裸 KPI 卡格、块内无可见标题（终审 #268 §2.6 N1 的页枚举漏了 23／24 两页），现照同件 `sec-kpi`／`sec-dist` 同形，把题作为 `<section>` 首个子节点补上——题词与页内导航同源（都取 `card()` 的 label「数值对照」，两处不会走散），风格同档（15px／700）。 */
+function goalFigures(v, goalTotal) {
+    return renderKpiGrid([
+        { label: '目标', value: fmtNum(goalTotal, 0), unit: '卡' },
+        { label: '实际', value: fmtNum(v.actual, 0), unit: '卡' },
+        { label: '完成度', value: fmtNum(v.pct) + '%', detail: '环最高画到 100%' },
+        { label: '差额', value: fmtNum(Math.abs(v.gap), 0), unit: '卡', detail: v.gap >= 0 ? '超出目标' : '还差这么多' },
+    ]);
 }
-/* ── 波动分析（weight_volatility_v2.html 对照：基线＋阈值＋预警＋异常点） ── */
-export function buildVolatilityDoc(v) {
-    const o = v.volatility;
-    const parts = [renderKpiGrid([
-            { label: '波动分析', value: '基线 ' + o.baselineValue + ' kg', detail: o.baselineToggleLabel },
-            {
-                label: '阈值', value: '黄±' + o.thresholds.yellow + ' 红±' + o.thresholds.red + ' kg',
-                detail: 'σ=' + o.baselineSigma + 'kg · ' + v.baselineMode + '基线',
-            },
-            { label: '预警', value: o.earlyWarning.level, detail: o.earlyWarning.message },
-            {
-                label: '近期异常', value: String(o.recentAnomalies.length), unit: '个',
-                detail: '共 ' + o.points.length + ' 点',
-            },
-        ])];
-    let charts = false;
-    if (o.points.length > 0) {
-        parts.push(renderChartBlock({
-            kind: 'line',
-            title: '偏离基线',
-            input: { items: o.points.map((p) => ({ label: p.date.slice(5), value: p.deviationKg })) },
-        }));
-        charts = true;
-    }
-    parts.push(renderDataTable({
-        columns: [
-            { key: 'date', label: '日期' },
-            { key: 'kg', label: '体重', align: 'right' },
-            { key: 'dev', label: '偏离', align: 'right' },
-            { key: 'level', label: '级别' },
-        ],
-        rows: o.recentAnomalies.map((p) => ({ date: p.date, kg: p.kg, dev: p.deviationKg, level: p.level })),
-        caption: '近期异常点（共 ' + o.recentAnomalies.length + ' 个，黄/红阈上）',
-        emptyText: '近期无异常点（基线 ' + o.baselineValue + ' kg，黄±' + o.thresholds.yellow + ' 红±' + o.thresholds.red + '）',
-    }));
-    parts.push(copyBlock('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: 'calorie.view.volatility',
-            data: {
-                metrics: {
-                    baselineValue: o.baselineValue, baselineSigma: o.baselineSigma,
-                    yellow: o.thresholds.yellow, red: o.thresholds.red,
-                    points: o.points.length, anomalies: o.recentAnomalies.length,
-                    deviationKg: o.earlyWarning.deviationKg,
-                },
-            },
-        },
-    }));
-    return assemble('波动分析 ' + v.start + ' ~ ' + v.end, 'calorie.view.volatility · 运动身体域', o.earlyWarning.message, parts.join(''), charts);
+/** 周口径那句：**全仓只在本件算一处（days === 7 时才对周口径负责）、写一处**。
+ *  返回 `null` ＝ 本窗不是整周，不出这句（免得把日口径页也印成周口径）。 */
+function weekCaliberLine(v, goalTotal) {
+    if (v.days !== 7)
+        return null;
+    return '周目标口径＝每日目标 × 7：每日目标 ' + fmtNum(v.dailyGoal, 0) + ' 卡 × 7 = ' + fmtNum(goalTotal, 0) + ' 卡';
 }
-/* ── 体成分（body_composition_view.html 对照：来源筛选＋趋势＋记录表＋复制） ── */
-export function buildBodyCompositionDoc(v) {
+/** 目标页口径行（#523 一条事实一行；周口径那句只走这里一处）。 */
+function goalCalibers(v, goalTotal) {
     const parts = [
-        renderParamForm({
-            fields: [{ name: 'source', label: '来源', value: v.source ?? '' }],
-            description: '按来源筛选体成分（空=全部；趋势默认最近来源；对比两期归组合分析）',
-        }),
-        renderKpiGrid([
-            { label: '体成分看', value: v.source ?? '全部来源', detail: '共 ' + v.total + ' 条' },
-            { label: '最新体脂', value: v.latestPct === null ? '—' : String(v.latestPct) + '%' },
-            { label: '趋势点', value: String(v.trend.length), unit: '天' },
-        ]),
+        '完成度＝实际 ÷ 目标',
+        '差额＝实际 − 目标',
+        '每日目标 ' + fmtNum(v.dailyGoal, 0) + ' 卡',
     ];
-    let charts = false;
-    if (v.trend.length > 0) {
-        parts.push(renderChartBlock({
-            kind: 'line',
-            title: '体脂趋势',
-            input: { items: v.trend.map((t) => ({ label: t.date.slice(5), value: t.avgPct })) },
-        }));
-        charts = true;
+    if (goalTotal !== null) {
+        const week = weekCaliberLine(v, goalTotal);
+        if (week !== null)
+            parts.push(week);
     }
-    const rows = v.items.map((r) => {
-        const d = r;
-        return {
-            date: typeof d.date === 'string' ? d.date : '',
-            pct: typeof d.body_fat_pct === 'number' ? d.body_fat_pct : '',
-            source: typeof d.source === 'string' ? d.source : '',
-            note: typeof d.note === 'string' ? d.note : '',
-        };
-    });
-    parts.push(renderDataTable({
-        columns: [
-            { key: 'date', label: '日期' },
-            { key: 'pct', label: '体脂', align: 'right' },
-            { key: 'source', label: '来源' },
-            { key: 'note', label: '备注' },
-        ],
-        rows,
-        caption: '体成分记录（共 ' + v.total + ' 条）',
-        emptyText: '无体成分记录',
-    }));
-    parts.push(copyBlock('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'list', key: 'calorie.view.body-composition',
-            data: { items: rows, total: v.total },
-        },
-    }));
-    return assemble('体成分看', 'calorie.view.body-composition · 运动身体域', null, parts.join(''), charts);
+    return parts;
 }
-/* ── 围度（body_measurements_view.html 对照：项目筛选＋趋势＋记录表＋复制，13 项） ── */
-const MEASURE_ZH = {
-    chest_cm: '胸围', waist_cm: '腰围', abdomen_cm: '腹围', hip_cm: '臀围',
-    left_thigh_cm: '左大腿', right_thigh_cm: '右大腿', left_calf_cm: '左小腿', right_calf_cm: '右小腿',
-    left_arm_cm: '左上臂', right_arm_cm: '右上臂', left_forearm_cm: '左前臂', right_forearm_cm: '右前臂',
-    shoulder_cm: '肩宽',
-};
-export function buildBodyMeasureDoc(v) {
-    const parts = [
-        renderParamForm({
-            fields: [{ name: 'metric', label: '围度项', value: v.metric ?? '' }],
-            description: '13 围度项按名筛选（空=全部；趋势需指定单项；两期对比归组合分析）',
-        }),
-        renderKpiGrid([
-            { label: '围度看', value: v.metric ? (MEASURE_ZH[v.metric] ?? v.metric) : '全部围度', detail: '共 ' + v.total + ' 条' },
-            { label: '最新', value: v.latestVal === null ? '—' : String(v.latestVal) + 'cm', detail: v.metric ? (MEASURE_ZH[v.metric] ?? v.metric) : '' },
-            { label: '趋势点', value: String(v.trend.length), unit: '天' },
-        ]),
-    ];
-    let charts = false;
-    if (v.metric && v.trend.length > 0) {
-        parts.push(renderChartBlock({
-            kind: 'line',
-            title: (MEASURE_ZH[v.metric] ?? v.metric) + '趋势',
-            input: { items: v.trend.map((t) => ({ label: t.date.slice(5), value: t.avgVal })) },
-        }));
-        charts = true;
-    }
-    if (v.metric) {
-        const mkey = v.metric;
-        parts.push(renderDataTable({
-            columns: [
-                { key: 'date', label: '日期' },
-                { key: 'val', label: (MEASURE_ZH[mkey] ?? mkey) + '(cm)', align: 'right' },
-                { key: 'note', label: '备注' },
-            ],
-            rows: v.items.map((r) => {
-                const val = r[mkey];
-                return {
-                    date: typeof r['date'] === 'string' ? r['date'] : '',
-                    val: typeof val === 'number' ? val : '',
-                    note: typeof r['note'] === 'string' ? r['note'] : '',
-                };
+function goalEnvelope(v) {
+    return {
+        version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: '运动目标',
+        data: {
+            metrics: metricsOf({
+                dailyGoal: v.dailyGoal, goalTotal: v.goalTotal, actual: v.actual,
+                pct: v.pct, gap: v.gap, achieved: v.achieved ? 1 : 0, days: v.days,
             }),
-            caption: (MEASURE_ZH[mkey] ?? mkey) + '记录（共 ' + v.total + ' 条）',
-            emptyText: '该项目无记录',
-        }));
-    }
-    else {
-        const numOrEmpty = (x) => (typeof x === 'number' ? x : '');
-        const strOrEmpty = (x) => (typeof x === 'string' ? x : '');
-        parts.push(renderDataTable({
-            columns: [
-                { key: 'date', label: '日期' },
-                { key: 'chest', label: '胸', align: 'right' },
-                { key: 'waist', label: '腰', align: 'right' },
-                { key: 'abdomen', label: '腹', align: 'right' },
-                { key: 'hip', label: '臀', align: 'right' },
-                { key: 'note', label: '备注' },
-            ],
-            rows: v.items.map((r) => ({
-                date: strOrEmpty(r['date']), chest: numOrEmpty(r['chest_cm']), waist: numOrEmpty(r['waist_cm']),
-                abdomen: numOrEmpty(r['abdomen_cm']), hip: numOrEmpty(r['hip_cm']), note: strOrEmpty(r['note']),
-            })),
-            caption: '围度记录（共 ' + v.total + ' 条；全量 13 项见复制数据）',
-            emptyText: '无围度记录',
-        }));
-    }
-    const rows = v.items.map((r) => ({ ...r }));
-    parts.push(copyBlock('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'list', key: 'calorie.view.body-measure',
-            data: { items: rows, total: v.total },
         },
-    }));
-    return assemble('围度看', 'calorie.view.body-measure · 运动身体域', null, parts.join(''), charts);
+    };
+}
+/** 运动目标整页：目标缺席（`goalTotal`／`pct` 为 `null`）＝专门空态、**不画空环**；
+ *  有目标＝环卡（`min(pct,100)`）＋判决胶囊两态＋差距文案。 */
+export function buildExerciseGoalDoc(v, cmd) {
+    const env = goalEnvelope(v);
+    const copy = docCopy(env, cmd ?? commandLine('calorie.view.exercise-goal', { start: v.start, end: v.end }), v.source ?? 'daily_goal ＋ exercise_log（只读对照）');
+    // #523 返修 R3：单日窗原来印成「运动目标 2026-09-15 ~ 2026-09-15」——同一天在 H1 里写两遍
+    // （窗口条与来源脚注再各一份，视觉复评 R2 记 −3）。起止同日只印一次，与窗口条的退化分支同口径。
+    const title = '运动目标 ' + (v.start === v.end ? v.start : rangeText(v.start, v.end));
+    if (v.goalTotal === null || v.pct === null) {
+        return assembleDocPage({
+            docTitle: DOC_TITLE, title, eyebrow: GOAL_EYEBROW, subtitle: '还没设每日运动消耗目标',
+            content: exerciseUiCss() + '<section id="sec-empty">' + emptyGuide({
+                icon: '🎯', text: '还没设每日运动消耗目标',
+                hint: '先说一句「定营养目标」把每日运动消耗目标定下来，再看这张对照页。',
+            }) + '</section>',
+            printable: true,
+        }) + copy;
+    }
+    const goalTotal = v.goalTotal;
+    const cards = [
+        card('sec-ring', '目标环', ringCard(v, v.pct)),
+        card('sec-figures', '数值对照', '<h2 style="margin:0;font-size:15px;font-weight:700">数值对照</h2>' + goalFigures(v, goalTotal)),
+    ];
+    const source = footFacts(SOURCE_GOAL, v.start, v.end, v.days);
+    return assembleDocPage({
+        docTitle: DOC_TITLE, title, eyebrow: GOAL_EYEBROW,
+        subtitle: '这段时间的运动消耗与每日目标的对照',
+        content: windowStrip(v.start, v.end, v.days + ' 天')
+            + pageBody(cards, goalCalibers(v, goalTotal), source, copy),
+        printable: true,
+    });
 }
+/* ── 身体两页已迁出（#353）：体成分／围度整页文档原样迁入 `src/body/bodyDocs.ts`，本件只留运动页。 ── */
 //# sourceMappingURL=sportDocs.js.map