opencode-gbk-tools 0.1.29 → 0.1.31

package/README.md

@@ -60,6 +60,8 @@ npx opencode-gbk-tools uninstall
 ### text_read / text_write / text_edit
 
 - 默认 `encoding=auto`
+- 新建 `.txt` 文件时，优先直接使用 `gbk_write` 创建；plugin 会把这类创建请求优先路由到 `gbk_*`
+- 当前会话只要已经成功使用过 `gbk_*`，后续新建文件也应继续优先使用 `gbk_write` / `gbk_*`
 - 已有文件会尽量保持：
   - 原编码
   - BOM
@@ -208,7 +210,9 @@ A：不要。现在优先用 `mode="insertAfter"` 或 `mode="insertBefore"`，
 
 | 版本 | 说明 |
 |------|------|
-| 0.1.29 | 在方案 B 基础上新增 GBK 文件持久记忆：普通 agent 继续按编码分流，UTF-8 优先使用 OpenCode 内置工具，已确认是 GBK/GB18030 的文件会按完整路径 + mtime/size 持久记忆；后续再次操作同一路径时，`text_*` 会自动补齐记忆编码，内置 `read` / `write` / `edit` 会被拦截并提示改用 `gbk_*`；`gbk-engine` 继续保持为强制 GBK 专属模式 |
+| 0.1.31 | 在 `0.1.30` 基础上继续收紧新建文件路由：新建 `.txt` 文件必须优先直接使用 `gbk_write`，不再先走 `text_write` 或内置 `write/edit`；并新增“当前会话一旦成功使用过 `gbk_*`，后续新建文件继续优先走 `gbk_*`”的插件级约束与测试覆盖 |
+| 0.1.30 | 补强 `text_*` 针对真实 GBK 样本与大体积重复样本的高强度测试：新增 `QFunction-0.txt` 真实样本读取、编辑、追加与端到端工作流覆盖，并补充大文件重复样本下的 `text_read` / `text_edit` 行为验证；同时继续收紧路由规则：新建 `.txt` 文件直接要求改用 `gbk_write`，且当前会话一旦使用过 `gbk_*`，后续新建文件也继续要求走 `gbk_*` |
+| 0.1.29 | 在方案 B 基础上新增 GBK 文件持久记忆：普通 agent 继续按编码分流，UTF-8 优先使用 OpenCode 内置工具；对现有文件，已确认或首次检测到是 GBK/GB18030 的路径会按完整路径 + mtime/size 持久记忆；后续再次操作同一路径时，`text_*` 与内置 `read` / `write` / `edit` 都会被直接拦截并提示改用 `gbk_*`，避免先误走 `text_edit` / `edit` 再失败；`gbk-engine` 继续保持为强制 GBK 专属模式 |
 | 0.1.28 | 调整为方案 B：普通 agent 按编码分流，UTF-8 优先使用 OpenCode 内置工具，GBK/乱码风险优先使用 `gbk_*`；`gbk-engine` 保持为强制 GBK 专属模式；同时修复 `src/lib/gbk-file.ts` 中多处用户可见乱码错误文案，并增强 `text_*` 的匹配容错与大文件流式替换稳定性 |
 | 0.1.27 | 重新发布当前稳定内容，包含：新建 `.txt` 文件在 `encoding=auto` 下默认使用 `gbk`；保留已有文件的原编码检测与保持逻辑；修复 plugin 追加 system 规则时可能触发部分 Jinja/chat template 的“System message must be at the beginning”异常；同步更新工具提示、README 与测试覆盖 |
 | 0.1.26 | 仅提升发布版本号，用于重新发布当时的稳定内容 |

package/dist/plugin/index.js

@@ -3816,6 +3816,9 @@ var require_lib = __commonJS({
   }
 });
 
+// src/plugin/index.ts
+import path5 from "path";
+
 // src/lib/session-pressure.ts
 var AUTO_SUMMARIZE_PRESSURE_RATIO = 0.85;
 var AUTO_SUMMARIZE_COOLDOWN_MS = 6e4;
@@ -4043,6 +4046,67 @@ async function getRememberedGbkEncoding(filePath) {
   return entry;
 }
 
+// src/lib/path-sandbox.ts
+import fs2 from "fs/promises";
+import path2 from "path";
+
+// src/lib/errors.ts
+var GbkToolError = class extends Error {
+  code;
+  cause;
+  constructor(code, message, cause) {
+    super(message);
+    this.name = "GbkToolError";
+    this.code = code;
+    this.cause = cause;
+  }
+};
+function createGbkError(code, message, cause) {
+  return new GbkToolError(code, message, cause);
+}
+var createTextError = createGbkError;
+
+// src/lib/path-sandbox.ts
+function resolveBaseDirectory(context) {
+  const value = context.directory ?? process.cwd();
+  return path2.isAbsolute(value) ? value : path2.resolve(process.cwd(), value);
+}
+function resolveWorkspaceRoot(context) {
+  const value = context.worktree ?? context.directory ?? process.cwd();
+  return path2.isAbsolute(value) ? value : path2.resolve(process.cwd(), value);
+}
+function resolveCandidatePath(filePath, context) {
+  return path2.resolve(resolveBaseDirectory(context), filePath);
+}
+async function resolveExistingAnchor(filePath) {
+  let current = filePath;
+  while (true) {
+    try {
+      return await fs2.realpath(current);
+    } catch {
+      const parent = path2.dirname(current);
+      if (parent === current) {
+        throw createGbkError("GBK_IO_ERROR", `\u65E0\u6CD5\u89E3\u6790\u8DEF\u5F84\u951A\u70B9: ${filePath}`);
+      }
+      current = parent;
+    }
+  }
+}
+async function assertPathAllowed(filePath, context, allowExternal = false) {
+  const candidatePath = resolveCandidatePath(filePath, context);
+  const workspaceRoot = resolveWorkspaceRoot(context);
+  if (!allowExternal) {
+    const realWorkspaceRoot = await fs2.realpath(workspaceRoot);
+    const realCandidateAnchor = await resolveExistingAnchor(candidatePath);
+    const relative = path2.relative(realWorkspaceRoot, realCandidateAnchor);
+    if (relative === "" || !relative.startsWith("..") && !path2.isAbsolute(relative)) {
+      return { candidatePath, workspaceRoot };
+    }
+    throw createGbkError("GBK_PATH_OUTSIDE_ROOT", `\u76EE\u6807\u8DEF\u5F84\u8D85\u51FA\u5DE5\u4F5C\u76EE\u5F55\u8303\u56F4: ${candidatePath}`);
+  }
+  return { candidatePath, workspaceRoot };
+}
+
 // node_modules/zod/v4/classic/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -4774,10 +4838,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path5) {
