@aipanel/provider-deepseek 1.3.9 → 1.3.11

package/es/constants.d.ts

@@ -17,6 +17,8 @@ export declare const DSH_REMOTE_MUX_PATH = "/api/remote.mux";
 export declare const DSH_LOOPBACK_HOST = "127.0.0.1";
 /** dsh web 默认端口（未显式指定时） */
 export declare const DSH_DEFAULT_PORT = 3080;
+/** dsh 默认 profile（$DSH_HOME/profiles/<name>）；用户可经 providerOptions.profile 覆盖 */
+export declare const DSH_DEFAULT_PROFILE = "web";
 /** ==================== Provider 专属配置默认值 ==================== */
 /**
  * Provider 选项兜底值。

package/es/constants.js

@@ -2,11 +2,15 @@ const DSH_API_BASE = "/api";
 const DSH_REMOTE_MUX_PATH = "/api/remote.mux";
 const DSH_LOOPBACK_HOST = "127.0.0.1";
 const DSH_DEFAULT_PORT = 3080;
-const DEFAULT_DEEPSEEK_PROVIDER_OPTIONS = {};
+const DSH_DEFAULT_PROFILE = "web";
+const DEFAULT_DEEPSEEK_PROVIDER_OPTIONS = {
+  profile: DSH_DEFAULT_PROFILE
+};
 export {
   DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
   DSH_API_BASE,
   DSH_DEFAULT_PORT,
+  DSH_DEFAULT_PROFILE,
   DSH_LOOPBACK_HOST,
   DSH_REMOTE_MUX_PATH
 };

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;
@@ -48,6 +55,8 @@ export interface DeepSeekWebOptions {
     hostname: string;
     /** 工作目录 */
     cwd: string;
+    /** dsh profile 名（$DSH_HOME/profiles/<name>），默认 "web" */
+    profile?: string;
     /** cordis overlay 文件路径（--patch 注入 MCP client / aipanel 插件） */
     patchPath?: string;
     /** dsh 数据目录（透传 DSH_HOME；缺省跟随 $DSH_HOME / ~/.dsh） */

package/es/deepseek-web.js

@@ -3,6 +3,7 @@ var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { en
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 import { execa } from "execa";
 import { createLogger, getProcessLogBuffer } from "@aipanel/core/node";
+import { DSH_DEFAULT_PROFILE } from "./constants.js";
 const log = createLogger("DeepSeekWeb");
 class LaunchToken {
   /** @param timeoutMs token 等待窗口（自 arm 起算，默认 20s） */
@@ -18,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);
   }
@@ -62,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;
@@ -93,7 +107,8 @@ class LaunchToken {
 }
 function startDeepSeekWeb(options) {
   const { port, hostname, cwd, patchPath, home, verbose, launchToken } = options;
-  const args = ["--profile", "web"];
+  const profile = options.profile ?? DSH_DEFAULT_PROFILE;
+  const args = ["--profile", profile];
   if (patchPath) {
     args.push("--patch", patchPath);
   }

package/es/dsh-install.d.ts

@@ -8,8 +8,8 @@ export declare const DSH_PLUGIN_PACKAGE = "@aipanel/dsh-plugin";
  * @param distRel 产物相对路径（client 为 "lib/client.js"，plugin 为 "dist/index.js"）
  */
 export declare function resolveDevDshPackageSource(metaUrl: string, subdir: string, distRel: string): string | null;
-/** dsh web profile 目录（固定 --profile web）；home 未指定时回退 $DSH_HOME / ~/.dsh */
-export declare function dshProfileDir(home?: string): string;
+/** dsh profile 目录（$DSH_HOME/profiles/<profile>）；home 未指定时回退 $DSH_HOME / ~/.dsh */
+export declare function dshProfileDir(profile: string, home?: string): string;
 /** 某 @aipanel/dsh-* 包在 profile 的 node_modules 中是否可解析 */
 export declare function isDshPackageInstalled(profileDir: string, packageName: string): boolean;
 /** 读取 profile 内已安装的某包版本（可解析不到时返回 null） */
@@ -22,4 +22,4 @@ export declare function readProviderVersion(metaUrl: string): string | null;
  * 生产 npm 包每次检查 registry 拉取最新版本。安装失败返回 false（不阻塞启动，
  * 仅对应 overlay 行停用，如失去 chip 高亮 / 审查工具）。
  */
-export declare function ensureDshPackage(profileDir: string, packageName: string, target: string, home?: string, expectedVersion?: string | null): Promise<boolean>;
+export declare function ensureDshPackage(profileDir: string, packageName: string, target: string, profile: string, home?: string, expectedVersion?: string | null): Promise<boolean>;

package/es/dsh-install.js

@@ -18,9 +18,9 @@ function resolveDevDshPackageSource(metaUrl, subdir, distRel) {
   }
   return null;
 }
