[Bug] Windows：不透明度设为 55%、背景模糊为“无”时，终端仍完全不透明

[maryjeck]

Operating system / 操作系统

Windows

OS version and display / 系统版本与显示

Windows 11 26H2，OS build 26300.9550，x64。
系统 EditionID：ProfessionalEducation。单显示器，Pebrel 窗口 DPI 144（150% 缩放）。
Windows 的“透明效果”已开启（EnableTransparency=1）。

Pebrel version / 版本号

2.0.0 (2122c62)，由运行中的 Runtime API 返回。
反馈时官方最新正式版为 v2.0.0。

How did you install Pebrel? / 安装方式

Other / 其他：Windows 本地安装版，原始安装包来源未另外核实。

Shell in the affected pane / 出问题的面板用的 Shell

PowerShell 7 (pwsh)

Program running in the pane / 面板里正在跑的程序

• Nothing, plain shell prompt / 普通 PowerShell 提示符
• Pi

两种场景都观察到，普通 Shell 对照用于排除“仅 Pi 的 TUI 背景覆盖透明区域”。

Connection type / 连接方式

Local terminal / 本地终端

Affected area / 影响范围

• Settings / theme / layout / blur — 设置页、主题、布局、模糊背景
• Terminal rendering / scrolling / selection / garbled text — 终端渲染

Did it work in a previous version? / 旧版本是否正常？

Not sure / 不确定，刚安装使用，未对照旧版本。

Can you reproduce it? / 复现概率

当前同一运行会话中，在原有 Pi 标签页和新建的普通 PowerShell 标签页均观察到；尚未统计跨重启或其他机器上的复现率。

Steps to reproduce / 复现步骤

1. 启动 Pebrel，打开本地 PowerShell 7 终端，并将窗口放在一个有明显浅色背景/文字的窗口前。
2. 打开“设置 → 外观”，将“终端正文不透明度”设为 55%。
3. “背景模糊”保持为 无，不设置背景图片。
4. 离开设置页面，切回终端标签页查看实际背景。这里不是要求设置页透明，设置页保持不透明是预期行为。
5. 另外新建一个普通 PowerShell 标签页，不运行 Pi 或其他全屏 TUI，再观察大面积空白终端背景。

Expected behavior / 期望结果

当终端不透明度为 55%、背景模糊为“无”时，应能透出窗口后方的内容，呈现不带模糊的半透明背景，而非完全不透明的纯色背景。文字本身应保持可读。

Actual behavior / 实际结果

设置界面显示 55%，保存文件也确实是 opacity=0.55，但切回终端后背景仍呈完全不透明的深色，看不到后方窗口内容。

原有 Pi 标签页和新建的普通 PowerShell 标签页表现相同；普通 PowerShell 标签页的大片空白区域也没有可见的透视效果。

Logs / screenshots / 日志或截图

以下为本机只读核验得到的相关信息，不是应用错误日志：

Runtime API app_version: 2.0.0 (2122c62)
Windows DisplayVersion: 26H2
Windows build: 26300.9550
OS architecture: X64
Monitor count: 1
Pebrel window DPI: 144 (150%)
Windows EnableTransparency: 1

%APPDATA%\Pebrel\pebrel_settings.txt:
opacity=0.55
blur=none
background_image_cover_chrome=1

Background image configured: false

已在本机截图对照设置页（55%）与终端页，并通过临时普通 PowerShell 标签页对照确认现象；本次文本报告未附截图，以免公开原始截图中的私人路径与会话内容。临时测试标签页已关闭，原有会话保留。

Non-default settings / 改过的设置

• 终端正文不透明度：55%。
• 背景模糊：无。
• 未配置背景图片。
• “将背景图扩展到标题栏和侧边栏”开启，但没有实际背景图片。

Investigation boundaries / 排查范围与相关问题

