swpp-backends 3.0.0-alpha.4 → 3.0.0-alpha.400

package/dist/swpp/ResourcesScanner.js

@@ -27,6 +27,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileUpdateTracker = exports.ResourcesScanner = void 0;
+exports.traverseDirectory = traverseDirectory;
 const fs_1 = __importDefault(require("fs"));
 const crypto = __importStar(require("node:crypto"));
 const path_1 = __importDefault(require("path"));
@@ -37,36 +38,42 @@ const untils_1 = require("./untils");
  * 资源文件扫描器
  */
 class ResourcesScanner {
-    constructor(compilation) {
+    constructor(compilation, oldTracker) {
         this.compilation = compilation;
+        this.oldTracker = oldTracker;
     }
     // noinspection JSUnusedGlobalSymbols
     /** 扫描指定目录下的所有文件 */
     async scanLocalFile(path) {
         const matchCacheRule = this.compilation.crossDep.read('matchCacheRule');
-        const register = this.compilation.compilationEnv.read('FILE_PARSER');
+        const register = this.compilation.fileParser;
+        const jsonInfo = this.compilation.compilationEnv.read('SWPP_JSON_FILE');
+        const excludes = [
+            path_1.default.posix.join(path, jsonInfo.swppPath, jsonInfo.versionPath),
+            path_1.default.posix.join(path, jsonInfo.swppPath, jsonInfo.trackerPath),
+            path_1.default.posix.join(path, this.compilation.compilationEnv.read('SERVICE_WORKER') + '.js')
+        ];
+        if (!this.oldTracker) {
+            this.oldTracker = await jsonInfo.fetchTrackerFile(this.compilation);
+        }
         const urls = new Set();
-        const tracker = new FileUpdateTracker(this.compilation);
+        const tracker = new FileUpdateTracker(this.compilation, this.oldTracker);
         await traverseDirectory(path, async (file) => {
-            const stream = fs_1.default.createReadStream(file);
-            const hash = crypto.createHash('md5');
-            stream.on('data', data => hash.update(data));
+            if (excludes.includes(file))
+                return;
             const localUrl = tracker.normalizeUri(file.substring(path.length));
-            if (matchCacheRule.runOnNode(localUrl)) {
+            const isCached = !!matchCacheRule.runOnNode(localUrl);
+            if (isCached) {
                 tracker.addUrl(localUrl.href);
             }
-            const type = path_1.default.extname(file);
-            if (register.containsType(type)) {
-                const set = await register.parserLocalFile(file);
-                set.forEach(it => urls.add(it));
-            }
-            await new Promise((resolve, reject) => {
-                stream.on('end', () => {
-                    tracker.update(file, hash.digest('hex'));
-                    resolve();
-                });
-                stream.on('error', err => reject(err));
-            });
+            const set = await register.parserLocalFile(file, content => {
+                if (isCached) {
+                    const hash = crypto.createHash('md5');
+                    hash.update(content);
+                    tracker.update(localUrl.pathname, hash.digest('hex'));
+                }
+            }, isCached);
+            set.forEach(it => urls.add(it));
         });
         await this.scanNetworkFile(tracker, urls);
         return tracker;
@@ -74,7 +81,8 @@ class ResourcesScanner {
     /** 扫描网络文件 */
     async scanNetworkFile(tracker, urls, record = new Set()) {
         const matchCacheRule = this.compilation.crossDep.read('matchCacheRule');
-        const registry = this.compilation.compilationEnv.read('FILE_PARSER');
+        const registry = this.compilation.fileParser;
+        const isStable = this.compilation.compilationEnv.read('isStable');
         const appendedUrls = new Set();
         const taskList = new Array(urls.size);
         let i = 0;
@@ -87,9 +95,19 @@ class ResourcesScanner {
             if (isCached) {
                 tracker.addUrl(normalizeUri.href);
             }
+            if (isStable(normalizeUri)) {
+                const oldValue = this.oldTracker?.get?.(normalizeUri.href);
+                if (Array.isArray(oldValue)) {
+                    const list = tracker.syncStable(normalizeUri, oldValue, this.oldTracker);
+                    list.forEach(it => appendedUrls.add(it));
+                    continue;
+                }
+            }
             taskList[i++] = registry.parserUrlFile(normalizeUri.href, !!isCached)
                 .then(value => {
-                tracker.update(value.file, value.mark);
+                if (isCached) {
+                    tracker.update(value.file, value.mark);
+                }
                 value.urls.forEach(it => appendedUrls.add(it));
             }).catch(err => untils_1.utils.printError('SCAN NETWORK FILE', err));
         }
@@ -112,7 +130,7 @@ async function traverseDirectory(dir, callback) {
                 if (err)
                     reject(err);
                 else {
-                    Promise.all(files.map(it => traverseDirectory(path_1.default.join(dir, it), callback))).then(() => resolve());
+                    Promise.all(files.map(it => traverseDirectory(path_1.default.posix.join(dir, it), callback))).then(() => resolve());
                 }
             });
         });
@@ -125,10 +143,9 @@ async function traverseDirectory(dir, callback) {
  * 文件更新监听器
  */
 class FileUpdateTracker {
-    constructor(compilation) {
+    constructor(compilation, oldTracker) {
         this.compilation = compilation;
-        /** 附加信息 */
-        this.headers = new Map();
+        this.oldTracker = oldTracker;
         /** 存储列表，key 为文件路径，value 为文件的唯一标识符 */
         this.map = new Map();
         /** 存储所有存在的 URL */
@@ -136,26 +153,58 @@ class FileUpdateTracker {
     }
     /** 更新一个文件的标识符 */
     update(uri, value) {
-        this.map.set(uri, value);
+        if (typeof value == 'string') {
+            if (value.startsWith('[')) {
+                throw new untils_1.RuntimeException(untils_1.exceptionNames.invalidValue, `插入数据（"${value}"）时，不应当以方括号开头`);
+            }
+            this.map.set(uri, value);
+        }
+        else if (Array.isArray(value)) {
+            this.map.set(uri, JSON.stringify(value));
+        }
+        else {
+            this.map.set(uri, JSON.stringify(Array.from(value)));
+        }
+    }
+    /**
+     * 同步指定的稳定资源（同步时会连同同步其连接的稳定资源）
+     * @return 直接或间接连接的一些需要扫描的资源
+     */
+    syncStable(uri, value, oldTracker) {
+        const isStable = this.compilation.compilationEnv.read('isStable');
+        this.update(uri.href, value);
+        this.addUrl(uri.href);
+        const result = [];
+        for (let item of value) {
+            this.addUrl(item);
+            const itemUrl = new URL(item);
+            if (isStable(itemUrl)) {
+                const oldValue = oldTracker.get(item);
+                if (Array.isArray(oldValue)) {
+                    const son = this.syncStable(itemUrl, oldValue, oldTracker);
+                    result.push(...son);
+                    continue;
+                }
+            }
+            result.push(item);
+        }
+        return result;
     }
     /** 读取一个文件的标识符 */
     get(uri) {
-        return this.map.get(this.normalizeUri(uri).href);
-    }
-    /** 设置一个 header */
-    putHeader(key, value) {
-        this.headers.set(key, value);
-    }
-    /** 读取一个 header */
-    getHeader(key) {
-        return this.headers.get(key);
+        const value = this.map.get(this.normalizeUri(uri).href);
+        if (!value)
+            return;
+        return value.startsWith('[') ? JSON.parse(value) : value;
     }
     /** 归一化 uri */
     normalizeUri(uri) {
         if (uri.startsWith('http:'))
             uri = `https:${uri.substring(5)}`;
-        const domain = this.compilation.compilationEnv.read('DOMAIN_HOST');
-        return new URL(uri, `https://${domain}`);
+        const baseUrl = this.compilation.compilationEnv.read('DOMAIN_HOST');
+        const url = new URL(uri, baseUrl);
+        const normalizer = this.compilation.crossDep.read('normalizeUrl');
+        return new URL(normalizer.runOnNode(url.href));
     }
     /** 添加一个 URL */
     addUrl(url) {
@@ -170,23 +219,20 @@ class FileUpdateTracker {
      * + 在新旧 tracker 中都存在且唯一标识符发生变化
      * + 在新 tracker 中不存在且在旧 tracker 中存在
      */
-    diff(oldTracker) {
+    async diff() {
+        const baseUrl = this.compilation.compilationEnv.read('DOMAIN_HOST');
         const diff = new JsonBuilder_1.JsonBuilder(this.compilation, this.allUrl);
-        oldTracker.map.forEach((value, key) => {
+        const oldTracker = this.oldTracker ??
+            await this.compilation.compilationEnv.read('SWPP_JSON_FILE').fetchTrackerFile(this.compilation);
+        oldTracker?.map?.forEach?.((value, key) => {
             if (this.map.has(key)) {
                 if (this.get(key) !== value)
-                    diff.update(key, value);
+                    diff.update(untils_1.utils.splicingUrl(baseUrl, key).href, value);
             }
             else {
-                diff.update(key, value);
+                diff.update(untils_1.utils.splicingUrl(baseUrl, key).href, value);
             }
         });
-        this.headers.forEach((value, key) => {
-            diff.putHeader(key, {
-                oldValue: oldTracker.getHeader(key),
-                newValue: value
-            });
-        });
         return diff;
     }
     // noinspection JSUnusedGlobalSymbols
@@ -198,9 +244,6 @@ class FileUpdateTracker {
      * ```json
      * {
      *   "version": 4,
-     *   "headers": {
-     *     [key: string]: any
-     *   },
      *   "tracker" {
      *     [uri: string]: string
      *   }
@@ -215,7 +258,7 @@ class FileUpdateTracker {
         this.map.forEach((value, key) => {
             result.tracker[key] = value;
         });
-        return JSON.stringify(result.tracker);
+        return JSON.stringify(result);
     }
     /** 解序列化数据 */
     static unJson(compilation, jsonStr) {
@@ -223,26 +266,17 @@ class FileUpdateTracker {
         const json = JSON.parse(jsonStr);
         switch (json.version) {
             case 4:
-                for (let key in json.headers) {
-                    tracker.headers.set(key, json.headers[key]);
-                }
                 for (let key in json.tracker) {
                     tracker.map.set(key, json.tracker[key]);
                 }
                 break;
             case 3:
-                for (let key in json['external']) {
-                    tracker.headers.set(key, json['external'][key]);
-                }
                 for (let key in json.list) {
                     const value = json.list[key];
                     tracker.map.set(key, value.length === 32 ? value : '');
                 }
                 break;
-            default: throw {
-                code: untils_1.exceptionNames.unsupportedVersion,
-                message: `不支持 ${json.version}`,
-            };
+            default: throw new untils_1.RuntimeException(untils_1.exceptionNames.unsupportedVersion, `不支持 ${json.version}`);
         }
         return tracker;
     }
@@ -251,9 +285,9 @@ class FileUpdateTracker {
     static async parserJsonFromNetwork(compilation) {
         const domain = compilation.compilationEnv.read('DOMAIN_HOST');
         const jsonInfo = compilation.compilationEnv.read('SWPP_JSON_FILE');
-        const url = new URL(jsonInfo.trackerPath, `https://${domain}`);
-        const fetcher = compilation.compilationEnv.read('FETCH_NETWORK_FILE');
-        const isNotFound = compilation.compilationEnv.read('IS_NOT_FOUND');
+        const url = untils_1.utils.splicingUrl(domain, jsonInfo.swppPath, jsonInfo.trackerPath);
+        const fetcher = compilation.compilationEnv.read('NETWORK_FILE_FETCHER');
+        const isNotFound = compilation.compilationEnv.read('isNotFound');
         const notFoundLevel = compilation.compilationEnv.read('ALLOW_NOT_FOUND');
         let error;
         const result = await (async () => {
@@ -261,10 +295,7 @@ class FileUpdateTracker {
                 const response = await fetcher.fetch(url);
                 if (isNotFound.response(response)) {
                     if (notFoundLevel == CompilationEnv_1.AllowNotFoundEnum.REJECT_ALL) {
-                        error = {
-                            code: untils_1.exceptionNames.notFound,
-                            message: `拉取 ${url} 时出现 404 错误`
-                        };
+                        error = new untils_1.RuntimeException(untils_1.exceptionNames.notFound, `拉取 ${url} 时出现 404 错误`);
                         return;
                     }
                     untils_1.utils.printWarning('SCANNER', '拉取 tracker 时服务器返回了 404，如果是第一次携带 swpp v3 构建网站请忽视这条信息');
@@ -278,11 +309,7 @@ class FileUpdateTracker {
                     untils_1.utils.printWarning('SCANNER', '拉取 tracker 时 DNS 解析失败，如果是第一次携带 swpp v3 构建网站且网站暂时无法解析请忽视这条信息');
                     return new FileUpdateTracker(compilation);
                 }
-                untils_1.utils.printError('SCANNER', e);
-                throw {
-                    code: untils_1.exceptionNames.error,
-                    message: `拉取或解析历史 Tracker 时出现错误`
-                };
+                throw new untils_1.RuntimeException(untils_1.exceptionNames.error, `拉取或解析历史 Tracker 时出现错误`, { cause: e });
             }
         })();
         if (result)

package/{types → dist}/swpp/SwCompiler.d.ts

@@ -1,10 +1,13 @@
 import { CompilationEnv } from './database/CompilationEnv';
+import { CompilationFileParser } from './database/CompilationFileParser';
 import { CrossDepCode } from './database/CrossDepCode';
+import { DomCode } from './database/DomCode';
 import { RuntimeCoreCode } from './database/RuntimeCoreCode';
 import { RuntimeDepCode } from './database/RuntimeDepCode';
 import { CrossEnv } from './database/CrossEnv';
 import { RuntimeEventCode } from './database/RuntimeEventCode';
 import { RuntimeKeyValueDatabase } from './database/RuntimeKeyValueDatabase';
+import { CallChainRecorder } from './debug/CallChainRecorder';
 export declare class SwCompiler {
     private swCode;
     /**
@@ -15,24 +18,34 @@ export declare class SwCompiler {
 /** 运行时数据 */
 export declare class RuntimeData {
     /** 控制插入顺序 */
-    readonly insertOrder: (Exclude<keyof RuntimeData, 'insertOrder'> | string)[];
+    insertOrder: (Exclude<keyof RuntimeData, 'insertOrder' | 'domConfig'> | string)[];
     /** 运行时环境变量 */
-    readonly crossEnv: CrossEnv;
+    crossEnv: CrossEnv;
     /** 运行时工具函数 */
-    readonly runtimeDep: RuntimeDepCode;
+    runtimeDep: RuntimeDepCode;
     /** 运行时核心功能函数 */
-    readonly runtimeCore: RuntimeCoreCode;
+    runtimeCore: RuntimeCoreCode;
     /** 运行时事件注册 */
-    readonly runtimeEvent: RuntimeEventCode;
+    runtimeEvent: RuntimeEventCode;
     /** 运行时/编译时工具函数 */
-    readonly crossDep: CrossDepCode;
+    crossDep: CrossDepCode;
+    /** DOM 相关设置 */
+    domConfig: DomCode;
+    /** 追踪调用链 */
+    debugCallChain: CallChainRecorder;
+    constructor(compilationData: CompilationData);
     getDatabase(key: string): RuntimeKeyValueDatabase<any, {}>;
+    initCompilation(compilation: CompilationData): void;
+    freezeAll(): void;
 }
 /** 编译时数据 */
-export interface CompilationData {
+export declare class CompilationData {
     compilationEnv: CompilationEnv;
-    crossEnv: CrossEnv;
     crossDep: CrossDepCode;
+    crossEnv: CrossEnv;
+    fileParser: CompilationFileParser;
+    initRuntime(runtime: RuntimeData): void;
+    freezeAll(): void;
 }
 /** 版本号信息 */
 export interface BrowserVersion {

package/dist/swpp/SwCompiler.js

@@ -1,11 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RuntimeData = exports.SwCompiler = void 0;
+exports.CompilationData = exports.RuntimeData = exports.SwCompiler = void 0;
+const CompilationEnv_1 = require("./database/CompilationEnv");
+const CompilationFileParser_1 = require("./database/CompilationFileParser");
 const CrossDepCode_1 = require("./database/CrossDepCode");
+const DomCode_1 = require("./database/DomCode");
+const KeyValueDatabase_1 = require("./database/KeyValueDatabase");
 const RuntimeCoreCode_1 = require("./database/RuntimeCoreCode");
 const RuntimeDepCode_1 = require("./database/RuntimeDepCode");
 const CrossEnv_1 = require("./database/CrossEnv");
 const RuntimeEventCode_1 = require("./database/RuntimeEventCode");
+const CallChainRecorder_1 = require("./debug/CallChainRecorder");
 const untils_1 = require("./untils");
 class SwCompiler {
     constructor() {
@@ -18,7 +23,6 @@ class SwCompiler {
     buildSwCode(runtime) {
         if (this.swCode)
             return this.swCode;
-        runtime.runtimeDep.fixDepFunction();
         this.swCode = '(() => {' + runtime.insertOrder
             .map(it => runtime.getDatabase(it).buildJsSource())
             .join(';\n')
@@ -29,35 +33,67 @@ class SwCompiler {
 exports.SwCompiler = SwCompiler;
 /** 运行时数据 */
 class RuntimeData {
-    constructor() {
+    constructor(compilationData) {
         /** 控制插入顺序 */
         this.insertOrder = [
             'crossEnv', 'crossDep', 'runtimeDep', 'runtimeCore', 'runtimeEvent'
         ];
-        /** 运行时环境变量 */
-        this.crossEnv = new CrossEnv_1.CrossEnv();
         /** 运行时工具函数 */
         this.runtimeDep = new RuntimeDepCode_1.RuntimeDepCode();
         /** 运行时核心功能函数 */
         this.runtimeCore = new RuntimeCoreCode_1.RuntimeCoreCode();
         /** 运行时事件注册 */
         this.runtimeEvent = new RuntimeEventCode_1.RuntimeEventCode();
-        /** 运行时/编译时工具函数 */
-        this.crossDep = new CrossDepCode_1.CrossDepCode();
+        /** DOM 相关设置 */
+        this.domConfig = new DomCode_1.DomCode();
+        /** 追踪调用链 */
+        this.debugCallChain = new CallChainRecorder_1.CallChainRecorder();
+        this.crossDep = compilationData.crossDep;
+        this.crossEnv = compilationData.crossEnv;
     }
     getDatabase(key) {
         if (!(key in this))
-            throw {
-                code: untils_1.exceptionNames.invalidKey,
-                message: `传入的 key [${key}] 不在当前对象中存在`
-            };
+            throw new untils_1.RuntimeException(untils_1.exceptionNames.invalidKey, `传入的 key [${key}] 不在当前对象中存在`);
         if (key == 'insertOrder')
-            throw {
-                code: untils_1.exceptionNames.invalidKey,
-                message: `传入的 key [${key}] 非法`
-            };
+            throw new untils_1.RuntimeException(untils_1.exceptionNames.invalidKey, `传入的 key [${key}] 非法`);
         // @ts-ignore
         return this[key];
     }
+    initCompilation(compilation) {
+        for (let key of this.insertOrder) {
+            this.getDatabase(key).initRuntimeAndCompilation(this, compilation);
+        }
+        this.domConfig.initRuntimeAndCompilation(this, compilation);
+    }
+    freezeAll() {
+        this.insertOrder.forEach(it => this.getDatabase(it).freeze());
+        this.domConfig.freeze();
+    }
 }
 exports.RuntimeData = RuntimeData;
+/** 编译时数据 */
+class CompilationData {
+    constructor() {
+        this.compilationEnv = new CompilationEnv_1.CompilationEnv();
+        this.crossDep = new CrossDepCode_1.CrossDepCode();
+        this.crossEnv = new CrossEnv_1.CrossEnv();
+        this.fileParser = new CompilationFileParser_1.CompilationFileParser();
+    }
+    initRuntime(runtime) {
+        for (let key in this) {
+            const value = this[key];
+            if (value instanceof KeyValueDatabase_1.KeyValueDatabase) {
+                value.initRuntimeAndCompilation(runtime, this);
+            }
+        }
+    }
+    freezeAll() {
+        for (let key in this) {
+            const value = this[key];
+            if (value instanceof KeyValueDatabase_1.KeyValueDatabase) {
+                value.freeze();
+            }
+        }
+    }
+}
+exports.CompilationData = CompilationData;

package/dist/swpp/cli.d.ts

@@ -0,0 +1,11 @@
+export interface SwppCliConfig {
+    /** 网站根目录 */
+    webRoot: string;
+    /** 配置文件所在的相对路径（越靠前优先级越高） */
+    configFiles: string[];
+    /** dom js 的相对路径（以 `/` 开头 `.js` 结尾） */
+    domJsPath?: string;
+    /** 需要被排除的 html 文件名，正则表达式，区分大小写 */
+    excludes?: string[];
+}
+export declare function initCommand(): Promise<void>;

package/dist/swpp/cli.js

@@ -0,0 +1,109 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = initCommand;
+const commander_1 = require("commander");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const index_1 = require("../index");
+const ConfigLoader_1 = require("./config/ConfigLoader");
+const ResourcesScanner_1 = require("./ResourcesScanner");
+const SwCompiler_1 = require("./SwCompiler");
+const untils_1 = require("./untils");
+const HTMLParser = __importStar(require("node-html-parser"));
+async function initCommand() {
+    commander_1.program.version(index_1.swppVersion, '-v, --version', '查看当前 swpp backends 的版本号');
+    commander_1.program.addHelpText('after', '  每行显示一条指令信息，指令后跟方括号表示可选参数，尖括号表示必填参数');
+    commander_1.program.option('-b, --build [config: string]', '构建网站的 sw 与版本文件');
+    commander_1.program.parse();
+    if (commander_1.program.opts().build) {
+        const build = commander_1.program.opts().build;
+        await runBuild(typeof build === 'string' ? build : undefined);
+    }
+}
+async function runBuild(cliJsonPath = './swpp.cli.json') {
+    if (!cliJsonPath.endsWith('.json')) {
+        throw new untils_1.RuntimeException(untils_1.exceptionNames.unsupportedFileType, 'CLI 配置文件仅支持 JSON 格式', { yourPath: cliJsonPath });
+    }
+    const cliConfig = JSON.parse(await untils_1.utils.readFileUtf8(cliJsonPath));
+    if (!cliConfig.webRoot || !fs_1.default.existsSync(cliConfig.webRoot) || !fs_1.default.statSync(cliConfig.webRoot).isDirectory()) {
+        throw new untils_1.RuntimeException(untils_1.exceptionNames.error, 'CLI 配置文件中缺少 webRoot 配置项或传入了一个非文件夹路径', { webRoot: cliConfig.webRoot });
+    }
+    if (cliConfig.domJsPath && (!cliConfig.domJsPath.startsWith('/') || !cliConfig.domJsPath.endsWith('.js'))) {
+        throw new untils_1.RuntimeException(untils_1.exceptionNames.invalidVarName, 'CLI 配置文件中的 domJsPath 应当传入一个 `/` 开头 `.js` 结尾的字符串');
+    }
+    if (!cliConfig.configFiles || cliConfig.configFiles.length === 0) {
+        throw new untils_1.RuntimeException(untils_1.exceptionNames.nullPoint, 'CLI 配置文件中缺少 configFiles 配置项或数组长度为 0', { configFiles: cliConfig.configFiles });
+    }
+    cliConfig.configFiles.forEach(path => {
+        if (!fs_1.default.existsSync(path)) {
+            throw new untils_1.RuntimeException(untils_1.exceptionNames.notFound, 'CLI 配置文件的 configFiles 配置项中某项目录不存在', { path });
+        }
+    });
+    // 加载配置项
+    const loader = new ConfigLoader_1.ConfigLoader();
+    for (let item of cliConfig.configFiles) {
+        const path = path_1.default.isAbsolute(item) ? item : path_1.default.resolve(item);
+        await loader.load(path);
+    }
+    const { runtime, compilation } = loader.generate();
+    // 扫描目录
+    const jsonInfo = compilation.compilationEnv.read('SWPP_JSON_FILE');
+    const scanner = new ResourcesScanner_1.ResourcesScanner(compilation);
+    const newTracker = await scanner.scanLocalFile(cliConfig.webRoot);
+    const updateJsonBuilder = await newTracker.diff();
+    const updateJson = await updateJsonBuilder.buildJson();
+    fs_1.default.mkdirSync(path_1.default.join(cliConfig.webRoot, jsonInfo.swppPath), { recursive: true });
+    // 生成各项文件
+    await Promise.all([
+        // 生成 json
+        untils_1.utils.writeFile(path_1.default.join(cliConfig.webRoot, jsonInfo.swppPath, jsonInfo.trackerPath), newTracker.json()),
+        untils_1.utils.writeFile(path_1.default.join(cliConfig.webRoot, jsonInfo.swppPath, jsonInfo.versionPath), JSON.stringify(updateJson)),
+        // 生成 sw js
+        untils_1.utils.writeFile(path_1.default.join(cliConfig.webRoot, compilation.compilationEnv.read('SERVICE_WORKER') + '.js'), new SwCompiler_1.SwCompiler().buildSwCode(runtime)),
+        // 生成 dom js
+        untils_1.utils.writeFile(path_1.default.join(cliConfig.webRoot, cliConfig.domJsPath ?? '/sw-dom.js'), runtime.domConfig.buildJsSource())
+    ]);
+    const regexes = cliConfig.excludes?.map?.(it => new RegExp(it)) ?? [];
+    const swRegistry = `<script>(${runtime.domConfig.read('registry')})()</script>`;
+    const domJsScript = `<script defer src="${cliConfig.domJsPath ?? '/sw-dom.js'}"></script>`;
+    // 修改 html
+    await (0, ResourcesScanner_1.traverseDirectory)(cliConfig.webRoot, async (file) => {
+        if (!file.endsWith('.html') || regexes.some(regex => regex.test(file)))
+            return;
+        const html = await readHtml(compilation, file);
+        const head = html.querySelector('head');
+        head.insertAdjacentHTML('afterbegin', swRegistry);
+        head.insertAdjacentHTML('beforeend', domJsScript);
+        await untils_1.utils.writeFile(file, html.outerHTML);
+    });
+}
+async function readHtml(compilation, path) {
+    const content = await compilation.compilationEnv.read('readLocalFile')(path);
+    return HTMLParser.parse(content);
+}