@open-dy/vibecoding-sdk-taro 0.1.12 → 0.1.13

package/dist/adapters/interest-card/runtime/microapp.d.ts

@@ -4,4 +4,4 @@
  * 此适配层只提供稳定的兴趣卡导入路径；请求、登录和传输能力仍由通用
  * microapp Runtime 实现，避免在业务域内复制基础逻辑。
  */
-export { clearDouyinLoginAuth, createMicroappClient, type CreateMicroappClientOptions, } from '../../../runtime/index.js';
+export { clearDouyinLoginAuth, createMicroappClient, prepareImageForUpload, type CreateMicroappClientOptions, type PreparedImageForUpload, } from '../../../runtime/index.js';

package/dist/adapters/interest-card/runtime/microapp.js

@@ -4,5 +4,5 @@
  * 此适配层只提供稳定的兴趣卡导入路径；请求、登录和传输能力仍由通用
  * microapp Runtime 实现，避免在业务域内复制基础逻辑。
  */
-export { clearDouyinLoginAuth, createMicroappClient, } from '../../../runtime/index.js';
+export { clearDouyinLoginAuth, createMicroappClient, prepareImageForUpload, } from '../../../runtime/index.js';
 //# sourceMappingURL=microapp.js.map

package/dist/adapters/interest-card/runtime/microapp.js.map

