mirror of https://github.com/Afilmory/afilmory synced 2026-02-01 22:48:17 +00:00

Files

Innei ced9e747aa feat: implement email notification system for comments

- Added MailModule to handle email notifications for comment events.
- Introduced CommentCreatedEvent to encapsulate comment creation details.
- Implemented CommentNotificationListener to send notifications to relevant users when a comment is created.
- Integrated Resend service for sending emails, with templates for comment notifications.
- Updated various modules to support the new email notification feature.

Signed-off-by: Innei <tukon479@gmail.com>

2025-12-03 20:57:26 +08:00

9.5 KiB

Raw Blame History

Afilmory RSS EXIF Extension Specification

概述

本规范定义了在 RSS 2.0 feeds 中包含摄影 EXIF 数据的标准方法，专为照片画廊网站设计。该扩展允许 RSS 阅读器和其他应用程序访问详细的摄影技术参数，并支持不同类型的图片展示。

协议版本

当前版本: 1.1
协议标识: afilmory-rss-exif

协议元数据

`<exif:version>`

描述: 协议版本号
位置: <channel> 元素内
格式: 语义化版本号
示例: <exif:version>1.1</exif:version>
必需: 是

`<exif:protocol>`

描述: 协议标识符
位置: <channel> 元素内
格式: 字符串标识符
示例: <exif:protocol>afilmory-rss-exif</exif:protocol>
必需: 是

EXIF 标签定义

相机设置参数 (basic)

`<exif:aperture>`

描述: 光圈值
格式: f/{数值}
示例: <exif:aperture>f/1.4</exif:aperture>
映射: EXIF FNumber 字段

`<exif:shutterSpeed>`

描述: 快门速度
格式:

长曝光: {秒数}s
短曝光: 1/{分母}s
示例:
<exif:shutterSpeed>1/250s</exif:shutterSpeed>
<exif:shutterSpeed>2s</exif:shutterSpeed>
映射: EXIF ExposureTime 字段

`<exif:iso>`

描述: ISO 感光度
格式: 整数
示例: <exif:iso>1000</exif:iso>
映射: EXIF ISOSpeedRatings 字段

`<exif:exposureCompensation>`

描述: 曝光补偿
格式: {±数值} EV
示例:

<exif:exposureCompensation>+0.7 EV</exif:exposureCompensation>
<exif:exposureCompensation>-1.3 EV</exif:exposureCompensation>
映射: EXIF ExposureBiasValue 字段

镜头参数 (lens)

`<exif:focalLength>`

描述: 实际焦距
格式: {数值}mm
示例: <exif:focalLength>50mm</exif:focalLength>
映射: EXIF FocalLength 字段

`<exif:focalLength35mm>`

描述: 等效35mm焦距
格式: {数值}mm
示例: <exif:focalLength35mm>75mm</exif:focalLength35mm>
映射: EXIF FocalLengthIn35mmFilm 字段

`<exif:lens>`

描述: 镜头型号
格式: CDATA 包装的字符串
示例: <exif:lens><![CDATA[BS-Optics FX 50mm F1.4]]></exif:lens>
映射: EXIF LensModel 字段

`<exif:maxAperture>`

描述: 镜头最大光圈
格式: f/{数值}
示例: <exif:maxAperture>f/1.4</exif:maxAperture>
映射: EXIF MaxApertureValue 字段

设备信息 (basic)

`<exif:camera>`

描述: 相机品牌和型号
格式: CDATA 包装的字符串
示例: <exif:camera><![CDATA[FUJIFILM X-T5]]></exif:camera>
映射: EXIF Make + Model 字段组合

图像属性 (basic)

`<exif:imageWidth>`

描述: 图像宽度（像素）
格式: 整数
示例: <exif:imageWidth>7728</exif:imageWidth>
映射: 来自图像处理系统的实际宽度

`<exif:imageHeight>`

描述: 图像高度（像素）
格式: 整数
示例: <exif:imageHeight>5152</exif:imageHeight>
映射: 来自图像处理系统的实际高度

`<exif:dateTaken>`

描述: 拍摄时间（原始时间戳）
格式: ISO 8601 格式
示例: <exif:dateTaken>2025-06-05T16:12:43.000Z</exif:dateTaken>
映射: EXIF DateTimeOriginal 字段

`<exif:orientation>`

描述: 图像方向格式: 整数 (1-8) 示例: <exif:orientation>1</exif:orientation> 映射: EXIF Orientation 字段

图片展示 (media)

`<enclosure>`

描述: 缩略图 URL 位置: <item> 元素内格式: 标准 RSS enclosure 元素示例: <enclosure url="https://example.com/thumbnails/photo.webp" type="image/webp" length="0" /> 说明:

url: 缩略图的完整 URL，支持相对路径转换为绝对路径
type: MIME 类型，根据文件扩展名自动判断（webp/png/jpeg）
length: 文件大小（字节），可设为 0 表示未知

技术参数 (technical)

`<exif:whiteBalance>`

描述: 白平衡设置
格式: 枚举值
示例: <exif:whiteBalance>Auto</exif:whiteBalance>
映射: EXIF WhiteBalance 字段
可选值: Auto, Daylight, Cloudy, Tungsten, Fluorescent, Flash, Manual

`<exif:meteringMode>`

描述: 测光模式
格式: 枚举值
示例: <exif:meteringMode>Matrix</exif:meteringMode>
映射: EXIF MeteringMode 字段
可选值: Matrix, Center-weighted, Spot, Multi-spot, Pattern

`<exif:flashMode>`

描述: 闪光灯模式
格式: 枚举值
示例: <exif:flashMode>Off</exif:flashMode>
映射: EXIF Flash 字段
可选值: Off, On, Auto, Red-eye, Fill, Slow-sync

