docs(windows): 跟踪 QA helper-window 生命周期

[Cooper-X-Oak]

治理归属

• 族群：E 族群 / helper-window 与输入交互契约
• 对应主 issue：[windows] QA 浮窗生命周期语义未与 macOS 对齐，存在 linger / focus / screenshot 风险 #153
• 主修范围：QA 浮窗可拖动语义、non-activating but draggable 产品目标、Windows 原生拖动承载
• 不默认并入：主窗口外观、Capsule 几何、Capsule 残留隐藏态、startup visible/ready ownership
• 参考：
  • docs/windows-window-governance-board.zh-CN.md
  • docs/2026-05-02-window-capability-family-audit.md
  • docs/github-tracking/windows-window-family-canonical-map.md

摘要

Closes #153

这张 draft PR 继续承担 QA helper-window 这条问题线的收敛工作，但现在已经不再是“泛泛跟踪浮窗生命周期”，而是更明确地聚焦到：

Windows 上如何用原生窗口承载，实现与 macOS 一样的 QA 浮窗产品目标。

这个产品目标包括：

• 不抢 source app 上下文
• 能点关闭
• 能拖动
• 关闭后不继续参与系统行为

当前状态

• 继续保持 draft
• 但不是“还没想清楚问题是什么”
• 而是“问题已经收敛，后续修复必须走 Windows 原生实现路线”

换句话说，这张 PR 现在承担的是：

• 设计收敛
• 分层边界固定
• 为后续真正的 Windows 原生实现让路

问题层面

这不是普通 QA UI 交互细节，也不是一段前端拖动代码没写。

这条线本质上是：

• helper-window 原生承载缺口
• Windows 没有把 macOS 那套“尽量不抢上下文、同时还能拖动”的目标补齐

所以这张 PR 不并入主窗口 UI 外观线，继续留在 selection ask / QA feature family 里推进。

当前结论

目前已经收敛出的核心判断是：

• 继续尝试共享拖动承载，没有意义
• 后续真正修复应该直接转向：
  • Windows 原生窗口创建属性
  • Windows 原生 hit-test / 消息处理
  • 拖动区和按钮区的原生分离

兼容范围

这张 PR 不包含：

• QA renderer 大改
• 主窗口圆角 / 外框 / 阴影等 Windows UI 外观修复
• 无关的 provider / insertion / polish 改动

测试计划

• 已有实机验证：Ctrl+Shift+; 正常
• 已有实机验证：关闭按钮可点
• 已有实机验证：QA panel 在 Windows 上仍不可拖动
• 后续真正修复时，再补 Windows 原生拖动回归验证
• 证据路径：issue [windows] QA 浮窗生命周期语义未与 macOS 对齐，存在 linger / focus / screenshot 风险 #153、fix(windows): 补齐 QA helper-window 的原生交互语义 #184、Windows 实机测试记录、后续原生实现说明

[sourcery-ai]

Sorry @Cooper-X-Oak, you have reached your weekly rate limit of 500000 diff characters.

Please try again later or upgrade to continue using Sourcery

[appergb]

@Cooper-X-Oak 这条 PR 一直是 draft 状态，main 在过去几小时已合入 #119/#120/#121/#138/#140/#145/#150/#151/#155/#160 + 配套 release 1.2.10/1.2.11，base 跑得比较远。issue #153 仍然 open，烦请基于最新 main rebase 一份新的 PR 或直接以新 PR 提交本次的 docs 内容（193 行 docs 现在跟 main 应该没冲突）。这次关闭不是对内容的否定，纯粹是清场避免长期 draft 在列表里堆积。