dsh-cost-meter 1.9.48 → 1.9.49

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/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  **Session cost tracking plugin for the DeepSeek Harness web GUI (bilingual UI)**
8
8
 
9
- [![version](https://img.shields.io/badge/version-1.9.48-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
9
+ [![version](https://img.shields.io/badge/version-1.9.49-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
10
10
  [![npm](https://img.shields.io/npm/v/dsh-cost-meter?label=npm)](https://www.npmjs.com/package/dsh-cost-meter)
11
11
  [![dshfind](https://dshfind.com/api/badge/Han-1413141/dsh-cost-meter?metric=downloads&lang=en)](https://dshfind.com/zh/plugins/Han-1413141/dsh-cost-meter?ref=badge)
12
12
  [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
@@ -16,11 +16,11 @@
16
16
 
17
17
  </div>
18
18
 
19
- **v1.9.48** fixes client chunk registration when dsh-loader is active, adds Codex quota reset times to the input-bar tooltip, and validates billion-context 0.1.210–0.1.211.
19
+ **v1.9.49** adds optional plan quota gauges, repairs native-search observation after network plugin replacement, and provides explicit search-fee corrections and billing-currency guidance.
20
20
 
21
21
  **Host floor: DSH 0.2.0** · Adaptation target: **0.2.1-rc.2** (npm `next`). Expand the compatibility notes below for exact declarations, host records and troubleshooting.
22
22
 
23
- Release notes: [v1.9.48](docs/update-notes-1.9.48.md#english). Fully restart DSH after updating.
23
+ Release notes: [v1.9.49](docs/update-notes-1.9.49.md#english). Fully restart DSH after updating.
24
24
 
25
25
  ![Promo art](docs/promo.en.png)
26
26
 
@@ -356,22 +356,22 @@ On Node.js 20, use `npm install -g pnpm@10` instead. See [pnpm installation and
356
356
  dsh plugin --profile web add dsh-cost-meter
357
357
  ```
358
358
 
359
- **PowerShell one-click script** (copy the whole line, paste, press Enter; pnpm is provisioned automatically, git is auto-detected — no clone needed; the install chain is **pinned to the release tag `v1.9.48`** — review the script before running):
359
+ **PowerShell one-click script** (copy the whole line, paste, press Enter; pnpm is provisioned automatically, git is auto-detected — no clone needed; the install chain is **pinned to the release tag `v1.9.49`** — review the script before running):
360
360
 
361
361
  ```powershell
362
- irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.9.48/install.ps1 | iex
362
+ irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.9.49/install.ps1 | iex
363
363
  ```
364
364
 
365
365
  **Or a plain command line** (the machine must already have pnpm and git; also pinned to the tag):
366
366
 
367
367
  ```sh
368
- dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.9.48
368
+ dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.9.49
369
369
  ```
370
370
 
371
371
  Without git, use the GitHub tag archive:
372
372
 
373
373
  ```sh
374
- dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.9.48.tar.gz
374
+ dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.9.49.tar.gz
375
375
  ```
376
376
 
377
377
  After installing, **restart** `dsh web` (plugin rows, the Typert manifest and the client bundle are all scanned at startup):
@@ -436,7 +436,7 @@ Workarounds:
436
436
 
437
437
  ```yaml
438
438
  minimumReleaseAgeExclude:
439
- - dsh-cost-meter@1.9.48
439
+ - dsh-cost-meter@1.9.49
440
440
  ```
441
441
 
442
442
  3. For a one-off CLI operation, forward the pnpm flag: `dsh plugin --profile desktop remove dsh-cost-meter --config.minimum-release-age=0` (or add `--trust-lockfile` when only lockfile verification fails). Both flags were verified against pnpm 11.28.5 in a temporary profile.
package/README.zh-CN.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  **DeepSeek Harness 会话费用统计插件(界面中英双语)**
8
8
 
9
- [![version](https://img.shields.io/badge/version-1.9.48-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
9
+ [![version](https://img.shields.io/badge/version-1.9.49-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
10
10
  [![npm](https://img.shields.io/npm/v/dsh-cost-meter?label=npm)](https://www.npmjs.com/package/dsh-cost-meter)
11
11
  [![dshfind](https://dshfind.com/api/badge/Han-1413141/dsh-cost-meter?metric=downloads&lang=zh)](https://dshfind.com/zh/plugins/Han-1413141/dsh-cost-meter?ref=badge)
12
12
  [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
@@ -16,11 +16,11 @@
16
16
 
17
17
  </div>
18
18
 
19
- **v1.9.48** 修复 dsh-loader 环境下的界面模块重复注册,Codex 输入栏额度悬停提示新增 5 小时/7 天重置时间,并验证 billion-context 0.1.210–0.1.211。
19
+ **v1.9.49** 新增套餐额度圆环,修复网络插件替换 fetch 后的搜索漏记,并提供搜索费用补记命令和计价币种核对入口。
20
20
 
21
21
  **宿主要求:DSH 0.2.0 起支持** · 适配目标 **0.2.1-rc.2**(npm `next`)。完整声明、历史记录与安装排障见下方展开项。
22
22
 
23
- 更新说明:[v1.9.48](docs/update-notes-1.9.48.md#中文)。更新后完全重启 DSH。
23
+ 更新说明:[v1.9.49](docs/update-notes-1.9.49.md#中文)。更新后完全重启 DSH。
24
24
 
25
25
  ![宣传图](docs/promo.png)
26
26
 
@@ -356,22 +356,22 @@ Node.js 20 请改用 `npm install -g pnpm@10`。版本要求见 [pnpm 官方安
356
356
  dsh plugin --profile web add dsh-cost-meter
357
357
  ```
358
358
 
359
- **PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.9.48`**,建议先下载审阅再运行):
359
+ **PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.9.49`**,建议先下载审阅再运行):
360
360
 
361
361
  ```powershell
362
- irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.9.48/install.ps1 | iex
362
+ irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.9.49/install.ps1 | iex
363
363
  ```
364
364
 
365
365
  **或直接命令行**(机器上需已有 pnpm 与 git;同样固定到 tag):
366
366
 
367
367
  ```sh
368
- dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.9.48
368
+ dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.9.49
369
369
  ```
370
370
 
371
371
  没有 git 时可用 GitHub tag 打包直链:
372
372
 
373
373
  ```sh
374
- dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.9.48.tar.gz
374
+ dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.9.49.tar.gz
375
375
  ```
376
376
 
377
377
  安装后**重启** `dsh web`(插件行、Typert 清单与客户端 bundle 均在启动时扫描):
@@ -436,7 +436,7 @@ DSH **0.2.1-rc.1 / 0.2.1-rc.2** 宿主自带 pnpm **11.28.5**,默认启用内
436
436
 
437
437
  ```yaml
438
438
  minimumReleaseAgeExclude:
439
- - dsh-cost-meter@1.9.48
439
+ - dsh-cost-meter@1.9.49
440
440
  ```
441
441
 
442
442
  3. 仅本次操作用 CLI 透传 pnpm 参数:`dsh plugin --profile desktop remove dsh-cost-meter --config.minimum-release-age=0`;若只是 lockfile 校验阶段失败,可改用 `--trust-lockfile`。这两个参数已在本机 pnpm 11.28.5 临时 Profile 上实测可用。
@@ -0,0 +1,21 @@
1
+ # DeepSeek billing currency / DeepSeek 计价币种
2
+
3
+ ## English
4
+
5
+ **Display currency** changes how amounts are shown. **Official price currency** selects the DeepSeek price table fetched by Sync. USD prices multiplied by a display exchange rate are not the official CNY prices.
6
+
7
+ For a CNY account, open **Settings → Cost → Prices → Official price sync**, choose **CNY**, wait for auto-save, then click **Sync from official docs** and apply. The CNY hint includes a button to select CNY; this selection alone does not fetch prices or reprice history. Check the sync result: if the CNY page is unavailable and syncing falls back to USD, the hint remains. Switching the table's currency uses the existing history recalculation; sessions without complete logs retain their previous cost basis. No setting changes merely because the hint appears.
8
+
9
+ For the September 2026 Flash off-peak rates, USD prices of $0.003 / $0.15 / $0.60 correspond to CNY prices of ¥0.02 / ¥1 / ¥4 per million cache-read / uncached-input / output tokens. Multiplying the USD prices by 7.2 gives ¥0.0216 / ¥1.08 / ¥4.32, 8% above that CNY table. The ratio is a comparison of those published prices, not a market exchange rate or a universal rule for every model. Sources: [DeepSeek USD prices](https://api-docs.deepseek.com/quick_start/pricing/) and [DeepSeek CNY prices](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/).
10
+
11
+ Use the matching official table when comparing bills. Changing the global exchange rate also affects other providers' displayed USD charges. Check the model, pricing window, cache tokens and settlement time: in [issue #157](https://github.com/Han-1413141/dsh-cost-meter/issues/157), one balance test settled after about four minutes; that observation is not a guaranteed settlement interval.
12
+
13
+ ## 中文
14
+
15
+ **显示币种**只决定金额如何展示;**官方价格币种**决定同步哪套 DeepSeek 价格。美元价格乘以显示汇率,不等于官方人民币报价。
16
+
17
+ 人民币账户请进入**设置 → 费用 → 价格 → 官方价格同步**,选择 **CNY**,等待自动保存,再点击同步并应用。提示中的按钮可以直接选择 CNY;仅选择币种不会抓取价格或重算历史。同步后应查看结果:若人民币页面不可用、回退到美元表,提示仍然保留。价目表币种切换沿用既有历史重算流程,日志不完整的会话保留原计价口径。出现提示本身不会修改设置。
18
+
19
+ 以 2026 年 9 月 Flash 谷价为例,每百万缓存读取/未命中输入/输出为 $0.003/$0.15/$0.60,对应官方 ¥0.02/¥1/¥4;美元报价乘以 7.2 后是 ¥0.0216/¥1.08/¥4.32,比这套人民币价高 8%。这个比值只描述这些报价,不是市场汇率,也不适用于所有模型。来源见上方 DeepSeek 中英文官方价格页。
20
+
21
+ 对账应选择匹配的官方价格表;修改全局汇率还会影响其他厂商美元费用的显示。同时核对模型、峰谷时段、缓存 tokens 和结算时间。#157 报告的一次余额实验约四分钟后才结算,这是个别观测,不是固定结算周期。
@@ -0,0 +1,32 @@
1
+ # 2026-11-02 计费检查记录
2
+
3
+ ## 已复现的问题与处理
4
+
5
+ | 项目 | 复现与处理 |
6
+ | --- | --- |
7
+ | 人民币显示与美元价表 | 默认价表的 Flash 谷价输出为 $0.60/百万 Token,显示汇率 7.2 时为 ¥4.32;官网人民币价为 ¥4。概览增加实际价表币种、待同步状态和同步入口,不自动覆盖用户价格。 |
8
+ | 搜索观察器失效 | 安装观察器后,用无 Undici 诊断的 HTTP 实现替换全局 fetch,旧包装器无法捕获响应。现在在搜索开始及官方搜索事件处重新接入;替换实现调用旧包装器时仍只记一次。 |
9
+ | 旧搜索请求漏记 | 增加明确指定次数、时间、会话和记录 ID 的命令。默认预览;确认写入后使用账本锁、原子文件替换、持久化去重与独立历史明细。仅补记已知请求费。 |
10
+
11
+ 搜索宿主检查使用实际 DSH Web 服务和 DeepSeek provider。发布包 `@deepseek-ai/dsh-web-search-deepseek@0.2.1-rc.3` 的 `lib/index.js` 与本机测试运行时 rc.2 文件一致,SHA-256 为 `fc13dd4eaba3c9298af41a4d0559a1b8bb61614462fe18ba6e76d8c598c332bd`。请求定向到本机测试服务器;八条搜索结果只产生一笔请求费,另记响应提供的模型用量。该复现说明可导致 #456 现象的一种加载顺序问题,未读取报告者的实际桌面进程。
12
+
13
+ ## 计费流程检查
14
+
15
+ | 范围 | 检查内容与回归入口 |
16
+ | --- | --- |
17
+ | 输入与缓存 | DSH 的输入、缓存读取、缓存写入为独立桶;OpenAI/Responses 原始输入转换先扣除已缓存部分。`billing-integrity.mjs`、`billion-context-billing.mjs`、`review-billing-regressions.mjs`。 |
18
+ | 输出与推理 | 推理通常已含在输出桶;默认不再收取推理单价。用户显式设置的 reasoning 是附加费率,保留原定义。`billing-integrity.mjs`、`custom-model-prices.mjs`。 |
19
+ | 流式与包装路由 | 使用最后一份累积 usage;嵌套转发去重;独立并发调用分别记账。`billing-channel-peak.mjs`、`scoped-billing.mjs`、`subagent-billing.mjs`、`review-billing-regressions.mjs`。 |
20
+ | 模型、渠道、倍率 | 按渠道和模型匹配;自定义价格、独立厂商价格和倍率不被官方同步覆盖。`pricing-model-matching.mjs`、`price-multiplier.mjs`、`official-price-sync-currency.mjs`。 |
21
+ | 峰谷与时间 | 按请求开始时间选择价格,覆盖跨边界、周末、节假日和渠道时区。`billing-channel-peak.mjs`、`provider-peak-schedule.mjs`、`deepseek-pricing-official.mjs`。 |
22
+ | 套餐与实际费用 | 默认排除套餐 API 等值;开启等值统计时在核对面板明确说明。`plan-provider-matching.mjs`、`go-auto-billing.mjs`、`billing-check.mjs`。 |
23
+ | 历史、汇率、并发 | 保留调用时的价格及汇率;检查重放、崩溃重试与多个写入进程的合并。`billing-history.mjs`、`ledger-frozen-fx.mjs`、`billion-context-receipts.mjs`、`review-ledger-writer.mjs`。 |
24
+ | 搜索与抓取 | 只对观察到的成功结果计费,结果数量不乘单价;固定请求费不套模型倍率、峰谷价或订阅分类。`web-request-billing.mjs`、`native-search-fetch.mjs`、`native-search-host.mjs`、`native-search-manual.mjs`。 |
25
+
26
+ 上述纯 Node 回归纳入 `node test/verify.mjs`;真实搜索宿主另运行 `test/native-search-host.mjs`。新增圆环使用 `test/display-settings-browser.mjs` 的真实浏览器检查,覆盖浅色/深色、220/320 像素宽度、四种侧栏布局、0/50/100%、保存、刷新和纯文本优先级。所有计费样本均为合成数据,没有发起收费模型请求,也没有修改用户的实际账本。
27
+
28
+ ## 官方依据与适用范围
29
+
30
+ - [DeepSeek 人民币价格](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/)与[美元价格](https://api-docs.deepseek.com/quick_start/pricing/),2026-11-02 核对:Flash 谷价缓存读取/未命中输入/输出分别为 ¥0.02/¥1/¥4,以及 $0.003/$0.15/$0.60;两套表分别定价。
31
+ - [搜索与抓取规则](https://api-docs.deepseek.com/zh-cn/guides/search/):每次成功请求人民币费用 ¥0.005,服务端工具免费期截止北京时间 2026-11-01 00:00。
32
+ - 群内“高于官网”反馈未提供厂商、模型、渠道、金额或时段,检查结果不能代替该账户的逐笔对账。除以上已复现情况,本轮回归未发现新的普遍性重复计费问题。
@@ -1,61 +1,67 @@
1
- # 显示设置预览
2
-
3
- 在“费用 → 显示 → 侧栏”打开“隐藏进度条,仅显示紧凑文本”,可去掉峰谷时段、套餐额度、余额、预算和模型占比的图形条。额度保留窗口名与百分比,峰谷保留当前时段、倒计时和切换时间;悬停详情、点击刷新与超额警告仍可使用。偏好会保存,重启后保留。此选项只影响侧栏和侧栏预览,不改变用量查询、账本、计价、输入区额度条或原有布局/条形方向;关闭后恢复原样式。在峰谷组件里仍可选择只显示倒计时或切换时间。
4
-
5
- **Compact text:** In **Cost → Display → Sidebar**, enable **Hide progress bars, show compact text** to hide sidebar pricing-period, quota, balance, budget and model-share bars. Window labels, percentages, period times, hover details, refresh actions and warnings remain available. The preference survives restart, applies to the sidebar preview, and never changes billing, account queries, composer bars or the saved graphical style. Disable it to restore the existing bars.
6
-
7
- 在“费用 → 额度”展开自定义余额条目,可设置“跳转链接(可选)”。填写账户、充值或控制台的 HTTP(S) 地址后,侧栏该条余额名称旁显示跳转箭头;余额行、进度卡和查询失败提示均可使用。点击箭头在新标签页打开,不触发余额刷新。每条链接独立保存,留空时不显示箭头;不从余额查询接口或请求头推导链接。
8
-
9
- 选择“侧栏 → 调整组件 → 余额”,可开启“仅官方渠道显示”(`balance.officialChannelOnly`,默认关闭)。开启后,侧栏官方余额只在当前会话使用 `deepseek`、`deepseek-official` 或 `deepseek-account` 渠道时显示;带 `llm-` 前缀的名称按相同渠道识别。无活跃会话或宿主未提供渠道投影时,按今日账本是否有官方渠道调用判断,包括零费用调用。当前会话明确使用其他渠道时,即使今天调用过官方渠道也隐藏;切换渠道后下一次调用更新显示。设置页官方余额面板和显示预览不受渠道限制,“隐藏官方余额”、显示位置与来源标注继续独立生效。
10
-
11
- 会话列表行末金额默认关闭。在“侧栏 → 调整组件 → 会话列表金额”打开“显示此组件”,选择累计或今日。金额沿用显示币种、精度与汇率设置;没有记录显示“—”,悬停查看输入、缓存和输出 Token。仅合并查询当前可见行,结果缓存五秒,显示期间每十秒刷新;关闭功能或隐藏页面时停止定时查询,收起为图标侧栏时不显示。
12
-
13
- 关闭输入框上方的 Codex 额度条:选择“输入区 → 调整组件 → Codex 额度”,取消“在输入区显示 Codex 额度”。该开关与侧栏额度独立,不影响预算、Go 或其他套餐的额度条;两个 Codex 显示位置都隐藏时停止查询。
14
-
15
- Codex 额度的真实数据来自已启用并登录的 `dsh-codex-subscription`、DSH 内置 pi-ai 登录、`dsh-chatgpt-sub`、`@eddyskywalker/dsh-chatgpt-subscription` 或 `dsh-codex-connect`。自动检测按上述顺序尝试;在 Codex 显示设置中指定数据源后,只读取所选来源当前账号的额度。侧栏以“周额度 · 剩余 83% · 10/25 08:10 重置”显示,5h 窗口单列一行;会话额度条也标明“剩余”。只返回周额度的账号仅显示周窗口。重置时间按本机时区显示,Codex 不随其他套餐的进度条方向切换口径。示例百分比只用于预览;真实查询未成功时,已开启的侧栏卡片会显示登录与重试提示,可以点击重新查询。启用期间每分钟检查一次,成功数据缓存五分钟,失败一分钟后重试;两个显示位置都关闭后停止检查。查询只读取额度,不发送模型请求。
16
-
17
- `dsh-chatgpt-sub` 与 `@eddyskywalker/dsh-chatgpt-subscription` 是两个独立插件。前者只提供登录绑定状态:费用插件先确认它已绑定且通道可用,再由服务端用 DSH 中该插件管理的凭据查询额度;不会读取共享的 Codex 登录文件,也不要求安装 Bottom Info Bar。后者沿用 `/api/dsh-chatgpt-subscription/status` 与 `/quota/refresh` 接口。使用 `dsh-chatgpt-sub` 时,在“侧栏 → 调整组件 → Codex 额度”中开启显示并选择同名数据源,也可单独开启输入区额度条。该设置与计费归类独立。
18
-
19
- 进入 DSH 设置 → 费用 → 显示。默认勾选“使用示例数据”,展示余额、预算、Go、套餐、峰谷和三种模型的完整效果。选中 Codex 或自定义余额时也提供对应示例。取消勾选后展示当前缓存数据,缺失的会话值显示“—”。数据来源的选择仅保存在本机预览偏好中,不更改插件配置或账本。
20
-
21
- 预览分为侧栏、输入区和会话内容三个区域,使用正常字号,只渲染当前区域。点击虚线框,在右侧调整对应组件。示例模式下隐藏的组件保留淡化效果,方便再次选中;当前数据模式下未显示的组件保留淡色标签。组件菜单只列出可调整的组件,操作提示不再作为菜单选项。显示设置的更改自动保存。
22
-
23
- 右侧的“侧栏布局”默认展开,展示合并卡片、简洁、标准和紧凑四种样式的小预览,复用实际预算与多时段额度的进度卡片。小预览标记为样式示例,未配置的额度使用本地示例数值。紧凑样式将多时段额度排成两列,预算卡片保持完整。点击峰谷条可切换细条或分段样式;点击“今日金额 · 模型数”可调整模型卡片的展开、周期、摘要、位置、行数、Token 和费用占比条。预算、余额、会话费用和额度条的选项各自放在对应组件旁。金额格式、换算和语言集中在下方。宽窗口将样式缩略图横向排列,窄窗口再改为竖向;右侧面板在空间不足时排到预览下方。放大预览中按 Escape 返回。
24
-
25
- 侧栏预览和真实侧栏共用完整的呈现函数与当前缓存数据,包含余额错误状态、独立的 Go 与预算卡片、预算摘要、今日用量和峰谷条、模型花费卡片。选择框使用独立覆盖层,不改变组件 DOM 层级和紧凑布局。打开时最多读取三个宿主表面的背景、圆角、字体等六项外观属性;主题属性变化时更新。共用插件组件、DSH 图标和主题变量,跟随这些外观的皮肤修改;其他插件的独立控件不重复挂载。
26
-
27
- 两种数据来源共用实际展示组件。示例状态只传给预览,不写入配置、余额、额度或账本,也不会启用账户查询或 Codex 探测。预览不复制会话内容,不遍历整页 DOM,不创建 iframe,不解码图片,不订阅会话投影。选择框只测量当前预览内最多 32 个标记节点,使用一个局部尺寸监听器;关闭时清理尺寸与主题监听器。异常组件由预览内部的错误边界隔离,仍可使用详细显示选项。
28
-
29
- 预算显示和预算统计分别控制。隐藏预算卡片不会关闭预算统计;隐藏峰谷条不会关闭峰谷计价;显示 Go 占位不会启用账户查询。
30
-
31
- 原生图标的来源和许可证见仓库根目录 THIRD_PARTY_NOTICES.md。
32
-
33
- 侧栏区域上方直接提供预算、今日用量、峰谷时段和模型花费四个显示开关,不必先选中组件。今日用量单行与“今日金额 · 模型数”摘要分别控制;关闭其中一个不影响其他组件,没有其他组件时也可以只显示峰谷条。隐藏侧栏今日用量不会隐藏概览里的今日费用,预算详细信息开关也不影响今日用量。所有组件关闭时不保留空白区域。
34
-
35
- 选择套餐进度条后,可以在同一面板选择 MiniMax 等账户、调整该账户的显示位置和侧栏开关。切换账户只切换编辑对象,不启用额度查询;进度条方向统一应用于所有套餐。需要修改凭据或查询参数时,点击“账户与额度设置”直接展开并定位到所选账户。
36
-
37
- 价格 → 模型定价中,每个模型下方的“计入统计”可展开三个独立开关:今日费用、月度与累计、预算。开关按渠道和模型保存,只改变对应汇总,不删除原始调用或重新定价。重新勾选可恢复统计。今日模型花费摘要跟随今日费用的选择;月度与累计、预算各用自己的选择。
38
-
39
- 模型定价以固定排序的紧凑列表展示,宽窗口中三项单价按列对齐,窄窗口在模型名下方排列。切换价格来源时模型保留原位置;选择自定义后,只定位一次到自定义编辑区的开头。保存价格或修改币种时不重新滚动。
40
-
41
- 峰谷时段新增“进度条”样式,显示当前计价时段已过的比例。峰时使用橙色,平价、周末和节假日使用 DSH 主题蓝色。标准侧栏显示完整信息,简洁侧栏使用两行,紧凑侧栏使用单行;可选择倒计时、切换时间或同时显示两者,悬停查看完整说明。周末和节假日会显示下一次切换的星期或日期,进度从连续谷价时段真正开始的时刻计算。
42
-
43
- 选中峰谷时段后,右侧以三张紧凑的实际效果卡片展示进度条、细条和分段样式,复用侧栏呈现函数,包含当前时段文字、橙蓝轨道和倒计时。蓝色边框和“已选”标明当前选择,样式说明放在悬停提示中,点击后立即更新左侧预览。右侧收窄并减少内边距和重复说明;桌面设置保持左侧预览、右侧调整,与其他组件使用相同的窄屏换行条件。显示时间的完整选项放在右侧卡片下方。预览中超长的时段文字以省略号收起,保留可见轨道,悬停或键盘聚焦可读取完整说明。样式示例只渲染峰谷组件,不挂载余额、额度和模型卡片,也不会把示例开关写入配置。
44
-
45
- 1.9.43 起,五个显示介绍合并为一个可关闭的首次提示,统一指向「设置 → 费用 → 显示」。已有任一介绍的已读记录会抑制新提示;关闭不会修改显示、查询或计费偏好。峰谷三种布局及预览仍可随时在显示设置中选择,原细条和分段样式保留。预览只读取配置和本机时间,不查询余额、不发送模型请求、不改变计价或历史记录。界面按需加载,页面隐藏时停止刷新,关闭组件时清理定时器和监听器。
46
-
47
- “费用 → 显示”提供“跟随皮肤透明度”,默认关闭。开启后,费用页共用设置窗口的背景,统计正文不再另铺实心底色;费用明细、引导、提醒与下拉浮层使用皮肤层色,保留至少 90% 不透明度。关闭后立即恢复不透明遮挡效果。该开关只修改插件自己的界面,保存后重启仍生效。
48
-
49
- “今日用量”右侧提供“费用”和“Token 用量”两个开关,至少保留一项;两项开启时金额与 Token 右对齐并列,空间不足时换行。选中“今日用量”后,两个子项各有虚线,点击对应虚线会定位到该项开关。
50
-
51
- 拖动排序仅在显示设置的侧栏预览中提供,主界面侧栏按保存顺序正常展示,不显示拖动手柄。预览中可拖动组件,拖到目标卡片的上半部或下半部决定放在前面或后面。手柄聚焦后也可用上下方向键移动。顺序保存到 `sidebarOrder`,重启、切换样式和暂时隐藏组件后保留;不同 Coding Plan 与网关卡片分别排序。Go 与预算使用独立卡片。原模型花费位置选项用于旧配置;手动使用该选项会清除拖动顺序并恢复原位置规则。
52
-
53
- “合并卡片”将今日 Token 与费用、余额和峰谷进度放入同一外框。选择时默认开启今日双项显示,之后仍可分别关闭。Codex 组件提供额度查询总开关;显式开启其显示时会启用查询。billion-context 的统计偏差说明放在“费用 → 概览”,使用普通灰色文字,不再自动弹窗或提供弹窗开关。
54
-
55
- “费用 → 显示 → 侧栏”中的“今日消费与余额同行”是独立开关,可与现有布局组合使用。开启时默认只显示今日费用,Token 可在今日组件中单独开启;两项保留悬停详情,余额进度条照常显示,隐藏官方余额时使用第一条可见的自定义余额。排序在设置预览中调整,关闭开关恢复各组件独立排列。
56
-
57
- ## 点击名称隐藏余额
58
-
59
- 1.9.45 起,在“设置 → 费用 → 显示 → 侧栏 → 调整组件 → 余额(或自定义余额)”中可以开启“点击名称快速隐藏余额”。默认关闭。开启后,点击余额名称隐藏或显示金额,点击金额继续刷新。隐藏时不显示进度条及悬停金额;四种侧栏布局、同行显示和收起样式共用隐藏状态。本机浏览器记住隐藏状态;关闭选项即恢复原有点击刷新方式。
60
-
61
- In Settings → Cost → Display → Sidebar → Balance (or Custom balance), enable **Click name to hide balance**. This is off by default. Click the label to hide/show the amount; click the amount to refresh. Hidden balances also hide progress bars and tooltip amounts across sidebar layouts. The browser remembers hidden state. Disabling this option restores the original click-to-refresh behavior.
1
+ # 显示设置预览
2
+
3
+ 在“费用 → 显示 → 侧栏”打开“隐藏进度条,仅显示紧凑文本”,可去掉峰谷时段、套餐额度、余额、预算和模型占比的图形条。额度保留窗口名与百分比,峰谷保留当前时段、倒计时和切换时间;悬停详情、点击刷新与超额警告仍可使用。偏好会保存,重启后保留。此选项只影响侧栏和侧栏预览,不改变用量查询、账本、计价、输入区额度条或原有布局/条形方向;关闭后恢复原样式。在峰谷组件里仍可选择只显示倒计时或切换时间。
4
+
5
+ **Compact text:** In **Cost → Display → Sidebar**, enable **Hide progress bars, show compact text** to hide sidebar pricing-period, quota, balance, budget and model-share bars. Window labels, percentages, period times, hover details, refresh actions and warnings remain available. The preference survives restart, applies to the sidebar preview, and never changes billing, account queries, composer bars or the saved graphical style. Disable it to restore the existing bars.
6
+
7
+ 在“费用 → 额度”展开自定义余额条目,可设置“跳转链接(可选)”。填写账户、充值或控制台的 HTTP(S) 地址后,侧栏该条余额名称旁显示跳转箭头;余额行、进度卡和查询失败提示均可使用。点击箭头在新标签页打开,不触发余额刷新。每条链接独立保存,留空时不显示箭头;不从余额查询接口或请求头推导链接。
8
+
9
+ 选择“侧栏 → 调整组件 → 余额”,可开启“仅官方渠道显示”(`balance.officialChannelOnly`,默认关闭)。开启后,侧栏官方余额只在当前会话使用 `deepseek`、`deepseek-official` 或 `deepseek-account` 渠道时显示;带 `llm-` 前缀的名称按相同渠道识别。无活跃会话或宿主未提供渠道投影时,按今日账本是否有官方渠道调用判断,包括零费用调用。当前会话明确使用其他渠道时,即使今天调用过官方渠道也隐藏;切换渠道后下一次调用更新显示。设置页官方余额面板和显示预览不受渠道限制,“隐藏官方余额”、显示位置与来源标注继续独立生效。
10
+
11
+ 会话列表行末金额默认关闭。在“侧栏 → 调整组件 → 会话列表金额”打开“显示此组件”,选择累计或今日。金额沿用显示币种、精度与汇率设置;没有记录显示“—”,悬停查看输入、缓存和输出 Token。仅合并查询当前可见行,结果缓存五秒,显示期间每十秒刷新;关闭功能或隐藏页面时停止定时查询,收起为图标侧栏时不显示。
12
+
13
+ 关闭输入框上方的 Codex 额度条:选择“输入区 → 调整组件 → Codex 额度”,取消“在输入区显示 Codex 额度”。该开关与侧栏额度独立,不影响预算、Go 或其他套餐的额度条;两个 Codex 显示位置都隐藏时停止查询。
14
+
15
+ Codex 额度的真实数据来自已启用并登录的 `dsh-codex-subscription`、DSH 内置 pi-ai 登录、`dsh-chatgpt-sub`、`@eddyskywalker/dsh-chatgpt-subscription` 或 `dsh-codex-connect`。自动检测按上述顺序尝试;在 Codex 显示设置中指定数据源后,只读取所选来源当前账号的额度。侧栏以“周额度 · 剩余 83% · 10/25 08:10 重置”显示,5h 窗口单列一行;会话额度条也标明“剩余”。只返回周额度的账号仅显示周窗口。重置时间按本机时区显示,Codex 不随其他套餐的进度条方向切换口径。示例百分比只用于预览;真实查询未成功时,已开启的侧栏卡片会显示登录与重试提示,可以点击重新查询。启用期间每分钟检查一次,成功数据缓存五分钟,失败一分钟后重试;两个显示位置都关闭后停止检查。查询只读取额度,不发送模型请求。
16
+
17
+ `dsh-chatgpt-sub` 与 `@eddyskywalker/dsh-chatgpt-subscription` 是两个独立插件。前者只提供登录绑定状态:费用插件先确认它已绑定且通道可用,再由服务端用 DSH 中该插件管理的凭据查询额度;不会读取共享的 Codex 登录文件,也不要求安装 Bottom Info Bar。后者沿用 `/api/dsh-chatgpt-subscription/status` 与 `/quota/refresh` 接口。使用 `dsh-chatgpt-sub` 时,在“侧栏 → 调整组件 → Codex 额度”中开启显示并选择同名数据源,也可单独开启输入区额度条。该设置与计费归类独立。
18
+
19
+ 进入 DSH 设置 → 费用 → 显示。默认勾选“使用示例数据”,展示余额、预算、Go、套餐、峰谷和三种模型的完整效果。选中 Codex 或自定义余额时也提供对应示例。取消勾选后展示当前缓存数据,缺失的会话值显示“—”。数据来源的选择仅保存在本机预览偏好中,不更改插件配置或账本。
20
+
21
+ 预览分为侧栏、输入区和会话内容三个区域,使用正常字号,只渲染当前区域。点击虚线框,在右侧调整对应组件。示例模式下隐藏的组件保留淡化效果,方便再次选中;当前数据模式下未显示的组件保留淡色标签。组件菜单只列出可调整的组件,操作提示不再作为菜单选项。显示设置的更改自动保存。
22
+
23
+ 右侧的“侧栏布局”默认展开,展示合并卡片、简洁、标准和紧凑四种样式的小预览,复用实际预算与多时段额度的进度卡片。小预览标记为样式示例,未配置的额度使用本地示例数值。紧凑样式将多时段额度排成两列,预算卡片保持完整。点击峰谷条可切换细条或分段样式;点击“今日金额 · 模型数”可调整模型卡片的展开、周期、摘要、位置、行数、Token 和费用占比条。预算、余额、会话费用和额度条的选项各自放在对应组件旁。金额格式、换算和语言集中在下方。宽窗口将样式缩略图横向排列,窄窗口再改为竖向;右侧面板在空间不足时排到预览下方。放大预览中按 Escape 返回。
24
+
25
+ 侧栏预览和真实侧栏共用完整的呈现函数与当前缓存数据,包含余额错误状态、独立的 Go 与预算卡片、预算摘要、今日用量和峰谷条、模型花费卡片。选择框使用独立覆盖层,不改变组件 DOM 层级和紧凑布局。打开时最多读取三个宿主表面的背景、圆角、字体等六项外观属性;主题属性变化时更新。共用插件组件、DSH 图标和主题变量,跟随这些外观的皮肤修改;其他插件的独立控件不重复挂载。
26
+
27
+ 两种数据来源共用实际展示组件。示例状态只传给预览,不写入配置、余额、额度或账本,也不会启用账户查询或 Codex 探测。预览不复制会话内容,不遍历整页 DOM,不创建 iframe,不解码图片,不订阅会话投影。选择框只测量当前预览内最多 32 个标记节点,使用一个局部尺寸监听器;关闭时清理尺寸与主题监听器。异常组件由预览内部的错误边界隔离,仍可使用详细显示选项。
28
+
29
+ 预算显示和预算统计分别控制。隐藏预算卡片不会关闭预算统计;隐藏峰谷条不会关闭峰谷计价;显示 Go 占位不会启用账户查询。
30
+
31
+ 原生图标的来源和许可证见仓库根目录 THIRD_PARTY_NOTICES.md。
32
+
33
+ 侧栏区域上方直接提供预算、今日用量、峰谷时段和模型花费四个显示开关,不必先选中组件。今日用量单行与“今日金额 · 模型数”摘要分别控制;关闭其中一个不影响其他组件,没有其他组件时也可以只显示峰谷条。隐藏侧栏今日用量不会隐藏概览里的今日费用,预算详细信息开关也不影响今日用量。所有组件关闭时不保留空白区域。
34
+
35
+ 选择套餐进度条后,可以在同一面板选择 MiniMax 等账户、调整该账户的显示位置和侧栏开关。切换账户只切换编辑对象,不启用额度查询;进度条方向统一应用于所有套餐。需要修改凭据或查询参数时,点击“账户与额度设置”直接展开并定位到所选账户。
36
+
37
+ 价格 → 模型定价中,每个模型下方的“计入统计”可展开三个独立开关:今日费用、月度与累计、预算。开关按渠道和模型保存,只改变对应汇总,不删除原始调用或重新定价。重新勾选可恢复统计。今日模型花费摘要跟随今日费用的选择;月度与累计、预算各用自己的选择。
38
+
39
+ 模型定价以固定排序的紧凑列表展示,宽窗口中三项单价按列对齐,窄窗口在模型名下方排列。切换价格来源时模型保留原位置;选择自定义后,只定位一次到自定义编辑区的开头。保存价格或修改币种时不重新滚动。
40
+
41
+ 峰谷时段新增“进度条”样式,显示当前计价时段已过的比例。峰时使用橙色,平价、周末和节假日使用 DSH 主题蓝色。标准侧栏显示完整信息,简洁侧栏使用两行,紧凑侧栏使用单行;可选择倒计时、切换时间或同时显示两者,悬停查看完整说明。周末和节假日会显示下一次切换的星期或日期,进度从连续谷价时段真正开始的时刻计算。
42
+
43
+ 选中峰谷时段后,右侧以三张紧凑的实际效果卡片展示进度条、细条和分段样式,复用侧栏呈现函数,包含当前时段文字、橙蓝轨道和倒计时。蓝色边框和“已选”标明当前选择,样式说明放在悬停提示中,点击后立即更新左侧预览。右侧收窄并减少内边距和重复说明;桌面设置保持左侧预览、右侧调整,与其他组件使用相同的窄屏换行条件。显示时间的完整选项放在右侧卡片下方。预览中超长的时段文字以省略号收起,保留可见轨道,悬停或键盘聚焦可读取完整说明。样式示例只渲染峰谷组件,不挂载余额、额度和模型卡片,也不会把示例开关写入配置。
44
+
45
+ 1.9.43 起,五个显示介绍合并为一个可关闭的首次提示,统一指向「设置 → 费用 → 显示」。已有任一介绍的已读记录会抑制新提示;关闭不会修改显示、查询或计费偏好。峰谷三种布局及预览仍可随时在显示设置中选择,原细条和分段样式保留。预览只读取配置和本机时间,不查询余额、不发送模型请求、不改变计价或历史记录。界面按需加载,页面隐藏时停止刷新,关闭组件时清理定时器和监听器。
46
+
47
+ “费用 → 显示”提供“跟随皮肤透明度”,默认关闭。开启后,费用页共用设置窗口的背景,统计正文不再另铺实心底色;费用明细、引导、提醒与下拉浮层使用皮肤层色,保留至少 90% 不透明度。关闭后立即恢复不透明遮挡效果。该开关只修改插件自己的界面,保存后重启仍生效。
48
+
49
+ “今日用量”右侧提供“费用”和“Token 用量”两个开关,至少保留一项;两项开启时金额与 Token 右对齐并列,空间不足时换行。选中“今日用量”后,两个子项各有虚线,点击对应虚线会定位到该项开关。
50
+
51
+ 拖动排序仅在显示设置的侧栏预览中提供,主界面侧栏按保存顺序正常展示,不显示拖动手柄。预览中可拖动组件,拖到目标卡片的上半部或下半部决定放在前面或后面。手柄聚焦后也可用上下方向键移动。顺序保存到 `sidebarOrder`,重启、切换样式和暂时隐藏组件后保留;不同 Coding Plan 与网关卡片分别排序。Go 与预算使用独立卡片。原模型花费位置选项用于旧配置;手动使用该选项会清除拖动顺序并恢复原位置规则。
52
+
53
+ “合并卡片”将今日 Token 与费用、余额和峰谷进度放入同一外框。选择时默认开启今日双项显示,之后仍可分别关闭。Codex 组件提供额度查询总开关;显式开启其显示时会启用查询。billion-context 的统计偏差说明放在“费用 → 概览”,使用普通灰色文字,不再自动弹窗或提供弹窗开关。
54
+
55
+ “费用 → 显示 → 侧栏”中的“今日消费与余额同行”是独立开关,可与现有布局组合使用。开启时默认只显示今日费用,Token 可在今日组件中单独开启;两项保留悬停详情,余额进度条照常显示,隐藏官方余额时使用第一条可见的自定义余额。排序在设置预览中调整,关闭开关恢复各组件独立排列。
56
+
57
+ ## 点击名称隐藏余额
58
+
59
+ 1.9.45 起,在“设置 → 费用 → 显示 → 侧栏 → 调整组件 → 余额(或自定义余额)”中可以开启“点击名称快速隐藏余额”。默认关闭。开启后,点击余额名称隐藏或显示金额,点击金额继续刷新。隐藏时不显示进度条及悬停金额;四种侧栏布局、同行显示和收起样式共用隐藏状态。本机浏览器记住隐藏状态;关闭选项即恢复原有点击刷新方式。
60
+
61
+ In Settings → Cost → Display → Sidebar → Balance (or Custom balance), enable **Click name to hide balance**. This is off by default. Click the label to hide/show the amount; click the amount to refresh. Hidden balances also hide progress bars and tooltip amounts across sidebar layouts. The browser remembers hidden state. Disabling this option restores the original click-to-refresh behavior.
62
+
63
+ ## 套餐额度圆环
64
+
65
+ 1.9.49 起,在“设置 → 费用 → 显示 → 侧栏 → 调整组件 → 套餐进度条”选择“套餐额度样式 → 开口圆环”,可将多个额度窗口并排显示。默认保留横向进度条;所有套餐共用样式选择,已用/剩余方向继续由原选项控制。鼠标悬停查看完整额度和重置时间,点击或按回车刷新。“隐藏进度条,仅显示紧凑文本”开启时优先显示文本,收起侧栏仍使用原有数字布局。
66
+
67
+ In **Settings → Cost → Display → Sidebar → Plan quota style**, select **Open rings**. The choice applies to Coding Plan cards; used/remaining direction, reset tooltips and refresh remain available. Compact text takes precedence, and collapsed sidebars retain their numeric layout.
@@ -0,0 +1,48 @@
1
+ # DeepSeek 原生搜索计费
2
+
3
+ 宿主的 `web-search-deepseek` provider 直接请求 Anthropic 兼容 Messages API,返回搜索结果时会丢弃响应 `usage`。这条调用不经过 `llm/stream`,旧版本费用统计无法观察。实现核对了 `@deepseek-ai/dsh-web-search-deepseek@0.1.5-rc.1` 的发布源码。
4
+
5
+ 插件在 `ctx.web.search` 的异步作用域内观察 `POST https://api.deepseek.com/anthropic/v1/messages`。Node 的 Undici 响应诊断提供完整响应后,插件提取真实输入、输出、缓存读取和缓存写入 token,按请求发起时间及当前价格配置入账,归属 `deepseek-official` 与调用搜索的会话。相同 token 的多次搜索分别计数。即使后续搜索结果解析失败,已经收到的完整有效 usage 仍代表真实模型消耗。
6
+
7
+ 新 Undici 使用 `undici:request:bodyChunkReceived` 通道;Node 20/22 所带旧 Undici 缺少此通道时,包装匹配请求实例的 `onData` 方法。1.8.5 还为宿主全局 `fetch` 添加范围受限的观察包装:只有搜索上下文内的官方 Messages POST 才会观察 provider 自己调用的 `response.json()`,从已解析对象读取 usage,不复制或提前消费响应流。两条路径共享请求状态,只入账一次;不读取请求头、密钥或搜索正文,不更换 dispatcher、请求参数和取消信号,保留 fetch/json 的 Promise、解析值及异常。卸载时恢复仍由插件持有的 fetch。诊断通道的响应缓冲及解压结果上限均为 4 MiB。
8
+
9
+ 每次已计费用量保存到插件账本旁的 `ledger.json.native-search/<会话 ID 的 SHA-256>.jsonl`,字段仅包含会话 ID、模型、provider、五桶 token、请求发起时间及独立 UUID。每次追加同步落盘;会话费用显示从账本读取,历史导入和币种重算联合读取这些明细及宿主日志,以请求 UUID 去重。即使原宿主日志已不存在,保留下来的搜索明细仍可导入。迁移或备份插件计费数据时,应同时保留账本及这个目录。
10
+
11
+ 插件不再调用宿主 `session.append()` 写入自己的事件。此前的版本会写入没有 `ignorable` 的 `cost-meter/native-search-usage`,DSH 0.1.5-rc.1 / rc.2 在从磁盘读取时因此拒绝整份会话。旧日志仍可识别计费;已受影响会话的备份修复步骤见 [会话与历史恢复说明](session-history-recovery.md)。不根据宿主函数源码中的单词推断追加 API 的能力。
12
+
13
+ 如果响应缺少合法 usage、响应中断、超过缓冲上限或用量事件无法保存,插件不虚构单次金额。当天的覆盖缺口会合并到余额对账提示,以日期和计数持久化到 `ledger.json.native-search-coverage.json`,最多保留 90 天。缺口并不证明该请求一定被供应商收费;它表示无法完整验证该调用的金额或历史。
14
+
15
+ 从 1.7.48 起,宿主 `web/deepseek-search-llm-request` 事件也可为同一异步上下文内随后的一次官方请求建立观察范围,覆盖保存的原始 search 方法。1.8.3 会在工具结束或 60 秒超时后,将未观察到对应请求的事件记为 `request-unobserved`,避免完全没有记录。第三方搜索事件不计入官方缺口。
16
+
17
+ ### #203 运行时诊断
18
+
19
+ 1.8.3 启动观察器后约 1 秒内就会写入上述 coverage 文件。其 `runtime` 保存本次启动时间、PID、Node / 内置 Undici / 插件版本,以及以下计数。重启后 `runtime` 重新计数,`days` 继续保留。文件不保存查询正文、响应正文、会话 ID、环境变量或凭据。
20
+
21
+ | 字段 | 含义 |
22
+ | --- | --- |
23
+ | `webObserved` / `searchScope` | 已观察的 web 服务数量 / 经过包装器的搜索次数 |
24
+ | `searchEvent` / `otherEndpoint` | 收到的宿主搜索事件 / 其中非官方端点事件 |
25
+ | `requestCreateAny` | 匹配前的全部 Undici create 事件,区分通道无事件与过滤未命中 |
26
+ | `requestMethodMismatch` / `requestOriginMismatch` / `requestPathMismatch` | 依次检查 POST、官方 origin、Messages path 时的未命中计数;不保存字段原文 |
27
+ | `fetchRequest` / `fetchResponse` | 进入兼容观察的官方搜索 fetch / 需要兼容路径处理的已解析响应 |
28
+ | `officialRequest` / `unscopedRequest` | 当前进程的官方 Messages 请求 / 无搜索上下文的请求;普通模型请求也会进入这两个计数,不据此收费 |
29
+ | `matchedRequest` | 已关联到搜索上下文的请求 |
30
+ | `responseHeaders` / `responseComplete` | 收到响应头 / 完整响应的已关联请求 |
31
+ | `accounted` | 已按真实 usage 入账的请求 |
32
+ | `reasons` | 本次运行中缺少请求、完整响应、有效 usage、入账或持久化的原因计数 |
33
+
34
+ fnOS 的 #203 在 1.8.3 上确认搜索作用域和事件正常、官方请求计数为零。维护侧使用反馈中的 Node 24.15.0 / 内置 Undici 7.24.4 / userland Undici 8.10.2,执行 DSH rc.2 的 `installProxyFromEnvironment()` 生产安装链:代理和 NO_PROXY 直连均能捕获,未复现“该版本组合本身造成漏记”。另用真实 DeepSeek Provider 和无 Undici 诊断的 HTTP transport 验证 1.8.5 的 JSON 兼容路径,可以精确入账。现场具体网络实现仍待升级复测,issue 保留开放。
35
+
36
+ 升级并重启后完成一次搜索,约 1 秒后提供 coverage 文件即可继续区分通道、匹配和 JSON 观察的断点;不用发送账本、搜索正文或 API Key。若文件不存在,需先核对实际插件版本、宿主 PID 和账本目录写入权限。
37
+
38
+ 已经发生、且旧宿主只留下请求日志的搜索无法恢复真实 token。新版本不会把这部分历史估算为精确费用。第三方搜索 endpoint、其他搜索 provider,以及既未通过 `ctx.web.search` 也没有对应搜索事件的直接请求不在此观察范围;改写网络实现且不再提供上述响应能力的宿主需要额外适配。仅有 `server_tool_use` 声明不收费;成功的 `web_search_tool_result` 按唯一工具调用 ID 另记搜索请求费,遵循 2026 年 11 月 1 日开始收费的规则,详见[网页搜索与抓取计费](web-request-fees.md)。
39
+
40
+ 验证覆盖 Node 20/22/24 的真实原生 `fetch`、gzip 响应、独立并发计数、精确端点过滤、取消与错误透传、兼容方法恢复、超限响应、无 usage 及缺口重启留存。DSH 0.1.5-rc.1 / rc.2 使用真实持久化后端产生明文和 Zstandard 日志,复现冷读拒绝,再验证锁竞争、备份修复、继续搜索、追加及再次重启;测试不访问付费接口。CI 在安装的宿主依赖上运行该冷读回归。
41
+
42
+ 相关上游契约:[Undici 诊断通道](https://github.com/nodejs/undici/blob/main/docs/docs/api/DiagnosticsChannel.md)、[响应数据诊断通道讨论](https://github.com/nodejs/undici/issues/4166)、[Anthropic 缓存 token 口径](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)。
43
+
44
+ ## 1.9.49:后加载网络实现与手动补记
45
+
46
+ 针对 [#456](https://github.com/Han-1413141/dsh-cost-meter/issues/456),每次搜索开始及官方搜索事件触发时检查当前全局 fetch;被其他插件替换后,重新添加范围受限的 JSON 响应观察,保留其实际网络实现。新的包装器委托旧包装器时共享请求状态,单次成功请求不重复收费。卸载只恢复费用插件仍持有的包装器。
47
+
48
+ 已用实际发布的 DeepSeek provider 和本地 HTTP 服务器验证后替换场景,包含没有 Undici 诊断的传输;完整浏览器壳环境仍需报告者升级验证。已确认漏记的历史成功请求可用 [record-search 命令](web-request-fees.md#手动补记已确认的漏记请求)补记请求费;缺失模型 Token 与覆盖缺口保持原状。
@@ -0,0 +1,30 @@
1
+ # v1.9.49:套餐圆环、搜索计费与费用核对
2
+
3
+ ## 中文
4
+
5
+ - 套餐侧栏新增可选的开口圆环,将多个额度窗口并排显示,保留已用/剩余方向、重置时间提示、刷新和纯文本模式。感谢 [@Eancen](https://github.com/Eancen) 在 [#455](https://github.com/Han-1413141/dsh-cost-meter/issues/455) 提出布局需求并提供浅色、深色参考图。
6
+ - 修复后加载的网络插件替换 `fetch` 后,原生搜索响应无法被观察的问题;嵌套包装共享请求状态,避免重复计费。感谢 [@loxxa-carry](https://github.com/loxxa-carry) 在 [#456](https://github.com/Han-1413141/dsh-cost-meter/issues/456) 提供宿主版本、诊断计数和手动补记建议。
7
+ - 新增 `record-search` 命令,预览或补记已确认漏记的成功搜索请求费;同一记录 ID 重试不会重复入账,保留手动来源与历史回放。不估算缺失的模型 Token。
8
+ - 费用概览新增“计费核对”,显示实际生效的 DeepSeek 价表币种、显示币种及套餐费用口径,并提供价格同步入口。今日费用提示改为“按当前价表计算”。
9
+
10
+ ### 使用方式
11
+
12
+ 1. **圆环**:设置 → 费用 → 显示 → 侧栏 → 调整组件 → 套餐进度条,将“套餐额度样式”改为“开口圆环”。默认仍是横向进度条;“隐藏进度条,仅显示紧凑文本”优先生效。
13
+ 2. **核对人民币费用**:设置 → 费用 → 概览 → 计费核对 → 查看并同步官方价表。人民币账户选择 CNY 官方价格,等待保存后执行同步;仅修改显示币种或选择同步币种不会更换正在使用的价表。
14
+ 3. **搜索漏记**:升级并完全重启 DSH,之后的成功搜索会重新观察。若确认旧记录漏记了成功请求,可按[搜索计费说明](web-request-fees.md#手动补记已确认的漏记请求)先预览,再追加 `--apply`。覆盖缺口计数本身不能当作成功次数。
15
+
16
+ ### 费用偏高检查
17
+
18
+ 已复现币种差异:Flash 谷价每百万输出 Token 为 $0.60 或 ¥4;美元价乘以 7.2 得到 ¥4.32。两套官方报价不能靠切换显示币种互相替代。新增提示使用实际价表单位,尚未同步时会明确显示。
19
+
20
+ 同时检查缓存和推理 Token、累积用量、包装路由、峰谷时段、套餐/API 分类、倍率、历史汇率、并发入账和搜索请求费。检查范围、复现数据和测试入口见[计费检查记录](billing-review-2026-11-02.md)。群内截图没有厂商、模型、渠道或对照金额,不能将上述币种差异认定为该次反馈的确定原因。
21
+
22
+ ## English
23
+
24
+ Coding Plan cards now offer open-ring gauges through **Settings → Cost → Display → Sidebar → Plan quota style**. Bars remain the default; compact text takes precedence. Refresh, reset-time tooltips and used/remaining directions are retained.
25
+
26
+ Native-search observation now reconnects when a later plugin replaces global `fetch`, without replacing the transport or counting nested observers twice. The `record-search` CLI supports explicit, idempotent corrections of confirmed missing successful request fees. It previews by default and requires `--apply` to write; model-token gaps remain visible.
27
+
28
+ The overview's billing check identifies the active DeepSeek price currency, display currency and subscription-equivalent basis. It links to official price synchronization without changing rates or recalculating history on its own. USD rates converted to CNY can differ from official CNY prices; for example $0.60 × 7.2 = ¥4.32 versus the published ¥4 Flash off-peak output rate.
29
+
30
+ Thanks to @Eancen for the layout request and references in #455, and @loxxa-carry for the runtime diagnostics and correction-workflow suggestion in #456.
@@ -1,32 +1,52 @@
1
- # DeepSeek 网页搜索与抓取计费
2
-
3
- ## 中文
4
-
5
- v1.9.16 读取 DSH `web.searchProvider`/`web.fetchProvider`,按调用开始时的选择与实际接口区分旧版 Messages 搜索、新版 Search/Fetch API。原有官方 `POST /v1/tools/search` 和 `POST /v1/tools/fetch` 的次数费。根据 [官方指南](https://api-docs.deepseek.com/zh-cn/guides/search/)与[价格页](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/),两者均为每 1,000 次成功请求 ¥5,即每次 ¥0.005。
6
-
7
- - 只计 HTTP 200 且有结果的请求:Search 的 `results` 非空;Fetch 返回非空网页正文。搜索结果条数不影响价格。
8
- - 失败、空结果、无正文、超时和取消不会凭空生成费用。同一请求同时经过网络诊断与 JSON 观察时只计一次,重试则分别判断是否成功。
9
- - 费用计入会话、每日、预算及 API 支出;统计明细显示“搜索请求/抓取请求”和“次数 × 每次单价”。五类模型 Token 不增加,也不套用模型倍率、Coding Plan 或峰谷折扣。
10
- - 记录保存在插件自己的用量文件中,保留请求标识、类型、单价和时间,不保存 URL、搜索词、页面正文或凭据。历史回放按请求去重,沿用调用当时的汇率;升级不为旧调用估补次数费。
11
-
12
- **区分三个来源:**
13
-
14
- | 来源 | 本版处理 |
15
- |---|---|
16
- | 官方独立 Search/Fetch API | 在 DSH 网页服务或工具执行期间观察真实成功响应,按上面的规则入账。支持直接工具调用及宿主网页服务调用。 |
17
- | DSH 的本地 HTTP 抓取后端 | 没有官方 Fetch API 请求就不增加次数费。模型随后阅读网页的 Token 仍由正常用量记录计费。 |
18
- | 旧版 Messages/服务端内置搜索 | 保留模型 Token 费用。观察到成功且有结果的服务端搜索时,按实际调用另记请求:北京时间 2026 年 11 月 1 日 00:00 前免请求费,此后每次 ¥0.005;没有成功证据时不估补。 |
19
-
20
- 只有官方域名和精确端点被纳入上述固定单价,第三方渠道不会被强行套价。没有会话/工具作用域的独立进程请求不在此插件的观察范围。插件不主动发起搜索或抓取,不替换提供方,不自动重试,也不修改宿主网络策略。
21
-
22
- “网页抓取”在用途图、矩形图、代理归属和步骤筛选中独立显示。它汇总相关模型步骤与已观察到的 Fetch API 次数费;同一步混用搜索和抓取归入“多类工具”,费用只计一次。次数费不能作为模型价格表中的 Token 单价编辑。
23
-
24
- 验证使用真实 DSH 工具注册、Web 服务和 HTTP 传输,官方请求地址被测试连接固定到本机服务器;不使用真实 Key 或收费接口。另覆盖空结果、失败、并发会话、重复观察、重启、历史汇率和旧宿主。
25
-
26
- ## English
27
-
28
- v1.8.35 meters the official standalone Search and Fetch endpoints separately from model tokens: CNY 5 per 1,000 successful requests. Only HTTP 200 with nonempty search results or fetched content is charged. Failures and empty results do not incur a request fee; the number of search results does not multiply it.
29
-
30
- Request fees use their own billing rows, remain API expenses, and retain historical exchange rates. They do not add tokens or inherit model multipliers, peak discounts or subscriptions. Observations are limited to exact official endpoints in DSH web/tool execution scopes; local HTTP fetching and third-party providers are not assigned this price. Journals contain no queries, URLs, page bodies or credentials. The plugin makes no search/fetch requests itself.
31
-
32
- Legacy Messages search retains model-token accounting. Observed successful server-side searches have a request-fee waiver until November 1, 2026 at 00:00 Beijing time, then cost CNY 0.005 per request. Selection is read from DSH’s live web settings and snapshotted at call start; historical records retain their source and rate. Presentation items alone do not create charges. See the [official billing rules](https://api-docs.deepseek.com/guides/search/).
1
+ # DeepSeek 网页搜索与抓取计费
2
+
3
+ ## 中文
4
+
5
+ v1.9.16 读取 DSH `web.searchProvider`/`web.fetchProvider`,按调用开始时的选择与实际接口区分旧版 Messages 搜索、新版 Search/Fetch API。原有官方 `POST /v1/tools/search` 和 `POST /v1/tools/fetch` 的次数费。根据 [官方指南](https://api-docs.deepseek.com/zh-cn/guides/search/)与[价格页](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/),两者均为每 1,000 次成功请求 ¥5,即每次 ¥0.005。
6
+
7
+ - 只计 HTTP 200 且有结果的请求:Search 的 `results` 非空;Fetch 返回非空网页正文。搜索结果条数不影响价格。
8
+ - 失败、空结果、无正文、超时和取消不会凭空生成费用。同一请求同时经过网络诊断与 JSON 观察时只计一次,重试则分别判断是否成功。
9
+ - 费用计入会话、每日、预算及 API 支出;统计明细显示“搜索请求/抓取请求”和“次数 × 每次单价”。五类模型 Token 不增加,也不套用模型倍率、Coding Plan 或峰谷折扣。
10
+ - 记录保存在插件自己的用量文件中,保留请求标识、类型、单价和时间,不保存 URL、搜索词、页面正文或凭据。历史回放按请求去重,沿用调用当时的汇率;升级不为旧调用估补次数费。
11
+
12
+ **区分三个来源:**
13
+
14
+ | 来源 | 本版处理 |
15
+ |---|---|
16
+ | 官方独立 Search/Fetch API | 在 DSH 网页服务或工具执行期间观察真实成功响应,按上面的规则入账。支持直接工具调用及宿主网页服务调用。 |
17
+ | DSH 的本地 HTTP 抓取后端 | 没有官方 Fetch API 请求就不增加次数费。模型随后阅读网页的 Token 仍由正常用量记录计费。 |
18
+ | 旧版 Messages/服务端内置搜索 | 保留模型 Token 费用。观察到成功且有结果的服务端搜索时,按实际调用另记请求:北京时间 2026 年 11 月 1 日 00:00 前免请求费,此后每次 ¥0.005;没有成功证据时不估补。 |
19
+
20
+ 只有官方域名和精确端点被纳入上述固定单价,第三方渠道不会被强行套价。没有会话/工具作用域的独立进程请求不在此插件的观察范围。插件不主动发起搜索或抓取,不替换提供方,不自动重试,也不修改宿主网络策略。
21
+
22
+ “网页抓取”在用途图、矩形图、代理归属和步骤筛选中独立显示。它汇总相关模型步骤与已观察到的 Fetch API 次数费;同一步混用搜索和抓取归入“多类工具”,费用只计一次。次数费不能作为模型价格表中的 Token 单价编辑。
23
+
24
+ 验证使用真实 DSH 工具注册、Web 服务和 HTTP 传输,官方请求地址被测试连接固定到本机服务器;不使用真实 Key 或收费接口。另覆盖空结果、失败、并发会话、重复观察、重启、历史汇率和旧宿主。
25
+
26
+ ### 手动补记已确认的漏记请求
27
+
28
+ 1.9.49 新增 `record-search`。先核对官网或实际成功响应,确定漏记次数;`request-unobserved` 只说明没有捕获到请求,不能直接用作成功次数。以下命令使用示例时间和次数,执行前替换为实际数据:
29
+
30
+ ```powershell
31
+ npx --yes --package=dsh-cost-meter@1.9.49 dsh-cost-meter record-search --ledger "C:\path\to\ledger.json" --count 3 --at "2026-11-02T10:00:00+08:00" --id "search-correction-20261102-01" --session "session-id"
32
+ ```
33
+
34
+ 默认只输出预览;核对 `added`、`rateCny` 和 `amountCny` 后,在同一命令末尾追加 `--apply` 写入。省略 `--ledger` 时使用 `DSH_HOME/storages/cost-meter/ledger.json`,未设置 DSH_HOME 则使用用户目录的 `.dsh`;省略 `--session` 时归入独立补记会话。
35
+
36
+ - `--count` 为已确认成功且尚未计费的请求数,1~10000;八条搜索结果仍是一条成功请求。
37
+ - `--at` 为带时区的实际发生时间,不能晚于当前时间或早于最后一次清空历史。
38
+ - `--id` 是本次补记的稳定标识。重试必须使用相同 ID 和参数;重复执行不会再次收费。不同 ID 视为不同补记,不能给同一批请求换 ID 重复执行。
39
+ - `--source server-tool` 为默认值,按服务端工具收费起点计算;独立 Search API 使用 `--source search-api`。
40
+ - 只补请求费,不补模型 Token,不消除原覆盖缺口,不自动推断未观察到的请求是否成功。
41
+
42
+ 补记元数据保存在账本旁的 `ledger.json.native-search-manual/`;历史明细保留 `recordedBy: manual`。备份时一并保留账本、该目录及 `ledger.json.native-search/`。写入与正常计费共用账本锁、原子替换和请求去重;中断后可用原命令重试。
43
+
44
+ ## English
45
+
46
+ v1.8.35 meters the official standalone Search and Fetch endpoints separately from model tokens: CNY 5 per 1,000 successful requests. Only HTTP 200 with nonempty search results or fetched content is charged. Failures and empty results do not incur a request fee; the number of search results does not multiply it.
47
+
48
+ Request fees use their own billing rows, remain API expenses, and retain historical exchange rates. They do not add tokens or inherit model multipliers, peak discounts or subscriptions. Observations are limited to exact official endpoints in DSH web/tool execution scopes; local HTTP fetching and third-party providers are not assigned this price. Journals contain no queries, URLs, page bodies or credentials. The plugin makes no search/fetch requests itself.
49
+
50
+ Legacy Messages search retains model-token accounting. Observed successful server-side searches have a request-fee waiver until November 1, 2026 at 00:00 Beijing time, then cost CNY 0.005 per request. Selection is read from DSH’s live web settings and snapshotted at call start; historical records retain their source and rate. Presentation items alone do not create charges. See the [official billing rules](https://api-docs.deepseek.com/guides/search/).
51
+
52
+ The `record-search` command previews confirmed missing successful search fees; add `--apply` to persist them. Reuse the same `--id`, timestamp, count and session when retrying. `--source server-tool` observes the server-tool waiver; `--source search-api` selects direct Search API fees. The command never infers successful counts from coverage gaps and never fabricates model tokens. Manual records and metadata are retained next to the ledger.
@@ -3,23 +3,28 @@ import { parseArgs } from 'node:util'
3
3
  import { resolve, join } from 'node:path'
4
4
  import { homedir } from 'node:os'
5
5
  import { manageBillionStorage } from './billion-context-storage.js'
6
+ import { recordManualSearchFees } from './native-search-manual.js'
6
7
 
7
8
  try {
8
9
  const { values, positionals } = parseArgs({ allowPositionals: true, options: {
9
10
  ledger: { type: 'string' }, 'older-than': { type: 'string', default: '7d' },
10
11
  streams: { type: 'boolean' }, groups: { type: 'boolean' }, 'dry-run': { type: 'boolean' },
11
12
  apply: { type: 'boolean', default: false }, help: { type: 'boolean', short: 'h' },
13
+ count: { type: 'string' }, at: { type: 'string' }, id: { type: 'string' }, session: { type: 'string' }, source: { type: 'string' },
12
14
  } })
13
15
  if (values.help || !positionals.length) {
16
+ console.log('dsh-cost-meter record-search --ledger <ledger.json> --count 3 --at <ISO timestamp with timezone> --id <correction-id> [--session <session-id>] [--source server-tool|search-api] [--apply]\n补记已确认成功且漏记的官方搜索请求费;默认预览,--apply 写入。同一 id 重试不会重复收费,不估算 Token。')
14
17
  console.log('dsh-cost-meter clean [--ledger <ledger.json>] [--streams] [--groups] [--older-than 7d|30d|all] [--dry-run | --apply]\n默认预览;--apply 才执行。合并压缩已完成的旧计费流,清理过期请求回执,保留账本、调用记录和历史费用明细。\nPreview by default. --apply compacts completed streams and removes expired receipts; ledger, calls and historical cost details are preserved.')
15
18
  } else {
16
- if (positionals.length !== 1 || positionals[0] !== 'clean') throw Error('Expected command: clean')
19
+ if (positionals.length !== 1 || !['clean', 'record-search'].includes(positionals[0])) throw Error('Expected command: clean or record-search')
17
20
  const retentionDays = { '7d': 7, '30d': 30, all: 0 }[values['older-than']]
18
21
  if (retentionDays === undefined) throw Error('--older-than must be 7d, 30d or all')
19
22
  if (values.apply && values['dry-run']) throw Error('--dry-run and --apply cannot be combined')
20
23
  const both = !values.streams && !values.groups
21
24
  const ledger = values.ledger ? resolve(values.ledger) : join(resolve(process.env.DSH_HOME || join(homedir(), '.dsh')), 'storages', 'cost-meter', 'ledger.json')
22
- console.log(JSON.stringify(await manageBillionStorage(ledger, { retentionDays, apply: values.apply,
23
- streams: both || values.streams === true, groups: both || values.groups === true }), null, 2))
25
+ console.log(JSON.stringify(positionals[0] === 'record-search'
26
+ ? recordManualSearchFees(ledger, values)
27
+ : await manageBillionStorage(ledger, { retentionDays, apply: values.apply,
28
+ streams: both || values.streams === true, groups: both || values.groups === true }), null, 2))
24
29
  }
25
30
  } catch (error) { console.error(error.message); process.exitCode = 1 }