# 智能影记-Memoria

**Repository Path**: huangjinwangpu/intelligent-imaging-memory

## Basic Information

- **Project Name**: 智能影记-Memoria
- **Description**: 该仓库是山东大学软件学院项目实训课程的项目仓库。我们希望开发一款名为智能影记的多模态无门槛生活导演软件，将海量碎片化影像自动重构为高质量的图文日志与视听故事，让每个人都可以成为自己生活的导演。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-24
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎬 智能影记 (Memoria) - 让每个人都成为自己生活的导演

![Version](https://img.shields.io/badge/version-v1.0.0--dev-blue)
![Flutter](https://img.shields.io/badge/Flutter-Cross_Platform-02569B?logo=flutter)
![C++](https://img.shields.io/badge/C++-Native_AI-00599C?logo=c%2B%2B)
![Python](https://img.shields.io/badge/Python-Cloud_LLM-3776AB?logo=python)

## 📖 项目简介
**Memoria (智能影记)** 是由山东大学软件学院 **Mnemosyne** 团队开发的一款基于“端云协同架构”与多模态 AI 技术的智能生活导演系统。

在这个影像数据爆炸的时代，我们的相册里堆积了成千上万的碎片。本项目致力于利用 MobileCLIP 语义检索、大语言模型 (LLM) 思维链编导以及生成式音频 (AIGC) 技术，将“死板的图片素材”全自动重构为高质量的图文日志与视听故事。全程坚持**“原始影像不出设备”**的绝对隐私保护底线。

## ✨ 核心特性预告 (Roadmap)
- 🔍 **自然语言语义搜图**：打破传统标签限制，支持诸如“去年夏天在海边的奋斗历程”等复杂语义检索。
- 🛡️ **极致隐私的端侧 AI**：基于 NCNN/ONNX，在移动端本地完成 MobileCLIP 推理与图片特征提取。
- 🎞️ **AI 智能编导引擎**：云端 LLM 根据照片特征自动撰写极具感染力的旁白文案与分镜脚本。
- 🎵 **AIGC 视听卡点合成**：根据画面情绪实时生成专属 BGM，并利用节拍检测算法实现帧级自动剪辑。

## 🛠️ 技术栈选型
*   **前端展示层**：Flutter (跨平台高性能 UI 渲染)
*   **端侧 AI 层**：C++ / FFI / NCNN / ONNX Runtime
*   **端侧存储层**：SQLite-VSS (本地高维向量检索)
*   **云端服务层**：Python / FastAPI / Qwen2.5 (大模型) / MusicGen (音乐生成)

## 📂 仓库目录规范
为了保证 4 人敏捷开发的高效协同，本仓库设定如下初始目录结构：

```text
├── ai_tools/             # 端侧 AI 脚本、模型量化导出工具与测试数据
├── ios/                  # iOS 原生工程目录 (含 FFI 桥接与底层配置)
├── lib/                  # Flutter 核心 Dart 源码 (业务主阵地)
│   ├── core/             # 核心配置 (主题、常量、路由等)
│   ├── models/           # 数据模型定义 (如 MediaFeature 等)
│   ├── services/         # 接口服务 (端云通信、本地 AI 引擎调用)
│   └── views/            # UI 界面展示与交互逻辑
├── linux/                # Linux 原生工程目录
├── web/                  # Web 端工程目录
├── windows/              # Windows 原生工程目录
├── .gitignore            # Git 忽略规范 (⚠️ 已屏蔽大模型与本地环境配置)
├── analysis_options.yaml # Dart 代码规范与静态分析严格规则
├── launch.ps1            # Windows 环境一键编译/自动化部署脚本
├── launch.sh             # macOS/Linux 环境一键编译/自动化部署脚本
├── LICENSE               # 开源协议文件
└── pubspec.yaml          # Flutter 核心依赖配置 (核心包管理)
```

## ⚠️ 团队协作与模型管理规范 (必读)
由于端侧 AI 模型（如 `.onnx`, `.bin`, `.param` 等权重文件）及生成式音频测试集体积过大，**严禁将大于 50MB 的单文件推送到本 Gitee 仓库**。

1. **代码与文档**：统一通过本仓库的 `main` 与 `dev` 分支进行 PR 协作。
2. **模型与大文件**：所有 AI 权重模型、SDK 压缩包均存放在团队内部的共享网盘中。本地开发时，请根据 `docs/model_setup.md` 的说明手动下载并放置在 `native_ai/models/` 目录下（该目录已被 `.gitignore` 保护）。