skill-bill 0.2.0 → 0.2.1

package/dist/analysis/scene-activity.js

@@ -0,0 +1,108 @@
+import { allRecords, kpiOf, round1 } from './agg.js';
+import { NO_WINDOW } from './pageParts.js';
+import { buildTrend } from './views.js';
+/** 一周七天的名字（逐字照老侧 `weekday_names` 的次序；`getUTCDay()` 是 0＝周日）。 */
+const WEEKDAY_NAMES = ['周一', '周二', '周三', '周四', '周五', '周六', '周日'];
+/** 记录时刻落在星期几；时间串认不得＝空串（这一笔不归堆）。 */
+function weekdayOf(time) {
+    const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(time);
+    if (m === null)
+        return '';
+    const d = new Date(Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3])));
+    return WEEKDAY_NAMES[(d.getUTCDay() + 6) % 7];
+}
+/** 记录时刻落在几点（两位小时串）；时间串认不得＝空串（这一笔不归堆）。 */
+function hourOf(time) {
+    const m = /^\d{4}-\d{2}-\d{2} (\d{2}):/.exec(time);
+    return m === null ? '' : m[1];
+}
+/** 按某个键分堆（只收键非空的记录）。 */
+function tally(records, keyOf) {
+    const out = new Map();
+    for (const r of records) {
+        const k = keyOf(r);
+        if (k === '')
+            continue;
+        out.set(k, (out.get(k) ?? 0) + 1);
+    }
+    return out;
+}
+/** 计数最大的一格（并列取先出现的那一格；没有桶＝null）。 */
+function peakOf(buckets) {
+    let best = null;
+    for (const b of buckets)
+        if (best === null || b.count > best.count)
+            best = b;
+    return best;
+}
+export const sceneActivity = {
+    id: 'activity',
+    key: 'bill.analysis.trend',
+    kind: 'activity',
+    title: '看活跃',
+    family: 'bars',
+    values: ({ db }) => {
+        const rows = allRecords(db);
+        const total = rows.length;
+        const byWeekday = tally(rows, (r) => weekdayOf(r.time));
+        const byHour = tally(rows, (r) => hourOf(r.time));
+        const weekdays = WEEKDAY_NAMES.map((name) => ({ key: name, count: byWeekday.get(name) ?? 0 }));
+        const hours = [...byHour.entries()]
+            .map(([key, count]) => ({ key, count }))
+            .sort((a, b) => a.key.localeCompare(b.key));
+        const peakDay = weekdays.reduce((max, w) => Math.max(max, w.count), 0);
+        const peakHour = hours.reduce((max, h) => Math.max(max, h.count), 0);
+        const busiestDay = peakOf(weekdays);
+        const busiestHour = peakOf(hours);
+        return {
+            title: '看活跃',
+            label: '全部时间',
+            from: NO_WINDOW,
+            to: NO_WINDOW,
+            count: total,
+            conclusion: total === 0
+                ? '全库还没有记录，看不出活跃规律。'
+                : '一共 ' + String(total) + ' 笔记录，记最多的是' + String(busiestDay === null ? '' : busiestDay.key)
+                    + '（' + String(busiestDay === null ? 0 : busiestDay.count) + ' 笔）'
+                    + (busiestHour === null
+                        ? '。'
+                        : '；最常记的时段是 ' + busiestHour.key + ' 点（' + String(busiestHour.count) + ' 笔）。'),
+            caliber: '按记录时刻的星期与小时归堆：周一到周日七行恒出，时段只列有记录的小时；转账记录也是记录，一并算在内。',
+            chips: ['共 ' + String(total) + ' 条记录'],
+            payload: buildTrend('activity', [...rows]),
+            kpi: kpiOf(rows),
+            page: {
+                kpis: [],
+                chips: [],
+                charts: [],
+                barGroups: [
+                    {
+                        title: '周几分布（周一 ~ 周日）',
+                        rows: weekdays.map((w) => ({
+                            label: w.key,
+                            text: String(w.count) + ' 笔',
+                            pct: peakDay === 0 ? 0 : round1((w.count / peakDay) * 100),
+                        })),
+                        emptyText: '还没有记录，看不出周几记得多',
+                    },
+                    {
+                        title: '时段分布（' + String(hours.length) + ' 个时段）',
+                        rows: hours.map((h) => ({
+                            label: h.key + ' 点',
+                            text: String(h.count) + ' 笔',
+                            pct: peakHour === 0 ? 0 : round1((h.count / peakHour) * 100),
+                        })),
+                        emptyText: '还没有记录，看不出哪个时段记得多',
+                    },
+                ],
+                listCards: [],
+                factCards: [],
+                empty: {
+                    text: '全库还没有记录，看不出活跃规律。',
+                    hint: '先说「记支出」或「记收入」记一笔，回来看这里就有数了。',
+                },
+            },
+        };
+    },
+};
+//# sourceMappingURL=scene-activity.js.map

