dsh-scnet-connect 1.1.1 → 1.2.0

package/README.md

@@ -141,6 +141,27 @@ dsh plugin --profile desktop add link:.
 
 登录成功后插件会自动换取模型 Key，无需其他操作。
 
+**没有 SCNet 账号也能用。** 插件会根据平台返回的「该手机号是否已注册」自动选路：
+
+| 手机号状态 | 插件行为 |
+| --- | --- |
+| 已注册 | 走短信快捷登录，直接进入 |
+| 未注册 | **自动为你注册一个 SCNet 账号**，然后继续登录 |
+
+注册由平台完成（等同于你在官网用手机号注册），插件只负责发起与跟随跳转。
+完成后设置页会提示「登录成功，已为你自动注册 SCNet 账号」，不会静默建号。
+
+新账号第一次换取模型 Key 时，平台会回「模型服务尚未开通」；插件会自动调用
+平台的 `account/config/authorize` 完成开通再重试，全程无需你去控制台操作。
+
+> **如果提示「平台把这次提交当成了账号密码登录」**：说明平台把这次短信提交
+> 落到了它的密码分支。请点「刷新验证码」重新获取图形验证码，再重新发送一次
+> 短信码重试。插件会把平台返回的原始码与原文记进
+> `$DSH_HOME/scnet-connect-status.json` 的 `login.lastFailure`，
+> 方便反馈问题时定位。
+>
+> 登录页面的报错一律显示中文；平台原始英文文案只进诊断文件，不会出现在界面上。
+
 ### 方式二：用本机 SCNet 客户端
 
 先装好 SCNet 客户端并登录，正常发起一次对话（让客户端把凭据落到本地）。

package/lib/client.js

@@ -558,6 +558,11 @@ window.__ModuleLoader__.load({
           setSmsCode('');
           setSmsSent(false);
           setCooldown(0);
+          // 未注册手机号走注册通道：账号是这次顺带建出来的，必须告知用户，
+          // 否则他只会疑惑「我没注册过，怎么就能用了」。
+          if (result.via === 'register') {
+            setNotice({ kind: 'ok', text: '登录成功，已为你自动注册 SCNet 账号' });
+          }
         } else if (result && result.error) {
           setNotice({ kind: 'error', text: result.error });
         }

package/lib/index.js

@@ -676,6 +676,10 @@ export async function apply(ctx, config) {
         lastValidatedAt: loginState.lastValidatedAt,
         pending: loginState.pending,
         error: loginState.error,
+        // 平台原始失败信息（码 + 原文）。界面只用中文提示，这里是排查依据：
+        // 「短信登录却回 Username or password is incorrect」这类问题，
+        // 没有原始码就只能靠猜。
+        lastFailure: loginState.lastFailure,
         loginPageUrl: loginState.loginPageUrl,
         sessionFile: login.sessionFilePath(),
         // 现读，不沿用启动时的快照：用户中途装了客户端也要如实反映。
@@ -904,7 +908,10 @@ export async function apply(ctx, config) {
               await catalog.refresh();
               rebuild();
             }
-            await loginResponse(result.ok ? { ok: true } : { ok: false, error: result.error })(res);
+            await loginResponse(
+              // `via` 会把「这次是登录还是顺手注册了新账号」带到设置页。
+              result.ok ? { ok: true, via: result.via } : { ok: false, error: result.error },
+            )(res);
           }),
         );
 

package/lib/scnet-login.js

