@aipanel/provider-deepseek 1.3.10 → 1.3.11

package/es/deepseek-web.d.ts

@@ -33,6 +33,13 @@ export declare class LaunchToken {
     fail(err: Error): void;
     /** 窗口到点：输出 dsh web 启动原始日志辅助诊断，再按未捕获 token 判定本次启动失败 */
     private expire;
+    /**
+     * 附上"这次起的是哪个 profile"的上下文（provider 起进程前调用）。
+     * 只加在这里、不进 printStartupOutput：超时的那条错误要能自己说清 profile 与它的 bundle 列表，
+     * 否则症状永远只是"启动超时"（见 profile-check 的注释）。
+     */
+    attachContext(provider: () => string): void;
+    private context?;
     /** 报错时把 dsh web 启动的原始日志作为一条日志整体输出（幂等：每实例只打一次） */
     private printed;
     private printStartupOutput;

package/es/deepseek-web.js

@@ -19,6 +19,7 @@ class LaunchToken {
     /** dsh 进程是否已 spawn：token 只可能在 spawn 后打印，超时窗口自 arm 起算 */
     __publicField(this, "spawned", false);
     __publicField(this, "windowTimer");
+    __publicField(this, "context");
     /** 报错时把 dsh web 启动的原始日志作为一条日志整体输出（幂等：每实例只打一次） */
     __publicField(this, "printed", false);
   }
@@ -63,12 +64,24 @@ class LaunchToken {
   /** 窗口到点：输出 dsh web 启动原始日志辅助诊断，再按未捕获 token 判定本次启动失败 */
   expire() {
     this.printStartupOutput();
+    const context = this.context?.();
+    const base = `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)`;
     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)`
+        context === void 0 || context.trim() === "" ? base : `${base}
+${context}
+\uFF08\u8FD9\u4E2A profile \u8D77\u4E0D\u4E86 Web UI \u65F6\u5C31\u662F\u8FD9\u4E2A\u75C7\u72B6\uFF1A\u5148\u786E\u8BA4\u5B83\u5EFA\u597D\u4E86\uFF09`
       )
     );
   }
+  /**
+   * 附上"这次起的是哪个 profile"的上下文（provider 起进程前调用）。
+   * 只加在这里、不进 printStartupOutput：超时的那条错误要能自己说清 profile 与它的 bundle 列表，
+   * 否则症状永远只是"启动超时"（见 profile-check 的注释）。
+   */
+  attachContext(provider) {
+    this.context = provider;
+  }
   printStartupOutput() {
     if (this.printed) return;
     this.printed = true;

package/es/profile-check.d.ts

@@ -0,0 +1,19 @@
+/** dsh 的 Web 应用 bundle（`dsh web` 的 profile 必有；纯终端类 profile 没有） */
+export declare const DSH_WEB_APP_BUNDLE = "@deepseek-ai/dsh-web-app";
+export type DshProfileProblem = "missing" | "no-web-app";
+export interface DshProfileInspection {
+    /** 这个 profile 现在能不能起 Web UI */
+    readonly ok: boolean;
+    /** 不能时是哪一类问题；能时为 null */
+    readonly problem: DshProfileProblem | null;
+    /** profile 声明的 bundle 列表（读不到时为空数组） */
+    readonly bundles: readonly string[];
+    /** profile 清单文件路径（报错信息里给绝对路径，方便直接去看） */
+    readonly manifest: string;
+}
+/** 读 profile 清单并判断它是否具备启动 Web UI 的条件 */
+export declare function inspectDshProfile(profileDir: string): DshProfileInspection;
+/** 预检没过时给用户的说明（通用措辞：说清是什么、去哪看、怎么修） */
+export declare function profileProblemText(inspection: DshProfileInspection, profileDir: string, profile: string): string;
+/** 启动超时诊断用的一行上下文：profile 在哪、声明了哪些 bundle */
+export declare function describeDshProfile(profileDir: string, profile: string): string;

package/es/profile-check.js

@@ -0,0 +1,41 @@
+import fs from "node:fs";
+import path from "node:path";
+const DSH_WEB_APP_BUNDLE = "@deepseek-ai/dsh-web-app";
+function inspectDshProfile(profileDir) {
+  const manifest = path.join(profileDir, "package.json");
+  let parsed;
+  try {
+    parsed = JSON.parse(fs.readFileSync(manifest, "utf8"));
+  } catch {
+    return { ok: false, problem: "missing", bundles: [], manifest };
+  }
+  const declared = parsed?.dsh?.profile?.bundles;
+  const bundles = Array.isArray(declared) ? declared.filter((one) => typeof one === "string") : [];
+  if (!bundles.includes(DSH_WEB_APP_BUNDLE)) {
+    return { ok: false, problem: "no-web-app", bundles, manifest };
+  }
+  return { ok: true, problem: null, bundles, manifest };
+}
+function profileProblemText(inspection, profileDir, profile) {
+  const head = inspection.problem === "missing" ? `dsh profile "${profile}" \u8FD8\u4E0D\u5B58\u5728\uFF08\u627E\u4E0D\u5230 ${inspection.manifest}\uFF09` : `dsh profile "${profile}" \u91CC\u6CA1\u6709 Web \u5E94\u7528 bundle\uFF08${DSH_WEB_APP_BUNDLE}\uFF09`;
+  const bundles = inspection.bundles.length === 0 ? "\uFF08\u8BFB\u4E0D\u5230 bundle \u5217\u8868\uFF09" : `\u73B0\u6709 bundles\uFF1A${inspection.bundles.join("\u3001")}`;
+  return [
+    `${head}\uFF1A${profileDir}`,
+    `  ${bundles}`,
+    "  dsh \u5728 profile \u7F3A\u5931\u65F6\u4F1A\u81EA\u5DF1\u5EFA\u4E00\u4E2A\u53EA\u6709 @deepseek-ai/dsh-base \u7684\u7A7A\u58F3\uFF0C\u8D77\u6765\u4E0D\u4F1A\u6709\u754C\u9762\uFF1B",
+    "  \u800C provider \u7684\u7F16\u6392\u662F\u300C\u5148\u88C5\u63D2\u4EF6\u3001\u518D\u8D77\u8FDB\u7A0B\u300D\uFF0C\u90A3\u4E00\u6B65\u4F1A\u628A\u7A7A\u58F3\u5EFA\u51FA\u6765\uFF0C\u75C7\u72B6\u53EA\u662F\u542F\u52A8\u8D85\u65F6\u3002",
+    "  \u5148\u628A\u8FD9\u4E2A profile \u5EFA\u597D\uFF08\u5B83\u81EA\u5DF1\u7684\u5B89\u88C5\u6D41\u7A0B\uFF0C\u6216 `dsh <\u540D> --from-default-profile web`\uFF09\u518D\u91CD\u5F00\u3002"
+  ].join("\n");
+}
+function describeDshProfile(profileDir, profile) {
+  const inspection = inspectDshProfile(profileDir);
+  const bundles = inspection.bundles.length === 0 ? "\uFF08\u8BFB\u4E0D\u5230\uFF09" : inspection.bundles.join("\u3001");
+  return `profile: ${profile} (${profileDir})
+bundles: ${bundles}`;
+}
+export {
+  DSH_WEB_APP_BUNDLE,
+  describeDshProfile,
+  inspectDshProfile,
+  profileProblemText
+};

package/es/provider.js

@@ -8,6 +8,7 @@ import { DEFAULT_DEEPSEEK_PROVIDER_OPTIONS, DSH_DEFAULT_PROFILE, DSH_LOOPBACK_HO
 import { DeepSeekAPI } from "./api.js";
 import { LaunchToken, startDeepSeekWeb } from "./deepseek-web.js";
 import { buildDshOverlay, writeDshOverlay } from "./profile.js";
+import { describeDshProfile, inspectDshProfile, profileProblemText } from "./profile-check.js";
 import {
   checkDeepSeekInstalled,
   getDeepSeekVersion,
@@ -91,6 +92,14 @@ Please upgrade:
     const launchToken = new LaunchToken();
     this.launchToken = launchToken;
     this.api.setLaunchTokenSource(() => launchToken.wait());
+    launchToken.attachContext(() => describeDshProfile(profileDir, this.opts.profile));
+    const profileCheck = inspectDshProfile(profileDir);
+    if (!profileCheck.ok) {
+      const reason = profileProblemText(profileCheck, profileDir, this.opts.profile);
+      log.error(reason);
+      launchToken.fail(new Error(reason));
+      throw new Error(reason);
+    }
     const devClientDir = resolveDevDshPackageSource(import.meta.url, "dsh-client", "lib/client.js");
     const providerVersion = readProviderVersion(import.meta.url);
     const clientTarget = devClientDir ?? (providerVersion ? `${DSH_CLIENT_PACKAGE}@${providerVersion}` : `${DSH_CLIENT_PACKAGE}@latest`);

package/es/types.d.ts

@@ -17,7 +17,13 @@ export type DeepSeekBusyEnter = BusyEnterBehavior;
 export type DeepSeekProviderOptions = {
     /** dsh 数据目录（$DSH_HOME），默认跟随系统（~/.dsh） */
     home?: string;
-    /** dsh profile 名（$DSH_HOME/profiles/<name>），默认 "web"；AIPanel 侧插件与 web 进程都指向该 profile */
+    /**
+     * dsh profile 名（$DSH_HOME/profiles/<name>），默认 "web"；AIPanel 侧插件与 web 进程都指向该 profile。
+     *
+     * ⚠️ 该 profile 必须**先建好**：其 `dsh.profile.bundles` 里要有 `@deepseek-ai/dsh-web-app`。
+     * 缺失时 dsh 的 `plugin` 子命令会自己建出一个只有 `@deepseek-ai/dsh-base` 的空壳，
+     * 于是启动只会表现为"等 launch token 超时"（见 profile-check.ts 的预检与说明）。
+     */
     profile?: string;
     /** 默认 Agent 预设（dsh settings agent-presets.default，如 code/standard；新建会话的默认模式） */
     agentPreset?: string;

package/lib/deepseek-web.cjs

@@ -41,6 +41,7 @@ class LaunchToken {
     /** dsh 进程是否已 spawn：token 只可能在 spawn 后打印，超时窗口自 arm 起算 */
     __publicField(this, "spawned", false);
     __publicField(this, "windowTimer");
+    __publicField(this, "context");
     /** 报错时把 dsh web 启动的原始日志作为一条日志整体输出（幂等：每实例只打一次） */
     __publicField(this, "printed", false);
   }
@@ -85,12 +86,24 @@ class LaunchToken {
   /** 窗口到点：输出 dsh web 启动原始日志辅助诊断，再按未捕获 token 判定本次启动失败 */
   expire() {
     this.printStartupOutput();
+    const context = this.context?.();
+    const base = `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)`;
     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)`
+        context === void 0 || context.trim() === "" ? base : `${base}
+${context}
+\uFF08\u8FD9\u4E2A profile \u8D77\u4E0D\u4E86 Web UI \u65F6\u5C31\u662F\u8FD9\u4E2A\u75C7\u72B6\uFF1A\u5148\u786E\u8BA4\u5B83\u5EFA\u597D\u4E86\uFF09`
       )
     );
   }
