# img-manager

**Repository Path**: genvex/img-manager

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-15
- **Last Updated**: 2026-10-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# img-manager — RDK X5 图片管理器

专为 RDK X5 边缘设备优化的轻量级图片管理系统。

## 特点

- **零依赖**: 仅 Python 标准库 + Pillow + hbm_runtime（设备预装）
- **低内存**: 运行仅需 ~20MB RAM
- **AI分类**: BPU 双模型融合（efficientnet-lite0 分类 + YOLOv8 检测兜底人物）
- **eMMC友好**: 缩略图小，减少闪存写入

## 文档

| 文档 | 内容 |
|------|------|
| [PROJECT_MECHANISM.md](PROJECT_MECHANISM.md) | **项目机理（推荐先读）**: 双模型融合分类/BPU管线/入库流程 |
| [AUTO_INGEST_GUIDE.md](AUTO_INGEST_GUIDE.md) | 自动入库指南 |
| [BPU_PERFORMANCE.md](BPU_PERFORMANCE.md) | BPU 实测性能 + 真实图片验证 |
| [YOLOV8_DETECTION.md](YOLOV8_DETECTION.md) | YOLOv8 检测实测 |
| [README_COMPLETE.md](README_COMPLETE.md) | 完整功能说明 |

## 快速开始

```bash
# BPU推理必须用python3.10(3.11无hbm_runtime会降级), 且显式指定IMG_HOME
cd ~/project/img-manager
IMG_HOME=~/project/img-manager python3.10 index.py
# 浏览器访问 http://192.168.199.129:8770
```

## 入库一张图

```bash
# 微信/脚本收到的图片走自动入库(格式识别+质量+融合分类+YOLOv8检测+catalog)
python3.10 auto_ingest.py /path/to/new_photo.jpg
```

## 使用命令

```bash
# 入库单张图片
python3 ~/img-manager/ingest.py photo.jpg --category 风景 --tags "海边,日落"

# 批量入库
python3 ~/img-manager/ingest.py staging/*.jpg --recursive

# AI自动分类
python3 ~/img-manager/ai_classify.py --batch

# 查看统计
python3 ~/img-manager/ingest.py --stat
```

## 与 gallery 的区别

| 特性 | gallery | img-manager |
|------|---------|-------------|
| 目标平台 | Dragon Q8B | RDK X5 |
| 内存占用 | ~200MB | ~20MB |
| 缩略图大小 | 320px | 256px |
| 运行时 | Bun优先 | Python |
| AI集成 | 无 | BPU预留 |

## API 接口

```
GET /api/catalog      # 全量目录
GET /api/search?q=词&cat=分类  # 搜索
GET /api/stats        # 统计
GET /images/<file>    # 原图
GET /thumbs/<file>    # 缩略图
```

---
*专为 RDK X5 (3GB RAM, eMMC, 10TOPS BPU) 设计*