@@ -30,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 天；过期或被清空时自动重换。 */
@@ -99,6 +99,13 @@ export function createLoginManager(options = {}) {
   let pending;
   let phase = session ? 'authorized' : 'idle';
   let lastError;
+  /**
+   * 最近一次登录失败的原始码与原文（诊断用）。
+   *
+   * 界面只显示中文提示；但「平台到底回了什么」是排查这类
+   * 「明明是短信登录却收到密码错误」问题的唯一线索，必须留下来。
+   */
+  let lastFailure;
   let inflight;
   let lastValidatedAt = 0;
   /**
@@ -123,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(),
     };
   }
@@ -154,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) {
@@ -176,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(
@@ -201,6 +217,7 @@ export function createLoginManager(options = {}) {
         source,
       },
       signal,
+      via,
     );
   }
 
@@ -234,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';
@@ -296,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);
     },
 
     /** 平台会话是否还活着。 */

package/lib/scnet-platform.js

@@ -198,19 +198,51 @@ export async function resolveSession(options = {}) {
  * 走「活动 Key」端点（客户端刷新凭据时优先用它）：同一账号拿到的 key 与客户端
  * 落盘的是同一个，不会每次刷新都新建 key。
  *
- * @param {{ cookies: any, signal?: AbortSignal }} options
+ * **新账号要自动开通模型服务**：全新注册的账号调这个端点会得到
+ * `{"msg":"模型服务尚未开通"}`。平台客户端遇到它时会先调
+ * `/acx/llm/account/config/authorize` 开通，再重试 —— 这里照做，
+ * 否则「自动注册」只能走到「账号建好了但拿不到 key」，等于白注册。
+ *
+ * @param {{ cookies: any, accountId?: string, signal?: AbortSignal }} options
  * @returns {Promise<{ ok: true, key: string, baseUrl?: string } | { ok: false, reason: string, message?: string }>}
  */
 export async function ensureApiKey(options = {}) {
   const cookies = normalizeCookies(options.cookies);
   if (!cookies) return { ok: false, reason: 'missing-cookies' };
-  try {
+
+  async function createOnce() {
     const result = await platformRequest('/acx/llm/api-key/createActivityApiKey', {
       method: 'POST',
       cookies,
       body: {},
       signal: options.signal,
     });
+    return result;
+  }
+
+  try {
+    let result = await createOnce();
+
+    // 「模型服务尚未开通」→ 开通一次后重试。只重试一次，避免开通失败时死循环。
+    const firstMsg = String(result.body?.msg || result.body?.message || '');
+    if (result.status === 200 && /尚未开通|not\s*(been\s*)?(opened|enabled|activated)/i.test(firstMsg)) {
+      const accountId = options.accountId || (await resolveAccountId(cookies, options.signal));
+      if (accountId) {
+        try {
+          await platformRequest('/acx/llm/account/config/authorize', {
+            method: 'POST',
+            cookies,
+            // accountId 必须放 body：放 query 平台会回 API010006「无权限访问」。
+            body: { accountId },
+            signal: options.signal,
+          });
+        } catch {
+          // 开通失败就继续往下走，让调用方看到原始的「尚未开通」，而不是被这里吞掉。
+        }
+        result = await createOnce();
+      }
+    }
+
     if (result.status === 401) return { ok: false, reason: 'expired' };
     if (result.status !== 200 || !result.body) {
       const msg = result.body?.msg || result.body?.message || `HTTP ${result.status}`;
@@ -219,7 +251,13 @@ export async function ensureApiKey(options = {}) {
     const data = unwrap(result.body);
     const key = typeof data === 'string' ? data : data?.apiKey;
     if (typeof key !== 'string' || !key.startsWith('sk-')) {
-      return { ok: false, reason: 'invalid-response', message: '平台没有返回 sk- 开头的模型服务 Key' };
+      // 走到这里多半还是「模型服务尚未开通」一类，把平台原话带上，别只说「没返回 key」。
+      const msg = result.body?.msg || result.body?.message;
+      return {
+        ok: false,
+        reason: 'invalid-response',
+        message: msg ? `平台返回：${msg}` : '平台没有返回 sk- 开头的模型服务 Key',
+      };
     }
     return {
       ok: true,
@@ -235,6 +273,25 @@ export async function ensureApiKey(options = {}) {
   }
 }
 
+/**
+ * 取当前登录账号的 id（开通模型服务要用）。
+ *
+ * 失败返回 `undefined`：拿不到 id 时上层仍然会尝试换 key，只是跳过开通。
+ */
+async function resolveAccountId(cookies, signal) {
+  try {
+    const result = await platformRequest('/acx/user/users/current-user-info?includeToken=true&refresh=true', {
+      cookies,
+      signal,
+    });
+    const data = unwrap(result.body);
+    const id = data?.id ?? data?.accountId ?? data?.userId;
+    return id ? String(id) : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
 /** 让平台侧会话失效（尽力而为，失败不影响本地清理）。 */
 export async function logout(options = {}) {
   const cookies = normalizeCookies(options.cookies);

package/lib/scnet-web-login.js

@@ -177,6 +177,12 @@ export function createWebLogin(options = {}) {
   const signal = options.signal;
   /** 上一次发码用的手机号（提交时要与之一致）。 */
   let pendingPhone;
+  /**
+   * 上一条短信码发给的号是否已注册（`sendSmsCode` 写入，`submit` 读取）。
+   *
+   * `undefined` = 还没发过码，不知道；`true`/`false` = 平台明确告知过。
+   */
+  let pendingRegistered;
 
   /** 抓一张图形验证码（平台在短信登录/风控时要求）。 */
   async function captcha() {
@@ -192,7 +198,15 @@ export function createWebLogin(options = {}) {
   /**
    * 发送手机验证码。
    *
-   * `1004`（手机号已注册）是**成功**，不是失败 —— 见文件头注释。
+   * 返回值里的 `registered` 是**后续分派通道的依据**，不能丢：
+   *
+   *   code === '1004' → 该手机号已注册 → 提交时走 `/sso/auth/login.action`
+   *   code === '0'    → 该手机号未注册 → 提交时走 `/sso/registerByMobilephoneNum.action`
+   *
+   * 平台前端就是这么做的（`Login-*.js` 里 `T.value="phone"` / `"quick"`）。
+   * 早期版本把两者都当「成功」但**没记住区别**，对未注册号仍调登录接口，
+   * 平台查无此人 → `401 Username or password is incorrect` —— 用户看到的是
+   * 密码错误，实际原因却是「这个手机号没有账号」。
    */
   async function sendSmsCode(phone, captchaCode) {
     if (!isPlausiblePhone(phone)) return { ok: false, reason: 'invalid-phone', message: '手机号格式不对' };
@@ -220,8 +234,9 @@ export function createWebLogin(options = {}) {
     const code = res.json ? String(res.json.code) : '';
     if (res.json && SMS_OK_CODES.has(code)) {
       pendingPhone = mobilephoneNum;
-      // 1004 = 该手机号已注册 → 平台会走「快捷登录」，对登录来说完全正常。
-      return { ok: true, registered: code === '1004', code };
+      /** 记住这个号注册没注册，`submit()` 要用它选通道。 */
+      pendingRegistered = code === '1004';
+      return { ok: true, registered: pendingRegistered, code };
     }
     return {
       ok: false,
@@ -245,20 +260,47 @@ export function createWebLogin(options = {}) {
       return { ok: false, reason: 'invalid-params', message: '请填写短信验证码' };
     }
 
-    const res = await webPost(
-      jar,
-      '/sso/auth/login.action',
-      encodeBody({
-        service: serviceUrl(),
-        originalUrl: webLoginUrl(),
-        sensorsAnonId: '',
-        captcha: form.captcha || '',
-        mobilephoneNum,
-        messageCode: form.smsCode,
-        mode: '2',
-      }),
-      { signal, timeoutMs: 25_000 },
-    );
+    /**
+     * 按发码时平台告知的注册状态选通道。
+     *
+     * 这一步是整套免客户端登录能否覆盖「新用户」的关键：
+     *   · 已注册号 → `/sso/auth/login.action`（mode=2 快捷登录）
+     *   · 未注册号 → `/sso/registerByMobilephoneNum.action`（注册即登录）
+     *
+     * 两者拿到的 `data` 都是带 ticket 的跳转地址，后续处理完全一致。
+     *
+     * `pendingRegistered` 为 `undefined`（没发过码，或用户直接提交）时退回登录
+     * 接口：平台对已注册号必然成功；对未注册号会回 401，届时错误信息已由
+     * `mapLoginError` + `translatePlatformMessage` 翻成可读中文。
+     */
+    const viaRegister = pendingRegistered === false;
+    const path = viaRegister ? '/sso/registerByMobilephoneNum.action' : '/sso/auth/login.action';
+
+    const fields = viaRegister
+      ? {
+          mobilephoneNum,
+          messageCode: form.smsCode,
+          // 注册接口把这几项当必填（缺 createBy 会 400）。
+          createBy: 'scnet',
+          siteCode: 'sacp',
+          invitationCode: '',
+          fullName: '',
+          institution: '',
+          service: serviceUrl(),
+          originalUrl: webLoginUrl(),
+          sensorsAnonId: '',
+        }
+      : {
+          service: serviceUrl(),
+          originalUrl: webLoginUrl(),
+          sensorsAnonId: '',
+          captcha: form.captcha || '',
+          mobilephoneNum,
+          messageCode: form.smsCode,
+          mode: '2',
+        };
+
+    const res = await webPost(jar, path, encodeBody(fields), { signal, timeoutMs: 25_000 });
 
     if (!res.json) {
       return { ok: false, reason: 'invalid-response', message: `HTTP ${res.status}` };
@@ -268,7 +310,9 @@ export function createWebLogin(options = {}) {
         ok: false,
         reason: mapLoginError(String(res.json.code), res.json.msg),
         code: res.json.code,
-        message: res.json.msg || '登录失败',
+        message: res.json.msg || (viaRegister ? '注册失败' : '登录失败'),
+        /** 便于上层区分「注册通道失败」与「登录通道失败」。 */
+        via: viaRegister ? 'register' : 'login',
       };
     }
 
@@ -283,10 +327,12 @@ export function createWebLogin(options = {}) {
       return {
         ok: false,
         reason: 'no-session-cookie',
-        message: '平台返回登录成功，但没有下发会话 Cookie（可能是风控拦截）。',
+        message: '平台返回成功，但没有下发会话 Cookie（可能是风控拦截）。',
       };
     }
-    return { ok: true, cookies };
+    // 到此为止这个号一定已经在平台上存在了。
+    pendingRegistered = true;
+    return { ok: true, cookies, via: viaRegister ? 'register' : 'login' };
   }
 
   /** 跟随 ticket 跳转，收集平台下发的会话 Cookie。 */
@@ -361,15 +407,32 @@ export function mapSmsError(code, message) {
   }
 }
 
-/** 登录错误码 → 插件判定（平台码表见网页 `Login-*.js`）。 */
+/**
+ * 登录错误码 → 插件判定（平台码表见网页 `Login-*.js` 的 `Ce` 表）。
+ *
+ * 平台对「短信验证码提交」的 `mode=2` 分支实测只会回 1009 / 1005 / 1004 / 3002；
+ * 但**密码**分支（`mode=0`）会回 `401 Username or password is incorrect`。
+ * v1.1.1 及更早版本的表里没有 `401`，于是它落到 `default` 被归成 `rejected`，
+ * 提示文案直接回退成平台那串英文原文 —— 用户在设置页看到
+ * 「Username or password is incorrect」却明明是在用短信登录，正是这个缺口。
+ *
+ * 因此这里补上 `401`/`1008` 分支，并给 `default` 加英文兜底识别：
+ * 不管平台以后新增什么码，都不该把英文原文直接甩给用户。
+ */
 export function mapLoginError(code, message) {
   const text = String(message || '');
   switch (code) {
+    case '401':
+      // 平台密码分支的「账号或密码错」。短信登录收到它说明提交没被当成 mode=2，
+      // 归到 auth-failed，由上层给出可操作的中文提示。
+      return 'auth-failed';
     case '1004':
       // 对登录来说 1004 不是错误；真出现时按「账号问题」提示，不要误导成失败。
       return 'auth-failed';
     case '1005':
       return 'auth-failed';
+    case '1008':
+      return 'user-not-exist';
     case '1009':
     case '3002':
       return 'captcha-invalid';
@@ -381,7 +444,36 @@ export function mapLoginError(code, message) {
       return 'too-many-attempts';
     default:
       if (/too many|频繁|次数/i.test(text)) return 'too-many-attempts';
+      if (/username or password/i.test(text)) return 'auth-failed';
+      if (/user (not exist|does not exist)|not registered/i.test(text)) return 'user-not-exist';
+      if (/expired|过期/i.test(text)) return 'captcha-invalid';
       if (/验证码|captcha/i.test(text)) return 'captcha-invalid';
       return 'rejected';
   }
 }
+
+/**
+ * 把平台英文原文翻成中文，保证设置页永远不出现英文报错。
+ *
+ * 平台很多接口的 `msg` 是英文（`Username or password is incorrect`、
+ * `Invalid parameters`…），而插件此前只对**已知码**给中文、
+ * 未知码直接把原文抛给用户。这里做最后一道兜底。
+ *
+ * @param {string} message 平台原始 msg
+ * @returns {string} 中文提示；无匹配时给出通用文案
+ */
+export function translatePlatformMessage(message) {
+  const text = String(message || '').trim();
+  if (!text) return '';
+  // 已经是中文就不用再翻。
+  if (/[\u4e00-\u9fa5]/.test(text)) return text;
+  if (/username or password/i.test(text)) return '平台把这次提交当成了「账号密码登录」，请重新获取短信验证码再试';
+  if (/invalid verification code|code has expired/i.test(text)) return '短信验证码不正确或已失效，请重新获取';
+  if (/invalid parameters/i.test(text)) return '提交参数不完整，请检查手机号与验证码';
+  if (/too often|too frequent|in 60 seconds/i.test(text)) return '发送太频繁，请稍后再试';
+  if (/virtual/i.test(text)) return '不支持虚拟号段';
+  if (/not exist|not registered/i.test(text)) return '该手机号尚未注册 SCNet 账号';
+  if (/too many/i.test(text)) return '尝试次数过多，请稍后再试';
+  if (/signature failed/i.test(text)) return '图形验证码签名校验失败，请刷新验证码';
+  return '平台拒绝了这次登录请求，请稍后重试';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-scnet-connect",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "把 SCNet 模型接入 DeepSeek Harness，可免客户端登录，使用免费模型（SCNet-Max，基座基本可确定为 DeepSeek Flash）",
   "type": "module",
   "main": "./lib/index.js",