一、核心规则

1. 依赖包：ohos.request，必须声明权限：ohos.permission.INTERNET
2. 不支持抓包工具（Charles/Fiddler）、不支持子线程（TaskPool）调用
3. 两种实现：request.xxxFile（简易）、request.agent（功能更强）

二、上传文件

1. request.uploadFile

• 仅支持：应用缓存目录 cacheDir
• URI 格式：internal://cache/文件名

2. request.agent.create

• 支持：公共文件 + 应用缓存目录
• 需手动管理任务：完成后 request.agent.remove(task.tid)

三、下载文件（三类场景）

1. 下载到应用内部目录

• 两种方式：request.downloadFile / request.agent
• 路径：context.cacheDir 或文件目录

2. 下载到用户公共文件（API 20+）

• 文档：DocumentViewPicker.save() 获取 URI
• 音频：AudioViewPicker.save() 获取 URI
• 图片 / 视频：PhotoAccessHelper.createAsset()，需权限 ohos.permission.WRITE_IMAGEVIDEO

3. 速度与超时限制（API 18+/20+）

• task.setMaxSpeed()：设置最大速度
• config.minSpeed：最低限速 + 超时判定
• config.timeout：连接超时 + 总超时

四、高级配置

1. HTTP 拦截 配置文件：src/main/resources/base/profile/network_config.json 控制明文 HTTP 是否允许
2. 通知栏跳转（API 22+） 配合 WantAgent，在 notification.wantAgent 配置跳转目标 Ability

五、一句话速记

用 ohos.request 做上传下载，必须加网络权限；简单场景用 uploadFile/downloadFile，复杂 / 公共文件用 agent，下载到用户相册需对应 Picker/PhotoHelper + 权限，可限速、超时、配置 HTTP 与通知跳转。