6f7840cf
tangwang
refactor: rename ...
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
#!/usr/bin/env python3
"""
商品内容理解与属性补充模块(product_enrich)
提供基于 LLM 的商品锚文本 / 语义属性 / 标签等分析能力,
供 indexer 与 API 在内存中调用(不再负责 CSV 读写)。
"""
import os
import json
import logging
import time
import hashlib
|
a73a751f
tangwang
enrich
|
14
|
from collections import OrderedDict
|
6f7840cf
tangwang
refactor: rename ...
|
15
16
17
18
19
20
21
22
23
|
from datetime import datetime
from typing import List, Dict, Tuple, Any, Optional
import redis
import requests
from pathlib import Path
from config.env_config import REDIS_CONFIG
from config.tenant_config_loader import SOURCE_LANG_CODE_MAP
|
a73a751f
tangwang
enrich
|
24
25
26
27
28
29
|
from indexer.product_enrich_prompts import (
SYSTEM_MESSAGE,
USER_INSTRUCTION_TEMPLATE,
LANGUAGE_MARKDOWN_TABLE_HEADERS,
SHARED_ANALYSIS_INSTRUCTION,
)
|
6f7840cf
tangwang
refactor: rename ...
|
30
31
32
33
34
35
36
37
38
39
40
41
|
# 配置
BATCH_SIZE = 20
# 华北2(北京):https://dashscope.aliyuncs.com/compatible-mode/v1
# 新加坡:https://dashscope-intl.aliyuncs.com/compatible-mode/v1
# 美国(弗吉尼亚):https://dashscope-us.aliyuncs.com/compatible-mode/v1
API_BASE_URL = "https://dashscope-us.aliyuncs.com/compatible-mode/v1"
MODEL_NAME = "qwen-flash"
API_KEY = os.environ.get("DASHSCOPE_API_KEY")
MAX_RETRIES = 3
RETRY_DELAY = 5 # 秒
REQUEST_TIMEOUT = 180 # 秒
|
a73a751f
tangwang
enrich
|
42
|
LOGGED_SHARED_CONTEXT_CACHE_SIZE = 256
|
6f7840cf
tangwang
refactor: rename ...
|
43
44
45
46
47
48
49
50
51
52
|
# 日志路径
OUTPUT_DIR = Path("output_logs")
LOG_DIR = OUTPUT_DIR / "logs"
# 设置独立日志(不影响全局 indexer.log)
LOG_DIR.mkdir(parents=True, exist_ok=True)
timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
log_file = LOG_DIR / f"product_enrich_{timestamp}.log"
verbose_log_file = LOG_DIR / "product_enrich_verbose.log"
|
a73a751f
tangwang
enrich
|
53
|
_logged_shared_context_keys: "OrderedDict[str, None]" = OrderedDict()
|
6f7840cf
tangwang
refactor: rename ...
|
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
# 主日志 logger:执行流程、批次信息等
logger = logging.getLogger("product_enrich")
logger.setLevel(logging.INFO)
if not logger.handlers:
formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")
file_handler = logging.FileHandler(log_file, encoding="utf-8")
file_handler.setFormatter(formatter)
stream_handler = logging.StreamHandler()
stream_handler.setFormatter(formatter)
logger.addHandler(file_handler)
logger.addHandler(stream_handler)
# 避免日志向根 logger 传播,防止写入 logs/indexer.log 等其他文件
logger.propagate = False
# 详尽日志 logger:专门记录 LLM 请求与响应
verbose_logger = logging.getLogger("product_enrich_verbose")
verbose_logger.setLevel(logging.INFO)
if not verbose_logger.handlers:
verbose_formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")
verbose_file_handler = logging.FileHandler(verbose_log_file, encoding="utf-8")
verbose_file_handler.setFormatter(verbose_formatter)
verbose_logger.addHandler(verbose_file_handler)
verbose_logger.propagate = False
# Redis 缓存(用于 anchors / 语义属性)
ANCHOR_CACHE_PREFIX = REDIS_CONFIG.get("anchor_cache_prefix", "product_anchors")
ANCHOR_CACHE_EXPIRE_DAYS = int(REDIS_CONFIG.get("anchor_cache_expire_days", 30))
_anchor_redis: Optional[redis.Redis] = None
try:
_anchor_redis = redis.Redis(
host=REDIS_CONFIG.get("host", "localhost"),
port=REDIS_CONFIG.get("port", 6479),
password=REDIS_CONFIG.get("password"),
decode_responses=True,
socket_timeout=REDIS_CONFIG.get("socket_timeout", 1),
socket_connect_timeout=REDIS_CONFIG.get("socket_connect_timeout", 1),
retry_on_timeout=REDIS_CONFIG.get("retry_on_timeout", False),
health_check_interval=10,
)
_anchor_redis.ping()
logger.info("Redis cache initialized for product anchors and semantic attributes")
except Exception as e:
logger.warning(f"Failed to initialize Redis for anchors cache: {e}")
_anchor_redis = None
|
a73a751f
tangwang
enrich
|
108
109
110
111
112
|
_missing_prompt_langs = sorted(set(SOURCE_LANG_CODE_MAP) - set(LANGUAGE_MARKDOWN_TABLE_HEADERS))
if _missing_prompt_langs:
raise RuntimeError(
f"Missing product_enrich prompt config for languages: {_missing_prompt_langs}"
)
|
6f7840cf
tangwang
refactor: rename ...
|
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
def _make_anchor_cache_key(
title: str,
target_lang: str,
tenant_id: Optional[str] = None,
) -> str:
"""构造 anchors/语义属性的缓存 key。"""
base = (tenant_id or "global").strip()
h = hashlib.md5(title.encode("utf-8")).hexdigest()
return f"{ANCHOR_CACHE_PREFIX}:{base}:{target_lang}:{h}"
def _get_cached_anchor_result(
title: str,
target_lang: str,
tenant_id: Optional[str] = None,
) -> Optional[Dict[str, Any]]:
if not _anchor_redis:
return None
try:
key = _make_anchor_cache_key(title, target_lang, tenant_id)
raw = _anchor_redis.get(key)
if not raw:
return None
return json.loads(raw)
except Exception as e:
logger.warning(f"Failed to get anchor cache: {e}")
return None
def _set_cached_anchor_result(
title: str,
target_lang: str,
result: Dict[str, Any],
tenant_id: Optional[str] = None,
) -> None:
if not _anchor_redis:
return
try:
key = _make_anchor_cache_key(title, target_lang, tenant_id)
ttl = ANCHOR_CACHE_EXPIRE_DAYS * 24 * 3600
_anchor_redis.setex(key, ttl, json.dumps(result, ensure_ascii=False))
except Exception as e:
logger.warning(f"Failed to set anchor cache: {e}")
|
a73a751f
tangwang
enrich
|
160
161
162
163
|
def _build_assistant_prefix(headers: List[str]) -> str:
header_line = "| " + " | ".join(headers) + " |"
separator_line = "|" + "----|" * len(headers)
return f"{header_line}\n{separator_line}\n"
|
6f7840cf
tangwang
refactor: rename ...
|
164
|
|
6f7840cf
tangwang
refactor: rename ...
|
165
|
|
a73a751f
tangwang
enrich
|
166
167
|
def _build_shared_context(products: List[Dict[str, str]]) -> str:
shared_context = SHARED_ANALYSIS_INSTRUCTION
|
6f7840cf
tangwang
refactor: rename ...
|
168
|
for idx, product in enumerate(products, 1):
|
a73a751f
tangwang
enrich
|
169
170
|
shared_context += f'{idx}. {product["title"]}\n'
return shared_context
|
6f7840cf
tangwang
refactor: rename ...
|
171
|
|
6f7840cf
tangwang
refactor: rename ...
|
172
|
|
a73a751f
tangwang
enrich
|
173
174
175
176
177
178
179
180
181
182
183
184
185
|
def _hash_text(text: str) -> str:
return hashlib.md5((text or "").encode("utf-8")).hexdigest()[:12]
def _mark_shared_context_logged_once(shared_context_key: str) -> bool:
if shared_context_key in _logged_shared_context_keys:
_logged_shared_context_keys.move_to_end(shared_context_key)
return False
_logged_shared_context_keys[shared_context_key] = None
if len(_logged_shared_context_keys) > LOGGED_SHARED_CONTEXT_CACHE_SIZE:
_logged_shared_context_keys.popitem(last=False)
return True
|
6f7840cf
tangwang
refactor: rename ...
|
186
|
|
6f7840cf
tangwang
refactor: rename ...
|
187
|
|
a73a751f
tangwang
enrich
|
188
189
190
|
def reset_logged_shared_context_keys() -> None:
"""测试辅助:清理已记录的共享 prompt key。"""
_logged_shared_context_keys.clear()
|
6f7840cf
tangwang
refactor: rename ...
|
191
|
|
a73a751f
tangwang
enrich
|
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
|
def create_prompt(
products: List[Dict[str, str]],
target_lang: str = "zh",
) -> Tuple[str, str, str]:
"""根据目标语言创建共享上下文、本地化输出要求和 Partial Mode assistant 前缀。"""
markdown_table_headers = LANGUAGE_MARKDOWN_TABLE_HEADERS.get(target_lang)
if not markdown_table_headers:
logger.warning(
"Unsupported target_lang for markdown table headers: %s",
target_lang,
)
return None, None, None
shared_context = _build_shared_context(products)
language_label = SOURCE_LANG_CODE_MAP.get(target_lang, target_lang)
user_prompt = USER_INSTRUCTION_TEMPLATE.format(language=language_label).strip()
assistant_prefix = _build_assistant_prefix(markdown_table_headers)
return shared_context, user_prompt, assistant_prefix
def _merge_partial_response(assistant_prefix: str, generated_content: str) -> str:
"""将 Partial Mode 的 assistant 前缀与补全文本拼成完整 markdown。"""
generated = (generated_content or "").lstrip()
prefix_lines = [line.strip() for line in assistant_prefix.strip().splitlines()]
generated_lines = generated.splitlines()
if generated_lines:
first_line = generated_lines[0].strip()
if prefix_lines and first_line == prefix_lines[0]:
generated_lines = generated_lines[1:]
if generated_lines and len(prefix_lines) > 1 and generated_lines[0].strip() == prefix_lines[1]:
generated_lines = generated_lines[1:]
elif len(prefix_lines) > 1 and first_line == prefix_lines[1]:
generated_lines = generated_lines[1:]
suffix = "\n".join(generated_lines).lstrip("\n")
if suffix:
return f"{assistant_prefix}{suffix}"
return assistant_prefix
def call_llm(
shared_context: str,
user_prompt: str,
assistant_prefix: str,
target_lang: str = "zh",
) -> Tuple[str, str]:
"""调用大模型 API(带重试机制),使用 Partial Mode 强制 markdown 表格前缀。"""
|
6f7840cf
tangwang
refactor: rename ...
|
240
241
242
243
|
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
}
|
a73a751f
tangwang
enrich
|
244
245
246
|
shared_context_key = _hash_text(shared_context)
localized_tail_key = _hash_text(f"{target_lang}\n{user_prompt}\n{assistant_prefix}")
combined_user_prompt = f"{shared_context.rstrip()}\n\n{user_prompt.strip()}"
|
6f7840cf
tangwang
refactor: rename ...
|
247
248
249
250
251
252
|
payload = {
"model": MODEL_NAME,
"messages": [
{
"role": "system",
|
a73a751f
tangwang
enrich
|
253
|
"content": SYSTEM_MESSAGE,
|
6f7840cf
tangwang
refactor: rename ...
|
254
255
256
|
},
{
"role": "user",
|
a73a751f
tangwang
enrich
|
257
258
259
260
261
262
|
"content": combined_user_prompt,
},
{
"role": "assistant",
"content": assistant_prefix,
"partial": True,
|
6f7840cf
tangwang
refactor: rename ...
|
263
264
265
266
267
268
269
270
271
272
273
|
},
],
"temperature": 0.3,
"top_p": 0.8,
}
request_data = {
"headers": {k: v for k, v in headers.items() if k != "Authorization"},
"payload": payload,
}
|
a73a751f
tangwang
enrich
|
274
275
276
277
278
279
280
281
282
283
|
if _mark_shared_context_logged_once(shared_context_key):
logger.info(f"\n{'=' * 80}")
logger.info(
"LLM Shared Context [model=%s, shared_key=%s, chars=%s] (logged once per process key)",
MODEL_NAME,
shared_context_key,
len(shared_context),
)
logger.info("\nSystem Message:\n%s", SYSTEM_MESSAGE)
logger.info("\nShared Context:\n%s", shared_context)
|
6f7840cf
tangwang
refactor: rename ...
|
284
285
|
verbose_logger.info(f"\n{'=' * 80}")
|
a73a751f
tangwang
enrich
|
286
287
288
289
290
291
292
|
verbose_logger.info(
"LLM Request [model=%s, lang=%s, shared_key=%s, tail_key=%s]:",
MODEL_NAME,
target_lang,
shared_context_key,
localized_tail_key,
)
|
6f7840cf
tangwang
refactor: rename ...
|
293
|
verbose_logger.info(json.dumps(request_data, ensure_ascii=False, indent=2))
|
a73a751f
tangwang
enrich
|
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
|
verbose_logger.info(f"\nCombined User Prompt:\n{combined_user_prompt}")
verbose_logger.info(f"\nShared Context:\n{shared_context}")
verbose_logger.info(f"\nLocalized Requirement:\n{user_prompt}")
verbose_logger.info(f"\nAssistant Prefix:\n{assistant_prefix}")
logger.info(
"\nLLM Request Variant [lang=%s, shared_key=%s, tail_key=%s, prompt_chars=%s, prefix_chars=%s]",
target_lang,
shared_context_key,
localized_tail_key,
len(user_prompt),
len(assistant_prefix),
)
logger.info("\nLocalized Requirement:\n%s", user_prompt)
logger.info("\nAssistant Prefix:\n%s", assistant_prefix)
|
6f7840cf
tangwang
refactor: rename ...
|
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
|
# 创建session,禁用代理
session = requests.Session()
session.trust_env = False # 忽略系统代理设置
try:
# 重试机制
for attempt in range(MAX_RETRIES):
try:
response = session.post(
f"{API_BASE_URL}/chat/completions",
headers=headers,
json=payload,
timeout=REQUEST_TIMEOUT,
proxies={"http": None, "https": None}, # 明确禁用代理
)
response.raise_for_status()
result = response.json()
|
a73a751f
tangwang
enrich
|
328
329
330
331
332
333
334
335
336
337
|
usage = result.get("usage") or {}
verbose_logger.info(
"\nLLM Response [model=%s, lang=%s, shared_key=%s, tail_key=%s]:",
MODEL_NAME,
target_lang,
shared_context_key,
localized_tail_key,
)
verbose_logger.info(json.dumps(result, ensure_ascii=False, indent=2))
|
6f7840cf
tangwang
refactor: rename ...
|
338
|
|
a73a751f
tangwang
enrich
|
339
340
|
generated_content = result["choices"][0]["message"]["content"]
full_markdown = _merge_partial_response(assistant_prefix, generated_content)
|
6f7840cf
tangwang
refactor: rename ...
|
341
|
|
a73a751f
tangwang
enrich
|
342
343
344
345
346
347
348
349
350
351
352
353
|
logger.info(
"\nLLM Response Summary [lang=%s, shared_key=%s, tail_key=%s, generated_chars=%s, completion_tokens=%s, prompt_tokens=%s, total_tokens=%s]",
target_lang,
shared_context_key,
localized_tail_key,
len(generated_content or ""),
usage.get("completion_tokens"),
usage.get("prompt_tokens"),
usage.get("total_tokens"),
)
logger.info("\nGenerated Content:\n%s", generated_content)
logger.info("\nMerged Markdown:\n%s", full_markdown)
|
6f7840cf
tangwang
refactor: rename ...
|
354
|
|
a73a751f
tangwang
enrich
|
355
356
|
verbose_logger.info(f"\nGenerated Content:\n{generated_content}")
verbose_logger.info(f"\nMerged Markdown:\n{full_markdown}")
|
6f7840cf
tangwang
refactor: rename ...
|
357
|
|
a73a751f
tangwang
enrich
|
358
|
return full_markdown, json.dumps(result, ensure_ascii=False)
|
6f7840cf
tangwang
refactor: rename ...
|
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
|
except requests.exceptions.ProxyError as e:
logger.warning(f"Attempt {attempt + 1}/{MAX_RETRIES}: Proxy error - {str(e)}")
if attempt < MAX_RETRIES - 1:
logger.info(f"Retrying in {RETRY_DELAY} seconds...")
time.sleep(RETRY_DELAY)
else:
raise
except requests.exceptions.RequestException as e:
logger.warning(f"Attempt {attempt + 1}/{MAX_RETRIES}: Request error - {str(e)}")
if attempt < MAX_RETRIES - 1:
logger.info(f"Retrying in {RETRY_DELAY} seconds...")
time.sleep(RETRY_DELAY)
else:
raise
except Exception as e:
logger.error(f"Unexpected error on attempt {attempt + 1}/{MAX_RETRIES}: {str(e)}")
if attempt < MAX_RETRIES - 1:
logger.info(f"Retrying in {RETRY_DELAY} seconds...")
time.sleep(RETRY_DELAY)
else:
raise
finally:
session.close()
def parse_markdown_table(markdown_content: str) -> List[Dict[str, str]]:
"""解析markdown表格内容"""
lines = markdown_content.strip().split("\n")
data = []
data_started = False
for line in lines:
line = line.strip()
if not line:
continue
# 表格行处理
if line.startswith("|"):
# 分隔行(---- 或 :---: 等;允许空格,如 "| ---- | ---- |")
sep_chars = line.replace("|", "").strip().replace(" ", "")
if sep_chars and set(sep_chars) <= {"-", ":"}:
data_started = True
continue
# 首个表头行:无论语言如何,统一跳过
if not data_started:
# 等待下一行数据行
continue
# 解析数据行
parts = [p.strip() for p in line.split("|")]
parts = [p for p in parts if p] # 移除空字符串
if len(parts) >= 2:
row = {
"seq_no": parts[0],
"title": parts[1], # 商品标题(按目标语言)
"category_path": parts[2] if len(parts) > 2 else "", # 品类路径
"tags": parts[3] if len(parts) > 3 else "", # 细分标签
"target_audience": parts[4] if len(parts) > 4 else "", # 适用人群
"usage_scene": parts[5] if len(parts) > 5 else "", # 使用场景
"season": parts[6] if len(parts) > 6 else "", # 适用季节
"key_attributes": parts[7] if len(parts) > 7 else "", # 关键属性
"material": parts[8] if len(parts) > 8 else "", # 材质说明
"features": parts[9] if len(parts) > 9 else "", # 功能特点
"selling_points": parts[10] if len(parts) > 10 else "", # 商品卖点
"anchor_text": parts[11] if len(parts) > 11 else "", # 锚文本
}
data.append(row)
return data
|
a73a751f
tangwang
enrich
|
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
|
def _log_parsed_result_quality(
batch_data: List[Dict[str, str]],
parsed_results: List[Dict[str, str]],
target_lang: str,
batch_num: int,
) -> None:
expected = len(batch_data)
actual = len(parsed_results)
if actual != expected:
logger.warning(
"Parsed row count mismatch for batch=%s lang=%s: expected=%s actual=%s",
batch_num,
target_lang,
expected,
actual,
)
missing_anchor = sum(1 for item in parsed_results if not str(item.get("anchor_text") or "").strip())
missing_category = sum(1 for item in parsed_results if not str(item.get("category_path") or "").strip())
missing_title = sum(1 for item in parsed_results if not str(item.get("title") or "").strip())
logger.info(
"Parsed Quality Summary [batch=%s, lang=%s]: rows=%s/%s, missing_title=%s, missing_category=%s, missing_anchor=%s",
batch_num,
target_lang,
actual,
expected,
missing_title,
missing_category,
missing_anchor,
)
|
6f7840cf
tangwang
refactor: rename ...
|
469
470
471
472
473
474
475
476
477
478
|
def process_batch(
batch_data: List[Dict[str, str]],
batch_num: int,
target_lang: str = "zh",
) -> List[Dict[str, str]]:
"""处理一个批次的数据"""
logger.info(f"\n{'#' * 80}")
logger.info(f"Processing Batch {batch_num} ({len(batch_data)} items)")
# 创建提示词
|
a73a751f
tangwang
enrich
|
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
|
shared_context, user_prompt, assistant_prefix = create_prompt(
batch_data,
target_lang=target_lang,
)
# 如果提示词创建失败(例如不支持的 target_lang),本次批次整体失败,不再继续调用 LLM
if shared_context is None or user_prompt is None or assistant_prefix is None:
logger.error(
"Failed to create prompt for batch %s, target_lang=%s; "
"marking entire batch as failed without calling LLM",
batch_num,
target_lang,
)
return [
{
"id": item["id"],
"lang": target_lang,
"title_input": item.get("title", ""),
"title": "",
"category_path": "",
"tags": "",
"target_audience": "",
"usage_scene": "",
"season": "",
"key_attributes": "",
"material": "",
"features": "",
"selling_points": "",
"anchor_text": "",
"error": f"prompt_creation_failed: unsupported target_lang={target_lang}",
}
for item in batch_data
]
|
6f7840cf
tangwang
refactor: rename ...
|
512
513
514
|
# 调用LLM
try:
|
a73a751f
tangwang
enrich
|
515
516
517
518
519
520
|
raw_response, full_response_json = call_llm(
shared_context,
user_prompt,
assistant_prefix,
target_lang=target_lang,
)
|
6f7840cf
tangwang
refactor: rename ...
|
521
522
523
|
# 解析结果
parsed_results = parse_markdown_table(raw_response)
|
a73a751f
tangwang
enrich
|
524
|
_log_parsed_result_quality(batch_data, parsed_results, target_lang, batch_num)
|
6f7840cf
tangwang
refactor: rename ...
|
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
|
logger.info(f"\nParsed Results ({len(parsed_results)} items):")
logger.info(json.dumps(parsed_results, ensure_ascii=False, indent=2))
# 映射回原始ID
results_with_ids = []
for i, parsed_item in enumerate(parsed_results):
if i < len(batch_data):
original_id = batch_data[i]["id"]
result = {
"id": original_id,
"lang": target_lang,
"title_input": batch_data[i]["title"], # 原始输入标题
"title": parsed_item.get("title", ""), # 模型生成的标题
"category_path": parsed_item.get("category_path", ""), # 品类路径
"tags": parsed_item.get("tags", ""), # 细分标签
"target_audience": parsed_item.get("target_audience", ""), # 适用人群
"usage_scene": parsed_item.get("usage_scene", ""), # 使用场景
"season": parsed_item.get("season", ""), # 适用季节
"key_attributes": parsed_item.get("key_attributes", ""), # 关键属性
"material": parsed_item.get("material", ""), # 材质说明
"features": parsed_item.get("features", ""), # 功能特点
"selling_points": parsed_item.get("selling_points", ""), # 商品卖点
"anchor_text": parsed_item.get("anchor_text", ""), # 锚文本
}
results_with_ids.append(result)
logger.info(f"Mapped: seq={parsed_item['seq_no']} -> original_id={original_id}")
# 保存批次 JSON 日志到独立文件
batch_log = {
"batch_num": batch_num,
"timestamp": datetime.now().isoformat(),
"input_products": batch_data,
"raw_response": raw_response,
"full_response_json": full_response_json,
"parsed_results": parsed_results,
"final_results": results_with_ids,
}
batch_log_file = LOG_DIR / f"batch_{batch_num:04d}_{timestamp}.json"
with open(batch_log_file, "w", encoding="utf-8") as f:
json.dump(batch_log, f, ensure_ascii=False, indent=2)
logger.info(f"Batch log saved to: {batch_log_file}")
return results_with_ids
except Exception as e:
logger.error(f"Error processing batch {batch_num}: {str(e)}", exc_info=True)
# 返回空结果,保持ID映射
return [
{
"id": item["id"],
"lang": target_lang,
"title_input": item["title"],
"title": "",
"category_path": "",
"tags": "",
"target_audience": "",
"usage_scene": "",
"season": "",
"key_attributes": "",
"material": "",
"features": "",
"selling_points": "",
"anchor_text": "",
"error": str(e),
}
for item in batch_data
]
def analyze_products(
products: List[Dict[str, str]],
target_lang: str = "zh",
batch_size: Optional[int] = None,
tenant_id: Optional[str] = None,
) -> List[Dict[str, Any]]:
"""
库调用入口:根据输入+语言,返回锚文本及各维度信息。
Args:
products: [{"id": "...", "title": "..."}]
target_lang: 输出语言
batch_size: 批大小,默认使用全局 BATCH_SIZE
"""
if not API_KEY:
raise RuntimeError("DASHSCOPE_API_KEY is not set, cannot call LLM")
if not products:
return []
# 简单路径:索引阶段通常 batch_size=1,这里优先做单条缓存命中
if len(products) == 1:
p = products[0]
title = str(p.get("title") or "").strip()
if title:
cached = _get_cached_anchor_result(title, target_lang, tenant_id=tenant_id)
if cached:
logger.info(
f"[analyze_products] Cache hit for title='{title[:50]}...', "
f"lang={target_lang}, tenant_id={tenant_id or 'global'}"
)
return [cached]
# call_llm 一次处理上限固定为 BATCH_SIZE(默认 20):
# - 尽可能攒批处理;
# - 即便调用方传入更大的 batch_size,也会自动按上限拆批。
req_bs = BATCH_SIZE if batch_size is None else int(batch_size)
bs = max(1, min(req_bs, BATCH_SIZE))
all_results: List[Dict[str, Any]] = []
total_batches = (len(products) + bs - 1) // bs
for i in range(0, len(products), bs):
batch_num = i // bs + 1
batch = products[i : i + bs]
logger.info(
f"[analyze_products] Processing batch {batch_num}/{total_batches}, "
f"size={len(batch)}, target_lang={target_lang}"
)
batch_results = process_batch(batch, batch_num=batch_num, target_lang=target_lang)
all_results.extend(batch_results)
# 写入缓存
for item in batch_results:
title_input = str(item.get("title_input") or "").strip()
if not title_input:
continue
if item.get("error"):
# 不缓存错误结果,避免放大临时故障
continue
try:
_set_cached_anchor_result(title_input, target_lang, item, tenant_id=tenant_id)
except Exception:
# 已在内部记录 warning
pass
return all_results
|