跳到主要内容

常见问题排查

本页面涵盖了使用 Deep Code 时可能遇到的常见问题及其解决方法。

错误提示："Cannot connect to server, please check your network"（无法连接服务器，请检查你的网络）​

问题：运行 Deep Code 时出现错误——无法连接服务器，请检查你的网络

此错误表示终端无法与 AI 模型服务器建立连接，导致无法调用 AI 模型来完成任务。可能的原因有三种——请逐一排查：

1. 网络连接问题​

确认你的电脑可以正常访问互联网。最简单的测试方法是打开浏览器访问任意网站（如 bing.com）。如果页面加载正常，说明网络连接没有问题。如果无法访问，请检查你的网络设置。

2. 系统时钟不同步​

终端与服务器之间的通信使用了加密协议，该协议对时间验证有严格要求。如果你的电脑时钟与实际时间相差超过 1 小时，连接将会失败。请将系统时钟调整为正确时间：

  • Windows：右键点击任务栏时钟 → 调整日期/时间 → 开启"自动设置时间"
  • macOS：系统设置 → 通用 → 日期与时间 → 开启"自动设置日期与时间"
  • Linux：系统设置 → 通用 → 日期与时间 → 开启"自动设置日期与时间"

修正系统时钟后，重新打开 Deep Code 即可解决问题。

3. 防火墙拦截连接（Windows）​

Windows 防火墙可能正在阻止该应用的网络访问。按照以下步骤允许其通过：

  1. 打开 Windows 安全中心
  2. 选择防火墙和网络保护 → 允许应用通过防火墙
  3. 点击"更改设置"，找到并勾选 Deep Code 应用
  4. 保存设置

Linux：AppImage 无法启动​

问题：AppImage 文件已启用执行权限，但双击后 Deep Code 仍然无法启动​

提示：你可以从命令行终端启动 Deep Code AppImage，以查看详细的错误信息。

排查步骤

  1. 打开终端，进入存放 Deep Code AppImage 文件的目录。
  2. 输入 ./Deep Code.AppImage 并回车运行 Deep Code。

错误：Permission denied（权限被拒绝）​

⛔ Error: Permission denied

解决方法

此错误表示 AppImage 文件没有执行权限。在终端中运行以下命令为 AppImage 文件添加执行权限：

chmod +x ./*.AppImage

然后重新运行 Deep Code AppImage 文件即可解决问题。

错误：缺少 libfuse.so.2​

⛔ dlopen(): error loading libfuse.so.2

AppImages require FUSE to run.
You might still be able to extract the contents of this AppImage
if you run it with the --appimage-extract option.
See https://github.com/AppImage/AppImageKit/wiki/FUSE
for more information

解决方法

Deep Code AppImage 需要 libfuse2 模块才能运行。按照以下步骤安装 FUSE：

sudo apt update
sudo apt install libfuse2

如果找不到该软件包，可以尝试 Debian 及较新发行版使用的 t64 包名：

sudo apt install libfuse2t64

然后重新运行 Deep Code AppImage 文件即可解决问题。