skill-calorie 0.2.3 → 0.2.5

package/dist/render/dietDocs.js

@@ -16,453 +16,203 @@
  * 行级页（榜单/食品/明细/去重）走 list 投影（JSON 行，旧「复制榜单/复制回 AI」的数据等价物）。
  * 本层不做取数（数据由调用方 dispatch 备齐），不返空（缺失由数据层抛 missing-data）。
  */
-import { renderChartBlock, renderDataTable, renderDisclosure, renderKpiGrid, renderListRows, renderParamForm, } from 'base-paint/blocks';
+import { renderCaliberLine, renderChartBlock, renderDataTable, renderDisclosure, renderEmptyBlock, renderKpiGrid, renderListRows, renderTocBlock, } from 'base-paint/blocks';
 import { assembleDocPage } from '../shared/docPage.js';
 import { dataCopyArea } from '../shared/copyArea.js';
+import { emptyGuide } from '../shared/emptyGuide.js';
+import { DIET_LIST_COLUMNS, buildDietOverviewPage, buildMealDistributionPage, listPageCopy, minuteOf, noteOf } from '../diet/todayDocs.js';
 import { inferMealType } from '../fetch/diet.js';
 /** envelope 头（值冻结对齐 cli/keys.ts ENVELOPE_VERSION／CALORIE_SKILL；测试钉死一致）。 */
 const DOC_VERSION = '0.1.0';
 const DOC_SKILL = 'calorie';
