deepseek-cost-meter 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## 0.1.1 — 2026-11-01
+
+- Publish the public npm package as `deepseek-cost-meter`.
+- Align bundle and browser module names; derive the browser module ID from package metadata.
+- Rebuild and run tests before packing, and document migration from the old `@local` package.
+- Preserve pricing, projection and storage identifiers; no accounting behavior changes.
+
+## 0.1.0 — 2026-10-29
+
+Initial community release.
+
+- Show estimated model cost after every completed, failed or interrupted conversation turn.
+- Expand per-model input, cache, output and price details with session totals.
+- Count recorded retries and avoid double-counting cumulative usage or inherited fork history.
+- Keep exact fixed-point amounts and persistent price snapshots.
+- Support official DeepSeek routes and configurable provider tariffs.
+- Include Chinese and English interface text, unit tests and a local Harness integration check.
+
+Validated on DeepSeek Harness Desktop 0.2.1-rc.3 for macOS. Built-in peak-calendar coverage ends on 2026-12-31. Estimates exclude independent subagents, title generation, tool fees and account adjustments.

package/CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing / 参与贡献
+
+欢迎提交可复现的问题、定价修正和 Pull Request。中文和英文均可。
+
+## Local development
+
+Use Node.js 22+ and npm:
+
+```sh
+npm ci --ignore-scripts
+npm run build
+npm run check
+npm pack
+```
+
+Edit `src/client-factory.js` or `locale/*.json`, then regenerate and commit `client.js`. Keep dependencies pinned and commit `package-lock.json`. Use two spaces, LF endings and descriptive commit messages.
+
+For an optional integration check on macOS with Harness installed:
+
+```sh
+ELECTRON_RUN_AS_NODE=1 '/Applications/DeepSeek Harness.app/Contents/MacOS/DeepSeek Harness' \
+  --expose-internals scripts/runtime-smoke.cjs
+```
+
+`DSH_RUNTIME_ROOT` can override the runtime directory. The check uses a temporary storage directory and synthetic events with flat fixture prices, makes no model calls, and removes its temporary data. It requires the real Harness runtime and is not part of hosted CI.
+
+## Changes worth testing
+
+- Pricing: UTC+8 peak boundaries, holidays, expired calendars, currency separation and exact arithmetic.
+- Usage: retries, interruptions, missing counters, cumulative samples and reasoning-token inclusion.
+- Projection: persisted-state replay, forks, completed-turn totals and disposal.
+
+For pricing changes, include an official source, verification date and effective date. Do not infer missing usage or unknown provider pricing. Update `CHANGELOG.md` for user-facing changes. Bump projection checkpoint compatibility if an algorithm change makes old state invalid.
+
+## Pull requests
+
+Explain the problem, resulting behavior, and verification performed. Keep changes focused. CI must pass; runtime integration results should identify the tested Harness version. Avoid adding personal conversations, API keys, account identifiers or machine-specific paths to fixtures and screenshots.
+
+Be respectful and constructive. Code and documentation contributions are accepted under this repository's MIT License; do not copy code whose license is incompatible.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 deepseek-cost-meter contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,110 @@
+# DeepSeek Harness Cost Meter
+
+English · [简体中文](README.md)
+
+[![CI](https://github.com/luomuwen/deepseek-cost-meter/actions/workflows/ci.yml/badge.svg)](https://github.com/luomuwen/deepseek-cost-meter/actions/workflows/ci.yml)
+
+An independent MIT-licensed community plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). Show estimated model costs after each conversation turn, with expandable token, price and session-total details. Not affiliated with or endorsed by DeepSeek.
+
+```text
+Estimated model cost CNY 0.012300 · 1 call
+  Uncached input: 1,000 tokens
+  Cache read:     2,000 tokens
+  Output:          100 tokens
+```
+
+The example uses the bundled peak rate for deepseek-v4-pro. Amounts are estimates based on recorded API usage and configured prices, not account billing records.
+
+## Install
+
+Recommended npm installation:
+
+```sh
+dsh plugin --profile desktop add deepseek-cost-meter
+# Web profile:
+dsh plugin --profile web add deepseek-cost-meter
+```
+
+On macOS without a global `dsh`, use `/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh`.
+
+### Upgrade from 0.1.0
+
+Save any custom `config.rates`, remove the old `@local/deepseek-cost-meter` package, then install the new package. Do not enable both:
+
+```sh
+dsh plugin --profile desktop remove @local/deepseek-cost-meter
+dsh plugin --profile desktop add deepseek-cost-meter
+```
+
+Reapply custom prices and restart Harness. Storage and projection identifiers stay unchanged so existing price snapshots remain usable.
+
+### Source or release archive
+
+Tested with DeepSeek Harness Desktop **0.2.1-rc.3 on macOS**. Other versions and platforms are unverified. Source installation requires Node.js 22+, npm and Git.
+
+```sh
+git clone https://github.com/luomuwen/deepseek-cost-meter.git
+cd deepseek-cost-meter
+npm ci --ignore-scripts
+bash scripts/install-local.sh
+```
+
+The installer uses the bundled macOS Desktop CLI when available; otherwise it uses `dsh` on PATH and the `web` profile. Pass `desktop` or `web` to override the profile. This links the source directory: keep it in place and restart Harness after installation or code changes.
+
+Manual installation:
+
+```sh
+dsh plugin --profile desktop add "$PWD"
+```
+
+On macOS, the bundled CLI is `/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh`. For Web, use `--profile web` and restart `dsh web`.
+
+Alternatively, download a `.tgz` from [Releases](https://github.com/luomuwen/deepseek-cost-meter/releases) and install it with `dsh plugin --profile desktop add /absolute/path/package.tgz`. `npm pack` builds the package locally. Zod is bundled; React is provided by Harness. The public npm package is `deepseek-cost-meter`.
+
+## Accounting model
+
+- A turn runs from `turn/start` to `turn/end`, including recorded retries in that session.
+- Uses persisted usage events, never token estimates from text length. Cumulative samples are replaced by their final value.
+- Uncached input, cache reads, cache writes and output are disjoint. Reasoning tokens are already included in output.
+- Uses exact fixed-point integer arithmetic, displayed to six decimal places.
+- Missing usage or prices is shown as incomplete, not free. Known totals may be partial.
+- Inherited fork history is displayed without adding it to new session spending.
+- Excludes independent subagent sessions, title generation, search/fetch and other tool fees, discounts and account adjustments.
+- No API key, additional model calls or telemetry. Aggregate state does not copy prompts, responses or tool payloads.
+
+## Prices and configuration
+
+The bundled CNY tariff was checked on **2026-10-29** against [DeepSeek's official pricing](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/). It applies from that date; earlier prices are unknown. Peak-calendar coverage ends on **2026-12-31**. Expired calendars are marked unavailable instead of silently using stale rules.
+
+Prices are per million tokens. Official `deepseek`, `deepseek-official` and `deepseek-account` routes are supported. Unrecognized providers do not inherit official prices. Cache writes default to the uncached-input rate. Peak requests are approximated using the step/retry start timestamp in UTC+8.
+
+Edit `rates.json` and restart, or supply the complete same-shaped object under the plugin's `config.rates`. Decimal prices must be strings with up to six fractional digits. Omit `peak` for flat pricing. See the [Chinese configuration guide](README.md#修改价格) and [architecture](docs/architecture.md) for the full contract.
+
+Rate changes append immutable snapshots to Harness storage. The initial snapshot starts at `effectiveFrom`; later changes take effect when loaded. Old calls use their saved price history. Losing that history prevents exact reconstruction: this is not an accounting ledger.
+
+## Development
+
+```sh
+npm ci --ignore-scripts
+npm run build
+npm run check
+npm pack
+```
+
+CI checks syntax, unit tests, deterministic client generation and package contents on Node.js 22 and 24. The real Harness integration check needs a separate local Harness installation; it is not run in hosted CI. See [CONTRIBUTING.md](CONTRIBUTING.md) and [VERIFICATION.md](VERIFICATION.md).
+
+## Uninstall
+
+Disable or remove the plugin in Harness, or run:
+
+```sh
+dsh plugin --profile desktop remove deepseek-cost-meter
+```
+
+Restart Harness if needed. The plugin does not modify conversation logs; price snapshots are retained by Harness storage.
+
+## Community and license
+
+[Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [Changelog](CHANGELOG.md) · [MIT License](LICENSE)
+
+DeepSeek and DeepSeek Harness names belong to their respective owners.

package/README.md

@@ -1,3 +1,157 @@
-# Temporary Holding Version
+# DeepSeek Harness Cost Meter
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[English](README.en.md) · 简体中文
+
+[![CI](https://github.com/luomuwen/deepseek-cost-meter/actions/workflows/ci.yml/badge.svg)](https://github.com/luomuwen/deepseek-cost-meter/actions/workflows/ci.yml)
+
+独立社区插件，采用 MIT 许可证；与 DeepSeek 官方无隶属关系。
+
+在每轮回复下方显示 **本轮模型费用约 CNY 0.012300 · 1 次调用**。点击展开模型、token、单价、峰谷时段及累计费用。支持正常完成、错误和中断轮次。
+
+兼容性：已在 macOS 桌面版 **DeepSeek Harness 0.2.1-rc.3** 验证。使用 `sessionProjections`、`storageDomain`、`conversation.chat.turnTail` 和 `useProjection`；其他版本需要重新验证。
+
+## 安装
+
+推荐通过 npm 包名安装（Node.js 22+ 的 Harness 环境）：
+
+```sh
+dsh plugin --profile desktop add deepseek-cost-meter
+# Web profile:
+dsh plugin --profile web add deepseek-cost-meter
+```
+
+macOS 桌面版没有全局 `dsh` 时，使用应用自带的 `/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh`。
+
+### 从 0.1.0 升级
+
+旧包名是 `@local/deepseek-cost-meter`。请先保存自行配置的 `config.rates`，移除旧包再安装新包，不要同时启用两者：
+
+```sh
+dsh plugin --profile desktop remove @local/deepseek-cost-meter
+dsh plugin --profile desktop add deepseek-cost-meter
+```
+
+安装后重新应用自定义价格并重启 Harness。存储域和投影标识保持不变，可继续使用原有价格快照。
+
+### 源码或安装包
+
+需要已安装的 DeepSeek Harness。源码安装和开发需要 Node.js 22 或更新版本、npm 和 Git；已验证的 Harness 版本见上文。
+
+```sh
+git clone https://github.com/luomuwen/deepseek-cost-meter.git
+cd deepseek-cost-meter
+npm ci --ignore-scripts
+bash scripts/install-local.sh
+```
+
+安装脚本优先使用 macOS 桌面版自带 CLI；其他环境使用 PATH 中的 `dsh`，默认安装到 `web` profile。可以用 `bash scripts/install-local.sh desktop` 指定 profile。这是本地链接安装，请保留源码目录。若界面未立即更新，退出并重新打开 Harness。
+
+手动安装：
+
+```sh
+dsh plugin --profile desktop add "$PWD"
+# Web profile:
+dsh plugin --profile web add "$PWD"
+```
+
+macOS 桌面版若没有全局 `dsh`，使用 `/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh` 替代命令。插件不需要 API Key，不会发起额外模型请求。
+
+也可以从 [Releases](https://github.com/luomuwen/deepseek-cost-meter/releases) 下载 `.tgz` 安装包：
+
+```sh
+dsh plugin --profile desktop add /absolute/path/deepseek-cost-meter-0.1.1.tgz
+```
+
+运行 `npm pack` 可自行打包。运行依赖 zod 随包分发；React 由 Harness 提供。npm 包名为 `deepseek-cost-meter`，公开发布到 npm registry；市场展示名保持“DeepSeek Cost Meter（每轮费用）”。
+
+## 计费口径
+
+- 一轮为 `turn/start` 到 `turn/end`，包括本会话内各步骤和已记录的重试尝试。
+- 读取 API 返回的持久化 usage，不使用字符数估算 token。不把多个累计 usage 样本相加。
+- 输入、缓存读取、缓存写入、输出是互斥桶；推理 token 已包含在输出中，不重复收费。
+- 默认缓存写入按未缓存输入价计算；若服务商采用其他规则，请显式配置。
+- 缺少 usage、模型价格或缓存拆分时显示不完整；已知金额为部分合计，不代表最终账单。
+- 不含子 Agent 独立会话、标题生成、Search/Fetch、其他工具费用及账户优惠。
+- 金额用 BigInt 定点计算，持久状态用十进制字符串，显示六位小数。
+- 分叉继承记录可显示，累计新增费用不重复包含继承历史。
+- 每轮展示的累计值固定为截至该轮结束时的值。多币种分别显示，不自动换汇。
+
+## 默认价格
+
+核验日期：2026-10-29；来源：[DeepSeek 官方人民币定价](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/)。币种 CNY，单位元 / 百万 token。
+
+| 模型 | 时段 | 未缓存输入 | 缓存命中 | 输出 |
+|---|---|---:|---:|---:|
+| deepseek-flash | 空闲 | 1 | 0.02 | 4 |
+| deepseek-flash | 高峰 | 2 | 0.04 | 8 |
+| deepseek-v4-pro | 空闲 | 4.5 | 0.15 | 13.5 |
+| deepseek-v4-pro | 高峰 | 9 | 0.30 | 27 |
+
+峰值窗口为北京时间周一至周五 09:00–12:00、14:00–18:00，周末和配置中的节假日除外。按 `step/start` / `llm/retry-started` 时间近似请求开始时间；跨边界请求仍属于估算。
+
+内置表只回算 **2026-10-29 00:00（北京时间）及以后**的记录。该日期前不猜测历史价。内置节假日日历覆盖到 2026-12-31，此覆盖区间内无中国法定节假日；进入 2027 年后会提示更新日历，避免套用未经核验的时段规则。
+
+`deepseek-v4-flash`、`deepseek-v4-flash-vision-exp` 按官方别名规则使用 Flash 价格。支持 Harness 官方路由 `deepseek-official`、登录账号路由 `deepseek-account`，以及 `deepseek`；前两者没有显式价格行时使用 `deepseek` 价格。账号路由也仅按公开 API 价格估算，不读取账户实际扣款。其他 provider 不自动套用官方价格，即使模型名称相同。
+
+## 修改价格
+
+首次安装可修改 `rates.json`。运行后修改该文件并重启，或通过个人配置中对应插件行的 `config.rates` 指定完整同结构价格表。示意：
+
+```yaml
+- id: local-deepseek-cost-meter
+  config:
+    rates:
+      version: my-provider-2026-11-01
+      source: manual
+      effectiveFrom: '2026-11-01T00:00:00+08:00'
+      calendarThrough: '2027-12-31'
+      holidays: []
+      prices:
+        - provider: my-provider
+          models: [my-model]
+          currency: CNY
+          offPeak:
+            input: '1'
+            cacheRead: '0.02'
+            cacheWrite: '1'
+            output: '4'
+```
+
+不提供 `peak` 则全天使用 `offPeak`。价格以字符串填写，最多六位小数。配置是完整替换，需保留仍要使用的其他模型行；高峰日历需提供实际节假日，不应随意延长覆盖期。
+
+每次价格配置变化会向 Harness 存储域 `local_turn_cost_prices` 追加不可变快照。首次快照从 `effectiveFrom` 回算；后续快照从加载新配置的时间生效。已保存的旧快照继续用于旧调用；卸载不会删除快照。更新算法或价格目录时投影缓存自动重建。丢失该存储域后只能按剩余价格表回算，因此此插件不是财务账本。
+
+## 开发与验证
+
+```sh
+npm ci
+npm run build
+npm run check
+ELECTRON_RUN_AS_NODE=1 '/Applications/DeepSeek Harness.app/Contents/MacOS/DeepSeek Harness' \
+  --expose-internals scripts/runtime-smoke.cjs
+```
+
+- `src/pricing.js`：价格校验、峰谷规则、定点计算。
+- `src/projection.js`：增量处理调用尝试、轮次汇总和分叉边界。
+- `index.js`：价格快照与 Host 投影注册。
+- `src/client-factory.js`：原生插槽组件；`client.js` 是生成产物。
+- `locale/`：中英文文案；`icon.svg`：原创图标。
+
+统计状态只保存每轮聚合明细，不复制提示词、回答、工具结果或 API Key。空间随轮数和不同模型/价格组合数增长。客户端通过投影读取结果，不扫描聊天 DOM，不修改对话内容。插件不增加模型 token，也不改变 KV Cache。
+
+## 卸载
+
+可在 Harness 插件页关闭或移除“每轮费用”。也可运行：
+
+```sh
+"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
+  plugin --profile desktop remove deepseek-cost-meter
+```
+
+若当前进程未自动卸载，请重启应用。会话日志不会被插件改写。
+
+## 参与贡献与许可
+
+欢迎提交 Issue 和 Pull Request。请先阅读 [贡献指南](CONTRIBUTING.md)、[安全政策](SECURITY.md) 和 [更新记录](CHANGELOG.md)。详细架构见 [架构说明](docs/architecture.md)，手动集成验证记录见 [VERIFICATION.md](VERIFICATION.md)。
+
+采用 [MIT License](LICENSE)。DeepSeek Harness 是 [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) 项目；相关名称与商标归各自所有者所有。

package/SECURITY.md

@@ -0,0 +1,17 @@
+# Security policy
+
+## Supported versions
+
+Security fixes target the latest release on `main`. This project is a community plugin and does not guarantee compatibility with every Harness version.
+
+## Reporting a vulnerability
+
+Use this repository's **Security → Report a vulnerability** private reporting flow when available. If it is unavailable, open an issue asking for a private contact channel without including exploit details or sensitive data. Do not attach API keys, full conversation logs, credentials or personal account data to public issues.
+
+Include the plugin version, Harness version, operating system, affected component, impact and a minimal sanitized reproduction. There is no guaranteed response time.
+
+## Data handling
+
+The plugin reads local session events and stores aggregate usage/cost projections and price snapshots through Harness services. It does not send telemetry or issue model API requests. It does not intentionally copy prompts, answers, tool results or credentials into its own state. It runs with the permissions of the Harness host; it is not a security boundary.
+
+A cost estimate is not a spending limit or a billing guarantee. Missing usage, unavailable tariffs and expired calendars must remain visible as incomplete.

package/VERIFICATION.md

@@ -0,0 +1,23 @@
+# 本地验证记录
+
+## 0.1.1 npm 发布验证（2026-11-01）
+
+- 17 项单元与包元数据测试通过；检查 npm 包名、Cordis 引用和生成客户端注册 ID 一致。
+- 将实际 `.tgz` 解包到隔离目录，以 `DSH_COST_PLUGIN_ROOT` 指向该目录运行真实 Harness 集成检查，验证 Host 加载、生成客户端渲染、价格存储及卸载/重载。
+- 保留原有投影、配置行和存储域标识，未改计费算法。
+
+## 0.1.0 首次验证
+
+日期：2026-10-29；环境：macOS、DeepSeek Harness Desktop 0.2.1-rc.3。
+
+- `npm run check`：15 项计费测试全部通过，Host 和生成的 Client JavaScript 语法检查通过。
+- `scripts/runtime-smoke.cjs`：使用已安装 Harness 的真实 Cordis、Session、Projection、JSON Storage 服务验证注册、事件驱动、价格持久化、卸载和重新加载；使用 React 18.2 验证组件渲染与清理。
+- 隔离 profile：通过官方 `dsh plugin --profile web add` 安装，使用临时 `DSH_HOME` 启动真实 Web composition，插件成功激活。
+- 实际 Desktop profile：通过应用附带官方 CLI 安装。插件页出现“每轮费用”，启用状态为 on。重启后，现有历史对话成功显示每轮费用、调用次数、缓存及输出明细和累计金额。
+- 官方账号路由 `deepseek-account` 在真实界面验证通过；普通 API 路由 `deepseek-official` 有自动化覆盖。
+- `npm pack`：生成包含全部运行文件、原创 SVG 图标、中英文文案以及 zod 4.6.7 的安装包。
+- 依赖安装审计：0 个已知漏洞。没有发起额外收费模型请求，没有改写用户会话日志。
+
+限制：没有向真实 API 新发请求测试流式网络过程；该部分由持久化事件测试覆盖。未验证其他 Harness 版本、Windows/Linux、2027 年峰谷日历及第三方提供商账单。
+
+首次热安装时，已经连接的旧会话可能暂时显示“费用统计正在加载”；重启 Harness 后恢复正常。修改插件代码后也需重启以加载新模块。

package/client.js

@@ -0,0 +1,84 @@
+// Generated by npm run build. Edit src/client-factory.js and locale/*.json.
+window.__ModuleLoader__.load({
+  id: "deepseek-cost-meter",
+  factory(require) {
+/** Browser factory: only React is shared with the host. Generated artifact embeds dictionaries. */
+function clientFactory(require, dictionaries) {
+  const React = require('react');
+  const h = React.createElement;
+  const ns = 'local-turn-cost';
+  const css = `
+    .dsh-cost-meter { margin: 6px 0; color: var(--dsw-alias-label-secondary); font-size: 12px; line-height: 1.6; }
+    .dsh-cost-meter summary { cursor: pointer; width: fit-content; max-width: 100%; padding: 4px 8px; border-radius: 6px; }
+    .dsh-cost-meter summary:hover { background: var(--dsw-alias-interactive-bg-hover); }
+    .dsh-cost-meter summary:focus-visible { outline: 2px solid currentColor; outline-offset: 2px; }
+    .dsh-cost-meter .cost-body { border: 1px solid var(--dsw-alias-border-primary); border-radius: 8px; padding: 12px; margin-top: 6px; }
+    .dsh-cost-meter .cost-route { margin: 10px 0 4px; overflow-wrap: anywhere; font-weight: 600; }
+    .dsh-cost-meter .cost-note { margin: 6px 0; color: var(--dsw-alias-label-tertiary); overflow-wrap: anywhere; }
+    .dsh-cost-meter .cost-table-scroll { overflow-x: auto; }
+    .dsh-cost-meter table { border-collapse: collapse; width: 100%; font-variant-numeric: tabular-nums; }
+    .dsh-cost-meter th, .dsh-cost-meter td { padding: 4px 8px; text-align: right; white-space: nowrap; }
+    .dsh-cost-meter th:first-child, .dsh-cost-meter td:first-child { text-align: left; padding-left: 0; }
+    .dsh-cost-meter .cost-amount { font-variant-numeric: tabular-nums; }
+  `;
+
+  function money(pico, currency) {
+    const n = BigInt(pico);
+    const rounded = (n + 500_000n) / 1_000_000n;
+    const whole = rounded / 1_000_000n;
+    const part = (rounded % 1_000_000n).toString().padStart(6, '0');
+    return `${currency} ${n > 0n && rounded === 0n ? '<0.000001' : `${whole}.${part}`}`;
+  }
+  function amounts(totals) {
+    return Object.entries(totals).map(([currency, value]) => money(value, currency)).join(' + ');
+  }
+  function CostTail({ turn, useProjection, t }) {
+    const data = useProjection('localTurnCost');
+    const current = data?.turns?.[turn.turn];
+    if (!current) return h('div', { className: 'dsh-cost-meter', role: 'status' }, t('waiting'));
+    const amount = amounts(current.totals);
+    const title = current.calls === 0 ? t('zero') : !amount ? t('unavailable')
+      : t(current.unknown ? 'partial' : 'summary', { amount });
+    // Stable per-turn snapshot prevents older rows changing as later turns finish.
+    const total = current.sessionTotals ?? {};
+    const note = text => h('p', { className: 'cost-note' }, text);
+    return h('details', { className: 'dsh-cost-meter', 'data-cost-turn': current.turn },
+      h('summary', null, h('span', { className: 'cost-amount' }, title), ' · ', t('calls', { count: current.calls })),
+      h('div', { className: 'cost-body' },
+        current.unknown > 0 && note(t('missing', { count: current.unknown })),
+        current.inherited && note(t('inherited')),
+        ...current.lines.map((row, index) => h('section', { key: index },
+          h('div', { className: 'cost-route' }, `${row.provider} / ${row.model} · `, t('calls', { count: row.calls })),
+          row.issue && note(t(row.issue)),
+          row.usage && h('div', { className: 'cost-table-scroll' }, h('table', null,
+            h('thead', null, h('tr', null, h('th'), h('th', null, t('tokens')), h('th', null, t('price')))),
+            h('tbody', null, ...['input', 'cacheRead', 'cacheWrite', 'output'].map(key =>
+              h('tr', { key }, h('td', null, t(key)), h('td', null, row.usage[key].toLocaleString()),
+                h('td', null, row.rates ? `${row.currency} ${row.rates[key]}` : '—')))))),
+          !row.issue && h('div', { className: 'cost-amount' }, `${t('subtotal')}: ${money(row.amountPico, row.currency)}`),
+          row.version && note(`${t('version')}: ${row.version} · ${t(row.period)}`))),
+        Object.keys(total).length > 0 && h('p', { className: 'cost-amount' }, t('session', { amount: amounts(total) })),
+        current.sessionUnknown > 0 && note(t('sessionPartial')),
+        note(t('scope')), note(t('timeRule')), note(t('history'))));
+  }
+  return {
+    inject: ['slots', 'locale'],
+    apply(ctx) {
+      ctx.effect(() => ctx.locale.register(ns, dictionaries));
+      ctx.effect(() => {
+        const style = document.createElement('style');
+        style.dataset.plugin = 'deepseek-cost-meter';
+        style.textContent = css;
+        document.head.appendChild(style);
+        return () => style.remove();
+      });
+      ctx.slots.inject('conversation.chat.turnTail', () => ctx.slots.register({
+        name: 'conversation.chat.turnTail', id: 'local-deepseek-cost-meter', locale: ns, order: 30,
+      }, CostTail));
+    },
+  };
+}
+
+    return clientFactory(require, {"en":{"meta":{"title":"Turn costs","description":"Show estimated model cost, request counts and token pricing below each completed turn."},"summary":"Estimated model cost: {amount}","partial":"Known model cost: {amount}","unavailable":"Model cost unavailable","zero":"No model calls this turn","calls":"{count} calls","missing":"{count} calls have incomplete billing data","inherited":"Inherited history; excluded from new spending in this branch","scope":"Model requests in this session only. Subagents, title generation and tool charges are excluded. Estimates use API usage and configured prices; the provider invoice is authoritative.","timeRule":"Peak pricing uses request start time. Cache writes use the uncached input rate.","history":"Older records are recalculated using verified historical prices. Prices checked on 2026-10-29.","session":"New session model cost through this turn: {amount}","input":"Uncached input","cacheRead":"Cache reads","cacheWrite":"Cache writes","output":"Output (including reasoning)","tokens":"Tokens","price":"Rate / 1M tokens","subtotal":"Estimated cost","peak":"Peak","offPeak":"Off-peak","version":"Price version","usage-unavailable":"Usage missing or incomplete","price-unavailable":"No applicable price","calendar-expired":"Peak calendar needs updating","waiting":"Loading cost estimate","unknown":"Unknown","sessionPartial":"Some calls are missing from this subtotal."},"zh":{"meta":{"title":"每轮费用","description":"在每轮回复下方显示模型费用估算、调用次数和 token 计费明细。"},"summary":"本轮模型费用约 {amount}","partial":"本轮已知模型费用约 {amount}","unavailable":"本轮模型费用暂无法估算","zero":"本轮没有模型调用","calls":"{count} 次调用","missing":"{count} 次调用缺少完整计费数据","inherited":"继承自原会话，不计入本分支新增费用","scope":"仅统计本会话模型请求，不含子 Agent、标题生成及工具费用。金额按 API 用量与单价估算，以服务商账单为准。","timeRule":"峰谷价按请求开始时间估算；缓存写入按未命中输入计价。","history":"安装前的记录按已核验的历史价格回算。价格表核验日期：2026-10-29。","session":"本会话新增模型费用（截至本轮）约 {amount}","input":"未缓存输入","cacheRead":"缓存读取","cacheWrite":"缓存写入","output":"输出（含推理）","tokens":"Token 数","price":"单价 / 百万 token","subtotal":"费用估算","peak":"高峰时段","offPeak":"空闲时段","version":"价格版本","usage-unavailable":"用量缺失或不完整","price-unavailable":"缺少适用价格","calendar-expired":"峰谷日历需要更新","waiting":"费用统计正在加载","unknown":"未知","sessionPartial":"累计中有未能计价的调用。"}});
+  },
+});

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+    - id: local-deepseek-cost-meter
+      name: 'deepseek-cost-meter'
+      config: {}

package/docs/architecture.md

@@ -0,0 +1,30 @@
+# Architecture
+
+```mermaid
+flowchart LR
+  Events[Persisted Harness session events] --> Projection[localTurnCost projection]
+  Rates[rates.json or config.rates] --> Catalog[Immutable price snapshots]
+  Catalog --> Projection
+  Projection --> View[Completed-turn aggregates]
+  View --> Slot[conversation.chat.turnTail]
+```
+
+## Host and projection
+
+`index.js` registers the `localTurnCost` projection through `sessionProjections` and opens the `local_turn_cost_prices` storage domain. A hash of the rate configuration identifies each saved snapshot. The projection checkpoint version incorporates the algorithm version and complete price catalog so incompatible caches are rebuilt.
+
+`src/projection.js` folds turn, step, retry and assistant-settlement events. A pending attempt keeps the final usage sample, commits on retry/step/turn boundaries, and aggregates lines by provider, model, price version, period and completeness. Only ended turns are published to the client. Fork-inherited records are excluded from new session totals.
+
+`src/pricing.js` validates configuration and usage. Prices have at most six decimals per million tokens; multiplication produces integer trillionths of currency serialized as decimal strings. Reasoning tokens are not an additional charge. Missing counters are inferred as zero only when the exact total proves it.
+
+## Price history
+
+The initial catalog entry starts at the configured `effectiveFrom`; subsequent changes start when loaded. A new catalog also respects its own `effectiveFrom`, so a future tariff is unavailable until that date. Catalog selection uses attempt-start time; peak windows use UTC+8, weekdays and configured holiday dates. The calendar is deliberately bounded. Explicit provider rows override official-route aliases.
+
+## Client
+
+`src/client-factory.js` uses Harness-provided React, `useProjection` and `conversation.chat.turnTail`. `scripts/build.mjs` generates the standalone `client.js` and embeds locale dictionaries. The client neither scans chat DOM nor changes conversation messages. Registration and styles are removed on disposal.
+
+## Limits
+
+Storage grows with turn count and distinct model/price combinations. Unknown usage cannot be recovered from rendered text. Independent subagent sessions and model calls outside the current session are excluded. Price history is not an authoritative financial ledger. Runtime service and slot APIs depend on the tested Harness version.

package/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect x="4" y="4" width="56" height="56" rx="15" fill="#176B64"/><path d="M17 19h30v21H30l-9 7v-7h-4z" fill="none" stroke="#fff" stroke-width="3" stroke-linejoin="round"/><path d="m27 24 5 6 5-6m-5 6v7m-7-6h14m-14 4h14" fill="none" stroke="#fff" stroke-width="2.5" stroke-linecap="round"/></svg>

package/index.js

@@ -0,0 +1,29 @@
+import { readFile } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+import { rateSchema, catalogSchema } from './src/pricing.js';
+import { createProjection } from './src/projection.js';
+
+export const name = 'local-deepseek-cost-meter';
+export const inject = ['sessionProjections', 'storageDomain'];
+export const Config = z.object({ rates: rateSchema.optional() }).strict().default({});
+
+/** Pin rate changes in host storage; replay uses the rate catalog active at the request time. */
+export async function apply(ctx, config = {}) {
+  const rates = rateSchema.parse(config.rates ?? JSON.parse(await readFile(new URL('./rates.json', import.meta.url), 'utf8')));
+  const domain = await ctx.storageDomain.open({
+    name: 'local_turn_cost_prices', version: 1, tables: {},
+    global: { schema: catalogSchema, initial: [] },
+  });
+  ctx.effect(() => () => domain.close());
+  const id = createHash('sha256').update(JSON.stringify(rates)).digest('hex');
+  let catalog = domain.global.get();
+  if (catalog.at(-1)?.id !== id) {
+    catalog = [...catalog, { id, startsAt: catalog.length ? Date.now() : Date.parse(rates.effectiveFrom), rates }];
+    await domain.global.set(catalog);
+  }
+  // Include both implementation and price history in checkpoint compatibility.
+  const stateVersion = createHash('sha256').update('projection-v2:' + JSON.stringify(catalog)).digest().readUInt32BE(0);
+  const handle = await ctx.sessionProjections.register(createProjection(catalog, stateVersion));
+  ctx.effect(() => () => handle.dispose());
+}

package/locale/en.json

@@ -0,0 +1,18 @@
+{
+  "meta": {"title": "Turn costs", "description": "Show estimated model cost, request counts and token pricing below each completed turn."},
+  "summary": "Estimated model cost: {amount}",
+  "partial": "Known model cost: {amount}",
+  "unavailable": "Model cost unavailable",
+  "zero": "No model calls this turn",
+  "calls": "{count} calls", "missing": "{count} calls have incomplete billing data",
+  "inherited": "Inherited history; excluded from new spending in this branch",
+  "scope": "Model requests in this session only. Subagents, title generation and tool charges are excluded. Estimates use API usage and configured prices; the provider invoice is authoritative.",
+  "timeRule": "Peak pricing uses request start time. Cache writes use the uncached input rate.",
+  "history": "Older records are recalculated using verified historical prices. Prices checked on 2026-10-29.",
+  "session": "New session model cost through this turn: {amount}",
+  "input": "Uncached input", "cacheRead": "Cache reads", "cacheWrite": "Cache writes", "output": "Output (including reasoning)",
+  "tokens": "Tokens", "price": "Rate / 1M tokens", "subtotal": "Estimated cost",
+  "peak": "Peak", "offPeak": "Off-peak", "version": "Price version",
+  "usage-unavailable": "Usage missing or incomplete", "price-unavailable": "No applicable price", "calendar-expired": "Peak calendar needs updating",
+  "waiting": "Loading cost estimate", "unknown": "Unknown", "sessionPartial": "Some calls are missing from this subtotal."
+}

package/locale/zh.json

@@ -0,0 +1,19 @@
+{
+  "meta": {"title": "每轮费用", "description": "在每轮回复下方显示模型费用估算、调用次数和 token 计费明细。"},
+  "summary": "本轮模型费用约 {amount}",
+  "partial": "本轮已知模型费用约 {amount}",
+  "unavailable": "本轮模型费用暂无法估算",
+  "zero": "本轮没有模型调用",
+  "calls": "{count} 次调用",
+  "missing": "{count} 次调用缺少完整计费数据",
+  "inherited": "继承自原会话，不计入本分支新增费用",
+  "scope": "仅统计本会话模型请求，不含子 Agent、标题生成及工具费用。金额按 API 用量与单价估算，以服务商账单为准。",
+  "timeRule": "峰谷价按请求开始时间估算；缓存写入按未命中输入计价。",
+  "history": "安装前的记录按已核验的历史价格回算。价格表核验日期：2026-10-29。",
+  "session": "本会话新增模型费用（截至本轮）约 {amount}",
+  "input": "未缓存输入", "cacheRead": "缓存读取", "cacheWrite": "缓存写入", "output": "输出（含推理）",
+  "tokens": "Token 数", "price": "单价 / 百万 token", "subtotal": "费用估算",
+  "peak": "高峰时段", "offPeak": "空闲时段", "version": "价格版本",
+  "usage-unavailable": "用量缺失或不完整", "price-unavailable": "缺少适用价格", "calendar-expired": "峰谷日历需要更新",
+  "waiting": "费用统计正在加载", "unknown": "未知", "sessionPartial": "累计中有未能计价的调用。"
+}

package/node_modules/zod/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.