feat(kb): REQ-302 笔记段到模型卡草稿接线

Author: Aparencia

app/src-tauri/src/commands_knowledge_cards.rs

@@ -132,3 +132,39 @@ pub(crate) fn list_group_cards_inner(
 #[cfg(test)]
 #[path = "commands_knowledge_cards_tests.rs"]
 mod tests;
+
+/// 笔记段 → 模型卡草稿接线（v0.20.3 / REQ-302，核心处理 γ M 行）。
+///
+/// @ai-context: 防双轨核对（REQ-302 前置）：model 卡唯一生成路径 =
+///              create_model_card_inner（本文件，幂等同组同 front）——本命令
+///              复用同一 inner，只是把「来源笔记段摘录」作为初始定义草稿载入
+///              （应用案例留空——用户到卡编辑完善）；与既有「model 卡纳入
+///              体系」（promote_card_to_concept 升格链）不重复。
+/// @ai-context: 组=唯一容器——笔记需已归组（无组笔记引导先归组，防孤儿卡）。
+#[tauri::command]
+pub fn model_card_from_note(
+    state: State<'_, AppState>,
+    note_id: i64,
+    name: String,
+    excerpt: Option<String>,
+) -> Result<Flashcard, String> {
+    let note = state
+        .db
+        .get_note(note_id)
+        .map_err(|e| e.to_string())?
+        .ok_or_else(|| "笔记不存在".to_string())?;
+    let group_id = note
+        .group_id
+        .ok_or_else(|| "笔记未归组——请先把笔记归入组（组是唯一容器），或直接用组卡列表入口创建".to_string())?;
+    // 摘录仅作文本载入（200 字护栏）；不做内容推断
+    let excerpt = match excerpt {
+        Some(t) => {
+            let t = t.trim().to_string();
+            let cut: String = t.chars().take(200).collect();
+            if t.chars().count() > 200 { format!("{}…", cut) } else { cut }
+        }
+        None => String::new(),
+    };
+    let essence = if excerpt.is_empty() { None } else { Some(excerpt) };
+    create_model_card_inner(&state.db, group_id, name, essence, None, None)
+}

app/src-tauri/src/lib.rs

@@ -966,6 +966,8 @@ pub fn run() {
             commands_after::question_list,
             commands_after::question_answer,
             commands_after::question_set_status,
+            // v0.20.3（REQ-302）：笔记段 → 模型卡草稿（复用既有 inner 防双轨）
+            commands_knowledge_cards::model_card_from_note,
             // v0.20.2（REQ-269）：ASR 混淆画像闭环——候选/确认/忽略/规则管理
             commands_asr_confusion::asr_confusion_get,
             commands_asr_confusion::asr_confusion_confirm,

app/src/components/ModelCardFromNoteDialog.tsx

@@ -0,0 +1,87 @@
+/**
+ * ModelCardFromNoteDialog — 笔记段 → 模型卡草稿（v0.20.3 / REQ-302）。
+ *
+ * @ai-context: 接线唯一生成链（commands_knowledge_cards::create_model_card_inner，
+ *              防双轨）：组内 kind=model 卡，front=归一化概念名，定义行=可选
+ *              笔记摘录草稿（应用案例留空——复习面/卡编辑完善）；笔记未归组
+ *              → 后端引导先归组（组=唯一容器）。
+ */
+import { useState } from "react";
+import { invoke } from "@tauri-apps/api/core";
+
+interface Props {
+  noteId: number;
+  noteTitle: string;
+  onClose: () => void;
+  onCreated?: () => void;
+}
+
+const overlayStyle: React.CSSProperties = {
+  position: "fixed",
+  inset: 0,
+  background: "rgba(0,0,0,.45)",
+  zIndex: 1000,
+  display: "flex",
+  alignItems: "center",
+  justifyContent: "center",
+};
+const cardStyle: React.CSSProperties = {
+  background: "#fff",
+  borderRadius: 12,
+  width: 460,
+  padding: 16,
+  fontSize: 13,
+};
+const btn: React.CSSProperties = { padding: "5px 12px", cursor: "pointer", fontSize: 12, borderRadius: 6, border: "1px solid #e5e7eb", background: "#fff", color: "#374151" };
+
+export default function ModelCardFromNoteDialog({ noteId, noteTitle, onClose, onCreated }: Props) {
+  const [name, setName] = useState("");
+  const [excerpt, setExcerpt] = useState("");
+  const [err, setErr] = useState("");
+  const [msg, setMsg] = useState("");
+  const [busy, setBusy] = useState(false);
+
+  const create = async () => {
+    setBusy(true);
+    setErr("");
+    try {
+      await invoke("model_card_from_note", { noteId, name, excerpt: excerpt.trim() || null });
+      setMsg("✓ 已建模型卡草稿（组内 model 卡；复习面/卡编辑可继续完善定义与应用案例）");
+      onCreated?.();
+      setTimeout(onClose, 900);
+    } catch (e) {
+      setErr(String(e));
+    } finally {
+      setBusy(false);
+    }
+  };
+
+  return (
+    <div style={overlayStyle} onClick={onClose}>
+      <div style={cardStyle} onClick={(e) => e.stopPropagation()}>
+        <div style={{ display: "flex", alignItems: "center", marginBottom: 10 }}>
+          <h3 style={{ margin: 0, fontSize: 15 }}>🧠 提炼模型卡草稿</h3>
+          <span style={{ fontSize: 11, color: "#6b7280", marginLeft: 8 }}>来源：{noteTitle.slice(0, 24)}</span>
+          <button style={{ ...btn, marginLeft: "auto" }} onClick={onClose}>取消</button>
+        </div>
+        {msg && <div style={{ fontSize: 12, color: "#047857", marginBottom: 8 }}>{msg}</div>}
+        {err && <div style={{ fontSize: 12, color: "#dc2626", marginBottom: 8 }}>{err}</div>}
+        <div style={{ display: "flex", flexDirection: "column", gap: 8 }}>
+          <div>
+            <div style={{ fontSize: 12, color: "#374151", marginBottom: 2 }}>概念名（front）</div>
+            <input value={name} onChange={(e) => setName(e.target.value)} autoFocus placeholder="如：安全边际" style={{ width: "100%", boxSizing: "border-box", fontSize: 13, border: "1px solid #e5e7eb", borderRadius: 4, padding: "4px 6px" }} />
+          </div>
+          <div>
+            <div style={{ fontSize: 12, color: "#374151", marginBottom: 2 }}>
+              定义草稿（可空——应用案例留空，后续完善）
+            </div>
+            <textarea value={excerpt} onChange={(e) => setExcerpt(e.target.value)} rows={4} placeholder="粘贴笔记中的模型表述（≤200 字）…" style={{ width: "100%", boxSizing: "border-box", fontSize: 12, border: "1px solid #e5e7eb", borderRadius: 4, padding: "4px 6px", resize: "vertical" }} />
+          </div>
+          <div style={{ display: "flex", justifyContent: "flex-end", gap: 6 }}>
+            <button style={btn} disabled={busy} onClick={() => void create()}>创建草稿</button>
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}

app/src/pages/NotesPage.tsx

@@ -32,6 +32,8 @@ import NoteReadingView from "../components/NoteReadingView";
 import ImagePreviewOverlay from "../components/ImagePreviewOverlay";
 import VersionPanel from "../components/VersionPanel";
 import NoteAiDialog from "../components/NoteAiDialog";
+// v0.20.3（REQ-302）：笔记段 → 模型卡草稿对话框
+import ModelCardFromNoteDialog from "../components/ModelCardFromNoteDialog";
 import NoteLinkToSystem from "../components/NoteLinkToSystem";
 // v0.16.1：阅读头「移动到组」显式手动分组入口（拖拽/ⓘ 之外的可发现路径）
 import NoteMoveToGroupMenu from "../components/NoteMoveToGroupMenu";
@@ -71,6 +73,8 @@ export default function NotesPage({ focusNoteId, focusNoteSearch, focusGroupId,
   const [review, setReview] = useState<{ groupId: number | null; name: string } | undefined>(undefined);
   // v0.20.3（REQ-293）：行动中心（✅ 全量入口——组侧栏底部按钮打开）
   const [actionOpen, setActionOpen] = useState(false);
+  // v0.20.3（REQ-302）：笔记段 → 模型卡草稿对话框
+  const [modelDialogOpen, setModelDialogOpen] = useState(false);
   const [selected, setSelected] = useState<Note | null>(null);
   const [status, setStatus] = useState("");
   // v0.19.1：阅读态命中词搜索请求（来自引用跳转；key 递增可重触发）
@@ -555,6 +559,18 @@ export default function NotesPage({ focusNoteId, focusNoteSearch, focusGroupId,
                 >
                   🤖 AI
                 </button>
+                {/* v0.20.3（REQ-302）：笔记段 → 模型卡草稿（组内 model 卡唯一生成链） */}
+                <button
+                  data-testid="note-model-card-entry"
+                  onClick={() => setModelDialogOpen(true)}
+                  title="把本条笔记提炼为模型卡草稿（需已归组）"
+                  style={{
+                    padding: "3px 8px", cursor: "pointer", fontSize: 11, borderRadius: 6,
+                    border: "1px solid #d1fae5", background: "#ecfdf5", color: "#047857",
+                  }}
+                >
+                  🧠 模型卡
+                </button>
               </>
             }
             onEdit={() => setEditing(true)}
@@ -581,6 +597,16 @@ export default function NotesPage({ focusNoteId, focusNoteSearch, focusGroupId,
           onUpdated={() => void handleNoteChanged()}
         />
       )}
+      {/* v0.20.3（REQ-302）：模型卡草稿（组内 model 卡唯一生成链，防双轨） */}
+      {modelDialogOpen && selected && (
+        <ModelCardFromNoteDialog
+          key={`mc-${selected.id}`}
+          noteId={selected.id}
+          noteTitle={selected.title}
+          onClose={() => setModelDialogOpen(false)}
+          onCreated={() => { void handleNoteChanged(); }}
+        />
+      )}
       {/* v0.10.1：图片放大预览（ESC/点击遮罩关闭——与编辑退出 ESC 互斥） */}
       {previewImg && (
         <ImagePreviewOverlay src={previewImg.src} title={previewImg.title} onClose={() => setPreviewImg(null)} />