已验证
稳定版
第一次装，走这条
- 发布前跑完 42 项安装兼容性用例
- Windows、macOS 与主流 Linux 都有对应安装包
- 每期公告里修掉的报错，这里同步生效
- 踩坑了有文档可查，按提示原文就能定位
三条线，各管一类场景
先选版本，再拿安装包
同一套软件发了三个方向：日常自用跟最新，生产环境求稳，内网团队要离线。选岔了不是不能用，是后面要多绕几步。
长期支持
长期支持版
装一次，几年不动
- 配置格式与调用接口保持向下兼容
- 只收安全修补，不掺功能变更
- 适合车间工位、产线终端这类不方便频繁重启的机器
- 真要升级，先比对公告里的变更条目再动手
内网可用
企业内网版
没有外网也能铺开
- 离线安装包，落地即装，不用回源外网
- 附批量部署脚本模板，一台写一次，其余照跑
- 支持静默安装与域内分发
- 机器数量多时，可以先和客服对一遍分发方式
当前稳定版 3.4.0
这个包里，装的是这些
先看文件信息，再决定点不点安装。版本号、文件大小和校验值会随每次发版一起刷新，拿包前扫一眼这几行就够。
- 文件名
qiudidai-3.4.0-win-x64.exe- 版本号
3.4.0（稳定版线最新）- 适用系统
- Windows 10 / 11 x64 · macOS 12 及以上 · Linux x86_64
- 文件大小
218.4 MB- 发布状态
- 兼容性用例已通过，可直接安装
SHA-256 校验值
a3f1c9d84b62e07f5d1a8c33be94f2076cd51b8e9a04f3c7d8620e5b7a19c4d6
校验不用装额外工具：系统自带的命令就能算出一串值，和你复制到的这串对上，说明文件在下载途中没被改动。
展开看各个系统怎么算校验值
Windows：certutil -hashfile qiudidai-3.4.0-win-x64.exe SHA256
macOS / Linux：shasum -a 256 qiudidai-3.4.0-win-x64.exe
两串字符完全一致，就可以放心双击安装包；对不上就重新下一次，别急着运行。
装之前先花一分钟
先看兼容清单，别装到一半才发现不支持
下面这张表按系统列出三条产品线的支持情况。把鼠标停在状态点上，能看到该系统的最低依赖；在手机上点一下状态点也能看到。
操作系统
稳定版
长期支持版
企业内网版
Windows 10 / 11 x64
稳定版
长期支持版
企业内网版
Windows Server 2019 / 2022
稳定版
长期支持版
企业内网版
macOS 12 及以上（含 Apple 芯片）
稳定版
长期支持版
企业内网版
Ubuntu 20.04 / 22.04 / 24.04
稳定版
长期支持版
企业内网版
Debian 11 / 12
稳定版
长期支持版
企业内网版
RHEL / CentOS 7.9 与 8 / 9
稳定版
长期支持版
企业内网版
openEuler 22.03 LTS
稳定版
长期支持版
企业内网版
- 支持
- 部分支持，需补依赖
- 不支持
系统之外，这几项也要顺手确认
- 本机管理员权限，安装过程会写入系统目录
- 至少 600 MB 可用磁盘空间
- 4 GB 以上可用内存
- 安装期间保持外网连通，企业内网版不需要
- 暂时关掉占用 8080 与 8443 端口的其他服务
- 关闭正在扫描安装目录的杀毒软件
从拿到包到第一次打开
七个步骤之内装完
版本选对了，剩下基本是一路点下去。中途卡在某一步，把那一屏的提示原文记下来，去帮助中心按关键词搜，比从头翻文档快得多。
核对系统版本，跟上面的兼容对照比一遍
关掉会占用安装目录的程序
算一次文件校验值，和页面上那串对上
以管理员身份运行安装包
选安装目录，默认路径最省事
等进度条走完，中途别点取消
首次启动，按引导完成初始化设置
停在「依赖缺失」或「端口占用」上？去帮助中心按报错找解法
历史版本归档
旧版本不是废纸
有些机器跑着依赖旧接口的插件，有些内网环境还没验证新版，留一条回退的路，比硬升上去再救火稳妥。归档最早可以回溯到 1.0 版，三条产品线的历代版本都在。
稳定版线 · 3.x
- 3.3.6上一版稳定版，从 3.3 升级可直接替换安装
- 3.2.43.2 线的最后一个修订，接口未变动
- 3.0.9老插件仍调用 3.0 接口时留用
- 1.0.2最早公开版本，仅作问题回溯参考
长期支持线 · LTS
- LTS 2.8仍在安全修补期内，配置迁移路径完整
- LTS 2.4已转入归档，仅供存量机器重装使用
- LTS 1.6早期产线终端环境，需配套旧版运行库
企业内网线 · offline
- 3.4.0-offline当前离线包，随稳定版同步签发
- 3.3.4-offline上一版离线包，脚本模板可直接沿用
- 3.1.2-offline早期内网环境，仅覆盖 Windows 与主流 Linux
这几种情况，先别急着升级
- 现有插件依赖旧版本接口，还没拿到适配版
- 批量部署脚本只在新版本上试过一两台机器
- 产线正处在交付高峰，任何变更都要排期
出现这些信号，就该换了
- 你遇到的报错在新版本里已标为修复
- 机器换了新系统，旧版本已不在兼容范围内
- 安全修补只在新版本下发
- 想提前知道改了什么，翻一翻每周三的更新公告