# goxdir

**Repository Path**: luolip/goxdir

## Basic Information

- **Project Name**: goxdir
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# goxdir

基于 Go 和 Bubble Tea 构建的终端目录浏览器。

## 功能特点

- **目录浏览** - 通过交互式 TUI 浏览目录
- **大小显示** - 显示文件和文件夹大小（递归计算）
- **排序** - 按大小排序（升序/降序）
- **搜索** - 实时按名称筛选文件和文件夹
- **删除** - 删除文件和目录（需确认）
- **多级颜色** - 不同目录层级显示不同颜色
- **绿色高亮** - 选中目录时显示绿色高亮
- **刷新** - 重新加载当前目录

## 安装

### 从源码构建

```bash
# 进入项目目录
cd goxdir

# 构建
go build -o goxdir.exe

# 复制到 PATH（Windows）
copy goxdir.exe D:\agodep\bin\goxdir.exe
```

### 运行

```bash
# 浏览当前目录
goxdir

# 浏览指定目录
goxdir C:\path\to\directory

# 显示帮助
goxdir -h
```

## 键盘快捷键

| 按键 | 功能 |
|-----|------|
| ↑/↓ | 导航条目 |
| Enter | 进入目录 |
| Backspace | 返回上级 |
| S | 切换大小排序（升序/降序） |
| R | 刷新目录 |
| F 或 / | 按名称搜索 |
| D | 删除选中项 |
| Y | 确认删除 |
| N | 取消删除 |
| Esc | 退出搜索模式 |
| Q | 退出程序 |

## 命令行参数

```
用法：
  goxdir [参数] [目录]

参数：
  -h, --help     显示帮助信息
  directory      要浏览的目录（默认：当前目录）
```

## 界面预览

```
┌──────────────────────────────────────────────────────────┐
│ ▸ goxdir   C:\Users\test                             │
├──────────────────────────────────────────────────────────┤
│ Name                             Size    Modified │
├──────────────────────────────────────────────────────────┤
│ 📁 Documents/                  1.2 MB           │
│ 📁 Downloads/                  256 MB           │
│ 📄 file.txt                    12 KB   2026/01/15 │
├──────────────────────────────────────────────────────────┤
│[Enter] Open  [Back] Up  [S] Sort  [R] Refresh  [F] Search  [D] Del  [Q] Quit │
└──────────────────────────────────────────────────────────┘
```

## 颜色方案

- 目录层级 0: 蓝色 (#60A5FA)
- 目录层级 1: 青色 (#22D3EE)
- 目录层级 2+: 紫色 (#A78BFA)
- 文件: 灰色 (#E5E7EB)
- 选中目录: 绿色 (#22C55E)
- 图标: 金色 (#FBBF24)

## 构建要求

- Go 1.20+
- [Bubble Tea](https://github.com/charmbracelet/bubbletea)
- [Lip Gloss](https://github.com/charmbracelet/lipgloss)

## 许可证

MIT