feat(ai): W1-AI-CLOSURE 超级 Sprint — 9 APP 全链路收口 + chat 上下文真激活

Phase 2.3 chat 上下文捕获链路从未真正激活到完整工作:
- 14 处 ai-float-button 补 sourcePage,chat.ts 三分支同步设 pageFilters.contextId
- 后端 page_context 4 层 BUG 修(列名错位 + RLS site_id 未重设)
- xcx_chat filters.pop 破坏 body.page_context 引用 — dict() 浅拷贝隔离
- chat 流式 markdown 实时解析(表格/标题/列表/加粗 + KPI 富卡)
- reference_card KPI 富卡接入 SSE 路径,db 真写入
- 维客线索 source 显示规则:AI 来源用机器人 icon 替代长文字

数据库:
- public.member_retention_clue 加 emoji + runtime_mode + sandbox_instance_id
- biz.ai_run_logs 加 assistant_id + 复合索引
- chk_ai_cache_type CHECK 约束 8 类应用名
- cache_type / app_type 命名统一(app6_note / app7_customer / app8_consolidation)
- 历史 emoji 抽取脚本 44/44 成功

后端 silent failure 修:
- cleanup_service WHERE app_type → cache_type(90 天清理 + 20K 上限重新生效)
- _build_ai_insight 字段错位修复(app4 → app7 + 字段对齐 prompt schema)
- task_manager talkingPoints 改 app5_tactics + tactics 字段
- task_manager aiSuggestion 改取 one_line_summary
- cache_service.CACHE_EXPIRY_DAYS 加 app2a_finance_area
- WS /ws/ai-cache 加 token + JWT + site_id 校验(P0 信息泄露漏洞)
- internal_ai token 改 hmac.compare_digest

工具/文档:
- main.py 加 RotatingFileHandler logs/backend.log + uvicorn /health 过滤
- 新建 utils/clue_category.py(VI 6 类配色 + emoji fallback + source 显示规则)
- 新建 utils/markdown.ts(轻量 md 转 rich-text 解析 + streaming 容错)
- audit + 数据库变更说明 + backlog §七 #14 收口 + #15-#38 残余子任务
- backlog 追加 §十一 App1 参数/MCP/沙箱审计 + §十二 百炼/SQL MCP 主任务线

实地 MCP 走查:14 入口数据层 + 5 代表入口 sourcePage 注入 + customer-detail 全模块 + chat md 渲染 + reference_card 富卡 都已验证。9 项预先 BUG/UX 登记 §七 #29-#38 后续修复。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

apps/backend/app/schemas/member_retention_clue.py

@@ -1,7 +1,9 @@
 """
 维客线索相关 Pydantic 模型。
 
-大类枚举：客户基础信息、消费习惯、玩法偏好、促销偏好、社交关系、重要反馈
+大类枚举(6 类,与数据库 chk_retention_clue_category 约束 + ai/schemas
+App3CategoryEnum / App6CategoryEnum 完全对齐):
+客户基础、消费习惯、玩法偏好、促销偏好、社交关系、重要反馈
 """
 
 from datetime import datetime
@@ -12,8 +14,10 @@ from pydantic import BaseModel, Field
 
 
 class ClueCategory(str, Enum):
-    """维客线索大类枚举"""
-    BASIC_INFO = "客户基础信息"
+    """维客线索大类枚举(W1-AI-CLOSURE 组 5:'客户基础信息' 字面量纠正为 '客户基础',
+    旧值与数据库 CHECK 约束不一致,POST /api/retention-clue 写库会失败)。"""
+
+    BASIC_INFO = "客户基础"
     CONSUMPTION = "消费习惯"
     PLAY_PREF = "玩法偏好"
     PROMO_PREF = "促销偏好"

apps/backend/app/schemas/xcx_chat.py

@@ -40,12 +40,19 @@ class ChatHistoryResponse(CamelModel):
 
 
 class ReferenceCard(CamelModel):
