coding-proxy 0.1.4a4__tar.gz → 0.1.4a6__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of coding-proxy might be problematic. Click here for more details.

Files changed (141) hide show
  1. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/PKG-INFO +1 -1
  2. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/pyproject.toml +1 -1
  3. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/cli/__init__.py +56 -8
  4. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/config/config.default.yaml +2 -0
  5. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/config/resiliency.py +7 -1
  6. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/logging/db.py +189 -24
  7. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/logging/stats.py +90 -21
  8. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/routing/error_classifier.py +47 -0
  9. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/routing/executor.py +136 -14
  10. coding_proxy-0.1.4a6/src/coding/proxy/server/request_normalizer.py +286 -0
  11. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/vendors/anthropic.py +58 -4
  12. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/vendors/base.py +2 -2
  13. coding_proxy-0.1.4a6/tests/test_cli_usage.py +233 -0
  14. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_error_classifier.py +100 -0
  15. coding_proxy-0.1.4a6/tests/test_request_normalizer.py +310 -0
  16. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_router_executor.py +425 -0
  17. coding_proxy-0.1.4a6/tests/test_time_range.py +120 -0
  18. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_vendors.py +183 -0
  19. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/uv.lock +1 -1
  20. coding_proxy-0.1.4a4/src/coding/proxy/server/request_normalizer.py +0 -143
  21. coding_proxy-0.1.4a4/tests/test_cli_usage.py +0 -112
  22. coding_proxy-0.1.4a4/tests/test_request_normalizer.py +0 -91
  23. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/.github/workflows/ci.yml +0 -0
  24. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/.github/workflows/coverage.yml +0 -0
  25. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/.github/workflows/promote.yml +0 -0
  26. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/.github/workflows/release.yml +0 -0
  27. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/.gitignore +0 -0
  28. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/AGENTS.md +0 -0
  29. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/CHANGELOG.md +0 -0
  30. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/CLAUDE.md +0 -0
  31. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/LICENSE +0 -0
  32. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/README.md +0 -0
  33. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/docs/ci-cd.md +0 -0
  34. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/docs/framework.md +0 -0
  35. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/docs/user-guide.md +0 -0
  36. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/docs/zh-CN/README.md +0 -0
  37. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/__init__.py +0 -0
  38. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/__init__.py +0 -0
  39. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/__main__.py +0 -0
  40. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/auth/__init__.py +0 -0
  41. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/auth/providers/__init__.py +0 -0
  42. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/auth/providers/base.py +0 -0
  43. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/auth/providers/github.py +0 -0
  44. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/auth/providers/google.py +0 -0
  45. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/auth/runtime.py +0 -0
  46. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/auth/store.py +0 -0
  47. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/cli/auth_commands.py +0 -0
  48. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/cli/banner.py +0 -0
  49. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/compat/__init__.py +0 -0
  50. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/compat/canonical.py +0 -0
  51. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/compat/session_store.py +0 -0
  52. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/config/__init__.py +0 -0
  53. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/config/auth_schema.py +0 -0
  54. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/config/loader.py +0 -0
  55. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/config/routing.py +0 -0
  56. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/config/schema.py +0 -0
  57. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/config/server.py +0 -0
  58. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/config/vendors.py +0 -0
  59. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/convert/__init__.py +0 -0
  60. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/convert/anthropic_to_gemini.py +0 -0
  61. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/convert/anthropic_to_openai.py +0 -0
  62. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/convert/gemini_sse_adapter.py +0 -0
  63. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/convert/gemini_to_anthropic.py +0 -0
  64. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/convert/openai_to_anthropic.py +0 -0
  65. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/logging/__init__.py +0 -0
  66. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/model/__init__.py +0 -0
  67. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/model/auth.py +0 -0
  68. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/model/compat.py +0 -0
  69. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/model/constants.py +0 -0
  70. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/model/pricing.py +0 -0
  71. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/model/token.py +0 -0
  72. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/model/vendor.py +0 -0
  73. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/pricing.py +0 -0
  74. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/routing/__init__.py +0 -0
  75. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/routing/circuit_breaker.py +0 -0
  76. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/routing/model_mapper.py +0 -0
  77. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/routing/quota_guard.py +0 -0
  78. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/routing/rate_limit.py +0 -0
  79. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/routing/retry.py +0 -0
  80. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/routing/router.py +0 -0
  81. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/routing/session_manager.py +0 -0
  82. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/routing/tier.py +0 -0
  83. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/routing/usage_parser.py +0 -0
  84. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/routing/usage_recorder.py +0 -0
  85. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/server/__init__.py +0 -0
  86. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/server/app.py +0 -0
  87. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/server/factory.py +0 -0
  88. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/server/responses.py +0 -0
  89. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/server/routes.py +0 -0
  90. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/streaming/__init__.py +0 -0
  91. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/streaming/anthropic_compat.py +0 -0
  92. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/vendors/__init__.py +0 -0
  93. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/vendors/antigravity.py +0 -0
  94. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/vendors/copilot.py +0 -0
  95. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/vendors/copilot_models.py +0 -0
  96. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/vendors/copilot_token_manager.py +0 -0
  97. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/vendors/copilot_urls.py +0 -0
  98. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/vendors/mixins.py +0 -0
  99. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/vendors/token_manager.py +0 -0
  100. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/src/coding/proxy/vendors/zhipu.py +0 -0
  101. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/__init__.py +0 -0
  102. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_antigravity.py +0 -0
  103. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_app_routes.py +0 -0
  104. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_auto_login.py +0 -0
  105. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_banner.py +0 -0
  106. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_circuit_breaker.py +0 -0
  107. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_compat.py +0 -0
  108. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_config_init.py +0 -0
  109. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_config_loader.py +0 -0
  110. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_convert_request.py +0 -0
  111. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_convert_response.py +0 -0
  112. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_convert_sse.py +0 -0
  113. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_copilot.py +0 -0
  114. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_copilot_convert_request.py +0 -0
  115. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_copilot_convert_response.py +0 -0
  116. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_copilot_models.py +0 -0
  117. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_copilot_urls.py +0 -0
  118. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_currency.py +0 -0
  119. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_mixins.py +0 -0
  120. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_model_auth.py +0 -0
  121. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_model_compat.py +0 -0
  122. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_model_constants.py +0 -0
  123. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_model_mapper.py +0 -0
  124. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_model_pricing.py +0 -0
  125. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_model_token.py +0 -0
  126. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_model_vendor.py +0 -0
  127. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_parse_usage.py +0 -0
  128. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_pricing.py +0 -0
  129. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_quota_guard.py +0 -0
  130. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_rate_limit.py +0 -0
  131. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_router_chain.py +0 -0
  132. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_runtime_reauth.py +0 -0
  133. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_schema.py +0 -0
  134. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_streaming_anthropic_compat.py +0 -0
  135. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_tier.py +0 -0
  136. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_tiers_config.py +0 -0
  137. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_token_logger.py +0 -0
  138. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_token_manager.py +0 -0
  139. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_types.py +0 -0
  140. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_vendor_streaming.py +0 -0
  141. {coding_proxy-0.1.4a4 → coding_proxy-0.1.4a6}/tests/test_zhipu.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: coding-proxy
