# DxPartReplace 私有桌面清理失败:定位报告 日期:2026-11-05 机器:SDT52178-PC ## 1. 现象 替换/检查日志中反复出现: ``` batch_resources_pending: private CAD cleanup requires reconciliation: orderly_shutdown: owned CAD refused orderly exit: owned CAD still has a project open private_desktop_cleanup: owned private desktop still exists after cleanup ``` 工具自己的诊断字段: ``` desktop_handle_closed = true desktop_disappeared = false remaining_windows = [] external_handle_holders = unknown ``` 说明:`CloseDesktop` 调用成功,桌面上也没有残留窗口,但桌面对象仍然存在。 ## 2. 本机定位方法 使用 Windows 原生句柄枚举,不依赖第三方工具: 1. `NtQuerySystemInformation(SystemExtendedHandleInformation, 64)` 取全系统句柄表。 2. 先 `OpenDesktopW("Default")`,在自己进程的句柄表项里读出 `ObjectTypeIndex`;本机 Desktop 类型索引为 **30**。 3. 统计类型 30 的句柄按 PID 分布。 4. 对可访问进程用 `DuplicateHandle` + `NtQueryObject(ObjectNameInformation)` 读出桌面名;对受保护进程记录 PID 和拒绝计数。 5. 做受控实验:创建私有桌面,在桌面上启动 GUI 进程,观察类型 30 句柄数变化,再 `CloseDesktop`,看桌面是否消失。 脚本: - `find_desktop_holders.py`:枚举 Desktop 类型句柄的持有进程。 - `desktop_agent_probe.py`:受控实验,验证“桌面上的 GUI 进程”是否触发第三方 Agent 持有句柄。 - `enum_desktops.py`:列出当前所有桌面。 ## 3. 实测结果 ### 3.1 残留桌面数量 ``` Desktops: 103 其中 dx-*: 100 ``` `SharedSection=1024,20480,768`,交互桌面堆为 **20 MB**。100 个 CAD 私有桌面已经足以耗尽该堆。 ### 3.2 句柄持有者 `find_desktop_holders.py` 输出(节选): ``` my Default desktop handle=0x3D4 type_index=30 desktop type handles: named=57 denied=314 denied by pid: pid=6792 (open denied) x103 pid=25492 (open denied) x81 ``` PID 6792 / 25492 均为: ``` 进程名:winrdlv3.exe 路径:C:\Windows\System32\winrdlv3.exe 描述:Winrdlv3 (X64) 产品:OCular Agent 公司:TEC Solutions Limited. 版本:4.61.112.0 ``` `OpenProcess(PROCESS_DUP_HANDLE)` 返回拒绝访问;尝试启用 `SeDebugPrivilege` 也未成功(`GetLastError=1300`,令牌未持有该特权),因此无法直接读这些句柄对应的桌面名。 ### 3.3 受控实验(关键证据) `desktop_agent_probe.py`: ``` 先创建 dx-leak-gui-6fa99a3047 在桌面上启动 notepad.exe t=5s present=True pid 6792=102 pid 25492=81 t=10s present=True pid 6792=102 pid 25492=81 t=20s present=True pid 6792=103 pid 25492=81 <-- Agent 打开了该桌面 t=30s present=True pid 6792=103 pid 25492=81 CloseDesktop 成功 after close present=True pid 6792=103 <-- 桌面仍存在 ``` 对照实验:创建一个空桌面、不运行任何进程,`CloseDesktop` 后桌面**立即消失**,Agent 句柄数不变。 结论:触发条件不是“创建桌面”,而是“桌面上运行了 GUI 进程(如 DxDesigner/viewdraw)”。OCular Agent 会在约 20 秒内对这类桌面打开并长期持有一个句柄。 ## 4. 根因链 ``` DxPartReplace 为每个 CAD 批次创建 dx-* 私有桌面 ↓ 桌面上启动 viewdraw / cscript / DxPartReplace ↓ OCular Agent (winrdlv3.exe) 打开并持有该桌面句柄 ↓ 工具 CloseDesktop 只关闭自己的句柄,桌面对象仍被 Agent 持有 ↓ confirm_desktop_released 在 EnumDesktops 里仍看到该桌面 ↓ 抛 private_desktop_cleanup,supervisor 进入 batch_resources_pending ↓ 每批次泄漏一个桌面,累计约 100 个 ↓ 20 MB 交互桌面堆耗尽 ↓ 后续 CAD 打开工程/图页发现超时(300s),表现为大量 inspect_failed 和 running/paused ``` 因此: - **私有桌面清理失败**的直接原因是第三方 Agent 持有句柄,不是工具没有调用 `CloseDesktop`。 - **46 个检查失败、21 个任务未闭环**的更深层原因是桌面堆被泄漏的桌面耗尽;CAD 打开/发现阶段拿不到窗口资源,表现为超时,而不是料号匹配错误。 ## 5. 建议处理方式 1. **释放现有泄漏**:重启 OCular Agent 相关进程,或重启机器;重启后用 `enum_desktops.py` 确认 `dx-*` 为 0。 2. **让 IT 排除监控**:把 `DxPartReplace.exe`、`viewdraw.exe`、`cscript.exe` 从 OCular Agent 的 GUI 监控/截屏范围排除,或允许私有桌面不被挂钩。 3. **工具侧规避**: - 一批任务只复用一个私有桌面,不要每个计划创建一个桌面。 - 把“外部进程仍持有桌面”视为非致命清理告警,不要让整个队列 pause。 - 检查阶段尽量在一个 worker 内复用同一桌面。 4. **清理后再重试**:先处理 46 个 `inspect_failed`,再重跑 21 个 running/paused;桌面堆未释放时重试大概率仍会超时。 ## 6. 复现命令 ```powershell $py = 'C:\Users\SDT52178\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\python\python.exe' $ws = 'C:\Users\SDT52178\Documents\deepseek-harness\default-workspace' # 1. 看当前桌面数量 & $py "$ws\enum_desktops.py" # 2. 看 Desktop 句柄持有者 & $py "$ws\find_desktop_holders.py" # 3. 受控实验(会创建一个测试桌面) & $py "$ws\desktop_agent_probe.py" ``` 注意:受控实验留下了测试桌面 `dx-leak-gui-6fa99a3047`,它同样被 Agent 持有;重启 Agent/机器后会释放。