swpp-backends 3.0.0 → 3.1.0-beta2

package/README.md

@@ -4,55 +4,55 @@
 
 ## 什么是 swpp
 
-  swpp 是一个用于为网站快速生成一个高度可用的 [Service Worker](https://developer.mozilla.org/zh-CN/docs/Web/API/ServiceWorker) 的工具，旨在提高网站的可靠性、优化二次访问性能、提供离线浏览功能……
+swpp（Service Worker Plus Plus）是一个现代化的 Service Worker 生成工具，专注于为静态网站提供精准、高效的缓存控制和离线访问能力。
 
-  常用 SW 构建工具的对比：
+与传统的 Service Worker 工具相比，swpp 提供了更细粒度的控制能力和更灵活的配置选项，让开发者能够精确管理网站资源的缓存策略。
 
-|            | swpp@3 | swpp@2 | hexo-offline |
-|:----------:|:------:|:------:|:------------:|
-|    本地缓存    |   ✔️   |   ✔️   |      ✔️      |
-|   缓存增量更新   |   ✔️   |   ✔️   |      ❌       |
-|   缓存过期时间   |   ✔️   |   ❌    |      ✔️      |
-|   缓存大小限制   |   ❌    |   ❌    |      ✔️      |
-|    预缓存     |   ❌    |   ❌    |      ✔️      |
-| Request 篡改 |   ✔️   |   ✔️   |      ❌       |
-|   URL 竞速   |   ✔️   |   ✔️   |      ❌       |
-|   备用 URL   |   ✔️   |   ✔️   |      ❌       |
-|  204 阻塞响应  |   ✔️   |   ✔️   |      ❌       |
-|    逃生门     |   ✔️   |   ✔️   |      ❌       |
-|    请求合并    |   ❌    |   ✔️   |      ❌       |
-|    高度自由    |   ✔️   |   ✔️   |      ❌       |
-|     更新     |   活跃   |  停止维护  |   超过两年没有更新   |
+## 核心特性
 
-## swpp v2 与 v3 的区别
+### 精准缓存控制
+- **智能缓存规则匹配**：基于 URL 模式的精细化缓存策略配置
+- **缓存过期时间管理**：可为不同类型的资源设置独立的过期时间
+- **增量更新机制**：只更新发生变化的资源，避免全量刷新
 
-  swpp v3 对 swpp 的所有代码进行了完全的重构，现在代码逻辑更加的清晰。除了后台代码的差异，v3 还有以下一系列的改进：
+### 性能优化
+- **URL 竞速加载**：同时请求多个 CDN 源，使用最快响应的资源
+- **备用 URL 机制**：主资源加载失败时自动切换到备用地址
 
-- 完全定制化<br/>
-  现在您对 swpp 生成的 sw 拥有完全的控制权。在 v2 中，如果需要修改插件生成的 sw 的逻辑，您需要自行编写整个 sw 文件。<br/>
-  v3 中将 sw 文件的各个部分拆分到了环境变量中，这使得您可以通过配置文件覆盖 sw 文件中的任意一个部分，或者追加任意内容。
+### 高度可定制
+- **模块化配置**：将 Service Worker 功能拆分为独立的配置模块
+- **TypeScript 支持**：完整的类型定义，提供更好的开发体验
+- **全面开放**：允许用户修改生成的 Service Worker 文件中任意一处代码
 
-- 现代化配置<br/>
-  现在您可以使用 `ts` 语言编写配置文件，同时还可以选择使用 `ESM`。在 v2 中您必须使用 `CommonJS`。<br/>
-  同时使用内置的一系列 `define` 函数可以让您对配置的颗粒度进行更加完美的掌控。
+## swpp 与 hexo-offline 对比
 
-- 完善的类型<br/>
-  现在 swpp 提供了更加优雅的数据类型，以优化编写配置项、二次开发时的体验。
+> hexo-offline 是基于 Workbox 构建的 Hexo 插件，采用预缓存（precaching）的工作方式，与 swpp 的设计理念存在本质区别：
+> 
+> swpp 设计目标是在提供一系列内置的常用操作的前提下，尽可能地允许用户自定义 Service Worker 的行为，离线访问只是缓存控制产生的“副作用”；
+> hexo-offline 的设计目标是实现网站的离线访问。
 
-## 版本号
+| 特性       | swpp                 | hexo-offline      |
+|----------|----------------------|-------------------|
+| **核心技术** | 自研 Service Worker 框架 | 基于 Google Workbox |
+| **配置方式** | 可编程配置，支持 TypeScript  | JSON/CJS 配置文件     |
+| **缓存策略** | 细粒度 URL 规则匹配         | 文件扩展名模式匹配         |
+| **更新机制** | 智能增量更新               | 全量预缓存更新           |
+| **性能特性** | URL 竞速、备用地址          | 基础缓存策略            |
+| **定制能力** | 高度可定制，完全控制           | 零配置开箱即用           |
+| **适用场景** | 复杂网站、高性能要求           | 简单博客、快速部署         |
 
-&emsp;&emsp;目前 swpp v3 还在测试阶段，版本号全部采用 `3.0.0-alpha.<a><b><c>` 的格式：
+### 选择建议
 
-- `3.0.0` - 大版本号
-- `alpha` - 测试版本
-- `a` - 一级子版本号，变动时表明 API 或配置文件等内容发生了不向前兼容的变动
-- `b` - 二级子版本号，变动时表明添加了新的功能
-- `c` - 三级子版本号，变动时表明进行了漏洞修复
+如果你：
 
-&emsp;&emsp;当 `a` `b` `c` 的某一位达到两位数时，会在其中添加 `x` 表示分割。
+- 希望对动态资源（如 API 响应、用户内容）的缓存进行精细策略控制；
+- 重视代码的透明度和可审计性，希望完全理解底层逻辑；
+- 享受深入技术细节、亲手构建网络层控制逻辑的过程；
+- 在个人项目或技术实验中探索 Service Worker 的潜力
 
-## QQ 群
+那么 swpp 是一个非常值得一试的选择。
 
-&emsp;&emsp;注意：swpp 有且仅有下面的群是官方的：
+## 社区支持
 
-![QQ 群：545028909](/qrcode.jpg)
+- **GitHub Issues**：报告问题和功能请求
+- **QQ 群**：545028909（官方技术支持群）

package/dist/index.d.ts

@@ -5,7 +5,6 @@ export { utils, RuntimeException } from './swpp/untils';
 export { ResourcesScanner, FileUpdateTracker, } from './swpp/ResourcesScanner';
 export { JsonBuilder, UpdateJson, UpdateChangeExp, TrackerHeaderDiff } from './swpp/JsonBuilder';
 export { SwCompiler, CompilationData, RuntimeData, BrowserVersion } from './swpp/SwCompiler';
-export { NetworkFileHandler, FiniteConcurrencyFetcher } from './swpp/NetworkFileHandler';
 export { KeyValueDatabase, readThisValue } from './swpp/database/KeyValueDatabase';
 export { RuntimeKeyValueDatabase } from './swpp/database/RuntimeKeyValueDatabase';
 export { RuntimeEventCode } from './swpp/database/RuntimeEventCode';

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 // noinspection JSUnusedGlobalSymbols
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineLazyInitConfig = exports.defineNoCacheConfig = exports.defineContextConfig = exports.defineIndivisibleConfig = exports.NoCacheConfig = exports.IndivisibleConfig = exports.SpecialConfig = exports.defineModifier = exports.defineCompilationFP = exports.defineCompilationEnv = exports.defineCrossEnv = exports.defineRuntimeDep = exports.defineCrossDep = exports.defineRuntimeCore = exports.defineDomConfig = exports.defineRuntimeEvent = exports.defineConfig = exports.ConfigLoader = exports.DomCode = exports.AllowNotFoundEnum = exports.CompilationEnv = exports.CrossDepCode = exports.CrossEnv = exports.RuntimeDepCode = exports.RuntimeCoreCode = exports.RuntimeEventCode = exports.RuntimeKeyValueDatabase = exports.readThisValue = exports.KeyValueDatabase = exports.FiniteConcurrencyFetcher = exports.RuntimeData = exports.CompilationData = exports.SwCompiler = exports.JsonBuilder = exports.FileUpdateTracker = exports.ResourcesScanner = exports.RuntimeException = exports.utils = exports.BasicActions = exports.swppVersion = void 0;
+exports.defineLazyInitConfig = exports.defineNoCacheConfig = exports.defineContextConfig = exports.defineIndivisibleConfig = exports.NoCacheConfig = exports.IndivisibleConfig = exports.SpecialConfig = exports.defineModifier = exports.defineCompilationFP = exports.defineCompilationEnv = exports.defineCrossEnv = exports.defineRuntimeDep = exports.defineCrossDep = exports.defineRuntimeCore = exports.defineDomConfig = exports.defineRuntimeEvent = exports.defineConfig = exports.ConfigLoader = exports.DomCode = exports.AllowNotFoundEnum = exports.CompilationEnv = exports.CrossDepCode = exports.CrossEnv = exports.RuntimeDepCode = exports.RuntimeCoreCode = exports.RuntimeEventCode = exports.RuntimeKeyValueDatabase = exports.readThisValue = exports.KeyValueDatabase = exports.RuntimeData = exports.CompilationData = exports.SwCompiler = exports.JsonBuilder = exports.FileUpdateTracker = exports.ResourcesScanner = exports.RuntimeException = exports.utils = exports.BasicActions = exports.swppVersion = void 0;
 /** 版本号 */
 exports.swppVersion = require('../package.json').version;
 var BasicActions_1 = require("./swpp/BasicActions");
@@ -18,8 +18,6 @@ var SwCompiler_1 = require("./swpp/SwCompiler");
 Object.defineProperty(exports, "SwCompiler", { enumerable: true, get: function () { return SwCompiler_1.SwCompiler; } });
 Object.defineProperty(exports, "CompilationData", { enumerable: true, get: function () { return SwCompiler_1.CompilationData; } });
 Object.defineProperty(exports, "RuntimeData", { enumerable: true, get: function () { return SwCompiler_1.RuntimeData; } });
-var NetworkFileHandler_1 = require("./swpp/NetworkFileHandler");
-Object.defineProperty(exports, "FiniteConcurrencyFetcher", { enumerable: true, get: function () { return NetworkFileHandler_1.FiniteConcurrencyFetcher; } });
 var KeyValueDatabase_1 = require("./swpp/database/KeyValueDatabase");
 Object.defineProperty(exports, "KeyValueDatabase", { enumerable: true, get: function () { return KeyValueDatabase_1.KeyValueDatabase; } });
 Object.defineProperty(exports, "readThisValue", { enumerable: true, get: function () { return KeyValueDatabase_1.readThisValue; } });

package/dist/swpp/FilePath.d.ts

@@ -1,4 +1,3 @@
-import { CompilationData } from './SwCompiler';
 export declare class FilePath {
     readonly absPath: string;
     readonly baseProject: string | null;
@@ -27,10 +26,6 @@ export declare class FilePath {
      * 检查路径是否指向一个目录
      */
     isDirectory(): Promise<boolean>;
-    /**
-     * 检查路径是否指向一个文件
-     */
-    isFile(): Promise<boolean>;
     /**
      * 将指定目录拼接到当前路径之后
      */
@@ -60,12 +55,6 @@ export declare class FilePath {
     mkdirs(): Promise<void>;
     /** 空目录 */
     static EMPTY: FilePath;
-    /**
-     * 从绝对路径获取 FilePath
-     * @param absPath 绝对路径
-     * @param compilation 编译期数据
-     */
-    static fromAbsPath(absPath: string, compilation: CompilationData): FilePath;
     /**
      * 构建网站根目录的 FilePath
      * @param path 绝对路径或相对路径（相对于项目根目录），以 `/` 开头或 `x:/` 开头判定为绝对路径

package/dist/swpp/FilePath.js

@@ -48,14 +48,6 @@ class FilePath {
             this.statCache = await fs_1.default.promises.stat(this.absPath);
         return this.statCache.isDirectory();
     }
-    /**
-     * 检查路径是否指向一个文件
-     */
-    async isFile() {
-        if (!this.statCache)
-            this.statCache = await fs_1.default.promises.stat(this.absPath);
-        return this.statCache.isFile();
-    }
     /**
      * 将指定目录拼接到当前路径之后
      */
@@ -130,25 +122,6 @@ class FilePath {
             await fs_1.default.promises.mkdir(parent.absPath, { recursive: true });
         }
     }
-    /**
-     * 从绝对路径获取 FilePath
-     * @param absPath 绝对路径
-     * @param compilation 编译期数据
-     */
-    static fromAbsPath(absPath, compilation) {
-        absPath = path_1.default.posix.normalize(absPath);
-        const projectRoot = compilation.compilationEnv.read('PROJECT_PATH');
-        const publicRoot = compilation.compilationEnv.read('PUBLIC_PATH');
-        if (projectRoot.absPath.startsWith(absPath)) {
-            return projectRoot.join(absPath.substring(projectRoot.absPath.length));
-        }
-        else if (publicRoot.absPath.startsWith(absPath)) {
-            return publicRoot.join(absPath.substring(publicRoot.absPath.length));
-        }
-        else {
-            return new FilePath(absPath, null, null);
-        }
-    }
     /**
      * 构建网站根目录的 FilePath
      * @param path 绝对路径或相对路径（相对于项目根目录），以 `/` 开头或 `x:/` 开头判定为绝对路径

package/dist/swpp/ResourcesScanner.d.ts

@@ -10,8 +10,6 @@ export declare class ResourcesScanner {
     constructor(compilation: CompilationData, oldTracker?: FileUpdateTracker | undefined);
     /** 扫描指定目录下的所有文件 */
     scanLocalFile(path: FilePath): Promise<FileUpdateTracker>;
-    /** 扫描网络文件 */
-    private scanNetworkFile;
 }
 /**
  * 文件更新监听器
@@ -26,11 +24,6 @@ export declare class FileUpdateTracker {
     constructor(compilation: CompilationData, oldTracker?: FileUpdateTracker | undefined);
     /** 更新一个文件的标识符 */
     update(uri: string, value: string | Set<string> | string[]): void;
-    /**
-     * 同步指定的稳定资源（同步时会连同同步其连接的稳定资源）
-     * @return 直接或间接连接的一些需要扫描的资源
-     */
-    syncStable(uri: URL, value: string[], oldTracker: FileUpdateTracker): string[];
     /** 读取一个文件的标识符 */
     get(uri: string): string | string[] | undefined;
     /** 归一化 uri */

package/dist/swpp/ResourcesScanner.js

@@ -79,46 +79,8 @@ class ResourcesScanner {
             }, isCached);
             set.forEach(it => urls.add(it));
         });
