@xixka/dsh-hub 0.2.4 → 0.2.6

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 (273) hide show
  1. package/README.md +2 -0
  2. package/lib/account-pool.d.ts +54 -1
  3. package/lib/account-pool.d.ts.map +1 -1
  4. package/lib/account-pool.js +173 -5
  5. package/lib/account-pool.js.map +1 -1
  6. package/lib/account-probe.d.ts +15 -1
  7. package/lib/account-probe.d.ts.map +1 -1
  8. package/lib/account-probe.js +27 -3
  9. package/lib/account-probe.js.map +1 -1
  10. package/lib/aggregate-adapter.d.ts +7 -0
  11. package/lib/aggregate-adapter.d.ts.map +1 -1
  12. package/lib/aggregate-adapter.js +70 -1
  13. package/lib/aggregate-adapter.js.map +1 -1
  14. package/lib/aggregate-expiry.d.ts +66 -0
  15. package/lib/aggregate-expiry.d.ts.map +1 -1
  16. package/lib/aggregate-expiry.js +142 -3
  17. package/lib/aggregate-expiry.js.map +1 -1
  18. package/lib/auto-checkin.d.ts +285 -26
  19. package/lib/auto-checkin.d.ts.map +1 -1
  20. package/lib/auto-checkin.js +701 -40
  21. package/lib/auto-checkin.js.map +1 -1
  22. package/lib/autoclaw-auth.d.ts +29 -6
  23. package/lib/autoclaw-auth.d.ts.map +1 -1
  24. package/lib/autoclaw-auth.js +32 -8
  25. package/lib/autoclaw-auth.js.map +1 -1
  26. package/lib/autoclaw-credits.d.ts +1 -1
  27. package/lib/autoclaw-credits.js +1 -1
  28. package/lib/autoclaw-oauth.d.ts +108 -9
  29. package/lib/autoclaw-oauth.d.ts.map +1 -1
  30. package/lib/autoclaw-oauth.js +393 -25
  31. package/lib/autoclaw-oauth.js.map +1 -1
  32. package/lib/autoclaw-product.d.ts +9 -4
  33. package/lib/autoclaw-product.d.ts.map +1 -1
  34. package/lib/autoclaw-product.js +9 -4
  35. package/lib/autoclaw-product.js.map +1 -1
  36. package/lib/baizhi-adapter.d.ts +182 -0
  37. package/lib/baizhi-adapter.d.ts.map +1 -0
  38. package/lib/baizhi-adapter.js +457 -0
  39. package/lib/baizhi-adapter.js.map +1 -0
  40. package/lib/baizhi-auth.d.ts +205 -0
  41. package/lib/baizhi-auth.d.ts.map +1 -0
  42. package/lib/baizhi-auth.js +387 -0
  43. package/lib/baizhi-auth.js.map +1 -0
  44. package/lib/baizhi-browser-login.d.ts +141 -0
  45. package/lib/baizhi-browser-login.d.ts.map +1 -0
  46. package/lib/baizhi-browser-login.js +216 -0
  47. package/lib/baizhi-browser-login.js.map +1 -0
  48. package/lib/baizhi-credits.d.ts +220 -0
  49. package/lib/baizhi-credits.d.ts.map +1 -0
  50. package/lib/baizhi-credits.js +507 -0
  51. package/lib/baizhi-credits.js.map +1 -0
  52. package/lib/baizhi-messages.d.ts +98 -0
  53. package/lib/baizhi-messages.d.ts.map +1 -0
  54. package/lib/baizhi-messages.js +154 -0
  55. package/lib/baizhi-messages.js.map +1 -0
  56. package/lib/baizhi-product.d.ts +126 -0
  57. package/lib/baizhi-product.d.ts.map +1 -0
  58. package/lib/baizhi-product.js +135 -0
  59. package/lib/baizhi-product.js.map +1 -0
  60. package/lib/baizhi-rpc.d.ts +103 -0
  61. package/lib/baizhi-rpc.d.ts.map +1 -0
  62. package/lib/baizhi-rpc.js +272 -0
  63. package/lib/baizhi-rpc.js.map +1 -0
  64. package/lib/baizhi.d.ts +191 -0
  65. package/lib/baizhi.d.ts.map +1 -0
  66. package/lib/baizhi.js +298 -0
  67. package/lib/baizhi.js.map +1 -0
  68. package/lib/buddy-adapter.d.ts +57 -0
  69. package/lib/buddy-adapter.d.ts.map +1 -1
  70. package/lib/buddy-adapter.js +70 -7
  71. package/lib/buddy-adapter.js.map +1 -1
  72. package/lib/buddy-balance-rank.d.ts +40 -3
  73. package/lib/buddy-balance-rank.d.ts.map +1 -1
  74. package/lib/buddy-balance-rank.js +24 -1
  75. package/lib/buddy-balance-rank.js.map +1 -1
  76. package/lib/buddy-growth.d.ts +135 -10
  77. package/lib/buddy-growth.d.ts.map +1 -1
  78. package/lib/buddy-growth.js +1430 -234
  79. package/lib/buddy-growth.js.map +1 -1
  80. package/lib/canonical-models.d.ts.map +1 -1
  81. package/lib/canonical-models.js +31 -3
  82. package/lib/canonical-models.js.map +1 -1
  83. package/lib/cap-pow.d.ts +82 -0
  84. package/lib/cap-pow.d.ts.map +1 -0
  85. package/lib/cap-pow.js +209 -0
  86. package/lib/cap-pow.js.map +1 -0
  87. package/lib/client/jet-hub.js +76 -31
  88. package/lib/cline-adapter.d.ts +15 -1
  89. package/lib/cline-adapter.d.ts.map +1 -1
  90. package/lib/cline-adapter.js +61 -8
  91. package/lib/cline-adapter.js.map +1 -1
  92. package/lib/cline-models-dev.d.ts +16 -0
  93. package/lib/cline-models-dev.d.ts.map +1 -1
  94. package/lib/cline-models-dev.js +49 -1
  95. package/lib/cline-models-dev.js.map +1 -1
  96. package/lib/cline-models.d.ts +12 -10
  97. package/lib/cline-models.d.ts.map +1 -1
  98. package/lib/cline-models.js +40 -8
  99. package/lib/cline-models.js.map +1 -1
  100. package/lib/codearts-credits.d.ts.map +1 -1
  101. package/lib/codearts-credits.js +33 -2
  102. package/lib/codearts-credits.js.map +1 -1
  103. package/lib/credential-resolver.d.ts +27 -0
  104. package/lib/credential-resolver.d.ts.map +1 -1
  105. package/lib/credential-resolver.js +23 -0
  106. package/lib/credential-resolver.js.map +1 -1
  107. package/lib/credits.d.ts +18 -1
  108. package/lib/credits.d.ts.map +1 -1
  109. package/lib/credits.js.map +1 -1
  110. package/lib/index.d.ts.map +1 -1
  111. package/lib/index.js +555 -31
  112. package/lib/index.js.map +1 -1
  113. package/lib/jet-hub-rpc.d.ts +48 -0
  114. package/lib/jet-hub-rpc.d.ts.map +1 -1
  115. package/lib/jet-hub-rpc.js +985 -35
  116. package/lib/jet-hub-rpc.js.map +1 -1
  117. package/lib/jet-hub-store.d.ts.map +1 -1
  118. package/lib/jet-hub-store.js +54 -1
  119. package/lib/jet-hub-store.js.map +1 -1
  120. package/lib/llm-adapter.d.ts +54 -1
  121. package/lib/llm-adapter.d.ts.map +1 -1
  122. package/lib/llm-adapter.js +72 -3
  123. package/lib/llm-adapter.js.map +1 -1
  124. package/lib/llm-register-compat.d.ts +57 -0
  125. package/lib/llm-register-compat.d.ts.map +1 -1
  126. package/lib/llm-register-compat.js +91 -7
  127. package/lib/llm-register-compat.js.map +1 -1
  128. package/lib/login.d.ts.map +1 -1
  129. package/lib/login.js +8 -0
  130. package/lib/login.js.map +1 -1
  131. package/lib/magicrew-auth.d.ts.map +1 -1
  132. package/lib/magicrew-auth.js +4 -1
  133. package/lib/magicrew-auth.js.map +1 -1
  134. package/lib/magicrew-checkin.d.ts +139 -0
  135. package/lib/magicrew-checkin.d.ts.map +1 -0
  136. package/lib/magicrew-checkin.js +536 -0
  137. package/lib/magicrew-checkin.js.map +1 -0
  138. package/lib/magicrew-credits.d.ts +24 -1
  139. package/lib/magicrew-credits.d.ts.map +1 -1
  140. package/lib/magicrew-credits.js +175 -33
  141. package/lib/magicrew-credits.js.map +1 -1
  142. package/lib/magicrew-number.d.ts +68 -0
  143. package/lib/magicrew-number.d.ts.map +1 -0
  144. package/lib/magicrew-number.js +89 -0
  145. package/lib/magicrew-number.js.map +1 -0
  146. package/lib/magicrew-product.d.ts +75 -3
  147. package/lib/magicrew-product.d.ts.map +1 -1
  148. package/lib/magicrew-product.js +100 -0
  149. package/lib/magicrew-product.js.map +1 -1
  150. package/lib/minimax-dedup.d.ts +1 -1
  151. package/lib/minimax-dedup.d.ts.map +1 -1
  152. package/lib/minimax-dedup.js +1 -1
  153. package/lib/minimax-dedup.js.map +1 -1
  154. package/lib/model-catalog.d.ts +13 -0
  155. package/lib/model-catalog.d.ts.map +1 -1
  156. package/lib/model-catalog.js +12 -1
  157. package/lib/model-catalog.js.map +1 -1
  158. package/lib/models.d.ts +15 -1
  159. package/lib/models.d.ts.map +1 -1
  160. package/lib/models.js +112 -20
  161. package/lib/models.js.map +1 -1
  162. package/lib/monkeycode-adapter.d.ts +164 -0
  163. package/lib/monkeycode-adapter.d.ts.map +1 -0
  164. package/lib/monkeycode-adapter.js +438 -0
  165. package/lib/monkeycode-adapter.js.map +1 -0
  166. package/lib/monkeycode-auth.d.ts +222 -0
  167. package/lib/monkeycode-auth.d.ts.map +1 -0
  168. package/lib/monkeycode-auth.js +371 -0
  169. package/lib/monkeycode-auth.js.map +1 -0
  170. package/lib/monkeycode-browser-login.d.ts +180 -0
  171. package/lib/monkeycode-browser-login.d.ts.map +1 -0
  172. package/lib/monkeycode-browser-login.js +270 -0
  173. package/lib/monkeycode-browser-login.js.map +1 -0
  174. package/lib/monkeycode-credits.d.ts +277 -0
  175. package/lib/monkeycode-credits.d.ts.map +1 -0
  176. package/lib/monkeycode-credits.js +673 -0
  177. package/lib/monkeycode-credits.js.map +1 -0
  178. package/lib/monkeycode-messages.d.ts +137 -0
  179. package/lib/monkeycode-messages.d.ts.map +1 -0
  180. package/lib/monkeycode-messages.js +207 -0
  181. package/lib/monkeycode-messages.js.map +1 -0
  182. package/lib/monkeycode-product.d.ts +178 -0
  183. package/lib/monkeycode-product.d.ts.map +1 -0
  184. package/lib/monkeycode-product.js +156 -0
  185. package/lib/monkeycode-product.js.map +1 -0
  186. package/lib/monkeycode-rpc.d.ts +61 -0
  187. package/lib/monkeycode-rpc.d.ts.map +1 -0
  188. package/lib/monkeycode-rpc.js +342 -0
  189. package/lib/monkeycode-rpc.js.map +1 -0
  190. package/lib/monkeycode.d.ts +189 -0
  191. package/lib/monkeycode.d.ts.map +1 -0
  192. package/lib/monkeycode.js +296 -0
  193. package/lib/monkeycode.js.map +1 -0
  194. package/lib/oauth.d.ts +23 -0
  195. package/lib/oauth.d.ts.map +1 -1
  196. package/lib/oauth.js +98 -13
  197. package/lib/oauth.js.map +1 -1
  198. package/lib/openai-gateway/models.d.ts +23 -0
  199. package/lib/openai-gateway/models.d.ts.map +1 -1
  200. package/lib/openai-gateway/models.js +48 -19
  201. package/lib/openai-gateway/models.js.map +1 -1
  202. package/lib/openai-gateway/server.d.ts.map +1 -1
  203. package/lib/openai-gateway/server.js +6 -3
  204. package/lib/openai-gateway/server.js.map +1 -1
  205. package/lib/openai-gateway/tencent-fingerprint.d.ts.map +1 -1
  206. package/lib/openai-gateway/tencent-fingerprint.js +11 -0
  207. package/lib/openai-gateway/tencent-fingerprint.js.map +1 -1
  208. package/lib/opencode-proxy.d.ts +63 -0
  209. package/lib/opencode-proxy.d.ts.map +1 -1
  210. package/lib/opencode-proxy.js +80 -36
  211. package/lib/opencode-proxy.js.map +1 -1
  212. package/lib/permanent-lock-store.d.ts +7 -0
  213. package/lib/permanent-lock-store.d.ts.map +1 -1
  214. package/lib/permanent-lock-store.js +85 -10
  215. package/lib/permanent-lock-store.js.map +1 -1
  216. package/lib/provider-credits.d.ts.map +1 -1
  217. package/lib/provider-credits.js +167 -2
  218. package/lib/provider-credits.js.map +1 -1
  219. package/lib/provider-expiry.d.ts.map +1 -1
  220. package/lib/provider-expiry.js +67 -1
  221. package/lib/provider-expiry.js.map +1 -1
  222. package/lib/provider-onboarding.d.ts +10 -0
  223. package/lib/provider-onboarding.d.ts.map +1 -1
  224. package/lib/provider-onboarding.js +70 -0
  225. package/lib/provider-onboarding.js.map +1 -1
  226. package/lib/provider-registry.d.ts.map +1 -1
  227. package/lib/provider-registry.js +257 -16
  228. package/lib/provider-registry.js.map +1 -1
  229. package/lib/proxy-mask.d.ts.map +1 -1
  230. package/lib/proxy-mask.js +14 -1
  231. package/lib/proxy-mask.js.map +1 -1
  232. package/lib/qoder-adapter.d.ts +60 -2
  233. package/lib/qoder-adapter.d.ts.map +1 -1
  234. package/lib/qoder-adapter.js +215 -3
  235. package/lib/qoder-adapter.js.map +1 -1
  236. package/lib/qoder-credits.d.ts.map +1 -1
  237. package/lib/qoder-credits.js +34 -4
  238. package/lib/qoder-credits.js.map +1 -1
  239. package/lib/raccoon-adapter.d.ts +27 -0
  240. package/lib/raccoon-adapter.d.ts.map +1 -1
  241. package/lib/raccoon-adapter.js +38 -2
  242. package/lib/raccoon-adapter.js.map +1 -1
  243. package/lib/raccoon-product.d.ts.map +1 -1
  244. package/lib/raccoon-product.js +10 -4
  245. package/lib/raccoon-product.js.map +1 -1
  246. package/lib/refresh-scheduler.d.ts +14 -0
  247. package/lib/refresh-scheduler.d.ts.map +1 -1
  248. package/lib/refresh-scheduler.js +28 -2
  249. package/lib/refresh-scheduler.js.map +1 -1
  250. package/lib/service.d.ts +2 -0
  251. package/lib/service.d.ts.map +1 -1
  252. package/lib/service.js +55 -1
  253. package/lib/service.js.map +1 -1
  254. package/lib/session-cookie.d.ts +39 -0
  255. package/lib/session-cookie.d.ts.map +1 -0
  256. package/lib/session-cookie.js +69 -0
  257. package/lib/session-cookie.js.map +1 -0
  258. package/lib/types.d.ts +153 -5
  259. package/lib/types.d.ts.map +1 -1
  260. package/lib/types.js.map +1 -1
  261. package/lib/webdav-auto-sync.d.ts +8 -3
  262. package/lib/webdav-auto-sync.d.ts.map +1 -1
  263. package/lib/webdav-auto-sync.js +0 -0
  264. package/lib/webdav-auto-sync.js.map +1 -1
  265. package/lib/webdav-rpc.d.ts +13 -0
  266. package/lib/webdav-rpc.d.ts.map +1 -0
  267. package/lib/webdav-rpc.js +127 -0
  268. package/lib/webdav-rpc.js.map +1 -0
  269. package/lib/zcode-upstream.d.ts +23 -5
  270. package/lib/zcode-upstream.d.ts.map +1 -1
  271. package/lib/zcode-upstream.js +27 -9
  272. package/lib/zcode-upstream.js.map +1 -1
  273. package/package.json +3 -1
