AI Diary

📝 一个基于 HarmonyOS Next 的极简笔记应用

✨ 特性

• 📱 多设备支持 - 支持手机、平板、2-in-1 设备和可穿戴设备
• ✏️ 快速记录 - 简洁的编辑界面，专注于内容创作
• 🏷️ 标签管理 - 灵活的标签系统，轻松组织笔记
• 🔍 智能搜索 - 支持关键词和标签搜索
• 🎨 主题色 - 清新的绿色主题 (#48b878)
• 🔄 数据持久化 - 基于关系型数据库的本地存储
• 🎴 服务卡片 - 桌面快捷创建笔记

🏗️ 技术架构

核心技术栈

• 开发语言: ArkTS (TypeScript for HarmonyOS)
• UI 框架: ArkUI (声明式 UI)
• 架构模式: MVVM
• 数据库: RelationalStore (关系型数据库)
• 构建工具: Hvigor
• 包管理: OHPM

架构设计

┌─────────────────────────────────────────┐
│         应用入口层                        │
│  EntryAbility → HomePage (首页入口)      │
└─────────────────────────────────────────┘
                  ↓
┌─────────────────────────────────────────┐
│         页面层 (MVVM)                    │
│  HomePage | EditPage | SearchPage       │
└─────────────────────────────────────────┘
                  ↓
┌─────────────────────────────────────────┐
│         组件层                           │
│  NavigationBar | MemoCard | Drawer...   │
└─────────────────────────────────────────┘
                  ↓
┌─────────────────────────────────────────┐
│         数据层                           │
│  Models | RDBStore | Constants          │
└─────────────────────────────────────────┘

📦 项目结构

AI_Diary/
├── entry/                          # 主模块
│   ├── src/
│   │   ├── main/
│   │   │   ├── ets/               # ArkTS 源代码
│   │   │   │   ├── pages/         # 页面
│   │   │   │   │   ├── HomePage.ets           # 主页 View
│   │   │   │   │   ├── HomePage.vm.ets        # 主页 ViewModel
│   │   │   │   │   ├── HomePage.service.ets   # 主页 Service
│   │   │   │   │   ├── HomePage.types.ets     # 主页 Types
│   │   │   │   │   ├── edit/                  # 编辑页 (MVVM)
│   │   │   │   │   │   ├── EditPage.ets       # View
│   │   │   │   │   │   ├── EditPage.vm.ets    # ViewModel
│   │   │   │   │   │   ├── EditPage.service.ets # Service
│   │   │   │   │   │   └── EditPage.types.ets # Types
│   │   │   │   │   ├── search/                # 搜索页 (MVVM)
│   │   │   │   │   └── debug/                 # 调试页
│   │   │   │   ├── components/    # 公共组件
│   │   │   │   │   ├── NavigationBar.ets      # 导航栏
│   │   │   │   │   ├── MemoCard.ets           # 笔记卡片
│   │   │   │   │   ├── ContentList.ets        # 内容列表
│   │   │   │   │   ├── TagManagementDrawer.ets # 标签抽屉
│   │   │   │   │   └── TagPopover.ets         # 标签选择器
│   │   │   │   ├── common/        # 公共模块
│   │   │   │   │   └── database/
│   │   │   │   │       └── RDBStoreUtil.ets   # 数据库工具
│   │   │   │   ├── models/        # 数据模型
│   │   │   │   │   └── NoteModels.ets         # 笔记模型
│   │   │   │   ├── constants/     # 常量定义
│   │   │   │   └── entryability/  # 应用入口
│   │   │   └── resources/         # 资源文件
│   │   ├── test/                  # 单元测试
│   │   └── ohosTest/              # 系统测试
│   └── hvigorfile.ts              # 模块构建配置
├── docs/                          # 文档
│   ├── ARCHITECTURE.md            # 架构设计文档
│   ├── DATABASE_DESIGN.md         # 数据库设计
│   ├── ARKTS_UI_DEV_GOTCHAS.md   # UI 开发陷阱
│   └── design/                    # 设计稿
└── oh-package.json5               # 依赖配置

🚀 快速开始

环境要求

• DevEco Studio: 5.0.0 或更高版本
• HarmonyOS SDK: API 12 或更高版本

📱 功能说明

主要功能

1. 笔记管理

• ✅ 创建笔记
• ✅ 编辑笔记
• ✅ 删除笔记（带确认对话框）
• ✅ 笔记列表展示
• ✅ 展开/收起长内容

2. 标签系统

• ✅ 创建标签
• ✅ 为笔记添加标签
• ✅ 标签管理抽屉
• ✅ 按标签筛选笔记
• ✅ 标签统计（显示笔记数量）

3. 搜索功能

• ✅ 关键词搜索
• ✅ 标签搜索
• ✅ 搜索结果高亮
• ✅ 空状态提示

4. 服务卡片

• ✅ 桌面快捷入口
• ✅ 一键创建笔记
• ✅ 主题色统一

页面导航

HomePage (主页)
  ├─→ EditPage (编辑页) - 创建/编辑笔记
  ├─→ SearchPage (搜索页) - 搜索笔记
  └─→ TagDrawer (标签抽屉) - 标签管理

📚 文档

• 架构设计 - MVVM 架构详细说明
• 数据库设计 - 数据库表结构和 SQL
• UI 开发陷阱 - 常见问题和解决方案
• ArkTS 合规性指南 - 语法限制和最佳实践
• 教学主线 - 面向学员的案例讲解入口