skill-calorie 0.1.1 → 0.2.1

package/dist/cli/write.js

@@ -9,7 +9,7 @@ import { getNutritionGoal, setNutritionGoal, updateWaterGoal } from '../fetch/nu
 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 } from '../render/receipt.js';
+import { buildCrudReceipt, withM5 } from '../render/receipt.js';
 import { CalorieRenderError } from '../render/errors.js';
 import { shiftISODate, todayISO } from '../analysis/utils.js';
 import { isCalorieWriteKey } from './keys.js';
@@ -72,6 +72,68 @@ function assertISO(v, field) {
 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:68-78` 的两条 SQL 同源：传 `water` 走 6 列 `INSERT OR REPLACE`
+ * （含 `water_goal`），不传则 SQL 里**没有** `water_goal` 列——该列的值只因 REPLACE 落列默认
+ * （`schema.ts:32` `water_goal INTEGER DEFAULT 2000`），**不属本次 SET 的字段**，故不得报 `water`。
+ * 记账列 `updated_at` 无 CLI 参数，按 §3.4 不计入摘要。
+ * 注意：`INSERT OR REPLACE` 连带把 `weight_goal`／`goal_deadline`／`goal_paused`／`start_weight`／
+ * `start_date` 重置为默认/NULL——那是**实际行为缺陷**（红队 D-4），已转 #127；本票只让回执如实
+ * 反映「本次 SET 了哪些列」，**不改写语义**（不做 UPSERT 化）。 */
+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
@@ -166,12 +228,17 @@ function oneExercise(item, i) {
         isBackfill: (g('backfill') ?? g('isBackfill')) === true,
     };
 }
-/** 写分发（唯一出口 cmd_read 内调用；未知键上游已拦，此处再拦一道）。 */
+/** 写分发（唯一出口 cmd_read 内调用；未知键上游已拦，此处再拦一道）。
+ * #97 · M5：`affectedRows` 在此统一注入——写库前后各取一次 SQLite `total_changes()`，
+ * 增量即「影响 N 行」（35 键单一来源，逐键不各自自报）。 */
 export function dispatchWrite(key, params, db) {
     if (!isCalorieWriteKey(key))
         fail(3, '未知 calorie 写键：' + key);
+    const before = totalChanges(db);
     try {
-        return dispatchInner(key, params, db);
+        const res = dispatchInner(key, params, db);
+        const receipt = withM5(res.data.receipt, { affectedRows: totalChanges(db) - before });
+        return { data: { ...res.data, receipt }, html: res.html };
     }
     catch (e) {
         if (e instanceof ValidationError)
@@ -214,11 +281,13 @@ function dispatchInner(key, params, db) {
             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, items: [{ id: r.id ?? undefined, date: r.date, status: '成功', reason: '', detail: r.food_name }],
+                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': {
@@ -243,15 +312,15 @@ function dispatchInner(key, params, db) {
                 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, noChange: r.changed.length === 0,
+                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 + ' 卡）', '删饮食记录', 'food_log (写库回执)', {
-                recordId: id, items: [{ id, status: '已删除', reason: '', detail: r.food_name }],
+            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': {
@@ -271,7 +340,8 @@ function dispatchInner(key, params, db) {
                 };
             }));
             return out(R('批量补记饮食', 'create', '批量记饮食：新增 ' + r.added + '，跳过 ' + r.skipped + '，失败 ' + r.failed, '批量补记饮食', 'food_log (写库回执)', {
-                noChange: r.added === 0,
+                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 + '条' })),
             }));
         }
@@ -285,7 +355,8 @@ function dispatchInner(key, params, db) {
             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,
+                noChange: r.copied === 0, ids: [], idSource: 'condition',
+                writtenFields: r.copied > 0 ? [...F.diet] : [],
             }));
         }
         case 'calorie.diet.update-by-date': {
@@ -305,7 +376,9 @@ function dispatchInner(key, params, db) {
             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 (写库回执)', {}));
+            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');
@@ -313,7 +386,7 @@ function dispatchInner(key, params, db) {
             const r = deleteMealsByDate(db, date);
             if (r.deleted === 0)
                 throw new CalorieRenderError('missing-data', '无饮食记录（' + date + '）');
-            return out(R('删某日饮食', 'delete', '已删除 ' + date + ' 饮食 ' + r.deleted + ' 条', '删某日饮食', 'food_log (写库回执)', {}));
+            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');
@@ -325,7 +398,7 @@ function dispatchInner(key, params, db) {
             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 + ' 条', '批量删饮食', 'food_log (写库回执)', {}));
+            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');
@@ -336,7 +409,7 @@ function dispatchInner(key, params, db) {
             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 + ' 条', '删一餐', 'food_log (写库回执)', {}));
+            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');
@@ -350,12 +423,17 @@ function dispatchInner(key, params, db) {
                 note: optStr(params, 'note'), date, time: optStr(params, 'time'),
             });
             if (r.duplicate) {
-                return out(R('记喝水', 'create', String(r.message ?? '重复记录已跳过'), '记喝水', 'food_log (写库回执)', { noChange: true }));
+                // 与 `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,
+                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' }],
             }));
         }
