本文介绍如何用 咕咕助手脚本 一键安装 咕咕助手 - 中转管理 扩展。
此工具适合在酒馆里保存了多个中转站 API 配置、想要集中查看余额、已使用、模型和常用入口的玩家。
中转管理的前后端仓库都是我的免费开源项目，请在 github 帮我点一个免费的 star 支持一下，谢谢：
部署和安装使用的工具是我的免费开源项目 咕咕助手：
声明
本项目和脚本均为免费开源项目，仅供个人学习和非商业用途使用。
未经作者授权，严禁将脚本或插件用于任何形式的商业盈利行为（包括但不限于倒卖、付费部署服务等）。
任何违反本协议的行为都将受到法律追究。
一、前言
这个插件分成两部分：
- 前端扩展 负责显示面板，也就是你在酒馆里看到的首页、详情页、关于页这些界面。
- 后端插件 负责代发请求、读取你在酒馆里保存的密钥、绕过浏览器跨域限制、刷新余额和模型。
所以它和普通只装一个前端面板的扩展不一样，前后端必须一起装 才完整。
而咕咕助手脚本做的事情，就是把这两个部分一起装好，并尽量把麻烦事一起处理掉：
- 前端扩展放到正确目录
- 后端插件放到正确目录
- 自动开启酒馆后端插件开关
- 后续更新也可以直接在脚本里完成（也可以在酒馆里更新）
不需要自己去折腾 plugins、extensions、config.yaml 这些东西。
它能做什么
- 自动读取你已经保存在酒馆里的 API 配置
- 刷新余额、已使用、24 小时变化、模型等信息
- 切换到某个 API 配置
- 给常用站点加分组、置顶、备注
- 打开站点主页、福利站、模型状态页、发布页
前提条件
- 你已经用咕咕助手部署好了酒馆。
- 你的咕咕助手已经更新到带有 咕咕宝箱 或 中转管理插件 菜单的版本。
本文的一键安装和使用说明，仅适配使用咕咕助手安装的酒馆。
如果你的酒馆是其他方式安装的，我更建议先改用咕咕助手，这样安装、更新、卸载、排错都会省事很多。
相关文章：
当然，你也可以自己去 GitHub 看前后端仓库文档手动安装。
二、安装
1. Windows / 安卓 本地酒馆
- 打开咕咕助手。
- 输入
12回车，进入 咕咕宝箱。 - 输入
1回车，进入 咕咕助手 - 中转管理。 - 输入
1回车，执行 安装/更新。 - 等待脚本安装完成。
安装完成后，重启酒馆，再刷新浏览器页面。
2. 云服务器 docker 酒馆
- 进入终端，唤出咕咕助手（命令
gugu或bash <(curl -sL gugu.qjyg.de/vps)） 。 - 进入酒馆的 应用运维管理 菜单。
- 输入
11回车，进入 中转管理插件。 - 输入
1回车，执行安装或更新。
脚本支持海内外仓库自动选择。
如果网络环境特殊，也可以在菜单里手动切换海内外仓库后再安装或更新。
三、使用
1. 关于
安装完成并重启酒馆后，进入酒馆网页。
你应该能在扩展区域看到 咕咕助手 - 中转管理，点击展开面板。
第一次进去后，先看关于页，先确认安装成功没。
关于页主要用来看这些状态：
- 前后端是否正常
- 当前能不能正常检查状态或更新
如果这里显示前后端都正常，说明装好了。
2. 首页
确认关于页正常后，再回首页。
首页会把在 API 连接设置中保存的配置列出来，能看到一些余额信息和快捷跳转按钮。
NEWAPI 需要配置一下才能显示余额。
3. 设置
点首页中的某个 API 配置，就会进入详情页，先进设置页面。
刷新相关
NEWAPI 系站点需要填写 面板令牌 和 用户 ID，在站点的 个人设置 页面可以看到自己的 用户 ID 和 生成令牌 ，填好之后就可以刷新查询余额了。
余额提醒、定时刷新
- 余额提醒：输入目标数值，余额低于这个数值会有弹窗和面板提醒。
- 定时刷新：默认每次启动时刷新+手动刷新，开启这个再加一项定时刷新。
按钮相关
- 站点页面
- 福利站
- 模型状态页
- 发布页
这些随便填，只影响按钮跳转到哪里，填或不填都不影响使用。
4. 刷新
点刷新后，插件会做这几件事：
- 识别站点类型
- 刷新余额或额度信息
- 拉取模型列表
不同中转站的差异很大并未全部适配，目前仅实测了 NEWAPI 和 SUB2API 可以正常使用。
5. 切换配置
- 概览页可以切配置。
6. 忽略错误通知
如果有些站点无法适配，一直无意义报错，可以点击概览中的忽略错误。
四、常见问题
1. 为什么首页没有任何站点
因为它读的是 你已经保存在酒馆里的 API 配置。
如果原本配置页里没有保存过，那这里就不会有。
2. 为什么能打开面板，但刷新失败
- 站点本身不支持。
- 这个站点除了密钥，还需要额外的令牌或用户 ID。
- 请求地址没填对。
- 站点接口本身不稳定。
3. 为什么站点显示的数据和网页上不一样
因为不同站点返回的字段口径不同。
有的返回的是余额，有的返回的是剩余额度，有的是折算值，有的是赠送额度，有的还会把货币单位和积分混着返回。
所以插件能做的是尽量按站点规则去识别，但 最终还是以站点自己接口返回的数据为准。
4. 为什么有些站点能拉模型，有些拉不出来
这也是站点实现差异。
有些站的 /models 接口很标准，有些站没实现完整，还有些站虽然能聊天但模型接口是坏的。
但可能并不影响使用。
5. 脚本装好了，还需要手动去开 config.yaml 中的后端插件开关吗
正常情况下 不用。
脚本安装时会自动帮你处理后端插件开关。
但如果你后面手动改过酒馆配置，把后端插件关掉了，那中转管理当然也会跟着失效，这时再去脚本菜单里打开后端插件开关即可。
五、后续管理
以后要更新，直接在面板的关于页面更新。
也可以回到脚本菜单里，进入原来的 中转管理 菜单，执行一次 安装/更新 就可以了。
如果要卸载，也是在同一个菜单里直接卸载。
喜欢的话，留下你的评论吧～