opencode-gbk-tools 0.1.6 → 0.1.8

package/dist/opencode-tools/gbk_edit.js

@@ -16457,14 +16457,14 @@ function buildNoMatchMessage(content, oldString) {
     getNearestContext(content, oldString)
   ].join("\n");
 }
-function tryLooseBlockReplace(content, oldString, newString) {
-  const normalizedContent = normalizeNewlines(content);
-  const contentLines = splitNormalizedLines(content);
-  const oldLines = trimTrailingEmptyLines(splitNormalizedLines(oldString));
-  const newLines = splitNormalizedLines(newString);
-  if (oldLines.length === 0) {
-    return null;
-  }
+function hasLineNumberPrefixes(lines) {
+  const nonEmpty = lines.filter((l) => l.trim().length > 0);
+  return nonEmpty.length > 0 && nonEmpty.every((l) => /^\d+: /.test(l));
+}
+function stripLineNumberPrefixes(lines) {
+  return lines.map((l) => l.replace(/^\d+: /, ""));
+}
+function matchLooseBlock(contentLines, oldLines, newLines, newlineStyle, content) {
   for (let start = 0; start < contentLines.length; start += 1) {
     let contentIndex = start;
     let oldIndex = 0;
@@ -16494,12 +16494,32 @@ function tryLooseBlockReplace(content, oldString, newString) {
       ].join("\n");
       return {
         occurrencesBefore: 1,
-        content: detectNewlineStyle(content) === "crlf" ? replacedNormalized.replace(/\n/g, "\r\n") : replacedNormalized
+        content: newlineStyle === "crlf" ? replacedNormalized.replace(/\n/g, "\r\n") : replacedNormalized
       };
     }
   }
   return null;
 }
