This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 <script setup> SFCs, check out the script setup docs to learn more.
一个基于 Tauri (Rust) + Vue3 的 Windows 托盘监控程序，实时显示 CPU 温度/占用、内存占用、网络与磁盘速率等信息。温度与风扇数据由内置的 .NET 8 传感器桥 sensor-bridge（使用 LibreHardwareMonitorLib）采集，并通过子进程与 Rust 后端通信。
- 托盘区“纯文本图标”：32x32 双行文本（上：CPU 温度或 CPU%，下：CPU% 或内存%）。
- Tooltip 与右键菜单信息区：CPU/内存/主板温度/风扇/网络/磁盘实时数据。
- 多窗口页面：详情、设置、关于（从托盘菜单打开）。
- 传感器桥自包含打包：客户机无需安装 .NET 运行时。
- 前端：Vue 3 + Vite + TypeScript
- 后端：Tauri v2（Rust）
- 传感器：.NET 8 + LibreHardwareMonitorLib 0.9.4（
sensor-bridge/）
src/前端源代码（多页面路由、详情/设置/关于）src-tauri/src/lib.rsTauri 后端：托盘、传感器桥进程、事件广播src-tauri/tauri.conf.jsonTauri 配置与打包设置sensor-bridge/.NET 8 传感器桥（输出 JSON 到 stdout）doc/progress.md进度日志；doc/项目总结与开发注意事项.md开发说明
- Node.js 18+（建议 20 LTS）
- Rust 工具链（stable；安装 rustup 与 cargo）
- .NET SDK 8.0（开发/构建时用于发布传感器桥；部署机不需要）
- 安装依赖
npm install- 启动开发（前端 + 后端）
cargo tauri dev说明：开发态下后端会尝试本地启动 sensor-bridge（优先 dll 的 dotnet <dll>，其次 exe，最后 dotnet run --project sensor-bridge）。
一键构建安装包（会自动发布自包含的桥接并纳入 Tauri 资源）：
# 推荐使用 npm 脚本（会自动发布桥接并处理代理）
npm run release:build:nsis:proxy-socks
# 或使用已有 NSIS 的本机环境
npm run release:build:nsis输出：src-tauri/target/release/bundle/ 下生成安装包（MSI/EXE，具体以 Tauri 配置为准）。
打包细节：
src-tauri/tauri.conf.json中：beforeBuildCommand会执行：dotnet publish ./sensor-bridge -c Release -r win-x64 -p:PublishSingleFile=true -p:SelfContained=true -o ./src-tauri/resources/sensor-bridge && npm run buildbundle.resources包含目录：resources/sensor-bridge，确保桥接随包分发。
- 运行时后端优先从
BaseDirectory::Resource/sensor-bridge/sensor-bridge.exe启动桥接；失败时回退到开发路径。
# 1) NSIS 安装包（通过 socks5 代理 127.0.0.1:7890）
npm run release:build:nsis:proxy-socks
# 2) NSIS 安装包（通过 http/https 代理 127.0.0.1:7890）
npm run release:build:nsis:proxy
# 3) NSIS 安装包（本机已预装 NSIS 时）
npm run release:build:nsis
# 4) 绿色便携版 ZIP（无需安装，解压即用）
npm run release:portable产物路径：
- 安装包（NSIS）：
src-tauri/target/release/bundle/nsis/*.exe - 便携版 ZIP：
dist-portable/sys-sensor-portable.zip
若需手动查看产物：
npm run bundle:ls
npm run portable:ls- 必装环境：
- Node.js 18+（推荐 20 LTS）
- Rust 工具链（stable，MSVC）
- .NET SDK 8.0（仅用于构建桥接；客户机无需 .NET）
- WebView2 Runtime（多数 Win10/11 已自带）
- 清理遗留进程（避免占用）：
taskkill /F /IM sys-sensor.exe /IM sensor-bridge.exe /IM dotnet.exe- 如需发布新版本，修改
src-tauri/tauri.conf.json的version。
cargo tauri build过程会自动：
dotnet publish ./sensor-bridge到src-tauri/resources/sensor-bridge/，产出自包含单文件sensor-bridge.exe；- 前端
npm run build； - 将
resources/sensor-bridge随安装包打入。
构建产物目录：src-tauri/target/release/bundle/（包含 .msi 与/或 .exe）。
- 将
.msi或.exe拷贝到客户电脑，双击安装。 - 首次运行后最小化到托盘。正常日志应见：
[bridge] spawning packaged exe:（表示从资源目录启动桥接）。
- 无需安装 .NET（桥接为自包含）。
- 建议安装 WebView2 Runtime（若系统无）。
- 若安全软件拦截
sensor-bridge.exe，请加入信任/白名单。 - 某些机型（如 Intel NUC8）读取主板/风扇可能需要“以管理员身份运行”。
- 在干净环境（虚拟机或 Windows Sandbox）安装并运行安装包：
- 托盘数据（CPU/内存/温度/风扇）正常刷新；
- 日志包含“spawning packaged exe”；
- 若温度/风扇为空，尝试管理员权限运行。
- 为消除 SmartScreen 提示，准备代码签名证书并按 Tauri 文档配置 Windows 签名再打包。
- 企业环境可用 SCCM/Intune 等分发
.msi/.exe。
- 在线打包时 Tauri 需从 GitHub 下载 NSIS/WiX 等二进制工具，如遇下载失败：
- 已提供代理脚本：
release:build:nsis:proxy（http 代理）、release:build:nsis:proxy-socks（socks5 代理）。 - 系统已开启的 System Proxy/TUN 也会被尊重。
- 已提供代理脚本：
- 或者预装依赖后再打包（推荐至少装 NSIS）：
# 安装 NSIS（用于 .exe 安装包）
winget install -e --id NSIS.NSIS
# 如切换到 MSI 目标（WiX），再安装 WiX（当前配置默认 NSIS，无需安装 WiX）
winget install -e --id WixToolset.WixToolsetclean:proc：结束遗留的 sys-sensor/sensor-bridge/dotnet 进程。clean:cargo：结束 cargo/rustc 进程。bridge:publish：发布自包含桥接到src-tauri/resources/sensor-bridge/。release:build:nsis：一键清理->发布桥接->Tauri 打包(NSIS)->打开目录。release:build:nsis:proxy：同上，启用 HTTP(S) 代理 127.0.0.1:7890。release:build:nsis:proxy-socks：同上，启用 socks5 代理 127.0.0.1:7890。release:portable：一键产出绿色便携版 ZIP。bundle:ls/portable:ls：列出产物文件。
- 首次运行将最小化到托盘；托盘图标每秒刷新文本。
- 右键菜单可打开“显示详情 / 快速设置 / 关于我们”，再次点击同一项会聚焦已有窗口。
- 关闭窗口仅隐藏（托盘“退出”才真正退出）。
- 路由已内置：
/floating（悬浮窗）、/edge（贴边面板）。对应组件分别为src/views/Floating.vue与src/views/EdgePanel.vue，均订阅实时聚合事件以展示核心 KPI。 - 开发态访问方式：
- 主窗口地址栏（或开发服务器浏览器）进入：
#/floating、#/edge - 例如：
http://localhost:1420/#/floating或http://localhost:1420/#/edge
- 主窗口地址栏（或开发服务器浏览器）进入：
- 交互说明（建议）：
- 悬浮窗：半透明深色背景，显示 CPU/内存/网络/GPU 等关键指标，适合置顶悬浮。
- 贴边面板：支持收起/展开，显示 CPU/内存/磁盘 R/W、网络、GPU 等指标。
- 后续将与后端窗口命令联动（创建/置顶/贴边/显示隐藏）并统一动画。
- 事件主题：
- 主聚合事件：
sensor://agg（历史别名：sensor://snapshot）。前端应优先订阅sensor://agg。 - 配置变更事件：
config://changed（保存后广播）。
- 主聚合事件：
- 命名风格：
- JSON/事件负载字段：camelCase（示例：
diskQueueLen、netRxBps）。 - Rust 对外序列化：
#[serde(rename_all = "camelCase")]；内部保持 snake_case。 - TypeScript/Vue：类型与组件 PascalCase；变量/字段 camelCase；模板 props 与 CSS 类 kebab-case。
- 单位后缀约定：
*_ms、*_bps、*_pct、*_mb、*_mhz、*_w、*_v。
- JSON/事件负载字段：camelCase（示例：
- Rust 快速校验：
cargo check
- 提示：IDE 中显示
canceled亦代表命令结束，可视为完成（非异常退出）。
- 提示：IDE 中显示
- 结束遗留进程避免占用：
taskkill /F /IM sys-sensor.exe /IM sensor-bridge.exe /IM dotnet.exe
- 代理/依赖下载问题：优先使用提供的一键脚本（见“网络/代理与依赖问题处理”与“脚本清单”章节）。
# 结束遗留调试进程（避免端口/句柄占用）
taskkill /F /IM sys-sensor.exe /IM sensor-bridge.exe /IM dotnet.exe
# 仅发布桥接（可选，通常由打包流程自动执行）
dotnet publish ./sensor-bridge -c Release -r win-x64 -p:PublishSingleFile=true -p:SelfContained=true -o ./src-tauri/resources/sensor-bridge
# 打包安装包（Release 交付）
cargo tauri build
# 检查 Rust 端构建
cargo check
# 前端构建（被 beforeBuildCommand 调用）
npm run build- 进度：
doc/progress.md - 开发说明：
doc/项目总结与开发注意事项.md
-
管理员权限与可用性：
- 在 Intel NUC8（NUC8BEB/i7-8559U）上，普通权限下 CPU 温度/风扇多为“—”；管理员权限下 CPU 温度有值；风扇 RPM 依然无值（多数 NUC 平台不经标准接口公开 RPM）。
- 应用已在生产态自动请求 UAC 提权；开发态会跳过提权以避免 dev server 中断。
-
回退显示策略：
- RPM 可用时优先显示 CPU 风扇 RPM；无 RPM 时回退机箱风扇 RPM；若仍无，则回退显示风扇占空比或 CPU%。托盘、Tooltip、详情页三处已统一。
-
现场快速诊断步骤（管理员 PowerShell 执行）：
- 进入桥接目录：
Set-Location C:\code\sys-sensor\sensor-bridge
- 运行管理员脚本（或直接运行发布版 exe）：
powershell -NoProfile -ExecutionPolicy Bypass -File .\run-bridge-admin-exe.ps1 # 或： $env:BRIDGE_TICKS=12 .\bin\Release\win-x64\publish\sensor-bridge.exe 1> bridge.admin.out.jsonl 2> bridge.admin.err.txt
- 检查输出：
Get-Content .\bridge.admin.out.jsonl -Tail 40 Get-Content .\bridge.admin.err.txt -Tail 200
- 期望：
{"isAdmin":true,"hasTemp":true,"hasTempValue":true,"hasFan":false,"hasFanValue":false}，stderr 中可见 CPU 温度条目；风扇条目通常缺失。
- 期望：
- 进入桥接目录：
-
常见问题与提示：
- WMI 温度在普通权限下可能报
PermissionDenied (0x80041003)；Win32_Fan常见无Speed/DesiredSpeed值。 - 若安全软件拦截
sensor-bridge.exe，请加入白名单。 - 若无 WebView2 Runtime，请按提示安装运行库。
- WMI 温度在普通权限下可能报