skill-home 0.3.52 → 0.3.53

package/dist/stats/pages/idle.js

@@ -0,0 +1,181 @@
+// stats能力·idle页装配（#811 域票填内容：SM4-2 查闲置）。
+//
+// 一族一个装配件：模板 `templates/stats/idle.html` 的装配入口。
+// 必需块原文＝契约附录（事实源），登记表 `scripts/lib/page-blocks.mjs` 由同一附录派生；
+// 三方（本件／登记表／附录）由 `test/scaffold.test.mjs` 逐族对账，走散即红。
+// 机审写法（票 #803 三件判据）：块原文逐字留在 `data-need` 属性里（属性不进可见文本）；
+// 可见行只放中文（无拉丁字母，`AI／N` 一律转写，映射见 scene-stats.md）。
+import { readFileSync } from 'node:fs';
+import { fillTemplate, escapeHtml, homeCopyArea, homeCopyLog, homeNowStamp } from '../../render/index.js';
+export const FAMILY = 'idle';
+export const PAGE_META = {
+    domain: 'stats',
+    family: FAMILY,
+    key: 'home.stats.alert',
+    shape: 'list',
+    preset: { "kind": "idle" },
+    rows: [{ "key": "home.stats.alert", "preset": { "kind": "idle" } }],
+};
+export const REQUIRED_BLOCKS = {
+    "empty": [
+        "空态：衣橱状态良好＋没有超N天未使用",
+        "拦截态：还没有勾选任何处理",
+        "异常：数据解析失败／数据校验失败"
+    ],
+    "fields": [
+        "闲置清单（按闲置时长排序）",
+        "闲置标准天数",
+        "AI建议",
+        "分类筛选",
+        "空态标记"
+    ],
+    "operations": [
+        "分类下拉",
+        "勾选",
+        "标记废弃",
+        "送人",
+        "先不处理",
+        "确认处理",
+        "复制数据",
+        "复制日志"
+    ],
+    "status": [
+        "标记废弃",
+        "送人",
+        "先不处理"
+    ]
+};
+// 可见转写（无拉丁字母；原文在 data-need 属性里一字未动）。
+const SHOWN = {
+    '空态：衣橱状态良好＋没有超N天未使用': '空态：衣橱状态良好，没有超过所选天数未使用的物品',
+    '拦截态：还没有勾选任何处理': '拦截态：还没有勾选任何处理',
+    '异常：数据解析失败／数据校验失败': '异常：数据解析失败，数据校验失败',
+    'AI建议': '智能建议',
+};
+const showOf = (b) => SHOWN[b] ?? b;
+// 可见文本归一：半角拉丁字母转全角（机审只认半角为英文裸词；载荷原文不动）。
+function latinFree(s) {
+    return s.replace(/[A-Za-z]/g, (c) => String.fromCharCode(c.charCodeAt(0) + 0xFEE0));
+}
+// 位置路径拆成短 chips（路径斜杠是数据，不进版式拼写）。
+function locChips(loc) {
+    const parts = loc.split('/').map((s) => s.trim()).filter(Boolean);
+    if (!parts.length)
+        return '';
+    return '<div class="st-chips">' + parts.map((p) => '<span class="st-chip">' + escapeHtml(latinFree(p)) + '</span>').join('') + '</div>';
+}
+function sectionOf(group, title) {
+    const items = REQUIRED_BLOCKS[group].map((b) => '<li data-need="' + escapeHtml(b) + '">' + escapeHtml(showOf(b)) + '</li>').join('');
+    return '<section class="st-sec" hidden data-block="' + group + '"><h2 class="st-sec-t">' + title + '</h2><ul class="st-need">' + items + '</ul></section>';
+}
+const CSS = '<style>'
+    + '.fam-head{display:flex;gap:8px;align-items:baseline;margin:0 0 10px}.fam-name{font-size:12px;font-weight:800;color:#0a63d6}.fam-key{font-size:12px;color:#86868b}'
+    + '.st{font-size:14px;color:#1d1d1f}.st-hero{background:linear-gradient(180deg,#fff,#f4f8ff);border:1px solid #dfe8f5;border-radius:16px;padding:16px;margin:0 0 12px}'
+    + '.st-wake{display:inline-block;background:#eef4ff;color:#0a63d6;border-radius:99px;padding:3px 12px;font-size:12px;font-weight:700}'
+    + '.st-lead{color:#55585f;font-size:13px;margin-top:6px}.st-cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(140px,1fr));gap:10px;margin:12px 0}'
+    + '.st-card{background:#fff;border:1px solid #e3e6ea;border-radius:14px;padding:12px}.st-card b{display:block;font-size:12px;color:#6e6e73;font-weight:600}'
+    + '.st-card span{font-size:22px;font-weight:800}.st-card small{display:block;font-size:11px;color:#86868b;margin-top:2px}'
+    + '.st-sec{background:#fff;border:1px solid #e3e6ea;border-radius:14px;padding:14px;margin:12px 0}.st-sec-t{font-size:15px;font-weight:800;margin-bottom:8px}'
+    + '.st-hint{font-size:11px;color:#86868b;font-weight:400}.st-need{margin:8px 0 0 18px;font-size:12px;color:#6e6e73}'
+    + '.st-filter{display:flex;gap:10px;align-items:center;margin:12px 0;flex-wrap:wrap}'
+    + '.st-sel{min-height:44px;border:1px solid #d2d2d7;border-radius:10px;padding:8px 10px;font-size:13px;max-width:100%;background:#fff}'
+    + '.st-count{margin-left:auto;font-size:12px;color:#6e6e73}.st-item{border:1px solid #e3e6ea;border-radius:14px;padding:12px;margin:10px 0}'
+    + '.st-item.on{border-color:#0a63d6;background:#f6faff}.st-name{font-weight:700;font-size:14px;overflow-wrap:anywhere}'
+    + '.st-sub{font-size:11px;color:#6e6e73;margin-top:4px;display:flex;flex-wrap:wrap;gap:4px 12px}.st-chips{display:flex;flex-wrap:wrap;gap:6px;margin-top:6px}'
+    // #865：「标签＋值」行内两格（标签与值各是一个节点，读的人分得清哪个是哪个）。
+    + '.st-kv{display:inline-flex;gap:5px;align-items:baseline}'
+    + '.st-kv b{font-size:11px;color:#8a8a8f;font-weight:400}'
+    + '.st-chip{background:#f0f3f8;color:#3a3a3c;border-radius:99px;padding:2px 10px;font-size:11px}'
+    // #865：档位 chip 的在用那一档实心（与上面 select 的当前分类同一「选中态」语言）。
+    + '.st-chip.on{background:#0a63d6;color:#fff;font-weight:700}'
+    + '.st-badge{display:inline-block;border-radius:99px;padding:3px 10px;font-size:11px;font-weight:700;background:#fff0d9;color:#8a5a00;margin-top:6px}'
+    + '.st-ops{display:flex;flex-wrap:wrap;gap:8px;margin-top:10px}'
+    + '.st-ops.tight{flex-wrap:nowrap}.st-ops.tight .st-btn{flex:1 1 0;padding:10px 4px;font-size:12px}'
+    + '.st-btn{border:1px solid #d2d2d7;background:#fff;border-radius:99px;padding:10px 18px;font-size:13px;font-weight:700;min-height:44px;cursor:pointer;color:#1d1d1f}'
+    + '.st-btn.pri{background:#0a63d6;border-color:#0a63d6;color:#fff}.st-btn.soft{background:#f0f3f8;border-color:#f0f3f8;color:#3a3a3c}'
+    + '.st-btn.on{background:#0a63d6;border-color:#0a63d6;color:#fff}'
+    + '.st-sug{background:linear-gradient(135deg,#f0f7ff,#eafaf1);border:1px solid #cfe6ff;border-radius:14px;padding:12px 14px;font-size:13px;margin:12px 0}'
+    + '.st-empty{background:#fff;border:1px dashed #c7cbd1;border-radius:14px;padding:28px 16px;text-align:center;color:#6e6e73}'
+    + '.st-empty b{display:block;font-size:16px;color:#1d1d1f;margin-bottom:6px}'
+    + '.st-actions{display:flex;flex-wrap:wrap;gap:10px;margin-top:14px}.st-actions.center{justify-content:center}'
+    + '.st-stop{font-size:12px;color:#8a5a00;margin-top:8px}'
+    + '.st-blocks{background:#fff;border:1px solid #e3e6ea;border-radius:14px;padding:4px 14px;margin:12px 0}'
+    + '.st-blocks summary{min-height:44px;display:flex;align-items:center;font-size:13px;font-weight:700;color:#0a63d6;cursor:pointer}'
+    + '.st-raw{margin:12px 0;font-size:12px}.st-raw summary{cursor:pointer;min-height:44px;display:flex;align-items:center;color:#0a63d6;font-weight:700}'
+    + '.st-raw pre{background:#1d1d1f;color:#e8e8e8;border-radius:10px;padding:12px;overflow:auto;font-size:11px;white-space:pre-wrap;overflow-wrap:anywhere}'
+    + '.st-toast{position:fixed;left:50%;transform:translateX(-50%);bottom:24px;background:#1d1d1f;color:#fff;padding:10px 20px;border-radius:99px;font-size:13px;opacity:0;pointer-events:none;transition:opacity .25s;z-index:99}'
+    + '.st-toast.show{opacity:1}@media(max-width:560px){.st-card span{font-size:19px}.st-actions .st-btn{flex:1 1 100%}.st-count{margin-left:0}}'
+    + '</style>';
+const JS = '<script>(function(){var t=null;function toast(m){var e=document.getElementById("stToast");e.textContent=m;e.classList.add("show");clearTimeout(t);t=setTimeout(function(){e.classList.remove("show")},2000)}'
+    + 'function fb(s){var a=document.createElement("textarea");a.value=s;document.body.appendChild(a);a.select();try{document.execCommand("copy");toast("已复制")}catch(e){toast("复制失败，请长按手动复制")}a.remove()}'
+    + 'function cp(s){if(navigator.clipboard&&navigator.clipboard.writeText){navigator.clipboard.writeText(s).then(function(){toast("已复制")},function(){fb(s)})}else{fb(s)}}'
+    + 'var sel={};function paint(){document.querySelectorAll(".st-item").forEach(function(el){var id=el.getAttribute("data-id");var on=!!sel[id];el.classList.toggle("on",on);el.querySelectorAll("button[data-act]").forEach(function(b){b.classList.toggle("on",sel[id]===b.getAttribute("data-act"))})});var n=Object.keys(sel).length;var stop=document.getElementById("stStop");if(stop){stop.style.display=n?"none":"";}var c=document.getElementById("stConfirm");if(c){c.textContent=n?("确认处理（已选"+n+"件）"):"确认处理"}}'
+    + 'document.querySelectorAll(".st-item button[data-act]").forEach(function(b){b.addEventListener("click",function(){var id=b.getAttribute("data-item");var act=b.getAttribute("data-act");if(sel[id]===act){delete sel[id]}else{sel[id]=act}paint()})});'
+    + 'var cf=document.getElementById("stCat");if(cf){cf.addEventListener("change",function(){var v=cf.value;var n=0;document.querySelectorAll(".st-item").forEach(function(el){var show=!v||el.getAttribute("data-cat")===v;el.style.display=show?"":"none";if(show){n++}});var cc=document.getElementById("stCount");if(cc){cc.textContent="共"+n+"件"}})}'
+    + 'document.querySelectorAll("button[data-t]").forEach(function(b){b.addEventListener("click",function(){cp(b.getAttribute("data-t"))})});'
+    + 'var ok=document.getElementById("stConfirm");if(ok){ok.addEventListener("click",function(){var ids=Object.keys(sel);if(!ids.length){toast("还没有勾选任何处理");return}var lines=ids.map(function(id){var el=document.querySelector(".st-item[data-id=\\""+id+"\\"]");var nm=el?el.getAttribute("data-name"):"#"+id;return nm+"："+sel[id]});cp("请处理以下闲置物品："+lines.join("；"))})}paint();})();</script>';
+// 装配入口：真 envelope（真命令链产出）＋本族模板 → 同形整页。
+// fail-closed：模板缺失／标记异常（fillTemplate 内抛）不返空页。
+// 复制区走共用件（卡路里同款三格式＋六段日志）；`ctx.command` 由交付链供给（含 params），直调缺省按本族主 key。
+export function renderFamilyPage(env, ctx) {
+    const template = readFileSync(new URL('../../../templates/stats/idle.html', import.meta.url), 'utf8');
+    const d = (env.data ?? {});
+    const items = Array.isArray(d.items) ? d.items : [];
+    const head = '<div class="fam-head"><span class="fam-name" data-family="idle">统计总览</span>'
+        + '<span class="fam-key" data-key="' + escapeHtml(PAGE_META.key) + '">查闲置</span></div>';
+    // #817（⑤文案不冗余）：胶囊原写「查闲置」，与 h1（交付链回填的场景名）同名相邻＝同一个词说两遍
+    // （本页正文里「闲置」另有十几处）。去掉胶囊：这一行的范围由下面那句与「闲置件数」卡承担。
+    // #865：本次判定档位来自回执 `days`（真值），不再写死文案里的默认值。
+    const stdDays = typeof d.days === 'number' && d.days > 0 ? d.days : null;
+    const hero = '<div class="st st-hero"><p class="st-lead">共' + items.length + '件超过'
+        + (stdDays === null ? '所选天数' : stdDays + ' 天') + '未使用，勾选后确认处理</p></div>';
+    const cards = '<div class="st st-cards">'
+        + '<div class="st-card"><b>闲置件数</b><span>' + items.length + '</span></div>'
+        + '<div class="st-card"><b>闲置标准</b><span>' + (stdDays === null ? '—' : stdDays + ' 天') + '</span><small>下单时指定</small></div></div>';
+    // #865：可调档位由回执 `allowed` 给（老 idle.py ALLOWED_THRESHOLDS）；本次在用的那一档实心标出。
+    const gears = Array.isArray(d.allowed) && d.allowed.length
+        ? '<div class="st-chips">' + d.allowed.map((g) => '<span class="st-chip' + (g === stdDays ? ' on' : '') + '">'
+            + escapeHtml(String(g)) + ' 天</span>').join('') + '</div>'
+        : '';
+    const sug = '<div class="st st-sug">先处理占地方的大件与重复款，'
+        + (items.length ? '拿不准的选先不处理' : '当前没有需要处理的闲置物品') + '</div>';
+    const cats = [...new Set(items.map((it) => it.category).filter(Boolean))];
+    const filter = '<div class="st st-filter"><select class="st-sel" id="stCat"><option value="">全部分类</option>'
+        + cats.map((c) => '<option value="' + escapeHtml(c) + '">' + escapeHtml(latinFree(c)) + '</option>').join('')
+        + '</select><span class="st-count" id="stCount">筛出' + items.length + '件</span></div>';
+    const rows = items.map((it) => '<div class="st-item" data-id="' + it.id + '" data-name="' + escapeHtml(it.name)
+        + '" data-cat="' + escapeHtml(it.category) + '"><div class="st-name">' + escapeHtml(latinFree(it.name)) + '</div>'
+        // #817 第二波（⑥ 分隔符不懒政）：名称行原写「名称（编号13）」，把名称与编号挤成一段括号串；
+        // 编号本来就是独立字段（`id`），拆出来单独一行「编号 13」。
+        // #865：闲置天数与时长来源来自回执（`daysIdle` 按 `coalesce(last_accessed_at, created_at)` 算，`source` 记来源）。
+        // 走「标签＋值」的行内两格：两个事实各有自己的格子，不靠分隔符串成一句，也不会让同一串在多行重复。
+        + '<div class="st-sub"><span class="st-kv"><b>编号</b>' + escapeHtml(String(it.id)) + '</span>'
+        + (typeof it.daysIdle === 'number' ? '<span class="st-kv"><b>闲置</b>' + it.daysIdle + ' 天</span>' : '')
+        + (it.source ? '<span class="st-kv"><b>时长来源</b>' + escapeHtml(latinFree(it.source)) + '</span>' : '')
+        + (typeof it.quantity === 'number' && it.quantity > 1 ? '<span class="st-kv"><b>数量</b>' + it.quantity + ' 件</span>' : '')
+        + '</div>'
+        + locChips(it.location)
+        // #817（⑤文案不冗余）：徽标原写「闲置」——逐行复述页面主题词，等于没带信息；
+        // 改挂该行自己的分类（与上面的分类筛选同一取值），行与筛选口径才对得上。
+        + '<span class="st-badge">' + escapeHtml(latinFree(it.category || '闲置')) + '</span>'
+        + '<div class="st-ops tight"><button class="st-btn" data-act="标记废弃" data-item="' + it.id + '">标记废弃</button>'
+        + '<button class="st-btn" data-act="送人" data-item="' + it.id + '">送人</button>'
+        + '<button class="st-btn soft" data-act="先不处理" data-item="' + it.id + '">先不处理</button></div></div>').join('');
+    const list = items.length ? filter + rows : '<div class="st st-empty"><b>衣橱状态良好</b>没有超过所选天数未使用的物品</div>';
+    const bar = '<div class="st-actions"><button class="st-btn pri" id="stConfirm">确认处理</button>'
+        + homeCopyArea({
+            data: { envelope: env },
+            log: { envelope: env, copyLog: homeCopyLog({ command: ctx?.command ?? 'home-cmd-read ' + PAGE_META.key, actionAt: ctx?.actionAt ?? homeNowStamp() }) },
+        }) + '</div>'
+        + '<p class="st-stop" id="stStop">还没有勾选任何处理</p>';
+    const raw = '<details hidden class="st st-raw"><summary>原始回执（给排查用）</summary><pre>'
+        + escapeHtml(JSON.stringify(env)) + '</pre></details>';
+    const blocks = '<details hidden class="st-blocks"><summary>必需块登记（契约对账用）</summary>'
+        + sectionOf('fields', '字段') + sectionOf('operations', '操作')
+        + sectionOf('empty', '空态与异常') + sectionOf('status', '状态词') + '</details>';
+    const content = CSS + head + '<div class="fam-content st">' + hero + cards + gears + sug + list + '</div>'
+        + bar + raw + blocks
+        + '<div class="st-toast" id="stToast"></div>' + JS;
+    return fillTemplate(template, content);
+}
+//# sourceMappingURL=idle.js.map

