axon-code 2.4.0

package/dist/media/image.js

@@ -0,0 +1,400 @@
+/**
+ * 图片处理模块
+ * 基于官方实现：Hw6 (主压缩入口), J39 (渐进缩放), j39 (PNG优化),
+ * D39 (中等JPEG), M39 (最终兜底), XE7 (token→bytes转换)
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { getMimeTypeSync } from './mime.js';
+// 动态加载 sharp
+let _sharp = null;
+let _sharpLoadAttempted = false;
+async function getSharp() {
+    if (!_sharpLoadAttempted) {
+        _sharpLoadAttempted = true;
+        try {
+            const mod = await import('sharp');
+            _sharp = mod.default;
+        }
+        catch (e) {
+            console.warn('[Image] sharp not available, image compression disabled:', e.message);
+        }
+    }
+    return _sharp;
+}
+/**
+ * 支持的图片格式
+ */
+export const SUPPORTED_IMAGE_FORMATS = new Set([
+    'png', 'jpg', 'jpeg', 'gif', 'webp'
+]);
+/**
+ * 最大图片 token 数
+ */
+export const MAX_IMAGE_TOKENS = 25000;
+/**
+ * Anthropic API 多图请求中单张图片的最大维度（像素）
+ */
+export const MAX_IMAGE_DIMENSION = 2000;
+/**
+ * 官方默认 maxBytes = 3932160 (Yh)
+ */
+const DEFAULT_MAX_BYTES = 3932160;
+/**
+ * 图片压缩配置 — 保留导出以保持 API 兼容
+ */
+export const IMAGE_COMPRESSION_CONFIG = {
+    maxWidth: 400,
+    maxHeight: 400,
+    quality: 20,
+    format: 'jpeg',
+};
+/**
+ * 检查是否为支持的图片格式
+ */
+export function isSupportedImageFormat(ext) {
+    const normalized = ext.toLowerCase().replace('.', '');
+    return SUPPORTED_IMAGE_FORMATS.has(normalized);
+}
+/**
+ * 创建压缩结果（对应官方 ex1）
+ */
+function makeCompressedResult(buffer, format, originalSize) {
+    const mediaType = format === 'jpg' ? 'jpeg' : format;
+    return {
+        base64: buffer.toString('base64'),
+        mediaType: `image/${mediaType}`,
+        originalSize,
+    };
+}
+/**
+ * 为指定格式应用最佳压缩参数（对应官方 X39）
+ */
+function applyFormatCompression(pipeline, format) {
+    switch (format) {
+        case 'png':
+            return pipeline.png({ compressionLevel: 9, palette: true });
+        case 'jpeg':
+        case 'jpg':
+            return pipeline.jpeg({ quality: 80 });
+        case 'webp':
+            return pipeline.webp({ quality: 80 });
+        default:
+            return pipeline;
+    }
+}
+/**
+ * 第一级：渐进缩放，保持原格式（对应官方 J39）
+ * 按 [100%, 75%, 50%, 25%] 逐级缩小
+ */
+async function tryProgressiveResize(ctx) {
+    const sharp = await getSharp();
+    if (!sharp)
+        return null;
+    const scales = [1, 0.75, 0.5, 0.25];
+    for (const scale of scales) {
+        const w = Math.round((ctx.metadata.width || 2000) * scale);
+        const h = Math.round((ctx.metadata.height || 2000) * scale);
+        let pipeline = sharp(ctx.imageBuffer).resize(w, h, {
+            fit: 'inside',
+            withoutEnlargement: true,
+        });
+        pipeline = applyFormatCompression(pipeline, ctx.format);
+        const buf = await pipeline.toBuffer();
+        if (buf.length <= ctx.maxBytes) {
+            return makeCompressedResult(buf, ctx.format, ctx.originalSize);
+        }
+    }
+    return null;
+}
+/**
+ * 第二级（仅 PNG）：800x800 + palette 64 色（对应官方 j39）
+ */
+async function tryPngOptimized(ctx) {
+    const sharp = await getSharp();
+    if (!sharp)
+        return null;
+    const buf = await sharp(ctx.imageBuffer)
+        .resize(800, 800, { fit: 'inside', withoutEnlargement: true })
+        .png({ compressionLevel: 9, palette: true, colors: 64 })
+        .toBuffer();
+    if (buf.length <= ctx.maxBytes) {
+        return makeCompressedResult(buf, 'png', ctx.originalSize);
+    }
+    return null;
+}
+/**
+ * 第三级：600x600 JPEG（对应官方 D39）
+ */
+async function tryMediumJpeg(ctx, quality) {
+    const sharp = await getSharp();
+    if (!sharp)
+        return null;
+    const buf = await sharp(ctx.imageBuffer)
+        .resize(600, 600, { fit: 'inside', withoutEnlargement: true })
+        .jpeg({ quality })
+        .toBuffer();
+    if (buf.length <= ctx.maxBytes) {
+        return makeCompressedResult(buf, 'jpeg', ctx.originalSize);
+    }
+    return null;
+}
+/**
+ * 第四级（兜底）：400x400 JPEG quality 20（对应官方 M39）
+ */
+async function fallbackCompress(ctx) {
+    const sharp = await getSharp();
+    if (!sharp)
+        return makeCompressedResult(ctx.imageBuffer, ctx.format, ctx.originalSize);
+    const buf = await sharp(ctx.imageBuffer)
+        .resize(400, 400, { fit: 'inside', withoutEnlargement: true })
+        .jpeg({ quality: 20 })
+        .toBuffer();
+    return makeCompressedResult(buf, 'jpeg', ctx.originalSize);
+}
+/**
+ * 检测 buffer 的图片格式
+ */
+function detectMediaType(buffer) {
+    const mime = getMimeTypeSync(buffer);
+    if (mime) {
+        const sub = mime.split('/')[1];
+        if (sub)
+            return sub;
+    }
+    return 'png';
+}
+/**
+ * 主压缩函数（对应官方 Hw6）
+ * 多级渐进压缩：渐进缩放 → PNG优化 → 中等JPEG → 兜底JPEG
+ */
+async function compressBuffer(imageBuffer, maxBytes) {
+    const sharpFn = await getSharp();
+    let metadata = {};
+    let format;
+    if (sharpFn) {
+        const meta = await sharpFn(imageBuffer).metadata();
+        format = meta.format || detectMediaType(imageBuffer);
+        metadata = meta;
+    }
+    else {
+        format = detectMediaType(imageBuffer);
+    }
+    const originalSize = imageBuffer.length;
+    // 已经足够小
+    if (originalSize <= maxBytes) {
+        return makeCompressedResult(imageBuffer, format, originalSize);
+    }
+    const ctx = { imageBuffer, metadata, format, maxBytes, originalSize };
+    // 1. 渐进缩放，保持原格式
+    const r1 = await tryProgressiveResize(ctx);
+    if (r1)
+        return r1;
+    // 2. PNG 特殊优化
+    if (format === 'png') {
+        const r2 = await tryPngOptimized(ctx);
+        if (r2)
+            return r2;
+    }
+    // 3. 中等 JPEG（600x600, quality 50）
+    const r3 = await tryMediumJpeg(ctx, 50);
+    if (r3)
+        return r3;
+    // 4. 兜底（400x400, quality 20）
+    return await fallbackCompress(ctx);
+}
+/**
+ * 从 token 限制计算 maxBytes（对应官方 XE7）
+ * maxBase64Length = maxTokens / 0.125
+ * maxBytes = maxBase64Length * 0.75 (base64 编码膨胀率)
+ */
+function tokensToMaxBytes(maxTokens) {
+    const maxBase64Length = Math.floor(maxTokens / 0.125);
+    return Math.floor(maxBase64Length * 0.75);
+}
+/**
+ * 创建 ImageResult 对象
+ */
+function createImageResult(buffer, mediaType, originalSize, dimensions) {
+    return {
+        type: 'image',
+        file: {
+            base64: buffer.toString('base64'),
+            type: mediaType,
+            originalSize,
+            dimensions,
+        },
+    };
+}
+/**
+ * 读取图片文件（主入口）
+ */
+export async function readImageFile(filePath, maxTokens = MAX_IMAGE_TOKENS, ext) {
+    const fileExt = ext || path.extname(filePath).toLowerCase().slice(1) || 'png';
+    const stat = fs.statSync(filePath);
+    if (stat.size === 0) {
+        throw new Error(`Image file is empty: ${filePath}`);
+    }
+    const buffer = fs.readFileSync(filePath);
+    const format = detectMediaType(buffer) || fileExt;
+    // 估算 token
+    const base64Len = Math.ceil(buffer.length * 4 / 3); // base64 膨胀
+    const estimatedTokens = Math.ceil(base64Len * 0.125);
+    if (estimatedTokens <= maxTokens) {
+        // 不需要压缩，提取尺寸信息直接返回
+        try {
+            const sharpFn = await getSharp();
+            if (!sharpFn) {
+                return createImageResult(buffer, `image/${format}`, stat.size);
+            }
+            const metadata = await sharpFn(buffer).metadata();
+            return createImageResult(buffer, `image/${format}`, stat.size, {
+                originalWidth: metadata.width,
+                originalHeight: metadata.height,
+                displayWidth: metadata.width,
+                displayHeight: metadata.height,
+            });
+        }
+        catch {
+            return createImageResult(buffer, `image/${format}`, stat.size);
+        }
+    }
+    // 需要压缩
+    const maxBytes = tokensToMaxBytes(maxTokens);
+    const compressed = await compressBuffer(buffer, maxBytes);
+    return {
+        type: 'image',
+        file: {
+            base64: compressed.base64,
+            type: compressed.mediaType,
+            originalSize: stat.size,
+        },
+    };
+}
+/**
+ * 同步读取图片（基础版本，不压缩）
+ */
+export function readImageFileSync(filePath) {
+    const stat = fs.statSync(filePath);
+    if (stat.size === 0) {
+        throw new Error(`Image file is empty: ${filePath}`);
+    }
+    const buffer = fs.readFileSync(filePath);
+    const ext = path.extname(filePath).toLowerCase().slice(1) || 'png';
+    const mimeType = getMimeTypeSync(buffer) || `image/${ext}`;
+    return createImageResult(buffer, mimeType, stat.size);
+}
+/**
+ * 估算图片的 token 消耗
+ */
+export function estimateImageTokens(base64) {
+    return Math.ceil(base64.length * 0.125);
+}
+/**
+ * 压缩 Base64 图片数据（带 data URI 前缀）
+ */
+export async function compressBase64Image(base64Data, maxTokens = MAX_IMAGE_TOKENS) {
+    let pureBase64 = base64Data;
+    let originalMediaType = 'image/png';
+    if (base64Data.startsWith('data:')) {
+        const matches = base64Data.match(/^data:(image\/\w+);base64,(.+)$/);
+        if (matches) {
+            originalMediaType = matches[1];
+            pureBase64 = matches[2];
+        }
+    }
+    const estimatedTokens = Math.ceil(pureBase64.length * 0.125);
+    if (estimatedTokens <= maxTokens) {
+        return base64Data.startsWith('data:')
+            ? base64Data
+            : `data:${originalMediaType};base64,${pureBase64}`;
+    }
+    try {
+        const buffer = Buffer.from(pureBase64, 'base64');
+        const maxBytes = tokensToMaxBytes(maxTokens);
+        const result = await compressBuffer(buffer, maxBytes);
+        return `data:${result.mediaType};base64,${result.base64}`;
+    }
+    catch (error) {
+        console.error('[ImageCompression] Compression failed, returning original data:', error);
+        return base64Data.startsWith('data:')
+            ? base64Data
+            : `data:${originalMediaType};base64,${pureBase64}`;
+    }
+}
+/**
+ * 确保 base64 图片的维度不超过 MAX_IMAGE_DIMENSION (2000px)
+ * Anthropic API 多图请求要求每张图片任意维度不超过此值
+ */
+export async function ensureMaxDimensions(base64Data, mediaType, maxDim = MAX_IMAGE_DIMENSION) {
+    const sharp = await getSharp();
+    if (!sharp)
+        return { data: base64Data, mediaType };
+    try {
+        const buffer = Buffer.from(base64Data, 'base64');
+        const metadata = await sharp(buffer).metadata();
+        const w = metadata.width || 0;
+        const h = metadata.height || 0;
+        if (w <= maxDim && h <= maxDim) {
+            return { data: base64Data, mediaType };
+        }
+        // 缩放到 maxDim 以内，保持原格式
+        const format = metadata.format || 'png';
+        let pipeline = sharp(buffer).resize(maxDim, maxDim, { fit: 'inside', withoutEnlargement: true });
+        pipeline = applyFormatCompression(pipeline, format);
+        const resized = await pipeline.toBuffer();
+        const outMediaType = format === 'jpg' ? 'image/jpeg' : `image/${format}`;
+        return { data: resized.toString('base64'), mediaType: outMediaType };
+    }
+    catch {
+        return { data: base64Data, mediaType };
+    }
+}
+/**
+ * 压缩纯 base64 图片数据（不带 data URI 前缀）
+ * 同时确保维度不超过 MAX_IMAGE_DIMENSION
+ */
+export async function compressRawBase64(base64Data, mediaType, maxTokens = MAX_IMAGE_TOKENS) {
+    // 先确保维度不超限
+    const dimChecked = await ensureMaxDimensions(base64Data, mediaType);
+    const estimatedTokens = Math.ceil(dimChecked.data.length * 0.125);
+    if (estimatedTokens <= maxTokens) {
+        return dimChecked;
+    }
+    try {
+        const buffer = Buffer.from(dimChecked.data, 'base64');
+        const maxBytes = tokensToMaxBytes(maxTokens);
+        const result = await compressBuffer(buffer, maxBytes);
+        return { data: result.base64, mediaType: result.mediaType };
+    }
+    catch (error) {
+        console.error('[ImageCompression] Attachment compression failed, using original data:', error);
+        return dimChecked;
+    }
+}
+/**
+ * 验证图片文件
+ */
+export function validateImageFile(filePath) {
+    try {
+        if (!fs.existsSync(filePath)) {
+            return { valid: false, error: 'File does not exist' };
+        }
+        const stat = fs.statSync(filePath);
+        if (stat.size === 0) {
+            return { valid: false, error: 'Image file is empty' };
+        }
+        const ext = path.extname(filePath).toLowerCase().slice(1);
+        if (!isSupportedImageFormat(ext)) {
+            return {
+                valid: false,
+                error: `Unsupported image format: ${ext}. Supported formats: ${Array.from(SUPPORTED_IMAGE_FORMATS).join(', ')}`
+            };
+        }
+        return { valid: true };
+    }
+    catch (error) {
+        return { valid: false, error: `Validation error: ${error}` };
+    }
+}
+//# sourceMappingURL=image.js.map

