网络连接与离线支持

网络连接与离线支持

Wansan Studio 遵循 本地优先 (Local-First) 的设计原则。在网络环境处理上，我们有两个核心设计目标：

1. 完全离线可用：在没有任何网络连接的情况下，除了需要 AI 辅助的功能外，软件所有的核心分析、绘图和导出能力均不受影响。
2. 服务器容错机制：由于我们的后端服务部署在 Cloudflare，在中国地区可能存在访问缓慢或无法连接的情况。Wansan 已在底层实现了完善的超时容错，即便是无法访问我们的服务器，也绝不影响您的正常使用。

---

核心功能：100% 本地运行

以下操作完全不需要连接互联网，且不受网络波动影响：

• 数据导入：Excel、CSV、JSON 文件的本地解析与入库。
• 计算引擎：所有的 SQL 执行和数据聚合都在您本地完成。
• 可视化渲染：图表的生成和本地展示。
• 报告排版：画布布局调整、文字块编写。
• 本地导出：导出为 PDF、PNG 或离线 HTML 报告。

---

哪些功能需要网络？

Wansan 仅在以下极少数场景下需要网络连接：

1. AI 对话分析：向您配置的 AI 服务商（如 DeepSeek 或 OpenAI）发送分析请求时。
2. 许可证验证：首次激活专业版或进行版本检查。
3. 匿名使用统计：用于优化产品的少量匿名埋点。

---

关于网络环境的特殊说明

由于中国地区的网络环境特殊，如果您在访问部署在 Cloudflare 的服务（如匿名统计、远程配置）时遇到超时：

请放心，这不会导致以下问题：

• Wansan 不会因此卡顿、崩溃或弹出报错。
• 核心分析流程（导入、查询、图表）依然完全可用。
• 只要您的 AI 提供商（如 DeepSeek）连接正常，AI 分析功能就不会受到任何干扰。

---

优化建议

如果您发现 AI 响应速度不理想：

1. 首选 DeepSeek：推荐国内用户使用 DeepSeek，其连接质量和稳定性远优于 OpenAI。
2. 离线分析：在处理极度敏感的数据时，您可以完全断开网络进行数据导入、建模和排版，仅在需要 AI 辅助总结时开启网络。

Wansan 理念：分析数据的能力不应受制于网线。我们尽可能将所有计算留在本地。