# sty1

**Repository Path**: xinyuedushang/sty1

## Basic Information

- **Project Name**: sty1
- **Description**: 第一个开始仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-17
- **Last Updated**: 2026-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# uv 配置助手

一个用 Python + tkinter 写的图形化配置工具，用来一键完成 **uv** 的目录迁移、**国内镜像**切换，并**同步配置 pip**。可打包为单文件 exe 直接分发。

---

## 功能一览

| 功能 | 说明 |
| --- | --- |
| 目录配置 | 自定义 **uv 安装目录 / 缓存目录 / Python 包存储目录 / 工具目录 / 工具可执行目录**，界面上一键选择或恢复默认 |
| uv 镜像 | 自动写入国内 PyPI 索引（`[[index]]` + `default = true`），无需再手动挡 PyPI 官方源 |
| Python 下载加速 | 配置 `python-install-mirror`，让 `uv python install` 走南大 / 清华 / GitHub 代理 |
| pip 同步 | 同步写入用户级 `pip.ini`，`pip install` 也走同一个国内源 |
| 环境变量 | 写入 `UV_INSTALL_DIR`、`UV_CACHE_DIR`、`UV_PYTHON_INSTALL_DIR`、`UV_TOOL_DIR`、`UV_TOOL_BIN_DIR`、`UV_DEFAULT_INDEX`、`UV_PYTHON_INSTALL_MIRROR`，并把 uv 目录加入用户 `PATH` |
| 安全保护 | 写入前自动备份原 `uv.toml` / `pip.ini`，支持一键还原 |
| 其它 | 配置预览、检测 uv、通过国内源安装 / 更新 uv、打开相关目录 |

---

## 目录结构

```
sty1/
├── main.py                  # 程序入口
├── uvkit/
│   ├── __init__.py
│   ├── paths.py             # 平台目录与配置文件位置
│   ├── mirrors.py           # 内置国内镜像源
│   ├── settings.py          # 本工具自身的配置模型（JSON 持久化）
│   ├── win_env.py           # Windows 用户环境变量读写（注册表 + 广播）
│   ├── writers.py           # uv.toml / pip.ini 生成、备份与一键应用
│   ├── installer.py         # uv 检测与安装
│   └── gui.py               # tkinter 界面
├── uv-config-tool.spec      # PyInstaller 打包配置
├── build.bat                # 一键打包脚本
├── requirements.txt
└── README.md
```

---

## 快速开始

### 1. 源码运行

```powershell
cd sty1
python main.py
```

只依赖 Python 标准库（`tkinter` / `winreg` / `subprocess`），无需安装第三方包。

### 2. 打包为 exe

方式一，双击 `build.bat`（自动从清华源安装 PyInstaller 并打包）。

方式二，手动执行：

```powershell
python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple --upgrade pyinstaller
python -m PyInstaller --clean --noconfirm uv-config-tool.spec
```

产物：`dist\uv-config-tool.exe`（单文件、无控制台窗口，约 10 MB）。

如果需要中文名，把 `uv-config-tool.spec` 里的 `name='uv-config-tool'` 改成想要的名称后重新打包即可。

---

## 使用步骤

1. 打开程序，在**目录配置**区选择五个目录（可点「默认」使用 `%USERPROFILE%\uv\...`）。
2. 在**国内镜像源**区选择 PyPI 源（默认清华）和 Python 下载镜像（默认南京大学）。选「自定义」时可自己填地址。
3. 勾选需要生效的范围：`uv.toml`、`pip.ini`、环境变量、PATH。
4. 点「**预览配置**」确认将要写入的内容。
5. 点「**一键配置**」，确认后完成。
6. **重新打开终端 / 重启 IDE**，让新的环境变量生效。

验证：

```powershell
uv --version
uv cache dir
uv python dir
uv tool dir
pip config list
```

---

## 写入的内容

### 用户级 `uv.toml`

路径：`%APPDATA%\uv\uv.toml`

```toml
cache-dir = "C:\\Users\\me\\uv\\cache"
python-install-dir = "C:\\Users\\me\\uv\\python"
tool-dir = "C:\\Users\\me\\uv\\tool"
tool-bin-dir = "C:\\Users\\me\\uv\\bin"

python-install-mirror = "https://mirror.nju.edu.cn/github-release/astral-sh/python-build-standalone"

[[index]]
name = "tuna"
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true
```

### 用户级 pip 配置

路径：`%APPDATA%\pip\pip.ini`

```ini
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
timeout = 120

[install]
disable-pip-version-check = true
trusted-host = pypi.tuna.tsinghua.edu.cn
```

### 用户环境变量

写入注册表 `HKCU\Environment`（不是 `setx`，因此没有 1024 字符长度限制，写入后自动广播 `WM_SETTINGCHANGE`）。

| 变量 | 作用 |
| --- | --- |
| `UV_INSTALL_DIR` | uv 自身安装目录，同时加入 `PATH` |
| `UV_CACHE_DIR` | 下载与构建缓存 |
| `UV_PYTHON_INSTALL_DIR` | `uv python install` 下载的托管 Python 存放位置 |
| `UV_TOOL_DIR` | `uv tool install` 工具本体目录 |
| `UV_TOOL_BIN_DIR` | 工具可执行入口目录，同时加入 `PATH` |
| `UV_DEFAULT_INDEX` | 默认 PyPI 索引（国内镜像） |
| `UV_PYTHON_INSTALL_MIRROR` | CPython 构建产物下载镜像 |

---

## 关于优先级

uv 的配置优先级为：

```
命令行参数 > 环境变量 > 项目级 uv.toml > 用户级 uv.toml > 系统级 uv.toml
```

本工具写入的是**环境变量 + 用户级配置**。如果某个项目目录里存在自己的 `uv.toml`，那个项目的配置会覆盖本工具的设置，这是预期行为。

另外，用户级 / 系统级配置文件只能是 `uv.toml`，不能写成 `pyproject.toml`。

---

## 备份与还原

每次写入前，原文件会被复制到：

```
%APPDATA%\uv-config-tool\backup\<时间戳>\uv.toml
%APPDATA%\uv-config-tool\backup\<时间戳>\pip.ini
```

界面上的「备份」「还原备份」按钮可手动操作。本工具界面上填写的目录、镜像等设置保存在 `%APPDATA%\uv-config-tool\settings.json`。

---

## 常见问题

**Q：配置后终端里 `uv` 还是找不到？**
环境变量只对新开的进程生效，请重开终端或重启 IDE。

**Q：`uv python install` 下载失败？**
`python-install-mirror` 属于第三方 GitHub Release 镜像，偶尔会同步延迟。可在界面上切换成另一个镜像，或选择「自定义」填入可用的前缀地址，留空则回退到 GitHub 官方。

**Q：怎么恢复成官方源？**
在「PyPI 包索引源」里选 `PyPI 官方源`，Python 下载镜像选 `GitHub 官方（不加速）`，重新点「一键配置」即可。

**Q：打包后运行报缺少模块？**
请在 `uv-config-tool.spec` 的 `hiddenimports` 中补充对应模块名后重新打包。

---

## 镜像源清单

PyPI：清华 TUNA、阿里云、腾讯云、中国科学技术大学、华为云、南京大学、豆瓣（旧）、PyPI 官方，以及自定义。

CPython 构建产物：南京大学、清华 TUNA、ghfast.top、gh-proxy.com、GitHub 官方，以及自定义。