feat(ai): add comment review endpoint and enhance AI configuration options

- Introduced a new endpoint `/comment-review/test` in `AiController` for testing AI comment review functionality.
- Implemented logic to validate comment text and check AI review settings before processing.
- Enhanced `configs.dsl.util.ts` and `configs.schema.ts` to support new action type for UI components, allowing for dynamic action button configurations.
- Updated Zod schema utilities to accommodate new action options for better UI integration.

These changes improve the AI comment review capabilities and enhance the configuration flexibility for UI components.

Signed-off-by: Innei <tukon479@gmail.com>

Author: Innei

apps/core/src/modules/ai/ai.controller.ts

@@ -4,6 +4,8 @@ import { Auth } from '~/common/decorators/auth.decorator'
 import { BizException } from '~/common/exceptions/biz.exception'
 import { ErrorCodeEnum } from '~/constants/error-code.constant'
 import { ConfigsService } from '../configs/configs.service'
+import { AI_PROMPTS } from './ai.prompts'
+import { AiService } from './ai.service'
 import { AIProviderType } from './ai.types'
 import type { IModelRuntime, ModelInfo } from './runtime'
 import { createModelRuntime, createRuntimeForModelList } from './runtime'
@@ -31,9 +33,17 @@ interface TestConnectionDto {
   model?: string
 }
 
+interface TestCommentReviewDto {
+  text: string
+  author?: string
+}
+
 @ApiController('ai')
 export class AiController {
-  constructor(private readonly configsService: ConfigsService) {}
+  constructor(
+    private readonly configsService: ConfigsService,
+    private readonly aiService: AiService,
+  ) {}
 
   @Get('/models')
   @Auth()
@@ -152,6 +162,79 @@ export class AiController {
     }
   }
 
