skill-calorie 0.2.3 → 0.2.4

package/dist/cli/write.js

@@ -1,275 +1,32 @@
-import { WATER_NAME, MEALS, MEAL_WINDOWS, addMeal, updateMeal, deleteMeal, copyMeals, addMealsBatch, updateMealsByDate, deleteMealsByDate, deleteMealsByRange, deleteMealsByType, getDailySummary, } from '../fetch/diet.js';
-import { logWeight, updateWeight, updateWeightByDate, deleteWeight, deleteWeightByDate, deleteWeightRange, batchLogWeight, } from '../fetch/weight.js';
-import { addRecord, updateRecord, updateDay, deleteRecord, deleteDay, deleteRange, batchAdd, copyYesterday } from '../fetch/exercise.js';
-import { addPhotos, deletePhoto, updateTag, tagAdd, tagRemove, getPhotoRow, resolvePhotosDir, daysSinceTagPhoto, parseTags, serializeTags, } from '../fetch/photos.js';
-import { buildAddReceipt, buildDeleteReceipt, buildTagReceipt } from '../render/photo.js';
-import { addProduct, updateProduct, deprecateProduct } from '../fetch/products.js';
-import { setActivityLevel, updateProfile } from '../fetch/profile.js';
-import { getNutritionGoal, setNutritionGoal, updateWaterGoal } from '../fetch/nutritionGoal.js';
-import { pauseAllGoals, resumeAllGoals, setWeightGoal } from '../fetch/goal.js';
-import { CALIPER_FIELDS, ValidationError, addComposition, addMeasurement, deleteComposition, deleteMeasurement, } from '../fetch/body.js';
-import { SOURCE_CHOICES, SOURCE_LABELS } from '../kcal.js';
-import { buildCrudReceipt, withM5 } from '../render/receipt.js';
+import { ValidationError, } from '../fetch/body.js';
+import { withM5 } from '../render/receipt.js';
 import { CalorieRenderError } from '../render/errors.js';
-import { shiftISODate, todayISO } from '../analysis/utils.js';
 // #179 · 场景 07 三条写入词的回执页：整页装配住在能力目录 `src/profile/`（写前页在 setup.ts）。
-import { buildProfileSettingReceiptDoc } from '../profile/setup.js';
-import { buildProfileUpdateReceiptDoc } from '../profile/update.js';
+// #330 · 按命令选整页的端口也住能力目录（`src/profile/receipt.ts`，经 `src/profile/index.ts` 转出）：
+// 分派层只调门，不再写任何命令名字面量。
+import { profileReceiptDoc } from '../profile/index.js';
+// #269 · 饮食 13 条会改数据库的命令的回执页：整页装配住能力目录 `src/diet/receipt.ts`
+//（经本文件直引，不经 `src/diet/index.ts` 转出；#276 需要的新增分支由本票留空）。
+import { dietReceiptDoc } from '../diet/receipt.js';
+// #337 · 体重 4 条会改数据库的命令的回执页：整页装配住能力目录 `src/weight/receipt.ts`
+//（经 `src/weight/index.ts` 转出；与档案 3 条、饮食 13 条同形）。
+import { weightReceiptDoc } from '../weight/index.js';
+// T351 视觉修复·实施兵B · 训练计划 10 条会改数据库的命令的回执页：整页装配住能力目录 `src/workout/receipt.ts`
+//（经本文件直引，不经 `src/workout/index.ts` 转出；与饮食 13 条同形）。
+import { workoutReceiptDoc } from '../workout/receipt.js';
+// #365 · 身体细节 7 条写词的回执页：整页装配住能力目录 `src/body/receipt.ts`
+//（经 `src/body/index.ts` 转出；与体重 4 条同形，接成链上第五个装配口）。
+import { bodyReceiptDoc } from '../body/index.js';
+// #253 · 目标管理 5 条会改数据库的命令的回执页：整页装配住能力目录 `src/goal/receipt.ts`
+//（经本文件直引，不经 `src/goal/index.ts` 转出——该件明文不转出域内件；与饮食 13 条同形，
+// 接成链上第六个装配口）。
+import { goalReceiptDoc } from '../goal/receipt.js';
 import { isCalorieWriteKey } from './keys.js';
