skill-calorie 0.2.3 → 0.2.4

package/dist/cli/cmd_read.js

@@ -7,10 +7,11 @@
  * 组合键为 registry 合法点式（见 cli/keys.ts；内部 VIEW_KEYS 下划线键仅渲染层复用，不直接登记）。
  * 缺失阻断不返空：空库/空窗/无目标一律抛（CalorieRenderError missing-data / FetchError），exit 4，不返空数组冒充正常。
  * 仅 type-only 消费 link-core（零运行时依赖）；envelope 手工装配，形状校验本地镜像 link-core。
- * HTML 默认落盘（utf8，见下行 #87）＋ 可 --output/--html 显式覆盖：视图键走 render/html.ts 专属模板（与 T8/T9/T10 快照同源），其余走通用 section。
- * #87 · 输出命名规范复刻（M10）：不给 --output/--html 时默认落
+ * HTML 默认落盘（utf8，见下行 #87）＋ 可用 `--html` 显式覆盖：视图键走 render/html.ts 专属模板（与 T8/T9/T10 快照同源），其余走通用 section。
+ * #87 · 输出命名规范复刻（M10）：不给 `--html` 时默认落
  * <SKILLS_DB_PATH>/calorie_html/<中文command>_<YYYYMMDD>_<HHMMSS>[_N].html（同秒冲突自动加后缀），
- * 中文 command 取 CALORIE_COMBOS[key].title；显式 --output（--html 为 legacy 别名）覆盖任意路径。
+ * 中文 command 取 CALORIE_COMBOS[key].title；显式 `--html` 覆盖任意路径。
+ * ⚠️ 老技能的 `--output` 别名**已由 #245 收口删除**（与其余五家同形：只认 `--html`；给 `--output` 即 exit 2）。
  * 落点随 envelope 的 data.output 回传（additive 字段，六形状守卫不校验 data 额外键）。
  * #91 · `calorie.help.center` 承载**全量速查台**（Q9）：`--params '{"mode":"file|inline|text"}'` 显式选交付形态
  * （D6，缺省 `file`）；`q`／`keyword` 保留**照片 10 键**语义（非空＝现找、空串＝全量 10 键）。envelope 恒五字段
@@ -19,1085 +20,37 @@
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { openDb } from '../schema.js';
-import { DB_FILENAME, resolveDbDir } from '../paths.js';
-import { listMeals } from '../fetch/diet.js';
-import { getCalorieHistory } from '../fetch/history.js';
+import { DB_FILENAME } from '../paths.js';
 import { FetchError } from '../fetch/errors.js';
-import { buildHomeData } from '../render/home.js';
-import { buildDietOverview, buildMealDistribution, zeroMealDistribution } from '../render/diet.js';
-import { buildExerciseView } from '../render/exercise.js';
-import { buildGoalView } from '../render/goal.js';
-import { buildGoalConfig, buildGoalRecommend, buildGoalWeight, buildGoalProgress, buildGoalStatus } from '../render/goalPlate.js';
-import { buildWeightDashboard, buildWeightHistoryView, buildWeightCompareView, buildWeightReviewView, buildVolatilityView } from '../render/weightPlate.js';
-import { buildBodyCompositionView, buildBodyMeasureView } from '../render/bodyPlate.js';
-import { buildPlanView, buildPlanWizardView, buildExerciseGoalView } from '../render/planPlate.js';
-import { buildGoalExpiringView, buildGoalPredictView, buildGoalVsActualView } from '../render/goalExtra.js';
-import { buildPredictView, buildAnomalyView, buildContraView, buildDedupeView } from '../render/insightPlate.js';
-// #179 · 档案读链取数搬进能力目录 `src/profile/`（同一个取数不留两处）。
-import { buildProfileView, buildProfileViewDoc } from '../profile/view.js';
-import { buildProfileSettingDoc, buildProfileSettingView } from '../profile/setup.js';
-import { buildCombinedAnalysis, buildDeficitPlate, buildDietReview } from '../render/analysisPlate.js';
-import { dietFoodRanking, dietMacroRatio } from '../analysis/diet.js';
-import { buildAllRankingsDoc, buildDedupeDoc, buildDietReviewDoc, buildHealthDoc, buildLibraryDoc, buildRankingDoc, buildSearchDoc, buildTodayDietDoc, buildViewDietDoc, } from '../render/dietDocs.js';
-import { buildBodyCompositionDoc, buildBodyMeasureDoc, buildExerciseDoc, buildExerciseGoalDoc, buildVolatilityDoc, buildWeightCompareDoc, buildWeightDoc, buildWeightHistoryDoc, buildWeightReviewDoc, } from '../render/sportDocs.js';
-import { buildCardioDoc, buildDistributionDoc, buildRecapDoc, buildReviewDoc, buildStrengthDoc, buildTrendDoc, } from '../render/sportPortDocs.js';
-import { buildCardioView, buildDistributionView, buildRecapView, buildReviewView, buildStrengthView, buildTrendView, } from '../render/exercisePort.js';
-import { buildNutritionDetailView, buildNutritionRatioView, buildSourceStatsView, buildTodayWaterView, } from '../render/nutritionPort.js';
-import { buildNutritionDetailDoc, buildNutritionRatioDoc, buildSourceStatsDoc, buildTodayWaterDoc, } from '../render/nutritionPortDocs.js';
-import { buildBatchImportPreviewView, buildCalorieTrendView, buildLintHealthView, buildLongTrendView, buildNutritionAnalysisView, buildProcessProgressView, buildReviewTemplateView, buildSixFactorsView, } from '../render/trendMiscPort.js';
-import { buildBatchImportPreviewDoc, buildCalorieTrendDoc, buildLintHealthDoc, buildLongTrendDoc, buildNutritionAnalysisDoc, buildProcessProgressDoc, buildReviewTemplateDoc, buildSixFactorsDoc, } from '../render/trendMiscPortDocs.js';
-import { buildCompositionWizardView, buildGifPlannerView, buildMeasureWizardView, buildPhotoLogWizardView, } from '../render/wizardPort.js';
-import { buildCompositionWizardDoc, buildGifPlannerDoc, buildMeasureWizardDoc, buildPhotoLogWizardDoc, } from '../render/wizardPortDocs.js';
-import { buildAnomalyDoc, buildCombinedDoc, buildContraDoc, buildDeficitDoc, buildGoalPredictDoc, buildPredictDoc, } from '../render/trendDocs.js';
-import { buildHealthPlate } from '../render/health.js';
-import { buildAllRankings, buildFoodRankingPlate } from '../render/ranking.js';
-import { buildProductLibrary, buildProductSearch, buildProductStats } from '../render/library.js';
-import { buildCompareData, buildGalleryData, buildGifTask, buildViewerData } from '../render/photo.js';
-import { buildPhotoHelp, lookupPhotoHelp } from '../render/help.js';
-// #91 · 全量速查台（Q9）：只读消费 #88 的 `render/helpCenter.js`（三态同源，零改动）。
-import { HELP_CENTER_MODES, buildHelpSceneData, renderHelpCenterHtml } from '../render/helpCenter.js';
-import { HELP_FILE_STEM, buildHelpFileData, renderHelpFileHtml } from '../render/helpFile.js';
-import { SHEET_FILE_STEM, HELP_HTML_DIR_NAME } from '../render/helpPaths.js';
-import { renderGalleryHtml, renderCompareHtml, renderViewerHtml, renderGifHtml, renderPhotoHelpHtml, renderHelpLookupHtml, renderErrorHtml, renderGoalConfigHtml, renderGoalRecommendHtml, renderGoalWeightHtml, renderGoalProgressHtml, renderGoalStatusHtml, renderGoalHtml, renderHomeHtml, renderPlanHtml, renderPlanWizardHtml, renderGoalExpiringHtml, renderGoalVsActualHtml, } from '../render/html.js';
-import { assertStatMetrics, buildDelivery, withDelivery } from '../render/envelope.js';
-import { buildErrorReceipt } from '../render/receipt.js';
-import { buildDataText } from 'base-paint';
 import { CalorieRenderError } from '../render/errors.js';
-import { TRIGGERS, searchHelp } from '../triggers/index.js';
-import { shiftISODate, todayISO } from '../analysis/utils.js';
-import { CALORIE_COMBOS, ENVELOPE_VERSION, CALORIE_SKILL, calorieShapeFor, isCalorieWriteKey } from './keys.js';
-import { HTML_DIR_NAME, deliverHtml, resolveReceiptHtmlPath, } from '../output.js';
+// #179 · 档案读链取数搬进能力目录 `src/profile/`（同一个取数不留两处）。
+// #330 · CLI 前置与交付装配住同目录两件（纯搬，行为不变）：`readArgs.ts`（参数＋预检）／
+// `delivery.ts`（envelope＋三态交付＋失败回执）。入口名与 `export function dispatch` 不挪。
+import { USAGE, bodySceneFor, parseReadArgs, preflight, toast } from './readArgs.js';
+import { buildDeliveredEnvelope, describeDeliveryTarget, failWithBodyReceipt, failWithReceipt } from './delivery.js';
+export { buildDeliveredEnvelope };
+// #250 · 窗口与锚点只有一个定义地（analysis/series.ts）：读命令一律经下方 anchorOf／windowRange／dayField 取参。
+import { CALORIE_COMBOS, calorieShapeFor, isCalorieWriteKey } from './keys.js';
+// #294 · 参数读取与窗口口径上移共用位：能力目录里的命令与分派层用同一套口径（唯一定义地）。
+import { fail } from '../shared/params.js';
 import { openDbReadOnly } from '../db/readonly.js';
 import { dispatchWrite } from './write.js';
