常见问题

数据安全

我的数据存储在哪里？

所有数据存储在本地 ~/.soagents/ 目录下，包括会话历史、配置、技能等。不会上传到任何云端。

API Key 安全吗？

API Key 存储在本地 ~/.soagents/config.json 中，不会发送到除对应供应商以外的任何服务。建议确保你的电脑用户账户安全。

供应商相关

没有 API Key 也能用吗？

可以。选择 Anthropic (订阅) 供应商，使用 Claude Pro 或 Max 订阅账号登录即可。

支持 OpenAI 的模型吗？

支持。通过 OpenRouter 供应商可以使用 GPT-5.4 等 OpenAI 模型，或添加自定义供应商。

为什么响应很慢？

可能的原因：

• 供应商 API 响应慢（特别是大模型）
• 网络连接不稳定
• 需要配置代理（针对部分国际供应商）

MCP 相关

MCP 启用后不生效？

尝试：

1. 检查对应运行时是否安装（Node.js / Python）
2. 在设置中禁用后重新启用
3. 重启 SoAgents

如何查找更多 MCP？

访问 mcp.so 或 smithery.ai 浏览社区 MCP。

应用相关

支持 Windows 吗？

目前提供 macOS 和 Windows 版本，可从 GitHub Releases 下载。

如何更新？

应用会自动检测新版本。左侧栏底部出现更新提示时，点击即可更新。也可以手动从 GitHub 下载最新版本。

对话记录丢失了？

检查左侧栏的过滤条件是否设为”全部”。如果设为”活跃”，归档的会话不会显示。也可以使用搜索功能查找。

如何清理存储空间？

会话数据存储在 ~/.soagents/sessions/，可以手动删除不需要的会话文件夹。日志文件在 ~/.soagents/logs/。