Skip to content

Commit af467a8

Browse files
dtsolaclaude
andcommitted
♻️ refactor(help): 优化帮助页面内容和i18n
- 重新组织帮助页面内容结构 - 优化中英文翻译键的命名 - 改进内容展示的可读性 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 5c61524 commit af467a8

3 files changed

Lines changed: 81 additions & 45 deletions

File tree

frontend/src/renderer/src/locales/en-US.ts

Lines changed: 25 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -659,7 +659,7 @@ export default {
659659
},
660660
semantic: {
661661
title: 'Semantic Understanding',
662-
description: 'BGE-M3 vector embedding + Ollama/OpenAI compatible LLM'
662+
description: 'BGE-M3/Cloud embedding vector + Ollama/Cloud LLM understanding'
663663
}
664664
},
665665
tutorial: {
@@ -670,9 +670,9 @@ export default {
670670
step1: { label: 'Speech Recognition Model:', text: 'Settings → Speech Settings → Select FastWhisper model version (local)' },
671671
step2: { label: 'Large Language Model:', text: 'Settings → LLM Settings → Choose local Ollama or OpenAI compatible cloud service' },
672672
step3: { label: 'Vision Understanding Model:', text: 'Settings → Vision Model → Select CN-CLIP model (local)' },
673-
step4: { label: 'Text Embedding Model:', text: 'Settings → Embedding Model → Select BGE-M3 model (local)' },
674-
step5: { label: 'Cloud Service Config:', text: 'To use cloud LLM, configure API key and endpoint' },
675-
tip: 'Tip: Local models offer better privacy, cloud models provide stronger understanding. Choose based on your needs'
673+
step4: { label: 'Text Embedding Model:', text: 'Settings → Embedding Model → Choose local BGE-M3 or cloud embedding API' },
674+
step5: { label: 'Cloud Service Config:', text: 'To use cloud LLM or cloud embedding, configure API key and endpoint' },
675+
tip: 'Tip: Local models offer better privacy, cloud models provide stronger understanding. You choose the balance between performance and privacy'
676676
}
677677
},
678678
panel2: {
@@ -725,14 +725,16 @@ export default {
725725
header: 'What\'s the difference between local and cloud models?',
726726
content: {
727727
comparisonTitle: 'Comparison:',
728-
comparison1: { label: 'Local Models (Ollama):', text: 'Run completely offline, data never leaves device, best privacy, requires higher hardware specs' },
728+
comparison1: { label: 'Local Models (Ollama/BGE-M3):', text: 'Run completely offline, data never leaves device, best privacy, requires higher hardware specs' },
729729
comparison2: { label: 'Cloud Models (OpenAI Compatible):', text: 'Search queries sent to cloud, better understanding, no local hardware resources needed' },
730+
comparison3: { label: 'Cloud Embedding Models:', text: 'Provide higher quality vector representations for improved search accuracy, queries sent to cloud' },
730731
choiceTitle: 'How to Choose:',
731-
choice1: 'High privacy requirements → Use local Ollama models',
732+
choice1: 'High privacy requirements → Use local models (Ollama + BGE-M3)',
732733
choice2: 'Pursue better understanding → Use cloud LLMs',
733-
choice3: 'Limited hardware config → Use cloud LLMs',
734-
choice4: 'Need offline use → Use local Ollama models',
735-
note: 'Note: Text embedding, speech recognition, image understanding models currently only support local, no data uploaded'
734+
choice3: 'Pursue more accurate search → Use cloud embedding models',
735+
choice4: 'Limited hardware config → Use cloud services',
736+
choice5: 'Need offline use → Use local models',
737+
note: 'Note: Local files and index data are always stored locally, never uploaded. Only search queries are sent to cloud (when using cloud models)'
736738
}
737739
},
738740
panel1: {
@@ -762,12 +764,17 @@ export default {
762764
ollamaCommand1: 'Install model:',
763765
ollamaCommand2: 'View models:',
764766
ollamaCommand3: 'Run model:',
765-
cloudTitle: 'Cloud OpenAI Compatible Service:',
766-
cloud1: 'Check if API key is properly configured',
767-
cloud2: 'Verify endpoint URL is accessible',
768-
cloud3: 'Check network connection and proxy settings',
769-
cloud4: 'Confirm API service is normal (check provider announcements)',
770-
cloud5: 'Check account balance (some services charge by usage)'
767+
cloudLlmTitle: 'Cloud LLM Service (OpenAI Compatible):',
768+
cloudLlm1: 'Check if API key is properly configured',
769+
cloudLlm2: 'Verify endpoint URL is accessible',
770+
cloudLlm3: 'Check network connection and proxy settings',
771+
cloudLlm4: 'Confirm API service is normal (check provider announcements)',
772+
cloudLlm5: 'Check account balance (some services charge by usage)',
773+
cloudEmbeddingTitle: 'Cloud Embedding Model Service:',
774+
cloudEmbedding1: 'Check if API key is properly configured',
775+
cloudEmbedding2: 'Verify endpoint URL is accessible',
776+
cloudEmbedding3: 'Check network connection and proxy settings',
777+
cloudEmbedding4: 'Confirm model name matches what the provider supports'
771778
}
772779
},
773780
panel3: {
@@ -818,7 +825,7 @@ export default {
818825
},
819826
about: {
820827
appDescription: 'Cross-platform local desktop application (Windows/MacOS/Linux) supporting multimodal AI intelligent search. Provides smarter file retrieval experience for knowledge workers through voice, text, and image inputs. Supports both local Ollama and OpenAI-compatible cloud LLMs for flexible deployment.',
821-
tagline: 'Local First · Cloud Optional · Privacy Secure',
828+
tagline: 'Local First · Cloud Optional · Privacy You Control',
822829
features: {
823830
voice: {
824831
title: 'Voice Search',
@@ -830,12 +837,12 @@ export default {
830837
},
831838
semantic: {
832839
title: 'Semantic Search',
833-
description: 'BGE-M3 vector embedding + Ollama/Cloud LLM understanding'
840+
description: 'BGE-M3/Cloud embedding vector + Ollama/Cloud LLM understanding'
834841
}
835842
},
836843
techHighlight: {
837844
title: 'Local First, Cloud Optional',
838-
description: 'Supports both local Ollama and OpenAI-compatible cloud LLMs, flexible switching. Local files and index data always stored locally, only search queries sent to cloud (when using cloud models).'
845+
description: 'Supports local Ollama/BGE-M3 and cloud OpenAI-compatible APIs, flexible switching. Local files and index data always stored locally, only search queries sent to cloud (when using cloud models). You choose the balance between performance and privacy.'
839846
}
840847
}
841848
}

frontend/src/renderer/src/locales/zh-CN.ts

Lines changed: 25 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -665,7 +665,7 @@ export default {
665665
},
666666
semantic: {
667667
title: '语义理解',
668-
description: 'BGE-M3向量嵌入 + Ollama/OpenAI兼容大模型'
668+
description: 'BGE-M3/云端嵌入向量 + Ollama/云端大模型理解'
669669
}
670670
},
671671
tutorial: {
@@ -676,9 +676,9 @@ export default {
676676
step1: { label: '语音识别模型:', text: '设置 → 语音设置 → 选择FastWhisper模型版本(本地)' },
677677
step2: { label: '大语言模型:', text: '设置 → 大语言模型 → 选择本地Ollama或OpenAI兼容云端服务' },
678678
step3: { label: '视觉理解模型:', text: '设置 → 视觉模型 → 选择CN-CLIP模型(本地)' },
679-
step4: { label: '文本嵌入模型:', text: '设置 → 嵌入模型 → 选择BGE-M3模型(本地)' },
680-
step5: { label: '云端服务配置:', text: '如需使用云端大模型,配置API密钥和端点地址' },
681-
tip: '建议:本地模型隐私更好,云端模型理解能力更强。可根据需求灵活选择'
679+
step4: { label: '文本嵌入模型:', text: '设置 → 嵌入模型 → 选择本地BGE-M3或云端嵌入API' },
680+
step5: { label: '云端服务配置:', text: '如需使用云端大模型或云端嵌入,配置API密钥和端点地址' },
681+
tip: '建议:本地模型隐私更好,云端模型理解能力更强。性能与隐私的权衡由您选择'
682682
}
683683
},
684684
panel2: {
@@ -731,14 +731,16 @@ export default {
731731
header: '本地模型和云端模型有什么区别?',
732732
content: {
733733
comparisonTitle: '对比说明:',
734-
comparison1: { label: '本地模型(Ollama):', text: '完全离线运行,数据不离开设备,隐私性最佳,需要较高硬件配置' },
734+
comparison1: { label: '本地模型(Ollama/BGE-M3):', text: '完全离线运行,数据不离开设备,隐私性最佳,需要较高硬件配置' },
735735
comparison2: { label: '云端模型(OpenAI兼容):', text: '搜索查询会发送到云端,理解能力更强,无需本地硬件资源' },
736+
comparison3: { label: '云端嵌入模型:', text: '提供更高质量的向量表示,提升搜索准确度,查询会发送到云端' },
736737
choiceTitle: '如何选择:',
737-
choice1: '对隐私要求高 → 使用本地Ollama模型',
738+
choice1: '对隐私要求高 → 使用本地模型(Ollama + BGE-M3)',
738739
choice2: '追求更好的理解能力 → 使用云端大模型',
739-
choice3: '硬件配置有限 → 使用云端大模型',
740-
choice4: '需要离线使用 → 使用本地Ollama模型',
741-
note: '注意:文本嵌入、语音识别、图像理解模型目前仅支持本地运行,不会上传数据'
740+
choice3: '追求更精准的搜索 → 使用云端嵌入模型',
741+
choice4: '硬件配置有限 → 使用云端服务',
742+
choice5: '需要离线使用 → 使用本地模型',
743+
note: '注意:本地文件和索引数据始终存储在本地,不上传。仅搜索查询会发送到云端(使用云端模型时)'
742744
}
743745
},
744746
panel1: {
@@ -768,12 +770,17 @@ export default {
768770
ollamaCommand1: '安装模型:',
769771
ollamaCommand2: '查看模型:',
770772
ollamaCommand3: '运行模型:',
771-
cloudTitle: '云端OpenAI兼容服务:',
772-
cloud1: '检查API密钥是否正确配置',
773-
cloud2: '验证端点地址是否可访问',
774-
cloud3: '检查网络连接和代理设置',
775-
cloud4: '确认API服务是否正常(查看服务商公告)',
776-
cloud5: '检查账户余额是否充足(部分服务按量计费)'
773+
cloudLlmTitle: '云端大模型服务(OpenAI兼容):',
774+
cloudLlm1: '检查API密钥是否正确配置',
775+
cloudLlm2: '验证端点地址是否可访问',
776+
cloudLlm3: '检查网络连接和代理设置',
777+
cloudLlm4: '确认API服务是否正常(查看服务商公告)',
778+
cloudLlm5: '检查账户余额是否充足(部分服务按量计费)',
779+
cloudEmbeddingTitle: '云端嵌入模型服务:',
780+
cloudEmbedding1: '检查API密钥是否正确配置',
781+
cloudEmbedding2: '验证端点地址是否可访问',
782+
cloudEmbedding3: '检查网络连接和代理设置',
783+
cloudEmbedding4: '确认模型名称是否与服务商支持的一致'
777784
}
778785
},
779786
panel3: {
@@ -824,7 +831,7 @@ export default {
824831
},
825832
about: {
826833
appDescription: '支持多模态AI智能搜索的跨平台本地桌面应用(Windows/MacOS/Linux),通过语音、文本、图像多种输入方式,支持本地Ollama和云端OpenAI兼容大模型,为知识工作者提供更智能的文件检索体验。',
827-
tagline: '本地优先 · 云端可选 · 隐私安全',
834+
tagline: '本地优先 · 云端可选 · 隐私可控',
828835
features: {
829836
voice: {
830837
title: '语音搜索',
@@ -836,12 +843,12 @@ export default {
836843
},
837844
semantic: {
838845
title: '语义搜索',
839-
description: 'BGE-M3向量嵌入 + Ollama/云端大模型理解'
846+
description: 'BGE-M3/云端嵌入向量 + Ollama/云端大模型理解'
840847
}
841848
},
842849
techHighlight: {
843850
title: '本地优先,云端可选',
844-
description: '支持本地Ollama和OpenAI兼容云端大模型,灵活切换。本地文件和索引数据始终存储在本地,只有搜索查询会发送到云端服务(使用云端模型时)。'
851+
description: '支持本地Ollama/BGE-M3和云端OpenAI兼容API,灵活切换。本地文件和索引数据始终存储在本地,仅搜索查询会发送到云端(使用云端模型时)。性能与隐私的权衡由您选择。'
845852
}
846853
}
847854
}

frontend/src/renderer/src/views/Help.vue

Lines changed: 31 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -182,18 +182,38 @@
182182

183183
<a-collapse-panel key="2" :header="t('help.faq.panel2.header')">
184184
<div class="faq-content">
185-
<p><strong>{{ t('help.faq.panel2.content.checkTitle') }}</strong></p>
185+
<!-- 本地 Ollama 服务 -->
186+
<p><strong>{{ t('help.faq.panel2.content.ollamaTitle') }}</strong></p>
186187
<ul>
187-
<li>{{ t('help.faq.panel2.content.check1') }}</li>
188-
<li>{{ t('help.faq.panel2.content.check2') }}</li>
189-
<li>{{ t('help.faq.panel2.content.check3') }}</li>
190-
<li>{{ t('help.faq.panel2.content.check4') }}</li>
188+
<li>{{ t('help.faq.panel2.content.ollama1') }}</li>
189+
<li>{{ t('help.faq.panel2.content.ollama2') }}</li>
190+
<li>{{ t('help.faq.panel2.content.ollama3') }}</li>
191+
<li>{{ t('help.faq.panel2.content.ollama4') }}</li>
191192
</ul>
192-
<p><strong>{{ t('help.faq.panel2.content.commandsTitle') }}</strong></p>
193+
<p><strong>{{ t('help.faq.panel2.content.ollamaCommandsTitle') }}</strong></p>
193194
<ul>
194-
<li>{{ t('help.faq.panel2.content.command1') }}<code>ollama pull qwen2.5:1.5b</code></li>
195-
<li>{{ t('help.faq.panel2.content.command2') }}<code>ollama list</code></li>
196-
<li>{{ t('help.faq.panel2.content.command3') }}<code>ollama run qwen2.5:1.5b</code></li>
195+
<li>{{ t('help.faq.panel2.content.ollamaCommand1') }}<code>ollama pull qwen2.5:1.5b</code></li>
196+
<li>{{ t('help.faq.panel2.content.ollamaCommand2') }}<code>ollama list</code></li>
197+
<li>{{ t('help.faq.panel2.content.ollamaCommand3') }}<code>ollama run qwen2.5:1.5b</code></li>
198+
</ul>
199+
200+
<!-- 云端大模型服务 -->
201+
<p><strong>{{ t('help.faq.panel2.content.cloudLlmTitle') }}</strong></p>
202+
<ul>
203+
<li>{{ t('help.faq.panel2.content.cloudLlm1') }}</li>
204+
<li>{{ t('help.faq.panel2.content.cloudLlm2') }}</li>
205+
<li>{{ t('help.faq.panel2.content.cloudLlm3') }}</li>
206+
<li>{{ t('help.faq.panel2.content.cloudLlm4') }}</li>
207+
<li>{{ t('help.faq.panel2.content.cloudLlm5') }}</li>
208+
</ul>
209+
210+
<!-- 云端嵌入模型服务 -->
211+
<p><strong>{{ t('help.faq.panel2.content.cloudEmbeddingTitle') }}</strong></p>
212+
<ul>
213+
<li>{{ t('help.faq.panel2.content.cloudEmbedding1') }}</li>
214+
<li>{{ t('help.faq.panel2.content.cloudEmbedding2') }}</li>
215+
<li>{{ t('help.faq.panel2.content.cloudEmbedding3') }}</li>
216+
<li>{{ t('help.faq.panel2.content.cloudEmbedding4') }}</li>
197217
</ul>
198218
</div>
199219
</a-collapse-panel>
@@ -319,6 +339,8 @@
319339
<a-tag color="orange">CN-CLIP</a-tag>
320340
<a-tag color="purple">BGE-M3</a-tag>
321341
<a-tag color="cyan">OpenAI API</a-tag>
342+
<a-tag color="magenta">Cloud Embedding</a-tag>
343+
<a-tag color="volcano">MCP & Agent Skills</a-tag>
322344
</div>
323345
</a-card>
324346
</div>

0 commit comments

Comments
 (0)