@aipanel/provider-deepseek 1.2.0-beta.0

package/es/api.d.ts

@@ -0,0 +1,36 @@
+import type { SessionSummary } from "./types";
+/**
+ * dsh 会话 API 客户端。
+ * dsh 使用自定义四象限 RPC envelope（{type:'client-request',rpcId,method,payload} →
+ * {type:'server-response',rpcId,result:{ok,value|error}}），本节封装该协议。
+ */
+export declare class DeepSeekAPI {
+    private hostname;
+    private getWebPort;
+    constructor(hostname: string, getWebPort: () => number);
+    /** 应用壳 URL（无 deepLink 能力，所有会话共用） */
+    get shellUrl(): string;
+    /** 发起一次 unary RPC，返回 result.value（ok=false 时抛错） */
+    private call;
+    /**
+     * 列出当前项目目录下的会话。
+     * dsh 的 session.list 不提供按目录过滤，故结合 workspace.list（path→sessionIds）
+     * 与各会话的 cwd 字段，在本端合并去重出属于 projectDir 的会话集。
+     */
+    listSessions(projectDir: string, retries?: number): Promise<SessionSummary[]>;
+    /** 在当前目录下创建会话（dsh 仅返回 { sessionId, agentPreset? }，非完整 SessionSummary）。
+     * 关键：必须先确保 projectDir 对应的 workspace 存在（workspace.create 幂等 get-or-create），
+     * 再用 workspaceId 调 session.create。若只传 cwd，dsh 侧不会把会话挂到任何 workspace，
+     * 新会话会落到侧边栏"未分组"。 */
+    createSession(projectDir: string, retries?: number): Promise<{
+        sessionId: string;
+    }>;
+    /**
+     * 通过 dsh settings.update 应用 providerOptions 指定的用户设置（逐命名空间幂等 patch）。
+     * dsh 启动初期 API 未就绪，整体带重试；单个命名空间不存在会导致该次调用失败重试。
+     */
+    applySettings(sections: Record<string, Record<string, unknown>>, retries?: number): Promise<void>;
+    /** 归档会话（dsh 无硬删除，仅归档；幂等） */
+    archiveSession(sessionId: string, retries?: number): Promise<void>;
+    private createHttpRequest;
+}

package/es/api.js

