Skip to content

Releases

4.0.0

Choose a tag to compare

@sky-unicorn sky-unicorn released this 31 Aug 05:24
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。

v3.9.0

Choose a tag to compare

@sky-unicorn sky-unicorn released this 07 Aug 00:57
Immutable release. Only release title and notes can be modified.

🎉 Vibe Coding 服务转发 v3.9.0

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

本版本在 v3.4.0 基础上主攻「MCP 生态扩展」「用量可观测性」与「运行时稳定性」三条线:

  • MCP 能力显著扩展:新增视觉理解 MCP(支持本地图片路径的 npx stdio 桥 + 独立的 /mcp/vision 端点,复用多模态转发能力,可做图片描述 / OCR / 图表解读 / UI 分析);新增网页读取 MCP(/mcp/webreader 端点抓取远程网页返回结构化内容——标题、元数据、标题大纲、正文 markdown、链接列表,内置 SSRF 防护拒绝内网/回环地址)。同时把 MCP 端点按工具集拆分隔离:/mcp/nacos3、/mcp/vision、/mcp/webreader 各管各的工具,互不干扰,Nacos MCP 仍由客户端经 X-Nacos-* headers 携带连接参数、服务端零落盘。Nacos MCP 调用现已接入 logs 表审计,9 个工具的增删改查操作全部留痕可查。视觉理解与网页读取 MCP 卡片增加**「测试」状态标签**,提示用户其尚在验证阶段。
  • 用量可观测性升级:用量统计新增 API Key 维度,可按客户端 Key 查看各 Key 的请求量与 token 消耗占比;新增 MCP 工具视图,按 source_model(Nacos MCP / 网页读取 MCP / 视觉理解 MCP)聚合调用次数、成败、耗时趋势与明细,视觉理解 MCP 可展开查看 token 用量。前端改为左侧 el-tabs 双视图(供应商×模型 / MCP 工具),API Key 作为两视图共用筛选维度。后端新增 mcp_usage_stats 永久聚合表,MCP 用量不再受日志保留期限制。
  • 运行时稳定性加固:新增跨平台单实例锁,禁止程序重复多开(已有一个实例时新实例直接退出);启动前检测端口占用,端口被占则启动失败并给出明确提示,避免静默假死 / 端口错乱。
  • 配置易用性:降级配置支持按模型别名覆盖(字段级继承全局,别名可单独覆盖降级策略);模型映射新增别名一键复制;「其他设置」新增图优先多模态全局开关,统一控制多模态请求的图片优先策略。
  • 数据关联优化:logs 表改用 provider_id 关联(而非 provider 名称),根治提供商改名后历史日志割裂的问题;新增 api_key_id 列,记录请求使用的客户端 API Key,支持按 Key 统计与审计。

📦 下载

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

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

  • 新增视觉理解 MCP(/mcp/vision)

    • 复用多模态转发能力,新增独立 /mcp/vision 端点,暴露 vision_describe 工具:输入一张或多张图片(本地文件路径或 data URL)+ 任务指令,返回文字描述;内置描述 / OCR / 图表解读 / UI 分析等任务模式,支持 max_tokens 控制回复长度
    • 新增轻量 npx 本地 stdio 桥:让 MCP 客户端通过 stdio 方式接入,桥接受本地图片文件路径、绕开 base64 过滤,图片不经过主模型上下文;桥源码以自托管 tarball 形式打进 exe,经 /npm/install/vision 端点发布,客户端 npx <本地tarball> 即可拉起
    • 修复打包成 exe 后 /npm/install/vision 端点 404:frozen 分支改用 sys._MEIPASS 定位 npm 资源目录,彻底解决免安装版视觉桥取不到源码的问题
    • 补全视觉 MCP 失败日志记录与参数 schema 约束,调用失败在日志中留痕可排查
  • 新增网页读取 MCP(/mcp/webreader)

    • 新增 /mcp/webreader 端点,暴露 webreader_read 工具:抓取指定 URL 网页返回结构化内容(标题、元数据、标题大纲、正文 markdown/纯文本、链接列表)
    • 典型场景:API 文档读取与摘要、开源项目页面解析、技术文章提取、BUG 参考文档抓取、知识库构建与同步
    • 内置 SSRF 防护:URL 解析到私有 / 回环地址会被直接拒绝,防止被当作内网探测跳板;支持 return_format / retain_images / with_links_summary / timeout 等参数
  • MCP 端点拆分独立隔离工具集

    • /mcp/nacos3 与 /mcp/vision(及新增的 /mcp/webreader)拆分为互相独立的工具集,各端点只暴露各自工具、互不干扰,避免工具名冲突与权限放大
    • Nacos MCP 连接参数仍由 MCP 客户端经 X-Nacos-* headers 携带、服务端零落盘,版本保持 2.0.0
  • Nacos MCP 调用接入 logs 表审计

    • Nacos MCP 的 9 个工具(增删改查命名空间/配置)原为日志盲区,现已补齐:nacos_client._request 出口统一记一条 MCP 日志(成功/失败都记),字段映射与 webreader_client 一致(source_model='Nacos MCP'、target_url=真实上游 URL、request_body=操作摘要、response_body=结果摘要),未来新增工具自动被覆盖,无需逐个 handler 改
    • 前端 logs.js 的 isMcpSource() 已预留 Nacos MCP 判定值,后端写入后日志页自动显示 MCP 标签;连接参数(账号密码)仍零落盘,仅 client_ip 与操作元数据入库
  • MCP 广场卡片增加「测试」状态标签

    • 视觉理解 MCP 与网页读取 MCP 卡片右上角新增 warning「测试」标签,提示用户这两项功能尚在验证阶段;稳定的 Nacos MCP 不加
  • 用量统计新增 API Key 维度

    • logs 表新增 api_key_id 列,记录请求使用的客户端 API Key id(0 表示未知/历史数据);_check_api_key 校验后把 key id 注入 flask.g.api_key_id,沿 client_ip 通道经 proxy / nacos_client / vision_client / webreader_client 透传到 add_log / record_usage_stats
    • usage_stats 唯一约束扩展为 UNIQUE(provider_id, model, period_type, period_start, api_key_id),同一 provider×model×period 按不同 Key 拆行,聚合查询 SUM 仍正确
    • 前端用量统计新增 API Key 下拉筛选,可按 Key 查看各 Key 的请求量与 token 消耗占比
  • 用量统计新增 MCP 工具视图

    • 新增 mcp_usage_stats 永久聚合表,按 source_model(Nacos MCP / 网页读取 MCP / 视觉理解 MCP)× 周期聚合调用次数、成败、总耗时;视觉理解 MCP 额外记录 input/output/cache token,不再依赖 logs 表(不受日志保留期限制)
    • 前端用量统计改为左侧 el-tabs 双视图:「供应商×模型」与「MCP 工具」;MCP 视图展示调用/成败/耗时趋势与明细,视觉理解 MCP 可展开查看 token
    • 新增 API 端点:/api/usage/api-keys(Key 列表)、/api/usage/mcp/stats(MCP 汇总)、/api/usage/mcp/timeseries(MCP 时间序列)
  • 跨平台单实例锁,禁止程序多开

    • 新增跨平台单实例锁:同一时间只允许一个实例运行,重复启动的新实例检测到已有实例后直接退出,避免多个实例争抢端口 / 写同一 proxy.db 造成数据损坏
  • 启动前检测端口占用

    • 启动时先检测目标端口是否已被占用,被占用则启动失败并给出明确提示,不再静默假死或绑定到错误端口
  • 降级配置支持按模型别名覆盖

    • 降级配置(fallback)新增按模型别名单独覆盖的能力,字段级继承全局配置:别名可单独指定不同的降级策略,未覆盖的字段回落全局默认
  • 模型映射别名一键复制

    • 模型映射列表为别名新增一键复制按钮,复制映射别名到剪贴板,方便在降级配置 / 其他场景中引用
  • 新增「图优先」多模态全局开关

    • 「其他设置」面板新增图优先多模态全局开关,统一控制多模态请求的图片优先策略,一处开关全局生效
  • logs 改用 provider_id 关联,根治改名后历史日志割裂

    • logs 表新增 provider_id 列,按提供商 id 关联而非名称,提供商改名后历史日志仍归并在同一提供商下,不再割裂成两段

🚀 快速开始

  1. 下载 VibeCodingProxy-v3.9.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 即可开始转发;需要用量时打开「用量统计」面板按小时 / 天 / 周 / 月查看,可按 API Key 或 MCP 工具维度筛选。

  6. (可选)让 Claude Code / Codex 等 MCP 客户端接入:

    • Nacos 管理:配置 /mcp/nacos3 端点 URL 与本服务 API Key,并通过 X-Nacos-* headers 携带目标 Nacos 集群连接参数;
    • 视觉理解:用 npx 本地 stdio 桥接入 /mcp/vision,或直接调用 HTTP 端点传本地图片路径;
    • 网页读取:调用 /mcp/webreader 端点传入目标 URL 即可抓取网页。
      (详见 MCP 广场面板的配置示例)

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

  • 从任意旧版本 exe 升级:把旧版本同目录的 proxy.db 复制到新 exe 同目录,即可保留历史数据。
  • 从 v3.4.0 升级:库已在 v18,首次启动 v3.9.0 会从 v18 依次升到 v19 → … → v23,全部幂等执行、平滑迁移、不丢其余数据:
    • v19:logs 表新增 provider_id 列,按提供商 id 关联,根治改名后历史日志割裂;
    • v20:logs 表新增 api_key_id 列,记录请求使用的客户端 API Key id,支持按 Key 统计;
    • v21:usage_stats 表新增 api_key_id 列,唯一约束加入 api_key_id 维度,支持按 Key 统计;
    • v22:新增 mcp_usage_stats 表,按 source_model×周期 聚合 MCP 调用次数/成败/耗时;
    • v23:mcp_usage_stats 新增 token 列,视觉理解 MCP 的 token 改为永久记录(不再读日志)。
  • 从 v3.0.0 或更旧版本升级:库会在启动时从旧版本依次升到 v18 再到 v23,全部迁移幂等、平滑执行。
  • 升级后行为变化(重要):
    • MCP 端点拆分:/mcp/nacos3、/mcp/vision、/mcp/webreader 拆分为独立工具集。原统一 /mcp 端点若配置了 Nacos 客户端,请改指向 /mcp/nacos3;视觉与网页读取分别对应各自端点 / npx 桥。
    • Nacos MCP 审计:Nacos MCP 调用现已写入 logs 表,日志页可按 MCP 标签筛选查看;连接参数(账号密码)仍零落盘,仅 client_ip 与操作元数据入库。
    • 单实例锁:同一机器同一时间只允许运行一个实例,重复启动的新实例会直接退出(旧实例不受影响)。
    • 端口占用检测:若目标端口已被其他程序占用,新实例启动会失败并提示,请先释放端口或修改 proxy.ini 中的端口。
    • 用量统计新增维度:用量统计面板新增 API Key 筛选与 MCP 工具视图,可按 Key 查看用量占比、按 MCP 工具查看调用趋势与 token 消耗。
    • logs 关联方式:logs 表存量日志迁移到 provider_id 关联后,提供商改名不再导致历史日志割裂;旧日志按名称无法匹配到 provider_id 的会保留原样。新增 api_key_id 列后,历史数据回填为 0(未知 Key),新请求自动记录。
    • 其余原有功能(提供商 / 模型映射 / API Key / 错误码 / 计费 / 日志 / 降级 / 用量统计 / MCP 广场)均保留,配置数据互通。
    • 标题旁版本徽章仍会访问 GitHub API 检查最新版;断网或 GitHub 不可达时降级为灰色静态版本号,不影响使用。
  • proxy.ini 是可选文件;管理员账号 / 密码以该文件为准,修改后重启会覆盖库中已有管理员,日常改密请直接编辑该文件。providers.csv 为内置预设种子源,位于 exe 同目录,缺失时内置预设为空、不影响启动。

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

类型 变更
✨ 特性 新增视觉理解 MCP:独立 /mcp/vision 端点暴露 vision_describe 工具(本地图片路径 / data URL + 任务指令 → 文字描述,支持描述 / OCR / 图表解读 / UI 分析 + max_tokens)
✨ 特性 视觉 MCP 新增轻量 npx 本地 stdio 桥(接受本地文件路径绕开 base64 过滤,图片不经过主模型上下文);源码自托管 tarball 打进 exe 经 /npm/install/vision 发布
🐛 修复 打包 exe 后 /npm/install/vision 端点 404:frozen 分支改用 sys._MEIPASS 定位 npm 资源目录
✨ 特性 新增网页读取 MCP:/mcp/webreader 端点暴露 webreader_read 工具,抓取 URL 返回标题 / 元数据 / 标题大纲 / 正文 markdown / 链接列表,内置 SSRF 防护拒绝内网 / 回环地址
✨ 特性 MCP 端点拆分独立隔离工具集:/mcp/nacos3、/mcp/vision、/mcp/webreader 各管各的工具互不干扰
✨ 特性 Nacos MCP 调用接入 logs 表审计:_request 出口统一记 MCP 日志(成功/失败),未来新增工具自动覆盖
🎨 UI MCP 广场卡片增加「测试」状态标签(视觉理解与网页读取 MCP)
✨ 特性 用量统计新增 API Key 维度:logs / usage_stats 新增 api_key_id 列,前端新增 Key 下拉筛选
✨ 特性 用量统计新增 MCP 工具视图:mcp_usage_stats 永久聚合表,前端左侧 el-tabs 双视图(供应商×模型 / MCP 工具),视觉理解 MCP 可展开查看 token
✨ 特性 新增跨平台单实例锁,禁止程序重复多开(新实例检测到已有实例直接退出)
✨ 特性 启动前检测端口占用,被占用则启动失败并给出明确提示
✨ 特性 降级配置支持按模型别名覆盖(字段级继承全局,未覆盖字段回落全局默认)
✨ 特性 模型映射别名一键复制按钮
✨ 特性 「其他设置」新增「图优先」多模态全局开关
✨ 特性 logs 表改用 provider_id 关联,根治提供商改名后历史日志割裂
🔧 架构 数据库 schema 升级到 v23:v19 加 logs.provider_id;v20 加 logs.api_key_id;v21 加 usage_stats.api_key_id + 重建索引;v22 建 mcp_usage_stats 表;v23 加 mcp_usage_stats token 四列

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

