dsh-cost-meter 1.8.13 → 1.8.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -8,12 +8,14 @@
8
8
 
9
9
  Per-conversation cost · daily totals · OpenCode Go subscription quota display · budget with usage percentage · official account balance · custom provider balance · balance progress bar · history · peak/off-peak pricing hours display (peak hours UTC 01:00–04:00, 06:00–10:00; weekends and Chinese public holidays are off-peak all day, with separate labels) · pre-switch popup & system-notification alerts for peak/off-peak changes (position / lead time / alert type configurable) · one-click price sync from the official docs · Codex-style token usage heat grid · multi-vendor model pricing (built-in 170+ model-ID catalog with auto-matching) · mainstream Coding Plan quota queries & display (Anthropic / Z.ai / MiniMax / Kimi / OpenRouter / SiliconFlow / CommandCode / SCNet / Volcano Ark / Qwen / Xiaomi MiMo) plan/API dual-track billing (subscription quota vs pay-as-you-go money separated, per-1% & full-window token/equivalent-cost estimates with daily/weekly/monthly curves) · · quota strip above the input box (budget / Go / coding-plan usage in one row, toggleable)
10
10
 
11
- [![version](https://img.shields.io/badge/version-1.8.13-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
11
+ [![version](https://img.shields.io/badge/version-1.8.15-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
12
12
 
13
- **v1.8.13** adds an optional amount-only conversation cost line below the composer. Enable it in **Settings → Cost → Display**; hover to see cache hit rate, token counts and model amounts. See the [release notes](docs/release-notes/v1.8.13.md).
13
+ **v1.8.15** keeps conversation Cost details below the Desktop title bar and inside narrow windows. Automatic refresh preserves existing content and expanded turns while fetching new usage. See the [release notes](docs/release-notes/v1.8.15.md).
14
14
 
15
15
  Desktop users: follow the [Desktop installation instructions](docs/install-troubleshooting.md#desktop-安装与更新) for the application's own CLI and `desktop` Profile.
16
16
 
17
+ If startup reports **Ledger is busy** and the cost widgets are missing, see [ledger lock recovery](docs/ledger-lock-recovery.md#english).
18
+
17
19
  [![npm](https://img.shields.io/npm/v/dsh-cost-meter?label=npm)](https://www.npmjs.com/package/dsh-cost-meter)
18
20
  [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
19
21
  [![dsh](https://img.shields.io/badge/DeepSeek%20Harness-dsh--plugin-4176E6)](https://github.com/deepseek-ai/deepseek-harness)
@@ -320,22 +322,22 @@ On Node.js 20, use `npm install -g pnpm@10` instead. See [pnpm installation and
320
322
  dsh plugin --profile web add dsh-cost-meter
321
323
  ```
322
324
 
323
- **PowerShell one-click script** (copy the whole line, paste, press Enter; pnpm is provisioned automatically, git is auto-detected — no clone needed; the install chain is **pinned to the release tag `v1.8.13`** — review the script before running):
325
+ **PowerShell one-click script** (copy the whole line, paste, press Enter; pnpm is provisioned automatically, git is auto-detected — no clone needed; the install chain is **pinned to the release tag `v1.8.15`** — review the script before running):
324
326
 
325
327
  ```powershell
326
- irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.8.13/install.ps1 | iex
328
+ irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.8.15/install.ps1 | iex
327
329
  ```
328
330
 
329
331
  **Or a plain command line** (the machine must already have pnpm and git; also pinned to the tag):
330
332
 
331
333
  ```sh
332
- dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.8.13
334
+ dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.8.15
333
335
  ```
334
336
 
335
337
  Without git, use the GitHub tag archive:
336
338
 
337
339
  ```sh
338
- dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.8.13.tar.gz
340
+ dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.8.15.tar.gz
339
341
  ```
340
342
 
341
343
  After installing, **restart** `dsh web` (plugin rows, the Typert manifest and the client bundle are all scanned at startup):
package/README.zh-CN.md CHANGED
@@ -8,12 +8,14 @@
8
8
 
9
9
  本会话费用 · 当日费用 · OpenCode Go 订阅额度显示 · 预算与已用百分比 · 官方账户余额 · 自定义 Provider 余额查询(可配任意 HTTP 端点) · 余额三段进度条 · 历史记录 · 峰谷计价时段显示(UTC 01:00–04:00、06:00–10:00 为峰时段;周末与中国法定假日全天按谷价,分别标注) · 峰/谷切换前弹窗与系统通知提醒(位置/提前量/提醒类型可配) · 官方价格一键同步 · 类 Codex Token 用量热图 · 多厂商多模型价格计费(内置 170+ 模型 ID 价格目录与自动匹配) · 主流 Coding Plan 额度查询与显示(Anthropic / Z.ai / MiniMax / Kimi / OpenRouter / SiliconFlow / CommandCode / SCNet / 火山方舟 / 千问 / 小米 MiMo 十一家,含 Volcano Ark AK/SK 签名与 MiMo 控制台 Cookie 查询) · Plan/API 双轨计费(订阅额度与按量金额分离统计,每 1% 额度与满窗的 token/等值金额估算及日/周/月曲线) · 输入框上方额度横条(预算/Go/Coding Plan 用量一条横排显示,可开关)
10
10
 
11
- [![version](https://img.shields.io/badge/version-1.8.13-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
11
+ [![version](https://img.shields.io/badge/version-1.8.15-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
12
12
 
13
- **v1.8.13** 增加输入区下方会话费用只显示金额的开关。在**设置 → 费用 → 显示**中启用,悬停仍可查看缓存命中率、Token 数量和模型费用。详见[更新说明](docs/release-notes/v1.8.13.md)。
13
+ **v1.8.15** 修复费用明细弹窗遮挡桌面端标题栏及窄窗口横向溢出;自动刷新时保留已有内容和展开的轮次,并同步新用量。详见[更新说明](docs/release-notes/v1.8.15.md)。
14
14
 
15
15
  桌面端用户请按 [Desktop 安装说明](docs/install-troubleshooting.md#desktop-安装与更新),使用应用自带的 CLI 和 `desktop` Profile。
16
16
 
17
+ 启动报 **Ledger is busy** 且费用卡片消失时,参见[账本锁恢复说明](docs/ledger-lock-recovery.md#简体中文)。
18
+
17
19
  [![npm](https://img.shields.io/npm/v/dsh-cost-meter?label=npm)](https://www.npmjs.com/package/dsh-cost-meter)
18
20
  [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
19
21
  [![dsh](https://img.shields.io/badge/DeepSeek%20Harness-dsh--plugin-4176E6)](https://github.com/deepseek-ai/deepseek-harness)
@@ -320,22 +322,22 @@ Node.js 20 请改用 `npm install -g pnpm@10`。版本要求见 [pnpm 官方安
320
322
  dsh plugin --profile web add dsh-cost-meter
321
323
  ```
322
324
 
323
- **PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.8.13`**,建议先下载审阅再运行):
325
+ **PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.8.15`**,建议先下载审阅再运行):
324
326
 
325
327
  ```powershell
326
- irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.8.13/install.ps1 | iex
328
+ irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.8.15/install.ps1 | iex
327
329
  ```
328
330
 
329
331
  **或直接命令行**(机器上需已有 pnpm 与 git;同样固定到 tag):
330
332
 
331
333
  ```sh
332
- dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.8.13
334
+ dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.8.15
333
335
  ```
334
336
 
335
337
  没有 git 时可用 GitHub tag 打包直链:
336
338
 
337
339
  ```sh
338
- dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.8.13.tar.gz
340
+ dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.8.15.tar.gz
339
341
  ```
340
342
 
341
343
  安装后**重启** `dsh web`(插件行、Typert 清单与客户端 bundle 均在启动时扫描):
@@ -14,6 +14,8 @@ Open a conversation and click **Cost details** in the same row as turns, speed,
14
14
  - **Turn inspection:** Expand a turn to load its original user inputs, then expand each tool to see arguments, result and completion/error status. Tool records paginate 20 at a time; each long text field shows up to 16,000 characters with an explicit notice. Attachments show their type; system prompts, request headers and binary data are excluded. This is the whole turn, independent of the billing filters. Opening the overview does not load these contents.
15
15
  - **Appearance:** Native DSH theme tokens, neutral surfaces, light borders, compact segmented controls and collapsible explanations replace the earlier colored dashboard cards. Light/dark themes and narrow windows share the same layout rules.
16
16
 
17
+ From **1.8.15**, the conversation dialog centers within the area below the Desktop title bar, including older Windows hosts and macOS clearance. Fullscreen and Web use the full viewport; narrow windows include padding in the width limit and scroll long content inside the dialog. Client hot reload replaces outdated styles. Automatic refresh keeps existing results and expanded turns, updates both overview and detail when usage or pricing changes, and displays background errors without clearing previous values.
18
+
17
19
  ### What the numbers mean
18
20
 
19
21
  Overview amounts come from the retained DSH ledger and refresh records written by other host processes. Opening statistics does not reprice history. Rankings combine days into one row per conversation. With subagent costs enabled, each agent is grouped under its owning conversation so the ranking matches its detail. Otherwise sessions stay separate. Each cost is counted once. Historical amounts without a known model or conversation are explicitly listed as unassigned costs.
@@ -46,6 +48,8 @@ The statistics screen uses DSH's package-local asynchronous module loader. Since
46
48
  - **展开轮次:**点击一轮才读取其用户输入和工具调用,继续展开工具可查看参数、结果、完成或失败状态。工具每页 20 条,单段文本最多显示 16,000 个字符并标明截断;附件只显示类型,不读取系统提示、请求头或二进制内容。这里显示整轮原始记录,不受计费筛选影响。打开统计首页不会加载这些正文。
47
49
  - **界面:**使用 DSH 的主题颜色、轻边框、紧凑分段按钮和可折叠说明,替换原来的彩色顶部卡片;支持浅色、深色和窄窗口。
48
50
 
51
+ 从 **1.8.15** 起,单对话弹窗在桌面标题栏下方的区域居中,兼容旧版 Windows 和 macOS 顶部空间;全屏与 Web 使用完整视口。窄窗口的宽度限制包含内边距,长内容在弹窗内滚动,热更新会替换陈旧样式。自动刷新保留已有结果和展开轮次,用量或计费配置变化后同时更新概览和明细,后台失败显示错误并保留旧值。
52
+
49
53
  ### 统计口径
50
54
 
51
55
  汇总读取 DSH 账本,打开页面会同步其他进程已写入的记录,不重新定价或修改历史金额。全局日、周及全部统计中,跨天对话合并成一行,开启子代理费用合计时,排行把子代理及其后代归入所属主会话,点击后的明细与排行金额一致;关闭时各会话分别列出。每笔费用只计一次。历史中未归属模型或对话的金额会单独提示。从 1.8.10 起,账本保留全部对话记录,不再按每日 200 个裁剪。若已记录的全部 Token 与调用次数完整覆盖一个日期,旧日总额会按这些对话已记录的金额修复;匿名调用和旧版裁剪留下的金额保留。此修复不重新定价。
@@ -0,0 +1,45 @@
1
+ # Ledger lock recovery / 账本锁恢复
2
+
3
+ ## English
4
+
5
+ Issue [#237](https://github.com/Han-1413141/dsh-cost-meter/issues/237) reports a startup failure with **Ledger is busy; preserving pending changes for retry**. The sidebar balance and quota widgets disappear because the cost-meter loader entry did not activate. An old lock can name a PID that now belongs to a different process; checking only whether that PID exists cannot identify the original owner.
6
+
7
+ ### Update and recover
8
+
9
+ 1. Update `dsh-cost-meter` in the affected Profile. Web users can run `dsh plugin --profile web add dsh-cost-meter`. Desktop users must use the application's own CLI and the `desktop` Profile; see the [Desktop guide](install-troubleshooting.md#desktop-安装与更新).
10
+ 2. Restart that DSH host. For Desktop, fully exit the application including its tray process, then reopen it. The upgraded plugin recovers a proven stale lock before loading its ledger.
11
+ 3. Confirm that the host logs contain `[dsh-cost-meter] 已加载` and that the Cost page and sidebar widgets return. Existing ledger amounts and history remain intact; this recovery does not reprice usage.
12
+
13
+ A previously failed loader entry is not necessarily retried when an unrelated configuration file changes. Restarting the affected host applies the installed fix; adding a dummy `balance.refreshMinutes` override is unnecessary. This plugin does not change DSH's loader/HMR retry policy.
14
+
15
+ ### What changes
16
+
17
+ - Owner filenames retain their original `PID-UUID` format. The owner file now records process identity: Linux uses the boot ID, PID namespace and process start ticks; Windows uses the native process creation time.
18
+ - A lock is recovered when its process has exited, or when a comparable native identity confirms PID reuse. Linux locks with identity records from another host or PID namespace are not treated as local owners.
19
+ - Earlier versions wrote empty owner files. These are recovered only when the file predates the identified process's start, with a two-second margin for timestamp precision. The current process also has an uptime-based fallback. A lock is not expired just because it is old.
20
+ - Unknown ownership, inaccessible process information and incomplete owner writes remain locked. A genuine competing writer retains its lock. Only the identified owner file and empty lock directory are removed; the ledger is preserved.
21
+
22
+ If a genuine writer still holds the lock, let its operation finish and restart the failed host entry. For persistent failures, attach the plugin and DSH versions, other installed plugins, the sanitized startup error, and lock directory filenames/timestamps. Do not include the ledger contents or credentials. Do not delete `ledger.json` to restore the widgets.
23
+
24
+ Implementation references: [Linux process start ticks](https://man7.org/linux/man-pages/man5/proc_pid_stat.5.html), [Windows process StartTime](https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.process.starttime).
25
+
26
+ ## 简体中文
27
+
28
+ Issue [#237](https://github.com/Han-1413141/dsh-cost-meter/issues/237) 报告启动时出现 **Ledger is busy; preserving pending changes for retry**。费用插件未成功挂载,侧栏余额和额度卡片随之消失。旧锁中的 PID 可能已经被系统分配给另一个进程,仅检查 PID 是否存在不能确认原锁持有者。
29
+
30
+ ### 升级与恢复
31
+
32
+ 1. 更新受影响 Profile 中的 `dsh-cost-meter`。Web 用户可执行 `dsh plugin --profile web add dsh-cost-meter`。桌面端使用应用自带 CLI 和 `desktop` Profile,见 [Desktop 安装说明](install-troubleshooting.md#desktop-安装与更新)。
33
+ 2. 重启该 DSH 宿主。桌面端完全退出应用(包括托盘)后重新打开。新版插件会在读取账本前回收已确认失效的锁。
34
+ 3. 确认日志出现 `[dsh-cost-meter] 已加载`,费用页和侧栏卡片恢复。已有金额和历史记录保留,此过程不重新定价。
35
+
36
+ 已经失败的加载器条目不一定会因无关配置文件变化而重试。重启受影响宿主即可加载已安装修复,无需添加临时 `balance.refreshMinutes` 配置。本插件不修改 DSH 加载器的热重载重试策略。
37
+
38
+ ### 修复规则
39
+
40
+ - 锁文件名继续使用原有 `PID-UUID` 格式,文件内容增加进程身份。Linux 保存系统启动 ID、PID 命名空间和进程启动计数;Windows 保存操作系统提供的进程创建时间。
41
+ - 进程已经退出,或原生启动身份能确认 PID 被复用时,回收旧锁。对于有身份记录的 Linux 锁,不会把其他主机或 PID 命名空间中的持有者误当成本机进程。
42
+ - 兼容旧版空锁文件。只有文件早于对应进程启动时间,并留出两秒精度余量时,才认定失效;当前进程还可用运行时长推算启动时间。锁的存放时间长短不是独立回收依据。
43
+ - 身份不明、进程信息不可读取或文件未写完整时,保留锁。真实并发写入者继续持锁。恢复只删除已确认的锁持有者文件和空锁目录,保留账本。
44
+
45
+ 如果是真实写入进程占锁,等待其操作结束后重启加载失败的宿主。持续失败时,请附插件和 DSH 版本、其他已安装插件、脱敏启动错误,以及锁目录中文件的名称和时间。不要附账本内容或凭据,也不要通过删除 `ledger.json` 恢复卡片。