dsh-usage-state 0.3.0 → 0.3.2

package/README.en.md

@@ -22,7 +22,7 @@ hover any segment:           Source DeepSeek · Mode API balance · Granted 0 ·
 
 ## Install
 
-**Requirements**: DSH `0.1.5-rc.2` or newer, Node ≥ 20, installed into the `web` profile. The package **ships the prebuilt `lib/`**, so installation has no build step.
+**Requirements**: DSH `0.1.5-rc.2` through `0.2.x`, Node ≥ 20, installed into the `web` profile. The package **ships the prebuilt `lib/`**, so installation has no build step.
 
 ```bash
 # 1) install (npm package)
@@ -46,6 +46,8 @@ For development, a local path works too (host-side changes still need a DSH rest
 dsh plugin --profile web add /path/to/dsh-usage-state
 ```
 
+It is also listed in [dsh-market](https://github.com/dsh-market/dsh-market): search for `usage state` (or `takboo`) and install it in one click — the plugin is on the [awesome-dsh-plugin](https://awesome-dsh-plugin.com) curated list under Usage & Billing.
+
 Nothing showing up after installing? See the troubleshooting table at the end of [`docs/adapters.md`](docs/adapters.md).
 
 ## Quick start
@@ -58,6 +60,20 @@ If a source needs an endpoint or a key (a self-hosted Sub2API, or a provider wit
 
 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).
 
+## Screenshots
+
+The reading directly below the composer's stats row (shown here with OpenCode Zen Go's three windows; hover any segment for source, mode and the absolute reset time):
+
+![The reading below the composer](https://raw.githubusercontent.com/takboo/dsh-usage-state/main/assets/screenshots/status-line.webp)
+
+Settings: one row per provider; **Auto** detects the data source and its primary mode:
+
+![Provider list in the settings page](https://raw.githubusercontent.com/takboo/dsh-usage-state/main/assets/screenshots/settings-providers.webp)
+
+Expanding **Advanced** lets you override the source and endpoint, name a credential, or paste a key (written to the DSH credential store):
+
+![Advanced block](https://raw.githubusercontent.com/takboo/dsh-usage-state/main/assets/screenshots/settings-advanced.webp)
+
 ## Supported sources
 
 | Source | API mode | Coding-plan mode | Credential |
@@ -82,9 +98,9 @@ A very long provider name never pushes the controls around: the card header stay
 
 ## Compatibility
 
-- Verified against DSH `0.1.5-rc.2`, Node ≥ 20; the DSH requirement is declared as `>=0.1.5-rc.1 <0.2.0-0` through `engines.dsh` (this is what dsh-market's compatibility badge reads).
+- Verified against DSH `0.1.5-rc.2` and `0.2.0-rc.2`, Node ≥ 20. The DSH requirement is declared as `>=0.1.5-rc.1 <0.3.0-0` through `engines.dsh` — the whole 0.1 line from 0.1.5 up, plus the 0.2 line (this is what dsh-market's compatibility badge and install gate read).
 - Published to npm as [`dsh-usage-state`](https://www.npmjs.com/package/dsh-usage-state); GitHub installs work too.
-- Version `0.3.0`: DeepSeek, z.ai and OpenCode Zen Go are verified against live accounts; see the limitations below.
+- Version `0.3.2`: 0.2-line compatibility review (no code change — only `engines.dsh` was widened); DeepSeek, z.ai and OpenCode Zen Go are verified against live accounts; see the limitations below.
 
 ## Limitations
 

package/README.md

@@ -24,7 +24,7 @@
 
 ## 安装
 
-**前置条件**：DSH `0.1.5-rc.2` 或更高、Node ≥ 20，装进 `web` profile。包内**自带预构建的 `lib/`**，安装时没有构建步骤。
+**前置条件**：DSH `0.1.5-rc.2` ～ `0.2.x`、Node ≥ 20，装进 `web` profile。包内**自带预构建的 `lib/`**，安装时没有构建步骤。
 
 ```bash
 # 1) 安装（npm 包）
@@ -48,6 +48,8 @@ dsh plugin --profile web add github:takboo/dsh-usage-state
 dsh plugin --profile web add /path/to/dsh-usage-state
 ```
 
+也可以在 [dsh-market](https://github.com/dsh-market/dsh-market) 里搜索 `usage state`（或 `takboo`）一键安装——本插件已收录在精选列表 [awesome-dsh-plugin](https://awesome-dsh-plugin.com) 的「用量与计费」分类。
+
 装好后界面没有出现？见 [`docs/adapters.md`](docs/adapters.md) 末尾的排查表。
 
 ## 快速开始
@@ -60,6 +62,20 @@ dsh plugin --profile web add /path/to/dsh-usage-state
 
 供应商名过长时，卡片头部只截断灰色的 provider id（悬停显示全文），右侧的 `↑ ↓ 自动 / Coding Plan / 隐藏` 不会换行。
 
+## 截图
+
+输入框统计行正下方的账户读数（图示为 OpenCode Zen Go 的三个窗口，悬停任意一段可看数据源、模式与绝对重置时刻）：
+
+![输入框下方的账户读数](https://raw.githubusercontent.com/takboo/dsh-usage-state/main/assets/screenshots/status-line.webp)
+
+设置页：每个 provider 一行，默认「自动」会识别数据源与主模式：
+
+![设置页的供应商列表](https://raw.githubusercontent.com/takboo/dsh-usage-state/main/assets/screenshots/settings-providers.webp)
+
+展开「高级」可覆盖数据源与端点、指定凭据名，或写入密钥（写入 DSH 凭据库）：
+
+![高级区](https://raw.githubusercontent.com/takboo/dsh-usage-state/main/assets/screenshots/settings-advanced.webp)
+
 ## 支持的数据源
 
 | 数据源 | API 模式 | Coding Plan 模式 | 凭据 |
@@ -106,9 +122,9 @@ dsh plugin --profile web add /path/to/dsh-usage-state
 
 ## 兼容性
 
-- 实测环境：DSH `0.1.5-rc.2`，Node ≥ 20；DSH 版本要求通过 `engines.dsh` 声明为 `>=0.1.5-rc.1 <0.2.0-0`（dsh-market 的兼容徽标读的就是它）。
+- 实测环境：DSH `0.1.5-rc.2` 与 `0.2.0-rc.2`，Node ≥ 20。DSH 版本要求通过 `engines.dsh` 声明为 `>=0.1.5-rc.1 <0.3.0-0`，即 **0.1.5 起的整条 0.1 线与 0.2 线**（dsh-market 的兼容徽标与"可安装"判定读的就是它）。
 - 同名发布在 npm（[`dsh-usage-state`](https://www.npmjs.com/package/dsh-usage-state)），也可从 GitHub 直接安装。
-- 版本 `0.3.0`：DeepSeek、z.ai 与 OpenCode Zen Go 已在真机验证，其余见下。
+- 版本 `0.3.2`：DSH 0.2 发布线的兼容复核（无代码改动，只放宽 `engines.dsh`）；DeepSeek、z.ai 与 OpenCode Zen Go 已在真机验证，其余见下。
 
 ## 已知限制
 

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "dsh-usage-state",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "description": "DSH plugin: show account balance (API mode) or coding-plan quota (5h/7d/30d) for the model in use",
   "license": "MIT",
   "engines": {
     "node": ">=20",
-    "dsh": ">=0.1.5-rc.1 <0.2.0-0"
+    "dsh": ">=0.1.5-rc.1 <0.3.0-0"
   },
   "scripts": {
     "test": "node --import ./tests/support/client-render-hook.mjs --test",
@@ -69,9 +69,6 @@
     "LICENSE",
     "docs/adapters.md"
   ],
-  "peerDependencies": {
-    "react": "^18.2.0"
-  },
   "keywords": [
     "deepseek",
     "dsh",