v3.4.0

Choose a tag to compare

@sky-unicorn sky-unicorn released this 30 Jul 06:17
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。

v3.0.0

Choose a tag to compare

@sky-unicorn sky-unicorn released this 24 Jul 02:35
Immutable release. Only release title and notes can be modified.

🎉 Vibe Coding 服务转发 v3.0.0

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

主版本号升至 3.0.0:本轮完成两件大事——其一,把沿用原生 HTML/JS 的整套前端彻底重构为 Vue 3 + Element Plus 的组件化岛屿架构(API Key / 错误码映射 / 提供商 / 模型映射 / 计费 / 请求日志 / MCP 广场 / 公共外壳 / 登录页九大模块全部迁移收尾),交互一致性、暗色主题、可访问性全面对齐现代组件库;其二,移除 OAuth 整套认证代码与数据库表(攻击面归零),把对外鉴权收敛回单一 API Key 机制。此外新增可远程管理 Nacos 3.x 的 MCP Server,并把转发重试次数 / 间隔做成可配置项。

📦 下载

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

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

  • 前端全面迁移至 Vue 3 + Element Plus

    • 引入 Vue 3(全局构建版)+ Element Plus + Element Plus Icons + 暗色主题样式,按「面板 = Vue 岛屿」的方式逐模块重构,所有面板共享一套 globalProperties 工具函数与全局桥接
    • 完成九大模块的迁移收尾:API Key 面板 → 错误码映射 → 提供商管理 → 模型映射 → 计费管理 + 请求日志 → MCP 广场 / 公共外壳 / 登录页;templates/index.html 从臃肿的单体模板瘦身,废弃的原生按钮 / 弹窗 / 开关 / 分页 / badge 等 CSS / JS 全部清理
    • 公共外壳迁移为 Vue 岛屿:el-tag 版本徽章三态(🆕 有新版 / ✓ 已是最新 / 灰色降级)+ el-tabs 路由替换原生 switchTab,URL hash 双向同步,_suppressReload 标志避免初始化双倍请求且保持激活态视觉同步;showFeatureToast 退役,统一用 ElMessage / ElNotification
    • 提供商启用 / 停用、刷新等操作的 toast 提示统一改用 ElMessage
    • 视觉与交互一致性显著提升:暗色主题统一、表单校验与加载态对齐组件库、响应式布局更稳健
  • 移除 OAuth 整套代码,攻击面归零

    • 删除 oauth.py(-276 行)及 OAuth 相关的 oauth_clients / oauth_codes / oauth_tokens 三张数据库表,对外鉴权收敛回单一的 API Key 机制,认证攻击面与维护负担降到最低
    • 配套 schema 迁移:v7 → v8(先给 oauth_tokens.access_token 加命名唯一索引,堵 alg=none JWT 伪造认证绕过)、v8 → v9(删除三张 OAuth 表),幂等执行,老库平滑迁移不丢其余数据
  • 新增 Nacos MCP Server(9 工具,零新依赖)

    • 让 Claude Code / Codex 等 AI 客户端通过 MCP 协议(Streamable HTTP) 远程管理 Nacos 3.x 的命名空间与配置,/mcp 路由嵌入 Flask 单进程,复用现有 API Key 鉴权,手写 JSON-RPC 2.0,零新第三方依赖
    • 工具共 9 个(nacos_ 前缀):命名空间 list / create / update / delete;配置 list / get / publish / delete / get_history
    • 连接参数设计(关键决策):Nacos 的 console_url / auth_url / 账号 / 密码不在本项目配置,而是由 MCP 客户端在 X-Nacos-Console-Url / X-Nacos-Auth-Url / X-Nacos-Username / X-Nacos-Password 四个 HTTP headers 携带,服务端按请求读取、零落盘。任意 Nacos 集群都能接入、不锁定地址,且天然支持多实例;accessToken 按 (console_url, username) 做进程级缓存
    • 前端 MCP / Nacos 面板改为纯展示:端点 URL、API Key、客户端 headers 配置示例(Claude Code / Codex)、9 工具清单;更新 Nacos 3.x 授权地址样例
  • 转发重试次数与间隔改为可配置

    • 原本硬编码的「最多重试 3 次、间隔 1 秒」做成降级设置里可调的配置项(degradation_retry_count 默认 3 / degradation_retry_delay 默认 1.0 秒),便于按上游稳定性灵活调优
    • _post_with_retry 默认参数改为 None,运行时动态从降级配置读取,UI 改完无需重启即时生效,所有转发路径零改动;对非法负值自动兜底回退默认值;全新库与老库均补默认种子值
  • 修复关闭命令行窗口后进程残留问题

    • 之前关闭 exe 弹出的控制台窗口,后台 Flask 进程可能残留继续占用端口。本次修复关闭窗口即干净退出
  • MCP 广场布局优化

    • Tab 改为卡片式布局;默认收起并改为面板内滚动,避免长内容撑开整个页面
  • 请求日志面板详情优化

    • 优化详情展示与 SSE 解析;日志详情改为点击时按需查询(而非一次性拉全量);详情弹窗增高并随视口自适应

