feat(order): parseAddress 改为内置省市字典本地解析,新增 parseAddressLocal,移除 DeepSeek AI 解析依赖

This commit is contained in:
liufumingren 2026-09-23 02:46:16 +08:00
parent 01acf106ae
commit a078d74122
2 changed files with 337 additions and 399 deletions

View File

@ -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)

View File

@ -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<Object>} 解析结果;批量模式返回 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<Array|null>} 与入参顺序对齐的逐条结果数组;
* 请求失败/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<Object>} { 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<Object>} 解析结果;批量/演示模式返回 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 });
}
/**