skill-chef 0.3.2 → 0.3.13

package/dist/history/routes.js

@@ -1,49 +1,55 @@
 /** 历史能力的路由声明（唤醒词命中哪条命令，声明面唯一一处）。
  *
- * 六行对应 `src/policy/wakewords.ts` 里历史六句唤醒词：记录做菜／补录做菜／改评分
- * 进 `chef.history.record`，查看历史／查看统计／体检进 `chef.history.query`。
- * `order` 沿用唤醒词表里的相对顺序（31–36），只保证本文件内有序；全表级顺序
- * 由整包落位票统一到场景表，本票不另立顺序。
- * 命令行写法照 `packages/skill-chef/SKILL.md` 同命令示例：需菜名的带菜名，
- * 查统计与体检带 `kind`（空库可跑的那一行）。
+ * 七行对应 `src/policy/wakewords.ts` 里归历史的七句唤醒词：记录做菜／补录做菜／改评分
+ * 进 `chef.history.record`，查看历史／查看统计／体检／备份进 `chef.history.query`。
+ * `order` 取唤醒词表 1-based 下标（32–37），与全表同序；表序是唯一顺序事实源，本文件不另立顺序。
+ * 命令行写法照本表各条的槽位示例：需菜名的带菜名，查统计／体检／备份带 `kind`（空库可跑的那一行）。
  */
 /** 历史能力的路由声明表：恰好导出一个声明数组。 */
 export const HISTORY_ROUTES = [
     {
-        order: 31,
+        order: 32,
         wakeWord: '记录做菜',
         key: 'chef.history.record',
-        cli: 'chef-cmd-read chef.history.record --params \'{"name":"宫保虾球"}\'',
+        cli: 'chef-cmd-read chef.history.record --params \'{"name":"辣椒炒肉"}\'',
     },
     {
-        order: 32,
+        order: 33,
         wakeWord: '补录做菜',
         key: 'chef.history.record',
-        cli: 'chef-cmd-read chef.history.record --params \'{"name":"宫保虾球"}\'',
+        cli: 'chef-cmd-read chef.history.record --params \'{"name":"辣椒炒肉"}\'',
     },
     {
-        order: 33,
+        order: 34,
         wakeWord: '改评分',
         key: 'chef.history.record',
-        cli: 'chef-cmd-read chef.history.record --params \'{"name":"宫保虾球"}\'',
+        cli: 'chef-cmd-read chef.history.record --params \'{"name":"辣椒炒肉"}\'',
     },
     {
-        order: 34,
+        order: 35,
         wakeWord: '查看历史',
         key: 'chef.history.query',
-        cli: 'chef-cmd-read chef.history.query --params \'{"name":"宫保虾球"}\'',
+        cli: 'chef-cmd-read chef.history.query --params \'{"name":"辣椒炒肉"}\'',
     },
     {
-        order: 35,
+        order: 36,
         wakeWord: '查看统计',
         key: 'chef.history.query',
         cli: 'chef-cmd-read chef.history.query --params \'{"kind":"stats"}\'',
     },
     {
-        order: 36,
+        order: 37,
         wakeWord: '体检',
         key: 'chef.history.query',
         cli: 'chef-cmd-read chef.history.query --params \'{"kind":"quality"}\'',
     },
+    {
+        // #841 追加：`备份`沿用本命令 `kind: 'backup'`（页面装配住数据管理域，事实是本技能的查询语义；
+        // 故这条只在本域声明一处，`src/data/routes.ts` 不再重复一行——一份事实一个落点）。
+        order: 50,
+        wakeWord: '备份',
+        key: 'chef.history.query',
+        cli: 'chef-cmd-read chef.history.query --params \'{"kind":"backup"}\'',
+    },
 ];
 //# sourceMappingURL=routes.js.map

package/dist/history/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/history/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,cAAc,GAAgC;IACzD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,qBAAqB;QAC1B,GAAG,EAAE,gEAAgE;KACtE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,qBAAqB;QAC1B,GAAG,EAAE,gEAAgE;KACtE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,KAAK;QACf,GAAG,EAAE,qBAAqB;QAC1B,GAAG,EAAE,gEAAgE;KACtE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,+DAA+D;KACrE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,gEAAgE;KACtE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,kEAAkE;KACxE;CACF,CAAC"}
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/history/routes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,cAAc,GAAgC;IACzD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,qBAAqB;QAC1B,GAAG,EAAE,gEAAgE;KACtE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,qBAAqB;QAC1B,GAAG,EAAE,gEAAgE;KACtE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,KAAK;QACf,GAAG,EAAE,qBAAqB;QAC1B,GAAG,EAAE,gEAAgE;KACtE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,+DAA+D;KACrE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,gEAAgE;KACtE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,kEAAkE;KACxE;IACD;QACE,6DAA6D;QAC7D,sDAAsD;QACtD,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,iEAAiE;KACvE;CACF,CAAC"}

package/dist/history/run-query.d.ts

@@ -4,10 +4,58 @@
  * 只改 import 出处，判定与装配一字不动。quality／backup 两路住数据管理域
  * （`src/data/run-query.ts`）；kind 路由由入口注册表做（非法 kind 入口已拦，落不到这里）。
  * `toHistoryItem`（原 `src/render/views.ts`）只被本域调用，随行搬入；旧址改转出（搬迁债务）。
