deepseek-usage

name	deepseek-usage
description	查询 DeepSeek API 用量（余额、本月消费、各模型 Token 明细、日维度明细、缓存命中率）。 通过 browser_use 访问 DeepSeek 开放平台，自动登录并导出月度数据。 需要用户自行配置 DeepSeek 账号到本地环境变量。 当用户说"查用量"、"看token消耗"、"查消费"、"余额还剩多少"、"今天跑了多少"时触发。
version	1.1.0
compatibility	Requires python3. DEEPSEEK_EMAIL and DEEPSEEK_PASSWORD env vars.

DeepSeek API 用量查询

⚠️ 安全提示 本技能需要 DeepSeek 登录凭据才能工作。 凭据仅存储在本地环境变量中，Minis 不会上传到任何服务器。 如果你不信任此方式，请删除本技能或不要设置凭据。

前置配置（首次使用，只需一次）

1. 设置环境变量

在 Minis 设置 → 环境变量中添加以下两个变量：

变量名	说明	示例值
DEEPSEEK_EMAIL	你的 DeepSeek 平台登录邮箱	[e-mail]
DEEPSEEK_PASSWORD	你的 DeepSeek 平台登录密码	your_password_here

🔗 点此打开环境变量设置

如果你的账号使用 Google/微信等第三方登录，则无法使用本技能。

2. 验证配置

[ -n "$DEEPSEEK_EMAIL" ] && [ -n "$DEEPSEEK_PASSWORD" ] && echo "已配置" || echo "未配置"

查询流程（仅需 2 个 tool call）

第 1 步：导航并确保登录（1 个 tool call）

动作:
  - set_user_agent: desktop_chrome
  - navigate: https://platform.deepseek.com/usage
  - 如果未登录，从环境变量填充 DEEPSEEK_EMAIL / DEEPSEEK_PASSWORD 并提交登录
  - wait_for_dom_stable

第 2 步：一键执行完整 JS 脚本（1 个 execute_js）

以下 JS 脚本完成取 Token → 下载 zip → 解压 → 解析 CSV → 输出全部逻辑。

将整个 JS 脚本作为 execute_js --script 的参数一次性执行。

(async () => {
  // === 获取汇总文本 ===
  // 用 get_readable 提取（在 execute_js 外部完成）

  // === 获取 Token ===
  const token = JSON.parse(localStorage.getItem('userToken')).value;
  if (!token) return JSON.stringify({ error: 'no_token' });

  // === 下载 zip ===
  const resp = await fetch('https://platform.deepseek.com/api/v0/usage/export?month=5&year=2026', {
    headers: { 'Authorization': 'Bearer ' + token }
  });
  const blob = await resp.blob();

  // === 加载 JSZip ===
  const script = document.createElement('script');
  script.src = 'https://cdnjs.cloudflare.com/ajax/libs/jszip/3.10.1/jszip.min.js';
  await new Promise(r => { script.onload = r; document.head.appendChild(script); });

  // === 解压 ===
  const zip = await JSZip.loadAsync(blob);
  const costText = await zip.file('cost-2026-5.csv').async('text');
  const amountText = await zip.file('amount-2026-5.csv').async('text');

  // === 解析 cost（费用）===
  // ⚠️ 表头: user_id, utc_date, model, wallet_type, cost, currency
  const costLines = costText.trim().split('\n').slice(1);
  const modelCost = {};
  let totalCost = 0;
  for (const line of costLines) {
    const p = line.split(',');
    const model = p[2], cost = parseFloat(p[4]) || 0;
    modelCost[model] = (modelCost[model] || 0) + cost;
    totalCost += cost;
  }

  // === 解析 amount（用量，按需筛选日期）===
  // ⚠️ 表头: user_id, utc_date, model, api_key_name, api_key(敏感!), type, price, amount
  // ⚠️ 安全警告：第5列是 api_key 明文，禁止打印整行！必须用索引引用。
  const allLines = amountText.trim().split('\n').slice(1);

  // 筛选规则：用户问当日用量 → 筛当天；用户问当月用量 → 全月
  // 默认当日。如需当日，取消下面这行的注释：
  // const targetDate = '当前日期的 YYYY-MM-DD 格式';
  // const filteredLines = targetDate ? allLines.filter(l => l.split(',')[1] === targetDate) : allLines;
  const filteredLines = allLines; // 默认全月

  const models = {};
  for (const line of filteredLines) {
    const p = line.split(',');
    const model = p[2], type = p[5], amount = parseInt(p[7]) || 0;
    if (!models[model]) models[model] = { requests: 0, cache_hit: 0, cache_miss: 0, output: 0 };
    if (type === 'request_count') models[model].requests += amount;
    else if (type === 'input_cache_hit_tokens') models[model].cache_hit += amount;
    else if (type === 'input_cache_miss_tokens') models[model].cache_miss += amount;
    else if (type === 'output_tokens') models[model].output += amount;
  }

  // === 汇总输出 ===
  let result = '';
  let gr = 0, go = 0, gh = 0, gm = 0;

  for (const [m, d] of Object.entries(models)) {
    const ti = d.cache_hit + d.cache_miss;
    const hr = ti > 0 ? (d.cache_hit / ti * 100).toFixed(1) : '0.0';
    const co = modelCost[m] || 0;
    result += `${m}|${d.requests}|${d.output}|${d.cache_hit}|${d.cache_miss}|${ti}|${hr}|${co.toFixed(2)}\n`;
    gr += d.requests; go += d.output; gh += d.cache_hit; gm += d.cache_miss;
  }

  const ti = gh + gm;
  const hr = ti > 0 ? (gh / ti * 100).toFixed(1) : '0.0';
  result += `TOTAL|${gr}|${go}|${gh}|${gm}|${ti}|${hr}|${totalCost.toFixed(2)}`;

  return result;
})();

