开启H5时，在局域网打开会显示会话列表加载失败

[huangxi3520]

提交前确认

• 我已经阅读了 README 常见问题
• 我已经阅读了第三方模型使用指南（如使用第三方 provider）
• 我已经搜索过现有 issues，确认没有重复问题
• 我已经隐藏截图和日志中的 API Key、Token、Cookie 等敏感信息

问题描述

使用环境

• 使用方式: 桌面端 / CLI / 其他:
• 操作系统: Windows / macOS / Linux:
• 系统版本: 例如 Windows 11 23H2 / macOS 15.4:
• 桌面端版本: 例如 v0.1.8（设置页 -> 关于 中可查看）:
• 安装来源: GitHub Release / 源码本地构建 / 其他:
• Bun 版本（CLI 问题填写，bun --version）:
• Node 版本（CLI 问题填写，node --version）:

使用场景

• 使用功能: 例如会话对话 / Provider 配置 / 模型调用 / MCP / Skills / 远程控制:
• API 提供商: 例如 Anthropic 官方 / OpenRouter / MiniMax / Kimi / Ollama:
• 使用的模型:

配置截图

操作步骤

1.启用H5访问
2.访问正常，大多数情况下无法加载出对话详情
3.当网页中有此报错，同时客户端也会报这个错，客户端也无法正常使用，需要重启客户端

错误信息与日志

在此粘贴错误信息和日志

截图或录屏

---

@dosubot

[dosubot]

你好！你遇到的"会话列表加载失败"问题是一个已知的性能问题，主要原因是 listSessions() 在每次 API 调用时会对所有会话的 JSONL 文件进行完整解析，阻塞了 Bun 的事件循环，导致 GET /api/sessions 请求超时（30秒）以及 WebSocket 心跳超时 [1] [2]。

这个问题不仅影响 H5 端，也会影响桌面端——这正解释了你观察到的"客户端也会报这个错"的现象。

解决建议：

1. 升级到 v0.3.2 或更高版本 — 维护者在 v0.3.2 中修复了 sidecar 内存泄漏问题，该问题是导致会话列表加载失败的主要原因之一 [2]

2. 检查你的 H5 访问配置：

   • 确保服务端绑定地址为 0.0.0.0（桌面端默认已绑定，无需手动修改）[3]
   • 确保在 H5 设置中正确配置了允许的来源（CORS origin），远程浏览器的来源地址需要加入白名单 [4]
   • 确认 H5 Token 已正确生成和使用

3. 注意版本兼容性 — H5 功能在 v0.2.5 中曾因稳定性问题被临时隐藏，后续版本逐步修复 [5]。请确认你使用的是最新版本。

另外，有一个待合并的 PR #650 专门针对会话列表 API 超时问题增加了 30 秒 TTL 内存缓存和 WebSocket 状态清理 [1]，合并后应该能进一步改善这个问题。

如果升级后问题仍然存在，建议提供你的桌面端版本号和完整的错误日志，以便进一步排查。

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

[NanmiCoder]

#723 发布0.4.0 已支持