文件系统 - Agent Client Protocol

文件系统方法允许代理在客户端环境中读取和写入文本文件。这些方法使代理能够访问未保存的编辑器状态，并允许客户端跟踪代理执行期间所做的文件修改。

检查支持

在尝试使用文件系统方法之前，代理必须通过在 initialize 响应中检查客户端功能字段来验证客户端是否支持这些功能：

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "protocolVersion": 1,
    "clientCapabilities": {
      "fs": {
        "readTextFile": true,
        "writeTextFile": true
      }
    }
  }
}

如果 readTextFile 或 writeTextFile 为 false 或不存在，则代理不得尝试调用相应的文件系统方法。

读取文件

fs/read_text_file 方法允许代理从客户端文件系统读取文本文件内容，包括编辑器中未保存的更改。

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "fs/read_text_file",
  "params": {
    "sessionId": "sess_abc123def456",
    "path": "/home/user/project/src/main.py",
    "line": 10,
    "limit": 50
  }
}

sessionId

SessionId

required

此请求的会话 ID

path

string

required

要读取的文件的绝对路径

line

number

可选的开始读取行号（从1开始）

limit

number

可选的最大读取行数

客户端响应文件内容：

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": "def hello_world():\n    print('Hello, world!')\n"
  }
}

写入文件

fs/write_text_file 方法允许代理在客户端文件系统中写入或更新文本文件。

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "fs/write_text_file",
  "params": {
    "sessionId": "sess_abc123def456",
    "path": "/home/user/project/config.json",
    "content": "{\n  \"debug\": true,\n  \"version\": \"1.0.0\"\n}"
  }
}

sessionId

SessionId

required

此请求的会话 ID

path

string

required

要写入的文件的绝对路径。如果文件不存在，客户端必须创建该文件。

content

string

required

要写入文件的文本内容

客户端在成功时响应空结果：

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": null
}

​检查支持

​读取文件

​写入文件

检查支持

读取文件

写入文件