+ *
+ * 本票新增（仍本域独占，不碰 `src/fetch/db.ts`）：
+ *   · 时间线按 `cook_date` 倒序（老件 `history_manager.py list` 的 `ORDER BY cook_date DESC`；
+ *     同日按 `cook_sequence` 倒序）；
+ *   · 单菜统计全指标（老件 `stats`：总次数／均分／最高／最低／最近日期）；
+ *   · 全局画像（老件 `global_stats` 单查询口径：做过几道／总次数／最爱均分最高与做得最多／
+ *     最近 5／没做过；本票定案：歧义已与老件对账消除，不另立裁定票）。
  */
 import type { ChefDb, HistoryRow } from '../fetch/db.js';
 /** 历史行＋菜名拼条目。原 `src/render/views.ts`，本域独占。 */
 export declare function toHistoryItem(h: HistoryRow, recipeName?: string): Record<string, unknown>;
+/** 单菜统计全指标（老件 `stats` 口径：总次数／均分／最高／最低／最近日期；无记录则后四项为 null）。 */
+export interface HistorySingleStats {
+    readonly count: number;
+    readonly avgRating: number | null;
+    readonly maxRating: number | null;
+    readonly minRating: number | null;
+    readonly lastDate: string | null;
+}
+/** 取一道菜的统计全指标（单 SQL 聚合，与老件 `stats` 同口径）。 */
+export declare function historySingleStats(handle: ChefDb, recipeId: string): HistorySingleStats;
+/** 全局画像（老件 `global_stats` 画像版口径：做过几道／总次数／菜总数／最爱两项／最近 5／没做过）。 */
+export interface HistoryGlobalPortrait {
+    readonly cookedCount: number;
+    readonly neverCookedCount: number;
+    readonly totalCooks: number;
+    readonly recipeTotal: number;
+    readonly favoriteAvg: {
+        name: string;
+        avgRating: number;
+        times: number;
+    } | null;
+    readonly favoriteMost: {
+        name: string;
+        times: number;
+        avgRating: number | null;
+    } | null;
+    readonly recent: ReadonlyArray<{
+        name: string;
+        lastDate: string;
+        avgRating: number | null;
+    }>;
+    readonly neverCooked: ReadonlyArray<string>;
+    readonly perRecipe: ReadonlyArray<{
+        id: string;
+        name: string;
+        count: number;
+        avgRating: number | null;
+    }>;
+}
+/** 取全局画像（单查询聚合 `recipes` 全表＋`recipe_history`，与老件 `global-stats` 同口径）。 */
+export declare function historyGlobalPortrait(handle: ChefDb): HistoryGlobalPortrait;
 /** 跑 `chef.history.query` 的 timeline／stats：`kind` 由入口注册表算好下传，本函数只做本域两路分支。 */
 export declare function runHistoryQuery(handle: ChefDb, params: Record<string, unknown>, kind: string): unknown;
 //# sourceMappingURL=run-query.d.ts.map

