feat: comprehensive documentation and demo updates

- Update READMEs and docs across multiple languages
- Enhance interactive demos for Agent, LLM, VLM, Audio, Image Gen, Terminal, and Web Basics
- Add new appendix sections for Database and IDE intros
- Update VitePress config, theme, and utility scripts
- Clean up unused assets and components
This commit is contained in:
sanbuphy
2026-01-16 19:10:21 +08:00
parent c8567ce23f
commit 73f4788d7e
150 changed files with 19530 additions and 13401 deletions
@@ -1,429 +1,289 @@
<template>
<div class="dns-lookup-demo">
<div class="domain-input">
<label>输入域名</label>
<input
type="text"
v-model="domain"
placeholder="例如: www.google.com"
class="input-field"
@keyup.enter="startLookup"
/>
<button class="lookup-btn" @click="startLookup">
🔍 开始解析
<div class="control-panel">
<div class="input-group">
<label>Domain</label>
<input
v-model="domain"
placeholder="www.example.com"
class="domain-input"
/>
</div>
<div class="toggle-group">
<label class="toggle">
<input type="checkbox" v-model="useCache" />
<span class="slider"></span>
<span class="label">Simulate Cache Hit</span>
</label>
</div>
<button @click="startLookup" :disabled="isLooking" class="lookup-btn">
{{ isLooking ? 'Resolving...' : 'Lookup' }}
</button>
</div>
<div class="lookup-process" v-if="isLooking">
<div class="process-title">DNS 解析过程</div>
<div class="viz-area">
<!-- Client -->
<div class="node client">
<span class="icon">💻</span>
<span>Browser</span>
</div>
<div class="step-list">
<!-- Servers -->
<div class="servers-container">
<div
v-for="(step, index) in steps"
:key="index"
class="step-item"
v-for="(server, index) in servers"
:key="server.name"
class="node server"
:class="{
active: currentStep === index,
completed: currentStep > index
active: currentServer === index,
success: completed && currentServer === index
}"
>
<div class="step-icon">
{{ currentStep > index ? '✓' : index + 1 }}
</div>
<div class="step-content">
<div class="step-title">{{ step.title }}</div>
<div class="step-desc">{{ step.desc }}</div>
<div v-if="currentStep === index" class="step-animation">
{{ step.animation }}
</div>
</div>
<div class="step-arrow" v-if="index < steps.length - 1">
</div>
<div class="server-icon">{{ server.icon }}</div>
<div class="server-name">{{ server.name }}</div>
<div class="server-desc">{{ server.desc }}</div>
</div>
</div>
<!-- Packet Animation -->
<div v-if="packet.visible" class="packet" :style="packetStyle">
{{ packet.text }}
</div>
</div>
<div class="result-box" v-if="completed">
<div class="result-title"> 解析完成</div>
<div class="result-content">
<div class="result-item">
<span class="label">域名:</span>
<span class="value">{{ domain }}</span>
</div>
<div class="result-item">
<span class="label">IP 地址:</span>
<span class="value">{{ resolvedIP }}</span>
</div>
<div class="result-item">
<span class="label">解析时间:</span>
<span class="value">{{ lookupTime }}ms</span>
</div>
</div>
<button class="reset-btn" @click="reset">
🔄 重新解析
</button>
</div>
<div class="info-box">
<div class="info-title">💡 DNS 知识点</div>
<div class="info-content">
<div class="info-item">
<strong>什么是 DNS</strong>
<br>
DNS域名系统就像互联网的电话簿将易记的域名 google.com转换为计算机能识别的 IP 地址 142.250.185.238
</div>
<div class="info-item">
<strong>为什么需要 DNS</strong>
<br>
IP 地址难记142.250.185.238 vs google.com
<br>
IP 可能变化服务器迁移时 IP 会变域名不变
<br>
负载均衡一个域名可以对应多个 IP
</div>
<div class="info-item">
<strong>DNS 解析的层次</strong>
<br>
1 浏览器缓存最近访问过的域名
<br>
2 系统缓存操作系统的 DNS 缓存
<br>
3 路由器缓存本地路由器的缓存
<br>
4 ISP DNS网络服务商的 DNS 服务器
<br>
5 根域名服务器最高层级的 DNS
</div>
<div class="log-panel" ref="logPanel">
<div v-for="(log, i) in logs" :key="i" class="log-entry">
<span class="time">{{ log.time }}ms</span>
<span class="msg">{{ log.message }}</span>
</div>
</div>
</div>
</template>
<script setup>
import { ref } from 'vue'
import { ref, computed, nextTick } from 'vue'
const domain = ref('www.google.com')
const useCache = ref(false)
const isLooking = ref(false)
const currentStep = ref(-1)
const currentServer = ref(-1)
const completed = ref(false)
const resolvedIP = ref('')
const lookupTime = ref(0)
const logs = ref([])
const packet = ref({ visible: false, text: '?', x: 0, y: 0 })
const steps = [
{
title: '检查浏览器缓存',
desc: '查看最近是否访问过该域名',
animation: '🔍 正在搜索浏览器缓存...'
},
{
title: '检查系统缓存',
desc: '查看操作系统的 DNS 缓存',
animation: '💻 正在查询系统 DNS 缓存...'
},
{
title: '查询路由器 DNS',
desc: '向本地路由器发送 DNS 查询',
animation: '📡 正在向路由器发送查询...'
},
{
title: '查询 ISP DNS 服务器',
desc: '向网络服务商的 DNS 服务器查询',
animation: '🌐 正在联系 ISP DNS 服务器...'
},
{
title: '查询根域名服务器',
desc: '从 . 根服务器开始递归查询',
animation: '🔝 正在查询根域名服务器...'
},
{
title: '获取 IP 地址',
desc: '成功解析到 IP 地址',
animation: '✅ 找到 IP 地址!'
}
const servers = [
{ name: 'Root (.)', icon: '🌲', desc: 'Global Root' },
{ name: 'TLD (.com)', icon: '🏢', desc: 'Top Level' },
{ name: 'Authoritative', icon: '📝', desc: 'example.com' }
]
const ipAddresses = {
'www.google.com': '142.250.185.238',
'www.baidu.com': '110.242.68.4',
'www.github.com': '140.82.112.3',
'default': '93.184.216.34'
const packetStyle = computed(() => ({
transform: `translate(${packet.value.x}px, ${packet.value.y}px)`,
opacity: packet.value.visible ? 1 : 0
}))
const addLog = (message) => {
logs.value.push({
time: Math.floor(performance.now() % 10000),
message
})
// Auto scroll
nextTick(() => {
const el = document.querySelector('.log-panel')
if (el) el.scrollTop = el.scrollHeight
})
}
const startLookup = () => {
const startLookup = async () => {
if (isLooking.value) return
isLooking.value = true
currentServer.value = -1
completed.value = false
currentStep.value = -1
const startTime = Date.now()
logs.value = []
// 模拟 DNS 查询过程
let stepIndex = 0
const interval = setInterval(() => {
if (stepIndex < steps.length) {
currentStep.value = stepIndex
stepIndex++
addLog(`Starting DNS lookup for ${domain.value}`)
if (useCache.value) {
await wait(500)
addLog('✅ Cache HIT! IP found in browser cache.')
completed.value = true
isLooking.value = false
return
}
// Recursive Query Simulation
for (let i = 0; i < servers.length; i++) {
const server = servers[i]
addLog(`Querying ${server.name}...`)
// Simulate network delay
currentServer.value = i
await wait(800)
if (i < servers.length - 1) {
addLog(`Received referral to ${servers[i + 1].name}`)
} else {
clearInterval(interval)
const endTime = Date.now()
lookupTime.value = endTime - startTime
resolvedIP.value = ipAddresses[domain.value.toLowerCase()] || ipAddresses['default']
completed.value = true
addLog(`✅ Resolved IP: 142.250.185.238`)
}
}, 800)
}
completed.value = true
isLooking.value = false
}
const reset = () => {
isLooking.value = false
currentStep.value = -1
completed.value = false
}
const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
</script>
<style scoped>
.dns-lookup-demo {
border: 1px solid var(--vp-c-divider);
border-radius: 8px;
padding: 20px;
background: var(--vp-c-bg-soft);
margin: 20px 0;
background-color: var(--vp-c-bg-soft);
padding: 1.5rem;
margin: 1rem 0;
font-family: var(--vp-font-family-mono);
}
.domain-input {
background: var(--vp-c-bg);
border-radius: 8px;
padding: 20px;
margin-bottom: 20px;
.control-panel {
display: flex;
gap: 10px;
align-items: flex-end;
gap: 1rem;
align-items: center;
margin-bottom: 2rem;
flex-wrap: wrap;
}
.domain-input label {
width: 100%;
font-size: 0.85rem;
font-weight: 600;
color: var(--vp-c-text-2);
margin-bottom: 8px;
}
.input-field {
.input-group {
display: flex;
flex-direction: column;
flex: 1;
min-width: 200px;
padding: 12px;
border: 2px solid var(--vp-c-divider);
border-radius: 6px;
font-size: 0.9rem;
background: var(--vp-c-bg-soft);
color: var(--vp-c-text-1);
}
.input-field:focus {
outline: none;
border-color: var(--vp-c-brand);
.domain-input {
padding: 0.5rem;
border: 1px solid var(--vp-c-divider);
border-radius: 4px;
}
.lookup-btn {
padding: 12px 24px;
padding: 0.5rem 1.5rem;
background: var(--vp-c-brand);
color: white;
border: none;
border-radius: 6px;
font-size: 0.9rem;
font-weight: 600;
cursor: pointer;
transition: background 0.2s;
}
.lookup-btn:hover {
background: var(--vp-c-brand-dark);
}
.lookup-process {
background: var(--vp-c-bg);
border-radius: 8px;
padding: 20px;
margin-bottom: 20px;
}
.process-title {
font-size: 1rem;
font-weight: bold;
color: var(--vp-c-text-1);
margin-bottom: 20px;
text-align: center;
}
.step-list {
display: flex;
flex-direction: column;
gap: 0;
}
.step-item {
display: flex;
align-items: flex-start;
gap: 15px;
position: relative;
opacity: 0.3;
transition: opacity 0.3s;
}
.step-item.active {
opacity: 1;
}
.step-item.completed {
opacity: 0.7;
}
.step-icon {
width: 40px;
height: 40px;
border-radius: 50%;
background: var(--vp-c-divider);
color: var(--vp-c-text-3);
display: flex;
align-items: center;
justify-content: center;
font-weight: bold;
font-size: 0.9rem;
flex-shrink: 0;
}
.step-item.active .step-icon {
background: var(--vp-c-brand);
color: white;
}
.step-item.completed .step-icon {
background: #22c55e;
color: white;
}
.step-content {
flex: 1;
padding-top: 5px;
}
.step-title {
font-size: 0.95rem;
font-weight: bold;
color: var(--vp-c-text-1);
margin-bottom: 4px;
}
.step-desc {
font-size: 0.85rem;
color: var(--vp-c-text-3);
margin-bottom: 6px;
}
.step-animation {
font-size: 0.8rem;
color: var(--vp-c-brand);
background: var(--vp-c-bg-soft);
padding: 8px;
border-radius: 4px;
font-family: monospace;
cursor: pointer;
height: 40px;
align-self: flex-end;
}
.step-arrow {
position: absolute;
left: 20px;
top: 40px;
width: 2px;
height: calc(100% - 20px);
background: var(--vp-c-divider);
.lookup-btn:disabled {
opacity: 0.5;
}
.step-item.completed .step-arrow {
background: #22c55e;
}
.result-box {
background: var(--vp-c-bg);
border-radius: 8px;
padding: 20px;
margin-bottom: 20px;
border-left: 4px solid #22c55e;
}
.result-title {
font-size: 1rem;
font-weight: bold;
color: var(--vp-c-text-1);
margin-bottom: 15px;
}
.result-content {
display: flex;
flex-direction: column;
gap: 10px;
margin-bottom: 15px;
}
.result-item {
.viz-area {
display: flex;
justify-content: space-between;
padding: 10px;
background: var(--vp-c-bg-soft);
border-radius: 6px;
align-items: center;
margin-bottom: 2rem;
position: relative;
min-height: 150px;
}
.result-item .label {
font-size: 0.85rem;
color: var(--vp-c-text-3);
font-weight: 600;
}
.result-item .value {
font-size: 0.9rem;
color: var(--vp-c-brand);
font-family: monospace;
font-weight: 600;
}
.reset-btn {
width: 100%;
padding: 10px;
background: var(--vp-c-brand);
color: white;
border: none;
border-radius: 6px;
font-size: 0.9rem;
font-weight: 600;
cursor: pointer;
transition: background 0.2s;
}
.reset-btn:hover {
background: var(--vp-c-brand-dark);
}
.info-box {
background: var(--vp-c-bg);
border-radius: 8px;
padding: 20px;
border-left: 4px solid var(--vp-c-brand);
}
.info-title {
font-size: 1rem;
font-weight: bold;
color: var(--vp-c-text-1);
margin-bottom: 15px;
}
.info-content {
.node {
display: flex;
flex-direction: column;
gap: 15px;
align-items: center;
padding: 1rem;
border: 2px solid var(--vp-c-divider);
border-radius: 8px;
background: var(--vp-c-bg);
transition: all 0.3s;
width: 100px;
}
.info-item {
font-size: 0.85rem;
.node.client {
border-color: #3b82f6;
}
.servers-container {
display: flex;
gap: 1rem;
}
.node.server.active {
border-color: #f59e0b;
transform: scale(1.1);
box-shadow: 0 0 15px rgba(245, 158, 11, 0.3);
}
.node.server.success {
border-color: #10b981;
}
.server-icon {
font-size: 1.5rem;
margin-bottom: 0.5rem;
}
.server-name {
font-weight: bold;
font-size: 0.8rem;
}
.server-desc {
font-size: 0.7rem;
color: var(--vp-c-text-2);
line-height: 1.8;
}
.log-panel {
background: #1e1e1e;
color: #10b981;
padding: 1rem;
border-radius: 6px;
height: 150px;
overflow-y: auto;
font-family: monospace;
font-size: 0.8rem;
}
.log-entry {
margin-bottom: 0.3rem;
}
.log-entry .time {
color: #6b7280;
margin-right: 0.5rem;
}
/* Toggle Switch */
.toggle {
display: flex;
align-items: center;
cursor: pointer;
gap: 0.5rem;
}
.toggle input {
display: none;
}
.toggle .slider {
width: 40px;
height: 20px;
background: #ccc;
border-radius: 20px;
position: relative;
transition: 0.3s;
}
.toggle .slider:before {
content: '';
position: absolute;
width: 16px;
height: 16px;
border-radius: 50%;
background: white;
top: 2px;
left: 2px;
transition: 0.3s;
}
.toggle input:checked + .slider {
background: var(--vp-c-brand);
}
.toggle input:checked + .slider:before {
transform: translateX(20px);
}
</style>