-const DEFAULT_TIMEOUT_MS = 30000;
-function fail(code, msg) {
-    console.error('ERR ' + code + ': ' + msg);
-    process.exit(code);
-}
-function toast(msg) {
-    console.error('TOAST: ' + msg);
-}
-function preflight() {
-    const v = process.versions.node.split('.').map(Number);
-    const major = v[0];
-    const minor = v[1];
-    if (!(major > 22 || (major === 22 && minor >= 13)))
-        fail(1, 'node 低于 22.13：' + process.versions.node);
-    const p = process.env.SKILLS_DB_PATH;
-    if (!p)
-        fail(1, 'SKILLS_DB_PATH 未设置（无默认值，必设）');
-    return p;
-}
-const USAGE = '用法：cmd_read <calorie.key> [--params JSON对象] [--output 输出路径] [--html 输出路径（--output 别名）] [--timeout 毫秒]';
-function parseArgs(a) {
-    const o = {
-        key: a[0], params: undefined, html: undefined, output: undefined, timeout: DEFAULT_TIMEOUT_MS,
-    };
-    for (let i = 1; i < a.length; i++) {
-        if (a[i] === '--params' && i + 1 < a.length)
-            o.params = a[++i];
-        else if (a[i] === '--html' && i + 1 < a.length)
-            o.html = a[++i];
-        else if (a[i] === '--output' && i + 1 < a.length)
-            o.output = a[++i];
-        else if (a[i] === '--timeout' && i + 1 < a.length) {
-            o.timeout = Number(a[++i]);
-            if (!Number.isFinite(o.timeout) || o.timeout <= 0)
-                fail(2, '--timeout 须为正数毫秒');
-        }
-        else
-            fail(2, '未知参数：' + a[i] + '（' + USAGE + '）');
-    }
-    return o;
-}
-function needStr(params, name) {
-    const v = params[name];
-    if (typeof v !== 'string' || v.length === 0)
-        fail(2, '缺参数 ' + name);
-    return v;
-}
-function optStr(params, name) {
-    const v = params[name];
-    if (v === undefined || v === null)
-        return undefined;
-    if (typeof v !== 'string')
-        fail(2, '参数 ' + name + ' 须为字符串');
-    return v;
-}
-function optNum(params, name) {
-    const v = params[name];
-    if (v === undefined || v === null)
-        return undefined;
-    if (typeof v !== 'number' || !Number.isFinite(v))
-        fail(2, '参数 ' + name + ' 须为有限 number');
-    return v;
-}
-function assertISO(v, field) {
-    if (!/^\d{4}-\d{2}-\d{2}$/.test(v))
-        fail(2, field + ' 非法（须 YYYY-MM-DD）：' + v);
-}
-function latestFoodDate(db) {
-    try {
-        const row = db.prepare('SELECT MAX(date) AS m FROM food_log').get();
-        return row?.m ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-function defaultRange(db, params, defDays = 7) {
-    let end = optStr(params, 'end') ?? optStr(params, 'date') ?? optStr(params, 'today') ?? undefined;
-    let start = optStr(params, 'start') ?? undefined;
-    if (end)
-        assertISO(end, 'end');
-    if (start)
-        assertISO(start, 'start');
-    if (start && end) {
-        if (start > end)
-            fail(2, 'start 不得晚于 end');
-        return { start, end };
-    }
-    const latest = latestFoodDate(db) ?? todayISO();
-    end = end ?? latest;
-    assertISO(end, 'end');
-    if (start) {
-        if (start > end)
-            fail(2, 'start 不得晚于 end');
-        return { start, end: end };
-    }
-    return { start: shiftISODate(end, -(defDays - 1)), end: end };
-}
-/** 本地 envelope 形状校验（镜像 link-core assertShapeData，不运行时 import）。 */
-function assertEnvelopeData(shape, data) {
-    switch (shape) {
-        case 'list':
-            if (!Array.isArray(data['items']))
-                throw new CalorieRenderError('bad-input', 'list 形缺 items 数组');
-            if (data['total'] !== undefined && typeof data['total'] !== 'number')
-                throw new CalorieRenderError('bad-input', 'list 形 total 须为 number');
-            break;
-        case 'detail':
-            if (typeof data['item'] !== 'object' || data['item'] === null || Array.isArray(data['item'])) {
-                throw new CalorieRenderError('bad-input', 'detail 形缺 item 对象');
-            }
-            break;
-        case 'stat':
-            if (typeof data['metrics'] !== 'object' || data['metrics'] === null || Array.isArray(data['metrics'])) {
-                throw new CalorieRenderError('bad-input', 'stat 形缺 metrics 对象');
-            }
-            assertStatMetrics(data['metrics']);
-            break;
-        case 'receipt':
-            if (typeof data['ok'] !== 'boolean' || typeof data['message'] !== 'string') {
-                throw new CalorieRenderError('bad-input', 'receipt 形缺 ok/message 全字段');
-            }
-            break;
-        case 'analysis':
-            if (typeof data['summary'] !== 'string' || data['summary'].length === 0) {
-                throw new CalorieRenderError('bad-input', 'analysis 形缺 summary 全字段');
-            }
-            break;
-        case 'fallback':
-            if (typeof data['reason'] !== 'string' || data['reason'].length === 0 || data['degraded'] !== true) {
-                throw new CalorieRenderError('bad-input', 'fallback 形缺 reason/degraded:true 全字段');
-            }
-            break;
-        default:
-            throw new CalorieRenderError('bad-input', '未知 shape：' + String(shape));
-    }
-}
-function buildEnvelope(key, shape, data) {
-    assertEnvelopeData(shape, data);
-    return { version: ENVELOPE_VERSION, skill: CALORIE_SKILL, shape, key, data };
-}
-/** 非空数挑拣：null/undefined/NaN/Infinity 一律丢弃（stat.metrics 须全有限 number）。 */
-function nums(input) {
-    const out = {};
-    for (const [k, v] of Object.entries(input)) {
-        if (typeof v === 'number' && Number.isFinite(v))
-            out[k] = v;
-    }
-    return out;
-}
-function photosDirOf(params) {
-    const p = optStr(params, 'photosDir');
-    if (p)
-        return p;
-    const e = process.env.CALORIE_PHOTOS_DIR;
-    return e ? e : undefined;
-}
-/** #91 · 全量速查台的信封载荷：**10 分组索引**（不把 1 MB 产物塞进 envelope）。
- *
- *  `items` 恒为 10 条分组（`total` = `items.length`，与 `list` 形语义一致）；
- *  `sceneTotal`／`subgroupTotal` 把「436 场景／54 子功能」如实回传，避免只报 10 丢掉全量口径。
- */
-function helpCenterIndex(data) {
-    let sceneTotal = 0;
-    let subgroupTotal = 0;
-    const items = data.groups.map((group) => {
-        const sceneCount = group.subgroups.reduce((n, sub) => n + sub.scenes.length, 0);
-        sceneTotal += sceneCount;
-        subgroupTotal += group.subgroups.length;
-        return {
-            id: group.id,
-            icon: typeof group.icon === 'string' ? group.icon : '',
-            label: group.label,
-            subgroupCount: group.subgroups.length,
-            sceneCount,
-        };
-    });
-    return { items, total: items.length, sceneTotal, subgroupTotal };
-}
+// #294 · 命令索引：命中即走能力目录里的实现；未命中即未知键（#320 起老 switch 已删）。
+import { REGISTRY } from './registry.js';
 // 全键分发：读走 render/fetch 读，HELP 走触发词现找；未知键上游已拦，此处再拦一道。
 /** #41 · 测试直调出口（纯 CLI 同逻辑，不经过 argv/spawn；CLI 唯一出口仍为 main）。 */
 export function dispatch(key, params, db) {
-    switch (key) {
-        case 'calorie.today': {
-            const date = optStr(params, 'date') ?? latestFoodDate(db) ?? todayISO();
-            assertISO(date, 'date');
-            const rows = listMeals(db, date).filter((r) => r.food_name !== '💧水');
-            if (rows.length === 0)
-                throw new CalorieRenderError('missing-data', '无饮食记录（' + date + '）');
-            const items = rows.map((r) => ({ id: r.id, date: r.date, time: r.time, food_name: r.food_name, grams: r.grams, calories: r.calories, protein: r.protein, carbs: r.carbs, fat: r.fat }));
-            const o = buildDietOverview(db, date, date);
-            const dist = buildMealDistribution(db, date);
-            // #108 · 今日饮食全文档（餐次进度＋营养配比＋今日明细；配比无数据即 skip，不编数）。
-            const mt = dietMacroRatio(db, date, date);
-            return { data: { items, total: items.length }, html: buildTodayDietDoc({ overview: o, dist, meals: rows, macro: mt.status === 'ok' ? (mt.data ?? null) : null }) };
-        }
-        case 'calorie.view.home': {
-            const date = optStr(params, 'date') ?? optStr(params, 'today') ?? latestFoodDate(db) ?? todayISO();
-            assertISO(date, 'date');
-            const windowDays = optNum(params, 'windowDays') ?? 7;
-            if (!Number.isInteger(windowDays) || windowDays < 1 || windowDays > 90)
-                fail(2, 'windowDays 须为 1..90 整数');
-            const h = buildHomeData(db, date, windowDays);
-            const metrics = nums({
-                calorieGoal: h.calorieGoal, waterGoal: h.waterGoal, caloriePct: h.caloriePct, proteinPct: h.proteinPct,
-                waterPct: h.waterPct, deficitToday: h.deficitToday, streakDays: h.streakDays,
-                intakeCal: h.daily.totals.cal, proteinG: h.daily.totals.pro, carbsG: h.daily.totals.carbs, fatG: h.daily.totals.fat,
-                waterMl: h.daily.waterMl, entryCount: h.daily.entryCount, avgIntake: h.week.avgIntake, avgDeficit: h.week.avgDeficit,
-                loggedDays: h.week.loggedDays,
-            });
-            return { data: { metrics }, html: renderHomeHtml(h) };
-        }
-        case 'calorie.view.diet': {
-            const { start, end } = defaultRange(db, params);
-            const date = optStr(params, 'date') ?? end;
-            assertISO(date, 'date');
-            const o = buildDietOverview(db, start, end);
-            // C4 #43 · 尾日空回零（窗内有数不掀整窗 missing；窗全空由上行 overview 抛 missing-data）。
-            let dist;
-            try {
-                dist = buildMealDistribution(db, date);
-            }
-            catch (e) {
-                if (e instanceof CalorieRenderError && e.code === 'missing-data')
-                    dist = zeroMealDistribution(date);
-                else
-                    throw e;
-            }
-            // #108 · 窗口明细（逐日 listMeals 去水，上限 100 条并明示截断；单日失败跳过）。
-            const mealRows = [];
-            for (const d of o.series) {
-                try {
-                    for (const r of listMeals(db, d.date)) {
-                        if (r.food_name !== '💧水')
-                            mealRows.push(r);
-                    }
-                }
-                catch {
-                    continue;
-                }
-            }
-            const MEAL_CAP = 100;
-            const mealTotal = mealRows.length;
-            const mealSlice = mealRows.slice(0, MEAL_CAP);
-            const metrics = nums({
-                totalCalories: o.totalCalories, avgCalories: o.avgCalories, calorieGoal: o.calorieGoal,
-                loggedDays: o.loggedDays, days: o.days, distTotal: dist.totalCalories,
-                'meal.早餐': dist.slices.find((s) => s.meal === '早餐')?.calories,
-                'meal.午餐': dist.slices.find((s) => s.meal === '午餐')?.calories,
-                'meal.晚餐': dist.slices.find((s) => s.meal === '晚餐')?.calories,
-                'meal.加餐': dist.slices.find((s) => s.meal === '加餐')?.calories,
-            });
-            return { data: { metrics }, html: buildViewDietDoc({
-                    overview: o, dist, distDate: date, days: o.series,
-                    meals: mealSlice, mealTotal, mealsTruncated: mealTotal > MEAL_CAP,
-                }) };
-        }
-        case 'calorie.view.exercise': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildExerciseView(db, start, end);
-            const metrics = nums({
-                totalBurned: v.review.totalBurned, totalMinutes: v.review.totalMinutes, sessions: v.review.sessions,
-                activeDays: v.review.activeDays, totalBurnedSeries: v.totalBurnedSeries,
-                avgBurnedPerLoggedDay: v.avgBurnedPerLoggedDay, seriesActiveDays: v.activeDays,
-            });
-            return { data: { metrics }, html: buildExerciseDoc(v) };
-        }
-        // #111 · 运动移植 6 键（t71 需移植 exercise_*；envelope stat metrics 只收确定数字）。
-        case 'calorie.view.exercise-strength': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildStrengthView(db, start, end);
-            const metrics = nums({
-                movementCount: v.movementCount, totalSets: v.totalSets,
-                totalVolumeKg: v.totalVolumeKg, totalReps: v.totalReps,
-            });
-            return { data: { metrics }, html: buildStrengthDoc(v) };
-        }
-        case 'calorie.view.exercise-cardio': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildCardioView(db, start, end);
-            const metrics = nums({
-                sessions: v.sessions, totalMinutes: v.totalMinutes,
-                totalDistanceKm: v.totalDistanceKm, avgPaceMinPerKm: v.avgPaceMinPerKm,
-            });
-            return { data: { metrics }, html: buildCardioDoc(v) };
-        }
-        case 'calorie.view.exercise-distribution': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildDistributionView(db, start, end);
-            const metrics = nums({
-                sessions: v.sessions, activeDays: v.activeDays, days: v.days, totalBurned: v.totalBurned,
-                intakeCal: v.intakeCal, tdeeTotal: v.tdeeTotal, deficit: v.deficit,
-            });
-            return { data: { metrics }, html: buildDistributionDoc(v) };
-        }
-        case 'calorie.view.exercise-recap': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildRecapView(db, start, end);
-            const metrics = nums({
-                sessions: v.sessions, totalMinutes: v.totalMinutes, totalBurned: v.totalBurned,
-                activeDays: v.activeDays, days: v.days,
-            });
-            return { data: { metrics }, html: buildRecapDoc(v) };
-        }
-        case 'calorie.view.exercise-review': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildReviewView(db, start, end);
-            const metrics = nums({
-                plannedSessions: v.plannedSessions, hitSessions: v.hitSessions,
-                completionPct: v.completionPct, plannedMovements: v.plannedMovements,
-                hitMovements: v.hitMovements, movementPct: v.movementPct,
-            });
-            return { data: { metrics }, html: buildReviewDoc(v) };
-        }
-        case 'calorie.view.exercise-trend': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildTrendView(db, start, end);
-            const metrics = nums({
-                activeDays: v.activeDays, totalMinutes: v.totalMinutes,
-                totalBurned: v.totalBurned, peakBurned: v.peak?.burned,
-            });
-            return { data: { metrics }, html: buildTrendDoc(v) };
-        }
-        // #112 · 营养移植 4 键（t71 需移植 nutrition_*／source_stats／today_water；envelope stat metrics 只收确定数字）。
-        case 'calorie.view.nutrition-ratio': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildNutritionRatioView(db, start, end);
-            const metrics = nums({
-                totalCalorie: v.totalCalorie, proteinG: v.proteinG, proteinPct: v.proteinPct,
-                carbG: v.carbG, carbPct: v.carbPct, fatG: v.fatG, fatPct: v.fatPct,
-                targetProteinG: v.targetProteinG, targetCarbG: v.targetCarbG, targetFatG: v.targetFatG,
-            });
-            return { data: { metrics }, html: buildNutritionRatioDoc(v) };
-        }
-        case 'calorie.view.nutrition-detail': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildNutritionDetailView(db, start, end);
-            const metrics = nums({
-                days: v.days,
-                matchedMeals: v.matchedMeals,
-                missingFoods: v.missingFoods.length,
-                fiberAvg: v.items[0]?.avg,
-                sodiumAvg: v.items[1]?.avg,
-                sugarAvg: v.items[2]?.avg,
-                fiberPct: v.items[0]?.pct,
-                sodiumPct: v.items[1]?.pct,
-                sugarPct: v.items[2]?.pct,
-            });
-            return { data: { metrics }, html: buildNutritionDetailDoc(v) };
-        }
-        case 'calorie.view.source-stats': {
-            const v = buildSourceStatsView(db);
-            const metrics = nums({ total: v.total, sources: v.sources });
-            return { data: { metrics }, html: buildSourceStatsDoc(v) };
-        }
-        case 'calorie.view.today-water': {
-            const date = optStr(params, 'date') ?? latestFoodDate(db) ?? todayISO();
-            assertISO(date, 'date');
-            const v = buildTodayWaterView(db, date);
-            const metrics = nums({
-                todayMl: v.todayMl, targetMl: v.targetMl, pct: v.pct, remainMl: v.remainMl, cups: v.cups.length,
-            });
-            return { data: { metrics }, html: buildTodayWaterDoc(v) };
-        }
-        // #113 · 趋势 2＋其他 6 移植 8 键（t71 需移植八模板；envelope stat metrics 只收确定数字）。
-        case 'calorie.view.calorie-trend': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildCalorieTrendView(db, start, end);
-            const s = v.data.summary;
-            const metrics = nums({
-                avg: s.avg, target: s.target, trendValue: s.trendValue,
-                startAvg: s.startAvg, endAvg: s.endAvg, weekdayAvg: s.weekdayAvg,
-                weekendAvg: s.weekendAvg, weekendDiff: s.weekendDiff,
-                compliantDays: s.compliantDays, complianceRate: s.complianceRate,
-            });
-            return { data: { metrics }, html: buildCalorieTrendDoc(v) };
-        }
-        case 'calorie.view.long-trend': {
-            const end = optStr(params, 'end') ?? latestFoodDate(db) ?? todayISO();
-            assertISO(end, 'end');
-            const v = buildLongTrendView(db, optStr(params, 'group'), optStr(params, 'window'), end);
-            const metrics = nums({
-                windowDays: v.windowDays, avgCalorie: v.avgCalorie, weightChange: v.weightChange,
-            });
-            return { data: { metrics }, html: buildLongTrendDoc(v) };
-        }
-        case 'calorie.view.nutrition-analysis': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildNutritionAnalysisView(db, start, end);
-            const metrics = nums({
-                days: v.days, totalCalorie: v.totalCalorie,
-                proteinG: v.proteinG, proteinPct: v.proteinPct,
-                carbG: v.carbG, carbPct: v.carbPct, fatG: v.fatG, fatPct: v.fatPct,
-                fiberAvg: v.fiberAvg, sodiumAvg: v.sodiumAvg, sugarAvg: v.sugarAvg,
-                adviceCount: v.advice.length,
-            });
-            return { data: { metrics }, html: buildNutritionAnalysisDoc(v) };
-        }
-        case 'calorie.view.six-factors': {
-            const date = optStr(params, 'date') ?? latestFoodDate(db) ?? todayISO();
-            assertISO(date, 'date');
-            const v = buildSixFactorsView(db, date);
-            const metrics = nums({
-                score: v.score,
-                calorie: v.factors[0]?.ok ? 1 : 0,
-                protein: v.factors[1]?.ok ? 1 : 0,
-                water: v.factors[2]?.ok ? 1 : 0,
-                exercise: v.factors[3]?.ok ? 1 : 0,
-                weigh: v.factors[4]?.ok ? 1 : 0,
-                meals: v.factors[5]?.ok ? 1 : 0,
-            });
-            return { data: { metrics }, html: buildSixFactorsDoc(v) };
-        }
-        case 'calorie.view.measure-wizard': {
-            const v = buildMeasureWizardView(db, params);
-            const metrics = nums({
-                filledCount: v.filledCount, hasRecent: v.recent ? 1 : 0,
-            });
-            return { data: { metrics }, html: buildMeasureWizardDoc(v) };
-        }
-        case 'calorie.view.composition-wizard': {
-            const v = buildCompositionWizardView(db, params);
-            const metrics = nums({
-                filledCount: (v.source ? 1 : 0) + (v.bodyFatPct === null ? 0 : 1) + v.calipers.length,
-                caliperCount: v.calipers.length, sum7: v.sum7, hasRecent: v.recent ? 1 : 0,
-            });
-            return { data: { metrics }, html: buildCompositionWizardDoc(v) };
-        }
-        case 'calorie.view.photo-log-wizard': {
-            const v = buildPhotoLogWizardView(params);
-            const metrics = nums({
-                fileCount: v.srcPaths.length, hasTag: v.tag ? 1 : 0,
-            });
-            return { data: { metrics }, html: buildPhotoLogWizardDoc(v) };
-        }
-        case 'calorie.view.gif-planner': {
-            const dir = photosDirOf(params);
-            const v = buildGifPlannerView(db, params, dir ?? null);
-            const metrics = nums({
-                photoCount: v.photos.length, selectedCount: v.selectedIds.length,
-                missingCount: v.missingIds.length, cropCount: v.photos.filter((p) => p.crop).length,
-            });
-            return { data: { metrics }, html: buildGifPlannerDoc(v) };
-        }
-        case 'calorie.view.profile-wizard': {
-            const v = buildProfileSettingView(db, params);
-            const metrics = nums({
-                filledCount: v.filledCount, hasProfile: v.before ? 1 : 0,
-                latestWeightKg: v.latestWeightKg, activityLevels: v.activityChoices.length,
-            });
-            return { data: { metrics }, html: buildProfileSettingDoc(v) };
-        }
-        case 'calorie.view.lint-health': {
-            const v = buildLintHealthView(db);
-            const metrics = nums({
-                issueCount: v.issueCount,
-                unmatched: v.checks[0]?.count,
-                badCalorie: v.checks[1]?.count,
-                future: v.checks[2]?.count,
-                duplicate: v.checks[3]?.count,
-            });
-            return { data: { metrics }, html: buildLintHealthDoc(v) };
-        }
-        case 'calorie.view.batch-import-preview': {
-            const v = buildBatchImportPreviewView(db, params['items']);
-            const metrics = nums({
-                total: v.total, matched: v.matched, missing: v.missing, totalCalorie: v.totalCalorie,
-            });
-            return { data: { metrics }, html: buildBatchImportPreviewDoc(v) };
-        }
-        case 'calorie.view.process-progress': {
-            const end = optStr(params, 'end') ?? latestFoodDate(db) ?? todayISO();
-            assertISO(end, 'end');
-            const v = buildProcessProgressView(db, end);
-            const metrics = nums({
-                hasPlan: v.hasPlan ? 1 : 0, plannedDays: v.plannedDays,
-                sessions7d: v.sessions7d, minutes7d: v.minutes7d,
-            });
-            return { data: { metrics }, html: buildProcessProgressDoc(v) };
-        }
-        case 'calorie.view.review-template': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildReviewTemplateView(db, start, end);
-            const metrics = nums({
-                days: v.days, meals: v.meals, avgCalorie: v.avgCalorie,
-                sessions: v.sessions, minutes: v.minutes, weightChange: v.weightChange,
-                points: v.points.length,
-            });
-            return { data: { metrics }, html: buildReviewTemplateDoc(v) };
-        }
-        case 'calorie.view.goal': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildGoalView(db, start, end);
-            const metrics = nums({
-                calorie_goal: v.nutrition.calorie_goal, protein_goal: v.nutrition.protein_goal,
-                carbs_goal: v.nutrition.carbs_goal, fat_goal: v.nutrition.fat_goal, water_goal: v.nutrition.water_goal,
-                completionPct: v.completionPct, weeklyDeficit: v.deficit.summary.weeklyDeficit,
-                predictedLossKg: v.deficit.summary.predictedLossKg, avgDeficit: v.deficit.summary.avgDeficit,
-                avgIntake: v.deficit.summary.avgIntake, trendAvg: v.trend.summary.avg,
-                completedCount: v.history.completedCount, incompleteCount: v.history.incompleteCount,
-            });
-            return { data: { metrics }, html: renderGoalHtml(v) };
-        }
-        case 'calorie.view.goal-config': {
-            const g = buildGoalConfig(db);
-            const metrics = nums({
-                calorie_goal: g.nutrition.calorie_goal, protein_goal: g.nutrition.protein_goal,
-                carbs_goal: g.nutrition.carbs_goal, fat_goal: g.nutrition.fat_goal, water_goal: g.nutrition.water_goal,
-                diffKcal: g.diffKcal, consistent: g.consistent ? 1 : 0, paused: g.paused ? 1 : 0,
-            });
-            return { data: { metrics }, html: renderGoalConfigHtml(g) };
-        }
-        case 'calorie.view.goal-recommend': {
-            const profile = optStr(params, 'profile') ?? 'cut';
-            if (!['cut', 'maintain', 'bulk'].includes(profile))
-                fail(2, 'profile 非法（cut/maintain/bulk）：' + profile);
-            const g = buildGoalRecommend(db, profile);
-            const metrics = nums({
-                calorieGoal: g.recommend.calorieGoal, proteinGoal: g.recommend.proteinGoal, carbsGoal: g.recommend.carbsGoal,
-                fatGoal: g.recommend.fatGoal, waterGoal: g.recommend.waterGoal, tdee: g.recommend.tdee, bmr: g.recommend.bmr,
-                weeklyRateKg: g.recommend.weeklyRateKg, weightKg: g.recommend.basis.weightKg,
-                recommendedWaterMl: g.water.recommendedWaterMl, mlPerKg: g.water.mlPerKg,
-            });
-            return { data: { metrics }, html: renderGoalRecommendHtml(g) };
-        }
-        case 'calorie.view.goal-weight': {
-            const { start, end } = defaultRange(db, params);
-            const g = buildGoalWeight(db, start, end);
-            const metrics = nums({ weightGoal: g.weightGoal, latestKg: g.latestKg, deltaKg: g.deltaKg, loggedDays: g.loggedDays });
-            return { data: { metrics }, html: renderGoalWeightHtml(g) };
-        }
-        case 'calorie.view.goal-progress': {
-            const { start, end } = defaultRange(db, params);
-            const historyDays = optNum(params, 'historyDays') ?? 30;
-            if (!Number.isInteger(historyDays) || historyDays < 1 || historyDays > 365)
-                fail(2, 'historyDays 须为 1..365 整数');
-            const g = buildGoalProgress(db, start, end, historyDays);
-            const metrics = nums({
-                calorie_goal: g.nutrition.calorie_goal, completionPct: g.completionPct,
-                weeklyDeficit: g.deficit.summary.weeklyDeficit, predictedLossKg: g.deficit.summary.predictedLossKg,
-                avgDeficit: g.deficit.summary.avgDeficit, trendAvg: g.trend.summary.avg,
-                completedCount: g.history.completedCount, incompleteCount: g.history.incompleteCount,
-            });
-            return { data: { metrics }, html: renderGoalProgressHtml(g) };
-        }
-        case 'calorie.view.goal-status': {
-            const g = buildGoalStatus(db);
-            const metrics = nums({ paused: g.paused ? 1 : 0, calorie_goal: g.nutrition.calorie_goal, water_goal: g.nutrition.water_goal });
-            return { data: { metrics }, html: renderGoalStatusHtml(g) };
-        }
-        case 'calorie.view.combined': {
-            const pair = optStr(params, 'pair') ?? 'weight_calorie';
-            const window = optStr(params, 'window') ?? '7d';
-            const start = optStr(params, 'start') ?? null;
-            const end = optStr(params, 'end') ?? null;
-            const today = optStr(params, 'today') ?? latestFoodDate(db) ?? todayISO();
-            const c = buildCombinedAnalysis(db, pair, window, start, end, today);
-            const metrics = nums({
-                aAvg: c.analysis.aAvg, bAvg: c.analysis.bAvg, aDelta: c.analysis.aDelta, bDelta: c.analysis.bDelta,
-                aCount: c.analysis.aCount, bCount: c.analysis.bCount,
-                correlationR: c.analysis.correlation.r, correlationN: c.analysis.correlation.n, days: c.analysis.days,
-                seriesDays: c.series.length,
-            });
-            return { data: { metrics }, html: buildCombinedDoc(c) };
-        }
-        case 'calorie.view.deficit': {
-            const { start, end } = defaultRange(db, params);
-            const d = buildDeficitPlate(db, start, end);
-            const metrics = nums({
-                avgIntake: d.summary.avgIntake, avgBurn: d.summary.avgBurn, avgExerciseBurn: d.summary.avgExerciseBurn,
-                avgDeficit: d.summary.avgDeficit, weeklyDeficit: d.summary.weeklyDeficit, predictedLossKg: d.summary.predictedLossKg,
-                days: d.meta.days, weekdayCount: d.meta.weekdayCount, weekendCount: d.meta.weekendCount,
-                targetIntake: d.target.intake, targetTdee: d.target.tdee,
-            });
-            return { data: { metrics }, html: buildDeficitDoc(d) };
-        }
-        case 'calorie.view.diet-review': {
-            const { start, end } = defaultRange(db, params);
-            const r = buildDietReview(db, start, end);
-            const metrics = nums({
-                loggedDays: r.loggedDays,
-                'meal.早餐': r.byMeal.find((s) => s.meal === '早餐')?.totalCalories,
-                'meal.午餐': r.byMeal.find((s) => s.meal === '午餐')?.totalCalories,
-                'meal.晚餐': r.byMeal.find((s) => s.meal === '晚餐')?.totalCalories,
-                'meal.加餐': r.byMeal.find((s) => s.meal === '加餐')?.totalCalories,
-            });
-            // #108 · 复盘全文档（趋势折线＋配比环＋高频 TOP5＋按餐汇总；TOP5 取数失败即空态，不编数）。
-            const fr = dietFoodRanking(db, start, end, 'frequent', 5);
-            return { data: { metrics }, html: buildDietReviewDoc(r, fr.status === 'ok' ? (fr.data ?? null) : null) };
-        }
-        case 'calorie.view.health': {
-            const { start, end } = defaultRange(db, params);
-            const h = buildHealthPlate(db, start, end);
-            const metrics = nums({ loggedDays: h.loggedDays, avgIntake: h.avgIntake, avgDeficit: h.avgDeficit });
-            return { data: { metrics }, html: buildHealthDoc(h) };
-        }
-        case 'calorie.view.ranking': {
-            const { start, end } = defaultRange(db, params);
-            const category = optStr(params, 'category');
-            const topN = optNum(params, 'topN') ?? 5;
-            if (!Number.isInteger(topN) || topN < 1 || topN > 50)
-                fail(2, 'topN 须为 1..50 整数');
-            if (category) {
-                const one = buildFoodRankingPlate(db, start, end, category, topN);
-                const top = one.items[0];
-                const metrics = nums({ total: one.items.length, topN: one.topN, topCal: top?.totalCal, topCnt: top?.cnt, topRank: top?.rank });
-                return { data: { metrics }, html: buildRankingDoc(one) };
-            }
-            const all = buildAllRankings(db, start, end, topN);
-            const metrics = nums({ okCount: all.okCount, topN: all.topN });
-            return { data: { metrics }, html: buildAllRankingsDoc(all) };
-        }
-        case 'calorie.view.library': {
-            const category = optStr(params, 'category') ?? null;
-            const limit = optNum(params, 'limit') ?? 50;
-            if (!Number.isInteger(limit) || limit < 1 || limit > 100)
-                fail(2, 'limit 须为 1..100 整数');
-            const lib = buildProductLibrary(db, category, limit);
-            const stats = buildProductStats(db);
-            const metrics = nums({ total: lib.total, statsTotal: stats.total });
-            return { data: { metrics }, html: buildLibraryDoc(lib, stats.total) };
-        }
-        case 'calorie.view.search': {
-            const keyword = needStr(params, 'keyword');
-            const limit = optNum(params, 'limit') ?? 20;
-            if (!Number.isInteger(limit) || limit < 1 || limit > 100)
-                fail(2, 'limit 须为 1..100 整数');
-            const s = buildProductSearch(db, keyword, limit);
-            const metrics = nums({ total: s.total, limit: limit });
-            return { data: { metrics }, html: buildSearchDoc(s) };
-        }
-        case 'calorie.photo.list': {
-            const dir = photosDirOf(params);
-            const filter = {};
-            for (const k of ['tag', 'dateFrom', 'dateTo', 'days', 'limit', 'today']) {
-                if (params[k] !== undefined)
-                    filter[k] = params[k];
-            }
-            const g = buildGalleryData(db, filter, dir ?? null);
-            const items = g.photos.map((p) => ({ id: p.id, date: p.date, photoPath: p.photoPath, tagList: p.tagList, fileExists: p.fileExists }));
-            return { data: { items, total: g.totalCount }, html: renderGalleryHtml(g) };
-        }
-        case 'calorie.photo.detail': {
-            const id = params['id'];
-            if (typeof id !== 'number' || !Number.isInteger(id))
-                fail(2, '缺参数 id（整数照片 id）');
-            const dir = photosDirOf(params);
-            const v = buildViewerData(db, id, dir ?? null);
-            return { data: { item: { id: v.photo.id, date: v.photo.date, photoPath: v.photo.photoPath, tagList: v.photo.tagList } }, html: renderViewerHtml(v) };
-        }
-        case 'calorie.photo.compare': {
-            const id1 = params['id1'];
-            const id2 = params['id2'];
-            if (typeof id1 !== 'number' || !Number.isInteger(id1))
-                fail(2, '缺参数 id1（整数）');
-            if (typeof id2 !== 'number' || !Number.isInteger(id2))
-                fail(2, '缺参数 id2（整数）');
-            const dir = photosDirOf(params);
-            const c = buildCompareData(db, id1, id2, dir ?? null);
-            const items = [c.photo1, c.photo2].map((p) => ({ id: p.id, date: p.date, photoPath: p.photoPath, tagList: p.tagList }));
-            return { data: { items, total: 2 }, html: renderCompareHtml(c) };
-        }
-        case 'calorie.photo.gif': {
-            const tag = needStr(params, 'tag');
-            const gif = buildGifTask(db, {
-                tag, dateFrom: (optStr(params, 'dateFrom') ?? null),
-                dateTo: (optStr(params, 'dateTo') ?? null),
-                days: (optNum(params, 'days') ?? 90),
-            });
-            return { data: { summary: 'GIF 任务：标签 ' + gif.tag + ' 共 ' + gif.photoCount + ' 张（' + (gif.firstDate ?? '—') + ' ~ ' + (gif.lastDate ?? '—') + '）· ' + gif.note }, html: renderGifHtml(gif) };
-        }
-        case 'calorie.help.center': {
-            // #139 · 本键出**两种产物**，靠 `mode` 分流（旧地图口径「缺省＝速查台」已被 #131 新图准则覆盖：
-            // Q2「整个卡路里只有一个 HELP」＋ Q17「比对以老实物为准」）：
-            //   缺省（不给 `mode`）＝「卡路里help」的交付物：老实物同款 V4 三级目录 HELP 文件
-            //     （`卡路里_HELP_<TS>.html`，与老技能同名同视觉——地图目的地①②就落在这一支）；
-            //   显式 `mode`＝#88 全量速查台三态（`file`／`inline`／`text`，内容与语义逐字不变），
-            //     落 `卡路里_速查台_<TS>.html`（与 HELP 文件分名，两份产物不撞车）。
-            // D6：`mode` 不靠猜、不从别的参数推，非法值即 exit 2；`q`＝照片 10 键现找（既有语义逐字不变）。
-            const q = optStr(params, 'q') ?? optStr(params, 'keyword') ?? undefined;
-            const modeRaw = optStr(params, 'mode');
-            const photoLookup = q !== undefined && q !== '';
-            if (photoLookup && modeRaw !== undefined) {
-                fail(2, '参数 q 与 mode 互斥：q＝照片 HELP 现找（10 键），mode＝全量速查台交付形态（'
-                    + HELP_CENTER_MODES.join('／') + '）');
-            }
-            if (q !== undefined && modeRaw === undefined) {
-                // 照片路径（原样保留）：非空 q ＝ 现找（无命中 exit 4）；`q:""` ＝ 全量 10 键。
-                const hits = photoLookup ? lookupPhotoHelp(q) : buildPhotoHelp();
-                if (photoLookup && hits.length === 0)
-                    throw new CalorieRenderError('missing-data', 'HELP 无命中：' + q);
-                const items = hits.map((h) => ({ wakeWord: h.wakeWord, key: h.key, desc: h.desc, exec: h.exec }));
-                return { data: { items, total: items.length }, html: renderPhotoHelpHtml(hits, q) };
-            }
-            const now = new Date();
-            if (modeRaw === undefined) {
-                // 缺省：老实物同款 HELP 文件（5 键 JSON → V4 三级目录壳）。落点走 `target`——本键的
-                // <中文command>（注册表 title）另有其物，不能拿来命名这份产物。
-                const html = renderHelpFileHtml(buildHelpFileData(now));
-                const data = {
-                    ...helpCenterIndex(buildHelpSceneData()),
-                    mode: 'file',
-                    bytes: Buffer.byteLength(html, 'utf8'),
-                };
-                return {
-                    data, html,
-                    target: { dir: join(resolveDbDir(), HELP_HTML_DIR_NAME), stem: HELP_FILE_STEM },
-                };
-            }
-            // 全量速查台：须显式 `mode`；`text` 态把文本一并回传（file／inline 只回落点，不塞 1 MB）。
-            const mode = modeRaw;
-            if (!HELP_CENTER_MODES.includes(mode)) {
-                fail(2, '参数 mode 非法（' + String(mode) + '）：须为 ' + HELP_CENTER_MODES.join('／'));
-            }
-            const sceneData = buildHelpSceneData();
-            const rendered = renderHelpCenterHtml({ mode, sceneData });
-            const data = {
-                ...helpCenterIndex(sceneData),
-                mode,
-                bytes: Buffer.byteLength(rendered.html, 'utf8'),
-            };
-            if (mode === 'text')
-                data['text'] = rendered.html;
-            // #83 · 渲染层已定文本交付：产物即文本（③ 文本态之一），交付装配层据此走文本通道。
-            return {
-                data, html: rendered.html, deliveryKind: mode === 'text' ? 'text' : 'html',
-                target: { dir: join(resolveDbDir(), HELP_HTML_DIR_NAME), stem: SHEET_FILE_STEM },
-            };
-        }
-        case 'calorie.help.lookup': {
-            const q = needStr(params, 'q');
-            // C2/C3 #43 · 唯一搜索入口 searchHelp：别名感知 + 可执行排前 + 高频词合成首条（去legacy首命中）。
-            const found = searchHelp(TRIGGERS, q);
-            if (found.length === 0)
-                throw new CalorieRenderError('missing-data', '唤醒词无命中：' + q);
-            const sceneToCategory = { '01': '主页', '02': '饮食', '03': '体重', '04': '运动', '05': '健身计划', '06': '目标管理', '07': '基础信息', '08': '身体细节', '09': '身材照片', '10': '分析' };
-            const hits = found.map((h) => {
-                const src = TRIGGERS.find((t) => t.wake_word === h.wake_word && ('key' in t ? String(t.key ?? '') : '') === String(h.key ?? ''));
-                const category = src ? src.category : (sceneToCategory[h.scene] ?? h.scene);
-                return { wake_word: h.wake_word, category, key: String(h.key ?? ''), cli: h.cli, desc: h.desc };
-            });
-            // #90 · 渲染收敛到 render/html.ts 的 renderHelpLookupHtml（每行复制按钮 ＋ 页尾注入双通道运行时）。
-            const html = renderHelpLookupHtml(hits, q);
-            return { data: { items: hits, total: hits.length }, html };
-        }
-        case 'calorie.history': {
-            const days = optNum(params, 'days') ?? 7;
-            if (!Number.isInteger(days) || days < 1 || days > 365)
-                fail(2, 'days 须为 1..365 整数');
-            const h = getCalorieHistory(db, days);
-            if (h.rows.length === 0)
-                throw new CalorieRenderError('missing-data', '最近' + String(days) + '天无记录');
-            const items = h.rows.map((r) => ({ date: r.date, calories: r.calories, protein: r.protein, status: r.status }));
-            const html = '<section class="ilife-page" data-skill="calorie" data-slot="ilife:calorie:history"><h1>热量历史（最近' + h.days + '天）</h1>' +
-                items.map((r) => '<div class="ilife-item"><b>' + r.date + '</b> ' + r.calories + ' 卡 · ' + String(r.status).replace(/&/g, '&amp;') + '</div>').join('') + '</section>';
-            return { data: { items, total: items.length }, html };
-        }
-        case 'calorie.view.weight': {
-            const { start, end } = defaultRange(db, params);
-            const w = buildWeightDashboard(db, start, end);
-            const metrics = nums({
-                recordCount: w.trend.recordCount, avgWeight: w.trend.avgWeight,
-                maxWeight: w.trend.maxWeight, minWeight: w.trend.minWeight,
-                firstWeight: w.trend.firstWeight, lastWeight: w.trend.lastWeight,
-                changeKg: w.trend.changeKg, dailyChangeG: w.trend.dailyChangeG,
-                weightGoal: w.weightGoal, gapKg: w.gapKg,
-            });
-            return { data: { metrics }, html: buildWeightDoc(w) };
-        }
-        case 'calorie.view.weight-history': {
-            const startDate = optStr(params, 'startDate') ?? optStr(params, 'start');
-            const endDate = optStr(params, 'endDate') ?? optStr(params, 'end');
-            const days = optNum(params, 'days');
-            let h;
-            if (startDate && endDate)
-                h = buildWeightHistoryView(db, { startDate, endDate });
-            else if (startDate && !endDate)
-                h = buildWeightHistoryView(db, { startDate });
-            else if (days !== undefined)
-                h = buildWeightHistoryView(db, { days });
-            else
-                h = buildWeightHistoryView(db, {});
-            const metrics = nums({
-                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 { data: { metrics }, html: buildWeightHistoryDoc(h) };
-        }
-        case 'calorie.view.weight-compare': {
-            const start = needStr(params, 'start');
-            const end = needStr(params, 'end');
-            const compareStart = needStr(params, 'compareStart');
-            const compareEnd = needStr(params, 'compareEnd');
-            const v = buildWeightCompareView(db, start, end, compareStart, compareEnd);
-            const metrics = nums({
-                avgDiff: v.compare.avgDiff,
-                currentAvg: v.compare.currentPeriod.avgWeight, compareAvg: v.compare.comparePeriod.avgWeight,
-                currentChange: v.compare.currentPeriod.changeKg, compareChange: v.compare.comparePeriod.changeKg,
-            });
-            return { data: { metrics }, html: buildWeightCompareDoc(v) };
-        }
-        case 'calorie.view.weight-review': {
-            const today = optStr(params, 'today') ?? optStr(params, 'date');
-            const v = buildWeightReviewView(db, today ?? undefined);
-            const metrics = nums({
-                currentWeight: v.milestone.currentWeight, weightGoal: v.milestone.weightGoal,
-                gapKg: v.milestone.gapKg, actualDailyChangeKg: v.milestone.actualDailyChangeKg,
-                estDays: v.milestone.estDays, calorieAdjustment: v.milestone.calorieAdjustment,
-            });
-            return { data: { metrics }, html: buildWeightReviewDoc(v) };
-        }
-        case 'calorie.view.volatility': {
-            const { start, end } = defaultRange(db, params);
-            const mode = (optStr(params, 'baselineMode') ?? optStr(params, 'mode') ?? 'rolling');
-            const v = buildVolatilityView(db, start, end, mode);
-            const metrics = nums({
-                baselineValue: v.volatility.baselineValue, baselineSigma: v.volatility.baselineSigma,
-                yellow: v.volatility.thresholds.yellow, red: v.volatility.thresholds.red,
-                points: v.volatility.points.length, anomalies: v.volatility.recentAnomalies.length,
-                deviationKg: v.volatility.earlyWarning.deviationKg,
-            });
-            return { data: { metrics }, html: buildVolatilityDoc(v) };
-        }
-        case 'calorie.view.body-composition': {
-            const days = optNum(params, 'days') ?? 90;
-            const source = optStr(params, 'source');
-            const limit = optNum(params, 'limit') ?? 20;
-            const v = buildBodyCompositionView(db, { days: days, source: source ?? undefined, limit: limit });
-            const metrics = nums({ total: v.total, latestPct: v.latestPct, trendDays: v.trend.length });
-            return { data: { metrics }, html: buildBodyCompositionDoc(v) };
-        }
-        case 'calorie.view.body-measure': {
-            const metric = optStr(params, 'metric');
-            const days = optNum(params, 'days') ?? 90;
-            const limit = optNum(params, 'limit') ?? 20;
-            const dateFrom = optStr(params, 'dateFrom');
-            const dateTo = optStr(params, 'dateTo');
-            const v = buildBodyMeasureView(db, { metric: metric ?? undefined, days: days, limit: limit, dateFrom: dateFrom ?? undefined, dateTo: dateTo ?? undefined });
-            const metrics = nums({ total: v.total, latestVal: v.latestVal, trendDays: v.trend.length });
-            return { data: { metrics }, html: buildBodyMeasureDoc(v) };
-        }
-        case 'calorie.view.plan': {
-            const v = buildPlanView(db);
-            const metrics = nums({ totalSessions: v.totalSessions, totalMovements: v.totalMovements, totalWeeks: v.totalWeeks });
-            return { data: { metrics }, html: renderPlanHtml(v) };
-        }
-        case 'calorie.view.plan-wizard': {
-            const plan = params['plan'];
-            if (typeof plan !== 'object' || plan === null || Array.isArray(plan))
-                fail(2, '缺参数 plan（PlanInput 对象）');
-            const catalog = params['catalog'];
-            const v = buildPlanWizardView(plan, catalog ?? undefined);
-            const metrics = nums({ errorCount: v.errorCount, warningCount: v.warningCount, checkedSessions: v.checkedSessions });
-            return { data: { metrics }, html: renderPlanWizardHtml(v) };
-        }
-        case 'calorie.view.exercise-goal': {
-            const { start, end } = defaultRange(db, params);
-            const v = buildExerciseGoalView(db, start, end);
-            const metrics = nums({ dailyGoal: v.dailyGoal, goalTotal: v.goalTotal, actual: v.actual, pct: v.pct, gap: v.gap, achieved: v.achieved ? 1 : 0, days: v.days });
-            return { data: { metrics }, html: buildExerciseGoalDoc(v) };
-        }
-        case 'calorie.view.goal-expiring': {
-            const withinDays = optNum(params, 'withinDays') ?? optNum(params, 'days') ?? 14;
-            const today = optStr(params, 'today');
-            const v = buildGoalExpiringView(db, withinDays, today ?? undefined);
-            const metrics = nums({ daysLeft: v.daysLeft, withinDays: v.withinDays, expiring: v.expiring ? 1 : 0, weightGoal: v.weightGoal, calorieGoal: v.calorieGoal });
-            return { data: { metrics }, html: renderGoalExpiringHtml(v) };
-        }
-        case 'calorie.view.goal-predict': {
-            // #103 G2 · 目标预测需 ≥14 条体重记录（simulate SIM_MIN_DAYS=14），7 天默认窗结构性不可达 → 默认 14 天。
-            const { start, end } = defaultRange(db, params, 14);
-            const v = buildGoalPredictView(db, start, end);
-            const metrics = nums({ targetKg: v.targetKg, current: v.current, daysLeft: v.daysLeft, ratePerWeek: v.ratePerWeek, feasible: v.feasible ? 1 : 0 });
-            return { data: { metrics }, html: buildGoalPredictDoc(v) };
-        }
-        case 'calorie.view.goal-vs-actual': {
-            const { start, end } = defaultRange(db, params);
-            const historyDays = optNum(params, 'historyDays') ?? 30;
-            const v = buildGoalVsActualView(db, start, end, historyDays);
-            const metrics = nums({
-                completedCount: v.completedCount, incompleteCount: v.incompleteCount,
-                completionPct: v.completionPct, trendAvg: v.trendAvg, calorieGoal: v.calorieGoal,
-            });
-            return { data: { metrics }, html: renderGoalVsActualHtml(v) };
-        }
-        case 'calorie.view.predict': {
-            // #103 G2 · 同 goal-predict：默认 14 天，否则缺省调用恒走 missing-data。
-            const { start, end } = defaultRange(db, params, 14);
-            const horizonDays = optNum(params, 'horizonDays') ?? optNum(params, 'days') ?? 30;
-            const v = buildPredictView(db, start, end, horizonDays);
-            const metrics = nums({ current: v.current, ratePerWeek: v.ratePerWeek, forecastValue: v.forecastValue, forecastLo: v.forecastLo, forecastHi: v.forecastHi, horizonDays: v.horizonDays });
-            return { data: { metrics }, html: buildPredictDoc(v) };
-        }
-        case 'calorie.view.anomaly': {
-            const kind = needStr(params, 'kind');
-            const { start, end } = defaultRange(db, params);
-            const v = buildAnomalyView(db, kind, start, end);
-            const metrics = nums({ findingCount: v.findingCount, days: v.diagnosis.days, degraded: v.diagnosis.degraded ? 1 : 0 });
-            return { data: { metrics }, html: buildAnomalyDoc(v) };
-        }
-        case 'calorie.view.contraindication': {
-            const part = optStr(params, 'part') ?? 'all';
-            const v = buildContraView(db, part);
-            const metrics = nums({ scannedSessions: v.scannedSessions, scannedMovements: v.scannedMovements, errorCount: v.errorCount, warnCount: v.warnCount, infoCount: v.infoCount });
-            return { data: { metrics }, html: buildContraDoc(v) };
-        }
-        case 'calorie.view.dedupe': {
-            const v = buildDedupeView(db);
-            const metrics = nums({ groupCount: v.groupCount, rowCount: v.rowCount, totalProducts: v.totalProducts });
-            return { data: { metrics }, html: buildDedupeDoc(v) };
-        }
-        case 'calorie.view.profile': {
-            const v = buildProfileView(db);
-            const metrics = nums({
-                age: v.profile.age, heightCm: v.profile.height_cm,
-                hasGoal: v.hasGoal ? 1 : 0, latestWeightKg: v.latestWeightKg,
-                calorieGoal: v.nutrition?.calorie_goal,
-            });
-            // #179 · 结果页换整页装配（原 `renderProfileHtml` 只出 `<section>` 片段，双击打不开）。
-            return { data: { metrics }, html: buildProfileViewDoc(v) };
-        }
-        default:
-            fail(3, '未知 calorie key：' + key);
-            throw new Error('unreachable');
-    }
-}
-/* ── #83 · 三态交付装配（M4 HTML-First ＋ 渲染失败回执） ───────────────────────────────── */
-/** 交付落点的可读描述（回执文案用；默认目录名必须出现在文案里，便于用户定位）。 */
-function describeDeliveryTarget(explicit) {
-    return explicit !== undefined ? '显式落点 ' + explicit : '默认目录 <SKILLS_DB_PATH>/' + HTML_DIR_NAME;
-}
-/** ③ 文本态的结构化文本：**同源**取 `buildDataText`（#77 契约，五 shape 投影）。
- *  `fallback` 形不在 `SERIALIZABLE_SHAPES` 内（#93 登记：无 CLI 出口）——此时退化为缩进 JSON，
- *  仍是「结构化文本」且零编造；本退化分支由 `delivery-83.test.mjs` 直接钉住。 */
-function dataTextOf(shape, key, data) {
-    try {
-        return buildDataText({
-            envelope: { version: ENVELOPE_VERSION, skill: CALORIE_SKILL, shape, key, data },
-            format: 'text',
-        });
-    }
-    catch {
-        return JSON.stringify(data, null, 2);
-    }
-}
-/** 三态判定 ＋ envelope 装配（**唯一交付落点**：同一 key、同一份 `data`，绝不各自取数）：
- *  ③ 文本态：用户**明确**要文本（通用 `--params '{"delivery":"text"}'`）／渲染层已产出文本
- *     （#91 `help.center` 的 `mode:'text'`）／**无 HTML 产物**（结构缝：`html` 为空 ⇒ 无对应模板，允许文字答）；
- *  ② 内联态：有 HTML 产物但写不进去（只读／沙箱 `EACCES|EPERM|EROFS|EBUSY`）⇒ 产物随 envelope 回传；
- *  ① 文件态（默认）：落盘 `calorie_html/*.html`，`data.output` 与 `delivery.path` 同值同源。
- *  `delivery` 为 envelope 的**顶层追加字段**（既有五字段一字不改）；P9「stdout 一行 JSON」不变。 */
-export function buildDeliveredEnvelope(input) {
-    const { key, shape, params, out } = input;
-    const html = typeof out.html === 'string' ? out.html : '';
-    const askedText = params['delivery'] === 'text';
-    const kind = askedText ? 'text' : (out.deliveryKind ?? (html.trim() === '' ? 'text' : 'html'));
-    if (kind === 'text') {
-        // 三态同源：文本由**同一份** envelope data 经 #77 `buildDataText` 投影（技能侧不自产第二套序列化）。
-        const text = typeof out.data['text'] === 'string' ? out.data['text'] : dataTextOf(shape, key, out.data);
-        const data = { ...out.data, text };
-        // 渲染层已定文本交付的键（#91 `help.center` text 态）**保留既有落盘**（`data.output` 指向该文本文件）；
-        // 其余键的文本态只走 envelope（③ 产物＝结构化文本，不落 HTML 文件）。
-        if (out.deliveryKind === 'text') {
-            const d = deliverHtml({ key, params, explicit: input.explicit, target: out.target, html: text });
-            if (d.mode === 'file')
-                data['output'] = d.path;
-            return withDelivery(buildEnvelope(key, shape, data), buildDelivery({
-                mode: 'text', path: d.mode === 'file' ? d.path : undefined, shape, html: text, bytes: d.bytes, template: 'text',
-            }));
-        }
-        return withDelivery(buildEnvelope(key, shape, data), buildDelivery({
-            mode: 'text', shape, html: text, bytes: Buffer.byteLength(text, 'utf8'), template: 'text',
-        }));
-    }
-    const d = deliverHtml({ key, params, explicit: input.explicit, target: out.target, html });
-    const data = d.mode === 'file'
-        ? { ...out.data, output: d.path }
-        : { ...out.data, html };
-    return withDelivery(buildEnvelope(key, shape, data), buildDelivery({
-        mode: d.mode, path: d.mode === 'file' ? d.path : undefined, shape, html, bytes: d.bytes,
-    }));
-}
-/** #83 · M4「渲染失败回执」：**模板化**回执（`buildErrorReceipt` ＋ `renderErrorHtml`，旧
- *  `render_error_receipt.py` 的等价物）——**严禁手写 HTML 兜底**。回执自身也走三态：默认目录可写即落盘，
- *  否则内联随 stderr 回传。机器可读回执以一行 `RECEIPT {…}` 落 **stderr**（P9：stdout 保持纯净，
- *  不吐半截 envelope），exit 5 与既有「渲染/落盘失败」口径一致。 */
-function failWithReceipt(reason, key) {
-    console.error('ERR 5: ' + reason);
-    try {
-        const receipt = buildErrorReceipt({
-            sceneName: '渲染',
-            wakeWord: key ?? '渲染失败',
-            op: '渲染／落盘未完成',
-            reason,
-            suggestions: [
-                '检查 SKILLS_DB_PATH 与 ' + HTML_DIR_NAME + ' 目录权限（只读／沙箱会自动转内联交付）',
-                '用 --output <可写绝对路径> 显式指定落点后重试',
-                '确认 ' + HTML_DIR_NAME + ' 未被同名文件占位（占位会挡住落点解析）',
-            ],
-            fixPrompt: 'calorie-cmd-read ' + (key ?? '<key>') + " --params '{…}' --output <可写绝对路径>",
-        });
-        const receiptHtml = renderErrorHtml(receipt);
-        let delivery;
-        try {
-            const d = deliverHtml({
-                key: key ?? 'calorie.help.center', params: {}, target: resolveReceiptHtmlPath(), html: receiptHtml,
-            });
-            delivery = buildDelivery({
-                mode: d.mode, path: d.mode === 'file' ? d.path : undefined, shape: 'receipt', html: receiptHtml, bytes: d.bytes,
-            });
-        }
-        catch {
-            delivery = buildDelivery({
-                mode: 'inline', shape: 'receipt', html: receiptHtml, bytes: Buffer.byteLength(receiptHtml, 'utf8'),
-            });
-        }
-        // 内联回执把模板化回执页面一并回传（否则调用方拿不到回执正文）；落盘态只回路径。
-        console.error('RECEIPT ' + JSON.stringify({
-            ok: false, ...receipt, delivery, html: delivery.mode === 'inline' ? receiptHtml : undefined,
-        }));
-    }
-    catch (e) {
-        console.error('TOAST: 回执生成失败（' + (e.message || String(e)) + '）');
-    }
-    process.exit(5);
-}
-function parseReadArgs(a) {
-    return parseArgs(a);
+    // #294 · 注册表先行：命中即走能力目录那道门（新增能力／新增命令都不必碰这个文件）。
+    // #320 · 未搬迁清单归零 ⇒ 老路那口按键分派的 switch 已成死代码，整口删除；
+    // 未命中即「这个键不存在」，直接 fail——往分派层加分支这件事已经被棘轮挡在门外。
+    const spec = REGISTRY[key];
+    if (spec) {
+        if (spec.kind !== 'read')
+            fail(3, '写键不走读分派：' + key);
+        return spec.run(params, db);
+    }
+    fail(3, '未知 calorie key：' + key);
+    throw new Error('unreachable');
 }
 async function main() {
     const o = parseReadArgs(process.argv.slice(2));
@@ -1140,18 +93,19 @@ async function main() {
                 ? dispatchWrite(o.key, params, db)
                 : dispatch(o.key, params, db);
             // #83 · 三态交付（M4 HTML-First）：① 文件态（默认）／② 内联态（只读·沙箱回退）／③ 文本态。
-            // 落点：--output（显式覆盖）> --html（legacy 别名）> 默认 calorie_html/<中文command>_<TS>[_N].html（#87／#119）。
+            // 落点：--html（显式覆盖）> 默认 calorie_html/<中文command>_<TS>[_N].html（#87／#119）。
+            // ⚠️ 老技能的 `--output` 别名**已删**（#245 收口，与其余五家同形：只认 `--html`；给 `--output` 即 exit 2）。
             // 只读类写失败 → 内联交付（产物随 envelope 回传，绝不因写不进去而文字答）；
             // 结构错／渲染错 → 渲染失败回执（模板化回执，exit 5；严禁手写 HTML 兜底）。
             try {
                 env = buildDeliveredEnvelope({
-                    key: o.key, shape: shape, out, params, explicit: o.output ?? o.html,
+                    key: o.key, shape: shape, out, params, explicit: o.html,
                 });
             }
             catch (e) {
                 if (e instanceof CalorieRenderError)
                     throw e;
-                failWithReceipt('渲染失败：' + describeDeliveryTarget(o.output ?? o.html) + '：'
+                failWithReceipt('渲染失败：' + describeDeliveryTarget(o.html) + '：'
                     + (e.message || String(e)), o.key);
             }
         }
@@ -1161,14 +115,25 @@ async function main() {
     }
     catch (e) {
         if (e instanceof CalorieRenderError) {
-            if (e.code === 'missing-data')
+            // #500 · 身体域缺数据／缺参数走失败回执整页（exit 保持 4／2，按 #365 实测）；
+            // 非身体键走原纯文本（其它域不动）。接线位是框架调用方（声明外最小 wiring，见证据）。
+            if (e.code === 'missing-data') {
+                if (bodySceneFor(o.key) !== null)
+                    failWithBodyReceipt('取数失败（缺失阻断）：' + e.message, o.key, 4);
                 fail(4, '取数失败（缺失阻断）：' + e.message);
-            if (e.code === 'bad-input')
+            }
+            if (e.code === 'bad-input') {
+                if (bodySceneFor(o.key) !== null)
+                    failWithBodyReceipt('参数失败：' + e.message, o.key, 2);
                 fail(2, '参数失败：' + e.message);
+            }
             failWithReceipt('渲染失败：' + e.message, o.key);
         }
-        if (e instanceof FetchError)
+        if (e instanceof FetchError) {
+            if (bodySceneFor(o.key) !== null)
+                failWithBodyReceipt('取数失败：' + e.message, o.key, 4);
             fail(4, '取数失败：' + e.message);
+        }
         fail(4, '未知失败：' + (e.message || String(e)));
     }
     finally {