@@ -0,0 +1,196 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+import http from "http";
+import { randomUUID } from "node:crypto";
+import { DEFAULT_RETRIES, RETRY_DELAY, sleep } from "@aipanel/core";
+import { PerformanceTimer, createLogger } from "@aipanel/core/node";
+import { DSH_API_BASE } from "./constants.js";
+const log = createLogger("DeepSeekAPI");
+class DeepSeekAPI {
+  constructor(hostname, getWebPort) {
+    __publicField(this, "hostname", hostname);
+    __publicField(this, "getWebPort", getWebPort);
+  }
+  /** 应用壳 URL（无 deepLink 能力，所有会话共用） */
+  get shellUrl() {
+    return `http://${this.hostname}:${this.getWebPort()}`;
+  }
+  /** 发起一次 unary RPC，返回 result.value（ok=false 时抛错） */
+  async call(method, payload = {}) {
+    const message = {
+      type: "client-request",
+      rpcId: randomUUID(),
+      method,
+      payload
+    };
+    const response = await this.createHttpRequest(
+      {
+        hostname: this.hostname,
+        port: this.getWebPort(),
+        path: `${DSH_API_BASE}/${method}`,
+        method: "POST",
+        headers: { "Content-Type": "application/json" }
+      },
+      JSON.stringify(message)
+    );
+    if (response?.result?.ok !== true) {
+      const err = response?.result && "error" in response.result ? response.result.error : void 0;
+      throw new Error(
+        `dsh RPC ${method} failed: ${err?.message ?? JSON.stringify(response?.result ?? response)}`
+      );
+    }
+    return response.result.value;
+  }
+  /**
+   * 列出当前项目目录下的会话。
+   * dsh 的 session.list 不提供按目录过滤，故结合 workspace.list（path→sessionIds）
+   * 与各会话的 cwd 字段，在本端合并去重出属于 projectDir 的会话集。
+   */
+  async listSessions(projectDir, retries = DEFAULT_RETRIES) {
+    const timer = log.timer("listSessions", { projectDir, retries });
+    let lastError = null;
+    for (let i = 0; i < retries; i++) {
+      try {
+        log.debug(`Attempt ${i + 1}/${retries}`, { method: "session.list", projectDir });
+        const workspaces = await this.call("workspace.list");
+        const matchedWorkspace = workspaces.items.find((w) => w.path === projectDir);
+        const ownedByWorkspace = new Set(matchedWorkspace?.sessionIds ?? []);
+        const archived = new Set(workspaces.archivedSessionIds);
+        const sessions = await this.call("session.list");
+        const all = sessions.items;
+        const filtered = all.filter((s) => {
+          if (s.blank) return false;
+          if (archived.has(s.sessionId)) return false;
+          if (ownedByWorkspace.has(s.sessionId)) return true;
+          if (s.cwd && s.cwd === projectDir) return true;
+          return false;
+        });
+        const result = filtered.sort((a, b) => b.updatedAt - a.updatedAt);
+        timer.end(`Found ${result.length} sessions`);
+        return result;
+      } catch (e) {
+        lastError = e instanceof Error ? e : new Error(String(e));
+        log.debug(`Attempt ${i + 1} failed: ${lastError.message}`, { method: "listSessions" });
+        if (i < retries - 1) {
+          await sleep(RETRY_DELAY);
+        }
+      }
+    }
+    timer.end("\u274C All retries exhausted");
+    throw lastError;
+  }
+  /** 在当前目录下创建会话（dsh 仅返回 { sessionId, agentPreset? }，非完整 SessionSummary）。
+   * 关键：必须先确保 projectDir 对应的 workspace 存在（workspace.create 幂等 get-or-create），
+   * 再用 workspaceId 调 session.create。若只传 cwd，dsh 侧不会把会话挂到任何 workspace，
+   * 新会话会落到侧边栏"未分组"。 */
+  async createSession(projectDir, retries = DEFAULT_RETRIES) {
+    const timer = log.timer("createSession", { projectDir, retries });
+    let lastError = null;
+    for (let i = 0; i < retries; i++) {
+      try {
+        log.debug(`Attempt ${i + 1}/${retries}`, {
+          method: "session.create",
+          projectDir
+        });
+        const { workspace } = await this.call("workspace.create", {
+          path: projectDir
+        });
+        const session = await this.call("session.create", {
+          workspaceId: workspace.workspaceId
+        });
+        timer.end(`Created session: ${session.sessionId}`);
+        return session;
+      } catch (e) {
+        lastError = e instanceof Error ? e : new Error(String(e));
+        log.debug(`Attempt ${i + 1} failed: ${lastError.message}`, { method: "createSession" });
+        if (i < retries - 1) {
+          await sleep(RETRY_DELAY);
+        }
+      }
+    }
+    timer.end("\u274C All retries exhausted");
+    throw lastError;
+  }
+  /**
+   * 通过 dsh settings.update 应用 providerOptions 指定的用户设置（逐命名空间幂等 patch）。
+   * dsh 启动初期 API 未就绪，整体带重试；单个命名空间不存在会导致该次调用失败重试。
+   */
+  async applySettings(sections, retries = DEFAULT_RETRIES) {
+    const namespaces = Object.keys(sections);
+    if (namespaces.length === 0) return;
+    const timer = log.timer("applySettings", { namespaces });
+    let lastError = null;
+    for (let i = 0; i < retries; i++) {
+      try {
+        log.debug(`Attempt ${i + 1}/${retries}`, { method: "settings.update", namespaces });
+        for (const [ns, patch] of Object.entries(sections)) {
+          await this.call("settings.update", { ns, patch });
+        }
+        timer.end(`Applied settings: ${namespaces.join(", ")}`);
+        return;
+      } catch (e) {
+        lastError = e instanceof Error ? e : new Error(String(e));
+        log.debug(`Attempt ${i + 1} failed: ${lastError.message}`, { method: "applySettings" });
+        if (i < retries - 1) {
+          await sleep(RETRY_DELAY);
+        }
+      }
+    }
+    timer.end("\u274C All retries exhausted");
+    throw lastError;
+  }
+  /** 归档会话（dsh 无硬删除，仅归档；幂等） */
+  async archiveSession(sessionId, retries = DEFAULT_RETRIES) {
+    const timer = log.timer("archiveSession", { sessionId, retries });
+    let lastError = null;
+    for (let i = 0; i < retries; i++) {
+      try {
+        log.debug(`Attempt ${i + 1}/${retries}`, { method: "workspace.archiveSession" });
+        await this.call("workspace.archiveSession", { sessionId });
+        timer.end(`Archived session: ${sessionId}`);
+        return;
+      } catch (e) {
+        lastError = e instanceof Error ? e : new Error(String(e));
+        log.debug(`Attempt ${i + 1} failed: ${lastError.message}`, {
+          method: "archiveSession"
+        });
+        if (i < retries - 1) {
+          await sleep(RETRY_DELAY);
+        }
+      }
+    }
+    timer.end("\u274C All retries exhausted");
+    throw lastError;
+  }
+  createHttpRequest(options, body) {
+    const timer = new PerformanceTimer("HTTP Request", {
+      operation: `${options.method || "GET"} ${options.path}`
+    });
+    return new Promise((resolve, reject) => {
+      const req = http.request(options, (res) => {
+        let data = "";
+        res.on("data", (chunk) => data += chunk);
+        res.on("end", () => {
+          try {
+            const result = JSON.parse(data);
+            timer.end(`\u2713 Status: ${res.statusCode}`);
+            resolve(result);
+          } catch {
+            timer.end("\u274C JSON parse error");
+            reject(new Error(`JSON parse error: ${data.substring(0, 100)}`));
+          }
+        });
+      });
+      req.on("error", (e) => {
+        timer.end("\u274C Request failed");
+        reject(e);
+      });
+      if (body) req.write(body);
+      req.end();
+    });
+  }
+}
+export {
+  DeepSeekAPI
+};

