feat: enhance read_file tool with extended parameters and improve security handling

- Extended read_file tool parameters to include file_path, offset, and limit for more granular file access
- Updated tool call conversions between Gemini and OpenAI formats to use new parameter structure
- Modified security configuration to use exclude list instead of blocklist for better control
- Updated documentation and examples to reflect new parameter naming and security model
- Adjusted JSON parsing demo scenarios to demonstrate new tool parameter structure

Author: tt-a1i

src/pages/ContentConverterAnimation.tsx

@@ -155,15 +155,31 @@ convertGeminiToolsToOpenAI(tools: Tool[]): ChatCompletionTool[] {
         functionDeclarations: [{
           name: 'read_file',
           description: '读取文件内容',
-          parameters: { type: 'object', properties: { path: { type: 'string' } } }
+          parameters: {
+            type: 'object',
+            properties: {
+              file_path: { type: 'string' },
+              offset: { type: 'number' },
+              limit: { type: 'number' },
+            },
+            required: ['file_path'],
+          }
         }]
       },
       openaiTool: {
         type: 'function',
         function: {
           name: 'read_file',
           description: '读取文件内容',
-          parameters: { type: 'object', properties: { path: { type: 'string' } } }
+          parameters: {
+            type: 'object',
+            properties: {
+              file_path: { type: 'string' },
+              offset: { type: 'number' },
+              limit: { type: 'number' },
+            },
+            required: ['file_path'],
+          }
         }
       }
     },
@@ -212,7 +228,7 @@ private convertContent(content: Content): ChatCompletionMessageParam {
         role: 'model',
         parts: [
           { text: '我来读取这个文件' },
-          { functionCall: { name: 'read_file', args: { path: 'index.ts' } } }
+          { functionCall: { name: 'read_file', args: { file_path: 'index.ts', offset: 0, limit: 200 } } }
         ]
       },
       openaiMessage: {
@@ -221,7 +237,7 @@ private convertContent(content: Content): ChatCompletionMessageParam {
         tool_calls: [{
           id: 'call_xxx',
           type: 'function',
-          function: { name: 'read_file', arguments: '{"path":"index.ts"}' }
+          function: { name: 'read_file', arguments: '{"file_path":"index.ts","offset":0,"limit":200}' }
         }]
       }
     },
@@ -253,14 +269,14 @@ private buildToolCallMessage(
 }
 
 // 关键转换:
-// Gemini: { name: "read", args: { path: "x.ts" } }
-// OpenAI: { name: "read", arguments: '{"path":"x.ts"}' }
+// Gemini: { name: "read", args: { file_path: "x.ts" } }
+// OpenAI: { name: "read", arguments: '{"file_path":"x.ts"}' }
 //                         ^^^^^^^^^ 字符串化！`,
     visualData: {
       gemini: {
         functionCall: {
           name: 'read_file',
-          args: { path: 'index.ts', encoding: 'utf-8' }
+          args: { file_path: 'index.ts', offset: 0, limit: 200 }
         }
       },
       openai: {
@@ -269,7 +285,7 @@ private buildToolCallMessage(
           type: 'function',
           function: {
             name: 'read_file',
-            arguments: '{"path":"index.ts","encoding":"utf-8"}'
+            arguments: '{"file_path":"index.ts","offset":0,"limit":200}'
           }
         }]
       }

src/pages/ContentGeneratorDetails.tsx

@@ -553,7 +553,7 @@ private tryRepairAndParse(buffer: string): Record<string, unknown> | null {
             </div>
             <div className="bg-black/30 rounded p-3">
               <div className="text-xs text-gray-400 mb-1">解析结果</div>
-              <code className="text-sm">{`{ completed: true, args: { path: "/src/app.ts" } }`}</code>
+              <code className="text-sm">{`{ completed: true, args: { file_path: "/src/app.ts" } }`}</code>
             </div>
           </div>
         </HighlightBox>

src/pages/FormatConverterAnimation.tsx

@@ -460,7 +460,7 @@ export function convertOpenAIChunkToGemini(
         functionCall: {
           id: "call_abc123",
           name: "read_file",
-          args: { path: "/package.json" }
+          args: { file_path: "/package.json" }
         }
       }],
       role: "model"
@@ -519,7 +519,7 @@ function mapUsageMetadata(usage: OpenAI.CompletionUsage) {
           functionCall: {
             id: "call_abc123",
             name: "read_file",
-            args: { path: "/package.json" }
+            args: { file_path: "/package.json" }
           }
         }
       ],

src/pages/FunctionResponseAnimation.tsx

