useful-pi-extensions 1.4.0 → 1.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "useful-pi-extensions",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "A small collection of pi extensions, installed with one command — a labelled status line with context pressure, cache, cost, effort, TTFT and tokens/sec.",
   "keywords": [
     "bun",

package/packages/statusline/README.md

@@ -53,29 +53,34 @@ Configuration lives at the top of [`render.ts`](render.ts):
 ## Currency
 
 pi prices every model in USD and its `cost` field carries no unit at all, so the footer cannot know
-what you were actually billed. What a session cost in RMB is set by whoever sold you the credit, not
-by a market feed, which is why the rate is configured rather than fetched.
-
-Create `~/.pi/agent/statusline.json`:
+what you were actually billed. The currency and the rate live in `~/.pi/agent/statusline.json`:
 
 ```json
 {
   "currency": {
-    "code": "CNY",
-    "perUsd": 7.12
+    "code": "CNY"
   }
 }
 ```
 
-- `code` picks the symbol (`CNY` and `RMB` give `¥`; the table also knows `USD`, `EUR`, `GBP`, `JPY`,
-  `HKD`, `TWD`, `SGD`, `KRW` and `INR`). A code the table does not know is printed as it is.
-- `symbol` overrides the table, for a currency it does not list or a different separator.
-- `perUsd` is how many units of that currency one dollar buys — the rate you were actually charged.
-  It has to be a positive number; anything else is refused and the footer stays in USD.
+Two ways to set the rate:
+
+- **Follow the market.** A `code` with no rate fetches the day's table from open.er-api.com on the
+  first session of each day and caches the whole table in the file (`rates` + `fetchedAt`), so the
+  next session starts warm and switching codes is instant and offline.
+- **Pin it.** Add `"perUsd": 7.12` and the footer always uses that rate, never touching the network
+  — the right choice when your platform bills in RMB directly, because a domestic price list is not
+  the dollar list times a market rate.
+
+`code` picks the symbol: `¥` for `CNY` and `RMB`, `JP¥` for `JPY` so the two never trade places, and
+the table also knows `USD`, `EUR`, `GBP`, `HKD`, `TWD`, `SGD`, `KRW`, `INR`, `AUD`, `CAD`, `NZD` and
+`CHF`; an unknown code is printed as it is. `symbol` overrides all of that.
 
-With the file above, the same session reads `Cost ¥1.63` instead of `Cost $0.229`. The file is read
-once per session, so edit it and `/reload`. A file that is there but unusable says so in a
-notification, rather than silently showing dollars with nothing to explain why.
+Switching is editing `code`, or `make currency CODE=JPY` from a checkout. The file is read once per
+session, so finish with `/reload`. A file that is there but unusable says so in a notification,
+rather than silently showing dollars with nothing to explain why.
+
+## Metrics
 
 ## Metrics
 

package/packages/statusline/README_CN.md

@@ -51,27 +51,31 @@ LSP Active: typescript
 ## 币种
 
 pi 里所有模型价格都是美元，而且它的 `cost` 字段**不带任何单位**，所以 footer 无从知道你实际是按什么币种付的。
-这次会话折合多少人民币，取决于卖你额度那家给的汇率，而不是市场汇率——所以汇率是**配置**出来的，不是联网抓的。
-
-创建 `~/.pi/agent/statusline.json`：
+币种与汇率放在 `~/.pi/agent/statusline.json`：
 
 ```json
 {
   "currency": {
-    "code": "CNY",
-    "perUsd": 7.12
+    "code": "CNY"
   }
 }
 ```
 
-- `code` 决定符号（`CNY` 与 `RMB` 得到 `¥`；符号表还认 `USD`、`EUR`、`GBP`、`JPY`、`HKD`、`TWD`、
-  `SGD`、`KRW`、`INR`）。表里没有的代码就原样打印。
-- `symbol` 可覆盖符号表，用于表里没列的币种，或想换分隔方式。
-- `perUsd` 是一美元等于多少该币种，也就是**你实际被收的汇率**。必须是正数；
-  否则整块被拒绝，footer 继续显示美元。
+汇率有两种设法：
+
+- **跟随市场。** 只写 `code` 不写汇率时，每天第一个会话会从 open.er-api.com 拉取当日汇率表，
+  并把整张表缓存进文件（`rates` + `fetchedAt`），下个会话热启动；切换币种即时生效、离线也能切。
+- **钉死。** 加上 `"perUsd": 7.12`，footer 永远用这个汇率、绝不联网——如果你的平台直接按人民币计费，
+  这是正确选择：国内价目表不是美元价目表乘以市场汇率。
+
+`code` 决定符号：`CNY` 和 `RMB` 得到 `¥`，`JPY` 得到 `JP¥`（两者永不混用），符号表还认 `USD`、
+`EUR`、`GBP`、`HKD`、`TWD`、`SGD`、`KRW`、`INR`、`AUD`、`CAD`、`NZD`、`CHF`；表里没有的代码原样打印。
+`symbol` 可覆盖这一切。
 
-配置成上面这样，同一个会话就从 `Cost $0.229` 变成 `Cost ¥1.63`。该文件每个会话只读一次，
-改完需 `/reload`。文件存在但不可用时会给出通知，而不是静默继续显示美元。
+切换就是改 `code`，或者在检出里执行 `make currency CODE=JPY`。该文件每个会话只读一次，改完需 `/reload`。
+文件存在但不可用时会给出通知，而不是静默继续显示美元。
+
+## 指标口径
 
 ## 指标口径
 

package/packages/statusline/extensions/statusline/render.ts

@@ -143,13 +143,18 @@ export const USD: Currency = { symbol: '$', perUsd: 1 }
 
 /** Currencies the config can name by `code` alone. Anything else needs an explicit `symbol`. */
 const CURRENCY_SYMBOLS: Record<string, string> = {
+  AUD: 'A$',
+  CAD: 'CA$',
+  CHF: 'CHF',
   CNY: '¥',
   EUR: '€',
   GBP: '£',
   HKD: 'HK$',
   INR: '₹',
-  JPY: '¥',
+  // ¥ is CNY's by default; JPY wears the prefixed form so the two never trade places.
+  JPY: 'JP¥',
   KRW: '₩',
+  NZD: 'NZ$',
   RMB: '¥',
   SGD: 'S$',
   TWD: 'NT$',