@@ -1 +1 @@
-{"version":3,"file":"microapp.js","sourceRoot":"","sources":["../../../../src/adapters/interest-card/runtime/microapp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,2BAA2B,CAAA"}
+{"version":3,"file":"microapp.js","sourceRoot":"","sources":["../../../../src/adapters/interest-card/runtime/microapp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GAGtB,MAAM,2BAA2B,CAAA"}

package/dist/reference/llms.txt

@@ -14,7 +14,9 @@ Companion libraries are separate project dependencies, imported from their own p
 ## APIs
 
 - [createMicroappClient](./sdk-api/runtime/createMicroappClient.md): 创建普通小程序的网络入口；SDK 自动绑定项目 Taro 运行时。 Import: `@open-dy/vibecoding-sdk-taro/runtime`.
-- [CreateMicroappClientOptions](./sdk-api/runtime/CreateMicroappClientOptions.md): 配置普通小程序 Network 的平台渠道。 Import: `@open-dy/vibecoding-sdk-taro/runtime`.
+- [CreateMicroappClientOptions](./sdk-api/runtime/CreateMicroappClientOptions.md): 配置普通小程序 Network 的平台渠道和真机预览上传环境。 Import: `@open-dy/vibecoding-sdk-taro/runtime`.
+- [prepareImageForUpload](./sdk-api/runtime/prepareImageForUpload.md): 显式预处理本地 JPEG，返回上传路径和诊断信息。 Import: `@open-dy/vibecoding-sdk-taro/runtime`.
+- [PreparedImageForUpload](./sdk-api/runtime/PreparedImageForUpload.md): 图片上传应使用的本地路径，以及可取得的压缩诊断信息。 Import: `@open-dy/vibecoding-sdk-taro/runtime`.
 - [MiniappOpenCard](./sdk-api/components/miniapp-open-card/MiniappOpenCard.md): 承载同一 OpenCard；SDK 选择环境版本并为空初始化参数提供对象，错误类型直接报错。 Import: `@open-dy/vibecoding-sdk-taro/components/miniapp-open-card`.
 - [MiniappOpenCardProps](./sdk-api/components/miniapp-open-card/MiniappOpenCardProps.md): 普通 Taro 宿主的内嵌卡属性；沿用 StandardProps，但不接受 children 或 envVersion。 Import: `@open-dy/vibecoding-sdk-taro/components/miniapp-open-card`.
 - [MiniappOpenCardErrorDetail](./sdk-api/components/miniapp-open-card/MiniappOpenCardErrorDetail.md): 内嵌卡加载错误的事件 detail；可选错误字段由平台提供。 Import: `@open-dy/vibecoding-sdk-taro/components/miniapp-open-card`.

package/dist/reference/sdk-api/runtime/CreateMicroappClientOptions.md

@@ -7,7 +7,7 @@
 
 #### 说明
 
-配置普通小程序 Network 的平台渠道。
+配置普通小程序 Network 的平台渠道和真机预览上传环境。
 
 示例：
 
@@ -34,6 +34,7 @@ const options = { platformChannel: 'ext' as const }
 ```ts
 export interface CreateMicroappClientOptions {
     platformChannel?: '' | 'ext';
+    previewUploadEnvType?: 'development';
 }
 ```
 
@@ -50,3 +51,4 @@ CreateMicroappClientOptions
 | 字段 | 类型 | 说明 |
 | --- | --- | --- |
 | platformChannel? | `"" \| "ext" \| undefined` | 平台渠道：空字符串为内场，ext 为外场；默认空字符串。 |
+| previewUploadEnvType? | `"development" \| undefined` | 设置为 development 时，真机扫码预览的托管上传使用抖音云开发环境。 |

package/dist/reference/sdk-api/runtime/PreparedImageForUpload.md

@@ -0,0 +1,52 @@
+# PreparedImageForUpload
+
+<!-- Generated by packages/sdk-tooling/src/reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/runtime`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/runtime/image-upload-preparation.ts`（仅补缺或排错时读取）。
+
+#### 说明
+
+图片上传应使用的本地路径，以及可取得的压缩诊断信息。
+
+示例：
+
+```ts
+const { filePath, reason } = await prepareImageForUpload(tempFilePath)
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 读取静默压缩选出的路径和诊断信息。 |
+| 适用时机 | 既有调用方需要读取显式预处理的结果时。 |
+| 避免 | 不要把压缩诊断用作上传错误或用户提示。 |
+
+#### 声明
+
+```ts
+export interface PreparedImageForUpload {
+    filePath: string;
+    originalBytes?: number;
+    bytes?: number;
+    reason: 'compressed' | 'below-target' | 'unsupported' | 'not-jpeg' | 'input-budget' | 'busy' | 'invalid-image' | 'no-benefit' | 'timeout' | 'failed';
+}
+```
+
+### PreparedImageForUpload 的类型契约
+
+#### 类型
+
+```ts
+PreparedImageForUpload
+```
+
+#### 字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| filePath | `string` | 最终上传使用的本地文件路径。 |
+| originalBytes? | `number \| undefined` | 原文件实际大小，单位字节。未取得时为 undefined。 |
+| bytes? | `number \| undefined` | 最终文件实际大小，单位字节。未取得时为 undefined。 |
+| reason | `"timeout" \| "compressed" \| "below-target" \| "unsupported" \| "not-jpeg" \| "input-budget" \| "busy" \| "invalid-image" \| "no-benefit" \| "failed"` | 压缩采用或使用原文件的原因。 |

package/dist/reference/sdk-api/runtime/createMicroappClient.md

@@ -13,11 +13,11 @@
 
 | 名称 | 说明 |
 | --- | --- |
-| `options` | 平台渠道配置；默认使用内场渠道。 |
+| `options` | 平台渠道和真机预览上传环境配置。默认使用内场渠道。 |
 
 返回：仅提供普通小程序的 request、uploadFile、downloadFile 和 streamSse。
 
-备注：业务优先从模板的 @/network 导入 Network；HTTP(S) 绝对地址直接交给 Taro。宿主需要封闭域功能时通过 MiniappOpenCard 承载，请求与数据处理仅在卡内完成。streamSse 返回的是流句柄，Promise resolve 不代表生成完成。正常关闭仅调用一次 onComplete；流错误仅调用一次 onError(Error)，随后释放任务；close() 主动取消仅调用一次可选的 onCancel，不调用 onComplete/onError。业务须在对应终态回调中清理 loading，不能把 onComplete 当通用 finally；终态后的消息与重复事件会被忽略。创建任务前的失败仍通过 Promise rejection 交付。
+备注：业务优先从模板的 @/network 导入 Network。uploadFile 在支持原生图片处理的抖音小程序中自动尝试压缩符合条件的本地 JPEG，各上传路由均适用。业务直接传入原始 filePath。HTTP(S) 绝对地址仍由 Taro 传输。宿主需要封闭域功能时通过 MiniappOpenCard 承载，请求与数据处理仅在卡内完成。streamSse 返回的是流句柄，Promise resolve 不代表生成完成。正常关闭仅调用一次 onComplete；流错误仅调用一次 onError(Error)，随后释放任务；close() 主动取消仅调用一次可选的 onCancel，不调用 onComplete/onError。业务须在对应终态回调中清理 loading，不能把 onComplete 当通用 finally；终态后的消息与重复事件会被忽略。创建任务前的失败仍通过 Promise rejection 交付。
 
 示例：
 
@@ -61,13 +61,14 @@ function createMicroappClient(options?: CreateMicroappClientOptions);
 
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| options? | `CreateMicroappClientOptions` | 平台渠道配置；默认使用内场渠道。 |
+| options? | `CreateMicroappClientOptions` | 平台渠道和真机预览上传环境配置。默认使用内场渠道。 |
 
 ##### options 字段
 
 | 字段 | 类型 | 说明 |
 | --- | --- | --- |
 | platformChannel? | `"" \| "ext" \| undefined` | 平台渠道：空字符串为内场，ext 为外场；默认空字符串。 |
+| previewUploadEnvType? | `"development" \| undefined` | 设置为 development 时，真机扫码预览的托管上传使用抖音云开发环境。 |
 
 #### 返回值
 

package/dist/reference/sdk-api/runtime/index.md

@@ -7,4 +7,6 @@
 | API | 说明 | 文档 |
 | --- | --- | --- |
 | `createMicroappClient` | 创建普通小程序的网络入口；SDK 自动绑定项目 Taro 运行时。 | [查看](./createMicroappClient.md) |
-| `CreateMicroappClientOptions` | 配置普通小程序 Network 的平台渠道。 | [查看](./CreateMicroappClientOptions.md) |
+| `CreateMicroappClientOptions` | 配置普通小程序 Network 的平台渠道和真机预览上传环境。 | [查看](./CreateMicroappClientOptions.md) |
+| `prepareImageForUpload` | 显式预处理本地 JPEG，返回上传路径和诊断信息。 | [查看](./prepareImageForUpload.md) |
+| `PreparedImageForUpload` | 图片上传应使用的本地路径，以及可取得的压缩诊断信息。 | [查看](./PreparedImageForUpload.md) |

package/dist/reference/sdk-api/runtime/prepareImageForUpload.md

@@ -0,0 +1,69 @@
+# prepareImageForUpload
+
+<!-- Generated by packages/sdk-tooling/src/reference/skill-reference.ts. Do not edit. -->
+
+导入路径：`@open-dy/vibecoding-sdk-taro/runtime`
+源码：实际安装的 `@open-dy/vibecoding-sdk-taro` 包内 `src/runtime/image-upload-preparation.ts`（仅补缺或排错时读取）。
+
+#### 说明
+
+显式预处理本地 JPEG，返回上传路径和诊断信息。
+
+返回：上传路径及诊断信息，降级时返回原路径。
+
+备注：Network.uploadFile 会自动预处理符合条件的 JPEG。此方法兼容已有显式调用。压缩结果由宿主临时保存，能力缺失或超时时沿用原路径或已验证的候选。
+
+示例：
+
+```ts
+const prepared = await prepareImageForUpload(tempFilePath)
+console.log(prepared.bytes, prepared.reason)
+```
+
+#### AI 使用约束
+
+| 规则 | 内容 |
+| --- | --- |
+| 意图 | 兼容已有的本地 JPEG 显式预处理。 |
+| 适用时机 | 维护已使用显式预处理或需要其诊断信息的调用方时。 |
+| 避免 | 不要为使用新版 Network.uploadFile 的新业务再接一层手动预处理。 |
+
+示例：
+
+```ts
+const prepared = await prepareImageForUpload(tempFilePath)
+```
+
+#### 声明
+
+```ts
+function prepareImageForUpload(filePath: string): Promise<PreparedImageForUpload>;
+```
+
+### prepareImageForUpload 的类型契约
+
+#### 工厂签名
+
+```ts
+(filePath: string): Promise<PreparedImageForUpload>
+```
+
+#### 参数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| filePath | `string` | 选图或拍摄获得的本地文件路径。 |
+
+#### 返回值
+
+- 类型：`Promise<PreparedImageForUpload>`
+- Promise resolve 类型：`PreparedImageForUpload`
+
+##### 字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| filePath | `string` | 最终上传使用的本地文件路径。 |
+| originalBytes? | `number \| undefined` | 原文件实际大小，单位字节。未取得时为 undefined。 |
+| bytes? | `number \| undefined` | 最终文件实际大小，单位字节。未取得时为 undefined。 |
+| reason | `"timeout" \| "compressed" \| "below-target" \| "unsupported" \| "not-jpeg" \| "input-budget" \| "busy" \| "invalid-image" \| "no-benefit" \| "failed"` | 压缩采用或使用原文件的原因。 |

package/dist/reference/sdk-api.json

@@ -99,12 +99,12 @@
         "parameters": [
           {
             "name": "options",
-            "description": "平台渠道配置；默认使用内场渠道。"
+            "description": "平台渠道和真机预览上传环境配置。默认使用内场渠道。"
           }
         ],
         "returns": "仅提供普通小程序的 request、uploadFile、downloadFile 和 streamSse。",
         "remarks": [
-          "业务优先从模板的 @/network 导入 Network；HTTP(S) 绝对地址直接交给 Taro。宿主需要封闭域功能时通过 MiniappOpenCard 承载，请求与数据处理仅在卡内完成。streamSse 返回的是流句柄，Promise resolve 不代表生成完成。正常关闭仅调用一次 onComplete；流错误仅调用一次 onError(Error)，随后释放任务；close() 主动取消仅调用一次可选的 onCancel，不调用 onComplete/onError。业务须在对应终态回调中清理 loading，不能把 onComplete 当通用 finally；终态后的消息与重复事件会被忽略。创建任务前的失败仍通过 Promise rejection 交付。"
+          "业务优先从模板的 @/network 导入 Network。uploadFile 在支持原生图片处理的抖音小程序中自动尝试压缩符合条件的本地 JPEG，各上传路由均适用。业务直接传入原始 filePath。HTTP(S) 绝对地址仍由 Taro 传输。宿主需要封闭域功能时通过 MiniappOpenCard 承载，请求与数据处理仅在卡内完成。streamSse 返回的是流句柄，Promise resolve 不代表生成完成。正常关闭仅调用一次 onComplete；流错误仅调用一次 onError(Error)，随后释放任务；close() 主动取消仅调用一次可选的 onCancel，不调用 onComplete/onError。业务须在对应终态回调中清理 loading，不能把 onComplete 当通用 finally；终态后的消息与重复事件会被忽略。创建任务前的失败仍通过 Promise rejection 交付。"
         ],
         "examples": [
           {
@@ -128,13 +128,19 @@
             "name": "options",
             "optional": true,
             "type": "CreateMicroappClientOptions",
-            "description": "平台渠道配置；默认使用内场渠道。",
+            "description": "平台渠道和真机预览上传环境配置。默认使用内场渠道。",
             "fields": [
               {
                 "name": "platformChannel",
                 "optional": true,
                 "type": "\"\" | \"ext\" | undefined",
                 "description": "平台渠道：空字符串为内场，ext 为外场；默认空字符串。"
+              },
+              {
+                "name": "previewUploadEnvType",
+                "optional": true,
+                "type": "\"development\" | undefined",
+                "description": "设置为 development 时，真机扫码预览的托管上传使用抖音云开发环境。"
               }
             ]
           }
@@ -734,9 +740,9 @@
       "importPath": "@open-dy/vibecoding-sdk-taro/runtime",
       "source": "src/runtime/client.ts",
       "docPath": "sdk-api/runtime/CreateMicroappClientOptions.md",
-      "summary": "配置普通小程序 Network 的平台渠道。",
+      "summary": "配置普通小程序 Network 的平台渠道和真机预览上传环境。",
       "documentation": {
-        "summary": "配置普通小程序 Network 的平台渠道。",
+        "summary": "配置普通小程序 Network 的平台渠道和真机预览上传环境。",
         "examples": [
           {
             "language": "ts",
@@ -750,7 +756,7 @@
         "avoid": "不要在业务页面直接拼接渠道请求头。",
         "example": "{ platformChannel: 'ext' }"
       },
-      "signature": "export interface CreateMicroappClientOptions {\n    platformChannel?: '' | 'ext';\n}",
+      "signature": "export interface CreateMicroappClientOptions {\n    platformChannel?: '' | 'ext';\n    previewUploadEnvType?: 'development';\n}",
       "contract": {
         "kind": "type",
         "type": "CreateMicroappClientOptions",
@@ -760,6 +766,138 @@
             "optional": true,
             "type": "\"\" | \"ext\" | undefined",
             "description": "平台渠道：空字符串为内场，ext 为外场；默认空字符串。"
+          },
+          {
+            "name": "previewUploadEnvType",
+            "optional": true,
+            "type": "\"development\" | undefined",
+            "description": "设置为 development 时，真机扫码预览的托管上传使用抖音云开发环境。"
+          }
+        ]
+      }
+    },
+    {
+      "id": "runtime.prepareImageForUpload",
+      "name": "prepareImageForUpload",
+      "importPath": "@open-dy/vibecoding-sdk-taro/runtime",
+      "source": "src/runtime/image-upload-preparation.ts",
+      "docPath": "sdk-api/runtime/prepareImageForUpload.md",
+      "summary": "显式预处理本地 JPEG，返回上传路径和诊断信息。",
+      "documentation": {
+        "summary": "显式预处理本地 JPEG，返回上传路径和诊断信息。",
+        "returns": "上传路径及诊断信息，降级时返回原路径。",
+        "remarks": [
+          "Network.uploadFile 会自动预处理符合条件的 JPEG。此方法兼容已有显式调用。压缩结果由宿主临时保存，能力缺失或超时时沿用原路径或已验证的候选。"
+        ],
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const prepared = await prepareImageForUpload(tempFilePath)\nconsole.log(prepared.bytes, prepared.reason)"
+          }
+        ]
+      },
+      "ai": {
+        "intent": "兼容已有的本地 JPEG 显式预处理。",
+        "when": "维护已使用显式预处理或需要其诊断信息的调用方时。",
+        "avoid": "不要为使用新版 Network.uploadFile 的新业务再接一层手动预处理。",
+        "example": "const prepared = await prepareImageForUpload(tempFilePath)"
+      },
+      "signature": "function prepareImageForUpload(filePath: string): Promise<PreparedImageForUpload>;",
+      "contract": {
+        "kind": "callable",
+        "signature": "(filePath: string): Promise<PreparedImageForUpload>",
+        "parameters": [
+          {
+            "name": "filePath",
+            "optional": false,
+            "type": "string",
+            "description": "选图或拍摄获得的本地文件路径。"
+          }
+        ],
+        "returns": {
+          "type": "Promise<PreparedImageForUpload>",
+          "promise": true,
+          "resolvesTo": "PreparedImageForUpload",
+          "fields": [
+            {
+              "name": "filePath",
+              "optional": false,
+              "type": "string",
+              "description": "最终上传使用的本地文件路径。"
+            },
+            {
+              "name": "originalBytes",
+              "optional": true,
+              "type": "number | undefined",
+              "description": "原文件实际大小，单位字节。未取得时为 undefined。"
+            },
+            {
+              "name": "bytes",
+              "optional": true,
+              "type": "number | undefined",
+              "description": "最终文件实际大小，单位字节。未取得时为 undefined。"
+            },
+            {
+              "name": "reason",
+              "optional": false,
+              "type": "\"timeout\" | \"compressed\" | \"below-target\" | \"unsupported\" | \"not-jpeg\" | \"input-budget\" | \"busy\" | \"invalid-image\" | \"no-benefit\" | \"failed\"",
+              "description": "压缩采用或使用原文件的原因。"
+            }
+          ]
+        },
+        "methods": []
+      }
+    },
+    {
+      "id": "runtime.PreparedImageForUpload",
+      "name": "PreparedImageForUpload",
+      "importPath": "@open-dy/vibecoding-sdk-taro/runtime",
+      "source": "src/runtime/image-upload-preparation.ts",
+      "docPath": "sdk-api/runtime/PreparedImageForUpload.md",
+      "summary": "图片上传应使用的本地路径，以及可取得的压缩诊断信息。",
+      "documentation": {
+        "summary": "图片上传应使用的本地路径，以及可取得的压缩诊断信息。",
+        "examples": [
+          {
+            "language": "ts",
+            "code": "const { filePath, reason } = await prepareImageForUpload(tempFilePath)"
+          }
+        ]
+      },
+      "ai": {
+        "intent": "读取静默压缩选出的路径和诊断信息。",
+        "when": "既有调用方需要读取显式预处理的结果时。",
+        "avoid": "不要把压缩诊断用作上传错误或用户提示。",
+        "example": "const { filePath, reason } = await prepareImageForUpload(tempFilePath)"
+      },
+      "signature": "export interface PreparedImageForUpload {\n    filePath: string;\n    originalBytes?: number;\n    bytes?: number;\n    reason: 'compressed' | 'below-target' | 'unsupported' | 'not-jpeg' | 'input-budget' | 'busy' | 'invalid-image' | 'no-benefit' | 'timeout' | 'failed';\n}",
+      "contract": {
+        "kind": "type",
+        "type": "PreparedImageForUpload",
+        "fields": [
+          {
+            "name": "filePath",
+            "optional": false,
+            "type": "string",
+            "description": "最终上传使用的本地文件路径。"
+          },
+          {
+            "name": "originalBytes",
+            "optional": true,
+            "type": "number | undefined",
+            "description": "原文件实际大小，单位字节。未取得时为 undefined。"
+          },
+          {
+            "name": "bytes",
+            "optional": true,
+            "type": "number | undefined",
+            "description": "最终文件实际大小，单位字节。未取得时为 undefined。"
+          },
+          {
+            "name": "reason",
+            "optional": false,
+            "type": "\"timeout\" | \"compressed\" | \"below-target\" | \"unsupported\" | \"not-jpeg\" | \"input-budget\" | \"busy\" | \"invalid-image\" | \"no-benefit\" | \"failed\"",
+            "description": "压缩采用或使用原文件的原因。"
           }
         ]
       }

package/dist/reference/sdk-api.md

@@ -44,6 +44,8 @@
 - [runtime](sdk-api/runtime/index.md)
   - `createMicroappClient`
   - `CreateMicroappClientOptions`
+  - `prepareImageForUpload`
+  - `PreparedImageForUpload`
 - [components/miniapp-open-card](sdk-api/components/miniapp-open-card/index.md)
   - `MiniappOpenCard`
   - `MiniappOpenCardProps`

package/dist/runtime/client.d.ts

@@ -1,5 +1,5 @@
 /**
- * @desc 配置普通小程序 Network 的平台渠道。
+ * @desc 配置普通小程序 Network 的平台渠道和真机预览上传环境。
  * @example
  * ```ts
  * const options = { platformChannel: 'ext' as const }
@@ -12,6 +12,8 @@
 export interface CreateMicroappClientOptions {
     /** @desc 平台渠道：空字符串为内场，ext 为外场；默认空字符串。 */
     platformChannel?: '' | 'ext';
+    /** @desc 设置为 development 时，真机扫码预览的托管上传使用抖音云开发环境。 */
+    previewUploadEnvType?: 'development';
 }
 /**
  * 网络请求模块

package/dist/runtime/client.js

@@ -1,7 +1,9 @@
-import { canUseDouyinContainer, downloadByDouyinContainer, isDouyinMiniProgram, isDouyinPreviewEnv, isWebPreviewEnv, requestByDouyinContainer, requestSSEByDouyinContainer, uploadByDouyinContainer, } from './douyin-container-request.js';
+import { canUseDouyinContainer, downloadByDouyinContainer, isDouyinMiniProgram, isDouyinNativePreviewEnv, isDouyinPreviewEnv, isWebPreviewEnv, requestByDouyinContainer, requestSSEByDouyinContainer, uploadByDouyinContainer, } from './douyin-container-request.js';
 import { mergeCachedDouyinLoginHeaders, requestByDouyinLogin, requestSSEByDouyinLogin, requestSSEByFetch, setDouyinLoginPlatformChannel, uploadByDouyinLogin, downloadByDouyinLogin, } from './douyin-login-request.js';
 import { mergeIframeIdentityHeaders } from '../internal/runtime/iframe-auth/index.js';
-import { appendGetQuery, createUrl } from './network-url.js';
+import { canPrepareImageForUpload, prepareUploadFilePath } from './image-upload-preparation.js';
+import { appendGetQuery, createUrl, getManagedUploadError } from './network-url.js';
+import { startPreparedUploadTask } from './prepared-upload-task.js';
 /**
  * 网络请求模块
  * 封装 Taro.request、Taro.uploadFile、Taro.downloadFile。
@@ -64,7 +66,7 @@ export function createMicroappClient(taro, options = {}) {
         });
         return promise;
     });
-    const uploadFile = ((option) => {
+    const startUpload = (option) => {
         if (!option.url) {
             option.url = '';
         }
@@ -75,14 +77,27 @@ export function createMicroappClient(taro, options = {}) {
         if (!option.name) {
             option.name = 'file';
         }
+        if (options.previewUploadEnvType === 'development' && isDouyinNativePreviewEnv()) {
+            return uploadByDouyinContainer(option, options.previewUploadEnvType);
+        }
         if (isDouyinMiniProgram() &&
             !isWebPreviewEnv() &&
             !isDouyinPreviewEnv() &&
-            canUseDouyinContainer() &&
-            !/^http(s)?:\/\//.test(option.url)) {
+            canUseDouyinContainer()) {
             return uploadByDouyinContainer(option);
         }
         return uploadByDouyinLogin(option);
+    };
+    const uploadFile = ((option) => {
+        if (getManagedUploadError(option) || !canPrepareImageForUpload(option.filePath)) {
+            return startUpload(option);
+        }
+        const uploadOption = { ...option };
+        const preparedPath = prepareUploadFilePath(uploadOption.filePath);
+        if (/^https?:\/\//.test(uploadOption.url ?? '')) {
+            return startPreparedUploadTask(uploadOption, preparedPath, prepared => taro.uploadFile(prepared));
+        }
+        return preparedPath.then(filePath => startUpload({ ...uploadOption, filePath }));
     });
     const downloadFile = ((option) => {
         if (!option.url) {

package/dist/runtime/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/runtime/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/runtime/client.ts"],"names":[],"mappings":"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"}

package/dist/runtime/default-client.d.ts

@@ -2,9 +2,9 @@ import Taro from '@tarojs/taro';
 import { type CreateMicroappClientOptions } from './client.js';
 /**
  * @desc 创建普通小程序的网络入口；SDK 自动绑定项目 Taro 运行时。
- * @params {CreateMicroappClientOptions} [options] 平台渠道配置；默认使用内场渠道。
+ * @params {CreateMicroappClientOptions} [options] 平台渠道和真机预览上传环境配置。默认使用内场渠道。
  * @return {ReturnType<typeof createMicroappClient>} 仅提供普通小程序的 request、uploadFile、downloadFile 和 streamSse。
- * @remarks 业务优先从模板的 @/network 导入 Network；HTTP(S) 绝对地址直接交给 Taro。宿主需要封闭域功能时通过 MiniappOpenCard 承载，请求与数据处理仅在卡内完成。streamSse 返回的是流句柄，Promise resolve 不代表生成完成。正常关闭仅调用一次 onComplete；流错误仅调用一次 onError(Error)，随后释放任务；close() 主动取消仅调用一次可选的 onCancel，不调用 onComplete/onError。业务须在对应终态回调中清理 loading，不能把 onComplete 当通用 finally；终态后的消息与重复事件会被忽略。创建任务前的失败仍通过 Promise rejection 交付。
+ * @remarks 业务优先从模板的 @/network 导入 Network。uploadFile 在支持原生图片处理的抖音小程序中自动尝试压缩符合条件的本地 JPEG，各上传路由均适用。业务直接传入原始 filePath。HTTP(S) 绝对地址仍由 Taro 传输。宿主需要封闭域功能时通过 MiniappOpenCard 承载，请求与数据处理仅在卡内完成。streamSse 返回的是流句柄，Promise resolve 不代表生成完成。正常关闭仅调用一次 onComplete；流错误仅调用一次 onError(Error)，随后释放任务；close() 主动取消仅调用一次可选的 onCancel，不调用 onComplete/onError。业务须在对应终态回调中清理 loading，不能把 onComplete 当通用 finally；终态后的消息与重复事件会被忽略。创建任务前的失败仍通过 Promise rejection 交付。
  * @example
  * ```ts
  * const Network = createMicroappClient({ platformChannel: 'ext' })

package/dist/runtime/default-client.js

@@ -2,9 +2,9 @@ import Taro from '@tarojs/taro';
 import { createMicroappClient as createMicroappClientWithTaro, } from './client.js';
 /**
  * @desc 创建普通小程序的网络入口；SDK 自动绑定项目 Taro 运行时。
- * @params {CreateMicroappClientOptions} [options] 平台渠道配置；默认使用内场渠道。
+ * @params {CreateMicroappClientOptions} [options] 平台渠道和真机预览上传环境配置。默认使用内场渠道。
  * @return {ReturnType<typeof createMicroappClient>} 仅提供普通小程序的 request、uploadFile、downloadFile 和 streamSse。
- * @remarks 业务优先从模板的 @/network 导入 Network；HTTP(S) 绝对地址直接交给 Taro。宿主需要封闭域功能时通过 MiniappOpenCard 承载，请求与数据处理仅在卡内完成。streamSse 返回的是流句柄，Promise resolve 不代表生成完成。正常关闭仅调用一次 onComplete；流错误仅调用一次 onError(Error)，随后释放任务；close() 主动取消仅调用一次可选的 onCancel，不调用 onComplete/onError。业务须在对应终态回调中清理 loading，不能把 onComplete 当通用 finally；终态后的消息与重复事件会被忽略。创建任务前的失败仍通过 Promise rejection 交付。
+ * @remarks 业务优先从模板的 @/network 导入 Network。uploadFile 在支持原生图片处理的抖音小程序中自动尝试压缩符合条件的本地 JPEG，各上传路由均适用。业务直接传入原始 filePath。HTTP(S) 绝对地址仍由 Taro 传输。宿主需要封闭域功能时通过 MiniappOpenCard 承载，请求与数据处理仅在卡内完成。streamSse 返回的是流句柄，Promise resolve 不代表生成完成。正常关闭仅调用一次 onComplete；流错误仅调用一次 onError(Error)，随后释放任务；close() 主动取消仅调用一次可选的 onCancel，不调用 onComplete/onError。业务须在对应终态回调中清理 loading，不能把 onComplete 当通用 finally；终态后的消息与重复事件会被忽略。创建任务前的失败仍通过 Promise rejection 交付。
  * @example
  * ```ts
  * const Network = createMicroappClient({ platformChannel: 'ext' })

package/dist/runtime/douyin-container-request.d.ts

@@ -1,11 +1,12 @@
 import Taro from "@tarojs/taro";
 export declare const isDouyinMiniProgram: () => boolean;
 export declare const isDouyinPreviewEnv: () => boolean;
+export declare const isDouyinNativePreviewEnv: () => boolean;
 export declare const isDouyinTestEnv: () => boolean;
-export declare const getDouyinCloud: () => DouyinCloudInstance | null;
+export declare const getDouyinCloud: () => DouyinMiniProgramCloudInstance | null;
 export declare const canUseDouyinContainer: () => boolean;
 export declare const requestByDouyinContainer: (option: Taro.request.Option<any, any>) => ReturnType<typeof Taro.request>;
 export declare const isWebPreviewEnv: () => boolean;
 export declare const requestSSEByDouyinContainer: (option: Taro.request.Option<any, any>) => Promise<EventSourceTask>;
-export declare const uploadByDouyinContainer: (option: Taro.uploadFile.Option) => Promise<never> | Taro.RequestTask<unknown>;
+export declare const uploadByDouyinContainer: (option: Taro.uploadFile.Option, envType?: "development") => Promise<Taro.uploadFile.SuccessCallbackResult>;
 export declare const downloadByDouyinContainer: (option: Taro.downloadFile.Option) => Taro.RequestTask<unknown> | Taro.DownloadTask.DownloadTaskPromise;