Skip to content

[upstream-port] 用量日志 CSV 导出(new-api #7774 / 633b4c5b) #900

Closed

Description

@LIghtJUNction

上游来源

做什么 / 为什么

在用量日志(common log)页 Search 旁增加 Export:按当前视图过滤条件 + 用户选择的时间范围,下载 CSV(列标题随查看者语言)。普通用户只导出自己的日志;管理员在全站视图可导出全部用户。

配套能力:

  • 每用户同时只允许一次导出(Redis 跨节点占位,约 1 分钟超时释放)
  • 运维设置:是否允许用户导出(默认开)、最长日志时间范围天数(默认改为 365;用户搜索与导出、仪表盘用量/流量图共用同一上限)
  • 日志维护页拆成四个模块(记录 / 搜索与导出 / 历史清理 / 服务端日志文件)——产品行为不变,主要是 UI 重组

LMM 已有较完整的 usage-logs UI,但仓库内 无 export-logs / LogExport / log_export 实现;这是明确缺口,对用户对账与管理员审计有直接价值。

路径映射(FORK / 微服务主线)

默认分支 wip/rust-core-go-extensions(见 #895);旧 main/traditional 冻结于 3948a0a1,移植须在微服务源码重新确认,不回灌旧库/权限/资金实现。

上游路径 LMM 候选
controller/log.go、service/log_export.go、model/log.go、setting/operation_setting/log_setting.go、router/api-router.go apps/api-go/...(或当前 WIP 中日志/选项实际归属的 Go 服务)
web/src/features/usage-logs/**、web/src/features/system-settings/maintenance/**、i18n apps/web/...(前端须 CloudAgent claude-opus-5-5,保留 LMM 品牌/DESIGN/NOTICE)

风险

  • 隐私/权限:管理员全站导出体量大,须严格沿用现有 admin 鉴权与用户范围隔离;勿把 raw UA / 密钥类字段写入 CSV
  • 资源:大范围导出可能拖垮 DB;须保留并发占位、时间范围上限、分页/流式写出;Redis-off 本地运行时要有单机退化路径(FORK 强调 Redis-off)
  • 设置契约:LogTimeRangeDays 影响仪表盘图表范围,可能改变现有「固定一个月」产品行为——需产品确认默认 365 是否接受
  • 前端:维护页大重构(+2481/−630 量级)勿机械复制上游视觉;只移植导出对话框 + 必要设置项

测试建议

  • 用户:仅能导出本人;超范围天数拒绝;第二次并发导出拒绝
  • 管理员:全站视图可导出多用户;非 admin 不可越权
  • Redis 开/关:占位语义一致
  • CSV:过滤条件生效、语言列头、无敏感泄漏
  • 仪表盘用量/流量图与设置上限一致
  • go test(controller/log_export 等)+ Web 导出对话框/设置单测;不改变计费/CAS/钱包

工作量

中等(后端导出 API + 设置 + FE 对话框与维护页局部;FE 需 Opus 5.5)。建议先后端 API/设置,再 FE。CloudAgent usage 当前耗尽时只记 issue,不自动开 PR。

相关

Activity

  1. added
    botOpened by the maintenance bot
    upstream-portQuantumNous/new-api upstream commit port candidate
    on Oct 12, 2026
  2. LIghtJUNction commented on Oct 30, 2026

    @LIghtJUNction
    MemberAuthor

    已在 tip / 固定源码核对:用量日志 CSV 导出已落地,可关。

    证据(lmm-api-source @ 7520d0bc 针 / tip 22cda9e9,主仓 tip 99b8d6df):

    • 后端:services/core/src/usage.rs 暴露 GET /core/v1/usage/self/export.csv 与 GET /core/v1/usage/admin/export.csv;services/core/src/usage/export.rs 的 NativeCsv 流式写出(含过滤后的原生回执列、字节上限与公式注入防护)。
    • 前端:apps/web/src/features/usage-logs/api.ts 的 exportNativeUsage;apps/web/src/features/usage-logs/components/common-logs-filter-bar.tsx 过滤栏「Export CSV」按钮按当前视图过滤下载 lmm-native-usage.csv。

    上游 new-api #7774 / 633b4c5b 的核心能力(用户/管理员范围导出 + UI 导出入口)已在当前微服务主线具备。关闭为 completed。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    botOpened by the maintenance botupstream-portQuantumNous/new-api upstream commit port candidate

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions