@isdk/proxy 0.1.2 → 0.1.3

package/docs/README.md

@@ -93,17 +93,31 @@ const myPostFetch = createCachedFetch({
 | `query` | `KeyFilterConfig` | Filters for URL search parameters (`include`/`exclude`). |
 | `headers` | `KeyFilterConfig` | Filters for request headers. |
 | `cookies` | `KeyFilterConfig` | Filters for cookies. |
-| `body` | `KeyFilterConfig` | Filters for JSON request body fields. |
+| `body` | `KeyFilterConfig` | Filters for request body fields. For JSON, supports field-level filtering; also supports extracting key data via `extract` regex. |
 | `staleIfError`| `boolean` | Serve stale cache on network failure. |
 | `forceCache` | `boolean` | Ignore `no-store` and force caching (useful for offline support). |
+| `offline` | `boolean` | Offline mode. Only reads from cache; throws `OfflineCacheMissError` if no cache exists. |
 
 ### `CacheRule` Object
 
 - `method`: HTTP method to match.
 - `path`: URL pathname matching (supports **RegExp**, **Glob**, **Array**, or **prefix match**).
 - `query`: Key-value pairs. Values can be `string` (exact/Glob match), `true` (must exist), `false` (must not exist), or `RegExp`.
+- `bodyType`: Match body type. Supports `'json'`, `'text'`, `'binary'`.
 - `body`: Body content matching (supports **RegExp**, **Glob**, or **Array**).
 
+---
+
+### `fetchWithCache` Advanced Options
+
+In addition to `SiteCacheConfig`, `fetchWithCache` supports the following control options:
+
+| Option | Type | Description |
+| :--- | :--- | :--- |
+| `backgroundUpdate` | `boolean` | Whether to enable background async update (SWR). Default is `true`. |
+| `onBackgroundUpdate`| `function` | Callback that receives the update Promise when a background update is triggered. Useful for task tracking. |
+| `generateKey` | `function` | Custom cache key generation function. |
+
 ### Pattern Matching
 
 `@isdk/proxy` provides powerful pattern matching for all configurable fields:
@@ -303,6 +317,50 @@ extractData(headers, { include: ['content-type'] }); // { 'content-type': ['appl
 extractData(headers, { include: ['*'], exclude: ['x-request-id'] }, true); // { 'content-type': ['application/json'] }
 ```
 
+### `prefetch(options)`
+
+Pre-cache function that fetches and stores a list of URLs into cache ahead of time.
+
+- **`urls`**: `PrefetchRequest[]`. Each object contains `url` and optional `request` config.
+- **`config`**: `ProxyConfig` full configuration.
+- **`cache`**: `SmartCache` instance.
+- **`concurrency`**: Concurrency limit (default `3`).
+- **`onProgress`**: Progress callback `(completed, total, url) => void`.
+
+```typescript
+import { prefetch } from '@isdk/proxy';
+
+const result = await prefetch({
+  urls: [
+    { url: 'https://api.example.com/page1' },
+    { url: 'https://api.example.com/api2', request: { method: 'POST', body: '...' } }
+  ],
+  config,
+  cache,
+  onProgress: (c, t, url) => console.log(`Progress: ${c}/${t} - ${url}`)
+});
+console.log(`Succeeded: ${result.succeeded}, Failed: ${result.failed}`);
+```
+
+### Error Handling: `OfflineCacheMissError`
+
+When `offline: true` mode is enabled and a request does not hit the cache, this error is thrown.
+
+- **`name`**: `OfflineCacheMissError`
+- **`code`**: `ERR_OFFLINE_CACHE_MISS` (can be imported as `OfflineCacheMissErrorCode`)
+
+```typescript
+import { OfflineCacheMissError } from '@isdk/proxy';
+
+try {
+  await myFetch(request);
+} catch (e) {
+  if (e instanceof OfflineCacheMissError) {
+    // Handle offline cache miss
+  }
+}
+```
+
 ### Cache Status Headers
 
 Every response processed by `@isdk/proxy` will include an `x-proxy-cache` header indicating its lifecycle:

package/docs/classes/OfflineCacheMissError.md

@@ -0,0 +1,426 @@
+[**@isdk/proxy**](../README.md)
+
+***
+
+[@isdk/proxy](../globals.md) / OfflineCacheMissError
+
+# Class: OfflineCacheMissError
+
+Defined in: [packages/proxy/src/errors.ts:24](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/errors.ts#L24)
+
+Offline 缓存未命中错误
+
+## Example
+
+```ts
+throw new OfflineCacheMissError('http://example.com/data')
+```
+
+## Extends
+
+- `CommonError`
+
+## Constructors
+
+### Constructor
+
+> **new OfflineCacheMissError**(`url`, `name?`): `OfflineCacheMissError`
+
+Defined in: [packages/proxy/src/errors.ts:26](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/errors.ts#L26)
+
+#### Parameters
+
+##### url
+
+`string` | `number`
+
+##### name?
+
+`string` | `Record`\<`string`, `any`\>
+
+#### Returns
+
+`OfflineCacheMissError`
+
+#### Overrides
+
+`CommonError.constructor`
+
+## Properties
+
+### caller
+
+> **caller**: `string`
+
+Defined in: node\_modules/.pnpm/@isdk+common-error@0.2.2/node\_modules/@isdk/common-error/dist/index.d.ts:141
+
+#### Inherited from
+
+`CommonError.caller`
+
+***
+
+### cause?
+
+> `optional` **cause**: `unknown`
+
+Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es2022.error.d.ts:26
+
+#### Inherited from
+
+`CommonError.cause`
+
+***
+
+### code
+
+> **code**: `ErrorCodeType`
+
+Defined in: node\_modules/.pnpm/@isdk+common-error@0.2.2/node\_modules/@isdk/common-error/dist/index.d.ts:142
+
+the error code
+
+#### Inherited from
+
+`CommonError.code`
+
+***
+
+### data?
+
+> `optional` **data**: `any`
+
+Defined in: node\_modules/.pnpm/@isdk+common-error@0.2.2/node\_modules/@isdk/common-error/dist/index.d.ts:143
+
+#### Inherited from
+
+`CommonError.data`
+
+***
+
+### message
+
+> **message**: `string`
+
+Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:1077
+
+#### Inherited from
+
+`CommonError.message`
+
+***
+
+### name
+
+> **name**: `string`
+
+Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:1076
+
+#### Inherited from
+
+`CommonError.name`
+
+***
+
+### stack?
+
+> `optional` **stack**: `string`
+
+Defined in: node\_modules/.pnpm/typescript@5.7.3/node\_modules/typescript/lib/lib.es5.d.ts:1078
+
+#### Inherited from
+
+`CommonError.stack`
+
+***
+
+### code
+
+> `static` **code**: `ErrorCode` = `OfflineCacheMissErrorCode`
+
+Defined in: [packages/proxy/src/errors.ts:25](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/errors.ts#L25)
+
+The error code associated with the error.
+
+#### Overrides
+
+`CommonError.code`
+
+***
+
+### stackTraceLimit
+
+> `static` **stackTraceLimit**: `number`
+
+Defined in: node\_modules/.pnpm/@types+node@20.19.26/node\_modules/@types/node/globals.d.ts:68
+
+The `Error.stackTraceLimit` property specifies the number of stack frames
+collected by a stack trace (whether generated by `new Error().stack` or
+`Error.captureStackTrace(obj)`).
+
+The default value is `10` but may be set to any valid JavaScript number. Changes
+will affect any stack trace captured _after_ the value has been changed.
+
+If set to a non-number value, or set to a negative number, stack traces will
+not capture any frames.
+
+#### Inherited from
+
+`CommonError.stackTraceLimit`
+
+## Methods
+
+### fromJSON()
+
+> **fromJSON**(`json`): `BaseError`
+
+Defined in: node\_modules/.pnpm/@isdk+common-error@0.2.2/node\_modules/@isdk/common-error/dist/index.d.ts:183
+
+#### Parameters
+
+##### json
+
+`any`
+
+#### Returns
+
+`BaseError`
+
+#### Inherited from
+
+`CommonError.fromJSON`
+
+***
+
+### toJSON()
+
+> **toJSON**(): `any`
+
+Defined in: node\_modules/.pnpm/@isdk+common-error@0.2.2/node\_modules/@isdk/common-error/dist/index.d.ts:165
+
+Returns a JSON representation of the error.
+
+#### Returns
+
+`any`
+
+A JSON representation of the error.
+
+#### Inherited from
+
+`CommonError.toJSON`
+
+***
+
+### captureStackTrace()
+
+> `static` **captureStackTrace**(`targetObject`, `constructorOpt?`): `void`
+
+Defined in: node\_modules/.pnpm/@types+node@20.19.26/node\_modules/@types/node/globals.d.ts:52
+
+Creates a `.stack` property on `targetObject`, which when accessed returns
+a string representing the location in the code at which
+`Error.captureStackTrace()` was called.
+
+```js
+const myObject = {};
+Error.captureStackTrace(myObject);
+myObject.stack;  // Similar to `new Error().stack`
+```
+
+The first line of the trace will be prefixed with
+`${myObject.name}: ${myObject.message}`.
+
+The optional `constructorOpt` argument accepts a function. If given, all frames
+above `constructorOpt`, including `constructorOpt`, will be omitted from the
+generated stack trace.
+
+The `constructorOpt` argument is useful for hiding implementation
+details of error generation from the user. For instance:
+
+```js
+function a() {
+  b();
+}
+
+function b() {
+  c();
+}
+
+function c() {
+  // Create an error without stack trace to avoid calculating the stack trace twice.
+  const { stackTraceLimit } = Error;
+  Error.stackTraceLimit = 0;
+  const error = new Error();
+  Error.stackTraceLimit = stackTraceLimit;
+
+  // Capture the stack trace above function b
+  Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
+  throw error;
+}
+
+a();
+```
+
+#### Parameters
+
+##### targetObject
+
+`object`
+
+##### constructorOpt?
+
+`Function`
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+`CommonError.captureStackTrace`
+
+***
+
+### create()
+
+> `static` **create**(`__namedParameters`): `CommonError`
+
+Defined in: node\_modules/.pnpm/@isdk+common-error@0.2.2/node\_modules/@isdk/common-error/dist/index.d.ts:186
+
+#### Parameters
+
+##### \_\_namedParameters
+
+###### code?
+
+`string` \| `number`
+
+###### data?
+
+`any`
+
+###### error
+
+`string`
+
+###### name?
+
+`string`
+
+#### Returns
+
+`CommonError`
+
+#### Inherited from
+
+`CommonError.create`
+
+***
+
+### createErrorClass()
+
+> `static` **createErrorClass**(`aType`, `aErrorCode?`, `ParentErrorClass?`): *typeof* `BaseError`
+
+Defined in: node\_modules/.pnpm/@isdk+common-error@0.2.2/node\_modules/@isdk/common-error/dist/index.d.ts:145
+
+Create an Error Class
+
+#### Parameters
+
+##### aType
+
+`string`
+
+the error type(class) name
+
+##### aErrorCode?
+
+`string` | `number` | *typeof* `AbstractError`
+
+##### ParentErrorClass?
+
+*typeof* `BaseError`
+
+the parent error class. defaults to AbstractError
+
+#### Returns
+
+*typeof* `BaseError`
+
+the new Error Class
+
+#### Inherited from
+
+`CommonError.createErrorClass`
+
+***
+
+### fromJSON()
+
+> `static` **fromJSON**(`json`): `BaseError`
+
+Defined in: node\_modules/.pnpm/@isdk+common-error@0.2.2/node\_modules/@isdk/common-error/dist/index.d.ts:182
+
+Creates a new error instance from a JSON representation.
+This method is useful for deserializing an error that was serialized with `toJSON`.
+
+#### Parameters
+
+##### json
+
+`any`
+
+A JSON object representing the error.
+
+#### Returns
+
+`BaseError`
+
+A new instance of the error class (or a subclass).
+
+#### Example
+
+```ts
+const originalError = new NotFoundError('thing');
+const json = originalError.toJSON();
+
+// Deserialize
+const newError = NotFoundError.fromJSON(json);
+console.log(newError instanceof NotFoundError); // true
+console.log(newError.message); // 'Could not find thing.'
+```
+
+#### Inherited from
+
+`CommonError.fromJSON`
+
+***
+
+### prepareStackTrace()
+
+> `static` **prepareStackTrace**(`err`, `stackTraces`): `any`
+
+Defined in: node\_modules/.pnpm/@types+node@20.19.26/node\_modules/@types/node/globals.d.ts:56
+
+#### Parameters
+
+##### err
+
+`Error`
+
+##### stackTraces
+
+`CallSite`[]
+
+#### Returns
+
+`any`
+
+#### See
+
+https://v8.dev/docs/stack-trace-api#customizing-stack-traces
+
+#### Inherited from
+
+`CommonError.prepareStackTrace`

package/docs/classes/SmartCache.md

@@ -6,7 +6,7 @@
 
 # Class: SmartCache
 
-Defined in: [core/SmartCache.ts:39](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/SmartCache.ts#L39)
+Defined in: [packages/proxy/src/core/SmartCache.ts:39](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/SmartCache.ts#L39)
 
 智能混合缓存类 (Hybrid Multi-tier Cache)
 
@@ -26,7 +26,7 @@ Defined in: [core/SmartCache.ts:39](https://github.com/isdk/proxy.js/blob/76fee3
 
 > **new SmartCache**(`options`): `SmartCache`
 
-Defined in: [core/SmartCache.ts:44](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/SmartCache.ts#L44)
+Defined in: [packages/proxy/src/core/SmartCache.ts:44](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/SmartCache.ts#L44)
 
 #### Parameters
 
@@ -42,9 +42,19 @@ Defined in: [core/SmartCache.ts:44](https://github.com/isdk/proxy.js/blob/76fee3
 
 ### clear()
 
-> **clear**(): `Promise`\<`void`\>
+> **clear**(`clearPersistent?`): `Promise`\<`void`\>
 
-Defined in: [core/SmartCache.ts:193](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/SmartCache.ts#L193)
+Defined in: [packages/proxy/src/core/SmartCache.ts:202](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/SmartCache.ts#L202)
+
+Clears the cache. By default, both the in-memory cache and the persistent disk cache are cleared.
+
+#### Parameters
+
+##### clearPersistent?
+
+`boolean` = `true`
+
+Whether to clear the persistent (disk) cache. Defaults to `true` for backward compatibility.
 
 #### Returns
 
@@ -54,9 +64,11 @@ Defined in: [core/SmartCache.ts:193](https://github.com/isdk/proxy.js/blob/76fee
 
 ### delete()
 
-> **delete**(`key`): `Promise`\<`void`\>
+> **delete**(`key`, `clearPersistent?`): `Promise`\<`void`\>
 
-Defined in: [core/SmartCache.ts:188](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/SmartCache.ts#L188)
+Defined in: [packages/proxy/src/core/SmartCache.ts:193](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/SmartCache.ts#L193)
+
+Deletes the cache entry for the specified key.
 
 #### Parameters
 
@@ -64,6 +76,14 @@ Defined in: [core/SmartCache.ts:188](https://github.com/isdk/proxy.js/blob/76fee
 
 `string`
 
+The cache key to delete
+
+##### clearPersistent?
+
+`boolean` = `true`
+
+Whether to also delete the entry from persistent (disk) storage. Defaults to `true`.
+
 #### Returns
 
 `Promise`\<`void`\>
@@ -74,7 +94,7 @@ Defined in: [core/SmartCache.ts:188](https://github.com/isdk/proxy.js/blob/76fee
 
 > **get**(`key`): `Promise`\<[`CacheEntry`](../interfaces/CacheEntry.md) \| `null`\>
 
-Defined in: [core/SmartCache.ts:79](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/SmartCache.ts#L79)
+Defined in: [packages/proxy/src/core/SmartCache.ts:79](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/SmartCache.ts#L79)
 
 获取缓存条目
 
@@ -104,7 +124,7 @@ Defined in: [core/SmartCache.ts:79](https://github.com/isdk/proxy.js/blob/76fee3
 
 > **getStream**(`key`): `ReadableStream`
 
-Defined in: [core/SmartCache.ts:159](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/SmartCache.ts#L159)
+Defined in: [packages/proxy/src/core/SmartCache.ts:159](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/SmartCache.ts#L159)
 
 获取磁盘读取流
 
@@ -130,7 +150,7 @@ Node.js 可读流
 
 > **set**(`key`, `body`, `metadata`): `Promise`\<`void`\>
 
-Defined in: [core/SmartCache.ts:129](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/SmartCache.ts#L129)
+Defined in: [packages/proxy/src/core/SmartCache.ts:129](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/SmartCache.ts#L129)
 
 写入缓存条目 (原子写入)
 
@@ -166,7 +186,7 @@ Defined in: [core/SmartCache.ts:129](https://github.com/isdk/proxy.js/blob/76fee
 
 > **setStream**(`key`, `metadata`): `WritableStream`
 
-Defined in: [core/SmartCache.ts:175](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/SmartCache.ts#L175)
+Defined in: [packages/proxy/src/core/SmartCache.ts:175](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/SmartCache.ts#L175)
 
 获取磁盘写入流 (流式缓存)
 

package/docs/functions/createCachedFetch.md

@@ -8,7 +8,7 @@
 
 > **createCachedFetch**(`defaultOptions`): (`request`, `fetcher`, `overrideOptions?`) => `Promise`\<`Response`\>
 
-Defined in: [core/createCachedFetch.ts:17](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/createCachedFetch.ts#L17)
+Defined in: [packages/proxy/src/core/createCachedFetch.ts:17](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/createCachedFetch.ts#L17)
 
 缓存请求工厂函数 (针对终端用户的顶层高阶 API)
 

package/docs/functions/createFetchWithCache.md

@@ -8,7 +8,7 @@
 
 > **createFetchWithCache**(`activeCacheWrites?`): (`request`, `fetcher`, `options`) => `Promise`\<`Response`\>
 
-Defined in: [core/createFetchWithCache.ts:16](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/createFetchWithCache.ts#L16)
+Defined in: [packages/proxy/src/core/createFetchWithCache.ts:16](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/core/createFetchWithCache.ts#L16)
 
 单一职责高阶函数：专门用于封装和隔离 activeCacheWrites 并发追踪器。
 

package/docs/functions/extractData.md

@@ -8,7 +8,7 @@
 
 > **extractData**(`source`, `config?`, `defaultAllowed?`): `Record`\<`string`, `string`[]\>
 
-Defined in: [utils/extractData.ts:40](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/utils/extractData.ts#L40)
+Defined in: [packages/proxy/src/utils/extractData.ts:40](https://github.com/isdk/proxy.js/blob/a1563efa4c3081261eb3af8a6404f1b704b33bf1/src/utils/extractData.ts#L40)
 
 从源对象中根据过滤配置提取数据并标准化。
 

package/docs/functions/fetchWithCache.md

@@ -8,19 +8,18 @@
 
 > **fetchWithCache**(`request`, `fetcher`, `options`): `Promise`\<`Response`\>
 
-Defined in: [core/fetchWithCache.ts:370](https://github.com/isdk/proxy.js/blob/76fee3a101f98e5bf29599fe7ea02ab06479cf70/src/core/fetchWithCache.ts#L370)
+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
 
-实现了基于流的混合缓存代理核心逻辑，主要机制包括：
-- **多方法支持与过滤**：支持通过 `allowedMethods` 配置可缓存的方法（如 POST, PUT），并通过 `cacheRules` 进行精细化的路径与参数匹配拦截。
-- **异步 Request Body 处理**：当缓存 POST/PUT 请求时，会自动读取 Body 并计算唯一指纹（支持 JSON 字段过滤）。
-- **大文件流式处理**：底层完全通过 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
 
@@ -28,22 +27,22 @@ Defined in: [core/fetchWithCache.ts:370](https://github.com/isdk/proxy.js/blob/7
 
 `Request`
 
-原始 Web 标准 Request 对象
+标准 Web Request 对象
 
 ### fetcher
 
 (`req`) => `Promise`\<`Response`\>
 
-实际执行网络请求的函数
+底层发起真实请求的函数
 
 ### options
 
 [`FetchWithCacheOptions`](../interfaces/FetchWithCacheOptions.md)
 
-缓存配置选项
+缓存协调配置项
 
 ## Returns
 
 `Promise`\<`Response`\>
 
-带有缓存标识头和流式 Body 的 Response 对象
+标准 Web Response 对象 (带 x-proxy-cache 标头)