Lark Streaming Patch

README

# OpenClaw Lark Streaming Card Patch

OpenClaw 飞书流式卡片工具调用显示增强补丁（V3）。

## 解决的问题

OpenClaw 官方飞书插件在长链推理场景下，工具调用步骤无法在流式卡片中实时展示，用户必须等整轮对话结束后才能看到完整的工具执行记录。

## 改动文件

| 文件 | 改动内容 |
|:-----|:---------|
| `tool-use-trace-store.js` | 三级 O(1) session 路由查找（精确 → 构造 → 前缀兜底），修复 session key 不匹配导致工具追踪失效 |
| `streaming-card-controller.js` | 移除文本阻断条件，工具状态与文本双通道并行；优先级更新队列串行执行；自适应节流/熔断器/指数退避重试 |
| `reply-dispatcher-types.js` | 新增 `ADAPTIVE_THROTTLE`、`RETRY_CONFIG`、`UPDATE_PRIORITY` 常量定义 |

## V3 特性

- **自适应节流**：根据 API 响应时间动态调整间隔（500ms~3000ms）
- **熔断器**：连续 5 次失败暂停 30s，自动恢复
- **指数退避重试**：最多 3 次，100ms 起步 ×2 退避
- **优先级更新队列**：工具状态 + 文本合并入队，按优先级串行执行
- **效果**：工具步骤实时可见延迟从整轮结束优化到 1.5s 以内

## 安装

```bash
cp src/card/tool-use-trace-store.js ~/.openclaw/extensions/openclaw-lark/src/card/
cp src/card/streaming-card-controller.js ~/.openclaw/extensions/openclaw-lark/src/card/
cp src/card/reply-dispatcher-types.js ~/.openclaw/extensions/openclaw-lark/src/card/
```

## 注意事项

- OpenClaw 升级或飞书插件重装会覆盖 `~/.openclaw/extensions/openclaw-lark/`，补丁需要重新安装
- 基于插件版本 2026.4.x，新版本可能有其他改动，安装前建议对比

## License

MIT