-        await this.scanNetworkFile(tracker, urls);
         return tracker;
     }
-    /** 扫描网络文件 */
-    async scanNetworkFile(tracker, urls, record = new Set()) {
-        const matchCacheRule = this.compilation.crossDep.read('matchCacheRule');
-        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;
-        for (let url of urls) {
-            const normalizeUri = tracker.normalizeUri(url);
-            if (record.has(normalizeUri.href))
-                continue;
-            record.add(normalizeUri.href);
-            const isCached = matchCacheRule.runOnNode(normalizeUri);
-            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 => {
-                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));
-        }
-        await Promise.all(taskList);
-        if (appendedUrls.size !== 0)
-            await this.scanNetworkFile(tracker, appendedUrls, record);
-    }
 }
 exports.ResourcesScanner = ResourcesScanner;
 /**
@@ -148,30 +110,6 @@ class FileUpdateTracker {
             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) {
         const value = this.map.get(this.normalizeUri(uri).href);
@@ -287,7 +225,7 @@ class FileUpdateTracker {
         let error;
         const result = await (async () => {
             try {
-                const response = await fetcher.fetch(url);
+                const response = await fetcher(url);
                 if (isNotFound.response(response)) {
                     if (notFoundLevel == CompilationEnv_1.AllowNotFoundEnum.REJECT_ALL) {
                         error = new untils_1.RuntimeException(untils_1.exceptionNames.notFound, `拉取 ${url} 时出现 404 错误`);

package/dist/swpp/database/CompilationEnv.d.ts

@@ -1,6 +1,5 @@
 import { FilePath } from '../FilePath';
 import { UpdateJson } from '../JsonBuilder';
-import { FiniteConcurrencyFetcher } from '../NetworkFileHandler';
 import { FileUpdateTracker } from '../ResourcesScanner';
 import { CompilationData } from '../SwCompiler';
 import { KeyValueDatabase } from './KeyValueDatabase';
@@ -62,7 +61,7 @@ declare function buildCommon(): {
     /**
      * 拉取网络文件
      */