package/es/bridge-script.d.ts

@@ -0,0 +1,11 @@
+export interface BridgeScriptOptions {
+    /** 主题模式 */
+    theme?: "light" | "dark" | "auto";
+}
+/**
+ * 生成 PostMessage Bridge 脚本。
+ * dsh 无正式"切换会话"URL 钩子，选中态持久化在 localStorage(CURRENT_SESSION)，
+ * 且 SPA 启动时会据此恢复选中——因此桥接采用"写入选中 + 刷新 iframe"的策略。
+ * 若 dsh 后续暴露正式切会话接口，可替换以下 FOCUS_SESSION 分支。
+ */
+export declare function generateBridgeScript(options?: BridgeScriptOptions): string;

package/es/bridge-script.js

@@ -0,0 +1,142 @@
+import { WIDGET_MSG } from "@aipanel/core";
+import { DSH_STORAGE_KEYS } from "./constants.js";
+function generateBridgeScript(options = {}) {
+  const { theme = "auto" } = options;
+  return `
+(function() {
+  const CURRENT_SESSION_KEY = ${JSON.stringify(DSH_STORAGE_KEYS.CURRENT_SESSION)};
+  const SELECTION_KEY = ${JSON.stringify(DSH_STORAGE_KEYS.SELECTION)};
+  const THEME = ${JSON.stringify(theme)};
+
+  // \u6865\u63A5\u5C42\u901A\u77E5 dsh-client \u7684\u9009\u4E2D\u5143\u7D20\u63D2\u5165\u4E8B\u4EF6\uFF08\u4E0E opencode \u4E00\u81F4\uFF1A\u9009\u4E2D\u5373\u8FFD\u52A0\u5230\u5BF9\u8BDD\u6846\uFF09
+  const INSERT_ELEMENT_EVENT = "aipanel:insert-element";
+
+  // === \u8BB0\u5F55\u6700\u8FD1\u9009\u4E2D\u5143\u7D20 ===
+  // \u4F9B dsh-client \u7684 @aipanel source \u4F5C\u4E3A\u5019\u9009\u8BFB\u53D6\uFF08\u53EF\u591A\u9009\uFF0C\u6700\u591A\u4FDD\u7559 20 \u4E2A\uFF09\uFF0C\u5E76\u6D3E\u53D1
+  // aipanel:insert-element \u8BA9 dsh-client \u7ACB\u5373\u628A\u5143\u7D20\u8FFD\u52A0\u5230\u5F53\u524D\u4F1A\u8BDD\u8F93\u5165\u6846\u3002
+  function pushSelection(element) {
+    if (!element) return;
+    try {
+      var list = [];
+      var raw = localStorage.getItem(SELECTION_KEY);
+      if (raw) list = JSON.parse(raw) || [];
+      if (!Array.isArray(list)) list = [];
+      var exists = list.some(function (e) {
+        return e && e.filePath === element.filePath && e.line === element.line;
+      });
+      if (!exists) list.unshift(element);
+      if (list.length > 20) list.length = 20;
+      localStorage.setItem(SELECTION_KEY, JSON.stringify(list));
+      // \u901A\u77E5 dsh-client \u8FFD\u52A0\u5230\u5BF9\u8BDD\u6846\uFF08\u9009\u4E2D\u5373\u63D2\u5165\uFF0C\u65E0\u9700\u518D\u8F93\u5165 @\uFF09
+      window.dispatchEvent(new CustomEvent(INSERT_ELEMENT_EVENT, {
+        detail: { element: element }
+      }));
+    } catch (e) { /* ignore */ }
+  }
+
+  // === \u4E3B\u9898\u540C\u6B65\uFF08UI \u5448\u73B0\uFF1B\u6301\u4E45\u5316\u4EA4\u7531 dsh settings\u300Cui-theme.preference\u300D\uFF0C\u4E0D\u5728\u6B64\u5199 localStorage\uFF09===
+  // dsh \u7684\u6697\u8272\u7531 body[data-ds-dark-theme] + colorScheme \u5448\u73B0\u3002
+  // \u6CE8\u610F\uFF1Abridge \u53EF\u80FD\u88AB\u6CE8\u5165\u5230 <head>\uFF0C\u6B64\u65F6 document.body \u5C1A\u4E0D\u5B58\u5728\uFF0C\u987B\u5728 DOM ready \u540E\u518D\u6267\u884C\u3002
+  // theme \u53C2\u6570\uFF1A"light" | "dark" | "auto"\uFF08auto \u4E0D\u5E72\u9884\uFF0C\u4EA4\u7ED9 dsh \u539F\u751F\u4E3B\u9898\u5904\u7406\uFF09\u3002
+  function applyTheme(theme) {
+    if (!document.body) return;
+    if (theme === "dark") {
+      document.body.setAttribute("data-ds-dark-theme", "");
+      document.documentElement.style.colorScheme = "dark";
+    } else if (theme === "light") {
+      document.body.removeAttribute("data-ds-dark-theme");
+      document.documentElement.style.colorScheme = "light";
+    }
+  }
+
+  // === \u5E03\u5C40\u8986\u76D6 ===
+  // \u9690\u85CF dsh \u7684\u4FA7\u8FB9\u680F\u5217\uFF0C\u907F\u514D\u4E0E AIPanel \u81EA\u5E26\u4F1A\u8BDD\u5217\u8868\u91CD\u590D\u3002
+  // \u7A33\u5B9A\u951A\u70B9\uFF1AAppFrame \u6839\u7F51\u683C\u5728\u4FA7\u8FB9\u680F\u6298\u53E0\u65F6\u5E26 data-sidebar-collapsed\uFF08AIPanel \u7A84 iframe \u4E0B\u6052\u5B58\u5728\uFF09\uFF0C
+  // \u4FA7\u8FB9\u680F\u5217\u662F\u6839\u7F51\u683C\u7684\u9996\u4E2A\u5B50\u5143\u7D20\u3002
+  // \u6CE8\u610F\u4E0D\u80FD\u53EA display:none \u5143\u7D20\uFF1A\u663E\u5F0F gridTemplateColumns\uFF08\u5185\u8054\u6837\u5F0F\uFF09\u8F68\u9053\u4E0D\u4F1A\u56E0\u5B50\u9879
+  // \u9690\u85CF\u800C\u6D88\u5931\uFF0C\u4F1A\u7559\u4E00\u6761\u7A7A\u767D\u5217\uFF0C\u987B\u628A\u9996\u5217\u8F68\u9053\u6539\u6210 auto\uFF08\u5B50\u9879\u9690\u85CF\u540E\u574D\u7F29\u4E3A 0\uFF09\u3002
+  function applyLayoutOverrides() {
+    try {
+      if (document.getElementById("aipanel-layout-overrides")) return;
+      var style = document.createElement("style");
+      style.id = "aipanel-layout-overrides";
+      style.textContent = [
+        "[data-sidebar-collapsed] {",
+        "  grid-template-columns: auto !important;",
+        "}",
+        "[data-sidebar-collapsed] > :first-child {",
+        "  display: none !important;",
+        "}",
+      ].join("\\n");
+      document.head.appendChild(style);
+    } catch (e) { /* ignore */ }
+  }
+
+  // === \u6D88\u606F\u76D1\u542C ===
+  window.addEventListener("message", function(event) {
+    if (!event.data) return;
+
+    // \u6838\u5FC3\u5C42\u901A\u77E5\uFF1A\u5207\u6362\u4E3B\u9898\uFF08\u5DE5\u5177\u680F\u4E3B\u9898\u6309\u94AE/\u8DDF\u968F\u7CFB\u7EDF\u53D8\u5316\uFF09\u3002\u52A8\u6001\u5E94\u7528\uFF0C\u65E0\u9700\u91CD\u8F7D\u3002
+    if (event.data.type === ${JSON.stringify(WIDGET_MSG.SET_THEME)}) {
+      applyTheme(event.data.theme);
+    }
+
+    // \u6838\u5FC3\u5C42\u901A\u77E5\uFF1A\u805A\u7126\u6307\u5B9A\u4F1A\u8BDD\uFF08\u65E0 deepLink \u6A21\u5F0F\uFF09\u3002
+    // dsh \u7684\u9009\u4E2D\u6001\u6301\u4E45\u5316\u4E3A JSON.stringify({ sessionId, subagentAddress? })\uFF0CSPA \u542F\u52A8\u65F6\u636E\u6B64\u6062\u590D\u3002
+    if (event.data.type === ${JSON.stringify(WIDGET_MSG.FOCUS_SESSION)}) {
+      const sessionId = event.data.sessionId;
+      if (!sessionId) return;
+      try {
+        localStorage.setItem(CURRENT_SESSION_KEY, JSON.stringify({ sessionId }));
+      } catch (e) {
+        console.warn("dsh bridge: failed to persist session selection", e);
+      }
+      // dsh SPA \u4ECE\u6301\u4E45\u5316\u9009\u4E2D\u6062\u590D\uFF0C\u5237\u65B0\u4EE5\u5207\u6362\u5230\u76EE\u6807\u4F1A\u8BDD
+      location.reload();
+    }
+
+    // \u6838\u5FC3\u5C42\u901A\u77E5\uFF1A\u9875\u9762\u9009\u4E2D\u5143\u7D20 \u2192 \u8BB0\u5F55\uFF0C\u4F9B @aipanel \u83DC\u5355\u7B5B\u9009\u540E\u4EE5 reference \u63D2\u5165
+    if (event.data.type === ${JSON.stringify(WIDGET_MSG.INSERT_FILE_PART)}) {
+      pushSelection(event.data.element);
+    }
+  });
+
+  // === \u5C31\u7EEA\u901A\u77E5 ===
+  // \u4E0D\u518D\u7528 MutationObserver \u6BCF\u5E27\u53D1 READY\uFF08\u90A3\u4F1A\u5728 dsh \u521A\u6E32\u67D3\u3001\u76EE\u6807\u4F1A\u8BDD\u5C1A\u672A\u6FC0\u6D3B\u65F6\u5C31
+  // \u63D0\u524D\u653E\u884C loading\uFF09\u3002\u6539\u4E3A\u76D1\u542C dsh-client \u63D2\u4EF6\u5728"\u76EE\u6807\u4F1A\u8BDD\u6FC0\u6D3B\u4E14\u6E32\u67D3\u7A33\u5B9A"\u540E\u6D3E\u53D1\u7684
+  // aipanel:session-ready \u4E8B\u4EF6\uFF0C\u6536\u5230\u540E\u4E0A\u62A5 SESSION_READY{sessionId}\u3002
+  // \u53EA\u53D1 SESSION_READY \u800C\u4E0D\u53D1 READY\uFF1A\u5BA2\u6237\u7AEF\u5DF2\u80FD\u51ED sessionId \u5339\u914D\u5F53\u524D\u4F1A\u8BDD\u51B3\u5B9A\u4F55\u65F6
+  // \u653E\u884C loading / \u8865\u53D1\u805A\u7126\uFF1B\u907F\u514D\u4E0E"FOCUS_SESSION \u2192 reload \u2192 \u518D\u5C31\u7EEA"\u6784\u6210\u5237\u65B0\u6B7B\u5FAA\u73AF\u3002
+  const SESSION_READY_EVENT = "aipanel:session-ready";
+
+  function sendSessionReady(sessionId) {
+    if (window.parent !== window) {
+      window.parent.postMessage({
+        type: ${JSON.stringify(WIDGET_MSG.SESSION_READY)},
+        sessionId
+      }, "*");
+    }
+  }
+
+  window.addEventListener(SESSION_READY_EVENT, function(e) {
+    const sessionId = e && e.detail && e.detail.sessionId;
+    if (!sessionId) return;
+    sendSessionReady(sessionId);
+  });
+
+  // \u4E3B\u9898\u540C\u6B65/\u5E03\u5C40\u8986\u76D6\u4ECD\u987B\u5728\u6BCF\u6B21\u9875\u9762\u52A0\u8F7D\u65F6\u751F\u6548\uFF08\u4E0E\u5C31\u7EEA\u5224\u5B9A\u89E3\u8026\uFF0C\u4E0D\u53C2\u4E0E loading \u653E\u884C\uFF09
+  function init() {
+    applyTheme(THEME);
+    applyLayoutOverrides();
+  }
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", init);
+  } else {
+    init();
+  }
+})();
+`;
+}
+export {
+  generateBridgeScript
+};