@@ -369,7 +447,8 @@ function dispatchInner(key, params, db) {
             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, items: [{ id: r.id, date: r.date, status: '成功', reason: '', detail: r.kg + 'kg' }],
+                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': {
@@ -385,13 +464,16 @@ function dispatchInner(key, params, db) {
                 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, items: [{ id, status: '已更新', reason: '' }],
+                    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 (写库回执)', {}));
+                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');
@@ -405,14 +487,14 @@ function dispatchInner(key, params, db) {
                 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）', '删体重记录', 'weight_log (写库回执)', {
-                    recordId: id, items: [{ id, status: '已删除', reason: '' }],
+                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 + ' 条', '删某日体重', 'weight_log (写库回执)', {}));
+                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)
@@ -422,7 +504,7 @@ function dispatchInner(key, params, db) {
                 if (start > end)
                     fail(2, 'start 不得晚于 end');
                 const r = deleteWeightRange(db, start, end);
-                return out(R('批量删体重', 'delete', '已删除 ' + start + '~' + end + ' 体重 ' + r.deletedCount + ' 条', '批量删体重', 'weight_log (写库回执)', {}));
+                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');
@@ -436,7 +518,8 @@ function dispatchInner(key, params, db) {
                 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,
+                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) })),
             }));
         }
@@ -450,7 +533,8 @@ function dispatchInner(key, params, db) {
                 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,
+                    noChange: r.copied === 0, ids: [], idSource: 'condition',
+                    writtenFields: r.copied > 0 ? [...F.exercise] : [],
                 }));
             }
             if (params['items'] !== undefined) {
@@ -459,13 +543,15 @@ function dispatchInner(key, params, db) {
                     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,
+                    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, items: [{ id: r.id, date: input.date, status: '成功', reason: '', detail: input.exerciseType }],
+                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': {
@@ -503,7 +589,8 @@ function dispatchInner(key, params, db) {
                     fail(2, 'id 须为正整数');
                 updateRecord(db, id, fields);
                 return out(R('改运动记录', 'update', '已更新运动 #' + id + '（' + Object.keys(fields).join('、') + '）', '改运动记录', 'exercise_log (写库回执)', {
-                    recordId: id, items: [{ id, status: '已更新', reason: '' }],
+                    recordId: id, ids: [id], writtenFields: cliNames(Object.keys(fields)),
+                    items: [{ id, status: '已更新', reason: '' }],
                 }));
             }
             if (date !== undefined) {
@@ -511,7 +598,9 @@ function dispatchInner(key, params, db) {
                 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 (写库回执)', {}));
+                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');
@@ -525,8 +614,8 @@ function dispatchInner(key, params, db) {
                 if (!Number.isInteger(id) || id <= 0)
                     fail(2, 'id 须为正整数');
                 deleteRecord(db, id);
-                return out(R('删运动记录', 'delete', '已删除运动 #' + id, '删运动记录', 'exercise_log (写库回执)', {
-                    recordId: id, items: [{ id, status: '已删除', reason: '' }],
+                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) {
@@ -534,7 +623,7 @@ function dispatchInner(key, params, db) {
                 const n = deleteDay(db, date);
                 if (n === 0)
                     throw new CalorieRenderError('missing-data', '无运动记录（' + date + '）');
-                return out(R('删某日运动', 'delete', '已删除 ' + date + ' 运动 ' + n + ' 条', '删某日运动', 'exercise_log (写库回执)', {}));
+                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)
@@ -546,7 +635,7 @@ function dispatchInner(key, params, db) {
                 const n = deleteRange(db, from, to);
                 if (n === 0)
                     throw new CalorieRenderError('missing-data', '无运动记录（' + from + '~' + to + '）');
-                return out(R('批量删运动', 'delete', '已删除 ' + from + '~' + to + ' 运动 ' + n + ' 条', '批量删运动', 'exercise_log (写库回执)', {}));
+                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');
@@ -573,7 +662,9 @@ function dispatchInner(key, params, db) {
             catch {
                 distance = null;
             }
-            const receipt = buildAddReceipt(added, { tag, note: optStr(params, 'note'), distance, failedCount: srcPaths.length - added.length || undefined });
+            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': {
@@ -583,7 +674,7 @@ function dispatchInner(key, params, db) {
             if (!snap)
                 throw new CalorieRenderError('missing-data', '身材照 #' + id + ' 不存在');
             deletePhoto(db, dir, id);
-            const receipt = buildDeleteReceipt(snap);
+            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': {
@@ -617,7 +708,7 @@ function dispatchInner(key, params, db) {
                 scene = '删照片标签';
             }
             const after = getPhotoRow(db, id)?.tag_list ?? before;
-            const receipt = buildTagReceipt(id, before, after, scene);
+            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': {
@@ -632,7 +723,8 @@ function dispatchInner(key, params, db) {
                 sodium: needNum(params, 'sodium'), note: optStr(params, 'note'),
             });
             return out(R('存食品', 'create', '已存食品 #' + r.id + '（' + productName.trim() + '）', '存食品', 'nutrition_products (写库回执)', {
-                recordId: r.id, items: [{ id: r.id, status: '成功', reason: '', detail: productName.trim() }],
+                recordId: r.id, ids: [r.id], writtenFields: [...F.product],
+                items: [{ id: r.id, status: '成功', reason: '', detail: productName.trim() }],
             }));
         }
         case 'calorie.product.update': {
@@ -657,7 +749,8 @@ function dispatchInner(key, params, db) {
             if (!r.updated)
                 throw new CalorieRenderError('missing-data', '食品 #' + id + ' 不存在');
             return out(R('改食品', 'update', '已更新食品 #' + id + '（' + Object.keys(fields).join('、') + '）', '改食品', 'nutrition_products (写库回执)', {
-                recordId: id, items: [{ id, status: '已更新', reason: '' }],
+                recordId: id, ids: [id], writtenFields: cliNames(Object.keys(fields)),
+                items: [{ id, status: '已更新', reason: '' }],
             }));
         }
         case 'calorie.product.deprecate': {
@@ -668,8 +761,8 @@ function dispatchInner(key, params, db) {
                     throw new CalorieRenderError('missing-data', '食品 #' + id + ' 不存在');
                 fail(2, String(r.error ?? '废弃失败'));
             }
-            return out(R('下架食品', 'update', '已下架食品 #' + id + '（' + (r.name ?? '') + '，行保留可恢复）', '下架食品', 'nutrition_products (写库回执)', {
-                recordId: id, items: [{ id, status: '已下架', reason: '' }],
+            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':
@@ -702,7 +795,7 @@ function dispatchInner(key, params, db) {
             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, noChange: r.changed.length === 0,
+                recordId: 1, ids: [1], idSource: 'singleton', writtenFields: Object.keys(picked), noChange: r.changed.length === 0,
             }));
         }
         case 'calorie.profile.activity': {
@@ -711,7 +804,7 @@ function dispatchInner(key, params, db) {
                 fail(2, '缺参数 activityLevel');
             const r = setActivityLevel(db, level);
             return out(R('设活动量', 'update', '已设活动量：' + (r.before ?? '—') + '→' + r.after, '设活动量', 'user_profile (写库回执)', {
-                recordId: 1, noChange: r.before === r.after,
+                recordId: 1, ids: [1], idSource: 'singleton', writtenFields: ['activityLevel'], noChange: r.before === r.after,
             }));
         }
         case 'calorie.goal.set': {
@@ -732,7 +825,7 @@ function dispatchInner(key, params, db) {
             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,
+                recordId: 1, ids: [1], idSource: 'singleton', writtenFields: goalSetWrittenFields(water !== undefined),
             }));
         }
         case 'calorie.goal.water': {
@@ -741,7 +834,7 @@ function dispatchInner(key, params, db) {
                 throw new CalorieRenderError('missing-data', '尚无营养目标行（先定营养目标）');
             const r = updateWaterGoal(db, water);
             return out(R('定饮水目标', 'update', '已定饮水目标：' + (r.oldWaterGoal ?? '—') + '→' + r.newWaterGoal + ' ml', '定饮水目标', 'daily_goal (写库回执)', {
-                recordId: 1, noChange: r.oldWaterGoal === r.newWaterGoal,
+                recordId: 1, ids: [1], idSource: 'singleton', writtenFields: ['water'], noChange: r.oldWaterGoal === r.newWaterGoal,
             }));
         }
         case 'calorie.goal.weight': {
@@ -752,19 +845,20 @@ function dispatchInner(key, params, 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,
+                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,
+                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,
+                recordId: r.id, ids: [r.id], idSource: 'singleton', writtenFields: ['goal_paused'],
             }));
         }
         case 'calorie.body.composition-add': {
@@ -785,14 +879,15 @@ function dispatchInner(key, params, db) {
             const r = addComposition(db, input);
             const label = SOURCE_LABELS[source] ?? source;
             return out(R('记体脂', 'create', '已记体脂：' + date + ' ' + label + ' ' + r.bodyFatPct + '%', '记体脂', 'body_composition (写库回执)', {
-                recordId: r.id, items: [{ id: r.id, date, status: '成功', reason: '', detail: r.bodyFatPct + '%' }],
+                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 + '（软删除，可恢复）', '删体脂', 'body_composition (写库回执)', {
-                recordId: id, items: [{ id, status: '已删除', reason: '' }],
+            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': {
@@ -814,14 +909,15 @@ function dispatchInner(key, params, db) {
                 return camel + ' ' + String(input[f]);
             }).join('、');
             return out(R('记围度', 'create', '已记围度：' + date + '（' + filledCn + '）', '记围度', 'body_measurements (写库回执)', {
-                recordId: r.id, items: [{ id: r.id, date, status: '成功', reason: '', detail: filledCn }],
+                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 + '（软删除，可恢复）', '删围度', 'body_measurements (写库回执)', {
-                recordId: id, items: [{ id, status: '已删除', reason: '' }],
+            return out(R('删围度', 'delete', '已删除围度记录 #' + id + SOFT_EXCLUDED, '删围度', 'body_measurements (写库回执)', {
+                recordId: id, ids: [id], writtenFields: ['is_deprecated'], items: [{ id, status: deleteStatus('soft'), reason: '' }],
             }));
         }
         default: