dsh-token-usage-ledger 0.0.36 → 0.0.37
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +14 -0
- package/README.md +10 -0
- package/docs/token-usage-image01.png +0 -0
- package/docs/token-usage-image02.png +0 -0
- package/lib/index.d.ts +1 -1
- package/lib/index.js +1 -1
- package/package.json +4 -2
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,18 @@
|
|
|
3
3
|
版本号约定:`v0.0.<序号>`(纯 SemVer,**不带日期后缀**;历史条目里的 `-yyyyMMdd` 是旧格式,保留原样不会重复发布)。
|
|
4
4
|
`package.json` 的 `version` 写 SemVer 合法形式(`0.0.36`,不带 `v` 前缀)。任何变更只递增最后一位数字。
|
|
5
5
|
|
|
6
|
+
## v0.0.37 — 2026-11-13 18:17
|
|
7
|
+
|
|
8
|
+
**README 新增「效果预览」:两张真实界面截图,让 npm 页面和 dsh 插件详情页可以直接看到看板效果。**
|
|
9
|
+
|
|
10
|
+
- **截图**:`docs/token-usage-image01.png`(看板上半部分:累计卡片、使用效率、固定 365 天日历热力图、Token / 费用趋势)与 `docs/token-usage-image02.png`(缓存命中率趋势、调用与轮次效率、24 小时活跃、Agent 与时段)。
|
|
11
|
+
- **图片 URL 用绝对地址**:npm 页面不会按包内相对路径解析图片(没有 public 仓库可映射),因此 README 使用 jsDelivr 的 npm 文件 CDN:`https://cdn.jsdelivr.net/npm/dsh-token-usage-ledger@0.0.37/docs/...`。dsh 0.2.x 的插件详情页同样把 http(s) 图片按外链渲染,所以两处都能显示。
|
|
12
|
+
- **图片随包发布**:`package.json` 的 `files` 增加两张 PNG,`npm pack` 后由 jsDelivr 从 npm tarball 读取;不把 `docs/` 里的维护文档打进包。
|
|
13
|
+
- **布局**:两张图按上下顺序放在正文简介之后、功能列表之前,每张下面一行斜体说明,分别对应看板上半部分和下半部分;截图用深色主题,文字注明浅色主题同样适配。
|
|
14
|
+
- **发布顺序**:必须先 `npm publish` 0.0.37,jsDelivr 上 `@0.0.37` 的图片 URL 才存在;在此之前本地/旧版页面打开会看到破图。发布后可用 `Invoke-WebRequest -Method Head` 逐个核对两个 URL 返回 200。
|
|
15
|
+
- **验证**:`typecheck` 双 0、单测 **280/280**、`npm pack --dry-run` 文件清单包含两张 PNG 且不含 `src/`、`tests/`、`scripts/`、`docs/*.md`、sourcemap、`.tsbuildinfo`。
|
|
16
|
+
- **说明**:截图只包含 token 数量、费用、模型/接入方与时间分布,不含提示词、会话内容或工作区路径;产品代码与账本 schema 不变。
|
|
17
|
+
|
|
6
18
|
## v0.0.36 — 2026-11-13 03:17
|
|
7
19
|
|
|
8
20
|
**面向 npm 公共发布:包名改为 `dsh-token-usage-ledger`,README 拆成用户版(npm 页面 / 插件详情页)与维护手册,版本号改为纯 SemVer;产品行为不变。**
|
|
@@ -16,6 +28,8 @@
|
|
|
16
28
|
- **维护脚本同步**:`verify-ui.mjs` 的模块 id 改为从 `package.json` 读取;`setup_test_env.py` 的组合层断言、`install/uninstall/deploy_production.py` 的默认包名与旧包名迁移提示同步更新(检测到旧包名时会明确要求先卸载,不会在 profile 里留下两行相同 id)。
|
|
17
29
|
- **测试**:单测 **280/280**、`typecheck` 双 0;`npm pack --dry-run` 文件清单与 `npm publish --dry-run` 通过;隔离实例从打包产物安装并通过 UI 断言(见维护手册 §9)。
|
|
18
30
|
- **安装/发布**:离线包 `npm run build && npm run pack:install` → `dist/dsh-token-usage-ledger-0.0.36.zip`;npm 公共发布步骤见 `docs/002-20261113-npm发布手册.md`(需要维护者本人输入 2FA 验证码)。
|
|
31
|
+
- **已发布(2026-11-13 03:24,北京时间)**:`dsh-token-usage-ledger@0.0.36` 发布成功,`dist-tags.latest = 0.0.36`;首次发布产生的 `0.0.0-stage` 占位版本已按规范单独 deprecate(`latest` 未受影响)。
|
|
32
|
+
- **正式环境已切换(2026-11-13 03:32)**:完全退出应用 → 卸载旧包名 → 从 npm 安装 `dsh-token-usage-ledger@^0.0.36` → 重启;`runtime.json` 的 `pluginVersion` 为 `0.0.36`,`dataDir` 仍是 `~/.dsh/token-usage`,账本保留并继续追加(切换前 10,037,896 字节 → 切换后 10,039,380 字节)。旧包名在 `node_modules` 里还留有一个**符号链接**(不在 dependencies / `dsh.profile.bundles` / lock 中,不影响加载),按需用 `cmd /c rmdir "<路径>"` 摘掉即可。
|
|
19
33
|
- **升级注意**:正式环境若还装着旧包名 `dsh-plugin-token-usage`,必须**先完全退出应用 → 卸载旧包 → 安装新包 → 重启**;新旧包名不能同时存在(同一个插件会有两行相同的 `token-usage` id)。账本不受影响。
|
|
20
34
|
|
|
21
35
|
## v0.0.35-20261112 — 2026-11-12 21:42
|
package/README.md
CHANGED
|
@@ -7,6 +7,16 @@
|
|
|
7
7
|
|
|
8
8
|
它会在每一轮对话结束后,自动把这一轮消耗的 token 与折算费用记到本地账本里,并在 dsh 侧栏提供一个看板:累计用量、日历热力图、Token / 费用趋势、按模型与按工作区的明细。安装后不需要任何操作,聊过的每一轮都会自动记账。
|
|
9
9
|
|
|
10
|
+
## 效果预览
|
|
11
|
+
|
|
12
|
+

