main
基于 @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/:渲染与数据/导出冒烟脚本
/usage 用量面板(中文副本)
中文界面副本,源自 @tmustier/pi-usage-extension 0.10.2(上游 github.com/tmustier/pi-extensions 的 usage-extension/)。
本目录被 pi 自动发现(~/.pi/agent/extensions/*/package.json 的 pi.extensions 或 index.ts),命令仍是 /usage。
文件
| 文件 | 说明 |
|---|---|
index.ts data.ts graph.ts export.ts |
上游源码(仅改了文案与 3 处本地补丁) |
export.ts |
未汉化:CSV 表头保持英文(provider,model,cost_usd,...),避免下游表格/脚本失配 |
zh-map.mjs |
汉化词表:{文件: [[英文原文, 中文], ...]} |
apply-zh.mjs |
词表应用器 + 本地补丁(幂等,未命中即报错) |
package.json |
本副本清单,version: 0.10.2-zh.1 |
scripts/usage-render-smoke.mjs |
渲染冒烟:三视图按指定宽度渲染为纯文本,报超宽行 |
scripts/usage-data-smoke.mjs |
数据/导出冒烟:采集 + 洞察文案 + CSV/JSON 片段 |
汉化覆盖
- 视图名 / 周期 Tab / 表头 / 合计行 / 底部快捷键提示 / 加载进度 / 导出回执
- 图表模式行、指标名、分组名、图例
合计与其他 (N) - 洞察页全部文案(标题、副标题、分组标题、6 类告警 + 5 类结构结论含 advice)
- 辅助用量伪渠道
工具 / 摘要(旧版为Tools / summaries)
保持英文:CSV 表头、JSON 键名(period/totals/insights…)、导出文件名(usage-graph-allTime-…csv)、模型名与思考等级等数据值。
本地补丁(与语言无关的宽度/排版修正)
- 图表 x 轴日期改 ASCII
M/D:renderChart用字符串长度算轴位,toLocaleDateString在 zh-CN 下返回8月14日(宽度 = 长度×2),会把末尾标签挤出并截断。 - 洞察分组横线长度改用
visibleWidth(label)而不是label.length,否则中文标签会让横线超出宽度、被截成…。 - 告警标题里的
(本期 x%)前不再补空格(英文(12% of this period)需要空格,中文不需要)。
数据层改动
AUXILIARY_PROVIDER/AUXILIARY_MODEL 改为中文并 bump CACHE_VERSION 6 → 7:这些名字会被 intern 进 ~/.pi/agent/usage-extension-cache.json,不 bump 会出现中英混排。代价是首次 /usage 走一次"重建"(本机 312 个会话约 2s)。
升级上游
SRC=~/.pi/agent/npm/node_modules/@tmustier/pi-usage-extension
cp $SRC/{index.ts,data.ts,graph.ts,export.ts} ~/.pi/agent/extensions/usage-zh/
cd ~/.pi/agent/extensions/usage-zh && node apply-zh.mjs # 报 MISS 即上游改了文案
node scripts/usage-render-smoke.mjs --width 80 # 渲染冒烟
node scripts/usage-data-smoke.mjs # 数据/导出冒烟
冒烟脚本默认以仓库根为扩展目录,可用 --dir 指到别处;PI_DIST / JITI 环境变量可覆盖依赖路径。
MISS 条目按 zh-map.mjs 的英文原文更新后重跑;新增界面文案需自行补条目。
注意
- 仓库:
ssh://git@git.cat-shark.xyz:2222/cat-shark/usage-zh.git;本目录即工作副本,origin/main - 不要把
npm:@tmustier/pi-usage-extension再加回settings.json:两个扩展都会注册/usage,命令重复。同理也不要用pi install再装本仓库的 git 包 - 上游 npm 版仍留在
~/.pi/agent/npm/node_modules/,用作 diff/升级参照,不影响加载 - 改完后:
node apply-zh.mjs→ 冒烟通过 →/reload生效 → commit/push
Languages
TypeScript
83.3%
JavaScript
16.7%