Merge pull request #140 from ThreeFish-AI/feature/1.x.x

v0.2.0

Author: ThreeFish-AI

CHANGELOG.md

@@ -4,6 +4,25 @@
 
 ## [Unreleased]
 
+## [v0.2.0](https://github.com/ThreeFish-AI/coding-proxy/releases/tag/v0.2.0) — 2026-04-09
+
+> [!IMPORTANT]
+>
+> **🚀 供应商大扩军 × 用量仪表盘全面进化，双线暴击！**
+>
+> 卡在一家供应商的限额天花板下抬不起头？现在你手握 **九条命**——新增 MiniMax、小米 MiMo、阿里千问、Kimi、豆包五路援军，全部原生讲 Anthropic 话，无缝接入 N-tier。 Token 烧到哪儿心里没数？新版 `usage` 命令解锁日/周/月/全量四档视角，多供应商并排比，汇总行一行看全局。**备用仓更满，账单更透，从此宕机只是别人家的故事。**
+
+### ✨ 核心亮点
+
+- **5 家供应商集体入场**：MiniMax、小米 MiMo、阿里千问、Kimi、豆包（火山引擎）正式入编 N-tier。备用通道数量直接翻倍，不怕堵；
+- **`usage` 命令全面升级**：从"只有天数"进化为**日 / 周 / 月 / 全量**四档时间维度（`-d 7` / `-w` / `-m` / `-t`）。支持多值过滤——`-v anthropic,kimi` 或 `--model claude-opus-4-6,glm-5.1` 用逗号隔开随便选。表格末行自动追加**汇总行**，请求总量、Token 总计、总成本、加权平均延迟四项一览无余。Token 花在哪家、烧了多少、谁最能扛——这张表给你答案；
+
+### 🔧 更多特性
+
+- **品牌横幅正式上线**：`proxy start` 启动时打印 Coding Proxy 专属 ASCII Banner 与版本号，告别冷冰冰的裸日志起手式；
+- **529 过载纳入降级触发**：HTTP `529 overloaded_error` 正式加入故障转移白名单，Anthropic 喊"我堵了"时 Proxy 不再干等；
+- **Zhipu 跨供应商级联故障根治**：`Internal Network Failure` 纳入 500 降级条件；`tool_result` 角色错位导致的下游级联崩溃彻底斩断，再也不因历史 message 的"历史遗留问题"把整条链拖下水；
+
 ## [v0.1.3](https://github.com/ThreeFish-AI/coding-proxy/releases/tag/v0.1.3) — 2026-04-07
 
 > [!IMPORTANT]

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "coding-proxy"
-version = "0.1.3"
+version = "0.2.0"
 description = "A High-Availability, Transparent, and Smart Multi-Vendor Proxy for Claude Code. Support Claude Plans, GitHub Copilot, Google Antigravity, ZAI/GLM."
 readme = "README.md"
 requires-python = ">=3.12"

src/coding/proxy/cli/__init__.py

@@ -8,7 +8,7 @@
 import asyncio
 import logging
 from pathlib import Path
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING
 
 import typer
 
@@ -18,7 +18,7 @@
 from rich.console import Console
 
 from ..config.loader import load_config
-from ..logging.db import TokenLogger
+from ..logging.db import TimePeriod, TokenLogger
 from ..logging.stats import show_usage
 from .auth_commands import app as auth_app
 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):
     return cfg, store
 
 
+def _resolve_period(
+    *,
+    days: int = 7,
+    week: int | None = None,
+    month: int | None = None,
+    total: bool = False,
+) -> tuple[TimePeriod, int]:
+    """将互斥的时间维度标志解析为 (TimePeriod, count) 元组.
+
+    优先级: ``-t`` > ``-m`` > ``-w`` > ``-d``。
+
+    Returns:
+        ``(period, count)`` 元组。``count`` 表示查询最近第 N 个周期的数据。
+    """
+    if total:
+        return TimePeriod.TOTAL, 1
+    if month is not None:
+        return TimePeriod.MONTH, max(1, month)
+    if week is not None:
+        return TimePeriod.WEEK, max(1, week)
+    return TimePeriod.DAY, max(1, days)
+
+
 # ── 主命令 ─────────────────────────────────────────────────────
 
 
