@xiaoqiong0v0/opencode-file-tool 1.0.5 → 1.0.8

package/README.md

@@ -14,9 +14,10 @@ OpenCode 文件缓存与图片分析插件。自动缓存用户粘贴的图片
 
 ## 功能
 
-- **文件缓存** — 粘贴图片时自动缓存到 `~/.opencode/plugins-cache/`
+- **文件缓存** — 粘贴图片时自动缓存到 `~/.opencode/plugins-cache/file-tool/`
 - **图片分析** — 通过 `analyze_image file_id:N` 调用视觉模型分析
 - **会话父子链** — 子 agent 会话可通过 parent 链回退读取祖先会话的缓存
+- **开关控制** — 主模型支持视觉时可用 `disable` 关闭缓存，让模型直接读取图片
 - **多语言** — 支持中/英文提示
 
 ## 工具
@@ -26,6 +27,11 @@ OpenCode 文件缓存与图片分析插件。自动缓存用户粘贴的图片
 | `file_tool list-provider` | 列出可用模型 |
 | `file_tool set-provider <model>` | 切换视觉模型 |
 | `file_tool list-cache [all\|N\|main\|main N]` | 查看缓存文件 |
+| `file_tool enable` | 临时开启图片缓存（重启恢复默认） |
+| `file_tool disable` | 临时关闭图片缓存（重启恢复默认） |
+| `file_tool enable-save` | 持久开启图片缓存（写入配置） |
+| `file_tool disable-save` | 持久关闭图片缓存（写入配置） |
+| `file_tool status` | 查看缓存开关状态和当前视觉模型 |
 | `analyze_image file_id:N` | 分析指定图片 |
 
 ## 命令
@@ -36,7 +42,7 @@ OpenCode 文件缓存与图片分析插件。自动缓存用户粘贴的图片
 
 ## 配置
 
-`~/.config/opencode/file-tool.jsonc` 在首次启动时自动生成。
+`~/.config/opencode/file-tool.jsonc` 在首次启动时自动生成，支持 `enabled` 字段控制缓存开关。
 
 ## GitHub
 

package/dist/file-tool.js

@@ -18,11 +18,14 @@ const FILE_TOOL_CFG_SAMPLE = `{
   // 缓存消息数量上限，超过则删除最早的
   "maxCacheMessages": 3,
   // 工具提示语言：zh=中文, en=English
-  "lang": "en"
+  "lang": "en",
+  // 是否启用图片缓存
+  "enabled": true
 }
 `;
 let MAX_CACHE_MSGS = 3;
 let LANG = "en";
