@rayadesu/dsh-billing 0.1.0-rc.9 → 0.2.0

package/AGENTS.md

@@ -41,7 +41,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.1.0-rc.8），`pnpm-lock.yaml` 随依赖变更更新。
+- **版本对齐**：根 bundle 与两个包统一版本号（当前 0.1.0），`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: a9771710292f8567ecbf3eb0cca14157ffe28bba
-README.zh.md: f8b2f62ea4c4ad46d4e05e2625ae1e9c70806e1c
+README.md: 6ba8f7b92f1815c54688bc77b63dbf8408565eae
+README.zh.md: 6efa6759a56cdaeeffa48319fff42e95d246029f

package/README.md

@@ -45,9 +45,9 @@ A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugin tha
 ### Installation (published to npm, one command)
 
 The three packages are published to npm under the `@rayadesu` scope. Install
-the bundle plus the two plugin packages in one command (pnpm does not install
-the bundle's local dependencies into the profile, so the two plugin packages
-must be named explicitly):
+the bundle plus the two plugin packages in one command (the bundle declares the
+two plugin packages as peer dependencies, which pnpm does not auto-install into
+the profile, so they must be named explicitly):
 
 ```bash
 dsh plugin --profile web add @rayadesu/dsh-billing @rayadesu/dsh-llm-billing @rayadesu/dsh-client-ui-billing
@@ -66,10 +66,13 @@ Manual rows (only when you do not want the bundle):
 
 ### Dependency notes
 
-The runtime dependencies (`@deepseek-ai/dsh-credentials` and friends) are published
-to npm (`0.1.0-rc.8` on the `next` tag); both manifests declare them as
-`^0.1.0-rc.8` (the published form of the official `workspace:^`), so `pnpm install`
-resolves them directly.
+The two plugin packages declare the DeepSeek Harness packages they build on
+(`@deepseek-ai/cordis`, `@deepseek-ai/dsh-credentials`, `@deepseek-ai/dsh-session`,
+and the client runtime packages) as `peerDependencies` at `^0.1.0-rc.8`. A dsh
+profile does not auto-install peers, so these are provided by the dsh
+installation itself through the `profiles/node_modules` fallback rather than
+fetched from the registry — no extra packages to install, and no registry token
+needed on the installing machine.
 
 ### Configure your DeepSeek API key
 
@@ -96,15 +99,15 @@ Both packages ship sane defaults; everything below is optional.
 | `apiKeyEnv` | `DEEPSEEK_API_KEY` | Credential-reference (environment-variable) name resolved per call. |
 | `baseURL` | `$DEEPSEEK_BASE_URL` then `https://api.deepseek.com` | Endpoint base; `/user/balance` is appended. |
 | `models` | V4 Flash + V4 Pro + V4 Flash Vision Exp | Advisory display rows, in presentation order. |
-| `billing.peakHours` | 09:00–12:00, 14:00–18:00 (Beijing) | Peak-hour windows; all other hours are off-peak. |
+| `billing.peakHours` | 09:00–12:00, 14:00–18:00 (Beijing, weekdays) | Peak-hour windows, applied weekdays (Mon–Fri) only; weekends and all other hours are off-peak. |
 | `billing.models` | Published V4 rates | Per-model peak/off-peak price rows (`cacheHitInput`, `cacheMissInput`, `output`, in CNY per 1M tokens). |
 
 ## How session spend is computed
 
 - Each `assistant/message` event reports three billed token buckets: **cache-hit input**, **cache-miss input** (uncached input + cache writes), and **output** (including reasoning).
-- Each message is priced at the peak/off-peak rate of its own **Beijing-time** hour, the three buckets are billed separately (`缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z`), then summed per model.
+- Each message is priced at the peak/off-peak rate of its own **Beijing-time** hour, the three buckets are billed separately (`缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z`), then summed per model. Peak windows apply weekdays (Monday–Friday) only; weekends are always off-peak.
 - **Today's spend** aggregates every session's events on the current Beijing-time calendar day with the same pricing rules; event dates are also assigned in Beijing time.