-  if (!path5)
+function getElementAtPath(obj, path6) {
+  if (!path6)
     return obj;
-  return path5.reduce((acc, key) => acc?.[key], obj);
+  return path6.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -5138,11 +5202,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path5, issues) {
+function prefixIssues(path6, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path5);
+    iss.path.unshift(path6);
     return iss;
   });
 }
@@ -5310,7 +5374,7 @@ function treeifyError(error45, _mapper) {
     return issue2.message;
   };
   const result = { errors: [] };
-  const processError = (error46, path5 = []) => {
+  const processError = (error46, path6 = []) => {
     var _a, _b;
     for (const issue2 of error46.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -5320,7 +5384,7 @@ function treeifyError(error45, _mapper) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path5, ...issue2.path];
+        const fullpath = [...path6, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -5352,8 +5416,8 @@ function treeifyError(error45, _mapper) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path5 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path5) {
+  const path6 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path6) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -16597,67 +16661,6 @@ import crypto from "crypto";
 import { createReadStream } from "fs";
 import fs3 from "fs/promises";
 import path3 from "path";
-
-// src/lib/errors.ts
-var GbkToolError = class extends Error {
-  code;
-  cause;
-  constructor(code, message, cause) {
-    super(message);
-    this.name = "GbkToolError";
-    this.code = code;
-    this.cause = cause;
-  }
-};
-function createGbkError(code, message, cause) {
-  return new GbkToolError(code, message, cause);
-}
-var createTextError = createGbkError;
-
-// src/lib/path-sandbox.ts
-import fs2 from "fs/promises";
-import path2 from "path";
-function resolveBaseDirectory(context) {
-  const value = context.directory ?? process.cwd();
-  return path2.isAbsolute(value) ? value : path2.resolve(process.cwd(), value);
-}
-function resolveWorkspaceRoot(context) {
-  const value = context.worktree ?? context.directory ?? process.cwd();
-  return path2.isAbsolute(value) ? value : path2.resolve(process.cwd(), value);
-}
-function resolveCandidatePath(filePath, context) {
-  return path2.resolve(resolveBaseDirectory(context), filePath);
-}
-async function resolveExistingAnchor(filePath) {
-  let current = filePath;
-  while (true) {
-    try {
-      return await fs2.realpath(current);
-    } catch {
-      const parent = path2.dirname(current);
-      if (parent === current) {
-        throw createGbkError("GBK_IO_ERROR", `\u65E0\u6CD5\u89E3\u6790\u8DEF\u5F84\u951A\u70B9: ${filePath}`);
-      }
-      current = parent;
-    }
-  }
-}
-async function assertPathAllowed(filePath, context, allowExternal = false) {
-  const candidatePath = resolveCandidatePath(filePath, context);
-  const workspaceRoot = resolveWorkspaceRoot(context);
-  if (!allowExternal) {
-    const realWorkspaceRoot = await fs2.realpath(workspaceRoot);
-    const realCandidateAnchor = await resolveExistingAnchor(candidatePath);
-    const relative = path2.relative(realWorkspaceRoot, realCandidateAnchor);
-    if (relative === "" || !relative.startsWith("..") && !path2.isAbsolute(relative)) {
-      return { candidatePath, workspaceRoot };
-    }
-    throw createGbkError("GBK_PATH_OUTSIDE_ROOT", `\u76EE\u6807\u8DEF\u5F84\u8D85\u51FA\u5DE5\u4F5C\u76EE\u5F55\u8303\u56F4: ${candidatePath}`);
-  }
-  return { candidatePath, workspaceRoot };
-}
-
-// src/lib/gbk-file.ts
 var STREAMING_FILE_SIZE_THRESHOLD_BYTES = 1024 * 1024;
 var STREAM_READ_CHUNK_SIZE_BYTES = 1024 * 1024;
 var gbkLineIndexCache = /* @__PURE__ */ new Map();
@@ -18243,35 +18246,6 @@ var gbk_write_default = tool({
   }
 });
 
-// src/plugin/text-guidance.ts
-var TEXT_TOOL_SYSTEM_MARKER = "[opencode-gbk-tools:text-rules]";
-var TEXT_TOOL_SYSTEM_PROMPT = [
-  TEXT_TOOL_SYSTEM_MARKER,
-  "\u6587\u672C\u6587\u4EF6\u5904\u7406\u89C4\u5219\uFF1A",
-  "- \u666E\u901A UTF-8 / UTF-8 BOM / UTF-16 \u6587\u672C\uFF0C\u4F18\u5148\u4F7F\u7528 OpenCode \u5185\u7F6E read\u3001write\u3001edit\u3002",
-  "- \u9047\u5230 GBK / GB18030 \u6587\u4EF6\u3001\u4E2D\u6587\u4E71\u7801\u3001\u975E UTF-8 \u65E7\u6587\u672C\uFF0C\u4F18\u5148\u4F7F\u7528 gbk_read\u3001gbk_write\u3001gbk_edit\u3001gbk_search\u3002",
-  "- \u65B0\u5EFA .txt \u6587\u4EF6\u5728 encoding=auto \u4E0B\u9ED8\u8BA4\u4F7F\u7528 GBK\uFF1B\u5176\u4ED6\u65B0\u6587\u4EF6\u8BF7\u663E\u5F0F\u6307\u5B9A encoding\u3002",
-  "- \u65E0\u6CD5\u786E\u5B9A\u7F16\u7801\u65F6\uFF0C\u5148\u5C1D\u8BD5\u5185\u7F6E read\uFF1B\u82E5\u51FA\u73B0\u4E2D\u6587\u4E71\u7801\u3001\u66FF\u6362\u5931\u8D25\u6216\u7F16\u7801\u98CE\u9669\uFF0C\u518D\u5207\u6362\u5230 gbk_*\u3002",
-  "- \u5DF2\u786E\u8BA4\u662F GBK/GB18030 \u7684\u6587\u4EF6\u4F1A\u88AB\u63D2\u4EF6\u6301\u4E45\u8BB0\u5FC6\uFF1B\u518D\u6B21\u64CD\u4F5C\u540C\u4E00\u8DEF\u5F84\u65F6\uFF0C\u4F18\u5148\u7EE7\u7EED\u6309 GBK \u5904\u7406\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",
-  "- anchor\u3001startAnchor\u3001endAnchor\u3001oldString \u82E5\u76F4\u63A5\u590D\u5236\u81EA\u8BFB\u53D6\u7ED3\u679C\uFF0C\u53EF\u4FDD\u7559 LF \u6362\u884C\uFF1Bgbk_edit / text_edit \u4F1A\u5C3D\u91CF\u6309\u6587\u4EF6\u6362\u884C\u98CE\u683C\u81EA\u52A8\u5BF9\u9F50\u3002",
-  '- \u82E5\u8BFB\u53D6\u7ED3\u679C\u5E26\u6709 "N: " \u884C\u53F7\u524D\u7F00\uFF0Cgbk_edit / text_edit \u4F1A\u5C3D\u91CF\u81EA\u52A8\u5265\u79BB\u8FD9\u4E9B\u524D\u7F00\u540E\u518D\u5339\u914D\u3002',
-  "- gbk-engine \u662F\u5F3A\u5236 GBK \u4E13\u5C5E\u6A21\u5F0F\uFF1A\u53EA\u5141\u8BB8 gbk_*\uFF0C\u4E0D\u8D70\u5185\u7F6E\u8BFB\u5199\u7F16\u8F91\u5DE5\u5177\u3002"
-].join("\n");
-function appendTextToolSystemPrompt(system) {
-  if (system.some((item) => item.includes(TEXT_TOOL_SYSTEM_MARKER))) {
-    return;
-  }
-  if (system.length === 0) {
-    system.push(TEXT_TOOL_SYSTEM_PROMPT);
-    return;
-  }
-  system[0] = `${system[0]}
-
-${TEXT_TOOL_SYSTEM_PROMPT}`;
-}
-
 // src/lib/text-file.ts
 var import_iconv_lite2 = __toESM(require_lib(), 1);
 import crypto2 from "crypto";
@@ -19220,6 +19194,20 @@ async function ensureParentDirectory(parent, createDirectories) {
     throw error45;
   }
 }
