Skip to content

[Bug] v2.4.2 空框预测幽灵仍不可见:候选已生成且 Tab 可取,但 next ghost 的 zIndex 2 被 composer 卡内层遮住 #110

Closed

Description

@HuHong-Tao

环境

  • DSH 0.2.2-rc.5(macOS),@michengai/dsh-codex-ui 2.4.2(上游最新发布版)
  • 模型路由:deepseek-v4.1-flash(预测请求 effort=low)
  • 空闲会话,输入框为空(next 模式)

复现步骤

  1. 打开一个已结束、agent 空闲的会话;
  2. 点击输入框(保持空白,不输入任何字符);
  3. 等 3–7 秒。

现象

服务端已经返回可用候选,客户端也能接收(按 Tab 会把候选写进输入框),但屏幕上不显示任何灰字幽灵,用户看到的是「空框 + 没有预测」。

证据(2.4.2 实测,2026-11-21 09:10)

  • 网关日志 ~/.config/magpie/routing/2026-11-21.jsonl:该会话出现 next 请求 out=322 / reasoning=275 / effort=low / ms=6397,正文约 47 tokens,说明主流程已修好、候选非空;
  • 同一时刻截图:输入框空白,无 ghost(无候选文本、无 1/3 计数、无 Tab 键帽);
  • 紧接着按 Tab:输入框 value 变为候选文本 → 数据链、流式、Tab 接受逻辑全部正常;
  • 用 DOM 查询 [data-composer-prediction] 时该元素确实被插入并带正确文本/坐标/灰色前景色,只是不可见。

代码定位(2.4.2)

  • 源码 src/client/composer/ComposerPredictionOverlay.tsx:NEXT_GHOST_STYLE 的 zIndex: 2,CONTINUE_GHOST_STYLE 的 zIndex: 3;
  • 构建产物 lib/client.js:11074 仍为 zIndex: 2、:11082 为 zIndex: 3;
  • 85dfeb5(回声过滤)只改了本文件的 streamingCandidate / cleanLine,没有动层级。

为什么 z=2 会看不见

ghost 被挂在与 composer 卡内层同级的堆叠上下文里。输入框所在内层本身就有 z-index(同层或更高),next 幽灵用 z=2 排在其后,于是被背景/占位层压住;而 continue 幽灵用 z=3,所以续写预测一直可见、空框预测从来不可见——这个非对称正是层级的直接证据,而不是渲染条件问题(visible 为真、元素已插入)。

建议修复

把 next 抬到内层之上,例如 zIndex: 8,continue 同步到 9,保持两者相对关系:

- NEXT_GHOST_STYLE = { ..., zIndex: 2 }
- CONTINUE_GHOST_STYLE = { ..., zIndex: 3 }
+ NEXT_GHOST_STYLE = { ..., zIndex: 8 }
+ CONTINUE_GHOST_STYLE = { ..., zIndex: 9 }

我在本地分别对 2.4.0 与 2.4.2 的 lib/client.js 打了这两行补丁:重启后空框 ghost 立刻可见(候选文本 + 计数 + Tab 键帽,AX 里输入框 value 仍为 "",确认是纯绘制层),说明改动足够且没有副作用。

与已关闭问题的关系

如果需要,我可以只提这两行的 PR(不夹带其它改动),或补一个「ghost 已绘制且在视口内」的回归断言。

Activity

  1. MichengAI commented on Nov 21, 2026

    @MichengAI
    Owner

    感谢反馈!

    针对输入预测浮层在特定环境(如 macOS 桌面端带有卡片材质/同级 z-index: 2 背景)下被卡内层背景遮挡的问题,以及两类预测模式的展现表现,我们已在主分支完成针对性修复与验证:

    1. 图层层叠上下文(z-index)提升:
      已在提交 81abbc0 中将整句预测浮层提升至 zIndex: 8、行内光标续写提升至 zIndex: 9,确保幽灵文本始终处于宿主 composer 卡内层绘制背景之上,并补充了自动化层级防护回归测试。

    2. 双模式实测验证:

      • 空框整句预测(next 模式):输入框为空时,整句建议正常浮现,按下 Tab 键正常采纳并填入输入框;
      • 行内光标续写(continue 模式):输入框已有内容时,光标后方续写建议正常浮现,按下 Tab 键正常完成补全。

    相关代码已合并并推送到 main 分支(81abbc0),将随下一个发版周期正式上线。本 Issue 先行关闭,感谢细致的反馈与跟进!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions