@bokutake/dsh-connect-qoder 0.0.0-stage → 1.28.0
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 +4860 -0
- package/LICENSE +21 -0
- package/LICENSE-MODIFICATIONS.md +60 -0
- package/README.en.md +492 -0
- package/README.md +498 -2
- package/THIRD_PARTY_NOTICES.md +60 -0
- package/cordis.patch.yml +12 -0
- package/docs/DESIGN.md +249 -0
- package/docs/DSH-0.2.1-RC1-FOLLOWUP.md +348 -0
- package/docs/DSH-0.2.2-RC1-FOLLOWUP.md +328 -0
- package/docs/DSH-0.2.2-RC2-FOLLOWUP.md +342 -0
- package/docs/DSH-0.2.2-RC3-FOLLOWUP.md +317 -0
- package/docs/DSH-0.2.2-RC5-FOLLOWUP.md +219 -0
- package/docs/PAT.md +191 -0
- package/docs/PRIVACY.md +109 -0
- package/docs/PROMO_BADGE.md +293 -0
- package/docs/assets/dsh-connect-qoder-composer-credits.png +0 -0
- package/docs/assets/dsh-connect-qoder-model-management.png +0 -0
- package/docs/assets/dsh-connect-qoder-model-picker.png +0 -0
- package/docs/assets/dsh-connect-qoder-promo-badge.png +0 -0
- package/docs/assets/dsh-connect-qoder-settings-page.png +0 -0
- package/docs/assets/dsh-connect-qoder-usage-card.png +0 -0
- package/docs/issues/magpie-330-billing-count.md +91 -0
- package/icons/dsh-connect-qoder-128.png +0 -0
- package/icons/dsh-connect-qoder-64.png +0 -0
- package/lib/bin.d.ts +26 -0
- package/lib/bin.js +219 -0
- package/lib/client.js +9252 -0
- package/lib/host-heartbeat-Daj8rZV0.js +4497 -0
- package/lib/index.d.ts +872 -0
- package/lib/index.js +6567 -0
- package/lib/transfer-pMn4lOHy.js +171 -0
- package/package.json +151 -4
- package/screenshots.json +8 -0
package/lib/index.d.ts
ADDED
|
@@ -0,0 +1,872 @@
|
|
|
1
|
+
import z from "@deepseek-ai/schemastery";
|
|
2
|
+
import { RetryPolicyConfig } from "@deepseek-ai/dsh-llm";
|
|
3
|
+
import { Context } from "@deepseek-ai/cordis";
|
|
4
|
+
//#region src/device-identity.d.ts
|
|
5
|
+
/** 人工填写的覆盖值。任何一个字段缺席都退回该字段的默认来源。 */
|
|
6
|
+
interface QoderIdentityOverride {
|
|
7
|
+
machineId?: string;
|
|
8
|
+
machineToken?: string;
|
|
9
|
+
machineType?: string;
|
|
10
|
+
machineCode?: string;
|
|
11
|
+
}
|
|
12
|
+
//#endregion
|
|
13
|
+
//#region src/upstream.d.ts
|
|
14
|
+
type QoderRegion = 'cn' | 'global';
|
|
15
|
+
/** 上游错误分类,供 shim 映射为 DSH 可判定的 code。 */
|
|
16
|
+
type UpstreamErrorKind = 'network' | 'auth' | 'rate-limited' | 'invalid-request' | 'content-policy' | 'quota-exhausted' | 'transient' | 'unknown';
|
|
17
|
+
/**
|
|
18
|
+
* 一笔**专属积分包**(issue #38)—— 上游 `qoderUsage.dedicatedResourcePackages[]`。
|
|
19
|
+
*
|
|
20
|
+
* 国际版实测(`GET /sash/api/v2/me/usage`):
|
|
21
|
+
*
|
|
22
|
+
* ```json
|
|
23
|
+
* [{ "id": "pkg-example", "name": "act-example", "total": 888, "used": 0,
|
|
24
|
+
* "remaining": 888, "percentage": 0, "unit": "credits",
|
|
25
|
+
* "expiresAt": 1798732800000, "available": true,
|
|
26
|
+
* "status": "QUOTA_DETAIL_STATUS_ACTIVE",
|
|
27
|
+
* "displayLabels": [
|
|
28
|
+
* { "dimension": "title", "value": "sota model series",
|
|
29
|
+
* "valueI18n": { "en-US": "SOTA Exclusive Credits", "zh-CN": "SOTA 专属积分" } },
|
|
30
|
+
* { "dimension": "description", "value": "…",
|
|
31
|
+
* "valueI18n": { "en-US": "…", "zh-CN": "…" } } ] }]
|
|
32
|
+
* ```
|
|
33
|
+
*
|
|
34
|
+
* 三条「不用自己编」的性质,正是这个类型只透传、不解释的理由:
|
|
35
|
+
*
|
|
36
|
+
* - **名字上游自己就给了**(`displayLabels` 的 `valueI18n` 带 zh-CN / en-US),
|
|
37
|
+
* 所以 DTO 里存的是**两种语言的原文**,由界面按当前语言挑一条 —— 插件翻译
|
|
38
|
+
* 一个营销词只会在上游改词时落后;
|
|
39
|
+
* - 它有 `remaining` / `total`,能直接填读数;
|
|
40
|
+
* - 它有 `status`,`QUOTA_DETAIL_STATUS_ACTIVE` 以外的不该算。
|
|
41
|
+
*
|
|
42
|
+
* ⚠️ 国内版实测 `qoderUsage` 里**没有**这个键,所以这一整块天然只在国际版出现。
|
|
43
|
+
*/
|
|
44
|
+
interface QoderDedicatedPackage {
|
|
45
|
+
/** 上游的包 id(同一次报文内唯一;界面用它做 React key)。 */
|
|
46
|
+
id: string;
|
|
47
|
+
/** 上游给的**两种语言**标题;两边都没有时才缺席(那时界面不外显这一个包)。 */
|
|
48
|
+
title?: {
|
|
49
|
+
zh?: string | undefined;
|
|
50
|
+
en?: string | undefined;
|
|
51
|
+
} | undefined;
|
|
52
|
+
/** 上游给的双语说明(「在模型选择器中选择 Sonus 时优先抵扣」)。 */
|
|
53
|
+
description?: {
|
|
54
|
+
zh?: string | undefined;
|
|
55
|
+
en?: string | undefined;
|
|
56
|
+
} | undefined;
|
|
57
|
+
/**
|
|
58
|
+
* 剩余额度;`undefined` = 上游这一行没报(不是 0)。
|
|
59
|
+
*
|
|
60
|
+
* 与 `creditsOf` 里的积分包同一条规矩:0 是关于账号的一个断言,缺席只是
|
|
61
|
+
* 「这次没读到」。
|
|
62
|
+
*/
|
|
63
|
+
remaining?: number | undefined;
|
|
64
|
+
total?: number | undefined;
|
|
65
|
+
/** 这一包的到期时刻(ms)。有它就能放进悬停,不必另编一个倒计时。 */
|
|
66
|
+
expiresAtMs?: number | undefined;
|
|
67
|
+
/** 上游的原始 `status`(`QUOTA_DETAIL_STATUS_ACTIVE` 等),原样保留。 */
|
|
68
|
+
status?: string | undefined;
|
|
69
|
+
}
|
|
70
|
+
/** 用量信息(sash/api/v2/me/usage 的 qoderUsage 形状,官方 SDK UsageInfo 核对)。 */
|
|
71
|
+
interface QoderUsage {
|
|
72
|
+
userType?: string | undefined;
|
|
73
|
+
expiresAt?: number | undefined;
|
|
74
|
+
upgradeUrl?: string | undefined;
|
|
75
|
+
userQuota?: {
|
|
76
|
+
total?: number | undefined;
|
|
77
|
+
used?: number | undefined;
|
|
78
|
+
remaining?: number | undefined;
|
|
79
|
+
percentage?: number | undefined;
|
|
80
|
+
} | undefined;
|
|
81
|
+
addOnQuota?: {
|
|
82
|
+
total?: number | undefined;
|
|
83
|
+
used?: number | undefined;
|
|
84
|
+
remaining?: number | undefined;
|
|
85
|
+
percentage?: number | undefined;
|
|
86
|
+
detailUrl?: string | undefined;
|
|
87
|
+
} | undefined;
|
|
88
|
+
orgResourcePackage?: {
|
|
89
|
+
used?: number | undefined;
|
|
90
|
+
cap?: number | undefined;
|
|
91
|
+
remaining?: number | undefined;
|
|
92
|
+
percentage?: number | undefined;
|
|
93
|
+
available?: boolean | undefined;
|
|
94
|
+
} | undefined;
|
|
95
|
+
/**
|
|
96
|
+
* 专属积分包(issue #38)。**只有国际版下发**;国内版实测没有这个键。
|
|
97
|
+
*
|
|
98
|
+
* 缺席 = 这个账号没有(或上游这次没给),不是「读失败」——两者的处理不同:
|
|
99
|
+
* 前者界面不画那一列,后者与「积分读不出来」同路。
|
|
100
|
+
*/
|
|
101
|
+
dedicatedResourcePackages?: readonly QoderDedicatedPackage[] | undefined;
|
|
102
|
+
isQuotaExceeded?: boolean;
|
|
103
|
+
}
|
|
104
|
+
//#endregion
|
|
105
|
+
//#region src/promo.d.ts
|
|
106
|
+
/**
|
|
107
|
+
* Qoder 的活动优惠规则(`promotion`):解析与「此刻是否成立」的判定。
|
|
108
|
+
*
|
|
109
|
+
* 三件事都在这里,且都围绕**不替上游说话**:
|
|
110
|
+
*
|
|
111
|
+
* 1. 什么是活动。`model/list` 的每个模型行自带一个 `promotion` 对象,里面既有
|
|
112
|
+
* 上游自己的文案(`badge.zh` / `badge.en`、`description`),也有规则本身
|
|
113
|
+
* (`rule_id`、`discount_factor`、`window_start/end`、`timezone`)。实测两个
|
|
114
|
+
* 区域都是同一套 schema,只有时区与文案不同(国内 `Asia/Shanghai`,国际
|
|
115
|
+
* `Asia/Singapore`;国内写「错峰 4 折」,国际写「错峰 4 折」/「Off-Peak 60%
|
|
116
|
+
* off」)。**文案是上游给的,插件不翻译、不改写**——这与 workbuddy 的促销
|
|
117
|
+
* 徽标同规,也与 Trae 那边故意留白的做法相反(Trae 只发数字,所以那边只能
|
|
118
|
+
* 自造「闲时」这类词)。
|
|
119
|
+
* 2. 什么时候画。上游同时给了一个服务端算好的 `active` 和一个墙钟时段。实测
|
|
120
|
+
* 2026-10-21T16:2x(窗口 22:00–08:00 之外)两个区域全部 `active: false`,说明
|
|
121
|
+
* 它是**按当时那一刻算的**,不是常量;而目录是 DSH 进程启动时取的一份内存快照
|
|
122
|
+
* (之后只有点「从 Qoder 刷新」才换)。所以:**有窗口就用窗口**(渲染时刻现算,
|
|
123
|
+
* 快照多旧都不影响),没有窗口才退回 `active`。若把 `active` 也当成门,白天启动
|
|
124
|
+
* 的进程会拿着 16:00 的 `false` 一直用到退出,22:00 窗口开了也不画——这个功能
|
|
125
|
+
* 对「一直开着 DSH」的用户等于不存在。反过来,窗口是「此刻」的纯函数,不会因为
|
|
126
|
+
* 快照旧而说错话。
|
|
127
|
+
* 3. 时段怎么算。`window_start` / `window_end` 是**上游声明时区里的墙钟时间**
|
|
128
|
+
* (`HH:MM`,终点允许 `24:00`),且可以跨零点(22:00→08:00)。所以判定必须按那条
|
|
129
|
+
* 记录的 `timezone` 求当地分钟数,不能拿浏览器本地时间直接比——用户在 UTC+0 打开
|
|
130
|
+
* 卡片时,「22:00–08:00」说的是 Asia/Shanghai 的 22:00,不是他的。时区读不懂就
|
|
131
|
+
* 不画(退回本地时区会让跨零点窗口错位几小时,比不画更糟)。
|
|
132
|
+
*
|
|
133
|
+
* 这里**不做**的事:不猜活动意图、不从 `discount_factor` 反推文案、不把
|
|
134
|
+
* `link_url` 变成可点击动作(卡片上的胶囊只是提示)、不在解析时挑定一枚
|
|
135
|
+
* 徽标(判定放在渲染时刻,理由同 workbuddy 的 `selectPromoBadge`)。
|
|
136
|
+
*
|
|
137
|
+
* 折扣数字(`discount_factor` / `before_promotion_price_factor`)现在**保留**:
|
|
138
|
+
* 它不是用来反推文案的(文案仍原样取上游),而是给 {@link displayMultiplierOf}
|
|
139
|
+
* 在渲染时刻算「活动实际倍率」——issue #41 里 Qoder 官方显示 `x0.00` 而插件只
|
|
140
|
+
* 显示基准价 `0.1x` 的那处不一致。计算只在 UI 层用,计费与落盘仍走基准价。
|
|
141
|
+
*
|
|
142
|
+
* @module dsh-connect-qoder/promo
|
|
143
|
+
*/
|
|
144
|
+
/** 上游的中英双语字段(`badge` / `description` / `link_url` 都是这个形状)。 */
|
|
145
|
+
interface QoderPromoLabel {
|
|
146
|
+
zh?: string;
|
|
147
|
+
en?: string;
|
|
148
|
+
}
|
|
149
|
+
/** 上游声明的时段(`window_start` / `window_end`,墙钟 `HH:MM`,可跨零点)。 */
|
|
150
|
+
interface QoderPromoWindow {
|
|
151
|
+
/** 原样保留的起点文本(`22:00`)。 */
|
|
152
|
+
start: string;
|
|
153
|
+
/** 原样保留的终点文本(`08:00`)。 */
|
|
154
|
+
end: string;
|
|
155
|
+
/** 起点的当天分钟数(0–1439)。 */
|
|
156
|
+
startMinute: number;
|
|
157
|
+
/** 终点的当天分钟数(0–1439)。 */
|
|
158
|
+
endMinute: number;
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* 一条已解析的活动规则。
|
|
162
|
+
*
|
|
163
|
+
* 字段名用 camelCase(上游是 snake_case),存储与投影都只认这一种形状——落盘
|
|
164
|
+
* 的形状与运行期的形状是同一个,读回时不需要第二套解析(`readPromotion`)。
|
|
165
|
+
*/
|
|
166
|
+
interface QoderPromotion {
|
|
167
|
+
/**
|
|
168
|
+
* 上游在**取目录那一刻**算出的「此刻生效」。
|
|
169
|
+
*
|
|
170
|
+
* 它是一份快照:目录在 DSH 进程启动时取一次,之后只有点「从 Qoder 刷新」才会换。
|
|
171
|
+
* 所以只在**没有窗口声明**时拿它作依据(那种活动没有起止,快照旧了也不会错);
|
|
172
|
+
* 有窗口时窗口说了算,见 `promoLiveAt`。
|
|
173
|
+
*/
|
|
174
|
+
active: boolean;
|
|
175
|
+
/** 上游自己的徽标文案。没有它就没有可画的东西,解析直接丢弃。 */
|
|
176
|
+
badge: QoderPromoLabel;
|
|
177
|
+
/** 上游自己的悬停说明。 */
|
|
178
|
+
description?: QoderPromoLabel;
|
|
179
|
+
/** 上游声明的时区(`Asia/Shanghai`);缺席时按账号所在区域兜底。 */
|
|
180
|
+
timeZone?: string;
|
|
181
|
+
/** 上游声明的每日时段;缺席表示没有窗口声明。 */
|
|
182
|
+
window?: QoderPromoWindow;
|
|
183
|
+
/**
|
|
184
|
+
* 上游**声明了**窗口但读不懂(`24:30`、只给一端、`HH:MM` 以外的写法)。
|
|
185
|
+
*
|
|
186
|
+
* 与「没有窗口声明」是两件事:读不懂的窗口不能被当成「全天」,也不能退回去信
|
|
187
|
+
* `active`——那会把一句读不懂的规则放大成整天都在打折。这种条目一律不画。
|
|
188
|
+
*/
|
|
189
|
+
windowUnreadable?: boolean;
|
|
190
|
+
/** 上游的活动说明页。 */
|
|
191
|
+
link?: QoderPromoLabel;
|
|
192
|
+
/**
|
|
193
|
+
* 上游的折扣系数(`discount_factor`,形如 `0.4` = 基准价打四折、`0` = 免费)。
|
|
194
|
+
*
|
|
195
|
+
* 只给 {@link displayMultiplierOf} 算 UI 展示用倍率,绝不参与计费/落盘。
|
|
196
|
+
* 缺席(上游没给或不是有限数)≠ 0:前者是「不知道有没有折扣」,回退基准价。
|
|
197
|
+
*/
|
|
198
|
+
discountFactor?: number;
|
|
199
|
+
/**
|
|
200
|
+
* 上游声明的「折前倍率」(`before_promotion_price_factor`,形如 `0.5`)。
|
|
201
|
+
*
|
|
202
|
+
* **只作记录,不参与计算**:`displayMultiplierOf` 的公式是「当前基准价 ×
|
|
203
|
+
* `discount_factor`」(实测 `0.5 × 0.4 = 0.2`,见 PROMO_BADGE.md §5.1)。不拿
|
|
204
|
+
* 这个字段去校验基准价——一旦上游给的值与目录里的 `price_factor` 对不上
|
|
205
|
+
* (改价、或限时免费这种特价活动),用它当门会把本来该显示的 `x0.00` 又压
|
|
206
|
+
* 回基准价,正是 issue #41 要修的病。留着它是为了不丢上游声明,供日后复核。
|
|
207
|
+
*/
|
|
208
|
+
beforePromotionPriceFactor?: number;
|
|
209
|
+
}
|
|
210
|
+
//#endregion
|
|
211
|
+
//#region src/catalog.d.ts
|
|
212
|
+
interface QoderModelInfo {
|
|
213
|
+
key: string;
|
|
214
|
+
displayName: string;
|
|
215
|
+
/** 积分倍率(模型名内嵌 `· xN.NN`)。 */
|
|
216
|
+
priceFactor: number;
|
|
217
|
+
/** 原生输入窗口(由 context_config 首档或 max_input_tokens 决定)。 */
|
|
218
|
+
contextWindow: number;
|
|
219
|
+
maxOutputTokens: number;
|
|
220
|
+
supportsImages: boolean;
|
|
221
|
+
supportsThinking: boolean;
|
|
222
|
+
/** 可完全关闭思考(thinking_config.disabled 存在)。 */
|
|
223
|
+
canDisableThinking: boolean;
|
|
224
|
+
/**
|
|
225
|
+
* 上游声明的思考强度档位(`thinking_config.enabled.efforts` 的键,按强度
|
|
226
|
+
* 升序)。不存在时该模型没有可选档位,卡片不渲染这一项。
|
|
227
|
+
*
|
|
228
|
+
* 实测 Qoder 的档位名不统一:Qwen 系用 `low / medium / xhigh`,DeepSeek/GLM
|
|
229
|
+
* 用 `low / high / max`——所以只做展示,不做跨模型比较。上游给出的键序也不
|
|
230
|
+
* 可靠(JSON 里可能先出现 `xhigh`),必须按语义排序后再显示。
|
|
231
|
+
*/
|
|
232
|
+
thinkingEfforts?: string[];
|
|
233
|
+
/** 上游标为默认的档位(`efforts[x].is_default`)。 */
|
|
234
|
+
defaultThinkingEffort?: string;
|
|
235
|
+
isDefault: boolean;
|
|
236
|
+
isFree: boolean;
|
|
237
|
+
isNew: boolean;
|
|
238
|
+
/**
|
|
239
|
+
* 网关声明可用的上下文档位(`context_config` 各项的 token_count,升序)。
|
|
240
|
+
* 不存在时无档位可选,卡片不渲染预算选择器。
|
|
241
|
+
*/
|
|
242
|
+
contextTiers?: number[];
|
|
243
|
+
/**
|
|
244
|
+
* 上游的活动优惠规则(`model/list` 每行的 `promotion`)。
|
|
245
|
+
*
|
|
246
|
+
* 这里存的是**解析后**的规则(`src/promo.ts` 的 `QoderPromotion`),不是上游的
|
|
247
|
+
* snake_case 原文:落盘、投影、卡片三处只认一种形状,读回时用 `readPromotion`
|
|
248
|
+
* 校验,不会出现两套解析各自漂移。
|
|
249
|
+
*
|
|
250
|
+
* 缺席 = 上游没给活动(或给的活动没有可显示的文案)。**不要**从
|
|
251
|
+
* `price_factor` 反推活动——倍率是基础价,活动是另一层,混起来会画出上游没
|
|
252
|
+
* 说的折扣。
|
|
253
|
+
*/
|
|
254
|
+
promotion?: QoderPromotion;
|
|
255
|
+
}
|
|
256
|
+
//#endregion
|
|
257
|
+
//#region src/status-paths.d.ts
|
|
258
|
+
/**
|
|
259
|
+
* The project's public repository.
|
|
260
|
+
*
|
|
261
|
+
* Lives here rather than beside one component because TWO sections link to it
|
|
262
|
+
* — the model section and the account pool — and a second copy of a URL is a
|
|
263
|
+
* second thing to forget when it moves. Node-free and side-effect free, so it
|
|
264
|
+
* costs nothing on the Host side either.
|
|
265
|
+
*
|
|
266
|
+
* **指向本分叉,不是上游**:这个链接是给用户点「项目主页 / 反馈问题」用的,
|
|
267
|
+
* 指到已停止维护的上游只会让人把 issue 提给一个不再看的仓库。上游地址仍然
|
|
268
|
+
* 保留在 README 与 `LICENSE-MODIFICATIONS.md` 里(署名与来源要留),只是
|
|
269
|
+
* 不复用这个「当前项目」常量。
|
|
270
|
+
*/
|
|
271
|
+
declare const QODER_GITHUB_URL = "https://github.com/bokutake/dsh-connect-qoder";
|
|
272
|
+
/**
|
|
273
|
+
* One credit bucket as the card renders it, node-free.
|
|
274
|
+
*
|
|
275
|
+
* ⚠️ **没有 `expiresAtMs`,也没有 `monthly`**(issue #31 的两条)。
|
|
276
|
+
*
|
|
277
|
+
* - `expiresAtMs` 曾经挂在这里,但上游那个字段是 `qoderUsage.expiresAt` ——
|
|
278
|
+
* 账号级**套餐 / 14 天试用**的到期,不是「这个积分包过期」。`userQuota` /
|
|
279
|
+
* `addOnQuota` 自己都不带任何到期字段。把它挂在一个叫「积分包」的类型上,
|
|
280
|
+
* 等于用一个误导性的名字请后来者再踩一次。套餐到期改在 {@link QoderWebCredits}
|
|
281
|
+
* 上单出 `planExpiresAtMs`。
|
|
282
|
+
* - `monthly` 在 Qoder 这边**恒为 `false`**(没有按月刷新的桶),它没有编码
|
|
283
|
+
* 任何信息。family 的约定是「有按月刷新的桶时,用 `monthly` + `cycleRefreshMs`
|
|
284
|
+
* 这一对表达」,不是「每个连接器都必须有」。留着它只会让读者无法区分
|
|
285
|
+
* 「不按月刷新」与「作者没填」。
|
|
286
|
+
*/
|
|
287
|
+
interface QoderWebCreditPackage {
|
|
288
|
+
/** Stable bucket key — 'base' | 'addon' | 'org'; the card localizes it. */
|
|
289
|
+
packageName: string;
|
|
290
|
+
remain: number;
|
|
291
|
+
size: number;
|
|
292
|
+
}
|
|
293
|
+
/** Aggregated credit answer rendered by the plugin card. */
|
|
294
|
+
interface QoderWebCredits {
|
|
295
|
+
total: number;
|
|
296
|
+
packages: readonly QoderWebCreditPackage[];
|
|
297
|
+
/**
|
|
298
|
+
* 3 天内到期的积分**金额**(不是包数)。
|
|
299
|
+
*
|
|
300
|
+
* 同名二义曾经存在(issue #31 附带那条):`creditsOf` 累加的是**包数**,而
|
|
301
|
+
* `poolMemberCredits` 累加的是**金额**,卡片文案 `row.poolCreditSoon` 写的是
|
|
302
|
+
* 「{count} 积分 3 天内过期」—— 金额措辞。现在两处都只算金额,计数那一份
|
|
303
|
+
* 从 DTO 里删掉(它没有读者)。
|
|
304
|
+
*/
|
|
305
|
+
expiringSoon: number;
|
|
306
|
+
/**
|
|
307
|
+
* 最早一批**积分**的到期时刻(ms)。只来自真正带到期语义的批次(签到批),
|
|
308
|
+
* 与套餐到期无关 —— 池排序的「临期紧急度」读的就是它。
|
|
309
|
+
*/
|
|
310
|
+
nearestExpiryMs?: number;
|
|
311
|
+
/**
|
|
312
|
+
* 账号级**套餐 / 试用**到期时刻(ms),来源是上游 `qoderUsage.expiresAt`。
|
|
313
|
+
*
|
|
314
|
+
* issue #31 的语义拆分:这个值此前伪装成 `packages[].expiresAtMs`,于是
|
|
315
|
+
* 「14 天试用到期」被显示成「积分包到期」。它与积分紧急度是两件事,所以既不进
|
|
316
|
+
* `expiringSoon`,也不进 `nearestExpiryMs`,更不参与池排序。
|
|
317
|
+
*/
|
|
318
|
+
planExpiresAtMs?: number;
|
|
319
|
+
}
|
|
320
|
+
/**
|
|
321
|
+
* 一笔专属积分包,面板要画的那几个字段(issue #38)。
|
|
322
|
+
*
|
|
323
|
+
* 与上游 DTO(`QoderDedicatedPackage`)分开声明,理由与
|
|
324
|
+
* {@link QoderWebProbeOutcome} 相同:`status-paths.ts` 是**无 node 依赖的桥**,
|
|
325
|
+
* 客户端会 import 它,不该顺着类型把上游模块(`node:http`、cosy 签名那一套)
|
|
326
|
+
* 拖进浏览器包里。
|
|
327
|
+
*/
|
|
328
|
+
interface QoderWebDedicatedPackage {
|
|
329
|
+
/** 上游的包 id —— 同一次报文内唯一,界面拿它做 React key。 */
|
|
330
|
+
id: string;
|
|
331
|
+
/**
|
|
332
|
+
* 上游自己的双语标题(`SOTA 专属积分` / `SOTA Exclusive Credits`)。
|
|
333
|
+
*
|
|
334
|
+
* **插件不翻译它。** 上游在 `displayLabels[].valueI18n` 里已经给了两种语言,
|
|
335
|
+
* 自己再写一份译文只会在上游改词时落后一步,而这是个营销词、不是术语。
|
|
336
|
+
*/
|
|
337
|
+
title?: {
|
|
338
|
+
zh?: string;
|
|
339
|
+
en?: string;
|
|
340
|
+
};
|
|
341
|
+
/** 上游自己的双语说明(「在模型选择器中选择 Sonus 时优先抵扣该积分」)。 */
|
|
342
|
+
description?: {
|
|
343
|
+
zh?: string;
|
|
344
|
+
en?: string;
|
|
345
|
+
};
|
|
346
|
+
/** 剩余额度;缺席 = 上游这一行没报(**不是 0**)。 */
|
|
347
|
+
remaining?: number;
|
|
348
|
+
total?: number;
|
|
349
|
+
/** 这一包的到期时刻(ms)。 */
|
|
350
|
+
expiresAtMs?: number;
|
|
351
|
+
}
|
|
352
|
+
/**
|
|
353
|
+
* Outcome vocabulary of one model probe, shared by the Host and the card.
|
|
354
|
+
*
|
|
355
|
+
* Mirrors `QoderProbeOutcome` in `./probe.ts`; kept as its own declaration
|
|
356
|
+
* here because this module is the node-free bridge and must not import the
|
|
357
|
+
* Host-side probe module.
|
|
358
|
+
*/
|
|
359
|
+
type QoderWebProbeOutcome = 'ok' | 'rate-limited' | 'out-of-credit' | 'credential-rejected' | 'policy-rejected' | 'unavailable' | 'queued' | 'not-found' | 'failed';
|
|
360
|
+
/**
|
|
361
|
+
* 最近一次**上游明说**的额度耗尽(对话路径上 `quota-exhausted` 的那次失败)。
|
|
362
|
+
*
|
|
363
|
+
* 为什么需要它:逐账号的 `out-of-credit` 只活在账号池的视图里,而池的记账有
|
|
364
|
+
* 两道门(池关不记盘、非成员不记)——池关着时一次 code 110 的失败在任何 UI 上
|
|
365
|
+
* 都无处可看(0.7.x 时代的「今日额度疑似已用尽」胶囊就是干这个的,后来随本地
|
|
366
|
+
* 计数器一起被拆掉了)。这份记录按**区域**存、与池开关无关,是那条信息现在的
|
|
367
|
+
* 出口。
|
|
368
|
+
*
|
|
369
|
+
* 注意它是**事实**不是推断:只有上游的业务码命中配额族(110/113/118/…)才产生
|
|
370
|
+
* 它,措辞用「上游报」,不用旧版的「疑似(本地统计)」。
|
|
371
|
+
*/
|
|
372
|
+
interface QoderWebQuotaExhaustion {
|
|
373
|
+
/** 上游业务码(如 `110` 当日用量 / `118` 个人 Credits 耗尽),读不到则缺席。 */
|
|
374
|
+
code?: string;
|
|
375
|
+
/** 脱敏后的上游原文(与探针 message 同一处理,pt- 形态绝不落盘)。 */
|
|
376
|
+
message: string;
|
|
377
|
+
/** 上游报出这件事的时刻;展示口径是「最近一次」。 */
|
|
378
|
+
atMs: number;
|
|
379
|
+
}
|
|
380
|
+
//#endregion
|
|
381
|
+
//#region src/version.d.ts
|
|
382
|
+
/**
|
|
383
|
+
* Package version, injected at build time by `tsdown.config.ts`.
|
|
384
|
+
*
|
|
385
|
+
* 参考:dsh-connect-workbuddy(MIT)——版本由构建期 define 注入,而非
|
|
386
|
+
* 运行时读 package.json(发布包只含 lib/,不含可解析的 package.json 路径)。
|
|
387
|
+
*
|
|
388
|
+
* @module dsh-connect-qoder/version
|
|
389
|
+
*/
|
|
390
|
+
/** The npm package version this build was produced from. */
|
|
391
|
+
declare const QODER_CONNECT_VERSION: string;
|
|
392
|
+
//#endregion
|
|
393
|
+
//#region src/account-pool.d.ts
|
|
394
|
+
/**
|
|
395
|
+
* Which of the pool's writers produced a measurement.
|
|
396
|
+
*
|
|
397
|
+
* `test-batch` — the user pressed "test", so the outcome is a deliberate
|
|
398
|
+
* measurement of the target model.
|
|
399
|
+
* `live-request` — a real chat request failed and its failure was recorded so
|
|
400
|
+
* the NEXT request starts from a measurement instead of rediscovering the
|
|
401
|
+
* same wall.
|
|
402
|
+
*/
|
|
403
|
+
type QoderPoolProbeSource = 'test-batch' | 'live-request';
|
|
404
|
+
/**
|
|
405
|
+
* 一条测量的 `retryAtMs` 是谁给的(issue #32)。
|
|
406
|
+
*
|
|
407
|
+
* `upstream-reported` 是上游自己申报的等待时长(排队信封),`quota-refresh`
|
|
408
|
+
* 是从签到快照推出来的当日窗口结束时刻 —— 后者是**本地推算**,卡片必须说清楚,
|
|
409
|
+
* 否则用户会把「我们猜的」读成「上游说的」。`retry-after` / `upstream-message`
|
|
410
|
+
* 来自探针路径(HTTP 头、失败报文里的重置句)。
|
|
411
|
+
*
|
|
412
|
+
* `unknown-cooldown` 与前面四个**语义不同**,务必看清:它表示 `retryAtMs`
|
|
413
|
+
* **缺席**,这次排除用的完全是本地兜底节奏({@link POOL_UNKNOWN_COOLDOWN_MS}),
|
|
414
|
+
* 上游没有、快照也没有给出任何时刻。它存在的唯一理由是让「我们在按 30 分钟
|
|
415
|
+
* 自己重试」这件事在数据里留下痕迹 —— 只看着 `retryAtMs` 缺席的话,它与
|
|
416
|
+
* 「上游没说、我们也不打算再试」完全无法区分,而实际上系统会拿真实聊天请求
|
|
417
|
+
* 每 30 分钟撞一次。
|
|
418
|
+
*/
|
|
419
|
+
type QoderPoolProbeRetrySource = 'retry-after' | 'upstream-message' | 'quota-refresh' | 'upstream-reported' | 'unknown-cooldown';
|
|
420
|
+
/**
|
|
421
|
+
* What the pool knows about ONE account's last test of the target model.
|
|
422
|
+
*
|
|
423
|
+
* `undefined` means "never tested", deliberately distinct from every measured
|
|
424
|
+
* outcome: an untested account is a candidate (the user may want to use it
|
|
425
|
+
* now) whereas a measured failure is not.
|
|
426
|
+
*/
|
|
427
|
+
interface QoderPoolProbe {
|
|
428
|
+
outcome: QoderWebProbeOutcome;
|
|
429
|
+
/** When this measurement was taken, in epoch ms. */
|
|
430
|
+
atMs: number;
|
|
431
|
+
/**
|
|
432
|
+
* WHAT WROTE THIS MEASUREMENT. Absent for any measurement written before the
|
|
433
|
+
* field existed, so old probe files stay readable — an absent source means
|
|
434
|
+
* "unknown", never a guess.
|
|
435
|
+
*/
|
|
436
|
+
source?: QoderPoolProbeSource;
|
|
437
|
+
/**
|
|
438
|
+
* When this account may be usable again, when the upstream stated a time.
|
|
439
|
+
* ABSENT when the upstream named no time — never a locally invented one.
|
|
440
|
+
*/
|
|
441
|
+
retryAtMs?: number;
|
|
442
|
+
/**
|
|
443
|
+
* WHICH source supplied {@link retryAtMs}(issue #32)。
|
|
444
|
+
*
|
|
445
|
+
* 缺席 = 写这条记录的版本还没有这个字段(旧文件照常可读,卡片按「没说」处理)。
|
|
446
|
+
*/
|
|
447
|
+
retrySource?: QoderPoolProbeRetrySource;
|
|
448
|
+
/**
|
|
449
|
+
* 上游的排队信息(issue #26)。
|
|
450
|
+
*
|
|
451
|
+
* 缺席 = 上游没提排队。`queueCount` 是上游给的人头数,不是本地估的。
|
|
452
|
+
*/
|
|
453
|
+
queue?: {
|
|
454
|
+
queueCount?: number;
|
|
455
|
+
queueType?: string;
|
|
456
|
+
};
|
|
457
|
+
/**
|
|
458
|
+
* The upstream's own words on the failure, already redacted by the probe.
|
|
459
|
+
* ABSENT for a success.
|
|
460
|
+
*/
|
|
461
|
+
message?: string;
|
|
462
|
+
/**
|
|
463
|
+
* WHICH MODEL this measurement is about.
|
|
464
|
+
*
|
|
465
|
+
* Without it a probe is an unscoped verdict: the pool would take "model A
|
|
466
|
+
* worked, model B was rate-limited" and conclude the ACCOUNT is fine or
|
|
467
|
+
* broken regardless of what is being asked for. Qoder rate-limits per model,
|
|
468
|
+
* so the same PAT can be `ok` on one and `rate-limited` on another at the
|
|
469
|
+
* same instant.
|
|
470
|
+
*
|
|
471
|
+
* ABSENT means the writer did not record a model (records written before the
|
|
472
|
+
* field existed, and the live-request path, which knows the failure kind but
|
|
473
|
+
* not reliably which model was being asked for). Readers must treat absent
|
|
474
|
+
* as "applies to anything" — that is the old, coarser behaviour, not a
|
|
475
|
+
* claim that every model agrees.
|
|
476
|
+
*/
|
|
477
|
+
modelId?: string;
|
|
478
|
+
}
|
|
479
|
+
//#endregion
|
|
480
|
+
//#region src/credit-expiry.d.ts
|
|
481
|
+
/**
|
|
482
|
+
* 一次签到领到的积分批次。
|
|
483
|
+
*
|
|
484
|
+
* `validityDays` 缺席 = 上游这次没说有效天数(不猜)。`amount` 缺席 = 没说数额
|
|
485
|
+
* (只影响「临期多少分」,不影响「哪一批先过期」)。
|
|
486
|
+
*/
|
|
487
|
+
interface QoderCheckinBatch {
|
|
488
|
+
/** 领取时刻(epoch ms)。这是上游没给的 `claimAtMs`,由本地在领到的那一刻记下。 */
|
|
489
|
+
atMs: number;
|
|
490
|
+
/** 有效天数,来自 `benefit.validity.days`。 */
|
|
491
|
+
validityDays: number;
|
|
492
|
+
/** 这一批的数额,来自 `benefit.amount`。 */
|
|
493
|
+
amount?: number;
|
|
494
|
+
}
|
|
495
|
+
//#endregion
|
|
496
|
+
//#region src/index.d.ts
|
|
497
|
+
declare const name = "dsh-connect-qoder";
|
|
498
|
+
/** The model registry and settings service required before providers register. */
|
|
499
|
+
declare const inject: string[];
|
|
500
|
+
/**
|
|
501
|
+
* 给一个 promise 加硬超时,超时**按「这次没读到」处理**(resolve undefined),
|
|
502
|
+
* 而不是抛错。
|
|
503
|
+
*
|
|
504
|
+
* 两条理由:
|
|
505
|
+
* 1. `fetchUsage` 先 `ensureSession()` 再带 signal 打 sash,signal 只管得住后半段
|
|
506
|
+
* —— 会话过期时前半段(jobToken 交换)挂住,signal 还没生效。整体 race 才封得住。
|
|
507
|
+
* 2. 超时必须落到**保旧值**那条分支,而不是 catch 分支:后者会把缓存写成
|
|
508
|
+
* `usage: undefined`,于是「网络慢」被显示成「没有积分数据」。
|
|
509
|
+
*
|
|
510
|
+
* 迟到的 rejection 要单独吞掉:promise 已经按超时结算之后,它再 reject 就是一次
|
|
511
|
+
* 没人处理的 rejection。
|
|
512
|
+
*/
|
|
513
|
+
declare function withHardTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T | undefined>;
|
|
514
|
+
/** The namespace the HOST actually serves this plugin under (workbuddy probe). */
|
|
515
|
+
declare function settingsNamespaceOf(ctx: unknown): string;
|
|
516
|
+
declare function asVolatile<T>(schema: z<T>): z<T>;
|
|
517
|
+
/** Unwrap a schemastery volatile's reactive `.get()` into a plain snapshot. */
|
|
518
|
+
declare function unwrapVolatile<T>(value: T): T;
|
|
519
|
+
interface Config {
|
|
520
|
+
regions: Record<string, unknown>;
|
|
521
|
+
/**
|
|
522
|
+
* 是否在 DSH 侧边栏放一个 Qoder 面板(行 + 整页)。**默认关闭**。
|
|
523
|
+
*
|
|
524
|
+
* 参考:dsh-connect-workbuddy 的 `Config.sidebarPanel`(PR #188,MIT,
|
|
525
|
+
* Copyright (c) 2026 LaoDing)。
|
|
526
|
+
*
|
|
527
|
+
* 为什么要用户显式打开:这一行占的是 `sidebar.panellist` —— 所有插件共用的
|
|
528
|
+
* 全局侧边栏座位,点开还会接管中央面板。打开它是对用户整个侧边栏的决定,
|
|
529
|
+
* 不是对这张卡片的偏好;「插件」页本来就能看到同一张卡片,所以默认值必须是
|
|
530
|
+
* 「不替用户动侧边栏」。缺席读作关闭(`=== true` 判据见 `status-paths.ts`)。
|
|
531
|
+
*/
|
|
532
|
+
sidebarPanel?: boolean;
|
|
533
|
+
/**
|
|
534
|
+
* 设备身份来源(见 `Config` 里同名项的注释)。缺席读作 `real`。
|
|
535
|
+
*/
|
|
536
|
+
deviceIdentity?: 'real' | 'derived' | 'manual';
|
|
537
|
+
/**
|
|
538
|
+
* 人工设备身份(只在 `deviceIdentity: 'manual'` 时生效)。
|
|
539
|
+
*/
|
|
540
|
+
identityOverride?: {
|
|
541
|
+
machineId?: string;
|
|
542
|
+
machineToken?: string;
|
|
543
|
+
machineType?: string;
|
|
544
|
+
machineCode?: string;
|
|
545
|
+
};
|
|
546
|
+
}
|
|
547
|
+
declare const Config: z<Config>;
|
|
548
|
+
/**
|
|
549
|
+
* 一份目录是否**声明了**思考档位。
|
|
550
|
+
*
|
|
551
|
+
* 「一个模型都没有档位」有两种完全不同的含义,必须分开:
|
|
552
|
+
* 1. 上游当前没声明(`thinkingEfforts` 字段缺席或为空)—— 那它是「上游没
|
|
553
|
+
* 档位」的诚实答案;
|
|
554
|
+
* 2. 这份目录来自一次没拉到档位的时刻 —— 本机实测 14 个 cn 模型的
|
|
555
|
+
* `thinkingEfforts` 全是 `[]`,是旧 schema 把字段剥掉时的产物。用它当答案,
|
|
556
|
+
* 卡片就不渲染档位选择器(用户实拍「思考强度有时候有、有时候没有」:点一次
|
|
557
|
+
* 「从 Qoder 刷新」就有,重启后就没)。
|
|
558
|
+
*
|
|
559
|
+
* 两种情况从数据上分不开(空数组与缺席都判「没声明」),要不要重拉由**目录的
|
|
560
|
+
* 来源**决定:调用方只在「本进程还没成功拉到实时目录」时才据此触发重拉(见
|
|
561
|
+
* displayModels)—— 实时目录没档位是上游的诚实答案,重拉多少次都一样。
|
|
562
|
+
*
|
|
563
|
+
* 判据用 `length > 0` 而不是「字段在不在」:旧 schema 留下的是**空数组**而不是
|
|
564
|
+
* 缺席,所以「字段在」恰恰不能作为「声明过」的证据。
|
|
565
|
+
*/
|
|
566
|
+
declare function catalogSnapshotDeclaresEfforts(models: readonly {
|
|
567
|
+
thinkingEfforts?: readonly string[];
|
|
568
|
+
}[]): boolean;
|
|
569
|
+
/**
|
|
570
|
+
* 「手上的目录能不能当档位答案」——**判据与动作打包在一起**。
|
|
571
|
+
*
|
|
572
|
+
* 拆开成两个函数(判据一个、调用处自己判)会留下一条没被测试覆盖的接线:把调用处
|
|
573
|
+
* 变异掉,单测仍然全绿(第一版就是这么自我欺骗的)。这里让规则自己执行动作并
|
|
574
|
+
* 返回结论,于是「动作有没有真的发生」也能被断言。
|
|
575
|
+
*
|
|
576
|
+
* 检测到「一个档位都没声明」时**不改动要服务的模型列表**:模型不能从卡片上
|
|
577
|
+
* 消失,缺的只是档位 —— 后台拉回来之后的下一次读取自然补上。返回 `stale`
|
|
578
|
+
* 标记这次调用有没有触发过拉取。
|
|
579
|
+
*/
|
|
580
|
+
declare function serveSavedCatalog(models: readonly QoderModelInfo[], onStale: () => void): {
|
|
581
|
+
models: readonly QoderModelInfo[];
|
|
582
|
+
stale: boolean;
|
|
583
|
+
};
|
|
584
|
+
/** 某区域的配置状态(缺省返回空对象)。 */
|
|
585
|
+
declare function regionStateOf(config: {
|
|
586
|
+
regions?: Record<string, unknown> | null;
|
|
587
|
+
}, region: QoderRegion): Record<string, unknown>;
|
|
588
|
+
/**
|
|
589
|
+
* 设备身份来源模式。认不出的值一律读作 `real`。
|
|
590
|
+
*
|
|
591
|
+
* 为什么不 `throw`:这个值来自用户可编辑的配置文件,写错一个字母不该让整个
|
|
592
|
+
* 插件起不来。退回默认值(`real`)也不会比现状更差 —— 它本来就是默认值。
|
|
593
|
+
*/
|
|
594
|
+
declare function deviceIdentityModeOf(config: {
|
|
595
|
+
deviceIdentity?: unknown;
|
|
596
|
+
}): 'real' | 'derived' | 'manual';
|
|
597
|
+
/**
|
|
598
|
+
* 人工身份覆盖值:把空字符串过滤掉,全空时整个字段都不传。
|
|
599
|
+
*
|
|
600
|
+
* `exactOptionalPropertyTypes` 下「传一个全空的 override 对象」与「不传」是两件事,
|
|
601
|
+
* 后者才对 —— 所以空值必须在这里被吃掉,不能指望下游判断。
|
|
602
|
+
*/
|
|
603
|
+
declare function identityOverrideOf(config: {
|
|
604
|
+
identityOverride?: unknown;
|
|
605
|
+
}): {
|
|
606
|
+
identityOverride?: QoderIdentityOverride;
|
|
607
|
+
};
|
|
608
|
+
/** 某区域是否启用(opt-out)。 */
|
|
609
|
+
declare function regionEnabled(config: {
|
|
610
|
+
regions?: Record<string, unknown> | null;
|
|
611
|
+
}, region: QoderRegion): boolean;
|
|
612
|
+
/**
|
|
613
|
+
* 某区域的重试预算 → 宿主的 `RetryPolicyConfig`(issue #24)。
|
|
614
|
+
*
|
|
615
|
+
* 三个值全为 0(schema 默认)时返回 `undefined`:**交给宿主默认**,与升级前
|
|
616
|
+
* 逐字一致。只要有一个非 0 就成对补齐 —— 宿主的 `resolveBackoff` 要求
|
|
617
|
+
* `initialDelayMs <= maxDelayMs` 且都为正数,所以缺失的一侧用另一侧/默认填,
|
|
618
|
+
* 而不是原样把 0 递进去(那会直接抛)。
|
|
619
|
+
*
|
|
620
|
+
* `mode` 恒为 `normal`(只重试宿主的可重试码):`always` 会让一个必然失败的
|
|
621
|
+
* 请求无限重试,那不是「调预算」,所以本版不暴露。
|
|
622
|
+
*/
|
|
623
|
+
declare function retryPolicyOf(config: {
|
|
624
|
+
regions?: Record<string, unknown> | null;
|
|
625
|
+
}, region: QoderRegion): RetryPolicyConfig | undefined;
|
|
626
|
+
/**
|
|
627
|
+
* 某区域「上游排队时插件自己等多久」的上限(毫秒,issue #29)。
|
|
628
|
+
*
|
|
629
|
+
* 返回 `undefined` 表示关掉(0):失败原样交给宿主的重试阶梯。本地读取而不是
|
|
630
|
+
* 依赖 schema 默认值 —— 这样在设置存在之前写下的配置读出来是「关」还是「60 秒」
|
|
631
|
+
* 由这里一句话决定,不随 schema 默认值漂移。
|
|
632
|
+
*
|
|
633
|
+
* 为什么默认开着:宿主的阶梯前两次一定短于上游申报的 30 秒(见 issue #29 的
|
|
634
|
+
* 28 次重试实测),不在这层等掉就等于每次都在对方说「别来」的窗口里敲门。
|
|
635
|
+
*/
|
|
636
|
+
declare function queueWaitMsOf(config: {
|
|
637
|
+
regions?: Record<string, unknown> | null;
|
|
638
|
+
}, region: QoderRegion): number | undefined;
|
|
639
|
+
/** 某区域是否配置了凭据(设置 PAT 或环境变量其一)。 */
|
|
640
|
+
declare function regionHasCredential(config: {
|
|
641
|
+
regions?: Record<string, unknown> | null;
|
|
642
|
+
}, region: QoderRegion): boolean;
|
|
643
|
+
/**
|
|
644
|
+
* 把一次用量解析成卡片可渲染的积分包。
|
|
645
|
+
*
|
|
646
|
+
* ⚠️ **上游那个 `expiresAt` 不是积分包的到期**(issue #31 的主问题):它是
|
|
647
|
+
* `qoderUsage` 的同级字段,等于 `userId`(UUIDv7)前 48 bit + 14 天 ——
|
|
648
|
+
* **账号级套餐 / 试用**的到期。`userQuota` / `addOnQuota` 自己都不带到期字段。
|
|
649
|
+
* 此前它被挂到 `addon` 包上,于是「试用期到期」被显示成「积分包到期」,池排序
|
|
650
|
+
* 也拿它当积分紧急度。现在它单独出 `planExpiresAtMs`,与积分彻底分开。
|
|
651
|
+
*
|
|
652
|
+
* 积分本身的到期只可能来自**签到批次**(上游 `validity.days` 只在活动里给过),
|
|
653
|
+
* 那一路见 `credit-expiry.ts`。
|
|
654
|
+
*/
|
|
655
|
+
declare function creditsOf(usage: QoderUsage): QoderWebCredits;
|
|
656
|
+
/**
|
|
657
|
+
* 把专属积分包映射进面板那一列的 DTO(issue #38)。
|
|
658
|
+
*
|
|
659
|
+
* **不并进 `total`。** 这是这一条最容易做错的地方:专属包是「选了某个模型才
|
|
660
|
+
* 优先抵扣」的一笔钱(上游原文:在模型选择器中选择 Sonus 模型时优先抵扣该
|
|
661
|
+
* 积分),与「普通积分」是**两个池子**。把它们相加会让胶囊显示一个用户花不掉
|
|
662
|
+
* 的数字 —— 不选那只模型,这笔钱一分都动不了。所以它单独一列,普通积分那一列
|
|
663
|
+
* 一个字都不变。
|
|
664
|
+
*
|
|
665
|
+
* 只留 `remaining > 0` 的(issue #38 的原话:「且 remaining > 0 时才多出这一
|
|
666
|
+
* 列」):一个用光的专属包留在读数里,用户会以为那笔钱还在。`remaining` 缺席
|
|
667
|
+
* 的行**保留**(那是「上游没报」,不是「用完了」),界面画成「—」。
|
|
668
|
+
*/
|
|
669
|
+
declare function dedicatedPackagesOf(usage: QoderUsage): QoderWebDedicatedPackage[];
|
|
670
|
+
/**
|
|
671
|
+
* 把签到批次的到期推算并进积分视图。
|
|
672
|
+
*
|
|
673
|
+
* 分成两步(而不是把批次塞进 `creditsOf`)的理由:`creditsOf` 是纯的、只吃
|
|
674
|
+
* 一次 usage 报文;批次是**另一份状态**,进程重启后才需要落盘。分开之后,
|
|
675
|
+
* 「没有批次」是一个自然状态(新装的插件、从没签到过),而不是一种要特判的错误。
|
|
676
|
+
*/
|
|
677
|
+
declare function creditsWithExpiry(credits: QoderWebCredits, batches: readonly QoderCheckinBatch[], nowMs?: number): QoderWebCredits;
|
|
678
|
+
declare function apply(ctx: Context, config: Config): void;
|
|
679
|
+
/**
|
|
680
|
+
* 「凭据被拒」这条结论**有没有凭据**。
|
|
681
|
+
*
|
|
682
|
+
* `auth` 这个 kind 只说「像凭据问题」,不说「凭什么」。两种来源的处置必须不同
|
|
683
|
+
* (issue #6):
|
|
684
|
+
*
|
|
685
|
+
* - **业务码 `105` 确认**(官方码表:登录态或 Access Token 已过期)—— 令牌真的
|
|
686
|
+
* 被拒了,等也没用,永久剔除是对的。
|
|
687
|
+
* - **HTTP 401** —— 401 在这套上游语义里就是凭据被拒,同样永久剔除。
|
|
688
|
+
* - **只是 HTTP 403 兜底猜的**(`classifyHttpStatus` 的 `401/403 → auth`)——
|
|
689
|
+
* 上游把「当日用量用尽」「排队中」「限流」也装在 403 里(实测 403 + 码 110 /
|
|
690
|
+
* 10605)。此时永久剔除会把一个几分钟到几小时就自愈的账号踢出池,而且
|
|
691
|
+
* **不自愈**:用户被要求换 PAT,换了也没用(问题从来不在凭据)。
|
|
692
|
+
*
|
|
693
|
+
* 所以这里只把**确认过**的拒绝记成永久排除,没确认的降级为冷却(`unavailable`
|
|
694
|
+
* ⇒ `exclusionOf` 走冷却期,到期自动回池)。
|
|
695
|
+
*
|
|
696
|
+
* `context` 缺席(旧调用方 / 不知道来源)时保持原语义:永久排除 —— 宁可多剔除,
|
|
697
|
+
* 也不让一个坏账号一直留在池里被反复选中。
|
|
698
|
+
*/
|
|
699
|
+
declare function credentialOutcomeOf(context?: {
|
|
700
|
+
status?: number | undefined;
|
|
701
|
+
code?: string | undefined;
|
|
702
|
+
}): QoderWebProbeOutcome;
|
|
703
|
+
/**
|
|
704
|
+
* 一次**真实请求**失败要写进账号池的那条测量;kind 不可映射时返回 undefined
|
|
705
|
+
* (不写:内容策略拒绝是「这一次输入」的事实,不是账号的事实,见
|
|
706
|
+
* `exclusionOf` 的 policy-rejected 分支)。
|
|
707
|
+
*
|
|
708
|
+
* 抽成模块级纯函数并导出,是因为它此前是 `onServingFailure` 里的一段内联字面量,
|
|
709
|
+
* 而那段代码有一个**已经发生过的**缺陷:上游原文被丢掉(参数写成 `_message`),
|
|
710
|
+
* 于是池里只有一句结论、没有依据 —— 用户实拍那条 `credential-rejected` 记录连
|
|
711
|
+
* `message` 都没有,卡片只能空口指控「PAT 被拒」,而真相(`code 110` 当日用量
|
|
712
|
+
* 用尽)就在被丢掉的那串字符里。探针路径早就带原文(`redactUpstreamText`),
|
|
713
|
+
* 两条路径写同一个文件却只有一个带。
|
|
714
|
+
*
|
|
715
|
+
* 按本项目的既有教训(「判据与动作打包,于是动作有没有真的发生也能被断言」),
|
|
716
|
+
* 把它做成可测函数而不是留在接线里:接线变异掉,测试照样全绿过一次了。
|
|
717
|
+
*
|
|
718
|
+
* `context`(上游状态 + 业务码)决定「凭据被拒」是永久排除还是冷却,见
|
|
719
|
+
* {@link credentialOutcomeOf}。
|
|
720
|
+
*/
|
|
721
|
+
declare function liveRequestProbe(kind: UpstreamErrorKind, message: string, modelId?: string, context?: {
|
|
722
|
+
status?: number | undefined;
|
|
723
|
+
code?: string | undefined;
|
|
724
|
+
/** 上游申报的等待时长(毫秒),issue #26。 */
|
|
725
|
+
retryAfterMs?: number | undefined;
|
|
726
|
+
/** 上游说「我在排队」的证据,issue #26。 */
|
|
727
|
+
queue?: {
|
|
728
|
+
isQueued: boolean;
|
|
729
|
+
queueCount?: number;
|
|
730
|
+
queueType?: string;
|
|
731
|
+
retryAfterSeconds?: number;
|
|
732
|
+
serviceAvailable?: boolean;
|
|
733
|
+
} | undefined;
|
|
734
|
+
/**
|
|
735
|
+
* 「当日用量用尽」的恢复时刻(签到快照里的 `refreshAtMs`),issue #32。
|
|
736
|
+
*
|
|
737
|
+
* 真实请求撞 `110` 时,上游报文里**没有**等待时长(那是 `10605` 排队信封
|
|
738
|
+
* 才有的字段),于是这条路径此前只能落一条没有 `retryAtMs` 的记录,池子
|
|
739
|
+
* 按 30 分钟兜底 —— 一个要等到次日窗口才恢复的号,每 30 分钟被真实请求
|
|
740
|
+
* 撞一次。探测路径(`probeThrough`)早就接上了这个值,真实路径没有。
|
|
741
|
+
*
|
|
742
|
+
* 只在 `out-of-credit` 时采用,与 {@link cooldownOf} 同一顺序:上游申报的
|
|
743
|
+
* 时长优先,其次才是快照推出来的窗口时刻。
|
|
744
|
+
*/
|
|
745
|
+
quotaRefreshAtMs?: number | undefined;
|
|
746
|
+
}): QoderPoolProbe | undefined;
|
|
747
|
+
/**
|
|
748
|
+
* 一次真实请求的失败要不要记成**区域级**的「上游报额度耗尽」通知。
|
|
749
|
+
*
|
|
750
|
+
* 与 {@link liveRequestProbe} 的分工:那条按**账号**记、供池换号决策用,且有
|
|
751
|
+
* 两道门(池关不记盘、非成员不记);这条按**区域**记、纯粹给 UI 看——池关着时
|
|
752
|
+
* 一次 code 110 的失败此前在任何面板上都无处显示(0.7.x 的「今日额度疑似已
|
|
753
|
+
* 用尽」胶囊拆掉后留下的缺口)。只要 `kind` 是 `quota-exhausted`(上游业务码
|
|
754
|
+
* 命中配额族)就记,展示口径「最近一次」——上游恢复正常不会主动通知,所以不
|
|
755
|
+
* 设失效时刻,事实性由时间戳保证。
|
|
756
|
+
*
|
|
757
|
+
* 抽成纯函数的理由同 `liveRequestProbe`:接线变异掉时测试仍能钉住判据。
|
|
758
|
+
*/
|
|
759
|
+
declare function liveQuotaExhaustion(kind: UpstreamErrorKind, message: string, context: {
|
|
760
|
+
status?: number | undefined;
|
|
761
|
+
code?: string | undefined;
|
|
762
|
+
} | undefined, nowMs: number): QoderWebQuotaExhaustion | undefined;
|
|
763
|
+
/** 「这个区域此刻允不允许替用户换号」所需要的那一个偏好位。 */
|
|
764
|
+
interface PoolGate {
|
|
765
|
+
enabled: boolean;
|
|
766
|
+
memberAccountIds: readonly string[];
|
|
767
|
+
}
|
|
768
|
+
/**
|
|
769
|
+
* **池开关是换号的唯一授权。** 关闭时不得改用任何别的账号。
|
|
770
|
+
*
|
|
771
|
+
* 这一条此前**缺着**:`nextFailoverCredential` 只读成员名单、从不读
|
|
772
|
+
* `enabled`,于是「关掉账号池」这个最核心的开关**对换号完全无效** —— 只要
|
|
773
|
+
* 成员非空,插件就永远在失败后悄悄换到另一个 PAT 计费,而用户以为自己关掉了
|
|
774
|
+
* 自动行为。默认值是 `enabled: false`,所以这是**每一条全新安装**都在踩的路径。
|
|
775
|
+
*
|
|
776
|
+
* 注意作用域:签到/测试这两个**手动**批量动作**不**挂在这个开关上 —— 它们由
|
|
777
|
+
* 用户亲手点击,不属于「插件替你决定」。只有换号与失败记录设门。
|
|
778
|
+
*/
|
|
779
|
+
declare function poolAllowsFailover(prefs: PoolGate): boolean;
|
|
780
|
+
/**
|
|
781
|
+
* 该不该把一次「正在服务的请求失败」记成池状态。
|
|
782
|
+
*
|
|
783
|
+
* 两条守卫各挡一类误伤:
|
|
784
|
+
*
|
|
785
|
+
* 1. **池关不记**:关掉池子意味着插件不再替用户选号、也不再替用户换号。此时
|
|
786
|
+
* 仍把失败写进池状态,用户下次开池会看到一堆根本没参与过任何决策的「上次
|
|
787
|
+
* 失败」,也与「关了就完全回到手动选号」这条承诺冲突。
|
|
788
|
+
* 2. **非成员不记**:勾选成员就是「我同意让这些号参与」。没勾的号不该因为一次
|
|
789
|
+
* 恰好用了它的请求就被判出池 —— 那等于把用户没授权的开销当成默认值。
|
|
790
|
+
*
|
|
791
|
+
* `invalid-request` 一类不必在这里再挡:shim 的 `isFailoverEligible` 已经排除过
|
|
792
|
+
* 它们(400 换谁都是 400),`liveRequestProbe` 不会为它们产出记录。
|
|
793
|
+
*/
|
|
794
|
+
declare function shouldRecordPoolFailure(prefs: PoolGate, accountId: string): boolean;
|
|
795
|
+
/**
|
|
796
|
+
* 一条换号播报的去重键:**同一个事实**才合并。
|
|
797
|
+
*
|
|
798
|
+
* 键里刻意含接管账号与失败种类:换成另一个账号回答、或失败原因变了
|
|
799
|
+
* (限流 → 用尽),都是新事实,应当再说一次。反之,一次 Agent 回合里十几轮
|
|
800
|
+
* 调用都以「A 用尽 → B 回答」进行时,它们只是同一件事重复了十几遍。
|
|
801
|
+
*/
|
|
802
|
+
declare function failoverAnnounceKey(input: {
|
|
803
|
+
fromAccountId: string;
|
|
804
|
+
toAccountId: string;
|
|
805
|
+
kind: string;
|
|
806
|
+
}): string;
|
|
807
|
+
/**
|
|
808
|
+
* 记录并回答「这条播报是否应当发出」:第一次 true,之后同一个键 false。
|
|
809
|
+
*
|
|
810
|
+
* `seen` 是调用方的有界 Map(值只当作插入顺序序号用,不参与判断)。重复的键会
|
|
811
|
+
* 被重新插入,从而在超限淘汰时保住仍然活跃的那一条。
|
|
812
|
+
*/
|
|
813
|
+
declare function shouldAnnounceFailoverOnce(seen: Map<string, number>, input: {
|
|
814
|
+
fromAccountId: string;
|
|
815
|
+
toAccountId: string;
|
|
816
|
+
kind: string;
|
|
817
|
+
}): boolean;
|
|
818
|
+
/** 某个账号不再被排除时,把它参与过的播报记录一并清掉(下一次重新播报)。 */
|
|
819
|
+
declare function clearAnnouncedFailoversFrom(seen: Map<string, number>, accountId: string): void;
|
|
820
|
+
/**
|
|
821
|
+
* @deprecated 用 {@link quotaRefreshOfAccount}(按账号 id)或
|
|
822
|
+
* {@link quotaRefreshOfStored}(再叠一层磁盘)。
|
|
823
|
+
*
|
|
824
|
+
* 保留它只为**不删已发布过的导出**(1.17.4 的 `lib/index.d.ts` 里有这个名字,
|
|
825
|
+
* 补丁版本不该把它拿走)。但它正是 issue #32 那个坑的形状:它替调用方把 PAT
|
|
826
|
+
* 派生成 id,而真实请求路径手里**本来就是 id** —— 再派生一次得到
|
|
827
|
+
* `pat-<hash(pat-…)>`,永远取不到,修复静默失效而纯函数测试全绿。
|
|
828
|
+
*
|
|
829
|
+
* 只在你手里确实是 PAT 时用它;其余情况直接用 id 那个入口。
|
|
830
|
+
*/
|
|
831
|
+
declare function quotaRefreshOf(snapshot: Readonly<Record<string, {
|
|
832
|
+
refreshAtMs?: number;
|
|
833
|
+
}>> | undefined, pat: string): {
|
|
834
|
+
quotaRefreshAtMs?: number;
|
|
835
|
+
};
|
|
836
|
+
/**
|
|
837
|
+
* 「当日用量用尽」(code 110) 的恢复时刻,从签到快照按**账号 id** 取。
|
|
838
|
+
*
|
|
839
|
+
* 上游在签到报文里给了这个时刻(`daily.endAt`),签到批次把它存进快照;这里
|
|
840
|
+
* 就按 id 取。取不到时返回 `{}`(不传)—— 这是**故意的保守**:宁可用 30 分钟
|
|
841
|
+
* 兜底,也不在本机编一个「次日零点」。官方页面上那个数字才是准的,编出来的会
|
|
842
|
+
* 让用户在错的时间回来(与 `cooldownOf` 的既有注释同一条规矩)。
|
|
843
|
+
*
|
|
844
|
+
* ⚠️ **键是账号 id(`pat-…`),不是 PAT**,这是 issue #32 那个坑:真实请求路径
|
|
845
|
+
* (`onServingFailure`)只拿得到 `accountId`,而探测路径手里是 PAT。曾经有一个
|
|
846
|
+
* 内部先 `qoderAccountId(pat)` 再取的入口,把 `pat-abc…` 再哈希一次得到
|
|
847
|
+
* `pat-<hash(pat-…)>`,于是永远取不到、修复静默失效(纯函数测试还全绿)。
|
|
848
|
+
* 现在派生一律由**调用方**做,本函数只认 id —— 少一个入口就少一处能踩。
|
|
849
|
+
*/
|
|
850
|
+
declare function quotaRefreshOfAccount(snapshot: Readonly<Record<string, {
|
|
851
|
+
refreshAtMs?: number;
|
|
852
|
+
}>> | undefined, accountId: string): {
|
|
853
|
+
quotaRefreshAtMs?: number;
|
|
854
|
+
};
|
|
855
|
+
/**
|
|
856
|
+
* 同上,但在进程内快照之外再看一眼**落过盘**的窗口时刻(issue #32 第三条)。
|
|
857
|
+
*
|
|
858
|
+
* 为什么需要第三个入口:`checkinSnapshots` 是进程内对象,注释里也写了「重启后
|
|
859
|
+
* 由下一次签到重新写入」。而 110 的兜底冷却恰恰只在「窗口时刻不知道」时生效 ——
|
|
860
|
+
* 于是进程一重启兜底就必然生效,用户看到的就是「这个号每半小时被试探一次」。
|
|
861
|
+
* 窗口时刻本身是一个**绝对时间点**(上游活动行的 `endAt`),它跨重启仍然成立。
|
|
862
|
+
*
|
|
863
|
+
* 顺序:进程内快照优先(它带今天的 `claimed` 语境),其次磁盘。两者都没有时
|
|
864
|
+
* 返回 `{}`,让调用方走兜底 —— 与这套代码一贯的「宁缺勿错」同规。
|
|
865
|
+
*/
|
|
866
|
+
declare function quotaRefreshOfStored(snapshot: Readonly<Record<string, {
|
|
867
|
+
refreshAtMs?: number;
|
|
868
|
+
}>> | undefined, stored: Readonly<Record<string, number>> | undefined, accountId: string, nowMs?: number): {
|
|
869
|
+
quotaRefreshAtMs?: number;
|
|
870
|
+
};
|
|
871
|
+
//#endregion
|
|
872
|
+
export { Config, PoolGate, QODER_CONNECT_VERSION, QODER_GITHUB_URL, apply, asVolatile, catalogSnapshotDeclaresEfforts, clearAnnouncedFailoversFrom, credentialOutcomeOf, creditsOf, creditsWithExpiry, dedicatedPackagesOf, deviceIdentityModeOf, failoverAnnounceKey, identityOverrideOf, inject, liveQuotaExhaustion, liveRequestProbe, name, poolAllowsFailover, queueWaitMsOf, quotaRefreshOf, quotaRefreshOfAccount, quotaRefreshOfStored, regionEnabled, regionHasCredential, regionStateOf, retryPolicyOf, serveSavedCatalog, settingsNamespaceOf, shouldAnnounceFailoverOnce, shouldRecordPoolFailure, unwrapVolatile, withHardTimeout };
|