package/dist/analysis/scene-activity.js.map

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

package/dist/analysis/scene-anomaly.d.ts

@@ -0,0 +1,3 @@
+import type { AnalysisScene } from './scene.js';
+export declare const sceneAnomaly: AnalysisScene;
+//# sourceMappingURL=scene-anomaly.d.ts.map

package/dist/analysis/scene-anomaly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-anomaly.d.ts","sourceRoot":"","sources":["../../src/analysis/scene-anomaly.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,YAAY,CAAC;AAuG3D,eAAO,MAAM,YAAY,EAAE,aA6F1B,CAAC"}

package/dist/analysis/scene-anomaly.js

@@ -0,0 +1,173 @@
+import { BillPolicyError } from '../fetch/errors.js';
+import { monthRange } from '../shared/dateRange.js';
+import { aggByL1, allRecords, kpiOf, monthOf, monthSeries, round1 } from './agg.js';
+import { MISSING, NO_WINDOW, money, pctText, windowLabel } from './pageParts.js';
+import { buildTrend } from './views.js';
+/** 正整数型参数（缺＝缺省值）。老侧 `args.months or 6` 的严格版：形态不对即报参数错。 */
+function monthsOf(params, fallback) {
+    const raw = params['months'];
+    if (raw === undefined || raw === null || raw === '')
+        return fallback;
+    const n = typeof raw === 'number' ? raw : Number(String(raw));
+    if (!Number.isFinite(n) || n < 1)
+        throw new BillPolicyError('POLICY_BAD_INPUT', '窗口月数须是正整数');
+    return Math.floor(n);
+}
+/** 窗口内的记录（序列覆盖的那些月；含转账，收支口径由 `kpiOf` 剔）。 */
+function windowRowsOf(rows, series) {
+    const keep = new Set(series.map((p) => p.month));
+    return rows.filter((r) => keep.has(monthOf(r.time)));
+}
+/** 序列里**没有记录**的月份（`count === 0`＝那个月一条记录都没有）。 */
+function gapsOf(series) {
+    return series.filter((p) => p.count === 0).map((p) => p.month);
+}
+/** 月度环比：只算相邻两个月**都有支出**的那些月（空月与支出为 0 的月不参与对比）。 */
+function momOf(series) {
+    const out = [];
+    for (let i = 1; i < series.length; i += 1) {
+        const prev = series[i - 1];
+        const cur = series[i];
+        if (prev.expense <= 0 || cur.expense <= 0)
+            continue;
+        out.push({
+            month: cur.month,
+            prev: prev.expense,
+            cur: cur.expense,
+            pct: round1(((cur.expense - prev.expense) / prev.expense) * 100),
+        });
+    }
+    return out;
+}
+/** 分类暴涨：最近一个月 vs 上一个**有记录的**月，按一级分类算支出，涨幅降序取前 10（老侧同序）。 */
+function surgeOf(rows, last, prev) {
+    const before = new Map(aggByL1(rows.filter((r) => monthOf(r.time) === prev)).map((a) => [a.key, a.value]));
+    return aggByL1(rows.filter((r) => monthOf(r.time) === last))
+        .map((a) => {
+        const base = before.get(a.key) ?? 0;
+        return { category: a.key, prev: base, cur: a.value, pct: base === 0 ? 0 : round1(((a.value - base) / base) * 100) };
+    })
+        .filter((x) => x.prev > 0 && x.cur > x.prev)
+        .sort((a, b) => b.pct - a.pct)
+        .slice(0, 10);
+}
+/** 折线点：没有记录的月 `value: null`——公共层据此不出点，并按 `gapStyle: 'dashed'` 出同色虚线桥接。 */
+function lineItemsOf(series, pick) {
+    return series.map((p) => ({ label: p.month.slice(2), value: p.count === 0 ? null : pick(p) }));
+}
+/** 折线图卡的数据：两条系列（支出／收入）＋ 纵轴刻度 ＋ 同色虚线跨空档；可用点少于 2 个改出说明句。 */
+function lineInputOf(series, usable, emptyText) {
+    if (usable < 2)
+        return { items: [], options: { emptyText } };
+    const expense = lineItemsOf(series, (p) => p.expense);
+    const income = lineItemsOf(series, (p) => p.income);
+    return {
+        items: expense,
+        options: {
+            series: [{ name: '支出', items: expense }, { name: '收入', items: income }],
+            yTicks: 4,
+            /* 纵轴下界恒 0：金额没有负数，公共层派生的那 6% 下外扩会印出「-732.26 元」这种读不出意思的刻度。 */
+            yMin: 0,
+            legend: true,
+            tooltip: true,
+            labels: 'select',
+            gapStyle: 'dashed',
+            format: money,
+        },
+    };
+}
+/** 一行的箭头与百分比（升／降／持平三态；持平不留白、也不谎报降）。 */
+function deltaText(pct) {
+    return (pct > 0 ? '↑ ' : pct < 0 ? '↓ ' : '→ ') + pctText(Math.abs(pct));
+}
+export const sceneAnomaly = {
+    id: 'anomaly',
+    key: 'bill.analysis.trend',
+    kind: 'anomaly',
+    title: '看异常',
+    family: 'charts',
+    values: ({ params, db }) => {
+        /* ① 取数：窗口＝近 N 个月，序列终点＝库里最新一条记录所在的月（不取今天的月）。 */
+        const months = monthsOf(params, 6);
+        const all = allRecords(db);
+        const series = monthSeries(all, months);
+        const rows = windowRowsOf(all, series);
+        const kpi = kpiOf(rows);
+        const gaps = gapsOf(series);
+        const recorded = series.filter((p) => p.count > 0);
+        const mom = momOf(series);
+        const widest = mom.length === 0 ? null : [...mom].sort((a, b) => Math.abs(b.pct) - Math.abs(a.pct))[0];
+        /* ② 分类暴涨：最近一个月 vs 上一个有记录的月（按一级分类算支出，涨幅降序前 10）。 */
+        const withRows = [...new Set(all.map((r) => monthOf(r.time)))].sort();
+        const lastMonth = withRows.length >= 2 ? withRows[withRows.length - 1] : '';
+        const prevMonth = withRows.length >= 2 ? withRows[withRows.length - 2] : '';
+        const surge = lastMonth === '' ? [] : surgeOf(all, lastMonth, prevMonth);
+        const topSurge = surge.length === 0 ? null : surge[0];
+        /* ③ 期间标签与来源脚注的窗口起止。 */
+        const firstMonth = series.length === 0 ? '' : series[0].month;
+        const endMonth = series.length === 0 ? '' : series[series.length - 1].month;
+        /* ④ 结论句与口径句：空月点名（裁定 3 第 4 条）＋ 可执行的下一步（#688 §二 C9）。 */
+        const conclusion = kpi.count === 0
+            ? '近 ' + String(months) + ' 个月还没有记录。'
+            : widest === null
+                ? '近 ' + String(series.length) + ' 个月里没有相邻两个月都有支出，算不出环比。'
+                : '近 ' + String(series.length) + ' 个月里支出环比变化最大的是 ' + widest.month
+                    + '（' + money(widest.prev) + ' 元 → ' + money(widest.cur) + ' 元，' + deltaText(widest.pct) + '）；'
+                    + (topSurge === null
+                        ? '最近一个月没有分类出现支出暴涨。'
+                        : '涨幅最高的是「' + topSurge.category + '」（+' + pctText(topSurge.pct) + '）。');
+        const caliber = [
+            '环比只算相邻两个月都有支出的那些月（没有记录的月、以及支出为 0 的月都不参与对比）',
+            '窗口取近 ' + String(months) + ' 个月，终点是库里最新一条记录所在的月（不是今天）',
+            gaps.length === 0
+                ? '这 ' + String(series.length) + ' 个月每个月都有记录'
+                : gaps.join('、') + ' 这 ' + String(gaps.length) + ' 个月没有记录，折线在那里断开、用同色虚线桥接',
+            recorded.length < 2 ? '有记录的月不到 2 个，不画半截线、图卡改出说明句' : '',
+            lastMonth === '' ? '库里的记录不足两个月，比不出分类暴涨' : '分类暴涨比的是 ' + prevMonth + ' 与 ' + lastMonth
+                + ' 这两个有记录的月，按一级分类算支出',
+            '建议核对: 是否存在一次性大额 / 记错分类 / 真实增长',
+            '转账不计入收支',
+        ].filter((s) => s !== '').join('；') + '。';
+        return {
+            title: '看异常',
+            label: windowLabel(firstMonth, endMonth),
+            from: firstMonth === '' ? NO_WINDOW : monthRange(firstMonth).start,
+            to: endMonth === '' ? NO_WINDOW : monthRange(endMonth).end,
+            count: rows.length,
+            conclusion,
+            caliber,
+            chips: ['近 ' + String(months) + ' 个月'],
+            payload: buildTrend('anomaly', [...all], { limit: 6 }),
+            kpi,
+            page: {
+                kpis: [],
+                chips: ['近 ' + String(months) + ' 个月'],
+                charts: [{
+                        title: '月度序列',
+                        kind: 'line',
+                        input: lineInputOf(series, recorded.length, '有记录的月不到 2 个，画不出月度序列；环比那条逐月列在下面。'),
+                    }],
+                listCards: [{
+                        title: '月度环比变化',
+                        rows: mom.map((x) => ({
+                            left: x.month,
+                            main: money(x.prev) + ' → ' + money(x.cur),
+                            right: deltaText(x.pct),
+                        })),
+                        emptyText: '窗口里没有相邻两个月都有支出，算不出环比',
+                    }],
+                factCards: [{
+                        title: '分类暴涨检测',
+                        rows: surge.length === 0
+                            ? [{ k: '最近一个月与上一个有记录的月比，没有分类出现支出暴涨', v: MISSING }]
+                            : surge.map((x) => ({ k: x.category + ' +' + pctText(x.pct), v: money(x.prev) + ' → ' + money(x.cur) })),
+                    }],
+                empty: {
+                    text: '近 ' + String(months) + ' 个月还没有记录。',
+                    hint: '先说「记支出」或「记收入」记一笔，回来看这里就有数了。',
+                },
+            },
+        };
+    },
+};
+//# sourceMappingURL=scene-anomaly.js.map

