feat: read_file 全面增强 — binary模式/字节分页/5MB限制/截断提示hint/offset_bytes+limit_bytes

2026-06-10 14:11:08 +08:00
parent f8842f195e
commit 751f548b0c
2 changed files with 116 additions and 13 deletions
@@ -13,15 +13,18 @@ export const TOOL_DEFINITIONS: ToolDefinition[] = [
    type: 'function',
    function: {
      name: 'read_file',
-      description: 'Read the contents of a local file. Returns the file content as a string. Supports text files up to 1MB. Use start_line/end_line for large files.',
+      description: 'Read a file from the local filesystem. Supports text mode (utf-8/latin1, line-based pagination) and binary mode (base64, byte-based pagination). Files up to 5MB (text) or 50MB (binary). When truncated, returns remaining_lines/remaining_bytes and a hint to continue reading. Use start_line/end_line for text files, offset_bytes/limit_bytes for binary files or raw byte access.',
      parameters: {
        type: 'object',
        required: ['path'],
        properties: {
-          path: { type: 'string', description: 'The file path to read. Absolute or relative.' },
-          encoding: { type: 'string', enum: ['utf-8', 'latin1', 'base64'], description: 'File encoding. Default: utf-8' },
-          start_line: { type: 'integer', description: 'Start line (1-indexed). For reading specific sections.' },
-          end_line: { type: 'integer', description: 'End line (inclusive). Default: start_line + 500.' }
+          path: { type: 'string', description: 'The file path to read. Absolute or relative to workspace.' },
+          encoding: { type: 'string', enum: ['utf-8', 'latin1', 'base64'], description: 'File encoding. Default: utf-8. Use base64 for binary content.' },
+          start_line: { type: 'integer', description: 'Start line (1-indexed) for text files. Use with end_line for pagination.' },
+          end_line: { type: 'integer', description: 'End line (inclusive). Default: start_line + 500.' },
+          mode: { type: 'string', enum: ['text', 'binary'], description: 'Read mode. text = decode as string, binary = return base64. Default: text.' },
+          offset_bytes: { type: 'integer', description: 'Byte offset to start reading from (0-indexed). Use for binary files or large text.' },
+          limit_bytes: { type: 'integer', description: 'Max bytes to read. Default: 50000 (text) or 102400 (binary).' }
        }
      }
    }