mslxdff 0.1.174 → 0.1.176

package/src/providers/traework/account-store.js

@@ -4,6 +4,8 @@ import { writeFileSync, mkdirSync, existsSync, renameSync, unlinkSync, readdirSy
 import { join, dirname } from "node:path";
 import { tmpdir } from "node:os";
 import { isTestEnv, defaultStateFile } from "../../state/store.js";
+// 市场侧伪设备身份：派生算法在 market-identity.js（纯函数），本文件只管落盘与取用。
+import { deriveMarketIdentity, marketUsable } from "./market-identity.js";
 
 export function authDirFor({ explicit = "", testEnv = false, stateFile } = {}) {
   if (explicit) return explicit;
@@ -34,8 +36,8 @@ export function resolveAuthDirs() {
   });
 }
 
-export function findAccountFile(uid) {
-  for (const dir of resolveAuthDirs()) {
+export function findAccountFile(uid, { dirs } = {}) {
+  for (const dir of dirs || resolveAuthDirs()) {
     const fp = join(dir, `trae-${uid}.json`);
     if (existsSync(fp)) return fp;
   }
@@ -147,3 +149,86 @@ export async function applyTokenRefresh({ uid, oldKey, newToken, refreshToken =
   const st = await persistAccounts(accounts, file, extraKeys);
   return { updated: matched, accounts: st.keys.length, file: fp };
 }
+
+/**
+ * 按 uid 回 auth 文件取「设备身份」（machineId/deviceId/apiHost/enterpriseId/domain）。
+ *
+ * 为什么必须回文件而不是信 state 行：`src/state/provider-config.js` 的 `normalizeAuths` 是
+ * {uid,domain,enterpriseId,refreshToken} **四字段白名单**（为 WorkBuddy 设计），任何写 state 的路径
+ * 都会把 machineId/deviceId/apiHost 静默剥光 —— 于是 `persistAccounts:100` 与 `applyTokenRefresh:141`
+ * 精心写的这三个字段**从来没落过盘**。缺 X-Device-Id 时上游 `ug/checkin_credits/claim` 回
+ * `code=9004 The submitted order parameters are incorrect`（2026-10-15 实测：同一次登录用局部 deviceId
+ * 那一发回的是 9074「参与用户太多」，两行代码之差即因果）。
+ */
+export function traeworkIdentityByUid(uid, { dirs } = {}) {
+  const blank = { machineId: "", deviceId: "", apiHost: "", domain: "", enterpriseId: "" };
+  const want = String(uid || "");
+  if (!want) return blank;
+  for (const { uid: u, doc } of listAccountDocs({ dirs })) {
+    if (String(u) !== want) continue;
+    const a = (doc && doc.auth) || {}, acc = (doc && doc.account) || {};
+    return {
+      machineId: String(a.machineId || ""),
+      deviceId: String(a.deviceId || ""),
+      apiHost: String(a.apiHost || ""),
+      domain: String(a.domain || ""),
+      enterpriseId: String(acc.enterpriseId || a.enterpriseId || ""),
+    };
+  }
+  return blank;
+}
+
+/** 批量版：一次扫目录，按 uid 把 authList 行补齐身份（state 已有的值优先，缺的才回文件取）。 */
+export function withTraeworkIdentity(authList = [], { dirs } = {}) {
+  const byUid = new Map(listAccountDocs({ dirs }).map((d) => [String(d.uid), d.doc]));
+  return (Array.isArray(authList) ? authList : []).map((row) => {
+    const doc = byUid.get(String((row && row.uid) || ""));
+    if (!doc) return { ...(row || {}) };
+    const a = (doc && doc.auth) || {}, acc = (doc && doc.account) || {};
+    return {
+      ...(row || {}),
+      machineId: (row && row.machineId) || a.machineId || "",
+      deviceId: (row && row.deviceId) || a.deviceId || "",
+      apiHost: (row && row.apiHost) || a.apiHost || "",
+      domain: (row && row.domain) || a.domain || "trae.cn",
+      enterpriseId: (row && row.enterpriseId) || acc.enterpriseId || "",
+      // accessToken 仍以 state.keys[i] 为准（keyring 按它轮转），只在行里空时兜一份文件里的
+      ...(row && row.accessToken ? {} : (a.accessToken ? { accessToken: a.accessToken } : {})),
+    };
+  });
+}
+
+/**
+ * 取该账号的市场侧伪设备身份（UG 接口的 x-device-id / x-market-user-id / vscode-sessionid）。
+ *
+ * 真相源是 `auths/trae-<uid>.json` 的 `market` 块，**不是 state**：`normalizeAuths` 是四字段白名单
+ * （`src/state/provider-config.js:21`），写进 state 的 auths 行必被剥光（2026-10-15 实测）。
+ * 存量缺失/形状不对/gen 落后 → 按 uid 确定性重建并回写文档；同 uid 永远得到同一套身份，
+ * 因此重登不会换设备（换设备在上游眼里就是新设备，签到风控会跟上来，见参考实现 device.rs:108）。
+ */
+export function ensureMarketIdentity(uid, { dirs } = {}) {
+  const want = String(uid || "").trim();
+  const derived = deriveMarketIdentity(want);
+  if (!want) return derived; // 无 uid：只可能拿到不可复现的兜底值，不写盘（没有文件名可写）
+  const fp = findAccountFile(want, { dirs });
+  if (!fp) return derived;
+  let doc = null;
+  try {
+    doc = JSON.parse(readFileSync(fp, "utf8"));
+  } catch {
+    return derived;
+  }
+  if (marketUsable(doc && doc.market)) {
+    const m = doc.market;
+    return { deviceId: String(m.deviceId), marketUserId: String(m.marketUserId), sessionId: String(m.sessionId), created: m.created || "", gen: Number(m.gen) };
+  }
+  // 就地补写：只加/换 `market` 一个键，其余字段原样保留（不碰 auth/account，防洗掉 token 与身份）
+  try {
+    const next = { ...doc, market: derived };
+    const tmp = `${fp}.tmp`;
+    writeFileSync(tmp, JSON.stringify(next, null, 2), { mode: 0o600 });
+    try { renameSync(tmp, fp); } catch { writeFileSync(fp, JSON.stringify(next, null, 2), { mode: 0o600 }); try { unlinkSync(tmp); } catch {} }
+    try { chmodSync(fp, 0o600); } catch {}
+  } catch {}
+  return derived;
+}

package/src/providers/traework/checkin.js

@@ -2,9 +2,18 @@
 import { UG_HOST, EP_CHECKIN_STATUS, EP_CHECKIN_CLAIM, EP_ENT_USAGE } from "./constants.js";
 import { ugHeaders } from "./headers.js";
 import { compatFetch, timeoutSignal } from "../../compat.js";
+import { ensureMarketIdentity } from "./account-store.js";
+
+// 三个 UG 接口共用这一发：市场身份在此统一挂载，调用点就不必各自记得带
+// （少带一件 x-device-id，claim 即回 9004；见 headers.js 的 ugHeaders 注释）。
+function withUgIdentity(cred = {}) {
+  if (cred.market) return cred; // 调用方已备好自己的身份（含测试注入）→ 尊重它，不越权读盘
+  const uid = String(cred.uid || "").trim();
+  return { ...cred, market: ensureMarketIdentity(uid) };
+}
 
 async function postJson(fetchImpl, url, cred, timeoutMs = 15000) {
-  const res = await fetchImpl(url, { method: "POST", headers: ugHeaders(cred), body: "{}", signal: timeoutSignal(timeoutMs) });
+  const res = await fetchImpl(url, { method: "POST", headers: ugHeaders(withUgIdentity(cred)), body: "{}", signal: timeoutSignal(timeoutMs) });
   const txt = await res.text().catch(() => "");
   let j = null;
   try { j = JSON.parse(txt); } catch { j = { _raw: txt.slice(0, 200) }; }
@@ -17,19 +26,52 @@ export async function checkinStatus({ cred, baseUrl = UG_HOST, fetchImpl = compa
   return { checkedIn: Boolean(json?.checked_in), credits: Number(json?.credits) || 0, enable: Boolean(json?.enable) };
 }
 
+// 领取每日签到积分。⚠ 别单用本函数判成败：上游对重复领取照样回 HTTP 200（raccoon 踩过同一坑，
+//   判据口径见 src/cli/commands/provider/raccoon-quota.js:3-5「只信回执就会谎报到账」）。
+//   本函数只做「HTTP 通了 + 回执 code 非明确失败」；到账与否请用下面 checkinClaimVerified。
+//   `code` 字段缺失时不判失败——claim 的响应体没实测过，不臆造上游契约。
 export async function checkinClaim({ cred, baseUrl = UG_HOST, fetchImpl = compatFetch, timeoutMs = 15000 } = {}) {
-  const { res } = await postJson(fetchImpl, `${String(baseUrl).replace(/\/+$/, "")}${EP_CHECKIN_CLAIM}`, cred, timeoutMs);
+  const { res, json } = await postJson(fetchImpl, `${String(baseUrl).replace(/\/+$/, "")}${EP_CHECKIN_CLAIM}`, cred, timeoutMs);
   if (res.status >= 400) throw Object.assign(new Error(`checkin claim http ${res.status}`), { status: res.status });
-  return { ok: true };
+  const code = json && typeof json === "object" && json.code !== undefined ? Number(json.code) : undefined;
+  return {
+    ok: code === undefined || code === 0,
+    code,
+    message: String(json?.message || json?.msg || "").slice(0, 120),
+    raw: json,
+  };
+}
+
+/**
+ * 领取并**复核到账** —— 签到唯一该用的入口。
+ * `claimed` 只在「领取后复查 checkinStatus().checkedIn === true」时为真；
+ * 回执没报错但复查仍 false → `phantom: true`，调用方必须按**未签到**处理（绝不写进 state 当今天签过了）。
+ * opts.before：调用方已查过状态时传进来，省一次往返。
+ */
+export async function checkinClaimVerified(opts = {}) {
+  const before = opts.before || (await checkinStatus(opts));
+  if (before.checkedIn) return { claimed: false, already: true, phantom: false, checkedIn: true, credits: before.credits, msg: "" };
+  if (!before.enable) return { claimed: false, already: false, phantom: false, checkedIn: false, credits: before.credits, msg: "checkin not enabled" };
+  let claim = { ok: false, code: undefined, message: "" };
+  try {
+    claim = await checkinClaim(opts);
+  } catch (e) {
+    return { claimed: false, already: false, phantom: false, checkedIn: false, credits: before.credits, msg: `claim http: ${String(e?.message || e).slice(0, 80)}` };
+  }
+  const after = await checkinStatus(opts);
+  if (after.checkedIn) return { claimed: true, already: false, phantom: false, checkedIn: true, credits: after.credits, msg: "" };
+  const why = claim.ok ? "上游回执未报错、但复查 checked_in 仍为 false（判未到账）" : `上游回执 code=${claim.code}${claim.message ? ` ${claim.message}` : ""}`;
+  return { claimed: false, already: false, phantom: claim.ok, checkedIn: false, credits: after.credits, msg: why.slice(0, 120) };
 }
 
-// 积分：ide_user_ent_usage 的 credits_limit 求和。
+// 积分额度：把 ide_user_ent_usage 各 pack 的 credits_limit 求和。
+// ⚠ 这是**额度上限**、不是剩余可用：实测该接口只回 credits_limit 与 enable_solo_* 开关，
+//   没有任何已用/剩余字段。故模型报 4008（requests exceeded the quota）时本数照样非零 —— 别拿它当余额判生死。
 export async function entUsage({ cred, baseUrl = UG_HOST, fetchImpl = compatFetch, timeoutMs = 15000 } = {}) {
   const { res, json } = await postJson(fetchImpl, `${String(baseUrl).replace(/\/+$/, "")}${EP_ENT_USAGE}`, cred, timeoutMs);
   if (res.status >= 400) throw Object.assign(new Error(`ent usage http ${res.status}`), { status: res.status });
-  const packs = json?.user_entitlement_pack_list;
-  if (!Array.isArray(packs)) return { remain: 0, isCreditsBilling: Boolean(json?.is_credits_billing) };
-  let remain = 0;
-  for (const p of packs) remain += Number(p?.entitlement_base_info?.quota?.credits_limit) || 0;
-  return { remain, isCreditsBilling: Boolean(json?.is_credits_billing) };
+  const packs = Array.isArray(json?.user_entitlement_pack_list) ? json.user_entitlement_pack_list : [];
+  let totalCredits = 0;
+  for (const p of packs) totalCredits += Number(p?.entitlement_base_info?.quota?.credits_limit) || 0;
+  return { totalCredits, isCreditsBilling: Boolean(json?.is_credits_billing), packCount: packs.length };
 }

package/src/providers/traework/constants.js

@@ -19,3 +19,23 @@ export const EP_USER_INFO = "/cloudide/api/v3/trae/GetUserInfo";
 export const EP_CHECKIN_STATUS = "/trae/api/v2/ug/checkin_credits/status";
 export const EP_CHECKIN_CLAIM = "/trae/api/v2/ug/checkin_credits/claim";
 export const EP_ENT_USAGE = "/trae/api/v2/pay/ide_user_ent_usage";
+
+// ── 市场/UG 侧线上契约（status/claim/ent_usage 共用）────────────────────────
+// 出处：抓包复刻自 NextAgentX/trae-workbuddy-switch `modules/trae/credits.rs:49-99`，
+// 不是从客户端源码抄的 —— 该仓自述「把 `x-market-client-id`/`x-market-user-id`/`x-lscbd-aid`
+// 与整串 `VSCode 1.107.1 (TRAE SOLO CN)` 在 Trae 安装目录 5141 个文件（含 .exe/.asar）里全扫一遍，
+// **一个字面量都搜不到**」，即无法从客户端侧核对，只能以「线上实测能用」为准。
+// ⚠ 因此这些值是**线上契约**，不要"顺手改成看起来更对的"；要改必须先拿到抓包证据。
+// 上面那段纪律原文见该仓 credits.rs:53-76。
+export const MARKET_UA_PRODUCT = "TRAE SOLO CN";      // UA 括号里的产品名
+export const MARKET_VSCODE_VERSION = "1.107.1";       // 真机 resources/app/package.json 的 version
+export const MARKET_UA = `VSCode ${MARKET_VSCODE_VERSION} (${MARKET_UA_PRODUCT})`;
+export const MARKET_AID = "787976";                   // x-lscbd-aid（活动/埋点侧应用标识）
+export const MARKET_SDK_TYPE = "3";                   // x-lgw-req-sdk-type
+export const MARKET_PACKAGE_TYPE = "stable_cn";       // package-type，CN 稳定版通道
+export const MARKET_USER_REGION = "CN";               // x-user-region，产品级 CN 通道，不随账号 Region 变
+export const MARKET_APP_VERSION = "0.1.45";           // app-version（≠ 上面的 IDE_VERSION 0.1.43：两条通道各自取值，别合）
+
+// 市场伪设备身份的派生算法版本（抄 device.rs:35 DEVICE_GEN）。
+// auth 文档里的 `market.gen` 缺失或小于此值 → 视为旧算法产物，就地重建（自愈）。
+export const MARKET_DEVICE_GEN = 2;

package/src/providers/traework/headers.js

@@ -1,5 +1,6 @@
 // SOLO 三类请求头（照抄 traework2api internal/upstream/headers.go）。纯函数，可测。
-import { APP_ID, DEVICE_BRAND, IDE_VERSION, IDE_VERSION_CODE, OS_VERSION, TRAE_UA } from "./constants.js";
+import { APP_ID, DEVICE_BRAND, IDE_VERSION, IDE_VERSION_CODE, OS_VERSION, TRAE_UA, MARKET_UA, MARKET_VSCODE_VERSION, MARKET_USER_REGION, MARKET_SDK_TYPE, MARKET_PACKAGE_TYPE, MARKET_AID, MARKET_APP_VERSION } from "./constants.js";
+import { uuid } from "../../compat.js";
 
 // 对话/模型表（Cloud-IDE-JWT 鉴权 + IDE 指纹）。
 export function soloHeaders(cred = {}, stream = true) {
@@ -28,17 +29,48 @@ export function soloHeaders(cred = {}, stream = true) {
   return h;
 }
 
-// 签到/积分（api.trae.cn）。
+// 签到/积分/额度（api.trae.cn 的 UG 与 pay 系接口）。
+// ⚠ 这套头是**线上契约**：三件设备身份（x-device-id / x-market-user-id / vscode-sessionid）缺一或形态不对，
+//   `checkin_credits/claim` 就回 `code=9004 下单参数不正确`（2026-10-15 现网取证）。
+//   逐字对齐 NextAgentX/trae-workbuddy-switch `modules/trae/credits.rs:116-147`，取值出处与该仓纪律见 constants.js 注释。
 export function ugHeaders(cred = {}) {
-  const h = {
-    "Content-Type": "application/json",
-    Accept: "application/json",
-    "User-Agent": TRAE_UA,
-    Authorization: `Cloud-IDE-JWT ${cred?.accessToken || ""}`,
-    "X-User-Region": "CN",
+  const m = cred?.market || {};
+  const at = String(cred?.accessToken || "");
+  return {
+    accept: "*/*",
+    "accept-language": "zh-CN",
+    "content-type": "application/json",
+    "user-agent": MARKET_UA,
+    // 防双前缀：传进来的可能已带 `Cloud-IDE-JWT `（口径同参考实现 jwt.rs:53-61）
+    authorization: at.startsWith("Cloud-IDE-JWT ") ? at : `Cloud-IDE-JWT ${at}`,
+    "x-market-client-id": `VSCode ${MARKET_VSCODE_VERSION}`,
+    "x-market-user-id": String(m.marketUserId || ""),
+    "x-user-region": MARKET_USER_REGION,
+    "x-device-id": String(m.deviceId || ""),
+    "x-lgw-req-sdk-type": MARKET_SDK_TYPE,
+    "package-type": MARKET_PACKAGE_TYPE,
+    "x-request-id": uuid(),
+    "x-lscbd-aid": MARKET_AID,
+    "x-lscbd-platform": ugPlatformTag(),
+    "app-version": MARKET_APP_VERSION,
+    "x-tt-trace-id": ugTraceId(),
+    "vscode-sessionid": String(m.sessionId || ""),
+    "sec-fetch-dest": "empty",
+    "sec-fetch-mode": "no-cors",
+    "sec-fetch-site": "none",
   };
-  if (cred?.deviceId) h["X-Device-Id"] = cred.deviceId;
-  return h;
+}
+
+/** `x-lscbd-platform`：按真实平台报，不自称 Windows（参考实现 credits.rs:150-160 的理由：减少跨平台特征矛盾）。 */
+export function ugPlatformTag(p = process.platform) {
+  if (p === "win32") return "windows";
+  if (p === "darwin") return "macos";
+  return "linux";
+}
+
+/** `x-tt-trace-id` = `00-<uuid 去连字符前 16 位>-01`（参考实现 credits.rs:162-166）。 */
+export function ugTraceId(rnd = uuid) {
+  return `00-${String(rnd()).replace(/-/g, "").slice(0, 16)}-01`;
 }
 
 // ExchangeToken / GetUserInfo（无签名，仅 UA）。

package/src/providers/traework/index.js

@@ -4,7 +4,7 @@ import { loadProviderKeys, loadProviderAuths, loadProviderBaseUrl } from "../../
 import { compatFetch, getUndici } from "../../compat.js";
 import { envInt, createAgent } from "../base.js";
 import { AGENT_HOST } from "./constants.js";
-import { listAccountDocs } from "./account-store.js";
+import { listAccountDocs, withTraeworkIdentity } from "./account-store.js";
 import { createChatService } from "./chat.js";
 import { createModelsService } from "./models.js";
 
@@ -66,14 +66,24 @@ export function createTraeworkProvider({
       }
     } catch {}
   }
+  // 无论 authList 来自 state 还是刚扫的目录，都回 auth 文档补一次设备身份：
+  // state 的 auths 行被 `normalizeAuths` 四字段白名单剥掉了 machineId/deviceId（见 account-store.js 同段注释），
+  // 不补则 SOLO 对话永远不发 X-Machine-Id / X-Device-Id。
+  authList = withTraeworkIdentity(authList);
   // auths 行自带 refreshToken 但无 accessToken（login 后 keys 与 auths 平行）；
-  // keys 与 authList 不配对（如 state 被外部改写）→ 从 auth 目录按 uid 补齐 accessToken，防 ring 空
-  if (authList.length && keys.length !== authList.length) {
+  // 补齐触发条件不能只看长度相等：2026-10-15 实测 `-provider traework <未接线子命令>` 掉进 keys 兜底分支，
+  // 把 keys[0] 覆盖成 5 字符垃圾串，长度仍与 authList 相等 → 旧判据放行，真拿垃圾串当 accessToken 鉴权。
+  // 故加形态判据：不像凭据（短、含空白）的槽位一律回 auth 目录重取。
+  // （判空白逐字符 trim 比对，不用 \s 正则——本仓 Edit 通道会把单反斜杠吃成两个，留可读写法防再踩）
+  const hasBlank = (k) => [...k].some((c) => c.trim() === "");
+  const looksLikeCredential = (k) => typeof k === "string" && k.trim().length >= 20 && !hasBlank(k);
+  const needRefill = authList.length && (keys.length !== authList.length || keys.some((k, i) => authList[i]?.uid && !looksLikeCredential(k)));
+  if (needRefill) {
     try {
       const docs = new Map(listAccountDocs().map((d) => [String(d.uid), d.doc]));
       authList.forEach((a, i) => {
         const at = docs.get(String(a.uid))?.auth?.accessToken;
-        if (at && !keys.includes(at)) keys[i] = at;
+        if (at) keys[i] = at; // 按位序覆盖：keys 与 authList 是平行数组（account-store 同语义），去重判据会留垃圾槽位
       });
     } catch {}
   }

package/src/providers/traework/market-identity.js

@@ -0,0 +1,116 @@
+// traework 市场侧「伪设备身份」派生 —— 纯函数，不碰 fs/env。
+//
+// 为什么需要它（2026-10-15 现网取证）：UG 系接口（`checkin_credits/status|claim`、`pay/ide_user_ent_usage`）
+// 要一整套 VSCode/market 请求头，其中三件是**按账号派生的设备身份**：
+//   x-device-id      = 15 位十进制数字串
+//   x-market-user-id = UUID v4 形态
+//   vscode-sessionid = 64 位十六进制串
+// 我们原先只发 5 个头、且把 OAuth 那个 32 位 hex 当 x-device-id 用 → `claim` 回
+// `code=9004 The submitted order parameters are incorrect`；补齐后同一发回 `9074 当前参与用户太多`
+// （已过参数校验，进到了排队/风控层）。
+//
+// 算法逐字对齐 NextAgentX/trae-workbuddy-switch `modules/trae/device.rs:59-151`
+// （salt `devid`/`sess`/`market` 与 SHA256 计数器模式都不能改 —— 改了同 uid 会派生出另一套身份，
+//  在风控眼里等同换设备）。落盘与 gen 自愈见 `account-store.js` 的 ensureMarketIdentity。
+import { createHash, randomBytes } from "node:crypto";
+import { MARKET_DEVICE_GEN } from "./constants.js";
+
+/** 每号 x-device-id 的位数（真机形态：15 位十进制，不是 OAuth 的 32 位 hex）。 */
+export const MARKET_DEVICE_ID_DIGITS = 15;
+/** vscode-sessionid 位数（64 位 hex）。 */
+export const MARKET_SESSION_HEX_LEN = 64;
+
+/**
+ * 确定性字节流：`SHA256("<salt>:<seed>" || u32BE(counter))` 逐块拼接后截断到 nbytes。
+ * seed 为空返回 null —— 调用方必须显式处理「无种子」，不许悄悄退化成不可复现的随机值
+ * （口径同参考实现 device.rs:59-79）。
+ */
+export function seededStream(seed, salt, nbytes) {
+  const s = String(seed || "");
+  if (!s || !(nbytes > 0)) return null;
+  const prefix = Buffer.from(`${salt}:${s}`, "utf8");
+  const out = [];
+  let counter = 0;
+  while (out.length < nbytes) {
+    const h = createHash("sha256");
+    h.update(prefix);
+    const c = Buffer.alloc(4);
+    c.writeUInt32BE(counter >>> 0, 0);
+    h.update(c);
+    out.push(...new Uint8Array(h.digest()));
+    counter = (counter + 1) >>> 0;
+  }
+  return Uint8Array.from(out.slice(0, nbytes));
+}
+
+/** 无种子时的兜底字节（仅在 uid 缺失的异常路径上用到；正常流程永远走确定性派生）。 */
+function fallbackBytes(nbytes) {
+  return new Uint8Array(randomBytes(nbytes));
+}
+
+/**
+ * 生成 n 位十进制数字串（x-device-id 用）。
+ * ⚠ 必须 `String(b % 10)` 出**单个数字字符**，不能写 `String(48 + (b % 10))` ——
+ *   后者在 JS 里是"数字转十进制字符串"（码点 49 → 两个字符 `"49"`），会把 n 字节撑成 2n 位、
+ *   且首位恒为 `4`/`5`。Rust 侧 `char::from(b'0' + b % 10)` 是码点→字符，语义即本行。
+ *   （2026-10-15 移植时真踩过，靠形状断言 `^[0-9]{15}$` 才暴露。）
+ * 每字节出一位，故 seededStream(n) 取 n 字节即得 n 位、无截断。
+ */
+export function marketDigits(seed, n = MARKET_DEVICE_ID_DIGITS) {
+  const bytes = seededStream(seed, "devid", n) || fallbackBytes(n);
+  let out = "";
+  for (const b of bytes) out += String(b % 10);
+  return out;
+}
+
+/** 按任意 salt 派生 n 位十六进制串（needed=ceil(n/2)，n 为偶数时截断是 no-op，奇数 n 靠 slice 截）。 */
+export function marketHexSalted(n, salt, seed) {
+  const needed = Math.ceil(n / 2);
+  const bytes = seededStream(seed, salt, needed) || fallbackBytes(needed);
+  let hex = "";
+  for (const b of bytes) hex += b.toString(16).padStart(2, "0");
+  return hex.slice(0, n);
+}
+
+/** vscode-sessionid 专用（salt 固定 `sess`）。 */
+export function marketSession(seed, n = MARKET_SESSION_HEX_LEN) {
+  return marketHexSalted(n, "sess", seed);
+}
+
+/** 标准 UUID v4 形态（salt 固定 `market`），并置版本位 4 与 RFC4122 变体位，使输出与 uuid4() 一致。 */
+export function marketUuid(seed) {
+  const raw = seededStream(seed, "market", 16) || fallbackBytes(16);
+  const b = Array.from(raw);
+  b[6] = (b[6] & 0x0f) | 0x40;
+  b[8] = (b[8] & 0x3f) | 0x80;
+  const hex = b.map((x) => x.toString(16).padStart(2, "0")).join("");
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;
+}
+
+/**
+ * 按 uid 派生完整市场身份（不落盘）。`created` 只在**新生成**时盖时间戳，
+ * 复用盘上旧值时由调用方保留原 created（换 created 不影响身份稳定性）。
+ */
+export function deriveMarketIdentity(uid) {
+  const seed = String(uid || "").trim();
+  return {
+    deviceId: marketDigits(seed, MARKET_DEVICE_ID_DIGITS),
+    marketUserId: marketUuid(seed),
+    sessionId: marketSession(seed),
+    created: new Date().toISOString(),
+    gen: MARKET_DEVICE_GEN,
+  };
+}
+
+/**
+ * 校验一份存量 market 块是否可用：三件齐、形状对、gen 不小于当前算法版本。
+ * 任一不满足都返回 false → 调用方重新派生并回写（对应参考实现的「gen 缺失按 1 处理，下次取用就地重建」）。
+ */
+export function marketUsable(m) {
+  if (!m || typeof m !== "object") return false;
+  if (Number(m.gen || 0) < MARKET_DEVICE_GEN) return false;
+  if (!/^[0-9]{15}$/.test(String(m.deviceId || ""))) return false;
+  if (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(String(m.marketUserId || ""))) return false;
+  if (!/^[0-9a-f]{64}$/.test(String(m.sessionId || ""))) return false;
+  return true;
+}