fix: 修复报告摘要生成并稳定默认端口

app/services/task_service.py

@@ -13,7 +13,7 @@ from app.platforms.base import PlatformAPIError, TikHubClient
 from app.platforms.douyin import DouyinPlatform
 from app.platforms.xiaohongshu import XiaohongshuPlatform
 from app.schemas import CreateTaskRequest
-from app.services.ai_service import OpenAICompatibleAIClient, analyze_comments_with_retry, calculate_analysis_status
+from app.services.ai_service import OpenAICompatibleAIClient, analyze_comments_with_retry, build_report_summary_prompt, calculate_analysis_status
 from app.services.report_service import generate_hotspot_report, generate_item_report
 
 
@@ -52,16 +52,25 @@ def build_platform(platform: str):
     raise ValueError(f"Unsupported platform: {platform}")
 
 
-def build_ai_requester():
+def build_ai_client() -> OpenAICompatibleAIClient | None:
     settings = get_settings()
     if settings.ai_base_url and settings.ai_api_key and settings.ai_model:
-        client = OpenAICompatibleAIClient(
+        return OpenAICompatibleAIClient(
             base_url=settings.ai_base_url,
             api_key=settings.ai_api_key,
             model=settings.ai_model,
             timeout_seconds=settings.ai_timeout_seconds,
         )
-        return client.request
+    return None
+
+
+def build_ai_requester(client: OpenAICompatibleAIClient | None = None):
+    client = client if client is not None else build_ai_client()
+    if client is not None:
+        return lambda prompt: client.request(
+            prompt,
+            system_prompt="只返回 JSON Array，不输出 Markdown 或解释性自然语言。",
+        )
 
     def fallback_requester(_prompt: str) -> str:
         return "[]"
@@ -69,6 +78,25 @@ def build_ai_requester():
     return fallback_requester
 
 
+def build_report_summary_provider(client: OpenAICompatibleAIClient | None):
+    if client is None:
+        return None
+
+    def summarize_report(metrics: dict, typical: dict, *, word_limit: int = 200) -> str:
+        return client.request(
+            build_report_summary_prompt(metrics, typical, word_limit=word_limit),
+            system_prompt="只返回一段中文总结，不使用 Markdown。",
+        )
+
+    return summarize_report
+
+
+def build_ai_dependencies():
+    client = build_ai_client()
+    requester = build_ai_requester(client)
+    return requester, build_report_summary_provider(client)
+
+
 def create_task(session: Session, request: CreateTaskRequest, *, submit_background: bool = True) -> Task:
     task = Task(
         platform=request.platform,
@@ -108,6 +136,8 @@ def run_task(task_id: str, *, session_factory: Callable[[], Session] | sessionma
             return
         try:
             platform = build_platform(task.platform)
+            ai_requester, report_summary_provider = build_ai_dependencies()
+
             try:
                 hotspots = platform.fetch_hotspots(limit=task.hotspot_limit)
             except PlatformAPIError as exc:
@@ -183,7 +213,7 @@ def run_task(task_id: str, *, session_factory: Callable[[], Session] | sessionma
                         item_comments = list(session.scalars(select(Comment).where(Comment.content_item_id == item.id)))
                         ai_results = analyze_comments_with_retry(
                             [{"comment_id": comment.id, "content": comment.content} for comment in item_comments],
-                            requester=build_ai_requester(),
+                            requester=ai_requester,
                             max_retries=get_settings().ai_max_retries,
                         )
                         results_by_comment_id = {result.comment_id: result for result in ai_results}
@@ -201,7 +231,7 @@ def run_task(task_id: str, *, session_factory: Callable[[], Session] | sessionma
                             comment.ai_analysis_status = result.ai_analysis_status
                         item.status = "success"
                         task.successful_items_count += 1
-                        generate_item_report(session, item.id)
+                        generate_item_report(session, item.id, summary_provider=report_summary_provider)
                     except Exception as exc:
                         item.status = "failed"
                         item.error_stage = "crawl_comments"
@@ -223,7 +253,7 @@ def run_task(task_id: str, *, session_factory: Callable[[], Session] | sessionma
                     total_count=total_comments,
                 )
                 for hotspot in task.hotspots:
-                    generate_hotspot_report(session, hotspot.id)
+                    generate_hotspot_report(session, hotspot.id, summary_provider=report_summary_provider)
                 task.status = "success"
             else:
                 _mark_task_failed(task, task.error_stage or "crawl_items", task.error_type or "no_successful_items", task.error_message or "没有任何内容条目成功")