image-vision-mcp 1.0.0

package/dist/proxy/imageProxy.js

@@ -0,0 +1,346 @@
+import http from "http";
+import https from "https";
+import { URL } from "url";
+import zlib from "zlib";
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { execSync } from "child_process";
+import { callMoonshot } from "../services/moonshot.js";
+// ────────────────────── 日志 ──────────────────────
+// 日志文件路径：优先用环境变量，否则放系统临时目录（跨平台、无需权限处理）
+const LOG_FILE = process.env.VISION_MCP_LOG_FILE ||
+    path.join(os.tmpdir(), "vision-mcp-proxy.log");
+const LOG_MAX_SIZE = 10 * 1024 * 1024; // 10MB，超过后清空旧日志
+function log(msg) {
+    const line = `[${new Date().toISOString()}] ${msg}\n`;
+    console.error(line.trim());
+    fs.stat(LOG_FILE, (statErr, stats) => {
+        if (statErr || stats.size < LOG_MAX_SIZE) {
+            fs.appendFile(LOG_FILE, line, () => { });
+        }
+        else {
+            // 超过大小限制，覆盖写入（保留最近日志，丢弃旧的）
+            fs.writeFile(LOG_FILE, line, () => { });
+        }
+    });
+}
+// ────────────────────── 配置 ──────────────────────
+// 代理监听端口：从 ANTHROPIC_BASE_URL 解析，与 Claude Code 端保持一致
+// 没设 ANTHROPIC_BASE_URL 时用默认 8787（纯 MCP 工具模式，代理无人连接）
+function getProxyPort() {
+    const baseUrl = process.env.ANTHROPIC_BASE_URL;
+    if (baseUrl) {
+        try {
+            const port = new URL(baseUrl).port;
+            if (port)
+                return parseInt(port, 10);
+        }
+        catch {
+            // 忽略解析错误，回退到默认
+        }
+    }
+    return 8787;
+}
+const PROXY_PORT = getProxyPort();
+// 代理转发目标：用户必须设置 UPSTREAM_BASE_URL，否则代理功能不可用（MCP 工具仍可用）
+const UPSTREAM_BASE_URL = process.env.UPSTREAM_BASE_URL || "";
+const UPSTREAM_AUTH_TOKEN = process.env.UPSTREAM_AUTH_TOKEN ||
+    process.env.ANTHROPIC_AUTH_TOKEN ||
+    "";
+const IMAGE_DESC_PROMPT = process.env.IMAGE_DESC_PROMPT ||
+    "请详细描述这张图片的内容。如果是图表/截图，请提取关键信息；如果包含文字，请提取文字内容；如果是 UI 界面，请描述界面元素和布局。描述要简洁准确。";
+// ────────────────────── 图片识别 ──────────────────────
+async function describeImage(base64Data, mimeType) {
+    const dataUrl = `data:${mimeType};base64,${base64Data}`;
+    const apiKey = process.env.MOONSHOT_API_KEY || "";
+    if (!apiKey) {
+        throw new Error("MOONSHOT_API_KEY 未设置");
+    }
+    const response = await callMoonshot({
+        apiKey,
+        messages: [
+            {
+                role: "user",
+                content: [
+                    { type: "image_url", image_url: { url: dataUrl } },
+                    { type: "text", text: IMAGE_DESC_PROMPT },
+                ],
+            },
+        ],
+        maxTokens: 2048,
+    });
+    const description = response.choices?.[0]?.message?.content || "";
+    if (!description) {
+        throw new Error("Moonshot API 返回空内容");
+    }
+    return description;
+}
+async function processContent(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return content;
+    // 日志：记录所有 block 类型，方便排查
+    const blockTypes = content.map((b) => b?.type || "unknown");
+    log(`[image-proxy] content blocks: ${JSON.stringify(blockTypes)}`);
+    const newContent = [];
+    for (const block of content) {
+        // 格式1: Anthropic 标准 {"type":"image","source":{"type":"base64",...}}
+        if (block?.type === "image" && block.source?.type === "base64") {
+            const { media_type, data } = block.source;
+            try {
+                const description = await describeImage(data, media_type);
+                newContent.push({
+                    type: "text",
+                    text: `[以下是用户粘贴的图片内容描述]\n${description}\n[图片描述结束]`,
+                });
+                log(`[image-proxy] 图片已识别 (${media_type}, ${Math.round((data.length * 0.75) / 1024)} KB)`);
+            }
+            catch (err) {
+                log(`[image-proxy] 图片识别失败: ${err.message}`);
+                newContent.push({
+                    type: "text",
+                    text: `[图片识别失败: ${err.message}]`,
+                });
+            }
+        }
+        // 格式2: OpenAI 风格 {"type":"image_url","image_url":{"url":"data:image/png;base64,..."}}
+        else if (block?.type === "image_url" &&
+            block.image_url?.url?.startsWith("data:image")) {
+            const url = block.image_url.url;
+            const match = url.match(/^data:(image\/[a-z+]+);base64,(.+)$/i);
+            if (match) {
+                const [, media_type, data] = match;
+                try {
+                    const description = await describeImage(data, media_type);
+                    newContent.push({
+                        type: "text",
+                        text: `[以下是截图内容描述]\n${description}\n[图片描述结束]`,
+                    });
+                    log(`[image-proxy] image_url 图片已识别 (${media_type})`);
+                }
+                catch (err) {
+                    log(`[image-proxy] image_url 图片识别失败: ${err.message}`);
+                    newContent.push({
+                        type: "text",
+                        text: `[图片识别失败: ${err.message}]`,
+                    });
+                }
+            }
+            else {
+                newContent.push(block);
+            }
+        }
+        // 格式3: tool_result 里嵌套图片（MCP 工具返回的截图）
+        else if (block?.type === "tool_result" && Array.isArray(block.content)) {
+            const toolContent = block.content;
+            const processed = await processContent(toolContent);
+            newContent.push({ ...block, content: processed });
+        }
+        else if (block?.type === "image" && block.source && !block.source.type?.startsWith("base64")) {
+            log(`[image-proxy] 未识别的 image source type: ${block.source.type}`);
+            newContent.push(block);
+        }
+        else {
+            newContent.push(block);
+        }
+    }
+    return newContent;
+}
+async function processMessages(messages) {
+    if (!Array.isArray(messages))
+        return messages;
+    for (const message of messages) {
+        if (message && typeof message === "object" && message.content !== undefined) {
+            message.content = await processContent(message.content);
+        }
+    }
+    return messages;
+}
+// ────────────────────── 转发请求 ──────────────────────
+function forwardRequest(req, res, body) {
+    const baseUrl = new URL(UPSTREAM_BASE_URL);
+    const basePath = baseUrl.pathname.replace(/\/+$/, "");
+    const fullPath = basePath + (req.url || "");
+    const isHttps = baseUrl.protocol === "https:";
+    const lib = isHttps ? https : http;
+    const headers = { ...req.headers };
+    delete headers["host"];
+    delete headers["content-length"];
+    // body 已被解压/修改，必须删除原压缩标记和逐跳头，否则上游会尝试解压明文导致失败
+    delete headers["content-encoding"];
+    delete headers["transfer-encoding"];
+    headers["host"] = baseUrl.host;
+    if (UPSTREAM_AUTH_TOKEN) {
+        headers["authorization"] = `Bearer ${UPSTREAM_AUTH_TOKEN}`;
+        headers["x-api-key"] = UPSTREAM_AUTH_TOKEN;
+    }
+    if (body) {
+        headers["content-length"] = String(Buffer.byteLength(body));
+    }
+    const options = {
+        method: req.method,
+        hostname: baseUrl.hostname,
+        port: baseUrl.port || (isHttps ? 443 : 80),
+        path: fullPath,
+        headers,
+    };
+    const proxyReq = lib.request(options, (proxyRes) => {
+        res.writeHead(proxyRes.statusCode || 502, proxyRes.headers);
+        proxyRes.pipe(res);
+    });
+    proxyReq.on("error", (err) => {
+        log(`[image-proxy] 转发失败: ${err.message}`);
+        if (!res.headersSent) {
+            res.writeHead(502, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: { type: "proxy_error", message: err.message } }));
+        }
+    });
+    if (body) {
+        proxyReq.write(body);
+    }
+    else {
+        req.pipe(proxyReq);
+    }
+    proxyReq.end();
+}
+// ────────────────────── 端口清理 ──────────────────────
+function killProcessOnPort(port) {
+    try {
+        if (process.platform === "win32") {
+            execSync(`powershell -NoProfile -Command "Get-NetTCPConnection -LocalPort ${port} -ErrorAction SilentlyContinue | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force -ErrorAction SilentlyContinue }"`, { stdio: "ignore", timeout: 5000 });
+        }
+        else if (process.platform === "darwin" || process.platform === "linux") {
+            // macOS/Linux: lsof 找到占用端口的 PID 并 kill -9
+            // lsof 不存在时静默失败，|| true 保证命令返回 0
+            execSync(`lsof -ti :${port} 2>/dev/null | xargs kill -9 2>/dev/null || true`, {
+                stdio: "ignore",
+                timeout: 5000,
+            });
+        }
+        else {
+            return false;
+        }
+        log(`[image-proxy] 已清理占用端口 ${port} 的旧进程`);
+        return true;
+    }
+    catch {
+        // 忽略错误
+    }
+    return false;
+}
+// ────────────────────── 启动代理 ──────────────────────
+export function startImageProxy() {
+    return new Promise((resolve) => {
+        if (!UPSTREAM_BASE_URL) {
+            log("[image-proxy] 未设置 UPSTREAM_BASE_URL，代理功能不可用（MCP 工具仍可用）");
+            resolve();
+            return;
+        }
+        const server = http.createServer(async (req, res) => {
+            const isMessagesEndpoint = req.method === "POST" && (req.url || "").includes("/v1/messages");
+            if (!isMessagesEndpoint) {
+                forwardRequest(req, res, null);
+                return;
+            }
+            const chunks = [];
+            req.on("data", (chunk) => chunks.push(chunk));
+            req.on("end", async () => {
+                const buffer = Buffer.concat(chunks);
+                const contentEncoding = (req.headers["content-encoding"] || "").toLowerCase();
+                // 解压请求体（支持 gzip / deflate / br），否则 JSON.parse 会失败
+                let rawBody;
+                try {
+                    if (contentEncoding.includes("gzip")) {
+                        rawBody = zlib.gunzipSync(buffer).toString("utf8");
+                    }
+                    else if (contentEncoding.includes("deflate")) {
+                        rawBody = zlib.inflateSync(buffer).toString("utf8");
+                    }
+                    else if (contentEncoding.includes("br")) {
+                        rawBody = zlib.brotliDecompressSync(buffer).toString("utf8");
+                    }
+                    else {
+                        rawBody = buffer.toString("utf8");
+                    }
+                }
+                catch (err) {
+                    log(`[image-proxy] 请求体解压失败: ${err.message}`);
+                    if (!res.headersSent) {
+                        res.writeHead(400, { "Content-Type": "application/json" });
+                        res.end(JSON.stringify({
+                            error: { type: "proxy_error", message: "请求体解压失败" },
+                        }));
+                    }
+                    return;
+                }
+                try {
+                    const requestData = JSON.parse(rawBody);
+                    let hasImage = false;
+                    if (Array.isArray(requestData.messages)) {
+                        for (const msg of requestData.messages) {
+                            if (Array.isArray(msg.content)) {
+                                for (const block of msg.content) {
+                                    // 检测所有可能的图片格式
+                                    if (block?.type === "image" ||
+                                        block?.type === "image_url" ||
+                                        (block?.type === "tool_result" && Array.isArray(block.content))) {
+                                        hasImage = true;
+                                        break;
+                                    }
+                                }
+                            }
+                            if (hasImage)
+                                break;
+                        }
+                    }
+                    if (hasImage) {
+                        log(`[image-proxy] 检测到图片，开始识别...`);
+                        requestData.messages = await processMessages(requestData.messages);
+                        const newBody = JSON.stringify(requestData);
+                        forwardRequest(req, res, newBody);
+                    }
+                    else {
+                        forwardRequest(req, res, rawBody);
+                    }
+                }
+                catch (err) {
+                    log(`[image-proxy] 处理失败: ${err.message}`);
+                    if (!res.headersSent) {
+                        res.writeHead(500, { "Content-Type": "application/json" });
+                        res.end(JSON.stringify({
+                            error: { type: "proxy_error", message: err.message },
+                        }));
+                    }
+                }
+            });
+            req.on("error", (err) => {
+                log(`[image-proxy] 请求错误: ${err.message}`);
+            });
+        });
+        let retried = false;
+        server.on("error", (err) => {
+            const msg = err.message;
+            if (msg.includes("EADDRINUSE") && !retried) {
+                retried = true;
+                log(`[image-proxy] 端口 ${PROXY_PORT} 被占用，清理旧进程后重试...`);
+                killProcessOnPort(PROXY_PORT);
+                setTimeout(() => {
+                    server.listen(PROXY_PORT, "127.0.0.1");
+                }, 1000);
+            }
+            else {
+                // 其他错误或重试仍失败，不阻塞 MCP 启动
+                log(`[image-proxy] 代理启动失败（MCP 工具仍可用）: ${msg}`);
+                resolve();
+            }
+        });
+        server.listen(PROXY_PORT, "127.0.0.1", () => {
+            log(`[image-proxy] 代理已启动: http://127.0.0.1:${PROXY_PORT}`);
+            log(`[image-proxy] 上游 API: ${UPSTREAM_BASE_URL}`);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=imageProxy.js.map

package/dist/proxy/imageProxy.js.map

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

package/dist/schemas.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export declare const DescribeImageInputSchema: z.ZodObject<{
+    image: z.ZodString;
+    prompt: z.ZodDefault<z.ZodString>;
+    max_tokens: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    image: string;
+    prompt: string;
+    max_tokens: number;
+}, {
+    image: string;
+    prompt?: string | undefined;
+    max_tokens?: number | undefined;
+}>;
+export type DescribeImageInput = z.infer<typeof DescribeImageInputSchema>;
+export declare const DescribeClipboardInputSchema: z.ZodObject<{
+    prompt: z.ZodDefault<z.ZodString>;
+    max_tokens: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    prompt: string;
+    max_tokens: number;
+}, {
+    prompt?: string | undefined;
+    max_tokens?: number | undefined;
+}>;
+export type DescribeClipboardInput = z.infer<typeof DescribeClipboardInputSchema>;

package/dist/schemas.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import { DEFAULT_PROMPT } from "./constants.js";
+export const DescribeImageInputSchema = z.object({
+    image: z.string()
+        .min(1, "image is required")
+        .describe("图片路径或 URL。支持本地文件路径（如 C:/Users/user/screenshot.png 或 /tmp/img.jpg）或 http(s):// 开头的图片 URL"),
+    prompt: z.string()
+        .min(1)
+        .max(4000)
+        .default(DEFAULT_PROMPT)
+        .describe("询问图片的问题或识图指令，例如 '描述图片内容'、'图片中有哪些文字'、'这是什么图表'、'提取图片中的所有文字'"),
+    max_tokens: z.number()
+        .int()
+        .min(1)
+        .max(8192)
+        .default(2048)
+        .describe("返回描述的最大 token 数，1-8192 之间，默认 2048"),
+}).strict();
+export const DescribeClipboardInputSchema = z.object({
+    prompt: z.string()
+        .min(1)
+        .max(4000)
+        .default(DEFAULT_PROMPT)
+        .describe("询问图片的问题或识图指令，例如 '描述图片内容'、'图片中有哪些文字'、'这是什么图表'、'提取图片中的所有文字'"),
+    max_tokens: z.number()
+        .int()
+        .min(1)
+        .max(8192)
+        .default(2048)
+        .describe("返回描述的最大 token 数，1-8192 之间，默认 2048"),
+}).strict();
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACd,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;SAC3B,QAAQ,CAAC,yFAAyF,CAAC;IACtG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACf,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,OAAO,CAAC,cAAc,CAAC;SACvB,QAAQ,CAAC,2DAA2D,CAAC;IACxE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;SACnB,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,mCAAmC,CAAC;CACjD,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACf,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,OAAO,CAAC,cAAc,CAAC;SACvB,QAAQ,CAAC,2DAA2D,CAAC;IACxE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;SACnB,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,mCAAmC,CAAC;CACjD,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/services/clipboard.d.ts

@@ -0,0 +1,16 @@
+import type { ImageLoadResult } from "../types.js";
+/**
+ * 跨平台读取剪贴板图片
+ *
+ * - Windows: PowerShell System.Windows.Forms.Clipboard
+ * - macOS: pngpaste (优先) 或 osascript
+ * - Linux: xclip (优先) 或 xsel
+ */
+export declare function readClipboardImage(): Promise<ImageLoadResult>;
+/**
+ * 清理上次进程异常退出残留的临时图片文件
+ *
+ * readClipboardImage 用 finally 清理临时文件，但进程被 SIGKILL 时来不及执行。
+ * 启动时调一次，扫掉 os.tmpdir() 里所有 kimi_clipboard_*.png。
+ */
+export declare function cleanupOldTempImages(): Promise<void>;

package/dist/services/clipboard.js

@@ -0,0 +1,196 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+import path from "path";
+import os from "os";
+import fs from "fs/promises";
+import { IMAGE_MAX_SIZE_BYTES } from "../constants.js";
+import { imageBufferToDataUrl, detectMimeTypeFromPath } from "./image.js";
+const execFileAsync = promisify(execFile);
+/**
+ * 生成临时图片路径
+ */
+function getTempImagePath() {
+    const timestamp = Date.now();
+    return path.join(os.tmpdir(), `kimi_clipboard_${timestamp}.png`);
+}
+/**
+ * 从临时文件加载图片为 data URL，并清理临时文件
+ */
+async function loadTempImage(tempPath) {
+    let buffer;
+    try {
+        buffer = await fs.readFile(tempPath);
+    }
+    finally {
+        // 无论成功与否都尝试清理临时文件
+        fs.unlink(tempPath).catch(() => { });
+    }
+    if (buffer.length > IMAGE_MAX_SIZE_BYTES) {
+        throw new Error(`剪贴板图片过大: ${(buffer.length / 1024 / 1024).toFixed(2)} MB，最大支持 ${IMAGE_MAX_SIZE_BYTES / 1024 / 1024} MB`);
+    }
+    const mimeType = detectMimeTypeFromPath(tempPath); // .png → image/png
+    return {
+        dataUrl: imageBufferToDataUrl(buffer, mimeType),
+        mimeType,
+        sizeBytes: buffer.length,
+    };
+}
+// ────────────────────── Windows ──────────────────────
+async function readClipboardWindows() {
+    const tempPath = getTempImagePath();
+    // PowerShell 单引号字符串里所有字符都是字面量（含 \ $ 反引号），单引号本身转义为 ''
+    // 这样避免路径含特殊字符时被 PowerShell 解释，比双引号 + 反斜杠转义更安全
+    const safePath = tempPath.replace(/'/g, "''");
+    const psScript = `
+Add-Type -AssemblyName System.Windows.Forms
+$img = [System.Windows.Forms.Clipboard]::GetImage()
+if ($img -eq $null) {
+    exit 1
+}
+$img.Save('${safePath}')
+$img.Dispose()
+exit 0
+`.trim();
+    try {
+        await execFileAsync("powershell", [
+            "-NoProfile",
+            "-NonInteractive",
+            "-Command",
+            psScript,
+        ]);
+    }
+    catch (err) {
+        if (err.code === 1) {
+            throw new Error("剪贴板中没有图片");
+        }
+        throw new Error(`PowerShell 读取剪贴板图片失败: ${err.message}`);
+    }
+    return loadTempImage(tempPath);
+}
+// ────────────────────── macOS ──────────────────────
+async function readClipboardMac() {
+    const tempPath = getTempImagePath();
+    // 优先尝试 pngpaste（brew install pngpaste）
+    try {
+        await execFileAsync("pngpaste", [tempPath]);
+        return loadTempImage(tempPath);
+    }
+    catch (err) {
+        // pngpaste 不可用或执行失败（如剪贴板无图片），回退到 osascript
+        console.error(`[vision-mcp] pngpaste 不可用，回退到 osascript: ${err.message}`);
+    }
+    // 使用 AppleScript 从剪贴板读取 PNG 图片
+    const appleScript = `
+try
+    set theFile to (open for access POSIX file "${tempPath}" with write permission)
+    try
+        write (the clipboard as «class PNGf») to theFile
+    on error
+        close access theFile
+        error "NoImage"
+    end try
+    close access theFile
+on error errMsg
+    if errMsg is "NoImage" then
+        error "NoImage"
+    else
+        error errMsg
+    end if
+end try
+`.trim();
+    try {
+        await execFileAsync("osascript", ["-e", appleScript]);
+    }
+    catch (err) {
+        const msg = err.message || "";
+        if (msg.includes("NoImage") || msg.includes("clipboard")) {
+            throw new Error("剪贴板中没有图片");
+        }
+        throw new Error(`osascript 读取剪贴板图片失败: ${msg}`);
+    }
+    return loadTempImage(tempPath);
+}
+// ────────────────────── Linux ──────────────────────
+async function readClipboardLinux() {
+    const tempPath = getTempImagePath();
+    // 尝试 xclip
+    try {
+        const { stdout } = await execFileAsync("xclip", [
+            "-selection",
+            "clipboard",
+            "-t",
+            "image/png",
+            "-o",
+        ], { encoding: "buffer" });
+        if (!stdout || stdout.length === 0) {
+            throw new Error("剪贴板中没有图片");
+        }
+        await fs.writeFile(tempPath, stdout);
+        return loadTempImage(tempPath);
+    }
+    catch (err) {
+        if (err.message?.includes("剪贴板中没有图片")) {
+            throw err;
+        }
+        // xclip 不可用或执行失败，尝试 xsel
+    }
+    // 尝试 xsel
+    try {
+        const { stdout } = await execFileAsync("xsel", [
+            "--clipboard",
+            "--output",
+        ], { encoding: "buffer" });
+        if (!stdout || stdout.length === 0) {
+            throw new Error("剪贴板中没有图片");
+        }
+        await fs.writeFile(tempPath, stdout);
+        return loadTempImage(tempPath);
+    }
+    catch (err) {
+        if (err.message?.includes("剪贴板中没有图片")) {
+            throw err;
+        }
+        throw new Error("Linux 剪贴板读取失败，请安装 xclip 或 xsel: sudo apt install xclip");
+    }
+}
+// ────────────────────── 统一入口 ──────────────────────
+/**
+ * 跨平台读取剪贴板图片
+ *
+ * - Windows: PowerShell System.Windows.Forms.Clipboard
+ * - macOS: pngpaste (优先) 或 osascript
+ * - Linux: xclip (优先) 或 xsel
+ */
+export async function readClipboardImage() {
+    const platform = process.platform;
+    switch (platform) {
+        case "win32":
+            return readClipboardWindows();
+        case "darwin":
+            return readClipboardMac();
+        case "linux":
+            return readClipboardLinux();
+        default:
+            throw new Error(`不支持的平台: ${platform}`);
+    }
+}
+/**
+ * 清理上次进程异常退出残留的临时图片文件
+ *
+ * readClipboardImage 用 finally 清理临时文件，但进程被 SIGKILL 时来不及执行。
+ * 启动时调一次，扫掉 os.tmpdir() 里所有 kimi_clipboard_*.png。
+ */
+export async function cleanupOldTempImages() {
+    const tmpDir = os.tmpdir();
+    try {
+        const files = await fs.readdir(tmpDir);
+        const pattern = /^kimi_clipboard_\d+\.png$/;
+        await Promise.all(files
+            .filter((f) => pattern.test(f))
+            .map((f) => fs.unlink(path.join(tmpDir, f)).catch(() => { })));
+    }
+    catch {
+        // 忽略错误
+    }
+}
+//# sourceMappingURL=clipboard.js.map

package/dist/services/clipboard.js.map

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