skill-bill 0.1.0 → 0.2.1

package/dist/setup/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/setup/commands.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;QACE,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,gBAAgB;QACrB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,gEAAgE;QACzE,GAAG,EAAE,QAAQ;KACd;CAC+B,CAAC"}

package/dist/setup/declaration.d.ts

@@ -0,0 +1,9 @@
+/** #721 · 开始使用域的**域声明**（手写、唯一事实源）。
+ *
+ * 一条唤醒词的字面量只准住在这里（判据＝`test/t721-判据与摘要锁.test.mjs` 扫非声明件）；
+ * 场景的 `wake_word` 是投影、不写——词条拥有它；二级组按场景 id 指回词条名下的场景。
+ * 合并方：`src/triggers/wakeTable.ts`（词表＋路由＋派生）与 `src/triggers/wake-assets.ts`（HELP 目录）。
+ */
+import type { DomainDeclaration } from '../triggers/routeSpec.js';
+export declare const SETUP_DECLARATION: DomainDeclaration;
+//# sourceMappingURL=declaration.d.ts.map

package/dist/setup/declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../../src/setup/declaration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,eAAO,MAAM,iBAAiB,EAAE,iBA0F/B,CAAC"}

package/dist/setup/declaration.js

@@ -0,0 +1,92 @@
+export const SETUP_DECLARATION = {
+    id: 'setup',
+    label: '开始使用',
+    icon: '🚀',
+    order: 7,
+    entries: [
+        {
+            phrase: '初始化',
+            key: 'bill.setup.run',
+            preset: { op: 'init' },
+            scenes: [
+                {
+                    id: 'setup_init_wizard',
+                    title: '首次使用向导(4 步零决策)',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我开始使用饼干记账(唤醒词:初始化):\n',
+                    types: ['向导'],
+                },
+            ],
+        },
+        {
+            phrase: '初始化状态',
+            key: 'bill.setup.run',
+            preset: { op: 'init-status' },
+            scenes: [
+                {
+                    id: 'setup_init_status',
+                    title: '初始化状态(是否已就绪)',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我看看饼干记账初始化了没有(唤醒词:初始化状态):\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '备份',
+            key: 'bill.setup.run',
+            preset: { op: 'backup-create' },
+            scenes: [
+                {
+                    id: 'setup_backup_create',
+                    title: '一键备份',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我备份饼干记账的数据(唤醒词:备份):\n',
+                    types: ['回执'],
+                },
+                {
+                    id: 'setup_backup_list',
+                    title: '查看备份',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我看看有哪些备份(唤醒词:备份):\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '恢复备份',
+            key: 'bill.setup.run',
+            preset: { op: 'restore' },
+            scenes: [
+                {
+                    id: 'setup_restore',
+                    title: '从备份恢复',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我从备份恢复数据(唤醒词:恢复备份):\n\n  备  份: ____ (选填,默认最新备份)\n',
+                    types: ['向导'],
+                },
+            ],
+        },
+        {
+            phrase: '导入',
+            key: 'bill.setup.run',
+            preset: { op: 'import' },
+            needs: ['file'],
+            scenes: [
+                {
+                    id: 'setup_import',
+                    title: '导入 CSV 账单(列映射向导)',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我导入 CSV 账单(唤醒词:导入):\n\n  文件路径: ____\n  列映射: ____ (选填,自动识别,如:日期=第1列,金额=第3列)\n',
+                    types: ['向导'],
+                },
+            ],
+        },
+    ],
+    subgroups: [
+        { id: 'setup_1', label: '初始化', scenes: ['setup_init_wizard', 'setup_init_status'] },
+        { id: 'setup_2', label: '备份恢复', scenes: ['setup_backup_create', 'setup_backup_list', 'setup_restore'] },
+        { id: 'setup_3', label: '导入', scenes: ['setup_import'] },
+    ],
+};
+//# sourceMappingURL=declaration.js.map

package/dist/setup/declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.js","sourceRoot":"","sources":["../../src/setup/declaration.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,CAAC;IACR,OAAO,EAAE;QACP;YACE,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,gBAAgB;YACrB,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;YACtB,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,mBAAmB;oBACvB,KAAK,EAAE,gBAAgB;oBACvB,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,oCAAoC;oBACrD,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;QACD;YACE,MAAM,EAAE,OAAO;YACf,GAAG,EAAE,gBAAgB;YACrB,MAAM,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE;YAC7B,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,mBAAmB;oBACvB,KAAK,EAAE,cAAc;oBACrB,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,0CAA0C;oBAC3D,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;QACD;YACE,MAAM,EAAE,IAAI;YACZ,GAAG,EAAE,gBAAgB;YACrB,MAAM,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE;YAC/B,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,qBAAqB;oBACzB,KAAK,EAAE,MAAM;oBACb,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,oCAAoC;oBACrD,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;gBACD;oBACE,EAAE,EAAE,mBAAmB;oBACvB,KAAK,EAAE,MAAM;oBACb,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,kCAAkC;oBACnD,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;QACD;YACE,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,gBAAgB;YACrB,MAAM,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;YACzB,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,eAAe;oBACnB,KAAK,EAAE,OAAO;oBACd,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,gEAAgE;oBACjF,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;QACD;YACE,MAAM,EAAE,IAAI;YACZ,GAAG,EAAE,gBAAgB;YACrB,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;YACxB,KAAK,EAAE,CAAC,MAAM,CAAC;YACf,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,cAAc;oBAClB,KAAK,EAAE,kBAAkB;oBACzB,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,2FAA2F;oBAC5G,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;KACF;IACD,SAAS,EAAE;QACT,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,EAAE;QACnF,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,qBAAqB,EAAE,mBAAmB,EAAE,eAAe,CAAC,EAAE;QACvG,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,cAAc,CAAC,EAAE;KACzD;CACF,CAAC"}

package/dist/setup/import.d.ts

@@ -0,0 +1,8 @@
+import type { BillDb } from '../fetch/index.js';
+import type { WriteOut } from '../shared/commandSpec.js';
+import type { ColumnMap } from './importer.js';
+/** 把映射写回人话（复制口令里那一格；`日期=第1列,金额=第3列`）。 */
+export declare function mappingTextOf(map: ColumnMap): string;
+/** 导入 CSV（`op=import`）：不确认只出映射向导页；确认则「自动备份 → 整批一个事务写 → 结果卡」。 */
+export declare function runImport(db: BillDb, key: string, params: Record<string, unknown>): WriteOut;
+//# sourceMappingURL=import.d.ts.map

package/dist/setup/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/setup/import.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAKzD,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,eAAe,CAAC;AAS3D,yCAAyC;AACzC,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAQpD;AAED,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CA0E5F"}

package/dist/setup/import.js

@@ -0,0 +1,111 @@
+/** `op=import`（导入 CSV 账单）——本件住**导入这一条的全部安全顺序**（`#688` §二 D2 的四件）。
+ *
+ * 四件逐条落在哪一行（老侧四件全无，逐条证据见 `docs/skills/skill-bill/t731-差异表.md`）：
+ *   ① **明示「本次将新增 N 行、不覆盖已有记录」**——`planImport` 算出的 `new_rows` 进载荷、进页面；
+ *   ② **导入前自动备份一次**——确认那一路先 `createBackup`，把备份文件名写进载荷与页面；
+ *   ③ **重复导入检测**——`planImport` 拿库里已有记录的签名逐行比，重号的进 `duplicates`、不写库；
+ *   ④ **页面级结果卡**——`applyImport` 回来的成功／失败行数与失败原因进结果卡（`./template-wizard.js`）。
+ *
+ * 另两处**有意与老侧不同**：整批一个事务（老侧逐行各自 commit，中途失败不回退）；三档读数分开报
+ *   （老侧把被跳过的空行算进 `total`）。
+ */
+import { existsSync } from 'node:fs';
+import { resolveBackupDir, resolveGoalsPath } from '../fetch/paths.js';
+import { actionStamp } from '../shared/copyArea.js';
+import { backupStampOf, createBackup } from './backups.js';
+import { FIELD_LABEL, applyImport, existingRows, guessMap, missingRequired, parseMapping, planImport, readCsv, } from './importer.js';
+import { confirmOf, importFileOf, mappingOf } from './params.js';
+import { receiptEnvelopeOf } from './pageParts.js';
+import { setupSceneFor } from './scene.js';
+import { importSteps } from './steps.js';
+import { blockedWizardDoc } from './blocked.js';
+import { wizardDoc } from './template-wizard.js';
+/** 把映射写回人话（复制口令里那一格；`日期=第1列,金额=第3列`）。 */
+export function mappingTextOf(map) {
+    const parts = [];
+    for (const f of ['time', 'amount', 'category', 'account', 'ledger', 'note']) {
+        const col = map[f];
+        if (col === undefined)
+            continue;
+        parts.push(FIELD_LABEL[f] + '=第' + String(col + 1) + '列');
+    }
+    return parts.join(',');
+}
+/** 导入 CSV（`op=import`）：不确认只出映射向导页；确认则「自动备份 → 整批一个事务写 → 结果卡」。 */
+export function runImport(db, key, params) {
+    const scene = setupSceneFor('import');
+    const file = importFileOf(params);
+    const blocked = [];
+    if (file === '')
+        blocked.push({ name: 'file', label: 'CSV 文件路径', why: '没给' });
+    else if (!existsSync(file))
+        blocked.push({ name: 'file', label: 'CSV 文件路径', why: '这个文件不存在' });
+    if (blocked.length > 0) {
+        const html = blockedWizardDoc({ op: 'import', scene, key, params, blocked, actionAt: actionStamp() });
+        const message = '导入还差 ' + String(blocked.length) + ' 项：' + blocked.map((b) => b.label + '（' + b.why + '）').join('、');
+        return { data: { ok: false, message, receipt: { op: 'import', blocked } }, html };
+    }
+    const csv = readCsv(file);
+    const mappingText = mappingOf(params);
+    const map = mappingText === '' ? guessMap(csv) : parseMapping(mappingText);
+    const missing = missingRequired(map);
+    if (missing.length > 0) {
+        const blocked2 = [{
+                name: 'mapping', label: '列映射',
+                why: '还缺 ' + missing.map((f) => FIELD_LABEL[f]).join('、') + ' 这几列（照「日期=第1列,金额=第3列」补上）',
+            }];
+        const html = blockedWizardDoc({ op: 'import', scene, key, params, blocked: blocked2, actionAt: actionStamp() });
+        const message = '导入还差 1 项：列映射（还是缺 ' + missing.map((f) => FIELD_LABEL[f]).join('、') + '）';
+        return { data: { ok: false, message, receipt: { op: 'import', blocked: blocked2 } }, html };
+    }
+    const plan = planImport(csv, map, existingRows(db));
+    const filled = { ...params, mapping: mappingTextOf(map) };
+    const common = {
+        op: 'import', file: csv.file, name: csv.name, total: csv.rows.length,
+        new_rows: plan.newRows, duplicates: plan.duplicates.length, bad: plan.bad.length, mapping: mappingTextOf(map),
+    };
+    if (!confirmOf(params)) {
+        const ok = plan.newRows > 0;
+        const message = ok
+            ? '导入向导：' + csv.name + ' 将新增 ' + String(plan.newRows) + ' 行，不覆盖已有记录'
+            : '导入向导：' + csv.name + ' 没有可新增的行（都是库里已有的或读不出来的）';
+        const receipt = { ...common, imported: 0, failed_count: 0, backup: '', confirmed: false };
+        const envelope = receiptEnvelopeOf(key, { ok, message, ...receipt });
+        const html = wizardDoc({
+            op: 'import', scene, key, params: filled, actionAt: actionStamp(), envelope, blocked: [],
+            steps: importSteps({
+                fileName: csv.name, totalRows: csv.rows.length, mapped: true, newRows: plan.newRows,
+                duplicateRows: plan.duplicates.length, badRows: plan.bad.length, confirmed: false, inserted: 0, failed: 0,
+            }),
+            prompt: scene.promptOf(filled), promptLabel: '复制给助手：照这句确认，导入前会自动备份一次',
+            csv, map, plan, confirmed: false, backup: '', inserted: 0, failed: [],
+        });
+        return { data: { ok, message, receipt }, html };
+    }
+    // ② 导入前自动备份一次（D2 的第二件；与恢复同一支、同一口径）。
+    const backup = createBackup({
+        db, dir: resolveBackupDir(), stamp: backupStampOf(new Date()), goalsPath: resolveGoalsPath(),
+    });
+    const written = applyImport(db, plan);
+    const ok = written.inserted > 0;
+    const message = '已导入：' + String(written.inserted) + ' 行'
+        + (written.failed.length > 0 ? '，失败 ' + String(written.failed.length) + ' 行' : '')
+        + '（导入前已备份：' + backup.file + '）';
+    const receipt = {
+        ...common, imported: written.inserted, failed_count: written.failed.length,
+        backup: backup.file, confirmed: true,
+    };
+    const envelope = receiptEnvelopeOf(key, { ok, message, ...receipt });
+    const html = wizardDoc({
+        op: 'import', scene, key, params: filled, actionAt: actionStamp(), envelope, blocked: [],
+        steps: importSteps({
+            fileName: csv.name, totalRows: csv.rows.length, mapped: true, newRows: plan.newRows,
+            duplicateRows: plan.duplicates.length, badRows: plan.bad.length, confirmed: true,
+            inserted: written.inserted, failed: written.failed.length,
+        }),
+        prompt: scene.promptOf(filled), promptLabel: '复制给助手：同一份文件再导一次会怎样',
+        csv, map, plan, confirmed: true, backup: backup.file, inserted: written.inserted, failed: written.failed,
+    });
+    return { data: { ok, message, receipt }, html };
+}
+//# sourceMappingURL=import.js.map

package/dist/setup/import.js.map

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

package/dist/setup/importer.d.ts

@@ -0,0 +1,79 @@
+import type { BillDb, BillRow } from '../fetch/index.js';
+/** 导入认的六个字段（老侧 `MAPPING_HINTS` 里除「收支方向」外的六项——方向由金额符号定，见下）。 */
+export type ImportField = 'time' | 'amount' | 'category' | 'account' | 'ledger' | 'note';
+/** 字段序号（列映射的取值面）。 */
+export declare const IMPORT_FIELDS: readonly ImportField[];
+/** 字段的中文名（老侧字段标签同集；页面与报错共用一处）。 */
+export declare const FIELD_LABEL: Readonly<Record<ImportField, string>>;
+/** 必填三列（老侧 `MAPPING_HINTS` 的 `必填` 标记：日期／金额／分类）。 */
+export declare const REQUIRED_FIELDS: readonly ImportField[];
+/** 老侧的缺省列序（无表头或猜不出时的兜底：`cli.py:469-474` 缺 date→1／amount→2／category→3）。 */
+export declare const DEFAULT_ORDER: Readonly<Record<ImportField, number>>;
+/** 预览取前几行（老侧 `cli.py:545` 的 `Math.min(8, …)` 同数）。 */
+export declare const PREVIEW_ROWS = 8;
+/** 读出来的一张 CSV（表头／数据行／编码）。 */
+export interface CsvFile {
+    readonly file: string;
+    readonly name: string;
+    readonly encoding: string;
+    readonly hasHeader: boolean;
+    readonly header: readonly string[];
+    readonly rows: readonly (readonly string[])[];
+}
+/** 列映射（字段 → 0 起的列号；缺项＝没映射）。 */
+export type ColumnMap = {
+    readonly [k in ImportField]?: number;
+};
+/** 一条排好的待写行。 */
+export interface ImportRow {
+    readonly line: number;
+    readonly time: string;
+    readonly amount: number;
+    readonly category: string;
+    readonly account: string;
+    readonly ledger: string;
+    readonly note: string;
+}
+/** 一条读不出来的行（哪一行／为什么）。 */
+export interface BadRow {
+    readonly line: number;
+    readonly why: string;
+}
+/** 一条与库里已有记录重号的行。 */
+export interface DuplicateRow {
+    readonly line: number;
+    readonly signature: string;
+}
+/** 这一次导入的计划（页面照它说「将新增几行」，写库照它写）。 */
+export interface ImportPlan {
+    readonly rows: readonly ImportRow[];
+    readonly duplicates: readonly DuplicateRow[];
+    readonly bad: readonly BadRow[];
+    readonly newRows: number;
+}
+/** 一条记录的签名（重复检测的判据：时刻＋金额＋分类＋备注四件，**不经数据库**）。 */
+export declare function signatureOf(r: {
+    time: string;
+    amount: number;
+    category: string;
+    note: string;
+}): string;
+/** 读一张 CSV（缺文件／空文件在这一层报「取数失败」；坏在文件本身，不是缺参数）。 */
+export declare function readCsv(file: string): CsvFile;
+/** 按表头猜映射（猜不出的必填项用老侧缺省列序兜底）。 */
+export declare function guessMap(csv: CsvFile): ColumnMap;
+/** 解析用户写的映射原文（`日期=第1列,金额=第3列`；也认 `time=1` 这种）。认不得即抛——**不猜**。 */
+export declare function parseMapping(text: string): ColumnMap;
+/** 必填三列里还缺哪些（空数组＝可以往下走）。 */
+export declare function missingRequired(map: ColumnMap): readonly ImportField[];
+/** 排一遍导入计划：逐行试读，读得动的进 `rows`，与库里重号的进 `duplicates`，读不动的进 `bad`。 */
+export declare function planImport(csv: CsvFile, map: ColumnMap, existing: readonly BillRow[]): ImportPlan;
+/** 真写：整批一个事务（要么全进、要么全不进），返回成功行数与读不出来的行。
+ *  计划里已经剔过坏行，故正常路径下失败为空；写库中途抛错即回滚并把那一条记进 `failed`。 */
+export declare function applyImport(db: BillDb, plan: ImportPlan): {
+    readonly inserted: number;
+    readonly failed: readonly BadRow[];
+};
+/** 库里现有记录（重复检测的对照面）。 */
+export declare function existingRows(db: BillDb): readonly BillRow[];
+//# sourceMappingURL=importer.d.ts.map

package/dist/setup/importer.d.ts.map

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

package/dist/setup/importer.js

@@ -0,0 +1,231 @@
+/** 开始使用域的 CSV 导入面：**读文件 → 认列 → 排一遍计划（新增／重复／坏行）→ 真写**。
+ *
+ * 老侧对应件：`scripts/setup/cli.py` 的 `_read_csv_rows`（478-492）／`guess_mapping`（455-475）／
+ *   `build_import_payload`（495-559）／`cmd_import` 的写库循环（587-645），字段标签同 `MAPPING_HINTS`（62-70）。
+ *   老侧逐块取证见 `.scratch/t731/old-setup.md` §6。
+ *
+ * **`#688` §二 D2 的「导入四件」在这里逐件落地**（老侧四件全无，逐条证据见 `t731-差异表.md`）：
+ *   ① 明示「本次将新增 N 行、不覆盖已有记录」——`planImport` 算出来的 `newRows`／`duplicates`／`bad` 三档，
+ *      页面照它出话（老侧只报文件总行数，`import.html:158/161`）；
+ *   ② 导入前**自动备份一次**——住在 `./run.js`（导入这条路先调 `createBackup`，见那里的顺序）；
+ *   ③ **重复导入检测**——本件的 `planImport` 拿库里已有的记录（`time|amount|category|note` 四件签名）逐行比，
+ *      同一个 CSV 导两次，第二次的每一行都会落进 `duplicates`（老侧 `db.py:85-89` 是纯 INSERT，无去重）；
+ *   ④ **页面级结果卡**——`applyImport` 回成功／失败行数与失败原因（老侧失败只在 stdout，页面 0 命中）。
+ *
+ * 两处**有意与老侧不同**（都写进差异表）：
+ *   - 老侧逐行 `insert_record`（每行开一次连接、各自 commit，`db.py:82/89`）——中途失败已写的行不回退；
+ *     新侧**整批一个事务**：要么全进，要么全不进（失败行先剔除，剩下的都是能写的）；
+ *   - 老侧 `total` 把被跳过的空行也算进去（`cli.py:632` 对 `597-598`）——新侧三档分开报，不混一个数。
+ */
+import { readFileSync } from 'node:fs';
+import { basename } from 'node:path';
+import { BillFetchError, BillPolicyError } from '../fetch/errors.js';
+import { addBill, fetchAll } from '../fetch/index.js';
+import { validateAmount, validateCategory } from '../shared/category.js';
+import { validateTime } from '../shared/dateRange.js';
+/** 字段序号（列映射的取值面）。 */
+export const IMPORT_FIELDS = ['time', 'amount', 'category', 'account', 'ledger', 'note'];
+/** 字段的中文名（老侧字段标签同集；页面与报错共用一处）。 */
+export const FIELD_LABEL = {
+    time: '日期/时间',
+    amount: '金额',
+    category: '分类',
+    account: '账户',
+    ledger: '账本',
+    note: '备注',
+};
+/** 必填三列（老侧 `MAPPING_HINTS` 的 `必填` 标记：日期／金额／分类）。 */
+export const REQUIRED_FIELDS = ['time', 'amount', 'category'];
+/** 老侧的缺省列序（无表头或猜不出时的兜底：`cli.py:469-474` 缺 date→1／amount→2／category→3）。 */
+export const DEFAULT_ORDER = {
+    time: 0, amount: 1, category: 2, account: 3, ledger: 4, note: 5,
+};
+/** 表头关键词（老侧 `MAPPING_HINTS` 的中文词集 ＋ 英文小写；命中即认）。 */
+const HEADER_WORDS = {
+    time: ['日期', '时间', '交易时间', '记账日期', 'date', 'time'],
+    amount: ['金额', '数额', 'amount', 'money'],
+    category: ['分类', '类别', 'category'],
+    account: ['账户', '帐号', 'account'],
+    ledger: ['账本', '帐本', 'ledger'],
+    note: ['备注', '摘要', 'note', 'memo'],
+};
+/** 预览取前几行（老侧 `cli.py:545` 的 `Math.min(8, …)` 同数）。 */
+export const PREVIEW_ROWS = 8;
+/** 一条记录的签名（重复检测的判据：时刻＋金额＋分类＋备注四件，**不经数据库**）。 */
+export function signatureOf(r) {
+    return [r.time.trim(), r.amount.toFixed(2), r.category.trim(), r.note.trim()].join('|');
+}
+/** 解码：先按 UTF-8 读，出现替换字符再按 GBK 读（老侧 `cli.py:482-488` 的 `utf-8-sig → gbk` 同序）。 */
+function decode(raw) {
+    const utf8 = raw.toString('utf8').replace(/^\uFEFF/, '');
+    if (!utf8.includes('\uFFFD'))
+        return { text: utf8, encoding: 'UTF-8' };
+    try {
+        const gbk = new TextDecoder('gbk').decode(raw);
+        return { text: gbk, encoding: 'GBK' };
+    }
+    catch {
+        return { text: utf8, encoding: 'UTF-8（有读不出的字符）' };
+    }
+}
+/** 一行拆成格子：照老侧按逗号切（`cli.py:597-598`），引号不特殊处理——本仓不替用户猜 CSV 方言。 */
+function cellsOf(line) {
+    return line.split(',').map((c) => c.trim());
+}
+/** 首行是不是表头：命中任一关键词即当表头（老侧 `cli.py:509-525` 同判法）。 */
+function looksLikeHeader(cells) {
+    const words = Object.values(HEADER_WORDS).flat();
+    return cells.some((c) => words.includes(c.trim().toLowerCase()) || words.includes(c.trim()));
+}
+/** 读一张 CSV（缺文件／空文件在这一层报「取数失败」；坏在文件本身，不是缺参数）。 */
+export function readCsv(file) {
+    let raw;
+    try {
+        raw = readFileSync(file);
+    }
+    catch (e) {
+        throw new BillFetchError('BILL_DB_MISSING', '导入文件读不出来：' + file, { cause: e });
+    }
+    const { text, encoding } = decode(raw);
+    const lines = text.split(/\r?\n/).map((l) => l.trim()).filter((l) => l !== '');
+    if (lines.length === 0)
+        throw new BillFetchError('BILL_BAD_QUERY', 'CSV 一行都没有：' + file);
+    const first = cellsOf(lines[0]);
+    const hasHeader = looksLikeHeader(first);
+    return {
+        file,
+        name: basename(file),
+        encoding,
+        hasHeader,
+        header: hasHeader ? first : first.map((_c, i) => '列' + String(i + 1)),
+        rows: (hasHeader ? lines.slice(1) : lines).map((l) => cellsOf(l)),
+    };
+}
+/** 按表头猜映射（猜不出的必填项用老侧缺省列序兜底）。 */
+export function guessMap(csv) {
+    const out = {};
+    for (const field of IMPORT_FIELDS) {
+        const words = HEADER_WORDS[field];
+        const hit = csv.header.findIndex((h) => {
+            const cell = h.trim().toLowerCase();
+            return words.some((w) => cell === w.toLowerCase() || (cell !== '' && cell.includes(w.toLowerCase())));
+        });
+        if (hit >= 0 && !Object.values(out).includes(hit))
+            out[field] = hit;
+    }
+    for (const field of IMPORT_FIELDS) {
+        if (out[field] !== undefined)
+            continue;
+        const fallback = DEFAULT_ORDER[field];
+        if (fallback < csv.header.length && !Object.values(out).includes(fallback))
+            out[field] = fallback;
+    }
+    return out;
+}
+/** 解析用户写的映射原文（`日期=第1列,金额=第3列`；也认 `time=1` 这种）。认不得即抛——**不猜**。 */
+export function parseMapping(text) {
+    const out = {};
+    for (const piece of text.split(/[,，]/).map((p) => p.trim()).filter((p) => p !== '')) {
+        const m = /^(.+?)\s*=\s*(?:第)?\s*(\d+)\s*列?$/.exec(piece);
+        if (m === null)
+            throw new BillPolicyError('POLICY_BAD_INPUT', '列映射写不明白：' + piece
+                + '（照「日期=第1列,金额=第3列」这样写）');
+        const label = m[1].trim().toLowerCase();
+        const col = Number(m[2]) - 1;
+        if (!Number.isInteger(col) || col < 0)
+            throw new BillPolicyError('POLICY_BAD_INPUT', '列号要从 1 起数：' + piece);
+        const field = IMPORT_FIELDS.find((f) => f === label
+            || FIELD_LABEL[f] === m[1].trim()
+            || HEADER_WORDS[f].some((w) => w.toLowerCase() === label));
+        if (field === undefined) {
+            throw new BillPolicyError('POLICY_BAD_INPUT', '认不得这一列是哪个字段：' + m[1].trim()
+                + '（认这些：' + IMPORT_FIELDS.map((f) => FIELD_LABEL[f]).join('／') + '）');
+        }
+        out[field] = col;
+    }
+    return out;
+}
+/** 必填三列里还缺哪些（空数组＝可以往下走）。 */
+export function missingRequired(map) {
+    return REQUIRED_FIELDS.filter((f) => map[f] === undefined);
+}
+/** 一格取值（列号越界或没映射＝空串）。 */
+function cell(row, col) {
+    if (col === undefined || col < 0 || col >= row.length)
+        return '';
+    return row[col].trim();
+}
+/** 排一遍导入计划：逐行试读，读得动的进 `rows`，与库里重号的进 `duplicates`，读不动的进 `bad`。 */
+export function planImport(csv, map, existing) {
+    const known = new Set(existing.map((r) => signatureOf(r)));
+    const rows = [];
+    const duplicates = [];
+    const bad = [];
+    const seen = new Set();
+    csv.rows.forEach((cells, i) => {
+        const line = i + (csv.hasHeader ? 2 : 1);
+        if (cells.every((c) => c === ''))
+            return; // 整行空白：跳过，不计入任何一档（老侧同样跳）
+        const rawTime = cell(cells, map.time);
+        const rawAmount = cell(cells, map.amount);
+        const rawCategory = cell(cells, map.category) === '' ? '其他' : cell(cells, map.category);
+        try {
+            const time = validateTime(rawTime);
+            // 老侧没有「收支方向」这一格时按符号定：金额栏自带方向上，`cli.py:614-617` 的方向列本仓不收。
+            const amount = validateAmount(rawAmount);
+            const category = validateCategory(rawCategory);
+            const row = {
+                line, time, amount, category,
+                account: cell(cells, map.account),
+                ledger: cell(cells, map.ledger) === '' ? '生活' : cell(cells, map.ledger),
+                note: cell(cells, map.note),
+            };
+            const sig = signatureOf(row);
+            if (known.has(sig) || seen.has(sig)) {
+                duplicates.push({ line, signature: sig });
+                return;
+            }
+            seen.add(sig);
+            rows.push(row);
+        }
+        catch (e) {
+            bad.push({ line, why: e.message });
+        }
+    });
+    return { rows, duplicates, bad, newRows: rows.length };
+}
+/** 真写：整批一个事务（要么全进、要么全不进），返回成功行数与读不出来的行。
+ *  计划里已经剔过坏行，故正常路径下失败为空；写库中途抛错即回滚并把那一条记进 `failed`。 */
+export function applyImport(db, plan) {
+    const failed = [];
+    let inserted = 0;
+    db.db.exec('BEGIN');
+    try {
+        for (const row of plan.rows) {
+            try {
+                addBill(db, {
+                    category: row.category, amount: row.amount, time: row.time,
+                    account: row.account, ledger: row.ledger, currency: '人民币', note: row.note,
+                });
+                inserted += 1;
+            }
+            catch (e) {
+                failed.push({ line: row.line, why: e.message });
+            }
+        }
+        db.db.exec('COMMIT');
+    }
+    catch (e) {
+        try {
+            db.db.exec('ROLLBACK');
+        }
+        catch { /* 回滚失败也照样抛下面那句 */ }
+        throw new BillFetchError('BILL_DB_UNREADABLE', '导入写库失败，整批回滚了：' + e.message);
+    }
+    return { inserted, failed };
+}
+/** 库里现有记录（重复检测的对照面）。 */
+export function existingRows(db) {
+    return fetchAll(db, { includeDeleted: true });
+}
+//# sourceMappingURL=importer.js.map

package/dist/setup/importer.js.map

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

package/dist/setup/index.d.ts

@@ -0,0 +1,8 @@
+/** 开始使用域对外的门：**命令声明**（权威源在 `./commands.ts`，这里只是转出）。
+ *
+ * 与账户域同形（`../account/index.ts`）：出口分派只要一条命令的 `run`，故本域不再多转一个入口函数；
+ * 域内其他件（六件场景件、三片页型件、`./params.js`／`./backups.js`／`./status.js`／`./importer.js`／
+ * `./steps.js`／`./pageParts.js`／`./run.js`）**不出这个目录**，不在这里转出。
+ */
+export { SETUP_COMMANDS } from './commands.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/setup/index.js

@@ -0,0 +1,8 @@
+/** 开始使用域对外的门：**命令声明**（权威源在 `./commands.ts`，这里只是转出）。
+ *
+ * 与账户域同形（`../account/index.ts`）：出口分派只要一条命令的 `run`，故本域不再多转一个入口函数；
+ * 域内其他件（六件场景件、三片页型件、`./params.js`／`./backups.js`／`./status.js`／`./importer.js`／
+ * `./steps.js`／`./pageParts.js`／`./run.js`）**不出这个目录**，不在这里转出。
+ */
+export { SETUP_COMMANDS } from './commands.js';
+//# sourceMappingURL=index.js.map

package/dist/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}