#Request 设计草案

Design Preview / Unreleased：本页只记录尚未进入完整用户契约的 request 设计选择，不是生产导入说明。

#目标

request runtime 是 commflow 计划落地的第一个真实运行时模块。它的目标是把常见请求编排能力抽到框架无关 core 中，同时让 VextJS 成为首个重点接入对象。

#现在可以做什么

当前你可以：

• 安装 commflow
• 阅读已发布的 Manifest API
• 查看 request descriptor
• 比较尚未稳定的 request 设计选择

#现在不要导入什么

不要从 commflow@0.0.2 导入 request runtime 名称。当前包还没有导出 request client、retry policy、timeout helper、proxy selector、hook runner 或 VextJS adapter。

如果你只是想验证当前包是否可用，请使用 快速上手。

#计划能力

当前设计方向包括：

• timeout 处理
• 网络错误与 response-based failure 的 retry
• trace 与 metadata 传播
• proxy 选择
• safe observer 生命周期 hook
• 标准化 request failure

#Hook 语义

观察型 hook 默认应该是 safe 的：secondary hook failure 应该被记录或透出诊断信息，但不应把一个已经成功的请求升级成失败请求。

#本页刻意不承诺什么

本页不承诺：

• 已发布的 request client import path
• 已定稿的 options object
• 从 VextJS app.fetch 迁移的步骤
• timeout、retry、proxy 或 hook 行为的生产可用支持

这些细节只有在 当前版本快速开始 和 release notes 明确列为已发布后，才能作为生产导入依据。

#如何判断已经可用

以当前版本文档为准：只有当 import path、options、返回结构与失败行为进入 当前版本快速开始 或对应版本 API 参考时，才能在应用中使用。完整任务说明始终以 Request 为准。