+let ENABLED = true;
 const TX = {
     file_not_found: { zh: "文件不存在: {path}", en: "File not found: {path}" },
     file_id_not_found: { zh: "文件ID不存在: {id}", en: "File ID not found: {id}" },
@@ -34,7 +37,7 @@ const TX = {
     model_not_set: { zh: "未设置", en: "not set" },
     model_switched: { zh: "视觉模型已切换为: {model}", en: "Vision model set to: {model}" },
     specify_model: { zh: "请指定模型名", en: "Specify a model name" },
-    unknown_cmd: { zh: "未知命令: {cmd}\n可用: list-provider, set-provider <model>, list-cache [all|N|main|main N]", en: "Unknown command: {cmd}\nAvailable: list-provider, set-provider <model>, list-cache [all|N|main|main N]" },
+    unknown_cmd: { zh: "未知命令: {cmd}\n可用: list-provider, set-provider <model>, list-cache [all|N|main|main N], enable, disable, enable-save, disable-save, status", en: "Unknown command: {cmd}\nAvailable: list-provider, set-provider <model>, list-cache [all|N|main|main N], enable, disable, enable-save, disable-save, status" },
     config_error: { zh: "请在 file-tool.jsonc 中配置 model (provider/modelId) 或 apiKey+apiBaseUrl+model", en: "Set model (provider/modelId) or apiKey+apiBaseUrl+model in file-tool.jsonc" },
     meta_failed: { zh: "分析失败", en: "Failed" },
     meta_skip: { zh: "跳过", en: "Skip" },
@@ -42,12 +45,18 @@ const TX = {
     meta_image: { zh: "图片", en: "Image" },
     meta_error: { zh: "分析出错", en: "Error" },
     no_cache: { zh: "[] (无缓存)", en: "[] (no cache)" },
+    enabled: { zh: "已启用", en: "Enabled" },
+    disabled: { zh: "已禁用", en: "Disabled" },
+    status: { zh: "图片缓存: {s}\n视觉模型: {m}", en: "Image cache: {s}\nVision model: {m}" },
+    status_cmd: { zh: "查看缓存开关状态", en: "Show cache status" },
     vision_prompt_default: { zh: "请详细描述这张图片的内容，返回格式: [文件名] 描述", en: "Describe this image in detail, format: [filename] description" },
     err_resolve_config: { zh: "无法解析模型配置: {model}。请在 file-tool.jsonc 中配置 model (provider/modelId) 或 apiKey+apiBaseUrl+model", en: "Cannot resolve model config: {model}. Set model (provider/modelId) or apiKey+apiBaseUrl+model in file-tool.jsonc" },
     err_api: { zh: "API {status}: {msg}", en: "API {status}: {msg}" },
     empty_response: { zh: "(空)", en: "(empty)" },
+    uncached: { zh: "未缓存", en: "uncached" },
+    uncached_hint: { zh: "文件未缓存（id={id}），请先启用缓存再操作", en: "File not cached (id={id}), enable cache first" },
     cmd_desc: { zh: "切换视觉分析模型", en: "Switch vision analysis model" },
-    cmd_template: { zh: "直接调用 file_tool 工具。默认 `list-provider`，`set-provider <模型名>` 切换模型，`list-cache` 查看缓存。", en: "Call file_tool tool directly. Default: `list-provider`. Use `set-provider <model>` to switch. Use `list-cache` to view cached files." },
+    cmd_template: { zh: "直接调用 file_tool 工具。`list-provider` 列出模型，`set-provider <模型名>` 切换模型，`list-cache` 查看缓存，`enable/disable` 临时开关，`enable-save/disable-save` 持久化开关，`status` 查看状态。", en: "Call file_tool tool directly. `list-provider` list models, `set-provider <model>` switch, `list-cache` view cache, `enable/disable` temp toggle, `enable-save/disable-save` persist toggle, `status` show state." },
 };
 const T = (key, params) => {
     const entry = TX[key] || { zh: key, en: key };
@@ -67,9 +76,16 @@ function loadCfg() {
     _cfg = resolveConfig(raw);
     MAX_CACHE_MSGS = (raw.maxCacheMessages > 0) ? raw.maxCacheMessages : 3;
     LANG = (raw.lang === "zh" ? "zh" : "en");
+    ENABLED = raw.enabled !== false;
     return _cfg;
 }
 function reloadCfg() { loadCfg(); }
+function writeCfgField(key, value) {
+    const cfg = existsSync(CONFIG_PATH) ? readJsonc(CONFIG_PATH) : {};
+    cfg[key] = value;
+    writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2));
+    reloadCfg();
+}
 try {
     loadCfg();
 }
@@ -82,12 +98,12 @@ const DESC = {
         en: "Analyze images with multimodal model. Call file_tool list-cache first to get file IDs, then use file_id:N.",
     },
     file_tool: {
-        zh: "文件缓存管理。当你在上下文中看到 [Image N] 或收到 Cannot read 图片错误时，立即调 list-cache 获取文件ID，再用 analyze_image file_id:N 分析。",
-        en: "File cache manager. When you see [Image N] or a Cannot read image error, call list-cache to get file IDs, then use analyze_image file_id:N.",
+        zh: "文件缓存管理。当你在上下文中看到 [Image N] 或收到 Cannot read 图片错误时，立即调 list-cache 获取文件ID，再用 analyze_image file_id:N 分析。主模型能直接读取图片时建议用 `disable` 关闭缓存。",
+        en: "File cache manager. When you see [Image N] or a Cannot read image error, call list-cache to get file IDs, then use analyze_image file_id:N. If the main model can read images directly, use `disable` to turn off caching.",
     },
     file_tool_args: {
-        zh: "list-cache, list-cache main, list-provider, set-provider <model>",
-        en: "list-cache, list-cache main, list-provider, set-provider <model>",
+        zh: "list-cache [all|N|main|main N], list-provider, set-provider <model>, enable/disable（临时）, enable-save/disable-save（持久化）, status — list-cache 查看缓存(不参数=最近1条,all=全部,N=最近N条,main=主会话,main N=主会话最近N条)",
+        en: "list-cache [all|N|main|main N], list-provider, set-provider <model>, enable/disable (temp), enable-save/disable-save (persist), status — list-cache: no arg=last 1, all=all, N=last N, main=root, main N=last N from root",
     },
     analyze_args_source: { zh: "file_path=file_id:N", en: "file_path=file_id:N" },
     analyze_args_data: { zh: "file_id:N 或 base64", en: "file_id:N or base64" },
@@ -215,6 +231,22 @@ function deleteSession(sid) {
     if (existsSync(dir))
         rmSync(dir, { recursive: true, force: true });
 }
+function removeMsgCache(sid, msgId) {
+    const data = readSession(sid);
+    const idx = data.messages.findIndex(m => m.msgId === msgId);
+    if (idx < 0) {
+        log.info(`${sid}: msg ${msgId.slice(-8)} not in cache, skip`);
+        return;
+    }
+    const [msg] = data.messages.splice(idx, 1);
+    for (const fid of msg.fileIds) {
+        delete data.files[fid];
+        const path = join(filesDir(sid), fid + ".b64");
+        rm(path, { force: true }).catch(() => { });
+    }
+    log.info(`${sid}: removed msg ${msgId.slice(-8)} (${msg.fileIds.length} files: ${msg.fileIds.join(", ")})`);
+    writeSession(sid, data);
+}
 // V1 export：工具 + 事件
 export const FileTool = async () => {
     log.loaded();
@@ -249,14 +281,17 @@ export const FileTool = async () => {
                 const part = props?.part;
                 if (part?.type === "file" && (part?.mime || "").startsWith("image/")) {
                     const fn = (part.filename || part.name || "");
-                    if (fn) {
-                        const data = readSession(sid || "");
-                        if (!sid)
-                            return;
+                    if (fn && sid) {
+                        const data = readSession(sid);
                         const fid = data.nextId++;
                         const msgId = (part.messageID || "");
-                        data.files[fid] = { id: fid, filename: fn, mime: part.mime, msgId };
-                        writeFileData(sid, fid, (part.url || ""));
+                        data.files[fid] = { id: fid, filename: fn, mime: part.mime, msgId, cached: ENABLED };
+                        if (ENABLED) {
+                            writeFileData(sid, fid, (part.url || ""));
+                            log.info(`${sid}: cached ${fn} as #${fid}`);
+                        }
+                        else
+                            log.info(`${sid}: skip cache ${fn} (disabled)`);
                         const msgs = data.messages;
                         const last = msgs[msgs.length - 1];
                         if (last && last.msgId === msgId) {
@@ -269,6 +304,18 @@ export const FileTool = async () => {
                     }
                 }
             }
+            if (event.type === "message.removed" && sid) {
+                const msgId = props?.messageID || "";
+                log.info(`${sid}: message.removed msgId=${msgId.slice(-8) || "(empty)"}`);
+                if (msgId)
+                    removeMsgCache(sid, msgId);
+            }
+            if (event.type === "message.part.removed" && sid) {
+                const msgId = props?.messageID || props?.info?.id || "";
+                log.info(`${sid}: message.part.removed msgId=${msgId.slice(-8) || "(empty)"}`);
+                if (msgId)
+                    removeMsgCache(sid, msgId);
+            }
         },
         tool: {
             analyze_image: tool({
@@ -288,6 +335,10 @@ export const FileTool = async () => {
                             return T("file_id_not_found", { id: String(fid) });
                         }
                         const file = found.file;
+                        if (!file.cached) {
+                            context.metadata?.({ title: T("meta_skip") });
+                            return T("uncached_hint", { id: String(fid) });
+                        }
                         if (!file.mime.startsWith("image/")) {
                             context.metadata?.({ title: T("meta_skip") });
                             return T("not_an_image", { name: file.filename, mime: file.mime });
@@ -363,6 +414,26 @@ export const FileTool = async () => {
                         reloadCfg();
                         return T("model_switched", { model });
                     }
+                    if (cmd === "disable") {
+                        ENABLED = false;
+                        return T("disabled");
+                    }
+                    if (cmd === "enable") {
+                        ENABLED = true;
+                        return T("enabled");
+                    }
+                    if (cmd === "disable-save") {
+                        writeCfgField("enabled", false);
+                        return T("disabled");
+                    }
+                    if (cmd === "enable-save") {
+                        writeCfgField("enabled", true);
+                        return T("enabled");
+                    }
+                    if (cmd === "status") {
+                        const cfg = existsSync(CONFIG_PATH) ? readJsonc(CONFIG_PATH) : {};
+                        return T("status", { s: ENABLED ? T("enabled") : T("disabled"), m: cfg.model || T("model_not_set") });
+                    }
                     if (cmd === "list-cache" || cmd.startsWith("list-cache ")) {
                         const arg = cmd === "list-cache" ? "1" : cmd.slice(11).trim();
                         let targetSid = context.sessionID;
@@ -392,7 +463,7 @@ export const FileTool = async () => {
                             for (const fid of msg.fileIds) {
                                 const f = data.files[fid];
                                 if (f)
-                                    out += `    ${f.filename}: ${f.id}\n`;
+                                    out += `    ${f.filename}: ${f.id}${f.cached ? "" : ` (${T("uncached")})`}\n`;
                             }
                         }
                         return out.trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaoqiong0v0/opencode-file-tool",
-  "version": "1.0.5",
+  "version": "1.0.8",
   "type": "module",
   "description": "File cache & image analysis plugin for OpenCode. Auto-caches pasted images, analyzes via multimodal model.",
   "files": [
@@ -12,7 +12,7 @@
     ".": "./dist/file-tool.js"
   },
   "scripts": {
-    "build": "tsc && node -e \"try{require('fs').copyFileSync('dist/file-tool.js', '.opencode/plugins/file-tool.js')}catch{}\"",
+    "build": "tsc",
     "prepublishOnly": "npm run build"
   },
   "repository": {