What's New

CDN Cache Busting

• Add version suffix (-v7.6.0) to all frontend chunk filenames
• Forces HF Space CDN to fetch new files instead of using cached old versions
• Fixes 'Failed to fetch dynamically imported module' error

Route Fixes

• Fix route ordering: specific routes now mounted before catch-all proxy
• Fix API error handling: return empty array instead of 500 when GitHub API fails
• Fix dashboard data loading: repos now fetched via /api/github/repos API
• Fix trending repos 'loading...' stuck issue

Version Updates

• Bump version from 7.5.0 to 7.6.0 across all files
• Update vite.config.js, config.py, version.js, Dockerfile
• Rebuild frontend with new version suffix

Stats

• 88 tests passing
• 195 API endpoints
• 10 router modules
• 30 MCP tools

重大变更

• 移除 app.py 桥接层 — 运行时不再依赖 6450 行的单体文件
• 195 个 API 路径 分布在 10 个独立路由模块中

新增模块

架构

backend/
├── main.py # 应用入口 (无桥接层)
├── config.py # Pydantic Settings
├── routers/
│ ├── github_repos.py # 仓库相关 API
│ ├── github_actions.py # Actions API
│ ├── github_misc.py # 杂项 API
│ ├── github_proxy.py # Catch-all 代理
│ ├── mcp.py # MCP 协议
│ ├── webhooks.py # Webhook 接收
│ ├── sync.py # 数据同步
│ ├── system.py # 系统管理
│ └── deploy.py # HF 部署
├── core/
│ ├── events.py # 事件总线
│ ├── cache_v2.py # LRU 缓存
│ ├── audit.py # 审计日志
│ └── shared_state.py # 共享状态
├── mcp_tools/ # MCP 工具集
└── clients/ # GitHub HTTP 客户端

测试

• 65 个单元测试全部通过
• 服务启动验证通过

v7.4.0 - 模块化架构重构

🎯 核心变更

Phase 1: 模块化架构基础

• 创建 backend/ 模块化目录结构 (8 个子模块)
• Pydantic Settings 配置管理
• 异步 GitHubClient (httpx AsyncClient, 连接池, 自动分页)
• AppError 统一错误处理体系 (8 种异常类型)
• 中间件独立模块 (auth / rate_limit / cache)
• SQLite 数据库连接管理 (WAL 模式)
• FastAPI lifespan 生命周期管理

Phase 2: MCP 服务重构

• BaseTool 抽象基类 + ToolParameter + ToolResult
• ToolRegistry 注册表 (register/call/list_tools)
• 30 个 MCP 工具从 if-elif 链迁移到独立类
  • 21 个 GitHub 工具 / 3 个 HF 工具 / 1 个 Shell 工具
  • 1 个 Proxy 工具 (SSRF 防护) / 2 个 Project 工具 / 2 个 Config 工具
• Shell 安全策略 (白名单 + 黑名单)

Phase 3: 路由桥接层

• 路由注册器从 app.py 桥接 247 个 API 路由
• 所有端点路径和参数完全兼容

Phase 4: 基础设施升级

• 异步事件总线 (pub/sub, 通配符, 12 种事件类型)
• LRU 缓存 (TTL 过期, 线程安全, 命中率统计)
• 审计日志 (环形缓冲区, 过滤查询)
• MCP 工具调用自动记录事件和审计日志

Phase 5: 前端优化

• 4 个通用 Hook (useFetch/useDebounce/useLocalStorage/useToggle)
• Vite 代码分割 (react/markdown/diff/charts 独立 chunk)

部署管理整合

• deploy_tool.py 核心逻辑迁移到 backend/services/
• 8 个部署 API 端点 (单部署/批量/状态/历史/Space 监控)

📊 影响范围

• 涉及文件: 42 files changed
• 新增代码: 3841+
• 删除代码: 35-

✅ 兼容性

• API 端点: 完全兼容 (247 个端点零中断)
• MCP 协议: 完全兼容 (30 个工具)
• 前端: 完全兼容
• 环境变量: 新增 pydantic-settings 依赖

🧪 测试

• 单元测试: 65/65 passed

📦 部署

docker pull ghcr.io/arwei944/github-mirror:v7.4.0
docker run -d -p 7860:7860 ghcr.io/arwei944/github-mirror:v7.4.0

🚀 What's New

MCP Streamable HTTP 传输支持

新增 Streamable HTTP 传输协议端点,兼容 SOLO、Claude Desktop 等新版 MCP 客户端。

• ✅ POST /mcp — Streamable HTTP 端点(推荐)
• ✅ GET /mcp — 客户端探测端点(返回 405)
• ✅ GET /mcp/sse/message — SSE 探测端点(返回 405)
• ♻️ 提取公共 JSON-RPC 处理函数 _handle_mcp_jsonrpc()
• 📝 更新 README 双传输协议文档

Bug Fixes

• 修复 SOLO 客户端连接 MCP 服务器时 HTTP 405 Method Not Allowed 错误
• 修复 Streamable HTTP 客户端探测请求导致的初始化失败

MCP 客户端配置

{
 "mcpServers": {
 "github-mirror": {
 "url": "https://arwei944-github-mirror.hf.space/mcp"
 }
 }
}

Full Changelog: v6.4.0...v6.5.0