package/dist/analysis/scene-anomaly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-anomaly.js","sourceRoot":"","sources":["../../src/analysis/scene-anomaly.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEpF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkBxC,0DAA0D;AAC1D,SAAS,QAAQ,CAAC,MAA+B,EAAE,QAAgB;IACjE,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IACrE,MAAM,CAAC,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;IAC7F,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,4CAA4C;AAC5C,SAAS,YAAY,CAAC,IAAwB,EAAE,MAA6B;IAC3E,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACjD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,gDAAgD;AAChD,SAAS,MAAM,CAAC,MAA6B;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,kDAAkD;AAClD,SAAS,KAAK,CAAC,MAA6B;IAC1C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC;YAAE,SAAS;QACpD,GAAG,CAAC,IAAI,CAAC;YACP,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,IAAI,CAAC,OAAO;YAClB,GAAG,EAAE,GAAG,CAAC,OAAO;YAChB,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC;SACjE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2DAA2D;AAC3D,SAAS,OAAO,CAAC,IAAwB,EAAE,IAAY,EAAE,IAAY;IACnE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3G,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;SACzD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;IACtH,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC;SAC3C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;SAC7B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,0EAA0E;AAC1E,SAAS,WAAW,CAClB,MAA6B,EAC7B,IAA+B;IAE/B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,0DAA0D;AAC1D,SAAS,WAAW,CAAC,MAA6B,EAAE,MAAc,EAAE,SAAiB;IACnF,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC;IAC7D,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO;QACL,KAAK,EAAE,OAAO;QACd,OAAO,EAAE;YACP,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACvE,MAAM,EAAE,CAAC;YACT,4DAA4D;YAC5D,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,KAAK;SACd;KACF,CAAC;AACJ,CAAC;AAED,uCAAuC;AACvC,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,EAAE,EAAE,SAAS;IACb,GAAG,EAAE,qBAAqB;IAC1B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE;QACzB,+CAA+C;QAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvG,kDAAkD;QAClD,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtE,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,KAAK,GAAG,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtD,uBAAuB;QACvB,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;QAE5E,sDAAsD;QACtD,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,KAAK,CAAC;YAChC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW;YACrC,CAAC,CAAC,MAAM,KAAK,IAAI;gBACf,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,wBAAwB;gBACzD,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,iBAAiB,GAAG,MAAM,CAAC,KAAK;sBAC7D,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI;sBAC7F,CAAC,QAAQ,KAAK,IAAI;wBAClB,CAAC,CAAC,kBAAkB;wBACpB,CAAC,CAAC,SAAS,GAAG,QAAQ,CAAC,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAChF,MAAM,OAAO,GAAG;YACd,4CAA4C;YAC5C,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,2BAA2B;YACtD,IAAI,CAAC,MAAM,KAAK,CAAC;gBACf,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,YAAY;gBAC7C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,yBAAyB;YAC5E,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE;YACtD,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS;kBAChF,oBAAoB;YACxB,+BAA+B;YAC/B,SAAS;SACV,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QAE1C,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC;YACxC,IAAI,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,KAAK;YAClE,EAAE,EAAE,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,GAAG;YAC1D,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,UAAU;YACV,OAAO;YACP,KAAK,EAAE,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;YACtC,OAAO,EAAE,UAAU,CAAC,SAAS,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACtD,GAAG;YACH,IAAI,EAAE;gBACJ,IAAI,EAAE,EAAE;gBACR,KAAK,EAAE,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;gBACtC,MAAM,EAAE,CAAC;wBACP,KAAK,EAAE,MAAM;wBACb,IAAI,EAAE,MAAM;wBACZ,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAC;qBAC/E,CAAC;gBACF,SAAS,EAAE,CAAC;wBACV,KAAK,EAAE,QAAQ;wBACf,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BACpB,IAAI,EAAE,CAAC,CAAC,KAAK;4BACb,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;4BAC1C,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;yBACxB,CAAC,CAAC;wBACH,SAAS,EAAE,sBAAsB;qBAClC,CAAC;gBACF,SAAS,EAAE,CAAC;wBACV,KAAK,EAAE,QAAQ;wBACf,IAAI,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC;4BACtB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,4BAA4B,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;4BACnD,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;qBAC3G,CAAC;gBACF,KAAK,EAAE;oBACL,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW;oBACzC,IAAI,EAAE,6BAA6B;iBACpC;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/analysis/scene-cat-compare.d.ts

