sanbuphy
3af119a598
- 新增 Vibe Coding 全栈相关演示组件 (DeveloperSkillShift, FrontendTriad, BackendCore 等) - 新增 RAG 相关组件 (RAGPipeline, ChunkingStrategy, Retrieval 等) - 新增 Embedding & Vector 相关组件 (EmbeddingConcept, VectorSimilarity 等) - 新增 AI Native App 设计组件 (AINativeArch, PromptDesign 等) - 新增 Infrastructure as Code 组件 (IaCConcept, TerraformWorkflow 等) - 新增 DNS & HTTPS 演示组件 (DnsResolution, HttpsHandshake 等) - 新增 Model Finetuning 组件 (FinetuningPipeline 等) - 更新多个章节的 markdown 内容，集成交互式演示
350 lines
8.6 KiB
Vue
350 lines
8.6 KiB
Vue
<!--
|
||
RAGPipelineDemo.vue
|
||
RAG 完整流程可视化演示
|
||
|
||
用途：
|
||
展示 RAG 的核心流程：用户提问 → 检索 → 上下文组装 → LLM 生成 → 返回结果
|
||
用户可以逐步点击，观察每个阶段的数据流动。
|
||
|
||
交互功能：
|
||
- 点击"下一步"逐步推进流程
|
||
- 每个阶段高亮并展示说明
|
||
- 可选择不同的示例问题
|
||
-->
|
||
<template>
|
||
<div class="rag-pipeline-demo">
|
||
<div class="query-selector">
|
||
<span class="label">选择问题：</span>
|
||
<button
|
||
v-for="(q, i) in queries"
|
||
:key="i"
|
||
:class="['query-btn', { active: currentQuery === i }]"
|
||
@click="selectQuery(i)"
|
||
>
|
||
{{ q.short }}
|
||
</button>
|
||
</div>
|
||
|
||
<div class="pipeline">
|
||
<div
|
||
v-for="(stage, i) in stages"
|
||
:key="i"
|
||
:class="['stage', { active: currentStep >= i, current: currentStep === i }]"
|
||
>
|
||
<div class="stage-icon">{{ stage.icon }}</div>
|
||
<div class="stage-name">{{ stage.name }}</div>
|
||
<div
|
||
v-if="currentStep >= i"
|
||
class="stage-content"
|
||
>
|
||
{{ getStageContent(i) }}
|
||
</div>
|
||
<div
|
||
v-if="i < stages.length - 1"
|
||
:class="['arrow', { active: currentStep > i }]"
|
||
>
|
||
→
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="detail-panel">
|
||
<div class="detail-title">{{ stages[currentStep]?.name }} — 详细说明</div>
|
||
<div class="detail-desc">{{ stages[currentStep]?.desc }}</div>
|
||
<div
|
||
v-if="currentStep >= 1 && currentStep <= 2"
|
||
class="retrieved-docs"
|
||
>
|
||
<div class="doc-title">检索到的文档片段：</div>
|
||
<div
|
||
v-for="(doc, i) in queries[currentQuery].docs"
|
||
:key="i"
|
||
:class="['doc-item', { visible: currentStep >= 2 }]"
|
||
>
|
||
<span class="doc-score">相关度 {{ doc.score }}</span>
|
||
<span class="doc-text">{{ doc.text }}</span>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="controls">
|
||
<button
|
||
class="ctrl-btn"
|
||
:disabled="currentStep <= 0"
|
||
@click="prevStep"
|
||
>
|
||
← 上一步
|
||
</button>
|
||
<span class="step-indicator">{{ currentStep + 1 }} / {{ stages.length }}</span>
|
||
<button
|
||
class="ctrl-btn primary"
|
||
:disabled="currentStep >= stages.length - 1"
|
||
@click="nextStep"
|
||
>
|
||
下一步 →
|
||
</button>
|
||
<button
|
||
class="ctrl-btn"
|
||
@click="reset"
|
||
>
|
||
重置
|
||
</button>
|
||
</div>
|
||
</div>
|
||
</template>
|
||
|
||
<script setup>
|
||
import { ref } from 'vue'
|
||
|
||
const stages = [
|
||
{
|
||
name: '用户提问',
|
||
icon: '💬',
|
||
desc: '用户向系统提出一个自然语言问题。这个问题会被转化为向量表示，用于后续的语义检索。'
|
||
},
|
||
{
|
||
name: '语义检索',
|
||
icon: '🔍',
|
||
desc: '系统将问题编码为向量，在向量数据库中搜索语义最相近的文档片段。通常使用余弦相似度或点积来衡量相关性。'
|
||
},
|
||
{
|
||
name: '上下文组装',
|
||
icon: '📋',
|
||
desc: '将检索到的 Top-K 文档片段与原始问题拼接，构造成一个完整的 Prompt。这个 Prompt 会告诉 LLM："请根据以下参考资料回答问题"。'
|
||
},
|
||
{
|
||
name: 'LLM 生成',
|
||
icon: '🤖',
|
||
desc: '大语言模型接收组装好的 Prompt，基于检索到的上下文信息生成回答。因为有了真实的参考资料，模型的回答更加准确、可靠。'
|
||
},
|
||
{
|
||
name: '返回结果',
|
||
icon: '✅',
|
||
desc: '系统将 LLM 生成的回答返回给用户。高级系统还会附带引用来源，方便用户验证答案的可靠性。'
|
||
}
|
||
]
|
||
|
||
const queries = [
|
||
{
|
||
short: '公司年假政策',
|
||
question: '我们公司的年假政策是什么？',
|
||
docs: [
|
||
{ score: '0.95', text: '员工入职满一年后享有 10 天带薪年假，满五年后增至 15 天。' },
|
||
{ score: '0.87', text: '年假需提前 3 个工作日申请，经直属主管审批后生效。' },
|
||
{ score: '0.72', text: '未使用的年假可结转至次年第一季度，逾期作废。' }
|
||
],
|
||
answer: '根据公司规定，入职满一年享有 10 天带薪年假，满五年增至 15 天。需提前 3 个工作日申请并经主管审批，未用年假可结转至次年 Q1。'
|
||
},
|
||
{
|
||
short: 'API 限流规则',
|
||
question: '我们的 API 限流规则是怎样的？',
|
||
docs: [
|
||
{ score: '0.93', text: '免费用户每分钟限 60 次请求，付费用户限 600 次。' },
|
||
{ score: '0.85', text: '超出限流后返回 HTTP 429 状态码，需等待 60 秒后重试。' },
|
||
{ score: '0.68', text: '企业版用户可申请自定义限流配额，最高支持每分钟 10000 次。' }
|
||
],
|
||
answer: '免费用户每分钟限 60 次请求，付费用户 600 次。超限返回 429 状态码，需等 60 秒。企业版可申请最高 10000 次/分钟的自定义配额。'
|
||
}
|
||
]
|
||
|
||
const currentQuery = ref(0)
|
||
const currentStep = ref(0)
|
||
|
||
function selectQuery(i) {
|
||
currentQuery.value = i
|
||
currentStep.value = 0
|
||
}
|
||
|
||
function getStageContent(i) {
|
||
const q = queries[currentQuery.value]
|
||
if (i === 0) return q.question
|
||
if (i === 1) return `找到 ${q.docs.length} 个相关片段`
|
||
if (i === 2) return '问题 + 参考资料 → Prompt'
|
||
if (i === 3) return '基于上下文生成回答...'
|
||
if (i === 4) return q.answer
|
||
return ''
|
||
}
|
||
|
||
function nextStep() {
|
||
if (currentStep.value < stages.length - 1) currentStep.value++
|
||
}
|
||
function prevStep() {
|
||
if (currentStep.value > 0) currentStep.value--
|
||
}
|
||
function reset() {
|
||
currentStep.value = 0
|
||
}
|
||
</script>
|
||
|
||
<style scoped>
|
||
.rag-pipeline-demo {
|
||
border: 1px solid var(--vp-c-divider);
|
||
border-radius: 12px;
|
||
padding: 20px;
|
||
margin: 16px 0;
|
||
background: var(--vp-c-bg-soft);
|
||
}
|
||
.query-selector {
|
||
display: flex;
|
||
align-items: center;
|
||
gap: 8px;
|
||
margin-bottom: 16px;
|
||
flex-wrap: wrap;
|
||
}
|
||
.query-selector .label {
|
||
font-size: 14px;
|
||
color: var(--vp-c-text-2);
|
||
}
|
||
.query-btn {
|
||
padding: 6px 14px;
|
||
border: 1px solid var(--vp-c-divider);
|
||
border-radius: 6px;
|
||
background: var(--vp-c-bg);
|
||
cursor: pointer;
|
||
font-size: 13px;
|
||
transition: all 0.2s;
|
||
}
|
||
.query-btn.active {
|
||
background: var(--vp-c-brand-1);
|
||
color: #fff;
|
||
border-color: var(--vp-c-brand-1);
|
||
}
|
||
.pipeline {
|
||
display: flex;
|
||
align-items: flex-start;
|
||
gap: 4px;
|
||
overflow-x: auto;
|
||
padding: 12px 0;
|
||
}
|
||
.stage {
|
||
flex: 1;
|
||
min-width: 100px;
|
||
text-align: center;
|
||
padding: 12px 8px;
|
||
border-radius: 8px;
|
||
border: 2px solid var(--vp-c-divider);
|
||
background: var(--vp-c-bg);
|
||
opacity: 0.5;
|
||
transition: all 0.3s;
|
||
position: relative;
|
||
}
|
||
.stage.active {
|
||
opacity: 1;
|
||
}
|
||
.stage.current {
|
||
border-color: var(--vp-c-brand-1);
|
||
box-shadow: 0 0 0 3px rgba(var(--vp-c-brand-1-rgb, 100, 108, 255), 0.15);
|
||
}
|
||
.stage-icon {
|
||
font-size: 24px;
|
||
margin-bottom: 4px;
|
||
}
|
||
.stage-name {
|
||
font-size: 13px;
|
||
font-weight: 600;
|
||
color: var(--vp-c-text-1);
|
||
}
|
||
.stage-content {
|
||
font-size: 11px;
|
||
color: var(--vp-c-text-2);
|
||
margin-top: 6px;
|
||
line-height: 1.4;
|
||
}
|
||
.arrow {
|
||
position: absolute;
|
||
right: -16px;
|
||
top: 50%;
|
||
transform: translateY(-50%);
|
||
font-size: 18px;
|
||
color: var(--vp-c-divider);
|
||
z-index: 1;
|
||
transition: color 0.3s;
|
||
}
|
||
.arrow.active {
|
||
color: var(--vp-c-brand-1);
|
||
}
|
||
.detail-panel {
|
||
margin-top: 16px;
|
||
padding: 16px;
|
||
border-radius: 8px;
|
||
background: var(--vp-c-bg);
|
||
border: 1px solid var(--vp-c-divider);
|
||
}
|
||
.detail-title {
|
||
font-weight: 600;
|
||
font-size: 14px;
|
||
margin-bottom: 8px;
|
||
color: var(--vp-c-brand-1);
|
||
}
|
||
.detail-desc {
|
||
font-size: 13px;
|
||
color: var(--vp-c-text-2);
|
||
line-height: 1.6;
|
||
}
|
||
.retrieved-docs {
|
||
margin-top: 12px;
|
||
padding-top: 12px;
|
||
border-top: 1px dashed var(--vp-c-divider);
|
||
}
|
||
.doc-title {
|
||
font-size: 13px;
|
||
font-weight: 600;
|
||
margin-bottom: 8px;
|
||
}
|
||
.doc-item {
|
||
display: flex;
|
||
align-items: center;
|
||
gap: 8px;
|
||
padding: 6px 10px;
|
||
margin-bottom: 4px;
|
||
border-radius: 6px;
|
||
background: var(--vp-c-bg-soft);
|
||
font-size: 12px;
|
||
opacity: 0;
|
||
transition: opacity 0.3s;
|
||
}
|
||
.doc-item.visible {
|
||
opacity: 1;
|
||
}
|
||
.doc-score {
|
||
background: var(--vp-c-brand-soft);
|
||
color: var(--vp-c-brand-1);
|
||
padding: 2px 8px;
|
||
border-radius: 4px;
|
||
font-size: 11px;
|
||
white-space: nowrap;
|
||
}
|
||
.doc-text {
|
||
color: var(--vp-c-text-2);
|
||
}
|
||
.controls {
|
||
display: flex;
|
||
align-items: center;
|
||
justify-content: center;
|
||
gap: 12px;
|
||
margin-top: 16px;
|
||
}
|
||
.ctrl-btn {
|
||
padding: 6px 16px;
|
||
border: 1px solid var(--vp-c-divider);
|
||
border-radius: 6px;
|
||
background: var(--vp-c-bg);
|
||
cursor: pointer;
|
||
font-size: 13px;
|
||
transition: all 0.2s;
|
||
}
|
||
.ctrl-btn:disabled {
|
||
opacity: 0.4;
|
||
cursor: not-allowed;
|
||
}
|
||
.ctrl-btn.primary {
|
||
background: var(--vp-c-brand-1);
|
||
color: #fff;
|
||
border-color: var(--vp-c-brand-1);
|
||
}
|
||
.step-indicator {
|
||
font-size: 13px;
|
||
color: var(--vp-c-text-2);
|
||
}
|
||
</style>
|