cortico-provider-gemini-gateway 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/README.md +91 -32
- package/assets/icon.png +0 -0
- package/package.json +9 -7
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,13 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.1.2
|
|
4
|
+
|
|
5
|
+
🐦 给粮仓换上了超可爱的新头像(趴在星星上的知更鸟小团子来报到啦!),还把卡片简介和整篇 README 里的冷冰冰公文腔统统赶跑,换成更贴近桌宠投喂日常的轻松小指南~
|
|
6
|
+
|
|
7
|
+
## 0.1.1
|
|
8
|
+
|
|
9
|
+
将扩展包的顶层简介(`description`)改为纯中文描述,便于在 npm 与扩展市场列表直接展示中文说明,并保留 `unofficial-api` 与 `experimental` 标签声明。
|
|
10
|
+
|
|
3
11
|
## 0.1.0
|
|
4
12
|
|
|
5
13
|
首个公开发布版本:提供面向 Cortico Provider API 6 的 Gemini 多协议网关扩展,支持 Google Robin 桌面 OAuth(含账号服务条款状态追踪与一键同意、按账号隔离的多模态附件上传与会话清理)、Web2API 原生 Gemini REST 及自定义会话式 RPC 三种接入模式,并在 WebUI 中随模式自动切换配置面板;内置多账号 OAuth 凭证池,支持主备故障转移、平等轮询与按周剩余额度优先三种调度策略及策略自适应额度看板,账号标识全局默认采用 `5***3@gmail.com` 脱敏并可一键显隐,同时支持公开模型目录自动拉取、自动计价与零内置密钥的安全分发模板。
|
package/README.md
CHANGED
|
@@ -1,49 +1,108 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="assets/icon.png" width="120" alt="Gemini 多合一粮仓" />
|
|
3
|
+
</p>
|
|
2
4
|
|
|
3
|
-
|
|
5
|
+
### 📦**Gemini 多合一粮仓(Robin / Web2API / 自定义 RPC)**
|
|
6
|
+
给自家桌宠搭的三合一 Gemini 喂食通道,WebUI 面板随切随用:
|
|
7
|
+
- **🐦 知更鸟模式(Robin)**:支持绑多个号轮着喂(主备切号 / 雨露均沾 / 谁额度多先吃谁),自带 5h & 周额度小看板、原生传图和账号打码防社死。
|
|
8
|
+
- **🔑 Web2API 模式**:切过去直接填官方 Gemini API Key 或自建反代 Key,零门槛开箱即用。
|
|
9
|
+
- **🛠️ 自定义 RPC**:给喜欢自己搭网关的折腾党留的后门。
|
|
4
10
|
|
|
5
|
-
|
|
11
|
+
---
|
|
6
12
|
|
|
7
|
-
|
|
13
|
+
## 🚀 怎么塞进 Coopanion(30 秒装好)
|
|
8
14
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
| `options.headers` / `options.secretHeaders` | 自定义网关请求头。前者保存明文值,后者将请求头映射到部署端点 `.env` 的变量名。 |
|
|
17
|
-
| `secret` / `options.credentialHeader` / `options.credentialPrefix` | `secret` 为网关 API 密钥变量名。默认头为 `x-goog-api-key`,默认前缀为空。 |
|
|
18
|
-
| `options.authHeader` / `options.authPrefix` | 桌面 OAuth 默认使用 `Authorization` 和 `Bearer `。 |
|
|
19
|
-
| `options.modelsDevUrl` / `options.openRouterUrl` | 可覆盖公开模型目录的 URL。目录请求只带 JSON Accept 头。 |
|
|
15
|
+
1. 打开 Coopanion 的 **扩展 → 模型供应商(Provider)** 页面。
|
|
16
|
+
2. 展开 **「手动安装」→「从 npm 安装」**,填包名(不要粘贴网页链接):
|
|
17
|
+
```text
|
|
18
|
+
cortico-provider-gemini-gateway
|
|
19
|
+
```
|
|
20
|
+
> 小提示:刚发新版未满 24 小时想抢鲜体验,记得把版本号带上,比如 `cortico-provider-gemini-gateway@0.1.2`。
|
|
21
|
+
3. 点 **「安装」**,装完 **重启 Coopanion**,去 **模型供应商 → 新建** 选它就能开喂啦!
|
|
20
22
|
|
|
21
|
-
|
|
23
|
+
**装不上?先看这两条避坑小纸条:**
|
|
24
|
+
- **提示找不到包 / 404**:多半是国内 npm 镜像还在同步中,去扩展页把 **「npm 源」留空保存**(切回官方源),或者等几分钟再试。
|
|
25
|
+
- **本机连不上 npm**:直接去 [Releases](https://github.com/Unnori/cortico-provider-gemini-gateway/releases) 下压缩包解压,在手动安装里切到 **「从本机目录安装」** 选文件夹照样能装。
|
|
22
26
|
|
|
23
|
-
|
|
27
|
+
---
|
|
24
28
|
|
|
25
|
-
|
|
29
|
+
## 🍱 三种喂食姿势,随切随用
|
|
26
30
|
|
|
27
|
-
|
|
28
|
-
- **使用官方 API Key(零 OAuth 授权)**:如不希望使用桌面 OAuth,可在第一步切换为 **「Web2API Gemini」**(认证模式 `api-key`)并填写自己的官方 API Key 或自建网关密钥。
|
|
29
|
-
- **CLI 方式配置**:将 [desktop-oauth.example.json](resources/desktop-oauth.example.json) 复制到端点目录并命名为 `desktop-oauth.json`,填入 `clientId`、可选 `clientSecret`、`scopes`、`authEndpoint` 和 `tokenEndpoint`。可通过 `authParams` 请求离线授权,通过 `tokenHeaders` 配置请求头,通过 `redirectHost` / `redirectPath` 覆盖回调 URI(默认 `http://127.0.0.1:<随机端口>/oauth/callback`,模板使用 `localhost` 与空路径 `""`)。
|
|
31
|
+
不用死记一堆 JSON 字段——在连接配置页 **第一步** 选好模式,**第二步** 和 **第三步** 的面板会自动跟着变身,用到啥才给你看啥。
|
|
30
32
|
|
|
31
|
-
|
|
33
|
+
### 1. 🐦 知更鸟模式(Robin 桌面 OAuth)
|
|
32
34
|
|
|
33
|
-
|
|
34
|
-
pnpm login /path/to/deployment/providers/endpoint
|
|
35
|
-
```
|
|
35
|
+
专门为想用消费级账号喂桌宠准备的省心模式:
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
- **先说安全底线**:出于公开分发规范,包里的 [desktop-oauth.example.json](resources/desktop-oauth.example.json) 默认把 `clientId` 和 `clientSecret` 留空,**绝不在安装包里夹带任何密钥**。打开第二步如果还没填过配置,输入框会自动展开,把你自己准备好的 OAuth 客户端 JSON 粘进去点 **「保存 OAuth 配置」**,就可以点 **「打开浏览器认证」** 登录啦(自己换设备或备份时,也能点 **「复制当前配置」** 一键带走)。
|
|
38
|
+
- **多号轮着喂,三种调度随你切**:往同一个供应商里想绑几个 Google 账号就绑几个,面板会按策略自动变样:
|
|
39
|
+
- **主备切号(故障转移)**:平时盯着主号吃,主号撞 429 限流、报异常或刷新失败,立刻自动冷却并无缝切给备用号顶上。
|
|
40
|
+
- **雨露均沾(轮询)**:取消主从高低,每个号平起平坐轮流上阵,卡片直接亮出大家的周额度条。
|
|
41
|
+
- **谁额度多先吃谁(额度优先)**:实时按 **每周剩余额度** 从多到少排队,粮最足的号自动顶到前面,尽量不把单号周额度吃穿。
|
|
42
|
+
- **几个超顺手的小功能**:
|
|
43
|
+
- **账号打码防社死**:所有邮箱全局默认打成 `5***3@gmail.com`,截图、录屏、发教程都安心;想核对原名时点一下 **「显示账号名」** 就能一键显隐。
|
|
44
|
+
- **条款状态小助手**:新绑进来的号,或者上游提示还没同意服务条款时,对应卡片会亮出 **「同意条款」** 按钮,点一下搞定,通过后按钮自动消失。
|
|
45
|
+
- **原生传图不串号**:发给桌宠看的图片会按账号单独缓存和上传,切号重试时绝不会拿 A 号的附件去撞 B 号的墙。
|
|
46
|
+
- **额度小看板**:第三步自带 **5 小时窗口 + 每周上限** 双进度条;小科普一下,Robin 是按算力权重扣的(上下文越长、开深度思考、用 Pro/Neon 档掉得越快;Fast/Hydrogen 档日常最划算;Flash-Lite 最轻,主额度吃空后通常也会自动回落到它兜底)。
|
|
38
47
|
|
|
39
|
-
|
|
48
|
+
---
|
|
40
49
|
|
|
41
|
-
|
|
50
|
+
### 2. 🔑 Web2API 模式(官方 API Key / 自建反代)
|
|
42
51
|
|
|
43
|
-
|
|
52
|
+
不想折腾 OAuth,只想拿个 Key 直接开聊?选它准没错:
|
|
44
53
|
|
|
45
|
-
|
|
54
|
+
1. 第一步切到 **「Web2API Gemini」**,Base URL 填官方 `https://generativelanguage.googleapis.com` 或者你自己的反代地址(比如 [`gemini-web2api-go`](https://github.com/zexadev/gemini-web2api-go))。
|
|
55
|
+
2. 第二步会自动变成 **「API 密钥配置」**,直接粘进官方 API Key 或反代 Key,按网关习惯选一下 `x-goog-api-key` / `Authorization: Bearer` / 自定义请求头预设,保存就能聊。
|
|
56
|
+
3. 密钥单独保存在端点数据目录里(仅当前用户可读),既不进代码仓库,也不会写死进配置模板。
|
|
46
57
|
|
|
47
|
-
|
|
58
|
+
---
|
|
48
59
|
|
|
49
|
-
|
|
60
|
+
### 3. 🛠️ 自定义 RPC 模式(给折腾党留的后门)
|
|
61
|
+
|
|
62
|
+
如果你自己手搓了会话式转发网关,第一步切到 **「自定义 RPC」**:
|
|
63
|
+
- 第二步管鉴权(API Key 或自定义 OAuth 都行)。
|
|
64
|
+
- 第三步直接变成 **「自定义路由与端点」**,生成、上传附件、删临时会话、查额度四条路由随便改。
|
|
65
|
+
|
|
66
|
+
顺手附一张进阶玩家用的字段速查表(WebUI 改完会自动写入 `config.json`,想手写也能参考 [provider.example.json](resources/provider.example.json)):
|
|
67
|
+
|
|
68
|
+
| 你想调啥 | 对应字段 | 怎么玩 |
|
|
69
|
+
| --- | --- | --- |
|
|
70
|
+
| 走哪种协议 | `options.protocol` | `robin`(知更鸟)/ `gemini`(原生 REST)/ `rpc`(自定义会话剧本) |
|
|
71
|
+
| 生成接口路由 | `options.generationEndpoint` | 支持相对路由、绝对 URL 和 `{model}` 占位符;不填会按协议自动套默认值 |
|
|
72
|
+
| 附件上传路由 | `options.uploadEndpoint` | 给自建 RPC / 反代用:multipart POST 发 `file` 和 `mimeType`,自动识别返回的 `id` / `attachmentId` / `fileUri` |
|
|
73
|
+
| 聊完自动清会话 | `options.deleteEndpoint` / `options.temporaryChat` | 默认开启无痕(`temporaryChat: true`);填了删除路由后,哪怕对话中途打断也会帮你把临时会话清干净 |
|
|
74
|
+
| 会话 ID 响应头 | `options.conversationHeader` | 网关把会话 ID 塞在响应头里时改这里,默认读 `x-conversation-id` |
|
|
75
|
+
| 自定义请求头 | `options.headers` / `options.secretHeaders` | 明文头放前者,不想明文暴露的头用后者映射到 `.env` 变量名 |
|
|
76
|
+
| 鉴权头格式 | `options.credentialHeader` / `options.authHeader` | API Key 默认走 `x-goog-api-key`,OAuth 默认走 `Authorization: Bearer `,随时可改 |
|
|
77
|
+
| 模型目录源 | `options.modelsDevUrl` / `options.openRouterUrl` | 默认自动拉 `models.dev`(失败兜底 `OpenRouter`,缓存 24h);未收录的 `gemini-*` 自动按 1M 上下文 / 64K 输出基线兜底 |
|
|
78
|
+
|
|
79
|
+
> 协议实现细节都整理在 [docs/DESKTOP_OAUTH.md](docs/DESKTOP_OAUTH.md) 和 [docs/GEMINI_REST.md](docs/GEMINI_REST.md) 里,折腾魔改时可以当字典翻;另外还支持直接 `import { GatewayClient }` 自己写 `encodeRequest` / `decodeEvent` 接奇奇怪怪的网关格式。
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## 💻 命令行 & 开发者小工具
|
|
84
|
+
|
|
85
|
+
- **纯命令行登录 OAuth**(跑独立脚本时会自动读 `HTTPS_PROXY` / `HTTP_PROXY` 和 Windows 系统代理,记得让代理放行 `localhost` 回环回调):
|
|
86
|
+
```sh
|
|
87
|
+
pnpm login /path/to/deployment/providers/<端点目录>
|
|
88
|
+
```
|
|
89
|
+
令牌会自动存在端点目录的 `oauth-accounts.json`(并同步主号到 `oauth-tokens.json`),快过期自动续期,401 自动抢救重放一次。
|
|
90
|
+
|
|
91
|
+
- **本地改代码 & 跑体检**:
|
|
92
|
+
```sh
|
|
93
|
+
pnpm install
|
|
94
|
+
pnpm verify # 一键打 WebUI 包 + 双向 TS 类型检查 + 跑全套单元测试
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## ⚠️ 温馨小提醒
|
|
100
|
+
|
|
101
|
+
- **知更鸟(Robin)模式**走的是非官方消费级接口,请合理控制频率、善用多账号分摊,别把心爱的账号累到吃红牌;要绝对稳妥直接切 **Web2API 模式** 上官方 API Key 就好。
|
|
102
|
+
- 本扩展采用 **MIT** 协议开源,欢迎提 Issue 或一起来玩。
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
<p align="center">
|
|
107
|
+
Made with ❤️ by <strong>云纪&云洄</strong>
|
|
108
|
+
</p>
|
package/assets/icon.png
ADDED
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "cortico-provider-gemini-gateway",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"type": "module",
|
|
5
|
-
"description": "
|
|
5
|
+
"description": "### 📦**Gemini 多合一粮仓(Robin / Web2API / 自定义 RPC)**\n给自家桌宠搭的三合一 Gemini 喂食通道,WebUI 面板随切随用:\n- **🐦 知更鸟模式(Robin)**:支持绑多个号轮着喂(主备切号 / 雨露均沾 / 谁额度多先吃谁),自带 5h & 周额度小看板、原生传图和账号打码防社死。\n- **🔑 Web2API 模式**:切过去直接填官方 Gemini API Key 或自建反代 Key,零门槛开箱即用。\n- **🛠️ 自定义 RPC**:给喜欢自己搭网关的折腾党留的后门。",
|
|
6
6
|
"author": "云纪&云洄",
|
|
7
7
|
"license": "MIT",
|
|
8
8
|
"repository": {
|
|
@@ -31,15 +31,16 @@
|
|
|
31
31
|
"cortico": {
|
|
32
32
|
"kind": "provider",
|
|
33
33
|
"api": 6,
|
|
34
|
-
"displayName": "
|
|
34
|
+
"displayName": "🐦 Gemini 多合一粮仓",
|
|
35
|
+
"icon": "assets/icon.png",
|
|
35
36
|
"locales": {
|
|
36
37
|
"zh": {
|
|
37
|
-
"displayName": "Gemini
|
|
38
|
-
"description": "
|
|
38
|
+
"displayName": "🐦 Gemini 多合一粮仓",
|
|
39
|
+
"description": "### 📦**Gemini 多合一粮仓(Robin / Web2API / 自定义 RPC)**\n给自家桌宠搭的三合一 Gemini 喂食通道,WebUI 面板随切随用:\n- **🐦 知更鸟模式(Robin)**:支持绑多个号轮着喂(主备切号 / 雨露均沾 / 谁额度多先吃谁),自带 5h & 周额度小看板、原生传图和账号打码防社死。\n- **🔑 Web2API 模式**:切过去直接填官方 Gemini API Key 或自建反代 Key,零门槛开箱即用。\n- **🛠️ 自定义 RPC**:给喜欢自己搭网关的折腾党留的后门。"
|
|
39
40
|
},
|
|
40
41
|
"en": {
|
|
41
|
-
"displayName": "
|
|
42
|
-
"description": "Gemini Robin desktop
|
|
42
|
+
"displayName": "🐦 Gemini All-in-One Feeder",
|
|
43
|
+
"description": "### 📦**Gemini All-in-One Gateway (Robin / Web2API / Custom RPC)**\nA 3-in-1 Gemini feeder for your Cortico desktop companion with adaptive WebUI panels:\n- **🐦 Robin Mode**: Multi-account OAuth pool (failover / round-robin / weekly-quota-first), 5h & weekly quota dashboard, native image upload, and one-click email masking.\n- **🔑 Web2API Mode**: Paste an official Gemini API Key or self-hosted proxy key and start right away.\n- **🛠️ Custom RPC**: Flexible routing and headers for self-hosted gateway tinkerers."
|
|
43
44
|
}
|
|
44
45
|
},
|
|
45
46
|
"tags": [
|
|
@@ -51,6 +52,7 @@
|
|
|
51
52
|
"webUiStyle": "dist/webui.css"
|
|
52
53
|
},
|
|
53
54
|
"files": [
|
|
55
|
+
"assets",
|
|
54
56
|
"src",
|
|
55
57
|
"dist",
|
|
56
58
|
"resources",
|