-function dshProfileDir(home) {
+function dshProfileDir(profile, home) {
   const resolved = home || process.env.DSH_HOME || path.join(os.homedir(), ".dsh");
-  return path.join(resolved, "profiles", "web");
+  return path.join(resolved, "profiles", profile);
 }
 function isDshPackageInstalled(profileDir, packageName) {
   return fs.existsSync(packageJsonIn(profileDir, packageName));
@@ -42,10 +42,10 @@ function readProviderVersion(metaUrl) {
     return null;
   }
 }
-async function ensureDshPackage(profileDir, packageName, target, home, expectedVersion) {
+async function ensureDshPackage(profileDir, packageName, target, profile, home, expectedVersion) {
   try {
-    log.debug(`installing ${target} into dsh profile via dsh plugin add`);
-    await execa("dsh", ["plugin", "--profile", "web", "add", target], {
+    log.debug(`installing ${target} into dsh profile via dsh plugin add`, { profile });
+    await execa("dsh", ["plugin", "--profile", profile, "add", target], {
       reject: true,
       env: {
         ...process.env,
@@ -64,7 +64,7 @@ async function ensureDshPackage(profileDir, packageName, target, home, expectedV
         `${packageName} version ${installed} is out of sync with provider ${expectedVersion}`,
         {
           profileDir,
-          install: `dsh plugin --profile web add ${packageName}@${expectedVersion}`
+          install: `dsh plugin --profile ${profile} add ${packageName}@${expectedVersion}`
         }
       );
     }

package/es/index.d.ts

@@ -11,7 +11,7 @@ export type { DeepSeekWebProviderConfig, DeepSeekWebProviderDeps } from "./provi
 export { startDeepSeekWeb, type DeepSeekWebOptions } from "./deepseek-web";
 export { buildDshOverlay, writeDshOverlay } from "./profile";
 export { checkDeepSeekInstalled, getDeepSeekVersion, killOrphanDeepSeekProcesses } from "./system";
-export { DEFAULT_DEEPSEEK_PROVIDER_OPTIONS, DSH_LOOPBACK_HOST, DSH_DEFAULT_PORT, } from "./constants";
+export { DEFAULT_DEEPSEEK_PROVIDER_OPTIONS, DSH_LOOPBACK_HOST, DSH_DEFAULT_PORT, DSH_DEFAULT_PROFILE, } from "./constants";
 export type { DeepSeekProviderOptions, DeepSeekPermissionPreset, DeepSeekBusyEnter } from "./types";
 export type { ClientRequest, RpcMessage, ServerResponse } from "@deepseek-ai/dsh-client-connection";
 export type { SessionCreateValue, SessionListValue, SessionSummary, } from "@deepseek-ai/dsh-api-session-controller/types";

package/es/index.js

@@ -14,11 +14,13 @@ import { checkDeepSeekInstalled, getDeepSeekVersion, killOrphanDeepSeekProcesses
 import {
   DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
   DSH_LOOPBACK_HOST as DSH_LOOPBACK_HOST2,
-  DSH_DEFAULT_PORT
+  DSH_DEFAULT_PORT,
+  DSH_DEFAULT_PROFILE
 } from "./constants.js";
 export {
   DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
   DSH_DEFAULT_PORT,
+  DSH_DEFAULT_PROFILE,
   DSH_LOOPBACK_HOST2 as DSH_LOOPBACK_HOST,
   DeepSeekAPI,
   buildDshOverlay,

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

@@ -4,11 +4,11 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 import { sleep } from "@aipanel/core";
 import { DEFAULT_DIAGNOSTICS_POLICY, resolveDiagnosticsPolicy } from "@aipanel/core";
 import { createLogger } from "@aipanel/core/node";
-import { DEFAULT_DEEPSEEK_PROVIDER_OPTIONS } from "./constants.js";
-import { DSH_LOOPBACK_HOST } from "./constants.js";
+import { DEFAULT_DEEPSEEK_PROVIDER_OPTIONS, DSH_DEFAULT_PROFILE, DSH_LOOPBACK_HOST } from "./constants.js";
 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,
@@ -85,12 +85,21 @@ Please upgrade:
       port: options.port,
       hostname: DSH_LOOPBACK_HOST,
       cwd: options.cwd,
+      profile: this.opts.profile,
       vitePort: options.vitePort
     });
-    const profileDir = dshProfileDir(this.opts.home);
+    const profileDir = dshProfileDir(this.opts.profile, this.opts.home);
     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`);
@@ -98,6 +107,7 @@ Please upgrade:
       profileDir,
       DSH_CLIENT_PACKAGE,
       clientTarget,
+      this.opts.profile,
       this.opts.home,
       providerVersion
     );
@@ -112,6 +122,7 @@ Please upgrade:
       profileDir,
       DSH_PLUGIN_PACKAGE,
       pluginTarget,
+      this.opts.profile,
       this.opts.home,
       providerVersion
     );
@@ -139,6 +150,7 @@ Please upgrade:
       port: options.port,
       hostname: DSH_LOOPBACK_HOST,
       cwd: options.cwd,
+      profile: this.opts.profile,
       patchPath,
       home: this.opts.home,
       verbose: options.verbose,
@@ -233,6 +245,7 @@ function resolveDeepSeekOptions(options) {
   return {
     ...DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
     home: po.home ?? options?.home,
+    profile: po.profile ?? options?.profile ?? DSH_DEFAULT_PROFILE,
     agentPreset: po.agentPreset ?? options?.agentPreset,
     permissionPreset: po.permissionPreset ?? options?.permissionPreset,
     busyEnter: po.busyEnter ?? options?.busyEnter,

package/es/types.d.ts

@@ -17,6 +17,14 @@ export type DeepSeekBusyEnter = BusyEnterBehavior;
 export type DeepSeekProviderOptions = {
     /** dsh 数据目录（$DSH_HOME），默认跟随系统（~/.dsh） */
     home?: string;
+    /**
+     * 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;
     /** 默认权限预设（dsh settings permission.defaultPreset） */
@@ -34,7 +42,8 @@ export type DeepSeekProviderOptions = {
      */
     [key: string]: unknown;
 };
-/** 归一化后的 Provider 选项：诊断策略一定是完整的（Partial 已在 provider 内解析） */
+/** 归一化后的 Provider 选项：诊断策略一定是完整的（Partial 已在 provider 内解析），profile 一定落到默认值 */
 export type DeepSeekResolvedOptions = DeepSeekProviderOptions & {
+    profile: string;
     diagnostics: DiagnosticsPolicy;
 };

package/lib/constants.cjs

@@ -20,6 +20,7 @@ __export(constants_exports, {
   DEFAULT_DEEPSEEK_PROVIDER_OPTIONS: () => DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
   DSH_API_BASE: () => DSH_API_BASE,
   DSH_DEFAULT_PORT: () => DSH_DEFAULT_PORT,
+  DSH_DEFAULT_PROFILE: () => DSH_DEFAULT_PROFILE,
   DSH_LOOPBACK_HOST: () => DSH_LOOPBACK_HOST,
   DSH_REMOTE_MUX_PATH: () => DSH_REMOTE_MUX_PATH
 });
@@ -28,12 +29,16 @@ const DSH_API_BASE = "/api";
 const DSH_REMOTE_MUX_PATH = "/api/remote.mux";
 const DSH_LOOPBACK_HOST = "127.0.0.1";
 const DSH_DEFAULT_PORT = 3080;
-const DEFAULT_DEEPSEEK_PROVIDER_OPTIONS = {};
+const DSH_DEFAULT_PROFILE = "web";
+const DEFAULT_DEEPSEEK_PROVIDER_OPTIONS = {
+  profile: DSH_DEFAULT_PROFILE
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
   DSH_API_BASE,
   DSH_DEFAULT_PORT,
+  DSH_DEFAULT_PROFILE,
   DSH_LOOPBACK_HOST,
   DSH_REMOTE_MUX_PATH
 });

package/lib/constants.d.ts

@@ -17,6 +17,8 @@ export declare const DSH_REMOTE_MUX_PATH = "/api/remote.mux";
 export declare const DSH_LOOPBACK_HOST = "127.0.0.1";
 /** dsh web 默认端口（未显式指定时） */
 export declare const DSH_DEFAULT_PORT = 3080;
+/** dsh 默认 profile（$DSH_HOME/profiles/<name>）；用户可经 providerOptions.profile 覆盖 */
+export declare const DSH_DEFAULT_PROFILE = "web";
 /** ==================== Provider 专属配置默认值 ==================== */
 /**
  * Provider 选项兜底值。

package/lib/deepseek-web.cjs

@@ -25,6 +25,7 @@ __export(deepseek_web_exports, {
 module.exports = __toCommonJS(deepseek_web_exports);
 var import_execa = require("execa");
 var import_node = require("@aipanel/core/node");
+var import_constants = require("./constants.cjs");
 const log = (0, import_node.createLogger)("DeepSeekWeb");
 class LaunchToken {
   /** @param timeoutMs token 等待窗口（自 arm 起算，默认 20s） */
@@ -40,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);
   }
@@ -84,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;
@@ -115,7 +129,8 @@ class LaunchToken {
 }
 function startDeepSeekWeb(options) {
   const { port, hostname, cwd, patchPath, home, verbose, launchToken } = options;
-  const args = ["--profile", "web"];
+  const profile = options.profile ?? import_constants.DSH_DEFAULT_PROFILE;
+  const args = ["--profile", profile];
   if (patchPath) {
     args.push("--patch", patchPath);
   }

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;
@@ -48,6 +55,8 @@ export interface DeepSeekWebOptions {
     hostname: string;
     /** 工作目录 */
     cwd: string;
+    /** dsh profile 名（$DSH_HOME/profiles/<name>），默认 "web" */
+    profile?: string;
     /** cordis overlay 文件路径（--patch 注入 MCP client / aipanel 插件） */
     patchPath?: string;
     /** dsh 数据目录（透传 DSH_HOME；缺省跟随 $DSH_HOME / ~/.dsh） */

package/lib/dsh-install.cjs

@@ -57,9 +57,9 @@ function resolveDevDshPackageSource(metaUrl, subdir, distRel) {
   }
   return null;
 }
-function dshProfileDir(home) {
+function dshProfileDir(profile, home) {
   const resolved = home || process.env.DSH_HOME || import_node_path.default.join(import_node_os.default.homedir(), ".dsh");
-  return import_node_path.default.join(resolved, "profiles", "web");
+  return import_node_path.default.join(resolved, "profiles", profile);
 }
 function isDshPackageInstalled(profileDir, packageName) {
   return import_node_fs.default.existsSync(packageJsonIn(profileDir, packageName));
@@ -81,10 +81,10 @@ function readProviderVersion(metaUrl) {
     return null;
   }
 }
-async function ensureDshPackage(profileDir, packageName, target, home, expectedVersion) {
+async function ensureDshPackage(profileDir, packageName, target, profile, home, expectedVersion) {
   try {
-    log.debug(`installing ${target} into dsh profile via dsh plugin add`);
-    await (0, import_execa.execa)("dsh", ["plugin", "--profile", "web", "add", target], {
+    log.debug(`installing ${target} into dsh profile via dsh plugin add`, { profile });
+    await (0, import_execa.execa)("dsh", ["plugin", "--profile", profile, "add", target], {
       reject: true,
       env: {
         ...process.env,
@@ -103,7 +103,7 @@ async function ensureDshPackage(profileDir, packageName, target, home, expectedV
         `${packageName} version ${installed} is out of sync with provider ${expectedVersion}`,
         {
           profileDir,
-          install: `dsh plugin --profile web add ${packageName}@${expectedVersion}`
+          install: `dsh plugin --profile ${profile} add ${packageName}@${expectedVersion}`
         }
       );
     }

package/lib/dsh-install.d.ts

@@ -8,8 +8,8 @@ export declare const DSH_PLUGIN_PACKAGE = "@aipanel/dsh-plugin";
  * @param distRel 产物相对路径（client 为 "lib/client.js"，plugin 为 "dist/index.js"）
  */
 export declare function resolveDevDshPackageSource(metaUrl: string, subdir: string, distRel: string): string | null;
-/** dsh web profile 目录（固定 --profile web）；home 未指定时回退 $DSH_HOME / ~/.dsh */
-export declare function dshProfileDir(home?: string): string;
+/** dsh profile 目录（$DSH_HOME/profiles/<profile>）；home 未指定时回退 $DSH_HOME / ~/.dsh */
+export declare function dshProfileDir(profile: string, home?: string): string;
 /** 某 @aipanel/dsh-* 包在 profile 的 node_modules 中是否可解析 */
 export declare function isDshPackageInstalled(profileDir: string, packageName: string): boolean;
 /** 读取 profile 内已安装的某包版本（可解析不到时返回 null） */
@@ -22,4 +22,4 @@ export declare function readProviderVersion(metaUrl: string): string | null;
  * 生产 npm 包每次检查 registry 拉取最新版本。安装失败返回 false（不阻塞启动，
  * 仅对应 overlay 行停用，如失去 chip 高亮 / 审查工具）。
  */
-export declare function ensureDshPackage(profileDir: string, packageName: string, target: string, home?: string, expectedVersion?: string | null): Promise<boolean>;
+export declare function ensureDshPackage(profileDir: string, packageName: string, target: string, profile: string, home?: string, expectedVersion?: string | null): Promise<boolean>;

package/lib/index.cjs

@@ -19,6 +19,7 @@ var lib_exports = {};
 __export(lib_exports, {
   DEFAULT_DEEPSEEK_PROVIDER_OPTIONS: () => import_constants2.DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
   DSH_DEFAULT_PORT: () => import_constants2.DSH_DEFAULT_PORT,
+  DSH_DEFAULT_PROFILE: () => import_constants2.DSH_DEFAULT_PROFILE,
   DSH_LOOPBACK_HOST: () => import_constants2.DSH_LOOPBACK_HOST,
   DeepSeekAPI: () => import_api.DeepSeekAPI,
   buildDshOverlay: () => import_profile.buildDshOverlay,
@@ -48,6 +49,7 @@ function createProvider(ctx) {
 0 && (module.exports = {
   DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
   DSH_DEFAULT_PORT,
+  DSH_DEFAULT_PROFILE,
   DSH_LOOPBACK_HOST,
   DeepSeekAPI,
   buildDshOverlay,

package/lib/index.d.ts

@@ -11,7 +11,7 @@ export type { DeepSeekWebProviderConfig, DeepSeekWebProviderDeps } from "./provi
 export { startDeepSeekWeb, type DeepSeekWebOptions } from "./deepseek-web";
 export { buildDshOverlay, writeDshOverlay } from "./profile";
 export { checkDeepSeekInstalled, getDeepSeekVersion, killOrphanDeepSeekProcesses } from "./system";
-export { DEFAULT_DEEPSEEK_PROVIDER_OPTIONS, DSH_LOOPBACK_HOST, DSH_DEFAULT_PORT, } from "./constants";
+export { DEFAULT_DEEPSEEK_PROVIDER_OPTIONS, DSH_LOOPBACK_HOST, DSH_DEFAULT_PORT, DSH_DEFAULT_PROFILE, } from "./constants";
 export type { DeepSeekProviderOptions, DeepSeekPermissionPreset, DeepSeekBusyEnter } from "./types";
 export type { ClientRequest, RpcMessage, ServerResponse } from "@deepseek-ai/dsh-client-connection";
 export type { SessionCreateValue, SessionListValue, SessionSummary, } from "@deepseek-ai/dsh-api-session-controller/types";

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

@@ -27,10 +27,10 @@ var import_core = require("@aipanel/core");
 var import_core2 = require("@aipanel/core");
 var import_node = require("@aipanel/core/node");
 var import_constants = require("./constants.cjs");
-var import_constants2 = 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");
@@ -50,7 +50,7 @@ class DeepSeekWebProvider {
     __publicField(this, "opts");
     this.deps = deps;
     this.opts = resolveDeepSeekOptions(options);
-    this.api = new import_api.DeepSeekAPI(import_constants2.DSH_LOOPBACK_HOST, deps.getWebPort);
+    this.api = new import_api.DeepSeekAPI(import_constants.DSH_LOOPBACK_HOST, deps.getWebPort);
   }
   /** 记录 AIPanel 侧主题偏好（applyConfig 在 start 前调用；start 时随 client 插件 config 下发） */
   applyConfig(config) {
@@ -92,14 +92,23 @@ Please upgrade:
   async start(options) {
     log.debug("Starting dsh web process", {
       port: options.port,
-      hostname: import_constants2.DSH_LOOPBACK_HOST,
+      hostname: import_constants.DSH_LOOPBACK_HOST,
       cwd: options.cwd,
+      profile: this.opts.profile,
       vitePort: options.vitePort
     });
-    const profileDir = (0, import_dsh_install.dshProfileDir)(this.opts.home);
+    const profileDir = (0, import_dsh_install.dshProfileDir)(this.opts.profile, this.opts.home);
     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`);
@@ -107,6 +116,7 @@ Please upgrade:
       profileDir,
       import_dsh_install.DSH_CLIENT_PACKAGE,
       clientTarget,
+      this.opts.profile,
       this.opts.home,
       providerVersion
     );
@@ -121,6 +131,7 @@ Please upgrade:
       profileDir,
       import_dsh_install.DSH_PLUGIN_PACKAGE,
       pluginTarget,
+      this.opts.profile,
       this.opts.home,
       providerVersion
     );
@@ -146,8 +157,9 @@ Please upgrade:
     const patchPath = (0, import_profile.writeDshOverlay)(options.cwd, overlay);
     const proc = (0, import_deepseek_web.startDeepSeekWeb)({
       port: options.port,
-      hostname: import_constants2.DSH_LOOPBACK_HOST,
+      hostname: import_constants.DSH_LOOPBACK_HOST,
       cwd: options.cwd,
+      profile: this.opts.profile,
       patchPath,
       home: this.opts.home,
       verbose: options.verbose,
@@ -218,7 +230,7 @@ Please upgrade:
   buildSessionUrl(projectDir, sessionId) {
     void projectDir;
     void sessionId;
-    return `http://${import_constants2.DSH_LOOPBACK_HOST}:${this.deps.getProxyPort()}/`;
+    return `http://${import_constants.DSH_LOOPBACK_HOST}:${this.deps.getProxyPort()}/`;
   }
   subscribeEvents(handler) {
     void handler;
@@ -242,6 +254,7 @@ function resolveDeepSeekOptions(options) {
   return {
     ...import_constants.DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
     home: po.home ?? options?.home,
+    profile: po.profile ?? options?.profile ?? import_constants.DSH_DEFAULT_PROFILE,
     agentPreset: po.agentPreset ?? options?.agentPreset,
     permissionPreset: po.permissionPreset ?? options?.permissionPreset,
     busyEnter: po.busyEnter ?? options?.busyEnter,

package/lib/types.d.ts

@@ -17,6 +17,14 @@ export type DeepSeekBusyEnter = BusyEnterBehavior;
 export type DeepSeekProviderOptions = {
     /** dsh 数据目录（$DSH_HOME），默认跟随系统（~/.dsh） */
     home?: string;
+    /**
+     * 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;
     /** 默认权限预设（dsh settings permission.defaultPreset） */
@@ -34,7 +42,8 @@ export type DeepSeekProviderOptions = {
      */
     [key: string]: unknown;
 };
-/** 归一化后的 Provider 选项：诊断策略一定是完整的（Partial 已在 provider 内解析） */
+/** 归一化后的 Provider 选项：诊断策略一定是完整的（Partial 已在 provider 内解析），profile 一定落到默认值 */
 export type DeepSeekResolvedOptions = DeepSeekProviderOptions & {
+    profile: string;
     diagnostics: DiagnosticsPolicy;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipanel/provider-deepseek",
-  "version": "1.3.9",
+  "version": "1.3.11",
   "type": "module",
   "main": "lib/index.cjs",
   "module": "es/index.js",
@@ -21,16 +21,16 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@aipanel/core": "1.3.9",
+    "@aipanel/core": "1.3.11",
     "execa": "^9.6.1"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.7-alpha.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.7-alpha.2",
-    "@deepseek-ai/dsh-brand": "^0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.7-alpha.2",
-    "@deepseek-ai/dsh-sandbox": "^0.1.7-alpha.2",
+    "@deepseek-ai/dsh-api-session-controller": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-brand": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-sandbox": "^0.2.0-rc.1",
     "esbuild": "^0.25.0"
   },
   "scripts": {