dsh-convert-core 0.1.0-alpha.1

package/lib/adapters/anydoc.js

@@ -0,0 +1,295 @@
+/**
+ * The document engine: `@firecrawl/anydoc` (MIT, Rust, prebuilt Node binding).
+ *
+ * One adapter replaces what used to be five (pdfjs text-layer reader, mammoth,
+ * the high-quality docling tier, plus the format routing between them). anydoc
+ * covers doc/docx/docm, ppt/pps/pot/pptx/pptm/ppsx/ppsm, xls/xlsx/xlsm/xlsb,
+ * odt/ods/odp, rtf, epub, csv and text-layer pdf, detects the format from the
+ * bytes, and needs no Python, no models and no external binary.
+ *
+ * The one thing it cannot do for us is the 0013 image contract: Markdown has no
+ * way to embed bytes, so an embedded image renders as its alt text while the
+ * bytes stay on `document.assets`. Retrieval only reads local relative image
+ * paths, so this adapter re-materialises every embedded image into `assets/`
+ * and puts a real `![](assets/img-…)` reference back where the document had it.
+ */
+import { createRequire } from 'node:module';
+import { readFile } from 'node:fs/promises';
+import { basename, extname } from 'node:path';
+import { sha1, sha256 } from '../markdown.js';
+import { AdapterError } from './types.js';
+export const ANYDOC_EXTENSIONS = [
+    // Word
+    '.doc', '.docx', '.docm',
+    // PowerPoint
+    '.ppt', '.pps', '.pot', '.pptx', '.pptm', '.ppsx', '.ppsm',
+    // Excel
+    '.xls', '.xlsx', '.xlsm', '.xlsb',
+    // OpenDocument
+    '.odt', '.ods', '.odp',
+    // Other containers anydoc reads
+    '.rtf', '.epub', '.csv', '.pdf',
+];
+const MEDIA_EXTENSIONS = {
+    'image/png': 'png',
+    'image/jpeg': 'jpg',
+    'image/jpg': 'jpg',
+    'image/gif': 'gif',
+    'image/webp': 'webp',
+    'image/tiff': 'tiff',
+    'image/bmp': 'bmp',
+    'image/svg+xml': 'svg',
+    'image/avif': 'avif',
+    'image/heic': 'heic',
+};
+let modulePromise;
+let moduleVersion;
+let moduleError;
+/** Load the binding once; the platform binary ships as an optional dependency. */
+export async function loadAnydoc() {
+    if (!modulePromise) {
+        modulePromise = (async () => {
+            const loaded = (await import('@firecrawl/anydoc'));
+            const candidate = typeof loaded.toMarkdown === 'function' ? loaded : loaded.default;
+            if (!candidate || typeof candidate.toMarkdown !== 'function')
+                throw new Error('找不到 toMarkdown 导出');
+            try {
+                const require = createRequire(import.meta.url);
+                const pkg = JSON.parse(await readFile(require.resolve('@firecrawl/anydoc/package.json'), 'utf8'));
+                moduleVersion = pkg.version;
+            }
+            catch {
+                /* version is cosmetic */
+            }
+            return candidate;
+        })().catch(error => {
+            moduleError = error instanceof Error ? error.message : String(error);
+            modulePromise = undefined;
+            throw error;
+        });
+    }
+    return await modulePromise;
+}
+export async function anydocAvailability() {
+    try {
+        await loadAnydoc();
+        return { available: true, ...(moduleVersion ? { versions: { '@firecrawl/anydoc': moduleVersion } } : {}) };
+    }
+    catch (cause) {
+        return {
+            available: false,
+            reason: `无法加载 @firecrawl/anydoc：${moduleError ?? (cause instanceof Error ? cause.message : String(cause))}`,
+            suggestion: '在 packages/dsh-convert-core 目录执行 pnpm install；Apple Silicon 需要 @firecrawl/anydoc-darwin-arm64（随 optionalDependencies 自动安装）。',
+        };
+    }
+}
+function extensionFor(asset) {
+    const mediaType = asset.mediaType?.split(';')[0]?.trim().toLowerCase();
+    if (mediaType && MEDIA_EXTENSIONS[mediaType])
+        return MEDIA_EXTENSIONS[mediaType];
+    const fromPart = asset.originPart ? /\.([a-zA-Z0-9]{2,5})$/.exec(asset.originPart)?.[1]?.toLowerCase() : undefined;
+    if (fromPart && fromPart !== 'bin')
+        return fromPart;
+    return undefined;
+}
+/** In document order, every inline image that points at an embedded asset. */
+function collectEmbeddedImages(document) {
+    const found = [];
+    for (const block of document.blocks ?? []) {
+        for (const inline of block.content ?? []) {
+            if (inline.kind !== 'image')
+                continue;
+            const source = inline.source;
+            if (!source || source.kind !== 'asset' || typeof source.assetId !== 'number')
+                continue;
+            const asset = document.assets?.[source.assetId];
+            if (!asset)
+                continue;
+            found.push({ assetId: source.assetId, alt: (inline.alt ?? '').trim(), asset });
+        }
+    }
+    return found;
+}
+/**
+ * Put real image references back into the Markdown.
+ *
+ * anydoc renders an embedded image as its alt text, so placement is a match on
+ * that text. A standalone-line match is used only when it is unambiguous;
+ * anything that cannot be located is appended under a `## 图片` heading rather
+ * than guessed at, and the count is reported.
+ */
+export function placeImageReferences(markdown, images) {
+    const lines = markdown.split('\n');
+    const consumed = new Set();
+    const remaining = [];
+    const warnings = [];
+    for (const image of images) {
+        const alt = image.alt.trim();
+        let index = -1;
+        if (alt) {
+            // Only accept a line that is exactly the alt text, and only once.
+            const candidates = lines
+                .map((line, position) => (line.trim() === alt && !consumed.has(position) ? position : -1))
+                .filter(position => position >= 0);
+            if (candidates.length === 1)
+                index = candidates[0];
+        }
+        if (index >= 0) {
+            consumed.add(index);
+            lines[index] = `![${alt}](${image.rel})`;
+            continue;
+        }
+        remaining.push(image);
+    }
+    let output = lines.join('\n');
+    if (remaining.length > 0) {
+        const section = remaining.map(image => `![${image.alt || basename(image.rel)}](${image.rel})`).join('\n\n');
+        output = `${output.trimEnd()}\n\n## 图片\n\n${section}\n`;
+        warnings.push(`${remaining.length} 张内嵌图片在正文中没有可定位的占位（无 alt 文本或 alt 不唯一），已追加到文末「图片」小节。`);
+    }
+    return { markdown: output, placed: images.length - remaining.length, appended: remaining.length, warnings };
+}
+function sourceFormatFor(anydocFormat, filename) {
+    const format = anydocFormat ?? extname(filename).replace('.', '').toLowerCase();
+    if (format === 'pdf')
+        return 'pdf';
+    if (format === 'csv')
+        return 'text';
+    return 'office';
+}
+/** anydoc's error codes are already precise; keep them instead of flattening. */
+const ANYDOC_SUGGESTIONS = {
+    needsOcr: '该 PDF 是扫描件/纯图片页，anydoc 本地不做 OCR（它只覆盖文本层 PDF）。走扫描档：把 adapter 指定为 "scanned"，' +
+        '或设环境变量 SCANNED_OCR=1 让 .pdf 直接走它 —— 扫描档用 pypdfium2 渲染页图 + 本地 RapidOCR 识别文字，不出网，' +
+        '但不做版面还原；需要版面/表格/公式时见 issues/0017 的可选高质量档。' +
+        '不要使用 anydoc 的 ocr:"hosted"：它会把整份文档发往 Firecrawl Parse 云端，与 0015 的本地优先原则冲突。',
+    encrypted: '文档有密码保护，请先去掉密码再转换。',
+    unsupported: '该格式不在本版范围内（doc/docx/ppt/pptx/xls/xlsx/odt/ods/odp/rtf/epub/csv/文本层 PDF）。',
+    malformed: '文件结构损坏，无法提取有意义的内容。',
+    resourceLimit: '文件触发了 anydoc 的解压/嵌套安全上限，可能是文档炸弹或异常嵌套。',
+    missingPart: '文档缺少必需的结构部件（可能被截断或由非标准工具生成）。',
+};
+function toAdapterError(cause) {
+    const error = cause;
+    const code = typeof error?.code === 'string' ? error.code : undefined;
+    if (code && code !== 'io') {
+        const pages = Array.isArray(error.pages) && error.pages.length > 0 ? `（第 ${error.pages.slice(0, 8).join(', ')} 页）` : '';
+        return new AdapterError(`ANYDOC_${code.replace(/([a-z])([A-Z])/g, '$1_$2').toUpperCase()}`, `${error.message || code}${pages}`, ANYDOC_SUGGESTIONS[code]);
+    }
+    return new AdapterError('ANYDOC_FAILED', error instanceof Error ? error.message : String(cause), ANYDOC_SUGGESTIONS.malformed);
+}
+async function run(context) {
+    const sourcePath = context.inputPath;
+    if (!sourcePath)
+        throw new AdapterError('INPUT_REQUIRED', '文档适配器需要文件路径。');
+    const anydoc = await loadAnydoc().catch(cause => {
+        throw new AdapterError('DEPENDENCY_MISSING', `无法加载 @firecrawl/anydoc：${cause instanceof Error ? cause.message : String(cause)}`, '在 packages/dsh-convert-core 目录执行 pnpm install。');
+    });
+    const filename = context.filename || basename(sourcePath);
+    const bytes = await readFile(sourcePath);
+    context.report(0.15, 'detect', '识别文档格式');
+    let detected = null;
+    try {
+        detected = anydoc.formatFromBytes(new Uint8Array(bytes));
+    }
+    catch {
+        detected = null;
+    }
+    context.report(0.35, 'convert', `解析 ${detected ?? extname(filename)}`);
+    let markdown;
+    let document = {};
+    const assetNote = [];
+    try {
+        markdown = await anydoc.toMarkdown(sourcePath);
+    }
+    catch (cause) {
+        throw toAdapterError(cause);
+    }
+    // `toDocument` covers the OOXML / OpenDocument / RTF / EPUB / CSV family. PDF
+    // renders straight to Markdown through pdf-inspector and *rejects* the
+    // document model, so a PDF simply has no embedded assets to place.
+    if (detected !== 'pdf') {
+        try {
+            document = await anydoc.toDocument(new Uint8Array(bytes));
+        }
+        catch (cause) {
+            const error = cause;
+            // Never lose a good Markdown because the asset model was unavailable.
+            assetNote.push(`内嵌资源枚举失败（${error?.code ?? 'unknown'}: ${error?.message ?? String(cause)}），本次只交付 Markdown，未落地图片。`);
+        }
+    }
+    if (!markdown.trim()) {
+        throw new AdapterError('CONTENT_REQUIRED', '文档解析后没有内容（可能全为图片或受保护内容）。');
+    }
+    // ---- asset glue: bytes live on the document model, not in the Markdown ----
+    const embedded = collectEmbeddedImages(document);
+    const images = [];
+    const assets = [];
+    const warnings = [];
+    let skippedObjects = 0;
+    for (const entry of embedded) {
+        const data = entry.asset.data ? Buffer.from(entry.asset.data) : undefined;
+        if (!data || data.length === 0) {
+            skippedObjects += 1;
+            continue;
+        }
+        if (!entry.asset.mediaType?.startsWith('image/')) {
+            // 0013 only consumes images; other embedded objects are reported, not dropped.
+            skippedObjects += 1;
+            continue;
+        }
+        const extension = extensionFor(entry.asset);
+        if (!extension) {
+            skippedObjects += 1;
+            continue;
+        }
+        const digest = sha1(data);
+        const rel = `assets/img-${digest.slice(0, 12)}.${extension}`;
+        images.push({ rel, alt: entry.alt });
+        assets.push({
+            rel,
+            data,
+            ...(entry.asset.mediaType ? { contentType: entry.asset.mediaType } : {}),
+        });
+    }
+    const placement = placeImageReferences(markdown, images);
+    for (const note of assetNote)
+        warnings.push({ code: 'ASSET_ENUMERATION_FAILED', message: note });
+    if (placement.appended > 0) {
+        warnings.push({ code: 'IMAGES_APPENDED', message: placement.warnings[0] });
+    }
+    if (skippedObjects > 0) {
+        warnings.push({
+            code: 'EMBEDDED_OBJECTS_SKIPPED',
+            message: `文档里有 ${skippedObjects} 个内嵌对象不是可落地的图片（非 image/* 或缺少字节），未写入 assets/。`,
+        });
+    }
+    if (embedded.length > 0) {
+        warnings.push({
+            code: 'IMAGES_LOCALIZED',
+            message: `内嵌图片 ${embedded.length} 张已落地为本地 assets/ 并改写正文引用（${placement.placed} 张原位、${placement.appended} 张追加）。`,
+        });
+    }
+    const heading = /^#{1,6}\s+(.+)$/m.exec(placement.markdown)?.[1]?.trim();
+    return {
+        title: (context.request.title?.trim() || heading || basename(filename, extname(filename))).slice(0, 300),
+        markdown: placement.markdown.trim(),
+        sourceFormat: sourceFormatFor(detected, filename),
+        parser: `anydoc@${moduleVersion ?? 'unknown'}/${detected ?? 'unknown'}`,
+        sourcePath,
+        warnings,
+        dependencyVersions: { '@firecrawl/anydoc': moduleVersion ?? 'unknown' },
+        externalId: `sha256:${sha256(bytes)}`,
+        assets,
+    };
+}
+export const anydocAdapter = {
+    id: 'anydoc',
+    description: 'DOC/DOCX/PPT/PPTX/XLS/XLSX/ODT/ODS/ODP/RTF/EPUB/CSV/文本层 PDF → GFM Markdown（Rust 内核，无模型、无外部二进制；内嵌图片落地到 assets/）',
+    kinds: ['file'],
+    extensions: ANYDOC_EXTENSIONS,
+    availability: () => ({ available: true, ...(moduleVersion ? { versions: { '@firecrawl/anydoc': moduleVersion } } : {}) }),
+    probe: anydocAvailability,
+    run,
+};
+//# sourceMappingURL=anydoc.js.map

