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/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