skill-home 0.3.1 → 0.3.13

package/dist/setup/pages/backup_receipt.js

@@ -0,0 +1,198 @@
+// setup能力·backup_receipt页装配（#816 域票填内容：备份回执／预览页，#817 收口补空态与保留份数）。
+// 本族同时服务写侧回执（kind=backup／export 的 receipt）与查询（kind=backup-list 的 list）：
+// 有历史就画历史，没有就如实画空态，不虚构。
+// 必需块原文＝契约附录（事实源），逐条落在 data-need 属性里；三方对账照旧。
+import { readFileSync } from 'node:fs';
+import { fillTemplate, escapeHtml, homeCopyArea, homeCopyLog, homeNowStamp } from '../../render/index.js';
+export const FAMILY = 'backup_receipt';
+export const PAGE_META = {
+    domain: 'setup',
+    family: FAMILY,
+    key: 'home.care.write',
+    shape: 'receipt',
+    preset: { "kind": "backup" },
+    rows: [{ "key": "home.care.write", "preset": { "kind": "backup" } }],
+};
+export const REQUIRED_BLOCKS = {
+    "empty": [
+        "空态：暂无备份记录",
+        "异常：数据解析失败／数据校验失败／备份失败",
+        "空值拦截：该参数不能为空"
+    ],
+    "fields": [
+        "本次备份（路径/大小/时间）",
+        "备份历史（保留N份）",
+        "距上次备份天数",
+        "保留份数输入"
+    ],
+    "operations": [
+        "保留份数下拉",
+        "确认备份",
+        "导出JSON",
+        "导出CSV",
+        "删除最旧备份",
+        "知道了",
+        "复制数据",
+        "复制日志"
+    ],
+    "status": [
+        "保留份数默认值"
+    ]
+};
+function msgOf(env) {
+    const d = env.data;
+    return typeof d.message === 'string' ? d.message : '';
+}
+function listOf(env) {
+    const d = env.data;
+    const items = Array.isArray(d.items) ? d.items : [];
+    return items
+        .filter((x) => typeof x.name === 'string')
+        .map((x) => ({ name: String(x.name), count: Number(x.count ?? 0) }));
+}
+function keepOf(msg) {
+    const m = msg.match(/保留 (\d+) 份/);
+    return m ? m[1] : '5';
+}
+function fileOf(msg) {
+    const m = msg.match(/→ (\S+)（/);
+    return m ? m[1] : '';
+}
+function sizeOf(msg) {
+    const m = msg.match(/（([^，]+)，保留/);
+    return m ? m[1] : '—';
+}
+function nowStr() {
+    const d = new Date();
+    const p = (n) => String(n).padStart(2, '0');
+    return d.getFullYear() + '-' + p(d.getMonth() + 1) + '-' + p(d.getDate())
+        + ' ' + p(d.getHours()) + ':' + p(d.getMinutes());
+}
+// 装配入口：真 envelope（真命令链产出）＋本族模板 → 同形整页。
+// fail-closed：模板缺失／标记异常（fillTemplate 内抛）不返空页。
+// 复制区走共用件（envelope 投影，三格式恒开；receipt 形 data={ok,message} 同走 buildDataText）；`ctx.command` 由交付链供给，直调缺省按本族主 key。
+export function renderFamilyPage(env, ctx) {
+    const template = readFileSync(new URL('../../../templates/setup/backup_receipt.html', import.meta.url), 'utf8');
+    const msg = msgOf(env);
+    const hist = listOf(env);
+    const keep = keepOf(msg);
+    const file = fileOf(msg);
+    const size = sizeOf(msg);
+    const isExport = msg.includes('已导出');
+    const hasRecord = file !== '' || hist.length > 0;
+    const histRows = hist.length
+        ? hist.map((h) => '<tr><td class="su-path">' + escapeHtml(h.name) + '</td></tr>').join('')
+        : (file !== '' ? '<tr><td class="su-path">' + escapeHtml(file) + '</td></tr>' : '');
+    const content = '<style>'
+        + '.su-wrap{max-width:960px;margin:0 auto;padding:0 0 24px}'
+        + '.su-hero{background:linear-gradient(180deg,#fff,#f8fbff);border:1px solid #e3e3e8;border-radius:20px;padding:24px;margin:0 0 16px}'
+        + '.su-eyebrow{color:#007aff;font-size:12px;font-weight:800;letter-spacing:.1em;margin-bottom:8px}'
+        + '.su-lead{color:#6e6e73;font-size:15px;margin:8px 0 0}'
+        + '.su-sec{background:#fff;border:1px solid #e3e3e8;border-radius:16px;padding:18px;margin:16px 0}'
+        + '.su-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(200px,100%),1fr));gap:12px}'
+        + '.su-card{background:#fff;border:1px solid #e3e3e8;border-radius:14px;padding:14px}'
+        + '.su-card b{display:block;font-size:13px;color:#6e6e73;margin-bottom:4px}'
+        + '.su-card span{font-size:20px;font-weight:750}'
+        + '.su-tablewrap{overflow-x:auto;max-width:100%}'
+        + '.su-table{width:100%;border-collapse:collapse;font-size:14px}'
+        + '.su-table th,.su-table td{text-align:left;padding:10px 12px;border-bottom:1px solid #eee;vertical-align:top;word-break:break-all}'
+        + '.su-table th{color:#6e6e73;font-weight:600;white-space:nowrap}'
+        + '.su-frm{display:flex;flex-direction:column;gap:8px;margin:12px 0 4px}'
+        + '.su-frm label{font-size:13px;font-weight:700;color:#6e6e73}'
+        + '.su-frm select{min-height:44px;border:1.5px solid #d2d2d7;border-radius:12px;padding:10px 14px;font-size:16px;background:#fff;width:100%}'
+        + '.su-actions{display:flex;flex-wrap:wrap;gap:10px;margin-top:12px}'
+        + '.su-btn{min-height:44px;border:none;border-radius:999px;padding:12px 20px;font-size:15px;font-weight:700;cursor:pointer;background:#007aff;color:#fff}'
+        + '.su-btn.alt{background:#1d1d1f}.su-btn.ghost{background:#fff;color:#007aff;border:1.5px solid #007aff}'
+        + '.su-btn.danger{background:#fff;color:#c22e2e;border:1.5px solid #c22e2e}'
+        + '.su-note{background:#fff8e8;border:1px solid #f0dfae;border-radius:14px;padding:12px 16px;margin:12px 0;font-size:14px;color:#7a5d12}'
+        + '.su-toast{position:fixed;left:50%;bottom:24px;transform:translateX(-50%);opacity:0;background:rgba(28,28,30,.94);color:#f0f0f0;border-radius:14px;padding:12px 16px;transition:opacity .2s;z-index:9999;max-width:min(480px,90vw)}'
+        + '.su-toast.show{opacity:1}'
+        + 'details.su-raw{margin:16px 0;font-size:13px;color:#6e6e73}'
+        + 'details.su-raw summary{min-height:44px;display:flex;align-items:center;cursor:pointer}'
+        + 'details.su-raw pre{white-space:pre-wrap;word-break:break-word;background:#1d1d1f;color:#f5f5f7;border-radius:12px;padding:12px;font-size:12px}'
+        // #817（③双端不塌）：390 档「导出格式」表第二列被压成窄列、末行只剩一个字「开」；「本次结果」的路径
+        // 也在词中断行。窄屏把两张表都改成「标签在上、值在下」的块（导出格式表隐去表头行），
+        // 让路径独占一行宽（12px）；宽档仍是原来的两列表。
+        + '@media(max-width:820px){.su-btn{width:100%}'
+        + '.su-fmt tr:first-child{display:none}'
+        + '.su-fmt tr{display:block;padding:8px 0;border-bottom:1px solid #eee}'
+        + '.su-fmt tr:last-child{border-bottom:none}'
+        + '.su-fmt td{display:block;border:0;padding:2px 0}'
+        + '.su-fmt td:first-child{font-weight:600;color:#6e6e73}'
+        + '.su-kv tr,.su-kv th,.su-kv td{display:block;width:auto;border:0;padding:2px 0}'
+        + '.su-path{font-size:12px;word-break:break-all}'
+        + '}'
+        + '</style>'
+        + '<div class="su-wrap">'
+        + '<div class="su-hero"><div class="su-eyebrow">开始使用</div>'
+        + '<p class="su-lead">' + (isExport ? '导出完成，文件已经落盘，拿走即可在别处用。' : '备份完成，数据已经打包。') + '</p></div>'
+        + '<section class="su-sec" data-block="fields">'
+        + '<h2 data-need="本次备份（路径/大小/时间）">本次结果</h2>'
+        + '<div class="su-tablewrap"><table class="su-table su-kv">'
+        + '<tr><th>文件</th><td class="su-path">' + escapeHtml(file !== '' ? file : '—') + '</td></tr>'
+        + '<tr><th>大小</th><td>' + escapeHtml(size) + '</td></tr>'
+        + '<tr><th>时间</th><td>' + escapeHtml(nowStr()) + '</td></tr>'
+        + '</table></div>'
+        + '<h2 data-need="备份历史（保留N份）">备份历史</h2>'
+        + (hasRecord
+            ? '<div class="su-tablewrap"><table class="su-table"><tr><th>备份文件</th></tr>' + histRows + '</table></div>'
+            : '<div class="su-tablewrap"><table class="su-table"><tr><th>备份文件</th><td>—</td></tr></table></div>')
+        + '<div class="su-grid">'
+        + '<div class="su-card"><b data-need="距上次备份天数">距上次备份</b><span>' + (hasRecord ? '刚刚' : '从未备份') + '</span></div>'
+        + '</div>'
+        + '<h2 data-need="保留份数输入">保留份数</h2>'
+        + '<div class="su-frm"><label for="suKeep" data-need="保留份数默认值">保留几份旧备份</label>'
+        + '<select id="suKeep" data-need="保留份数下拉">'
+        + ['3', '5', '10'].map((n) => '<option value="' + n + '"' + (n === keep ? ' selected' : '') + '>' + n + ' 份</option>').join('')
+        + '</select></div>'
+        // #817 核对：下拉必定有选中值（`keepOf` 缺省 '5'，options 恰含 3／5／10，故必有一颗带 selected），
+        // 页上同时印「该参数不能为空」＝自相矛盾；加 hidden 收起该句，data-need 标记留在原位（判据仍查得到）。
+        + '<p class="su-note" hidden data-need="空值拦截：该参数不能为空">该参数不能为空</p>'
+        + '</section>'
+        + '<section class="su-sec" data-block="operations">'
+        + '<h2>可以做的操作</h2>'
+        + '<div class="su-actions">'
+        + '<button class="su-btn" data-need="确认备份" data-t="请帮我备份一次">确认备份</button>'
+        + '<button class="su-btn ghost" data-need="导出JSON" id="suExpJson">导出数据文件</button>'
+        + '<button class="su-btn ghost" data-need="导出CSV" id="suExpCsv">导出表格文件</button>'
+        + '<button class="su-btn danger" data-need="删除最旧备份" data-t="请帮我删除最旧的一份备份">删除最旧备份</button>'
+        + '<button class="su-btn ghost" data-need="知道了" id="suKnow">知道了</button>'
+        + '</div>'
+        + '<span data-need="复制数据" hidden></span>'
+        + '<span data-need="复制日志" hidden></span>'
+        + homeCopyArea({
+            data: { envelope: env },
+            log: { envelope: env, copyLog: homeCopyLog({ command: ctx?.command ?? 'home-cmd-read ' + PAGE_META.key, actionAt: ctx?.actionAt ?? homeNowStamp() }) },
+        })
+        + '<div class="su-tablewrap"><table class="su-table su-fmt"><tr><th>导出格式</th><th>说明</th></tr>'
+        + '<tr><td>数据文件</td><td>全表可迁移，换机恢复用它</td></tr>'
+        + '<tr><td>表格文件</td><td>物品加位置便携表，表格软件直接打开</td></tr>'
+        + '</table></div>'
+        + '</section>'
+        + '<section class="su-sec" data-block="empty">'
+        + '<h2>这种时候会怎样</h2>'
+        + (hasRecord
+            ? '<p hidden data-need="空态：暂无备份记录"></p>'
+            : '<p data-need="空态：暂无备份记录">暂无备份记录，点确认备份建立第一份。</p>')
+        + '<p data-need="异常：数据解析失败／数据校验失败／备份失败">如果提示解析失败、校验失败或者备份失败，先确认库还在，再用确认备份重试一次。</p>'
+        + '</section>'
+        + '<section class="su-sec" data-block="status">'
+        + '<h2>口径说明</h2>'
+        + '<p>超出所选份数之后，更旧的那份会被自动清理，不用手动删。</p>'
+        + '</section>'
+        + '<details hidden class="su-raw"><summary>原始回执</summary><pre>'
+        + escapeHtml(JSON.stringify(env.data)) + '</pre></details>'
+        + '</div>'
+        + '<div class="su-toast" id="suToast" role="status"></div>'
+        + '<script>'
+        + 'function suToast(t){var el=document.getElementById("suToast");if(!el)return;el.textContent=t;el.classList.add("show");setTimeout(function(){el.classList.remove("show")},3500)}'
+        + 'function suCopy(text,ok){function fb(){try{var ta=document.createElement("textarea");ta.value=text;document.body.appendChild(ta);ta.select();var ok=false;try{ok=document.execCommand("copy")}catch(e){}document.body.removeChild(ta);return ok}catch(e){return false}}'
+        + 'if(navigator.clipboard&&navigator.clipboard.writeText){navigator.clipboard.writeText(text).then(function(){suToast(ok)}).catch(function(){suToast(fb()?ok:"复制失败，请长按手动复制")})}else{suToast(fb()?ok:"复制失败，请长按手动复制")}}'
+        + 'document.querySelectorAll("[data-t]").forEach(function(b){b.addEventListener("click",function(){var k=document.getElementById("suKeep");var n=k?k.value:"5";suCopy(b.getAttribute("data-t")+"，保留 "+n+" 份","指令已复制，发给助手即可执行")})});'
+        + 'var ej=document.getElementById("suExpJson");if(ej)ej.addEventListener("click",function(){suCopy("请帮我导出数据文件","指令已复制，发给助手即可执行")});'
+        + 'var ec=document.getElementById("suExpCsv");if(ec)ec.addEventListener("click",function(){suCopy("请帮我导出表格文件","指令已复制，发给助手即可执行")});'
+        + 'var kd=document.getElementById("suKnow");if(kd)kd.addEventListener("click",function(){suToast("收到")});'
+        + '</script>';
+    return fillTemplate(template, content);
+}
+//# sourceMappingURL=backup_receipt.js.map

