文档中心

三分钟上手,剩下的边用边查

ToVisionAI 的操作就一件事:把图片文件夹拖进来,标几张,点开始训练,然后去推理页看结果。 下面是完整流程、快捷键速查和常见问题;要更细的说明,下载 PDF。

五分钟跑通一遍

1打开软件

装好后从开始菜单(或桌面图标)启动 ToVisionAI。 第一次打开是一个空白工作区,左边侧边栏是空的。

2加数据集

按 Ctrl+O 选一个装着图片的文件夹,或者直接把文件夹拖进侧边栏。 图片会出现在「标注」页右边的图像列表里。

3标几张

在「标注」页按 W 画矩形、按 Q 画多边形, 松手后在标签框里选一个已有标签或新建一个。自动保存,没有保存按钮。

4开始训练

切到「训练」页,选模型类型(检测 / 分割)和模型大小,确认几个参数, 点右上角「开始训练」,等进度条和曲线往前走。

5看结果

切到「推理」页,模型会自动带上这个数据集训练出来的那个; 点「开始推理」或按 Enter,结果框、置信度、耗时马上出来。

6带走模型

在「模型文件」那一行右键可以导出 .tvai, 拷到别的电脑上接着用。

快捷键

不用背 —— 画布上右键弹出的菜单里,每一项右边都写着它的快捷键。

全局
Ctrl+B 收起 / 展开侧边栏
Ctrl+N 打开内置 AI 助手
Ctrl+O 添加数据集(选文件夹)
推理页
A / D、← / → 上一张 / 下一张
Enter 重新跑一次推理
按住 空格 临时切回原图,松开回到结果
F 适应窗口
标注页
W / Q 画矩形 / 画多边形
E / Esc 结束当前编辑,回到选择模式
F 适应窗口
Ctrl+E 改当前对象的标签
Ctrl+D 复制当前对象
Delete 删除当前对象
Ctrl+Z 撤销
Ctrl+Y / Ctrl+Shift+Z 重做
A / D 上一张 / 下一张
滚轮 / 拖动 / 双击 以光标为中心缩放 / 按住左键平移 / 双击空白处适应窗口

下下来慢慢看

软件自带的《使用说明》从界面到训练参数逐节讲清楚,另加术语表和常见问题;宣传手册适合转给同事看。

使用说明 · PDF

从界面上每个按钮到训练参数的含义,逐节讲清楚;开头有可点击的目录, 想查哪一节直接跳。

宣传手册 · PDF

讲清楚「别人卖你一个模型,我们给你一套自己造模型的能力」这件事, 适合发给需要做决定的人。

大家最常问的几个

训练环境怎么准备?

标注和推理只用软件本身,不需要额外准备。训练要用到的 Python 与依赖放在程序目录的 TOVISIONAI_FORGE\ 里,第一次用训练页时在软件内按提示获取。

还没获取这一层的时候,训练页是「演示模式」:界面照常能点,但曲线是演示数据、 不会真的产出模型。这也是判断「训练环境有没有装好」最简单的办法。

标注文件是什么格式?能和别的标注工具互换吗?

一张图配一个同名的 .json,用的是通用标注格式(labelme 兼容): rectangle 和 polygon 两边都能互相打开。 labelme 标好的数据可以直接拿来训,ToVisionAI 标的也能给别人用。

覆盖旧文件之前,软件会先备份一份 .json.bak。

训练一定要 NVIDIA 显卡吗?

建议有 —— GPU 训练快得多。没有也能跑:训练设备选 CPU 就行, 小数据、小模型照样能出结果,只是慢一些。

我的图片会被上传吗?

不会。图片、标注、训练出来的模型都留在你自己的电脑里。 内置的 AI 助手默认是「离线模式」,数据集统计、标注检查、训练状态、使用说明这几类问题, 不接任何外部服务就能回答;只有你自己填了模型服务地址,对话才会发到你指定的那个服务。

训练出来的模型怎么拿到别的电脑上用?

在推理页「模型文件」那一行右键 → 导出模型,得到一个 .tvai 文件。拷到别的电脑后,在那台机器的推理页点一下 「模型文件」,选这个文件就能用;模型类型(检测 / 分割)是从文件里读出来的,不用手选。

换个电脑,最近项目都没了?

最近项目列表、训练参数与进度、界面设置都存在 %APPDATA%\ToVisionAI\state.json。 把这个文件拷到新电脑的同一位置,或者在新电脑上重新把数据集文件夹拖进来一次即可。 顺便一提:图片本身不会被复制,软件只是记住了文件夹路径。

.tvai 是什么文件?

内容是 ToVisionAI 模型文件,是软件训练后导出的模型文件, 用来部署到产线进行推理。

同时能开几个项目?

侧边栏里可以放很多数据集,同一时间打开一个。每个数据集的训练参数和训练进度各自记着, 切来切去不串、关掉再开还在。

几个词先说清楚

数据集

就是一个装图片的文件夹。软件不往里面写别的东西。

项目

你打开过的那个数据集文件夹。软件按项目分别记住训练参数、进度和模型路径。

标注文件

「一张图配一个同名 .json」,通用格式,可以和其他标注工具互相打开。

.tvai

ToVisionAI 模型文件,软件训练后导出,用于产线部署推理。

演示模式

还没获取训练运行时时的状态:界面照常,曲线是演示数据,不产出模型;在训练页按提示获取运行时即可。

置信度 / 重叠阈值

置信度阈值:低于这个分数的目标不显示。重叠阈值:框之间去重的门槛(端到端模型不用这一项)。

边看边试最快

照着上面的六步走一遍,基本就会用了;剩下的细节用到再回来查。