宝锐工作台 · AI 助手 Tab 强化工作流

🎯 定位

baoyu-sales-copilot = 总架构（四步闭环 / 四 Tab / 数据源 / IMA / 订单 / 顺丰全景）。
本技能 = 其中 AI 助手 Tab 的强化深化，把「被动问答框」升级为「主动参谋」。

核心一句话：销售不用记得问，AI 在四步闭环的每一步主动把弹药递到手上。

🔔 触发场景（When to Use）

用户要求「强化 / 优化 AI 助手 Tab」，或讨论 AI 助手如何从被动问答变成主动参谋
用户提到「客户 360 全景」「行动项转待办」「沉淀自动化」「拜访前主动提醒」
需要设计 AI 助手 Tab 的四步闭环工作流，或把 Copilot 心智注入 AI 助手

🧱 现有 AI 助手能力（2026-08-22 基线，改造前先复习）

/api/chat 多轮 messages（截断16条）+ files 上传（Excel/CSV/PDF/Word/图片OCR）+ sources 溯源
背景检索三通道：飞书活动 daily_activities_mcp.json + 产品 _all_products.json + IMA 知识库 _search_knowledge_base()
历史持久化 数据/chat_history.json（按 name 分桶，admin 全见，禁止进 CloudBase）
经验归档 /api/archive_experience（多轮问答链 → 结构化经验）+ /api/ima_review（submit→审核→写库）
三条铁律：只答工作问题 / 客户权限隔离 _visible_for_user / 行业竞品自由回答
DeepSeek V4 Pro，必须 thinking:{'type':'disabled'}（否则答案在 reasoning_content）

🔍 核心诊断：三个断点

#	断点	现状	后果
1	四步闭环没进 AI 助手	通用问答框，无「分析/传递/跟进/沉淀」步骤引导	销售不知道「现在该问什么」
2	背景检索被动触发	只按问题关键词检索，只接活动+产品+IMA 三通道	订单/客诉/商机问不了；不提客户名不给全景
3	产出不落回闭环	「下一步」是文字不转待办；沉淀靠手动点按钮	跟进断档、沉淀靠自觉

🧭 优化工作流总览

🔍分析

▶

📢传递

▶

✅跟进

▶

📖沉淀

客户360全景主动预加载 · 场景话术/价值主张 · 行动项一键转待办 · 主动提示「该沉淀了」
数据底座（订单/客诉/商机/活动/产品/IMA/价格）全接入
▲ 每次沉淀回流知识库，反哺下一次分析（飞轮）

⚡ 五个强化点

P0-1 · 客户 360° 全景主动预加载「一问就全」

识别到客户名（提问 / 上传文件 / 作战准备 Tab 带过来）后，主动拉 6 维全景注入 system prompt：

维度	数据源
订单/物流	`shipment_status.json`（近90天明细）
客诉	`mcp_complaints.json`
商机	`opportunity_sandbox.json`
活动记录	`daily_activities_mcp.json`
竞品情报	IMA + `知识库-copilot/`
已有材料	`file_manifest.json`（是否已生成拜访卡/调研卡）

实现：ai_chat._load_customer360(cust) 六维拉取 → 生成摘要 → 注入。验收：问「迈克生物最近怎么样」一次答全订单+客诉+商机+竞品。

P0-2 · 四步闭环引导条「你现在在哪一步」

AI 助手 Tab 顶部加步骤切换条 🔍分析 · 📢传递 · ✅跟进 · 📖沉淀，切换后 AI 换「参谋模式」：

模式	AI 主动做什么
🔍 分析	客户画像 / 痛点 / 竞品 / 机会，列出「该问客户什么」
📢 传递	话术库场景话术、价值主张、异议处理
✅ 跟进	结论拆行动项（负责人/截止日），一键转待办
📖 沉淀	引导回写经验库，提示飞轮闭环

这是把 Copilot 四 Tab 的「心智」搬进 AI 助手，两者共享同一闭环。

P0-3 · 行动项一键转待办「说了就记」

AI 回答识别出「行动项/下一步/建议动作」→ 前端「＋转待办」→ 写入待办推进 Tab 的 copilot_todos（负责人/截止日/优先级）→ 超期自动标红。打通 AI 助手 ↔ 待办推进。

P1-4 · 沉淀闭环自动化「该沉淀了」

AI 判断触发条件（追问 ≥3 轮或涉及具体客户或有明确结论）→ 主动提示「这段对话有沉淀价值，要提炼成经验吗？」→ 确认走既有 archive_experience → 审核入库。飞轮真正转起来。

P2-5 · 拜访前主动提醒「明天见谁、带什么」

登录时读访前准备 Tab 的拜访日期，48h 内有拜访则主动推送：「你 8/25 拜访迈克生物，作战卡已备好，要点：冻干+快速扩增追赶窗口、竞品圣湘已卡位」。一键打开作战卡。这是「被动问答」到「主动参谋」的质变。

🗺 落地路线图

阶段	内容	改动	验收
P0	客户360预加载 + 四步引导条 + 行动项转待办	`ai_chat._load_customer360()`；前端引导条+转待办按钮	问客户一次答全；建议能落待办
P1	沉淀自动化 + 数据源补齐（客诉/订单/商机）	检索通道 3→6；`_should_suggest_archive()`	多轮后 AI 主动提沉淀
P2	拜访前主动提醒 + 跨 Tab 上下文共享	登录钩子 + 拜访日期查表	48h 内拜访自动递作战摘要

⚠️ 关键约束（改之前必读）

衔接现有实现，不重造：多轮/上传/溯源/背景检索/归档已上线，强化是「叠加」非「替换」。先读 脚本/ai_chat.py 的 handle() 现状再动手。
双入口同步：工具/index.html（CloudBase 源）+ 工具/app.html（飞书内嵌）必须同步改，否则本地/云端口径不一致。
权限铁律不破：客户360 的 6 维数据、上传内容、历史、待办，全部走 _visible_for_user 隔离：admin/gm 全量 → manager 本部门 → sales 仅自己。
安全红线：数据/chat_history.json、数据/ima_pending_review.json 禁止进 cb_sync.sh/cron 的 CloudBase 部署清单。
DeepSeek thinking 必须 disabled（见 baoyu-sales-copilot pitfall）。
服务重启三坑：tmux 会掉；kill 杀不死 python 子进程（须 kill -9 + lsof -i:8765 确认）；patch 大段 JS 用精确锚点。
字段口径：MCP 销售员是「角色」非「字段」（role_7dd6e0）；下单人 role_00a9b7；金额按单据编号合并；ps.total 排除 no_tracking。

🕳 Pitfalls

1. 客户360 的「客户名识别」要复用背景检索的通用词排除

_load_customer360 识别客户名时，沿用 _search_background() 的 _COMMON_BIGRAM（公司/客户/生物/科技等），否则「公司内部资源」会误触发全量拉取。

2. 六维拉取失败要降级，不能阻塞回答

任一数据源缺失/解析失败，跳过该维度继续，不能因为 opportunity_sandbox.json 不存在就整个 360 报错。每次拉取都要 try/except + 空数据保护（呼应 baoyu-sales-copilot 的「空数据覆盖」铁律）。

3. 待办写入要复用现有 key，不新造

行动项转待办写入 copilot_todos（localStorage），与待办推进 Tab 共用 key + 字段结构，避免两个 Tab 各存一份。

AI 助手 Tab 强化工作流