-function fail(code, msg) {
-    console.error('ERR ' + code + ': ' + msg);
-    process.exit(code);
-}
-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 needNum(params, name) {
-    const v = params[name];
-    if (typeof v !== 'number' || !Number.isFinite(v))
-        fail(2, '缺参数 ' + name + '（须为有限 number）');
-    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 optInt(params, name) {
-    const v = optNum(params, name);
-    if (v === undefined)
-        return undefined;
-    if (!Number.isInteger(v))
-        fail(2, '参数 ' + name + ' 须为整数');
-    return v;
-}
-function needId(params, name = 'id') {
-    const v = params[name];
-    if (typeof v !== 'number' || !Number.isInteger(v) || v <= 0)
-        fail(2, '缺参数 ' + name + '（正整数记录 id）');
-    return v;
-}
-function needArr(params, name) {
-    const v = params[name];
-    if (!Array.isArray(v) || v.length === 0)
-        fail(2, '缺参数 ' + name + '（非空数组）');
-    return v;
-}
-function assertISO(v, field) {
-    if (!/^\d{4}-\d{2}-\d{2}$/.test(v))
-        fail(2, field + ' 非法（须 YYYY-MM-DD）：' + v);
-}
-function esc(s) {
-    return String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
-}
-/** #101 · 删除口径单一来源（prose 词条 ＋ `items[].status` 状态串同源派生）。
- * `recoverable` 恒 false：全仓 77 键 0 个 restore/undo/recover 入口，故不得出现「可恢复」承诺。 */
-const SOFT_EXCLUDED_INNER = '软删除：行保留，已从查询与统计中排除；暂无恢复入口';
-const SOFT_EXCLUDED = '（' + SOFT_EXCLUDED_INNER + '）';
-const HARD_INNER = '硬删除，不可恢复';
-const HARD_WORDING = '（' + HARD_INNER + '）';
-/** 状态串与 prose 同源：kind 决定「软/硬」，两者一律带「不可恢复」。 */
-function deleteStatus(kind, base = '已删除') {
-    return base + (kind === 'soft' ? '（软，不可恢复）' : '（硬，不可恢复）');
-}
-/* ------------------------------------------------ #97 · M5 回执契约（追加字段，正本 t97-m5-contract.md） */
-/** 影响行数来源：SQLite `total_changes()` 在本键写库前后的增量。
- * 真实库行数（INSERT／UPDATE／DELETE／软删标记一律计；`INSERT OR REPLACE` 命中已有行＝1，
- * `INSERT OR IGNORE` 命中已有行＝0——实测 node:sqlite v24），非自报。 */
-function totalChanges(db) {
-    const row = db.prepare('SELECT total_changes() AS n').get();
-    return row && typeof row.n === 'number' ? Number(row.n) : 0;
-}
-/** 写入字段摘要（CLI 参数名口径）：create 键＝该键写入字段全集（缺省值也算写入）；
- * update 键＝本次实际变更字段；delete 键＝空数组（无写入字段，旧版同样只印 id/日期/影响）。 */
-const F = {
-    diet: ['foodName', 'calories', 'protein', 'carbs', 'fat', 'grams', 'note', 'date', 'time'],
-    water: ['ml', 'note', 'date', 'time'],
-    weight: ['kg', 'note', 'date', 'time'],
-    weightBatch: ['kg', 'date'],
-    exercise: ['type', 'calories', 'minutes', 'date', 'time', 'note', 'reps', 'category', 'difficulty', 'distance', 'heartRate', 'maxHeartRate', 'steps', 'setIndex', 'loadKg', 'backfill'],
-    photo: ['srcPaths', 'tag', 'note', 'date', 'time'],
-    product: ['productName', 'brand', 'calories', 'protein', 'fat', 'saturatedFat', 'carbohydrates', 'sugar', 'dietaryFiber', 'sodium', 'note'],
-};
-/** `calorie.goal.set` 本次**实际被 SET 的列** → CLI 参数名（正本 §3.4「update 键＝本次实际变更字段」）。
- * 与 `fetch/nutritionGoal.ts` 的两条 UPSERT 同源（#127 已改）：传 `water` 走 6 列
- * （含 `water_goal`），不传则 SQL 里**没有** `water_goal` 列——该列保持原值，
- * **不属本次 SET 的字段**，故不得报 `water`。
- * 记账列 `updated_at` 无 CLI 参数，按 §3.4 不计入摘要。
- * #127：UPSERT 只覆盖传入列，`weight_goal`／`goal_deadline`／`goal_paused`／`start_weight`／
- * `start_date`／`exercise_goal`／未传的 `water_goal` 逐列保持原值（不再整行替换）。 */
-const goalSetWrittenFields = (hasWater) => ['calorie', 'protein', 'carbs', 'fat', ...(hasWater ? ['water'] : [])];
-/** 库列名 → CLI 参数名（update 键按实际变更列回报写入字段摘要）。 */
-const COL_CLI = {
-    food_name: 'foodName', grams: 'grams', calories: 'calories', protein: 'protein', carbs: 'carbs',
-    fat: 'fat', note: 'note', date: 'date', time: 'time',
-    exercise_type: 'type', calories_burned: 'calories', duration_minutes: 'minutes', category: 'category',
-    difficulty: 'difficulty', distance_km: 'distance', avg_heart_rate: 'heartRate',
-    max_heart_rate: 'maxHeartRate', steps: 'steps', reps: 'reps', load_kg: 'loadKg',
-    set_index: 'setIndex', is_backfill: 'backfill',
-    product_name: 'productName', brand: 'brand', saturated_fat: 'saturatedFat', carbohydrates: 'carbohydrates',
-    sugar: 'sugar', dietary_fiber: 'dietaryFiber', sodium: 'sodium',
-};
-const cliNames = (cols) => cols.map((c) => COL_CLI[c] ?? c);
-/** 只取「实际提供」的参数名（写入字段摘要；`undefined` 不算写入）。 */
-function provided(params, names) {
-    return names.filter((n) => params[n] !== undefined);
-}
-/** `input` 里实际有值的键（体脂／围度等动态字段表）。 */
-function definedKeys(input) {
-    return Object.keys(input).filter((k) => input[k] !== undefined);
-}
-/** 围度库列名 → CLI 参数名（`MEASURE_CAMEL` 反向；写入字段摘要统一走 CLI 名口径）。 */
-function measureCliNames(keys) {
-    return keys.map((k) => Object.keys(MEASURE_CAMEL).find((c) => MEASURE_CAMEL[c] === k) ?? k);
-}
-/** C6 #43 · 写收据 HTML 结构化分项：摘要 + 操作元 + items 逐条（id/日期/状态/原因/明细）。 */
-function receiptHtml(scene, summary, op, recordId, items) {
-    const list = (items ?? []).length > 0
-        ? '<ul>' + (items ?? []).map((it) => '<li>#' + esc(it.id ?? '') + (it.date ? ' ' + esc(it.date) : '') + ' ' + esc(it.status) + (it.reason ? '（' + esc(it.reason) + '）' : '') + (it.detail ? ' · ' + esc(it.detail) : '') + '</li>').join('') + '</ul>'
-        : '';
-    return '<section class="ilife-page" data-skill="calorie" data-slot="ilife:calorie:receipt"><h1>' + esc(scene) + '</h1>' +
-        '<div class="ilife-item"><b>' + esc(summary) + '</b><div>op=' + esc(op) + (recordId === null ? '' : ' · id=' + esc(recordId)) + '</div>' + list + '</div></section>';
-}
-function out(receipt) {
-    return {
-        data: { ok: true, message: receipt.summary, receipt },
-        html: receiptHtml(receipt.scene, receipt.summary, receipt.op, receipt.recordId, receipt.items),
-    };
-}
-/* -------------------------------------- #179 · 场景 07 三条写入词的回执页（整页装配） */
-/** 档案库列名 ↔ CLI 参数名（逐字段对照只用这 5 项，与 `PROFILE_UPDATABLE` 同集）。 */
-const PROFILE_COLS = {
-    age: 'age', gender: 'gender', heightCm: 'height_cm', activityLevel: 'activity_level', note: 'note',
-};
-/** 档案某字段的展示值：空库（无改前值）与库内 NULL 一律写「—」，不编数据。 */
-function profileValue(row, camel) {
-    const col = PROFILE_COLS[camel];
-    if (!row || col === undefined)
-        return '—';
-    const v = row[col];
-    return v === null || v === undefined ? '—' : String(v);
-}
-/** 改档案逐字段对照：字段名（CLI 参数名，与 `writtenFields` 同口径）＋ 改前 → 改后。
- *  形照 `profile/update.ts:diffRows` 的读法（`status`＝字段名、`reason`＝对照）。 */
-function profileDiffItems(before, after, fields) {
-    return fields.map((f) => ({ status: f, reason: profileValue(before, f) + ' → ' + profileValue(after, f) }));
-}
-/** 页面「复制日志」第 4 段的命令原文：与 AI 实跑那条同形（含本次 `--params`），可照抄重跑。
- *  参数值里若出现半角单引号，原文会在此处被截断——与 `profile/setup.ts` 的 prompt 写命令同一口径，
- *  真要照抄重跑请自行把单引号转义（本仓命令原文一贯用单引号包 JSON）。 */
-function commandLine(key, params) {
-    return 'calorie-cmd-read ' + key + " --params '" + JSON.stringify(params) + "'";
-}
-/** 三条写入词的回执页换成整页装配；**其余 32 条一律返回 null**，由 `dispatchWrite` 的
- *  `?? res.html` 原样放行——那些命令的产物与 `receiptHtml` 那条片段路径逐字节不变
- *  （分派只认这三个命令名，认不出就不进这条路，也不碰 `receiptHtml` 本身）。
- *  必须在 `withM5` 之后调用：新页要印 `affectedRows`／`writtenFields`／`m5Line`。
- *  #239：把命令原文一并交给回执页，进「复制日志」第 4 段（key 与 params 都在本处作用域里）。 */
-function profileReceiptDoc(key, params, receipt) {
-    switch (key) {
-        case 'calorie.profile.set':
-        case 'calorie.profile.activity':
-            return buildProfileSettingReceiptDoc(receipt, commandLine(key, params));
-        case 'calorie.profile.update':
-            return buildProfileUpdateReceiptDoc(receipt, commandLine(key, params));
-        default:
-            return null;
-    }
-}
-const R = (scene, op, summary, wakeWord, source, extra) => buildCrudReceipt({
-    scene, action: scene, op, recordId: null, summary, items: [], wakeWord, source,
-    ...(extra ?? {}),
-});
-function photosDirOf(params) {
-    return resolvePhotosDir(optStr(params, 'photosDir') ?? null);
-}
-const SOURCE_ALIASES = { '家测皮褶钳': 'home_caliper', '医院测': 'hospital', '健身房测': 'gym', '健身房': 'gym', '医院': 'hospital', '皮褶钳': 'home_caliper' };
-function normSource(v) {
-    const s = String(v ?? '').trim();
-    if (SOURCE_CHOICES.includes(s))
-        return s;
-    const hit = SOURCE_ALIASES[s];
-    if (hit)
-        return hit;
-    fail(2, '缺参数 source（' + SOURCE_CHOICES.join('/') + ' 或中文 ' + Object.keys(SOURCE_ALIASES).join('/') + '）');
-    throw new Error('unreachable');
-}
-function normSex(v) {
-    if (v === undefined || v === null)
-        return undefined;
-    const s = String(v).trim();
-    if (s === 'male' || s === 'female')
-        return s;
-    if (s === '男')
-        return 'male';
-    if (s === '女')
-        return 'female';
-    fail(2, '参数 sex 非法（male/female 或 男/女）：' + s);
-    throw new Error('unreachable');
-}
-const MEASURE_CAMEL = {
-    chestCm: 'chest_cm', waistCm: 'waist_cm', abdomenCm: 'abdomen_cm', hipCm: 'hip_cm', shoulderCm: 'shoulder_cm',
-    leftThighCm: 'left_thigh_cm', rightThighCm: 'right_thigh_cm', leftCalfCm: 'left_calf_cm', rightCalfCm: 'right_calf_cm',
-    leftArmCm: 'left_arm_cm', rightArmCm: 'right_arm_cm', leftForearmCm: 'left_forearm_cm', rightForearmCm: 'right_forearm_cm',
-};
-const EX_CAMEL = {
-    type: 'exercise_type', exerciseType: 'exercise_type', calories: 'calories_burned', caloriesBurned: 'calories_burned',
-    minutes: 'duration_minutes', durationMinutes: 'duration_minutes', note: 'note', category: 'category', difficulty: 'difficulty',
-    distance: 'distance_km', distanceKm: 'distance_km', heartRate: 'avg_heart_rate', avgHeartRate: 'avg_heart_rate',
-    maxHeartRate: 'max_heart_rate', steps: 'steps', reps: 'reps', loadKg: 'load_kg', setIndex: 'set_index',
-    date: 'date', time: 'time', backfill: 'is_backfill', isBackfill: 'is_backfill',
-};
-function oneExercise(item, i) {
-    const g = (k) => item[k];
-    const type = g('type') ?? g('exerciseType');
-    if (typeof type !== 'string' || !type.trim())
-        fail(2, '运动 type 必填' + i);
-    const cal = g('calories') ?? g('caloriesBurned');
-    if (typeof cal !== 'number' || !Number.isFinite(cal) || cal < 0)
-        fail(2, '运动 calories 必填（≥0 number）' + i);
-    const date = g('date') ?? todayISO();
-    assertISO(date, 'date');
-    const numOrNull = (k) => {
-        const v = g(k);
-        if (v === undefined || v === null)
-            return undefined;
-        if (typeof v !== 'number' || !Number.isFinite(v))
-            fail(2, '运动参数 ' + k + ' 须为 number' + i);
-        return v;
-    };
-    const strOrUndef = (k) => {
-        const v = g(k);
-        if (v === undefined || v === null)
-            return undefined;
-        if (typeof v !== 'string')
-            fail(2, '运动参数 ' + k + ' 须为字符串' + i);
-        return v;
-    };
-    return {
-        date, exerciseType: type.trim(), caloriesBurned: cal,
-        minutes: numOrNull('minutes') ?? null, timeStr: strOrUndef('time'), note: strOrUndef('note'),
-        reps: numOrNull('reps') ?? null, category: strOrUndef('category') ?? null,
-        difficulty: strOrUndef('difficulty') ?? null, distance: numOrNull('distance') ?? numOrNull('distanceKm') ?? null,
-        heartRate: numOrNull('heartRate') ?? numOrNull('avgHeartRate') ?? null,
-        maxHeartRate: numOrNull('maxHeartRate') ?? null, steps: numOrNull('steps') ?? null,
-        setIndex: numOrNull('setIndex') ?? null, loadKg: numOrNull('loadKg') ?? null,
-        isBackfill: (g('backfill') ?? g('isBackfill')) === true,
-    };
-}
+// #294 · 命令索引：命中即走能力目录里的实现，未命中的老键落下面的 dispatchInner switch。
+import { REGISTRY } from './registry.js';
+// #294 · 参数读取与回执底座上移共用位：能力目录里的命令与分派层用同一套口径（唯一定义地）。
+import { fail } from '../shared/params.js';
+import { totalChanges } from '../shared/writeParts.js';
 /** 写分发（唯一出口 cmd_read 内调用；未知键上游已拦，此处再拦一道）。
  * #97 · M5：`affectedRows` 在此统一注入——写库前后各取一次 SQLite `total_changes()`，
  * 增量即「影响 N 行」（35 键单一来源，逐键不各自自报）。 */
@@ -278,9 +35,18 @@ export function dispatchWrite(key, params, db) {
         fail(3, '未知 calorie 写键：' + key);
     const before = totalChanges(db);
     try {
-        const res = dispatchInner(key, params, db);
+        // #294 · 注册表先行：命中即走能力目录那道门（新增能力／新增命令都不必碰这个文件）。
+        // #320 · 未搬迁清单归零 ⇒ 老写键也全在注册表里，`dispatchInner` 只剩「键不存在」这一条兜底。
+        const spec = REGISTRY[key];
+        const res = spec && spec.kind === 'write' ? spec.run(params, db) : dispatchInner(key, params, db);
         const receipt = withM5(res.data.receipt, { affectedRows: totalChanges(db) - before });
-        return { data: { ...res.data, receipt }, html: profileReceiptDoc(key, params, receipt) ?? res.html };
+        // #269 · 饮食 13 条切整页装配（`assembleDocPage`，与档案 3 条同路）；其余键原样放行。
+        // #276 插入点：如需新增命令的整页分派，在本行下方按 `?? 下一个Doc(...)` 续接（本票留空）。
+        // #337 · 体重 4 条切整页装配（与档案 3 条、饮食 13 条同路；具名键集在 `src/weight/receipt.ts`）。
+        // T351 视觉修复·实施兵B · 训练计划 10 条切整页装配（与饮食 13 条同路；具名键集在 `src/workout/receipt.ts`）。
+        // #365 · 身体细节 7 条切整页装配（链上第五个装配口；具名键集在 `src/body/receipt.ts`）。
+        // #253 · 目标管理 5 条切整页装配（链上第六个装配口；具名键集在 `src/goal/receipt.ts`）。
+        return { data: { ...res.data, receipt }, html: profileReceiptDoc(key, params, receipt, db) ?? dietReceiptDoc(key, params, receipt, db) ?? weightReceiptDoc(key, params, receipt, db) ?? workoutReceiptDoc(key, params, receipt, db) ?? bodyReceiptDoc(key, params, receipt, db) ?? goalReceiptDoc(key, params, receipt, db) ?? res.html };
     }
     catch (e) {
         if (e instanceof ValidationError)
@@ -290,680 +56,6 @@ export function dispatchWrite(key, params, db) {
 }
 function dispatchInner(key, params, db) {
     switch (key) {
-        case 'calorie.diet.add': {
-            const foodName = (optStr(params, 'foodName') ?? optStr(params, 'food_name') ?? '');
-            if (!foodName.trim())
-                fail(2, '缺参数 foodName');
-            const calories = needNum(params, 'calories');
-            const protein = needNum(params, 'protein');
-            for (const [k, v] of [['calories', calories], ['protein', protein]]) {
-                if (v < 0)
-                    fail(2, k + ' 不能为负');
-            }
-            for (const k of ['carbs', 'fat']) {
-                const v = optNum(params, k);
-                if (v !== undefined && v < 0)
-                    fail(2, k + ' 不能为负');
-            }
-            const grams0 = optNum(params, 'grams');
-            if (grams0 !== undefined && grams0 <= 0)
-                fail(2, 'grams 必须为正');
-            const date = optStr(params, 'date');
-            if (date)
-                assertISO(date, 'date');
-            const meal = optStr(params, 'meal') ?? optStr(params, 'mealOverride');
-            if (meal !== undefined && !MEALS.includes(meal))
-                fail(2, '--meal 须为 ' + MEALS.join('、'));
-            const r = addMeal(db, {
-                foodName: foodName.trim(), calories, protein,
-                carbs: optNum(params, 'carbs') ?? 0, fat: optNum(params, 'fat') ?? 0,
-                grams: optNum(params, 'grams') ?? 100, note: optStr(params, 'note'),
-                date, time: optStr(params, 'time'), mealOverride: meal,
-            });
-            if (r.duplicate) {
-                return out(R('记一餐', 'create', String(r.message ?? '重复记录已跳过'), '记一餐', 'food_log (写库回执)', {
-                    recordId: r.dupId ?? null, noChange: true,
-                    ids: r.dupId ? [r.dupId] : [], idSource: r.dupId ? 'record' : 'none', writtenFields: [],
-                }));
-            }
-            const remain = r.remainingCal === null || r.remainingCal === undefined ? '' : ' · 今日剩 ' + r.remainingCal + ' 卡';
-            return out(R('记一餐', 'create', '已记一餐：' + r.food_name + ' ' + r.date + ' ' + r.time + '（' + r.meal + '）' + remain, '记一餐', 'food_log (写库回执)', {
-                recordId: r.id, ids: r.id === null ? [] : [r.id], writtenFields: [...F.diet],
-                items: [{ id: r.id ?? undefined, date: r.date, status: '成功', reason: '', detail: r.food_name }],
-            }));
-        }
-        case 'calorie.diet.update': {
-            const id = needId(params);
-            const fields = {};
-            const name = optStr(params, 'foodName') ?? optStr(params, 'food_name');
-            if (name !== undefined)
-                fields['food_name'] = name;
-            for (const k of ['grams', 'calories', 'protein', 'carbs', 'fat']) {
-                const v = optNum(params, k);
-                if (v !== undefined)
-                    fields[k] = v;
-            }
-            for (const k of ['note', 'date', 'time']) {
-                const v = optStr(params, k);
-                if (v !== undefined)
-                    fields[k] = v;
-            }
-            if (Object.keys(fields).length === 0)
-                fail(2, '至少传 1 个待改字段');
-            if (typeof fields['date'] === 'string')
-                assertISO(fields['date'], 'date');
-            const r = updateMeal(db, id, fields);
-            return out(R('改饮食记录', 'update', '已更新饮食 #' + id + '（' + (r.changed.length ? r.changed.join('、') : '无实际变化') + '）', '改饮食记录', 'food_log (写库回执)', {
-                recordId: id, ids: [id], writtenFields: cliNames(Object.keys(fields)), noChange: r.changed.length === 0,
-                items: [{ id, status: '已更新', reason: '', detail: r.changed.join(',') || '无变化' }],
-            }));
-        }
-        case 'calorie.diet.remove': {
-            const id = needId(params);
-            const r = deleteMeal(db, id);
-            return out(R('删饮食记录', 'delete', '已删除饮食 #' + id + '（' + r.food_name + ' ' + r.calories + ' 卡 · ' + HARD_INNER + '）', '删饮食记录', 'food_log (写库回执)', {
-                recordId: id, ids: [id], writtenFields: [], items: [{ id, status: deleteStatus('hard'), reason: '', detail: r.food_name }],
-            }));
-        }
-        case 'calorie.diet.batch': {
-            const items = needArr(params, 'items');
-            if (items.length > 200)
-                fail(2, 'items 至多 200 条');
-            const r = addMealsBatch(db, items.map((e) => {
-                const o = (e ?? {});
-                const food = o['foodName'] ?? o['food_name'];
-                return {
-                    date: o['date'] === undefined ? undefined : String(o['date']),
-                    time: o['time'] === undefined ? undefined : String(o['time']),
-                    food_name: food === undefined ? undefined : String(food),
-                    grams: o['grams'], calories: o['calories'],
-                    protein: o['protein'], carbs: o['carbs'],
-                    fat: o['fat'], note: o['note'] === undefined ? undefined : String(o['note']),
-                };
-            }));
-            return out(R('批量补记饮食', 'create', '批量记饮食：新增 ' + r.added + '，跳过 ' + r.skipped + '，失败 ' + r.failed, '批量补记饮食', 'food_log (写库回执)', {
-                noChange: r.added === 0, ids: [], idSource: 'condition',
-                writtenFields: r.added > 0 ? [...F.diet] : [],
-                items: r.failures.slice(0, 20).map(([idx, reason]) => ({ status: '失败', reason, detail: '第' + idx + '条' })),
-            }));
-        }
-        case 'calorie.diet.copy': {
-            const today = todayISO();
-            const from = optStr(params, 'from') ?? optStr(params, 'fromDate') ?? shiftISODate(today, -1);
-            const to = optStr(params, 'to') ?? optStr(params, 'toDate') ?? today;
-            assertISO(from, 'from');
-            assertISO(to, 'to');
-            const r = copyMeals(db, from, to);
-            if (r.copied + r.skipped === 0)
-                throw new CalorieRenderError('missing-data', '来源无饮食记录（' + from + '）');
-            return out(R('复制昨日饮食', 'create', '已复制饮食 ' + from + '→' + to + '：复制 ' + r.copied + '，跳过 ' + r.skipped, '复制昨日饮食', 'food_log (写库回执)', {
-                noChange: r.copied === 0, ids: [], idSource: 'condition',
-                writtenFields: r.copied > 0 ? [...F.diet] : [],
-            }));
-        }
-        case 'calorie.diet.update-by-date': {
-            const date = needStr(params, 'date');
-            assertISO(date, 'date');
-            const fields = {};
-            const name = optStr(params, 'foodName') ?? optStr(params, 'food_name');
-            if (name !== undefined)
-                fields['food_name'] = name;
-            for (const k of ['grams', 'calories', 'protein', 'carbs', 'fat', 'note', 'time']) {
-                const v = k === 'note' || k === 'time' ? optStr(params, k) : optNum(params, k);
-                if (v !== undefined)
-                    fields[k] = v;
-            }
-            if (Object.keys(fields).length === 0)
-                fail(2, '至少传 1 个待改字段');
-            const r = updateMealsByDate(db, date, fields);
-            if (r.matched === 0)
-                throw new CalorieRenderError('missing-data', '无饮食记录（' + date + '）');
-            return out(R('改某日饮食', 'update', '已更新 ' + date + ' 饮食 ' + r.updated + ' 条（' + r.changedFields.join('、') + '）', '改某日饮食', 'food_log (写库回执)', {
-                ids: [], idSource: 'condition', writtenFields: cliNames(r.changedFields),
-            }));
-        }
-        case 'calorie.diet.remove-by-date': {
-            const date = needStr(params, 'date');
-            assertISO(date, 'date');
-            const r = deleteMealsByDate(db, date);
-            if (r.deleted === 0)
-                throw new CalorieRenderError('missing-data', '无饮食记录（' + date + '）');
-            return out(R('删某日饮食', 'delete', '已删除 ' + date + ' 饮食 ' + r.deleted + ' 条' + HARD_WORDING, '删某日饮食', 'food_log (写库回执)', { ids: [], idSource: 'condition', writtenFields: [] }));
-        }
-        case 'calorie.diet.remove-by-range': {
-            const start = needStr(params, 'start');
-            const end = needStr(params, 'end');
-            assertISO(start, 'start');
-            assertISO(end, 'end');
-            if (start > end)
-                fail(2, 'start 不得晚于 end');
-            const r = deleteMealsByRange(db, start, end);
-            if (r.deleted === 0)
-                throw new CalorieRenderError('missing-data', '无饮食记录（' + start + '~' + end + '）');
-            return out(R('批量删饮食', 'delete', '已删除 ' + start + '~' + end + ' 饮食 ' + r.deleted + ' 条' + HARD_WORDING, '批量删饮食', 'food_log (写库回执)', { ids: [], idSource: 'condition', writtenFields: [] }));
-        }
-        case 'calorie.diet.remove-by-type': {
-            const date = needStr(params, 'date');
-            assertISO(date, 'date');
-            const mealType = needStr(params, 'mealType');
-            if (!Object.prototype.hasOwnProperty.call(MEAL_WINDOWS, mealType))
-                fail(2, 'mealType 须为 ' + Object.keys(MEAL_WINDOWS).join('/') + '：' + mealType);
-            const r = deleteMealsByType(db, date, mealType);
-            if (r.deleted === 0)
-                throw new CalorieRenderError('missing-data', date + ' 无' + mealType + '记录');
-            return out(R('删一餐', 'delete', '已删除 ' + date + ' ' + mealType + ' ' + r.deleted + ' 条' + HARD_WORDING, '删一餐', 'food_log (写库回执)', { ids: [], idSource: 'condition', writtenFields: [] }));
-        }
-        case 'calorie.water.log': {
-            const ml = needNum(params, 'ml');
-            if (!(ml > 0) || ml > 10000)
-                fail(2, 'ml 须为 0..10000 毫升');
-            const date = optStr(params, 'date');
-            if (date)
-                assertISO(date, 'date');
-            const r = addMeal(db, {
-                foodName: WATER_NAME, calories: 0, protein: 0, grams: ml,
-                note: optStr(params, 'note'), date, time: optStr(params, 'time'),
-            });
-            if (r.duplicate) {
-                // 与 `calorie.diet.add` 同口径（§3.3 `record`）：重复跳过的原 id 由 fetch 回传（`fetch/diet.ts:96`），
-                // 拿得到就报 `record`＋`ids=[dupId]`，拿不到才退 `none`（返修 R-3／蓝队 D-3 统一）。
-                return out(R('记喝水', 'create', String(r.message ?? '重复记录已跳过'), '记喝水', 'food_log (写库回执)', {
-                    recordId: r.dupId ?? null, noChange: true,
-                    ids: r.dupId ? [r.dupId] : [], idSource: r.dupId ? 'record' : 'none', writtenFields: [],
-                }));
-            }
-            const day = date ?? todayISO();
-            const sum = getDailySummary(db, day);
-            return out(R('记喝水', 'create', '已记喝水 ' + ml + ' ml（' + day + ' 累计 ' + sum.waterMl + ' ml）', '记喝水', 'food_log (写库回执)', {
-                recordId: r.id, ids: r.id === null ? [] : [r.id], writtenFields: [...F.water],
-                items: [{ id: r.id ?? undefined, date: r.date, status: '成功', reason: '', detail: ml + 'ml' }],
-            }));
-        }
-        case 'calorie.weight.log': {
-            const kg = needNum(params, 'kg');
-            if (!(kg > 0) || kg > 500)
-                fail(2, 'kg 须为 0..500');
-            const date = optStr(params, 'date');
-            if (date)
-                assertISO(date, 'date');
-            const r = logWeight(db, kg, optStr(params, 'note') ?? '', date, optStr(params, 'time'));
-            const bmiText = r.bmi === null ? 'BMI 待补身高（补档案：calorie-cmd-read calorie.profile.set)' : 'BMI ' + r.bmi;
-            return out(R('记体重', 'create', '已记体重 ' + r.kg + ' kg（' + bmiText + ' · ' + r.date + ' ' + r.time + '）', '记体重', 'weight_log (写库回执)', {
-                recordId: r.id, ids: [r.id], writtenFields: [...F.weight],
-                items: [{ id: r.id, date: r.date, status: '成功', reason: '', detail: r.kg + 'kg' }],
-            }));
-        }
-        case 'calorie.weight.update': {
-            const id = optNum(params, 'id');
-            const date = optStr(params, 'date');
-            const kg = optNum(params, 'kg');
-            const note = optStr(params, 'note');
-            if (kg !== undefined && (!(kg > 0) || kg > 500))
-                fail(2, 'kg 须为 0..500');
-            if (id !== undefined) {
-                if (!Number.isInteger(id) || id <= 0)
-                    fail(2, 'id 须为正整数');
-                const r = updateWeight(db, id, kg, note);
-                const bmiTextU = r.bmi === null ? 'BMI 待补身高（补档案：calorie-cmd-read calorie.profile.set)' : 'BMI ' + r.bmi;
-                return out(R('改体重记录', 'update', '已更新体重 #' + id + '：' + r.oldWeight + '→' + r.newWeight + ' kg（' + bmiTextU + '）', '改体重记录', 'weight_log (写库回执)', {
-                    recordId: id, ids: [id], writtenFields: [...(kg !== undefined ? ['kg'] : []), ...(note !== undefined ? ['note'] : [])],
-                    items: [{ id, status: '已更新', reason: '' }],
-                }));
-            }
-            if (date !== undefined) {
-                assertISO(date, 'date');
-                const r = updateWeightByDate(db, date, kg, note);
-                return out(R('改某日体重', 'update', '已更新 ' + date + ' 体重 ' + r.hitCount + ' 条', '改某日体重', 'weight_log (写库回执)', {
-                    ids: [], idSource: 'condition', writtenFields: [...(kg !== undefined ? ['kg'] : []), ...(note !== undefined ? ['note'] : [])],
-                }));
-            }
-            fail(2, '缺参数 id 或 date（二选一）');
-            throw new Error('unreachable');
-        }
-        case 'calorie.weight.remove': {
-            const id = optNum(params, 'id');
-            const date = optStr(params, 'date');
-            const start = optStr(params, 'start');
-            const end = optStr(params, 'end');
-            if (id !== undefined) {
-                if (!Number.isInteger(id) || id <= 0)
-                    fail(2, 'id 须为正整数');
-                const r = deleteWeight(db, id);
-                return out(R('删体重记录', 'delete', '已删除体重 #' + id + '（' + r.date + ' ' + r.weight_kg + ' kg · ' + HARD_INNER + '）', '删体重记录', 'weight_log (写库回执)', {
-                    recordId: id, ids: [id], writtenFields: [], items: [{ id, status: deleteStatus('hard'), reason: '' }],
-                }));
-            }
-            if (date !== undefined) {
-                assertISO(date, 'date');
-                const r = deleteWeightByDate(db, date);
-                return out(R('删某日体重', 'delete', '已删除 ' + date + ' 体重 ' + r.deletedCount + ' 条' + HARD_WORDING, '删某日体重', 'weight_log (写库回执)', { ids: [], idSource: 'condition', writtenFields: [] }));
-            }
-            if (start !== undefined || end !== undefined) {
-                if (start === undefined || end === undefined)
-                    fail(2, '按范围删须同时传 start/end');
-                assertISO(start, 'start');
-                assertISO(end, 'end');
-                if (start > end)
-                    fail(2, 'start 不得晚于 end');
-                const r = deleteWeightRange(db, start, end);
-                return out(R('批量删体重', 'delete', '已删除 ' + start + '~' + end + ' 体重 ' + r.deletedCount + ' 条' + HARD_WORDING, '批量删体重', 'weight_log (写库回执)', { ids: [], idSource: 'condition', writtenFields: [] }));
-            }
-            fail(2, '缺参数 id/date/start+end（三选一）');
-            throw new Error('unreachable');
-        }
-        case 'calorie.weight.batch': {
-            const items = needArr(params, 'items');
-            if (items.length > 365)
-                fail(2, 'items 至多 365 条');
-            const r = batchLogWeight(db, items.map((e) => {
-                const o = (e ?? {});
-                return { date: o['date'] === undefined ? undefined : String(o['date']), kg: o['kg'] };
-            }));
-            return out(R('批量补录体重', 'create', '批量记体重：写入 ' + r.wrote + '，跳过 ' + r.skipped + '，失败 ' + r.failed, '批量补录体重', 'weight_log (写库回执)', {
-                noChange: r.wrote === 0, ids: [], idSource: 'condition',
-                writtenFields: r.wrote > 0 ? [...F.weightBatch] : [],
-                items: r.items.filter((x) => x.status === '失败').slice(0, 20).map((x) => ({ status: '失败', reason: x.reason, detail: String(x.date) })),
-            }));
-        }
-        case 'calorie.exercise.add': {
-            if (params['copyFrom'] !== undefined) {
-                if (params['copyFrom'] !== 'yesterday')
-                    fail(2, 'copyFrom 只支持 yesterday');
-                const target = optStr(params, 'date') ?? optStr(params, 'targetDate') ?? todayISO();
-                assertISO(target, 'date');
-                const r = copyYesterday(db, target);
-                if (r.copied + r.skipped === 0)
-                    throw new CalorieRenderError('missing-data', '昨日无运动记录可复制');
-                return out(R('复制昨日运动', 'create', '已复制昨日运动→' + target + '：复制 ' + r.copied + '，跳过 ' + r.skipped, '复制昨日运动', 'exercise_log (写库回执)', {
-                    noChange: r.copied === 0, ids: [], idSource: 'condition',
-                    writtenFields: r.copied > 0 ? [...F.exercise] : [],
-                }));
-            }
-            if (params['items'] !== undefined) {
-                const items = needArr(params, 'items');
-                if (items.length > 200)
-                    fail(2, 'items 至多 200 条');
-                const r = batchAdd(db, items.map((e, i) => oneExercise((e ?? {}), '（第' + i + '条）')));
-                return out(R('记运动', 'create', '批量记运动：新增 ' + r.added + ' 条', '批量补记运动', 'exercise_log (写库回执)', {
-                    recordId: r.ids[0] ?? null, ids: r.ids, idSource: r.ids.length > 0 ? 'record' : 'condition',
-                    writtenFields: r.added > 0 ? [...F.exercise] : [],
-                }));
-            }
-            const input = oneExercise(params, '');
-            const r = addRecord(db, input);
-            return out(R('记运动', 'create', '已记运动：' + input.exerciseType + ' ' + input.caloriesBurned + ' 卡' + (input.minutes ? ' · ' + input.minutes + ' 分钟' : '') + '（' + input.date + '）', '记运动', 'exercise_log (写库回执)', {
-                recordId: r.id, ids: [r.id], writtenFields: [...F.exercise],
-                items: [{ id: r.id, date: input.date, status: '成功', reason: '', detail: input.exerciseType }],
-            }));
-        }
-        case 'calorie.exercise.update': {
-            const id = optNum(params, 'id');
-            const date = optStr(params, 'date');
-            const fields = {};
-            for (const [camel, col] of Object.entries(EX_CAMEL)) {
-                if (camel === 'type' || camel === 'exerciseType' || camel === 'calories' || camel === 'caloriesBurned')
-                    continue;
-                if (params[camel] !== undefined)
-                    fields[col] = params[camel];
-            }
-            const t = optStr(params, 'type') ?? optStr(params, 'exerciseType');
-            if (t !== undefined) {
-                if (!t.trim())
-                    fail(2, 'type 不得为空');
-                fields['exercise_type'] = t.trim();
-            }
-            const cal = optNum(params, 'calories') ?? optNum(params, 'caloriesBurned');
-            if (cal !== undefined) {
-                if (cal < 0)
-                    fail(2, 'calories 不得为负');
-                fields['calories_burned'] = cal;
-            }
-            for (const k of Object.keys(params)) {
-                if (!(k in EX_CAMEL) && k !== 'id' && k !== 'key')
-                    fail(2, '不支持字段: ' + k);
-            }
-            if (Object.keys(fields).length === 0)
-                fail(2, '至少传 1 个待改字段');
-            if (typeof fields['date'] === 'string')
-                assertISO(fields['date'], 'date');
-            if (id !== undefined) {
-                if (!Number.isInteger(id) || id <= 0)
-                    fail(2, 'id 须为正整数');
-                updateRecord(db, id, fields);
-                return out(R('改运动记录', 'update', '已更新运动 #' + id + '（' + Object.keys(fields).join('、') + '）', '改运动记录', 'exercise_log (写库回执)', {
-                    recordId: id, ids: [id], writtenFields: cliNames(Object.keys(fields)),
-                    items: [{ id, status: '已更新', reason: '' }],
-                }));
-            }
-            if (date !== undefined) {
-                assertISO(date, 'date');
-                const r = updateDay(db, date, fields);
-                if (r.matched === 0)
-                    throw new CalorieRenderError('missing-data', '无运动记录（' + date + '）');
-                return out(R('改某日运动', 'update', '已更新 ' + date + ' 运动 ' + r.matched + ' 条', '改某日运动', 'exercise_log (写库回执)', {
-                    ids: [], idSource: 'condition', writtenFields: cliNames(Object.keys(fields)),
-                }));
-            }
-            fail(2, '缺参数 id 或 date（二选一）');
-            throw new Error('unreachable');
-        }
-        case 'calorie.exercise.remove': {
-            const id = optNum(params, 'id');
-            const date = optStr(params, 'date');
-            const from = optStr(params, 'from');
-            const to = optStr(params, 'to');
-            if (id !== undefined) {
-                if (!Number.isInteger(id) || id <= 0)
-                    fail(2, 'id 须为正整数');
-                deleteRecord(db, id);
-                return out(R('删运动记录', 'delete', '已删除运动 #' + id + SOFT_EXCLUDED, '删运动记录', 'exercise_log (写库回执)', {
-                    recordId: id, ids: [id], writtenFields: ['is_deleted'], items: [{ id, status: deleteStatus('soft'), reason: '' }],
-                }));
-            }
-            if (date !== undefined) {
-                assertISO(date, 'date');
-                const n = deleteDay(db, date);
-                if (n === 0)
-                    throw new CalorieRenderError('missing-data', '无运动记录（' + date + '）');
-                return out(R('删某日运动', 'delete', '已删除 ' + date + ' 运动 ' + n + ' 条' + SOFT_EXCLUDED, '删某日运动', 'exercise_log (写库回执)', { ids: [], idSource: 'condition', writtenFields: ['is_deleted'] }));
-            }
-            if (from !== undefined || to !== undefined) {
-                if (from === undefined || to === undefined)
-                    fail(2, '按范围删须同时传 from/to');
-                assertISO(from, 'from');
-                assertISO(to, 'to');
-                if (from > to)
-                    fail(2, 'from 不得晚于 to');
-                const n = deleteRange(db, from, to);
-                if (n === 0)
-                    throw new CalorieRenderError('missing-data', '无运动记录（' + from + '~' + to + '）');
-                return out(R('批量删运动', 'delete', '已删除 ' + from + '~' + to + ' 运动 ' + n + ' 条' + SOFT_EXCLUDED, '批量删运动', 'exercise_log (写库回执)', { ids: [], idSource: 'condition', writtenFields: ['is_deleted'] }));
-            }
-            fail(2, '缺参数 id/date/from+to（三选一）');
-            throw new Error('unreachable');
-        }
-        case 'calorie.photo.add': {
-            const raw = params['srcPaths'] ?? params['srcPath'];
-            const srcPaths = (Array.isArray(raw) ? raw : [raw]).filter((s) => typeof s === 'string' && s.length > 0);
-            if (srcPaths.length === 0)
-                fail(2, '缺参数 srcPaths（照片源文件路径数组）');
-            if (srcPaths.length > 20)
-                fail(2, 'srcPaths 至多 20 张');
-            const tag = needStr(params, 'tag');
-            const dir = photosDirOf(params);
-            const today = optStr(params, 'date') ?? todayISO();
-            assertISO(today, 'date');
-            const added = addPhotos(db, dir, { srcPaths, tag, note: optStr(params, 'note'), today, nowTime: optStr(params, 'time') });
-            if (added.length === 0)
-                throw new CalorieRenderError('missing-data', '照片源文件均不存在，未存入');
-            let distance = null;
-            try {
-                const days = daysSinceTagPhoto(db, tag, today);
-                distance = days === null ? null : { tag, days };
-            }
-            catch {
-                distance = null;
-            }
-            const receipt = withM5(buildAddReceipt(added, { tag, note: optStr(params, 'note'), distance, failedCount: srcPaths.length - added.length || undefined }), {
-                ids: added.map((a) => a.id), writtenFields: [...F.photo],
-            });
-            return { data: { ok: true, message: receipt.summary, receipt }, html: receiptHtml(receipt.scene, receipt.summary, receipt.op, receipt.recordId, receipt.items) };
-        }
-        case 'calorie.photo.remove': {
-            const id = needId(params);
-            const dir = photosDirOf(params);
-            const snap = getPhotoRow(db, id);
-            if (!snap)
-                throw new CalorieRenderError('missing-data', '身材照 #' + id + ' 不存在');
-            deletePhoto(db, dir, id);
-            const receipt = withM5(buildDeleteReceipt(snap), { ids: [id], writtenFields: [] });
-            return { data: { ok: true, message: receipt.summary, receipt }, html: receiptHtml(receipt.scene, receipt.summary, receipt.op, receipt.recordId, receipt.items) };
-        }
-        case 'calorie.photo.tag': {
-            const id = needId(params);
-            const op = needStr(params, 'op');
-            if (op !== 'set' && op !== 'add' && op !== 'remove')
-                fail(2, 'op 须为 set/add/remove：' + op);
-            const row = getPhotoRow(db, id);
-            if (!row)
-                throw new CalorieRenderError('missing-data', '身材照 #' + id + ' 不存在');
-            const before = [...row.tag_list];
-            let scene;
-            if (op === 'set') {
-                const raw = params['tags'] ?? params['tag'];
-                const tags = Array.isArray(raw) ? raw.map(String) : parseTags(typeof raw === 'string' ? raw : '');
-                if (tags.length === 0)
-                    fail(2, '缺参数 tags（新标签全量）');
-                updateTag(db, id, serializeTags(tags));
-                scene = '改照片标签';
-            }
-            else if (op === 'add') {
-                const tag = needStr(params, 'tag');
-                tagAdd(db, id, tag);
-                scene = '加照片标签';
-            }
-            else {
-                const tag = needStr(params, 'tag');
-                if (parseTags(tag).length !== 1)
-                    fail(2, '删标签一次只删 1 个');
-                tagRemove(db, id, tag);
-                scene = '删照片标签';
-            }
-            const after = getPhotoRow(db, id)?.tag_list ?? before;
-            const receipt = withM5(buildTagReceipt(id, before, after, scene), { ids: [id], writtenFields: op === 'set' ? ['tags'] : ['tag'] });
-            return { data: { ok: true, message: receipt.summary, receipt }, html: receiptHtml(receipt.scene, receipt.summary, receipt.op, receipt.recordId, receipt.items) };
-        }
-        case 'calorie.product.add': {
-            const productName = (optStr(params, 'productName') ?? optStr(params, 'product_name') ?? '');
-            if (!productName.trim())
-                fail(2, '缺参数 productName');
-            const r = addProduct(db, {
-                productName: productName.trim(), brand: optStr(params, 'brand'),
-                calories: needNum(params, 'calories'), protein: needNum(params, 'protein'), fat: needNum(params, 'fat'),
-                saturatedFat: optNum(params, 'saturatedFat'), carbohydrates: needNum(params, 'carbohydrates'),
-                sugar: optNum(params, 'sugar'), dietaryFiber: optNum(params, 'dietaryFiber'),
-                sodium: needNum(params, 'sodium'), note: optStr(params, 'note'),
-            });
-            return out(R('存食品', 'create', '已存食品 #' + r.id + '（' + productName.trim() + '）', '存食品', 'nutrition_products (写库回执)', {
-                recordId: r.id, ids: [r.id], writtenFields: [...F.product],
-                items: [{ id: r.id, status: '成功', reason: '', detail: productName.trim() }],
-            }));
-        }
-        case 'calorie.product.update': {
-            const id = needId(params);
-            const map = {
-                productName: 'product_name', brand: 'brand', calories: 'calories', protein: 'protein', fat: 'fat',
-                saturatedFat: 'saturated_fat', carbohydrates: 'carbohydrates', sugar: 'sugar',
-                dietaryFiber: 'dietary_fiber', sodium: 'sodium', note: 'note', category: 'category',
-            };
-            const fields = {};
-            for (const [camel, col] of Object.entries(map)) {
-                if (params[camel] !== undefined)
-                    fields[col] = params[camel];
-            }
-            for (const k of Object.keys(params)) {
-                if (!(k in map) && k !== 'id' && k !== 'key')
-                    fail(2, '不支持字段: ' + k);
-            }
-            if (Object.keys(fields).length === 0)
-                fail(2, '至少传 1 个待改字段');
-            const r = updateProduct(db, id, fields);
-            if (!r.updated)
-                throw new CalorieRenderError('missing-data', '食品 #' + id + ' 不存在');
-            return out(R('改食品', 'update', '已更新食品 #' + id + '（' + Object.keys(fields).join('、') + '）', '改食品', 'nutrition_products (写库回执)', {
-                recordId: id, ids: [id], writtenFields: cliNames(Object.keys(fields)),
-                items: [{ id, status: '已更新', reason: '' }],
-            }));
-        }
-        case 'calorie.product.deprecate': {
-            const id = needId(params);
-            const r = deprecateProduct(db, id);
-            if (!r.ok) {
-                if (/not found/.test(String(r.error ?? '')))
-                    throw new CalorieRenderError('missing-data', '食品 #' + id + ' 不存在');
-                fail(2, String(r.error ?? '废弃失败'));
-            }
-            return out(R('下架食品', 'update', '已下架食品 #' + id + '（' + (r.name ?? '') + ' · ' + SOFT_EXCLUDED_INNER + '）', '下架食品', 'nutrition_products (写库回执)', {
-                recordId: id, ids: [id], writtenFields: ['is_deprecated'], items: [{ id, status: deleteStatus('soft', '已下架'), reason: '' }],
-            }));
-        }
-        case 'calorie.profile.set':
-        case 'calorie.profile.update': {
-            const isSet = key === 'calorie.profile.set';
-            const scene = isSet ? '设置档案' : '改档案';
-            const wake = isSet ? '设置档案' : '改档案';
-            const picked = {};
-            if (params['fields'] !== undefined) {
-                const f = params['fields'];
-                if (typeof f !== 'object' || f === null || Array.isArray(f))
-                    fail(2, 'fields 须为对象');
-                Object.assign(picked, f);
-            }
-            else if (params['field'] !== undefined) {
-                picked[String(needStr(params, 'field'))] = params['value'];
-            }
-            else {
-                for (const k of ['age', 'gender', 'heightCm', 'activityLevel', 'note']) {
-                    if (params[k] !== undefined)
-                        picked[k] = params[k];
-                }
-            }
-            for (const k of Object.keys(picked)) {
-                if (!['age', 'gender', 'heightCm', 'activityLevel', 'note'].includes(k))
-                    fail(2, '不支持字段: ' + k);
-            }
-            if (Object.keys(picked).length === 0)
-                fail(2, '至少传 1 个档案字段');
-            const r = updateProfile(db, picked);
-            const after = r.after;
-            return out(R(scene, 'update', '已' + scene + '（身高 ' + (after.height_cm ?? '—') + ' · 年龄 ' + (after.age ?? '—') + ' · 活动量 ' + (after.activity_level ?? '—') + '）', wake, 'user_profile (写库回执)', {
-                recordId: 1, ids: [1], idSource: 'singleton', writtenFields: Object.keys(picked), noChange: r.changed.length === 0,
-                // #179 · 改档案回执带逐字段对照（设置档案没有「改前」概念，items 保持空）。
-                items: isSet ? [] : profileDiffItems(r.before, after, Object.keys(picked)),
-            }));
-        }
-        case 'calorie.profile.activity': {
-            const level = optStr(params, 'activityLevel') ?? optStr(params, 'level') ?? '';
-            if (!level.trim())
-                fail(2, '缺参数 activityLevel');
-            const r = setActivityLevel(db, level);
-            return out(R('设活动量', 'update', '已设活动量：' + (r.before ?? '—') + '→' + r.after, '设活动量', 'user_profile (写库回执)', {
-                recordId: 1, ids: [1], idSource: 'singleton', writtenFields: ['activityLevel'], noChange: r.before === r.after,
-            }));
-        }
-        case 'calorie.goal.set': {
-            const calorie = needNum(params, 'calorie');
-            const protein = needNum(params, 'protein');
-            const carbs = needNum(params, 'carbs');
-            const fat = needNum(params, 'fat');
-            const water = optNum(params, 'water');
-            if (!(calorie > 0))
-                fail(2, '热量目标必须为正数');
-            for (const [k, v] of [['protein', protein], ['carbs', carbs], ['fat', fat]]) {
-                if (v < 0)
-                    fail(2, k + ' 不能为负');
-            }
-            if (water !== undefined && water < 0)
-                fail(2, 'water 不能为负');
-            const had = getNutritionGoal(db) !== null;
-            const r = setNutritionGoal(db, { calorie, protein, carbs, fat, water });
-            const tail = r.consistent ? ' · 宏量自洽' : ' · ⚠宏量换算差 ' + r.diffKcal + ' 卡（>50 建议复核）';
-            return out(R('定营养目标', had ? 'update' : 'create', '已定营养目标：' + r.calorieGoal + ' 卡·蛋白 ' + r.proteinGoal + '·碳水 ' + r.carbsGoal + '·脂肪 ' + r.fatGoal + (r.waterGoal === null ? '' : '·饮水 ' + r.waterGoal) + tail, '定营养目标', 'daily_goal (写库回执)', {
-                recordId: 1, ids: [1], idSource: 'singleton', writtenFields: goalSetWrittenFields(water !== undefined),
-            }));
-        }
-        case 'calorie.goal.water': {
-            const water = needNum(params, 'water');
-            if (getNutritionGoal(db) === null)
-                throw new CalorieRenderError('missing-data', '尚无营养目标行（先定营养目标）');
-            const r = updateWaterGoal(db, water);
-            return out(R('定饮水目标', 'update', '已定饮水目标：' + (r.oldWaterGoal ?? '—') + '→' + r.newWaterGoal + ' ml', '定饮水目标', 'daily_goal (写库回执)', {
-                recordId: 1, ids: [1], idSource: 'singleton', writtenFields: ['water'], noChange: r.oldWaterGoal === r.newWaterGoal,
-            }));
-        }
-        case 'calorie.goal.weight': {
-            const kg = needNum(params, 'kg');
-            if (!(kg > 0) || kg > 500)
-                fail(2, 'kg 须为 0..500');
-            const r = setWeightGoal(db, {
-                kg, deadline: params['deadline'], startKg: params['startKg'], startDate: params['startDate'],
-            });
-            return out(R('定体重目标', 'update', '已定体重目标 ' + r.weightGoal + ' kg' + (r.deadline ? '（截止 ' + r.deadline + '）' : '') + (r.startKg !== null ? ' · 起点 ' + r.startKg + ' kg' : ''), '定体重目标', 'daily_goal (写库回执)', {
-                recordId: 1, ids: [1], idSource: 'singleton',
-                writtenFields: provided(params, ['kg', 'deadline', 'startKg', 'startDate']),
-            }));
-        }
-        case 'calorie.goal.pause': {
-            const r = pauseAllGoals(db);
-            return out(R('暂停所有目标', 'update', '已暂停所有目标（记录照常，仅目标暂停）', '暂停所有目标', 'daily_goal (写库回执)', {
-                recordId: r.id, ids: [r.id], idSource: 'singleton', writtenFields: ['goal_paused'],
-            }));
-        }
-        case 'calorie.goal.resume': {
-            const r = resumeAllGoals(db);
-            return out(R('重启所有目标', 'update', '已重启所有目标（恢复正常）', '重启所有目标', 'daily_goal (写库回执)', {
-                recordId: r.id, ids: [r.id], idSource: 'singleton', writtenFields: ['goal_paused'],
-            }));
-        }
-        case 'calorie.body.composition-add': {
-            const date = optStr(params, 'date') ?? todayISO();
-            assertISO(date, 'date');
-            const source = normSource(params['source']);
-            const input = {
-                date, source, bodyFatPct: params['bodyFatPct'], note: optStr(params, 'note'),
-                age: optInt(params, 'age'), sex: normSex(params['sex']),
-            };
-            for (const f of CALIPER_FIELDS) {
-                const v = optNum(params, f);
-                if (v !== undefined)
-                    input[f] = v;
-            }
-            if (input['bodyFatPct'] === undefined)
-                fail(2, '缺参数 bodyFatPct（皮褶→体脂自动换算未移植，直传实测值）');
-            const r = addComposition(db, input);
-            const label = SOURCE_LABELS[source] ?? source;
-            return out(R('记体脂', 'create', '已记体脂：' + date + ' ' + label + ' ' + r.bodyFatPct + '%', '记体脂', 'body_composition (写库回执)', {
-                recordId: r.id, ids: [r.id], writtenFields: definedKeys(input),
-                items: [{ id: r.id, date, status: '成功', reason: '', detail: r.bodyFatPct + '%' }],
-            }));
-        }
-        case 'calorie.body.composition-remove': {
-            const id = needId(params);
-            deleteComposition(db, id);
-            return out(R('删体脂', 'delete', '已删除体脂记录 #' + id + SOFT_EXCLUDED, '删体脂', 'body_composition (写库回执)', {
-                recordId: id, ids: [id], writtenFields: ['is_deprecated'], items: [{ id, status: deleteStatus('soft'), reason: '' }],
-            }));
-        }
-        case 'calorie.body.measure-add': {
-            const date = optStr(params, 'date') ?? todayISO();
-            assertISO(date, 'date');
-            const input = { date, note: optStr(params, 'note') };
-            for (const [camel, col] of Object.entries(MEASURE_CAMEL)) {
-                const v = optNum(params, camel);
-                if (v !== undefined)
-                    input[col] = v;
-            }
-            for (const k of Object.keys(params)) {
-                if (!(k in MEASURE_CAMEL) && k !== 'date' && k !== 'note' && k !== 'key')
-                    fail(2, '不支持字段: ' + k);
-            }
-            const r = addMeasurement(db, input);
-            const filledCn = r.filled.map((f) => {
-                const camel = Object.keys(MEASURE_CAMEL).find((c) => MEASURE_CAMEL[c] === f) ?? f;
-                return camel + ' ' + String(input[f]);
-            }).join('、');
-            return out(R('记围度', 'create', '已记围度：' + date + '（' + filledCn + '）', '记围度', 'body_measurements (写库回执)', {
-                recordId: r.id, ids: [r.id], writtenFields: measureCliNames(definedKeys(input)),
-                items: [{ id: r.id, date, status: '成功', reason: '', detail: filledCn }],
-            }));
-        }
-        case 'calorie.body.measure-remove': {
-            const id = needId(params);
-            deleteMeasurement(db, id);
-            return out(R('删围度', 'delete', '已删除围度记录 #' + id + SOFT_EXCLUDED, '删围度', 'body_measurements (写库回执)', {
-                recordId: id, ids: [id], writtenFields: ['is_deprecated'], items: [{ id, status: deleteStatus('soft'), reason: '' }],
-            }));
-        }
         default:
             fail(3, '未知 calorie 写键：' + key);
             throw new Error('unreachable');