智能推荐重构原型 v1.0

REQ-用户-006 · 基于 PRD v1.0-Frozen + 技术方案 v1.0 · 2026-07-28

场景 1：重构前 vs 重构后 整体对比

核心改动：移除"智能推荐"分类标题 + 边框颜色区分 layer + FIFO 插入

v2.3 现状（有标题 + 分组）

VPN 连不上怎么办？
请尝试以下步骤：1. 检查网络 2. 重启 aTrust
⚡ 相关推荐
VPN 相关信息
客户端下载、服务器地址...
🔔 运维提醒
火绒病毒库过期
病毒库已 7 天未更新
💼 常用资源
开发者资源
代码仓库、API 文档...
问题：
  • 三个分类标题占据空间，视觉杂乱
  • 无 FIFO，新旧卡片位置固定
  • 分组标题强化"分类"概念，用户误以为必须点击分类切换
  • 卡片样式无 layer 区分，仅靠标题文字

v1.0 重构后（无标题 + 边框颜色 + FIFO）

VPN 连不上怎么办？
请尝试以下步骤：1. 检查网络 2. 重启 aTrust
📋💻
🔐VPN 相关信息
VPN 连接所需资源
  • 客户端下载（支持 Windows/macOS）
  • 服务器地址：vpn.servyou-it.com
  • 申请审批 → 去申请
L1 · 关键词命中 2 秒前
🦠火绒病毒库过期
病毒库已 7 天未更新，建议立即升级
L2 · 画像触发 2 秒前
💻开发者资源
代码仓库、API 文档、测试环境申请
L3 · 角色匹配 2 秒前
改进：
  • ✅ 移除所有分类标题（"⚡ 相关推荐"/"🔔 运维提醒"/"💼 常用资源"），视觉更清爽
  • ✅ 边框颜色区分 layer：🟢 L1 / 🟠 L2 / ⚪ L3 / 🔵 A / 🟣 progress
  • ✅ FIFO：新卡片插入最上方（最新在上）
  • ✅ 来源标签在卡片底部可查（L1/L2/L3 + 来源类型）

场景 2：冷启动空状态（PRD §4.7.4 决策 ① A）

用户进入会话但未发言 / AI 还未回复 → 右侧栏完全空白（不强求兜底）
VPN 连不上怎么办？
（消息已发送，等待 AI 回复...）
VPN 连不上怎么办？
（AI 正在思考...）
PRD §4.7.4 决策 ① A 落地：

场景 3：AI 回复瞬间 FIFO 插入

新生成的卡片插入到右侧栏最上方（最新优先）
VPN 连不上怎么办？
请尝试以下步骤：
1. 检查网络连接
2. 重启 aTrust 客户端
3. 如仍无法连接，右侧已为您准备好重连步骤
📋💻
顺便帮我看下电脑补丁情况
您的电脑有 12 个安全补丁未安装，右侧已准备好补丁列表
💻⚠️
🔧系统补丁缺失
您的电脑有 12 个安全补丁未安装，可能存在安全风险
L1 · 关键词"补丁" 刚刚
FIFO 规则（PRD §4.7.3）：

场景 4：4 类卡片样式

基于 PRD §4.5 + §4.6 决策的完整卡片类型展示

① 操作步骤（来自 Dify action · 可展开）

② 联系窗口（仅左侧栏出现，右侧栏不显示）

位置：左侧气泡 / 右侧栏不出现
关联：员工服务窗口链接（chat_id / openid）
示例气泡（左侧）：
💬IT 服务窗口
需要人工帮助？点击下方按钮跳转 IT 服务窗口
打开 IT 服务窗口
A · Dify action

③ 联系人名片（仅左侧栏出现，右侧栏不显示）

位置：左侧气泡 / 右侧栏不出现
关联：员工名片（user_id）
示例气泡（左侧）：
👤联系：财务部 张三
财务部经理 · 工号 10086
查看名片
A · Dify 路由名片

④ 下载/链接（仅左侧栏出现，右侧栏不显示）

位置：左侧气泡 / 右侧栏不出现
关联：直接下载链接（exe/pdf/zip）
示例气泡（左侧）：
📦VPN 客户端下载
Windows 10/11 / macOS · 32.5 MB
立即下载
A · Dify 资源链接

⑤ 常用资源 L3（来自角色匹配 · 仅左侧栏出现）

位置：左侧气泡（"试试问：xxx"形式） / 右侧栏不出现
触发：profile.position 匹配 role_assets
示例气泡（左侧）：
💻开发者常用资源
代码仓库 · API 文档 · 测试环境申请
  • git.servyou-it.com
  • api-docs.servyou-it.com
  • 测试环境申请 → 去申请
L3 · 角色"开发"

⑥ 审批进度回流（来自 T2 webhook · 右侧栏顶部插入）

📋VPN 申请进度
您发起的 VPN 权限申请
已审批 60% · 等待 IT 开通
progress · T2 事件触发 2 分钟前更新

场景 5：跨会话持久化（PRD §4.7.7 决策 ⑤ B）

L2/L3/progress 持久化到 localStorage；L1/A 不持久

会话 1（首次打开，3 张卡都已生成）

帮我看看电脑情况
已检测，您的电脑有 12 个补丁待安装，病毒库已过期 7 天
🦠火绒病毒库过期
病毒库已 7 天未更新
L2 · 持久化 ✅ 已存 localStorage
📋VPN 申请进度
已审批 · 等待 IT 开通
progress · 持久化直到完结 ✅ 已存 localStorage
🔧系统补丁缺失
12 个安全补丁未安装
L1 · ❌ 不持久 会话结束即清

会话 2（用户关闭浏览器后再次打开，localStorage 加载）

（新会话，用户未发言）
🦠火绒病毒库过期
病毒库已 7 天未更新（来自 localStorage）
L2 · 跨会话持久 30 天后过期
📋VPN 申请进度
已审批 · 等待 IT 开通（来自 localStorage）
progress · 跨会话持久 完结后清除
持久化规则（PRD §4.7.7）：
类型 持久化 过期规则
L1 关键词❌话题切换 / 会话结束即清
L2 画像✅ 30 天30 天后或画像更新时清
L3 角色✅角色变更时清（极少）
来源 A 步骤❌话题切换 / 会话结束即清
progress✅审批完结时清

场景 6：话题切换（PRD §4.7.6 决策 ④ B）

用户切换话题后，L1 推荐清空；L2/L3/progress 保留
VPN 连不上
请尝试重连 aTrust 客户端
顺便帮我预约一下会议室
话题已切换，旧的 L1 推荐已清空 ✅
好的，您要预约哪个会议室？
🦠火绒病毒库过期
病毒库已 7 天未更新
L2 · 保留 画像无关
📋VPN 申请进度
已审批 · 等待 IT 开通
progress · 保留 跨会话持久
话题切换检测（PRD §4.7.6）：

场景 7：触发失败降级（PRD §4.7.5 决策 ③ B）

C 失败 → D 降级；全部失败 → 右侧栏空

7.1 画像 API 故障（C 失败 → D 降级）

我要申请 VPN
好的，请填写 VPN 申请表单
🔐VPN 相关信息
VPN 连接所需资源
L1 · 正常 ✅
⚠️开发者资源（降级展示）
画像 API 故障，降级使用 L3 角色通用资源
L3 · C→D 降级 画像不可用

7.2 全部失败（右侧栏空）

xxx（无关内容）
您好，请问需要什么帮助？
降级链路（PRD §4.7.5）：