@xixka/dsh-hub 0.4.8 → 0.4.9

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 (473) hide show
  1. package/README.md +1085 -93
  2. package/docs/DETAIL.md +66 -0
  3. package/docs/DETAIL.zh.md +40 -0
  4. package/lib/accio-adapter.d.ts +30 -1
  5. package/lib/accio-adapter.d.ts.map +1 -1
  6. package/lib/accio-adapter.js +102 -15
  7. package/lib/accio-adapter.js.map +1 -1
  8. package/lib/account-pool.d.ts +61 -106
  9. package/lib/account-pool.d.ts.map +1 -1
  10. package/lib/account-pool.js +269 -275
  11. package/lib/account-pool.js.map +1 -1
  12. package/lib/account-probe.d.ts +5 -1
  13. package/lib/account-probe.d.ts.map +1 -1
  14. package/lib/account-probe.js +8 -5
  15. package/lib/account-probe.js.map +1 -1
  16. package/lib/aggregate-adapter.d.ts +0 -38
  17. package/lib/aggregate-adapter.d.ts.map +1 -1
  18. package/lib/aggregate-adapter.js +43 -138
  19. package/lib/aggregate-adapter.js.map +1 -1
  20. package/lib/aggregate-core.d.ts +50 -0
  21. package/lib/aggregate-core.d.ts.map +1 -1
  22. package/lib/aggregate-core.js +80 -0
  23. package/lib/aggregate-core.js.map +1 -1
  24. package/lib/aggregate-dispatch-context.d.ts +57 -0
  25. package/lib/aggregate-dispatch-context.d.ts.map +1 -0
  26. package/lib/aggregate-dispatch-context.js +77 -0
  27. package/lib/aggregate-dispatch-context.js.map +1 -0
  28. package/lib/aggregate-expiry.d.ts +1 -1
  29. package/lib/aggregate-expiry.js +1 -1
  30. package/lib/astudio-adapter.d.ts +34 -14
  31. package/lib/astudio-adapter.d.ts.map +1 -1
  32. package/lib/astudio-adapter.js +42 -25
  33. package/lib/astudio-adapter.js.map +1 -1
  34. package/lib/astudio-product.d.ts +60 -19
  35. package/lib/astudio-product.d.ts.map +1 -1
  36. package/lib/astudio-product.js +36 -18
  37. package/lib/astudio-product.js.map +1 -1
  38. package/lib/astudio.d.ts +68 -22
  39. package/lib/astudio.d.ts.map +1 -1
  40. package/lib/astudio.js +420 -28
  41. package/lib/astudio.js.map +1 -1
  42. package/lib/atomcode-adapter.d.ts.map +1 -1
  43. package/lib/atomcode-adapter.js +1 -2
  44. package/lib/atomcode-adapter.js.map +1 -1
  45. package/lib/auto-checkin.d.ts +15 -10
  46. package/lib/auto-checkin.d.ts.map +1 -1
  47. package/lib/auto-checkin.js +31 -30
  48. package/lib/auto-checkin.js.map +1 -1
  49. package/lib/autoclaw-adapter.d.ts +1 -1
  50. package/lib/autoclaw-adapter.d.ts.map +1 -1
  51. package/lib/autoclaw-adapter.js +4 -4
  52. package/lib/autoclaw-adapter.js.map +1 -1
  53. package/lib/backup.d.ts +2 -22
  54. package/lib/backup.d.ts.map +1 -1
  55. package/lib/backup.js +20 -43
  56. package/lib/backup.js.map +1 -1
  57. package/lib/baizhi-adapter.d.ts.map +1 -1
  58. package/lib/baizhi-adapter.js +1 -2
  59. package/lib/baizhi-adapter.js.map +1 -1
  60. package/lib/balance-cache.d.ts +0 -36
  61. package/lib/balance-cache.d.ts.map +1 -1
  62. package/lib/balance-cache.js +0 -23
  63. package/lib/balance-cache.js.map +1 -1
  64. package/lib/buddy-adapter.d.ts +11 -1
  65. package/lib/buddy-adapter.d.ts.map +1 -1
  66. package/lib/buddy-adapter.js +38 -7
  67. package/lib/buddy-adapter.js.map +1 -1
  68. package/lib/buddy-balance-rank.d.ts +67 -0
  69. package/lib/buddy-balance-rank.d.ts.map +1 -1
  70. package/lib/buddy-balance-rank.js +80 -0
  71. package/lib/buddy-balance-rank.js.map +1 -1
  72. package/lib/buddy-balance-selector.d.ts +19 -0
  73. package/lib/buddy-balance-selector.d.ts.map +1 -1
  74. package/lib/buddy-balance-selector.js +18 -2
  75. package/lib/buddy-balance-selector.js.map +1 -1
  76. package/lib/buddy-oauth.d.ts.map +1 -1
  77. package/lib/buddy-oauth.js +34 -1
  78. package/lib/buddy-oauth.js.map +1 -1
  79. package/lib/buddy.d.ts +42 -0
  80. package/lib/buddy.d.ts.map +1 -1
  81. package/lib/buddy.js +106 -4
  82. package/lib/buddy.js.map +1 -1
  83. package/lib/canonical-models.d.ts.map +1 -1
  84. package/lib/canonical-models.js +175 -7
  85. package/lib/canonical-models.js.map +1 -1
  86. package/lib/chromium-session.d.ts +29 -85
  87. package/lib/chromium-session.d.ts.map +1 -1
  88. package/lib/chromium-session.js +33 -236
  89. package/lib/chromium-session.js.map +1 -1
  90. package/lib/client/jet-hub.js +18452 -107
  91. package/lib/cline-adapter.d.ts +2 -10
  92. package/lib/cline-adapter.d.ts.map +1 -1
  93. package/lib/cline-adapter.js +7 -23
  94. package/lib/cline-adapter.js.map +1 -1
  95. package/lib/cline-models.d.ts +11 -13
  96. package/lib/cline-models.d.ts.map +1 -1
  97. package/lib/cline-models.js +9 -41
  98. package/lib/cline-models.js.map +1 -1
  99. package/lib/codearts-credits.d.ts.map +1 -1
  100. package/lib/codearts-credits.js +6 -7
  101. package/lib/codearts-credits.js.map +1 -1
  102. package/lib/codearts-identity.d.ts +109 -0
  103. package/lib/codearts-identity.d.ts.map +1 -0
  104. package/lib/codearts-identity.js +189 -0
  105. package/lib/codearts-identity.js.map +1 -0
  106. package/lib/codearts-vision.d.ts +8 -9
  107. package/lib/codearts-vision.d.ts.map +1 -1
  108. package/lib/codearts-vision.js +8 -10
  109. package/lib/codearts-vision.js.map +1 -1
  110. package/lib/codely-adapter.d.ts.map +1 -1
  111. package/lib/codely-adapter.js +2 -5
  112. package/lib/codely-adapter.js.map +1 -1
  113. package/lib/credential-resolver.d.ts +17 -1
  114. package/lib/credential-resolver.d.ts.map +1 -1
  115. package/lib/credential-resolver.js +96 -2
  116. package/lib/credential-resolver.js.map +1 -1
  117. package/lib/credits.d.ts +10 -0
  118. package/lib/credits.d.ts.map +1 -1
  119. package/lib/credits.js +65 -2
  120. package/lib/credits.js.map +1 -1
  121. package/lib/dead-model-store.d.ts.map +1 -1
  122. package/lib/dead-model-store.js +24 -2
  123. package/lib/dead-model-store.js.map +1 -1
  124. package/lib/doubao-credits.d.ts +52 -0
  125. package/lib/doubao-credits.d.ts.map +1 -0
  126. package/lib/doubao-credits.js +61 -0
  127. package/lib/doubao-credits.js.map +1 -0
  128. package/lib/doubao-login.d.ts +118 -0
  129. package/lib/doubao-login.d.ts.map +1 -0
  130. package/lib/doubao-login.js +438 -0
  131. package/lib/doubao-login.js.map +1 -0
  132. package/lib/doubao-signin.d.ts +58 -0
  133. package/lib/doubao-signin.d.ts.map +1 -0
  134. package/lib/doubao-signin.js +405 -0
  135. package/lib/doubao-signin.js.map +1 -0
  136. package/lib/doubao.d.ts +94 -0
  137. package/lib/doubao.d.ts.map +1 -0
  138. package/lib/doubao.js +186 -0
  139. package/lib/doubao.js.map +1 -0
  140. package/lib/gemini-adapter.d.ts +1 -1
  141. package/lib/gemini-adapter.d.ts.map +1 -1
  142. package/lib/gemini-adapter.js +4 -10
  143. package/lib/gemini-adapter.js.map +1 -1
  144. package/lib/image-budget.d.ts +11 -3
  145. package/lib/image-budget.d.ts.map +1 -1
  146. package/lib/image-budget.js +5 -43
  147. package/lib/image-budget.js.map +1 -1
  148. package/lib/index.d.ts +51 -0
  149. package/lib/index.d.ts.map +1 -1
  150. package/lib/index.js +239 -283
  151. package/lib/index.js.map +1 -1
  152. package/lib/jet-hub-rpc.d.ts +18 -89
  153. package/lib/jet-hub-rpc.d.ts.map +1 -1
  154. package/lib/jet-hub-rpc.js +1258 -366
  155. package/lib/jet-hub-rpc.js.map +1 -1
  156. package/lib/jet-hub-store.d.ts +110 -49
  157. package/lib/jet-hub-store.d.ts.map +1 -1
  158. package/lib/jet-hub-store.js +141 -36
  159. package/lib/jet-hub-store.js.map +1 -1
  160. package/lib/llm-adapter.d.ts +97 -33
  161. package/lib/llm-adapter.d.ts.map +1 -1
  162. package/lib/llm-adapter.js +191 -47
  163. package/lib/llm-adapter.js.map +1 -1
  164. package/lib/llm-register-compat.d.ts +0 -57
  165. package/lib/llm-register-compat.d.ts.map +1 -1
  166. package/lib/llm-register-compat.js +30 -91
  167. package/lib/llm-register-compat.js.map +1 -1
  168. package/lib/lobsterai-adapter.d.ts +1 -1
  169. package/lib/lobsterai-adapter.d.ts.map +1 -1
  170. package/lib/lobsterai-adapter.js +18 -57
  171. package/lib/lobsterai-adapter.js.map +1 -1
  172. package/lib/lobsterai-auth.d.ts.map +1 -1
  173. package/lib/lobsterai-auth.js +2 -1
  174. package/lib/lobsterai-auth.js.map +1 -1
  175. package/lib/login.d.ts +90 -5
  176. package/lib/login.d.ts.map +1 -1
  177. package/lib/login.js +297 -106
  178. package/lib/login.js.map +1 -1
  179. package/lib/loomy-adapter.d.ts +1 -4
  180. package/lib/loomy-adapter.d.ts.map +1 -1
  181. package/lib/loomy-adapter.js +9 -67
  182. package/lib/loomy-adapter.js.map +1 -1
  183. package/lib/marvis-adapter.d.ts +13 -3
  184. package/lib/marvis-adapter.d.ts.map +1 -1
  185. package/lib/marvis-adapter.js +105 -7
  186. package/lib/marvis-adapter.js.map +1 -1
  187. package/lib/marvis-identity.d.ts +106 -0
  188. package/lib/marvis-identity.d.ts.map +1 -0
  189. package/lib/marvis-identity.js +144 -0
  190. package/lib/marvis-identity.js.map +1 -0
  191. package/lib/marvis-messages.d.ts +65 -4
  192. package/lib/marvis-messages.d.ts.map +1 -1
  193. package/lib/marvis-messages.js +88 -8
  194. package/lib/marvis-messages.js.map +1 -1
  195. package/lib/marvis-product.d.ts +31 -6
  196. package/lib/marvis-product.d.ts.map +1 -1
  197. package/lib/marvis-product.js +60 -13
  198. package/lib/marvis-product.js.map +1 -1
  199. package/lib/marvis-slots.d.ts +43 -0
  200. package/lib/marvis-slots.d.ts.map +1 -0
  201. package/lib/marvis-slots.js +9 -0
  202. package/lib/marvis-slots.js.map +1 -0
  203. package/lib/minimax-adapter.d.ts +1 -6
  204. package/lib/minimax-adapter.d.ts.map +1 -1
  205. package/lib/minimax-adapter.js +4 -10
  206. package/lib/minimax-adapter.js.map +1 -1
  207. package/lib/minimax-auth.d.ts.map +1 -1
  208. package/lib/minimax-auth.js +2 -1
  209. package/lib/minimax-auth.js.map +1 -1
  210. package/lib/model-catalog.d.ts +19 -8
  211. package/lib/model-catalog.d.ts.map +1 -1
  212. package/lib/model-catalog.js +10 -127
  213. package/lib/model-catalog.js.map +1 -1
  214. package/lib/model-promotions.d.ts +377 -0
  215. package/lib/model-promotions.d.ts.map +1 -0
  216. package/lib/model-promotions.js +856 -0
  217. package/lib/model-promotions.js.map +1 -0
  218. package/lib/models-dev-cache.d.ts +0 -27
  219. package/lib/models-dev-cache.d.ts.map +1 -1
  220. package/lib/models-dev-cache.js +3 -48
  221. package/lib/models-dev-cache.js.map +1 -1
  222. package/lib/models.d.ts +17 -14
  223. package/lib/models.d.ts.map +1 -1
  224. package/lib/models.js +23 -47
  225. package/lib/models.js.map +1 -1
  226. package/lib/modelscope-adapter.d.ts +89 -0
  227. package/lib/modelscope-adapter.d.ts.map +1 -1
  228. package/lib/modelscope-adapter.js +167 -23
  229. package/lib/modelscope-adapter.js.map +1 -1
  230. package/lib/modelscope-checkin.d.ts +5 -0
  231. package/lib/modelscope-checkin.d.ts.map +1 -0
  232. package/lib/modelscope-checkin.js +265 -0
  233. package/lib/modelscope-checkin.js.map +1 -0
  234. package/lib/modelscope-credits.d.ts +1 -1
  235. package/lib/modelscope-credits.d.ts.map +1 -1
  236. package/lib/modelscope-credits.js +31 -12
  237. package/lib/modelscope-credits.js.map +1 -1
  238. package/lib/modelscope-messages.d.ts +9 -1
  239. package/lib/modelscope-messages.d.ts.map +1 -1
  240. package/lib/modelscope-messages.js +12 -3
  241. package/lib/modelscope-messages.js.map +1 -1
  242. package/lib/monkeycode-adapter.d.ts.map +1 -1
  243. package/lib/monkeycode-adapter.js +0 -3
  244. package/lib/monkeycode-adapter.js.map +1 -1
  245. package/lib/officeace-adapter.d.ts.map +1 -1
  246. package/lib/officeace-adapter.js +21 -147
  247. package/lib/officeace-adapter.js.map +1 -1
  248. package/lib/officeace-auth.d.ts +0 -15
  249. package/lib/officeace-auth.d.ts.map +1 -1
  250. package/lib/officeace-auth.js +12 -278
  251. package/lib/officeace-auth.js.map +1 -1
  252. package/lib/openai-compat.d.ts.map +1 -1
  253. package/lib/openai-compat.js +1 -18
  254. package/lib/openai-compat.js.map +1 -1
  255. package/lib/openai-gateway/config.d.ts +1 -0
  256. package/lib/openai-gateway/config.d.ts.map +1 -1
  257. package/lib/openai-gateway/config.js +20 -0
  258. package/lib/openai-gateway/config.js.map +1 -1
  259. package/lib/openai-gateway/models.d.ts +77 -1
  260. package/lib/openai-gateway/models.d.ts.map +1 -1
  261. package/lib/openai-gateway/models.js +110 -2
  262. package/lib/openai-gateway/models.js.map +1 -1
  263. package/lib/openai-gateway/server.d.ts.map +1 -1
  264. package/lib/openai-gateway/server.js +23 -17
  265. package/lib/openai-gateway/server.js.map +1 -1
  266. package/lib/openai-gateway/stream.d.ts.map +1 -1
  267. package/lib/openai-gateway/stream.js +24 -2
  268. package/lib/openai-gateway/stream.js.map +1 -1
  269. package/lib/openai-gateway/tencent-fingerprint.d.ts.map +1 -1
  270. package/lib/openai-gateway/tencent-fingerprint.js +14 -2
  271. package/lib/openai-gateway/tencent-fingerprint.js.map +1 -1
  272. package/lib/product.d.ts +17 -12
  273. package/lib/product.d.ts.map +1 -1
  274. package/lib/product.js +17 -12
  275. package/lib/product.js.map +1 -1
  276. package/lib/promotion-edge-broadcast.d.ts +76 -0
  277. package/lib/promotion-edge-broadcast.d.ts.map +1 -0
  278. package/lib/promotion-edge-broadcast.js +172 -0
  279. package/lib/promotion-edge-broadcast.js.map +1 -0
  280. package/lib/provider-credits.d.ts +6 -17
  281. package/lib/provider-credits.d.ts.map +1 -1
  282. package/lib/provider-credits.js +98 -65
  283. package/lib/provider-credits.js.map +1 -1
  284. package/lib/provider-registry.d.ts +19 -6
  285. package/lib/provider-registry.d.ts.map +1 -1
  286. package/lib/provider-registry.js +80 -29
  287. package/lib/provider-registry.js.map +1 -1
  288. package/lib/provider-runtime.d.ts +17 -3
  289. package/lib/provider-runtime.d.ts.map +1 -1
  290. package/lib/provider-runtime.js.map +1 -1
  291. package/lib/qiniu-messages.d.ts +4 -1
  292. package/lib/qiniu-messages.d.ts.map +1 -1
  293. package/lib/qiniu-messages.js +6 -3
  294. package/lib/qiniu-messages.js.map +1 -1
  295. package/lib/qoder-adapter.d.ts +113 -8
  296. package/lib/qoder-adapter.d.ts.map +1 -1
  297. package/lib/qoder-adapter.js +638 -231
  298. package/lib/qoder-adapter.js.map +1 -1
  299. package/lib/qoder-align.d.ts +104 -0
  300. package/lib/qoder-align.d.ts.map +1 -0
  301. package/lib/qoder-align.js +215 -0
  302. package/lib/qoder-align.js.map +1 -0
  303. package/lib/qoder-catalog.d.ts.map +1 -1
  304. package/lib/qoder-catalog.js +7 -0
  305. package/lib/qoder-catalog.js.map +1 -1
  306. package/lib/qoder-credits.d.ts.map +1 -1
  307. package/lib/qoder-credits.js +29 -5
  308. package/lib/qoder-credits.js.map +1 -1
  309. package/lib/qoder-machine.d.ts.map +1 -1
  310. package/lib/qoder-machine.js +0 -52
  311. package/lib/qoder-machine.js.map +1 -1
  312. package/lib/qoder-product.d.ts +20 -4
  313. package/lib/qoder-product.d.ts.map +1 -1
  314. package/lib/qoder-product.js.map +1 -1
  315. package/lib/qoder-rpc.d.ts +16 -1
  316. package/lib/qoder-rpc.d.ts.map +1 -1
  317. package/lib/qoder-rpc.js +56 -1
  318. package/lib/qoder-rpc.js.map +1 -1
  319. package/lib/qoder-traffic-guard.d.ts +6 -0
  320. package/lib/qoder-traffic-guard.d.ts.map +1 -0
  321. package/lib/qoder-traffic-guard.js +44 -0
  322. package/lib/qoder-traffic-guard.js.map +1 -0
  323. package/lib/qoder-web-usage.d.ts +165 -0
  324. package/lib/qoder-web-usage.d.ts.map +1 -0
  325. package/lib/qoder-web-usage.js +471 -0
  326. package/lib/qoder-web-usage.js.map +1 -0
  327. package/lib/raccoon-adapter.d.ts +3 -53
  328. package/lib/raccoon-adapter.d.ts.map +1 -1
  329. package/lib/raccoon-adapter.js +32 -151
  330. package/lib/raccoon-adapter.js.map +1 -1
  331. package/lib/raccoon-auth.d.ts +3 -2
  332. package/lib/raccoon-auth.d.ts.map +1 -1
  333. package/lib/raccoon-auth.js +6 -4
  334. package/lib/raccoon-auth.js.map +1 -1
  335. package/lib/raccoon-credits.d.ts +105 -40
  336. package/lib/raccoon-credits.d.ts.map +1 -1
  337. package/lib/raccoon-credits.js +250 -119
  338. package/lib/raccoon-credits.js.map +1 -1
  339. package/lib/raccoon-login-page.d.ts +10 -5
  340. package/lib/raccoon-login-page.d.ts.map +1 -1
  341. package/lib/raccoon-login-page.js +110 -23
  342. package/lib/raccoon-login-page.js.map +1 -1
  343. package/lib/raccoon-oauth.d.ts +67 -11
  344. package/lib/raccoon-oauth.d.ts.map +1 -1
  345. package/lib/raccoon-oauth.js +140 -16
  346. package/lib/raccoon-oauth.js.map +1 -1
  347. package/lib/raccoon.d.ts +98 -12
  348. package/lib/raccoon.d.ts.map +1 -1
  349. package/lib/raccoon.js +98 -12
  350. package/lib/raccoon.js.map +1 -1
  351. package/lib/reasoning-default.d.ts +207 -0
  352. package/lib/reasoning-default.d.ts.map +1 -0
  353. package/lib/reasoning-default.js +450 -0
  354. package/lib/reasoning-default.js.map +1 -0
  355. package/lib/reasoning-preferences.d.ts +86 -0
  356. package/lib/reasoning-preferences.d.ts.map +1 -0
  357. package/lib/reasoning-preferences.js +172 -0
  358. package/lib/reasoning-preferences.js.map +1 -0
  359. package/lib/service.d.ts +4 -9
  360. package/lib/service.d.ts.map +1 -1
  361. package/lib/service.js +12 -13
  362. package/lib/service.js.map +1 -1
  363. package/lib/session-balance.d.ts.map +1 -1
  364. package/lib/session-balance.js +14 -6
  365. package/lib/session-balance.js.map +1 -1
  366. package/lib/session-title.d.ts +3 -2
  367. package/lib/session-title.d.ts.map +1 -1
  368. package/lib/session-title.js +27 -3
  369. package/lib/session-title.js.map +1 -1
  370. package/lib/sync-apply.d.ts +97 -0
  371. package/lib/sync-apply.d.ts.map +1 -0
  372. package/lib/sync-apply.js +201 -0
  373. package/lib/sync-apply.js.map +1 -0
  374. package/lib/sync-rpc.d.ts +38 -0
  375. package/lib/sync-rpc.d.ts.map +1 -0
  376. package/lib/sync-rpc.js +144 -0
  377. package/lib/sync-rpc.js.map +1 -0
  378. package/lib/sync-service.d.ts +220 -0
  379. package/lib/sync-service.d.ts.map +1 -0
  380. package/lib/sync-service.js +434 -0
  381. package/lib/sync-service.js.map +1 -0
  382. package/lib/sync-targets.d.ts +184 -0
  383. package/lib/sync-targets.d.ts.map +1 -0
  384. package/lib/sync-targets.js +560 -0
  385. package/lib/sync-targets.js.map +1 -0
  386. package/lib/system-prompt-fold.d.ts +53 -0
  387. package/lib/system-prompt-fold.d.ts.map +1 -0
  388. package/lib/system-prompt-fold.js +66 -0
  389. package/lib/system-prompt-fold.js.map +1 -0
  390. package/lib/token-ledger-store.d.ts.map +1 -1
  391. package/lib/token-ledger-store.js +27 -121
  392. package/lib/token-ledger-store.js.map +1 -1
  393. package/lib/token-ledger.d.ts +13 -1
  394. package/lib/token-ledger.d.ts.map +1 -1
  395. package/lib/token-ledger.js.map +1 -1
  396. package/lib/trae-adapter.d.ts +1 -1
  397. package/lib/trae-adapter.d.ts.map +1 -1
  398. package/lib/trae-adapter.js +4 -6
  399. package/lib/trae-adapter.js.map +1 -1
  400. package/lib/trae-auth.d.ts +3 -1
  401. package/lib/trae-auth.d.ts.map +1 -1
  402. package/lib/trae-auth.js +12 -2
  403. package/lib/trae-auth.js.map +1 -1
  404. package/lib/trae-oauth.d.ts +27 -0
  405. package/lib/trae-oauth.d.ts.map +1 -1
  406. package/lib/trae-oauth.js +143 -0
  407. package/lib/trae-oauth.js.map +1 -1
  408. package/lib/types.d.ts +164 -154
  409. package/lib/types.d.ts.map +1 -1
  410. package/lib/types.js.map +1 -1
  411. package/lib/usage-badge.d.ts +2 -83
  412. package/lib/usage-badge.d.ts.map +1 -1
  413. package/lib/usage-badge.js +27 -227
  414. package/lib/usage-badge.js.map +1 -1
  415. package/lib/workbuddy-intl-activity.d.ts +112 -0
  416. package/lib/workbuddy-intl-activity.d.ts.map +1 -0
  417. package/lib/workbuddy-intl-activity.js +370 -0
  418. package/lib/workbuddy-intl-activity.js.map +1 -0
  419. package/lib/zcode-adapter.d.ts.map +1 -1
  420. package/lib/zcode-adapter.js +31 -112
  421. package/lib/zcode-adapter.js.map +1 -1
  422. package/lib/zcode-auth.d.ts.map +1 -1
  423. package/lib/zcode-auth.js +1 -8
  424. package/lib/zcode-auth.js.map +1 -1
  425. package/lib/zcode-login.d.ts.map +1 -1
  426. package/lib/zcode-login.js +3 -5
  427. package/lib/zcode-login.js.map +1 -1
  428. package/lib/zcode-transport.d.ts.map +1 -1
  429. package/lib/zcode-transport.js +1 -3
  430. package/lib/zcode-transport.js.map +1 -1
  431. package/lib/zcode-upstream.d.ts +0 -59
  432. package/lib/zcode-upstream.d.ts.map +1 -1
  433. package/lib/zcode-upstream.js +10 -156
  434. package/lib/zcode-upstream.js.map +1 -1
  435. package/locale/en.json +2 -1
  436. package/locale/zh.json +2 -1
  437. package/package.json +7 -11
  438. package/lib/image-data-cache.d.ts +0 -87
  439. package/lib/image-data-cache.d.ts.map +0 -1
  440. package/lib/image-data-cache.js +0 -144
  441. package/lib/image-data-cache.js.map +0 -1
  442. package/lib/provider-http-pool.d.ts +0 -134
  443. package/lib/provider-http-pool.d.ts.map +0 -1
  444. package/lib/provider-http-pool.js +0 -519
  445. package/lib/provider-http-pool.js.map +0 -1
  446. package/lib/qoder-umid.d.ts +0 -184
  447. package/lib/qoder-umid.d.ts.map +0 -1
  448. package/lib/qoder-umid.js +0 -503
  449. package/lib/qoder-umid.js.map +0 -1
  450. package/lib/webdav-auto-sync.d.ts +0 -101
  451. package/lib/webdav-auto-sync.d.ts.map +0 -1
  452. package/lib/webdav-auto-sync.js +0 -0
  453. package/lib/webdav-auto-sync.js.map +0 -1
  454. package/lib/webdav-rpc.d.ts +0 -13
  455. package/lib/webdav-rpc.d.ts.map +0 -1
  456. package/lib/webdav-rpc.js +0 -137
  457. package/lib/webdav-rpc.js.map +0 -1
  458. package/lib/webdav-sync-crypto.d.ts +0 -18
  459. package/lib/webdav-sync-crypto.d.ts.map +0 -1
  460. package/lib/webdav-sync-crypto.js +0 -72
  461. package/lib/webdav-sync-crypto.js.map +0 -1
  462. package/lib/webdav-sync-merge.d.ts +0 -31
  463. package/lib/webdav-sync-merge.d.ts.map +0 -1
  464. package/lib/webdav-sync-merge.js +0 -0
  465. package/lib/webdav-sync-merge.js.map +0 -1
  466. package/lib/webdav-sync.d.ts +0 -155
  467. package/lib/webdav-sync.d.ts.map +0 -1
  468. package/lib/webdav-sync.js +0 -412
  469. package/lib/webdav-sync.js.map +0 -1
  470. package/lib/workbuddy-keepalive.d.ts +0 -81
  471. package/lib/workbuddy-keepalive.d.ts.map +0 -1
  472. package/lib/workbuddy-keepalive.js +0 -218
  473. package/lib/workbuddy-keepalive.js.map +0 -1
