KVAXIR本地建模工作室
首页 功能 用法 隐私 安全 更新 下载 关于 联系
0.3.11 · 公测版
首页 / 用法与 FAQ

用法与 FAQ

快速上手六步、软件内置 FAQ 的全部条目，以及安装 / 串口 / 训练三类常见故障的依据与处理。FAQ 与故障条目均来自软件内置手册与仓库文档，逐条标注来源。

01— 快速上手

六步跑通第一个模型

步骤 1 — 安装与校验
  • 从下载页获取安装包 Kvaxir-Setup-*.exe 与校验文件 SHA256SUMS.txt；双击按向导安装，无需另装 Python。
  • 校验：certutil -hashfile Kvaxir-Setup-xxx.exe SHA256 对照 SHA256SUMS.txt
步骤 2 — 注册与登录
  • 邮箱注册（验证码），注册即赠 1000 KVA 体验额度。
  • 同一账号在任意电脑登录即可，余额跟随账号，无需重新注册。
步骤 3 — 接设备或导数据
  • 接设备三条路径：①「实时采集」中选择通道（串口 / BLE / TCP / UDP / MQTT）后启动；② 对助手说「读一下串口」「扫描蓝牙」；③ 串口在联网状态下自动刷新端口列表。
  • 导文件：CSV / TSV / Excel，安装后即可导入。
步骤 4 — 打标
  • 在实时数据页「设备检测」头部启用「动作打标」→ 设备动作触发卡片 → 选择建议标签或输入自定义标签 → 保存。
  • 累计 60 条以上可先训练一版；同类动作建议至少标注 5 段。
  • 也可以对助手说「入库」或点「停止」后入库：采集缓冲写入数据集，在「数据预览」可见。启用「动作打标」时，打标卡片保存的数据段直接进入数据集。
步骤 5 — 训练
  • 「数据预览」确认目标列（打标时自动创建「标签」列）→ 训练页选择档位（速度 / 均衡 / 精度）→ 开始训练。
  • 未标注数据不参与训练。
步骤 6 — 查看结果与导出
  • 训练完成后结果下方出现「助手解读」与「换精度档再训一次」。
  • 模型确认可用后点「导出模型包」保存为 .zip。
02— FAQ

内置 FAQ 全部条目（14 条）

设备连接与采集启动
三条路径：①「实时采集」中选择通道（串口 / BLE / TCP / UDP / MQTT）后启动；② 对助手说「读一下串口」「扫描蓝牙」；③ 串口在联网状态下自动刷新端口列表。
串口读不到数据 / 乱码
① 点端口旁的刷新按钮：设备接入后端口自动出现；② 波特率与设备编码自动匹配（GBK 等中文编码自动适配）；③ 数据为纯二进制时，打开「设备检测」的「HEX」开关查看原始字节；④ 确认端口未被其它程序占用（串口监视器 / 烧录工具）。
蓝牙连接与订阅
「扫描蓝牙」→ 在列表中点设备连接（或对助手说「蓝牙详情 <地址>」查看服务 / 特征列表）→「蓝牙订阅 ffe1」指定数据通道（等效 nRF 工具）→「蓝牙读 <地址> 5 秒」直接读取数据。
采集数据转入数据集
对助手说「入库」，或点「停止」后入库：采集缓冲写入数据集，在「数据预览」可见。启用「动作打标」时，打标卡片保存的数据段直接进入数据集。
动作打标
在实时数据页「设备检测」头部启用「动作打标」→ 设备动作触发卡片 → 选择建议标签或输入自定义标签 → 保存。累计 60 条以上可先训练一版；同类动作建议至少标注 5 段。
模型训练
「数据预览」确认目标列（打标时自动创建「标签」列）→ 训练页选择档位（速度 / 均衡 / 精度）→ 开始训练。未标注数据不参与训练。
结果查看与导出
训练完成后结果下方出现「助手解读」与「换精度档再训一次」；模型确认可用后点「导出模型包」保存为 .zip。
KVA 额度
KVA 是 Kvaxir 的统一服务额度：本地训练按轮次低额计量（15 KVA / 轮），助手功能按 token 计量。注册赠送 1000 KVA；更多额度可在「账户」页用激励码兑换或购买套餐。
换机登录与离线激活
同一账号在任意电脑登录即可，余额跟随账号，无需重新注册。完整权限可用「离线激活」恢复：账户页复制机器码 → 管理员生成授权码 → 粘贴激活（离线可用、导出无水印）。
助手能力
可查询操作问题，也可直接下达指令：「读一下串口」「扫描蓝牙」「蓝牙订阅 ffe1」「停止」「入库」「开启动作检测打标」。
数据与隐私
① 训练与数据 100% 本地：导入 / 采集 / 打标 / 训练 / 导出全链路离线可跑，零联网；② 助手按需联网：仅发送统计摘要（列名 / 行数 / 特征概况），不含原始数据行；③ 可完全关闭：设置中切换「纯本地模式」后全程离线。可用系统抓包工具（资源监视器等）自行验证。
离线可用范围
训练、采集、图谱、导出全链路离线可运行；在线助手功能需要网络。「断网自动降级为本地引导（纯本地模式）」将在后续公测版中提供。
版本更新
运行新版本安装包覆盖安装即可；版本号见 设置 → 关于。
自动筛特征
  • 训练前自动挑列：只保留最有信息量的 N 列（默认 128，可填 1–4096；
  • 列数本就不超过 N 时不裁剪）。顺序：① 先剔除全空 / 常量 / 重复列；
  • ② 数值列按方差、非数值列按去重数排序，取前 N；
  • ③ 目标列（标签）不参与打分、无条件保留（防标签泄露）。实测 10299 行 × 561 列：模型体积 43MB → 11MB（约 −75%），代价是可能损失一点精度（约 −1.4 个点）。列多且有冗余时启用；
  • 列少或每列都有意义时关闭，或把 N 调大（256 / 512）。默认关闭（不勾选 = 用全部列）。拿不准时先看「特征体检」报告（只诊断不改数据）再定 N。
