opencode-gbk-tools 0.1.7 → 0.1.8

package/dist/opencode-tools/gbk_edit.js

@@ -16750,6 +16750,12 @@ gbk_read output looks like "3787: SENDMSG 0 content". The "3787: " is a navigati
 oldString must be the raw file content: "SENDMSG 0 content" (no line number prefix).
 Including line numbers in oldString will cause GBK_NO_MATCH even if the content exists.
 
+CRITICAL \u2014 do NOT use bare newlines or whitespace-only as oldString:
+Using oldString="
+" or oldString="" to append content will always fail.
+To append content to the END of a file, use gbk_write with append=true instead:
+  gbk_write(filePath=..., content="\\r\\n\u65B0\u5185\u5BB9", append=true)
+
 Recommended workflow for large files (when gbk_read returned truncated=true):
 1. gbk_search(pattern) \u2192 find exact lineNumber
 2. gbk_read(offset=<lineNumber>, limit=20) \u2192 get the exact block (strip "N: " prefixes)

package/dist/opencode-tools/gbk_write.js

@@ -16314,9 +16314,49 @@ async function writeGbkFile(input) {
   const encoding = input.encoding ?? "gbk";
   const createDirectories = input.createDirectories ?? true;
   const overwrite = input.overwrite ?? false;
+  const append = input.append ?? false;
   const { candidatePath } = await assertPathAllowed(input.filePath, input.context, input.allowExternal ?? false);
   const parent = path2.dirname(candidatePath);
   assertEncodingSupported(encoding);
+  if (append) {
+    try {
+      const parentStat = await fs2.stat(parent);
+      if (!parentStat.isDirectory()) {
+        throw createGbkError("GBK_PARENT_DIRECTORY_MISSING", `\u7236\u76EE\u5F55\u4E0D\u5B58\u5728: ${parent}`);
+      }
+    } catch (error45) {
+      if (error45 instanceof Error && "code" in error45 && error45.code === "ENOENT") {
+        if (!createDirectories) {
+          throw createGbkError("GBK_PARENT_DIRECTORY_MISSING", `\u7236\u76EE\u5F55\u4E0D\u5B58\u5728: ${parent}`);
+        }
+        await fs2.mkdir(parent, { recursive: true });
+      } else if (error45 instanceof Error && "code" in error45) {
+        throw error45;
+      }
+    }
+    let existingContent = "";
+    let existed = false;
+    try {
+      const existingBuffer = await fs2.readFile(candidatePath);
+      existingContent = import_iconv_lite.default.decode(existingBuffer, encoding);
+      existed = true;
+    } catch (error45) {
+      if (!(error45 instanceof Error && "code" in error45 && error45.code === "ENOENT")) {
+        throw createGbkError("GBK_IO_ERROR", `\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25: ${candidatePath}`, error45);
+      }
+    }
+    const combined = existingContent + input.content;
+    const buffer = import_iconv_lite.default.encode(combined, encoding);
+    await fs2.writeFile(candidatePath, buffer);
+    return {
+      filePath: candidatePath,
+      encoding,
+      bytesWritten: buffer.byteLength,
+      created: !existed,
+      overwritten: false,
+      appended: true
+    };
+  }
   try {
     const stat = await fs2.stat(candidatePath);
     if (stat.isDirectory()) {
@@ -16370,13 +16410,24 @@ async function writeGbkFile(input) {
 
 // src/tools/gbk_write.ts
 var gbk_write_default = tool({
-  description: "Write GBK encoded text files",
+  description: `Write GBK encoded text files.
+
+**append=true** (recommended for adding content to existing files):
+- Reads the existing file content and appends new content at the end.
+- Works whether the file exists or not (creates it if missing).
+- Use this whenever you want to add lines/content to an existing GBK file.
+- Example: gbk_write(filePath=..., content="\\r\\n\u65B0\u5185\u5BB9", append=true)
+
+**overwrite=true**: Replace the entire file with new content.
+
+**Default (overwrite=false, append=false)**: Fails if the file already exists.`,
   args: {
     filePath: tool.schema.string().describe("Target file path"),
-    content: tool.schema.string().describe("Text content to write"),
+    content: tool.schema.string().describe("Text content to write (or append)"),
     encoding: tool.schema.enum(["gbk", "gb18030"]).optional().describe("Text encoding"),
     createDirectories: tool.schema.boolean().optional().describe("Create parent directories"),
-    overwrite: tool.schema.boolean().optional().describe("Overwrite existing file"),
+    overwrite: tool.schema.boolean().optional().describe("Overwrite existing file (replaces entire content)"),
+    append: tool.schema.boolean().optional().describe("Append content to existing file instead of overwriting; creates the file if it does not exist"),
     allowExternal: tool.schema.boolean().optional().describe("Allow paths outside workspace root")
   },
   async execute(args, context) {

package/dist/plugin/index.js

@@ -16984,9 +16984,49 @@ async function writeGbkFile(input) {
   const encoding = input.encoding ?? "gbk";
   const createDirectories = input.createDirectories ?? true;
   const overwrite = input.overwrite ?? false;
+  const append = input.append ?? false;
   const { candidatePath } = await assertPathAllowed(input.filePath, input.context, input.allowExternal ?? false);
   const parent = path2.dirname(candidatePath);
   assertEncodingSupported(encoding);
+  if (append) {
+    try {
+      const parentStat = await fs2.stat(parent);
+      if (!parentStat.isDirectory()) {
+        throw createGbkError("GBK_PARENT_DIRECTORY_MISSING", `\u7236\u76EE\u5F55\u4E0D\u5B58\u5728: ${parent}`);
+      }
+    } catch (error45) {
+      if (error45 instanceof Error && "code" in error45 && error45.code === "ENOENT") {
+        if (!createDirectories) {
+          throw createGbkError("GBK_PARENT_DIRECTORY_MISSING", `\u7236\u76EE\u5F55\u4E0D\u5B58\u5728: ${parent}`);
+        }
+        await fs2.mkdir(parent, { recursive: true });
+      } else if (error45 instanceof Error && "code" in error45) {
+        throw error45;
+      }
+    }
+    let existingContent = "";
+    let existed = false;
+    try {
+      const existingBuffer = await fs2.readFile(candidatePath);
+      existingContent = import_iconv_lite.default.decode(existingBuffer, encoding);
+      existed = true;
+    } catch (error45) {
+      if (!(error45 instanceof Error && "code" in error45 && error45.code === "ENOENT")) {
+        throw createGbkError("GBK_IO_ERROR", `\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25: ${candidatePath}`, error45);
+      }
+    }
+    const combined = existingContent + input.content;
+    const buffer = import_iconv_lite.default.encode(combined, encoding);
+    await fs2.writeFile(candidatePath, buffer);
+    return {
+      filePath: candidatePath,
+      encoding,
+      bytesWritten: buffer.byteLength,
+      created: !existed,
+      overwritten: false,
+      appended: true
+    };
+  }
   try {
     const stat = await fs2.stat(candidatePath);
     if (stat.isDirectory()) {
@@ -17050,6 +17090,12 @@ gbk_read output looks like "3787: SENDMSG 0 content". The "3787: " is a navigati
 oldString must be the raw file content: "SENDMSG 0 content" (no line number prefix).
 Including line numbers in oldString will cause GBK_NO_MATCH even if the content exists.
 
+CRITICAL \u2014 do NOT use bare newlines or whitespace-only as oldString:
+Using oldString="
+" or oldString="" to append content will always fail.
+To append content to the END of a file, use gbk_write with append=true instead:
+  gbk_write(filePath=..., content="\\r\\n\u65B0\u5185\u5BB9", append=true)
+
 Recommended workflow for large files (when gbk_read returned truncated=true):
 1. gbk_search(pattern) \u2192 find exact lineNumber
 2. gbk_read(offset=<lineNumber>, limit=20) \u2192 get the exact block (strip "N: " prefixes)
@@ -17138,13 +17184,24 @@ Workflow for large files:
 
 // src/tools/gbk_write.ts
 var gbk_write_default = tool({
-  description: "Write GBK encoded text files",
+  description: `Write GBK encoded text files.
+
+**append=true** (recommended for adding content to existing files):
+- Reads the existing file content and appends new content at the end.
+- Works whether the file exists or not (creates it if missing).
+- Use this whenever you want to add lines/content to an existing GBK file.
+- Example: gbk_write(filePath=..., content="\\r\\n\u65B0\u5185\u5BB9", append=true)
+
+**overwrite=true**: Replace the entire file with new content.
+
+**Default (overwrite=false, append=false)**: Fails if the file already exists.`,
   args: {
     filePath: tool.schema.string().describe("Target file path"),
-    content: tool.schema.string().describe("Text content to write"),
+    content: tool.schema.string().describe("Text content to write (or append)"),
     encoding: tool.schema.enum(["gbk", "gb18030"]).optional().describe("Text encoding"),
     createDirectories: tool.schema.boolean().optional().describe("Create parent directories"),
-    overwrite: tool.schema.boolean().optional().describe("Overwrite existing file"),
+    overwrite: tool.schema.boolean().optional().describe("Overwrite existing file (replaces entire content)"),
+    append: tool.schema.boolean().optional().describe("Append content to existing file instead of overwriting; creates the file if it does not exist"),
     allowExternal: tool.schema.boolean().optional().describe("Allow paths outside workspace root")
   },
   async execute(args, context) {

package/dist/release-manifest.json

@@ -1,12 +1,12 @@
 {
   "manifestVersion": 1,
   "packageName": "opencode-gbk-tools",
-  "packageVersion": "0.1.7",
+  "packageVersion": "0.1.8",
   "artifacts": [
     {
       "relativePath": "tools/gbk_edit.js",
       "kind": "tool",
-      "expectedHash": "783a97cc6f7d1378f0b841ce0c6809e93db104aa192a64f72878ce6d432c997e",
+      "expectedHash": "68d8398eae66592166de62e1bdce35ac51a6c22f27e6b48eca83c62370bc44f5",
       "hashAlgorithm": "sha256"
     },
     {
@@ -24,7 +24,7 @@
     {
       "relativePath": "tools/gbk_write.js",
       "kind": "tool",
-      "expectedHash": "fcb35107b599a9d2a60a1549372ef39f9b4e7f3759b5242faca3ed4b0170330f",
+      "expectedHash": "fa69eecf0c6133ebcd670fa81983a2acb5d011128f1ebc4a99fea4f5f1c37136",
       "hashAlgorithm": "sha256"
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-gbk-tools",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "GBK/GB18030 custom tools and agent for OpenCode",
   "type": "module",
   "license": "MIT",