-- Models without a rate row are not priced (the built-in catalog currently has the three V4 rows: V4 Flash, V4 Pro, and V4 Flash Vision Exp). Rates follow the DeepSeek pricing effective **August 17** (Beijing-time peak/off-peak hours).
+- Models without a rate row are not priced (the built-in catalog currently has the three V4 rows: V4 Flash, V4 Pro, and V4 Flash Vision Exp). Rates follow the DeepSeek pricing effective **August 17**; the weekend-off-peak rule (weekends billed at off-peak prices all day) follows the adjustment effective **August 23**.
 
 ## Known limitations
 

package/README.zh.md

@@ -44,7 +44,7 @@
 ### 安装（已发布到 npm，一条命令）
 
 三个包已发布到 npm 的 `@rayadesu` scope。一条命令同时安装 bundle 与两个插件包
-（pnpm 不会把 bundle 的本地依赖装进 profile，所以两个插件包要显式列出）：
+（bundle 把两个插件包声明为 peer 依赖，而 profile 默认不自动安装 peer，所以要显式列出）：
 
 ```bash
 dsh plugin --profile web add @rayadesu/dsh-billing @rayadesu/dsh-llm-billing @rayadesu/dsh-client-ui-billing
@@ -63,9 +63,11 @@ dsh plugin --profile web add @rayadesu/dsh-billing @rayadesu/dsh-llm-billing @ra
 
 ### 依赖说明
 
-`@deepseek-ai/dsh-credentials` 等运行时依赖已发布到 npm（`0.1.0-rc.8`，`next` tag），
-两个包的 manifest 以 `^0.1.0-rc.8` 声明（官方 monorepo 中 `workspace:^` 的发布形态），
-`pnpm install` 可直接解析。
+两个插件包把它们依赖的 DeepSeek Harness 包（`@deepseek-ai/cordis`、
+`@deepseek-ai/dsh-credentials`、`@deepseek-ai/dsh-session` 以及客户端运行时包）
+声明为 `peerDependencies`（`^0.1.0-rc.8`）。dsh profile 默认不自动安装 peer，所以
+这些由 dsh 安装本身通过 `profiles/node_modules` 回退提供，而不是从 registry 拉取——
+无需额外安装，安装机也不需要 registry token。
 
 ### 配置你的 DeepSeek API key
 
@@ -92,15 +94,15 @@ dsh web
 | `apiKeyEnv` | `DEEPSEEK_API_KEY` | 每次调用时解析的凭据引用（环境变量）名。 |
 | `baseURL` | `$DEEPSEEK_BASE_URL`，其次 `https://api.deepseek.com` | 端点基础地址；会追加 `/user/balance`。 |
 | `models` | V4 Flash + V4 Pro + V4 Flash Vision Exp | 展示用的模型行，按展示顺序。 |
-| `billing.peakHours` | 09:00–12:00、14:00–18:00（北京） | 高峰时段窗口；其余时段为低谷。 |
+| `billing.peakHours` | 09:00–12:00、14:00–18:00（北京，仅工作日） | 高峰时段窗口，仅周一至周五适用；周末与其余时段均为低谷。 |
 | `billing.models` | 官方 V4 费率 | 每个模型的峰/谷单价行（`cacheHitInput`、`cacheMissInput`、`output`，单位：元/百万 token）。 |
 
 ## 会话花费是怎么算的
 
 - 每条 `assistant/message` 事件报告三个计费 token 桶：**缓存命中输入**、**未命中输入**（未缓存输入 + 缓存写入）、**输出**（含推理）。
-- 每条消息按其**发生时刻（北京时间）**所在的峰/谷时段单价计价，三个桶分别计费（`缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z`），再按模型汇总。
+- 每条消息按其**发生时刻（北京时间）**所在的峰/谷时段单价计价，三个桶分别计费（`缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z`），再按模型汇总。高峰窗口仅周一至周五适用；周末全天按低谷价计费。
 - **今日共花费**按同一个计价规则汇总当天（北京时间自然日）所有会话的事件；事件归属的日期同样按北京时间计算。
