feat: improve document chunk loading and error handling in doc-content component

- Added state management for pending document requests to enhance user experience during chunk loading.
- Implemented error handling for chunk loading failures, providing user feedback through warnings.
- Adjusted scroll handling logic to ensure smoother pagination and prevent multiple concurrent requests.

This update enhances the reliability of document loading and improves user interaction during scrolling.
This commit is contained in:
wizardchen
2026-02-28 21:34:50 +08:00
committed by lyingbug
parent eb2dc534ad
commit 565660dc46
4 changed files with 58 additions and 13 deletions
+21 -3
View File
@@ -57,6 +57,8 @@ marked.use({
const renderer = new marked.Renderer();
let page = 1;
let loadingChunks = false;
let pendingRequestedPage: number | null = null;
let pendingChunksBeforeLoad = 0;
let doc = null;
let down = ref()
let mdContentWrap = ref()
@@ -142,9 +144,23 @@ onMounted(() => {
watch(() => props.details?.id, () => {
page = 1;
loadingChunks = false;
pendingRequestedPage = null;
pendingChunksBeforeLoad = 0;
});
watch(() => props.details?.md?.length, () => {
loadingChunks = false;
watch(() => props.details?.chunkLoading, (val) => {
if (val === false) {
if (pendingRequestedPage !== null) {
const currentLength = props.details?.md?.length || 0;
const hasError = Boolean(props.details?.chunkLoadError);
if (hasError && currentLength <= pendingChunksBeforeLoad) {
page = Math.max(1, pendingRequestedPage - 1);
MessagePlugin.warning(props.details?.chunkLoadError || '分块加载失败,请继续下滑重试');
}
}
pendingRequestedPage = null;
pendingChunksBeforeLoad = 0;
loadingChunks = false;
}
});
onUnmounted(() => {
doc.removeEventListener('scroll', handleDetailsScroll);
@@ -566,10 +582,12 @@ const handleDetailsScroll = () => {
if (doc && !loadingChunks) {
let pageNum = Math.ceil(props.details.total / 25);
const { scrollTop, scrollHeight, clientHeight } = doc;
if (scrollTop + clientHeight >= scrollHeight) {
if (scrollTop + clientHeight >= scrollHeight - 8) {
if (props.details.md.length < props.details.total && page + 1 <= pageNum) {
page++;
loadingChunks = true;
pendingRequestedPage = page;
pendingChunksBeforeLoad = props.details.md.length;
emit("getDoc", page);
}
}
+19 -4
View File
@@ -13,8 +13,8 @@ import { knowledgeStore } from "@/stores/knowledge";
import { useUIStore } from "@/stores/ui";
import { useRoute } from 'vue-router';
const usemenuStore = knowledgeStore();
export default function (knowledgeBaseId?: string) {
const usemenuStore = knowledgeStore();
const route = useRoute();
const { cardList, total } = storeToRefs(usemenuStore);
let moreIndex = ref(-1);
@@ -26,7 +26,9 @@ export default function (knowledgeBaseId?: string) {
total: 0,
type: "",
source: "",
file_type: ""
file_type: "",
chunkLoading: false,
chunkLoadError: "",
});
const getKnowled = (
query: { page: number; page_size: number; tag_id?: string; keyword?: string; file_type?: string } = { page: 1, page_size: 35 },
@@ -147,7 +149,8 @@ export default function (knowledgeBaseId?: string) {
id: "",
type: "",
source: "",
file_type: ""
file_type: "",
chunkLoadError: "",
});
getKnowledgeDetails(item.id)
.then((result: any) => {
@@ -168,6 +171,8 @@ export default function (knowledgeBaseId?: string) {
};
const getfDetails = (id: string, page: number) => {
details.chunkLoading = true;
details.chunkLoadError = "";
getKnowledgeDetailsCon(id, page)
.then((result: any) => {
if (result.success && result.data) {
@@ -180,7 +185,17 @@ export default function (knowledgeBaseId?: string) {
details.total = totalResult;
}
})
.catch(() => {});
.catch((err: any) => {
details.chunkLoadError = err?.message || "分块加载失败";
console.error("[ChunkLoad] failed", {
knowledgeId: id,
page,
error: err,
});
})
.finally(() => {
details.chunkLoading = false;
});
};
return {
cardList,
+17 -6
View File
@@ -13,6 +13,9 @@ import (
"github.com/sirupsen/logrus"
)
// appLogger 使用私有实例,避免外部依赖改写 logrus 全局状态导致日志丢失
var appLogger = logrus.New()
// LogLevel 日志级别类型
type LogLevel string
@@ -129,11 +132,20 @@ func (f *CustomFormatter) Format(entry *logrus.Entry) ([]byte, error) {
func init() {
// 根据环境变量设置全局日志级别
logLevel := getLogLevelFromEnv()
logrus.SetLevel(logLevel)
appLogger.SetLevel(logLevel)
// 统一输出到 stdout,确保在 Docker 容器中与 GORM/GIN 日志合并展示
appLogger.SetOutput(os.Stdout)
// 非终端(如 Docker 日志采集)禁用 ANSI 颜色,避免日志聚合/检索异常
forceColor := false
if fi, err := os.Stdout.Stat(); err == nil {
forceColor = (fi.Mode() & os.ModeCharDevice) != 0
}
// 设置日志格式而不修改全局时区
logrus.SetFormatter(&CustomFormatter{ForceColor: true})
logrus.SetReportCaller(false)
appLogger.SetFormatter(&CustomFormatter{ForceColor: forceColor})
appLogger.SetReportCaller(false)
}
// GetLogger 获取日志实例
@@ -141,8 +153,7 @@ func GetLogger(c context.Context) *logrus.Entry {
if logger := c.Value(types.LoggerContextKey); logger != nil {
return logger.(*logrus.Entry)
}
// 使用全局logrus实例,确保日志级别设置正确生效
return logrus.NewEntry(logrus.StandardLogger())
return logrus.NewEntry(appLogger)
}
// SetLogLevel 设置日志级别
@@ -164,7 +175,7 @@ func SetLogLevel(level LogLevel) {
logLevel = logrus.InfoLevel
}
logrus.SetLevel(logLevel)
appLogger.SetLevel(logLevel)
}
// getLogLevelFromEnv 从环境变量读取日志级别配置
+1
View File
@@ -61,6 +61,7 @@ type RouterParams struct {
// NewRouter 创建新的路由
func NewRouter(params RouterParams) *gin.Engine {
r := gin.New()
r.ContextWithFallback = true
// CORS 中间件应放在最前面
r.Use(cors.New(cors.Config{