skill-bill 0.1.0 → 0.2.0

package/dist/shared/userWording.d.ts

@@ -0,0 +1,54 @@
+/** 用户语言映射（**唯一定义地**）：把内部标识符换成记账人看得懂的说法，页面、回执、复制载荷一律走这里。
+ *
+ * 谁在用（两个调用点，指名）：
+ *   ① `src/record/` 的 16 件场景件——类型徽章的唤醒词与状态说明、字段名的中文标签都取自本件；
+ *   ② `src/shared/` 的同层共用件（`typeBadge.ts`／`summaryRow.ts`／`blockedSlots.ts` 这批）——同一句话不各写一份。
+ *  本票实测：本包 `src/` 下真引用本件的就是这两个去处，再无第三处。
+ *
+ * 为什么另立一件：内部标识符与用户说法是**一对多**的映射（同一个 `amount` 在金额格叫「金额」、在缺口清单里叫「金额」、
+ *  在字段表里叫「金额」），散在各页各写一句就会走散；本件把这张对照表只写一遍，别处只引用。
+ *
+ * 对外五件（铁律五「不多于五个」）：
+ *   - `wakeWordOf`——内部型名 → 唤醒词（`expense` → 记支出）；
+ *   - `statusNoteOf`——内部状态串 → 用户说法（`软删打标（deleted_at = now，不物理删）` → 已撤销，记录还在，随时可恢复）；
+ *   - `fieldLabelOf`——库列名 → 中文列名（`deleted_at` → 撤销标记）；
+ *   - `nextStepOf`——这一页现在该做什么（「下一步动作」那枚形状的取值）。
+ *   - `badgeTextOf`——摆进徽标前把行内 `·` 换成全角空格（版式位收口，只做标点替换）。
+ *
+ * **不进用户可见处**的两类（照上级裁定第 1 条）：命令名 `bill.record.add`／`bill.record.update` 与
+ *  `data-t` 复制载荷里那一行「场景标识」——它们只活在复制给助手的载荷里，页面正文与徽章一个字都不印。
+ *
+ * 口径出处：`docs/skills/skill-bill/t407-文字审查.md` 第二节逐条（页／位置／原文逐字／最小改法字面）
+ *  ＋ `docs/skills/skill-bill/t407-机审读数.md` 第三节（英文裸词那一列逐行）。
+ */
+/** 内部状态串 → 用户说法；认不得的原样返回（**不猜、不静默抹掉**）。空串＝这一句不上屏。 */
+export declare function statusNoteOf(state: string): string;
+/** 内部型名 → 唤醒词；认不得的型名与空串都给「记一笔」（通用词那一件，与 `src/record/scene.ts` 的兜底同口径）。 */
+export declare function wakeWordOf(kind: unknown): string;
+/** 库列名 → 中文列名；认不得的原样返回（照实印出，不假装认得出）。 */
+export declare function fieldLabelOf(name: string): string;
+/** 一句要摆进**徽标**的话（候选依据、分段现状这类）：把行内那个 `·` 换成全角空格。
+ *
+ *  为什么单立这一件：徽标是版式位，行内拿 `·` 当版式就是「分隔符懒政」那一列命中的根源
+ *  （`docs/skills/skill-bill/t407-机审读数.md` 第三节）。徽标里的话由上游各页拼出来、写法各异，
+ *  与其在十几个调用点各改一遍，不如在**摆进徽标的那一刻**统一收口——这里是那唯一的一处。
+ *  只换 `·`（U+00B7）：`·` 两边的半角空格一并吃掉（`甲 · 乙` 与 `甲·乙` 都收成 `甲　乙`），
+ *  别的标点一律不碰：句末分号、顿号、括号都是正经标点。 */
+export declare function badgeTextOf(text: string): string;
+/** 这一页现在该做什么（「下一步动作」那枚形状的取值）。
+ *
+ *  四档按「这一页缺什么」选，**不按内部状态选**：
+ *   - `missing > 0`：还差 `missing` 项，补齐了再说一遍唤醒词（`wakeWord` 为空串＝不点唤醒词，只剩前半句）；
+ *   - 采集页（`page: 'collect'`）不缺项：核一眼就可以照着下面那句复制；
+ *   - 回执页（`page: 'receipt'`）：这一笔已经记下了，不用再做什么；
+ *   - 回执页带 `exit`：还想反悔就用下面那颗「撤销这一笔」。
+ *  R3 改形状：回执带退出口那档原先一句拿分号串两件事
+ *  （`…不用再做什么；要反悔就点下面的「撤销这一笔」。`，回执 7 页同句）。
+ *  现写成两句整句（句号断开），由 `typeBadge` 按句分行各出一行口径；不再用分号串版式。 */
+export declare function nextStepOf(input: {
+    readonly page: 'collect' | 'receipt';
+    readonly missing?: number;
+    readonly wakeWord?: string;
+    readonly exit?: boolean;
+}): string;
+//# sourceMappingURL=userWording.d.ts.map