package/lib/index.js CHANGED
@@ -34,7 +34,7 @@ import { registerZcodeLlm } from './zcode-adapter.js';
34
34
  import { ZCODE } from './zcode-product.js';
35
35
  // 浏览器授权 + 本地轮询设备流登录,无扩展动词、无专属前端 UI。
36
36
  import { ZCODE_CAPTCHA_FALLBACK } from './zcode-captcha.js';
37
- import { AccountPool, allAccountsRateLimitedForModel } from './account-pool.js';
37
+ import { AccountPool, allAccountsRateLimitedForModel, isPolicyBlockedAccount } from './account-pool.js';
38
38
  import { geminiFetchForAccount, setGeminiProxyPool } from './gemini-proxy.js';
39
39
  import { qoderFetchForAccount, setQoderProxyPool } from './qoder-proxy.js';
40
40
  import { foldReasonErrors } from './locked-error-text.js';
@@ -92,8 +92,9 @@ import { fetchQoderBalanceDetailed, fetchQoderCreditBalance } from './qoder-cred
92
92
  // 薄封装(压平 `fetchAstudioBalanceDetailed` 的 `{balance, error?}` 成
93
93
  // `CreditBalance | null`)。两个变体**都接**(见上方长注释),选号器优先用 Detailed。
94
94
  import { MagicrewAuth } from './magicrew-auth.js';
95
+ import { fetchMagicrewBalance } from './magicrew-credits.js';
95
96
  import { MagicrewService } from './magicrew.js';
96
- import { MAGICREW } from './magicrew-product.js';
97
+ import { MAGICREW, MAGICREW_INTL } from './magicrew-product.js';
97
98
  import { registerAdapterIdempotent } from './llm-register-compat.js';
98
99
  import { fetchAstudioBalanceDetailed, fetchAstudioCreditBalance } from './astudio-credits.js';
99
100
  // ⚠️ MiniMax 两站的 `fetchMinimaxCreditBalance`(2026-10-20,同为「永久积分锁定」新增):
