opencode-gbk-tools 0.1.25 → 0.1.27

package/README.md

@@ -64,7 +64,8 @@ npx opencode-gbk-tools uninstall
   - 原编码
   - BOM
   - 换行风格
-- 新文件在 `encoding=auto` 下不会自动默认成 `utf8`，需要显式指定 `encoding`
+- 新建 `.txt` 文件在 `encoding=auto` 下默认使用 `gbk`
+- 其他新文件在 `encoding=auto` 下不会自动默认成 `utf8`，仍需要显式指定 `encoding`
 - 当前支持：
   - `utf8`
   - `utf8-bom`
@@ -207,6 +208,8 @@ A：不要。现在优先用 `mode="insertAfter"` 或 `mode="insertBefore"`，
 
 | 版本 | 说明 |
 |------|------|
+| 0.1.27 | 重新发布当前稳定内容，包含：新建 `.txt` 文件在 `encoding=auto` 下默认使用 `gbk`；保留已有文件的原编码检测与保持逻辑；修复 plugin 追加 system 规则时可能触发部分 Jinja/chat template 的“System message must be at the beginning”异常；同步更新工具提示、README 与测试覆盖 |
+| 0.1.26 | 仅提升发布版本号，用于重新发布当时的稳定内容 |
 | 0.1.25 | 恢复并正式发布专属 `gbk-engine` agent；通过 agent 白名单禁用内置 `read` / `write` / `edit` / `apply_patch`，只保留 `text_*` / `gbk_*` 自定义工具，并把 agent 纳入构建、安装与 release manifest |
 | 0.1.17 | 修复 OpenCode 以 npm plugin 方式加载包时缺少 `./server` 导出导致的插件加载失败问题；补充 `main` 与 `./server` 入口兼容性 |
 | 0.1.16 | 去掉专属 `gbk-engine` agent 安装链路，改为通过 plugin + tools 让全部 agents 统一支持 `text_*` / `gbk_*`；同步更新安装说明 |

package/dist/opencode-tools/text_write.js

@@ -16340,6 +16340,9 @@ function resolveExplicitTextEncoding(value, fallback) {
   const requested = value ?? "auto";
   return requested === "auto" ? fallback : requested;
 }
