一、什么是文件储存模块

二、文件储存模块有哪些功能

1. OSS存储开关 控制用例执行截图、Bug错误截图、缩略图、素材等文件是否存储到OSS。启用后这些文件将自动上传至OSS，不再占用本地磁盘空间。

1. 本地文件配置表格 展示四类文件的详细信息，包括：

• 附件文件：用例截图、Bug截图等，存储路径 /home/meta/maifast/external_resource
• 代码文件：AI生成的代码项目，存储路径 /home/meta/maifast/ai_dev_projects
• 技能文件：AI工坊技能资源，存储路径 /home/meta/maifast/ai_skills
• MCP文件：MCP插件文件，存储路径 /home/meta/maifast/ai_mcp/system

1. 定期清理 附件文件支持设置清理周期（如30天）。开启后，系统会在每天凌晨2:00自动删除超过清理周期的过期文件。
2. 存储空间监控 通过表格直观查看代码、技能、附件等各类文件的磁盘占用情况，方便及时清理冗余数据。
3. OSS配置入口 通过「前往配置」按钮跳转到OSS配置页面，设置OSS的Endpoint、AccessKey、SecretKey、Bucket等信息。

三、常见操作

1. 开启或关闭OSS存储 在「OSS存储」区域，点击开关按钮即可开启或关闭。开启后，用例执行截图、Bug错误截图、缩略图、素材将自动存储至OSS。

1. 前往配置OSS 开启OSS存储开关后，页面会出现提示文字和「前往配置」按钮。点击该按钮进入OSS配置页面，填写OSS的Endpoint、AccessKey、SecretKey、Bucket名称等信息并保存。——具体配置方法见开发配置的oss配置——OSS配置
2. 查看文件存储详情 在文件配置表格中，点击附件文件行的「查看」按钮，可以查看该存储位置下的文件列表和详细信息。

1. 设置附件清理周期 在文件配置表格的附件文件行，开启「定期清理」开关，然后设置清理周期（单位：天）。例如设置为30天，系统会在每天凌晨2:00自动删除超过30天的附件文件。
2. 监控磁盘空间 定期查看表格中各文件类型的「大小」列，关注代码文件 等可能占用较大空间的类型。发现空间不足时，及时手动清理不再使用的文件。

四、常见使用场景

五、注意事项

1. 只有附件文件（external_resource）支持定期清理。代码、技能、MCP等文件类型不支持自动清理，需要管理员手动维护。
2. 清理操作在每天凌晨2:00自动执行，不是实时生效的。设置30天清理周期后，文件会在存入满30天后的下一个凌晨2:00被删除。
3. OSS存储需要先在「前往配置」页面完成OSS信息配置后才能正常使用。只开启开关而未配置OSS，文件将仍然存储在本地。
4. 代码文件（ai_dev_projects）占用空间可能很大，建议定期检查并清理不再使用的项目代码，避免磁盘写满影响平台正常运行。
5. 文件存储页面是平台级别的全局配置，只有管理员权限才能访问和操作。普通用户无法看到此页面。
6. 开启OSS存储后，已在本地存储的历史文件不会自动迁移到OSS，仅新产生的文件会存储至OSS。
7. 附件文件包括：用例执行截图、Bug的错误截图、缩略图、素材等。这些文件支持存储到本地或OSS。除附件外，其他类型的文件（代码、技能、MCP）都只存储在本地。