@dougen/dsh-deepseek-usage 0.1.3 → 0.1.4

package/README.md

@@ -1,27 +1,30 @@
 # @dougen/dsh-deepseek-usage
 
-DeepSeek 用量侧边栏插件（DeepSeek Harness Web UI）· 已发布到 npm：[https://www.npmjs.com/package/@dougen/dsh-deepseek-usage](https://www.npmjs.com/package/@dougen/dsh-deepseek-usage)
+DeepSeek 用量侧边栏插件（DeepSeek Harness Web UI）
 
 > **⚠️ 使用须知**
-> - 本插件界面文案仅提供**中文**（无多语言版本）。
-> - **仅适用于 DSH 的 Web UI**：卡片渲染在侧边栏底部的 `sidebar.footer.action` 槽位，命令行 / 桌面端等其他界面形态不支持。
+> - 本插件界面文案仅提供**中文**，无多语言版本。
+> - **仅适用于 DSH 的 Web UI**：命令行等其他非WEB界面不支持。
+> - **今日花费为本地估算值**（非官方账单）：按本地会话日志 token × 官方峰谷价格表计算。
 
 ## 简介
 
 给 DeepSeek Harness（DSH）**网页界面**用的插件：在**侧边栏底部**常驻显示你的 **DeepSeek 账号用量**卡片 —— 余额、今日花费、今日 Token、今日 API 请求次数与高峰/空闲计费时段指示灯。
 
-与动态插件不同，它是**正式的可安装 cordis 插件**：随 profile 组合启动，**刷新页面 / 重启服务后依然存在**。
+## 界面截图
+
+![DeepSeek 用量卡片](screenshot.png)
+
+侧边栏底部常驻卡片：余额、今日花费、今日 Token、今日 API 次数、峰谷状态灯与当前档单价。
 
 ## 功能
 
 - 第一行：`余额 ¥110.00`
-- 第二行：`今日 ¥2.94 · 36.9M · 170`（今日花费 / 今日 Token / 今日 API 请求次数，带图标）
-- 第三行：`↑1.5 · 💾0.05 · ↓4.5`（输入 / 缓存命中 / 输出 单价，按当前启用模型与峰谷时段自动切换）+ 右下角时间（刷新时显示旋转 ⟳ 图标，仅作刷新中的状态指示）
+- 第二行：`今日 ¥2.94 · 36.9M · 170`（今日花费为**本地估算**）
+- 第三行：`↑1.5 · 💾0.05 · ↓4.5`（输入 / 缓存命中 / 输出 单价，按当前启用模型与峰谷时段自动切换）
 - 右上角：高峰/空闲状态指示灯（高峰 9:00–12:00、14:00–18:00 为橙色；其余空闲为绿色；悬停提示时段）
 - 每 60 秒自动刷新；点击卡片任意位置也可手动刷新
-- 折叠 rail 态显示紧凑余额 + 状态灯
 - 跟随应用明暗主题（`--dsw-*` 变量，含兜底值）
-- 错误状态明确（未配置 Key / 网络失败 / 接口报错）
 
 ## 安装
 
@@ -33,7 +36,7 @@ dsh plugin --profile web add @dougen/dsh-deepseek-usage
 
 > 包声明了 `dsh.bundle`，`dsh plugin` 会自动把它加入 profile 的 bundle 层。
 
-本地开发时也可以用 tarball 安装：
+本地开发时也可以手动安装：
 
 ```sh
 cd dsh-deepseek-usage
@@ -41,13 +44,12 @@ pnpm pack                                       # 生成 dougen-dsh-deepseek-usa
 dsh plugin --profile web add <生成的 .tgz>
 ```
 
-> 注意：不要用目录路径 `dsh plugin add <目录>`——pnpm 会以 link 方式安装，包的真实路径在工作区外，ESM 无法解析到 peer 依赖（`@deepseek-ai/dsh-*`）。务必安装 npm 包或 tarball（真实拷贝进 profile 的 node_modules）。
 
 安装之后：
 
 1. 重启网页应用：`dsh web`（bundle 层在启动时读取）。
 2. 打开 http://127.0.0.1:3080 。
-3. 侧边栏底部（Cordis 面板按钮下方）即出现用量卡片，刷新页面也不会消失。
+3. 侧边栏底部（Cordis 面板按钮下方）即出现用量卡片。
 
 > 手动方式：把包放进 profile 的 `node_modules`，并在 `~/.dsh/profiles/web/cordis.patch.yml` 追加：
 >
@@ -62,48 +64,9 @@ dsh plugin --profile web add <生成的 .tgz>
 | 数据 | 来源 |
 |---|---|
 | 余额 | DeepSeek 官方 `GET /user/balance`（API Key 经凭证服务 `DEEPSEEK_API_KEY` 解析，不出本机） |
-| 今日花费 | ① 官方（优先）：配置 `DEEPSEEK_PLATFORM_TOKEN` 后走平台用量接口；② 估算（兜底）：本地会话日志 token × 官方峰谷价格表（估算值以 `≈` 前缀标识） |
+| 今日花费 | **本地估算**：本地会话日志 token × 官方峰谷价格表（非官方账单） |
 | 今日 Token / API 次数 | 本地会话日志统计（官方 API 无用量查询接口），覆盖全部会话，含重启前历史 |
 
-### 可选：官方今日消费（`DEEPSEEK_PLATFORM_TOKEN`）
-
-DeepSeek 官方 API 不提供用量查询接口，但平台控制台的用量页有同源接口。登录 https://platform.deepseek.com ，打开 DevTools → Console 执行：
-
-```js
-JSON.parse(localStorage.getItem('userToken')).value
-```
-
-把返回值存为凭证（例如追加到 `~/.dsh/.credentials.yaml`）：
-
-```yaml
-DEEPSEEK_PLATFORM_TOKEN: <令牌>
-```
-
-配置后卡片显示官方今日消费；令牌过期（或未配置）时自动回退为本地日志估算（带 `≈`）。
-
-## 工作原理
-
-| 部分 | 文件 | 作用 |
-|---|---|---|
-| Host 半 | `lib/index.js` | Cordis 插件（`inject: credentials, webServer`），注册 `GET /api/deepseek-usage`；解析余额、平台今日消费、本地日志用量统计（按 `message.source.model` + 事件时刻峰谷单价计价，20s 缓存） |
-| 定价 | `lib/pricing.js` | 官方价格表（2026-08-17 峰谷价：高峰半价为空闲），调整价格只改此文件 |
-| 浏览器半 | `lib/client.js` | `dsh.client` web 包，注册 `sidebar.footer.action` 槽位卡片，60s 轮询 |
-| 组合层 | `cordis.patch.yml` | `dsh.bundle` 补丁层，插入加载项 |
-
-## 开发
-
-```sh
-# 修改 lib/index.js / lib/client.js / lib/pricing.js 后重新打包安装：
-pnpm pack
-dsh plugin --profile web add <生成的 .tgz>
-# 重启 dsh web，硬刷新页面
-```
-
-发布新版本（`publishConfig` 已指向官方源并设为 public）：
-
-```sh
-npm publish
-```
 
 ## 卸载
 

package/lib/client.js

@@ -2,7 +2,7 @@
 //
 // 侧边栏底部用量卡片（注册进 `sidebar.footer.action` 槽位，独占一行，位于
 // Cordis 面板按钮下方）。轮询宿主路由 `/api/deepseek-usage`（见 lib/index.js）
-// 每 60 秒一次，点击卡片任意位置可立即刷新；时间旁的 ⟳ 图标仅作刷新中的状态显示。
+// 每 60 秒一次，点击卡片任意位置可立即刷新；右下角在刷新时显示旋转 ⟳ 图标，仅作刷新状态指示（无更新时间显示）。
 // 样式仅使用 `--dsw-*` 主题变量（含兜底值），跟随明暗主题。
 window.__ModuleLoader__.load({
 	id: "dsh-deepseek-usage",
@@ -40,12 +40,6 @@ window.__ModuleLoader__.load({
 			return String(parseFloat(n.toFixed(2)));
 		}
 
-		function fmtTime(ms) {
-			const d = new Date(ms);
-			const p = (x) => String(x).padStart(2, "0");
-			return `${p(d.getHours())}:${p(d.getMinutes())}`;
-		}
-
 		// 主题变量（带兜底值）
 		const C = {
 			bg: "var(--dsw-alias-bg-layer-1, rgba(127,127,127,.12))",
@@ -238,8 +232,7 @@ window.__ModuleLoader__.load({
 								title: "刷新中",
 							}, h("svg", { width: 11, height: 11, viewBox: "0 0 16 16", fill: "none", style: { animation: "dsh-usage-spin .8s linear infinite" } },
 								h("path", { d: "M13.5 8a5.5 5.5 0 1 1-1.6-3.9M13.5 1.5v3h-3", stroke: "currentColor", strokeWidth: 1.6, strokeLinecap: "round", strokeLinejoin: "round" })))
-							: null,
-						h("span", null, fmtTime(data ? data.updatedAt : Date.now())))),
+							: null)),
 				errs.length
 					? h("div", { style: { color: C.err, fontSize: 10, whiteSpace: "pre-wrap" } }, errs.join(" | "))
 					: null);

