[BUG] 桌面端同时打开同一 session 时，通过 Telegram 发送指令会导致桌面端出现重复回复

[Terryli246]

提交前确认

• 我已经阅读了 README 常见问题
• 我已经升级到最新版本后复现过这个问题
• 我已经搜索过现有 issues，确认没有重复问题
• 我已经隐藏截图和日志中的 API Key、Token、Cookie 等敏感信息

问题描述

通过 Telegram 向 cc-haha 发送指令时，如果桌面端同时打开了同一个 session 页面，桌面端的 session 页面会显示两条完全相同的助手回复内容（重复消息）。

期望行为：桌面端 session 页面应该只显示一次助手回复。

运行环境

• 使用方式: 桌面端 + Telegram
• 操作系统: macOS
• 系统版本: macOS（具体版本请根据实际情况补充）
• 桌面端版本: 最新版
• 安装来源: GitHub Release

Provider / 模型配置

• API 提供商: （请根据实际情况补充）
• 使用的模型: （请根据实际情况补充）

复现步骤

1. 在桌面端打开 cc-haha 并进入一个已有的 session 页面
2. 保持桌面端 session 页面处于打开状态
3. 在 Telegram 中向同一个 session 发送一条新指令
4. 等待助手回复出现在桌面端 session 页面

是否稳定复现: 是

错误信息与日志

无报错日志，问题表现为 UI 层面的消息重复显示。

截图或录屏

（如有需要可以补充截图）

补充信息

该问题在桌面端与 Telegram 同时连接同一 session 时稳定复现。怀疑是 WebSocket/SSE 推送与轮询机制同时触发了消息更新，导致同一条回复被渲染了两次。

---

@dosubot

[dosubot]

感谢你提交这个 Bug 报告！这个问题与此前报告过的几个重复消息相关的 issue 有相似之处。

问题分析：

你的怀疑方向是正确的。桌面端使用 WebSocket (/ws/{sessionId}) 接收实时消息更新 [1]，当 Telegram 适配器同时通过 WebSocket bridge 向同一个 session 发送和接收消息时 [2]，可能出现以下情况：

1. Telegram 适配器通过 WebSocket 向服务端发送用户指令并接收助手回复
2. 桌面端的 WebSocket 连接也同时收到同一条助手回复的推送
3. 如果桌面端的去重机制未能正确识别来自 Telegram 触发的回复为同一条消息，就会渲染两次

虽然代码中存在多层去重机制 — 包括适配器层的 MessageDedup 类（基于消息 ID + 10 分钟 TTL 窗口）[3] 和 UI 层 MessageList 组件的过滤逻辑 [4] — 但这些机制可能在跨客户端（桌面端 + Telegram）同时监听同一 session 的场景下存在覆盖不全的情况。

相关历史问题：

• #446: 长时间空闲后对话中同一结果反复出现，在 v0.3.1 中修复 [5]
• Mac 休眠唤醒后消息重复播放问题，根因是 WebSocket 层缺少基于序列号的去重（不同于 SSE 层），同样在 v0.3.1 修复 [6]

临时解决方法：

• 通过 Telegram 发送指令时，不要同时在桌面端打开同一个 session 页面
• 如果出现重复消息，刷新桌面端页面即可恢复正常显示

建议补充信息：

1. 你使用的桌面端具体版本号（设置 -> 关于）是否已经是 v0.3.1 或更新版本？
2. API 提供商和使用的模型

如果你已经在 v0.3.1+ 版本上复现了此问题，说明跨客户端场景下的去重逻辑仍需进一步完善。

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

[Terryli246]

@dosu

1. 已经是 v0.3.1 或更新版本
2. Zhipu CN - GLM 5.1

[dosubot]

感谢补充信息！既然你已在 v0.3.1+ 版本上稳定复现，这说明该问题确实是一个尚未修复的 Bug。

根因分析：

通过代码研究确认了你的猜测。服务端使用 Map<sessionId, Set<WebSocket>> 结构管理同一 session 的多个连接，设计上会将所有消息广播给同一 session 的所有已连接客户端，且服务端没有去重逻辑 [1]：

// 所有连接到同一 session 的客户端都会收到消息
for (const ws of clients) {
  ws.send(payload)
}

当 Telegram 发送指令时，服务端调用 bindAllClientSessionOutputs() 将助手回复广播给该 session 的所有 WebSocket 连接 [2]。问题在于：

1. Telegram 适配器连接收到回复 → 正常处理发送到 Telegram
2. 桌面端的 WebSocket 连接也同时收到相同的回复 → 桌面端渲染了一次
3. 但桌面端可能因为回调被绑定了两次（Telegram 触发的 bindAllClientSessionOutputs 为桌面端额外注册了一个 output callback），导致同一条消息通过两个 callback 分别推送，最终显示两条

v0.3.1 引入的去重机制（MessageDedup 类）仅作用于 Telegram/飞书等适配器侧 [3]，桌面端客户端本身并未实现类似的消息去重过滤。此外，已有 #574 报告了 Telegram 适配器在会话切换时旧 WebSocket 连接未正确关闭导致重复消息的竞态条件 [4]。

总结： 这是一个服务端广播机制在多客户端同时连接时的 output callback 重复绑定问题，桌面端缺少客户端侧的消息去重保护。建议维护者考虑：

• 在桌面端 WebSocket 客户端侧增加基于消息 ID 的去重逻辑（类似适配器的 MessageDedup）
• 或在服务端 bindAllClientSessionOutputs 时检查是否已为该 WebSocket 绑定过 callback，避免重复注册

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.

[NanmiCoder]

#723 发布0.4.0 已支持