FileManager Transfer
当用户与 agent 远程环境之间传递文件时,使用这个技能。scripts/ 里的 FileManager 程序负责提供文件中转服务,Python 脚本只是调用 API 的便捷封装。
首次使用
- 访问https://github.com/mrknow001/FileManager/releases下载可执行程序
- 启动scripts目录下服务端程序
- 访问web页面设置密码或者使用./filemanager-linux-amd64 -reset-password your_password初始化密码
- 访问后台创建appkey
- 配置
scripts/.env
使用流程
- 先判断传输方向:
- agent 发给用户:上传文件,创建带密码的分享链接,把链接和密码给用户。
- 用户发给 agent:让用户通过 FileManager 上传,或提供 FileManager 文件 ID,然后下载。
- 脚本用法只参考
references/transfer-script.md。 - 脚本失败时,不要盲猜。先阅读错误,参考
references/troubleshooting.md 修复配置或服务状态,然后重试一次。 - 如果 FileManager 可访问但脚本仍失败,可按 references 中
api.md记录的 API 行为兜底,并向用户说明已尝试的操作。
参考文档
references/install-and-start.md:安装、配置和启动 FileManager 服务。references/transfer-script.md:scripts/filemanager_transfer.py 的上传、分享、下载命令。references/troubleshooting.md:常见失败原因和恢复步骤。
规则
- 不要硬编码或泄露
FILEMANAGER_APPKEY。 - 除非用户明确只需要上传保存,否则创建分享链接时必须设置非空密码(默认4位数字字母组合)。
- 临时传输优先使用短有效期分享。
- 输出应聚焦于链接、密码、文件 ID 或本地保存路径。