Copy for AI

operationToAiText(endpoint) 是一个纯函数(没有 I/O,不依赖 React),把一个标准化后的端点转换成 Copy for AI 按钮背后的那段文本。

operationToAiText

定义在 src/transformers/copy-for-ai.ts 中。输出结构:Purpose → Request → Responses → Error Responses → Validation。

边界情况

边界情况会被显式处理,而不是靠猜:

  • 没有 requestBody → 不生成 Request 部分。
  • 没有声明 4xx/5xx → 不生成 Error Responses 部分。
  • oneOf/anyOf schema → 标注为 (one of N possible shapes),而不是随意挑一个。
  • 没有约束条件的 schema → 不生成 Validation 部分。
  • 没有 summary 的长描述 → 在 Purpose 里截断到两句话。

性能与循环引用

生成耗时始终稳定地远低于 100ms(不会显示加载动画),递归/循环引用的 DTO 也能被安全处理。