3
- Version: 0.1.4a4
3
+ Version: 0.1.4a6
4
4
  Summary: A High-Availability, Transparent, and Smart Multi-Vendor Proxy for Claude Code. Support Claude Plans, GitHub Copilot, Google Antigravity, ZAI/GLM.
5
5
  Project-URL: Source Code, https://github.com/ThreeFish-AI/coding-proxy
6
6
  Project-URL: User Guide, https://github.com/ThreeFish-AI/coding-proxy/blob/master/docs/user-guide.md
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "coding-proxy"
3
- version = "0.1.4a4"
3
+ version = "0.1.4a6"
4
4
  description = "A High-Availability, Transparent, and Smart Multi-Vendor Proxy for Claude Code. Support Claude Plans, GitHub Copilot, Google Antigravity, ZAI/GLM."
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.12"
@@ -8,7 +8,7 @@ from __future__ import annotations
8
8
  import asyncio
9
9
  import logging
10
10
  from pathlib import Path
11
- from typing import TYPE_CHECKING, Optional
11
+ from typing import TYPE_CHECKING
12
12
 
13
13
  import typer
14
14
 
@@ -18,7 +18,7 @@ if TYPE_CHECKING:
18
18
  from rich.console import Console
19
19
 
20
20
  from ..config.loader import load_config
