# programmer-scripts

**Repository Path**: simplecoder-1/programmer-scripts

## Basic Information

- **Project Name**: programmer-scripts
- **Description**: 程序员日常高频脚本合集
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-04
- **Last Updated**: 2026-04-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 程序员日常高频脚本合集

## 目录

| 脚本 | 功能 | 依赖 |
|------|------|------|
| auto_format.py | 自动格式化代码 | black, prettier |
| auto_comment.py | 自动添加文件头注释 | - |
| auto_api_doc.py | 自动生成接口文档 | - |
| auto_packet_capture.py | 自动抓包分析 | tshark (Wireshark) |
| auto_translate_error.py | 自动翻译报错信息 | - |
| auto_commit.py | 自动生成规范commit | git |

## 使用方法

### 1. auto_format.py - 代码自动格式化

```bash
python auto_format.py <文件或目录>
```

**示例:**
```bash
python auto_format.py ./src
python auto_format.py app.py
```

**依赖安装:**
```bash
pip install black
npm install -g prettier
```

### 2. auto_comment.py - 自动添加文件头注释

```bash
python auto_comment.py <文件或目录> [-d "描述"]
```

**示例:**
```bash
python auto_comment.py ./src -d "用户认证模块"
python auto_comment.py app.py -d "主入口文件"
```

### 3. auto_api_doc.py - 自动生成接口文档

```bash
python auto_api_doc.py <文件或目录> [-o 输出目录] [-f markdown|json]
```

**示例:**
```bash
python auto_api_doc.py ./api -o ./docs
python auto_api_doc.py user.py -f json
```

### 4. auto_packet_capture.py - 自动抓包

**列出网络接口:**
```bash
python auto_packet_capture.py list
```

**开始抓包:**
```bash
python auto_packet_capture.py capture -i 1 -o capture.pcap -f "port 80"
```

**分析抓包文件:**
```bash
python auto_packet_capture.py analyze -r capture.pcap -c 50
```

**依赖:** 需要安装 [Wireshark](https://www.wireshark.org/) 并添加到系统 PATH

### 5. auto_translate_error.py - 自动翻译报错

```bash
python auto_translate_error.py <错误信息>
```

**示例:**
```bash
python auto_translate_error.py "SyntaxError: invalid syntax"
echo "TypeError: 'NoneType' object" | python auto_translate_error.py -
```

### 6. auto_commit.py - 自动生成规范Commit

```bash
python auto_commit.py [-m "提交信息"] [-t 类型] [-s 范围] [-y]
```

**示例:**
```bash
python auto_commit.py -y
python auto_commit.py -t feat -s user -m "添加用户登录功能"
```

**支持的类型:**
- `feat` - 新增功能
- `fix` - 修复bug
- `docs` - 文档更新
- `style` - 代码格式
- `refactor` - 代码重构
- `perf` - 性能优化
- `test` - 测试相关
- `chore` - 构建或辅助工具变动

## 注意事项

1. 所有脚本基于 Python 3 开发
2. 部分脚本需要额外依赖，请按需安装
3. 抓包脚本需要管理员/root权限
4. 翻译功能优先本地词库，失败时调用Google翻译API