Skip to content

v3.4.0

Choose a tag to compare

@sky-unicorn sky-unicorn released this 30 Jul 06:17
· 31 commits to main since this release
Immutable release. Only release title and notes can be modified.

🎉 Vibe Coding 服务转发 v3.4.0

基于 Flask 的多供应商 AI API 代理服务,把多家上游 LLM 统一抽象成 Anthropic Messages API、OpenAI Chat Completions API、OpenAI Responses API 三种接口对外暴露,并配套可视化 Web 管理界面。延续 Windows 免安装 exe 双击即运行的形态。

本版本在 v3.0.0 基础上集中补齐了「可观测性」与「安全 / 易用性」两条线:新增用量统计面板(按小时 / 天 / 周 / 月四粒度统计请求与 token 用量,ECharts 折线图 + 明细表格),providers 表 api_key 改为加盐加密存储(盐值可配置、转发时解密还原),并支持为每个提供商显式配置 OpenAI Responses 端点、把对应的 Codex 四开关锁定为原生透传。为降低配置门槛新增内置提供商地址预设,选中即可一键填充三个 URL 路径与完整路径开关。日志侧新增 target_url 列记录真实转发上游 URL,排查转发路径不再只能看 provider 名。同时修复了启动时 database is locked 导致自动清理失效、局域网 IP 访问时复制按钮静默失效等问题。

📦 下载

文件 说明
VibeCodingProxy-v3.4.0.exe Windows 64 位免安装单文件,双击运行(带应用图标)
  • 大小:约 16 MB
  • 系统要求:Windows 10 / 11(64 位),无需预装 Python 或任何依赖

✨ 本版本更新(v3.0.0 → v3.4.0)

  • 新增用量统计面板(按小时 / 天 / 周 / 月粒度统计)

    • 后端在所有代理路径(Anthropic / OpenAI Chat / Responses 原生与转换、流式与非流式)的成功与失败分支埋点,按四个时间维度 UPSERT 聚合到新表 usage_stats;新增四条只读 API(汇总、时间序列、provider 列表、model 列表),缺失零值桶;保留策略独立于日志清理开关,分批删除避免长时间持锁
    • 前端新增 Vue 岛屿面板:汇总卡片、provider/model 筛选、ECharts 折线图与 provider×model 明细表格;ECharts 已本地化到 static/lib 保证离线可用
    • 用量曲线 X 轴按日期粒度自适应显示:跨天 hour 序列在日界输出 MM-DD 作为日期分隔、仅保留日界与午间刻度避免重叠;自定义日期范围阈值放宽到 7 天(≤7 天用 hour、>7 天用 day)
    • 配套自写日期范围选择器组件(规避 el-date-picker daterange 双月份溢出 / 透明 / 宽度 bug 的定点豁免,沿用 Element Plus 主题变量)
    • 修复用量曲线首次进入堆积左侧:ECharts 在 display:none 容器上初始化宽度为 0,用 ResizeObserver 监听容器尺寸变化,面板显隐切换时自动 resize
  • API Key 加密存储 + Responses 端点配置

    • API Key 安全加固:DB 中 api_key 改为加盐加密存储(HMAC-SHA256 计数器密钥流 + XOR + ENC1: 前缀,纯标准库实现以兼容 PyInstaller spec 对 cryptography/bcrypt 的排除),转发时解密还原;proxy.ini 新增 [security] salt 段支持自定义盐值,未配置则回落内置默认盐值
    • 创建提供商时 api_key 必填(前端 el-form 规则 + 后端 400 双保险);提供商列表移除 API Key 列(改为 has_api_key 布尔脱敏),模型映射查询不再回吐明文
    • Responses 端点配置:providers 新增 responses_url 列,CRUD / 列表 / 新增 / 编辑全链路支持;_openai_responses_url 优先用显式 responses_url,留空则按 openai_url 自动派生 /responses(向后兼容)
    • 修复原生 Responses 透传时 responses_url 未透传端点:候选 provider 字典此前只复制了 openai_url,导致配置了独立 Responses 端点的提供商被错误转发,已在无映射兜底与命中映射两处补传
  • 锁定 Responses URL 提供商下模型映射的 Codex 四开关

    • 提供商配置非空 responses_url 即表示其上游原生支持 Responses 协议,该提供商下所有模型映射应走原生透传,Codex 四开关语义唯一确定、禁止修改:reasoning_effort_supported=0 / think_injection=0 / reasoning_content_field=0 / native_responses=1
    • 三层保障:DB 真值层(增改映射 / 编辑切换 provider 时强制锁定)+ 数据修正(一次性迁移修正历史数据)+ 前端展示(四开关 disabled 并 el-alert 提示锁定原因)
  • 新增内置提供商地址预设并支持表单一键填充

    • 新增 provider_presets 只读模板表(与 providers 独立),从 providers.csv 一次性导入种子数据(UTF-8 优先、GBK 回退,文件缺失时表为空不阻塞启动)
    • 提供商表单顶部新增 el-select 内置预设选择器,选中即可一键填充名称、三个 URL 路径与完整路径开关,用户仅需补全 API Key、并发、计费等信息即可保存为正式 provider
  • 日志新增转发目标 URL 记录与展示

    • logs 表新增 target_url 列,记录请求转发的真实上游 URL(含 full_path=0 时的后缀拼接、Responses 端点派生等),19 处 add_log 调用点全部传入真实 URL;新增 _openai_chat_url / _anthropic_messages_url 辅助函数统一 URL 构造点
    • 详情弹窗顶部新增蓝色 info 提示条展示目标 URL,沿用 Element Plus 恒暗主题 CSS 变量
  • Responses URL 受完整路径开关约束

    • _openai_responses_url 的端点派生逻辑与提供商的 full_path 开关对齐,确保显式 / 派生两条路径下转发目标一致
  • 修复启动时 database is locked 导致自动清理失效

    • 启动时 _cleanup_thread 与 _startup_vacuum_thread 两条写线程同时起跑,cleanup_old_logs 撞上 VACUUM 的 EXCLUSIVE 锁、异常被吞掉,导致过期日志未被清理、last_cleanup_time 不更新
    • get_conn 增加 busy_timeout / synchronous=NORMAL,锁冲突改为排队等待;cleanup_old_logs 改为分批删除避免长事务持锁;移除独立启动 VACUUM 线程,首次 VACUUM 交由清理循环第一轮承担
  • 修复非安全上下文下复制按钮失效

    • navigator.clipboard.writeText 仅在安全上下文(localhost / https)下可用,打包成 exe 后通过局域网 IP 访问时该 API 不可用、复制静默失败
    • 为端点 URL 与 API Key 三处复制点统一增加 execCommand('copy') 的 textarea 兜底,优先用 clipboard API、不可用时自动降级,确保任何访问方式下复制功能均正常
  • 登录页新增源码地址与 Star 提示

    • 登录卡片底部以分隔线区分,展示 GitHub 源码地址链接(带 Link 图标,新标签页打开),下方文案引导用户点 Star 支持项目;图标用 vertical-align 对齐文字避免错位,沿用登录页既有 CSS 变量保持恒暗主题一致
  • Header 增加在线使用说明入口