package/lib/index.js

@@ -10,8 +10,8 @@
  *     ok: true,
  *     balance: { available, total, currency, granted, toppedUp },   // 官方余额接口
  *     today: {
- *       cost,         // 今日花费：官方平台数据（配置 DEEPSEEK_PLATFORM_TOKEN 时），否则本地日志估算
- *       costSource: 'official' | 'estimate' | null,
+ *       cost,         // 今日花费：本地日志估算（日志 token × 官方峰谷价格表）
+ *       costSource: 'estimate' | null,
  *       tokens: { input, output, cacheRead, cacheWrite, total },   // 今日 token 数（本地日志）
  *       calls,        // 今日 API 请求数（本地日志）
  *       sessions      // 今日有活动的会话数
@@ -23,8 +23,8 @@
  *
  * 余额来自 DeepSeek 官方 GET /user/balance（API Key 经凭证服务解析，与
  * llm-deepseek 同一引用，不出本机）。今日 Token / API 次数只能从本地会话
- * 日志统计（官方无用量查询接口）；今日花费优先用官方平台 usage API
- * （需可选的 DEEPSEEK_PLATFORM_TOKEN），否则按日志 token × 官方价格表估算。
+ * 日志统计（官方无用量查询接口）；今日花费为本地估算：
+ * 日志 token × 官方峰谷价格表（见 lib/pricing.js）。
  */
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import { DEFAULT_MODEL, PEAK_HOURS_TEXT, costOf, isPeak, unitAt } from "./pricing.js";
@@ -36,13 +36,9 @@ const PUBLIC_BASE_URL = "https://api.deepseek.com";
 /** 与 llm-deepseek 适配器对齐的环境变量覆盖。 */
 const BASE_URL_ENV = "DEEPSEEK_BASE_URL";
 const API_KEY_REF = credentialRef("DEEPSEEK_API_KEY");
-/** 可选：平台会话令牌（platform.deepseek.com 的 userToken），解锁官方今日消费数据。 */
-const PLATFORM_TOKEN_REF = credentialRef("DEEPSEEK_PLATFORM_TOKEN");
 const BALANCE_PATH = "/user/balance";
 const ROUTE_PATH = "/api/deepseek-usage";
 const TIMEOUT_MS = 15000;
-/** 平台用量接口（控制台同源，可按月按日筛选）。 */
-const PLATFORM_USAGE_URL = "https://platform.deepseek.com/api/v0/usage/cost";
 /** 本地用量扫描的短缓存，避免多标签页/轮询反复解码全部日志。 */
 const USAGE_CACHE_MS = 20000;
 
@@ -61,14 +57,6 @@ function balanceUrl() {
   return `${base.replace(/\/+$/, "")}${BALANCE_PATH}`;
 }
 
-/** 本地日历日 `YYYY-MM-DD`（平台用量行按日期键控）。 */
-function localDate(d = new Date()) {
-  const y = d.getFullYear();
-  const m = String(d.getMonth() + 1).padStart(2, "0");
-  const day = String(d.getDate()).padStart(2, "0");
-  return `${y}-${m}-${day}`;
-}
-
 /** 容忍字符串/数字，返回有限数或 NaN。 */
 function toFinite(value) {
   if (typeof value === "number") return Number.isFinite(value) ? value : NaN;
@@ -79,49 +67,6 @@ function toFinite(value) {
   return NaN;
 }
 
-/** 取平台用量接口"今天"行的花费（官方），找不到返回 null。 */
-async function fetchPlatformTodayCost(token) {
-  const now = new Date();
-  const url = `${PLATFORM_USAGE_URL}?month=${now.getMonth() + 1}&year=${now.getFullYear()}`;
-  const response = await fetch(url, {
-    headers: {
-      Authorization: `Bearer ${token}`,
-      Accept: "application/json",
-      "x-app-version": "1.0.0",
-      Origin: "https://platform.deepseek.com",
-      Referer: "https://platform.deepseek.com/usage",
-    },
-    signal: AbortSignal.timeout(TIMEOUT_MS),
-  });
-  if (!response.ok) throw new Error(`DeepSeek 平台用量接口返回 HTTP ${response.status}`);
-  const body = await response.json();
-  const biz = body && typeof body === "object" ? body.data : void 0;
-  if (body?.code !== 0 || biz === void 0 || biz.biz_code !== 0) {
-    const code = body?.code ?? biz?.biz_code;
-    if (code === 40002 || code === 40003) {
-      throw new Error("DEEPSEEK_PLATFORM_TOKEN 已过期：请重新登录 platform.deepseek.com 并更新 userToken");
-    }
-    throw new Error(`DeepSeek 平台用量接口错误 (code ${code ?? "unknown"})`);
-  }
-  const bizData = biz.biz_data;
-  const container = Array.isArray(bizData) ? bizData[0] : bizData;
-  const days = container && typeof container === "object" ? container.days : void 0;
-  if (!Array.isArray(days)) return null;
-  const today = localDate();
-  const entry = days.find((d) => d && d.date === today);
-  if (!entry || !Array.isArray(entry.data)) return null;
-  let total = 0;
-  for (const modelEntry of entry.data) {
-    if (!modelEntry || typeof modelEntry !== "object" || !Array.isArray(modelEntry.usage)) continue;
-    for (const u of modelEntry.usage) {
-      if (!u || typeof u !== "object") continue;
-      const value = toFinite(u.cost ?? u.amount);
-      if (Number.isFinite(value)) total += value;
-    }
-  }
-  return Math.round(total * 100) / 100;
-}
-
 /** 本地今日零点（unix ms）。 */
 function startOfTodayMs() {
   const d = new Date();
@@ -230,17 +175,6 @@ function apply(ctx) {
             errors.push(`余额获取失败: ${error instanceof Error ? error.message : String(error)}`);
           }
 
-          // ---- 今日花费：官方平台数据（可选令牌）----
-          let costOfficial = null;
-          try {
-            const platformHit = await ctx.credentials.resolve(PLATFORM_TOKEN_REF);
-            if (platformHit !== void 0) {
-              costOfficial = await fetchPlatformTodayCost(platformHit.value);
-            }
-          } catch (error) {
-            errors.push(`官方今日消费获取失败: ${error instanceof Error ? error.message : String(error)}`);
-          }
-
           // ---- 今日 token / API 次数 / 花费估算（本地日志）----
           const usage = await scanTodayUsage(ctx);
           if (!usage.usable) errors.push(usage.error ?? "今日用量统计不可用");
@@ -254,8 +188,8 @@ function apply(ctx) {
           } catch {}
           const unit = unitAt(model, now);
 
-          const cost = costOfficial !== null ? costOfficial : (usage.usable ? usage.cost : null);
-          const costSource = costOfficial !== null ? "official" : (usage.usable ? "estimate" : null);
+          const cost = usage.usable ? usage.cost : null;
+          const costSource = usage.usable ? "estimate" : null;
 
           sendJson(res, 200, {
             ok: true,

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@dougen/dsh-deepseek-usage",
-  "version": "0.1.3",
-  "description": "DeepSeek 用量侧边栏插件：余额（官方 API）、今日花费（官方平台数据或本地日志估算）、今日 Token 与 API 次数（本地日志）、高峰/空闲时段指示灯。",
+  "version": "0.1.4",
+  "description": "DeepSeek 用量侧边栏插件：余额（官方 API）、今日花费（本地日志估算，带 ≈ 标识）、今日 Token 与 API 次数（本地日志）、高峰/空闲时段指示灯。",
   "type": "module",
   "main": "lib/index.js",
   "files": [
     "lib",
     "cordis.patch.yml",
-    "README.md"
+    "README.md",
+    "screenshot.png"
   ],
   "exports": {
     ".": "./lib/index.js",