-    readonly NETWORK_FILE_FETCHER: import("./KeyValueDatabase").DatabaseValue<FiniteConcurrencyFetcher>;
+    readonly NETWORK_FILE_FETCHER: import("./KeyValueDatabase").DatabaseValue<(url: string | URL) => Promise<Response>>;
     /**
      * 判断文件是否是 404
      */
@@ -74,9 +73,5 @@ declare function buildCommon(): {
      * 是否允许 404
      */
     readonly ALLOW_NOT_FOUND: import("./KeyValueDatabase").DatabaseValue<AllowNotFoundEnum>;
-    /**
-     * 检查一个链接是否是稳定的（也就是 URL 不变其返回的结果永远不变）
-     */
-    readonly isStable: import("./KeyValueDatabase").DatabaseValue<(_url: URL) => boolean>;
 };
 export {};

package/dist/swpp/database/CompilationEnv.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AllowNotFoundEnum = exports.CompilationEnv = void 0;
 const FilePath_1 = require("../FilePath");
-const NetworkFileHandler_1 = require("../NetworkFileHandler");
 const ResourcesScanner_1 = require("../ResourcesScanner");
 const untils_1 = require("../untils");
 const KeyValueDatabase_1 = require("./KeyValueDatabase");
@@ -117,7 +116,7 @@ function buildCommon() {
                     try {
                         const swppPath = (0, KeyValueDatabase_1.readThisValue)(this, 'swppPath');
                         const versionPath = (0, KeyValueDatabase_1.readThisValue)(this, 'versionPath');
-                        const response = await fetcher.fetch(untils_1.utils.splicingUrl(baseUrl, swppPath, versionPath));
+                        const response = await fetcher(untils_1.utils.splicingUrl(baseUrl, swppPath, versionPath));
                         if (!isNotFound.response(response)) {
                             if (isFetchSuccessful(response)) {
                                 const json = await response.json().catch(err => {
@@ -159,7 +158,7 @@ function buildCommon() {
          * 拉取网络文件
          */
         NETWORK_FILE_FETCHER: (0, KeyValueDatabase_1.buildEnv)({
-            default: new NetworkFileHandler_1.FiniteConcurrencyFetcher()
+            default: (url) => fetch(url)
         }),
         /**
          * 判断文件是否是 404
@@ -186,11 +185,5 @@ function buildCommon() {
                 }
             }
         }),
-        /**
-         * 检查一个链接是否是稳定的（也就是 URL 不变其返回的结果永远不变）
-         */
-        isStable: (0, KeyValueDatabase_1.buildEnv)({
-            default: (_url) => false
-        })
     };
 }

package/dist/swpp/database/CompilationFileParser.d.ts

@@ -7,14 +7,6 @@ export declare class CompilationFileParser extends KeyValueDatabase<FileParser<c
     constructor();
     /** 解析本地文件 */
     parserLocalFile(path: FilePath, cb?: (content: crypto.BinaryLike) => void, force?: boolean): Promise<Set<string>>;
-    /** 解析网络文件 */
-    parserNetworkFile(response: Response, callback?: (content: crypto.BinaryLike) => Promise<void> | void): Promise<Set<string>>;
-    /**
-     * 解析指定的 URL
-     * @param url 链接
-     * @param isCached 该链接指向的资源是否需要缓存
-     */
-    parserUrlFile(url: string, isCached: boolean): Promise<FileMark>;
     /**
      * 解析指定类型的文件内容
      * @param type 文件类型

package/dist/swpp/database/CompilationFileParser.js

@@ -60,69 +60,6 @@ class CompilationFileParser extends KeyValueDatabase_1.KeyValueDatabase {
             return new Set();
         }
     }
-    /** 解析网络文件 */
-    async parserNetworkFile(response, callback) {
-        const url = response.url;
-        const fileHandler = this.compilation.compilationEnv.read('NETWORK_FILE_FETCHER');
-        const contentType = fileHandler.getUrlContentType(url, response);
-        if (this.hasKey(contentType)) {
-            const parser = this.read(contentType);
-            const content = await parser.readFromNetwork(this.compilation, response);
-            if (callback)
-                await callback(content);
-            return await parser.extractUrls(this.compilation, content, new URL(url));
-        }
-        else {
-            if (callback) {
-                const buffer = await response.arrayBuffer();
-                const array = new Uint8Array(buffer);
-                callback(array);
-            }
-            return new Set();
-        }
-    }
-    /**
-     * 解析指定的 URL
-     * @param url 链接
-     * @param isCached 该链接指向的资源是否需要缓存
-     */
-    async parserUrlFile(url, isCached) {
-        const fileHandler = this.compilation.compilationEnv.read('NETWORK_FILE_FETCHER');
-        const contentType = fileHandler.getUrlContentType(url);
-        if (!contentType && !isCached)
-            return { file: url, mark: '', urls: new Set() };
-        const parser = this.hasKey(contentType) ? this.read(contentType) : undefined;
-        if (!parser && !isCached)
-            return { file: url, mark: '', urls: new Set() };
-        if (parser?.calcUrl) {
-            const result = await parser.calcUrl(url);
-            if (result)
-                return {
-                    file: url,
-                    ...result
-                };
-        }
-        const fetcher = this.compilation.compilationEnv.read('NETWORK_FILE_FETCHER');
-        const urls = new Set();
-        let mark = '';
-        await fetcher.fetch(url)
-            .then(response => this.parserNetworkFile(response, isCached ? content => {
-            mark = untils_1.utils.calcHash(content);
-        } : undefined))
-            .then(urls => urls.forEach(it => urls.add(it)))
-            .catch(err => new Response(JSON.stringify({
-            type: err.type,
-            message: err.message,
-            stack: err.stack,
-            addition: err
-        }), {
-            status: 599,
-            headers: {
-                'Content-Type': 'application/json'
-            }
-        }));
-        return { file: url, mark, urls };
-    }
     /**
      * 解析指定类型的文件内容
      * @param type 文件类型

package/dist/swpp/database/CrossEnv.d.ts

@@ -9,6 +9,8 @@ export declare class CrossEnv extends RuntimeKeyValueDatabase<any, COMMON_TYPE_C
 declare function buildCommon(): {
     /** 缓存库名称 */
     readonly CACHE_NAME: import("./KeyValueDatabase").DatabaseValue<string>;
+    /** 网站的基准域名 */
+    readonly BASE_URL: import("./KeyValueDatabase").DatabaseValue<string>;
     /** 永久缓存标记 */
     readonly INFINITE_CACHE: import("./KeyValueDatabase").DatabaseValue<symbol>;
     /** 存储版本号的 URL */

package/dist/swpp/database/CrossEnv.js

@@ -32,6 +32,18 @@ function buildCommon() {
     return {
         /** 缓存库名称 */
         CACHE_NAME: (0, KeyValueDatabase_1.buildEnv)({ default: 'kmarBlogCache' }),
+        /** 网站的基准域名 */
+        BASE_URL: (0, KeyValueDatabase_1.buildEnv)({
+            default: (0, ConfigCluster_1.defineLazyInitConfig)((_, compilation) => {
+                const url = compilation.compilationEnv.read('DOMAIN_HOST');
+                return url.href;
+            }),
+            checker(value) {
+                if (this.manual)
+                    return { value, message: '不应当手动设置该项！' };
+                return false;
+            },
+        }),
         /** 永久缓存标记 */
         INFINITE_CACHE: (0, KeyValueDatabase_1.buildEnv)({
             default: Symbol(),

package/dist/swpp/database/RuntimeDepCode.js

@@ -84,8 +84,14 @@ function buildCommon() {
                 const headers = response.headers;
                 if (headers.has(INVALID_KEY))
                     return false;
-                if (rule === INFINITE_CACHE)
-                    return true;
+                // 只有本站资源允许永久缓存
+                if (rule === INFINITE_CACHE) {
+                    const url = response.url;
+                    const baseLength = BASE_URL.length;
+                    if (url.startsWith(BASE_URL) && (url.length === baseLength || url[baseLength] === '/')) {
+                        return true;
+                    }
+                }
                 const storage = headers.get(STORAGE_TIMESTAMP);
                 if (!storage)
                     return true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swpp-backends",
-  "version": "3.0.0",
+  "version": "3.1.0-beta2",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
   "description": "Generate a powerful ServiceWorker for your website.",