opencode-gbk-tools 0.1.11 → 0.1.13

package/README.md

@@ -52,6 +52,7 @@ npx opencode-gbk-tools uninstall
   - 原编码
   - BOM
   - 换行风格
+- 新文件在 `encoding=auto` 下不会自动默认成 `utf8`，需要显式指定 `encoding`
 - 当前支持：
   - `utf8`
   - `utf8-bom`
@@ -194,6 +195,8 @@ A：不要。现在优先用 `mode="insertAfter"` 或 `mode="insertBefore"`，
 
 | 版本 | 说明 |
 |------|------|
+| 0.1.13 | `text_write` 在新文件 + `encoding=auto` 下改为显式报错，不再静默默认 `utf8`；同时优化 `text_read` 流式读取与 `text_edit` 预览生成，减少重复读取 |
+| 0.1.12 | 仅提升发布版本号，用于重新发布当前 `0.1.11` 的稳定内容 |
 | 0.1.11 | `text_edit` / `gbk_edit` 新增 `insertAfter` / `insertBefore`，插入内容不再依赖 `oldString`；README 与全局提示同步改为“插入优先用 anchor/content” |
 | 0.1.10 | 新增 `text_read` / `text_write` / `text_edit`，自动识别并保持原编码、BOM 与换行风格；同时通过 plugin 规则让所有 agents 默认优先使用 `text_*` |
 | 0.1.9 | `gbk_edit` 修复精确匹配路径写入 CRLF 文件时换行风格变 mixed 的 bug |

package/dist/opencode-tools/text_edit.js

@@ -16240,6 +16240,8 @@ tool.schema = external_exports;
 
 // src/lib/text-file.ts
 var import_iconv_lite2 = __toESM(require_lib(), 1);
+import crypto2 from "crypto";
+import { createReadStream as createReadStream2 } from "fs";
 import fs3 from "fs/promises";
 import path3 from "path";
 
