Module media 

媒体处理模块

提供图片、PDF、SVG 等媒体文件的处理功能

Structs

ImageCompressionConfig

图片压缩配置

ImageDimensions

图片尺寸信息

ImageResult

图片处理结果

PdfReadResult

PDF 读取结果

SvgRenderOptions

SVG 渲染选项

Enums

MediaCategory

媒体类别

MediaResult

媒体读取结果

MediaType

媒体文件类型

Constants

DEFAULT_SVG_DPI

默认 DPI

IMAGE_COMPRESSION_CONFIG

MAX_IMAGE_TOKENS

最大图片 token 数

PDF_MAX_SIZE

PDF 最大文件大小 (32MB)

Statics

BINARY_FILE_BLACKLIST

二进制文件黑名单 这些文件类型不应该被读取

PDF_EXTENSIONS

PDF 扩展名

SUPPORTED_IMAGE_FORMATS

支持的图片格式

Functions

detect_media_type

检测文件的媒体类型

estimate_image_dimensions

估算图片尺寸（基于文件大小和格式）

estimate_image_tokens

估算图片的 token 消耗

get_media_category

根据 MIME 类型获取媒体类别

get_mime_type_from_extension

从文件扩展名推断 MIME 类型

get_mime_type_sync

同步获取 MIME 类型（基于文件头 magic bytes）

get_svg_dimensions

获取 SVG 文件的原始尺寸

is_blacklisted_file

检查文件是否在黑名单中

is_pdf_extension

验证文件扩展名是否为 PDF

is_pdf_supported

检查是否支持 PDF

is_supported_image_format

检查是否为支持的图片格式

is_supported_media_file

检查文件是否为支持的媒体文件

is_svg_render_enabled

检查是否启用 SVG 渲染

read_image_file_enhanced

读取图片文件（增强版本，包含尺寸提取）

read_image_file_sync

读取图片文件（同步版本，不压缩）

read_pdf_file

读取 PDF 文件并返回 base64

read_svg_file

读取 SVG 文件内容

validate_image_file

验证图片文件

validate_pdf_file

验证 PDF 文件是否有效

validate_svg_file

验证 SVG 文件