feat(ai): add min text length threshold for auto summary/insights

Add summaryMinTextLength (default 100) and insightsMinTextLength
(default 300) configs. When article body is shorter than the
threshold, OnCreate/OnUpdate auto hooks skip task dispatch. Manual
generation is unaffected. Set to 0 to disable.

Author: Innei

apps/core/src/modules/ai/ai-insights/ai-insights.service.ts

@@ -575,6 +575,22 @@ export class AiInsightsService implements OnModuleInit {
     ) {
       return
     }
+
+    const minLen = aiConfig.insightsMinTextLength ?? 0
+    if (minLen > 0) {
+      try {
+        const { article } = await this.resolveArticleForInsights(event.id)
+        if ((article.text?.length ?? 0) < minLen) {
+          this.logger.debug(
+            `AI auto insights skipped (text below threshold ${minLen}): article=${event.id}`,
+          )
+          return
+        }
+      } catch {
+        return
+      }
+    }
+
     this.logger.log(`AI auto insights task created: article=${event.id}`)
     await this.aiTaskService.createInsightsTask({ refId: event.id })
   }
@@ -596,6 +612,13 @@ export class AiInsightsService implements OnModuleInit {
     } catch {
       return
     }
+    const minLen = aiConfig.insightsMinTextLength ?? 0
+    if (minLen > 0 && (article.text?.length ?? 0) < minLen) {
+      this.logger.debug(
+        `AI auto insights skipped (text below threshold ${minLen}): article=${event.id}`,
+      )
+      return
+    }
     const newHash = this.computeContentHash(article.text)
     const existing = await this.aiInsightsModel.find({
       refId: event.id,

apps/core/src/modules/ai/ai-summary/ai-summary.service.ts

@@ -729,6 +729,21 @@ export class AiSummaryService implements OnModuleInit {
       return
     }
 
+    const minLen = aiConfig.summaryMinTextLength ?? 0
+    if (minLen > 0) {
+      try {
+        const { document } = await this.resolveArticleForSummary(event.id)
+        if ((document.text?.length ?? 0) < minLen) {
+          this.logger.debug(
+            `AI auto summary skipped (text below threshold ${minLen}): article=${event.id}`,
+          )
+          return
+        }
+      } catch {
+        return
+      }
+    }
+
     this.logger.log(`AI auto summary task created: article=${event.id}`)
     await this.aiTaskService.createSummaryTask({
       refId: event.id,
@@ -756,6 +771,14 @@ export class AiSummaryService implements OnModuleInit {
       return
     }
 
+    const minLen = aiConfig.summaryMinTextLength ?? 0
+    if (minLen > 0 && (document.text?.length ?? 0) < minLen) {
+      this.logger.debug(
+        `AI auto summary skipped (text below threshold ${minLen}): article=${id}`,
+      )
+      return
+    }
+
     const existingSummaries = await this.aiSummaryModel.find({ refId: id })
     if (!existingSummaries.length) {
       return

apps/core/src/modules/configs/configs.default.ts

@@ -109,13 +109,15 @@ export const generateDefaultConfig: () => IConfig = () => ({
     enableAutoGenerateSummaryOnCreate: false,
     enableAutoGenerateSummaryOnUpdate: false,
     summaryTargetLanguages: [],
+    summaryMinTextLength: 100,
     insightsModel: undefined,
     insightsTranslationModel: undefined,
     enableInsights: false,
     enableAutoGenerateInsightsOnCreate: false,
     enableAutoGenerateInsightsOnUpdate: false,
     enableAutoTranslateInsights: false,
     insightsTargetLanguages: [],
+    insightsMinTextLength: 300,
   },
   oauth: {
     providers: [],

apps/core/src/modules/configs/configs.schema.ts

@@ -385,6 +385,18 @@ export const AISchema = section('AI 设定', {
         '自动生成摘要的目标语言列表，使用 [ISO 639-1 语言代码](https://www.w3schools.com/tags/ref_language_codes.asp)，如 ["zh", "en", "ja"]',
     },
   ),
+  summaryMinTextLength: field.number(
+    z.preprocess(
+      (val) =>
+        val === '' || val === null || val === undefined ? val : Number(val),
+      z.number().int().min(0).optional(),
+    ),
+    '摘要自动生成最小文本长度',
+    {
+      description:
+        '正文字符数低于此值时跳过自动钩子（OnCreate/OnUpdate），仅影响自动触发；0 表示不限。默认 100',
+    },
+  ),
   translationModel: field.plain(
     AIModelAssignmentSchema.optional(),
     '翻译功能模型',
@@ -445,6 +457,18 @@ export const AISchema = section('AI 设定', {
       description: 'ISO 639-1 列表；源语言自动排除',
     },
   ),
+  insightsMinTextLength: field.number(
+    z.preprocess(
+      (val) =>
+        val === '' || val === null || val === undefined ? val : Number(val),
+      z.number().int().min(0).optional(),
+    ),
+    'Insights 自动生成最小文本长度',
+    {
+      description:
+        '正文字符数低于此值时跳过自动钩子（OnCreate/OnUpdate），仅影响自动触发；0 表示不限。默认 300',
+    },
+  ),
 })
 export class AIDto extends createZodDto(AISchema) {}
 export type AIConfig = z.infer<typeof AISchema>

apps/core/test/src/modules/ai/ai-insights.service.spec.ts

@@ -129,6 +129,36 @@ describe('AiInsightsService', () => {
     expect(taskSvc.createInsightsTask).toHaveBeenCalledWith({ refId: 'a' })
   })
 
+  it('handleCreateArticle skips when text below insightsMinTextLength', async () => {
+    mockConfigService.get.mockResolvedValue({
+      enableInsights: true,
+      enableAutoGenerateInsightsOnCreate: true,
+      insightsMinTextLength: 100,
+    })
+    mockDatabaseService.findGlobalById.mockResolvedValue({
+      type: CollectionRefTypes.Post,
+      document: { title: 'T', text: 'short', lang: 'zh' },
+    })
+    const taskSvc: any = (service as any).aiTaskService
+    await service.handleCreateArticle({ id: 'a' })
+    expect(taskSvc.createInsightsTask).not.toHaveBeenCalled()
+  })
+
+  it('handleCreateArticle enqueues when text meets insightsMinTextLength', async () => {
+    mockConfigService.get.mockResolvedValue({
+      enableInsights: true,
+      enableAutoGenerateInsightsOnCreate: true,
+      insightsMinTextLength: 5,
+    })
+    mockDatabaseService.findGlobalById.mockResolvedValue({
+      type: CollectionRefTypes.Post,
+      document: { title: 'T', text: 'long enough body', lang: 'zh' },
+    })
+    const taskSvc: any = (service as any).aiTaskService
+    await service.handleCreateArticle({ id: 'a' })
+    expect(taskSvc.createInsightsTask).toHaveBeenCalledWith({ refId: 'a' })
+  })
+
   it('handleDeleteArticle cascades', async () => {
     await service.handleDeleteArticle({ id: 'a' })
     expect(mockModel.deleteMany).toHaveBeenCalledWith({ refId: 'a' })

apps/core/test/src/modules/ai/ai-summary.service.spec.ts

@@ -227,6 +227,56 @@ describe('AiSummaryService', () => {
     })
   })
 
+  describe('handleCreateArticle threshold', () => {
+    it('skips when text below summaryMinTextLength', async () => {
+      mockConfigService.get.mockResolvedValue({
+        enableSummary: true,
+        enableAutoGenerateSummaryOnCreate: true,
+        summaryTargetLanguages: ['zh'],
+        summaryMinTextLength: 100,
+      })
+      mockDatabaseService.findGlobalById.mockResolvedValue({
+        document: { title: 'T', text: 'short' },
+        type: CollectionRefTypes.Post,
+      })
+      const taskSvc: any = (service as any).aiTaskService
+      await service.handleCreateArticle({ id: 'a' })
+      expect(taskSvc.createSummaryTask).not.toHaveBeenCalled()
+    })
+
+    it('enqueues when text meets summaryMinTextLength', async () => {
+      mockConfigService.get.mockResolvedValue({
+        enableSummary: true,
+        enableAutoGenerateSummaryOnCreate: true,
+        summaryTargetLanguages: ['zh'],
+        summaryMinTextLength: 5,
+      })
+      mockDatabaseService.findGlobalById.mockResolvedValue({
+        document: { title: 'T', text: 'long enough body' },
+        type: CollectionRefTypes.Post,
+      })
+      const taskSvc: any = (service as any).aiTaskService
+      await service.handleCreateArticle({ id: 'a' })
+      expect(taskSvc.createSummaryTask).toHaveBeenCalledWith({
+        refId: 'a',
+        targetLanguages: ['zh'],
+      })
+    })
+
+    it('enqueues without fetching article when threshold is 0', async () => {
+      mockConfigService.get.mockResolvedValue({
+        enableSummary: true,
+        enableAutoGenerateSummaryOnCreate: true,
+        summaryTargetLanguages: ['zh'],
+        summaryMinTextLength: 0,
+      })
+      const taskSvc: any = (service as any).aiTaskService
+      await service.handleCreateArticle({ id: 'a' })
+      expect(mockDatabaseService.findGlobalById).not.toHaveBeenCalled()
+      expect(taskSvc.createSummaryTask).toHaveBeenCalled()
+    })
+  })
+
   describe('getSummaryByArticleId', () => {
     it('should return valid summary from database', async () => {
       const text = mockArticle.text