dsh-usage-state 0.4.3 → 0.4.5
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/CHANGELOG.md +118 -0
- package/README.en.md +61 -118
- package/README.md +58 -147
- package/docs/adapters.md +49 -80
- package/lib/client.js +190 -59
- package/lib/index.js +279 -167
- package/lib/typert.js +1 -0
- package/package.json +17 -7
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
# 更新日志（Changelog）
|
|
2
|
+
|
|
3
|
+
用户可见的变更按版本记录于此。设计取舍见 [设计修订](https://github.com/takboo/dsh-usage-state/blob/main/docs/design-changelog.md)，发布验证流程见 [发布与验收](https://github.com/takboo/dsh-usage-state/blob/main/docs/release.md)。
|
|
4
|
+
|
|
5
|
+
格式参照 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循语义化版本。0.3.0起发布npm，之前仅GitHub分发。已发布日期按 [npm registry](https://registry.npmjs.org/dsh-usage-state) 的UTC记录；历史比较引用说明见文末。
|
|
6
|
+
|
|
7
|
+
## [Unreleased]
|
|
8
|
+
|
|
9
|
+
## [0.4.5] - 2026-10-10
|
|
10
|
+
|
|
11
|
+
### Fixed
|
|
12
|
+
|
|
13
|
+
- provider级凭据覆盖贯通读取、描述和保存；显式provider端点/ref优先于legacy source默认，固定端点不尝试镜像。
|
|
14
|
+
- Moonshot余额按官方人民币元解析；DeepSeek跳过非法金额，无有效读数时报parse并保留同身份旧成功值；响应体超时/中断归network。
|
|
15
|
+
- 宿主按有效目标签名、私有凭据摘要和generation隔离缓存/在途；拒绝配置切换、ABA、晚lookup和晚HTTP的旧结果，目标移除及stop不再触发后续查询。已解析密钥的原文回显在快照错误边界精确替换。
|
|
16
|
+
- legacy models仅通过normalize迁移，权威空provider目录停止轮询；普通getState只初始化缺失/变更身份，浏览器30s轮询不缩短5min宿主idle，间隔修改会重调timer。
|
|
17
|
+
- origin-only endpointHints传到设置页和状态行；默认provider按可见顺序排序；旧值tooltip含原因，RPC断线标年龄/陈旧。客户端配置身份失效后拒绝旧RPC，普通请求中的显式刷新排一次，已有force则共享。
|
|
18
|
+
- 配置写入false/rejection、凭据保存/清除失败与pending均有反馈；配置只读和凭据权限分开，未编辑输入框失焦不写回旧草稿。
|
|
19
|
+
|
|
20
|
+
### Engineering
|
|
21
|
+
|
|
22
|
+
- 新增标准Ubuntu CI、Dependabot和默认verify的手动Release；action固定完整SHA，npm OIDC与GitHub附档分离权限，复用同一已验证tarball和checksum。
|
|
23
|
+
- 修复Release在job级env使用runner.temp导致整份工作流无法解析的问题，tarball路径改在runner步骤中设置；CI新增固定版本/checksum的actionlint检查表达式上下文。
|
|
24
|
+
- Dependabot保留React18与TypeScript JavaScript编译API兼容线，忽略这些依赖的自动major更新；纳入tsdown0.23.0、unrun0.3.1和Zod4.6.5。Zod测试验证固定v4依赖及真实codec行为，不再要求旧补丁号4.5.1。
|
|
25
|
+
- 新增metadata、已提交产物、实际tarball、稳定发布tag和预构建runtime门禁；必要产物缺失改为硬失败，不再skip。规范工具链固定Node24.21.0/npm11.19.1，锁文件根版本同步包版本。
|
|
26
|
+
- schemastery peer/dev下界更正为3.18.3（3.18.2缺少volatile能力），锁定解析版本3.18.4；没有扩大DSH发布线范围。
|
|
27
|
+
- 版本升至0.4.5，交付此前Unreleased整改；新增稳定版本tag自动派发可信main上的Release，手动触发仍默认verify。npm经OIDC发布同一已验证tarball，GitHub Release附相同字节与checksum。
|
|
28
|
+
|
|
29
|
+
### Documentation
|
|
30
|
+
|
|
31
|
+
- 精简中英README，增加任务导航、领域术语、开发指南和用户排查；明确0.4.5包含整改，0.4.4及更早版本仍有旧版问题。
|
|
32
|
+
- 双语README增加CI/npm状态徽章，恢复修复版npm安装指引并记录0.4.5版本说明。
|
|
33
|
+
- 设计、架构、适配器、平台和发布文档同步本地实现及验证边界；A01–A17状态归入唯一Backlog，历史研究与修订1–24保留。
|
|
34
|
+
- 0.4.4发布日期和历史提交引用已校正；真实账户、视觉及实际凭据写入验证仍未新增。
|
|
35
|
+
|
|
36
|
+
## [0.4.4] - 2026-10-06
|
|
37
|
+
|
|
38
|
+
- 更新README中的SVG进度环、输入框上方独立行和版本导航文案，拆分维护文档的职责。
|
|
39
|
+
- CHANGELOG自本版起随npm包发布；预构建lib与0.4.3相同，无预构建运行代码变更。
|
|
40
|
+
|
|
41
|
+
## [0.4.3] - 2026-10-05
|
|
42
|
+
|
|
43
|
+
- **进度显示改为SVG圆环**：平台ContextMeter同款几何（14×14、r=5.5、2px描边、12点起弧），替代文字条（字形回落问题见修订21/23）。阈值变色经currentColor传导到环，沿用display.progressBar配置键。
|
|
44
|
+
- 字号/行高照抄平台统计行的显式表达式（修订22）。
|
|
45
|
+
- 分隔符与它引导的段落同盒，折行不再留下孤立的分隔符（修订21）。
|
|
46
|
+
- 显示模型从文字bar改为数值progress。
|
|
47
|
+
|
|
48
|
+
## [0.4.2] - 2026-10-05
|
|
49
|
+
|
|
50
|
+
- 状态行迁到conversation.input.dock，位于输入框上方、与输入卡片同宽、order=200；保留原生统计行（修订20）。
|
|
51
|
+
- 此前GitHub开发阶段对共享dock的适配记录在修订19，最终随本版迁为上方独立行；不把该后续提交误列为npm0.4.1已发布内容。
|
|
52
|
+
|
|
53
|
+
## [0.4.1] - 2026-10-05
|
|
54
|
+
|
|
55
|
+
- **修复0.4.0读数全缺**：客户端RPC贡献参数codec缺少0.2要求的create()，remote.usageState未挂载，界面误报Mode not supported（修订18）。0.4.0用户应升级至最新兼容版。
|
|
56
|
+
- 挂载失败记录console.error和store错误；catalog未到时显示读取中。
|
|
57
|
+
- 新增真实0.2 registry契约测试，源码与构建产物各一条。
|
|
58
|
+
|
|
59
|
+
## [0.4.0] - 2026-10-05
|
|
60
|
+
|
|
61
|
+
- 迁移到DSH0.2的Config/configForms/configEditor设置模型；旧settingsScope/settings.register已移除（修订17）。支持范围收紧为 `>=0.2.0-rc.2 <0.3.0-0`。
|
|
62
|
+
- 新增dsh-settings与schemastery peer声明，并在patch中提供config:{}。
|
|
63
|
+
- 本版仍有客户端RPC挂载缺陷，随后由0.4.1修复。
|
|
64
|
+
|
|
65
|
+
## [0.3.2] - 2026-09-30
|
|
66
|
+
|
|
67
|
+
- 仅放宽engines.dsh，源码与产物未改（修订16）。
|
|
68
|
+
- 0.1线末版；声称的0.2兼容后来被真机推翻。DSH0.2不能使用本版，需最新兼容0.4系列。
|
|
69
|
+
|
|
70
|
+
## [0.3.1] - 2026-09-22
|
|
71
|
+
|
|
72
|
+
- 移除React runtime peer，浏览器React由平台模块表提供；React仍作开发依赖（修订15）。
|
|
73
|
+
|
|
74
|
+
## [0.3.0] - 2026-09-22
|
|
75
|
+
|
|
76
|
+
- 移除回合行，账户当前读数只在输入区域显示（修订13）。
|
|
77
|
+
- 首次发布npm，去掉private并声明engines.dsh；进入dsh-market收录链路（修订14）。
|
|
78
|
+
|
|
79
|
+
## [0.2.3] - 2026-09-22
|
|
80
|
+
|
|
81
|
+
- 设置页头部改两列网格，长provider名截断，不挤走控件（修订12）。
|
|
82
|
+
- README补充上游行为参考与致谢。
|
|
83
|
+
|
|
84
|
+
## [0.2.2] - 2026-09-21
|
|
85
|
+
|
|
86
|
+
- 三处健壮性修复，宿主不再轮询已删provider。
|
|
87
|
+
|
|
88
|
+
## [0.2.1] - 2026-09-21
|
|
89
|
+
|
|
90
|
+
- 修复已删provider仍留在设置页的幽灵行。
|
|
91
|
+
|
|
92
|
+
## [0.2.0] - 2026-09-21
|
|
93
|
+
|
|
94
|
+
- 新增OpenCode Zen Go来源，5h/7d/30d；同源模式合并路由（修订11）。
|
|
95
|
+
|
|
96
|
+
## 0.1.0 - 2026-09-21
|
|
97
|
+
|
|
98
|
+
- 首版：四家适配器、宿主缓存/RPC、输入区域状态行、provider配置与中英UI。
|
|
99
|
+
- 首版完整发布提交尚未确认，不链接不存在的版本标签。
|
|
100
|
+
|
|
101
|
+
## 历史引用说明
|
|
102
|
+
|
|
103
|
+
0.4.5起建立版本tag/Release；更早发布没有保存这些引用。0.3.0至0.4.4的比较端点来自各npm版本的gitHead；0.2系列引用对应实现提交，不能替代当时没有保存的正式发布产物。早期日期沿用历史版本记录。今后版本应按发布流程建立稳定引用。
|
|
104
|
+
|
|
105
|
+
[Unreleased]: https://github.com/takboo/dsh-usage-state/compare/v0.4.5...HEAD
|
|
106
|
+
[0.4.5]: https://github.com/takboo/dsh-usage-state/compare/3ad9a71e2f7e4b9a05c69bc529e396a364ae6aeb...v0.4.5
|
|
107
|
+
[0.4.4]: https://github.com/takboo/dsh-usage-state/compare/885541638ffa4da05b39bd1864085ba6d9acc288...3ad9a71e2f7e4b9a05c69bc529e396a364ae6aeb
|
|
108
|
+
[0.4.3]: https://github.com/takboo/dsh-usage-state/compare/0d2d4376d0db990fb36df5d6124e5b7894974d62...885541638ffa4da05b39bd1864085ba6d9acc288
|
|
109
|
+
[0.4.2]: https://github.com/takboo/dsh-usage-state/compare/e5ef97375d01faf9073ef5e4c7522f6ff59514f9...0d2d4376d0db990fb36df5d6124e5b7894974d62
|
|
110
|
+
[0.4.1]: https://github.com/takboo/dsh-usage-state/compare/d93e2c7cdbbba76346d753171b2a4c8408793fc2...e5ef97375d01faf9073ef5e4c7522f6ff59514f9
|
|
111
|
+
[0.4.0]: https://github.com/takboo/dsh-usage-state/compare/d9e08c8765ff89b9dc57b8ac56ee4c61412176d6...d93e2c7cdbbba76346d753171b2a4c8408793fc2
|
|
112
|
+
[0.3.2]: https://github.com/takboo/dsh-usage-state/compare/9f8b863339ebf552478e48c93cc80641f5e2ecb5...d9e08c8765ff89b9dc57b8ac56ee4c61412176d6
|
|
113
|
+
[0.3.1]: https://github.com/takboo/dsh-usage-state/compare/098a31c5b01c600a42ce5bc86d51627ec97b2b16...9f8b863339ebf552478e48c93cc80641f5e2ecb5
|
|
114
|
+
[0.3.0]: https://github.com/takboo/dsh-usage-state/compare/dd37b3d...098a31c5b01c600a42ce5bc86d51627ec97b2b16
|
|
115
|
+
[0.2.3]: https://github.com/takboo/dsh-usage-state/compare/7adb90e...dd37b3d
|
|
116
|
+
[0.2.2]: https://github.com/takboo/dsh-usage-state/compare/e4d40d7...7adb90e
|
|
117
|
+
[0.2.1]: https://github.com/takboo/dsh-usage-state/compare/c01a64f...e4d40d7
|
|
118
|
+
[0.2.0]: https://github.com/takboo/dsh-usage-state/commit/c01a64f
|
package/README.en.md
CHANGED
|
@@ -1,169 +1,112 @@
|
|
|
1
1
|
# dsh-usage-state
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[中文](README.md) | **English**
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
[](https://github.com/takboo/dsh-usage-state/actions/workflows/ci.yml) [](https://www.npmjs.com/package/dsh-usage-state)
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
7
|
+
> **Version note:** **0.4.5** includes the balance parsing, credential override, cache isolation and failure-display fixes previously recorded as Unreleased. See the [Changelog](CHANGELOG.md#045---2026-10-10). Users of 0.4.4 or earlier should upgrade to 0.4.5 or a newer compatible version.
|
|
8
|
+
|
|
9
|
+
Show the current model provider's **account balance** or **coding-plan quota** above the composer input in [DSH (DeepSeek Harness)](https://github.com/deepseek-ai/deepseek-harness). The line matches the input card's width and preserves the native statistics and context meter.
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
z.ai / GLM · ◔ 5h 12% (4h0m) · ◔ 7d 59% (3d17h)
|
|
13
|
+
DeepSeek · ¥58.13
|
|
11
14
|
```
|
|
12
15
|
|
|
13
16
|
## Features
|
|
14
17
|
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
- **Bilingual** (zh / en), following the DSH locale setting.
|
|
21
|
-
- **Display only**: balances and quotas, nothing else — no cost accounting, pricing catalog, history or budgets.
|
|
18
|
+
- Recognized providers default to Auto and reuse existing DSH credentials. Configuration is per provider; the model list is informational.
|
|
19
|
+
- Balances, used percentages, reset countdowns and SVG rings, with configurable amber/red thresholds (80%/95% by default) and an option to hide rings.
|
|
20
|
+
- A failed source request keeps the last successful reading for the same effective account identity, with its age and reason. An RPC failure also marks retained values as stale.
|
|
21
|
+
- Hover details include source, mode, reset time and balance components. The UI follows DSH's Chinese/English language setting.
|
|
22
|
+
- Current account readings only: no cost attribution, price catalog, budgets or historical bills.
|
|
22
23
|
|
|
23
24
|
## Install
|
|
24
25
|
|
|
25
|
-
|
|
26
|
-
|
|
26
|
+
Requires DSH matching `>=0.2.0-rc.2 <0.3.0-0`. The prebuilt plugin declares Node ≥20. Install into the `web` profile you actually use.
|
|
27
|
+
|
|
28
|
+
Install from npm:
|
|
27
29
|
|
|
28
30
|
```bash
|
|
29
|
-
# 1) install (npm package)
|
|
30
31
|
dsh plugin --profile web add dsh-usage-state
|
|
31
|
-
|
|
32
|
-
# 2) restart DSH — the plugin's bundle patch is read at startup
|
|
33
|
-
|
|
34
|
-
# 3) remove
|
|
35
|
-
dsh plugin --profile web remove dsh-usage-state
|
|
32
|
+
# Restart DSH afterwards: the bundle patch is read at startup.
|
|
36
33
|
```
|
|
37
34
|
|
|
38
|
-
|
|
35
|
+
You can also install from GitHub:
|
|
39
36
|
|
|
40
37
|
```bash
|
|
41
38
|
dsh plugin --profile web add github:takboo/dsh-usage-state
|
|
42
39
|
```
|
|
43
40
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
```bash
|
|
47
|
-
dsh plugin --profile web add /path/to/dsh-usage-state
|
|
48
|
-
```
|
|
41
|
+
This repository commits prebuilt artifacts for DSH's GitHub installation path. A floating Git branch may be ahead of npm; record the source and version/commit when reproducing an issue. This does not describe every npm Git installation's lifecycle.
|
|
49
42
|
|
|
50
|
-
|
|
43
|
+
You can also search for `usage state` or `takboo` in [dsh-market](https://github.com/dsh-market/dsh-market); check the actual installation source and version afterwards. The plugin is on the [curated list](https://awesome-dsh-plugin.com); catalog visibility depends on the selected region and a successful catalog build.
|
|
51
44
|
|
|
52
|
-
|
|
45
|
+
Use historical version 0.3.2 on DSH 0.1; it does not work on 0.2. Version 0.4.0 has a broken RPC mount, so upgrade to the **latest compatible release**. See the [Changelog](CHANGELOG.md) for version history.
|
|
53
46
|
|
|
54
47
|
## Quick start
|
|
55
48
|
|
|
56
|
-
1. Open **Settings → Usage state
|
|
57
|
-
2.
|
|
58
|
-
3.
|
|
59
|
-
|
|
60
|
-
If a source needs an endpoint or a key (a self-hosted Sub2API, or a provider without a credential yet), expand that row's **Advanced** block to override the source, set the endpoint, name the credential, or paste a key (written to the DSH credential store).
|
|
61
|
-
|
|
62
|
-
A very long provider name never pushes the controls around: the card header stays on one line and only the grey provider id is truncated (hover it for the full text).
|
|
63
|
-
|
|
64
|
-
## Screenshots
|
|
65
|
-
|
|
66
|
-
The reading on its own line above the composer (shown here with OpenCode Zen Go's three windows; the row under the card is DSH's own statistics, untouched by this plugin — hover any segment for source, mode and the absolute reset time):
|
|
49
|
+
1. Open **Settings → Usage state** to inspect providers, models and the detected source.
|
|
50
|
+
2. Keep Auto for recognized providers, or choose a supported API, Coding Plan or Hidden option.
|
|
51
|
+
3. Set your instance URL for a self-hosted Sub2API source. The current model's reading appears above the input.
|
|
52
|
+
4. Use Refresh now for an explicit query. Check the settings error and the [troubleshooting guide (Chinese)](https://github.com/takboo/dsh-usage-state/blob/main/docs/troubleshooting.md) if it fails.
|
|
67
53
|
|
|
68
|
-
|
|
54
|
+
Advanced controls offer source, endpoint, credential name and key writes. Explicit provider overrides take precedence over legacy source defaults. Descriptions and requests share the candidate order; saves prioritize the explicit ref. Pinned endpoints do not try mirrors, and account configuration/key changes discard previous-identity readings. Configuration and credential write permissions are separate; saves/clears report failure and prevent repeated in-flight operations.
|
|
69
55
|
|
|
70
|
-
|
|
56
|
+
## Sources
|
|
71
57
|
|
|
72
|
-
|
|
58
|
+
| Source | API reading | Coding-plan reading | Main credential |
|
|
59
|
+
|---|---|---|---|
|
|
60
|
+
| DeepSeek official | CNY/USD balance | — | DEEPSEEK_API_KEY |
|
|
61
|
+
| z.ai / Zhipu GLM | — | 5h / 7d used % | ZAI_API_KEY and related refs |
|
|
62
|
+
| Kimi / Moonshot | CNY balance | Kimi Code subscription windows | MOONSHOT_API_KEY / KIMI_CODING_API_KEY |
|
|
63
|
+
| OpenCode Zen Go | — | 5h / 7d / 30d used % | OPENCODE_GO_API_KEY / OPENCODE_API_KEY |
|
|
64
|
+
| Sub2API | Balance or key allowance | Depends on the instance, e.g. 5h / 1d / 7d / 30d | SUB2API_API_KEY and instance URL |
|
|
73
65
|
|
|
74
|
-
|
|
66
|
+
Percentages mean **used**. z.ai keys belong to their China/global region; China is the default endpoint and failures may try the mirror. The current cache merges by source and mode, so separate keys/instances must not be treated as supported independent accounts. Endpoints, field semantics and extension steps are in the [adapter guide (Chinese)](https://github.com/takboo/dsh-usage-state/blob/main/docs/adapters.md).
|
|
75
67
|
|
|
76
|
-
|
|
68
|
+
## Screenshots
|
|
77
69
|
|
|
78
|
-
|
|
70
|
+
OpenCode Zen Go's three windows on the independent line above the input:
|
|
79
71
|
|
|
80
|
-
|
|
81
|
-
|---|---|---|---|
|
|
82
|
-
| DeepSeek official | balance (CNY / USD) | — (no coding plan) | `DEEPSEEK_API_KEY` |
|
|
83
|
-
| z.ai / Zhipu GLM | — | 5h / 7d used % | `ZAI_API_KEY` and friends |
|
|
84
|
-
| Kimi (China) | Moonshot pay-as-you-go balance | Kimi Code subscription windows | `MOONSHOT_API_KEY` / `KIMI_CODING_API_KEY` |
|
|
85
|
-
| OpenCode Zen Go | — | 5h / 7d / 30d used % | `OPENCODE_GO_API_KEY` / `OPENCODE_API_KEY` |
|
|
86
|
-
| Sub2API (self-hosted) | balance / key quota | 5h / 7d from `rate_limits[]` | `SUB2API_API_KEY` + instance URL |
|
|
72
|
+
|
|
87
73
|
|
|
88
|
-
|
|
89
|
-
- **OpenCode Zen Go** reads `rolling` / `weekly` / `monthly` from `opencode.ai/zen/go/v1/usage`. Both DSH routes into the same account (built-in `opencode-go` and the custom `opencode-go-deepseek`) produce one reading and one request. A missing subscription or a rejected key is reported as an auth failure, never as 0%.
|
|
90
|
-
- Other vendors (Claude Pro/Max, MiniMax, OpenRouter, Codex, Antigravity, Volcengine Ark, …) are not implemented, but the adapter contract and a candidate list are ready: see [`docs/adapters.md`](docs/adapters.md).
|
|
74
|
+
Provider settings and advanced controls:
|
|
91
75
|
|
|
92
|
-
|
|
76
|
+
|
|
93
77
|
|
|
94
|
-
|
|
95
|
-
- **Elements**: provider label · balance + currency · each window (5h / 7d / 30d) used % · reset countdown · mini progress ring · threshold colours (defaults: amber ≥80%, red ≥95%).
|
|
96
|
-
- **Semantics**: percentages are always *used*; balances only appear in API mode, and coding-plan mode shows the windows the source actually has (5h / 7d for z.ai and Sub2API, plus 30d for OpenCode Zen Go); a stale reading shows its age instead of hiding.
|
|
97
|
-
- **Refresh**: 2s after a turn ends, plus a 5-minute idle fallback; at most one real request per source per 60s, in-flight calls are shared, failures are not throttled.
|
|
98
|
-
- **Credentials**: override → the provider's declared `apiKeyEnv` → the source's built-in ref → DSH credential store. Keys are written to `~/.dsh/.credentials.yaml`; **this plugin never stores a plaintext key** and the browser never receives a key value.
|
|
78
|
+
|
|
99
79
|
|
|
100
|
-
##
|
|
80
|
+
## Refresh and credentials
|
|
101
81
|
|
|
102
|
-
|
|
103
|
-
- `peerDependencies` carry `@deepseek-ai/dsh-settings` (`^0.2.0-rc.2`) and `@deepseek-ai/schemastery` (`^3.18.2`). The first one is deliberate: the runtime install gate only reads `@deepseek-ai/dsh*` peers, so declaring it makes a 0.1.x host **refuse the install** instead of accepting it and then failing to boot. Both are platform-provided; pnpm may print a `missing peer` warning for them, which is expected.
|
|
104
|
-
- Version `0.4.2` moves the status line to `conversation.input.dock`, giving it **its own line above the composer input** — DSH 0.2 turned the old below-the-input position into a shared row of pills next to the platform's stats and context meter (revisions 19/20).
|
|
105
|
-
- Version `0.4.1` fixes `0.4.0`'s missing readings: the browser half's RPC contribution lacked the `create()` factory 0.2 requires, so `remote.usageState` never mounted — the UI showed **no readings at all** and mislabelled the cause as `Mode not supported`. The same release stops swallowing a rejected mount, says "reading" while the catalog is absent, and adds **real 0.2 registry contract tests** (revision 18). **Use `0.4.1`, not `0.4.0`.**
|
|
106
|
-
- Version `0.4.0` migrates to the 0.2 settings model (`Config` + `configForms`, with cross-entry config read through `configEditor`). Verification and results: [`docs/implementation.md`](docs/implementation.md) §10; rationale: [`docs/design-consensus.md`](docs/design-consensus.md) revision 17.
|
|
107
|
-
- Version `0.3.2` (last of the 0.1 line) only widened `engines.dsh`; **its claimed 0.2 compatibility was wrong** — on `0.2.0-rc.2` it fails the entire web boot because `settingsScope` does not exist there.
|
|
108
|
-
- Published to npm as [`dsh-usage-state`](https://www.npmjs.com/package/dsh-usage-state); GitHub installs work too.
|
|
82
|
+
The host schedules refreshes 2 seconds after a turn ends and has a 5-minute fallback timer. The browser reads the RPC mirror every 30 seconds. Ordinary polling initializes a missing or changed account identity, otherwise it does not shorten idle queries to once a minute. Successful requests have a default 60-second minimum; explicit refresh can bypass it, and active retries after failure are not throttled by that successful-request interval. Editing the idle interval reschedules the timer.
|
|
109
83
|
|
|
110
|
-
|
|
84
|
+
The plugin queries balances/quotas and reads the selected model and provider catalog. It writes no session logs and reports no readings to third parties. The host does not return stored key values to the browser; a key the user actively pastes is sent through DSH's credential service to the credential file in the selected home. Environment values take precedence and usually cannot be edited in settings.
|
|
111
85
|
|
|
112
|
-
|
|
113
|
-
- **Clicking the line does not open settings** (the platform exposes no public "open settings panel" service); details are in the hover tooltip.
|
|
114
|
-
- **Current reading only**: the line reports the account's latest value. The plugin keeps no per-turn and no per-time history, so scrolling back through old turns shows no "balance at that moment". Account history, if ever added, would be keyed by time rather than by turn — a separate decision.
|
|
115
|
-
- Full list: [`docs/implementation.md`](docs/implementation.md) §6.
|
|
86
|
+
## Known limitations
|
|
116
87
|
|
|
117
|
-
|
|
88
|
+
See the [Backlog (Chinese)](https://github.com/takboo/dsh-usage-state/blob/main/docs/backlog.md) for remediation status and verification scope.
|
|
118
89
|
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
npm run build # tsdown → lib/ (host index.js + typert.js, browser client.js)
|
|
124
|
-
npm run watch # rebuilds client.js only; client changes hot-reload, no page refresh
|
|
125
|
-
```
|
|
90
|
+
- **Older npm 0.4.4 and earlier:** still has credential override, pin/cache identity, legacy hiding, default ordering and failure-display defects. It still divides Moonshot balances ≥100 yuan by 100 and may turn invalid DeepSeek amounts into zero. These are fixed in 0.4.5; upgrade if you use an older version. Cross-check old-version amounts against the [official API](https://platform.kimi.com/docs/api/balance.md).
|
|
91
|
+
- **Account scope:** one target is still selected per source and mode. Identity isolation does not add independent multi-account support.
|
|
92
|
+
- **Live verification:** Kimi Code/Sub2API accounts, high-threshold colors, real credential writes and nonzero OpenCode readings still lack live coverage. Local interaction tests do not replace that acceptance.
|
|
93
|
+
- **Scope:** the line can be absent without a selected model or when hidden; clicking it does not open settings; readings are not saved as history.
|
|
126
94
|
|
|
127
|
-
|
|
95
|
+
## Development and docs
|
|
128
96
|
|
|
129
|
-
|
|
130
|
-
npm run build # lib/ must exist
|
|
131
|
-
scripts/dev-local.sh # creates/reuses the dev profile, prints the token URL
|
|
132
|
-
# second terminal:
|
|
133
|
-
npm run watch # rebuilds client.js on save
|
|
134
|
-
```
|
|
135
|
-
|
|
136
|
-
Because the profile links this working tree, a rebuild is picked up by the running host: client changes are hot-swapped by `dsh-client-hmr` (the host stat-polls every bundle at 500ms and tells the browser to reload the module over `/plugins/events`) — no restart, no release. Host-side changes (`src/host/**`, `src/index.ts`, `cordis.patch.yml`) need this script restarted.
|
|
137
|
-
|
|
138
|
-
⚠️ **This profile has no credentials**: `$DSH_HOME/.credentials.yaml` is home-level, and a fresh home starts without keys and without your other plugins (a font plugin changes the very glyph metrics a layout depends on). It is for **structural / host-side** checks only. To judge how something *looks*, install the same build into a profile that already has your keys and plugins — still without publishing:
|
|
97
|
+
Development supports Node 22.18+ on the 22 line or Node 24.11+. Canonical builds pin **Node 24.21.0** ([.node-version](https://github.com/takboo/dsh-usage-state/blob/main/.node-version)) and **npm 11.19.1** (packageManager), above the runtime floor. Basic checks:
|
|
139
98
|
|
|
140
99
|
```bash
|
|
141
|
-
npm
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
100
|
+
npm ci
|
|
101
|
+
npm run typecheck
|
|
102
|
+
npm run build
|
|
103
|
+
npm test
|
|
145
104
|
```
|
|
146
105
|
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
Host-side changes need a DSH restart; client-side changes do not. The `lib/` output is **committed on purpose**: `dsh plugin add github:...` installs straight from the repository with no build step, and `npm test` guards the bundle envelope, the require allow-list and the `exports` targets.
|
|
150
|
-
|
|
151
|
-
## Docs
|
|
152
|
-
|
|
153
|
-
| Document | Contents |
|
|
154
|
-
|---|---|
|
|
155
|
-
| [`docs/implementation.md`](docs/implementation.md) | Implementation and verification overview: code map, decision → code → test → verification traceability, open items |
|
|
156
|
-
| [`docs/adapters.md`](docs/adapters.md) | Adding a data source: contract, workflow, pitfalls, candidate vendors, troubleshooting |
|
|
157
|
-
| [`docs/design-consensus.md`](docs/design-consensus.md) | Design consensus and its revision log (Chinese) |
|
|
158
|
-
| [`docs/research/README.md`](docs/research/README.md) | Read-only research index (vendor APIs, the replaced plugin, DSH RPC contract) |
|
|
159
|
-
|
|
160
|
-
## Acknowledgements
|
|
106
|
+
See the [development guide (Chinese)](https://github.com/takboo/dsh-usage-state/blob/main/docs/development.md) for local profiles, watch and HMR requirements. The [documentation index (Chinese)](https://github.com/takboo/dsh-usage-state/blob/main/docs/index.md) links architecture, design, release, audit and research material by task.
|
|
161
107
|
|
|
162
|
-
|
|
163
|
-
The data-source endpoints, the meaning of the response fields and several compatibility pitfalls (OpenCode Zen Go needs a browser UA, z.ai reports auth failure as HTTP 200 + `{success:false}`, the legacy `coding_plan/usage` fallback, sub2api's `rate_limits[]` shape, …) come from a **read-only analysis** of `dsh-cost-meter@1.7.28`, recorded in [`docs/research/dsh-cost-meter-analysis.md`](docs/research/dsh-cost-meter-analysis.md). The implementation here is independently written TypeScript rather than copied source, but those behaviours are upstream's work and credit belongs there.
|
|
164
|
-
If the upstream author wants a clearer attribution or a different arrangement, open an issue and it will be fixed.
|
|
165
|
-
- **[DSH (DeepSeek Harness)](https://github.com/deepseek-ai)**: the host platform. The plugin relies on its settings namespace, credential store, Typert RPC, slot system and UI primitives (`@deepseek-ai/dsh-client-ui-primitives` and friends).
|
|
108
|
+
## Acknowledgements and license
|
|
166
109
|
|
|
167
|
-
|
|
110
|
+
Thanks to [dsh-cost-meter](https://github.com/Han-1413141/dsh-cost-meter) by Han-1413141 (MIT) for data-source behavior references. This TypeScript implementation was written independently; endpoint, field and compatibility provenance is recorded in the [upstream analysis](https://github.com/takboo/dsh-usage-state/blob/main/docs/research/dsh-cost-meter-analysis.md). DSH provides the settings, credentials, RPC, slots and UI primitives.
|
|
168
111
|
|
|
169
|
-
[MIT](LICENSE)
|
|
112
|
+
[MIT](LICENSE). Report problems or attribution suggestions through [Issues](https://github.com/takboo/dsh-usage-state/issues).
|