+  @Post('/comment-review/test')
+  @Auth()
+  async testCommentReview(
+    @Body() body: TestCommentReviewDto,
+  ): Promise<{ isSpam: boolean; score?: number; reason?: string }> {
+    const { text } = body
+
+    if (!text?.trim()) {
+      throw new BizException(
+        ErrorCodeEnum.ContentNotFoundCantProcess,
+        'Comment text is required',
+      )
+    }
+
+    const commentConfig = await this.configsService.get('commentOptions')
+    if (!commentConfig.aiReview) {
+      throw new BizException(
+        ErrorCodeEnum.AINotEnabled,
+        'AI review is not enabled',
+      )
+    }
+
+    try {
+      const runtime = await this.aiService.getCommentReviewModel()
+
+      const reviewType = commentConfig.aiReviewType || 'binary'
+      const threshold = commentConfig.aiReviewThreshold || 5
+
+      if (reviewType === 'score') {
+        const promptConfig = AI_PROMPTS.comment.score(text)
+        const result = await runtime.generateStructured({
+          ...promptConfig,
+        })
+
+        const isSpam =
+          result.output.score >= threshold ||
+          result.output.hasSensitiveContent === true
+
+        return {
+          isSpam,
+          score: result.output.score,
+          reason: result.output.hasSensitiveContent
+            ? '包含敏感内容'
+            : isSpam
+              ? `评分 ${result.output.score} 超过阈值 ${threshold}`
+              : undefined,
+        }
+      } else {
+        const promptConfig = AI_PROMPTS.comment.spam(text)
+        const result = await runtime.generateStructured({
+          ...promptConfig,
+        })
+
+        const isSpam =
+          result.output.isSpam || result.output.hasSensitiveContent === true
+
+        return {
+          isSpam,
+          reason: result.output.hasSensitiveContent
+            ? '包含敏感内容'
+            : result.output.isSpam
+              ? '判定为垃圾评论'
+              : undefined,
+        }
+      }
+    } catch (error: any) {
+      throw new BizException(
+        ErrorCodeEnum.AIException,
+        error?.message || 'AI comment review test failed',
+      )
+    }
+  }
+
   private async resolveModelListConfig(body: FetchModelsDto) {
     const needsLookup =
       !!body.providerId && (!body.apiKey || !body.type || !body.endpoint)

apps/core/src/modules/configs/configs.dsl.util.ts

@@ -12,6 +12,7 @@ export type UIComponent =
   | 'switch'
   | 'select'
   | 'tags'
+  | 'action'
 
 export interface UIConfig {
   component: UIComponent
@@ -24,6 +25,18 @@ export interface UIConfig {
    * When the condition is not met, the field and all its nested children are hidden.
    */
   showWhen?: Record<string, string | string[]>
+  /**
+   * Action button configuration (only used when component is 'action')
+   */
+  actionId?: string
+  actionLabel?: string
+  actionVariant?:
+    | 'default'
+    | 'primary'
+    | 'info'
+    | 'success'
+    | 'warning'
+    | 'error'
 }
 
 export interface FormField {
@@ -164,6 +177,7 @@ function inferUIComponent(
   if (uiOptions?.type === 'password') return 'password'
   if (uiOptions?.type === 'textarea') return 'textarea'
   if (uiOptions?.type === 'select') return 'select'
+  if (uiOptions?.type === 'action') return 'action'
 
   const unwrapped = unwrapZodType(schema)
 
@@ -266,6 +280,18 @@ function extractField(key: string, schema: z.ZodTypeAny): FormField {
     }
   }
 
+  if (component === 'action') {
+    if (uiOptions?.actionId) {
+      field.ui.actionId = uiOptions.actionId
+    }
+    if (uiOptions?.actionLabel) {
+      field.ui.actionLabel = uiOptions.actionLabel
+    }
+    if (uiOptions?.actionVariant) {
+      field.ui.actionVariant = uiOptions.actionVariant
+    }
+  }
+
   const unwrapped = unwrapZodType(schema)
   if (unwrapped instanceof z.ZodObject && component !== 'select') {
     const nestedFields = extractFields(unwrapped)

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

@@ -104,6 +104,11 @@ export const CommentOptionsSchema = section('评论设置', {
     'AI 审核阈值',
     { description: '分数大于多少时会被归类为垃圾评论，范围为 1-10, 默认为 5' },
   ),
+  testAiReview: field.action('测试 AI 审核', 'test-ai-review', {
+    description: '输入测试内容，验证 AI 审核功能是否正常工作',
+    actionLabel: '测试',
+    showWhen: { aiReview: 'true' },
+  }),
   disableComment: field.toggle(z.boolean().optional(), '全站禁止评论', {
     description: '敏感时期专用',
   }),

apps/core/src/modules/configs/configs.zod-schema.util.ts

@@ -4,7 +4,7 @@ import { z } from 'zod'
  * UI Options for JSON Schema form rendering
  */
 export interface UIOptions {
-  type?: 'password' | 'textarea' | 'select' | 'hidden'
+  type?: 'password' | 'textarea' | 'select' | 'hidden' | 'action'
   halfGrid?: boolean
   hide?: boolean
   connect?: boolean
@@ -16,6 +16,18 @@ export interface UIOptions {
    * @example { provider: ['smtp', 'sendgrid'] } - show when provider equals any of these
    */
   showWhen?: Record<string, string | string[]>
+  /**
+   * Action button configuration (only used when type is 'action')
+   */
+  actionId?: string
+  actionLabel?: string
+  actionVariant?:
+    | 'default'
+    | 'primary'
+    | 'info'
+    | 'success'
+    | 'warning'
+    | 'error'
 }
 
 /**
@@ -148,6 +160,34 @@ export const field = {
       title,
       'ui:options': { type: 'hidden' },
     }),
+
+  action: (
+    title: string,
+    actionId: string,
+    options?: {
+      description?: string
+      actionLabel?: string
+      actionVariant?:
+        | 'default'
+        | 'primary'
+        | 'info'
+        | 'success'
+        | 'warning'
+        | 'error'
+      showWhen?: Record<string, string | string[]>
+    },
+  ) =>
+    withMeta(z.literal('__action__').optional(), {
+      title,
+      description: options?.description,
+      'ui:options': {
+        type: 'action',
+        actionId,
+        actionLabel: options?.actionLabel || title,
+        actionVariant: options?.actionVariant,
+        showWhen: options?.showWhen,
+      },
+    }),
 }
 
 /**