dsh-token-usage-ledger 0.0.0-stage → 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 +1081 -0
- package/LICENSE +21 -0
- package/README.md +247 -2
- package/cordis.patch.yml +30 -0
- package/docs/token-usage-image01.png +0 -0
- package/docs/token-usage-image02.png +0 -0
- package/lib/client.js +4469 -0
- package/lib/host/aggregate.d.ts +132 -0
- package/lib/host/aggregate.js +840 -0
- package/lib/host/api.d.ts +118 -0
- package/lib/host/api.js +346 -0
- package/lib/host/backfill.d.ts +54 -0
- package/lib/host/backfill.js +265 -0
- package/lib/host/collector.d.ts +139 -0
- package/lib/host/collector.js +441 -0
- package/lib/host/ledger-io.d.ts +125 -0
- package/lib/host/ledger-io.js +211 -0
- package/lib/host/operation-error.d.ts +22 -0
- package/lib/host/operation-error.js +28 -0
- package/lib/host/paths.d.ts +35 -0
- package/lib/host/paths.js +63 -0
- package/lib/host/pricing-module.d.ts +112 -0
- package/lib/host/pricing-module.js +63 -0
- package/lib/host/pricing-modules/deepseek-2026-09-10.d.ts +31 -0
- package/lib/host/pricing-modules/deepseek-2026-09-10.js +67 -0
- package/lib/host/pricing-modules/index.d.ts +27 -0
- package/lib/host/pricing-modules/index.js +30 -0
- package/lib/host/pricing.d.ts +192 -0
- package/lib/host/pricing.js +287 -0
- package/lib/host/records.d.ts +47 -0
- package/lib/host/records.js +116 -0
- package/lib/host/runtime-marker.d.ts +67 -0
- package/lib/host/runtime-marker.js +71 -0
- package/lib/host/schema.d.ts +77 -0
- package/lib/host/schema.js +158 -0
- package/lib/host/store.d.ts +171 -0
- package/lib/host/store.js +337 -0
- package/lib/host/workspace-titles.d.ts +38 -0
- package/lib/host/workspace-titles.js +136 -0
- package/lib/host/zstd.d.ts +41 -0
- package/lib/host/zstd.js +134 -0
- package/lib/index.d.ts +82 -0
- package/lib/index.js +512 -0
- package/lib/shared/format.d.ts +415 -0
- package/lib/shared/format.js +714 -0
- package/lib/shared/protocol.d.ts +646 -0
- package/lib/shared/protocol.js +129 -0
- package/package.json +87 -4
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,1081 @@
|
|
|
1
|
+
# CHANGELOG — dsh-token-usage-ledger
|
|
2
|
+
|
|
3
|
+
版本号约定:`v0.0.<序号>`(纯 SemVer,**不带日期后缀**;历史条目里的 `-yyyyMMdd` 是旧格式,保留原样不会重复发布)。
|
|
4
|
+
`package.json` 的 `version` 写 SemVer 合法形式(`0.0.36`,不带 `v` 前缀)。任何变更只递增最后一位数字。
|
|
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
|
+
|
|
18
|
+
## v0.0.36 — 2026-11-13 03:17
|
|
19
|
+
|
|
20
|
+
**面向 npm 公共发布:包名改为 `dsh-token-usage-ledger`,README 拆成用户版(npm 页面 / 插件详情页)与维护手册,版本号改为纯 SemVer;产品行为不变。**
|
|
21
|
+
|
|
22
|
+
- **包名**:npm 上的 `dsh-plugin-token-usage` 已被别人的包占用(2026-08-19 由其他账号发布),继续用原名会发布失败,也会让用户装错。改为 `dsh-token-usage-ledger`(2026-11-13 查证 npm 上未被占用)。
|
|
23
|
+
- **内部标识全部不变**:插件 id、patch 行 id 仍是 `token-usage`,账本目录仍是 `<dsh home>/token-usage/`,端点前缀仍是 `/dsh-token-usage`,备份格式仍是 `dsh-token-usage-backup`,`~/.dsh/token-usage/records.jsonl` 与用户配置**无需迁移**;变的只有 npm 包名(以及由包名派生的浏览器模块 id)。
|
|
24
|
+
- **README 拆分**:`README.md` 改写为面向普通 dsh 用户的版本(安装/更新/卸载、看板使用、数据与隐私、计价口径、可选配置、常见问题、已知限制、英文摘要),随 npm 包发布并显示在 dsh 插件详情页;原来给维护者看的安装/升级/排障长文移到 `docs/001-20261113-维护与交付手册.md`(`files` 白名单已排除 `docs/`,不会进 npm 包)。
|
|
25
|
+
- **npm 元数据**:`private: false`、`publishConfig.access=public`、`author`、`keywords`、`LICENSE`(MIT)与 `prepublishOnly`(typecheck + test);新增 `engines.dsh = ^0.2.2-rc.2` 作为 dsh 安装期准入(dsh 用 `semver.satisfies(..., {includePrerelease:true})` 判定,`0.2.2-rc.2`~`0.2.x` 放行,`0.3.0` 起拒绝)。发布包只含 `lib/`、`cordis.patch.yml`、`README.md`、`CHANGELOG.md`、`LICENSE`。
|
|
26
|
+
- **去掉 `peerDependencies.@deepseek-ai/cordis`**:插件运行时不 import 任何 `@deepseek-ai/*` 包(类型导入编译后消失),保留 peer 只会让 pnpm 在 profile 里多装一份宿主包;dsh 的兼容判定在存在 `engines.dsh` 时也不读 peer。
|
|
27
|
+
- **版本号**:`0.0.35-20261112` → `0.0.36`。旧格式是 SemVer 预发布版本,npm 公共包应使用稳定版本,避免版本工具把每次发布都当成预发布;`0.0.36 > 0.0.35-20261112`,dsh 的版本比较正常。
|
|
28
|
+
- **维护脚本同步**:`verify-ui.mjs` 的模块 id 改为从 `package.json` 读取;`setup_test_env.py` 的组合层断言、`install/uninstall/deploy_production.py` 的默认包名与旧包名迁移提示同步更新(检测到旧包名时会明确要求先卸载,不会在 profile 里留下两行相同 id)。
|
|
29
|
+
- **测试**:单测 **280/280**、`typecheck` 双 0;`npm pack --dry-run` 文件清单与 `npm publish --dry-run` 通过;隔离实例从打包产物安装并通过 UI 断言(见维护手册 §9)。
|
|
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 "<路径>"` 摘掉即可。
|
|
33
|
+
- **升级注意**:正式环境若还装着旧包名 `dsh-plugin-token-usage`,必须**先完全退出应用 → 卸载旧包 → 安装新包 → 重启**;新旧包名不能同时存在(同一个插件会有两行相同的 `token-usage` id)。账本不受影响。
|
|
34
|
+
|
|
35
|
+
## v0.0.35-20261112 — 2026-11-12 21:42
|
|
36
|
+
|
|
37
|
+
**工作区名称跟随 dsh 当前标题;重命名后旧名不再残留、也不会新旧两行并存。**
|
|
38
|
+
|
|
39
|
+
- **读取时解析**:汇总请求用 `ctx.workspaceRegistry.list()` 建 `规范化路径 → 当前 Workspace.title` 映射;对账本里唯一的工作区路径先直接匹配,必要时 `realpath` 回退;只对当前 host 形态路径做 realpath,避免 WSL `/mnt/...` 与 Windows 盘符路径互相误配。
|
|
40
|
+
- **聚合口径**:`workspaceGroupKeyOf` 优先当前标题,映射不到才回退账本里的 `workspaceLabel`;同一路径的历史记录和重命名后记录合并为一行;不同路径同标题继续按显示名合并,`paths[]` 保留原始路径。
|
|
41
|
+
- **筛选**:工作区筛选接受“当前标题”或“原始路径”;旧标题不再命中。已打开面板若停留在旧标题,下一次数据加载会自动清回“全部工作区”,并只对真实原始路径保留“(单路径)”选项。
|
|
42
|
+
- **不改变数据**:账本 schema、费用/token、导入/导出/补录、`SUMMARY_SCHEMA_VERSION` 均不变;不重写历史行。新增 `@deepseek-ai/dsh-workspace@0.2.2-rc.2` 仅类型 devDependency(运行时不 import)。
|
|
43
|
+
- **测试**:单测 **280/280**、隔离 UI **84/84**、typecheck 0;新增 Host 路径解析单测、旧/新名合并与筛选单测,以及探针重命名真实工作区后的 UI 断言(当前标题出现、旧 basename 不单独成行)。
|
|
44
|
+
- **设计记录**:`docs/plan/013-20261112-工作区名称跟随当前标题设计.md`;方案 B(记录 `workspaceId`,用于同路径重新登记/目录移动等未来需求)已在该文档 §10 记录。
|
|
45
|
+
- **安装**:`npm run build && npm run pack:install` → `dist/dsh-plugin-token-usage-0.0.35-20261112.zip`。
|
|
46
|
+
|
|
47
|
+
## v0.0.34-20261112 — 2026-11-12 18:50
|
|
48
|
+
|
|
49
|
+
**适配 dsh `0.2.2-rc.2`:重钉接口包、复核新机制事实、修正隔离 UI 侧栏断言;产品逻辑不变。**
|
|
50
|
+
|
|
51
|
+
- **基线**:`pluginCompat` → `{dshVersion: 0.2.2-rc.2, checkedAt: 2026-11-12}`;7 个接口包(`dsh-client-store`、`dsh-client-ui-{layout,renderer,sidebar,slots}`、`dsh-session`、`dsh-token-meter`)重钉到 `0.2.2-rc.2`,`@deepseek-ai/cordis` 对齐宿主 `4.1.0`;删除旧 tree 后干净重装并重建。
|
|
52
|
+
- **0.2.2 接口面复核(产品代码零改动)**:
|
|
53
|
+
- `session.append(inputs)` 批量追加:按顺序逐个发布,`session.seq`/`surface` 已含整批;本插件只按事件顺序折叠、不读 seq,采集不变。
|
|
54
|
+
- `session.header.parentSession` 语义收紧为「子代理的直接创建者」;本插件本来就只用 `origin` 区分主子会话,聚合口径不变。
|
|
55
|
+
- 侧栏 `sidebar.panellist` 新增官方「更多/取消固定」:注册 API 与 owner props 不变;入口可能被用户收起(不是加载失败),重新固定即恢复。
|
|
56
|
+
- 官方菜单改用新定位接口:本插件价格说明是面板内绝对定位、tooltip 跟随鼠标 `position:fixed`,不依赖官方菜单定位,无需迁移。
|
|
57
|
+
- 其余适配面(`session/event`、`webServer.register`、`connection.requestRejection`、`main`、`ctx.slots`、`layout.selectPanel`、主题 token、浏览器只 `require("react")`)逐项仍成立。
|
|
58
|
+
- **隔离 UI 断言**:0.2.2 的侧栏导航多了逐行「取消固定」与「更多」按钮,原「入口是 nav 最后一个按钮」断言会把它们算进入口而失败;改为按 `nav` 下的面板行容器计数(入口仍是最后一个面板行),并保留「工作区区域在导航下方」断言。
|
|
59
|
+
- **测试**:`typecheck` 双 0 错误;单测 **269/269**(含与官方 `deriveTurnTokenUsage` 的 2000 条随机日志对拍);隔离 UI **82/82**(0.2.2-rc.2 实例,端口 3094)。
|
|
60
|
+
- **安装**:`npm run build && npm run pack:install` → `dist/dsh-plugin-token-usage-0.0.34-20261112.zip`。
|
|
61
|
+
|
|
62
|
+
## v0.0.33-20261104 — 2026-11-04 07:35
|
|
63
|
+
|
|
64
|
+
**Agent 与时段改为三张可悬浮扇形图。**
|
|
65
|
+
|
|
66
|
+
- 三张同排卡片:
|
|
67
|
+
- **Agent 费用占比**(环形):中心累计费用;
|
|
68
|
+
- **Agent 轮次分布**(实心扇形):共享 Agent 配色,中心和费用图一致;
|
|
69
|
+
- **高峰 / 空闲调用**(环形):绿/橙独立配色,中心累计调用。
|
|
70
|
+
- 删除“按 Agent”“高峰/空闲”两张数值表与旁边的数值图例;图例只保留色点+名称。
|
|
71
|
+
- 悬停任一扇区弹出完整明细:
|
|
72
|
+
- Agent 费用:名称、费用、占比、轮次、调用、Token、缓存命中;
|
|
73
|
+
- Agent 轮次:名称、轮次、占比、调用、Token、费用、缓存命中;
|
|
74
|
+
- 高峰/空闲:时段、调用、占比、Token、费用。
|
|
75
|
+
- 扇区间隙/描边、hover 透明度、超过 5 类合并“其它”;说明浮层同步补充悬浮口径。
|
|
76
|
+
- **测试**:单测 269/269、隔离 UI 82/82、typecheck 0。
|
|
77
|
+
- **安装**:`npm run build && npm run pack:install` → `dist/dsh-plugin-token-usage-0.0.33-20261104.zip`。
|
|
78
|
+
|
|
79
|
+
## v0.0.32-20261104 — 2026-11-04 06:58
|
|
80
|
+
|
|
81
|
+
**模块说明从底部常驻文字改为标题栏说明按钮 + 浮层。**
|
|
82
|
+
|
|
83
|
+
- `调用与轮次效率`、`24 小时活跃时段`、`Agent 与时段` 三个模块:
|
|
84
|
+
- 标题栏右侧新增 `i` 信息按钮(与价格说明同尺寸/同风格);
|
|
85
|
+
- 点击弹出该模块的说明浮层,复用价格说明的不透明 popover 主题;
|
|
86
|
+
- 点击外部或再次点击按钮关闭;同一时间只开一个;支持 Escape。
|
|
87
|
+
- 删除三处底部常驻说明(`.dsh-tu-panel-note`),数据区更整洁。
|
|
88
|
+
- 说明内容保持不变:多次调用轮次含义、90% 轮次 ≤ 口径、24 小时按调用结算小时、Agent preset 中文名与高峰/空闲口径。
|
|
89
|
+
- **测试**:单测 269/269、隔离 UI 81/81;新增 3 个信息按钮/浮层内容/关闭/无底部说明断言。
|
|
90
|
+
- **安装**:`npm run build && npm run pack:install` → `dist/dsh-plugin-token-usage-0.0.32-20261104.zip`。
|
|
91
|
+
|
|
92
|
+
## v0.0.31-20261104 — 2026-11-04 06:25
|
|
93
|
+
|
|
94
|
+
**图表细节修复:零值缓存写入、Agent 布局、零数据日、缓存圆点。**
|
|
95
|
+
|
|
96
|
+
- **Token 悬浮提示**:只展示该柱中实际大于 0 的成分;DeepSeek 路由 `cacheWrite=0` 时不再显示“缓存写入”。底层字段 `tokens.cacheWrite` / `cost.cacheWrite` 仍在账本中保存,非零时会自动出现。
|
|
97
|
+
- **Agent 与时段布局**:改为左侧 Agent 费用环形图、右侧纵向排列「按 Agent」「高峰 / 空闲」两表;不再让只有 4 列的时段表独占整行。
|
|
98
|
+
- **零数据日**:费用柱状图移除 0 值柱的 1px 最小高度,与 Token 堆叠图一致完全空白;正数柱仍保留最小 1px 以免小值消失。
|
|
99
|
+
- **缓存命中率点**:从被横向拉伸的 SVG 圆改为 HTML 定位的 6px 圆点,任何宽度下都是圆形;低于纵轴下限的点仍用红色标记。
|
|
100
|
+
- **测试**:单测 269/269、隔离 UI 80/80;新增悬浮零值校验、Agent 布局、零柱高度、圆点几何断言。
|
|
101
|
+
- **安装**:`npm run build && npm run pack:install` → `dist/dsh-plugin-token-usage-0.0.31-20261104.zip`。
|
|
102
|
+
|
|
103
|
+
## v0.0.30-20261104 — 2026-11-04 05:58
|
|
104
|
+
|
|
105
|
+
**图表交互、缓存纵轴、Agent 文案与 24 小时活跃时段优化。**
|
|
106
|
+
|
|
107
|
+
- **Token 消耗合并构成**:删除重复的「每日 Token 构成」模块;Token 消耗改为缓存命中/未命中/写入/输出堆叠柱,鼠标悬停整根柱子一次展示合计、四类 token、占比、轮次与估算状态(小分段不再需要单独悬停)。
|
|
108
|
+
- **缓存命中率纵轴**:新增自适应轴(95%–100% / 90%–100% / 动态范围);95% 以下罕见低值(≤10% 样本)固定在底部并明确提示实际值,异常多时自动扩展,避免 99% 附近被压平。
|
|
109
|
+
- **Agent 与时段**:preset 显示中文(标准模式/极简模式/代码模式/创造模式/PTC 模式,未知保留原 id);删除“主会话/子代理”“结束原因”表,保留高峰/空闲;模块改名。
|
|
110
|
+
- **文案/阶梯**:`p90` 改为「90% 的轮次 ≤」;「多调用轮次」改「多次调用轮次」并解释;每轮耗时改为 `<1 分 / 1–5 分 / 5–15 分 / 15–30 分 / 30–60 分 / ≥60 分`;每轮调用次数改为 `1 / 2–10 / 11–20 / 21–50 / 51–100 / 100+`。
|
|
111
|
+
- **视觉**:费用柱状图改橙→红渐变;累计/效率卡片分组,新增分类色(顶部色条 + 淡色背景 + 同色数值);Token 构成图沿用分类色。
|
|
112
|
+
- **24 小时活跃时段**:新增 24 列彩色柱状图(本地时间),高度为模型调用次数,tooltip 展示调用/轮次开始/Token/费用;输出 `Analytics.hours: HourUsage[24]`,按当前 workspace/model/provider 筛选的全历史统计。
|
|
113
|
+
- **测试**:单测 **269/269**、隔离 UI **78/78**、typecheck 0;新增 `panel-cache-rate.png`、`panel-hours.png` 截图。
|
|
114
|
+
- **安装**:`npm run build && npm run pack:install` → `dist/dsh-plugin-token-usage-0.0.30-20261104.zip`。
|
|
115
|
+
|
|
116
|
+
## v0.0.29-20261104 — 2026-11-04 04:47
|
|
117
|
+
|
|
118
|
+
**基于账本已有字段扩展统计维度:缓存构成/趋势、调用与耗时效率、Agent/来源/结果/时段。**
|
|
119
|
+
|
|
120
|
+
- **新卡片(5 张)**:每轮调用中位/p90、最多调用次数、多调用轮次占比、轮次耗时中位/p90、会话数与平均轮次、每轮费用中位。
|
|
121
|
+
- **`Token 构成与缓存` 面板**:按当前日期范围/粒度堆叠展示缓存命中、未命中、缓存写入、输出;同一时间轴缓存命中率折线;区间命中/未命中/输出总量。
|
|
122
|
+
- **`调用与轮次效率` 面板**:每轮模型调用次数直方图(1/2–5/6–20/21–50/51–100/100+)、每轮耗时直方图(<10 秒…≥15 分)、调用/耗时摘要与会话统计。
|
|
123
|
+
- **`Agent、子代理与结果` 面板**:Agent 费用占比环形图、按 Agent 表(轮次/调用/Token/费用/缓存命中率)、主会话/子代理表、结束原因表、高峰/空闲表。
|
|
124
|
+
- **Host**:`SummaryResponse.analytics`(可选字段)新增 calls/durations/attemptBins/durationBins/sessions/agents/origins/reasons/windows;全部基于现有 `record`/`attempts[]`,沿用 workspace/model/provider 筛选语义;不改账本 schema、不改采集器。
|
|
125
|
+
- **兼容**:旧 Host 无 `analytics` 时新客户端不渲染新增面板;`SUMMARY_SCHEMA_VERSION` 不变,账本/备份/导入格式不变。
|
|
126
|
+
- **测试**:单测 **264/264**(新增 analytics 聚合、`formatDuration`、`bucketDaily.tokenBuckets`);隔离 UI **74/74**(新增卡片/缓存/效率/Agent 面板、analytics 与 totals 轮次一致性、无横向溢出;新增 3 张面板截图)。typecheck 0。
|
|
127
|
+
- **后续**:需要新增采集的数据(attempt 延迟/reported 标记、compaction 用量、工具/job 活动等)已整理到 `docs/plan/008-20261104-后续数据采集扩展路线.md`,本轮不实施。
|
|
128
|
+
- **安装**:`npm run build && npm run pack:install` → `dist/dsh-plugin-token-usage-0.0.29-20261104.zip`。
|
|
129
|
+
|
|
130
|
+
## v0.0.28-20261104 — 2026-11-04 03:47
|
|
131
|
+
|
|
132
|
+
**导出文件名改为当前时区的 `yyyyMMddHHmmss`;页面通知增加手动关闭。**
|
|
133
|
+
|
|
134
|
+
- **文件名**:`downloadBackup()` 不再用 `toISOString()`(UTC,且带 `T`/`-`),改为
|
|
135
|
+
`formatBackupTimestamp()`:优先浏览器当前 IANA 时区(`Intl.DateTimeFormat().resolvedOptions().timeZone`),
|
|
136
|
+
格式 `yyyyMMddHHmmss`;时区取不到/非法/`Intl` 不可用时回退 `Asia/Shanghai`(UTC+8)。
|
|
137
|
+
例:`token-usage-backup-20261104034707.json`。
|
|
138
|
+
- **通知关闭**:抽出统一的通知条(文本 + 右侧 `×`,`aria-label="关闭通知"`),接入三类通知:
|
|
139
|
+
操作 `info/success/error`、摘要加载失败、账本健康/降级警告。
|
|
140
|
+
- 成功/错误/健康通知**不自动消失**,由用户手动关闭;错误在下次失败时重新出现。
|
|
141
|
+
- 健康通知关闭状态按健康计数指纹记录:同一组问题在本次页面会话内不再反复出现,
|
|
142
|
+
出现新的坏行/写失败/截断等问题(计数变化)时重新出现;页面重开恢复显示。
|
|
143
|
+
- 通知条增加 `role=status/alert` + `aria-live`;关闭按钮有 hover/focus-visible 样式。
|
|
144
|
+
- 关闭首屏加载错误后,副标题显示「未读取到数据,请点刷新重试」,不会一直停留在「正在读取」。
|
|
145
|
+
- **测试**:单测 **259/259**(新增 `formatBackupTimestamp` 的时区/回退/午夜 h23/14 位用例);
|
|
146
|
+
隔离 UI **68/68**(新增导出文件名格式、手动关闭通知、导入结果关闭;旧 6 按钮/导入去重/补录预览回归)。
|
|
147
|
+
- **安装**:`npm run build && npm run pack:install` → `dist/dsh-plugin-token-usage-0.0.28-20261104.zip`。
|
|
148
|
+
|
|
149
|
+
## v0.0.27-20261104 — 2026-11-04 03:20
|
|
150
|
+
|
|
151
|
+
**新增数据导出/导入与历史/缺失补录按钮;账本首次出现写操作的 UI 入口。**
|
|
152
|
+
|
|
153
|
+
- **导出**:头部新增「导出全部数据(备份)」按钮(价格说明左边),`GET /api/export` 输出完整账本 JSON(格式 `dsh-token-usage-backup` v1,含版本/记录数/records),浏览器直接下载;不受列表 `maxRecords` 截断影响。
|
|
154
|
+
- **导入**:`POST /api/import` 接收备份文件;Host 逐条走现有 schema reader 校验,按 `(sessionId, turn)` 与现有账本及文件内部去重,只追加缺失记录;全量非法记录会拒绝整次导入(不写半份)。UI 选择文件后先展示记录数/隐私提示,确认才上传,返回新增/跳过重复计数。
|
|
155
|
+
- **补录**:新增「补录缺失数据」按钮;一个按钮两阶段(扫描预览 → 确认补录),复用从 `scripts/backfill-ledger.mjs` 抽出的 `src/host/backfill.ts`(CLI 与按钮共用同一实现)。同时覆盖:装插件前的历史、运行中漏记/报错但日志可还原的轮次;重复点击/并发安全,分叉副本按指纹跳过,无法判定的轮次在预览中如实计数。
|
|
156
|
+
- **安全**:数据端点沿用宿主信任围栏;POST 额外校验 JSON content-type、同源/Sec-Fetch-Site;无 CORS、`no-store`;导出/导入 64 MiB + 记录数上限;补录只扫描固定 `DSH_HOME/sessions`,不接受客户端路径;导入/补录/导出共享进程内操作锁(409 busy),只追加、不重写历史。
|
|
157
|
+
- **图标/样式**:三个新按钮与刷新/价格/关闭同一套 28px `.dsh-tu-icon-btn`;导出=托盘+下箭头,导入=托盘+上箭头,补录=数据库+加号(避免与刷新混淆)。
|
|
158
|
+
- **验证**:单测 **255/255**(新增备份格式/导入去重/外部追加/fingerprint;API 数据端点);隔离 UI **67/67**(新增 6 按钮几何/顺序、页面导出→重复导入、补录预览/取消);typecheck 0;真实会话日志 CLI dry-run 扫描 136 个日志正常。
|
|
159
|
+
- **安装**:`npm run build && npm run pack:install` → `dist/dsh-plugin-token-usage-0.0.27-20261104.zip`。
|
|
160
|
+
|
|
161
|
+
## v0.0.26-20261104 — 2026-11-04 01:30
|
|
162
|
+
|
|
163
|
+
**接入方与模型筛选改为层级级联,并按业务顺序把接入方放到模型之前。**
|
|
164
|
+
|
|
165
|
+
- **顺序**:筛选行改为 工作区 → **接入方** → **模型** → 粒度 → 范围。
|
|
166
|
+
- **级联**:模型下拉只列当前接入方下的模型;切换接入方时,若已选模型不属于新接入方则自动清空;选择模型时自动把接入方同步为该模型的 provider;切到「全部接入方」保留已选模型(模型本身已限定 provider)。正常操作下不会再出现「接入方 A + 接入方 B 的模型」这种空组合。
|
|
167
|
+
- **不变**:Host/API 仍独立接受 `provider` 与 `model`(旧客户端/手工调用不受影响),统计口径与账本未变;facets 仍基于全账本,只在前端做模型选项收缩。表格列顺序保持 `模型 / 接入方`(面板主维度是模型)。
|
|
168
|
+
- **验证**:单测 **243/243**(Host 无改动);隔离 UI **62/62**(新增:筛选字段顺序、模型选项随接入方收缩、切换接入方清空外来模型、选模型同步接入方)。
|
|
169
|
+
|
|
170
|
+
## v0.0.25-20261103 — 2026-11-03 23:43
|
|
171
|
+
|
|
172
|
+
**「按模型」新增接入方(provider)维度:同名模型分行可辨,并可按接入方筛选。**
|
|
173
|
+
|
|
174
|
+
- **表格**:「按模型」表新增「接入方」列(`provider` id),显示 `deepseek-official` / `deepseek-account` / `aliyun-bailian` 等;
|
|
175
|
+
同一模型 id 由不同接入方服务时分行显示(模型列 + 接入方列),悬停可看完整 `provider/model` 路由。此前两行都只显示模型名,看起来像重复数据。
|
|
176
|
+
- **筛选**:筛选行新增「接入方」(provider)下拉;模型下拉的选项也补上 `模型 · provider`,两个同名选项不再无法区分。
|
|
177
|
+
provider 与模型都是 **attempt 级**筛选(两者同时生效取交集),工作区仍是记录级;facets 始终基于全账本计算,不随当前筛选收缩。
|
|
178
|
+
- **接口**:`GET /api/summary` 新增可选 `provider` 查询参数;`filters.provider` 回显、`facets.providers` 新增;
|
|
179
|
+
`Facet` 增加可选 `provider`(模型 facet 携带);全部为向后兼容的增量字段。
|
|
180
|
+
- **数据口径不变**:`byModel` 仍在非空筛选下只统计匹配 attempt;接入方筛选下模型明细按匹配 attempt 重新分组(不会漏掉 provider 过滤)。
|
|
181
|
+
- **验证**:单测 243/243(新增同名模型 × 多 provider、provider 筛选、provider+model 交集用例);隔离 UI 60/60(新增 3 项:接入方列/同名分行、两个筛选都能区分 provider、接入方筛选生效)。
|
|
182
|
+
|
|
183
|
+
## v0.0.24-20261103 — 2026-11-03 23:04
|
|
184
|
+
|
|
185
|
+
**修复「费用是怎么算出来的」价格表:列对齐 + 字段顺序/名称。**
|
|
186
|
+
|
|
187
|
+
- **列对齐**:空闲行比高峰行少一个单元格(模型单元格用 `rowSpan=2` 跨行),原来用 `th:nth-child(2)/td:nth-child(2)` 定位「时段」列,导致空闲行的「时段/缓存未命中」整体左移一列、与高峰行不对齐。改为给时段单元格加 `dsh-tu-price-window` 类按类对齐(并单独覆盖首列 padding),高峰/空闲两行的「时段」左边缘与数值列右边缘现在一致。
|
|
188
|
+
- **字段顺序/名称**:表头与数值列统一为 **模型 / 时段 / 缓存命中 / 缓存未命中 / 输出**(缓存命中在缓存未命中之前,`未命中输入` 更名为 `缓存未命中`);公式与「缓存写入按…计价」说明同步改用「缓存未命中」措辞。
|
|
189
|
+
- **验证**:单测 242/242;`verify-ui.mjs` 新增一条断言(表头顺序 + 高峰/空闲行逐列左/右边缘对齐,容差 2px),隔离 UI 57/57;明暗主题与 popover 不透明断言保持通过。
|
|
190
|
+
- **打包布局**(2026-11-03 晚调整):独立安装包 zip 内目录固定为 `dsh-plugin-token-usage/`(版本号只在 zip 文件名与 package.json),
|
|
191
|
+
升级时完全退出应用后覆盖该目录内容、重开即可,profile 链接不变、无需重新「添加插件」;zip 仍按版本命名便于归档。
|
|
192
|
+
|
|
193
|
+
## v0.0.23-20261103 — 2026-11-03 21:28
|
|
194
|
+
|
|
195
|
+
**四项看板优化 + 基线纠正到实际运行的 dsh `0.2.1-rc.2`。**
|
|
196
|
+
|
|
197
|
+
- **入口迁移**:侧栏入口从 `sidebar.footer.action`(底部设置上方)迁到 `sidebar.panellist`(与「插件」「自动化任务」同一列表,order 20),落在**自动化任务下方、工作区上方**;组件改为纯图标(owner props `{size, active}`),按钮/选中态/无障碍名由侧栏提供(`aria-current="page"`),组件文件名 `sidebar-button.tsx` → `sidebar-entry.tsx`;标签文案改为 `Token消耗统计`。点击已选中入口保持面板打开(与内置两个入口一致),返回对话用看板 `×`。
|
|
198
|
+
- **价格说明弹窗**:同时展示**官方高峰价**与**按空闲倍率折算的空闲价**(折算值明确标注;无高峰时段时单行显示实际生效价;倍率 1 时单行「标准」);表头显示模型/时段;保留价目版本、官网来源、查询日期与本地覆盖说明。修复弹窗背景透明:不再使用 Windows 下 58%/45% 半透明的 `--dsw-specific-menu`,改用不透明 `--dsw-alias-bg-layer-1`,并加 `max-height` 内部滚动。
|
|
199
|
+
- **按模型**:聚合层跳过「空 model 且零用量」的 error attempt(它们仍计入累计轮次,不再生成 `(未标注模型)/0 token` 行);有 token 的未标注 attempt 保留。模型下拉不再出现与「全部模型」冲突的空值选项;「轮次」表头补充语义说明。
|
|
200
|
+
- **按工作区**:按 `workspaceLabel`(basename)合并同名工作区(WSL→Windows 迁移后的同一项目合并为一行);wire 增加可选 `paths[]`/`mergedCount`(原始路径、platform、各路径轮次/token/费用);表格行内「N 个路径」可展开查看明细并「只看此路径」精确筛选;筛选同时兼容合并 label 与原始路径。
|
|
201
|
+
- **故障隔离**:看板与侧栏图标各包一层渲染错误边界(fallback 只显示通用文案、不含错误栈);`fetchSummary` 先用 `isSummaryResponseLike` 校验响应容器;slot 注册失败被捕获,仅影响本插件。
|
|
202
|
+
- **基线纠正**:实测运行版本为 `0.2.1-rc.2`(CLI/注册表/asar 三方一致;原记录 0.2.0-rc.2 过时)。`pluginCompat` → `{dshVersion: 0.2.1-rc.2, checkedAt: 2026-11-03}`;7 个接口包 + `@deepseek-ai/cordis` 已对齐实际运行版本(临时副本验证 → 工作区干净重装 → typecheck 0 错误 → 重建产物 sha256 与验证构建一致)。修复 `dsh_env.installed_interface_versions()`:asar 里不再以独立目录出现的 `dsh-client-store`/`dsh-client-ui-slots` 回退到运行时版本,`install_production.py --dry-run` 在 0.2.1-rc.2 上不再误报中止。
|
|
203
|
+
- **验证**:单测 **242/242**(新增 10:幽灵 attempt 过滤、同名工作区合并/路径明细/原始路径兼容、turns 语义、响应结构校验);typecheck 双 0 错误;冻结真实账本只读对比 `allTime`/`totals`/`daily`/`health` 逐字段一致、`byModel` 9→8 行、`byWorkspace` 22→18 行(4 行 `mergedCount=2`);隔离 UI 断言 **56/56**(入口位次/aria-current、双列价格、popover 明暗 alpha=1、合并展开/单路径筛选、无幽灵行、错误边界不出现;顺手修掉热力图 1px 子像素横向滚动 —— 月份标签右对齐 + `heat-grid` 宽度收敛 1px);账本 sha256 未变。已知限制见 README §11。
|
|
204
|
+
- **知识库**:新增 `docs/12-upgrade-to-0.2.1-rc.2.md`;更新 docs/README 基线/索引/事实表、docs/01、docs/09、根 README、plugins/README、AGENTS、`design/CORE-LOGIC.md`。
|
|
205
|
+
|
|
206
|
+
## v0.0.22-20260929 — 2026-09-29 23:00
|
|
207
|
+
|
|
208
|
+
适配 **Windows 桌面版 dsh `0.2.0-rc.2`**(`profile` = `desktop`,`DSH_HOME` = `~/.dsh`),
|
|
209
|
+
并把整套维护工具从 Linux/WSL 口径搬到 Windows。
|
|
210
|
+
|
|
211
|
+
**结论:0.2.0-rc.2 没有破坏本插件依赖的任何接口面 —— 插件源码 0 处改动。**
|
|
212
|
+
|
|
213
|
+
- 唯一需要的改动是按运行版本重钉 7 个接口包:`0.1.7-rc.1` → **`0.2.0-rc.2`**(这次 CLI 与功能包同版本)。
|
|
214
|
+
- `pluginCompat` → `{dshVersion: 0.2.0-rc.2, checkedAt: 2026-09-29}`;插件版本 → `v0.0.22-20260929`。
|
|
215
|
+
- 隔离环境实测:一个会话里插件正常加载并记账,UI 断言 **48/48**(含暗色主题、热力图 365 天窗口、
|
|
216
|
+
价格浮层、关闭/重开),端点未带凭据 **401**、伪造 Host **403**、带 Cookie **200** —— 均与 0.1.x 一致。
|
|
217
|
+
|
|
218
|
+
**新确认的 0.2.x 机制事实**(细节见 `docs/11-upgrade-to-0.2.0-rc.2-windows-desktop.md`)
|
|
219
|
+
|
|
220
|
+
- **profile `desktop` 由应用独占**:`dsh --profile desktop …`(启动/导出)被直接拒绝
|
|
221
|
+
(`error: profile "desktop" is managed exclusively by the Electron application`),
|
|
222
|
+
但**桌面版自带的启动器** `<安装目录>\resources\runtime\cli\bin\dsh.cmd`
|
|
223
|
+
(走 `manageDesktopProfile: true`)**允许 `dsh plugin --profile desktop add|remove`**。
|
|
224
|
+
这就是 Windows 上安装/卸载唯一的正经入口。
|
|
225
|
+
- **运行时代码在 `app.asar` 里**:接口包不在磁盘上,`Get-ChildItem` 看不到,必须读 asar 才能拿到真实版本。
|
|
226
|
+
- **pnpm 的 link 在 Windows 上是 NTFS junction**,`Path.is_symlink()` 返回 `False`,
|
|
227
|
+
删它必须走 `rmdir` 语义(`shutil.rmtree` 会删掉链接指向的**插件源码**)。
|
|
228
|
+
- **`os.kill(pid, 0)` 在 Windows 上会直接终止进程**,绝不能当存活探针。
|
|
229
|
+
- **设置搬到了 profile 的 `cordis.patch.yml`**(`settings.yaml` 只是一次性遗留导入,导入后改名
|
|
230
|
+
`settings.yaml.imported`);家目录级 `~/.dsh/cordis.patch.yml` 是高优先级层,
|
|
231
|
+
在里面写 `- id: token-usage` / `disabled: true` 可在 **4 秒内热停用**插件,删掉即恢复(空文件也合法)。
|
|
232
|
+
- **0.2.x 新增「预览版说明」模态**,首次打开会盖住整页;它的确认是**与编译进构建的版本做相等比较**,
|
|
233
|
+
写死任何日期都不可靠 ⇒ 改为由 `verify-ui.mjs` 自行识别并点掉。
|
|
234
|
+
|
|
235
|
+
**工具链改动**
|
|
236
|
+
|
|
237
|
+
- 新增 **`scripts/dsh_env.py`**:跨平台公共层 —— 定位 `dsh` 启动器(显式 → `$DSH_CLI` → `PATH` →
|
|
238
|
+
注册表里的桌面版安装位置)、最小 **asar 读取器**(读真实功能包版本)、junction 感知的
|
|
239
|
+
`is_link`/`link_target`/`remove_link`/`same_location`、跨平台存活探测与端口归属
|
|
240
|
+
(`/proc` ↔ `netstat -ano`)、UTF-8 子进程解码(Windows 默认 cp936 会把正常输出炸成
|
|
241
|
+
`UnicodeDecodeError`)。自带 `python scripts/dsh_env.py` 冒烟自检。
|
|
242
|
+
- `setup_test_env.py`:`dsh` 解析、端口归属、停止进程、前台运行全部改走 `dsh_env`;
|
|
243
|
+
新增 `--skip-build`;不再用 `settings.yaml` 压制首屏公告(原因见上)。
|
|
244
|
+
- `verify-ui.mjs`:Chrome 候选补 Windows 路径并支持 `$CHROME_PATH`;修 `URL.pathname` 在
|
|
245
|
+
Windows 下拿不到盘符的 bug(改 `fileURLToPath`);`dismissOverlays` 改为**轮询一个稳定窗口**
|
|
246
|
+
而不是"一次没命中就返回"——预览版说明是在页面看起来就绪之后一个往返才挂载的,
|
|
247
|
+
原来会在很久之后表现为「分段按钮被遮罩盖住」的假失败。
|
|
248
|
+
- `install_production.py` / `uninstall_production.py` / `deploy_production.py`:默认值改
|
|
249
|
+
`--profile desktop` / `--port 19387`,`--dsh <路径>`,三态服务探测
|
|
250
|
+
(`RUNNING`/`STOPPED`/`UNKNOWN`,**查不到绝不当作"没在跑"**),junction 感知的链接判定与删除,
|
|
251
|
+
退出码 0/1/2 语义不变。
|
|
252
|
+
- `tests/manifest.test.mjs`:插件根路径断言改为按路径分段比较(原来断言 POSIX 形状的
|
|
253
|
+
`/plugins/token-usage/`,在 Windows 上必然失败)。
|
|
254
|
+
- `package.json`:`clean` 脚本改成跨平台(原 `rm -rf lib`);7 个接口包**精确 pin**(不带 `^`)。
|
|
255
|
+
|
|
256
|
+
**实测记录(隔离环境,未触碰正式服务)**
|
|
257
|
+
|
|
258
|
+
- 单测:`npm test` → **232 项全绿**(其中 1 项是本次修的 Windows 路径断言)。
|
|
259
|
+
- 隔离端到端:`setup` → `start` → `verify-ui.mjs` → **48/48**,并在全新浏览器 profile 下复现通过。
|
|
260
|
+
- 停用/恢复:家目录级补丁写入后 4 秒端点 401→404,删除后 4 秒恢复 401。
|
|
261
|
+
|
|
262
|
+
## v0.0.21-20260924 — 2026-09-24 02:13
|
|
263
|
+
|
|
264
|
+
**修:0.1.7-rc.1 换了会话日志文件名,历史回填因此静默失效**(装回后核对时发现)。
|
|
265
|
+
|
|
266
|
+
- **现象**:按 §2.5 装回、重启后跑 `backfill-ledger.mjs --since 2026-09-24 --write`,报告
|
|
267
|
+
`turnsBackfillable: 0` —— 卸载期间那几轮(含一轮 3,124 万 tokens)一条都没补进来。
|
|
268
|
+
- **根因**:dsh `0.1.7-rc.1` 把持久会话日志从 `session.v3.jsonl.zstd` 改成 **`session.v4.jsonl.zstd`**
|
|
269
|
+
(旧会话仍是 v3;跨升级的会话两个文件都在,v3 冻结在旧格式、v4 是整段会话的重编码)。脚本**只读 v3**,
|
|
270
|
+
于是新格式里的轮次完全看不见 —— 而且**不报错、不告警**,报告看起来一切正常。
|
|
271
|
+
- **修**:`SESSION_LOG_NAMES = ['session.v4.jsonl.zstd', 'session.v3.jsonl.zstd']`,逐个会话读**所有**
|
|
272
|
+
认识的版本(同一会话读到两份也安全:`(sessionId, turn)` 键与指纹双重去重)。
|
|
273
|
+
- **防复发**:遇到**不认识**的 `session.v<n>.jsonl.zstd` 时在 stderr 明确报警、退出码变 `2`
|
|
274
|
+
(报告里加 `logsUnknownFormat`),不再静默漏掉。
|
|
275
|
+
- **实测**:修复后 `--since 2026-09-24` 报 `turnsBackfillable: 1` → `--write` 写入 1 条
|
|
276
|
+
(session `session-9902098f…` 的 turn 5,结束 02:00:49,31,245,525 tokens / ¥1.302)→ 账本 200 → **201 条**、
|
|
277
|
+
`(sessionId, turn)` 零重复;再跑 dry-run 得 `turnsBackfillable: 0`(幂等)。另造一个
|
|
278
|
+
`session.v5.jsonl.zstd` 验证告警与退出码 2 生效。
|
|
279
|
+
|
|
280
|
+
**顺带记录两个 0.1.7 的实测事实**(不改变代码行为,已写进 README §8 与 docs/10)
|
|
281
|
+
|
|
282
|
+
- **用量桶变化**:升级后的轮次不再上报 `reasoningTokens`、改报 `cacheWriteTokens`
|
|
283
|
+
(可选桶,缺省即 0,费用口径不变)。
|
|
284
|
+
- **日志格式版本进文件名**:`session.v<n>.jsonl.zstd`;事件编码本身未变。
|
|
285
|
+
|
|
286
|
+
## v0.0.20-20260924 — 2026-09-24 01:49
|
|
287
|
+
|
|
288
|
+
适配 **dsh `0.1.7-rc.1`**(正式服务已由用户升级到该版本;本插件此前已按 §2.4 卸载)。
|
|
289
|
+
|
|
290
|
+
**结论:0.1.7-rc.1 没有破坏本插件依赖的任何接口面 —— 源码 0 处改动**
|
|
291
|
+
|
|
292
|
+
- 唯一需要的改动是按运行版本重钉 7 个接口包:`0.1.5-rc.2` → **`0.1.7-rc.1`**
|
|
293
|
+
(这次 CLI 与功能包**同版本**;`0.1.5-rc.1` 那会儿是 rc.2,所以每次都实测,见 §8 注)。
|
|
294
|
+
- `pluginCompat` → `{dshVersion: 0.1.7-rc.1, checkedAt: 2026-09-24}`;知识库基线与 `docs/README.md` 同步更新,
|
|
295
|
+
升级记录成文为 **`docs/10-upgrade-to-0.1.7-rc.1.md`**。
|
|
296
|
+
|
|
297
|
+
**运行时契约逐项实测(Inspect + 真跑,不是"看起来没变")**
|
|
298
|
+
|
|
299
|
+
| 面 | 实测 |
|
|
300
|
+
|---|---|
|
|
301
|
+
| Client 槽位 `sidebar.footer.action` | 在(list/root,ownerProps `{wide}`,标准 props 含 `usePanelInfo`)|
|
|
302
|
+
| Client 槽位 `main` | 在(keyed/root;已占用 `conversation`,新增官方 `plugins`)|
|
|
303
|
+
| Client 服务 `layout.selectPanel(id\|null)` | 在,签名不变 |
|
|
304
|
+
| Host 服务 `webServer.register(WebRoute)` | 在,`WebRouteKind = 'exact' \| 'prefix'` 不变 |
|
|
305
|
+
| Host 服务 `connection.requestRejection` | 在(鉴权围栏照旧)|
|
|
306
|
+
| 主题 token | 插件用到的 **18 个全部存在**(`--dsw-alias-bg-overlay` 由 `dsh-client-ui-theme` 运行时注入,
|
|
307
|
+
**不在静态 CSS 里** —— 只查 CSS 会误判缺失)|
|
|
308
|
+
| 事件与负载 | `tsc` 两面 0 错误;隔离实例真实模型调用被正确计价采集(账本 1787→1788 条)|
|
|
309
|
+
|
|
310
|
+
**验证矩阵**:`npm run typecheck` host+client 双 0 错误 · `npm test` **232/232** ·
|
|
311
|
+
隔离环境真启动(插件行进组合、两行启动日志正常、探针轮次入账)· `verify-ui.mjs` **48/48**(含明暗主题、
|
|
312
|
+
色阶单调、翻页、几何、无页面异常)。
|
|
313
|
+
|
|
314
|
+
**本次踩到的三个坑(都已修进工具)**
|
|
315
|
+
|
|
316
|
+
1. **重钉撞 peer 冲突**:`dsh-token-meter@0.1.7-rc.1` 的 peer 要求 `dsh-llm-retry@0.1.7-rc.1`,旧
|
|
317
|
+
`node_modules` 里是 rc.2 ⇒ npm `ERESOLVE` 拒绝。**重钉必须先删 `node_modules/` + `package-lock.json`**。
|
|
318
|
+
2. **`dsh` 从自己的环境解析 `DSH_HOME`**:只改脚本读写的路径,`dsh plugin` 会作用到**正式 profile**
|
|
319
|
+
(实测 pnpm 报的目录就是 `~/.dsh/profiles/web`)⇒ 私有时必须显式传 `DSH_HOME`。
|
|
320
|
+
3. **UI 断言量矩形要等布局稳定**(`verify-ui.mjs` 已修):点击分段按钮会触发取数 + 重绘,点后 60ms 取到的
|
|
321
|
+
rect 可能已过期,四个探针点落到别的(空文本)节点上 —— 表现为"选中态四边不完整"的**假失败**(0.1.7 上
|
|
322
|
+
复现一次、同条件复跑两次均通过,`elementsFromPoint` 显示四边最顶层就是按钮本身、边框均 1px)。
|
|
323
|
+
改成"连续两帧几何一致再量 + 按 label 重新解析节点",并把失败信息从 `textContent` 改成
|
|
324
|
+
`tag.class`(能直接看出压在按钮上的是什么)。
|
|
325
|
+
|
|
326
|
+
**新增**:`scripts/install_production.py` —— 一条命令装回正式环境(对齐运行版本 → 需要时干净重装 →
|
|
327
|
+
build/test → `dsh plugin add` → 验证依赖/组合层/软链 → `--check` 与缺口回填指引;退出码 0/1/2)。
|
|
328
|
+
|
|
329
|
+
## v0.0.19-20260924 — 2026-09-24 01:18
|
|
330
|
+
|
|
331
|
+
新增**一键卸载脚本** `scripts/uninstall_production.py`:升级 dsh 本体之前,把插件从正式 profile 干净摘掉。
|
|
332
|
+
|
|
333
|
+
**为什么需要脚本而不是一条命令**
|
|
334
|
+
|
|
335
|
+
- `dsh plugin --profile web remove <包名>` 只清 `dependencies` 与 `dsh.profile.bundles`;
|
|
336
|
+
它**不删** link 安装留下的软链(本机实测复现),也**不会立刻生效**(组合层在服务启动时组装)。
|
|
337
|
+
少做一步就会留下"以为卸干净了、其实还挂着"的假象。
|
|
338
|
+
|
|
339
|
+
**它做什么**
|
|
340
|
+
|
|
341
|
+
- 前置检查 → 备份账本与 profile 清单到 `<DSH_HOME>/backup/token-usage-uninstall-<时间戳>/`
|
|
342
|
+
(逐文件 sha256 校验 + `uninstall-report.json` 存档)→ `dsh plugin … remove` →
|
|
343
|
+
**复验清单确实干净之后**才删 `node_modules/` 里的软链(校验指向本插件目录,指向别处拒绝删;永不递归)
|
|
344
|
+
→ 验收(依赖/组合层/软链/**账本 sha256 未变**)→ 打印重启、验收与缺口回填指引。
|
|
345
|
+
- 检测到端口仍在应答就停下(退出码 2)并让你先停服务;确认发生在**任何写操作之前**
|
|
346
|
+
(非终端须显式 `--yes`,否则退出码 2 且磁盘零痕迹)。
|
|
347
|
+
- 绝不触碰账本内容、插件源码、dsh 服务进程。退出码:`0` 完成 / `1` 出错且已停在安全点 / `2` 需要人工动作。
|
|
348
|
+
|
|
349
|
+
**预演中发现并修掉的坑**
|
|
350
|
+
|
|
351
|
+
- `dsh` 从**自己的环境**解析 `DSH_HOME`:只改脚本读写的路径,会让 `dsh plugin remove` 作用到另一个 home
|
|
352
|
+
(实测:pnpm 的报错里出现正式 profile 目录)→ 子进程现在显式带 `DSH_HOME=<home>`,
|
|
353
|
+
并在 remove 之后复验清单、不符立即中止且不删软链。
|
|
354
|
+
- `.modules.yaml` 的 `"storeDir"` 是带引号带尾逗号的 JSON 形态,原正则把 `",` 一起吞掉 → 改为优先取引号内取值。
|
|
355
|
+
- `--store-dir` 与 profile 记录不一致时(pnpm 会以 `ERR_PNPM_UNEXPECTED_STORE` 拒绝)改为**动手前**告警。
|
|
356
|
+
|
|
357
|
+
**实测覆盖**(隔离 `DSH_HOME`,全程未触碰正式 3080)
|
|
358
|
+
|
|
359
|
+
- 端到端真卸载:依赖与组合层清空、软链删除、账本字节未变、备份三件套 + 报告齐全、退出码 0;
|
|
360
|
+
- 幂等:第二次运行识别为"已未安装"并安全跳过;
|
|
361
|
+
- 软链指向别处:拒绝删除并提示人工确认(软链原样保留);
|
|
362
|
+
- `dsh` 不可执行:退出 1,软链未删、依赖未动(安全点生效);
|
|
363
|
+
- 非终端未确认:退出 2 且**零写入**(连备份目录都没创建)。
|
|
364
|
+
|
|
365
|
+
**文档同步**
|
|
366
|
+
|
|
367
|
+
- §2.4 增加脚本用法、退出码与安全边界;§10 维护命令表增补一行。
|
|
368
|
+
- §2.5 修正"重装 devDependencies":原命令(`npm install`)只会按老 pin 重装,接口类型停留在升级前版本,
|
|
369
|
+
编译期发现不了变更 → 改为显式 `install --save-dev …@$V` 重钉 7 个接口包。
|
|
370
|
+
- §2.6 补两行陷阱:`ERR_PNPM_UNEXPECTED_STORE`、`dsh` 与脚本指向不同 home。
|
|
371
|
+
|
|
372
|
+
## v0.0.18-20260914 — 2026-09-14 10:35
|
|
373
|
+
|
|
374
|
+
按用户要求去掉两处文字(都属于「常驻说明」,影响观感)。
|
|
375
|
+
|
|
376
|
+
**① 去掉顶部「部分轮次的价格为估算值…」提示**
|
|
377
|
+
|
|
378
|
+
- 账本一旦回溯到价格表最早生效行之前(本机就是 2026-09-08 那批),这个提示会**永久存在**,从信号退化成噪音。
|
|
379
|
+
- 信息没有丢,只是从横幅移到具体位置:**估算的柱子仍然画得更淡**,悬停会说明具体原因;
|
|
380
|
+
`attempts[].estimatedReason` 逐条留痕;价格说明浮层里写明了估算口径。
|
|
381
|
+
- 其余健康提示全部保留(无法解析的行、写入失败、待写入、币种不一致、记录数超上限)——那些是真问题,
|
|
382
|
+
而且不会常驻。代码里留了注释说明这是**刻意的**,别再加回来。
|
|
383
|
+
- 顺带把「估算原因」的文案函数 `describeEstimate()` 从 `barchart.tsx` 移到 `shared/format.ts`(可单测),
|
|
384
|
+
并补 5 个断言(含「原因缺失/未知时给一句对三种原因都成立的话」)。
|
|
385
|
+
|
|
386
|
+
**② 去掉日历下方「账本自 X 起;X 之前的格子是『没有记录』…」**
|
|
387
|
+
|
|
388
|
+
- 账本比页面短是**正常状态**(新装/回填前的常见情形),格子本身是诚实的零值,悬停也会标「早于账本起点」,
|
|
389
|
+
所以这句话属于解释性冗余。
|
|
390
|
+
- **保留**另外两条覆盖提示(`dsh-tu-heat-note`):① 页面起点早于 payload 起点(有格子被隐藏,或已达读取上限);
|
|
391
|
+
② 页面尾部超出 payload(尚未取到)。这两条对应的是「payload 真的画不出这一页」——此时沉默会被读成
|
|
392
|
+
「没有消耗」,与「没取到」混淆,属于必须说的话。
|
|
393
|
+
|
|
394
|
+
**验证**
|
|
395
|
+
|
|
396
|
+
- 单测 **231 → 232 项全绿**;`typecheck` 通过。
|
|
397
|
+
- `verify-ui.mjs` 新增两条断言(**47 项**):日历在整页可绘制时**不得有任何 `.dsh-tu-heat-note`**、
|
|
398
|
+
页面上不得出现「之后的格子是「没有记录」」这句;以及顶部提示里不得出现「估算」(防止横幅被加回来)。
|
|
399
|
+
|
|
400
|
+
## v0.0.17-20260914 — 2026-09-14 09:55
|
|
401
|
+
|
|
402
|
+
修一处**估算价格的归因错误**:柱状图 tooltip 把所有估算都写成「含未知模型的估算价格」。
|
|
403
|
+
|
|
404
|
+
**为什么现在修**:用户准备用 `backfill-ledger.mjs` 回填历史,而那批轮次最早是 2026-09-08——
|
|
405
|
+
**早于价格表已知的最早生效行(2026-09-10 12:00 北京时间)**,它们的估算原因是
|
|
406
|
+
`before-first-known-price` 而不是「未知模型」。旧文案会把「这轮早于价格表」误说成「模型不在价目表里」,
|
|
407
|
+
而这正是回填之后立刻会在图上看到的东西。
|
|
408
|
+
|
|
409
|
+
**改法**
|
|
410
|
+
|
|
411
|
+
- `DailyPoint` / `BucketPoint` 增加可选 `estimatedReason`;Host 的 `Contribution` / `Accumulator` 也带上它。
|
|
412
|
+
- **只在「所有贡献方一致」时保留原因**:同一天/同一个桶里混了两种原因就置空——两种不同的保留意见不该被
|
|
413
|
+
总结成其中任意一种(Host 与前端各实现一次,规则一致)。
|
|
414
|
+
- tooltip 按原因给话:`unknown-model` → 「该模型不在价目表中,按兜底模型计价」;
|
|
415
|
+
`before-first-known-price` → 「该轮早于价格表已知的最早生效日」;`no-price-row` → 「该时段没有对应的价目行」;
|
|
416
|
+
原因缺失/不一致 → 「含估算价格(模型未知或早于价格表生效日)」(对三种原因都成立)。
|
|
417
|
+
- 看板顶部的整体提示本来就是对的(「未知模型走兜底价,或该轮早于价格表已知的最早生效日」),未改动。
|
|
418
|
+
|
|
419
|
+
**验证**:单测 **230 → 231 项全绿**(新增:原因随日→桶传递;两种原因混在一个桶里时 `estimatedReason` 为空);
|
|
420
|
+
`npm run typecheck` 通过(含 `exactOptionalPropertyTypes` 下的 `delete` 写法)。
|
|
421
|
+
|
|
422
|
+
## v0.0.16-20260914 — 2026-09-14 09:05
|
|
423
|
+
|
|
424
|
+
**部署核对不再需要启动 token**:Host 半在加载时写一个**启动标记**,`--check` 直接读它。
|
|
425
|
+
|
|
426
|
+
**起因**:v0.0.15 的 `--check --url '<dsh 启动 URL>'` 要用户把终端里打印的 URL(含一次性登录 token)复制出来;
|
|
427
|
+
在 Windows Terminal 里复制很容易误按 `Ctrl+C` 把服务打断(用户提出的问题)。而那个 token 只存在于终端回滚缓冲里,
|
|
428
|
+
脚本无法自行获取。
|
|
429
|
+
|
|
430
|
+
**做法**
|
|
431
|
+
|
|
432
|
+
- 新增 `src/host/runtime-marker.ts`:插件**加载时**在**自己的数据目录**写 `<DSH_HOME>/token-usage/runtime.json`
|
|
433
|
+
(`{schema, pluginVersion, pid, startedAt, dataDir, apiPath, pricing}`,0600),**卸载时删除**。
|
|
434
|
+
版本常量与 payload 上报的是同一个 `PLUGIN_VERSION`,因此标记与面板不可能不一致;写入失败只记一条日志
|
|
435
|
+
(绝不抛异常——它跑在 `apply()` 里,标记写不出来只是少了个便利,不该影响采集)。
|
|
436
|
+
- `deploy_production.py --check` 改为读该文件,**无 token、无 cookie、无 HTTP 也能判断**:
|
|
437
|
+
① 标记版本 vs `lib/` 里构建版本(直接回答"重启是否生效");② 路由是否应答(401=已挂载 / 404=没挂);
|
|
438
|
+
③ pid 只作为**参考信息**打印,**不参与判定**——pid 只在同一进程命名空间里有意义,把它当判据会在
|
|
439
|
+
容器/沙箱环境给出错误结论(开发中就踩到过)。
|
|
440
|
+
- `--url` 变成**可选**的 HTTP 交叉验证(有 token 时顺带读一次运行中服务上报的版本)。
|
|
441
|
+
- 未带标记但路由有应答时的提示说清楚:那是"该构建早于标记功能(v0.0.15 及更早)或 DSH_HOME 不同",
|
|
442
|
+
重启一次即进入 token-free 模式。
|
|
443
|
+
|
|
444
|
+
**验证**
|
|
445
|
+
|
|
446
|
+
| 场景 | 结果 |
|
|
447
|
+
|---|---|
|
|
448
|
+
| 单元测试 | **228 → 230 项全绿**:加载后标记存在且版本等于 `PLUGIN_VERSION`、卸载后被删除;标记写不出来时返回 false + 一条警告且不抛(用「把文件当目录」造确定性失败——注意某些沙箱里对 `/proc` 调 `mkdirSync` 会**卡住**而不是报错,测试因此不用那条路径) |
|
|
449
|
+
| A 标记版本 == 构建版本 | **OK**(退出码 0) |
|
|
450
|
+
| B 标记版本落后于构建 | 「the LOADED plugin is X, but the build here is Y」→ 退出码 **2** |
|
|
451
|
+
| C 没有标记、端口也没人监听 | 「plugin is not loaded in this home」→ 退出码 **2** |
|
|
452
|
+
| D 没有标记但路由有应答(401) | 明确说明「该构建早于标记功能(v0.0.15 及更早)或 DSH_HOME 不同」并提示重启一次 → 退出码 **2** |
|
|
453
|
+
| E 标记匹配、且端口上确有实例在跑 | **OK**(退出码 0) |
|
|
454
|
+
| (修)无人在监听时**不再中止** | 端口无人监听是「服务停了/端口不对」的正常状态,探测失败只作为注记,不改变判定(此前会把 `Connection refused` 当成脚本错误直接退出 1) |
|
|
455
|
+
|
|
456
|
+
**文档**:§2.8 改写为「先 `--check`(不需要 token)」,并说明那个 token 是什么、为什么脚本拿不到、
|
|
457
|
+
以及在 Windows Terminal 里安全复制的办法(鼠标选中 + `Ctrl+Shift+C`,别用 `Ctrl+C`)。
|
|
458
|
+
|
|
459
|
+
## v0.0.15-20260914 — 2026-09-14 08:10
|
|
460
|
+
|
|
461
|
+
新增**一键部署脚本** `scripts/deploy_production.py`:把「升级正式环境里的插件」里除了重启以外的步骤全部自动化
|
|
462
|
+
(用户要求:尽量减少手动操作)。插件运行代码不变。
|
|
463
|
+
|
|
464
|
+
**脚本做什么**
|
|
465
|
+
|
|
466
|
+
1. **预检**(只读 `~/.dsh/profiles/<profile>/package.json`):依赖里有本插件吗、在 `dsh.profile.bundles` 里吗、
|
|
467
|
+
是不是 **link 到本目录**;如果是 tarball/npm 安装,直接告诉你「重建无效,需 `dsh plugin add` 重装」。
|
|
468
|
+
2. **构建**:`npm install` → `npm run build` → `npm test`(228 项;`--no-test` / `--skip-install` 可跳过)。
|
|
469
|
+
3. **校验产物**:版本号从 **`lib/index.js` 里读**(不是 `package.json`——「`lib/` 是旧的」正是要抓的失败模式),
|
|
470
|
+
并确认 `lib/client.js` 存在。
|
|
471
|
+
4. **打印下一步**:重启命令、刷新页面、`--check` 用法、面板应显示的版本、账本路径(明确"重启只有你能做")。
|
|
472
|
+
5. **`--check`**:未带凭据探测插件路由(401=在跑 / 404=没挂);带 `--url`(dsh 打印的带 token 的 URL)时完成
|
|
473
|
+
cookie 握手并读运行中服务上报的 `pluginVersion`,与磁盘构建版本比对 →
|
|
474
|
+
**一致退出 0,不一致提示重启并退出 2**。退出码:0 正常 / 1 失败 / 2 待重启。
|
|
475
|
+
|
|
476
|
+
**边界**:不重启服务、不写 `~/.dsh`(写入只发生在插件目录内);`--profile`(默认 web)与 `--port`(默认 3080)可调。
|
|
477
|
+
|
|
478
|
+
**验证(实测,两个分支都跑过)**
|
|
479
|
+
|
|
480
|
+
| 场景 | 结果 |
|
|
481
|
+
|---|---|
|
|
482
|
+
| 构建分支(`--skip-install`,隔离环境) | 预检识别出 link 安装 → build → 228 项测试通过 → 报出产物版本 `0.0.15-20260914` → 打印三步指引 |
|
|
483
|
+
| `--check` 未带凭据(3080 未重启) | 路由返回 401 → 报「路由已挂载(缺路由会是 404)」+ 提示带 `--url` 可读运行版本 |
|
|
484
|
+
| `--check --url` 运行版本落后(隔离实例仍在跑 0.0.14,构建已 0.0.15) | 报「running 0.0.14-20260914, build 0.0.15-20260914」并提示重启,**退出码 2** |
|
|
485
|
+
| `--check --url` 重启后 | 报 **OK: the running service reports 0.0.15-20260914**,**退出码 0** |
|
|
486
|
+
|
|
487
|
+
**文档**:插件 `README.md` §2.8 改写为「一键脚本 + 只需你重启」(含脚本各阶段行为表、退出码语义、
|
|
488
|
+
手工等价操作与两种失败模式);§9 的维护命令表加入该脚本。
|
|
489
|
+
|
|
490
|
+
## v0.0.14-20260914 — 2026-09-14 07:40
|
|
491
|
+
|
|
492
|
+
补一节**「怎么升级插件本身」**的文档(用户提问:正式环境显示的还是旧版本,怎么升到最新代码)。
|
|
493
|
+
插件运行代码不变。
|
|
494
|
+
|
|
495
|
+
- `README.md` 新增 §2.8:本插件在正式环境是 **link 安装**,所以升级 = **重新构建 + 重启服务**,
|
|
496
|
+
不需要重新 `dsh plugin add`;并写明「只重建不重启 / 只重启不重建」各自会发生什么、
|
|
497
|
+
账本不受影响、怎么确认(面板头部 `v<版本>` + `grep PLUGIN_VERSION plugins/token-usage/lib/index.js`)、
|
|
498
|
+
以及拿到 tarball/npm 包时的替代步骤。
|
|
499
|
+
- 头部状态行的「装/停用/卸载」指引后面补了「升级插件本体看 §2.8」。
|
|
500
|
+
- 顺带把 §2.7(交付层)与 §2.8(升级)的先后顺序理正。
|
|
501
|
+
|
|
502
|
+
> 背景:正式环境显示 `v0.0.10` 是因为 Host 半的 `PLUGIN_VERSION` 与全部逻辑都在**服务启动时**载入,
|
|
503
|
+
> 而该服务是在 v0.0.10 构建之后启动的;此后 v0.0.11~v0.0.13 只改了文档/测试脚本,
|
|
504
|
+
> 功能上与 v0.0.10 相同,但要让面板显示新版本号仍需重建 + 重启一次。
|
|
505
|
+
|
|
506
|
+
## v0.0.13-20260914 — 2026-09-14 07:05
|
|
507
|
+
|
|
508
|
+
修 `setup_test_env.py` 的**停机不可靠**问题(用户实测:`stop` 说「not running (no pid file)」,而服务仍在端口上应答)。
|
|
509
|
+
插件运行代码不变。
|
|
510
|
+
|
|
511
|
+
**问题**
|
|
512
|
+
|
|
513
|
+
- 旧版 `stop` 只看 `.verify/server.pid`:文件不存在就直接报「没在跑」并返回,**不会去看端口上到底有没有人**;
|
|
514
|
+
而且它会在读完之后无条件删掉 pid 文件。真实场景:pid 文件被删(或它记录的 pid 属于另一个进程命名空间/已被回收),
|
|
515
|
+
服务继续监听 3093,`stop` 却坚称没在运行。
|
|
516
|
+
- 只看 pid 还有反向风险:pid 被系统回收后可能指向**无关进程**,照着它 `killpg` 会误杀。
|
|
517
|
+
|
|
518
|
+
**修法(`stop` 现在以「谁在监听端口」为准)**
|
|
519
|
+
|
|
520
|
+
1. 先读 pid 文件,但**核对 `/proc/<pid>/cmdline` 确实是 `dsh … --port <端口>`** 才发信号;对不上就报「pid 文件已过期」
|
|
521
|
+
并转入下一步(绝不朝未经核实的 pid 发信号)。
|
|
522
|
+
2. 扫描 `/proc`,找出命令行同时含 `dsh` 与 `--port <端口>` 的进程,`SIGTERM` → 5 秒内端口未释放再 `SIGKILL`。
|
|
523
|
+
3. **端口真空出来才删 pid 文件**,并打印停掉的是谁、靠什么找到的(如 `stopped 12345 (port scan)`);
|
|
524
|
+
端口仍被占着就报错退出(不谎报成功)。
|
|
525
|
+
4. 端口被**非 dsh 进程**占用时不动手,报错并给出 `ss -ltnp | grep <端口>` 的排查提示。
|
|
526
|
+
5. `start` / `run` 在端口已被占用时**直接拒绝启动**(此前会闷头启动再卡在读旧日志上)。
|
|
527
|
+
6. `status` 新增 `pid_file_state`(`match`/`stale`/`absent`)与 `listener_pids`,一眼看出「文件不可信但有人在监听」。
|
|
528
|
+
|
|
529
|
+
**验证**(用一个「绑定端口并 sleep」的假 dsh 在单次 shell 内驱动,四种情形都实测)
|
|
530
|
+
|
|
531
|
+
| 情形 | 结果 |
|
|
532
|
+
|---|---|
|
|
533
|
+
| 无 pid 文件 + 有监听 | `stopped <pid> (port scan)`,端口释放 |
|
|
534
|
+
| pid 文件指向无关的活进程 + 有监听 | 打印「treating it as stale」,**无关进程幸存**,真监听被停掉,pid 文件被清理 |
|
|
535
|
+
| 端口空闲 | `nothing to stop (no listener on port N)` |
|
|
536
|
+
| `start` 遇到被占端口 | 拒绝启动并提示先 `stop`(退出码 1) |
|
|
537
|
+
|
|
538
|
+
**文档**
|
|
539
|
+
|
|
540
|
+
- 插件 `README.md` §9:新增 `stop` 的判定规则、输出示例与「为什么不能只看 pid 文件」(附本次真实坑)。
|
|
541
|
+
- `plugins/README.md`「隔离测试环境」:新增**生命周期约定**表(status/stop/cleanup/start 的语义要求)。
|
|
542
|
+
- `docs/03`:新增「隔离实例的停止与清理」小节,含手动兜底 `ss -ltnp | grep <端口>` → `kill <pid>`。
|
|
543
|
+
|
|
544
|
+
## v0.0.12-20260914 — 2026-09-14 06:25
|
|
545
|
+
|
|
546
|
+
**定下 `deepseek-v4-pro` 的计费口径**(用户决定,仅文档;运行代码与 v0.0.11 相同)。
|
|
547
|
+
|
|
548
|
+
- 背景:官方页面此前自相矛盾 —— 新闻页称 2026-09-14 之后 V4-Pro 请求路由到 V4.1-Flash 并按 Flash 计费,
|
|
549
|
+
定价页脚注称继续提供、计费方式不变。
|
|
550
|
+
- **2026-09-14 用户确认:官方后续继续按当前价目执行,计费方式不变** ⇒ 插件按定价页(V4-Pro 用 V4-Pro
|
|
551
|
+
价格)计算即为正确,**价格模块不做任何改动**,也不需要重算历史。
|
|
552
|
+
- 文档同步:`README.md` §11 把「待复核」改写为「已定(含结论依据)」;`design/CORE-LOGIC.md` 的
|
|
553
|
+
「⏰ 当前待办」改为「已定」,并写明**这条结论来自部署方确认、不是重新读页面**,
|
|
554
|
+
因此 `provenance.checkedAt` 仍是上次实际核对页面的 **2026-09-13**(面板「查询日期」照实显示,不美化);
|
|
555
|
+
`design/DESIGN.md` §4 的括注同步。
|
|
556
|
+
- 若将来官方真的调价:按 CORE-LOGIC ② **追加**一行带 `effectiveFrom` 的价格(旧行保留),
|
|
557
|
+
再用 `scripts/recompute-cost.mjs` 干跑评估是否重算。
|
|
558
|
+
|
|
559
|
+
## v0.0.11-20260914 — 2026-09-14 06:05
|
|
560
|
+
|
|
561
|
+
**插件已装到正式环境(3080)**,并按当前实际情况把项目文档全面校准一遍。**本轮没有改运行代码**
|
|
562
|
+
(与 `v0.0.10` 相同的 `lib/`,只有文档与版本号变化)。
|
|
563
|
+
|
|
564
|
+
**正式环境安装(用户手动完成,2026-09-14)**
|
|
565
|
+
|
|
566
|
+
- `~/.dsh/profiles/web/package.json`:`dependencies` 含 `dsh-plugin-token-usage`(link 到本仓库),
|
|
567
|
+
`dsh.profile.bundles` = `[dsh-base, dsh-web-app, dsh-plugin-token-usage]`;用户 patch 层保持模板原样。
|
|
568
|
+
- 路由确认已挂载:未带凭据请求 `/dsh-token-usage/api/summary` → **401**(插件自己的响应头),
|
|
569
|
+
同源不存在路径 `/definitely-not-a-route` 与已归档插件的旧路由 → **404**。
|
|
570
|
+
- 账本 `~/.dsh/token-usage/records.jsonl` 尚未创建 —— 正常:`UsageStore` 懒创建,重启后第一条对话结束时才落盘。
|
|
571
|
+
- 历史回填(只读干跑):可回填 **93 轮**,`ledgerLinesBefore: 0`。
|
|
572
|
+
|
|
573
|
+
**文档校准(本轮全部改动)**
|
|
574
|
+
|
|
575
|
+
| 文档 | 改动 |
|
|
576
|
+
|---|---|
|
|
577
|
+
| `README.md`(插件) | 头部状态改为「已装到正式环境」;§2.2 增加正式环境实际状态与「账本为何暂时不存在」;§11 把 `deepseek-v4-pro` 定价复核窗口标成**已到期**并给出做法 |
|
|
578
|
+
| `docs/01`(本机事实) | 「关键路径」新增账本路径与懒创建说明;「组合层」树外 bundle 从「当前无」更新为 `dsh-plugin-token-usage`(含安装日期与停用/卸载入口) |
|
|
579
|
+
| `docs/09` | 新增 §7.4.2「怎么确认插件在正式环境里挂上没有」:**401 vs 404 对照探测**、懒创建、启动日志两行 |
|
|
580
|
+
| `docs/03` | §D 卸载章节基线更新为「已在 0.1.5-rc.1 复核」并指向插件手册(v0.0.10 已完成,本轮校对其余表述) |
|
|
581
|
+
| `docs/README.md` | 插件状态行、最近更新、新增两条事实索引(正式环境状态 / 探测方法) |
|
|
582
|
+
| `plugins/README.md` | 新增「交付到正式环境:每个插件 README 必须写清」的约定,以 token-usage §2 为参考实现 |
|
|
583
|
+
| `design/VERIFICATION.md` | §4 计数更新为当前值;新增 §7.9 正式环境安装的只读验证证据表 |
|
|
584
|
+
| `design/CORE-LOGIC.md` | ② 前置一条「当前待办:V4-Pro 定价复核窗口已到」与处理路径 |
|
|
585
|
+
| `AGENTS.md`、`README.md`(工作区) | 状态表:版本、计数、**已装到正式环境**、最近变更 |
|
|
586
|
+
|
|
587
|
+
## v0.0.10-20260914 — 2026-09-14 05:10
|
|
588
|
+
|
|
589
|
+
把「装到正式环境 / 升级 dsh 前怎么停用或卸载」写成可照着敲的操作文档(用户要求)。
|
|
590
|
+
|
|
591
|
+
**文档**
|
|
592
|
+
|
|
593
|
+
- `plugins/token-usage/README.md` §2 重写为操作手册:安装 4 步(build → `dsh plugin --profile web add
|
|
594
|
+
./plugins/token-usage` → `cat` profile 确认 `dependencies` + `dsh.profile.bundles` → **重启**)、
|
|
595
|
+
安装后改了哪些文件、可选的**历史回填**、**升级 dsh 前临时停用(patch 层三行,热生效)或彻底卸载**、
|
|
596
|
+
卸载验收命令、升级后重装、故障排查表、交付层说明。
|
|
597
|
+
- `docs/09` §7.4.1 记录 `dsh plugin` 的 CLI 层语义:它是 **pnpm 转发器**,跑完 pnpm 后按**安装状态**重算
|
|
598
|
+
`dsh.profile.bundles`(`remove` 后名字自动消失;反之「只删 bundles 名字」会被自动加回);相对路径锚定调用目录
|
|
599
|
+
(`add .` 会自链接 profile);`remove` 不删 link 软链且 `pnpm prune` 也不清;停用三行 + `patchReload: live` 热生效。
|
|
600
|
+
- `docs/03` §D 的基线从 0.1.2-rc.1 更新为**已在 0.1.5-rc.1 完整复核**,并指向插件 README 的逐步命令。
|
|
601
|
+
- 工作区 `README.md` 与 `AGENTS.md` §4 增加对应条目(含「dsh 升级前先停用/卸载」这条规则)。
|
|
602
|
+
|
|
603
|
+
**验证(2026-09-14 在隔离环境完整演练,未触碰正式 `~/.dsh`)**
|
|
604
|
+
|
|
605
|
+
| 步骤 | 实测结果 |
|
|
606
|
+
|---|---|
|
|
607
|
+
| 卸载 | `dsh plugin --profile web remove dsh-plugin-token-usage` → `dependencies` 清空、`dsh.profile.bundles` 自动变回 `[dsh-base, dsh-web-app]` |
|
|
608
|
+
| 卸载后启动 | 实例正常启动,boot 图里 **0 处** `token-usage` 引用(组合不再引用它,残留的 link 软链无害) |
|
|
609
|
+
| 停用(patch 层三行) | **不重启即生效**:端点 404、boot 图 0 引用;删掉三行后立即恢复 200 / 1 引用 |
|
|
610
|
+
| 重装 | `dsh plugin --profile web add ./plugins/token-usage` → 依赖与 bundles 恢复,UI 断言 **46/46** |
|
|
611
|
+
| 历史回填(正式 home 只读试跑) | `node scripts/backfill-ledger.mjs`(默认干跑)→ 本机当前可回填 **93 轮**、`ledgerLinesBefore: 0`,未写任何文件 |
|
|
612
|
+
|
|
613
|
+
## v0.0.9-20260914 — 2026-09-14 04:35
|
|
614
|
+
|
|
615
|
+
按用户提的两点:自定义区间允许「结束早于起始」的逻辑问题;费用说明里要能看到**当前官网价格与查询日期**。
|
|
616
|
+
|
|
617
|
+
**① 自定义日期区间:限制倒置 + 明确闭合语义**
|
|
618
|
+
|
|
619
|
+
- **语义先说清**:区间**首尾都包含**(closed interval,`起 ≤ 日期 ≤ 止`)。起 = 止 就是「只看这一天」,
|
|
620
|
+
近 7 天 = 今天−6 ~ 今天共 7 天,`filterRange` / `bucketDaily` 全部按 `>=` / `<=` 过滤。
|
|
621
|
+
这条约定写在 `resolveRange` 的文档里(此前没有一处明文写过),并给「起止日期」标签加了悬停提示。
|
|
622
|
+
- **三层防线**(缺一层就会退回原缺陷):
|
|
623
|
+
1. 日期选择器本身带约束:起始输入框 `max = 结束日期`,结束输入框 `min = 起始日期` —— 日历里根本选不出倒置区间;
|
|
624
|
+
2. 手动输入能绕过选择器(部分浏览器不拦),所以改一个框时若越界,**另一个框跟着移动**,
|
|
625
|
+
屏幕上两个值始终等于真实生效的区间;
|
|
626
|
+
3. `resolveRange('custom')` 作为纯函数兜底:倒置时**交换**两端(用户选的两个日期就是一个闭区间,
|
|
627
|
+
与输入顺序无关)。没有这一层,倒置会静默过滤掉全部数据、面板全空且没有任何报错。
|
|
628
|
+
- 单测:倒置交换、单日区间;UI 断言:`min`/`max` 属性存在、标签写明「含首尾」、
|
|
629
|
+
手动把「止」改成比「起」早的日期后两个框都变成该日期(「起」同理)。
|
|
630
|
+
|
|
631
|
+
**② 费用说明里展示官网价目表 + 查询日期**
|
|
632
|
+
|
|
633
|
+
- 原来只有公式、时段规则、来源链接和核对日期——**没有价格数字,读者无法核算**。
|
|
634
|
+
- `PricingProvenance`(payload)扩展为完整的「可解释信息」:`label`、`currency`、`unitTokens`、
|
|
635
|
+
`rows[]`(模型 × 未命中输入/缓存命中/输出 + 生效时刻)、`peakWindows`、`offPeakRatio`、
|
|
636
|
+
`timezoneOffsetMinutes`、`aliases`、`overriddenModels`;由 `provenanceOf(rule)` 从**当前生效的价格模块**生成,
|
|
637
|
+
因此面板不可能和计价逻辑各存一份价格。面板新增表格:
|
|
638
|
+
`官网价目(¥ / 百万 token,高峰时段)` + 两张模型行 + `空闲时段 ×0.5;高峰 09:00–12:00 / 14:00–18:00(UTC+8)`
|
|
639
|
+
+ `生效 2026-09-10 12:00;以上为 2026-09-13 查询到的官网价格,以官方页面与账单为准`。
|
|
640
|
+
- **只列官网价,不冒充**:若 `config.models` 覆盖了某模型价格,面板写明「本地配置覆盖了 X 的价格,上面这几行仍是官网价」。
|
|
641
|
+
- **顺手抓到一个自己写出来的真缺陷**:`peakWindows` 一开始把已按北京时间的整点**又加了一次 +8 小时**,
|
|
642
|
+
于是弹层里出现「高峰 17:00–20:00」而下一行的规则文字写着「09:00–12:00」——同一个小窗里两个互相矛盾的时间。
|
|
643
|
+
已修(`classifyWindow` 的语义就是要按 `peakOffsetMinutes` 平移后再读 UTC 小时,所以存储值本身就是当地时间),
|
|
644
|
+
并加测试:渲染出的窗口必须逐个出现在模块自己的规则文字里。
|
|
645
|
+
- 顺带把同名但不同形状的两个类型分开:模块自带的 `PricingModuleProvenance`(3 个字段:来源/核对日期/时段规则)
|
|
646
|
+
与 payload 的 `PricingProvenance`(完整说明),避免下次再 import 错一个。
|
|
647
|
+
- 单测:`rows` 必须等于当前纪元的价格数字、`peakWindows` 与规则文字一致、`overriddenModels` 正确上报、
|
|
648
|
+
`formatUnitPrice` 在 0.006 与 27 之间都能读。UI 断言:用交付的 `formatUnitPrice` 把**渲染出的表格**与
|
|
649
|
+
端点 payload **逐格比对**,并检查币种/单位/查询日期/高峰与倍率都出现在弹层里;另存 `panel-pricing.png`。
|
|
650
|
+
|
|
651
|
+
**验证**
|
|
652
|
+
|
|
653
|
+
- `npm test` **223 → 228 项全绿**(新增 `formatUnitPrice`、倒置区间归一、provenance 三例)。
|
|
654
|
+
- 隔离实例 UI 断言 **44 → 46/46**(新增倒置区间、价格表逐格比对两条)。
|
|
655
|
+
|
|
656
|
+
## v0.0.8-20260914 — 2026-09-14 04:00
|
|
657
|
+
|
|
658
|
+
按用户反馈**删掉筛选栏底部那行「当前筛选:…」说明文字**。
|
|
659
|
+
|
|
660
|
+
- 那行原本承担三件事:① 显示解析后的日期区间;② 本区间内的数据点/轮次;③ 说明「哪个筛选影响哪些数字」。
|
|
661
|
+
① 已经在两张柱状图的横轴标签上(如 `08-16 … 09-14`)、热力图工具栏里也有自己的区间;
|
|
662
|
+
② 在柱状图标题(`按天 · 合计 67M tokens`)与明细表里都有;③ 上一版已经写进四个控件的悬停说明。
|
|
663
|
+
所以这一行是重复信息,删掉后筛选框只留 4 个控件(间距同步收紧)。
|
|
664
|
+
- 顺手删掉只有它使用的 `describeRange()`(死代码)。
|
|
665
|
+
- `verify-ui.mjs` 把这条偏好钉成断言:筛选框内 `.dsh-tu-field` 恰好 4 个、`.dsh-tu-subtle` **0 个**,
|
|
666
|
+
防止以后又被加回来。
|
|
667
|
+
|
|
668
|
+
**验证**
|
|
669
|
+
|
|
670
|
+
- `npm test` **223 项全绿**;隔离实例 UI 断言 **44/44**(实测筛选框 `fields: 4, proseLines: 0`,
|
|
671
|
+
筛选行 bottom 126 < 卡片 top 161)。
|
|
672
|
+
|
|
673
|
+
## v0.0.7-20260914 — 2026-09-14 03:40
|
|
674
|
+
|
|
675
|
+
按用户反馈把**筛选栏移到累计卡片上方**,并把「哪个筛选影响哪些数字」写进控件本身。
|
|
676
|
+
|
|
677
|
+
**为什么移**
|
|
678
|
+
|
|
679
|
+
用户观察到的现象是对的:改 `工作区` / `模型` 时,**上面的累计卡片也会变**。原来的顺序是
|
|
680
|
+
「卡片 → 筛选栏 → 图表」,于是「被筛选的数字」排在「筛选控件」前面,读起来像倒装。
|
|
681
|
+
现在顺序是 **筛选栏 → 累计卡片 → 日历 → 柱状图 → 明细表**,符合「先设条件、再看结果」。
|
|
682
|
+
|
|
683
|
+
**顺便把作用域说清楚**(这是老版就有的、容易误解的地方):
|
|
684
|
+
|
|
685
|
+
- `工作区` / `模型`:影响**本面板全部统计**(累计卡片、图表、明细表)——label 的 `title` 写明。
|
|
686
|
+
- `粒度` / `范围`:**只影响柱状图**(热力图有自己的固定 365 天窗口 + 翻页)——label 的 `title` 写明
|
|
687
|
+
「只影响下面的柱状图;累计卡片与明细表为全历史,不随日期变化」。
|
|
688
|
+
- 筛选行下方那行说明保持原样(它本来就解释了这个分工),现在它位于卡片**上方**,读者先看到解释再看数字。
|
|
689
|
+
|
|
690
|
+
**验证**
|
|
691
|
+
|
|
692
|
+
- `npm test` **223 项全绿**(纯前端顺序与提示改动,未碰数据/计价逻辑)。
|
|
693
|
+
- 隔离实例 UI 断言 **43 → 44/44**:新增一条「筛选行必须在它所约束的数字上方,且四个 label 各自写明作用域」,
|
|
694
|
+
用 DOM 顺序(`compareDocumentPosition`)+ 几何位置 + `title` 文本三重判定,
|
|
695
|
+
实测筛选行 bottom=126 < 卡片 top=193。
|
|
696
|
+
|
|
697
|
+
## v0.0.6-20260914 — 2026-09-14 03:05
|
|
698
|
+
|
|
699
|
+
按用户新提的三项改看板:刷新按钮统一成图标按钮、日历自适应铺满整行(星期标签写全称)、
|
|
700
|
+
全范围柱状图不再溢出面板。
|
|
701
|
+
|
|
702
|
+
**① 刷新按钮与相邻按钮统一**
|
|
703
|
+
|
|
704
|
+
- 头部原来有 `i`(价格说明)与 `×`(关闭)两个 **28px 圆形图标按钮**,而刷新是一个文字按钮
|
|
705
|
+
(`dsh-tu-btn`),三者高矮、边距都不一样。现在刷新也是同款图标按钮:手绘环形箭头 SVG、
|
|
706
|
+
`aria-label="刷新数据"`、`title` 提示,加载中置 `data-busy="true"` + `aria-busy` + 禁用,
|
|
707
|
+
并有一个 `dsh-tu-spin` 旋转动画(`prefers-reduced-motion: reduce` 时不动)。
|
|
708
|
+
- `verify-ui.mjs` 断言头部三个按钮**尺寸与圆角完全一致**(实测都是 28×28 / `border-radius: 50%`)。
|
|
709
|
+
|
|
710
|
+
**② 日历:星期写全称 + 自适应铺满整行**
|
|
711
|
+
|
|
712
|
+
- 星期标签 `一/二/…/日` 改为 **`周一/周二/…/周日`**(不再需要读者猜)。
|
|
713
|
+
- 原来格子固定 14px + 3px 间隙,一年恒为 ≈898px:窗口一宽,右侧就剩一大片空白,
|
|
714
|
+
而它上面的「上一段 / 下一段」工具栏是满行的,看着不协调。现在**格子尺寸由行宽算出来**:
|
|
715
|
+
- `.dsh-tu-heat` 成为 CSS 容器(`container-type: inline-size`),列数由组件以内联
|
|
716
|
+
`--dsh-tu-cols` 传入;
|
|
717
|
+
- 一个变量 `--dsh-tu-cell = clamp(9px, calc((100cqw - 标签列 - 行间隙 - (列数-1)*列间隙) / 列数), 22px)`
|
|
718
|
+
同时喂给**星期标签的 7 行**和**日格子的 7 行**,两块因此不可能错位;
|
|
719
|
+
- 宽屏时取到上限 22px,多出来的宽度进入列间隙(格子在自己列里居中),整行仍然齐平;
|
|
720
|
+
- 窄屏时降到下限 9px,再窄就交给原有的横向滚动容器(标签列固定、只有网格滚动)。
|
|
721
|
+
- 不支持容器单位的浏览器由 `@supports (width: 1cqw)` 兜底回到固定 14px;图例色块在
|
|
722
|
+
`.dsh-tu-heat` 之外,用 `var(--dsh-tu-cell, 14px)` 的默认值保持原尺寸。
|
|
723
|
+
- 实测(1600px 窗口):格子 **14 → 17.8px**,网格 **898 → 1100px**,正好等于面板内容宽减去标签列与
|
|
724
|
+
行间隙;820px 窗口时格子落回 9px 并出现横向滚动,面板本身不溢出。
|
|
725
|
+
- 断言:标签文本必须是 `周一…周日`;格子尺寸落在 9–22px;网格宽度必须达到「填满」的目标宽度
|
|
726
|
+
(上限封顶时按封顶宽度算);窄窗口下必须真的出现滚动且面板不溢出。
|
|
727
|
+
|
|
728
|
+
**③ 全范围柱状图溢出面板(真实缺陷,不只是假数据)**
|
|
729
|
+
|
|
730
|
+
- 触发条件是「范围=全部 + 粒度=按天」:一年 ≈399 个柱子。CSS 里 `.dsh-tu-bar-col { min-width: 3px }`
|
|
731
|
+
加固定 2px 间隙,399 列最少要 **≈2000px**,于是柱子直接画到面板右边界之外
|
|
732
|
+
(合成账本只是把它暴露出来;任何用了几个月以上的真实账本都会遇到)。
|
|
733
|
+
- 修法:列 `min-width: 0`;间隙改为变量 `--dsh-tu-bar-gap`,按柱子数取 **2px / 1px / 0px**,
|
|
734
|
+
于是柱子永远**正好铺满整行**(实测 398 根:`scrollWidth == clientWidth`,间隙 0px,面板无横向溢出);
|
|
735
|
+
另加 `overflow: hidden` 作为兜底,确保以后即使再出问题也只会在面板内被裁掉,不会盖住别的模块。
|
|
736
|
+
- 柱子数 > 120 时在图下加一行说明「398 个数据点已排满整行;想看清单个柱子可切到「按周 / 按月」」
|
|
737
|
+
——**只提示,不偷偷改用户的粒度**。
|
|
738
|
+
- `verify-ui.mjs` 新增断言(用「全部 + 按天」实测):每个图表 `scrollWidth <= clientWidth + 1`、
|
|
739
|
+
面板根节点无横向溢出、提示文案存在,并额外抓一张 `panel-dense-chart.png` 作为该状态的视觉证据。
|
|
740
|
+
|
|
741
|
+
**独立审查(第三轮)后的修订**
|
|
742
|
+
|
|
743
|
+
本轮改动交给一个**未参与开发的独立审查者**只读审查(用仓库自己的样式在 `/tmp` 复刻页面并用无头 Chrome
|
|
744
|
+
实测)。8 条发现全部已修,逐条见 [`design/REVIEW-round3.md`](design/REVIEW-round3.md):
|
|
745
|
+
|
|
746
|
+
- 「铺满整行」的断言原本用了 `min(可用宽度, 上限宽度)`,宽屏下会接受一个**比行短 40px** 的网格 → 目标
|
|
747
|
+
改为「可用宽度 − 标签列 − 行间隙」(网格有 `min-width: 100%`,不可能更窄)。
|
|
748
|
+
- `--dsh-tu-cols` 为 0 时 `calc(长度/0)` 会让整块塌成 0 高(当前逻辑下到不了,但属隐患)→ 组件侧
|
|
749
|
+
`Math.max(1, 列数)`。
|
|
750
|
+
- 绘制范围很短时月份标签会离开自己那一列(53 列时偏移 <1px,短页可达 215px)→ 标签改为锚定格子。
|
|
751
|
+
- 密集柱状图的断言没测「间隙归零」(改回固定 2px 也通过)→ 现在断言 `gap === 0`;根节点溢出样本
|
|
752
|
+
也移到密集状态下采集。
|
|
753
|
+
- `prefers-reduced-motion` 下加载中只剩「图标略淡」→ 头部补一个 `role="status"` 的「正在刷新…」。
|
|
754
|
+
- 公式里的 8px 行间隙改为变量 `--dsh-tu-row-gap`;按钮家族断言改为钉住绝对值(28×28 / `border-radius: 50%`);
|
|
755
|
+
修正两处注释与刷新图标的旋转中心(墨迹盒偏上 0.7px)。
|
|
756
|
+
|
|
757
|
+
审查者在复刻页面上实测确认:容器查询语义正确(`cqw` 按消费元素解析)、标签行与日格行顶部完全对齐
|
|
758
|
+
(含 9px 下限与滚动中)、铺满后「网格 = 滚动区 = 1362px、最后一列齐平、根节点零溢出」、398 根柱子时
|
|
759
|
+
`clientWidth === scrollWidth` 且 `gap: 0`。
|
|
760
|
+
|
|
761
|
+
**另一处主动设计变更**:面板内容宽度上限 `.dsh-tu-shell` 从 **1180px 提到 1440px**。1180px 让日历在任何
|
|
762
|
+
宽屏上都只能到 1142px(空白留在 shell 之外,正是用户看到的「右侧一片空白」)。改回这个值即可回到旧观感,
|
|
763
|
+
其余逻辑不用动。
|
|
764
|
+
|
|
765
|
+
**验证**
|
|
766
|
+
|
|
767
|
+
- `npm test` **223 项全绿**(本轮纯客户端布局改动,未改数据/计价逻辑)。
|
|
768
|
+
- 隔离实例 UI 断言 **38 → 43/43**(新增 5 条:按钮家族一致、星期标签与铺满、全范围图表不溢出、
|
|
769
|
+
密集提示、视口宽度扫描)。
|
|
770
|
+
|
|
771
|
+
|
|
772
|
+
## v0.0.5-20260914 — 2026-09-14 02:05
|
|
773
|
+
|
|
774
|
+
按用户逐条提出的 9 项改看板:热力图改成**固定最近 365 天 + 翻页**、绿色深浅色阶、按钮与信息补齐。
|
|
775
|
+
|
|
776
|
+
**① 关闭按钮**
|
|
777
|
+
|
|
778
|
+
- 看板右上角新增 `×`(`aria-label="关闭统计面板,返回对话"`),点击即 `layout.selectPanel(null)`。
|
|
779
|
+
关闭后**中央列回到对话**,侧栏底部那条按钮**回到未选中态**(不再高亮);再点侧栏按钮即可重开,
|
|
780
|
+
因此关掉面板不会丢失任何入口。`verify-ui.mjs` 断言「关掉 → 面板消失、按钮重开 → 面板回来」。
|
|
781
|
+
|
|
782
|
+
**② 热力图改用绿色深浅(明暗主题各自成立)**
|
|
783
|
+
|
|
784
|
+
- 色阶只由主题的 success 族构成:`--dsw-alias-state-success-tertiary`(浅色主题是最淡的绿、深色主题是深绿)
|
|
785
|
+
→ 用 `color-mix(in oklab, …)` 与 `--dsw-alias-state-success-primary` 插出中间两级 → `primary` 作为最深一级。
|
|
786
|
+
**不写死颜色、也不写 `prefers-color-scheme` 分支**,明暗两套值由设计系统提供。
|
|
787
|
+
- 0 值仍然是中性灰(`--dsw-alias-label-secondary` 14%),与「有记录但很少」区分得开。
|
|
788
|
+
|
|
789
|
+
**③ 热力图独占一行**
|
|
790
|
+
|
|
791
|
+
- `.dsh-tu-heat-layout` 从「网格 + 统计块左右并排」改为**上下堆叠**,统计块(日均 Token / 单日最高 /
|
|
792
|
+
平均每轮 / 区间费用 / 连续使用)移到网格**下方单独一行**,并加一条分隔线。并排在一年宽度下会把网格挤窄。
|
|
793
|
+
|
|
794
|
+
**④ 固定 365 天 + 翻页(用户建议由实现方定,选翻页而非区间下拉)**
|
|
795
|
+
|
|
796
|
+
- `heatmapWindow()` 重写为**定长滚动窗口**:`HEATMAP_SPAN_DAYS = 365` 天、**结束于锚点日(默认今天)**,
|
|
797
|
+
起点回退到周一(整列成周)。此前起点固定锚在 `2026-08-13` 那一周并向右生长——几年后网格会有几米宽、
|
|
798
|
+
且每来一天整幅图就右移一格。现在格子尺寸恒定(53 列 ≈ 898 px),翻页负责时间轴。
|
|
799
|
+
- 新增 `← 上一段 / 下一段 → / 回到今天`:一次翻一页(365 天),`下一段` 在最新一段自动禁用,
|
|
800
|
+
`回到今天` 只在翻走后才出现。翻页边界来自 **payload 真正持有的首末日期**,因此不会画「没取到的日子」。
|
|
801
|
+
- 取数下限提到**整整一年**(`neededSpanDays()` 的 floor 从 API 默认 90 天改成 `HEATMAP_FETCH_DAYS = 371` 天,
|
|
802
|
+
含周一回退的 6 天余量):一年里每一格都是真实观测,而不是「没取到」被画成空白。
|
|
803
|
+
- 单元格新增 `data-date` / `data-outside` / `data-today`,把「没取到」和「当天没有消耗」在 DOM 里就分开。
|
|
804
|
+
- 面板里的说明文字同步改成实话:**两张柱状图跟随日期范围;热力图固定最近 365 天**(此前那句「热力图跟随
|
|
805
|
+
上述日期范围」从旧版起就不成立——热力图一直画的是未过滤序列)。
|
|
806
|
+
|
|
807
|
+
**⑤ 显示插件版本**
|
|
808
|
+
|
|
809
|
+
- 看板头部显示 `v0.0.5-20260914`(来自 Host 上报的 `pluginVersion`),`verify-ui.mjs` 用
|
|
810
|
+
`/^v\d+\.\d+\.\d+-\d{8}$/` 断言格式,`manifest.test.mjs` 断言它与 `package.json` 一致。
|
|
811
|
+
|
|
812
|
+
**⑥ 自定义区间默认填好日期**
|
|
813
|
+
|
|
814
|
+
- 选 `自定义` 时把 `至` 预填为今天、`起` 预填为「今天 − 29 天」(30 天窗口),两个框仍可编辑;
|
|
815
|
+
预填只在为空时发生,不会覆盖用户已经改过的值。`verify-ui.mjs` 用**真实输入事件**改日期并断言
|
|
816
|
+
图表真的跟着变成 7 列(`30 → 7`),而不是只看输入框有值。
|
|
817
|
+
|
|
818
|
+
**⑦ 选中态四边完整**
|
|
819
|
+
|
|
820
|
+
- 分段按钮组用 `margin-left: -1px` 合并相邻边框,副作用是**后一个按钮的左边框会盖住选中按钮的右边框**,
|
|
821
|
+
选中态看起来只有三边。修法:`.dsh-tu-group .dsh-tu-btn[data-active="true"] { position: relative; z-index: 1 }`。
|
|
822
|
+
- 截图看不出 1 px 的差别,所以这条**用几何断言测**:逐个点击每组按钮,在四条边内侧各取 1 px 做
|
|
823
|
+
`elementFromPoint` 命中测试,命中必须是自己(实测 9 个按钮全部通过)。
|
|
824
|
+
|
|
825
|
+
**⑧ 价格计算说明**
|
|
826
|
+
|
|
827
|
+
- 头部新增 `i` 按钮:悬停/点击弹出说明——公式(未命中输入 × 未命中价 + 缓存命中 × 命中价 +
|
|
828
|
+
缓存写入按未命中价 + 输出 × 输出价)、峰谷规则、当前计价模块与生效时刻、币种,以及「只计 provider
|
|
829
|
+
上报的用量、以官方账单为准」的口径。点击可钉住、点外部关闭。
|
|
830
|
+
|
|
831
|
+
**⑨ 侧栏按钮移到设置按钮上方**
|
|
832
|
+
|
|
833
|
+
- 席位从 `sidebar.panellist` 换到 **`sidebar.footer.action`**(官方描述「侧栏底部、设置旁边的可选动作」):
|
|
834
|
+
它是 list(多个插件的动作可以累积,不争一格),侧栏把它渲染在**设置上方**,正好符合「以后还要扩展」。
|
|
835
|
+
代价是侧栏不再代管外观,组件自己用标准 `usePanelInfo` 渲染选中态并对齐已装 `cordis-panel` 的几何
|
|
836
|
+
(36 px 高、12 px 圆角、hover 用 `--dsw-alias-interactive-bg-hover`)。
|
|
837
|
+
- 单击切换:已选中时点击回到对话(与 `×` 同一语义),不再是一个「点了没反应」的按钮。
|
|
838
|
+
|
|
839
|
+
**测试与验证**
|
|
840
|
+
|
|
841
|
+
- `npm test` **223 项全绿**;`tests/manifest.test.mjs` 的适配面清单改为断言
|
|
842
|
+
`sidebar.footer.action` / `usePanelInfo` / `selectPanel`。
|
|
843
|
+
- 隔离实例 UI 断言 **38/38**(新增:分段按钮选中态四边完整、自定义区间预填且真的生效、
|
|
844
|
+
暗色截图确实换了主题、色阶单调性、翻页不落在未取到的年份、价格说明可钉住、文案无 Markdown 记号、
|
|
845
|
+
已打开时点侧栏按钮可回到对话)。
|
|
846
|
+
- 隔离账本扩到 **400 天 / 1,710 轮**,让「固定一年 + 翻页」有真实可翻的年份;实测翻页
|
|
847
|
+
`2025-09-15 ~ 2026-09-14(365 天)` → `2024-09-09 ~ 2025-09-14(371 天)` → 回到今天。
|
|
848
|
+
|
|
849
|
+
**独立审查(第二轮)后的修订**
|
|
850
|
+
|
|
851
|
+
本轮改动交给**两个未参与开发的独立审查者**(正确性/边界;交互/可访问性/回归)只读审查,
|
|
852
|
+
共 11 条真实缺陷,全部已修,逐条记录与证据见 [`design/REVIEW-round2.md`](design/REVIEW-round2.md):
|
|
853
|
+
|
|
854
|
+
- **翻页会翻进几乎全部没取到的一年**(原判据只看「payload 里有更早的一天」):新增
|
|
855
|
+
`pageSpanDays()` 在翻页时把取数窗口加宽到覆盖目标页,并让 `canPageBack` 同时要求
|
|
856
|
+
「账本够老」与「payload 覆盖上一页最后一天」。实测翻页后未取到格子 **338 → 0**。
|
|
857
|
+
- **标题声称名义窗口**:`HeatmapRange` 改为给出 `drawnStart`/`drawnEnd`/`drawnDays`,
|
|
858
|
+
未覆盖时标题写「实绘 N 天,其余未取到」。
|
|
859
|
+
- **只守左边界**:比 payload 更新的日子(跨零点)会被画成零消耗 —— 补上 `coverageEnd`
|
|
860
|
+
两侧都守,并钳制翻页锚点不超过最新一天。
|
|
861
|
+
- **伴生数字不是这一页的**:改传本页的 `drawnStart..drawnEnd`(同账本 `¥216 → ¥192`)。
|
|
862
|
+
- **「暗色截图」其实是浅色截图**(两张 md5 相同):harness 的主题开关是
|
|
863
|
+
`document.body.toggleAttribute('data-ds-dark-theme', …)`,脚本改用真开关并断言两张图不同。
|
|
864
|
+
- **色阶最浅一档比无消耗的底格还弱**(浅色 1.09 vs 1.21):底格降到 9%,
|
|
865
|
+
1/2/3 级改为 30%/52%/76% 混合;实测两套主题对比度单调递增
|
|
866
|
+
(浅 `1.128→2.279`,暗 `1.24→6.891`)并写成断言。
|
|
867
|
+
- **价格说明浮层点不动**(悬停与点击共用一个布尔):拆成 hover 与 pinned,支持 Escape 与点外部。
|
|
868
|
+
- 其余:禁用的「上一段」按原因给文案、部分覆盖时不再铺满 53 列隐形格、账本起点晚于绘制起点时
|
|
869
|
+
也给出「没有记录 ≠ 没有消耗」的说明、自定义区间断言同时钉两个日期框、入口按钮几何对齐
|
|
870
|
+
42 px/`calc(100% + 4px)`/`margin: 0 -2px`、清掉用户文案里的 Markdown 星号、删掉死导出
|
|
871
|
+
`HEATMAP_EPOCH_DAY` 与 `sidebar.footer.action` 上无用的 `label`、`usePanelInfo` 改用上游类型、
|
|
872
|
+
图标去掉与 `aria-hidden` 互斥的 `role="img"`、补上「已打开时点按钮回到对话」的断言。
|
|
873
|
+
|
|
874
|
+
## v0.0.4-20260914 — 2026-09-14 01:30
|
|
875
|
+
|
|
876
|
+
按用户确认的五项,把插件的**核心关键逻辑**补齐并整理成文档:
|
|
877
|
+
[`design/CORE-LOGIC.md`](design/CORE-LOGIC.md)(新增,286 行,含变更检查清单)。
|
|
878
|
+
|
|
879
|
+
**① 记录 schema 版本兼容(旧账本永远可读)**
|
|
880
|
+
|
|
881
|
+
- 新增 `src/host/schema.ts`:读取按行**自己声明的 `v`** 选 reader,而不是拿当前版本号卡死;
|
|
882
|
+
`READABLE_RECORD_VERSIONS` 声明可读版本,`READERS` 表按版本分发。
|
|
883
|
+
- 新增健康计数 `unsupportedRecords`:来自**更新版本插件**的行与「损坏」分开报,看板提示
|
|
884
|
+
「由更新版本的插件写入,当前版本读不了」,不会让人误以为数据被毁。
|
|
885
|
+
- 加 v2 的完整步骤写进 `design/CORE-LOGIC.md` ①(含「`readVersion1` 永远不要删」这条铁律)。
|
|
886
|
+
|
|
887
|
+
**② 价格表带生效日期区间**
|
|
888
|
+
|
|
889
|
+
- 价格行从单一对象改为**带 `effectiveFrom`(含时区)的行数组**:`{effectiveFrom, cacheHit, cacheMiss, output}`。
|
|
890
|
+
- 新增 `selectEpoch()`:取「生效时刻 ≤ 该 attempt 结算时刻」中最晚的一行;早于所有已知行时用最早行并标
|
|
891
|
+
`before-first-known-price`(拒绝计价会丢用量,当作精确值会夸大置信度);无法解析时间戳的行不参与比较。
|
|
892
|
+
- 记录新增可选字段 `attempts[].pricedBy`(用了哪一行)与 `attempts[].estimatedReason`/`cost.estimatedReason`,
|
|
893
|
+
让一个数字事后仍可解释。`estimatedReason` 现有两个值:`unknown-model`、`before-first-known-price`。
|
|
894
|
+
|
|
895
|
+
**③ 重算命令(不做过期提醒,但可重算)**
|
|
896
|
+
|
|
897
|
+
- 新增 `scripts/recompute-cost.mjs`:**只用已存的 token** 重算 `cost`;token/时间/会话/工作区/路由一个字节不改。
|
|
898
|
+
- 默认干跑;`--write` 写前复制 `records.jsonl.bak-<ISO>` 并**原子替换**(tmp + rename),中断不留半个账本;
|
|
899
|
+
输出统一按当前 schema 版本写,因此它也是一条受支持的「升级旧行」路径。
|
|
900
|
+
- 实测:同一纪元重算 `changed: 0 / unchanged: 164`(幂等);换 USD 后 `changed: 164`,总额 `24.412504 → 3.607555`。
|
|
901
|
+
|
|
902
|
+
**④ 计价逻辑抽成可切换模块(换价格只改数据)**
|
|
903
|
+
|
|
904
|
+
- 三层拆分:契约 `src/host/pricing-module.ts`(形状 + `selectEpoch`)、**数据+规则** `src/host/pricing-modules/<era>.ts`、
|
|
905
|
+
引擎 `src/host/pricing.ts`、注册表 `src/host/pricing-modules/index.ts`。
|
|
906
|
+
- 一个纪元**自带规则**(`peakWindows`、`offPeakRatio`、`timezoneOffsetMinutes`),所以「时段规则变了」也不用碰引擎。
|
|
907
|
+
- 新增纪元 = 加一个文件 + 注册表加一行;**旧纪元保留**,用 `config.pricingModule` 切换或回切;
|
|
908
|
+
配错 id 会回落默认并打警告(不会静默用错价)。
|
|
909
|
+
- `buildPricingRule` 改为选项对象;`config.models`(无日期)语义明确为「在**所有**时刻优先」并记为精确值。
|
|
910
|
+
|
|
911
|
+
**⑤ 历史回填**
|
|
912
|
+
|
|
913
|
+
- 新增 `scripts/backfill-ledger.mjs`:重放 `<DSH_HOME>/sessions/*/*/session.v3.jsonl.zstd`,
|
|
914
|
+
用**同一个折叠器/价格纪元/记录构造器**补出装插件之前的轮次。
|
|
915
|
+
- 新增 `src/host/zstd.ts`:**纯 Node 多帧 zstd 解码**。实测 Node 的 `zstdDecompressSync` 只能解第一帧
|
|
916
|
+
(4.9 MB 日志得 1 行 vs CLI 5688 行);本模块自行解析帧头与 block 表求精确边界,输出与 CLI **完全一致**
|
|
917
|
+
(5688 行 / 0 残留 / 78 ms),不依赖 `zstd` 命令。
|
|
918
|
+
- **fork 继承副本用指纹判重**(`turn|startedAt|endedAt|结算时刻|total`),不靠信任标记;并按 `createdAt` 升序处理,
|
|
919
|
+
使继承轮归给父会话。实测取证:26 个日志里 2 个真 fork,各含**恰好 3 轮**与父会话时间戳+token 完全一致的副本。
|
|
920
|
+
标记预筛与指纹兜底**两条路径独立验证**:跳过 2,582 事件 / 报告 0 副本 与 跳过 0 / 报告 6 副本,
|
|
921
|
+
两条都得到**同样的 83 轮可回填**。
|
|
922
|
+
- 默认只报告;`--write` 只追加、`(sessionId, turn)` 与指纹双重幂等。实测真实历史 `--since 2026-09-10 --write`
|
|
923
|
+
写入 82 轮;抽查一轮 20,626,416 tokens,手算 ¥0.54307348 与账本**逐位一致**。
|
|
924
|
+
|
|
925
|
+
**测试与文档**
|
|
926
|
+
|
|
927
|
+
- `npm test` 185 → **217 项全绿**(新增 `tests/ledger-format.test.mjs`:多帧 zstd 往返/边界/腐坏输入 + schema 版本读法)。
|
|
928
|
+
- 新增 `design/CORE-LOGIC.md`(核心逻辑 + 不变量表 + 变更检查清单);`design/README.md` 收录。
|
|
929
|
+
|
|
930
|
+
## v0.0.3-20260914 — 2026-09-14 00:55
|
|
931
|
+
|
|
932
|
+
修复热力图的**静默失真**:不画取不到的日期,并把星期标签移出滚动区。
|
|
933
|
+
|
|
934
|
+
**修复**
|
|
935
|
+
|
|
936
|
+
- **热力图不再把「没有取到数据的日子」画成空白**。服务端的逐日序列是有上限的窗口
|
|
937
|
+
(`API_LIMITS.maxDays = 1825`,约 5 年),而热力图起点固定锚在 2026-08-13 所属周
|
|
938
|
+
(`HEATMAP_EPOCH_DAY`),于是账本一旦超过窗口长度,左侧那一段**账本里其实有记录、payload 里却没有**的日子
|
|
939
|
+
会被渲染成空白色块 —— 与「当天确实没有消耗」在视觉上完全无法区分。
|
|
940
|
+
实测(模拟 2034-01-01):**387 列 / 2709 格**,其中绝大多数是这种假空白。
|
|
941
|
+
现在 `heatmapWindow()` 会把起点夹到「窗口实际覆盖的首日所在周」:同一模拟变成 **262 列上限**并从
|
|
942
|
+
2029-01-01 起,不再绘制取不到的日期。
|
|
943
|
+
- **面板标题由「自 X 起」改为显示实际绘制范围**(`2026-08-10 ~ 2026-09-14`),用与网格同一个函数计算,
|
|
944
|
+
因此标题不可能再声称一个网格并未覆盖的范围。
|
|
945
|
+
- **横向滚动只作用于网格**:此前 `.dsh-tu-heat` 整体滚动,把左侧星期标签与月份表头一起滚出视野;
|
|
946
|
+
现在星期列固定,只有网格滚动。
|
|
947
|
+
|
|
948
|
+
**验证**
|
|
949
|
+
|
|
950
|
+
- `npm test` **185 项全绿**(新增 2 项:窗口覆盖边界、epoch 周优先);隔离 UI 断言 **23/23**。
|
|
951
|
+
- 实地观察:跨过午夜后(2026-09-14 周一)热力图由 5 周自动变为 **6 周 42 格**,即「每 7 天多一列」按预期发生。
|
|
952
|
+
|
|
953
|
+
**文档更正**
|
|
954
|
+
|
|
955
|
+
- 更正 `design/VERIFICATION.md` §8 与 v0.0.2 条目里的一处**时刻错误**:真实模型调用发生在
|
|
956
|
+
**北京时间 2026-09-13 22:53 周日**(原写「2026-09-14 06:53 周一」)。原因是核对脚本
|
|
957
|
+
`datetime.fromtimestamp(...)` 已按主机时区 CST 解释、又重复加了 8 小时。**插件判定本身无误**
|
|
958
|
+
(`classifyWindow` 用 `getUTC*` 且带 +480 分钟偏移,与主机时区无关),两次独立手算均一致。
|
|
959
|
+
|
|
960
|
+
## v0.0.2-20260913 — 2026-09-14 00:20
|
|
961
|
+
|
|
962
|
+
隔离测试环境按**工作区统一约定**重建(用户 2026-09-13 确认):**三独立 + 零拷贝 + 两项借用**。
|
|
963
|
+
规范落在 `../../plugins/README.md`「隔离测试环境」,本插件的 `scripts/setup_test_env.py` 是可复制的参考实现。
|
|
964
|
+
|
|
965
|
+
**变更**
|
|
966
|
+
|
|
967
|
+
- **三独立**:`DSH_HOME` 放插件目录内 `.verify/dsh-home`(gitignore);profile 沿用出厂名 `web`(隔离靠 home,
|
|
968
|
+
不靠 profile 名);端口**默认 3093**,占用时才探测空闲端口(此前未传 `--port` 会随机取端口,URL 不可预期)。
|
|
969
|
+
- **零拷贝**:不复制 `sessions/`、`attachments/`、`storages/`,**也不复制 `.credentials.yaml`**
|
|
970
|
+
(此前 file-tree 的做法是拷贝快照 + 凭据副本,留下 45MB 且含明文密钥的测试 home)。
|
|
971
|
+
- **配置借用**:从正式 `settings.yaml` 只摘 `agent-default-model`、`llm-deepseek`、`agent-presets`
|
|
972
|
+
三段**非机密**配置写进隔离 home,测试实例不再「不知道用哪个模型」。
|
|
973
|
+
- **凭据借用**:从正式 `.credentials.yaml` 的 `refs:` 读出值,**只经子进程环境变量**传给测试实例
|
|
974
|
+
(不写文件、不打印、不进仓库)。依据是官方 `dsh-credentials-local` 的层级「继承环境只读且优先级最高」。
|
|
975
|
+
默认开启,`--no-credentials` 显式验证无凭据路径。
|
|
976
|
+
- 新增 `run` 子命令(前台运行,供后台作业/CI 托管进程生命周期);`status` 改为
|
|
977
|
+
**pid 文件 + 端口探测**双判据(此前只认自己 `start` 写的 pid 文件,会把受管实例误报为未运行)。
|
|
978
|
+
- `scripts/verify-ui.mjs` 新增 `--expect-credentials`:开跑前观测是否出现「添加一个 API Key」引导页,
|
|
979
|
+
用于断言实例确实借到了凭据(默认只观测不断言,因为 `--no-credentials` 跑法应当看到该页)。
|
|
980
|
+
|
|
981
|
+
**验证(本轮新增,补上了此前最大的验证空白)**
|
|
982
|
+
|
|
983
|
+
- **真实模型调用端到端**:在隔离 home 里建 headless profile 装上本插件,仅靠环境变量注入凭据,
|
|
984
|
+
`dsh --profile headless "只回复两个字:收到"` 成功返回;账本记下**真实 provider 上报**
|
|
985
|
+
(未命中输入 9254 / 输出 2 / 合计 9256),费用 **¥0.009262** 与手算**逐位一致**;
|
|
986
|
+
北京时间 **2026-09-13 22:53 周日** 正确判定为空闲时段(×0.5);`estimated: false`、`total == 桶和`。
|
|
987
|
+
(初版此处误写为「周一 06:53」——是核对脚本把 +8 小时重复加了一次,插件判定本身无误;
|
|
988
|
+
详见 `design/VERIFICATION.md` §8 的更正说明。)
|
|
989
|
+
这同时验证了**无 `webServer` 的 headless 组合**下插件正常降级(只记录、不提供看板)。
|
|
990
|
+
- Web 实例借到凭据后**不再出现**「添加一个 API Key」引导,`verify-ui.mjs --expect-credentials` **23/23** 通过。
|
|
991
|
+
- `npm test` **183 项全绿**;`check-plugin-compat.mjs` `[ok]`。
|
|
992
|
+
|
|
993
|
+
## v0.0.1-20260913 — 2026-09-13 23:10
|
|
994
|
+
|
|
995
|
+
首个版本。基线 dsh `0.1.5-rc.1`(功能包 `0.1.5-rc.2`)。测试:`node --test` **183 项全绿**;
|
|
996
|
+
隔离环境端到端 **22/22** UI 断言通过。含两名独立审查者发现问题的修订。
|
|
997
|
+
|
|
998
|
+
**新增**
|
|
999
|
+
|
|
1000
|
+
- **Host 半:采集。** 订阅 `session/event`,在 `turn/end`(一轮已提交完成、对话不再处于处理中)
|
|
1001
|
+
把该轮用量折成一条账本记录。观察者回调内**零 I/O**:只做标量算术并入队,真正的追加由
|
|
1002
|
+
`setImmediate` 排空队列时批量完成。三层兜底(官方观察者分发自身包含异常 + 回调 `try/catch` +
|
|
1003
|
+
折叠器内部 `try/catch`),任何内部失败只体现为看板上的健康计数。
|
|
1004
|
+
- **Host 半:折算。** **流式复刻**官方 `deriveTurnTokenUsage` 的状态机与全部校验,
|
|
1005
|
+
不 import 内部包(零 dsh 运行时依赖);不持有事件与原始流,长对话常驻内存为常数级。
|
|
1006
|
+
- **Host 半:账本。** 跨工作区/跨会话的只追加 JSONL(默认 `~/.dsh/token-usage/records.jsonl`),
|
|
1007
|
+
记录日期时间、工作区绝对路径与短名、模型与 provider、Agent preset、子代理来源与委派深度、
|
|
1008
|
+
结束原因、逐 attempt 用量与金额;`(sessionId, turn)` 幂等去重(自愈式,重复追加不会重复计数);
|
|
1009
|
+
半行/非法行跳过并计数;写入队列有界。
|
|
1010
|
+
- **Host 半:费用。** DeepSeek 官方价格表(`deepseek-2026-09-10`,2026-09-13 核对,CNY/USD 两套)
|
|
1011
|
+
与峰谷计价:周一至周五 09:00–12:00 / 14:00–18:00(北京时间,与主机时区无关)为高峰,
|
|
1012
|
+
其余(含周末)按 50%;**逐 attempt 按各自结算时刻**判定时段;费用在写入时冻结;
|
|
1013
|
+
未知模型用兜底价并标记估算;价格可配置覆盖。
|
|
1014
|
+
- **Host 半:只读端点。** `ctx.webServer` 上注册 `<apiPath>/api/summary`,自带访问控制
|
|
1015
|
+
(回环 `Host` 白名单防 DNS rebinding、`Sec-Fetch-Site` 同源校验、永不发 CORS 头、
|
|
1016
|
+
只允许 GET/HEAD、`no-store` + `nosniff`、内部错误只回通用消息)。
|
|
1017
|
+
- **Client 半:席位。** `sidebar.panellist` 图标按钮 + `main` 键控中央面板
|
|
1018
|
+
(运行时槽位目录定义的「全局面板」席位配对),两个席位均为追加型、不遮蔽内置 UI。
|
|
1019
|
+
- **Client 半:图标。** 自绘 SVG:三根递增圆角柱 + 一条抬升的趋势线与端点,
|
|
1020
|
+
直陈「token 消耗趋势」,`currentColor` 继承主题与选中态。
|
|
1021
|
+
- **Client 半:看板。** 6 张累计卡片、日历热力图(自含 2026-08-13 的那一周起,周一起始,
|
|
1022
|
+
按第 90 百分位取色标,今日描边,右侧伴生日均/最高/每轮/费用/连续统计)、
|
|
1023
|
+
Token 柱状图、费用柱状图、按模型/按工作区明细表;支持工作区/模型筛选、
|
|
1024
|
+
按天/周/月粒度、近 7/30/90 天/本月/全部/自定义区间;全部配色走 `--dsw-*` 主题 token。
|
|
1025
|
+
- **测试(150 项)。** 折算状态机全分支 + **真实会话日志回放**(本机一次真实 25 步、
|
|
1026
|
+
1,405,497 token 的对话);**与官方折算函数在 2000 个随机日志上逐字段一致**(含共同拒绝的畸形日志);
|
|
1027
|
+
价格常量与峰谷边界(含周末/时区无关性);聚合的补零与按 attempt 切片;账本的幂等/容错/写失败不外抛;
|
|
1028
|
+
端点的访问控制(含 rebinding 与无 CORS 断言);单位换算与周分组;版本号五处一致与打包契约;
|
|
1029
|
+
**装配层**(假 Cordis ctx 驱动 `apply()`:监听器注册、一轮合成对话恰好落一行、畸形事件不外抛与
|
|
1030
|
+
会话销毁后不再记录)。测试针对 `lib/` 交付产物运行,`pretest` 自动先构建两半。
|
|
1031
|
+
- **隔离验证脚本。** `scripts/setup_test_env.py`(独立 `DSH_HOME` + profile + 端口,pnpm store 亦重定向)、
|
|
1032
|
+
`scripts/e2e-probe.mjs`(测试专用合成回合探针)、`scripts/seed-ledger.mjs`(用**已交付的**计价与记录
|
|
1033
|
+
契约造合成账本)、`scripts/verify-ui.mjs`(零依赖 CDP 断言,21 项,含局部 2× 截图与失败诊断转储)。
|
|
1034
|
+
- **文档。** README(功能/配置/费用算法/账本格式/安全/设计取舍/升级适配面清单/自测/已知陷阱/限制)、
|
|
1035
|
+
本 CHANGELOG、`design/DESIGN.md`(设计说明)、`design/VERIFICATION.md`(隔离验证记录)。
|
|
1036
|
+
|
|
1037
|
+
**修复(两名独立审查者发现,含 1 条阻断、3 条严重)**
|
|
1038
|
+
|
|
1039
|
+
> 完整逐条响应见 [`design/REVIEW-RESPONSE.md`](design/REVIEW-RESPONSE.md)。审查由**未参与开发**的独立
|
|
1040
|
+
> agent 担任,报告为 [`design/REVIEW-correctness.md`](design/REVIEW-correctness.md)(阻断 1 / 严重 4 /
|
|
1041
|
+
> 一般 7 / 建议 8)与 [`design/REVIEW-security.md`](design/REVIEW-security.md)(严重 3 / 一般 6 / 建议 9)。
|
|
1042
|
+
|
|
1043
|
+
- **阻断:聚合层混币**——金额现按币种隔离累加(token 与币种无关,仍全部累加),新增
|
|
1044
|
+
`HealthReport.currencyMismatches` 并在看板提示;`validateRecord` 拒绝非法币种。
|
|
1045
|
+
同一 `DSH_HOME` 下多个 profile 用不同币种时,此前会把 USD 金额并进 CNY 总额且零提示。
|
|
1046
|
+
- **严重:端点完全无凭据**——改为优先使用宿主的浏览器信任 + 鉴权围栏
|
|
1047
|
+
`ctx.connection.requestRejection`(与 `/api/*` 同一道围栏),并按请求惰性解析以避开组合顺序依赖。
|
|
1048
|
+
实测无凭据 **401**、伪造 Host **403**、带浏览器 Cookie **200**;无该服务的组合仍退回插件自己的
|
|
1049
|
+
回环 Host + 同源检查(并如实声明**不鉴权**,README §6 已重写,删去了原先「远程用 extraAllowedHosts」的不实说法)。
|
|
1050
|
+
- **严重:账本超 64 MiB 后看板静默清空**——账本改为流式读取,文件大小不再是悬崖;改为记录数上限
|
|
1051
|
+
(500,000,保留最新)并新增 `HealthReport.ledgerTruncated`,看板显式提示。
|
|
1052
|
+
- **严重:一行坏账本数据让看板 500**——`validateRecord` 现校验聚合层会解引用的每个字段
|
|
1053
|
+
(`attempts` 及其元素、`tokens` 含 `reasoning`、`cost.currency`),`workspaceLabel` 强制转换而非丢弃。
|
|
1054
|
+
- **严重:与官方折算函数在畸形日志上背离**——`streamUsage` 改为与官方一致(按 chunk **类型**命中即返回、
|
|
1055
|
+
不检查载荷),`turn/end` 增加 `data.turn` 校验、`reason` 防御式读取;conformance 扩到 **20000 例**
|
|
1056
|
+
且**数值一致与拒绝一致分别断言**。重复 closer / closer 之后的事件是流式折叠的必然差异,写成显式测试并记录。
|
|
1057
|
+
- **严重:客户端筛选语义无法单测**——`resolveRange`/`neededSpanDays` 移入 `src/shared/format.ts`,补 7 项单测。
|
|
1058
|
+
- 一般项:模型维度「轮次」不再按 attempt 虚高(新增按 route 分组);写失败改为一次有界重试 + 计入
|
|
1059
|
+
`droppedRecords`;未定价 attempt 的时段如实标 `unknown` 而非谎报 `off-peak`;UI 断言改为
|
|
1060
|
+
**用交付的格式化代码反算端点 payload 再与 DOM 比对**;`extraAllowedHosts` 不再抹平端口;
|
|
1061
|
+
回环判定覆盖 `127.0.0.0/8`;`stripPort` 只接受纯数字端口;定价表用空原型 + `Object.hasOwn` 防原型链;
|
|
1062
|
+
`apiPath` 校验并拒绝 `/api`、`/plugins`;`session/disposed` 监听器补兜底;账本创建用 `0600`。
|
|
1063
|
+
- 测试 150 → **183 项**;隔离 UI 断言 21 → **22 项**(新增卡片与端点 payload 的数值比对)。
|
|
1064
|
+
|
|
1065
|
+
**修复(本次隔离验证抓到,均为单测与类型检查发现不了的集成缺陷)**
|
|
1066
|
+
|
|
1067
|
+
- **`ctx.get('webServer')` 在 `apply` 时取不到服务** → 改用 `ctx.inject(['webServer'], …)`,
|
|
1068
|
+
服务出现时注册、消失时释放,headless 组合安静降级。修复前看板永远不出现。
|
|
1069
|
+
- **测试探针放在插件包目录内导致 dsh 启动失败**(`package … resolves from multiple active Loader
|
|
1070
|
+
sources`)→ 探针复制到独立包名的目录后再挂载。
|
|
1071
|
+
- **客户端 bundle 是语法错误**:模块加载器要求 factory 带默认参数,而 esbuild 的 CJS 产物以
|
|
1072
|
+
`"use strict";` 开头——「非简单参数列表」中的严格模式指令是 SyntaxError,整页显示
|
|
1073
|
+
「Failed to load plugins」→ 打包器把该指令提升到脚本顶层,并新增**编译级语法门禁**
|
|
1074
|
+
(构建脚本 + 清单测试各一道)。
|
|
1075
|
+
- **热力图锚点用了补零后的窗口首日**,多画 8 周空白 → 抽出纯函数 `heatmapWindow()`
|
|
1076
|
+
(锚点 = epoch 周与首个有流量日的所在周中较早者)并补 4 个单测。
|
|
1077
|
+
- 另修:热力图列中月份表头挤占网格行导致的星期标签错位(改为表头 + 独立 7 行网格);
|
|
1078
|
+
热力图仅 82px 宽而面板满宽显得像布局错误(补右侧伴生统计块);
|
|
1079
|
+
引导弹窗遮挡截图(隔离 home 预置为已读 + 通用浮层关闭);
|
|
1080
|
+
`parseSummaryQuery` 对缺省 `days` 会解析成 0 天(`Number(null)`)而非默认窗口;
|
|
1081
|
+
`formatMoney` 在 Host 与共享层各有一份实现(删除重复,只留一份)。
|