vnt/vnt-desktop/README.md

VNT Desktop

基于 Tauri 2 + Vue 3 的 VNT PC 客户端。桌面端直接内置 vnt-web 的服务能力，不需要另行启动 vnt2_web。

桌面端与 Web 端共用 vnt-web/ui/src/ 下的同一套 Vue 应用、路由、状态、组件和样式。vnt-desktop/src/main.js 只负责注册 Tauri IPC 桥接，不维护第二套界面代码。

功能

• 桌面工作台：总览、实例、在线设备、路由和配置管理
• 多实例启动、停止、重启及启动日志
• 表单 / TOML 双模式配置编辑
• 原生窗口、系统托盘、单实例运行
• 关闭主窗口时隐藏到托盘，托盘菜单可彻底退出
• 深浅主题与 Ctrl/Cmd + 1~5 页面快捷键
• 响应式布局：桌面侧栏、移动端顶部栏和抽屉导航
• 桌面工作台通过 Tauri IPC 直接调用进程内 vnt-core，不监听本地 API 端口
• 可选 Web 访问：启停、端口、本机/局域网监听范围、访问令牌、打开浏览器
• Web API 强制使用 Bearer 令牌鉴权，令牌可在桌面端重新生成

桌面数据存放在系统应用数据目录的 com.vnt.desktop 下，包括 vnt_config、自启动记录、web_access.toml、日志及 Windows 下的 wintun.dll。

开发

要求：Rust、Node.js、pnpm，以及 Tauri 2 对应的系统依赖。

依赖由仓库根目录的 pnpm workspace 统一管理：

pnpm install
pnpm dev:desktop

只验证前端：

pnpm build:desktop-ui

验证 Rust 桌面模块：

cargo check -p vnt-desktop

打包

pnpm build:desktop

Windows 使用虚拟网卡模式时，可能需要以管理员身份运行。

应用图标

图标母版保存在 vnt-desktop/assets/vnt-icon-master.png。需要重新生成各平台图标时，在仓库根目录执行：

pnpm --filter vnt-desktop tauri icon assets/vnt-icon-master.png --ios-color '#4F46E5'