Skip to content

v3.9.0

Choose a tag to compare

@sky-unicorn sky-unicorn released this 07 Aug 00:57
· 14 commits to main since this release
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。