🚀 快速开始

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

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

    [server]
    port = 5000
    
    [admin]
    username = admin
    password = admin123
  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 广场面板的配置示例)。

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

  • 从任意旧版本 exe 升级:把旧版本同目录的 proxy.db 复制到新 exe 同目录,即可保留历史数据。
  • 从 v2.0.0 升级:库已在 v7,首次启动 v3.0.0 会从 v7 依次升到 v8 → v9:
    • v7 → v8:给 oauth_tokens.access_token 加命名唯一索引(堵 alg=none JWT 伪造认证绕过);
    • v8 → v9:删除 OAuth 相关三张表(oauth_clients / oauth_codes / oauth_tokens),攻击面归零;
    • OAuth 表被删除是预期行为——本版本起 OAuth 认证代码已整套移除,对外鉴权统一为 API Key,相关历史表无实际用途;
    • 其余历史映射 / 设置 / 日志字段不变、不丢失。
  • 升级后新增的降级配置项:degradation_retry_count(默认 3)与 degradation_retry_delay(默认 1.0 秒)会由迁移与种子值自动补上,默认值与旧版硬编码行为(重试 3 次 / 间隔 1 秒)完全一致,升级后转发重试行为零变化;需要调优时在降级设置弹窗修改,改完即时生效。
  • 升级后行为变化(重要):
    • 前端整体换肤为 Vue 3 + Element Plus,外观与交互方式有较大变化,但所有原有功能(提供商 / 模型映射 / API Key / 错误码 / 计费 / 日志 / 降级 / MCP 广场)均保留,配置数据互通。
    • OAuth 认证入口已移除,若旧版本曾依赖 OAuth 登录,请改用 API Key 或内置管理员账号登录。
    • 标题旁版本徽章仍会访问 GitHub API 检查最新版;断网或 GitHub 不可达时降级为灰色静态版本号,不影响使用。
  • proxy.ini 是可选文件;管理员账号 / 密码以该文件为准,修改后重启会覆盖库中已有管理员,日常改密请直接编辑该文件。

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

类型 变更
✨ 特性 前端全面迁移至 Vue 3 + Element Plus:九大模块(API Key / 错误码 / 提供商 / 模型映射 / 计费 / 日志 / MCP 广场 / 公共外壳 / 登录页)组件化重构收尾,暗色主题与交互一致性对齐组件库
✨ 特性 新增 Nacos MCP Server:/mcp 嵌入 Flask,9 个 nacos_ 工具远程管理 Nacos 3.x 命名空间与配置,连接参数经客户端 X-Nacos-* headers 携带、零落盘、零新依赖
✨ 特性 转发重试次数 / 间隔可配置(degradation_retry_count 默认 3 / degradation_retry_delay 默认 1.0),UI 改完即时生效,默认值与旧版一致
🔒 安全 移除 OAuth 整套代码(oauth.py -276 行)与三张 OAuth 表,对外鉴权收敛回单一 API Key,攻击面归零
🐛 修复 关闭命令行窗口后后台进程残留占用端口的问题
🎨 UI MCP 广场改卡片式布局、默认收起并面板内滚动;请求日志详情优化 SSE 解析、改为点击按需查询、详情弹窗增高自适应;提供商启停提示统一用 ElMessage
🔧 架构 数据库 schema 升级到 v9:v8 给 oauth_tokens.access_token 加命名唯一索引;v9 删除 OAuth 三张表;新增 degradation_retry_count / degradation_retry_delay 降级配置项(迁移 + 种子值幂等补全)

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

v2.0.0

Choose a tag to compare

@sky-unicorn sky-unicorn released this 20 Jul 08:58
Immutable release. Only release title and notes can be modified.

🎉 Vibe Coding 服务转发 v2.0.0

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

主版本号升至 2.0.0:本轮在降级调度、供应商生命周期管理、版本自检三个核心维度补齐了「主备语义」与「可运维性」,从「能转发」走向「能稳定运维」;并对 provider 禁用 → mapping 联动这条链路做了前后端 + 历史数据三层闭环,彻底消除「mapping 显示启用却实际无效」的假启用状态。

📦 下载

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

✨ 本版本更新(v1.2.2 → v2.0.0)

  • 新增严格优先级(逐级下放)模型选择模式

    • 原降级机制为全池加权轮询,低优先级模型仍按概率被选中,「主备」语义不成立。新增 degradation_strict_priority 辅助开关(依赖主降级开关):开启后仅在当前最高优先级层级内选择候选,整层降级才逐级下放到更低优先级层,全部层级降级则回退全量池(不拒服务)
    • 纯加法改动,默认关闭:关闭时 Anthropic / OpenAI Chat / Codex Responses 三条转发路径的过滤行为与改动前逐字节等价(走原 _filter_candidates_by_degradation 分支);层内选择沿用 _pick_weighted_round_robin,降级状态管理与 duration 复用现有机制
  • provider 启停级联同步其下映射模型状态(含假启用闭环)

    • provider 停用时其下所有 model_mappings 联动停用,启用时联动启用,避免上游已下线却仍把请求路由过去
    • 为避免覆盖用户单独禁用的 mapping,新增 model_mappings.disable_reason 列(与 providers 表对齐),区分手动禁用(manual)与因 provider 禁用而联动禁用(provider_disabled)。启用 provider 时只恢复联动禁用的 mapping,保留用户手动禁用的状态
    • v6 schema 迁移:model_mappings 新增 disable_reason 列,历史禁用一律回填 manual;手动启停与计费恢复两处入口均触发级联,同一事务保证原子性
    • 前端 toggleProvider 切换后同步刷新模型列表,并弹出 2 秒自动关闭的 toast 提示
    • 前后端闭环「假启用」:原级联机制虽会在 provider 禁用时同步把 mapping 置为 disabled,但前端 toggle 仍可点击、后端不拦截,造成 mapping「显示启用却因路由层 p.enabled=1 过滤而实际无效」的假启用状态。本次闭环该语义——get_model_mappings 返回 provider_enabled 字段;update_model_mapping 在所属 provider 禁用时拒绝开启(抛 ValueError,禁用操作不受影响),/api/models/<id> 捕获后返回 400 + 错误信息;前端列表 toggle 按 provider_enabled 灰色锁定并加 tooltip,编辑弹窗联动锁定「启用」开关,操作失败弹 toast 提示原因
  • 修正历史假启用 mapping(v7 数据迁移)

    • v6 引入 disable_reason 列之前,provider 禁用并不会级联到 mapping(当时无级联机制),老库迁移到 v6 时的回填只看 mapping 自身的 enabled、未参考 provider 状态,导致「provider 已禁用但 mapping enabled=1 / disable_reason=''」的历史假启用残留:UI 显示启用却因路由层 p.enabled=1 过滤而实际无效
    • 新增 v6 → v7 数据修正迁移,把这些 mapping 改写为 enabled=0 + disable_reason='provider_disabled',与运行时级联禁用语义对齐。幂等:以 settings 标记键做一次性守卫,UPDATE 仅命中不一致行,手动禁用(manual)与 provider 启用的 mapping 不受影响
  • 新增版本号徽章,自动检测 GitHub 最新版

    • 新建 version.py 作为应用版本号唯一来源(APP_VERSION / RELEASES_URL / GITHUB_LATEST_API)
    • 标题旁版本徽章三种态:🆕 有新版本(橙色,可点击跳转 releases)/ ✓ 已是最新版(绿色)/ v2.0.0(灰色,断网降级);⟳ 按钮手动强制检查
    • /api/version 端点:拉取 GitHub releases/latest 对比版本号,settings 表缓存 1 小时(403 限流时 24 小时),threading.Lock 防并发重复请求,3s 超时保证 UI 不卡,force=1 参数绕过缓存强制刷新
  • 刷新页面保持当前 Tab 页

    • 之前每次 F5 刷新都会回到首个 Tab(提供商管理)。现在通过 URL hash 记录当前 Tab:切换时用 history.replaceState 写入 #<tab>,初始化时从 hash 恢复。用 replaceState 而非 pushState,避免切 Tab 污染浏览器历史
  • 优化模型映射列表与角色映射弹窗 UI

    • 模型映射列表「状态」「降级状态」两列互换位置
    • 角色映射弹窗美化:提示信息改为左侧紫色强调边框的提示卡、code 标签用主色高亮;每条规则独立卡片包裹、hover 边框泛紫、输入框加聚焦态;箭头改紫色、删除按钮固定 28×28 居中;新增空状态提示(删完规则显示「暂无映射规则」占位);「+ 添加规则」改为与输入框同宽的虚线按钮、hover 变紫
  • 优化模型映射 max_tokens 字段说明文案

    • 表头与编辑窗 label 由 max_tokens 改为中文「最大输出 Token 数」;描述明确:仅当上游有上限且调用方传入超限报错时才需配置(以 kimi-2.7 上限 32768、调用方传 64000 报错为例)
  • 修复 codex 正常请求被日志详情框误显示为错误

    • codex 经 Responses 流式代理的正常请求(exit=normal),日志详情框一直弹红色「错误:」块造成误判。根因两层:
      1. finally 调 resp.close() 后,后台读取线程的 iter_lines 因 resp.raw 被置空抛 AttributeError,被 _upstream_reader 捕获后写入 upstream_error_type,正常请求被误报 upstream_err。仅在 exit_reason==normal(主动关闭的预期异常)时清空 upstream_error_type
      2. 流式诊断串 [exit=...] 即便 status=success 也被写入 DB 的 error_msg 字段,Web UI 只要 error_msg 非空就以红色「错误:」块渲染。收紧为仅 status=error 时写入 error_msg,诊断串始终 print 到控制台保留排障能力
    • 不影响降级判定(其条件 status==error 本就不在成功路径触发)
  • 新增程序图标 ICON_PROMPT.png

    • 打包出的 exe 与任务栏图标使用该图,视觉识别更清晰

