i/Aether
1
0
Fork 0
mirror of https://github.com/fawney19/Aether.git synced 2026-09-03 01:40:21 +08:00
Code Issues Packages Projects Releases Wiki Activity
1,189 Commits 6 Branches 174 Tags
ff4e853fd386e7cf3f30cf6f6b5e0d1f9537b2c1
Commit Graph

128 Commits

Author SHA1 Message Date
fawney19
c0b80c923a refactor(usage): 移除 RequestHeadersContent 中未使用的 diff props 
移除 clientHeadersWithDiff 和 providerHeadersWithDiff 属性及相关计算逻辑
 2026-02-26 02:36:37 +08:00
LewisPen
adaf9e4b93 feat(usage): 响应头 Tab 增加并排对比模式 
泛化 RequestHeadersContent 组件支持任意 header 对，
响应头 Tab 复用同一组件实现客户端/提供商响应头 Diff 对比。
 2026-02-24 15:25:59 +08:00
fawney19
cf2eee222e refactor: 前端全面替换 any 为 unknown 并统一错误处理，后端用量记录补写请求头/体 
- 前端 API 层、stores、conversation 解析器、组件全面替换 any 为 unknown/具体类型
- 错误处理统一使用 parseApiError/getErrorStatus 替代 err.response?.data?.detail 模式
- 后端 handler/TaskService/UsageLifecycle/StreamTracker 链路传递 request_headers/request_body
- streaming/pending 状态更新时可补写客户端和提供商的请求头及请求体
- 新增 TaskService 和 UsageService 相关测试
 2026-02-22 00:43:41 +08:00
fawney19
1e4d0006b9 fix: 用量记录保留空 headers/body，格式转换支持同 normalizer 透传 
- 用量记录和遥测写入中将 truthiness 检查改为 is not None，
  避免空 dict/list 被误丢弃
- FormatConversionRegistry 新增 _same_normalizer() 方法，
  共享 normalizer 的格式（如 claude:chat/claude:cli）视为同格式透传
- 前端请求详情抽屉按数据可用性智能选择默认数据源
- 视频任务 finalize 支持 headers/original_headers 等别名字段
 2026-02-21 21:16:35 +08:00
fawney19
0fe5346f4d refactor: 提取 HandlerAdapterBase 基类，新增 api_family/endpoint_kind 结构化维度 
- 从 ChatAdapterBase 和 CliAdapterBase 提取公共逻辑到 HandlerAdapterBase，
  消除头部处理、异常处理、计费策略等重复代码
- Usage 记录链路全程透传 api_family / endpoint_kind / provider_api_family /
  provider_endpoint_kind 四个结构化字段，替代从 api_format 字符串解析
- 删除冗余的 ClaudeCliNormalizer、GeminiCliNormalizer、ClaudeCliResponseParser、
  GeminiCliResponseParser，改用 data_format_id 回退机制自动复用 Chat 版本
- build_endpoint_url 签名统一扩展 request_data / model_name 参数
- 新增 Alembic 迁移，含历史数据回填
 2026-02-21 13:17:11 +08:00
fawney19
314e4a497d feat: 拆分 usage 记录的请求体/响应体为客户端侧与提供商侧 
将 request_body/response_body 语义明确为客户端原始请求体和提供商原始响应体，
新增 provider_request_body（格式转换后发给提供商的请求体）和 client_response_body
（格式转换后返回给客户端的响应体），支持跨格式转换场景下分别查看两侧数据。

- 数据库新增 provider_request_body/client_response_body 及对应压缩字段
- 全链路（telemetry/recording/handler/stream_context）传递新字段
- 维护调度器同步支持新字段的压缩与清理
- 前端请求详情抽屉支持请求体/响应体/响应头的客户端/提供商视图切换
 2026-02-21 01:56:28 +08:00
fawney19
7a81e56553 refactor: 统一 API 格式显示函数，补全 Usage/Trace 的 provider 链路信息 
- 提取 formatApiFormat 为共享工具函数，替换各组件中分散的 API_FORMAT_LABELS 调用
- Trace API 返回密钥认证类型(key_auth_type)和 OAuth 套餐信息(key_oauth_plan_type)
- 请求时间线展示密钥认证方式标签（OAuth/Vertex AI/Kiro 等）
- Usage 记录补充 provider_id/endpoint_id/key_id，避免 curl 复现时缺失 provider 信息
- curl 复现兜底从 RequestCandidate 表查找 provider 信息
- Headers Diff 面板左右独立滚动并同步垂直滚动位置
 2026-02-19 14:51:08 +08:00
