DeepSeek Daily Briefing
每日自动推送 DeepSeek API 余额、花费和 Token 用量监控。使用 no_agent=true 模式直接执行 Python 脚本，不消耗 LLM Token。
认证
需要两个凭据：
# ~/.hermes/.env
DEEPSEEK_API_KEY=sk-your_key_here
# ~/.hermes/deepseek_platform_token
# DeepSeek Platform API Token（从 Web 控制台获取）
your_platform_token_here
可用 API 端点
余额查询（API Key 认证）
GET https://api.deepseek.com/user/balance
Authorization: Bearer <DEEPSEEK_API_KEY>
用户总览（Platform Token）
GET https://platform.deepseek.com/api/v0/users/get_user_summary
花费明细（Platform Token）
GET https://platform.deepseek.com/api/v0/usage/cost?year=2026&month=06
Token 用量（Platform Token）
GET https://platform.deepseek.com/api/v0/usage/amount?year=2026&month=06
脚本说明
脚本 deepseek_daily_briefing.py 执行流程：
- 读取凭据（
DEEPSEEK_API_KEY+ Platform Token） - 调用余额接口获取当前余额
- 调用用户总览获取本月累计花费和 Token 用量
- 调用花费明细获取昨日和今日的按模型细分
- 输出 Markdown 格式报告
Cron 部署
cronjob action=create \
name="DeepSeek 每日用量简报" \
schedule="0 9 * * *" \
no_agent=true \
script="deepseek_daily_briefing.py" \
workdir="$HOME/.hermes" \
deliver="feishu"
> ⚠️ script 路径注意事项：script 参数只传文件名（如 deepseek_daily_briefing.py），系统会自动在前面补 scripts/。不要传 scripts/foo.py，否则会变成 scripts/scripts/foo.py。
>
> ⚠️ deliver 注意事项：显式设置 deliver 到目标平台（feishu/telegram 等），origin 默认值可能因会话过期而投递失败。
最佳实践
- 使用 Python 标准库：
no_agent=true的 cron 脚本运行在最小环境中，urllib.request.urlopen()比subprocess.run(["curl", ...])更可靠（curl 可能不在 PATH 中） - 跨月边界处理：脚本自动计算昨天和今天的年月参数，不会在月末/月初报错
- 凭据文件管理：API Key 放在
.env，Platform Token 放在独立文件中（便于权限分离）
参考
- DeepSeek API 官方文档
- DeepSeek 定价
