dsh-scnet-connect 1.1.0 → 1.2.0

package/lib/scnet-catalog.js

@@ -22,9 +22,26 @@ import { DEFAULT_BASE_URL, DEFAULT_MODEL_ID, FREE_PRICE_LABEL } from './scnet-mo
 
 /** 目录缓存有效期。 */
 export const CATALOG_CACHE_TTL_MS = 60_000;
+/** 目录 mtime 复查间隔（DSH 会高频调用 `getModels()`，不做节流就是每请求一次 stat）。 */
+const STAT_THROTTLE_MS = 5_000;
 /** 网关校验超时。 */
 const GATEWAY_TIMEOUT_MS = 8_000;
 
+/**
+ * 目录不可用时的兜底模型。
+ *
+ * 必须带上与平台一致的输入能力：只写 `{ id, priceLabel }` 会让描述符退化成
+ * 纯文本（`buildModel` 对「有元数据但没写 input」按纯文本处理），
+ * 于是没装客户端的用户会平白丢掉图片能力。
+ */
+export const BUILTIN_MODEL = Object.freeze({
+  id: DEFAULT_MODEL_ID,
+  priceLabel: FREE_PRICE_LABEL,
+  input: ['text', 'image'],
+  reasoning: false,
+  thinkingMode: 'levels',
+});
+
 /**
  * 从客户端目录里挑出免费模型。
  *
@@ -104,10 +121,16 @@ export function createModelCatalog(options = {}) {
   /** @type {{ models: any[], source: string, path?: string, modifiedAt?: number, updatedAt: string, gateway?: any, error?: string } | undefined} */
   let snapshot;
   let readAt = 0;
+  /** 最近一次 stat 得到的目录 mtime（用于发现客户端刷新了目录）。 */
+  let lastMtime;
+  let lastStatAt = 0;
 
   function readFromDisk() {
     const catalog = readClientCatalog({ modelsPath });
     const updatedAt = new Date().toISOString();
+    // 目录不存在时也要有 mtime 基线，否则「后来才出现的目录」不会被察觉
+    // （`modifiedAt === undefined` 会让 fileChanged 永远为 false）。
+    const modifiedAt = catalog?.modifiedAt ?? fileMtime();
     if (explicitIds.length > 0) {
       const byId = new Map((catalog?.models ?? []).map((model) => [model.id.toLowerCase(), model]));
       const models = explicitIds.map((id) => byId.get(id.toLowerCase()) ?? { id, priceLabel: 'unknown' });
@@ -115,7 +138,7 @@ export function createModelCatalog(options = {}) {
         models,
         source: 'config',
         path: catalog?.path,
-        modifiedAt: catalog?.modifiedAt,
+        modifiedAt,
         updatedAt,
       };
     }
@@ -129,15 +152,15 @@ export function createModelCatalog(options = {}) {
           models: [...preferred, ...rest],
           source: 'client-catalog-all',
           path: catalog.path,
-          modifiedAt: catalog.modifiedAt,
+          modifiedAt,
           updatedAt,
         };
       }
       return {
-        models: [{ id: DEFAULT_MODEL_ID, priceLabel: FREE_PRICE_LABEL }],
+        models: [{ ...BUILTIN_MODEL }],
         source: 'builtin',
         path: catalog?.path,
-        modifiedAt: catalog?.modifiedAt,
+        modifiedAt,
         updatedAt,
         error: '未找到客户端模型目录（~/.sclaw/agent/models.json），已退回内置 SCNet-Max',
       };
@@ -148,15 +171,15 @@ export function createModelCatalog(options = {}) {
         models: free,
         source: 'client-catalog',
         path: catalog.path,
-        modifiedAt: catalog.modifiedAt,
+        modifiedAt,
         updatedAt,
       };
     }
     return {
-      models: [{ id: DEFAULT_MODEL_ID, priceLabel: FREE_PRICE_LABEL }],
+      models: [{ ...BUILTIN_MODEL }],
       source: catalog ? 'client-catalog-empty' : 'builtin',
       path: catalog?.path,
-      modifiedAt: catalog?.modifiedAt,
+      modifiedAt,
       updatedAt,
       error: catalog
         ? '客户端模型目录里没有标记为 free 的模型，已退回内置 SCNet-Max'
@@ -164,14 +187,27 @@ export function createModelCatalog(options = {}) {
     };
   }
 
