# junshi_del

**Repository Path**: aufesta/junshi_del

## Basic Information

- **Project Name**: junshi_del
- **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-06-05
- **Last Updated**: 2026-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 军史图片分类 (JunShiDel)

Android 应用：扫描 `Pictures` 目录下 `.junshi_` 开头的隐藏文件夹，去掉名称前的 `.`，并用 ML Kit 姿态检测识别是否包含清晰人体，将图片移动到对应子文件夹。

## 功能

1. 扫描 `/sdcard/Pictures/`（或 `内部存储/Pictures`）
2. 查找以 `.junshi_` 开头的文件夹
3. 重命名为 `junshi_...`（去掉开头的 `.`）
4. 递归读取该文件夹及子目录中的所有图片（jpg/png/webp 等）
5. 使用 Google ML Kit **精确姿态检测** 判断是否有清晰人体：
   - 需检测到躯干（双肩 + 至少一侧髋部）
   - 需检测到头部或至少 2 个四肢关键点
   - 至少 8 个关键点置信度 ≥ 0.55
6. 将图片**移动**到：
   - `有人体/` — 检测到清晰人体
   - `无人体/` — 未检测到

## 目录示例

处理前：

```
Pictures/
└── .junshi_2024/
    ├── a/
    │   ├── photo1.jpg
    │   └── photo2.jpg
    └── b/photo3.png
```

处理后：

```
Pictures/
└── junshi_2024/
    ├── a/
    ├── b/
    ├── 有人体/
    │   └── photo1.jpg
    └── 无人体/
        ├── photo2.jpg
        └── photo3.png
```

## 构建

使用 Android Studio 打开本项目，或命令行：

```bash
# 需要安装 Android SDK 和 JDK 17
./gradlew assembleDebug
```

APK 输出路径：`app/build/outputs/apk/debug/app-debug.apk`

## 权限说明

| Android 版本 | 所需权限 |
|---|---|
| 13+ | 读取媒体图片 + **所有文件访问权限** |
| 11–12 | **所有文件访问权限**（重命名文件夹、移动文件） |
| 10 及以下 | 读写外部存储 |

首次运行请按界面提示授予权限。Android 11+ 需在系统设置中开启「允许访问所有文件」。

## 技术栈

- Kotlin + Coroutines
- ML Kit Pose Detection Accurate
- minSdk 24 / targetSdk 34

## 注意事项

- 人体检测在本地离线运行，首次使用会下载 ML 模型（需联网一次）
- 已位于 `有人体/` 或 `无人体/` 中的图片不会重复处理
- 若目标文件名冲突，会自动追加 `_1`、`_2` 等后缀