@skillfm/local 2.7.2 → 2.7.4

package/dist/checkup/dimension-4-context.js

@@ -0,0 +1,177 @@
+// sdk/skillfm-local/src/checkup/dimension-4-context.ts
+//
+// 维度 4: 上下文占用 / 一键整理 (PRD §4.4) — AI 时代独有.
+// 检测各 agent harness 的当前 session 上下文 % 用量.
+//
+// MVP: 只 surface OpenClaw (我们已 verify 真 schema), Claude Code/Cursor 后续 batch.
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+const OPENCLAW_AGENTS_DIR = path.join(homedir(), '.openclaw', 'agents');
+/**
+ * 估算 model 的 context window 上限 (粗略, MVP)
+ * 后续可改成跟 model-pricing.ts 联动 (按 modelId 真查上限)
+ */
+function estimateContextWindow(modelId) {
+    const m = modelId.toLowerCase();
+    if (m.includes('claude') && m.includes('1m'))
+        return 1_000_000;
+    if (m.includes('claude'))
+        return 200_000;
+    if (m.includes('gpt-4o') || m.includes('o1'))
+        return 128_000;
+    if (m.includes('gpt-4-turbo'))
+        return 128_000;
+    if (m.includes('minimax'))
+        return 200_000;
+    if (m.includes('deepseek'))
+        return 128_000;
+    if (m.includes('qwen'))
+        return 128_000;
+    if (m.includes('doubao'))
+        return 128_000;
+    if (m.includes('kimi'))
+        return 200_000;
+    return 128_000; // fallback
+}
+/**
+ * 扫 OpenClaw agents/<id>/sessions/*.trajectory.jsonl 的最后一条 model.completed
+ * 看当前 session 累计 token + 估算 context window 占用
+ */
+async function scanOpenClawSessions() {
+    if (!fs.existsSync(OPENCLAW_AGENTS_DIR))
+        return [];
+    const out = [];
+    const agents = await fs.promises.readdir(OPENCLAW_AGENTS_DIR, { withFileTypes: true });
+    for (const agent of agents) {
+        if (!agent.isDirectory())
+            continue;
+        const sessionsDir = path.join(OPENCLAW_AGENTS_DIR, agent.name, 'sessions');
+        if (!fs.existsSync(sessionsDir))
+            continue;
+        const files = await fs.promises.readdir(sessionsDir);
+        for (const f of files) {
+            if (!f.endsWith('.trajectory.jsonl'))
+                continue;
+            const filePath = path.join(sessionsDir, f);
+            const status = await readLastModelCompleted(filePath);
+            if (status)
+                out.push(status);
+        }
+    }
+    return out;
+}
+/**
+ * 读 trajectory.jsonl 最后一个 model.completed event
+ * 返 ContextStatus (含 input/output/cacheRead 加总作为当前 context size 估算)
+ */
+async function readLastModelCompleted(filePath) {
+    try {
+        // tail 100KB (大多数 jsonl session 是 5-10MB, 后 100KB 足够找最近 event)
+        const stat = await fs.promises.stat(filePath);
+        const readSize = Math.min(stat.size, 100 * 1024);
+        const startOffset = stat.size - readSize;
+        const buf = Buffer.alloc(readSize);
+        const fd = await fs.promises.open(filePath, 'r');
+        try {
+            await fd.read(buf, 0, readSize, startOffset);
+        }
+        finally {
+            await fd.close();
+        }
+        const text = buf.toString('utf-8');
+        const lines = text.split('\n').reverse();
+        let modelId = '';
+        let provider = '';
+        let lastUsage = null;
+        let turn_count = 0;
+        for (const line of lines) {
+            if (!line.trim().startsWith('{'))
+                continue;
+            try {
+                const ev = JSON.parse(line);
+                if (ev.type === 'model.completed' && ev.data?.usage) {
+                    turn_count += 1;
+                    if (!lastUsage) {
+                        lastUsage = ev.data.usage;
+                        modelId = ev.modelId ?? '';
+                        provider = ev.provider ?? '';
+                    }
+                }
+            }
+            catch {
+                // skip
+            }
+        }
+        if (!lastUsage)
+            return null;
+        // 当前 context size ~ input + cacheRead (system prompt + history)
+        const current_tokens = (lastUsage.input ?? 0) + (lastUsage.cacheRead ?? 0);
+        const max = estimateContextWindow(modelId);
+        return {
+            agent_harness: 'openclaw',
+            session_id: path.basename(filePath, '.trajectory.jsonl'),
+            current_tokens,
+            context_window_max: max,
+            utilization_pct: (current_tokens / max) * 100,
+            turn_count,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export async function checkDimensionContext() {
+    const sessions = await scanOpenClawSessions();
+    const findings = [];
+    let severity = 'healthy';
+    // 找最严重的 session (占比最高)
+    const sorted = sessions.sort((a, b) => b.utilization_pct - a.utilization_pct);
+    const worst = sorted[0];
+    if (worst) {
+        if (worst.utilization_pct > 90) {
+            findings.push({
+                headline: `${worst.agent_harness} session 上下文 ${worst.utilization_pct.toFixed(0)}% — 接近爆`,
+                severity: 'critical',
+                score_deduction: 25,
+                fix_label: 'rotate session (新干净 session, 旧 turn summary 进 memory) [Pro 自动]',
+                fix_free_allowed: false, // Free 只 surface 提示, Pro 自动 rotate
+                estimated_savings: { description: '估省后续 60% input token' },
+            });
+            severity = 'critical';
+        }
+        else if (worst.utilization_pct > 80) {
+            findings.push({
+                headline: `${worst.agent_harness} session 上下文 ${worst.utilization_pct.toFixed(0)}% — 偏高`,
+                severity: 'warning',
+                score_deduction: 15,
+                fix_label: 'rotate session 让 agent 又快又聪明 [Pro 自动]',
+                fix_free_allowed: false,
+                estimated_savings: { description: '估省后续 40% input token' },
+            });
+            severity = 'warning';
+        }
+        else if (worst.turn_count > 30) {
+            findings.push({
+                headline: `${worst.agent_harness} session 已 ${worst.turn_count} turn — 建议考虑 rotate`,
+                severity: 'info',
+                score_deduction: 5,
+                fix_label: '考虑新开 session [Pro 自动]',
+                fix_free_allowed: false,
+            });
+            severity = 'info';
+        }
+    }
+    const headline = worst
+        ? `${worst.agent_harness} ${worst.utilization_pct.toFixed(0)}%${sessions.length > 1 ? ` (${sessions.length} session)` : ''}`
+        : '无 active session';
+    return {
+        dimension: 'context',
+        severity,
+        headline,
+        findings,
+        pro_locked: false,
+        sessions,
+    };
+}
+//# sourceMappingURL=dimension-4-context.js.map

package/dist/checkup/dimension-4-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-4-context.js","sourceRoot":"","sources":["../../src/checkup/dimension-4-context.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,2CAA2C;AAC3C,0CAA0C;AAC1C,EAAE;AACF,8EAA8E;AAE9E,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAiBlC,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AAExE;;;GAGG;AACH,SAAS,qBAAqB,CAAC,OAAe;IAC5C,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/D,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IAC7D,IAAI,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,OAAO,CAAC;IAC1C,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IACvC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IACvC,OAAO,OAAO,CAAC,CAAC,WAAW;AAC7B,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,oBAAoB;IACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC;QAAE,OAAO,EAAE,CAAC;IACnD,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACvF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC3E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,SAAS;QAC1C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAAE,SAAS;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,QAAQ,CAAC,CAAC;YACtD,IAAI,MAAM;gBAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,sBAAsB,CAAC,QAAgB;IACpD,IAAI,CAAC;QACH,+DAA+D;QAC/D,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC/C,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACzC,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,SAAS,GAAkE,IAAI,CAAC;QACpF,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC3C,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5B,IAAI,EAAE,CAAC,IAAI,KAAK,iBAAiB,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;oBACpD,UAAU,IAAI,CAAC,CAAC;oBAChB,IAAI,CAAC,SAAS,EAAE,CAAC;wBACf,SAAS,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;wBAC1B,OAAO,GAAG,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC;wBAC3B,QAAQ,GAAG,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC;oBAC/B,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;QACH,CAAC;QACD,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5B,gEAAgE;QAChE,MAAM,cAAc,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;QAC3E,MAAM,GAAG,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC3C,OAAO;YACL,aAAa,EAAE,UAAU;YACzB,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;YACxD,cAAc;YACd,kBAAkB,EAAE,GAAG;YACvB,eAAe,EAAE,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,GAAG;YAC7C,UAAU;SACX,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,QAAQ,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,IAAI,QAAQ,GAAa,SAAS,CAAC;IAEnC,uBAAuB;IACvB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,KAAK,CAAC,eAAe,GAAG,EAAE,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,GAAG,KAAK,CAAC,aAAa,gBAAgB,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBACzF,QAAQ,EAAE,UAAU;gBACpB,eAAe,EAAE,EAAE;gBACnB,SAAS,EAAE,gEAAgE;gBAC3E,gBAAgB,EAAE,KAAK,EAAE,mCAAmC;gBAC5D,iBAAiB,EAAE,EAAE,WAAW,EAAE,sBAAsB,EAAE;aAC3D,CAAC,CAAC;YACH,QAAQ,GAAG,UAAU,CAAC;QACxB,CAAC;aAAM,IAAI,KAAK,CAAC,eAAe,GAAG,EAAE,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,GAAG,KAAK,CAAC,aAAa,gBAAgB,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;gBACxF,QAAQ,EAAE,SAAS;gBACnB,eAAe,EAAE,EAAE;gBACnB,SAAS,EAAE,uCAAuC;gBAClD,gBAAgB,EAAE,KAAK;gBACvB,iBAAiB,EAAE,EAAE,WAAW,EAAE,sBAAsB,EAAE;aAC3D,CAAC,CAAC;YACH,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC;aAAM,IAAI,KAAK,CAAC,UAAU,GAAG,EAAE,EAAE,CAAC;YACjC,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,GAAG,KAAK,CAAC,aAAa,cAAc,KAAK,CAAC,UAAU,qBAAqB;gBACnF,QAAQ,EAAE,MAAM;gBAChB,eAAe,EAAE,CAAC;gBAClB,SAAS,EAAE,uBAAuB;gBAClC,gBAAgB,EAAE,KAAK;aACxB,CAAC,CAAC;YACH,QAAQ,GAAG,MAAM,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK;QACpB,CAAC,CAAC,GAAG,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5H,CAAC,CAAC,kBAAkB,CAAC;IAEvB,OAAO;QACL,SAAS,EAAE,SAAS;QACpB,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,UAAU,EAAE,KAAK;QACjB,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/checkup/index.d.ts

@@ -0,0 +1,11 @@
+export type { DimensionId, Severity, Finding, DimensionStatus, CheckupReport, HealthSnapshot, } from './types.js';
+export { runCheckup, renderMainEntry } from './report.js';
+export type { CheckupDeps } from './report.js';
+export { computeHealthScore, selectTopFocus, computeTrend, loadHealthHistory, appendHealthSnapshot, } from './score.js';
+export { checkDimensionUsage, buildUsageSurfaceLines } from './dimension-1-usage.js';
+export type { UsageDimDeps } from './dimension-1-usage.js';
+export { checkDimensionFiles, executeFileCleanup } from './dimension-3-files.js';
+export { checkDimensionContext } from './dimension-4-context.js';
+export { renderDailyPush, renderAnomalyPush, shouldPushRealtimeAnomaly, pushTimeToCron, DEFAULT_PUSH_CONFIG, } from './daily-push.js';
+export type { DailyPushConfig, PushTime } from './daily-push.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/checkup/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,WAAW,EACX,QAAQ,EACR,OAAO,EACP,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrF,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,cAAc,EACd,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/checkup/index.js

@@ -0,0 +1,10 @@
+// sdk/skillfm-local/src/checkup/index.ts
+//
+// Checkup public API.
+export { runCheckup, renderMainEntry } from './report.js';
+export { computeHealthScore, selectTopFocus, computeTrend, loadHealthHistory, appendHealthSnapshot, } from './score.js';
+export { checkDimensionUsage, buildUsageSurfaceLines } from './dimension-1-usage.js';
+export { checkDimensionFiles, executeFileCleanup } from './dimension-3-files.js';
+export { checkDimensionContext } from './dimension-4-context.js';
+export { renderDailyPush, renderAnomalyPush, shouldPushRealtimeAnomaly, pushTimeToCron, DEFAULT_PUSH_CONFIG, } from './daily-push.js';
+//# sourceMappingURL=index.js.map

package/dist/checkup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/checkup/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,sBAAsB;AAUtB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErF,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,cAAc,EACd,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/checkup/report.d.ts

@@ -0,0 +1,21 @@
+import type { LocalUsageStore } from '../usage-local/store.js';
+import type { ReconciliationEngine } from '../reconciliation/index.js';
+import type { CheckupReport } from './types.js';
+export interface CheckupDeps {
+    store: LocalUsageStore;
+    reconciliationEngine: ReconciliationEngine;
+    /** 是否为 Pro 用户 (锁标控制) */
+    is_pro: boolean;
+    /** 跳过 history 写入 (测试用) */
+    skip_persist?: boolean;
+}
+/**
+ * 主入口 — 跑一次全 5 维度体检 → CheckupReport
+ */
+export declare function runCheckup(deps: CheckupDeps): Promise<CheckupReport>;
+/**
+ * 主入口 UX 渲染 — 把 CheckupReport 渲染成 < 300 字的中文文本块
+ * (PRD §3.1 极简主入口)
+ */
+export declare function renderMainEntry(report: CheckupReport): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/checkup/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/checkup/report.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,YAAY,CAAC;AAWjE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,eAAe,CAAC;IACvB,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,wBAAwB;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAgE1E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAgD7D"}

package/dist/checkup/report.js

@@ -0,0 +1,133 @@
+// sdk/skillfm-local/src/checkup/report.ts
+//
+// CheckupReport 拼装 — 主入口数据源.
+// runCheckup() 跑全体 5 维度 + 算 score + 选 top focus + 持久化 history.
+import { checkDimensionUsage, buildUsageSurfaceLines } from './dimension-1-usage.js';
+import { checkDimensionFiles } from './dimension-3-files.js';
+import { checkDimensionContext } from './dimension-4-context.js';
+import { computeHealthScore, selectTopFocus, computeTrend, appendHealthSnapshot, } from './score.js';
+/**
+ * 主入口 — 跑一次全 5 维度体检 → CheckupReport
+ */
+export async function runCheckup(deps) {
+    const generated_at = new Date().toISOString();
+    // 维度 1: 用量 (含 reconciliation)
+    const reconciliations = await deps.reconciliationEngine.reconcileAll();
+    const usage = checkDimensionUsage({
+        store: deps.store,
+        reconciliations,
+    });
+    // 维度 3: 文件 (并行扫)
+    const files = await checkDimensionFiles();
+    // 维度 4: 上下文
+    const context = await checkDimensionContext();
+    // 维度 2: 技术债 (Pro 锁, MVP 不做)
+    const tech_debt = {
+        dimension: 'tech_debt',
+        severity: 'pro_locked',
+        headline: deps.is_pro ? '即将上线 (2.7.5)' : 'Pro 解锁',
+        findings: [],
+        pro_locked: !deps.is_pro,
+    };
+    // 维度 5: 记忆 (Pro 锁, MVP 不做)
+    const memory = {
+        dimension: 'memory',
+        severity: 'pro_locked',
+        headline: deps.is_pro ? '即将上线 (2.7.6)' : 'Pro 解锁',
+        findings: [],
+        pro_locked: !deps.is_pro,
+    };
+    const dimensions = [usage, files, context, tech_debt, memory];
+    const health_score = computeHealthScore(dimensions);
+    const health_trend = await computeTrend(health_score).catch(() => undefined);
+    const top_focus = selectTopFocus(dimensions);
+    const usage_summary_lines = buildUsageSurfaceLines(reconciliations);
+    const all_healthy = dimensions.every((d) => d.severity === 'healthy' || d.severity === 'pro_locked' || d.severity === 'no_data');
+    const report = {
+        generated_at,
+        health_score,
+        health_trend,
+        dimensions,
+        top_focus,
+        usage_summary_lines,
+        all_healthy,
+    };
+    // 持久化 health snapshot (用于下次 trend)
+    if (!deps.skip_persist) {
+        await appendHealthSnapshot({ timestamp: generated_at, health_score }).catch(() => {
+            // 写失败不阻塞 report
+        });
+    }
+    return report;
+}
+/**
+ * 主入口 UX 渲染 — 把 CheckupReport 渲染成 < 300 字的中文文本块
+ * (PRD §3.1 极简主入口)
+ */
+export function renderMainEntry(report) {
+    const lines = [];
+    const trendStr = report.health_trend != null
+        ? (report.health_trend > 0 ? ` (上次 ${report.health_score - report.health_trend}, ↑${report.health_trend})` : ` (上次 ${report.health_score - report.health_trend}, ↓${-report.health_trend})`)
+        : '';
+    const overall_emoji = report.health_score >= 90 ? '✨' : report.health_score >= 70 ? '✅' : report.health_score >= 50 ? '⚠️' : '🔴';
+    lines.push(`🧬 你家 AI · 健康度 ${report.health_score}/100 ${overall_emoji}${trendStr}`);
+    lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━');
+    lines.push('');
+    // 维度行
+    for (const dim of report.dimensions) {
+        const sevEmoji = severityEmoji(dim.severity);
+        const lockTag = dim.pro_locked ? '   [Pro 解锁]' : '';
+        const dimLabel = labelOf(dim.dimension);
+        lines.push(`${dimLabel}${sevEmoji} ${dim.headline}${lockTag}`);
+    }
+    // 用量子行 (对账 surface, 主入口灵魂位置)
+    if (report.usage_summary_lines.length > 0) {
+        lines.push('');
+        for (const sl of report.usage_summary_lines) {
+            lines.push(`   ${sl}`);
+        }
+    }
+    // Today's #1
+    lines.push('');
+    lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━');
+    if (report.all_healthy) {
+        lines.push(`✨ 今日: 你家 AI 高效如初. 保持!`);
+    }
+    else if (report.top_focus) {
+        lines.push(`今日 #1: ${report.top_focus.headline}`);
+        if (report.top_focus.fix_label) {
+            lines.push(`        ${report.top_focus.fix_label}`);
+        }
+    }
+    // Action buttons
+    lines.push('');
+    if (report.top_focus?.fix_free_allowed) {
+        lines.push('[🛠 修这一个] [📊 看全部] [⏰ 设每日] [✨ Pro]');
+    }
+    else {
+        lines.push('[📊 看全部] [⏰ 设每日] [✨ Pro 解锁自动 fix]');
+    }
+    return lines.join('\n');
+}
+function severityEmoji(s) {
+    switch (s) {
+        case 'critical': return ' 🔴';
+        case 'warning': return ' 🟠';
+        case 'info': return ' 🟡';
+        case 'healthy': return ' ✅';
+        case 'pro_locked': return '';
+        case 'no_data': return ' ❓';
+        default: return '';
+    }
+}
+function labelOf(dim) {
+    switch (dim) {
+        case 'usage': return '💰 用量    ';
+        case 'tech_debt': return '🐛 技术债   ';
+        case 'files': return '📦 文件    ';
+        case 'context': return '📁 上下文  ';
+        case 'memory': return '🧠 记忆    ';
+        default: return dim;
+    }
+}
+//# sourceMappingURL=report.js.map

package/dist/checkup/report.js.map

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

package/dist/checkup/score.d.ts

@@ -0,0 +1,27 @@
+import type { DimensionStatus, Finding, HealthSnapshot } from './types.js';
+/**
+ * 算总 score (基于所有 dimension 的 findings)
+ */
+export declare function computeHealthScore(dimensions: DimensionStatus[]): number;
+/**
+ * 选 "今日 #1" — 最该 surface 的 1 个 finding (PRD §3.2 治信息过载)
+ *
+ * 选择策略 (按优先级):
+ *   1. 最严重 critical (score_deduction 最高)
+ *   2. 如果有 fix_free_allowed=true 的 critical, 优先选可执行的 (用户能立刻动作)
+ *   3. 否则取所有 findings 中 score_deduction 最高的
+ */
+export declare function selectTopFocus(dimensions: DimensionStatus[]): Finding | null;
+/**
+ * 加载健康度历史 (用于 trend 计算)
+ */
+export declare function loadHealthHistory(filePath?: string): Promise<HealthSnapshot[]>;
+/**
+ * Append 一条健康度 snapshot
+ */
+export declare function appendHealthSnapshot(snap: HealthSnapshot, filePath?: string): Promise<void>;
+/**
+ * 算 trend (vs 上次 snapshot)
+ */
+export declare function computeTrend(currentScore: number, historyPath?: string): Promise<number | undefined>;
+//# sourceMappingURL=score.d.ts.map

package/dist/checkup/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../src/checkup/score.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAiB,eAAe,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI1F;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,MAAM,CASxE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,OAAO,GAAG,IAAI,CAwB5E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,GAAE,MAA4B,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAczG;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,cAAc,EACpB,QAAQ,GAAE,MAA4B,GACrC,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAK1G"}

package/dist/checkup/score.js

@@ -0,0 +1,101 @@
+// sdk/skillfm-local/src/checkup/score.ts
+//
+// 健康度公式 (PRD V1.3 §7, Eric 拍板):
+//   用量 40% / 上下文 25% / 文件 15% / 技术债 10% / 记忆 10%
+//
+// 算法: score = max(0, 100 - Σ (weight × dimension_deduction_normalized))
+// 但因 finding 有 score_deduction 真值, 简化为:
+//   score = max(0, 100 - Σ findings[].score_deduction)
+//
+// Free 用户: 上限 100 (Eric 决策 #6, 不区分不 cripple)
+// Pro 维度 (技术债/记忆) 在 Free 用户的 deduction = 0 (锁了不算分)
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+const HEALTH_HISTORY_PATH = path.join(homedir(), '.skillfm', 'health-history.jsonl');
+/**
+ * 算总 score (基于所有 dimension 的 findings)
+ */
+export function computeHealthScore(dimensions) {
+    let totalDeduction = 0;
+    for (const dim of dimensions) {
+        if (dim.pro_locked)
+            continue; // Free 用户 Pro 维度不算分
+        for (const finding of dim.findings) {
+            totalDeduction += finding.score_deduction;
+        }
+    }
+    return Math.max(0, Math.min(100, 100 - totalDeduction));
+}
+/**
+ * 选 "今日 #1" — 最该 surface 的 1 个 finding (PRD §3.2 治信息过载)
+ *
+ * 选择策略 (按优先级):
+ *   1. 最严重 critical (score_deduction 最高)
+ *   2. 如果有 fix_free_allowed=true 的 critical, 优先选可执行的 (用户能立刻动作)
+ *   3. 否则取所有 findings 中 score_deduction 最高的
+ */
+export function selectTopFocus(dimensions) {
+    const allFindings = [];
+    for (const dim of dimensions) {
+        if (dim.pro_locked)
+            continue;
+        allFindings.push(...dim.findings);
+    }
+    if (allFindings.length === 0)
+        return null;
+    // 优先 critical + fix_free_allowed
+    const critFreeFix = allFindings.filter((f) => f.severity === 'critical' && f.fix_free_allowed);
+    if (critFreeFix.length > 0) {
+        return critFreeFix.sort((a, b) => b.score_deduction - a.score_deduction)[0];
+    }
+    // 其次 critical
+    const crit = allFindings.filter((f) => f.severity === 'critical');
+    if (crit.length > 0) {
+        return crit.sort((a, b) => b.score_deduction - a.score_deduction)[0];
+    }
+    // 最后按 deduction 排序
+    return allFindings.sort((a, b) => b.score_deduction - a.score_deduction)[0];
+}
+/**
+ * 加载健康度历史 (用于 trend 计算)
+ */
+export async function loadHealthHistory(filePath = HEALTH_HISTORY_PATH) {
+    if (!fs.existsSync(filePath))
+        return [];
+    const text = await fs.promises.readFile(filePath, 'utf-8');
+    const out = [];
+    for (const line of text.split('\n')) {
+        const t = line.trim();
+        if (!t.startsWith('{'))
+            continue;
+        try {
+            out.push(JSON.parse(t));
+        }
+        catch {
+            // skip
+        }
+    }
+    return out.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+}
+/**
+ * Append 一条健康度 snapshot
+ */
+export async function appendHealthSnapshot(snap, filePath = HEALTH_HISTORY_PATH) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        await fs.promises.mkdir(dir, { recursive: true, mode: 0o700 });
+    }
+    await fs.promises.appendFile(filePath, JSON.stringify(snap) + '\n', { mode: 0o600 });
+}
+/**
+ * 算 trend (vs 上次 snapshot)
+ */
+export async function computeTrend(currentScore, historyPath) {
+    const history = await loadHealthHistory(historyPath);
+    if (history.length === 0)
+        return undefined;
+    const last = history[history.length - 1];
+    return currentScore - last.health_score;
+}
+//# sourceMappingURL=score.js.map

package/dist/checkup/score.js.map

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

package/dist/checkup/types.d.ts

@@ -0,0 +1,64 @@
+export type DimensionId = 'usage' | 'tech_debt' | 'files' | 'context' | 'memory';
+export type Severity = 'critical' | 'warning' | 'info' | 'healthy' | 'pro_locked' | 'no_data';
+/**
+ * 一个 deduction = 一项发现的问题 (用于 score 计算 + UX surface)
+ */
+export interface Finding {
+    /** 短描述 (主入口 surface 行用) */
+    headline: string;
+    /** 严重度 */
+    severity: Severity;
+    /** 扣分 (0-30) */
+    score_deduction: number;
+    /** 一键 fix 文案 (可选, 主入口 [修这一个] 时用) */
+    fix_label?: string;
+    /** 是否 Free 用户可执行 fix */
+    fix_free_allowed?: boolean;
+    /** 真省 (如果 fix 后, 估算月省 token / ¥) */
+    estimated_savings?: {
+        tokens?: number;
+        cny?: number;
+        description?: string;
+    };
+}
+/**
+ * 单个维度的体检结果
+ */
+export interface DimensionStatus {
+    dimension: DimensionId;
+    /** 维度总 severity (取 findings 中最高) */
+    severity: Severity;
+    /** 维度 1 行 headline (主入口 surface) */
+    headline: string;
+    /** 该维度所有 findings */
+    findings: Finding[];
+    /** Pro 锁标 */
+    pro_locked: boolean;
+}
+/**
+ * Checkup 完整报告 — 主入口数据源
+ */
+export interface CheckupReport {
+    generated_at: string;
+    /** 整体健康度 0-100 */
+    health_score: number;
+    /** vs 上次 score 的变化 (+/- 数, 用于 trend "↑ 28") */
+    health_trend?: number;
+    /** 5 维度状态 */
+    dimensions: DimensionStatus[];
+    /** "今日 #1" — 最该看的 1 件事 (treats 信息过载, PRD §3.2) */
+    top_focus: Finding | null;
+    /** 主入口的"💰 用量"那一行 (来自 reconciliation summary) */
+    usage_summary_lines: string[];
+    /** 是否所有维度都 healthy → fallback UX */
+    all_healthy: boolean;
+}
+/**
+ * 健康度历史 snapshot (持久化在 ~/.skillfm/health-history.jsonl)
+ * 用于 trend 计算 + Daily push 文案
+ */
+export interface HealthSnapshot {
+    timestamp: string;
+    health_score: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/checkup/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/checkup/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,WAAW,GACX,OAAO,GACP,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,SAAS,GACT,MAAM,GACN,SAAS,GACT,YAAY,GACZ,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU;IACV,QAAQ,EAAE,QAAQ,CAAC;IACnB,gBAAgB;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oCAAoC;IACpC,iBAAiB,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,WAAW,CAAC;IACvB,oCAAoC;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,aAAa;IACb,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,kDAAkD;IAClD,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,oCAAoC;IACpC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/checkup/types.js

@@ -0,0 +1,5 @@
+// sdk/skillfm-local/src/checkup/types.ts
+//
+// Checkup types — 5 维度 + 健康度 score (PRD V1.3 §3-§7).
+export {};
+//# sourceMappingURL=types.js.map

package/dist/checkup/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/checkup/types.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,qDAAqD"}

package/dist/connectors/anthropic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/connectors/anthropic.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuC1F,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,EAAE,EAAE,WAAW,CAAe;IAC9B,IAAI,SAAsB;IAC1B,OAAO,UAAQ;IAET,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkD7E,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CA8BlD"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/connectors/anthropic.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuC1F,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,EAAE,EAAE,WAAW,CAAe;IAC9B,IAAI,SAAsB;IAC1B,OAAO,UAAQ;IAET,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAqD7E,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CA8BlD"}

package/dist/connectors/anthropic.js

@@ -30,12 +30,15 @@ export class AnthropicConnector extends BaseConnector {
     name = 'Anthropic Claude';
     is_real = true;
     async fetchUsage(byok_key, opts) {
+        // group_by=model 必传 — 否则 result.model 返 null (Anthropic API doc 明确)
+        // 没 model 维度数据下游"模型细分省钱建议"无法生成
         const params = new URLSearchParams({
             starting_at: opts.start_date.toISOString(),
             ending_at: opts.end_date.toISOString(),
             bucket_width: '1d',
             limit: String(opts.limit ?? 100),
         });
+        params.append('group_by[]', 'model');
         let url = `${BASE_URL}/v1/organizations/usage_report/messages?${params}`;
         const records = [];
         while (url) {