feat(window-recognition): UI理由展示+内容分类进程信号+监听diff含标题变化

Author: Aparencia

client/electron/screenCaptureHandlers.ts

@@ -54,8 +54,8 @@ let captureSessionToken = 0;
 /** 窗口监听轮询定时器 */
 let windowWatchTimer: ReturnType<typeof setInterval> | null = null;
 
-/** 上一次窗口列表的 id 集合（用于 diff 检测变化） */
-let lastWindowIds: Set<string> = new Set();
+/** 上一次窗口列表的 id|name 键集合（用于 diff 检测变化，标题变化也触发） */
+let lastWindowKeys: Set<string> = new Set();
 
 const WINDOW_WATCH_INTERVAL_MS = 3000;
 
@@ -292,15 +292,15 @@ export function registerScreenCaptureHandlers(): void {
           thumbnailSize: { width: 240, height: 135 },
         });
 
-        const currentIds = new Set(sources.map((s) => s.id));
+        const currentKeys = new Set(sources.map((s) => `${s.id}|${s.name}`));
 
-        // 检测是否有变化（新增或关闭窗口）
+        // 检测是否有变化（新增/关闭窗口，或窗口标题变化）
         const hasChanged =
-          currentIds.size !== lastWindowIds.size ||
-          [...currentIds].some((id) => !lastWindowIds.has(id));
+          currentKeys.size !== lastWindowKeys.size ||
+          [...currentKeys].some((k) => !lastWindowKeys.has(k));
 
         if (hasChanged) {
-          lastWindowIds = currentIds;
+          lastWindowKeys = currentKeys;
 
           const rawWindows = sources.map((src) => {
             const thumb = src.thumbnail.isEmpty() ? src.thumbnail : src.thumbnail.resize({ width: 120 });
@@ -340,7 +340,7 @@ export function registerScreenCaptureHandlers(): void {
     if (windowWatchTimer) {
       clearInterval(windowWatchTimer);
       windowWatchTimer = null;
-      lastWindowIds = new Set();
+      lastWindowKeys = new Set();
       logger.info('[IPC] 窗口监听已停止');
     }
     return { success: true };
@@ -385,7 +385,7 @@ export function disposeScreenCaptureHandlers(): void {
   if (windowWatchTimer) {
     clearInterval(windowWatchTimer);
     windowWatchTimer = null;
-    lastWindowIds = new Set();
+    lastWindowKeys = new Set();
   }
   if (activeCapture) {
     activeCapture.dispose();

client/src/features/classroom/components/WindowSelectCard.tsx

@@ -41,8 +41,8 @@ function WindowRow({ win, isSelected, onClick }: { win: WindowInfo; isSelected:
       )}
       <div className="flex-1 min-w-0">
         <span className="text-b3 leading-tight line-clamp-1 block">{win.title}</span>
-        {win.matched && (
-          <span className="text-[10px] text-brand-500 leading-tight">匹配：{win.matched}</span>
+        {win.reasons?.[0] && (
+          <span className="text-[10px] text-brand-500 leading-tight">推荐：{win.reasons[0]}</span>
         )}
       </div>
       {(win.score ?? 0) >= 100 && (
@@ -115,6 +115,9 @@ export function WindowSelectCard({ windows, selected, onSelect, onRefresh, loadi
               {selected.matched && (
                 <span className="text-[10px] text-brand-500 leading-tight">匹配：{selected.matched}</span>
               )}
+              {selected.confidence === 'high' && (
+                <span className="text-[10px] font-medium text-brand-600 flex-shrink-0">自动识别</span>
+              )}
             </div>
             <span className="text-[11px] text-brand-600 flex-shrink-0">更换</span>
           </>

client/src/features/classroom/hooks/useWindowWatcher.ts

@@ -13,7 +13,7 @@ import type { WindowInfo, CourseMeta } from '@/lib/capture';
 const WINDOW_MISSING_THRESHOLD = 10;
 
 /** 常见课程名关键词（规则模式兜底提取） */
-const COURSE_KEYWORDS = /((?:高等数学|线性代数|概率论|大学物理|数据结构|操作系统|编译原理|离散数学|复变函数|英语|高数|大物|C语言|Python|Java|机器学习|深度学习|人工智能|计算机网络|数据库)[^\s|]*)/;
+const COURSE_KEYWORDS = /((?:高等数学|线性代数|概率论|大学物理|数据结构|操作系统|编译原理|离散数学|复变函数|英语|高数|大物|C语言|Python|Java|机器学习|深度学习|人工智能|计算机网络|数据库|入门|进阶|实战|从零|攻略|教程)[^\s|]*)/;
 
 interface UseWindowWatcherOptions {
   courseMeta: CourseMeta;

client/src/lib/capture/contentClassifier.test.ts

@@ -43,6 +43,21 @@ describe('classifyByTitle — 窗口标题规则', () => {
   });
 });
 
+describe('classifyByTitle — 进程名信号', () => {
+  it('进程名命中软件名单 → software_skill（标题无特征词）', () => {
+    expect(classifyByTitle('随便看看', 'photoshop.exe')).toBe('software_skill');
+    expect(classifyByTitle('随便看看', 'obs64.exe')).toBe('software_skill');
+    expect(classifyByTitle('随便看看', 'code.exe')).toBe('software_skill');
+  });
+  it('游戏/直播进程不误判，交给标题判定', () => {
+    expect(classifyByTitle('随便看看', 'steam.exe')).toBe('unknown');
+    expect(classifyByTitle('只狼全 Boss 打法教学', 'steam.exe')).not.toBe('unknown');
+  });
+  it('非软件进程保持原行为', () => {
+    expect(classifyByTitle('高等数学全程课程', 'chrome.exe')).toBe('course');
+  });
+});
+
 describe('classifyByTranscript — 转写证据投票', () => {
   it('软件操作指令词显著 → software_skill', () => {
     expect(classifyByTranscript('我们点击图层面板，把这个参数调整一下，快捷键是 Ctrl+J')).toBe('software_skill');

client/src/lib/capture/contentClassifier.ts

@@ -32,6 +32,10 @@ const CRAFT_TITLE_RE =
 const LECTURE_TITLE_RE =
   /讲座|演讲|发布会|报告|论坛|会议|访谈|大师课|公开课/i;
 
+/** 软件技能进程名单（标题无特征词时，进程名兜底判定；Windows） */
+const SOFTWARE_PROCESS_RE =
+  /photoshop|premiere|afterfx|illustrator|lightroom|剪映|obs64|blender|figma|sketch|unity|unreal|code\.exe|pycharm|intellij|webstorm|notepad\+\+|wps\.exe/i;
+
 // ================================================================
 // 转写术语证据规则
 // ================================================================
@@ -59,13 +63,15 @@ const COURSE_CUES = [
 // ================================================================
 
 /** 窗口标题单独分类（无转写信号时） */
-export function classifyByTitle(title: string): ContentKind {
+export function classifyByTitle(title: string, processName?: string): ContentKind {
   const t = (title ?? '').trim();
   if (!t) return 'unknown';
   // 讲座/会议类优先（"AI 开发者大会"含"开发"字样但属讲座场景，需先于软件判定）
   if (LECTURE_TITLE_RE.test(t)) return 'lecture';
   if (SOFTWARE_TITLE_RE.test(t)) return 'software_skill';
   if (CRAFT_TITLE_RE.test(t)) return 'craft_skill';
+  // 进程名兜底：软件技能进程在标题无特征词时判为软件技能
+  if (processName && SOFTWARE_PROCESS_RE.test(processName)) return 'software_skill';
   // 标题含"教程/课程/课堂/教学"默认按知识授课（视频站标题高频形态）
   if (/教程|课程|课堂|教学|网课/i.test(t)) return 'course';
   return 'unknown';
@@ -100,8 +106,12 @@ export interface ClassificationResult {
  * 综合分类：标题优先，无标题信号时用转写证据。
  * 标题信号覆盖转写（窗口标题是用户主动选择的上下文，可信度更高）。
  */
-export function classifyContent(windowTitle: string, transcriptText: string): ClassificationResult {
-  const byTitle = classifyByTitle(windowTitle);
+export function classifyContent(
+  windowTitle: string,
+  transcriptText: string,
+  processName?: string,
+): ClassificationResult {
+  const byTitle = classifyByTitle(windowTitle, processName);
   if (byTitle !== 'unknown') return { kind: byTitle, source: 'title' };
   const byTranscript = classifyByTranscript(transcriptText);
   if (byTranscript !== 'unknown') return { kind: byTranscript, source: 'transcript' };