Sidemate
桌伴Sidemate Wiki

故障排查

错误信息看不懂？这里查表。

错误信息对照表

错误信息含义解决方法
------------------------
模型未加载没有可用的本地 LLM设置→模型下载，下载模型（完成后自动加载）
模型服务正在启动中llama-server 还在加载模型等待 10-30 秒，首次加载较慢
云端连接测试失败API Key 无效或网络不通检查 Key、网络、Key 是否过期
文档路径不安全文件路径含 .. 或跳出工作区工作区限制在安全目录内
内网地址被拦截fetch_url 访问了 localhost/内网 IPSSRF 安全防护。如需访问内网，设置→隐私→完全信任
输出过长被截断网页内容超过 12000 字符正常设计，避免发送过多内容到云端
请先加载模型离线模式没有加载的模型设置→模型下载，下载模型（完成后自动加载）
知识库不可用KB 模型未安装或未加载设置→模型下载，下载知识库模型（完成后自动加载）

常见问题

应用启动后白屏

检查 %LOCALAPPDATA%\Sidemate\data\logs\ 下的日志文件。通常是 Python 依赖损坏——尝试重新运行 envsetup.py。

模型加载失败

  1. 确认模型文件完整（.gguf 文件存在且大小正确）
  2. 确认有足够内存（按档位：0.8B 16GB / 2B 24GB / 4B 32GB）
  3. 尝试换一个档位（4B→2B）

知识库处理卡住

  1. 大文件需要更多时间
  2. 暂停后恢复
  3. 重启应用（处理进度会持久化）
  4. 检查 KB 模型是否加载

---

Error Message Reference

ErrorMeaningSolution
--------------------------
Model not loadedNo local LLM availableSettings → Model Download, download a model (auto-loads when done)
Model service startingllama-server still loadingWait 10-30 seconds, first load is slower
Cloud connection failedInvalid API Key or networkCheck Key, network, expiry
Unsafe file pathPath contains .. or escapes workspaceWorkspace is sandboxed
Internal IP blockedfetch_url accessed localhost/internal IPSSRF protection. Settings → Privacy → Trusted for internal access
Output truncatedWeb content exceeds 12000 charsBy design, prevents sending too much to cloud
Please load a model firstNo loaded model in offline modeSettings → General, select and load a model
Knowledge base unavailableKB models not installed/loadedDownload KB model package and load

Common Issues

App shows white screen after launch

Check logs in %LOCALAPPDATA%\Sidemate\data\logs\. Usually Python dependency corruption — try re-running envsetup.py.

Model load failure

  1. Verify model file is complete (.gguf exists, correct size)
  2. Ensure sufficient RAM (by tier: 0.8B 16GB / 2B 24GB / 4B 32GB)
  3. Try a smaller tier (4B→2B)

KB processing stuck

  1. Large files take more time
  2. Try pause then resume
  3. Restart app (progress is persisted)
  4. Check if KB models are loaded

---

品牌与商标声明：本文中提及的产品名称均为各自所有方的商标或注册商标，仅用于客观功能对比说明。Sidemate 与上述公司无隶属、合作或背书关系。

对比说明：本页对比反映 Sidemate v0.9.7 当前设计与公开资料，实际表现可能因版本、时间、用户环境而异。

AI 输出声明：Sidemate 是软件运行平台，不直接提供 AI 模型。离线模式下的模型（如 Qwen 系列）是开源第三方，在线模式下的云端模型由您配置的第三方服务商（如 OpenAI / DeepSeek / 通义千问 等）提供。AI 输出的文本、图表、文档等内容由模型本身决定，可能存在错误、遗漏或偏差。涉及医疗、法律、财务、安全等重要决策时，请人工核对或咨询专业人士。Sidemate 不对 AI 输出内容的准确性、完整性或适用性承担责任。

数据与隐私：离线模式下，对话、文件、知识库存储于用户本机；在线/并行模式下，提问发往所选云端模型服务商，相关政策遵循该服务商，非 Sidemate 保证。