PROJECT TOPICS

项目标签

deepseek deepseek-harness dsh-plugin

PROJECT README

README

dsh-tidecost

小孩子用ai做着玩的（x

DeepSeek Harness 侧边栏插件：余额 / 峰谷价 / 逐步用量花费 / 预算预警 一体化面板。

支持 DeepSeek（余额 + 峰谷价）与 Z.ai（按量计费），两者均采用官方人民币单价。

旧数据目录与浏览器内的旧设置键会自动迁移（见下文）。

在 DSH Web 侧边栏脚部新增「余额」模块：实时显示账户余额、当前会话每一步的 token 用量与花费、DeepSeek 官方峰谷价档位与倒计时、预算设定与三级预警，并在峰价时段每日首次对话前弹窗确认。

支持范围与限制

Provider	支持情况
DeepSeek（`deepseek-official`）	完整支持：余额 `GET /user/balance`、峰谷时段、按调用时刻的价格纪年（人民币）
Z.ai（`zai`）	按量计费计价：`glm-5.3-flash` 官方人民币单价——输入 ¥0.8 / 缓存命中 ¥0.23 / 输出 ¥2.8（每 1M tokens；缓存存储限时免费），直接以 ¥ 计入预算与预警；余额请在 Z.ai 控制台查看
其他 provider（OpenAI / Anthropic / 自建网关等）	不适用：无定价表，费用按 DeepSeek Flash 兜底价估算，仅供参考

项	说明
DeepSeek 模型	`deepseek-flash`（V4.1）、`deepseek-v4-flash`、`deepseek-v4-flash-vision-exp`、`deepseek-v4-pro`；未知名模型按 Flash 价兜底
Z.ai 模型	`glm-5.3-flash`；同 provider 其他模型先用同价兜底，可在 `src/shared/tide.ts` 的 `FLAT_PRICES` 增补
计价方式	每步按调用发生时刻计价：DeepSeek 走峰/谷/节假日价格纪年；Z.ai 为按量计费（无峰谷，标为 `flat` 档）
图片 token	以供应商 `usage` 为准；`vision-exp` 图片按官方像素折算规则计入 input
汇率	`usdCny`（Config，默认 7.1）仅用于未来美元计价的 provider；DeepSeek 与 Z.ai 均为官方人民币价，不做换算
计费准确性	价格内置官方公告口径；官方调价后需同步 `src/shared/tide.ts`。注：Z.ai 另有美元定价页（$0.15/$0.50/$0.03）与 pi-ai 目录里的 cost 字段，两者均与官方人民币价不一致，本插件以官方人民币价为准

功能

模块	说明
账户余额	官方 `GET /user/balance`（`ctx.credentials` 解析 `DEEPSEEK_API_KEY`），60s 缓存 + 手动刷新
逐步用量	当前会话每步（turn/step）的 input/output/cache 命中/缓存写入/reasoning token、模型、费用
峰谷价提醒	当前档位（峰价 ×2 / 谷价 ×0.5）、距下一档倒计时、北京时间时段表、档位翻转自动提醒
对话前确认	峰价时段每日首次对话前弹窗确认（可开关、可当日不再提醒；周末/节假日不弹）
预算	会话预算按会话隔离；月度预算 / 余额预警线 / 预警比例全局；超预算或接近上限时预警
多 Provider 计价	DeepSeek（峰谷价格纪年）+ Z.ai（按量计费，官方人民币价）；逐步明细标注 provider 与档位（峰/谷/按量）
Agent 工具	`dsh_balance`：快速查询余额、会话花费、峰谷档位与预警

官方峰谷价与价格纪年

按 DeepSeek 官方公告实现（按调用发生时刻计价，历史调用不会被新价格改写）：

生效时间（北京）	规则
2026-08-16 16:00Z 之前	峰谷时代前基础价（legacy，仅历史行）
2026-08-17 起	峰谷分时定价：峰 = 周一至周五 09:00–12:00、14:00–18:00；谷价 = 峰价一半
2026-08-23 起	周末全天谷价
2026-09-10 12:00 起	Flash 系列降价（`deepseek-flash` / `deepseek-v4-flash` / `-vision-exp`）：谷 0.02 / 1 / 4，峰 0.04 / 2 / 8（元/百万 token）；Pro 未调整

