) => {
+ event.stopPropagation()
+ window.dispatchEvent(new Event('wxe:open-voice-recognition-settings'))
+ }, [])
+
const formatDuration = (seconds: number | undefined): string => {
if (!seconds || !isFinite(seconds)) return '0:00'
const mins = Math.floor(seconds / 60)
@@ -151,33 +200,54 @@ export function VoicePlayer({
return `${mins}:${secs.toString().padStart(2, '0')}`
}
- if (loading) {
- return (
-
- ▶
- 加载中...
-
- )
- }
-
- if (error && !audioUrl) {
- return (
-
- ▶
- 当前版本暂不支持播放
-
- )
- }
-
return (
-
-
{isPlaying ? '⏸' : '▶'}
-
-
-
-
+
+
+
{isPlaying ? '⏸' : '▶'}
+ {loading ? (
+
加载中...
+ ) : error && !audioUrl ? (
+
当前语音暂不支持播放
+ ) : (
+ <>
+
+
+
+
+
+
{formatDuration(audioDuration)}
+
+ )}
+ {transcribing ? (
+
+ ) : (
+
+ )}
-
{formatDuration(audioDuration)}
+ {modelStatus && modelStatus.state !== 'ready' && (
+
event.stopPropagation()}>
+
+ {modelStatus.state === 'downloading'
+ ? `离线模型正在下载 ${Math.round(modelStatus.progress * 100)}%`
+ : modelStatus.state === 'unsupported'
+ ? '当前系统暂不支持语音转文字'
+ : '请先在设置中准备离线语音模型'}
+
+
+
+ )}
+ {transcribing &&
正在识别...
}
+ {transcript &&
{transcript}
}
+ {transcriptError &&
{transcriptError}
}
)
}
diff --git a/src/renderer/src/components/export/ExportTaskCenter.tsx b/src/renderer/src/components/export/ExportTaskCenter.tsx
index f8e21c0..e1461f9 100644
--- a/src/renderer/src/components/export/ExportTaskCenter.tsx
+++ b/src/renderer/src/components/export/ExportTaskCenter.tsx
@@ -16,6 +16,22 @@ export function ExportTaskCenter({
onToggle,
onCancel
}: ExportTaskCenterProps): React.ReactElement {
+ const [copiedJobId, setCopiedJobId] = React.useState('')
+
+ const copyTaskLog = async (task: ExportTaskRecord): Promise
=> {
+ const log = [
+ 'WechatExplorer 导出任务日志',
+ `时间：${new Date(task.createdAt).toLocaleString('zh-CN')}`,
+ `会话：${task.contactName}`,
+ `格式：${task.format.toUpperCase()}`,
+ `状态：${task.progress.phase}`,
+ `进度：${task.progress.percent ?? 0}%`,
+ `错误：${task.progress.error || '未记录具体错误'}`
+ ].join('\n')
+ await navigator.clipboard.writeText(log)
+ setCopiedJobId(task.jobId)
+ }
+
return (
<>
)}
+ {task.status === 'failed' && (
+
+ )}
))
)}
diff --git a/src/renderer/src/components/export/ExportWorkspace.tsx b/src/renderer/src/components/export/ExportWorkspace.tsx
index 9486647..25b6179 100644
--- a/src/renderer/src/components/export/ExportWorkspace.tsx
+++ b/src/renderer/src/components/export/ExportWorkspace.tsx
@@ -16,6 +16,7 @@ import type {
GroupMemberName
} from './exportTypes'
import { displayName, formatLabels, formatOrder, messageKinds } from './exportUtils'
+import type { VoiceModelStatus } from '../../../../shared/voice-recognition'
export function ExportWorkspace({
contacts,
@@ -38,6 +39,8 @@ export function ExportWorkspace({
const [nameMode, setNameMode] = useState
('remark')
const [groupMembers, setGroupMembers] = useState([])
const [includeMedia, setIncludeMedia] = useState(true)
+ const [includeVoiceTranscripts, setIncludeVoiceTranscripts] = useState(true)
+ const [voiceModelStatus, setVoiceModelStatus] = useState(null)
const [includeAvatars, setIncludeAvatars] = useState(true)
const [preferOriginal, setPreferOriginal] = useState(true)
const [fallbackThumbnail, setFallbackThumbnail] = useState(true)
@@ -149,6 +152,17 @@ export function ExportWorkspace({
return () => window.clearTimeout(timer)
}, [activeContact])
+ React.useEffect(() => {
+ let active = true
+ void window.api
+ .getVoiceModelStatus()
+ .then((next) => active && setVoiceModelStatus(next))
+ .catch(() => undefined)
+ return () => {
+ active = false
+ }
+ }, [])
+
const toggleKind = (value: string): void => {
setSelectedKinds((current) => {
const next = new Set(current)
@@ -208,6 +222,12 @@ export function ExportWorkspace({
: undefined,
kinds: Array.from(selectedKinds) as ExportMessageKind[],
includeMedia,
+ includeVoiceTranscripts:
+ includeVoiceTranscripts &&
+ includeMedia &&
+ format === 'html' &&
+ selectedKinds.has('voice') &&
+ voiceModelStatus?.state === 'ready',
preferOriginal,
fallbackThumbnail,
keepMissing,
@@ -484,6 +504,20 @@ export function ExportWorkspace({
/>
媒体缺失时保留占位说明
+
资源文件仅在 HTML 导出中生效，CSV、JSON 和 Markdown 只保留文本内容。
@@ -492,6 +526,10 @@ export function ExportWorkspace({
图片解密：已就绪
视频资源：可用
语音资源：可用
+
+ 语音转文字：
+ {voiceModelStatus?.state === 'ready' ? '已就绪' : '请先在设置中准备模型'}
+
表情资源：按需解析
文件附件：按需复制
diff --git a/src/renderer/src/features/settings/SettingsWorkspace.tsx b/src/renderer/src/features/settings/SettingsWorkspace.tsx
index 78cdc1b..965aab5 100644
--- a/src/renderer/src/features/settings/SettingsWorkspace.tsx
+++ b/src/renderer/src/features/settings/SettingsWorkspace.tsx
@@ -11,6 +11,7 @@ import { AdvancedPage } from './pages/AdvancedPage'
import { CacheCleanupPage } from './pages/CacheCleanupPage'
import { AppearancePage } from './pages/AppearancePage'
import { AboutPage } from './pages/AboutPage'
+import { VoiceRecognitionPage } from './pages/VoiceRecognitionPage'
import type { Contact } from '../../../../shared/types'
import type { AIRuntimeModelConfig } from '../../../../shared/ai-provider'
@@ -88,6 +89,8 @@ export function SettingsWorkspace({
return
case 'ai-model':
return
+ case 'voice-recognition':
+ return
case 'recall-protection':
return
case 'advanced':
diff --git a/src/renderer/src/features/settings/model/settingsNavigation.ts b/src/renderer/src/features/settings/model/settingsNavigation.ts
index 13256cb..359da7e 100644
--- a/src/renderer/src/features/settings/model/settingsNavigation.ts
+++ b/src/renderer/src/features/settings/model/settingsNavigation.ts
@@ -17,7 +17,8 @@ export const SETTINGS_NAVIGATION: SettingsNavigationGroup[] = [
{
label: '智能能力',
items: [
- { id: 'ai-model', label: 'AI 模型' },
+ { id: 'voice-recognition', label: '语音转文字' },
+ { id: 'ai-model', label: 'AI 模型' }
]
},
{
diff --git a/src/renderer/src/features/settings/model/types.ts b/src/renderer/src/features/settings/model/types.ts
index 82aee06..0fbda56 100644
--- a/src/renderer/src/features/settings/model/types.ts
+++ b/src/renderer/src/features/settings/model/types.ts
@@ -2,6 +2,7 @@ export type SettingsCategoryId =
| 'account-database'
| 'database-key'
| 'image-key'
+ | 'voice-recognition'
| 'ai-model'
| 'recall-protection'
| 'local-api'
diff --git a/src/renderer/src/features/settings/pages/VoiceRecognitionPage.tsx b/src/renderer/src/features/settings/pages/VoiceRecognitionPage.tsx
new file mode 100644
index 0000000..3e48ba4
--- /dev/null
+++ b/src/renderer/src/features/settings/pages/VoiceRecognitionPage.tsx
@@ -0,0 +1,246 @@
+import { useCallback, useEffect, useMemo, useState } from 'react'
+import type { VoiceModelStatus } from '../../../../../shared/voice-recognition'
+
+const SENSEVOICE_URL = 'https://github.com/FunAudioLLM/SenseVoice'
+const SHERPA_URL = 'https://github.com/k2-fsa/sherpa-onnx'
+
+const STATUS_LABELS: Record = {
+ missing: '未下载',
+ downloading: '下载中',
+ ready: '已就绪',
+ invalid: '需要修复',
+ error: '下载失败',
+ unsupported: '暂不支持'
+}
+
+function formatBytes(value: number): string {
+ if (value < 1024 * 1024) return `${Math.round(value / 1024)} KB`
+ return `${(value / 1024 / 1024).toFixed(1)} MB`
+}
+
+function formatPlatform(status: VoiceModelStatus): string {
+ if (status.platform === 'win32')
+ return `Windows ${status.architecture === 'x64' ? '64 位' : status.architecture}`
+ if (status.platform === 'darwin') {
+ return status.architecture === 'arm64' ? 'macOS Apple 芯片' : 'macOS Intel'
+ }
+ return `${status.platform} ${status.architecture}`
+}
+
+export function VoiceRecognitionPage({
+ onNotice
+}: {
+ onNotice: (message: string) => void
+}): React.ReactElement {
+ const [status, setStatus] = useState(null)
+ const [busy, setBusy] = useState(false)
+
+ const refresh = useCallback(async (): Promise => {
+ setStatus(await window.api.getVoiceModelStatus())
+ }, [])
+
+ useEffect(() => {
+ let active = true
+ void window.api.getVoiceModelStatus().then((next) => active && setStatus(next))
+ const unsubscribe = window.api.onVoiceModelProgress((next) => {
+ if (active) setStatus(next)
+ })
+ return () => {
+ active = false
+ unsubscribe()
+ }
+ }, [])
+
+ const badgeClass = useMemo(() => {
+ if (status?.state === 'ready') return 'ready'
+ if (status?.state === 'downloading') return 'checking'
+ if (status?.state === 'invalid' || status?.state === 'error') return 'error'
+ if (status?.state === 'unsupported') return 'unavailable'
+ return 'warning'
+ }, [status?.state])
+
+ const download = async (): Promise => {
+ setBusy(true)
+ setStatus((current) =>
+ current ? { ...current, state: 'downloading', downloadedBytes: 0, progress: 0 } : current
+ )
+ try {
+ const result = await window.api.downloadVoiceModel()
+ setStatus(result.status)
+ onNotice(result.success ? '离线语音模型已准备好' : result.error || '模型下载失败')
+ } finally {
+ setBusy(false)
+ }
+ }
+
+ const cancelDownload = async (): Promise => {
+ await window.api.cancelVoiceModelDownload()
+ onNotice('正在取消模型下载')
+ }
+
+ const removeModel = async (): Promise => {
+ if (!window.confirm('删除离线语音模型？以后使用语音转文字时需要重新下载。')) return
+ setBusy(true)
+ try {
+ setStatus(await window.api.removeVoiceModel())
+ onNotice('离线语音模型已删除')
+ } catch (error) {
+ onNotice(error instanceof Error ? `模型删除失败：${error.message}` : '模型删除失败')
+ } finally {
+ setBusy(false)
+ }
+ }
+
+ const openDirectory = async (): Promise => {
+ const result = await window.api.openVoiceModelDirectory()
+ if (!result.success) onNotice(result.error || '无法打开模型目录')
+ }
+
+ return (
+
+
+
+
+
+
+
+
语音内容仅在本机处理
+
识别过程不会上传语音、聊天内容或转写结果，也不需要配置在线 AI 服务。
+
+
+
运行环境
+
+
+
+
- 当前平台
+ - {status ? formatPlatform(status) : '检测中...'}
+
+
+
- 离线识别
+ -
+ {status?.supported ? '支持' : '暂不支持'}
+
+
+
+
- 识别引擎
+ - sherpa-onnx · SenseVoice
+
+
+
+
+
离线模型
+
+
+
SenseVoice Small INT8
+
+ {status?.state === 'downloading'
+ ? `正在下载 ${Math.round(status.progress * 100)}%`
+ : status
+ ? STATUS_LABELS[status.state]
+ : '正在检测'}
+
+
+ {status
+ ? `版本 ${status.version} · ${formatBytes(status.totalBytes)}`
+ : '读取模型状态...'}
+
+ {status?.error &&
{status.error}
}
+
+ 上游模型：
+
+ SenseVoice（MIT）
+
+ ·
+ 推理运行库：
+
+ sherpa-onnx（Apache-2.0）
+
+
+
+ {status?.state === 'downloading' ? (
+
+ ) : status?.state === 'ready' ? (
+ <>
+
+
+
+ ) : (
+
+ )}
+
+
+ {status?.state === 'downloading' && (
+
+
+ {Math.round(status.progress * 100)}%
+
+ {formatBytes(status.downloadedBytes)} / {formatBytes(status.totalBytes)}
+
+
+
+
+
+
平台支持
+
+
+ Windows
+ 支持 Windows 10/11 64 位
+
+
+ macOS
+ 支持 Intel 与 Apple 芯片
+
+
+
+ 模型由两个平台共用；应用会随安装包提供对应系统的本地识别运行库。
+
+
+
+