# harmony-moodlist

**Repository Path**: singularwind/harmony-moodlist

## Basic Information

- **Project Name**: harmony-moodlist
- **Description**: 一个基于 Harmony OS 的情绪记录与调节应用，帮助用户通过简单记录、分析与反馈提升情绪自我管理能力。
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-20
- **Last Updated**: 2025-12-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 情绪清单 (Mood List) - MVP 版本

## **核心理念**:

“情绪清单”应用通过记录、分析和调节用户情绪，帮助用户提升情绪自我管理能力。结合伯恩斯新情绪疗法（CBT），应用提供简单有效的情绪记录与调整方法，帮助用户识别负面思维并提供定制化调节建议。

## **MVP阶段目标**:

在MVP阶段，我们将专注于以下核心功能，确保应用的基本功能稳定且能快速投入使用：

- **情绪记录**：用户可以快速记录情绪及简短描述。
- **自动识别认知扭曲**：根据用户输入的情绪数据，自动识别可能的认知扭曲类型（如过度概括、全有或全无等）。
- **简单调节建议**：根据情绪类型和识别的扭曲模式，提供1-3条简短的情绪调节方法。
- **趋势可视化**：展示情绪变化趋势，通过折线图或柱状图显示情绪数据。
- **本地存储**：所有数据将本地存储，确保隐私安全。

---

## **MVP开发优先级**

### **高优先级功能（MVP核心功能）**：
1. **情绪记录**：快速记录用户情绪及简短文字描述。
2. **认知扭曲识别**：根据规则映射识别情绪背后的负面思维模式。
3. **调节建议**：提供1-3条简短、有效的情绪调节方法。
4. **趋势可视化**：使用折线图展示用户的情绪变化趋势。
5. **本地存储（SQLite）**：实现情绪记录和调节方法的本地存储。

### **中期迭代功能**：
- **每日反思与总结**：记录用户每天的情绪反思，并提供简单的正向反馈。
- **情绪目标设定**：允许用户设置情绪管理目标，并跟踪进度。
- **本地推送提醒**：提醒用户每日记录情绪和反思。

### **长期扩展功能**：
- **微练习模块**：提供短小的情绪管理练习。
- **跨端同步**：支持跨设备同步情绪数据（例如，手机、平板等）。
- **情绪+氛围生成**：根据用户情绪自动调整背景音效和动画效果。
- **个性化调节方案**：使用本地AI生成个性化的情绪调节建议。

---

## **开发平台与技术栈**

- **开发平台**：鸿蒙OS（HarmonyOS）
- **开发工具**：DevEco Studio
- **编程语言**：Kotlin（常规功能开发）、ArkTS（分布式功能开发）
- **数据存储**：SQLite（本地存储）、后期支持DataAbility（数据同步）
- **前端UI**：ArkUI + ArkTS
- **数据可视化**：ECharts（折线图和柱状图）
- **推送提醒**：AlarmManager / WorkManager
- **微交互**：使用ArkUI动画组件

---

## **功能模块**

| 功能         | 描述                   | 技术实现                              |
|------------|----------------------|-----------------------------------|
| **情绪记录**   | 允许用户快速记录情绪及简短描述。     | 使用ArkUI实现选择界面，SQLite本地存储情绪数据。     |
| **认知扭曲识别** | 自动识别情绪背后的认知扭曲模式。     | 基于规则映射，简单算法判断认知扭曲类型（如过度概括、全有全无等）。 |
| **调节建议**   | 根据情绪类型与认知扭曲模式提供调节建议。 | 根据情绪和扭曲类型提供1-3条建议，使用文本和简短动画反馈。    |
| **趋势可视化**  | 折线图/柱状图展示情绪变化趋势。     | 使用ECharts生成折线图和柱状图，SQLite读取历史数据。  |
| **本地存储**   | 存储情绪记录及调节建议。         | 使用SQLite存储情绪数据、调节方法和用户反馈。         |

---

## **开发架构**

- **前端（UI）**：ArkUI + ArkTS（声明式布局，快速开发，跨设备可扩展）
- **后端（数据存储）**：SQLite（存储情绪记录和调节建议）
- **数据分析与反馈**：规则映射用于认知扭曲识别，使用ECharts进行情绪趋势的可视化展示。

---

## **开发策略**

- **MVP优先**：专注于情绪记录、认知扭曲识别和调节建议的实现，确保应用的基本功能。
- **轻量化**：简单易用、极简设计，秒级响应。
- **数据隐私**：本地存储所有数据，确保用户隐私。
- **可扩展性**：后期可以添加更多的功能，如跨端同步、微练习和AI调节建议。

---