[Bug][Desktop][Windows] 3.18.2 对话引用插件时 UI 全局无响应(后端存活),与「插件自动推荐」链路相关
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
调研方向
Repro is spelled out: enable plugin auto-recommend, send a message naming a plugin, and check whether the UI stops while ~/.zcode/cli/log/zcode-YYYY-MM-DD.jsonl keeps logging heartbeats. Start from acquireFileLock and the getPluginReferenceCatalog() / SearchPlugins / SuggestPluginInstall path inside the zcode.cjs app-server --stdio --surface desktop process, sampling the lock owner pid in installed_plugins.json.lock and CPU at freeze time. Done means naming the blocking call that ties the UI to the lock, plus a repro that no longer hangs.
由索引模型根据 Issue 内容生成。
描述
环境
- ZCode Desktop 3.18.2.10443(Windows x64,正式通道安装包,与 cdn-zcode.z.ai stable latest.yml 同一 sha512)
- Windows 11 Pro 26320(Insider Beta)
- 插件规模:40 个已安装插件 / 3 个市场(含 1 个 git 型市场);MCP 多组多实例;开启"接受预览版更新"(本次下载包与 stable 相同)
症状
对话中发送的消息里引用/提及插件名时,整个桌面端 UI 无响应:点击任何按钮均无法切换到对应界面,只能结束进程重启。3.5 小时内出现 6 次(本地时间 2026-11-14 19:26 / 21:00 / 21:31 / 21:48 / 21:52 / 23:23 前后,均为结束进程重启的时间点)。
两个值得注意的特征:
- 无 OS 级挂起:Windows 应用程序日志全程无 Application Hang (1002) / Application Error (1000),无 WER 档案,无 Crashpad dump。窗口仍在渲染,但事件处理无响应。
- CLI 后端存活且健康:冻结发生时
~/.zcode/cli/log/zcode-YYYY-MM-DD.jsonl中心跳(zcode_protocol.process.memory_sample)持续;结束进程时后端仍能完成优雅关停(zcode_protocol.shutdown.completed+ 全量 MCP lease 释放)。其中 3 次冻结发生前 ≥10 分钟后端无任何业务事件——即用户操作没有到达后端。
关联线索
- 触发场景与 3.18.2 新增的插件推荐能力高度重合。本机实测开启该功能时,提示词引用插件后可出现无响应;在设置中关闭「插件自动推荐」后,
SearchPlugins/SuggestPluginInstall随即从会话工具面移除,截至提交时未再复现(观察窗约 1 小时,仍在持续观察)。 - 插件状态锁出现异常长持有。
~/.zcode/cli/plugins/installed_plugins.json.lock(目录锁,owner 文件含 pid)在无冻结的正常运行时段,实测被 app-server 进程(zcode.cjs app-server --stdio --surface desktop)连续持有 16–43 秒。本地元数据读改写通常不应达到该量级,怀疑锁内包含慢 IO 或网络请求(本机市场含 git 型仓库,网络经代理)。 - 冻结高发时段与插件更新流重叠:22:45 市场仓库推送插件新版本 → 22:50
installed_plugins.json被改写 → 23:23 冻结重启。
怀疑路径(基于 3.18.2 二进制内省,供参考)
- 插件发现体系(3.18.2 新增):
pluginDiscoveryUi/SearchPlugins/SuggestPluginInstall/getPluginReferenceCatalog()/resolveIcon - 锁实现:
acquireFileLock(目录锁;owner 进程存活时不回收,无论持有时长;进程内同路径请求经串行队列;默认等待上限 8s) - 建议排查方向:
- 插件引用解析/推荐链路中是否存在无超时的跨进程等待(app-server ↔ 插件宿主
__zcode-plugin-host,或持锁期间的网络 IO) - 市场元数据刷新/版本检查是否在持有
installed_plugins.json.lock期间执行网络请求 - 桌面端 UI 在上述 RPC 未返回时的全局行为(是否存在所有视图切换都依赖同一 RPC 状态的设计)
- 插件引用解析/推荐链路中是否存在无超时的跨进程等待(app-server ↔ 插件宿主
复现参考
- 设置开启「插件自动推荐」(默认关闭;开启后暴露面应显著缩小)
- 在对话中发送引用插件名的消息(本机 40 插件 + git 型市场环境)
- 观察 UI 是否整体无响应、后端日志是否仍在记录心跳
缓解
设置 → 关闭「插件自动推荐」。关闭后立即生效(下一条输入起),无需重启。
备注
设备号等账号关联信息可按官方反馈流程另行提供,不在公开 issue 中附带。愿意配合进一步取证(冻结时刻的进程 CPU 采样、锁采样日志均可提供)。
- 主要语言
- Python
- 星标
- 152
- 派生
- 137
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
zai-org/zcode-plugins 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 83/100
zai-org/zcode-plugins#202 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 76/100
zai-org/zcode-plugins#107 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 85/100
zai-org/zcode-plugins#106 ·
维护者通常 1 天内回复
-
video-agent-kit (0.4.3): hooks invoke python3, which doesn't exist on Windows — SessionStart/UserPromptSubmit/Stop hooks fail on every trigger可能已有人在做 @dvd233 于 57 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 85/100
zai-org/zcode-plugins#14 ·
维护者通常 1 天内回复
-
难度 4/5 3-5 天 新手友好度 25/100
zai-org/zcode-plugins#194 ·
维护者通常 1 天内回复
查看 zai-org/zcode-plugins 的全部 Issue
相似的 Issue
-
opensubtitlescom: provider rejects pt-PT even though its own converter maps it可能已有人在做 @paulo-0308 今天认领。 未关闭
难度 1/5 1 小时以内 新手友好度 88/100
Diaoul/subliminal#1405 ·
-
Internal Error未关闭bug
难度 2/5 1-3 小时 新手友好度 66/100
frappe/frappe_docker#2071 ·
维护者通常 1 天内回复
-
bug python
难度 2/5 1-3 小时 新手友好度 76/100
traceloop/openllmetry#4717 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 82/100
The-Pocket/PocketFlow#161 ·
-
comp/desktop P2 type/bug
难度 2/5 1-3 小时 新手友好度 78/100
NousResearch/hermes-agent#157702 ·
维护者通常 1 天内回复