skill-calorie 0.2.3 → 0.2.4

package/dist/photo/helpFile.d.ts

@@ -0,0 +1,26 @@
+import { HELP_CONTACT } from './helpCenter.js';
+import type { WakeGroupAsset } from '../triggers/wake-assets.js';
+/** 「卡路里help」交付文件的文件名主体（接线层写死；调用方不接受外部传入，S3-3）。 */
+export declare const HELP_FILE_STEM: "\u5361\u8DEF\u91CC_HELP";
+/** 5 键头（实物逐字）。 */
+export declare const HELP_FILE_SKILL_NAME: "\u5361\u8DEF\u91CC";
+export declare const HELP_FILE_TITLE: "\u5524\u9192\u8BCD\u901F\u67E5\u53F0";
+/** 实物 payload 容器 id（`help-data`，老 `:195`）。 */
+export declare const HELP_FILE_DATA_ID: "help-data";
+/** 5 键 HELP JSON（实物顶层键集；`groups` 由资产直转，只读引用不 clone）。 */
+export interface HelpFileData {
+    readonly skill_name: typeof HELP_FILE_SKILL_NAME;
+    readonly title: typeof HELP_FILE_TITLE;
+    readonly subtitle: string;
+    readonly contact: typeof HELP_CONTACT;
+    readonly groups: readonly WakeGroupAsset[];
+}
+/** 老 `%Y-%m-%d %H:%M` 等价物（本地时区，零填充；非法 Date 即坏参，不返空串）。 */
+export declare function formatHelpMinute(now: Date): string;
+/** 资产 → 5 键 JSON（纯函数；组数／场景数由资产派生，不写死 10／436）。 */
+export declare function buildHelpFileData(now?: Date): HelpFileData;
+/** 5 键 JSON → 全壳 HTML（T3 #134 与老实物同壳；模板唯一实现已搬家至
+ * `base-paint/help-shell:renderHelpShellHtml`——DOM＋CSS变量＋三槽填充物照搬老实物，
+ * 本函数只做接线层转发，不自造第二套壳；空分组抛 `missing-data`，调用方 exit 5）。 */
+export declare function renderHelpFileHtml(data: HelpFileData): string;
+//# sourceMappingURL=helpFile.d.ts.map

package/dist/photo/helpFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpFile.d.ts","sourceRoot":"","sources":["../../src/photo/helpFile.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAIjE,kDAAkD;AAClD,eAAO,MAAM,cAAc,EAAG,yBAAmB,CAAC;AAClD,kBAAkB;AAClB,eAAO,MAAM,oBAAoB,EAAG,oBAAc,CAAC;AACnD,eAAO,MAAM,eAAe,EAAG,sCAAiB,CAAC;AACjD,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,EAAG,WAAoB,CAAC;AAEtD,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,oBAAoB,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,OAAO,eAAe,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,YAAY,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;CAC5C;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAOlD;AA+BD,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,IAAiB,GAAG,YAAY,CAatE;AAED;;yDAEyD;AACzD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAE7D"}

package/dist/photo/helpFile.js