package/dist/shared/userWording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userWording.d.ts","sourceRoot":"","sources":["../../src/shared/userWording.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AA4DH,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAGhD;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;;;;;iCAMiC;AACjC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;;;uDASuD;AACvD,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,MAAM,CAST"}

package/dist/shared/userWording.js

@@ -0,0 +1,131 @@
+/** 用户语言映射（**唯一定义地**）：把内部标识符换成记账人看得懂的说法，页面、回执、复制载荷一律走这里。
+ *
+ * 谁在用（两个调用点，指名）：
+ *   ① `src/record/` 的 16 件场景件——类型徽章的唤醒词与状态说明、字段名的中文标签都取自本件；
+ *   ② `src/shared/` 的同层共用件（`typeBadge.ts`／`summaryRow.ts`／`blockedSlots.ts` 这批）——同一句话不各写一份。
+ *  本票实测：本包 `src/` 下真引用本件的就是这两个去处，再无第三处。
+ *
+ * 为什么另立一件：内部标识符与用户说法是**一对多**的映射（同一个 `amount` 在金额格叫「金额」、在缺口清单里叫「金额」、
+ *  在字段表里叫「金额」），散在各页各写一句就会走散；本件把这张对照表只写一遍，别处只引用。
+ *
+ * 对外五件（铁律五「不多于五个」）：
+ *   - `wakeWordOf`——内部型名 → 唤醒词（`expense` → 记支出）；
+ *   - `statusNoteOf`——内部状态串 → 用户说法（`软删打标（deleted_at = now，不物理删）` → 已撤销，记录还在，随时可恢复）；
+ *   - `fieldLabelOf`——库列名 → 中文列名（`deleted_at` → 撤销标记）；
+ *   - `nextStepOf`——这一页现在该做什么（「下一步动作」那枚形状的取值）。
+ *   - `badgeTextOf`——摆进徽标前把行内 `·` 换成全角空格（版式位收口，只做标点替换）。
+ *
+ * **不进用户可见处**的两类（照上级裁定第 1 条）：命令名 `bill.record.add`／`bill.record.update` 与
+ *  `data-t` 复制载荷里那一行「场景标识」——它们只活在复制给助手的载荷里，页面正文与徽章一个字都不印。
+ *
+ * 口径出处：`docs/skills/skill-bill/t407-文字审查.md` 第二节逐条（页／位置／原文逐字／最小改法字面）
+ *  ＋ `docs/skills/skill-bill/t407-机审读数.md` 第三节（英文裸词那一列逐行）。
+ */
+/** 内部标识符 → 用户说法。四张表都**只在这里定义一次**，别处不许再写第二份。 */
+/** ① 库列名 → 中文列名（字段表、缺口清单、回执明细都读它）。 */
+const FIELD_LABELS = {
+    id: '记录编号',
+    category: '分类',
+    amount: '金额',
+    time: '时间',
+    account: '账户',
+    ledger: '账本',
+    currency: '币种',
+    note: '备注',
+    source_id: '原记录编号',
+    who: '往来对象',
+    total: '总额',
+    periods: '期数',
+    start_date: '首期日',
+    deleted_at: '撤销标记',
+    op: '这一步做什么',
+};
+/** ② 内部型名 → 唤醒词（类型徽章第一枚形状、回执页页标题都读它）。 */
+const WAKE_WORDS = {
+    expense: '记支出',
+    income: '记收入',
+    photo: '拍账单',
+    batch: '批量录入',
+    refund: '记退款',
+    reimburse: '记报销',
+    'reimburse-done': '报销到账',
+    lend: '记借出',
+    borrow: '记借入',
+    collect: '记收回',
+    repay: '记偿还',
+    installment: '记分期',
+    plain: '记一笔',
+};
+/** ③ 内部状态串 → 用户说法。表里的名字逐字取自页面现状（`docs/skills/skill-bill/t407-机审读数.md` 第三节的原文）。
+ *  撤销／恢复两态照上级口径逐字：`deleted_at＝now` →「已撤销，记录还在，随时可恢复」、
+ *  置 NULL →「已恢复」；「本仓尚未定额的型」→「分类按三级挂靠」（人话，不隐藏）。 */
+const STATUS_NOTES = {
+    '软删打标（deleted_at = now，不物理删）': '已撤销，记录还在，随时可恢复',
+    '软删打标（deleted_at = now，行还在）': '已撤销，记录还在，随时可恢复',
+    '置 NULL（deleted_at 清空）': '已恢复',
+    '三形态之一：缺记录编号 · 先挑一条': '先挑一条记录',
+    '落库回执': '这一笔已保存',
+    '批量·现单笔化': '一次只落一笔',
+    '本仓尚未定额的型': '分类按三级挂靠',
+    '按金额符号判支出／收入': '方向按金额符号判',
+    '待补槽位 · 未写库（已阻断）': '还没写库',
+    '待补槽位 · 未写库': '还没写库',
+    '待核对 · 未写库': '还没写库',
+    '写库成功': '这一笔已保存',
+    '写库成功（收入取正数）': '这一笔已保存',
+    '写库成功（方向按金额符号判）': '这一笔已保存',
+};
+/** 内部状态串 → 用户说法；认不得的原样返回（**不猜、不静默抹掉**）。空串＝这一句不上屏。 */
+export function statusNoteOf(state) {
+    if (typeof state !== 'string')
+        return '';
+    const hit = STATUS_NOTES[state.trim()];
+    return hit === undefined ? state.trim() : hit;
+}
+/** 内部型名 → 唤醒词；认不得的型名与空串都给「记一笔」（通用词那一件，与 `src/record/scene.ts` 的兜底同口径）。 */
+export function wakeWordOf(kind) {
+    const k = typeof kind === 'string' ? kind.trim() : '';
+    return k === '' ? '记一笔' : (WAKE_WORDS[k] ?? '记一笔');
+}
+/** 库列名 → 中文列名；认不得的原样返回（照实印出，不假装认得出）。 */
+export function fieldLabelOf(name) {
+    if (typeof name !== 'string')
+        return '';
+    const k = name.trim();
+    if (k === '')
+        return '';
+    return FIELD_LABELS[k] ?? k;
+}
+/** 一句要摆进**徽标**的话（候选依据、分段现状这类）：把行内那个 `·` 换成全角空格。
+ *
+ *  为什么单立这一件：徽标是版式位，行内拿 `·` 当版式就是「分隔符懒政」那一列命中的根源
+ *  （`docs/skills/skill-bill/t407-机审读数.md` 第三节）。徽标里的话由上游各页拼出来、写法各异，
+ *  与其在十几个调用点各改一遍，不如在**摆进徽标的那一刻**统一收口——这里是那唯一的一处。
+ *  只换 `·`（U+00B7）：`·` 两边的半角空格一并吃掉（`甲 · 乙` 与 `甲·乙` 都收成 `甲　乙`），
+ *  别的标点一律不碰：句末分号、顿号、括号都是正经标点。 */
+export function badgeTextOf(text) {
+    return typeof text === 'string' ? text.replace(/[ \t]*·[ \t]*/g, '　').trim() : '';
+}
+/** 这一页现在该做什么（「下一步动作」那枚形状的取值）。
+ *
+ *  四档按「这一页缺什么」选，**不按内部状态选**：
+ *   - `missing > 0`：还差 `missing` 项，补齐了再说一遍唤醒词（`wakeWord` 为空串＝不点唤醒词，只剩前半句）；
+ *   - 采集页（`page: 'collect'`）不缺项：核一眼就可以照着下面那句复制；
+ *   - 回执页（`page: 'receipt'`）：这一笔已经记下了，不用再做什么；
+ *   - 回执页带 `exit`：还想反悔就用下面那颗「撤销这一笔」。
+ *  R3 改形状：回执带退出口那档原先一句拿分号串两件事
+ *  （`…不用再做什么；要反悔就点下面的「撤销这一笔」。`，回执 7 页同句）。
+ *  现写成两句整句（句号断开），由 `typeBadge` 按句分行各出一行口径；不再用分号串版式。 */
+export function nextStepOf(input) {
+    const n = input.missing ?? 0;
+    if (n > 0) {
+        const word = input.wakeWord === undefined || input.wakeWord === '' ? '' : '，再说一遍「' + input.wakeWord + '」';
+        return '还差 ' + n + ' 项：补齐了' + word + '。';
+    }
+    if (input.page === 'collect')
+        return '这一页先不写库；看准了就照下面那句复制。';
+    if (input.exit === true)
+        return '这一笔已经记下了，不用再做什么。要反悔就点下面的「撤销这一笔」。';
+    return '这一笔已经记下了，不用再做什么。';
+}
+//# sourceMappingURL=userWording.js.map

package/dist/shared/userWording.js.map

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

package/dist/shared/writeParts.d.ts

@@ -0,0 +1,62 @@
+/** 写命令回执的共用件（**唯一定义地**）：回执事实的形状（`BillReceipt`）＋ 影响行数口径（`totalChanges`）
+ *  ＋ 页面的 `<section>` 段（`writeSection`）＋ 命令原文（`commandLine`）。**对外五件**；三字符转义（`esc`）只在本件内部
+ *  给 `writeSection` 用，不转出去（铁律五：接口小、里面厚）。
+ *
+ * 谁在用（两个能力，指名）：
+ *   ① `src/record/`——写入域：两条写命令的处理体（影响行数取前后差、回执事实在这里装配、命令原文在这里拼），
+ *      过程型采集页与结果型回执整页的 `<section>` 段；
+ *   ② `src/query/`——查询域：四条读命令的处理体用 `commandLine` 拼复制载荷与日志的命令原文，
+ *      通用查询列表页的 `<section>` 段同走 `writeSection`（槽位 `list`）。
+ *  （页面三个公共标识另立 `./pageIdentity.ts`：那是另一件活——标识取值，不是回执与 `<section>` 段。）
+ *  （页面三个公共标识另立 `./pageIdentity.ts`：那是另一件活——标识取值，不是回执与 `<section>` 段。）
+ *
+ * 口径出处：
+ *   - 影响行数＝SQLite `total_changes()` 在本次写库前后的增量（`INSERT`／`UPDATE`／软删标记一律计），
+ *     与 `packages/skill-calorie/src/shared/writeParts.ts:38` 同一口径，**非自报**；
+ *   - 回执 `<section>` 的槽位取值照卡路里同件的 `ilife:<技能>:<槽位>` 形状。
+ *
+ * 转义口径（**不得与公共层 `escapeHtml` 互换**）：本件 `esc` 只转 `&`／`<`／`>` 三字符；
+ *   公共层 `escapeHtml`（`base-paint`）与 `src/render/html.ts:7` 的那份都转五字符（多 `"`／`'`）。
+ *   两者混用会静默改产物（`docs/skills/skill-bill/t406-共用件依赖与提升改造清单.md` 第二节 `esc` 行）。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { RecordOp } from '../policy/record.js';
+/** 一次写库的事实（回执页与复制日志都读它）。
+ *  形状照卡路里同件的收据对象，只留饼干用得上的：操作／记录号／摘要／影响行数／写入字段／有无改动／来源／时刻。
+ *  `noChange` 承接「值与改前一致」那一格，一页只出现这一处。 */
+export interface BillReceipt {
+    readonly op: RecordOp;
+    readonly recordId: number | null;
+    readonly summary: string;
+    readonly affectedRows: number;
+    readonly writtenFields: readonly string[];
+    readonly noChange: boolean;
+    /** 本次数据从哪里来（复制日志第 3 段；库文件名逐字由调用方给，共用件不取本包文件名）。 */
+    readonly source: string;
+    /** 写入时刻（本地时钟，`YYYY-MM-DD HH:MM:SS`）。 */
+    readonly actionAt: string;
+}
+/** 回执格式串（页尾对账折叠区那一行）；本票口径 `v1`。 */
+export declare const RECEIPT_FORMAT = "v1\uFF08\u5199\u5E93\u56DE\u6267\uFF09";
+/** 影响行数口径：SQLite `total_changes()` 的当前值；调用方取「写库前」与「写库后」两次之差。 */
+export declare function totalChanges(db: DatabaseSync): number;
+/** 本次执行的命令原文（复制 prompt 区与复制日志第 4 段共用）：与助手实跑那条同形，含本次 `--params`，可照抄重跑。
+ *  参数值里若出现半角单引号，原文会在此处被截断——真要照抄重跑请自行转义（本仓命令原文一贯用单引号包 JSON）。 */
+export declare function commandLine(key: string, params: Record<string, unknown>): string;
+/** 页面域内的 `<section>` 段：`data-slot`（`receipt`＝结果型回执整页、`collect`＝过程型采集页、
+ *  `list`＝查询域列表页）＋ 四个机器标记 ＋ 正文。
+ *  标记：`data-skill`（技能名，取值同页标识）／`data-slot`（页型槽位，取值见上）
+ *  ／`data-shape`（＝本次 envelope 的形状，与老回执页同一枚，**是契约、不随页型改**）
+ *  ／`data-page`（**选页用这一枚**：`collect`／`receipt`／`list`；回执页与采集页共用 `shape=receipt`，靠 shape 选页会选错）
+ *  ／`data-key`（**场景名**，过 `sceneKeyOf`：`bill.record.add` → `record.add`）。
+ *  R4 收口（写域）：`bill.` 只许出现在复制载荷区（`pre`／复制块／`data-t`），页面标记一律写场景名；
+ *  要整名时 `data-skill` ＋ `.` ＋ `data-key` 仍拼得回来。
+ *  H1 与副标题**不在这里**：那是页面模板（`base-paint/blocks` 的 `renderPageShell`）的活，一处只出一次。 */
+export declare function writeSection(input: {
+    readonly slot: 'receipt' | 'collect' | 'list';
+    readonly page: 'receipt' | 'collect' | 'list';
+    readonly shape: string;
+    readonly key: string;
+    readonly content: string;
+}): string;
+//# sourceMappingURL=writeParts.d.ts.map

