# search-xiaoyangtx

**Repository Path**: yang-xufan/search-xiaoyangtx

## Basic Information

- **Project Name**: search-xiaoyangtx
- **Description**: 小杨搜索
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://search.xiaoyangtx.icu/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-29
- **Last Updated**: 2026-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 导航, 搜索

## README

# 小杨搜索（Search-XiaoyangTX）

> 现代化导航站与聚合搜索平台，支持多主题、实时搜索与卡片管理。

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Node.js](https://img.shields.io/badge/node.js-18%2B-brightgreen.svg)](https://nodejs.org/)
[![Vue.js](https://img.shields.io/badge/vue.js-3.4%2B-green.svg)](https://vuejs.org/)

## ✨ 功能特性

- 🎨 **多主题模式**：纯色、图片、渐变主题，支持自定义
- 📱 **响应式设计**：完美适配桌面端与移动端
- 🔍 **实时搜索**：全局搜索卡片，支持高亮与快速跳转
- 🗂️ **分类管理**：多级菜单与子分类，灵活组织卡片
- 🛡️ **安全防护**：CSRF 防护、请求限流、XSS 防护
- 📦 **数据备份**：手动/自动备份与恢复
- 🌍 **PWA 支持**：可安装为桌面应用，支持离线访问

## 🛠️ 技术栈

**前端**：Vue 3 + TypeScript + Vite + Pinia + TailwindCSS  
**后端**：Node.js + Express + SQLite + JWT

## 🚀 快速开始

### 环境要求

- Node.js >= 18.0.0
- npm >= 8.0.0

### 安装

```bash
# 克隆项目
git clone https://gitee.com/yang-xufan/search-xiaoyangtx.git
cd search-xiaoyangtx

# 安装依赖
cd backend && npm install
cd ../frontend && npm install
```

### 配置

在 `backend` 目录下创建 `.env` 文件：

```env
PORT=3000
NODE_ENV=production
DB_PATH=./data/database.db
JWT_SECRET=your-super-secret-jwt-key
JWT_EXPIRES_IN=7d
ADMIN_USERNAME=admin
ADMIN_PASSWORD=admin123
CORS_ORIGIN=http://localhost:5173
SESSION_SECRET=your-session-secret
```

### 启动

```bash
# 启动后端
cd backend && npm start

# 启动前端（新终端）
cd frontend && npm run dev
```

访问地址：
- 前台：http://localhost:5173
- 后台：http://localhost:5173/admin
- API：http://localhost:3000/api

### 生产部署

```bash
# 构建前端
cd frontend && npm run build

# 启动生产服务器
cd backend && npm start
```

访问：http://localhost:3000

## 📁 目录结构

```
search-xiaoyangtx/
├── backend/          # 后端服务
│   ├── middleware/   # 中间件
│   ├── routes/       # 路由
│   ├── utils/        # 工具函数
│   └── server.js     # 入口
├── frontend/         # 前端应用
│   └── src/
│       ├── api/      # API 接口
│       ├── components/  # 组件
│       ├── views/    # 页面
│       └── stores/   # 状态管理
└── README.md
```

## 🤝 贡献

1. Fork 项目
2. 创建功能分支：`git checkout -b feature/amazing-feature`
3. 提交：`git commit -m 'feat: add amazing feature'`
4. 推送：`git push origin feature/amazing-feature`
5. 提交 Pull Request

## 📄 许可证

[MIT 许可证](LICENSE)

##  联系

- 项目主页：[https://gitee.com/yang-xufan/search-xiaoyangtx](https://gitee.com/yang-xufan/search-xiaoyangtx)
- 问题反馈：[Issues](https://gitee.com/yang-xufan/search-xiaoyangtx/issues)

---

⭐ 如果这个项目对你有帮助，请给个 Star！