skill-home 0.2.0 → 0.3.0

package/dist/cli/health.d.ts

@@ -0,0 +1,7 @@
+/** 体检命令名（插件侧镜像同值，见 `packages/plugin-home-ilife/src/bridge.ts`）。 */
+export declare const HEALTH_CHECK_KEY: "home.config.check";
+/** 是不是体检命令（分派层拦截用）。 */
+export declare function isHealthCheckKey(key: string): boolean;
+/** 跑一次体检，返回整行 envelope JSON（`data` 即那份报告）。 */
+export declare function runHealthCheckKey(key: string): string;
+//# sourceMappingURL=health.d.ts.map

package/dist/cli/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/cli/health.ts"],"names":[],"mappings":"AAaA,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,EAAG,mBAA4B,CAAC;AAK7D,uBAAuB;AACvB,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUrD"}

package/dist/cli/health.js

@@ -0,0 +1,32 @@
+/** 配置体检这个只读命令的**技能入口装配**：把 `src/health.ts` 的报告包成唯一出口那行 envelope。
+ *
+ * 为什么这个 key 与三个配置命令同住 `cli/config.ts` 的旁边、而不进 `src/policy/wakewords.ts` 那张唤醒词表：
+ * 那张表管的是**唤醒词命令**（短语→key→形状→示例），要进 HELP 与唤醒词计数。体检是**设置页专用**的只读
+ * 出口（面板点一下才跑），没有唤醒词、不进 HELP，故按「一条命令的事实只住一处」与三个配置命令并列；
+ * `cmd_read.ts` 在**进预检与分派层之前**拦下它（体检不该要求库目录已配——它要报的正是「库在哪、通不通」）。
+ *
+ * 判据与文案住在 `src/health.ts`；本件只做包封，不重写一个字。
+ */
+import { ENVELOPE_VERSION } from 'base-link-core';
+import { buildHomeHealthReport } from '../health.js';
+/** 体检命令名（插件侧镜像同值，见 `packages/plugin-home-ilife/src/bridge.ts`）。 */
+export const HEALTH_CHECK_KEY = 'home.config.check';
+/** 本技能的 envelope skill 名（与 `src/render/envelope.ts` 的 `createEnvelope({skill:'home'})` 同值）。 */
+const HOME_SKILL = 'home';
+/** 是不是体检命令（分派层拦截用）。 */
+export function isHealthCheckKey(key) {
+    return key === HEALTH_CHECK_KEY;
+}
+/** 跑一次体检，返回整行 envelope JSON（`data` 即那份报告）。 */
+export function runHealthCheckKey(key) {
+    const report = buildHomeHealthReport();
+    const envelope = {
+        version: ENVELOPE_VERSION,
+        skill: HOME_SKILL,
+        shape: 'detail',
+        key,
+        data: report,
+    };
+    return JSON.stringify(envelope);
+}
+//# sourceMappingURL=health.js.map

package/dist/cli/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/cli/health.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,mEAAmE;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAA4B,CAAC;AAE7D,+FAA+F;AAC/F,MAAM,UAAU,GAAG,MAAe,CAAC;AAEnC,uBAAuB;AACvB,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,GAAG,KAAK,gBAAgB,CAAC;AAClC,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG;QACf,OAAO,EAAE,gBAAgB;QACzB,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,QAAyB;QAChC,GAAG;QACH,IAAI,EAAE,MAAM;KACb,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,44 @@
+import type { ConfigRecord } from 'base-link-core';
+/** 配置文件主体名：`<配置目录>/home.yaml`。 */
+export declare const HOME_CONFIG_STEM: "home";
+/** 居家管家那份配置表：键即设置页的行，一层嵌套（子集支持范围见 base-link-core README）。 */
+export declare const HOME_CONFIG_DEFAULTS: {
+    db: {
+        dir: string;
+        name: string;
+    };
+    html: {
+        dir: string;
+    };
+    files: {
+        help: string;
+        lookup: string;
+    };
+    backup: {
+        dir: string;
+    };
+};
+/** 取值形状由默认值表派生（同一件事只有一个定义地）。 */
+export type HomeConfigValues = typeof HOME_CONFIG_DEFAULTS;
+/** 读回来的一份配置：文件路径（人话报错要指它）＋数据目录＋取值。 */
+export interface LoadedHomeConfig {
+    readonly path: string;
+    readonly dataDir: string;
+    readonly created: boolean;
+    readonly values: HomeConfigValues;
+}
+/** 读一份配置（文件不存在即按默认值落一份并把配置目录／数据目录建出来）。 */
+export declare function loadHomeConfig(): LoadedHomeConfig;
+/** 写一份配置（写出去的是完整一份：没给的项按默认值补齐）。写完清记忆，同进程后续读也现取。 */
+export declare function saveHomeConfig(values: ConfigRecord): {
+    path: string;
+};
+/** 重置为默认（先另存 `<配置目录>/home.yaml.bak`）。 */
+export declare function resetHomeConfig(): {
+    path: string;
+    backupPath: string | null;
+};
+/** 把配置里的相对段串拆成段（`home_manager_html` → `['home_manager_html']`；`\` 与 `/` 都认，
+ *  空段丢弃——Windows 用户手写路径时两种分隔符都会用）。段数由值决定，故「几段」这件事配置形状能表达。 */
+export declare function splitDirSegments(value: string): string[];
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,kCAAkC;AAClC,eAAO,MAAM,gBAAgB,EAAG,MAAe,CAAC;AAEhD,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;CAKhC,CAAC;AAEF,gCAAgC;AAChC,MAAM,MAAM,gBAAgB,GAAG,OAAO,oBAAoB,CAAC;AAE3D,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAKD,0CAA0C;AAC1C,wBAAgB,cAAc,IAAI,gBAAgB,CAajD;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAIrE;AAED,yCAAyC;AACzC,wBAAgB,eAAe,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAI7E;AAED;6DAC6D;AAC7D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD"}

