# scripts

**Repository Path**: sevenclear/scripts

## Basic Information

- **Project Name**: scripts
- **Description**: 生活中的脚本合集
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-01-21
- **Last Updated**: 2025-07-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python, bat, shell, Go语言

## README

# Scripts 工具集

这是一个实用的脚本工具集合，包含了多个用于提高日常开发和系统操作效率的脚本。

## 环境要求

- Python 3.6+
- Windows 操作系统（部分脚本支持 Linux/Mac）
- PowerShell 5.0+ (针对 PowerShell 工具)
- 网络连接（用于包安装和网络工具）

## 快速开始

1. 克隆仓库到本地
2. 安装依赖：
```bash
pip install requests pygame socket shutil -i https://pypi.tuna.tsinghua.edu.cn/simple
```

## 工具分类

### 1. 目录导航工具

#### autojump.py + j.bat
快速目录跳转组合工具，支持模糊匹配和历史记录。

功能特点：
- 智能目录匹配
- 历史路径记录
- 快速访问常用目录

使用示例：
```bash
j work          # 跳转到包含 work 的目录路径
j project       # 跳转到包含 project 的目录
j last          # 跳转到上次访问的目录
```

### 2. 文件操作工具

#### copy_files.py + run_copy_file.bat
文件批量处理工具套件。

功能特点：
- 文件均匀分配
- 自动创建子文件夹
- 保持原文件属性

使用示例：
```bash
run_copy_file.bat
# 根据提示输入子文件夹数量，如：3
```

#### generate_bat.py + generate_bat.bat
Python 脚本打包工具，将 Python 脚本转换为可执行的 bat 文件。

功能特点：
- 自动环境检测
- 支持参数传递
- 错误处理机制

使用示例：
```bash
generate_bat.bat
# 按提示输入 Python 脚本路径和目标 bat 文件名
```

### 3. 系统工具

#### 进程管理
- killchrome.bat：快速结束 Chrome 进程
- killwin.bat：结束 Windows 桌面管理器进程（需管理员权限）

#### 包管理
- pip_gfw.bat (Windows)
- pip_gfw.sh (Linux/Mac)

使用示例：
```bash
pip_gfw.bat requests  # 安装 requests 包
pip_gfw.sh pygame    # 在 Linux/Mac 上安装 pygame
```

### 4. 网络工具

#### UDP 广播工具（whereAmI.py + whoAreaYou.py）
局域网设备发现和通信工具。

功能特点：
- 支持局域网广播
- 实时消息接收
- 自动地址显示

使用方法：
```bash
# 在接收端运行
python whoAreaYou.py

# 在发送端运行
python whereAmI.py
```

#### gfw_project.py
项目依赖源配置工具。

支持项目类型：
- Maven 项目
- Gradle 项目（包括 Kotlin DSL）

功能特点：
- 自动检测项目类型
- 配置国内镜像源
- 支持多种构建工具

使用示例：
```bash
python gfw_project.py
```

### 5. 开发辅助工具

#### get-allhistory.psm1
PowerShell 历史记录管理工具。

功能特点：
- 完整命令历史
- 支持检索
- 带行号显示

使用方法：
```powershell
Import-Module .\get-allhistory.psm1
Get-AllHistory
```

#### gameball.py
Pygame 图形界面示例程序。

功能展示：
- 基础图形绘制
- 事件处理
- 窗口管理

## 最佳实践

1. 目录跳转
   - 先用 `j` 命令几次，建立历史记录
   - 使用关键字的独特部分进行跳转

2. 文件分发
   - 建议先备份重要文件
   - 合理规划子文件夹数量
   - 检查文件权限

3. 网络工具使用
   - 确保防火墙允许 UDP 广播
   - 多台设备测试时注意端口占用

## 故障排除

1. Python 环境问题
   ```bash
   python --version  # 检查 Python 版本
   pip --version    # 检查 pip 版本
   ```

2. 权限问题
   - 以管理员身份运行命令提示符
   - 检查文件访问权限

3. 网络连接问题
   - 检查防火墙设置
   - 验证网络连接状态

## 贡献指南

1. Fork 本仓库
2. 创建特性分支
3. 提交更改
4. 发起 Pull Request

## 注意事项

1. 安全性
   - 谨慎使用需要管理员权限的脚本
   - 定期更新依赖包
   - 注意网络工具的使用环境

2. 兼容性
   - 部分工具仅支持 Windows
   - 注意 Python 版本要求
   - 检查系统依赖

## 许可证

MIT License

## 联系方式

如有问题或建议，请提交 Issue 或 Pull Request。