# my_nav

**Repository Path**: kunka588/my_nav

## Basic Information

- **Project Name**: my_nav
- **Description**: 一个轻量的网页收集导航项目，使用json文件存储数据
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-08-22
- **Last Updated**: 2025-11-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ModernLink Hub - 现代网页导航管理系统

一个优雅、功能丰富的个人网页导航管理系统，帮助您高效管理和发现优质网络资源。

## 🌟 项目特色

- **🎨 现代化界面**：基于Bootstrap 5的响应式设计，支持深色/浅色主题
- **📱 全设备适配**：完美支持桌面、平板、手机等各种屏幕尺寸
- **🔍 智能搜索**：实时搜索、多维度筛选，快速定位目标网站
- **🏷️ 灵活分类**：支持多级分类和标签系统，资源管理井井有条
- **📊 可视化分组**：按类别分组展示，支持折叠/展开交互
- **🚀 快速访问**：一键直达目标网站，支持批量操作
- **💾 数据持久化**：本地JSON文件存储，支持导入导出
- **⚡ 高性能**：纯前端渲染，响应迅速无延迟

## 🛠️ 技术栈

- **后端**：Python Flask 轻量级Web框架
- **前端**：HTML5 + CSS3 + JavaScript (ES6+)
- **UI框架**：Bootstrap 5 + FontAwesome图标
- **数据存储**：JSON文件本地存储
- **依赖管理**：pip包管理器

## 📋 功能详解

### 1. 资源管理
- **添加链接**：支持自定义名称、URL、描述、图标、分类和标签
- **编辑功能**：随时修改链接信息
- **删除操作**：单个或批量删除链接
- **图标支持**：自动获取网站favicon或自定义图标URL

### 2. 分类与标签
- **预设分类**：AI、工具、社区、资源、导航等
- **自定义标签**：为每个链接添加个性化标签
- **智能分组**：自动按类别分组显示
- **折叠面板**：支持类别内容的展开/收起

### 3. 搜索与筛选
- **全局搜索**：实时搜索名称、描述、分类、标签
- **分类筛选**：点击左侧分类快速过滤
- **标签筛选**：多标签组合筛选
- **清空筛选**：一键清除所有筛选条件

### 4. 数据管理
- **自动保存**：所有修改实时保存到本地文件
- **导入功能**：支持JSON格式数据导入
- **导出功能**：一键导出完整数据备份
- **数据恢复**：支持从备份文件恢复数据

## 🚀 快速开始

### 环境要求
- Python 3.7+
- pip包管理器

### 安装步骤

1. **克隆项目**
```bash
git clone [项目地址]
cd my_nav
```

2. **安装依赖**
```bash
pip install -r requirements.txt
```

3. **启动服务**
```bash
python app.py
```

4. **访问应用**
打开浏览器访问：http://localhost:5000

## 📁 项目结构

```
my_nav/
├── app.py                 # Flask应用主文件
├── requirements.txt       # Python依赖列表
├── data/
│   └── links.json       # 链接数据存储
├── static/
│   ├── css/
│   │   └── style.css    # 自定义样式
│   └── js/
│       └── app.js       # 前端交互逻辑
└── templates/
    └── index.html       # 主页面模板
```

## 🎯 使用指南

### 添加新链接
1. 点击右上角的"添加链接"按钮
2. 填写网站信息（带*为必填项）
3. 选择或输入分类
4. 添加相关标签（可选）
5. 点击保存即可

### 搜索资源
- **全局搜索**：使用顶部搜索框
- **分类筛选**：点击左侧分类按钮
- **标签筛选**：点击左侧标签
- **组合筛选**：可同时使用多种筛选方式

### 数据备份
1. 点击左侧菜单的"导出数据"按钮
2. 保存生成的JSON文件
3. 需要恢复时使用"导入数据"功能

## 🎨 界面预览

### 主界面
- 左侧：分类和标签筛选区域
- 右侧：链接卡片展示区域
- 顶部：全局搜索框和操作按钮

### 链接卡片
- 网站图标自动显示
- 网站名称高亮显示
- 分类标签清晰标识
- 描述文字简洁明了
- 操作按钮悬浮显示

## 🔧 自定义配置

### 修改预设分类
编辑 `static/js/app.js` 文件中的 `categoryOrder` 数组：
```javascript
const categoryOrder = ['AI', '工具', '社区', '资源', '导航', '未分类'];
```

### 调整样式
编辑 `static/css/style.css` 文件自定义颜色、间距等样式

### 扩展功能
项目采用模块化设计，易于扩展新功能

## 📱 移动端体验

- **响应式布局**：完美适配各种屏幕尺寸
- **触摸优化**：按钮大小适合触摸操作
- **手势支持**：支持滑动等手势操作
- **离线缓存**：支持PWA离线访问（可扩展）

## 🤝 贡献指南

欢迎提交Issue和Pull Request来改进项目！

### 开发建议
1. 保持代码风格一致
2. 添加必要的注释
3. 测试所有功能后再提交
4. 更新相关文档

## 📄 许可证

本项目采用MIT许可证，详见LICENSE文件。

## 🙏 致谢

- [Bootstrap](https://getbootstrap.com/) - 前端UI框架
- [FontAwesome](https://fontawesome.com/) - 图标库
- [Flask](https://flask.palletsprojects.com/) - Python Web框架

---

**ModernLink Hub** - 让资源管理变得简单而优雅！