-/** 本文件各页共用的 head 标题（整页模板住 `src/shared/docPage.ts`，标题走参数）。 */
-const DOC_TITLE = '卡路里·饮食';
-function fmt(n) {
-    if (n === null || n === undefined)
-        return '—';
-    return String(n);
+/** 本文件各页共用的 head 标题（整页模板住 `src/shared/docPage.ts`，标题走参数）；#591 去 `·`（门禁 R1），取值照同域 ② 类页现行口径（`diet/todayDocs.ts` 的「卡路里饮食」）。 */
+const DOC_TITLE = '卡路里饮食';
+/* LF 口径：#618 要给本件（HEAD 已是 350 LF）加一处映射，同票把下面两个小件压成一行等价写法（本包告警线
+   台账住 `packages/skill-calorie/AGENTS.md`，不在本票写集 ⇒ 不越线、不改台账）。 */
+const fmt = (n) => (n === null || n === undefined) ? '—' : String(n);
+const r1 = (n) => Math.round(n * 10) / 10;
+/** #618 趋势卡的中文判语（**本件唯一一处映射**，8 张窗口页共走 `buildViewDietDoc` 故只此一份）：用户原话
+ *  「趋势这个卡片写的是『up/down』不应该有英文」；数据层 `'up' | 'down' | 'flat'`（`analysis/trend.ts:26`）口径不动，只在页面侧换人话，表外值原样透传（照 `trendPredictDocs.ts` 的 `DEFICIT_TREND_ZH ?? …`）。 */
+const TREND_ZH = { up: '上升', down: '下降', flat: '持平' };
+/** 餐别口径一行（**正文里说一次**的版本，不带常量名）。
+ *
+ *  #496 · 原文案是「窗口跟 MEAL_WINDOWS · 加餐=下午茶+夜宵」——把源码常量名印给用户看
+ *  （`.scratch/t155o/text-review-P0.md` 第 2、62、68 条，四份审查件共 14 席命中）。
+ *  现在只留读者用得上的那半句：加餐是哪几顿（#591：「、」也去掉，两顿用「和」并列）。 */
+const MEAL_NOTE = '加餐时段：下午茶和夜宵';
+/* ── #551 · 副题与 caption 一带的形状件（写集只给本件：窗口条＋事实条，字号 12／13，断点 820 照 HELP）── */
+const DIET_SHAPE_CSS = '<style>.diet-window,.diet-facts{display:flex;flex-wrap:wrap;align-items:center;gap:8px 16px;margin:4px 0 12px}'
+    + '.diet-date{font-size:13px;font-weight:600;background:var(--card);border:1px solid var(--line);border-radius:8px;padding:4px 8px}'
+    + '.diet-arrow{font-size:13px;color:var(--fg3)}.diet-chip{font-size:12px;font-weight:700;color:var(--blue2);background:var(--soft);border-radius:999px;padding:4px 8px}'
+    + '.diet-fact{display:inline-flex;gap:8px;align-items:baseline}.diet-fact-k{font-size:12px;color:var(--fg3);white-space:nowrap}'
+    + '.diet-fact-v{font-size:13px;font-weight:600;font-variant-numeric:tabular-nums}'
+    + '@media (max-width:820px){.diet-facts{flex-direction:column;align-items:stretch;gap:8px}.diet-fact{justify-content:space-between}}</style>';
+const dietEsc = (s) => s.replace(/[&<>"']/g, (c) => c === '&' ? '&amp;' : c === '<' ? '&lt;' : c === '>' ? '&gt;' : c === '"' ? '&quot;' : '&#39;');
+function dietHead(start, end, chip, facts) {
+    const mid = start === end ? '<span class="diet-date">' + dietEsc(start) + '（单日）</span>' : '<span class="diet-date">' + dietEsc(start) + '</span><span class="diet-arrow">→</span><span class="diet-date">' + dietEsc(end) + '</span>';
+    return DIET_SHAPE_CSS + '<div class="diet-window">' + mid + '<span class="diet-chip">' + dietEsc(chip) + '</span></div><div class="diet-facts">'
+        + facts.map(([k, v]) => '<span class="diet-fact"><span class="diet-fact-k">' + dietEsc(k) + '</span><span class="diet-fact-v">' + dietEsc(v) + '</span></span>').join('') + '</div>';
 }
-function r1(n) {
-    return Math.round(n * 10) / 10;
+/* ── 条目列表页（`calorie.view.diet` 的窗口词；老实物 `today_meals.html` 对照） ── */
+/** 区块锚点（页内导航 `renderTocBlock` 的落点；名字照作者认可的样张
+ *  `docs/skills/skill-calorie/t425-样张-今日饮食.html` 的 `sec-*` 一套）。 */
+const LIST_ANCHOR = {
+    kpi: 'sec-kpi', trend: 'sec-trend', dist: 'sec-dist', daily: 'sec-daily', meals: 'sec-meals', copy: 'sec-copy',
+};
+/** 区块外面套一层带锚点的 `<section>`（页内导航点得到才出这一项——不留死链接）。 */
+function anchored(id, html) {
+    return '<section id="' + id + '">' + html + '</section>';
 }
-const MEAL_NOTE = '窗口跟 MEAL_WINDOWS · 加餐=下午茶+夜宵';
-export function buildTodayDietDoc(input) {
-    const { overview: o, dist, meals, macro } = input;
-    const names = new Set(meals.map((m) => m.food_name));
-    const kpis = renderKpiGrid([
-        { label: '当日摄入', value: String(o.totalCalories), unit: '卡', detail: '目标 ' + o.calorieGoal + ' 卡' },
-        { label: '餐数', value: String(meals.length), unit: '条', detail: names.size + ' 个品种' },
-        { label: '热量目标', value: String(o.calorieGoal), unit: '卡', detail: '剩余 ' + (o.calorieGoal - o.totalCalories) + ' 卡' },
-        { label: '餐别覆盖', value: dist.slices.filter((s) => s.count > 0).length + '/' + dist.slices.length, detail: MEAL_NOTE },
-    ]);
-    const parts = [kpis];
+/** 老新对照的明细列（老实物 `today_meals.html:168` 的九列）住在 `../diet/todayDocs.ts` 的
+ *  `DIET_LIST_COLUMNS`——今日页与窗口页同族，列面只准有一处。 */
+/** 条目列表页（② 类，`t425-融合基准.md` §五 的 15 行骨架逐行落位；老实物 `today_meals.html`）。
+ *
+ *  裁定落点：1 眉标只写人话、源码标识符不上屏；2 结论句走标题下第一行（样张做法＝复用副题槽）；
+ *  3 页内导航 ＋ 口径说明行 ＋ 来源脚注三条恒出；4 缺值一律 `—`、空窗出完整页 ＋ 空态句 ＋ 引导句；
+ *  5 零值不画柱身、单点不成线（点数不足出说明句）；7 复制区双按钮、日志第 4 段＝本次命令原文。 */
+export function buildViewDietDoc(input) {
+    /* 餐别筛选那一支（`meal` 参数由命令面带进来）：整页换成餐别分布页（#273 交付的具名区块）。 */
+    if (input.mealView !== undefined)
+        return buildMealDistributionPage(input.mealView, input.command);
+    /* 「看饮食总览」那一支：整页换成总览页（#275 交付的具名区块）。 */
+    if (input.overviewView !== undefined)
+        return buildDietOverviewPage(input.overviewView, input.command);
+    const { overview: o, dist, distDate, days, meals, mealTotal, mealsTruncated } = input;
+    const loggedDays = days.filter((d) => d.calories !== null);
+    /* 裁定 4：本窗一条记录也没有 ⇒ 整页仍是完整页（空态句 ＋ 引导句 ＋ 来源脚注都在），图表不画。 */
+    const empty = loggedDays.length === 0;
+    /* 移植清单 5 的排序口径（老 `today_meals.html:322`）：明细按日期＋时间**倒序**，最近的排最前。 */
+    const rows = [...meals].sort((a, b) => (b.date + (b.time ?? '')).localeCompare(a.date + (a.time ?? '')));
     let charts = false;
-    if (dist.totalCalories > 0) {
-        parts.push(renderChartBlock({
-            kind: 'bar',
-            title: '餐别热量占比',
-            input: { items: dist.slices.map((s) => ({ label: s.meal, value: s.calories })) },
-        }));
-        charts = true;
-    }
-    if (macro && (macro.protein || macro.carb || macro.fat)) {
-        parts.push(renderChartBlock({
-            kind: 'donut',
-            title: '营养配比',
-            input: {
-                items: [
-                    { label: '蛋白', value: macro.protein ? macro.protein.pct : 0 },
-                    { label: '碳水', value: macro.carb ? macro.carb.pct : 0 },
-                    { label: '脂肪', value: macro.fat ? macro.fat.pct : 0 },
-                ],
-                options: { showPercent: true },
-            },
-        }));
-        charts = true;
-    }
-    parts.push(renderDataTable({
-        columns: [
-            { key: 'time', label: '时间' },
-            { key: 'meal', label: '餐别' },
-            { key: 'food', label: '食物' },
-            { key: 'grams', label: '克数', align: 'right' },
-            { key: 'cal', label: '热量', align: 'right' },
-            { key: 'pro', label: '蛋白', align: 'right' },
-            { key: 'carbs', label: '碳水', align: 'right' },
-            { key: 'fat', label: '脂肪', align: 'right' },
+    const parts = [];
+    /* §五 第 4 行：页内导航只列**真会出**的区块（点不到的项就是死链接）。 */
+    parts.push(renderTocBlock({
+        items: [
+            { id: LIST_ANCHOR.kpi, text: '读数' },
+            ...(empty ? [] : [{ id: LIST_ANCHOR.trend, text: '每日摄入' }]),
+            { id: LIST_ANCHOR.dist, text: '餐别分布' },
+            ...(empty ? [] : [
+                { id: LIST_ANCHOR.daily, text: '按日汇总' },
+                { id: LIST_ANCHOR.meals, text: '每日明细' },
+            ]),
+            { id: LIST_ANCHOR.copy, text: '复制区' },
         ],
-        rows: meals.map((m) => ({
-            time: m.time ?? '', meal: inferMealType(String(m.time ?? '')), food: m.food_name,
-            grams: m.grams, cal: m.calories, pro: m.protein, carbs: m.carbs, fat: m.fat,
-        })),
-        caption: '今日明细（' + o.start + '，共 ' + meals.length + ' 条）',
-        emptyText: '本日无明细',
-    }));
-    parts.push(dataCopyArea('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'list', key: 'calorie.today',
-            data: {
-                items: meals.map((m) => ({
-                    date: m.date, time: m.time, food_name: m.food_name, grams: m.grams,
-                    calories: m.calories, protein: m.protein, carbs: m.carbs, fat: m.fat,
-                })),
-                total: meals.length,
-            },
-        },
     }));
-    return assembleDocPage({
-        docTitle: DOC_TITLE,
-        title: '今日饮食 ' + o.start,
-        eyebrow: 'calorie.today · 饮食域',
-        subtitle: MEAL_NOTE,
-        content: parts.join(''),
-        charts,
-    });
-}
-const MEAL_COLUMNS = [
-    { key: 'date', label: '日期' },
-    { key: 'time', label: '时间' },
-    { key: 'meal', label: '餐别' },
-    { key: 'food', label: '食物' },
-    { key: 'grams', label: '克数', align: 'right' },
-    { key: 'cal', label: '热量', align: 'right' },
-    { key: 'pro', label: '蛋白', align: 'right' },
-    { key: 'carbs', label: '碳水', align: 'right' },
-    { key: 'fat', label: '脂肪', align: 'right' },
-];
-export function buildViewDietDoc(input) {
-    const { overview: o, dist, distDate, days, meals, mealTotal, mealsTruncated } = input;
-    const kpis = renderKpiGrid([
+    /* #551 · 副题只留一句结论，五事实落窗口条＋事实条（390 靠 flex-wrap＋820 纵列）。 */
+    parts.push(dietHead(o.start, o.end, '共 ' + o.days + ' 天', [['有记录', o.loggedDays + ' 天'], ['记录', mealTotal + ' 条'], ['合计', o.totalCalories + ' 卡'], ['日均', fmt(o.avgCalories) + ' 卡']]));
+    /* §五 第 5 行：KPI 读数。 */
+    parts.push(anchored(LIST_ANCHOR.kpi, renderKpiGrid([
         { label: '累计', value: String(o.totalCalories), unit: '卡', detail: o.loggedDays + '/' + o.days + '天有记录' },
         { label: '日均', value: fmt(o.avgCalories), unit: '卡' },
         { label: '目标', value: String(o.calorieGoal), unit: '卡' },
-        { label: '趋势', value: o.trend.summary.trend, detail: '均值 ' + o.trend.summary.avg + ' 卡' },
-    ]);
-    const parts = [kpis];
-    let charts = false;
-    const loggedDays = days.filter((d) => d.calories !== null);
-    if (loggedDays.length > 0) {
-        parts.push(renderChartBlock({
+        { label: '趋势', value: TREND_ZH[o.trend.summary.trend] ?? o.trend.summary.trend, detail: '均值 ' + o.trend.summary.avg + ' 卡' },
+    ])));
+    /* §五 第 6 行：主体折线。裁定 5 —— 单点不成线：只画**两点及以上**，否则出一句说明。 */
+    if (loggedDays.length >= 2) {
+        parts.push(anchored(LIST_ANCHOR.trend, renderChartBlock({
             kind: 'line',
             title: '每日摄入',
             input: {
                 items: days.map((d) => ({ label: d.date.slice(5), value: d.calories })),
                 options: { markLine: { value: o.avgCalories ?? undefined, label: '日均' } },
             },
-        }));
+        })));
         charts = true;
     }
+    else if (loggedDays.length === 1) {
+        parts.push(anchored(LIST_ANCHOR.trend, renderEmptyBlock({
+            title: '每日摄入',
+            text: '本窗只有 ' + loggedDays[0].date + ' 一天有记录，一个点画不成折线（不画半截线）。',
+        })));
+    }
     if (dist.totalCalories > 0) {
-        parts.push(renderChartBlock({
+        parts.push(anchored(LIST_ANCHOR.dist, renderChartBlock({
             kind: 'bar',
             title: '餐别分布 ' + distDate,
             input: { items: dist.slices.map((s) => ({ label: s.meal + ' ' + s.count + '餐', value: s.calories })) },
-        }));
+        })));
+        /* #496 · 餐别口径（加餐是哪几顿）只在图下说一次，不带常量名。 */
+        parts.push(renderCaliberLine(MEAL_NOTE));
         charts = true;
     }
     else {
-        parts.push(renderKpiGrid(dist.slices.map((s) => ({
-            label: '餐别分布 ' + s.meal, value: '0', unit: '卡', detail: distDate + ' 无记录（窗内有数，仅尾日回零）',
-        }))));
-    }
-    parts.push(renderDataTable({
-        columns: [
-            { key: 'date', label: '日期' },
-            { key: 'cal', label: '摄入', align: 'right' },
-            { key: 'pro', label: '蛋白', align: 'right' },
-            { key: 'carbs', label: '碳水', align: 'right' },
-            { key: 'fat', label: '脂肪', align: 'right' },
-            { key: 'goal', label: '目标', align: 'right' },
-        ],
-        rows: days.map((d) => ({
-            date: d.date, cal: d.calories, pro: d.protein, carbs: d.carbs, fat: d.fat, goal: d.calorieGoal,
-        })),
-        caption: '按日汇总（' + o.start + ' ~ ' + o.end + '，无记录日留空，不断 0）',
-        emptyText: '本窗无按日汇总',
-    }));
-    parts.push(renderDisclosure({
-        title: '窗口明细（共 ' + mealTotal + ' 条' + (mealsTruncated ? '，仅列前 ' + meals.length + ' 条' : '') + '）',
-        contentHtml: renderDataTable({
-            columns: [...MEAL_COLUMNS],
-            rows: meals.map((m) => ({
-                date: m.date, time: m.time ?? '', meal: inferMealType(String(m.time ?? '')), food: m.food_name,
-                grams: m.grams, cal: m.calories, pro: m.protein, carbs: m.carbs, fat: m.fat,
-            })),
-            caption: '窗口明细' + (mealsTruncated ? '（截断前 ' + meals.length + ' 条）' : ''),
-            emptyText: '本窗无明细',
-        }),
-    }));
-    parts.push(dataCopyArea('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: 'calorie.view.diet',
-            data: {
-                metrics: {
-                    totalCalories: o.totalCalories, loggedDays: o.loggedDays, days: o.days,
-                    calorieGoal: o.calorieGoal, distTotal: dist.totalCalories,
-                },
-            },
-        },
-    }));
-    return assembleDocPage({
-        docTitle: DOC_TITLE,
-        title: '饮食总览 ' + o.start + ' ~ ' + o.end,
-        eyebrow: 'calorie.view.diet · 饮食域',
-        subtitle: '餐别分布 ' + distDate + '（' + MEAL_NOTE + '）',
-        content: parts.join(''),
-        charts,
-    });
-}
-/* ── 饮食复盘（diet_review.html 对照：每日热量趋势＋配比＋高频 TOP＋按餐汇总） ── */
-export function buildDietReviewDoc(r, top5) {
-    const t = r.trend.status === 'ok' && r.trend.data ? r.trend.data : null;
-    const m = r.macro.status === 'ok' && r.macro.data ? r.macro.data : null;
-    const macroText = m && m.protein
-        ? '蛋白/碳水/脂肪 ' + m.protein.pct + '/' + (m.carb ? m.carb.pct : '—') + '/' + (m.fat ? m.fat.pct : '—')
-        : '—';
-    const parts = [renderKpiGrid([
-            {
-                label: '热量',
-                value: t ? String(t.totalCal) + ' 卡' : '—',
-                detail: t ? '日均 ' + t.avgCal + ' 卡 · ' + r.loggedDays + ' 天有记录' : r.loggedDays + ' 天有记录',
-            },
-            { label: '配比', value: macroText },
-            {
-                label: '达标天', value: t ? String(t.complianceDays) + '/' + t.daysCount : '—',
-                detail: t && t.calGoal ? '目标 ' + t.calGoal + ' 卡（±10%）' : '未设热量目标',
-            },
-            {
-                label: '周末/工作日', value: t ? t.weekendAvg + '/' + t.weekdayAvg : '—',
-                detail: '均值（卡）',
-            },
-        ])];
-    let charts = false;
-    if (t && t.daily.length > 0) {
-        parts.push(renderChartBlock({
-            kind: 'line',
-            title: '每日热量趋势',
-            input: {
-                items: t.daily.map((d) => ({ label: d.date.slice(5), value: d.totalCal })),
-                options: { avgLine: t.avgCal },
-            },
-        }));
-        charts = true;
+        /* 裁定 5：零值不画柱身；裁定 4：这一支的值位是「尾日没记录」而不是「吃了 0 卡」⇒ 值位写 `—`。 */
+        parts.push(anchored(LIST_ANCHOR.dist, renderKpiGrid(dist.slices.map((s) => ({
+            label: '餐别分布 ' + s.meal, value: '—', detail: distDate + ' 无记录（窗内有数，仅尾日回零）',
+        })))));
     }
-    if (m && (m.protein || m.carb || m.fat)) {
-        parts.push(renderChartBlock({
-            kind: 'donut',
-            title: '营养配比',
-            input: {
-                items: [
-                    { label: '蛋白', value: m.protein ? m.protein.pct : 0 },
-                    { label: '碳水', value: m.carb ? m.carb.pct : 0 },
-                    { label: '脂肪', value: m.fat ? m.fat.pct : 0 },
-                ],
-                options: { showPercent: true },
-            },
-        }));
-        charts = true;
+    if (empty) {
+        /* §五 第 12 行：空态块 ＋ 一句「怎么记第一条」的引导句（裁定 4）。 */
+        parts.push(anchored(LIST_ANCHOR.meals, emptyGuide({
+            icon: '🍽️',
+            text: '这一段时间（' + o.start + ' ~ ' + o.end + '）没有饮食记录。',
+            hint: '要让它有内容，说「记一餐」把吃的那顿记上；补以前的日期就说「补记饮食」。',
+        })));
     }
-    const top = top5 ? top5.items : [];
-    parts.push(renderDataTable({
-        columns: [
-            { key: 'rank', label: '排名', align: 'right' },
-            { key: 'food', label: '食物' },
-            { key: 'cal', label: '总热量', align: 'right' },
-            { key: 'cnt', label: '次数', align: 'right' },
-            { key: 'avg', label: '餐均', align: 'right' },
-        ],
-        rows: top.slice(0, 5).map((it) => ({
-            rank: it.rank, food: it.foodName, cal: it.totalCal, cnt: it.cnt, avg: it.avgCalPerMeal,
-        })),
-        caption: '高频食物 TOP5（' + r.start + ' ~ ' + r.end + '）',
-        emptyText: '本窗无高频食物',
-    }));
-    parts.push(renderDataTable({
-        columns: [
-            { key: 'meal', label: '餐别' },
-            { key: 'days', label: '天数', align: 'right' },
-            { key: 'cal', label: '累计热量', align: 'right' },
-        ],
-        rows: r.byMeal.map((s) => ({ meal: s.meal, days: s.days, cal: s.totalCalories })),
-        caption: '按餐汇总（' + MEAL_NOTE + '）',
-        emptyText: '本窗无按餐汇总',
-    }));
-    parts.push(dataCopyArea('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: 'calorie.view.diet-review',
-            data: { metrics: { loggedDays: r.loggedDays } },
-        },
-    }));
-    return assembleDocPage({
-        docTitle: DOC_TITLE,
-        title: '饮食复盘 ' + r.start + ' ~ ' + r.end,
-        eyebrow: 'calorie.view.diet-review · 饮食域',
-        subtitle: null,
-        content: parts.join(''),
-        charts,
-    });
-}
-/* ── 食品排行（food_ranking.html 对照：榜单表＋复制榜单；tab 交互归宿主，静态页逐榜/全榜直出） ── */
-const RANK_ZH = {
-    high_calorie: '高热量', low_calorie: '低热量', frequent: '常吃', high_carb: '高碳水', high_protein: '高蛋白',
-};
-const RANK_COLUMNS = [
-    { key: 'rank', label: '排名', align: 'right' },
-    { key: 'food', label: '食物' },
-    { key: 'cal', label: '总热量', align: 'right' },
-    { key: 'cnt', label: '次数', align: 'right' },
-    { key: 'avg', label: '餐均', align: 'right' },
-    { key: 'pro', label: '蛋白', align: 'right' },
-    { key: 'carbs', label: '碳水', align: 'right' },
-    { key: 'fat', label: '脂肪', align: 'right' },
-];
-export function buildRankingDoc(r) {
-    const top = r.items[0];
-    const parts = [renderKpiGrid([
-            { label: '榜单', value: RANK_ZH[r.category] ?? r.category, detail: r.start + ' ~ ' + r.end },
-            { label: '上榜', value: String(r.items.length), unit: '种', detail: 'TOP ' + r.topN },
-            {
-                label: '头名', value: top ? top.foodName : '—',
-                detail: top ? top.totalCal + ' 卡 · ' + top.cnt + ' 次 · 均 ' + top.avgCalPerMeal + ' 卡/餐' : '',
-            },
-        ])];
-    parts.push(renderDataTable({
-        columns: [...RANK_COLUMNS],
-        rows: r.items.map((it) => ({
-            rank: it.rank, food: it.foodName, cal: it.totalCal, cnt: it.cnt,
-            avg: it.avgCalPerMeal, pro: it.totalProtein, carbs: it.totalCarbs, fat: it.totalFat,
-        })),
-        caption: r.title,
-        emptyText: '本窗无排行数据',
-    }));
-    parts.push(dataCopyArea('复制榜单', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'list', key: 'calorie.view.ranking',
-            data: {
-                items: r.items.map((it) => ({
-                    rank: it.rank, foodName: it.foodName, totalCal: it.totalCal,
-                    cnt: it.cnt, avgCalPerMeal: it.avgCalPerMeal,
-                })),
-                total: r.items.length,
-            },
-        },
-    }));
-    return assembleDocPage({
-        docTitle: DOC_TITLE,
-        title: '排行 ' + (RANK_ZH[r.category] ?? r.category) + ' ' + r.start + ' ~ ' + r.end,
-        eyebrow: 'calorie.view.ranking · 饮食域',
-        subtitle: 'tab 切换归宿主：单榜直出（' + r.title + '）',
-        content: parts.join(''),
-        charts: false,
-    });
-}
-export function buildAllRankingsDoc(a) {
-    const cats = Object.keys(a.boards);
-    const parts = [renderKpiGrid(cats.map((c) => {
-            const b = a.boards[c];
-            if (!b || !b.items[0])
-                return { label: RANK_ZH[c] ?? c, value: '—', detail: '本窗无数据' };
-            const top = b.items[0];
-            return {
-                label: RANK_ZH[c] ?? c, value: top.foodName + ' ' + top.totalCal + ' 卡', detail: 'TOP ' + b.topN,
-            };
-        }))];
-    for (const c of cats) {
-        const b = a.boards[c];
-        parts.push(renderDisclosure({
-            title: (RANK_ZH[c] ?? c) + '榜' + (b ? '（TOP ' + b.topN + '）' : '（本窗无数据）'),
-            open: b !== null && cats.indexOf(c) === cats.findIndex((k) => a.boards[k] !== null),
+    else {
+        /* §五 第 9 行：主表两张——按日汇总 ＋ 每日明细（明细含**备注列**）。 */
+        parts.push(anchored(LIST_ANCHOR.daily, renderDataTable({
+            columns: [
+                { key: 'date', label: '日期' },
+                { key: 'cal', label: '摄入', align: 'right' },
+                { key: 'pro', label: '蛋白', align: 'right' },
+                { key: 'carbs', label: '碳水', align: 'right' },
+                { key: 'fat', label: '脂肪', align: 'right' },
+                { key: 'goal', label: '目标', align: 'right' },
+            ],
+            /* 裁定 4：无记录日写 `—`，不写 0、也不留空串（老页留空、样张写 `—`）。 */
+            rows: days.map((d) => ({
+                date: d.date, cal: fmt(d.calories), pro: fmt(d.protein), carbs: fmt(d.carbs), fat: fmt(d.fat),
+                goal: fmt(d.calorieGoal),
+            })),
+            /* #551 · caption 只留表名，窗口与口径事实另有去处（窗口在页顶条，口径在表下行），不删事实。 */
+            caption: '按日汇总',
+            emptyText: '本窗无按日汇总',
+        })));
+        parts.push(renderCaliberLine('无记录日写 — 不断 0'));
+        parts.push(anchored(LIST_ANCHOR.meals, renderDisclosure({
+            /* #496 · 折行标题原写「窗口明细」——审查件第 63、64、66、68 条点到它：读者看不出「窗口」是哪扇窗，
+               且这一页的明细就是窗内全部记录 ⇒ 改「全部记录（共 N 条）」。 */
+            title: '全部记录（共 ' + mealTotal + ' 条' + (mealsTruncated ? '，仅列前 ' + meals.length + ' 条' : '') + '）',
+            open: true,
             contentHtml: renderDataTable({
-                columns: [...RANK_COLUMNS],
-                rows: (b ? b.items : []).map((it) => ({
-                    rank: it.rank, food: it.foodName, cal: it.totalCal, cnt: it.cnt,
-                    avg: it.avgCalPerMeal, pro: it.totalProtein, carbs: it.totalCarbs, fat: it.totalFat,
+                columns: [...DIET_LIST_COLUMNS],
+                rows: rows.map((m) => ({
+                    when: m.date + ' ' + minuteOf(m.time), meal: inferMealType(String(m.time ?? '')), food: m.food_name,
+                    grams: m.grams, cal: m.calories, pro: m.protein, carbs: m.carbs, fat: m.fat, note: noteOf(m.note),
                 })),
-                caption: b ? b.title : '本窗无数据',
-                emptyText: '本窗无数据',
+                /* #496 · 这一段原caption 与折叠标题同名同数（「窗口明细（共 N 条）」＋「窗口明细」），
+                   读者在同一行读到两遍（审查件第 64、66 条点的同形重复）。折叠标题已经说全 ⇒ caption 删。 */
+                emptyText: '本窗无明细',
             }),
-        }));
+        })));
     }
-    parts.push(dataCopyArea('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: 'calorie.view.ranking',
-            data: { metrics: { okCount: a.okCount, topN: a.topN } },
-        },
-    }));
-    return assembleDocPage({
-        docTitle: DOC_TITLE,
-        title: '全部排行 ' + a.start + ' ~ ' + a.end,
-        eyebrow: 'calorie.view.ranking · 饮食域',
-        subtitle: a.start + ' ~ ' + a.end + ' · ' + a.okCount + '/5 榜有数据',
-        content: parts.join(''),
-        charts: false,
-    });
-}
-/* ── 查食品／食品库（food_search／food_library 对照：参数表单＋结果表＋复制） ── */
-const PRODUCT_COLUMNS = [
-    { key: 'name', label: '食品名' },
-    { key: 'brand', label: '品牌' },
-    { key: 'cal', label: '热量', align: 'right' },
-    { key: 'pro', label: '蛋白', align: 'right' },
-    { key: 'fat', label: '脂肪', align: 'right' },
-    { key: 'carbs', label: '碳水', align: 'right' },
-    { key: 'sodium', label: '钠', align: 'right' },
-    { key: 'source', label: '来源' },
-];
-export function buildSearchDoc(s) {
-    const rows = s.items.map((p) => ({
-        name: p.product_name, brand: p.brand ?? '', cal: p.calories, pro: p.protein,
-        fat: p.fat, carbs: p.carbohydrates, sodium: p.sodium, source: p.source ?? '',
-    }));
-    const parts = [
-        renderParamForm({
-            fields: [{ name: 'keyword', label: '关键词', value: s.keyword }],
-            description: '食品库按名称/品牌模糊查找（营养值为每 100g；实时搜索归宿主）',
-        }),
-        renderKpiGrid([{ label: '关键词', value: s.keyword, detail: '命中 ' + s.total + ' 条' }]),
-        renderDataTable({
-            columns: [...PRODUCT_COLUMNS],
-            rows,
-            caption: '查食品 ' + s.keyword + '（共 ' + s.total + ' 条）',
-            emptyText: '无命中',
-        }),
-        dataCopyArea('复制数据', {
-            envelope: {
-                version: DOC_VERSION, skill: DOC_SKILL, shape: 'list', key: 'calorie.view.search',
-                data: { items: rows, total: s.total },
+    /* §五 第 13 行：口径说明行（餐别口径 ＋ 缺值口径各说一次，不带常量名）；#591 · 门禁 R2：两句原由 `；` 串一行，改一条一行（同 #523／#544 口径行做法）。 */
+    parts.push(renderCaliberLine(MEAL_NOTE) + renderCaliberLine('本页缺值一律写成 —，不当成 0 卡。'));
+    /* §五 第 14 行：复制区（双按钮；`command` 不在时只出「复制数据」，不留死按钮）。 */
+    parts.push(anchored(LIST_ANCHOR.copy, listPageCopy({
+        version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: 'calorie.view.diet',
+        data: {
+            metrics: {
+                totalCalories: o.totalCalories, loggedDays: o.loggedDays, days: o.days,
+                calorieGoal: o.calorieGoal, distTotal: dist.totalCalories,
             },
-        }),
-    ];
-    return assembleDocPage({
-        docTitle: DOC_TITLE,
-        title: '查食品 ' + s.keyword,
-        eyebrow: 'calorie.view.search · 饮食域',
-        subtitle: null,
-        content: parts.join(''),
-        charts: false,
-    });
-}
-export function buildLibraryDoc(lib, statsTotal) {
-    const rows = lib.items.map((p) => ({
-        name: p.product_name, brand: p.brand ?? '', cal: p.calories, pro: p.protein,
-        fat: p.fat, carbs: p.carbohydrates, sodium: p.sodium, source: p.source ?? '',
-    }));
-    const parts = [
-        renderParamForm({
-            fields: [{ name: 'category', label: '分类', value: lib.category ?? '' }],
-            description: '按分类浏览食品库（空=全量；分页与实时筛选归宿主）',
-        }),
-        renderKpiGrid([
-            { label: '食品库', value: lib.category ?? '全量', detail: '本页 ' + lib.total + ' 条 / 库 ' + statsTotal + ' 条' },
-        ]),
-        renderDataTable({
-            columns: [...PRODUCT_COLUMNS],
-            rows,
-            caption: '食品库' + (lib.category ? '（' + lib.category + '）' : '（全量）') + '（共 ' + lib.total + ' 条）',
-            emptyText: '该分类空库',
-        }),
-        dataCopyArea('复制数据', {
-            envelope: {
-                version: DOC_VERSION, skill: DOC_SKILL, shape: 'list', key: 'calorie.view.library',
-                data: { items: rows, total: lib.total },
-            },
-        }),
-    ];
+        },
+    }, input.command)));
+    /* #560 · 屏上来源脚注撤（用户裁决原文：「用户 2026-09-15 点名：所有 HTML 页面底部的「数据来源：xxx」都删掉（用户直接看得见按钮与内容，不需要脚注复读来路）。」）；
+       `sourceLine` helper 与复制载荷 `copyLog.source` 保留（技术原件，只删屏上脚注）。 */
     return assembleDocPage({
         docTitle: DOC_TITLE,
-        title: '食品库' + (lib.category ? '（' + lib.category + '）' : ''),
-        eyebrow: 'calorie.view.library · 饮食域',
-        subtitle: null,
+        /* 用户缺陷（2026-09-15）：页名不再带窗口日期——窗口区间归副题那一行，全页只出现一次。
+           单日窗「饮食总览 2026-09-07 ~ 2026-09-07」又长又丑；多日窗同样只说「饮食总览」。 */
+        title: '饮食总览',
+        /* #496 · 眉标原写命令键「calorie.view.diet · 饮食域」——`t425-融合基准.md:127-132`（裁定 1）
+           定死不上屏；改样张口径的中文族名，#591 再去掉族名里的 `·`（门禁 R1，同 `diet/todayDocs.ts`）。 */
+        eyebrow: '卡路里饮食',
+        /* §五 第 3 行：结论句（句内只留合计一句，窗口与五事实明细在页顶形状条；#551 去文字串）。 */
+        subtitle: '本窗合计 ' + o.totalCalories + ' 卡',
         content: parts.join(''),
-        charts: false,
+        charts,
     });
 }
 /* ── 健康盘（health_dashboard.html 对照：四维＋今日该做什么＋复制回 AI） ── */
@@ -546,53 +296,4 @@ export function buildHealthDoc(h) {
         charts: false,
     });
 }
-/* ── 去重报告（dedupe_report.html 对照：KPI＋重复组表＋处理建议） ── */
-export function buildDedupeDoc(v) {
-    const parts = [renderKpiGrid([
-            { label: '重复组', value: String(v.groupCount), unit: '组' },
-            { label: '冗余条', value: String(v.rowCount), unit: '条' },
-            { label: '库内食品', value: String(v.totalProducts), unit: '条' },
-        ])];
-    parts.push(renderDataTable({
-        columns: [
-            { key: 'name', label: '食品名' },
-            { key: 'brand', label: '品牌' },
-            { key: 'count', label: '条数', align: 'right' },
-            { key: 'ids', label: 'ID' },
-        ],
-        rows: v.groups.slice(0, 50).map((g) => ({
-            name: g.productName, brand: g.brand ?? '', count: g.ids.length, ids: g.ids.join(','),
-        })),
-        caption: '重复组列表（共 ' + v.groupCount + ' 组' + (v.groups.length > 50 ? '，仅列前 50 组' : '') + '）',
-        emptyText: '无重复组（库内 ' + v.totalProducts + ' 条均唯一）',
-    }));
-    parts.push(renderDisclosure({
-        title: '处理建议',
-        contentHtml: renderListRows({
-            items: v.groupCount === 0
-                ? [{ main: '库内无重复，无需处理' }]
-                : [
-                    { main: '每组合并保留一条（取数据最全者）', right: '共 ' + v.groupCount + ' 组' },
-                    { main: '其余条目下架（deprecate），查询/搜索/导入去重不再出现' },
-                ],
-        }),
-    }));
-    parts.push(dataCopyArea('复制数据', {
-        envelope: {
-            version: DOC_VERSION, skill: DOC_SKILL, shape: 'list', key: 'calorie.view.dedupe',
-            data: {
-                items: v.groups.map((g) => ({ productName: g.productName, brand: g.brand, ids: g.ids })),
-                total: v.groupCount,
-            },
-        },
-    }));
-    return assembleDocPage({
-        docTitle: DOC_TITLE,
-        title: '去重报告',
-        eyebrow: 'calorie.view.dedupe · 饮食域',
-        subtitle: '数据来源：nutrition_products',
-        content: parts.join(''),
-        charts: false,
-    });
-}
 //# sourceMappingURL=dietDocs.js.map