@@ -181,6 +182,25 @@ import { QiniuAuth } from './qiniu-auth.js';
181
182
  import { QiniuAdapter, registerQiniuLlm } from './qiniu-adapter.js';
182
183
  import { QINIU } from './qiniu-product.js';
183
184
  import { qiniuModelsUrl, qiniuHeaders } from './qiniu.js';
185
+ // MonkeyCode(`monkeycode` / `monkeycodeintl`,2026-11-02):**本 fork 独有**。
186
+ // 无 OAuth,但**主路径是浏览器登录**(`loginViaBrowser()` 开窗读 cookie;四审
187
+ // H-3 更正:此前这里写成「粘贴静态 Key、无登录」),粘贴 Key 只是备用入口。
188
+ // 协议层是 **Anthropic Messages**(两条通道都是),故消息/SSE 复用
189
+ // `src/minimax-messages.ts`。
190
+ // ⚠️ 两条通道的**模型清单来源不同**:白泽有 `GET /v1/models`(动态拉、
191
+ // 失败回退内置表),网关**没有列出接口**(405)⇒ 用 `MONKEYCODE_GATEWAY_MODELS`。
192
+ import { MonkeycodeAuth } from './monkeycode-auth.js';
193
+ import { MonkeycodeAdapter, registerMonkeycodeLlm } from './monkeycode-adapter.js';
194
+ import { MONKEYCODE, MONKEYCODE_INTL } from './monkeycode-product.js';
195
+ // 百智云(`baizhi`,2026-11-02):凭据是长期静态 `sk-…`(实测 67 位),**主路径**
196
+ // 是浏览器登录后从「大模型商店」取
197
+ // (`https://ai-models.app.baizhi.cloud/console/api-keys`,四审 H-3 更正:此前
198
+ // 这里写成「用户手工粘贴」),手工粘贴只是备用;直连
199
+ // `https://ai-models.app.baizhi.cloud/api/anthropic`(Anthropic Messages 协议),
200
+ // **按量计费**、无每日额度/签到 —— 与 MonkeyCode 两站是不同产品线。
201
+ import { BaizhiAuth } from './baizhi-auth.js';
202
+ import { BaizhiAdapter, registerBaizhiLlm } from './baizhi-adapter.js';
203
+ import { BAIZHI } from './baizhi-product.js';
184
204
  import { GEMINI_DEFAULT_PROJECT, GEMINI_SESSION_LANE_SMOKE } from './gemini.js';
185
205
  import { createProviderCredits, creditsOf } from './provider-credits.js';
186
206
  import { createProviderOnboarding, onboardingOf } from './provider-onboarding.js';
@@ -717,6 +737,59 @@ export const probeById = {
717
737
  product: QINIU,
718
738
  }),
719
739
  },
740
+ // MonkeyCode(**本 fork 独有**)—— 粘贴静态 Key 型渠道,探测只喂**这一份凭据**。
741
+ //
742
+ // ⚠️ **不传 `fetchRemoteModels`**:探测要判的是「这份凭据能不能推理」,而
743
+ // 白泽模型目录**实测免鉴权也回 200**(与 qiniu `/v1/models` 同款性质)
744
+ // ⇒ 目录能读到**不构成**凭据有效的证据。探测直接用内置清单 + 真实补全请求。
745
+ // ⚠️ 不传 `warn`:`probeById` 是**模块级**常量(在 `apply()` 之前求值),
746
+ // 此处**没有 `ctx`**。
747
+ monkeycode: {
748
+ createProbeAdapter: (ref, credential) => new MonkeycodeAdapter({
749
+ credentialRef: credentialRef(ref),
750
+ slots: async () => [{
751
+ // ⚠️ `accountId` 只用于限流标记;探测路径没有池,给一个固定占位
752
+ // (不会写进任何池 —— 适配器只在 `accountPool !== undefined` 时才写)。
753
+ accountId: MONKEYCODE.id,
754
+ credential: credential,
755
+ }],
756
+ product: MONKEYCODE,
757
+ }),
758
+ },
759
+ // MonkeyCode 国际站(`monkeycodeintl`)—— 与国内站逐行同构,只差 `product`。
760
+ //
761
+ // ⚠️ 必须**单独一条**:`probeById` 是按 provider id 取工厂的,漏了这一条
762
+ // ⇒ 国际站账号卡片上的「重测」按钮点了没反应(`probeAdapter` 查不到
763
+ // 就直接回「不支持探测」,全程静默)。
764
+ monkeycodeintl: {
765
+ createProbeAdapter: (ref, credential) => new MonkeycodeAdapter({
766
+ credentialRef: credentialRef(ref),
767
+ slots: async () => [{
768
+ accountId: MONKEYCODE_INTL.id,
769
+ credential: credential,
770
+ }],
771
+ product: MONKEYCODE_INTL,
772
+ }),
773
+ },
774
+ // 百智云(`baizhi`)—— 静态 `sk-` Key 直连,无平台登录态、无每日额度。
775
+ //
776
+ // ⚠️ 必须**单独一条**:`probeById` 是按 provider id 取工厂的,漏了这一条
777
+ // ⇒ 百智云账号卡片上的「重测」按钮点了没反应(查不到就直接回「不支持
778
+ // 探测」,全程静默)。
779
+ // ⚠️ 不传 `warn`:`probeById` 是**模块级**常量(在 `apply()` 之前求值),
780
+ // 此处**没有 `ctx`**。
781
+ baizhi: {
782
+ createProbeAdapter: (ref, credential) => new BaizhiAdapter({
783
+ credentialRef: credentialRef(ref),
784
+ slots: async () => [{
785
+ // ⚠️ `accountId` 只用于限流标记;探测路径没有池,给一个固定占位
786
+ // (不会写进任何池 —— 适配器只在 `accountPool !== undefined` 时才写)。
787
+ id: BAIZHI.id,
788
+ apiKey: credential.access_token,
789
+ }],
790
+ product: BAIZHI,
791
+ }),
792
+ },
720
793
  // ZCode(智谱)→ Anthropic Messages 体 + 阿里云 captcha 参数。
721
794
  //
722
795
  // ⚠️ 已知取舍:探测路径**没有** `mintCaptcha` 透传通道(`ProbeDeps` 里没有
