@xixka/dsh-hub 0.2.1-rc.8 → 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 -854
  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 +162 -1
  6. package/lib/account-pool.d.ts.map +1 -1
  7. package/lib/account-pool.js +322 -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 -13303
  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 -17
  79. package/lib/jet-hub-rpc.d.ts.map +1 -1
  80. package/lib/jet-hub-rpc.js +812 -328
  81. package/lib/jet-hub-rpc.js.map +1 -1
  82. package/lib/jet-hub-store.d.ts +74 -1
  83. package/lib/jet-hub-store.d.ts.map +1 -1
  84. package/lib/jet-hub-store.js +72 -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 +165 -13
  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 +155 -0
  300. package/lib/webdav-sync.d.ts.map +1 -0
  301. package/lib/webdav-sync.js +412 -0
  302. package/lib/webdav-sync.js.map +1 -0
  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,214 @@
1
+ /**
2
+ * qiniu 专用 RPC 的**方法处理函数**(不是自注册端点)。
3
+ *
4
+ * ## ⚠️⚠️ 为什么是「被主 switch 调用」而不是「自己注册」
5
+ *
6
+ * 这一条是 opencode 用真实事故换来的(`src/opencode-rpc.ts` 模块头有完整记录):
7
+ * 它最初在这里调 `rpc.register('jet-hub', handler)`,以为能与 `jet-hub-rpc.ts`
8
+ * 并存。真机报障:
9
+ *
10
+ * ```
11
+ * 添加失败:unknown method: opencode.addAnonymous
12
+ * ```
13
+ *
14
+ * 根因:**Jet Hub 只有一条通道** —— `jet-hub-rpc.ts` 的
15
+ * `connection.fetch.register({ path: JET_HUB_API_PATH })`,它把 `call.method`
16
+ * 交给一个穷举 `switch`,`default` 分支直接回 `unknown method` 且**不让路**。
17
+ *
18
+ * ⇒ 本文件只导出 {@link handleQiniuRpc},由 `jet-hub-rpc.ts` 的
19
+ * `handleMethod` 在 `default` **之前**调用(对不认识的方法返回 `undefined`,
20
+ * 让主 switch 继续匹配)。
21
+ *
22
+ * ## 为什么 qiniu 需要自己的方法(而不是复用 account.create)
23
+ *
24
+ * 七牛云的凭据是用户**手工粘贴的 API Key**,没有 OAuth 授权页 ⇒ `account.create`
25
+ * 那条「先返回 loginUrl、后台等回调」的两步式路径对它**根本不适用**。
26
+ * 本插件已有先例(opencode):前端在最前面改道,直接调 provider 自己的
27
+ * addAccount 方法。**这是本仓库第二家不跳浏览器的 provider。**
28
+ *
29
+ * 与 opencode 的差异(都来自协议事实,不是风格):
30
+ *
31
+ * | | opencode | qiniu |
32
+ * |---|---|---|
33
+ * | 凭据字段 | `api_key` | `access_token`(AccountPool 身份反查要求,见 `qiniu.ts` 模块头) |
34
+ * | 账号去重 | 按 key 尾段派生 id(同 key 复用) | 同左 |
35
+ * | 失效模式 | 形状校验 `[A-Za-z0-9_.-]{20,}`(原 `sk-`,2026-10-22 起上游也发 `oc_sk_…`) | 形状校验 `[A-Za-z0-9_.-]{16,}`(**不绑死前缀**,理由同左) |
36
+ * | 匿名槽 | 有(字面量 `public`) | **没有** —— 七牛云必须持 Key 才能调用 |
37
+ *
38
+ * @module src/qiniu-rpc.ts
39
+ */
40
+ import { createHash } from 'node:crypto';
41
+ import { credentialRef } from '@deepseek-ai/dsh-credentials';
42
+ import { QINIU } from './qiniu-product.js';
43
+ import { parseQiniuCredential } from './qiniu-auth.js';
44
+ import { maskQiniuKey } from './qiniu.js';
45
+ /**
46
+ * Key 形状:至少 16 位 `[A-Za-z0-9_.-]`,**不绑死前缀**。
47
+ *
48
+ * ⚠️ 这只是**形状**校验(挡手滑/占位符),**不是**有效性验证:
49
+ * 真 Key 仍要等第一次真实请求才知道。
50
+ *
51
+ * 官方依据:七牛云《批量创建API Key》文档明示 Key「以 `sk-` 开头」,长度与
52
+ * 字符集未给约束。故判据取与上游命名无关的共性形状,**不写死 `^sk-`** ——
53
+ * 本仓库 opencode 的 Issue IKPLRU 实测过绑死前缀的代价(上游换发 `oc_sk_…`
54
+ * 后旧闸门把新 Key 全数拒收,用户一个账号都加不进来,且完全无法自救)。
55
+ */
56
+ const KEY_PATTERN = /^[A-Za-z0-9_.-]{16,}$/;
57
+ /**
58
+ * 账号 id / credentialRef 由 Key 尾段派生,使重复 Key 落到同一账号。
59
+ *
60
+ * ⚠️⚠️ **ref 名必须是合法标识符**(2026-10-29 审计 P1):宿主的
61
+ * `credentialRef()` 只认 `/^[A-Za-z_][A-Za-z0-9_]*$/`(见
62
+ * `node_modules/@deepseek-ai/dsh-credentials` 的 `REF_PATTERN`),而本家的
63
+ * Key 形状闸放行 `[A-Za-z0-9_.-]`(**刻意不绑死前缀**,见 `KEY_PATTERN`)⇒
64
+ * 末 8 位含 `.`/`-` 的 Key 会把 `QINIU_ACCOUNT_` 拼成 `QINIU_ACCOUNT_BBB-CCDD`,
65
+ * 这个串一进 `credentialRef()` 就 **抛 TypeError**:
66
+ *
67
+ * ```text
68
+ * credential ref "QINIU_ACCOUNT_BBB-CCDD" must match /^[A-Za-z_][A-Za-z0-9_]*$/
69
+ * ```
70
+ *
71
+ * 后果是「任何末 8 位带连字符/点的 Key 都加不进账号」,用户看到一句英文正则 ——
72
+ * 与 opencode 的 Issue IKPLRU 同型(形状闸放宽后派生侧没跟上),故修法照抄
73
+ * `src/opencode-rpc.ts:208-221`:
74
+ *
75
+ * - **尾段本来就合法** ⇒ 逐字节不变(保护存量凭据引用,否则老账号会被当成新账号);
76
+ * - **尾段不合法** ⇒ 剥掉非标识符字符 + 追加 key 的 sha256 前 8 位,
77
+ * 使 `…bb-ccdd` 与 `…bb_ccdd` 不会撞成同一个 ref(撞了会后者覆盖前者凭据)。
78
+ */
79
+ export function qiniuSlotNamesOf(apiKey) {
80
+ const tail = apiKey.slice(-8);
81
+ const upper = tail.toUpperCase();
82
+ // ⚠️ 前缀必须是 `QINIU` —— `jet-hub-store.ts` 的
83
+ // `REF_PREFIX_TO_PROVIDER` 按它反推 provider,漏登记会让
84
+ // `QINIU_ACCOUNT_*` 的账号在 `state.json` 缺失时**静默消失**。
85
+ const refName = /^[A-Z0-9_]*$/.test(upper)
86
+ ? `QINIU_ACCOUNT_${upper}`
87
+ : `QINIU_ACCOUNT_${upper.replace(/[^A-Z0-9_]/g, '')}_${createHash('sha256').update(apiKey).digest('hex').slice(0, 8).toUpperCase()}`;
88
+ return { id: `${QINIU.id}-${tail.toLowerCase()}`, refName };
89
+ }
90
+ /**
91
+ * 处理一个 qiniu RPC 方法。
92
+ *
93
+ * @returns `{ok:true, value}` / `{ok:false, error}`;**方法不认识时返回
94
+ * `undefined`**,让主 switch 继续往下走(它自己的 `default`
95
+ * 分支仍能给出 `unknown method`,语义归属清晰)。
96
+ *
97
+ * ⚠️ 不认识时**必须**返回 `undefined` 而不是 `{ok:false}`:主 switch 会在
98
+ * `default` 之前调用本函数,若本函数对未知方法也回信封,别的 provider 的
99
+ * 方法名就会被误判成「格式错误」而不是「没这个方法」。
100
+ */
101
+ export async function handleQiniuRpc(ctx, pool, method, payload) {
102
+ const fail = (message) => ({ ok: false, error: { code: 'bad-request', message } });
103
+ const done = (value) => ({ ok: true, value });
104
+ try {
105
+ switch (method) {
106
+ case 'qiniu.addAccount': {
107
+ const req = (payload ?? {});
108
+ const apiKey = typeof req.apiKey === 'string' ? req.apiKey.trim() : '';
109
+ if (!KEY_PATTERN.test(apiKey)) {
110
+ return fail('API Key 形状不对(通常以 sk- 开头、至少 16 位;'
111
+ + '可在 https://portal.qiniu.com/ai-inference/api-key 创建)');
112
+ }
113
+ const { id, refName } = qiniuSlotNamesOf(apiKey);
114
+ // ⚠️ 重复 Key 必须**复用**同一账号:同 Key 加两次会让用户误以为是
115
+ // 两个独立额度桶,实际请求仍会打到同一份额度上(并在限额时一起被跳过)。
116
+ if (pool.listAccountsByProvider(QINIU.id).some((a) => a.id === id)) {
117
+ return done({ accountId: id, existed: true });
118
+ }
119
+ const nickname = typeof req.nickname === 'string' && req.nickname.trim().length > 0
120
+ ? req.nickname.trim()
121
+ : `Qiniu ${apiKey.slice(-6)}`;
122
+ await ctx.credentials.set(credentialRef(refName), JSON.stringify({
123
+ // ⚠️ 字段名必须是 `access_token`(AccountPool 身份反查用,见 qiniu.ts)。
124
+ access_token: apiKey,
125
+ nickname,
126
+ }));
127
+ await pool.addAccount({
128
+ id,
129
+ provider: QINIU.id,
130
+ nickname,
131
+ enabled: true,
132
+ credentialRef: refName,
133
+ // ⚠️ 七牛云**没有 refresh 端点**(API Key 是静态材料,默认长期有效),
134
+ // 标 true 会让 UI 显示「可自动续期」——一个永远不会发生的承诺。
135
+ refreshable: false,
136
+ createdAt: Date.now(),
137
+ });
138
+ return done({ accountId: id, existed: false });
139
+ }
140
+ case 'qiniu.setApiKey': {
141
+ const req = (payload ?? {});
142
+ if (typeof req.accountId !== 'string' || req.accountId.length === 0) {
143
+ return fail('缺少 accountId');
144
+ }
145
+ const apiKey = typeof req.apiKey === 'string' ? req.apiKey.trim() : '';
146
+ if (!KEY_PATTERN.test(apiKey)) {
147
+ return fail('API Key 形状不对(通常以 sk- 开头、至少 16 位;'
148
+ + '可在 https://portal.qiniu.com/ai-inference/api-key 创建)');
149
+ }
150
+ const old = pool.listAccountsByProvider(QINIU.id).find((a) => a.id === req.accountId);
151
+ if (!old)
152
+ return fail(`未找到账号 ${req.accountId}`);
153
+ const { id, refName } = qiniuSlotNamesOf(apiKey);
154
+ if (id === req.accountId) {
155
+ // ⚠️ 同一条 Key:只刷新凭据内容,**不动**账号(否则会先删后建、
156
+ // 期间面板上的这条账号会短暂消失,用户可能重复点击)。
157
+ await ctx.credentials.set(credentialRef(refName), JSON.stringify({
158
+ access_token: apiKey,
159
+ // ⚠️ 昵称**沿用旧的**:改 Key 不该顺手把用户起的名字冲掉。
160
+ nickname: typeof old.nickname === 'string' && old.nickname.length > 0
161
+ ? old.nickname
162
+ : `Qiniu ${apiKey.slice(-6)}`,
163
+ }));
164
+ return done({ accountId: id, masked: maskQiniuKey(apiKey), renamed: false });
165
+ }
166
+ // ⚠️⚠️ **Key 变了 ⇒ 账号 id 随尾段变**(`id` 由 Key 尾 8 位派生,见
167
+ // `qiniuSlotNamesOf`)⇒ 这不是「改一个字段」,而是**换一条账号**。
168
+ // 必须显式新建 + 移除旧的,否则会出现两个账号共用一份凭据的错象。
169
+ // ⚠️ 顺序刻意是「先建后删」:反过来的话,若新建失败(磁盘/权限)
170
+ // 用户就**连旧账号一起丢了** —— 删除不可逆(本仓库记过多起同类事故)。
171
+ const target = pool.listAccountsByProvider(QINIU.id).find((a) => a.id === id);
172
+ if (target) {
173
+ return fail(`该 API Key 已对应另一个账号(${id}),请直接编辑那个账号,避免同一 Key 出现两次`);
174
+ }
175
+ await ctx.credentials.set(credentialRef(refName), JSON.stringify({
176
+ access_token: apiKey,
177
+ // ⚠️ 昵称**继承旧的**(含用户手改过的),别让改 Key 顺手改名。
178
+ nickname: typeof old.nickname === 'string' && old.nickname.length > 0
179
+ ? old.nickname
180
+ : `Qiniu ${apiKey.slice(-6)}`,
181
+ }));
182
+ await pool.addAccount({
183
+ id,
184
+ provider: QINIU.id,
185
+ nickname: typeof old.nickname === 'string' && old.nickname.length > 0
186
+ ? old.nickname
187
+ : `Qiniu ${apiKey.slice(-6)}`,
188
+ // ⚠️ 停用状态**继承**旧的:用户特意关掉的账号不该被改 Key 顺手启用。
189
+ enabled: old.enabled,
190
+ credentialRef: refName,
191
+ // ⚠️ 同 `addAccount`:静态 API Key,没有 refresh 端点 ⇒ 诚实记 false。
192
+ refreshable: false,
193
+ createdAt: Date.now(),
194
+ });
195
+ await pool.removeAccount(req.accountId);
196
+ return done({ accountId: id, masked: maskQiniuKey(apiKey), renamed: true });
197
+ }
198
+ default:
199
+ // ⚠️ 返回 `undefined`(不是错误信封):方法不属于 qiniu,
200
+ // 让主 switch 继续匹配 —— 它自己的 `default` 会给出
201
+ // `unknown method`,那才是准确的归属。
202
+ return undefined;
203
+ }
204
+ }
205
+ catch (error) {
206
+ return fail(error instanceof Error ? error.message : String(error));
207
+ }
208
+ }
209
+ /** 供单测用:判断一个 ref 是否是本 provider 的账号 ref。 */
210
+ export function isQiniuAccountRef(ref) {
211
+ return /^QINIU_ACCOUNT_[0-9A-Za-z]+$/.test(ref);
212
+ }
213
+ export { parseQiniuCredential };
214
+ //# sourceMappingURL=qiniu-rpc.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"qiniu-rpc.js","sourceRoot":"","sources":["../src/qiniu-rpc.ts"],"names":[],"mappings":"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"}
package/lib/qiniu.d.ts ADDED
@@ -0,0 +1,145 @@
1
+ /**
2
+ * Qiniu(七牛云)的凭据结构、过期判定、请求头与模型 id 处理。
3
+ *
4
+ * ## 凭据形态
5
+ *
6
+ * 七牛云用的是**长期 API Key**(AI 大模型推理控制台的「API Key」页生成,官方
7
+ * 文档明示**以 `sk-` 开头**;完整长度与字符集官方未给约束),**没有 refresh 端点** ——
8
+ * 与 ZCode / Loomy 同属「凭据是静态材料」那一类,与 codearts / buddy / qoder /
9
+ * trae / cline / raccoon / minimax / gemini 的 OAuth 续期链**不同源**。
10
+ *
11
+ * 本插件的统一形态(与其余 16 家一致):**一条账号一份 JSON 凭据**,
12
+ * 存在 `ctx.credentials` 里、由 `credentialRef` 关联;账号索引进 `AccountPool`。
13
+ * 故这里不引入任何「裸字符串 / 数组号池」的历史形态 —— 那种形态只适合反代,
14
+ * 而本插件没有反代:推理一律经 `ctx.llm` 上的适配器走。
15
+ *
16
+ * ## ⚠️ 字段名必须是 `access_token`
17
+ *
18
+ * `AccountPool.findAccountIdByCredential` 对**非 codearts** 的 provider
19
+ * 统一取 `access_token` 作身份标识(`src/account-pool.ts:1271`):
20
+ *
21
+ * ```ts
22
+ * const identifierKey = provider === 'codearts' ? 'access_key_id' : 'access_token'
23
+ * ```
24
+ *
25
+ * 若这里改名成 `api_key`(opencode 那种写法),限流记录的账号归属会**恒匹配
26
+ * 失败且静默** —— 重测/重置按钮清不掉任何标记。故**沿用 `access_token`**。
27
+ *
28
+ * `docs/adding-a-new-provider.md` 的检查清单把这条写成了硬性要求:
29
+ * 「非 `codearts` 的 provider 凭据含 `access_token` 字段」。
30
+ *
31
+ * @module src/qiniu.ts
32
+ */
33
+ /** 一份可持久化的七牛云凭据。 */
34
+ export interface QiniuCredential {
35
+ /**
36
+ * API Key(身份本体)。
37
+ *
38
+ * ⚠️ 字段名 **必须**是 `access_token`(见模块头),不要改成 `api_key`。
39
+ */
40
+ access_token: string;
41
+ /** 展示名。 */
42
+ nickname?: string;
43
+ /**
44
+ * 毫秒时间戳字符串(若上游给出过有效期)。
45
+ *
46
+ * ⚠️ 七牛云的 API Key **默认长期有效**,实测控制台可设「永久」。故本字段通常
47
+ * **缺失** —— `isQiniuExpired` 因此对缺省值判**未过期**(见下)。
48
+ */
49
+ expires_at?: string;
50
+ /** 账号标识(若可获得;七牛云不提供,保留仅为兼容导入的备份)。 */
51
+ user_id?: string;
52
+ }
53
+ /**
54
+ * 解析凭据里的过期时刻(毫秒)。
55
+ *
56
+ * ⚠️ **读取时兼容秒级时间戳**(`> 1e12` 视为毫秒,否则视为秒)——
57
+ * 与 `src/buddy.ts` 的 `credentialExpiresAtMs` 同一约定。不兼容会让
58
+ * 「上游/历史误写成秒」的值被当成 1970 年 ⇒ **恒判已过期**、无谓续期。
59
+ *
60
+ * @returns 毫秒时间戳;字段缺失或不可解析时 `undefined`。
61
+ */
62
+ export declare function qiniuCredentialExpiresAtMs(credential: QiniuCredential | undefined): number | undefined;
63
+ /**
64
+ * 凭据是否已过期。
65
+ *
66
+ * ⚠️⚠️ **没有 `expires_at` 时恒返回 `false`(= 未过期),这不是省事。**
67
+ *
68
+ * 七牛云的 API Key 默认长期有效,凭据里因此通常**根本没有过期时间**。若把
69
+ * 「读不到」判成「已过期」,后果是:
70
+ * - 界面每张账号卡片都会显示红色「有效期:已过期」;
71
+ * - 续期定时器每轮都把它挑出来(本 provider 又没有 refresh 端点可调);
72
+ * - 用户以为账号坏了,实际一切正常。
73
+ *
74
+ * 与 Loomy 同口径:「读不到就说读不到」,不把未知当失效。
75
+ * 真正的失效由**上游 401** 反映(适配器按需给出可读文案)。
76
+ */
77
+ export declare function isQiniuExpired(credential: QiniuCredential | undefined): boolean;
78
+ /**
79
+ * 凭据是否**具备可续期的材料**。
80
+ *
81
+ * ⚠️ **恒为 `false`**,且这是**诚实标记而非状态**:七牛云没有任何 refresh 端点,
82
+ * API Key 只能由用户回控制台重新生成。标 `true` 会让 UI 显示「可自动续期」
83
+ * ——一个永远不会发生的承诺(与 Loomy 的 `isLoomyRefreshable` 同因)。
84
+ *
85
+ * 账号落池时 `refreshable` 必须写 `false`(见 `qiniu-rpc.ts`)。
86
+ */
87
+ export declare function isQiniuRefreshable(_credential?: QiniuCredential): boolean;
88
+ /** 凭据的身份串(限流记录归属用;取不到时返回空串)。 */
89
+ export declare function qiniuIdentityOf(credential: QiniuCredential | undefined): string;
90
+ /**
91
+ * 把 API Key 打码成 `前 4 位…尾 4 位`(UI 一律用它,**绝不**展示明文)。
92
+ *
93
+ * ## ⚠️ 为什么取**尾 4** 位
94
+ *
95
+ * 与 `qiniuSlotNamesOf`(账号 id 由**尾 8 位**派生)同一口径 ⇒ 用户在
96
+ * 「账号 id」「凭据 ref」「卡片上的打码」三处看到的是同一段指纹,能互相核对。
97
+ *
98
+ * ⚠️ 形状不合法的**返回空串**而不是回显原文 —— 打码函数绝不能成为「把任意
99
+ * 输入原样显示」的通道(否则用户粘贴了一段错误文本时会被整串上屏)。
100
+ *
101
+ * ## ⚠️ 形状闸门**刻意不绑死 `sk-` 前缀**
102
+ *
103
+ * 七牛云官方文档(《批量创建API Key》 developer.qiniu.com/aitokenapi/13392)
104
+ * 明示 Key「以 `sk-` 开头」,OpenClaw 配置指南示例亦为 `sk-...`;但**长度与
105
+ * 字符集官方从未给出约束**。故闸门按与上游命名无关的共性判据
106
+ * 「≥16 位 + 仅 `[A-Za-z0-9_.-]`」,不写死前缀 —— 本仓库 opencode 的
107
+ * Issue IKPLRU 实测过绑死前缀的代价:上游换发 `oc_sk_…` 后 `^sk-` 闸门让
108
+ * 新 Key **全数拒收**,用户一个账号都加不进来。当前正则天然放行 `sk-…`。
109
+ */
110
+ export declare function maskQiniuKey(key: string | undefined | null): string;
111
+ /**
112
+ * 构造发往七牛云的请求头。
113
+ *
114
+ * `Content-Type: application/json` + `Authorization: Bearer <key>`,另加 `Accept`。
115
+ *
116
+ * ## ⚠️ Accept 必须**按用途区分**
117
+ *
118
+ * `/models` 与 `/chat/completions` 共用 `text/event-stream` 在部分平台上会让
119
+ * 目录端点回 **406**(本仓库实测过 ChatAnywhere)⇒ 该上游模型列表**永远失败**,
120
+ * 且后果隐蔽(拉不到时上层静默跳过该上游,它提供的模型全部缺失)。
121
+ * 七牛云本身未实测到 406,但判据不该依赖「某平台碰巧不校验」这种易变外部事实。
122
+ *
123
+ * @param apiKey API Key(空串时仍产出合法头,由调用方先判「有没有凭据」)。
124
+ * @param accept `'application/json'`(列举模型)或 `'text/event-stream'`(对话)。
125
+ */
126
+ export declare function qiniuHeaders(apiKey: string, accept?: 'application/json' | 'text/event-stream'): Record<string, string>;
127
+ /** 对话端点全 URL。 */
128
+ export declare function qiniuChatUrl(product?: import("./qiniu-product.js").QiniuProduct): string;
129
+ /** 模型目录端点全 URL。 */
130
+ export declare function qiniuModelsUrl(product?: import("./qiniu-product.js").QiniuProduct): string;
131
+ /**
132
+ * 归一化模型 id。
133
+ *
134
+ * 七牛云的 `/v1/models` 返回的是**带命名空间前缀**的真实 id
135
+ * (例:`deepseek-ai/DeepSeek-V4.1-Flash`),必须**原样**发给上游 ——
136
+ * 剥掉 `deepseek-ai/` 会得到 404("model not found")。
137
+ *
138
+ * ⚠️ 本函数**只做去空白**,**刻意不做**任何前缀剥离/大小写归一。
139
+ * 存在的意义是:把「调用方忘了 trim」这类失误收敛到一处,并让
140
+ * 「不剥前缀」这条判据有一处可被单测点名的地方。
141
+ * (对照:`canonical-models.ts` 的归一化是**给聚合分组用**的,绝不能回流到
142
+ * 发请求的 model 字段上 —— 那是 qoder 那条「id 是内部代号」教训的同族。)
143
+ */
144
+ export declare function normalizeQiniuModelId(raw: string): string;
145
+ //# sourceMappingURL=qiniu.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"qiniu.d.ts","sourceRoot":"","sources":["../src/qiniu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH,oBAAoB;AACpB,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,eAAe,GAAG,SAAS,GACtC,MAAM,GAAG,SAAS,CAOpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,eAAe,GAAG,SAAS,GAAG,OAAO,CAI/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,eAAe,GAAG,OAAO,CAEzE;AAED,gCAAgC;AAChC,wBAAgB,eAAe,CAAC,UAAU,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAE/E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAMnE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,kBAAkB,GAAG,mBAAyC,GACrE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxB;AAED,iBAAiB;AACjB,wBAAgB,YAAY,CAAC,OAAO,4CAAQ,GAAG,MAAM,CAEpD;AAED,mBAAmB;AACnB,wBAAgB,cAAc,CAAC,OAAO,4CAAQ,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD"}
package/lib/qiniu.js ADDED
@@ -0,0 +1,164 @@
1
+ /**
2
+ * Qiniu(七牛云)的凭据结构、过期判定、请求头与模型 id 处理。
3
+ *
4
+ * ## 凭据形态
5
+ *
6
+ * 七牛云用的是**长期 API Key**(AI 大模型推理控制台的「API Key」页生成,官方
7
+ * 文档明示**以 `sk-` 开头**;完整长度与字符集官方未给约束),**没有 refresh 端点** ——
8
+ * 与 ZCode / Loomy 同属「凭据是静态材料」那一类,与 codearts / buddy / qoder /
9
+ * trae / cline / raccoon / minimax / gemini 的 OAuth 续期链**不同源**。
10
+ *
11
+ * 本插件的统一形态(与其余 16 家一致):**一条账号一份 JSON 凭据**,
12
+ * 存在 `ctx.credentials` 里、由 `credentialRef` 关联;账号索引进 `AccountPool`。
13
+ * 故这里不引入任何「裸字符串 / 数组号池」的历史形态 —— 那种形态只适合反代,
14
+ * 而本插件没有反代:推理一律经 `ctx.llm` 上的适配器走。
15
+ *
16
+ * ## ⚠️ 字段名必须是 `access_token`
17
+ *
18
+ * `AccountPool.findAccountIdByCredential` 对**非 codearts** 的 provider
19
+ * 统一取 `access_token` 作身份标识(`src/account-pool.ts:1271`):
20
+ *
21
+ * ```ts
22
+ * const identifierKey = provider === 'codearts' ? 'access_key_id' : 'access_token'
23
+ * ```
24
+ *
25
+ * 若这里改名成 `api_key`(opencode 那种写法),限流记录的账号归属会**恒匹配
26
+ * 失败且静默** —— 重测/重置按钮清不掉任何标记。故**沿用 `access_token`**。
27
+ *
28
+ * `docs/adding-a-new-provider.md` 的检查清单把这条写成了硬性要求:
29
+ * 「非 `codearts` 的 provider 凭据含 `access_token` 字段」。
30
+ *
31
+ * @module src/qiniu.ts
32
+ */
33
+ import { QINIU } from './qiniu-product.js';
34
+ /**
35
+ * 解析凭据里的过期时刻(毫秒)。
36
+ *
37
+ * ⚠️ **读取时兼容秒级时间戳**(`> 1e12` 视为毫秒,否则视为秒)——
38
+ * 与 `src/buddy.ts` 的 `credentialExpiresAtMs` 同一约定。不兼容会让
39
+ * 「上游/历史误写成秒」的值被当成 1970 年 ⇒ **恒判已过期**、无谓续期。
40
+ *
41
+ * @returns 毫秒时间戳;字段缺失或不可解析时 `undefined`。
42
+ */
43
+ export function qiniuCredentialExpiresAtMs(credential) {
44
+ const raw = credential?.expires_at;
45
+ if (typeof raw !== 'string' || raw.trim().length === 0)
46
+ return undefined;
47
+ const parsed = Number(raw);
48
+ if (!Number.isFinite(parsed) || parsed <= 0)
49
+ return undefined;
50
+ // 秒级(10 位)与毫秒级(13 位)的分界取 1e12。
51
+ return parsed > 1e12 ? parsed : parsed * 1000;
52
+ }
53
+ /**
54
+ * 凭据是否已过期。
55
+ *
56
+ * ⚠️⚠️ **没有 `expires_at` 时恒返回 `false`(= 未过期),这不是省事。**
57
+ *
58
+ * 七牛云的 API Key 默认长期有效,凭据里因此通常**根本没有过期时间**。若把
59
+ * 「读不到」判成「已过期」,后果是:
60
+ * - 界面每张账号卡片都会显示红色「有效期:已过期」;
61
+ * - 续期定时器每轮都把它挑出来(本 provider 又没有 refresh 端点可调);
62
+ * - 用户以为账号坏了,实际一切正常。
63
+ *
64
+ * 与 Loomy 同口径:「读不到就说读不到」,不把未知当失效。
65
+ * 真正的失效由**上游 401** 反映(适配器按需给出可读文案)。
66
+ */
67
+ export function isQiniuExpired(credential) {
68
+ const expiresAt = qiniuCredentialExpiresAtMs(credential);
69
+ if (expiresAt === undefined)
70
+ return false;
71
+ return expiresAt <= Date.now();
72
+ }
73
+ /**
74
+ * 凭据是否**具备可续期的材料**。
75
+ *
76
+ * ⚠️ **恒为 `false`**,且这是**诚实标记而非状态**:七牛云没有任何 refresh 端点,
77
+ * API Key 只能由用户回控制台重新生成。标 `true` 会让 UI 显示「可自动续期」
78
+ * ——一个永远不会发生的承诺(与 Loomy 的 `isLoomyRefreshable` 同因)。
79
+ *
80
+ * 账号落池时 `refreshable` 必须写 `false`(见 `qiniu-rpc.ts`)。
81
+ */
82
+ export function isQiniuRefreshable(_credential) {
83
+ return false;
84
+ }
85
+ /** 凭据的身份串(限流记录归属用;取不到时返回空串)。 */
86
+ export function qiniuIdentityOf(credential) {
87
+ return typeof credential?.access_token === 'string' ? credential.access_token : '';
88
+ }
89
+ /**
90
+ * 把 API Key 打码成 `前 4 位…尾 4 位`(UI 一律用它,**绝不**展示明文)。
91
+ *
92
+ * ## ⚠️ 为什么取**尾 4** 位
93
+ *
94
+ * 与 `qiniuSlotNamesOf`(账号 id 由**尾 8 位**派生)同一口径 ⇒ 用户在
95
+ * 「账号 id」「凭据 ref」「卡片上的打码」三处看到的是同一段指纹,能互相核对。
96
+ *
97
+ * ⚠️ 形状不合法的**返回空串**而不是回显原文 —— 打码函数绝不能成为「把任意
98
+ * 输入原样显示」的通道(否则用户粘贴了一段错误文本时会被整串上屏)。
99
+ *
100
+ * ## ⚠️ 形状闸门**刻意不绑死 `sk-` 前缀**
101
+ *
102
+ * 七牛云官方文档(《批量创建API Key》 developer.qiniu.com/aitokenapi/13392)
103
+ * 明示 Key「以 `sk-` 开头」,OpenClaw 配置指南示例亦为 `sk-...`;但**长度与
104
+ * 字符集官方从未给出约束**。故闸门按与上游命名无关的共性判据
105
+ * 「≥16 位 + 仅 `[A-Za-z0-9_.-]`」,不写死前缀 —— 本仓库 opencode 的
106
+ * Issue IKPLRU 实测过绑死前缀的代价:上游换发 `oc_sk_…` 后 `^sk-` 闸门让
107
+ * 新 Key **全数拒收**,用户一个账号都加不进来。当前正则天然放行 `sk-…`。
108
+ */
109
+ export function maskQiniuKey(key) {
110
+ if (typeof key !== 'string')
111
+ return '';
112
+ const trimmed = key.trim();
113
+ // ⚠️ 与 `KEY_PATTERN`(qiniu-rpc.ts)同款形状:前缀 + 至少 16 位。
114
+ if (!/^[A-Za-z0-9_.-]{16,}$/.test(trimmed))
115
+ return '';
116
+ return `${trimmed.slice(0, 4)}…${trimmed.slice(-4)}`;
117
+ }
118
+ /**
119
+ * 构造发往七牛云的请求头。
120
+ *
121
+ * `Content-Type: application/json` + `Authorization: Bearer <key>`,另加 `Accept`。
122
+ *
123
+ * ## ⚠️ Accept 必须**按用途区分**
124
+ *
125
+ * `/models` 与 `/chat/completions` 共用 `text/event-stream` 在部分平台上会让
126
+ * 目录端点回 **406**(本仓库实测过 ChatAnywhere)⇒ 该上游模型列表**永远失败**,
127
+ * 且后果隐蔽(拉不到时上层静默跳过该上游,它提供的模型全部缺失)。
128
+ * 七牛云本身未实测到 406,但判据不该依赖「某平台碰巧不校验」这种易变外部事实。
129
+ *
130
+ * @param apiKey API Key(空串时仍产出合法头,由调用方先判「有没有凭据」)。
131
+ * @param accept `'application/json'`(列举模型)或 `'text/event-stream'`(对话)。
132
+ */
133
+ export function qiniuHeaders(apiKey, accept = 'text/event-stream') {
134
+ return {
135
+ 'content-type': 'application/json',
136
+ accept,
137
+ authorization: `Bearer ${apiKey}`,
138
+ };
139
+ }
140
+ /** 对话端点全 URL。 */
141
+ export function qiniuChatUrl(product = QINIU) {
142
+ return `${product.baseUrl}${product.chatPath}`;
143
+ }
144
+ /** 模型目录端点全 URL。 */
145
+ export function qiniuModelsUrl(product = QINIU) {
146
+ return `${product.baseUrl}${product.modelsPath}`;
147
+ }
148
+ /**
149
+ * 归一化模型 id。
150
+ *
151
+ * 七牛云的 `/v1/models` 返回的是**带命名空间前缀**的真实 id
152
+ * (例:`deepseek-ai/DeepSeek-V4.1-Flash`),必须**原样**发给上游 ——
153
+ * 剥掉 `deepseek-ai/` 会得到 404("model not found")。
154
+ *
155
+ * ⚠️ 本函数**只做去空白**,**刻意不做**任何前缀剥离/大小写归一。
156
+ * 存在的意义是:把「调用方忘了 trim」这类失误收敛到一处,并让
157
+ * 「不剥前缀」这条判据有一处可被单测点名的地方。
158
+ * (对照:`canonical-models.ts` 的归一化是**给聚合分组用**的,绝不能回流到
159
+ * 发请求的 model 字段上 —— 那是 qoder 那条「id 是内部代号」教训的同族。)
160
+ */
161
+ export function normalizeQiniuModelId(raw) {
162
+ return raw.trim();
163
+ }
164
+ //# sourceMappingURL=qiniu.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"qiniu.js","sourceRoot":"","sources":["../src/qiniu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAuB1C;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAuC;IAEvC,MAAM,GAAG,GAAG,UAAU,EAAE,UAAU,CAAA;IAClC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACxE,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IAC7D,+BAA+B;IAC/B,OAAO,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAA;AAC/C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,UAAuC;IACpE,MAAM,SAAS,GAAG,0BAA0B,CAAC,UAAU,CAAC,CAAA;IACxD,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACzC,OAAO,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAA;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAA6B;IAC9D,OAAO,KAAK,CAAA;AACd,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,eAAe,CAAC,UAAuC;IACrE,OAAO,OAAO,UAAU,EAAE,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;AACpF,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,YAAY,CAAC,GAA8B;IACzD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAA;IACtC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IAC1B,qDAAqD;IACrD,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAA;IACrD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACtD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,SAAmD,mBAAmB;IAEtE,OAAO;QACL,cAAc,EAAE,kBAAkB;QAClC,MAAM;QACN,aAAa,EAAE,UAAU,MAAM,EAAE;KAClC,CAAA;AACH,CAAC;AAED,iBAAiB;AACjB,MAAM,UAAU,YAAY,CAAC,OAAO,GAAG,KAAK;IAC1C,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;AAChD,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,cAAc,CAAC,OAAO,GAAG,KAAK;IAC5C,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAA;AAClD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,OAAO,GAAG,CAAC,IAAI,EAAE,CAAA;AACnB,CAAC"}
@@ -190,8 +190,8 @@ export interface RaccoonAdapterOptions {
190
190
  *
191
191
  * | 类别 | 判据 | 换号? | 写冷却? |
192
192
  * |---|---|---|---|
193
- * | `quota` | `14018` / `Credits exhausted` / `insufficient` / 「积分·额度·余额 + 不足·耗尽」/ `quota exceeded`;HTTP 402 | ✅ | ✅ 24h(日配额) |
194
- * | `rate` | HTTP 429 | ✅ | ✅ 1h |
193
+ * | `quota` | `14018` / `Credits exhausted` / `insufficient` / 「积分·额度·余额 + 不足·耗尽」/ `quota exceeded`;HTTP 402 —— **且状态码不是 401/403/429** | ✅ | ✅ 24h(日配额) |
194
+ * | `rate` | HTTP 429(**先于 quota 文案判定**:限流报文体高频带额度字样,见 `classifyRaccoonFailure`) | ✅ | ✅ 60s |
195
195
  * | `auth` | HTTP 401 / 403(如 `code=200003 authorization_verify_error`) | ✅ | ❌ **绝不写** |
196
196
  * | `other` | 其余 4xx(400 参数错等) | ❌ | ❌ |
197
197
  *
@@ -223,6 +223,22 @@ export type RaccoonFailureClass = 'quota' | 'rate' | 'auth' | 'other';
223
223
  * ⚠️ 顺序不能调换回去:把「先按文案判门禁、再解析」当通则会静默误伤 ——
224
224
  * 401/403 与额度文案并存时(网关侧故障常在报文里带余额提示)必须以状态码为准。
225
225
  *
226
+ * ## ⚠️ 429 也必须先判(2026-11-03,用户报障「均在限流中」取证后补的档)
227
+ *
228
+ * 本上游的**限流报文体高频携带额度字样**(`quota exceeded` 等)——同上游的
229
+ * `sddvcm/workbuddy-api` 在 AGENTS.md 规则 15 里明确登记:「错误分类 429 必须
230
+ * 优先于 hardMarkers:限流 body 高频带 `quota exceeded`,先判 hardRule 会把
231
+ * 限流误归余额耗尽 → 12h 硬冷却。三渠道 `Classify` 均已修复此顺序」。
232
+ * 本仓库 zcode 侧也已修过同型(`zcode.spec.ts` 的「上游把并发限流装进额度码
233
+ * 下发」:`429 + user concurrency limit exceeded` ⇒ 判限流不判额度)。
234
+ *
235
+ * 旧顺序(文案先判、429 后判)的事故形态正是用户 2026-11-03 的报障原文:
236
+ * 瞬时 429 的 body 带 `quota exceeded` ⇒ 误判 `quota` ⇒ 写 **24h** 冷却(而非
237
+ * 短冷却)⇒ 轮换把最多 8 个号全标上 ⇒ 全池「可用账号均在限流中」,解禁时刻
238
+ * = 误判时刻 + 24h。误判方向恒定朝「封号更久」,与 401/403 那次事故同型。
239
+ *
240
+ * ⚠️ 顺序不能调换回去:401/403/429 与额度文案并存时必须以状态码为准。
241
+ *
226
242
  * ⚠️ **本函数与 `classifyLoomyFailure`(`src/loomy-adapter.ts`)是同一张判据表的
227
243
  * 两个实现,必须逐格同构**。真实教训(2026-10-06,**同型复发**):本函数在
228
244
  * `7b524ff` 收窄后 loomy 那份**未同步**,于是同一报文
@@ -1 +1 @@
1
- {"version":3,"file":"raccoon-adapter.d.ts","sourceRoot":"","sources":["../src/raccoon-adapter.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"raccoon-adapter.d.ts","sourceRoot":"","sources":["../src/raccoon-adapter.ts"],"names":[],"mappings":"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"}