# 小影智能助理

**Repository Path**: mihu/aiaid

## Basic Information

- **Project Name**: 小影智能助理
- **Description**: AIAiD - Intelligent Personal Assistant (小影智能助理) 是一个运行在 Windows 桌面端的智能效率助理。它通过记录你的屏幕活动、应用使用情况，结合 AI (LLM) 能力，为你提供自动化的日报生成、目标管理辅助以及可视化的工作流编排。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-07
- **Last Updated**: 2026-01-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AIAiD - Intelligent Personal Assistant (小影智能助理)

> **AIAiD** 是一个运行在 Windows 桌面端的智能效率助理。它通过记录你的屏幕活动、应用使用情况，结合 AI (LLM) 能力，为你提供自动化的日报生成、目标管理辅助以及可视化的工作流编排。

**本项目完全由 AI (Google DeepMind) 生成与构建**

---

## ✨ 核心功能 (Features)

### 📊 全方位的活动追踪 (Activity Tracking)
实时记录当前活跃窗口标题、所属进程及持续时间。通过直观的时间轴与饼图（应用分布/网站分类），带你回顾一天的时间去向。

![Activity Tracking](images/activity.png)

### 📺 屏幕回溯 (Screen Recall)
自动化的屏幕快照记录。支持按时间线回放，查看关键帧，帮助你找回遗忘的工作上下文。

![Screen Recall](images/screen.png)

### 🎯 目标与任务管理 (Goal Management)
支持层级化的目标（Goal）与任务（Task）管理。结合 Markdown 编辑器，你可以清晰地规划周计划与月度目标，并利用 AI 拆解任务。

![Goal Management](images/goal.png)

### 📝 智能日报 (Daily Report)
基于一天的活动记录与屏幕内容，利用大语言模型（Gemini/Qwen）自动生成结构化的中文日报，总结今日工作成就。

![Daily Report](images/report.png)

### ⚙️ 可视化工作流 (Visual Workflow)
内置 LangGraph 可视化编辑器，直观展示 AI 任务的执行流转逻辑（如日报生成流程）。

![Workflow Editor](images/flow.png)

### 🛠️ 深度数据管理 (Data & Settings)
提供完善的后台管理界面，包括系统设置、字典配置以及底层数据库的直接查看能力，确保你对个人数据拥有完全的掌控权。

| 系统设置 | 字典管理 | 数据浏览 |
| :---: | :---: | :---: |
| ![Settings](images/setting.png) | ![Dictionary](images/dict.png) | ![Database](images/db.png) |

---

## 🏗️ 技术架构 (Architecture)

本项目采用现代化的前后端分离架构，专为 Windows 桌面体验优化：

*   **Frontend**: `Next.js 16` + `React 19` + `Ant Design` + `Tailwind CSS`
*   **Backend**: `FastAPI` + `SQLAlchemy` + `APScheduler`
*   **Desktop Shell**: `PySide6` (用于系统托盘、侧边栏及后台进程管理)
*   **Data Store**:
    *   **SQLite**: 存储结构化业务数据
    *   **LanceDB** (可选): 向量数据库，用于屏幕语义检索
*   **AI Engine**: Google Gemini / Qwen (Via API)
*   **Workflow Orchestration**: `LangGraph` (用于构建智能体的复杂业务流与可视化)

## 🚀 快速开始 (Getting Started)

### 前置要求
- Windows 10/11
- Python 3.10+
- Node.js 18+

### 1. 启动后端 (Backend)

```bash
cd backend
pip install -r requirements.txt

# 启动 API 服务、系统托盘及后台任务
python run.py
```

> `run.py` 会自动启动 FastAPI 服务 (Port 8000) 和 PySide6 托盘图标。

### 2. 启动前端 (Frontend)

```bash
cd frontend
npm install

# 启动开发服务器
npm run dev
```

访问浏览器地址: `http://localhost:3000`

---

## ⚙️ 配置说明

主要配置位于 **设置页面**，支持动态修改：

*   **LLM Provider**: 选择 `Gemini` 或 `Qwen`。
*   **API Keys**: 填入对应的 API Key。
*   **Vision & Audio**: 开启或关闭屏幕截图与音频监控功能。

环境变量配置 (可选,create `.env` in `backend/`):
```env
GOOGLE_API_KEY=your_key_here
```

## 📦 构建发布

项目包含一键构建脚本，可将前端打包并在后端生成单一可执行文件：

```bash
python build_release.py
```

产物将生成在 `backend/dist/AIAiD/` 目录下。

## ⚠️ 隐私说明

AIAiD 旨在运行于**本地环境**，你的数据（截图、活动日志）均存储于本地 `backend/data/` 目录。
*   在启用 AI 功能时，部分脱敏文本/图片摘要会被发送至云端 LLM 提供商。
*   请确保保管好你的 `data` 目录及 API Key。

## 🤝 贡献 (Contributing)

欢迎提交 Issue 和 Pull Request！
由于本项目由 AI 辅助生成，代码风格可能融合了多种习惯，建议在提交前进行充分的测试。

## 📄 License

[MIT License](LICENSE)