生成式 AI 正从单轮问答走向可持续的业务协作会话。企业在客服、研发协作、知识问答、流程辅导等场景中，越来越需要可嵌入既有系统的「长对话」能力，而不是再造一套独立聊天产品。iframe 化、多租户/多系统隔离、会话可沉淀与可回溯，成为工具平台的标配诉求。
与此同时，长上下文带来阅读与导航成本：用户需要摘要、定位与结构化回顾。将对话摘要为思维导图、并把节点回链到原文片段，契合「边聊边整理、边读边定位」的趋势。结合场景化提示词与模型服务解耦，前端可专注交互与数据编排，模型侧可持续升级，降低业务系统接入门槛。
预计未来 3–5 年，嵌入式 AI 助手会从「页面角落的聊天框」演进为可编排的工作组件：支持系统编码隔离、国际化、主题协同、可观测的会话资产，以及与企业内部数据服务（如 MDS）打通的持久化能力。具备可复用长对话底座的产品，将更易在多业务线间复制推广，形成平台级复利。
本项目提供可嵌套的通用 AI 长对话界面，通过 URL 参数 `systemCode` 区分嵌入方系统，自动注册并隔离对话列表与消息数据。核心能力包括：多轮聊天（先展示用户消息与思考态，再展示 AI 回复）、Markdown 渲染与复制、场景选择与模板参数预览、超长首条消息异步生成副标题、多轮后自动整理思维导图摘要。
思维导图节点关联具体消息及正文摘录，点击可定位到对话中的精确片段；滚动阅读时节点同步高亮，帮助把握全局进度。输入区支持失焦折叠为右下角消息图标，扩大阅读空间。支持中英文国际化（默认英文），iframe 场景可隐藏语言切换并与父系统语言对齐；支持浅色/深色主题。全部会话、消息与导图映射持久化至数据库，便于跨会话延续与审计。
我负责完整前端交付与联调：基于 React + Vite 搭建工程，使用 Ant Design 与 i18next 实现极简 UI 与双语；对接 Model Data Server 完成系统/对话/消息/思维导图表结构与版本脚本，对接 AI Model API 完成长对话、副标题与导图摘要场景；编写 `scripts/` 下数据库与提示词初始化及 Vitest 业务单测；输出 iframe 对接文档并按版本规范构建发布。
技术栈以 React 19、Vite、Ant Design、i18next、react-markdown 为主，数据与智能能力分别落在 MDS 与 AI 微服务。架构上严格分离 `src/services` 纯逻辑与视图层，便于测试与复用。实现难点与亮点包括：嵌套布局下固定高度与滚动容器测量，避免页面整体溢出；mindmap 节点与正文 exact quote 校验入库及滚动精确定位；阅读焦点与导图选中双向协同；输入区失焦折叠与布局重算；发送链路中的乐观展示、异步副标题与导图刷新互不阻塞主对话。
使用tools-hub系统构建（https://www.proginn.com/w/1583719?act=preview）
评论