fast-cocos 1.1.0 → 1.1.2

package/dist/index.js

@@ -16,7 +16,8 @@ fast-cocos ttf          export ttf fonts
 fast-cocos robot        send dingtalk / feishu (lark) messages
 fast-cocos bmfont       export bmfont fonts
 fast-cocos xxteakey     generate xxteakey
-fast-cocos json         json operations`;
+fast-cocos json         json operations
+fast-cocos xor          xor encrypt/decrypt images`;
 /**
  * 打印 CLI 的命令使用说明。
  */

package/dist/xlsx/template/xlsx.txt

@@ -92,6 +92,4 @@ class Xlsx {
 }
 
 export const xlsx = Xlsx.instance;
-if (cc.sys.isBrowser) {
-    (window as any)["xlsx"] = xlsx;
-}
+(window as any)["xlsx"] = xlsx;

package/dist/xor/src/index.js

@@ -0,0 +1,60 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const xor_1 = require("./xor");
+/**
+ * 使用 commander 解析参数并执行 XOR 加解密。
+ */
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        commander_1.program
+            .name("xor")
+            .description("XOR 图片文件加解密")
+            .version(xor_1.XOR_VERSION)
+            .argument("<mode>", "encrypt 或 decrypt", (v) => {
+            if (v !== "encrypt" && v !== "decrypt") {
+                throw new commander_1.InvalidArgumentError("mode 须为 encrypt 或 decrypt");
+            }
+            return v;
+        })
+            .argument("<input>", "输入文件或目录路径")
+            .argument("[output]", "输出文件、目录路径（可选）")
+            .option("-s, --sign <sign>", "签名", xor_1.DEFAULT_SIGN)
+            .option("-k, --key <key>", "密钥", xor_1.DEFAULT_KEY)
+            .option("-e, --encrypted-suffix <suffix>", "加密输出文件名后缀（不含扩展名时与原名组合，如 .enc）", xor_1.DEFAULT_ENCRYPTED_FILE_SUFFIX)
+            .option("--ext <list>", "批量处理时的扩展名列表，逗号分隔（解密时默认会包含加密后缀对应扩展）")
+            .addHelpText("after", `
+示例:
+  fast-cocos xor encrypt sprite.png
+  fast-cocos xor encrypt sprite.png -e .xor -s MyS1 -k MySecretKey123
+  fast-cocos xor encrypt ./assets/ ./out/ --ext .png,.jpg
+  fast-cocos xor decrypt ./out/sprite.enc -e .enc
+`)
+            .action((mode, input, output) => {
+            const o = commander_1.program.opts();
+            (0, xor_1.runXorCommand)({
+                mode: mode,
+                input,
+                output,
+                sign: o.sign,
+                key: o.key,
+                encryptedFileSuffix: o.encryptedSuffix,
+                extensionsCsv: o.ext
+            });
+        });
+        yield commander_1.program.parseAsync(process.argv);
+    });
+}
+void main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/dist/xor/src/xor.js