fawney19
1c2a8119c0 feat: delegate 客户端替换为 hyper 原生实现，新增代理管理功能 
aether-proxy:
- 用 hyper-util Client + 自定义 InstrumentedConnector 替换 reqwest delegate 客户端
- 支持 HTTP/HTTPS 自动 TLS，ALPN h2 协商，connect/tls 分阶段计时
- ConnectTiming 通过 hyper extensions 传递，上游响应细分 connect_ms/tls_ms/ttfb_ms
- upgrade 命令在非 root 下跳过 systemd restart 并提示手动操作

后端:
- 新增 /admin/proxy-nodes/test-url 接口，支持直接测试代理 URL 连通性
- 新增 /admin/proxy-nodes/hmac-key 接口，获取 HMAC Key 供部署使用
- 提取 _test_proxy_connectivity 公共函数，消除 test_node 中的重复代码
- candidate_resolver 在 extra_data 中输出 needs_conversion/provider_api_format
- stats_aggregator 小时聚合增加 IntegrityError 冲突重试

前端:
- 请求时间线组件展示代理 timing 细分（DNS/连接/TLS/TTFB/上游处理）
- 请求时间线增加格式转换分界标记和 conversion badge
- ProxyNodes 页面新增代理 URL 测试和 HMAC Key 复制功能
- HardwareTooltip 从 Popover 改为 Tooltip 组件
 2026-02-11 23:24:59 +08:00
fawney19
0ddeccf698 feat(aether-proxy): delegate gzip body 流式透传替代读取解压 
- gzip 压缩请求体直接流式转发给上游，避免全量读取和解压
- 非 gzip 请求保持原有读取逻辑
- 移除 body_read_ms/decompress_ms 指标，新增 passthrough 标记
- 前端 timing 展示兼容旧版字段
- 同步更新 Cargo.lock
 2026-02-11 17:17:45 +08:00
fawney19
9647d95759 feat: delegate 协议改为 header 元数据 + gzip 压缩 body 直传 
- delegate wire format 从 JSON body 改为 HTTP headers 传递元数据
  (X-Delegate-Method/Url/Headers)，上游请求体 gzip 压缩后直传，
  减少跨国代理传输耗时
- Rust 侧新增 gzip 解压（含 decompression bomb 防护 50MB 上限）
- 升级模块从 GitHub API asset 下载改为公开 release URL 直链，
  GITHUB_TOKEN 变为可选
- 前端适配新 timing 字段，展示压缩率与 wire_size/body_size
- CI release notes 改用 generate_release_notes 自动生成
 2026-02-11 16:34:18 +08:00
fawney19
2a2a4b817e feat: 代理 timing 细分指标与前端展示优化 
- aether-proxy 新增 auth_ms/body_read_ms/body_parse_ms/body_size 计时字段
- 链路追踪面板代理耗时改为分阶段展示，密钥和代理信息改为堆叠布局
- 硬件信息从 Tooltip 改为 Popover，新增 FD Limit 展示
- 新增区域代码格式化工具函数，统一显示区域中文名称
 2026-02-11 15:33:01 +08:00
fawney19
d51234f202 fix(frontend): 链路追踪打开时自动选中进行中的尝试而非最后一个未执行的 2026-02-11 13:35:02 +08:00
fawney19
ed3f208dda feat(aether-proxy): 网络层全面优化与代理耗时追踪 
aether-proxy:
- 新增 20+ 可配置参数：Aether API/delegate/CONNECT 各阶段超时、连接池、TCP keepalive/nodelay
- AetherClient 支持指数退避重试(可配置次数/延迟)和 HTTP/2
- 新增 DNS 缓存(TTL + 容量限制)避免重复解析
- 新增并发连接数限制(Semaphore，默认基于硬件估算)
- CONNECT 隧道增加建连超时和升级超时
- TLS 增加握手超时、会话缓存(session ticket + memory cache)、ALPN 协商
- 新增 ProxyMetrics 收集请求计数和延迟，通过心跳上报
- delegate 响应注入 X-Proxy-Timing 头(dns_ms/upstream_ms/total_ms)

