feat(audio): 原生模块支持流式采集（采集线程 + ThreadSafeFunction）

Phase 2 前置：同步阻塞采集无法用于真实链路，新增生产采集入口。

- capture_session：WASAPI 激活/初始化/读包原语（pimpl 隐藏 COM），供同步与流式
  两路复用；含 isProcessLoopbackSupported 能力探测（真实尝试激活而非查版本号，
  避免兼容性设置伪造版本号导致误判）
- streaming_capture：采集线程按 chunkDurationMs 聚块回调，Stop 阻塞等待线程退出
  以保证无回调泄漏
- addon：新增 startCapture/stopCapture/isProcessLoopbackSupported，块经
  ThreadSafeFunction 投递到 JS 线程并拷贝为 ArrayBuffer
- loopback_capture 精简为复用 CaptureSession（去重 WASAPI 样板代码）

实测 spike-streaming：5 个 1s 块周期准确、样本数 16000 一致、元数据正确、
stopCapture 后零泄漏。

Author: Aparencia

client/native/process-audio/binding.gyp

@@ -5,7 +5,9 @@
       "sources": [
         "src/addon.cc",
         "src/window_finder.cc",
-        "src/loopback_capture.cc"
+        "src/capture_session.cc",
+        "src/loopback_capture.cc",
+        "src/streaming_capture.cc"
       ],
       "include_dirs": [
         "<!@(node -p \"require('node-addon-api').include\")"

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

@@ -1,12 +1,19 @@
 // N-API 绑定入口
 //
-// @ai-context: Phase 1 spike 第一步仅暴露窗口/进程解析，用于验证编译链路
-// 与"窗口 → PID → 应用根进程"回溯是否可靠；WASAPI 进程环回采集在验证
-// 通过后追加。
+// @ai-context: 导出三类能力——窗口/进程解析、能力探测、采集。
+// 采集分两个入口：captureToWav（同步阻塞，spike 验证用）与
+// startCapture/stopCapture（采集线程 + ThreadSafeFunction 流式回调，生产用）。
+// @ai-context: 单实例语义——IPC 层同时只有一路采集，重复 startCapture 报错
+// 而非默默覆盖，避免采集线程泄漏。
 
 #include <napi.h>
 
+#include <memory>
+#include <utility>
+
+#include "capture_session.h"
 #include "loopback_capture.h"
+#include "streaming_capture.h"
 #include "window_finder.h"
 
 namespace {
@@ -104,10 +111,136 @@ Napi::Value CaptureToWav(const Napi::CallbackInfo& info) {
   return out;
 }
 
+/** isProcessLoopbackSupported(): 能力探测（真实尝试激活一次） */
+Napi::Value IsSupported(const Napi::CallbackInfo& info) {
+  return Napi::Boolean::New(info.Env(), process_audio::IsProcessLoopbackSupported());
+}
+
+// ================================================================
+// 流式采集（生产入口）
+// ================================================================
+
+/** 投递给 JS 线程的负载：一个音频块或一次错误 */
+struct StreamEvent {
+  bool is_error = false;
+  std::string error;
+  process_audio::StreamingChunk chunk;
+};
+
+/** 全局单例采集器与其线程安全回调句柄 */
+std::unique_ptr<process_audio::StreamingCapture> g_capture;
+Napi::ThreadSafeFunction g_tsfn;
+
+/** 在 JS 线程消费采集线程投递的事件 */
+void DispatchStreamEvent(Napi::Env env, Napi::Function callback, StreamEvent* event) {
+  if (env != nullptr && callback != nullptr) {
+    Napi::Object payload = Napi::Object::New(env);
+    if (event->is_error) {
+      payload.Set("error", Napi::String::New(env, event->error));
+    } else {
+      const size_t bytes = event->chunk.samples.size() * sizeof(float);
+      // 拷贝一份给 JS：采集线程的 vector 回调后即释放，不能共享内存
+      Napi::ArrayBuffer buffer = Napi::ArrayBuffer::New(env, bytes);
+      if (bytes > 0) {
+        std::memcpy(buffer.Data(), event->chunk.samples.data(), bytes);
+      }
+      payload.Set("audioBuffer", buffer);
+      payload.Set("sampleRate", Napi::Number::New(env, event->chunk.sample_rate));
+      payload.Set("channels", Napi::Number::New(env, event->chunk.channels));
+      payload.Set("durationMs", Napi::Number::New(env, event->chunk.duration_ms));
+    }
+    callback.Call({payload});
+  }
+  delete event;
+}
+
+/**
+ * startCapture({ pid, sampleRate, channels, chunkDurationMs }, cb):
+ * 启动采集线程，每聚成一块就回调 cb({audioBuffer, sampleRate, channels,
+ * durationMs})；致命错误回调 cb({error})。
+ *
+ * 会话打开在采集线程内完成，故"目标不可采"这类失败以 error 回调形式
+ * 异步上报，调用方应据此触发降级。
+ */
+Napi::Value StartCapture(const Napi::CallbackInfo& info) {
+  Napi::Env env = info.Env();
+  if (info.Length() < 2 || !info[0].IsObject() || !info[1].IsFunction()) {
+    Napi::TypeError::New(env, "startCapture(options, callback) 参数不完整")
+        .ThrowAsJavaScriptException();
+    return env.Undefined();
+  }
+  if (g_capture && g_capture->running()) {
+    Napi::Error::New(env, "采集已在进行中，请先 stopCapture")
+        .ThrowAsJavaScriptException();
+    return env.Undefined();
+  }
+
+  Napi::Object opts = info[0].As<Napi::Object>();
+  process_audio::StreamingOptions options;
+  options.root_pid = opts.Has("pid")
+      ? opts.Get("pid").As<Napi::Number>().Uint32Value() : 0;
+  options.sample_rate = opts.Has("sampleRate")
+      ? opts.Get("sampleRate").As<Napi::Number>().Uint32Value() : 16000;
+  options.channels = opts.Has("channels")
+      ? opts.Get("channels").As<Napi::Number>().Uint32Value() : 1;
+  options.chunk_duration_ms = opts.Has("chunkDurationMs")
+      ? opts.Get("chunkDurationMs").As<Napi::Number>().Uint32Value() : 5000;
+
+  g_tsfn = Napi::ThreadSafeFunction::New(
+      env, info[1].As<Napi::Function>(), "process-audio-capture", 0, 1);
+
+  g_capture = std::make_unique<process_audio::StreamingCapture>();
+  const std::string err = g_capture->Start(
+      options,
+      [](process_audio::StreamingChunk&& chunk) {
+        auto* event = new StreamEvent();
+        event->chunk = std::move(chunk);
+        // 采集线程不能直接碰 JS，统一经 ThreadSafeFunction 投递
+        if (g_tsfn.BlockingCall(event, DispatchStreamEvent) != napi_ok) {
+          delete event;
+        }
+      },
+      [](const std::string& message) {
+        auto* event = new StreamEvent();
+        event->is_error = true;
+        event->error = message;
+        if (g_tsfn.BlockingCall(event, DispatchStreamEvent) != napi_ok) {
+          delete event;
+        }
+      });
+
+  Napi::Object result = Napi::Object::New(env);
+  if (!err.empty()) {
+    g_tsfn.Release();
+    g_capture.reset();
+    result.Set("ok", Napi::Boolean::New(env, false));
+    result.Set("error", Napi::String::New(env, err));
+    return result;
+  }
+  result.Set("ok", Napi::Boolean::New(env, true));
+  result.Set("error", Napi::String::New(env, ""));
+  return result;
+}
+
+/** stopCapture(): 停止采集并等待线程退出（幂等） */
+Napi::Value StopCapture(const Napi::CallbackInfo& info) {
+  Napi::Env env = info.Env();
+  if (g_capture) {
+    g_capture->Stop();
+    g_capture.reset();
+    g_tsfn.Release();
+  }
+  return Napi::Boolean::New(env, true);
+}
+
 Napi::Object Init(Napi::Env env, Napi::Object exports) {
   exports.Set("listAudioWindows", Napi::Function::New(env, ListAudioWindows));
   exports.Set("resolveRootPid", Napi::Function::New(env, ResolveRootPid));
   exports.Set("captureToWav", Napi::Function::New(env, CaptureToWav));
+  exports.Set("isProcessLoopbackSupported",
+              Napi::Function::New(env, IsSupported));
+  exports.Set("startCapture", Napi::Function::New(env, StartCapture));
+  exports.Set("stopCapture", Napi::Function::New(env, StopCapture));
   return exports;
 }