@xixka/dsh-hub 0.2.1-rc.9 → 0.2.3
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/README.md +60 -889
- package/lib/accio-adapter.d.ts.map +1 -1
- package/lib/accio-adapter.js +3 -1
- package/lib/accio-adapter.js.map +1 -1
- package/lib/account-pool.d.ts +128 -0
- package/lib/account-pool.d.ts.map +1 -1
- package/lib/account-pool.js +252 -15
- package/lib/account-pool.js.map +1 -1
- package/lib/aggregate-adapter.d.ts +38 -0
- package/lib/aggregate-adapter.d.ts.map +1 -1
- package/lib/aggregate-adapter.js +145 -12
- package/lib/aggregate-adapter.js.map +1 -1
- package/lib/aggregate-expiry.d.ts.map +1 -1
- package/lib/aggregate-expiry.js +4 -0
- package/lib/aggregate-expiry.js.map +1 -1
- package/lib/analyze-image.d.ts.map +1 -1
- package/lib/analyze-image.js.map +1 -1
- package/lib/astudio-adapter.d.ts.map +1 -1
- package/lib/astudio-adapter.js +3 -1
- package/lib/astudio-adapter.js.map +1 -1
- package/lib/buddy-adapter.d.ts.map +1 -1
- package/lib/buddy-adapter.js +22 -4
- package/lib/buddy-adapter.js.map +1 -1
- package/lib/buddy.d.ts +7 -2
- package/lib/buddy.d.ts.map +1 -1
- package/lib/buddy.js +7 -2
- package/lib/buddy.js.map +1 -1
- package/lib/canonical-models.d.ts.map +1 -1
- package/lib/canonical-models.js +20 -0
- package/lib/canonical-models.js.map +1 -1
- package/lib/chromium-session.d.ts +174 -0
- package/lib/chromium-session.d.ts.map +1 -1
- package/lib/chromium-session.js +418 -1
- package/lib/chromium-session.js.map +1 -1
- package/lib/client/jet-hub.js +287 -13918
- package/lib/codearts-credits.d.ts +176 -16
- package/lib/codearts-credits.d.ts.map +1 -1
- package/lib/codearts-credits.js +316 -34
- package/lib/codearts-credits.js.map +1 -1
- package/lib/codearts-vision.d.ts +95 -4
- package/lib/codearts-vision.d.ts.map +1 -1
- package/lib/codearts-vision.js +136 -5
- package/lib/codearts-vision.js.map +1 -1
- package/lib/codely-adapter.d.ts +36 -3
- package/lib/codely-adapter.d.ts.map +1 -1
- package/lib/codely-adapter.js +252 -11
- package/lib/codely-adapter.js.map +1 -1
- package/lib/codely-auth-service.d.ts +17 -0
- package/lib/codely-auth-service.d.ts.map +1 -1
- package/lib/codely-auth-service.js +40 -3
- package/lib/codely-auth-service.js.map +1 -1
- package/lib/codely-auth.d.ts.map +1 -1
- package/lib/codely-auth.js +23 -0
- package/lib/codely-auth.js.map +1 -1
- package/lib/codely-credits.d.ts.map +1 -1
- package/lib/codely-credits.js +18 -1
- package/lib/codely-credits.js.map +1 -1
- package/lib/codely-product.d.ts +10 -5
- package/lib/codely-product.d.ts.map +1 -1
- package/lib/codely-product.js +4 -2
- package/lib/codely-product.js.map +1 -1
- package/lib/credential-resolver.d.ts +41 -1
- package/lib/credential-resolver.d.ts.map +1 -1
- package/lib/credential-resolver.js +31 -6
- package/lib/credential-resolver.js.map +1 -1
- package/lib/image-budget.d.ts +3 -11
- package/lib/image-budget.d.ts.map +1 -1
- package/lib/image-budget.js +43 -5
- package/lib/image-budget.js.map +1 -1
- package/lib/image-data-cache.d.ts +87 -0
- package/lib/image-data-cache.d.ts.map +1 -0
- package/lib/image-data-cache.js +144 -0
- package/lib/image-data-cache.js.map +1 -0
- package/lib/index.d.ts +0 -51
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +290 -164
- package/lib/index.js.map +1 -1
- package/lib/jet-hub-rpc.d.ts +14 -19
- package/lib/jet-hub-rpc.d.ts.map +1 -1
- package/lib/jet-hub-rpc.js +812 -496
- package/lib/jet-hub-rpc.js.map +1 -1
- package/lib/jet-hub-store.d.ts +52 -0
- package/lib/jet-hub-store.d.ts.map +1 -1
- package/lib/jet-hub-store.js +52 -4
- package/lib/jet-hub-store.js.map +1 -1
- package/lib/llm-adapter.d.ts +96 -5
- package/lib/llm-adapter.d.ts.map +1 -1
- package/lib/llm-adapter.js +742 -62
- package/lib/llm-adapter.js.map +1 -1
- package/lib/lobsterai-adapter.d.ts.map +1 -1
- package/lib/lobsterai-adapter.js +54 -15
- package/lib/lobsterai-adapter.js.map +1 -1
- package/lib/login.d.ts +5 -13
- package/lib/login.d.ts.map +1 -1
- package/lib/login.js +75 -14
- package/lib/login.js.map +1 -1
- package/lib/loomy-adapter.d.ts +3 -0
- package/lib/loomy-adapter.d.ts.map +1 -1
- package/lib/loomy-adapter.js +11 -3
- package/lib/loomy-adapter.js.map +1 -1
- package/lib/loomy-auth.d.ts +64 -1
- package/lib/loomy-auth.d.ts.map +1 -1
- package/lib/loomy-auth.js +191 -22
- package/lib/loomy-auth.js.map +1 -1
- package/lib/loomy-credits.d.ts +17 -0
- package/lib/loomy-credits.d.ts.map +1 -1
- package/lib/loomy-credits.js +35 -2
- package/lib/loomy-credits.js.map +1 -1
- package/lib/loomy-oauth.d.ts +44 -0
- package/lib/loomy-oauth.d.ts.map +1 -1
- package/lib/loomy-oauth.js +48 -1
- package/lib/loomy-oauth.js.map +1 -1
- package/lib/loomy-sms-login.d.ts +61 -0
- package/lib/loomy-sms-login.d.ts.map +1 -0
- package/lib/loomy-sms-login.js +330 -0
- package/lib/loomy-sms-login.js.map +1 -0
- package/lib/loomy.d.ts +41 -0
- package/lib/loomy.d.ts.map +1 -1
- package/lib/loomy.js +29 -0
- package/lib/loomy.js.map +1 -1
- package/lib/magicrew-adapter.d.ts +201 -0
- package/lib/magicrew-adapter.d.ts.map +1 -0
- package/lib/magicrew-adapter.js +595 -0
- package/lib/magicrew-adapter.js.map +1 -0
- package/lib/magicrew-auth.d.ts +494 -0
- package/lib/magicrew-auth.d.ts.map +1 -0
- package/lib/magicrew-auth.js +951 -0
- package/lib/magicrew-auth.js.map +1 -0
- package/lib/magicrew-browser-login.d.ts +333 -0
- package/lib/magicrew-browser-login.d.ts.map +1 -0
- package/lib/magicrew-browser-login.js +740 -0
- package/lib/magicrew-browser-login.js.map +1 -0
- package/lib/magicrew-catalog.d.ts +19 -0
- package/lib/magicrew-catalog.d.ts.map +1 -0
- package/lib/magicrew-catalog.js +80 -0
- package/lib/magicrew-catalog.js.map +1 -0
- package/lib/magicrew-credits.d.ts +112 -0
- package/lib/magicrew-credits.d.ts.map +1 -0
- package/lib/magicrew-credits.js +319 -0
- package/lib/magicrew-credits.js.map +1 -0
- package/lib/magicrew-local-browser.d.ts +123 -0
- package/lib/magicrew-local-browser.d.ts.map +1 -0
- package/lib/magicrew-local-browser.js +321 -0
- package/lib/magicrew-local-browser.js.map +1 -0
- package/lib/magicrew-product.d.ts +127 -0
- package/lib/magicrew-product.d.ts.map +1 -0
- package/lib/magicrew-product.js +159 -0
- package/lib/magicrew-product.js.map +1 -0
- package/lib/magicrew-profile.d.ts +74 -0
- package/lib/magicrew-profile.d.ts.map +1 -0
- package/lib/magicrew-profile.js +148 -0
- package/lib/magicrew-profile.js.map +1 -0
- package/lib/magicrew.d.ts +185 -0
- package/lib/magicrew.d.ts.map +1 -0
- package/lib/magicrew.js +215 -0
- package/lib/magicrew.js.map +1 -0
- package/lib/model-catalog.d.ts +8 -0
- package/lib/model-catalog.d.ts.map +1 -1
- package/lib/model-catalog.js +127 -5
- package/lib/model-catalog.js.map +1 -1
- package/lib/models.d.ts +216 -32
- package/lib/models.d.ts.map +1 -1
- package/lib/models.js +500 -47
- package/lib/models.js.map +1 -1
- package/lib/modelscope-adapter.d.ts.map +1 -1
- package/lib/modelscope-adapter.js +7 -2
- package/lib/modelscope-adapter.js.map +1 -1
- package/lib/modelscope-product.d.ts +44 -6
- package/lib/modelscope-product.d.ts.map +1 -1
- package/lib/modelscope-product.js +98 -9
- package/lib/modelscope-product.js.map +1 -1
- package/lib/officeace-adapter.d.ts.map +1 -1
- package/lib/officeace-adapter.js +147 -21
- package/lib/officeace-adapter.js.map +1 -1
- package/lib/officeace-auth.d.ts +15 -0
- package/lib/officeace-auth.d.ts.map +1 -1
- package/lib/officeace-auth.js +99 -2
- package/lib/officeace-auth.js.map +1 -1
- package/lib/openai-gateway/tencent-fingerprint.d.ts.map +1 -1
- package/lib/openai-gateway/tencent-fingerprint.js +28 -3
- package/lib/openai-gateway/tencent-fingerprint.js.map +1 -1
- package/lib/opencode-adapter.d.ts +27 -0
- package/lib/opencode-adapter.d.ts.map +1 -1
- package/lib/opencode-adapter.js +57 -8
- package/lib/opencode-adapter.js.map +1 -1
- package/lib/opencode-bun-tls.d.ts +103 -0
- package/lib/opencode-bun-tls.d.ts.map +1 -0
- package/lib/opencode-bun-tls.js +212 -0
- package/lib/opencode-bun-tls.js.map +1 -0
- package/lib/opencode-messages.d.ts +0 -19
- package/lib/opencode-messages.d.ts.map +1 -1
- package/lib/opencode-messages.js +30 -33
- package/lib/opencode-messages.js.map +1 -1
- package/lib/opencode-official-prompt.d.ts +62 -0
- package/lib/opencode-official-prompt.d.ts.map +1 -0
- package/lib/opencode-official-prompt.js +119 -0
- package/lib/opencode-official-prompt.js.map +1 -0
- package/lib/opencode-official-tools.d.ts +27 -0
- package/lib/opencode-official-tools.d.ts.map +1 -0
- package/lib/opencode-official-tools.js +340 -0
- package/lib/opencode-official-tools.js.map +1 -0
- package/lib/opencode-product.d.ts.map +1 -1
- package/lib/opencode-product.js +3 -2
- package/lib/opencode-product.js.map +1 -1
- package/lib/opencode-stream.d.ts.map +1 -1
- package/lib/opencode-stream.js +8 -7
- package/lib/opencode-stream.js.map +1 -1
- package/lib/product.d.ts +15 -3
- package/lib/product.d.ts.map +1 -1
- package/lib/product.js +44 -11
- package/lib/product.js.map +1 -1
- package/lib/provider-credits.d.ts +2 -0
- package/lib/provider-credits.d.ts.map +1 -1
- package/lib/provider-credits.js +46 -17
- package/lib/provider-credits.js.map +1 -1
- package/lib/provider-expiry.d.ts.map +1 -1
- package/lib/provider-expiry.js +29 -0
- package/lib/provider-expiry.js.map +1 -1
- package/lib/provider-http-pool.d.ts +85 -0
- package/lib/provider-http-pool.d.ts.map +1 -0
- package/lib/provider-http-pool.js +224 -0
- package/lib/provider-http-pool.js.map +1 -0
- package/lib/provider-registry.d.ts.map +1 -1
- package/lib/provider-registry.js +73 -39
- package/lib/provider-registry.js.map +1 -1
- package/lib/qiniu-adapter.d.ts +276 -0
- package/lib/qiniu-adapter.d.ts.map +1 -0
- package/lib/qiniu-adapter.js +689 -0
- package/lib/qiniu-adapter.js.map +1 -0
- package/lib/qiniu-auth.d.ts +130 -0
- package/lib/qiniu-auth.d.ts.map +1 -0
- package/lib/qiniu-auth.js +234 -0
- package/lib/qiniu-auth.js.map +1 -0
- package/lib/qiniu-messages.d.ts +96 -0
- package/lib/qiniu-messages.d.ts.map +1 -0
- package/lib/qiniu-messages.js +97 -0
- package/lib/qiniu-messages.js.map +1 -0
- package/lib/qiniu-product.d.ts +126 -0
- package/lib/qiniu-product.d.ts.map +1 -0
- package/lib/qiniu-product.js +269 -0
- package/lib/qiniu-product.js.map +1 -0
- package/lib/qiniu-rpc.d.ts +119 -0
- package/lib/qiniu-rpc.d.ts.map +1 -0
- package/lib/qiniu-rpc.js +214 -0
- package/lib/qiniu-rpc.js.map +1 -0
- package/lib/qiniu.d.ts +145 -0
- package/lib/qiniu.d.ts.map +1 -0
- package/lib/qiniu.js +164 -0
- package/lib/qiniu.js.map +1 -0
- package/lib/raccoon-adapter.d.ts +52 -2
- package/lib/raccoon-adapter.d.ts.map +1 -1
- package/lib/raccoon-adapter.js +148 -29
- package/lib/raccoon-adapter.js.map +1 -1
- package/lib/raccoon-auth.d.ts +6 -0
- package/lib/raccoon-auth.d.ts.map +1 -1
- package/lib/raccoon-auth.js +9 -1
- package/lib/raccoon-auth.js.map +1 -1
- package/lib/raccoon-credits.d.ts +38 -5
- package/lib/raccoon-credits.d.ts.map +1 -1
- package/lib/raccoon-credits.js +127 -6
- package/lib/raccoon-credits.js.map +1 -1
- package/lib/raccoon.d.ts +14 -2
- package/lib/raccoon.d.ts.map +1 -1
- package/lib/raccoon.js +14 -2
- package/lib/raccoon.js.map +1 -1
- package/lib/service.d.ts +46 -6
- package/lib/service.d.ts.map +1 -1
- package/lib/service.js +104 -16
- package/lib/service.js.map +1 -1
- package/lib/session-balance.d.ts +203 -0
- package/lib/session-balance.d.ts.map +1 -0
- package/lib/session-balance.js +279 -0
- package/lib/session-balance.js.map +1 -0
- package/lib/sign.d.ts +97 -1
- package/lib/sign.d.ts.map +1 -1
- package/lib/sign.js +174 -2
- package/lib/sign.js.map +1 -1
- package/lib/token-ledger-store.d.ts.map +1 -1
- package/lib/token-ledger-store.js +121 -27
- package/lib/token-ledger-store.js.map +1 -1
- package/lib/trae-adapter.d.ts.map +1 -1
- package/lib/trae-adapter.js +3 -1
- package/lib/trae-adapter.js.map +1 -1
- package/lib/types.d.ts +75 -15
- package/lib/types.d.ts.map +1 -1
- package/lib/types.js.map +1 -1
- package/lib/usage-badge.d.ts +77 -7
- package/lib/usage-badge.d.ts.map +1 -1
- package/lib/usage-badge.js +190 -28
- package/lib/usage-badge.js.map +1 -1
- package/lib/webdav-auto-sync.d.ts +96 -0
- package/lib/webdav-auto-sync.d.ts.map +1 -0
- package/lib/webdav-auto-sync.js +0 -0
- package/lib/webdav-auto-sync.js.map +1 -0
- package/lib/webdav-sync-crypto.d.ts +18 -0
- package/lib/webdav-sync-crypto.d.ts.map +1 -0
- package/lib/webdav-sync-crypto.js +72 -0
- package/lib/webdav-sync-crypto.js.map +1 -0
- package/lib/webdav-sync-merge.d.ts +31 -0
- package/lib/webdav-sync-merge.d.ts.map +1 -0
- package/lib/webdav-sync-merge.js +0 -0
- package/lib/webdav-sync-merge.js.map +1 -0
- package/lib/webdav-sync.d.ts +43 -7
- package/lib/webdav-sync.d.ts.map +1 -1
- package/lib/webdav-sync.js +72 -11
- package/lib/webdav-sync.js.map +1 -1
- package/lib/zcode-adapter.d.ts +4 -2
- package/lib/zcode-adapter.d.ts.map +1 -1
- package/lib/zcode-adapter.js +132 -37
- package/lib/zcode-adapter.js.map +1 -1
- package/lib/zcode-upstream.d.ts +59 -0
- package/lib/zcode-upstream.d.ts.map +1 -1
- package/lib/zcode-upstream.js +137 -2
- package/lib/zcode-upstream.js.map +1 -1
- package/package.json +5 -4
- package/lib/stepcode-adapter.d.ts +0 -158
- package/lib/stepcode-adapter.d.ts.map +0 -1
- package/lib/stepcode-adapter.js +0 -318
- package/lib/stepcode-adapter.js.map +0 -1
- package/lib/stepcode-auth.d.ts +0 -154
- package/lib/stepcode-auth.d.ts.map +0 -1
- package/lib/stepcode-auth.js +0 -287
- package/lib/stepcode-auth.js.map +0 -1
- package/lib/stepcode-oauth.d.ts +0 -194
- package/lib/stepcode-oauth.d.ts.map +0 -1
- package/lib/stepcode-oauth.js +0 -496
- package/lib/stepcode-oauth.js.map +0 -1
- package/lib/stepcode-product.d.ts +0 -255
- package/lib/stepcode-product.d.ts.map +0 -1
- package/lib/stepcode-product.js +0 -256
- package/lib/stepcode-product.js.map +0 -1
- package/lib/stepcode.d.ts +0 -230
- package/lib/stepcode.d.ts.map +0 -1
- package/lib/stepcode.js +0 -300
- package/lib/stepcode.js.map +0 -1
- package/lib/teleagent-adapter.d.ts +0 -116
- package/lib/teleagent-adapter.d.ts.map +0 -1
- package/lib/teleagent-adapter.js +0 -293
- package/lib/teleagent-adapter.js.map +0 -1
- package/lib/teleagent-auth.d.ts +0 -279
- package/lib/teleagent-auth.d.ts.map +0 -1
- package/lib/teleagent-auth.js +0 -512
- package/lib/teleagent-auth.js.map +0 -1
- package/lib/teleagent-cdp-login.d.ts +0 -100
- package/lib/teleagent-cdp-login.d.ts.map +0 -1
- package/lib/teleagent-cdp-login.js +0 -402
- package/lib/teleagent-cdp-login.js.map +0 -1
- package/lib/teleagent-credits.d.ts +0 -120
- package/lib/teleagent-credits.d.ts.map +0 -1
- package/lib/teleagent-credits.js +0 -288
- package/lib/teleagent-credits.js.map +0 -1
- package/lib/teleagent-product.d.ts +0 -196
- package/lib/teleagent-product.d.ts.map +0 -1
- package/lib/teleagent-product.js +0 -212
- package/lib/teleagent-product.js.map +0 -1
- package/lib/teleagent.d.ts +0 -288
- package/lib/teleagent.d.ts.map +0 -1
- package/lib/teleagent.js +0 -450
- package/lib/teleagent.js.map +0 -1
|
@@ -0,0 +1,689 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Qiniu(七牛云)LLM 适配器。
|
|
3
|
+
*
|
|
4
|
+
* ## 协议形态:**标准 OpenAI 兼容**,无任何厂商私有信封
|
|
5
|
+
*
|
|
6
|
+
* 与 qoder(WASM 签名 + 加密体)、trae(SOLO 双层转换)、gemini(字母序双层
|
|
7
|
+
* 信封)不同,七牛云就是标准 OpenAI 协议 —— 这正是它能**大面积复用共享抽象**的
|
|
8
|
+
* 原因:
|
|
9
|
+
*
|
|
10
|
+
* | 复用点 | 来源 |
|
|
11
|
+
* |---|---|
|
|
12
|
+
* | 消息序列化(含 0.1.7 形状归一化、工具配对剔除、图片 parts) | `openai-compat.ts` 的 `serializeMessages` |
|
|
13
|
+
* | 图片引用收集 | `openai-compat.ts` 的 `collectImages` |
|
|
14
|
+
* | SSE 消费(思考字段、工具增量合并、截断判定) | `openai-compat.ts` 的 `consumeOpenAiSse` |
|
|
15
|
+
* | 幂等注册 + Token 记账 + 失效模型剔除 | `llm-register-compat.ts` 的 `registerAdapterIdempotent` |
|
|
16
|
+
* | 附件字节桥接 | 接线层的 `makeReadImage` / `makeReadImageRequest` |
|
|
17
|
+
*
|
|
18
|
+
* **本文件不重复实现上述任何一条** —— 旧 fork 那份 `remote-upstream.ts` 曾把
|
|
19
|
+
* 消息序列化与 SSE 解帧各写一遍(且与另外两份实现**不一致**,实测漏掉了
|
|
20
|
+
* `prompt_tokens_details.cached_tokens`,导致七牛云承接的步长永远显示「缓存命中 0」,
|
|
21
|
+
* 见旧 fork `src/transport/usage.ts:4-8`)。这里直接走共享实现,从根本上避免分叉。
|
|
22
|
+
*
|
|
23
|
+
* ## 轮换语义:「类别 → 动作」表(不照抄循环骨架)
|
|
24
|
+
*
|
|
25
|
+
* AGENTS.md 有一节专门讲这个(2026-10-06 的事故:照抄循环骨架、漏抄分支语义表,
|
|
26
|
+
* 导致全池 6 个账号各被封 24h)。本适配器的表:
|
|
27
|
+
*
|
|
28
|
+
* | 类别 | 换号? | 写限流标记? | 抛什么 |
|
|
29
|
+
* |---|---|---|---|
|
|
30
|
+
* | `auth`(401/403) | 换 | **不写** | 全试完则抛 `AUTH`(保留服务端原文) |
|
|
31
|
+
* | `rate_limit`(429) | 换 | **写**(服务端给了 `retry-after` 就用它,否则指数退避、封顶 30 分钟) | 全试完抛 `QUOTA_EXCEEDED` |
|
|
32
|
+
* | `quota`(额度耗尽) | 换 | **写**(当日 24h) | 同上 |
|
|
33
|
+
* | `invalid_request`(400/422) | **不换** | 不写 | 直接抛 `BAD_REQUEST` |
|
|
34
|
+
* | `server`(5xx) | 换 | **不写**(不是配额问题) | 全试完抛原错误 |
|
|
35
|
+
* | `transport`(网络) | 换 | **不写** | 全试完抛原错误 |
|
|
36
|
+
*
|
|
37
|
+
* ⚠️ **认证类绝不写限流标记**:七牛云的网关在异常时可能对全池回 401,
|
|
38
|
+
* 若按「凡可换号就写冷却」处理,一个请求内就能把整池账号全部标记掉
|
|
39
|
+
* (正是 2026-10-06 事故的形态)。
|
|
40
|
+
*
|
|
41
|
+
* ## ⚠️ 已产出内容的流不重放
|
|
42
|
+
*
|
|
43
|
+
* 轮换只在**尚未 yield 任何 chunk** 时发生。一旦开始产出,再失败只能上抛 ——
|
|
44
|
+
* 否则用户会看到两份重复输出(`openai-compat` 的模块头有同款说明)。
|
|
45
|
+
*
|
|
46
|
+
* @module src/qiniu-adapter.ts
|
|
47
|
+
*/
|
|
48
|
+
import { CONTEXT_WINDOW_EXCEEDED_CODE, LlmAdapter, LlmError, ReasoningEffortId, } from '@deepseek-ai/dsh-llm';
|
|
49
|
+
import { createModelCatalog } from './model-catalog.js';
|
|
50
|
+
import { QINIU, QINIU_FALLBACK_MODELS, classifyQiniuError, } from './qiniu-product.js';
|
|
51
|
+
import { qiniuChatUrl, qiniuHeaders, normalizeQiniuModelId } from './qiniu.js';
|
|
52
|
+
import { buildQiniuPayload } from './qiniu-messages.js';
|
|
53
|
+
import { collectImages, consumeOpenAiSse, httpErrorCode, serializeMessages } from './openai-compat.js';
|
|
54
|
+
// ⚠️ 复用**共享** abort 判据,不自写第二份(该函数自己的注释记载:仓库此前已有
|
|
55
|
+
// 4 份同义实现,明令「别再添第五份」)。
|
|
56
|
+
import { isAbortLike } from './aggregate-adapter.js';
|
|
57
|
+
import { registerAdapterIdempotent } from './llm-register-compat.js';
|
|
58
|
+
import { nextUtc8DayStartMs } from './model-queue.js';
|
|
59
|
+
import { retryAfterMsFromResponse } from './retry-after.js';
|
|
60
|
+
import { reportLedgerAccount } from './token-ledger.js';
|
|
61
|
+
/** 默认目录缓存 TTL(5 分钟,与 opencode 同档)。 */
|
|
62
|
+
const DEFAULT_CATALOG_TTL_MS = 300_000;
|
|
63
|
+
/**
|
|
64
|
+
* 目录缓存。
|
|
65
|
+
*
|
|
66
|
+
* ⚠️ 按 **apiKey** 分开存:不同账号(不同区/不同额度档)可见的模型可能不同 ——
|
|
67
|
+
* 共用一份缓存会让新加的账号迟迟看不到它自己那批模型(与 opencode 同因)。
|
|
68
|
+
*/
|
|
69
|
+
const catalogCache = new Map();
|
|
70
|
+
/** 清空目录缓存(RPC 的「刷新目录」与单测隔离用)。 */
|
|
71
|
+
export function clearQiniuCatalogCache() {
|
|
72
|
+
catalogCache.clear();
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* 解析远端 `GET /v1/models` 的响应体。
|
|
76
|
+
*
|
|
77
|
+
* ## ⚠️ 三个字段都**尽力而为**,拿不到就回落到兜底表的值
|
|
78
|
+
*
|
|
79
|
+
* 实测(2026-10-29 直连 https://api.qnaigc.com/v1/models,HTTP 200、80+ 条):
|
|
80
|
+
* 每条**带 `context_length` 与 `max_tokens`**(部分为 0),**不下发模态**。
|
|
81
|
+
* 故:
|
|
82
|
+
*
|
|
83
|
+
* - 窗口按 `context_length` → `context_window` → `limit.context` 三级取值 ——
|
|
84
|
+
* 拿不到时**从兜底表按 id 查**(查到就用,查不到留 `0` 哨兵)。⚠️ **绝不编造数字**:
|
|
85
|
+
* `contextWindow` 是 DSH 自动压缩阈值的输入,编一个会让压缩在错误的位置触发
|
|
86
|
+
* (opencode 的 issue IKJJ68 同因);
|
|
87
|
+
* - `modalities.input` 含 `image` 才算支持图片;拿不到时同样回落到兜底表 ——
|
|
88
|
+
* 本仓库的硬约定是「**声明支持就必须真支持**」,故**未知一律按不支持**处理
|
|
89
|
+
* (除兜底表里明确记着支持的);
|
|
90
|
+
* - 窗口/模态**都只认「远端明确给出」或「兜底表明确记着」**,不猜。
|
|
91
|
+
*/
|
|
92
|
+
export function parseQiniuCatalog(body) {
|
|
93
|
+
const data = body?.data;
|
|
94
|
+
if (!Array.isArray(data))
|
|
95
|
+
return [];
|
|
96
|
+
const entries = [];
|
|
97
|
+
const seen = new Set();
|
|
98
|
+
for (const raw of data) {
|
|
99
|
+
if (typeof raw !== 'object' || raw === null)
|
|
100
|
+
continue;
|
|
101
|
+
const record = raw;
|
|
102
|
+
const id = typeof record.id === 'string' ? normalizeQiniuModelId(record.id) : '';
|
|
103
|
+
if (id.length === 0 || seen.has(id))
|
|
104
|
+
continue;
|
|
105
|
+
seen.add(id);
|
|
106
|
+
const fallback = QINIU_FALLBACK_MODELS.find((m) => m.id === id);
|
|
107
|
+
const name = typeof record.name === 'string' && record.name.trim().length > 0
|
|
108
|
+
? record.name.trim()
|
|
109
|
+
: fallback?.name ?? id;
|
|
110
|
+
// ⚠️ 顺序 = 权威度:七牛云实测下发的是 `context_length`,另两个是别家
|
|
111
|
+
// 兼容网关的同义写法(保留以兼容未来反向代理层)。
|
|
112
|
+
const remoteCtx = typeof record.context_length === 'number'
|
|
113
|
+
? record.context_length
|
|
114
|
+
: typeof record.context_window === 'number'
|
|
115
|
+
? record.context_window
|
|
116
|
+
: typeof record.limit?.context === 'number' ? record.limit.context : 0;
|
|
117
|
+
const contextWindow = Number.isSafeInteger(remoteCtx) && remoteCtx > 0
|
|
118
|
+
? remoteCtx
|
|
119
|
+
: fallback?.contextWindow ?? 0;
|
|
120
|
+
// ⚠️ 未知一律按**不支持**图片(硬约定:声明支持就必须真支持)。
|
|
121
|
+
// 只有远端明确列了 image,或兜底表明确记着支持,才算支持。
|
|
122
|
+
const remoteModalities = Array.isArray(record.modalities?.input)
|
|
123
|
+
? record.modalities.input.filter((v) => typeof v === 'string')
|
|
124
|
+
: undefined;
|
|
125
|
+
const supportsImage = remoteModalities === undefined
|
|
126
|
+
? fallback?.supportsImage ?? false
|
|
127
|
+
: remoteModalities.includes('image');
|
|
128
|
+
entries.push({
|
|
129
|
+
id,
|
|
130
|
+
name,
|
|
131
|
+
contextWindow,
|
|
132
|
+
supportsImage,
|
|
133
|
+
...fallback?.efforts === undefined ? {} : { efforts: fallback.efforts },
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
return entries;
|
|
137
|
+
}
|
|
138
|
+
/**
|
|
139
|
+
* 拉取远端目录,失败回退静态兜底。
|
|
140
|
+
*
|
|
141
|
+
* @param ttlMs 命中内存缓存的窗口;测试传 0 强制每次都拉。
|
|
142
|
+
*
|
|
143
|
+
* ⚠️ **必须有超时**(接线层给):桌面版到外部域名的 fetch 可能**永不 settle**
|
|
144
|
+
* (opencode 的真机事故 2026-10-02:没有超时 → `listModels` 永不返回 →
|
|
145
|
+
* **模型列表与徽标同时空白**)。有超时则超时后回退兜底表,UI 立刻可用。
|
|
146
|
+
*/
|
|
147
|
+
export async function loadQiniuCatalog(fetchCatalog, apiKey, ttlMs = DEFAULT_CATALOG_TTL_MS, signal) {
|
|
148
|
+
const cached = catalogCache.get(apiKey);
|
|
149
|
+
if (cached !== undefined && ttlMs > 0 && Date.now() - cached.at < ttlMs)
|
|
150
|
+
return cached.entries;
|
|
151
|
+
let entries;
|
|
152
|
+
try {
|
|
153
|
+
const response = await fetchCatalog(apiKey, signal);
|
|
154
|
+
if (!response.ok)
|
|
155
|
+
throw new Error(`HTTP ${response.status}`);
|
|
156
|
+
const parsed = parseQiniuCatalog(await response.json());
|
|
157
|
+
if (parsed.length === 0)
|
|
158
|
+
throw new Error('空目录');
|
|
159
|
+
entries = parsed;
|
|
160
|
+
}
|
|
161
|
+
catch {
|
|
162
|
+
entries = QINIU_FALLBACK_MODELS.map((m) => ({
|
|
163
|
+
id: m.id,
|
|
164
|
+
name: m.name,
|
|
165
|
+
contextWindow: m.contextWindow,
|
|
166
|
+
supportsImage: m.supportsImage,
|
|
167
|
+
...m.efforts === undefined ? {} : { efforts: m.efforts },
|
|
168
|
+
}));
|
|
169
|
+
}
|
|
170
|
+
catalogCache.set(apiKey, { at: Date.now(), entries });
|
|
171
|
+
return entries;
|
|
172
|
+
}
|
|
173
|
+
/** 限流退避上限:服务端再狠也不让它单次阻塞超过 30 分钟。 */
|
|
174
|
+
const RETRY_AFTER_CAP_MS = 30 * 60_000;
|
|
175
|
+
/** 首次 429 的默认冷却。 */
|
|
176
|
+
const RATE_LIMIT_BASE_MS = 60_000;
|
|
177
|
+
/**
|
|
178
|
+
* 把「错误语义 + 服务端给的延迟」换算成该槽该模型的受限时长。
|
|
179
|
+
*
|
|
180
|
+
* ⚠️ **服务端给了就用它的**,且 **0 是合法值**(「立即解除」而非「未知」):
|
|
181
|
+
* 必须用 `=== undefined` 判空,写成任何 falsy 判据都会把 0 静默换成 1 小时
|
|
182
|
+
* (`src/retry-after.ts` 的模块头记录了这条教训)。
|
|
183
|
+
*/
|
|
184
|
+
export function qiniuRetryAfterMs(kind, retryAfterMs, attempt,
|
|
185
|
+
/** 注入时钟(单测用);默认 `Date.now()`。与仓库其它时间函数同约定。 */
|
|
186
|
+
nowMs = Date.now()) {
|
|
187
|
+
if (retryAfterMs !== undefined)
|
|
188
|
+
return Math.max(0, Math.min(retryAfterMs, RETRY_AFTER_CAP_MS));
|
|
189
|
+
// ⚠️ 额度耗尽的冷却必须对齐**七牛额度的重置时刻**,不能用固定 24h。
|
|
190
|
+
//
|
|
191
|
+
// 七牛云的额度规则(用户 2026-07-14 当面确认,与网页控制台一致):
|
|
192
|
+
// - 每个账号**每日 250 七牛额度**,**按 UTC+8 自然日重置**;
|
|
193
|
+
// - 旗舰档模型(deepseek-v4.1-flash / v4-pro 等)**每次调用固定扣 2 七牛额度**,
|
|
194
|
+
// 与 token 数无关 ⇒ 一天约 125 次调用。
|
|
195
|
+
//
|
|
196
|
+
// 用固定 24h 的问题:在 23:50 撞到额度耗尽,会被冷却到**次日 23:50** ——
|
|
197
|
+
// 而额度次日 00:00 就恢复了,白等近 24 小时(旧 fork `key-pool.ts` 记录了
|
|
198
|
+
// 同款现象,它当时用「固定 1 小时 TTL」近似,代价是要反复空试)。
|
|
199
|
+
// 复用仓库既有的 `nextUtc8DayStartMs()`(`model-queue.ts`,与签到/聚合
|
|
200
|
+
// 同一口径),一次算准。
|
|
201
|
+
if (kind === 'quota')
|
|
202
|
+
return Math.max(0, nextUtc8DayStartMs(nowMs) - nowMs);
|
|
203
|
+
return Math.min(RATE_LIMIT_BASE_MS * 2 ** Math.max(0, attempt - 1), RETRY_AFTER_CAP_MS);
|
|
204
|
+
}
|
|
205
|
+
export class QiniuAdapter extends LlmAdapter {
|
|
206
|
+
options;
|
|
207
|
+
product;
|
|
208
|
+
/**
|
|
209
|
+
* 最近一次成功解析出的目录快照(**仅供同步路径**读取)。
|
|
210
|
+
*
|
|
211
|
+
* ⚠️ 它不是缓存 —— 权威缓存仍是 `loadQiniuCatalog` 那份带 TTL 的
|
|
212
|
+
* (见 `catalog()` 的注释:在适配器上另立缓存会让目录永不过期)。
|
|
213
|
+
* 这里只是把「上一次的结果」留给 `listAllModels()` 那个**必须同步**的调用者。
|
|
214
|
+
*/
|
|
215
|
+
lastCatalog;
|
|
216
|
+
/**
|
|
217
|
+
* 共享目录骨架(`model-catalog.ts`)——**黑名单 / 关闭意图 / 模态回填 / 映射**
|
|
218
|
+
* 的唯一实现处(2026-10-23 迁移,见 `listModels` 的注释)。
|
|
219
|
+
*/
|
|
220
|
+
skeletonCatalog;
|
|
221
|
+
constructor(options) {
|
|
222
|
+
super();
|
|
223
|
+
this.options = options;
|
|
224
|
+
this.product = options.product ?? QINIU;
|
|
225
|
+
// ⚠️⚠️ **`accountPool` 必须是真池**:骨架里 `deps.accountPool?.disabledModelsFor`
|
|
226
|
+
// 与 `providerClosedFor?.(...)` 全靠它;传 `{}` 或 `undefined` 会让
|
|
227
|
+
// `?.` 变成静默 no-op(Gitee IKP8OF 实测过的形态:关掉的模型照样可选、
|
|
228
|
+
// 关整个供应商也无效,且零报错零日志)。
|
|
229
|
+
this.skeletonCatalog = createModelCatalog(this.options.accountPool === undefined ? {} : { accountPool: this.options.accountPool }, {
|
|
230
|
+
product: this.product,
|
|
231
|
+
loadCatalog: () => this.loadCatalogEntries(),
|
|
232
|
+
syncCatalog: () => this.syncCatalogEntries(),
|
|
233
|
+
// ⚠️ 未知 id **保守报 `['text']`**:本家的能力来自远端能力表,
|
|
234
|
+
// 查不到时把「未知」当成「支持」会让 DSH 把图片投影成上游不接受的形态
|
|
235
|
+
// (与本文件迁移前的手写口径逐字一致)。
|
|
236
|
+
unknownModelInputModalities: () => ['text'],
|
|
237
|
+
});
|
|
238
|
+
}
|
|
239
|
+
/**
|
|
240
|
+
* 异步读目录并转成骨架的中间结构(`CatalogEntry[]`)。
|
|
241
|
+
*
|
|
242
|
+
* ⚠️ **本家独有的门控放这里**:没有可用槽位时返回 `[]`
|
|
243
|
+
* (骨架把它当「目录为空」⇒ `listModels` 吐空数组 ⇒ 隐藏整个 provider 分组,
|
|
244
|
+
* 与本文件迁移前那条 `if (slots.length === 0) return []` 逐字等价)。
|
|
245
|
+
*/
|
|
246
|
+
async loadCatalogEntries() {
|
|
247
|
+
const slots = await this.options.slots();
|
|
248
|
+
if (slots.length === 0)
|
|
249
|
+
return [];
|
|
250
|
+
return (await this.catalog()).map((m) => this.toCatalogEntry(m));
|
|
251
|
+
}
|
|
252
|
+
/**
|
|
253
|
+
* **同步**全量目录(`listAllModels()` 用)。
|
|
254
|
+
*
|
|
255
|
+
* ⚠️ 与 `loadCatalogEntries` 的差别只在「等不等远端」:这里读上一轮缓存,
|
|
256
|
+
* 缓存为空时用兜底表并**顺手**触发一次后台预热(同步契约见 `listAllModels`)。
|
|
257
|
+
*/
|
|
258
|
+
syncCatalogEntries() {
|
|
259
|
+
const remote = this.snapshotCatalog();
|
|
260
|
+
if (remote !== undefined)
|
|
261
|
+
return remote.map((m) => this.toCatalogEntry(m));
|
|
262
|
+
void this.warmCatalog();
|
|
263
|
+
return QINIU_FALLBACK_MODELS.map((m) => this.toCatalogEntry({
|
|
264
|
+
id: m.id,
|
|
265
|
+
name: m.name,
|
|
266
|
+
contextWindow: m.contextWindow,
|
|
267
|
+
supportsImage: m.supportsImage,
|
|
268
|
+
...m.efforts === undefined ? {} : { efforts: m.efforts },
|
|
269
|
+
}));
|
|
270
|
+
}
|
|
271
|
+
/** 本家私有形状 → 骨架的 `CatalogEntry`(**唯一**转换点)。 */
|
|
272
|
+
toCatalogEntry(m) {
|
|
273
|
+
return {
|
|
274
|
+
id: m.id,
|
|
275
|
+
name: m.name,
|
|
276
|
+
// ⚠️ 能力表缺失/未知时**一律回退 `['text']`**(硬约定:声明支持就必须
|
|
277
|
+
// 真支持)。把「查不到」当成「支持」会让 DSH 把图片投影成上游不接受的形态。
|
|
278
|
+
inputModalities: m.supportsImage
|
|
279
|
+
? ['text', 'image']
|
|
280
|
+
: ['text'],
|
|
281
|
+
// ⚠️ 窗口未知**不编造**(0 是「不知道」哨兵)⇒ 省略该字段。
|
|
282
|
+
...(m.contextWindow ?? 0) > 0 ? { contextWindow: m.contextWindow } : {},
|
|
283
|
+
// ⚠️ 档位经 `qiniuReasoningOf` 归一(`defaultEffort` 必须落在 `efforts` 内)。
|
|
284
|
+
...(() => {
|
|
285
|
+
const efforts = m.efforts ?? [];
|
|
286
|
+
if (efforts.length === 0)
|
|
287
|
+
return {};
|
|
288
|
+
return {
|
|
289
|
+
reasoning: {
|
|
290
|
+
efforts: efforts.map((effort) => ({
|
|
291
|
+
// ⚠️ `id` 是**品牌类型**(`ReasoningEffortId`),必须经构造函数。
|
|
292
|
+
id: ReasoningEffortId(effort),
|
|
293
|
+
// ⚠️ 没有官方中文名时回退到 id 本身 —— 宁可显示英文原值,
|
|
294
|
+
// 也不猜一个可能错译的中文(与 opencode 同取向)。
|
|
295
|
+
name: effort === 'none' ? '关闭' : effort,
|
|
296
|
+
})),
|
|
297
|
+
},
|
|
298
|
+
};
|
|
299
|
+
})(),
|
|
300
|
+
};
|
|
301
|
+
}
|
|
302
|
+
providerInfo(provider) {
|
|
303
|
+
const id = typeof provider === 'string' && provider.length > 0 ? provider : this.product.id;
|
|
304
|
+
return { id, name: this.product.displayName };
|
|
305
|
+
}
|
|
306
|
+
/**
|
|
307
|
+
* 完整目录(**同步**返回数组)。
|
|
308
|
+
*
|
|
309
|
+
* ⚠️ **绝不能写成 async**:`jet-hub-rpc.ts` 的 `ModelCatalogSource` 接口是
|
|
310
|
+
* 同步的且消费者**不 await**(`catalog = [...all]`),返回 Promise 会抛
|
|
311
|
+
* `TypeError: all is not iterable`(minimax 的同款真实缺陷)。
|
|
312
|
+
*/
|
|
313
|
+
listAllModels() {
|
|
314
|
+
// ⚠️ 远端优先,但**必须同步返回**(见上方注释):故读的是**上一轮**拉到的缓存,
|
|
315
|
+
// 缓存为空时用兜底表,并**顺手**触发一次后台刷新 —— 下次调用即拿到远端目录。
|
|
316
|
+
// 这与 cline 的 `this.remoteModels ?? this.fallbackCatalog()` + `ensureRemoteModels()`
|
|
317
|
+
// 是同一范式(见 `cline-adapter.ts:480`)。
|
|
318
|
+
//
|
|
319
|
+
// 为什么必须这么做:「显示列表」(模型黑名单)逐 id 开关,来源正是本方法。
|
|
320
|
+
// 只回兜底表的两个模型 ⇒ 远端另外几十个模型**在 UI 里根本不存在**,
|
|
321
|
+
// 用户无从开关(真实缺陷,2026-07-14 实测:七牛云远端 35 个、兜底 2 个)。
|
|
322
|
+
const remote = this.snapshotCatalog();
|
|
323
|
+
if (remote !== undefined)
|
|
324
|
+
return remote.map((m) => ({ id: m.id, name: m.name }));
|
|
325
|
+
void this.warmCatalog();
|
|
326
|
+
return QINIU_FALLBACK_MODELS.map((m) => ({ id: m.id, name: m.name }));
|
|
327
|
+
}
|
|
328
|
+
/**
|
|
329
|
+
* 同步取「已缓存的远端目录」;没有缓存则返回 undefined。
|
|
330
|
+
*
|
|
331
|
+
* ⚠️ 只读缓存、**绝不发起网络请求** —— 本方法在 UI 的同步路径上被调用
|
|
332
|
+
* (`catalog = [...all]`,见 `jet-hub-rpc.ts` 的 `fullCatalogIds`)。
|
|
333
|
+
*/
|
|
334
|
+
snapshotCatalog() {
|
|
335
|
+
const cached = this.lastCatalog;
|
|
336
|
+
return cached === undefined || cached.length === 0 ? undefined : cached;
|
|
337
|
+
}
|
|
338
|
+
/** 后台预热一次目录;失败静默(兜底表已保证 UI 可用)。 */
|
|
339
|
+
async warmCatalog() {
|
|
340
|
+
try {
|
|
341
|
+
await this.catalog();
|
|
342
|
+
}
|
|
343
|
+
catch {
|
|
344
|
+
// 兜底表已保证可用,预热失败不值得打扰用户。
|
|
345
|
+
}
|
|
346
|
+
}
|
|
347
|
+
/** 当前生效的目录(远端优先,失败回退兜底)。 */
|
|
348
|
+
async catalog() {
|
|
349
|
+
const slots = await this.options.slots();
|
|
350
|
+
const slot = slots[0];
|
|
351
|
+
if (this.options.fetchRemoteCatalog === undefined || slot === undefined) {
|
|
352
|
+
// ⚠️ 这里**不写** lastCatalog:没有远端能力时它永远是兜底表,
|
|
353
|
+
// 记下来只会让 listAllModels 走一条与本分支结果相同的弯路。
|
|
354
|
+
return QINIU_FALLBACK_MODELS.map((m) => ({
|
|
355
|
+
id: m.id,
|
|
356
|
+
name: m.name,
|
|
357
|
+
contextWindow: m.contextWindow,
|
|
358
|
+
supportsImage: m.supportsImage,
|
|
359
|
+
...m.efforts === undefined ? {} : { efforts: m.efforts },
|
|
360
|
+
}));
|
|
361
|
+
}
|
|
362
|
+
// ⚠️ **不要**在适配器上再 memoize 一份:那会让目录永不过期。
|
|
363
|
+
// 刷新职责交给带 TTL 的 `loadQiniuCatalog`。
|
|
364
|
+
const entries = await loadQiniuCatalog(this.options.fetchRemoteCatalog, slot.apiKey);
|
|
365
|
+
// 留给 `listAllModels()`(它必须同步返回)。只记远端**成功**的结果;
|
|
366
|
+
// 兜底表已由 `loadQiniuCatalog` 在失败时返回,记不记都一样。
|
|
367
|
+
this.lastCatalog = entries;
|
|
368
|
+
return entries;
|
|
369
|
+
}
|
|
370
|
+
/**
|
|
371
|
+
* 模型选择器的目录 —— **委托共享骨架**(`model-catalog.ts`)。
|
|
372
|
+
*
|
|
373
|
+
* ## ⚠️⚠️ 2026-10-23 迁移(用户要求:实体 provider 一律走共享骨架)
|
|
374
|
+
*
|
|
375
|
+
* 迁移前本方法是**手写**的,自己做了四件事:判 `providerClosed`、
|
|
376
|
+
* 判 `providerCatalogVisible`、过滤 `disabledModels`、手工 map 成
|
|
377
|
+
* `LlmModelInfo`。其中 ①③④ 与其余 13 家**逐字同义** —— 而「同义的两份实现」
|
|
378
|
+
* 正是本仓库红线(`docs/agent-notes/misc.md` 的「一文件两套同义判据」),
|
|
379
|
+
* 也是 Gitee IKP8OF 那类漂移缺陷的温床(各写一份 ⇒ 新入口漏接线就静默失效)。
|
|
380
|
+
*
|
|
381
|
+
* 现在四条全部由骨架承担,本方法只剩一行委托:
|
|
382
|
+
* - 关闭意图 / 黑名单 / 模态回填 / `provider` 回填 ⇒ `createModelCatalog`;
|
|
383
|
+
* - **本家独有的门控**(没有可用槽位时隐藏)⇒ 放进 `loadCatalog`
|
|
384
|
+
* (返回 `[]` 即「目录为空」,与骨架的既有语义一致)。
|
|
385
|
+
*/
|
|
386
|
+
async listModels(_provider) {
|
|
387
|
+
return await this.skeletonCatalog.listModels(_provider);
|
|
388
|
+
}
|
|
389
|
+
async resolveModel(provider, model, _signal) {
|
|
390
|
+
const id = normalizeQiniuModelId(model);
|
|
391
|
+
const all = await this.catalog();
|
|
392
|
+
const entry = all.find((m) => m.id === id);
|
|
393
|
+
const resolved = {
|
|
394
|
+
provider,
|
|
395
|
+
id,
|
|
396
|
+
name: entry?.name ?? id,
|
|
397
|
+
inputModalities: entry?.supportsImage === true
|
|
398
|
+
? ['text', 'image']
|
|
399
|
+
: ['text'],
|
|
400
|
+
};
|
|
401
|
+
// ⚠️ 窗口未知**不编造**:0 是「不知道」哨兵,不能当合法窗口下发 ——
|
|
402
|
+
// 自动压缩会拿它算阈值并抛
|
|
403
|
+
// `TargetPressureConfigError: contextWindow (…) must be a positive integer`。
|
|
404
|
+
const contextWindow = entry?.contextWindow ?? 0;
|
|
405
|
+
if (contextWindow > 0)
|
|
406
|
+
resolved.context = { contextWindow };
|
|
407
|
+
// ⚠️ 档位为**空**时**不声明**本字段(而不是给 `efforts: []`):
|
|
408
|
+
// DSH 的判定是 `resolved.reasoning === undefined ? undefined : {…}`,
|
|
409
|
+
// 声明空数组会让 UI 出现一个没有任何档位的空选择器(opencode 的 issue IKJJ0V)。
|
|
410
|
+
const efforts = entry?.efforts ?? [];
|
|
411
|
+
if (efforts.length > 0) {
|
|
412
|
+
resolved.reasoning = {
|
|
413
|
+
efforts: efforts.map((effort) => ({
|
|
414
|
+
// ⚠️ `id` 是**品牌类型**(`ReasoningEffortId`),必须经它的构造函数。
|
|
415
|
+
id: ReasoningEffortId(effort),
|
|
416
|
+
// ⚠️ 没有官方中文名时回退到 id 本身 —— 宁可显示英文原值,
|
|
417
|
+
// 也不猜一个可能错译的中文(与 opencode 同取向)。
|
|
418
|
+
name: effort === 'none' ? '关闭' : effort,
|
|
419
|
+
})),
|
|
420
|
+
};
|
|
421
|
+
}
|
|
422
|
+
// ⚠️ **刻意不声明 `defaultMaxTokens`**:DSH 的契约是「用户未指定
|
|
423
|
+
// `max_tokens` 时直接拿它填请求」,而下发等于**我们替用户决定**每轮按上限
|
|
424
|
+
// 请求。七牛云的能力表里根本没有可靠的输出上限来源 ⇒ 不下发。
|
|
425
|
+
return resolved;
|
|
426
|
+
}
|
|
427
|
+
async prepareCall(provider, model, signal) {
|
|
428
|
+
return { model: await this.resolveModel(provider, model, signal), stream: (o) => this.stream(o) };
|
|
429
|
+
}
|
|
430
|
+
/**
|
|
431
|
+
* 解析消息里的图片附件为 data URL。
|
|
432
|
+
*
|
|
433
|
+
* ⚠️ **模型不支持图片时直接抛 `UNSUPPORTED_CONTENT`**(而不是静默丢弃)——
|
|
434
|
+
* 静默丢弃会让用户以为模型看到了图(Qoder 图片事故的教训)。
|
|
435
|
+
* ⚠️ 附件字节读不出来时**不写入该条**:`openai-compat` 的
|
|
436
|
+
* `userContentParts` 遇到缺失会产出 `[image unavailable]` 占位,
|
|
437
|
+
* 至少让模型知道「这里本该有张图但没拿到」,而不是消息里凭空少一块。
|
|
438
|
+
*/
|
|
439
|
+
async resolveImageUrls(model, messages) {
|
|
440
|
+
const refs = new Map();
|
|
441
|
+
for (const message of messages) {
|
|
442
|
+
if (Array.isArray(message.content))
|
|
443
|
+
collectImages(message.content, refs);
|
|
444
|
+
}
|
|
445
|
+
if (refs.size === 0)
|
|
446
|
+
return undefined;
|
|
447
|
+
const all = await this.catalog();
|
|
448
|
+
const entry = all.find((m) => m.id === normalizeQiniuModelId(model));
|
|
449
|
+
if (entry?.supportsImage !== true) {
|
|
450
|
+
throw new LlmError(`qiniu: 模型 "${model}" 不支持图片输入(能力以远端目录/兜底表为准)`, 'UNSUPPORTED_CONTENT');
|
|
451
|
+
}
|
|
452
|
+
if (this.options.readImage === undefined) {
|
|
453
|
+
throw new LlmError('qiniu: 图片输入需要附件服务', 'UNSUPPORTED_CONTENT');
|
|
454
|
+
}
|
|
455
|
+
const readImage = this.options.readImage;
|
|
456
|
+
const out = new Map();
|
|
457
|
+
for (const [id, ref] of refs) {
|
|
458
|
+
const image = await readImage(ref);
|
|
459
|
+
if (image === undefined)
|
|
460
|
+
continue;
|
|
461
|
+
out.set(id, `data:${image.mediaType};base64,${Buffer.from(image.data).toString('base64')}`);
|
|
462
|
+
}
|
|
463
|
+
return out;
|
|
464
|
+
}
|
|
465
|
+
/**
|
|
466
|
+
* 轮换:失败按「语义」标记该槽 → 换下一槽重发。
|
|
467
|
+
*
|
|
468
|
+
* 三条硬规则(见模块头的表):
|
|
469
|
+
* 1. `tried` **跨迭代保留** —— 每次重置会让两个槽之间无限来回;
|
|
470
|
+
* 2. **已交付内容的流不重放**;
|
|
471
|
+
* 3. **认证类不写限流标记**(写它会放大成「全池被封」)。
|
|
472
|
+
*/
|
|
473
|
+
async *stream(options) {
|
|
474
|
+
// ⚠️ 传 modelId:接线层据此跳过「该模型正处于限流窗口」的账号。
|
|
475
|
+
const slots = await this.options.slots(options.model);
|
|
476
|
+
if (slots.length === 0) {
|
|
477
|
+
throw new LlmError(
|
|
478
|
+
// ⚠️ 这条文案是用户**唯一**的出路(没有凭据时列表也是空的),故必须给出
|
|
479
|
+
// 与控制台一致的入口:AI 大模型推理 / API Key(与 `qiniu-rpc.ts` 的报错同源)。
|
|
480
|
+
'qiniu: 没有可用账号。请在 Jet Hub 的 Qiniu 面板粘贴一个 API Key'
|
|
481
|
+
+ '(https://portal.qiniu.com/ai-inference/api-key 创建)。', 'MISSING_CREDENTIAL');
|
|
482
|
+
}
|
|
483
|
+
const tried = new Set();
|
|
484
|
+
const limited = [];
|
|
485
|
+
for (;;) {
|
|
486
|
+
const slot = slots.find((s) => !tried.has(s.id));
|
|
487
|
+
if (slot === undefined) {
|
|
488
|
+
throw new LlmError(`qiniu: 所有账号对该模型均受限${limited.length > 0 ? `(${limited.join('、')})` : ''}`, 'QUOTA_EXCEEDED');
|
|
489
|
+
}
|
|
490
|
+
tried.add(slot.id);
|
|
491
|
+
// Token 账本:回报「本笔请求实际使用的槽」。
|
|
492
|
+
reportLedgerAccount(this.product.id, slot.id);
|
|
493
|
+
let delivered = false;
|
|
494
|
+
try {
|
|
495
|
+
for await (const chunk of this.streamVia(slot, options)) {
|
|
496
|
+
// ⚠️ **任何 chunk 产出都算「已交付」**:`StreamChunk` 联合里没有
|
|
497
|
+
// 「内容之前的前置事件」,保守取「一律算交付」—— 宁可漏掉一次可切换
|
|
498
|
+
// 的机会,也绝不重放。
|
|
499
|
+
delivered = true;
|
|
500
|
+
yield chunk;
|
|
501
|
+
}
|
|
502
|
+
return;
|
|
503
|
+
}
|
|
504
|
+
catch (error) {
|
|
505
|
+
if (delivered)
|
|
506
|
+
throw error;
|
|
507
|
+
if (error instanceof LlmError && error.code === 'QUOTA_EXCEEDED')
|
|
508
|
+
throw error;
|
|
509
|
+
// ⚠️⚠️ **取消 / 超时必须在此立刻抛出,且排在所有分类之前**
|
|
510
|
+
// (2026-10-17 审计 P2 修复)。此前轮换循环**从不检查中止**:取消产生的
|
|
511
|
+
// `AbortError` 消息不命中任何分类关键词 ⇒ 落到兜底 `server` 分支 ⇒ 被当成
|
|
512
|
+
// 「换个号再试」⇒ 取消之后**继续发请求**(实测取消后仍多打 2 次),且全池
|
|
513
|
+
// 耗尽后抛 `QUOTA_EXCEEDED`「所有账号对该模型均受限」—— 用户明明点了取消,
|
|
514
|
+
// 看到的却是「额度用尽」。
|
|
515
|
+
// ⚠️ 用**共享** `isAbortLike`(`aggregate-adapter.ts` 导出,仓库唯一一份):
|
|
516
|
+
// 它覆盖 `signal.aborted`、`AbortError`、`code === 'ABORTED'` 与上游 499 报文。
|
|
517
|
+
if (isAbortLike(error, options.signal)) {
|
|
518
|
+
throw error;
|
|
519
|
+
}
|
|
520
|
+
const info = classifyQiniuFailure(error);
|
|
521
|
+
if (info.kind === 'invalid_request') {
|
|
522
|
+
// 400/422:**换号无益**(每个槽发的是同一个体,形状问题与账号无关),
|
|
523
|
+
// 且七牛云对形状极严格(工具未包装事故)⇒ 带上服务端原文直接上抛。
|
|
524
|
+
throw new LlmError(`qiniu: 请求被上游拒绝(${info.detail})`, 'BAD_REQUEST');
|
|
525
|
+
}
|
|
526
|
+
if (info.kind === 'auth') {
|
|
527
|
+
// 认证失败:**标记并切下一个账号是对的,但不写限流标记**。
|
|
528
|
+
// 也不能在试完全部槽后报「所有账号均受限」—— 真实原因通常是
|
|
529
|
+
// 「这条 Key 无效」,与额度无关。故最后一次失败**直接透传原文**。
|
|
530
|
+
if (tried.size >= slots.length)
|
|
531
|
+
throw error;
|
|
532
|
+
limited.push(`${slot.id}(认证失败)`);
|
|
533
|
+
continue;
|
|
534
|
+
}
|
|
535
|
+
if (info.kind === 'server' || info.kind === 'transport') {
|
|
536
|
+
// 上游故障/网络问题:**不写标记**(不是配额问题),只换下一个。
|
|
537
|
+
this.options.warn?.(`qiniu: 账号 ${slot.id} ${info.kind},换下一个:${info.detail}`);
|
|
538
|
+
// ⚠️⚠️ **换号有意义只在「故障是账号级」时**(2026-10-17 审计 P1 修复)。
|
|
539
|
+
// 本分支此前无条件 `continue` ⇒ 换号直到槽耗尽 ⇒ 兜底那段抛
|
|
540
|
+
// `QUOTA_EXCEEDED`「所有账号对该模型均受限」。⇒ ① **单账号用户**
|
|
541
|
+
// (绝大多数)看到的是「额度用尽」而真因是上游 5xx / 风控页,
|
|
542
|
+
// 排障方向完全错;② 每换一个号白发一次请求。
|
|
543
|
+
// ⇒ 判据:**槽已耗尽**时把**原始错误**抛出去(保留真因与错误码)。
|
|
544
|
+
if (tried.size >= slots.length)
|
|
545
|
+
throw error;
|
|
546
|
+
continue;
|
|
547
|
+
}
|
|
548
|
+
if (info.kind === 'context_window') {
|
|
549
|
+
// ⚠️ **本 fork 独有**(2026-10-17 审计 P1 修复):上下文超限**换账号也没用**
|
|
550
|
+
// —— 它是**请求本身**太大,与哪个账号无关(同一长会话换 10 个号一样报错)。
|
|
551
|
+
// ⇒ 不写冷却标记、不换号,直接把原文抛出去,让宿主走溢出压缩。
|
|
552
|
+
// ⚠️ 若漏这一格会落进下面「限流/额度」默认分支 ⇒ 给账号写一个到次日
|
|
553
|
+
// UTC+8 零点的标记 ⇒ 用户只是消息太长却被封账号一整天
|
|
554
|
+
// (与 loomy 的滑动窗口缺陷同族)。
|
|
555
|
+
// ⚠️ 真机取证(2026-10-17):模型 id 去掉组织前缀会得到
|
|
556
|
+
// **HTTP 400 `Invalid model id: DeepSeek-V4-Flash-0731`**,且该校验
|
|
557
|
+
// **发生在鉴权之前**(带合法前缀时同一请求先回 401)⇒ 这类报文是
|
|
558
|
+
// `invalid_request`(上游已有分支直接抛),不该被当成额度去换号。
|
|
559
|
+
throw error;
|
|
560
|
+
}
|
|
561
|
+
// 限流 / 额度:标记该槽后换下一个。
|
|
562
|
+
const resetAtMs = Date.now() + qiniuRetryAfterMs(info.kind, info.retryAfterMs, tried.size);
|
|
563
|
+
await this.options.markLimited?.(slot.id, options.model, resetAtMs);
|
|
564
|
+
limited.push(`${slot.id}(${info.kind})`);
|
|
565
|
+
}
|
|
566
|
+
}
|
|
567
|
+
}
|
|
568
|
+
/** 指定槽发一次请求(轮换循环的复用单元)。 */
|
|
569
|
+
async *streamVia(slot, options) {
|
|
570
|
+
const imageUrls = await this.resolveImageUrls(options.model, options.messages);
|
|
571
|
+
const messages = serializeMessages(options.messages, imageUrls);
|
|
572
|
+
const payload = buildQiniuPayload({
|
|
573
|
+
model: normalizeQiniuModelId(options.model),
|
|
574
|
+
messages,
|
|
575
|
+
...options.system !== undefined && options.system.length > 0 ? { system: options.system } : {},
|
|
576
|
+
...options.tools !== undefined ? { tools: options.tools } : {},
|
|
577
|
+
...options.temperature !== undefined ? { temperature: options.temperature } : {},
|
|
578
|
+
...options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {},
|
|
579
|
+
...options.reasoningEffort !== undefined
|
|
580
|
+
? { reasoningEffort: String(options.reasoningEffort) }
|
|
581
|
+
: {},
|
|
582
|
+
});
|
|
583
|
+
const response = await fetch(qiniuChatUrl(this.product), {
|
|
584
|
+
method: 'POST',
|
|
585
|
+
headers: qiniuHeaders(slot.apiKey, 'text/event-stream'),
|
|
586
|
+
body: JSON.stringify(payload),
|
|
587
|
+
...options.signal === undefined ? {} : { signal: options.signal },
|
|
588
|
+
});
|
|
589
|
+
if (!response.ok) {
|
|
590
|
+
// ⚠️ **必须先读体**:额度/限流的语义在响应体里,而 body 只能读一次 ——
|
|
591
|
+
// 读了不传下去,轮换层只能按状态码猜(把「额度耗尽」误判成「Key 失效」)。
|
|
592
|
+
const text = await response.text().catch(() => '');
|
|
593
|
+
// ⚠️ 只解析一次:头值是 HTTP 日期时,两次调用会算出毫秒级不同的值。
|
|
594
|
+
const retryAfterMs = retryAfterMsFromResponse(response.headers);
|
|
595
|
+
// ⚠️⚠️ **额度必须用字面量 `'QUOTA_EXCEEDED'`,不能交给 `httpErrorCode`**
|
|
596
|
+
// (2026-10-17 审计 P2 修复)。两条理由:
|
|
597
|
+
// ① `classifyQiniuError` 的注释明确指出七牛云「额度耗尽时可能回
|
|
598
|
+
// **401/403** 而不是 429」—— 即**这正是本分支预期会遇到的形态**,
|
|
599
|
+
// 而 `httpErrorCode(401)` = `'AUTH'`。而 `AUTH` 码会把 message 一起吞掉
|
|
600
|
+
// (`docs/agent-notes/client-ui.md` 记的复发形态:用户只看到
|
|
601
|
+
// 「API 密钥无效」,真实原因那句指路文案连同报文一起消失);
|
|
602
|
+
// ② harness 的 `QUOTA_EXCEEDED_CODE` 字面值就是 `'QUOTA'`,客户端会丢掉
|
|
603
|
+
// message 换成「当前请求的额度已用尽」⇒ 额度必须用字面量。
|
|
604
|
+
// ⇒ 故先跑一次语义分类:额度/限流各自产出**字面量**码,认证才用 `'AUTH'`。
|
|
605
|
+
// ⚠️ 语义判对而错误码判错,比两者都判错更危险 —— 它会让正确的分类
|
|
606
|
+
// 在传输途中被换掉,用户看到的是误导性的文案。
|
|
607
|
+
const info = classifyQiniuError(response.status, text, {
|
|
608
|
+
// ⚠️ `Headers` 无索引签名、不是 `Record<string,string>` ⇒ 必须显式转。
|
|
609
|
+
// 只取 `retry-after` 一格:`classifyQiniuError` 内部只读它。
|
|
610
|
+
...(response.headers.get('retry-after') === null
|
|
611
|
+
? {}
|
|
612
|
+
: { 'retry-after': response.headers.get('retry-after') }),
|
|
613
|
+
});
|
|
614
|
+
// ⚠️⚠️ **上下文超限必须归 `CONTEXT_WINDOW_EXCEEDED`**(2026-10-29 审计 P2)。
|
|
615
|
+
// 此前这一格落进 `httpErrorCode(status)`,而七牛云超限时回 **HTTP 400**
|
|
616
|
+
// ⇒ `httpErrorCode(400)` = `'INVALID_REQUEST'` ⇒ 宿主的
|
|
617
|
+
// `context-overflow` 监听器(判据第一行是
|
|
618
|
+
// `if (failure.code !== CONTEXT_WINDOW_EXCEEDED_CODE) return next()`)
|
|
619
|
+
// **完全不触发** ⇒ 自动压缩不跑、用户只看到一句「请求无效」,
|
|
620
|
+
// 唯一有效动作(压缩上下文重试)被掩盖。与 `gemini-adapter.ts:888` 同修法。
|
|
621
|
+
// ⚠️ 轮换层已单独处理 `context_window`(不换号、不写标记,见上),
|
|
622
|
+
// 两条口径一致:**请求太大换账号没用**。
|
|
623
|
+
const code = info.kind === 'quota'
|
|
624
|
+
? 'QUOTA_EXCEEDED'
|
|
625
|
+
: info.kind === 'rate_limit'
|
|
626
|
+
? 'RATE_LIMIT'
|
|
627
|
+
: info.kind === 'context_window'
|
|
628
|
+
? CONTEXT_WINDOW_EXCEEDED_CODE
|
|
629
|
+
: info.kind === 'auth'
|
|
630
|
+
? 'AUTH'
|
|
631
|
+
: httpErrorCode(response.status);
|
|
632
|
+
throw new LlmError(`qiniu: HTTP ${response.status} — ${text.slice(0, 300)}`, code, {
|
|
633
|
+
status: response.status,
|
|
634
|
+
...retryAfterMs === undefined ? {} : { providerRetryAfterMs: retryAfterMs },
|
|
635
|
+
});
|
|
636
|
+
}
|
|
637
|
+
// ⚠️⚠️ **content-type 闸门**(2026-10-17 审计 P1 修复)。此前本文件只有
|
|
638
|
+
// `!response.ok` 一个闸门 ⇒ 网关返回 **HTTP 200 + `text/html`**(风控拦截页 /
|
|
639
|
+
// 登录墙)时被当成正常响应喂给 `consumeOpenAiSse` ⇒ 解析不出任何帧 ⇒ 抛
|
|
640
|
+
// `EMPTY_RESPONSE` ⇒ `classifyQiniuFailure` 读到 `status = 0` ⇒ 命中
|
|
641
|
+
// 「传输错误」分支 ⇒ **轮换把整个账号池白打一遍**,最后抛
|
|
642
|
+
// `QUOTA_EXCEEDED`「所有账号对该模型均受限」。
|
|
643
|
+
// ⇒ 用户看到的是「额度用尽」而真因是风控,且唯一有效动作(换网络环境)
|
|
644
|
+
// 被完全掩盖。这与 `accio-adapter.ts:1481-1492`(2026-10-13 真机踩过)是
|
|
645
|
+
// 同一个坑,此处复刻。
|
|
646
|
+
// ⚠️ 归类 `SERVER`(**不重试**):风控是身份/环境问题,原样重发只会再被拦。
|
|
647
|
+
const contentType = response.headers.get('content-type') ?? '';
|
|
648
|
+
if (!contentType.includes('text/event-stream')) {
|
|
649
|
+
const peek = await response.text().catch(() => '');
|
|
650
|
+
throw new LlmError(`qiniu: 上游未返回事件流(content-type: ${contentType || '(空)'})——`
|
|
651
|
+
+ `通常是被风控拦截(网关返回 200 + HTML 拦截页)。`
|
|
652
|
+
+ `${peek === '' ? '' : ` 服务端原文:${peek.slice(0, 200)}`}`, 'SERVER', { status: response.status });
|
|
653
|
+
}
|
|
654
|
+
yield* consumeOpenAiSse(response, options.signal !== undefined ? { signal: options.signal } : {}, {
|
|
655
|
+
label: 'qiniu',
|
|
656
|
+
firstTokenTimeoutMs: this.product.chatHeaderTimeoutMs,
|
|
657
|
+
chunkTimeoutMs: this.product.chunkTimeoutMs,
|
|
658
|
+
...options.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {},
|
|
659
|
+
});
|
|
660
|
+
}
|
|
661
|
+
}
|
|
662
|
+
/**
|
|
663
|
+
* 从 `LlmError` 还原成语义化分类。
|
|
664
|
+
*
|
|
665
|
+
* ⚠️ 事实挂在 `error.failure` 上(`LlmFailure` 契约),**不是**展开在 error
|
|
666
|
+
* 自身 —— 早期版本误按「自身属性」读响应头,`retry-after` 因此永远读不到
|
|
667
|
+
* (opencode 写单测时实测到:`expected 590000, got 60000`)。
|
|
668
|
+
*/
|
|
669
|
+
export function classifyQiniuFailure(error) {
|
|
670
|
+
const failure = (typeof error === 'object' && error !== null ? error : {});
|
|
671
|
+
const status = typeof failure.failure?.status === 'number' ? failure.failure.status : 0;
|
|
672
|
+
const providerRetryAfterMs = typeof failure.failure?.providerRetryAfterMs === 'number'
|
|
673
|
+
&& Number.isFinite(failure.failure.providerRetryAfterMs)
|
|
674
|
+
? failure.failure.providerRetryAfterMs
|
|
675
|
+
: undefined;
|
|
676
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
677
|
+
const info = classifyQiniuError(status, message);
|
|
678
|
+
return providerRetryAfterMs === undefined
|
|
679
|
+
? info
|
|
680
|
+
: { ...info, retryAfterMs: info.retryAfterMs ?? providerRetryAfterMs };
|
|
681
|
+
}
|
|
682
|
+
/** 在 `ctx.llm` 上注册 qiniu 路由。 */
|
|
683
|
+
export function registerQiniuLlm(ctx, options) {
|
|
684
|
+
const product = options.product ?? QINIU;
|
|
685
|
+
const adapter = new QiniuAdapter(options);
|
|
686
|
+
registerAdapterIdempotent(ctx.llm, [product.id], adapter);
|
|
687
|
+
return adapter;
|
|
688
|
+
}
|
|
689
|
+
//# sourceMappingURL=qiniu-adapter.js.map
|