fix(cards): 步骤信号收紧防叙事误判（REQ-199）

Author: Aparencia

app/src-tauri/src/card_generate.rs

@@ -15,7 +15,9 @@ pub const KIND_FACT: &str = "fact";
 pub const KIND_ACTION: &str = "action";
 
 /// 步骤语义元词（命中任一即判 action——中文教程/操作高频词）。
-const STEP_META_WORDS: [&str; 6] = ["第一步", "步骤", "做法", "流程", "操作步骤", "教程"];
+const STEP_META_WORDS: [&str; 7] = ["第一步", "步骤", "做法", "流程", "操作步骤", "教程", "首先"];
+/// "先…然后"成对信号的误判守卫词（普通叙事高频，非步骤语义）。
+const PAIR_SIGNAL_GUARD: [&str; 4] = ["先生", "先后", "优先", "先修"];
 
 /// 生成的卡片候选（front/back + 内容分型 kind）。
 #[derive(Debug, Clone, PartialEq, Eq)]
@@ -130,11 +132,25 @@ pub fn card_from_fragment(text: &str) -> Option<CardCandidate> {
 
 /// 步骤语义信号判定（REQ-199）：步骤元词命中，或"先…然后"成对出现。
 ///
-/// @ai-context: "先/然后"单现不算信号（普通叙事高频词，误判会把知识卡
-///              伪装成动作卡）；成对出现才隐含操作顺序。
+/// @ai-context: 审查修复（2026-08-22）："先"单字高频（先生/先后/优先/先修），
+///              且"先…然后"普通叙事（如"先修课…然后…"）不隐含操作顺序——
+///              成对信号须满足：守卫词不命中 + 至少 3 句 + 两词跨句（步骤
+///              序列的最小形态），元词命中不受限（词义明确）。
 fn has_step_signal(text: &str) -> bool {
-    STEP_META_WORDS.iter().any(|w| text.contains(w))
-        || (text.contains("先") && text.contains("然后"))
+    if STEP_META_WORDS.iter().any(|w| text.contains(w)) {
+        return true;
+    }
+    if PAIR_SIGNAL_GUARD.iter().any(|w| text.contains(w)) {
+        return false;
+    }
+    let sentences: Vec<&str> = text
+        .split(|c| "。！？；\n".contains(c))
+        .map(|s| s.trim())
+        .filter(|s| !s.is_empty())
+        .collect();
+    let xian_at = sentences.iter().position(|s| s.contains("先"));
+    let ranhou_at = sentences.iter().position(|s| s.contains("然后"));
+    sentences.len() >= 3 && xian_at.is_some() && ranhou_at.is_some() && xian_at != ranhou_at
 }
 
 #[cfg(test)]

app/src-tauri/src/card_generate_tests.rs

@@ -118,6 +118,38 @@ fn lone_ranhou_is_not_action_signal() {
     assert!(!card.back.starts_with("1. "));
 }
 
+#[test]
+fn xiu_ke_narrative_not_action() {
+    // Arrange："先修课…然后…"——"先"是课程名一部分，守卫词命中且非步骤
+    let text = "先修课是线性代数。然后学微积分。最后是概率论。";
+    // Act
+    let card = card_from_fragment(text).expect("出卡");
+    // Assert：维持 fact（守卫词拦截——防"先修/先后/优先/先生"误判）
+    assert_eq!(card.kind, KIND_FACT);
+    assert!(!card.back.starts_with("1. "));
+}
+
+#[test]
+fn two_sentence_xian_ranhou_not_action() {
+    // Arrange："先…然后"同现但仅 2 句——步骤序列的最小形态是 3 句
+    let text = "先复习错题。然后做新题。";
+    // Act
+    let card = card_from_fragment(text).expect("出卡");
+    // Assert：2 句不成序列（不足 3 句），维持 fact 诚实
+    assert_eq!(card.kind, KIND_FACT);
+}
+
+#[test]
+fn shou_xian_meta_word_counts_as_action() {
+    // Arrange："首先"入元词表——列表/步骤描述高频，词义明确不受句数限制
+    let text = "首先打开软件。接着导入素材。最后点击导出。";
+    // Act
+    let card = card_from_fragment(text).expect("出卡");
+    // Assert：元词命中 → action（跨句信号不需要，词义已定）
+    assert_eq!(card.kind, KIND_ACTION);
+    assert!(card.back.starts_with("1. 首先打开软件"));
+}
+
 #[test]
 fn single_sentence_with_signal_still_no_card() {
     // Arrange：单句含步骤信号——无多句结构，步骤清单无从谈起