后端:
- StreamContext 和 handler 提取 X-Proxy-Timing 写入 proxy_info 追踪数据

前端:
- 请求时间线展示代理分阶段耗时(DNS/上游)
- Endpoint 添加按钮改为文字按钮样式
 2026-02-11 11:30:29 +08:00
fawney19
68f5e7e502 fix(frontend): 链路追踪打开时自动选中有效状态的节点 
修复 Provider 组状态提升逻辑，之前仅在 success 时更新组状态，
导致组内有 streaming/failed 等状态的 key 时组仍显示为 available，
自动选择逻辑无法识别有效节点。引入状态优先级机制正确提升组状态，
并扩大 fallback 有效状态范围，避免默认选中未执行的节点。
 2026-02-11 10:06:59 +08:00
fawney19
0c52341dec feat: TTFB 追踪记录与前端展示 + 缓存调度器代码整理 
- CLI handler 记录上游请求 TTFB 并注入 proxy_info
- 前端请求时间线展示 TTFB 耗时
- 调度器提升局部 import 到模块顶部，提取 _affinity_hash/_merge_restriction_sets 辅助方法
- 修复缓存亲和性写入的缩进层级
- Python 版本回退至 3.13
 2026-02-10 17:37:53 +08:00
fawney19
f9adf5938e feat: 请求记录 cURL 导出与回放功能 
- 后端新增 /{usage_id}/curl 接口，重建完整 cURL 命令（含明文 API Key）
- 后端新增 /{usage_id}/replay 接口，支持向原始或指定提供商回放请求
- 回放支持 OAuth/Vertex AI/API Key 多种认证方式和跨格式请求体转换
- 前端新增 ReplayDialog 组件，支持选择目标提供商/Key 并查看响应
- RequestDetailDrawer 添加回放按钮和 cURL 复制按钮
- 调整 Tab 内容区布局，表头栏与内容区融为一体
 2026-02-10 03:07:49 +08:00
fawney19
b34dd12863 feat: 新增 Kiro 适配器、OAuth 改进与多项功能增强 
- 新增 Kiro provider 适配器（EventStream 协议解析、令牌管理、用量追踪）
- 重构 OAuth 账户管理与统一配额机制
- 重构 Handler 基类（CLI adapter/handler、请求构建器、流处理器）
- 增强缓存监控后端 API 与前端可视化
- 改进 Gemini 格式标准化器与请求头处理
- Antigravity/Codex 适配器更新，移除旧 metadata_collector
- 新增数据库迁移：proxy provider API keys
- 前端 UI 多项优化

Co-Authored-By: AAEE86 <ppk0227@hotmail.com>
 2026-02-09 01:05:48 +08:00
fawney19
254d30d32d feat: 请求候选记录中追踪代理节点信息并在前端 timeline 展示 2026-02-08 01:18:00 +08:00
fawney19
62f852b851 feat: Antigravity 端点签名迁移至 gemini:chat，流式 usage 提取重构与请求详情自动刷新 
- Antigravity 端点签名从 gemini:cli 统一为 gemini:chat，保留向后兼容，含 DB 迁移
- 流式处理中 usage/completion/text 提取抽离为 _update_ctx_from_provider_event，
  支持 envelope 解包后提取，避免格式转换流程中重复计数
- 新增 has_format_conversion 属性，区分真正的格式转换与 envelope rewrite，
  修正 usage 展示层的格式转换标记
- 请求详情抽屉对未完成请求支持自动轮询刷新，关闭时自动停止
- 按次计费样式调整；实际成本仅在倍率非 1.0 时显示；缓存日志降级为 trace
 2026-02-07 02:59:02 +08:00
fawney19
b88fb6273b refactor: Antigravity/Codex 服务重构为插件化适配器架构 
- 将 Antigravity 和 Codex 从独立模块迁移至 src/services/provider/adapters/ 插件体系
- 新增 provider_types 和 oauth_token 模块，移除 maintenance_scheduler 中的 OAuth 定时刷新
- 增强 admin API：扩展 keys 和 provider_query 端点，新增 dashboard 路由
- 大幅增强 ProviderDetailDrawer 组件，新增 AntigravityQuotaDialog
- 改进 handler 基类（chat/cli）和错误分类器
- 优化 fetch_scheduler 和 upstream_fetcher
- 前端 UI 组件清理和优化
- 更新测试以匹配新模块结构
 2026-02-06 16:37:06 +08:00