🚀 快速开始

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

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

    [server]
    port = 5000
    
    [admin]
    username = admin
    password = admin123
  3. 双击运行,弹出的控制台窗口会显示各端点地址。

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

  5. 在 Web 界面配置上游提供商、模型映射、API Key 即可开始转发;需要「主备」语义时在设置里开启「严格优先级(逐级下放)」开关;停用 provider 后其下映射模型会自动联动停用。

⚠️ 升级说明(v1.2.2 → v2.0.0)

  • 从 v1.0.0 / v1.1.1 / v1.2.0 / v1.2.1 / v1.2.2 的 exe 升级:把旧版本同目录的 proxy.db 复制到新 exe 同目录,即可保留历史数据。
  • 从 v1.2.2 升级:库已在 v5,首次启动 v2.0.0 会从 v5 依次升到 v6 → v7:
    • v5 → v6:model_mappings 新增 disable_reason 列,历史禁用一律回填 manual;
    • v6 → v7:数据修正迁移,把「provider 已禁用但 mapping enabled=1」的历史假启用残留改写为 enabled=0 + disable_reason='provider_disabled',使其与运行时级联禁用语义对齐。
    • 其余历史映射字段不变、不丢失。
  • 升级后行为变化(重要):
    • 严格优先级模式 默认关闭,升级后转发行为与旧版逐字节等价;需要「主备」语义时手动在设置开启。
    • provider 停用后其下映射模型会 自动联动停用(标为 provider_disabled);重新启用 provider 时,仅恢复因 provider 停用而联动的禁用,保留用户手动禁用的状态——不会误启你单独关掉的 mapping。
    • provider 处于禁用状态时,其下映射模型的「启用」开关在前端灰色锁定、后端拒绝开启,避免再产生假启用;v7 迁移会一次性清掉历史库里已存在的假启用残留。
    • 标题旁新增版本徽章,会访问 GitHub API 检查最新版;断网或 GitHub 不可达时降级为灰色静态版本号,不影响使用。
  • proxy.ini 是可选文件;管理员账号 / 密码以该文件为准,修改后重启会覆盖库中已有管理员,日常改密请直接编辑该文件。

📝 本版本变更清单(v1.2.2..v2.0.0)

类型 变更
✨ 特性 新增严格优先级(逐级下放)模型选择模式 degradation_strict_priority,补齐「主备」语义,默认关闭、零回归
✨ 特性 provider 启停级联同步其下映射模型状态:新增 disable_reason 列区分手动禁用与联动禁用,恢复 provider 时不误启用户手动禁用的 mapping
✨ 特性 provider 禁用时前后端闭环禁止开启其下 mapping(后端 400 拦截 + 前端灰色锁定 tooltip),消除「显示启用却实际无效」的假启用
✨ 特性 新增版本号徽章自动检测 GitHub 最新版(version.py + /api/version + settings 缓存,断网降级)
✨ 特性 刷新页面保持当前 Tab 页(URL hash + history.replaceState)
🎨 UI 模型映射列表列顺序调整、角色映射弹窗样式美化、max_tokens 字段中文说明优化
🐛 修复 codex 正常请求被日志详情框误显示为错误(exit=normal 清空 upstream_error_type + 仅 status=error 写 error_msg)
🎨 资源 新增程序图标 ICON_PROMPT.png,exe / 任务栏使用该图
🔧 架构 数据库 schema 升级到 v7:v6 给 model_mappings 新增 disable_reason 列(迁移幂等回填 manual);v7 数据修正迁移把历史假启用残留改写为 provider_disabled

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

v1.2.2

Choose a tag to compare

@sky-unicorn sky-unicorn released this 15 Jul 05:03
Immutable release. Only release title and notes can be modified.

🎉 Vibe Coding 服务转发 v1.2.2

