{"id":51026587,"url":"https://github.com/gitstq/filezen","last_synced_at":"2026-06-21T20:02:05.957Z","repository":{"id":363740003,"uuid":"1264712641","full_name":"gitstq/filezen","owner":"gitstq","description":"🗂️ FileZen - 零依赖轻量级智能终端文件管理器 | Zero-dependency Lightweight Intelligent Terminal File Manager with smart classification and preview","archived":false,"fork":false,"pushed_at":"2026-06-10T05:57:29.000Z","size":26,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-10T07:24:52.098Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitstq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-10T05:50:19.000Z","updated_at":"2026-06-10T05:57:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/filezen","commit_stats":null,"previous_names":["gitstq/filezen"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/filezen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Ffilezen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Ffilezen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Ffilezen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Ffilezen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/filezen/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Ffilezen/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34623906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-21T20:02:04.942Z","updated_at":"2026-06-21T20:02:05.952Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🗂️ FileZen\n\n**零依赖轻量级智能终端文件管理器**\n*Zero-dependency Lightweight Intelligent Terminal File Manager*\n\n[![Python](https://img.shields.io/badge/Python-3.7+-blue.svg)](https://www.python.org/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Platform](https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]()\n[![Zero Dependencies](https://img.shields.io/badge/Dependencies-Zero-brightgreen.svg)]()\n\n[English](#english) | [简体中文](#简体中文) | [繁體中文](#繁體中文)\n\n\u003c/div\u003e\n\n---\n\n\u003ca name=\"简体中文\"\u003e\u003c/a\u003e\n## 🎉 项目介绍\n\nFileZen 是一款**零依赖、纯Python实现的轻量级智能终端文件管理器**，专为追求效率的开发者与系统管理员设计。在终端环境下，FileZen 提供媲美图形界面的文件浏览体验，同时保持极低的资源占用与极高的响应速度。\n\n### 💡 灵感来源\n\n本项目受到以下优秀开源项目的启发：\n- **[yazi](https://github.com/sxyazi/yazi)** - 极速异步文件管理器（Rust），启发我们追求极致性能\n- **[nnn](https://github.com/jarun/nnn)** - 极简终端文件浏览器，启发我们保持零依赖理念\n- **[Ranger](https://github.com/ranger/ranger)** - Vim风格文件管理器，启发我们设计键盘驱动交互\n\n### ✨ 自研差异化亮点\n\n| 特性 | 传统终端文件管理器 | FileZen |\n|------|-------------------|---------|\n| 依赖 | 需安装多个第三方库 | ✅ **纯Python零依赖** |\n| 兼容性 | Python 3.9+ | ✅ **Python 3.7+ 全兼容** |\n| 智能分类 | 仅按扩展名着色 | ✅ **8大类文件智能分类+图标** |\n| 文件预览 | 简单文本显示 | ✅ **目录内容统计+文本预览** |\n| 跨平台 | 部分功能受限 | ✅ **Linux/macOS/Windows全支持** |\n| 启动速度 | 依赖加载慢 | ✅ **毫秒级冷启动** |\n\n---\n\n## ✨ 核心特性\n\n### 🚀 零依赖纯Python核心\n- **无需pip install任何包**，单文件即可运行\n- 仅使用Python标准库（os, sys, shutil, stat, time等）\n- 兼容Python 3.7/3.8/3.9/3.10/3.11/3.12\n\n### 🎨 现代化TUI界面\n- 256色ANSI终端色彩支持\n- 文件类型彩色高亮（目录黄、可执行绿、代码蓝、媒体粉等）\n- 文件类型emoji图标（🐍Python、📝Markdown、🖼️图片等）\n- 自适应终端尺寸，支持窄屏与宽屏\n\n### 🤖 智能文件分类\n- **8大智能分类**：源代码💻、文档📚、媒体🎭、压缩包📦、数据📊、配置🔧、可执行⚙️、其他📎\n- 支持100+文件扩展名自动识别\n- 目录内容实时统计与预览\n\n### 📖 实时文件预览\n- 文本文件内容预览（支持语法感知）\n- 目录内容概览（文件数量、分类统计）\n- 符号链接追踪与状态检测\n- 大文件智能跳过（\u003e50KB）\n\n### ⌨️ 类Vim快捷键\n- 全键盘操作，双手不离开主键区\n- hjkl导航、Space选择、/搜索\n- 批量复制/剪切/粘贴/删除\n- 快速新建文件/目录\n\n### ⚡ 高性能设计\n- 毫秒级目录加载\n- 流畅的滚动与导航\n- 内存占用极低（\u003c10MB）\n\n---\n\n## 🚀 快速开始\n\n### 环境要求\n\n- **Python** 3.7 或更高版本\n- **操作系统**: Linux / macOS / Windows\n- **终端**: 支持ANSI颜色的终端（推荐：iTerm2、Windows Terminal、GNOME Terminal）\n\n### 安装方式\n\n#### 方式一：单文件直接运行（推荐）\n\n```bash\n# 下载单文件\ncurl -O https://raw.githubusercontent.com/gitstq/filezen/main/smartfile.py\n\n# 直接运行\npython3 smartfile.py\n```\n\n#### 方式二：通过 pip 安装\n\n```bash\npip install filezen\n```\n\n#### 方式三：从源码安装\n\n```bash\ngit clone https://github.com/gitstq/filezen.git\ncd filezen\npip install -e .\n```\n\n### 启动命令\n\n```bash\n# 基本启动\nfilezen\n\n# 或简写\nfz\n\n# 指定起始目录\nfilezen /path/to/directory\n\n# 显示版本\nfilezen --version\n```\n\n---\n\n## 📖 详细使用指南\n\n### ⌨️ 快捷键一览\n\n#### 导航操作\n| 快捷键 | 功能 |\n|--------|------|\n| `↑` / `k` | 向上移动 |\n| `↓` / `j` | 向下移动 |\n| `←` / `h` | 返回上级目录 |\n| `→` / `l` / `Enter` | 进入目录/打开文件 |\n| `g` | 跳到首项 |\n| `G` | 跳到末项 |\n| `Ctrl+U` / `PageUp` | 上翻10项 |\n| `Ctrl+D` / `PageDown` | 下翻10项 |\n\n#### 选择与搜索\n| 快捷键 | 功能 |\n|--------|------|\n| `Space` | 选择/取消选择当前项 |\n| `a` | 全选/取消全选 |\n| `/` | 搜索文件（实时过滤） |\n| `.` | 切换显示/隐藏隐藏文件 |\n\n#### 排序\n| 快捷键 | 功能 |\n|--------|------|\n| `s` | 切换排序方式（名称→大小→修改时间） |\n| `S` | 切换升序/降序 |\n\n#### 文件操作\n| 快捷键 | 功能 |\n|--------|------|\n| `c` | 复制选中项到剪贴板 |\n| `x` | 剪切选中项到剪贴板 |\n| `p` | 粘贴剪贴板内容 |\n| `d` | 删除选中项（需确认） |\n| `r` | 重命名当前项 |\n| `n` | 新建文件/目录 |\n| `o` | 用系统默认程序打开 |\n\n#### 其他\n| 快捷键 | 功能 |\n|--------|------|\n| `q` / `Esc` | 退出 |\n| `?` | 显示帮助 |\n\n### 🖥️ 界面说明\n\n```\n┌─────────────────────────────────────┬──────────────────┐\n│ 📂 /home/user/projects              │  预览             │\n│  共12项 | 排序: 名称↑               │  文件信息         │\n├─────────────────────────────────────┤                  │\n│ 📁 src          \u003cDIR\u003e    2天前      │  名称: README.md │\n│ 📄 README.md     2K      刚刚       │  类型: 文件       │\n│ 🐍 main.py       5K      1小时前    │  大小: 2K        │\n│ ⚙️ build.sh      1K      3天前      │  权限: -rw-r--r--│\n│ 📦 dist.tar.gz   15M     1周前      │  修改: 2026-06-10│\n│ 📝 docs.md       8K      2天前      │  分类: 📚 文档    │\n│                                     │                  │\n│                                     │  ─────────────── │\n│                                     │  # FileZen       │\n│                                     │  零依赖文件管理器 │\n│                                     │                  │\n└─────────────────────────────────────┴──────────────────┘\n ↑↓移动 Enter进入 Space选择 /搜索 .隐藏 q退出 d删除 ?帮助\n```\n\n---\n\n## 💡 设计思路与迭代规划\n\n### 🎯 设计理念\n\nFileZen 的设计遵循三个核心原则：\n\n1. **零依赖优先**：在受限环境（如无网络的服务器、嵌入式设备）中也能直接使用\n2. **键盘驱动**：减少鼠标依赖，让文件操作像Vim编辑一样流畅\n3. **智能感知**：通过文件扩展名与属性自动分类，降低认知负担\n\n### 🔧 技术选型原因\n\n| 技术决策 | 原因 |\n|---------|------|\n| 纯Python标准库 | 零安装成本，跨平台一致性 |\n| ANSI 256色 | 兼顾兼容性（非True Color终端）与视觉效果 |\n| 同步I/O | 文件操作本身受磁盘限制，异步收益有限，同步代码更简洁 |\n| 单文件架构 | 便于直接下载使用，降低分发复杂度 |\n\n### 📅 后续迭代计划\n\n- [ ] **v1.1.0** - 添加书签功能（快速跳转常用目录）\n- [ ] **v1.2.0** - 添加文件内容搜索（集成ripgrep）\n- [ ] **v1.3.0** - 添加批量重命名（正则表达式支持）\n- [ ] **v1.4.0** - 添加Git状态集成（显示文件修改状态）\n- [ ] **v1.5.0** - 添加可配置主题与键位绑定\n\n### 🤝 社区贡献方向\n\n- 欢迎提交Issue报告bug或建议新功能\n- 欢迎提交PR扩展文件类型识别规则\n- 欢迎改进多语言文档\n\n---\n\n## 📦 打包与部署指南\n\n### 构建源码分发包\n\n```bash\nmake build\n```\n\n### 本地安装测试\n\n```bash\nmake install\nfilezen --version\n```\n\n### 运行测试\n\n```bash\nmake test\n```\n\n### 清理构建产物\n\n```bash\nmake clean\n```\n\n---\n\n## 🤝 贡献指南\n\n### 提交Issue\n\n- 使用清晰的标题描述问题\n- 提供复现步骤与环境信息（OS、Python版本、终端类型）\n- 如可能，附上截图或录屏\n\n### 提交PR\n\n1. Fork本仓库\n2. 创建功能分支：`git checkout -b feat/amazing-feature`\n3. 提交更改：`git commit -m 'feat: add amazing feature'`\n4. 推送分支：`git push origin feat/amazing-feature`\n5. 提交Pull Request\n\n### 代码规范\n\n- 遵循PEP 8编码规范\n- 所有新功能需附带单元测试\n- 保持零依赖原则（标准库 only）\n\n---\n\n## 📄 开源协议说明\n\n本项目采用 [MIT License](LICENSE) 开源协议。\n\n您可以自由使用、修改、分发本软件，只需在副本中包含原始版权声明即可。\n\n---\n\n\u003ca name=\"繁體中文\"\u003e\u003c/a\u003e\n# 繁體中文\n\n## 🎉 專案介紹\n\nFileZen 是一款**零依賴、純Python實現的輕量級智慧終端檔案管理器**，專為追求效率的開發者與系統管理員設計。在終端環境下，FileZen 提供媲美圖形介面的檔案瀏覽體驗，同時保持極低的資源佔用與極高的回應速度。\n\n### ✨ 自研差異化亮點\n\n| 特性 | 傳統終端檔案管理器 | FileZen |\n|------|-------------------|---------|\n| 依賴 | 需安裝多個第三方庫 | ✅ **純Python零依賴** |\n| 相容性 | Python 3.9+ | ✅ **Python 3.7+ 全相容** |\n| 智慧分類 | 僅按副檔名著色 | ✅ **8大類檔案智慧分類+圖示** |\n| 檔案預覽 | 簡單文字顯示 | ✅ **目錄內容統計+文字預覽** |\n| 跨平台 | 部分功能受限 | ✅ **Linux/macOS/Windows全支援** |\n\n### 🚀 快速開始\n\n```bash\n# 單檔案直接執行\ncurl -O https://raw.githubusercontent.com/gitstq/filezen/main/smartfile.py\npython3 smartfile.py\n\n# 或透過 pip 安裝\npip install filezen\nfilezen\n```\n\n### ⌨️ 快速鍵一覽\n\n| 快速鍵 | 功能 |\n|--------|------|\n| `↑` / `k`, `↓` / `j` | 上下移動 |\n| `←` / `h`, `→` / `l` | 返回/進入目錄 |\n| `Space` | 選擇/取消選擇 |\n| `/` | 搜尋檔案 |\n| `c` / `x` / `p` | 複製/剪下/貼上 |\n| `d` | 刪除（需確認） |\n| `q` | 退出 |\n| `?` | 顯示說明 |\n\n### 📄 開源協議\n\n本專案採用 [MIT License](LICENSE) 開源協議。\n\n---\n\n\u003ca name=\"english\"\u003e\u003c/a\u003e\n# English\n\n## 🎉 Introduction\n\nFileZen is a **zero-dependency, pure Python lightweight intelligent terminal file manager** designed for developers and system administrators who value efficiency. In terminal environments, FileZen provides a file browsing experience comparable to GUI file managers while maintaining extremely low resource usage and high responsiveness.\n\n### ✨ Differentiation Highlights\n\n| Feature | Traditional Terminal File Managers | FileZen |\n|---------|-----------------------------------|---------|\n| Dependencies | Multiple third-party libraries required | ✅ **Pure Python, Zero Dependencies** |\n| Compatibility | Python 3.9+ | ✅ **Python 3.7+ Fully Compatible** |\n| Smart Classification | Extension-only coloring | ✅ **8-Category Smart Classification + Icons** |\n| File Preview | Simple text display | ✅ **Directory Stats + Text Preview** |\n| Cross-Platform | Limited functionality | ✅ **Full Linux/macOS/Windows Support** |\n\n### 🚀 Quick Start\n\n```bash\n# Single-file direct execution\ncurl -O https://raw.githubusercontent.com/gitstq/filezen/main/smartfile.py\npython3 smartfile.py\n\n# Or install via pip\npip install filezen\nfilezen\n```\n\n### ⌨️ Key Bindings\n\n| Key | Action |\n|-----|--------|\n| `↑` / `k`, `↓` / `j` | Move up/down |\n| `←` / `h`, `→` / `l` | Go back/enter directory |\n| `Space` | Select/deselect |\n| `/` | Search files |\n| `c` / `x` / `p` | Copy/cut/paste |\n| `d` | Delete (with confirmation) |\n| `q` | Quit |\n| `?` | Show help |\n\n### 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Ffilezen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Ffilezen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Ffilezen/lists"}