fawney19
e01dfee41d feat: body rules 支持嵌套路径并增强前端验证体验 
- 后端 apply_body_rules 支持点号分隔的嵌套路径（如 metadata.user.name）
- 支持 \. 转义字面量点号（如 config\.v1.enabled）
- 配置导出导入升级至 v2.2，新增 SystemConfig 支持
- 前端请求体规则编辑器改用 JSON 格式输入，增加实时验证指示
- 用量记录表格新增移动端卡片视图，优化筛选器响应式布局
 2026-02-05 20:13:41 +08:00
fawney19
73249f09e4 Merge remote-tracking branch 'origin/master' into dev 
# Conflicts:
#	src/api/handlers/base/request_builder.py
#	src/api/handlers/openai_cli/adapter.py
#	src/services/system/maintenance_scheduler.py
 2026-02-05 00:07:29 +08:00
fawney19
4d6e7c094f feat: OAuth 账户管理、维护调度、端点健康检查增强及前端优化 
- 新增 OAuth 账户管理对话框和提供商详情抽屉中的 OAuth 信息展示
- 新增维护调度器(maintenance_scheduler)支持定时清理和健康检查
- 增强端点健康检查器，支持更多检测策略
- 重构 codex 服务为 metadata_collectors 模块
- 优化 OpenAI CLI normalizer 代码结构
- 前端: 改进使用量表格、统计图表、指南页面和异步任务管理
- 扩展多个数据库字符串列为 TEXT 类型
- 新增倒计时 composable 和 provider OAuth API 端点
 2026-02-04 23:59:45 +08:00
fawney19
065b1caaf9 feat: support more request statuses in timeline 2026-02-04 13:32:42 +08:00
fawney19
2516460a0d fix: show cancelled requests in timeline 2026-02-04 13:26:33 +08:00
fawney19
7f09f191a1 feat: 优化用量状态同步机制和 OpenAI CLI 流式转换 
- 增加状态回退保护，防止异步响应覆盖已知状态
- 添加轮询并发保护 (pollInFlight)，避免重复请求
- 支持 cancelled 状态筛选和显示
- 前端 mergeRecordStatus 保护活跃记录状态
- 后端 streaming 状态同步更新改为使用当前 DB 会话
- OpenAI CLI 流式转换增加工具调用事件支持
- 轮询接口新增 target_model 字段返回
- 修复迁移脚本 inspector 缓存问题，改用 information_schema
 2026-02-04 03:17:55 +08:00
fawney19
f3e2f84b38 feat: 统计数据优化 - 支持细粒度时间范围和多维度分析 
- 新增 StatsHourly/StatsDaily 预聚合表，支持任意时区的精确统计
- 实现 UTC datetime 范围查询策略，边界数据实时聚合
- 新增统计 API：用户/API Key 维度、成本分析、性能百分位、错误分类
- 新增前端页面：成本分析、性能分析、用户统计
- 新增 TimeRangePicker 组件和统计可视化组件
- 优化 Dashboard 和 Usage 页面支持时间范围筛选

Close #135
 2026-02-04 02:04:54 +08:00
fawney19
00442c41fa feat: 视频计费增强与影子计费系统 2026-02-03 18:48:39 +08:00
fawney19
7b66505634 refactor: 全局适配 ApiFamily/EndpointKind 结构化标识体系 
将新的 (ApiFamily, EndpointKind) / `family:kind` 签名体系应用到整个代码库：
- API Handlers: 所有 adapter/handler 使用新的签名格式
- Services: provider, model, usage, cache, auth 等服务层适配
- Database: ProviderEndpoint 新增 api_family/endpoint_kind 字段
- Frontend: Provider 管理、Usage 表格等组件适配
- Tests: 更新所有相关测试用例
 2026-02-01 17:28:00 +08:00
fawney19
c246ccfc91 refactor(api_format): 重构为结构化的 (ApiFamily, EndpointKind) 标识体系 
将扁平的 APIFormat 枚举 (CLAUDE, OPENAI, GEMINI, *_CLI) 重构为二维结构：
- ApiFamily: 协议族 (openai, claude, gemini)
- EndpointKind: 端点变体 (chat, cli, video, image)