@@ -0,0 +1,3 @@
+import type { AnalysisScene } from './scene.js';
+export declare const sceneCatCompare: AnalysisScene;
+//# sourceMappingURL=scene-cat-compare.d.ts.map

package/dist/analysis/scene-cat-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-cat-compare.d.ts","sourceRoot":"","sources":["../../src/analysis/scene-cat-compare.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAwChD,eAAO,MAAM,eAAe,EAAE,aA6E7B,CAAC"}

package/dist/analysis/scene-cat-compare.js

@@ -0,0 +1,128 @@
+/** 场景件：**看分类对比**（`kind = 'category'`，命令 `bill.analysis.compare`）——本件只是差异声明与取值，
+ *  块位序列住 `./template-compare.ts`（族＝对比＋变更）。
+ *
+ *  老侧对应件：`scripts/analysis/cli.py` 的 `cmd_cat_compare`（`:485-519`）＋ 模板
+ *  `templates/分析/analysis_view.html` 的 `renderCatCompare`（`:602-627`）。
+ *
+ *  本件的差异（照老侧那一页逐点对）：
+ *   ① **两套槽位名都认**（与「看双区间」同一条）：先取 `startA`／`endA`／`startB`／`endB`，
+ *      任缺再退回老侧那套 `from1`／`to1`／`from2`／`to2`；缺一个即 `POLICY_MISSING_SLOT`；
+ *   ② **只算支出侧**（老侧 `_filter(..., type_="expense")`）：两段各按 L1 归堆算金额与笔数，
+ *      并起来算金额差与笔数差，绝对差降序取前 10（老侧 `rows[:10]`），条长按最大金额差折算；
+ *   ③ 老侧那页把每条差异摆成 `↑ 金额` 一行——新侧改摆**条卡**（#681 偏好 3：版式可全新设计），
+ *      两段金额、金额差与两段笔数一件不少（条卡比老侧那行多了两段笔数）。
+ */
+import { BillPolicyError } from '../fetch/errors.js';
+import { listRange } from '../fetch/index.js';
+import { normalizeDate } from '../shared/dateRange.js';
+import { aggByL1, filterOf, kpiOf, round1, round2 } from './agg.js';
+import { money, signedMoney } from './pageParts.js';
+import { buildCompare } from './views.js';
+/** 参数槽位的空写法（缺省、空串、非字符串一律当「没给」）。 */
+function slotText(v) {
+    return typeof v === 'string' ? v.trim() : '';
+}
+/** 两套槽位名择一：`startA` 那套优先，缺了退回 `from1` 那套。 */
+function slotOf(params, fresh, legacy) {
+    const v = slotText(params[fresh]);
+    return v === '' ? slotText(params[legacy]) : v;
+}
+/** 本次要比的两段：四个槽位缺一个即阻断；起止形态归一走 `../shared/dateRange.js`。 */
+function windowsOf(params) {
+    const a = { start: slotOf(params, 'startA', 'from1'), end: slotOf(params, 'endA', 'to1') };
+    const b = { start: slotOf(params, 'startB', 'from2'), end: slotOf(params, 'endB', 'to2') };
+    if (a.start === '' || a.end === '' || b.start === '' || b.end === '') {
+        throw new BillPolicyError('POLICY_MISSING_SLOT', '缺槽位 startA/endA/startB/endB（老写法 from1/to1/from2/to2 也认）');
+    }
+    const startA = normalizeDate(a.start, 'startA');
+    const endA = normalizeDate(a.end, 'endA');
+    const startB = normalizeDate(b.start, 'startB');
+    const endB = normalizeDate(b.end, 'endB');
+    if (startA > endA)
+        throw new BillPolicyError('POLICY_BAD_INPUT', '区间一起点不得晚于终点：' + startA + '~' + endA);
+    if (startB > endB)
+        throw new BillPolicyError('POLICY_BAD_INPUT', '区间二起点不得晚于终点：' + startB + '~' + endB);
+    return {
+        a: { label: startA + '~' + endA, start: startA, end: endA },
+        b: { label: startB + '~' + endB, start: startB, end: endB },
+    };
+}
+export const sceneCatCompare = {
+    id: 'cat_compare',
+    key: 'bill.analysis.compare',
+    kind: 'category',
+    title: '看分类对比',
+    family: 'compare',
+    values: ({ params, db }) => {
+        const { a: winA, b: winB } = windowsOf(params);
+        const ra = listRange(db, winA.start, winA.end);
+        const rb = listRange(db, winB.start, winB.end);
+        /* 只算支出侧：转账与收入都不进来（`filterOf` 已剔转账）。 */
+        const ea = filterOf(ra, { direction: 'expense' });
+        const eb = filterOf(rb, { direction: 'expense' });
+        const ga = new Map(aggByL1(ea).map((x) => [x.key, x]));
+        const gb = new Map(aggByL1(eb).map((x) => [x.key, x]));
+        const all = [...new Set([...ga.keys(), ...gb.keys()])]
+            .map((key) => {
+            const x = ga.get(key);
+            const y = gb.get(key);
+            const av = x === undefined ? 0 : x.value;
+            const bv = y === undefined ? 0 : y.value;
+            const aCount = x === undefined ? 0 : x.count;
+            const bCount = y === undefined ? 0 : y.count;
+            return {
+                key, a: av, b: bv, aCount, bCount,
+                amount: round2(av - bv),
+                countDiff: aCount - bCount,
+            };
+        })
+            .sort((x, y) => Math.abs(y.amount) - Math.abs(x.amount) || x.key.localeCompare(y.key));
+        /* 条卡只摆前 10 类（老侧 `rows[:10]`）；结论句里的类数报**全部**几类（老侧标题那枚 `TOP 10` 报的是摆出来的条数）。 */
+        const rows = all.slice(0, 10);
+        const maxAbs = rows.reduce((m, r) => Math.max(m, Math.abs(r.amount)), 0);
+        /* 两段支出合计的差只用来定方向（老侧 `cmd_cat_compare` 只打分类那一列，本页不出变更徽标）。 */
+        const sumA = round2(ea.reduce((s, r) => s + Math.abs(r.amount), 0));
+        const sumB = round2(eb.reduce((s, r) => s + Math.abs(r.amount), 0));
+        const diff = round2(sumA - sumB);
+        const direction = diff > 0.01 ? 'up' : diff < -0.01 ? 'down' : 'flat';
+        const head = rows[0];
+        return {
+            title: '看分类对比',
+            label: winA.label + ' 与 ' + winB.label,
+            from: winA.start < winB.start ? winA.start : winB.start,
+            to: winA.end > winB.end ? winA.end : winB.end,
+            count: ra.length + rb.length,
+            conclusion: head === undefined
+                ? winA.label + ' 与 ' + winB.label + ' 两段都没有支出记录。'
+                : winA.label + ' 与 ' + winB.label + ' 两段共 ' + String(all.length) + ' 类支出：金额差最大的是「'
+                    + head.key + '」' + signedMoney(head.amount) + ' 元（' + money(head.a) + ' → ' + money(head.b)
+                    + '）；两段支出合计差 ' + signedMoney(diff) + ' 元。',
+            caliber: '只算支出侧；分类按一级归堆（两级／三级分类并到一级），条长按最大金额差折算，金额差降序取前 10 类；转账不计入收支。',
+            chips: ['区间一 ' + winA.start + '~' + winA.end, '区间二 ' + winB.start + '~' + winB.end],
+            payload: buildCompare({ labelA: winA.label, labelB: winB.label, a: [...ra], b: [...rb] }),
+            kpi: kpiOf([...ra, ...rb]),
+            page: {
+                kpis: [],
+                chips: ['区间一 ' + winA.start + '~' + winA.end, '区间二 ' + winB.start + '~' + winB.end],
+                sides: [],
+                change: { text: '', detail: '', direction },
+                barGroups: [{
+                        title: '金额变化最大（' + String(rows.length) + ' 类）',
+                        rows: rows.map((r) => ({
+                            label: r.key,
+                            text: money(r.a) + ' → ' + money(r.b) + ' · ' + signedMoney(r.amount)
+                                + '（' + String(r.aCount) + '笔→' + String(r.bCount) + '笔）',
+                            pct: maxAbs === 0 ? 0 : round1((Math.abs(r.amount) / maxAbs) * 100),
+                        })),
+                        emptyText: '两段都没有支出记录',
+                    }],
+                factCards: [],
+                empty: {
+                    text: '两段都没有支出记录。',
+                    hint: '先说「记支出」记一笔，回来看这里就有数了。',
+                },
+            },
+        };
+    },
+};
+//# sourceMappingURL=scene-cat-compare.js.map