+function shouldDefaultNewTextFileToGbk(filePath) {
+  return path3.extname(filePath).toLowerCase() === ".txt";
+}
 function getBomPrefix(encoding, hasBom) {
   if (!hasBom) {
     return Buffer.alloc(0);
@@ -16626,10 +16629,11 @@ async function writeTextFile(input) {
   if (existing && !append && !overwrite) {
     throw createTextError("GBK_FILE_EXISTS", `\u76EE\u6807\u6587\u4EF6\u5DF2\u5B58\u5728: ${candidatePath}`);
   }
-  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 newFileDefaultEncoding = !existing && requestedEncoding === "auto" && shouldDefaultNewTextFileToGbk(candidatePath) ? "gbk" : null;
+  if (!existing && requestedEncoding === "auto" && !newFileDefaultEncoding) {
+    throw createTextError("TEXT_UNKNOWN_ENCODING", "\u65B0\u6587\u4EF6\u5728 encoding=auto \u4E0B\u65E0\u6CD5\u786E\u5B9A\u7F16\u7801\uFF1B.txt \u65B0\u6587\u4EF6\u4F1A\u9ED8\u8BA4\u4F7F\u7528 GBK\uFF0C\u5176\u4ED6\u6587\u4EF6\u8BF7\u663E\u5F0F\u6307\u5B9A encoding");
   }
-  const targetEncoding = existing && preserveEncoding ? existing.encoding : resolveExplicitTextEncoding(requestedEncoding, existing?.encoding ?? "utf8");
+  const targetEncoding = existing && preserveEncoding ? existing.encoding : requestedEncoding === "auto" && newFileDefaultEncoding ? newFileDefaultEncoding : 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}`;
@@ -16657,7 +16661,8 @@ 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 require explicit encoding when encoding=auto.
+- New .txt files default to GBK when encoding=auto.
+- Other new files still 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

@@ -18036,7 +18036,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",
+  "- \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",
   "- \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",
@@ -18046,7 +18046,13 @@ function appendTextToolSystemPrompt(system) {
   if (system.some((item) => item.includes(TEXT_TOOL_SYSTEM_MARKER))) {
     return;
   }
-  system.push(TEXT_TOOL_SYSTEM_PROMPT);
+  if (system.length === 0) {
+    system.push(TEXT_TOOL_SYSTEM_PROMPT);
+    return;
+  }
+  system[0] = `${system[0]}
+
+${TEXT_TOOL_SYSTEM_PROMPT}`;
 }
 
 // src/lib/text-file.ts
@@ -18089,6 +18095,9 @@ function resolveExplicitTextEncoding(value, fallback) {
   const requested = value ?? "auto";
   return requested === "auto" ? fallback : requested;
 }
+function shouldDefaultNewTextFileToGbk(filePath) {
+  return path3.extname(filePath).toLowerCase() === ".txt";
+}
 function getBomPrefix(encoding, hasBom) {
   if (!hasBom) {
     return Buffer.alloc(0);
@@ -18817,10 +18826,11 @@ async function writeTextFile(input) {
   if (existing && !append && !overwrite) {
     throw createTextError("GBK_FILE_EXISTS", `\u76EE\u6807\u6587\u4EF6\u5DF2\u5B58\u5728: ${candidatePath}`);
   }
-  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 newFileDefaultEncoding = !existing && requestedEncoding === "auto" && shouldDefaultNewTextFileToGbk(candidatePath) ? "gbk" : null;
+  if (!existing && requestedEncoding === "auto" && !newFileDefaultEncoding) {
+    throw createTextError("TEXT_UNKNOWN_ENCODING", "\u65B0\u6587\u4EF6\u5728 encoding=auto \u4E0B\u65E0\u6CD5\u786E\u5B9A\u7F16\u7801\uFF1B.txt \u65B0\u6587\u4EF6\u4F1A\u9ED8\u8BA4\u4F7F\u7528 GBK\uFF0C\u5176\u4ED6\u6587\u4EF6\u8BF7\u663E\u5F0F\u6307\u5B9A encoding");
   }
-  const targetEncoding = existing && preserveEncoding ? existing.encoding : resolveExplicitTextEncoding(requestedEncoding, existing?.encoding ?? "utf8");
+  const targetEncoding = existing && preserveEncoding ? existing.encoding : requestedEncoding === "auto" && newFileDefaultEncoding ? newFileDefaultEncoding : 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}`;
@@ -19063,7 +19073,8 @@ 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 require explicit encoding when encoding=auto.
+- New .txt files default to GBK when encoding=auto.
+- Other new files still 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

@@ -18036,7 +18036,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",
+  "- \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",
   "- \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",
@@ -18046,7 +18046,13 @@ function appendTextToolSystemPrompt(system) {
   if (system.some((item) => item.includes(TEXT_TOOL_SYSTEM_MARKER))) {
     return;
   }
-  system.push(TEXT_TOOL_SYSTEM_PROMPT);
+  if (system.length === 0) {
+    system.push(TEXT_TOOL_SYSTEM_PROMPT);
+    return;
+  }
+  system[0] = `${system[0]}
+
+${TEXT_TOOL_SYSTEM_PROMPT}`;
 }
 
 // src/lib/text-file.ts
@@ -18089,6 +18095,9 @@ function resolveExplicitTextEncoding(value, fallback) {
   const requested = value ?? "auto";
   return requested === "auto" ? fallback : requested;
 }
+function shouldDefaultNewTextFileToGbk(filePath) {
+  return path3.extname(filePath).toLowerCase() === ".txt";
+}
 function getBomPrefix(encoding, hasBom) {
   if (!hasBom) {
     return Buffer.alloc(0);
@@ -18817,10 +18826,11 @@ async function writeTextFile(input) {
   if (existing && !append && !overwrite) {
     throw createTextError("GBK_FILE_EXISTS", `\u76EE\u6807\u6587\u4EF6\u5DF2\u5B58\u5728: ${candidatePath}`);
   }
-  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 newFileDefaultEncoding = !existing && requestedEncoding === "auto" && shouldDefaultNewTextFileToGbk(candidatePath) ? "gbk" : null;
+  if (!existing && requestedEncoding === "auto" && !newFileDefaultEncoding) {
+    throw createTextError("TEXT_UNKNOWN_ENCODING", "\u65B0\u6587\u4EF6\u5728 encoding=auto \u4E0B\u65E0\u6CD5\u786E\u5B9A\u7F16\u7801\uFF1B.txt \u65B0\u6587\u4EF6\u4F1A\u9ED8\u8BA4\u4F7F\u7528 GBK\uFF0C\u5176\u4ED6\u6587\u4EF6\u8BF7\u663E\u5F0F\u6307\u5B9A encoding");
   }
-  const targetEncoding = existing && preserveEncoding ? existing.encoding : resolveExplicitTextEncoding(requestedEncoding, existing?.encoding ?? "utf8");
+  const targetEncoding = existing && preserveEncoding ? existing.encoding : requestedEncoding === "auto" && newFileDefaultEncoding ? newFileDefaultEncoding : 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}`;
@@ -19063,7 +19073,8 @@ 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 require explicit encoding when encoding=auto.
+- New .txt files default to GBK when encoding=auto.
+- Other new files still require explicit encoding when encoding=auto.
 - Supports append and overwrite modes.`,
   args: {
     filePath: tool.schema.string().describe("Target file path"),

package/dist/release-manifest.json

@@ -1,12 +1,12 @@
 {
   "manifestVersion": 1,
   "packageName": "opencode-gbk-tools",
-  "packageVersion": "0.1.25",
+  "packageVersion": "0.1.27",
   "artifacts": [
     {
       "relativePath": "plugins/opencode-gbk-tools.js",
       "kind": "plugin",
-      "expectedHash": "55f2eae379bf3bd5a9129fbc413f255a4ffd9186d90a4fe26ecb3cc75b5a4c68",
+      "expectedHash": "7d7c0b0f3c801e9017e167b21a098ae2992b36e0d95deebb13a85d4f163db84f",
       "hashAlgorithm": "sha256"
     },
     {

package/package.json

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