@xixka/dsh-hub 0.2.1-rc.9 → 0.2.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.
Files changed (355) hide show
  1. package/README.md +60 -889
  2. package/lib/accio-adapter.d.ts.map +1 -1
  3. package/lib/accio-adapter.js +3 -1
  4. package/lib/accio-adapter.js.map +1 -1
  5. package/lib/account-pool.d.ts +128 -0
  6. package/lib/account-pool.d.ts.map +1 -1
  7. package/lib/account-pool.js +252 -15
  8. package/lib/account-pool.js.map +1 -1
  9. package/lib/aggregate-adapter.d.ts +38 -0
  10. package/lib/aggregate-adapter.d.ts.map +1 -1
  11. package/lib/aggregate-adapter.js +145 -12
  12. package/lib/aggregate-adapter.js.map +1 -1
  13. package/lib/aggregate-expiry.d.ts.map +1 -1
  14. package/lib/aggregate-expiry.js +4 -0
  15. package/lib/aggregate-expiry.js.map +1 -1
  16. package/lib/analyze-image.d.ts.map +1 -1
  17. package/lib/analyze-image.js.map +1 -1
  18. package/lib/astudio-adapter.d.ts.map +1 -1
  19. package/lib/astudio-adapter.js +3 -1
  20. package/lib/astudio-adapter.js.map +1 -1
  21. package/lib/buddy-adapter.d.ts.map +1 -1
  22. package/lib/buddy-adapter.js +22 -4
  23. package/lib/buddy-adapter.js.map +1 -1
  24. package/lib/buddy.d.ts +7 -2
  25. package/lib/buddy.d.ts.map +1 -1
  26. package/lib/buddy.js +7 -2
  27. package/lib/buddy.js.map +1 -1
  28. package/lib/canonical-models.d.ts.map +1 -1
  29. package/lib/canonical-models.js +20 -0
  30. package/lib/canonical-models.js.map +1 -1
  31. package/lib/chromium-session.d.ts +174 -0
  32. package/lib/chromium-session.d.ts.map +1 -1
  33. package/lib/chromium-session.js +418 -1
  34. package/lib/chromium-session.js.map +1 -1
  35. package/lib/client/jet-hub.js +287 -13918
  36. package/lib/codearts-credits.d.ts +123 -13
  37. package/lib/codearts-credits.d.ts.map +1 -1
  38. package/lib/codearts-credits.js +168 -25
  39. package/lib/codearts-credits.js.map +1 -1
  40. package/lib/codearts-vision.d.ts +95 -4
  41. package/lib/codearts-vision.d.ts.map +1 -1
  42. package/lib/codearts-vision.js +136 -5
  43. package/lib/codearts-vision.js.map +1 -1
  44. package/lib/codely-adapter.d.ts +36 -3
  45. package/lib/codely-adapter.d.ts.map +1 -1
  46. package/lib/codely-adapter.js +252 -11
  47. package/lib/codely-adapter.js.map +1 -1
  48. package/lib/codely-auth-service.d.ts +17 -0
  49. package/lib/codely-auth-service.d.ts.map +1 -1
  50. package/lib/codely-auth-service.js +40 -3
  51. package/lib/codely-auth-service.js.map +1 -1
  52. package/lib/codely-auth.d.ts.map +1 -1
  53. package/lib/codely-auth.js +23 -0
  54. package/lib/codely-auth.js.map +1 -1
  55. package/lib/codely-credits.d.ts.map +1 -1
  56. package/lib/codely-credits.js +18 -1
  57. package/lib/codely-credits.js.map +1 -1
  58. package/lib/codely-product.d.ts +10 -5
  59. package/lib/codely-product.d.ts.map +1 -1
  60. package/lib/codely-product.js +4 -2
  61. package/lib/codely-product.js.map +1 -1
  62. package/lib/credential-resolver.d.ts +41 -1
  63. package/lib/credential-resolver.d.ts.map +1 -1
  64. package/lib/credential-resolver.js +31 -6
  65. package/lib/credential-resolver.js.map +1 -1
  66. package/lib/image-budget.d.ts +3 -11
  67. package/lib/image-budget.d.ts.map +1 -1
  68. package/lib/image-budget.js +43 -5
  69. package/lib/image-budget.js.map +1 -1
  70. package/lib/image-data-cache.d.ts +87 -0
  71. package/lib/image-data-cache.d.ts.map +1 -0
  72. package/lib/image-data-cache.js +144 -0
  73. package/lib/image-data-cache.js.map +1 -0
  74. package/lib/index.d.ts +0 -51
  75. package/lib/index.d.ts.map +1 -1
  76. package/lib/index.js +290 -164
  77. package/lib/index.js.map +1 -1
  78. package/lib/jet-hub-rpc.d.ts +14 -19
  79. package/lib/jet-hub-rpc.d.ts.map +1 -1
  80. package/lib/jet-hub-rpc.js +812 -496
  81. package/lib/jet-hub-rpc.js.map +1 -1
  82. package/lib/jet-hub-store.d.ts +52 -0
  83. package/lib/jet-hub-store.d.ts.map +1 -1
  84. package/lib/jet-hub-store.js +52 -4
  85. package/lib/jet-hub-store.js.map +1 -1
  86. package/lib/llm-adapter.d.ts +96 -5
  87. package/lib/llm-adapter.d.ts.map +1 -1
  88. package/lib/llm-adapter.js +742 -62
  89. package/lib/llm-adapter.js.map +1 -1
  90. package/lib/lobsterai-adapter.d.ts.map +1 -1
  91. package/lib/lobsterai-adapter.js +54 -15
  92. package/lib/lobsterai-adapter.js.map +1 -1
  93. package/lib/login.d.ts +5 -13
  94. package/lib/login.d.ts.map +1 -1
  95. package/lib/login.js +75 -14
  96. package/lib/login.js.map +1 -1
  97. package/lib/loomy-adapter.d.ts +3 -0
  98. package/lib/loomy-adapter.d.ts.map +1 -1
  99. package/lib/loomy-adapter.js +11 -3
  100. package/lib/loomy-adapter.js.map +1 -1
  101. package/lib/loomy-auth.d.ts +51 -0
  102. package/lib/loomy-auth.d.ts.map +1 -1
  103. package/lib/loomy-auth.js +149 -2
  104. package/lib/loomy-auth.js.map +1 -1
  105. package/lib/loomy-oauth.d.ts +44 -0
  106. package/lib/loomy-oauth.d.ts.map +1 -1
  107. package/lib/loomy-oauth.js +48 -1
  108. package/lib/loomy-oauth.js.map +1 -1
  109. package/lib/loomy-sms-login.d.ts +61 -0
  110. package/lib/loomy-sms-login.d.ts.map +1 -0
  111. package/lib/loomy-sms-login.js +330 -0
  112. package/lib/loomy-sms-login.js.map +1 -0
  113. package/lib/loomy.d.ts +22 -0
  114. package/lib/loomy.d.ts.map +1 -1
  115. package/lib/loomy.js +10 -0
  116. package/lib/loomy.js.map +1 -1
  117. package/lib/magicrew-adapter.d.ts +201 -0
  118. package/lib/magicrew-adapter.d.ts.map +1 -0
  119. package/lib/magicrew-adapter.js +595 -0
  120. package/lib/magicrew-adapter.js.map +1 -0
  121. package/lib/magicrew-auth.d.ts +494 -0
  122. package/lib/magicrew-auth.d.ts.map +1 -0
  123. package/lib/magicrew-auth.js +951 -0
  124. package/lib/magicrew-auth.js.map +1 -0
  125. package/lib/magicrew-browser-login.d.ts +333 -0
  126. package/lib/magicrew-browser-login.d.ts.map +1 -0
  127. package/lib/magicrew-browser-login.js +740 -0
  128. package/lib/magicrew-browser-login.js.map +1 -0
  129. package/lib/magicrew-catalog.d.ts +19 -0
  130. package/lib/magicrew-catalog.d.ts.map +1 -0
  131. package/lib/magicrew-catalog.js +80 -0
  132. package/lib/magicrew-catalog.js.map +1 -0
  133. package/lib/magicrew-credits.d.ts +112 -0
  134. package/lib/magicrew-credits.d.ts.map +1 -0
  135. package/lib/magicrew-credits.js +319 -0
  136. package/lib/magicrew-credits.js.map +1 -0
  137. package/lib/magicrew-local-browser.d.ts +123 -0
  138. package/lib/magicrew-local-browser.d.ts.map +1 -0
  139. package/lib/magicrew-local-browser.js +321 -0
  140. package/lib/magicrew-local-browser.js.map +1 -0
  141. package/lib/magicrew-product.d.ts +127 -0
  142. package/lib/magicrew-product.d.ts.map +1 -0
  143. package/lib/magicrew-product.js +159 -0
  144. package/lib/magicrew-product.js.map +1 -0
  145. package/lib/magicrew-profile.d.ts +74 -0
  146. package/lib/magicrew-profile.d.ts.map +1 -0
  147. package/lib/magicrew-profile.js +148 -0
  148. package/lib/magicrew-profile.js.map +1 -0
  149. package/lib/magicrew.d.ts +185 -0
  150. package/lib/magicrew.d.ts.map +1 -0
  151. package/lib/magicrew.js +215 -0
  152. package/lib/magicrew.js.map +1 -0
  153. package/lib/model-catalog.d.ts +8 -0
  154. package/lib/model-catalog.d.ts.map +1 -1
  155. package/lib/model-catalog.js +127 -5
  156. package/lib/model-catalog.js.map +1 -1
  157. package/lib/models.d.ts +216 -32
  158. package/lib/models.d.ts.map +1 -1
  159. package/lib/models.js +500 -47
  160. package/lib/models.js.map +1 -1
  161. package/lib/modelscope-adapter.d.ts.map +1 -1
  162. package/lib/modelscope-adapter.js +7 -2
  163. package/lib/modelscope-adapter.js.map +1 -1
  164. package/lib/modelscope-product.d.ts +44 -6
  165. package/lib/modelscope-product.d.ts.map +1 -1
  166. package/lib/modelscope-product.js +98 -9
  167. package/lib/modelscope-product.js.map +1 -1
  168. package/lib/officeace-adapter.d.ts.map +1 -1
  169. package/lib/officeace-adapter.js +147 -21
  170. package/lib/officeace-adapter.js.map +1 -1
  171. package/lib/officeace-auth.d.ts +15 -0
  172. package/lib/officeace-auth.d.ts.map +1 -1
  173. package/lib/officeace-auth.js +99 -2
  174. package/lib/officeace-auth.js.map +1 -1
  175. package/lib/openai-gateway/tencent-fingerprint.d.ts.map +1 -1
  176. package/lib/openai-gateway/tencent-fingerprint.js +28 -3
  177. package/lib/openai-gateway/tencent-fingerprint.js.map +1 -1
  178. package/lib/opencode-adapter.d.ts +27 -0
  179. package/lib/opencode-adapter.d.ts.map +1 -1
  180. package/lib/opencode-adapter.js +57 -8
  181. package/lib/opencode-adapter.js.map +1 -1
  182. package/lib/opencode-bun-tls.d.ts +103 -0
  183. package/lib/opencode-bun-tls.d.ts.map +1 -0
  184. package/lib/opencode-bun-tls.js +212 -0
  185. package/lib/opencode-bun-tls.js.map +1 -0
  186. package/lib/opencode-messages.d.ts +0 -19
  187. package/lib/opencode-messages.d.ts.map +1 -1
  188. package/lib/opencode-messages.js +30 -33
  189. package/lib/opencode-messages.js.map +1 -1
  190. package/lib/opencode-official-prompt.d.ts +62 -0
  191. package/lib/opencode-official-prompt.d.ts.map +1 -0
  192. package/lib/opencode-official-prompt.js +119 -0
  193. package/lib/opencode-official-prompt.js.map +1 -0
  194. package/lib/opencode-official-tools.d.ts +27 -0
  195. package/lib/opencode-official-tools.d.ts.map +1 -0
  196. package/lib/opencode-official-tools.js +340 -0
  197. package/lib/opencode-official-tools.js.map +1 -0
  198. package/lib/opencode-product.d.ts.map +1 -1
  199. package/lib/opencode-product.js +3 -2
  200. package/lib/opencode-product.js.map +1 -1
  201. package/lib/opencode-stream.d.ts.map +1 -1
  202. package/lib/opencode-stream.js +8 -7
  203. package/lib/opencode-stream.js.map +1 -1
  204. package/lib/product.d.ts +15 -3
  205. package/lib/product.d.ts.map +1 -1
  206. package/lib/product.js +44 -11
  207. package/lib/product.js.map +1 -1
  208. package/lib/provider-credits.d.ts +2 -0
  209. package/lib/provider-credits.d.ts.map +1 -1
  210. package/lib/provider-credits.js +46 -17
  211. package/lib/provider-credits.js.map +1 -1
  212. package/lib/provider-expiry.d.ts.map +1 -1
  213. package/lib/provider-expiry.js +29 -0
  214. package/lib/provider-expiry.js.map +1 -1
  215. package/lib/provider-http-pool.d.ts +85 -0
  216. package/lib/provider-http-pool.d.ts.map +1 -0
  217. package/lib/provider-http-pool.js +224 -0
  218. package/lib/provider-http-pool.js.map +1 -0
  219. package/lib/provider-registry.d.ts.map +1 -1
  220. package/lib/provider-registry.js +73 -39
  221. package/lib/provider-registry.js.map +1 -1
  222. package/lib/qiniu-adapter.d.ts +276 -0
  223. package/lib/qiniu-adapter.d.ts.map +1 -0
  224. package/lib/qiniu-adapter.js +689 -0
  225. package/lib/qiniu-adapter.js.map +1 -0
  226. package/lib/qiniu-auth.d.ts +130 -0
  227. package/lib/qiniu-auth.d.ts.map +1 -0
  228. package/lib/qiniu-auth.js +234 -0
  229. package/lib/qiniu-auth.js.map +1 -0
  230. package/lib/qiniu-messages.d.ts +96 -0
  231. package/lib/qiniu-messages.d.ts.map +1 -0
  232. package/lib/qiniu-messages.js +97 -0
  233. package/lib/qiniu-messages.js.map +1 -0
  234. package/lib/qiniu-product.d.ts +126 -0
  235. package/lib/qiniu-product.d.ts.map +1 -0
  236. package/lib/qiniu-product.js +269 -0
  237. package/lib/qiniu-product.js.map +1 -0
  238. package/lib/qiniu-rpc.d.ts +119 -0
  239. package/lib/qiniu-rpc.d.ts.map +1 -0
  240. package/lib/qiniu-rpc.js +214 -0
  241. package/lib/qiniu-rpc.js.map +1 -0
  242. package/lib/qiniu.d.ts +145 -0
  243. package/lib/qiniu.d.ts.map +1 -0
  244. package/lib/qiniu.js +164 -0
  245. package/lib/qiniu.js.map +1 -0
  246. package/lib/raccoon-adapter.d.ts +18 -2
  247. package/lib/raccoon-adapter.d.ts.map +1 -1
  248. package/lib/raccoon-adapter.js +154 -21
  249. package/lib/raccoon-adapter.js.map +1 -1
  250. package/lib/raccoon-auth.d.ts +6 -0
  251. package/lib/raccoon-auth.d.ts.map +1 -1
  252. package/lib/raccoon-auth.js +9 -1
  253. package/lib/raccoon-auth.js.map +1 -1
  254. package/lib/raccoon-credits.d.ts +38 -5
  255. package/lib/raccoon-credits.d.ts.map +1 -1
  256. package/lib/raccoon-credits.js +127 -6
  257. package/lib/raccoon-credits.js.map +1 -1
  258. package/lib/raccoon.d.ts +14 -2
  259. package/lib/raccoon.d.ts.map +1 -1
  260. package/lib/raccoon.js +14 -2
  261. package/lib/raccoon.js.map +1 -1
  262. package/lib/service.d.ts +46 -6
  263. package/lib/service.d.ts.map +1 -1
  264. package/lib/service.js +104 -16
  265. package/lib/service.js.map +1 -1
  266. package/lib/session-balance.d.ts +203 -0
  267. package/lib/session-balance.d.ts.map +1 -0
  268. package/lib/session-balance.js +279 -0
  269. package/lib/session-balance.js.map +1 -0
  270. package/lib/sign.d.ts +97 -1
  271. package/lib/sign.d.ts.map +1 -1
  272. package/lib/sign.js +174 -2
  273. package/lib/sign.js.map +1 -1
  274. package/lib/token-ledger-store.d.ts.map +1 -1
  275. package/lib/token-ledger-store.js +121 -27
  276. package/lib/token-ledger-store.js.map +1 -1
  277. package/lib/trae-adapter.d.ts.map +1 -1
  278. package/lib/trae-adapter.js +3 -1
  279. package/lib/trae-adapter.js.map +1 -1
  280. package/lib/types.d.ts +75 -15
  281. package/lib/types.d.ts.map +1 -1
  282. package/lib/types.js.map +1 -1
  283. package/lib/usage-badge.d.ts +77 -7
  284. package/lib/usage-badge.d.ts.map +1 -1
  285. package/lib/usage-badge.js +190 -28
  286. package/lib/usage-badge.js.map +1 -1
  287. package/lib/webdav-auto-sync.d.ts +96 -0
  288. package/lib/webdav-auto-sync.d.ts.map +1 -0
  289. package/lib/webdav-auto-sync.js +0 -0
  290. package/lib/webdav-auto-sync.js.map +1 -0
  291. package/lib/webdav-sync-crypto.d.ts +18 -0
  292. package/lib/webdav-sync-crypto.d.ts.map +1 -0
  293. package/lib/webdav-sync-crypto.js +72 -0
  294. package/lib/webdav-sync-crypto.js.map +1 -0
  295. package/lib/webdav-sync-merge.d.ts +31 -0
  296. package/lib/webdav-sync-merge.d.ts.map +1 -0
  297. package/lib/webdav-sync-merge.js +0 -0
  298. package/lib/webdav-sync-merge.js.map +1 -0
  299. package/lib/webdav-sync.d.ts +43 -7
  300. package/lib/webdav-sync.d.ts.map +1 -1
  301. package/lib/webdav-sync.js +72 -11
  302. package/lib/webdav-sync.js.map +1 -1
  303. package/lib/zcode-adapter.d.ts +4 -2
  304. package/lib/zcode-adapter.d.ts.map +1 -1
  305. package/lib/zcode-adapter.js +132 -37
  306. package/lib/zcode-adapter.js.map +1 -1
  307. package/lib/zcode-upstream.d.ts +59 -0
  308. package/lib/zcode-upstream.d.ts.map +1 -1
  309. package/lib/zcode-upstream.js +137 -2
  310. package/lib/zcode-upstream.js.map +1 -1
  311. package/package.json +5 -4
  312. package/lib/stepcode-adapter.d.ts +0 -158
  313. package/lib/stepcode-adapter.d.ts.map +0 -1
  314. package/lib/stepcode-adapter.js +0 -318
  315. package/lib/stepcode-adapter.js.map +0 -1
  316. package/lib/stepcode-auth.d.ts +0 -154
  317. package/lib/stepcode-auth.d.ts.map +0 -1
  318. package/lib/stepcode-auth.js +0 -287
  319. package/lib/stepcode-auth.js.map +0 -1
  320. package/lib/stepcode-oauth.d.ts +0 -194
  321. package/lib/stepcode-oauth.d.ts.map +0 -1
  322. package/lib/stepcode-oauth.js +0 -496
  323. package/lib/stepcode-oauth.js.map +0 -1
  324. package/lib/stepcode-product.d.ts +0 -255
  325. package/lib/stepcode-product.d.ts.map +0 -1
  326. package/lib/stepcode-product.js +0 -256
  327. package/lib/stepcode-product.js.map +0 -1
  328. package/lib/stepcode.d.ts +0 -230
  329. package/lib/stepcode.d.ts.map +0 -1
  330. package/lib/stepcode.js +0 -300
  331. package/lib/stepcode.js.map +0 -1
  332. package/lib/teleagent-adapter.d.ts +0 -116
  333. package/lib/teleagent-adapter.d.ts.map +0 -1
  334. package/lib/teleagent-adapter.js +0 -293
  335. package/lib/teleagent-adapter.js.map +0 -1
  336. package/lib/teleagent-auth.d.ts +0 -279
  337. package/lib/teleagent-auth.d.ts.map +0 -1
  338. package/lib/teleagent-auth.js +0 -512
  339. package/lib/teleagent-auth.js.map +0 -1
  340. package/lib/teleagent-cdp-login.d.ts +0 -100
  341. package/lib/teleagent-cdp-login.d.ts.map +0 -1
  342. package/lib/teleagent-cdp-login.js +0 -402
  343. package/lib/teleagent-cdp-login.js.map +0 -1
  344. package/lib/teleagent-credits.d.ts +0 -120
  345. package/lib/teleagent-credits.d.ts.map +0 -1
  346. package/lib/teleagent-credits.js +0 -288
  347. package/lib/teleagent-credits.js.map +0 -1
  348. package/lib/teleagent-product.d.ts +0 -196
  349. package/lib/teleagent-product.d.ts.map +0 -1
  350. package/lib/teleagent-product.js +0 -212
  351. package/lib/teleagent-product.js.map +0 -1
  352. package/lib/teleagent.d.ts +0 -288
  353. package/lib/teleagent.d.ts.map +0 -1
  354. package/lib/teleagent.js +0 -450
  355. package/lib/teleagent.js.map +0 -1
