Refactor/migrate zod v4 (#10002)

* build: 更新 zod 依赖至 v4.1.5

* refactor: 将zod导入从'zod/v4'更新为'zod'

统一使用zod主包而非v4子路径，简化依赖管理

* refactor: 统一使用命名导入方式导入zod库

* refactor(mcpServers): 更新RequestPayloadSchema的url和headers类型定义

* refactor(mcp): 将默认值从pipe移动到string以简化schema

默认值'stdio'从pipe操作中移动到string操作，使schema定义更清晰

* refactor(Markdown): 简化 CitationSchema 中 url 的验证方式

* refactor: 将类型断言改为使用 satisfies 操作符

* build: 更新 aiCore 的 zod 依赖至 v4.1.5

* refactor: 更新zod导入方式并简化基础provider类型定义

将zod从'zod/v4'更新为'zod'导入
将baseProviderSchema替换为更简洁的接口类型定义

* fix(providers): 优化provider配置的schema定义并添加注释

调整creator函数的类型定义，增加输入输出类型约束

package.json

@@ -327,7 +327,7 @@
     "yjs": "^13.6.27",
     "youtubei.js": "^15.0.1",
     "zipread": "^1.3.3",
-    "zod": "^3.25.74"
+    "zod": "^4.1.5"
   },
   "resolutions": {
     "@codemirror/language": "6.11.3",

packages/aiCore/package.json

@@ -45,7 +45,7 @@
     "@ai-sdk/provider": "^2.0.0",
     "@ai-sdk/provider-utils": "^3.0.4",
     "@ai-sdk/xai": "^2.0.9",
-    "zod": "^3.25.0"
+    "zod": "^4.1.5"
   },
   "devDependencies": {
     "tsdown": "^0.12.9",

packages/aiCore/src/core/options/xai.ts

@@ -1,7 +1,7 @@
 // copy from @ai-sdk/xai/xai-chat-options.ts
 // 如果@ai-sdk/xai暴露出了xaiProviderOptions就删除这个文件
 
-import * as z from 'zod/v4'
+import { z } from 'zod'
 
 const webSourceSchema = z.object({
   type: z.literal('web'),

packages/aiCore/src/core/providers/schemas.ts

@@ -10,8 +10,8 @@ import { createGoogleGenerativeAI } from '@ai-sdk/google'
 import { createOpenAI, type OpenAIProviderSettings } from '@ai-sdk/openai'
 import { createOpenAICompatible } from '@ai-sdk/openai-compatible'
 import { createXai } from '@ai-sdk/xai'
-import { customProvider, type Provider } from 'ai'
+import { customProvider, Provider } from 'ai'
-import * as z from 'zod'
+import { z } from 'zod'
 
 /**
  * 基础 Provider IDs
@@ -38,14 +38,12 @@ export const baseProviderIdSchema = z.enum(baseProviderIds)
  */
 export type BaseProviderId = z.infer<typeof baseProviderIdSchema>
 
-export const baseProviderSchema = z.object({
+type BaseProvider = {
-  id: baseProviderIdSchema,
+  id: BaseProviderId
-  name: z.string(),
+  name: string
-  creator: z.function().args(z.any()).returns(z.any()) as z.ZodType<(options: any) => Provider>,
+  creator: (options: any) => Provider
-  supportsImageGeneration: z.boolean()
+  supportsImageGeneration: boolean
-})
+}
-
-export type BaseProvider = z.infer<typeof baseProviderSchema>
 
 /**
  * 基础 Providers 定义
@@ -148,7 +146,12 @@ export const providerConfigSchema = z
   .object({
     id: customProviderIdSchema, // 只允许自定义ID
     name: z.string().min(1),
-    creator: z.function().optional(),
+    creator: z
+      .function({
+        input: z.any(),
+        output: z.any()
+      })
+      .optional(),
     import: z.function().optional(),
     creatorFunctionName: z.string().optional(),
     supportsImageGeneration: z.boolean().default(false),

src/main/knowledge/langchain/embeddings/JinaEmbeddings.ts

@@ -1,7 +1,7 @@
 import { Embeddings, type EmbeddingsParams } from '@langchain/core/embeddings'
 import { chunkArray } from '@langchain/core/utils/chunk_array'
 import { getEnvironmentVariable } from '@langchain/core/utils/env'
-import z from 'zod/v4'
+import { z } from 'zod'
 
 const jinaModelSchema = z.union([
   z.literal('jina-clip-v2'),

src/main/mcpServers/dify-knowledge.ts

@@ -3,7 +3,7 @@ import { loggerService } from '@logger'
 import { Server } from '@modelcontextprotocol/sdk/server/index.js'
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js'
 import { net } from 'electron'
-import * as z from 'zod/v4'
+import { z } from 'zod'
 
 const logger = loggerService.withContext('DifyKnowledgeServer')
 

src/main/mcpServers/fetch.ts

@@ -8,8 +8,8 @@ import TurndownService from 'turndown'
 import { z } from 'zod'
 
 export const RequestPayloadSchema = z.object({
-  url: z.string().url(),
+  url: z.url(),
-  headers: z.record(z.string()).optional()
+  headers: z.record(z.string(), z.string()).optional()
 })
 
 export type RequestPayload = z.infer<typeof RequestPayloadSchema>

src/main/mcpServers/filesystem.ts

@@ -8,7 +8,7 @@ import fs from 'fs/promises'
 import { minimatch } from 'minimatch'
 import os from 'os'
 import path from 'path'
-import * as z from 'zod/v4'
+import { z } from 'zod'
 
 const logger = loggerService.withContext('MCP:FileSystemServer')
 

src/main/services/knowledge/LangChainFramework.ts

@@ -30,7 +30,7 @@ import {
   KnowledgeBaseParams,
   KnowledgeSearchResult
 } from '@types'
-import { uuidv4 } from 'zod/v4'
+import { uuidv4 } from 'zod'
 
 import { windowService } from '../WindowService'
 import {

src/renderer/src/aiCore/tools/MemorySearchTool.ts

@@ -82,7 +82,7 @@ export const memorySearchToolWithExtraction = (assistant: Assistant) => {
           role: z.enum(['user', 'assistant', 'system']).describe('Message role')
         })
         .optional()
-    }) as z.ZodSchema<MemorySearchWithExtractionInput>,
+    }) satisfies z.ZodSchema<MemorySearchWithExtractionInput>,
     execute: async ({ userMessage }) => {
       // console.log('🧠 [memorySearchToolWithExtraction] Processing:', { userMessage, lastAnswer })
 

src/renderer/src/pages/home/Markdown/CitationTooltip.tsx

@@ -5,7 +5,7 @@ import styled from 'styled-components'
 import { z } from 'zod'
 
 export const CitationSchema = z.object({
-  url: z.string().url(),
+  url: z.url(),
   title: z.string().optional(),
   content: z.string().optional()
 })

src/renderer/src/types/index.ts

@@ -2,7 +2,7 @@ import type { WebSearchResultBlock } from '@anthropic-ai/sdk/resources'
 import type { GenerateImagesConfig, GroundingMetadata, PersonGeneration } from '@google/genai'
 import type OpenAI from 'openai'
 import type { CSSProperties } from 'react'
-import * as z from 'zod/v4'
+import { z } from 'zod'
 
 export * from './file'
 export * from './note'

src/renderer/src/types/mcp.ts

@@ -1,4 +1,4 @@
-import z from 'zod'
+import { z } from 'zod'
 
 import { isBuiltinMCPServerName } from '.'
 
@@ -17,6 +17,7 @@ export type MCPConfigSample = z.infer<typeof MCPConfigSampleSchema>
  */
 export const McpServerTypeSchema = z
   .string()
+  .default('stdio')
   .transform((type) => {
     if (type.includes('http')) {
       return 'streamableHttp'
@@ -24,9 +25,7 @@ export const McpServerTypeSchema = z
       return type
     }
   })
-  .pipe(
+  .pipe(z.union([z.literal('stdio'), z.literal('sse'), z.literal('streamableHttp'), z.literal('inMemory')])) // 大多数情况下默认使用 stdio
-    z.union([z.literal('stdio'), z.literal('sse'), z.literal('streamableHttp'), z.literal('inMemory')]).default('stdio') // 大多数情况下默认使用 stdio
-  )
 
 /**
  * 定义单个 MCP 服务器的配置。

src/renderer/src/types/tool.ts

@@ -1,4 +1,4 @@
-import * as z from 'zod/v4'
+import { z } from 'zod'
 
 export type ToolType = 'builtin' | 'provider' | 'mcp'
 

src/renderer/src/utils/error.ts

@@ -8,7 +8,7 @@ import {
 } from '@renderer/types/error'
 import { InvalidToolInputError, NoSuchToolError } from 'ai'
 import { t } from 'i18next'
-import z from 'zod'
+import { z } from 'zod'
 
 import { safeSerialize } from './serialize'
 

yarn.lock

@@ -2258,7 +2258,7 @@ __metadata:
     tsdown: "npm:^0.12.9"
     typescript: "npm:^5.0.0"
     vitest: "npm:^3.2.4"
-    zod: "npm:^3.25.0"
+    zod: "npm:^4.1.5"
   peerDependencies:
     ai: ^5.0.26
   languageName: unknown
@@ -10131,7 +10131,7 @@ __metadata:
     yjs: "npm:^13.6.27"
     youtubei.js: "npm:^15.0.1"
     zipread: "npm:^1.3.3"
-    zod: "npm:^3.25.74"
+    zod: "npm:^4.1.5"
   languageName: unknown
   linkType: soft
 
@@ -25631,17 +25631,17 @@ __metadata:
   languageName: node
   linkType: hard
 
-"zod@npm:^3.25.0, zod@npm:^3.25.32":
+"zod@npm:^3.25.32":
   version: 3.25.76
   resolution: "zod@npm:3.25.76"
   checksum: 10c0/5718ec35e3c40b600316c5b4c5e4976f7fee68151bc8f8d90ec18a469be9571f072e1bbaace10f1e85cf8892ea12d90821b200e980ab46916a6166a4260a983c
   languageName: node
   linkType: hard
 
-"zod@npm:^3.25.74":
+"zod@npm:^4.1.5":
-  version: 3.25.74
+  version: 4.1.5
-  resolution: "zod@npm:3.25.74"
+  resolution: "zod@npm:4.1.5"
-  checksum: 10c0/59e38b046ac333b5bd1ba325a83b6798721227cbfb1e69dfc7159bd7824b904241ab923026edb714fafefec3624265ae374a70aee9a5a45b365bd31781ffa105
+  checksum: 10c0/7826fb931bc71d4d0fff2fbb72f1a1cf30a6672cf9dbe6933a216bbb60242ef1c3bdfbcd3c5b27e806235a35efaad7a4a9897ff4d3621452f9ea278bce6fd42a
   languageName: node
   linkType: hard