package/dist/history/run-query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-query.d.ts","sourceRoot":"","sources":["../../src/history/run-query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAMzD,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzF;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAuBtG"}
+{"version":3,"file":"run-query.d.ts","sourceRoot":"","sources":["../../src/history/run-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAMzD,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzF;AAED,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,4CAA4C;AAC5C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAgBvF;AAWD,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChF,QAAQ,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACxF,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC7F,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC1G;AAED,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAkD3E;AAQD,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAiCtG"}

package/dist/history/run-query.js

@@ -4,8 +4,15 @@
  * 只改 import 出处，判定与装配一字不动。quality／backup 两路住数据管理域
  * （`src/data/run-query.ts`）；kind 路由由入口注册表做（非法 kind 入口已拦，落不到这里）。
  * `toHistoryItem`（原 `src/render/views.ts`）只被本域调用，随行搬入；旧址改转出（搬迁债务）。
+ *
+ * 本票新增（仍本域独占，不碰 `src/fetch/db.ts`）：
+ *   · 时间线按 `cook_date` 倒序（老件 `history_manager.py list` 的 `ORDER BY cook_date DESC`；
+ *     同日按 `cook_sequence` 倒序）；
+ *   · 单菜统计全指标（老件 `stats`：总次数／均分／最高／最低／最近日期）；
+ *   · 全局画像（老件 `global_stats` 单查询口径：做过几道／总次数／最爱均分最高与做得最多／
+ *     最近 5／没做过；本票定案：歧义已与老件对账消除，不另立裁定票）。
  */
-import { getRecipeDetail, historyStats, listRecipes, queryHistory } from '../fetch/db.js';
+import { getRecipeDetail, mustRecipe, qAll, qGet, queryHistory } from '../fetch/db.js';
 import { ChefPolicyError } from '../fetch/errors.js';
 import { buildHistoryQuery } from '../render/index.js';
 import { needName } from '../policy/index.js';
@@ -16,27 +23,106 @@ export function toHistoryItem(h, recipeName) {
         out.recipe_name = recipeName;
     return out;
 }
+/** 取一道菜的统计全指标（单 SQL 聚合，与老件 `stats` 同口径）。 */
+export function historySingleStats(handle, recipeId) {
+    const recipe = mustRecipe(handle, recipeId);
+    const row = qGet(handle, 'SELECT COUNT(*) AS c, AVG(rating) AS a, MAX(rating) AS hi, MIN(rating) AS lo, MAX(cook_date) AS last FROM recipe_history WHERE recipe_id = ?', [recipe.id]);
+    const numOrNull = (v) => v === null || v === undefined ? null : Number(v);
+    return {
+        count: Number(row?.c ?? 0),
+        avgRating: numOrNull(row?.a),
+        maxRating: numOrNull(row?.hi),
+        minRating: numOrNull(row?.lo),
+        lastDate: row?.last ?? null,
+    };
+}
+/** 取全局画像（单查询聚合 `recipes` 全表＋`recipe_history`，与老件 `global-stats` 同口径）。 */
+export function historyGlobalPortrait(handle) {
+    const rows = qAll(handle, 'SELECT r.id AS recipe_id, r.name AS recipe_name, COUNT(h.id) AS cook_count, AVG(h.rating) AS avg_rating, MAX(h.cook_date) AS last_date ' +
+        'FROM recipes r LEFT JOIN recipe_history h ON h.recipe_id = r.id GROUP BY r.id ORDER BY r.name ASC');
+    const cooked = [];
+    const neverCooked = [];
+    for (const r of rows) {
+        const count = Number(r.cook_count ?? 0);
+        if (count > 0) {
+            cooked.push({
+                recipeId: String(r.recipe_id),
+                recipeName: String(r.recipe_name),
+                cookCount: count,
+                avgRating: r.avg_rating === null || r.avg_rating === undefined ? null : Number(r.avg_rating),
+                lastDate: r.last_date ?? null,
+            });
+        }
+        else {
+            neverCooked.push(String(r.recipe_name));
+        }
+    }
+    const round2 = (v) => Math.round(v * 100) / 100;
+    const totalCooks = cooked.reduce((s, r) => s + r.cookCount, 0);
+    const rated = cooked.filter((r) => r.avgRating !== null);
+    const topAvg = rated.length ? rated.reduce((a, b) => b.avgRating > a.avgRating ? b : a) : null;
+    const topMost = cooked.length ? cooked.reduce((a, b) => (b.cookCount > a.cookCount ? b : a)) : null;
+    const recent = [...cooked]
+        .sort((a, b) => String(b.lastDate ?? '').localeCompare(String(a.lastDate ?? '')))
+        .slice(0, 5)
+        .map((r) => ({ name: r.recipeName, lastDate: r.lastDate, avgRating: r.avgRating === null ? null : round2(r.avgRating) }));
+    return {
+        cookedCount: cooked.length,
+        neverCookedCount: neverCooked.length,
+        totalCooks,
+        recipeTotal: rows.length,
+        favoriteAvg: topAvg
+            ? { name: topAvg.recipeName, avgRating: round2(topAvg.avgRating), times: topAvg.cookCount }
+            : null,
+        favoriteMost: topMost
+            ? {
+                name: topMost.recipeName,
+                times: topMost.cookCount,
+                avgRating: topMost.avgRating === null ? null : round2(topMost.avgRating),
+            }
+            : null,
+        recent,
+        neverCooked: [...neverCooked].sort((a, b) => (a < b ? -1 : a > b ? 1 : 0)),
+        perRecipe: cooked.map((r) => ({ id: r.recipeId, name: r.recipeName, count: r.cookCount, avgRating: r.avgRating })),
+    };
+}
+/** 按时间倒序排历史行（`cook_date` 倒序，同日按 `cook_sequence` 倒序；老件 timeline 口径）。 */
+function byTimeDesc(a, b) {
+    if (a.cook_date !== b.cook_date)
+        return a.cook_date < b.cook_date ? 1 : -1;
+    return b.cook_sequence - a.cook_sequence;
+}
 /** 跑 `chef.history.query` 的 timeline／stats：`kind` 由入口注册表算好下传，本函数只做本域两路分支。 */
 export function runHistoryQuery(handle, params, kind) {
     if (kind === 'timeline') {
         const name = needName(params);
         const detail = getRecipeDetail(handle, name);
-        const rows = queryHistory(handle, detail.recipe.id);
+        const rows = queryHistory(handle, detail.recipe.id).sort(byTimeDesc);
         return buildHistoryQuery('timeline:' + detail.recipe.name, rows.map((h) => toHistoryItem(h, detail.recipe.name)));
     }
     if (kind === 'stats') {
         const name = params.name;
         if (typeof name === 'string' && name.trim()) {
             const detail = getRecipeDetail(handle, name.trim());
-            const st = historyStats(handle, detail.recipe.id);
-            return buildHistoryQuery('stats:' + detail.recipe.name, [{ name: detail.recipe.name, count: st.count, avgRating: st.avgRating }]);
+            const st = historySingleStats(handle, detail.recipe.id);
+            return buildHistoryQuery('stats:' + detail.recipe.name, [
+                { name: detail.recipe.name, count: st.count, avgRating: st.avgRating, maxRating: st.maxRating, minRating: st.minRating, lastDate: st.lastDate },
+            ]);
         }
-        const recipes = listRecipes(handle);
-        const items = recipes.map((r) => {
-            const st = historyStats(handle, r.id);
-            return { id: r.id, name: r.name, count: st.count, avgRating: st.avgRating };
-        });
-        return buildHistoryQuery('stats:all', items);
+        const portrait = historyGlobalPortrait(handle);
+        return buildHistoryQuery('stats:all', [
+            {
+                cookedCount: portrait.cookedCount,
+                neverCookedCount: portrait.neverCookedCount,
+                totalCooks: portrait.totalCooks,
+                recipeTotal: portrait.recipeTotal,
+                favoriteAvg: portrait.favoriteAvg,
+                favoriteMost: portrait.favoriteMost,
+                recent: portrait.recent,
+                neverCooked: portrait.neverCooked,
+                perRecipe: portrait.perRecipe,
+            },
+        ]);
     }
     // 不可达：入口注册表已拦过非法 kind（原文分支尾 fail(2) 同报文，归用法错 exit 2）。
     throw new ChefPolicyError('POLICY_BAD_INPUT', 'history.query 只接受 kind=timeline/stats/quality/backup');

package/dist/history/run-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-query.js","sourceRoot":"","sources":["../../src/history/run-query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,8CAA8C;AAC9C,MAAM,UAAU,aAAa,CAAC,CAAa,EAAE,UAAmB;IAC9D,MAAM,GAAG,GAA4B,EAAE,GAAG,CAAC,EAAE,CAAC;IAC9C,IAAI,UAAU,KAAK,SAAS;QAAE,GAAG,CAAC,WAAW,GAAG,UAAU,CAAC;IAC3D,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,MAA+B,EAAE,IAAY;IAC3F,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpD,OAAO,iBAAiB,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpH,CAAC;IACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACpD,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAClD,OAAO,iBAAiB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACpI,CAAC;QACD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC9B,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACtC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC;QAC9E,CAAC,CAAC,CAAC;QACH,OAAO,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,sDAAsD;IACtD,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,sDAAsD,CAAC,CAAC;AACxG,CAAC"}
+{"version":3,"file":"run-query.js","sourceRoot":"","sources":["../../src/history/run-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,8CAA8C;AAC9C,MAAM,UAAU,aAAa,CAAC,CAAa,EAAE,UAAmB;IAC9D,MAAM,GAAG,GAA4B,EAAE,GAAG,CAAC,EAAE,CAAC;IAC9C,IAAI,UAAU,KAAK,SAAS;QAAE,GAAG,CAAC,WAAW,GAAG,UAAU,CAAC;IAC3D,OAAO,GAAG,CAAC;AACb,CAAC;AAWD,4CAA4C;AAC5C,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,QAAgB;IACjE,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,CACd,MAAM,EACN,8IAA8I,EAC9I,CAAC,MAAM,CAAC,EAAE,CAAC,CACZ,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,CAA4B,EAAiB,EAAE,CAChE,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACnD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC1B,SAAS,EAAE,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5B,SAAS,EAAE,SAAS,CAAC,GAAG,EAAE,EAAE,CAAC;QAC7B,SAAS,EAAE,SAAS,CAAC,GAAG,EAAE,EAAE,CAAC;QAC7B,QAAQ,EAAE,GAAG,EAAE,IAAI,IAAI,IAAI;KAC5B,CAAC;AACJ,CAAC;AAwBD,yEAAyE;AACzE,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,MAAM,IAAI,GAAG,IAAI,CACf,MAAM,EACN,yIAAyI;QACvI,mGAAmG,CACtG,CAAC;IACF,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;QACxC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC7B,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;gBACjC,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,CAAC,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;gBAC5F,QAAQ,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;aAC9B,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAChE,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAC,CAAC,SAAoB,GAAI,CAAC,CAAC,SAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvH,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpG,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC;SACvB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;SAChF,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAkB,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IACtI,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,MAAM;QAC1B,gBAAgB,EAAE,WAAW,CAAC,MAAM;QACpC,UAAU;QACV,WAAW,EAAE,IAAI,CAAC,MAAM;QACxB,WAAW,EAAE,MAAM;YACjB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAmB,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE;YACrG,CAAC,CAAC,IAAI;QACR,YAAY,EAAE,OAAO;YACnB,CAAC,CAAC;gBACE,IAAI,EAAE,OAAO,CAAC,UAAU;gBACxB,KAAK,EAAE,OAAO,CAAC,SAAS;gBACxB,SAAS,EAAE,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;aACzE;YACH,CAAC,CAAC,IAAI;QACR,MAAM;QACN,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;KACnH,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,SAAS,UAAU,CAAC,CAAa,EAAE,CAAa;IAC9C,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS;QAAE,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,OAAO,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC;AAC3C,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,MAA+B,EAAE,IAAY;IAC3F,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrE,OAAO,iBAAiB,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpH,CAAC;IACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACpD,MAAM,EAAE,GAAG,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxD,OAAO,iBAAiB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;gBACtD,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE;aAChJ,CAAC,CAAC;QACL,CAAC;QACD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,iBAAiB,CAAC,WAAW,EAAE;YACpC;gBACE,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;gBAC3C,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,YAAY,EAAE,QAAQ,CAAC,YAAY;gBACnC,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,SAAS,EAAE,QAAQ,CAAC,SAAS;aAC9B;SACF,CAAC,CAAC;IACL,CAAC;IACD,sDAAsD;IACtD,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,sDAAsD,CAAC,CAAC;AACxG,CAAC"}

package/dist/history/run-record.d.ts

@@ -5,7 +5,11 @@
  * 只被本域调用，按“写不出的留回域目录”搬入本文件；旧址改转出（搬迁债务，见对应 index）。
  */
 import type { ChefDb, HistoryRow } from '../fetch/db.js';
-/** 记一次做菜（评分必填：老库 rating NOT NULL，缺评分直接拦）。原 `src/fetch/db.ts`，本域独占。 */
+/** 记一次做菜（评分必填＋反馈必填禁占位：老库 rating NOT NULL，缺值直接拦）。原 `src/fetch/db.ts`，本域独占。
+ *
+ * 反馈口径见 `./validate.ts`（老仓 `scenes/历史.yaml:56`：必填真实内容、禁「无」占位）。
+ * 日期缺省今天（同 `./validate.ts` 的 `validateCookDate`，本文件不再自备 today）。
+ */
 export declare function recordHistory(h: ChefDb, input: {
     recipe_id: string;
     rating?: number | null;
@@ -16,6 +20,12 @@ export declare function buildHistoryRecord(message: string): {
     ok: boolean;
     message: string;
 };
-/** 跑 `chef.history.record`：定位母菜＋评分校验＋落历史（receipt 形）。 */
+/** 跑 `chef.history.record`：定位母菜＋评分校验＋反馈校验＋落历史（receipt 形）。
+ *
+ * 参数：`name` 必填；`rating` 0-5 数字（818 定案甲：缺评分不写历史，取数层抛
+ * `CHEF_BAD_QUERY` 即 CLI exit 4）；`feedback` 必填真实内容禁占位（口径错 exit 2）；
+ * 补录日期 `date`（`cook_date` 作兼容别名，老件 `--cook_date` 同名），缺省今天。
+ * 「改评分」唤醒词走同一条记录路径（路由见 `./routes.ts:33-38`）：记一次新的做菜记录。
+ */
 export declare function runHistoryRecord(handle: ChefDb, params: Record<string, unknown>): unknown;
 //# sourceMappingURL=run-record.d.ts.map

package/dist/history/run-record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-record.d.ts","sourceRoot":"","sources":["../../src/history/run-record.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AASzD,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CA4BhJ;AAGD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAEpF;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAYzF"}
+{"version":3,"file":"run-record.d.ts","sourceRoot":"","sources":["../../src/history/run-record.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKzD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CA8BhJ;AAGD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAEpF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAiBzF"}

package/dist/history/run-record.js

@@ -8,11 +8,12 @@ import { randomUUID } from 'node:crypto';
 import { ChefFetchError } from '../fetch/errors.js';
 import { getRecipeDetail, mustRecipe, now, qGet, qRun, toHistory } from '../fetch/db.js';
 import { needName, validateRating } from '../policy/index.js';
-/** 当日日期（本域独占：落历史默认 cook_date 与补录默认 date；原 db.ts `today()`，随 recordHistory 搬入）。 */
-function today() {
-    return new Date().toISOString().slice(0, 10);
-}
-/** 记一次做菜（评分必填：老库 rating NOT NULL，缺评分直接拦）。原 `src/fetch/db.ts`，本域独占。 */
+import { validateCookDate, validateFeedback } from './validate.js';
+/** 记一次做菜（评分必填＋反馈必填禁占位：老库 rating NOT NULL，缺值直接拦）。原 `src/fetch/db.ts`，本域独占。
+ *
+ * 反馈口径见 `./validate.ts`（老仓 `scenes/历史.yaml:56`：必填真实内容、禁「无」占位）。
+ * 日期缺省今天（同 `./validate.ts` 的 `validateCookDate`，本文件不再自备 today）。
+ */
 export function recordHistory(h, input) {
     const rid = typeof input?.recipe_id === 'string' ? input.recipe_id.trim() : '';
     if (!rid)
@@ -24,19 +25,21 @@ export function recordHistory(h, input) {
     if (rawRt === undefined || rawRt === null || rawRt === '')
         throw new ChefFetchError('CHEF_BAD_QUERY', '记录做菜须给评分 rating（0-5 数字；老库 NOT NULL，未评分请先问用户要分）');
     {
-        const n = typeof rawRt === 'string' ? Number(String(rawRt).trim()) : rawRt;
+        // 空串／纯空白同样按「没给」处理（与 `recordHistory` 同口径：一份缺值只认一个定义地）。
+        const n = typeof rawRt === 'string' ? (rawRt.trim() === '' ? rawRt : Number(rawRt.trim())) : rawRt;
         if (typeof n !== 'number' || !Number.isFinite(n))
-            throw new ChefFetchError('CHEF_HISTORY_CORRUPT', '评分须为数字');
+            throw new ChefFetchError('CHEF_BAD_QUERY', '记录做菜须给评分 rating（0-5 数字；老库 NOT NULL，未评分请先问用户要分）');
         if (n < 0 || n > 5)
             throw new ChefFetchError('CHEF_HISTORY_CORRUPT', '评分须在 0-5 内');
         rating = n;
     }
-    const cookDate = typeof input.cook_date === 'string' && input.cook_date.trim() ? input.cook_date.trim() : today();
+    const cookDate = validateCookDate(input.cook_date);
+    const feedback = validateFeedback(input.feedback);
     const maxRow = qGet(h, 'SELECT MAX(cook_sequence) AS m FROM recipe_history WHERE recipe_id = ?', [recipe.id]);
     const seq = (maxRow?.m ?? 0) + 1;
     const id = randomUUID();
     try {
-        qRun(h, 'INSERT INTO recipe_history (id, recipe_id, cook_date, cook_sequence, rating, feedback) VALUES (?, ?, ?, ?, ?, ?)', [id, recipe.id, cookDate, seq, rating, input.feedback ?? '']);
+        qRun(h, 'INSERT INTO recipe_history (id, recipe_id, cook_date, cook_sequence, rating, feedback) VALUES (?, ?, ?, ?, ?, ?)', [id, recipe.id, cookDate, seq, rating, feedback]);
         if (recipe.status === '未做')
             qRun(h, 'UPDATE recipes SET status = ?, updated_at = ? WHERE id = ?', ['已做', now(), recipe.id]);
     }
@@ -54,17 +57,28 @@ export function recordHistory(h, input) {
 export function buildHistoryRecord(message) {
     return { ok: true, message };
 }
-/** 跑 `chef.history.record`：定位母菜＋评分校验＋落历史（receipt 形）。 */
+/** 跑 `chef.history.record`：定位母菜＋评分校验＋反馈校验＋落历史（receipt 形）。
+ *
+ * 参数：`name` 必填；`rating` 0-5 数字（818 定案甲：缺评分不写历史，取数层抛
+ * `CHEF_BAD_QUERY` 即 CLI exit 4）；`feedback` 必填真实内容禁占位（口径错 exit 2）；
+ * 补录日期 `date`（`cook_date` 作兼容别名，老件 `--cook_date` 同名），缺省今天。
+ * 「改评分」唤醒词走同一条记录路径（路由见 `./routes.ts:33-38`）：记一次新的做菜记录。
+ */
 export function runHistoryRecord(handle, params) {
     const name = needName(params);
     const detail = getRecipeDetail(handle, name);
     let rating = null;
     if (params.rating !== undefined) {
-        const raw = typeof params.rating === 'string' && params.rating.trim() !== '' ? Number(params.rating.trim()) : params.rating;
-        rating = validateRating(raw);
+        const raw = params.rating;
+        // 空串／纯空白＝「用户啥也没填」，与「键不传」同义（#853 契约：缺评分 → 取数失败档 4 且点名 rating）。
+        // 不这么归一，`rating: ''` 会先撞口径校验（`validateRating` 只认数字 ⇒ exit 2「缺槽位」），
+        // 同一个场景因「空串 vs 不传」分叉成两种错误档——同一件事两个定义地。
+        const blank = typeof raw === 'string' && raw.trim() === '';
+        rating = blank ? null : validateRating(typeof raw === 'string' ? Number(raw.trim()) : raw);
     }
-    const feedback = params.feedback === undefined ? '' : String(params.feedback);
-    const cookDate = params.date === undefined || params.date === '' ? today() : String(params.date);
+    const feedback = validateFeedback(params.feedback);
+    const dateRaw = params.date === undefined ? params.cook_date : params.date;
+    const cookDate = validateCookDate(dateRaw);
     const h = recordHistory(handle, { recipe_id: detail.recipe.id, rating, feedback, cook_date: cookDate });
     return buildHistoryRecord('已记录做菜：' + detail.recipe.name + '（' + h.cook_date + (rating !== null ? '，评分 ' + rating : '') + '）');
 }

package/dist/history/run-record.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-record.js","sourceRoot":"","sources":["../../src/history/run-record.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-record.js","sourceRoot":"","sources":["../../src/history/run-record.ts"],"names":[],"mappings":"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"}

package/dist/history/validate.d.ts

@@ -0,0 +1,22 @@
+/** 历史域独占的写参校验（反馈必填禁占位＋补录日期）。
+ *
+ * 本域独占：只有 `chef.history.record` 一条写路径在用（`run-record.ts` 的
+ * 入口校验与落库门）。第二个用法出现前不进共用位（结构标准：共用位从
+ * 第二个用法里长出来）。
+ *
+ * 口径出处：
+ *   · 反馈必填真实内容、禁「无」占位：老仓 `scenes/历史.yaml:56`
+ *    （`feedback: 一句话反馈(必填真实内容,禁「无」占位)`）＋ 本票验收
+ *     反例（`feedback` 为「无」必须拦下并 exit≠0）。
+ *   · 占位词表：老件 `scripts/validators.py` 的 `PLACEHOLDER_STRINGS`
+ *     13 种 ＋ 本域加 1 种「无」（精确匹配，不做子串判断——
+ *     「无敌好吃」这类真反馈必须放行）。
+ *   · 日期：老件 `history_manager.py add` 的 `--cook_date`（`YYYY-MM-DD`，
+ *     缺省今天）；新命令面收 `date`（见本域 `routes.ts` 与 `SKILL.md`），
+ *     `cook_date` 作兼容别名由调用方归一后传入。
+ */
+/** 校验一条做菜反馈：非空真实内容、禁占位词。非法一律抛口径错（CLI exit 2）。 */
+export declare function validateFeedback(raw: unknown): string;
+/** 校验补录日期：`YYYY-MM-DD` 真日期；缺省（`undefined`／空串）即今天。 */
+export declare function validateCookDate(raw: unknown): string;
+//# sourceMappingURL=validate.d.ts.map

package/dist/history/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/history/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAuBH,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CASrD;AAOD,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAgBrD"}

package/dist/history/validate.js

@@ -0,0 +1,69 @@
+/** 历史域独占的写参校验（反馈必填禁占位＋补录日期）。
+ *
+ * 本域独占：只有 `chef.history.record` 一条写路径在用（`run-record.ts` 的
+ * 入口校验与落库门）。第二个用法出现前不进共用位（结构标准：共用位从
+ * 第二个用法里长出来）。
+ *
+ * 口径出处：
+ *   · 反馈必填真实内容、禁「无」占位：老仓 `scenes/历史.yaml:56`
+ *    （`feedback: 一句话反馈(必填真实内容,禁「无」占位)`）＋ 本票验收
+ *     反例（`feedback` 为「无」必须拦下并 exit≠0）。
+ *   · 占位词表：老件 `scripts/validators.py` 的 `PLACEHOLDER_STRINGS`
+ *     13 种 ＋ 本域加 1 种「无」（精确匹配，不做子串判断——
+ *     「无敌好吃」这类真反馈必须放行）。
+ *   · 日期：老件 `history_manager.py add` 的 `--cook_date`（`YYYY-MM-DD`，
+ *     缺省今天）；新命令面收 `date`（见本域 `routes.ts` 与 `SKILL.md`），
+ *     `cook_date` 作兼容别名由调用方归一后传入。
+ */
+import { ChefPolicyError } from '../fetch/errors.js';
+/** 反馈占位词（精确匹配，调用方先去首尾空白）：老件 13 种 ＋ 本域「无」系 3 种。 */
+const FEEDBACK_PLACEHOLDERS = [
+    '未知',
+    '未提供',
+    '不详',
+    '未填',
+    'n/a',
+    'N/A',
+    'null',
+    'None',
+    '暂时不知道',
+    '不知道',
+    '我没数据',
+    '-',
+    '无',
+    '无反馈',
+    '(无反馈)',
+];
+/** 校验一条做菜反馈：非空真实内容、禁占位词。非法一律抛口径错（CLI exit 2）。 */
+export function validateFeedback(raw) {
+    if (typeof raw !== 'string' || !raw.trim()) {
+        throw new ChefPolicyError('POLICY_BAD_INPUT', '记录做菜须给反馈 feedback（一句话真实反馈，禁「无」占位）');
+    }
+    const text = raw.trim();
+    if (FEEDBACK_PLACEHOLDERS.includes(text)) {
+        throw new ChefPolicyError('POLICY_BAD_INPUT', '反馈须填真实内容，「' + text + '」是占位词（请向用户要一句真实反馈后重试）');
+    }
+    return text;
+}
+/** 当日日期（`YYYY-MM-DD`）：本域落历史默认 cook_date 的唯一定义地。 */
+function todayStr() {
+    return new Date().toISOString().slice(0, 10);
+}
+/** 校验补录日期：`YYYY-MM-DD` 真日期；缺省（`undefined`／空串）即今天。 */
+export function validateCookDate(raw) {
+    if (raw === undefined || raw === null || (typeof raw === 'string' && !raw.trim()))
+        return todayStr();
+    if (typeof raw !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(raw.trim())) {
+        throw new ChefPolicyError('POLICY_BAD_INPUT', '补录日期须为 YYYY-MM-DD（实际 ' + JSON.stringify(raw) + '）');
+    }
+    const text = raw.trim();
+    const dt = new Date(text + 'T00:00:00Z');
+    if (Number.isNaN(dt.getTime()) ||
+        dt.getUTCFullYear() !== Number(text.slice(0, 4)) ||
+        dt.getUTCMonth() + 1 !== Number(text.slice(5, 7)) ||
+        dt.getUTCDate() !== Number(text.slice(8, 10))) {
+        throw new ChefPolicyError('POLICY_BAD_INPUT', '补录日期不是真日期（实际 ' + text + '）');
+    }
+    return text;
+}
+//# sourceMappingURL=validate.js.map

package/dist/history/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/history/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,kDAAkD;AAClD,MAAM,qBAAqB,GAAsB;IAC/C,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,MAAM;IACN,GAAG;IACH,GAAG;IACH,KAAK;IACL,OAAO;CACR,CAAC;AAEF,iDAAiD;AACjD,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,mCAAmC,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACxB,IAAK,qBAA2C,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,YAAY,GAAG,IAAI,GAAG,uBAAuB,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mDAAmD;AACnD,SAAS,QAAQ;IACf,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAAE,OAAO,QAAQ,EAAE,CAAC;IACrG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,uBAAuB,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACxB,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;IACzC,IACE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;QAC1B,EAAE,CAAC,cAAc,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjD,EAAE,CAAC,UAAU,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAC7C,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,eAAe,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/policy/wakewords.d.ts

@@ -1,4 +1,4 @@
-export type ChefKey = 'chef.recipe.view' | 'chef.recipe.search' | 'chef.recipe.write' | 'chef.cooking.run' | 'chef.shopping.query' | 'chef.history.record' | 'chef.history.query' | 'chef.help.lookup';
+export type ChefKey = 'chef.recipe.view' | 'chef.recipe.search' | 'chef.recipe.write' | 'chef.cooking.run' | 'chef.shopping.query' | 'chef.history.record' | 'chef.history.query' | 'chef.help.lookup' | 'chef.relation.write' | 'chef.relation.query' | 'chef.setup.init' | 'chef.data.batch';
 export interface WakeRoute {
     key: ChefKey;
     params: Record<string, unknown>;

package/dist/policy/wakewords.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wakewords.d.ts","sourceRoot":"","sources":["../../src/policy/wakewords.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,OAAO,GACf,kBAAkB,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,kBAAkB,GACpF,qBAAqB,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,kBAAkB,CAAC;AAE9F,MAAM,WAAW,SAAS;IAAG,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAAE;AAC7E,MAAM,WAAW,SAAS;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAAE;AAEhH,eAAO,MAAM,UAAU,EAAE,SAAS,EAsCjC,CAAC;AAIF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,SAAS,CAmBxF"}
+{"version":3,"file":"wakewords.d.ts","sourceRoot":"","sources":["../../src/policy/wakewords.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,OAAO,GACf,kBAAkB,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,kBAAkB,GACpF,qBAAqB,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,kBAAkB,GAGzF,qBAAqB,GAAG,qBAAqB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAE1F,MAAM,WAAW,SAAS;IAAG,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAAE;AAC7E,MAAM,WAAW,SAAS;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAAE;AAEhH,eAAO,MAAM,UAAU,EAAE,SAAS,EAyDjC,CAAC;AAIF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,SAAS,CAmBxF"}

package/dist/policy/wakewords.js

@@ -1,5 +1,7 @@
-// 口径层·唤醒词路由：自然语言 → 8 联动 key；最长匹配；无命中/缺槽位 throw。
-// HELP 速查唯一上游；改这里，HELP 构建期跟进。37 条 = help4 + view7 + search8 (#43 F1 看菜/看菜谱→view) + write4 + cooking4 + shopping4 + record3 + query3。
+// 口径层·唤醒词路由：自然语言 → 联动 key；最长匹配；无命中/缺槽位 throw。
+// HELP 速查唯一上游；改这里，SKILL.md 的说明面与快照（构建期）、HELP 页的卡状态（生成器）三处跟进。
+// 50 条 = 37 条原路由词（下标 1..37 不动）＋ 13 条本次接入词（下标 38..50，按域归组）。
+// 改这张表＝同时改三处登记面，判据见 `docs/skills/skill-chef/t841-登记面对账.mjs`。
 import { ChefPolicyError } from '../fetch/errors.js';
 export const WAKE_TABLE = [
     { phrase: '私家大厨HELP', key: 'chef.help.lookup' },
@@ -39,6 +41,25 @@ export const WAKE_TABLE = [
     { phrase: '查看历史', key: 'chef.history.query', needs: ['name'] },
     { phrase: '查看统计', key: 'chef.history.query', preset: { kind: 'stats' } },
     { phrase: '体检', key: 'chef.history.query', preset: { kind: 'quality' } },
+    // ── 38–50：本次接入的 13 条旧路由表外短语（原文见 `docs/skills/skill-chef/t767-对账表.md` §二）。
+    //    这 13 条原是不可路由的老组名；各域在 #770–#776 落好命令分支与页面后，
+    //    由 #841 补进本表接管路由。`needs` 逐条对齐各域 run 真正读的参数名，
+    //    `preset` 逐条对齐 t767 的卡面 `editable_fields`（筛选四条的维度键照卡面写，
+    //    不经 `filter` 绕 `cuisine`——同 #771 对既有三条路由错位的处理）。
+    //    排序：按域归组，域序照十域表（搜索筛选 → 修改 → 录入 → 派生 → 开始使用 → 数据管理）。
+    { phrase: '筛选难度', key: 'chef.recipe.search', needs: ['difficulty'] },
+    { phrase: '筛选时间', key: 'chef.recipe.search', needs: ['time_max'] },
+    { phrase: '筛选炊具', key: 'chef.recipe.search', needs: ['cookware'] },
+    { phrase: '筛选状态', key: 'chef.recipe.search', needs: ['status'] },
+    { phrase: '修改步骤', key: 'chef.recipe.write', needs: ['name', 'step'], preset: { op: 'update', target: 'step' } },
+    { phrase: '修改食材', key: 'chef.recipe.write', needs: ['name', 'ingredient'], preset: { op: 'update', target: 'ingredient' } },
+    { phrase: '导入食谱', key: 'chef.recipe.write', needs: ['name', 'input'], preset: { op: 'add' } },
+    { phrase: '添加派生关系', key: 'chef.relation.write', needs: ['child', 'parent', 'relation_type', 'change_summary'] },
+    { phrase: '从已有派生新菜', key: 'chef.relation.write', needs: ['source', 'target', 'differences'], preset: { op: 'derive' } },
+    { phrase: '首次使用', key: 'chef.setup.init' },
+    { phrase: '查看派生关系', key: 'chef.relation.query', needs: ['name'] },
+    { phrase: '批量改', key: 'chef.data.batch', needs: ['name'] },
+    { phrase: '备份', key: 'chef.history.query', preset: { kind: 'backup' } },
 ];
 const SORTED = [...WAKE_TABLE].sort((a, b) => b.phrase.length - a.phrase.length);
 export function routeWakeword(text, ctx = {}) {