概述
文件发送功能（9条消息）是 fries-mac 通过 Mattermost 向用户发送文件附件的能力。这一看似简单的功能在实践中遇到了多次障碍，需要正确调用 Mattermost 文件上传 API。
关键事件
- 2026-03-03: 用户要求发送文件，Agent 无法正确执行
- 2026-03-10: 用户强调”让你发文件你就必须发文件，要想办法发出来”
- 2026-03-15: 确认文件发送流程：先将文件复制到工作区，再通过 API 上传
- 2026-03-20: TTS 语音文件发送成功验证了文件上传流程
- 2026-04-01: 用户再次确认 Agent 是否记得如何发送文件
技术要点
- API 流程: Mattermost 文件上传 API → 获取 file_id → 创建带附件的 post
- 文件路径: 文件必须在 Agent 可访问的工作区路径中
- 支持格式: 图片、音频、文档等均可作为附件发送
经验教训
- Agent 不能仅输出文件路径来”发送文件”，必须调用 API 完成实际上传
- 文件发送是基础能力，必须确保记忆中有正确的发送流程
- 遇到文件发送失败时要主动排查 API 调用是否正确
- 将操作流程记入长期记忆，避免反复失败