dsh-spendingframe 0.2.2 → 0.2.4

package/README.md

@@ -1,4 +1,8 @@
-# DSHBalance
+# dsh-spendingframe
+
+[![npm](https://img.shields.io/npm/v/dsh-spendingframe?label=npm)](https://www.npmjs.com/package/dsh-spendingframe)
+[![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![node](https://img.shields.io/badge/node-%E2%89%A522-brightgreen)](package.json)
 
 **DeepSeek API 峰谷时段 · 会话消耗 · 今日花费，常驻在 DSH 输入框下方的一个小条目里。**
 
@@ -23,7 +27,7 @@ right next to DSH's context usage pill.
 - **今日花费**：北京时间自然日内的全部会话合计。
 - **跟随宿主**：颜色、字号、字体全部取用 DSH 自己的设计 token，跟随主题与字号设置。
 - **原生手感**：与同排的「上下文使用情况」同一套交互 —— 悬停出小气泡，点击出完整明细。
-- **零配置**：装好即用，每 5 分钟自动刷新，也随页面重新加载立即刷新。
+- **零配置**：装好即用，每分钟自动刷新，也随页面重新加载立即刷新。
 
 ## 交互
 
@@ -56,12 +60,12 @@ right next to DSH's context usage pill.
 
 ### 方式一：从 npm 安装（推荐）
 
-在 DSH 的插件管理里安装 `dsh-spendingframe`（版本 `^0.2.2`）；或者手工编辑当前 profile
+在 DSH 的插件管理里安装 `dsh-spendingframe`（版本 `^0.2.3`）；或者手工编辑当前 profile
 （`<DSH_HOME>/profiles/<profile>/package.json`）：
 
 ```jsonc
 {
-  "dependencies": { "dsh-spendingframe": "^0.2.2" },
+  "dependencies": { "dsh-spendingframe": "^0.2.3" },
   "dsh": { "profile": { "bundles": [/* …已有的 bundle… */, "dsh-spendingframe"] } }
 }
 ```
@@ -73,7 +77,7 @@ right next to DSH's context usage pill.
 1. 克隆仓库到任意目录（目录名随意，下文用 `<插件目录>` 指代）：
 
    ```sh
-   git clone https://github.com/JackyWadih14/DSHB.git DSHBalance
+   git clone https://github.com/JackyWadih14/dsh-spendingframe.git dsh-spendingframe
    ```
 2. 在 DSH 的插件管理里以**本地目录**安装它；或者把上面那段 `dependencies` 改成
    `{ "dsh-spendingframe": "file:<本目录的绝对路径>" }` 再 `pnpm install`。
@@ -171,7 +175,7 @@ right next to DSH's context usage pill.
 ```json
 {
   "ok": true, "at": 1791697077790, "peak": false, "window": "空闲时段",
-  "nextChangeInMs": 69721543, "version": "0.2.2",
+  "nextChangeInMs": 69721543, "version": "0.2.4",
   "session": {
     "found": true, "id": "session-79fa1914-…", "cost": 1.611052, "calls": 112,
     "tokens": { "hit": 12345, "miss": 6789, "out": 4321 }, "lastAt": 1791697070000,
@@ -213,6 +217,8 @@ npm run test:real # 额外读本机会话日志，断言真实血缘与金额（
 | 0.2.0 | 子智能体会话的花费并入父会话；悬停高亮与原生条目一致 |
 | 0.2.1 | 悬停只显示两项消耗与统计时间，完整明细改为点击弹出，对齐原生「上下文使用情况」；悬停延迟、明细色块等细节与原生一致 |
 | 0.2.2 | 发布到 npm：包名改为 `dsh-spendingframe`（原 `dshbalance` 被 npm 判定与已有的 `dsh-balance` 过于相似），只读路由随之改为 `/dsh-spendingframe/summary` |
+| 0.2.3 | 名字全仓统一为 `dsh-spendingframe`：源码目录、README 标题、面板页脚、日志前缀不再使用旧品牌名 |
+| 0.2.4 | 刷新间隔由 5 分钟缩短到 1 分钟（数据源是本地会话日志，落盘即带用量，所以缩短间隔真的能更快看到变化） |
 
 ## 许可
 

package/client/client.js

@@ -1,5 +1,5 @@
 /**
- * DSHBalance 客户端半（包名 dsh-spendingframe，手写的 __ModuleLoader__ 工厂包，无需构建步骤）。
+ * dsh-spendingframe 客户端半（手写的 __ModuleLoader__ 工厂包，无需构建步骤）。
  *
  * 作用：在会话输入框下沿的 `conversation.composer.dock`（“上下文占用”那一行）
  * 追加一个条目，排在上下文占用右侧，从左到右显示：
@@ -37,8 +37,14 @@ window.__ModuleLoader__.load({
     const name = 'dsh-spendingframe'
     /** 只依赖插槽服务。 */
     const inject = ['slots']
-    /** 刷新间隔：5 分钟。 */
-    const REFRESH_MS = 5 * 60 * 1000
+    /**
+     * 刷新间隔：1 分钟。
+     *
+     * 数据源是本地会话日志（`session.v4.jsonl.zstd`），每条 `assistant/message`
+     * 一落盘就带着 usage，所以这里只受轮询间隔限制；DeepSeek 开放平台账单页那个
+     * 「可能延迟 5 分钟」说的是它自己的统计服务，与本插件无关。
+     */
+    const REFRESH_MS = 60 * 1000
     /** 宿主路由。 */
     const ROUTE = '/dsh-spendingframe/summary'
     /** 悬停多久后浮出小气泡（原生 ContextMeter 的 Tooltip 用的是 delayMs: 200）。 */
@@ -351,7 +357,7 @@ window.__ModuleLoader__.load({
             .catch((error) => {
               if (!alive) return
               setStale(true)
-              console.warn('[DSHBalance] 读取失败：', error)
+              console.warn('[dsh-spendingframe] 读取失败：', error)
             })
         }
         load()
@@ -480,7 +486,7 @@ window.__ModuleLoader__.load({
             )),
           ),
           typeof data.version === 'string' && data.version !== ''
-            ? React.createElement('div', { style: panelFooterStyle }, `DSHBalance v${data.version}`)
+            ? React.createElement('div', { style: panelFooterStyle }, `dsh-spendingframe v${data.version}`)
             : null,
         ))
         : null

package/lib/index.js

@@ -1,7 +1,7 @@
 /**
- * DSHBalance 宿主半（包名 dsh-spendingframe）：把「高峰/空闲 + 会话花费 + 今日花费」暴露成一个只读 HTTP 路由。
+ * dsh-spendingframe 宿主半：把「高峰/空闲 + 会话花费 + 今日花费」暴露成一个只读 HTTP 路由。
  *
- * 客户端半（client/client.js）只负责显示：它每 5 分钟拉一次
+ * 客户端半（client/client.js）只负责显示：它每 1 分钟拉一次
  * `GET /dsh-spendingframe/summary?session=<会话 id>`，因此金额只在宿主算一次，
  * 浏览器不需要接触会话日志，也不需要自己维护价目表。
  *

package/lib/session-logs.js

@@ -8,7 +8,7 @@
  * 模型在 `data.message.source.model`。
  *
  * 这里只做两件事：把文件读成用量记录，并缓存解析结果（按 mtime + size 失效），
- * 这样每 5 分钟一次的轮询不会反复解压没变过的历史会话。
+ * 这样每分钟一次的轮询不会反复解压没变过的历史会话。
  */
 
 import { readFileSync, readdirSync, statSync } from 'node:fs'

package/lib/summary.js

@@ -206,4 +206,4 @@ export function buildSummary(options = {}) {
 }
 
 /** 与 package.json 保持一致的插件版本，随响应返回便于排查。 */
-export const VERSION = '0.2.2'
+export const VERSION = '0.2.4'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-spendingframe",
-  "version": "0.2.2",
-  "description": "DSHBalance：DSH 插件，在会话输入框下方、上下文占用右侧显示 DeepSeek API 高峰/空闲状态、会话消耗（含子智能体）与今日花费。",
+  "version": "0.2.4",
+  "description": "dsh-spendingframe：DSH 插件，在会话输入框下方、上下文占用右侧显示 DeepSeek API 高峰/空闲状态、会话消耗（含子智能体）与今日花费。",
   "license": "MIT",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -9,11 +9,11 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/JackyWadih14/DSHB.git"
+    "url": "git+https://github.com/JackyWadih14/dsh-spendingframe.git"
   },
-  "homepage": "https://github.com/JackyWadih14/DSHB#readme",
+  "homepage": "https://github.com/JackyWadih14/dsh-spendingframe#readme",
   "bugs": {
-    "url": "https://github.com/JackyWadih14/DSHB/issues"
+    "url": "https://github.com/JackyWadih14/dsh-spendingframe/issues"
   },
   "keywords": [
     "dsh",

package/tests/balance-probe.mjs

@@ -63,7 +63,7 @@ console.log('周一 17:00 距下一次切换 =', msUntilNextChange(bj('2026-10-1
 // --- 版本号与 package.json 一致 -------------------------------------------
 const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
 check('VERSION 与 package.json 一致', VERSION, pkg.version)
-check('package.json 已是 v0.2.2', pkg.version, '0.2.2')
+check('package.json 已是 v0.2.4', pkg.version, '0.2.4')
 
 // --- 本机真实数据（--real 才跑）-------------------------------------------
 const now = Date.now()

package/tests/client-harness-test.mjs

@@ -212,7 +212,7 @@ function textOf(node) {
 
 // --- canned payloads ------------------------------------------------------
 const peakPayload = {
-  ok: true, at: Date.parse('2026-10-12T02:00:00Z'), peak: true, window: '高峰时段', version: '0.2.2',
+  ok: true, at: Date.parse('2026-10-12T02:00:00Z'), peak: true, window: '高峰时段', version: '0.2.4',
   session: {
     cost: 0.434705, calls: 60,
     own: { cost: 0.3, calls: 57, tokens: { hit: 120000, miss: 4000, out: 900 } },
@@ -301,7 +301,7 @@ check('subagent row', rowMap['子智能体消耗'], '¥0.135（2 个会话 / 3
 check('today row', rowMap['今日消耗'], '¥1.21（2 个会话 / 91 次调用）')
 check('own token row', rowMap['本会话 Token'], '命中 120K / 未命中 4K / 输出 900')
 check('model row', rowMap['模型'], 'deepseek-flash ¥0.435（60 次）')
-contains('panel footer carries the version', textOf(footer), 'DSHBalance v0.2.2')
+contains('panel footer carries the version', textOf(footer), 'dsh-spendingframe v0.2.4')
 check('panel carries the full breakdown, not just the hover lines', [panelText.includes('今日消耗'), panelText.includes('计费时段'), panelText.includes('统计更新时间')], [true, true, true])
 
 // --- 4. dismissal ---------------------------------------------------------