feat(ai): 精修发起 UI/编辑态 AI 入口/对话流式任务卡——目标 chips+档位+旋钮+提示词预览（REQ-245~247）

Author: Aparencia

app/src/components/AiRefineCard.tsx

@@ -18,10 +18,9 @@ import type {
   AiRefineResult,
   AiSettingsView,
   AiTaskState,
-  BalanceView,
-  RefineEstimateView,
 } from "../types";
 import RefineWorkbench from "./RefineWorkbench";
+import RefineLaunchDialog from "./RefineLaunchDialog";
 
 const btn: React.CSSProperties = { padding: "5px 10px", cursor: "pointer", fontSize: 12, borderRadius: 6 };
 
@@ -39,15 +38,14 @@ export default function AiRefineCard({
 }) {
   const [settings, setSettings] = useState<AiSettingsView | null>(null);
   const [phase, setPhase] = useState<"idle" | "consent" | "confirm" | "running" | "done" | "failed">("idle");
-  const [estimate, setEstimate] = useState<RefineEstimateView | null>(null);
-  const [balance, setBalance] = useState<BalanceView | null>(null);
   const [progress, setProgress] = useState<{ finished: number; total: number } | null>(null);
   const [result, setResult] = useState<AiRefineResult | null>(null);
   const [failure, setFailure] = useState<AiTaskFailureLike | null>(null);
-  const [remember, setRemember] = useState(false);
   const [msg, setMsg] = useState("");
   const [, setTaskId] = useState<number | null>(null);
   const [showWorkbench, setShowWorkbench] = useState(false);
+  // v0.17.0：策略发起对话框（目标/档位/旋钮/提示词预览/成本确认在对话框内）
+  const [showLaunch, setShowLaunch] = useState(false);
   // v0.16.1 审查修复：工作台「重新生成」不经用户启动路径——旁路导航跳转
   // （否则每次 regenerate 都会 onTaskStarted → App 把你从会话页拽到 AI 对话页）
   const skipNavigateRef = useRef(false);
@@ -102,7 +100,7 @@ export default function AiRefineCard({
     setMsg("任务 30 秒无进展（可能未启动或后台卡住）——请查看 tauri 终端 [refine-task] 日志后重试");
   });
 
-  /** ① 预估 + 余额（确认弹窗数据源） */
+  /** ① 快速检查 → 打开策略发起对话框（授权/成本确认/策略选择在对话框内） */
   const prepare = async () => {
     setMsg("");
     if (!settings?.enabled) {
@@ -115,36 +113,22 @@ export default function AiRefineCard({
       setPhase("idle");
       return;
     }
-    if (!settings.authorized) {
-      setPhase("consent");
-      return;
-    }
-    const est = await invoke<RefineEstimateView>("ai_refine_estimate", { sessionId }).catch(() => null);
-    const bal = await invoke<BalanceView>("ai_get_balance").catch(() => null);
-    if (!est) {
-      setMsg("成本预估失败，无法继续");
-      return;
-    }
-    setEstimate(est);
-    setBalance(bal);
-    setRemember(est.rememberCostChoice);
-    // 已"记住此选择"且同意过 → 跳过确认直接开始
-    if (est.rememberCostChoice) {
-      void start(est);
-    } else {
-      setPhase("confirm");
-    }
+    setShowLaunch(true);
   };
 
-  /** ② 启动任务（确认/授权通过后） */
-  const start = async (est?: RefineEstimateView) => {
+  /** ② 对话框确认启动回调（策略已由对话框传入——回接轮询/事件双通道） */
+  const handleDialogStarted = useCallback((sid: number, taskId: number) => {
+    setPhase("running");
+    taskIdRef.current = taskId;
+    // v0.16.1：会话页精修启动 → 自动跳 AI 对话页（任务卡入聊天线程/可追问）
+    if (!skipNavigateRef.current) onTaskStarted?.(sid, taskId);
+    setTaskId(taskId);
+    startPolling(taskId);
+  }, [onTaskStarted, startPolling]);
+
+  /** ② 启动任务（工作台「重新生成」路径——沿全局默认偏好；策略选择在主发起对话框） */
+  const start = async () => {
     setMsg("");
-    if (remember && !est) {
-      // 勾选"记住" → 持久化偏好
-      await invoke("ai_update_settings", {
-        settings: { ...settings, rememberCostChoice: true },
-      }).catch(() => undefined);
-    }
     setPhase("running");
     // 契约修复（2026-08-21 真机"排队中"根因）：Rust AiTaskHandle 为 camelCase
     // 序列化（taskId），此前读 handle.task_id 恒为 undefined → 事件被忽略、
@@ -177,12 +161,8 @@ export default function AiRefineCard({
     setResult(null);
     setFailure(null);
     setProgress(null);
-    setEstimate(null);
-    setBalance(null);
   };
 
-  const est = estimate?.estimate;
-
   return (
     <div style={{ border: "1px solid #c7d2fe", borderRadius: 8, padding: 10, marginBottom: 8, background: "#f5f3ff" }}>
       <div style={{ display: "flex", alignItems: "center", gap: 8, marginBottom: 6 }}>
@@ -204,56 +184,8 @@ export default function AiRefineCard({
         )}
       </div>
 
-      {/* 授权卡（首次：上传内容说明） */}
-      {phase === "consent" && (
-        <div style={{ border: "1px solid #f59e0b", background: "#fffbeb", borderRadius: 6, padding: 8, marginBottom: 6, fontSize: 12 }}>
-          <div style={{ fontWeight: 600, marginBottom: 4 }}>首次使用需授权</div>
-          精修将上传<strong>转写文本与最小上下文</strong>至 DeepSeek；本地优先铁律：<strong>音视频/图像永不出本机</strong>。是否同意？
-          <div style={{ marginTop: 6, display: "flex", gap: 6 }}>
-            <button style={{ ...btn, background: "#0d9488", color: "#fff", border: "none" }} onClick={async () => {
-              await invoke("ai_set_authorized", { authorized: true }).catch(() => undefined);
-              setSettings({ ...settings!, authorized: true });
-              setPhase("confirm");
-            }}>同意并继续</button>
-            <button style={btn} onClick={() => setPhase("idle")}>暂不</button>
-          </div>
-        </div>
-      )}
-
-      {/* 成本确认（REQ-143 基础版：token 预估 + 费用 + 内联余额） */}
-      {phase === "confirm" && est && (
-        <div style={{ border: "1px solid #e5e7eb", background: "#fff", borderRadius: 6, padding: 8, marginBottom: 6, fontSize: 12 }}>
-          <div style={{ fontWeight: 600, marginBottom: 4 }}>成本确认</div>
-          <div>
-            预估 token：<strong>{est.estTokens}</strong> · 预估费用：<strong>¥{est.estCostYuan.toFixed(4)}</strong>
-            {est.pricePer1m > 0 && <span style={{ color: "#6b7280" }}>（单价 ¥{est.pricePer1m}/1M token）</span>}
-            {est.pricePer1m === 0 && <span style={{ color: "#0d9488" }}>（当前模型免费档 ¥0）</span>}
-            {est.pricePer1m === 0 && est.priceKnown === false && <span style={{ color: "#d97706" }}>（该模型单价未登记，费用可能不准确）</span>}
-          </div>
-          {balance && (
-            <div style={{ color: balance.lowBalanceWarning ? "#dc2626" : "#374151" }}>
-              当前余额：<strong>¥{balance.balance.totalBalance.toFixed(2)}</strong>
-              {balance.lowBalanceWarning && <span style={{ marginLeft: 6 }}>⚠️ {balance.lowBalanceWarning}</span>}
-            </div>
-          )}
-          {/* F3-D：成本硬拦截提示——余额不足时启动会被后端拒绝（三出口引导） */}
-          {balance && est.estCostYuan > 0 && balance.balance.totalBalance < est.estCostYuan * 1.2 && (
-            <div style={{ color: "#b91c1c", marginTop: 2 }}>
-              ⚠️ 余额不足本次预估（含安全系数）——启动将被拦截，请充值或切换免费档模型
-            </div>
-          )}
-          <label style={{ display: "flex", alignItems: "center", gap: 4, margin: "4px 0" }}>
-            <input type="checkbox" checked={remember} onChange={(e) => setRemember(e.target.checked)} />
-            记住此选择，下次不再确认
-          </label>
-          <div style={{ display: "flex", gap: 6 }}>
-            <button style={{ ...btn, background: "#0d9488", color: "#fff", border: "none" }} onClick={() => void start()}>
-              开始精修
-            </button>
-            <button style={btn} onClick={reset}>取消</button>
-          </div>
-        </div>
-      )}
+      {/* 授权卡由 RefineLaunchDialog 承载（v0.17.0——策略/成本/授权一屏编排） */}
+      {phase === "consent" && null}
 
       {/* 任务进行中（切片进度） */}
       {phase === "running" && (
@@ -315,6 +247,15 @@ export default function AiRefineCard({
       )}
 
       {msg && <div style={{ fontSize: 11, color: msg.startsWith("已") ? "#0d9488" : "#dc2626", marginTop: 4 }}>{msg}</div>}
+
+      {/* v0.17.0：策略发起对话框（目标/档位/旋钮/预览/成本/授权） */}
+      {showLaunch && (
+        <RefineLaunchDialog
+          sessionId={sessionId}
+          onClose={() => setShowLaunch(false)}
+          onStarted={handleDialogStarted}
+        />
+      )}
     </div>
   );
 }

app/src/components/AiServicePanel.tsx

@@ -10,7 +10,9 @@
  */
 import { useCallback, useEffect, useState } from "react";
 import { invoke } from "@tauri-apps/api/core";
-import type { AiAuditEntry, AiSettingsView } from "../types";
+import type { AiAuditEntry, AiSettingsView, RefineStrategyMeta } from "../types";
+import RefineStrategyPicker from "./RefineStrategyPicker";
+import { draftFromPrefs, prefsFromDraft, type StrategyDraft } from "../utils/refineStrategy";
 
 /** 通用小按钮样式（与各设置面板一致） */
 const btn: React.CSSProperties = {
@@ -36,6 +38,21 @@ export default function AiServicePanel() {
   const [consentVisible, setConsentVisible] = useState(false);
   const [msg, setMsg] = useState<{ kind: "ok" | "err"; text: string } | null>(null);
   const [busy, setBusy] = useState(false);
+  // v0.17.0：产出偏好（meta 声明 + 草稿——保存为全局默认）
+  const [meta, setMeta] = useState<RefineStrategyMeta | null>(null);
+  const [strategyDraft, setStrategyDraft] = useState<StrategyDraft | null>(null);
+
+  /** 装载：设置（含偏好）+ 策略声明 → 初始草稿（默认档位/目标） */
+  const loadStrategy = useCallback(async (v: AiSettingsView | null) => {
+    if (!v) return;
+    try {
+      const mt = await invoke<RefineStrategyMeta>("ai_refine_strategy_meta");
+      setMeta(mt);
+      setStrategyDraft(draftFromPrefs(v.refineStrategy, mt));
+    } catch {
+      /* 声明加载失败不阻塞面板（偏好区隐藏） */
+    }
+  }, []);
 
   const load = useCallback(async () => {
     try {
@@ -58,6 +75,25 @@ export default function AiServicePanel() {
     void loadAudit();
   }, [load, loadAudit]);
 
+  // v0.17.0：设置（含偏好）加载后初始化策略草稿
+  useEffect(() => {
+    void loadStrategy(view);
+  }, [view, loadStrategy]);
+
+  /** 保存产出偏好为全局默认（仅为偏离基准的最小集——语义见 prefsFromDraft） */
+  const saveStrategy = async () => {
+    if (!strategyDraft || !meta) return;
+    setBusy(true);
+    try {
+      await invoke("ai_set_refine_strategy", { prefs: prefsFromDraft(strategyDraft, meta) });
+      setMsg({ kind: "ok", text: "已保存为默认产出偏好（下次精修默认采用）" });
+    } catch (e) {
+      setMsg({ kind: "err", text: `保存失败：${e}` });
+    } finally {
+      setBusy(false);
+    }
+  };
+
   /** 开关切换：未授权时先弹授权确认卡，同意后才真正开启 */
   const toggleEnabled = async (on: boolean) => {
     if (on && view && !view.authorized) {
@@ -159,6 +195,28 @@ export default function AiServicePanel() {
         <span style={{ color: "#6b7280" }}>（默认关——图片随精修上传，仅视频会话生效）</span>
       </div>
 
+      {/* v0.17.0：精修产出偏好（默认档位/目标——发起时可临时覆盖；REQ-245） */}
+      {(view || meta) && (
+        <div style={{ border: "1px solid #e0e7ff", borderRadius: 8, padding: 10, marginBottom: 10, background: "#fbfaff" }}>
+          <div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", marginBottom: 8 }}>
+            <span style={{ fontWeight: 600, fontSize: 12.5 }}>精修产出偏好（默认）</span>
+            <button
+              style={{ ...btn, padding: "2px 10px", background: "#4f46e5", color: "#fff", border: "none", fontWeight: 600 }}
+              disabled={strategyDraft == null}
+              onClick={() => void saveStrategy()}
+            >
+              保存为默认
+            </button>
+          </div>
+          <RefineStrategyPicker
+            meta={meta}
+            value={strategyDraft ?? { presetId: "", dims: {} }}
+            onChange={setStrategyDraft}
+          />
+          {msg?.kind === "ok" && <div style={{ color: "#0d9488", marginTop: 6 }}>{msg.text}</div>}
+        </div>
+      )}
+
       {/* 授权确认卡（开启且未授权时出现） */}
       {consentVisible && (
         <div

app/src/components/NoteAiDialog.tsx

@@ -0,0 +1,98 @@
+/**
+ * NoteAiDialog — 笔记编辑态 AI 能力对话框（v0.17.0 REQ-246）。
+ *
+ * @ai-context: 统一入口（精修/知识补充/预留槽位）——知识补充板块从阅读态
+ *              独立面板迁移至此（用户裁决：阅读态用 AI 直接进入编辑态）。
+ *              精修=笔记级（内容=编辑器当前内容直接传参，未保存所见即所修；
+ *              profile=handwritten 笔记式/用户所选；基线=当前笔记版）；
+ *              补充=现有 EnrichPanel 交互（九子项勾选）内嵌复用。
+ */
+
+import { useState } from "react";
+import EnrichPanel from "./EnrichPanel";
+import RefineLaunchDialog from "./RefineLaunchDialog";
+
+const menuBtn: React.CSSProperties = {
+  display: "block", width: "100%", textAlign: "left",
+  padding: "10px 12px", cursor: "pointer", fontSize: 13, borderRadius: 8,
+  border: "1px solid #e5e7eb", background: "#fff", color: "#374151", marginBottom: 6,
+};
+
+export default function NoteAiDialog({
+  noteId,
+  noteContent,
+  onClose,
+  onUpdated,
+}: {
+  noteId: number;
+  /** 编辑器当前内容（发起精修时直接传参——未保存所见即所修） */
+  noteContent: string;
+  onClose: () => void;
+  /** 知识补充完成回调（父层刷新笔记） */
+  onUpdated?: (noteId: number) => void;
+}) {
+  const [kind, setKind] = useState<"menu" | "refine" | "enrich">("menu");
+
+  return (
+    <div
+      style={{ position: "fixed", inset: 0, background: "rgba(17,24,39,.45)", zIndex: 1000,
+        display: "flex", alignItems: "center", justifyContent: "center" }}
+      onClick={() => { if (kind === "menu") onClose(); }}
+    >
+      <div
+        style={{ width: 460, maxWidth: "92vw", maxHeight: "86vh", overflowY: "auto",
+          background: "#fff", borderRadius: 12, padding: 16, boxShadow: "0 8px 30px rgba(0,0,0,.2)" }}
+        onClick={(e) => e.stopPropagation()}
+      >
+        {kind === "menu" && (
+          <>
+            <div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", marginBottom: 10 }}>
+              <span style={{ fontWeight: 600, fontSize: 14, color: "#374151" }}>🤖 AI 能力</span>
+              <span style={{ fontSize: 11, color: "#9ca3af" }}>笔记 #{noteId}</span>
+            </div>
+            <button style={{ ...menuBtn, background: "#f5f3ff", border: "1px solid #c7d2fe" }} onClick={() => setKind("refine")}>
+              <span style={{ fontWeight: 600 }}>✨ AI 精修</span>
+              <div style={{ fontSize: 11, color: "#6b7280", marginTop: 2 }}>
+                整理当前笔记（去冗余/结构化/按目标改写）——选择目标/变化程度，可实时预览提示词
+              </div>
+            </button>
+            <button style={menuBtn} onClick={() => setKind("enrich")}>
+              <span style={{ fontWeight: 600 }}>✧ 知识补充</span>
+              <div style={{ fontSize: 11, color: "#6b7280", marginTop: 2 }}>
+                补充与笔记相关的新知识（概念展开/步骤补全/例子/进阶/资源）——九子项勾选
+              </div>
+            </button>
+          </>
+        )}
+
+        {kind === "refine" && (
+          <RefineLaunchDialog
+            noteId={noteId}
+            noteContent={noteContent}
+            onClose={onClose}
+            onStarted={(_targetId, _taskId) => {
+              // 任务已入后台（事件/轮询双通道）——关闭对话框；父层保持编辑态
+              onClose();
+            }}
+          />
+        )}
+
+        {kind === "enrich" && (
+          <div>
+            <div style={{ display: "flex", justifyContent: "space-between", alignItems: "center", marginBottom: 8 }}>
+              <span style={{ fontWeight: 600, fontSize: 14, color: "#374151" }}>✧ 知识补充</span>
+              <button
+                onClick={onClose}
+                style={{ padding: "3px 10px", cursor: "pointer", fontSize: 12, border: "1px solid #d1d5db", borderRadius: 6, background: "#fff" }}
+              >
+                完成
+              </button>
+            </div>
+            {/* 九子项面板复用（REQ-142 交互不变——仅入口迁至编辑态） */}
+            <EnrichPanel noteId={noteId} onUpdated={() => onUpdated?.(noteId)} />
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}

app/src/components/NoteEditView.tsx

@@ -25,9 +25,11 @@ interface Props {
 }
 
 /** v0.13.6（审查 H1 修复）：父层命令式出口——ESC 出口先 await 保存再刷新
- *  （原 ESC 由父层直接 setEditing(false)，卸载保存与刷新竞态重演 P0） */
+ *  （原 ESC 由父层直接 setEditing(false)，卸载保存与刷新竞态重演 P0）
+ *  v0.17.0：getContent——编辑器当前内容（AI 发起所见即所修，未保存传参） */
 export interface NoteEditHandle {
   flushSave: () => Promise<void>;
+  getContent: () => string;
 }
 
 // L14：自动保存双计时参数——停止输入 2s 存一次（debounce）；dirty 期间最长
@@ -129,7 +131,11 @@ const NoteEditView = forwardRef<NoteEditHandle, Props>(function NoteEditView({ n
   }, [note.id]);
 
   // 父层命令式出口（NotesPage ESC 出口先 await 再刷新）
-  useImperativeHandle(ref, () => ({ flushSave: () => flushLatest() }), [flushLatest]);
+  useImperativeHandle(
+    ref,
+    () => ({ flushSave: () => flushLatest(), getContent: () => contentRef.current }),
+    [flushLatest],
+  );
 
   // Ctrl+S 显式保存（建版本）
   const handleKeyDown = useCallback((e: React.KeyboardEvent) => {