skill-calorie 0.2.3 → 0.2.5

package/dist/photo/photoUi.js

@@ -0,0 +1,233 @@
+/** #526 · 身材照片**读侧族**的页内形状件（唯一产出者）：把原来靠 `·`／`；`／`／`／`、` 串起来的正文，
+ *  落成有形状的元素。负责人口径（2026-09-15 第 2／5 条）与同型先例：`src/weight/weightUi.ts`、
+ *  `src/exercise/sportUi.ts`——三族共用同一套口径，样式各住各的件。
+ *
+ * ── 为什么有这一件（第 5 条，逐字）──
+ *  「当一个内容需要通过 `；` 和 `·` 分割时代表需要进行 UI 上的设计，该问题是用这些符号简化了 UI 展示的设计」。
+ *  读侧四页（看身材照／查身材照两态／对比两张照片）改前节点级命中 59 处：图注 `日期 · 标签 · 相对时间`
+ *  三件事串一行、`← 上一张 #16 · 下一张 #23 →` 两个动作串一行、KPI 明细 `8 张找不到文件 · 10 张太大未显示`
+ *  两件事串一行、缺失清单 `#16 · 文件名 · 徽标` 三件事串一行。本件给它们各自的形状：
+ *    - 并列小标签（编号／标签／相对时间／筛选／窗口）→ **`renderChips` 徽章列**（公共层件，本件只给容器）；
+ *    - 「名字 ＋ 值」这类事实（原图大小／文件／备注名）→ `factRows()` 键值行；
+ *    - 用户自己用斜杠连写的备注 → `noteSegments()` 分段（**同一件事换形状，不改一个字的用户数据**）；
+ *    - 间隔天数 ＋ 两张日期 → `intervalStrip()`（大数字 ＋ 两枚日期块）。
+ *  一条也不许再退回符号串：判据是 `scripts/audit-separators.mjs` 的**节点级命中共零**。
+ *
+ * ── 手机端口径照 HELP 页（断点 820，四条固定手法）──
+ *   ① 触摸目标 ≥44px、`-webkit-tap-highlight-color:transparent`、`touch-action:manipulation`；
+ *   ② 横向一行在窄屏塌成纵向一列（图注的键值行、间隔条都不例外）；
+ *   ③ 窄屏收紧内距、字号落**三级梯度**——标题 15／正文 14／辅助 12（px，全档 ≥12 下限，与
+ *      `weightUi`／`sportUi` 同一「不新造空档」的口径）；
+ *   ④ 窄屏表格给「可以左右滑」这一行提示（`.phu-scroll-hint`，桌面不出）。
+ *  共享区块自带的 **640** 段不撤：820 管本件自造的件，640 管共享件，两段同向、不打架。
+ *
+ * ── 与公共层的边界（不许越）──
+ *  本件只产**本族专属**的类（`phu-` 前缀）与容器；徽章走 `base-paint/blocks` 的 `renderChips`，
+ *  状态徽标走 `base-paint` 的 `renderStatusBadge`，卡片／表／复制区一律走公共层——本件不自造第二份。
+ *  `packages/base-render/**` 归 #525，本族一行不碰。
+ *
+ * 用法：`photoUiCss()` 返回 `<style>` 串，由本族三个整页装配放进 `parts` 的第一项
+ * （`assembleDocPage` 没有页内 CSS 入口，同 `weightUi.ts` 的处置）。
+ */
+import { escapeHtml, renderStatusBadge } from 'base-paint';
+import { renderChips } from 'base-paint/blocks';
+const esc = (s) => escapeHtml(s);
+/** 用户备注里的**并列分隔符集**：与判据工具 `audit-separators.mjs` 的 `PARALLEL` 同源（同一件事
+ *  只有一份定义地，抄散了两边迟早走散）。命中即在该处换形状——不是删字符，是把连写拆成段。 */
+const PARALLEL_RE = /[·；;｜|／/、＋]/;
+/** 形状词汇的 CSS（冻结 token；不新增 `:root` 变量、不新造断点）。 */
+export function photoUiCss() {
+    return '<style>'
+        // ── 徽章行（并列小标签）：容器只给间距，徽章本身就是公共层件 ──
+        + '.phu-chips{margin:0 0 12px}'
+        // ── 键值行：「名字 ＋ 值」，一行一件事 ──
+        + '.phu-facts{margin:0}'
+        + '.phu-fact{display:flex;gap:12px;align-items:baseline;padding:8px 0;border-top:1px solid var(--line);min-width:0}'
+        + '.phu-fact:first-child{border-top:0;padding-top:0}'
+        + '.phu-fk{flex:0 0 72px;font-size:12px;color:var(--fg3)}'
+        + '.phu-fv{font-size:14px;color:var(--fg);min-width:0;overflow-wrap:anywhere}'
+        // ── 备注分段：用户自己用斜杠连写的几件事，按段落到位（视觉上仍是一行，段间是细线不是符号）──
+        + '.phu-segs{display:flex;flex-wrap:wrap;align-items:baseline}'
+        + '.phu-seg{font-size:14px;overflow-wrap:anywhere}'
+        + '.phu-seg + .phu-seg{padding-left:8px;margin-left:8px;border-left:1px solid var(--line)}'
+        // ══ 字号三级梯度（2026-09-15 收口 · #526 版面档复评「② 信息层级与版式细调 78」的扣分项）══
+        //  定档（照片族四页**唯一**的字号表，不新造第四档，不写 12.5 这类空档；全档 ≥12px 下限）：
+        //    L1 15px＝**标题档**：一张照片的拍下时刻（`.phu-when`）、间隔条两端的日期（`.phu-date`）、
+        //       页内定位条上的动作（`[data-nav] a`）；
+        //    L2 14px＝**正文档**：键值行的值（`.phu-fv`）、备注分段（`.phu-seg`）、要读者记住的那一份文件名
+        //       （`.phu-file code`）、大图页的动作说明句（`.phu-act-s`）；
+        //    L3 12px＝**辅助档**：键值行的名字（`.phu-fk`）、页脚细字（`.phu-note`）、窄屏表格提示、
+        //       占位框里那两句人话（公共层媒体占位件给的 13px／12px，本族在 §占位件收敛 里压到 12px 一档）。
+        //  为什么这么分（复评原话「文件名与说明字号接近、看不出层次」）：改前占位里「文件名」与「为什么／
+        //  下一步」同为 12px 左右、同一个视觉重量；改后文件名落到 L2 且用正文色（`--fg`），说明落到 L3
+        //  且用弱色（`--fg2`／`--fg3`），**层级由字号 ＋ 颜色两重拉开**，不靠把辅助字越缩越小。
+        // ── 画廊网格：等高卡片（`aspect-ratio` 定框），宽屏多列、390 宽两列 ──
+        + '.phu-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(168px,1fr));gap:12px;margin:0}'
+        + '.phu-card{display:flex;flex-direction:column;min-width:0;margin:0;background:var(--card);'
+        + 'border:1px solid var(--line);border-radius:14px;overflow:hidden}'
+        + '.phu-shot{position:relative;aspect-ratio:4/5;background:var(--soft);display:flex;'
+        + 'align-items:center;justify-content:center;overflow:hidden}'
+        // 图片容器有明确宽高比 ＋ `object-fit`：图按框裁切，绝不按天然像素撑破容器（高度的 `auto` 落在内联那侧）。
+        + '.phu-shot img{display:block;width:100%;height:100%;object-fit:cover}'
+        + '.phu-cap{display:flex;flex-direction:column;gap:6px;padding:8px 10px 10px;min-width:0}'
+        + '.phu-when{font-size:15px;font-weight:600;color:var(--fg);font-variant-numeric:tabular-nums}'
+        + '.phu-file{display:flex;flex-wrap:wrap;align-items:center;gap:6px;min-width:0}'
+        // L2：文件名是这一格**要读者记住的那一件事**（占位态里就是「哪一份文件」，图在时是「这张图存在哪」），
+        // 故走正文档 14px ＋ 正文色；它与 L1 时刻（15px）差 1px，靠粗细（600 对 400）与等宽字再分一层。
+        // （#526 · t524 §3.2「390 档正文类 ≥12px」在这条上仍然成立：14px。）
+        + '.phu-file code{font-size:14px;color:var(--fg);overflow-wrap:anywhere}'
+        // 占位（没图的那张）走公共层同规格媒体占位件（`renderMediaPlaceholder`，见 `galleryDoc.figureHtml`）。
+        // 下面三条把公共件**收敛进本族的格位**里，明细见「占位件收敛」那一段的注释。
+        + '/* 占位件收敛（公共件 ＋ 本族格位） */'
+        // ① 格位（`.phu-shot`）是网格里的**等高框**：`aspect-ratio` 定第一次布局，`stretch` 只改高度。
+        + '.phu-grid .phu-shot,.phu-compare .phu-shot{position:relative;aspect-ratio:4/5}'
+        + '.phu-grid .phu-shot>.ilife-block-media,.phu-compare .phu-shot>.ilife-block-media,.phu-hero-miss>.ilife-block-media{margin:0}'
+        // ② 框体铺满格位；本族格位已经有比例，故不叠公共层那条 `4/5`，高度全交给外层。
+        + '.phu-grid .phu-shot>.ilife-block-media>.ilife-block-media-frame,.phu-compare .phu-shot>.ilife-block-media>.ilife-block-media-frame,.phu-hero-miss>.ilife-block-media>.ilife-block-media-frame{position:absolute;inset:0;aspect-ratio:auto}'
+        // ③ 框内两句人话：主句（哪一份文件 ＋ 为什么）走辅助档 12px，次句（下一步）再弱一档、字号同档。
+        + '.phu-grid .ilife-block-media-empty,.phu-grid .ilife-block-media-reason,.phu-compare .ilife-block-media-empty,.phu-compare .ilife-block-media-reason,.phu-hero-miss .ilife-block-media-empty,.phu-hero-miss .ilife-block-media-reason{font-size:12px}'
+        + '.phu-grid .ilife-block-media-frame-empty,.phu-compare .ilife-block-media-frame-empty,.phu-hero-miss .ilife-block-media-frame-empty{font-size:12px}'
+        // ── 对比并排（对比页）：两栏**等高**（`align-items:stretch` 是默认值，这里显式写出来，
+        //  说明它是判据）；卡内图注（`.phu-cap`）与占位舞台吃掉剩余高度，两栏下沿齐平，
+        //  不出现「一边有图一边是占位、短的那栏底下一大片空灰」。
+        + '.phu-compare{display:flex;flex-wrap:wrap;align-items:stretch;gap:12px;margin:0}'
+        + '.phu-compare>.phu-card>.phu-cap{flex:1 1 auto}'
+        + '.phu-compare>.phu-card>.phu-shot{flex:1 1 auto;min-height:0}'
+        // ── 间隔条（对比页）：大数字 ＋ 两张日期块，原来挤在页头标题那句 `·` 串里 ──
+        + '.phu-interval{display:flex;flex-wrap:wrap;align-items:baseline;gap:8px 10px;margin:0 0 14px}'
+        + '.phu-iv-n{font-size:30px;font-weight:700;line-height:1.1;color:var(--fg);font-variant-numeric:tabular-nums}'
+        + '.phu-iv-u{font-size:14px;color:var(--fg2)}'
+        + '.phu-date{font-size:15px;font-weight:600;color:var(--fg);background:var(--card);border:1px solid var(--line);'
+        + 'border-radius:10px;padding:3px 9px;font-variant-numeric:tabular-nums}'
+        // ── 页内定位条（上一张／下一张）：`[data-nav]` 是三条既有判据认的锚（不加类名，改属性选择器）──
+        + '[data-nav]{display:flex;flex-wrap:wrap;gap:6px 16px;align-items:center;margin:0 0 12px}'
+        + '[data-nav] a{font-size:15px;font-weight:600;color:var(--blue2);text-decoration:none;'
+        + 'border:1px solid var(--line);border-radius:999px;padding:0 12px;background:var(--card)}'
+        + '[data-nav] a:hover{border-color:var(--blue2)}'
+        + '[data-nav] span[aria-disabled="true"]{font-size:15px;color:var(--fg3)}'
+        + '.phu-nav-id{color:var(--fg3);font-weight:400}'
+        // ── 大图舞台的占位态（查身材照）：黑底 75vh contain 是本页的既有观看口径（#473／#438），
+        // 只换「没图可看」那一态——虚线框＋浅底，写明哪一份文件、为什么、下一步 ──
+        + '.phu-hero-miss{min-height:200px;border:1px dashed var(--line);border-radius:14px;background:var(--soft)}'
+        // ── 动作块的说明句（「删掉这张照片」那一段）──
+        + '.phu-act-s{font-size:14px;color:var(--fg2);margin:0 0 10px}'
+        + '.phu-note{font-size:12px;color:var(--fg3);margin:8px 0 0}'
+        // ── 候选行（#527 规划器：一行一张照片）：编号槽 ＋ 文件槽 ＋ 状态槽，不靠 `·`／`#N` 串 ──
+        + '.phu-pl{border-top:1px solid var(--line)}'
+        + '.phu-pl:first-child{border-top:0}'
+        + '.phu-pl-row{display:flex;align-items:center;gap:10px;padding:10px 0;min-width:0}'
+        + '.phu-pl-n{flex:0 0 auto;min-width:64px;font-size:12px;color:var(--fg3);font-variant-numeric:tabular-nums}'
+        + '.phu-pl-file{flex:1 1 auto;min-width:0;font-size:13px;color:var(--fg);overflow-wrap:anywhere}'
+        + '.phu-pl-tag{flex:0 0 auto;font-size:12px;color:var(--fg2)}'
+        + '.phu-pl-meta{display:flex;flex-wrap:wrap;align-items:baseline;gap:4px 10px;padding:0 0 10px 74px;'
+        + 'font-size:12px;color:var(--fg3);font-variant-numeric:tabular-nums}'
+        // ── 候选卡的编号行（#527 删照候选页）：与画廊同一张卡（`.phu-card`＋`.phu-shot`＝等高格位），
+        //  格位里放真图或**同规格占位件**（`renderMediaPlaceholder`）；编号与标签走 L1／辅助两档。 ──
+        + '.phu-cap-no{font-size:15px;font-weight:600;color:var(--fg);font-variant-numeric:tabular-nums}'
+        // ── 节标题（删照候选页的两块：候选照片／快照）：同一页内两块的分界，走 L1 档 ＋ 上留白 ──
+        + '.phu-sec{font-size:15px;font-weight:600;color:var(--fg);margin:20px 0 10px}'
+        + '.phu-sec:first-child{margin-top:0}'
+        // ── 快照位（删前核对凭据）：大图 ＋ 框内摆法；`contain` 保「整张都看得见」（删前要认得出是它）──
+        + '.phu-snap{aspect-ratio:4/5;background:var(--soft);border:1px solid var(--line);border-radius:14px;'
+        + 'overflow:hidden;display:flex;align-items:center;justify-content:center;margin:0 0 12px}'
+        + '.phu-snap img{display:block;width:100%;height:100%;object-fit:contain}'
+        // ── 表格列头抬到 12px 下限（#527 · t524 §3.2）：共享块层在 ≥641 档给 `th` 11.5px、
+        //  ≤640 档给 11px，两档都低于本族页面正文的 12px 下限；本域页面自己把列头托起来
+        //  （只动字号，不动块层的色与层级账——列头仍是最浅最弱的那一档）。──
+        + '.ilife-block-data-table th{font-size:12px}'
+        // ── 触摸目标 ≥44px（#527 · t524 §3.2「两档都 0 处不足」）：共享块层的复制按钮／菜单项
+        //  在 >820 档只有 40px 高（390 档靠 #525 的 820 档配方已够）；本族页面自己把这两颗托到
+        //  44px（原地加高，不改块层的排布与配色）。──
+        + '.ilife-copy-btn,.ilife-copy-menu-item{min-height:44px}'
+        // ── GIF 舞台（#527）：图按 `1-1` 摆，占屏宽度给一个有上限的放大（#484 口径：合成的是
+        //  小方帧，不给上限放大会只占一小块屏；窄屏仍随容器收，`max-width:100%` 兜底在媒体件里）。
+        //  `image-rendering:pixelated` 保留 #484 的观感：放大后保持方帧锐边（不插值糊成一片）。──
+        + '.phu-gif-stage{max-width:300px}'
+        + '.phu-gif-stage .ilife-block-media-img{image-rendering:pixelated}'
+        // ── 窄屏表格提示：桌面不出，640 以下才出（表格本身照公共层的横滑口径走）──
+        + '.phu-scroll-hint{display:none}'
+        // ── 手机端（断点 820 = HELP）：留白收紧、字号落档、触摸面补齐 ──
+        + '@media (max-width:400px){'
+        // 读数卡在 390 档**保持两格并排**（本族四页的读数卡都是短值：一行两枚才撑得住首屏）。
+        // 公共层的 `pageUi` 在 ≤400 档把读数卡塌成单列（`pageUi.ts` ⑦：照 HELP 的同一条意图）；
+        // 但 HELP 的单列是给长文本卡用的，本族的卡只有「4 张／2026-07-17／8 张」这类短值——
+        // 单列时三张卡占 309px，首屏被卡占满、第一批图掉到第二屏（对抗审查必改 ③ 的原话）。
+        // 本族页内件按自己的内容把小屏档位就地收紧（不改公共层，不动公共层的断点值）。
+        + '  .ilife-block-page-shell-body .ilife-block-kpi-card-grid{grid-template-columns:repeat(2,minmax(0,1fr))}'
+        + '}'
+        + '@media (max-width:820px){'
+        + '  .phu-chips{margin-bottom:10px}'
+        // 390 档（内容宽 358）**稳定两列**：150＋150＋间距 10＝310 ≤358，余量 48px，卡片实测宽 174。
+        // 字号三级梯度在窄屏**按同一套 px 落下**（不缩档）：标题 15／正文 14／辅助 12——12px 是下限。
+        + '  .phu-grid{grid-template-columns:repeat(auto-fill,minmax(150px,1fr));gap:10px}'
+        + '  .phu-fk{flex-basis:64px}'
+        + '  .phu-iv-n{font-size:26px}'
+        + '  .phu-pl-row{min-height:44px;padding:6px 0;-webkit-tap-highlight-color:transparent}'
+        + '  .phu-pl-n{min-width:56px}'
+        + '  .phu-pl-meta{padding-left:66px}'
+        + '  [data-nav] a{min-height:44px;display:inline-flex;align-items:center}'
+        + '  .phu-card,[data-nav] a,.phu-date{-webkit-tap-highlight-color:transparent;touch-action:manipulation}'
+        + '}'
+        + '@media (max-width:640px){'
+        + '  .phu-scroll-hint{display:block;margin:6px 0 0;font-size:12px;color:var(--fg3)}'
+        + '  .ilife-block-data-table th{font-size:12px}'
+        // 键值行在 390 宽塌成「名字在上、值在下」：原来左栏 64px 会把值挤成一条窄柱。
+        + '  .phu-fact{flex-direction:column;gap:2px}'
+        + '  .phu-fk{flex:0 0 auto}'
+        + '}'
+        + '</style>';
+}
+/** 徽章列（页头身份行／图注元数据）：并列小标签一律走公共层 `renderChips`，本件只给容器。
+ *  空表＝空串（没内容不留空壳）。 */
+export function chipRow(items) {
+    const kept = items.filter((s) => s !== '');
+    if (kept.length === 0)
+        return '';
+    return '<div class="phu-chips">' + renderChips({ items: kept.map((text) => ({ text })) }) + '</div>';
+}
+/** 键值行（详情页「这张照片的信息」那一块）：一行一件事，窄屏塌成上下两行。空表＝空串。 */
+export function factRows(rows) {
+    const body = rows
+        .filter((r) => (r.vHtml ?? r.v ?? '') !== '')
+        .map((r) => '<div class="phu-fact"><span class="phu-fk">' + esc(r.k) + '</span>'
+        + '<span class="phu-fv">' + (r.vHtml ?? esc(r.v)) + '</span></div>')
+        .join('');
+    return body === '' ? '' : '<div class="phu-facts">' + body + '</div>';
+}
+/** 用户自己连写的文本 → 分段形状：命中并列分隔符即拆段，段间由细线分（**用户数据一字不改**，
+ *  只把「拿符号顶版面」换成「把版面画出来」）。无分隔符即原样一段。 */
+export function noteSegments(text) {
+    const segs = text.split(PARALLEL_RE).map((s) => s.trim()).filter((s) => s !== '');
+    if (segs.length === 0)
+        return '';
+    if (segs.length === 1)
+        return '<span class="phu-seg">' + esc(segs[0]) + '</span>';
+    return segs.map((s) => '<span class="phu-seg">' + esc(s) + '</span>').join('');
+}
+/** 间隔条（对比页）：大数字＋单位＋两张日期块——「间隔 N 天」原来只是页头标题里的半句话。 */
+export function intervalStrip(days, left, right) {
+    return '<div class="phu-interval">'
+        + '<span class="phu-date">' + esc(left) + '</span>'
+        + '<span class="phu-iv-n">' + String(days) + '</span>'
+        + '<span class="phu-iv-u">天</span>'
+        + '<span class="phu-date">' + esc(right) + '</span>'
+        + '</div>';
+}
+/** 候选行（#527 规划器）：原来六列表在窄屏被挤成长串，改「一行一张照片」——编号、文件名、
+ *  标签、异常徽标各占一槽，次要事实走第二行的徽章列。**不印 `#N`**（那是内部标识符口径），
+ *  改「照片 31」这种读者话；行高在 820 以下补到 44px 触摸面。 */
+export function photoPickRows(rows) {
+    const body = rows.map((r) => {
+        const badge = r.badge === undefined ? ''
+            : ' ' + renderStatusBadge({ status: r.badge.tone, text: r.badge.text });
+        const meta = r.meta === undefined || r.meta.length === 0
+            ? '' : '<div class="phu-pl-meta">' + renderChips({ items: r.meta.map((text) => ({ text })) }) + '</div>';
+        return '<li class="phu-pl"><div class="phu-pl-row">'
+            + '<span class="phu-pl-n">' + esc(r.no) + '</span>'
+            + '<span class="phu-pl-tag">' + esc(r.tag ?? '') + '</span>'
+            + '<span class="phu-pl-file">' + esc(r.file) + '</span>'
+            + badge + '</div>' + meta + '</li>';
+    }).join('');
+    return body === '' ? '' : '<ol class="phu-pl">' + body + '</ol>';
+}
+//# sourceMappingURL=photoUi.js.map