@@ -442,7 +442,7 @@ function HistoryInjection({ phase }: { phase: BuildPhase }) {
         <div className="p-2 bg-[var(--cyber-blue)]/10 rounded border border-[var(--cyber-blue-dim)]">
           <div className="text-[var(--cyber-blue)] mb-1">role: "model"</div>
           <div className="text-[var(--text-muted)]">
-            functionCall: read_file({'{'}path: "/package.json"{'}'})
+            functionCall: read_file({'{'}file_path: "/package.json"{'}'})
           </div>
         </div>
 

src/pages/IDEDiffProtocol.tsx

@@ -30,7 +30,7 @@ export function IDEDiffProtocol() {
 
   // Diff View 完整交互流程
   const diffFlowChart = `flowchart TD
-    tool([AI 调用<br/>write_file/edit])
+    tool([AI 调用<br/>write_file/replace])
     check_ide{IDE 已连接<br/>且支持 Diff?}
     acquire_mutex[获取 diffMutex<br/>单 Diff 锁]
     send_open[MCP: openDiff<br/>filePath, newContent]
@@ -425,7 +425,7 @@ this.client.setNotificationHandler(
           <div className="bg-gray-800/50 rounded-lg p-4">
             <h4 className="font-semibold text-cyan-400 mb-3">触发条件</h4>
             <ul className="text-sm text-gray-300 space-y-1">
-              <li>• AI 调用 <code className="text-cyan-300">write_file</code> 或 <code className="text-cyan-300">edit</code> 工具</li>
+              <li>• AI 调用 <code className="text-cyan-300">write_file</code> 或 <code className="text-cyan-300">replace</code> 工具</li>
               <li>• IDE 集成已启用（<code className="text-cyan-300">/ide enable</code>）</li>
               <li>• VS Code 插件已安装并连接成功</li>
               <li>• 工作区路径匹配 CLI 运行目录</li>

src/pages/LoopDetection.tsx

@@ -981,7 +981,7 @@ Turn 5: Read({ file_path: "/project/src/config.ts " })              // 加空格
 模糊匹配：归一化后全部相同 -> 触发检测！
 
 归一化结果：
-Turn 1-5: { toolName: "Read", normalizedArgs: { path: "config.ts", offset: "NUMBER" } }
+Turn 1-5: { toolName: "Read", normalizedArgs: { file_path: "config.ts", offset: "NUMBER" } }
 */`}
             language="typescript"
             title="模糊匹配检测"

src/pages/LoopDetectionAnimation.tsx

@@ -170,7 +170,7 @@ private hashToolCall(toolCall: ToolCall): string {
     visualData: {
       toolCall: {
         name: 'read_file',
-        arguments: { path: '/src/index.ts' }
+        arguments: { file_path: '/src/index.ts' }
       },
       hash: 'a3f2b8c1e9d04567'
     },

src/pages/LoopDetectionEngineAnimation.tsx

@@ -40,13 +40,13 @@ type DetectionLayer = 'tool' | 'content' | 'llm';
 
 const SAMPLE_TOOL_CALLS: Omit<ToolCall, 'hash' | 'timestamp'>[] = [
   { id: 't1', name: 'Read', args: '{"file_path": "/src/app.ts"}' },
-  { id: 't2', name: 'Edit', args: '{"file_path": "/src/app.ts", "old": "a", "new": "b"}' },
+  { id: 't2', name: 'Edit', args: '{"file_path": "/src/app.ts", "old_string": "a", "new_string": "b"}' },
   { id: 't3', name: 'Read', args: '{"file_path": "/src/app.ts"}' },
-  { id: 't4', name: 'Edit', args: '{"file_path": "/src/app.ts", "old": "a", "new": "b"}' },
+  { id: 't4', name: 'Edit', args: '{"file_path": "/src/app.ts", "old_string": "a", "new_string": "b"}' },
   { id: 't5', name: 'Read', args: '{"file_path": "/src/app.ts"}' },
-  { id: 't6', name: 'Edit', args: '{"file_path": "/src/app.ts", "old": "a", "new": "b"}' },
-  { id: 't7', name: 'Edit', args: '{"file_path": "/src/app.ts", "old": "a", "new": "b"}' },
-  { id: 't8', name: 'Edit', args: '{"file_path": "/src/app.ts", "old": "a", "new": "b"}' },
+  { id: 't6', name: 'Edit', args: '{"file_path": "/src/app.ts", "old_string": "a", "new_string": "b"}' },
+  { id: 't7', name: 'Edit', args: '{"file_path": "/src/app.ts", "old_string": "a", "new_string": "b"}' },
+  { id: 't8', name: 'Edit', args: '{"file_path": "/src/app.ts", "old_string": "a", "new_string": "b"}' },
 ];
 
 const SAMPLE_CONTENT = "The function calculates. The function calculates. The function calculates. The function calculates. The function calculates. The function calculates. The function calculates. The function calculates. The function calculates. The function calculates. The function calculates. ";