新增 EndpointSignature 数据类和 `family:kind` 签名键工具函数，
统一 JSON dict/metrics/logs 中的字符串标识格式。
 2026-02-01 17:25:28 +08:00
fawney19
5c80be92c9 refactor: 使用 data_format_id 重构格式兼容性判断逻辑 
- 在 ApiFormatDefinition 中新增 data_format_id 字段标识数据格式
- 新增 can_passthrough() 函数判断格式间是否可透传
- 重构 compatibility.py 使用 data_format_id 替代 get_base_format()
- 使用量记录支持从 endpoint 回填格式信息（兼容历史数据）
- 前端优化格式转换显示逻辑，区分跨格式转换和同族格式差异
- 首页 header 响应式布局优化
 2026-01-28 11:07:23 +08:00
fawney19
c732a03263 feat: 添加格式转换追踪、模型过滤规则和 Provider 超时配置 
1. Usage 格式转换追踪
   - 新增 endpoint_api_format 和 has_format_conversion 字段
   - 在用量记录中显示格式转换信息（请求格式 → 端点格式）
   - 兼容历史数据的回填逻辑

2. Provider API Key 模型过滤规则
   - 新增 model_include_patterns 和 model_exclude_patterns 字段
   - 支持 * 和 ? 通配符，不区分大小写
   - 自动获取模型时应用过滤规则

3. Provider 超时配置
   - 新增 stream_first_byte_timeout 和 request_timeout 字段
   - 支持每个 Provider 单独配置超时时间
   - 优先使用 Provider 配置，否则回退到全局配置

Close #122, Close #123

Co-Authored-By: AAEE86 <33052466+AAEE86@users.noreply.github.com>
 2026-01-28 00:06:49 +08:00
fawney19
c3be83bf94 fix: 将 UsageRecord.provider 字段改为可选类型 
配合 PR #121 后端移除普通用户 API 中的 provider 字段
 2026-01-23 18:59:21 +08:00
