ms-vite-plugin 1.3.4 → 1.3.5

package/dist/build.js

@@ -42,6 +42,7 @@ const child_process_1 = require("child_process");
 const fsExtra = __importStar(require("fs-extra"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
+const stopGuardPlugin_1 = require("./stopGuardPlugin");
 const vite_plugin_bundle_obfuscator_1 = __importDefault(require("vite-plugin-bundle-obfuscator"));
 /**
  * 压缩目录
@@ -202,15 +203,18 @@ const buildAll = async (isDev = true, workspacePath) => {
                     sourcemap: isDev,
                     minify: !isDev, // 开发环境不压缩变量名
                 },
-                plugins: isDev
-                    ? []
-                    : [
-                        (0, vite_plugin_bundle_obfuscator_1.default)({
-                            autoExcludeNodeModules: true,
-                            threadPool: true,
-                            options: obfuscatorConfig,
-                        }),
-                    ],
+                plugins: [
+                    (0, stopGuardPlugin_1.createStopGuardPlugin)(),
+                    ...(isDev
+                        ? []
+                        : [
+                            (0, vite_plugin_bundle_obfuscator_1.default)({
+                                autoExcludeNodeModules: true,
+                                threadPool: true,
+                                options: obfuscatorConfig,
+                            }),
+                        ]),
+                ],
             });
         }
     }

package/dist/stopGuardPlugin.d.ts

@@ -0,0 +1,8 @@
+import type { Plugin } from "vite";
+/**
+ * 为最终 JS chunk 的 catch 块补充停止异常转抛逻辑。
+ *
+ * 这个插件运行在 renderChunk 阶段：Vite 已经把 TS/模块语法编译成最终 JS，但尚未写入文件。
+ * 使用 MagicString 返回 sourcemap，让新增保护代码不映射到用户源码，原有代码继续保持映射。
+ */
+export declare function createStopGuardPlugin(): Plugin;

package/dist/stopGuardPlugin.js

@@ -0,0 +1,161 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStopGuardPlugin = createStopGuardPlugin;
+const acorn = __importStar(require("acorn"));
+const MagicString = require("magic-string");
+const STOP_GUARD_ERROR = "__kuaijs_stop_guard_error";
+const STOP_EXCEPTION_NAME = "KuaiJSManualExitException";
+/**
+ * 为最终 JS chunk 的 catch 块补充停止异常转抛逻辑。
+ *
+ * 这个插件运行在 renderChunk 阶段：Vite 已经把 TS/模块语法编译成最终 JS，但尚未写入文件。
+ * 使用 MagicString 返回 sourcemap，让新增保护代码不映射到用户源码，原有代码继续保持映射。
+ */
+function createStopGuardPlugin() {
+    return {
+        name: "kuaijs-stop-guard",
+        enforce: "post",
+        renderChunk(code) {
+            const edits = createStopGuardEdits(code);
+            if (edits.length === 0) {
+                return null;
+            }
+            const magic = new MagicString(code);
+            for (const edit of edits) {
+                if (edit.start === edit.end) {
+                    magic.appendLeft(edit.start, edit.text);
+                }
+                else {
+                    magic.overwrite(edit.start, edit.end, edit.text);
+                }
+            }
+            return {
+                code: magic.toString(),
+                map: magic.generateMap({ hires: true }),
+            };
+        },
+    };
+}
+function createStopGuardEdits(code) {
+    const ast = parseJavaScript(code);
+    const edits = [];
+    walkAst(ast, (node) => {
+        if (node.type === "CatchClause" && node.body?.type === "BlockStatement") {
+            addCatchStopExceptionGuard(edits, node, code);
+        }
+    });
+    return edits;
+}
+function parseJavaScript(code) {
+    try {
+        return acorn.parse(code, {
+            allowHashBang: true,
+            ecmaVersion: "latest",
+            sourceType: "script",
+        });
+    }
+    catch {
+        return acorn.parse(code, {
+            allowHashBang: true,
+            ecmaVersion: "latest",
+            sourceType: "module",
+        });
+    }
+}
+function addCatchStopExceptionGuard(edits, catchClause, code) {
+    if (typeof catchClause.body.start !== "number") {
+        return;
+    }
+    let errorExpression = STOP_GUARD_ERROR;
+    let restoreCatchPattern = "";
+    if (catchClause.param) {
+        if (catchClause.param.type === "Identifier") {
+            errorExpression = catchClause.param.name;
+        }
+        else if (typeof catchClause.param.start === "number" &&
+            typeof catchClause.param.end === "number") {
+            const originalPattern = code.slice(catchClause.param.start, catchClause.param.end);
+            edits.push({
+                start: catchClause.param.start,
+                end: catchClause.param.end,
+                text: STOP_GUARD_ERROR,
+            });
+            restoreCatchPattern = `let ${originalPattern}=${STOP_GUARD_ERROR};`;
+        }
+    }
+    else {
+        edits.push({
+            start: catchClause.body.start,
+            end: catchClause.body.start,
+            text: `(${STOP_GUARD_ERROR})`,
+        });
+    }
+    const stopGuard = `if(String(${errorExpression}).includes("${STOP_EXCEPTION_NAME}")){` +
+        `throw ${errorExpression};` +
+        `}`;
+    edits.push({
+        start: catchClause.body.start + 1,
+        end: catchClause.body.start + 1,
+        text: stopGuard + restoreCatchPattern,
+    });
+}
+function walkAst(node, visit) {
+    if (!node || typeof node !== "object") {
+        return;
+    }
+    if (typeof node.type === "string") {
+        visit(node);
+    }
+    for (const key of Object.keys(node)) {
+        if (key === "parent" ||
+            key === "start" ||
+            key === "end" ||
+            key === "loc" ||
+            key === "range" ||
+            key === "raw") {
+            continue;
+        }
+        const value = node[key];
+        if (Array.isArray(value)) {
+            for (const child of value) {
+                walkAst(child, visit);
+            }
+        }
+        else if (value && typeof value === "object") {
+            walkAst(value, visit);
+        }
+    }
+}

package/docs/httpapi/api.md

@@ -2504,6 +2504,154 @@ GET /api/hid/mouseUp
 |---|---|---|---|---|---|
 |» success|boolean|true|none|是否成功|none|
 
+## POST 保存图像到相册
+
+POST /api/media/saveImageToAlbum
+
+### 请求体
+
+请求体为图片文件原始二进制数据。接口会流式写入临时文件，不会把完整文件缓存到内存。可通过 query 参数 `filename` 传入文件名用于保留扩展名。
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true
+}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
+状态码 **200**
+
+|名称|类型|必选|约束|中文名|说明|
+|---|---|---|---|---|---|
+|» success|boolean|true|none|是否成功|none|
+
+## POST 保存视频到相册
+
+POST /api/media/saveVideoToAlbumPath
+
+### 请求体
+
+请求体为视频文件原始二进制数据。接口会流式写入临时文件，不会把完整文件缓存到内存。可通过 query 参数 `filename` 传入文件名用于保留扩展名。
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true
+}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
+状态码 **200**
+
+|名称|类型|必选|约束|中文名|说明|
+|---|---|---|---|---|---|
+|» success|boolean|true|none|是否成功|none|
+
+## GET 清空相册图片
+
+GET /api/media/deleteAllPhotos
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true
+}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
+状态码 **200**
+
+|名称|类型|必选|约束|中文名|说明|
+|---|---|---|---|---|---|
+|» success|boolean|true|none|是否成功|none|
+
+## GET 清空相册视频
+
+GET /api/media/deleteAllVideos
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true
+}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
+状态码 **200**
+
+|名称|类型|必选|约束|中文名|说明|
+|---|---|---|---|---|---|
+|» success|boolean|true|none|是否成功|none|
+
+## GET 清空相册截图
+
+GET /api/media/deleteAllScreenshots
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true
+}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
+状态码 **200**
+
+|名称|类型|必选|约束|中文名|说明|
+|---|---|---|---|---|---|
+|» success|boolean|true|none|是否成功|none|
+
 # 数据模型
 
 <h2 id="tocS_软件状态">软件状态</h2>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-vite-plugin",
-  "version": "1.3.4",
+  "version": "1.3.5",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {
@@ -22,10 +22,12 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "acorn": "8.15.0",
     "archiver": "^7.0.1",
     "commander": "^14.0.3",
     "crc": "^4.3.2",
     "fs-extra": "^11.3.5",
+    "magic-string": "^0.30.21",
     "sharp": "^0.34.5",
     "uuid": "^14.0.0",
     "vite": "^8.0.13",
@@ -42,4 +44,4 @@
     "@types/ws": "^8.18.1",
     "typescript": "~6.0.3"
   }
-}
+}