package/dist/shared/writeParts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeParts.d.ts","sourceRoot":"","sources":["../../src/shared/writeParts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD;;yCAEyC;AACzC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,mCAAmC;AACnC,eAAO,MAAM,cAAc,2CAAa,CAAC;AAOzC,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAGrD;AAED;+DAC+D;AAC/D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEhF;AAUD;;;;;;;;gFAQgF;AAChF,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAIT"}

package/dist/shared/writeParts.js

@@ -0,0 +1,39 @@
+import { DOC_SKILL, sceneKeyOf } from './pageIdentity.js';
+/** 回执格式串（页尾对账折叠区那一行）；本票口径 `v1`。 */
+export const RECEIPT_FORMAT = 'v1（写库回执）';
+/** 三字符转义：只转 `&`／`<`／`>`。**不得与五字符的 `escapeHtml` 互换**（见文件头）；只给本件的 `<section>` 段用。 */
+function esc(s) {
+    return String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+/** 影响行数口径：SQLite `total_changes()` 的当前值；调用方取「写库前」与「写库后」两次之差。 */
+export function totalChanges(db) {
+    const row = db.prepare('SELECT total_changes() AS n').get();
+    return row && typeof row.n === 'number' ? Number(row.n) : 0;
+}
+/** 本次执行的命令原文（复制 prompt 区与复制日志第 4 段共用）：与助手实跑那条同形，含本次 `--params`，可照抄重跑。
+ *  参数值里若出现半角单引号，原文会在此处被截断——真要照抄重跑请自行转义（本仓命令原文一贯用单引号包 JSON）。 */
+export function commandLine(key, params) {
+    return 'bill-cmd-read ' + key + " --params '" + JSON.stringify(params) + "'";
+}
+/** `<section>` 上的类名（按槽位取值）。写域两页沿用已交付产物上的 `ilife-write`（32 份产物与验收墙按它，
+ *  本票一字不动）；查询域列表页用自己那一枚 `ilife-list`——同一份整页不该顶着「write」这个类名走。 */
+const SECTION_CLASS = {
+    receipt: 'ilife-write',
+    collect: 'ilife-write',
+    list: 'ilife-list',
+};
+/** 页面域内的 `<section>` 段：`data-slot`（`receipt`＝结果型回执整页、`collect`＝过程型采集页、
+ *  `list`＝查询域列表页）＋ 四个机器标记 ＋ 正文。
+ *  标记：`data-skill`（技能名，取值同页标识）／`data-slot`（页型槽位，取值见上）
+ *  ／`data-shape`（＝本次 envelope 的形状，与老回执页同一枚，**是契约、不随页型改**）
+ *  ／`data-page`（**选页用这一枚**：`collect`／`receipt`／`list`；回执页与采集页共用 `shape=receipt`，靠 shape 选页会选错）
+ *  ／`data-key`（**场景名**，过 `sceneKeyOf`：`bill.record.add` → `record.add`）。
+ *  R4 收口（写域）：`bill.` 只许出现在复制载荷区（`pre`／复制块／`data-t`），页面标记一律写场景名；
+ *  要整名时 `data-skill` ＋ `.` ＋ `data-key` 仍拼得回来。
+ *  H1 与副标题**不在这里**：那是页面模板（`base-paint/blocks` 的 `renderPageShell`）的活，一处只出一次。 */
+export function writeSection(input) {
+    return '<section class="' + SECTION_CLASS[input.slot] + '" data-skill="' + DOC_SKILL + '" data-slot="ilife:bill:' + input.slot
+        + '" data-page="' + input.page + '" data-shape="' + esc(input.shape) + '" data-key="' + esc(sceneKeyOf(input.key)) + '">'
+        + input.content + '</section>';
+}
+//# sourceMappingURL=writeParts.js.map

package/dist/shared/writeParts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeParts.js","sourceRoot":"","sources":["../../src/shared/writeParts.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAkB1D,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AAEzC,mFAAmF;AACnF,SAAS,GAAG,CAAC,CAAU;IACrB,OAAO,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5F,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,EAAgB;IAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,GAAG,EAAgC,CAAC;IAC1F,OAAO,GAAG,IAAI,OAAO,GAAG,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;+DAC+D;AAC/D,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,MAA+B;IACtE,OAAO,gBAAgB,GAAG,GAAG,GAAG,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;AAC/E,CAAC;AAED;gEACgE;AAChE,MAAM,aAAa,GAA6D;IAC9E,OAAO,EAAE,aAAa;IACtB,OAAO,EAAE,aAAa;IACtB,IAAI,EAAE,YAAY;CACnB,CAAC;AAEF;;;;;;;;gFAQgF;AAChF,MAAM,UAAU,YAAY,CAAC,KAM5B;IACC,OAAO,kBAAkB,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,GAAG,SAAS,GAAG,0BAA0B,GAAG,KAAK,CAAC,IAAI;UAC1H,eAAe,GAAG,KAAK,CAAC,IAAI,GAAG,gBAAgB,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,cAAc,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI;UACvH,KAAK,CAAC,OAAO,GAAG,YAAY,CAAC;AACnC,CAAC"}

package/dist/triggers/wake-assets.d.ts

@@ -0,0 +1,37 @@
+/** 徽章类型词（老实物用到的全集；共享 help 模板 `TYPE_DEFAULT` 认得这些词，缺席即配色表要改）。 */
+export type WakeSceneType = '采集' | '查看' | '选择' | '向导' | '回执';
+export interface WakeSceneAsset {
+    readonly id: string;
+    readonly title: string;
+    readonly wake_word: string;
+    /** 老实物 71/71 为空串（可用）；`【待开发】` 为本仓预留态。 */
+    readonly status: string;
+    /** 「复制指令」按钮按出来的正文，逐字保留。 */
+    readonly prompt_template: string;
+    readonly types: readonly WakeSceneType[];
+}
+export interface WakeSubgroupAsset {
+    readonly id: string;
+    readonly label: string;
+    readonly scenes: readonly WakeSceneAsset[];
+}
+export interface WakeGroupAsset {
+    readonly id: string;
+    readonly icon: string;
+    readonly label: string;
+    readonly subgroups: readonly WakeSubgroupAsset[];
+}
+/** 7 域／20 二级组／74 场景（老 71 逐字 ＋ 新增 3 条接在对应二级组末尾）。 */
+export declare const WAKE_GROUPS: readonly WakeGroupAsset[];
+/** 扁平 74 条（顺序与 HELP 分组一致；单源派生，不重复落词）。 */
+export declare const WAKE_ASSETS: readonly WakeSceneAsset[];
+/** id → 场景（74/74 唯一）。 */
+export declare const SCENE_BY_ID: Readonly<Record<string, WakeSceneAsset>>;
+/** 资产总数（由 `WAKE_ASSETS` 派生，单源不复写第二遍数；改资产即跟变，测试仍钉 74）。 */
+export declare const WAKE_ASSET_TOTAL: number;
+/** HELP 自身的唤醒词（老实物 `meta_blocks.help_wake_words` 那一块；4 条，不进场景目录）。
+ *
+ * 从口径层 `WAKE_TABLE` **派生**而非复写：口径层是唤醒词的单一事实源，本文件只投影。
+ * （老实物写的是「饼干记账 帮助」（带空格），现表口径为「饼干记账帮助」——以现表为准。） */
+export declare const HELP_WAKE_WORDS: readonly string[];
+//# sourceMappingURL=wake-assets.d.ts.map

package/dist/triggers/wake-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wake-assets.d.ts","sourceRoot":"","sources":["../../src/triggers/wake-assets.ts"],"names":[],"mappings":"AA0BA,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD;AAED,mDAAmD;AACnD,eAAO,MAAM,WAAW,EAAE,SAAS,cAAc,EA84BhD,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,WAAW,EAAE,SAAS,cAAc,EAEhD,CAAC;AAEF,yBAAyB;AACzB,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAEhE,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,EAAE,MAA2B,CAAC;AAE3D;;;kDAGkD;AAClD,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAEtB,CAAC"}