基于 Flask 的多供应商 AI API 代理服务,把多家上游 LLM 统一抽象成 Anthropic Messages API、OpenAI Chat Completions API、OpenAI Responses API 三种接口对外暴露,并配套可视化 Web 管理界面。本版本延续 Windows 免安装 exe 双击即运行的形态,集中攻克了 codex CLI 经代理卡死的各类根因(流式心跳缺失、连接中断静默吞错、思考链被丢弃),并为模型映射新增了 Codex 配置弹窗,把「丢弃 / think 标签 / reasoning_content 字段 / 原生 Responses 透传」四种 Responses↔Chat 转换策略统一为可视化开关。

📦 下载

文件 说明
VibeCodingProxy-v1.2.2.exe Windows 64 位免安装单文件,双击运行
  • 大小:约 15 MB
  • SHA256:2da3d8fb6c9591ae802ace80553acee58ca69accb944d972597e875394b0dc9b
  • 系统要求:Windows 10 / 11(64 位),无需预装 Python 或任何依赖

✨ 本版本更新(v1.2.1 → v1.2.2)

  • 彻底修复 codex CLI 经代理卡死(本轮多条提交协同解决,覆盖心跳、错误终结、思考链三个层面)

    • Responses 流式路径 SSE 心跳保活:codex 走 OpenAI Responses 协议,请求国产上游时其 reasoning 阶段可能数十秒甚至数百秒不产出任何 SSE 数据,代理在阻塞读取上游期间不发任何事件,codex SSE 客户端的 idle timeout(硬上限 300s)触发后报 idle timeout waiting for SSE 断连,表现为「请求成功但卡死」。修复把上游 iter_lines() 阻塞读取移到后台 daemon 线程,主生成器带 5s 超时拉取,超时则 yield response.ping 真正的 SSE event;心跳必须是真事件而不能是 : 注释行(codex 的 eventsource_stream 会丢弃注释行、不重置计时)
    • 流式中断不再被静默记 success:流式 generate() 的连接级异常分支原本 pass 静默吞掉,error_msg 保持空串、finally 误记 status=success 且不发任何终结事件,codex 收到半截 reasoning 流后 EOF,报 stream closed before response.completed 并卡死,与日志 success 自相矛盾。现改为:上游侧异常时发 response.failed 真 SSE 事件让 codex 走错误重试路径,连接级异常一律记 error,并新增流式诊断变量(exit_reason/completed_sent/upstream_done 等)在 finally 拼成摘要输出到控制台与 error_msg,便于从 Web UI / SQLite / 控制台定位卡死退出路径
    • 思考链注入修复多轮工具调用决策退化:codex 经代理请求 MiniMax 等推理模型时,Responses→Chat 转换原本直接丢弃历史 reasoning 思考内容,破坏 MiniMax Interleaved Thinking 思维链,导致多轮工具调用后模型决策退化、不再调用工具而返回纯文本(finish_reason=stop)。详见下方「Codex 配置弹窗」
  • 新增模型映射「Codex 配置」弹窗,统一四种思考回传 / 转换策略为开关

    • 模型映射操作列新增「Codex 配置」按钮与独立弹窗,收纳并扩展原先散落的 Responses 转换开关;编辑弹窗移除原 reasoning_effort 透传开关(已迁入 Codex 配置弹窗)
    • 弹窗内含四个开关,前三个为「思考过程回传方式」、第四个为「转换路径」:
      1. 透传思考强度参数(reasoning_effort) —— v1.2.1 已有,迁入弹窗,默认打开
      2. 思考过程注入:think 标签(think_injection)—— 把 codex 回传的历史 reasoning 以 <think>...</think> 注入对应 assistant 消息 content 前缀,保持思考链连续;MiniMax 识别为思维链,DeepSeek/GLM/Kimi 等当普通文本无害。默认关闭
      3. 思考过程注入:reasoning_content 字段(reasoning_content_field)—— DeepSeek/GLM/Kimi 思考模式官方要求 reasoning 以独立 reasoning_content 字段回传 assistant 消息,多轮工具调用缺失该字段会返回 400;think_injection 的标签形式只对 MiniMax 有效,对 DeepSeek 等仍 400,故新增此字段注入方式。默认开启(DeepSeek 用户最多)
      4. 原生 Responses 透传(native_responses)—— 开启后 /openai 端点对该 mapping 跳过 Responses↔Chat 双向转换,按 provider.openai_url 派生 /responses 端点原样转发(仿 Anthropic handler 直转语义),适用于原生支持 Responses API 的上游;避免协议转换造成的保真度损失(previous_response_id/store/原生 reasoning 摘要被丢弃)、额外延迟与转换层心跳维护复杂度。默认关闭
    • 互斥规则:think_injection 与 reasoning_content_field 在 UI 上互斥(前端 onchange 强制),同一时间只能开一个;native_responses 与前两者三方互斥,开启原生透传自动取消另两个;三个全关则走原转换路径并丢弃 reasoning(与改动前逐字节一致,零回归)。reasoning_effort 透传开关独立、不参与互斥
  • 修复 Responses 路径缓存命中 token 未记录

    • 通过 OpenAI Responses 端点请求时,日志的 cache_read_input_tokens 始终为 0,无法查看模型缓存命中数量、影响缓存命中计费
    • 根因:原生 Responses 透传路径(流式 / 非流式)与 Responses→Chat 转换流式路径只提取了 input/output_tokens,未解析上游 usage 中的缓存命中字段;转换路径返回给客户端的响应也漏了 input_tokens_details
    • 修复后:原生透传从 usage.input_tokens_details.cached_tokens 提取并记账,转换流式从 prompt_tokens_details.cached_tokens 提取并记账,转换响应(非流式 / 流式)均补全 input_tokens_details.cached_tokens 字段;日志、计费与客户端可见的缓存命中口径与 Chat Completions 直通路径一致
  • 思考过程注入开关命名与描述优化

    • 统一两个思考过程注入开关的命名风格为「思考过程注入:think 标签」与「思考过程注入:reasoning_content 字段」,让用户一眼看出是同一功能的两种注入方式
    • 精简描述:去掉互斥关系的冗余重复说明(onchange 已强制保证)、去掉跨适用场景的「无害」备注
    • 新增 原生Responses透传说明.md:文档化转换路径中图片剥离、reasoning 重整、Responses↔Chat 字段映射、_responses_input_to_chat_messages 调用四个操作的作用与原生透传跳过它们的原因

🚀 快速开始

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

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

    [server]
    port = 5000
    
    [admin]
    username = admin
    password = admin123
  3. 双击运行,弹出的控制台窗口会显示各端点地址。

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

  5. 在 Web 界面配置上游提供商、模型映射、API Key 即可开始转发;codex CLI 接入请在对应模型映射行点「Codex 配置」按上游能力选择思考回传方式。

