# 工具脚本集合

本目录包含各种通用工具脚本，用于提供基础功能和辅助其他脚本运行。

## 目录结构

```
utils/
├── README.md           # 本文档
├── common.sh          # 通用shell函数库
└── check_user.sh      # 用户权限检查工具
```

## 脚本说明

### common.sh

通用shell函数库，提供了各种常用的shell函数。

#### 功能
- 日志管理
  - `setup_logging`: 设置日志系统
  - `log_info`: 记录信息日志
  - `log_warn`: 记录警告日志
  - `log_error`: 记录错误日志
  - `log_success`: 记录成功日志

- 进度显示
  - `show_progress`: 显示进度条
  - `update_progress`: 更新进度

- 网络管理
  - `check_network`: 检查网络连接
  - `get_mirror_url`: 获取镜像源URL

- 配置管理
  - `manage_config`: 管理配置文件
  - `manage_plugin`: 管理插件

- 依赖管理
  - `check_dependencies`: 检查依赖
  - `install_base_dependencies`: 安装基础依赖

- 用户交互
  - `confirm`: 用户确认提示
  - `get_user_info`: 获取用户信息

- 文件管理
  - `download_file`: 下载文件
  - `manage_path`: 管理PATH环境变量
  - `manage_alias`: 管理命令别名

#### 使用方法
```bash
# 在脚本中引入
source ./utils/common.sh

# 使用函数
log_info "开始安装..."
show_progress "安装进度" 0
```

### check_user.sh

用户权限检查工具，用于检查脚本运行环境和权限。

#### 功能
- 检查root权限
- 检查用户信息
- 检查系统环境
- 检查必要命令

#### 使用方法
```bash
# 在脚本中引入
source ./utils/check_user.sh

# 检查权限
check_root
```

## 依赖要求

- Debian/Ubuntu系统
- bash shell
- 基本系统工具（curl, wget等）

## 使用建议

1. 在脚本开头引入需要的工具脚本
2. 使用提供的函数而不是直接实现功能
3. 遵循错误处理和日志记录规范
4. 使用进度显示提供更好的用户体验

## 注意事项

- 确保脚本有执行权限
- 注意函数的依赖关系
- 正确处理错误情况
- 保持日志记录的完整性

## 常见问题

1. 如果函数未定义，检查是否正确引入了脚本
2. 如果权限检查失败，确保使用sudo运行
3. 如果网络检查失败，检查网络连接
4. 如果日志记录失败，检查日志目录权限

## 更新日志

### v1.0.0 (2024-03-xx)
- 初始版本发布
- 完成通用函数库
- 实现用户检查工具
- 添加完整的错误处理