# Nulcleaner

> 查找并删除在 Git Bash 中使用 /dev/null 创建的 Windows 保留 NUL 文件。支持无界面（Headless）或 GUI 模式。

- Skill: `ellmos-ai/nulcleaner-6` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ellmos-ai/nulcleaner-6`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ellmos-ai/nulcleaner-6/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ellmos-ai (https://skillmd.com/u/ellmos-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ellmos-ai/nulcleaner-6

---


<img src="banner.png" width="100%" alt="nulcleaner banner">

> **中文** — `nulcleaner` 官方中文版本。

# nulcleaner - Windows NUL File Cleanup (中文)

## 问题描述

在 Windows 的 Git Bash 中使用 `/dev/null` 时（例如 `> /dev/null`），输出不会重定向至空无之处，反而会在当前目录中生成一个名为 **`nul` 的实际文件**。Windows 将“NUL”保留为设备名称，这意味着无法通过常规方式删除这些文件。

该工具通过扩展 UNC 路径（`\\?\`）查找并删除此类 NUL 文件。

---

## 模式

| 模式 | 描述 |
|------|-------------|
| `scan` | 递归扫描目录中的 NUL 文件 |
| `delete` | 查找并删除 NUL 文件 |
| `gui` | 带文件选择功能的图形界面 |

---

## CLI 用法

```bash
# 仅扫描（显示找到的 NUL 文件） (中文)
python nulcleaner.py scan /path/to/directory

# 扫描并删除 (中文)
python nulcleaner.py delete /path/to/directory

# 启动 GUI 模式 (中文)
python nulcleaner.py gui
```

---

## 无界面 API (用于集成)

该工具还提供了用于无界面操作的 Python API：

```python
from nulcleaner import clean_nul_files_headless

result = clean_nul_files_headless("/path/to/directory", verbose=True)
print(f"Found: {result['found']}, Deleted: {result['deleted']}")
```

**返回值：** `{'found': int, 'deleted': int, 'errors': list}`

---

## 技术细节

- 使用扩展 UNC 路径（`\\?\`）删除 Windows 保留的文件名
- 使用 `os.walk()` 进行递归扫描
- 基于 tkinter 的 GUI（无外部依赖）
- 仅在 Windows 系统上有效（即出现该问题的地方）

---

## 预防措施

最好完全避免在 Git Bash 中使用 `/dev/null`。替代方案：
- 直接忽略输出
- 使用 `2>&1` 进行 stderr 重定向
- 在 Shell 脚本中注意 Windows 兼容性