QmFkLVBp/hckfetch
GitHub: QmFkLVBp/hckfetch
hckfetch 是一款类 neofetch 的终端仪表盘工具，通过 shell wrapper 自动追踪并可视化展示 Kali Linux 渗透测试工具的累计使用统计数据。
Stars: 0 | Forks: 0
# hckfetch 🍎💀
hckfetch 以彩色仪表盘的形式展示常见 Kali Linux 渗透测试工具的累计使用统计数据（花费时间、运行次数、上次会话）——所有数据均通过透明的 shell wrapper 自动追踪。
## 截图
```
(
)
__..---..__
,-=' / | \ `=-.
:--..___________..--;
\.,_____________,./
╔══════════════════════════════════════════════════╗
║ hckfetch v1.0.0 — pentest activity tracker ║
╚══════════════════════════════════════════════════╝
System Info
──────────────────────────────
User: hacker@kali
OS: Kali GNU/Linux Rolling
Kernel: 6.6.0-kali1-amd64
Arch: x86_64
Uptime: 3h 42m
Shell: /usr/bin/zsh
Tool Usage Statistics
──────────────────────────────────────────────────
Tool Time Runs Last Session
──────────────────────────────────────────────────
🔍 nmap 2h 34m 47 2026-05-26 22:11
💀 metasploit 1h 12m 18 2026-05-25 19:45
🕷️ burpsuite 0m 00s 0 never
...
```
## 安装说明
```
git clone https://github.com/QmFkLVBp/hckfetch
cd hckfetch
chmod +x install.sh
./install.sh
source ~/.bashrc # or source ~/.zshrc
```
安装程序会执行以下操作：
1. 将 `hckfetch` 和 `hckfetch-wrap` 复制到 `~/.local/bin/`（如果以 root 身份运行，则复制到 `/usr/local/bin/`）。
2. 创建 `~/.hckfetch_logs/` 目录来存储每次会话的日志文件。
3. 将用于追踪工具的 **aliases** 追加到你的 `~/.bashrc` / `~/.zshrc` 中。
4. 添加一行 **auto-launch** 指令，使得每次打开新终端时都会自动显示仪表盘。
## 用法
| 命令 | 描述 |
|---|---|
| `hckfetch` | 显示完整仪表盘（logo + 统计数据） |
| `hckfetch --no-logo` | 仅显示统计数据（不含 ASCII 艺术字） |
| `hckfetch --reset` | 清除所有使用日志并重新开始 |
| `hckfetch --help` | 显示帮助信息 |
在你的环境中设置 `HCKFETCH_SILENT=1` 可以在打开终端时禁止自动启动。
## 追踪原理
`hckfetch-wrap` 是一个轻量级的 wrapper，它会：
1. 将**开始时间戳**（unix epoch）记录到 `~/.hckfetch_logs//.log` 中。
2. 使用所有原始参数执行**真实的二进制文件**。
3. 将**结束时间戳**记录到同一个文件中。
`hckfetch` 会读取每一个 `.log` 文件，对持续时间进行求和，并展示结果。
安装的 aliases 类似于：
```
alias nmap='hckfetch-wrap nmap'
alias sqlmap='hckfetch-wrap sqlmap'
# ... 等等。
```
## 被追踪的工具
| 图标 | 工具 | 图标 | 工具 |
|---|---|---|---|
| 🔍 | nmap | 🔓 | hashcat |
| 💀 | metasploit | 🌊 | wfuzz |
| 🕷️ | burpsuite | ⚡ | ffuf |
| 🗄️ | sqlmap | 🗺️ | crackmapexec |
| 🐉 | hydra | 🐧 | enum4linux |
| 🔑 | john | 🚀 | gobuster |
| 📡 | aircrack-ng | 🕵️ | nikto |
| 🦈 | wireshark | | |
编辑 `hckfetch` 中的 `TOOLS` 和 `TOOL_ICONS` 数组即可添加你自己的工具。
## 卸载说明
```
./uninstall.sh # interactive (asks whether to delete logs)
./uninstall.sh --purge # remove everything including logs
```
## 环境要求
- Bash 4+
- 标准 Unix 工具：`date`、`awk`、`find`、`mkdir`
- 可选：用于发行版检测的 `lsb_release`
- 无繁重依赖 —— 适用于 Kali Linux 及任何基于 Debian 的发行版
## 相关文件
| 文件 | 描述 |
|---|---|
| `hckfetch` | 主仪表盘脚本 |
| `hckfetch-wrap` | 透明日志记录 wrapper |
| `install.sh` | 安装脚本 |
| `uninstall.sh` | 卸载脚本 |
标签：Cutter, Shell脚本, 应用安全, 效率统计, 系统信息