本文介绍如何用 咕咕助手脚本 一键安装 咕咕助手 - 中转管理 扩展。

此工具适合在酒馆里保存了多个中转站 API 配置、想要集中查看余额、已使用、模型和常用入口的玩家。

中转管理的前后端仓库都是我的免费开源项目，请在 github 帮我点一个免费的 star 支持一下，谢谢：

部署和安装使用的工具是我的免费开源项目 咕咕助手：

一、前言

这个插件分成两部分：

1. 前端扩展 负责显示面板，也就是你在酒馆里看到的首页、详情页、关于页这些界面。
2. 后端插件 负责代发请求、读取你在酒馆里保存的密钥、绕过浏览器跨域限制、刷新余额和模型。

所以它和普通只装一个前端面板的扩展不一样，前后端必须一起装 才完整。

而咕咕助手脚本做的事情，就是把这两个部分一起装好，并尽量把麻烦事一起处理掉：

• 前端扩展放到正确目录
• 后端插件放到正确目录
• 自动开启酒馆后端插件开关
• 后续更新也可以直接在脚本里完成（也可以在酒馆里更新）

不需要自己去折腾 plugins、extensions、config.yaml 这些东西。

它能做什么

• 自动读取你已经保存在酒馆里的 API 配置
• 刷新余额、已使用、24 小时变化、模型等信息
• 切换到某个 API 配置
• 给常用站点加分组、置顶、备注
• 打开站点主页、福利站、模型状态页、发布页

前提条件

1. 你已经用咕咕助手部署好了酒馆。
2. 你的咕咕助手已经更新到带有 咕咕宝箱 或 中转管理插件 菜单的版本。

二、安装

1. Windows / 安卓 本地酒馆

1. 打开咕咕助手。
2. 输入 12 回车，进入 咕咕宝箱。
3. 输入 1 回车，进入 咕咕助手 - 中转管理。
4. 输入 1 回车，执行 安装/更新。
5. 等待脚本安装完成。

安装完成后，重启酒馆，再刷新浏览器页面。

2. 云服务器 docker 酒馆

1. 进入终端，唤出咕咕助手（命令 gugu 或 bash <(curl -sL gugu.qjyg.de/vps) ） 。
2. 进入酒馆的 应用运维管理 菜单。
3. 输入 11 回车，进入 中转管理插件。
4. 输入 1 回车，执行安装或更新。

三、使用

1. 关于

安装完成并重启酒馆后，进入酒馆网页。

你应该能在扩展区域看到 咕咕助手 - 中转管理，点击展开面板。

第一次进去后，先看关于页，先确认安装成功没。

关于页主要用来看这些状态：

• 前后端是否正常
• 当前能不能正常检查状态或更新

如果这里显示前后端都正常，说明装好了。

2. 首页

确认关于页正常后，再回首页。

首页会把在 API 连接设置中保存的配置列出来，能看到一些余额信息和快捷跳转按钮。

NEWAPI 需要配置一下才能显示余额。

3. 设置

点首页中的某个 API 配置，就会进入详情页，先进设置页面。

刷新相关

NEWAPI 系站点需要填写 面板令牌 和 用户 ID，在站点的 个人设置 页面可以看到自己的 用户 ID 和 生成令牌 ，填好之后就可以刷新查询余额了。

余额提醒、定时刷新

• 余额提醒：输入目标数值，余额低于这个数值会有弹窗和面板提醒。
• 定时刷新：默认每次启动时刷新+手动刷新，开启这个再加一项定时刷新。

按钮相关

• 站点页面
• 福利站
• 模型状态页
• 发布页

这些随便填，只影响按钮跳转到哪里，填或不填都不影响使用。

4. 刷新

点刷新后，插件会做这几件事：

1. 识别站点类型
2. 刷新余额或额度信息
3. 拉取模型列表

不同中转站的差异很大并未全部适配，目前仅实测了 NEWAPI 和 SUB2API 可以正常使用。

5. 切换配置

• 概览页可以切配置。

6. 忽略错误通知

如果有些站点无法适配，一直无意义报错，可以点击概览中的忽略错误。

四、常见问题

1. 为什么首页没有任何站点

因为它读的是 你已经保存在酒馆里的 API 配置。

如果原本配置页里没有保存过，那这里就不会有。

2. 为什么能打开面板，但刷新失败

1. 站点本身不支持。
2. 这个站点除了密钥，还需要额外的令牌或用户 ID。
3. 请求地址没填对。
4. 站点接口本身不稳定。

3. 为什么站点显示的数据和网页上不一样

因为不同站点返回的字段口径不同。

有的返回的是余额，有的返回的是剩余额度，有的是折算值，有的是赠送额度，有的还会把货币单位和积分混着返回。

所以插件能做的是尽量按站点规则去识别，但 最终还是以站点自己接口返回的数据为准。

4. 为什么有些站点能拉模型，有些拉不出来

这也是站点实现差异。

有些站的 /models 接口很标准，有些站没实现完整，还有些站虽然能聊天但模型接口是坏的。

但可能并不影响使用。

5. 脚本装好了，还需要手动去开 config.yaml 中的后端插件开关吗

正常情况下 不用。

脚本安装时会自动帮你处理后端插件开关。

但如果你后面手动改过酒馆配置，把后端插件关掉了，那中转管理当然也会跟着失效，这时再去脚本菜单里打开后端插件开关即可。

五、后续管理

以后要更新，直接在面板的关于页面更新。

也可以回到脚本菜单里，进入原来的 中转管理 菜单，执行一次 安装/更新 就可以了。

如果要卸载，也是在同一个菜单里直接卸载。