skill-bill 0.1.0 → 0.2.0

package/dist/record/write.js

@@ -0,0 +1,186 @@
+/** 记账写入域两条命令的处理体（**从 `src/cli/cmd_read.ts` 归位到这里**）：
+ *  `bill.record.add`（记一笔）与 `bill.record.update`（改记录，op＝改字段／撤销／恢复）。
+ *
+ * 谁在用（两个调用点，指名）：`src/record/commands.ts` 的两条声明各引一支——
+ *   `writeRecordAdd` 引给 `bill.record.add`，`writeRecordUpdate` 引给 `bill.record.update`；
+ *   出口分派 `src/cli/cmd_read.ts` 只查注册表再调 `runRecordWrite`，不再认这两个命令名。
+ *
+ * 两支的分岔口径（本票的新规矩）：
+ *   **有阻断项不再报参数错退出**，改出过程型采集页（`./collect.ts`），退出码 0、`ok:false`、不写库；
+ *   阻断项＝必需的槽位没给（`./collect.ts` 的 `missingSlots`）**或**金额符号与这一型的方向不符
+ *   （`../shared/blockedSlots.ts` 的 `blockedItems`：记支出要负数、记收入要正数）。两件都由 `blockedItems`
+ *   合成一张表，**非空即不进写库那一步**——这就是「真阻断」的根，页上那条阻断条只是它的影子。
+ *   **方向判定只服务录入路径**：`writeRecordAdd`（`bill.record.add`）那一支传 `kind` 才判方向；
+ *   `writeRecordUpdate`（改字段／撤销／恢复三支）不传方向，那三支只按「缺的必需槽位」阻断。
+ *   阻断项清空照旧写库，出结果型回执整页（`./receipt.ts`）。
+ *   必需槽位是哪些住 `./collect.ts` 的 `RECORD_SLOTS`（唯一定义地）；真值校验仍走 `src/policy`
+ *   （`validateAddInput`／`validateUpdateInput`／`needId`／`parseRecordOp`），取数写库仍走 `src/fetch`
+ *   （`addBill`／`updateBill`／`undoBill`／`restoreBill`），本文件只做编排与回执事实装配。
+ * 写入字段口径：记一笔写整列全集（含缺省值列）；改字段＝本次实际变更的列；撤销／恢复写的是 `deleted_at`。
+ */
+import { addBill, updateBill, undoBill, restoreBill, getById, listRecent, DB_FILENAME } from '../fetch/index.js';
+import { needId, parseRecordOp, validateAddInput, validateUpdateInput } from '../policy/index.js';
+import { buildRecordReceipt } from '../render/views.js';
+import { blockedItems, blockedMessage } from '../shared/blockedSlots.js';
+import { fieldLabelOf, statusNoteOf, wakeWordOf } from '../shared/userWording.js';
+import { totalChanges } from '../shared/writeParts.js';
+import { actionStamp } from '../shared/copyArea.js';
+import { RECORD_SLOTS, missingSlots, recordCollectDoc } from './collect.js';
+import { recordReceiptDoc } from './receipt.js';
+/** 记一笔写进库的列全集（**由槽位表派生，同一件事实一处定义**）：`add` 那一行的七个参数名就是它写进库的七个列
+ *  （缺省值列也算写入：时间／账户／账本／币种都带缺省）。名单只有 `./collect.ts` 的 `RECORD_SLOTS` 一处。 */
+const ADD_FIELDS = RECORD_SLOTS['bill.record.add'].map((s) => s.name);
+/** 近期记录的回看天数（预填标注／重复检测／三枚选择器的候选都取这一段）。 */
+const RECENT_WINDOW_DAYS = 90;
+/** 本次数据来源（复制日志第 3 段）；库文件名逐字取本包常量，共用件不取。**两页各一句**：
+ *  回执页那句说的是写库回执，采集页不写库，不许沿用回执页那句（改前两页共用一句，采集页照抄了「写库回执」）。
+ *  本轮整改删掉两处内部话（照 `docs/skills/skill-bill/t407-文字审查.md` 第 57、58 条）：库内表名 `bills` 与
+ *  `prompt` 那个英文词都不上屏；`本地时钟` 只留在复制日志的时间戳里（那里是过程证据，正文不印）。 */
+const SOURCE_RECEIPT = DB_FILENAME + '（写库回执）';
+const SOURCE_COLLECT = DB_FILENAME + '（只读：这一页先不写库，只采集）';
+/** 本地时钟时刻串（写入时间与复制日志时间戳）。**取时钟在这一步，不在共用位**——取值口径住
+ *  `../shared/copyArea.js` 的 `actionStamp`（写域与查询域两种页共用同一份，本件只调它）。 */
+function nowStamp() {
+    return actionStamp();
+}
+/** 本页执行那天（`YYYY-MM-DD`）：缺省时间的取值与重复检测的比对面用它。 */
+function todayOf() {
+    return new Date().toISOString().slice(0, 10);
+}
+/** 库内那一行写进明细表的项名（**库列名不上屏**：行名走 `../shared/userWording.js` 的 `fieldLabelOf`）。 */
+function rowDetail(r) {
+    return [
+        { k: fieldLabelOf('id'), v: String(r.id) },
+        { k: fieldLabelOf('category'), v: r.category },
+        { k: fieldLabelOf('amount'), v: r.amount.toFixed(2) },
+        { k: fieldLabelOf('time'), v: r.time },
+        { k: fieldLabelOf('account'), v: r.account },
+        { k: fieldLabelOf('ledger'), v: r.ledger },
+        { k: fieldLabelOf('currency'), v: r.currency },
+        { k: fieldLabelOf('note'), v: r.note },
+    ];
+}
+/** 库内那一列在改前的值。字段名只认 `BillRow` 上真有的列——形状写得出（铁律三），
+ *  不拿 `unknown` 中转成宽字典再按变长字符串取字段。`patch` 那一边由 `src/policy` 的
+ *  `validateUpdateInput` 校验过字段与值，这里只读回来比对。 */
+function preValue(pre, column) {
+    return Object.prototype.hasOwnProperty.call(pre, column) ? pre[column] : undefined;
+}
+/** 摘要行的事实：回执页取**库内那一行**（不是拿 params 顶——回执报的是库里的真值）。 */
+function rowFacts(r) {
+    return { amount: r.amount, category: r.category, account: r.account, ledger: r.ledger, time: r.time };
+}
+/** 有阻断项时的那一支：出过程型采集页（不写库、`ok:false`）。
+ *  取数只此一处：`listRecent` 取回的近期记录，预填标注／重复检测／三枚选择器的候选三处共用。 */
+function collectOut(input) {
+    const message = blockedMessage(input.missing, input.blocked);
+    const today = todayOf();
+    const anchor = typeof input.params['time'] === 'string' ? String(input.params['time']) : today;
+    return {
+        data: { ok: false, message },
+        html: recordCollectDoc({
+            key: input.key,
+            params: input.params,
+            slots: input.slots,
+            missing: input.missing,
+            source: SOURCE_COLLECT,
+            actionAt: nowStamp(),
+            today,
+            recent: listRecent(input.db, anchor, RECENT_WINDOW_DAYS),
+        }),
+    };
+}
+/** 写库成功后的收口：回执事实 ＋ envelope 载荷 ＋ 回执整页。 */
+function finish(input) {
+    const receipt = {
+        op: input.op,
+        recordId: input.row.id,
+        summary: input.summary,
+        affectedRows: totalChanges(input.db.db) - input.before,
+        writtenFields: input.fields,
+        noChange: input.noChange,
+        source: SOURCE_RECEIPT,
+        actionAt: nowStamp(),
+    };
+    return {
+        data: { ...buildRecordReceipt(input.summary), receipt },
+        html: recordReceiptDoc({
+            key: input.key, params: input.params, receipt,
+            writtenDetail: input.writtenDetail, detail: input.detail,
+            facts: rowFacts(input.row),
+            recent: listRecent(input.db, input.row.time, RECENT_WINDOW_DAYS),
+        }),
+    };
+}
+/** `bill.record.add`（记一笔，**录入路径**）：有阻断项（缺分类或金额／金额符号与这一型不符）即出采集页，
+ *  清空即写库出回执整页。方向判定只在这一支传 `kind`。 */
+export function writeRecordAdd(params, db) {
+    const key = 'bill.record.add';
+    const slots = RECORD_SLOTS[key];
+    const missing = missingSlots(params, slots);
+    const kind = typeof params.kind === 'string' ? params.kind : '';
+    const blocked = blockedItems({ params, missing, kind });
+    if (blocked.length > 0)
+        return collectOut({ key, params, slots, missing, blocked, db });
+    const before = totalChanges(db.db);
+    const input = validateAddInput(params);
+    const r = addBill(db, input);
+    // 回执摘要里的型名改唤醒词（本轮整改）：`（expense）` 这种内建型名不上屏，
+    // 换成「记支出」这类用户自己说过的词；`id=` 换「记录编号」；`prompt` 那个英文词删。
+    const extra = kind === 'photo'
+        ? '（三要素以外部识别为准）'
+        : kind === 'batch' ? '（只落了其中一笔）' : kind ? '（' + wakeWordOf(kind) + '）' : '';
+    return finish({
+        db, key, params, op: 'add', row: r, fields: ADD_FIELDS, before, noChange: false,
+        summary: `已记录：${r.category} ${r.amount.toFixed(2)}${extra}（记录编号 ${r.id}，这一页可以复制）`,
+        writtenDetail: '这一笔已记进账本',
+        detail: rowDetail(r),
+    });
+}
+/** `bill.record.update`（改记录）：有阻断项（缺 `id`）即出采集页；op 决定改字段／撤销／恢复三支。
+ *  **这一支不判金额方向**：撤销／恢复本来就不带 `kind`＋`amount`，带上也不该被方向判定拦下、改出采集页。 */
+export function writeRecordUpdate(params, db) {
+    const key = 'bill.record.update';
+    const slots = RECORD_SLOTS[key];
+    const missing = missingSlots(params, slots);
+    const blocked = blockedItems({ params, missing, kind: '' });
+    if (blocked.length > 0)
+        return collectOut({ key, params, slots, missing, blocked, db });
+    const op = parseRecordOp(params);
+    const before = totalChanges(db.db);
+    if (op === 'undo') {
+        const id = needId(params);
+        const r = undoBill(db, id);
+        return finish({
+            db, key, params, op: 'undo', row: r, fields: ['deleted_at'], before, noChange: false,
+            summary: `已撤销，记录还在，随时可恢复（记录编号 ${r.id}）`,
+            writtenDetail: '已标记撤销（记录还在库里，只是不再算进查询与统计）',
+            detail: [{ k: fieldLabelOf('op'), v: statusNoteOf('软删打标（deleted_at = now，不物理删）') }, { k: fieldLabelOf('id'), v: String(r.id) }],
+        });
+    }
+    if (op === 'restore') {
+        const id = needId(params);
+        const r = restoreBill(db, id);
+        return finish({
+            db, key, params, op: 'restore', row: r, fields: ['deleted_at'], before, noChange: false,
+            summary: `已恢复（记录编号 ${r.id}）`,
+            writtenDetail: '已恢复（撤销标记清掉，这一笔回到查询与统计里）',
+            detail: [{ k: fieldLabelOf('op'), v: statusNoteOf('置 NULL（deleted_at 清空）') }, { k: fieldLabelOf('id'), v: String(r.id) }],
+        });
+    }
+    const { id, patch } = validateUpdateInput(params);
+    const pre = getById(db, id);
+    const r = updateBill(db, id, patch);
+    const fields = Object.keys(patch);
+    const noChange = fields.every((f) => preValue(pre, f) === patch[f]);
+    return finish({
+        db, key, params, op: 'update', row: r, fields, before, noChange,
+        summary: `已修改：${r.id}（改了 ${fields.map((f) => fieldLabelOf(f)).join('、')}）`,
+        writtenDetail: '这一条已改好',
+        detail: [
+            { k: fieldLabelOf('id'), v: String(r.id) },
+            ...fields.map((f) => ({ k: fieldLabelOf(f), v: String(patch[f]) })),
+        ],
+    });
+}
+//# sourceMappingURL=write.js.map

