@isdk/proxy 0.1.1 → 0.1.3

package/docs/interfaces/CacheRule.md

@@ -0,0 +1,80 @@
+[**@isdk/proxy**](../README.md)
+
+***
+
+[@isdk/proxy](../globals.md) / CacheRule
+
+# Interface: CacheRule
+
+Defined in: [packages/proxy/src/types.ts:35](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L35)
+
+精细化缓存匹配规则
+
+用于在 `methods` 过滤的基础上，进一步限定哪些具体的请求路径或参数需要被缓存。
+多个规则之间是 **OR (逻辑或)** 关系，即请求只需匹配其中一条规则即可。
+在单个规则对象内部，各字段之间是 **AND (逻辑与)** 关系。
+
+## Properties
+
+### body?
+
+> `optional` **body**: `string` \| `RegExp` \| (`string` \| `RegExp`)[]
+
+Defined in: [packages/proxy/src/types.ts:75](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L75)
+
+Body 内容匹配。
+仅当 Body 为文本或 JSON 时有效。
+- 字符串: 支持 Glob 模式匹配。
+- 正则表达式: 检查 Body 内容是否匹配。
+- 数组: 支持传入多个模式。
+
+***
+
+### bodyType?
+
+> `optional` **bodyType**: `"json"` \| `"text"` \| `"binary"`
+
+Defined in: [packages/proxy/src/types.ts:67](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L67)
+
+强制指定 Body 类型。
+如果不指定，则根据 `Content-Type` 自动判断。
+
+***
+
+### method?
+
+> `optional` **method**: `string`
+
+Defined in: [packages/proxy/src/types.ts:40](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L40)
+
+匹配的方法 (如 "POST")。
+如果指定，则必须方法完全一致；如果不指定，则匹配所有 `methods` 中允许的方法。
+
+***
+
+### path?
+
+> `optional` **path**: `string` \| `RegExp` \| (`string` \| `RegExp`)[]
+
+Defined in: [packages/proxy/src/types.ts:52](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L52)
+
+路径匹配。
+- 字符串: 默认进行 Glob 模式匹配（支持 `!` 否定），若非 Glob 且非正则字符串则退化为前缀匹配。
+- 正则表达式: 检查 `url.pathname` 是否匹配。
+- 数组: 支持传入多个模式（含否定模式），只要其中一个匹配即可。
+
+***
+
+### query?
+
+> `optional` **query**: `Record`\<`string`, `string` \| `boolean` \| `RegExp`\>
+
+Defined in: [packages/proxy/src/types.ts:62](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L62)
+
+Query 参数匹配规则。
+- 键名: 支持字符串、Glob 或正则。
+- 值:
+  - 字符串: 支持 Glob 模式匹配。
+  - 正则表达式: 检查参数值是否匹配。
+  - `true`: 要求该参数必须存在于 URL 中。
+  - `false`: 要求该参数必须 **不** 存在于 URL 中。

package/docs/interfaces/FetchWithCacheContext.md

@@ -6,9 +6,9 @@
 
 # Interface: FetchWithCacheContext
 
-Defined in: [core/fetchWithCache.ts:31](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L31)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:31](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L31)
 
-内部流水线上下文，合并了入参和计算出的关键状态
+内部流水线上下文
 
 ## Extends
 
@@ -20,11 +20,9 @@ Defined in: [core/fetchWithCache.ts:31](https://github.com/isdk/proxy.js/blob/be
 
 > **activeCacheWrites**: `Map`\<`string`, `Promise`\<`void`\>\>
 
-Defined in: [core/fetchWithCache.ts:35](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L35)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:35](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L35)
 
 并发写入任务追踪器
-传入一个外部维护的 Map，用于在跨请求、跨实例时防止针对同一文件的并发重复下载。
-Map 的 Key 是缓存 Key，Value 是一个代表写入完成的 Promise。
 
 #### Overrides
 
@@ -36,7 +34,7 @@ Map 的 Key 是缓存 Key，Value 是一个代表写入完成的 Promise。
 
 > `optional` **backgroundUpdate**: `boolean`
 
