axon-code 2.4.0 → 2.6.1

package/dist/hooks/auto-verify.js

@@ -0,0 +1,297 @@
+/**
+ * Auto-Verify 系统
+ *
+ * 追踪对话中的文件修改，在工具结果中注入精确的测试命令，
+ * 引导模型主动验证变更。不自动执行测试（避免副作用）。
+ *
+ * 设计原则：
+ * - 只追踪代码文件（.ts/.js/.py/.go/.rs/.java 等）
+ * - 只在有未验证变更时注入提示
+ * - 给出精确的测试命令（不是模糊建议）
+ * - 每轮 API 调用最多注入一次（避免噪音）
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+// ============================================================================
+// 常量
+// ============================================================================
+/** 需要追踪的代码文件扩展名 */
+const CODE_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.py', '.pyw',
+    '.go',
+    '.rs',
+    '.java', '.kt', '.kts',
+    '.c', '.cpp', '.cc', '.cxx', '.h', '.hpp',
+    '.cs',
+    '.rb',
+    '.swift',
+    '.dart',
+    '.vue', '.svelte',
+]);
+/** 测试命令检测正则（与 blueprint/autonomous-worker.ts 一致） */
+const TEST_COMMAND_RE = /\b(npm\s+test|npm\s+run\s+test|npx\s+vitest|vitest|jest|pytest|go\s+test|cargo\s+test|ruby\s+-Itest|rspec|phpunit|dotnet\s+test)\b/i;
+/** 测试文件名模式 */
+const TEST_FILE_PATTERNS = [
+    // foo.ts → foo.test.ts, foo.spec.ts (same directory)
+    (name, ext, dir) => path.join(dir, `${name}.test${ext}`),
+    (name, ext, dir) => path.join(dir, `${name}.spec${ext}`),
+    // foo.ts → __tests__/foo.test.ts
+    (name, ext, dir) => path.join(dir, '__tests__', `${name}.test${ext}`),
+    (name, ext, dir) => path.join(dir, '__tests__', `${name}.spec${ext}`),
+];
+/** 常见项目结构：src/x.ts → tests/x.test.ts */
+const MIRROR_TEST_DIRS = [
+    ['src', 'tests'],
+    ['src', 'test'],
+    ['lib', 'tests'],
+    ['lib', 'test'],
+];
+const frameworkCache = new Map();
+/**
+ * 从 package.json / 项目配置推断测试框架和命令
+ */
+export function detectTestFramework(cwd) {
+    const cached = frameworkCache.get(cwd);
+    if (cached !== undefined)
+        return cached;
+    let result = null;
+    try {
+        const pkgPath = path.join(cwd, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            const scripts = pkg.scripts || {};
+            const deps = { ...pkg.devDependencies, ...pkg.dependencies };
+            if (deps.vitest || scripts.test?.includes('vitest')) {
+                result = { command: 'npx vitest', framework: 'vitest' };
+            }
+            else if (deps.jest || scripts.test?.includes('jest')) {
+                result = { command: 'npx jest', framework: 'jest' };
+            }
+            else if (scripts.test) {
+                result = { command: 'npm test', framework: 'npm' };
+            }
+        }
+    }
+    catch { /* ignore */ }
+    // Python
+    if (!result) {
+        try {
+            if (fs.existsSync(path.join(cwd, 'pytest.ini')) ||
+                fs.existsSync(path.join(cwd, 'pyproject.toml')) ||
+                fs.existsSync(path.join(cwd, 'setup.cfg'))) {
+                result = { command: 'pytest', framework: 'pytest' };
+            }
+        }
+        catch { /* ignore */ }
+    }
+    // Go
+    if (!result) {
+        try {
+            if (fs.existsSync(path.join(cwd, 'go.mod'))) {
+                result = { command: 'go test ./...', framework: 'go' };
+            }
+        }
+        catch { /* ignore */ }
+    }
+    // Rust
+    if (!result) {
+        try {
+            if (fs.existsSync(path.join(cwd, 'Cargo.toml'))) {
+                result = { command: 'cargo test', framework: 'cargo' };
+            }
+        }
+        catch { /* ignore */ }
+    }
+    frameworkCache.set(cwd, result);
+    return result;
+}
+// ============================================================================
+// 测试文件发现
+// ============================================================================
+/**
+ * 找到与源文件对应的测试文件
+ */
+export function findRelatedTests(filePath, cwd) {
+    const ext = path.extname(filePath);
+    const base = path.basename(filePath, ext);
+    const dir = path.dirname(filePath);
+    const found = [];
+    // 如果文件本身就是测试文件，返回自身
+    if (base.endsWith('.test') || base.endsWith('.spec') || dir.includes('__tests__')) {
+        return [filePath];
+    }
+    // 同目录模式
+    for (const pattern of TEST_FILE_PATTERNS) {
+        const candidate = pattern(base, ext, dir);
+        if (fs.existsSync(candidate)) {
+            found.push(path.relative(cwd, candidate));
+        }
+    }
+    // 镜像目录模式：src/foo/bar.ts → tests/foo/bar.test.ts
+    const relPath = path.relative(cwd, filePath);
+    const parts = relPath.split(path.sep);
+    for (const [srcDir, testDir] of MIRROR_TEST_DIRS) {
+        if (parts[0] === srcDir) {
+            const testRelParts = [testDir, ...parts.slice(1)];
+            const testBase = path.basename(testRelParts[testRelParts.length - 1], ext);
+            testRelParts[testRelParts.length - 1] = `${testBase}.test${ext}`;
+            const candidate = path.join(cwd, ...testRelParts);
+            if (fs.existsSync(candidate)) {
+                found.push(path.join(...testRelParts));
+            }
+        }
+    }
+    return found;
+}
+/**
+ * 变更追踪器
+ *
+ * 每个会话实例持有一个 tracker，记录当前对话中修改了哪些代码文件，
+ * 以及哪些文件已通过测试验证。
+ */
+export class ChangeTracker {
+    /** 被修改的代码文件 → 修改信息 */
+    modifiedFiles = new Map();
+    /** 已验证的文件集合（运行过相关测试的文件） */
+    verifiedFiles = new Set();
+    /** 本轮 API 调用是否已注入过提示（避免重复注入） */
+    hintInjectedThisTurn = false;
+    /**
+     * 记录文件变更
+     * 只追踪代码文件扩展名
+     */
+    trackChange(filePath, tool) {
+        const ext = path.extname(filePath).toLowerCase();
+        if (!CODE_EXTENSIONS.has(ext))
+            return;
+        this.modifiedFiles.set(path.resolve(filePath), {
+            tool,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * 记录验证（检测到 Bash 执行了测试命令）
+     */
+    trackVerification(command) {
+        if (TEST_COMMAND_RE.test(command)) {
+            // 测试命令执行 = 所有当前变更视为已验证
+            for (const filePath of this.modifiedFiles.keys()) {
+                this.verifiedFiles.add(filePath);
+            }
+        }
+    }
+    /**
+     * 获取未验证的变更文件列表
+     */
+    getUnverifiedChanges() {
+        const unverified = [];
+        for (const filePath of this.modifiedFiles.keys()) {
+            if (!this.verifiedFiles.has(filePath)) {
+                unverified.push(filePath);
+            }
+        }
+        return unverified;
+    }
+    /**
+     * 生成验证提示
+     * 返回 null 表示不需要注入
+     */
+    generateHint(cwd) {
+        // 已经注入过本轮提示
+        if (this.hintInjectedThisTurn)
+            return null;
+        const unverified = this.getUnverifiedChanges();
+        // 少于 2 个未验证文件不提示（单文件修改通常是小改动）
+        if (unverified.length < 2)
+            return null;
+        const framework = detectTestFramework(cwd);
+        if (!framework)
+            return null;
+        // 找到相关测试文件
+        const testFiles = [];
+        for (const file of unverified) {
+            const related = findRelatedTests(file, cwd);
+            for (const t of related) {
+                if (!testFiles.includes(t))
+                    testFiles.push(t);
+            }
+        }
+        // 构建精确命令
+        let command;
+        if (testFiles.length > 0 && framework.framework === 'vitest') {
+            command = `npx vitest ${testFiles.join(' ')} --run`;
+        }
+        else if (testFiles.length > 0 && framework.framework === 'jest') {
+            command = `npx jest ${testFiles.join(' ')}`;
+        }
+        else {
+            command = framework.command;
+        }
+        const fileList = unverified
+            .map(f => path.relative(cwd, f))
+            .join(', ');
+        this.hintInjectedThisTurn = true;
+        const parts = [
+            `You have ${unverified.length} unverified code changes: ${fileList}.`,
+        ];
+        if (testFiles.length > 0) {
+            parts.push(`Related tests: ${testFiles.join(', ')}.`);
+        }
+        parts.push(`Verify: \`${command}\``);
+        return parts.join(' ');
+    }
+    /**
+     * 重置本轮注入标记（每轮 API 调用开始时调用）
+     */
+    resetTurnFlag() {
+        this.hintInjectedThisTurn = false;
+    }
+    /**
+     * 获取统计
+     */
+    getStats() {
+        const unverified = this.getUnverifiedChanges();
+        return {
+            modified: this.modifiedFiles.size,
+            verified: this.verifiedFiles.size,
+            unverified: unverified.length,
+        };
+    }
+    /**
+     * 完全重置（会话结束时）
+     */
+    reset() {
+        this.modifiedFiles.clear();
+        this.verifiedFiles.clear();
+        this.hintInjectedThisTurn = false;
+    }
+}
+// ============================================================================
+// 全局单例（按会话隔离）
+// ============================================================================
+const trackers = new Map();
+/**
+ * 获取或创建会话级的 ChangeTracker
+ */
+export function getChangeTracker(sessionId) {
+    let tracker = trackers.get(sessionId);
+    if (!tracker) {
+        tracker = new ChangeTracker();
+        trackers.set(sessionId, tracker);
+    }
+    return tracker;
+}
+/**
+ * 清理会话 tracker
+ */
+export function removeChangeTracker(sessionId) {
+    trackers.delete(sessionId);
+}
+/**
+ * 清空框架检测缓存（测试用）
+ */
+export function clearFrameworkCache() {
+    frameworkCache.clear();
+}
+//# sourceMappingURL=auto-verify.js.map

package/dist/hooks/auto-verify.js.map

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

package/dist/mcp/config.d.ts

@@ -99,64 +99,64 @@ export declare const ExtendedMcpServerConfigSchema: z.ZodEffects<z.ZodObject<{
     timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     retries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
+    timeout?: number;
     type?: "stdio" | "sse" | "http";
     url?: string;
-    timeout?: number;
     command?: string;
     enabled?: boolean;
     headers?: Record<string, string>;
-    retries?: number;
     oauth?: {
         clientId?: string;
         callbackPort?: number;
     };
     args?: string[];
     env?: Record<string, string>;
+    retries?: number;
     clientSecret?: string;
 }, {
+    timeout?: number;
     type?: "stdio" | "sse" | "http";
     url?: string;
-    timeout?: number;
     command?: string;
     enabled?: boolean;
     headers?: Record<string, string>;
-    retries?: number;
     oauth?: {
         clientId?: string;
         callbackPort?: number;
     };
     args?: string[];
     env?: Record<string, string>;
+    retries?: number;
     clientSecret?: string;
 }>, {
+    timeout?: number;
     type?: "stdio" | "sse" | "http";
     url?: string;
-    timeout?: number;
     command?: string;
     enabled?: boolean;
     headers?: Record<string, string>;
-    retries?: number;
     oauth?: {
         clientId?: string;
         callbackPort?: number;
     };
     args?: string[];
     env?: Record<string, string>;
+    retries?: number;
     clientSecret?: string;
 }, {
+    timeout?: number;
     type?: "stdio" | "sse" | "http";
     url?: string;
-    timeout?: number;
     command?: string;
     enabled?: boolean;
     headers?: Record<string, string>;
-    retries?: number;
     oauth?: {
         clientId?: string;
         callbackPort?: number;
     };
     args?: string[];
     env?: Record<string, string>;
+    retries?: number;
     clientSecret?: string;
 }>;
 /**
@@ -255,64 +255,64 @@ export declare const ExtendedMcpConfigSchema: z.ZodRecord<z.ZodString, z.ZodEffe
     timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     retries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
+    timeout?: number;
     type?: "stdio" | "sse" | "http";
     url?: string;
-    timeout?: number;
     command?: string;
     enabled?: boolean;
     headers?: Record<string, string>;
-    retries?: number;
     oauth?: {
         clientId?: string;
         callbackPort?: number;
     };
     args?: string[];
     env?: Record<string, string>;
+    retries?: number;
     clientSecret?: string;
 }, {
+    timeout?: number;
     type?: "stdio" | "sse" | "http";
     url?: string;
-    timeout?: number;
     command?: string;
     enabled?: boolean;
     headers?: Record<string, string>;
-    retries?: number;
     oauth?: {
         clientId?: string;
         callbackPort?: number;
     };
     args?: string[];
     env?: Record<string, string>;
+    retries?: number;
     clientSecret?: string;
 }>, {
+    timeout?: number;
     type?: "stdio" | "sse" | "http";
     url?: string;
-    timeout?: number;
     command?: string;
     enabled?: boolean;
     headers?: Record<string, string>;
-    retries?: number;
     oauth?: {
         clientId?: string;
         callbackPort?: number;
     };
     args?: string[];
     env?: Record<string, string>;
+    retries?: number;
     clientSecret?: string;
 }, {
+    timeout?: number;
     type?: "stdio" | "sse" | "http";
     url?: string;
-    timeout?: number;
     command?: string;
     enabled?: boolean;
     headers?: Record<string, string>;
-    retries?: number;
     oauth?: {
         clientId?: string;
         callbackPort?: number;
     };
     args?: string[];
     env?: Record<string, string>;
+    retries?: number;
     clientSecret?: string;
 }>>;
 export type McpServerConfig = z.infer<typeof McpServerConfigSchema>;

package/dist/media/index.d.ts

@@ -10,7 +10,8 @@
 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 { OFFICE_EXTENSIONS, DOCUMENT_EXTENSIONS, isOfficeFile, isDocumentFile, documentToHtml, documentToText, getSearchableText, renderPresentationToImages, MAX_RENDERED_PRESENTATION_PAGES, type PresentationRenderResult, editDocument, clearDocumentCache, type EditDocumentResult, } from './office.js';
+export { extractDocumentVisuals, compressExtractedImages, MAX_IMAGES_PER_DOCUMENT, type VisualExtractionResult, type ExtractedImage, type CompressedImage, type SlideInfo, } from './office-visual.js';
 export { isSvgRenderEnabled, renderSvgToPng, renderSvgStringToPng, validateSvgFile, getSvgDimensions, type SvgRenderOptions, } from './svg.js';
 import { type ImageResult } from './image.js';
 import { type PdfReadResult } from './pdf.js';

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

@@ -1 +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"}
+{"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,0BAA0B,EAC1B,+BAA+B,EAC/B,KAAK,wBAAwB,EAC7B,YAAY,EACZ,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,SAAS,GACf,MAAM,oBAAoB,CAAC;AAG5B,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

@@ -14,7 +14,9 @@ export { PDF_MAX_SIZE, PDF_EXTENSIONS, PDF_MAX_PAGES_PER_REQUEST, PDF_LARGE_THRE
 // 图片处理
 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';
+export { OFFICE_EXTENSIONS, DOCUMENT_EXTENSIONS, isOfficeFile, isDocumentFile, documentToHtml, documentToText, getSearchableText, renderPresentationToImages, MAX_RENDERED_PRESENTATION_PAGES, editDocument, clearDocumentCache, } from './office.js';
+// Office 文档视觉提取（图片 + 文本）
+export { extractDocumentVisuals, compressExtractedImages, MAX_IMAGES_PER_DOCUMENT, } from './office-visual.js';
 // SVG 渲染
 export { isSvgRenderEnabled, renderSvgToPng, renderSvgStringToPng, validateSvgFile, getSvgDimensions, } from './svg.js';
 /**
@@ -103,8 +105,8 @@ export const BINARY_FILE_BLACKLIST = new Set([
     // 数据库文件
     'dat', 'db', 'sqlite', 'sqlite3', 'mdb', 'idx',
     // Office 文档（旧格式，不支持解析）
-    'doc', 'xls', 'ppt', 'odt', 'ods', 'odp',
-    // 注意：docx/xlsx/pptx 已移出黑名单，由 office.ts 模块处理
+    'doc', 'xls', 'odt', 'ods', 'odp',
+    // 注意：docx/xlsx/ppt/pptx 已移出黑名单，由 office.ts 模块处理
     // 字体文件
     'ttf', 'otf', 'woff', 'woff2', 'eot',
     // 设计文件

package/dist/media/index.js.map

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

package/dist/media/office-visual.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Office 文档视觉提取模块
+ * 从 docx/pptx/xlsx ZIP 包中提取嵌入图片 + 文本，
+ * 让多模态模型能"看到"文档中的图片内容。
+ *
+ * 策略：纯 JS 从 ZIP 提取 media/ 目录下的嵌入图片 + 解析文本
+ * 不依赖 LibreOffice 等外部工具
+ */
+/** 单张提取的图片 */
+export interface ExtractedImage {
+    /** 图片在 ZIP 中的路径 (e.g. ppt/media/image1.png) */
+    zipPath: string;
+    /** 原始二进制数据 */
+    data: Buffer;
+    /** MIME 类型 */
+    mimeType: string;
+    /** 关联的 slide/page 编号（如果可以确定） */
+    slideIndex?: number;
+}
+/** 单个 slide/page 的信息 */
+export interface SlideInfo {
+    /** slide 编号（从 1 开始） */
+    index: number;
+    /** 提取的纯文本 */
+    text: string;
+    /** 关联的图片列表 */
+    images: ExtractedImage[];
+}
+/** 文档视觉提取结果 */
+export interface VisualExtractionResult {
+    /** 文档类型 */
+    type: 'pptx' | 'docx' | 'xlsx';
+    /** 按 slide/page 组织的内容 */
+    slides: SlideInfo[];
+    /** 未关联到 slide 的图片（兜底） */
+    unassociatedImages: ExtractedImage[];
+    /** 纯文本摘要（所有 slide 文本拼接） */
+    fullText: string;
+    /** 总图片数 */
+    totalImages: number;
+}
+/** 每次提取的最大图片数 */
+export declare const MAX_IMAGES_PER_DOCUMENT = 20;
+/**
+ * 从 Office 文档中提取嵌入图片和文本
+ */
+export declare function extractDocumentVisuals(filePath: string): Promise<VisualExtractionResult>;
+/** 压缩后的图片 */
+export interface CompressedImage {
+    /** base64 编码 */
+    base64: string;
+    /** MIME 类型 */
+    mimeType: 'image/jpeg' | 'image/png';
+    /** 压缩后大小（字节） */
+    size: number;
+    /** 原始 ZIP 路径 */
+    zipPath: string;
+    /** 关联的 slide 编号 */
+    slideIndex?: number;
+}
+/**
+ * 批量压缩图片
+ * 使用 sharp 缩放到 2000x2000 以内，转 JPEG
+ */
+export declare function compressExtractedImages(images: ExtractedImage[], maxDimension?: number, quality?: number): Promise<CompressedImage[]>;
+//# sourceMappingURL=office-visual.d.ts.map

package/dist/media/office-visual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"office-visual.d.ts","sourceRoot":"","sources":["../../src/media/office-visual.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,cAAc;AACd,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAwB;AACxB,MAAM,WAAW,SAAS;IACxB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,eAAe;AACf,MAAM,WAAW,sBAAsB;IACrC,WAAW;IACX,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,yBAAyB;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,yBAAyB;IACzB,kBAAkB,EAAE,cAAc,EAAE,CAAC;IACrC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iBAAiB;AACjB,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAK1C;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAgB9F;AAqWD,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,QAAQ,EAAE,YAAY,GAAG,WAAW,CAAC;IACrC,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,cAAc,EAAE,EACxB,YAAY,SAAO,EACnB,OAAO,SAAK,GACX,OAAO,CAAC,eAAe,EAAE,CAAC,CAyD5B"}