package/es/constants.d.ts

@@ -0,0 +1,25 @@
+/**
+ * DeepSeek Harness Provider 专属常量
+ * 与 dsh web 绑定的常量自包含于此，核心层不感知。
+ */
+import type { DeepSeekProviderOptions } from "./types";
+/** ==================== dsh API ==================== */
+/** dsh 所有 RPC 路径前缀（POST /api/<method>、GET /api/events.mux） */
+export declare const DSH_API_BASE = "/api";
+/** mux 事件流端点（会话级聚合流，含 session/event 可推导 thinking/streaming） */
+export declare const DSH_MUX_EVENTS_PATH = "/api/events.mux";
+/** host 事件流端点（host 级，含 host/session-status.running 运行态开关） */
+export declare const DSH_HOST_EVENTS_PATH = "/api/events.host";
+/** dsh 唯一允许的绑定主机字面量（服务 schema 只接受 127.0.0.1 / 0.0.0.0） */
+export declare const DSH_LOOPBACK_HOST = "127.0.0.1";
+/** dsh web 默认端口（未显式指定时） */
+export declare const DSH_DEFAULT_PORT = 3080;
+/** ==================== dsh localStorage 键 ==================== */
+export declare const DSH_STORAGE_KEYS: {
+    /** 当前选中会话（SPA 启动时据此恢复选中，无 URL 深链） */
+    readonly CURRENT_SESSION: "dsh.sessions.current";
+    /** 选中的页面元素（bridge 写入，dsh-client 的 @aipanel source 读取） */
+    readonly SELECTION: "dsh.bridge.selection";
+};
+/** ==================== Provider 专属配置默认值 ==================== */
+export declare const DEFAULT_DEEPSEEK_PROVIDER_OPTIONS: DeepSeekProviderOptions;

package/es/constants.js

@@ -0,0 +1,23 @@
+const DSH_API_BASE = "/api";
+const DSH_MUX_EVENTS_PATH = "/api/events.mux";
+const DSH_HOST_EVENTS_PATH = "/api/events.host";
+const DSH_LOOPBACK_HOST = "127.0.0.1";
+const DSH_DEFAULT_PORT = 3080;
+const DSH_STORAGE_KEYS = {
+  /** 当前选中会话（SPA 启动时据此恢复选中，无 URL 深链） */
+  CURRENT_SESSION: "dsh.sessions.current",
+  /** 选中的页面元素（bridge 写入，dsh-client 的 @aipanel source 读取） */
+  SELECTION: "dsh.bridge.selection"
+};
+const DEFAULT_DEEPSEEK_PROVIDER_OPTIONS = {
+  agentPreset: "code"
+};
+export {
+  DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
+  DSH_API_BASE,
+  DSH_DEFAULT_PORT,
+  DSH_HOST_EVENTS_PATH,
+  DSH_LOOPBACK_HOST,
+  DSH_MUX_EVENTS_PATH,
+  DSH_STORAGE_KEYS
+};

package/es/deepseek-web.d.ts

@@ -0,0 +1,21 @@
+import { type ResultPromise } from "execa";
+export interface DeepSeekWebOptions {
+    /** 服务端口 */
+    port: number;
+    /** 服务主机（dsh 只接受 127.0.0.1，见 DSH_LOOPBACK_HOST） */
+    hostname: string;
+    /** 工作目录 */
+    cwd: string;
+    /** cordis overlay 文件路径（--patch 注入 MCP client / aipanel 插件） */
+    patchPath?: string;
+    /** dsh 数据目录（透传 DSH_HOME；缺省跟随 $DSH_HOME / ~/.dsh） */
+    home?: string;
+    /** 启用 verbose 模式 */
+    verbose?: boolean;
+}
+/**
+ * 启动 dsh web 服务。
+ * dsh web 是自包含单进程（web server + agent runtime 同进程），无需额外配置/插件注入。
+ * 也无需 API key 即可启动 UI 壳。
+ */
+export declare function startDeepSeekWeb(options: DeepSeekWebOptions): ResultPromise;

