FileManager Transfer#

当用户与 agent 远程环境之间传递文件时，使用这个技能。 scripts/ 里的 FileManager 程序负责提供文件中转服务，Python 脚本只是调用 API 的便捷封装。

首次使用#

1. 访问 https://github.com/mrknow001/FileManager/releases下载可执行程序

2. 启动scripts目录下服务端程序

3. 访问web页面设置密码或者使用./filemanager-linux-amd64 -reset-password your_password初始化密码

4. 访问后台创建appkey

5. 配置 scripts/.env

使用流程#

1. 先判断传输方向：
   • agent 发给用户：上传文件，创建带密码的分享链接，把链接和密码给用户。
   • 用户发给 agent：让用户通过 FileManager 上传，或提供 FileManager 文件 ID，然后下载。
2. 脚本用法只参考 references/transfer-script.md。
3. 脚本失败时，不要盲猜。先阅读错误，参考 references/troubleshooting.md 修复配置或服务状态，然后重试一次。
4. 如果 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 或本地保存路径。