-- 没有费率行的模型不计入（内置价目表目前含三个 V4 行：V4 Flash、V4 Pro、V4 Flash Vision Exp）。计费按 DeepSeek **8 月 17 日实行**的费率（北京时间峰/谷时段）。
+- 没有费率行的模型不计入（内置价目表目前含三个 V4 行：V4 Flash、V4 Pro、V4 Flash Vision Exp）。计费按 DeepSeek **8 月 17 日实行**的费率；**周末按低谷价计费**的规则按 **8 月 23 日**生效的调整执行。
 
 ## 已知限制
 

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@rayadesu/dsh-billing",
-  "version": "0.1.0-rc.9",
+  "version": "0.2.0",
   "description": "DeepSeek Harness billing plugin: account balance and this session's billed spend with a session-header badge.",
   "license": "MIT",
+  "packageManager": "pnpm@11.7.0",
   "engines": {
     "node": "^22.19 || >=24"
   },
@@ -11,10 +12,11 @@
       "patch": "./cordis.patch.yml"
     }
   },
+  "scripts": {
+    "build": "pnpm -r build"
+  },
   "files": [
     "cordis.patch.yml",
-    "packages/llm-billing",
-    "packages/ui-billing",
     "README.md",
     "README.zh.md",
     "LICENSE",
@@ -24,10 +26,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.1.0-rc.8",
-    "@rayadesu/dsh-client-ui-billing": "^0.1.0-rc.8"
-  },
-  "scripts": {
-    "build": "pnpm -r build"
+    "@rayadesu/dsh-llm-billing": "^0.2.0",
+    "@rayadesu/dsh-client-ui-billing": "^0.2.0"
   }
-}
+}

package/packages/llm-billing/README.i18n.yaml

@@ -1,6 +0,0 @@
-# Bilingual-pair consistency record: the git blob hash of each side as of the
-# 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: 655288ebdb37cee4ecd3edfad8b3953e3a4e87ee
-README.zh.md: e8ac4a2716ffe57200bb9757e1f0c6dabaf77c2f

package/packages/llm-billing/README.md

@@ -1,44 +0,0 @@
-# @rayadesu/dsh-llm-billing
-
-English | [中文](README.zh.md)
-
-Standalone host plugin that turns the DeepSeek account balance and per-session spend into a `billing` Remote. It owns the `/user/balance` transport, the peak/off-peak pricing table, and the per-session spend pricing, so a deployment can surface "how much is left, and what this session cost" without coupling that to the chat-completions adapter. The browser half is [`dsh-client-ui-billing`](../ui-billing/README.md).
-
-## Install
-
-Add the plugin to a composition (a `cordis.yml` row) and give it a credential. It resolves the API key from the credential seam (or the environment variable named by `apiKeyEnv`) and the endpoint from `baseURL`, then `$DEEPSEEK_BASE_URL`, then the public API.
-
-```yaml
-- id: llm-billing
-  name: '@rayadesu/dsh-llm-billing'
-  config:
-    # apiKeyEnv: DEEPSEEK_API_KEY   # default
-    # baseURL: https://api.deepseek.com
-```
-
-The plugin registers the `billing` Remote with three methods: `getBalance()` (the parsed `/user/balance` snapshot), `getSessionSpend(sessionId)` (one session's billed cost), and `getTodaySpend()` (every session's billed cost on the current Beijing-time calendar day). The spend prices each `assistant/message` event's billed tokens (cache-hit input, cache-miss input including cache writes, and output including reasoning) at the official rate of the event's own Beijing-time peak/off-peak hour, then sums per model.
-
-## Configuration
-
-| Field | Default | Meaning |
-| --- | --- | --- |
-| `apiKeyEnv` | `DEEPSEEK_API_KEY` | Credential-reference (environment-variable) name resolved per call. |
-| `baseURL` | `$DEEPSEEK_BASE_URL` then `https://api.deepseek.com` | Endpoint base; `/user/balance` is appended. |
-| `models` | V4 Flash + V4 Pro + V4 Flash Vision Exp | Advisory display rows, in presentation order. |
-| `billing.peakHours` | 09:00–12:00, 14:00–18:00 (Beijing) | Peak-hour windows; all other hours are off-peak. |
-| `billing.models` | Published V4 rates | Per-model peak/off-peak price rows (`cacheHitInput`, `cacheMissInput`, `output`, in CNY per 1M tokens). |
-
-Override one model without dropping the others by supplying a non-empty `billing.models` list; an empty or omitted list falls back to the published defaults.
-
-## Model Experience
-
-None, as this package is a read-only Remote projection of provider and session facts and touches no prompt, message, schema, stream, or tool result.
-
-#### KV Cache effect
-
-None; its only provider call is a credential-authenticated `/user/balance` read, which is not cached in the provider KV store.
-
-## Known Limitations and Deferred Work
-
-- **Priced rows only** — the session and today spends only price models that have a `billing.models` row; a model without a rate row is omitted.
-- **On-demand read** — the session spend reads the session's full event log on each call rather than maintaining an incremental aggregate, so cost grows with the per-session log size; `getTodaySpend()` reads every session's log, and a session whose log cannot be read is skipped with a warning instead of failing the whole day's total.

