答案是：需设计两类结构意图不同的提示词——方向一严格按json字段原始顺序逐级展开生成字段说明表；方向二按业务语义分组（如“用户信息”“订单状态”）归类字段并按重要性排序。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让Gemini在生成接口文档时，把原本返回的JSON示例自动拆解成字段级说明，且要同时输出两种不同组织逻辑的提示词：一种按字段出现顺序逐条解释，另一种按业务语义分组归类（如“用户信息”“订单状态”“支付明细”）。这两种提示词不能只是换词重述，必须体现结构意图差异。
方向一：按JSON字段原始顺序生成字段说明提示词
第一步：复制接口返回的完整JSON示例，确保包含真实值（如{"code":0,"data":{"id":123,"name":"张三"}}），不要用省略号或占位符。
第二步：在提示词开头明确指令：“请严格依据以下JSON响应体，按字段在原文中从上到下的出现顺序，逐个提取字段名、类型、含义、是否必填、示例值，生成字段说明表。字段顺序不可调整，不可合并，不可跳过空字段。”
第三步：粘贴JSON示例后，追加约束条件：若字段值为对象或数组，需递归展开一级子字段（例如data对象下的id和name必须单独列为两条），【未展开子字段将导致字段遗漏】。
方向二：按业务语义分组生成字段说明提示词
方法一：用角色指令锚定分组逻辑
告诉Gemini：“你是一位电商系统API文档工程师，负责将技术响应转化为业务方能理解的说明。请识别该JSON中隐含的3～5个业务实体（如‘订单主信息’‘收货地址’‘优惠详情’），把字段分配到最匹配的实体下，每个实体内字段按重要性降序排列。”
用于在用户想通过浏览器自动化与 Google Gemini 或 ChatGPT 交互时。触发短语包括“ask Gemini”“ask ChatGPT”“ask GPT”“让...”。
方法二：提供分组关键词引导
在JSON示例后直接给出分组线索：“请按以下四类组织字段说明：① 状态控制类（code、msg、success）；② 主体数据类（user、order、product相关字段）；③ 时间与审计类（created_at、updated_by）；④ 扩展配置类（extra、metadata）。不属于这四类的字段归入‘其他’。”
注意：分组名称必须来自业务术语，不能写“第一层字段”“嵌套字段”这类技术表述。
关键区别验证步骤
① 拿到Gemini输出后，立即检查字段总数是否与原始JSON扁平化后的字段数一致——少于该数说明有字段被吞掉。
② 对照两个方向的输出：方向一的首条字段必须是JSON最顶层第一个键（通常是code或status），方向二的首组标题必须是业务名词（如“用户身份信息”），而非技术层级描述。
③ 随机选一个嵌套字段（如data.address.city），确认方向一中它出现在data之后、address之后、city单独成行；方向二中它必须归属在“收货地址”或类似业务组下，且不与data或address并列展示。