-Defined in: [core/fetchWithCache.ts:17](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L17)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:19](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L19)
 
 是否启用后台异步更新 (SWR)
 
@@ -50,7 +48,7 @@ Defined in: [core/fetchWithCache.ts:17](https://github.com/isdk/proxy.js/blob/be
 
 > **cache**: [`SmartCache`](../classes/SmartCache.md)
 
-Defined in: [core/fetchWithCache.ts:13](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L13)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:15](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L15)
 
 混合缓存实例
 
@@ -64,7 +62,7 @@ Defined in: [core/fetchWithCache.ts:13](https://github.com/isdk/proxy.js/blob/be
 
 > **cacheKey**: `string`
 
-Defined in: [core/fetchWithCache.ts:34](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L34)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:34](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L34)
 
 ***
 
@@ -72,7 +70,7 @@ Defined in: [core/fetchWithCache.ts:34](https://github.com/isdk/proxy.js/blob/be
 
 > **config**: [`SiteCacheConfig`](SiteCacheConfig.md)
 
-Defined in: [core/fetchWithCache.ts:15](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L15)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:17](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L17)
 
 站点级缓存配置
 
@@ -86,7 +84,7 @@ Defined in: [core/fetchWithCache.ts:15](https://github.com/isdk/proxy.js/blob/be
 
 > **fetcher**: (`req`) => `Promise`\<`Response`\>
 
-Defined in: [core/fetchWithCache.ts:33](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L33)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:33](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L33)
 
 #### Parameters
 
@@ -102,13 +100,28 @@ Defined in: [core/fetchWithCache.ts:33](https://github.com/isdk/proxy.js/blob/be
 
 ### generateKey()?
 
-> `optional` **generateKey**: (`req`, `config`) => `string`
+> `optional` **generateKey**: (`req`, `config`) => `Promise`\<`string`\>
 
-Defined in: [core/fetchWithCache.ts:21](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L21)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:23](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L23)
 
 自定义缓存键生成函数
 
-根据 Request 和配置生成唯一的缓存键
+根据 Request 对象和站点配置生成唯一的缓存指纹 (异步)
+
+该函数是缓存系统的核心组件，用于将复杂的 HTTP 请求对象转换为唯一的 SHA-256 字符串。
+它实现了高度可定制的提取逻辑，允许通过配置排除掉请求中不稳定的因素（如时间戳、Nonce 等）。
+
+### 生成指纹包含的要素：
+1. **Method**: 请求方法（统一转为大写）。
+2. **Host & Path**: 请求的域名和路径。
+3. **Query Params**: URL 查询参数，受 `config.query` 过滤影响。
+4. **Headers**: 请求头信息，受 `config.headers` 过滤影响。默认排除 `cookie` 头。
+5. **Cookies**: 特别提取的 Cookie 字段，受 `config.cookies` 过滤影响。
+6. **Request Body**:
+   - 对于 `POST`, `PUT`, `PATCH` 请求，会自动尝试读取 Body。
+   - **JSON 类型**: 如果 `Content-Type` 包含 `application/json`，则解析为对象并应用 `config.body` 过滤。
+   - **非 JSON/流类型**: 回退到对原始 Body 字节流进行 SHA-256 哈希计算。
+   - **安全性**: 使用 `req.clone()` 读取 Body，确保不影响后续真实的 Fetch 请求流消费。
 
 #### Parameters
 
@@ -116,13 +129,28 @@ Defined in: [core/fetchWithCache.ts:21](https://github.com/isdk/proxy.js/blob/be
 
 `Request`
 
+原始 Web 标准 Request 对象。
+
 ##### config
 
 [`SiteCacheConfig`](SiteCacheConfig.md)
 
+站点级缓存配置，决定了哪些字段参与指纹计算。
+
 #### Returns
 
-`string`
+`Promise`\<`string`\>
+
+返回一个 64 位十六进制的 SHA-256 哈希字符串作为缓存键。
+
+#### Example
+
+```typescript
+const cacheKey = await generateCacheKey(request, {
+  query: { exclude: ['timestamp'] },
+  body: { include: ['id', 'action'] }
+});
+```
 
 #### Inherited from
 
@@ -134,7 +162,7 @@ Defined in: [core/fetchWithCache.ts:21](https://github.com/isdk/proxy.js/blob/be
 
 > `optional` **onBackgroundUpdate**: (`promise`) => `void`
 
-Defined in: [core/fetchWithCache.ts:19](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L19)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:21](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L21)
 
 后台更新 Promise 触发时的回调
 
@@ -158,4 +186,4 @@ Defined in: [core/fetchWithCache.ts:19](https://github.com/isdk/proxy.js/blob/be
 
 > **request**: `Request`
 
-Defined in: [core/fetchWithCache.ts:32](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L32)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:32](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L32)

package/docs/interfaces/FetchWithCacheOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: FetchWithCacheOptions
 
-Defined in: [core/fetchWithCache.ts:11](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L11)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:13](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L13)
 
 fetchWithCache 选项
 
