# DeepSeek峰谷定价调价分析器

**Repository Path**: horseluke/deepseek-cost-analyze

## Basic Information

- **Project Name**: DeepSeek峰谷定价调价分析器
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-14
- **Last Updated**: 2026-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepSeek 调用费峰谷调价影响分析工具

Vue3 + TypeScript SPA，帮助量化 DeepSeek 模型调用费改为峰谷时段收费后对每个 api_key 的影响。用户维护模型价格 / 峰谷比例 / 调价后用量预估系数，上传用量 zip（内含 `amount-*.csv`），以表格与 CSS 条形图对比 调价前 / 全峰 / 全谷 / 比例估算 费用。

本项目由DeepSeek V4正式版全程自动AI编写。

## 下载编译版本

在以下地址下载：

https://gitee.com/horseluke/deepseek-cost-analyze/releases

下载index.zip，然后解压缩，直接用浏览器打开里面的index.html即可运行。

整个计算过程都是本地运行，不会有数据泄露的风险。

## 快速开始

```bash
npm install          # 安装依赖
npm run dev          # 开发服务器（vite）
npm run build        # vue-tsc 类型检查 + 生产构建
npm run preview      # 预览生产构建（默认端口 4173）
npm run test:unit    # Vitest 单元测试（jsdom）
npm run test:e2e     # Playwright e2e（系统 chromium-browser，--no-sandbox）
```

> e2e 前会自动执行 `scripts/make_fixtures.py`（生成 `e2e/fixtures/` 下全部合成假数据 zip）与 `scripts/compute_expected.py`（生成 `e2e/fixtures/expected.json`），需本机 Python3（仅标准库）。系统 chromium 位于 `/usr/bin/chromium-browser`。测试体系完全自包含、可重现，与 `stat/` 无任何依赖。

## 部署

`npm run build` 产出 `dist/index.html` **自包含单文件**（CSS、JS 与微信二维码图片均已内联为 data URI，无任何外部引用与绝对路径），可：

- 放到任意目录、任意子路径部署（相对路径 base，无需改配置）；
- 直接双击该文件用浏览器打开使用（`file://` 下 ES module 内联加载，不受 CORS 限制）。

注意：仅价格配置、峰谷比例、调价后用量预估系数保存在浏览器 localStorage 中（`http(s)://` 与 `file://` 来源彼此隔离），不同部署方式 / 不同浏览器之间互不相通；上传历史与筛选状态仅保存在当前会话，刷新页面后消失。

## 预置模型价格配置

预置模型与默认价格位于根目录 `index.html` 内 `<script type="application/json" id="mca-default-config">`：JSON 数组 `models`，每项含模型名 `name`、峰谷比例 `r`、用量预估系数 `c`，以及三类 token（`input_cache_hit_tokens` / `input_cache_miss_tokens` / `output_tokens`）的 原价/峰价/谷价。应用启动时运行时读取该 JSON，读取失败或不存在时回退到代码内内置的相同预置值（`src/store/models.ts` 的 `fallbackModels`）。

- 开发模式（`npm run dev`）：直接修改 `index.html` 保存即生效，无需重新编译前端源码。
- 生产构建：`dist/index.html` 由构建步骤从根目录 `index.html` 复制生成，修改根文件后需重新执行 `npm run build` 再部署；若直接修改已部署的 `dist/index.html` 同样生效（该 JSON 由浏览器运行时解析）。

## 功能与页面

| 页面 | 说明 |
|---|---|
| `/` 总览 | 6 步使用流程 + 口径速览 |
| `/#/prices` 01 价格配置 | 模型 × 类型三档价格（原价/峰/谷）与调价后用量预估系数 c；增删模型、非法值红框校验、实时持久化 |
| `/#/ratio` 02 峰谷比例 | 每模型峰时占比滑条（0~100%，1% 整数步进，默认 80%），三种口径说明 |
| `/#/upload` 03 上传数据 | 拖拽/选择 zip，解析摘要列表，同名覆盖确认，未知模型自动补价提示 |
| `/#/analysis` 04 费用分析 | 表格 1（api_key×模型，api_key 列 rowspan）与表格 2（按模型），token 组含总数、六个口径组含总价，含合计行，独立 Excel 导出 |
| `/#/filter` 05 筛选 | api_key / zip 双维度多选，默认全选，chips 移除，全选/清空 |
| `/#/charts` 06 图表对比 | KPI 4 卡 + 图 1（按 token 类型+合计）与图 2（按模型）CSS 条形图 |

## 响应式

全站适配 PC 与移动端：以 `@media (max-width: 768px)` 为主断点（个别组件如无额外 480px 细分）。移动端要点：

- 顶栏 7 个导航链接保留 flex-wrap 换行（logo 独占一行），sticky 保持，全部链接可达且当前页高亮可见。
- 数据表格一律置于 `.table-scroll` 横向滚动容器内（01/04/06 已有；01 总览口径速览、02 口径说明表本次补齐），页面 body 不产生横向滚动（除表格容器内）。
- 总览 `.steps` 3 列 → 1 列；06 `.kpis` 4 列 → 2 列；02 `.models` 2 列 → 1 列。
- 06 条形图 `.bar-row` 移动端重排为三行：label + 数值（右对齐）/ 全宽 track / delta 文案左对齐，375px 宽下数值与 delta 完整可见。
- 按钮/输入框移动端最小触控高度 ≥ 36px；`ConfirmDialog` 宽度 `max-width: 92vw`（桌面仍为 400px）；全局 `.wrap` padding 20px → 12px，字号与 note-box/foot 同步收紧。