🚀 快速开始

  1. 下载 VibeCodingProxy-v3.4.0.exe,放到任意目录(建议新建一个空文件夹,数据库文件会生成在同目录)。

  2. 如需自定义端口或管理员,在同目录新建 proxy.ini:

    [server]
    port = 5000
    
    [admin]
    username = admin
    password = admin123
    
    [security]
    # 可选:自定义 API Key 加密盐值(强烈建议首次部署即设置)
    # salt = your-custom-salt-here
  3. 双击运行,弹出的控制台窗口会显示各端点地址。

  4. 浏览器打开 **http://localhost:5000**(端口随 proxy.ini 变化),首次启动会自动初始化数据库并创建管理员账号。

  5. 在 Web 界面配置上游提供商、模型映射、API Key 即可开始转发;新建提供商时可从「内置预设」下拉一键填充地址;需要查看用量时打开「用量统计」面板按小时 / 天 / 周 / 月查看。

  6. (可选)让 Claude Code / Codex 等 MCP 客户端接入 Nacos 管理:在客户端配置 /mcp 端点 URL 与本服务 API Key,并通过 X-Nacos-* headers 携带目标 Nacos 集群连接参数(详见 MCP 广场面板的配置示例)。

⚠️ 升级说明(v3.0.0 → v3.4.0)

  • 从任意旧版本 exe 升级:把旧版本同目录的 proxy.db 复制到新 exe 同目录,即可保留历史数据。
  • 从 v3.0.0 升级:库已在 v9,首次启动 v3.4.0 会从 v9 依次升到 v10 → … → v18,全部幂等执行、平滑迁移、不丢其余数据:
    • v10:新增 usage_stats 表,按小时 / 天 / 周 / 月粒度记录用量统计;
    • v11:usage_stats 新增覆盖索引 idx_usage_stats_period_model,优化时间序列查询;
    • v12:usage_stats 新增 success_count / failure_count 列,记录请求成败统计;
    • v13:回填 usage_stats 历史 success / failure 数据;
    • v14:加密 providers.api_key(盐值可配置,转发时解密还原)——存量明文 api_key 自动加密;
    • v15:providers 表新增 responses_url 列,显式配置 OpenAI Responses 端点;
    • v16:锁定 responses_url 提供商下 mapping 的 Codex 四开关(reasoning / think / reasoning_field 关、native_responses 开);
    • v17:logs 表新增 target_url 列,记录请求转发的真实上游 URL;
    • v18:新增 provider_presets 表,存储内置提供商地址预设并从 providers.csv 导入种子数据。
  • 升级后行为变化(重要):
    • API Key 已加密存储:升级时存量明文 api_key 会被自动加密,转发行为零变化;若随后在 proxy.ini 修改了盐值,已加密的 API Key 将无法解密,需在 Web UI 重新填写所有提供商的 API Key。使用内置默认盐值时,任何拿到 DB + 源码的人都能解密全部 api_key(加密退化为混淆),强烈建议首次部署即设置自定义盐值。
    • Responses URL 端点:提供商可留空 responses_url(按 openai_url 自动派生 /responses,与旧版行为一致),也可显式填写独立端点;配置了非空 responses_url 的提供商,其下模型映射的 Codex 四开关会被自动锁定为原生透传取值、不可修改。
    • 新增「用量统计」面板与「内置预设」下拉;其余原有功能(提供商 / 模型映射 / API Key / 错误码 / 计费 / 日志 / 降级 / MCP 广场)均保留,配置数据互通。
    • 标题旁版本徽章仍会访问 GitHub API 检查最新版;断网或 GitHub 不可达时降级为灰色静态版本号,不影响使用。
  • proxy.ini 是可选文件;管理员账号 / 密码以该文件为准,修改后重启会覆盖库中已有管理员,日常改密请直接编辑该文件。providers.csv 为内置预设种子源,位于 exe 同目录,缺失时内置预设为空、不影响启动。

