萝卜盒 LuoboBox

萝卜盒 LuoboBox

codebuddy2api local gateway console

codebuddy2api 本地网关的 Windows 桌面控制台。把网关跑起来、开关公网入口、 一键接入 Codex 与 Claude Code、升级后自动补回必需的补丁 —— 一个托盘图标全搞定。

Windows · 自用工具 · 非商业授权

Why

原来跑这个网关,要记一长串事情

都是零碎但真实的坑 —— 不是网关坏了,是没人记得住那些步骤。

01

双击哪个 bat 都要记

换端口、换目录、清缓存,每次都得翻文档确认哪个脚本才是对的那个。

02

改 Key 要同步三个文件

少改一处,客户端就开始 401,而提示通常什么都说不出来。

03

升级后必须手动重打补丁

不重打,上游一更新就把 Codex 拦掉,报错还看不出跟补丁有关。

04

Funnel 挂了要手动重挂

公网入口莫名其妙就没了,得记得那条带 --bg 的命令。

05

服务莫名退出

日志里只有一串 0xC000013A,得逐条排查才知道是被谁关掉的。

06

机器上没装 Python

装 Python 要 UAC,装错位数比没装更难查,官网只给个下载链接就没了。

核心不是「好看」,是「不会再忘」。

萝卜盒把这些都收进一个托盘程序里,每一步都有对应的按钮和状态提示。

Features

一个托盘图标,替你管住这些事

点击即用,不用记命令;出问题时告诉你到底缺什么、点哪个能修。

托盘常驻

启动 / 停止 / 重启网关、开关公网入口、复制接入地址与 Key、立即签到、检查更新(发现新版本时托盘直接带角标)、开机自启。

状态面板

网关状态、端口、PID、可用模型数、响应延迟、脱敏补丁健康度、凭证池健康与积分,一屏看完。

首屏状态环

96px 自绘状态环加大状态字与双主按钮,打开就知道现在什么状态、下一步该点哪。

命令面板与快捷键

Ctrl+K 模糊匹配任意功能,不用记它藏在哪个标签页;Ctrl+1..N 切页签、Ctrl+R 重启网关、Ctrl+Shift+C 复制接入包。

iOS 风格外观

暗 / 亮双基调、四套强调色、三档字号,分段控件式导航与自绘开关。切换即时生效,窗口位置自动记忆。

四个接入地址

本机 / 局域网 / Tailscale / 公网各一个,一键复制;API Key 可显隐。

客户端自动化

一键写入 Codex 的 config.toml 与 Claude Code 的 settings.json,改前自动备份,可一键还原。

日志查看器

实时 tail 网关日志,关键字 / 正则过滤,ERROR 与 WARN 分级着色,可清空、可导出。

原生管理台

统计 / 模型 / 凭证 / 日志 / 设置五个子页签,直接调网关的 REST 接口,与前端构建产物解耦 —— 网关怎么升级都不会坏。

额度消耗

基于本地余额快照反推消耗,累计 / 今日消耗与每账号明细,柱状图加环形图,纯本地不依赖上游。

补丁守护

检测脱敏词表是否被上游冲掉,缺失自动补回 —— 这是升级后最容易被忽略、又最致命的一步。

两条独立更新链路

萝卜盒更新只换自己(静默安装 / 原地覆盖后自动重启);网关更新只换网关源码,保留凭证与配置,并自动重打补丁。

一键配置环境

一次点击体检九项:指针、网关源码、解释器与依赖、端口、API Key、启动参数、脱敏补丁、内置 WebUI、旧计划任务。能修的当场修好并复检,全程逐行回显。

免安装内置 Python

机器上一个可用解释器都没有时,自动下载官方嵌入式 Python(约 50MB,免安装、免管理员),补 _pth、引导 pip、装齐依赖。按架构选包,多镜像回退。

自动获取网关源码

本机找不到网关时直接从上游拉一份:下载、解包、打补丁、补内置 WebUI,拿到手即可运行。

数据目录可搬家

