@xixka/dsh-hub 0.3.2 → 0.3.3

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 (187) hide show
  1. package/README.md +56 -1
  2. package/lib/account-pool.d.ts +31 -0
  3. package/lib/account-pool.d.ts.map +1 -1
  4. package/lib/account-pool.js +98 -7
  5. package/lib/account-pool.js.map +1 -1
  6. package/lib/aggregate-adapter.d.ts.map +1 -1
  7. package/lib/aggregate-adapter.js +7 -0
  8. package/lib/aggregate-adapter.js.map +1 -1
  9. package/lib/aggregate-expiry.d.ts +19 -0
  10. package/lib/aggregate-expiry.d.ts.map +1 -1
  11. package/lib/aggregate-expiry.js +31 -0
  12. package/lib/aggregate-expiry.js.map +1 -1
  13. package/lib/astudio-adapter.d.ts +1 -1
  14. package/lib/astudio-adapter.js +1 -1
  15. package/lib/astudio-auth.d.ts +2 -2
  16. package/lib/astudio-auth.js +2 -2
  17. package/lib/astudio-credits.d.ts +1 -1
  18. package/lib/astudio-credits.js +1 -1
  19. package/lib/astudio-product.d.ts +21 -6
  20. package/lib/astudio-product.d.ts.map +1 -1
  21. package/lib/astudio-product.js +22 -7
  22. package/lib/astudio-product.js.map +1 -1
  23. package/lib/astudio.d.ts +3 -3
  24. package/lib/astudio.js +3 -3
  25. package/lib/auto-adapter.d.ts +6 -1
  26. package/lib/auto-adapter.d.ts.map +1 -1
  27. package/lib/auto-adapter.js +13 -1
  28. package/lib/auto-adapter.js.map +1 -1
  29. package/lib/auto-checkin.d.ts.map +1 -1
  30. package/lib/auto-checkin.js +20 -1
  31. package/lib/auto-checkin.js.map +1 -1
  32. package/lib/baizhi-adapter.d.ts.map +1 -1
  33. package/lib/baizhi-adapter.js +38 -2
  34. package/lib/baizhi-adapter.js.map +1 -1
  35. package/lib/baizhi-messages.d.ts +43 -3
  36. package/lib/baizhi-messages.d.ts.map +1 -1
  37. package/lib/baizhi-messages.js +46 -6
  38. package/lib/baizhi-messages.js.map +1 -1
  39. package/lib/baizhi-product.d.ts +31 -2
  40. package/lib/baizhi-product.d.ts.map +1 -1
  41. package/lib/baizhi-product.js +71 -18
  42. package/lib/baizhi-product.js.map +1 -1
  43. package/lib/baizhi.d.ts.map +1 -1
  44. package/lib/baizhi.js +2 -0
  45. package/lib/baizhi.js.map +1 -1
  46. package/lib/buddy-balance-rank.d.ts +42 -0
  47. package/lib/buddy-balance-rank.d.ts.map +1 -1
  48. package/lib/buddy-balance-rank.js +42 -0
  49. package/lib/buddy-balance-rank.js.map +1 -1
  50. package/lib/buddy-balance-selector.d.ts +15 -0
  51. package/lib/buddy-balance-selector.d.ts.map +1 -1
  52. package/lib/buddy-balance-selector.js +18 -3
  53. package/lib/buddy-balance-selector.js.map +1 -1
  54. package/lib/canonical-models.d.ts.map +1 -1
  55. package/lib/canonical-models.js +6 -0
  56. package/lib/canonical-models.js.map +1 -1
  57. package/lib/chromium-session.d.ts +35 -0
  58. package/lib/chromium-session.d.ts.map +1 -1
  59. package/lib/chromium-session.js +47 -1
  60. package/lib/chromium-session.js.map +1 -1
  61. package/lib/client/jet-hub.js +118 -52
  62. package/lib/credential-resolver.d.ts +10 -0
  63. package/lib/credential-resolver.d.ts.map +1 -1
  64. package/lib/credential-resolver.js +7 -1
  65. package/lib/credential-resolver.js.map +1 -1
  66. package/lib/credits.d.ts +22 -0
  67. package/lib/credits.d.ts.map +1 -1
  68. package/lib/credits.js.map +1 -1
  69. package/lib/index.d.ts.map +1 -1
  70. package/lib/index.js +104 -9
  71. package/lib/index.js.map +1 -1
  72. package/lib/jet-hub-rpc.d.ts +10 -0
  73. package/lib/jet-hub-rpc.d.ts.map +1 -1
  74. package/lib/jet-hub-rpc.js +306 -5
  75. package/lib/jet-hub-rpc.js.map +1 -1
  76. package/lib/jet-hub-store.d.ts +49 -0
  77. package/lib/jet-hub-store.d.ts.map +1 -1
  78. package/lib/jet-hub-store.js +50 -0
  79. package/lib/jet-hub-store.js.map +1 -1
  80. package/lib/loomy-balance-rank.d.ts +26 -0
  81. package/lib/loomy-balance-rank.d.ts.map +1 -1
  82. package/lib/loomy-balance-rank.js +29 -0
  83. package/lib/loomy-balance-rank.js.map +1 -1
  84. package/lib/loomy-balance-selector.d.ts.map +1 -1
  85. package/lib/loomy-balance-selector.js +6 -2
  86. package/lib/loomy-balance-selector.js.map +1 -1
  87. package/lib/magicrew-adapter.d.ts.map +1 -1
  88. package/lib/magicrew-adapter.js +6 -7
  89. package/lib/magicrew-adapter.js.map +1 -1
  90. package/lib/magicrew-auth.d.ts.map +1 -1
  91. package/lib/magicrew-auth.js +7 -4
  92. package/lib/magicrew-auth.js.map +1 -1
  93. package/lib/magicrew-catalog.d.ts +6 -0
  94. package/lib/magicrew-catalog.d.ts.map +1 -1
  95. package/lib/magicrew-catalog.js +8 -4
  96. package/lib/magicrew-catalog.js.map +1 -1
  97. package/lib/magicrew-credits.d.ts.map +1 -1
  98. package/lib/magicrew-credits.js +34 -18
  99. package/lib/magicrew-credits.js.map +1 -1
  100. package/lib/magicrew-product.d.ts +40 -0
  101. package/lib/magicrew-product.d.ts.map +1 -1
  102. package/lib/magicrew-product.js +41 -0
  103. package/lib/magicrew-product.js.map +1 -1
  104. package/lib/magicrew-profile.d.ts.map +1 -1
  105. package/lib/magicrew-profile.js +8 -4
  106. package/lib/magicrew-profile.js.map +1 -1
  107. package/lib/marvis-adapter.d.ts +142 -0
  108. package/lib/marvis-adapter.d.ts.map +1 -0
  109. package/lib/marvis-adapter.js +335 -0
  110. package/lib/marvis-adapter.js.map +1 -0
  111. package/lib/marvis-auth.d.ts +188 -0
  112. package/lib/marvis-auth.d.ts.map +1 -0
  113. package/lib/marvis-auth.js +555 -0
  114. package/lib/marvis-auth.js.map +1 -0
  115. package/lib/marvis-browser-login.d.ts +118 -0
  116. package/lib/marvis-browser-login.d.ts.map +1 -0
  117. package/lib/marvis-browser-login.js +249 -0
  118. package/lib/marvis-browser-login.js.map +1 -0
  119. package/lib/marvis-credits.d.ts +57 -0
  120. package/lib/marvis-credits.d.ts.map +1 -0
  121. package/lib/marvis-credits.js +182 -0
  122. package/lib/marvis-credits.js.map +1 -0
  123. package/lib/marvis-device.d.ts +23 -0
  124. package/lib/marvis-device.d.ts.map +1 -0
  125. package/lib/marvis-device.js +26 -0
  126. package/lib/marvis-device.js.map +1 -0
  127. package/lib/marvis-messages.d.ts +72 -0
  128. package/lib/marvis-messages.d.ts.map +1 -0
  129. package/lib/marvis-messages.js +79 -0
  130. package/lib/marvis-messages.js.map +1 -0
  131. package/lib/marvis-product.d.ts +134 -0
  132. package/lib/marvis-product.d.ts.map +1 -0
  133. package/lib/marvis-product.js +236 -0
  134. package/lib/marvis-product.js.map +1 -0
  135. package/lib/marvis.d.ts +186 -0
  136. package/lib/marvis.d.ts.map +1 -0
  137. package/lib/marvis.js +282 -0
  138. package/lib/marvis.js.map +1 -0
  139. package/lib/monkeycode-adapter.d.ts +11 -2
  140. package/lib/monkeycode-adapter.d.ts.map +1 -1
  141. package/lib/monkeycode-adapter.js +35 -3
  142. package/lib/monkeycode-adapter.js.map +1 -1
  143. package/lib/monkeycode-messages.d.ts +8 -0
  144. package/lib/monkeycode-messages.d.ts.map +1 -1
  145. package/lib/monkeycode-messages.js +8 -0
  146. package/lib/monkeycode-messages.js.map +1 -1
  147. package/lib/monkeycode-product.d.ts +35 -0
  148. package/lib/monkeycode-product.d.ts.map +1 -1
  149. package/lib/monkeycode-product.js +35 -8
  150. package/lib/monkeycode-product.js.map +1 -1
  151. package/lib/provider-credits.d.ts.map +1 -1
  152. package/lib/provider-credits.js +28 -0
  153. package/lib/provider-credits.js.map +1 -1
  154. package/lib/provider-expiry.d.ts.map +1 -1
  155. package/lib/provider-expiry.js +13 -0
  156. package/lib/provider-expiry.js.map +1 -1
  157. package/lib/provider-http-pool.d.ts +38 -4
  158. package/lib/provider-http-pool.d.ts.map +1 -1
  159. package/lib/provider-http-pool.js +52 -7
  160. package/lib/provider-http-pool.js.map +1 -1
  161. package/lib/provider-registry.d.ts +30 -0
  162. package/lib/provider-registry.d.ts.map +1 -1
  163. package/lib/provider-registry.js +83 -0
  164. package/lib/provider-registry.js.map +1 -1
  165. package/lib/qoder-adapter.d.ts.map +1 -1
  166. package/lib/qoder-adapter.js +8 -1
  167. package/lib/qoder-adapter.js.map +1 -1
  168. package/lib/qoder-credits.d.ts +10 -3
  169. package/lib/qoder-credits.d.ts.map +1 -1
  170. package/lib/qoder-credits.js +65 -4
  171. package/lib/qoder-credits.js.map +1 -1
  172. package/lib/types.d.ts +62 -2
  173. package/lib/types.d.ts.map +1 -1
  174. package/lib/types.js.map +1 -1
  175. package/lib/zcode-auth.d.ts.map +1 -1
  176. package/lib/zcode-auth.js +8 -1
  177. package/lib/zcode-auth.js.map +1 -1
  178. package/lib/zcode-login.d.ts.map +1 -1
  179. package/lib/zcode-login.js +5 -3
  180. package/lib/zcode-login.js.map +1 -1
  181. package/lib/zcode-transport.d.ts.map +1 -1
  182. package/lib/zcode-transport.js +3 -1
  183. package/lib/zcode-transport.js.map +1 -1
  184. package/lib/zcode-upstream.d.ts.map +1 -1
  185. package/lib/zcode-upstream.js +19 -8
  186. package/lib/zcode-upstream.js.map +1 -1
  187. package/package.json +2 -1
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Marvis 的设备 guid。
3
+ *
4
+ * ## 为什么每次登录都**新造**一个随机 guid
5
+ *
6
+ * Marvis 的 access token 与**设备 guid 绑定**(`Ual-Access-Guid` 是登录态校验
7
+ * 的一部分)。若所有账号共用本机 guid,「登录第二个 QQ 号」会让第一个号的
8
+ * token 立刻失效 —— 用户看到的是「刚登好的号又掉了」。⇒ 每次登录新造一个
9
+ * 随机 guid,让每个账号各自拥有一个虚拟设备。
10
+ *
11
+ * ## 为什么**不**读本机 svid
12
+ *
13
+ * 读过一版 `HKCU\SOFTWARE\Tencent\Marvis\Env\svid` + `md5(host|user|marvis)`
14
+ * 的「稳定设备 id」,但它在产品上**没有落点**:多账号场景下共用本机 svid 正是
15
+ * 上面那个顶号问题,而「从桌面客户端导入」这条路径我们只导凭据、不导设备身份。
16
+ * ⇒ 2026-11-09 整支评审 M1:整段删除(含 16 条只守护不可达代码的用例),
17
+ * 只留真正在用的随机 guid。
18
+ *
19
+ * @module src/marvis-device.ts
20
+ */
21
+ /** 新设备 guid(32 位小写 hex,与 Marvis 自己签发的 svid 同形)。 */
22
+ export declare function newMarvisDeviceGuid(): string;
23
+ //# sourceMappingURL=marvis-device.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"marvis-device.d.ts","sourceRoot":"","sources":["../src/marvis-device.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,mDAAmD;AACnD,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Marvis 的设备 guid。
3
+ *
4
+ * ## 为什么每次登录都**新造**一个随机 guid
5
+ *
6
+ * Marvis 的 access token 与**设备 guid 绑定**(`Ual-Access-Guid` 是登录态校验
7
+ * 的一部分)。若所有账号共用本机 guid,「登录第二个 QQ 号」会让第一个号的
8
+ * token 立刻失效 —— 用户看到的是「刚登好的号又掉了」。⇒ 每次登录新造一个
9
+ * 随机 guid,让每个账号各自拥有一个虚拟设备。
10
+ *
11
+ * ## 为什么**不**读本机 svid
12
+ *
13
+ * 读过一版 `HKCU\SOFTWARE\Tencent\Marvis\Env\svid` + `md5(host|user|marvis)`
14
+ * 的「稳定设备 id」,但它在产品上**没有落点**:多账号场景下共用本机 svid 正是
15
+ * 上面那个顶号问题,而「从桌面客户端导入」这条路径我们只导凭据、不导设备身份。
16
+ * ⇒ 2026-11-09 整支评审 M1:整段删除(含 16 条只守护不可达代码的用例),
17
+ * 只留真正在用的随机 guid。
18
+ *
19
+ * @module src/marvis-device.ts
20
+ */
21
+ import { randomBytes } from 'node:crypto';
22
+ /** 新设备 guid(32 位小写 hex,与 Marvis 自己签发的 svid 同形)。 */
23
+ export function newMarvisDeviceGuid() {
24
+ return randomBytes(16).toString('hex');
25
+ }
26
+ //# sourceMappingURL=marvis-device.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"marvis-device.js","sourceRoot":"","sources":["../src/marvis-device.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,mDAAmD;AACnD,MAAM,UAAU,mBAAmB;IACjC,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxC,CAAC"}
@@ -0,0 +1,72 @@
1
+ /**
2
+ * 腾讯 Marvis 的 chat 请求体构造。
3
+ *
4
+ * ## 为什么单独成文件
5
+ *
6
+ * 工具必须包装成 `{type:'function', function:{...}}` —— 本仓 2026-10-07 的
7
+ * 真实事故(modelscope 逐字相同):原样透传 DSH 的扁平 schema 会让上游回
8
+ * `400 'type' is a required property - 'tools.0'`,而 DSH **每轮都带工具**,
9
+ * 于是「一次都没请求成功」且反代把它当上游不可用静默跳过。
10
+ *
11
+ * 消息序列化复用共享的 `serializeMessages`(纯协议转换、无厂商差异);
12
+ * 只有**工具包装**与**字段白名单**是厂商特有的形状门禁,故在此独立成文件。
13
+ *
14
+ * ## 与 modelscope 的两处差异(都是 Marvis 特有)
15
+ *
16
+ * 1. **`stream_options: { include_usage: true }` 恒带**:Marvis 的 SSE 只有
17
+ * 在请求里声明它时才会在末帧下发 `usage`(2026-11-09 实测),而账本
18
+ * (`wrapAdapterWithTokenLedger`)没有 `usage` 就记 0。
19
+ * 2. **不发 `reasoning_effort` 之外的思考参数**:Marvis 的思考默认开启,
20
+ * `none` 才真正关闭(实测 `reasoning_tokens=0`);但目录**刻意不声明**
21
+ * `reasoning.efforts`(用户裁定「抄 magpie」),所以正常情况下这个字段
22
+ * 不会出现 —— 保留透传只是为了「若将来声明了档位就必须真的发出去」
23
+ * (IKJJ0V:声明了却不发 = 选择器是 UI 装饰)。
24
+ *
25
+ * @module src/marvis-messages.ts
26
+ */
27
+ /** DSH 的工具 schema(`GenerateOptions.tools` 的形状)。 */
28
+ export interface MarvisHarnessTool {
29
+ name: string;
30
+ description: string;
31
+ parameters?: Record<string, unknown>;
32
+ }
33
+ /** OpenAI wire 侧的工具定义。 */
34
+ export interface MarvisWireTool {
35
+ type: 'function';
36
+ function: {
37
+ name: string;
38
+ description?: string;
39
+ parameters?: Record<string, unknown>;
40
+ };
41
+ }
42
+ /**
43
+ * DSH 工具 → wire 工具。
44
+ *
45
+ * ⚠️ 这是 `options.tools` 的**唯一出口**。不下发它,模型在 wire 上看不到任何
46
+ * 函数定义,只能用正文里的 XML 臆造工具调用。
47
+ */
48
+ export declare function buildMarvisTools(tools: readonly MarvisHarnessTool[] | undefined): MarvisWireTool[];
49
+ export interface MarvisPayloadInput {
50
+ model: string;
51
+ messages: ReadonlyArray<Record<string, unknown>>;
52
+ system?: string;
53
+ tools?: readonly MarvisHarnessTool[];
54
+ temperature?: number;
55
+ maxTokens?: number;
56
+ /** 思考档位(`GenerateOptions.reasoningEffort` 的字符串形态)。 */
57
+ reasoningEffort?: string;
58
+ }
59
+ /**
60
+ * 构造一次 chat 请求的完整 body。
61
+ *
62
+ * 契约细节(每条都对齐仓库既有适配器):
63
+ * - `stream` **恒 true**:本适配器只走 SSE 路径;
64
+ * - `stream_options` **恒带** `include_usage`(见模块头);
65
+ * - `system` 只有非空才带;
66
+ * - `max_tokens` 只放行安全正整数 —— 0 / 负数 / NaN 会让 DSH 侧抛
67
+ * `INVALID_MODEL_MAX_TOKENS`,整轮崩;
68
+ * - `tools` **恒带**(哪怕空数组);
69
+ * - `reasoning_effort` 只有非空字符串才带(非法值上游 400 `3000101`)。
70
+ */
71
+ export declare function buildMarvisPayload(input: MarvisPayloadInput): Record<string, unknown>;
72
+ //# sourceMappingURL=marvis-messages.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"marvis-messages.d.ts","sourceRoot":"","sources":["../src/marvis-messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,0BAA0B;AAC1B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CACvF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,GAC9C,cAAc,EAAE,CAalB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAChD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBrF"}
@@ -0,0 +1,79 @@
1
+ /**
2
+ * 腾讯 Marvis 的 chat 请求体构造。
3
+ *
4
+ * ## 为什么单独成文件
5
+ *
6
+ * 工具必须包装成 `{type:'function', function:{...}}` —— 本仓 2026-10-07 的
7
+ * 真实事故(modelscope 逐字相同):原样透传 DSH 的扁平 schema 会让上游回
8
+ * `400 'type' is a required property - 'tools.0'`,而 DSH **每轮都带工具**,
9
+ * 于是「一次都没请求成功」且反代把它当上游不可用静默跳过。
10
+ *
11
+ * 消息序列化复用共享的 `serializeMessages`(纯协议转换、无厂商差异);
12
+ * 只有**工具包装**与**字段白名单**是厂商特有的形状门禁,故在此独立成文件。
13
+ *
14
+ * ## 与 modelscope 的两处差异(都是 Marvis 特有)
15
+ *
16
+ * 1. **`stream_options: { include_usage: true }` 恒带**:Marvis 的 SSE 只有
17
+ * 在请求里声明它时才会在末帧下发 `usage`(2026-11-09 实测),而账本
18
+ * (`wrapAdapterWithTokenLedger`)没有 `usage` 就记 0。
19
+ * 2. **不发 `reasoning_effort` 之外的思考参数**:Marvis 的思考默认开启,
20
+ * `none` 才真正关闭(实测 `reasoning_tokens=0`);但目录**刻意不声明**
21
+ * `reasoning.efforts`(用户裁定「抄 magpie」),所以正常情况下这个字段
22
+ * 不会出现 —— 保留透传只是为了「若将来声明了档位就必须真的发出去」
23
+ * (IKJJ0V:声明了却不发 = 选择器是 UI 装饰)。
24
+ *
25
+ * @module src/marvis-messages.ts
26
+ */
27
+ /**
28
+ * DSH 工具 → wire 工具。
29
+ *
30
+ * ⚠️ 这是 `options.tools` 的**唯一出口**。不下发它,模型在 wire 上看不到任何
31
+ * 函数定义,只能用正文里的 XML 臆造工具调用。
32
+ */
33
+ export function buildMarvisTools(tools) {
34
+ if (tools === undefined || tools.length === 0)
35
+ return [];
36
+ return tools.map((tool) => ({
37
+ type: 'function',
38
+ function: {
39
+ name: tool.name,
40
+ // ⚠️ 空描述**整个省略**(不是发空串):与 `openai-compat` 同口径。
41
+ ...(typeof tool.description === 'string' && tool.description.length > 0
42
+ ? { description: tool.description }
43
+ : {}),
44
+ ...(tool.parameters === undefined ? {} : { parameters: tool.parameters }),
45
+ },
46
+ }));
47
+ }
48
+ /**
49
+ * 构造一次 chat 请求的完整 body。
50
+ *
51
+ * 契约细节(每条都对齐仓库既有适配器):
52
+ * - `stream` **恒 true**:本适配器只走 SSE 路径;
53
+ * - `stream_options` **恒带** `include_usage`(见模块头);
54
+ * - `system` 只有非空才带;
55
+ * - `max_tokens` 只放行安全正整数 —— 0 / 负数 / NaN 会让 DSH 侧抛
56
+ * `INVALID_MODEL_MAX_TOKENS`,整轮崩;
57
+ * - `tools` **恒带**(哪怕空数组);
58
+ * - `reasoning_effort` 只有非空字符串才带(非法值上游 400 `3000101`)。
59
+ */
60
+ export function buildMarvisPayload(input) {
61
+ return {
62
+ model: input.model,
63
+ messages: input.messages,
64
+ stream: true,
65
+ stream_options: { include_usage: true },
66
+ tools: buildMarvisTools(input.tools),
67
+ ...(input.system !== undefined && input.system.length > 0 ? { system: input.system } : {}),
68
+ ...(typeof input.temperature === 'number' && Number.isFinite(input.temperature)
69
+ ? { temperature: input.temperature }
70
+ : {}),
71
+ ...(Number.isSafeInteger(input.maxTokens) && (input.maxTokens ?? 0) > 0
72
+ ? { max_tokens: input.maxTokens }
73
+ : {}),
74
+ ...(typeof input.reasoningEffort === 'string' && input.reasoningEffort.length > 0
75
+ ? { reasoning_effort: input.reasoningEffort }
76
+ : {}),
77
+ };
78
+ }
79
+ //# sourceMappingURL=marvis-messages.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"marvis-messages.js","sourceRoot":"","sources":["../src/marvis-messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAeH;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAA+C;IAE/C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACxD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,UAAmB;QACzB,QAAQ,EAAE;YACR,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,+CAA+C;YAC/C,GAAG,CAAC,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;gBACrE,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;gBACnC,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;SAC1E;KACF,CAAC,CAAC,CAAA;AACL,CAAC;AAaD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAyB;IAC1D,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,IAAI;QACZ,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE;QACvC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC;QACpC,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,GAAG,CAAC,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC;YAC7E,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE;YACpC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC;YACrE,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE;YACjC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;YAC/E,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,eAAe,EAAE;YAC7C,CAAC,CAAC,EAAE,CAAC;KACR,CAAA;AACH,CAAC"}
@@ -0,0 +1,134 @@
1
+ /**
2
+ * 腾讯 Marvis 的产品常量、静态目录与错误分类。
3
+ *
4
+ * ## 为什么目录只有一条
5
+ *
6
+ * 2026-11-09 在本机真实账号(QQ·Jet)上实测了 magpie-marvis 的整张槽位表:
7
+ * 每一个槽位都能跑通推理(`hy3-preview-agent`、`claude-sonnet-4-6` 等),
8
+ * 但**用户明确裁定只暴露 `main-auto`**——它由服务端自动路由到
9
+ * `deepseek-v4-1-flash-261017`(响应体 `model` 字段可证),其余槽位属于
10
+ * Marvis 自己的产品线,与本插件的「一个渠道 = 一个可预期模型」定位不符。
11
+ *
12
+ * ⚠️ 因此本文件**不**是「上游目录的镜像」,而是**产品决策**:
13
+ * 想加回别的槽位要先问清楚它是不是真模型(`claude-*` 那几个在本账号下
14
+ * 实测 **400 `4130001 无效模型id`**,即该账号根本没授权)。
15
+ *
16
+ * ## 为什么没有远端目录端点
17
+ *
18
+ * 实测 9 个候选端点全部 404(`/v1/models`、`/v3/marvis_get_models`、
19
+ * `/v3/marvis_get_model_list`、`/v3/marvis_models`、`/v1/model/list` …),
20
+ * 且 magpie 自己也只用静态表 ⇒ 目录**只能**静态兜底,不需要远端拉取。
21
+ *
22
+ * @module marvis-product
23
+ */
24
+ /** 产品常量。 */
25
+ export interface MarvisProduct {
26
+ /** provider id(必须纯小写字母,`provider-registry.spec.ts` 逐条断言)。 */
27
+ readonly id: 'marvis';
28
+ /** 左栏展示名(必须与客户端 `PROVIDERS` 里 `marvis` 的 `label` 逐字一致)。 */
29
+ readonly displayName: string;
30
+ /** OpenAI 兼容 base URL(**含 `/v1`**,不带尾斜杠)。 */
31
+ readonly baseUrl: string;
32
+ /** 对话端点(拼在 baseUrl 之后)。 */
33
+ readonly chatPath: string;
34
+ /** 钱包端点(拼在 baseUrl 之后;与推理**同 host**)。 */
35
+ readonly balancePath: string;
36
+ /** 续期端点(拼在 baseUrl 之后)。 */
37
+ readonly refreshPath: string;
38
+ /** 等首个 token 的空闲超时(毫秒)。 */
39
+ readonly chatHeaderTimeoutMs: number;
40
+ /** 两次 chunk 之间的空闲超时(毫秒)。 */
41
+ readonly chunkTimeoutMs: number;
42
+ /** 兜底目录的超时(毫秒)—— 本家无远端目录,保留字段与家族同构。 */
43
+ readonly catalogTimeoutMs: number;
44
+ /** 钱包请求超时(毫秒)。 */
45
+ readonly balanceTimeoutMs: number;
46
+ /** 默认凭据引用前缀。 */
47
+ readonly defaultCredentialRef: string;
48
+ }
49
+ export declare const MARVIS: MarvisProduct;
50
+ /** 兜底目录条目。 */
51
+ export interface MarvisFallbackModel {
52
+ /** 上游槽位 id(**不是**真实模型 id —— 真实 id 直传会 400)。 */
53
+ readonly id: string;
54
+ /** 展示名(美化名)。 */
55
+ readonly name: string;
56
+ /**
57
+ * 上下文窗口。
58
+ *
59
+ * ⚠️ `0` 是「**不知道**」哨兵 ⇒ `resolveModel` 判 `> 0` 才下发 `context`。
60
+ * 本家 magpie 表口径是 1,000,000;实测只验证到 18k(36k 汉字),
61
+ * 但这只是「没测到上界」,不是「上界是 18k」。
62
+ */
63
+ readonly contextWindow: number;
64
+ readonly supportsImage: boolean;
65
+ }
66
+ /**
67
+ * 唯一的目录条目。
68
+ *
69
+ * ⚠️ 显示名是**产品决策**(用户要求「映射被 ds v4.1 flash 的美化名字」),
70
+ * 不是上游下发的名字 —— 上游只回真实模型 id `deepseek-v4-1-flash-261017`。
71
+ */
72
+ /**
73
+ * ⚠️ **刻意不声明 `maxTokens`**(2026-11-09 评审 M4 的定案,不是遗漏)。
74
+ *
75
+ * magpie 的 `DEFAULT_OUTPUT = 32_000` 是**它自己**给 OpenAI SDK 用的默认值:
76
+ * 它每一发都显式写 `max_tokens`。我们这边不写 —— 理由与 codearts 同向
77
+ * (`src/models.ts:105-124`):出站预算由宿主 `GenerateOptions.maxTokens`
78
+ * 决定,模型能力不在目录里硬编一个数,免得「用户设 128k、插件偷偷改成 32k」。
79
+ *
80
+ * 实测(2026-11-09 wire):32_000 / 65_536 / 131_072 / 1_000_000 全 200,
81
+ * 上游不校验上界;`max_tokens` 缺席时走上游默认值,正文正常。
82
+ * ⇒ 这里**不**写 `MARVIS_DEFAULT_OUTPUT`,也不要「补上」它。
83
+ */
84
+ export declare const MARVIS_FALLBACK_MODELS: readonly MarvisFallbackModel[];
85
+ export declare function findMarvisFallback(modelId: string): MarvisFallbackModel | undefined;
86
+ /**
87
+ * 把用户可能持久化过的各种写法归一成槽位 id。
88
+ *
89
+ * ⚠️ 为什么需要它:magpie 早先把**数组下标**写进过配置(`MODEL_ALIASES`
90
+ * 的 `"0".."7"`),而响应体里的 **真实模型 id** 也常被用户直接粘进模型字段
91
+ * ——两者都不是合法槽位。真实 id 直传上游会 400 `4130001 无效模型id`,
92
+ * 但**静默替换成别的模型更糟**(用户以为在跟 A 说话,实际是 B)。
93
+ * 故只归一**确知等价**的两种写法,其余原样交给上游判错。
94
+ */
95
+ export declare function normalizeMarvisModelId(model: string): string;
96
+ /** 错误分类(**语义**,不是 LlmError 码)。 */
97
+ export type MarvisErrorKind = 'rate_limit' | 'quota' | 'auth' | 'risk' | 'server' | 'transport' | 'invalid_request' | 'context_window' | 'model_unavailable';
98
+ export interface MarvisErrorInfo {
99
+ kind: MarvisErrorKind;
100
+ /** 服务端要求的等待时长(毫秒);仅限流类产出。 */
101
+ retryAfterMs?: number;
102
+ /** 面向用户的可读描述(**禁止**裸 JSON)。 */
103
+ detail: string;
104
+ }
105
+ /**
106
+ * 把一次失败的 HTTP 响应归类为语义化错误。
107
+ *
108
+ * ## ⚠️ 顺序即优先级(每一条都来自真机实测)
109
+ *
110
+ * 1. **上下文超限**(按报文关键词)——必须最先,否则 `exceed` 会被 quota 抢走、
111
+ * `throttl` 会被 rate_limit 抢走 ⇒ 用户只是发了一条超长消息,
112
+ * 却把整个账号封到次日零点(本仓 loomy/modelscope 同型事故)。
113
+ * 2. **业务码 4100403 / HTTP 401 ⇒ auth**:它可能以 **HTTP 200** 下发
114
+ * (实测如此)⇒ 只看状态码会漏判。
115
+ * 3. **业务码 4100404 / HTTP 403 ⇒ risk**:风控,不是账号态。
116
+ * 4. 429 / 限流文案 ⇒ rate_limit(`retry-after` 原样保留,`0` 合法)。
117
+ * 5. 402 / 额度文案 ⇒ quota。
118
+ * 6. **业务码 4130001(无效模型id)/ 4100402 / HTTP 404 ⇒ model_unavailable**
119
+ * ——必须排在 400 之前,否则「该账号没开通这个模型」会被当成「用户的请求写错了」
120
+ * 而永不换号。
121
+ * 7. 400 / 422 ⇒ invalid_request。
122
+ * 8. status 0 / 传输层文案 ⇒ transport。
123
+ * 9. >= 500(含 `5104002` RPC 报错)⇒ server。
124
+ */
125
+ export declare function classifyMarvisError(status: number, body: string, headers?: Readonly<Record<string, string>>): MarvisErrorInfo;
126
+ /**
127
+ * 语义分类 → 宿主 `LlmError.code`。
128
+ *
129
+ * ⚠️ 额度/限流/认证必须用**字面量**:harness 的 `QUOTA_EXCEEDED_CODE`
130
+ * 字面值是 `'QUOTA'`,客户端会据此把 message 换成固定文案
131
+ * ⇒ 用错字面量会让「额度用尽」被渲染成别的错误(Issue IKJVCW)。
132
+ */
133
+ export declare function marvisErrorKindCode(kind: MarvisErrorKind): string;
134
+ //# sourceMappingURL=marvis-product.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"marvis-product.d.ts","sourceRoot":"","sources":["../src/marvis-product.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,YAAY;AACZ,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,4BAA4B;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,kBAAkB;IAClB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,gBAAgB;IAChB,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;CACtC;AAED,eAAO,MAAM,MAAM,EAAE,aAYpB,CAAA;AAED,cAAc;AACd,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAChC;AAED;;;;;GAKG;AACH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,mBAAmB,EAUhE,CAAA;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAEnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED,kCAAkC;AAClC,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,OAAO,GACP,MAAM,GAGN,MAAM,GACN,QAAQ,GACR,WAAW,GACX,iBAAiB,GACjB,gBAAgB,GAEhB,mBAAmB,CAAA;AAEvB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAA;IACrB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAA;CACf;AAqCD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACzC,eAAe,CAqEjB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAuBjE"}
@@ -0,0 +1,236 @@
1
+ /**
2
+ * 腾讯 Marvis 的产品常量、静态目录与错误分类。
3
+ *
4
+ * ## 为什么目录只有一条
5
+ *
6
+ * 2026-11-09 在本机真实账号(QQ·Jet)上实测了 magpie-marvis 的整张槽位表:
7
+ * 每一个槽位都能跑通推理(`hy3-preview-agent`、`claude-sonnet-4-6` 等),
8
+ * 但**用户明确裁定只暴露 `main-auto`**——它由服务端自动路由到
9
+ * `deepseek-v4-1-flash-261017`(响应体 `model` 字段可证),其余槽位属于
10
+ * Marvis 自己的产品线,与本插件的「一个渠道 = 一个可预期模型」定位不符。
11
+ *
12
+ * ⚠️ 因此本文件**不**是「上游目录的镜像」,而是**产品决策**:
13
+ * 想加回别的槽位要先问清楚它是不是真模型(`claude-*` 那几个在本账号下
14
+ * 实测 **400 `4130001 无效模型id`**,即该账号根本没授权)。
15
+ *
16
+ * ## 为什么没有远端目录端点
17
+ *
18
+ * 实测 9 个候选端点全部 404(`/v1/models`、`/v3/marvis_get_models`、
19
+ * `/v3/marvis_get_model_list`、`/v3/marvis_models`、`/v1/model/list` …),
20
+ * 且 magpie 自己也只用静态表 ⇒ 目录**只能**静态兜底,不需要远端拉取。
21
+ *
22
+ * @module marvis-product
23
+ */
24
+ import { MARVIS_BASE_URL } from './marvis.js';
25
+ import { retryAfterMsFromRecord } from './retry-after.js';
26
+ export const MARVIS = {
27
+ id: 'marvis',
28
+ displayName: '腾讯 Marvis',
29
+ baseUrl: MARVIS_BASE_URL,
30
+ chatPath: '/v1/chat/completions',
31
+ balancePath: '/v3/marvis_get_wallet',
32
+ refreshPath: '/marvis_client_login/marvis_refresh_token',
33
+ chatHeaderTimeoutMs: 60_000,
34
+ chunkTimeoutMs: 120_000,
35
+ catalogTimeoutMs: 15_000,
36
+ balanceTimeoutMs: 15_000,
37
+ defaultCredentialRef: 'MARVIS_ACCOUNT_DEFAULT',
38
+ };
39
+ /**
40
+ * 唯一的目录条目。
41
+ *
42
+ * ⚠️ 显示名是**产品决策**(用户要求「映射被 ds v4.1 flash 的美化名字」),
43
+ * 不是上游下发的名字 —— 上游只回真实模型 id `deepseek-v4-1-flash-261017`。
44
+ */
45
+ /**
46
+ * ⚠️ **刻意不声明 `maxTokens`**(2026-11-09 评审 M4 的定案,不是遗漏)。
47
+ *
48
+ * magpie 的 `DEFAULT_OUTPUT = 32_000` 是**它自己**给 OpenAI SDK 用的默认值:
49
+ * 它每一发都显式写 `max_tokens`。我们这边不写 —— 理由与 codearts 同向
50
+ * (`src/models.ts:105-124`):出站预算由宿主 `GenerateOptions.maxTokens`
51
+ * 决定,模型能力不在目录里硬编一个数,免得「用户设 128k、插件偷偷改成 32k」。
52
+ *
53
+ * 实测(2026-11-09 wire):32_000 / 65_536 / 131_072 / 1_000_000 全 200,
54
+ * 上游不校验上界;`max_tokens` 缺席时走上游默认值,正文正常。
55
+ * ⇒ 这里**不**写 `MARVIS_DEFAULT_OUTPUT`,也不要「补上」它。
56
+ */
57
+ export const MARVIS_FALLBACK_MODELS = [
58
+ {
59
+ id: 'main-auto',
60
+ name: 'DeepSeek V4.1 Flash',
61
+ contextWindow: 1_000_000,
62
+ // 2026-11-09 实测:main-auto 收 `{type:'image_url',image_url:{url:'data:image/png;base64,…'}}`
63
+ // 并正确答出颜色 ⇒ 真能读图(与 codearts 的 `deepseek-v4.1-flash` 同款结论:
64
+ // **目录标的 false 不可信**,以 wire 实测为准)。
65
+ supportsImage: true,
66
+ },
67
+ ];
68
+ export function findMarvisFallback(modelId) {
69
+ return MARVIS_FALLBACK_MODELS.find((m) => m.id === modelId);
70
+ }
71
+ /**
72
+ * 把用户可能持久化过的各种写法归一成槽位 id。
73
+ *
74
+ * ⚠️ 为什么需要它:magpie 早先把**数组下标**写进过配置(`MODEL_ALIASES`
75
+ * 的 `"0".."7"`),而响应体里的 **真实模型 id** 也常被用户直接粘进模型字段
76
+ * ——两者都不是合法槽位。真实 id 直传上游会 400 `4130001 无效模型id`,
77
+ * 但**静默替换成别的模型更糟**(用户以为在跟 A 说话,实际是 B)。
78
+ * 故只归一**确知等价**的两种写法,其余原样交给上游判错。
79
+ */
80
+ export function normalizeMarvisModelId(model) {
81
+ const trimmed = model.trim();
82
+ // ⚠️ **大小写不敏感**(2026-11-10 对抗性审计 I6):`MAIN-AUTO` / `Main-Auto`
83
+ // 原样透传会目录未命中 ⇒ 静默退化成「未知模型」(text-only、无上下文、
84
+ // 无图片能力),而且**不报错** —— 用户只会发现「图发不出去了」。
85
+ const lower = trimmed.toLowerCase();
86
+ if (lower === '0')
87
+ return 'main-auto';
88
+ if (lower === 'deepseek-v4-1-flash-261017')
89
+ return 'main-auto';
90
+ if (lower === 'main-auto')
91
+ return 'main-auto';
92
+ return trimmed;
93
+ }
94
+ /** 从错误体里抽出人可读片段(禁止把整坨 JSON 抛给用户)。 */
95
+ function readableDetail(body) {
96
+ const text = body.trim();
97
+ if (text === '')
98
+ return '(上游未返回错误详情)';
99
+ try {
100
+ const data = JSON.parse(text);
101
+ const nested = typeof data.error === 'object' && data.error !== null
102
+ ? data.error.message
103
+ : data.error;
104
+ const parts = [data.msg, data.message, nested].filter((v) => typeof v === 'string' && v.length > 0);
105
+ if (parts.length > 0)
106
+ return parts.join(' ');
107
+ }
108
+ catch {
109
+ // 非 JSON:直接截断原文
110
+ }
111
+ return text.length > 500 ? `${text.slice(0, 500)}…` : text;
112
+ }
113
+ /** 从响应体里抽 Marvis 的业务码(`{"code":4100403,...}`)。 */
114
+ function businessCodeOf(body) {
115
+ try {
116
+ const data = JSON.parse(body);
117
+ if (typeof data.code === 'number' && Number.isFinite(data.code))
118
+ return data.code;
119
+ if (typeof data.code === 'string' && data.code.trim() !== '') {
120
+ const parsed = Number(data.code);
121
+ return Number.isFinite(parsed) ? parsed : undefined;
122
+ }
123
+ }
124
+ catch {
125
+ // 非 JSON
126
+ }
127
+ return undefined;
128
+ }
129
+ /**
130
+ * 把一次失败的 HTTP 响应归类为语义化错误。
131
+ *
132
+ * ## ⚠️ 顺序即优先级(每一条都来自真机实测)
133
+ *
134
+ * 1. **上下文超限**(按报文关键词)——必须最先,否则 `exceed` 会被 quota 抢走、
135
+ * `throttl` 会被 rate_limit 抢走 ⇒ 用户只是发了一条超长消息,
136
+ * 却把整个账号封到次日零点(本仓 loomy/modelscope 同型事故)。
137
+ * 2. **业务码 4100403 / HTTP 401 ⇒ auth**:它可能以 **HTTP 200** 下发
138
+ * (实测如此)⇒ 只看状态码会漏判。
139
+ * 3. **业务码 4100404 / HTTP 403 ⇒ risk**:风控,不是账号态。
140
+ * 4. 429 / 限流文案 ⇒ rate_limit(`retry-after` 原样保留,`0` 合法)。
141
+ * 5. 402 / 额度文案 ⇒ quota。
142
+ * 6. **业务码 4130001(无效模型id)/ 4100402 / HTTP 404 ⇒ model_unavailable**
143
+ * ——必须排在 400 之前,否则「该账号没开通这个模型」会被当成「用户的请求写错了」
144
+ * 而永不换号。
145
+ * 7. 400 / 422 ⇒ invalid_request。
146
+ * 8. status 0 / 传输层文案 ⇒ transport。
147
+ * 9. >= 500(含 `5104002` RPC 报错)⇒ server。
148
+ */
149
+ export function classifyMarvisError(status, body, headers) {
150
+ const retryAfterMs = retryAfterMsFromRecord(headers);
151
+ const detail = readableDetail(body);
152
+ const lower = body.toLowerCase();
153
+ const code = businessCodeOf(body);
154
+ // ① 上下文超限(文本判据,先于一切)
155
+ if (lower.includes('context length')
156
+ || lower.includes('context window')
157
+ || (lower.includes('context') && lower.includes('limit'))
158
+ || lower.includes('context_length_exceeded')
159
+ || lower.includes('reduce the length')
160
+ || lower.includes('too many tokens')
161
+ || lower.includes('input tokens exceed')) {
162
+ return { kind: 'context_window', detail };
163
+ }
164
+ // ② 认证(业务码先于状态码:实测可能 HTTP 200)
165
+ if (code === 4100403 || status === 401)
166
+ return { kind: 'auth', detail };
167
+ // ③ 风控(4100404 实测是 403;不按文案抢判,避免「登录」二字把风控误判成 auth)
168
+ if (code === 4100404 || status === 403)
169
+ return { kind: 'risk', detail };
170
+ // ④ 限流
171
+ if (status === 429
172
+ || lower.includes('too many requests')
173
+ || lower.includes('rate limit')
174
+ || lower.includes('throttl')) {
175
+ return { kind: 'rate_limit', ...(retryAfterMs === undefined ? {} : { retryAfterMs }), detail };
176
+ }
177
+ // ⑤ 额度
178
+ if (status === 402
179
+ || lower.includes('insufficient')
180
+ || lower.includes('quota')
181
+ || lower.includes('exceed')
182
+ || lower.includes('balance')) {
183
+ return { kind: 'quota', ...(retryAfterMs === undefined ? {} : { retryAfterMs }), detail };
184
+ }
185
+ // ⑥ 模型侧不可用(必须在 400 之前)
186
+ if (code === 4130001 || code === 4100402 || status === 404) {
187
+ return { kind: 'model_unavailable', detail };
188
+ }
189
+ // ⑦ 请求非法
190
+ if (status === 400 || status === 422)
191
+ return { kind: 'invalid_request', detail };
192
+ // ⑧ 传输层
193
+ if (status === 0
194
+ || lower.includes('fetch failed')
195
+ || lower.includes('terminated')
196
+ || lower.includes('econnreset')
197
+ || lower.includes('socket hang up')
198
+ || lower.includes('getaddrinfo')
199
+ || lower.includes('econnrefused')) {
200
+ return { kind: 'transport', detail };
201
+ }
202
+ // ⑨ 服务端(含 5104002)
203
+ return { kind: 'server', detail };
204
+ }
205
+ /**
206
+ * 语义分类 → 宿主 `LlmError.code`。
207
+ *
208
+ * ⚠️ 额度/限流/认证必须用**字面量**:harness 的 `QUOTA_EXCEEDED_CODE`
209
+ * 字面值是 `'QUOTA'`,客户端会据此把 message 换成固定文案
210
+ * ⇒ 用错字面量会让「额度用尽」被渲染成别的错误(Issue IKJVCW)。
211
+ */
212
+ export function marvisErrorKindCode(kind) {
213
+ switch (kind) {
214
+ case 'auth':
215
+ return 'AUTH';
216
+ case 'risk':
217
+ // 风控的报文本身就是**唯一出路**(换网络环境),不能被 AUTH 的通用
218
+ // 文案吞掉 —— 用 PERMISSION 让原文透出。
219
+ return 'PERMISSION';
220
+ case 'rate_limit':
221
+ return 'RATE_LIMIT';
222
+ case 'quota':
223
+ return 'QUOTA_EXCEEDED';
224
+ case 'context_window':
225
+ return 'CONTEXT_WINDOW_EXCEEDED';
226
+ case 'invalid_request':
227
+ case 'model_unavailable':
228
+ // 确定性失败:重试 5 次只会拿到同一个 400。
229
+ return 'BAD_REQUEST';
230
+ case 'transport':
231
+ return 'TRANSPORT';
232
+ case 'server':
233
+ return 'SERVER';
234
+ }
235
+ }
236
+ //# sourceMappingURL=marvis-product.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"marvis-product.js","sourceRoot":"","sources":["../src/marvis-product.ts"],"names":[],"mappings":"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"}