@isdk/proxy 0.1.2 → 0.1.3

package/docs/functions/generateCacheKey.md

@@ -8,7 +8,7 @@
 
 > **generateCacheKey**(`req`, `config`): `Promise`\<`string`\>
 
-Defined in: [core/generateCacheKey.ts:36](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/generateCacheKey.ts#L36)
+Defined in: [packages/proxy/src/core/generateCacheKey.ts:36](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/generateCacheKey.ts#L36)
 
 根据 Request 对象和站点配置生成唯一的缓存指纹 (异步)
 

package/docs/functions/getSiteConfig.md

@@ -8,7 +8,7 @@
 
 > **getSiteConfig**(`urlString`, `proxyConfig`): [`SiteCacheConfig`](../interfaces/SiteCacheConfig.md)
 
-Defined in: [utils/getSiteConfig.ts:17](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/utils/getSiteConfig.ts#L17)
+Defined in: [packages/proxy/src/utils/getSiteConfig.ts:17](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/utils/getSiteConfig.ts#L17)
 
 根据 URL 获取对应的站点缓存配置
 

package/docs/functions/isAllowed.md

@@ -8,7 +8,7 @@
 
 > **isAllowed**(`key`, `config?`, `defaultAllowed?`): `boolean`
 
-Defined in: [utils/isAllowed.ts:37](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/utils/isAllowed.ts#L37)
+Defined in: [packages/proxy/src/utils/isAllowed.ts:37](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/utils/isAllowed.ts#L37)
 
 判断给定的键是否允许参与缓存指纹计算。
 

package/docs/functions/isCacheable.md

@@ -0,0 +1,27 @@
+[**@isdk/proxy**](../README.md)
+
+***
+
+[@isdk/proxy](../globals.md) / isCacheable
+
+# Function: isCacheable()
+
+> **isCacheable**(`request`, `config`): `Promise`\<`boolean`\>
+
+Defined in: [packages/proxy/src/core/isCacheable.ts:56](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/isCacheable.ts#L56)
+
+判断当前请求是否满足可缓存的基础条件
+
+## Parameters
+
+### request
+
+`Request`
+
+### config
+
+[`SiteCacheConfig`](../interfaces/SiteCacheConfig.md)
+
+## Returns
+
+`Promise`\<`boolean`\>

package/docs/functions/isGlob.md

@@ -8,7 +8,7 @@
 
 > **isGlob**(`str`): `boolean`
 
-Defined in: [utils/matcher.ts:7](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/utils/matcher.ts#L7)
+Defined in: [packages/proxy/src/utils/matcher.ts:7](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/utils/matcher.ts#L7)
 
 判断一个模式是否为 Glob 模式
 

package/docs/functions/isMatch.md

@@ -8,7 +8,7 @@
 
 > **isMatch**(`pattern`, `value`, `usePrefix`): `boolean`
 
-Defined in: [utils/matcher.ts:25](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/utils/matcher.ts#L25)
+Defined in: [packages/proxy/src/utils/matcher.ts:25](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/utils/matcher.ts#L25)
 
 通用匹配函数
 

package/docs/functions/prefetch.md

@@ -0,0 +1,33 @@
+[**@isdk/proxy**](../README.md)
+
+***
+
+[@isdk/proxy](../globals.md) / prefetch
+
+# Function: prefetch()
+
+> **prefetch**(`options`): `Promise`\<[`PrefetchResult`](../interfaces/PrefetchResult.md)\>
+
+Defined in: [packages/proxy/src/core/prefetch.ts:55](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/prefetch.ts#L55)
+
+预缓存函数
+
+提前将指定的 URL 列表内容存入缓存，支持并发控制和进度回调。
+复用了 `createCachedFetch` 的完整逻辑，自动支持：
+- GET/POST/PUT/PATCH/DELETE 等所有方法
+- POST body 过滤和缓存键生成
+- 站点级配置
+
+## Parameters
+
+### options
+
+[`PrefetchOptions`](../interfaces/PrefetchOptions.md)
+
+预缓存选项
+
+## Returns
+
+`Promise`\<[`PrefetchResult`](../interfaces/PrefetchResult.md)\>
+
+预缓存结果，包含成功/失败数量和错误详情

package/docs/globals.md

@@ -6,6 +6,7 @@
 
 ## Classes
 
+- [OfflineCacheMissError](classes/OfflineCacheMissError.md)
 - [SmartCache](classes/SmartCache.md)
 
 ## Interfaces
@@ -17,10 +18,17 @@
 - [FetchWithCacheContext](interfaces/FetchWithCacheContext.md)
 - [FetchWithCacheOptions](interfaces/FetchWithCacheOptions.md)
 - [KeyFilterConfig](interfaces/KeyFilterConfig.md)
+- [PrefetchOptions](interfaces/PrefetchOptions.md)
+- [PrefetchRequest](interfaces/PrefetchRequest.md)
+- [PrefetchResult](interfaces/PrefetchResult.md)
 - [ProxyConfig](interfaces/ProxyConfig.md)
 - [SiteCacheConfig](interfaces/SiteCacheConfig.md)
 - [SmartCacheOptions](interfaces/SmartCacheOptions.md)
 
+## Variables
+
+- [OfflineCacheMissErrorCode](variables/OfflineCacheMissErrorCode.md)
+
 ## Functions
 
 - [createCachedFetch](functions/createCachedFetch.md)
@@ -30,5 +38,7 @@
 - [generateCacheKey](functions/generateCacheKey.md)
 - [getSiteConfig](functions/getSiteConfig.md)
 - [isAllowed](functions/isAllowed.md)
+- [isCacheable](functions/isCacheable.md)
 - [isGlob](functions/isGlob.md)
 - [isMatch](functions/isMatch.md)
+- [prefetch](functions/prefetch.md)

package/docs/interfaces/BodyFilterConfig.md

@@ -6,7 +6,7 @@
 
 # Interface: BodyFilterConfig
 
-Defined in: [types.ts:13](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L13)
+Defined in: [packages/proxy/src/types.ts:13](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L13)
 
 缓存键过滤配置
 
@@ -22,7 +22,7 @@ Defined in: [types.ts:13](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5b
 
 > `optional` **exclude**: (`string` \| `RegExp`)[]
 
-Defined in: [types.ts:10](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/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` 等干扰缓存命中的动态字段。支持字符串、Glob 模式或正则表达式。
 
@@ -36,7 +36,7 @@ Defined in: [types.ts:10](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5b
 
 > `optional` **extract**: `string` \| `RegExp`
 
-Defined in: [types.ts:18](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L18)
+Defined in: [packages/proxy/src/types.ts:18](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L18)
 
 用于非 JSON (文本) Body 的提取正则表达式。
 如果包含捕获组，则提取捕获组内容作为指纹；否则提取整个匹配部分。
@@ -47,7 +47,7 @@ Defined in: [types.ts:18](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5b
 
 > `optional` **include**: (`string` \| `RegExp`)[]
 
-Defined in: [types.ts:8](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/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 的计算。支持字符串、Glob 模式或正则表达式。
 
@@ -61,7 +61,7 @@ Defined in: [types.ts:8](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf
 
 > `optional` **maxLength**: `number`
 
-Defined in: [types.ts:25](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L25)
+Defined in: [packages/proxy/src/types.ts:25](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L25)
 
 用于正则匹配/提取 Body 时的最大长度限制，默认 1024 (1KB)
 
@@ -71,7 +71,7 @@ Defined in: [types.ts:25](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5b
 
 > `optional` **sort**: `boolean`
 
-Defined in: [types.ts:23](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L23)
+Defined in: [packages/proxy/src/types.ts:23](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L23)
 
 是否对提取出的捕获组进行排序。
 开启后可解决 Body 中参数顺序不一致导致的指纹失效问题。

package/docs/interfaces/CacheEntry.md

@@ -6,7 +6,7 @@
 
 # Interface: CacheEntry
 
-Defined in: [types.ts:137](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L137)
+Defined in: [packages/proxy/src/types.ts:139](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L139)
 
 完整的缓存条目
 
@@ -20,7 +20,7 @@ Defined in: [types.ts:137](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5
 
 > **body**: `any`
 
-Defined in: [types.ts:139](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L139)
+Defined in: [packages/proxy/src/types.ts:141](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L141)
 
 响应体数据：小文件为 Buffer，大文件为可读流
 
@@ -30,7 +30,7 @@ Defined in: [types.ts:139](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5
 
 > **headers**: `Record`\<`string`, `string`\>
 
-Defined in: [types.ts:121](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L121)
+Defined in: [packages/proxy/src/types.ts:123](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L123)
 
 响应头对象
 
@@ -44,7 +44,7 @@ Defined in: [types.ts:121](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5
 
 > **method**: `string`
 
-Defined in: [types.ts:127](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L127)
+Defined in: [packages/proxy/src/types.ts:129](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L129)
 
 原始请求方法
 
@@ -58,7 +58,7 @@ Defined in: [types.ts:127](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5
 
 > **policy**: `any`
 
-Defined in: [types.ts:123](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L123)
+Defined in: [packages/proxy/src/types.ts:125](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L125)
 
 http-cache-semantics 策略对象，包含 TTL 和缓存指令
 
@@ -72,7 +72,7 @@ http-cache-semantics 策略对象，包含 TTL 和缓存指令
 
 > **size**: `number`
 
-Defined in: [types.ts:131](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L131)
+Defined in: [packages/proxy/src/types.ts:133](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L133)
 
 Body 的字节长度，用于精确区分“空响应”与“未入内存的大响应”
 
@@ -86,7 +86,7 @@ Body 的字节长度，用于精确区分“空响应”与“未入内存的大
 
 > **status**: `number`
 
-Defined in: [types.ts:119](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L119)
+Defined in: [packages/proxy/src/types.ts:121](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L121)
 
 HTTP 状态码
 
@@ -100,7 +100,7 @@ HTTP 状态码
 
 > **timestamp**: `number`
 
-Defined in: [types.ts:129](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L129)
+Defined in: [packages/proxy/src/types.ts:131](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L131)
 
 缓存写入时的时间戳
 
@@ -114,7 +114,7 @@ Defined in: [types.ts:129](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5
 
 > **url**: `string`
 
-Defined in: [types.ts:125](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L125)
+Defined in: [packages/proxy/src/types.ts:127](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L127)
 
 原始请求 URL
 

package/docs/interfaces/CacheMetadata.md

@@ -6,7 +6,7 @@
 
 # Interface: CacheMetadata
 
-Defined in: [types.ts:117](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L117)
+Defined in: [packages/proxy/src/types.ts:119](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L119)
 
 缓存元数据
 
@@ -23,7 +23,7 @@ Defined in: [types.ts:117](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5
 
 > **headers**: `Record`\<`string`, `string`\>
 
-Defined in: [types.ts:121](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L121)
+Defined in: [packages/proxy/src/types.ts:123](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L123)
 
 响应头对象
 
@@ -33,7 +33,7 @@ Defined in: [types.ts:121](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5
 
 > **method**: `string`
 
-Defined in: [types.ts:127](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L127)
+Defined in: [packages/proxy/src/types.ts:129](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L129)
 
 原始请求方法
 
@@ -43,7 +43,7 @@ Defined in: [types.ts:127](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5
 
 > **policy**: `any`
 
-Defined in: [types.ts:123](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L123)
+Defined in: [packages/proxy/src/types.ts:125](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L125)
 
 http-cache-semantics 策略对象，包含 TTL 和缓存指令
 
@@ -53,7 +53,7 @@ http-cache-semantics 策略对象，包含 TTL 和缓存指令
 
 > **size**: `number`
 
-Defined in: [types.ts:131](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L131)
+Defined in: [packages/proxy/src/types.ts:133](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L133)
 
 Body 的字节长度，用于精确区分“空响应”与“未入内存的大响应”
 
@@ -63,7 +63,7 @@ Body 的字节长度，用于精确区分“空响应”与“未入内存的大
 
 > **status**: `number`
 
-Defined in: [types.ts:119](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L119)
+Defined in: [packages/proxy/src/types.ts:121](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L121)
 
 HTTP 状态码
 
@@ -73,7 +73,7 @@ HTTP 状态码
 
 > **timestamp**: `number`
 
-Defined in: [types.ts:129](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L129)
+Defined in: [packages/proxy/src/types.ts:131](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L131)
 
 缓存写入时的时间戳
 
@@ -83,6 +83,6 @@ Defined in: [types.ts:129](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5
 
 > **url**: `string`
 
-Defined in: [types.ts:125](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L125)
+Defined in: [packages/proxy/src/types.ts:127](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L127)
 
 原始请求 URL

package/docs/interfaces/CacheRule.md

@@ -6,7 +6,7 @@
 
 # Interface: CacheRule
 
-Defined in: [types.ts:35](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L35)
+Defined in: [packages/proxy/src/types.ts:35](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L35)
 
 精细化缓存匹配规则
 
@@ -20,7 +20,7 @@ Defined in: [types.ts:35](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5b
 
 > `optional` **body**: `string` \| `RegExp` \| (`string` \| `RegExp`)[]
 
-Defined in: [types.ts:75](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L75)
+Defined in: [packages/proxy/src/types.ts:75](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L75)
 
 Body 内容匹配。
 仅当 Body 为文本或 JSON 时有效。
@@ -34,7 +34,7 @@ Body 内容匹配。
 
 > `optional` **bodyType**: `"json"` \| `"text"` \| `"binary"`
 
-Defined in: [types.ts:67](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L67)
+Defined in: [packages/proxy/src/types.ts:67](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L67)
 
 强制指定 Body 类型。
 如果不指定，则根据 `Content-Type` 自动判断。
@@ -45,7 +45,7 @@ Defined in: [types.ts:67](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5b
 
 > `optional` **method**: `string`
 
-Defined in: [types.ts:40](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L40)
+Defined in: [packages/proxy/src/types.ts:40](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L40)
 
 匹配的方法 (如 "POST")。
 如果指定，则必须方法完全一致；如果不指定，则匹配所有 `methods` 中允许的方法。
@@ -56,7 +56,7 @@ Defined in: [types.ts:40](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5b
 
 > `optional` **path**: `string` \| `RegExp` \| (`string` \| `RegExp`)[]
 
-Defined in: [types.ts:52](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L52)
+Defined in: [packages/proxy/src/types.ts:52](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L52)
 
 路径匹配。
 - 字符串: 默认进行 Glob 模式匹配（支持 `!` 否定），若非 Glob 且非正则字符串则退化为前缀匹配。
@@ -69,7 +69,7 @@ Defined in: [types.ts:52](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5b
 
 > `optional` **query**: `Record`\<`string`, `string` \| `boolean` \| `RegExp`\>
 
-Defined in: [types.ts:62](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L62)
+Defined in: [packages/proxy/src/types.ts:62](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L62)
 
 Query 参数匹配规则。
 - 键名: 支持字符串、Glob 或正则。

package/docs/interfaces/FetchWithCacheContext.md

@@ -6,9 +6,9 @@
 
 # Interface: FetchWithCacheContext
 
-Defined in: [core/fetchWithCache.ts:32](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L32)
+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:32](https://github.com/isdk/proxy.js/blob/76
 
 > **activeCacheWrites**: `Map`\<`string`, `Promise`\<`void`\>\>
 
-Defined in: [core/fetchWithCache.ts:36](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L36)
+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:18](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L18)
+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:18](https://github.com/isdk/proxy.js/blob/76
 
 > **cache**: [`SmartCache`](../classes/SmartCache.md)
 
-Defined in: [core/fetchWithCache.ts:14](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L14)
+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:14](https://github.com/isdk/proxy.js/blob/76
 
 > **cacheKey**: `string`
 
-Defined in: [core/fetchWithCache.ts:35](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L35)
+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:35](https://github.com/isdk/proxy.js/blob/76
 
 > **config**: [`SiteCacheConfig`](SiteCacheConfig.md)
 
-Defined in: [core/fetchWithCache.ts:16](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L16)
+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:16](https://github.com/isdk/proxy.js/blob/76
 
 > **fetcher**: (`req`) => `Promise`\<`Response`\>
 
-Defined in: [core/fetchWithCache.ts:34](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L34)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:33](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L33)
 
 #### Parameters
 
@@ -104,7 +102,7 @@ Defined in: [core/fetchWithCache.ts:34](https://github.com/isdk/proxy.js/blob/76
 
 > `optional` **generateKey**: (`req`, `config`) => `Promise`\<`string`\>
 
-Defined in: [core/fetchWithCache.ts:22](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L22)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:23](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L23)
 
 自定义缓存键生成函数
 
@@ -164,7 +162,7 @@ const cacheKey = await generateCacheKey(request, {
 
 > `optional` **onBackgroundUpdate**: (`promise`) => `void`
 
-Defined in: [core/fetchWithCache.ts:20](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L20)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:21](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L21)
 
 后台更新 Promise 触发时的回调
 
@@ -188,4 +186,4 @@ Defined in: [core/fetchWithCache.ts:20](https://github.com/isdk/proxy.js/blob/76
 
 > **request**: `Request`
 
-Defined in: [core/fetchWithCache.ts:33](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L33)
+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:12](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L12)
+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:28](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L28)
+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:18](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L18)
+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:18](https://github.com/isdk/proxy.js/blob/76
 
 > **cache**: [`SmartCache`](../classes/SmartCache.md)
 
-Defined in: [core/fetchWithCache.ts:14](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L14)
+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:14](https://github.com/isdk/proxy.js/blob/76
 
 > **config**: [`SiteCacheConfig`](SiteCacheConfig.md)
 
-Defined in: [core/fetchWithCache.ts:16](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L16)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:17](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L17)
 
 站点级缓存配置
 
@@ -62,7 +60,7 @@ Defined in: [core/fetchWithCache.ts:16](https://github.com/isdk/proxy.js/blob/76
 
 > `optional` **generateKey**: (`req`, `config`) => `Promise`\<`string`\>
 
-Defined in: [core/fetchWithCache.ts:22](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L22)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:23](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L23)
 
 自定义缓存键生成函数
 
@@ -118,7 +116,7 @@ const cacheKey = await generateCacheKey(request, {
 
 > `optional` **onBackgroundUpdate**: (`promise`) => `void`
 
-Defined in: [core/fetchWithCache.ts:20](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L20)
+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,7 +6,7 @@
 
 # Interface: KeyFilterConfig
 
-Defined in: [types.ts:6](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/types.ts#L6)
+Defined in: [packages/proxy/src/types.ts:6](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L6)
 
 缓存键过滤配置
 
@@ -22,7 +22,7 @@ Defined in: [types.ts:6](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf
 
 > `optional` **exclude**: (`string` \| `RegExp`)[]
 
-Defined in: [types.ts:10](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/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` 等干扰缓存命中的动态字段。支持字符串、Glob 模式或正则表达式。
 
@@ -32,6 +32,6 @@ Defined in: [types.ts:10](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5b
 
 > `optional` **include**: (`string` \| `RegExp`)[]
 
-Defined in: [types.ts:8](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/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 的计算。支持字符串、Glob 模式或正则表达式。