# UVUI **Repository Path**: a15292350166/UVUI ## Basic Information - **Project Name**: UVUI - **Description**: UVUI —— uv 工具箱的 Windows 11 风格图形界面(Python + TkWin11) - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-10-30 - **Last Updated**: 2026-10-31 ## Categories & Tags **Categories**: Uncategorized **Tags**: shell, Python, nuikat, UV, uvtools ## README # UVUI · UV 工具箱 > 把 uvui.bat 重写成 Windows 11 风格的图形界面:**Python + TkWin11**,一键运行 uv 的日常操作。 ![UVUI 概览](docs/images/home.png) UVUI 是 [uv](https://github.com/astral-sh/uv)(Python 包与环境管理器)的桌面工作台,界面支持**简体中文 / English 实时切换**。它把 uvui.bat v1.5.0 里的 A/B/C/D/E/M/H/F 菜单原样搬到图形界面里它把 uvui.bat v1.5.0 里的 A/B/C/D/E/M/H/F 菜单原样搬到图形界面里:环境检测、虚拟环境、依赖管理、Python 版本、项目工具、构建发布、镜像源与 PATH 维护,全部点点鼠标完成,命令输出实时滚动在窗口底部,可复制、可取消。 ## 为什么重写 | uvui.bat 的痛点 | UVUI 的做法 | | --- | --- | | 一层层输入字母回车,找不到位置 | 左侧导航分组,一屏看全所有功能 | | 黑框输出,无法回看和复制 | 深色日志面板,滚动、复制、清空、收起 | | 环境状态靠 H 菜单反复检查 | 工具条实时显示 uv / Python 就绪状态与 PATH 归属 | | 命令跑在哪个目录说不清 | 全局「工作目录」选择器,所有命令按它执行 | | 镜像源只能靠记忆开关 | 镜像页展示会话 / 永久值来源,一键切换与恢复 | | 出错就一闪而过 | 退出码、耗时、失败原因都写进日志与状态栏 | ## 功能一览 | 页面 | 对应 uvui.bat | 内容 | | --- | --- | --- | | 概览 | — | 环境状态、快速开始、当前 PyPI 镜像 | | 核心操作 | [A] Core Ops | uv 版本与位置、已安装 Python、创建 .venv、按 requirements 安装、uv add、uv sync、uv run | | 依赖管理 | [B] Dependencies | uv pip list、过期包、依赖树、深度 / 反查、导出 requirements、卸载 | | Python 版本 | [C] Python Version | 版本列表、安装、升级、卸载(含 ALL)、pin | | 项目与工具 | [D] Project·Tools | uv init、tool install、uvx、tool list、缓存目录 / 清理、self update | | 构建与发布 | [E] Build·Publish | build、sdist / wheel、--out-dir、publish、TestPyPI、lock / upgrade / check | | 镜像源 | [M] Mirrors | 查看配置、PyPI 会话 / 永久镜像、Python 下载镜像(淘宝 / 官方 / 自定义 GitHub 代理)、恢复官方源 | | 环境检查 | [H] Env Check | 完整检查、追加 uv / Python 目录到用户 PATH、安装 uv、安装 Python | | 关于 | [F] + 版权 | 版本、作者、许可、界面语言切换、配置目录 | ## 界面一览 | 核心操作 | 依赖管理 | | --- | --- | | ![核心操作](docs/images/core.png) | ![依赖管理](docs/images/deps.png) | | 镜像源 | 环境检查 | | --- | --- | | ![镜像源](docs/images/mirrors.png) | ![环境检查](docs/images/env.png) | 英文界面: | 概览 | 核心操作 | | --- | --- | | ![Overview](docs/images/home-en.png) | ![Core operations](docs/images/core-en.png) | | 镜像源 | 关于 | | --- | --- | | ![Mirrors](docs/images/mirrors-en.png) | ![About](docs/images/about-en.png) | ## 环境要求 > 两种分发形态:`UVUI.exe`(单文件,要求管理员权限,带 UAC 盾牌)与 `UVUI.msix`(Microsoft Store 规范的打包应用,普通权限运行,不自带提权)。 - Windows 10 1809+ / Windows 11 - 运行时:**无需 Python**(EXE / MSIX 自带解释器,Nuitka 打包) - 源码运行:Python 3.11+(开发使用 3.12),仅标准库 + 随仓库的 tkwin11 - 功能依赖:uv(UVUI 可以直接帮你安装) - 构建:Nuitka 4.x、Pillow 与 resvg-py(把 SVG 图标光栅化)、Windows 10/11 SDK(makeappx / signtool) ## 使用 ### 方式一:直接运行 exe 从 [发行版](https://gitee.com/a15292350166/UVUI/releases) 下载 `UVUI.exe` 双击即可,免安装;文件图标右下角带 UAC 盾牌,启动时系统会请求管理员权限(维护用户 PATH、写注册表需要)。也可以浏览 [release 分支](https://gitee.com/a15292350166/UVUI/tree/release) 的 `dist` 目录。 ### 方式二:安装 MSIX 先信任随包的 `UVUI.cer`(本地计算机 → 受信任人),再双击 `UVUI.msix`,或: ```powershell Add-AppxPackage -Path .\UVUI.msix ``` ### 方式三:源码运行 ```powershell python main.py # 打开概览 python main.py --page env # 直接打开环境检查页 ``` 首次启动会探测 uv / Python。如果 uv 还没安装,进入「环境检查」页点「安装 uv」,完成后点「追加 uv 目录」写入用户 PATH,再点「刷新环境」。 工作流程示例: 1. 在工具条选择项目目录(或点「选择目录」)。 2. 「核心操作 → 创建虚拟环境 .venv」。 3. 「核心操作 → 添加依赖」,填 `requests numpy`。 4. 「构建与发布 → 构建(sdist + wheel)」,产物在 `dist`。 5. 需要国内加速时去「镜像源」选清华源,勾选「仅本次会话」或「永久写入用户环境」。 6. 需要自定义 GitHub 代理时,在「设置 Python 下载镜像」下方填写代理前缀(例如 `https://gh-proxy.com/`),点「使用自定义代理」,UVUI 会拼成 `代理前缀 + 官方 python-build-standalone 地址` 写入 `UV_PYTHON_INSTALL_MIRROR`。 ## 界面说明 - **标题栏**:一体化 Fluent 标题栏,支持拖动、贴靠、最大化与边缘缩放。 - **工具条**:工作目录、选择 / 打开目录、刷新环境、uv 与 Python 状态胶囊。 - **侧栏**:按 uv 工具与配置分组,键盘方向键可导航。 - **任务输出**:深色等宽日志,显示执行的命令行(令牌自动打码)、实时输出、退出码与耗时;「复制 / 清空 / 收起」;输出按帧批量写入(实测约 5 万行/秒),日志超过 4000 行自动裁剪旧内容。 - **状态栏**:当前动作、运行中进度、取消按钮、版本号。 快捷键:`F5` 刷新环境,`Ctrl+L` 清空日志,`Ctrl+,` 打开关于。界面语言在「关于 → 界面语言」切换,立即生效并记住选择,重启后保持。 ## 与 uvui.bat 的逐项对照 | uvui.bat | UVUI | | --- | --- | | A-1 `uv --version` + `where uv` | 核心操作 → uv 版本与位置 | | A-2 `uv python list --only-installed` + `uv python find` | 核心操作 → 已安装的 Python | | A-3 `uv venv [--python X]` | 核心操作 → 创建虚拟环境 .venv | | A-4 `uv pip install -r` | 核心操作 → 按 requirements.txt 安装 | | A-5 `uv add` | 核心操作 → 添加依赖 | | A-6 `uv sync` | 核心操作 → 同步项目 | | A-7 `uv run` | 核心操作 → 运行脚本 | | B-1..B-6 | 依赖管理页对应卡片 | | C-1..C-5 | Python 版本页对应卡片 | | D-1..D-7 | 项目与工具页对应卡片 | | E-1..E-9 | 构建与发布页对应卡片 | | M-1..M-7 | 镜像源页 | | H-1..H-5 | 环境检查页 | | F `uv --help` | 关于页「查看 uv 帮助」(输出到日志) | 完整说明见 [docs/USER-GUIDE.md](docs/USER-GUIDE.md),设计与模块划分见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)。 ## 项目结构 ``` UVUI/ main.py 启动入口(--page 可直达某页) uvui/ 应用包 app.py 主窗口、任务调度、事件分发 i18n.py 中英文文案与运行时切换 pages.py 各功能页 catalog.py uv 命令目录与输入校验 envcheck.py 环境检测、用户 PATH / 环境变量 runner.py 子进程流式执行器 widgets.py 命令卡片、日志面板、通用控件 theme.py 补充样式 config.py 配置持久化 version.py 版本号读取 tkwin11/ Windows 11 Fluent 控件库(随仓库,MIT) assets/ SVG 图标源文件与生成的 ICO / PNG packaging/ MSIX 清单与磁贴资源 tools/ 图标 / 打包 / 发版脚本 tests/ 单元与集成测试(32 项) docs/ 用户手册、架构说明、截图 ``` ## 测试 ```powershell python -m unittest discover -s tests -v ``` 32 项测试覆盖命令参数拼装与校验、PATH 判断、子进程流式执行与取消、令牌打码、中英文案覆盖(含环境结论)与 GitHub 代理拼接。 ## 构建与发版 见 [BUILD.md](BUILD.md)。一条命令: ```powershell .\tools\build_all.ps1 -Version 2.0.0.0 ``` 产物:`dist\UVUI.exe`、`dist\UVUI.msix`、`dist\UVUI.cer`。 ## 常见问题 **提示「未找到 uv」**:到「环境检查」页点「安装 uv」,装完点「追加 uv 目录」,再刷新环境。 **新开的终端里找不到 uv**:用户 PATH 没写入。环境检查页「追加 uv 目录」会安全追加(已存在则跳过)。 **命令报「找不到 pyproject.toml」**:工具条的工作目录不是项目目录;点「选择目录」切过去。 **MSIX 安装失败 0x800B0109**:证书未被信任。双击 `UVUI.cer` 安装到「本地计算机 → 受信任人」,或换正式签名证书。 **日志中文乱码**:UVUI 会先按 UTF-8 解码,失败再按 GBK;若仍异常,请在「任务输出」里复制内容反馈。 ## 许可与致谢 - 本项目:MIT License,© 温宿县钦诺网络科技工作室(Wensu Qinnuo Network Technology Studio) - 作者:Jiangmen.pro —— uvui.bat 与本程序由同一位开发者维护 - 界面框架:[TkWin11](https://github.com/bvb6417/tkwin11)(MIT),已随仓库包含 - 包管理器:[uv](https://github.com/astral-sh/uv)(Apache-2.0 / MIT) - 原始脚本:uvui.bat v1.5.0,作者 Jiangmen.pro