+function tryLooseBlockReplace(content, oldString, newString) {
+  const contentLines = splitNormalizedLines(content);
+  const oldLines = trimTrailingEmptyLines(splitNormalizedLines(oldString));
+  const newLines = splitNormalizedLines(newString);
+  const newlineStyle = detectNewlineStyle(content);
+  if (oldLines.length === 0) {
+    return null;
+  }
+  const result = matchLooseBlock(contentLines, oldLines, newLines, newlineStyle, content);
+  if (result !== null) {
+    return result;
+  }
+  if (hasLineNumberPrefixes(oldLines)) {
+    const strippedOldLines = trimTrailingEmptyLines(stripLineNumberPrefixes(oldLines));
+    if (strippedOldLines.length > 0) {
+      return matchLooseBlock(contentLines, strippedOldLines, newLines, newlineStyle, content);
+    }
+  }
+  return null;
+}
 function countOccurrences(text, target) {
   if (target.length === 0) {
     throw createGbkError("GBK_EMPTY_OLD_STRING", "oldString \u4E0D\u80FD\u4E3A\u7A7A");
@@ -16725,12 +16745,28 @@ var gbk_edit_default = tool({
 Reads the FULL file content regardless of file size \u2014 not limited by gbk_read's line window.
 Safe to use on files with more than 2000 lines.
 
+CRITICAL \u2014 do NOT include line number prefixes in oldString or newString:
+gbk_read output looks like "3787: SENDMSG 0 content". The "3787: " is a navigation prefix, NOT file content.
+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)
+3. gbk_edit(oldString=<content without prefixes>, newString=<new content>)
+
 For large files, use 'startLine'/'endLine' or 'startAnchor'/'endAnchor' to narrow the search scope
 and avoid false matches. Scoped edits also improve performance on very large files.`,
   args: {
     filePath: tool.schema.string().describe("Target file path"),
-    oldString: tool.schema.string().describe("Exact text to replace (must match file content, not gbk_read output with line numbers)"),
-    newString: tool.schema.string().describe("Replacement text"),
+    oldString: tool.schema.string().describe("Exact text to replace \u2014 raw file content only, no 'N: ' line number prefixes from gbk_read output"),
+    newString: tool.schema.string().describe("Replacement text \u2014 raw content only, no line number prefixes"),
     replaceAll: tool.schema.boolean().optional().describe("Replace all occurrences (default: false, requires unique match)"),
     startLine: tool.schema.union([tool.schema.number().int().positive(), tool.schema.literal(-1)]).optional().describe("Restrict edit scope to 1-based start line (inclusive)"),
     endLine: tool.schema.union([tool.schema.number().int().positive(), tool.schema.literal(-1)]).optional().describe("Restrict edit scope to 1-based end line (inclusive)"),

package/dist/opencode-tools/gbk_read.js

@@ -16609,14 +16609,23 @@ var gbk_read_default = tool({
 Returns up to 'limit' lines (default 2000) starting from 'offset'.
 When the file has more lines than the window, 'truncated' is true and 'totalLines' shows the full count.
 
-IMPORTANT: If 'truncated' is true, the returned content is incomplete.
-DO NOT use the returned content as 'oldString' for gbk_edit on a truncated file.
-To edit content beyond the visible window, use gbk_edit with 'startLine'/'endLine' to target the exact range,
-or read the specific range first with 'offset' set to the desired line number.`,
+IMPORTANT \u2014 line number format: each output line is prefixed with "N: " (e.g. "3787: content").
+These prefixes are for navigation only. Strip them before using any line as 'oldString' in gbk_edit.
+
+IMPORTANT \u2014 do NOT use large limits to read the whole file:
+- Setting limit=40000 or similar to "read everything" is WRONG. It produces an enormous response
+  that is unreliable to process and may be truncated by the protocol.
+- To find content in a large file, use gbk_search instead.
+- To read a specific section, set offset=<lineNumber> and limit=<small number like 10-30>.
+
+Workflow when truncated=true:
+1. gbk_search(pattern) \u2192 get exact lineNumber
+2. gbk_read(offset=<lineNumber>, limit=20) \u2192 get the exact block
+3. gbk_edit(oldString=<exact content without line prefixes>) \u2192 edit reliably`,
   args: {
     filePath: tool.schema.string().describe("Target file path"),
     offset: tool.schema.union([tool.schema.number().int().positive(), tool.schema.literal(-1)]).optional().describe("1-based start line (default: 1)"),
-    limit: tool.schema.union([tool.schema.number().int().positive(), tool.schema.literal(-1)]).optional().describe("Number of lines to read (default: 2000). Use -1 to apply the default."),
+    limit: tool.schema.union([tool.schema.number().int().positive(), tool.schema.literal(-1)]).optional().describe("Number of lines to read (default: 2000, max recommended: 200). Use -1 to apply the default."),
     tail: tool.schema.boolean().optional().describe("Read last N lines instead of offset-based window"),
     encoding: tool.schema.enum(["gbk", "gb18030"]).optional().describe("Text encoding (default: gbk)"),
     allowExternal: tool.schema.boolean().optional().describe("Allow paths outside workspace root")

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

@@ -16508,14 +16508,14 @@ function buildNoMatchMessage(content, oldString) {
     getNearestContext(content, oldString)
   ].join("\n");
 }
-function tryLooseBlockReplace(content, oldString, newString) {
-  const normalizedContent = normalizeNewlines(content);
-  const contentLines = splitNormalizedLines(content);
-  const oldLines = trimTrailingEmptyLines(splitNormalizedLines(oldString));
-  const newLines = splitNormalizedLines(newString);
-  if (oldLines.length === 0) {
-    return null;
-  }
+function hasLineNumberPrefixes(lines) {
+  const nonEmpty = lines.filter((l) => l.trim().length > 0);
+  return nonEmpty.length > 0 && nonEmpty.every((l) => /^\d+: /.test(l));
+}
+function stripLineNumberPrefixes(lines) {
+  return lines.map((l) => l.replace(/^\d+: /, ""));
+}
+function matchLooseBlock(contentLines, oldLines, newLines, newlineStyle, content) {
   for (let start = 0; start < contentLines.length; start += 1) {
     let contentIndex = start;
     let oldIndex = 0;
@@ -16545,12 +16545,32 @@ function tryLooseBlockReplace(content, oldString, newString) {
       ].join("\n");
       return {
         occurrencesBefore: 1,
-        content: detectNewlineStyle(content) === "crlf" ? replacedNormalized.replace(/\n/g, "\r\n") : replacedNormalized
+        content: newlineStyle === "crlf" ? replacedNormalized.replace(/\n/g, "\r\n") : replacedNormalized
       };
     }
   }
   return null;
 }
+function tryLooseBlockReplace(content, oldString, newString) {
+  const contentLines = splitNormalizedLines(content);
+  const oldLines = trimTrailingEmptyLines(splitNormalizedLines(oldString));
+  const newLines = splitNormalizedLines(newString);
+  const newlineStyle = detectNewlineStyle(content);
+  if (oldLines.length === 0) {
+    return null;
+  }
+  const result = matchLooseBlock(contentLines, oldLines, newLines, newlineStyle, content);
+  if (result !== null) {
+    return result;
+  }
+  if (hasLineNumberPrefixes(oldLines)) {
+    const strippedOldLines = trimTrailingEmptyLines(stripLineNumberPrefixes(oldLines));
+    if (strippedOldLines.length > 0) {
+      return matchLooseBlock(contentLines, strippedOldLines, newLines, newlineStyle, content);
+    }
+  }
+  return null;
+}
 function countOccurrences(text, target) {
   if (target.length === 0) {
     throw createGbkError("GBK_EMPTY_OLD_STRING", "oldString \u4E0D\u80FD\u4E3A\u7A7A");
@@ -16964,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()) {
@@ -17025,12 +17085,28 @@ var gbk_edit_default = tool({
 Reads the FULL file content regardless of file size \u2014 not limited by gbk_read's line window.
 Safe to use on files with more than 2000 lines.
 
+CRITICAL \u2014 do NOT include line number prefixes in oldString or newString:
+gbk_read output looks like "3787: SENDMSG 0 content". The "3787: " is a navigation prefix, NOT file content.
+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)
+3. gbk_edit(oldString=<content without prefixes>, newString=<new content>)
+
 For large files, use 'startLine'/'endLine' or 'startAnchor'/'endAnchor' to narrow the search scope
 and avoid false matches. Scoped edits also improve performance on very large files.`,
   args: {
     filePath: tool.schema.string().describe("Target file path"),
-    oldString: tool.schema.string().describe("Exact text to replace (must match file content, not gbk_read output with line numbers)"),
-    newString: tool.schema.string().describe("Replacement text"),
+    oldString: tool.schema.string().describe("Exact text to replace \u2014 raw file content only, no 'N: ' line number prefixes from gbk_read output"),
+    newString: tool.schema.string().describe("Replacement text \u2014 raw content only, no line number prefixes"),
     replaceAll: tool.schema.boolean().optional().describe("Replace all occurrences (default: false, requires unique match)"),
     startLine: tool.schema.union([tool.schema.number().int().positive(), tool.schema.literal(-1)]).optional().describe("Restrict edit scope to 1-based start line (inclusive)"),
     endLine: tool.schema.union([tool.schema.number().int().positive(), tool.schema.literal(-1)]).optional().describe("Restrict edit scope to 1-based end line (inclusive)"),
@@ -17052,14 +17128,23 @@ var gbk_read_default = tool({
 Returns up to 'limit' lines (default 2000) starting from 'offset'.
 When the file has more lines than the window, 'truncated' is true and 'totalLines' shows the full count.
 
-IMPORTANT: If 'truncated' is true, the returned content is incomplete.
-DO NOT use the returned content as 'oldString' for gbk_edit on a truncated file.
-To edit content beyond the visible window, use gbk_edit with 'startLine'/'endLine' to target the exact range,
-or read the specific range first with 'offset' set to the desired line number.`,
+IMPORTANT \u2014 line number format: each output line is prefixed with "N: " (e.g. "3787: content").
+These prefixes are for navigation only. Strip them before using any line as 'oldString' in gbk_edit.
+
+IMPORTANT \u2014 do NOT use large limits to read the whole file:
+- Setting limit=40000 or similar to "read everything" is WRONG. It produces an enormous response
+  that is unreliable to process and may be truncated by the protocol.
+- To find content in a large file, use gbk_search instead.
+- To read a specific section, set offset=<lineNumber> and limit=<small number like 10-30>.
+
+Workflow when truncated=true:
+1. gbk_search(pattern) \u2192 get exact lineNumber
+2. gbk_read(offset=<lineNumber>, limit=20) \u2192 get the exact block
+3. gbk_edit(oldString=<exact content without line prefixes>) \u2192 edit reliably`,
   args: {
     filePath: tool.schema.string().describe("Target file path"),
     offset: tool.schema.union([tool.schema.number().int().positive(), tool.schema.literal(-1)]).optional().describe("1-based start line (default: 1)"),
-    limit: tool.schema.union([tool.schema.number().int().positive(), tool.schema.literal(-1)]).optional().describe("Number of lines to read (default: 2000). Use -1 to apply the default."),
+    limit: tool.schema.union([tool.schema.number().int().positive(), tool.schema.literal(-1)]).optional().describe("Number of lines to read (default: 2000, max recommended: 200). Use -1 to apply the default."),
     tail: tool.schema.boolean().optional().describe("Read last N lines instead of offset-based window"),
     encoding: tool.schema.enum(["gbk", "gb18030"]).optional().describe("Text encoding (default: gbk)"),
     allowExternal: tool.schema.boolean().optional().describe("Allow paths outside workspace root")
@@ -17099,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,18 +1,18 @@
 {
   "manifestVersion": 1,
   "packageName": "opencode-gbk-tools",
-  "packageVersion": "0.1.6",
+  "packageVersion": "0.1.8",
   "artifacts": [
     {
       "relativePath": "tools/gbk_edit.js",
       "kind": "tool",
-      "expectedHash": "3d0eb2fab5e3eca869923c2a3cc00e58ed429a4be4dbed22d13e5a5343bd5acc",
+      "expectedHash": "68d8398eae66592166de62e1bdce35ac51a6c22f27e6b48eca83c62370bc44f5",
       "hashAlgorithm": "sha256"
     },
     {
       "relativePath": "tools/gbk_read.js",
       "kind": "tool",
-      "expectedHash": "799c53835bfe7237c5bf1e4858a67d20fffe00f90958ef48b72877cb95c1c07f",
+      "expectedHash": "90c0c3ca519000bcc1fc65f84615a5a280866a45104d08678f3ed92dbfda9f45",
       "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.6",
+  "version": "0.1.8",
   "description": "GBK/GB18030 custom tools and agent for OpenCode",
   "type": "module",
   "license": "MIT",