@@ -1828,10 +1901,16 @@ export function apply(ctx) {
1828
1901
  *
1829
1902
  * ## ⚠️ 位置约束(与 astudio 那处同理)
1830
1903
  *
1831
- * 本函数放在 `loomyLockedError` **之前**是有意的:`loomy-balance-error-contract.spec.ts`
1832
- * 用「`const loomyLockedError` 到 `const buddy = new BuddyAuth`」切片来核对 Loomy 的
1833
- * 错误码(Loomy 用可重试的 `TRANSPORT`,本家必须用不可重试的 `QUOTA_EXCEEDED`)。
1834
- * 插进那个区间会让该用例把本家的码当成 Loomy 的核对而**必然变红**。
1904
+ * 本函数放在 `loomyLockedError` **之前**,理由是**可读性**(同一屏内与 autoclaw 等
1905
+ * 同样使用 `QUOTA_EXCEEDED` 的锁定错误排在一起),**不是**为了躲某个切片。
1906
+ *
1907
+ * ⚠️⚠️ **原先这里写的是「插进 Loomy 区间会让 `loomy-balance-error-contract.spec.ts`
1908
+ * 必然变红」—— 那是错的**(2026-11-01 二审实测):该 spec 的终点锚点早在
1909
+ * 2026-10-20 就从 `const buddy = new BuddyAuth` 换成了 `'\n const '`(下一个同级
1910
+ * 声明),它自己的注释 `:35-47` 明写「就是为了别人插 const 时不再被迫挪顺序」。
1911
+ * 实测在该区间插一个用 `'QUOTA_EXCEEDED'` 的同级 const,那个切片**逐字节不变**。
1912
+ * ⇒ 位置的真正守卫是 `tests/unit/magicrew-lock-wiring.spec.ts` 的
1913
+ * `expect(mine).toBeLessThan(loomy)`,不要再靠「会变红」这种口耳相传的理由排序。
1835
1914
  */
1836
1915
  const autoclawLockedError = (displayName) => (reason) => {
1837
1916
  const days = buddyExpiringWindowDays();
@@ -1901,6 +1980,102 @@ export function apply(ctx) {
1901
1980
  + ' —— 这是锁定的预期效果。'
1902
1981
  + `请在 Jet Hub 的 ${displayName} 面板解锁永久积分,或等待下一次签到 / 活动发放。`, 'QUOTA_EXCEEDED');
1903
1982
  };
1983
+ /**
1984
+ * Magicrew(国内 `magicrew` / 国际版 `magicrewintl`)的
1985
+ * 「锁定永久积分 + 无可用账号」报错文案(2026-11-01 用户要求加锁定)。
1986
+ *
1987
+ * ## 本家的积分形状(决定文案能说什么、不能说什么)
1988
+ *
1989
+ * `GET /api/v1/quota/points/total` 只给两样东西:`total_points` 与
1990
+ * `expiring_quota_details[]`(**带到期时间**的批次)。两者的差额是上游
1991
+ * **不下发任何到期时间**的积分 —— 也就是用户口径的**永久积分**
1992
+ *(取证:国内 2661 total / 1661 批次 / 残差 1000;国际 347 / 247 / 100,
1993
+ * 见 `magicrew-credits.ts` 的合成包注释)。⇒ 文案里可以说「永久积分」
1994
+ *(判据是**有没有到期时间**,不是某个池名),但**不得**点名任何积分池
1995
+ *(上游不下发池名,那会是 AutoClaw 那次「编池名」的同型缺陷)。
1996
+ *
1997
+ * ## 与领居家四份的差异(**不是漏抽公共函数**)
1998
+ *
1999
+ * buddy / qoder / astudio / minimax / autoclaw 五家的 `exhausted` 文案都在描述
2000
+ * 「活动赠送 / 签到包」这类**有名字的桶**。本家**没有桶名**,只有一个
2001
+ * 「到期时间有无」的判据 ⇒ 强行共用会写出一句无从核实的话
2002
+ *(`foldReasonErrors` 那类公共部分已复用,`lockedError` 文案逐家独有是本仓惯例)。
2003
+ *
2004
+ * ## 错误码取 `QUOTA_EXCEEDED`
2005
+ *
2006
+ * 与其余五家一致:这确实是额度问题,且它**不在**宿主
2007
+ * `DEFAULT_RETRYABLE_CODES` 里 ⇒ 不会被白重试(锁定是**确定性**结果)。
2008
+ * ⚠️ `unknown` 档文案写「请重试」而该码不可重试 —— 这是**全仓既有**的自相矛盾
2009
+ *(`autoclawLockedError` 的注释里已登记过同样的六家口径),本次**跟随多数派、
2010
+ * 不单独开例外**;要修应六家一起改,属独立任务。
2011
+ *
2012
+ * ## 位置约束
2013
+ *
2014
+ * 本函数放在 `loomyLockedError` **之前**,理由是**可读性**(同一屏内与 autoclaw 等
2015
+ * 同样使用 `QUOTA_EXCEEDED` 的锁定错误排在一起),**不是**为了躲某个切片。
2016
+ *
2017
+ * ⚠️⚠️ **原先这里写的是「插进 Loomy 区间会让 `loomy-balance-error-contract.spec.ts`
2018
+ * 必然变红」—— 那是错的**(2026-11-01 二审实测):该 spec 的终点锚点早在
2019
+ * 2026-10-20 就从 `const buddy = new BuddyAuth` 换成了 `'\n const '`(下一个同级
2020
+ * 声明),它自己的注释 `:35-47` 明写「就是为了别人插 const 时不再被迫挪顺序」。
2021
+ * 实测在该区间插一个用 `'QUOTA_EXCEEDED'` 的同级 const,那个切片**逐字节不变**。
2022
+ * ⇒ 位置的真正守卫是 `tests/unit/magicrew-lock-wiring.spec.ts` 的
2023
+ * `expect(mine).toBeLessThan(loomy)`,不要再靠「会变红」这种口耳相传的理由排序。
2024
+ */
2025
+ const magicrewLockedError = (displayName) => (reason) => {
2026
+ const days = buddyExpiringWindowDays();
2027
+ if (reason.kind === 'unknown') {
2028
+ return new LlmError(`${displayName}:无法确认是否有可用账号。已锁定永久积分,而本次余额查询未能全部完成`
2029
+ + `(${foldReasonErrors(reason.errors)})。这些账号**可能仍有**「${days} 天内到期」`
2030
+ + '的积分 —— 请重试。'
2031
+ + `⚠️ 若持续失败,请在 Jet Hub 的 ${displayName} 面板检查凭据是否失效`
2032
+ + '(本家的推理凭据是定期轮换的 `mgw_` key,JWT 过期后需要重新登录);'
2033
+ // ⚠️ 点名 `organizationCode` 是可诊断性的唯一出路:`fetchMagicrewBalance`
2034
+ // 没有「缺组织码」前置守卫(签到侧有,用的是 `product.needsOrgOnGateway`)
2035
+ // ⇒ 缺组织码时请求照发、上游回 `code 2182`(用户所在组织不存在)⇒ 落到本档,
2036
+ + '需要网关组织码的站点,还要确认该账号登录时选过组织(`organizationCode` 已记录)。', 'QUOTA_EXCEEDED');
2037
+ }
2038
+ if (reason.kind === 'no-candidates') {
2039
+ // ⚠️ **不得照抄 buddy 系那句「或全部账号都在本次请求的模型上受限」**(2026-11-01 二审):
2040
+ // `candidatesOf()` 只用两个条件筛候选 —— `a.enabled` 与
2041
+ // `modelRateLimits[modelId]` 未过期。而本家**从不写** `modelRateLimits`:
2042
+ // 写它的是各适配器里的 `updateModelRateLimit()` 调用,而
2043
+ // `src/magicrew-adapter.ts` / `src/magicrew.ts` / `src/magicrew-credits.ts`
2044
+ // 里该调用 **0 处** ⇒ 第二个条件恒放行 ⇒ 本档只可能是「没有启用中的账号」。
2045
+ //
2046
+ // ⚠️ **不要**用 `rateLimit` 当理由:两站在 `src/provider-registry.ts` 里
2047
+ // 都写的是 `rateLimit: false`(2026-11-01 三审更正 —— 本条原写「国内站
2048
+ // 省略该字段」,实测已不成立),而该字段管辖的是「重测 / 重置」按钮,
2049
+ // **不驱动** `modelRateLimits` 的写入。写进文案就是让用户排查一个不可能
2050
+ // 存在的方向。
2051
+ return new LlmError(`${displayName}:没有可用账号。已锁定永久积分,而本次**没有任何候选账号**`
2052
+ + '(该 provider 下没有**启用中**的账号)。'
2053
+ + `请在 Jet Hub 的 ${displayName} 面板确认至少有一个账号处于启用状态;`
2054
+ + '或改用其它 provider / 模型,或解锁永久积分后重试。', 'QUOTA_EXCEEDED');
2055
+ }
2056
+ if (reason.kind === 'credential-only') {
2057
+ // ⚠️ **必须与「积分用尽」逐字分开**,且要**明确劝阻解锁**:解锁会不可
2058
+ // 撤回地消耗永久积分,而本情形的根因在凭据、与积分无关。
2059
+ return new LlmError(`${displayName}:无法使用任何账号。已锁定永久积分,而余额分档**确实选出了**`
2060
+ + '有可用积分的账号 —— 但它们的**凭据读不出来**(凭据缺失 / 已失效 / 被并发续期覆盖)。'
2061
+ + '⚠️ 这与「积分用尽」是两件事,**不要去解锁永久积分**(解锁会不可撤回地消耗它们)。'
2062
+ + `请在 Jet Hub 的 ${displayName} 面板检查这些账号的凭据,必要时重新登录。`, 'QUOTA_EXCEEDED');
2063
+ }
2064
+ /**
2065
+ * ⚠️⚠️ **穷尽性守卫**(与 buddy / Loomy / AStudio / MiniMax / AutoClaw 五份同型):
2066
+ * 走到这里**只允许**是 `{ kind: 'exhausted' }`。把 `reason` 赋给单成员类型,
2067
+ * 将来 `BuddyNoAccountReason` 加了新档位却忘写文案时,`tsc` 当场报
2068
+ * `TS2322`,而不是静默落进「积分都已用尽」—— 那句会把用户推向
2069
+ * **不可撤回**的解锁操作。
2070
+ */
2071
+ const exhaustedOnly = reason;
2072
+ void exhaustedOnly;
2073
+ return new LlmError(`${displayName}:没有可用账号。已锁定永久积分,而所有账号的「${days} 天内到期」`
2074
+ + '积分(上游 `expiring_quota_details` 里那些**带到期时间**的批次)都已用尽。'
2075
+ + '**永久积分**(上游**不下发到期时间**的那部分)在锁定状态下动不到它们'
2076
+ + ' —— 这是锁定的预期效果。'
2077
+ + `请在 Jet Hub 的 ${displayName} 面板解锁永久积分,或等待下一次签到 / 活动发放。`, 'QUOTA_EXCEEDED');
2078
+ };
1904
2079
  /**
1905
2080
  * Loomy 的「锁定永久积分 + 无可用账号」报错文案(issue IKMCOO 缺陷 2/3)。
1906
2081
  *
@@ -2566,6 +2741,18 @@ export function apply(ctx) {
2566
2741
  * (`cline-bb211a53`)过滤 → 两个 id 空间不一致 → 表格永远空白。
2567
2742
  */
2568
2743
  let activeClineAccountId = '';
2744
+ /** Cline 按 ref 读取凭据;推理选号与目录专用选号共用同一解析口径。 */
2745
+ const resolveClineCredentialByRef = async (refName) => {
2746
+ const resolved = await ctx.credentials.resolve(credentialRef(refName));
2747
+ if (!resolved)
2748
+ return undefined;
2749
+ try {
2750
+ return JSON.parse(resolved.value);
2751
+ }
2752
+ catch {
2753
+ return undefined;
2754
+ }
2755
+ };
2569
2756
  const clineAdapter = registerClineLlm(ctx, {
2570
2757
  credentialRef: credentialRef(CLINE.defaultCredentialRef),
2571
2758
  // 只从 Cline 自己的账号池取账号,回退到自己的单凭据 ref,
@@ -2585,17 +2772,7 @@ export function apply(ctx) {
2585
2772
  },
2586
2773
  }, {
2587
2774
  product: CLINE,
2588
- readCredential: async (refName) => {
2589
- const resolved = await ctx.credentials.resolve(credentialRef(refName));
2590
- if (!resolved)
2591
- return undefined;
2592
- try {
2593
- return JSON.parse(resolved.value);
2594
- }
2595
- catch {
2596
- return undefined;
2597
- }
2598
- },
2775
+ readCredential: resolveClineCredentialByRef,
2599
2776
  fallback: { kind: 'ref', refName: CLINE.defaultCredentialRef },
2600
2777
  // ⚠️ 与 buddy / workbuddy 同因(真实缺陷,2026-10-03 用户报障):
2601
2778
  // 唯一的 cline 账号被**模型级限流**标记挡住时,候选会筛成空集,最终降级成
@@ -2604,6 +2781,19 @@ export function apply(ctx) {
2604
2781
  // 先把「其实是限流,预计 X 后解禁」说清楚。
2605
2782
  throwIfAllRateLimited: throwIfAllAccountsRateLimited,
2606
2783
  }),
2784
+ // 目录是账号无关的只读数据:仍尊重用户停用与策略封禁,但不复用推理
2785
+ // 的账号/模型限流过滤。否则唯一账号正在冷却时,目录会误报「无可用凭据」,
2786
+ // 按量模型目录随之下线;这与 CodeArts 的目录专用凭据链同型。
2787
+ resolveCatalogCredential: async () => {
2788
+ for (const entry of pool.listAccountsByProvider(CLINE.id)) {
2789
+ if (!entry.enabled || isPolicyBlockedAccount(entry))
2790
+ continue;
2791
+ const credential = await resolveClineCredentialByRef(entry.credentialRef);
2792
+ if (credential !== undefined)
2793
+ return credential;
2794
+ }
2795
+ return await resolveClineCredentialByRef(CLINE.defaultCredentialRef);
2796
+ },
2607
2797
  refresh: async () => {
2608
2798
  // 必须刷新**解析凭据时所用的那一个**账号,而不是默认单凭据 ref。
2609
2799
  //
@@ -3557,9 +3747,10 @@ export function apply(ctx) {
3557
3747
  // 实测佐证:拿国内签发的 token 打国际基址,`wallets` / `user-profile`
3558
3748
  // 一律 `410000 用户未登录`、推理 `401 Invalid token` ⇒ 用户体系物理隔离。
3559
3749
  //
3560
- // ⚠️ **当前登录**:Z.ai OAuth 尚未接入(`state.nh` 来源未知,
3561
- // 见 `AUTOCLAW_INTL` 的注释)⇒ 本 provider 目前只能手工注入 token 使用。
3562
- // 接入后它会自己有一条 `login.startOAuth` 分支。
3750
+ // ⚠️ **登录**:Z.ai OAuth **已于 2026-11-02 接入**(接入前本渠道只能手工注入 token)。
3751
+ // 实现形态是**本地 flow 页里的授权链接 + `/auth/callback-zai` 回调**
3752
+ // (见 `AUTOCLAW_INTL` 的注释与 `src/autoclaw-oauth.ts`),
3753
+ // ⚠️ **不是** `login.startOAuth` 分支 —— 原先这里预告的形态是错的。
3563
3754
  const autoclawIntl = new AutoclawAuth(ctx, { product: AUTOCLAW_INTL });
3564
3755
  const autoclawIntlAdapter = registerAutoclawLlm(ctx, {
3565
3756
  resolveCredential: createCredentialResolver({ pool, reportAccount: (id) => { if (id !== undefined)
@@ -3712,6 +3903,37 @@ export function apply(ctx) {
3712
3903
  const astudio = new AstudioAuth(ctx);
3713
3904
  // 超级麦吉(Magicrew 国内站,2026-10-29)。MagicrewAuth 构造时自 provide(服务名 magicrewAuth)。
3714
3905
  const magicrewAuth = new MagicrewAuth(ctx);
3906
+ /**
3907
+ * **MagiCrew 国际站**(`magicrewintl`,2026-11-01 用户要求)。
3908
+ *
3909
+ * ⚠️ 服务名由 `MagicrewAuth` 构造里 `super(ctx, `${product.id}Auth`)` **自动派生**
3910
+ * 为 `magicrewintlAuth` ⇒ 这里**不需要**再 `ctx.provide`。
3911
+ * ⚠️ 两站是同一个 Go 服务的两个**数据面**(账号体系物理隔离)⇒ 必须是两个实例:
3912
+ * 共用一个实例会让 `states` 按 ref 串号、`currentCredential()` 互相覆盖。
3913
+ */
3914
+ const magicrewIntlAuth = new MagicrewAuth(ctx, { product: MAGICREW_INTL });
3915
+ /**
3916
+ * 两站共用的**读图桥接**(`ctx.attachments.readImage` → 适配器的
3917
+ * `{data, mediaType}`)。
3918
+ *
3919
+ * ⚠️ 必须**惰性** `ctx.get('attachments')`,不能写 `ctx.attachments` ——
3920
+ * 后者是 cordis 的 inject 服务,在同步代码里直接访问会抛
3921
+ * `cannot get property "…" without inject` 并**打断整个 `apply()`**
3922
+ * (实测:在 `ctx.provide('accountPool', …)` 之后被打断,minimax 的
3923
+ * 巡检定时器读不到它 ⇒ `wiring-lifecycle-guards.spec.ts` 两条红)。
3924
+ * 惰性取时缺服务返回 `undefined` ⇒ 适配器抛 `INVALID_REQUEST`(可见失败,
3925
+ * 不是静默降级:静默降级会让模型「看不到图却以为看到了」,那是幻觉源)。
3926
+ */
3927
+ const magicrewReadImage = async (attachment) => {
3928
+ const attachments = ctx.get('attachments');
3929
+ if (attachments?.readImage === undefined)
3930
+ return undefined;
3931
+ const stored = await attachments.readImage(attachment);
3932
+ if (stored === undefined)
3933
+ return undefined;
3934
+ // 形状转换:宿主给 `{ ref, data }`,适配器要 `{ data, mediaType }`(拼 data URL 用)。
3935
+ return { data: stored.data, mediaType: stored.ref.mediaType };
3936
+ };
3715
3937
  /**
3716
3938
  * 适配器**必须**拿到 `resolveCredential` 与 `fetchRemoteModels`:
3717
3939
  * 缺前者 ⇒ 每条请求抛 `AUTH`「账号未登录」(已登录用户也看到,且 AUTH 吞文案);
@@ -3728,6 +3950,36 @@ export function apply(ctx) {
3728
3950
  *
3729
3951
  * 走 resolver 还白拿**请求级换号**与**限流排除**(其余 23 家同款)。
3730
3952
  */
3953
+ /**
3954
+ * Magicrew 国内站的**余额分档选号器**(2026-11-01 用户要求「加锁定 / 解锁永久积分」)。
3955
+ *
3956
+ * ## 为什么复用 `BuddyBalanceSelector` 而不是新写一个
3957
+ *
3958
+ * 分档判据只读通用的 `packages[].{ active, remaining, deductionEndTime }`,
3959
+ * 而 `fetchMagicrewBalance` 返回的**就是** `CreditBalance` —— 天生满足它要的形状。
3960
+ * 本仓库对这类「同族判定」既有明确裁定:**优先扩 `buddy-balance-rank.ts`,
3961
+ * 不要再开第三份**(见该文件头部)。TRAE / LobsterAI / Qoder / AStudio / MiniMax /
3962
+ * AutoClaw 六家走的就是这条复用路线,magicrew 只是第七家。
3963
+ *
3964
+ * ⚠️ **非 buddy product 时 `fetchBalance` 是编译期必填的**(`FetchBalanceRule`):
3965
+ * 漏传 `tsc` 会报错。这是刻意的 —— 缺省实现会拿 `TraeProduct` 那类没有
3966
+ * `endpoint` 的 `product` 拼出 `undefined/...` 的畸形 URL,症状是
3967
+ * 「余额恒查不到 ⇒ 锁定时永远报无法确认」且**零日志**。
3968
+ * ⚠️ **第三参 `ctx`(出口代理)本家不需要**:magicrew 两站都不按出口 IP 分流,
3969
+ * 故只写两参。若将来接入按账号代理,必须同时补这里与
3970
+ * `BuddySelectionDeps.fetchFor`,否则只有 `fetchBalance` 那条腿有出口。
3971
+ * ⚠️ **`?? null` 是契约差异**:`fetchMagicrewBalance` 用 `undefined` 表达「读不到」,
3972
+ * 而选号器契约是 `null`(两者同义,但 `undefined` 会被当成「没实现」)。
3973
+ */
3974
+ const magicrewBalanceSelector = new BuddyBalanceSelector({
3975
+ product: MAGICREW,
3976
+ resolveCredential: (refName) => magicrewAuth.currentCredential(refName),
3977
+ fetchBalance: async (credential, product) => await fetchMagicrewBalance({
3978
+ jwt: credential.jwt,
3979
+ organizationCode: credential.organizationCode,
3980
+ product,
3981
+ }) ?? null,
3982
+ });
3731
3983
  const magicrewResolver = createCredentialResolver({ pool: pool }, {
3732
3984
  product: MAGICREW,
3733
3985
  // 按 ref 读 ⇒ 池里的 `MAGICREW_ACCOUNT_*` 与手工塞的默认 ref 都能读。
@@ -3741,8 +3993,43 @@ export function apply(ctx) {
3741
3993
  * 的「走了工厂却没接限流判定」那条守卫会直接点名 magicrew。
3742
3994
  */
3743
3995
  throwIfAllRateLimited: throwIfAllAccountsRateLimited,
3996
+ /**
3997
+ * ## `balance` —— 锁定永久积分的**唯一执行路径**(2026-11-01)
3998
+ *
3999
+ * ⚠️⚠️ **没有这一段就是「假开关」**:`provider-registry.ts` 的
4000
+ * `permanentLock: true` 只让面板渲染出按钮、让 `credits.permanentLock`
4001
+ * RPC 接受写入,**没有任何代码去执行那张锁定表** —— 用户点了锁定,
4002
+ * 凭据照旧烧永久积分,且**没有任何用例会红**(officeace 的原始缺陷,
4003
+ * 见 Gitee IKLTHB 与 `permanent-lock-execution.spec.ts` 的文件头)。
4004
+ *
4005
+ * `kind: 'buddy'` 的含义是「沿用 `pickBuddyAccount` 的编排」:
4006
+ * `credential-resolver.ts` 读 `pool.permanentLocked(providerId)` ⇒
4007
+ * 传 `allowPermanent` ⇒ 只剩永久桶时 `select()` 返回不可用 ⇒
4008
+ * 落到本行的 `lockedError` 报错(**绝不**回落 `getAvailableAccount`)。
4009
+ *
4010
+ * ⚠️ **`isFreeModel: NO_FREE_MODEL` 是刻意的保守取舍**:免费模型
4011
+ * (`input_points === 0`)本不该受锁定约束,但本家的免费判定在**适配器**
4012
+ * 内部(远端计费表 `magicrewIsFree(wirePoints)`),没有可注入的
4013
+ * 「modelId → 是否免费」查询点。宁可让免费模型也走一次余额分档
4014
+ * (代价:一次余额请求;锁定 + 只剩永久时会被误拦),也不在这里
4015
+ * 猜一个判据 —— 猜错的代价是免费模型静默绕开锁定、真烧掉永久积分。
4016
+ * 将来适配器若暴露倍率查询,这里应改成真实判据(与 buddy 系同款)。
4017
+ */
4018
+ balance: {
4019
+ kind: 'buddy',
4020
+ selector: magicrewBalanceSelector,
4021
+ lockedError: magicrewLockedError('超级麦吉'),
4022
+ isFreeModel: NO_FREE_MODEL,
4023
+ },
3744
4024
  });
3745
4025
  const magicrewService = new MagicrewService({
4026
+ /**
4027
+ * ⚠️ **必须显式传**(2026-11-01 三审 D5):`src/magicrew.ts` 的构造器有
4028
+ * `?? MAGICREW` 缺省,省略在这里**行为正确但形态不对称** —— 后人照着国内站
4029
+ * 抄去接第三个站点时会**静默打回国内基址**(与 `src/provider-expiry.ts`
4030
+ * 「漏传 product ⇒ 恒 UNUSABLE ⇒ 聚合候选静默消失」是同型风险)。
4031
+ */
4032
+ product: MAGICREW,
3746
4033
  // ⚠️ 必填:`login()` 的实现在 auth 层(`account.create` 只拿得到 `JetHubAuths`)。
3747
4034
  auth: magicrewAuth,
3748
4035
  resolveCredential: magicrewResolver,
@@ -3750,21 +4037,12 @@ export function apply(ctx) {
3750
4037
  * ⚠️ 桥接宿主读图入口。**必须用 `ctx.get()` 惰性取**,不能写 `ctx.attachments` ——
3751
4038
  * 后者是 cordis 的 inject 服务,在同步代码里直接访问会抛
3752
4039
  * `cannot get property "…" without inject` 并**打断整个 `apply()`**
3753
- * (实测:`ctx.provide('accountPool', …)` 在 5977 行,被打断后 minimax 的
4040
+ * (实测:在 `ctx.provide('accountPool', …)` 之后被打断,minimax 的
3754
4041
  * 巡检定时器读不到它 ⇒ `wiring-lifecycle-guards.spec.ts` 两条红)。
3755
4042
  * 惰性取时缺服务返回 `undefined` ⇒ 适配器抛 `INVALID_REQUEST`(可见失败,
3756
4043
  * 不是静默降级)。
3757
4044
  */
3758
- readImage: async (attachment) => {
3759
- const attachments = ctx.get('attachments');
3760
- if (attachments?.readImage === undefined)
3761
- return undefined;
3762
- const stored = await attachments.readImage(attachment);
3763
- if (stored === undefined)
3764
- return undefined;
3765
- // 形状转换:宿主给 `{ ref, data }`,适配器要 `{ data, mediaType }`(拼 data URL 用)。
3766
- return { data: stored.data, mediaType: stored.ref.mediaType };
3767
- },
4045
+ readImage: magicrewReadImage,
3768
4046
  fetchRemoteModels: async () => {
3769
4047
  const credential = await magicrewAuth.currentCredential();
3770
4048
  if (credential === undefined)
@@ -3789,6 +4067,74 @@ export function apply(ctx) {
3789
4067
  const magicrewAdapter = magicrewService.adapter;
3790
4068
  // 与 accio / aggregate 同款幂等注册(`llm-register-compat.ts` 负责记账与剔除包装)。
3791
4069
  registerAdapterIdempotent(ctx.llm, [MAGICREW.id], magicrewAdapter);
4070
+ /**
4071
+ * ## MagiCrew 国际站(`magicrewintl`,2026-11-01 用户要求)
4072
+ *
4073
+ * 与国内版**共用全部实现**,只有 `product` 常量不同 —— 判据与理由见
4074
+ * `src/magicrew-product.ts` 的 `MAGICREW_INTL` 注释(账号体系物理隔离、
4075
+ * host 不同、网关强制 org)。
4076
+ *
4077
+ * 下面这一整块与国内版逐行同构,**故意不抽公共工厂**:两处差异点(product /
4078
+ * auth 实例)都出现 5 次以上,抽工厂会让「哪一处漏改」变得不可见 ——
4079
+ * 而本仓库记录过多次「一份语义两处实现,改一处漏一处」的缺陷
4080
+ *(`minimaxintl` / `autoclawintl` 都选了同样的显式两份 —— 各有一份 resolver 工厂)。
4081
+ */
4082
+ /**
4083
+ * MagiCrew 国际站的余额分档选号器 —— 与国内版**逐行同构**,只有 `product`
4084
+ * 与 auth 实例不同(判据见 `magicrew-product.ts` 的 `MAGICREW_INTL` 注释)。
4085
+ *
4086
+ * ⚠️ **不能两站共用一个 selector 实例**:`BuddyBalanceSelector` 的缓存按
4087
+ * `account.id` 索引、且 `product` 在构造期固定 ⇒ 共用会让国际站账号用国内
4088
+ * 基址查余额(症状:国际站余额恒查不到 ⇒ 锁定时永远报「无法确认」,
4089
+ * 面板却还能刷新 —— 与 `provider-expiry.ts` 那次漏传 `product` 同型)。
4090
+ */
4091
+ const magicrewIntlBalanceSelector = new BuddyBalanceSelector({
4092
+ product: MAGICREW_INTL,
4093
+ resolveCredential: (refName) => magicrewIntlAuth.currentCredential(refName),
4094
+ fetchBalance: async (credential, product) => await fetchMagicrewBalance({
4095
+ jwt: credential.jwt,
4096
+ organizationCode: credential.organizationCode,
4097
+ product,
4098
+ }) ?? null,
4099
+ });
4100
+ const magicrewIntlResolver = createCredentialResolver({ pool: pool }, {
4101
+ product: MAGICREW_INTL,
4102
+ readCredential: (refName) => magicrewIntlAuth.currentCredential(refName),
4103
+ fallback: { kind: 'ref', refName: MAGICREW_INTL.defaultCredentialRef },
4104
+ // ⚠️ 同上:不传会把「全部账号被限流」误报成「未登录」。
4105
+ throwIfAllRateLimited: throwIfAllAccountsRateLimited,
4106
+ /**
4107
+ * ⚠️ **必须与国内版同格**(2026-11-01):两站各自登记 `permanentLock: true`
4108
+ * ⇒ 各自的 `lockedError` 缺一段就是**假开关**(面板有按钮、点了没用)。
4109
+ * `displayName` 必须**逐站区分**:两站账号体系物理隔离,用户要知道去
4110
+ * 哪个面板解锁(`credits.permanentLock` 也是按 provider id 写同一张锁定表)。
4111
+ * `isFreeModel` 取 `NO_FREE_MODEL` 的取舍与后果(免费模型也会走一次余额
4112
+ * 分档、锁定 + 只剩永久时会被误拦)见国内版那段注释 —— 两站同源,这里不重复。
4113
+ */
4114
+ balance: {
4115
+ kind: 'buddy',
4116
+ selector: magicrewIntlBalanceSelector,
4117
+ lockedError: magicrewLockedError('MagiCrew (国际版)'),
4118
+ isFreeModel: NO_FREE_MODEL,
4119
+ },
4120
+ });
4121
+ const magicrewIntlService = new MagicrewService({
4122
+ product: MAGICREW_INTL,
4123
+ auth: magicrewIntlAuth,
4124
+ resolveCredential: magicrewIntlResolver,
4125
+ readImage: magicrewReadImage,
4126
+ fetchRemoteModels: async () => {
4127
+ const credential = await magicrewIntlAuth.currentCredential();
4128
+ if (credential === undefined)
4129
+ return [];
4130
+ return await magicrewIntlAuth.fetchCatalogModels(credential.jwt, credential.organizationCode);
4131
+ },
4132
+ // ⚠️ 必须传(与国内版同因):缺了会让「关掉的模型照样出现在选择器里」,
4133
+ // 且在构造期读 `ctx.accountPool` 会抛错打断整个 `apply()`。
4134
+ accountPool: pool,
4135
+ });
4136
+ const magicrewIntlAdapter = magicrewIntlService.adapter;
4137
+ registerAdapterIdempotent(ctx.llm, [MAGICREW_INTL.id], magicrewIntlAdapter);
3792
4138
  /**
3793
4139
  * 按凭据 ref 解析 AStudio 凭据(供**选号器查余额**与最终取凭据共用)。
3794
4140
  *
@@ -4114,6 +4460,117 @@ export function apply(ctx) {
4114
4460
  // `providerClosed` 两个回调 —— 那会让「同一语义两套判据」重现(本仓库红线),
4115
4461
  // 且会掩盖池没接上的缺陷。
4116
4462
  });
4463
+ // ===== MonkeyCode(`monkeycode` + `monkeycodeintl`)—— **本 fork 独有** =====
4464
+ //
4465
+ // 两个**独立部署**的站点(2026-11-02 实测):国内 `monkeycode-ai.com` 与国际
4466
+ // `monkeycode-ai.net` 各有独立账号池 —— 国内 cookie 打国际站回 401、两站的
4467
+ // 网关路径(`/v1/messages`)逐字节同形但凭据互不通用 ⇒ **必须两个 provider
4468
+ // id**,不能靠凭据里的字段区分(同一张卡片混着两站的号,额度/签到会串)。
4469
+ //
4470
+ // 实现完全共用(`MonkeycodeAuth` / `MonkeycodeAdapter` / `monkeycode-credits`),
4471
+ // 只在 `product` 上分叉:`MONKEYCODE_PRODUCTS` 是站点清单的唯一真相源。
4472
+ //
4473
+ // 与 qiniu **同格**的部分:粘贴静态 Key 建账号、没有 OAuth、没有 refresh 端点。
4474
+ // ⚠️ 与 qiniu 的**实质差异**:协议是 **Anthropic Messages**(`POST /v1/messages`
4475
+ // + SSE),不是 OpenAI 兼容(网关的 `/v1/chat/completions` 实测 404);
4476
+ // 且网关通道每个请求都要 `X-OhMyAgent-Signature`(HMAC-SHA256 over prompt),
4477
+ // 缺它恒 403 —— 签名在适配器里算。
4478
+ //
4479
+ // 服务名由 MonkeycodeAuth 依 product.id 派生 ⇒ 分别注册为
4480
+ // `ctx.monkeycodeAuth` / `ctx.monkeycodeintlAuth`。
4481
+ const createMonkeycode = (product) => {
4482
+ const auth = new MonkeycodeAuth(ctx, { product });
4483
+ const adapter = registerMonkeycodeLlm(ctx, {
4484
+ // 单凭据回退 ref:池里没有该站账号时用它(与其余 provider 同约定)。
4485
+ credentialRef: credentialRef(product.defaultCredentialRef),
4486
+ // 槽序列由**接线层**解析好传进来(适配器不直接读凭据)。
4487
+ // `modelId` 透传:据此过滤「该模型正处于限流窗口」的账号。
4488
+ slots: async (modelId) => {
4489
+ const entries = await pool.listAccounts(product.id);
4490
+ const usable = await Promise.all(entries.map(async (entry) => {
4491
+ if (!entry.enabled)
4492
+ return undefined;
4493
+ // ⚠️ 模型级限流标记:`modelId` 缺省时**不查** —— 传了会让被限流的账号
4494
+ // 把整个目录一起拖空(与 qiniu / modelscope 同款判据)。
4495
+ if (modelId !== undefined && modelId.length > 0) {
4496
+ const resetAt = entry.modelRateLimits?.[modelId];
4497
+ if (typeof resetAt === 'number' && resetAt > Date.now())
4498
+ return undefined;
4499
+ }
4500
+ const resolved = await ctx.credentials.resolve(credentialRef(entry.credentialRef));
4501
+ if (!resolved)
4502
+ return undefined;
4503
+ try {
4504
+ const parsed = JSON.parse(resolved.value);
4505
+ if (typeof parsed.access_token !== 'string' || parsed.access_token.length === 0)
4506
+ return undefined;
4507
+ return { accountId: entry.id, credential: parsed };
4508
+ }
4509
+ catch {
4510
+ // ⚠️ 坏 JSON 不该让整个 provider 不可用:跳过这一槽,其余账号照常轮换。
4511
+ return undefined;
4512
+ }
4513
+ }));
4514
+ return usable.filter((slot) => slot !== undefined);
4515
+ },
4516
+ accountPool: pool,
4517
+ product,
4518
+ // 图片:网关模型在内置清单里都不声明 `supportsImage`(`GET /v1/models`
4519
+ // 实测 405,拿不到能力表)⇒ 适配器会显式抛 `UNSUPPORTED_CONTENT`,
4520
+ // 而不是把图片静默丢掉。
4521
+ readImage: makeReadImage(ctx),
4522
+ });
4523
+ return { auth, adapter };
4524
+ };
4525
+ const { auth: monkeycode, adapter: monkeycodeAdapter } = createMonkeycode(MONKEYCODE);
4526
+ const { auth: monkeycodeIntl, adapter: monkeycodeIntlAdapter } = createMonkeycode(MONKEYCODE_INTL);
4527
+ // ===== 百智云(`baizhi`)—— 静态 Key 直连,**按量计费** =====
4528
+ //
4529
+ // 与 MonkeyCode 的关键差别(都是实测结论,不是设计偏好):
4530
+ // * 认证:`x-api-key: sk-…`(**不用** cookie、**不签** HMAC);
4531
+ // * 额度:没有每日额度、没有积分、没有签到接口 ⇒ 注册表里**不写
4532
+ // `credits`**,积分面板不出现这一家;
4533
+ // * 目录:`GET /api/anthropic/v1/models` 实测可用(45 条),故走
4534
+ // `RemoteCatalogGate` 动态拉取 + 内置 15 条兜底;
4535
+ // * 续期:Key 是静态材料 ⇒ `isBaizhiRefreshable()` 恒 false,不进
4536
+ // `SELF_HEAL_REFRESHABLE_PROVIDERS`。
4537
+ const baizhi = new BaizhiAuth(ctx);
4538
+ const baizhiAdapter = registerBaizhiLlm(ctx, {
4539
+ credentialRef: credentialRef(BAIZHI.defaultCredentialRef),
4540
+ // 槽序列由**接线层**解析好传进来(适配器不直接读凭据)。
4541
+ // `modelId` 透传:据此过滤「该模型正处于限流窗口」的账号。
4542
+ slots: async (modelId) => {
4543
+ const entries = await pool.listAccounts(BAIZHI.id);
4544
+ const usable = await Promise.all(entries.map(async (entry) => {
4545
+ if (!entry.enabled)
4546
+ return undefined;
4547
+ // ⚠️ 模型级限流标记:`modelId` 缺省时**不查** —— 传了会让被限流的账号
4548
+ // 把整个目录一起拖空(与 monkeycode / qiniu 同款判据)。
4549
+ if (modelId !== undefined && modelId.length > 0) {
4550
+ const resetAt = entry.modelRateLimits?.[modelId];
4551
+ if (typeof resetAt === 'number' && resetAt > Date.now())
4552
+ return undefined;
4553
+ }
4554
+ const resolved = await ctx.credentials.resolve(credentialRef(entry.credentialRef));
4555
+ if (!resolved)
4556
+ return undefined;
4557
+ try {
4558
+ const parsed = JSON.parse(resolved.value);
4559
+ if (typeof parsed.access_token !== 'string' || parsed.access_token.length === 0)
4560
+ return undefined;
4561
+ return { id: entry.id, apiKey: parsed.access_token };
4562
+ }
4563
+ catch {
4564
+ // ⚠️ 坏 JSON 不该让整个 provider 不可用:跳过这一槽,其余账号照常轮换。
4565
+ return undefined;
4566
+ }
4567
+ }));
4568
+ return usable.filter((slot) => slot !== undefined);
4569
+ },
4570
+ accountPool: pool,
4571
+ product: BAIZHI,
4572
+ readImage: makeReadImage(ctx),
4573
+ });
4117
4574
  // 一次性修复**老账号**的昵称与凭据字段(与上面 WorkBuddy 的启动清理同类)。
4118
4575
  //
4119
4576
  // 早期实现把服务端的 `name` 直接当昵称用,而实测它是**自动生成的默认名**
@@ -4584,6 +5041,12 @@ export function apply(ctx) {
4584
5041
  const refreshScheduler = new MultiAccountRefreshScheduler({
4585
5042
  refresh: refreshAllCredentials,
4586
5043
  intervalMs: REFRESH_INTERVAL_MS,
5044
+ /**
5045
+ * 首轮延后 15s(issue #20):宿主启动时插件并发初始化,立即对全量账号
5046
+ * 发续期会和启动路径抢网络/凭据存储,日志里常见一串冷启动 `fetch failed`。
5047
+ * 周期定时器仍然立刻武装;只有首轮让路。
5048
+ */
5049
+ initialDelayMs: 15_000,
4587
5050
  isPoolEmpty: async () => (await pool.listAllAccounts()).length === 0,
4588
5051
  // ⚠️ 可选链:`logger` 在极简 profile 下可能缺席,而日志不该成为续期的
4589
5052
  // 单点故障(与仓库既有的 `ctx.logger?.warn?.()` 一致)。
@@ -4649,6 +5112,11 @@ export function apply(ctx) {
4649
5112
  zcodeAdapter.stop();
4650
5113
  // AStudio(讯飞)的 stop() 置 active=false,阻止在途刷新回写凭据。
4651
5114
  astudio.stop();
5115
+ // MonkeyCode 两站 + 百智云:`stop()` 置 `active=false`,阻止在途的
5116
+ // 浏览器登录在卸载之后继续收窗/写回凭据(`loginViaBrowser` 每轮都判它)。
5117
+ monkeycode.stop();
5118
+ monkeycodeIntl.stop();
5119
+ baizhi.stop();
4652
5120
  }, 'jet-hub: multi-account refresh scheduler');
4653
5121
  // 保留旧的 stop scheduler(兼容旧命令)
4654
5122
  ctx.effect(() => () => {
@@ -4666,6 +5134,11 @@ export function apply(ctx) {
4666
5134
  zcodeAdapter.stop();
4667
5135
  // 同上:AStudio 的在途刷新必须随插件一起回收。
4668
5136
  astudio.stop();
5137
+ // MonkeyCode 两站 + 百智云:`stop()` 置 `active=false`,阻止在途的
5138
+ // 浏览器登录在卸载之后继续收窗/写回凭据(`loginViaBrowser` 每轮都判它)。
5139
+ monkeycode.stop();
5140
+ monkeycodeIntl.stop();
5141
+ baizhi.stop();
4669
5142
  }, 'codearts-auth.scheduler (legacy)');
4670
5143
  // ===== OfficeAce(华为 ModelArts MaaS,云端直连)=====
4671
5144
  //
@@ -5298,7 +5771,25 @@ export function apply(ctx) {
5298
5771
  // 目录。表里缺它 ⇒ 退化到已过滤的 `llm.listModels` ⇒「关闭整个 provider」
5299
5772
  // 时漏写黑名单 ⇒「provider 显示已关闭、模型却仍可选用」的矛盾态。
5300
5773
  qiniu: pruned(QINIU.id, qiniuAdapter),
5774
+ // ⚠️ MonkeyCode(2026-11-02):必须进这张表,理由与 modelscope / qiniu 逐条
5775
+ // 相同 —— `provider.status` 的「已关闭」判据是 `total > 0 &&
5776
+ // disabled === total`,读的是 `listAllModels()` 那份**不套黑名单**的全量
5777
+ // 目录。表里缺它 ⇒ 退化到已过滤的 `llm.listModels` ⇒「关闭整个 provider」
5778
+ // 时漏写黑名单 ⇒「provider 显示已关闭、模型却仍可选用」的矛盾态。
5779
+ // ⚠️ 它的目录是「白泽远端 + 网关常量」两段合并(`mergeWithGatewayModels`)
5780
+ // ⇒ 即便白泽目录拉失败也有 9 条网关常量兜底,不会出现 `total === 0`。
5781
+ monkeycode: pruned(MONKEYCODE.id, monkeycodeAdapter),
5782
+ // ⚠️ 国际站同样必须进这张表:理由与国内站逐条相同 —— 「关闭整个 provider」
5783
+ // 依赖 `listAllModels()` 那份**不套黑名单**的全量目录,漏了会漏写黑名单。
5784
+ monkeycodeintl: pruned(MONKEYCODE_INTL.id, monkeycodeIntlAdapter),
5785
+ // ⚠️ 百智云同样必须进这张表:理由与 monkeycode 逐条相同 ——
5786
+ // `provider.status` 的「已关闭」判据读的是 `listAllModels()` 那份
5787
+ // **不套黑名单**的全量目录,表里缺它 ⇒「关闭整个 provider」时漏写
5788
+ // 黑名单 ⇒「provider 显示已关闭、模型却仍可选用」的矛盾态。
5789
+ baizhi: pruned(BAIZHI.id, baizhiAdapter),
5301
5790
  magicrew: pruned(MAGICREW.id, magicrewAdapter),
5791
+ // MagiCrew 国际站(2026-11-01):与国内版同款剪枝,目录/黑名单逻辑共用。
5792
+ magicrewintl: pruned(MAGICREW_INTL.id, magicrewIntlAdapter),
5302
5793
  // OfficeAce(华为 MaaS 云端直连):目录静态 + 平台侧可用性,同其余渠道。
5303
5794
  officeace: pruned(OFFICEACE.id, officeAceAdapter),
5304
5795
  // AStudio(上游 MAAS 云端直连):目录来自 model-manager 远端 + 兜底表,同其余渠道。
@@ -5673,11 +6164,28 @@ export function apply(ctx) {
5673
6164
  // (`provider-runtime.ts` 的注册表是按本数组逐个 `registerProviderRuntime`
5674
6165
  // 建的;主循环本身不需要改)。
5675
6166
  ['qiniu', qiniu],
6167
+ // ⚠️ MonkeyCode(2026-11-02):漏加这一行 = 它不出现在注册表里 ⇒
6168
+ // 续期 / 积分 / 探测三条链路全部**静默失效**(`provider-runtime.ts` 的
6169
+ // 注册表是按本数组逐个 `registerProviderRuntime` 建的,主循环本身
6170
+ // 不需要改)。
6171
+ ['monkeycode', monkeycode],
6172
+ // ⚠️ 国际站必须**单独一行**(2026-11-02):`provider-runtime-wiring.spec.ts`
6173
+ // 与续期/积分/探测三条链路都按 provider id 取实例,漏了它 = 国际站账号
6174
+ // 的过期检测、积分刷新、重测按钮全部静默失效(与 magicrewintl 同型)。
6175
+ ['monkeycodeintl', monkeycodeIntl],
6176
+ // ⚠️ 百智云(2026-11-02):漏加这一行 = 它不出现在注册表里 ⇒
6177
+ // 续期 / 积分 / 探测三条链路全部**静默失效**(`provider-runtime.ts`
6178
+ // 的注册表是按本数组逐个 `registerProviderRuntime` 建的)。
6179
+ ['baizhi', baizhi],
5676
6180
  // ⚠️ 超级麦吉(Magicrew,2026-10-29):值必须是 `registerJetHubRpc` 的
5677
6181
  // `auths.magicrew` 是**同一个对象**,否则守卫用例布在该实例上的 spy
5678
6182
  // 收不到本循环的调用(本仓库复发过 6 次)。
5679
6183
  // 漏加这一行 = 它不进注册表 ⇒ 续期/积分/探测三条链路全部静默失效。
5680
6184
  ['magicrew', magicrewAuth],
6185
+ // ⚠️ 国际站必须**单独一行**(2026-11-01):`provider-runtime-wiring.spec.ts`
6186
+ // 与续期/积分/探测三条链路都按 provider id 取实例,漏了它 = 国际站账号
6187
+ // 的 token 永不过期检测、积分永不刷新、重测按钮点了没反应(全静默)。
6188
+ ['magicrewintl', magicrewIntlAuth],
5681
6189
  ];
5682
6190
  for (const [id, auth] of registry) {
5683
6191
  const descriptor = descriptorOf(id);
@@ -5860,10 +6368,26 @@ export function apply(ctx) {
5860
6368
  // `credits-balance-self-heal.spec.ts` 的反向守卫(JetHubAuths 每个键
5861
6369
  // 必须在自愈表或豁免表里)会红。
5862
6370
  qiniu,
6371
+ // ⚠️ MonkeyCode(2026-11-02):值必须是 `registerProviderRuntime` 那个
6372
+ // registry 数组里 `['monkeycode', monkeycode]` 的**同一个实例**,否则
6373
+ // `provider-runtime-wiring.spec.ts` 布在该实例上的 spy 收不到调用。
6374
+ // 漏加 ⇒ 客户端的 monkeycode 面板所有 RPC 报 `unknown provider`。
6375
+ monkeycode,
6376
+ // ⚠️ 国际站同款陷阱:值必须是 `registerProviderRuntime` 那个 registry 数组里
6377
+ // `['monkeycodeintl', monkeycodeIntl]` 的**同一个实例**,否则
6378
+ // `provider-runtime-wiring.spec.ts` 布在该实例上的 spy 收不到调用。
6379
+ monkeycodeintl: monkeycodeIntl,
6380
+ // ⚠️ 百智云:值必须是上面 registry 数组里 `['baizhi', baizhi]` 的**同一个
6381
+ // 实例**,否则 `provider-runtime-wiring.spec.ts` 布在该实例上的 spy
6382
+ // 收不到调用。漏加 ⇒ 客户端的 baizhi 面板所有 RPC 报 `unknown provider`。
6383
+ baizhi,
5863
6384
  // ⚠️ 超级麦吉(Magicrew,2026-10-29):值必须是 `registerProviderRuntime` 那个
5864
6385
  // registry 数组里 `['magicrew', magicrewAuth]` 的**同一个实例**,否则
5865
6386
  // `provider-runtime-wiring.spec.ts` 布在该实例上的 spy 收不到调用。
5866
6387
  magicrew: magicrewAuth,
6388
+ // ⚠️ MagiCrew 国际站(2026-11-01):必须与上面 `['magicrewintl', magicrewIntlAuth]`
6389
+ // 是**同一个实例**,否则 spec 布在该实例上的 spy 收不到调用。
6390
+ magicrewintl: magicrewIntlAuth,
5867
6391
  }, modelAdapters);
5868
6392
  // WebDAV 自动双向同步常驻于插件主进程:不依赖设置页是否打开;本地约 1 秒
5869
6393
  // 检测、云端 5 秒轮询,任何失败只在同步状态与日志中呈现,不阻塞插件启动。