package/dist/photo/photoUi.js.map

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

package/dist/photo/photos.d.ts

@@ -0,0 +1,78 @@
+/** T4 #23 · body_photo_tracker 取数+写数（对照老家 scripts/body_photo_tracker.py）。
+ *
+ * 铁律：照片二进制只存路径 + 元数据（body_photos.photo_path 仅文件名，目录由配置文件的
+ * `photos.dir` 解析；缺失直接抛，不静默落盘）。gif 规划器只出任务描述
+ * （planGif），不跑图像处理。getLatestWeight 归 T3（weight_log），此处不碰。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+export declare const TAG_SEP = ",";
+export declare const TAG_MAX_LEN = 20;
+export declare const TAG_MAX_COUNT = 10;
+/** '正面, 侧面' → ['正面', '侧面']（去空白/去空项/去重保序）。 */
+export declare function parseTags(tagStr: string | null | undefined): string[];
+export declare function serializeTags(tags: string[]): string;
+/** 硬规则：非空 + 单个 ≤20 + 数量 ≤10（非法即抛）。 */
+export declare function validateTags(tags: string[]): string[];
+export declare function tagsContain(tagStr: string | null | undefined, tag: string): boolean;
+/** 配置里的照片目录（**唯一真相**：`calorie.yaml` 的 `photos.dir`；空串＝这一项还没配）。 */
+export declare function configuredPhotosDir(): string;
+/** 照片目录解析：显式传参 > 配置文件 `photos.dir`；缺失抛（不静默落盘），报错写明去哪配。 */
+export declare function resolvePhotosDir(dir?: string | null): string;
+export interface PhotoRow {
+    id: number;
+    date: string;
+    time: string | null;
+    photo_path: string;
+    tag: string;
+    note: string | null;
+    created_at: string | null;
+    tag_list: string[];
+}
+export declare function getPhotoRow(db: DatabaseSync, id: number): PhotoRow | null;
+export interface ListPhotosFilter {
+    days?: number;
+    tag?: string | null;
+    dateFrom?: string | null;
+    dateTo?: string | null;
+    limit?: number | null;
+    today?: string;
+}
+export declare function listPhotos(db: DatabaseSync, filter?: ListPhotosFilter): PhotoRow[];
+export declare function daysSinceTagPhoto(db: DatabaseSync, tag: string, beforeDate: string): number | null;
+export interface AddPhotosInput {
+    srcPaths: string[];
+    tag: string;
+    note?: string;
+    today?: string;
+    nowTime?: string;
+}
+/** 添加照片：文件复制进目录 + 落库（仅文件名入库）。不存在的源文件跳过。 */
+export declare function addPhotos(db: DatabaseSync, photosDir: string, input: AddPhotosInput): Array<{
+    id: number;
+    file: string;
+}>;
+export declare function deletePhoto(db: DatabaseSync, photosDir: string, id: number): {
+    deleted: boolean;
+    fileDeleted: boolean;
+};
+export declare function updateTag(db: DatabaseSync, id: number, newTag: string): boolean;
+/** 追加标签（判重）；返回新增标签数（不存在的照片回 0）。 */
+export declare function tagAdd(db: DatabaseSync, id: number, tag: string): number;
+/** 移除单个标签（至少保留 1 个；一次只删 1 个）。 */
+export declare function tagRemove(db: DatabaseSync, id: number, tag: string): boolean;
+export interface GifPlanInput {
+    tag: string;
+    dateFrom?: string | null;
+    dateTo?: string | null;
+    days?: number | null;
+}
+/** gif 规划器：只出任务描述（起止、张数、标签），不跑图像处理、不碰二进制。 */
+export declare function planGif(db: DatabaseSync, input: GifPlanInput): {
+    task: 'generate_gif';
+    tag: string;
+    dateFrom: string | null;
+    dateTo: string | null;
+    photoCount: number;
+    photoIds: number[];
+};
+//# sourceMappingURL=photos.d.ts.map

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

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