## 目录结构

```
├── src/
│   ├── calc/            # 纯函数：engine.ts（计算引擎）、csv.ts、zip.ts、excel.ts、format.ts、types.ts
│   ├── store/           # Pinia：models（localStorage 持久化）、uploads / filters（仅会话内存，不持久化）
│   ├── components/      # TopBar、AnalysisTable、ConfirmDialog
│   ├── views/           # 7 个页面
│   └── router/          # hash 路由
├── e2e/
│   ├── fixtures/        # 全部合成假数据 zip（含边界 zip）与 expected.json（均由 Python 生成）
│   └── *.spec.ts        # Playwright 用例
├── scripts/
│   ├── make_fixtures.py     # 生成 e2e fixtures：清空重建目录 + 生成全部假数据 zip（确定性、整数、含边界用例）
│   ├── compute_expected.py  # 独立计算期望值（stdlib only，从 e2e/fixtures/fake-*.zip 计算，写入 expected.json）
│   └── inline_build.mjs     # vite build 后把 dist 的 css/js 内联进 index.html，清理 assets（图片经 assetsInlineLimit 内联为 data URI）
├── stat/                # 5 个真实样例 zip（只读，仅作真实数据示例，测试体系不依赖）
├── prod-demo/           # 需求文档与原型（只读）
└── software-workdir/    # PLAN.md 与 PM 问答（文档）
```

## 计算口径摘要

- 放大后 token：`T′ = ⌈ T × c ⌉`（向上取整；request_count 不放大）
- 调价前 = `T × 原价 / 10⁶`；全峰 = `T′ × 峰价 / 10⁶`；全谷 = `T′ × 谷价 / 10⁶`
- 比例估算 = `全峰 × r + 全谷 × (1 − r)`；差额 = 估算 − 调价前；涨幅 = 差额 ÷ 调价前
- 合计行 = 同列全精度求和，合计涨幅 = 合计差额 ÷ 合计调价前（非各行平均）
- 所有金额统一保留 4 位小数（固定 4 位、含尾随 0，如 0.0000 / 7.5528 / −4.4400）；token/请求数千分位；涨幅 1 位小数 + %（负号 U+2212、正号全角＋）
- 04 表每组末尾含总数/总价列：token 总数 = 三类 token 相加；各口径总价 = 三类费用全精度相加（涨幅总价 = 差额总价 ÷ 调价前总价 × 100%）
- 未配置价格模型：自动加入 01 页并提示补价，计算先按 0 价并在 04/06 页标红；删除模型后其用量按 0 价标红继续展示
- 仅价格配置 / 峰谷比例 / 调价后用量预估系数持久化在 localStorage（key：`mca.v1.models`）；上传历史与筛选状态仅保存在会话内存，刷新页面后消失

## e2e 期望值

`scripts/compute_expected.py` 仅用 Python 标准库（zipfile/csv/math/json/decimal）从 `e2e/fixtures/` 下顶层 `fake-*.zip`（排除 multi_amount / no_amount / unknown_model 边界 zip、overwrite 子目录，以及 1M token 演示 zip `fake_1m_token.zip`）独立重算期望值，输出 `e2e/fixtures/expected.json`，含全选、仅选 fake-2026-07 zip、仅选 alice（sk-test-0001）、仅选 `fake_1m_token.zip`（million）四个场景的 04 两表（含合计行）、06 KPI/图 1/图 2 的数值与 UI 格式化字符串。e2e 直接断言页面文本与期望字符串一致，不 import 前端代码。

`e2e/fixtures/` 全部为合成假数据（api_key 为 `sk-test-0001`/`sk-test-0002`/`sk-test-0003`，姓名 alice/bob/无），由 `scripts/make_fixtures.py` 确定性生成（每次运行前清空目录重建，幂等），`npm run pretest:e2e` 自动执行。`stat/` 仅作为真实数据样例保留，测试体系完全不依赖它。

### fixtures 清单

| 文件 | 用途 |
|---|---|
| `fake-2026-04-01_2026-04-30.zip` ~ `fake-2026-08-01_2026-08-13.zip` | 5 个自然月假数据 zip，覆盖全部场景计算 |
| `fake_1m_token.zip` | 1M token 演示：alice × deepseek-v4-flash 三类 token（命中/未命中/输出）各 1,000,000 token、请求数 1，费用即单价元数，直观感受峰谷调价影响 |
| `multi_amount.zip` / `no_amount.zip` / `unknown_model.zip` | 边界用例：多 amount 报错、缺 amount 报错、未知模型自动补价 |
| `overwrite/fake-2026-04-01_2026-04-30.zip` | 同名覆盖上传确认用例 |

## 移动端 e2e

`e2e/mobile.spec.ts` 通过 `test.use` 分别以 375×667 与 768×1024 视口运行（桌面用例由 `playwright.config.ts` 默认 1400×950，互不影响）。断言覆盖：7 个页面 h1 可见、顶栏 7 链接存在且可滚动到可见、当前页高亮、`document.documentElement.scrollWidth <= innerWidth + 1`（逐页无横向溢出）、总览 `.steps` 与 02 `.models` 单列、06 `.kpis` 两列、上传全部 fixtures 后 04 表格容器可横向滚动且末列表头滚动后可见、KPI 卡 `.val` 文本与 expected.json 一致、06 `.bar-delta` 文本完整、ConfirmDialog 宽度不超视口且按钮可点击、03 上传按钮触控高度 ≥ 32px。

## License

MIT