故障排除

本页列出常见问题及其解决办法。如果问题持续存在,请收集日志文件 (参见收集日志)并转发给技术支持。

硬件采集

未检测到采集前端

• 确认设备已连接并通电,然后重新打开采集标签页以刷新设备列表。
• USB 设备一次只绑定一个驱动。Deepsona 路径需要设备处于其 自研绑定上(便携式记录仪 → WinUSB;模块化控制器 → FTDI)。如果设备处于其他 驱动上,所选路径将无法枚举到它。
• 检查 Settings → Acquisition Driver。默认是 Deepsona 驱动 (自研)。仅当您打算使用厂商栈时才切换到 厂商驱动。

通道无信号或呈平直线

• 确认该通道已启用,且其传感器灵敏度已在录制器配置中正确设置。
• 对于 ICP 传感器,确认该通道的 ICP 供电已开启。

几何 / CAD 导入

导入的 STEP 模型看起来像线框而非实体曲面

完整曲面三角化使用外部的 OpenCASCADE 转换器。当它不存在时,谛耳 会自动回退到无依赖的线框导入器——模型仍可加载,只是保真度较低。 要获得完整曲面,请确保 tools\step2mesh.exe 与应用部署在一起。 目标机器上无需安装 Python。

AI 助手

"AI is not configured: no API key found"

• 打开 Settings → AI Assistant,选择一个提供商,并输入其 API key。
• 保存后重新打开 AI 面板——key 在面板打开时读取。
• 或者,在应用旁放置一个 .env 文件,内含 DEEPSEEK_API_KEY=...。

"Model not exist" 或认证错误

• 检查 key 是否与所选提供商匹配(DeepSeek 的 key 无法用于 OpenAI 等)。
• 如果您在 Advanced 下设置了自定义 Model,请确认该模型名称对该提供商有效; 留空则使用提供商默认模型。

性能

应用首次启动很慢

在全新机器上,杀毒软件(例如 Windows Defender)可能会在首次运行时扫描已签名的二进制文件。后续 启动会更快。将安装文件夹加入杀毒软件的排除列表可消除延迟。

收集日志

打开 Settings → Diagnostics → Open log folder。应用文件夹中包含 crash.log(未处理异常的详细信息)。USB 采集日志写入 %TEMP%\vlisten_winusb.log。报告问题时请一并发送这两个文件。