@@ -0,0 +1,90 @@
+/** #139 · 「卡路里help」的交付**内容**：5 键 HELP JSON → 老实物同款 V4 三级目录壳。
+ *
+ * 本模块**零 IO、零落盘**：落点命名与写盘全在 CLI 交付管线
+ * （`cli/cmd_read.ts` → `output.ts:deliverHtml`，`wx` 独占＋`EEXIST` 递补＋绝对路径回执）。
+ * 教训（#139 诊断）：本模块此前自带 `runHelpFile` 落盘，结果只被自己的单测调用——
+ * 「单测全绿、live 出口没人调」的孤岛，产出与交付脱钩，故删。
+ *
+ * 链路（每步零旁路）：
+ *  1. 资产：`WAKE_GROUPS` 直转 5 键 HELP JSON（`skill_name/title/subtitle/contact/groups`，
+ *     老实物 `卡路里_HELP_20260906_220726.html:195` 口径；`subtitle` 沿老
+ *     `render_help_center.py:182-186` 公式 `〈组数〉 分类 · 〈场景数〉 场景 · 更新于 〈本地分钟〉`；
+ *     `contact` 与 `photo/helpCenter.ts:HELP_CONTACT` 同源（实物 2 项逐字）；
+ *     `init_banner/version/recommendations` 为模板侧可选能力，本接线**不传**——传了即
+ *     第二真相源，漂移面无收益）。
+ *  2. 渲染：`renderHelpFileHtml` → `base-paint/help-shell:renderHelpShellHtml`
+ *     （模板唯一实现＝verbatim 老实物；空分组抛 `missing-data`，调用方 exit 5；
+ *     模板源在 `packages/base-render/assets/help-template.html`，改动走 `gen:help-shell`）。
+ */
+import { CalorieRenderError } from '../render/errors.js';
+import { HELP_CONTACT } from './helpCenter.js';
+import { WAKE_ASSETS, WAKE_GROUPS } from '../triggers/wake-assets.js';
+import { SCENE_09_PHOTO } from '../triggers/scene-09-photo.js';
+import { renderHelpShellHtml } from '../render/helpShell.js';
+/** 「卡路里help」交付文件的文件名主体（接线层写死；调用方不接受外部传入，S3-3）。 */
+export const HELP_FILE_STEM = '卡路里_HELP';
+/** 5 键头（实物逐字）。 */
+export const HELP_FILE_SKILL_NAME = '卡路里';
+export const HELP_FILE_TITLE = '唤醒词速查台';
+/** 实物 payload 容器 id（`help-data`，老 `:195`）。 */
+export const HELP_FILE_DATA_ID = 'help-data';
+/** 老 `%Y-%m-%d %H:%M` 等价物（本地时区，零填充；非法 Date 即坏参，不返空串）。 */
+export function formatHelpMinute(now) {
+    if (!(now instanceof Date) || Number.isNaN(now.getTime())) {
+        throw new CalorieRenderError('bad-input', 'HELP 更新时间须为有效 Date（缺失阻断不返空）。');
+    }
+    const p = (n) => String(n).padStart(2, '0');
+    return String(now.getFullYear()) + '-' + p(now.getMonth() + 1) + '-' + p(now.getDate())
+        + ' ' + p(now.getHours()) + ':' + p(now.getMinutes());
+}
+/** #437 · 把 scene 09 那十条的 `prompt_template` 换成 **SoT（`SCENE_09_PHOTO`）** 的值。
+ *
+ *  分叉事实（2026-09-16 实测）：`WAKE_GROUPS`（`wake-assets.ts`，机器生成的老资产）里
+ *  `body_photo` 组十条 prompt **与 SoT 十条逐条不同**（10/10），且 #345 给速查写的流程句
+ *  （「动笔前请先出预检确认页」／「动手前请先出候选页」）**在缺省 HELP 里 0 命中** —— 即默认交付的
+ *  `卡路里_HELP_<时间戳>.html` 读不出「先出哪张过程型页」。
+ *
+ *  合口径的**唯一改动地就是这里**：`wake-assets.ts` 是生成物（头注禁令：不许手改，改词即改 SoT），
+ *  133 指纹也不动；只在装配这一步按**场景 id ↔ trigger key** 覆盖 prompt 文本，其余字段（标题／唤醒词／
+ *  分组／图标／顺序）仍由资产给——分叉只剩「prompt 文本」这一处，而它现在只有一个定义地。 */
+function withScene09Prompts(groups) {
+    // `Trigger` 是 `SceneTrigger | LegacyTrigger` 的联合（老条目没有 key／prompt_template），
+    // 故按 SoT 的家法收窄（同 `helpLookup.ts` 的 `keyOf` 一脉），不硬转。
+    const byKey = new Map();
+    for (const t of SCENE_09_PHOTO) {
+        if ('key' in t && 'prompt_template' in t)
+            byKey.set(t.key, t.prompt_template);
+    }
+    return groups.map((g) => (g.id !== 'body_photo' ? g : {
+        ...g,
+        subgroups: g.subgroups.map((sg) => ({
+            ...sg,
+            scenes: sg.scenes.map((sc) => {
+                const prompt = byKey.get(sc.id);
+                return prompt === undefined || prompt === sc.prompt_template ? sc : { ...sc, prompt_template: prompt };
+            }),
+        })),
+    }));
+}
+/** 资产 → 5 键 JSON（纯函数；组数／场景数由资产派生，不写死 10／436）。 */
+export function buildHelpFileData(now = new Date()) {
+    const groups = withScene09Prompts(WAKE_GROUPS);
+    if (groups.length === 0 || WAKE_ASSETS.length === 0) {
+        throw new CalorieRenderError('missing-data', 'HELP 资产分组缺失（WAKE_GROUPS 空）');
+    }
+    return {
+        skill_name: HELP_FILE_SKILL_NAME,
+        title: HELP_FILE_TITLE,
+        subtitle: String(groups.length) + ' 分类 · ' + String(WAKE_ASSETS.length)
+            + ' 场景 · 更新于 ' + formatHelpMinute(now),
+        contact: HELP_CONTACT,
+        groups,
+    };
+}
+/** 5 键 JSON → 全壳 HTML（T3 #134 与老实物同壳；模板唯一实现已搬家至
+ * `base-paint/help-shell:renderHelpShellHtml`——DOM＋CSS变量＋三槽填充物照搬老实物，
+ * 本函数只做接线层转发，不自造第二套壳；空分组抛 `missing-data`，调用方 exit 5）。 */
+export function renderHelpFileHtml(data) {
+    return renderHelpShellHtml(data);
+}
+//# sourceMappingURL=helpFile.js.map