package/dist/analysis/scene-cat-compare.js.map

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

package/dist/analysis/scene-cat-trend.d.ts

@@ -0,0 +1,3 @@
+import type { AnalysisScene } from './scene.js';
+export declare const sceneCatTrend: AnalysisScene;
+//# sourceMappingURL=scene-cat-trend.d.ts.map

package/dist/analysis/scene-cat-trend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-cat-trend.d.ts","sourceRoot":"","sources":["../../src/analysis/scene-cat-trend.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,YAAY,CAAC;AA2C3D,eAAO,MAAM,aAAa,EAAE,aA+E3B,CAAC"}

package/dist/analysis/scene-cat-trend.js

@@ -0,0 +1,121 @@
+import { BillPolicyError } from '../fetch/errors.js';
+import { monthRange } from '../shared/dateRange.js';
+import { allRecords, filterOf, kpiOf, monthOf, monthSeries, round2 } from './agg.js';
+import { MISSING, NO_WINDOW, money, windowLabel } from './pageParts.js';
+import { buildTrend } from './views.js';
+/** 分类名（缺＝「餐饮」，与老侧同一句缺省）。给了但不是非空串即报参数错。 */
+function categoryOf(params) {
+    const raw = params['category'];
+    if (raw === undefined || raw === null || raw === '')
+        return '餐饮';
+    if (typeof raw !== 'string' || raw.trim() === '') {
+        throw new BillPolicyError('POLICY_BAD_INPUT', '分类名须是非空字符串');
+    }
+    return raw.trim();
+}
+/** 正整数型参数（缺＝缺省值）。老侧 `args.months or 12` 的严格版：形态不对即报参数错。 */
+function monthsOf(params, fallback) {
+    const raw = params['months'];
+    if (raw === undefined || raw === null || raw === '')
+        return fallback;
+    const n = typeof raw === 'number' ? raw : Number(String(raw));
+    if (!Number.isFinite(n) || n < 1)
+        throw new BillPolicyError('POLICY_BAD_INPUT', '窗口月数须是正整数');
+    return Math.floor(n);
+}
+/** 窗口内的记录（序列覆盖的那些月）。 */
+function windowRowsOf(rows, series) {
+    const keep = new Set(series.map((p) => p.month));
+    return rows.filter((r) => keep.has(monthOf(r.time)));
+}
+/** 序列里**没有记录**的月份（`count === 0`＝那个月这个分类一条记录都没有）。 */
+function gapsOf(series) {
+    return series.filter((p) => p.count === 0).map((p) => p.month);
+}
+/** 逐月柱图的数据：**只有支出大于 0 的月进图元**（零值不出柱身）；可用点不到 2 个改出说明句。 */
+function barInputOf(series, emptyText) {
+    const bars = series.filter((p) => p.expense > 0);
+    if (bars.length < 2)
+        return { items: [], options: { emptyText } };
+    return {
+        items: bars.map((p) => ({ label: p.month.slice(2), value: p.expense })),
+        options: { singleColor: true, showValues: true, yTicks: 4, format: money },
+    };
+}
+export const sceneCatTrend = {
+    id: 'cat_trend',
+    key: 'bill.analysis.trend',
+    kind: 'category',
+    title: '看分类趋势',
+    family: 'charts',
+    values: ({ params, db }) => {
+        /* ① 取数：先按一级分类筛，再取近 N 个月的逐月序列（终点＝该分类最新一条记录所在的月）。 */
+        const months = monthsOf(params, 12);
+        const category = categoryOf(params);
+        const all = allRecords(db);
+        const rows = filterOf(all, { categoryL1: category });
+        const series = monthSeries(rows, months);
+        const windowRows = windowRowsOf(rows, series);
+        const kpi = kpiOf(windowRows);
+        const gaps = gapsOf(series);
+        const bars = series.filter((p) => p.expense > 0);
+        /* ② 峰值与月均（老侧同式：月均的分母是窗口月数，不是有支出的月数）。 */
+        const totalExpense = series.reduce((sum, p) => sum + p.expense, 0);
+        const peak = series.reduce((max, p) => (p.expense > max ? p.expense : max), 0);
+        const avg = series.length === 0 ? 0 : round2(totalExpense / series.length);
+        const head = series.find((p) => p.count > 0 && p.expense === peak);
+        const peakMonth = peak > 0 && head !== undefined ? head.month : MISSING;
+        /* ③ 期间标签与来源脚注的窗口起止。 */
+        const firstMonth = series.length === 0 ? '' : series[0].month;
+        const lastMonth = series.length === 0 ? '' : series[series.length - 1].month;
+        /* ④ 结论句与口径句：空月点名（裁定 3 第 4 条）＋ 零值不出柱 ＋ 点数不足的说明句。 */
+        const conclusion = kpi.count === 0
+            ? '「' + category + '」近 ' + String(months) + ' 个月一笔支出都没有。'
+            : '「' + category + '」近 ' + String(series.length) + ' 个月一共支出 ' + money(totalExpense) + ' 元'
+                + (peak > 0 ? '：最高的是 ' + peakMonth + '（' + money(peak) + ' 元）' : '')
+                + '，平均每月 ' + money(avg) + ' 元。';
+        const caliber = [
+            '按一级分类「' + category + '」归堆（' + category + ' 下面的二级、三级分类一并算进来）',
+            '窗口取近 ' + String(months) + ' 个月，终点是这个分类最新一条记录所在的月（不是今天）',
+            gaps.length === 0
+                ? '这 ' + String(series.length) + ' 个月每个月都有记录'
+                : gaps.join('、') + ' 这 ' + String(gaps.length) + ' 个月没有记录，柱图里不出那几个月',
+            '支出为 0 的月同样不出柱身',
+            bars.length < 2 ? '有支出的月不到 2 个，不画半个逐月图、图卡改出说明句' : '',
+            '转账不计入收支',
+        ].filter((s) => s !== '').join('；') + '。';
+        return {
+            title: '看分类趋势',
+            label: category + ' · ' + windowLabel(firstMonth, lastMonth),
+            from: firstMonth === '' ? NO_WINDOW : monthRange(firstMonth).start,
+            to: lastMonth === '' ? NO_WINDOW : monthRange(lastMonth).end,
+            count: windowRows.length,
+            conclusion,
+            caliber,
+            chips: [],
+            payload: buildTrend('category', [...rows], { limit: 12 }),
+            kpi,
+            page: {
+                kpis: [
+                    { label: '分类', value: category },
+                    { label: '峰值月', value: peakMonth },
+                    { label: '峰值支出', value: money(peak), unit: '元' },
+                    { label: '月均', value: money(avg), unit: '元' },
+                ],
+                chips: [],
+                charts: [{
+                        title: category + ' 逐月支出',
+                        kind: 'bar',
+                        input: barInputOf(series, '有支出的月不到 2 个，画不出逐月柱子；合计与峰值看上面那排读数。'),
+                    }],
+                listCards: [],
+                factCards: [],
+                empty: {
+                    text: '近 ' + String(months) + ' 个月里「' + category + '」还没有记录。',
+                    hint: '先说「记支出」记一笔，或者换一个分类再看；回来看这里就有数了。',
+                },
+            },
+        };
+    },
+};
+//# sourceMappingURL=scene-cat-trend.js.map

package/dist/analysis/scene-cat-trend.js.map

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

package/dist/analysis/scene-category.d.ts

@@ -0,0 +1,3 @@
+import type { AnalysisScene } from './scene.js';
+export declare const sceneCategory: AnalysisScene;
+//# sourceMappingURL=scene-category.d.ts.map

package/dist/analysis/scene-category.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-category.d.ts","sourceRoot":"","sources":["../../src/analysis/scene-category.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAiBhD,eAAO,MAAM,aAAa,EAAE,aAkE3B,CAAC"}