dsh-tidecost
仅支持 DeepSeek API 的 DSH 侧边栏：余额 / 峰谷价提醒 / 逐步 token 花费 / 会话预算预警
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ibuki-mu/dsh-tidecost#1da96404d647b8eddc3596c3ae67ab67c2e77845Tidecost 以 dsh-tidecost 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
小孩子用ai做着玩的（x
DeepSeek Harness 侧边栏插件：余额 / 峰谷价 / 逐步用量花费 / 预算预警 一体化面板。
⚠️ 仅支持 DeepSeek API（provider
deepseek-official）。旧数据目录与浏览器内的旧设置键会自动迁移（见下文）。
在 DSH Web 侧边栏脚部新增「余额」模块：实时显示账户余额、当前会话每一步的 token 用量与花费、DeepSeek 官方峰谷价档位与倒计时、预算设定与三级预警，并在峰价时段每日首次对话前弹窗确认。
| 项 | 支持情况 |
|---|---|
| Provider | 仅 DeepSeek 官方 API（deepseek-official）：余额接口 GET /user/balance、峰谷时段与价格纪年均来自 DeepSeek 官方口径 |
| 模型 | deepseek-flash（V4.1）、deepseek-v4-flash、deepseek-v4-flash-vision-exp、deepseek-v4-pro；未知名模型按 Flash 价兜底 |
| 其他 provider（OpenAI / Anthropic / pi-ai / 自建网关等） | 不适用：账户余额取的是 DeepSeek 账户；费用会按 Flash 兜底价估算，数值仅供参照、不代表实际账单 |
| 图片 token | 以官方 usage 为准；vision-exp 的图片按官方像素折算规则计入 input |
| 计费准确性 | 价格表内置官方公告口径；官方调价后需同步 src/shared/tide.ts，面板会提示价格可能过期 |
| 模块 | 说明 |
|---|---|
| 账户余额 | 官方 GET /user/balance（ctx.credentials 解析 DEEPSEEK_API_KEY），60s 缓存 + 手动刷新 |
| 逐步用量 | 当前会话每步（turn/step）的 input/output/cache 命中/缓存写入/reasoning token、模型、费用 |
| 峰谷价提醒 | 当前档位（峰价 ×2 / 谷价 ×0.5）、距下一档倒计时、北京时间时段表、档位翻转自动提醒 |
| 对话前确认 | 峰价时段每日首次对话前弹窗确认（可开关、可当日不再提醒；周末/节假日不弹） |
| 预算 | 会话预算按会话隔离；月度预算 / 余额预警线 / 预警比例全局；超预算或接近上限时预警 |
| 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/ 预构建随仓库提交（装配时无需构建）。
| 字段 | 默认 | 说明 |
|---|---|---|
apiBaseUrl | https://api.deepseek.com | 余额接口基址（不用于模型调用） |
balanceCacheMs | 60000 | 余额缓存时长 |
holidays | [] | 节假日北京日期名单（YYYY-MM-DD）；holidays.json 优先 |
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：首次加载会自动迁移为「默认会话预算」，老数据不丢。
| 端点 | 说明 |
|---|---|
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 | 单会话逐步用量 |
ctx.credentials 在请求时解析，不写入日志、不落盘、不经前端。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。
BSD-3-Clause © 2026 ibuki_mu