package/lib/adapters/anydoc.js.map

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

package/lib/adapters/iddoc.d.ts

@@ -0,0 +1,28 @@
+/**
+ * iddoc —— 音视频 / 图片 adapter(issue 0017 的 video 档)。
+ *
+ * 这个文件**只做契约映射**:能力全在同包的 `src/media/` 里(纯本地管线:
+ * ffmpeg 抽帧 + 可选的字幕/转写 + 可选的画面 OCR),这里负责
+ *
+ *   1. 把内核的 `AdapterContext` 翻译成该包的 options(**含 env 旋钮**);
+ *   2. 把 `MediaToMarkdownResult` 映射成 `AdapterOutput`(assets 交给内核写盘);
+ *   3. 把它抛出的错误原样转成 `AdapterError`,保留 `code` 与可操作建议。
+ *
+ * 与文档档(anydoc)一样:引擎独立于 adapter,内核只管契约。
+ *
+ * 环境变量(都是**显式**开关,默认不下载模型、不对图片做 OCR):
+ *   IDDOC_ASR=1              允许在无字幕时下载模型并本地转写
+ *   IDDOC_ASR_MODEL          whisper 模型(默认 small;中文建议 large-v3-turbo)
+ *   IDDOC_ASR_LANG           语言代码(默认自动检测;中文建议 zh)
+ *   IDDOC_OCR_FRAMES=1       对关键帧做画面文字 OCR
+ *   IDDOC_IMAGE_OCR=1        对图片输入做 OCR(默认关闭:图片直接收录)
+ *   IDDOC_UVX / IDDOC_PYTHON 自定义 uvx 与 Python 版本
+ *   IDDOC_SAMPLES / IDDOC_MAX_FRAMES / IDDOC_SCENE  抽帧参数
+ */
+import { type Adapter } from './types.js';
+export declare const IDDOC_VIDEO_EXTENSIONS: string[];
+export declare const IDDOC_AUDIO_EXTENSIONS: string[];
+export declare const IDDOC_IMAGE_EXTENSIONS: string[];
+export declare const IDDOC_EXTENSIONS: string[];
+export declare const iddocAdapter: Adapter;
+//# sourceMappingURL=iddoc.d.ts.map