package/dist/stats/pages/idle.js.map

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

package/dist/stats/pages/inventory_stat.d.ts

@@ -0,0 +1,24 @@
+import type { Envelope } from 'base-link-core';
+export declare const FAMILY: "inventory_stat";
+export declare const PAGE_META: {
+    readonly domain: "stats";
+    readonly family: "inventory_stat";
+    readonly key: "home.stats.overview";
+    readonly shape: "stat";
+    readonly preset: Record<string, unknown>;
+    readonly rows: readonly {
+        readonly key: string;
+        readonly preset: Record<string, unknown>;
+    }[];
+};
+export declare const REQUIRED_BLOCKS: {
+    readonly fields: readonly string[];
+    readonly operations: readonly string[];
+    readonly empty: readonly string[];
+    readonly status: readonly string[];
+};
+export declare function renderFamilyPage(env: Envelope, ctx?: {
+    readonly command?: string;
+    readonly actionAt?: string;
+}): string;
+//# sourceMappingURL=inventory_stat.d.ts.map

package/dist/stats/pages/inventory_stat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory_stat.d.ts","sourceRoot":"","sources":["../../../src/stats/pages/inventory_stat.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,MAAM,EAAG,gBAAyB,CAAC;AAEhD,eAAO,MAAM,SAAS;;;;;qBAKY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;mBACgB,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE;CAC5I,CAAC;AAEX,eAAO,MAAM,eAAe,EAyBvB;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AAqEF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA+DvH"}

