@fv-ui/ai-chat 0.8.0 → 0.8.1

package/dist/index.d.ts

@@ -1484,7 +1484,7 @@ type __VLS_Props$3 = {
     suggestions?: AiMessagesSuggestion[];
     /** 空态建议区标题 */
     suggestionsTitle?: string;
-    /** 用户上滚免打扰阈值(px):距底不超过该值才自动吸底 */
+    /** 用户上滚免打扰阈值(px):距底不超过该值视为「钉在底部」,流式/完成自动跟随 */
     scrollThreshold?: number;
     /** 显示滚到底部悬浮按钮 */
     showScrollButton?: boolean;

package/es/index.mjs

@@ -6450,7 +6450,7 @@ var _sfc_main$2 = /* @__PURE__ */ defineComponent({
     description: { type: String, required: false, default: "" },
     suggestions: { type: Array, required: false, default: () => [] },
     suggestionsTitle: { type: String, required: false, default: "" },
-    scrollThreshold: { type: Number, required: false, default: 40 },
+    scrollThreshold: { type: Number, required: false, default: 100 },
     showScrollButton: { type: Boolean, required: false, default: true },
     scrollButtonThreshold: { type: Number, required: false, default: 100 },
     showActions: { type: Boolean, required: false, default: true },
@@ -6475,21 +6475,35 @@ var _sfc_main$2 = /* @__PURE__ */ defineComponent({
       if (!el) return 0;
       return el.scrollHeight - el.scrollTop - el.clientHeight;
     }
+    const isPinnedToBottom = ref(true);
     function scrollToBottom(smooth = true) {
       const el = scrollRef.value;
       if (!el) return;
+      isPinnedToBottom.value = true;
       try {
         el.scrollTo({ top: el.scrollHeight, behavior: smooth ? "smooth" : "auto" });
       } catch {
         el.scrollTop = el.scrollHeight;
       }
     }
-    function scrollToBottomIfNear() {
-      if (distanceFromBottom() <= props.scrollThreshold) nextTick(() => scrollToBottom());
+    function scrollToBottomNow() {
+      const el = scrollRef.value;
+      if (!el) return;
+      isPinnedToBottom.value = true;
+      try {
+        el.scrollTo({ top: el.scrollHeight, behavior: "auto" });
+      } catch {
+        el.scrollTop = el.scrollHeight;
+      }
+    }
+    function followIfPinned() {
+      if (isPinnedToBottom.value) nextTick(() => scrollToBottomNow());
     }
     const isAwayFromBottom = ref(false);
     function onScroll() {
-      isAwayFromBottom.value = distanceFromBottom() > props.scrollButtonThreshold;
+      const d = distanceFromBottom();
+      isPinnedToBottom.value = d <= props.scrollThreshold;
+      isAwayFromBottom.value = d > props.scrollButtonThreshold;
     }
     watch(() => props.scrollButtonThreshold, onScroll);
     onMounted(() => {
@@ -6497,7 +6511,7 @@ var _sfc_main$2 = /* @__PURE__ */ defineComponent({
       onScroll();
     });
     watch(() => props.messages.length, (nv, ov) => {
-      if (nv > (ov ?? 0)) scrollToBottomIfNear();
+      if (nv > (ov ?? 0)) followIfPinned();
     });
     watch(
       () => props.messages.filter((m) => m.role === "user").length,
@@ -6510,11 +6524,11 @@ var _sfc_main$2 = /* @__PURE__ */ defineComponent({
         (sum, m) => sum + m.content.length + (m.reasoning?.length ?? 0) + (m.toolSteps?.reduce((s, t) => s + (t.status?.length ?? 0) + (t.title?.length ?? 0), 0) ?? 0) + (m.toolSteps?.length ?? 0),
         0
       ),
-      () => scrollToBottomIfNear()
+      () => followIfPinned()
     );
     watch(
       () => props.messages.reduce((sum, m) => sum + (m.status === "done" || m.status === "error" ? 1 : 0), 0),
-      () => scrollToBottomIfNear()
+      () => followIfPinned()
     );
     function branchInfo(m) {
       if (!m) return void 0;

package/lib/index.js

@@ -6466,7 +6466,7 @@ ${fileParts.join("\n")}` });
       description: { type: String, required: false, default: "" },
       suggestions: { type: Array, required: false, default: () => [] },
       suggestionsTitle: { type: String, required: false, default: "" },
-      scrollThreshold: { type: Number, required: false, default: 40 },
+      scrollThreshold: { type: Number, required: false, default: 100 },
       showScrollButton: { type: Boolean, required: false, default: true },
       scrollButtonThreshold: { type: Number, required: false, default: 100 },
       showActions: { type: Boolean, required: false, default: true },
@@ -6491,21 +6491,35 @@ ${fileParts.join("\n")}` });
         if (!el) return 0;
         return el.scrollHeight - el.scrollTop - el.clientHeight;
       }
+      const isPinnedToBottom = vue.ref(true);
       function scrollToBottom(smooth = true) {
         const el = scrollRef.value;
         if (!el) return;
+        isPinnedToBottom.value = true;
         try {
           el.scrollTo({ top: el.scrollHeight, behavior: smooth ? "smooth" : "auto" });
         } catch {
           el.scrollTop = el.scrollHeight;
         }
       }
-      function scrollToBottomIfNear() {
-        if (distanceFromBottom() <= props.scrollThreshold) vue.nextTick(() => scrollToBottom());
+      function scrollToBottomNow() {
+        const el = scrollRef.value;
+        if (!el) return;
+        isPinnedToBottom.value = true;
+        try {
+          el.scrollTo({ top: el.scrollHeight, behavior: "auto" });
+        } catch {
+          el.scrollTop = el.scrollHeight;
+        }
+      }
+      function followIfPinned() {
+        if (isPinnedToBottom.value) vue.nextTick(() => scrollToBottomNow());
       }
       const isAwayFromBottom = vue.ref(false);
       function onScroll() {
-        isAwayFromBottom.value = distanceFromBottom() > props.scrollButtonThreshold;
+        const d = distanceFromBottom();
+        isPinnedToBottom.value = d <= props.scrollThreshold;
+        isAwayFromBottom.value = d > props.scrollButtonThreshold;
       }
       vue.watch(() => props.scrollButtonThreshold, onScroll);
       vue.onMounted(() => {
@@ -6513,7 +6527,7 @@ ${fileParts.join("\n")}` });
         onScroll();
       });
       vue.watch(() => props.messages.length, (nv, ov) => {
-        if (nv > (ov ?? 0)) scrollToBottomIfNear();
+        if (nv > (ov ?? 0)) followIfPinned();
       });
       vue.watch(
         () => props.messages.filter((m) => m.role === "user").length,
@@ -6526,11 +6540,11 @@ ${fileParts.join("\n")}` });
           (sum, m) => sum + m.content.length + (m.reasoning?.length ?? 0) + (m.toolSteps?.reduce((s, t) => s + (t.status?.length ?? 0) + (t.title?.length ?? 0), 0) ?? 0) + (m.toolSteps?.length ?? 0),
           0
         ),
-        () => scrollToBottomIfNear()
+        () => followIfPinned()
       );
       vue.watch(
         () => props.messages.reduce((sum, m) => sum + (m.status === "done" || m.status === "error" ? 1 : 0), 0),
-        () => scrollToBottomIfNear()
+        () => followIfPinned()
       );
       function branchInfo(m) {
         if (!m) return void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fv-ui/ai-chat",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "基于 Vue3 + Element Plus 的 AI 对话组件库",
   "type": "module",
   "main": "lib/index.js",