opencode-gbk-tools 0.1.4 → 0.1.6

package/dist/plugin/index.js

@@ -16811,6 +16811,22 @@ async function replaceLargeGbkFileText(input) {
     throw error45;
   }
 }
+async function loadGbkTextFile(input) {
+  const resolved = await resolveReadableGbkFile(input);
+  if (resolved.stat.size < STREAMING_FILE_SIZE_THRESHOLD_BYTES) {
+    return await readWholeGbkTextFile(resolved);
+  }
+  const chunks = [];
+  await visitDecodedTextChunks(resolved, (text) => {
+    chunks.push(text);
+  });
+  return {
+    filePath: resolved.filePath,
+    encoding: resolved.encoding,
+    content: chunks.join(""),
+    bytesRead: resolved.stat.size
+  };
+}
 async function readGbkFile(input) {
   const offset = normalizeOptionalPositiveInteger(input.offset, "offset") ?? 1;
   const limit = normalizeOptionalPositiveInteger(input.limit, "limit") ?? 2e3;
@@ -16911,6 +16927,39 @@ async function replaceGbkFileText(input) {
     bytesWritten: buffer.byteLength
   };
 }
+async function searchGbkFile(input) {
+  if (input.pattern.length === 0) {
+    throw createGbkError("GBK_INVALID_ARGUMENT", "pattern \u4E0D\u80FD\u4E3A\u7A7A");
+  }
+  const contextLines = Math.max(0, input.contextLines ?? 3);
+  const resolved = await resolveReadableGbkFile(input);
+  const loaded = await loadGbkTextFile({
+    filePath: resolved.filePath,
+    encoding: resolved.encoding,
+    allowExternal: input.allowExternal,
+    context: input.context
+  });
+  const lines = loaded.content.split(/\r?\n/);
+  const totalLines = lines.length;
+  const matches = [];
+  for (let i = 0; i < lines.length; i += 1) {
+    if (lines[i].includes(input.pattern)) {
+      matches.push({
+        lineNumber: i + 1,
+        line: lines[i],
+        contextBefore: lines.slice(Math.max(0, i - contextLines), i),
+        contextAfter: lines.slice(i + 1, Math.min(totalLines, i + 1 + contextLines))
+      });
+    }
+  }
+  return {
+    filePath: resolved.filePath,
+    encoding: resolved.encoding,
+    totalLines,
+    matchCount: matches.length,
+    matches
+  };
+}
 async function writeGbkFile(input) {
   const encoding = input.encoding ?? "gbk";
   const createDirectories = input.createDirectories ?? true;
@@ -16971,17 +17020,23 @@ async function writeGbkFile(input) {
 
 // src/tools/gbk_edit.ts
 var gbk_edit_default = tool({
-  description: "Edit GBK encoded text files with exact replacement",
+  description: `Edit GBK/GB18030 encoded text files with exact string replacement.
+
+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.
+
+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("Text to replace"),
+    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"),
-    replaceAll: tool.schema.boolean().optional().describe("Replace all occurrences"),
-    startLine: tool.schema.union([tool.schema.number().int().positive(), tool.schema.literal(-1)]).optional().describe("Restrict edit to 1-based start line"),
-    endLine: tool.schema.union([tool.schema.number().int().positive(), tool.schema.literal(-1)]).optional().describe("Restrict edit to 1-based end line"),
-    startAnchor: tool.schema.string().optional().describe("Restrict edit to content after this anchor"),
-    endAnchor: tool.schema.string().optional().describe("Restrict edit to content before this anchor"),
-    encoding: tool.schema.enum(["gbk", "gb18030"]).optional().describe("Text encoding"),
+    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)"),
+    startAnchor: tool.schema.string().optional().describe("Restrict edit to content after this anchor string"),
+    endAnchor: tool.schema.string().optional().describe("Restrict edit to content before this anchor string"),
+    encoding: tool.schema.enum(["gbk", "gb18030"]).optional().describe("Text encoding (default: gbk)"),
     allowExternal: tool.schema.boolean().optional().describe("Allow paths outside workspace root")
   },
   async execute(args, context) {
@@ -16992,13 +17047,21 @@ var gbk_edit_default = tool({
 
 // src/tools/gbk_read.ts
 var gbk_read_default = tool({
-  description: "Read GBK encoded text files",
+  description: `Read GBK/GB18030 encoded text files with line numbers.
+
+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.`,
   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"),
-    limit: tool.schema.union([tool.schema.number().int().positive(), tool.schema.literal(-1)]).optional().describe("Number of lines to read"),
+    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."),
     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"),
+    encoding: tool.schema.enum(["gbk", "gb18030"]).optional().describe("Text encoding (default: gbk)"),
     allowExternal: tool.schema.boolean().optional().describe("Allow paths outside workspace root")
   },
   async execute(args, context) {
@@ -17007,6 +17070,33 @@ var gbk_read_default = tool({
   }
 });
 
+// src/tools/gbk_search.ts
+var gbk_search_default = tool({
+  description: `Search for exact text in GBK/GB18030 files. Returns matching line numbers and surrounding context.
+
+Use this BEFORE gbk_edit when:
+- gbk_read returned truncated: true (file has more than the visible window of lines)
+- You need to verify the exact content and line number before constructing oldString for gbk_edit
+- You are unsure whether a string exists in the file
+
+Workflow for large files:
+1. gbk_read \u2192 if truncated: true, use gbk_search to locate the target
+2. gbk_search \u2192 get exact lineNumber and contextAfter/contextBefore
+3. gbk_read(offset=<lineNumber>, limit=<N>) \u2192 get the exact block of text
+4. gbk_edit with the exact content as oldString`,
+  args: {
+    filePath: tool.schema.string().describe("Target file path"),
+    pattern: tool.schema.string().describe("Exact string to search for (case-sensitive, plain text, not regex)"),
+    contextLines: tool.schema.number().int().nonnegative().optional().describe("Number of context lines to return before and after each match (default: 3)"),
+    encoding: tool.schema.enum(["gbk", "gb18030"]).optional().describe("Text encoding (default: gbk)"),
+    allowExternal: tool.schema.boolean().optional().describe("Allow paths outside workspace root")
+  },
+  async execute(args, context) {
+    const result = await searchGbkFile({ ...args, context });
+    return JSON.stringify(result, null, 2);
+  }
+});
+
 // src/tools/gbk_write.ts
 var gbk_write_default = tool({
   description: "Write GBK encoded text files",
@@ -17032,7 +17122,8 @@ var pluginModule = {
       tool: {
         gbk_read: gbk_read_default,
         gbk_write: gbk_write_default,
-        gbk_edit: gbk_edit_default
+        gbk_edit: gbk_edit_default,
+        gbk_search: gbk_search_default
       }
     };
   }

package/dist/release-manifest.json

@@ -1,18 +1,24 @@
 {
   "manifestVersion": 1,
   "packageName": "opencode-gbk-tools",
-  "packageVersion": "0.1.4",
+  "packageVersion": "0.1.6",
   "artifacts": [
     {
       "relativePath": "tools/gbk_edit.js",
       "kind": "tool",
-      "expectedHash": "6a8a26850a21e47a9ececc2b8606452491a654d5fc79ef908cfbcea9e6c5b7e3",
+      "expectedHash": "3d0eb2fab5e3eca869923c2a3cc00e58ed429a4be4dbed22d13e5a5343bd5acc",
       "hashAlgorithm": "sha256"
     },
     {
       "relativePath": "tools/gbk_read.js",
       "kind": "tool",
-      "expectedHash": "c61e5ee95e05e96965c76e5dc2f18b3943bc3c2a76567b415839442358024d46",
+      "expectedHash": "799c53835bfe7237c5bf1e4858a67d20fffe00f90958ef48b72877cb95c1c07f",
+      "hashAlgorithm": "sha256"
+    },
+    {
+      "relativePath": "tools/gbk_search.js",
+      "kind": "tool",
+      "expectedHash": "dc779c10156dacf1e88195d68445dcd25da0f279b30887559da2a8d5c32b1a02",
       "hashAlgorithm": "sha256"
     },
     {
@@ -24,7 +30,7 @@
     {
       "relativePath": "agents/gbk-engine.md",
       "kind": "agent",
-      "expectedHash": "755b6278033400bdc08bb0d7dc491eabe5aa3a0157c6bef4304c7a5f2038c0dd",
+      "expectedHash": "3ff7de130d4fd3c318627efd56e2be08ec6ea5b9d37b3d6bf4a7122a9e0997b1",
       "hashAlgorithm": "sha256"
     }
   ]

package/package.json

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