package/dist/record/write.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/render/envelope.ts"],"names":[],"mappings":"AACA,OAAO,EAAmD,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAiBzD,CAAC;AAEF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAIvD;AAGD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAatE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAG1D"}
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/render/envelope.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmD,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAkCpH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAmB,CAAC;AAE9E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAIvD;AAGD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAatE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAG1D"}

package/dist/render/envelope.js

@@ -1,13 +1,12 @@
-// 渲染层·envelope：16 联动 key×shape 映射（拆分表）；key 字符串后续票落表时冻结，此处只做形状分配与全字段校验。
+// 页面交付·envelope：16 联动 key×shape 映射（拆分表）；key 字符串后续票落表时冻结，此处只做形状分配与全字段校验。
+// 迁移过的命令（写入域两条 ＋ 查询域四条）的形状**不在本文件写死**：从 `src/cli/registry.ts` 运行期派生。
 import { createEnvelope, parseEnvelope, parseRegistryKey } from 'base-link-core';
+import { REGISTRY } from '../cli/registry.js';
 import { BillRenderError } from './errors.js';
-export const BILL_KEY_SHAPES = {
-    'bill.record.add': 'receipt',
-    'bill.record.update': 'receipt',
-    'bill.record.today': 'list',
-    'bill.record.range': 'list',
-    'bill.record.search': 'list',
-    'bill.record.detail': 'detail',
+/** 过渡表是**债务**：10 条尚未搬进能力目录的命令，形状仍写在这里。
+ *  迁移过的六条（写入域两条 ＋ 查询域四条）从表里删掉，形状由注册表运行期派生（见下 `keyShapeTable`）；
+ *  余下待搬迁的域各自成票时，本表跟着变薄，直到「全部命令的形状从注册表派生」。 */
+const TRANSITIONAL_KEY_SHAPES = {
     'bill.analysis.overview': 'stat',
     'bill.analysis.compare': 'analysis',
     'bill.analysis.trend': 'analysis',
@@ -19,6 +18,20 @@ export const BILL_KEY_SHAPES = {
     'bill.setup.run': 'receipt',
     'bill.help.lookup': 'list',
 };
+/** 形状表的组成：过渡表打底 ＋ 注册表里的命令逐条派生（**形状事实只住各能力的 `commands.ts`**）。
+ *  过渡表里若还留着同一条命令且形状对不上 → 抛：那就是漏删了过渡表那一行。 */
+function keyShapeTable() {
+    const out = { ...TRANSITIONAL_KEY_SHAPES };
+    for (const spec of Object.values(REGISTRY)) {
+        const prev = out[spec.key];
+        if (prev !== undefined && prev !== spec.shape) {
+            throw new BillRenderError('BILL_SHAPE_MISMATCH', '形状两处不一致（迁移过的命令要从过渡表里删掉）：' + spec.key);
+        }
+        out[spec.key] = spec.shape;
+    }
+    return out;
+}
+export const BILL_KEY_SHAPES = keyShapeTable();
 export function billShapeFor(key) {
     const s = BILL_KEY_SHAPES[key];
     if (!s)

package/dist/render/envelope.js.map

@@ -1 +1 @@
-{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/render/envelope.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAqC,MAAM,gBAAgB,CAAC;AACpH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAkC;IAC5D,iBAAiB,EAAE,SAAS;IAC5B,oBAAoB,EAAE,SAAS;IAC/B,mBAAmB,EAAE,MAAM;IAC3B,mBAAmB,EAAE,MAAM;IAC3B,oBAAoB,EAAE,MAAM;IAC5B,oBAAoB,EAAE,QAAQ;IAC9B,wBAAwB,EAAE,MAAM;IAChC,uBAAuB,EAAE,UAAU;IACnC,qBAAqB,EAAE,UAAU;IACjC,iBAAiB,EAAE,SAAS;IAC5B,iBAAiB,EAAE,MAAM;IACzB,oBAAoB,EAAE,SAAS;IAC/B,oBAAoB,EAAE,MAAM;IAC5B,kBAAkB,EAAE,SAAS;IAC7B,gBAAgB,EAAE,SAAS;IAC3B,kBAAkB,EAAE,MAAM;CAC3B,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,WAAW,GAAG,GAAG,CAAC,CAAC;IACzE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,IAAa;IAC1D,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,CAAC;QAAC,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;IAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,SAAS,GAAI,CAAW,CAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IAC9F,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,IAAa,EAAE,CAAC,CAAC;IACvF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CAAC,qBAAqB,EAAE,KAAK,GAAG,SAAS,GAAI,CAAW,CAAC,OAAO,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC;QAAC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,cAAc,GAAI,CAAW,CAAC,OAAO,CAAC,CAAC;IAAC,CAAC;AACrG,CAAC"}
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/render/envelope.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,qEAAqE;AACrE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAqC,MAAM,gBAAgB,CAAC;AACpH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;6CAE6C;AAC7C,MAAM,uBAAuB,GAAkC;IAC7D,wBAAwB,EAAE,MAAM;IAChC,uBAAuB,EAAE,UAAU;IACnC,qBAAqB,EAAE,UAAU;IACjC,iBAAiB,EAAE,SAAS;IAC5B,iBAAiB,EAAE,MAAM;IACzB,oBAAoB,EAAE,SAAS;IAC/B,oBAAoB,EAAE,MAAM;IAC5B,kBAAkB,EAAE,SAAS;IAC7B,gBAAgB,EAAE,SAAS;IAC3B,kBAAkB,EAAE,MAAM;CAC3B,CAAC;AAEF;4CAC4C;AAC5C,SAAS,aAAa;IACpB,MAAM,GAAG,GAAkC,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAC1E,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9C,MAAM,IAAI,eAAe,CAAC,qBAAqB,EAAE,0BAA0B,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1F,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAkC,aAAa,EAAE,CAAC;AAE9E,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,WAAW,GAAG,GAAG,CAAC,CAAC;IACzE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,IAAa;IAC1D,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,CAAC;QAAC,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;IAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,SAAS,GAAI,CAAW,CAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IAC9F,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,IAAa,EAAE,CAAC,CAAC;IACvF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CAAC,qBAAqB,EAAE,KAAK,GAAG,SAAS,GAAI,CAAW,CAAC,OAAO,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC;QAAC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,cAAc,GAAI,CAAW,CAAC,OAAO,CAAC,CAAC;IAAC,CAAC;AACrG,CAAC"}

package/dist/render/errors.d.ts

@@ -1,5 +1,5 @@
 export declare class BillRenderError extends Error {
-    readonly code: 'BILL_UNKNOWN_KEY' | 'BILL_BAD_PAYLOAD' | 'BILL_SHAPE_MISMATCH' | 'BILL_TEMPLATE_MISSING' | 'BILL_MARKER_INVALID' | 'BILL_HTML_TOO_LARGE';
+    readonly code: 'BILL_UNKNOWN_KEY' | 'BILL_BAD_PAYLOAD' | 'BILL_SHAPE_MISMATCH' | 'BILL_TEMPLATE_MISSING' | 'BILL_MARKER_INVALID' | 'BILL_HTML_TOO_LARGE' | 'BILL_HELP_MISSING_DATA';
     constructor(code: BillRenderError['code'], message: string);
 }
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/render/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EACT,kBAAkB,GAAG,kBAAkB,GAAG,qBAAqB,GAC/D,uBAAuB,GAAG,qBAAqB,GAAG,qBAAqB,CAAC;gBAChE,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;CAK3D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/render/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EACT,kBAAkB,GAAG,kBAAkB,GAAG,qBAAqB,GAC/D,uBAAuB,GAAG,qBAAqB,GAAG,qBAAqB,GACvE,wBAAwB,CAAC;gBACjB,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;CAK3D"}

package/dist/render/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/render/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAE+D;IAC5E,YAAY,IAA6B,EAAE,OAAe;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/render/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAGgB;IAC7B,YAAY,IAA6B,EAAE,OAAe;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/render/helpFile.d.ts

@@ -0,0 +1,85 @@
+import { WAKE_GROUPS } from '../triggers/wake-assets.js';
+/** 「饼干记账help」交付文件的文件名主体（接线层写死；调用方不接受外部传入，照 #139 S3-3）。 */
+export declare const HELP_FILE_STEM: "\u997C\u5E72\u8BB0\u8D26_HELP";
+/** 5 键头（老实物逐字）。 */
+export declare const HELP_FILE_SKILL_NAME: "\u997C\u5E72\u8BB0\u8D26";
+export declare const HELP_FILE_TITLE: "\u997C\u5E72\u8BB0\u8D26 \u00B7 \u4F7F\u7528\u624B\u518C(HELP)";
+/** 技能数据世代版本（老口径 `summary.version`，非 npm 包版本）。 */
+export declare const HELP_FILE_VERSION: "2.0";
+/** 首次使用横幅的 prompt 取自该场景（老 `SETUP_INIT_SCENE_ID`）。 */
+export declare const HELP_INIT_SCENE_ID: "setup_init_wizard";
+export interface HelpContactItem {
+    readonly label: string;
+    readonly value: string;
+    /** 标记「可点链接」（老实物该键为真时渲染成 `<a>`）。 */
+    readonly url?: true;
+}
+export interface HelpContact {
+    readonly items: readonly HelpContactItem[];
+    readonly copy_all: true;
+}
+/** 联系作者三项（老 `render_help.py:59-63` 的 CONTACT ＋ `:206-213` 的 items 组法逐字）。 */
+export declare const HELP_CONTACT: HelpContact;
+/** 透传信息块（老契约 `{id,title,html}`）。**自 t202 起共享 help 模板会渲染它**：块 `id` 逐字命中某个
+ *  一级分组的 `id` 时，该块渲在那个分组页的页首。本件两块（`help_summary`／`help_wake_words`）与 7 个
+ *  分组 id 零碰撞 ⇒ 本件页面上仍**不渲染**（行为同旧版，照旧只作页面外消费的透传位）。
+ *  契约＝`docs/base/base-render/t202-help-meta-blocks.md`。 */
+export interface HelpMetaBlock {
+    readonly id: string;
+    readonly title: string;
+    readonly html: string;
+}
+/** 首次使用横幅（老 `:221-227` 五键 ＋ 新线追加的显隐开关 `hidden`）。 */
+export interface HelpInitBanner {
+    readonly title: string;
+    readonly subtitle: string;
+    readonly button_text: string;
+    readonly prompt: string;
+    readonly closable: true;
+    readonly hidden: boolean;
+}
+/** 老 5 键 ＋ 三块可选键（共享 help 模板运行时契约的超集）。 */
+export interface HelpFileData {
+    readonly skill_name: typeof HELP_FILE_SKILL_NAME;
+    readonly title: typeof HELP_FILE_TITLE;
+    readonly subtitle: string;
+    readonly contact: HelpContact;
+    readonly groups: typeof WAKE_GROUPS;
+    readonly meta_blocks: readonly HelpMetaBlock[];
+    readonly version: typeof HELP_FILE_VERSION;
+    readonly init_banner: HelpInitBanner;
+}
+export interface HelpFileOptions {
+    /** 库是否已初始化（`true` ⇒ 首次使用横幅隐藏）。缺省 `false`＝照显（见模块头：误显的代价小于误藏）。 */
+    readonly initialized?: boolean;
+}
+/** 老 `%Y-%m-%d %H:%M` 等价物（本地时区，零填充；非法 Date 即坏参，不返空串）。 */
+export declare function formatHelpMinute(now: Date): string;
+/** 老 `:194-195` 的 `summary_line`：计数与版本**派生**，不写死 7／74（改资产即跟变）。 */
+export declare function deriveSummaryLine(now?: Date): string;
+/** 两块 meta：HELP 汇总（＝summaryLine 同源）＋ HELP 唤醒词（＝口径层那 4 条派生）。 */
+export declare function buildMetaBlocks(summaryLine: string): readonly HelpMetaBlock[];
+/** 首次使用横幅：文案照老实样，`prompt` 取自初始化场景的 `prompt_template`（单源）。
+ *  该场景缺位即抛（内容资产被机器生成 ＋ 摘要锁，缺位属真故障，不静默把横幅降级掉）。 */
+export declare function buildInitBanner(initialized: boolean): HelpInitBanner;
+/** 内容资产 ＋ 派生 → 全量 HELP JSON（纯函数；`now` 显式传入以保证可复现）。 */
+export declare function buildHelpFileData(now?: Date, opts?: HelpFileOptions): HelpFileData;
+/** 全量 HELP JSON → 全help模板 HTML（模板唯一实现＝共享层 verbatim 老实物；空分组抛 `missing-data`，调用方 exit 5）。 */
+export declare function renderHelpFileHtml(data: HelpFileData): string;
+/** 交付索引（envelope 的 `data` 载荷；`list` 形要 `items`）：域级一行，计数全**派生**——
+ *  与 `help_summary` 同源思路，改资产即跟变，不回写第二份数字。 */
+export interface HelpIndexItem {
+    readonly id: string;
+    readonly icon: string;
+    readonly label: string;
+    readonly subgroupCount: number;
+    readonly sceneCount: number;
+}
+export interface HelpIndex {
+    readonly items: readonly HelpIndexItem[];
+    readonly total: number;
+    readonly sceneTotal: number;
+    readonly subgroupTotal: number;
+}
+export declare function buildHelpIndex(): HelpIndex;
+//# sourceMappingURL=helpFile.d.ts.map

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

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

package/dist/render/helpFile.js

@@ -0,0 +1,110 @@
+/** #145 · 「饼干记账help」的交付**内容**：内容资产 ＋ 派生 → 共享 help 模板（`base-paint/help-shell`）全页 HTML。
+ *
+ * 本模块**零 IO、零落盘**：落点与写盘全在 CLI 交付管线（#144：`render/helpPaths.ts` ＋ `output.ts`）。
+ * 逐字对照老口径（只读基线 `D:\2Study\StudyNotes\SKILLS\饼干记账\scripts\render_help.py:build_help_contract`）：
+ *  - `skill_name`／`title`／`contact`／`version` 照老实样（`:197-214`）；
+ *  - `subtitle` 与 `meta_blocks[0]` 同源派生（老 `:194-202` 的 `summary_line` 一处算、两处用）；
+ *  - `groups` 由内容资产直转（`WAKE_GROUPS`，只读引用不 clone）；
+ *  - `init_banner` 文案照老 `INIT_BANNER_TEXT`（`:69-74`），`prompt` 取自 `setup_init_wizard`
+ *    场景的 `prompt_template`（老 `:124-132` 同一个「从汇总里取该场景 prompt」的单源做法）。
+ *
+ * 三块可选键（用户 Q9=B 完整照传；仓内共享 help 模板运行时全量读这些键，TS 类型面只声明 5 键）：
+ *  - `meta_blocks`：两块（`help_summary`／`help_wake_words`），内容全部派生，不写第二份源；
+ *  - `version`：`'2.0'`——老口径 `str(summary.get("version","2.0"))`，语义是**技能数据世代**
+ *    （bill 自己的 `init-status` 也自述「v2.0 特征 deleted_at」），**不是** npm 包版本 `0.1.0`；
+ *  - `init_banner`：显隐由 `hidden` 控。老口径是「未初始化才给这个键」，help模板读的却是 `hidden`
+ *    （`help-template.html` 的 `INIT_BANNER && !INIT_BANNER.hidden`），故新线**键常在、显隐走 `hidden`**：
+ *    payload 形状不随状态变，下游用例能断言同一个键集。初始化状态由调用方传入（本模块零 IO）。
+ */
+import { renderHelpShellHtml } from 'base-paint/help-shell';
+import { HELP_WAKE_WORDS, SCENE_BY_ID, WAKE_ASSETS, WAKE_GROUPS } from '../triggers/wake-assets.js';
+import { BillRenderError } from './errors.js';
+/** 「饼干记账help」交付文件的文件名主体（接线层写死；调用方不接受外部传入，照 #139 S3-3）。 */
+export const HELP_FILE_STEM = '饼干记账_HELP';
+/** 5 键头（老实物逐字）。 */
+export const HELP_FILE_SKILL_NAME = '饼干记账';
+export const HELP_FILE_TITLE = '饼干记账 · 使用手册(HELP)';
+/** 技能数据世代版本（老口径 `summary.version`，非 npm 包版本）。 */
+export const HELP_FILE_VERSION = '2.0';
+/** 首次使用横幅的 prompt 取自该场景（老 `SETUP_INIT_SCENE_ID`）。 */
+export const HELP_INIT_SCENE_ID = 'setup_init_wizard';
+/** 联系作者三项（老 `render_help.py:59-63` 的 CONTACT ＋ `:206-213` 的 items 组法逐字）。 */
+export const HELP_CONTACT = Object.freeze({
+    items: Object.freeze([
+        Object.freeze({ label: '邮箱', value: '975559549@qq.com' }),
+        Object.freeze({ label: 'GitHub', value: 'https://github.com/FeatherHunter/SKILLS', url: true }),
+        Object.freeze({ label: 'Issues', value: 'https://github.com/FeatherHunter/SKILLS/issues', url: true }),
+    ]),
+    copy_all: true,
+});
+/** 老 `%Y-%m-%d %H:%M` 等价物（本地时区，零填充；非法 Date 即坏参，不返空串）。 */
+export function formatHelpMinute(now) {
+    if (!(now instanceof Date) || Number.isNaN(now.getTime())) {
+        throw new BillRenderError('BILL_HELP_MISSING_DATA', 'HELP 更新时间须为有效 Date（缺失阻断不返空）。');
+    }
+    const p = (n) => String(n).padStart(2, '0');
+    return String(now.getFullYear()) + '-' + p(now.getMonth() + 1) + '-' + p(now.getDate())
+        + ' ' + p(now.getHours()) + ':' + p(now.getMinutes());
+}
+/** 老 `:194-195` 的 `summary_line`：计数与版本**派生**，不写死 7／74（改资产即跟变）。 */
+export function deriveSummaryLine(now = new Date()) {
+    return String(WAKE_GROUPS.length) + ' 功能域 · ' + String(WAKE_ASSETS.length)
+        + ' 场景 · 版本 ' + HELP_FILE_VERSION + ' · 更新于 ' + formatHelpMinute(now);
+}
+/** 两块 meta：HELP 汇总（＝summaryLine 同源）＋ HELP 唤醒词（＝口径层那 4 条派生）。 */
+export function buildMetaBlocks(summaryLine) {
+    return [
+        { id: 'help_summary', title: 'HELP 汇总', html: '<p>' + summaryLine + '</p>' },
+        { id: 'help_wake_words', title: 'HELP 唤醒词', html: '<p>' + HELP_WAKE_WORDS.join(' / ') + '</p>' },
+    ];
+}
+/** 首次使用横幅：文案照老实样，`prompt` 取自初始化场景的 `prompt_template`（单源）。
+ *  该场景缺位即抛（内容资产被机器生成 ＋ 摘要锁，缺位属真故障，不静默把横幅降级掉）。 */
+export function buildInitBanner(initialized) {
+    const scene = SCENE_BY_ID[HELP_INIT_SCENE_ID];
+    const prompt = scene?.prompt_template;
+    if (typeof prompt !== 'string' || prompt.length === 0) {
+        throw new BillRenderError('BILL_HELP_MISSING_DATA', 'HELP 首次使用横幅缺 prompt：内容资产无场景 ' + HELP_INIT_SCENE_ID);
+    }
+    return {
+        title: '🚀 第一次用饼干记账?',
+        subtitle: '从「初始化」开始 — 自动检测环境、确认数据目录、建库、验证,全程零决策。完成初始化后,本区域将不再出现。',
+        button_text: '📋 复制初始化 prompt',
+        prompt,
+        closable: true,
+        hidden: initialized === true,
+    };
+}
+/** 内容资产 ＋ 派生 → 全量 HELP JSON（纯函数；`now` 显式传入以保证可复现）。 */
+export function buildHelpFileData(now = new Date(), opts = {}) {
+    if (WAKE_GROUPS.length === 0 || WAKE_ASSETS.length === 0) {
+        throw new BillRenderError('BILL_HELP_MISSING_DATA', 'HELP 内容资产为空（WAKE_GROUPS／WAKE_ASSETS）');
+    }
+    const summaryLine = deriveSummaryLine(now);
+    return {
+        skill_name: HELP_FILE_SKILL_NAME,
+        title: HELP_FILE_TITLE,
+        subtitle: summaryLine,
+        contact: HELP_CONTACT,
+        groups: WAKE_GROUPS,
+        meta_blocks: buildMetaBlocks(summaryLine),
+        version: HELP_FILE_VERSION,
+        init_banner: buildInitBanner(opts.initialized === true),
+    };
+}
+/** 全量 HELP JSON → 全help模板 HTML（模板唯一实现＝共享层 verbatim 老实物；空分组抛 `missing-data`，调用方 exit 5）。 */
+export function renderHelpFileHtml(data) {
+    return renderHelpShellHtml(data);
+}
+export function buildHelpIndex() {
+    let sceneTotal = 0;
+    let subgroupTotal = 0;
+    const items = WAKE_GROUPS.map((g) => {
+        const sceneCount = g.subgroups.reduce((n, s) => n + s.scenes.length, 0);
+        sceneTotal += sceneCount;
+        subgroupTotal += g.subgroups.length;
+        return { id: g.id, icon: g.icon, label: g.label, subgroupCount: g.subgroups.length, sceneCount };
+    });
+    return { items, total: items.length, sceneTotal, subgroupTotal };
+}
+//# sourceMappingURL=helpFile.js.map

package/dist/render/helpFile.js.map

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

package/dist/render/helpPaths.d.ts

@@ -0,0 +1,19 @@
+/** #144 · 「饼干记账help」的**落点值**（目录名与两个文件名主体；零 IO、零逻辑）。
+ *
+ * #237 改判（**就地改正上一轮 #147 的结论**）：#147 曾记「走 **(b) bill 自持一份最小管线**，不上移
+ * `base-paint`（那是被 #96 主动冻结的渲染包，落盘是 IO、主题错位）」——该结论**已被维护者 2026-09-12
+ * 裁决 8 推翻**，原话「不应该是一个独立的 base 包，放在 `base-paint` 吧，**是绘制出 html 后的相关操作**」
+ * （地图 #208 的 Q7 同轮裁「乙」＝把命名与落盘收成共用位）。故时间戳格式 `YYYYMMDD_HHMMSS`（本地时间）与
+ * 通式 `〈文件名主体〉_<stamp>[_N].html` **不再住这里**：唯一定义地是共用件 `base-paint/save-html` 的
+ * `saveHtmlFile`（`packages/base-render/src/output/saveHtml.ts`），本模块只剩「本技能自己的值」。
+ *
+ * 老命名规则复刻（只读基线 `SKILLS\饼干记账\scripts\html_paths.py` ＋ 实物目录
+ * `D:\2Study\StudyNotes\.db\biscuit_accountant_html\` 的四个 HELP 文件）：产物目录
+ * `<SKILLS_DB_PATH>/biscuit_accountant_html/`，文件名主体 `饼干记账_HELP`（老 `COMMAND_NAMES["help"]`）。
+ */
+/** HELP 产物子目录名（老 `SKILL_HTML_NAME + "_html"`）。 */
+export declare const HELP_HTML_DIR_NAME = "biscuit_accountant_html";
+/** 「速查／现找」那一支的产物名主体：与 HELP 文件**分名**（照 #139 判法：别让用户按一个名字
+ *  打开到另一个东西）。老技能没有这一支，故无老名可循；取「饼干记账_速查表」与 HELP 并列。 */
+export declare const LOOKUP_FILE_STEM = "\u997C\u5E72\u8BB0\u8D26_\u901F\u67E5\u8868";
+//# sourceMappingURL=helpPaths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpPaths.d.ts","sourceRoot":"","sources":["../../src/render/helpPaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAE5D;sDACsD;AACtD,eAAO,MAAM,gBAAgB,gDAAa,CAAC"}

package/dist/render/helpPaths.js

@@ -0,0 +1,19 @@
+/** #144 · 「饼干记账help」的**落点值**（目录名与两个文件名主体；零 IO、零逻辑）。
+ *
+ * #237 改判（**就地改正上一轮 #147 的结论**）：#147 曾记「走 **(b) bill 自持一份最小管线**，不上移
+ * `base-paint`（那是被 #96 主动冻结的渲染包，落盘是 IO、主题错位）」——该结论**已被维护者 2026-09-12
+ * 裁决 8 推翻**，原话「不应该是一个独立的 base 包，放在 `base-paint` 吧，**是绘制出 html 后的相关操作**」
+ * （地图 #208 的 Q7 同轮裁「乙」＝把命名与落盘收成共用位）。故时间戳格式 `YYYYMMDD_HHMMSS`（本地时间）与
+ * 通式 `〈文件名主体〉_<stamp>[_N].html` **不再住这里**：唯一定义地是共用件 `base-paint/save-html` 的
+ * `saveHtmlFile`（`packages/base-render/src/output/saveHtml.ts`），本模块只剩「本技能自己的值」。
+ *
+ * 老命名规则复刻（只读基线 `SKILLS\饼干记账\scripts\html_paths.py` ＋ 实物目录
+ * `D:\2Study\StudyNotes\.db\biscuit_accountant_html\` 的四个 HELP 文件）：产物目录
+ * `<SKILLS_DB_PATH>/biscuit_accountant_html/`，文件名主体 `饼干记账_HELP`（老 `COMMAND_NAMES["help"]`）。
+ */
+/** HELP 产物子目录名（老 `SKILL_HTML_NAME + "_html"`）。 */
+export const HELP_HTML_DIR_NAME = 'biscuit_accountant_html';
+/** 「速查／现找」那一支的产物名主体：与 HELP 文件**分名**（照 #139 判法：别让用户按一个名字
+ *  打开到另一个东西）。老技能没有这一支，故无老名可循；取「饼干记账_速查表」与 HELP 并列。 */
+export const LOOKUP_FILE_STEM = '饼干记账_速查表';
+//# sourceMappingURL=helpPaths.js.map

package/dist/render/helpPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpPaths.js","sourceRoot":"","sources":["../../src/render/helpPaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,kDAAkD;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAE5D;sDACsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC"}

package/dist/render/html.js

@@ -40,7 +40,7 @@ export function assertHtmlSize(html, max = BILL_HTML_MAX_BYTES) {
         throw new BillRenderError('BILL_HTML_TOO_LARGE', 'HTML 超体积：' + estimateBytes(html) + ' > ' + max);
     }
 }
-// 共享标记填充（老家离线注入壳对应）：CSS/HELPERS/CONTENT 三标记各恰出现 1 次，否则 throw。
+// 共享标记填充（老家离线注入help模板对应）：CSS/HELPERS/CONTENT 三标记各恰出现 1 次，否则 throw。
 export const SHARED_CSS_MARKER = '<!--SHARED-CSS-->';
 export const SHARED_HELPERS_MARKER = '<!--SHARED-HELPERS-->';
 export const CONTENT_MARKER = '<!--CONTENT-->';

package/dist/render/html.js.map

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

package/dist/render/index.d.ts

@@ -3,6 +3,10 @@ export { BILL_KEY_SHAPES, billShapeFor, buildBillEnvelope, parseBillEnvelope } f
 export { BILL_HTML_MAX_BYTES, escapeHtml, renderEnvelopeHtml, estimateBytes, assertHtmlSize, SHARED_CSS_MARKER, SHARED_HELPERS_MARKER, CONTENT_MARKER, SHARED_CSS, SHARED_HELPERS, fillTemplate } from './html.js';
 export { BILL_TEMPLATES, templateFor, loadTemplate } from './templates.js';
 export type { BillTemplate } from './templates.js';
-export { toBillItem, calcKpi, calcCategories, buildRecordToday, buildRecordRange, buildRecordSearch, buildRecordDetail, buildRecordReceipt, buildOverview, buildCompare, buildTrend, buildGoalQuery, buildAccountQuery, buildHelpItems } from './views.js';
+export { toBillItem, calcKpi, calcCategories, buildRecordReceipt, buildOverview, buildCompare, buildTrend, buildGoalQuery, buildAccountQuery, buildHelpItems } from './views.js';
 export type { BillItem, HelpItem } from './views.js';
+export { HELP_FILE_STEM, HELP_FILE_SKILL_NAME, HELP_FILE_TITLE, HELP_FILE_VERSION, HELP_INIT_SCENE_ID, HELP_CONTACT, formatHelpMinute, deriveSummaryLine, buildMetaBlocks, buildInitBanner, buildHelpFileData, renderHelpFileHtml, buildHelpIndex, } from './helpFile.js';
+export type { HelpContact, HelpContactItem, HelpMetaBlock, HelpInitBanner, HelpFileData, HelpFileOptions, HelpIndex, HelpIndexItem } from './helpFile.js';
+/** #237：时间戳／通式／初候选已收进共用件 `base-paint/save-html`（本模块只剩本技能自己的落点值）。 */
+export { HELP_HTML_DIR_NAME, LOOKUP_FILE_STEM } from './helpPaths.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACnN,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3P,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACnN,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjL,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,cAAc,EAAE,oBAAoB,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,YAAY,EAC1G,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAC5G,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1J,oEAAoE;AACpE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/render/index.js

@@ -2,5 +2,8 @@ export { BillRenderError } from './errors.js';
 export { BILL_KEY_SHAPES, billShapeFor, buildBillEnvelope, parseBillEnvelope } from './envelope.js';
 export { BILL_HTML_MAX_BYTES, escapeHtml, renderEnvelopeHtml, estimateBytes, assertHtmlSize, SHARED_CSS_MARKER, SHARED_HELPERS_MARKER, CONTENT_MARKER, SHARED_CSS, SHARED_HELPERS, fillTemplate } from './html.js';
 export { BILL_TEMPLATES, templateFor, loadTemplate } from './templates.js';
-export { toBillItem, calcKpi, calcCategories, buildRecordToday, buildRecordRange, buildRecordSearch, buildRecordDetail, buildRecordReceipt, buildOverview, buildCompare, buildTrend, buildGoalQuery, buildAccountQuery, buildHelpItems } from './views.js';
+export { toBillItem, calcKpi, calcCategories, buildRecordReceipt, buildOverview, buildCompare, buildTrend, buildGoalQuery, buildAccountQuery, buildHelpItems } from './views.js';
+export { HELP_FILE_STEM, HELP_FILE_SKILL_NAME, HELP_FILE_TITLE, HELP_FILE_VERSION, HELP_INIT_SCENE_ID, HELP_CONTACT, formatHelpMinute, deriveSummaryLine, buildMetaBlocks, buildInitBanner, buildHelpFileData, renderHelpFileHtml, buildHelpIndex, } from './helpFile.js';
+/** #237：时间戳／通式／初候选已收进共用件 `base-paint/save-html`（本模块只剩本技能自己的落点值）。 */
+export { HELP_HTML_DIR_NAME, LOOKUP_FILE_STEM } from './helpPaths.js';
 //# sourceMappingURL=index.js.map