@@ -16360,6 +16362,7 @@ function countOccurrences(text, target) {
 
 // src/lib/text-file.ts
 var TEXT_STREAMING_FILE_SIZE_THRESHOLD_BYTES = 1024 * 1024;
+var TEXT_DETECTION_SAMPLE_BYTES = 64 * 1024;
 var UTF8_DECODER = new TextDecoder("utf-8", { fatal: true });
 function assertStringArgument2(value, name) {
   if (typeof value !== "string") {
@@ -16380,6 +16383,21 @@ function resolveExplicitTextEncoding(value, fallback) {
   const requested = value ?? "auto";
   return requested === "auto" ? fallback : requested;
 }
+function getBomPrefix(encoding, hasBom) {
+  if (!hasBom) {
+    return Buffer.alloc(0);
+  }
+  if (encoding === "utf8-bom") {
+    return Buffer.from([239, 187, 191]);
+  }
+  if (encoding === "utf16le") {
+    return Buffer.from([255, 254]);
+  }
+  if (encoding === "utf16be") {
+    return Buffer.from([254, 255]);
+  }
+  return Buffer.alloc(0);
+}
 function isSupportedEncoding(value) {
   return value === "utf8" || value === "utf8-bom" || value === "utf16le" || value === "utf16be" || value === "gbk" || value === "gb18030";
 }
@@ -16391,23 +16409,23 @@ function assertTextEncodingSupported(encoding) {
 function decodeUtf16be(buffer) {
   return import_iconv_lite2.default.decode(buffer, "utf16be");
 }
-function encodeText(content, encoding, hasBom = encoding === "utf8-bom") {
-  if (encoding === "utf8") {
+function encodeTextBody(content, encoding) {
+  if (encoding === "utf8" || encoding === "utf8-bom") {
     return Buffer.from(content, "utf8");
   }
-  if (encoding === "utf8-bom") {
-    return Buffer.concat([Buffer.from([239, 187, 191]), Buffer.from(content, "utf8")]);
-  }
   if (encoding === "utf16le") {
-    const body = Buffer.from(content, "utf16le");
-    return hasBom ? Buffer.concat([Buffer.from([255, 254]), body]) : body;
+    return Buffer.from(content, "utf16le");
   }
   if (encoding === "utf16be") {
-    const body = import_iconv_lite2.default.encode(content, "utf16be");
-    return hasBom ? Buffer.concat([Buffer.from([254, 255]), body]) : body;
+    return import_iconv_lite2.default.encode(content, "utf16be");
   }
   return import_iconv_lite2.default.encode(content, encoding);
 }
+function encodeText(content, encoding, hasBom = encoding === "utf8-bom") {
+  const bom = getBomPrefix(encoding, hasBom);
+  const body = encodeTextBody(content, encoding);
+  return bom.length === 0 ? body : Buffer.concat([bom, body]);
+}
 function decodeText(buffer, encoding) {
   if (encoding === "utf8") {
     return buffer.toString("utf8");
@@ -16683,6 +16701,30 @@ async function resolveReadableTextFile(input) {
   }
   return { filePath: candidatePath, stat };
 }
+async function readDetectionBuffer(filePath, sampleSize = TEXT_DETECTION_SAMPLE_BYTES) {
+  const handle = await fs3.open(filePath, "r");
+  try {
+    const buffer = Buffer.alloc(sampleSize);
+    const { bytesRead } = await handle.read(buffer, 0, sampleSize, 0);
+    return buffer.subarray(0, bytesRead);
+  } finally {
+    await handle.close();
+  }
+}
+async function detectReadableTextFile(input) {
+  const resolved = await resolveReadableTextFile(input);
+  const sample = await readDetectionBuffer(resolved.filePath);
+  assertLikelyTextBuffer(sample);
+  const detected = detectTextEncodingFromBuffer(sample, input.encoding ?? "auto");
+  return {
+    ...resolved,
+    encoding: detected.detectedEncoding,
+    requestedEncoding: detected.requestedEncoding,
+    detectedEncoding: detected.detectedEncoding,
+    confidence: detected.confidence,
+    hasBom: detected.hasBom
+  };
+}
 async function readWholeTextFile(input) {
   const resolved = await resolveReadableTextFile(input);
   try {
@@ -16819,70 +16861,84 @@ async function replaceTextFileText(input) {
     startLine: normalizeOptionalPositiveInteger(input.startLine, "startLine"),
     endLine: normalizeOptionalPositiveInteger(input.endLine, "endLine")
   };
-  const loaded = await readWholeTextFile({
-    filePath: input.filePath,
-    encoding: input.encoding ?? "auto",
-    allowExternal: input.allowExternal,
-    context: input.context
-  });
   if (mode === "insertAfter" || mode === "insertBefore") {
+    const loaded2 = await readWholeTextFile({
+      filePath: input.filePath,
+      encoding: input.encoding ?? "auto",
+      allowExternal: input.allowExternal,
+      context: input.context
+    });
     assertInsertArguments(normalizedInput);
     const occurrence = normalizeOptionalPositiveInteger(normalizedInput.occurrence, "occurrence") ?? 1;
     const insertResult = buildInsertOutput(
-      loaded.content,
+      loaded2.content,
       mode,
       normalizedInput.anchor,
       normalizedInput.content,
       occurrence,
       resolveInsertIfExists(normalizedInput.ifExists),
-      loaded.newlineStyle
+      loaded2.newlineStyle
     );
     if (insertResult.skipped) {
       return {
         mode,
-        filePath: loaded.filePath,
-        encoding: loaded.encoding,
-        requestedEncoding: loaded.requestedEncoding,
-        detectedEncoding: loaded.detectedEncoding,
-        confidence: loaded.confidence,
-        hasBom: loaded.hasBom,
+        filePath: loaded2.filePath,
+        encoding: loaded2.encoding,
+        requestedEncoding: loaded2.requestedEncoding,
+        detectedEncoding: loaded2.detectedEncoding,
+        confidence: loaded2.confidence,
+        hasBom: loaded2.hasBom,
         anchor: insertResult.anchor,
         occurrence: insertResult.occurrence,
         anchorMatches: insertResult.anchorMatches,
         inserted: false,
         skipped: true,
-        bytesRead: loaded.bytesRead,
+        bytesRead: loaded2.bytesRead,
         bytesWritten: 0,
-        newlineStyle: loaded.newlineStyle
+        newlineStyle: loaded2.newlineStyle,
+        diffPreview: buildLineDiffPreview(loaded2.filePath, loaded2.encoding, insertResult.previewBefore, insertResult.previewAfter)
       };
     }
-    const targetEncoding2 = (normalizedInput.preserveEncoding ?? true) || (normalizedInput.encoding ?? "auto") === "auto" ? loaded.encoding : resolveExplicitTextEncoding(normalizedInput.encoding, loaded.encoding);
-    const targetHasBom2 = normalizedInput.preserveEncoding === false ? targetEncoding2 === "utf8-bom" || targetEncoding2 === "utf16le" || targetEncoding2 === "utf16be" : loaded.hasBom;
+    const targetEncoding2 = (normalizedInput.preserveEncoding ?? true) || (normalizedInput.encoding ?? "auto") === "auto" ? loaded2.encoding : resolveExplicitTextEncoding(normalizedInput.encoding, loaded2.encoding);
+    const targetHasBom2 = normalizedInput.preserveEncoding === false ? targetEncoding2 === "utf8-bom" || targetEncoding2 === "utf16le" || targetEncoding2 === "utf16be" : loaded2.hasBom;
     ensureLossless(insertResult.outputText, targetEncoding2, targetHasBom2);
     const buffer2 = encodeText(insertResult.outputText, targetEncoding2, targetHasBom2);
-    await fs3.writeFile(loaded.filePath, buffer2);
+    await fs3.writeFile(loaded2.filePath, buffer2);
     return {
       mode,
-      filePath: loaded.filePath,
+      filePath: loaded2.filePath,
       encoding: targetEncoding2,
-      requestedEncoding: loaded.requestedEncoding,
-      detectedEncoding: loaded.detectedEncoding,
-      confidence: loaded.confidence,
+      requestedEncoding: loaded2.requestedEncoding,
+      detectedEncoding: loaded2.detectedEncoding,
+      confidence: loaded2.confidence,
       hasBom: targetHasBom2,
       anchor: insertResult.anchor,
       occurrence: insertResult.occurrence,
       anchorMatches: insertResult.anchorMatches,
       inserted: true,
       skipped: false,
-      bytesRead: loaded.bytesRead,
+      bytesRead: loaded2.bytesRead,
       bytesWritten: buffer2.byteLength,
-      newlineStyle: detectNewlineStyle(insertResult.outputText)
+      newlineStyle: detectNewlineStyle(insertResult.outputText),
+      diffPreview: buildLineDiffPreview(loaded2.filePath, targetEncoding2, insertResult.previewBefore, insertResult.previewAfter)
     };
   }
   assertReplaceArguments(input);
   if (input.oldString.length === 0) {
     throw createTextError("GBK_EMPTY_OLD_STRING", "oldString \u4E0D\u80FD\u4E3A\u7A7A");
   }
+  const resolved = await detectReadableTextFile({
+    filePath: input.filePath,
+    encoding: input.encoding ?? "auto",
+    allowExternal: input.allowExternal,
+    context: input.context
+  });
+  const loaded = await readWholeTextFile({
+    filePath: input.filePath,
+    encoding: input.encoding ?? "auto",
+    allowExternal: input.allowExternal,
+    context: input.context
+  });
   const scope = resolveEditScope(loaded.content, normalizedInput);
   const replaceAll = normalizedInput.replaceAll ?? false;
   const preserveEncoding = normalizedInput.preserveEncoding ?? true;
@@ -16917,43 +16973,8 @@ async function replaceTextFileText(input) {
     occurrencesBefore,
     bytesRead: loaded.bytesRead,
     bytesWritten: buffer.byteLength,
-    newlineStyle: detectNewlineStyle(outputText)
-  };
-}
-async function createTextDiffPreview(input) {
-  const mode = resolveEditMode(input.mode);
-  const loaded = await readWholeTextFile({
-    filePath: input.filePath,
-    encoding: input.encoding ?? "auto",
-    allowExternal: input.allowExternal,
-    context: input.context
-  });
-  if (mode === "insertAfter" || mode === "insertBefore") {
-    assertInsertArguments(input);
-    const occurrence = normalizeOptionalPositiveInteger(input.occurrence, "occurrence") ?? 1;
-    const insertResult = buildInsertOutput(
-      loaded.content,
-      mode,
-      input.anchor,
-      input.content,
-      occurrence,
-      resolveInsertIfExists(input.ifExists),
-      loaded.newlineStyle
-    );
-    return {
-      filePath: loaded.filePath,
-      encoding: loaded.encoding,
-      preview: buildLineDiffPreview(loaded.filePath, loaded.encoding, insertResult.previewBefore, insertResult.previewAfter)
-    };
-  }
-  assertReplaceArguments(input);
-  const scope = resolveEditScope(loaded.content, input);
-  const alignedNewString = alignTextToNewlineStyle(input.newString, loaded.newlineStyle);
-  const replaced = input.replaceAll ?? false ? scope.selectedText.split(input.oldString).join(alignedNewString) : scope.selectedText.replace(input.oldString, alignedNewString);
-  return {
-    filePath: loaded.filePath,
-    encoding: loaded.encoding,
-    preview: buildLineDiffPreview(loaded.filePath, loaded.encoding, scope.selectedText, replaced)
+    newlineStyle: detectNewlineStyle(outputText),
+    diffPreview: buildLineDiffPreview(loaded.filePath, targetEncoding, scope.selectedText, replaced)
   };
 }
 
@@ -16986,7 +17007,6 @@ var text_edit_default = tool({
   },
   async execute(args, context) {
     const result = await replaceTextFileText({ ...args, context });
-    const preview = await createTextDiffPreview({ ...args, context });
     const title = result.mode === "replace" ? `\u6587\u672C\u7F16\u8F91 ${result.encoding.toUpperCase()} x${result.replacements}` : result.inserted ? `\u6587\u672C\u63D2\u5165 ${result.encoding.toUpperCase()} #${result.occurrence}` : `\u6587\u672C\u8DF3\u8FC7 ${result.encoding.toUpperCase()} #${result.occurrence}`;
     context.metadata({
       title,
@@ -17005,7 +17025,7 @@ var text_edit_default = tool({
         inserted: result.mode === "replace" ? void 0 : result.inserted,
         skipped: result.mode === "replace" ? void 0 : result.skipped,
         newlineStyle: result.newlineStyle,
-        diffPreview: preview.preview
+        diffPreview: result.diffPreview ?? ""
       }
     });
     return JSON.stringify(result, null, 2);

package/dist/opencode-tools/text_read.js

@@ -16240,6 +16240,8 @@ tool.schema = external_exports;
 
 // src/lib/text-file.ts
 var import_iconv_lite2 = __toESM(require_lib(), 1);
+import crypto2 from "crypto";
+import { createReadStream as createReadStream2 } from "fs";
 import fs3 from "fs/promises";
 import path3 from "path";
 
@@ -16361,7 +16363,35 @@ function detectNewlineStyle(text) {
 
 // src/lib/text-file.ts
 var TEXT_STREAMING_FILE_SIZE_THRESHOLD_BYTES = 1024 * 1024;
+var TEXT_DETECTION_SAMPLE_BYTES = 64 * 1024;
 var UTF8_DECODER = new TextDecoder("utf-8", { fatal: true });
+function finalizeNewlineStyle(crlfCount, lfCount) {
+  if (crlfCount > 0 && lfCount === 0) {
+    return "crlf";
+  }
+  if (lfCount > 0 && crlfCount === 0) {
+    return "lf";
+  }
+  if (crlfCount > 0 && lfCount > 0) {
+    return "mixed";
+  }
+  return "none";
+}
+function getBomPrefix(encoding, hasBom) {
+  if (!hasBom) {
+    return Buffer.alloc(0);
+  }
+  if (encoding === "utf8-bom") {
+    return Buffer.from([239, 187, 191]);
+  }
+  if (encoding === "utf16le") {
+    return Buffer.from([255, 254]);
+  }
+  if (encoding === "utf16be") {
+    return Buffer.from([254, 255]);
+  }
+  return Buffer.alloc(0);
+}
 function isSupportedEncoding(value) {
   return value === "utf8" || value === "utf8-bom" || value === "utf16le" || value === "utf16be" || value === "gbk" || value === "gb18030";
 }
@@ -16373,23 +16403,23 @@ function assertTextEncodingSupported(encoding) {
 function decodeUtf16be(buffer) {
   return import_iconv_lite2.default.decode(buffer, "utf16be");
 }
-function encodeText(content, encoding, hasBom = encoding === "utf8-bom") {
-  if (encoding === "utf8") {
+function encodeTextBody(content, encoding) {
+  if (encoding === "utf8" || encoding === "utf8-bom") {
     return Buffer.from(content, "utf8");
   }
-  if (encoding === "utf8-bom") {
-    return Buffer.concat([Buffer.from([239, 187, 191]), Buffer.from(content, "utf8")]);
-  }
   if (encoding === "utf16le") {
-    const body = Buffer.from(content, "utf16le");
-    return hasBom ? Buffer.concat([Buffer.from([255, 254]), body]) : body;
+    return Buffer.from(content, "utf16le");
   }
   if (encoding === "utf16be") {
-    const body = import_iconv_lite2.default.encode(content, "utf16be");
-    return hasBom ? Buffer.concat([Buffer.from([254, 255]), body]) : body;
+    return import_iconv_lite2.default.encode(content, "utf16be");
   }
   return import_iconv_lite2.default.encode(content, encoding);
 }
+function encodeText(content, encoding, hasBom = encoding === "utf8-bom") {
+  const bom = getBomPrefix(encoding, hasBom);
+  const body = encodeTextBody(content, encoding);
+  return bom.length === 0 ? body : Buffer.concat([bom, body]);
+}
 function decodeText(buffer, encoding) {
   if (encoding === "utf8") {
     return buffer.toString("utf8");
@@ -16543,6 +16573,169 @@ async function resolveReadableTextFile(input) {
   }
   return { filePath: candidatePath, stat };
 }
+async function readDetectionBuffer(filePath, sampleSize = TEXT_DETECTION_SAMPLE_BYTES) {
+  const handle = await fs3.open(filePath, "r");
+  try {
+    const buffer = Buffer.alloc(sampleSize);
+    const { bytesRead } = await handle.read(buffer, 0, sampleSize, 0);
+    return buffer.subarray(0, bytesRead);
+  } finally {
+    await handle.close();
+  }
+}
+async function detectReadableTextFile(input) {
+  const resolved = await resolveReadableTextFile(input);
+  const sample = await readDetectionBuffer(resolved.filePath);
+  assertLikelyTextBuffer(sample);
+  const detected = detectTextEncodingFromBuffer(sample, input.encoding ?? "auto");
+  return {
+    ...resolved,
+    encoding: detected.detectedEncoding,
+    requestedEncoding: detected.requestedEncoding,
+    detectedEncoding: detected.detectedEncoding,
+    confidence: detected.confidence,
+    hasBom: detected.hasBom
+  };
+}
+function createLineCollector(offset, limit) {
+  const lines = [];
+  let pending = "";
+  let totalLines = 0;
+  let crlfCount = 0;
+  let lfCount = 0;
+  const emitLine = (line) => {
+    totalLines += 1;
+    if (totalLines >= offset && lines.length < limit) {
+      lines.push(`${totalLines}: ${line}`);
+    }
+  };
+  return {
+    push(text) {
+      if (text.length === 0) {
+        return;
+      }
+      const combined = pending + text;
+      let start = 0;
+      while (true) {
+        const newlineIndex = combined.indexOf("\n", start);
+        if (newlineIndex === -1) {
+          break;
+        }
+        let line = combined.slice(start, newlineIndex);
+        if (line.endsWith("\r")) {
+          line = line.slice(0, -1);
+          crlfCount += 1;
+        } else {
+          lfCount += 1;
+        }
+        emitLine(line);
+        start = newlineIndex + 1;
+      }
+      pending = combined.slice(start);
+    },
+    finish() {
+      emitLine(pending);
+      return {
+        startLine: offset,
+        endLine: lines.length === 0 ? totalLines : offset + lines.length - 1,
+        totalLines,
+        content: lines.join("\n"),
+        tail: false,
+        truncated: (lines.length === 0 ? totalLines : offset + lines.length - 1) < totalLines,
+        newlineStyle: finalizeNewlineStyle(crlfCount, lfCount)
+      };
+    }
+  };
+}
+function createTailCollector(limit) {
+  assertPositiveInteger(limit, "limit");
+  const lines = [];
+  let pending = "";
+  let totalLines = 0;
+  let crlfCount = 0;
+  let lfCount = 0;
+  const emitLine = (line) => {
+    totalLines += 1;
+    lines.push(line);
+    if (lines.length > limit) {
+      lines.shift();
+    }
+  };
+  return {
+    push(text) {
+      if (text.length === 0) {
+        return;
+      }
+      const combined = pending + text;
+      let start = 0;
+      while (true) {
+        const newlineIndex = combined.indexOf("\n", start);
+        if (newlineIndex === -1) {
+          break;
+        }
+        let line = combined.slice(start, newlineIndex);
+        if (line.endsWith("\r")) {
+          line = line.slice(0, -1);
+          crlfCount += 1;
+        } else {
+          lfCount += 1;
+        }
+        emitLine(line);
+        start = newlineIndex + 1;
+      }
+      pending = combined.slice(start);
+    },
+    finish() {
+      emitLine(pending);
+      const startLine = Math.max(1, totalLines - lines.length + 1);
+      return {
+        startLine,
+        endLine: totalLines,
+        totalLines,
+        content: lines.map((line, index) => `${startLine + index}: ${line}`).join("\n"),
+        truncated: startLine > 1,
+        tail: true,
+        newlineStyle: finalizeNewlineStyle(crlfCount, lfCount)
+      };
+    }
+  };
+}
+async function visitDecodedTextChunks(resolved, visitor) {
+  const stream = createReadStream2(resolved.filePath);
+  const bomLength = getBomPrefix(resolved.encoding, resolved.hasBom).length;
+  const decoderEncoding = resolved.encoding === "utf8-bom" ? "utf8" : resolved.encoding;
+  const decoder = import_iconv_lite2.default.getDecoder(decoderEncoding);
+  let skippedBom = false;
+  try {
+    for await (const chunk of stream) {
+      let buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+      if (!skippedBom && bomLength > 0) {
+        buffer = buffer.subarray(Math.min(bomLength, buffer.length));
+        skippedBom = true;
+      } else {
+        skippedBom = true;
+      }
+      if (buffer.length === 0) {
+        continue;
+      }
+      const text = decoder.write(buffer);
+      if (text.length > 0) {
+        await visitor(text);
+      }
+    }
+    const trailingText = decoder.end() ?? "";
+    if (trailingText.length > 0) {
+      await visitor(trailingText);
+    }
+  } catch (error45) {
+    if (error45 instanceof Error && "code" in error45) {
+      throw error45;
+    }
+    throw createTextError("GBK_IO_ERROR", `\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25: ${resolved.filePath}`, error45);
+  } finally {
+    stream.destroy();
+  }
+}
 async function readWholeTextFile(input) {
   const resolved = await resolveReadableTextFile(input);
   try {
@@ -16588,26 +16781,46 @@ async function readTextFile(input) {
   const offset = normalizeOptionalPositiveInteger(input.offset, "offset") ?? 1;
   const limit = normalizeOptionalPositiveInteger(input.limit, "limit") ?? 2e3;
   const tail = input.tail ?? false;
-  const loaded = await readWholeTextFile(input);
-  const lineWindow = tail ? collectTailLines(loaded.content, limit) : {
-    ...splitLinesWithNumbers(loaded.content, offset, limit),
-    tail: false,
-    truncated: false
-  };
-  if (!tail) {
-    lineWindow.truncated = lineWindow.endLine < lineWindow.totalLines;
+  const resolved = await detectReadableTextFile(input);
+  if (resolved.stat.size < TEXT_STREAMING_FILE_SIZE_THRESHOLD_BYTES) {
+    const loaded = await readWholeTextFile(input);
+    const lineWindow2 = tail ? collectTailLines(loaded.content, limit) : {
+      ...splitLinesWithNumbers(loaded.content, offset, limit),
+      tail: false,
+      truncated: false
+    };
+    if (!tail) {
+      lineWindow2.truncated = lineWindow2.endLine < lineWindow2.totalLines;
+    }
+    return {
+      filePath: loaded.filePath,
+      encoding: loaded.encoding,
+      requestedEncoding: loaded.requestedEncoding,
+      detectedEncoding: loaded.detectedEncoding,
+      confidence: loaded.confidence,
+      hasBom: loaded.hasBom,
+      bytesRead: loaded.bytesRead,
+      fileSize: loaded.fileSize,
+      streamed: false,
+      newlineStyle: loaded.newlineStyle,
+      ...lineWindow2
+    };
   }
+  const collector = tail ? createTailCollector(limit) : createLineCollector(offset, limit);
+  await visitDecodedTextChunks(resolved, (text) => {
+    collector.push(text);
+  });
+  const lineWindow = collector.finish();
   return {
-    filePath: loaded.filePath,
-    encoding: loaded.encoding,
-    requestedEncoding: loaded.requestedEncoding,
-    detectedEncoding: loaded.detectedEncoding,
-    confidence: loaded.confidence,
-    hasBom: loaded.hasBom,
-    bytesRead: loaded.bytesRead,
-    fileSize: loaded.fileSize,
-    streamed: false,
-    newlineStyle: loaded.newlineStyle,
+    filePath: resolved.filePath,
+    encoding: resolved.encoding,
+    requestedEncoding: resolved.requestedEncoding,
+    detectedEncoding: resolved.detectedEncoding,
+    confidence: resolved.confidence,
+    hasBom: resolved.hasBom,
+    bytesRead: resolved.stat.size,
+    fileSize: resolved.stat.size,
+    streamed: true,
     ...lineWindow
   };
 }

package/dist/opencode-tools/text_write.js

@@ -16240,6 +16240,8 @@ tool.schema = external_exports;
 
 // src/lib/text-file.ts
 var import_iconv_lite2 = __toESM(require_lib(), 1);
+import crypto2 from "crypto";
+import { createReadStream as createReadStream2 } from "fs";
 import fs3 from "fs/promises";
 import path3 from "path";
 
@@ -16326,12 +16328,32 @@ function detectNewlineStyle(text) {
 
 // src/lib/text-file.ts
 var TEXT_STREAMING_FILE_SIZE_THRESHOLD_BYTES = 1024 * 1024;
+var TEXT_DETECTION_SAMPLE_BYTES = 64 * 1024;
 var UTF8_DECODER = new TextDecoder("utf-8", { fatal: true });
 function assertStringArgument(value, name) {
   if (typeof value !== "string") {
     throw createTextError("GBK_INVALID_ARGUMENT", `${name} \u5FC5\u987B\u662F\u5B57\u7B26\u4E32`);
   }
 }
+function resolveExplicitTextEncoding(value, fallback) {
+  const requested = value ?? "auto";
+  return requested === "auto" ? fallback : requested;
+}
+function getBomPrefix(encoding, hasBom) {
+  if (!hasBom) {
+    return Buffer.alloc(0);
+  }
+  if (encoding === "utf8-bom") {
+    return Buffer.from([239, 187, 191]);
+  }
+  if (encoding === "utf16le") {
+    return Buffer.from([255, 254]);
+  }
+  if (encoding === "utf16be") {
+    return Buffer.from([254, 255]);
+  }
+  return Buffer.alloc(0);
+}
 function isSupportedEncoding(value) {
   return value === "utf8" || value === "utf8-bom" || value === "utf16le" || value === "utf16be" || value === "gbk" || value === "gb18030";
 }
@@ -16343,23 +16365,23 @@ function assertTextEncodingSupported(encoding) {
 function decodeUtf16be(buffer) {
   return import_iconv_lite2.default.decode(buffer, "utf16be");
 }
-function encodeText(content, encoding, hasBom = encoding === "utf8-bom") {
-  if (encoding === "utf8") {
+function encodeTextBody(content, encoding) {
+  if (encoding === "utf8" || encoding === "utf8-bom") {
     return Buffer.from(content, "utf8");
   }
-  if (encoding === "utf8-bom") {
-    return Buffer.concat([Buffer.from([239, 187, 191]), Buffer.from(content, "utf8")]);
-  }
   if (encoding === "utf16le") {
-    const body = Buffer.from(content, "utf16le");
-    return hasBom ? Buffer.concat([Buffer.from([255, 254]), body]) : body;
+    return Buffer.from(content, "utf16le");
   }
   if (encoding === "utf16be") {
-    const body = import_iconv_lite2.default.encode(content, "utf16be");
-    return hasBom ? Buffer.concat([Buffer.from([254, 255]), body]) : body;
+    return import_iconv_lite2.default.encode(content, "utf16be");
   }
   return import_iconv_lite2.default.encode(content, encoding);
 }
+function encodeText(content, encoding, hasBom = encoding === "utf8-bom") {
+  const bom = getBomPrefix(encoding, hasBom);
+  const body = encodeTextBody(content, encoding);
+  return bom.length === 0 ? body : Buffer.concat([bom, body]);
+}
 function decodeText(buffer, encoding) {
   if (encoding === "utf8") {
     return buffer.toString("utf8");
@@ -16603,7 +16625,10 @@ async function writeTextFile(input) {
   if (existing && !append && !overwrite) {
     throw createTextError("GBK_FILE_EXISTS", `\u76EE\u6807\u6587\u4EF6\u5DF2\u5B58\u5728: ${candidatePath}`);
   }
-  const targetEncoding = existing && preserveEncoding ? existing.encoding : requestedEncoding === "auto" ? "utf8" : requestedEncoding;
+  if (!existing && requestedEncoding === "auto") {
+    throw createTextError("TEXT_UNKNOWN_ENCODING", "\u65B0\u6587\u4EF6\u5728 encoding=auto \u4E0B\u65E0\u6CD5\u786E\u5B9A\u7F16\u7801\uFF0C\u8BF7\u663E\u5F0F\u6307\u5B9A encoding");
+  }
+  const targetEncoding = existing && preserveEncoding ? existing.encoding : resolveExplicitTextEncoding(requestedEncoding, existing?.encoding ?? "utf8");
   const targetHasBom = targetEncoding === "utf8-bom" ? true : existing && preserveEncoding ? existing.hasBom : targetEncoding === "utf16le" || targetEncoding === "utf16be" ? true : false;
   const baseContent = append ? existing?.content ?? "" : "";
   const rawContent = `${baseContent}${input.content}`;
@@ -16631,7 +16656,7 @@ var text_write_default = tool({
   description: `Write text files while preserving detected encoding and newline style by default.
 
 - Existing files keep their original encoding when encoding=auto.
-- New files default to utf8 unless encoding is specified.
+- New files require explicit encoding when encoding=auto.
 - Supports append and overwrite modes.`,
   args: {
     filePath: tool.schema.string().describe("Target file path"),

package/dist/plugin/index.js

@@ -17409,6 +17409,7 @@ var TEXT_TOOL_SYSTEM_PROMPT = [
   "\u6587\u672C\u6587\u4EF6\u5904\u7406\u89C4\u5219\uFF1A",
   "- \u5904\u7406\u6587\u672C\u6587\u4EF6\u65F6\uFF0C\u4F18\u5148\u4F7F\u7528 text_read\u3001text_write\u3001text_edit\u3002",
   "- text_* \u9ED8\u8BA4\u4F1A\u81EA\u52A8\u8BC6\u522B\u73B0\u6709\u6587\u4EF6\u7F16\u7801\uFF0C\u5E76\u5728\u4FEE\u6539\u65F6\u5C3D\u91CF\u4FDD\u6301\u539F\u7F16\u7801\u3001BOM \u548C\u6362\u884C\u98CE\u683C\u3002",
+  "- \u65B0\u6587\u4EF6\u5728 encoding=auto \u4E0B\u4E0D\u4F1A\u9759\u9ED8\u9ED8\u8BA4\u6210 utf8\uFF1B\u8BF7\u663E\u5F0F\u6307\u5B9A encoding\u3002",
   "- \u5982\u679C\u610F\u56FE\u662F\u2018\u5728\u67D0\u6807\u7B7E\u524D\u540E\u63D2\u5165\u5185\u5BB9\u2019\uFF0C\u4F18\u5148\u4F7F\u7528 mode=insertAfter \u6216 mode=insertBefore\uFF0C\u5E76\u4F20 anchor/content\u3002",
   "- \u53EA\u6709\u5728\u660E\u786E\u505A\u7CBE\u786E\u66FF\u6362\u65F6\uFF0C\u624D\u4F7F\u7528 oldString/newString\u3002",
   "- \u82E5\u68C0\u6D4B\u7F6E\u4FE1\u5EA6\u4E0D\u8DB3\u6216\u51FA\u73B0 TEXT_UNKNOWN_ENCODING\uFF0C\u8BF7\u663E\u5F0F\u6307\u5B9A encoding \u540E\u91CD\u8BD5\u3002",
@@ -17423,10 +17424,25 @@ function appendTextToolSystemPrompt(system) {
 
 // src/lib/text-file.ts
 var import_iconv_lite2 = __toESM(require_lib(), 1);
+import crypto2 from "crypto";
+import { createReadStream as createReadStream2 } from "fs";
 import fs3 from "fs/promises";
 import path3 from "path";
 var TEXT_STREAMING_FILE_SIZE_THRESHOLD_BYTES = 1024 * 1024;
+var TEXT_DETECTION_SAMPLE_BYTES = 64 * 1024;
 var UTF8_DECODER = new TextDecoder("utf-8", { fatal: true });
+function finalizeNewlineStyle2(crlfCount, lfCount) {
+  if (crlfCount > 0 && lfCount === 0) {
+    return "crlf";
+  }
+  if (lfCount > 0 && crlfCount === 0) {
+    return "lf";
+  }
+  if (crlfCount > 0 && lfCount > 0) {
+    return "mixed";
+  }
+  return "none";
+}
 function assertStringArgument2(value, name) {
   if (typeof value !== "string") {
     throw createTextError("GBK_INVALID_ARGUMENT", `${name} \u5FC5\u987B\u662F\u5B57\u7B26\u4E32`);
@@ -17446,6 +17462,21 @@ function resolveExplicitTextEncoding(value, fallback) {
   const requested = value ?? "auto";
   return requested === "auto" ? fallback : requested;
 }
+function getBomPrefix(encoding, hasBom) {
+  if (!hasBom) {
+    return Buffer.alloc(0);
+  }
+  if (encoding === "utf8-bom") {
+    return Buffer.from([239, 187, 191]);
+  }
+  if (encoding === "utf16le") {
+    return Buffer.from([255, 254]);
+  }
+  if (encoding === "utf16be") {
+    return Buffer.from([254, 255]);
+  }
+  return Buffer.alloc(0);
+}
 function isSupportedEncoding(value) {
   return value === "utf8" || value === "utf8-bom" || value === "utf16le" || value === "utf16be" || value === "gbk" || value === "gb18030";
 }
@@ -17457,23 +17488,23 @@ function assertTextEncodingSupported(encoding) {
 function decodeUtf16be(buffer) {
   return import_iconv_lite2.default.decode(buffer, "utf16be");
 }
-function encodeText(content, encoding, hasBom = encoding === "utf8-bom") {
-  if (encoding === "utf8") {
+function encodeTextBody(content, encoding) {
+  if (encoding === "utf8" || encoding === "utf8-bom") {
     return Buffer.from(content, "utf8");
   }
-  if (encoding === "utf8-bom") {
-    return Buffer.concat([Buffer.from([239, 187, 191]), Buffer.from(content, "utf8")]);
-  }
   if (encoding === "utf16le") {
-    const body = Buffer.from(content, "utf16le");
-    return hasBom ? Buffer.concat([Buffer.from([255, 254]), body]) : body;
+    return Buffer.from(content, "utf16le");
   }
   if (encoding === "utf16be") {
-    const body = import_iconv_lite2.default.encode(content, "utf16be");
-    return hasBom ? Buffer.concat([Buffer.from([254, 255]), body]) : body;
+    return import_iconv_lite2.default.encode(content, "utf16be");
   }
   return import_iconv_lite2.default.encode(content, encoding);
 }
+function encodeText(content, encoding, hasBom = encoding === "utf8-bom") {
+  const bom = getBomPrefix(encoding, hasBom);
+  const body = encodeTextBody(content, encoding);
+  return bom.length === 0 ? body : Buffer.concat([bom, body]);
+}
 function decodeText(buffer, encoding) {
   if (encoding === "utf8") {
     return buffer.toString("utf8");
@@ -17749,6 +17780,169 @@ async function resolveReadableTextFile(input) {
   }
   return { filePath: candidatePath, stat };
 }
+async function readDetectionBuffer(filePath, sampleSize = TEXT_DETECTION_SAMPLE_BYTES) {
+  const handle = await fs3.open(filePath, "r");
+  try {
+    const buffer = Buffer.alloc(sampleSize);
+    const { bytesRead } = await handle.read(buffer, 0, sampleSize, 0);
+    return buffer.subarray(0, bytesRead);
+  } finally {
+    await handle.close();
+  }
+}
+async function detectReadableTextFile(input) {
+  const resolved = await resolveReadableTextFile(input);
+  const sample = await readDetectionBuffer(resolved.filePath);
+  assertLikelyTextBuffer(sample);
+  const detected = detectTextEncodingFromBuffer(sample, input.encoding ?? "auto");
+  return {
+    ...resolved,
+    encoding: detected.detectedEncoding,
+    requestedEncoding: detected.requestedEncoding,
+    detectedEncoding: detected.detectedEncoding,
+    confidence: detected.confidence,
+    hasBom: detected.hasBom
+  };
+}
+function createLineCollector2(offset, limit) {
+  const lines = [];
+  let pending = "";
+  let totalLines = 0;
+  let crlfCount = 0;
+  let lfCount = 0;
+  const emitLine = (line) => {
+    totalLines += 1;
+    if (totalLines >= offset && lines.length < limit) {
+      lines.push(`${totalLines}: ${line}`);
+    }
+  };
+  return {
+    push(text) {
+      if (text.length === 0) {
+        return;
+      }
+      const combined = pending + text;
+      let start = 0;
+      while (true) {
+        const newlineIndex = combined.indexOf("\n", start);
+        if (newlineIndex === -1) {
+          break;
+        }
+        let line = combined.slice(start, newlineIndex);
+        if (line.endsWith("\r")) {
+          line = line.slice(0, -1);
+          crlfCount += 1;
+        } else {
+          lfCount += 1;
+        }
+        emitLine(line);
+        start = newlineIndex + 1;
+      }
+      pending = combined.slice(start);
+    },
+    finish() {
+      emitLine(pending);
+      return {
+        startLine: offset,
+        endLine: lines.length === 0 ? totalLines : offset + lines.length - 1,
+        totalLines,
+        content: lines.join("\n"),
+        tail: false,
+        truncated: (lines.length === 0 ? totalLines : offset + lines.length - 1) < totalLines,
+        newlineStyle: finalizeNewlineStyle2(crlfCount, lfCount)
+      };
+    }
+  };
+}
+function createTailCollector2(limit) {
+  assertPositiveInteger(limit, "limit");
+  const lines = [];
+  let pending = "";
+  let totalLines = 0;
+  let crlfCount = 0;
+  let lfCount = 0;
+  const emitLine = (line) => {
+    totalLines += 1;
+    lines.push(line);
+    if (lines.length > limit) {
+      lines.shift();
+    }
+  };
+  return {
+    push(text) {
+      if (text.length === 0) {
+        return;
+      }
+      const combined = pending + text;
+      let start = 0;
+      while (true) {
+        const newlineIndex = combined.indexOf("\n", start);
+        if (newlineIndex === -1) {
+          break;
+        }
+        let line = combined.slice(start, newlineIndex);
+        if (line.endsWith("\r")) {
+          line = line.slice(0, -1);
+          crlfCount += 1;
+        } else {
+          lfCount += 1;
+        }
+        emitLine(line);
+        start = newlineIndex + 1;
+      }
+      pending = combined.slice(start);
+    },
+    finish() {
+      emitLine(pending);
+      const startLine = Math.max(1, totalLines - lines.length + 1);
+      return {
+        startLine,
+        endLine: totalLines,
+        totalLines,
+        content: lines.map((line, index) => `${startLine + index}: ${line}`).join("\n"),
+        truncated: startLine > 1,
+        tail: true,
+        newlineStyle: finalizeNewlineStyle2(crlfCount, lfCount)
+      };
+    }
+  };
+}
+async function visitDecodedTextChunks2(resolved, visitor) {
+  const stream = createReadStream2(resolved.filePath);
+  const bomLength = getBomPrefix(resolved.encoding, resolved.hasBom).length;
+  const decoderEncoding = resolved.encoding === "utf8-bom" ? "utf8" : resolved.encoding;
+  const decoder = import_iconv_lite2.default.getDecoder(decoderEncoding);
+  let skippedBom = false;
+  try {
+    for await (const chunk of stream) {
+      let buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+      if (!skippedBom && bomLength > 0) {
+        buffer = buffer.subarray(Math.min(bomLength, buffer.length));
+        skippedBom = true;
+      } else {
+        skippedBom = true;
+      }
+      if (buffer.length === 0) {
+        continue;
+      }
+      const text = decoder.write(buffer);
+      if (text.length > 0) {
+        await visitor(text);
+      }
+    }
+    const trailingText = decoder.end() ?? "";
+    if (trailingText.length > 0) {
+      await visitor(trailingText);
+    }
+  } catch (error45) {
+    if (error45 instanceof Error && "code" in error45) {
+      throw error45;
+    }
+    throw createTextError("GBK_IO_ERROR", `\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25: ${resolved.filePath}`, error45);
+  } finally {
+    stream.destroy();
+  }
+}
 async function readWholeTextFile(input) {
   const resolved = await resolveReadableTextFile(input);
   try {
@@ -17914,26 +18108,46 @@ async function readTextFile(input) {
   const offset = normalizeOptionalPositiveInteger(input.offset, "offset") ?? 1;
   const limit = normalizeOptionalPositiveInteger(input.limit, "limit") ?? 2e3;
   const tail = input.tail ?? false;
-  const loaded = await readWholeTextFile(input);
-  const lineWindow = tail ? collectTailLines2(loaded.content, limit) : {
-    ...splitLinesWithNumbers(loaded.content, offset, limit),
-    tail: false,
-    truncated: false
-  };
-  if (!tail) {
-    lineWindow.truncated = lineWindow.endLine < lineWindow.totalLines;
+  const resolved = await detectReadableTextFile(input);
+  if (resolved.stat.size < TEXT_STREAMING_FILE_SIZE_THRESHOLD_BYTES) {
+    const loaded = await readWholeTextFile(input);
+    const lineWindow2 = tail ? collectTailLines2(loaded.content, limit) : {
+      ...splitLinesWithNumbers(loaded.content, offset, limit),
+      tail: false,
+      truncated: false
+    };
+    if (!tail) {
+      lineWindow2.truncated = lineWindow2.endLine < lineWindow2.totalLines;
+    }
+    return {
+      filePath: loaded.filePath,
+      encoding: loaded.encoding,
+      requestedEncoding: loaded.requestedEncoding,
+      detectedEncoding: loaded.detectedEncoding,
+      confidence: loaded.confidence,
+      hasBom: loaded.hasBom,
+      bytesRead: loaded.bytesRead,
+      fileSize: loaded.fileSize,
+      streamed: false,
+      newlineStyle: loaded.newlineStyle,
+      ...lineWindow2
+    };
   }
+  const collector = tail ? createTailCollector2(limit) : createLineCollector2(offset, limit);
+  await visitDecodedTextChunks2(resolved, (text) => {
+    collector.push(text);
+  });
+  const lineWindow = collector.finish();
   return {
-    filePath: loaded.filePath,
-    encoding: loaded.encoding,
-    requestedEncoding: loaded.requestedEncoding,
-    detectedEncoding: loaded.detectedEncoding,
-    confidence: loaded.confidence,
-    hasBom: loaded.hasBom,
-    bytesRead: loaded.bytesRead,
-    fileSize: loaded.fileSize,
-    streamed: false,
-    newlineStyle: loaded.newlineStyle,
+    filePath: resolved.filePath,
+    encoding: resolved.encoding,
+    requestedEncoding: resolved.requestedEncoding,
+    detectedEncoding: resolved.detectedEncoding,
+    confidence: resolved.confidence,
+    hasBom: resolved.hasBom,
+    bytesRead: resolved.stat.size,
+    fileSize: resolved.stat.size,
+    streamed: true,
     ...lineWindow
   };
 }
@@ -17965,7 +18179,10 @@ async function writeTextFile(input) {
   if (existing && !append && !overwrite) {
     throw createTextError("GBK_FILE_EXISTS", `\u76EE\u6807\u6587\u4EF6\u5DF2\u5B58\u5728: ${candidatePath}`);
   }
-  const targetEncoding = existing && preserveEncoding ? existing.encoding : requestedEncoding === "auto" ? "utf8" : requestedEncoding;
+  if (!existing && requestedEncoding === "auto") {
+    throw createTextError("TEXT_UNKNOWN_ENCODING", "\u65B0\u6587\u4EF6\u5728 encoding=auto \u4E0B\u65E0\u6CD5\u786E\u5B9A\u7F16\u7801\uFF0C\u8BF7\u663E\u5F0F\u6307\u5B9A encoding");
+  }
+  const targetEncoding = existing && preserveEncoding ? existing.encoding : resolveExplicitTextEncoding(requestedEncoding, existing?.encoding ?? "utf8");
   const targetHasBom = targetEncoding === "utf8-bom" ? true : existing && preserveEncoding ? existing.hasBom : targetEncoding === "utf16le" || targetEncoding === "utf16be" ? true : false;
   const baseContent = append ? existing?.content ?? "" : "";
   const rawContent = `${baseContent}${input.content}`;
@@ -17994,70 +18211,84 @@ async function replaceTextFileText(input) {
     startLine: normalizeOptionalPositiveInteger(input.startLine, "startLine"),
     endLine: normalizeOptionalPositiveInteger(input.endLine, "endLine")
   };
-  const loaded = await readWholeTextFile({
-    filePath: input.filePath,
-    encoding: input.encoding ?? "auto",
-    allowExternal: input.allowExternal,
-    context: input.context
-  });
   if (mode === "insertAfter" || mode === "insertBefore") {
+    const loaded2 = await readWholeTextFile({
+      filePath: input.filePath,
+      encoding: input.encoding ?? "auto",
+      allowExternal: input.allowExternal,
+      context: input.context
+    });
     assertInsertArguments2(normalizedInput);
     const occurrence = normalizeOptionalPositiveInteger(normalizedInput.occurrence, "occurrence") ?? 1;
     const insertResult = buildInsertOutput(
-      loaded.content,
+      loaded2.content,
       mode,
       normalizedInput.anchor,
       normalizedInput.content,
       occurrence,
       resolveInsertIfExists(normalizedInput.ifExists),
-      loaded.newlineStyle
+      loaded2.newlineStyle
     );
     if (insertResult.skipped) {
       return {
         mode,
-        filePath: loaded.filePath,
-        encoding: loaded.encoding,
-        requestedEncoding: loaded.requestedEncoding,
-        detectedEncoding: loaded.detectedEncoding,
-        confidence: loaded.confidence,
-        hasBom: loaded.hasBom,
+        filePath: loaded2.filePath,
+        encoding: loaded2.encoding,
+        requestedEncoding: loaded2.requestedEncoding,
+        detectedEncoding: loaded2.detectedEncoding,
+        confidence: loaded2.confidence,
+        hasBom: loaded2.hasBom,
         anchor: insertResult.anchor,
         occurrence: insertResult.occurrence,
         anchorMatches: insertResult.anchorMatches,
         inserted: false,
         skipped: true,
-        bytesRead: loaded.bytesRead,
+        bytesRead: loaded2.bytesRead,
         bytesWritten: 0,
-        newlineStyle: loaded.newlineStyle
+        newlineStyle: loaded2.newlineStyle,
+        diffPreview: buildLineDiffPreview(loaded2.filePath, loaded2.encoding, insertResult.previewBefore, insertResult.previewAfter)
       };
     }
-    const targetEncoding2 = (normalizedInput.preserveEncoding ?? true) || (normalizedInput.encoding ?? "auto") === "auto" ? loaded.encoding : resolveExplicitTextEncoding(normalizedInput.encoding, loaded.encoding);
-    const targetHasBom2 = normalizedInput.preserveEncoding === false ? targetEncoding2 === "utf8-bom" || targetEncoding2 === "utf16le" || targetEncoding2 === "utf16be" : loaded.hasBom;
+    const targetEncoding2 = (normalizedInput.preserveEncoding ?? true) || (normalizedInput.encoding ?? "auto") === "auto" ? loaded2.encoding : resolveExplicitTextEncoding(normalizedInput.encoding, loaded2.encoding);
+    const targetHasBom2 = normalizedInput.preserveEncoding === false ? targetEncoding2 === "utf8-bom" || targetEncoding2 === "utf16le" || targetEncoding2 === "utf16be" : loaded2.hasBom;
     ensureLossless(insertResult.outputText, targetEncoding2, targetHasBom2);
     const buffer2 = encodeText(insertResult.outputText, targetEncoding2, targetHasBom2);
-    await fs3.writeFile(loaded.filePath, buffer2);
+    await fs3.writeFile(loaded2.filePath, buffer2);
     return {
       mode,
-      filePath: loaded.filePath,
+      filePath: loaded2.filePath,
       encoding: targetEncoding2,
-      requestedEncoding: loaded.requestedEncoding,
-      detectedEncoding: loaded.detectedEncoding,
-      confidence: loaded.confidence,
+      requestedEncoding: loaded2.requestedEncoding,
+      detectedEncoding: loaded2.detectedEncoding,
+      confidence: loaded2.confidence,
       hasBom: targetHasBom2,
       anchor: insertResult.anchor,
       occurrence: insertResult.occurrence,
       anchorMatches: insertResult.anchorMatches,
       inserted: true,
       skipped: false,
-      bytesRead: loaded.bytesRead,
+      bytesRead: loaded2.bytesRead,
       bytesWritten: buffer2.byteLength,
-      newlineStyle: detectNewlineStyle(insertResult.outputText)
+      newlineStyle: detectNewlineStyle(insertResult.outputText),
+      diffPreview: buildLineDiffPreview(loaded2.filePath, targetEncoding2, insertResult.previewBefore, insertResult.previewAfter)
     };
   }
   assertReplaceArguments2(input);
   if (input.oldString.length === 0) {
     throw createTextError("GBK_EMPTY_OLD_STRING", "oldString \u4E0D\u80FD\u4E3A\u7A7A");
   }
+  const resolved = await detectReadableTextFile({
+    filePath: input.filePath,
+    encoding: input.encoding ?? "auto",
+    allowExternal: input.allowExternal,
+    context: input.context
+  });
+  const loaded = await readWholeTextFile({
+    filePath: input.filePath,
+    encoding: input.encoding ?? "auto",
+    allowExternal: input.allowExternal,
+    context: input.context
+  });
   const scope = resolveEditScope2(loaded.content, normalizedInput);
   const replaceAll = normalizedInput.replaceAll ?? false;
   const preserveEncoding = normalizedInput.preserveEncoding ?? true;
@@ -18092,43 +18323,8 @@ async function replaceTextFileText(input) {
     occurrencesBefore,
     bytesRead: loaded.bytesRead,
     bytesWritten: buffer.byteLength,
-    newlineStyle: detectNewlineStyle(outputText)
-  };
-}
-async function createTextDiffPreview(input) {
-  const mode = resolveEditMode(input.mode);
-  const loaded = await readWholeTextFile({
-    filePath: input.filePath,
-    encoding: input.encoding ?? "auto",
-    allowExternal: input.allowExternal,
-    context: input.context
-  });
-  if (mode === "insertAfter" || mode === "insertBefore") {
-    assertInsertArguments2(input);
-    const occurrence = normalizeOptionalPositiveInteger(input.occurrence, "occurrence") ?? 1;
-    const insertResult = buildInsertOutput(
-      loaded.content,
-      mode,
-      input.anchor,
-      input.content,
-      occurrence,
-      resolveInsertIfExists(input.ifExists),
-      loaded.newlineStyle
-    );
-    return {
-      filePath: loaded.filePath,
-      encoding: loaded.encoding,
-      preview: buildLineDiffPreview(loaded.filePath, loaded.encoding, insertResult.previewBefore, insertResult.previewAfter)
-    };
-  }
-  assertReplaceArguments2(input);
-  const scope = resolveEditScope2(loaded.content, input);
-  const alignedNewString = alignTextToNewlineStyle(input.newString, loaded.newlineStyle);
-  const replaced = input.replaceAll ?? false ? scope.selectedText.split(input.oldString).join(alignedNewString) : scope.selectedText.replace(input.oldString, alignedNewString);
-  return {
-    filePath: loaded.filePath,
-    encoding: loaded.encoding,
-    preview: buildLineDiffPreview(loaded.filePath, loaded.encoding, scope.selectedText, replaced)
+    newlineStyle: detectNewlineStyle(outputText),
+    diffPreview: buildLineDiffPreview(loaded.filePath, targetEncoding, scope.selectedText, replaced)
   };
 }
 
@@ -18161,7 +18357,6 @@ var text_edit_default = tool({
   },
   async execute(args, context) {
     const result = await replaceTextFileText({ ...args, context });
-    const preview = await createTextDiffPreview({ ...args, context });
     const title = result.mode === "replace" ? `\u6587\u672C\u7F16\u8F91 ${result.encoding.toUpperCase()} x${result.replacements}` : result.inserted ? `\u6587\u672C\u63D2\u5165 ${result.encoding.toUpperCase()} #${result.occurrence}` : `\u6587\u672C\u8DF3\u8FC7 ${result.encoding.toUpperCase()} #${result.occurrence}`;
     context.metadata({
       title,
@@ -18180,7 +18375,7 @@ var text_edit_default = tool({
         inserted: result.mode === "replace" ? void 0 : result.inserted,
         skipped: result.mode === "replace" ? void 0 : result.skipped,
         newlineStyle: result.newlineStyle,
-        diffPreview: preview.preview
+        diffPreview: result.diffPreview ?? ""
       }
     });
     return JSON.stringify(result, null, 2);
@@ -18228,7 +18423,7 @@ var text_write_default = tool({
   description: `Write text files while preserving detected encoding and newline style by default.
 
 - Existing files keep their original encoding when encoding=auto.
-- New files default to utf8 unless encoding is specified.
+- New files require explicit encoding when encoding=auto.
 - Supports append and overwrite modes.`,
   args: {
     filePath: tool.schema.string().describe("Target file path"),

package/dist/plugins/opencode-gbk-tools.js

@@ -5,6 +5,7 @@ var TEXT_TOOL_SYSTEM_PROMPT = [
   "\u6587\u672C\u6587\u4EF6\u5904\u7406\u89C4\u5219\uFF1A",
   "- \u5904\u7406\u6587\u672C\u6587\u4EF6\u65F6\uFF0C\u4F18\u5148\u4F7F\u7528 text_read\u3001text_write\u3001text_edit\u3002",
   "- text_* \u9ED8\u8BA4\u4F1A\u81EA\u52A8\u8BC6\u522B\u73B0\u6709\u6587\u4EF6\u7F16\u7801\uFF0C\u5E76\u5728\u4FEE\u6539\u65F6\u5C3D\u91CF\u4FDD\u6301\u539F\u7F16\u7801\u3001BOM \u548C\u6362\u884C\u98CE\u683C\u3002",
+  "- \u65B0\u6587\u4EF6\u5728 encoding=auto \u4E0B\u4E0D\u4F1A\u9759\u9ED8\u9ED8\u8BA4\u6210 utf8\uFF1B\u8BF7\u663E\u5F0F\u6307\u5B9A encoding\u3002",
   "- \u5982\u679C\u610F\u56FE\u662F\u2018\u5728\u67D0\u6807\u7B7E\u524D\u540E\u63D2\u5165\u5185\u5BB9\u2019\uFF0C\u4F18\u5148\u4F7F\u7528 mode=insertAfter \u6216 mode=insertBefore\uFF0C\u5E76\u4F20 anchor/content\u3002",
   "- \u53EA\u6709\u5728\u660E\u786E\u505A\u7CBE\u786E\u66FF\u6362\u65F6\uFF0C\u624D\u4F7F\u7528 oldString/newString\u3002",
   "- \u82E5\u68C0\u6D4B\u7F6E\u4FE1\u5EA6\u4E0D\u8DB3\u6216\u51FA\u73B0 TEXT_UNKNOWN_ENCODING\uFF0C\u8BF7\u663E\u5F0F\u6307\u5B9A encoding \u540E\u91CD\u8BD5\u3002",

package/dist/release-manifest.json

@@ -1,7 +1,7 @@
 {
   "manifestVersion": 1,
   "packageName": "opencode-gbk-tools",
-  "packageVersion": "0.1.11",
+  "packageVersion": "0.1.13",
   "artifacts": [
     {
       "relativePath": "tools/gbk_edit.js",
@@ -30,19 +30,19 @@
     {
       "relativePath": "tools/text_edit.js",
       "kind": "tool",
-      "expectedHash": "7389be2ae7134574a083800df62001761b993a80bffe8835c6e6a346112653f1",
+      "expectedHash": "28e22f96cb6e738c55a3c90b8ffae9ef5d5d702649353373d0d04e882c60a5ee",
       "hashAlgorithm": "sha256"
     },
     {
       "relativePath": "tools/text_read.js",
       "kind": "tool",
-      "expectedHash": "54aa450b02c1efa98ee4528f9b4511ba454d02bb8b03c332558d6931fa025fb9",
+      "expectedHash": "09de6b032a6c622471e00701be56274e86a6019406f1bf4e45016b90ffabc4d9",
       "hashAlgorithm": "sha256"
     },
     {
       "relativePath": "tools/text_write.js",
       "kind": "tool",
-      "expectedHash": "fada2d48f25e5348461140bc2899158af12a2b331b37c90bb20c7730c33276c6",
+      "expectedHash": "d9b941bb88ecad271a9865eac6595ead964357a04e278ecd43941d4212ab69f3",
       "hashAlgorithm": "sha256"
     },
     {
@@ -54,7 +54,7 @@
     {
       "relativePath": "plugins/opencode-gbk-tools.js",
       "kind": "plugin",
-      "expectedHash": "5804344669c2fa34f9d18590b931e7649413c25f78107d60e1215e5a45b0f7f8",
+      "expectedHash": "efde5f79ebaa4393a276aa9da0be2f172e90127de7ccfbe16a186eb04f02975a",
       "hashAlgorithm": "sha256"
     }
   ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-gbk-tools",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Auto-encoding text tools plus GBK/GB18030 tools for OpenCode",
   "type": "module",
   "license": "MIT",