package/dist/photo/helpFile.js.map

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

package/dist/photo/helpLookup.d.ts

@@ -0,0 +1,18 @@
+export declare const PHOTO_HELP_MODULE: "skill-calorie/photo/photo";
+export interface PhotoHelpHit {
+    wakeWord: string;
+    key: string;
+    desc: string;
+    legacyCli: string;
+    /** 可执行 TS 入口模块（dist 相对包名，动态 import 可达）。 */
+    module: string;
+    /** 可执行 TS 入口函数名（模块须导出）。 */
+    fn: string;
+    /** 复制即运行的 node 一行式（读 SKILLS_DB_PATH）。 */
+    exec: string;
+}
+/** 全量照片 HELP（10 键，顺序跟 SCENE_09_PHOTO SoT 序）。 */
+export declare function buildPhotoHelp(): PhotoHelpHit[];
+/** 现找：唤醒词/key/描述子串命中（空串抛，不返全表冒充命中）。 */
+export declare function lookupPhotoHelp(word: string): PhotoHelpHit[];
+//# sourceMappingURL=helpLookup.d.ts.map

package/dist/photo/helpLookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpLookup.d.ts","sourceRoot":"","sources":["../../src/photo/helpLookup.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,iBAAiB,EAAG,2BAAoC,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;CACd;AA2BD,gDAAgD;AAChD,wBAAgB,cAAc,IAAI,YAAY,EAAE,CAe/C;AAED,uCAAuC;AACvC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAI5D"}

package/dist/photo/helpLookup.js