@@ -18,7 +18,6 @@
18
18
  * | 端口纯随机 | 连到旧实例 → `child` 指向死进程 → 整棵树泄漏 | 探测空闲端口 + 校验应答端口 |
19
19
  * | 一次性 `rmSync` | 句柄未释放,残留数十个 profile 目录 | 退避重试 |
20
20
  * | 窗口进任务栏 | 每次刷新都在任务栏闪烁(用户报障) | `WS_EX_TOOLWINDOW` / EWMH / 最小化 |
21
- * | 封装 exe 秒退(Chrome++) | CDP 明明就绪,登录却被判「进程异常退出(code=0)」失败 | `code=0` 转中继形态接续 + 按 `--user-data-dir` 反查回收 |
22
21
  *
23
22
  * ## 与 ZCode 的关系
24
23
  *
@@ -273,8 +272,35 @@ export declare function browserCandidates(input?: {
273
272
  */
274
273
  exists?: (path: string) => boolean;
275
274
  }): string[];
276
- /** 在候选链里挑第一个**存在**的绝对路径。 */
277
- export declare function findBrowserExecutable(): string | undefined;
275
+ /**
276
+ * 浏览器探测的**入参**(与 {@link browserCandidates} 逐字段同义)。
277
+ *
278
+ * ⚠️ 抽成具名类型只为一件事:让「兜底到跨平台探测」的那一层(豆包的
279
+ * `doubaoLoginBrowserExecutable` / `doubaoSigninBrowserExecutable`)能**原样透传**
280
+ * 这份入参,而不是各自抄一遍形状 —— 抄一份就会漂移出第二个口径
281
+ * (本仓「一文件两套同义判据」的教训,见 `docs/agent-notes/misc.md`)。
282
+ */
283
+ export interface BrowserLookup {
284
+ platform?: NodeJS.Platform;
285
+ env?: Record<string, string | undefined>;
286
+ home?: string;
287
+ exists?: (path: string) => boolean;
288
+ }
289
+ /**
290
+ * 在候选链里挑第一个**存在**的绝对路径。
291
+ *
292
+ * ## ⚠️ 可选入参 `lookup`:让「跨平台兜底」本身可测(Gitee issue IKV5HC)
293
+ *
294
+ * 原签名不接受任何入参,于是**只能**用 `process.platform` 与本机 `existsSync`
295
+ * 跑 —— 在 Windows 开发机上「macOS 分支」永远走不到,这类「平台路径」缺陷
296
+ * 结构上不可能被 CI 发现(豆包 provider 就是这么漏的:它的候选链全是
297
+ * Windows 路径,而 macOS 用户点「新建账号」只会看到「未找到可执行文件」)。
298
+ *
299
+ * 入参与 {@link browserCandidates} **逐字段同义**(直接透传),因此
300
+ * `findBrowserExecutable()` 与 `findBrowserExecutable({ platform: 'darwin', … })`
301
+ * 的差别只在「用谁的环境」,判据仍只有这一处。
302
+ */
303
+ export declare function findBrowserExecutable(lookup?: BrowserLookup): string | undefined;
278
304
  /**
279
305
  * 找不到浏览器时的**用户可执行提示**(按平台说人话)。
280
306
  *
@@ -330,38 +356,6 @@ export declare function browserNotFoundMessage(platform?: NodeJS.Platform, overr
330
356
  * —— 那会把 `Brave Browser` 之类的路径误伤。
331
357
  */
