opencode-tui-image-clipboard-fix 1.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenCode Image Storage Plugin Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,89 @@
+# OpenCode TUI Image Clipboard Fix
+
+修复 OpenCode TUI 中图片粘贴和拖入的问题：自动将图片保存为本地文件，并替换 `[Image N]` 占位符为实际文件路径。
+
+## 🚀 一键安装
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/A11thwn/opencode-tui-image-clipboard-fix/main/install.sh | bash
+```
+
+安装完成后，重启 OpenCode 即可使用。
+
+## 📦 手动安装
+
+在 `~/.config/opencode/opencode.json` 的 `plugin` 数组中添加：
+
+```json
+{
+  "plugin": ["github:A11thwn/opencode-tui-image-clipboard-fix"]
+}
+```
+
+## ✨ 功能特性
+
+- ✅ **自动保存图片**：将 base64 图片数据保存为本地文件
+- ✅ **路径替换**：自动替换 `[Image 1]` 占位符为 `/path/to/image.png`
+- ✅ **去重检测**：使用 SHA-256 哈希避免保存重复图片
+- ✅ **LRU 清理**：当存储超过限制时自动删除最旧的图片
+- ✅ **移除 FilePart**：避免不支持图片的模型报错
+- ✅ **自动提示**：添加提示让模型使用 `read` 工具读取图片
+
+## 🔧 工作原理
+
+```
+┌─────────────────────────────────────────────────────┐
+│                OpenCode TUI                         │
+│  用户粘贴/拖入图片                                    │
+│  ↓                                                  │
+│  生成 FilePart (url: "data:image/...;base64,...")  │
+│  消息文本包含 [Image 1] 占位符                       │
+└─────────────────────────────────────────────────────┘
+                        ↓
+┌─────────────────────────────────────────────────────┐
+│           Image Clipboard Fix Plugin                │
+│  1. 监听 chat.message hook                          │
+│  2. 检测图片 FilePart                               │
+│  3. 提取 base64 数据，保存为本地文件                   │
+│  4. 替换文本中的 [Image N] 为实际路径                 │
+│  5. 移除 FilePart（避免模型报错）                    │
+│  6. 添加提示让模型使用 read 工具读取图片              │
+└─────────────────────────────────────────────────────┘
+                        ↓
+┌─────────────────────────────────────────────────────┐
+│                最终消息                              │
+│  "请分析这张图片 /path/to/image.png                  │
+│   [Image Reference: ...]"                           │
+│  模型使用 read 工具读取图片                          │
+└─────────────────────────────────────────────────────┘
+```
+
+## ⚙️ 配置
+
+默认配置：
+
+- **存储目录**: `~/.local/share/opencode/storage/images`
+- **最大存储**: 2048 MB
+- **最小剩余空间**: 512 MB
+
+## 📝 支持的格式
+
+- PNG (支持尺寸提取)
+- JPEG/JPG
+- GIF
+- WebP
+
+## 🐛 解决的问题
+
+1. **粘贴图片识别问题**：将 base64 图片保存为文件，替换占位符为路径
+2. **模型不支持图片报错**：移除 FilePart，只发送文本路径
+3. **图片读取提示**：自动添加提示让模型使用 read 工具读取图片
+
+## 🔗 相关链接
+
+- [OpenCode](https://opencode.ai)
+- [GitHub Issues](https://github.com/A11thwn/opencode-tui-image-clipboard-fix/issues)
+
+## 📄 License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,86 @@
+interface PluginInput {
+    client: any;
+    project: any;
+    directory: string;
+    worktree: string;
+    serverUrl: URL;
+    $: any;
+}
+interface FilePart {
+    id?: string;
+    sessionID?: string;
+    messageID?: string;
+    type: "file";
+    mime: string;
+    filename?: string;
+    url: string;
+    source?: {
+        type: string;
+        path: string;
+        text?: {
+            start: number;
+            end: number;
+            value: string;
+        };
+    };
+}
+interface TextPart {
+    id?: string;
+    sessionID?: string;
+    messageID?: string;
+    type: "text";
+    text: string;
+    source?: {
+        text?: {
+            start: number;
+            end: number;
+            value: string;
+        };
+    };
+}
+type Part = FilePart | TextPart | {
+    type: string;
+    [key: string]: any;
+};
+interface Message {
+    id?: string;
+    sessionID?: string;
+    role?: string;
+    [key: string]: any;
+}
+interface ChatMessageInput {
+    sessionID: string;
+    agent?: string;
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+    messageID?: string;
+    variant?: string;
+}
+interface ChatMessageOutput {
+    message: any;
+    parts: Part[];
+}
+interface MessagesTransformOutput {
+    messages: {
+        info: Message;
+        parts: Part[];
+    }[];
+}
+type Plugin = (input: PluginInput) => Promise<{
+    "chat.message"?: (input: ChatMessageInput, output: ChatMessageOutput) => Promise<void>;
+    "experimental.chat.messages.transform"?: (input: {}, output: MessagesTransformOutput) => Promise<void>;
+    command?: Record<string, () => Promise<void>>;
+}>;
+/**
+ * OpenCode Image Storage Plugin
+ *
+ * 功能：
+ * 1. 监听用户消息中的图片（粘贴或拖入）
+ * 2. 将 base64 图片保存为本地文件
+ * 3. 在发送给模型时替换 [Image N] 占位符为实际文件路径（不影响界面显示）
+ * 4. 移除 FilePart，只保留文本（避免不支持图片的模型报错）
+ */
+export declare const ImageStoragePlugin: Plugin;
+export default ImageStoragePlugin;

package/dist/index.js

@@ -0,0 +1,217 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImageStoragePlugin = void 0;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const storage_1 = require("./storage");
+const utils_1 = require("./utils");
+const DEFAULT_CONFIG = {
+    maxStorageMB: 2048,
+    minFreeSpaceMB: 512,
+    storageDir: path.join(os.homedir(), ".local/share/opencode/storage/images"),
+};
+// 存储每个消息的图片路径映射（messageID -> imagePaths）
+const messageImagePaths = new Map();
+/**
+ * OpenCode Image Storage Plugin
+ *
+ * 功能：
+ * 1. 监听用户消息中的图片（粘贴或拖入）
+ * 2. 将 base64 图片保存为本地文件
+ * 3. 在发送给模型时替换 [Image N] 占位符为实际文件路径（不影响界面显示）
+ * 4. 移除 FilePart，只保留文本（避免不支持图片的模型报错）
+ */
+const ImageStoragePlugin = async ({ client, directory }) => {
+    const config = {
+        ...DEFAULT_CONFIG,
+    };
+    const storageManager = new storage_1.ImageStorageManager(config);
+    await storageManager.initialize();
+    /**
+     * 处理消息中的图片，保存并返回路径映射
+     * @param parts 消息的 parts 数组
+     * @param saveImages 是否保存图片（chat.message 时保存，transform 时不保存）
+     */
+    async function processImageParts(parts, saveImages = true) {
+        const imagePathMap = new Map();
+        // 查找所有图片 parts
+        const imageParts = parts.filter((p) => p.type === "file" &&
+            typeof p.mime === "string" &&
+            p.mime.startsWith("image/"));
+        if (imageParts.length === 0) {
+            return { modified: false, imagePaths: imagePathMap };
+        }
+        for (let i = 0; i < imageParts.length; i++) {
+            const imagePart = imageParts[i];
+            const imageIndex = i + 1;
+            const placeholder = `[Image ${imageIndex}]`;
+            try {
+                // 检查是否是 base64 data URL（粘贴的图片）
+                if (imagePart.url && imagePart.url.startsWith("data:image/")) {
+                    if (saveImages) {
+                        const imagePath = await storageManager.saveImageAndReturnPath(imagePart.url, `msg_${Date.now()}`);
+                        if (imagePath) {
+                            imagePathMap.set(placeholder, imagePath);
+                        }
+                    }
+                }
+                else if (imagePart.source?.path &&
+                    imagePart.source.path !== "clipboard" &&
+                    imagePart.source.path !== "") {
+                    // 已经是文件路径（拖入的文件）
+                    imagePathMap.set(placeholder, imagePart.source.path);
+                }
+            }
+            catch (error) {
+                console.error(`[ImageStoragePlugin] Error processing image ${imageIndex}:`, error);
+            }
+        }
+        return { modified: imagePathMap.size > 0, imagePaths: imagePathMap };
+    }
+    /**
+     * 修改文本内容：替换占位符、去重路径、添加提示
+     * 只在 transform hook 中使用，不影响界面显示
+     */
+    function modifyTextContent(text, imagePathMap) {
+        let newText = text;
+        const allPaths = Array.from(imagePathMap.values());
+        // 1. 先从文本中移除所有已知的图片路径（去重）
+        for (const imagePath of allPaths) {
+            const escapedPath = imagePath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            const pathPattern = new RegExp(`\\s*${escapedPath}`, "g");
+            newText = newText.replace(pathPattern, "");
+        }
+        // 2. 替换 [Image N] 占位符为路径
+        for (const [placeholder, imagePath] of imagePathMap) {
+            const escapedPlaceholder = placeholder.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            const placeholderPattern = new RegExp(escapedPlaceholder, "g");
+            newText = newText.replace(placeholderPattern, imagePath);
+        }
+        // 3. 清理多余的空格和换行
+        newText = newText.replace(/\s+/g, " ").trim();
+        // 4. 添加图片读取提示
+        const hint = `\n\n[Image Reference: The above path(s) point to local image file(s). Please use the "read" tool to view the image content.]`;
+        newText = newText + hint;
+        return newText;
+    }
+    /**
+     * 移除图片 FilePart（静默，不打印日志）
+     */
+    function removeImagePartsSilently(parts) {
+        for (let i = parts.length - 1; i >= 0; i--) {
+            const part = parts[i];
+            if (part.type === "file" &&
+                part.mime?.startsWith("image/")) {
+                parts.splice(i, 1);
+            }
+        }
+    }
+    return {
+        /**
+         * chat.message hook - 在用户消息发送时处理
+         * 只负责：1. 保存图片 2. 记录路径映射 3. 移除 FilePart
+         * 不修改 textPart.text，避免修改后的内容显示在界面上
+         */
+        "chat.message": async (input, output) => {
+            const { parts } = output;
+            const { modified, imagePaths } = await processImageParts(parts, true);
+            if (!modified) {
+                return;
+            }
+            // 保存图片路径映射，供 transform hook 使用
+            const messageKey = input.messageID || `msg_${Date.now()}`;
+            messageImagePaths.set(messageKey, imagePaths);
+            // 移除图片 FilePart（避免不支持图片的模型报错）
+            removeImagePartsSilently(parts);
+        },
+        /**
+         * experimental.chat.messages.transform hook - 在发送给模型前转换消息
+         * 在这里进行文本替换，确保模型收到的是完整的图片路径
+         * 这个修改只影响发送给模型的内容，不影响界面显示
+         */
+        "experimental.chat.messages.transform": async (input, output) => {
+            for (const message of output.messages) {
+                // 只处理用户消息
+                if (message.info?.role !== "user")
+                    continue;
+                const { parts } = message;
+                // 尝试从缓存获取图片路径
+                let imagePaths;
+                if (message.info?.id) {
+                    imagePaths = messageImagePaths.get(message.info.id);
+                }
+                // 如果缓存中没有，尝试从 parts 中提取（可能是历史消息）
+                if (!imagePaths || imagePaths.size === 0) {
+                    const result = await processImageParts(parts, false);
+                    if (result.modified) {
+                        imagePaths = result.imagePaths;
+                    }
+                }
+                // 如果有图片路径，替换文本中的占位符
+                if (imagePaths && imagePaths.size > 0) {
+                    const textPart = parts.find((p) => p.type === "text");
+                    if (textPart && textPart.text) {
+                        textPart.text = modifyTextContent(textPart.text, imagePaths);
+                    }
+                }
+                // 移除图片 FilePart
+                removeImagePartsSilently(parts);
+            }
+        },
+        command: {
+            "cleanup-images": async () => {
+                const deletedCount = await storageManager.cleanup();
+                console.log(`[ImageStoragePlugin] Deleted ${deletedCount} images`);
+            },
+            "show-storage": async () => {
+                const stats = await storageManager.getStats();
+                console.log("=== Image Storage Stats ===");
+                console.log(`Total Files: ${stats.totalFiles}`);
+                console.log(`Total Size: ${(0, utils_1.formatSize)(stats.totalSize)}`);
+                console.log(`Oldest File: ${stats.oldestFile || "N/A"}`);
+                console.log(`Newest File: ${stats.newestFile || "N/A"}`);
+                console.log(`Storage Dir: ${config.storageDir}`);
+                console.log(`Max Storage: ${config.maxStorageMB} MB`);
+            },
+            "clear-cache": async () => {
+                messageImagePaths.clear();
+                console.log(`[ImageStoragePlugin] Cleared image path cache`);
+            },
+        },
+    };
+};
+exports.ImageStoragePlugin = ImageStoragePlugin;
+exports.default = exports.ImageStoragePlugin;

package/dist/storage.d.ts

@@ -0,0 +1,55 @@
+import { ImageMetadata, StorageStats, PluginConfig } from './types';
+/**
+ * 图片存储管理器
+ *
+ * 功能：
+ * - 将 base64 图片保存为本地文件
+ * - 去重检测（通过哈希）
+ * - 自动清理（LRU 策略）
+ * - 元数据管理
+ */
+export declare class ImageStorageManager {
+    private config;
+    private metadataFile;
+    private metadata;
+    constructor(config: PluginConfig);
+    /**
+     * 初始化存储目录
+     */
+    initialize(): Promise<void>;
+    /**
+     * 加载元数据
+     */
+    private loadMetadata;
+    /**
+     * 保存元数据
+     */
+    private saveMetadata;
+    /**
+     * 保存图片
+     *
+     * @param dataUrl - base64 data URL (data:image/png;base64,...)
+     * @returns 图片元数据，如果图片已存在则返回现有元数据
+     */
+    saveImage(dataUrl: string): Promise<ImageMetadata | null>;
+    /**
+     * 获取存储统计信息
+     */
+    getStats(): Promise<StorageStats>;
+    /**
+     * 检查并自动清理（LRU 策略）
+     */
+    checkAndCleanup(): Promise<void>;
+    /**
+     * 手动清理所有图片
+     */
+    cleanup(): Promise<number>;
+    /**
+     * 保存图片并返回路径
+     *
+     * @param dataUrl - base64 data URL
+     * @param messageID - 消息 ID（用于日志）
+     * @returns 保存的图片路径，如果失败则返回 null
+     */
+    saveImageAndReturnPath(dataUrl: string, messageID: string): Promise<string | null>;
+}

package/dist/storage.js

@@ -0,0 +1,203 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImageStorageManager = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const utils_1 = require("./utils");
+/**
+ * 图片存储管理器
+ *
+ * 功能：
+ * - 将 base64 图片保存为本地文件
+ * - 去重检测（通过哈希）
+ * - 自动清理（LRU 策略）
+ * - 元数据管理
+ */
+class ImageStorageManager {
+    constructor(config) {
+        this.config = config;
+        this.metadata = new Map();
+        this.metadataFile = path.join(config.storageDir, 'metadata.json');
+    }
+    /**
+     * 初始化存储目录
+     */
+    async initialize() {
+        await fs.mkdir(this.config.storageDir, { recursive: true });
+        await this.loadMetadata();
+    }
+    /**
+     * 加载元数据
+     */
+    async loadMetadata() {
+        try {
+            const data = await fs.readFile(this.metadataFile, 'utf-8');
+            const parsed = JSON.parse(data);
+            this.metadata = new Map(Object.entries(parsed));
+        }
+        catch {
+            this.metadata = new Map();
+        }
+    }
+    /**
+     * 保存元数据
+     */
+    async saveMetadata() {
+        const obj = Object.fromEntries(this.metadata);
+        await fs.writeFile(this.metadataFile, JSON.stringify(obj, null, 2));
+    }
+    /**
+     * 保存图片
+     *
+     * @param dataUrl - base64 data URL (data:image/png;base64,...)
+     * @returns 图片元数据，如果图片已存在则返回现有元数据
+     */
+    async saveImage(dataUrl) {
+        const imageInfo = (0, utils_1.extractImageInfo)(dataUrl);
+        if (!imageInfo) {
+            // Invalid data URL format
+            return null;
+        }
+        const hash = (0, utils_1.generateHash)(imageInfo.base64);
+        // 检查是否已存在相同图片
+        const existingImage = Array.from(this.metadata.values()).find(m => m.hash === hash);
+        if (existingImage) {
+            // Image already exists, returning cached
+            return existingImage;
+        }
+        const buffer = Buffer.from(imageInfo.base64, 'base64');
+        const mimeType = `image/${imageInfo.type}`;
+        const dimensions = (0, utils_1.getImageDimensions)(buffer, mimeType);
+        const timestamp = Date.now();
+        const filename = `${timestamp}_${hash}.${imageInfo.type}`;
+        const filepath = path.join(this.config.storageDir, filename);
+        await fs.writeFile(filepath, buffer);
+        const metadata = {
+            filename,
+            path: filepath,
+            size: imageInfo.size,
+            mimeType,
+            width: dimensions?.width,
+            height: dimensions?.height,
+            createdAt: new Date(timestamp).toISOString(),
+            hash,
+        };
+        this.metadata.set(filename, metadata);
+        await this.saveMetadata();
+        // Image saved successfully
+        // 检查是否需要清理
+        await this.checkAndCleanup();
+        return metadata;
+    }
+    /**
+     * 获取存储统计信息
+     */
+    async getStats() {
+        const files = Array.from(this.metadata.values());
+        const totalSize = files.reduce((sum, f) => sum + f.size, 0);
+        const totalFiles = files.length;
+        const sorted = files.sort((a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime());
+        return {
+            totalSize,
+            totalFiles,
+            oldestFile: sorted[0]?.createdAt,
+            newestFile: sorted[sorted.length - 1]?.createdAt,
+        };
+    }
+    /**
+     * 检查并自动清理（LRU 策略）
+     */
+    async checkAndCleanup() {
+        const stats = await this.getStats();
+        const maxBytes = this.config.maxStorageMB * 1024 * 1024;
+        if (stats.totalSize <= maxBytes)
+            return;
+        const bytesToFree = stats.totalSize - maxBytes + (this.config.minFreeSpaceMB * 1024 * 1024);
+        let freedBytes = 0;
+        const sorted = Array.from(this.metadata.values()).sort((a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime());
+        for (const file of sorted) {
+            if (freedBytes >= bytesToFree)
+                break;
+            try {
+                await fs.unlink(file.path);
+                freedBytes += file.size;
+                this.metadata.delete(file.filename);
+                // Deleted old image for cleanup
+            }
+            catch (err) {
+                console.error(`[ImageStorageManager] Failed to delete ${file.path}:`, err);
+            }
+        }
+        await this.saveMetadata();
+        // Cleanup complete
+    }
+    /**
+     * 手动清理所有图片
+     */
+    async cleanup() {
+        const files = Array.from(this.metadata.keys());
+        let deletedCount = 0;
+        for (const filename of files) {
+            const meta = this.metadata.get(filename);
+            if (!meta)
+                continue;
+            try {
+                await fs.unlink(meta.path);
+                this.metadata.delete(filename);
+                deletedCount++;
+            }
+            catch (err) {
+                console.error(`[ImageStorageManager] Failed to delete ${meta.path}:`, err);
+            }
+        }
+        await this.saveMetadata();
+        return deletedCount;
+    }
+    /**
+     * 保存图片并返回路径
+     *
+     * @param dataUrl - base64 data URL
+     * @param messageID - 消息 ID（用于日志）
+     * @returns 保存的图片路径，如果失败则返回 null
+     */
+    async saveImageAndReturnPath(dataUrl, messageID) {
+        const metadata = await this.saveImage(dataUrl);
+        if (!metadata)
+            return null;
+        return metadata.path;
+    }
+}
+exports.ImageStorageManager = ImageStorageManager;

package/dist/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 图片元数据
+ */
+export interface ImageMetadata {
+    filename: string;
+    path: string;
+    size: number;
+    mimeType: string;
+    width?: number;
+    height?: number;
+    createdAt: string;
+    hash: string;
+}
+/**
+ * 存储统计信息
+ */
+export interface StorageStats {
+    totalSize: number;
+    totalFiles: number;
+    oldestFile?: string;
+    newestFile?: string;
+}
+/**
+ * 插件配置
+ */
+export interface PluginConfig {
+    maxStorageMB: number;
+    minFreeSpaceMB: number;
+    storageDir: string;
+}
+/**
+ * 图片信息（从 data URL 提取）
+ */
+export interface ImageInfo {
+    type: string;
+    size: number;
+    base64: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils.d.ts

@@ -0,0 +1,27 @@
+import { ImageInfo } from './types';
+/**
+ * 格式化字节大小为人类可读格式
+ */
+export declare function formatSize(bytes: number): string;
+/**
+ * 从 data URL 提取图片信息
+ */
+export declare function extractImageInfo(dataUrl: string): ImageInfo | null;
+/**
+ * 生成 base64 数据的哈希值
+ */
+export declare function generateHash(base64: string): string;
+/**
+ * 获取 PNG 图片尺寸
+ */
+export declare function getPNGDimensions(buffer: Buffer): {
+    width: number;
+    height: number;
+} | null;
+/**
+ * 获取图片尺寸（目前仅支持 PNG）
+ */
+export declare function getImageDimensions(buffer: Buffer, mimeType: string): {
+    width: number;
+    height: number;
+} | null;

package/dist/utils.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSize = formatSize;
+exports.extractImageInfo = extractImageInfo;
+exports.generateHash = generateHash;
+exports.getPNGDimensions = getPNGDimensions;
+exports.getImageDimensions = getImageDimensions;
+const crypto_1 = require("crypto");
+/**
+ * 格式化字节大小为人类可读格式
+ */
+function formatSize(bytes) {
+    const units = ['B', 'KB', 'MB', 'GB'];
+    let size = bytes;
+    let unitIndex = 0;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex++;
+    }
+    return `${size.toFixed(2)} ${units[unitIndex]}`;
+}
+/**
+ * 从 data URL 提取图片信息
+ */
+function extractImageInfo(dataUrl) {
+    const match = dataUrl.match(/^data:image\/(png|jpeg|jpg|gif|webp);base64,(.+)$/);
+    if (!match)
+        return null;
+    const type = match[1];
+    const base64 = match[2];
+    const size = Buffer.from(base64, 'base64').byteLength;
+    return { type, size, base64 };
+}
+/**
+ * 生成 base64 数据的哈希值
+ */
+function generateHash(base64) {
+    return (0, crypto_1.createHash)('sha256').update(base64).digest('hex').substring(0, 16);
+}
+/**
+ * 获取 PNG 图片尺寸
+ */
+function getPNGDimensions(buffer) {
+    try {
+        // PNG signature check
+        if (buffer.toString('hex', 0, 8) !== '89504e470d0a1a0a') {
+            return null;
+        }
+        // IHDR chunk contains dimensions (starts at byte 16)
+        const width = buffer.readUInt32BE(16);
+        const height = buffer.readUInt32BE(20);
+        return { width, height };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 获取图片尺寸（目前仅支持 PNG）
+ */
+function getImageDimensions(buffer, mimeType) {
+    if (mimeType === 'image/png') {
+        return getPNGDimensions(buffer);
+    }
+    return null;
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "opencode-tui-image-clipboard-fix",
+  "version": "1.0.5",
+  "description": "OpenCode TUI plugin to fix image paste/drag issues - saves images locally and replaces [Image N] with file paths",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "plugin",
+    "image",
+    "storage",
+    "base64",
+    "clipboard",
+    "paste",
+    "drag-drop",
+    "ai",
+    "llm"
+  ],
+  "author": "chanliang",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chanliang/opencode-tui-image-clipboard-fix.git"
+  },
+  "bugs": {
+    "url": "https://github.com/chanliang/opencode-tui-image-clipboard-fix/issues"
+  },
+  "homepage": "https://github.com/chanliang/opencode-tui-image-clipboard-fix#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@opencode-ai/plugin": {
+      "optional": true
+    }
+  }
+}