feat(window-recognition): windowScorer 组合入口（信号注入+记忆查找，导出兼容）

Author: Aparencia

client/electron/windowScorer.test.ts

@@ -0,0 +1,65 @@
+// @vitest-environment node
+/**
+ * 窗口评分组合入口测试
+ * @ai-context: 兼容路径（无信号=纯标题，与改造前行为一致）；信号注入路径；
+ * 记忆查找注入（courseName 携带 + boost 计入总分）。
+ */
+import { describe, it, expect } from 'vitest';
+import { scoreAndFilterWindows } from './windowScorer.js';
+
+const WIN = (id: string, title: string) => ({ id, title, thumbnail: '' });
+
+describe('scoreAndFilterWindows — 兼容路径（无信号）', () => {
+  it('空标题与黑名单窗口被过滤', () => {
+    const out = scoreAndFilterWindows([WIN('1', ''), WIN('2', 'Program Manager'), WIN('3', '腾讯会议')]);
+    expect(out.map((w) => w.id)).toEqual(['3']);
+  });
+  it('无信号时评分与旧逻辑等价（关键词排序）', () => {
+    const out = scoreAndFilterWindows([WIN('1', '随便看看'), WIN('2', '腾讯会议 - 网课')]);
+    expect(out[0].id).toBe('2');
+    expect(out[0].score).toBeGreaterThanOrEqual(80);
+    expect(out[1].score).toBe(0);
+  });
+  it('matched 兼容：填充最高权重理由', () => {
+    const out = scoreAndFilterWindows([WIN('1', '腾讯会议 - 网课')]);
+    expect(out[0].matched).toBeTruthy();
+  });
+});
+
+describe('scoreAndFilterWindows — 信号注入路径', () => {
+  it('按 source id 注入信号参与评分', () => {
+    const out = scoreAndFilterWindows(
+      [WIN('window:111:0', '原神萌新攻略')],
+      {
+        signalsBySourceId: new Map([['window:111:0', { title: '原神萌新攻略', processName: 'steam.exe' }]]),
+      },
+    );
+    expect(out[0].processName).toBe('steam.exe');
+    expect(out[0].confidence).toBeDefined();
+    expect(out[0].reasons?.length).toBeGreaterThan(0);
+  });
+  it('记忆查找注入：携带 courseName 并计入 boost', () => {
+    const out = scoreAndFilterWindows(
+      [WIN('window:111:0', '高等数学 - bilibili.com')],
+      {
+        signalsBySourceId: new Map([['window:111:0', { title: '高等数学 - bilibili.com' }]]),
+        memoryLookup: () => ({ courseName: '高等数学', boost: 40 }),
+      },
+    );
+    expect(out[0].memoryCourseName).toBe('高等数学');
+    expect(out[0].score).toBeGreaterThanOrEqual(40);
+  });
+  it('排序：总分降序，同分按 id 稳定', () => {
+    const out = scoreAndFilterWindows(
+      [WIN('a', '随便看看'), WIN('b', '腾讯会议 - 网课'), WIN('c', '随便看看')],
+      {
+        signalsBySourceId: new Map([
+          ['a', { title: '随便看看' }],
+          ['b', { title: '腾讯会议 - 网课' }],
+          ['c', { title: '随便看看' }],
+        ]),
+      },
+    );
+    expect(out.map((w) => w.id)).toEqual(['b', 'a', 'c']);
+  });
+});

client/electron/windowScorer.ts

@@ -1,12 +1,18 @@
 /**
- * 窗口智能评分与过滤模块
+ * 窗口智能评分与过滤模块（组合入口）
  *
- * 基于关键词匹配对 desktopCapturer 返回的窗口列表进行评分和排序，
+ * 编排信号层（windowSignals）与规则层（windowRules）：对 desktopCapturer
+ * 返回的窗口列表附加系统信号（进程/几何/前台）与记忆 boost 后双向打分排序，
  * 过滤系统/不可见窗口，将最可能是网课/直播/会议的窗口排在前面。
- * 仅针对 Windows 平台优化关键词列表。
+ * 无信号注入时退化为纯标题评分（与旧版行为一致）。
  *
- * @ai-context: 采集窗口智能评分过滤：排除自身窗口（含旧品牌'课伴'关键词——防旧版本窗口被采集，为兼容保留勿删）与系统窗口。
+ * @ai-context: 采集窗口智能评分过滤：排除自身窗口（含旧品牌'课伴'关键词——
+ * 防旧版本窗口被采集，为兼容保留勿删）与系统窗口。信号源全部可选：native
+ * 缺失时仅标题关键词评分，保证行为不回归。
+ * @ai-context EN: Composition entry for window scoring. All signal sources
+ * are optional; without them the output matches legacy title-only behavior.
  */
+import { scoreWindow, type Confidence, type WindowSignalInput } from './windowRules.js';
 
 // ================================================================
 // 类型定义
