# windows_tools

**Repository Path**: tin555/windows_tools

## Basic Information

- **Project Name**: windows_tools
- **Description**: windows系统一些辅助工具
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Windows Tools

一个基于Python开发的Windows辅助小工具集合，旨在提高Windows系统的使用效率和便利性。

![Python](https://img.shields.io/badge/Python-3.7+-blue.svg)
![Platform](https://img.shields.io/badge/Platform-Windows-lightgrey.svg)
![License](https://img.shields.io/badge/License-MIT-green.svg)

## 📋 项目介绍

这个项目包含了一系列实用的Windows辅助工具，使用Python开发，专门针对Windows系统的日常使用需求。每个工具都经过精心设计，力求简单易用且功能强大。

## 🛠️ 工具列表

### 1. Python版本管理工具 (`python_version.py`)

一个强大的Python版本管理器，类似于Node.js的nvm，让您能够在同一台机器上轻松管理和切换多个Python版本。

**主要功能：**
- 🔄 快速切换Python版本
- 📝 列出所有已安装的Python版本
- ⚙️ 自动配置环境变量和PATH
- 🌐 快速访问Python官方下载页面
- 🔗 使用符号链接技术，无需重复安装包

**使用示例：**
```bash
# 初始化环境（需要管理员权限）
python python_version.py --init "e:\\tools\\python" "e:\\tools\\python-uv\\"
 
# 查看所有可用版本
python python_version.py --list

# 切换到Python 3.13（需要管理员权限）
python python_version.py --use python313

# 查看当前版本
python python_version.py --current

# 打开Python下载页面
python python_version.py --download

# 打包应用
pyinstaller --onefile python_version.py --name=python_version.exe
```


**详细功能说明：**
- `--init`: 初始化环境变量和路径设置
- `--list`: 显示所有可用的Python版本
- `--use`: 切换到指定的Python版本
- `--current`: 显示当前活跃的Python版本
- `--download`: 打开Python官方下载页面
- `--help-detail`: 显示详细帮助和FAQ

## 🚀 快速开始

### 系统要求

- Windows 10/11
- Python 3.7+
- 管理员权限（用于创建符号链接）

### 安装步骤

1. **克隆项目到本地**
   ```bash
   git clone [your-repo-url]
   cd windows_tools
   ```

2. **确保Python环境**
   ```bash
   python --version
   ```

3. **开始使用工具**
   - 每个工具都是独立的Python脚本
   - 可以直接运行，无需额外依赖
   - 部分工具需要管理员权限

## 📖 详细使用说明

### Python版本管理工具详细指南

#### 初始化环境
```bash
# 以管理员身份运行命令提示符或PowerShell
# 设置符号链接路径和版本存储目录
python python_version.py --init "C:\\Python" "C:\\PythonVersions\\"
```

#### 安装多个Python版本
1. 从 [Python官网](https://www.python.org/downloads/) 下载不同版本
2. 安装到版本存储目录的子文件夹中：
   - `C:\PythonVersions\python312\` (Python 3.12)
   - `C:\PythonVersions\python313\` (Python 3.13)
   - `C:\PythonVersions\python311\` (Python 3.11)

#### 版本切换
```bash
python python_version.py --use python313  # 切换到Python 3.13
python python_version.py --use python312  # 切换到Python 3.12
```

#### 目录结构示例
```
C:\PythonVersions\          # 版本存储目录
├── python311\             # Python 3.11
│   ├── python.exe
│   ├── Scripts\
│   └── Lib\
├── python312\             # Python 3.12
│   ├── python.exe
│   ├── Scripts\
│   └── Lib\
└── python313\             # Python 3.13
    ├── python.exe
    ├── Scripts\
    └── Lib\

C:\Python\                 # 符号链接（指向当前版本）
├── python.exe -> 指向当前选中版本的python.exe
└── Scripts\ -> 指向当前选中版本的Scripts目录
```

## ⚠️ 注意事项

1. **管理员权限**：部分工具（如Python版本管理器）需要管理员权限运行
2. **环境变量**：初始化后需要重启命令提示符使环境变量生效
3. **Python版本命名**：Python版本目录名必须以'python'开头
4. **备份重要数据**：使用前建议备份重要的Python环境配置

## 🔧 故障排除

### 常见问题

**Q: 提示需要管理员权限？**
A: 右键点击命令提示符，选择"以管理员身份运行"

**Q: 环境变量没有生效？**
A: 重启命令提示符或PowerShell窗口，或重启电脑

**Q: 找不到Python版本？**
A: 确保Python安装目录名以'python'开头，且包含python.exe文件

**Q: 符号链接创建失败？**
A: 检查是否有管理员权限，且目标路径不存在同名文件夹

## 🤝 参与贡献

欢迎提交Issues和Pull Requests来改进这个项目！

### 贡献步骤

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

### 开发规范

- 遵循PEP 8代码风格
- 添加必要的注释和文档字符串
- 测试新功能的可用性
- 更新相关文档

## 📝 待办事项

- [ ] 添加更多Windows系统工具
- [ ] 支持批量操作功能
- [ ] 添加图形界面版本
- [ ] 支持配置文件管理
- [ ] 添加自动更新功能
- [ ] 国际化支持

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 🔗 相关链接

- [Python官方网站](https://www.python.org/)
- [Python下载页面](https://www.python.org/downloads/)
- [Windows命令行工具文档](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/)

## 💡 反馈与支持

如果您在使用过程中遇到任何问题或有改进建议，请通过以下方式联系：

- 提交 [Issue](../../issues)
- 发送邮件到 [your-email@example.com]
- 在项目页面留言讨论

---

**⭐ 如果这个项目对您有帮助，请给一个Star支持一下！**