package/packages/llm-billing/README.zh.md

@@ -1,44 +0,0 @@
-# @rayadesu/dsh-llm-billing
-
-[English](README.md) | 中文
-
-独立的宿主插件，把 DeepSeek 账户余额与会话花费变成 `billing` Remote。它拥有 `/user/balance` 传输、峰谷计价表与每会话的计费花费计价，因此部署可以在不把这个能力与聊天补全适配器耦合的前提下，展示「还剩多少、这个会话花了多少」。浏览器侧是 [`dsh-client-ui-billing`](../ui-billing/README.md)。
-
-## 安装
-
-把插件加进组合（一个 `cordis.yml` 行）并给它一个凭据。它先从凭据 seam（或 `apiKeyEnv` 指定的环境变量）解析 API key，再从 `baseURL`、其次 `$DEEPSEEK_BASE_URL`、最后公共 API 解析端点。
-
-```yaml
-- id: llm-billing
-  name: '@rayadesu/dsh-llm-billing'
-  config:
-    # apiKeyEnv: DEEPSEEK_API_KEY   # default
-    # baseURL: https://api.deepseek.com
-```
-
-插件注册 `billing` Remote，含三个方法：`getBalance()`（解析后的 `/user/balance` 快照）、`getSessionSpend(sessionId)`（单个会话的计费花费）与 `getTodaySpend()`（当前北京时间自然日内所有会话的计费花费合计）。会话花费把每条 `assistant/message` 事件的计费 token（缓存命中输入、含缓存写入的未命中输入、含推理的输出）按事件自身发生时刻（北京时间）所在的峰/谷单价计价，再按模型汇总。
-
-## 配置
-
-| 字段 | 默认 | 含义 |
-| --- | --- | --- |
-| `apiKeyEnv` | `DEEPSEEK_API_KEY` | 每次调用时解析的凭据引用（环境变量）名。 |
-| `baseURL` | `$DEEPSEEK_BASE_URL`，其次 `https://api.deepseek.com` | 端点基础地址；会追加 `/user/balance`。 |
-| `models` | V4 Flash + V4 Pro + V4 Flash Vision Exp | 展示用的模型行，按展示顺序。 |
-| `billing.peakHours` | 09:00–12:00、14:00–18:00（北京） | 高峰时段窗口；其余时段为低谷。 |
-| `billing.models` | 官方 V4 费率 | 每个模型的峰/谷单价行（`cacheHitInput`、`cacheMissInput`、`output`，单位：元/百万 token）。 |
-
-只想覆盖某个模型而不丢其它，就提供一个非空的 `billing.models` 列表；空或省略则回退到官方默认费率。
-
-## 模型体验
-
-无，因为本包是 provider 与会话事实的只读 Remote 投影，不触及 prompt、消息、schema、流或工具结果。
-
-#### KV Cache effect
-
-无；它唯一的 provider 调用是一次带凭据的 `/user/balance` 读取，不落在 provider 的 KV 缓存里。
-
-## 已知限制与暂缓事项
-
-- **有费率行才计价** —— 会话花费与今日花费只统计价目表（`billing.models`）里有的模型；没有费率行的模型不计入。
-- **按需读取** —— 会话花费在每次调用时读取该会话的完整事件日志，而非维护增量聚合，因此成本随单会话日志大小增长；`getTodaySpend()` 会读取每个会话的日志，日志无法读取的会话带警告跳过，而不是让整日合计失败。