Community plugins for DeepSeek Harness (DSH) Web GUI: session token cost meter with official dynamic pricing, DeepSeek & Volcengine billing balance, and update checker. Plain JavaScript, no build required.
Pending human review — the facts below come from the source repository.
Community plugins for DeepSeek Harness (DSH) Web GUI: session token cost meter with official dynamic pricing, DeepSeek & Volcengine billing balance, and update checker. Plain JavaScript, no build required.
Users who want this capability in DSH; check the source and docs before installing.
dsh plugin --profile web add github:YZz-S/dsh-token-cost-meter No supported platforms were declared.
cordis_define usage (temporary run). ## English 中文 · ← Back to DeepSeekHarnessPlugins ### Preview A new stats line appears below the input box (right of the built-in stats line): Cost ¥0.13 · 43.2K tokens Hovering shows the breakdown: pricing model, input (cache-miss / cache-hit buckets), output, pricing mode (current / peak-hour / off-peak-hour), price source and fetch time. ### Features - Real usage: reads the session projection tokenUsage (provider-reported cumulative usage: cache-miss input / cache-hit input / output — same source as DSH's built-in stats line) - Official dynamic pricing: the Host fetches and parses the official DeepSeek pricing page every 6 hours (including peak/off-peak price tables, auto-switching by Beijing time) - Graceful degradation: if the official page fetch fails, automatically falls back to the built-in price snapshot, prefixing amounts with ≈ and noting the reason in the hover tooltip - Three-level model detection fallback: recent request provenance → requestConfig → Host agents.options.model; if all fail, displays a price range computed per model - Zero data egress: the only outbound request is the official public pricing page; token usage is displayed locally only — never uploaded or persisted ### Files | File | Description | | --- | --- | | index.js | Installed Host half: fetches/parses the official pricing page; /api/token-cost-meter/* routes (pricing / model) | | lib/client.js | Installed Client half: UI below the input box, cost calculation | | cordis.patch.yml | Bundle patch: inserts this plugin's row into the DSH composition | | host.js | Dynamic Host half (cordis_define code.host), functionally equivalent to the installed form | | client.js | Dynamic Client half (code.client) | | README.md / SECURITY.md / CHANGELOG.md / LICENSE | Docs & license | ### Installation (dsh.bundle) This repo is also an installable dsh plugin package (package.json declares dsh.bundle + dsh.client): sh dsh plugin --profile web add github:YZz-S/dsh-token-cost-meter After installation, restart DSH and the cost stats line below the input box takes effect automatically. The dynamic usage (cordis_define loading host.js / client.js) is kept; pick either one. ### Usage #### Method 1: dynamic Cordis plugin (temporary) 1. Open DSH Web and enter a session; 2. Ask the assistant to call cordis_define, submitting host.js full text as code.host and client.js full text as code.client; 3. cordis_run the returned pluginId / packageId; 4. Approve on the Run card (double ✓ recommended to skip approval for future updates); 5. Refresh the page; the cost stats line appears below the input box. > A dynamic plugin lives as long as the current DSH process: after a DSH restart you must define + run it again. #### Method 2: install as a regular plugin (persistent) That's the "Installation (dsh.bundle)" section above — after dsh plugin add it loads automatically at DSH startup. ### How it works ┌────────────────────────── Client (browser) ──────────────────────────┐ │ conversation.composer.dock (stats line below input box) │ │ ┌──────────────────────────────────────────────────────────────────┐ │ │ │ CostLine component │ │ │ │ · useProjection('tokenUsage') ← session cumulative real usage │ │ │ │ · GET /api/token-cost-meter/pricing ← official prices (TTL 6h + │ │ │ │ snapshot fallback) │ │ │ │ · GET /api/token-cost-meter/model ← session model (Host side) │ │ │ │ cost = miss input × miss price + cache-hit × hit price + │ │ │ │ output × output price │ │ │ └──────────────────────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────────────┘ │ fetch (same-origin HTTP) ┌──────────────────────── Host (DSH Node process) ──────────────────────┐ │ webServer routes: pricing (native fetch → parse both price tables) │ │ model (agents.get(sessionId).options.model) │ └───────────────────────────────────────────────────────────────────────┘ ### Billing basis Cost (CNY) = cache-miss input × miss price + cache-hit input × hit price + output × output price - Price unit: CNY / million tokens, taken from the official pricing page; since 2026-08-17 auto-switches per the officially announced peak/off-peak table (Beijing time 9:00–12:00 and 14:00–18:00 are peak hours, the rest are off-peak). - Cache writes are billed at the miss price (consistent with DeepSeek billing rules). ### Platform requirements - DSH (Web mode, dynamic Cordis plugins supported; verified on DSH 0.1.0-rc.6 + Node.js v22 + Windows) - Installed form has no extra dependencies: the host process has native fetch (Node ≥ 18) - Dynamic form (host.js): the price-fetching command is PowerShell syntax and works out of the box on Windows; on Linux/macOS replace NODE_FETCH in host.js with the corresponding shell syntax ### Why the dynamic form fetches the pricing page with node.exe The DSH dynamic plugin sandbox disables fetch / require, and the Web deployment by default does not mount the fetch provider of ctx.web (anti-SSRF); also, the Windows sandbox executor corrupts curl/PowerShell schannel TLS credentials. The dynamic form therefore calls node.exe via ctx.shell (OpenSSL TLS, unaffected by schannel) to fetch the single hard-coded official URL — the command string concatenates no external input, leaving no command-injection surface. The installed form uses the host process's native fetch and is not subject to this restriction. ### Known limitations - The cost is an estimate, not an official bill; actual charges are subject to the DeepSeek platform - The built-in price snapshot (fetched 2026-08-15) may lag official price changes; it only serves as a fallback when dynamic fetching fails - The dynamic plugin is session-level: after a DSH process restart it must be reinstalled (see Method 2) ### License MIT --- ## 中文 English · ← 返回 DeepSeekHarnessPlugins DeepSeek Harness（DSH）插件：在 Web GUI 输入框下方的统计行中实时显示当前会话累计 token 消耗与估算费用（人民币），价格从 DeepSeek 官方价格页动态获取。 支持两种形态：可安装的 dsh.bundle 包（推荐，随 DSH 启动常驻）与动态 cordis_define 用法（临时运行）。 ### 效果 输入框下方（自带 stats 行右侧）新增一行读数： 费用 ¥0.13 · 43.2K tokens 鼠标悬停显示明细：计价模型、输入（缓存未命中/命中分桶）、输出、计价模式（现行价 / 高峰时段价 / 空闲时段价）、价格来源与抓取时间。 ### 功能特性 - 真实用量：读取会话投影 tokenUsage（服务商上报的累计用量：未命中输入 / 缓存命中 / 输出，与 DSH 自带统计行同源） - 官方动态价格：Host 端每 6 小时抓取并解析 DeepSeek 官方价格页（含峰谷价表，按北京时间自动切换时段） - 优雅降级：官方页抓取失败时自动改用内置价格快照，金额前加 ≈ 并在悬停提示中标注原因 - 模型识别三级回退：最近请求 provenance → requestConfig → Host agents.options.model；全部失败时显示按各模型分别计算的价格区间 - 零数据外传：唯一出站请求为官方公开价格页；token 用量仅本地展示，不上传、不落盘 ### 文件说明 | 文件 | 说明 | | --- | --- | | index.js | 安装版 Host 半边：抓取/解析官方价格页，/api/token-cost-meter/* 路由（pricing / model） | | lib/client.js | 安装版 Client 半边：输入框下方 UI、费用计算 | | cordis.patch.yml | bundle 补丁：向 DSH 组合插入本插件行 | | host.js | 动态版 Host 半边（cordis_define 的 code.host），与安装版功能等价 | | client.js | 动态版 Client 半边（code.client） | | README.md / SECURITY.md / CHANGELOG.md / LICENSE | 文档与许可 | ### 安装（dsh.bundle） 本仓库同时是可安装的 dsh 插件包（package.json 声明 dsh.bundle + dsh.client）： sh dsh plugin --profile web add github:YZz-S/dsh-token-cost-meter 安装后重启 DSH，输入框下方的费用读数自动生效。 动态用法（cordis_define 加载 host.js / client.js）仍保留，两种方式二选一。 ### 使用方法 #### 方式一：动态 Cordis 插件（临时运行） 1. 打开 DSH Web，进入会话； 2. 让助手调用 cordis_define，将 host.js 全文作为 code.host、client.js 全文作为 code.client 提交； 3. cordis_run 运行返回的 pluginId / packageId； 4. 在 Run 卡片上批准（建议勾选双 ✓，后续版本更新免审批）； 5. 刷新页面，输入框下方出现费用读数。 > 动态插件的生命周期与当前 DSH 进程相同：重启 DSH 后需重新 define + run。 #### 方式二：正式插件（常驻） 即上方「安装（dsh.bundle）」一节，dsh plugin add 后随 DSH 启动自动加载。 ### 工作原理 ┌─────────────────────────── Client（浏览器） ───────────────────────────┐ │ conversation.composer.dock（输入框下方统计行） │ │ ┌───────────────────────────────────────────────────────────────────┐ │ │ │ CostLine 组件 │ │ │ │ · useProjection('tokenUsage') ← 会话累计真实用量（实时更新） │ │ │ │ · GET /api/token-cost-meter/pricing ← 官方价格（TTL 6h + 快照兜底）│ │ │ │ · GET /api/token-cost-meter/model ← 会话模型（Host 侧来源） │ │ │ │ 费用 = 未命中输入×未命中价 + 缓存命中×命中价 + 输出×输出价 │ │ │ └───────────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────────────┘ │ fetch（同源 HTTP） ┌───────────────────────── Host（DSH Node 进程） ─────────────────────────┐ │ webServer 路由: pricing（原生 fetch 抓官方页 → 解析两套价表） │ │ model（agents.get(sessionId).options.model） │ └─────────────────────────────────────────────────────────────────────────┘ ### 计费口径 费用（人民币）= 缓存未命中输入 × 未命中价 + 缓存命中 × 命中价 + 输出 × 输出价 - 价格单位：人民币 / 百万 tokens，取自官方价格页；2026-08-17 起按官方公告的峰谷价表自动切换（北京时间 9:00–12:00、14:00–18:00 为高峰时段，其余为空闲时段）。 - 缓存写入按未命中价计（与 DeepSeek 计费规则一致）。 ### 平台要求 - DSH（Web 模式，支持动态 Cordis 插件；已在 DSH 0.1.0-rc.6 + Node.js v22 + Windows 验证） - 安装版无额外依赖：宿主进程自带 fetch（Node ≥ 18） - 动态版（host.js）的价格抓取命令为 PowerShell 语法，Windows 开箱即用；Linux/macOS 需替换 host.js 中 NODE_FETCH 为对应 shell 语法 ### 为什么动态版用 node.exe 抓取价格页 DSH 动态插件沙盒禁用了 fetch / require，且 Web 部署默认不挂载 ctx.web 的 fetch provider（防 SSRF）；同时 Windows 沙盒执行器会破坏 curl / PowerShell 的 schannel TLS 凭据。因此动态版经 ctx.shell 调用 node.exe（OpenSSL TLS，不受 schannel 影响）抓取唯一的硬编码官方 URL，命令字符串无任何外部输入拼接，无命令注入面。安装版宿主进程自带原生 fetch，不受此限制。 ### 已知限制 - 费用为估算值，非官方账单；实际以 DeepSeek 平台扣费为准 - 内置价格快照（2026-08-15 抓取）可能滞后于官方调价，仅供动态抓取失败时兜底 - 动态插件为会话级：DSH 进程重启后需重新安装（见「方式二」） ### 许可 MIT --- English · 中文Not by stars — picked by hand, one at a time.
A visual settings dashboard for DeepSeek Harness: every registered settings namespace — including third-party plugin ones the official UI never covers — rendered as editable, schema-driven forms. Early, but the right direction: stop hand-editing YAML.
A DIY trajectory visualizer for DeepSeek Harness: watch the agent’s plan and execution unfold as a graph instead of scrolling raw logs. Early, but it fills a real gap — understanding at a glance what the agent is doing.
Dispatch DSH work from Claude Code / Codex: spin up in-host DSH agent sessions with per-tier presets, watch native subagent progress, and borrow a multimodal bridge that lends the text-only harness vision and image generation. An orchestration plugin that turns DSH into a backend for other coding agents.