@@ -20,11 +20,9 @@ fetchWithCache 选项
 
 > `optional` **activeCacheWrites**: `Map`\<`string`, `Promise`\<`void`\>\>
 
-Defined in: [core/fetchWithCache.ts:27](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L27)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:27](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L27)
 
 并发写入任务追踪器
-传入一个外部维护的 Map，用于在跨请求、跨实例时防止针对同一文件的并发重复下载。
-Map 的 Key 是缓存 Key，Value 是一个代表写入完成的 Promise。
 
 ***
 
@@ -32,7 +30,7 @@ Map 的 Key 是缓存 Key，Value 是一个代表写入完成的 Promise。
 
 > `optional` **backgroundUpdate**: `boolean`
 
-Defined in: [core/fetchWithCache.ts:17](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L17)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:19](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L19)
 
 是否启用后台异步更新 (SWR)
 
@@ -42,7 +40,7 @@ Defined in: [core/fetchWithCache.ts:17](https://github.com/isdk/proxy.js/blob/be
 
 > **cache**: [`SmartCache`](../classes/SmartCache.md)
 
-Defined in: [core/fetchWithCache.ts:13](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L13)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:15](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L15)
 
 混合缓存实例
 
@@ -52,7 +50,7 @@ Defined in: [core/fetchWithCache.ts:13](https://github.com/isdk/proxy.js/blob/be
 
 > **config**: [`SiteCacheConfig`](SiteCacheConfig.md)
 
-Defined in: [core/fetchWithCache.ts:15](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L15)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:17](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L17)
 
 站点级缓存配置
 
@@ -60,13 +58,28 @@ Defined in: [core/fetchWithCache.ts:15](https://github.com/isdk/proxy.js/blob/be
 
 ### generateKey()?
 
-> `optional` **generateKey**: (`req`, `config`) => `string`
+> `optional` **generateKey**: (`req`, `config`) => `Promise`\<`string`\>
 
-Defined in: [core/fetchWithCache.ts:21](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L21)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:23](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L23)
 
 自定义缓存键生成函数
 
-根据 Request 和配置生成唯一的缓存键
+根据 Request 对象和站点配置生成唯一的缓存指纹 (异步)
+
+该函数是缓存系统的核心组件，用于将复杂的 HTTP 请求对象转换为唯一的 SHA-256 字符串。
+它实现了高度可定制的提取逻辑，允许通过配置排除掉请求中不稳定的因素（如时间戳、Nonce 等）。
+
+### 生成指纹包含的要素：
+1. **Method**: 请求方法（统一转为大写）。
+2. **Host & Path**: 请求的域名和路径。
+3. **Query Params**: URL 查询参数，受 `config.query` 过滤影响。
+4. **Headers**: 请求头信息，受 `config.headers` 过滤影响。默认排除 `cookie` 头。
+5. **Cookies**: 特别提取的 Cookie 字段，受 `config.cookies` 过滤影响。
+6. **Request Body**:
+   - 对于 `POST`, `PUT`, `PATCH` 请求，会自动尝试读取 Body。
+   - **JSON 类型**: 如果 `Content-Type` 包含 `application/json`，则解析为对象并应用 `config.body` 过滤。
+   - **非 JSON/流类型**: 回退到对原始 Body 字节流进行 SHA-256 哈希计算。
+   - **安全性**: 使用 `req.clone()` 读取 Body，确保不影响后续真实的 Fetch 请求流消费。
 
 #### Parameters
 