@@ -0,0 +1,58 @@
+/** T10 #29 · 身材照片 HELP 速查台（对照老家 render_help_center.py + SKILL 速查表）。
+ *
+ * 数据源：triggers SCENE_09_PHOTO 唯一上游（SoT，不复制唤醒词文本）。
+ * Q71 验收：HELP 从 SKILL 现找直达可执行命令——每条命中自带 exec（node 一行
+ * 式，可直接复制运行，读 SKILLS_DB_PATH 库），legacyCli 保留老家 python 原命令
+ * 备查。lookupPhotoHelp 按唤醒词/键/描述子串现找。
+ */
+import { SCENE_09_PHOTO } from '../triggers/scene-09-photo.js';
+import { CalorieRenderError } from '../render/errors.js';
+export const PHOTO_HELP_MODULE = 'skill-calorie/photo/photo';
+function execFor(module, fn, argsExpr) {
+    return 'node --input-type=module -e "import { openDb } from \'skill-calorie\'; ' +
+        'import { ' + fn + ' } from \'' + module + '\'; ' +
+        'const db = openDb(process.env.SKILLS_DB_PATH); ' +
+        'try { console.log(JSON.stringify(' + fn + '(db, ' + argsExpr + '))); } finally { db.close(); }"';
+}
+/** key → 可执行函数映射（T4 取数 + 本包渲染，无二进制操作）。 */
+const KEY_EXEC = {
+    body_photo_add_single: { module: 'skill-calorie/photo/photos', fn: 'addPhotos', args: 'process.env.CALORIE_PHOTOS_DIR, { srcPaths: ["<照片路径>"], tag: "<标签>" }' },
+    body_photo_add_note: { module: 'skill-calorie/photo/photos', fn: 'addPhotos', args: 'process.env.CALORIE_PHOTOS_DIR, { srcPaths: ["<照片路径>"], tag: "<标签>", note: "<备注>" }' },
+    body_photo_add_batch: { module: 'skill-calorie/photo/photos', fn: 'addPhotos', args: 'process.env.CALORIE_PHOTOS_DIR, { srcPaths: ["<照片1>", "<照片2>"], tag: "<标签>" }' },
+    body_photo_list: { module: PHOTO_HELP_MODULE, fn: 'buildGalleryData', args: '{ tag: "<标签>", days: 90 }' },
+    body_photo_compare: { module: PHOTO_HELP_MODULE, fn: 'buildCompareData', args: '<ID1>, <ID2>' },
+    body_photo_gif: { module: PHOTO_HELP_MODULE, fn: 'buildGifTask', args: '{ tag: "<标签>", days: 90 }' },
+    body_photo_delete: { module: 'skill-calorie/photo/photos', fn: 'deletePhoto', args: 'process.env.CALORIE_PHOTOS_DIR, <ID>' },
+    body_photo_tag_set: { module: PHOTO_HELP_MODULE, fn: 'buildTagReceipt', args: '<ID>, <改前标签数组>, <改后标签数组>, "改照片标签"' },
+    body_photo_tag_add: { module: PHOTO_HELP_MODULE, fn: 'buildTagReceipt', args: '<ID>, <改前标签数组>, <改后标签数组>, "加照片标签"' },
+    body_photo_tag_remove: { module: PHOTO_HELP_MODULE, fn: 'buildTagReceipt', args: '<ID>, <改前标签数组>, <改后标签数组>, "删照片标签"' },
+};
+function keyOf(t) {
+    return typeof t.key === 'string' ? t.key : '';
+}
+/** 全量照片 HELP（10 键，顺序跟 SCENE_09_PHOTO SoT 序）。 */
+export function buildPhotoHelp() {
+    return SCENE_09_PHOTO.map((t) => {
+        const key = keyOf(t);
+        const e = KEY_EXEC[key];
+        if (!e)
+            throw new CalorieRenderError('bad-input', '照片 HELP 缺可执行映射：' + key);
+        return {
+            wakeWord: t.wake_word,
+            key,
+            desc: t.desc,
+            legacyCli: t.main_prompt.cli,
+            module: e.module,
+            fn: e.fn,
+            exec: execFor(e.module, e.fn, e.args),
+        };
+    });
+}
+/** 现找：唤醒词/key/描述子串命中（空串抛，不返全表冒充命中）。 */
+export function lookupPhotoHelp(word) {
+    const q = String(word ?? '').trim();
+    if (!q)
+        throw new CalorieRenderError('bad-input', 'HELP 查询词必填');
+    return buildPhotoHelp().filter((h) => h.wakeWord.includes(q) || h.key.includes(q) || h.desc.includes(q));
+}
+//# sourceMappingURL=helpLookup.js.map

package/dist/photo/helpLookup.js.map

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

package/dist/photo/helpPaths.d.ts