⚠️ 注意：execute_js 返回的是包裹在 JSON 中的文本，AI 需要解析 data.text 获取实际结果。

第 3 步：截图（1 个 tool call，可选）

screenshot: 当前页面

第 4 步：汇报（memory_write 由用户决定）

是否需要将结果写入 daily log 由用户决定。用户明确要求时才写入。

输出格式

余额： ¥X.XX | 本月已消费： ¥X.XX

模型	请求次数	输出 Tokens	缓存命中	缓存未命中	总输入 Tokens	缓存命中率	费用
deepseek-v4-pro	X	X	X	X	X	X%	¥X.XX
deepseek-v4-flash	X	X	X	X	X	X%	¥X.XX
总计	X	X	X	X	X	X%	¥X.XX

⚠️ 安全注意事项（必须遵守）

API Key 泄露风险

amount CSV 第 5 列（索引 4）为 api_key 字段，包含用户的 DeepSeek API Key 明文。

必须遵守：

• 解析 CSV 时使用列索引引用（如 p[2]、p[5]、p[7]），不要引用整行
• 禁止在任何回复、日志或截图中间接展示 api_key 内容
• 如果需要在调试时查看 CSV 内容，只打印表头（第 1 行），不要打印数据行

凭据安全

• 邮箱密码存储在 Minis 本地环境变量，不会上传
• localStorage Token 仅当前浏览器 session 有效
• 建议定期修改密码

踩坑记录

问题	原因	解决方案
导出按钮点击无效	导出按钮是 <div> 不是 <button>	用 querySelector 匹配文本"导出"后 .click()
browser_use fetch 返回 Missing Token	fetch 不携带页面 cookie	改用 execute_js 在页面上下文中执行 fetch
JSZip 加载失败	import() 方式不支持	用 document.createElement('script') 动态加载 CDN
CSV 解析出 0 条	字段索引猜错	先确认表头（amount 8 列，cost 6 列），再按索引引用
amount.csv 含 API Key 明文	第 5 列是 api_key	解析时使用列名引用，不打印整行
minis-browser-use CLI 跨调用状态丢失	每次调用是独立进程	全 JS 逻辑放在一个 execute_js 中执行，不要跨 navigate/execute_js 传递状态