@@ -17,110 +23,68 @@ export interface ScoredWindow {
   title: string;
   thumbnail: string;
   score: number;
-  matched?: string; // 命中的关键词（用于前端显示推荐理由）
+  matched?: string;
+  processName?: string;
+  confidence?: Confidence;
+  reasons?: string[];
+  /** 未被娱乐负分主导的学习分 */
+  learningScore?: number;
+  /** 记忆命中的课程名（供渲染层回填课程） */
+  memoryCourseName?: string;
+  /** 是否前台窗口（渲染层自动选中规则②使用） */
+  isForeground?: boolean;
 }
 
-// ================================================================
-// 关键词评分规则
-// ================================================================
-
-const SCORE_RULES = {
-  /** 高优先级：网课/直播/会议关键词 (+100) */
-  highPriority: [
-    '网课', '直播', '课程', '课堂', '学习', '讲座', '培训',
-    '腾讯会议', '钉钉', 'Zoom', 'Teams', 'Meet', 'Webex',
-    '中国大学MOOC', '学堂在线', '智慧树', '学习通', '雨课堂',
-    'Bilibili', '哔哩哔哩', 'YouTube', '网易公开课',
-    'Coursera', 'edX', 'Udemy',
-  ],
-  /** 中优先级：浏览器/视频播放器 (+50) */
-  mediumPriority: [
-    'Chrome', 'Edge', 'Firefox', 'Brave', 'Opera',
-    'PotPlayer', 'VLC', 'mpv', 'Windows Media',
-    'EV录屏', 'OBS', 'MPC-HC',
-  ],
-  /** 黑名单：系统/工具窗口（直接过滤） */
-  blacklist: [
-    'Program Manager',
-    'Taskbar',
-    'Settings',
-    '设置',
-    'Windows Input Experience',
-    'MSCTFIME',
-    'Default IME',
-    'Electron',
-    'Entropy decrease',
-    '课伴',
-    '熵减',
-  ],
-} as const;
-
-const HIGH_SCORE = 100;
-const MEDIUM_SCORE = 50;
-
-// ================================================================
-// 评分逻辑
-// ================================================================
-
-/**
- * 对窗口标题进行关键词匹配评分
- * @returns score 和 matched 关键词，若命中黑名单返回 null
- */
-function scoreTitle(title: string): { score: number; matched?: string } | null {
-  const lowerTitle = title.toLowerCase();
-
-  // 黑名单检测
-  for (const keyword of SCORE_RULES.blacklist) {
-    if (lowerTitle.includes(keyword.toLowerCase())) {
-      return null; // 过滤
-    }
-  }
-
-  // 高优先级匹配
-  for (const keyword of SCORE_RULES.highPriority) {
-    if (lowerTitle.includes(keyword.toLowerCase())) {
-      return { score: HIGH_SCORE, matched: keyword };
-    }
-  }
-
-  // 中优先级匹配
-  for (const keyword of SCORE_RULES.mediumPriority) {
-    if (lowerTitle.includes(keyword.toLowerCase())) {
-      return { score: MEDIUM_SCORE, matched: keyword };
-    }
-  }
-
-  // 无匹配，基础分 0
-  return { score: 0 };
+export interface ScoreAndFilterOptions {
+  /** 按 source id 注入的信号 */
+  signalsBySourceId?: Map<string, WindowSignalInput>;
+  /** 记忆查找注入（windowHistory 包装） */
+  memoryLookup?: (processName: string, title: string) => { courseName?: string; boost: number } | null;
 }
 
-/**
- * 对窗口列表进行评分、过滤和排序
- * @param windows 原始窗口列表（来自 desktopCapturer）
- * @returns 过滤并排序后的窗口列表（降序）
- */
 export function scoreAndFilterWindows(
   windows: { id: string; title: string; thumbnail: string }[],
+  options?: ScoreAndFilterOptions,
 ): ScoredWindow[] {
   const scored: ScoredWindow[] = [];
 
   for (const win of windows) {
-    // 过滤空标题窗口
     if (!win.title || win.title.trim() === '') continue;
 
-    const result = scoreTitle(win.title);
-    if (result === null) continue; // 命中黑名单
+    const signal: WindowSignalInput = {
+      title: win.title,
+      ...(options?.signalsBySourceId?.get(win.id) ?? {}),
+    };
+
+    const result = scoreWindow(signal);
+    if (result.filtered) continue;
 
-    scored.push({
+    const out: ScoredWindow = {
       id: win.id,
       title: win.title,
       thumbnail: win.thumbnail,
       score: result.score,
-      matched: result.matched,
-    });
+      matched: result.reasons[0],
+      reasons: result.reasons,
+      confidence: result.confidence,
+      learningScore: result.score - result.entertainmentPenalty,
+    };
+
+    if (signal.processName) out.processName = signal.processName;
+    if (signal.isForeground) out.isForeground = true;
+
+    // 记忆查找以标题为锚：进程缺失时传空串降级调用，不阻断记忆命中
+    if (options?.memoryLookup) {
+      const mem = options.memoryLookup(signal.processName ?? '', win.title);
+      if (mem) {
+        out.score += mem.boost;
+        out.memoryCourseName = mem.courseName;
+      }
+    }
+
+    scored.push(out);
   }
 
-  // 按 score 降序排列，同分按 id 稳定排序
   scored.sort((a, b) => {
     if (b.score !== a.score) return b.score - a.score;
     return a.id.localeCompare(b.id);