@@ -0,0 +1,22 @@
+/** T2-②a #133 · HELP 落盘的**本技能自己的值**（目录名、扩展名、速查台主体；零 IO、零逻辑）。
+ *
+ * #237 改判（**就地改正上一轮的结论**）：时间戳格式 `YYYYMMDD_HHMMSS`（本地时间）与通式
+ * `〈文件名主体〉_<stamp>[_N].html` **不再住这里**——维护者 2026-09-12 裁决 8「不应该是一个独立的 base 包，
+ * 放在 `base-paint` 吧，是绘制出 html 后的相关操作」＋ 地图 #208 的 Q7 裁「乙」（收成共用位）之后，
+ * 命名的唯一定义地是共用件 `base-paint/save-html` 的 `saveHtmlFile`
+ * （`packages/base-render/src/output/saveHtml.ts`）；原先本模块的 `formatHelpStamp`／
+ * `buildHelpFileName`／`resolveStemTarget` 已随之删除（旧 `writeFileExclusiveWithRetry` 的递补口径由共用件持有）。
+ *
+ * 老命名规则复刻（只读基线 `D:\2Study\StudyNotes\SKILLS\卡路里\scripts\html_paths.py`）：
+ *   - 文件名主体原样使用：可含中文／空格／`：`／`vs`／`_`（老 `html_name` 只 sanitize `suffix`，`command` 不洗）；
+ *   - 输出目录：老 `db_path.parent / calorie_html`（`db_path` 为 db **文件**）≡
+ *     TS 线 `join(dbDir, 'calorie_html')`（`dbDir` 为 `SKILLS_DB_PATH` **目录**，见 `src/paths.ts`）；
+ *     目录不存在则递归创建（老 `html_dir(mkdir=True)`），不写死任何盘符。
+ */
+/** HELP 产物子目录名（老 `SKILL_HTML_NAME + "_html"`，卡路里 → `calorie_html`）。 */
+export declare const HELP_HTML_DIR_NAME = "calorie_html";
+/** HELP 产物扩展名。 */
+export declare const HELP_HTML_EXT = ".html";
+/** 速查台（#88，须显式 `mode` 才出）的文件名主体：与 HELP 文件分名，两份产物不撞名。 */
+export declare const SHEET_FILE_STEM = "\u5361\u8DEF\u91CC_\u901F\u67E5\u53F0";
+//# sourceMappingURL=helpPaths.d.ts.map

package/dist/photo/helpPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpPaths.d.ts","sourceRoot":"","sources":["../../src/photo/helpPaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AACjD,kBAAkB;AAClB,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC,wDAAwD;AACxD,eAAO,MAAM,eAAe,0CAAY,CAAC"}

package/dist/photo/helpPaths.js

@@ -0,0 +1,22 @@
+/** T2-②a #133 · HELP 落盘的**本技能自己的值**（目录名、扩展名、速查台主体；零 IO、零逻辑）。
+ *
+ * #237 改判（**就地改正上一轮的结论**）：时间戳格式 `YYYYMMDD_HHMMSS`（本地时间）与通式
+ * `〈文件名主体〉_<stamp>[_N].html` **不再住这里**——维护者 2026-09-12 裁决 8「不应该是一个独立的 base 包，
+ * 放在 `base-paint` 吧，是绘制出 html 后的相关操作」＋ 地图 #208 的 Q7 裁「乙」（收成共用位）之后，
+ * 命名的唯一定义地是共用件 `base-paint/save-html` 的 `saveHtmlFile`
+ * （`packages/base-render/src/output/saveHtml.ts`）；原先本模块的 `formatHelpStamp`／
+ * `buildHelpFileName`／`resolveStemTarget` 已随之删除（旧 `writeFileExclusiveWithRetry` 的递补口径由共用件持有）。
+ *
+ * 老命名规则复刻（只读基线 `D:\2Study\StudyNotes\SKILLS\卡路里\scripts\html_paths.py`）：
+ *   - 文件名主体原样使用：可含中文／空格／`：`／`vs`／`_`（老 `html_name` 只 sanitize `suffix`，`command` 不洗）；
+ *   - 输出目录：老 `db_path.parent / calorie_html`（`db_path` 为 db **文件**）≡
+ *     TS 线 `join(dbDir, 'calorie_html')`（`dbDir` 为 `SKILLS_DB_PATH` **目录**，见 `src/paths.ts`）；
+ *     目录不存在则递归创建（老 `html_dir(mkdir=True)`），不写死任何盘符。
+ */
+/** HELP 产物子目录名（老 `SKILL_HTML_NAME + "_html"`，卡路里 → `calorie_html`）。 */
+export const HELP_HTML_DIR_NAME = 'calorie_html';
+/** HELP 产物扩展名。 */
+export const HELP_HTML_EXT = '.html';
+/** 速查台（#88，须显式 `mode` 才出）的文件名主体：与 HELP 文件分名，两份产物不撞名。 */
+export const SHEET_FILE_STEM = '卡路里_速查台';
+//# sourceMappingURL=helpPaths.js.map

package/dist/photo/helpPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpPaths.js","sourceRoot":"","sources":["../../src/photo/helpPaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AACjD,kBAAkB;AAClB,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC,wDAAwD;AACxD,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC"}

package/dist/photo/index.d.ts

