CodeBuddy通过Network Sniffer捕获多轮差异化请求响应，自动合并分析生成带联合类型的TS接口：必填字段标为required，空值字段加| null，缺失字段不声明，保存前需确保目标目录已存在。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在前后端联调时，用真实接口响应自动推导出既准确又抗变化的 TypeScript 类型定义，避免手动写错字段可选性、空值容忍或动态键名导致编译通过但运行报错。
启用 Network Sniffer 捕获真实流量
打开 CodeBuddy → 左侧导航栏点击「Network」→ 点击「Start Sniffing」按钮。此时 CodeBuddy 启动本地 HTTP 代理服务，默认监听 http://localhost:8081。
确保前端应用已配置代理：若使用 vite，需在 vite.config.ts 中设置 server.proxy['/api'] = { target: 'http://localhost:8081', changeOrigin: true }; 若为浏览器直连后端，需手动在浏览器开发者工具 Network → 右键请求 → Copy as cURL → 修改 URL host 为 localhost:8081 后粘贴执行。
这一步不配置代理，所有请求将绕过 CodeBuddy，后续无法捕获任何流量——【代理配置是唯一前提，缺省即失效】。
触发多轮差异化请求以覆盖字段变异性
在浏览器或前端页面中，依次触发同一接口的至少三次调用，参数组合必须明显不同：
① 查询用户 ID = 1（返回完整 profile，avatar 字段非空，roles 数组含两项）；
② 查询用户 ID = 999（返回 404 响应，data 字段为 null，message 字段存在）；
php获得文件的mime type类
php获得文件的mime type类
下载
③ 查询用户 ID = null 或留空（触发后端默认逻辑，返回精简字段，extraInfo 键完全缺失）。
只发一次请求，CodeBuddy 会把所有字段都标为必填，遇到后端字段动态裁剪就会运行时报 undefined 错误。三次不是凑数，是让系统识别 always-present / sometimes-null / occasionally-missing 三类字段行为。
分析并生成带联合类型的 TS 接口
回到 CodeBuddy Network 面板 → 点击右上角「Analyze Traffic & Generate Types」。
系统自动合并三次响应体，对每个字段标注稳定性等级：id 和 name 被标记为 required，avatar 标为 string | null，extraInfo 不出现在最终 interface 中（因未在任一响应里出现），而 roles 自动推导为 string[] | undefined。
预览区显示生成结果后，点击「Save as TS Interface」→ 在弹窗路径框中输入 src/types/generated/api/user-detail.ts → 点击确定。
【目标目录必须提前存在】，CodeBuddy 不创建父级文件夹，路径 src/types/generated/ 若不存在，保存操作直接失败且无提示。