diff --git a/AI_METHOD_ROUTING.md b/AI_METHOD_ROUTING.md index 145136c..4e5032b 100644 --- a/AI_METHOD_ROUTING.md +++ b/AI_METHOD_ROUTING.md @@ -432,8 +432,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods - list, manualOutboundOrder - app/service/systemMethods/order/packing.js (11) - list, get, setEndTime, forceRecord, export, exportTaskProgress, generateExportTaskId, normalizeExportTaskId, getExportTaskCacheKey, setExportTaskProgress, getExportTaskProgress -- app/service/systemMethods/order/pendingOrder.js (41) - - list, detail, reverseReviewOrder, assertOrdersWithoutWaybill, syncWavesAfterReverseReview, allocateStorage, allocateStorageProgress, normalizeAllocateStorageTaskProgress, normalizeAllocateStorageTaskCount, normalizeAllocateStorageTaskCounts, normalizeAllocateStorageRequestId, getAllocateStorageTaskCacheKey, setAllocateStorageTaskProgress, getAllocateStorageTaskProgress, getAllocateExpressTaskCacheKey, normalizeAllocateExpressTaskId, setAllocateExpressTaskProgress, getAllocateExpressTaskProgress, getSyncOrderIdsTaskCacheKey, normalizeSyncOrderIdsRequestId, setSyncOrderIdsTaskProgress, getSyncOrderIdsTaskProgress, cancelAllocateStorage, syncOrderIds, syncOrderIdsProgress, allocateExpressCode, allocateExpressCodeTaskProgress, markPendingOutboundOrder, cancelOrder, normalizePendingOutboundOrderIds, normalizePendingCancelOrderIds, isCancelablePendingOrder, updateOrderPlatform, updateOrderExpress, updateAddress, updateRemark, cloneOrder, parseAddress, _parseAddressBatchOneShot, _parseSingleAddress, catch +- app/service/systemMethods/order/pendingOrder.js (40) + - list, detail, reverseReviewOrder, assertOrdersWithoutWaybill, syncWavesAfterReverseReview, allocateStorage, allocateStorageProgress, normalizeAllocateStorageTaskProgress, normalizeAllocateStorageTaskCount, normalizeAllocateStorageTaskCounts, normalizeAllocateStorageRequestId, getAllocateStorageTaskCacheKey, setAllocateStorageTaskProgress, getAllocateStorageTaskProgress, getAllocateExpressTaskCacheKey, normalizeAllocateExpressTaskId, setAllocateExpressTaskProgress, getAllocateExpressTaskProgress, getSyncOrderIdsTaskCacheKey, normalizeSyncOrderIdsRequestId, setSyncOrderIdsTaskProgress, getSyncOrderIdsTaskProgress, cancelAllocateStorage, syncOrderIds, syncOrderIdsProgress, allocateExpressCode, allocateExpressCodeTaskProgress, markPendingOutboundOrder, cancelOrder, normalizePendingOutboundOrderIds, normalizePendingCancelOrderIds, isCancelablePendingOrder, updateOrderPlatform, updateOrderExpress, updateAddress, updateRemark, cloneOrder, parseAddress, parseAddressLocal, catch - app/service/systemMethods/order/print.js (4) - getWavePlatformPrintData, getOrderPrintData, getPrintDataByWaybillCodes, unlockWavePlatformPrintDataByGroup - app/service/systemMethods/order/recheckOrder.js (60) diff --git a/app/service/systemMethods/order/pendingOrder.js b/app/service/systemMethods/order/pendingOrder.js index 5a79006..1302cab 100644 --- a/app/service/systemMethods/order/pendingOrder.js +++ b/app/service/systemMethods/order/pendingOrder.js @@ -410,6 +410,71 @@ const PROVINCE_LIST = [ '香港特别行政区', '澳门特别行政区', ]; +/** + * 本地地址解析副接口内置的"省 → 地级市"地址字典数据。 + * + * 覆盖全国 34 个省级行政区下的地级市/自治州/地区/盟(约 340 条), + * 供 parseAddressLocal 遍历匹配识别省市区,不依赖 AI 接口。 + * 直辖市(北京/天津/上海/重庆)的 city 与 province 同名;港澳台无地级市条目, + * 仅靠 PROVINCE_LIST 识别省份。 + */ +const LOCAL_CITY_DICT = Object.freeze( + [ + [ '北京市', [ '北京市' ]], + [ '天津市', [ '天津市' ]], + [ '上海市', [ '上海市' ]], + [ '重庆市', [ '重庆市' ]], + [ '河北省', [ '石家庄市', '唐山市', '秦皇岛市', '邯郸市', '邢台市', '保定市', '张家口市', '承德市', '沧州市', '廊坊市', '衡水市' ]], + [ '山西省', [ '太原市', '大同市', '阳泉市', '长治市', '晋城市', '朔州市', '晋中市', '运城市', '忻州市', '临汾市', '吕梁市' ]], + [ '内蒙古自治区', [ '呼和浩特市', '包头市', '乌海市', '赤峰市', '通辽市', '鄂尔多斯市', '呼伦贝尔市', '巴彦淖尔市', '乌兰察布市', '兴安盟', '锡林郭勒盟', '阿拉善盟' ]], + [ '辽宁省', [ '沈阳市', '大连市', '鞍山市', '抚顺市', '本溪市', '丹东市', '锦州市', '营口市', '阜新市', '辽阳市', '盘锦市', '铁岭市', '朝阳市', '葫芦岛市' ]], + [ '吉林省', [ '长春市', '吉林市', '四平市', '辽源市', '通化市', '白山市', '松原市', '白城市', '延边朝鲜族自治州' ]], + [ '黑龙江省', [ '哈尔滨市', '齐齐哈尔市', '鸡西市', '鹤岗市', '双鸭山市', '大庆市', '伊春市', '佳木斯市', '七台河市', '牡丹江市', '黑河市', '绥化市', '大兴安岭地区' ]], + [ '江苏省', [ '南京市', '无锡市', '徐州市', '常州市', '苏州市', '南通市', '连云港市', '淮安市', '盐城市', '扬州市', '镇江市', '泰州市', '宿迁市' ]], + [ '浙江省', [ '杭州市', '宁波市', '温州市', '嘉兴市', '湖州市', '绍兴市', '金华市', '衢州市', '舟山市', '台州市', '丽水市' ]], + [ '安徽省', [ '合肥市', '芜湖市', '蚌埠市', '淮南市', '马鞍山市', '淮北市', '铜陵市', '安庆市', '黄山市', '滁州市', '阜阳市', '宿州市', '六安市', '亳州市', '池州市', '宣城市' ]], + [ '福建省', [ '福州市', '厦门市', '莆田市', '三明市', '泉州市', '漳州市', '南平市', '龙岩市', '宁德市' ]], + [ '江西省', [ '南昌市', '景德镇市', '萍乡市', '九江市', '新余市', '鹰潭市', '赣州市', '吉安市', '宜春市', '抚州市', '上饶市' ]], + [ '山东省', [ '济南市', '青岛市', '淄博市', '枣庄市', '东营市', '烟台市', '潍坊市', '济宁市', '泰安市', '威海市', '日照市', '临沂市', '德州市', '聊城市', '滨州市', '菏泽市' ]], + [ '河南省', [ '郑州市', '开封市', '洛阳市', '平顶山市', '安阳市', '鹤壁市', '新乡市', '焦作市', '濮阳市', '许昌市', '漯河市', '三门峡市', '南阳市', '商丘市', '信阳市', '周口市', '驻马店市' ]], + [ '湖北省', [ '武汉市', '黄石市', '十堰市', '宜昌市', '襄阳市', '鄂州市', '荆门市', '孝感市', '荆州市', '黄冈市', '咸宁市', '随州市', '恩施土家族苗族自治州' ]], + [ '湖南省', [ '长沙市', '株洲市', '湘潭市', '衡阳市', '邵阳市', '岳阳市', '常德市', '张家界市', '益阳市', '郴州市', '永州市', '怀化市', '娄底市', '湘西土家族苗族自治州' ]], + [ '广东省', [ '广州市', '韶关市', '深圳市', '珠海市', '汕头市', '佛山市', '江门市', '湛江市', '茂名市', '肇庆市', '惠州市', '梅州市', '汕尾市', '河源市', '阳江市', '清远市', '东莞市', '中山市', '潮州市', '揭阳市', '云浮市' ]], + [ '广西壮族自治区', [ '南宁市', '柳州市', '桂林市', '梧州市', '北海市', '防城港市', '钦州市', '贵港市', '玉林市', '百色市', '贺州市', '河池市', '来宾市', '崇左市' ]], + [ '海南省', [ '海口市', '三亚市', '三沙市', '儋州市' ]], + [ '四川省', [ '成都市', '自贡市', '攀枝花市', '泸州市', '德阳市', '绵阳市', '广元市', '遂宁市', '内江市', '乐山市', '南充市', '眉山市', '宜宾市', '广安市', '达州市', '雅安市', '巴中市', '资阳市', '阿坝藏族羌族自治州', '甘孜藏族自治州', '凉山彝族自治州' ]], + [ '贵州省', [ '贵阳市', '六盘水市', '遵义市', '安顺市', '毕节市', '铜仁市', '黔西南布依族苗族自治州', '黔东南苗族侗族自治州', '黔南布依族苗族自治州' ]], + [ '云南省', [ '昆明市', '曲靖市', '玉溪市', '保山市', '昭通市', '丽江市', '普洱市', '临沧市', '楚雄彝族自治州', '红河哈尼族彝族自治州', '文山壮族苗族自治州', '西双版纳傣族自治州', '大理白族自治州', '德宏傣族景颇族自治州', '怒江傈僳族自治州', '迪庆藏族自治州' ]], + [ '西藏自治区', [ '拉萨市', '日喀则市', '昌都市', '林芝市', '山南市', '那曲市', '阿里地区' ]], + [ '陕西省', [ '西安市', '铜川市', '宝鸡市', '咸阳市', '渭南市', '延安市', '汉中市', '榆林市', '安康市', '商洛市' ]], + [ '甘肃省', [ '兰州市', '嘉峪关市', '金昌市', '白银市', '天水市', '武威市', '张掖市', '平凉市', '酒泉市', '庆阳市', '定西市', '陇南市', '临夏回族自治州', '甘南藏族自治州' ]], + [ '青海省', [ '西宁市', '海东市', '海北藏族自治州', '黄南藏族自治州', '海南藏族自治州', '果洛藏族自治州', '玉树藏族自治州', '海西蒙古族藏族自治州' ]], + [ '宁夏回族自治区', [ '银川市', '石嘴山市', '吴忠市', '固原市', '中卫市' ]], + [ '新疆维吾尔自治区', [ '乌鲁木齐市', '克拉玛依市', '吐鲁番市', '哈密市', '昌吉回族自治州', '博尔塔拉蒙古自治州', '巴音郭楞蒙古自治州', '克孜勒苏柯尔克孜自治州', '伊犁哈萨克自治州', '阿克苏地区', '喀什地区', '和田地区', '塔城地区', '阿勒泰地区' ]], + ].reduce((map, [ province, cities ]) => { + for (const city of cities) map[city] = province; + return map; + }, {}) +); + +/** + * parseAddressLocal 内置的示例地址数据。 + * + * 请求未传 address/addresses 时,接口直接遍历识别这批地址并返回结果, + * 便于验证本地字典遍历识别效果,覆盖直辖市、普通省市区、县级市、不设区地级市、 + * 自治区、仅有城市名、仅有县级市名等典型场景。 + */ +const LOCAL_SAMPLE_ADDRESSES = Object.freeze([ + '张三 13800138000 北京市朝阳区建国路88号', + '李四 13900139000 广东省广州市天河区体育西路100号', + '江苏省苏州市昆山市花桥镇光明路8号', + '广东省东莞市南城街道宏图路100号', + '新疆维吾尔自治区乌鲁木齐市天山区中山路1号', + '苏州市姑苏区干将西路100号', + '昆山市玉山镇前进西路100号', + '四川省成都市武侯区人民南路四段10号', +]); + /** * 根据已解析的地址字段,利用中国行政区划知识进行反向推断,补全缺失的 province/city/area。 * @@ -535,92 +600,7 @@ function reverseInferAddress(parsed) { } /** - * 从模型返回的文本中截取 JSON 片段(对象或数组),并清理 markdown 代码块标记。 - * 对象取第一个 { 到最后一个 },数组取第一个 [ 到最后一个 ],自动忽略前后多余文本。 - * - * @param {string} text 模型原始返回文本。 - * @return {string} 截取后的 JSON 字符串;无有效片段时返回原文 trim。 - */ -function extractJsonBlock(text) { - if (!text) return ''; - let s = String(text).trim(); - s = s.replace(/^```(?:json)?\s*/i, '').replace(/\s*```$/i, ''); - const firstBrace = s.indexOf('{'); - const firstBracket = s.indexOf('['); - let start = -1; - if (firstBrace === -1) { - start = firstBracket; - } else if (firstBracket === -1) { - start = firstBrace; - } else { - start = Math.min(firstBrace, firstBracket); - } - const end = Math.max(s.lastIndexOf('}'), s.lastIndexOf(']')); - if (start === -1 || end === -1 || end <= start) { - return s; - } - return s.slice(start, end + 1); -} - -const ADDRESS_PARSE_FIELDS = [ - 'province', 'city', 'area', 'town', 'detailAddress', 'name', 'mobile', -]; - -/** - * 从任意文本(如思维链模型的 reasoning_content)中提取地址解析字段, - * 支持 "province":"xx"、province=xx、province:xx 等常见写法。 - * - * @param {string} text 原始文本。 - * @return {Object|null} 提取到的字段对象;一个字段都没提取到则返回 null。 - */ -function salvageFieldsFromText(text) { - if (!text) return null; - const src = String(text); - const out = {}; - let foundAny = false; - for (const field of ADDRESS_PARSE_FIELDS) { - const patterns = [ - new RegExp(`["']?${field}["']?\\s*[::=]\\s*["']([^"']{0,80})["']`, 'i'), - new RegExp(`["']?${field}["']?\\s*[::=]\\s*([^\\s,,;;\\n"']{0,80})`, 'i'), - ]; - for (const re of patterns) { - const m = src.match(re); - if (m && m[1] && m[1].trim()) { - out[field] = m[1].trim(); - foundAny = true; - break; - } - } - } - return foundAny ? out : null; -} - -/** - * 清洗手机号:仅保留合法 11 位大陆手机号;兜底提取的脏数据(如整段地址)置空。 - * - * @param {*} mobile 原始手机号字段。 - * @return {string} 合法手机号或空字符串。 - */ -function sanitizeMobile(mobile) { - const m = String(mobile || '').trim(); - return /^1[3-9]\d{9}$/.test(m) ? m : ''; -} - -/** - * 清洗收件人姓名:过滤过长的字符串与明显混入地址信息的脏数据。 - * - * @param {*} name 原始姓名字段。 - * @return {string} 合法姓名或空字符串。 - */ -function sanitizeName(name) { - const n = String(name || '').trim(); - if (!n || n.length > 20) return ''; - if (/[省市县区镇街道路号村组栋座楼室单元乡]/.test(n)) return ''; - return n; -} - -/** - * 地址解析最终兜底:AI 解析与行政区划映射表均失败时,用正则按"省-市-区-镇"顺序 + * 地址解析最终兜底:本地字典遍历与行政区划映射表均失败时,用正则按"省-市-区-镇"顺序 * 从原始地址字符串中提取行政区划。支持省份全称与简称(如"广东"、"内蒙古")。 * * @param {string} text 原始地址字符串。 @@ -667,6 +647,210 @@ function extractAddressByRegex(text) { return result; } +/** + * 本地地址解析副接口核心逻辑:不调用 AI,直接遍历内置的省市区地址字典数据, + * 对地址字符串做包含匹配,识别出省/市/区(及乡镇、详细地址、手机号)。 + * + * 遍历识别顺序: + * 1. 提取并剥离手机号 + * 2. 遍历 LOCAL_CITY_DICT 找最先出现的地级市 → city + province + * 3. 无城市命中时,遍历 CHINA_ADMIN_DIVISION_MAP 找特殊行政区 → area + 反查省/市 + * 4. 仍未识别省份时,遍历 PROVINCE_LIST 全称/简称匹配 + * 5. 有省无市时,在省名之后正则提取市 + * 6. 直辖市补全:province 与 city 同名 + * 7. 有市无区时,在市名之后遍历特殊行政区 + 正则提取区/县 + * 8. 复用 reverseInferAddress 统一补全缺失的省/市/区 + * 9. 正则提取乡镇/街道,剩余部分作为详细地址 + * + * @param {*} rawAddress 原始地址字符串。 + * @return {Object} { address, ok, message, fields };fields 为 + * { province, city, area, town, detailAddress, name, mobile } 或 null。 + */ +function parseAddressByLocalDict(rawAddress) { + const address = String(rawAddress || '').trim(); + if (!address) { + return { address, ok: false, message: '地址字符串不能为空', fields: null }; + } + + // 1. 提取并剥离手机号 + let working = address; + let mobile = ''; + const mobileMatch = working.match(/1[3-9]\d{9}/); + if (mobileMatch) { + mobile = mobileMatch[0]; + working = working.replace(mobile, ''); + } + + let province = ''; + let city = ''; + let area = ''; + + // 2. 遍历地级市字典,取地址中最先出现的城市 + let cityIdx = -1; + for (const [ cityName, provinceName ] of Object.entries(LOCAL_CITY_DICT)) { + const idx = working.indexOf(cityName); + if (idx >= 0 && (cityIdx === -1 || idx < cityIdx)) { + cityIdx = idx; + city = cityName; + province = provinceName; + } + } + + // 3. 无城市命中时,遍历特殊行政区映射(省直辖县级市/不设区地级市/代管县级市) + if (!city) { + let areaIdx = -1; + for (const [ key, entry ] of Object.entries(CHINA_ADMIN_DIVISION_MAP)) { + const idx = working.indexOf(key); + if (idx >= 0 && (areaIdx === -1 || idx < areaIdx)) { + areaIdx = idx; + area = key; + province = entry.province; + city = entry.city; + } + } + } + + // 4. 仍未识别省份时,遍历省份全称/简称 + if (!province) { + for (const p of PROVINCE_LIST) { + if (working.includes(p)) { + province = p; + break; + } + const short = p.replace(/(壮族自治区|回族自治区|维吾尔自治区|特别行政区|自治区|省|市)$/, ''); + if (short !== p && working.includes(short)) { + province = p; + break; + } + } + } + + // 5. 有省无市:在省名之后正则提取市 + if (province && !city) { + const short = province.replace(/(壮族自治区|回族自治区|维吾尔自治区|特别行政区|自治区|省|市)$/, ''); + const fullIdx = working.indexOf(province); + const shortIdx = working.indexOf(short); + const idx = Math.max(fullIdx, shortIdx); + const skipLen = fullIdx >= 0 ? province.length : short.length; + const rest = idx >= 0 ? working.slice(idx + skipLen) : working; + const cityMatch = rest.match(/([\u4e00-\u9fa5]{2,10}?(?:自治州|地区|盟|市))/); + if (cityMatch) { + city = cityMatch[1]; + } + } + + // 6. 直辖市补全:province 与 city 同名 + if (!province && MUNICIPALITY_SET.has(city)) { + province = city; + } + if (province && !city && MUNICIPALITY_SET.has(province)) { + city = province; + } + + // 7. 有市无区:在市名之后遍历特殊行政区 + 正则提取区/县 + if (city && !area) { + const cityPos = working.indexOf(city); + const rest = cityPos >= 0 ? working.slice(cityPos + city.length) : working; + for (const key of Object.keys(CHINA_ADMIN_DIVISION_MAP)) { + if (rest.includes(key)) { + area = key; + break; + } + } + if (!area) { + const areaMatch = rest.match(/([\u4e00-\u9fa5]{1,10}?(?:自治县|自治旗|旗|区|县|市))/); + if (areaMatch) { + area = areaMatch[1]; + } + // "市辖区"不是真实行政区(东莞/中山等不设区地级市的历史遗留写法), + // 从原文剥离并置空 area,交由 reverseInferAddress 对不设区地级市将 area 补为 city; + // 剥离可避免后续 town/detailAddress 提取把"市辖区"误并入街道名 + if (area === '市辖区') { + working = working.replace('市辖区', ''); + area = ''; + } + } + } + + // 8. 复用反向推断补全缺失的省/市/区(含不设区地级市 area 补 city 等规则) + let town = ''; + const inferred = reverseInferAddress({ + province, + city, + area, + town, + detailAddress: working, + name: '', + mobile, + }); + province = inferred.province; + city = inferred.city; + area = inferred.area; + + // 9. 提取乡镇/街道:限定在已识别行政区(city/area)之后的余串开头匹配, + // 避免正则从地址开头扫描时把省市区前缀吞进镇名(如"苏省苏州市昆山市花桥镇") + town = ''; + let restTail = working; + { + const areaPos = area ? working.indexOf(area) : -1; + const cityPos = city ? working.indexOf(city) : -1; + const areaEnd = areaPos >= 0 ? areaPos + area.length : -1; + const cityEnd = cityPos >= 0 ? cityPos + city.length : -1; + if (Math.max(areaEnd, cityEnd) >= 0) { + restTail = working.slice(Math.max(areaEnd, cityEnd)); + } + } + const townMatch = restTail.match(/^[\s,,、]*([\u4e00-\u9fa5]{2,10}?(?:街道|办事处|镇|乡))/); + if (townMatch) { + town = townMatch[1]; + } + let cutEnd = -1; + for (const part of [ province, city, area, town ]) { + if (!part) continue; + const idx = working.indexOf(part); + if (idx >= 0 && idx + part.length > cutEnd) { + cutEnd = idx + part.length; + } + } + let detailAddress = cutEnd >= 0 ? working.slice(cutEnd) : working; + detailAddress = detailAddress.replace(/^[\s,,、-]+/, '').trim(); + + // 10. 正则最终兜底:字典遍历无法识别时,用正则从原文提取省市区 + if (!province && !city && !area) { + const regexResult = extractAddressByRegex(working); + if (regexResult.province) { + province = regexResult.province; + city = city || regexResult.city; + area = area || regexResult.area; + if (!town) { + town = regexResult.town; + } + // 重算详细地址 + cutEnd = -1; + for (const part of [ province, city, area, town ]) { + if (!part) continue; + const idx = working.indexOf(part); + if (idx >= 0 && idx + part.length > cutEnd) { + cutEnd = idx + part.length; + } + } + detailAddress = cutEnd >= 0 ? working.slice(cutEnd) : working; + detailAddress = detailAddress.replace(/^[\s,,、-]+/, '').trim(); + } + } + + if (!province && !city && !area) { + return { address, ok: false, message: '地址解析失败:省市区无法识别,请补充更多地址信息后重试', fields: null }; + } + + return { + address, + ok: true, + message: 'ok', + fields: { province, city, area, town, detailAddress, name: '', mobile }, + }; +} + class PendingOrderService extends OrderBaseService { /** * 初始化待处理订单系统方法的免登录、免权限、免日志和免鉴权配置。 @@ -676,9 +860,9 @@ class PendingOrderService extends OrderBaseService { constructor(ctx) { super(ctx); const _noNeedLogin = ''; - const _noNeedRight = 'list,pendingOrder,reverseReviewOrder,markPendingOutboundOrder,cancelOrder,allocateExpressCode,allocateExpressCodeTaskProgress,allocateStorage,allocateStorageProgress,cancelAllocateStorage,syncOrderIds,syncOrderIdsProgress,updateOrderPlatform,updateOrderExpress,updateRemark,updateAddress,cloneOrder,createOrder,downloadCreateTemplate,parseAddress,batchIntercept,batchInterceptTaskProgress,batchLock,batchLockTaskProgress,batchUnlock,batchUnlockTaskProgress,batchUnintercept,batchUninterceptTaskProgress,manualWaybill,allocateSubOrderNumber,allocateSubOrderNumberProgress,batchMarkPrinted'; - const _noNeedLog = 'list,markPendingOutboundOrder,cancelOrder,allocateExpressCode,allocateExpressCodeTaskProgress,allocateStorage,allocateStorageProgress,cancelAllocateStorage,syncOrderIds,syncOrderIdsProgress,parseAddress,batchIntercept,batchInterceptTaskProgress,batchLock,batchLockTaskProgress,batchUnlock,batchUnlockTaskProgress,batchUnintercept,batchUninterceptTaskProgress,manualWaybill,allocateSubOrderNumber,allocateSubOrderNumberProgress,batchMarkPrinted'; - const _noNeedAuth = 'list,pendingOrder,reverseReviewOrder,markPendingOutboundOrder,cancelOrder,allocateExpressCode,allocateExpressCodeTaskProgress,allocateStorage,allocateStorageProgress,cancelAllocateStorage,syncOrderIds,syncOrderIdsProgress,updateOrderPlatform,updateOrderExpress,updateRemark,updateAddress,cloneOrder,createOrder,downloadCreateTemplate,parseAddress,batchIntercept,batchInterceptTaskProgress,batchLock,batchLockTaskProgress,batchUnlock,batchUnlockTaskProgress,batchUnintercept,batchUninterceptTaskProgress,manualWaybill,allocateSubOrderNumber,allocateSubOrderNumberProgress,batchMarkPrinted'; + const _noNeedRight = 'list,pendingOrder,reverseReviewOrder,markPendingOutboundOrder,cancelOrder,allocateExpressCode,allocateExpressCodeTaskProgress,allocateStorage,allocateStorageProgress,cancelAllocateStorage,syncOrderIds,syncOrderIdsProgress,updateOrderPlatform,updateOrderExpress,updateRemark,updateAddress,cloneOrder,createOrder,downloadCreateTemplate,parseAddress,parseAddressLocal,batchIntercept,batchInterceptTaskProgress,batchLock,batchLockTaskProgress,batchUnlock,batchUnlockTaskProgress,batchUnintercept,batchUninterceptTaskProgress,manualWaybill,allocateSubOrderNumber,allocateSubOrderNumberProgress,batchMarkPrinted'; + const _noNeedLog = 'list,markPendingOutboundOrder,cancelOrder,allocateExpressCode,allocateExpressCodeTaskProgress,allocateStorage,allocateStorageProgress,cancelAllocateStorage,syncOrderIds,syncOrderIdsProgress,parseAddress,parseAddressLocal,batchIntercept,batchInterceptTaskProgress,batchLock,batchLockTaskProgress,batchUnlock,batchUnlockTaskProgress,batchUnintercept,batchUninterceptTaskProgress,manualWaybill,allocateSubOrderNumber,allocateSubOrderNumberProgress,batchMarkPrinted'; + const _noNeedAuth = 'list,pendingOrder,reverseReviewOrder,markPendingOutboundOrder,cancelOrder,allocateExpressCode,allocateExpressCodeTaskProgress,allocateStorage,allocateStorageProgress,cancelAllocateStorage,syncOrderIds,syncOrderIdsProgress,updateOrderPlatform,updateOrderExpress,updateRemark,updateAddress,cloneOrder,createOrder,downloadCreateTemplate,parseAddress,parseAddressLocal,batchIntercept,batchInterceptTaskProgress,batchLock,batchLockTaskProgress,batchUnlock,batchUnlockTaskProgress,batchUnintercept,batchUninterceptTaskProgress,manualWaybill,allocateSubOrderNumber,allocateSubOrderNumberProgress,batchMarkPrinted'; this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth); } @@ -3653,25 +3837,26 @@ class PendingOrderService extends OrderBaseService { } /** - * 智能地址解析:使用 DeepSeek 将用户输入的地址字符串解析为结构化地址。 + * 智能地址解析:使用本地省市区字典遍历方式将地址字符串解析为结构化地址。 + * + * 原 DeepSeek AI 解析方式已弃用,现改为本地字典遍历识别(与 parseAddressLocal 同源): + * - 遍历 LOCAL_CITY_DICT(约 340 个地级市)识别 province/city + * - 遍历 CHINA_ADMIN_DIVISION_MAP(省直辖县级市/不设区地级市/代管县级市)识别特殊区县 + * - 遍历 PROVINCE_LIST 全称/简称兜底识别省份 + * - 复用 reverseInferAddress 补全省/市/区,extractAddressByRegex 正则最终兜底 * * 支持单条解析与数组批量解析两种模式: * - 单条:data.address 传字符串,返回单条解析结果(与原行为一致) * - 批量:data.addresses(或 data.address)传字符串数组,按数组顺序返回 data.list, * 每条元素含 address/flag/message 与解析字段,失败条目不影响其他条目 * - * 采用"AI 解析 + 反向识别兜底"双层策略: - * 1. 先由 DeepSeek AI 进行语义级地址解析 - * 2. 若 AI 返回的省/市/区字段缺失,通过内置的中国行政区划映射表反向补全 - * 3. 仅在两层策略均无法确定 province 时才判定失败 - * * @param {Object} data 请求数据。 * @param {string|string[]} data.address 原始地址字符串或字符串数组(必填)。 * @param {string[]} [data.addresses] 批量地址字符串数组(与 address 数组二选一)。 * @return {Promise} 解析结果;批量模式返回 data.list 数组。 */ async parseAddress(data = {}) { - // 批量模式:addresses 数组优先,其次 address 数组 + // 批量模式:addresses 数组优先,其次 address 数组;均走本地字典遍历解析 const rawAddresses = Array.isArray(data.addresses) ? data.addresses : (Array.isArray(data.address) ? data.address : null); @@ -3683,334 +3868,87 @@ class PendingOrderService extends OrderBaseService { if (rawAddresses.length > 50) { return this.fail('单次批量解析最多支持 50 条地址'); } - // 批量提速:每 10 条合并为一次 DeepSeek 请求(实测 10 条约 18s、无截断), - // 所有块异步并行发出,全部完成后按输入顺序聚合返回;失败/缺失条目逐条回退单条解析。 - const CHUNK_SIZE = 10; const EMPTY_FIELDS = { province: '', city: '', area: '', town: '', detailAddress: '', name: '', mobile: '' }; const toListItem = r => ({ address: r.address, - flag: r.flag, + flag: r.ok ? 'success' : 'failure', message: r.message, ...(r.fields || EMPTY_FIELDS), }); - const chunks = []; - for (let i = 0; i < rawAddresses.length; i += CHUNK_SIZE) { - chunks.push(rawAddresses.slice(i, i + CHUNK_SIZE)); - } - const chunkResults = await Promise.all(chunks.map(chunk => this._parseAddressBatchOneShot(chunk))); - const results = await Promise.all(rawAddresses.map((item, idx) => { - const r = chunkResults[Math.floor(idx / CHUNK_SIZE)]; - const inChunk = r && r[idx % CHUNK_SIZE]; - return inChunk && inChunk.ok ? inChunk : this._parseSingleAddress(item); - })); + const results = rawAddresses.map(item => parseAddressByLocalDict(item)); return this.success('地址解析成功', { list: results.map(toListItem) }); } // 单条模式(向后兼容) - const single = await this._parseSingleAddress(data.address); + const single = parseAddressByLocalDict(data.address); if (!single.ok) { return this.fail(single.message); } return this.success('地址解析成功', single.fields); } - /** - * 块内一次性解析:把一组地址(建议 10 条)合并为一次 DeepSeek 请求, - * 让模型按编号返回 JSON 数组,省去逐条请求的网络开销。 - * - * @param {string[]} addressList 地址字符串数组。 - * @return {Promise} 与入参顺序对齐的逐条结果数组; - * 请求失败/JSON 解析失败/被截断时返回 null,由调用方逐条回退单条解析。 - */ - async _parseAddressBatchOneShot(addressList) { - const apiKey = this.config.deepseek.apiKey; - const baseUrl = this.config.deepseek.baseUrl || 'https://api.deepseek.com'; - if (!apiKey) return null; - - const numbered = addressList.map((a, i) => `${i + 1}. ${a}`).join('\n'); - const prompt = `你是一个专业的中文地址解析助手。请一次性解析以下 ${addressList.length} 条地址,按编号顺序返回JSON数组,每条为: -{"index":编号,"province":"省","city":"市","area":"区/县","town":"乡镇/街道","detailAddress":"详细地址","name":"收件人","mobile":"手机号"} -规则: -1. 地址重复拼接时先智能去重再解析 -2. 直辖市:province与city都填直辖市名,area填市辖区名 -3. 无法识别的字段填空字符串 -4. 只返回JSON数组,不含解释或markdown - -地址列表: -${numbered}`; - - try { - const result = await this.ctx.curl(`${baseUrl}/v1/chat/completions`, { - method: 'POST', - contentType: 'json', - dataType: 'json', - headers: { - Authorization: `Bearer ${apiKey}`, - }, - data: { - model: 'deepseek-v4-flash', - messages: [ - { role: 'system', content: '你是一个专业的地址解析助手,只返回JSON格式结果。' }, - { role: 'user', content: prompt }, - ], - temperature: 0, - max_tokens: 32000, - }, - timeout: 120000, - }); - - if (result.status !== 200 || !result.data) { - return null; - } - const choice = result.data.choices?.[0] || {}; - // 被截断时整体回退,避免残缺数组造成大量错位 - if ((choice.finish_reason || '') === 'length') { - return null; - } - - const content = String(choice.message?.content || '').trim(); - const arr = JSON.parse(extractJsonBlock(content)); - if (!Array.isArray(arr)) { - return null; - } - this.ctx.logger.info('[parseAddress] 批量块请求完成:入参 %d 条,finish_reason=%s,返回 %d 条', addressList.length, choice.finish_reason, arr.length); - - return addressList.map((address, idx) => { - if (!String(address || '').trim()) { - return { address, ok: false, flag: 'failure', message: '地址字符串不能为空', fields: null }; - } - const item = arr.find(x => x && Number(x.index) === idx + 1); - if (!item) { - return { address, ok: false, flag: 'failure', message: '批量解析未返回该条结果', fields: null }; - } - - let province = String(item.province || '').trim(); - let city = String(item.city || '').trim(); - let area = String(item.area || '').trim(); - let town = String(item.town || '').trim(); - const detailAddress = String(item.detailAddress || '').trim(); - const name = sanitizeName(item.name); - const mobile = sanitizeMobile(item.mobile); - - // 反向识别兜底 + 正则兜底,与单条解析保持一致 - const inferred = reverseInferAddress({ province, city, area, town, detailAddress, name, mobile }); - province = inferred.province; - city = inferred.city; - area = inferred.area; - if (!province) { - const regexResult = extractAddressByRegex(address); - if (regexResult.province) { - province = regexResult.province; - city = city || regexResult.city; - area = area || regexResult.area; - town = town || regexResult.town; - } - } - - if (!province || province === '暂未识别' || province === '其他') { - return { address, ok: false, flag: 'failure', message: '地址解析失败:省市区无法识别,请补充更多地址信息后重试', fields: null }; - } - return { - address, - ok: true, - flag: 'success', - message: 'ok', - fields: { province, city, area, town, detailAddress, name, mobile }, - }; - }); - } catch (error) { - this.ctx.logger.warn('[parseAddress] 批量一次性解析失败,将逐条回退: %s', error.message); - return null; - } - } /** - * 解析单条地址(parseAddress 单条/批量模式共用)。 + * 本地地址解析接口:不调用 AI,直接内置省市区地址字典数据,遍历识别省市区。 * - * @param {*} item 原始地址。 - * @return {Promise} { address, ok, flag, message, fields };fields 为解析字段对象或 null。 + * 与 parseAddress 使用同一套本地字典遍历解析逻辑,两者解析结果等价; + * - 单条:data.address 传字符串,返回单条解析结果(与 parseAddress 单条结构一致) + * - 批量:data.addresses(或 data.address)传字符串数组,返回 data.list, + * 每条含 address/flag/message 与解析字段,失败条目不影响其他条目 + * - 演示:address 与 addresses 均不传时,直接使用接口内置的示例地址数据 + * 遍历识别并返回 data.list(data.source=sample) + * + * 识别范围:province/city/area/town/detailAddress/mobile(name 本地不识别,返回空字符串)。 + * + * @param {Object} data 请求数据。 + * @param {string|string[]} [data.address] 原始地址字符串或字符串数组。 + * @param {string[]} [data.addresses] 批量地址字符串数组(与 address 数组二选一)。 + * @return {Promise} 解析结果;批量/演示模式返回 data.list 数组。 */ - async _parseSingleAddress(item) { - const address = String(item || '').trim(); - if (!address) { - return { address, ok: false, flag: 'failure', message: '地址字符串不能为空', fields: null }; + async parseAddressLocal(data = {}) { + const requestData = this.isPlainObject(data) ? data : {}; + + // 确定输入地址:addresses 数组 > address 数组 > address 字符串 > 内置示例地址数据 + let addresses; + let useSample = false; + if (Array.isArray(requestData.addresses)) { + addresses = requestData.addresses; + } else if (Array.isArray(requestData.address)) { + addresses = requestData.address; + } else if (String(requestData.address || '').trim()) { + addresses = [ String(requestData.address).trim() ]; + } else { + addresses = LOCAL_SAMPLE_ADDRESSES.slice(); + useSample = true; } - const apiKey = this.config.deepseek.apiKey; - const baseUrl = this.config.deepseek.baseUrl || 'https://api.deepseek.com'; - if (!apiKey) { - return { address, ok: false, flag: 'failure', message: 'DeepSeek API Key 未配置', fields: null }; + if (!addresses.length) { + return this.fail('地址数组不能为空'); + } + if (!useSample && addresses.length > 50) { + return this.fail('单次批量解析最多支持 50 条地址'); } - try { - // 仅在 parseAddress 使用 v4-flash(速度优先,适合批量解析),不改全局配置 - const model = 'deepseek-v4-flash'; - const prompt = `你是一个专业的中文地址解析助手,拥有丰富的中国地理知识。请解析以下地址字符串。 + const EMPTY_FIELDS = { province: '', city: '', area: '', town: '', detailAddress: '', name: '', mobile: '' }; + const toListItem = r => ({ + address: r.address, + flag: r.ok ? 'success' : 'failure', + message: r.message, + ...(r.ok && r.fields ? r.fields : EMPTY_FIELDS), + }); -规则: -1. 提取字段:province(省)、city(市)、area(区/县)、town(乡镇/街道)、detailAddress(详细地址)、name(收件人)、mobile(手机号) -2. **中国行政区划特殊规则(非常重要)**: - - 四大直辖市(北京、天津、上海、重庆):province填直辖市名,city填直辖市名,area填市辖区名(如"朝阳区") - - 省直辖县级市(如湖北仙桃/潜江/天门、河南济源、海南五指山/琼海/文昌/万宁/东方、新疆石河子等):province填省名,city填省名或留空,area填县级市名 - - 不设区的地级市(如东莞、中山、嘉峪关、儋州、三沙):province填省名,city填地级市名,area填地级市名或留空 - - 普通地级市代管的县级市(如苏州代管昆山、无锡代管江阴、潍坊代管寿光等):province填省名,city填地级市名,area填县级市名 -3. **利用你的中国地理知识**:如果地址缺少省份或城市信息,请检索你的知识库反向推断。例如: - - "仙桃市xxx路" → province=湖北省, city=湖北省, area=仙桃市(省直辖县级市) - - "昆山市xxx镇" → province=江苏省, city=苏州市, area=昆山市(苏州代管县级市) - - "广东省东莞市xxx镇" → province=广东省, city=东莞市, area=东莞市(不设区的地级市) - - "浙江省xxx村" → 根据村名命名习惯和方言特征推测所属城市 -4. 如果实在无法确定,province填"",city和area同理填"",收件人和name同理填"",mobile同理填""。 -5. detailAddress去除省市区部分,只保留街道/村/门牌号 -6. 地址字符串若出现重复拼接(如"陕西省延安市志丹县"出现两次),先智能去重再解析,合并保留重复部分中的街道/村信息 -7. 只返回纯JSON,不含解释或markdown - -地址字符串: "${address}" - -请返回JSON:`; - - const requestDeepSeek = async maxTokens => { - const result = await this.ctx.curl(`${baseUrl}/v1/chat/completions`, { - method: 'POST', - contentType: 'json', - dataType: 'json', - headers: { - Authorization: `Bearer ${apiKey}`, - }, - data: { - model, - messages: [ - { role: 'system', content: '你是一个专业的地址解析助手,只返回JSON格式结果。' }, - { role: 'user', content: prompt }, - ], - temperature: 0, - max_tokens: maxTokens, - }, - timeout: 60000, - }); - - if (result.status !== 200 || !result.data) { - return null; - } - const choice = result.data.choices?.[0] || {}; - return { - content: String(choice.message?.content || '').trim(), - reasoningContent: String(choice.message?.reasoning_content || '').trim(), - finishReason: choice.finish_reason || '', - }; - }; - - // deepseek-v4-flash 为思维链模型,max_tokens 过小时推理会耗尽全部配额, - // 导致 content 为空且 finish_reason=length。首次给足 3000 tokens, - // 仍被截断且无法从 reasoning_content 兜底时,加大到 8000 重试一次。 - let response = await requestDeepSeek(3000); - if ( - response - && response.finishReason === 'length' - && !response.content - && !salvageFieldsFromText(response.reasoningContent) - ) { - this.ctx.logger.warn('[parseAddress] 首次调用被截断(finish_reason=length),以 max_tokens=8000 重试'); - response = await requestDeepSeek(8000); + // 单条模式(向后兼容 parseAddress 单条返回结构) + if (!useSample && addresses.length === 1) { + const single = parseAddressByLocalDict(addresses[0]); + if (!single.ok) { + return this.fail(single.message); } - - if (!response) { - return { address, ok: false, flag: 'failure', message: '地址解析服务请求失败', fields: null }; - } - - const { content, reasoningContent, finishReason } = response; - this.ctx.logger.info('[parseAddress] DeepSeek原始返回 finish_reason=%s content: %s', finishReason, content || '(空)'); - - const tryParseJson = raw => { - try { - return JSON.parse(raw); - } catch (parseError) { - return null; - } - }; - - // 清理 markdown 代码块标记,并截取第一个 { 到最后一个 } 之间的 JSON 片段 - let parsed = tryParseJson(extractJsonBlock(content)); - if (!parsed) { - // 轻量修复:去除对象/数组内的尾随逗号后重试 - parsed = tryParseJson(extractJsonBlock(content).replace(/,\s*([}\]])/g, '$1')); - } - - // JSON 解析失败时,尝试从 content 或 reasoning_content 文本中做字段级提取兜底 - if (!parsed) { - parsed = salvageFieldsFromText(content || reasoningContent); - if (parsed) { - this.ctx.logger.warn('[parseAddress] 正文字段提取兜底结果: %j', parsed); - } - } - - if (!parsed) { - this.ctx.logger.warn('[parseAddress] JSON解析失败,finish_reason=%s,原始返回: %s', finishReason, content || reasoningContent); - if (finishReason === 'length') { - return { address, ok: false, flag: 'failure', message: '地址解析超时,请重试', fields: null }; - } - return { address, ok: false, flag: 'failure', message: '地址解析结果格式异常,请重试', fields: null }; - } - - let province = String(parsed.province || '').trim(); - let city = String(parsed.city || '').trim(); - let area = String(parsed.area || '').trim(); - let town = String(parsed.town || '').trim(); - const detailAddress = String(parsed.detailAddress || '').trim(); - const name = sanitizeName(parsed.name); - const mobile = sanitizeMobile(parsed.mobile); - - // --- 反向识别兜底:使用内置行政区划映射表补全缺失字段 --- - const inferred = reverseInferAddress({ - province, - city, - area, - town, - detailAddress, - name, - mobile, - }); - province = inferred.province; - city = inferred.city; - area = inferred.area; - - // --- 最终兜底:AI 与映射表均失败时,用正则从原始地址提取省市区 --- - if (!province) { - const regexResult = extractAddressByRegex(address); - if (regexResult.province) { - province = regexResult.province; - city = city || regexResult.city; - area = area || regexResult.area; - if (!town) { - town = regexResult.town; - } - this.ctx.logger.warn('[parseAddress] 正则兜底解析结果: %j', regexResult); - } - } - - // 反向识别后仍无 province 才判定失败 - if (!province || province === '暂未识别' || province === '其他') { - return { address, ok: false, flag: 'failure', message: '地址解析失败:省市区无法识别,请补充更多地址信息后重试', fields: null }; - } - - return { - address, - ok: true, - flag: 'success', - message: 'ok', - fields: { - province, - city, - area, - town, - detailAddress, - name, - mobile, - }, - }; - } catch (error) { - this.ctx.logger.error('[parseAddress] DeepSeek请求异常: %s', error.message); - return { address, ok: false, flag: 'failure', message: `地址解析失败: ${error.message}`, fields: null }; + return this.success('地址解析成功', single.fields); } + + const list = addresses.map(item => toListItem(parseAddressByLocalDict(item))); + const message = useSample ? '内置示例地址遍历识别成功' : '地址解析成功'; + return this.success(message, useSample ? { list, source: 'sample' } : { list }); } /**