⚠️ 升级说明(v1.2.0 / v1.2.1 → v1.2.2)

  • 从 v1.0.0 / v1.1.1 / v1.2.0 / v1.2.1 的 exe 升级:把旧版本同目录的 proxy.db 复制到新 exe 同目录,即可保留历史数据。
  • 从 v1.2.0 升级:首次启动 v1.2.2 时,迁移框架会自动把库从 v1 升到 v5,依次补齐 reasoning_effort_supported(v1.2.1 引入)、think_injection、reasoning_content_field、native_responses 四列,按备份 → 重建 → 回填的流程执行,历史模型映射不丢失。
  • 从 v1.2.1 升级:库已在 v2,首次启动 v1.2.2 会从 v2 升到 v5,补齐 think_injection(默认 0 / 关)、reasoning_content_field(默认 1 / 开)、native_responses(默认 0 / 关)三列。
  • 升级后行为变化(重要):
    • 老映射升级后 reasoning_content_field 默认打开——若你的上游是 DeepSeek / GLM / Kimi,这正是所需行为(修复多轮工具调用 400);若上游是 MiniMax,建议改用「思考过程注入:think 标签」开关(与 reasoning_content_field 互斥,前端会自动切换)。
    • 原本因思考链被丢弃导致 codex 多轮工具调用后「不调工具只回纯文本」的模型,升级后开启对应注入开关即可恢复。
    • 原生支持 Responses API 的上游,可在 Codex 配置弹窗开启「原生 Responses 透传」获得更高保真度(与思考注入开关三方互斥)。
    • Responses 端点的缓存命中 token 现已正确记录到日志与计费,cache_read_input_tokens 不再恒为 0。
  • proxy.ini 是可选文件;管理员账号 / 密码以该文件为准,修改后重启会覆盖库中已有管理员,日常改密请直接编辑该文件。

📝 本版本变更清单(v1.2.1..v1.2.2)

类型 变更
🐛 修复 codex 经代理卡死:Responses 流式路径 SSE 心跳保活(后台线程 + response.ping 真 event)
🐛 修复 流式中断被静默记 success:上游异常发 response.failed 终结事件、连接级异常一律记 error、新增流式诊断摘要
🐛 修复 Responses 路径缓存命中 token 未记录:原生透传与转换路径均提取 cached_tokens 并补全 input_tokens_details
✨ 特性 模型映射新增「Codex 配置」弹窗,收纳 reasoning_effort 透传并新增 think 标签 / reasoning_content 字段 / 原生 Responses 透传开关
✨ 特性 think_injection(think 标签注入,默认关)修复 MiniMax 多轮工具调用思考链断裂
✨ 特性 reasoning_content_field(字段注入,默认开)修复 DeepSeek/GLM/Kimi 多轮工具调用 400
✨ 特性 native_responses(原生 Responses 透传,默认关)跳过协议转换直转,提升保真度
🔧 架构 数据库 schema 升级到 v5:model_mappings 新增 think_injection、reasoning_content_field、native_responses 三列,迁移幂等回填,老库升级与全新库默认值一致
📄 文档 新增 原生Responses透传说明.md;优化思考过程注入开关命名与描述

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

v1.2.0

Choose a tag to compare

@sky-unicorn sky-unicorn released this 13 Jul 07:32
Immutable release. Only release title and notes can be modified.

🎉 Vibe Coding 服务转发 v1.2.0

基于 Flask 的多供应商 AI API 代理服务,把多家上游 LLM 统一抽象成 Anthropic Messages API、OpenAI Chat Completions API、OpenAI Responses API 三种接口对外暴露,并配套可视化 Web 管理界面。本版本延续 Windows 免安装 exe 双击即运行的形态,重点增强了计费灵活性、数据库结构演进的安全保障,并修复了 max_tokens 转发的潜在 400 错误。

📦 下载

文件 说明
VibeCodingProxy-v1.2.0.exe Windows 64 位免安装单文件,双击运行
  • 大小:约 17 MB
  • SHA256:0bc407a23dbe10cfc7dad638ef530dd0a6d0f3998e7b412524717cde84d8dcf6
  • 系统要求:Windows 10 / 11(64 位),无需预装 Python 或任何依赖

✨ 本版本更新(v1.1.1 → v1.2.0)

  • 余额计费新增「缓存命中价格」配置

    • 此前余额(balance)计费模式下,缓存命中 token(cache_read)按输入价格的 10% 硬编码计费,无法适配不同供应商的实际缓存折扣
    • 计费设置抽屉新增「缓存命中价格(/百万 Token)」输入框;余额扣减改用此配置值
    • 留空(或 0)时自动回退为输入价格的 10%,与 v1.1.1 行为完全兼容,无需改动存量配置
  • max_tokens 转发改为按模型配置上限钳制(修复潜在 400 错误)

    • 此前模型映射配置的 max_tokens 仅在客户端未传时作为默认值填充;当客户端传入超过模型上限的值(例如客户端传 64000,而模型上限 32768),会被原样转发,导致上游 provider 直接返回 400
    • 现统一为「上限钳制 + 填空」:配置了 max_tokens 时,客户端未传或 ≤0 则填配置值,客户端传入超过配置值则裁剪到配置值,确保配置上限真正生效
    • 三条转发路径(OpenAI 直转、Anthropic 转发、Responses / 流式降级)已全部同步
  • 引入数据库版本号迁移框架(内部可靠性增强)

    • 采用 PRAGMA user_version 版本号线性迁移机制,替换原先依赖手写函数与列存在性检测的零散迁移逻辑
    • 新增 _MIGRATIONS 注册表 + run_migrations 按序前向执行,每步递增版本号、崩溃可断点续跑
    • 启动自检兜底:派生期望 schema 做反射对比,遗漏迁移会直接启动失败,把「忘了写迁移」从静默故障变为启动即暴露
    • 老库首次启动会自动基线校准到当前版本并跑必要迁移,不重跑、不丢数据;全新库直接获得最新结构
  • 供应商表单 API Key 输入框支持显示 / 隐藏切换

    • API Key 输入框新增眼睛图标切换按钮,方便输入或核对密钥时临时查看明文
    • 默认隐藏;打开与关闭供应商弹窗时自动重置为隐藏状态,确保密钥默认不可见

🚀 快速开始

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

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

    [server]
    port = 5000
    
    [admin]
    username = admin
    password = admin123
  3. 双击运行,弹出的控制台窗口会显示各端点地址。

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

  5. 在 Web 界面配置上游提供商、模型映射、API Key 即可开始转发。

⚠️ 升级说明

  • 从 v1.0.0 / v1.1.1 的 exe 升级:把旧版本同目录的 proxy.db 复制到新 exe 同目录,即可保留历史数据。
  • 首次启动 v1.2.0 时,新版本迁移框架会自动校准库版本并补齐「缓存命中价格」列(cache_read_price_per_million),按备份 → 重建 → 回填的流程执行,历史计费配置不丢失;该列默认为 0,计费行为与旧版一致。
  • proxy.ini 是可选文件;管理员账号 / 密码以该文件为准,修改后重启会覆盖库中已有管理员,日常改密请直接编辑该文件。

