+
+
@@ -39,7 +53,9 @@ import { TimeDelay } from '@/define/Tools/time'
import { useMessage } from 'naive-ui'
import CopyWritingContent from '@/renderer/src/components/CopyWriting/CopyWritingContent.vue'
import CopyWritingCategoryMenu from '@/renderer/src/components/CopyWriting/CopyWritingCategoryMenu.vue'
+import AIChatInterface from '@/renderer/src/components/CopyWriting/AIChatInterface.vue'
import LoadingComponent from '@/renderer/src/components/common/LoadingComponent.vue'
+import { NDivider } from 'naive-ui'
import { OptionKeyName, OptionType } from '@/define/enum/option'
import { define } from '@/define/define'
import { useMD } from '../hooks/useMD'
@@ -61,6 +77,23 @@ const simpleSetting = ref({})
// 数据加载状态
const dataLoaded = ref(false)
+// 当前模式: 'batch' 批量文案处理, 'chat' AI对话
+const currentMode = ref('batch')
+
+// 当前选中的分类(用于AI对话)
+const selectedCategory = ref(null)
+
+// AI聊天组件的引用
+const aiChatRef = ref(null)
+
+// AI聊天消息列表
+const chatMessages = ref([])
+
+// 保存节流控制
+let saveTimer = null
+let lastSaveTime = 0
+const SAVE_INTERVAL = 2000 // 2秒内最多保存一次
+
onMounted(async () => {
try {
// 不再使用全局 spin，使用组件内的加载状态
@@ -72,6 +105,9 @@ onMounted(async () => {
// 初始化界面数据
await InitCopyWritingData()
+ // 加载保存的模式设置
+ await LoadCurrentMode()
+
// 加载提示词数据
await InitServerGptOptions()
@@ -119,6 +155,88 @@ let UpdateWord = debounce((value) => {
// newWord.value += value
}, 300)
+// 保存聊天记录到数据库
+async function handleSaveChatHistory() {
+ try {
+ if (!selectedCategory.value?.id) return
+
+ const now = Date.now()
+
+ // 节流控制
+ if (now - lastSaveTime < SAVE_INTERVAL) {
+ // 清除之前的延迟保存
+ if (saveTimer) {
+ clearTimeout(saveTimer)
+ }
+ // 延迟保存
+ saveTimer = setTimeout(
+ () => {
+ handleSaveChatHistory()
+ },
+ SAVE_INTERVAL - (now - lastSaveTime)
+ )
+ return
+ }
+
+ lastSaveTime = now
+ if (saveTimer) {
+ clearTimeout(saveTimer)
+ saveTimer = null
+ }
+
+ const chatData = {
+ categoryId: selectedCategory.value.id,
+ messages: chatMessages.value.map((msg) => ({
+ role: msg.role,
+ content: msg.content,
+ timestamp: msg.timestamp
+ }))
+ }
+
+ const key = `InferenceAI_CW_ChatHistory_${selectedCategory.value.id}`
+ console.log('保存聊天记录, key:', key, '消息数:', chatData.messages.length)
+
+ const result = await window.option.ModifyOptionByKey(
+ key,
+ JSON.stringify(chatData),
+ OptionType.JSON
+ )
+ console.log('保存聊天记录结果:', result)
+ } catch (error) {
+ console.error('保存聊天记录失败:', error)
+ }
+}
+
+// 加载聊天记录
+async function handleLoadChatHistory() {
+ try {
+ if (!selectedCategory.value?.id) {
+ chatMessages.value = []
+ return
+ }
+
+ const key = `InferenceAI_CW_ChatHistory_${selectedCategory.value.id}`
+
+ const res = await window.option.GetOptionByKey(key)
+
+ if (res.code === 1 && res.data) {
+ const chatData = optionSerialization(res.data)
+
+ if (chatData.messages && Array.isArray(chatData.messages)) {
+ chatMessages.value = chatData.messages
+ console.log('成功加载消息:', chatData.messages.length, '条')
+ } else {
+ chatMessages.value = []
+ }
+ } else {
+ chatMessages.value = []
+ }
+ } catch (error) {
+ console.error('加载聊天记录失败:', error)
+ chatMessages.value = []
+ }
+}
+
// 处理分类选择事件
async function handleCategorySelect(selection) {
console.log('Received category selection:', selection)
@@ -128,6 +246,9 @@ async function handleCategorySelect(selection) {
return
}
+ // 更新选中的分类(用于AI对话模式)
+ selectedCategory.value = selection
+
// 检查数据结构
let mainCategoryId, subCategoryId
@@ -149,6 +270,37 @@ async function handleCategorySelect(selection) {
})
}
+// 处理模式切换
+async function handleToggleMode() {
+ try {
+ const newMode = currentMode.value === 'batch' ? 'chat' : 'batch'
+ currentMode.value = newMode
+
+ // 保存模式到数据库
+ const saveRes = await window.option.ModifyOptionByKey(
+ OptionKeyName.InferenceAI.CW_CurrentMode,
+ currentMode.value,
+ OptionType.STRING
+ )
+
+ if (saveRes.code !== 1) {
+ throw new Error(saveRes.message)
+ }
+
+ message.info(
+ t('已切换到{mode}模式', {
+ mode: currentMode.value === 'batch' ? t('批量文案处理') : t('AI对话')
+ })
+ )
+ } catch (error) {
+ message.error(
+ t('切换模式失败，{error}', {
+ error: error.message
+ })
+ )
+ }
+}
+
// async function handleContentSaveCWSimpleSetting(selection = {}) {
// let res = await handleSaveCWSimpleSetting(selection)
// if(res) {
@@ -219,7 +371,7 @@ async function InitServerGptOptions() {
throw new Error(promptRes.error || promptRes.data.message)
}
pc = [...promptRes.data.data]
-
+
// 获取提示词数据
let prompt = await axios.get(define.lms_url + '/lms/Prompt/GetPromptOptions/all')
@@ -239,8 +391,9 @@ async function InitServerGptOptions() {
}
promptCategory.value = pc
- console.log('Loaded prompt categories:', pc)
- console.log('Current simpleSetting:', simpleSetting.value)
+
+ // 初始化选中的分类(用于AI对话模式)
+ await InitSelectedCategory()
} catch (error) {
showErrorDialog(
t('数据加载失败'),
@@ -251,6 +404,70 @@ async function InitServerGptOptions() {
}
}
+/**
+ * 根据保存的设置初始化选中的分类
+ */
+async function InitSelectedCategory() {
+ try {
+ const gptType = simpleSetting.value.gptType
+ const gptData = simpleSetting.value.gptData
+
+ if (!isEmpty(gptType) && !isEmpty(gptData) && promptCategory.value.length > 0) {
+ // 查找对应的主分类
+ const mainCategory = promptCategory.value.find((cat) => cat.id === gptType)
+
+ if (mainCategory && mainCategory.children) {
+ // 查找对应的子分类
+ const subCategory = mainCategory.children.find((sub) => sub.id === gptData)
+
+ if (subCategory) {
+ selectedCategory.value = subCategory
+ } else {
+ console.warn('未找到匹配的子分类:', gptData)
+ }
+ } else {
+ console.warn('未找到匹配的主分类或主分类无子项:', gptType)
+ }
+ } else {
+ console.log('没有保存的分类数据,跳过初始化')
+ }
+ } catch (error) {
+ console.error('初始化选中分类失败:', error)
+ }
+}
+
+/**
+ * 加载当前模式设置
+ */
+async function LoadCurrentMode() {
+ try {
+ const modeRes = await window.option.GetOptionByKey(OptionKeyName.InferenceAI.CW_CurrentMode)
+
+ if (modeRes.code === 1 && modeRes.data) {
+ const savedMode = optionSerialization(modeRes.data, '', 'chat')
+ // 验证模式值是否有效
+ if (savedMode === 'batch' || savedMode === 'chat') {
+ currentMode.value = savedMode
+ console.log('已加载保存的模式:', savedMode)
+ } else {
+ console.warn('无效的模式值，使用默认值 batch')
+ currentMode.value = 'batch'
+ }
+ } else {
+ // 没有保存的模式，使用默认值并保存
+ currentMode.value = 'batch'
+ await window.option.ModifyOptionByKey(
+ OptionKeyName.InferenceAI.CW_CurrentMode,
+ 'batch',
+ OptionType.STRING
+ )
+ }
+ } catch (error) {
+ console.error('加载模式设置失败:', error)
+ currentMode.value = 'batch' // 出错时使用默认值
+ }
+}
+
/**
* 初始化文案处理AI设置
*/
diff --git a/src/renderer/src/views/MediaToVideoHome.vue b/src/renderer/src/views/MediaToVideoHome.vue
index 2b80120..df49e3a 100644
--- a/src/renderer/src/views/MediaToVideoHome.vue
+++ b/src/renderer/src/views/MediaToVideoHome.vue
@@ -54,7 +54,7 @@
import { ref, computed, onMounted } from 'vue'
import { useBookStore, useSoftwareStore } from '@/renderer/src/stores'
import { useMessage, useDialog } from 'naive-ui'
-import { BookType, GetBookTaskDetailStatusLabel } from '@/define/enum/bookEnum'
+import { BookType } from '@/define/enum/bookEnum'
import { TimeDelay } from '@/define/Tools/time'
import { h } from 'vue'
@@ -64,13 +64,14 @@ import TaskList from '@/renderer/src/components/Original/MainHome/OriginalTaskLi
import EmptyState from '@/renderer/src/components/Original/MainHome/OriginalEmptyState.vue'
import AddBook from '@/renderer/src/components/Original/MainHome/OriginalAddBook.vue'
import AddBookTask from '@/renderer/src/components/Original/MainHome/OriginalAddBookTask.vue'
-import { getImageCategoryOptions } from '@/define/data/imageData'
+import { useBook } from '@/renderer/src/hooks/useBook'
import { t } from '@/i18n'
const bookStore = useBookStore()
const softwareStore = useSoftwareStore()
const message = useMessage()
const dialog = useDialog()
+const { loadVideoBookInfo, loadProjectProgressData } = useBook()
// 响应式数据
const bookData = ref([])
@@ -92,64 +93,15 @@ onMounted(async () => {
await loadBookInfo(true) // 初始加载
})
-// 加载所有的小说数据
+// 加载所有的小说数据(包含分镜信息)
async function loadBookInfo(isInitialLoad = false) {
- try {
- if (isInitialLoad) {
- // 初始加载使用组件级别的loading
- comLoading.value = true
- } else {
- // 方法调用使用全局loading
- softwareStore.spin.spinning = true
- softwareStore.spin.tip = t('正在加载任务数据...')
- }
-
- const imageCategoryOptions = getImageCategoryOptions()
-
- // 加载小说数据 和 小说批次数据
- let res = await window.book.video.GetVideoBookInfoList({})
- if (res.code != 1) {
- message.error(res.message)
- return
- }
-
- bookData.value = res.data
-
- console.log('获取可以小说数据', res)
-
- // 加载每个批次数据的 tag
-
- for (let i = 0; i < bookData.value.length; i++) {
- // 处理每一个 bookTasks ，添加一个 tags 属性
- bookData.value[i].children.forEach((task) => {
- let tempArray = []
- // 出图方式
- let imageCategory = imageCategoryOptions.find((item) => item.value === task.imageCategory)
- tempArray.push(imageCategory.label)
-
- // 状态
- let statusObj = GetBookTaskDetailStatusLabel(task.status)
- tempArray.push(statusObj.label)
- task.tags = tempArray
- })
-
- loadProjectProgressData(bookData.value[i])
- }
- } catch (error) {
- message.error(
- t('加载数据失败，{error}', {
- error: error.message
- })
- )
- } finally {
- if (isInitialLoad) {
- // 初始加载结束，显示内容
- comLoading.value = false
- } else {
- // 方法调用结束，隐藏全局loading
- softwareStore.spin.spinning = false
- }
- }
+ const data = await loadVideoBookInfo({
+ isInitialLoad,
+ comLoading: comLoading,
+ loadingTip: t('正在加载任务数据...'),
+ processProgressData: loadProjectProgressData
+ })
+ bookData.value = data
}
// 搜索小说
@@ -246,100 +198,6 @@ async function handleSelectProject(projectId) {
await loadProjectProgressData(project)
}
-/**
- * 加载项目进度和首图信息
- * @description 获取指定项目的图片生成进度和首图路径信息，并更新到项目数据中
- * @param {Object} project 项目对象，包含子任务列表
- */
-async function loadProjectProgressData(project) {
- try {
- // 获取进度信息
- const progressResult = await getProjectProgress(project.id)
- if (!progressResult) return
-
- // 获取首图信息
- const firstImageResult = await getProjectFirstImages(project.id)
- if (!firstImageResult) return
-
- // 更新项目数据
- updateProjectData(project, progressResult, firstImageResult)
-
- // 更新store中的选中项目
- bookStore.selectBook = { ...project }
- } catch (error) {
- message.error(
- t('加载数据失败，{error}', {
- error: error.message
- })
- )
- }
-}
-
-/**
- * 获取项目进度信息
- * @description 调用API获取项目中所有任务的图片和视频生成进度
- * @param {string} projectId 项目ID
- * @returns {Object|null} 进度数据对象，失败时返回null
- */
-async function getProjectProgress(projectId) {
- const res = await window.book.GetBookTaskImageGenerateProgress(projectId)
- console.log('获取小说任务生成进度', res)
-
- if (res.code != 1) {
- message.error(res.message)
- return null
- }
-
- return res.data
-}
-
-/**
- * 获取项目首图信息
- * @description 调用API获取项目中所有任务的首图路径
- * @param {string} projectId 项目ID
- * @returns {Object|null} 首图路径数据对象，失败时返回null
- */
-async function getProjectFirstImages(projectId) {
- const res = await window.book.GetBookTaskFirstImagePath(projectId)
-
- if (res.code != 1) {
- message.error(res.message)
- return null
- }
-
- console.log('首图路径', res.data)
- return res.data
-}
-
-/**
- * 更新项目数据
- * @description 将获取到的进度和首图信息更新到项目的子任务中
- * @param {Object} project 项目对象
- * @param {Object} progressData 进度数据
- * @param {Object} firstImageData 首图数据
- */
-function updateProjectData(project, progressData, firstImageData) {
- // 遍历项目的子任务，更新进度和首图信息
- for (let i = 0; i < project.children.length; i++) {
- const element = project.children[i]
-
- // 设置图片和视频生成进度
- element.imageVideoProgress = progressData[element.id] || {
- imageProgress: 0,
- videoProgress: 0,
- totalCount: 0,
- imageRate: 0,
- videoRate: 0
- }
-
- // 设置首图路径，添加时间戳避免缓存问题
- element.firstImagePath =
- firstImageData[element.id] == undefined
- ? undefined
- : firstImageData[element.id] + '?t=' + new Date().getTime()
- }
-}
-
// 移动端侧边栏控制
function closeMobileSidebar() {
diff --git a/src/renderer/src/views/OriginalHome.vue b/src/renderer/src/views/OriginalHome.vue
index 2f68baf..09a1ab1 100644
--- a/src/renderer/src/views/OriginalHome.vue
+++ b/src/renderer/src/views/OriginalHome.vue
@@ -52,7 +52,7 @@
import { ref, computed, onMounted } from 'vue'
import { useBookStore, useSoftwareStore } from '@/renderer/src/stores'
import { useMessage, useDialog } from 'naive-ui'
-import { BookType, GetBookTaskDetailStatusLabel } from '@/define/enum/bookEnum'
+import { BookType } from '@/define/enum/bookEnum'
import { TimeDelay } from '@/define/Tools/time'
import { h } from 'vue'
@@ -62,13 +62,14 @@ import TaskList from '@/renderer/src/components/Original/MainHome/OriginalTaskLi
import EmptyState from '@/renderer/src/components/Original/MainHome/OriginalEmptyState.vue'
import AddBook from '@/renderer/src/components/Original/MainHome/OriginalAddBook.vue'
import AddBookTask from '@/renderer/src/components/Original/MainHome/OriginalAddBookTask.vue'
-import { getImageCategoryOptions } from '@/define/data/imageData'
+import { useBook } from '@/renderer/src/hooks/useBook'
import { t } from '@/i18n'
const bookStore = useBookStore()
const softwareStore = useSoftwareStore()
const message = useMessage()
const dialog = useDialog()
+const { loadBookInfo: loadBookInfoFromHook, loadProjectProgressData } = useBook()
// 响应式数据
const bookData = ref([])
@@ -92,67 +93,13 @@ onMounted(async () => {
// 加载所有的小说数据
async function loadBookInfo(isInitialLoad = false) {
- try {
- if (isInitialLoad) {
- // 初始加载使用组件级别的loading
- comLoading.value = true
- } else {
- // 方法调用使用全局loading
- softwareStore.spin.spinning = true
- softwareStore.spin.tip = t('加载小说信息中...')
- }
-
- const imageCategoryOptions = getImageCategoryOptions()
- let res = await window.book.GetBookDataCondition({ ...bookStore.queryBookCondition })
- if (res.code != 1) {
- message.error(res.message)
- return
- }
- console.log('小说信息', res.data)
- bookData.value = res.data.resultBooks
-
- // 加载每个的子项目
- for (let i = 0; i < bookData.value.length; i++) {
- const element = bookData.value[i]
- let bookTaskRes = await window.book.GetBookTaskDataByCondition({
- bookId: element.id
- })
- if (bookTaskRes.code != 1) {
- message.error(bookTaskRes.message)
- return
- }
-
- // 处理每一个 bookTasks ，添加一个 tags 属性
- bookTaskRes.data.bookTasks.forEach((task) => {
- let tempArray = []
- // 出图方式
- let imageCategory = imageCategoryOptions.find((item) => item.value === task.imageCategory)
- tempArray.push(imageCategory.label)
-
- // 状态
- let statusObj = GetBookTaskDetailStatusLabel(task.status)
- tempArray.push(statusObj.label)
- task.tags = tempArray
- })
-
- bookData.value[i].children = bookTaskRes.data.bookTasks
- loadProjectProgressData(bookData.value[i])
- }
- } catch (error) {
- message.error(
- t('加载小说信息失败，{error}', {
- error: error.message
- })
- )
- } finally {
- if (isInitialLoad) {
- // 初始加载结束，显示内容
- comLoading.value = false
- } else {
- // 方法调用结束，隐藏全局loading
- softwareStore.spin.spinning = false
- }
- }
+ const data = await loadBookInfoFromHook({
+ isInitialLoad,
+ comLoading: comLoading,
+ loadingTip: t('加载小说信息中...'),
+ processProgressData: loadProjectProgressData
+ })
+ bookData.value = data
}
// 搜索小说
@@ -253,100 +200,6 @@ async function handleSelectProject(projectId) {
await loadProjectProgressData(project)
}
-/**
- * 加载项目进度和首图信息
- * @description 获取指定项目的图片生成进度和首图路径信息，并更新到项目数据中
- * @param {Object} project 项目对象，包含子任务列表
- */
-async function loadProjectProgressData(project) {
- try {
- // 获取进度信息
- const progressResult = await getProjectProgress(project.id)
- if (!progressResult) return
-
- // 获取首图信息
- const firstImageResult = await getProjectFirstImages(project.id)
- if (!firstImageResult) return
-
- // 更新项目数据
- updateProjectData(project, progressResult, firstImageResult)
-
- // 更新store中的选中项目
- bookStore.selectBook = { ...project }
- } catch (error) {
- message.error(
- t('加载小说信息失败，{error}', {
- error: error.message
- })
- )
- }
-}
-
-/**
- * 获取项目进度信息
- * @description 调用API获取项目中所有任务的图片和视频生成进度
- * @param {string} projectId 项目ID
- * @returns {Object|null} 进度数据对象，失败时返回null
- */
-async function getProjectProgress(projectId) {
- const res = await window.book.GetBookTaskImageGenerateProgress(projectId)
- console.log('获取小说任务生成进度', res)
-
- if (res.code != 1) {
- message.error(res.message)
- return null
- }
-
- return res.data
-}
-
-/**
- * 获取项目首图信息
- * @description 调用API获取项目中所有任务的首图路径
- * @param {string} projectId 项目ID
- * @returns {Object|null} 首图路径数据对象，失败时返回null
- */
-async function getProjectFirstImages(projectId) {
- const res = await window.book.GetBookTaskFirstImagePath(projectId)
-
- if (res.code != 1) {
- message.error(res.message)
- return null
- }
-
- console.log('首图路径', res.data)
- return res.data
-}
-
-/**
- * 更新项目数据
- * @description 将获取到的进度和首图信息更新到项目的子任务中
- * @param {Object} project 项目对象
- * @param {Object} progressData 进度数据
- * @param {Object} firstImageData 首图数据
- */
-function updateProjectData(project, progressData, firstImageData) {
- // 遍历项目的子任务，更新进度和首图信息
- for (let i = 0; i < project.children.length; i++) {
- const element = project.children[i]
-
- // 设置图片和视频生成进度
- element.imageVideoProgress = progressData[element.id] || {
- imageProgress: 0,
- videoProgress: 0,
- totalCount: 0,
- imageRate: 0,
- videoRate: 0
- }
-
- // 设置首图路径，添加时间戳避免缓存问题
- element.firstImagePath =
- firstImageData[element.id] == undefined
- ? undefined
- : firstImageData[element.id] + '?t=' + new Date().getTime()
- }
-}
-
// 移动端侧边栏控制
function closeMobileSidebar() {
diff --git a/src/utils/httpErrorHandler.README.md b/src/utils/httpErrorHandler.README.md
new file mode 100644
index 0000000..18dfac9
--- /dev/null
+++ b/src/utils/httpErrorHandler.README.md
@@ -0,0 +1,303 @@
+# HTTP 错误处理工具使用指南
+
+## 概述
+
+`httpErrorHandler.js` 提供了统一的 HTTP 错误处理功能,支持 fetch 和 axios,可在主线程和渲染线程使用。
+
+## 功能特性
+
+- ✅ 支持 Fetch API
+- ✅ 支持 Axios
+- ✅ 自动识别错误类型
+- ✅ 提取服务器错误消息
+- ✅ 友好的中文错误提示
+- ✅ 支持主线程和渲染线程
+- ✅ 完整的错误信息日志
+
+## 使用方法
+
+### 1. Fetch API 使用
+
+#### 方式一：使用包装器（推荐）
+
+```javascript
+import { fetchWithErrorHandling } from '@/utils/httpErrorHandler'
+
+try {
+ const response = await fetchWithErrorHandling('https://api.example.com/data', {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ key: 'value' })
+ })
+
+ const data = await response.json()
+ console.log(data)
+} catch (error) {
+ console.error(error.message) // 友好的错误提示
+ console.log(error.status) // HTTP 状态码
+ console.log(error.data) // 服务器返回的原始数据
+}
+```
+
+#### 方式二：手动处理
+
+```javascript
+import { handleFetchError } from '@/utils/httpErrorHandler'
+
+const response = await fetch('https://api.example.com/data')
+
+if (!response.ok) {
+ const error = await handleFetchError(response)
+ throw error
+}
+
+const data = await response.json()
+```
+
+### 2. Axios 使用
+
+#### 方式一：错误拦截器（推荐）
+
+```javascript
+import axios from 'axios'
+import { createAxiosErrorInterceptor } from '@/utils/httpErrorHandler'
+
+// 创建 axios 实例
+const api = axios.create({
+ baseURL: 'https://api.example.com'
+})
+
+// 添加错误拦截器
+api.interceptors.response.use(
+ response => response,
+ createAxiosErrorInterceptor()
+)
+
+// 使用
+try {
+ const response = await api.post('/data', { key: 'value' })
+ console.log(response.data)
+} catch (error) {
+ console.error(error.message) // 友好的错误提示
+ console.log(error.status) // HTTP 状态码
+ console.log(error.data) // 服务器返回的原始数据
+}
+```
+
+#### 方式二：手动处理
+
+```javascript
+import axios from 'axios'
+import { handleAxiosError } from '@/utils/httpErrorHandler'
+
+try {
+ const response = await axios.post('https://api.example.com/data', {
+ key: 'value'
+ })
+ console.log(response.data)
+} catch (axiosError) {
+ const error = handleAxiosError(axiosError)
+ console.error(error.message)
+ throw error
+}
+```
+
+### 3. 通用处理（自动识别）
+
+```javascript
+import { handleRequestError } from '@/utils/httpErrorHandler'
+
+try {
+ // fetch 或 axios 请求
+ const response = await fetch(url)
+
+ if (!response.ok) {
+ const error = await handleRequestError(response)
+ throw error
+ }
+} catch (error) {
+ // 如果是 axios 错误
+ const friendlyError = await handleRequestError(error)
+ console.error(friendlyError.message)
+}
+```
+
+## 错误类型
+
+```javascript
+import { ErrorType, isErrorType } from '@/utils/httpErrorHandler'
+
+try {
+ // 请求代码
+} catch (error) {
+ if (isErrorType(error, ErrorType.NETWORK_ERROR)) {
+ console.log('网络错误')
+ } else if (isErrorType(error, ErrorType.TIMEOUT)) {
+ console.log('请求超时')
+ } else if (isErrorType(error, ErrorType.HTTP_ERROR)) {
+ console.log('HTTP错误:', error.status)
+ }
+}
+```
+
+### 支持的错误类型
+
+- `HTTP_ERROR` - HTTP 状态码错误（400-599）
+- `NETWORK_ERROR` - 网络连接错误
+- `TIMEOUT` - 请求超时
+- `ABORTED` - 请求被取消
+- `UNKNOWN_ERROR` - 未知错误
+
+## HTTP 状态码处理
+
+| 状态码 | 错误提示 |
+|--------|----------|
+| 400 | 请求参数错误，请检查配置是否正确 |
+| 401 | API密钥无效或已过期，请检查配置 |
+| 403 | 没有访问权限，请检查API密钥是否有效 |
+| 404 | API地址不存在，请检查配置的URL是否正确 |
+| 429 | 请求过于频繁，请稍后再试 |
+| 500 | 服务器内部错误，请稍后重试 |
+| 502 | 网关错误，服务暂时不可用，请稍后重试 |
+| 503 | 服务暂时不可用，请稍后重试 |
+| 504 | 请求超时，请检查网络连接或稍后重试 |
+
+## 错误对象属性
+
+```javascript
+error = {
+ message: '友好的错误提示', // 用户可读的错误消息
+ type: 'HTTP_ERROR', // 错误类型
+ status: 400, // HTTP 状态码（HTTP错误时）
+ statusText: 'Bad Request', // HTTP 状态文本
+ data: {...}, // 服务器返回的原始数据
+ originalError: Error // 原始错误对象（如果有）
+}
+```
+
+## 在主线程使用
+
+```javascript
+// main/index.js 或其他主线程文件
+import { handleFetchError, fetchWithErrorHandling } from '../utils/httpErrorHandler'
+
+async function fetchData() {
+ try {
+ const response = await fetchWithErrorHandling('https://api.example.com/data')
+ const data = await response.json()
+ return data
+ } catch (error) {
+ console.error('主线程请求失败:', error.message)
+ throw error
+ }
+}
+```
+
+## 完整示例
+
+### 示例 1：AI 接口调用
+
+```javascript
+import { handleFetchError } from '@/utils/httpErrorHandler'
+
+async function callAI(prompt) {
+ try {
+ const response = await fetch('https://api.openai.com/v1/chat/completions', {
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/json',
+ 'Authorization': `Bearer ${apiKey}`
+ },
+ body: JSON.stringify({
+ model: 'gpt-3.5-turbo',
+ messages: [{ role: 'user', content: prompt }]
+ })
+ })
+
+ if (!response.ok) {
+ const error = await handleFetchError(response)
+ throw error
+ }
+
+ return await response.json()
+ } catch (error) {
+ if (error.status === 401) {
+ console.log('需要重新登录')
+ } else if (error.status === 429) {
+ console.log('请求过于频繁，等待后重试')
+ }
+
+ throw error
+ }
+}
+```
+
+### 示例 2：Axios 全局配置
+
+```javascript
+// src/api/request.js
+import axios from 'axios'
+import { createAxiosErrorInterceptor } from '@/utils/httpErrorHandler'
+import { useMessage } from 'naive-ui'
+
+const message = useMessage()
+
+const api = axios.create({
+ baseURL: import.meta.env.VITE_API_BASE_URL,
+ timeout: 30000
+})
+
+// 响应拦截器
+api.interceptors.response.use(
+ response => response,
+ createAxiosErrorInterceptor()
+)
+
+// 在组件中使用
+export async function fetchUserData() {
+ try {
+ const response = await api.get('/user/profile')
+ return response.data
+ } catch (error) {
+ message.error(error.message) // 显示友好的错误提示
+ throw error
+ }
+}
+```
+
+## 服务器错误消息提取
+
+工具会自动尝试从以下字段提取服务器错误消息：
+
+- `error.message`
+- `message`
+- `msg`
+- `error`
+- `rawError`（当响应不是JSON格式时）
+
+服务器返回示例：
+
+```json
+{
+ "error": {
+ "message": "Invalid API key"
+ }
+}
+```
+
+最终错误提示：`API密钥无效或已过期，请检查配置：Invalid API key`
+
+## 注意事项
+
+1. **日志输出**：工具会在控制台输出详细的错误信息，方便调试
+2. **原始数据保留**：所有原始错误数据都保存在 `error.data` 中
+3. **类型判断**：使用 `isErrorType()` 判断错误类型，而不是直接比较字符串
+4. **网络错误**：网络连接失败等非 HTTP 错误也会被统一处理
+
+## 更新日志
+
+- v1.0.0 (2025-11-23)
+ - 初始版本
+ - 支持 Fetch 和 Axios
+ - 完整的错误类型处理
+ - 友好的中文错误提示
diff --git a/src/utils/httpErrorHandler.ts b/src/utils/httpErrorHandler.ts
new file mode 100644
index 0000000..fe0fc91
--- /dev/null
+++ b/src/utils/httpErrorHandler.ts
@@ -0,0 +1,301 @@
+/**
+ * HTTP 错误处理工具
+ * 支持 fetch 和 axios,可在主线程和渲染线程使用
+ */
+
+import type { AxiosError } from 'axios'
+
+// 错误类型常量
+export const ErrorType = {
+ HTTP_ERROR: 'HTTP_ERROR',
+ NETWORK_ERROR: 'NETWORK_ERROR',
+ TIMEOUT: 'TIMEOUT',
+ ABORTED: 'ABORTED',
+ UNKNOWN_ERROR: 'UNKNOWN_ERROR'
+} as const
+
+export type ErrorTypeValue = (typeof ErrorType)[keyof typeof ErrorType]
+
+// 扩展的 Error 接口
+export interface HttpError extends Error {
+ type?: ErrorTypeValue
+ status?: number
+ statusText?: string
+ data?: any
+ originalError?: any
+}
+
+// 错误响应数据接口
+// interface ErrorData {
+// error?: {
+// message?: string
+// }
+// message?: string
+// msg?: string
+// rawError?: string
+// [key: string]: any
+// }
+
+/**
+ * 从错误响应数据中提取服务器消息
+ * @param errorData - 错误响应数据
+ * @returns 服务器错误消息
+ */
+function extractServerMessage(errorData: any): string | null {
+ if (!errorData) return null
+
+ return (
+ errorData?.error?.message ||
+ errorData?.message ||
+ errorData?.msg ||
+ errorData?.error ||
+ errorData?.rawError ||
+ null
+ )
+}
+
+/**
+ * 根据 HTTP 状态码获取友好的错误提示
+ * @param status - HTTP 状态码
+ * @param serverMessage - 服务器返回的错误消息
+ * @param statusText - HTTP 状态文本
+ * @returns 友好的错误消息
+ */
+function getHttpErrorMessage(
+ status: number,
+ serverMessage: string | null = null,
+ statusText: string | null = null
+): string {
+ let errorMessage = ''
+
+ switch (status) {
+ case 400:
+ errorMessage = '请求参数错误，请检查配置是否正确'
+ break
+
+ case 401:
+ errorMessage = 'API密钥无效或已过期，请检查配置'
+ break
+
+ case 403:
+ errorMessage = '没有访问权限，请检查API密钥是否有效'
+ break
+
+ case 404:
+ errorMessage = 'API地址不存在，请检查配置的URL是否正确'
+ break
+
+ case 429:
+ errorMessage = '请求过于频繁，请稍后再试'
+ break
+
+ case 500:
+ errorMessage = '服务器内部错误，请稍后重试'
+ break
+
+ case 502:
+ errorMessage = '网关错误，服务暂时不可用，请稍后重试'
+ break
+
+ case 503:
+ errorMessage = '服务暂时不可用，请稍后重试'
+ break
+
+ case 504:
+ errorMessage = '请求超时，请检查网络连接或稍后重试'
+ break
+
+ default:
+ errorMessage = `请求失败 (${status})`
+ }
+
+ // 附加服务器消息
+ if (serverMessage) {
+ // 避免重复信息
+ if (!errorMessage.includes(serverMessage)) {
+ errorMessage += `：${serverMessage}`
+ }
+ } else if (statusText && status >= 500) {
+ // 5xx 错误且没有服务器消息时，附加状态文本
+ errorMessage += `：${statusText}`
+ }
+
+ return errorMessage
+}
+
+/**
+ * 处理 Fetch API 的错误响应
+ * @param response - Fetch Response 对象
+ * @returns 包含友好错误信息的 Error 对象
+ */
+export async function handleFetchError(response: Response): Promise
+ 子项目列表 - {{ activeProjectTitle }}
+
+
+ 共 {{ subProjects.length }} 个子项目
+
+
+
+
+
+
+ 新增分镜批次
+
+
+