DeepBlog博客系统文档中心

# 📚 DeepBlog博客系统文档中心

> 版本：v1.0 | 最后更新：2026-04-21

<style>
/* 搜索框样式 */
:root {
    --primary-color: #4a90d9;
    --border-color: #e1e5e9;
    --bg-hover: #f5f7fa;
    --shadow: 0 2px 8px rgba(0,0,0,0.08);
}

.search-container {
    margin: 2rem 0;
    position: relative;
}

#docSearch {
    width: 100%;
    padding: 14px 20px;
    font-size: 16px;
    border: 2px solid var(--border-color);
    border-radius: 12px;
    outline: none;
    transition: all 0.3s ease;
    background: #fff;
}

#docSearch:focus {
    border-color: var(--primary-color);
    box-shadow: 0 0 0 3px rgba(74,144,217,0.1);
}

.search-results {
    margin-top: 1rem;
    border-radius: 12px;
    background: #fff;
    box-shadow: var(--shadow);
    overflow: hidden;
}

.search-result-item {
    padding: 1rem 1.5rem;
    border-bottom: 1px solid var(--border-color);
    transition: background 0.2s;
    cursor: pointer;
}

.search-result-item:hover {
    background: var(--bg-hover);
}

.search-result-title {
    font-size: 1.1rem;
    font-weight: 600;
    color: var(--primary-color);
    text-decoration: none;
    display: block;
    margin-bottom: 0.5rem;
}

.search-result-snippet {
    font-size: 0.9rem;
    color: #5a6874;
    line-height: 1.5;
}

mark.highlight {
    background: #ffeb3b;
    padding: 0 2px;
    border-radius: 3px;
    color: #2c3e50;
}

.search-loading {
    text-align: center;
    padding: 2rem;
    color: #8a9aa8;
}

.search-empty {
    text-align: center;
    padding: 2rem;
    color: #8a9aa8;
}

.search-stats {
    padding: 0.75rem 1.5rem;
    background: #f8f9fa;
    font-size: 0.85rem;
    color: #6c7a8a;
    border-bottom: 1px solid var(--border-color);
}

/* 响应式 */
@media (max-width: 768px) {
    #docSearch {
        padding: 12px 16px;
        font-size: 14px;
    }
    
    .search-result-item {
        padding: 0.75rem 1rem;
    }
    
    .search-result-title {
        font-size: 1rem;
    }
}
</style>

searchInput.addEventListener('input', function() {
    clearTimeout(debounceTimer);
    const keyword = this.value.trim();
    
    if (keyword.length < 2) {
        resultsContainer.innerHTML = '';
        return;
    }
    
    debounceTimer = setTimeout(() => performSearch(keyword), 300);
});

async function performSearch(keyword) {
    // 显示加载状态
    resultsContainer.innerHTML = '<div class="search-loading">🔍 正在搜索中...</div>';
    
    try {
        const response = await fetch(`/docs/search?keyword=${encodeURIComponent(keyword)}`);
        const data = await response.json();
        
        if (data.code === 200 && data.data.length > 0) {
            renderResults(data.data, data.keyword);
        } else {
            resultsContainer.innerHTML = `<div class="search-empty">😢 未找到包含"${escapeHtml(keyword)}"的内容，请尝试其他关键词</div>`;
        }
    } catch (error) {
        console.error('搜索失败:', error);
        resultsContainer.innerHTML = '<div class="search-empty">⚠️ 搜索服务暂时不可用，请稍后重试</div>';
    }
}

function escapeHtml(text) {
    const div = document.createElement('div');
    div.textContent = text;
    return div.innerHTML;
}
</script>

## 📑 文档导航

### 📖 用户试用手册
- [前台功能](/docs/user-manual.md#前台功能)
  - [文章浏览](/docs/user-manual.md#文章浏览)
  - [文章搜索](/docs/user-manual.md#文章搜索)
  - [评论互动](/docs/user-manual.md#评论互动)
  - [用户中心](/docs/user-manual.md#用户中心)
- [后台管理](/docs/user-manual.md#后台管理)
  - [登录与权限](/docs/user-manual.md#登录与权限)
  - [文章管理](/docs/user-manual.md#文章管理)
  - [分类管理](/docs/user-manual.md#分类管理)
  - [标签管理](/docs/user-manual.md#标签管理)
  - [用户管理](/docs/user-manual.md#用户管理)
  - [系统设置](/docs/user-manual.md#系统设置)

### 🔧 技术对接文档
- [系统架构](/docs/developer-guide.md#系统架构)
  - [整体架构](/docs/developer-guide.md#整体架构)
  - [目录结构](/docs/developer-guide.md#目录结构)
- [数据库设计](/docs/developer-guide.md#数据库设计)
  - [核心表结构](/docs/developer-guide.md#核心表结构)
- [API接口文档](/docs/developer-guide.md#api接口文档)
  - [获取文章列表](/docs/developer-guide.md#获取文章列表)
  - [获取文章详情](/docs/developer-guide.md#获取文章详情)
- [二次开发指南](/docs/developer-guide.md#二次开发指南)
  - [创建新模块](/docs/developer-guide.md#创建新模块)
  - [扩展点说明](/docs/developer-guide.md#扩展点说明)
- [部署与配置](/docs/developer-guide.md#部署与配置)
  - [环境要求](/docs/developer-guide.md#环境要求)
  - [核心配置说明](/docs/developer-guide.md#核心配置说明)

## 🚀 快捷入口
- [📖 用户试用手册](/docs/user-manual.md)：面向网站管理员和普通用户的操作说明
- [🔧 技术对接文档](/docs/developer-guide.md)：面向开发人员的二次开发和API对接说明