@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
@@ -0,0 +1,673 @@
1
+ /**
2
+ * MonkeyCode 的**平台侧读数**:积分余额 / 每日额度 / 订阅档位 / 每日签到。
3
+ *
4
+ * ## 为什么这些读数走「平台 API + 网页会话」,而不是走推理用的 API Key
5
+ *
6
+ * MonkeyCode 有**两套完全不同的凭据**:
7
+ *
8
+ * | 用途 | 凭据 | 认证方式 |
9
+ * |---|---|---|
10
+ * | 推理(Anthropic Messages) | 白泽 `sk-…` / 网关 `oma_…` + `signing_secret` | `x-api-key` / HMAC 签名头 |
11
+ * | 余额 / 额度 / 签到 | 网页登录态 `monkeycode_ai_session==…` | **Cookie** |
12
+ *
13
+ * 平台的 `/api/v1/users/*` 系列**不接受 API Key**(实测带 `x-api-key` / `Authorization`
14
+ * 一律 401),只认网页 Cookie。这与 modelscope / codely 那种「同一个 Key 既能推理
15
+ * 又能读余额」的形态不同,故 `MonkeycodeCredential` 里额外有 `session_cookie`。
16
+ *
17
+ * ⚠️ 因此本模块的每个入口都**必须先判 `session_cookie` 是否配置**:
18
+ * 「没配会话」和「会话失效」是两件事,用户动作也不同(去补会话 vs 去重新登录)。
19
+ * 把前者报成后者会让人以为自己的 Cookie 坏了。**绝不抛错**,一律降级成
20
+ * 一句能行动的说明(`fetchBalanceDetailed` 的 `error` / `ClaimOutcome` 的 `failed`)。
21
+ *
22
+ * ⚠️ 「补会话」的主路径是「浏览器登录」,不是手工粘贴:该 cookie 是 **HttpOnly**,
23
+ * `document.cookie` 读不到(四审自查修正了本段原写的「去粘贴」)。
24
+ *
25
+ * ## 计费口径(为什么余额要除以 1000)
26
+ *
27
+ * 平台下发的 `balance` 单位是**千分之一积分**(网页前端也是 `/1000` 显示),
28
+ * 直接用会显示成「12500 积分」而实际是 12.5 —— 差三个数量级。换算只在本模块
29
+ * 做一次,`CreditBalance.total` 一律是**积分**(`unit: 'credit'`)。
30
+ *
31
+ * `daily_token_balance` / `daily_token_limit` 是**计费 token**(`unit: 'token'`),
32
+ * 与积分**不可互相折算** —— 计费 token 的折算规则见 `SPEC-monkeycode-provider.md`:
33
+ * `(input + cache_read + 10 × output) × 1.5`,额度耗尽后按 `1 积分 = 5000 计费 token`
34
+ * 转扣积分。⚠️ 但那是**上游的扣费规则**,本模块**不参与换算**,只如实回传两个读数
35
+ * ——前端按单位分组并列显示(`credits-format.js` 的 `normalizeUnit`),
36
+ * 跨量纲求和会让「12.5 积分 / 800 万 token」变成一个没有意义的数字。
37
+ *
38
+ * ## 每日签到:为什么要在本地解 PoW
39
+ *
40
+ * 签到接口要先过一道**人机验证**(captcha),但它不是图形码,而是
41
+ * 「挑战 → 本地求解 → 兑换」的 proof-of-work:
42
+ *
43
+ * POST /api/v1/public/captcha/challenge → { token, challenge: { c, s, d } }
44
+ * (本地求解 c 道题,约 0.1s)
45
+ * POST /api/v1/public/captcha/redeem → { token: '<8hex>:<15hex>', success }
46
+ * POST /api/v1/users/wallet/checkin { captcha_token: <上一步的 token> }
47
+ *
48
+ * 求解算法见 {@link solveChallenge}(与平台前端逐字节同构,`fnv1a32` 派生 PRNG +
49
+ * SHA-256 前缀碰撞)。⚠️ 这里是**纯计算**,没有任何规避行为:题目就是让你算的,
50
+ * 网页版也是浏览器里算。
51
+ *
52
+ * @module src/monkeycode-credits.ts
53
+ */
54
+ import { prng, readCapChallenge, readCapToken, solveChallenge, solveChallengeYielding, } from './cap-pow.js';
55
+ import { MONKEYCODE, MONKEYCODE_PLAN_DAILY_LIMIT, } from './monkeycode-product.js';
56
+ import { MONKEYCODE_SESSION_COOKIE_NAME } from './monkeycode-browser-login.js';
57
+ import { normalizeSessionCookie } from './session-cookie.js';
58
+ // 求解器仍从本模块公开导出(既有单测与调用方按这个路径 import)。
59
+ export { prng, solveChallenge, solveChallengeYielding };
60
+ /** 档位短标签(面板只放得下一个词,`extra.accountTier.label` 用它)。 */
61
+ const PLAN_LABELS = Object.freeze({
62
+ basic: 'Basic',
63
+ pro: 'Pro',
64
+ ultra: 'Ultra',
65
+ });
66
+ /**
67
+ * 把凭据里的 `session_cookie` 归一成可以直接放进 `Cookie` 头的字符串。
68
+ *
69
+ * ⚠️ 用户可能粘贴整串 `a=1; b=2`,也可能只粘贴值的片段。两种情况都要能用:
70
+ * - 已含 `=` ⇒ 视为完整 cookie 串,原样(去掉首尾空白)使用;
71
+ * - 不含合法 cookie 名 ⇒ 视为裸值,补上平台会话 cookie 名前缀。
72
+ *
73
+ * 若用户从 DevTools 里连 `cookie:` 一并复制过来,先剥掉这个前缀 ——
74
+ * 否则发出去的会是 `Cookie: cookie: xxx`,服务端只会当未登录。
75
+ *
76
+ * ⚠️ **2026-11-02 四审 G-3**:实现已抽到 `src/session-cookie.ts`
77
+ * (与百智云共用一份),这里只留**参数**(cookie 名列表 + 兜底名)。
78
+ * 此前本文件里还留着一份**逐字重复**的本地副本,且
79
+ * `import { normalizeSessionCookie }` 进来后**零使用**(死 import)
80
+ * —— 「已消除两家漂移」当时只落了一半。
81
+ */
82
+ function normalizeCookie(raw) {
83
+ return normalizeSessionCookie(raw, [MONKEYCODE_SESSION_COOKIE_NAME], MONKEYCODE_SESSION_COOKIE_NAME);
84
+ }
85
+ /** 从凭据里取归一化后的 cookie;没有则 `undefined`(调用方据此给「未配置会话」)。 */
86
+ function cookieOf(credential) {
87
+ if (credential === undefined || credential === null)
88
+ return undefined;
89
+ const raw = credential.session_cookie;
90
+ if (typeof raw !== 'string')
91
+ return undefined;
92
+ return normalizeCookie(raw);
93
+ }
94
+ /**
95
+ * 平台 REST 请求头。
96
+ *
97
+ * ⚠️ 带 `referer` / `user-agent` 只是「尽量与网页同形」的保守选择 ——
98
+ * 平台是普通 SPA + REST,没有证据表明它强制校验这两项;但缺失时被边缘 WAF
99
+ * 拦掉的概率更高,而签到是**写操作**,失败一次就少一天的量。
100
+ * 若将来实测发现不需要,**删掉即可**(没有逻辑依赖它们)。
101
+ */
102
+ function platformHeaders(cookie, product) {
103
+ return {
104
+ cookie,
105
+ accept: 'application/json',
106
+ referer: `${product.platformBaseUrl}/`,
107
+ 'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 '
108
+ + '(KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36',
109
+ };
110
+ }
111
+ /**
112
+ * 把 HTTP 失败翻译成**能行动**的中文原因。
113
+ *
114
+ * ⚠️ 401/403 是**唯一**需要单独成句的状态:它意味着 Cookie 过期,
115
+ * 用户必须去浏览器重新登录后更新凭据;其余状态多半是瞬时的或上游改版,
116
+ * 重贴一次 Cookie 没有用。
117
+ */
118
+ function describeFailure(status, text) {
119
+ const excerpt = text.replace(/\s+/g, ' ').trim().slice(0, 200);
120
+ const suffix = excerpt.length === 0 ? '' : `:${excerpt}`;
121
+ if (status === 401 || status === 403) {
122
+ return `网页登录态未生效(HTTP ${status})—— 平台接口只认已登录的会话,`
123
+ + '请确认浏览器窗口里已经完成登录';
124
+ }
125
+ return `平台接口返回 HTTP ${status}${suffix}`;
126
+ }
127
+ /**
128
+ * 该失败是「会话还没生效」(401/403),而不是真的出错。
129
+ *
130
+ * ⚠️⚠️ 这个区分是**必需**的(2026-11-02 真机踩到):网页登录窗口一打开,
131
+ * `monkeycode_ai_session` **立刻**就存在(服务端下发的匿名会话),所以
132
+ * 「读到了 cookie」绝不等于「用户已经登进去」。拿它去换 Key 必然 401;
133
+ * 此时必须**继续等**用户真正登录,而不是当场判「会话已失效」。
134
+ */
135
+ export function isMonkeycodeSessionExpiredError(message) {
136
+ return /HTTP 40[13]/.test(message) || message.includes('网页登录态未生效');
137
+ }
138
+ /** 发一个平台请求并把响应体读成 JSON(非 JSON 也带原文片段,便于诊断)。 */
139
+ async function platformRequest(cookie, url, init, product, deps) {
140
+ const fetcher = deps.fetchImpl ?? fetch;
141
+ const headers = platformHeaders(cookie, product);
142
+ if (init.body !== undefined)
143
+ headers['content-type'] = 'application/json';
144
+ let response;
145
+ try {
146
+ response = await fetcher(url, {
147
+ method: init.method,
148
+ headers,
149
+ ...init.body === undefined ? {} : { body: JSON.stringify(init.body) },
150
+ signal: AbortSignal.timeout(product.catalogTimeoutMs),
151
+ });
152
+ }
153
+ catch (error) {
154
+ // 网络层失败(断网 / DNS / 证书)与业务失败要分开说 —— 前者重试可能有用,
155
+ // 后者重试无用。这里只翻译成一句,调用方统一降级。
156
+ const reason = error instanceof Error ? error.message : String(error);
157
+ return { ok: false, status: 0, error: `平台接口请求失败:${reason}` };
158
+ }
159
+ const text = await response.text().catch(() => '');
160
+ if (!response.ok) {
161
+ return { ok: false, status: response.status, error: describeFailure(response.status, text) };
162
+ }
163
+ if (text.trim().length === 0) {
164
+ // 成功状态但空体:某些写接口确实回 204,交给调用方判断(这里不判失败)。
165
+ return { ok: true, data: undefined };
166
+ }
167
+ try {
168
+ return { ok: true, data: JSON.parse(text) };
169
+ }
170
+ catch {
171
+ // ⚠️ 「200 + HTML」是本仓记录过的「假 200」形态(SPA catch-all 路由):
172
+ // 若把原文当成功传下去,上层会以为是报文变形,排查方向直接跑偏。
173
+ return {
174
+ ok: false,
175
+ status: response.status,
176
+ error: `平台接口返回了非 JSON 响应(HTTP 200,可能是会话失效被重定向到登录页):`
177
+ + `${text.replace(/\s+/g, ' ').trim().slice(0, 120)}`,
178
+ };
179
+ }
180
+ }
181
+ /**
182
+ * 用网页会话 cookie 换一对网关凭据(浏览器登录的**最后一跳**)。
183
+ *
184
+ * 上游是 `POST /api/v1/users/ohmyagent/api-keys`(body `{}`,Cookie 认证):
185
+ * 成功回 `{ id, api_key, signing_secret, created_at }`,GET 同路径是 404。
186
+ *
187
+ * ⚠️⚠️ **返回里的 `id` 是「这把 API Key 的记录 id」,不是平台用户 id**
188
+ * (2026-11-03 真机取证:同一账号连续兑换两次得到 `2b37a3dd-…` 与 `0848857d-…`
189
+ * 两个不同 id,而 `GET /api/v1/users/status` 的 `data.user.id` 恒为
190
+ * `01a19fa3-…`)。把它当账号身份写入 `user_id` 会让「同一账号第二次浏览器登录
191
+ * 必然被判成新账号」(每登一次多一张卡 + 多签发一把 Key)。
192
+ * ⇒ 本函数只回 `keyId`(诊断用);稳定的 `user_id` 必须走
193
+ * {@link fetchMonkeycodeProfile}。
194
+ *
195
+ * ⚠️ **不抛错**:这与本模块其余入口同口径 —— 兑换失败只是「这次登录没拿到
196
+ * 网关凭据」,调用方可以退回到「只有会话、没有 key」的状态(额度与签到照样能用),
197
+ * 不该让整个账号创建失败。
198
+ *
199
+ * ⚠️ 兑换**每次都签发新的一对**(上游没有幂等键),所以只在登录流程里调一次,
200
+ * 不要在续期/刷新里反复调 —— 那会在用户账号下堆一长串 key。
201
+ */
202
+ export async function exchangeMonkeycodeSessionForKey(sessionCookie, deps = {}, product = MONKEYCODE) {
203
+ const cookie = normalizeCookie(sessionCookie);
204
+ if (cookie === undefined)
205
+ return { ok: false, error: '未提供网页会话 cookie' };
206
+ const response = await platformRequest(cookie, `${product.platformBaseUrl}${product.apiKeysPath}`, { method: 'POST', body: {} }, product, deps);
207
+ if (!response.ok)
208
+ return { ok: false, error: response.error };
209
+ const unwrapped = unwrapEnvelope(response.data);
210
+ if (!unwrapped.ok)
211
+ return { ok: false, error: unwrapped.error };
212
+ const value = unwrapped.value;
213
+ const readText = (input) => (typeof input === 'string' ? input.trim() : '');
214
+ const apiKey = readText(value.api_key);
215
+ const signingSecret = readText(value.signing_secret);
216
+ if (apiKey.length === 0 || signingSecret.length === 0) {
217
+ return { ok: false, error: '平台未返回 api_key / signing_secret(上游形态可能已变)' };
218
+ }
219
+ const keyId = readText(value.id);
220
+ const createdAt = readNumber(value.created_at);
221
+ return {
222
+ ok: true,
223
+ key: {
224
+ apiKey,
225
+ signingSecret,
226
+ ...keyId.length === 0 ? {} : { keyId },
227
+ ...createdAt === undefined ? {} : { createdAt },
228
+ },
229
+ };
230
+ }
231
+ /**
232
+ * 读平台用户资料:`GET /api/v1/users/status` → `data.user.{id,nickname}`。
233
+ *
234
+ * ⚠️ 这是**稳定账号身份**的唯一来源(浏览器登录判重、邀请链接都靠它):
235
+ * 兑换接口回的 `id` 是「每签发一把 Key 就变」的记录 id(见
236
+ * {@link exchangeMonkeycodeSessionForKey} 的实测)。
237
+ *
238
+ * ⚠️ 失败**不抛错**:调用方拿到 `undefined` 时按「身份未知」处理(不做判重),
239
+ * 不能让一次辅助读数把已经成功的登录判死。
240
+ */
241
+ export async function fetchMonkeycodeProfile(sessionCookie, product = MONKEYCODE, deps = {}) {
242
+ const cookie = normalizeCookie(sessionCookie);
243
+ if (cookie === undefined)
244
+ return undefined;
245
+ const result = await platformRequest(cookie, `${product.platformBaseUrl}${product.profilePath}`, { method: 'GET' }, product, deps);
246
+ if (!result.ok) {
247
+ deps.warn?.(`[monkeycode] 用户资料读取失败:${result.error}`);
248
+ return undefined;
249
+ }
250
+ const unwrapped = unwrapEnvelope(result.data);
251
+ if (!unwrapped.ok) {
252
+ deps.warn?.(`[monkeycode] 用户资料读取失败:${unwrapped.error}`);
253
+ return undefined;
254
+ }
255
+ const user = unwrapped.value.user;
256
+ if (user === null || typeof user !== 'object')
257
+ return {};
258
+ const record = user;
259
+ const userId = typeof record.id === 'string' && record.id.trim().length > 0 ? record.id.trim() : undefined;
260
+ const nickname = typeof record.nickname === 'string' && record.nickname.trim().length > 0
261
+ ? record.nickname.trim()
262
+ : undefined;
263
+ return {
264
+ ...userId === undefined ? {} : { userId },
265
+ ...nickname === undefined ? {} : { nickname },
266
+ };
267
+ }
268
+ /**
269
+ * 生成**邀请链接**(上游口径:`https://<平台主机>/?ic=<平台用户 id>`)。
270
+ *
271
+ * 2026-11-03 从官网 bundle 逐字取证:`const g = \`https://monkeycode-ai.com/?ic=${user.id}\``
272
+ * —— 参数名是 `ic`,值是**平台用户 id**(不是邀请码、不是 Key id),
273
+ * 邀请记录接口是 `GET /api/v1/users/invitations?page=1&size=20`。
274
+ *
275
+ * ⚠️ 用户 id 缺失时返回 `undefined`,**绝不**拼一个空 `?ic=` 的链接
276
+ * (那会让用户把无效链接发给朋友,且看起来「生成成功」)。
277
+ */
278
+ export function monkeycodeInviteLink(userId, product = MONKEYCODE) {
279
+ if (typeof userId !== 'string' || userId.trim().length === 0)
280
+ return undefined;
281
+ try {
282
+ return `${new URL(product.platformBaseUrl).origin}/?ic=${encodeURIComponent(userId.trim())}`;
283
+ }
284
+ catch {
285
+ return undefined;
286
+ }
287
+ }
288
+ /** 把 number | string 收敛成有限数字;其余一律 `undefined`(表示「读不到」)。 */
289
+ function readNumber(value) {
290
+ if (typeof value === 'number')
291
+ return Number.isFinite(value) ? value : undefined;
292
+ if (typeof value === 'string' && value.trim().length > 0) {
293
+ const parsed = Number(value);
294
+ return Number.isFinite(parsed) ? parsed : undefined;
295
+ }
296
+ return undefined;
297
+ }
298
+ /** 从 `{ code, data, message }` 信封里取 `data`;`code !== 0` 视为业务失败。 */
299
+ function unwrapEnvelope(data) {
300
+ if (data === null || typeof data !== 'object') {
301
+ return { ok: false, error: '平台接口返回的报文不是对象(上游形态可能已变)' };
302
+ }
303
+ const envelope = data;
304
+ // ⚠️ 只有**明确**给出 `code` 且不为 0 才判业务失败:有的端点直接回裸对象
305
+ //(没有 `code` 字段),把「缺 code」也判失败会让它们全部读不到。
306
+ if (typeof envelope.code === 'number' && envelope.code !== 0) {
307
+ const message = typeof envelope.message === 'string' && envelope.message.trim().length > 0
308
+ ? envelope.message.trim()
309
+ : `业务码 ${envelope.code}`;
310
+ return { ok: false, error: `平台接口拒绝:${message}` };
311
+ }
312
+ const value = envelope.data !== undefined ? envelope.data : data;
313
+ if (value === null || typeof value !== 'object') {
314
+ return { ok: false, error: '平台接口返回的 data 不是对象(上游形态可能已变)' };
315
+ }
316
+ return { ok: true, value: value };
317
+ }
318
+ /**
319
+ * 读钱包:`GET /api/v1/users/wallet`。
320
+ *
321
+ * ⚠️ `balance` 缺失必须判**失败**,不得回落成 0 —— 本仓红线「绝不编造数字」,
322
+ * 而 0 的语义是「已用光」,会让用户白白去充值。
323
+ */
324
+ export async function fetchMonkeycodeWallet(credential, product = MONKEYCODE, deps = {}) {
325
+ const cookie = cookieOf(credential);
326
+ if (cookie === undefined) {
327
+ return {
328
+ ok: false,
329
+ // ⚠️ 2026-11-02 三审 F🟡-4:这个 cookie 是 **HttpOnly**(`document.cookie` 读不到),
330
+ // 原文案叫用户「登录后把 cookie 粘贴到该账号」是**死路**。主路径是浏览器登录;
331
+ // 已建的账号可用账号卡片上的「改 Key」补填(弹窗有 session cookie 栏)。
332
+ error: '未配置会话(session_cookie)—— 余额 / 额度 / 签到接口只认网页登录态,'
333
+ + '请用「浏览器登录」添加账号;已建的账号可点卡片上的「改 Key」补填 session cookie'
334
+ + '(只填 API Key 的账号能发消息但查不到余额)',
335
+ };
336
+ }
337
+ const result = await platformRequest(cookie, `${product.platformBaseUrl}${product.walletPath}`, { method: 'GET' }, product, deps);
338
+ if (!result.ok)
339
+ return { ok: false, error: result.error };
340
+ const unwrapped = unwrapEnvelope(result.data);
341
+ if (!unwrapped.ok)
342
+ return { ok: false, error: unwrapped.error };
343
+ const raw = unwrapped.value;
344
+ // ⚠️ 单位换算:平台下发的是**千分之一积分**(网页前端 /1000 显示)。
345
+ // 先 `Math.round` 再除以 1000,避免 `12.345000000000001` 这类浮点尾巴。
346
+ const milli = readNumber(raw.balance);
347
+ if (milli === undefined) {
348
+ return { ok: false, error: '钱包报文里没有 balance 字段(上游形态可能已变)' };
349
+ }
350
+ const dailyTokenBalance = readNumber(raw.daily_token_balance);
351
+ const dailyTokenLimit = readNumber(raw.daily_token_limit);
352
+ return {
353
+ ok: true,
354
+ wallet: {
355
+ balance: Math.round(milli) / 1000,
356
+ ...dailyTokenBalance === undefined ? {} : { dailyTokenBalance },
357
+ ...dailyTokenLimit === undefined ? {} : { dailyTokenLimit },
358
+ },
359
+ };
360
+ }
361
+ /**
362
+ * 读订阅档位:`GET /api/v1/users/subscription`。
363
+ *
364
+ * ⚠️ 这是**辅助**读数:读不到只影响档位标签(`Basic` / `Pro` / `Ultra`),
365
+ * 不影响余额展示 ⇒ 失败一律 `undefined` + 一条 `warn`,绝不把整行变成错误。
366
+ */
367
+ export async function fetchMonkeycodePlan(credential, product = MONKEYCODE, deps = {}) {
368
+ const cookie = cookieOf(credential);
369
+ if (cookie === undefined)
370
+ return undefined;
371
+ const result = await platformRequest(cookie, `${product.platformBaseUrl}${product.subscriptionPath}`, { method: 'GET' }, product, deps);
372
+ if (!result.ok) {
373
+ deps.warn?.(`[monkeycode] 订阅档位读取失败:${result.error}`);
374
+ return undefined;
375
+ }
376
+ const unwrapped = unwrapEnvelope(result.data);
377
+ if (!unwrapped.ok) {
378
+ deps.warn?.(`[monkeycode] 订阅档位读取失败:${unwrapped.error}`);
379
+ return undefined;
380
+ }
381
+ const raw = unwrapped.value;
382
+ const plan = typeof raw.plan === 'string' ? raw.plan.trim().toLowerCase() : '';
383
+ if (plan === 'basic' || plan === 'pro' || plan === 'ultra')
384
+ return plan;
385
+ deps.warn?.(`[monkeycode] 订阅档位是未知值 "${String(raw.plan)}"(只认 basic/pro/ultra)`);
386
+ return undefined;
387
+ }
388
+ /**
389
+ * 把两个读数拼成 `CreditBalance`。
390
+ *
391
+ * ## 为什么分两个包(而不是加成一个 total)
392
+ *
393
+ * 积分(`credit`)与每日额度(`token`)**不可互相折算**,加起来的数字没有语义。
394
+ * 前端的 `normalizeUnit` 会按单位**分组并列**显示(与 ZCode 的 token 同型),
395
+ * 故这里如实给两个包;`total` 只汇总**积分**口径 —— 主行显示的就是用户真正
396
+ * 关心的「我还有多少积分」。
397
+ *
398
+ * ⚠️ 两个包的 `expiredTime` / `cycleEndTime` 必须写**空串**:
399
+ * 平台 wallet 报文只有标量余额,**没有任何到期时间或重置时刻字段**
400
+ *(每日额度是隐式的「次日 0 点重置」,但上游不下发时刻,编一个就是编造)。
401
+ *
402
+ * ⚠️ 2026-11-03 合并审计更正:这里原写「这也是 monkeycode **不进**
403
+ * `WIRED_EXPIRY_PROVIDERS` 的唯一理由」——**事实错误**。三家实际都**已接进**
404
+ * 聚合折算(`aggregate-expiry.ts` 的 `WIRED_EXPIRY_PROVIDERS` 含 `monkeycode`
405
+ * / `monkeycodeintl` / `baizhi`,折算原语是 `monkeycodeExpiry` / `baizhiExpiry`)。
406
+ * 空的到期字段只影响**面板展示**;折算层用的是「有 `active && remaining > 0`
407
+ * 的包 ⇒ `NEVER`,全空才 `UNUSABLE`」(`sharedPackageExpiry`),两者并不冲突。
408
+ */
409
+ export function buildMonkeycodeBalance(wallet, plan) {
410
+ const packages = [
411
+ {
412
+ name: '积分余额',
413
+ unit: 'credit',
414
+ remaining: wallet.balance,
415
+ // 上游只给「当前余额」这一个数,不给「总额 / 已用」⇒ 如实让 total 等于
416
+ // remaining、used 为 0。编一个「总额」会让面板显示「12.5 / 100」这种
417
+ // 用户根本无法核对的数字。
418
+ total: wallet.balance,
419
+ used: 0,
420
+ // 余额为 0 不等于「包失效」—— `active` 是「这部分额度还算不算数」,
421
+ // 余额用光时它仍然是用户的账户额度(下一天/充值后继续可用)。
422
+ active: true,
423
+ cycleStartTime: '',
424
+ cycleEndTime: '',
425
+ expiredTime: '',
426
+ },
427
+ ];
428
+ const limit = wallet.dailyTokenLimit;
429
+ const remaining = wallet.dailyTokenBalance;
430
+ // ⚠️ 只有**上限与剩余都有**才给额度包:缺剩余时把 0 当剩余会让用户以为
431
+ // 今天已经用光了(实际可能只是上游没下发)。
432
+ if (limit !== undefined && remaining !== undefined) {
433
+ packages.push({
434
+ // ⚠️ 包名**不带档位**:档位已由 `planTierExtra()` 渲染成卡片上的
435
+ // 「账号规格」一行,这里再带一遍只会把窄标签列(`dt`)撑爆 ——
436
+ // 而且用户在卡片上找的是「每日额度还剩多少」,不是档位名。
437
+ // `plan` 形参保留,是为了让调用方签名稳定、也给未来「按档位显示不同
438
+ // 上限单位」留位;当前它只影响 `planTierExtra`。
439
+ name: '每日额度',
440
+ unit: 'token',
441
+ remaining,
442
+ total: limit,
443
+ used: Math.max(0, limit - remaining),
444
+ active: true,
445
+ cycleStartTime: '',
446
+ cycleEndTime: '',
447
+ expiredTime: '',
448
+ });
449
+ }
450
+ return {
451
+ // 主行口径 = 积分(token 额度不参与求和,见函数注释)。
452
+ total: wallet.balance,
453
+ packages,
454
+ expiredTotal: 0,
455
+ };
456
+ }
457
+ /** 把档位拼成 `extra.accountTier`(hover 里给出该档的每日额度上限)。 */
458
+ function planTierExtra(plan, wallet) {
459
+ if (plan === undefined)
460
+ return undefined;
461
+ const limit = wallet.dailyTokenLimit ?? MONKEYCODE_PLAN_DAILY_LIMIT[plan];
462
+ return {
463
+ accountTier: {
464
+ label: PLAN_LABELS[plan],
465
+ title: `MonkeyCode ${PLAN_LABELS[plan]}(每日额度上限 ${limit.toLocaleString('en-US')} 计费 token)`,
466
+ },
467
+ };
468
+ }
469
+ /**
470
+ * `ProviderCredits.fetchBalanceDetailed` 的实现。
471
+ *
472
+ * ⚠️ **必须走 Detailed 而不是 `fetchBalance`**:`fetchBalance` 的 `null` 会被共享
473
+ * 骨架统一补一句写死的「余额查询失败」,于是「未配置会话」与「会话过期」这两种
474
+ * **用户动作完全不同**的原因都到不了 UI —— 用户只会看到一句没用的话。
475
+ */
476
+ export async function fetchMonkeycodeBalanceDetailed(credential, product = MONKEYCODE, deps = {}) {
477
+ const wallet = await fetchMonkeycodeWallet(credential, product, deps);
478
+ if (!wallet.ok)
479
+ return { balance: null, error: wallet.error };
480
+ const plan = await fetchMonkeycodePlan(credential, product, deps);
481
+ const extra = planTierExtra(plan, wallet.wallet);
482
+ return {
483
+ balance: buildMonkeycodeBalance(wallet.wallet, plan),
484
+ ...extra === undefined ? {} : { extra },
485
+ };
486
+ }
487
+ // Cap 的 PoW 求解与题面解析统一在 `src/cap-pow.ts`(与百智云共用一份实现)。
488
+ /**
489
+ * 读签到状态:`GET /api/v1/users/wallet/checkin` → `{ checked_in: boolean }`。
490
+ *
491
+ * ⚠️ 上游只给**一个布尔**,没有连续天数、没有奖励金额、没有活动期。
492
+ * 契约要求那些字段存在,故一律如实填 0 / 空串并**在注释里说明**,
493
+ * 绝不为了「看起来完整」编造数值。`active` 恒 `true`:拿到响应就意味着签到可用。
494
+ */
495
+ export async function fetchMonkeycodeCheckinStatus(credential, product = MONKEYCODE, deps = {}) {
496
+ const cookie = cookieOf(credential);
497
+ if (cookie === undefined)
498
+ return null;
499
+ const result = await platformRequest(cookie, `${product.platformBaseUrl}${product.checkinPath}`, { method: 'GET' }, product, deps);
500
+ if (!result.ok) {
501
+ deps.warn?.(`[monkeycode] 签到状态读取失败:${result.error}`);
502
+ return null;
503
+ }
504
+ const unwrapped = unwrapEnvelope(result.data);
505
+ if (!unwrapped.ok) {
506
+ deps.warn?.(`[monkeycode] 签到状态读取失败:${unwrapped.error}`);
507
+ return null;
508
+ }
509
+ const checkedIn = unwrapped.value.checked_in === true;
510
+ return {
511
+ active: true,
512
+ todayCheckedIn: checkedIn,
513
+ // 以下字段上游**不下发**,如实为 0 / 空串(见函数注释)。
514
+ streakDays: 0,
515
+ dailyCredit: 0,
516
+ todayCredit: 0,
517
+ isStreakDay: false,
518
+ totalCredits: 0,
519
+ checkinDates: [],
520
+ activityName: 'MonkeyCode 每日签到',
521
+ themeName: 'MonkeyCode',
522
+ endTime: '',
523
+ };
524
+ }
525
+ /** 从签到响应里 best-effort 取「本次到账积分」;读不到返回 `undefined`。 */
526
+ function readRewardedCredit(data) {
527
+ if (data === null || typeof data !== 'object')
528
+ return undefined;
529
+ const record = data;
530
+ // ⚠️ 只认**明确的奖励字段名**:`balance` 之类是「余额」不是「本次到账」,
531
+ // 拿它当奖励会显示成「签到 +100积分」而实际是账户总额(本仓库红线)。
532
+ for (const key of ['credit', 'credits', 'reward', 'reward_credit', 'amount', 'points']) {
533
+ const value = readNumber(record[key]);
534
+ if (value !== undefined && value > 0)
535
+ return value;
536
+ }
537
+ return undefined;
538
+ }
539
+ /**
540
+ * 一键签到:`challenge → 本地求解 → redeem → checkin`。
541
+ *
542
+ * ## 幂等与预检
543
+ *
544
+ * 先 `GET /wallet/checkin` 判 `checked_in`:已签则直接回 `already-claimed`
545
+ * **不发任何写请求**。这一步既是幂等判据,也省掉一次 PoW 计算
546
+ *(50 道题约 0.2s,纯 CPU,但没必要白发)。
547
+ * ⇒ `provider-credits.ts` 里因此可以声明 `precheckStatus: false`:
548
+ * 预检已在本函数内部完成,外部再查一次就是**同一端点打两遍**。
549
+ *
550
+ * ## 奖励金额:优先读响应,其次用「签到前后余额差」
551
+ *
552
+ * ⚠️⚠️ 2026-11-03 真机实测(账号 `01a19fa3…`,国内站):上游签到接口只回
553
+ * `{ code: 0, data: { checked_in: true } }`,**不含奖励金额**;而网页文案写死
554
+ * 「已领取 100 积分」——那 100 是前端常量,不是接口字段。
555
+ *
556
+ * 原实现写死 `credit: 0` + `delayedMessage`,后果是签到成功的那次批量领取在
557
+ * 汇总行里显示成「MonkeyCode 无账号」(`formatClaimGains` 全零返回 null),
558
+ * 用户会以为**根本没签到**。现改为:
559
+ * 1. 响应里真有 `credit/reward/amount` ⇒ 直接用;
560
+ * 2. 否则读一次签到后钱包,与签到前余额求差 ⇒ 用**实测增量**(真机为 +100);
561
+ * 3. 两次读余额有一次失败 ⇒ 才回落 `0 + delayedMessage`(并已修客户端
562
+ * 不再把 0 渲染成「+0积分」/「无账号」)。
563
+ *
564
+ * ⚠️ 差值口径的边界:签到与读余额之间若有**并发的模型调用**,差值会被扣费
565
+ * 抵消。这只影响展示数字、不影响签到本身;拿不到正数时按第 3 条降级,绝不
566
+ * 编造一个「100」。
567
+ *
568
+ * ## 为什么每一步失败都单独给文案
569
+ *
570
+ * 用户点「一键签到」时最需要知道的是「卡在哪一步、要不要自己动手」:
571
+ * 题解不出来 ⇒ 上游改版(等修复);redeem 失败 ⇒ 验证过期(重试);
572
+ * checkin 失败 ⇒ 上游拒绝(看原文)。全部笼统成「签到失败」等于零线索。
573
+ */
574
+ export async function claimMonkeycodeDailyCheckin(credential, product = MONKEYCODE, deps = {}) {
575
+ const cookie = cookieOf(credential);
576
+ if (cookie === undefined) {
577
+ return {
578
+ kind: 'failed',
579
+ code: -1,
580
+ // 同上:HttpOnly cookie 不能手工粘贴(F🟡-4)。
581
+ message: '未配置会话(session_cookie)—— 签到接口只认网页登录态,'
582
+ + '请用「浏览器登录」添加账号;已建的账号可点卡片上的「改 Key」补填 session cookie',
583
+ };
584
+ }
585
+ const base = product.platformBaseUrl;
586
+ try {
587
+ const status = await fetchMonkeycodeCheckinStatus(credential, product, deps);
588
+ if (status !== null && status.todayCheckedIn) {
589
+ return { kind: 'already-claimed', message: '今天已经签到过了' };
590
+ }
591
+ // 签到前余额(读不到不影响签到本身,只是拿不到「增量」这个口径)。
592
+ const walletBefore = await fetchMonkeycodeWallet(credential, product, deps);
593
+ const challengeResult = await platformRequest(cookie, `${base}${product.captchaChallengePath}`, { method: 'POST', body: {} }, product, deps);
594
+ if (!challengeResult.ok) {
595
+ return { kind: 'failed', code: challengeResult.status, message: `获取签到验证题失败:${challengeResult.error}` };
596
+ }
597
+ // ⚠️ `platformRequest` 回的是**未解包**的原始报文(`{ code: 0, data: … }` 信封),
598
+ // 而 `readCapChallenge` / `readCapToken` 期望的是信封里的业务对象。
599
+ // 少了这一步,真实报文会被判成「没有 token」⇒ 签到**永远失败**,
600
+ // 且文案指向「上游改版」,排查方向完全跑偏(本轮单测抓到的第一个真实缺陷)。
601
+ const challengeEnvelope = unwrapEnvelope(challengeResult.data);
602
+ if (!challengeEnvelope.ok) {
603
+ return { kind: 'failed', code: -1, message: `获取签到验证题失败:${challengeEnvelope.error}` };
604
+ }
605
+ const challenge = readCapChallenge(challengeEnvelope.value);
606
+ if ('error' in challenge) {
607
+ return { kind: 'failed', code: -1, message: challenge.error };
608
+ }
609
+ // ⚠️ 用 `solveChallengeYielding`(每解完一题让出事件循环)而不是同步版本:
610
+ // 上游调高难度时同步版本会独占宿主事件循环(见 `MAX_POW_ATTEMPTS_TOTAL`)。
611
+ const solutions = await solveChallengeYielding(challenge.token, challenge.challenge);
612
+ const redeemResult = await platformRequest(cookie, `${base}${product.captchaRedeemPath}`, { method: 'POST', body: { token: challenge.token, solutions } }, product, deps);
613
+ if (!redeemResult.ok) {
614
+ return { kind: 'failed', code: redeemResult.status, message: `提交签到验证答案失败:${redeemResult.error}` };
615
+ }
616
+ // 同 challenge:redeem 也带信封,先解包再读 `token`。
617
+ const redeemEnvelope = unwrapEnvelope(redeemResult.data);
618
+ if (!redeemEnvelope.ok) {
619
+ return { kind: 'failed', code: -1, message: `提交签到验证答案失败:${redeemEnvelope.error}` };
620
+ }
621
+ const captchaToken = readCapToken(redeemEnvelope.value);
622
+ if (captchaToken === undefined) {
623
+ return {
624
+ kind: 'failed',
625
+ code: -1,
626
+ message: '签到验证没有通过(redeem 响应里没有 token)—— 可能是验证题已过期,请重试一次',
627
+ };
628
+ }
629
+ const checkinResult = await platformRequest(cookie, `${base}${product.checkinPath}`, { method: 'POST', body: { captcha_token: captchaToken } }, product, deps);
630
+ if (!checkinResult.ok) {
631
+ return { kind: 'failed', code: checkinResult.status, message: `签到失败:${checkinResult.error}` };
632
+ }
633
+ // ① 先看响应里有没有明确的奖励金额(不同版本/站点可能下发)。
634
+ const checkinEnvelope = unwrapEnvelope(checkinResult.data);
635
+ const responseCredit = checkinEnvelope.ok ? readRewardedCredit(checkinEnvelope.value) : undefined;
636
+ // ② 响应没给 ⇒ 用「签到前后余额差」实测(2026-11-03 真机为 +100 积分)。
637
+ let measuredCredit;
638
+ if (responseCredit === undefined && walletBefore.ok) {
639
+ const walletAfter = await fetchMonkeycodeWallet(credential, product, deps);
640
+ if (walletAfter.ok) {
641
+ const delta = walletAfter.wallet.balance - walletBefore.wallet.balance;
642
+ // 浮点尾数(余额按 1/1000 换算)先归整到 3 位小数,再判正负。
643
+ const normalized = Math.round(delta * 1000) / 1000;
644
+ if (normalized > 0)
645
+ measuredCredit = normalized;
646
+ }
647
+ }
648
+ const credited = responseCredit ?? measuredCredit;
649
+ if (credited !== undefined) {
650
+ return {
651
+ kind: 'claimed',
652
+ credit: credited,
653
+ unit: 'credit',
654
+ streakDays: 0,
655
+ isStreakDay: false,
656
+ };
657
+ }
658
+ // ③ 两条口径都拿不到 ⇒ 如实回 0 + 说明(客户端已不会渲染成「+0积分」)。
659
+ return {
660
+ kind: 'claimed',
661
+ credit: 0,
662
+ streakDays: 0,
663
+ isStreakDay: false,
664
+ delayedMessage: '签到成功(上游不返回积分数量,请查看刷新后的余额)',
665
+ };
666
+ }
667
+ catch (error) {
668
+ // PoW 的硬上限抛错走这里:它是**可预期的**上游形态变化,不是崩溃。
669
+ const reason = error instanceof Error ? error.message : String(error);
670
+ return { kind: 'failed', code: -1, message: `签到失败:${reason}` };
671
+ }
672
+ }
673
+ //# sourceMappingURL=monkeycode-credits.js.map