常见问题

概述

问：FreeBCI DAQ 是什么？ 答：基于浏览器的 EEG 采集与实时频谱分析平台。所有处理均在本地完成。

问：是否免费？ 答：是的，遵循 AGPL v3 开源协议。

问：可以离线使用吗？ 答：核心采集和分析可以。AI 功能需要网络（或本地 Ollama）。

问：支持哪些硬件？ 答：任何通过 USB 串口（UART）输出 int24 二进制协议、波特率 921600 的 EEG 设备。

问：为什么只支持 Chrome 和 Edge？ 答：Web Serial API 目前仅限 Chromium 内核浏览器。

问：数据是否上传？ 答：不会。所有处理在本地浏览器完成，没有后端服务器。

问：数据存储在哪里？ 答：IndexedDB（特征帧）、LocalStorage（偏好）、内存（原始样本）、可选的 CSV 文件。

问：API Key 安全吗？ 答：存储在 IndexedDB，仅直接发送到你配置的 API 端点。

问：为什么 EI 需要几秒才出现？ 答：FFT 需要 2 秒的样本窗口。

问：为什么前 30 秒被排除？ 答：设备预热。可通过 VITE_INITIAL_UNRELIABLE 配置。

问：热力图为什么不完整？ 答：当前仅 ch0 为有效 EEG 通道。热力图通过切换站点逐步积累。

问：专注度分类有多准确？ 答：基于 EI 中位数对比的二元近似。非医疗级别。

问：哪些模型效果最好？ 答：GPT-4o、DeepSeek V3、Llama 3（通过 Ollama）。

问：可以不使用 API Key 吗？ 答：可以，使用本地 Ollama。无需 Key。

问：AI 能看到原始 EEG 数据吗？ 答：不能。仅发送预计算的频带功率值（δ,θ,α,β,γ）。

问：可以修改代码吗？ 答：可以，遵循 AGPL v3 协议。详见开发者指南和开发者教程。

问：如何运行测试？

npm test
npx vitest run -t "测试名称"

问：错误详情在哪里？ 答：诊断抽屉（底部日志按钮）、系统页面、浏览器开发者工具（F12）。

问：停滞（STALLED）是什么意思？ 答：2 秒未收到有效数据包。数据恢复后自动恢复。IndexedDB 写入超时？ 导出重要对话、清理旧数据。