常见问题与错误处理

0. 提示「网络连接失败 / Agent Craft Core 中止」

这是 DataPulse 调度服务没有启动。打开 DataPulse 客户端 →「主页」→ 点击「启动服务」，状态显示绿色「运行中」后再试。

1. 提示「运行时系统错误」（Windows）

Windows 系统缺少 Visual C++ 2015-2022 运行时库。下载安装后重启 DataPulse 即可：

官方下载（64 位）：https://aka.ms/vs/17/release/vc_redist.x64.exe
高速下载（64 位）：https://wwbvq.lanzoue.com/iZzhp3wxhhzi

2. 提示「Message: 503 Passthrough mode is disabled」

这是 API Key 配置失效。打开 DataPulse 客户端 →「设置」→「配置信息」→ 点击「重新生成」，然后重启 AI 客户端。

3. 提示「502 connect ECONNREFUSED 127.0.0.1:18765」（含 proxy 字样）

是电脑上的代理软件（Clash、V2Ray 等）把本地请求拦截了。任选一种解决：

1. 最简单：使用 DataPulse 时直接关闭代理软件，再重新打开 AI 客户端。
2. 不想关代理：在代理软件的「绕过列表 / Bypass」中加入 127.0.0.1 和 localhost 并保存。
3. 还不行：按 Win + R 输入 sysdm.cpl 回车 → 高级 → 环境变量 → 新建系统变量：变量名 NO_PROXY，变量值 127.0.0.1,localhost，确定后重启 DataPulse 和 AI 客户端。

另外请确认：DataPulse 已打开并且点过「启动服务」，状态栏显示绿色「运行中」。

4. 提示「Message: 400 Invalid request parameters」

对话历史过长导致上游拒绝了请求。在 AI 客户端里输入 /clear 清理对话历史，或新开一个会话窗口。长时间运行的任务建议定期清理上下文。

5. 软件闪退 / 双击打不开 / 用着用着突然消失

最高可能是杀毒软件或公司监控软件拦截了。目前已知 360 安全卫士会误报，公司配发电脑的企业管控软件也会静默杀进程。

1. 查隔离区：打开 360 → 查杀修复 → 恢复区，找到 DataPulse 相关文件点「恢复」并「添加信任」。其他杀软同理。
2. 加白名单：把 DataPulse 安装目录整个加入杀毒软件信任列表（360：设置 → 信任列表）。
3. 公司电脑：联系公司 IT 加白名单，或换个人电脑使用。
4. 排除以上原因仍不行：联系客服获取「诊断工具」，把生成的报告发给客服排查。