@@ -0,0 +1,17 @@
+/** 身材照片能力对外的门（HELP 一级分组「身材照片」／场景 09）：命令分派三件。
+ *
+ * 对外三件：
+ *   ① `PHOTO_COMMANDS`——命令声明（权威源在 `commands.ts`，这里只是转出）；
+ *   ② `runPhotoView(key, params, db)`——读命令入口（查不到身材照片键即抛，不当静默兜底）；
+ *   ③ `runPhotoWrite(key, params, db)`——写命令入口（同上）。
+ * 域内其他件（存／看／比／管／向导／HELP 六个子功能文件 ＋ 照片目录解析 `dir.ts`）
+ * **不出这个目录**，故不在这里转出。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { ViewOut, WriteOut } from '../shared/commandSpec.js';
+export { PHOTO_COMMANDS } from './commands.js';
+/** 读命令入口：命中即走它的处理函数；键不属身材照片（或其实是写键）即抛——**不猜**。 */
+export declare function runPhotoView(key: string, params: Record<string, unknown>, db: DatabaseSync): ViewOut;
+/** 写命令入口：同上。 */
+export declare function runPhotoWrite(key: string, params: Record<string, unknown>, db: DatabaseSync): WriteOut;
+//# sourceMappingURL=index.d.ts.map

package/dist/photo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/photo/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAI/C,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,YAAY,GAAG,OAAO,CAMpG;AAED,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,YAAY,GAAG,QAAQ,CAMtG"}

package/dist/photo/index.js

@@ -0,0 +1,21 @@
+import { CalorieRenderError } from '../render/errors.js';
+import { PHOTO_COMMANDS } from './commands.js';
+export { PHOTO_COMMANDS } from './commands.js';
+const BY_KEY = new Map(PHOTO_COMMANDS.map((c) => [c.key, c]));
+/** 读命令入口：命中即走它的处理函数；键不属身材照片（或其实是写键）即抛——**不猜**。 */
+export function runPhotoView(key, params, db) {
+    const spec = BY_KEY.get(key);
+    if (!spec || spec.kind !== 'read') {
+        throw new CalorieRenderError('bad-input', '不是身材照片的读命令：' + key);
+    }
+    return spec.run(params, db);
+}
+/** 写命令入口：同上。 */
+export function runPhotoWrite(key, params, db) {
+    const spec = BY_KEY.get(key);
+    if (!spec || spec.kind !== 'write') {
+        throw new CalorieRenderError('bad-input', '不是身材照片的写命令：' + key);
+    }
+    return spec.run(params, db);
+}
+//# sourceMappingURL=index.js.map

package/dist/photo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/photo/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9D,kDAAkD;AAClD,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,MAA+B,EAAE,EAAgB;IACzF,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,aAAa,GAAG,GAAG,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,MAA+B,EAAE,EAAgB;IAC1F,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACnC,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,aAAa,GAAG,GAAG,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC"}

package/dist/photo/manage.d.ts

@@ -0,0 +1,13 @@
+/** 管身材照（HELP 一级分组「身材照片」下一级）：删身材照 ＋ 改／加／删照片标签两条写命令。
+ *
+ * 两条 `case` 逐字搬自旧分派层 `cli/write.ts`（#314 纯搬迁，行为不变）；
+ * 删身材照是**硬删除**（行删掉、不可恢复），照片本体也从照片目录里删——口径照旧，未改。
+ * 标签命令一个键承载三种动作（`op` = set／add／remove），回执场景名随之分三种。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { WriteOut } from '../shared/commandSpec.js';
+/** `calorie.photo.remove` · 删身材照（硬删除；查不到即 missing-data）。 */
+export declare function writePhotoRemove(params: Record<string, unknown>, db: DatabaseSync): WriteOut;
+/** `calorie.photo.tag` · 改照片标签：`op` 三选一（set 全量替换／add 加一个／remove 删一个）。 */
+export declare function writePhotoTag(params: Record<string, unknown>, db: DatabaseSync): WriteOut;
+//# sourceMappingURL=manage.d.ts.map

package/dist/photo/manage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage.d.ts","sourceRoot":"","sources":["../../src/photo/manage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAKzD,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,YAAY,GAAG,QAAQ,CAY5F;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,YAAY,GAAG,QAAQ,CA+BzF"}

package/dist/photo/manage.js

