# VeilTime

**Repository Path**: Ez17Code/VeilTime

## Basic Information

- **Project Name**: VeilTime
- **Description**: VeilTime 是一款面向 Windows 桌面的透明悬浮时钟应用，强调轻盈、安静、低占用和长期陪伴感。

它使用 C#、.NET 10 和 Avalonia UI 构建，采用 MVVM 架构，并以单文件、自包含、可直接分发为目标进行发布优化。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-22
- **Last Updated**: 2026-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# 🕰️ VeilTime (轻纱时钟)

**一款面向 Windows 桌面的纯净、异形、沉浸式悬浮时钟**

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![.NET](https://img.shields.io/badge/.NET-10.0-512BD4.svg)](https://dotnet.microsoft.com/)
[![Avalonia](https://img.shields.io/badge/Avalonia-11.x-purple.svg)](https://avaloniaui.net/)
[![Platform](https://img.shields.io/badge/platform-Windows-0078D6.svg)]()

[功能特性](#✨-核心特性) • [安装使用](#🚀-快速开始) • [用户指南](Docs/user-guide.md) • [常见问题](Docs/faq.md) • [参与贡献](#🤝-参与贡献)

</div>

---


VeilTime 是一款用 C# 和 Avalonia UI 精心打造的 Windows 桌面时钟应用。它不仅抛弃了传统窗口的边框与背景，实现了真正的“异形透明”，还深度集成了 Windows 底层 API，为您带来如轻纱般无缝融入桌面的长期陪伴感。

![VeilTime 主界面](Docs/Archive/snapshot/VeilTime_main.png)


## ✨ 核心特性

- 👻 **极致沉浸**：纯透明异形窗口，支持 `悬浮顶层模式`（置顶）与 `沉浸桌面模式`（完美附着桌面，**免疫 Win+D** 快捷键）。
- 🎨 **主题预设**：内置 5 款精心调校的资源字典主题（默认轻纱蓝、深色/浅色背景增强、暖色护眼、高对比），秒级无缝换肤。
- 🖱️ **不干扰工作**：支持"鼠标穿透"，开启后点击直接作用于下层窗口，时钟宛如刻在屏幕玻璃上。
- 📊 **硬件监控**：内置极简 CPU 与 RAM 占用率监视器，负载高低颜色自适应警示。
- ⏱️ **手势操控组件**：通过直接在表盘上拖拽，优雅且直观地设定**倒计时**与**闹钟**。
- 🔔 **整点空灵报时**：整点时发出轻柔的提示音，优雅提醒时间流逝。
- 🖥️ **开机自启动**：勾选后可在 Windows 登录时自动静默启动，无需手动运行。
- 🌙 **防烧屏屏保**：支持一键注册为 Windows 系统屏幕保护程序，纯黑背景动态漂浮，保护 OLED 屏幕。
- ⚡ **单文件发布**：支持 .NET AOT/自包含发布，体积小巧，零依赖，开箱即用。


### 主题展示

![默认轻纱蓝](Docs/Archive/snapshot/VeilTime_main_2.png)
![深色背景增强](Docs/Archive/snapshot/主题-深色背景.png)
![浅色背景增强](Docs/Archive/snapshot/主题-浅色增强.png)
![暖色护眼](Docs/Archive/snapshot/主题-暖色护眼.png)
![高对比度](Docs/Archive/snapshot/主题-高对比度.png)

### 倒计时与闹钟

![倒计时设置](Docs/Archive/snapshot/倒计时-设置.png)
![倒计时运行中](Docs/Archive/snapshot/倒计时-运行中.png)
![闹钟设置-时钟](Docs/Archive/snapshot/闹钟设置-时钟.png)
![闹钟设置-分钟](Docs/Archive/snapshot/闹钟设置-分钟.png)
![闹钟运行中](Docs/Archive/snapshot/闹钟运行中.png)

### 屏保功能

![屏保安装](Docs/Archive/snapshot/屏保安装-1.png)
![屏保设置预览](Docs/Archive/snapshot/屏保设置-预览.png)
![屏保设置确定](Docs/Archive/snapshot/屏保设置-确定.png)


## 🚀 快速开始

### 针对普通用户
1. 前往 Releases 页面下载最新版的 `VeilTime.exe`。
2. 双击即可运行，无需安装环境。
3. 右键点击时钟表盘或系统托盘图标，即可打开设置菜单。
4. 详细操作请参阅 [**用户使用指南**](Docs/user-guide.md)。

### 针对开发者
本项目使用 C# 12 和 .NET 10 编写，UI 框架采用 Avalonia。

```powershell
# 克隆仓库
git clone https://github.com/YourName/VeilTime-open-source.git
cd VeilTime-open-source

# 还原依赖并运行
dotnet restore
dotnet run
```

#### 发布独立可执行文件
```powershell
# 将项目发布为不依赖系统 .NET 环境的单文件可执行程序
dotnet publish -c Release -r win-x64
```
发布的最终文件将位于：`bin\Release\net10.0\win-x64\publish\`。
更详细的构建指南请参阅 [build.md](Docs/build.md)。

## 🏗️ 架构概览

VeilTime 严格遵循 **MVVM (Model-View-ViewModel)** 架构模式，确保 UI 与业务逻辑的彻底解耦：
- **`Views/` & `ViewModels/`**：界面渲染与状态驱动。绝不在 View 层进行业务计算，绝不在 ViewModel 层引入具体的 UI 框架组件（如 `IBrush`, `Avalonia.Point`）。
- **`Services/`**：系统互操作层。所有平台相关的副作用（如开机自启注册表、Win32 窗口层级提权、音频播放）全部收口在服务层。
- **`Assets/Themes/`**：基于 Avalonia `ResourceDictionary` 的动态主题库。

完整的架构与编码规范请参阅 [架构与编码约束指南](Docs/architecture-guidelines.md)。

## 📚 文档导航

- 📖 [用户使用指南 (User Guide)](Docs/user-guide.md)
- ❓ [常见问题解答 (FAQ)](Docs/faq.md)
- 🛠️ [构建与发布指南 (Build)](Docs/build.md)
- 🏛️ [架构与编码规范 (Architecture)](Docs/architecture-guidelines.md)
- 📋 [跨会话交接文档 (Session Handoff)](Docs/session-handoff.md)

## 🤝 参与贡献

我们非常欢迎任何形式的贡献！无论是一个小小的 Bug 修复、文档拼写纠正，还是全新的功能提案。
在提交 Pull Request 之前，请先阅读我们的 [CONTRIBUTING.md](CONTRIBUTING.md)。

1. Fork 本仓库
2. 创建您的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交您的更改 (`git commit -m 'feat: Add some AmazingFeature'`)
4. 将您的更改推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启一个 Pull Request

## 📄 许可证

本项目基于 [MIT 许可证](LICENSE) 发布，您可以自由地使用、修改和分发。