332
358
  export declare function isEdgeExecutable(executable: string): boolean;
333
- /**
334
- * 中继回收(Chrome++ 之类的封装启动器形态,2026-11-10)用的**匹配串环境变量名**。
335
- *
336
- * Windows 端把匹配串(`--user-data-dir=<本次会话目录>`)经它传给回收脚本 ——
337
- * 见 {@link buildRelayKillPowerShellScript} 里「为什么走环境变量」的两条理由。
338
- */
339
- export declare const RELAY_MATCH_ENV = "DSH_RELAY_MATCH";
340
- /**
341
- * Windows 中继回收脚本:按环境变量 {@link RELAY_MATCH_ENV} 里的匹配串,
342
- * 反查**命令行**里含它的进程并终止(`Get-CimInstance Win32_Process` + `Stop-Process`)。
343
- *
344
- * ⚠️ **纯函数**(内容不含任何运行时值):匹配串走环境变量传入,脚本因此可以
345
- * **纯 ASCII** 落盘 —— PS 5.1 对无 BOM UTF-8 会按 ANSI 解读,而临时目录路径
346
- * 可能含非 ASCII 的用户名(同 {@link hideWindowWindows} 的教训)。
347
- *
348
- * ⚠️ WQL `LIKE` 的转义在脚本里做(`[` → `[[]`、`%` → `[%]`、`_` → `[_]`、
349
- * `'` → `''`);反斜杠在 WQL 字符串里**不是**转义符,Windows 目录路径原样可用。
350
- * 过滤串用**单引号拼接**构造:值来自变量拼接、不经过 PS 双引号的 `$`/反引号
351
- * 二次展开 —— 路径里出现 `$` 或 `` ` `` 也不会破坏语法。
352
- *
353
- * ⚠️ 匹配串不在 PowerShell 自身命令行里(在环境变量里)⇒ CIM 查询天然不会把
354
- * 执行反查的这个进程自己也列进去 —— 这正是走环境变量的第二条理由。
355
- */
356
- export declare function buildRelayKillPowerShellScript(): string;
357
- /**
358
- * 把字面量文本转义成 POSIX **ERE**(`pkill -f` 的匹配方言)。
359
- *
360
- * ⚠️ 只转义元字符(`\ . + * ? ^ $ ( ) [ ] { } |`)、不动其余字符 ——
361
- * `/`、空格、`-`、`=` 在 ERE 里都是普通字符。测试锁死行为:
362
- * `tests/unit/chromium-relay-launch.spec.ts`。
363
- */
364
- export declare function escapePosixEre(literal: string): string;
365
359
  /**
366
360
  * **浏览器部署错误**:本机没配好(找不到可执行文件 / 起不来),
367
361
  * 重试一万次也不会成功。
@@ -666,27 +660,6 @@ export declare class ChromiumSession {
666
660
  * 否则「浏览器秒退」要白等满 `readyTimeoutMs`(默认 30 秒)才报错。
667
661
  */