@@ -0,0 +1,64 @@
+import { deletePhoto, getPhotoRow, parseTags, serializeTags, tagAdd, tagRemove, updateTag } from './photos.js';
+import { buildDeleteReceipt, buildTagReceipt } from './photo.js';
+import { withM5 } from '../render/receipt.js';
+import { CalorieRenderError } from '../render/errors.js';
+import { commandLine, totalChanges } from '../shared/writeParts.js';
+import { fail, needId, needStr } from '../shared/params.js';
+import { photoDirOrThrow } from './dir.js';
+import { embedPhoto } from './photoThumb.js';
+import { buildPhotoRemoveDoc, buildPhotoTagDoc } from './receipt.js';
+/** `calorie.photo.remove` · 删身材照（硬删除；查不到即 missing-data）。 */
+export function writePhotoRemove(params, db) {
+    const id = needId(params);
+    const dir = photoDirOrThrow(params);
+    const snap = getPhotoRow(db, id);
+    if (!snap)
+        throw new CalorieRenderError('missing-data', '身材照 #' + id + ' 不存在');
+    const preEmbed = embedPhoto(dir, snap.photo_path);
+    const before = totalChanges(db);
+    deletePhoto(db, dir, id);
+    const receipt = withM5(buildDeleteReceipt(snap), {
+        ids: [id], writtenFields: [], affectedRows: totalChanges(db) - before,
+    });
+    return { data: { ok: true, message: receipt.summary, receipt }, html: buildPhotoRemoveDoc(receipt, { embed: preEmbed, command: commandLine('calorie.photo.remove', params) }) };
+}
+/** `calorie.photo.tag` · 改照片标签：`op` 三选一（set 全量替换／add 加一个／remove 删一个）。 */
+export function writePhotoTag(params, db) {
+    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];
+    const dbBefore = totalChanges(db);
+    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'],
+        affectedRows: totalChanges(db) - dbBefore,
+    });
+    return { data: { ok: true, message: receipt.summary, receipt }, html: buildPhotoTagDoc(receipt, { command: commandLine('calorie.photo.tag', params) }) };
+}
+//# sourceMappingURL=manage.js.map

package/dist/photo/manage.js.map

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

package/dist/photo/photo.d.ts