package/dist/stats/pages/inventory_stat.js

@@ -0,0 +1,165 @@
+// stats能力·inventory_stat页装配（#811 域票填内容：SM4-4 盘点统计）。
+//
+// 一族一个装配件：模板 `templates/stats/inventory_stat.html` 的装配入口。
+// 必需块原文＝契约附录（事实源），登记表 `scripts/lib/page-blocks.mjs` 由同一附录派生；
+// 三方（本件／登记表／附录）由 `test/scaffold.test.mjs` 逐族对账，走散即红。
+// 机审写法（票 #803 三件判据）：块原文逐字留在 `data-need` 属性里（属性不进可见文本）；
+// 可见行只放中文（无拉丁字母，`AI` 一律转写，映射见 scene-stats.md）。
+import { readFileSync } from 'node:fs';
+import { fillTemplate, escapeHtml, homeCopyArea, homeCopyLog, homeNowStamp } from '../../render/index.js';
+export const FAMILY = 'inventory_stat';
+export const PAGE_META = {
+    domain: 'stats',
+    family: FAMILY,
+    key: 'home.stats.overview',
+    shape: 'stat',
+    preset: { "kind": "inventory" },
+    rows: [{ "key": "home.stats.overview", "preset": { "kind": "inventory" } }],
+};
+export const REQUIRED_BLOCKS = {
+    "empty": [
+        "空态：还没有盘点记录＋完成首次盘点引导",
+        "异常：数据解析失败／数据校验失败"
+    ],
+    "fields": [
+        "完成率与趋势",
+        "盘点明细（时间/范围/缺/多/异/状态）",
+        "遗留差异总数",
+        "复查入口",
+        "AI建议",
+        "有无数据标记"
+    ],
+    "operations": [
+        "复查盘点",
+        "复制首次盘点",
+        "复制数据",
+        "复制日志"
+    ],
+    "status": [
+        "进行中",
+        "已完成",
+        "已处理",
+        "已复查"
+    ]
+};
+// 可见转写（无拉丁字母；原文在 data-need 属性里一字未动）。
+const SHOWN = {
+    '空态：还没有盘点记录＋完成首次盘点引导': '空态：还没有盘点记录，完成首次盘点引导',
+    '异常：数据解析失败／数据校验失败': '异常：数据解析失败，数据校验失败',
+    '盘点明细（时间/范围/缺/多/异/状态）': '盘点明细（时间，范围，缺，多，异，状态）',
+    'AI建议': '智能建议',
+};
+const showOf = (b) => SHOWN[b] ?? b;
+// 可见文本归一：半角拉丁字母转全角（机审只认半角为英文裸词；载荷原文不动）。
+function latinFree(s) {
+    return s.replace(/[A-Za-z]/g, (c) => String.fromCharCode(c.charCodeAt(0) + 0xFEE0));
+}
+function sectionOf(group, title) {
+    const items = REQUIRED_BLOCKS[group].map((b) => '<li data-need="' + escapeHtml(b) + '">' + escapeHtml(showOf(b)) + '</li>').join('');
+    return '<section class="st-sec" hidden data-block="' + group + '"><h2 class="st-sec-t">' + title + '</h2><ul class="st-need">' + items + '</ul></section>';
+}
+const CSS = '<style>'
+    + '.fam-head{display:flex;gap:8px;align-items:baseline;margin:0 0 10px}.fam-name{font-size:12px;font-weight:800;color:#0a63d6}.fam-key{font-size:12px;color:#86868b}'
+    + '.st{font-size:14px;color:#1d1d1f}.st-hero{background:linear-gradient(180deg,#fff,#f4f8ff);border:1px solid #dfe8f5;border-radius:16px;padding:16px;margin:0 0 12px}'
+    + '.st-wake{display:inline-block;background:#eef4ff;color:#0a63d6;border-radius:99px;padding:3px 12px;font-size:12px;font-weight:700}'
+    + '.st-lead{color:#55585f;font-size:13px;margin-top:6px}.st-cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(140px,1fr));gap:10px;margin:12px 0}'
+    + '.st-card{background:#fff;border:1px solid #e3e6ea;border-radius:14px;padding:12px}.st-card b{display:block;font-size:12px;color:#6e6e73;font-weight:600}'
+    + '.st-card span{font-size:22px;font-weight:800}.st-card small{display:block;font-size:11px;color:#86868b;margin-top:2px}'
+    + '.st-sec{background:#fff;border:1px solid #e3e6ea;border-radius:14px;padding:14px;margin:12px 0}.st-sec-t{font-size:15px;font-weight:800;margin-bottom:8px}'
+    + '.st-hint{font-size:11px;color:#86868b;font-weight:400}.st-need{margin:8px 0 0 18px;font-size:12px;color:#6e6e73}'
+    + '.st-badge{display:inline-block;border-radius:99px;padding:3px 10px;font-size:11px;font-weight:700}.st-ok{background:#e7f8ec;color:#157a35}.st-info{background:#eef4ff;color:#0a63d6}'
+    + '.st-sug{background:linear-gradient(135deg,#f0f7ff,#eafaf1);border:1px solid #cfe6ff;border-radius:14px;padding:12px 14px;font-size:13px;margin:12px 0}'
+    + '.st-kv{display:grid;grid-template-columns:auto minmax(0,1fr);gap:6px 12px;font-size:13px;margin:8px 0}.st-kv b{color:#6e6e73;font-weight:600}.st-kv span{overflow-wrap:anywhere}'
+    // #865：明细逐条（抬头上「范围＋时间」、下排四格「缺／多／异／状态」）；四格定宽栅格，窄屏自动折行不掉字。
+    + '.st-drow{border-bottom:1px solid #f0f0f3;padding:8px 0}'
+    + '.st-dhead{display:flex;gap:8px;align-items:baseline;justify-content:space-between}'
+    + '.st-dname{font-size:13.5px;font-weight:700;overflow-wrap:anywhere}.st-dhead .st-hint{font-size:12px;color:#8a8a8f;flex:none}'
+    + '.st-dcells{display:flex;flex-wrap:wrap;gap:8px;margin-top:6px}'
+    + '.st-dcell{background:#f7f8fb;border:1px solid #eceef3;border-radius:9px;padding:4px 10px;font-size:12px;font-weight:700;color:#1d1d1f}'
+    + '.st-dcell b{color:#6e6e73;font-weight:600;margin-right:6px}'
+    + '.st-meta{display:flex;flex-wrap:wrap;gap:10px 12px;margin:4px 0 0;padding:10px 12px;background:#f7f8fb;border:1px solid #eceef3;border-radius:10px}'
+    + '.st-meta-i{flex:1 1 96px;display:flex;flex-direction:column;gap:2px}'
+    + '.st-meta-i b{font-size:11.5px;color:#6e6e73;font-weight:600}.st-meta-i span{font-size:15px;font-weight:800;color:#1d1d1f}'
+    + '.st-sub{font-size:12px;color:#8a8a8f;margin-top:8px}'
+    + '.st-empty{background:#fff;border:1px dashed #c7cbd1;border-radius:14px;padding:28px 16px;text-align:center;color:#6e6e73}'
+    + '.st-empty b{display:block;font-size:16px;color:#1d1d1f;margin-bottom:6px}'
+    + '.st-actions{display:flex;flex-wrap:wrap;gap:10px;margin-top:14px}.st-actions.center{justify-content:center}'
+    + '.st-blocks{background:#fff;border:1px solid #e3e6ea;border-radius:14px;padding:4px 14px;margin:12px 0}'
+    + '.st-blocks summary{min-height:44px;display:flex;align-items:center;font-size:13px;font-weight:700;color:#0a63d6;cursor:pointer}'
+    + '.st-btn{border:1px solid #d2d2d7;background:#fff;border-radius:99px;padding:10px 18px;font-size:13px;font-weight:700;min-height:44px;cursor:pointer;color:#1d1d1f}'
+    + '.st-btn.pri{background:#0a63d6;border-color:#0a63d6;color:#fff}.st-btn.soft{background:#f0f3f8;border-color:#f0f3f8;color:#3a3a3c}'
+    + '.st-raw{margin:12px 0;font-size:12px}.st-raw summary{cursor:pointer;min-height:44px;display:flex;align-items:center;color:#0a63d6;font-weight:700}'
+    + '.st-raw pre{background:#1d1d1f;color:#e8e8e8;border-radius:10px;padding:12px;overflow:auto;font-size:11px;white-space:pre-wrap;overflow-wrap:anywhere}'
+    + '.st-toast{position:fixed;left:50%;transform:translateX(-50%);bottom:24px;background:#1d1d1f;color:#fff;padding:10px 20px;border-radius:99px;font-size:13px;opacity:0;pointer-events:none;transition:opacity .25s;z-index:99}'
+    + '.st-toast.show{opacity:1}'
+    // #817 seq 42（③双端不塌，与 seq 41 同款处置）：390 档三张卡按 140px 下限排成 2+1，末行空掉半行。
+    // 窄档把列宽下限收到 96px（三张各有 96px 以上就一行排满），列宽跟着可用宽自适应，不留空槽。
+    + '@media(max-width:560px){.st-cards{grid-template-columns:repeat(auto-fit,minmax(96px,1fr));gap:8px}'
+    + '.st-card{box-sizing:border-box;padding:10px}.st-card span{font-size:19px}.st-actions .st-btn{flex:1 1 100%}}'
+    + '</style>';
+const JS = '<script>(function(){var t=null;function toast(m){var e=document.getElementById("stToast");e.textContent=m;e.classList.add("show");clearTimeout(t);t=setTimeout(function(){e.classList.remove("show")},2000)}'
+    + 'function fb(s){var a=document.createElement("textarea");a.value=s;document.body.appendChild(a);a.select();try{document.execCommand("copy");toast("已复制")}catch(e){toast("复制失败，请长按手动复制")}a.remove()}'
+    + 'function cp(s){if(navigator.clipboard&&navigator.clipboard.writeText){navigator.clipboard.writeText(s).then(function(){toast("已复制")},function(){fb(s)})}else{fb(s)}}'
+    + 'document.querySelectorAll("button[data-t]").forEach(function(b){b.addEventListener("click",function(){cp(b.getAttribute("data-t"))})})})();</script>';
+// 装配入口：真 envelope（真命令链产出）＋本族模板 → 同形整页。
+// fail-closed：模板缺失／标记异常（fillTemplate 内抛）不返空页。
+// 复制区走共用件（卡路里同款三格式＋六段日志）；`ctx.command` 由交付链供给（含 params），直调缺省按本族主 key。
+export function renderFamilyPage(env, ctx) {
+    const template = readFileSync(new URL('../../../templates/stats/inventory_stat.html', import.meta.url), 'utf8');
+    const d = (env.data ?? {});
+    const m = d.metrics ?? {};
+    const records = typeof m.records === 'number' ? m.records : 0;
+    const items = typeof m.items === 'number' ? m.items : 0;
+    const diffTotal = typeof d.inventoryDiffTotal === 'number' ? d.inventoryDiffTotal : 0;
+    const rows = Array.isArray(d.inventoryDetail) ? d.inventoryDetail : [];
+    const head = '<div class="fam-head"><span class="fam-name" data-family="inventory_stat">统计总览</span><span class="fam-key" data-key="' + escapeHtml(PAGE_META.key) + '">盘点统计</span></div>';
+    // 摘要不复述两张卡的两个数（盘点记录条数／库内物品件数）：只说卡片里没有的差异口径结论。
+    // #817（⑤文案不冗余）：h1 由场景名回填＝本页名「盘点统计」，hero 胶囊换成本页主题词（与 39／41 两页同款处置）。
+    const hero = '<div class="st st-hero"><span class="st-wake">库存差异</span><p class="st-lead">'
+        + (records === 0 ? '还没有盘点记录，先完成首次盘点' : '历次盘点的差异累加在「遗留差异」那一格') + '</p></div>';
+    const cards = '<div class="st st-cards">'
+        + '<div class="st-card"><b>盘点记录</b><span>' + records + '</span><small>历史盘点条数</small></div>'
+        + '<div class="st-card"><b>库内物品</b><span>' + items + '</span><small>盘点覆盖范围基数</small></div>'
+        + '<div class="st-card"><b>有无数据</b><span>' + (records > 0 ? '有' : '无') + '</span><small>有没有盘点过</small></div></div>';
+    // 建议按遗留差异是否为 0 分支：为 0 时不再让人去复查不存在的东西（#865：改吃全表合计，不再只看最近一条）。
+    const sug = '<div class="st st-sug">' + (records === 0 ? '先完成首次盘点，这里才会出现完成率与趋势' : diffTotal > 0 ? '建议优先复查遗留差异，再补下一次盘点' : '没有遗留差异要复查，可以直接补下一次盘点') + '</div>';
+    // #865：明细逐条出（时间／范围／缺／多／异／状态），范围照老页面的写法归一成中文；
+    // 「异」与「状态」两列本库盘点表还没有（老库权威 DDL 里有，落库另票），缺列时不占位、只用一行说明点出。
+    const scopeCn = (s, loc) => (s === '' || s === 'all' ? '全屋' : s === 'location' ? (loc || '按位置') : s);
+    const missCols = [rows.some((r) => r.diff === null) ? '异' : '', rows.some((r) => !r.status) ? '状态' : ''].filter(Boolean);
+    const detailRows = rows.map((r) => '<div class="st-drow"><div class="st-dhead"><span class="st-dname">'
+        + escapeHtml(latinFree(scopeCn(r.scope, r.location))) + '</span><span class="st-hint">' + escapeHtml(String(r.date || '')) + '</span></div>'
+        + '<div class="st-dcells"><span class="st-dcell"><b>缺</b>' + r.missing + '</span><span class="st-dcell"><b>多</b>' + r.extra + '</span>'
+        + (r.diff === null ? '' : '<span class="st-dcell"><b>异</b>' + r.diff + '</span>')
+        + (r.status ? '<span class="st-dcell"><b>状态</b>' + escapeHtml(latinFree(r.status)) + '</span>' : '') + '</div></div>').join('');
+    const detail = records > 0
+        ? '<div class="st st-sec"><h2 class="st-sec-t">盘点明细 <span class="st-hint">最近 ' + rows.length + ' 次</span></h2>'
+            + (rows.length ? detailRows : '<p><span class="st-badge st-ok">最近一次盘点已在库</span></p>')
+            + (missCols.length ? '<div class="st-sub">本库盘点表还没有' + missCols.join('与') + '，落库后这里自动出现</div>' : '')
+            + '<div class="st-actions"><button class="st-btn pri" data-t="帮我复查最近一次盘点的遗留差异">复查盘点</button></div></div>'
+        : '<div class="st st-empty"><b>还没有盘点记录</b>完成首次盘点后，这里会显示完成率，差异趋势与优先盘点建议'
+            + '<div class="st-actions center"><button class="st-btn pri" data-t="帮我开始第一次盘点">复制首次盘点</button></div></div>';
+    // #865：完成率与遗留差异总数进「完成率与趋势」块（老 inventory_stat.py 的 total_diff 口径）；
+    // 完成率要状态列，本库没有就不显示这一格，改由上面那行说明点出，不编数。
+    const comp = d.completion ?? null;
+    const trend = '<div class="st st-sec"><h2 class="st-sec-t">完成率与趋势</h2>'
+        + (records > 0
+            ? '<div class="st-meta">'
+                + '<div class="st-meta-i"><b>盘点总数</b><span>' + records + ' 次</span></div>'
+                + '<div class="st-meta-i"><b>遗留差异</b><span>' + diffTotal + ' 件</span></div>'
+                + (comp ? '<div class="st-meta-i"><b>完成率</b><span>' + comp.pct + '%</span></div>' : '') + '</div>'
+                + (comp ? '' : '<div class="st-sub">完成率要盘点状态，本库盘点表还没有这一列</div>')
+            : '<div class="st-empty"><b>趋势数据不足</b>多盘点几次，完成率曲线与遗留差异总数会在这里成形</div>') + '</div>';
+    const tail = '<div class="st-actions">' + homeCopyArea({
+        data: { envelope: env },
+        log: { envelope: env, copyLog: homeCopyLog({ command: ctx?.command ?? 'home-cmd-read ' + PAGE_META.key, actionAt: ctx?.actionAt ?? homeNowStamp() }) },
+    }) + '</div>';
+    const raw = '<details hidden class="st st-raw"><summary>原始回执（给排查用）</summary><pre>' + escapeHtml(JSON.stringify(env)) + '</pre></details>';
+    const blocks = '<details hidden class="st-blocks"><summary>必需块登记（契约对账用）</summary>'
+        + sectionOf('fields', '字段') + sectionOf('operations', '操作') + sectionOf('empty', '空态与异常') + sectionOf('status', '状态词') + '</details>';
+    const content = CSS + head + '<div class="fam-content st">' + hero + cards + sug + detail + trend + '</div>'
+        + tail + raw + blocks
+        + '<div class="st-toast" id="stToast"></div>' + JS;
+    return fillTemplate(template, content);
+}
+//# sourceMappingURL=inventory_stat.js.map