📝 本版本变更清单(v3.0.0..v3.4.0)

类型 变更
✨ 特性 新增用量统计面板:后端全代理路径埋点 UPSERT 到 usage_stats,四条只读 API;前端 Vue 岛屿汇总卡片 + ECharts 折线图 + provider×model 明细表格,ECharts 本地化保证离线可用
✨ 特性 用量曲线 X 轴按日期粒度自适应(跨天 hour 序列日界输出 MM-DD、自定义范围阈值放宽到 7 天);自写日期范围选择器组件(规避 el-date-picker daterange bug)
✨ 特性 API Key 加密存储:providers.api_key 加盐加密(HMAC-SHA256 密钥流 + XOR + ENC1: 前缀,纯标准库),proxy.ini 新增 [security] salt 段;创建必填、列表脱敏、查询不回吐明文
✨ 特性 提供商新增 responses_url 列,显式配置 OpenAI Responses 端点(留空自动派生 /responses,向后兼容);CRUD / 列表 / 新增 / 编辑全链路支持
✨ 特性 锁定 Responses URL 提供商下模型映射的 Codex 四开关(DB 真值层 + 数据修正 + 前端 disabled 三层保障)
✨ 特性 新增内置提供商地址预设:provider_presets 表从 providers.csv 导入种子,表单顶部 el-select 一键填充三个 URL 路径与完整路径开关
✨ 特性 日志新增 target_url 列记录转发真实上游 URL,19 处调用点传入,详情弹窗顶部 info 提示条展示;新增 _openai_chat_url / _anthropic_messages_url 辅助函数统一 URL 构造
✨ 特性 Header 增加在线使用说明入口
🐛 修复 启动时 database is locked 导致自动清理失效:get_conn 加 busy_timeout / synchronous=NORMAL,清理改分批删除,移除独立启动 VACUUM 线程
🐛 修复 非安全上下文(局域网 IP 访问 exe)下复制按钮失效:三处复制点增加 execCommand('copy') textarea 兜底降级
🐛 修复 用量曲线首次进入堆积左侧:ECharts 在 display:none 容器宽度为 0,用 ResizeObserver 自动 resize
🐛 修复 原生 Responses 透传时 responses_url 未透传端点,导致配置独立 Responses 端点的提供商被错误转发
🎨 UI 登录页新增 GitHub 源码地址链接与 Star 提示(带 Link 图标、新标签页打开、沿用恒暗主题变量)
🔧 架构 数据库 schema 升级到 v18:v10 建 usage_stats 表;v11 加覆盖索引;v12 加 success/failure 列;v13 回填历史;v14 加密 api_key;v15 加 responses_url;v16 锁定 Codex 四开关;v17 加 logs.target_url;v18 建 provider_presets 表 + CSV 种子

源码与完整文档见仓库 README.md。