package/dist/photo/photos.js

@@ -0,0 +1,194 @@
+import { cpSync, existsSync, mkdirSync, rmSync } from 'node:fs';
+import { basename, join, resolve } from 'node:path';
+import { FetchError } from '../fetch/errors.js';
+import { loadCalorieConfig } from '../config.js';
+import { shiftISODate, timeOfDayISO, todayISO } from '../shared/time.js';
+export const TAG_SEP = ',';
+export const TAG_MAX_LEN = 20;
+export const TAG_MAX_COUNT = 10;
+/** '正面, 侧面' → ['正面', '侧面']（去空白/去空项/去重保序）。 */
+export function parseTags(tagStr) {
+    const seen = new Set();
+    const out = [];
+    for (const t of String(tagStr ?? '').split(TAG_SEP)) {
+        const s = t.trim();
+        if (!s || seen.has(s))
+            continue;
+        seen.add(s);
+        out.push(s);
+    }
+    return out;
+}
+export function serializeTags(tags) {
+    return tags.join(TAG_SEP);
+}
+/** 硬规则：非空 + 单个 ≤20 + 数量 ≤10（非法即抛）。 */
+export function validateTags(tags) {
+    if (tags.length === 0)
+        throw new FetchError('标签必填，当前是空列表');
+    for (const t of tags) {
+        if (t.length > TAG_MAX_LEN)
+            throw new FetchError('标签太长(' + t.length + ' > ' + TAG_MAX_LEN + '): ' + t);
+    }
+    if (tags.length > TAG_MAX_COUNT)
+        throw new FetchError('标签数量太多(' + tags.length + ' > ' + TAG_MAX_COUNT + ')');
+    return tags;
+}
+export function tagsContain(tagStr, tag) {
+    return parseTags(tagStr).includes(tag);
+}
+/** 配置里的照片目录（**唯一真相**：`calorie.yaml` 的 `photos.dir`；空串＝这一项还没配）。 */
+export function configuredPhotosDir() {
+    return loadCalorieConfig().values.photos.dir;
+}
+/** 照片目录解析：显式传参 > 配置文件 `photos.dir`；缺失抛（不静默落盘），报错写明去哪配。 */
+export function resolvePhotosDir(dir) {
+    const raw = (dir ?? configuredPhotosDir()).trim();
+    if (!raw) {
+        throw new FetchError('照片目录未配置：请先在卡路里设置页里填「照片目录」（配置文件 calorie.yaml 的 photos.dir），'
+            + '或本次调用直接传 photosDir 参数；填了才落盘，不猜路径。');
+    }
+    mkdirSync(raw, { recursive: true });
+    return resolve(raw);
+}
+const PHOTO_COLS = 'id, date, time, photo_path, tag, note, created_at';
+function toRow(r) {
+    return { ...r, tag_list: parseTags(r.tag) };
+}
+export function getPhotoRow(db, id) {
+    const row = db.prepare('SELECT ' + PHOTO_COLS + ' FROM body_photos WHERE id = ?').get(id);
+    return row ? toRow(row) : null;
+}
+/* #717 批③·时钟归一：本件原先自写 `todayISO` ＋ `shiftISODate`（又一份副本），
+   两个定义成对去掉、改读共用位 `shared/time.js`。 */
+export function listPhotos(db, filter = {}) {
+    const days = filter.days ?? 7;
+    const where = [];
+    const params = [];
+    if (filter.dateFrom) {
+        where.push('date >= ?');
+        params.push(filter.dateFrom);
+    }
+    if (filter.dateTo) {
+        where.push('date <= ?');
+        params.push(filter.dateTo);
+    }
+    if (!filter.dateFrom && !filter.dateTo) {
+        where.push('date >= ?');
+        params.push(shiftISODate(filter.today ?? todayISO(), -days));
+    }
+    const rows = db
+        .prepare('SELECT ' + PHOTO_COLS + ' FROM body_photos WHERE ' + where.join(' AND ') + ' ORDER BY date DESC, time DESC')
+        .all(...params);
+    let out = rows.map(toRow);
+    if (filter.tag)
+        out = out.filter((r) => tagsContain(r.tag, filter.tag));
+    const limit = filter.limit ?? 100;
+    if (limit)
+        out = out.slice(0, limit);
+    return out;
+}
+export function daysSinceTagPhoto(db, tag, beforeDate) {
+    const rows = db
+        .prepare('SELECT id, tag, date FROM body_photos WHERE date < ? ORDER BY date DESC, time DESC')
+        .all(beforeDate);
+    for (const r of rows) {
+        if (tagsContain(r.tag, tag)) {
+            const delta = Math.round((Date.parse(beforeDate + 'T12:00:00Z') - Date.parse(r.date + 'T12:00:00Z')) / 86400000);
+            return delta >= 0 ? delta : null;
+        }
+    }
+    return null;
+}
+/** 添加照片：文件复制进目录 + 落库（仅文件名入库）。不存在的源文件跳过。 */
+export function addPhotos(db, photosDir, input) {
+    const tags = validateTags(parseTags(input.tag));
+    const serialized = serializeTags(tags);
+    const today = input.today ?? todayISO();
+    const now = input.nowTime ?? timeOfDayISO();
+    const cnt = db.prepare('SELECT COUNT(*) AS n FROM body_photos WHERE date = ?').get(today);
+    const added = [];
+    let i = 0;
+    for (const srcPath of input.srcPaths) {
+        if (!existsSync(srcPath))
+            continue;
+        const ext = srcPath.slice(srcPath.lastIndexOf('.')).toLowerCase();
+        const destName = today + '_' + String(cnt.n + i + 1).padStart(3, '0') + ext;
+        cpSync(srcPath, join(photosDir, destName));
+        const run = db
+            .prepare('INSERT INTO body_photos (date, time, photo_path, tag, note) VALUES (?, ?, ?, ?, ?)')
+            .run(today, now, destName, serialized, input.note ?? '');
+        added.push({ id: Number(run.lastInsertRowid), file: destName });
+        i += 1;
+    }
+    return added;
+}
+export function deletePhoto(db, photosDir, id) {
+    const row = db.prepare('SELECT photo_path FROM body_photos WHERE id = ?').get(id);
+    if (!row)
+        return { deleted: false, fileDeleted: false };
+    db.prepare('DELETE FROM body_photos WHERE id = ?').run(id);
+    const file = join(photosDir, basename(row.photo_path));
+    if (existsSync(file)) {
+        rmSync(file);
+        return { deleted: true, fileDeleted: true };
+    }
+    return { deleted: true, fileDeleted: false };
+}
+export function updateTag(db, id, newTag) {
+    const row = db.prepare('SELECT id FROM body_photos WHERE id = ?').get(id);
+    if (!row)
+        return false;
+    const serialized = serializeTags(validateTags(parseTags(newTag)));
+    db.prepare('UPDATE body_photos SET tag = ? WHERE id = ?').run(serialized, id);
+    return true;
+}
+/** 追加标签（判重）；返回新增标签数（不存在的照片回 0）。 */
+export function tagAdd(db, id, tag) {
+    const photo = getPhotoRow(db, id);
+    if (!photo)
+        return 0;
+    const tags = validateTags(parseTags(tag));
+    const existing = [...photo.tag_list];
+    let added = 0;
+    for (const t of tags) {
+        if (existing.includes(t))
+            continue;
+        existing.push(t);
+        added += 1;
+    }
+    if (added === 0)
+        return 0;
+    db.prepare('UPDATE body_photos SET tag = ? WHERE id = ?').run(serializeTags(existing), id);
+    return added;
+}
+/** 移除单个标签（至少保留 1 个；一次只删 1 个）。 */
+export function tagRemove(db, id, tag) {
+    const photo = getPhotoRow(db, id);
+    if (!photo)
+        return false;
+    const tags = parseTags(tag);
+    if (tags.length !== 1)
+        throw new FetchError('删标签一次只删 1 个，收到 ' + tags.length + ' 个');
+    const existing = [...photo.tag_list];
+    const rm = tags[0];
+    if (!existing.includes(rm))
+        return false;
+    if (existing.length <= 1)
+        throw new FetchError('每张照片至少保留 1 个标签');
+    db.prepare('UPDATE body_photos SET tag = ? WHERE id = ?').run(serializeTags(existing.filter((t) => t !== rm)), id);
+    return true;
+}
+/** gif 规划器：只出任务描述（起止、张数、标签），不跑图像处理、不碰二进制。 */
+export function planGif(db, input) {
+    const photos = listPhotos(db, { tag: input.tag, dateFrom: input.dateFrom, dateTo: input.dateTo, days: input.days ?? 30, limit: null });
+    return {
+        task: 'generate_gif',
+        tag: input.tag,
+        dateFrom: photos.length > 0 ? photos[photos.length - 1].date : null,
+        dateTo: photos.length > 0 ? photos[0].date : null,
+        photoCount: photos.length,
+        photoIds: photos.map((p) => p.id),
+    };
+}
+//# sourceMappingURL=photos.js.map

package/dist/photo/photos.js.map

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

package/dist/photo/picker.d.ts

@@ -0,0 +1,41 @@
+/** #283 · 删身材照候选与快照（只读过程型页的取数＋prompt）。
+ *
+ * 服务「删身材照」与标签三条（改／加／删照片标签）：先列候选（缩略图＋日期＋标签）
+ * → 选中一张看快照 → 复制 prompt → 才走写命令（老技能 D6 三步，
+ * `SKILL.md:1193`「先列候选 → 快照确认 → 回执」）。
+ * 本件只做取数与 prompt 组装；整页文档见 `pickerDoc.ts`。快照只读，不含删除动作
+ * （删除走 `calorie.photo.remove` 写命令；t400 裁定 2 prompt 即 CLI、裁定 4 快照只读必读）。
+ * 空库即抛（缺失阻断不返空，exit 4，不落盘）；参数非法即抛 bad-input（exit 2）。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import { type PhotoCard } from './photo.js';
+export type PickerAction = 'remove' | 'tag';
+export type PickerTagOp = 'set' | 'add' | 'remove';
+export interface PhotoPickerView {
+    readonly candidates: PhotoCard[];
+    readonly fullCount: number;
+    readonly truncated: boolean;
+    readonly filtersDesc: string;
+    readonly selected: PhotoCard | null;
+    readonly selectedInList: boolean;
+    readonly action: PickerAction;
+    readonly prompt: string;
+}
+/** 候选缺省与上限（t341 体积节口径沿用：单页 1 MiB 只容 3~4 张实拍直嵌，候选不无脑全嵌）。 */
+export declare const PICKER_DEFAULT_LIMIT = 20;
+export declare const PICKER_MAX_LIMIT = 100;
+/** prompt 预览：有已选 ID 即 bash 可执行 CLI；缺项即指到步骤的占位句（t400 裁定 2）。
+ *  人话口径（#474）：命令段本身（`calorie-cmd-read …` 与 `--params` JSON）是给 AI 的机器内容，
+ *  一律不改；只改**对着用户说的那几句**。 */
+export declare function buildPhotoPickerPrompt(input: {
+    selectedId: number | null;
+    action: PickerAction;
+    op: PickerTagOp | null;
+    newTag: string | null;
+}): string;
+/** `calorie.view.photo-picker` · 删照候选：候选列表＋单张快照＋可复制 prompt（只读）。 */
+export declare function viewPhotoPicker(params: Record<string, unknown>, db: DatabaseSync): {
+    data: Record<string, unknown>;
+    html: string;
+};
+//# sourceMappingURL=picker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"picker.d.ts","sourceRoot":"","sources":["../../src/photo/picker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAOpD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,KAAK,CAAC;AAC5C,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AA2CpC;;4BAE4B;AAC5B,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChG,GAAG,MAAM,CAgBT;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,YAAY,GAAG;IAClF,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAC7C,CAsDA"}