配置、日志、备份、下载中转整体搬到别的盘,缓解 C 盘压力。顺序是先复制、再写指针、最后删旧,中途失败不丢数据。

环境自愈与首次向导

每次启动自动修正失效的网关目录、Python 路径、被占用的端口;首次运行四步向导带「一键修复环境」,本机没 Python 会自动装一份内置的。

How it works

装上之后,只剩四步

从零到能用,中间那堆命令都不需要你手敲。

STEP 1

装好、打开

双击运行,不用装 Python、不用配环境变量、不用管理员权限。

STEP 2

一键配置环境

自动探测解释器、缺什么装什么;本机一个 Python 都没有就装内置的那份。

STEP 3

启动网关

点一下就起。起不来时告诉你缺什么、点哪个按钮能补,不用自己翻 traceback。

STEP 4

接入客户端

一键写入 Codex 或 Claude Code 的配置,复制接入地址与 Key,粘贴到客户端即可用。

Under the hood

刻意保持简单

不引第三方 UI 库、图表库与浏览器内核 —— 少一个依赖就少一份体积和升级风险。

PySide6 / Qt桌面壳与窗口
FastAPI + uvicorn网关运行时(独立子进程)
QPainter自绘柱状图与环形图
GetExtendedTcpTable端口查询 0.16ms
GitHub Actions打 tag 自动出包
PyInstaller只打包桌面壳
FAQ

常见问题

我电脑上根本没装过 Python,也能用吗?

能,而且不用你自己去装。点「一键配置环境」,发现机器上一个可用解释器都没有时,萝卜盒会自动下载一份官方的嵌入式 Python 放进数据目录(约 50MB,免安装、不需要管理员权限、不写注册表、不碰 Program Files),然后补 _pth、引导 pip、装齐依赖。它跟着数据目录走,卸载或迁移时一起处理。

启动报「网关目录不完整」或 ModuleNotFoundError: No module named 'app'?

说明网关源码目录只下了一半:converter.py 在,但它第一段就要 import app/ 包,而那个包不在。到「设置 → 运行环境」点「一键配置环境」,它会就地补齐 —— 路径不变,登录凭证与配置都保留,不会另拉一份把你现有的东西甩掉。这种目录在体检阶段就会被判出来,点启动也会在起进程之前直接告诉你怎么补。

Codex 报 stream closed before response.completed?

九成是脱敏补丁被升级冲掉了。到「概览」看「脱敏补丁」那一行,点「一键重打补丁」然后重启网关即可。补丁守护就是为这件事存在的。

更新时报「由于连接方在一段时间后没有正确答复」?

这是代理连不上,不是下载源挂了。到「更新 → 下载通道」点「保存并诊断」,会逐条列出每个候选通道(手动 / 系统 / 环境变量 / 直连)是否可达。萝卜盒会自动跳过探活失败的通道,通常不用管。

能换主题吗?字号太小怎么办?

到「设置 → 外观」:暗 / 亮两种基调,四套强调色(萝卜红 / 青柠 / 电紫 / 湖蓝),三档字号。改完立刻生效,不用重启。

关闭窗口后程序去哪了?网关还活着吗?

默认最小化到托盘(设置里可关),网关继续在后台提供服务,托盘图标能随时看状态。

可以放在 D 盘吗?

可以。升级永远不会动安装位置:安装版静默升级会显式带上当前目录,便携版原地覆盖。真正占地方的数据目录(配置 / 日志 / 备份 / 下载中转,备份一份可能几百 MB)到「设置 → 数据与磁盘 → 迁移数据目录到其他盘」整体搬走即可。

有快捷键吗?

Ctrl+K 命令面板(模糊搜任意功能)、Ctrl+1..N 按顺序切页签、Ctrl+R 重启网关、Ctrl+Shift+C 复制接入包、F5 刷新、Ctrl+, 设置。

Get it

获取萝卜盒

扫码联系获取安装包。也可直接在 GitHub Releases 下载最新版本。

微信客服二维码

微信扫码 · 备注「萝卜盒」获取最新版安装包

Windows 10 / 11 · 便携版与安装版均可