@rayadesu/dsh-billing 0.3.1 → 0.3.4

package/AGENTS.md

@@ -47,7 +47,7 @@ cordis.patch.yml         DSH profile bundle 补丁层：挂载 llm-billing + ui-
 - **密钥不进仓库**：`DEEPSEEK_API_KEY` 等一律由用户环境或凭据 seam 提供，仓库不含真实值。
 - **README 双语**：每个 README 遵循 DSH 结构 `README.md`(EN) + `README.zh.md`(ZH) +
   `README.i18n.yaml`（记录两文件 git blob hash，改动后需更新）。
-- **版本对齐**：根 bundle 与两个包统一版本号（当前 0.3.0），`pnpm-lock.yaml` 随依赖变更更新。
+- **版本对齐**：根 bundle 与两个包统一版本号（当前 0.3.4），`pnpm-lock.yaml` 随依赖变更更新。
 - **文本规范**：LF 换行、文件末尾一个换行（`.editorconfig`/`.gitattributes` 已声明）。
 
 ## 常用命令

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 WilliamLIiii
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 WilliamLIiii
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # last confirmed-consistent state. Both languages carry equal authority; after
 # editing either side, bring the other along and re-record both hashes with:
 #   git hash-object README.md README.zh.md
-README.md: 043453b28aa797ae654f2fa8653a547c1a9dd13b
-README.zh.md: bd3f35d13149144e519b31a01960066df9c53423
+README.md: 9c37927de206de645bc826b3d95b8d86dd636e1e
+README.zh.md: c48efb8c6d88452d959feec50670f428fd927cce

package/README.md

@@ -25,6 +25,10 @@ A real session: the session-header badge, the detail panel (remaining amount, th
 
 <img width="1200" alt="Billing plugin overview: session header badge, detail panel with per-model rows and today's session ranking, and the turn-cost row" src="preview-overview.png" />
 
+Close-up of the detail panel — the `API 剩余金额` figure, `本会话花费` next to `今日共花费`, the per-model breakdown (`缓存命中 · 未命中输入 · 输出`), and the today session-spend ranking:
+
+<img width="640" alt="Detail panel close-up: API remaining amount, this session's spend next to today's all-session spend, per-model rows and today's session ranking" src="preview-detail.png" />
+
 Close-up of the turn-cost row — money-bag icon, `本轮花费` label and the `¥` amount, in front of the copy control:
 
 <img width="640" alt="Turn-cost row close-up: money-bag icon, 本轮花费 label and ¥ amount before the copy control" src="preview-turn-cost.png" />
@@ -111,8 +115,17 @@ dsh plugin --profile web list    # list the web profile's installed plugins
 dsh plugin --profile web add @rayadesu/dsh-billing @rayadesu/dsh-llm-billing @rayadesu/dsh-client-ui-billing
 dsh plugin --profile web remove @rayadesu/dsh-billing @rayadesu/dsh-llm-billing @rayadesu/dsh-client-ui-billing
 dsh plugin --profile web update  # update plugins to the latest allowed versions
+dsh plugin --profile web update --latest  # ignore declared ranges; upgrade every plugin to its newest published version
 ```
 
+`update` respects the version ranges in the profile's `package.json`, so it
+stays within the semver range each plugin declares. Adding `--latest` (a pnpm
+`update` flag) instead ignores those ranges and upgrades every plugin to its
+newest published version — the way to pick up a fresh release immediately once
+it is resolvable. From a source-built dsh checkout you run it as
+`pnpm dsh …` in the deepseek-harness directory, exactly as with the other
+commands.
+
 ### Dependency notes
 
 The two plugin packages declare the DeepSeek Harness packages they build on

package/README.zh.md

@@ -25,6 +25,10 @@
 
 <img width="1200" alt="计费插件总览：会话头部徽标、详情面板（按模型分项与今日会话花费排行）、消息操作行里的本轮花费行" src="preview-overview.png" />
 
+详情面板特写 —— `API 剩余金额`、`本会话花费` 与 `今日共花费`、按模型分项（`缓存命中 · 未命中输入 · 输出`）与今日会话花费排行：
+
+<img width="640" alt="详情面板特写：API 剩余金额、本会话花费与今日共花费、按模型分项与今日会话花费排行" src="preview-detail.png" />
+
 本轮花费行特写 —— 钱袋图标、`本轮花费` 标签与 `¥` 金额，位于复制控件之前：
 
 <img width="640" alt="本轮花费行特写：钱袋图标、本轮花费标签与金额，位于复制控件之前" src="preview-turn-cost.png" />
@@ -105,8 +109,14 @@ dsh plugin --profile web list    # 列出 web profile 已安装的插件
 dsh plugin --profile web add @rayadesu/dsh-billing @rayadesu/dsh-llm-billing @rayadesu/dsh-client-ui-billing
 dsh plugin --profile web remove @rayadesu/dsh-billing @rayadesu/dsh-llm-billing @rayadesu/dsh-client-ui-billing
 dsh plugin --profile web update  # 把插件更新到当前允许的最新版本
+dsh plugin --profile web update --latest  # 忽略声明的版本区间，把所有插件升到最新发布版本
 ```
 
+`update` 遵循 profile `package.json` 里的版本区间，只在该插件声明的 semver 范围内升级。
+加上 `--latest`（pnpm `update` 的选项）则忽略这些区间，把所有插件直接升到最新发布的版本——
+用于在版本可解析后立刻拿到新发布。源码构建的 dsh 要在 deepseek-harness 目录里用
+`pnpm dsh …` 执行，和其余命令一样。
+
 ### 依赖说明
 
 两个插件包把它们依赖的 DeepSeek Harness 包（`@deepseek-ai/cordis`、

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@rayadesu/dsh-billing",
-  "version": "0.3.1",
+  "version": "0.3.4",
   "description": "DeepSeek Harness billing plugin: account balance and this session's billed spend with a session-header badge.",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/rayadesune/DeepSeek-Harness-chat-billing.git"
   },
