본문으로 건너뛰기

软件启动错误

常见软件启动错误故障排除步骤​

步骤1：检查系统要求​

  1. 确保您的系统满足最低要求：
    • Windows 10 或更高版本
    • 至少4GB内存
    • 至少1GB可用磁盘空间

步骤2：检查Microsoft Visual C++ Redistributable​

通常情况下, vcruntime140.dll 未找到 或者应用程序无法正常启动(0xc000007b)错误是由于 Microsoft Visual C++ Redistributable 未安装导致的。

  1. 按 Windows + R 键, 输入 cmd 并按回车
  2. 输入 dir "C:\Windows\System32\vcruntime*.dll" 并按回车
  3. 如果有输出，说明安装了相关版本的 Visual C++ Redistributable。文件名中的 vcruntime 后缀通常会带版本号，如 vcruntime140.dll（对应 2015-2022）。
  4. 如果没有输出，请下载并安装Microsoft Visual C++ Redistributable: Latest Microsoft Visual C++ Redistributable Version

Download Link1 Download Link2

步骤3：检查系统时间​

电脑时钟不准确会导致"Agent Start Timeout"错误：

  1. 右键点击屏幕右下角的时间显示
  2. 选择"调整日期/时间"
  3. 如果尚未启用，请开启"自动设置时间"
  4. 如果时间仍然不正确，点击"立即同步"或手动设置正确的日期和时间
  5. 校正时间后重新启动TikMatrix

步骤4：检查应用程序日志​

  1. 点击设置 - 打开应用目录 按钮
  2. 导航到 logs 文件夹
  3. 检查最新的日志文件中的错误信息

如果问题仍然存在​

步骤 5：macOS — Agent InvalidStateError​

在部分 macOS 机器上，Agent 可能无法启动并出现如下错误：

Agent start error InvalidStateError: The object is in an invalid state.

可能原因：

  • 通常是应用与当前 macOS 系统版本或旧硬件/固件之间的不兼容所致。

解决方法 / 工作方案：

  1. 通过「系统设置」>「通用」>「软件更新」将 macOS 更新到最新版。更新后重启 Mac 并再次启动 TikMatrix。
  2. 如果无法升级或错误仍然存在，尝试在另一台运行较新 macOS 的 Mac 上运行应用。

如果在尝试以上方法后问题依旧，请收集应用日志并通过 Telegram 联系我们，附上您的 macOS 版本与日志文件。

请联系我们的支持团队 Telegram ，并提供以下信息：

  • Windows版本
  • 应用程序日志文件
  • 您已经尝试过的步骤

Step 6: Linux AppImage - white screen or EGL_BAD_PARAMETER​

On Linux, AppImage builds may show a white window on Wayland sessions, especially on NVIDIA systems, and the logs may contain:

Could not create default EGL display: EGL_BAD_PARAMETER

If that happens, start the AppImage once with:

WEBKIT_DISABLE_COMPOSITING_MODE=1 \
WEBKIT_DISABLE_DMABUF_RENDERER=1 \
./TikMatrix.AppImage

Recent builds enable the same WebKit workaround automatically when the app detects an AppImage running on Wayland, so the manual command should only be needed for older packages. If you prefer a native Linux package, the Linux build also includes a .deb artifact.