`<exif:colorSpace>`

描述: 色彩空间
格式: 枚举值
示例: <exif:colorSpace>sRGB</exif:colorSpace>
映射: EXIF ColorSpace 字段
可选值: sRGB, Adobe RGB, ProPhoto RGB, DCI-P3

高级参数 (advanced)

`<exif:exposureProgram>`

描述: 曝光程序
格式: 枚举值
示例: <exif:exposureProgram>Aperture Priority</exif:exposureProgram>
映射: EXIF ExposureProgram 字段
可选值: Manual, Program, Aperture Priority, Shutter Priority, Creative, Action, Portrait, Landscape

`<exif:sceneMode>`

描述: 场景模式
格式: CDATA 包装的字符串
示例: <exif:sceneMode><![CDATA[Portrait]]></exif:sceneMode>
映射: EXIF SceneCaptureType 字段

`<exif:contrast>`

描述: 对比度设置
格式: 枚举值
示例: <exif:contrast>Normal</exif:contrast>
映射: EXIF Contrast 字段
可选值: Low, Normal, High

`<exif:saturation>`

描述: 饱和度设置
格式: 枚举值
示例: <exif:saturation>Normal</exif:saturation>
映射: EXIF Saturation 字段
可选值: Low, Normal, High

`<exif:sharpness>`

描述: 锐度设置
格式: 枚举值
示例: <exif:sharpness>Normal</exif:sharpness>
映射: EXIF Sharpness 字段
可选值: Soft, Normal, Hard

完整示例

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:exif="https://afilmory.art/rss/exif">
  <channel>
    <title><![CDATA[我的风景摄影画廊]]></title>
    <link>https://example.com</link>
    <description><![CDATA[分享我的风景摄影作品]]></description>

    <!-- 协议元数据 -->
    <exif:version>1.1</exif:version>
    <exif:protocol>afilmory-rss-exif</exif:protocol>
 
    
    <item>
      <title><![CDATA[夕阳下的城市]]></title>
      <link>https://example.com/photo123</link>
      <guid isPermaLink="true">https://example.com/photo123</guid>
      <description><![CDATA[城市天际线在夕阳下的美丽景象]]></description>
      <pubDate>Thu, 05 Jun 2025 16:12:43 GMT</pubDate>
      <category><![CDATA[风景]]></category>
      <category><![CDATA[城市]]></category>
      <enclosure url="https://example.com/thumbnails/photo123.webp" type="image/webp" length="1024000" />
      
      <!-- 基础 EXIF 数据 -->
      <exif:aperture>f/1.4</exif:aperture>
      <exif:shutterSpeed>1/250s</exif:shutterSpeed>
      <exif:iso>1000</exif:iso>
      <exif:exposureCompensation>0 EV</exif:exposureCompensation>
      <exif:imageWidth>7728</exif:imageWidth>
      <exif:imageHeight>5152</exif:imageHeight>
      <exif:dateTaken>2025-06-05T16:12:43.000Z</exif:dateTaken>
      <exif:camera><![CDATA[FUJIFILM X-T5]]></exif:camera>
      <exif:orientation>1</exif:orientation>
      
      <!-- 镜头信息 -->
      <exif:lens><![CDATA[BS-Optics FX 50mm F1.4]]></exif:lens>
      <exif:focalLength>50mm</exif:focalLength>
      <exif:focalLength35mm>75mm</exif:focalLength35mm>
      <exif:maxAperture>f/1.4</exif:maxAperture>

      <!-- 技术参数 -->
      <exif:whiteBalance>Auto</exif:whiteBalance>
      <exif:meteringMode>Matrix</exif:meteringMode>
      <exif:flashMode>Off</exif:flashMode>
      <exif:colorSpace>sRGB</exif:colorSpace>
    </item>
  </channel>
</rss>

兼容性和实现注意事项

向后兼容性

标准的 RSS 2.0 阅读器将忽略不识别的命名空间元素
核心 RSS 功能（标题、链接、描述等）保持完全兼容

可选字段

除协议版本和图片展类型外，所有 EXIF 标签都是可选的
如果某个 EXIF 数据不可用，应省略对应的标签而不是输出空值
实现者可以根据 supportedFields 声明选择性实现字段集

数据验证

实现者应验证 EXIF 数据的有效性
对于无效或缺失的数据，建议静默跳过而不是输出错误值
枚举类型字段应严格验证取值范围

性能考虑

EXIF 数据提取可能影响 RSS 生成性能
建议在构建时预处理 EXIF 数据而非实时提取
可根据 supportedFields 声明优化数据提取范围

字段集实现建议

basic 字段集适用于大多数基础应用
location 字段集需要考虑隐私保护
advanced 字段集适用于专业摄影应用
实现者可以自定义字段集组合

版本历史

v1.1 (2025-01-19): 扩展规范
- 添加协议版本号和标识符
- 定义图片展类型系统
- 引入EXIF字段集概念
- 扩充EXIF字段定义
- 添加位置信息、技术参数和高级参数字段集
v1.0 (2025-01-19): 初始规范发布
- 定义核心 EXIF 标签集合
- 建立命名空间约定
- 提供完整实现示例

许可证

本规范基于 Creative Commons Attribution 4.0 International License 发布。

9.5 KiB Raw Blame History Unescape Escape

Afilmory RSS EXIF Extension Specification

概述

协议版本

协议元数据

<exif:version>

<exif:protocol>

EXIF 标签定义

相机设置参数 (basic)

<exif:aperture>

<exif:shutterSpeed>

<exif:iso>

<exif:exposureCompensation>

镜头参数 (lens)

<exif:focalLength>

<exif:focalLength35mm>

<exif:lens>

<exif:maxAperture>