5.7 KiB
AI-001 工作经历AI优化前端对接方案
2026-10-26 A7 新候选：真实模式改为 mode=deepseek + real-enabled=true 显式开启，不再要求 dev；新增 Redis 调用额度与并发门禁（429/Retry-After=60、Redis 故障503）。告知升级 work-experience-external-processing-v2，developmentOnly=false。下文旧版本/仅开发环境及旧验收记录属于历史，当前规则和上线边界以 正式环境配置说明 为准；本批尚未部署，不代表合规审核完成。
日期：2026-10-23。交付范围：后端AI建议生成；前端由前端负责人实施，复用原页面及保存流程。
POST /api/v1/profile/me/work-experience-optimization，Content-Type application/json，Authorization: Bearer ，仅当前STUDENT。不得传用户ID。
{"position":"后端开发工程师","description":"负责订单查询接口开发，使用Java和MySQL，参与问题排查。","targetPosition":"Java后端开发","externalProcessingConsent":true,"consentNoticeVersion":"work-experience-external-processing-v2"}
position、targetPosition可选各最多100字符；description必填非空最多3000字符。2026-10-26 后端新候选要求 externalProcessingConsent 为原生布尔 true，且 consentNoticeVersion 与本次告知接口一致；旧请求缺版本将被拒绝。具体展示、拒绝及重新确认流程见 当前告知与同意接入说明。下文未涉及该版本字段的来源记录仅作历史。
成功HTTP200使用ApiResponse，code=200、message=ok，data字段：status为OPTIMIZED/NEED_MORE_INFO；optimizedDescription为建议，信息不足可null或省略；suggestions、followUpQuestions为字符串数组；promptVersion为后端确定的提示词版本标识（不代表内容事实已校验）；simulated标识是否模拟。真实模式为false/work-experience-deepseek-v2，stub为true/work-experience-v1，不限制dev profile。前端不要按固定提示词版本阻断展示。无流式或分页；429读取Retry-After但不自动重试，Redis故障返回503。
错误HTTP400参数或敏感输入拒绝（code可能400/1001）；401未登录；403角色拒绝（可能code2002）；404用户不存在；502无效模型结果；503关闭或模型不可用；504超时。模型错误仅安全固定文案，不回传上游正文。HTTP状态与业务code不能一概等同。
按钮流程：取当前一条描述→显示加载并防重复点击→展示原文/建议/补充问题→允许编辑、采用、取消→采用回填工作内容→沿用已有保存。失败/取消保留原文，原文已改变则丢弃旧响应。可设置25秒前端等待，超时不自动重试（供应商仍可能计费）。本接口不写数据库，不改变公司/时间、评分或企业可见性。
验证：源目录离线22项20通过2跳过；用户本机单例真实调用与5例合成质量评审有证据。目标仓库移植验证见后端整合说明。实际启动后的HTTP/JWT黑盒、前端、完整生产数据治理与至少30例评测仍未完成。当前只允许dev合成联调，告知文案按用户要求暂缓，不视为可上线。
v2 规则与版本（后续修正候选）
历史验证段描述来源交付时的状态。随后 v1 在目标工程完成离线/JAR 链路验证和单次真实联调，但质量批次在第 29 例因“不负责”被改成“不参与”而停止，第 30 例未执行，不能作为质量放行。
v2 要求保留否定条件、参与程度、指导/责任/权限边界及时间/上线状态。补充建议必须以“仅在真实发生且可核实时补充”为前提；原文已清晰时允许不改并诚实说明。采用前仍应让用户核对，不默认覆盖原文；API 字段、路径、保存流程、stub 和默认关闭行为均不变。
离线验证边界
离线回归只校验 v2 资源与版本一致、规则被发送、原文无损传递、合成响应解析及权限等程序行为；不能证明真实模型遵守规则，也不代表输出已脱敏或事实忠实。
待授权真实复验
v2 尚未执行真实模型质量复验。需用新候选制品重新验证已失败及边界遗漏用例，再经单独授权完成至少 30 例质量评测；不得复用 v1 通过项宣称 v2 质量通过。当前不发布、不开放生产真实模式。
2026-10-26 信息不足修正候选
规则与版本
此前 A3 v2 已实际复验 16 次：15 例质量通过，Q09“暂无相关经历。”被返回为 OPTIMIZED 后停止，14 例未执行，不是完整通过。新候选对有限登记的无经历、占位、空泛评价和纯愿望语句增加本地不足信息判定；只有整段各分句均符合才直接要求补充，短真实职责及含具体事实的混合句不因长度或“暂无”字样被拒绝。模型若返回同类无事实语句，也归一为空描述。
接口字段和路径不变。status=NEED_MORE_INFO 时展示 followUpQuestions，不显示“优化成功”、不启用采用/覆盖原文；optimizedDescription 可 null 或省略。simulated=false 仅代表真实运行模式，不保证本次调用过供应商，本地规则也可能直接返回；不得用它推算计费或质量案例数。提示词仍为 v2，新 JAR/基线哈希区分本次规则修正。
离线验证边界与真实复验状态
新回归覆盖本地不足信息、短真实经历及混合事实放行、权限/同意/敏感输入保护和无自动保存。新基线的全量、同次 JAR 验证与真实模型质量需分别记录；原有 v1/A3 质量失败保留。有限规则不保证识别所有自然语言；新候选未据此开放生产。本批不改前端，以上供后续联调对接。