# baoyu-workbench-ops — feishu api

### 🔴 folder 类型消息被网关静默忽略

**症状**：用户说"发完了"，但 `~/.hermes/cache/documents/`、Downloads、飞书容器、全盘 find 都找不到新文件。

**诊断（关键：查网关日志的消息类型，不要反复 find）**：
```bash
grep "Received raw message type=" ~/.hermes/logs/gateway.log | tail -20
```
对比：
- **file/document 类型**（能收到）→ 完整链：`type=file` → `Inbound ... media=1` → `Flushing media batch ... with N attachment(s)` → 落盘 `cache/documents/doc_xxx`
- **folder 类型**（丢失）→ 只有 `Received raw message type=folder`，之后**无任何 Inbound/media 记录** = 网关收到但忽略，整包丢弃

**根因**：Hermes 飞书网关处理 file/document，但不处理 folder（飞书云盘文件夹卡片），不展开其中文件。

**解决**（让用户三选一，最省事是给路径）：① 改发单个文件 ② 打包 zip ③ 给本地完整路径让 agent 自己读。