# llmdu

**Repository Path**: grow-project/llmdu

## Basic Information

- **Project Name**: llmdu
- **Description**: llmdu 是一个 macOS 命令行工具，用于审计本地 AI 和大语言模型工具的磁盘占用情况。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# llmdu

`llmdu` 是一个 macOS CLI 工具，用于审计本地 AI 和 LLM 工具的硬盘占用。

它会检测已配置工具的磁盘占用，包括：

- Ollama
- LM Studio
- HuggingFace
- Cursor
- Claude Code
- Codex
- Kimi
- Tencent Yuanbao
- Doubao
- Qianwen
- MiniMax
- ZCode
- OpenCode
- CodeArts
- Kiro
- Trae
- Trae CN
- Trae Work CN
- CodeBuddy
- CodeBuddy CN
- Qoder
- Docker Desktop
- Go、Node.js 和 Python 开发缓存

`llmdu` 不会删除文件。它只报告磁盘占用，并输出清理建议。

扫描结果还会显示 App 安装状态：

- `installed`：检测到对应 App 安装路径。
- `uninstalled, leftovers detected`：未检测到 App，但仍检测到残留数据。
- `uninstalled, no data detected`：未检测到 App，也未检测到数据占用。
- `unknown`：该工具没有配置安装路径，无法判断安装状态。

例如：

```text
Kimi
  Status: uninstalled, leftovers detected
  Total: 2.36 GiB
  Suggestion: Safe to remove all Kimi leftovers if you no longer use it.
```

## 隐私

`llmdu` 只扫描文件系统元数据：

- 文件和目录路径
- 文件大小 / 已分配磁盘 block
- 目录是否存在
- 扫描错误

它不会读取文件内容。

## 环境要求

- macOS
- Go 1.26 或更新版本

## 安装

```bash
go install ./cmd/llmdu
```

也可以构建本地二进制：

```bash
go build ./cmd/llmdu
```

## 使用

输出终端报告：

```bash
llmdu scan
```

输出 JSON：

```bash
llmdu scan --format json
```

生成 Markdown 报告：

```bash
llmdu scan --format markdown > report.md
```

输出清理建议：

```bash
llmdu doctor
```

只扫描某个工具：

```bash
llmdu scan --only Ollama
```

只显示至少 1 GiB 的路径：

```bash
llmdu scan --min-size 1GB
```

使用自定义规则文件：

```bash
llmdu scan --config ./rules.yaml
```

## 自定义规则

规则使用 YAML，可以定义任意工具和路径组合：

```yaml
tools:
  - name: Custom Tool
    type: model_cache
    description: Custom model cache
    install_paths:
      - /Applications/Custom Tool.app
    paths:
      - path: ~/Library/Caches/custom-tool
        category: cache
        risk: medium
        description: Custom cache directory
```

`risk` 必须是以下值之一：

- `low`
- `medium`
- `high`

常见 `category` 包括：

- `models`
- `cache`
- `logs`
- `sessions`
- `app_data`
- `dependency_cache`
- `build_cache`
- `container_data`

## 安全说明

高风险路径可能包含模型、提示词、源代码、凭据或私有会话数据。`llmdu doctor` 只会提示值得检查的位置，清理始终需要手动完成。