文件系统(1) 大内容写入 调用方通常只需要传入 content。当写入内容较大时,SDK 和服务会自动适配处理,调用方式保持不变。 建议业务侧按普通文本写入方式调用,不需要关注内部传输方式。 移动文件 plaintext await session.filesystem.movefile({ source: 'C:/aiusertest/result.txt', destination: 'C:/aiusertest/archive/result.txt' }); movefile 可用于移动或重命名文件、目录。目标父目录不存在时会自动创建。 搜索文件 plaintext const result await session.filesystem.searchfiles({ path: 'C:/aiusertest', pattern: '.txt', matchMode: 'wildcard' }); console.log(result.data.matches); matchMode 支持: matchMode 说明 wildcard 通配符匹配,例如 .txt regex 正则表达式匹配 exact 精确文件名匹配 返回结构示例: plaintext { "matches": [ "C:aiusertestresult.txt" ], "pattern": ".txt", "matchMode": "wildcard", "path": "C:aiusertest", "truncated": false } 路径安全建议 FileSystem 工具具备读写目标云电脑文件的能力。业务系统应限制可操作的目录范围,避免误读、误写系统文件或敏感目录。 建议为任务分配独立工作目录,例如: plaintext C:/aiuse/tasks/{taskId} 使用建议 文本大文件建议使用 offset 和 length 分片读取。 写入文件前应明确 mode,避免误覆盖。 不建议使用 readfile 读取二进制文件。 对外共享文件内容或截图前应进行必要脱敏。
来自: