# Notee

**Repository Path**: Ethan-Bai/notee

## Basic Information

- **Project Name**: Notee
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-23
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Notee - 现代化卡片式笔记应用

基于 PyQt5 开发的现代化卡片式笔记应用，采用 Material Design 设计风格。

## 功能特性

### 核心功能
- 📝 **卡片式布局**：现代化卡片设计，支持展开/折叠动画
- 🏷️ **分类标签**：支持自定义分类和标签系统
- 📄 **富文本内容**：支持富文本编辑和显示
- 💻 **代码高亮**：支持语法高亮的代码块编辑
- 🖼️ **图片上传**：支持拖拽上传图片（预留接口）
- 🔍 **全局搜索**：高性能搜索系统，支持标题、分类、内容等多字段搜索
- 📱 **响应式设计**：适配不同屏幕尺寸

### CRUD 操作
- ✅ **创建**：带表单验证的新建笔记功能
- ✏️ **编辑**：完整的笔记编辑功能
- 🗑️ **删除**：软删除/归档功能
- 📋 **查看**：摘要视图和完整视图切换

### 动画效果
- 🎭 **平滑动画**：使用 CSS Transform 实现的展开/折叠动画
- ⏳ **加载指示器**：操作过程中的加载状态指示

## 项目结构

```
Notee/
├── app/
│   ├── main.py              # 程序入口
│   ├── core/
│   │   └── main_window.py   # 主窗口
│   ├── models/
│   │   └── note.py          # 笔记数据模型
│   ├── data/
│   │   └── storage.py       # 数据存储管理
│   ├── widgets/
│   │   ├── note_card.py     # 笔记卡片组件
│   │   ├── search_widget.py # 搜索组件
│   │   └── note_editor.py   # 笔记编辑器
│   └── resources/
│       └── icons/           # 图标资源
├── tests/                   # 测试文件
└── README.md
```

## 安装和运行

### 环境要求
- Python 3.7+
- PyQt5

### 安装依赖
```bash
pip install PyQt5
```

### 运行应用
```bash
cd h:\PyFile\Programming\Notee
python app/main.py
```

或者使用 PowerShell：
```powershell
cd h:\PyFile\Programming\Notee
python app/main.py
```

## 使用说明

### 创建新笔记
1. 点击顶部工具栏的"新建笔记"按钮
2. 填写必填的标题和内容字段
3. 选择分类，添加标签和代码块（可选）
4. 点击"保存"完成创建

### 搜索笔记
1. 在搜索框中输入关键词
2. 可选择搜索字段（全部、标题、内容等）
3. 实时显示搜索结果和数量统计

### 编辑笔记
1. 在笔记卡片上点击"编辑"按钮
2. 修改笔记内容
3. 保存更改

### 归档/删除笔记
- **归档**：点击"归档"按钮将笔记移至归档分类
- **删除**：点击"删除"按钮永久删除笔记（需确认）

## 数据存储

笔记数据以 JSON 格式存储在 `app/data/notes.json` 文件中，包含以下字段：
- `note_id`: 笔记唯一标识
- `title`: 笔记标题
- `content`: 笔记内容
- `category`: 分类
- `tags`: 标签列表
- `code_blocks`: 代码块列表
- `images`: 图片列表（预留）
- `remarks`: 备注
- `created_at`: 创建时间
- `updated_at`: 更新时间
- `is_archived`: 是否归档

## 开发说明

### 扩展功能
- 图片上传功能可通过集成文件对话框实现
- 代码高亮可使用 PyQt5 的 QSyntaxHighlighter
- 主题切换可添加深色模式支持

### 自定义样式
应用样式采用 Material Design 设计原则，主要颜色：
- 主色调：`#2196f3`（蓝色）
- 强调色：`#ff9800`（橙色）
- 背景色：`#fafafa`（浅灰）
- 文字色：`#333333`（深灰）

## 许可证

MIT License