计费口径：input×未命中价 + output×输出价 + (cacheRead + cacheWrite)×命中价（元/百万 token）。
节假日：官方按谷价计费。在 $DSH_HOME/dsh-tidecost/holidays.json 写北京日期数组（如 ["2026-10-01"]）即可热更生效（无需重启），也可用插件 Config 的 holidays。
官方调价只需更新 src/shared/tide.ts 的价格纪年常量（文件头有说明）。

安装

要求：DeepSeek Harness（dsh CLI）与 pnpm。

# 1) 官方装配（GitHub）
dsh plugin --profile web add github:ibuki-mu/dsh-tidecost

# 或本地开发目录
dsh plugin --profile web add link:/path/to/dsh-tidecost

# 2) 重启 dsh web 生效（bundle 插件无进程内热重载）

仓库按 DSH 生态约定：标准插件包格式（package.json + lib/）、dsh.client.platform=web、 peerDependencies 全范围声明（不硬编码 DSH 版本）、lib/ 预构建随仓库提交（装配时无需构建）。

配置（插件 Config）

字段	默认	说明
`apiBaseUrl`	`https://api.deepseek.com`	余额接口基址（不用于模型调用）
`balanceCacheMs`	`60000`	余额缓存时长
`holidays`	`[]`	节假日北京日期名单（YYYY-MM-DD）；`holidays.json` 优先
`usdCny`	`7.1`	USD→CNY 汇率：仅用于未来美元计价 provider（当前 DeepSeek / Z.ai 均为人民币价）
`dataDir`	`$DSH_HOME/dsh-tidecost`	数据目录（旧 dsh-balance 自动迁移）

数据文件（均在 dataDir）：

文件	内容
`budget.json`	全局：`defaultSessionBudgetCny` / `monthlyBudgetCny` / `balanceWarnCny` / `warnThreshold`
`session-budgets.json`	`{ [sessionId]: 会话预算 }`（仅显式自定义过的会话）
`holidays.json`	节假日名单（优先于 Config，热更）
`usage-log.jsonl`	逐步用量流水（月结按调用时刻价格纪年重算）

旧版把会话预算写在全局 budget.json：首次加载会自动迁移为「默认会话预算」，老数据不丢。

HTTP API（同源，供面板使用）

端点	说明
`GET /dsh-tidecost/api/overview?session=<id>`	面板快照：余额、会话逐步用量、预算、峰谷相位、节假日、预警
`GET /dsh-tidecost/api/balance?refresh=1`	余额（强制刷新）
`GET /dsh-tidecost/api/budget?session=<id>`	该会话生效预算 + 全局项
`POST /dsh-tidecost/api/budget?session=<id>`	保存：`sessionBudgetCny` 仅写该会话；`{resetSession:true}` 恢复默认；不带 `session` 则更新默认会话预算
`GET /dsh-tidecost/api/session/<id>/usage`	单会话逐步用量

隐私

API Key 仅通过 ctx.credentials 在请求时解析，不写入日志、不落盘、不经前端。
插件仅在查询余额时访问 DeepSeek 官方接口；其余数据全部本地计算与存储。

开发

npm install                 # 安装 devDependencies（typescript / tsdown / @types/*）
bash scripts/build.sh       # 链接 DSH 类型依赖 + tsc 编译 host
npm run build:client        # tsdown 打包 host bundle + client bundle
npm run typecheck           # host 类型检查

node test/tide.mjs          # 峰谷数学 / 价格纪年
node test/peakgate.mjs      # 峰价确认门控
node test/budget.mjs        # 会话预算隔离（驱动打包后 host）
node test/budget-input.mjs  # 预算输入框回归

客户端类型检查（自包含、仅依赖 react 类型）：

npx tsc --noEmit --jsx react-jsx --module esnext --moduleResolution bundler \
  --target ES2023 --lib ES2023,DOM --skipLibCheck --strict --types node,react src/client/index.tsx

提交规范见 AGENTS.md。

许可证

CLASSIFICATION EVIDENCE

分类依据

项目类型待识别

功能分类其他

规则置信度低

系统优先读取 GitHub Topics，再与站内分类词典和词根规则比对。当前命中：无有效分类标签。

dsh-tidecost

项目标签

README

dsh-tidecost

支持范围与限制

功能

官方峰谷价与价格纪年

安装

配置（插件 Config）

HTTP API（同源，供面板使用）

隐私

开发

许可证

分类依据

同类项目

deepseek-harness

dsh-desktop

awesome-dsh-plugin