NyaDoo
cddccd2b99 fix: 移除后端普通用户使用统计API中的提供商信息/修复下拉菜单悬停效果 (#121) 
* fix: 移除普通用户使用统计页面的提供商信息

普通用户不应该看到后端使用的提供商信息，此前前端筛选框和后端 API
都泄露了这些数据。

- 前端：为提供商筛选下拉菜单添加 isAdmin 条件
- 后端：移除 summary_by_provider 和 records 中的 provider 字段
- 补充：添加遗漏的 first_byte_time_ms 字段

* fix: 修复 SelectItem 下拉菜单悬停高亮效果

将 hover:bg-primary/10 改为 data-[highlighted]:bg-accent，与
DropdownMenuItem 保持一致。radix-vue 使用 data-highlighted 属性
控制高亮状态，这样键盘导航和鼠标悬停的高亮行为才能正确同步。

---------

Co-authored-by: LewisPen <LewisPen@nyadoo.com>
 2026-01-23 18:57:41 +08:00
fawney19
6f597a5f54 fix: 修复模型权限正则匹配逻辑及相关缓存清除 
- 修复 model_mappings 正则匹配不再受 candidate_models 限制
- Provider 启用/禁用/删除时清除 GlobalModel 解析缓存
- 优先级管理对话框中启用的 Provider 排在禁用的前面
- 修复请求时间线 skipped 状态颜色适配主题
 2026-01-23 16:10:53 +08:00
fawney19
4eeba69381 feat: 新增 cancelled 状态区分客户端主动断开连接 
- 新增 cancelled 请求状态，与系统失败 (failed) 区分
- 客户端主动断开连接 (HTTP 499) 不计入失败率统计
- 前后端同步更新状态枚举、UI 样式和统计逻辑
 2026-01-20 15:40:16 +08:00
fawney19
8053cbd854 feat: 分页组件支持 pageSize 浏览器缓存 
- 为 Pagination 组件添加 cacheKey 属性，支持将 pageSize 缓存到 localStorage
- 组件挂载时自动恢复缓存的 pageSize 设置
- 为各页面的分页组件配置独立的缓存键
- 仅在显示 pageSize 选择器时启用缓存恢复

Closes #105

Co-Authored-By: AAEE86 <33052466+AAEE86@users.noreply.github.com>
 2026-01-17 20:21:03 +08:00
fawney19
b807c16395 fix: 修复对话轮次分组器的类型安全问题 
- 移除 grouper.ts 中的 as any 类型断言，使用正确的类型守卫
- 导入具体的 RenderBlock 类型替代 import() 语法
- 合并 ConversationView.vue 中的两个 watch 避免竞争条件
- 使用 lastRenderResultId 追踪变化防止重复初始化
 2026-01-16 19:53:54 +08:00
LewisPen
ed1d828f85 feat: 实现对话轮次折叠视图 
- 新增轮次分组逻辑，将消息按 user/assistant 配对分组
- 新增 TurnCard 组件，支持折叠/展开单个轮次
- 新增 TurnBadges 组件，显示思考/工具/图片/错误图标
- 历史轮次默认折叠，最新轮次默认展开
- 折叠时显示用户和助手消息摘要
- 统一 UI 设计规范：边距、字体、图标、圆角
 2026-01-16 15:54:21 +08:00
LewisPen
691a71ac05 refactor: 将 BlockRenderer 和 ConversationView 样式改为 Tailwind 
移除手写 CSS，统一使用 Tailwind 原子类，符合项目设计规范：
- BlockRenderer: 删除 260 行 scoped CSS，改用 Tailwind 类
- ConversationView: 删除 38 行 scoped CSS，改用 Tailwind 类
- 使用样式映射对象管理消息块的角色样式
 2026-01-16 11:22:11 +08:00
fawney19
adc82532eb refactor: 将对话解析器拆分为独立模块 
将 lib/conversationParser 重构为 conversation/ 目录:
- 按 API 格式拆分解析器 (claude.ts, openai.ts, gemini.ts)
- 提取公共渲染逻辑到 render.ts
- 添加解析器注册表支持自动格式检测
- 更新组件导入路径
 2026-01-16 03:11:41 +08:00
fawney19
02770d56df refactor: 重构请求详情对话视图的渲染架构 
- 新增 BlockRenderer 组件，支持递归渲染多种内容块类型
- 将 ConversationView 改为使用 RenderResult 和 BlockRenderer
- 删除旧的 messageExtractor 工具，改用 conversationParser 库
- 更新 RequestDetailDrawer 中的对话解析和复制逻辑
 2026-01-16 02:53:47 +08:00
fawney19
1366c0b973 fix: 优化请求详情抽屉在窄屏的响应式布局 
- 窄屏时抽屉占满全宽，宽屏时保持 800px
- 减小窄屏时的内边距 (px-3/py-3 vs px-6/py-4)
- 阶梯定价标题行在窄屏时改为垂直布局
- Tab 按钮内边距响应式调整，工具栏不被压缩
 2026-01-16 01:53:59 +08:00
fawney19
8bd3a894f1 fix: 修复请求链路追踪宽度不足时节点被遮挡的问题 
使用 justify-content: safe center 替代 center，
当内容溢出时自动回退到靠左对齐，确保左侧节点可滚动访问
 2026-01-16 01:43:52 +08:00
fawney19
6cc66e404b fix: 将请求详情抽屉的请求头默认数据源改为提供商 2026-01-16 01:38:59 +08:00
fawney19
80887dd2cc fix: 修复请求详情抽屉的默认状态问题 
- viewMode 默认改为 formatted，避免按钮被禁用
- currentExpandDepth 默认改为 0，与收缩状态一致
 2026-01-15 19:23:01 +08:00
fawney19
b2731eddf3 fix: 修复对话视图合并后的问题 
- 移除未使用的变量 index
- 修复展开/收缩按钮在非请求体Tab被禁用的问题
- 删除未使用的 copyJsonToClipboard 函数

Co-Authored-By: LewisPen <LewisPen@nyadoo.com>
 2026-01-15 19:18:32 +08:00
LewisPen
38607332b9 feat(usage): 请求详情页面添加对话视图功能 2026-01-15 18:37:59 +08:00
fawney19
bc16c0eec8 style(usage): 调整使用记录表格类型列宽度 2026-01-15 13:44:22 +08:00
fawney19
bc2b430ec3 style(usage): 请求链路节点改回居中布局并修复 TypeScript 兼容性 
- 将节点布局从两端对齐改回居中展示
- 将 findLastIndex 替换为向后兼容的 for 循环实现
 2026-01-15 13:29:22 +08:00