@@ -61,6 +84,7 @@ def start(
     import uvicorn
 
     from ..server.app import create_app
+    from .banner import print_banner
 
     cfg_path = _resolve_config_path(config)
     cfg = load_config(cfg_path)
@@ -76,6 +100,10 @@ def start(
     from ..logging import build_log_config
 
     fastapi_app = create_app(cfg)
+
+    # 打印启动品牌横幅
+    print_banner(console, host=cfg.server.host, port=cfg.server.port)
+
     uvicorn.run(
         fastapi_app,
         host=cfg.server.host,
@@ -113,29 +141,68 @@ def status(
 
 @app.command()
 def usage(
-    days: int = typer.Option(7, "--days", "-d", help="统计天数"),
+    days: int = typer.Option(7, "--days", "-d", help="统计天数（与 -w/-m/-t 互斥）"),
+    week: int | None = typer.Option(
+        None, "--week", "-w", help="最近第 N 周统计（按周聚合，默认 1）"
+    ),
+    month: int | None = typer.Option(
+        None, "--month", "-m", help="最近第 N 月统计（按月聚合，默认 1）"
+    ),
+    total: bool = typer.Option(False, "--total", "-t", help="统计全部历史记录"),
     vendor: str | None = typer.Option(None, "--vendor", "-v", help="过滤供应商"),
-    model: str | None = typer.Option(None, "--model", "-m", help="过滤请求模型"),
+    model: str | None = typer.Option(
+        None, "--model", help="过滤实际服务模型（model_served），逗号分隔可指定多个"
+    ),
     db_path: str | None = typer.Option(None, "--db", help="数据库路径"),
 ) -> None:
-    """查看 Token 使用统计."""
+    """查看 Token 使用统计.
+
+    时间维度（互斥，优先级 -t > -m > -w > -d）：
+
+      \b
+      -d 7         最近 7 天（默认，按日聚合）
+      -w [N]       最近第 N 周（按周聚合，默认 1＝本周）
+      -m [N]       最近第 N 月（按月聚合，默认 1＝本月）
+      -t           全部历史（按供应商+模型聚合）
+    """
+    period, count = _resolve_period(days=days, week=week, month=month, total=total)
     cfg = load_config(Path(db_path) if db_path else None)
     token_logger = TokenLogger(cfg.db_path)
-    asyncio.run(_run_usage(token_logger, days, vendor, model, cfg))
+    # 解析逗号分隔的多 vendor（如 "anthropic,zhipu" → ["anthropic", "zhipu"]）
+    vendor_filter: str | list[str] | None = None
+    if vendor:
+        parts = [v.strip() for v in vendor.split(",") if v.strip()]
+        vendor_filter = parts[0] if len(parts) == 1 else parts
+    # 解析逗号分隔的多 model（如 "glm-5,glm-5.1" → ["glm-5", "glm-5.1"]）
+    model_filter: str | list[str] | None = None
+    if model:
+        parts = [m.strip() for m in model.split(",") if m.strip()]
+        model_filter = parts[0] if len(parts) == 1 else parts
+    asyncio.run(
+        _run_usage(token_logger, period, count, vendor_filter, model_filter, cfg)
+    )
 
 
 async def _run_usage(
     token_logger: TokenLogger,
-    days: int,
-    vendor: str | None,
-    model: str | None,
+    period: TimePeriod,
+    count: int,
+    vendor: str | list[str] | None,
+    model: str | list[str] | None,
     cfg: ProxyConfig,
 ) -> None:
     from ..pricing import PricingTable
 
     await token_logger.init()
     pricing_table = PricingTable(cfg.pricing)
-    await show_usage(token_logger, days, vendor, model, pricing_table)
+    await show_usage(
+        token_logger,
+        vendor=vendor,
+        model=model,
+        pricing_table=pricing_table,
+        period=period,
+        count=count,
+    )
     await token_logger.close()
 
 

src/coding/proxy/cli/banner.py

@@ -0,0 +1,61 @@
+"""CLI 启动品牌横幅.
+
+使用 Rich Panel 构建紧凑的品牌展示面板，
+在服务启动前向终端输出版本与监听地址信息。
+
+设计原则:
+- 正交分解: 展示逻辑独立于业务逻辑
+- 复用驱动: 使用项目已有的 Rich Console 模式
+- 最小干预: 无新依赖，纯组合现有组件
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from rich.panel import Panel
+from rich.text import Text
+
+if TYPE_CHECKING:
+    from rich.console import Console
+
+from .. import __version__
+
+
+def build_banner(host: str = "127.0.0.1", port: int = 8046) -> Panel:
+    """构建品牌横幅 Panel.
+
+    Args:
+        host: 监听地址.
+        port: 监听端口.
+
+    Returns:
+        配置完成的 Rich Panel 实例.
+    """
+    brand_text = Text()
+    brand_text.append("⚡ ", style="bold")
+    brand_text.append("Coding Proxy", style="bold cyan")
+    brand_text.append("\n\n")
+
+    info_text = Text()
+    info_text.append("Version: ", style="dim")
+    info_text.append(__version__, style="green")
+    info_text.append("  │  ", style="dim")
+    info_text.append("Listening: ", style="dim")
+    info_text.append(f"http://{host}:{port}", style="blue")
+    brand_text.append(info_text)
+
+    return Panel(brand_text, border_style="cyan", padding=(1, 2), expand=False)
+
+
+def print_banner(console: Console, host: str = "127.0.0.1", port: int = 8046) -> None:
+    """通过指定 Console 打印品牌横幅.
+
+    Args:
+        console: Rich Console 实例（复用 CLI 层已有实例）.
+        host: 监听地址.
+        port: 监听端口.
+    """
+    console.print()
+    console.print(build_banner(host=host, port=port))
+    console.print()