﻿# 时区助手

Windows 10 / 11（64 位）的免安装桌面小工具。双击 `时区助手.exe` 即可运行，不需要安装 Python、Node.js 或额外的 .NET SDK。

## 功能

- 一键切换北京时间、UTC、美国西部、美国东部。
- 从 Windows 的完整时区列表中选择其他时区。
- 首次打开时自动保存当前时区；「恢复原时区」恢复这个固定备份，后续切换不会覆盖它。
- 保存、恢复原时区的夏令时开关。美国等时区正常使用当地夏令时。
- 显示当前本地时间、所选时区的时间预览、原时区及操作结果。
- 每次切换后读取 Windows 实际设置核对结果。

## 使用方法

1. 双击 `时区助手.exe`。
2. 点击一个常用时区，或选择时区后点击「切换到所选时区」。立即生效。
3. 点击「恢复原时区」，回到本账户在本电脑第一次打开软件时的时区。

普通 Windows 账户通常就有更改时区的权限。权限不足时软件会请求 Windows 管理员授权；取消授权不会被报告为成功。管理员授权需使用当前账户；另一个管理员账户或单位策略可能阻止修改，软件会显示失败原因。

软件仅修改 Windows 时区及对应夏令时开关，不修改实际 UTC 时钟、联网校时、系统语言，也不会注销或重启电脑。

如果 Windows 开启了「自动设置时区」，系统可能随后覆盖手动选择。软件会显示提醒，并可点击「打开日期和时间设置」自行关闭自动设置时区。软件不更改这项开关。

## 备份与日志

每个用户、每台电脑分别保存：

`%LOCALAPPDATA%\TimeZoneHelper\original-v1.json`

操作记录：

`%LOCALAPPDATA%\TimeZoneHelper\operations.log`

备份文件损坏或不属于当前电脑/用户时，软件会禁用切换，避免在没有可靠恢复点的情况下修改系统。保留备份文件即可持续恢复首次使用时的时区。软件不提供自动覆盖原备份的按钮。

## 构建和检查

在源码目录运行：

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\build.ps1
.\dist\时区助手.exe --self-test
.\dist\时区助手.exe --inspect
.\dist\时区助手.exe --preview .\preview.png
```

`--self-test` 在独立临时目录测试备份和切换流程，使用模拟系统接口，不修改真实系统时区。`--inspect` 只读输出真实设置。`--preview` 启动实际窗口、读取状态、生成截图并退出，不切换时区。