• 已搜索相关问题：[Bug] 终端正文不透明度调整存在bug #60 是滑块回弹及后续“低于 50% 无变化”的评论；[Bug] 背景模糊不生效 #163 最终与不透明度理解/背景图片遮盖有关；[Bug] Aero / Acrylic 模糊在屏幕边缘出现背景内容透出 #236 及 fix(windows): 使用 Acrylic 控制器改善边缘模糊并保持失焦效果 #250 针对 Acrylic 屏幕边缘与失焦模糊。这次是 blur=none 下普通终端完全没有可见透明效果，暂不能认定与上述问题同源。
• 对照 2122c62 的 nebula_app/src/gpui_shell/wallpaper.rs，BlurModeName::None 映射到 WindowBackgroundAppearance::Transparent，因此期望不带模糊的透明应可工作。这只是实现线索，不是已经定位的根因。
• 尚未测试：完全退出并重启 Pebrel、切换 Aero/Acrylic、清空全部配置、其他 Windows 构建/显卡环境。
• 尚不能确定是设置热应用、窗口合成路径，还是该 Windows 构建的兼容问题；也不声称所有用户都受影响。

Before submitting / 提交前确认

• 已搜索现有 Issues，未找到现象完全相同且已确认的重复项。
• 已在反馈时的最新正式版 v2.0.0 观察并核验。
• 已删除个人路径、主机名、会话内容、密码、私钥及 token 等敏感信息。

[Kuddev]

已核对你记录的 55% / blur=none / 无背景图条件，以及普通 Shell 中也不透明的对照。当前源码映射到 Transparent 只能证明请求了透明窗口，尚未证明系统合成结果正确，因此保持 Issue 打开。

下一步请保留其它设置，在普通 Shell 页面仅做一次材质对照：切到 Aero 或 Acrylic，再切回“无”，分别观察是否能透出后方内容。如果只在切回后正常，将重点检查热应用/原生材质状态；若一直不透，再对照当前版本与显卡驱动/系统构建。

无需清空配置或修改系统透明效果。若日志有 DwmSetWindowAttribute、SetWindowCompositionAttribute 等失败记录，只提供对应几行即可，不需整个会话日志。

[maryjeck]

谢谢，补充一次本机只读日志检查的结果。此次没有清空配置、修改系统透明效果或切换材质。

1. 当前环境与原报告不同

当前运行中的 Runtime API 返回 2.1.1 (d574856)；设置文件现在为：

opacity=0.75
blur=none
Background image configured: false

原报告的 2.0.0 / 55% 是当时的检查结果。此次没有重新验证 2.1.1 的透明效果，也没有执行“普通 Shell → Aero/Acrylic → 无”的对照，因此不能把本次日志检查当成新版本的复现结论。

2. 没有找到可摘录的日志文件

在 Pebrel 内的 Shell 环境中核对了当前进程身份及导出的日志路径（以下均为脱敏路径）：

$env:PEBREL_LOG -> %TEMP%\Pebrel-<当前运行进程PID>.log
$env:NEBULA_LOG -> 同一个文件
Test-Path $env:PEBREL_LOG -> False

%APPDATA%\Pebrel\pebrel_debug.log -> 不存在
%TEMP%\Pebrel-*.log -> 未找到
%APPDATA%\Pebrel 目录内的 *.log -> 0 个

PEBREL_DEBUG_LOG / NEBULA_DEBUG_LOG -> 当前 Shell 环境中均未设置
PEBREL_CONFIG_DIR / NEBULA_CONFIG_DIR -> 当前 Shell 环境中均未设置

也检查了兼容的旧 Nebula 目录、安装目录及备用临时目录，没有找到相关日志。因此目前没有可提供的 DwmSetWindowAttribute / SetWindowCompositionAttribute 失败记录；这里是“未找到日志文件”，不是“日志证明这些调用成功”。

3. 日志启用方式

对照 d574856 的 logging.rs：

• debug_log 受 PEBREL_DEBUG_LOG / NEBULA_DEBUG_LOG 开关控制。
• Pebrel-<pid>.log 由 OnDemandLogFile 按需创建，导出了路径不代表文件已经生成。

能否确认当前 GPUI 版本收集上述 Win32 材质调用失败记录所需的最小启动日志开关/级别，以及是否必须完全退出后重启才能启用？本次未擅自开启全量日志或中断现有会话，也没有上传任何会话日志。