Remote Executor 文件高级层 (v3.5)

注意: 此 skill 由关键词触发加载，不要常驻。

核心特性

• 自动编码检测: encoding: "auto" 自动识别 UTF-8 / GBK
• 精准行替换: start_line + end_line 替换指定行范围
• 明确插入模式: insert: true 在指定行前插入，不替换任何行
• 自动备份: .bak 文件自动创建
• Diff 对比: 每次修改返回 unified diff（限8000字符）
• 行号读取: include_line_numbers 带行号输出

端点

读取文件（支持行范围、行号、自动编码）

POST /file/read
Content-Type: application/json

{
  "path": "D:\\file.txt",
  "encoding": "auto",            // "auto" | "utf-8" | "gbk" | "binary"
  "offset": 1,                   // 起始行号（1-based，0=全部）
  "limit": 50,                   // 读取行数（0=全部）
  "include_line_numbers": true   // 是否带行号输出
}

返回（行范围模式）:

{
  "content": "    1: line1\n    2: line2...",
  "encoding": "utf-8",
  "total_lines": 100,
  "from_line": 1,
  "to_line": 50,
  "truncated": false,
  "include_line_numbers": true
}

写入文件（三种模式 + diff 返回）

#### 模式1: 插入行（推荐）

POST /file/write
Content-Type: application/json

{
  "path": "D:\\file.txt",
  "content": "new line 1\nnew line 2\n",
  "encoding": "auto",      // "auto" 自动检测原文件编码
  "start_line": 10,       // 在第10行之前插入
  "insert": true,         // 明确插入模式
  "backup": true          // 是否自动创建 .bak 备份
}

返回:

{
  "message": "插入成功 at line 10",
  "path": "D:\\file.txt",
  "size": 500,
  "total_lines": 102,
  "affected_lines": 2,
  "backup": "D:\\file.txt.bak",
  "mode": "insert",
  "diff": "--- before\n+++ after\n@@ -8,3 +8,5 @@\n line8\n line9\n+new line 1\n+new line 2\n line10"
}

#### 模式2: 替换行

POST /file/write
Content-Type: application/json

{
  "path": "D:\\file.txt",
  "content": "new line 1\nnew line 2\n",
  "encoding": "auto",
  "start_line": 10,       // 替换起始行
  "end_line": 15,         // 替换结束行（0=到文件末尾）
  "insert": false,        // 替换模式（默认）
  "backup": true
}

返回:

{
  "message": "替换成功 at line 10",
  "mode": "replace",
  "diff": "..."
}

#### 模式3: 传统全文件写入/追加（也返回 diff）

POST /file/write
Content-Type: application/json

{
  "path": "D:\\file.txt",
  "content": "全部内容",
  "encoding": "auto",
  "append": false,       // false=覆盖写入, true=追加
  "backup": true         // 覆盖时自动备份原文件
}

搜索文件

POST /file/search
Content-Type: application/json

{
  "pattern": "*.py",
  "path": "C:\\Projects",
  "recursive": true,
  "limit": 50
}

使用示例

读取文件前50行（带行号，自动编码）:

curl -s -X POST http://<host>:8765/file/read \
  -H "Content-Type: application/json" \
  -d '{"path": "D:\\\\script.py", "encoding": "auto", "offset": 1, "limit": 50, "include_line_numbers": true}'

在第100行前插入新代码（自动编码检测 + 备份 + diff）:

curl -s -X POST http://<host>:8765/file/write \
  -H "Content-Type: application/json" \
  -d '{
    "path": "D:\\\\script.py",
    "content": "def new_func():\n    pass\n",
    "encoding": "auto",
    "start_line": 100,
    "insert": true,
    "backup": true
  }'

替换第10-15行:

curl -s -X POST http://<host>:8765/file/write \
  -H "Content-Type: application/json" \
  -d '{
    "path": "D:\\\\script.py",
    "content": "def new_func():\n    pass\n",
    "encoding": "auto",
    "start_line": 10,
    "end_line": 15,
    "insert": false,
    "backup": true
  }'

全文覆盖写入（自动编码 + 备份 + diff）:

curl -s -X POST http://<host>:8765/file/write \
  -H "Content-Type: application/json" \
  -d '{"path": "D:\\\\new.txt", "content": "hello", "encoding": "auto", "backup": true}'

搜索 .py 文件:

curl -s -X POST http://<host>:8765/file/search \
  -H "Content-Type: application/json" \
  -d '{"path": "D:\\\\PythonProject", "pattern": "*.py", "recursive": true, "limit": 20}'