FEATURED · 精选文章

TradingAgents-CN 使用统计与成本管理前端实战指南:从访问入口到模型定价配置

发布时间 / 2026/9/11 10:21:30
来源 / 创域科博编辑部
栏目 / 资讯中心
TradingAgents-CN 使用统计与成本管理前端实战指南:从访问入口到模型定价配置 TradingAgents-CN 使用统计与成本管理前端实战指南从访问入口到模型定价配置【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN本文面向 TradingAgents-CN 的管理员与深度使用者完整讲解「使用统计」前端页面的访问方式、功能布局与操作细节并深入模型定价配置的完整链路从前端「配置管理 大模型配置」中的定价字段到后端成本计算公式与 MongoDB 存储结构。读完本文你将能够熟练通过统计仪表板监控各供应商、各模型的 Token 与成本开销正确配置模型单价并基于数据做出成本优化决策。功能总览使用统计模块是 TradingAgents-CN 的 LLM 成本可视化管理入口核心由两部分组成使用统计页面展示总请求数、总输入/输出 Token、总成本四个关键指标配合按供应商饼图、按模型柱状图、每日成本趋势折线图三类图表以及详细的 API 调用记录表格模型定价配置在「配置管理 大模型配置」中为每个模型维护每 1000 Token 的输入/输出单价与货币单位成本统计依赖这些配置实时计算。从源码结构看该功能的前端实现位于 使用统计页面组件对应 API 封装位于 API 客户端后端由 路由层 与 统计服务 提供数据支撑。访问入口方式 1通过设置页面导航登录系统点击左侧导航栏的「设置」在设置页面顶部选择「系统配置」标签在左侧菜单中点击「使用统计」点击「查看使用统计」按钮。该导航在设置页源码中对应 使用统计菜单项点击后通过router.push(/settings/usage)跳转到统计页面。方式 2直接访问 URLhttp://localhost:5173/settings/usage其中5173是前端开发服务器Vite的默认端口。该路由已在 前端路由配置 中注册为/settings/usage与设置页其他子页面保持一致的嵌套结构。页面功能详解1. 统计概览页面顶部以 4 张指标卡片展示核心数据┌─────────────┬─────────────┬─────────────┬─────────────┐ │ 总请求数 │ 总输入Token │ 总输出Token │ 总成本 │ │ 1,234 │ ⬆️ 45,678 │ ⬇️ 23,456 │ ¥12.34 │ └─────────────┴─────────────┴─────────────┴─────────────┘一个值得注意的实现细节总成本卡片支持多货币并行展示。组件读取后端返回的cost_by_currency字段按货币分组列出各项成本如 CNY、USD、EUR而不是只显示单一货币的总额。货币符号映射关系在组件中定义为CNY→元、USD→$、EUR→€、GBP→£、JPY→¥当没有任何数据时卡片兜底显示0.0000 元。对应数据结构见 UsageStatistics 模型 中的cost_by_currency字段——该字段是当前推荐的成本统计口径而total_cost已标记为“已废弃使用 cost_by_currency”。2. 时间范围筛选页面右上角提供时间范围下拉框与「刷新」按钮最近 7 天最近 30 天最近 90 天切换时间范围会立即重新加载统计数据与图表changeloadData。该参数在 后端接口 中对应days查询参数取值范围为1 到 365 天服务端据此计算datetime.now() - timedelta(daysdays)作为时间下界。3. 图表展示按供应商统计饼图显示各供应商的成本占比鼠标悬停显示详细数据图例可点击切换显示/隐藏。其 tooltip 格式为{b}: ¥{c} ({d}%)即“供应商名: 金额(占比)”。饼图数据直接来源于后端by_provider聚合结果中每个供应商的cost字段。按模型统计柱状图显示成本最高的前 10 个模型按成本从高到低排序sort((a, b) b.value - a.value)后slice(0, 10)x 轴标签旋转 45 度避免重叠。注意后端by_model的键是供应商/模型名的复合形式如dashscope/qwen-max因此柱状图天然能区分不同供应商下的同名模型。每日成本趋势折线图展示每日成本变化采用平滑曲线smooth: true并带绿色半透明区域填充rgba(103, 194, 58, 0.2)便于直观观察成本波动趋势。日期键取自记录时间戳的前 10 位YYYY-MM-DD按字典序升序排列后绘制。三个图表均由 ECharts 渲染实例通过echarts.init创建并复用切换时间范围时仅更新option而不会重建实例性能表现良好。4. 使用记录表格详细记录每次 API 调用时间供应商模型输入Token输出Token成本分析类型会话ID2025-10-07 10:30:25dashscopeqwen-max1,234567¥0.0456stock_analysissession_123时间列使用toLocaleString(zh-CN)本地化格式展示成本列按toFixed(4)保留 4 位小数并跟随记录自身的currency字段显示对应货币符号会话 ID 列设置show-overflow-tooltip超长内容自动省略并支持悬停查看完整值表格加载时显示 loading 遮罩加载失败通过ElMessage.error提示。5. 分页功能支持每页显示 10 / 20 / 50 / 100 条记录支持页码跳转layout 为total, sizes, prev, pager, next, jumper显示总记录数。分页切换时重新调用记录查询接口接口层 getUsageRecords 还支持provider、model_name、start_date、end_date等可选过滤参数便于后续按条件精确检索。6. 清理旧记录点击「清理旧记录」按钮会弹出二次确认框“确定要删除90天前的旧记录吗此操作不可恢复。”确认后调用DELETE /api/usage/records/old?days90成功后提示实际删除条数已删除 N 条旧记录并刷新数据。后端对days参数的约束为30 到 365 天超出范围将返回参数校验错误删除逻辑基于timestamp now - days执行 MongoDB 批量删除见 delete_old_records。配置模型定价访问配置管理进入「设置 系统配置 配置管理」选择「大模型配置」标签找到要配置定价的模型点击「编辑」按钮。在配置管理页的模型表格中专门设有「定价」列见 ConfigManagement.vue当模型配置了input_price_per_1k或output_price_per_1k时会以「输入: 0.0200 CNY/1K」的格式直接展示在表格中。配置定价信息在编辑对话框的「定价配置」部分填写三个字段┌─────────────────────────────────────┐ │ 定价配置 │ ├─────────────────────────────────────┤ │ 输入价格: [0.0200] CNY/1K tokens │ │ 输出价格: [0.0600] CNY/1K tokens │ │ 货币单位: [CNY ▼] │ └─────────────────────────────────────┘填写说明输入价格每 1000 个输入 token 的价格输出价格每 1000 个输出 token 的价格货币单位选择 CNY人民币、USD美元或 EUR欧元。这三个字段在数据模型层对应 LLMConfig 的定价配置input_price_per_1k: Optional[float]、output_price_per_1k: Optional[float]、currency: str CNY。它们与max_tokens默认 4000、temperature默认 0.7范围 0.0–2.0、timeout默认 180 秒等参数共同构成模型的完整配置。查看定价信息配置完成后模型卡片中会显示定价信息┌─────────────────────────────────────┐ │ ️ qwen-max ✅ 启用 │ ├─────────────────────────────────────┤ │ Token: 4000 │ │ 温度: 0.7 │ │ 超时: 60s │ ├─────────────────────────────────────┤ │ 定价: │ │ 输入: 0.0200 CNY/1K │ │ 输出: 0.0600 CNY/1K │ └─────────────────────────────────────┘成本如何计算源码级链路定价配置并非仅供展示它直接参与每次 API 调用的成本核算。在 分析服务 中成本计算的完整链路如下分析任务执行后按分析类型估算或读取实际输入/输出 token 数从系统配置中按provider model_name精确匹配对应的LLMConfig读取该模型的input_price_per_1k与output_price_per_1k未配置时按0.0处理代入成本公式cost (input_tokens / 1000 × input_price) (output_tokens / 1000 × output_price)货币单位取自llm_config.currency缺省为CNY将UsageRecord含timestamp、provider、model_name、input_tokens、output_tokens、cost、currency、session_id、analysis_type、stock_code写入 MongoDB 的token_usage集合。该集合与 TradingAgents 核心库共用命名确保了前后端统计口径一致。使用示例场景 1查看本周成本访问使用统计页面选择「最近 7 天」查看总成本卡片查看每日成本趋势图判断本周成本是否平稳。场景 2对比不同模型成本访问使用统计页面查看「按模型统计」柱状图对比不同模型含供应商前缀的成本识别高成本模型评估是否值得更换。场景 3分析供应商使用情况访问使用统计页面查看「按供应商统计」饼图了解各供应商的成本占比优化供应商选择例如将简单任务切换到低成本供应商。场景 4查看详细使用记录访问使用统计页面滚动到使用记录表格查看每次 API 调用的详细信息时间、供应商、模型、输入/输出 Token、成本、分析类型、会话 ID根据需要调整每页显示数量10/20/50/100。场景 5清理历史数据访问使用统计页面点击「清理旧记录」按钮确认删除 90 天前的数据查看删除结果提示会显示实际删除条数。后端视角统计如何聚合为了更准确地理解前端看到的数字有必要了解统计服务的聚合逻辑usage_statistics_service.py。get_usage_statistics(days, provider, model_name)会按timestamp在[now - days, now]的 ISO 字符串区间内查询token_usage集合对每条记录分别累加到四个维度总计、by_provider、by_model键为供应商/模型、by_date键为日期前 10 位每个维度都统计requests、input_tokens、output_tokens、cost与按货币细分的cost_by_currency最终将defaultdict转换为普通 dict 返回给前端。对外暴露的 API 端点与前端调用一一对应方法路径说明关键参数GET/api/usage/records获取使用记录provider / model_name / start_date / end_date / limit1–1000GET/api/usage/statistics获取使用统计days1–365/ provider / model_nameGET/api/usage/cost/by-provider按供应商统计成本daysGET/api/usage/cost/by-model按模型统计成本daysGET/api/usage/cost/daily每日成本统计daysDELETE/api/usage/records/old删除旧记录days30–365默认 90所有端点均依赖get_current_user登录鉴权未登录访问会返回 401。最佳实践1. 定期查看建议每周查看一次使用统计关注成本趋势是否正常是否有异常高成本各模型使用情况。2. 成本优化根据统计数据优化模型选择对于简单任务使用低成本模型可结合 LLMConfig 中的capability_level能力分级与suitable_roles角色适配字段做精细路由对于复杂任务使用高性能模型平衡成本和效果。3. 预算控制设定每月预算目标定期对比实际成本与预算及时调整使用策略。4. 数据管理定期清理旧数据建议保留 90 天与清理接口默认值一致重要数据可以导出备份直接从 MongoDBtoken_usage集合导出即可关注异常使用记录如单次成本异常偏高、某个会话 Token 消耗突增。5. 定价维护建议及时更新供应商调整价格后及时更新配置否则统计成本会失真统一货币建议统一使用人民币CNY便于统计对比因为系统不自动做货币换算混用货币会导致总成本卡片出现多个币种行、难以横向比较精确配置价格精确到小数点后 4 位前端展示也是 4 位小数。故障排查问题 1页面加载失败症状页面显示错误或无法加载。解决方案检查网络连接刷新页面检查后端服务是否正常/api/usage/statistics依赖 MongoDB需确认数据库可达查看浏览器控制台错误信息确认请求是否因未登录而返回 401。问题 2图表不显示症状图表区域空白。解决方案检查是否有数据首次使用、无调用记录时各维度为空属正常现象尝试切换时间范围如从「最近 7 天」切到「最近 90 天」刷新页面检查 ECharts 是否正确加载组件通过import * as echarts from echarts按需引入。问题 3数据不准确症状显示的数据与预期不符。解决方案检查模型定价配置是否正确未配置定价的模型成本按 0 计算检查时间范围选择检查数据库中的使用记录连接 MongoDB 查看token_usage集合的timestamp与cost字段联系管理员检查后端日志日志关键字如获取使用统计成功、记录使用成本。问题 4无法清理旧记录症状点击清理按钮无反应或报错。解决方案检查用户权限需为已登录用户管理员优先检查后端服务状态查看浏览器控制台错误确认是否为参数校验失败days必须落在 30–365 区间联系管理员。响应式设计使用统计页面支持不同屏幕尺寸基于 Element Plus 栅格系统实现桌面端1200px完整显示所有功能概览卡片一行 4 列平板端768px–1200px图表自适应调整移动端768px垂直布局图表缩小。权限说明需要登录才能访问所有接口都经过get_current_user鉴权所有登录用户都可以查看使用统计从当前后端实现看记录查询与统计接口尚未按用户做数据隔离过滤管理员与普通用户当前可见范围一致文档所述的“只能查看自己的使用记录如果启用了用户隔离”属于规划中的多用户成本分摊能力启用后仅管理员可查看全部用户记录管理员可以查看所有用户的使用记录未来功能。注意事项数据延迟统计数据可能有几秒钟延迟因为使用记录在分析任务完成后异步写入货币单位确保所有模型使用统一的货币单位系统不做自动换算定价更新供应商调整价格后需要及时更新配置否则成本统计会失真数据备份重要数据建议定期导出备份清理旧记录操作不可恢复浏览器兼容建议使用 Chrome、Firefox、Edge 等现代浏览器页面依赖 ECharts 5 与 Vue 3 / Element Plus成本为 0 的情况未配置定价的模型其调用记录依然会被写入token_usage但cost为 0统计时不会计入成本排查“总成本偏低”问题时优先检查这里。未来功能计划中的功能导出统计报表Excel/PDF成本预警通知预算管理更多图表类型自定义时间范围成本优化建议多用户成本分摊相关文档使用统计与定价配置功能使用统计访问指南使用统计实现总结使用统计快速测试前端使用统计页面组件使用统计 API 封装使用统计后端路由使用统计服务实现【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED — 相关阅读

相关资讯

LATEST — 最新资讯

最新发布

TODAY — 本日精选

新闻

WEEKLY — 本周精选

新闻

MONTHLY — 本月精选

新闻