基于 @tmustier/pi-usage-extension 0.10.2(github.com/tmustier/pi-extensions 的 usage-extension/),仅改文案与 3 处中文宽度/排版补丁。 - zh-map.mjs:100 条词表(103 处替换),覆盖视图/周期/表头/快捷键/加载/洞察全部文案 - apply-zh.mjs:幂等应用器,上游改文案时报 MISS 而非静默漏译 - 本地补丁:x 轴日期改 ASCII M/D、分组横线用 visibleWidth、中文括号前不补空格 - 数据层:辅助用量伪渠道改 工具/摘要,CACHE_VERSION 6→7(名字会 intern 进缓存) - 保持英文:CSV 表头、JSON 键名、导出文件名,避免下游表格/脚本失配 - scripts/:渲染与数据/导出冒烟脚本
147 lines
4.5 KiB
TypeScript
147 lines
4.5 KiB
TypeScript
/**
|
|
* Pure builders for /usage export ([e] key).
|
|
*
|
|
* Each view exports its current slice: the table as per-model CSV rows, the
|
|
* graph as one CSV column per visible series, and insights as structured JSON.
|
|
* Builders are pure string producers so they stay trivially testable; the
|
|
* component owns file naming and disk writes.
|
|
*/
|
|
|
|
import { join } from "node:path";
|
|
import type { Insight, ProviderStats, TotalStats } from "./data.ts";
|
|
import type { GraphModel } from "./graph.ts";
|
|
|
|
/**
|
|
* Read the configured export directory from settings.json content, if any.
|
|
* Config shape: `{ "usage-extension": { "exportDir": "~/Downloads" } }`.
|
|
*/
|
|
export function parseExportDirSetting(settingsJson: string): string | null {
|
|
try {
|
|
const parsed = JSON.parse(settingsJson) as { "usage-extension"?: { exportDir?: unknown } };
|
|
const dir = parsed["usage-extension"]?.exportDir;
|
|
return typeof dir === "string" && dir.trim() !== "" ? dir.trim() : null;
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Pick the export directory. A configured dir wins (with `~` expanded);
|
|
* otherwise exports go to /tmp so they never litter a repo or home
|
|
* directory, falling back to the OS temp dir where /tmp doesn't exist.
|
|
*/
|
|
export function resolveExportDir(
|
|
configured: string | null,
|
|
home: string,
|
|
slashTmpExists: boolean,
|
|
fallbackTmp: string,
|
|
): string {
|
|
if (configured !== null) {
|
|
if (configured === "~") return home;
|
|
if (configured.startsWith("~/")) return join(home, configured.slice(2));
|
|
return configured;
|
|
}
|
|
return slashTmpExists ? "/tmp" : fallbackTmp;
|
|
}
|
|
|
|
/** Quote a CSV field only when it needs it (comma, quote, or newline). */
|
|
function csvField(value: string | number): string {
|
|
const s = String(value);
|
|
return /[",\n]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
|
|
}
|
|
|
|
function csvLine(fields: (string | number)[]): string {
|
|
return fields.map(csvField).join(",");
|
|
}
|
|
|
|
/** Per-model rows (provider repeated), then a TOTAL row. */
|
|
export function buildTableCsv(providers: ReadonlyMap<string, ProviderStats>, totals: TotalStats): string {
|
|
const lines = [
|
|
csvLine([
|
|
"provider",
|
|
"model",
|
|
"sessions",
|
|
"messages",
|
|
"cost_usd",
|
|
"fresh_tokens",
|
|
"input_tokens",
|
|
"output_tokens",
|
|
"cache_read_tokens",
|
|
"cache_write_tokens",
|
|
]),
|
|
];
|
|
const sorted = Array.from(providers.entries()).sort((a, b) => b[1].cost - a[1].cost);
|
|
for (const [providerName, provider] of sorted) {
|
|
const models = Array.from(provider.models.entries()).sort((a, b) => b[1].cost - a[1].cost);
|
|
for (const [modelName, model] of models) {
|
|
lines.push(
|
|
csvLine([
|
|
providerName,
|
|
modelName,
|
|
model.sessions.size,
|
|
model.messages,
|
|
model.cost,
|
|
model.tokens.total,
|
|
model.tokens.input,
|
|
model.tokens.output,
|
|
model.tokens.cacheRead,
|
|
model.tokens.cacheWrite,
|
|
])
|
|
);
|
|
}
|
|
}
|
|
lines.push(
|
|
csvLine([
|
|
"TOTAL",
|
|
"",
|
|
totals.sessions,
|
|
totals.messages,
|
|
totals.cost,
|
|
totals.tokens.total,
|
|
totals.tokens.input,
|
|
totals.tokens.output,
|
|
totals.tokens.cacheRead,
|
|
totals.tokens.cacheWrite,
|
|
])
|
|
);
|
|
return lines.join("\n") + "\n";
|
|
}
|
|
|
|
/**
|
|
* One row per time bucket, one column per visible series, values exactly as
|
|
* plotted (per-bucket or cumulative, current metric).
|
|
*/
|
|
export function buildGraphCsv(model: GraphModel): string {
|
|
const visible = model.series.filter((s) => !s.hidden);
|
|
const lines = [csvLine(["bucket_start", ...visible.map((s) => s.label)])];
|
|
for (let i = 0; i < model.bucketStarts.length; i++) {
|
|
lines.push(csvLine([new Date(model.bucketStarts[i]!).toISOString(), ...visible.map((s) => s.points[i] ?? 0)]));
|
|
}
|
|
return lines.join("\n") + "\n";
|
|
}
|
|
|
|
/** Structured JSON of the period's insights plus headline totals. */
|
|
export function buildInsightsJson(period: string, totals: TotalStats, insights: Insight[]): string {
|
|
return (
|
|
JSON.stringify(
|
|
{
|
|
period,
|
|
generatedAt: new Date().toISOString(),
|
|
totals: { costUsd: totals.cost, messages: totals.messages, sessions: totals.sessions },
|
|
insights: insights.map((i) => ({ kind: i.kind, stat: i.stat, headline: i.headline, advice: i.advice })),
|
|
},
|
|
null,
|
|
"\t"
|
|
) + "\n"
|
|
);
|
|
}
|
|
|
|
/** usage-<view>-<period>[-<slice>]-<stamp>.<ext> in the current directory. */
|
|
export function exportFileName(view: string, period: string, slice: string | null, ext: string, now: Date): string {
|
|
const pad = (n: number) => String(n).padStart(2, "0");
|
|
const stamp =
|
|
`${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}` +
|
|
`-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
|
|
return ["usage", view, period, ...(slice ? [slice] : []), stamp].join("-") + `.${ext}`;
|
|
}
|