package/dist/media/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/media/image.ts"],"names":[],"mappings":"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"}

package/dist/media/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 媒体处理模块统一导出
+ * 提供图片、PDF、SVG 等媒体文件的处理功能
+ *
+ * 基于 Anthropic 官方 CLI 的实现
+ * - 图片处理：CP3, zP3, BQ0 函数
+ * - PDF 处理：XzB 函数
+ * - SVG 渲染：增强功能（官方未实现）
+ */
+export { getMimeType, getMimeTypeSync, getMediaType, getMimeTypeFromExtension, } from './mime.js';
+export { PDF_MAX_SIZE, PDF_EXTENSIONS, PDF_MAX_PAGES_PER_REQUEST, PDF_LARGE_THRESHOLD, isPdfSupported, isPdfExtension, readPdfFile, readPdfFileSync, validatePdfFile, parsePageRange, getPdfPageCount, extractPdfPages, formatBytes, type PdfReadResult, type PdfPartsResult, type PageRange, } from './pdf.js';
+export { SUPPORTED_IMAGE_FORMATS, MAX_IMAGE_TOKENS, IMAGE_COMPRESSION_CONFIG, isSupportedImageFormat, readImageFile, readImageFileSync, estimateImageTokens, validateImageFile, type ImageDimensions, type ImageResult, } from './image.js';
+export { OFFICE_EXTENSIONS, DOCUMENT_EXTENSIONS, isOfficeFile, isDocumentFile, documentToHtml, documentToText, getSearchableText, editDocument, clearDocumentCache, type EditDocumentResult, } from './office.js';
+export { isSvgRenderEnabled, renderSvgToPng, renderSvgStringToPng, validateSvgFile, getSvgDimensions, type SvgRenderOptions, } from './svg.js';
+import { type ImageResult } from './image.js';
+import { type PdfReadResult } from './pdf.js';
+/**
+ * 媒体文件类型
+ */
+export type MediaType = 'image' | 'pdf' | 'svg' | 'unknown';
+/**
+ * 媒体读取结果
+ */
+export type MediaResult = ImageResult | PdfReadResult;
+/**
+ * 检测文件的媒体类型
+ */
+export declare function detectMediaType(filePath: string): MediaType;
+/**
+ * 统一的媒体文件读取函数
+ * 根据文件类型自动选择合适的处理方式
+ *
+ * @param filePath 文件路径
+ * @param options 可选配置
+ * @returns 媒体处理结果
+ */
+export declare function readMediaFile(filePath: string, options?: {
+    maxTokens?: number;
+    renderSvg?: boolean;
+    svgOptions?: any;
+}): Promise<MediaResult>;
+/**
+ * 检查文件是否为支持的媒体文件
+ */
+export declare function isSupportedMediaFile(filePath: string): boolean;
+/**
+ * 获取媒体处理统计信息
+ */
+export interface MediaStats {
+    totalImages: number;
+    totalPdfs: number;
+    totalSvgs: number;
+    totalSize: number;
+    supportedFormats: string[];
+}
+export declare function getMediaStats(): MediaStats;
+/**
+ * 二进制文件黑名单（对应官方的 VP3）
+ * 这些文件类型不应该被读取
+ */
+export declare const BINARY_FILE_BLACKLIST: Set<string>;
+/**
+ * 检查文件是否在黑名单中
+ */
+export declare function isBlacklistedFile(filePath: string): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/media/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,wBAAwB,GACzB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,WAAW,EACX,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,eAAe,EACf,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,UAAU,CAAC;AAMlB,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAA+C,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAG3F;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;AAEtD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAgB3D;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,GAAG,CAAC;CACb,GACL,OAAO,CAAC,WAAW,CAAC,CAsBtB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAgB,aAAa,IAAI,UAAU,CAY1C;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,aA4BhC,CAAC;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG3D"}

package/dist/media/index.js

@@ -0,0 +1,122 @@
+/**
+ * 媒体处理模块统一导出
+ * 提供图片、PDF、SVG 等媒体文件的处理功能
+ *
+ * 基于 Anthropic 官方 CLI 的实现
+ * - 图片处理：CP3, zP3, BQ0 函数
+ * - PDF 处理：XzB 函数
+ * - SVG 渲染：增强功能（官方未实现）
+ */
+// MIME 类型检测
+export { getMimeType, getMimeTypeSync, getMediaType, getMimeTypeFromExtension, } from './mime.js';
+// PDF 处理
+export { PDF_MAX_SIZE, PDF_EXTENSIONS, PDF_MAX_PAGES_PER_REQUEST, PDF_LARGE_THRESHOLD, isPdfSupported, isPdfExtension, readPdfFile, readPdfFileSync, validatePdfFile, parsePageRange, getPdfPageCount, extractPdfPages, formatBytes, } from './pdf.js';
+// 图片处理
+export { SUPPORTED_IMAGE_FORMATS, MAX_IMAGE_TOKENS, IMAGE_COMPRESSION_CONFIG, isSupportedImageFormat, readImageFile, readImageFileSync, estimateImageTokens, validateImageFile, } from './image.js';
+// Office 文档处理
+export { OFFICE_EXTENSIONS, DOCUMENT_EXTENSIONS, isOfficeFile, isDocumentFile, documentToHtml, documentToText, getSearchableText, editDocument, clearDocumentCache, } from './office.js';
+// SVG 渲染
+export { isSvgRenderEnabled, renderSvgToPng, renderSvgStringToPng, validateSvgFile, getSvgDimensions, } from './svg.js';
+/**
+ * 统一的媒体文件读取接口
+ */
+import * as path from 'path';
+import { readImageFile, isSupportedImageFormat } from './image.js';
+import { readPdfFile, isPdfExtension, isPdfSupported } from './pdf.js';
+import { renderSvgToPng, isSvgRenderEnabled } from './svg.js';
+/**
+ * 检测文件的媒体类型
+ */
+export function detectMediaType(filePath) {
+    const ext = path.extname(filePath).toLowerCase().slice(1);
+    if (isSupportedImageFormat(ext)) {
+        return 'image';
+    }
+    if (isPdfExtension(ext)) {
+        return 'pdf';
+    }
+    if (ext === 'svg') {
+        return 'svg';
+    }
+    return 'unknown';
+}
+/**
+ * 统一的媒体文件读取函数
+ * 根据文件类型自动选择合适的处理方式
+ *
+ * @param filePath 文件路径
+ * @param options 可选配置
+ * @returns 媒体处理结果
+ */
+export async function readMediaFile(filePath, options = {}) {
+    const mediaType = detectMediaType(filePath);
+    switch (mediaType) {
+        case 'image':
+            return await readImageFile(filePath, options.maxTokens);
+        case 'pdf':
+            if (!isPdfSupported()) {
+                throw new Error('PDF support is not enabled');
+            }
+            return await readPdfFile(filePath);
+        case 'svg':
+            if (options.renderSvg && isSvgRenderEnabled()) {
+                return await renderSvgToPng(filePath, options.svgOptions);
+            }
+            throw new Error('SVG rendering is not enabled or not requested');
+        default:
+            throw new Error(`Unsupported media type for file: ${filePath}`);
+    }
+}
+/**
+ * 检查文件是否为支持的媒体文件
+ */
+export function isSupportedMediaFile(filePath) {
+    const mediaType = detectMediaType(filePath);
+    return mediaType !== 'unknown';
+}
+export function getMediaStats() {
+    return {
+        totalImages: 0,
+        totalPdfs: 0,
+        totalSvgs: 0,
+        totalSize: 0,
+        supportedFormats: [
+            'png', 'jpg', 'jpeg', 'gif', 'webp', // Image formats
+            'pdf', // PDF format
+            'svg', // SVG format
+        ],
+    };
+}
+/**
+ * 二进制文件黑名单（对应官方的 VP3）
+ * 这些文件类型不应该被读取
+ */
+export const BINARY_FILE_BLACKLIST = new Set([
+    // 音频格式
+    'mp3', 'wav', 'flac', 'ogg', 'aac', 'm4a', 'wma', 'aiff', 'opus',
+    // 视频格式
+    'mp4', 'avi', 'mov', 'wmv', 'flv', 'mkv', 'webm', 'm4v', 'mpeg', 'mpg',
+    // 压缩文件
+    'zip', 'rar', 'tar', 'gz', 'bz2', '7z', 'xz', 'z', 'tgz', 'iso',
+    // 可执行文件
+    'exe', 'dll', 'so', 'dylib', 'app', 'msi', 'deb', 'rpm', 'bin',
+    // 数据库文件
+    'dat', 'db', 'sqlite', 'sqlite3', 'mdb', 'idx',
+    // Office 文档（旧格式，不支持解析）
+    'doc', 'xls', 'ppt', 'odt', 'ods', 'odp',
+    // 注意：docx/xlsx/pptx 已移出黑名单，由 office.ts 模块处理
+    // 字体文件
+    'ttf', 'otf', 'woff', 'woff2', 'eot',
+    // 设计文件
+    'psd', 'ai', 'eps', 'sketch', 'fig', 'xd', 'blend', 'obj', '3ds', 'max',
+    // 编译文件
+    'class', 'jar', 'war', 'pyc', 'pyo', 'rlib', 'swf', 'fla',
+]);
+/**
+ * 检查文件是否在黑名单中
+ */
+export function isBlacklistedFile(filePath) {
+    const ext = path.extname(filePath).toLowerCase().slice(1);
+    return BINARY_FILE_BLACKLIST.has(ext);
+}
+//# sourceMappingURL=index.js.map

package/dist/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"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"}

package/dist/media/mime.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MIME 类型检测模块
+ * 基于官方实现 (cli.js 行495附近的 BA1 函数)
+ */
+/**
+ * 获取文件的 MIME 类型 (异步版本)
+ * 使用 file-type 库进行准确检测
+ */
+export declare function getMimeType(buffer: Buffer): Promise<string | null>;
+/**
+ * 同步获取 MIME 类型（基于文件头 magic bytes）
+ * 对应官方的 BA1 函数
+ */
+export declare function getMimeTypeSync(buffer: Buffer): string | null;
+/**
+ * 根据 MIME 类型获取媒体类型
+ */
+export declare function getMediaType(mimeType: string): 'image' | 'pdf' | 'video' | 'audio' | 'unknown';
+/**
+ * 从文件扩展名推断 MIME 类型
+ */
+export declare function getMimeTypeFromExtension(ext: string): string;
+//# sourceMappingURL=mime.d.ts.map

package/dist/media/mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../../src/media/mime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6C7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAc9F;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA6B5D"}