操作 FAQ
装不上、卡顿、模型下载失败——常见问题怎么解决。
装不上、卡顿、下载失败——常见问题怎么解决。
模型下载
Q: 下载速度很慢怎么办？
A: 默认使用魔搭 ModelScope（国内快）。在下载页可切换到 HuggingFace。支持断点续传——中断后重新点击下载会继续。
Q: 下载失败了怎么办？
A: 1) 检查网络连接 2) 切换下载源（ModelScope ↔ HuggingFace）3) 使用「从本地安装」导入 .sidemate 离线包 4) 确认磁盘空间足够（LLM 0.5-3GB + KB 4.5GB）
Q: 4B / 2B / 0.8B 选哪个？
A: 按内存选档：16GB 选 0.8B / 24GB 选 2B / 32GB 选 4B（内存越大可跑越大的模型，效果越好；下载页会按你的内存自动推荐）。可以都下载，随时切换。
知识库
Q: 上传文档失败？
A: 1) 检查格式（支持 11 种：txt/md/csv/docx/xlsx/pdf/epub/html/htm/srt/rtf）2) .doc/.xls 需先转存为 .docx/.xlsx 3) 单文件不超过 50MB 4) 确认 KB 模型已下载并加载
Q: 文档一直显示"处理中"？
A: 大文件需要时间处理（文本提取 + 分块 + 向量化）。如果长时间无变化，尝试暂停后恢复，或重启应用。
Q: 检索结果不相关？
A: 可能是查询词和文档内容语义距离太远。尝试换个问法，或检查文档是否已处理完成（状态为"就绪"）。
对话与工具
Q: 对话突然中断？
A: 可能原因：1) 你点了停止按钮 2) 工具调用达到 20 轮上限（复杂任务自动收尾）3) 网络超时（在线模式）。重新提问即可。
Q: AI 说"知识库不可用"？
A: 知识库模型（bge-m3 + reranker）未加载。去设置→模型下载下载 KB 模型组合包。
Q: 离线模式下能用联网搜索吗？
A: 不能。离线模式下 search_web 和 fetch_url 不可用。需要联网功能请切换到在线或并行模式。
性能
Q: 内存不够怎么办？
A: 1) 降低 LLM 档位（4B→2B→0.8B）2) 关闭 Reranker 常驻（设置→常规）3) 关闭其他大内存程序 4) 有独立显卡可开启 GPU 加速
Q: 回复速度很慢？
A: 离线模式速度取决于硬件。CPU 模式比 GPU 慢 3-10 倍。有 NVIDIA/AMD/Intel Arc 显卡会快很多。
数据
Q: 如何备份数据？
A: 设置→常规→导出备份（ZIP 格式，含对话、设置、知识库元数据）。也可以直接复制安装目录下的 data/ 文件夹。
Q: 卸载后数据还在吗？
A: 数据存储在 %LOCALAPPDATA%\Sidemate\data\。卸载时有选项页：默认只删除程序本体，模型和个人数据全部保留（重装后无缝继续使用）；如需彻底清理，勾选对应选项即可。
---
Installation, performance, download issues — common problems and solutions.
Model Download
Q: Download is very slow?
A: Default source is ModelScope (fast in China). You can switch to HuggingFace on the download page. Resume is supported — re-click download after interruption.
Q: Download failed?
A: 1) Check network 2) Switch source (ModelScope ↔ HuggingFace) 3) Use "Install from local" with a .sidemate package 4) Ensure sufficient disk space
Q: Which tier: 4B / 2B / 0.8B?
A: Pick by RAM: 16GB→0.8B / 24GB→2B / 32GB→4B (bigger RAM unlocks bigger, better models; the download page auto-recommends for your RAM). You can download all and switch anytime.
Knowledge Base
Q: Upload failed?
A: 1) Check format (11 supported: txt/md/csv/docx/xlsx/pdf/epub/html/htm/srt/rtf) 2) Convert .doc/.xls to .docx/.xlsx 3) Max 50MB per file 4) Ensure KB models are downloaded and loaded
Q: Document stuck on "processing"?
A: Large files take time (extraction + chunking + vectorization). If stuck for very long, try pause/resume or restart the app.
Q: Search results irrelevant?
A: The query may be too far from document content semantically. Try rephrasing, or check if documents are fully processed (status "ready").
Conversation & Tools
Q: Conversation interrupted?
A: Possible causes: 1) You clicked Stop 2) Tool calls reached 20-round limit (auto-wrap-up) 3) Network timeout (online mode). Just ask again.
Q: AI says "Knowledge base unavailable"?
A: KB models (bge-m3 + reranker) not loaded. Go to Settings → Model Download to get the KB model package.
Q: Can I use web search in offline mode?
A: No. search_web and fetch_url are unavailable offline. Switch to Online or Parallel mode for internet features.
Performance
Q: Not enough memory?
A: 1) Lower LLM tier (4B→2B→0.8B) 2) Disable Reranker resident (Settings → General) 3) Close other memory-heavy apps 4) Enable GPU if you have a dedicated graphics card
Q: Responses are slow?
A: Offline mode speed depends on hardware. CPU mode is 3-10x slower than GPU. NVIDIA/AMD/Intel Arc GPUs are much faster.
Data
Q: How to backup?
A: Settings → General → Export Backup (ZIP, includes conversations, settings, KB metadata). Or copy the data/ folder directly.
Q: Is data kept after uninstall?
A: Data is stored in %LOCALAPPDATA%\Sidemate\data\. The uninstaller shows an options page: by default only the program itself is removed — models and personal data are kept (reinstall picks up right where you left off). Check the boxes if you want a full cleanup.
---
品牌与商标声明：本文中提及的产品名称均为各自所有方的商标或注册商标，仅用于客观功能对比说明。Sidemate 与上述公司无隶属、合作或背书关系。
对比说明：本页对比反映 Sidemate v0.9.7 当前设计与公开资料，实际表现可能因版本、时间、用户环境而异。
AI 输出声明：Sidemate 是软件运行平台，不直接提供 AI 模型。离线模式下的模型（如 Qwen 系列）是开源第三方，在线模式下的云端模型由您配置的第三方服务商（如 OpenAI / DeepSeek / 通义千问 等）提供。AI 输出的文本、图表、文档等内容由模型本身决定，可能存在错误、遗漏或偏差。涉及医疗、法律、财务、安全等重要决策时，请人工核对或咨询专业人士。Sidemate 不对 AI 输出内容的准确性、完整性或适用性承担责任。
数据与隐私：离线模式下，对话、文件、知识库存储于用户本机；在线/并行模式下，提问发往所选云端模型服务商，相关政策遵循该服务商，非 Sidemate 保证。