@@ -74,13 +87,28 @@ Defined in: [core/fetchWithCache.ts:21](https://github.com/isdk/proxy.js/blob/be
 
 `Request`
 
+原始 Web 标准 Request 对象。
+
 ##### config
 
 [`SiteCacheConfig`](SiteCacheConfig.md)
 
+站点级缓存配置，决定了哪些字段参与指纹计算。
+
 #### Returns
 
-`string`
+`Promise`\<`string`\>
+
+返回一个 64 位十六进制的 SHA-256 哈希字符串作为缓存键。
+
+#### Example
+
+```typescript
+const cacheKey = await generateCacheKey(request, {
+  query: { exclude: ['timestamp'] },
+  body: { include: ['id', 'action'] }
+});
+```
 
 ***
 
@@ -88,7 +116,7 @@ Defined in: [core/fetchWithCache.ts:21](https://github.com/isdk/proxy.js/blob/be
 
 > `optional` **onBackgroundUpdate**: (`promise`) => `void`
 
-Defined in: [core/fetchWithCache.ts:19](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L19)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:21](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L21)
 
 后台更新 Promise 触发时的回调
 

package/docs/interfaces/KeyFilterConfig.md

@@ -6,28 +6,32 @@
 
 # Interface: KeyFilterConfig
 
-Defined in: [types.ts:6](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L6)
+Defined in: [packages/proxy/src/types.ts:6](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L6)
 
 缓存键过滤配置
 
 用于定义在生成缓存指纹时，哪些字段应该被包含或排除。
 
+## Extended by
+
+- [`BodyFilterConfig`](BodyFilterConfig.md)
+
 ## Properties
 
 ### exclude?
 
-> `optional` **exclude**: `string`[]
+> `optional` **exclude**: (`string` \| `RegExp`)[]
 
-Defined in: [types.ts:10](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L10)
+Defined in: [packages/proxy/src/types.ts:10](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L10)
 
-排除（黑名单）：用于排除像 `timestamp`、`nonce` 等干扰缓存命中的动态字段
+排除（黑名单）：用于排除像 `timestamp`、`nonce` 等干扰缓存命中的动态字段。支持字符串、Glob 模式或正则表达式。
 
 ***
 
 ### include?
 
-> `optional` **include**: `string`[]
+> `optional` **include**: (`string` \| `RegExp`)[]
 
-Defined in: [types.ts:8](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L8)
+Defined in: [packages/proxy/src/types.ts:8](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L8)
 
-仅包含（白名单）：如果设置，只有这些字段会参与 Key 的计算
+仅包含（白名单）：如果设置，只有这些字段会参与 Key 的计算。支持字符串、Glob 模式或正则表达式。

package/docs/interfaces/PrefetchOptions.md

@@ -0,0 +1,107 @@
+[**@isdk/proxy**](../README.md)
+
+***
+
+[@isdk/proxy](../globals.md) / PrefetchOptions
+
+# Interface: PrefetchOptions
+
+Defined in: [packages/proxy/src/core/prefetch.ts:17](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L17)
+
+## Properties
+
+### cache
+
+> **cache**: [`SmartCache`](../classes/SmartCache.md)
+
+Defined in: [packages/proxy/src/core/prefetch.ts:23](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L23)
+
+SmartCache 实例
+
+***
+
+### concurrency?
+
+> `optional` **concurrency**: `number`
+
+Defined in: [packages/proxy/src/core/prefetch.ts:27](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L27)
+
+并发数，默认 3
+
+***
+
+### config
+
+> **config**: [`ProxyConfig`](ProxyConfig.md)
+
+Defined in: [packages/proxy/src/core/prefetch.ts:21](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L21)
+
+完整的代理配置
+
+***
+
+### fetcher()?
+
+> `optional` **fetcher**: (`req`) => `Promise`\<`Response`\>
+
+Defined in: [packages/proxy/src/core/prefetch.ts:25](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L25)
+
+自定义 fetcher，默认使用 globalThis.fetch
+
+#### Parameters
+
+##### req
+
+`Request`
+
+#### Returns
+
+`Promise`\<`Response`\>
+
+***
+
+### onProgress()?
+
+> `optional` **onProgress**: (`completed`, `total`, `url`) => `void`
+
+Defined in: [packages/proxy/src/core/prefetch.ts:29](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L29)
+
+进度回调 (completed, total, url)
+
+#### Parameters
+
+##### completed
+
+`number`
+
+##### total
+
+`number`
+
+##### url
+
+`string`
+
+#### Returns
+
+`void`
+
+***
+
+### signal?
+
+> `optional` **signal**: `AbortSignal`
+
+Defined in: [packages/proxy/src/core/prefetch.ts:31](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L31)
+
+取消信号
+
+***
+
+### urls
+
+> **urls**: [`PrefetchRequest`](PrefetchRequest.md)[]
+
+Defined in: [packages/proxy/src/core/prefetch.ts:19](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L19)
+
+要预缓存的 URL 列表及其请求选项

package/docs/interfaces/PrefetchRequest.md

@@ -0,0 +1,31 @@
+[**@isdk/proxy**](../README.md)
+
+***
+
+[@isdk/proxy](../globals.md) / PrefetchRequest
+
+# Interface: PrefetchRequest
+
+Defined in: [packages/proxy/src/core/prefetch.ts:10](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L10)
+
+预缓存请求选项
+
+## Properties
+
+### request?
+
+> `optional` **request**: `RequestInit`
+
+Defined in: [packages/proxy/src/core/prefetch.ts:14](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L14)
+
+可选的请求配置（method, headers, body 等）
+
+***
+
+### url
+
+> **url**: `string`
+
+Defined in: [packages/proxy/src/core/prefetch.ts:12](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L12)
+
+请求 URL

package/docs/interfaces/PrefetchResult.md

@@ -0,0 +1,47 @@
+[**@isdk/proxy**](../README.md)
+
+***
+
+[@isdk/proxy](../globals.md) / PrefetchResult
+
+# Interface: PrefetchResult
+
+Defined in: [packages/proxy/src/core/prefetch.ts:34](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L34)
+
+## Properties
+
+### errors?
+
+> `optional` **errors**: `object`[]
+
+Defined in: [packages/proxy/src/core/prefetch.ts:40](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L40)
+
+失败详情
+
+#### error
+
+> **error**: `Error`
+
+#### url
+
+> **url**: `string`
+
+***
+
+### failed
+
+> **failed**: `number`
+
+Defined in: [packages/proxy/src/core/prefetch.ts:38](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L38)
+
+失败数量
+
+***
+
+### succeeded
+
+> **succeeded**: `number`
+
+Defined in: [packages/proxy/src/core/prefetch.ts:36](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L36)
+
+成功数量

package/docs/interfaces/ProxyConfig.md

@@ -6,7 +6,7 @@
 
 # Interface: ProxyConfig
 
-Defined in: [types.ts:63](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L63)
+Defined in: [packages/proxy/src/types.ts:147](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L147)
 
 代理拦截器全局配置
 
@@ -16,7 +16,7 @@ Defined in: [types.ts:63](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe
 
 > **default**: [`SiteCacheConfig`](SiteCacheConfig.md)
 
-Defined in: [types.ts:65](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L65)
+Defined in: [packages/proxy/src/types.ts:149](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L149)
 
 默认缓存配置，当请求的域名未在 sites 中匹配时使用
 
@@ -26,7 +26,7 @@ Defined in: [types.ts:65](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe
 
 > **sites**: `Record`\<`string`, [`SiteCacheConfig`](SiteCacheConfig.md)\>
 
-Defined in: [types.ts:67](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L67)
+Defined in: [packages/proxy/src/types.ts:151](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L151)
 
 针对特定域名的精细化缓存配置
 
@@ -36,6 +36,6 @@ Defined in: [types.ts:67](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe
 
 > `optional` **storagePath**: `string`
 
-Defined in: [types.ts:69](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L69)
+Defined in: [packages/proxy/src/types.ts:153](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L153)
 
 磁盘缓存（cacache）的物理存储路径，可选，默认为系统临时目录