feat(window-recognition): native 扩展窗口几何/置顶/前台HWND枚举

Author: Aparencia

client/electron/audio/processAudioNative.ts

@@ -20,6 +20,13 @@ export interface NativeWindowInfo {
   title: string;
   processName: string;
   rootProcessName: string;
+  /** 窗口矩形（像素，native 扩展字段） */
+  left: number;
+  top: number;
+  width: number;
+  height: number;
+  /** 置顶窗口 */
+  alwaysOnTop: boolean;
 }
 
 /** 原生模块流式回调的负载：音频块或错误 */
@@ -35,6 +42,8 @@ export interface NativeStreamPayload {
 export interface ProcessAudioNative {
   listAudioWindows(): NativeWindowInfo[];
   resolveRootPid(pid: number): number;
+  /** 当前前台窗口 hwnd 字符串；无前台窗口返回空串 */
+  getForegroundHwnd(): string;
   isProcessLoopbackSupported(): boolean;
   startCapture(
     options: { pid: number; sampleRate: number; channels: number; chunkDurationMs: number },

client/native/process-audio/src/addon.cc

@@ -39,6 +39,11 @@ Napi::Value ListAudioWindows(const Napi::CallbackInfo& info) {
     obj.Set("title", ToNapiString(env, w.title));
     obj.Set("processName", ToNapiString(env, w.process_name));
     obj.Set("rootProcessName", ToNapiString(env, w.root_process_name));
+    obj.Set("left", Napi::Number::New(env, w.left));
+    obj.Set("top", Napi::Number::New(env, w.top));
+    obj.Set("width", Napi::Number::New(env, w.width));
+    obj.Set("height", Napi::Number::New(env, w.height));
+    obj.Set("alwaysOnTop", Napi::Boolean::New(env, w.always_on_top));
     arr.Set(i, obj);
   }
   return arr;
@@ -116,6 +121,13 @@ Napi::Value IsSupported(const Napi::CallbackInfo& info) {
   return Napi::Boolean::New(info.Env(), process_audio::IsProcessLoopbackSupported());
 }
 
+/** getForegroundHwnd(): 返回当前前台窗口 hwnd 字符串；无则返回空串 */
+Napi::Value GetForegroundHwnd(const Napi::CallbackInfo& info) {
+  const uint64_t hwnd = process_audio::GetForegroundWindowHwnd();
+  if (hwnd == 0) return Napi::String::New(info.Env(), "");
+  return Napi::String::New(info.Env(), std::to_string(hwnd));
+}
+
 // ================================================================
 // 流式采集（生产入口）
 // ================================================================
@@ -239,6 +251,7 @@ Napi::Object Init(Napi::Env env, Napi::Object exports) {
   exports.Set("captureToWav", Napi::Function::New(env, CaptureToWav));
   exports.Set("isProcessLoopbackSupported",
               Napi::Function::New(env, IsSupported));
+  exports.Set("getForegroundHwnd", Napi::Function::New(env, GetForegroundHwnd));
   exports.Set("startCapture", Napi::Function::New(env, StartCapture));
   exports.Set("stopCapture", Napi::Function::New(env, StopCapture));
   return exports;

client/native/process-audio/src/window_finder.cc

@@ -106,6 +106,16 @@ BOOL CALLBACK EnumProc(HWND hwnd, LPARAM lparam) {
   info.title = title;
   info.process_name = GetProcessImageName(pid);
   info.root_process_name = GetProcessImageName(info.root_pid);
+
+  RECT rect = {0, 0, 0, 0};
+  if (GetWindowRect(hwnd, &rect) != 0) {
+    info.left = rect.left;
+    info.top = rect.top;
+    info.width = rect.right - rect.left;
+    info.height = rect.bottom - rect.top;
+  }
+  info.always_on_top = (GetWindowLongW(hwnd, GWL_EXSTYLE) & WS_EX_TOPMOST) != 0;
+
   ctx->out->push_back(std::move(info));
   return TRUE;
 }
@@ -125,4 +135,10 @@ uint32_t ResolveRootPidForPid(uint32_t pid) {
   return ResolveRootPid(static_cast<DWORD>(pid), parents);
 }
 
+uint64_t GetForegroundWindowHwnd() {
+  HWND hwnd = ::GetForegroundWindow();
+  if (hwnd == nullptr) return 0;
+  return reinterpret_cast<uint64_t>(hwnd);
+}
+
 }  // namespace process_audio

client/native/process-audio/src/window_finder.h

@@ -22,6 +22,14 @@ struct WindowInfo {
   std::wstring title;
   std::wstring process_name;
   std::wstring root_process_name;
+
+  /** 窗口矩形（像素，GetWindowRect） */
+  int32_t left = 0;
+  int32_t top = 0;
+  int32_t width = 0;
+  int32_t height = 0;
+  /** 置顶窗口（WS_EX_TOPMOST） */
+  bool always_on_top = false;
 };
 
 /** 枚举所有可见且有标题的顶层窗口 */
@@ -30,6 +38,9 @@ std::vector<WindowInfo> ListAudioWindows();
 /** 单独解析某个 PID 的应用根进程 */
 uint32_t ResolveRootPidForPid(uint32_t pid);
 
+/** 取当前前台窗口 HWND；无前台窗口时返回 0 */
+uint64_t GetForegroundWindowHwnd();
+
 }  // namespace process_audio
 
 #endif  // PROCESS_AUDIO_WINDOW_FINDER_H_