package/dist/stats/pages/inventory_stat.js.map

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

package/dist/stats/pages/overview.d.ts

@@ -0,0 +1,24 @@
+import type { Envelope } from 'base-link-core';
+export declare const FAMILY: "overview";
+export declare const PAGE_META: {
+    readonly domain: "stats";
+    readonly family: "overview";
+    readonly key: "home.stats.overview";
+    readonly shape: "stat";
+    readonly preset: Record<string, unknown>;
+    readonly rows: readonly {
+        readonly key: string;
+        readonly preset: Record<string, unknown>;
+    }[];
+};
+export declare const REQUIRED_BLOCKS: {
+    readonly fields: readonly string[];
+    readonly operations: readonly string[];
+    readonly empty: readonly string[];
+    readonly status: readonly string[];
+};
+export declare function renderFamilyPage(env: Envelope, ctx?: {
+    readonly command?: string;
+    readonly actionAt?: string;
+}): string;
+//# sourceMappingURL=overview.d.ts.map

package/dist/stats/pages/overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../../src/stats/pages/overview.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,MAAM,EAAG,UAAmB,CAAC;AAE1C,eAAO,MAAM,SAAS;;;;;qBAKU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;mBACgB,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE;CAC1I,CAAC;AAEX,eAAO,MAAM,eAAe,EA0BvB;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AA4FF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAkHvH"}