百度文库ai生成的表格字段说明须强制执行四类可验证检查：类型严格对照swagger文档、取值范围标注边界值与异常示例、空值规则三选一明确声明、业务含义绑定动词+具体场景，缺一不可。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让百度文库AI生成的表格字段说明真正能被开发、测试、产品三方直接拿去对齐接口或校验数据，提示词必须强制AI对每个字段执行四类可验证检查：类型是否匹配原始文档、取值范围是否标注边界值、空值规则是否写明“允许/禁止/默认值”、业务含义是否绑定具体场景动词。漏掉任意一类，字段说明就会变成词典式解释，无法指导联调或埋点。
字段类型检查必须绑定原始依据
在提示词开头直接写：“所有字段类型（如string/int/boolean/enum）必须严格对照《订单中心API_v3.4.2_swagger.json》中paths部分的实际定义，不得按常识推断。”
AI常把“user_id”默认标为string，但实际文档里是long类型——【若未指定原始依据文件名和路径段落，AI会自行补全类型，导致下游解析失败】。
紧接着加一句硬约束：“若某字段在原始文档中未声明类型，则字段说明栏必须写‘类型缺失：请确认swagger中paths./order/create.post.requestBody.content.application/json.schema.properties.user_id.type’，不许留空或写‘待定’。”
取值范围检查要带边界值与异常示例
方法一：用“必须包含”句式锁定内容要素
“每个枚举型字段的说明必须包含：①完整枚举项列表（含code和label，如‘1=待支付,2=已支付,3=已取消’）；②明确标注默认值（如‘默认值：1’）；③列出1个典型异常值及系统响应（如‘传入0时返回HTTP 400，错误码INVALID_STATUS’）。”
方法二：禁用模糊描述
删除所有“常见值包括”“一般为”“可能有”等短语——这些表述会让测试同学无法编写边界用例。
调用百度PaddleOCR‑VL大模型API，支持PDF、Word、PPT、图片等多格式文档解析，精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素，支持100+语言，可处理不规则布局和跨页长文档。触发词：文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。
空值规则检查需分三档强制声明
第一步：要求AI对每个字段单独判断并填入固定三选一格式
• 允许为空 → 写“允许为空；若为空，接口将跳过该字段校验”
• 禁止为空 → 写“禁止为空；为空时返回HTTP 400，错误码MISSING_REQUIRED_FIELD”
• 默认填充 → 写“禁止为空；若为空，后端自动填充为【具体值】（如created_time默认为当前时间戳）”
第二步：【若字段说明中未出现“允许为空”“禁止为空”“默认填充”任一关键词，整行视为无效，AI须重写】。
第三步：对时间类字段追加特殊规则：“所有时间字段必须注明时区，例如‘create_time（UTC+8）’，不写时区则判定为空值规则缺失。”
业务含义检查要绑定动词+场景
① 所有字段说明首句必须是“动词+名词+场景”结构，例如：“标识用户提交订单时选择的支付方式（微信支付/支付宝/银行卡）”，而不是“支付方式的选择结果”。
② 禁用抽象名词堆砌：“订单状态标识符”→删掉；改为“标记当前订单所处生命周期阶段（如‘待支付’表示用户未完成付款，‘已发货’表示物流单号已录入系统）”。
③ 对ID类字段强制关联操作动作：“order_id用于调用GET /order/{id}接口查询订单详情，不可用于前端展示或用户输入”。
启动字段说明自检流程
请在输出前完成以下自检：
- 核对每个字段名是否与原始swagger中properties下完全一致（区分大小写、下划线）
- 确认所有枚举值code与label之间用等号连接，且无中文顿号或英文逗号混用
- 删除任何含“通常”“一般”“建议”的修饰性短语
- 检查每行末尾是否以句号结束，且无多余空格
【启动自检】
