From 7c19a5f43cc9390f80f36d711a0750b4817aebb1 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Tue, 15 Sep 2026 15:32:51 +0800 Subject: [PATCH] =?UTF-8?q?fix(inbox):=20=E5=9B=9E=E4=BF=A1=E6=94=B9?= =?UTF-8?q?=E4=B8=BA=E8=BF=90=E5=8D=95=E5=8F=B7+=E5=A4=84=E7=90=86?= =?UTF-8?q?=E5=86=85=E5=AE=B9=EF=BC=8C=E4=B8=8D=E5=86=8D=E5=90=91=E5=AE=A2?= =?UTF-8?q?=E6=88=B7=E5=8F=91=E9=80=81=E5=94=AE=E5=90=8E=E5=8D=95=E5=8F=B7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 生产核实(近 7 天):含售后单号(AS)的出站消息 647 条 / 46 个群,其中 99.8% 发在货主售后群; 拦截回信 484 条、工单处理备注通知 96 条、拦截幂等 33 条只带 AS 无运单号,客户无法据此跟进。 - 拦截回信:`运单X 拦截信息已登记,已通知快递群`(未配置快递群 / 已登记过同理), 幂等分支回 `运单X 已有处理中的拦截申请`;AS→运单号用 validList 按 waybill_id 反查 (existingASList 只带 waybill_id) - handleStoreFeedback / weishoudao:`运单X <问题>问题已登记`,去掉 `,工单:AS...` - cancelIntercept:回信补运单号(已追加到处理中的工单 / 已创建处理工单) - systems/afterSale handleWorkOrder 处理备注通知:`运单X 处理备注:\n<备注>`(无运单号时降级) - inbox/ai.js systemPrompt 口径同步:拦截回复必须给运单号,严禁回复售后单号;模板描述去掉工单号 售后单号仍照常生成、入库、驱动幂等与状态流转,仅不再出现在回信中。 验证:eslint 通过;test/inbox handle_store_feedback 13 passing,其余站内信用例 100 passing。 (query_return.test.js 的 8 个失败为既有环境问题 can't get mockContext before ready, 已用 git stash 基线对比确认与本次改动无关) --- app/service/inbox/ai.js | 4 +-- app/service/inbox/functions.js | 54 +++++++++++++++++++++++--------- app/service/systems/afterSale.js | 6 +++- 3 files changed, 46 insertions(+), 18 deletions(-) diff --git a/app/service/inbox/ai.js b/app/service/inbox/ai.js index 834e971..7c34508 100644 --- a/app/service/inbox/ai.js +++ b/app/service/inbox/ai.js @@ -266,7 +266,7 @@ ${historyContext} - 需要上下文但记忆不足时,主动调用 recallHistory 回顾对话历史 - 【防误判规则 - interceptWaybill】讨论已有售后工单(AS开头编号)、询问物流进度、问"快递到哪了"、转发售后截图等均不是拦截请求,严禁调用 interceptWaybill。只有用户明确说"拦截/退回/召回/追回/取消"运单时才可调用 - 【规则 - requestPickup】货主售后群/仓库客服群中客户要求上门揽收/取件(如"揽收""上门取件""退货取件""寄回""让快递来拿"等)且提供了运单号时,调用 requestPickup(keyword=运单号,多个用逗号分隔)。函数会创建揽收售后工单,并优先转发到对应快递的揽收群(未配置揽收群时回退到售后群);返回的 data.message 是模板消息必须原样回复;若消息中无运单号,先向客户确认运单号再调用 -- 【措辞规则 - interceptWaybill】拦截结果回复严禁使用"已拦截""拦截成功"等确定口吻,必须使用"拦截信息已登记""已提交拦截申请"等措辞。因为快递拦截可能失败,实际结果以快递公司反馈为准。回复时需列出工单号供用户跟进 +- 【措辞规则 - interceptWaybill】拦截结果回复严禁使用"已拦截""拦截成功"等确定口吻,必须使用"拦截信息已登记""已提交拦截申请"等措辞。因为快递拦截可能失败,实际结果以快递公司反馈为准。回复时必须给出运单号与处理结果,严禁把售后单号(AS 开头编号)回复给用户 - 【规则 - handleStoreFeedback】货主售后群中客户反馈"错发/发错""破损/坏了""多发/发多""少发/漏发"且提供了运单号时,调用 handleStoreFeedback 创建售后工单(初始状态未开始处理,不通知快递群);若消息中无运单号,先向客户确认运单号再调用 - 【规则 - handleExpressFeedback】快递售后群中,快递客服反馈处理进度/结果(如"已通知网点""网点正在处理""已拦截""已联系收件人""改地址失败/无法改""已签收""加急处理"等)且消息含运单号时,必须调用 handleExpressFeedback(keyword=运单号,多个用逗号分隔)。该函数会自动查找已有售后工单追加反馈并回信到相关群,无工单则自动创建。严禁把快递客服的进度/结果反馈判定为无需处理而 silent;若消息无运单号,先用 recallHistory 或询问确认运单号,严禁跳过 - 【规则 - handleExpressFeedback 证据核实】快递售后群中快递方发消息要求"提供交易记录截图/未收到依据/核实签收/带日期单号"等证据类诉求且消息含运单号时,同样必须调用 handleExpressFeedback(as_sub_type=verify_delivery),由函数创建售后工单并回信到货主售后群;严禁仅回复"收到/已记录"等确认话术而不调用函数 @@ -278,7 +278,7 @@ ${historyContext} - 【规则 - createPostnum】货主售后群中客户要求"出单/打单/打印单/催发货/分配快递号"且提供了订单号时,调用 createPostnum(keyword=订单号,多个用逗号分隔);仅待处理表已审核且未分配快递号的订单可分配,函数会走分配流程并按结果返回"已分配+已回传"或"分配失败,等待客服人工处理"模板;返回的 data.message 是模板消息必须原样回复;若消息中无订单号,先向客户确认订单号再调用 - 【模板消息 - queryReturn】queryReturn 返回的 data.message 是已排版好的模板消息,必须原样作为最终回复输出,禁止改写、删减、增补内容,禁止添加 Markdown 或额外说明 - 【规则 - queryWarehouseAddress】用户询问"仓库地址/收货地址/退货地址/退件地址/寄回地址"时,调用 queryWarehouseAddress 查询仓库配置中的 receiver_address;返回的 data.message 是模板消息必须原样回复 -- 【模板消息 - handleStoreFeedback】handleStoreFeedback 返回的 data.message 是已排版好的模板消息(运单号+问题类型+工单号+"稍后客服将人工核实跟进"),必须原样作为最终回复输出,禁止改写、删减或增补内容 +- 【模板消息 - handleStoreFeedback】handleStoreFeedback 返回的 data.message 是已排版好的模板消息(运单号+问题类型+"稍后客服将人工核实跟进"),必须原样作为最终回复输出,禁止改写、删减或增补内容,严禁补充售后单号 - 用户发送"查退回+运单号"时,调用 queryReturn 查询退回明细,不要误调 queryOrder 或 interceptWaybill - 【查询类请求强制调函数】查订单/查退回/查库存等查询类请求必须实际调用对应函数获取结果后再回复,严禁仅凭历史对话或猜测臆测"服务不可用/无法处理"而跳过函数调用 - 【历史失败回复免疫】群历史中 AI 的历史回复(尤其含"失败""异常""无法处理"等字样的兜底回复)只是历史记录,不代表当前功能不可用;严禁模仿、引用这类历史回复,也严禁据此判断函数不可用而拒绝调用;登记/操作/查询类请求必须实际调用对应函数获取最新结果`; diff --git a/app/service/inbox/functions.js b/app/service/inbox/functions.js index 9313658..e8d1115 100644 --- a/app/service/inbox/functions.js +++ b/app/service/inbox/functions.js @@ -922,13 +922,20 @@ class InboxFunctionsService extends Service { // 过滤掉已存在工单的 const toCreate = validList.filter(e => !existingWaybillIds.has(e.id)); const alreadyExist = existingASList.map(r => r.after_sale_no); + // 已存在工单对应的运单号(去重):客户回信只给运单号,不暴露售后单号 + const alreadyExistWbs = [ ...new Set(existingASList.map(r => { + const hit = validList.find(v => Number(v.id) === Number(r.waybill_id)); + return hit ? hit.waybill_code : ''; + }).filter(Boolean)) ]; if (toCreate.length === 0) { return { success: true, data: { existed: true, - message: `运单已存在处理中的拦截工单: ${alreadyExist.join('、')}`, + message: alreadyExistWbs.length > 0 + ? `运单${alreadyExistWbs.join('、')} 已有处理中的拦截申请` + : '拦截信息已登记过,无需重复提交', after_sale_nos: alreadyExist, }, }; @@ -1173,14 +1180,19 @@ class InboxFunctionsService extends Service { } // 第六步:有通知的工单升级为 pending_feedback + // 同时收集运单号:客户回信只给运单号 + 处理内容,不再暴露售后单号 const notifiedAsNos = []; const notNotifiedAsNos = []; + const notifiedWbs = []; + const notNotifiedWbs = []; for (const e of toCreate) { const asNo = waybillToAsNo[e.id]; if (notifiedWaybillIds.has(e.id)) { notifiedAsNos.push(asNo); + notifiedWbs.push(e.waybill_code); } else { notNotifiedAsNos.push(asNo); + notNotifiedWbs.push(e.waybill_code); } } @@ -1203,16 +1215,16 @@ class InboxFunctionsService extends Service { ); } - // 构造返回消息 + // 构造返回消息(运单号 + 处理内容,不含售后单号) const parts = []; - if (notifiedAsNos.length > 0) { - parts.push(`拦截信息已登记并通知快递群,工单: ${notifiedAsNos.join('、')}`); + if (notifiedWbs.length > 0) { + parts.push(`运单${notifiedWbs.join('、')} 拦截信息已登记,已通知快递群`); } - if (notNotifiedAsNos.length > 0) { - parts.push(`拦截信息已登记(未配置快递群,需人工跟进),工单: ${notNotifiedAsNos.join('、')}`); + if (notNotifiedWbs.length > 0) { + parts.push(`运单${notNotifiedWbs.join('、')} 拦截信息已登记(未配置快递群,需人工跟进)`); } - if (alreadyExist.length > 0) { - parts.push(`已登记过,工单: ${alreadyExist.join('、')}`); + if (alreadyExistWbs.length > 0) { + parts.push(`运单${alreadyExistWbs.join('、')} 拦截信息已登记过`); } if (skipped.length > 0) { parts.push(`无权操作: ${skipped.join('、')}`); @@ -1766,6 +1778,7 @@ class InboxFunctionsService extends Service { } catch (e) { /* ignore */ } let feedbackCount = 0; + const feedbackWbs = []; const cancelGroup = ctx.inboxContext?.group_name || '未知群'; const cancelUser = ctx.inboxContext?.user_name || '未知用户'; const cancelTime = new Date().toISOString().slice(0, 19) @@ -1785,13 +1798,19 @@ class InboxFunctionsService extends Service { remark: remarkLines.join('\n'), }); feedbackCount += 1; + if (as.waybill_no) feedbackWbs.push(as.waybill_no); } catch (e) { ctx.logger.warn(`[inbox functions] 取消拦截反馈失败 as_no=${as.after_sale_no}: ${e.message}`); } } const parts = []; - if (feedbackCount > 0) parts.push(`已有工单追加取消拦截: ${feedbackCount}个`); + if (feedbackCount > 0) { + const wbs = [ ...new Set(feedbackWbs) ]; + parts.push(wbs.length > 0 + ? `运单${wbs.join('、')} 取消拦截信息已登记(已追加到处理中的工单)` + : `取消拦截信息已登记 ${feedbackCount} 个`); + } // 第四步:无工单的按拦截规则创建 const createdNos = []; @@ -1820,7 +1839,12 @@ class InboxFunctionsService extends Service { createdNos.push(afterSaleNo); } } - if (createdNos.length > 0) parts.push(`已创建取消拦截工单: ${createdNos.length}个`); + if (createdNos.length > 0) { + const wbs = toCreate.map(e => e.waybill_code).filter(Boolean); + parts.push(wbs.length > 0 + ? `运单${wbs.join('、')} 取消拦截信息已登记(已创建处理工单)` + : `取消拦截信息已登记 ${createdNos.length} 个`); + } ctx.logger.info( `[inbox functions] 取消拦截: total=${keywords.length} ` + @@ -2057,12 +2081,12 @@ class InboxFunctionsService extends Service { const alreadyExist = existingASList.map(r => r.after_sale_no); /** - * 组装客户回信模板:单号 + 问题信息 + 工单号。 - * @param {Array<{waybill: string, as_no: string}>} pairs 运单号→工单号列表。 + * 组装客户回信模板:运单号 + 问题信息(不暴露售后单号)。 + * @param {Array<{waybill: string, as_no: string}>} pairs 运单号→工单号列表(as_no 仅内部使用)。 * @return {string} 模板消息。 */ const buildReply = pairs => { - const lines = pairs.map(p => `运单${p.waybill} ${issue.label}问题已登记,工单:${p.as_no}`); + const lines = pairs.map(p => `运单${p.waybill} ${issue.label}问题已登记`); if (notFound.length > 0) { lines.push(`未找到运单:${notFound.join('、')},请核实单号`); } @@ -2597,12 +2621,12 @@ class InboxFunctionsService extends Service { } } - // 第六步:客户回信模板(单号+诉求+工单) + // 第六步:客户回信模板(运单号 + 诉求,不暴露售后单号) const createdPairs = toCreate.map(e => ({ waybill: e.waybill_code, as_no: waybillToAsNo[e.id] || '', })); - const lines = [ ...createdPairs, ...existedPairs ].map(p => `运单${p.waybill} ${issue.label}问题已登记,工单:${p.as_no}`); + const lines = [ ...createdPairs, ...existedPairs ].map(p => `运单${p.waybill} ${issue.label}问题已登记`); if (notFound.length > 0) { lines.push(`未找到运单:${notFound.join('、')},请核实单号`); } diff --git a/app/service/systems/afterSale.js b/app/service/systems/afterSale.js index a8eb7c2..ee3c31a 100644 --- a/app/service/systems/afterSale.js +++ b/app/service/systems/afterSale.js @@ -1267,7 +1267,11 @@ class AfterSaleService extends Service { storeIds: [ notifyStoreId ], warehouseId, }); - const content = `【工单 ${asRow.after_sale_no}】处理备注:\n${remarkText}`; + // 通知文案只给运单号 + 处理内容(售后单号对客户无意义) + const waybillNo = String(asRow.waybill_no || '').trim(); + const content = waybillNo + ? `运单${waybillNo} 处理备注:\n${remarkText}` + : `处理备注:\n${remarkText}`; for (const g of storeGroups) { if (!g.group_id) continue; ctx.service.inbox.processor.pushSystemNotification({