skill-calorie 0.2.2 → 0.2.4

package/templates/help.html

@@ -26,7 +26,7 @@ pre{white-space:pre-wrap;border-radius:16px;padding:16px;overflow:auto;font-size
 <strong>取数</strong>
 <pre class="view-cli">calorie-cmd-read calorie.help.lookup --params '{"q":"看今日主页"}'</pre>
 </section>
-<section class="panel"><strong>身材照片 HELP 模块</strong><pre>skill-calorie/dist/render/photo.js · buildPhotoHelp/lookupPhotoHelp · 每条命中自带 exec（node 一行式）+ legacyCli</pre></section>
+<section class="panel"><strong>身材照片 HELP 模块</strong><pre>skill-calorie/photo/photo ＋ skill-calorie/photo/photos · buildPhotoHelp/lookupPhotoHelp · 每条命中自带 exec（node 一行式）+ legacyCli</pre></section>
 <section class="panel">
 <strong>数据与日志</strong>
 <p class="small">点复制数据保存当前结果 · 日志不含隐私内容</p>

package/workflows/08-/350/272/253/344/275/223/347/273/206/350/212/202.md

@@ -0,0 +1,60 @@
+# 08 身体细节 · 逐词工作流（包内披露）
+
+> 指针：`packages/skill-calorie/SKILL.md`「场景 08 身体细节工作流程」节只留**索引表指针**一行，逐词细节只住本件。
+> 本件随包安装（`packages/skill-calorie/` 这一层进 agent 可读范围，`docs/` 进不去，故放包内）。
+> 口径源：`src/triggers/scene-08-body.ts`（13 条唤醒词）／`src/body/commands.ts`（10 条命令声明，键名权威源）／
+> `src/body/routes.ts`（17 条路由声明）／`src/body/wizardPlate.ts` 的 `WIZARD_WRITE_KEYS`（两个预检确认页各自服务的写命令）。
+> 唯一出口：`calorie-cmd-read <key>`，argv＋JSON（stdout）＋exit；成功 HTML 落 `data.output`（恒绝对路径）。
+> 跑完必须主动把 HTML 交给用户，不只给路径。
+
+## 一 · 索引表：写词 → 预检页命令（7 条）
+
+配置型写词**先出预检确认页**，用户在页上核对后复制 prompt 回给 AI，AI 再调会改数据库的命令。
+下表是这 7 条的落点；「预检页命令」列一律**照抄即跑**（就是 AI 该跑的那条命令），「会改数据库的命令」列是确认之后那一步。
+
+| # | 唤醒词（写词） | 预检页命令（照抄即跑） | 会改数据库的命令 | 备注 |
+|---|---|---|---|---|
+| 1 | `记体脂（皮褶钳）` | `calorie-cmd-read calorie.view.composition-wizard` | `calorie.body.composition-add` | 皮褶钳 7 点须先换算成 `bodyFatPct`，缺性别或年龄时先问 |
+| 2 | `记体脂（外部测量）` | `calorie-cmd-read calorie.view.composition-wizard` | `calorie.body.composition-add` | 外部设备测得的体脂率直传 |
+| 3 | `补记体脂` | `calorie-cmd-read calorie.view.composition-wizard` | `calorie.body.composition-add` | 补录过去某天；那天已有记录时先报冲突再确认 |
+| 4 | `记围度` | `calorie-cmd-read calorie.view.measure-wizard` | `calorie.body.measure-add` | 13 项围度可部分填写，至少 1 项 |
+| 5 | `补记围度` | `calorie-cmd-read calorie.view.measure-wizard` | `calorie.body.measure-add` | 同 3，按日期补录 |
+| 6 | `看体脂向导` | `calorie-cmd-read calorie.view.composition-wizard` | — | **页面入口**：这一行是预检确认页本身的开页命令，不是写词；确认后跑第 1～3 行那条写命令 |
+| 7 | `看围度向导` | `calorie-cmd-read calorie.view.measure-wizard` | — | **页面入口**：同 6，确认后跑第 4～5 行那条写命令 |
+
+**另两条写词没有预检确认页**（读—确认—写三拍，靠对话里的确认，不走页面）：`删体脂` → `calorie.body.composition-remove`；
+`删围度` → `calorie.body.measure-remove`。它们先读（`calorie.view.body-composition`／`calorie.view.body-measure`）定位记录，
+把这条记录的内容给用户看过再删。
+
+## 二 · 入口一览（哪些行是页面入口）
+
+- **页面入口行**只有上表第 6、7 两行（`看体脂向导`／`看围度向导`）——它们开的是**预检确认页本身**，
+  确认页上再走写命令。上表第 1～5 行是**写词**，它们指向同一批预检确认页。
+- 上表第 1～5 行的「预检页命令」列就是页面入口的命令；第 6、7 行是**同一个入口的另一半叫法**
+  （用页面自己的名字说），两处指向**同一个键**，不新造键。
+- 其余 13 条唤醒词都是**读类直出**（说唤醒词 → 该词对应的命令 → 结果型 HTML 落盘），没有预检确认页。
+
+## 三 · 13 条唤醒词逐条落点
+
+| # | 唤醒词 | 命令 | 产出 | 从哪一步走 |
+|---|---|---|---|---|
+| 1 | `记体脂（皮褶钳）` | `calorie.body.composition-add` | 回执页（写后） | 见索引表第 1 行：先出预检确认页 |
+| 2 | `记体脂（外部测量）` | `calorie.body.composition-add` | 回执页（写后） | 见索引表第 2 行 |
+| 3 | `补记体脂` | `calorie.body.composition-add` | 回执页（写后） | 见索引表第 3 行 |
+| 4 | `记围度` | `calorie.body.measure-add` | 回执页（写后） | 见索引表第 4 行 |
+| 5 | `补记围度` | `calorie.body.measure-add` | 回执页（写后） | 见索引表第 5 行 |
+| 6 | `看体脂` | `calorie.view.body-composition` | 结果型页面 | `calorie-cmd-read calorie.view.body-composition` |
+| 7 | `看体脂趋势` | `calorie.view.body-composition` | 结果型页面 | `calorie-cmd-read calorie.view.body-composition --params '{"days":90}'` |
+| 8 | `看围度` | `calorie.view.body-measure` | 结果型页面 | `calorie-cmd-read calorie.view.body-measure` |
+| 9 | `看围度趋势` | `calorie.view.body-measure` | 结果型页面 | `calorie-cmd-read calorie.view.body-measure --params '{"days":90}'` |
+| 10 | `对比体脂` | `calorie.view.body-composition-compare` | 结果型页面（两期对比） | `calorie-cmd-read calorie.view.body-composition-compare --params '{"period1Start":"<开始日期>","period1End":"<结束日期>","period2Start":"<开始日期>","period2End":"<结束日期>"}'` |
+| 11 | `对比围度` | `calorie.view.body-measure-compare` | 结果型页面（两日对比） | `calorie-cmd-read calorie.view.body-measure-compare --params '{"date1":"<日期1>","date2":"<日期2>"}'` |
+| 12 | `删体脂` | `calorie.body.composition-remove` | 回执页（含删前快照） | 先 `calorie.view.body-composition` 定位 → 确认 → `calorie-cmd-read calorie.body.composition-remove --params '{"id":1}'` |
+| 13 | `删围度` | `calorie.body.measure-remove` | 回执页（含删前快照） | 先 `calorie.view.body-measure` 定位 → 确认 → `calorie-cmd-read calorie.body.measure-remove --params '{"id":1}'` |
+
+## 四 · 13 部位名与两条口径
+
+- **13 部位中文名一律引 `MEASUREMENT_ZH`**（`src/fetch/body.ts` 的唯一来源），页面与本件都不写第二份字面量。
+- **缺值可见 `—`**：页面与回执上「量了但没在这一档显示出来」的情形不静默省略。
+- **payload 留空值**：机器面（复制区 payload）里缺的项留空值，不猜、不补 0。
+  （两条是**分开**的约定：可见面「缺值可见」走 `—`，机器面「缺值」留空值。）

package/workflows/09-/350/272/253/346/235/220/347/205/247/347/211/207.md

@@ -0,0 +1,98 @@
+# 09 身材照片 · 逐词工作流（包内披露）
+
+> 指针：`packages/skill-calorie/SKILL.md`「场景 09 身材照片常驻规则与工作流指针」节只留常驻规则＋一行指针，逐词细节只住本件。本件随包安装（`packages/skill-calorie/` 这一层进 agent 可读范围，`docs/` 进不去，故放包内）。
+> 口径源：`src/triggers/scene-09-photo.ts`（SCENE_09_PHOTO，10 唤醒词 SoT 顺序）／`src/photo/commands.ts`（11 条命令声明，键名以 #283 冻结 `calorie.view.photo-picker` 为准，不增删）／`src/photo/routes.ts`／t170 对账（10 个场景）／t400 融合基准（6 条裁定）。
+> 唯一出口：`calorie-cmd-read <key>`，argv＋JSON（stdout）＋exit；成功 HTML 落 `data.output`（恒绝对路径）。跑完必须主动把 HTML 交给用户，不只给路径（D7）。
+
+## 常驻规则 D2–D7（照做，不重新讨论）
+
+- D2 发图与路径双模式＋文字与图片分离到达：可直接发照片（手机／飞书），也可给照片文件路径（电脑）；文字先到等图片，图片先到追问上下文；同轮所有图片＝本次要存的照片。
+- D3 标签必填、缺则逐张追问（批量时每张可单独指定标签，没指定的用默认标签）。
+- D4 多标签模型：逗号分隔、单个 ≤20 字、单张 ≤10 个；改＝覆盖整套（`op=set`）／加＝追加判重（`op=add`，已存在即提示）／删＝移除且至少保留 1 个（`op=remove`，删空报错，想清空用改）。
+- D6 删的候选与快照：删身材照走「先列候选→快照确认→回执」三步；候选与快照页只做选中与复制，不含删除动作（删除走写命令；硬删除、不可恢复）。
+- D7 跑完必须主动把 HTML 交给用户，不只给路径（思想保留，机制按本环境＝把文件交给用户）。
+- D5（GIF 规划坐标，供场景 6 用）：裁剪 JSON `{id:[x1,y1,x2,y2]}`，像素左上原点；缺项时 prompt 为指到步骤的占位句。
+
+## 10 个场景索引（t170 四列对照表顺序）
+
+| # | 场景 | 底层唤醒词 → 命令 | 产出页面 | 从哪一步走 |
+|---|---|---|---|---|
+| 1 | 存一张照片（存身材照） | 记身材照 → `calorie.photo.add` | 回执页 | `calorie-cmd-read calorie.photo.add --params '{"srcPaths":["<照片路径>"],"tag":"正面"}'` |
+| 2 | 存照片（含备注）（存身材照） | 记身材照 → `calorie.photo.add`（带 `--note`） | 回执页 | `calorie-cmd-read calorie.photo.add --params '{"srcPaths":["<照片路径>"],"tag":"正面"}'`（备注随 `--note`） |
+| 3 | 批量存照片（存身材照） | 记身材照 → `calorie.photo.add`（多 `srcPaths`） | 回执页（逐张状态） | `calorie-cmd-read calorie.photo.add --params '{"srcPaths":["<照片路径>"],"tag":"正面"}'`（多路径即批量） |
+| 4 | 看身材照（真名，唤醒词「查身材照」） | 查身材照 → `calorie.photo.list`；单张 → `calorie.photo.detail` | 画廊页／单图页 | `calorie-cmd-read calorie.photo.list --params '{"tag":"正面"}'`；`calorie-cmd-read calorie.photo.detail --params '{"id":1}'` |
+| 5 | 对比两张照片 | 对比两张照片 → `calorie.photo.compare` | 对比页 | `calorie-cmd-read calorie.photo.compare --params '{"id1":1,"id2":2}'` |
+| 6 | 生成身材照GIF | 生成身材照GIF → `calorie.photo.gif`（前置 GIF 规划页） | GIF 结果页（前置 GIF 规划页） | 先 `calorie-cmd-read calorie.view.gif-planner --params '{"tag":"正面"}'` 定范围与裁剪，再 `calorie-cmd-read calorie.photo.gif --params '{"tag":"正面"}'` |
+| 7 | 删身材照 | 删身材照 → `calorie.photo.remove`（前置候选页） | 回执页（＋快照） | 先 `calorie-cmd-read calorie.view.photo-picker` 列候选→看快照→复制 prompt，再 `calorie-cmd-read calorie.photo.remove --params '{"id":1}'` |
+| 8 | 改照片标签（`op=set`） | 改照片标签 → `calorie.photo.tag`（`op=set`，先看原标签） | 回执页 | 先 `calorie-cmd-read calorie.view.photo-picker --params '{"id":1}'` 看原标签与快照，再 `calorie-cmd-read calorie.photo.tag --params '{"id":1,"op":"set","tag":"晨起"}'` |
+| 9 | 加照片标签（`op=add`） | 加照片标签 → `calorie.photo.tag`（`op=add`） | 回执页 | 先 `calorie-cmd-read calorie.view.photo-picker --params '{"id":1}'` 看快照，再 `calorie-cmd-read calorie.photo.tag --params '{"id":1,"op":"add","tag":"晨起"}'` |
+| 10 | 删照片标签（`op=remove`） | 删照片标签 → `calorie.photo.tag`（`op=remove`） | 回执页 | 先 `calorie-cmd-read calorie.view.photo-picker --params '{"id":1}'` 看原标签，再 `calorie-cmd-read calorie.photo.tag --params '{"id":1,"op":"remove","tag":"晨起"}'` |
+
+## 逐词工作流（每条从哪一步往下走）
+
+### 1 存一张照片
+
+- 用户说「记身材照」，要存一张。先问标签（D3：缺则追问）与来源（发图或路径，D2）。
+- 跑 `calorie-cmd-read calorie.photo.add --params '{"srcPaths":["<照片路径>"],"tag":"正面"}'`。
+- 回执页核对 id 卡＋明细＋间隔行；跑完把 HTML 交给用户（D7）。
+
+### 2 存照片（含备注）
+
+- 同场景 1，另问备注（如当时状态／饮食阶段），随 `--note` 入库。
+- 跑同一条 `calorie.photo.add`；回执多一行备注；跑完把 HTML 交给用户（D7）。
+
+### 3 批量存照片
+
+- 用户连发多张或给多个路径即批量（D2：同轮所有图片＝本次要存的照片）。
+- 每张可单独指定标签，没指定的用默认标签（D3 逐张追问）。
+- 跑 `calorie.photo.add`（多 `srcPaths`）；回执看 `items[]` 逐张状态；跑完把 HTML 交给用户（D7）。
+- 预检确认页可用 `calorie-cmd-read calorie.view.photo-log-wizard`（四段表单＋prompt 生成，缺项为指步骤占位句；老技能没有唤醒词，故用页面本身的叫法）。
+
+### 4 看身材照
+
+- 用户说「查身材照」，想浏览。时间可用天数／日期／范围，没填默认最近 90 天；标签选填。
+- 跑 `calorie-cmd-read calorie.photo.list --params '{"tag":"正面"}'` 看画廊（筛选＋体积横幅＋网格三态）。
+- 单张大图跑 `calorie-cmd-read calorie.photo.detail --params '{"id":1}'`（单图页：黑底 75vh contain，上一张／下一张首尾禁用，删改链走回执流程）。
+- 卡路里HELP跑 `calorie-cmd-read calorie.help.center --params '{"q":"记身材照"}'`（结果型；`q` 与 `mode` 互斥）；不出参数（缺省）就是老技能同款 HELP 文件。
+
+### 5 对比两张照片
+
+- 用户说「对比两张照片」。可说日期（如月初 vs 月底）、编号，或从最近照片里选（选不出来先跑候选页）。
+- 跑 `calorie-cmd-read calorie.photo.compare --params '{"id1":1,"id2":2}'`；读间隔 N 天横幅＋跨标签警告行；跑完把 HTML 交给用户（D7）。
+
+### 6 生成身材照GIF
+
+- 用户说「生成身材照GIF」。先确认照片范围（标签／时间），前置跑 `calorie-cmd-read calorie.view.gif-planner --params '{"tag":"正面"}'`（GIF 规划页：候选表＋裁剪 JSON＋prompt 生成）。
+- 再跑 `calorie-cmd-read calorie.photo.gif --params '{"tag":"正面"}'` 出 GIF 结果页（过大降级给本地路径，缺值 `—`）；跑完把 HTML 交给用户（D7）。
+
+### 7 删身材照
+
+- 用户说「删身材照」（删除后无法恢复）。若没说清哪张，先跑 `calorie-cmd-read calorie.view.photo-picker`（候选页：列候选缩略图＋日期＋标签→选中看快照→复制 prompt）。
+- 快照只读，不含删除动作；核对无误后跑 `calorie-cmd-read calorie.photo.remove --params '{"id":1}'`。
+- 回执为删除态徽章＋删前快照；跑完把 HTML 交给用户（D7）。
+
+### 8 改照片标签
+
+- 用户说「改照片标签」：整套覆盖（可多个）。先跑 `calorie-cmd-read calorie.view.photo-picker --params '{"id":1}'` 确认该照片原来的完整标签列表与快照。
+- 再跑 `calorie-cmd-read calorie.photo.tag --params '{"id":1,"op":"set","tag":"晨起"}'`；对照行读改前改后；跑完把 HTML 交给用户（D7）。
+
+### 9 加照片标签
+
+- 用户说「加照片标签」：追加不覆盖（可多个）。先跑候选页看快照。
+- 再跑 `calorie-cmd-read calorie.photo.tag --params '{"id":1,"op":"add","tag":"晨起"}'`；已存在即提示判重；对照行读加前加后；跑完把 HTML 交给用户（D7）。
+
+### 10 删照片标签
+
+- 用户说「删照片标签」：移除（可多个），其余保留。先跑候选页告诉用户当前有哪些标签。
+- 再跑 `calorie-cmd-read calorie.photo.tag --params '{"id":1,"op":"remove","tag":"晨起"}'`；每张至少保留 1 个，删空报错，想清空用改照片标签；对照行读删除前删除后；跑完把 HTML 交给用户（D7）。
+
+## 过程型页入口一览（写前先出页）
+
+- 预检确认页：`calorie-cmd-read calorie.view.photo-log-wizard`（记身材照纯配置；缺项指步骤占位）。
+- GIF 规划页：`calorie-cmd-read calorie.view.gif-planner --params '{"tag":"正面"}'`（查身材照／生成身材照GIF；框选＋4 数字裁剪）。
+- 候选页：`calorie-cmd-read calorie.view.photo-picker`（删身材照与标签三条的候选快照；老技能这三个页面是流程内页、没有唤醒词，命令名 `calorie.view.photo-picker` 由 #283 冻结；无 id 时为指步骤占位，复制的即写命令照抄即跑形状）。
+
+## 老技能对账：场景 09 的唤醒词只有 8 个
+
+老技能 `scripts/_triggers.py` 场景 09 的唤醒词逐条为：记身材照／查身材照／对比两张照片／生成身材照GIF／删身材照／改照片标签／加照片标签／删照片标签。真名另有 `存身材照`（`_triggers.py:2669` 子功能名）与 `看身材照`（`_triggers.py:2699` name＋`body_photo_gallery.html:7` 标题）。本件与 SKILL.md 只用这些词；预检确认页／GIF 规划页／候选页这三个页面名不是唤醒词，也不当入口词用（逐词对账读数见 `docs/skills/skill-calorie/t450-词表订正.md`）。
+「卡路里HELP」是老技能正文注册的唤醒词（老 `SKILL.md:5/291/299`，v2.4.10 起），故 `calorie.help.center` 的代表唤醒词用它。

package/dist/render/profilePlate.d.ts

@@ -1,17 +0,0 @@
-/** #41 · 档案读链 render 数据（profile/档案视图，旧 profile 查档案）。
- *
- * 数据源：fetch/profile.getProfile（单例 id=1，无行即 missing）+
- * fetch/nutritionGoal.getNutritionGoal（可选）+ weight_log 最新一条（可选）。
- * 写链（profile.set/activity/update）已由 #40 承接，本票只补看链。
- */
-import type { DatabaseSync } from 'node:sqlite';
-import type { ProfileRow } from '../fetch/profile.js';
-import type { NutritionGoalRow } from '../fetch/nutritionGoal.js';
-export interface ProfileView {
-    profile: ProfileRow;
-    nutrition: NutritionGoalRow | null;
-    latestWeightKg: number | null;
-    hasGoal: boolean;
-}
-export declare function buildProfileView(db: DatabaseSync): ProfileView;
-//# sourceMappingURL=profilePlate.d.ts.map

package/dist/render/profilePlate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"profilePlate.d.ts","sourceRoot":"","sources":["../../src/render/profilePlate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,WAAW,CAa9D"}

package/dist/render/profilePlate.js

@@ -1,18 +0,0 @@
-import { getProfile } from '../fetch/profile.js';
-import { getNutritionGoal } from '../fetch/nutritionGoal.js';
-import { CalorieRenderError } from './errors.js';
-export function buildProfileView(db) {
-    const profile = getProfile(db);
-    if (!profile)
-        throw new CalorieRenderError('missing-data', '未设档案（user_profile#1 缺失，先设置档案）');
-    const nutrition = getNutritionGoal(db);
-    let latest;
-    try {
-        latest = db.prepare('SELECT weight_kg FROM weight_log ORDER BY date DESC, id DESC LIMIT 1').get();
-    }
-    catch {
-        latest = undefined;
-    }
-    return { profile, nutrition, latestWeightKg: latest?.weight_kg ?? null, hasGoal: nutrition !== null };
-}
-//# sourceMappingURL=profilePlate.js.map

package/dist/render/profilePlate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"profilePlate.js","sourceRoot":"","sources":["../../src/render/profilePlate.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AASjD,MAAM,UAAU,gBAAgB,CAAC,EAAgB;IAC/C,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,+BAA+B,CAAC,CAAC;IAC5F,MAAM,SAAS,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACvC,IAAI,MAAyC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,sEAAsE,CAAC,CAAC,GAAG,EAElF,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,IAAI,IAAI,EAAE,OAAO,EAAE,SAAS,KAAK,IAAI,EAAE,CAAC;AACxG,CAAC"}