skill-bill 0.1.0 → 0.2.1

package/dist/health.js

@@ -0,0 +1,456 @@
+/** 饼干记账自己的配置体检（票 #706）：一份只读的报告，回答「我配的东西现在通不通」。
+ *
+ * 口径（票面「开工前的形状裁定」）：
+ *   · **判据住技能侧**——每条的有效值（库在哪、产物落哪个目录、第二份库叫什么）只有本包算得出来；
+ *     插件包与总管只透传与渲染，不重写这里的任何一个字。
+ *   · **只报不改**——不建目录、不写文件、不落那份默认配置；凡是要建目录才算得出的结论，一律当「不在」报。
+ *     所以本件**不许**调 `loadBillConfig()`（文件不在即落一份默认件），配置一律本件只读解析
+ *     （`base-link-core` 的受限子集解析器**没有对外**，见其包门只有四条）。
+ *   · 报告形状见面板侧镜像 `packages/plugin-manager/src/health-contract.ts`（唯一消费者）。
+ *
+ * 检查项与检查表 `docs/research/check-table-671-life-panel-20260917.html` 逐条对应：
+ * 六家通用 5 条（配置文件本身／数据目录／库文件表数／产物目录／这个值从哪来）
+ * ＋ 记账特有 2 条（第二份库 goals.json／备份目录）。
+ *
+ * 本件与卡路里那份 `packages/skill-calorie/src/health.ts` 同形（同一套受限子集解析、同一套写探针、
+ * 同一个 `node:sqlite` 只读读表数），只换本家那份配置表与自有项——读的人一眼认得出是同一条链。
+ */
+import { existsSync, readFileSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import { configPaths } from 'base-link-core';
+import { BILL_CONFIG_DEFAULTS, BILL_CONFIG_STEM } from './config.js';
+/** 库表数门槛：`src/fetch/db.ts` 只建一张业务表 `bills`（＋同表两个索引）。 */
+export const DB_TABLE_THRESHOLD = 1;
+const SKILL = 'bill';
+/** 人话里的路径一律用正斜杠：报告给页面看，也让跨平台读数可比。 */
+function p(path) {
+    return path.replace(/\\/g, '/');
+}
+/**
+ * 只读解析那份配置文件（与 `base-link-core` 的受限子集同一套校验，口径逐条对齐）：
+ * 剥 BOM、去 `\r`、空行与整行注释跳过、缩进只许 2 个空格且不许制表符、不支持列表、
+ * 一行须是「键: 值」、不许重复定义、顶层键冒号后没值即开一个组。
+ *
+ * 与 `loadConfig()` 的差别只有一处、也正是本件要的那一处：**文件不在时不落默认件**。
+ * 取值语义与它一致：文件里缺的项按默认值补。
+ */
+export function readBillConfigReadOnly() {
+    const file = configPaths(BILL_CONFIG_STEM).configFile;
+    if (!existsSync(file))
+        return { kind: 'missing' };
+    let text;
+    try {
+        text = readFileSync(file, 'utf8');
+    }
+    catch (e) {
+        return { kind: 'bad', message: '读配置文件失败：' + file + '（' + (e instanceof Error ? e.message : String(e)) + '）' };
+    }
+    const parsed = parseSubset(text, file);
+    if (!parsed.ok)
+        return { kind: 'bad', message: parsed.message };
+    return { kind: 'ok', values: projectOnDefaults(parsed.values), present: presentKeysOf(parsed.values) };
+}
+/** 文件里真写了哪些键（扁平成 `组.键`）：给「这个值从哪来」那条判据用。
+ *
+ * 为什么不能直接看投到默认值表之后的值：**空串＝按默认落点**——留空的项值看起来与默认值一样，
+ * 但它的来源是「用户写了空串」，不是「文件里没有这一项」。混起来就会把来源报错。 */
+function presentKeysOf(values) {
+    const out = new Set();
+    for (const [group, got] of Object.entries(values)) {
+        if (typeof got !== 'object' || got === null) {
+            out.add(group);
+            continue;
+        }
+        for (const key of Object.keys(got))
+            out.add(group + '.' + key);
+    }
+    return out;
+}
+/** 受限子集的极简解析：只算值与行号，不算别的（校验口径与配置件同一套）。 */
+function parseSubset(text, file) {
+    const source = text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+    const lines = source.replace(/\r\n?/g, '\n').split('\n');
+    const values = {};
+    const lineOf = new Map();
+    let openGroup = null;
+    let openGroupLine = 0;
+    /** 标量解析的失败口：`parseScalar` 把报文写进 `scalarError`，调用处读它即可（不抛，免得类型糊）。 */
+    let scalarError = '';
+    const fail = (line, why) => ({ ok: false, message: '配置件第 ' + String(line) + ' 行：' + why + '（文件：' + file + '）' });
+    const closeGroup = () => {
+        if (openGroup !== null && Object.keys(values[openGroup]).length === 0) {
+            return fail(openGroupLine, '键「' + openGroup + '」冒号后没有值，也没有子项').message;
+        }
+        openGroup = null;
+        return null;
+    };
+    for (let i = 0; i < lines.length; i += 1) {
+        const lineNo = i + 1;
+        const raw = lines[i] ?? '';
+        if (raw.trim() === '')
+            continue;
+        if (/^\s*#/.test(raw))
+            continue;
+        const head = /^[ \t]*/.exec(raw)?.[0] ?? '';
+        const body = raw.slice(head.length);
+        if (head.includes('\t'))
+            return fail(lineNo, '缩进里有制表符：本子集只许空格，且嵌套缩进恰好 2 个空格');
+        if (body.startsWith('-'))
+            return fail(lineNo, '本子集不支持列表（「-」开头的行）');
+        const matched = /^([A-Za-z_][A-Za-z0-9_.-]*)[ \t]*:[ \t]*(.*)$/.exec(body);
+        if (matched === null)
+            return fail(lineNo, '不是「键: 值」形状：' + body.trim());
+        const key = matched[1];
+        const rest = (matched[2] ?? '').trim();
+        if (head.length > 0) {
+            if (head.length !== 2)
+                return fail(lineNo, '缩进必须恰好 2 个空格（本子集只支持一层嵌套），实为 ' + String(head.length) + ' 个空格');
+            if (openGroup === null)
+                return fail(lineNo, '缩进的子项「' + key + '」上面没有开着子的顶层键');
+            const group = values[openGroup];
+            if (Object.prototype.hasOwnProperty.call(group, key)) {
+                return fail(lineNo, '键「' + openGroup + '.' + key + '」重复定义（第 ' + String(lineOf.get(openGroup + '.' + key)) + ' 行已定义）');
+            }
+            if (rest === '')
+                return fail(lineNo, '键「' + openGroup + '.' + key + '」冒号后没有值');
+            const scalar = parseScalar(rest, lineNo, fail, (message) => {
+                scalarError = message;
+            });
+            if (scalarError !== '')
+                return { ok: false, message: scalarError };
+            group[key] = scalar;
+            lineOf.set(openGroup + '.' + key, lineNo);
+            continue;
+        }
+        const closedError = closeGroup();
+        if (closedError !== null)
+            return { ok: false, message: closedError };
+        if (Object.prototype.hasOwnProperty.call(values, key)) {
+            return fail(lineNo, '键「' + key + '」重复定义（第 ' + String(lineOf.get(key)) + ' 行已定义）');
+        }
+        lineOf.set(key, lineNo);
+        if (rest === '') {
+            values[key] = {};
+            openGroup = key;
+            openGroupLine = lineNo;
+            continue;
+        }
+        const scalar = parseScalar(rest, lineNo, fail, (message) => {
+            scalarError = message;
+        });
+        if (scalarError !== '')
+            return { ok: false, message: scalarError };
+        values[key] = scalar;
+    }
+    const tailError = closeGroup();
+    if (tailError !== null)
+        return { ok: false, message: tailError };
+    return { ok: true, values };
+}
+/** 标量：带引号／数字／布尔／裸字符串（值后的 `#` 注释照配置件同一口径切掉）。 */
+function parseScalar(text, lineNo, fail, onError) {
+    const first = text[0];
+    if (first === '"' || first === "'") {
+        const quote = first;
+        let out = '';
+        let i = 1;
+        let closed = false;
+        for (; i < text.length; i += 1) {
+            const ch = text[i];
+            if (ch === quote) {
+                if (quote === "'" && text[i + 1] === "'") {
+                    out += "'";
+                    i += 1;
+                    continue;
+                }
+                closed = true;
+                break;
+            }
+            if (quote === '"' && ch === '\\') {
+                const next = text[i + 1];
+                out += next === 'n' ? '\n' : next === 't' ? '\t' : (next ?? '');
+                i += 1;
+                continue;
+            }
+            out += ch;
+        }
+        if (!closed) {
+            onError(fail(lineNo, '引号没有闭合：' + text).message);
+            return '';
+        }
+        return out;
+    }
+    let cut = text.length;
+    for (let i = 0; i < text.length; i += 1) {
+        if (text[i] === '#' && (i === 0 || /\s/.test(text[i - 1]))) {
+            cut = i;
+            break;
+        }
+    }
+    const body = text.slice(0, cut).trim();
+    if (body === '') {
+        onError(fail(lineNo, '冒号后没有值（只有注释）').message);
+        return '';
+    }
+    if (body === 'true')
+        return true;
+    if (body === 'false')
+        return false;
+    if (/^-?(\d+\.?\d*|\.\d+)$/.test(body))
+        return Number(body);
+    return body;
+}
+/** 把文件里读到的取值投到默认值表的形状上（缺项补默认值；组内只取默认值表认得的键）。 */
+function projectOnDefaults(values) {
+    const out = {};
+    for (const [group, def] of Object.entries(BILL_CONFIG_DEFAULTS)) {
+        const bucket = {};
+        const got = values[group];
+        const source = typeof got === 'object' && got !== null ? got : {};
+        for (const [key, defValue] of Object.entries(def)) {
+            const mine = source[key];
+            bucket[key] = typeof mine === typeof defValue ? mine : defValue;
+        }
+        out[group] = bucket;
+    }
+    return out;
+}
+/** 取值：一层嵌套按 `组.键` 读（缺层或类型不符回 undefined）。 */
+function readValue(values, group, key) {
+    return values[group]?.[key];
+}
+/** 有值的字符串（空串＝未配，按 `undefined` 处理，语义与各取用处一致）。 */
+function textOf(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value : '';
+}
+/** 「这个值从哪来」：真在文件里写了就是「配置文件」，否则按默认值（文件不存在则全按默认值）。 */
+function sourceOf(present, key) {
+    return present.has(key) ? '配置文件' : '默认值';
+}
+/** 目录那一项的形状是**段串**（`biscuit_accountant_html`；大厨／作息是两段），段数与 `src/config.ts`
+ *  自己的 `splitDirSegments` 同一口径。本件不 import 它：health 面与配置面互锁没有好处，
+ *  而这条规则只有三行。 */
+function splitDirSegments(value) {
+    return value.split(/[\\/]+/).filter((s) => s.length > 0);
+}
+/** 目录能不能写：建一个探针文件再删掉（老技能三家同一套做法）。**不建目录本身**。 */
+function writeProbe(dir) {
+    const probe = join(dir, '.ilife-health-probe-' + String(process.pid) + '-' + String(Date.now()));
+    try {
+        writeFileSync(probe, 'probe', { encoding: 'utf8', flag: 'wx' });
+        unlinkSync(probe);
+        return { ok: true, reason: '' };
+    }
+    catch (e) {
+        return { ok: false, reason: e instanceof Error ? e.message : String(e) };
+    }
+}
+/** 已算过的目录结论按路径记一份：同一份报告里同一个目录不重复起写探针。 */
+const dirMemo = new Map();
+function dirVerdict(dir) {
+    const memoized = dirMemo.get(dir);
+    if (memoized !== undefined)
+        return memoized;
+    const verdict = dirVerdictUncached(dir);
+    dirMemo.set(dir, verdict);
+    return verdict;
+}
+function dirVerdictUncached(dir) {
+    if (!existsSync(dir))
+        return { exists: false, writable: false, reason: '' };
+    try {
+        if (!statSync(dir).isDirectory())
+            return { exists: false, writable: false, reason: '同名文件占了它的位置' };
+    }
+    catch (e) {
+        return { exists: false, writable: false, reason: e instanceof Error ? e.message : String(e) };
+    }
+    const probe = writeProbe(dir);
+    return { exists: true, writable: probe.ok, reason: probe.reason };
+}
+/** 开库读表数（只读打开，不建库、不迁移）。打不开即当作「读不出」。 */
+function tableCount(file) {
+    let db = null;
+    try {
+        db = new DatabaseSync(file, { readOnly: true });
+        const rows = db.prepare("SELECT name FROM sqlite_master WHERE type = 'table'").all();
+        const names = rows.map((row) => String(row.name ?? '')).filter((name) => name !== '' && !name.startsWith('sqlite_'));
+        return { ok: true, count: names.length, reason: '' };
+    }
+    catch (e) {
+        return { ok: false, count: 0, reason: e instanceof Error ? e.message : String(e) };
+    }
+    finally {
+        try {
+            db?.close();
+        }
+        catch {
+            /* 关不掉不影响结论 */
+        }
+    }
+}
+/** 跑一次体检，返回整份报告。**只读**：任何一处都不落盘（只有写探针那一个文件，且当场删掉）。 */
+export function buildBillHealthReport() {
+    const paths = configPaths(BILL_CONFIG_STEM);
+    const items = [];
+    const read = readBillConfigReadOnly();
+    const values = read.kind === 'ok' ? read.values : projectOnDefaults({});
+    const present = read.kind === 'ok' ? read.present : new Set();
+    // ① 配置文件本身：能不能解析；它落在默认位置还是被 ILIFE_CONFIG_DIR 指到别处（只陈述，不评价）。
+    const defaultConfigFile = join(homedir(), '.ilife', BILL_CONFIG_STEM + '.yaml');
+    const relocated = paths.configFile !== defaultConfigFile;
+    const where = relocated ? '位置被 ILIFE_CONFIG_DIR 指到这里' : '默认位置';
+    if (read.kind === 'bad') {
+        items.push({
+            id: 'config.file', title: '配置文件', status: 'red',
+            message: read.message,
+            action: '照报文指的行号改回「键: 值」的写法；改不动就删掉这个文件，让技能按默认值重落一份。',
+            source: '配置文件',
+        });
+    }
+    else if (read.kind === 'missing') {
+        items.push({
+            id: 'config.file', title: '配置文件', status: 'yellow',
+            message: '配置文件还不存在：' + p(paths.configFile) + '（现在跑的是默认值）。',
+            action: '在面板上保存一次即会落一份；也可点「重置为默认」。',
+            source: '默认值',
+        });
+    }
+    else {
+        items.push({
+            id: 'config.file', title: '配置文件', status: 'green',
+            message: '能解析：' + p(paths.configFile) + '（' + where + '）。',
+            action: '',
+            source: '配置文件',
+        });
+    }
+    // ② 数据目录：在不在、能不能写。
+    const dbDirConfigured = textOf(readValue(values, 'db', 'dir'));
+    const dataDir = dbDirConfigured !== '' ? dbDirConfigured : paths.dataDir;
+    const dataDirSource = sourceOf(present, 'db.dir');
+    const dataDirVerdict = dirVerdict(dataDir);
+    items.push({
+        id: 'db.dir', title: '数据目录',
+        status: !dataDirVerdict.exists || !dataDirVerdict.writable ? 'red' : 'green',
+        message: !dataDirVerdict.exists
+            ? '不在：' + p(dataDir) + (dataDirVerdict.reason !== '' ? '（' + dataDirVerdict.reason + '）' : '')
+            : dataDirVerdict.writable
+                ? '在且能写：' + p(dataDir) + '。'
+                : '在，但写不进去：' + p(dataDir) + '（' + dataDirVerdict.reason + '）。',
+        action: !dataDirVerdict.exists
+            ? '先建这个目录，或把配置里的「数据目录」改到一个已存在的位置。'
+            : dataDirVerdict.writable ? '' : '去掉这个目录的只读属性，或把「数据目录」改到别处。',
+        source: dataDirSource,
+    });
+    // ③ 库文件：在不在 ＋ 表数够不够。
+    const dbNameConfigured = textOf(readValue(values, 'db', 'name'));
+    const dbName = dbNameConfigured !== '' ? dbNameConfigured : String(BILL_CONFIG_DEFAULTS.db.name);
+    const dbFile = join(dataDir, dbName);
+    const dbSource = sourceOf(present, 'db.name');
+    if (!existsSync(dbFile)) {
+        items.push({
+            id: 'db.file', title: '库文件', status: 'red',
+            message: '不在：' + p(dbFile) + '。',
+            action: '确认「数据目录」与「库文件名」对不对；新装的话，跑一条会写库的命令即会建库。',
+            source: dbSource,
+        });
+    }
+    else {
+        const tables = tableCount(dbFile);
+        if (!tables.ok) {
+            items.push({
+                id: 'db.file', title: '库文件', status: 'red',
+                message: '在，但打不开：' + p(dbFile) + '（' + tables.reason + '）。',
+                action: '这个文件可能不是库文件或已损坏；先备份，再看要不要让技能重建一份。',
+                source: dbSource,
+            });
+        }
+        else if (tables.count < DB_TABLE_THRESHOLD) {
+            items.push({
+                id: 'db.file', title: '库文件', status: 'yellow',
+                message: '在，但表不全：' + p(dbFile) + '（' + String(tables.count) + ' / ' + String(DB_TABLE_THRESHOLD) + ' 张表）。',
+                action: '缺表会让对应的功能报错；跑一次会写库的命令让它补齐，或从备份恢复。',
+                source: dbSource,
+            });
+        }
+        else {
+            items.push({
+                id: 'db.file', title: '库文件', status: 'green',
+                message: '在，' + String(tables.count) + ' 张表齐：' + p(dbFile) + '。',
+                action: '',
+                source: dbSource,
+            });
+        }
+    }
+    // ④ 产物目录：在不在、能不能写（还没建＝绿：交付页面时才落这里，那时自动建）。
+    const htmlDirValue = textOf(readValue(values, 'html', 'dir'));
+    const htmlDir = join(dataDir, ...splitDirSegments(htmlDirValue !== '' ? htmlDirValue : String(BILL_CONFIG_DEFAULTS.html.dir)));
+    const htmlVerdict = dirVerdict(htmlDir);
+    const htmlSource = sourceOf(present, 'html.dir');
+    items.push({
+        id: 'html.dir', title: '产物目录',
+        status: !htmlVerdict.exists ? 'green' : htmlVerdict.writable ? 'green' : 'yellow',
+        message: !htmlVerdict.exists
+            ? '还没建：' + p(htmlDir) + '（交付页面时才落这里，那时自动建）。'
+            : htmlVerdict.writable
+                ? '在且能写：' + p(htmlDir) + '。'
+                : '在，但写不进去：' + p(htmlDir) + '（交付会转成内联回执，不再落盘）。',
+        action: !htmlVerdict.exists || htmlVerdict.writable ? '' : '去掉这个目录的只读属性，或把「HTML 产物目录名」改到别处。',
+        source: htmlSource,
+    });
+    // ⑤ 这个值从哪来：只陈述数据目录与库文件名的来源，不判好坏（六家通用最后一条）。
+    items.push({
+        id: 'value.source', title: '这个值从哪来', status: 'green',
+        message: '数据目录走「' + dataDirSource + '」，库文件名走「' + dbSource + '」'
+            + (read.kind === 'missing' ? '（配置文件还不存在，落点全按默认值）。' : '。'),
+        action: '', source: dataDirSource,
+    });
+    // ⑥ 第二份库 goals.json（记账特有）：不在＝绿（预算功能没在用）；在但坏了＝红。
+    const goalsName = textOf(readValue(values, 'db', 'goals'));
+    const goalsFile = join(dataDir, goalsName !== '' ? goalsName : String(BILL_CONFIG_DEFAULTS.db.goals));
+    const goalsSource = sourceOf(present, 'db.goals');
+    if (!existsSync(goalsFile)) {
+        items.push({
+            id: 'goals.file', title: '第二份库 goals.json', status: 'green',
+            message: '还没建：' + p(goalsFile) + '（预算功能没在用）。',
+            action: '', source: goalsSource,
+        });
+    }
+    else {
+        let broken = '';
+        try {
+            JSON.parse(readFileSync(goalsFile, 'utf8'));
+        }
+        catch (e) {
+            broken = e instanceof Error ? e.message : String(e);
+        }
+        items.push({
+            id: 'goals.file', title: '第二份库 goals.json',
+            status: broken === '' ? 'green' : 'red',
+            message: broken === '' ? '在，能解析：' + p(goalsFile) + '。' : '在，但坏了：' + p(goalsFile) + '（' + broken + '）。',
+            action: broken === '' ? '' : '预算与储蓄目标读不出来；从备份里拿回一份，或删掉它让预算功能从零开始（本技能不会自动重建）。',
+            source: goalsSource,
+        });
+    }
+    // ⑦ 备份目录（记账特有）：在且能写＝绿；不在＝黄、不可写＝黄——面板**不自动建**，只报。
+    const backupDirConfigured = textOf(readValue(values, 'backup', 'dir'));
+    const backupDir = backupDirConfigured !== '' ? resolve(backupDirConfigured) : join(dataDir, 'backups');
+    const backupVerdict = dirVerdict(backupDir);
+    items.push({
+        id: 'backup.dir', title: '备份目录',
+        status: backupVerdict.exists && backupVerdict.writable ? 'green' : 'yellow',
+        message: !backupVerdict.exists
+            ? '还没建：' + p(backupDir) + '（备份功能没在用；本技能不自动建它）。'
+            : backupVerdict.writable
+                ? '在且能写：' + p(backupDir) + '。'
+                : '在，但写不进去：' + p(backupDir) + '（' + backupVerdict.reason + '）。',
+        action: !backupVerdict.exists
+            ? '要用备份就先把这个目录建出来；也可以用「备份」那条命令第一次跑时让它自己落这里。'
+            : backupVerdict.writable ? '' : '去掉这个目录的只读属性，或把「备份目录」改到别处。',
+        source: sourceOf(present, 'backup.dir'),
+    });
+    return { skill: SKILL, configPath: p(paths.configFile), dataDir: p(dataDir), items };
+}
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

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

package/dist/help/declaration.d.ts

@@ -0,0 +1,9 @@
+/** #721 · **HELP 位**的域声明（同形、无场景：4 条短语不进场景目录——防自指的规则只写一处）。
+ *
+ * 一条唤醒词的字面量只准住在这里（判据＝`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 HELP_DECLARATION: DomainDeclaration;
+//# sourceMappingURL=declaration.d.ts.map

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

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

package/dist/help/declaration.js

@@ -0,0 +1,28 @@
+export const HELP_DECLARATION = {
+    id: 'help',
+    order: 0,
+    entries: [
+        {
+            phrase: '饼干记账 HELP',
+            key: 'bill.help.lookup',
+            scenes: [],
+        },
+        {
+            phrase: '饼干记账帮助',
+            key: 'bill.help.lookup',
+            scenes: [],
+        },
+        {
+            phrase: '查帮助',
+            key: 'bill.help.lookup',
+            scenes: [],
+        },
+        {
+            phrase: '能做什么',
+            key: 'bill.help.lookup',
+            scenes: [],
+        },
+    ],
+    subgroups: [],
+};
+//# sourceMappingURL=declaration.js.map

package/dist/help/declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.js","sourceRoot":"","sources":["../../src/help/declaration.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,CAAC;IACR,OAAO,EAAE;QACP;YACE,MAAM,EAAE,WAAW;YACnB,GAAG,EAAE,kBAAkB;YACvB,MAAM,EAAE,EAAE;SACX;QACD;YACE,MAAM,EAAE,QAAQ;YAChB,GAAG,EAAE,kBAAkB;YACvB,MAAM,EAAE,EAAE;SACX;QACD;YACE,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,kBAAkB;YACvB,MAAM,EAAE,EAAE;SACX;QACD;YACE,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,kBAAkB;YACvB,MAAM,EAAE,EAAE;SACX;KACF;IACD,SAAS,EAAE,EAAE;CACd,CAAC"}

package/dist/help/helpFile.d.ts

@@ -0,0 +1,88 @@
+import { WAKE_GROUPS } from '../triggers/wake-assets.js';
+/** 「饼干记账help」交付文件的文件名主体：配置项 `html.helpStem` 的**具名引用**（默认 `饼干记账_HELP`）。
+ *  对外不接受调用方传入（照 #139 S3-3）——用户改的是配置文件，不是这条命令的参数。 */
+export declare const HELP_FILE_STEM: string;
+/** HELP 文件名主体：配置 `html.helpStem` 非空即用它，空串＝`HELP_FILE_STEM`（#726 起取值走配置文件）。 */
+export declare function helpFileStem(): string;
+/** 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/help/helpFile.d.ts.map

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