@@ -0,0 +1,248 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ENCRYPTED_FILE_SUFFIX = exports.XOR_VERSION = exports.DEFAULT_IMAGE_EXTS = exports.DEFAULT_KEY = exports.DEFAULT_SIGN = void 0;
+exports.xorTransform = xorTransform;
+exports.encryptFile = encryptFile;
+exports.decryptFile = decryptFile;
+exports.batchProcess = batchProcess;
+exports.runXorCommand = runXorCommand;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/** 默认签名（4 字节） */
+exports.DEFAULT_SIGN = "CrP3";
+/** 默认密钥（16 字节） */
+exports.DEFAULT_KEY = "Xk9#mQ2$vL5@nR8w";
+/** 默认参与批量加密的图片扩展名 */
+exports.DEFAULT_IMAGE_EXTS = [".png", ".jpg", ".jpeg", ".webp", ".bmp"];
+exports.XOR_VERSION = "1.0.0";
+/** 默认加密输出文件名后缀（如 sprite.png -> sprite.enc） */
+exports.DEFAULT_ENCRYPTED_FILE_SUFFIX = ".enc";
+/**
+ * XOR 加密/解密（对称）
+ */
+function xorTransform(opts) {
+    const { data, key } = opts;
+    const result = Buffer.alloc(data.length);
+    const keyLen = key.length;
+    for (let i = 0; i < data.length; i++) {
+        result[i] = data[i] ^ key.charCodeAt(i % keyLen);
+    }
+    return result;
+}
+/**
+ * 加密文件（签名头 + XOR）
+ */
+function encryptFile(opts) {
+    var _a, _b, _c, _d;
+    const finalSign = (_a = opts.sign) !== null && _a !== void 0 ? _a : exports.DEFAULT_SIGN;
+    const finalKey = (_b = opts.key) !== null && _b !== void 0 ? _b : exports.DEFAULT_KEY;
+    const suffix = (_c = opts.encryptedFileSuffix) !== null && _c !== void 0 ? _c : exports.DEFAULT_ENCRYPTED_FILE_SUFFIX;
+    let out = (_d = opts.outputPath) !== null && _d !== void 0 ? _d : null;
+    if (!out) {
+        out = defaultEncryptedOutputPath(opts.inputPath, suffix);
+    }
+    else if (out.endsWith("/") || out.endsWith(path_1.default.sep)) {
+        const stem = path_1.default.basename(opts.inputPath, path_1.default.extname(opts.inputPath));
+        out = path_1.default.join(out, stem + suffix);
+    }
+    else if (fs_1.default.existsSync(out) && fs_1.default.statSync(out).isDirectory()) {
+        const stem = path_1.default.basename(opts.inputPath, path_1.default.extname(opts.inputPath));
+        out = path_1.default.join(out, stem + suffix);
+    }
+    if (out === null) {
+        throw new Error("输出路径解析失败");
+    }
+    const destPath = out;
+    const rawData = fs_1.default.readFileSync(opts.inputPath);
+    const encrypted = xorTransform({ data: rawData, key: finalKey });
+    const signature = Buffer.from(finalSign, "utf-8");
+    const output = Buffer.concat([signature, encrypted]);
+    fs_1.default.writeFileSync(destPath, output);
+    console.log(`加密: ${path_1.default.basename(opts.inputPath)} -> ${path_1.default.basename(destPath)} [sign:${finalSign}, key:${finalKey.substring(0, 4)}...]`);
+}
+/**
+ * 解密文件（校验签名头 + XOR）
+ * @returns 签名不匹配时为 false
+ */
+function decryptFile(opts) {
+    var _a, _b, _c, _d;
+    const finalSign = (_a = opts.sign) !== null && _a !== void 0 ? _a : exports.DEFAULT_SIGN;
+    const finalKey = (_b = opts.key) !== null && _b !== void 0 ? _b : exports.DEFAULT_KEY;
+    const suffix = (_c = opts.encryptedFileSuffix) !== null && _c !== void 0 ? _c : exports.DEFAULT_ENCRYPTED_FILE_SUFFIX;
+    let out = (_d = opts.outputPath) !== null && _d !== void 0 ? _d : null;
+    if (!out) {
+        out = defaultDecryptedOutputPath(opts.inputPath, suffix);
+    }
+    else if (out.endsWith("/") || out.endsWith(path_1.default.sep)) {
+        const base = path_1.default.basename(opts.inputPath);
+        const stem = base.endsWith(suffix) ? base.slice(0, -suffix.length) : path_1.default.basename(opts.inputPath, path_1.default.extname(opts.inputPath));
+        out = path_1.default.join(out, stem);
+    }
+    else if (fs_1.default.existsSync(out) && fs_1.default.statSync(out).isDirectory()) {
+        const base = path_1.default.basename(opts.inputPath);
+        const stem = base.endsWith(suffix) ? base.slice(0, -suffix.length) : path_1.default.basename(opts.inputPath, path_1.default.extname(opts.inputPath));
+        out = path_1.default.join(out, stem);
+    }
+    if (out === null) {
+        throw new Error("输出路径解析失败");
+    }
+    const destPath = out;
+    const encryptedData = fs_1.default.readFileSync(opts.inputPath);
+    const signBuffer = Buffer.from(finalSign, "utf-8");
+    const signSize = signBuffer.length;
+    if (encryptedData.length < signSize || !encryptedData.subarray(0, signSize).equals(signBuffer)) {
+        console.log(`跳过（签名不匹配）: ${path_1.default.basename(opts.inputPath)}`);
+        return false;
+    }
+    const dataWithoutSign = encryptedData.subarray(signSize);
+    const decrypted = xorTransform({ data: dataWithoutSign, key: finalKey });
+    fs_1.default.writeFileSync(destPath, decrypted);
+    console.log(`解密: ${path_1.default.basename(opts.inputPath)} -> ${path_1.default.basename(destPath)} [sign:${finalSign}, key:${finalKey.substring(0, 4)}...]`);
+    return true;
+}
+/**
+ * 递归批量处理目录
+ */
+function batchProcess(opts) {
+    var _a, _b;
+    const { dirPath, mode, outputDir = null, sign = null, key = null } = opts;
+    const suffix = (_a = opts.encryptedFileSuffix) !== null && _a !== void 0 ? _a : exports.DEFAULT_ENCRYPTED_FILE_SUFFIX;
+    const extensions = (_b = opts.extensions) !== null && _b !== void 0 ? _b : defaultExtensionsForMode(mode, suffix);
+    if (!fs_1.default.existsSync(dirPath)) {
+        console.error(`目录不存在: ${dirPath}`);
+        return;
+    }
+    if (outputDir && !fs_1.default.existsSync(outputDir)) {
+        fs_1.default.mkdirSync(outputDir, { recursive: true });
+    }
+    const files = fs_1.default.readdirSync(dirPath);
+    let processedCount = 0;
+    for (const file of files) {
+        const fullPath = path_1.default.join(dirPath, file);
+        const stat = fs_1.default.statSync(fullPath);
+        if (stat.isDirectory()) {
+            const subOutputDir = outputDir ? path_1.default.join(outputDir, file) : null;
+            batchProcess({ dirPath: fullPath, mode, outputDir: subOutputDir, extensions, sign, key, encryptedFileSuffix: suffix });
+        }
+        else {
+            const ext = path_1.default.extname(file).toLowerCase();
+            if (!extensions.includes(ext)) {
+                continue;
+            }
+            let outputFile;
+            if (mode === "encrypt") {
+                const stem = path_1.default.basename(file, ext);
+                outputFile = outputDir ? path_1.default.join(outputDir, stem + suffix) : path_1.default.join(path_1.default.dirname(fullPath), stem + suffix);
+                encryptFile({ inputPath: fullPath, outputPath: outputFile, sign, key, encryptedFileSuffix: suffix });
+                processedCount++;
+            }
+            else {
+                const base = file;
+                const stem = base.endsWith(suffix) ? base.slice(0, -suffix.length) : path_1.default.basename(file, ext);
+                outputFile = outputDir ? path_1.default.join(outputDir, stem) : path_1.default.join(path_1.default.dirname(fullPath), stem);
+                if (decryptFile({ inputPath: fullPath, outputPath: outputFile, sign, key, encryptedFileSuffix: suffix })) {
+                    processedCount++;
+                }
+            }
+        }
+    }
+    if (processedCount > 0) {
+        console.log(`\n${mode === "encrypt" ? "加密" : "解密"} 完成，共处理 ${processedCount} 个文件`);
+    }
+}
+/**
+ * 由 CLI 解析结果驱动：单文件或目录批量
+ */
+function runXorCommand(opts) {
+    var _a, _b, _c, _d;
+    const { mode, input } = opts;
+    const suffix = (_a = opts.encryptedFileSuffix) !== null && _a !== void 0 ? _a : exports.DEFAULT_ENCRYPTED_FILE_SUFFIX;
+    const sign = (_b = opts.sign) !== null && _b !== void 0 ? _b : exports.DEFAULT_SIGN;
+    const key = (_c = opts.key) !== null && _c !== void 0 ? _c : exports.DEFAULT_KEY;
+    const extensions = parseExtensionsCsv(opts.extensionsCsv, mode, suffix);
+    console.log(`\n使用配置: 签名="${sign}", 密钥="${key.substring(0, 4)}***", 加密后缀="${suffix}"`);
+    const stats = fs_1.default.statSync(input);
+    if (stats.isFile()) {
+        let finalOutput = opts.output;
+        if (!finalOutput) {
+            if (mode === "encrypt") {
+                finalOutput = defaultEncryptedOutputPath(input, suffix);
+            }
+            else {
+                finalOutput = defaultDecryptedOutputPath(input, suffix);
+            }
+        }
+        else if (finalOutput.endsWith("/") || finalOutput.endsWith(path_1.default.sep)) {
+            if (mode === "encrypt") {
+                const stem = path_1.default.basename(input, path_1.default.extname(input));
+                finalOutput = path_1.default.join(finalOutput, stem + suffix);
+            }
+            else {
+                const base = path_1.default.basename(input);
+                const stem = base.endsWith(suffix) ? base.slice(0, -suffix.length) : path_1.default.basename(input, path_1.default.extname(input));
+                finalOutput = path_1.default.join(finalOutput, stem);
+            }
+        }
+        else if (fs_1.default.existsSync(finalOutput) && fs_1.default.statSync(finalOutput).isDirectory()) {
+            if (mode === "encrypt") {
+                const stem = path_1.default.basename(input, path_1.default.extname(input));
+                finalOutput = path_1.default.join(finalOutput, stem + suffix);
+            }
+            else {
+                const base = path_1.default.basename(input);
+                const stem = base.endsWith(suffix) ? base.slice(0, -suffix.length) : path_1.default.basename(input, path_1.default.extname(input));
+                finalOutput = path_1.default.join(finalOutput, stem);
+            }
+        }
+        if (mode === "encrypt") {
+            encryptFile({ inputPath: input, outputPath: finalOutput, sign, key, encryptedFileSuffix: suffix });
+        }
+        else {
+            decryptFile({ inputPath: input, outputPath: finalOutput, sign, key, encryptedFileSuffix: suffix });
+        }
+    }
+    else if (stats.isDirectory()) {
+        batchProcess({
+            dirPath: input,
+            mode,
+            outputDir: (_d = opts.output) !== null && _d !== void 0 ? _d : null,
+            extensions,
+            sign,
+            key,
+            encryptedFileSuffix: suffix
+        });
+    }
+}
+function defaultEncryptedOutputPath(inputPath, suffix) {
+    const dir = path_1.default.dirname(inputPath);
+    const stem = path_1.default.basename(inputPath, path_1.default.extname(inputPath));
+    return path_1.default.join(dir, stem + suffix);
+}
+function defaultDecryptedOutputPath(inputPath, suffix) {
+    const dir = path_1.default.dirname(inputPath);
+    const base = path_1.default.basename(inputPath);
+    if (base.endsWith(suffix)) {
+        return path_1.default.join(dir, base.slice(0, -suffix.length));
+    }
+    return inputPath;
+}
+function defaultExtensionsForMode(mode, encryptedSuffix) {
+    if (mode === "decrypt") {
+        const set = new Set([...exports.DEFAULT_IMAGE_EXTS, encryptedSuffix.toLowerCase()]);
+        return [...set];
+    }
+    return [...exports.DEFAULT_IMAGE_EXTS];
+}
+function parseExtensionsCsv(csv, mode, encryptedSuffix) {
+    if (!csv || !csv.trim()) {
+        return defaultExtensionsForMode(mode, encryptedSuffix);
+    }
+    return csv
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .map((s) => (s.startsWith(".") ? s.toLowerCase() : `.${s.toLowerCase()}`));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fast-cocos",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "scripts": {
     "clean": "rm -rf dist",
     "start": "node ./dist/index.js",