package/es/deepseek-web.js

@@ -0,0 +1,62 @@
+import { execa } from "execa";
+import { createLogger, getProcessLogBuffer } from "@aipanel/core/node";
+const log = createLogger("DeepSeekWeb");
+function startDeepSeekWeb(options) {
+  const { port, hostname, cwd, patchPath, home, verbose } = options;
+  const args = ["--profile", "web"];
+  if (patchPath) {
+    args.push("--patch", patchPath);
+  }
+  args.push(
+    "--port",
+    String(port),
+    "--host",
+    hostname,
+    // 由插件内嵌 iframe 展示，禁止 dsh 自动打开默认浏览器
+    "--no-open"
+  );
+  log.debug("Spawning dsh web process", {
+    command: "dsh",
+    args: args.join(" "),
+    cwd,
+    home: home ?? process.env.DSH_HOME
+  });
+  const proc = execa("dsh", args, {
+    cwd,
+    reject: false,
+    cleanup: true,
+    shell: true,
+    env: {
+      ...process.env,
+      ...home ? { DSH_HOME: home } : {},
+      ...verbose ? { VERBOSE: "1" } : {}
+    }
+  });
+  proc.then((result) => {
+    if (result.exitCode !== 0) {
+      log.warn("[dsh exited]", { exitCode: result.exitCode, signal: result.signal });
+    } else {
+      log.debug("[dsh exited]", { exitCode: result.exitCode });
+    }
+  }).catch((e) => {
+    log.error("[dsh spawn failed]", { error: e instanceof Error ? e.message : String(e) });
+  });
+  proc.stdout?.on("data", (data) => {
+    const output = data.toString().trim();
+    if (output) {
+      log.debug("[dsh stdout]", { output });
+      getProcessLogBuffer().addProviderStdout(output);
+    }
+  });
+  proc.stderr?.on("data", (data) => {
+    const output = data.toString().trim();
+    if (output) {
+      log.warn("[dsh stderr]", { output });
+      getProcessLogBuffer().addProviderStderr(output);
+    }
+  });
+  return proc;
+}
+export {
+  startDeepSeekWeb
+};

