@aipanel/provider-deepseek 1.2.0-beta.0

package/es/types.js

@@ -0,0 +1,19 @@
+const SESSION_EVENT_TYPES = {
+  /** 回合开始 → 视为 streaming */
+  TURN_START: "turn/start",
+  /** 回合结束（稳定停等） */
+  TURN_END: "turn/end",
+  /** 步骤开始 */
+  STEP_START: "step/start",
+  /** 步骤结束 */
+  STEP_END: "step/end",
+  /** 助手输出完成 */
+  ASSISTANT_MESSAGE: "assistant/message",
+  /** 助手输出增量分片 */
+  ASSISTANT_CHUNK: "assistant/chunk",
+  /** 思考增量分片 */
+  THINKING_DELTA: "thinking/delta"
+};
+export {
+  SESSION_EVENT_TYPES
+};

package/lib/api.cjs

@@ -0,0 +1,228 @@
+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 __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+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 __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var api_exports = {};
+__export(api_exports, {
+  DeepSeekAPI: () => DeepSeekAPI
+});
+module.exports = __toCommonJS(api_exports);
+var import_http = __toESM(require("http"));
+var import_node_crypto = require("node:crypto");
+var import_core = require("@aipanel/core");
+var import_node = require("@aipanel/core/node");
+var import_constants = require("./constants.cjs");
+const log = (0, import_node.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: (0, import_node_crypto.randomUUID)(),
+      method,
+      payload
+    };
+    const response = await this.createHttpRequest(
+      {
+        hostname: this.hostname,
+        port: this.getWebPort(),
+        path: `${import_constants.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 = import_core.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 (0, import_core.sleep)(import_core.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 = import_core.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 (0, import_core.sleep)(import_core.RETRY_DELAY);
+        }
+      }
+    }
+    timer.end("\u274C All retries exhausted");
+    throw lastError;
+  }
+  /**
+   * 通过 dsh settings.update 应用 providerOptions 指定的用户设置（逐命名空间幂等 patch）。
+   * dsh 启动初期 API 未就绪，整体带重试；单个命名空间不存在会导致该次调用失败重试。
+   */
+  async applySettings(sections, retries = import_core.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 (0, import_core.sleep)(import_core.RETRY_DELAY);
+        }
+      }
+    }
+    timer.end("\u274C All retries exhausted");
+    throw lastError;
+  }
+  /** 归档会话（dsh 无硬删除，仅归档；幂等） */
+  async archiveSession(sessionId, retries = import_core.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 (0, import_core.sleep)(import_core.RETRY_DELAY);
+        }
+      }
+    }
+    timer.end("\u274C All retries exhausted");
+    throw lastError;
+  }
+  createHttpRequest(options, body) {
+    const timer = new import_node.PerformanceTimer("HTTP Request", {
+      operation: `${options.method || "GET"} ${options.path}`
+    });
+    return new Promise((resolve, reject) => {
+      const req = import_http.default.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();
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DeepSeekAPI
+});

package/lib/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/lib/bridge-script.cjs

@@ -0,0 +1,165 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var bridge_script_exports = {};
+__export(bridge_script_exports, {
+  generateBridgeScript: () => generateBridgeScript
+});
+module.exports = __toCommonJS(bridge_script_exports);
+var import_core = require("@aipanel/core");
+var import_constants = require("./constants.cjs");
+function generateBridgeScript(options = {}) {
+  const { theme = "auto" } = options;
+  return `
+(function() {
+  const CURRENT_SESSION_KEY = ${JSON.stringify(import_constants.DSH_STORAGE_KEYS.CURRENT_SESSION)};
+  const SELECTION_KEY = ${JSON.stringify(import_constants.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(import_core.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(import_core.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(import_core.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(import_core.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();
+  }
+})();
+`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateBridgeScript
+});

package/lib/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/lib/constants.cjs

@@ -0,0 +1,52 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var constants_exports = {};
+__export(constants_exports, {
+  DEFAULT_DEEPSEEK_PROVIDER_OPTIONS: () => DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
+  DSH_API_BASE: () => DSH_API_BASE,
+  DSH_DEFAULT_PORT: () => DSH_DEFAULT_PORT,
+  DSH_HOST_EVENTS_PATH: () => DSH_HOST_EVENTS_PATH,
+  DSH_LOOPBACK_HOST: () => DSH_LOOPBACK_HOST,
+  DSH_MUX_EVENTS_PATH: () => DSH_MUX_EVENTS_PATH,
+  DSH_STORAGE_KEYS: () => DSH_STORAGE_KEYS
+});
+module.exports = __toCommonJS(constants_exports);
+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"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  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/lib/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/lib/deepseek-web.cjs

@@ -0,0 +1,85 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var deepseek_web_exports = {};
+__export(deepseek_web_exports, {
+  startDeepSeekWeb: () => startDeepSeekWeb
+});
+module.exports = __toCommonJS(deepseek_web_exports);
+var import_execa = require("execa");
+var import_node = require("@aipanel/core/node");
+const log = (0, import_node.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 = (0, import_execa.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 });
+      (0, import_node.getProcessLogBuffer)().addProviderStdout(output);
+    }
+  });
+  proc.stderr?.on("data", (data) => {
+    const output = data.toString().trim();
+    if (output) {
+      log.warn("[dsh stderr]", { output });
+      (0, import_node.getProcessLogBuffer)().addProviderStderr(output);
+    }
+  });
+  return proc;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  startDeepSeekWeb
+});

package/lib/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;