正在加载 LinguaMate ...
Technical Architecture & Design

技术驱动语言陪伴
架构承载真实交互

LinguaMate 语航者 AI 不止是一个语言练习工具——它是一套将 Dify Agent 能力、 场景化教学设计、轻量前端架构融合在一起的智能体语伴系统。

5+
场景化 AI 语伴
24/7
随时可练,零等待
2
页面解耦架构层
Agent
真实 Dify 智能体驱动
System Architecture

轻量前端 × 智能体后端的清晰分层。

项目采用"展示层 → 交互层 → 智能体层"的三段式架构,每一层职责明确、可独立迭代。

🖥️
展示层
Vue 3 双页应用
companion.html 语伴介绍页
companion-chat.html 语伴交互页
🧠
智能体交互层
iframe 沙箱嵌入
Dify Agent 对话窗口
独立语伴人格配置
☁️
Dify 平台层
LLM 推理与知识库
Agent 工作流编排
多应用独立部署
Technical Innovations

四个关键技术决策,让语伴系统与众不同。

🎭
核心创新

一人一 Agent 的场景隔离

每个语伴对应一个独立的 Dify 应用,拥有专属的 System Prompt、知识库和对话风格。校园语伴不会用职场语气回应,文化语伴自带跨文化知识背景——这比单一聊天机器人切换 "模式" 更可靠。

🛡️
安全设计

iframe 沙箱安全集成

通过 sandbox 属性精确控制 Dify Agent 的浏览器权限:允许脚本执行与表单提交,同时限制弹窗和导航。用户数据不经过前端服务器中转,直接与 Dify 实例通信,降低数据泄露面。

📱
体验设计

双页面解耦架构

index.html 承担产品叙事与价值传递,companion.html 承担语伴介绍与导流,companion-chat.html 承担语伴选择与对话交互。页面共享视觉语言但职责分离——介绍页负责说服,交互页负责直达练习,互不拖累加载性能。

性能策略

零构建依赖的纯静态部署

基于 Vue 3 CDN 运行时 + 原生 CSS 变量体系,无需 Webpack/Vite 构建流程。整个项目就是一组 HTML 文件和一个 CSS 文件,可以直接部署到任何静态服务器或 CDN,首次内容绘制极快。

🔄
交互细节

智能体热重载机制

切换语伴时通过 Vue 的 key 绑定触发 iframe 销毁与重建,配合 loading placeholder 实现平滑的"退出-加载-进入"过渡。用户点击重新加载按钮时,同样的机制确保 Agent 会话干净重启。

🎨
视觉系统

场景感知的色彩语义

每个语伴拥有独立的渐变色标识——校园蓝、生活橙、社交靛、职场灰、文化红——用户无需阅读文字即可通过颜色快速定位目标语伴。卡片动画采用交错入场序列,降低等待的感知时间。

Key Differentiators

相比传统方案,我们做了什么不同的事。

📋 传统语言学习应用

固定对话脚本,无法自由发挥
需要真人教师或语伴预约
单一对话机器人,缺乏场景区分
重客户端,学习成本高
通用回复,缺乏场景化纠错

✨ LinguaMate 语航者 AI

LLM 驱动的开放式对话,任何话题都能继续
24/7 AI Agent 在线,打开即练
5 个独立 Agent,分别对应真实生活场景
纯静态页面,浏览器即用,零安装
Agent 内嵌场景化纠错与表达润色提示词
Technology Stack

精选技术栈,每一层都恰到好处。

Vue 3
响应式 UI 框架
CDN 运行时加载
Composition API
🤖
Dify.ai
Agent 编排平台
多应用管理
知识库 + 工作流
🎨
CSS Variables
设计 Token 系统
全局主题一致性
零运行时开销
🔒
iframe Sandbox
安全隔离
权限最小化
第三方安全嵌入
📄
纯静态 HTML
零构建工具
即部署即上线
任意静态服务器
🧠
LLM 后端
大语言模型推理
场景化 Prompt
多轮对话记忆
📱
响应式设计
Mobile-First
自适应断点
触摸友好交互
🌐
Inter / 苹方
中西文双语字体栈
优化可读性
跨平台一致性
Design Philosophy

每一个交互细节都在降低"开始练习"的心理成本。

01

卡片即入口

每个语伴以可视化卡片呈现——头像、名称、场景描述、标签——用户无需阅读说明书就能理解"这个人可以陪我练什么"。点击卡片直接进入对话,中间没有多余的配置页面。

02

移动端即原生体验

100vh 占满、隐藏滚动条、viewport-fit: cover 适配刘海屏——语伴页面在手机上就像一个独立的 App。桌面端则自动切换为双列网格布局,充分利用屏幕空间。

03

状态可见,不给惊喜

在线状态指示灯、加载 Spinner、过渡动画——每一个状态变化都有对应的视觉反馈。用户点击卡片后有 200ms 的选中态延迟,让大脑跟上界面的节奏。

04

渐进增强,不做过度设计

5 个语伴覆盖核心场景,更多语伴标记为"即将上线"而非填充假数据。CSS 变量体系让颜色、圆角、阴影统一管理——未来扩展只需改几个变量值。

技术亮点看完,不如亲自体验一次真实的 AI 语伴对话。

从架构设计到交互细节,LinguaMate 语航者 AI 的每一层都在回答同一个问题:如何让留学生"敢开口、有处练、练得对"。