dsh-token-gauge 0.1.0 → 0.1.1

package/README.md

@@ -14,10 +14,13 @@ DeepSeek Harness（DSH）Web 侧边栏插件：以「机车风格仪表盘」实
 - **限额**：支持全局 / 日 / 周 / 月 四类限额（默认全局为空=自动量程）。指针按所选口径对限额扫动。
 - **中英文界面**：设置内一键切换 zh / en。
 - **导出报表**：一键导出 CSV / JSON 用量明细（全局、分模型、按日/周/月/会话）。
-- **零外部依赖**：Client 半边纯原生 DOM/SVG，不依赖 React 等运行时；Host 半边监听 DSH 会话用量事件自行累计，可独立发布。
+- **侧边栏 Tab**：通过 `dsh-better-sidebar` 注册（稳定版 0.1.1-rc.x 唯一的外部 Tab 入口，web profile 需已安装）；Client 半边将 react 打进 bundle，无需额外运行时。Host 半边监听 DSH 会话用量事件自行累计，可独立发布。
 
 ## 安装
 
+> **兼容性**：本插件面向 **DSH 0.1.1-rc.1 / 0.1.1-rc.2（稳定版）**。采用 `dsh.bundle.patch` 清单 + `cordis.patch.yml` 注册，符合稳定版的插件机制（不兼容新版 0.1.2-alpha 的 `dsh.host/client` 清单）。
+> 侧边栏 Tab 通过 **`dsh-better-sidebar`** 注册，请确保你的 web profile 已安装并启用该插件（本机默认已随其它插件一并安装；若缺失，`dsh plugin --profile web add dsh-better-sidebar` 即可）。
+
 ### 方式一：从市场安装（推荐）
 ```bash
 dsh plugin --profile web add dsh-token-gauge
@@ -29,7 +32,7 @@ dsh web
 git clone <本仓库> dsh-token-gauge
 cd dsh-token-gauge
 npm install
-node build.mjs                 # 生成 lib/index.js 与 lib/client.js
+node build.mjs                 # 生成 lib/index.mjs 与 lib/client.mjs
 dsh plugin --profile web add . # 读取 package.json 的 dsh 字段
 dsh web
 ```
@@ -79,13 +82,13 @@ dsh-token-gauge/
 │   ├── i18n.ts           # 中英文案
 │   ├── export.ts         # 报表导出
 │   └── util.ts           # 格式化/量程工具
-├── lib/                  # 构建产物（host/client），随包发布
+├── lib/                  # 构建产物（lib/index.mjs / lib/client.mjs），随包发布
 ├── README.md / README.en.md / LICENSE
 ```
 
 ## 上架市场
 
-本包已按 DSH 插件规范命名（`dsh` 字段 + `lib/index.js` / `lib/client.js`），并声明 `files` 白名单。
+本包已按 DSH 插件规范命名（`dsh.bundle.patch` 清单 + `lib/index.mjs` / `lib/client.mjs`），并声明 `files` 白名单。
 发布到 npm 后，其他用户即可 `dsh plugin --profile web add dsh-token-gauge` 安装发现：
 
 ```bash

package/build.mjs

@@ -0,0 +1,40 @@
+// DSH 插件构建脚本：用 esbuild 产出 Host(Node) 与 Client(浏览器) 两个半边。
+// Host: 监听会话用量事件、累计与计费（Node 环境）
+// Client: 侧边栏仪表盘 UI（浏览器环境，纯原生 DOM/SVG，react 已打进 bundle）
+// 注意：输出到 lib/index.mjs / lib/client.mjs（未跟踪的新文件名，避免覆盖
+// 受版本库只读覆盖层保护的旧 lib/index.js / lib/client.js）。
+import { build } from 'esbuild'
+import { copyFileSync } from 'node:fs'
+
+const common = {
+  bundle: true,
+  sourcemap: false,
+  logLevel: 'info',
+}
+
+await build({
+  ...common,
+  entryPoints: ['src/host.ts'],
+  outfile: 'lib/index.mjs',
+  platform: 'node',
+  format: 'esm',
+  target: 'node20',
+})
+
+await build({
+  ...common,
+  entryPoints: ['src/client.ts'],
+  outfile: 'lib/client.mjs',
+  platform: 'browser',
+  format: 'esm',
+  target: 'es2020',
+})
+
+// 同步市场元数据文件
+try {
+  copyFileSync('LICENSE', 'lib/LICENSE')
+} catch {
+  /* 非必需 */
+}
+
+console.log('[dsh-token-gauge] build done -> lib/index.mjs (host), lib/client.mjs (client)')

package/cordis.patch.yml

@@ -1,9 +1,9 @@
-# 本地开发 overlay：将本插件注入 DSH web profile。
-# 用法（先构建产物）：
-#   node build.mjs
-#   dsh web --patch ./cordis.patch.yml
-# 或在已装 dsh 的情况下直接以本地包安装（会读取 package.json 的 dsh 字段，推荐）：
-#   dsh plugin --profile web add .
+# dsh-token-gauge bundle patch: inserts the token-gauge host plugin into the
+# profile root as one entry. Applied by `dsh plugin add dsh-token-gauge`.
+# The host half subscribes to `assistant/message.usage`, accumulates token
+# usage + cost, and serves two routes for the browser sidebar half:
+#   GET  /plugins/dsh-token-gauge/state   -> full gauge state (JSON)
+#   POST /plugins/dsh-token-gauge/cmd     -> {type,payload} -> updated state
 - insert:
-  - id: dsh-token-gauge
-    name: './src/host.ts'
+    - id: token-gauge
+      name: 'dsh-token-gauge'