Repository navigation
·
7 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
🎉 Vibe Coding 服务转发 v4.0.0
基于 Flask 的多供应商 AI API 代理服务,把多家上游 LLM 统一抽象成 Anthropic Messages API、OpenAI Chat Completions API、OpenAI Responses API 三种接口对外暴露,并配套可视化 Web 管理界面。延续 Windows 免安装 exe 双击即运行的形态。
本版本在 v3.9.0 基础上完成「界面主题系统」「路由边界收紧」与「配置维护体验」三项升级:
- 新增完整主题系统:提供 6 套暗色主题、2 套亮色主题和自定义调色板;主题写入数据库并即时切换,登录页与管理页首屏均由服务端注入配色,刷新无白屏闪烁。Element Plus 和原有业务样式统一通过 CSS 变量随主题切换。
- 严格模型别名路由:Anthropic、OpenAI Chat Completions、OpenAI Responses 三类入口都要求请求模型命中已启用的别名;未映射模型直接返回 404,不再把目标模型名原样发送到默认提供商。这是 v4.0.0 的主要行为边界变化。
- 配置维护更清晰:模型映射页可选择隐藏已禁用提供商的模型;内置提供商预设改为每次启动从
providers.csv幂等同步,版本新增预设可自动进入数据库,同时保留用户对同名预设的 URL 和开关修改。 - DeepSeek 适配更新:Anthropic
thinking参数改为原样透传,继续将budget_tokens映射为output_config.effort,兼顾上游当前能力与思考强度控制。
📦 下载
| 文件 | 说明 |
|---|---|
VibeCodingProxy-v4.0.0.exe |
Windows 64 位免安装单文件,双击运行(带应用图标) |
- 大小:约 20 MB
- SHA-256:
75F8FD94B8C6470ED9C7966BBAD77AACBCC82F12030D62EF43C61E6E70C2E241 - 系统要求:Windows 10 / 11(64 位),无需预装 Python 或任何依赖
✨ 本版本更新(v3.9.0 → v4.0.0)
-
新增 8 套亮暗主题与自定义配色
- 内置 6 套暗色主题:午夜靛蓝、翠林墨玉、碧海天青、暮霞琥珀、玫红蔷薇、石墨冷灰
- 内置 2 套亮色主题:晨曦白、米暖白
- 顶部主题菜单支持即时切换;自定义配色可调整背景、卡片、边框、文字、主色和功能色
- 主题持久化到
settings.ui_theme/settings.ui_theme_custom,重启后保持不变 - 亮色主题使用独立预览色,避免浅色圆点难以辨认或强调色造成误导
-
统一页面与 Element Plus 主题变量
- 新增主色、成功色、警告色、危险色、背景色和文字色的 RGB 派生变量,半透明 hover、提示块、滚动条等样式均能跟随主题
- 亮暗主题自动设置
color-scheme,浏览器原生控件同步切换 - 服务端在管理页和登录页
<head>注入当前主题变量,消除首次渲染闪烁 - 自定义主题接口使用变量白名单、严格 hex 校验和注入字符过滤,防止存储型 CSS/HTML 注入
-
严格模型别名路由
- Anthropic
/anthropic/*、OpenAI Chat/v1/*、OpenAI Responses/openai/*入口统一按已启用别名路由 - 未命中别名时直接返回 404,不再回退默认提供商
- 防止调用方使用上游真实模型名绕过模型映射、负载均衡、禁用状态和路由治理
- Anthropic
-
模型映射支持隐藏禁用提供商模型
- 「其他设置」新增「隐藏禁用提供商模型」开关,默认关闭
- 开启后只影响模型映射列表展示,不改变实际路由行为
- 空状态会区分「没有映射」与「映射全部因提供商禁用而隐藏」
-
内置提供商预设每次启动幂等同步
providers.csv新增预设会在升级后自动写入provider_presets- 已存在同名预设只刷新排序,不覆盖用户修改过的 URL、完整路径开关等配置
- 本版本新增「火山方舟AP」内置预设
-
DeepSeek thinking 参数改为透传
- 移除过时的
thinking剔除逻辑,匹配 DeepSeek Anthropic 端点当前支持情况 - 保留
budget_tokens→output_config.effort映射:>=10000映射为max,其余映射为high - 原有
metadata.user_id规范化与空 thinking 块兼容逻辑保持不变
- 移除过时的
🚀 快速开始
-
下载
VibeCodingProxy-v4.0.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。请求中的
model必须使用已启用的映射别名。 -
需要切换配色时,使用页面顶部主题菜单选择预设或打开自定义调色板。
⚠️ 升级说明(v3.9.0 → v4.0.0)
- 升级方式:把旧版本同目录的
proxy.db复制到新 exe 同目录,即可保留提供商、模型映射、API Key、日志、计费、用量和界面设置。 - 数据库结构:本版本 schema 仍为 v23,没有新增、删除或修改表结构,因此不会执行新的版本迁移。
- 重要行为变化——取消未映射模型直连:如果客户端此前直接传上游真实模型名、且没有配置同名别名,升级后会收到 404。请先在「模型映射」中创建并启用对应别名,再升级生产流量。
- 内置预设同步变化:内置的
providers.csv现在每次启动都会同步到预设表。已存在同名项的用户配置不会被覆盖;从预设表删除的内置项会在下次启动时恢复,但不会自动创建或修改正式 provider。 - 主题设置:首次升级默认继续使用午夜靛蓝主题;主题切换仅新增 settings 数据,不影响业务表。
- DeepSeek 行为变化:
thinking不再被代理剔除,而是发送给上游。若使用不支持该参数的自定义兼容端点,请在调用方关闭 thinking 或单独配置适配策略。 proxy.ini仍是可选文件;管理员账号 / 密码以该文件为准,修改后重启会覆盖库中已有管理员。
📝 本版本变更清单(v3.9.0..v4.0.0)
| 类型 | 变更 |
|---|---|
| ✨ 特性 | 新增 6 套暗色 + 2 套亮色主题,以及自定义调色板与持久化切换 |
| 🎨 UI | Element Plus 与业务样式统一映射主题变量,亮暗模式完整适配 |
| 🎨 UI | 主题首屏 SSR 注入消除刷新闪烁,登录页同步继承当前主题 |
| 🔒 安全 | 自定义主题变量白名单、hex 校验与 CSS 注入纵深过滤 |
| 🔒 行为变更 | 三类协议入口收紧为严格别名路由,未映射模型统一返回 404 |
| ✨ 特性 | 模型映射新增「隐藏禁用提供商模型」开关 |
| 🔧 配置 | providers.csv 改为每次启动幂等同步,并新增「火山方舟AP」预设 |
| 🔧 适配 | DeepSeek Anthropic 端点改为透传 thinking,保留 effort 映射 |
| 🗃️ 数据库 | schema 维持 v23,无新增结构迁移 |
源码与完整文档见仓库 README.md。