# DeskWidget

**Repository Path**: chyrep/desk-widget

## Basic Information

- **Project Name**: DeskWidget
- **Description**: 一个专注于桌面小工具开发的开源项目，提供多种实用组件，支持自定义与扩展，旨在提升用户桌面使用体验。
- **Primary Language**: Rust
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-11
- **Last Updated**: 2026-02-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# desk-widget

一个独立的桌面小组件应用（Windows），支持：

- 系统托盘常驻
- 透明置顶小组件窗口（默认鼠标穿透，悬停按住 Ctrl/Alt 解锁交互）
- 拖拽移动并记住位置
- 本地指标（CPU / 内存 / 网络）
- 云驿用量展示（支持多个 Key 轮播）

## 环境准备（Windows）

- Rust：安装 Rustup（推荐 stable），确保 `rustc -V`、`cargo -V` 可用
- 构建工具：安装 Visual Studio 2022 或 Build Tools，并勾选「使用 C++ 的桌面开发」（包含 MSVC、Windows SDK）
- Node.js + Yarn：安装 Node.js LTS（建议 >= 18），安装 Yarn Classic（1.x）
- WebView2：Windows 10/11 通常已自带；若运行时提示缺少 WebView2，请安装 Microsoft Edge WebView2 Runtime
- WiX Toolset：用于打包 MSI，确保 WiX 的 `candle.exe` / `light.exe` 在 PATH 中

## 开发

```bash
yarn
yarn tauri:dev
```

## 构建（MSI）

```bash
yarn
yarn tauri:build
```

构建产物默认输出在：

`src-tauri/target/release/bundle/msi/`

## 云驿用量（重要）

- 严禁将「刷新频率」设置过短：过高频率会对服务端造成压力，极端情况下可能导致服务端异常/宕机
- 建议刷新频率 >= 60 秒（应用端会强制最小 30 秒）
- 配置多个 Key 时，每次刷新会对每个 Key 分别请求一次；Key 越多请求越多，请合理提高刷新频率
- “测试/立即刷新”请勿频繁点击，尤其是多人/多设备共用同一 Key 的情况下

## 配置文件

配置文件保存在应用数据目录下，文件名为 `desk-widget.config.json`，包含：

- `desktop_widget_settings`：小组件设置
- `yunyi_api_keys`：云驿 Key 列表

> 说明：为实现最小化独立移植，当前 Key 以明文形式存储在本机配置文件中，请自行做好分发与安全约束。