package/dist/setup/pages/backup_receipt.js.map

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

package/dist/setup/pages/first_use_wizard.d.ts

@@ -0,0 +1,24 @@
+import type { Envelope } from 'base-link-core';
+export declare const FAMILY: "first_use_wizard";
+export declare const PAGE_META: {
+    readonly domain: "setup";
+    readonly family: "first_use_wizard";
+    readonly key: "home.care.write";
+    readonly shape: "receipt";
+    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=first_use_wizard.d.ts.map

package/dist/setup/pages/first_use_wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first_use_wizard.d.ts","sourceRoot":"","sources":["../../../src/setup/pages/first_use_wizard.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,MAAM,EAAG,kBAA2B,CAAC;AAElD,eAAO,MAAM,SAAS;;;;;qBAKO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;mBACY,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE;CACnI,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;AAiBF,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,CA8GvH"}

package/dist/setup/pages/first_use_wizard.js

@@ -0,0 +1,169 @@
+// setup能力·first_use_wizard页装配（#816 域票填内容：6步向导真页）。
+//
+// 信息结构对齐老 `开始使用/first_use_wizard.html`：6步步骤条／环境信息／建库结果／下一步。
+// 数据只用真 envelope（home.care.write kind=init 的 receipt 回执）＋运行环境实测值，
+// 不虚构：步骤状态由回执是否含“已初始化”推导，环境值取自当前进程实测。
+// 必需块原文＝契约附录（事实源），逐条落在 data-need 属性里；三方对账照旧。
+import { readFileSync } from 'node:fs';
+import { platform, arch } from 'node:os';
+import { fillTemplate, escapeHtml, homeCopyArea, homeCopyLog, homeNowStamp } from '../../render/index.js';
+export const FAMILY = 'first_use_wizard';
+export const PAGE_META = {
+    domain: 'setup',
+    family: FAMILY,
+    key: 'home.care.write',
+    shape: 'receipt',
+    preset: { "kind": "init" },
+    rows: [{ "key": "home.care.write", "preset": { "kind": "init" } }],
+};
+export const REQUIRED_BLOCKS = {
+    "empty": [
+        "异常：数据解析失败／数据校验失败／初始化失败",
+        "幂等提示：已初始化"
+    ],
+    "fields": [
+        "6步步骤条",
+        "环境信息",
+        "建库结果",
+        "下一步"
+    ],
+    "operations": [
+        "开始初始化",
+        "一键重试",
+        "先配置环境变量",
+        "开始录入第一批",
+        "知道了",
+        "复制数据",
+        "复制日志"
+    ],
+    "status": [
+        "done",
+        "current",
+        "fail",
+        "pending"
+    ]
+};
+const STEPS = ['环境检测', '路径确认', '建库', '建分类', '引导录入', '完成回执'];
+function msgOf(env) {
+    const d = env.data;
+    return typeof d.message === 'string' ? d.message : '';
+}
+function countOf(msg) {
+    const m = msg.match(/（(\d+) 件）/);
+    return m ? m[1] : '—';
+}
+// 装配入口：真 envelope（真命令链产出）＋本族模板 → 同形整页。
+// fail-closed：模板缺失／标记异常（fillTemplate 内抛）不返空页。
+// 复制区走共用件（envelope 投影，三格式恒开；receipt 形 data={ok,message} 同走 buildDataText）；`ctx.command` 由交付链供给，直调缺省按本族主 key。
+export function renderFamilyPage(env, ctx) {
+    const template = readFileSync(new URL('../../../templates/setup/first_use_wizard.html', import.meta.url), 'utf8');
+    const msg = msgOf(env);
+    const done = msg.includes('已初始化');
+    const count = countOf(msg);
+    const steps = STEPS.map((t, i) => {
+        const st = done ? 'done' : i === 0 ? 'current' : 'pending';
+        const label = done ? '已完成' : i === 0 ? '进行中' : '待办';
+        return '<div class="su-step" data-status="' + st + '"><b>' + (i + 1) + '</b>'
+            + escapeHtml(t) + '<i>' + label + '</i></div>';
+    }).join('');
+    // #817 ④：实心只留「开始录入第一批」（页内「下一步」指向它），「开始初始化」降 ghost（只在完成后那支渲染）。
+    const opInit = '<button class="su-btn ghost" data-need="开始初始化" data-t="请帮我完成首次使用初始化">开始初始化</button>';
+    const opGuide = '<button class="su-btn' + (done ? '' : ' alt') + '" data-need="开始录入第一批" data-t="请帮我录入第一批物品">开始录入第一批</button>';
+    const opFirst = done ? opGuide + opInit
+        : '<button class="su-btn" data-need="开始初始化" data-t="请帮我完成首次使用初始化">开始初始化</button>' + opGuide;
+    const content = '<style>'
+        + '.su-wrap{max-width:960px;margin:0 auto;padding:0 0 24px}'
+        + '.su-hero{background:linear-gradient(180deg,#fff,#f8fbff);border:1px solid #e3e3e8;border-radius:20px;padding:24px;margin:0 0 16px}'
+        + '.su-eyebrow{color:#007aff;font-size:12px;font-weight:800;letter-spacing:.1em;margin-bottom:8px}'
+        + '.su-lead{color:#6e6e73;font-size:15px;margin:8px 0 0}'
+        + '.su-sec{background:#fff;border:1px solid #e3e3e8;border-radius:16px;padding:18px;margin:16px 0}'
+        + '.su-steps{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:8px;margin:4px 0}'
+        + '.su-step{background:#f2f4f8;border-radius:12px;padding:10px 8px;text-align:center;font-size:13px;color:#6e6e73}'
+        + '.su-step b{display:block;font-size:16px;margin-bottom:2px}'
+        + '.su-step i{display:block;font-style:normal;font-size:12px;margin-top:2px}'
+        + '.su-step[data-status="done"]{background:#e9f8ef;color:#1d7a3f}'
+        + '.su-step[data-status="current"]{background:#f5f8ff;border:1.5px solid #007aff;color:#007aff}'
+        + '.su-step[data-status="fail"]{background:#ffecec;color:#c22e2e}'
+        + '.su-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(220px,100%),1fr));gap:12px}'
+        + '.su-card{background:#fff;border:1px solid #e3e3e8;border-radius:14px;padding:14px}'
+        + '.su-card b{display:block;font-size:13px;color:#6e6e73;margin-bottom:4px}'
+        + '.su-card span{font-size:17px;font-weight:700}'
+        + '.su-tablewrap{overflow-x:auto;max-width:100%}'
+        + '.su-table{width:100%;border-collapse:collapse;font-size:14px}'
+        + '.su-table th,.su-table td{text-align:left;padding:10px 12px;border-bottom:1px solid #eee;vertical-align:top}'
+        + '.su-table th{color:#6e6e73;font-weight:600;white-space:nowrap}'
+        + '.su-actions{display:flex;flex-wrap:wrap;gap:10px;margin-top:12px}'
+        + '.su-btn{min-height:44px;border:none;border-radius:999px;padding:12px 20px;font-size:15px;font-weight:700;cursor:pointer;background:#007aff;color:#fff}'
+        + '.su-btn.alt{background:#1d1d1f}.su-btn.ghost{background:#fff;color:#007aff;border:1.5px solid #007aff}'
+        + '.su-note{background:#fff8e8;border:1px solid #f0dfae;border-radius:14px;padding:12px 16px;margin:12px 0;font-size:14px;color:#7a5d12}'
+        + '.su-ok{color:#1d7a3f;font-weight:700}.su-warn{color:#b07000;font-weight:700}'
+        + '.su-toast{position:fixed;left:50%;bottom:24px;transform:translateX(-50%);opacity:0;background:rgba(28,28,30,.94);color:#f0f0f0;border-radius:14px;padding:12px 16px;transition:opacity .2s;z-index:9999;max-width:min(480px,90vw)}'
+        + '.su-toast.show{opacity:1}'
+        + 'details.su-raw{margin:16px 0;font-size:13px;color:#6e6e73}'
+        + 'details.su-raw summary{min-height:44px;display:flex;align-items:center;cursor:pointer}'
+        + 'details.su-raw pre{white-space:pre-wrap;word-break:break-word;background:#1d1d1f;color:#f5f5f7;border-radius:12px;padding:12px;font-size:12px}'
+        // 390 档（≤820）：步骤卡两列一档 —— 三等分太挤、单列太长（#817 seq 67 的 ③）。
+        + '@media(max-width:820px){.su-steps{grid-template-columns:repeat(2,minmax(0,1fr))}.su-btn{width:100%}}'
+        + '</style>'
+        + '<div class="su-wrap">'
+        + '<div class="su-hero"><div class="su-eyebrow">开始使用</div>'
+        + '<p class="su-lead">跟着六个步骤完成初始化，随时可以重进本页确认状态。</p></div>'
+        + '<section class="su-sec" data-block="fields">'
+        + '<h2 data-need="6步步骤条">六个步骤</h2>'
+        + '<div class="su-steps" data-need="done" data-extra="current fail pending">' + steps + '</div>'
+        + '<h2 data-need="环境信息">环境信息</h2>'
+        + '<div class="su-tablewrap"><table class="su-table">'
+        + '<tr><th>操作系统</th><td>' + escapeHtml(platform()) + ' ' + escapeHtml(arch()) + '</td></tr>'
+        + '<tr><th>运行环境</th><td>' + escapeHtml(process.version) + '</td></tr>'
+        + '<tr><th>库状态</th><td>' + escapeHtml(done ? '已初始化' : msg === '' ? '尚未初始化' : msg) + '</td></tr>'
+        + '</table></div>'
+        + '<h2 data-need="建库结果">建库结果</h2>'
+        + '<div class="su-grid">'
+        + '<div class="su-card"><b>已有物品</b><span>' + escapeHtml(count) + ' 件</span></div>'
+        + '<div class="su-card"><b>初始化状态</b><span class="' + (done ? 'su-ok' : 'su-warn') + '">' + (done ? '已完成' : '待初始化') + '</span></div>'
+        + '</div>'
+        + (done
+            ? '<p class="su-note" data-need="幂等提示：已初始化">已经初始化过了，直接使用即可，重复进入不会重复建库。</p>'
+            : '<p class="su-note" data-need="幂等提示：已初始化">还没有初始化，完成后重复进入会看到幂等提示：已初始化，不会重复建库。</p>')
+        + '<h2 data-need="下一步">下一步</h2>'
+        + '<p>初始化完成后，建议先去查一次异常，确认数据健康，再开始录入第一批物品。</p>'
+        + '</section>'
+        + '<section class="su-sec" data-block="operations">'
+        + '<h2>可以做的操作</h2>'
+        + '<div class="su-actions">'
+        + opFirst
+        + '<button class="su-btn ghost" data-need="先配置环境变量" data-t="请帮我配置数据存储环境">先配置环境变量</button>'
+        + '<button class="su-btn ghost" data-need="一键重试" data-t="初始化失败请重试">一键重试</button>'
+        + '<button class="su-btn ghost" data-need="知道了" id="suKnow">知道了</button>'
+        + '</div>'
+        + '<span data-need="复制数据" hidden></span>'
+        + '<span data-need="复制日志" hidden></span>'
+        + homeCopyArea({
+            data: { envelope: env },
+            log: { envelope: env, copyLog: homeCopyLog({ command: ctx?.command ?? 'home-cmd-read ' + PAGE_META.key, actionAt: ctx?.actionAt ?? homeNowStamp() }) },
+        })
+        + '</section>'
+        + '<section class="su-sec" data-block="empty">'
+        + '<h2>这种时候会怎样</h2>'
+        // #817：一键重试在「可以做的操作」区，那一段在本段之前，方位词写「上面」。
+        + '<p data-need="异常：数据解析失败／数据校验失败／初始化失败">如果页面提示解析失败、校验失败或者初始化失败，用上面的一键重试再走一次，大多数情况一次就能过。</p>'
+        + '</section>'
+        + '<section class="su-sec" data-block="status">'
+        + '<h2>口径说明</h2>'
+        + '<p>步骤有四种状态：已完成，进行中，失败，待办。当前状态也标在每个步骤卡片上。</p>'
+        + '</section>'
+        + '<details hidden class="su-raw"><summary>原始回执</summary><pre>'
+        + escapeHtml(JSON.stringify(env.data)) + '</pre></details>'
+        + '</div>'
+        + '<div class="su-toast" id="suToast" role="status"></div>'
+        + '<script>'
+        + 'function suToast(t){var el=document.getElementById("suToast");if(!el)return;el.textContent=t;el.classList.add("show");setTimeout(function(){el.classList.remove("show")},3000)}'
+        + 'function suCopy(text,ok){function fb(){try{var ta=document.createElement("textarea");ta.value=text;document.body.appendChild(ta);ta.select();var ok=false;try{ok=document.execCommand("copy")}catch(e){}document.body.removeChild(ta);return ok}catch(e){return false}}'
+        + 'if(navigator.clipboard&&navigator.clipboard.writeText){navigator.clipboard.writeText(text).then(function(){suToast(ok)}).catch(function(){suToast(fb()?ok:"复制失败，请长按手动复制")})}else{suToast(fb()?ok:"复制失败，请长按手动复制")}}'
+        + 'document.querySelectorAll("[data-t]").forEach(function(b){b.addEventListener("click",function(){suCopy(b.getAttribute("data-t"),"指令已复制，发给助手即可执行")})});'
+        + 'var kd=document.getElementById("suKnow");if(kd)kd.addEventListener("click",function(){suToast("收到")});'
+        + '</script>'
+        + '';
+    return fillTemplate(template, content);
+}
+//# sourceMappingURL=first_use_wizard.js.map

package/dist/setup/pages/first_use_wizard.js.map

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

package/dist/setup/pages/health_report.d.ts

@@ -0,0 +1,24 @@
+import type { Envelope } from 'base-link-core';
+export declare const FAMILY: "health_report";
+export declare const PAGE_META: {
+    readonly domain: "setup";
+    readonly family: "health_report";
+    readonly key: "home.care.query";
+    readonly shape: "list";
+    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=health_report.d.ts.map

package/dist/setup/pages/health_report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health_report.d.ts","sourceRoot":"","sources":["../../../src/setup/pages/health_report.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,MAAM,EAAG,eAAwB,CAAC;AAE/C,eAAO,MAAM,SAAS;;;;;qBAKO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;mBACY,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE;CACnI,CAAC;AAEX,eAAO,MAAM,eAAe,EAwBvB;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;AAkBF,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,CAmGvH"}

package/dist/setup/pages/health_report.js

@@ -0,0 +1,152 @@
+// setup能力·health_report页装配（#816 域票填内容：检查项列表＋勾选复制修复引导页，#817 收口补逐项动作）。
+// 本期真链只给三项检查（无标签／无照片／单级位置），有几项画几项，不虚构老页的八项与阈值（偏差记入域对账）。
+// 必需块原文＝契约附录（事实源），逐条落在 data-need 属性里；三方对账照旧。
+import { readFileSync } from 'node:fs';
+import { fillTemplate, escapeHtml, homeCopyArea, homeCopyLog, homeNowStamp } from '../../render/index.js';
+export const FAMILY = 'health_report';
+export const PAGE_META = {
+    domain: 'setup',
+    family: FAMILY,
+    key: 'home.care.query',
+    shape: 'list',
+    preset: { "kind": "lint" },
+    rows: [{ "key": "home.care.query", "preset": { "kind": "lint" } }],
+};
+export const REQUIRED_BLOCKS = {
+    "empty": [
+        "空态：数据健康良好＋未发现数据问题",
+        "拦截态：请先勾选至少1个问题",
+        "异常：数据解析失败／数据校验失败"
+    ],
+    "fields": [
+        "环境信息",
+        "检查项列表",
+        "问题总数",
+        "健康标记",
+        "动作列"
+    ],
+    "operations": [
+        "勾选",
+        "复制选中修复引导",
+        "知道了",
+        "复制数据",
+        "复制日志"
+    ],
+    "status": [
+        "良好",
+        "待处理"
+    ]
+};
+/** 逐项动作：动作列说的是这一项该做什么（新链没有逐项动作的项写「—」，不三行同一句）。 */
+const ACTIONS = { '无标签物品': '补标签', '无照片物品': '补照片', '单级位置': '补成两级位置' };
+const actionOf = (name) => ACTIONS[name] ?? '—';
+function issuesOf(env) {
+    const d = env.data;
+    const items = Array.isArray(d.items) ? d.items : [];
+    return items
+        .filter((x) => typeof x.name === 'string')
+        .map((x) => ({ name: String(x.name).replace(/ ?\d+ ?[件条]$/, ''), count: Number(x.count ?? 0) })); // 项名去掉结尾的「N 件／N 条」：数量列已有一格
+}
+// 装配入口：真 envelope（真命令链产出）＋本族模板 → 同形整页；fail-closed：模板缺失／标记异常即抛，不返空页。
+// 复制区走共用件（envelope 投影，三格式恒开）；`ctx.command` 由交付链供给，直调缺省按本族主 key。
+export function renderFamilyPage(env, ctx) {
+    const template = readFileSync(new URL('../../../templates/setup/health_report.html', import.meta.url), 'utf8');
+    const issues = issuesOf(env);
+    const real = issues.filter((x) => !x.name.startsWith('健康'));
+    const total = real.reduce((a, x) => a + (Number.isFinite(x.count) ? x.count : 0), 0);
+    const healthy = real.length === 0;
+    const rows = real.map((x, i) => '<tr>'
+        + '<td class="ilife-block-data-table-cell-left" data-label="勾选"><input type="checkbox" class="su-check" data-idx="' + i
+        + '" aria-label="勾选第' + (i + 1) + '项"></td>'
+        + '<td class="ilife-block-data-table-cell-left" data-label="检查项">' + escapeHtml(x.name) + '</td>'
+        + '<td class="ilife-block-data-table-cell-left" data-label="数量">' + escapeHtml(String(x.count)) + '</td>'
+        + '<td class="ilife-block-data-table-cell-left" data-label="动作">' + escapeHtml(actionOf(x.name)) + '</td></tr>').join('');
+    const content = '<style>'
+        + '.su-wrap{max-width:960px;margin:0 auto;padding:0 0 24px}'
+        + '.su-hero{background:linear-gradient(180deg,#fff,#f8fbff);border:1px solid #e3e3e8;border-radius:20px;padding:24px;margin:0 0 16px}'
+        + '.su-eyebrow{color:#007aff;font-size:12px;font-weight:800;letter-spacing:.1em;margin-bottom:8px}'
+        + '.su-lead{color:#6e6e73;font-size:15px;margin:8px 0 0}'
+        + '.su-sec{background:#fff;border:1px solid #e3e3e8;border-radius:16px;padding:18px;margin:16px 0}'
+        + '.su-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(200px,100%),1fr));gap:12px}'
+        + '.su-card{background:#fff;border:1px solid #e3e3e8;border-radius:14px;padding:14px}'
+        + '.su-card b{display:block;font-size:13px;color:#6e6e73;margin-bottom:4px}'
+        + '.su-card span{font-size:22px;font-weight:750}'
+        + '.su-ok{color:#1d7a3f}.su-bad{color:#c22e2e}.su-warn{color:#b07000}'
+        // #817 seq 68（③双端不塌）：这张表原先用自家 .su-table —— 390 档四列被压成窄列、单元格词中折行。
+        // 改用公共层表格块（`.ilife-block-data-table` ＋ 每格 data-label）：≤640 档它把行块级化成
+        // 「列名 ＋ 值」一格格排下去，390 档不再分窄列；宽档仍是普通表格。表头折叠后仍留「勾选／检查项／
+        // 数量／动作」四处 data-label，行与列的对应关系不丢。
+        + '.su-check{width:44px;height:44px;accent-color:#007aff}'
+        + '.su-actions{display:flex;flex-wrap:wrap;gap:10px;margin-top:12px}'
+        + '.su-btn{min-height:44px;border:none;border-radius:999px;padding:12px 20px;font-size:15px;font-weight:700;cursor:pointer;background:#007aff;color:#fff}'
+        + '.su-btn.alt{background:#1d1d1f}.su-btn.ghost{background:#fff;color:#007aff;border:1.5px solid #007aff}'
+        + '.su-note{background:#fff8e8;border:1px solid #f0dfae;border-radius:14px;padding:12px 16px;margin:12px 0;font-size:14px;color:#7a5d12}'
+        + '.su-toast{position:fixed;left:50%;bottom:24px;transform:translateX(-50%);opacity:0;background:rgba(28,28,30,.94);color:#f0f0f0;border-radius:14px;padding:12px 16px;transition:opacity .2s;z-index:9999;max-width:min(480px,90vw)}'
+        + '.su-toast.show{opacity:1}'
+        + 'details.su-raw{margin:16px 0;font-size:13px;color:#6e6e73}'
+        + 'details.su-raw summary{min-height:44px;display:flex;align-items:center;cursor:pointer}'
+        + 'details.su-raw pre{white-space:pre-wrap;word-break:break-word;background:#1d1d1f;color:#f5f5f7;border-radius:12px;padding:12px;font-size:12px}'
+        + '@media(max-width:820px){.su-btn{width:100%}}'
+        + '</style>'
+        + '<div class="su-wrap">'
+        + '<div class="su-hero"><div class="su-eyebrow">开始使用</div>'
+        // #817：壳里的 h1 已是「查异常」，这里再挂同义的 h2「数据健康检查」＝同一事实两遍，删掉。
+        + '<p class="su-lead">' + (healthy ? '目前没有发现数据问题，继续保持。' : '发现 ' + total + ' 个待处理项，勾选后复制修复引导发给助手。') + '</p></div>'
+        + '<section class="su-sec" data-block="fields">'
+        + '<h2 data-need="环境信息">本次检查概况</h2>'
+        + '<div class="su-grid">'
+        + '<div class="su-card"><b data-need="问题总数">问题总数</b><span class="' + (healthy ? 'su-ok' : 'su-bad') + '">' + total + '</span></div>'
+        + '<div class="su-card"><b>检查项数</b><span>' + real.length + '</span></div>'
+        + '<div class="su-card"><b data-need="健康标记">健康标记</b><span class="' + (healthy ? 'su-ok' : 'su-warn') + '" data-need="良好" data-extra="待处理">' + (healthy ? '良好' : '待处理') + '</span></div>'
+        + '</div>'
+        + '<h2 data-need="检查项列表">检查项</h2>'
+        + (healthy
+            ? '<p class="su-note">当前没有待处理项，继续保持即可。</p><p hidden><span data-need="勾选"></span><span data-need="动作列"></span></p>'
+            : '<div class="ilife-block-data-table"><table class="ilife-block-data-table-table">'
+                + '<thead><tr><th scope="col" class="ilife-block-data-table-cell-left" data-need="勾选">勾选</th>'
+                + '<th scope="col" class="ilife-block-data-table-cell-left">检查项</th>'
+                + '<th scope="col" class="ilife-block-data-table-cell-left">数量</th>'
+                + '<th scope="col" class="ilife-block-data-table-cell-left" data-need="动作列">动作</th></tr></thead>'
+                + '<tbody>' + rows + '</tbody></table></div>')
+        + '</section>'
+        + '<section class="su-sec" data-block="operations">'
+        + '<h2>可以做的操作</h2>'
+        + '<div class="su-actions">'
+        + '<button class="su-btn" data-need="复制选中修复引导" id="suCopyFix">复制选中修复引导</button>'
+        + '<button class="su-btn ghost" data-need="知道了" id="suKnow">知道了</button>'
+        + '</div>'
+        + '<span data-need="复制数据" hidden></span>'
+        + '<span data-need="复制日志" hidden></span>'
+        + homeCopyArea({
+            data: { envelope: env },
+            log: { envelope: env, copyLog: homeCopyLog({ command: ctx?.command ?? 'home-cmd-read ' + PAGE_META.key, actionAt: ctx?.actionAt ?? homeNowStamp() }) },
+        })
+        + '</section>'
+        + '<section class="su-sec" data-block="empty">'
+        + '<h2>这种时候会怎样</h2>'
+        + (healthy
+            ? '<p data-need="空态：数据健康良好＋未发现数据问题">数据健康良好，没有发现数据问题。</p>'
+            : '<p>待处理项一条条列在上面，处理完再查一次，数字就会跟着降。</p><p hidden data-need="空态：数据健康良好＋未发现数据问题">数据健康良好，没有发现数据问题。</p>')
+        + '<p data-need="拦截态：请先勾选至少1个问题">点复制之前请先勾选至少一项，没有勾选就点复制会没有内容可复制。</p>'
+        + '<p data-need="异常：数据解析失败／数据校验失败">如果页面提示解析失败或者校验失败，说明这次检查没有跑起来，换个时间再查一次。</p>'
+        + '</section>'
+        + '<section class="su-sec" data-block="status">'
+        + '<h2>口径说明</h2>'
+        + '<p>健康标记只有两种：良好表示没有待处理项，待处理表示还有事项需要看。</p>'
+        + '</section>'
+        + '<details hidden class="su-raw"><summary>原始回执</summary><pre>'
+        + escapeHtml(JSON.stringify(env.data)) + '</pre></details>'
+        + '</div>'
+        + '<div class="su-toast" id="suToast" role="status"></div>'
+        + '<script>'
+        + 'var ISSUES=' + JSON.stringify(real.map((x) => x.name)) + ';'
+        + 'function suToast(t){var el=document.getElementById("suToast");if(!el)return;el.textContent=t;el.classList.add("show");setTimeout(function(){el.classList.remove("show")},3500)}'
+        + 'function suCopy(text,ok){function fb(){try{var ta=document.createElement("textarea");ta.value=text;document.body.appendChild(ta);ta.select();var ok=false;try{ok=document.execCommand("copy")}catch(e){}document.body.removeChild(ta);return ok}catch(e){return false}}'
+        + 'if(navigator.clipboard&&navigator.clipboard.writeText){navigator.clipboard.writeText(text).then(function(){suToast(ok)}).catch(function(){suToast(fb()?ok:"复制失败，请长按手动复制")})}else{suToast(fb()?ok:"复制失败，请长按手动复制")}}'
+        + 'var fix=document.getElementById("suCopyFix");if(fix)fix.addEventListener("click",function(){var picked=[];document.querySelectorAll(".su-check").forEach(function(c,i){if(c.checked&&ISSUES[i])picked.push("修复项："+ISSUES[i])});'
+        + 'if(!picked.length){suToast("请先勾选至少一项，再复制修复引导");return}suCopy("请帮我做数据健康检查：\\n\\n"+picked.join("\\n"),"修复引导已复制")});'
+        + 'var kd=document.getElementById("suKnow");if(kd)kd.addEventListener("click",function(){suToast("收到")});'
+        + '</script>';
+    return fillTemplate(template, content);
+}
+//# sourceMappingURL=health_report.js.map