668
662
  private spawnFailure;
669
- /**
670
- * Chrome++ 之类的**封装启动器**(中继)形态:外层 exe 把命令行**原样转发**
671
- * 给一个**独立**的真实浏览器进程后,自己以 `code=0` 秒退(实测 9ms)。
672
- *
673
- * `true` = 本会话是这种形态,意味着:
674
- * - `this.child` 指向的是**已退出**的启动器 —— `taskkill /T` / 进程组
675
- * 都打不到真实浏览器,收尾必须改走「按 `--user-data-dir` 反查」
676
- * ({@link killRelayedBrowser});
677
- * - 真实浏览器的死活只能从**浏览器级 WebSocket 的断开**探知
678
- * (`launch()` 里注册的 `'close'` 监听)。
679
- */
680
- private relayed;
681
- /**
682
- * 启动器以 `code=0` 自退时**暂存**的失败原因。
683
- *
684
- * ⚠️ 不立刻赋给 {@link spawnFailure}:那会把「封装形态 + CDP 即将就绪」的
685
- * 正常路径一起判死(用户报障:超级麦吉 / MagiCrew 国际版登录直接失败,
686
- * 而浏览器窗口明明开着)。只有轮询到 `readyTimeoutMs` 期限 CDP 仍未应答时,
687
- * 它才作为最终报错抛出 —— 文案保留「换浏览器」的可操作指引。
688
- */
689
- private launcherExit;
690
663
  private readonly log;
