Files
cat-shark 50740b4d08 feat: /usage 用量面板中文化(上游 0.10.2)
基于 @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/:渲染与数据/导出冒烟脚本
2026-11-18 14:46:30 +08:00

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}`;
}