codebuddy 提供 always-present 字段标记功能，通过手动右键、自动检测或 jsonpath 规则标记跨至少3次响应稳定存在的必传字段，支持在响应体高亮、契约视图查看及导出为 openapi 3.0 格式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
接口调试过程中，需要快速识别哪些字段在所有响应中必然存在，CodeBuddy 提供了 always-present 字段标记功能，帮助你验证接口契约一致性——比如后端承诺的必传字段是否真的从未缺失，避免前端因字段突然为空而崩溃。
在 CodeBuddy 响应体中定位目标字段
打开调试完成的请求详情页，点击「Response」标签 → 向下滚动到 JSON 响应体区域 → 找到你想标记为 always-present 的字段名（如 user_id、status），确保它出现在至少 3 条不同响应样本中，且值均非 null 或缺失。
注意：如果该字段只在某次响应里出现过一次，CodeBuddy 不允许标记，系统会提示“未在多条响应中稳定出现”。【必须跨至少 3 次请求确认存在】
右键标记为 always-present
将鼠标悬停在字段名上（例如 "name" 左侧的键名位置，不是值）→ 右键 → 选择「Mark as always-present」。
这一步操作起来很简单，直接右键触发即可。但要注意：若字段处于嵌套对象深层（如 data.profile.avatar.url），必须逐级展开到最后一层键再右键，顶层 data 上右键无效。
批量验证与自动标定
方法一：使用「Auto-detect always-present」快捷扫描
点击响应体右上角「⋯」→ 选择「Detect stable fields」→ CodeBuddy 会自动比对当前接口全部历史响应样本，将出现率 100% 且类型一致的字段高亮为蓝色，并在字段旁显示小徽章「✓ AP」。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
方法二：手动勾选后批量提交
按住 Ctrl（Windows）或 Cmd（Mac）多选多个字段名 → 右键 → 「Mark selected as always-present」→ 弹窗确认后立即生效。
方法三：通过字段路径规则批量匹配
点击「Advanced tagging」→ 输入 JSONPath 表达式，例如 $.data.items[*].id → 点击「Apply to all matches」→ 所有匹配到的 id 字段将统一标记。⚠️ 路径写错会导致零匹配，建议先用在线 JSONPath 测试器验证。
查看与导出标记结果
第一步：在响应体中，已标记字段的键名会变为深蓝色，右侧显示「always-present」灰色标签。
第二步：点击顶部「Schema」标签 → 切换到「Contract View」→ 所有 marked 字段以绿色锁形图标呈现，未标记字段显示为灰色问号图标。
第三步：点击右上角「Export contract」→ 选择「OpenAPI 3.0」格式 → 导出的 YAML 中，对应字段的 required 数组将自动包含这些键名，且 x-always-present: true 扩展属性被写入 schema。