+  /**
+   * 附上"这次起的是哪个 profile"的上下文（provider 起进程前调用）。
+   * 只加在这里、不进 printStartupOutput：超时的那条错误要能自己说清 profile 与它的 bundle 列表，
+   * 否则症状永远只是"启动超时"（见 profile-check 的注释）。
+   */
+  attachContext(provider) {
+    this.context = provider;
+  }
   printStartupOutput() {
     if (this.printed) return;
     this.printed = true;

package/lib/deepseek-web.d.ts

@@ -33,6 +33,13 @@ export declare class LaunchToken {
     fail(err: Error): void;
     /** 窗口到点：输出 dsh web 启动原始日志辅助诊断，再按未捕获 token 判定本次启动失败 */
     private expire;
+    /**
+     * 附上"这次起的是哪个 profile"的上下文（provider 起进程前调用）。
+     * 只加在这里、不进 printStartupOutput：超时的那条错误要能自己说清 profile 与它的 bundle 列表，
+     * 否则症状永远只是"启动超时"（见 profile-check 的注释）。
+     */
+    attachContext(provider: () => string): void;
+    private context?;
     /** 报错时把 dsh web 启动的原始日志作为一条日志整体输出（幂等：每实例只打一次） */
     private printed;
     private printStartupOutput;

package/lib/profile-check.cjs

@@ -0,0 +1,77 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var profile_check_exports = {};
+__export(profile_check_exports, {
+  DSH_WEB_APP_BUNDLE: () => DSH_WEB_APP_BUNDLE,
+  describeDshProfile: () => describeDshProfile,
+  inspectDshProfile: () => inspectDshProfile,
+  profileProblemText: () => profileProblemText
+});
+module.exports = __toCommonJS(profile_check_exports);
+var import_node_fs = __toESM(require("node:fs"));
+var import_node_path = __toESM(require("node:path"));
+const DSH_WEB_APP_BUNDLE = "@deepseek-ai/dsh-web-app";
+function inspectDshProfile(profileDir) {
+  const manifest = import_node_path.default.join(profileDir, "package.json");
+  let parsed;
+  try {
+    parsed = JSON.parse(import_node_fs.default.readFileSync(manifest, "utf8"));
+  } catch {
+    return { ok: false, problem: "missing", bundles: [], manifest };
+  }
+  const declared = parsed?.dsh?.profile?.bundles;
+  const bundles = Array.isArray(declared) ? declared.filter((one) => typeof one === "string") : [];
+  if (!bundles.includes(DSH_WEB_APP_BUNDLE)) {
+    return { ok: false, problem: "no-web-app", bundles, manifest };
+  }
+  return { ok: true, problem: null, bundles, manifest };
+}
+function profileProblemText(inspection, profileDir, profile) {
+  const head = inspection.problem === "missing" ? `dsh profile "${profile}" \u8FD8\u4E0D\u5B58\u5728\uFF08\u627E\u4E0D\u5230 ${inspection.manifest}\uFF09` : `dsh profile "${profile}" \u91CC\u6CA1\u6709 Web \u5E94\u7528 bundle\uFF08${DSH_WEB_APP_BUNDLE}\uFF09`;
+  const bundles = inspection.bundles.length === 0 ? "\uFF08\u8BFB\u4E0D\u5230 bundle \u5217\u8868\uFF09" : `\u73B0\u6709 bundles\uFF1A${inspection.bundles.join("\u3001")}`;
+  return [
+    `${head}\uFF1A${profileDir}`,
+    `  ${bundles}`,
+    "  dsh \u5728 profile \u7F3A\u5931\u65F6\u4F1A\u81EA\u5DF1\u5EFA\u4E00\u4E2A\u53EA\u6709 @deepseek-ai/dsh-base \u7684\u7A7A\u58F3\uFF0C\u8D77\u6765\u4E0D\u4F1A\u6709\u754C\u9762\uFF1B",
+    "  \u800C provider \u7684\u7F16\u6392\u662F\u300C\u5148\u88C5\u63D2\u4EF6\u3001\u518D\u8D77\u8FDB\u7A0B\u300D\uFF0C\u90A3\u4E00\u6B65\u4F1A\u628A\u7A7A\u58F3\u5EFA\u51FA\u6765\uFF0C\u75C7\u72B6\u53EA\u662F\u542F\u52A8\u8D85\u65F6\u3002",
+    "  \u5148\u628A\u8FD9\u4E2A profile \u5EFA\u597D\uFF08\u5B83\u81EA\u5DF1\u7684\u5B89\u88C5\u6D41\u7A0B\uFF0C\u6216 `dsh <\u540D> --from-default-profile web`\uFF09\u518D\u91CD\u5F00\u3002"
+  ].join("\n");
+}
+function describeDshProfile(profileDir, profile) {
+  const inspection = inspectDshProfile(profileDir);
+  const bundles = inspection.bundles.length === 0 ? "\uFF08\u8BFB\u4E0D\u5230\uFF09" : inspection.bundles.join("\u3001");
+  return `profile: ${profile} (${profileDir})
+bundles: ${bundles}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DSH_WEB_APP_BUNDLE,
+  describeDshProfile,
+  inspectDshProfile,
+  profileProblemText
+});

package/lib/profile-check.d.ts

@@ -0,0 +1,19 @@
+/** dsh 的 Web 应用 bundle（`dsh web` 的 profile 必有；纯终端类 profile 没有） */
+export declare const DSH_WEB_APP_BUNDLE = "@deepseek-ai/dsh-web-app";
+export type DshProfileProblem = "missing" | "no-web-app";
+export interface DshProfileInspection {
+    /** 这个 profile 现在能不能起 Web UI */
+    readonly ok: boolean;
+    /** 不能时是哪一类问题；能时为 null */
+    readonly problem: DshProfileProblem | null;
+    /** profile 声明的 bundle 列表（读不到时为空数组） */
+    readonly bundles: readonly string[];
+    /** profile 清单文件路径（报错信息里给绝对路径，方便直接去看） */
+    readonly manifest: string;
+}
+/** 读 profile 清单并判断它是否具备启动 Web UI 的条件 */
+export declare function inspectDshProfile(profileDir: string): DshProfileInspection;
+/** 预检没过时给用户的说明（通用措辞：说清是什么、去哪看、怎么修） */
+export declare function profileProblemText(inspection: DshProfileInspection, profileDir: string, profile: string): string;
+/** 启动超时诊断用的一行上下文：profile 在哪、声明了哪些 bundle */
+export declare function describeDshProfile(profileDir: string, profile: string): string;

package/lib/provider.cjs

@@ -30,6 +30,7 @@ var import_constants = require("./constants.cjs");
 var import_api = require("./api.cjs");
 var import_deepseek_web = require("./deepseek-web.cjs");
 var import_profile = require("./profile.cjs");
+var import_profile_check = require("./profile-check.cjs");
 var import_system = require("./system.cjs");
 var import_dsh_install = require("./dsh-install.cjs");
 const log = (0, import_node.createLogger)("DeepSeekWebProvider");
@@ -100,6 +101,14 @@ Please upgrade:
     const launchToken = new import_deepseek_web.LaunchToken();
     this.launchToken = launchToken;
     this.api.setLaunchTokenSource(() => launchToken.wait());
+    launchToken.attachContext(() => (0, import_profile_check.describeDshProfile)(profileDir, this.opts.profile));
+    const profileCheck = (0, import_profile_check.inspectDshProfile)(profileDir);
+    if (!profileCheck.ok) {
+      const reason = (0, import_profile_check.profileProblemText)(profileCheck, profileDir, this.opts.profile);
+      log.error(reason);
+      launchToken.fail(new Error(reason));
+      throw new Error(reason);
+    }
     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);
     const clientTarget = devClientDir ?? (providerVersion ? `${import_dsh_install.DSH_CLIENT_PACKAGE}@${providerVersion}` : `${import_dsh_install.DSH_CLIENT_PACKAGE}@latest`);

package/lib/types.d.ts

@@ -17,7 +17,13 @@ export type DeepSeekBusyEnter = BusyEnterBehavior;
 export type DeepSeekProviderOptions = {
     /** dsh 数据目录（$DSH_HOME），默认跟随系统（~/.dsh） */
     home?: string;
-    /** dsh profile 名（$DSH_HOME/profiles/<name>），默认 "web"；AIPanel 侧插件与 web 进程都指向该 profile */
+    /**
+     * dsh profile 名（$DSH_HOME/profiles/<name>），默认 "web"；AIPanel 侧插件与 web 进程都指向该 profile。
+     *
+     * ⚠️ 该 profile 必须**先建好**：其 `dsh.profile.bundles` 里要有 `@deepseek-ai/dsh-web-app`。
+     * 缺失时 dsh 的 `plugin` 子命令会自己建出一个只有 `@deepseek-ai/dsh-base` 的空壳，
+     * 于是启动只会表现为"等 launch token 超时"（见 profile-check.ts 的预检与说明）。
+     */
     profile?: string;
     /** 默认 Agent 预设（dsh settings agent-presets.default，如 code/standard；新建会话的默认模式） */
     agentPreset?: string;

package/package.json

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