📝 本版本变更清单(v1.1.1..v1.2.0)

类型 变更
✨ 特性 余额计费新增「缓存命中价格」配置(cache_read_price_per_million)
✨ 特性 max_tokens 转发改为按模型配置上限钳制(OpenAI / Anthropic / Responses 三路径)
✨ 特性 供应商表单 API Key 输入框显示 / 隐藏切换
🔧 架构 引入数据库版本号迁移框架(user_version + 启动自检)
🐛 修复 修复客户端传入超限 max_tokens 导致 provider 返回 400 的问题
🐛 修复 修复使用手册中图片地址错误
📄 文档 完善 README 与使用手册,新增 cc-switch 配置图文指南、版本说明文档

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

v1.1.1

Choose a tag to compare

@sky-unicorn sky-unicorn released this 10 Jul 03:19
Immutable release. Only release title and notes can be modified.

🎉 Vibe Coding 服务转发 v1.1.1

基于 Flask 的多供应商 AI API 代理服务,把多家上游 LLM 统一抽象成 Anthropic Messages API、OpenAI Chat Completions API、OpenAI Responses API 三种接口对外暴露,并配套可视化 Web 管理界面。本版本延续 Windows 免安装 exe 双击即运行的形态,新增外部配置文件并补全缓存命中 Token 的可观测性。

📦 下载

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

✨ 本版本更新

  • 支持 proxy.ini 外部配置

    • 在 exe 同目录(源码方式为项目根目录)放置 proxy.ini 即可配置启动端口与管理员账号/密码,无需修改源码
    • [admin] 段是管理员账户的唯一事实来源,每次启动都会校准 admin_users 表,修改用户名/密码后重启即生效(改用户名会自动清理旧账号)
    • 没有 proxy.ini 时使用内置默认值(端口 5000、管理员 admin / admin123),与 v1.0.0 行为一致
  • 日志补全缓存命中 Token 展示

    • OpenAI 直转路径(流式与非流式)此前未采集缓存命中 token,现已从 usage.prompt_tokens_details.cached_tokens 提取并记录,与 Anthropic 路径的 cache_read_input_tokens 统一
    • 前端将「输入 Token」「输出 Token」两列合并为「入/缓/出(token)」一列,以 入 / 缓存命中 / 出 三段紧凑展示

🚀 快速开始

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

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

    [server]
    port = 5000
    
    [admin]
    username = admin
    password = admin123
  3. 双击运行,弹出的控制台窗口会显示各端点地址。

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

  5. 在 Web 界面配置上游提供商、模型映射、API Key 即可开始转发。

⚠️ 升级说明

  • 从 v1.0.0 的 exe 升级:把旧版本同目录的 proxy.db 复制到新 exe 同目录,即可保留历史数据。
  • proxy.ini 是可选文件;管理员账号/密码以该文件为准,修改后重启会覆盖库中已有管理员,日常改密请直接编辑该文件。

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

v1.0.0

Choose a tag to compare

@sky-unicorn sky-unicorn released this 09 Jul 07:49
Immutable release. Only release title and notes can be modified.

🎉 Vibe Coding 服务转发 v1.0.0

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

📦 下载

文件 说明
VibeCodingProxy-v1.0.0.exe Windows 64 位免安装单文件,双击运行
  • 大小:约 17 MB
  • SHA256:c5089441388a1da1b936d8a55f6164719079173ba05bce9eefcfe784f0992bad
  • 系统要求:Windows 10 / 11(64 位),无需预装 Python 或任何依赖

🚀 快速开始

  1. 下载 VibeCodingProxy-v1.0.0.exe,放到任意目录(建议新建一个空文件夹,数据库文件会生成在同目录)。
  2. 双击运行,弹出的控制台窗口会显示各端点地址。
  3. 浏览器打开 **http://localhost:5000**,首次启动会自动初始化数据库并创建管理员账号。
  4. 在 Web 界面配置上游提供商、模型映射、API Key 即可开始转发。

✨ 核心功能

  • 多协议统一代理

    • POST /anthropic/v1/messages — Anthropic Messages API
    • POST /v1/chat/completions — OpenAI Chat Completions API
    • POST /openai/responses — OpenAI Responses API(供 Codex CLI 等只认 Responses 协议的客户端,自动与 Chat Completions 互转)
    • 完整支持流式(stream: true)与非流式响应
  • 提供商管理

    • 每个提供商可同时配置 Anthropic URL 与 OpenAI URL,按请求协议自动路由
    • 「完整路径 / Base 路径」开关,支持 URL 原样转发或自动拼接路径后缀
    • 最大并发数限制、启用/禁用、自动禁用原因记录、实时并发统计
  • 模型映射与负载均衡

    • 别名(alias)= 对外模型名,按客户端 IP 隔离的加权轮询
    • 同别名多映射构成负载均衡池,按 priority 加权选择
    • 角色映射(role_mappings):转发前对 messages 角色做一次性替换(如 developer → system)
    • 强制覆盖 max_tokens、多模态优先选择
  • 服务降级与故障转移

    • 同一别名下某上游转发失败后被临时「降级」,后续请求自动绕过、切换到健康上游
    • 全部上游降级时仍会尝试,任一成功即立即恢复
  • 自动重试与容错

    • 上游 5xx 或连接级异常(超时、断开、Chunked 错误)自动重试
    • 4xx 视为语义错误立即返回不重试
  • 资源治理

    • 计费限额(5h / 周 / 月 / 余额)、超额自动禁用、窗口自动重置
    • 错误码映射、自动日志清理、启动及每日自动 VACUUM 压缩数据库
  • OAuth 2.1 支持

    • PKCE、动态客户端注册(RFC 7591)、JWT 访问令牌
    • RFC 8414 授权服务器元数据、RFC 9728 受保护资源元数据端点,供 Claude Code 等客户端 OAuth 登录
  • 可观测性:完整记录每次请求的 IP、源/目标模型、provider、token、缓存 token、耗时、状态码、请求/响应体。

📝 本版本打包说明

  • 使用 PyInstaller --onefile 打包,所有 Python 依赖已内嵌,开箱即用。
  • 数据库文件 proxy.db 生成在 exe 同目录,便于备份与迁移。
  • 控制台窗口支持 UTF-8 中文输出。

⚠️ 已知限制

  • 内置的是 Flask 开发服务器,适合个人/小团队使用;高并发生产场景建议自行用 Gunicorn / waitress 等 WSGI 服务器运行源码。
  • 当前仅提供 Windows 64 位版本。

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