@kidli1412/dsh-token-heatmap 0.1.2 → 0.1.3

package/README.md

@@ -21,7 +21,7 @@ A DeepSeek Harness web plugin: a GitHub-style daily token-usage heatmap of the *
 
 ## 安装 / Install
 
-需要 `web` profile（`@deepseek-ai/dsh >= 0.1.0-rc.6`）与 `pnpm`。
+需要 `web` profile 与 `pnpm`。DSH 兼容版本见下方「兼容性 / Compatibility」；运行于 `@deepseek-ai/dsh >= 0.1.2-alpha.4`（0.1.2 版本线）。
 
 从 npm 安装：
 
@@ -59,6 +59,12 @@ dsh plugin --profile web remove @kidli1412/dsh-token-heatmap
 - 无会话/无工作区时（`input.dock` 需要会话上下文）统计卡不渲染。
 - 服务端与客户端都随 `dsh web` 启动加载，因此新增/更新插件后需要重启。
 
+## 兼容性 / Compatibility
+
+- **DSH**：manifest 通过 `dsh.compatibility.dshReleases` 将官方最新三个版本 `0.1.2-alpha.4`、`0.1.2-alpha.5`、`0.1.2-rc.1` 逐项声明为 `compatible`（DSH STORE 的精确逐版本兼容证据；仅范围声明不会恢复上架）。插件使用的客户端注入（locale / runtime / ui-slots）与 Host 服务（`settings` namespace、`webServer` 精确路由）在这条版本线上保持稳定。
+- **Node**：`^22.19.0 || >=24.0.0`（与 DSH 一致）。
+- **依赖**：`@deepseek-ai/dsh-settings` 自 0.1.3 起提升为 `^0.1.2-rc.1`、`@deepseek-ai/schemastery` 提升为 `^3.18.2`，与 DSH 0.1.2 版本线对齐。npm 的 prerelease 解析规则下 `^0.1.0-rc.7` 不会解析到 `0.1.2-rc.1`（只会装 `0.1.0-rc.8`），因此较低的范围会拉到与新版 DSH 不同 train 的 settings 副本。
+
 ## License
 
 MIT。聚合与回环端点实现参考了 [dsh-usage-stats](https://github.com/Ychris12138/dsh-usage-stats)（MIT © Ychris12138）。

package/lib/index.js

@@ -37,7 +37,6 @@ import { join, dirname } from "node:path";
 import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
 import { applyUsageDelta, createUsageState, mergeInto, renderUsage, zeroBuckets } from "./usage.js";
 import { DEFAULT_CONFIG, parseConfig } from "./config.js";
-import { settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "@deepseek-ai/schemastery";
 
 /** Stable Cordis plugin name. */
@@ -56,8 +55,11 @@ const inject = ["webServer", "sessions", "sessionPersistence", "settings"];
  * namespace. The card edits `enabled` + `colorScheme` through the settings
  * scope; the legacy `<DSH_HOME>/storages/token-heatmap-config.json` document
  * is migrated once at startup (see migrateLegacyConfig).
+ * DSH 0.1.2 起 `@deepseek-ai/dsh-settings` 不再导出 settingsNamespace 帮助函数：
+ * namespace 直接以字面量传入（register/get/update 内部仍按
+ * /^[a-z][a-z0-9-]*$/ 校验）。
  */
-const SETTINGS_NAMESPACE = settingsNamespace("token-heatmap");
+const SETTINGS_NAMESPACE = "token-heatmap";
 
 /**
  * Durable display preferences; also the wire envelope the browser scope

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kidli1412/dsh-token-heatmap",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "DSH web plugin: GitHub-style daily token-usage heatmap on the new-session screen with a selectable calendar-year view, green/blue color schemes and a display switch (设置 → 插件 → 插件配置), plus today / this-month / all-time totals.",
   "type": "module",
   "main": "lib/index.js",
@@ -17,8 +17,8 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.7",
-    "@deepseek-ai/schemastery": "^3.18.1"
+    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.2"
   },
   "dsh": {
     "bundle": {
@@ -31,6 +31,13 @@
         "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-slots"
       ]
+    },
+    "compatibility": {
+      "dshReleases": {
+        "0.1.2-alpha.4": "compatible",
+        "0.1.2-alpha.5": "compatible",
+        "0.1.2-rc.1": "compatible"
+      }
     }
   },
   "scripts": {