ms-vite-plugin 1.1.4 → 1.1.5

package/dist/mcp/tools.js

@@ -269,6 +269,39 @@ function registerDocTools(server) {
  * registerRuntimeTools(server)
  */
 function registerRuntimeTools(server) {
+    /**
+     * MCP 进程内当前工作目录（可通过 set_workspace 修改）
+     */
+    let currentWorkspacePath;
+    /**
+     * 解析并记忆工作目录
+     * @param workspacePath 可选的工作目录
+     * @returns 返回本次生效的绝对路径
+     * @example
+     * const workspace = resolveWorkspacePath("/Users/demo/project")
+     */
+    function resolveWorkspacePath(workspacePath) {
+        if (workspacePath && workspacePath.trim()) {
+            currentWorkspacePath = path.resolve(workspacePath.trim());
+            return currentWorkspacePath;
+        }
+        if (currentWorkspacePath) {
+            return currentWorkspacePath;
+        }
+        return process.cwd();
+    }
+    /**
+     * 校验并返回有效工作目录
+     * @param workspacePath 可选工作目录
+     * @returns 返回校验通过的绝对路径
+     * @example
+     * const workspace = await ensureWorkspacePath("/Users/demo/project")
+     */
+    async function ensureWorkspacePath(workspacePath) {
+        const workspace = resolveWorkspacePath(workspacePath);
+        await (0, project_2.ensureValidKuaiJSProject)(workspace);
+        return workspace;
+    }
     /**
      * 解析运行目标：
      * - 显式 transport=ws: 强制走 ws
@@ -306,6 +339,41 @@ function registerRuntimeTools(server) {
             label: `${device.ip}:${device.port}`,
         };
     }
+    server.registerTool("set_workspace", {
+        title: "Set Workspace",
+        description: "设置默认工作目录。后续 build/run/package/watch 等工具会优先使用该目录。",
+        inputSchema: {
+            workspacePath: z
+                .string()
+                .min(1)
+                .describe("快点JS 项目目录绝对路径（需包含 package.json 与 scripts）"),
+        },
+    }, async ({ workspacePath }) => {
+        const workspace = await ensureWorkspacePath(workspacePath);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `默认工作目录已设置为: ${workspace}`,
+                },
+            ],
+        };
+    });
+    server.registerTool("get_workspace", {
+        title: "Get Workspace",
+        description: "查看当前 MCP 生效的工作目录。",
+        inputSchema: {},
+    }, async () => {
+        const workspace = resolveWorkspacePath();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `当前工作目录: ${workspace}`,
+                },
+            ],
+        };
+    });
     server.registerTool("set_device", {
         title: "Set Device",
         description: "设置默认设备连接信息。首次配置后，后续 run/stop 可不再传 ip。",
@@ -525,6 +593,11 @@ function registerRuntimeTools(server) {
         title: "Watch Logs",
         description: "通过 SSE 监听设备日志并自动判定异常。首次可传 ip，也可复用 set_device 保存的默认设备。",
         inputSchema: {
+            workspacePath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
             ip: z
                 .string()
                 .min(1)
@@ -554,8 +627,8 @@ function registerRuntimeTools(server) {
                 .default(200)
                 .describe("最多收集日志条数，默认 200"),
         },
-    }, async ({ ip, port, durationSeconds, maxLogs }) => {
-        await (0, project_2.ensureValidKuaiJSProject)(process.cwd());
+    }, async ({ workspacePath, ip, port, durationSeconds, maxLogs }) => {
+        await ensureWorkspacePath(workspacePath);
         const device = await (0, device_config_1.resolveDeviceConfig)(ip, port);
         const result = await (0, project_1.watchDeviceLogsBySse)(device.ip, device.port, durationSeconds * 1000, maxLogs);
         const findingsPreview = result.findings
@@ -589,14 +662,19 @@ function registerRuntimeTools(server) {
         title: "Build Project",
         description: "构建 KuaiJS 项目，支持开发模式与生产模式。",
         inputSchema: {
+            workspacePath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
             dev: z
                 .boolean()
                 .optional()
                 .describe("是否开发模式构建，true=开发模式，false=生产模式"),
         },
-    }, async ({ dev }) => {
-        await (0, project_2.ensureValidKuaiJSProject)(process.cwd());
-        await (0, build_1.buildAll)(Boolean(dev), process.cwd());
+    }, async ({ workspacePath, dev }) => {
+        const workspace = await ensureWorkspacePath(workspacePath);
+        await (0, build_1.buildAll)(Boolean(dev), workspace);
         return {
             content: [
                 { type: "text", text: `构建完成，模式: ${dev ? "dev" : "prod"}` },
@@ -606,10 +684,16 @@ function registerRuntimeTools(server) {
     server.registerTool("package_project", {
         title: "Package Project",
         description: "执行生产构建并加密，返回 enc.msbundle 路径。",
-        inputSchema: {},
-    }, async () => {
-        await (0, project_2.ensureValidKuaiJSProject)(process.cwd());
-        const encryptedPath = await (0, packager_1.packageProject)(process.cwd());
+        inputSchema: {
+            workspacePath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
+        },
+    }, async ({ workspacePath }) => {
+        const workspace = await ensureWorkspacePath(workspacePath);
+        const encryptedPath = await (0, packager_1.packageProject)(workspace);
         return {
             content: [{ type: "text", text: `打包完成: ${encryptedPath}` }],
         };
@@ -648,9 +732,14 @@ function registerRuntimeTools(server) {
                 .max(600000)
                 .optional()
                 .describe("WS 等待连接超时毫秒（transport=ws 时可选，默认 30000）"),
+            workspacePath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
         },
-    }, async ({ transport, ip, port, wsPort, wsWaitMs }) => {
-        await (0, project_2.ensureValidKuaiJSProject)(process.cwd());
+    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath }) => {
+        const workspace = await ensureWorkspacePath(workspacePath);
         const target = await resolvePreferredRuntimeTarget({
             transport,
             ip,
@@ -663,11 +752,13 @@ function registerRuntimeTools(server) {
                 transport: "ws",
                 wsPort: target.wsPort,
                 wsWaitMs: target.wsWaitMs,
+                workspacePath: workspace,
             }
             : {
                 ip: target.ip,
                 port: target.port,
                 transport: "http",
+                workspacePath: workspace,
             });
         return {
             content: [
@@ -712,9 +803,14 @@ function registerRuntimeTools(server) {
                 .max(600000)
                 .optional()
                 .describe("WS 等待连接超时毫秒（transport=ws 时可选，默认 30000）"),
+            workspacePath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
         },
-    }, async ({ transport, ip, port, wsPort, wsWaitMs }) => {
-        await (0, project_2.ensureValidKuaiJSProject)(process.cwd());
+    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath }) => {
+        const workspace = await ensureWorkspacePath(workspacePath);
         const target = await resolvePreferredRuntimeTarget({
             transport,
             ip,
@@ -727,11 +823,13 @@ function registerRuntimeTools(server) {
                 transport: "ws",
                 wsPort: target.wsPort,
                 wsWaitMs: target.wsWaitMs,
+                workspacePath: workspace,
             }
             : {
                 ip: target.ip,
                 port: target.port,
                 transport: "http",
+                workspacePath: workspace,
             });
         return {
             content: [
@@ -776,9 +874,14 @@ function registerRuntimeTools(server) {
                 .max(600000)
                 .optional()
                 .describe("WS 等待连接超时毫秒（transport=ws 时可选，默认 30000）"),
+            workspacePath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("可选工作目录；不传时使用 set_workspace 记录值或 MCP 启动目录"),
         },
-    }, async ({ transport, ip, port, wsPort, wsWaitMs }) => {
-        await (0, project_2.ensureValidKuaiJSProject)(process.cwd());
+    }, async ({ transport, ip, port, wsPort, wsWaitMs, workspacePath }) => {
+        resolveWorkspacePath(workspacePath);
         const target = await resolvePreferredRuntimeTarget({
             transport,
             ip,

package/dist/project.d.ts

@@ -7,6 +7,7 @@ export interface DeviceCliOptions {
     transport?: string;
     wsPort?: string;
     wsWaitMs?: string;
+    workspacePath?: string;
 }
 /**
  * 设备日志条目

package/dist/project.js

@@ -709,7 +709,9 @@ async function ensureWsReady(options) {
  * await runOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
  */
 async function runOnDevice(options) {
-    const workspacePath = process.cwd();
+    const workspacePath = options.workspacePath
+        ? path.resolve(options.workspacePath)
+        : process.cwd();
     const transport = parseTransport(options);
     console.log(`🔧 开始构建项目: ${workspacePath}`);
     await runDevBuild(workspacePath);
@@ -737,7 +739,9 @@ async function runOnDevice(options) {
  * await runUIOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
  */
 async function runUIOnDevice(options) {
-    const workspacePath = process.cwd();
+    const workspacePath = options.workspacePath
+        ? path.resolve(options.workspacePath)
+        : process.cwd();
     const transport = parseTransport(options);
     console.log(`🔧 开始构建项目: ${workspacePath}`);
     await runDevBuild(workspacePath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-vite-plugin",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {