安装部署
当前为公测（Beta）阶段。Release 提供 Windows（amd64 / arm64）、Linux（amd64 / arm64）与 macOS（arm64）发行包；容器化部署请参阅 Docker 项目说明。
下载与运行（Windows）
- 在 GitHub Releases 获取与你的平台和架构相符的最新公测包。
- 完整解压到一个固定文件夹（路径建议不含特殊字符），不要放在系统临时目录中，也不要在压缩包里直接双击程序。
- Windows 请双击
dice-next.exe启动；Linux/macOS 请执行包内启动脚本或核心程序。首次启动会自动生成config/与数据目录。 - 程序默认不显示窗口，直接最小化到系统托盘（右下角弹气泡提示）。右键托盘图标可「打开网页面板 / 显示控制台 / 打开应用目录 / 退出」。
- 打开管理面板：托盘右键 →「打开网页面板」，或浏览器访问
http://localhost:18088。
压缩包内已附带常见运行库（VC++ 运行时），一般无需额外安装；仅支持 64 位 Windows 10 / 11。
临时目录启动限制
从 build 926 起，Windows 启动器和核心程序会检查程序目录及实际运行目录。若位于系统临时目录或其子目录，会拒绝启动并弹出中英双语提示，避免配置与数据留在随时可能被清理的目录中。请先完整解压到固定目录，再启动 dice-next.exe。
端口说明
默认端口 18088（可在 config/server.json 的 port 修改）。若端口被占用，启动时会自动顺延到下一个可用端口并写回配置——此时用托盘的「打开网页面板」总能打开正确地址。
单实例
同一套数据（同一个程序目录）只能运行一个进程，重复启动会自动退出，避免数据冲突。详见故障排查。
验证安装
启动后访问：
- 管理面板：
http://localhost:18088 - 状态检查：
http://localhost:18088/api/system/status
如果管理面板能打开，说明服务已正常运行。建议先在管理面板的 WebUI 设置里设置一个登录密码，然后去快速开始接入你的 QQ 机器人。
开机自启
管理面板 → 系统设置里可开启开机自启动（随 Windows 登录自动启动，仅 Windows）。无需再手动配置任务计划。
升级
管理面板自动更新
打开管理面板 → 关于项目 → 检测与自动更新：
- 点“立即检查”，程序从 GitHub Release 的
update-manifest.json获取最新版本与当前平台安装包。 - 默认“自动选择”会并行探测 GitHub 直连和内置镜像；中国大陆网络不稳定时会自动采用先成功的镜像，也可强制仅镜像或填写可信的自定义 HTTPS 镜像。
- 点“下载更新”后，程序核对清单仓库、平台、架构、文件名、文件大小与 SHA-256。Windows 还会在解压前检查路径穿越和包结构。
- Windows 使用
dice-next.exe启动时，可点“安装并重启”。管理器事务式替换程序、运行库、WebUI、文档与内置资源；任一步失败都会按相反顺序恢复旧版。
右上角的版本文字可直接打开更新区域，有新版本时显示红色 New。下载阶段支持取消：等待“已取消”后可重试；连续 60 秒无新增数据或单个来源尝试超过 20 分钟时会终止本次传输，并按配置换源。失败 / 取消只清理本次未完成文件，不要求重启程序。校验和 Windows 安装准备阶段也可取消，但已经开始的正式安装不能取消。
网页请求超时并不代表后台任务停止，应等待面板重新获取状态，或点击刷新状态后再操作。Linux / macOS 仍需手动安装下载好的更新包，新增取消功能没有改变安装支持范围。
自动检查默认开启、间隔 6 小时、发现更新后仅通知。你可以改为自动下载；“自动安装并重启”只有 Windows 管理器模式可选。Linux、macOS 或直接运行核心时，可自动检查 / 下载，但暂不原地安装。容器部署只检查并通知，不下载或安装程序更新；请拉取新镜像并重新创建容器。
Windows 管理器模式还可开启定时安装：先下载并校验更新包，在指定时间主动重启安装，初始时间为 04:00。时间按服务器设置计算，面板显示具体日期和 UTC 偏移；下载完成时当天时间已过，则安排到次日。自动安装开启且包已就绪时，任何提前发生的重新启动都会顺带安装，包括手动重启、退出后再次打开、系统重启和守护进程拉起。定时仅限制程序主动发起的重启。修改时间或时区会重新安排；关闭定时只取消主动重启计划。若想保留下载包却不在启动时安装，请改为“仅下载”或“仅通知”；仍可手动安装。
容器升级
官方镜像带有明确的容器标记，程序也会用 Docker / Podman 标记、Kubernetes 环境变量和 cgroup 信息兜底识别。检测到容器后，WebUI 会禁用手动与自动下载 / 安装，但版本检查仍可使用。Compose 部署可执行 docker compose pull dice-next，再执行 docker compose up -d --force-recreate dice-next；挂载的 config/ 与 data/ 会保留。
镜像信任边界
SHA-256 可以发现下载中断、损坏或清单与安装包不一致，但不是独立的发行签名。选择内置或自定义镜像代表信任该来源；对供应链要求较高时，请使用“仅 GitHub”，并在 Release 页面核对版本。
手动升级
也可以从 GitHub Releases 下载对应平台的新包，停服后完整覆盖程序文件——exe、运行库、i18n/、web/dist/、docs/ 与包内内置资源都需要更新。
个人数据不会被安装包清空：
- 配置目录
config/不在发行包内； data/下的数据库、跑团日志、媒体与用户自建资源会保留；- 内置
data/helpdoc会随版本刷新，data/plugins采用覆盖内置文件但保留其他文件的方式更新。
升级前仍建议从管理面板制作备份，或手工备份 config/ 与 data/。
将管理面板安装为应用
WebUI 提供应用清单与图标。打开要管理的服务器地址后，可使用浏览器提供的安装入口：Chrome / Edge 地址栏图标或菜单中的安装应用；macOS Safari 的“添加到程序坞”；移动端浏览器的“添加到主屏幕”。入口是否出现及名称由浏览器决定。
使用 HTTPS，或本机 http://localhost:端口 / http://127.0.0.1:端口。普通 HTTP 局域网 / 公网地址可能不显示推荐安装入口，不要为此关闭浏览器安全限制。
安装的只是当前地址的管理面板独立窗口，不会安装或后台启动机器人后端。后端仍需运行，登录校验不变；没有 Service Worker、离线管理或管理 API 缓存。服务器地址改变后需从新地址重新安装。
从源码构建
需要自行编译（CMake + vcpkg + MSVC）请参考从源码构建。