高效获取窗口信息：如何用active-win打造智能桌面应用

2026-04-17 08:35:53作者：曹令琨Iris

🌟 核心价值：为什么active-win是窗口信息获取的首选方案？

在多任务处理已成常态的今天，能否精准捕捉用户当前活动窗口状态，直接决定了桌面应用的智能化程度。无论是时间管理工具需要统计应用使用时长，还是自动化脚本需要根据窗口内容触发操作，active-win都提供了跨平台的底层支持。这个轻量级Node.js模块通过原生系统调用，能在Windows、macOS和Linux系统中高效获取窗口标题、进程ID、位置尺寸等关键元数据，其核心优势在于：

跨平台一致性：统一API封装不同系统的窗口管理机制，避免开发者处理平台差异
性能优化：原生二进制模块实现，单次调用响应时间低于10ms
信息完整性：不仅提供基础窗口属性，还能获取进程路径、所有者信息等深度数据

🚀 5分钟上手指南：从安装到第一个窗口监控程序

环境准备

确保系统已安装Node.js 14+ 环境，通过以下命令验证：

node -v  # 应输出 v14.0.0 或更高版本

安装步骤

📌 第一步：克隆项目仓库

git clone https://gitcode.com/gh_mirrors/ac/active-win
cd active-win

📌 第二步：安装依赖并构建

npm install
npm run build  # 编译原生系统模块

📌 第三步：基础使用示例（ES6模块版）

import activeWin from './index.js';

// 立即获取当前活动窗口
const getCurrentWindow = async () => {
  try {
    const windowInfo = await activeWin();
    console.log('当前活动窗口信息:', {
      title: windowInfo.title,
      app: windowInfo.owner.name,
      size: `${windowInfo.bounds.width}x${windowInfo.bounds.height}`,
      pid: windowInfo.owner.processId
    });
  } catch (error) {
    console.error('获取窗口信息失败:', error.message);
  }
};

// 每2秒轮询一次窗口状态
setInterval(getCurrentWindow, 2000);

运行上述代码后，控制台将周期性输出类似以下信息：

当前活动窗口信息: {
  title: 'active-win使用教程 - Google Chrome',
  app: 'Google Chrome',
  size: '1280x720',
  pid: 12345
}

💡 场景化应用：三个创新使用案例

1. 会议自动记录器

问题：线上会议时经常忘记记录参会人发言时间线
方案：通过监控窗口标题变化自动生成会议纪要框架

import activeWin from './index.js';
import fs from 'fs';

let lastApp = '';
const meetingLog = [];

// 检测窗口切换事件
const monitorMeeting = async () => {
  const window = await activeWin();
  const currentApp = window.owner.name;
  const currentTitle = window.title;
  
  if (currentApp !== lastApp) {
    const timestamp = new Date().toLocaleTimeString();
    meetingLog.push(`[${timestamp}] 切换到应用: ${currentApp} - ${currentTitle}`);
    console.log(`记录窗口切换: ${currentApp}`);
    lastApp = currentApp;
  }
  
  // 每30秒保存一次日志
  if (meetingLog.length % 2 === 0) {
    fs.writeFileSync('meeting-log.txt', meetingLog.join('\n'));
  }
};

// 启动监控
setInterval(monitorMeeting, 15000);

2. 应用使用时间统计器

问题：想知道自己每天在不同应用上的时间分配
方案：记录每个窗口的活跃时长并生成统计报告

import activeWin from './index.js';

const usageStats = {};
let lastCheck = Date.now();
let currentWindowId = null;

const updateStats = () => {
  const now = Date.now();
  const duration = (now - lastCheck) / 1000; // 转换为秒
  
  if (currentWindowId && usageStats[currentWindowId]) {
    usageStats[currentWindowId].duration += duration;
  }
  
  lastCheck = now;
};

const trackUsage = async () => {
  updateStats();
  const window = await activeWin();
  currentWindowId = window.id;
  
  if (!usageStats[currentWindowId]) {
    usageStats[currentWindowId] = {
      app: window.owner.name,
      title: window.title,
      duration: 0
    };
  }
  
  // 每小时输出一次统计
  const hour = Math.floor(Date.now() / 3600000);
  if (usageStats.lastHour !== hour) {
    console.log('\n=== 应用使用统计 ===');
    Object.values(usageStats).forEach(app => {
      console.log(`${app.app}: ${(app.duration / 60).toFixed(1)}分钟`);
    });
    usageStats.lastHour = hour;
  }
};

setInterval(trackUsage, 5000);

3. 专注模式自动屏蔽器

问题：工作时容易被娱乐应用分心
方案：检测到指定娱乐应用激活时自动隐藏窗口

import activeWin from './index.js';
import { exec } from 'child_process';

// 定义需要屏蔽的应用列表
const DISTRACTING_APPS = ['YouTube', 'Netflix', 'Steam'];

const enforceFocusMode = async () => {
  const window = await activeWin();
  
  if (DISTRACTING_APPS.includes(window.owner.name)) {
    console.log(`检测到分心应用: ${window.owner.name}`);
    
    // 根据不同系统发送窗口最小化命令
    switch (process.platform) {
      case 'win32':
        exec(`powershell -Command "(New-Object -ComObject Shell.Application).MinimizeAll()"`);
        break;
      case 'darwin':
        exec(`osascript -e 'tell application "System Events" to keystroke "m" using {command down}'`);
        break;
      case 'linux':
        exec(`xdotool windowminimize ${window.id}`);
        break;
    }
  }
};

// 每2秒检查一次
setInterval(enforceFocusMode, 2000);

🔍 技术解析：active-win的实现原理与高级配置

跨平台窗口检测机制对比

操作系统	底层技术	优势	局限性
Windows	User32.dll API	支持所有Windows版本	需要管理员权限获取某些进程信息
macOS	AppleScript + CoreGraphics	系统原生支持，信息完整	需 accessibility权限
Linux	X11窗口系统 + wmctrl	轻量级实现	依赖窗口管理器支持

高级参数配置

active-win提供了丰富的配置选项，满足不同场景需求：

// 完整配置示例
const windowInfo = await activeWin({
  screenRecordingPermission: true, // macOS下请求屏幕录制权限
  includeBounds: true, // 包含窗口位置和尺寸信息
  timeout: 5000, // 设置超时时间
  throwOnError: false // 出错时返回null而非抛出异常
});

常见错误与调试技巧

📌 权限问题

macOS: 需在系统偏好设置 > 安全性与隐私 > 辅助功能中添加终端/IDE权限
Linux: 确保安装xdotool和wmctrl工具：sudo apt install xdotool wmctrl

📌 性能优化

避免高频次调用（建议间隔≥100ms）
对相同窗口ID的连续调用可使用缓存

📌 错误处理最佳实践

try {
  const window = await activeWin();
  if (!window) {
    console.warn('未检测到活动窗口');
    return;
  }
  // 处理窗口信息
} catch (error) {
  if (error.message.includes('permission')) {
    console.error('需要权限：请在系统设置中启用辅助功能权限');
  } else {
    console.error('获取窗口信息失败:', error);
  }
}