Initial commit: 小南娘 - 面向可爱的蓝孩子的 git 学习实践项目

仿 Dress 的照片投稿仓库, 适配自建 Gitea 平台 git.xhmcl.com:
- README / GUIDE (PR 教程) / CONTRIBUTING / Q&A / EXIF / PARTIAL_CLONE (中英双语)
- A-Z + # 首字母目录结构
- .gitea: PR 模板、维护者名单、7 个纯 bash + API 的 Actions 工作流 (可选功能)

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
xhgitandClaude Code committed 2026-11-07 17:17:27 +08:00
commit cf17c9ea42
51 files changed
+2450

No files matched your search

+91
View File
@@ -0,0 +1,91 @@
# 📋 EXIF 是什么?
## 简介
**EXIF**(Exchangeable Image File Format)是嵌入在图片文件中的一份「数字档案」。
每次你用手机或相机拍照,设备会自动把拍摄时的各种信息记录进去——包括你**在哪里拍**、**用什么设备拍**、**什么时候拍**。
除了 EXIF 本身,图片还可能携带 **IPTC**、**XMP** 等元数据格式,同样能存储位置和个人信息。
照片提交准则和常用元数据清理方法请查看 [贡献准备](CONTRIBUTING.md)。
> ⚠️ 如果平台启用了 Gitea Actions,下方「高度敏感」字段会被本仓库的工作流自动检测,发现即要求修正。**平台未启用 Actions 时不会自动拦截,提交前请务必自查。**
---
## 🔴 高度敏感
**这些字段会被自动检测(平台启用 Actions 时),发现即要求修正。**
| 字段 | 说明 |
|---|---|
| `GPS:GPSLatitude` / `GPS:GPSLongitude` | 精确地理坐标,可定位到米级 |
| `GPS:GPSAltitude` | 海拔高度 |
| `GPS:GPSDateStamp` + `GPS:GPSTimeStamp` | 精确拍摄时刻(结合坐标可还原行踪)|
| `GPS:GPSSpeed` / `GPS:GPSTrack` / `GPS:GPSImgDirection` | 移动速度、方向 |
| `IPTC:City` / `IPTC:Country` / `IPTC:Sub-location` / `IPTC:Province-State` | 文字形式的拍摄地址 |
| `XMP-photoshop:City` / `XMP-photoshop:Country` / `XMP-photoshop:State` | Photoshop/Lightroom 写入的地址 |
| `XMP-iptcCore:CreatorWorkEmail` | Creator's work email |
| `XMP-iptcCore:CreatorWorkTelephone` | 创作者电话 |
| `XMP-iptcCore:CreatorCity` / `CreatorCountry` / `CreatorPostalCode` | 创作者通讯地址 |
---
## 🟠 较敏感
**这些字段不会导致 PR 被拒,但建议留意——尤其是序列号类信息可以跨图片追踪到同一台设备。**
| 字段 | 说明 |
|---|---|
| `EXIF:BodySerialNumber` / `EXIF:CameraSerialNumber` | 设备序列号,可跨图追踪 |
| `EXIF:LensSerialNumber` | 镜头序列号 |
| `EXIF:Artist` / `XMP-dc:Creator` | 拍摄者/创作者姓名 |
| `MakerNotes:FaceName` / `XMP-mwg-rs:PersonInImageName` | 相机人脸识别绑定的人名 |
---
## 🟡 低度敏感
**通常对隐私影响较小,本项目不拦截,保留这些信息是可以接受的。**
| 字段 | 说明 |
|---|---|
| `EXIF:DateTimeOriginal` | 拍摄时间(无位置时风险较低) |
| `EXIF:Make` / `EXIF:Model` | 相机/手机品牌型号 |
| `EXIF:Software` | 后期处理软件 |
| `EXIF:FNumber` / `EXIF:ExposureTime` / `EXIF:ISO` | 光圈、快门、感光度等摄影参数 |
| `EXIF:Copyright` | 版权声明 |
---
## 🔍 如何自查
提交前可用以下命令查看图片中是否残留高敏感信息:
```bash
# 安装 exiftool
# macOS: brew install exiftool
# Ubuntu: sudo apt install libimage-exiftool-perl
# Windows: https://exiftool.org/
# 检查单张图片
exiftool -GPS:all -IPTC:City -IPTC:Country-PrimaryLocationName \
-XMP-photoshop:City -XMP-iptcCore:CreatorWorkEmail your_photo.jpg
# 若以上命令无任何输出,说明高敏感字段均已清除。
```
### 完整清除所有元数据
```bash
# 删除全部 EXIF/XMP/IPTC(最彻底)
exiftool -all= -o cleaned_photo.jpg your_photo.jpg
```
---
## 📖 延伸阅读
如果你对 EXIF 感兴趣,可以通过以下资源深入了解:
- [ExifTool 官方文档](https://exiftool.org/)
- [EXIF(维基百科)](https://en.wikipedia.org/wiki/Exif)