opencode-gbk-tools 0.1.24 → 0.1.26

package/README.md

@@ -2,7 +2,7 @@
 
 为 OpenCode 提供一套自动识别编码的文本工具，以及面向 `GBK` / `GB18030` 的专用工具。
 
-解决 OpenCode 内置工具难以稳定处理非 UTF-8 文本文件的问题，并通过 plugin 让所有 agents 默认获得这些工具与规则，无需单独切换专属 GBK agent。
+解决 OpenCode 内置工具难以稳定处理非 UTF-8 文本文件的问题，并通过 plugin 让所有 agents 默认获得这些工具与规则；同时提供一个只允许调用 `text_*` / `gbk_*` 自定义工具的 `gbk-engine` agent。
 
 ---
 
@@ -18,6 +18,7 @@
 | `gbk_edit` | 精确替换 GBK 文件中的指定文本块 |
 | `gbk_search` | 在 GBK 文件中搜索关键词，返回行号和上下文 |
 | 本地/全局 plugin 规则 | 给所有 agents 注入“优先使用 `text_*`”的系统提示，并统一开放 `gbk_*` 工具 |
+| `gbk-engine` agent | 禁用 OpenCode 内置读写编辑工具，只保留 `text_*` / `gbk_*` 自定义工具 |
 
 ---
 
@@ -34,8 +35,9 @@ npx opencode-gbk-tools install
 - `text_read` / `text_write` / `text_edit`
 - `gbk_read` / `gbk_write` / `gbk_edit` / `gbk_search`
 - 对文本文件优先使用 `text_*` 的系统提示
+- `.opencode/agents/gbk-engine.md` 或 `~/.config/opencode/agents/gbk-engine.md`
 
-不再需要单独安装或切换专属 `gbk-engine` agent。
+如果你希望强制禁用内置 `read` / `write` / `edit` / `apply_patch`，可以直接切换到专属 `gbk-engine` agent。
 
 ---
 
@@ -62,7 +64,8 @@ npx opencode-gbk-tools uninstall
   - 原编码
   - BOM
   - 换行风格
-- 新文件在 `encoding=auto` 下不会自动默认成 `utf8`，需要显式指定 `encoding`
+- 新建 `.txt` 文件在 `encoding=auto` 下默认使用 `gbk`
+- 其他新文件在 `encoding=auto` 下不会自动默认成 `utf8`，仍需要显式指定 `encoding`
 - 当前支持：
   - `utf8`
   - `utf8-bom`
@@ -205,6 +208,8 @@ A：不要。现在优先用 `mode="insertAfter"` 或 `mode="insertBefore"`，
 
 | 版本 | 说明 |
 |------|------|
+| 0.1.26 | 新建 `.txt` 文件在 `encoding=auto` 下默认使用 `gbk`；保留已有文件的原编码检测与保持逻辑；同步更新工具提示、README 与测试覆盖 |
+| 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_*`；同步更新安装说明 |
 | 0.1.15 | 为 GBK 大文件统一引入行字节索引与流式读/搜/改路径，提升局部编辑、搜索与大块修改时的性能、稳定性与准确性 |

package/dist/agents/gbk-engine.md

@@ -0,0 +1,33 @@
+---
+description: 仅使用 opencode-gbk-tools 自定义工具处理自动编码文本与 GBK/GB18030 文件
+mode: primary
+temperature: 0
+tools:
+  "*": false
+  read: false
+  write: false
+  edit: false
+  apply_patch: false
+  text_read: true
+  text_write: true
+  text_edit: true
+  gbk_read: true
+  gbk_write: true
+  gbk_edit: true
+  gbk_search: true
+permission:
+  task:
+    "*": deny
+---
+你是 `gbk-engine`。
+
+你只能使用 `opencode-gbk-tools` 提供的 `text_*` 与 `gbk_*` 工具，不允许退回到 OpenCode 内置的 `read`、`write`、`edit`、`apply_patch` 或其他内置工具。
+
+工作规则：
+
+- 通用文本文件优先使用 `text_read`、`text_write`、`text_edit`
+- 只有在用户明确指定 `GBK` / `GB18030` 文件，或自动编码检测失败时，才优先使用 `gbk_*` 工具
+- 编辑前先读取目标文件；对大文件先搜索，再局部读取
+- 插入内容优先使用 `mode="insertAfter"` 或 `mode="insertBefore"` 搭配 `anchor` / `content`
+- 只有在精确替换现有内容时，才使用 `oldString` / `newString`
+- 如果自定义工具不可用，要明确说明当前 OpenCode 没有加载 `opencode-gbk-tools` plugin

package/dist/cli/index.js

@@ -60,7 +60,7 @@ function resolveTargetBase(target, cwd) {
 // src/cli/install.ts
 async function installCommand(args) {
   const targetBase = resolveTargetBase(args.target, args.cwd);
-  const allowedArtifacts = new Set(args.artifacts ?? ["plugin"]);
+  const allowedArtifacts = new Set(args.artifacts ?? ["plugin", "agent"]);
   const releaseManifest = JSON.parse(await fs3.readFile(path3.join(args.packageRoot, "dist", "release-manifest.json"), "utf8"));
   const selectedArtifacts = releaseManifest.artifacts.filter((artifact) => allowedArtifacts.has(artifact.kind));
   const existingManifest = await loadInstalledManifest(targetBase);
@@ -190,7 +190,7 @@ async function setupCommand(args) {
   await fs6.mkdir(configBase, { recursive: true });
   const configPath = await resolveConfigFile(configBase);
   await ensurePluginConfigured(configPath, pluginName);
-  const installResult = await installCommand({ ...args, force: true, artifacts: ["plugin"] });
+  const installResult = await installCommand({ ...args, force: true, artifacts: ["plugin", "agent"] });
   return {
     configPath,
     targetBase: installResult.targetBase

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",
@@ -18089,6 +18089,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 +18820,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 +19067,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",
@@ -18089,6 +18089,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 +18820,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 +19067,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,18 @@
 {
   "manifestVersion": 1,
   "packageName": "opencode-gbk-tools",
-  "packageVersion": "0.1.24",
+  "packageVersion": "0.1.26",
   "artifacts": [
     {
       "relativePath": "plugins/opencode-gbk-tools.js",
       "kind": "plugin",
-      "expectedHash": "55f2eae379bf3bd5a9129fbc413f255a4ffd9186d90a4fe26ecb3cc75b5a4c68",
+      "expectedHash": "fd233ebb174994213fa19d2aab801812ce9065efbdddceb3048989efe1723963",
+      "hashAlgorithm": "sha256"
+    },
+    {
+      "relativePath": "agents/gbk-engine.md",
+      "kind": "agent",
+      "expectedHash": "05a97cfe24d72339e45616638d0706d46c0d3782a3bfedefa1e59978adc5c3be",
       "hashAlgorithm": "sha256"
     }
   ]

package/package.json

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