-  /** 同步读取（带 TTL 缓存）。 */
+  /**
+   * 同步读取（带 TTL 缓存 + stat 节流）。
+   *
+   * DSH 会频繁调用 `getModels()`；`stat` 本身不贵，但每次请求都打一次系统调用
+   * 没有意义，因此目录 mtime 最多每 {@link STAT_THROTTLE_MS} 复查一次。
+   */
   function current() {
     const now = Date.now();
     const expired = now - readAt > CATALOG_CACHE_TTL_MS;
-    const fileChanged = snapshot?.modifiedAt !== undefined && fileMtime() !== snapshot.modifiedAt;
+    let fileChanged = false;
+    if (snapshot !== undefined && now - lastStatAt > STAT_THROTTLE_MS) {
+      lastStatAt = now;
+      const mtime = fileMtime();
+      fileChanged = mtime !== lastMtime;
+      lastMtime = mtime;
+    }
     if (!snapshot || expired || fileChanged) {
       snapshot = readFromDisk();
       readAt = now;
+      lastStatAt = now;
+      lastMtime = fileMtime();
     }
     return snapshot;
   }
@@ -184,13 +220,18 @@ export function createModelCatalog(options = {}) {
     }
   }
 
-  /** 强制重新读取，并（可选）用网关校验可用性。 */
+  /**
+   * 强制重新读取，并（可选）用网关校验可用性。
+   *
+   * `resolveKey` 允许返回 Promise：免客户端模式下缓存的 key 可能已过期，
+   * 刷新时现换一个再校验，否则会拿过期 key 去请求网关、误报「校验失败」。
+   */
   async function refresh() {
     const fresh = readFromDisk();
     if (verifyWithGateway) {
       let key = '';
       try {
-        key = resolveKey() || '';
+        key = (await resolveKey()) || '';
       } catch {
         key = '';
       }
@@ -212,6 +253,8 @@ export function createModelCatalog(options = {}) {
     }
     snapshot = fresh;
     readAt = Date.now();
+    lastStatAt = readAt;
+    lastMtime = fileMtime();
     return snapshot;
   }
 

package/lib/scnet-credential.js

@@ -147,7 +147,11 @@ function normalizeModelEntry(found) {
     input: input && input.length > 0 ? input : undefined,
     contextWindow: typeof found.contextWindow === 'number' ? found.contextWindow : undefined,
     maxTokens: typeof found.maxTokens === 'number' ? found.maxTokens : undefined,
-    toolCalling: found.toolCalling === true ? true : undefined,
+    // `toolCalling` / `thinkingMode` 以前读了不用（描述符里没有对应字段），
+    // 现在它们参与两件事：设置页标注「不支持工具」，以及判断是否真的能展示思考等级。
+    toolCalling: typeof found.toolCalling === 'boolean' ? found.toolCalling : undefined,
+    thinkingMode: typeof found.thinkingMode === 'string' ? found.thinkingMode : undefined,
+    reasoning: typeof found.reasoning === 'boolean' ? found.reasoning : undefined,
     priceLabel: typeof found.priceLabel === 'string' ? found.priceLabel : undefined,
   };
 }
@@ -194,20 +198,6 @@ export function readClientCatalog(options = {}) {
   return { path: modelsPath, modifiedAt, models, visibleModelIds };
 }
 