package/dist/config.js

@@ -0,0 +1,65 @@
+/** 居家管家自己的配置面：那份默认值表 ＋ 读／写／重置三个薄转调。
+ *
+ * 口径出处（「配置的存与生效口径裁定」#675 的解决评论，本票 #695 落地）：**每个技能一份 YAML 配置文件，
+ * 配置文件是唯一真相，环境变量不参与配置**。默认落点 `~/.ilife/home.yaml`（由 `os.homedir()` 派生，
+ * 平台无关），`ILIFE_CONFIG_DIR` 设定且非空即整体接管配置目录；数据目录默认 `~/.ilife/data/`，
+ * 首次读时自动建；「重置为默认」先另存 `<配置目录>/home.yaml.bak`。
+ *
+ * 读写实现（受限 YAML 子集解析、键表与类型校验、备份、建目录）住 `base-link-core` 的 `src/config/`
+ * ——#694 已交付，本件只做「居家管家的那份表 ＋ 转调」，一份实现不抄第二处（结构纪律铁律一）。
+ *
+ * 默认值逐项等于改造前的代码常量（对照读数见 `docs/skills/skill-home/t695-证据.md`）：
+ *   · `db.dir`＝`''`（空串＝按默认落点：数据目录 `~/.ilife/data/`，由取用处算——见 `src/fetch/paths.ts`）；
+ *   · `db.name`＝`home.db`（原 `src/fetch/paths.ts` 的 `DB_FILENAME`）；
+ *   · `html.dir`＝`home_manager_html`（原 `src/help/manifest.ts` 的 `HELP_HTML_DIR_NAME`——家是**一段**目录，
+ *     配置形状是字符串、段间用 `/` 或 `\` 分隔，因为受限子集不收数组；见 `base-link-core/README.md` §支持范围）；
+ *   · `files.help`／`files.lookup`＝`居家管家_HELP`／`居家管家_速查表`（原 `manifest.ts` 的两个主体名）；
+ *   · `backup.dir`＝`backups`（原 `src/fetch/backup.ts` 的 `BACKUP_DIR_NAME`，老家 `ops.py:26` 同值）。
+ * 用法上一处约定：**空串＝按默认落点**——`db.dir` 空即用数据目录，由取用处算，
+ * 所以空串不是「没配」，老数据不会看起来丢了。
+ */
+import { loadConfig, resetConfig, saveConfig } from 'base-link-core';
+/** 配置文件主体名：`<配置目录>/home.yaml`。 */
+export const HOME_CONFIG_STEM = 'home';
+/** 居家管家那份配置表：键即设置页的行，一层嵌套（子集支持范围见 base-link-core README）。 */
+export const HOME_CONFIG_DEFAULTS = {
+    db: { dir: '', name: 'home.db' },
+    html: { dir: 'home_manager_html' },
+    files: { help: '居家管家_HELP', lookup: '居家管家_速查表' },
+    backup: { dir: 'backups' },
+};
+/** 每进程只读一次：配置文件的「保存即生效」靠**下一次调用现读**，同一个进程里不反复读盘。 */
+let memo = null;
+/** 读一份配置（文件不存在即按默认值落一份并把配置目录／数据目录建出来）。 */
+export function loadHomeConfig() {
+    if (memo === null) {
+        const loaded = loadConfig(HOME_CONFIG_STEM, HOME_CONFIG_DEFAULTS);
+        // base-link-core 读回来时已经过了「键齐 ＋ 类型对」两道校验（不认识的键、类型不符一律抛），
+        // 故这一处从宽松记录到形状记录的转换是有依据的投影，不是猜测。
+        memo = {
+            path: loaded.path,
+            dataDir: loaded.dataDir,
+            created: loaded.created,
+            values: loaded.values,
+        };
+    }
+    return memo;
+}
+/** 写一份配置（写出去的是完整一份：没给的项按默认值补齐）。写完清记忆，同进程后续读也现取。 */
+export function saveHomeConfig(values) {
+    const r = saveConfig(HOME_CONFIG_STEM, HOME_CONFIG_DEFAULTS, values);
+    memo = null;
+    return r;
+}
+/** 重置为默认（先另存 `<配置目录>/home.yaml.bak`）。 */
+export function resetHomeConfig() {
+    const r = resetConfig(HOME_CONFIG_STEM, HOME_CONFIG_DEFAULTS);
+    memo = null;
+    return r;
+}
+/** 把配置里的相对段串拆成段（`home_manager_html` → `['home_manager_html']`；`\` 与 `/` 都认，
+ *  空段丢弃——Windows 用户手写路径时两种分隔符都会用）。段数由值决定，故「几段」这件事配置形状能表达。 */
+export function splitDirSegments(value) {
+    return value.split(/[\\/]+/).filter((s) => s.length > 0);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGrE,kCAAkC;AAClC,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAe,CAAC;AAEhD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAChC,IAAI,EAAE,EAAE,GAAG,EAAE,mBAAmB,EAAE;IAClC,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE;IAChD,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE;CAC3B,CAAC;AAaF,oDAAoD;AACpD,IAAI,IAAI,GAA4B,IAAI,CAAC;AAEzC,0CAA0C;AAC1C,MAAM,UAAU,cAAc;IAC5B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,UAAU,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;QAClE,wDAAwD;QACxD,iCAAiC;QACjC,IAAI,GAAG;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAqC;SACrD,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,MAAM,CAAC,GAAG,UAAU,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,CAAC,CAAC;IACrE,IAAI,GAAG,IAAI,CAAC;IACZ,OAAO,CAAC,CAAC;AACX,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,eAAe;IAC7B,MAAM,CAAC,GAAG,WAAW,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;IAC9D,IAAI,GAAG,IAAI,CAAC;IACZ,OAAO,CAAC,CAAC;AACX,CAAC;AAED;6DAC6D;AAC7D,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/fetch/archive.d.ts

@@ -0,0 +1,13 @@
+export interface ZipEntry {
+    name: string;
+    data: Buffer;
+}
+export interface ZipReadEntry {
+    name: string;
+    data: Buffer;
+}
+/** 打包：条目按给定顺序写入，逐个 deflate（压不小就退回 stored，两种都合法）。 */
+export declare function zipWrite(entries: ZipEntry[]): Buffer;
+/** 解包：从 EOCD 走中央目录取每个条目的偏移，再读本地头与数据。 */
+export declare function zipRead(buf: Buffer): ZipReadEntry[];
+//# sourceMappingURL=archive.d.ts.map

package/dist/fetch/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/fetch/archive.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAqCD,oDAAoD;AACpD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CA6BpD;AAED,wCAAwC;AACxC,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE,CAiCnD"}

package/dist/fetch/archive.js

@@ -0,0 +1,115 @@
+// 备份容器：条目的打包与解包（ZIP 的最小可用子集，只用 node:zlib，不引外部依赖）。
+//
+// 为什么自己写而不引 zip 库：本仓规矩是不加外部依赖（见地图 #671 Notes 的冻结口径）；
+// 而备份产物要**用户能直接双击打开 / 拿系统解压**，故格式必须是 ZIP 而不是 tar.gz。
+// 只做写与读各自必需的部分——不做流式、不做 ZIP64、不做加密、不收目录树（调用方给扁平条目表）。
+// 读侧只认「无数据描述符（bit 3 = 0）＋ stored/deflate」两条；其余一律带原因抛错，不静默跳过。
+import { deflateRawSync, inflateRawSync } from 'node:zlib';
+const SIG_LOCAL = 0x04034b50;
+const SIG_CENTRAL = 0x02014b50;
+const SIG_EOCD = 0x06054b50;
+// msdos 时间：秒只有 2 秒精度；备份时间戳另由文件名承载，这里给常数，不谎报时间。
+const DOS_TIME = 0;
+const DOS_DATE = 0x2821; // 2000-01-01
+function u16(v) {
+    const b = Buffer.allocUnsafe(2);
+    b.writeUInt16LE(v, 0);
+    return b;
+}
+function u32(v) {
+    const b = Buffer.allocUnsafe(4);
+    b.writeUInt32LE(v >>> 0, 0);
+    return b;
+}
+const CRC_TABLE = (() => {
+    const t = new Int32Array(256);
+    for (let n = 0; n < 256; n++) {
+        let c = n;
+        for (let k = 0; k < 8; k++)
+            c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        t[n] = c;
+    }
+    return t;
+})();
+function crc32(buf) {
+    let c = -1;
+    for (let i = 0; i < buf.length; i++)
+        c = CRC_TABLE[(c ^ buf[i]) & 0xff] ^ (c >>> 8);
+    return (c ^ -1) >>> 0;
+}
+/** 打包：条目按给定顺序写入，逐个 deflate（压不小就退回 stored，两种都合法）。 */
+export function zipWrite(entries) {
+    const locals = [];
+    const centrals = [];
+    let offset = 0;
+    for (const e of entries) {
+        const name = Buffer.from(e.name, 'utf8');
+        const deflated = deflateRawSync(e.data, { level: 9 });
+        const stored = deflated.length >= e.data.length;
+        const body = stored ? e.data : deflated;
+        const method = stored ? 0 : 8;
+        const crc = crc32(e.data);
+        const local = Buffer.concat([
+            u32(SIG_LOCAL), u16(20), u16(0), u16(method), u16(DOS_TIME), u16(DOS_DATE),
+            u32(crc), u32(body.length), u32(e.data.length), u16(name.length), u16(0), name, body,
+        ]);
+        locals.push(local);
+        centrals.push(Buffer.concat([
+            u32(SIG_CENTRAL), u16(20), u16(20), u16(0), u16(method), u16(DOS_TIME), u16(DOS_DATE),
+            u32(crc), u32(body.length), u32(e.data.length), u16(name.length),
+            u16(0), u16(0), u16(0), u16(0), u32(0), u32(offset), name,
+        ]));
+        offset += local.length;
+    }
+    const central = Buffer.concat(centrals);
+    const eocd = Buffer.concat([
+        u32(SIG_EOCD), u16(0), u16(0), u16(entries.length), u16(entries.length),
+        u32(central.length), u32(offset), u16(0),
+    ]);
+    return Buffer.concat([...locals, central, eocd]);
+}
+/** 解包：从 EOCD 走中央目录取每个条目的偏移，再读本地头与数据。 */
+export function zipRead(buf) {
+    const eocd = buf.lastIndexOf(u32(SIG_EOCD));
+    if (eocd < 0)
+        throw new Error('不是 ZIP：未找到中央目录结尾记录');
+    const count = buf.readUInt16LE(eocd + 10);
+    let p = buf.readUInt32LE(eocd + 16);
+    const out = [];
+    for (let i = 0; i < count; i++) {
+        if (p + 46 > buf.length || buf.readUInt32LE(p) !== SIG_CENTRAL)
+            throw new Error('ZIP 中央目录第 ' + (i + 1) + ' 条损坏');
+        const method = buf.readUInt16LE(p + 10);
+        const crc = buf.readUInt32LE(p + 16);
+        const compSize = buf.readUInt32LE(p + 20);
+        const rawSize = buf.readUInt32LE(p + 24);
+        const nameLen = buf.readUInt16LE(p + 28);
+        const extraLen = buf.readUInt16LE(p + 30);
+        const commentLen = buf.readUInt16LE(p + 32);
+        const localOff = buf.readUInt32LE(p + 42);
+        const name = buf.toString('utf8', p + 46, p + 46 + nameLen);
+        if (localOff + 30 > buf.length || buf.readUInt32LE(localOff) !== SIG_LOCAL)
+            throw new Error('ZIP 条目缺少本地头：' + name);
+        if ((buf.readUInt16LE(localOff + 6) & 0x08) !== 0)
+            throw new Error('ZIP 条目用了数据描述符（不支持）：' + name);
+        const lNameLen = buf.readUInt16LE(localOff + 26);
+        const lExtraLen = buf.readUInt16LE(localOff + 28);
+        const start = localOff + 30 + lNameLen + lExtraLen;
+        const body = buf.subarray(start, start + compSize);
+        let data;
+        if (method === 0)
+            data = Buffer.from(body);
+        else if (method === 8)
+            data = inflateRawSync(body);
+        else
+            throw new Error('ZIP 条目压缩方式不支持（method=' + method + '）：' + name);
+        if (data.length !== rawSize)
+            throw new Error('ZIP 条目长度不符：' + name);
+        if (crc32(data) !== crc)
+            throw new Error('ZIP 条目校验和不符（备份可能损坏）：' + name);
+        out.push({ name, data });
+        p += 46 + nameLen + extraLen + commentLen;
+    }
+    return out;
+}
+//# sourceMappingURL=archive.js.map

package/dist/fetch/archive.js.map

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

package/dist/fetch/backup.d.ts

@@ -0,0 +1,77 @@
+/** 备份目录名的默认值：＝改造前的代码常量 `BACKUP_DIR_NAME`（配置项 `backup.dir` 空串即用它）。 */
+export declare const DEFAULT_BACKUP_DIR_NAME = "backups";
+export interface BackupRow {
+    file: string;
+    size: number;
+    created_at: string;
+    days_ago: number;
+}
+export interface BackupResult {
+    status: 'ok';
+    keep_n: number;
+    file: string;
+    size: number;
+    created_at: string;
+    items: number;
+    history: BackupRow[];
+    days_since_last: number | null;
+}
+export interface BackupListResult {
+    status: 'ok';
+    dir: string;
+    keep_n: number;
+    count: number;
+    history: BackupRow[];
+    days_since_last: number | null;
+}
+export interface RestoreResult {
+    status: 'ok';
+    restored_from: string;
+    safety_backup: string;
+    before_items: number;
+    items_total: number;
+    message: string;
+}
+/** 预告（`dryRun`）结果：只报「这份备份装了多少件、当前库多少件」，不落盘。 */
+export interface RestorePreview {
+    status: 'ok';
+    dry_run: true;
+    restored_from: string;
+    items_in_backup: number | null;
+    items_current: number;
+    message: string;
+}
+export type RestoreOutcome = RestoreResult | RestorePreview;
+export interface ExportResult {
+    status: 'ok';
+    file: string;
+    format: 'json' | 'csv';
+    size: number;
+    rows: number;
+}
+/** 备份目录名：配置 `backup.dir`，空串＝默认（`backups`）。 */
+export declare function backupDirName(): string;
+/** 备份目录（库目录下 `backups/`）——设置页「备份目录」那一项的取值口；只算路径，不建目录。 */
+export declare function resolveBackupDir(): string;
+/** 备份：库快照（含 WAL）＋ 清单打包成 zip，保留 N 份、删最旧；返回回执载荷。 */
+export declare function createBackup(opts?: {
+    keepN?: number;
+}): BackupResult;
+/** 备份历史：现读盘，不缓存（面板／回执要的是当前真状态）。 */
+export declare function listBackups(opts?: {
+    keepN?: number;
+}): BackupListResult;
+/**
+ * 导入恢复：拿备份里的 `home.db` 覆盖当前库；覆盖前先自备份一次（数据安全优先于便捷）。
+ * `dryRun`＝预告支（SM8-4「文件选择(预告式)→ 校验 → 冲突预览 → 确认导入」的中间那一步）：只校验＋报数，不落盘。
+ */
+export declare function restoreBackup(file: string, opts?: {
+    keepN?: number;
+    dryRun?: boolean;
+}): RestoreOutcome;
+/** 导出：JSON＝全表可迁移；CSV＝物品 ⋈ 位置便携（列与老家 ops.py:620 逐列相同）。 */
+export declare function exportData(opts?: {
+    format?: string;
+    output?: string;
+}): ExportResult;
+//# sourceMappingURL=backup.d.ts.map

package/dist/fetch/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/fetch/backup.ts"],"names":[],"mappings":"AAkBA,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,YAAY,CAAC;AAKjD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,IAAI,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,IAAI,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,cAAc,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,IAAI,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AA0BD,8CAA8C;AAC9C,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AA8BD,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,YAAY,CA0CxE;AAED,mCAAmC;AACnC,wBAAgB,WAAW,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,gBAAgB,CAK3E;AAmBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,cAAc,CAmD3G;AAaD,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,YAAY,CA6CxF"}