@@ -0,0 +1,118 @@
+/** T10 #29 · 身材照片渲染数据（对照老家 render_body_photo_receipt/gallery/compare/viewer/gif_result）。
+ *
+ * 铁律直通 T4：照片二进制只存路径 + 元数据——本层只透出 photo_path 文件名与
+ * fileExists 存在位，永不读文件字节、不做 base64 内嵌（老家 PIL 缩放+q75 内嵌
+ * 在此有意舍弃，飞书自包含改由调用方按需处理）；gif 只出 planGif 任务描述，
+ * 不跑图像合成、不碰二进制。写库一律走 T4 fetch，本层只做呈现组装。
+ * 缺失阻断不返空：空窗/无行即 missing-data，同体不合并走 bad-input。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import { type PhotoRow } from './photos.js';
+import { type CrudReceipt, type PhotoDistance } from '../render/receipt.js';
+export interface PhotoCard {
+    id: number;
+    date: string;
+    time: string | null;
+    photoPath: string;
+    tagList: string[];
+    note: string | null;
+    /** null = 未传 photosDir（未知，不断言）；true/false = 存在性实测。 */
+    fileExists: boolean | null;
+}
+export declare function toCard(row: PhotoRow, photosDir?: string | null): PhotoCard;
+export interface GalleryFilter {
+    dateFrom?: string;
+    dateTo?: string;
+    days?: number;
+    tag?: string;
+    limit?: number | null;
+    today?: string;
+}
+export interface GalleryData {
+    scene: '看身材照';
+    filters: {
+        tag: string;
+        dateFrom: string;
+        dateTo: string;
+    };
+    totalCount: number;
+    tagCounts: {
+        tag: string;
+        count: number;
+    }[];
+    daysSinceLast: number | null;
+    photos: PhotoCard[];
+}
+/** 看身材照：网格 + 时间/标签筛选 + 计数（老家 gallery build 对应，默认 90 天窗）。 */
+export declare function buildGalleryData(db: DatabaseSync, filter?: GalleryFilter, photosDir?: string | null): GalleryData;
+export interface CompareData {
+    scene: '对比两张照片';
+    photo1: PhotoCard;
+    photo2: PhotoCard;
+    intervalDays: number;
+    orderByDate: boolean;
+    crossTagWarning: boolean;
+}
+/** 对比两张照片：并排 + 间隔天数 + 跨标签警告（老家方案 B：警告不拦截）。 */
+export declare function buildCompareData(db: DatabaseSync, id1: number, id2: number, photosDir?: string | null): CompareData;
+export interface ViewerData {
+    scene: '查身材照';
+    photo: PhotoCard;
+    prevId: number | null;
+    nextId: number | null;
+}
+/** 单图查看：照片 + 同标签 prev/next（老家 viewer 邻居口径：同 tag 按日期排序）。 */
+export declare function buildViewerData(db: DatabaseSync, id: number, photosDir?: string | null): ViewerData;
+export interface GifTask {
+    task: 'generate_gif';
+    tag: string;
+    dateFrom: string | null;
+    dateTo: string | null;
+    photoCount: number;
+    photoIds: number[];
+    firstDate: string | null;
+    lastDate: string | null;
+    note: string;
+}
+export declare const GIF_PASSTHROUGH_NOTE = "GIF \u5408\u6210\u7531\u5916\u90E8\u6309\u672C\u4EFB\u52A1\u63CF\u8FF0\u6267\u884C\uFF0C\u672C\u6E32\u67D3\u4E0D\u78B0\u4E8C\u8FDB\u5236";
+/** 动图规划器：只出任务描述（T4 planGif 直通；photoIds 显式交集，不跑合成）。 */
+export declare function buildGifTask(db: DatabaseSync, input: {
+    tag: string;
+    dateFrom?: string | null;
+    dateTo?: string | null;
+    days?: number | null;
+    photoIds?: number[];
+}): GifTask;
+export interface AddedPhoto {
+    id: number;
+    file: string;
+}
+/** 存照片回执：单张/含备注/批量（items 逐张状态由调用方按 T4 addPhotos 结果组装）。
+ *
+ * #476 两处修正：
+ * - **失败张逐张上页**：以前失败的不进 `items`（`addPhotos` 直接跳过），逐张状态恒「成功」，
+ *   页面只在摘要给个数字——现在按 `srcPaths` 复算缺哪些，逐条以 `status:'失败'` ＋ `reason`
+ *   入 items（点名源文件），页面逐张印出。
+ * - **`distance` 真传进回执**：原来只在摘要里印，`buildCrudReceipt` 没收到这一位，专用卡恒是死支。
+ *   摘要里那句同时删掉（同一件事不再印两遍），改由页面上的独立小卡说。 */
+export declare function buildAddReceipt(added: AddedPhoto[], opts: {
+    tag: string;
+    note?: string;
+    distance?: PhotoDistance | null;
+    failedCount?: number;
+    srcPaths?: readonly string[];
+}): CrudReceipt;
+/** 删照片回执：删除前快照（调用方先 getPhotoRow 取快照，再调 T4 deletePhoto）。
+ *
+ * #101 删除可恢复性口径：`body_photos` 走 `DELETE FROM` ＋ 删文件，属**硬删除**，
+ * 故文案必须显式标注「硬删除，不可恢复」；软删除键（行保留）一律**不承诺可恢复**
+ * （全仓 0 个 restore/undo/recover 入口），词条与 `items[].status` 同源。
+ *
+ * #476：这两串是**机器口径**——写链三源一致判据钉着它们（`cmd-write-40-persist` 比
+ * prose／items[].status／库内行三处），本票一字不改；页面可见文本改词「永久删除，无法恢复」
+ * 且全页只留 1 处，由 `receipt.ts` 自写副标题与状态句承担（页面不再直接印这两串）。
+ */
+export declare function buildDeleteReceipt(snapshot: PhotoRow): CrudReceipt;
+/** 标签回执：改前/改后对比 + 无变化明示（set 整套覆盖 / add 追加判重 / remove 移除）。 */
+export declare function buildTagReceipt(photoId: number, before: string[], after: string[], scene: '改照片标签' | '加照片标签' | '删照片标签'): CrudReceipt;
+//# sourceMappingURL=photo.d.ts.map

package/dist/photo/photo.d.ts.map

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