691
664
  constructor(options?: ChromiumSessionOptions);
692
665
  /** 浏览器是否已就绪。 */
@@ -715,10 +688,6 @@ export declare class ChromiumSession {
715
688
  * 监听只在**它自己**退出时同时满足这两条(主动 `kill()` 会先把 `child` 置空,
716
689
  * 那一刻 `spawnFailure` 仍是 `undefined`;启动前两者也都为空)。
717
690
  *
718
- * **中继形态**(Chrome++ 之类封装启动器,2026-11-10):真实浏览器不是我们的
719
- * 子进程、没有 `'exit'` 可听,这条腿由 `launch()` 里注册的**浏览器级
720
- * WebSocket `'close'` 监听**补上(用户关窗 ⇒ 连接断开 ⇒ `spawnFailure` 就位)。
721
- *
722
691
  * 用途:登录类流程(`magicrew-browser-login.ts`)据它**提前**结束等待 ——
723
692
  * 用户关窗后若还耗满 4 分钟预算,用户看到的是「明明关掉了却还在转圈」。
724
693
  */
@@ -775,31 +744,6 @@ export declare class ChromiumSession {
775
744
  * 换来确定性的「返回即已终止」。
776
745
  */
777
746
  private killProcessTree;
778
- /**
779
- * 收掉**中继形态**的真实浏览器(Chrome++ 之类封装启动器代起的那个)。
780
- *
781
- * ## 为什么必须按 `--user-data-dir` 反查(而不是 pid)
782
- *
783
- * 启动器退出后,真实浏览器对我们只剩一个可反查的锚点:**命令行** ——
784
- * 启动器**原样转发**了我们传的参数,真实浏览器(及其子进程)的命令行里
785
- * 带着 `--user-data-dir=<本次会话的 mkdtemp 目录>`。这个目录**每次会话
786
- * 唯一**,拿它当键不会误伤用户自己开的浏览器(那是另一个 user-data-dir)。
787
- * pid 则拿不到:启动器没告诉我们,`child.pid` 是启动器的。
788
- *
789
- * ## 平台实现
790
- *
791
- * | 平台 | 手段 | 说明 |
792
- * |---|---|---|
793
- * | Windows | `Get-CimInstance Win32_Process`(WQL `LIKE`)+ `Stop-Process` | PS 5.1 自带;匹配串走**环境变量**传入(见 {@link buildRelayKillPowerShellScript}) |
794
- * | POSIX | `pkill -f -- <pattern>` | 模式按 ERE 转义({@link escapePosixEre});`pkill` 自带「不匹配自己」 |
795
- *
796
- * ⚠️ `spawnSync`(同步):与 {@link killProcessTree} 同一纪律 ——
797
- * 调用方(如 captcha 的轮询重试)返回后旧实例必须已经终止,否则端口串线。
798
- *
799
- * ⚠️ 尽力而为:反查失败(权限 / 策略 / 工具缺失)最坏结果是那棵树留到
800
- * 用户注销,**不能**让它把清理流程本身弄挂。
801
- */
802
- private killRelayedBrowser;
803
747
  /**
804
748
  * 关闭浏览器并清理临时 profile。
805
749
  *
@@ -1 +1 @@
1
- {"version":3,"file":"chromium-session.d.ts","sourceRoot":"","sources":["../src/chromium-session.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"chromium-session.d.ts","sourceRoot":"","sources":["../src/chromium-session.ts"],"names":[],"mappings":"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"}
@@ -18,7 +18,6 @@
18
18
  * | 端口纯随机 | 连到旧实例 → `child` 指向死进程 → 整棵树泄漏 | 探测空闲端口 + 校验应答端口 |
19
19
  * | 一次性 `rmSync` | 句柄未释放,残留数十个 profile 目录 | 退避重试 |
20
20
  * | 窗口进任务栏 | 每次刷新都在任务栏闪烁(用户报障) | `WS_EX_TOOLWINDOW` / EWMH / 最小化 |
21
- * | 封装 exe 秒退(Chrome++) | CDP 明明就绪,登录却被判「进程异常退出(code=0)」失败 | `code=0` 转中继形态接续 + 按 `--user-data-dir` 反查回收 |
22
21
  *
23
22
  * ## 与 ZCode 的关系
24
23
  *
@@ -757,9 +756,23 @@ export function browserCandidates(input = {}) {
757
756
  }
758
757
  return candidates;
759
758
  }
760
- /** 在候选链里挑第一个**存在**的绝对路径。 */
761
- export function findBrowserExecutable() {
762
- for (const candidate of browserCandidates()) {
759
+ /**
760
+ * 在候选链里挑第一个**存在**的绝对路径。
761
+ *
762
+ * ## ⚠️ 可选入参 `lookup`:让「跨平台兜底」本身可测(Gitee issue IKV5HC)
763
+ *
764
+ * 原签名不接受任何入参,于是**只能**用 `process.platform` 与本机 `existsSync`
765
+ * 跑 —— 在 Windows 开发机上「macOS 分支」永远走不到,这类「平台路径」缺陷
766
+ * 结构上不可能被 CI 发现(豆包 provider 就是这么漏的:它的候选链全是
767
+ * Windows 路径,而 macOS 用户点「新建账号」只会看到「未找到可执行文件」)。
768
+ *
769
+ * 入参与 {@link browserCandidates} **逐字段同义**(直接透传),因此
770
+ * `findBrowserExecutable()` 与 `findBrowserExecutable({ platform: 'darwin', … })`
771
+ * 的差别只在「用谁的环境」,判据仍只有这一处。
772
+ */
773
+ export function findBrowserExecutable(lookup = {}) {
774
+ const exists = lookup.exists ?? existsSync;
775
+ for (const candidate of browserCandidates(lookup)) {
763
776
  try {
764
777
  /**
765
778
  * ⚠ 只接受**绝对路径**:空环境变量产生的相对路径会相对 CWD 解析,
@@ -767,7 +780,7 @@ export function findBrowserExecutable() {
767
780
  */
768
781
  if (candidate.length === 0 || !isAbsolute(candidate))
769
782
  continue;
770
- if (existsSync(candidate))
783
+ if (exists(candidate))
771
784
  return candidate;
772
785
  }
773
786
  catch {
@@ -884,52 +897,6 @@ function safeRemoveDir(dir) {
884
897
  }
885
898
  catch { /* 忽略 */ }
886
899
  }
887
- /**
888
- * 中继回收(Chrome++ 之类的封装启动器形态,2026-11-10)用的**匹配串环境变量名**。
889
- *
890
- * Windows 端把匹配串(`--user-data-dir=<本次会话目录>`)经它传给回收脚本 ——
891
- * 见 {@link buildRelayKillPowerShellScript} 里「为什么走环境变量」的两条理由。
892
- */
893
- export const RELAY_MATCH_ENV = 'DSH_RELAY_MATCH';
894
- /**
895
- * Windows 中继回收脚本:按环境变量 {@link RELAY_MATCH_ENV} 里的匹配串,
896
- * 反查**命令行**里含它的进程并终止(`Get-CimInstance Win32_Process` + `Stop-Process`)。
897
- *
898
- * ⚠️ **纯函数**(内容不含任何运行时值):匹配串走环境变量传入,脚本因此可以
899
- * **纯 ASCII** 落盘 —— PS 5.1 对无 BOM UTF-8 会按 ANSI 解读,而临时目录路径
900
- * 可能含非 ASCII 的用户名(同 {@link hideWindowWindows} 的教训)。
901
- *
902
- * ⚠️ WQL `LIKE` 的转义在脚本里做(`[` → `[[]`、`%` → `[%]`、`_` → `[_]`、
903
- * `'` → `''`);反斜杠在 WQL 字符串里**不是**转义符,Windows 目录路径原样可用。
904
- * 过滤串用**单引号拼接**构造:值来自变量拼接、不经过 PS 双引号的 `$`/反引号
905
- * 二次展开 —— 路径里出现 `$` 或 `` ` `` 也不会破坏语法。
906
- *
907
- * ⚠️ 匹配串不在 PowerShell 自身命令行里(在环境变量里)⇒ CIM 查询天然不会把
908
- * 执行反查的这个进程自己也列进去 —— 这正是走环境变量的第二条理由。
909
- */
910
- export function buildRelayKillPowerShellScript() {
911
- return `
912
- $ErrorActionPreference = 'SilentlyContinue'
913
- $m = $env:${RELAY_MATCH_ENV}
914
- if ([string]::IsNullOrWhiteSpace($m)) { exit 0 }
915
- $e = $m.Replace('[', '[[]').Replace('%', '[%]').Replace('_', '[_]').Replace("'", "''")
916
- $filter = 'CommandLine LIKE ' + "'" + $e + "'"
917
- foreach ($p in @(Get-CimInstance Win32_Process -Filter $filter)) {
918
- try { Stop-Process -Id $p.ProcessId -Force -ErrorAction SilentlyContinue } catch {}
919
- }
920
- exit 0
921
- `;
922
- }
923
- /**
924
- * 把字面量文本转义成 POSIX **ERE**(`pkill -f` 的匹配方言)。
925
- *
926
- * ⚠️ 只转义元字符(`\ . + * ? ^ $ ( ) [ ] { } |`)、不动其余字符 ——
927
- * `/`、空格、`-`、`=` 在 ERE 里都是普通字符。测试锁死行为:
928
- * `tests/unit/chromium-relay-launch.spec.ts`。
929
- */
930
- export function escapePosixEre(literal) {
931
- return literal.replace(/[\\.+*?^$()[\]{}|]/g, '\\$&');
932
- }
933
900
  /**
934
901
  * **浏览器部署错误**:本机没配好(找不到可执行文件 / 起不来),
935
902
  * 重试一万次也不会成功。
@@ -1545,27 +1512,6 @@ export class ChromiumSession {
1545
1512
  * 否则「浏览器秒退」要白等满 `readyTimeoutMs`(默认 30 秒)才报错。
1546
1513
  */
1547
1514
  spawnFailure;
1548
- /**
1549
- * Chrome++ 之类的**封装启动器**(中继)形态:外层 exe 把命令行**原样转发**
1550
- * 给一个**独立**的真实浏览器进程后,自己以 `code=0` 秒退(实测 9ms)。
1551
- *
1552
- * `true` = 本会话是这种形态,意味着:
1553
- * - `this.child` 指向的是**已退出**的启动器 —— `taskkill /T` / 进程组
1554
- * 都打不到真实浏览器,收尾必须改走「按 `--user-data-dir` 反查」
1555
- * ({@link killRelayedBrowser});
1556
- * - 真实浏览器的死活只能从**浏览器级 WebSocket 的断开**探知
1557
- * (`launch()` 里注册的 `'close'` 监听)。
1558
- */
1559
- relayed = false;
1560
- /**
1561
- * 启动器以 `code=0` 自退时**暂存**的失败原因。
1562
- *
1563
- * ⚠️ 不立刻赋给 {@link spawnFailure}:那会把「封装形态 + CDP 即将就绪」的
1564
- * 正常路径一起判死(用户报障:超级麦吉 / MagiCrew 国际版登录直接失败,
1565
- * 而浏览器窗口明明开着)。只有轮询到 `readyTimeoutMs` 期限 CDP 仍未应答时,
1566
- * 它才作为最终报错抛出 —— 文案保留「换浏览器」的可操作指引。
1567
- */
1568
- launcherExit;
1569
1515
  log;
1570
1516
  constructor(options = {}) {
1571
1517
  this.options = options;
@@ -1605,10 +1551,6 @@ export class ChromiumSession {
1605
1551
  * 监听只在**它自己**退出时同时满足这两条(主动 `kill()` 会先把 `child` 置空,
1606
1552
  * 那一刻 `spawnFailure` 仍是 `undefined`;启动前两者也都为空)。
1607
1553
  *
1608
- * **中继形态**(Chrome++ 之类封装启动器,2026-11-10):真实浏览器不是我们的
1609
- * 子进程、没有 `'exit'` 可听,这条腿由 `launch()` 里注册的**浏览器级
1610
- * WebSocket `'close'` 监听**补上(用户关窗 ⇒ 连接断开 ⇒ `spawnFailure` 就位)。
1611
- *
1612
1554
  * 用途:登录类流程(`magicrew-browser-login.ts`)据它**提前**结束等待 ——
1613
1555
  * 用户关窗后若还耗满 4 分钟预算,用户看到的是「明明关掉了却还在转圈」。
1614
1556
  */
@@ -1702,11 +1644,8 @@ export class ChromiumSession {
1702
1644
  /**
1703
1645
  * 每次启动都是一次全新的尝试:上一次的失败原因必须清掉,
1704
1646
  * 否则上一轮「浏览器起不来」会让后续**所有**轮次秒失败。
1705
- * 中继形态({@link relayed})与其暂存报错同理 —— 一并复位。
1706
1647
  */
1707
1648
  this.spawnFailure = undefined;
1708
- this.relayed = false;
1709
- this.launcherExit = undefined;
1710
1649
  this.profileDir = mkdtempSync(join(tmpdir(), this.options.profilePrefix ?? 'chromium-session-'));
1711
1650
  /**
1712
1651
  * ★ **必须挑一个确实空闲的端口**(真实缺陷)。
@@ -1819,45 +1758,25 @@ export class ChromiumSession {
1819
1758
  ? `signal=${signal}`
1820
1759
  : `code=${String(code)}`;
1821
1760
  /**
1822
- * ## ⚠️⚠️ `code=0` 是「封装启动器」而非死亡(2026-11-10 修)
1761
+ * ## ⚠️⚠️ `code=0` 也算「起不来」(Gitee issue IKQ4JN 的实测坑)
1823
1762
  *
1824
- * 有用户用 **Chrome++ 之类的封装 exe**(如 `D:\soft\1\常用\chrome\chrome.exe`):
1825
- * 外层 exe 会**在 9ms 内以 exit code 0 正常退出**,把命令行**原样转发**
1826
- * 给一个**独立**的真实浏览器进程。
1763
+ * 有人用 **Chrome++ 之类的封装 exe**(如 `D:\…\Chrome\App\Chrome.exe`):
1764
+ * 外层 exe 会**在 9ms 内以 exit code 0 正常退出**,然后拉起一个独立进程。
1827
1765
  *
1828
1766
  * 实测表象极具误导性:CDP `/json/version` **517ms 就绪、端口完全正常**,
1829
- * 而启动器已按 `code=0` 退出。原先直接判失败,超级麦吉 / MagiCrew 国际版
1830
- * 的用户看到「浏览器进程异常退出(code=0)……属不支持的封装形态」——
1831
- * **浏览器明明跑着却被判死**。
1832
- *
1833
- * ## 现在的三段处理
1834
- *
1835
- * 1. **先不判死**:`code=0`(且无信号)只置 {@link relayed} 并暂存报错
1836
- * ({@link launcherExit}),**不**碰 `spawnFailure` —— 轮询继续,
1837
- * 真实浏览器就在那 517ms 后应答我们的端口。
1838
- * 2. **CDP 就绪** ⇒ 下方的端口校验(`webSocketDebuggerUrl` 里的端口必须
1839
- * 等于 `this.port`)保证应答的确实是这次启动的那个浏览器(启动器
1840
- * 会转发 `--remote-debugging-port`)⇒ 正常接续;收尾改走
1841
- * {@link killRelayedBrowser} 按 `--user-data-dir` 反查回收 ——
1842
- * 不会再用「死了的 `this.child`」去打 `taskkill`。
1843
- * 3. **到 `readyTimeoutMs` 期限 CDP 仍未应答** ⇒ 抛 {@link launcherExit}
1844
- * (保留「换浏览器」的可操作指引;这种情况说明该封装没把命令行
1845
- * 转发给真实浏览器)。
1767
+ * 而这里判 `code=0`。若按「退出码 0 = 正常」放行,就会继续用一个
1768
+ * **已经死了的** `this.child`(`killProcessTree` 打空、真实例泄漏);
1769
+ * 若按「异常退出」处理,则**浏览器明明跑着却被判死**。
1846
1770
  *
1847
- * ⚠️ 误判风险为零的依据:`code=0` 分支只在**直接子进程秒退**时走进来,
1848
- * 而真 chromium 启动时不会秒退(headful 至少活到 CDP 就绪之后);
1849
- * 若 exe 真的什么都没拉起,第 3 段兜底会报出与原先一致的部署错误。
1771
+ * ⇒ 当前选择后者(判失败)并**明确告知**用户换一个真浏览器:
1772
+ * 泄漏整棵进程树比「误判一个非标准封装」严重得多。这条也解释了
1773
+ * 为什么它属于**部署错误**(换浏览器就能好,重试没用)。
1850
1774
  */
1851
- if (code === 0 && signal === null) {
1852
- this.relayed = true;
1853
- this.launcherExit ??= new BrowserDeploymentError(`${label}: 浏览器进程异常退出(${executable},${how})` +
1854
- `。请重试,或用 ${envName} 指定其它 chromium 内核浏览器。` +
1855
- '(退出码 0 = 该 exe 启动了别的进程后自行退出;已等到超时它仍未应答调试端口,' +
1856
- '该封装形态可能没有转发命令行参数,如 Chrome++ 配置异常)', 'browser-spawn-failed');
1857
- return;
1858
- }
1859
1775
  this.spawnFailure ??= new BrowserDeploymentError(`${label}: 浏览器进程异常退出(${executable},${how})` +
1860
- `。请重试,或用 ${envName} 指定其它 chromium 内核浏览器。`, 'browser-spawn-failed');
1776
+ `。请重试,或用 ${envName} 指定其它 chromium 内核浏览器。` +
1777
+ (code === 0
1778
+ ? '(退出码 0 = 该 exe 启动了别的进程后自行退出,属不支持的封装形态,如 Chrome++)'
1779
+ : ''), 'browser-spawn-failed');
1861
1780
  });
1862
1781
  const timeoutMs = this.options.readyTimeoutMs ?? 30_000;
1863
1782
  const deadline = Date.now() + timeoutMs;
@@ -1895,13 +1814,8 @@ export class ChromiumSession {
1895
1814
  /**
1896
1815
  * ⚠️ 走到这里若 `spawnFailure` 已就位,优先抛它 ——
1897
1816
  * 「浏览器起不来」比「端口没就绪」更贴近根因,用户才知道该换浏览器。
1898
- *
1899
- * ⚠️ **中继形态**(启动器 `code=0` 自退、CDP 始终未应答)其次抛
1900
- * {@link launcherExit}:文案同样落到「换浏览器」的可操作指引上
1901
- * (见 `exit` 监听里 `code=0` 分支的说明)。
1902
1817
  */
1903
1818
  throw this.spawnFailure
1904
- ?? this.launcherExit
1905
1819
  ?? new BrowserDeploymentError(`${label}: 浏览器调试端口未就绪(${timeoutMs}ms 超时)` +
1906
1820
  `。可换一个 chromium 内核浏览器,或用 ${envName} 指定。`, 'browser-spawn-failed');
1907
1821
  }
@@ -1928,29 +1842,6 @@ export class ChromiumSession {
1928
1842
  });
1929
1843
  this.ws = ws;
1930
1844
  this.cdp = new CdpConnection(ws);
1931
- /**
1932
- * ★ **中继形态的「退出」检测**(2026-11-10,配合 `exit` 监听的 `code=0` 分支)。
1933
- *
1934
- * 真实浏览器**不是我们的子进程**,`'exit'` 监听探不到它的死活 —— 用户关窗后
1935
- * {@link exited} 若不翻转,登录流程会耗满等待预算(用户看到
1936
- * 「明明关掉了却还在转圈」,恰是那个 getter 存在的理由)。
1937
- * 这里由**浏览器级 WebSocket 断开**补上这一腿。
1938
- *
1939
- * ⚠️ `this.ws !== ws` 挡掉主动停机:`kill()` 会先把 `this.ws` 置空,
1940
- * 而 `'close'` 事件是**异步派发**的(JS 单线程,事件到达时置空早已完成)——
1941
- * 与 `'exit'` 监听的「`this.child !== child`」判据同一思路,不需要额外标志。
1942
- * 正常(非中继)形态不走这条腿:`'exit'` 监听已经覆盖。
1943
- */
1944
- if (this.relayed) {
1945
- this.log?.(`[jet-hub] ${label}: 检测到封装启动器(如 Chrome++)已代为启动浏览器 —— 会话继续,` +
1946
- '收尾将按 --user-data-dir 反查回收进程。');
1947
- ws.addEventListener('close', () => {
1948
- if (this.ws !== ws || !this.relayed)
1949
- return;
1950
- this.spawnFailure ??= new BrowserDeploymentError(`${label}: 浏览器进程已退出(封装启动器形态,调试连接已断开)。` +
1951
- `请重试,或用 ${envName} 指定其它 chromium 内核浏览器。`, 'browser-spawn-failed');
1952
- });
1953
- }
1954
1845
  /**
1955
1846
  * ★ **把窗口从任务栏移除**(Windows / Linux / macOS 各一条路)。
1956
1847
  *
@@ -1961,17 +1852,9 @@ export class ChromiumSession {
1961
1852
  * (库库AI 的登录要让用户看见并自己操作)。
1962
1853
  *
1963
1854
  * ⚠ 不 await:这是装饰性优化,失败要静默,不能拖慢启动。
1964
- *
1965
- * ⚠️ **中继形态拿不到真实浏览器的主进程 pid**(启动器已退)——
1966
- * 如实告警而不是静默:用户会看到任务栏多一个浏览器图标(功能不受影响)。
1967
1855
  */
1968
- if (hide && this.relayed) {
1969
- this.log?.(`[jet-hub] ${label}: 封装启动器(如 Chrome++)形态下拿不到浏览器主进程 pid,` +
1970
- '跳过任务栏隐藏 —— 浏览器图标可能出现在任务栏(不影响功能)。');
1971
- }
1972
- else if (hide && this.child?.pid !== undefined) {
1856
+ if (hide && this.child?.pid !== undefined)
1973
1857
  hideWindowFromTaskbar(this.child.pid, this.log);
1974
- }
1975
1858
  }
1976
1859
  /**
1977
1860
  * 终止浏览器进程**树**并清理所有 CDP 连接(**保留**临时 profile)。
@@ -2029,21 +1912,8 @@ export class ChromiumSession {
2029
1912
  killProcessTree() {
2030
1913
  const child = this.child;
2031
1914
  this.child = undefined;
2032
- if (child === undefined || child.pid === undefined) {
2033
- /**
2034
- * ★ **中继形态的收尾**(2026-11-10):走到这里且 {@link relayed} 为真,
2035
- * 说明 `child` 是那个已退出的**封装启动器** —— `taskkill /T` / 进程组
2036
- * 都打不到真实浏览器,它此刻还带着整棵树(约 200-400MB)在跑。
2037
- * 按 `--user-data-dir` 反查回收,见 {@link killRelayedBrowser}。
2038
- *
2039
- * ⚠️ 只在 `relayed` 时才反查:正常形态下走到这里说明浏览器是
2040
- * **自己**退出的(用户关窗 / 崩溃),树已随之消散 —— 再去拉一次
2041
- * PowerShell 纯属浪费(每次约 0.5~1 秒)。
2042
- */
2043
- if (this.relayed)
2044
- this.killRelayedBrowser();
1915
+ if (child === undefined || child.pid === undefined)
2045
1916
  return;
2046
- }
2047
1917
  const pid = child.pid;
2048
1918
  if (process.platform === 'win32') {
2049
1919
  /**
@@ -2081,79 +1951,6 @@ export class ChromiumSession {
2081
1951
  catch { /* 已退出 */ }
2082
1952
  }
2083
1953
  }
2084
- /**
2085
- * 收掉**中继形态**的真实浏览器(Chrome++ 之类封装启动器代起的那个)。
2086
- *
2087
- * ## 为什么必须按 `--user-data-dir` 反查(而不是 pid)
2088
- *
2089
- * 启动器退出后,真实浏览器对我们只剩一个可反查的锚点:**命令行** ——
2090
- * 启动器**原样转发**了我们传的参数,真实浏览器(及其子进程)的命令行里
2091
- * 带着 `--user-data-dir=<本次会话的 mkdtemp 目录>`。这个目录**每次会话
2092
- * 唯一**,拿它当键不会误伤用户自己开的浏览器(那是另一个 user-data-dir)。
2093
- * pid 则拿不到:启动器没告诉我们,`child.pid` 是启动器的。
2094
- *
2095
- * ## 平台实现
2096
- *
2097
- * | 平台 | 手段 | 说明 |
2098
- * |---|---|---|
2099
- * | Windows | `Get-CimInstance Win32_Process`(WQL `LIKE`)+ `Stop-Process` | PS 5.1 自带;匹配串走**环境变量**传入(见 {@link buildRelayKillPowerShellScript}) |
2100
- * | POSIX | `pkill -f -- <pattern>` | 模式按 ERE 转义({@link escapePosixEre});`pkill` 自带「不匹配自己」 |
2101
- *
2102
- * ⚠️ `spawnSync`(同步):与 {@link killProcessTree} 同一纪律 ——
2103
- * 调用方(如 captcha 的轮询重试)返回后旧实例必须已经终止,否则端口串线。
2104
- *
2105
- * ⚠️ 尽力而为:反查失败(权限 / 策略 / 工具缺失)最坏结果是那棵树留到
2106
- * 用户注销,**不能**让它把清理流程本身弄挂。
2107
- */
2108
- killRelayedBrowser() {
2109
- const dir = this.profileDir;
2110
- if (dir === undefined || dir.length === 0)
2111
- return;
2112
- const marker = `--user-data-dir=${dir}`;
2113
- if (process.platform === 'win32') {
2114
- let scriptDir;
2115
- try {
2116
- const script = buildRelayKillPowerShellScript();
2117
- scriptDir = mkdtempSync(join(tmpdir(), 'chromium-relay-'));
2118
- const file = join(scriptDir, 'kill-relay.ps1');
2119
- /** 纯 ASCII 脚本(理由见 {@link buildRelayKillPowerShellScript})。 */
2120
- writeFileSync(file, script, 'ascii');
2121
- /**
2122
- * 匹配串走环境变量 {@link RELAY_MATCH_ENV} 而不是命令行参数:
2123
- * 1. 脚本保持纯 ASCII(PS 5.1 对无 BOM UTF-8 按 ANSI 解读);
2124
- * 2. PowerShell 自身的命令行因此**不含**匹配串 —— CIM 查询不会把
2125
- * 执行反查的这个进程自己也列进去。
2126
- */
2127
- spawnSync('powershell.exe', [
2128
- '-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass',
2129
- '-WindowStyle', 'Hidden', '-File', file,
2130
- ], {
2131
- stdio: 'ignore',
2132
- windowsHide: true,
2133
- // 最多等 10 秒(正常约 0.5~1 秒;卡住说明系统异常,别无限等)。
2134
- timeout: 10_000,
2135
- env: { ...process.env, [RELAY_MATCH_ENV]: marker },
2136
- });
2137
- }
2138
- catch {
2139
- // 尽力而为:见方法注释。
2140
- }
2141
- finally {
2142
- if (scriptDir !== undefined)
2143
- safeRemoveDir(scriptDir);
2144
- }
2145
- return;
2146
- }
2147
- try {
2148
- spawnSync('pkill', ['-f', '--', escapePosixEre(marker)], {
2149
- stdio: 'ignore',
2150
- timeout: 10_000,
2151
- });
2152
- }
2153
- catch {
2154
- // 尽力而为:见方法注释。
2155
- }
2156
- }
2157
1954
  /**
2158
1955
  * 关闭浏览器并清理临时 profile。
2159
1956
  *