+  "packageManager": "pnpm@11.7.0",
   "engines": {
     "node": "^22.19 || >=24"
   },
@@ -15,6 +16,14 @@
       "patch": "./cordis.patch.yml"
     }
   },
+  "scripts": {
+    "build": "pnpm run build:host && pnpm run build:client",
+    "build:host": "tsc -b tsconfig.host.json && tsdown --env.DSH_BUILD_FACE host",
+    "build:client": "tsc -b tsconfig.client.json && tsdown --env.DSH_BUILD_FACE client",
+    "typecheck": "tsc -b tsconfig.host.json && tsc -b tsconfig.client.json",
+    "test": "vitest run",
+    "verify": "node scripts/verify-packages.mjs"
+  },
   "files": [
     "cordis.patch.yml",
     "README.md",
@@ -22,6 +31,7 @@
     "README.i18n.yaml",
     "preview-overview.png",
     "preview-turn-cost.png",
+    "preview-detail.png",
     "LICENSE",
     "AGENTS.md"
   ],
@@ -29,8 +39,8 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@rayadesu/dsh-client-ui-billing": "^0.3.1",
-    "@rayadesu/dsh-llm-billing": "^0.3.1"
+    "@rayadesu/dsh-client-ui-billing": "^0.3.4",
+    "@rayadesu/dsh-llm-billing": "^0.3.4"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
@@ -42,13 +52,5 @@
     "tsdown": "^0.22.2",
     "typescript": "^6.0.3",
     "vitest": "^4.1.8"
-  },
-  "scripts": {
-    "build": "pnpm run build:host && pnpm run build:client",
-    "build:host": "tsc -b tsconfig.host.json && tsdown --env.DSH_BUILD_FACE host",
-    "build:client": "tsc -b tsconfig.client.json && tsdown --env.DSH_BUILD_FACE client",
-    "typecheck": "tsc -b tsconfig.host.json && tsc -b tsconfig.client.json",
-    "test": "vitest run",
-    "verify": "node scripts/verify-packages.mjs"
   }
-}
+}