Repository navigation
v3.4.0
🎉 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-pickerdaterange 双月份溢出 / 透明 / 宽度 bug 的定点豁免,沿用 Element Plus 主题变量) - 修复用量曲线首次进入堆积左侧:ECharts 在
display:none容器上初始化宽度为 0,用ResizeObserver监听容器尺寸变化,面板显隐切换时自动 resize
- 后端在所有代理路径(Anthropic / OpenAI Chat / Responses 原生与转换、流式与非流式)的成功与失败分支埋点,按四个时间维度 UPSERT 聚合到新表
-
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 端点的提供商被错误转发,已在无映射兜底与命中映射两处补传
- API Key 安全加固:DB 中
-
锁定 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 变量保持恒暗主题一致
- 登录卡片底部以分隔线区分,展示 GitHub 源码地址链接(带 Link 图标,新标签页打开),下方文案引导用户点 Star 支持项目;图标用
-
Header 增加在线使用说明入口
🚀 快速开始
-
下载
VibeCodingProxy-v3.4.0.exe,放到任意目录(建议新建一个空文件夹,数据库文件会生成在同目录)。 -
如需自定义端口或管理员,在同目录新建
proxy.ini:[server] port = 5000 [admin] username = admin password = admin123 [security] # 可选:自定义 API Key 加密盐值(强烈建议首次部署即设置) # salt = your-custom-salt-here
-
双击运行,弹出的控制台窗口会显示各端点地址。
-
浏览器打开 **http://localhost:5000**(端口随
proxy.ini变化),首次启动会自动初始化数据库并创建管理员账号。 -
在 Web 界面配置上游提供商、模型映射、API Key 即可开始转发;新建提供商时可从「内置预设」下拉一键填充地址;需要查看用量时打开「用量统计」面板按小时 / 天 / 周 / 月查看。
-
(可选)让 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导入种子数据。
- v10:新增
- 升级后行为变化(重要):
- 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 不可达时降级为灰色静态版本号,不影响使用。
- API Key 已加密存储:升级时存量明文 api_key 会被自动加密,转发行为零变化;若随后在
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。