|
|
13
|
+
|
|
14
|
+
*看板上半部分:累计 Token / 费用 / 轮次、缓存命中率、固定 365 天的日历热力图,以及 Token 与费用趋势。顶部可切换工作区、接入方、模型、粒度和日期范围。*
|
|
15
|
+
|
|
16
|
+

|
|
17
|
+
|
|
18
|
+
*继续向下:缓存命中率趋势、调用与轮次效率、24 小时活跃时段、Agent 模式以及高峰 / 空闲占比。截图使用深色主题,浅色主题同样适配。*
|
|
19
|
+
|
|
10
20
|
---
|
|
11
21
|
|
|
12
22
|
## 功能
|
|
Binary file
|
|
Binary file
|
package/lib/index.d.ts
CHANGED
|
@@ -29,7 +29,7 @@ export declare const name = "token-usage";
|
|
|
29
29
|
* Plugin version, kept in sync with `package.json` by
|
|
30
30
|
* `tests/manifest.test.mjs`.
|
|
31
31
|
*/
|
|
32
|
-
export declare const PLUGIN_VERSION = "0.0.
|
|
32
|
+
export declare const PLUGIN_VERSION = "0.0.37";
|
|
33
33
|
/** Settings after normalization; every field has a usable default. */
|
|
34
34
|
export interface PluginSettings {
|
|
35
35
|
/** Ledger directory; `undefined` means `<dsh home>/token-usage`. */
|
package/lib/index.js
CHANGED
|
@@ -38,7 +38,7 @@ export const name = 'token-usage';
|
|
|
38
38
|
* Plugin version, kept in sync with `package.json` by
|
|
39
39
|
* `tests/manifest.test.mjs`.
|
|
40
40
|
*/
|
|
41
|
-
export const PLUGIN_VERSION = '0.0.
|
|
41
|
+
export const PLUGIN_VERSION = '0.0.37';
|
|
42
42
|
/** Default route prefix for the browser-facing JSON endpoint. */
|
|
43
43
|
const DEFAULT_API_PATH = '/dsh-token-usage';
|
|
44
44
|
/**
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-token-usage-ledger",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.37",
|
|
4
4
|
"description": "Token usage and cost ledger with a dashboard for DeepSeek Harness: per-turn ledger, 365-day heatmap, charts, filters, export/import and backfill.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.js",
|
|
@@ -21,7 +21,9 @@
|
|
|
21
21
|
"cordis.patch.yml",
|
|
22
22
|
"README.md",
|
|
23
23
|
"CHANGELOG.md",
|
|
24
|
-
"LICENSE"
|
|
24
|
+
"LICENSE",
|
|
25
|
+
"docs/token-usage-image01.png",
|
|
26
|
+
"docs/token-usage-image02.png"
|
|
25
27
|
],
|
|
26
28
|
"dsh": {
|
|
27
29
|
"bundle": {
|