vite-plugin-aipanel 1.2.0-beta.4 → 1.2.1

package/README.md

@@ -2,15 +2,9 @@
 
 在 Vite 开发环境中嵌入 AIPanel AI 助手，边聊天边改代码，HMR 实时预览。
 
-## 快速开始
-
-### 前置条件
+支持 OpenCode 与 DeepSeek Harness (dsh) 两种 AI 引擎，通过 `provider` 配置一键切换。
 
-安装 [OpenCode CLI](https://opencode.ai)（AI 引擎，必须）：
-
-```bash
-curl -fsSL https://opencode.ai/install | bash
-```
+## 快速开始
 
 ### 1. 安装插件
 
@@ -30,6 +24,8 @@ export default defineConfig({
 });
 ```
 
+默认使用 **OpenCode** 引擎（详见下方「选择 AI 引擎」）。
+
 ### 3. 启动开发服务器
 
 ```bash
@@ -48,12 +44,54 @@ Vite 插件会自动启动 AIPanel Web 服务并创建当前项目的 AI 会话
 
 > Edge / Arc / Brave 操作步骤相同，入口分别是 `edge://extensions/` / `arc://extensions/` / `brave://extensions/`。
 
+## 选择 AI 引擎
+
+插件内置两套 AI 引擎，通过 `providerOptions` 段的 `provider` 字段选择：
+
+| provider     | 引擎                    | 额外依赖                        | 特点                           |
+| ------------ | ----------------------- | ------------------------------- | ------------------------------ |
+| `opencode`   | [OpenCode CLI](https://opencode.ai) | 无（插件内置）       | 默认引擎，通用 AI CLI         |
+| `deepseek`   | DeepSeek Harness (dsh)  | 另装 `@aipanel/provider-deepseek` | DeepSeek 官方 Web 对话界面 |
+
+使用 DeepSeek Harness 引擎需先安装依赖：
+
+```bash
+npm install -D @aipanel/provider-deepseek
+npm install -g @deepseek-ai/dsh
+```
+
+```ts
+// 使用 DeepSeek Harness 引擎
+aipanelAssistant({
+  provider: "deepseek",
+  providerOptions: {
+    // dsh 专属配置，详见在线文档
+    // home: "~/.dsh",          // dsh 数据目录
+    // agentPreset: "standard", // 新建会话的默认 Agent 预设
+    // permissionPreset: "read-only", // 默认权限预设
+    // busyEnter: "queue",      // 繁忙时 Enter 行为
+  },
+});
+```
+
+> 已预装 OpenCode 与 dsh 其中之一的用户，插件会自动检测并使用。
+
+## 纯净 MCP 模式
+
+`mcpOnly: true` 时，插件只暴露 MCP 工具服务（Chrome DevTools 控制、Vue DevTools、日志读取等），不注入挂件、不启动 AI 引擎，适合作为独立 MCP server 供外部 Agent 消费。
+
+```ts
+aipanelAssistant({ mcpOnly: true });
+```
+
+启动后 MCP 端点挂在 Vite dev server 上，外部 MCP 客户端配置 Streamable HTTP 接入 `http://localhost:5173/__aipanel_mcp__`。
+
 ## 工作原理
 
 ```
 ┌────────────────┐      ┌────────────────┐      ┌─────────────┐
-│  Vite 插件       │      │  浏览器扩展      │      │  OpenCode   │
-│  启动 Web 服务   │◀────▶│  侧边栏面板      │◀────▶│  AI 引擎    │
+│  Vite 插件       │      │  浏览器扩展      │      │ OpenCode/dsh │
+│  启动 Web 服务   │◀────▶│  侧边栏面板      │◀────▶│  AI 引擎     │
 │  代理跨域        │      │  页面上下文同步   │      │  会话管理    │
 └────────────────┘      └────────────────┘      └─────────────┘
 ```

package/es/core/mcp-proxy.mjs

@@ -17,7 +17,7 @@ var __privateWrapper = (obj, member, setter, getter) => ({
     return __privateGet(obj, member, getter);
   }
 });
-var _proc, _rl, _messageId, _internalIdBase, _pending, _args, _startPromise, _idleTimer, _idleTimeout, _McpProxy_instances, doStart_fn, resetIdleTimer_fn;
+var _proc, _rl, _messageId, _internalIdBase, _pending, _args, _startPromise, _lastExit, _stderrTail, _idleTimer, _idleTimeout, _McpProxy_instances, doStart_fn, formatNotAvailable_fn, resetIdleTimer_fn;
 import { spawn } from "node:child_process";
 import { createInterface } from "node:readline";
 import crypto from "node:crypto";
@@ -44,6 +44,10 @@ class McpProxy {
     __privateAdd(this, _pending, /* @__PURE__ */ new Map());
     __privateAdd(this, _args);
     __privateAdd(this, _startPromise, null);
+    /** 最近一次进程退出信息，用于生成精确错误（无退出记录时为 null） */
+    __privateAdd(this, _lastExit, null);
+    /** 捕获的 stderr 最近若干行，进程异常退出时作为诊断信息 */
+    __privateAdd(this, _stderrTail, []);
     __privateAdd(this, _idleTimer, null);
     __privateAdd(this, _idleTimeout);
     __publicField(this, "sessionId");
@@ -61,14 +65,19 @@ class McpProxy {
   async start() {
     if (this.isRunning) return;
     if (__privateGet(this, _startPromise)) return __privateGet(this, _startPromise);
-    __privateSet(this, _startPromise, __privateMethod(this, _McpProxy_instances, doStart_fn).call(this));
-    return __privateGet(this, _startPromise);
+    const p = __privateMethod(this, _McpProxy_instances, doStart_fn).call(this);
+    __privateSet(this, _startPromise, p);
+    try {
+      await p;
+    } finally {
+      __privateSet(this, _startPromise, null);
+    }
   }
   /** 转发原始 JSON-RPC 请求，保留客户端 ID */
   async forward(rawRequest) {
     await this.start();
     if (!__privateGet(this, _proc) || !__privateGet(this, _proc).stdin) {
-      throw new Error("MCP process not available");
+      throw new Error(__privateMethod(this, _McpProxy_instances, formatNotAvailable_fn).call(this));
     }
     __privateMethod(this, _McpProxy_instances, resetIdleTimer_fn).call(this);
     let msg;
@@ -93,7 +102,7 @@ class McpProxy {
   async call(method, params = {}) {
     await this.start();
     if (!__privateGet(this, _proc) || !__privateGet(this, _proc).stdin) {
-      throw new Error("MCP process not available");
+      throw new Error(__privateMethod(this, _McpProxy_instances, formatNotAvailable_fn).call(this));
     }
     __privateMethod(this, _McpProxy_instances, resetIdleTimer_fn).call(this);
     const id = __privateGet(this, _internalIdBase) + ++__privateWrapper(this, _messageId)._;
@@ -141,6 +150,8 @@ _internalIdBase = new WeakMap();
 _pending = new WeakMap();
 _args = new WeakMap();
 _startPromise = new WeakMap();
+_lastExit = new WeakMap();
+_stderrTail = new WeakMap();
 _idleTimer = new WeakMap();
 _idleTimeout = new WeakMap();
 _McpProxy_instances = new WeakSet();
@@ -148,6 +159,8 @@ doStart_fn = async function() {
   log.debug("Starting MCP process", { args: __privateGet(this, _args) });
   try {
     const binPath = resolveChromeDevToolsMcpBin();
+    __privateSet(this, _lastExit, null);
+    __privateSet(this, _stderrTail, []);
     __privateSet(this, _proc, spawn(process.execPath, [binPath, ...__privateGet(this, _args)], {
       stdio: ["pipe", "pipe", "pipe"]
     }));
@@ -179,26 +192,56 @@ doStart_fn = async function() {
   __privateGet(this, _proc).stderr?.on("data", (d) => {
     const text = d.toString().trim();
     if (!text || /No handler registered for issue code \w+/i.test(text)) return;
+    __privateGet(this, _stderrTail).push(...text.split("\n"));
+    if (__privateGet(this, _stderrTail).length > 20) __privateGet(this, _stderrTail).splice(0, __privateGet(this, _stderrTail).length - 20);
     log.debug("[MCP stderr]", { text: text.substring(0, 200) });
   });
-  __privateGet(this, _proc).on("close", (code) => {
-    log.debug("MCP process closed", { code });
+  __privateGet(this, _proc).on("close", (code, signal) => {
+    const exitDesc = `code ${code ?? "null"}${signal ? ` (signal ${signal})` : ""}`;
+    const abnormalExit = code !== null && code !== 0 || signal !== null && signal !== "SIGTERM";
+    if (abnormalExit) {
+      log.warn("MCP process exited abnormally", {
+        code,
+        signal,
+        stderrTail: __privateGet(this, _stderrTail).join("\n").slice(0, 500)
+      });
+    } else {
+      log.debug("MCP process closed", { code, signal });
+    }
+    __privateSet(this, _lastExit, { code, signal, stderrTail: __privateGet(this, _stderrTail).join("\n") });
     for (const resolve of __privateGet(this, _pending).values()) {
-      resolve({ error: { code: -32e3, message: `MCP process exited with code ${code}` } });
+      resolve({ error: { code: -32e3, message: `MCP process exited with ${exitDesc}` } });
     }
     __privateGet(this, _pending).clear();
     __privateSet(this, _proc, null);
     __privateSet(this, _rl, null);
     __privateSet(this, _startPromise, null);
   });
-  await this.call("initialize", {
+  const initResult = await this.call("initialize", {
     protocolVersion: "2024-11-05",
     capabilities: {},
     clientInfo: { name: "vite-plugin-aipanel", version: "1.0.0" }
   });
+  if (!__privateGet(this, _proc)) {
+    throw new Error(__privateMethod(this, _McpProxy_instances, formatNotAvailable_fn).call(this));
+  }
+  if (initResult?.error) {
+    throw new Error(
+      `MCP initialize failed: ${initResult.error.message ?? JSON.stringify(initResult.error)}`
+    );
+  }
   log.debug("MCP proxy ready");
   __privateSet(this, _startPromise, null);
 };
+/** 生成 "MCP process not available" 的精确错误信息（包含最近一次退出原因与 stderr） */
+formatNotAvailable_fn = function() {
+  const exit = __privateGet(this, _lastExit);
+  if (!exit) return "MCP process not available";
+  const exitDesc = `code ${exit.code ?? "null"}${exit.signal ? ` (signal ${exit.signal})` : ""}`;
+  const tail = exit.stderrTail ? `
+  stderr: ${exit.stderrTail}` : "";
+  return `MCP process not available (last exit ${exitDesc})${tail}`;
+};
 resetIdleTimer_fn = function() {
   if (__privateGet(this, _idleTimeout) <= 0) return;
   if (__privateGet(this, _idleTimer)) clearTimeout(__privateGet(this, _idleTimer));

package/lib/core/mcp-proxy.cjs

@@ -53,7 +53,7 @@ var import_node_readline = require("node:readline");
 var import_node_crypto = __toESM(require("node:crypto"));
 var import_node_path = __toESM(require("node:path"));
 var import_node = require("@aipanel/core/node");
-var _proc, _rl, _messageId, _internalIdBase, _pending, _args, _startPromise, _idleTimer, _idleTimeout, _McpProxy_instances, doStart_fn, resetIdleTimer_fn;
+var _proc, _rl, _messageId, _internalIdBase, _pending, _args, _startPromise, _lastExit, _stderrTail, _idleTimer, _idleTimeout, _McpProxy_instances, doStart_fn, formatNotAvailable_fn, resetIdleTimer_fn;
 const log = (0, import_node.createLogger)("McpProxy");
 function resolveChromeDevToolsMcpBin() {
   const pluginDir = (0, import_node.resolvePackageDir)("vite-plugin-aipanel");
@@ -75,6 +75,10 @@ class McpProxy {
     __privateAdd(this, _pending, /* @__PURE__ */ new Map());
     __privateAdd(this, _args);
     __privateAdd(this, _startPromise, null);
+    /** 最近一次进程退出信息，用于生成精确错误（无退出记录时为 null） */
+    __privateAdd(this, _lastExit, null);
+    /** 捕获的 stderr 最近若干行，进程异常退出时作为诊断信息 */
+    __privateAdd(this, _stderrTail, []);
     __privateAdd(this, _idleTimer, null);
     __privateAdd(this, _idleTimeout);
     __publicField(this, "sessionId");
@@ -92,14 +96,19 @@ class McpProxy {
   async start() {
     if (this.isRunning) return;
     if (__privateGet(this, _startPromise)) return __privateGet(this, _startPromise);
-    __privateSet(this, _startPromise, __privateMethod(this, _McpProxy_instances, doStart_fn).call(this));
-    return __privateGet(this, _startPromise);
+    const p = __privateMethod(this, _McpProxy_instances, doStart_fn).call(this);
+    __privateSet(this, _startPromise, p);
+    try {
+      await p;
+    } finally {
+      __privateSet(this, _startPromise, null);
+    }
   }
   /** 转发原始 JSON-RPC 请求，保留客户端 ID */
   async forward(rawRequest) {
     await this.start();
     if (!__privateGet(this, _proc) || !__privateGet(this, _proc).stdin) {
-      throw new Error("MCP process not available");
+      throw new Error(__privateMethod(this, _McpProxy_instances, formatNotAvailable_fn).call(this));
     }
     __privateMethod(this, _McpProxy_instances, resetIdleTimer_fn).call(this);
     let msg;
@@ -124,7 +133,7 @@ class McpProxy {
   async call(method, params = {}) {
     await this.start();
     if (!__privateGet(this, _proc) || !__privateGet(this, _proc).stdin) {
-      throw new Error("MCP process not available");
+      throw new Error(__privateMethod(this, _McpProxy_instances, formatNotAvailable_fn).call(this));
     }
     __privateMethod(this, _McpProxy_instances, resetIdleTimer_fn).call(this);
     const id = __privateGet(this, _internalIdBase) + ++__privateWrapper(this, _messageId)._;
@@ -172,6 +181,8 @@ _internalIdBase = new WeakMap();
 _pending = new WeakMap();
 _args = new WeakMap();
 _startPromise = new WeakMap();
+_lastExit = new WeakMap();
+_stderrTail = new WeakMap();
 _idleTimer = new WeakMap();
 _idleTimeout = new WeakMap();
 _McpProxy_instances = new WeakSet();
@@ -179,6 +190,8 @@ doStart_fn = async function() {
   log.debug("Starting MCP process", { args: __privateGet(this, _args) });
   try {
     const binPath = resolveChromeDevToolsMcpBin();
+    __privateSet(this, _lastExit, null);
+    __privateSet(this, _stderrTail, []);
     __privateSet(this, _proc, (0, import_node_child_process.spawn)(process.execPath, [binPath, ...__privateGet(this, _args)], {
       stdio: ["pipe", "pipe", "pipe"]
     }));
@@ -210,26 +223,56 @@ doStart_fn = async function() {
   __privateGet(this, _proc).stderr?.on("data", (d) => {
     const text = d.toString().trim();
     if (!text || /No handler registered for issue code \w+/i.test(text)) return;
+    __privateGet(this, _stderrTail).push(...text.split("\n"));
+    if (__privateGet(this, _stderrTail).length > 20) __privateGet(this, _stderrTail).splice(0, __privateGet(this, _stderrTail).length - 20);
     log.debug("[MCP stderr]", { text: text.substring(0, 200) });
   });
-  __privateGet(this, _proc).on("close", (code) => {
-    log.debug("MCP process closed", { code });
+  __privateGet(this, _proc).on("close", (code, signal) => {
+    const exitDesc = `code ${code ?? "null"}${signal ? ` (signal ${signal})` : ""}`;
+    const abnormalExit = code !== null && code !== 0 || signal !== null && signal !== "SIGTERM";
+    if (abnormalExit) {
+      log.warn("MCP process exited abnormally", {
+        code,
+        signal,
+        stderrTail: __privateGet(this, _stderrTail).join("\n").slice(0, 500)
+      });
+    } else {
+      log.debug("MCP process closed", { code, signal });
+    }
+    __privateSet(this, _lastExit, { code, signal, stderrTail: __privateGet(this, _stderrTail).join("\n") });
     for (const resolve of __privateGet(this, _pending).values()) {
-      resolve({ error: { code: -32e3, message: `MCP process exited with code ${code}` } });
+      resolve({ error: { code: -32e3, message: `MCP process exited with ${exitDesc}` } });
     }
     __privateGet(this, _pending).clear();
     __privateSet(this, _proc, null);
     __privateSet(this, _rl, null);
     __privateSet(this, _startPromise, null);
   });
-  await this.call("initialize", {
+  const initResult = await this.call("initialize", {
     protocolVersion: "2024-11-05",
     capabilities: {},
     clientInfo: { name: "vite-plugin-aipanel", version: "1.0.0" }
   });
+  if (!__privateGet(this, _proc)) {
+    throw new Error(__privateMethod(this, _McpProxy_instances, formatNotAvailable_fn).call(this));
+  }
+  if (initResult?.error) {
+    throw new Error(
+      `MCP initialize failed: ${initResult.error.message ?? JSON.stringify(initResult.error)}`
+    );
+  }
   log.debug("MCP proxy ready");
   __privateSet(this, _startPromise, null);
 };
+/** 生成 "MCP process not available" 的精确错误信息（包含最近一次退出原因与 stderr） */
+formatNotAvailable_fn = function() {
+  const exit = __privateGet(this, _lastExit);
+  if (!exit) return "MCP process not available";
+  const exitDesc = `code ${exit.code ?? "null"}${exit.signal ? ` (signal ${exit.signal})` : ""}`;
+  const tail = exit.stderrTail ? `
+  stderr: ${exit.stderrTail}` : "";
+  return `MCP process not available (last exit ${exitDesc})${tail}`;
+};
 resetIdleTimer_fn = function() {
   if (__privateGet(this, _idleTimeout) <= 0) return;
   if (__privateGet(this, _idleTimer)) clearTimeout(__privateGet(this, _idleTimer));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-aipanel",
-  "version": "1.2.0-beta.4",
+  "version": "1.2.1",
   "description": "Embed OpenCode Web UI in your Vite dev server for real-time code modification and preview",
   "type": "module",
   "main": "lib/index.cjs",
@@ -37,16 +37,16 @@
   "dependencies": {
     "@vue/devtools-kit": "^8.0.0",
     "@vue/language-server": "^3.3.7",
-    "chrome-devtools-mcp": "1.7.0",
+    "chrome-devtools-mcp": "^1.8.0",
     "execa": "^9.6.1",
     "typescript-language-server": "^5.3.0",
     "unplugin-vue-inspector": "^3.0.0",
-    "@aipanel/core": "1.2.0-beta.4",
-    "@aipanel/provider-opencode": "1.2.0-beta.4"
+    "@aipanel/core": "1.2.1",
+    "@aipanel/provider-opencode": "1.2.1"
   },
   "peerDependencies": {
     "vite": ">=5.0.0",
-    "@aipanel/provider-deepseek": "1.2.0-beta.4"
+    "@aipanel/provider-deepseek": "1.2.1"
   },
   "peerDependenciesMeta": {
     "@aipanel/provider-deepseek": {
@@ -55,14 +55,10 @@
   },
   "devDependencies": {
     "sharp": "^0.34.5",
-    "@aipanel/client": "1.2.0-beta.4"
+    "@aipanel/client": "1.2.1"
   },
   "scripts": {
-    "prepare-eslint-lsp": "node scripts/prepare-eslint-lsp.mjs",
     "build": "pagoda-cli build && vite build -c vite.client.config.ts",
-    "dev": "pagoda-cli dev",
-    "site": "pagoda-cli site",
-    "build:site": "pagoda-cli build-site",
     "typecheck": "tsc -p tsconfig.declaration.json --noEmit"
   }
 }