技能介绍

解决的工作区文件管理痛点

在长时间运行的 Agent 任务中，工作区往往会堆积大量中间产物，如脚本、数据文件和日志。当会话结束或上下文达到上限时，这些文件很容易被遗忘在本地，导致新会话无法复用历史成果，甚至因磁盘空间不足而中断任务。File COS Manager 旨在通过自动化归档和云端持久化，解决工作区文件生命周期管理混乱的问题。

核心能力与工作流程

该技能通过 ima_cos_util 工具与腾讯云对象存储（COS）交互，核心流程分为三步：

自动分类归档：任务结束时，根据扩展名和路径规则将文件归类至 code、data、config、output、logs 等目录。
上传与索引：将文件上传至 COS，并同步更新 .cos_index.md 清单，记录 cosKey、类别和会话时间。
跨会话恢复：新会话启动时，自动拉取索引清单并按需下载所需文件到工作区。

适用边界与注意事项

虽然该技能实现了自动化的云存储同步，但仍需注意以下工程细节：

大文件处理：单文件虽无大小限制，但超过 100MB 的文件建议先压缩再上传，避免网络抖动导致超时。
隐私与安全：uploads/ 目录下的用户原始文件默认不上传，仅在明确指令下触发。
垃圾文件清理：上传前会自动忽略 node_modules/、__pycache__/ 和 .git/ 等无关目录，但开发者仍需关注 COS 的存储成本增长。