21
- from ..logging.db import TokenLogger
21
+ from ..logging.db import TimePeriod, TokenLogger
22
22
  from ..logging.stats import show_usage
23
23
  from .auth_commands import app as auth_app
24
24
  from .auth_commands import auto_login_if_needed as _auto_login_if_needed
@@ -48,6 +48,29 @@ def _build_token_store(cfg_path: Path | None = None):
48
48
  return cfg, store
49
49
 
50
50
 
51
+ def _resolve_period(
52
+ *,
53
+ days: int = 7,
54
+ week: int | None = None,
55
+ month: int | None = None,
56
+ total: bool = False,
57
+ ) -> tuple[TimePeriod, int]:
58
+ """将互斥的时间维度标志解析为 (TimePeriod, count) 元组.
59
+
60
+ 优先级: ``-t`` > ``-m`` > ``-w`` > ``-d``。
61
+
62
+ Returns:
63
+ ``(period, count)`` 元组。``count`` 表示查询最近第 N 个周期的数据。
64
+ """
65
+ if total:
66
+ return TimePeriod.TOTAL, 1
67
+ if month is not None:
68
+ return TimePeriod.MONTH, max(1, month)
69
+ if week is not None:
70
+ return TimePeriod.WEEK, max(1, week)
71
+ return TimePeriod.DAY, max(1, days)
72
+
73
+
51
74
  # ── 主命令 ─────────────────────────────────────────────────────
52
75
 
53
76
 
@@ -118,20 +141,38 @@ def status(
118
141
 
119
142
  @app.command()
120
143
  def usage(
121
- days: int = typer.Option(7, "--days", "-d", help="统计天数"),
144
+ days: int = typer.Option(7, "--days", "-d", help="统计天数(与 -w/-m/-t 互斥)"),
145
+ week: int | None = typer.Option(
146
+ None, "--week", "-w", help="最近第 N 周统计(按周聚合,默认 1)"
147
+ ),
148
+ month: int | None = typer.Option(
149
+ None, "--month", "-m", help="最近第 N 月统计(按月聚合,默认 1)"
150
+ ),
151
+ total: bool = typer.Option(False, "--total", "-t", help="统计全部历史记录"),
122
152
  vendor: str | None = typer.Option(None, "--vendor", "-v", help="过滤供应商"),
123
- model: str | None = typer.Option(None, "--model", "-m", help="过滤请求模型"),
153
+ model: str | None = typer.Option(None, "--model", help="过滤请求模型"),
124
154
  db_path: str | None = typer.Option(None, "--db", help="数据库路径"),
125
155
  ) -> None:
126
- """查看 Token 使用统计."""
156
+ """查看 Token 使用统计.
157
+
158
+ 时间维度(互斥,优先级 -t > -m > -w > -d):
159
+
160
+ \b
161
+ -d 7 最近 7 天(默认,按日聚合)
162
+ -w [N] 最近第 N 周(按周聚合,默认 1=本周)
163
+ -m [N] 最近第 N 月(按月聚合,默认 1=本月)
164
+ -t 全部历史(按供应商+模型聚合)
165
+ """
166
+ period, count = _resolve_period(days=days, week=week, month=month, total=total)
127
167
  cfg = load_config(Path(db_path) if db_path else None)
128
168
  token_logger = TokenLogger(cfg.db_path)
129
- asyncio.run(_run_usage(token_logger, days, vendor, model, cfg))
169
+ asyncio.run(_run_usage(token_logger, period, count, vendor, model, cfg))
130
170
 
131
171
 
132
172
  async def _run_usage(
133
173
  token_logger: TokenLogger,
134
- days: int,
174
+ period: TimePeriod,
175
+ count: int,
135
176
  vendor: str | None,
136
177
  model: str | None,
137
178
  cfg: ProxyConfig,
@@ -140,7 +181,14 @@ async def _run_usage(
140
181
 
141
182
  await token_logger.init()
142
183
  pricing_table = PricingTable(cfg.pricing)
143
- await show_usage(token_logger, days, vendor, model, pricing_table)
184
+ await show_usage(
185
+ token_logger,
186
+ vendor=vendor,
187
+ model=model,
188
+ pricing_table=pricing_table,
189
+ period=period,
190
+ count=count,
191
+ )
144
192
  await token_logger.close()
145
193
 
146
194
 
@@ -122,9 +122,11 @@ failover:
122
122
  error_types:
123
123
  - "rate_limit_error"
124
124
  - "overloaded_error"
125
+ - "api_error"
125
126
  error_message_patterns:
126
127
  - "quota"
127
128
  - "usage cap"
129
+ - "internal network failure"
128
130
 
129
131
  # === 模型映射 ===
130
132
  model_mapping:
@@ -30,7 +30,13 @@ class FailoverConfig(BaseModel):
30
30
  default=["rate_limit_error", "overloaded_error", "api_error"],
31
31
  )
32
32
  error_message_patterns: list[str] = Field(
33
- default=["quota", "limit exceeded", "usage cap", "capacity"],
33
+ default=[
34
+ "quota",
35
+ "limit exceeded",
36
+ "usage cap",
37
+ "capacity",
38
+ "internal network failure",
39
+ ],
34
40
  )
35
41
 
36
42
 
@@ -4,6 +4,7 @@ from __future__ import annotations
4
4
 
5
5
  import logging
6
6
  from datetime import UTC, datetime, timedelta
7
+ from enum import StrEnum
7
8
  from pathlib import Path
8
9
  from zoneinfo import ZoneInfo
9
10
 
@@ -12,6 +13,21 @@ import aiosqlite
12
13
  logger = logging.getLogger(__name__)
13
14
 
14
15
 
16
+ # ── 时间维度枚举 ──────────────────────────────────────────────
17
+
18
+
19
+ class TimePeriod(StrEnum):
20
+ """用量查询时间维度."""
21
+
22
+ DAY = "day"
23
+ WEEK = "week"
24
+ MONTH = "month"
25
+ TOTAL = "total"
26
+
27
+
28
+ # ── 时区工具函数 ──────────────────────────────────────────────
29
+
30
+
15
31
  def _local_tz() -> ZoneInfo:
16
32
  """获取系统本地时区,失败降级 UTC."""
17
33
  try:
@@ -40,6 +56,48 @@ def _hours_ago_utc_iso(hours: float) -> str:
40
56
  return cutoff.strftime("%Y-%m-%dT%H:%M:%f+00:00")
41
57
 
42
58
 
59
+ def _weeks_start_utc_iso(weeks: int) -> str:
60
+ """计算本地时区下 weeks 周前的周一 00:00 对应的 UTC ISO 字符串."""
61
+ tz = _local_tz()
62
+ now = datetime.now(tz)
63
+ monday = now.date() - timedelta(days=now.weekday(), weeks=max(1, weeks) - 1)
64
+ start_dt = datetime(monday.year, monday.month, monday.day, tzinfo=tz)
65
+ return start_dt.astimezone(UTC).strftime("%Y-%m-%dT%H:%M:%f+00:00")
66
+
67
+
68
+ def _months_start_utc_iso(months: int) -> str:
69
+ """计算本地时区下 months 个月前的 1 日 00:00 对应的 UTC ISO 字符串."""
70
+ tz = _local_tz()
71
+ now = datetime.now(tz)
72
+ y, m = now.year, now.month
73
+ m -= max(1, months) - 1
74
+ while m <= 0:
75
+ m += 12
76
+ y -= 1
77
+ start_dt = datetime(y, m, 1, tzinfo=tz)
78
+ return start_dt.astimezone(UTC).strftime("%Y-%m-%dT%H:%M:%f+00:00")
79
+
80
+
81
+ def _period_start_iso(period: TimePeriod, count: int) -> str | None:
82
+ """根据时间维度和数量计算起始 UTC ISO 字符串.
83
+
84
+ Returns:
85
+ ISO 字符串,或 ``None``(``count == 0`` 或 TOTAL 维度时不限时间范围)。
86
+ """
87
+ if count == 0:
88
+ return None # count=0 语义:不限时间
89
+ if period is TimePeriod.DAY:
90
+ return _days_start_utc_iso(count)
91
+ if period is TimePeriod.WEEK:
92
+ return _weeks_start_utc_iso(count)
93
+ if period is TimePeriod.MONTH:
94
+ return _months_start_utc_iso(count)
95
+ return None # TOTAL: 全量查询
96
+
97
+
98
+ # ── SQLite UDF ────────────────────────────────────────────────
99
+
100
+
43
101
  def _local_date_udf(ts_str: str) -> str:
44
102
  """
45
103
  SQLite UDF:将 UTC ISO 时间戳转为本地日期字符串.
@@ -63,6 +121,36 @@ def _local_date_udf(ts_str: str) -> str:
63
121
  return ""
64
122
 
65
123
 
124
+ def _local_week_udf(ts_str: str) -> str:
125
+ """SQLite UDF:将 UTC ISO 时间戳转为本地 ISO 周标识 (YYYY-WNN)."""
126
+ try:
127
+ tz = _local_tz()
128
+ return (
129
+ datetime.fromisoformat(ts_str.replace("Z", "+00:00"))
130
+ .astimezone(tz)
131
+ .strftime("%G-W%V")
132
+ )
133
+ except (ValueError, TypeError, AttributeError):
134
+ return ""
135
+
136
+
137
+ def _local_month_udf(ts_str: str) -> str:
138
+ """SQLite UDF:将 UTC ISO 时间戳转为本地年月标识 (YYYY-MM)."""
139
+ try:
140
+ tz = _local_tz()
141
+ return (
142
+ datetime.fromisoformat(ts_str.replace("Z", "+00:00"))
143
+ .astimezone(tz)
144
+ .strftime("%Y-%m")
145
+ )
146
+ except (ValueError, TypeError, AttributeError):
147
+ if isinstance(ts_str, str) and len(ts_str) >= 7:
148
+ return ts_str[:7]
149
+ return ""
150
+
151
+
152
+ # ── DDL ───────────────────────────────────────────────────────
153
+
66
154
  _CREATE_TABLES = """
67
155
  CREATE TABLE IF NOT EXISTS usage_log (
68
156
  id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -104,6 +192,35 @@ CREATE INDEX IF NOT EXISTS idx_usage_evidence_request_id ON usage_evidence(reque
104
192
  CREATE INDEX IF NOT EXISTS idx_usage_evidence_vendor ON usage_evidence(vendor);
105
193
  """
106
194
 
195
+ # ── 时间维度 → SQL 片段映射 ───────────────────────────────────
196
+
197
+ _PERIOD_SQL: dict[TimePeriod, tuple[str, str, str]] = {
198
+ # (date_expr, group_by, order_by_expr)
199
+ TimePeriod.DAY: (
200
+ "local_date(ts) AS date",
201
+ "local_date(ts), vendor, model_served",
202
+ "local_date(ts) DESC, vendor, model_served",
203
+ ),
204
+ TimePeriod.WEEK: (
205
+ "local_week(ts) AS date",
206
+ "local_week(ts), vendor, model_served",
207
+ "local_week(ts) DESC, vendor, model_served",
208
+ ),
209
+ TimePeriod.MONTH: (
210
+ "local_month(ts) AS date",
211
+ "local_month(ts), vendor, model_served",
212
+ "local_month(ts) DESC, vendor, model_served",
213
+ ),
214
+ TimePeriod.TOTAL: (
215
+ "NULL AS date",
216
+ "vendor, model_served",
217
+ "vendor, model_served",
218
+ ),
219
+ }
220
+
221
+
222
+ # ── TokenLogger ───────────────────────────────────────────────
223
+
107
224
 
108
225
  class TokenLogger:
109
226
  def __init__(self, db_path: Path) -> None:
@@ -120,8 +237,10 @@ class TokenLogger:
120
237
  await self._migrate_rename_backend_to_vendor()
121
238
  await self._migrate_add_failover_from()
122
239
  await self._db.executescript(_CREATE_INDEXES)
123
- # 注册时区感知的日期函数:将 UTC 时间戳转为本地日期
240
+ # 注册时区感知的日期函数:将 UTC 时间戳转为本地时间维度
124
241
  await self._db.create_function("local_date", 1, _local_date_udf)
242
+ await self._db.create_function("local_week", 1, _local_week_udf)
243
+ await self._db.create_function("local_month", 1, _local_month_udf)
125
244
  await self._db.commit()
126
245
 
127
246
  async def _migrate_add_failover_from(self) -> None:
@@ -248,14 +367,31 @@ class TokenLogger:
248
367
  rows = await cursor.fetchall()
249
368
  return [dict(row) for row in rows]
250
369
 
251
- async def query_daily(
252
- self, days: int = 7, vendor: str | None = None, model: str | None = None
370
+ # ── 核心查询方法 ──────────────────────────────────────────
371
+
372
+ async def query_usage(
373
+ self,
374
+ *,
375
+ period: TimePeriod = TimePeriod.DAY,
376
+ count: int = 7,
377
+ vendor: str | None = None,
378
+ model: str | None = None,
253
379
  ) -> list[dict]:
380
+ """按指定时间维度聚合 Token 使用统计.
381
+
382
+ Args:
383
+ period: 时间维度(日/周/月/全量)。
384
+ count: ``period`` 的数量。仅用于计算起始时间边界,
385
+ ``TOTAL`` 维度下忽略此参数。
386
+ vendor: 过滤供应商。
387
+ model: 过滤请求模型。
388
+ """
254
389
  if not self._db:
255
390
  return []
256
- days = max(1, days)
257
- start_iso = _days_start_utc_iso(days)
258
- sql = """SELECT local_date(ts) AS date, vendor,
391
+
392
+ date_expr, group_clause, order_clause = _PERIOD_SQL[period]
393
+
394
+ sql = f"""SELECT {date_expr}, vendor,
259
395
  GROUP_CONCAT(DISTINCT model_requested) AS model_requested,
260
396
  model_served,
261
397
  COUNT(*) AS total_requests,
@@ -265,56 +401,85 @@ class TokenLogger:
265
401
  SUM(cache_read_tokens) AS total_cache_read,
266
402
  SUM(CASE WHEN failover THEN 1 ELSE 0 END) AS total_failovers,
267
403
  AVG(duration_ms) AS avg_duration_ms
268
- FROM usage_log WHERE ts >= ?"""
269
- params: list = [start_iso]
404
+ FROM usage_log WHERE 1=1"""
405
+
406
+ params: list = []
407
+
408
+ start_iso = _period_start_iso(period, count)
409
+ if start_iso is not None:
410
+ sql += " AND ts >= ?"
411
+ params.append(start_iso)
412
+
270
413
  if vendor:
271
414
  sql += " AND vendor = ?"
272
415
  params.append(vendor)
273
416
  if model:
274
417
  sql += " AND model_requested = ?"
275
418
  params.append(model)
276
- sql += (
277
- " GROUP BY local_date(ts), vendor, model_served"
278
- " ORDER BY local_date(ts) DESC, vendor, model_served"
279
- )
419
+
420
+ sql += f" GROUP BY {group_clause} ORDER BY {order_clause}"
421
+
280
422
  cursor = await self._db.execute(sql, params)
281
423
  rows = await cursor.fetchall()
282
424
  return [dict(row) for row in rows]
283
425
 
284
- async def query_failover_stats(
285
- self, days: int = 7, include_model_info: bool = False
426
+ async def query_daily(
427
+ self,
428
+ days: int | None = 7,
429
+ vendor: str | None = None,
430
+ model: str | None = None,
286
431
  ) -> list[dict]:
432
+ """按日聚合 Token 使用统计.
433
+
434
+ Args:
435
+ days: 查询天数。``None`` 表示不限时间(全量查询)。
436
+ vendor: 过滤供应商。
437
+ model: 过滤请求模型。
287
438
  """
288
- 按 failover_from → vendor 聚合故障转移次数.
439
+ # days=None → count=0 → _period_start_iso 返回 None → 不限时间
440
+ count = 0 if days is None else days
441
+ return await self.query_usage(
442
+ period=TimePeriod.DAY, count=count, vendor=vendor, model=model
443
+ )
444
+
445
+ async def query_failover_stats(
446
+ self, days: int | None = 7, include_model_info: bool = False
447
+ ) -> list[dict]:
448
+ """按 failover_from → vendor 聚合故障转移次数.
289
449
 
290
450
  Args:
291
- days: 查询天数
451
+ days: 查询天数。``None`` 表示不限时间(全量查询)。
292
452
  include_model_info: 是否在聚合中包含模型信息
293
453
  - False: 按 (failover_from, vendor) 聚合 (默认,向后兼容)
294
454
  - True: 按 (failover_from, vendor, model_requested, model_served) 聚合
295
455
  """
296
456
  if not self._db:
297
457
  return []
298
- days = max(1, days)
299
- start_iso = _days_start_utc_iso(days)
458
+
459
+ time_clause = ""
460
+ params: list = []
461
+ if days is not None:
462
+ days = max(1, days)
463
+ start_iso = _days_start_utc_iso(days)
464
+ time_clause = " AND ts >= ?"
465
+ params.append(start_iso)
300
466
 
301
467
  if include_model_info:
302
- sql = """SELECT failover_from, vendor, model_requested, model_served,
468
+ sql = f"""SELECT failover_from, vendor, model_requested, model_served,
303
469
  COUNT(*) AS count
304
470
  FROM usage_log
305
- WHERE failover = 1 AND ts >= ?
471
+ WHERE failover = 1{time_clause}
306
472
  GROUP BY failover_from, vendor, model_requested, model_served
307
473
  ORDER BY count DESC"""
308
474
  else:
309
- # 保持原有的聚合逻辑确保向后兼容
310
- sql = """SELECT failover_from, vendor,
475
+ sql = f"""SELECT failover_from, vendor,
311
476
  COUNT(*) AS count
312
477
  FROM usage_log
313
- WHERE failover = 1 AND ts >= ?
478
+ WHERE failover = 1{time_clause}
314
479
  GROUP BY failover_from, vendor
315
480
  ORDER BY count DESC"""
316
481
 
317
- cursor = await self._db.execute(sql, [start_iso])
482
+ cursor = await self._db.execute(sql, params)
318
483
  rows = await cursor.fetchall()
319
484
  return [dict(row) for row in rows]
320
485
 
@@ -2,17 +2,65 @@
2
2
 
3
3
  from __future__ import annotations
4
4
 
5
+ from datetime import datetime, timedelta
5
6
  from typing import TYPE_CHECKING
6
7
 
7
8
  from rich.console import Console
8
9
  from rich.table import Table
9
10
 
10
- from .db import TokenLogger
11
+ from .db import TimePeriod, TokenLogger
11
12
 
12
13
  if TYPE_CHECKING:
13
14
  from ..pricing import PricingTable
14
15
 
15
16
 
17
+ # ── 时间维度 → 表格标题 ──────────────────────────────────────
18
+
19
+ _PERIOD_TITLES: dict[TimePeriod, str] = {
20
+ TimePeriod.DAY: "日",
21
+ TimePeriod.WEEK: "周",
22
+ TimePeriod.MONTH: "月",
23
+ TimePeriod.TOTAL: "全部",
24
+ }
25
+
26
+
27
+ def _week_date_range(count: int) -> str:
28
+ """计算最近第 count 周的周一~周日日期范围字符串.
29
+
30
+ count=1 表示本周,count=2 表示上周,以此类推。
31
+
32
+ Returns:
33
+ 格式为 ``YYYY-MM-DD ~ YYYY-MM-DD`` 的日期范围字符串。
34
+ """
35
+ today = datetime.now().date()
36
+ # 本周周一
37
+ this_monday = today - timedelta(days=today.weekday())
38
+ # 目标周的周一
39
+ target_monday = this_monday - timedelta(weeks=count - 1)
40
+ target_sunday = target_monday + timedelta(days=6)
41
+ return (
42
+ f"{target_monday.strftime('%Y-%m-%d')} ~ {target_sunday.strftime('%Y-%m-%d')}"
43
+ )
44
+
45
+
46
+ def _build_title(period: TimePeriod, count: int) -> str:
47
+ """根据时间维度构建表格标题.
48
+
49
+ WEEK 维度会附加具体日期范围(如 ``2026-04-07 ~ 2026-04-13``),
50
+ 其他维度仅显示统计周期标签。
51
+ """
52
+ if period is TimePeriod.TOTAL:
53
+ return "Token 使用统计(全部)"
54
+ label = _PERIOD_TITLES[period]
55
+ base = f"Token 使用统计(最近 {count} {label}"
56
+ if period is TimePeriod.WEEK:
57
+ base += f":{_week_date_range(count)}"
58
+ return base + ")"
59
+
60
+
61
+ # ── 格式化工具 ───────────────────────────────────────────────
62
+
63
+
16
64
  def _format_model_display(model_value: str | None) -> str:
17
65
  """格式化模型显示,处理 None 或空值."""
18
66
  if not model_value or model_value.strip() == "":
@@ -31,37 +79,41 @@ def _format_tokens(n: int) -> str:
31
79
  return str(n)
32
80
 
33
81
 
34
- def _detect_model_variants(failover_stats: list[dict]) -> bool:
35
- """检测是否存在模型差异,用于决定是否建议详细模式."""
36
- if not failover_stats or "model_requested" not in failover_stats[0]:
37
- return False
82
+ # ── 日期列名 ─────────────────────────────────────────────────
83
+
84
+ _PERIOD_DATE_LABELS: dict[TimePeriod, str] = {
85
+ TimePeriod.DAY: "日期",
86
+ TimePeriod.WEEK: "周",
87
+ TimePeriod.MONTH: "月",
88
+ TimePeriod.TOTAL: "维度",
89
+ }
38
90
 
39
- # 计算唯一的模型对
40
- model_pairs = {
41
- (stat.get("model_requested", ""), stat.get("model_served", ""))
42
- for stat in failover_stats
43
- }
44
- # 检查是否存在模型映射(请求模型与实际模型不同)
45
- return any(pair[0] != pair[1] for pair in model_pairs if pair[0] and pair[1])
91
+
92
+ # ── 主展示函数 ───────────────────────────────────────────────
46
93
 
47
94
 
48
95
  async def show_usage(
49
96
  logger: TokenLogger,
50
- days: int = 7,
97
+ *,
51
98
  vendor: str | None = None,
52
99
  model: str | None = None,
53
100
  pricing_table: PricingTable | None = None,
101
+ period: TimePeriod = TimePeriod.DAY,
102
+ count: int = 7,
54
103
  ) -> None:
55
104
  """展示 Token 使用统计."""
56
105
  console = Console()
57
- rows = await logger.query_daily(days=days, vendor=vendor, model=model)
106
+ rows = await logger.query_usage(
107
+ period=period, count=count, vendor=vendor, model=model
108
+ )
58
109
 
59
110
  if not rows:
60
111
  console.print("[yellow]暂无使用记录[/yellow]")
61
112
  return
62
113
 
63
- table = Table(title=f"Token 使用统计(最近 {days} 天)")
64
- table.add_column("日期", style="cyan")
114
+ table = Table(title=_build_title(period, count))
115
+ date_label = _PERIOD_DATE_LABELS[period]
116
+ table.add_column(date_label, style="cyan")
65
117
  table.add_column("供应商", style="green")
66
118
  table.add_column("请求模型", style="magenta")
67
119
  table.add_column("实际模型", style="yellow")
@@ -98,8 +150,9 @@ async def show_usage(
98
150
  else:
99
151
  cost_str = "-"
100
152
 
153
+ date_value = row.get("date") or ""
101
154
  table.add_row(
102
- str(row.get("date", "")),
155
+ str(date_value),
103
156
  vendor_name,
104
157
  _format_model_display(row.get("model_requested")),
105
158
  model_served,
@@ -115,8 +168,9 @@ async def show_usage(
115
168
 
116
169
  console.print(table)
117
170
 
118
- # 故障转移来源汇总
119
- failover_stats = await logger.query_failover_stats(days=days)
171
+ # 故障转移来源汇总(使用与主查询相同的时间范围)
172
+ failover_days = _period_to_days(period, count)
173
+ failover_stats = await logger.query_failover_stats(days=failover_days)
120
174
  if failover_stats:
121
175
  console.print()
122
176
  ft_table = Table(title="故障转移来源明细")
@@ -126,6 +180,21 @@ async def show_usage(
126
180
  for stat in failover_stats:
127
181
  source = stat.get("failover_from") or "unknown"
128
182
  target = stat.get("vendor", "")
129
- count = stat.get("count", 0)
130
- ft_table.add_row(source, target, str(count))
183
+ count_val = stat.get("count", 0)
184
+ ft_table.add_row(source, target, str(count_val))
131
185
  console.print(ft_table)
186
+
187
+
188
+ def _period_to_days(period: TimePeriod, count: int) -> int | None:
189
+ """将 TimePeriod + count 近似转换为天数(供 query_failover_stats 使用).
190
+
191
+ Returns:
192
+ 天数,或 ``None`` 表示全量查询。
193
+ """
194
+ if period is TimePeriod.TOTAL:
195
+ return None
196
+ if period is TimePeriod.MONTH:
197
+ return count * 31 # 粗略近似,保证覆盖范围
198
+ if period is TimePeriod.WEEK:
199
+ return count * 7
200
+ return max(1, count) # DAY