03— 常见故障

安装 / 串口 / 训练三类

现象依据与处理
安装包校验不一致用 certutil -hashfile Kvaxir-Setup-xxx.exe SHA256 对照 SHA256SUMS.txt；不一致不要安装。（来源：首页下载段）
安装 / 首次启动被系统拦截公测版安装包尚未做代码签名；「代码签名证书（消除 SmartScreen 提示）」列在 M4 发布清单内。杀软白名单要点与便携版方案见发布物内 docs/Windows真机清单与便携版-v1.md。
串口读不到数据① 点端口旁的刷新按钮（设备接入后端口自动出现）；② 波特率与设备编码自动匹配；③ 纯二进制数据打开「HEX」开关看原始字节；④ 确认端口未被其它程序占用。
串口数据乱码乱码治理 v2 会做多编码自动识别（UTF-8 / GBK / Big5 / UTF-16）；「乱码自愈」为开发版功能，截至 2026-09-21 尚未随版本发布。
蓝牙连不上 / 收不到数据「扫描蓝牙」→ 点设备连接；用「蓝牙详情 <地址>」看服务 / 特征列表；「蓝牙订阅 ffe1」指定数据通道；「蓝牙读 <地址> 5 秒」直接读取。连接侧断线自动重连为 1s / 3s / 5s 三连。
训练按钮被拒 / 启动不了磁盘可用 < 1.5 GB 会直接拒绝启动训练（提示先清理磁盘）；内存 < 0.5 GB 拒绝启动，< 2 GB 提示建议改用「速度优先」档。
训练中途失败 / 超时单次尝试超时 = 2 × 档位 time_limit + 120s，超时杀子进程并按「超时」分类进入下一级；整条降级阶梯预算 = 4 × 档位 time_limit + 300s，预算用完即停，不再无限重试。失败分类会写进训练历史条目（ok/kind 字段），随项目一起保存。
长时间反复训练后磁盘吃紧磁盘可用 < 10 GB 时自动清理超过 24 小时的旧 models/run_*（保留当前模型 + 最近 3 个）。人工建议：把 models/ 迁到更大的分区；每天只保留 1–2 个成功模型目录；导出成 .zip 后删除缓存目录；不要把 models/ 放进同步盘。
训练时整机卡顿训练 CPU 上限为 max(1, 核数 - 2)，最简降级档固定 2 核，任何档位都不会吃满整机。
要看训练日志训练日志（人读）：训练页「导出日志」→ .txt；结构化日志（机器读）：models/train_logs/train_<时间戳>_<微秒>.jsonl。