mslxdff 0.1.231 → 0.1.232

package/src/providers/raccoon/const.js

@@ -1,202 +1,202 @@
-// raccoon（商汤小浣熊）供应商常量单一源：网关地址、客户端版本与 UA、两档思考、业务码表、兜底模型目录。
-// 端点契约调研自 Ebony-Vinyl/dsh-our-free-model 的 vendor/channel-pack/src/raccoon*.ts
-// （打包产物 pack.js 原文）并逐条本机实测：站点根 200、model_catalog 匿名 401、
-// chat/completions 匿名 401、login_with_qrcode_code 匿名 200 {"code":0,"data":{"status":"pending"}}。
-import { isEffortOff } from "../../thinking-effort.js";
-
-export const RACCOON_ORIGIN = "https://xiaohuanxiong.com";
-
-export const RACCOON_LLM_PREFIX = "/api/web/llm/v2";
-export const RACCOON_AUTH_PREFIX = "/api/web/auth/v1";
-export const RACCOON_POINTS_PREFIX = "/api/web/points/v1";
-export const RACCOON_DESKTOP_PREFIX = "/api/web/desktop/v1";
-/**
- * 新一代身份通道前缀（2026-10 上游改版实测）。
- * 扫码登录已从 `/api/web/auth/v1/login_with_qrcode_code` 迁到这里，契约完全变了：
- * code 由**服务端签发**（`qr-<uuid>`），并下发 scan_path / expires_in / poll_interval。
- * 旧的「客户端自造 code」在新通道里没有服务端会话 —— 微信扫码后查不到该码，
- * 正好表现为「二维码已过期或已被使用」，故整条扫码链路必须走新端点。
- * ⚠ 信封也不同：这套用 `code: "OK"` 而不是 `code: 0` —— 判成功一律用 isRaccoonOk()。
- */
-export const RACCOON_IAM_PREFIX = "/api/iam/v1";
-
-export const raccoonModelCatalogUrl = () => `${RACCOON_ORIGIN}${RACCOON_LLM_PREFIX}/model_catalog`;
-export const raccoonChatUrl = () => `${RACCOON_ORIGIN}${RACCOON_LLM_PREFIX}/chat/completions`;
-export const raccoonRefreshUrl = () => `${RACCOON_ORIGIN}${RACCOON_AUTH_PREFIX}/refresh`;
-/**
- * IAM 会话确认端点（2026-10-18 故障取证 + 官方前端 c6.js 实证）。
- * 上游把网页/IAM 登录的会话划入「先确认再放行」：新登录的 token 打业务端点回
- * `400 {"code":200901,"message":"iam_confirm_required"}`，先带 Bearer POST 本端点
- * （body `{}` 即可）确认会话后业务端点恢复 200。官方前端的处理同样是
- * 「撞 200901 → confirm(true) → 重试原请求」。
- */
-export const raccoonIamConfirmUrl = () => `${RACCOON_ORIGIN}${RACCOON_AUTH_PREFIX}/iam/confirm`;
-export const raccoonUserInfoUrl = () => `${RACCOON_ORIGIN}${RACCOON_AUTH_PREFIX}/user_info`;
-export const raccoonBalanceUrl = () => `${RACCOON_ORIGIN}${RACCOON_POINTS_PREFIX}/balance`;
-export const raccoonBillsUrl = (limit = 50) =>
-  `${RACCOON_ORIGIN}${RACCOON_POINTS_PREFIX}/bills?paging.limit=${Number(limit) || 50}&paging.offset=0`;
-export const raccoonLoginGrantUrl = () => `${RACCOON_ORIGIN}${RACCOON_DESKTOP_PREFIX}/login/points/grant`;
-
-/**
- * 每日积分结算触发器：`GET /api/web/office/v3/setting_info`。
- *
- * 2026-10-21 账单实测（这家的每日积分是**惰性结算**，不是签到）：
- *   · 每日积分由服务端按天挂账，**当天第一次访问这个端点时才真正入账**
- *     （此前账单里连 `daily_grant` 都没有，`balance.daily_points` 恒 0）；
- *   · 入账后 `expire_at` 直接是 T+6 的 23:59:59 —— 对应官方文案
- *     「每日积分每天 00:00 发放，默认当日 24:00 清零，**当天登录后有效期延长至 7 天**」；
- *   · 完全幂等：连打 4 次只有第一次产生账单，其余静默返回（可放心每天重试）。
- * 官方前端把这个端点挂在登录后拉设置信息的路径上，等价于「登录」这个动作本身。
- * 端点选型实测：`/auth/v1/setting_info` 404、`/setting/v1/setting_info` 404，只有 office/v3 这条通。
- */
-export const raccoonOfficeSettingUrl = () => `${RACCOON_ORIGIN}/api/web/office/v3/setting_info`;
-/**
- * 每日积分账单的 `event_name` 字面量 —— 判「今天结算过没有」只认它（`biz_type` 是 `daily_grant`）。
- * ⚠ 定位必须先按 biz_type 过滤再比 event_name：重度使用号的账单会被「对话消耗」刷满，
- *   窗口里根本翻不到那条陈旧的 grant（这是 claimRaccoonLoginReward 注释里踩过的同一个坑）。
- */
-export const RACCOON_DAILY_GRANT_EVENT_NAME = "每日积分发放";
-/** 账单分页上限实测值：一次 200 条，足够覆盖一天的重度用量（对话消耗）而仍能捞到当天的 grant。 */
-export const RACCOON_BILLS_PAGE_LIMIT = 200;
-
-/** 服务端签发二维码（POST，body 可带 `{ product_codes: [] }`）。 */
-export const raccoonQrCreateUrl = () => `${RACCOON_ORIGIN}${RACCOON_IAM_PREFIX}/auth/mp/qrcode`;
-/** 轮询扫码状态（POST，body `{ qrcode_code }`）。 */
-export const raccoonQrPollUrl = () => `${RACCOON_ORIGIN}${RACCOON_IAM_PREFIX}/auth/mp/qrcode/login`;
-/** 取消二维码（PUT，body `{ qrcode_code, status: "canceled" }`）——过期/离开页面时礼貌回收。 */
-export const raccoonQrCancelUrl = () => `${RACCOON_ORIGIN}${RACCOON_IAM_PREFIX}/auth/mp/qrcode`;
-
-/**
- * 密码登录（手机号 + 密码）—— **走官方前端同款 web 端点，参数须 AES 加密**。
- *
- * 端点选择（2026-10-18 真实账号实测三选一）：
- *   `POST /api/web/auth/v1/login_with_password`（官方前端 `loginWithPassword` 同款）
- *     → 200 `{code:0, data:{access_token, refresh_token}}` ✅ 与 refresh/chat/credits 同族，且给 refresh_token
- *   `POST /api/iam/v1/auth/login/password/phone`
- *     → 200 `{code:"OK", data:{access_token, token_type, expires_at}}` —— **无 refresh_token**，
- *       token 一过期就得重新输密码，对多号长期使用是硬伤，故弃用。
- * 两处都要求 phone/password **加密**（算法与 key 见 `crypto.js`）；明文一律回
- * `AUTH_ACCOUNT_OR_PASSWORD_INVALID`（用「密码错」的口径掩盖「格式错」，极难自查）。
- *
- * body 契约：`{ nation_code: "86", phone: <加密>, password: <加密> }`
- *   · nation_code 是**明文数字字符串**（数字 86 被判 body invalid）
- *   · phone / password 各自 Base64(IV ‖ AES-128-CFB 密文) —— 见 crypto.js
- * ⚠ 密码只在此处作为请求体出现，**绝不落盘、绝不进日志**。
- */
-export const raccoonPasswordLoginUrl = () => `${RACCOON_ORIGIN}${RACCOON_AUTH_PREFIX}/login_with_password`;
-
-/**
- * 登录参数加密 key（AES-128-CFB）。**上游公开常量**，打包在任意客户端里（app.asar 原文）。
- * 照抄它只为对齐协议；传输保密性来自 HTTPS，不来自这个 key。
- */
-export const RACCOON_PASSWORD_ENC_KEY = "senseraccoon2023";
-
-/**
- * 密码登录失败码 → 人话。命中即抛「可操作」的错误，未命中一律透出上游 message。
- * 表里只放**本机实测见过**的码，不臆造（上游加了新码就走 default 兜底透出原文）。
- *   200004                          —— web 通道（本项目所用）实测：错误密码回
- *                                      `{code:200004,message:"phone_or_password_verify_error"}`；
- *                                      该 message 是英文码不是人话，必须靠本表翻译。
- *   AUTH_ACCOUNT_OR_PASSWORD_INVALID —— IAM 通道同义码（本项目已不用该端点，保留以防回退）。
- *   COMMON_INVALID_ARGUMENT          —— 缺 nation_code/空字段实测（IAM 通道）。
- */
-export const RACCOON_PASSWORD_ERRORS = {
-  200004: "手机号或密码不正确",
-  AUTH_ACCOUNT_OR_PASSWORD_INVALID: "手机号或密码不正确",
-  COMMON_INVALID_ARGUMENT: "登录参数不完整（需要 国家码 + 手机号 + 密码）",
-};
-
-/**
- * 扫码登录深链接：终端编成二维码，**必须用微信「扫一扫」**打开确认。
- * code 与 scan_path 都由 `POST /auth/mp/qrcode` 下发（scan_path 实测为 `/login/mp`），
- * 形如 `https://xiaohuanxiong.com/login/mp?code=qr-xxxx&appname=商汤小浣熊官网&source=platform`。
- * `source=platform` 来自网站登录页实测（chunk c3.js）：新版网关按它区分扫码来源，缺了会被判非法码。
- * ⚠ scan_path 是**服务端数据**，拼进 URL 前必须校验（只允许站内单斜杠开头的相对路径），
- *   否则一个被篡改的响应就能把用户导向任意外站。
- */
-export const raccoonQrPageUrl = (code, scanPath = "/login/mp") => {
-  const path = typeof scanPath === "string" && /^\/[^\s\\#]*$/.test(scanPath) && !scanPath.startsWith("//") ? scanPath : "/login/mp";
-  return `${RACCOON_ORIGIN}${path}?code=${encodeURIComponent(String(code || ""))}`
-    + `&appname=${encodeURIComponent("商汤小浣熊官网")}&source=platform`;
-};
-
-export const RACCOON_DEFAULT_CLIENT_VERSION = "v1.0.35";
-export const RACCOON_CLIENT_PLATFORM = "desktop-windows";
-export const RACCOON_CLIENT_LANGUAGE = "zh";
-export const RACCOON_LOGIN_REWARD_POINTS = 3000;
-export const RACCOON_LOGIN_REWARD_EVENT_NAME = "桌面端登录奖励";
-
-export const RACCOON_REQUEST_TIMEOUT_MS = 60_000;
-export const RACCOON_LOGIN_TIMEOUT_MS = 5 * 60 * 1000;
-export const RACCOON_LOGIN_POLL_INTERVAL_MS = 2000;
-
-/** 客户端版本号（env 可覆盖：上游按版本做风控判断，硬编码会随官方发版失效）。 */
-export function raccoonClientVersion(env = process.env) {
-  const v = typeof env?.MSLXDFF_RACCOON_CLIENT_VERSION === "string" ? env.MSLXDFF_RACCOON_CLIENT_VERSION.trim() : "";
-  return v || RACCOON_DEFAULT_CLIENT_VERSION;
-}
-
-/** UA 形如 `Raccoon Work/1.0.35 (Windows)` —— 版本段不带 `v` 前缀（对齐官方客户端字面量）。 */
-export function raccoonUserAgent(env = process.env) {
-  const ver = raccoonClientVersion(env).replace(/^v/i, "");
-  return `Raccoon Work/${ver} (Windows)`;
-}
-
-// 思考只有两档（上游不认 reasoning_effort，实测传该参数无可测差异）：
-// 出站经 extra_body.thinking.type = "enabled" | "disabled"。
-export const RACCOON_EFFORT_ON = "on";
-export const RACCOON_EFFORT_OFF = "off";
-export const RACCOON_EFFORTS = [RACCOON_EFFORT_ON, RACCOON_EFFORT_OFF];
-export const RACCOON_DEFAULT_EFFORT = RACCOON_EFFORT_ON;
-
-/**
- * 思考档位 → 出站 `thinking.type`。
- * 词表由 src/thinking-effort.js 统一（off/none/disabled 均判关），非本家档位（high/xhigh/max/…）归一为「开」而非报错。
- */
-export function raccoonThinkingType(effort) {
-  return isEffortOff(effort) ? "disabled" : "enabled";
-}
-
-/**
- * 思考开关的环境默认：`MSLXDFF_RACCOON_THINKING=off|0|false|no|disabled` 关，其余（含未设）=开。
- * 优先级见 `chat.js` 的 `buildRaccoonWireBody`（请求体显式声明 > effort 参数 > 本 env > 默认开）。
- */
-export function raccoonEffortFromEnv(env = process.env) {
-  const raw = typeof env?.MSLXDFF_RACCOON_THINKING === "string" ? env.MSLXDFF_RACCOON_THINKING.trim().toLowerCase() : "";
-  return raw === "off" || raw === "0" || raw === "false" || raw === "no" || raw === "disabled" ? RACCOON_EFFORT_OFF : RACCOON_EFFORT_ON;
-}
-
-/** 冷却档位（对齐 qoder/zcode 先例：限流短冷、额度长冷）。 */
-export const RACCOON_DEFAULT_COOLDOWN_MS = 30_000;
-export const RACCOON_DEFAULT_QUOTA_COOLDOWN_MS = 60 * 60 * 1000;
-
-// 业务码表（pack.js 实证）：200001 未带 token，200003 登录态过期，100006 图形验证码失败（仅短信链路）。
-export const RACCOON_ERROR_KINDS = {
-  200001: "auth",
-  200003: "auth",
-  100006: "captcha",
-};
-
-export function raccoonErrorKind(code) {
-  return RACCOON_ERROR_KINDS[Number(code)] || "unknown";
-}
-
-/**
- * 兜底模型目录（pack.js `RACCOON_FALLBACK_MODELS` 原文，全部支持读图）。
- * `multiplier` = 每次调用扣分倍率：0 免费、1 基准、0.25 四分之一；`baseMultiplier` 存在即促销（显示 x基→x实）。
- * 上游 `model_catalog` 不可达时用本表，保证「未登录也能看见这家有什么」。
- */
-export const RACCOON_FALLBACK_MODELS = [
-  { id: "sn-sensenova-6-8-flash", contextWindow: 256_000, maxTokens: 63_999, supportsImage: true, multiplier: 0 },
-  { id: "sn-sensenova-6-8-flash-lite", contextWindow: 256_000, maxTokens: 63_999, supportsImage: true, multiplier: 0 },
-  { id: "sn-kimi-k3", contextWindow: 1_000_000, maxTokens: 100_000, supportsImage: true, multiplier: 1 },
-  { id: "sn-deepseek-v4-1-flash", contextWindow: 1_000_000, maxTokens: 100_000, supportsImage: true, multiplier: 0.25 },
-  { id: "sn-glm-5-3", contextWindow: 1_000_000, maxTokens: 100_000, supportsImage: true, multiplier: 0.75 },
-  { id: "sn-glm-5-3-flash", contextWindow: 1_000_000, maxTokens: 100_000, supportsImage: true, multiplier: 0.1, baseMultiplier: 0.2 },
-];
-
-/** 入站 `raccoon/<model>` → 裸 id（allowlist 与出站都用裸 id）。 */
-export function canonicalRaccoonModel(id) {
-  const raw = String(id || "").trim();
-  return raw.startsWith("raccoon/") ? raw.slice("raccoon/".length) : raw;
-}
+// raccoon（商汤小浣熊）供应商常量单一源：网关地址、客户端版本与 UA、两档思考、业务码表、兜底模型目录。
+// 端点契约调研自 Ebony-Vinyl/dsh-our-free-model 的 vendor/channel-pack/src/raccoon*.ts
+// （打包产物 pack.js 原文）并逐条本机实测：站点根 200、model_catalog 匿名 401、
+// chat/completions 匿名 401、login_with_qrcode_code 匿名 200 {"code":0,"data":{"status":"pending"}}。
+import { isEffortOff } from "../../thinking-effort.js";
+
+export const RACCOON_ORIGIN = "https://xiaohuanxiong.com";
+
+export const RACCOON_LLM_PREFIX = "/api/web/llm/v2";
+export const RACCOON_AUTH_PREFIX = "/api/web/auth/v1";
+export const RACCOON_POINTS_PREFIX = "/api/web/points/v1";
+export const RACCOON_DESKTOP_PREFIX = "/api/web/desktop/v1";
+/**
+ * 新一代身份通道前缀（2026-10 上游改版实测）。
+ * 扫码登录已从 `/api/web/auth/v1/login_with_qrcode_code` 迁到这里，契约完全变了：
+ * code 由**服务端签发**（`qr-<uuid>`），并下发 scan_path / expires_in / poll_interval。
+ * 旧的「客户端自造 code」在新通道里没有服务端会话 —— 微信扫码后查不到该码，
+ * 正好表现为「二维码已过期或已被使用」，故整条扫码链路必须走新端点。
+ * ⚠ 信封也不同：这套用 `code: "OK"` 而不是 `code: 0` —— 判成功一律用 isRaccoonOk()。
+ */
+export const RACCOON_IAM_PREFIX = "/api/iam/v1";
+
+export const raccoonModelCatalogUrl = () => `${RACCOON_ORIGIN}${RACCOON_LLM_PREFIX}/model_catalog`;
+export const raccoonChatUrl = () => `${RACCOON_ORIGIN}${RACCOON_LLM_PREFIX}/chat/completions`;
+export const raccoonRefreshUrl = () => `${RACCOON_ORIGIN}${RACCOON_AUTH_PREFIX}/refresh`;
+/**
+ * IAM 会话确认端点（2026-10-18 故障取证 + 官方前端 c6.js 实证）。
+ * 上游把网页/IAM 登录的会话划入「先确认再放行」：新登录的 token 打业务端点回
+ * `400 {"code":200901,"message":"iam_confirm_required"}`，先带 Bearer POST 本端点
+ * （body `{}` 即可）确认会话后业务端点恢复 200。官方前端的处理同样是
+ * 「撞 200901 → confirm(true) → 重试原请求」。
+ */
+export const raccoonIamConfirmUrl = () => `${RACCOON_ORIGIN}${RACCOON_AUTH_PREFIX}/iam/confirm`;
+export const raccoonUserInfoUrl = () => `${RACCOON_ORIGIN}${RACCOON_AUTH_PREFIX}/user_info`;
+export const raccoonBalanceUrl = () => `${RACCOON_ORIGIN}${RACCOON_POINTS_PREFIX}/balance`;
+export const raccoonBillsUrl = (limit = 50) =>
+  `${RACCOON_ORIGIN}${RACCOON_POINTS_PREFIX}/bills?paging.limit=${Number(limit) || 50}&paging.offset=0`;
+export const raccoonLoginGrantUrl = () => `${RACCOON_ORIGIN}${RACCOON_DESKTOP_PREFIX}/login/points/grant`;
+
+/**
+ * 每日积分结算触发器：`GET /api/web/office/v3/setting_info`。
+ *
+ * 2026-10-21 账单实测（这家的每日积分是**惰性结算**，不是签到）：
+ *   · 每日积分由服务端按天挂账，**当天第一次访问这个端点时才真正入账**
+ *     （此前账单里连 `daily_grant` 都没有，`balance.daily_points` 恒 0）；
+ *   · 入账后 `expire_at` 直接是 T+6 的 23:59:59 —— 对应官方文案
+ *     「每日积分每天 00:00 发放，默认当日 24:00 清零，**当天登录后有效期延长至 7 天**」；
+ *   · 完全幂等：连打 4 次只有第一次产生账单，其余静默返回（可放心每天重试）。
+ * 官方前端把这个端点挂在登录后拉设置信息的路径上，等价于「登录」这个动作本身。
+ * 端点选型实测：`/auth/v1/setting_info` 404、`/setting/v1/setting_info` 404，只有 office/v3 这条通。
+ */
+export const raccoonOfficeSettingUrl = () => `${RACCOON_ORIGIN}/api/web/office/v3/setting_info`;
+/**
+ * 每日积分账单的 `event_name` 字面量 —— 判「今天结算过没有」只认它（`biz_type` 是 `daily_grant`）。
+ * ⚠ 定位必须先按 biz_type 过滤再比 event_name：重度使用号的账单会被「对话消耗」刷满，
+ *   窗口里根本翻不到那条陈旧的 grant（这是 claimRaccoonLoginReward 注释里踩过的同一个坑）。
+ */
+export const RACCOON_DAILY_GRANT_EVENT_NAME = "每日积分发放";
+/** 账单分页上限实测值：一次 200 条，足够覆盖一天的重度用量（对话消耗）而仍能捞到当天的 grant。 */
+export const RACCOON_BILLS_PAGE_LIMIT = 200;
+
+/** 服务端签发二维码（POST，body 可带 `{ product_codes: [] }`）。 */
+export const raccoonQrCreateUrl = () => `${RACCOON_ORIGIN}${RACCOON_IAM_PREFIX}/auth/mp/qrcode`;
+/** 轮询扫码状态（POST，body `{ qrcode_code }`）。 */
+export const raccoonQrPollUrl = () => `${RACCOON_ORIGIN}${RACCOON_IAM_PREFIX}/auth/mp/qrcode/login`;
+/** 取消二维码（PUT，body `{ qrcode_code, status: "canceled" }`）——过期/离开页面时礼貌回收。 */
+export const raccoonQrCancelUrl = () => `${RACCOON_ORIGIN}${RACCOON_IAM_PREFIX}/auth/mp/qrcode`;
+
+/**
+ * 密码登录（手机号 + 密码）—— **走官方前端同款 web 端点，参数须 AES 加密**。
+ *
+ * 端点选择（2026-10-18 真实账号实测三选一）：
+ *   `POST /api/web/auth/v1/login_with_password`（官方前端 `loginWithPassword` 同款）
+ *     → 200 `{code:0, data:{access_token, refresh_token}}` ✅ 与 refresh/chat/credits 同族，且给 refresh_token
+ *   `POST /api/iam/v1/auth/login/password/phone`
+ *     → 200 `{code:"OK", data:{access_token, token_type, expires_at}}` —— **无 refresh_token**，
+ *       token 一过期就得重新输密码，对多号长期使用是硬伤，故弃用。
+ * 两处都要求 phone/password **加密**（算法与 key 见 `crypto.js`）；明文一律回
+ * `AUTH_ACCOUNT_OR_PASSWORD_INVALID`（用「密码错」的口径掩盖「格式错」，极难自查）。
+ *
+ * body 契约：`{ nation_code: "86", phone: <加密>, password: <加密> }`
+ *   · nation_code 是**明文数字字符串**（数字 86 被判 body invalid）
+ *   · phone / password 各自 Base64(IV ‖ AES-128-CFB 密文) —— 见 crypto.js
+ * ⚠ 密码只在此处作为请求体出现，**绝不落盘、绝不进日志**。
+ */
+export const raccoonPasswordLoginUrl = () => `${RACCOON_ORIGIN}${RACCOON_AUTH_PREFIX}/login_with_password`;
+
+/**
+ * 登录参数加密 key（AES-128-CFB）。**上游公开常量**，打包在任意客户端里（app.asar 原文）。
+ * 照抄它只为对齐协议；传输保密性来自 HTTPS，不来自这个 key。
+ */
+export const RACCOON_PASSWORD_ENC_KEY = "senseraccoon2023";
+
+/**
+ * 密码登录失败码 → 人话。命中即抛「可操作」的错误，未命中一律透出上游 message。
+ * 表里只放**本机实测见过**的码，不臆造（上游加了新码就走 default 兜底透出原文）。
+ *   200004                          —— web 通道（本项目所用）实测：错误密码回
+ *                                      `{code:200004,message:"phone_or_password_verify_error"}`；
+ *                                      该 message 是英文码不是人话，必须靠本表翻译。
+ *   AUTH_ACCOUNT_OR_PASSWORD_INVALID —— IAM 通道同义码（本项目已不用该端点，保留以防回退）。
+ *   COMMON_INVALID_ARGUMENT          —— 缺 nation_code/空字段实测（IAM 通道）。
+ */
+export const RACCOON_PASSWORD_ERRORS = {
+  200004: "手机号或密码不正确",
+  AUTH_ACCOUNT_OR_PASSWORD_INVALID: "手机号或密码不正确",
+  COMMON_INVALID_ARGUMENT: "登录参数不完整（需要 国家码 + 手机号 + 密码）",
+};
+
+/**
+ * 扫码登录深链接：终端编成二维码，**必须用微信「扫一扫」**打开确认。
+ * code 与 scan_path 都由 `POST /auth/mp/qrcode` 下发（scan_path 实测为 `/login/mp`），
+ * 形如 `https://xiaohuanxiong.com/login/mp?code=qr-xxxx&appname=商汤小浣熊官网&source=platform`。
+ * `source=platform` 来自网站登录页实测（chunk c3.js）：新版网关按它区分扫码来源，缺了会被判非法码。
+ * ⚠ scan_path 是**服务端数据**，拼进 URL 前必须校验（只允许站内单斜杠开头的相对路径），
+ *   否则一个被篡改的响应就能把用户导向任意外站。
+ */
+export const raccoonQrPageUrl = (code, scanPath = "/login/mp") => {
+  const path = typeof scanPath === "string" && /^\/[^\s\\#]*$/.test(scanPath) && !scanPath.startsWith("//") ? scanPath : "/login/mp";
+  return `${RACCOON_ORIGIN}${path}?code=${encodeURIComponent(String(code || ""))}`
+    + `&appname=${encodeURIComponent("商汤小浣熊官网")}&source=platform`;
+};
+
+export const RACCOON_DEFAULT_CLIENT_VERSION = "v1.0.35";
+export const RACCOON_CLIENT_PLATFORM = "desktop-windows";
+export const RACCOON_CLIENT_LANGUAGE = "zh";
+export const RACCOON_LOGIN_REWARD_POINTS = 3000;
+export const RACCOON_LOGIN_REWARD_EVENT_NAME = "桌面端登录奖励";
+
+export const RACCOON_REQUEST_TIMEOUT_MS = 60_000;
+export const RACCOON_LOGIN_TIMEOUT_MS = 5 * 60 * 1000;
+export const RACCOON_LOGIN_POLL_INTERVAL_MS = 2000;
+
+/** 客户端版本号（env 可覆盖：上游按版本做风控判断，硬编码会随官方发版失效）。 */
+export function raccoonClientVersion(env = process.env) {
+  const v = typeof env?.MSLXDFF_RACCOON_CLIENT_VERSION === "string" ? env.MSLXDFF_RACCOON_CLIENT_VERSION.trim() : "";
+  return v || RACCOON_DEFAULT_CLIENT_VERSION;
+}
+
+/** UA 形如 `Raccoon Work/1.0.35 (Windows)` —— 版本段不带 `v` 前缀（对齐官方客户端字面量）。 */
+export function raccoonUserAgent(env = process.env) {
+  const ver = raccoonClientVersion(env).replace(/^v/i, "");
+  return `Raccoon Work/${ver} (Windows)`;
+}
+
+// 思考只有两档（上游不认 reasoning_effort，实测传该参数无可测差异）：
+// 出站经 extra_body.thinking.type = "enabled" | "disabled"。
+export const RACCOON_EFFORT_ON = "on";
+export const RACCOON_EFFORT_OFF = "off";
+export const RACCOON_EFFORTS = [RACCOON_EFFORT_ON, RACCOON_EFFORT_OFF];
+export const RACCOON_DEFAULT_EFFORT = RACCOON_EFFORT_ON;
+
+/**
+ * 思考档位 → 出站 `thinking.type`。
+ * 词表由 src/thinking-effort.js 统一（off/none/disabled 均判关），非本家档位（high/xhigh/max/…）归一为「开」而非报错。
+ */
+export function raccoonThinkingType(effort) {
+  return isEffortOff(effort) ? "disabled" : "enabled";
+}
+
+/**
+ * 思考开关的环境默认：`MSLXDFF_RACCOON_THINKING=off|0|false|no|disabled` 关，其余（含未设）=开。
+ * 优先级见 `chat.js` 的 `buildRaccoonWireBody`（请求体显式声明 > effort 参数 > 本 env > 默认开）。
+ */
+export function raccoonEffortFromEnv(env = process.env) {
+  const raw = typeof env?.MSLXDFF_RACCOON_THINKING === "string" ? env.MSLXDFF_RACCOON_THINKING.trim().toLowerCase() : "";
+  return raw === "off" || raw === "0" || raw === "false" || raw === "no" || raw === "disabled" ? RACCOON_EFFORT_OFF : RACCOON_EFFORT_ON;
+}
+
+/** 冷却档位（对齐 qoder/zcode 先例：限流短冷、额度长冷）。 */
+export const RACCOON_DEFAULT_COOLDOWN_MS = 30_000;
+export const RACCOON_DEFAULT_QUOTA_COOLDOWN_MS = 60 * 60 * 1000;
+
+// 业务码表（pack.js 实证）：200001 未带 token，200003 登录态过期，100006 图形验证码失败（仅短信链路）。
+export const RACCOON_ERROR_KINDS = {
+  200001: "auth",
+  200003: "auth",
+  100006: "captcha",
+};
+
+export function raccoonErrorKind(code) {
+  return RACCOON_ERROR_KINDS[Number(code)] || "unknown";
+}
+
+/**
+ * 兜底模型目录（pack.js `RACCOON_FALLBACK_MODELS` 原文，全部支持读图）。
+ * `multiplier` = 每次调用扣分倍率：0 免费、1 基准、0.25 四分之一；`baseMultiplier` 存在即促销（显示 x基→x实）。
+ * 上游 `model_catalog` 不可达时用本表，保证「未登录也能看见这家有什么」。
+ */
+export const RACCOON_FALLBACK_MODELS = [
+  { id: "sn-sensenova-6-8-flash", contextWindow: 256_000, maxTokens: 63_999, supportsImage: true, multiplier: 0 },
+  { id: "sn-sensenova-6-8-flash-lite", contextWindow: 256_000, maxTokens: 63_999, supportsImage: true, multiplier: 0 },
+  { id: "sn-kimi-k3", contextWindow: 1_000_000, maxTokens: 100_000, supportsImage: true, multiplier: 1 },
+  { id: "sn-deepseek-v4-1-flash", contextWindow: 1_000_000, maxTokens: 100_000, supportsImage: true, multiplier: 0.25 },
+  { id: "sn-glm-5-3", contextWindow: 1_000_000, maxTokens: 100_000, supportsImage: true, multiplier: 0.75 },
+  { id: "sn-glm-5-3-flash", contextWindow: 1_000_000, maxTokens: 100_000, supportsImage: true, multiplier: 0.1, baseMultiplier: 0.2 },
+];
+
+/** 入站 `raccoon/<model>` → 裸 id（allowlist 与出站都用裸 id）。 */
+export function canonicalRaccoonModel(id) {
+  const raw = String(id || "").trim();
+  return raw.startsWith("raccoon/") ? raw.slice("raccoon/".length) : raw;
+}