package/lib/adapters/iddoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iddoc.d.ts","sourceRoot":"","sources":["../../src/adapters/iddoc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAYH,OAAO,EAAgB,KAAK,OAAO,EAAyF,MAAM,YAAY,CAAA;AAE9I,eAAO,MAAM,sBAAsB,UAElC,CAAA;AACD,eAAO,MAAM,sBAAsB,UAElC,CAAA;AACD,eAAO,MAAM,sBAAsB,UAAmB,CAAA;AACtD,eAAO,MAAM,gBAAgB,UAAoF,CAAA;AAyHjH,eAAO,MAAM,YAAY,EAAE,OAQ1B,CAAA"}

package/lib/adapters/iddoc.js

@@ -0,0 +1,153 @@
+/**
+ * iddoc —— 音视频 / 图片 adapter(issue 0017 的 video 档)。
+ *
+ * 这个文件**只做契约映射**:能力全在同包的 `src/media/` 里(纯本地管线:
+ * ffmpeg 抽帧 + 可选的字幕/转写 + 可选的画面 OCR),这里负责
+ *
+ *   1. 把内核的 `AdapterContext` 翻译成该包的 options(**含 env 旋钮**);
+ *   2. 把 `MediaToMarkdownResult` 映射成 `AdapterOutput`(assets 交给内核写盘);
+ *   3. 把它抛出的错误原样转成 `AdapterError`,保留 `code` 与可操作建议。
+ *
+ * 与文档档(anydoc)一样:引擎独立于 adapter,内核只管契约。
+ *
+ * 环境变量(都是**显式**开关,默认不下载模型、不对图片做 OCR):
+ *   IDDOC_ASR=1              允许在无字幕时下载模型并本地转写
+ *   IDDOC_ASR_MODEL          whisper 模型(默认 small;中文建议 large-v3-turbo)
+ *   IDDOC_ASR_LANG           语言代码(默认自动检测;中文建议 zh)
+ *   IDDOC_OCR_FRAMES=1       对关键帧做画面文字 OCR
+ *   IDDOC_IMAGE_OCR=1        对图片输入做 OCR(默认关闭:图片直接收录)
+ *   IDDOC_UVX / IDDOC_PYTHON 自定义 uvx 与 Python 版本
+ *   IDDOC_SAMPLES / IDDOC_MAX_FRAMES / IDDOC_SCENE  抽帧参数
+ */
+import { stat } from 'node:fs/promises';
+import { IMAGE_EXTENSIONS, MediaToMarkdownError, convertMedia, probeTools, } from '../media/index.js';
+import { AdapterError } from './types.js';
+export const IDDOC_VIDEO_EXTENSIONS = [
+    '.mp4', '.m4v', '.mov', '.mkv', '.webm', '.avi', '.flv', '.wmv', '.mpg', '.mpeg', '.ogv',
+];
+export const IDDOC_AUDIO_EXTENSIONS = [
+    '.mp3', '.m4a', '.wav', '.aac', '.flac', '.ogg', '.opus', '.aiff', '.aif', '.amr', '.wma',
+];
+export const IDDOC_IMAGE_EXTENSIONS = IMAGE_EXTENSIONS;
+export const IDDOC_EXTENSIONS = [...IDDOC_VIDEO_EXTENSIONS, ...IDDOC_AUDIO_EXTENSIONS, ...IDDOC_IMAGE_EXTENSIONS];
+const INSTALL_HINT = '装 ffmpeg(含 ffprobe)后重试:macOS `brew install ffmpeg`,Debian/Ubuntu `apt install ffmpeg`。';
+function envFlag(name) {
+    const value = (process.env[name] ?? '').trim().toLowerCase();
+    return value === '1' || value === 'true' || value === 'yes' || value === 'on';
+}
+function envInt(name) {
+    const parsed = Number.parseInt((process.env[name] ?? '').trim(), 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+}
+function envFloat(name) {
+    const parsed = Number.parseFloat((process.env[name] ?? '').trim());
+    return Number.isFinite(parsed) && parsed >= 0 && parsed <= 1 ? parsed : undefined;
+}
+/** 路由用的廉价同步检查;真正的探测在 probe() 与首次使用时。 */
+function availabilitySync() {
+    return { available: true };
+}
+async function probeAvailability() {
+    const versions = await probeTools({ ...(process.env.IDDOC_UVX ? { uvxPath: process.env.IDDOC_UVX } : {}) });
+    if (!versions.ffprobe || !versions.ffmpeg) {
+        const missing = [!versions.ffprobe ? 'ffprobe' : null, !versions.ffmpeg ? 'ffmpeg' : null].filter(Boolean).join('、');
+        return { available: false, reason: `缺少外部二进制:${missing}`, suggestion: INSTALL_HINT };
+    }
+    const reported = {};
+    if (versions.ffmpeg)
+        reported.ffmpeg = versions.ffmpeg;
+    if (versions.ffprobe)
+        reported.ffprobe = versions.ffprobe;
+    if (versions.uvx)
+        reported.uvx = versions.uvx;
+    return { available: true, versions: reported };
+}
+function toOptions(context, file) {
+    const model = (process.env.IDDOC_ASR_MODEL ?? '').trim() || 'small';
+    const language = (process.env.IDDOC_ASR_LANG ?? '').trim();
+    const frames = {
+        ...(envInt('IDDOC_SAMPLES') ? { samples: envInt('IDDOC_SAMPLES') } : {}),
+        ...(envInt('IDDOC_MAX_FRAMES') ? { maxFrames: envInt('IDDOC_MAX_FRAMES') } : {}),
+        ...(envFloat('IDDOC_SCENE') !== undefined ? { sceneThreshold: envFloat('IDDOC_SCENE') } : {}),
+    };
+    const tools = {
+        ...(process.env.IDDOC_UVX?.trim() ? { uvxPath: process.env.IDDOC_UVX.trim() } : {}),
+        ...(process.env.IDDOC_PYTHON?.trim() ? { pythonVersion: process.env.IDDOC_PYTHON.trim() } : {}),
+    };
+    return {
+        file,
+        ...(context.request.title?.trim() ? { title: context.request.title.trim() } : {}),
+        mode: 'auto',
+        asr: {
+            model,
+            ...(language ? { language } : {}),
+            allowModelDownload: envFlag('IDDOC_ASR'),
+        },
+        ...(Object.keys(frames).length > 0 ? { frames } : {}),
+        ...(Object.keys(tools).length > 0 ? { tools } : {}),
+        ...(envFlag('IDDOC_IMAGE_OCR') ? { imageOcr: true } : {}),
+        ...(envFlag('IDDOC_OCR_FRAMES') ? { ocrFrames: true } : {}),
+        ...(context.signal ? { signal: context.signal } : {}),
+        onProgress: progress => context.report(progress.progress, progress.stage, progress.message),
+    };
+}
+function toPreparedAssets(assets) {
+    return assets.map(asset => ({
+        rel: asset.rel,
+        data: asset.data,
+        ...(asset.contentType ? { contentType: asset.contentType } : {}),
+    }));
+}
+async function run(context) {
+    if (!context.inputPath) {
+        throw new AdapterError('INPUT_REQUIRED', 'iddoc 只处理本地文件(kind=file):音频、视频或图片。');
+    }
+    const file = context.inputPath;
+    const fileInfo = await stat(file).catch(() => undefined);
+    if (!fileInfo?.isFile())
+        throw new AdapterError('INPUT_NOT_A_FILE', `输入不是文件:${file}`);
+    const versions = await probeTools({ ...(process.env.IDDOC_UVX ? { uvxPath: process.env.IDDOC_UVX } : {}) });
+    if (!versions.ffprobe || !versions.ffmpeg) {
+        throw new AdapterError('DEPENDENCY_MISSING', 'iddoc 需要 ffmpeg 与 ffprobe。', INSTALL_HINT);
+    }
+    let result;
+    try {
+        result = await convertMedia(toOptions(context, file));
+    }
+    catch (cause) {
+        if (cause instanceof MediaToMarkdownError) {
+            throw new AdapterError(cause.code, cause.message, cause.suggestion);
+        }
+        throw new AdapterError('ADAPTER_FAILED', cause instanceof Error ? cause.message : String(cause));
+    }
+    const warnings = result.warnings.map(warning => ({ code: warning.code, message: warning.message }));
+    const suffix = result.meta.transcriptSource === 'subtitle'
+        ? '+subtitle'
+        : result.meta.transcriptSource === 'transcription' ? '+asr' : '';
+    // 文档类按格式命名(pdf/office),媒体类按容器命名(mp4/png),与既有 parser 约定保持一致。
+    const parserKind = result.meta.sourceFormat === 'image'
+        ? (result.meta.containerExtension ?? 'image')
+        : `${result.meta.sourceFormat}${suffix}`;
+    const assets = toPreparedAssets(result.assets);
+    return {
+        title: result.title,
+        markdown: result.markdown,
+        sourceFormat: result.meta.sourceFormat,
+        parser: `iddoc@1/${parserKind}`,
+        sourcePath: file,
+        warnings,
+        dependencyVersions: result.dependencyVersions,
+        externalId: result.externalId,
+        ...(assets.length > 0 ? { assets } : {}),
+    };
+}
+export const iddocAdapter = {
+    id: 'iddoc',
+    description: '本地音视频 / 图片 → Markdown 与本地图片(能力来自内核自带的 src/media/:字幕优先;转写需显式开启;图片直接收录)',
+    kinds: ['file'],
+    extensions: IDDOC_EXTENSIONS,
+    availability: availabilitySync,
+    probe: probeAvailability,
+    run,
+};
+//# sourceMappingURL=iddoc.js.map

package/lib/adapters/iddoc.js.map

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

package/lib/adapters/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Adapter registry.
+ *
+ * Resolution order stays trivial and explicit: an explicit override, then the
+ * media adapter (`iddoc`, by extension), then the document engine, then the text
+ * pass-through. Unknown extensions are only treated as text when the bytes are
+ * actually textual — guessing there is how "converted successfully" becomes a lie.
+ *
+ * `.pdf` 默认仍走 anydoc(文本层最好、零依赖);只有显式 `SCANNED_OCR=1` 才改走
+ * `scanned`(纯图片页的轻量 OCR 档)。
+ */
+import type { ConvertRequest } from '../contract.js';
+import { type Adapter, type AdapterAvailability } from './types.js';
+export declare const ADAPTERS: Adapter[];
+export declare function findAdapter(id: string): Adapter | undefined;
+/** Cheap binary sniff: NUL bytes or invalid UTF-8 in the head means "not text". */
+export declare function looksTextual(path: string): Promise<boolean>;
+export declare const SUPPORTED_EXTENSIONS: string[];
+export declare function resolveAdapter(request: ConvertRequest, filename: string, inputPath: string | undefined): Promise<Adapter>;
+export interface AdapterCapability {
+    id: string;
+    description: string;
+    kinds: ConvertRequest['kind'][];
+    extensions: string[];
+    availability: AdapterAvailability;
+}
+export interface CapabilityReport {
+    adapters: AdapterCapability[];
+    /** Engine-level runtime facts; documents need no external binary, iddoc needs ffmpeg. */
+    runtime: Record<string, {
+        available: boolean;
+        version?: string;
+        error?: string;
+    }>;
+    defaults: Record<string, string>;
+    /** Extensions the document engine covers. */
+    extensions: string[];
+}
+/** Everything the console and the DSH settings panel need to tell the truth. */
+export declare function capabilityReport(): Promise<CapabilityReport>;
+//# sourceMappingURL=index.d.ts.map

package/lib/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAKpD,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAEjF,eAAO,MAAM,QAAQ,EAAE,OAAO,EAA+D,CAAA;AAE7F,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE3D;AAED,mFAAmF;AACnF,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBjE;AAED,eAAO,MAAM,oBAAoB,UAAkE,CAAA;AAEnG,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,OAAO,CAAC,CAgClB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,CAAA;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,YAAY,EAAE,mBAAmB,CAAA;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAA;IAC7B,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACjF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,6CAA6C;IAC7C,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,gFAAgF;AAChF,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAyClE"}