@aipanel/provider-deepseek 1.2.24 → 1.2.26

package/es/deepseek-web.d.ts

@@ -6,6 +6,7 @@ import { type ResultPromise } from "execa";
  * 本类在子进程 stdout 就该 URL 打洞解析 token，供 DeepSeekAPI 与代理做认证。
  */
 export declare class LaunchToken {
+    private readonly timeoutMs;
     private token?;
     /** 首次超时后缓存失败：本启动已不可能再打印 token，后续 wait 直接快速失败 */
     private failure?;
@@ -13,17 +14,32 @@ export declare class LaunchToken {
     /** dsh 进程原始输出尾部缓存，超时报错时回填，便于定位真实根因 */
     private stdoutTail;
     private stderrTail;
+    /** dsh 进程是否已 spawn：token 只可能在 spawn 后打印，超时窗口自 arm 起算 */
+    private spawned;
+    private windowTimer?;
+    /** @param timeoutMs token 等待窗口（自 arm 起算，默认 20s） */
+    constructor(timeoutMs?: number);
+    /**
+     * 标记 dsh 进程已 spawn，窗口开始计时。
+     * provider.start 在 spawn 之前还有编排耗时（ensureDshPackage 装插件等，可能数十秒），
+     * 那段时间 web 进程尚未 launch、不可能产出 token，若计入窗口就会误报“token 未捕获”。
+     */
+    arm(): void;
     /** 记录 dsh 进程原始输出（只保留末尾，防止内存无限增长），用于超时报错时辅助诊断 */
     recordOutput(stream: "stdout" | "stderr", text: string): void;
     /** 从子进程输出写入已解析的 token（幂等：只接受第一个） */
     set(token: string): void;
+    /** 令所有等待者失败：本启动不会再产出 token（窗口超时 / provider 已停止） */
+    fail(err: Error): void;
+    /** 窗口到点：输出 dsh web 启动原始日志辅助诊断，再按未捕获 token 判定本次启动失败 */
+    private expire;
     /** 报错时把 dsh web 启动的原始日志作为一条日志整体输出（幂等：每实例只打一次） */
     private printed;
     private printStartupOutput;
     /** 已解析的 token（未就绪时 undefined） */
     get(): string | undefined;
-    /** 等待 token 就绪（默认 20s 超时；未打印则抛错并快速失败，调用方降级处理） */
-    wait(timeoutMs?: number): Promise<string>;
+    /** 等待 token 就绪（未 arm 时一直等；arm 后窗口到点即抛错并快速失败，调用方降级处理） */
+    wait(): Promise<string>;
 }
 export interface DeepSeekWebOptions {
     /** 服务端口 */

package/es/deepseek-web.js

@@ -5,7 +5,9 @@ import { execa } from "execa";
 import { createLogger, getProcessLogBuffer } from "@aipanel/core/node";
 const log = createLogger("DeepSeekWeb");
 class LaunchToken {
-  constructor() {
+  /** @param timeoutMs token 等待窗口（自 arm 起算，默认 20s） */
+  constructor(timeoutMs = 2e4) {
+    __publicField(this, "timeoutMs", timeoutMs);
     __publicField(this, "token");
     /** 首次超时后缓存失败：本启动已不可能再打印 token，后续 wait 直接快速失败 */
     __publicField(this, "failure");
@@ -13,9 +15,23 @@ class LaunchToken {
     /** dsh 进程原始输出尾部缓存，超时报错时回填，便于定位真实根因 */
     __publicField(this, "stdoutTail", "");
     __publicField(this, "stderrTail", "");
+    /** dsh 进程是否已 spawn：token 只可能在 spawn 后打印，超时窗口自 arm 起算 */
+    __publicField(this, "spawned", false);
+    __publicField(this, "windowTimer");
     /** 报错时把 dsh web 启动的原始日志作为一条日志整体输出（幂等：每实例只打一次） */
     __publicField(this, "printed", false);
   }
+  /**
+   * 标记 dsh 进程已 spawn，窗口开始计时。
+   * provider.start 在 spawn 之前还有编排耗时（ensureDshPackage 装插件等，可能数十秒），
+   * 那段时间 web 进程尚未 launch、不可能产出 token，若计入窗口就会误报“token 未捕获”。
+   */
+  arm() {
+    if (this.spawned) return;
+    this.spawned = true;
+    if (this.token !== void 0 || this.failure) return;
+    this.windowTimer = setTimeout(() => this.expire(), this.timeoutMs);
+  }
   /** 记录 dsh 进程原始输出（只保留末尾，防止内存无限增长），用于超时报错时辅助诊断 */
   recordOutput(stream, text) {
     const key = stream === "stdout" ? "stdoutTail" : "stderrTail";
@@ -27,12 +43,31 @@ class LaunchToken {
     if (this.token !== void 0) return;
     this.token = token;
     this.failure = void 0;
+    clearTimeout(this.windowTimer);
     for (const w of this.waiters) {
-      clearTimeout(w.timer);
       w.resolve(token);
     }
     this.waiters = [];
   }
+  /** 令所有等待者失败：本启动不会再产出 token（窗口超时 / provider 已停止） */
+  fail(err) {
+    if (this.failure || this.token !== void 0) return;
+    this.failure = err;
+    clearTimeout(this.windowTimer);
+    for (const w of this.waiters) {
+      w.reject(err);
+    }
+    this.waiters = [];
+  }
+  /** 窗口到点：输出 dsh web 启动原始日志辅助诊断，再按未捕获 token 判定本次启动失败 */
+  expire() {
+    this.printStartupOutput();
+    this.fail(
+      new Error(
+        `dsh launch token was not captured from stdout within ${this.timeoutMs}ms (dsh >= 0.1.2 should print the "dsh web: http://127.0.0.1:<port>/?token=..." URL)`
+      )
+    );
+  }
   printStartupOutput() {
     if (this.printed) return;
     this.printed = true;
@@ -47,25 +82,12 @@ class LaunchToken {
   get() {
     return this.token;
   }
-  /** 等待 token 就绪（默认 20s 超时；未打印则抛错并快速失败，调用方降级处理） */
-  wait(timeoutMs = 2e4) {
+  /** 等待 token 就绪（未 arm 时一直等；arm 后窗口到点即抛错并快速失败，调用方降级处理） */
+  wait() {
     if (this.token !== void 0) return Promise.resolve(this.token);
     if (this.failure) return Promise.reject(this.failure);
     return new Promise((resolve, reject) => {
-      const timer = setTimeout(() => {
-        this.printStartupOutput();
-        const err = new Error(
-          `dsh launch token was not captured from stdout within ${timeoutMs}ms (dsh >= 0.1.2 should print the "dsh web: http://127.0.0.1:<port>/?token=..." URL)`
-        );
-        this.failure = err;
-        for (const w of this.waiters) {
-          clearTimeout(w.timer);
-          w.reject(err);
-        }
-        this.waiters = [];
-        reject(err);
-      }, timeoutMs);
-      this.waiters.push({ resolve, reject, timer });
+      this.waiters.push({ resolve, reject });
     });
   }
 }
@@ -89,6 +111,7 @@ function startDeepSeekWeb(options) {
     cwd,
     home: home ?? process.env.DSH_HOME
   });
+  launchToken?.arm();
   const proc = execa("dsh", args, {
     cwd,
     reject: false,

package/es/provider.d.ts

@@ -27,6 +27,8 @@ export declare class DeepSeekWebProvider implements WebProvider {
     private readonly api;
     private deps;
     private process;
+    /** 本次启动的 token 捕获器：stop 时令其等待者快速失败，避免请求一直挂起 */
+    private launchToken;
     /** AIPanel 侧下发的主题偏好（AIPanelWidgetTheme，default auto）：随 client 插件 config 注入，作为启动初值 */
     private uiTheme;
     private readonly opts;

package/es/provider.js

@@ -33,6 +33,8 @@ class DeepSeekWebProvider {
     __publicField(this, "api");
     __publicField(this, "deps");
     __publicField(this, "process", null);
+    /** 本次启动的 token 捕获器：stop 时令其等待者快速失败，避免请求一直挂起 */
+    __publicField(this, "launchToken", null);
     /** AIPanel 侧下发的主题偏好（AIPanelWidgetTheme，default auto）：随 client 插件 config 注入，作为启动初值 */
     __publicField(this, "uiTheme", "auto");
     __publicField(this, "opts");
@@ -86,6 +88,7 @@ Please upgrade:
     });
     const profileDir = dshProfileDir(this.opts.home);
     const launchToken = new LaunchToken();
+    this.launchToken = launchToken;
     this.api.setLaunchTokenSource(() => launchToken.wait());
     const devClientDir = resolveDevDshPackageSource(import.meta.url, "dsh-client", "lib/client.js");
     const providerVersion = readProviderVersion(import.meta.url);
@@ -172,6 +175,8 @@ Please upgrade:
     return { url: this.api.shellUrl, processHandle: proc, webAuthCookie };
   }
   async stop() {
+    this.launchToken?.fail(new Error("dsh web stopped before launch token was captured"));
+    this.launchToken = null;
     if (this.process) {
       log.debug("Killing dsh web process", { pid: this.process.pid });
       this.process.kill("SIGTERM");

package/lib/deepseek-web.cjs

@@ -27,7 +27,9 @@ var import_execa = require("execa");
 var import_node = require("@aipanel/core/node");
 const log = (0, import_node.createLogger)("DeepSeekWeb");
 class LaunchToken {
-  constructor() {
+  /** @param timeoutMs token 等待窗口（自 arm 起算，默认 20s） */
+  constructor(timeoutMs = 2e4) {
+    __publicField(this, "timeoutMs", timeoutMs);
     __publicField(this, "token");
     /** 首次超时后缓存失败：本启动已不可能再打印 token，后续 wait 直接快速失败 */
     __publicField(this, "failure");
@@ -35,9 +37,23 @@ class LaunchToken {
     /** dsh 进程原始输出尾部缓存，超时报错时回填，便于定位真实根因 */
     __publicField(this, "stdoutTail", "");
     __publicField(this, "stderrTail", "");
+    /** dsh 进程是否已 spawn：token 只可能在 spawn 后打印，超时窗口自 arm 起算 */
+    __publicField(this, "spawned", false);
+    __publicField(this, "windowTimer");
     /** 报错时把 dsh web 启动的原始日志作为一条日志整体输出（幂等：每实例只打一次） */
     __publicField(this, "printed", false);
   }
+  /**
+   * 标记 dsh 进程已 spawn，窗口开始计时。
+   * provider.start 在 spawn 之前还有编排耗时（ensureDshPackage 装插件等，可能数十秒），
+   * 那段时间 web 进程尚未 launch、不可能产出 token，若计入窗口就会误报“token 未捕获”。
+   */
+  arm() {
+    if (this.spawned) return;
+    this.spawned = true;
+    if (this.token !== void 0 || this.failure) return;
+    this.windowTimer = setTimeout(() => this.expire(), this.timeoutMs);
+  }
   /** 记录 dsh 进程原始输出（只保留末尾，防止内存无限增长），用于超时报错时辅助诊断 */
   recordOutput(stream, text) {
     const key = stream === "stdout" ? "stdoutTail" : "stderrTail";
@@ -49,12 +65,31 @@ class LaunchToken {
     if (this.token !== void 0) return;
     this.token = token;
     this.failure = void 0;
+    clearTimeout(this.windowTimer);
     for (const w of this.waiters) {
-      clearTimeout(w.timer);
       w.resolve(token);
     }
     this.waiters = [];
   }
+  /** 令所有等待者失败：本启动不会再产出 token（窗口超时 / provider 已停止） */
+  fail(err) {
+    if (this.failure || this.token !== void 0) return;
+    this.failure = err;
+    clearTimeout(this.windowTimer);
+    for (const w of this.waiters) {
+      w.reject(err);
+    }
+    this.waiters = [];
+  }
+  /** 窗口到点：输出 dsh web 启动原始日志辅助诊断，再按未捕获 token 判定本次启动失败 */
+  expire() {
+    this.printStartupOutput();
+    this.fail(
+      new Error(
+        `dsh launch token was not captured from stdout within ${this.timeoutMs}ms (dsh >= 0.1.2 should print the "dsh web: http://127.0.0.1:<port>/?token=..." URL)`
+      )
+    );
+  }
   printStartupOutput() {
     if (this.printed) return;
     this.printed = true;
@@ -69,25 +104,12 @@ class LaunchToken {
   get() {
     return this.token;
   }
-  /** 等待 token 就绪（默认 20s 超时；未打印则抛错并快速失败，调用方降级处理） */
-  wait(timeoutMs = 2e4) {
+  /** 等待 token 就绪（未 arm 时一直等；arm 后窗口到点即抛错并快速失败，调用方降级处理） */
+  wait() {
     if (this.token !== void 0) return Promise.resolve(this.token);
     if (this.failure) return Promise.reject(this.failure);
     return new Promise((resolve, reject) => {
-      const timer = setTimeout(() => {
-        this.printStartupOutput();
-        const err = new Error(
-          `dsh launch token was not captured from stdout within ${timeoutMs}ms (dsh >= 0.1.2 should print the "dsh web: http://127.0.0.1:<port>/?token=..." URL)`
-        );
-        this.failure = err;
-        for (const w of this.waiters) {
-          clearTimeout(w.timer);
-          w.reject(err);
-        }
-        this.waiters = [];
-        reject(err);
-      }, timeoutMs);
-      this.waiters.push({ resolve, reject, timer });
+      this.waiters.push({ resolve, reject });
     });
   }
 }
@@ -111,6 +133,7 @@ function startDeepSeekWeb(options) {
     cwd,
     home: home ?? process.env.DSH_HOME
   });
+  launchToken?.arm();
   const proc = (0, import_execa.execa)("dsh", args, {
     cwd,
     reject: false,

package/lib/deepseek-web.d.ts

@@ -6,6 +6,7 @@ import { type ResultPromise } from "execa";
  * 本类在子进程 stdout 就该 URL 打洞解析 token，供 DeepSeekAPI 与代理做认证。
  */
 export declare class LaunchToken {
+    private readonly timeoutMs;
     private token?;
     /** 首次超时后缓存失败：本启动已不可能再打印 token，后续 wait 直接快速失败 */
     private failure?;
@@ -13,17 +14,32 @@ export declare class LaunchToken {
     /** dsh 进程原始输出尾部缓存，超时报错时回填，便于定位真实根因 */
     private stdoutTail;
     private stderrTail;
+    /** dsh 进程是否已 spawn：token 只可能在 spawn 后打印，超时窗口自 arm 起算 */
+    private spawned;
+    private windowTimer?;
+    /** @param timeoutMs token 等待窗口（自 arm 起算，默认 20s） */
+    constructor(timeoutMs?: number);
+    /**
+     * 标记 dsh 进程已 spawn，窗口开始计时。
+     * provider.start 在 spawn 之前还有编排耗时（ensureDshPackage 装插件等，可能数十秒），
+     * 那段时间 web 进程尚未 launch、不可能产出 token，若计入窗口就会误报“token 未捕获”。
+     */
+    arm(): void;
     /** 记录 dsh 进程原始输出（只保留末尾，防止内存无限增长），用于超时报错时辅助诊断 */
     recordOutput(stream: "stdout" | "stderr", text: string): void;
     /** 从子进程输出写入已解析的 token（幂等：只接受第一个） */
     set(token: string): void;
+    /** 令所有等待者失败：本启动不会再产出 token（窗口超时 / provider 已停止） */
+    fail(err: Error): void;
+    /** 窗口到点：输出 dsh web 启动原始日志辅助诊断，再按未捕获 token 判定本次启动失败 */
+    private expire;
     /** 报错时把 dsh web 启动的原始日志作为一条日志整体输出（幂等：每实例只打一次） */
     private printed;
     private printStartupOutput;
     /** 已解析的 token（未就绪时 undefined） */
     get(): string | undefined;
-    /** 等待 token 就绪（默认 20s 超时；未打印则抛错并快速失败，调用方降级处理） */
-    wait(timeoutMs?: number): Promise<string>;
+    /** 等待 token 就绪（未 arm 时一直等；arm 后窗口到点即抛错并快速失败，调用方降级处理） */
+    wait(): Promise<string>;
 }
 export interface DeepSeekWebOptions {
     /** 服务端口 */

package/lib/provider.cjs

@@ -42,6 +42,8 @@ class DeepSeekWebProvider {
     __publicField(this, "api");
     __publicField(this, "deps");
     __publicField(this, "process", null);
+    /** 本次启动的 token 捕获器：stop 时令其等待者快速失败，避免请求一直挂起 */
+    __publicField(this, "launchToken", null);
     /** AIPanel 侧下发的主题偏好（AIPanelWidgetTheme，default auto）：随 client 插件 config 注入，作为启动初值 */
     __publicField(this, "uiTheme", "auto");
     __publicField(this, "opts");
@@ -95,6 +97,7 @@ Please upgrade:
     });
     const profileDir = (0, import_dsh_install.dshProfileDir)(this.opts.home);
     const launchToken = new import_deepseek_web.LaunchToken();
+    this.launchToken = launchToken;
     this.api.setLaunchTokenSource(() => launchToken.wait());
     const devClientDir = (0, import_dsh_install.resolveDevDshPackageSource)(import_meta.url, "dsh-client", "lib/client.js");
     const providerVersion = (0, import_dsh_install.readProviderVersion)(import_meta.url);
@@ -181,6 +184,8 @@ Please upgrade:
     return { url: this.api.shellUrl, processHandle: proc, webAuthCookie };
   }
   async stop() {
+    this.launchToken?.fail(new Error("dsh web stopped before launch token was captured"));
+    this.launchToken = null;
     if (this.process) {
       log.debug("Killing dsh web process", { pid: this.process.pid });
       this.process.kill("SIGTERM");

package/lib/provider.d.ts

@@ -27,6 +27,8 @@ export declare class DeepSeekWebProvider implements WebProvider {
     private readonly api;
     private deps;
     private process;
+    /** 本次启动的 token 捕获器：stop 时令其等待者快速失败，避免请求一直挂起 */
+    private launchToken;
     /** AIPanel 侧下发的主题偏好（AIPanelWidgetTheme，default auto）：随 client 插件 config 注入，作为启动初值 */
     private uiTheme;
     private readonly opts;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipanel/provider-deepseek",
-  "version": "1.2.24",
+  "version": "1.2.26",
   "type": "module",
   "main": "lib/index.cjs",
   "module": "es/index.js",
@@ -21,7 +21,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@aipanel/core": "1.2.24",
+    "@aipanel/core": "1.2.26",
     "execa": "^9.6.1"
   },
   "devDependencies": {