@isdk/proxy 0.1.1 → 0.1.3

package/docs/functions/extractData.md

@@ -6,18 +6,23 @@
 
 # Function: extractData()
 
-> **extractData**(`source`, `config?`): `Record`\<`string`, `string`[]\>
+> **extractData**(`source`, `config?`, `defaultAllowed?`): `Record`\<`string`, `string`[]\>
 
-Defined in: [utils/extractData.ts:17](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/utils/extractData.ts#L17)
+Defined in: [packages/proxy/src/utils/extractData.ts:40](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/utils/extractData.ts#L40)
 
 从源对象中根据过滤配置提取数据并标准化。
 
 此函数主要用于生成缓存指纹。它会：
-1. 根据 `config` (include/exclude) 过滤键。
+1. 根据 `config` (include/exclude) 过滤键，调用 `isAllowed` 判断每个键是否允许。
 2. 对键进行排序以保证指纹的一致性。
 3. 将所有键转换为小写。
 4. 将值统一包装为数组并进行排序，消除数组项顺序差异。
 
+**关于 `defaultAllowed` 参数**：
+- 只有当没有配置 `include` 和 `exclude` 时，`defaultAllowed` 才会生效。
+- 如果配置了 `include`（即使为空数组），`defaultAllowed` 也不会生效。
+- 详见 `isAllowed` 函数的优先级逻辑。
+
 ## Parameters
 
 ### source
@@ -30,10 +35,34 @@ Defined in: [utils/extractData.ts:17](https://github.com/isdk/proxy.js/blob/bed3
 
 [`KeyFilterConfig`](../interfaces/KeyFilterConfig.md)
 
-过滤配置 (白名单或黑名单)
+过滤配置，支持 `include`（白名单）和 `exclude`（黑名单）
+
+### defaultAllowed?
+
+`boolean`
+
+当没有配置时的默认值（默认 `false`，即不提取任何键）
 
 ## Returns
 
 `Record`\<`string`, `string`[]\>
 
-标准化后的数据 Map，键为小写，值为字符串数组
+标准化后的数据 Map，键为小写，值为排序后的字符串数组
+
+## Example
+
+```typescript
+const headers = { 'Content-Type': 'application/json', 'X-Request-Id': '123' };
+
+// 默认不提取任何键
+extractData(headers); // {}
+
+// 提取所有键
+extractData(headers, undefined, true); // { 'content-type': ['application/json'], 'x-request-id': ['123'] }
+
+// 白名单
+extractData(headers, { include: ['content-type'] }); // { 'content-type': ['application/json'] }
+
+// 黑名单（需要 include 或 defaultAllowed）
+extractData(headers, { include: ['*'], exclude: ['x-request-id'] }, true); // { 'content-type': ['application/json'] }
+```

package/docs/functions/fetchWithCache.md

@@ -8,17 +8,18 @@
 
 > **fetchWithCache**(`request`, `fetcher`, `options`): `Promise`\<`Response`\>
 
-Defined in: [core/fetchWithCache.ts:244](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/fetchWithCache.ts#L244)
+Defined in: [packages/proxy/src/core/fetchWithCache.ts:234](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/fetchWithCache.ts#L234)
 
-核心协调函数 (Fetcher Orchestrator)
+核心协调函数：协调请求、缓存命中、并发控制和 SWR
 
-实现了基于流的混合缓存代理核心逻辑，主要机制包括：
-- **大文件流式处理**：底层完全通过 Streams 实现，代理大文件时自动写入磁盘且防 OOM。
-- **SWR (Stale-While-Revalidate)**：后台静默更新机制。
-- **并发防击穿 (Request Coalescing)**：利用 `activeCacheWrites` 将并发请求合并。
-- **强制离线容灾**：支持 `staleIfError` 和 `forceCache`（无视 Cache-Control 强制入库）。
-
-并且会在响应头中自动注入 `x-proxy-cache` 标明缓存命中状态 (`HIT`, `STALE`, `MISS`, `STALE_IF_ERROR`)。
+流程如下：
+1. 初始化上下文并生成缓存键。
+2. 检查离线模式：若开启则强读取，未命中直接抛错。
+3. 检查请求是否符合缓存规则 (isCacheable)。
+4. 尝试读取缓存并判定状态 (HIT / STALE)。
+5. 处理 SWR (后台更新)。
+6. 处理请求合并 (Request Coalescing)，防止缓存击穿。
+7. 若缓存缺失，发起网络请求并流式写入。
 
 ## Parameters
 
@@ -26,14 +27,22 @@ Defined in: [core/fetchWithCache.ts:244](https://github.com/isdk/proxy.js/blob/b
 
 `Request`
 
+标准 Web Request 对象
+
 ### fetcher
 
 (`req`) => `Promise`\<`Response`\>
 
+底层发起真实请求的函数
+
 ### options
 
 [`FetchWithCacheOptions`](../interfaces/FetchWithCacheOptions.md)
 
+缓存协调配置项
+
 ## Returns
 
 `Promise`\<`Response`\>
+
+标准 Web Response 对象 (带 x-proxy-cache 标头)

package/docs/functions/generateCacheKey.md

@@ -6,11 +6,26 @@
 
 # Function: generateCacheKey()
 
-> **generateCacheKey**(`req`, `config`): `string`
+> **generateCacheKey**(`req`, `config`): `Promise`\<`string`\>
 
-Defined in: [core/generateCacheKey.ts:8](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/generateCacheKey.ts#L8)
+Defined in: [packages/proxy/src/core/generateCacheKey.ts:36](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/generateCacheKey.ts#L36)
 
-根据 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
 
@@ -18,10 +33,25 @@ Defined in: [core/generateCacheKey.ts:8](https://github.com/isdk/proxy.js/blob/b
 
 `Request`
 
+原始 Web 标准 Request 对象。
+
 ### config
 
 [`SiteCacheConfig`](../interfaces/SiteCacheConfig.md)
 
+站点级缓存配置，决定了哪些字段参与指纹计算。
+
 ## Returns
 
-`string`
+`Promise`\<`string`\>
+
+返回一个 64 位十六进制的 SHA-256 哈希字符串作为缓存键。
+
+## Example
+
+```typescript
+const cacheKey = await generateCacheKey(request, {
+  query: { exclude: ['timestamp'] },
+  body: { include: ['id', 'action'] }
+});
+```

package/docs/functions/getSiteConfig.md

@@ -0,0 +1,39 @@
+[**@isdk/proxy**](../README.md)
+
+***
+
+[@isdk/proxy](../globals.md) / getSiteConfig
+
+# Function: getSiteConfig()
+
+> **getSiteConfig**(`urlString`, `proxyConfig`): [`SiteCacheConfig`](../interfaces/SiteCacheConfig.md)
+
+Defined in: [packages/proxy/src/utils/getSiteConfig.ts:17](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/utils/getSiteConfig.ts#L17)
+
+根据 URL 获取对应的站点缓存配置
+
+匹配逻辑：
+1. 遍历 sites 中的所有 key。
+2. 如果 key 是正则或 Glob 格式字符串，则对完整 URL 进行匹配。
+3. 如果 key 是普通字符串，则作为 URL 前缀进行匹配。
+4. 返回第一个匹配到的配置；若均未匹配，则返回 defaultConfig。
+
+## Parameters
+
+### urlString
+
+`string`
+
+请求的完整 URL
+
+### proxyConfig
+
+[`ProxyConfig`](../interfaces/ProxyConfig.md)
+
+全局代理配置
+
+## Returns
+
+[`SiteCacheConfig`](../interfaces/SiteCacheConfig.md)
+
+匹配到的站点配置

package/docs/functions/isAllowed.md

@@ -6,16 +6,19 @@
 
 # Function: isAllowed()
 
-> **isAllowed**(`key`, `config?`): `boolean`
+> **isAllowed**(`key`, `config?`, `defaultAllowed?`): `boolean`
 
-Defined in: [utils/isAllowed.ts:15](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/utils/isAllowed.ts#L15)
+Defined in: [packages/proxy/src/utils/isAllowed.ts:37](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/utils/isAllowed.ts#L37)
 
 判断给定的键是否允许参与缓存指纹计算。
 
-优先级逻辑：
-1. 如果配置了 `include` (白名单)，则只有存在于 `include` 中的键才会被允许。
-2. 否则，如果配置了 `exclude` (黑名单)，则存在于 `exclude` 中的键将被拒绝。
-3. 如果都没有配置，默认允许所有键。
+**优先级逻辑**：
+1. `exclude` 命中 → 返回 `false`（优先级最高，会覆盖前面的结果）
+2. `include` 存在且命中 → 返回 `true`
+3. `include` 存在但不命中 → 返回 `false`
+4. 都没有配置 → 使用 `defaultAllowed`（未传则返回 `undefined`）
+
+**注意**：`include` 和 `exclude` 可以同时配置，此时 `exclude` 优先级更高。
 
 ## Parameters
 
@@ -29,10 +32,34 @@ Defined in: [utils/isAllowed.ts:15](https://github.com/isdk/proxy.js/blob/bed37f
 
 [`KeyFilterConfig`](../interfaces/KeyFilterConfig.md)
 
-过滤配置
+过滤配置，支持 `include`（白名单）和 `exclude`（黑名单）
+
+### defaultAllowed?
+
+`boolean`
+
+当没有配置或配置未命中时的默认值（可选）
 
 ## Returns
 
 `boolean`
 
-是否允许
+是否允许。返回 `boolean` 或 `undefined`（当没有配置且未传 defaultAllowed 时）
+
+## Example
+
+```typescript
+// 无配置
+isAllowed('key'); // undefined
+
+// 白名单
+isAllowed('id', { include: ['id', 'name'] }); // true
+isAllowed('email', { include: ['id', 'name'] }); // false
+
+// 黑名单
+isAllowed('password', { exclude: ['password'] }); // false
+isAllowed('name', { exclude: ['password'] }); // undefined
+
+// 设置默认值
+isAllowed('name', { exclude: ['password'] }, true); // true
+```

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

@@ -0,0 +1,23 @@
+[**@isdk/proxy**](../README.md)
+
+***
+
+[@isdk/proxy](../globals.md) / isGlob
+
+# Function: isGlob()
+
+> **isGlob**(`str`): `boolean`
+
+Defined in: [packages/proxy/src/utils/matcher.ts:7](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/utils/matcher.ts#L7)
+
+判断一个模式是否为 Glob 模式
+
+## Parameters
+
+### str
+
+`string`
+
+## Returns
+
+`boolean`

package/docs/functions/isMatch.md

@@ -0,0 +1,44 @@
+[**@isdk/proxy**](../README.md)
+
+***
+
+[@isdk/proxy](../globals.md) / isMatch
+
+# Function: isMatch()
+
+> **isMatch**(`pattern`, `value`, `usePrefix`): `boolean`
+
+Defined in: [packages/proxy/src/utils/matcher.ts:25](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/utils/matcher.ts#L25)
+
+通用匹配函数
+
+逻辑优先级：
+1. 如果 pattern 是数组，遵循：(匹配任一正向模式) 且 (不匹配任一负向模式)。
+2. 如果 pattern 是 RegExp 对象，直接使用 regex.test(value)。
+3. 如果 pattern 是 "/regex/flags" 格式的字符串，转为 RegExp 后使用 test。
+4. 如果 pattern 是 Glob 字符串，使用 picomatch 进行匹配。
+5. 否则，根据 usePrefix 参数进行前缀匹配或精确匹配。
+
+## Parameters
+
+### pattern
+
+匹配模式 (RegExp 或 字符串 或 数组)
+
+`string` | `RegExp` | (`string` \| `RegExp`)[]
+
+### value
+
+`string`
+
+要匹配的值
+
+### usePrefix
+
+`boolean` = `false`
+
+是否在普通字符串匹配时启用前缀匹配 (默认为 false，即精确匹配)
+
+## Returns
+
+`boolean`

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,19 +6,29 @@
 
 ## Classes
 
+- [OfflineCacheMissError](classes/OfflineCacheMissError.md)
 - [SmartCache](classes/SmartCache.md)
 
 ## Interfaces
 
+- [BodyFilterConfig](interfaces/BodyFilterConfig.md)
 - [CacheEntry](interfaces/CacheEntry.md)
 - [CacheMetadata](interfaces/CacheMetadata.md)
+- [CacheRule](interfaces/CacheRule.md)
 - [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)
@@ -26,4 +36,9 @@
 - [extractData](functions/extractData.md)
 - [fetchWithCache](functions/fetchWithCache.md)
 - [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

@@ -0,0 +1,77 @@
+[**@isdk/proxy**](../README.md)
+
+***
+
+[@isdk/proxy](../globals.md) / BodyFilterConfig
+
+# Interface: BodyFilterConfig
+
+Defined in: [packages/proxy/src/types.ts:13](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L13)
+
+缓存键过滤配置
+
+用于定义在生成缓存指纹时，哪些字段应该被包含或排除。
+
+## Extends
+
+- [`KeyFilterConfig`](KeyFilterConfig.md)
+
+## Properties
+
+### exclude?
+
+> `optional` **exclude**: (`string` \| `RegExp`)[]
+
+Defined in: [packages/proxy/src/types.ts:10](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L10)
+
+排除（黑名单）：用于排除像 `timestamp`、`nonce` 等干扰缓存命中的动态字段。支持字符串、Glob 模式或正则表达式。
+
+#### Inherited from
+
+[`KeyFilterConfig`](KeyFilterConfig.md).[`exclude`](KeyFilterConfig.md#exclude)
+
+***
+
+### extract?
+
+> `optional` **extract**: `string` \| `RegExp`
+
+Defined in: [packages/proxy/src/types.ts:18](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L18)
+
+用于非 JSON (文本) Body 的提取正则表达式。
+如果包含捕获组，则提取捕获组内容作为指纹；否则提取整个匹配部分。
+
+***
+
+### include?
+
+> `optional` **include**: (`string` \| `RegExp`)[]
+
+Defined in: [packages/proxy/src/types.ts:8](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L8)
+
+仅包含（白名单）：如果设置，只有这些字段会参与 Key 的计算。支持字符串、Glob 模式或正则表达式。
+
+#### Inherited from
+
+[`KeyFilterConfig`](KeyFilterConfig.md).[`include`](KeyFilterConfig.md#include)
+
+***
+
+### maxLength?
+
+> `optional` **maxLength**: `number`
+
+Defined in: [packages/proxy/src/types.ts:25](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L25)
+
+用于正则匹配/提取 Body 时的最大长度限制，默认 1024 (1KB)
+
+***
+
+### sort?
+
+> `optional` **sort**: `boolean`
+
+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:55](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L55)
+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:55](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe
 
 > **body**: `any`
 
-Defined in: [types.ts:57](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L57)
+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:57](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe
 
 > **headers**: `Record`\<`string`, `string`\>
 
-Defined in: [types.ts:39](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L39)
+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:39](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe
 
 > **method**: `string`
 
-Defined in: [types.ts:45](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L45)
+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:45](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe
 
 > **policy**: `any`
 
-Defined in: [types.ts:41](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L41)
+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:49](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L49)
+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:37](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L37)
+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:47](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L47)
+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:47](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe
 
 > **url**: `string`
 
-Defined in: [types.ts:43](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L43)
+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:35](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L35)
+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:35](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe
 
 > **headers**: `Record`\<`string`, `string`\>
 
-Defined in: [types.ts:39](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L39)
+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:39](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe
 
 > **method**: `string`
 
-Defined in: [types.ts:45](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L45)
+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:45](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe
 
 > **policy**: `any`
 
-Defined in: [types.ts:41](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L41)
+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:49](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L49)
+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:37](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L37)
+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:47](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L47)
+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:47](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe
 
 > **url**: `string`
 
-Defined in: [types.ts:43](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L43)
+Defined in: [packages/proxy/src/types.ts:127](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/types.ts#L127)
 
 原始请求 URL