-/**
- * 读取客户端的模型目录，返回 scnet provider 下某个模型的元数据。
- * 目录不存在或没有该模型时返回 undefined（调用方使用内置默认值）。
- *
- * @param {string} modelId
- * @param {{ modelsPath?: string }} [options]
- * @returns {{ id: string, name?: string, input?: string[], contextWindow?: number, maxTokens?: number, toolCalling?: boolean, priceLabel?: string } | undefined}
- */
-export function readClientModelMeta(modelId, options = {}) {
-  const catalog = readClientCatalog(options);
-  const target = modelId.trim().toLowerCase();
-  return catalog?.models.find((m) => m.id.toLowerCase() === target);
-}
-
 /** 把手机号抹成 138****1234（客户端本身也可能已脱敏）。 */
 function maskPhone(value) {
   if (typeof value !== 'string') return undefined;

package/lib/scnet-login.js

@@ -23,8 +23,6 @@ import path from 'node:path';
 
 import {
   PENDING_TTL_MS,
-  PLATFORM_BASE_URL,
-  cookieHeader,
   ensureApiKey,
   logout,
   normalizeCookies,
@@ -32,7 +30,7 @@ import {
   sessionFilePath,
   webLoginUrl,
 } from './scnet-platform.js';
-import { createWebLogin, mapLoginError } from './scnet-web-login.js';
+import { createWebLogin, mapLoginError, translatePlatformMessage } from './scnet-web-login.js';
 import { maskKey } from './scnet-credential.js';
 
 /** 平台会话换来的 key 缓存 6 天；过期或被清空时自动重换。 */
@@ -101,6 +99,13 @@ export function createLoginManager(options = {}) {
   let pending;
   let phase = session ? 'authorized' : 'idle';
   let lastError;
+  /**
+   * 最近一次登录失败的原始码与原文（诊断用）。
+   *
+   * 界面只显示中文提示；但「平台到底回了什么」是排查这类
+   * 「明明是短信登录却收到密码错误」问题的唯一线索，必须留下来。
+   */
+  let lastFailure;
   let inflight;
   let lastValidatedAt = 0;
   /**
@@ -125,6 +130,8 @@ export function createLoginManager(options = {}) {
       lastValidatedAt: lastValidatedAt ? new Date(lastValidatedAt).toISOString() : undefined,
       pending: pending ? { startedAt: pending.startedAt, expiresAt: pending.expiresAt } : undefined,
       error: lastError,
+      /** 原始失败信息（码 + 平台原文），供诊断；不含任何凭据。 */
+      lastFailure,
       loginPageUrl: webLoginUrl(),
     };
   }
@@ -156,10 +163,17 @@ export function createLoginManager(options = {}) {
     return { ok: false, error: reason, ...snapshot() };
   }
 
-  /** 会话到手后立刻换 API Key。失败时保留会话（用户不必重新登录）。 */
-  async function finishAuthorization(raw, signal) {
+  /**
+   * 会话到手后立刻换 API Key。失败时保留会话（用户不必重新登录）。
+   *
+   * @param {'register' | 'login'} [via] 这条会话是「自动注册」还是「登录」拿到的
+   */
+  async function finishAuthorization(raw, signal, via) {
     const startedAt = epoch;
-    const keyed = await ensureApiKey({ cookies: raw.cookies, signal });
+    // 带上 accountId：新账号首次换 key 会回「模型服务尚未开通」，
+    // ensureApiKey 需要用它在平台侧开通服务后重试。
+    const accountId = raw.account?.id ?? raw.account?.accountId ?? raw.account?.userId;
+    const keyed = await ensureApiKey({ cookies: raw.cookies, accountId, signal });
     // 换 key 期间用户又点了退出/重新登录：这次结果不再代表当前意图。
     if (startedAt !== epoch) return { ok: false, error: '登录已被取消', ...snapshot() };
     if (!keyed.ok) {
@@ -178,15 +192,15 @@ export function createLoginManager(options = {}) {
     });
     lastValidatedAt = now.getTime();
     logger.info(
-      `免客户端登录完成：${raw.account?.userName || raw.account?.userId || '未知账号'}（来源：${
-        '短信登录'
+      `免客户端登录完成：${raw.account?.userName || raw.account?.userId || '未知账号'}（${
+        via === 'register' ? '短信登录 · 已自动注册新账号' : '短信登录'
       }，key=${maskKey(keyed.key)}）`,
     );
     return { ok: true, ...snapshot() };
   }
 
   /** 把任意会话来源收敛成「验证身份 → 换 key」。 */
-  async function authorizeFromCookies(cookies, source, signal) {
+  async function authorizeFromCookies(cookies, source, signal, via) {
     const verified = await resolveSession({ cookies, signal });
     if (!verified.ok) {
       return fail(
@@ -203,6 +217,7 @@ export function createLoginManager(options = {}) {
         source,
       },
       signal,
+      via,
     );
   }
 
@@ -236,7 +251,9 @@ export function createLoginManager(options = {}) {
           return undefined;
         }
         lastValidatedAt = Date.now();
-        const keyed = await ensureApiKey({ cookies: verified.cookies, signal });
+        const renewId =
+          verified.user?.id ?? verified.user?.accountId ?? session.account?.id ?? session.account?.accountId;
+        const keyed = await ensureApiKey({ cookies: verified.cookies, accountId: renewId, signal });
         if (startedAt !== epoch) return undefined;
         if (!keyed.ok) {
           phase = 'failed';
@@ -265,15 +282,6 @@ export function createLoginManager(options = {}) {
       return inflight;
     },
 
-    /** 开一张新的网页登录表单会话（重置验证码/风控状态）。 */
-    beginWebLogin() {
-      webLogin = createWebLogin();
-      pending = { startedAt: Date.now(), expiresAt: new Date(Date.now() + PENDING_TTL_MS).toISOString() };
-      if (phase !== 'authorized') phase = 'pending';
-      lastError = undefined;
-      return { ok: true, ...snapshot() };
-    },
-
     /** 图形验证码（短信登录/风控时用）。返回 data URL，不落盘。 */
     async captcha() {
       if (!webLogin) webLogin = createWebLogin();
@@ -307,17 +315,29 @@ export function createLoginManager(options = {}) {
           mapped === 'captcha-invalid'
             ? '短信验证码不正确或已失效，请重新获取'
             : mapped === 'auth-failed'
-              ? '手机号或验证码不正确'
-              : mapped === 'invalid-params'
-                ? '参数不完整，请检查手机号/验证码'
-                : mapped === 'too-many-attempts'
-                  ? '尝试次数过多，请稍后再试'
-                  : result.message || '登录失败';
+              ? translatePlatformMessage(result.message) || '手机号或验证码不正确'
+              : mapped === 'user-not-exist'
+                ? '该手机号尚未注册 SCNet 账号，请先在平台注册'
+                : mapped === 'invalid-params'
+                  ? '参数不完整，请检查手机号/验证码'
+                  : mapped === 'too-many-attempts'
+                    ? '尝试次数过多，请稍后再试'
+                    : mapped === 'server-busy'
+                      ? '平台繁忙，请稍后重试'
+                      // 兜底也要说人话：平台原文多是英文，不能直接甩给用户。
+                      : translatePlatformMessage(result.message) || '登录失败';
+        // 记下原始码与原文，供状态文件/诊断用（界面只显示上面的中文）。
+        lastFailure = {
+          code: result.code !== undefined ? String(result.code) : undefined,
+          rawMessage: result.message,
+          reason: result.reason,
+          at: new Date().toISOString(),
+        };
         // 验证码/风控状态可能需要重开表单。
         if (mapped === 'too-many-attempts' || mapped === 'captcha-invalid') webLogin = undefined;
         return fail(message);
       }
-      return authorizeFromCookies(result.cookies, 'web', form.signal);
+      return authorizeFromCookies(result.cookies, 'web', form.signal, result.via);
     },
 
     /** 平台会话是否还活着。 */
@@ -363,18 +383,6 @@ export function createLoginManager(options = {}) {
       logger.info('已退出免客户端登录（本地会话已清除）');
       return snapshot();
     },
-
-    /** 给「测试连接」用：只读当前 key 与账号，不暴露密文。 */
-    describe() {
-      return {
-        available: Boolean(session?.apiKey),
-        source: session?.source,
-        account: session?.account,
-        cookieHeaderPresent: Boolean(cookieHeader(session?.cookies)),
-      };
-    },
   };
 }
 
-export { PLATFORM_BASE_URL, sessionFilePath };
-

package/lib/scnet-models.js

@@ -63,6 +63,23 @@ export const THINKING_LEVEL_MAP = Object.freeze({
   max: 'max',
 });
 
+/**
+ * 判断客户端目录里的模型是否真的支持思考。
+ *
+ * 目录里 `reasoning: false` 但 `thinkingMode: "levels"` 的模型（当前 SCNet-Max
+ * 就是这种）实际会返回 `reasoning_content`，客户端 UI 也按「分等级」展示；
+ * 所以 `thinkingMode` 是比 `reasoning` 更诚实的信号。两个都没有时保持旧行为
+ * （声明支持），因为网关不认 `reasoning_effort` 时也只会忽略它。
+ *
+ * @param {{ reasoning?: boolean, thinkingMode?: string } | undefined} meta
+ */
+function catalogSupportsReasoning(meta) {
+  if (!meta) return true;
+  if (meta.thinkingMode === 'levels') return true;
+  if (typeof meta.reasoning === 'boolean') return meta.reasoning;
+  return true;
+}
+
 /**
  * 构造 pi-ai 的模型描述符。
  *
@@ -70,7 +87,8 @@ export const THINKING_LEVEL_MAP = Object.freeze({
  *   modelId?: string,
  *   modelName?: string,
  *   baseUrl: string,
- *   meta?: { id?: string, name?: string, input?: string[], contextWindow?: number, maxTokens?: number, toolCalling?: boolean, priceLabel?: string },
+ *   provider?: string,
+ *   meta?: { id?: string, name?: string, input?: string[], contextWindow?: number, maxTokens?: number, toolCalling?: boolean, thinkingMode?: string, reasoning?: boolean, priceLabel?: string },
  *   contextWindow?: number,
  *   maxTokens?: number,
  *   inputImages?: boolean,
@@ -84,17 +102,27 @@ export function buildModel(options) {
   const signedMaxTokens = options.maxTokens && options.maxTokens > 0 ? options.maxTokens : undefined;
   const contextWindow = signedContextWindow ?? meta?.contextWindow ?? DEFAULT_CONTEXT_WINDOW;
   const maxTokens = signedMaxTokens ?? meta?.maxTokens ?? DEFAULT_MAX_TOKENS;
-  const input = options.inputImages === false ? ['text'] : meta?.input?.length ? [...meta.input] : ['text', 'image'];
+  // 目录里有 `input` 就以目录为准（没写就是纯文本）；连元数据都没有时才按
+  // 「SCNet 网关至少支持文本+图片」给个乐观默认值，避免凭空给陌生模型加图片能力。
+  const input =
+    options.inputImages === false
+      ? ['text']
+      : meta?.input?.length
+        ? [...meta.input]
+        : meta
+          ? ['text']
+          : ['text', 'image'];
+  const supportsReasoning = options.reasoning !== false && catalogSupportsReasoning(meta);
 
   return {
     id: modelId,
     name: options.modelName?.trim() || meta?.name || modelId,
     api: 'openai-completions',
-    provider: 'scnet',
+    provider: options.provider || 'scnet',
     baseUrl: options.baseUrl,
     input,
-    reasoning: options.reasoning !== false,
-    ...(options.reasoning === false ? {} : { thinkingLevelMap: { ...THINKING_LEVEL_MAP } }),
+    reasoning: supportsReasoning,
+    ...(supportsReasoning ? { thinkingLevelMap: { ...THINKING_LEVEL_MAP } } : {}),
     cost: { ...NO_COST },
     contextWindow,
     // 只保证「输出不超过上下文」这一条一致性；不再按模型 id 打 262144/32768 的补丁