package/es/dsh-install.d.ts

@@ -0,0 +1,16 @@
+export declare const DSH_CLIENT_PACKAGE = "@aipanel/dsh-client";
+/**
+ * 是否为 dev workspace 且 dsh-client 产物就绪（存在 package.json 与 lib/client.js）。
+ * 生产安装的 provider 在 node_modules/@aipanel/provider-deepseek/ 下，上一级不是 dsh-client，返回 null。
+ */
+export declare function resolveDevDshClientSource(metaUrl: string): string | null;
+/** dsh web profile 目录（固定 --profile web）；home 未指定时回退 $DSH_HOME / ~/.dsh */
+export declare function dshProfileDir(home?: string): string;
+/** @aipanel/dsh-client 在 profile 的 node_modules 中是否可解析 */
+export declare function isDshClientInstalled(profileDir: string): boolean;
+/**
+ * 确保 @aipanel/dsh-client 已安装且为最新（官方命令 dsh plugin add）。
+ * 每次启动都执行（不跳过已安装）：dev 本地目录每次重装保证改代码生效，
+ * 生产 npm 包每次检查 registry 拉取最新版本。安装失败返回 false（不阻塞启动，仅 chip 高亮不可用）。
+ */
+export declare function ensureDshClient(profileDir: string, target: string, home?: string): Promise<boolean>;

package/es/dsh-install.js

@@ -0,0 +1,58 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { execa } from "execa";
+import { fileURLToPath } from "node:url";
+import { createLogger } from "@aipanel/core/node";
+const log = createLogger("DshInstall");
+const DSH_CLIENT_PACKAGE = "@aipanel/dsh-client";
+function resolveDevDshClientSource(metaUrl) {
+  const here = path.dirname(fileURLToPath(metaUrl));
+  const devDir = path.resolve(here, "../dsh-client");
+  if (fs.existsSync(path.join(devDir, "package.json")) && fs.existsSync(path.join(devDir, "lib/client.js"))) {
+    return devDir;
+  }
+  return null;
+}
+function dshProfileDir(home) {
+  const resolved = home || process.env.DSH_HOME || path.join(os.homedir(), ".dsh");
+  return path.join(resolved, "profiles", "web");
+}
+function isDshClientInstalled(profileDir) {
+  return fs.existsSync(
+    path.join(profileDir, "node_modules", "@aipanel", "dsh-client", "package.json")
+  );
+}
+async function ensureDshClient(profileDir, target, home) {
+  try {
+    log.debug(`installing ${target} into dsh profile via dsh plugin add`);
+    await execa("dsh", ["plugin", "--profile", "web", "add", target], {
+      reject: true,
+      shell: true,
+      env: {
+        ...process.env,
+        ...home ? { DSH_HOME: home } : {}
+      }
+    });
+    if (!isDshClientInstalled(profileDir)) {
+      log.warn(`dsh plugin add finished but ${DSH_CLIENT_PACKAGE} is not resolvable`, {
+        profileDir
+      });
+      return false;
+    }
+    return true;
+  } catch (e) {
+    log.warn(`failed to install ${DSH_CLIENT_PACKAGE} via dsh plugin add`, {
+      target,
+      error: e instanceof Error ? e.message : String(e)
+    });
+    return false;
+  }
+}
+export {
+  DSH_CLIENT_PACKAGE,
+  dshProfileDir,
+  ensureDshClient,
+  isDshClientInstalled,
+  resolveDevDshClientSource
+};