-    """引用卡片，附加在 AI 回复消息中的结构化上下文数据。"""
+    """引用卡片,附加在消息中的结构化上下文数据。
 
-    type: str  # 'customer' | 'record'
+    W1-AI-CLOSURE 组 4 修正(P0-13):补全 link / source_page 字段,与
+    references.py:91 build_app1_reference_card 的实际输出对齐。之前 schema
+    缺这两字段导致 Pydantic 序列化时丢失,前端 wxml 的 link 跳转按钮永远拿不到 link。
+    """
+
+    type: str  # 'customer' | 'record' | 'member' | 'task' 等
     title: str
-    summary: str
-    data: dict[str, str]  # 键值对详情
+    summary: str = ""
+    data: dict[str, str] | None = None
+    link: str | None = None  # 跳转链接(如 /pages/customer-detail/...)
+    source_page: str | None = None  # 起源页面(用于回链定位)
 
 
 class ChatMessageItem(CamelModel):

apps/backend/app/schemas/xcx_customers.py

@@ -8,7 +8,12 @@ from app.schemas.base import CamelModel
 
 
 class AiStrategy(CamelModel):
-    color: str
+    """App7 客户分析策略单条(对齐 demo 标杆 wxml `{{item.text}}` 单字段)。
+
+    W1-AI-CLOSURE 组 3 + 复盘修正:服务层把 prompt schema 的 {title, content}
+    拼接成 demo 标杆的 text 单字段;color 由前端按 index 轮换 6 色。
+    """
+
     text: str
 
 class AiInsight(CamelModel):
@@ -71,8 +76,23 @@ class ConsumptionRecord(CamelModel):
     recharge_amount: float | None = None
 
 class RetentionClue(CamelModel):
-    type: str
+    """维客线索单条(对齐 clue-card 组件契约 + task-detail.ts 字段命名)。
+
+    W1-AI-CLOSURE 组 3 修正:从 {type, text} 2 字段扩展为 6 字段。
+    - tag: 中文分类(如 "客户基础"),前端 wxml 显示用,可由 css 强制两行
+    - tag_color: 6 类配色 alias(VI-DESIGN-SYSTEM §2.1:primary/success/orange/gold/purple/error)
+    - emoji: 独立 emoji 字符,App8 prompt 输出独立字段(W1-AI-CLOSURE 组 1 加列)
+    - text: summary 主文案(20 字内)
+    - source: 显示用来源("AI" / "系统" / 录入人姓名),前端拼 "By:" 前缀
+    - desc: detail 详情(120 字内,可空,前端可折叠展示)
+    """
+
+    tag: str
+    tag_color: str
+    emoji: str = ""
     text: str
+    source: str = ""
+    desc: str = ""
 
 class CustomerNote(CamelModel):
     id: int

apps/backend/app/schemas/xcx_tasks.py

@@ -123,8 +123,20 @@ class ServiceRecord(CamelModel):
     date: str
 
 
+class TacticItem(CamelModel):
+    """App5 话术单条(场景 + 话术)。
+
+    W1-AI-CLOSURE 组 3 修正:talking_points 从 list[str] 改为 list[TacticItem],
+    对齐 App5Result.tactics(prompt schema 权威 — 之前查的 cache_type
+    'app5_talking_points' 与字段 'talking_points' 全是不存在的幽灵命名,P0-6)。
+    """
+
+    scenario: str
+    script: str
+
+
 class AiAnalysis(CamelModel):
-    """AI 分析结果。"""
+    """AI 分析结果(对齐 App4Result one_line_summary + action_suggestions)。"""
 
     summary: str
     suggestions: list[str]
@@ -169,7 +181,7 @@ class TaskDetailResponse(CamelModel):
     balance: float | None = None
     # 扩展模块
     retention_clues: list[RetentionClue]
-    talking_points: list[str]
+    talking_points: list[TacticItem]
     service_summary: ServiceSummary
     service_records: list[ServiceRecord]
     ai_analysis: AiAnalysis