Skip to content

4.0.0

Latest

Choose a tag to compare

@sky-unicorn sky-unicorn released this 31 Aug 05:24
· 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,不再回退默认提供商
    • 防止调用方使用上游真实模型名绕过模型映射、负载均衡、禁用状态和路由治理
  • 模型映射支持隐藏禁用提供商模型

    • 「其他设置」新增「隐藏禁用提供商模型」开关,默认关闭
    • 开启后只影响模型映射列表展示,不改变实际路由行为
    • 空状态会区分「没有映射」与「映射全部因提供商禁用而隐藏」
  • 内置提供商预设每次启动幂等同步

    • providers.csv 新增预设会在升级后自动写入 provider_presets
    • 已存在同名预设只刷新排序,不覆盖用户修改过的 URL、完整路径开关等配置
    • 本版本新增「火山方舟AP」内置预设
  • DeepSeek thinking 参数改为透传

    • 移除过时的 thinking 剔除逻辑,匹配 DeepSeek Anthropic 端点当前支持情况
    • 保留 budget_tokens → output_config.effort 映射:>=10000 映射为 max,其余映射为 high
    • 原有 metadata.user_id 规范化与空 thinking 块兼容逻辑保持不变

🚀 快速开始

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

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

    [server]
    port = 5000
    
    [admin]
    username = admin
    password = admin123
    
    [security]
    # 可选:自定义 API Key 加密盐值(强烈建议首次部署即设置)
    # salt = your-custom-salt-here
  3. 双击运行,浏览器打开 **http://localhost:5000**(端口随 proxy.ini 变化)。

  4. 在 Web 界面配置上游提供商、模型映射和 API Key。请求中的 model 必须使用已启用的映射别名。

  5. 需要切换配色时,使用页面顶部主题菜单选择预设或打开自定义调色板。

⚠️ 升级说明(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。