以下示例以 desktopCode=xxx 为例，实际调用时请替换为目标云电脑的桌面编码。

工具列表

create_directory

创建目录。若父目录不存在，会自动创建父目录。

{
  "name": "create_directory",
  "arguments": {
    "desktopCode": "xxx",
    "path": "C:/ai-user-test"
  }
}

read_file

读取文本文件内容，支持按偏移量和长度读取。

{
  "name": "read_file",
  "arguments": {
    "desktopCode": "xxx",
    "path": "C:/ai-user-test/demo.txt",
    "offset": 0,
    "length": 1024
  }
}

返回内容中通常包含：

{
  "encoding": "utf-8",
  "offset": 0,
  "bytesRead": 1024,
  "path": "C:/ai-user-test/demo.txt",
  "content": "file content"
}

当读取内容较大时，系统会自动适配处理。调用方仍按普通文本读取结果使用即可。

write_file

写入文本文件。

{
  "name": "write_file",
  "arguments": {
    "desktopCode": "xxx",
    "path": "C:/ai-user-test/result.txt",
    "mode": "overwrite",
    "content": "result content"
  }
}

参数说明：

调用方通常只需要传入 content。当内容较大时，系统会自动适配处理。

move_file

移动或重命名文件、目录。

{
  "name": "move_file",
  "arguments": {
    "desktopCode": "xxx",
    "source": "C:/ai-user-test/result.txt",
    "destination": "C:/ai-user-test/archive/result.txt"
  }
}

search_files

在指定目录下搜索文件。

{
  "name": "search_files",
  "arguments": {
    "desktopCode": "xxx",
    "path": "C:/ai-user-test",
    "pattern": "*.txt",
    "matchMode": "wildcard"
  }
}

matchMode 支持：

使用建议

• 建议为每个任务分配独立工作目录，例如 C:/ai-use/tasks/{taskId}。

• 写入文件前应明确 mode，避免误覆盖。

• 文件读取当前面向文本文件，二进制文件不建议通过 read_file 读取。

• 文件系统工具具备读写目标云电脑文件的能力，应仅对可信任务开放。

• search_files 当前返回文件匹配结果，不作为完整目录列表接口使用。