package/es/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * DeepSeek Harness Web Provider
+ * 实现 WebProvider 契约：进程管理、RPC 会话 API、桥接脚本、CLI 环境检查。
+ * 所有 dsh 专属类型与常量自包含于此包。
+ */
+import type { ProviderInitContext, WebProvider } from "@aipanel/core";
+/** 约定工厂：核心层动态加载本包后调用，初始化动作完全由 Provider 定义 */
+export declare function createProvider(ctx: ProviderInitContext): WebProvider;
+export { DeepSeekAPI } from "./api";
+export type { DeepSeekWebProviderConfig, DeepSeekWebProviderDeps } from "./provider";
+export { startDeepSeekWeb, type DeepSeekWebOptions } from "./deepseek-web";
+export { buildDshOverlay, writeDshOverlay } from "./profile";
+export { generateBridgeScript, type BridgeScriptOptions } from "./bridge-script";
+export { checkDeepSeekInstalled, getDeepSeekVersion, killOrphanDeepSeekProcesses } from "./system";
+export { DEFAULT_DEEPSEEK_PROVIDER_OPTIONS, DSH_LOOPBACK_HOST, DSH_DEFAULT_PORT } from "./constants";
+export type { DeepSeekProviderOptions, DeepSeekPermissionPreset, DeepSeekBusyEnter, SessionSummary, WorkspaceView, SessionStreamEvent, ServerRequest, ServerResponse, ClientRequest, } from "./types";

package/es/index.js

@@ -0,0 +1,29 @@
+import { DeepSeekWebProvider } from "./provider.js";
+import { DSH_LOOPBACK_HOST } from "./constants.js";
+function createProvider(ctx) {
+  return new DeepSeekWebProvider(
+    { hostname: DSH_LOOPBACK_HOST },
+    { getWebPort: ctx.getWebPort, getProxyPort: ctx.getProxyPort },
+    ctx.options
+  );
+}
+import { DeepSeekAPI } from "./api.js";
+import { startDeepSeekWeb } from "./deepseek-web.js";
+import { buildDshOverlay, writeDshOverlay } from "./profile.js";
+import { generateBridgeScript } from "./bridge-script.js";
+import { checkDeepSeekInstalled, getDeepSeekVersion, killOrphanDeepSeekProcesses } from "./system.js";
+import { DEFAULT_DEEPSEEK_PROVIDER_OPTIONS, DSH_LOOPBACK_HOST as DSH_LOOPBACK_HOST2, DSH_DEFAULT_PORT } from "./constants.js";
+export {
+  DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
+  DSH_DEFAULT_PORT,
+  DSH_LOOPBACK_HOST2 as DSH_LOOPBACK_HOST,
+  DeepSeekAPI,
+  buildDshOverlay,
+  checkDeepSeekInstalled,
+  createProvider,
+  generateBridgeScript,
+  getDeepSeekVersion,
+  killOrphanDeepSeekProcesses,
+  startDeepSeekWeb,
+  writeDshOverlay
+};

package/es/profile.d.ts

@@ -0,0 +1,11 @@
+/** 组装 overlay YAML */
+export declare function buildDshOverlay(options: {
+    vitePort: number;
+    cwd: string;
+    pluginDistPath?: string;
+    /** client 插件是否可被 dsh 解析（provider 已同步到 dsh profile）；false 时停用该行，避免 fail-loud */
+    clientAvailable?: boolean;
+}): string;
+/** 将 overlay 写入项目缓存目录（node_modules/.cache/aipanel，参照 opencode 的
+ * node_modules/.cache/opencode 惯例），不污染用户项目根目录。 */
+export declare function writeDshOverlay(workspaceCwd: string, overlay: string): string;