+async function detectTextFileEncoding(input) {
+  const detected = await detectReadableTextFile(input);
+  const fileSize = typeof detected.stat.size === "bigint" ? Number(detected.stat.size) : detected.stat.size;
+  return {
+    filePath: detected.filePath,
+    encoding: detected.encoding,
+    requestedEncoding: detected.requestedEncoding,
+    detectedEncoding: detected.detectedEncoding,
+    confidence: detected.confidence,
+    hasBom: detected.hasBom,
+    bytesRead: Math.min(fileSize, TEXT_DETECTION_SAMPLE_BYTES),
+    newlineStyle: "unknown"
+  };
+}
 async function readTextFile(input) {
   const offset = normalizeOptionalPositiveInteger(input.offset, "offset") ?? 1;
   const limit = normalizeOptionalPositiveInteger(input.limit, "limit") ?? 2e3;
@@ -19497,6 +19485,35 @@ async function replaceTextFileText(input) {
   };
 }
 
+// src/plugin/text-guidance.ts
+var TEXT_TOOL_SYSTEM_MARKER = "[opencode-gbk-tools:text-rules]";
+var TEXT_TOOL_SYSTEM_PROMPT = [
+  TEXT_TOOL_SYSTEM_MARKER,
+  "\u6587\u672C\u6587\u4EF6\u5904\u7406\u89C4\u5219\uFF1A",
+  "- \u666E\u901A UTF-8 / UTF-8 BOM / UTF-16 \u6587\u672C\uFF0C\u4F18\u5148\u4F7F\u7528 OpenCode \u5185\u7F6E read\u3001write\u3001edit\u3002",
+  "- \u9047\u5230 GBK / GB18030 \u6587\u4EF6\u3001\u4E2D\u6587\u4E71\u7801\u3001\u975E UTF-8 \u65E7\u6587\u672C\uFF0C\u4F18\u5148\u4F7F\u7528 gbk_read\u3001gbk_write\u3001gbk_edit\u3001gbk_search\uFF0C\u4E0D\u8981\u5148\u5C1D\u8BD5 text_* \u6216\u5185\u7F6E read/write/edit\u3002",
+  "- \u65B0\u5EFA .txt \u6587\u4EF6\u5728 encoding=auto \u4E0B\u9ED8\u8BA4\u4F7F\u7528 GBK\uFF1B\u5176\u4ED6\u65B0\u6587\u4EF6\u8BF7\u663E\u5F0F\u6307\u5B9A encoding\u3002",
+  "- \u5BF9\u73B0\u6709 .txt / .cfg / .ini / .log \u7B49\u65E7\u6587\u672C\u6587\u4EF6\uFF0C\u53EA\u8981\u6000\u7591\u662F\u4E2D\u6587\u672C\u5730\u7F16\u7801\uFF0C\u4F18\u5148\u5148\u7528 gbk_read \u5224\u65AD\uFF0C\u4E0D\u8981\u5148 edit \u518D\u56E0\u4E3A\u5339\u914D\u5931\u8D25\u6216\u6587\u4EF6\u65F6\u95F4\u6233\u53D8\u5316\u800C\u56DE\u9000\u3002",
+  "- \u5DF2\u786E\u8BA4\u6216\u9996\u6B21\u68C0\u6D4B\u5230\u662F GBK/GB18030 \u7684\u6587\u4EF6\u4F1A\u88AB\u63D2\u4EF6\u6301\u4E45\u8BB0\u5FC6\uFF1B\u518D\u6B21\u64CD\u4F5C\u540C\u4E00\u8DEF\u5F84\u65F6\uFF0C\u4F1A\u76F4\u63A5\u62E6\u622A\u5185\u7F6E read/write/edit \u548C text_*\uFF0C\u5E76\u8981\u6C42\u6539\u7528 gbk_*\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",
+  "- anchor\u3001startAnchor\u3001endAnchor\u3001oldString \u82E5\u76F4\u63A5\u590D\u5236\u81EA\u8BFB\u53D6\u7ED3\u679C\uFF0C\u53EF\u4FDD\u7559 LF \u6362\u884C\uFF1Bgbk_edit / text_edit \u4F1A\u5C3D\u91CF\u6309\u6587\u4EF6\u6362\u884C\u98CE\u683C\u81EA\u52A8\u5BF9\u9F50\u3002",
+  '- \u82E5\u8BFB\u53D6\u7ED3\u679C\u5E26\u6709 "N: " \u884C\u53F7\u524D\u7F00\uFF0Cgbk_edit / text_edit \u4F1A\u5C3D\u91CF\u81EA\u52A8\u5265\u79BB\u8FD9\u4E9B\u524D\u7F00\u540E\u518D\u5339\u914D\u3002',
+  "- gbk-engine \u662F\u5F3A\u5236 GBK \u4E13\u5C5E\u6A21\u5F0F\uFF1A\u53EA\u5141\u8BB8 gbk_*\uFF0C\u4E0D\u8D70\u5185\u7F6E\u8BFB\u5199\u7F16\u8F91\u5DE5\u5177\u3002"
+].join("\n");
+function appendTextToolSystemPrompt(system) {
+  if (system.some((item) => item.includes(TEXT_TOOL_SYSTEM_MARKER))) {
+    return;
+  }
+  if (system.length === 0) {
+    system.push(TEXT_TOOL_SYSTEM_PROMPT);
+    return;
+  }
+  system[0] = `${system[0]}
+
+${TEXT_TOOL_SYSTEM_PROMPT}`;
+}
+
 // src/tools/text_edit.ts
 var text_edit_default = tool({
   description: `Edit text files with automatic encoding detection and preservation.
@@ -19641,7 +19658,8 @@ var MANAGED_TOOL_IDS = /* @__PURE__ */ new Set([
   "text_edit"
 ]);
 var BUILTIN_TEXT_TOOL_IDS = /* @__PURE__ */ new Set(["read", "write", "edit"]);
-var REMEMBERABLE_TEXT_TOOL_IDS = /* @__PURE__ */ new Set(["text_read", "text_write", "text_edit"]);
+var TEXT_TOOL_IDS = /* @__PURE__ */ new Set(["text_read", "text_write", "text_edit"]);
+var ROUTED_TEXT_TOOL_IDS = /* @__PURE__ */ new Set([...BUILTIN_TEXT_TOOL_IDS, ...TEXT_TOOL_IDS]);
 function getToolFilePath(args) {
   if (!args || typeof args !== "object") {
     return null;
@@ -19649,6 +19667,35 @@ function getToolFilePath(args) {
   const filePath = args.filePath;
   return typeof filePath === "string" ? filePath : null;
 }
+function getToolAllowExternal(args) {
+  if (!args || typeof args !== "object") {
+    return false;
+  }
+  return args.allowExternal === true;
+}
+function normalizeSessionFilePath(filePath, directory, worktree) {
+  const resolved = path5.normalize(resolveCandidatePath(filePath, { directory, worktree }));
+  return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+function buildGbkRoutingMessage(filePath, encoding) {
+  return `\u6587\u4EF6\u68C0\u6D4B\u4E3A ${encoding.toUpperCase()} \u7F16\u7801\uFF0C\u8BF7\u76F4\u63A5\u6539\u7528 gbk_read\u3001gbk_write\u3001gbk_edit \u6216 gbk_search\uFF0C\u4E0D\u8981\u5148\u4F7F\u7528\u5185\u7F6E read/write/edit \u6216 text_*\uFF1A${filePath}`;
+}
+function buildTextEditSessionRoutingMessage(filePath) {
+  return `\u5F53\u524D\u4F1A\u8BDD\u5DF2\u5BF9\u8BE5\u6587\u4EF6\u4F7F\u7528 text_edit\uFF0C\u8BF7\u7EE7\u7EED\u4F7F\u7528 text_read\u3001text_write\u3001text_edit \u6216\u76F4\u63A5\u6539\u7528 gbk_*\uFF1B\u4E0D\u8981\u518D\u5207\u56DE\u5185\u7F6E read/write/edit\uFF0C\u4EE5\u514D\u89E6\u53D1\u6587\u4EF6\u65B0\u9C9C\u5EA6\u68C0\u67E5\u51B2\u7A81\uFF1A${filePath}`;
+}
+async function detectExistingGbkEncoding(filePath, allowExternal, directory, worktree) {
+  try {
+    const detected = await detectTextFileEncoding({
+      filePath,
+      encoding: "auto",
+      allowExternal,
+      context: { directory, worktree }
+    });
+    return isRememberedGbkEncoding(detected.encoding) ? detected.encoding : null;
+  } catch {
+    return null;
+  }
+}
 async function maybePersistRememberedEncoding(metadata) {
   const filePath = typeof metadata.filePath === "string" ? metadata.filePath : null;
   const encoding = metadata.encoding;
@@ -19712,7 +19759,25 @@ async function maybeAutoSummarizeSession(client, directory, input) {
     markAutoSummarizeFinished(input.sessionID, false);
   }
 }
-function createOpencodeGbkHooks(client, directory) {
+function createOpencodeGbkHooks(client, directory, worktree) {
+  const sessionTextEditedFiles = /* @__PURE__ */ new Map();
+  function rememberSessionTextEditFile(sessionID, normalizedFilePath) {
+    if (!sessionID) {
+      return;
+    }
+    let files = sessionTextEditedFiles.get(sessionID);
+    if (!files) {
+      files = /* @__PURE__ */ new Set();
+      sessionTextEditedFiles.set(sessionID, files);
+    }
+    files.add(normalizedFilePath);
+  }
+  function hasSessionTextEditFile(sessionID, normalizedFilePath) {
+    if (!sessionID) {
+      return false;
+    }
+    return sessionTextEditedFiles.get(sessionID)?.has(normalizedFilePath) ?? false;
+  }
   return {
     tool: {
       gbk_read: gbk_read_default,
@@ -19743,19 +19808,32 @@ function createOpencodeGbkHooks(client, directory) {
       if (!filePath) {
         return;
       }
-      const remembered = await getRememberedGbkEncoding(filePath);
-      if (!remembered) {
+      if (!ROUTED_TEXT_TOOL_IDS.has(input.tool)) {
         return;
       }
-      if (REMEMBERABLE_TEXT_TOOL_IDS.has(input.tool)) {
-        if (output.args && (output.args.encoding === void 0 || output.args.encoding === "auto")) {
-          output.args.encoding = remembered.encoding;
-        }
+      const normalizedFilePath = normalizeSessionFilePath(filePath, directory, worktree);
+      if (BUILTIN_TEXT_TOOL_IDS.has(input.tool) && hasSessionTextEditFile(input.sessionID, normalizedFilePath)) {
+        throw new Error(buildTextEditSessionRoutingMessage(filePath));
+      }
+      const resolvedFilePath = resolveCandidatePath(filePath, { directory, worktree });
+      const remembered = await getRememberedGbkEncoding(resolvedFilePath);
+      if (remembered) {
+        throw new Error(buildGbkRoutingMessage(filePath, remembered.encoding));
+      }
+      const detectedEncoding = await detectExistingGbkEncoding(
+        resolvedFilePath,
+        getToolAllowExternal(output.args),
+        directory,
+        worktree
+      );
+      if (!detectedEncoding) {
         return;
       }
-      if (BUILTIN_TEXT_TOOL_IDS.has(input.tool)) {
-        throw new Error(`\u6587\u4EF6\u5DF2\u8BB0\u5FC6\u4E3A ${remembered.encoding.toUpperCase()} \u7F16\u7801\uFF0C\u8BF7\u6539\u7528 gbk_read\u3001gbk_write\u3001gbk_edit \u6216 gbk_search\uFF1A${filePath}`);
+      try {
+        await rememberGbkEncoding(resolvedFilePath, detectedEncoding);
+      } catch {
       }
+      throw new Error(buildGbkRoutingMessage(filePath, detectedEncoding));
     },
     async "tool.execute.after"(input, output) {
       if (!MANAGED_TOOL_IDS.has(input.tool)) return;
@@ -19772,6 +19850,12 @@ function createOpencodeGbkHooks(client, directory) {
       if (typeof metadata.diffPreview === "string") {
         metadata.diffPreview = truncateMetadataPreview(metadata.diffPreview, input.sessionID);
       }
+      if (input.tool === "text_edit" && typeof metadata.filePath === "string") {
+        rememberSessionTextEditFile(
+          input.sessionID,
+          normalizeSessionFilePath(metadata.filePath, directory, worktree)
+        );
+      }
       try {
         await maybePersistRememberedEncoding(metadata);
       } catch {
@@ -19803,7 +19887,7 @@ function createOpencodeGbkHooks(client, directory) {
 var pluginModule = {
   id: "opencode-gbk-tools",
   async server(ctx) {
-    return createOpencodeGbkHooks(ctx.client, ctx.directory);
+    return createOpencodeGbkHooks(ctx.client, ctx.directory, ctx.worktree);
   }
 };
 var plugin_default = pluginModule;

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

@@ -3816,6 +3816,9 @@ var require_lib = __commonJS({
   }
 });
 
+// src/plugin/index.ts
+import path5 from "path";
+
 // src/lib/session-pressure.ts
 var AUTO_SUMMARIZE_PRESSURE_RATIO = 0.85;
 var AUTO_SUMMARIZE_COOLDOWN_MS = 6e4;
@@ -4043,6 +4046,67 @@ async function getRememberedGbkEncoding(filePath) {
   return entry;
 }
 
+// src/lib/path-sandbox.ts
+import fs2 from "fs/promises";
+import path2 from "path";
+
+// src/lib/errors.ts
+var GbkToolError = class extends Error {
+  code;
+  cause;
+  constructor(code, message, cause) {
+    super(message);
+    this.name = "GbkToolError";
+    this.code = code;
+    this.cause = cause;
+  }
+};
+function createGbkError(code, message, cause) {
+  return new GbkToolError(code, message, cause);
+}
+var createTextError = createGbkError;
+
+// src/lib/path-sandbox.ts
+function resolveBaseDirectory(context) {
+  const value = context.directory ?? process.cwd();
+  return path2.isAbsolute(value) ? value : path2.resolve(process.cwd(), value);
+}
+function resolveWorkspaceRoot(context) {
+  const value = context.worktree ?? context.directory ?? process.cwd();
+  return path2.isAbsolute(value) ? value : path2.resolve(process.cwd(), value);
+}
+function resolveCandidatePath(filePath, context) {
+  return path2.resolve(resolveBaseDirectory(context), filePath);
+}
+async function resolveExistingAnchor(filePath) {
+  let current = filePath;
+  while (true) {
+    try {
+      return await fs2.realpath(current);
+    } catch {
+      const parent = path2.dirname(current);
+      if (parent === current) {
+        throw createGbkError("GBK_IO_ERROR", `\u65E0\u6CD5\u89E3\u6790\u8DEF\u5F84\u951A\u70B9: ${filePath}`);
+      }
+      current = parent;
+    }
+  }
+}
+async function assertPathAllowed(filePath, context, allowExternal = false) {
+  const candidatePath = resolveCandidatePath(filePath, context);
+  const workspaceRoot = resolveWorkspaceRoot(context);
+  if (!allowExternal) {
+    const realWorkspaceRoot = await fs2.realpath(workspaceRoot);
+    const realCandidateAnchor = await resolveExistingAnchor(candidatePath);
+    const relative = path2.relative(realWorkspaceRoot, realCandidateAnchor);
+    if (relative === "" || !relative.startsWith("..") && !path2.isAbsolute(relative)) {
+      return { candidatePath, workspaceRoot };
+    }
+    throw createGbkError("GBK_PATH_OUTSIDE_ROOT", `\u76EE\u6807\u8DEF\u5F84\u8D85\u51FA\u5DE5\u4F5C\u76EE\u5F55\u8303\u56F4: ${candidatePath}`);
+  }
+  return { candidatePath, workspaceRoot };
+}
+
 // node_modules/zod/v4/classic/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -4774,10 +4838,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path5) {
-  if (!path5)
+function getElementAtPath(obj, path6) {
+  if (!path6)
     return obj;
-  return path5.reduce((acc, key) => acc?.[key], obj);
+  return path6.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -5138,11 +5202,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path5, issues) {
+function prefixIssues(path6, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path5);
+    iss.path.unshift(path6);
     return iss;
   });
 }
@@ -5310,7 +5374,7 @@ function treeifyError(error45, _mapper) {
     return issue2.message;
   };
   const result = { errors: [] };
-  const processError = (error46, path5 = []) => {
+  const processError = (error46, path6 = []) => {
     var _a, _b;
     for (const issue2 of error46.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -5320,7 +5384,7 @@ function treeifyError(error45, _mapper) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path5, ...issue2.path];
+        const fullpath = [...path6, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -5352,8 +5416,8 @@ function treeifyError(error45, _mapper) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path5 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path5) {
+  const path6 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path6) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -16597,67 +16661,6 @@ import crypto from "crypto";
 import { createReadStream } from "fs";
 import fs3 from "fs/promises";
 import path3 from "path";
-
-// src/lib/errors.ts
-var GbkToolError = class extends Error {
-  code;
-  cause;
-  constructor(code, message, cause) {
-    super(message);
-    this.name = "GbkToolError";
-    this.code = code;
-    this.cause = cause;
-  }
-};
-function createGbkError(code, message, cause) {
-  return new GbkToolError(code, message, cause);
-}
-var createTextError = createGbkError;
-
-// src/lib/path-sandbox.ts
-import fs2 from "fs/promises";
-import path2 from "path";
-function resolveBaseDirectory(context) {
-  const value = context.directory ?? process.cwd();
-  return path2.isAbsolute(value) ? value : path2.resolve(process.cwd(), value);
-}
-function resolveWorkspaceRoot(context) {
-  const value = context.worktree ?? context.directory ?? process.cwd();
-  return path2.isAbsolute(value) ? value : path2.resolve(process.cwd(), value);
-}
-function resolveCandidatePath(filePath, context) {
-  return path2.resolve(resolveBaseDirectory(context), filePath);
-}
-async function resolveExistingAnchor(filePath) {
-  let current = filePath;
-  while (true) {
-    try {
-      return await fs2.realpath(current);
-    } catch {
-      const parent = path2.dirname(current);
-      if (parent === current) {
-        throw createGbkError("GBK_IO_ERROR", `\u65E0\u6CD5\u89E3\u6790\u8DEF\u5F84\u951A\u70B9: ${filePath}`);
-      }
-      current = parent;
-    }
-  }
-}
-async function assertPathAllowed(filePath, context, allowExternal = false) {
-  const candidatePath = resolveCandidatePath(filePath, context);
-  const workspaceRoot = resolveWorkspaceRoot(context);
-  if (!allowExternal) {
-    const realWorkspaceRoot = await fs2.realpath(workspaceRoot);
-    const realCandidateAnchor = await resolveExistingAnchor(candidatePath);
-    const relative = path2.relative(realWorkspaceRoot, realCandidateAnchor);
-    if (relative === "" || !relative.startsWith("..") && !path2.isAbsolute(relative)) {
-      return { candidatePath, workspaceRoot };
-    }
-    throw createGbkError("GBK_PATH_OUTSIDE_ROOT", `\u76EE\u6807\u8DEF\u5F84\u8D85\u51FA\u5DE5\u4F5C\u76EE\u5F55\u8303\u56F4: ${candidatePath}`);
-  }
-  return { candidatePath, workspaceRoot };
-}
-
-// src/lib/gbk-file.ts
 var STREAMING_FILE_SIZE_THRESHOLD_BYTES = 1024 * 1024;
 var STREAM_READ_CHUNK_SIZE_BYTES = 1024 * 1024;
 var gbkLineIndexCache = /* @__PURE__ */ new Map();
@@ -18243,35 +18246,6 @@ var gbk_write_default = tool({
   }
 });
 
-// src/plugin/text-guidance.ts
-var TEXT_TOOL_SYSTEM_MARKER = "[opencode-gbk-tools:text-rules]";
-var TEXT_TOOL_SYSTEM_PROMPT = [
-  TEXT_TOOL_SYSTEM_MARKER,
-  "\u6587\u672C\u6587\u4EF6\u5904\u7406\u89C4\u5219\uFF1A",
-  "- \u666E\u901A UTF-8 / UTF-8 BOM / UTF-16 \u6587\u672C\uFF0C\u4F18\u5148\u4F7F\u7528 OpenCode \u5185\u7F6E read\u3001write\u3001edit\u3002",
-  "- \u9047\u5230 GBK / GB18030 \u6587\u4EF6\u3001\u4E2D\u6587\u4E71\u7801\u3001\u975E UTF-8 \u65E7\u6587\u672C\uFF0C\u4F18\u5148\u4F7F\u7528 gbk_read\u3001gbk_write\u3001gbk_edit\u3001gbk_search\u3002",
-  "- \u65B0\u5EFA .txt \u6587\u4EF6\u5728 encoding=auto \u4E0B\u9ED8\u8BA4\u4F7F\u7528 GBK\uFF1B\u5176\u4ED6\u65B0\u6587\u4EF6\u8BF7\u663E\u5F0F\u6307\u5B9A encoding\u3002",
-  "- \u65E0\u6CD5\u786E\u5B9A\u7F16\u7801\u65F6\uFF0C\u5148\u5C1D\u8BD5\u5185\u7F6E read\uFF1B\u82E5\u51FA\u73B0\u4E2D\u6587\u4E71\u7801\u3001\u66FF\u6362\u5931\u8D25\u6216\u7F16\u7801\u98CE\u9669\uFF0C\u518D\u5207\u6362\u5230 gbk_*\u3002",
-  "- \u5DF2\u786E\u8BA4\u662F GBK/GB18030 \u7684\u6587\u4EF6\u4F1A\u88AB\u63D2\u4EF6\u6301\u4E45\u8BB0\u5FC6\uFF1B\u518D\u6B21\u64CD\u4F5C\u540C\u4E00\u8DEF\u5F84\u65F6\uFF0C\u4F18\u5148\u7EE7\u7EED\u6309 GBK \u5904\u7406\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",
-  "- anchor\u3001startAnchor\u3001endAnchor\u3001oldString \u82E5\u76F4\u63A5\u590D\u5236\u81EA\u8BFB\u53D6\u7ED3\u679C\uFF0C\u53EF\u4FDD\u7559 LF \u6362\u884C\uFF1Bgbk_edit / text_edit \u4F1A\u5C3D\u91CF\u6309\u6587\u4EF6\u6362\u884C\u98CE\u683C\u81EA\u52A8\u5BF9\u9F50\u3002",
-  '- \u82E5\u8BFB\u53D6\u7ED3\u679C\u5E26\u6709 "N: " \u884C\u53F7\u524D\u7F00\uFF0Cgbk_edit / text_edit \u4F1A\u5C3D\u91CF\u81EA\u52A8\u5265\u79BB\u8FD9\u4E9B\u524D\u7F00\u540E\u518D\u5339\u914D\u3002',
-  "- gbk-engine \u662F\u5F3A\u5236 GBK \u4E13\u5C5E\u6A21\u5F0F\uFF1A\u53EA\u5141\u8BB8 gbk_*\uFF0C\u4E0D\u8D70\u5185\u7F6E\u8BFB\u5199\u7F16\u8F91\u5DE5\u5177\u3002"
-].join("\n");
-function appendTextToolSystemPrompt(system) {
-  if (system.some((item) => item.includes(TEXT_TOOL_SYSTEM_MARKER))) {
-    return;
-  }
-  if (system.length === 0) {
-    system.push(TEXT_TOOL_SYSTEM_PROMPT);
-    return;
-  }
-  system[0] = `${system[0]}
-
-${TEXT_TOOL_SYSTEM_PROMPT}`;
-}
-
 // src/lib/text-file.ts
 var import_iconv_lite2 = __toESM(require_lib(), 1);
 import crypto2 from "crypto";
@@ -19220,6 +19194,20 @@ async function ensureParentDirectory(parent, createDirectories) {
     throw error45;
   }
 }
+async function detectTextFileEncoding(input) {
+  const detected = await detectReadableTextFile(input);
+  const fileSize = typeof detected.stat.size === "bigint" ? Number(detected.stat.size) : detected.stat.size;
+  return {
+    filePath: detected.filePath,
+    encoding: detected.encoding,
+    requestedEncoding: detected.requestedEncoding,
+    detectedEncoding: detected.detectedEncoding,
+    confidence: detected.confidence,
+    hasBom: detected.hasBom,
+    bytesRead: Math.min(fileSize, TEXT_DETECTION_SAMPLE_BYTES),
+    newlineStyle: "unknown"
+  };
+}
 async function readTextFile(input) {
   const offset = normalizeOptionalPositiveInteger(input.offset, "offset") ?? 1;
   const limit = normalizeOptionalPositiveInteger(input.limit, "limit") ?? 2e3;
@@ -19497,6 +19485,35 @@ async function replaceTextFileText(input) {
   };
 }
 
+// src/plugin/text-guidance.ts
+var TEXT_TOOL_SYSTEM_MARKER = "[opencode-gbk-tools:text-rules]";
+var TEXT_TOOL_SYSTEM_PROMPT = [
+  TEXT_TOOL_SYSTEM_MARKER,
+  "\u6587\u672C\u6587\u4EF6\u5904\u7406\u89C4\u5219\uFF1A",
+  "- \u666E\u901A UTF-8 / UTF-8 BOM / UTF-16 \u6587\u672C\uFF0C\u4F18\u5148\u4F7F\u7528 OpenCode \u5185\u7F6E read\u3001write\u3001edit\u3002",
+  "- \u9047\u5230 GBK / GB18030 \u6587\u4EF6\u3001\u4E2D\u6587\u4E71\u7801\u3001\u975E UTF-8 \u65E7\u6587\u672C\uFF0C\u4F18\u5148\u4F7F\u7528 gbk_read\u3001gbk_write\u3001gbk_edit\u3001gbk_search\uFF0C\u4E0D\u8981\u5148\u5C1D\u8BD5 text_* \u6216\u5185\u7F6E read/write/edit\u3002",
+  "- \u65B0\u5EFA .txt \u6587\u4EF6\u5728 encoding=auto \u4E0B\u9ED8\u8BA4\u4F7F\u7528 GBK\uFF1B\u5176\u4ED6\u65B0\u6587\u4EF6\u8BF7\u663E\u5F0F\u6307\u5B9A encoding\u3002",
+  "- \u5BF9\u73B0\u6709 .txt / .cfg / .ini / .log \u7B49\u65E7\u6587\u672C\u6587\u4EF6\uFF0C\u53EA\u8981\u6000\u7591\u662F\u4E2D\u6587\u672C\u5730\u7F16\u7801\uFF0C\u4F18\u5148\u5148\u7528 gbk_read \u5224\u65AD\uFF0C\u4E0D\u8981\u5148 edit \u518D\u56E0\u4E3A\u5339\u914D\u5931\u8D25\u6216\u6587\u4EF6\u65F6\u95F4\u6233\u53D8\u5316\u800C\u56DE\u9000\u3002",
+  "- \u5DF2\u786E\u8BA4\u6216\u9996\u6B21\u68C0\u6D4B\u5230\u662F GBK/GB18030 \u7684\u6587\u4EF6\u4F1A\u88AB\u63D2\u4EF6\u6301\u4E45\u8BB0\u5FC6\uFF1B\u518D\u6B21\u64CD\u4F5C\u540C\u4E00\u8DEF\u5F84\u65F6\uFF0C\u4F1A\u76F4\u63A5\u62E6\u622A\u5185\u7F6E read/write/edit \u548C text_*\uFF0C\u5E76\u8981\u6C42\u6539\u7528 gbk_*\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",
+  "- anchor\u3001startAnchor\u3001endAnchor\u3001oldString \u82E5\u76F4\u63A5\u590D\u5236\u81EA\u8BFB\u53D6\u7ED3\u679C\uFF0C\u53EF\u4FDD\u7559 LF \u6362\u884C\uFF1Bgbk_edit / text_edit \u4F1A\u5C3D\u91CF\u6309\u6587\u4EF6\u6362\u884C\u98CE\u683C\u81EA\u52A8\u5BF9\u9F50\u3002",
+  '- \u82E5\u8BFB\u53D6\u7ED3\u679C\u5E26\u6709 "N: " \u884C\u53F7\u524D\u7F00\uFF0Cgbk_edit / text_edit \u4F1A\u5C3D\u91CF\u81EA\u52A8\u5265\u79BB\u8FD9\u4E9B\u524D\u7F00\u540E\u518D\u5339\u914D\u3002',
+  "- gbk-engine \u662F\u5F3A\u5236 GBK \u4E13\u5C5E\u6A21\u5F0F\uFF1A\u53EA\u5141\u8BB8 gbk_*\uFF0C\u4E0D\u8D70\u5185\u7F6E\u8BFB\u5199\u7F16\u8F91\u5DE5\u5177\u3002"
+].join("\n");
+function appendTextToolSystemPrompt(system) {
+  if (system.some((item) => item.includes(TEXT_TOOL_SYSTEM_MARKER))) {
+    return;
+  }
+  if (system.length === 0) {
+    system.push(TEXT_TOOL_SYSTEM_PROMPT);
+    return;
+  }
+  system[0] = `${system[0]}
+
+${TEXT_TOOL_SYSTEM_PROMPT}`;
+}
+
 // src/tools/text_edit.ts
 var text_edit_default = tool({
   description: `Edit text files with automatic encoding detection and preservation.
@@ -19641,7 +19658,8 @@ var MANAGED_TOOL_IDS = /* @__PURE__ */ new Set([
   "text_edit"
 ]);
 var BUILTIN_TEXT_TOOL_IDS = /* @__PURE__ */ new Set(["read", "write", "edit"]);
-var REMEMBERABLE_TEXT_TOOL_IDS = /* @__PURE__ */ new Set(["text_read", "text_write", "text_edit"]);
+var TEXT_TOOL_IDS = /* @__PURE__ */ new Set(["text_read", "text_write", "text_edit"]);
+var ROUTED_TEXT_TOOL_IDS = /* @__PURE__ */ new Set([...BUILTIN_TEXT_TOOL_IDS, ...TEXT_TOOL_IDS]);
 function getToolFilePath(args) {
   if (!args || typeof args !== "object") {
     return null;
@@ -19649,6 +19667,35 @@ function getToolFilePath(args) {
   const filePath = args.filePath;
   return typeof filePath === "string" ? filePath : null;
 }
+function getToolAllowExternal(args) {
+  if (!args || typeof args !== "object") {
+    return false;
+  }
+  return args.allowExternal === true;
+}
+function normalizeSessionFilePath(filePath, directory, worktree) {
+  const resolved = path5.normalize(resolveCandidatePath(filePath, { directory, worktree }));
+  return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+function buildGbkRoutingMessage(filePath, encoding) {
+  return `\u6587\u4EF6\u68C0\u6D4B\u4E3A ${encoding.toUpperCase()} \u7F16\u7801\uFF0C\u8BF7\u76F4\u63A5\u6539\u7528 gbk_read\u3001gbk_write\u3001gbk_edit \u6216 gbk_search\uFF0C\u4E0D\u8981\u5148\u4F7F\u7528\u5185\u7F6E read/write/edit \u6216 text_*\uFF1A${filePath}`;
+}
+function buildTextEditSessionRoutingMessage(filePath) {
+  return `\u5F53\u524D\u4F1A\u8BDD\u5DF2\u5BF9\u8BE5\u6587\u4EF6\u4F7F\u7528 text_edit\uFF0C\u8BF7\u7EE7\u7EED\u4F7F\u7528 text_read\u3001text_write\u3001text_edit \u6216\u76F4\u63A5\u6539\u7528 gbk_*\uFF1B\u4E0D\u8981\u518D\u5207\u56DE\u5185\u7F6E read/write/edit\uFF0C\u4EE5\u514D\u89E6\u53D1\u6587\u4EF6\u65B0\u9C9C\u5EA6\u68C0\u67E5\u51B2\u7A81\uFF1A${filePath}`;
+}
+async function detectExistingGbkEncoding(filePath, allowExternal, directory, worktree) {
+  try {
+    const detected = await detectTextFileEncoding({
+      filePath,
+      encoding: "auto",
+      allowExternal,
+      context: { directory, worktree }
+    });
+    return isRememberedGbkEncoding(detected.encoding) ? detected.encoding : null;
+  } catch {
+    return null;
+  }
+}
 async function maybePersistRememberedEncoding(metadata) {
   const filePath = typeof metadata.filePath === "string" ? metadata.filePath : null;
   const encoding = metadata.encoding;
@@ -19712,7 +19759,25 @@ async function maybeAutoSummarizeSession(client, directory, input) {
     markAutoSummarizeFinished(input.sessionID, false);
   }
 }
-function createOpencodeGbkHooks(client, directory) {
+function createOpencodeGbkHooks(client, directory, worktree) {
+  const sessionTextEditedFiles = /* @__PURE__ */ new Map();
+  function rememberSessionTextEditFile(sessionID, normalizedFilePath) {
+    if (!sessionID) {
+      return;
+    }
+    let files = sessionTextEditedFiles.get(sessionID);
+    if (!files) {
+      files = /* @__PURE__ */ new Set();
+      sessionTextEditedFiles.set(sessionID, files);
+    }
+    files.add(normalizedFilePath);
+  }
+  function hasSessionTextEditFile(sessionID, normalizedFilePath) {
+    if (!sessionID) {
+      return false;
+    }
+    return sessionTextEditedFiles.get(sessionID)?.has(normalizedFilePath) ?? false;
+  }
   return {
     tool: {
       gbk_read: gbk_read_default,
@@ -19743,19 +19808,32 @@ function createOpencodeGbkHooks(client, directory) {
       if (!filePath) {
         return;
       }
-      const remembered = await getRememberedGbkEncoding(filePath);
-      if (!remembered) {
+      if (!ROUTED_TEXT_TOOL_IDS.has(input.tool)) {
         return;
       }
-      if (REMEMBERABLE_TEXT_TOOL_IDS.has(input.tool)) {
-        if (output.args && (output.args.encoding === void 0 || output.args.encoding === "auto")) {
-          output.args.encoding = remembered.encoding;
-        }
+      const normalizedFilePath = normalizeSessionFilePath(filePath, directory, worktree);
+      if (BUILTIN_TEXT_TOOL_IDS.has(input.tool) && hasSessionTextEditFile(input.sessionID, normalizedFilePath)) {
+        throw new Error(buildTextEditSessionRoutingMessage(filePath));
+      }
+      const resolvedFilePath = resolveCandidatePath(filePath, { directory, worktree });
+      const remembered = await getRememberedGbkEncoding(resolvedFilePath);
+      if (remembered) {
+        throw new Error(buildGbkRoutingMessage(filePath, remembered.encoding));
+      }
+      const detectedEncoding = await detectExistingGbkEncoding(
+        resolvedFilePath,
+        getToolAllowExternal(output.args),
+        directory,
+        worktree
+      );
+      if (!detectedEncoding) {
         return;
       }
-      if (BUILTIN_TEXT_TOOL_IDS.has(input.tool)) {
-        throw new Error(`\u6587\u4EF6\u5DF2\u8BB0\u5FC6\u4E3A ${remembered.encoding.toUpperCase()} \u7F16\u7801\uFF0C\u8BF7\u6539\u7528 gbk_read\u3001gbk_write\u3001gbk_edit \u6216 gbk_search\uFF1A${filePath}`);
+      try {
+        await rememberGbkEncoding(resolvedFilePath, detectedEncoding);
+      } catch {
       }
+      throw new Error(buildGbkRoutingMessage(filePath, detectedEncoding));
     },
     async "tool.execute.after"(input, output) {
       if (!MANAGED_TOOL_IDS.has(input.tool)) return;
@@ -19772,6 +19850,12 @@ function createOpencodeGbkHooks(client, directory) {
       if (typeof metadata.diffPreview === "string") {
         metadata.diffPreview = truncateMetadataPreview(metadata.diffPreview, input.sessionID);
       }
+      if (input.tool === "text_edit" && typeof metadata.filePath === "string") {
+        rememberSessionTextEditFile(
+          input.sessionID,
+          normalizeSessionFilePath(metadata.filePath, directory, worktree)
+        );
+      }
       try {
         await maybePersistRememberedEncoding(metadata);
       } catch {

package/dist/release-manifest.json

@@ -1,12 +1,12 @@
 {
   "manifestVersion": 1,
   "packageName": "opencode-gbk-tools",
-  "packageVersion": "0.1.29",
+  "packageVersion": "0.1.30",
   "artifacts": [
     {
       "relativePath": "plugins/opencode-gbk-tools.js",
       "kind": "plugin",
-      "expectedHash": "0b1824ee451a19ab284a2840f35ed8a1867ef14d1c697d353ca611f6e8f2d8d5",
+      "expectedHash": "ce0215b44f5166b283e083969533307a4fc54f62e594dc11c1ca669d6c9b495e",
       "hashAlgorithm": "sha256"
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-gbk-tools",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "description": "Auto-encoding text tools plus GBK/GB18030 tools for OpenCode",
   "type": "module",
   "main": "./dist/plugin/index.js",