@@ -0,0 +1,276 @@
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 { LlmAdapter } from '@deepseek-ai/dsh-llm';
49
+ import type { GenerateOptions, LlmModelInfo, LlmProviderInfo, LlmResolvedModelInfo, StreamChunk } from '@deepseek-ai/dsh-llm';
50
+ import type { Context } from '@deepseek-ai/cordis';
51
+ import type { AccountPool } from './account-pool.js';
52
+ import { type QiniuErrorInfo, type QiniuErrorKind, type QiniuProduct } from './qiniu-product.js';
53
+ /** 目录条目(远端与兜底共用的输出形状)。 */
54
+ export interface QiniuCatalogEntry {
55
+ id: string;
56
+ name: string;
57
+ contextWindow: number;
58
+ supportsImage: boolean;
59
+ efforts?: readonly string[];
60
+ }
61
+ /** 清空目录缓存(RPC 的「刷新目录」与单测隔离用)。 */
62
+ export declare function clearQiniuCatalogCache(): void;
63
+ /** 远端目录拉取(注入以便单测离线)。 */
64
+ export type QiniuCatalogFetcher = (apiKey: string, signal?: AbortSignal) => Promise<Response>;
65
+ /** 拉目录时的凭据提供者(返回 undefined 表示无可用账号)。 */
66
+ export type QiniuCredentialProvider = () => Promise<{
67
+ apiKey: string;
68
+ } | undefined>;
69
+ /**
70
+ * 解析远端 `GET /v1/models` 的响应体。
71
+ *
72
+ * ## ⚠️ 三个字段都**尽力而为**,拿不到就回落到兜底表的值
73
+ *
74
+ * 实测(2026-10-29 直连 https://api.qnaigc.com/v1/models,HTTP 200、80+ 条):
75
+ * 每条**带 `context_length` 与 `max_tokens`**(部分为 0),**不下发模态**。
76
+ * 故:
77
+ *
78
+ * - 窗口按 `context_length` → `context_window` → `limit.context` 三级取值 ——
79
+ * 拿不到时**从兜底表按 id 查**(查到就用,查不到留 `0` 哨兵)。⚠️ **绝不编造数字**:
80
+ * `contextWindow` 是 DSH 自动压缩阈值的输入,编一个会让压缩在错误的位置触发
81
+ * (opencode 的 issue IKJJ68 同因);
82
+ * - `modalities.input` 含 `image` 才算支持图片;拿不到时同样回落到兜底表 ——
83
+ * 本仓库的硬约定是「**声明支持就必须真支持**」,故**未知一律按不支持**处理
84
+ * (除兜底表里明确记着支持的);
85
+ * - 窗口/模态**都只认「远端明确给出」或「兜底表明确记着」**,不猜。
86
+ */
87
+ export declare function parseQiniuCatalog(body: unknown): QiniuCatalogEntry[];
88
+ /**
89
+ * 拉取远端目录,失败回退静态兜底。
90
+ *
91
+ * @param ttlMs 命中内存缓存的窗口;测试传 0 强制每次都拉。
92
+ *
93
+ * ⚠️ **必须有超时**(接线层给):桌面版到外部域名的 fetch 可能**永不 settle**
94
+ * (opencode 的真机事故 2026-10-02:没有超时 → `listModels` 永不返回 →
95
+ * **模型列表与徽标同时空白**)。有超时则超时后回退兜底表,UI 立刻可用。
96
+ */
97
+ export declare function loadQiniuCatalog(fetchCatalog: QiniuCatalogFetcher, apiKey: string, ttlMs?: number, signal?: AbortSignal): Promise<readonly QiniuCatalogEntry[]>;
98
+ /** 一个可发起请求的槽(账号)。 */
99
+ export interface QiniuSlot {
100
+ readonly id: string;
101
+ readonly apiKey: string;
102
+ }
103
+ export interface QiniuAdapterOptions {
104
+ /**
105
+ * 单凭据回退 ref(无账号池条目时用)。
106
+ *
107
+ * ⚠️ 类型是 `unknown` 而不是品牌类型 `CredentialRef` —— 本适配器**不用它做
108
+ * 解析**(凭据一律经 `slots()` 由接线层解析好传进来),保留这个字段只为与
109
+ * 其余 15 个 `registerXxxLlm` 的选项形状一致,避免调用方误以为「不传就少了
110
+ * 一条解析路径」。做成 `unknown` 可免去在适配器里 import 凭据模块的类型。
111
+ */
112
+ credentialRef?: unknown;
113
+ /**
114
+ * 取当前可用槽序列(按账号池的手动顺序)。
115
+ *
116
+ * @param modelId 目标模型。**推理路径必须传**,接线层据此过滤掉
117
+ * 「该模型正处于限流窗口」的账号(与其余 15 家的 `getAvailableAccount` 同语义,
118
+ * 见 `src/index.ts` 的 `throwIfAllAccountsRateLimited`)。
119
+ * ⚠️ **目录路径刻意不传**:目录要的是「这个渠道有哪些模型」,
120
+ * 与「哪个账号此刻被限流」无关;传了会让被限流的账号把整个目录一起拖空。
121
+ */
122
+ slots: (modelId?: string) => Promise<readonly QiniuSlot[]>;
123
+ /**
124
+ * 账号池(**黑名单、关闭意图、目录门控的唯一数据源**)。
125
+ *
126
+ * ⚠️⚠️ **2026-10-23 迁移**:本家此前手写 `listModels`,黑名单与关闭意图靠
127
+ * `disabledModels` / `providerClosed` 两个**选项回调**传进来。那两个字段
128
+ * 已随迁移删除 —— 现在统一由共享骨架(`model-catalog.ts`)从本池读取,
129
+ * 与其余实体 provider 同源。
130
+ *
131
+ * ⚠️ 省略时(单测 / 嵌入方)行为退回「不过滤、不判关闭意图」;
132
+ * **生产接线必须传**(`index.ts` 负责,且 `qiniu-wiring.spec.ts` 会点名)。
133
+ */
134
+ accountPool?: AccountPool;
135
+ /** 记录受限的副作用(切槽时由接线层提供)。 */
136
+ markLimited?: (slotId: string, modelId: string, resetAtMs: number) => Promise<void>;
137
+ /** 诊断日志。 */
138
+ warn?: (message: string) => void;
139
+ /**
140
+ * 附件字节读取。**只有在模型被声明为支持图片时才会被调用**。
141
+ *
142
+ * ⚠️ 缺省时带图请求会抛 `UNSUPPORTED_CONTENT`(见 `resolveImageUrls`),
143
+ * 而不是把图片静默丢掉(Qoder 图片丢失事故的教训:模型看不到图却照常回答,
144
+ * 用户拿到的是幻觉结果)。
145
+ */
146
+ readImage?: (ref: unknown) => Promise<{
147
+ data: Uint8Array;
148
+ mediaType: string;
149
+ } | undefined>;
150
+ /** 拉远端目录;缺省时直接用兜底表。 */
151
+ fetchRemoteCatalog?: QiniuCatalogFetcher;
152
+ /** 产品配置;默认 {@link QINIU}。 */
153
+ product?: QiniuProduct;
154
+ }
155
+ /**
156
+ * 把「错误语义 + 服务端给的延迟」换算成该槽该模型的受限时长。
157
+ *
158
+ * ⚠️ **服务端给了就用它的**,且 **0 是合法值**(「立即解除」而非「未知」):
159
+ * 必须用 `=== undefined` 判空,写成任何 falsy 判据都会把 0 静默换成 1 小时
160
+ * (`src/retry-after.ts` 的模块头记录了这条教训)。
161
+ */
162
+ export declare function qiniuRetryAfterMs(kind: QiniuErrorKind, retryAfterMs: number | undefined, attempt: number,
163
+ /** 注入时钟(单测用);默认 `Date.now()`。与仓库其它时间函数同约定。 */
164
+ nowMs?: number): number;
165
+ export declare class QiniuAdapter extends LlmAdapter {
166
+ private readonly options;
167
+ private readonly product;
168
+ /**
169
+ * 最近一次成功解析出的目录快照(**仅供同步路径**读取)。
170
+ *
171
+ * ⚠️ 它不是缓存 —— 权威缓存仍是 `loadQiniuCatalog` 那份带 TTL 的
172
+ * (见 `catalog()` 的注释:在适配器上另立缓存会让目录永不过期)。
173
+ * 这里只是把「上一次的结果」留给 `listAllModels()` 那个**必须同步**的调用者。
174
+ */
175
+ private lastCatalog?;
176
+ /**
177
+ * 共享目录骨架(`model-catalog.ts`)——**黑名单 / 关闭意图 / 模态回填 / 映射**
178
+ * 的唯一实现处(2026-10-23 迁移,见 `listModels` 的注释)。
179
+ */
180
+ private readonly skeletonCatalog;
181
+ constructor(options: QiniuAdapterOptions);
182
+ /**
183
+ * 异步读目录并转成骨架的中间结构(`CatalogEntry[]`)。
184
+ *
185
+ * ⚠️ **本家独有的门控放这里**:没有可用槽位时返回 `[]`
186
+ * (骨架把它当「目录为空」⇒ `listModels` 吐空数组 ⇒ 隐藏整个 provider 分组,
187
+ * 与本文件迁移前那条 `if (slots.length === 0) return []` 逐字等价)。
188
+ */
189
+ private loadCatalogEntries;
190
+ /**
191
+ * **同步**全量目录(`listAllModels()` 用)。
192
+ *
193
+ * ⚠️ 与 `loadCatalogEntries` 的差别只在「等不等远端」:这里读上一轮缓存,
194
+ * 缓存为空时用兜底表并**顺手**触发一次后台预热(同步契约见 `listAllModels`)。
195
+ */
196
+ private syncCatalogEntries;
197
+ /** 本家私有形状 → 骨架的 `CatalogEntry`(**唯一**转换点)。 */
198
+ private toCatalogEntry;
199
+ providerInfo(provider: string): LlmProviderInfo;
200
+ /**
201
+ * 完整目录(**同步**返回数组)。
202
+ *
203
+ * ⚠️ **绝不能写成 async**:`jet-hub-rpc.ts` 的 `ModelCatalogSource` 接口是
204
+ * 同步的且消费者**不 await**(`catalog = [...all]`),返回 Promise 会抛
205
+ * `TypeError: all is not iterable`(minimax 的同款真实缺陷)。
206
+ */
207
+ listAllModels(): readonly {
208
+ id: string;
209
+ name: string;
210
+ }[];
211
+ /**
212
+ * 同步取「已缓存的远端目录」;没有缓存则返回 undefined。
213
+ *
214
+ * ⚠️ 只读缓存、**绝不发起网络请求** —— 本方法在 UI 的同步路径上被调用
215
+ * (`catalog = [...all]`,见 `jet-hub-rpc.ts` 的 `fullCatalogIds`)。
216
+ */
217
+ private snapshotCatalog;
218
+ /** 后台预热一次目录;失败静默(兜底表已保证 UI 可用)。 */
219
+ private warmCatalog;
220
+ /** 当前生效的目录(远端优先,失败回退兜底)。 */
221
+ private catalog;
222
+ /**
223
+ * 模型选择器的目录 —— **委托共享骨架**(`model-catalog.ts`)。
224
+ *
225
+ * ## ⚠️⚠️ 2026-10-23 迁移(用户要求:实体 provider 一律走共享骨架)
226
+ *
227
+ * 迁移前本方法是**手写**的,自己做了四件事:判 `providerClosed`、
228
+ * 判 `providerCatalogVisible`、过滤 `disabledModels`、手工 map 成
229
+ * `LlmModelInfo`。其中 ①③④ 与其余 13 家**逐字同义** —— 而「同义的两份实现」
230
+ * 正是本仓库红线(`docs/agent-notes/misc.md` 的「一文件两套同义判据」),
231
+ * 也是 Gitee IKP8OF 那类漂移缺陷的温床(各写一份 ⇒ 新入口漏接线就静默失效)。
232
+ *
233
+ * 现在四条全部由骨架承担,本方法只剩一行委托:
234
+ * - 关闭意图 / 黑名单 / 模态回填 / `provider` 回填 ⇒ `createModelCatalog`;
235
+ * - **本家独有的门控**(没有可用槽位时隐藏)⇒ 放进 `loadCatalog`
236
+ * (返回 `[]` 即「目录为空」,与骨架的既有语义一致)。
237
+ */
238
+ listModels(_provider: string): Promise<readonly LlmModelInfo[]>;
239
+ resolveModel(provider: string, model: string, _signal?: AbortSignal): Promise<LlmResolvedModelInfo>;
240
+ prepareCall(provider: string, model: string, signal?: AbortSignal): Promise<{
241
+ model: LlmResolvedModelInfo;
242
+ stream: (options: GenerateOptions) => AsyncIterable<StreamChunk>;
243
+ }>;
244
+ /**
245
+ * 解析消息里的图片附件为 data URL。
246
+ *
247
+ * ⚠️ **模型不支持图片时直接抛 `UNSUPPORTED_CONTENT`**(而不是静默丢弃)——
248
+ * 静默丢弃会让用户以为模型看到了图(Qoder 图片事故的教训)。
249
+ * ⚠️ 附件字节读不出来时**不写入该条**:`openai-compat` 的
250
+ * `userContentParts` 遇到缺失会产出 `[image unavailable]` 占位,
251
+ * 至少让模型知道「这里本该有张图但没拿到」,而不是消息里凭空少一块。
252
+ */
253
+ private resolveImageUrls;
254
+ /**
255
+ * 轮换:失败按「语义」标记该槽 → 换下一槽重发。
256
+ *
257
+ * 三条硬规则(见模块头的表):
258
+ * 1. `tried` **跨迭代保留** —— 每次重置会让两个槽之间无限来回;
259
+ * 2. **已交付内容的流不重放**;
260
+ * 3. **认证类不写限流标记**(写它会放大成「全池被封」)。
261
+ */
262
+ stream(options: GenerateOptions): AsyncIterable<StreamChunk>;
263
+ /** 指定槽发一次请求(轮换循环的复用单元)。 */
264
+ protected streamVia(slot: QiniuSlot, options: GenerateOptions): AsyncIterable<StreamChunk>;
265
+ }
266
+ /**
267
+ * 从 `LlmError` 还原成语义化分类。
268
+ *
269
+ * ⚠️ 事实挂在 `error.failure` 上(`LlmFailure` 契约),**不是**展开在 error
270
+ * 自身 —— 早期版本误按「自身属性」读响应头,`retry-after` 因此永远读不到
271
+ * (opencode 写单测时实测到:`expected 590000, got 60000`)。
272
+ */
273
+ export declare function classifyQiniuFailure(error: unknown): QiniuErrorInfo;
274
+ /** 在 `ctx.llm` 上注册 qiniu 路由。 */
275
+ export declare function registerQiniuLlm(ctx: Context, options: QiniuAdapterOptions): QiniuAdapter;
276
+ //# sourceMappingURL=qiniu-adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"qiniu-adapter.d.ts","sourceRoot":"","sources":["../src/qiniu-adapter.ts"],"names":[],"mappings":"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"}