{"id":51026804,"url":"https://github.com/gitstq/smartfile-tui","last_synced_at":"2026-06-21T20:02:22.161Z","repository":{"id":358414305,"uuid":"1241317901","full_name":"gitstq/smartfile-tui","owner":"gitstq","description":"🚀 AI驱动的智能终端文件管理器 - AI-Powered Intelligent Terminal File Manager with semantic search, smart classification, and async operations","archived":false,"fork":false,"pushed_at":"2026-05-17T08:26:30.000Z","size":37,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-17T10:35:38.636Z","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-05-17T08:23:53.000Z","updated_at":"2026-05-17T08:26:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/smartfile-tui","commit_stats":null,"previous_names":["gitstq/smartfile-tui"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/smartfile-tui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsmartfile-tui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsmartfile-tui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsmartfile-tui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsmartfile-tui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/smartfile-tui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fsmartfile-tui/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:21.351Z","updated_at":"2026-06-21T20:02:22.142Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🚀 SmartFile-TUI\n\n**AI驱动的智能终端文件管理器**  \n*AI-Powered Intelligent Terminal File Manager*\n\n[![Python](https://img.shields.io/badge/Python-3.9+-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\n[English](#english) | [简体中文](#简体中文) | [繁體中文](#繁體中文)\n\n\u003c/div\u003e\n\n---\n\n\u003ca name=\"简体中文\"\u003e\u003c/a\u003e\n## 🎉 项目介绍\n\nSmartFile-TUI 是一款**现代化、AI驱动的终端文件管理器**，融合了传统文件管理器的效率与现代AI技术的智能特性。\n\n### 💡 灵感来源\n\n本项目受到以下优秀开源项目的启发：\n- **[yazi](https://github.com/sxyazi/yazi)** - 极速异步文件管理器（Rust）\n- **[superfile](https://github.com/yorukot/superfile)** - 美观的TUI设计（Go）\n- **[veld-fm](https://github.com/BranBushes/veld-fm)** - Python可扩展性\n\n### ✨ 核心差异化亮点\n\n| 特性 | 传统文件管理器 | SmartFile-TUI |\n|------|---------------|---------------|\n| 文件分类 | 仅按扩展名 | 🤖 **AI智能分类+自动标签** |\n| 搜索方式 | 文件名匹配 | 🔍 **语义搜索（理解内容）** |\n| 文件操作 | 同步阻塞 | ⚡ **异步非阻塞** |\n| 界面风格 | 传统终端 | 🎨 **现代化TUI** |\n| 扩展性 | 有限 | 🔌 **插件系统** |\n\n---\n\n## ✨ 核心特性\n\n### 🗂️ 现代化TUI界面\n- 基于 **Textual** 框架构建\n- 响应式设计，支持窗口大小自适应\n- 多主题支持（Dark/Light/Dracula/Nord/Monokai）\n- 流畅的键盘导航体验\n\n### 🤖 AI智能功能\n- **智能文件分类**：自动识别文件类型并分类\n- **自动标签生成**：基于文件名和内容特征\n- **语义搜索**：不仅匹配文件名，更理解搜索意图\n- **使用频率分析**：智能推荐常用文件\n\n### ⚡ 高性能异步操作\n- 基于 **asyncio** 的异步文件操作\n- 复制/移动/删除不阻塞界面\n- 大文件操作流畅无卡顿\n\n### 🎨 丰富的文件预览\n- 文本文件语法高亮\n- 目录内容预览\n- 图片/媒体文件信息展示\n- 可配置预览行数\n\n### 🔧 强大的文件操作\n- 多选批量操作\n- 剪贴板复制/剪切/粘贴\n- 快速创建文件/目录\n- 书签与快速跳转\n- 最近访问记录\n\n### 🔌 可扩展架构\n- 插件系统（开发中）\n- 自定义键位绑定\n- 主题自定义\n- 配置文件支持\n\n---\n\n## 🚀 快速开始\n\n### 环境要求\n\n- **Python** 3.9 或更高版本\n- **操作系统**: Linux / macOS / Windows\n\n### 安装方式\n\n#### 方式一：通过 pip 安装（推荐）\n\n```bash\npip install smartfile-tui\n```\n\n#### 方式二：从源码安装\n\n```bash\ngit clone https://github.com/gitstq/smartfile-tui.git\ncd smartfile-tui\npip install -e .\n```\n\n### 启动命令\n\n```bash\n# 基本启动\nsmartfile\n\n# 或简写\nsft\n\n# 指定起始目录\nsmartfile -p /path/to/directory\n\n# 指定主题\nsmartfile -t dracula\n\n# 显示帮助\nsmartfile --help\n```\n\n---\n\n## 📖 详细使用指南\n\n### ⌨️ 快捷键一览\n\n#### 导航操作\n| 快捷键 | 功能 |\n|--------|------|\n| `↑` / `↓` 或 `j` / `k` | 上下移动 |\n| `←` / `→` 或 `h` / `l` | 返回/进入目录 |\n| `Enter` | 打开文件/进入目录 |\n| `Backspace` | 返回上级目录 |\n\n#### 文件操作\n| 快捷键 | 功能 |\n|--------|------|\n| `Space` | 选择/取消选择 |\n| `c` | 复制到剪贴板 |\n| `x` | 剪切到剪贴板 |\n| `v` | 粘贴 |\n| `d` | 删除 |\n| `R` | 重命名 |\n| `n` | 新建文件 |\n| `N` | 新建目录 |\n\n#### 视图与搜索\n| 快捷键 | 功能 |\n|--------|------|\n| `/` | 搜索文件 |\n| `.` | 切换隐藏文件显示 |\n| `p` | 切换预览面板 |\n| `b` | 书签 |\n| `r` | 刷新 |\n| `?` | 显示帮助 |\n| `q` | 退出 |\n\n### 🔍 搜索功能\n\nSmartFile-TUI 支持强大的文件搜索：\n\n1. **快速搜索**：按 `/` 输入文件名模式\n2. **通配符支持**：使用 `*` 和 `?` 进行模式匹配\n3. **递归搜索**：自动在所有子目录中搜索\n4. **语义搜索**：AI理解搜索意图，不仅匹配文件名\n\n### 🎨 主题切换\n\n```bash\n# 使用暗色主题（默认）\nsmartfile -t dark\n\n# 使用亮色主题\nsmartfile -t light\n\n# 使用 Dracula 主题\nsmartfile -t dracula\n\n# 使用 Nord 主题\nsmartfile -t nord\n\n# 使用 Monokai 主题\nsmartfile -t monokai\n```\n\n### 🔖 书签管理\n\n- 按 `b` 打开书签面板\n- 支持快速跳转到常用目录\n- 自动保存最近访问记录\n\n---\n\n## 💡 设计思路与迭代规划\n\n### 技术选型原因\n\n| 技术 | 选择原因 |\n|------|---------|\n| **Python** | 生态丰富，易于扩展，开发效率高 |\n| **Textual** | 现代化的Python TUI框架，组件丰富 |\n| **asyncio** | 原生异步支持，高性能IO操作 |\n| **Rich** | 美观的终端渲染，支持语法高亮 |\n| **Pydantic** | 类型安全，配置验证 |\n\n### 后续功能迭代计划\n\n#### v1.1.0（近期）\n- [ ] 文件内容全文搜索\n- [ ] 压缩文件直接浏览（zip/tar）\n- [ ] 更多主题支持\n- [ ] 文件对比功能\n\n#### v1.2.0（中期）\n- [ ] 插件系统正式发布\n- [ ] 远程文件管理（SFTP/FTP）\n- [ ] 文件同步功能\n- [ ] 批量重命名工具\n\n#### v2.0.0（远期）\n- [ ] 完整的AI助手集成\n- [ ] 自然语言命令\n- [ ] 智能工作流自动化\n- [ ] 团队协作功能\n\n### 社区贡献方向\n\n我们欢迎以下方向的贡献：\n- 🐛 Bug 修复\n- ✨ 新功能开发\n- 🌍 多语言翻译\n- 🎨 主题设计\n- 📚 文档完善\n- 🔌 插件开发\n\n---\n\n## 📦 打包与部署指南\n\n### 开发环境搭建\n\n```bash\n# 克隆仓库\ngit clone https://github.com/gitstq/smartfile-tui.git\ncd smartfile-tui\n\n# 创建虚拟环境\npython -m venv venv\nsource venv/bin/activate  # Linux/macOS\n# 或: venv\\Scripts\\activate  # Windows\n\n# 安装开发依赖\npip install -e \".[dev]\"\n```\n\n### 运行测试\n\n```bash\n# 运行单元测试\npytest\n\n# 运行代码检查\nblack --check smartfile_tui\nruff check smartfile_tui\nmypy smartfile_tui\n```\n\n### 构建可执行文件\n\n```bash\n# 使用构建脚本\npython build.py all\n\n# 或手动构建\npip install pyinstaller\npyinstaller --onefile --name smartfile smartfile_tui/main.py\n```\n\n### 发布到 PyPI\n\n```bash\n# 构建包\npython -m build\n\n# 上传到 PyPI\npython -m twine upload dist/*\n```\n\n---\n\n## 🤝 贡献指南\n\n### 提交 Issue\n\n- 使用清晰的标题描述问题\n- 提供复现步骤\n- 说明环境信息（OS、Python版本）\n- 附上错误日志（如有）\n\n### 提交 Pull Request\n\n1. Fork 本仓库\n2. 创建功能分支 (`git checkout -b feature/amazing-feature`)\n3. 提交更改 (`git commit -m 'feat: add amazing feature'`)\n4. 推送分支 (`git push origin feature/amazing-feature`)\n5. 创建 Pull Request\n\n### 代码规范\n\n- 遵循 PEP 8 规范\n- 使用 Black 格式化代码\n- 添加类型注解\n- 编写单元测试\n\n---\n\n## 📄 开源协议\n\n本项目采用 [MIT License](LICENSE) 开源协议。\n\n---\n\n\u003ca name=\"english\"\u003e\u003c/a\u003e\n## 🎉 Introduction (English)\n\nSmartFile-TUI is a **modern, AI-powered terminal file manager** that combines the efficiency of traditional file managers with intelligent features of modern AI technology.\n\n### ✨ Key Features\n\n- 🤖 **AI Smart Classification**: Automatic file categorization and tagging\n- 🔍 **Semantic Search**: Understands search intent, not just filename matching\n- ⚡ **Async Operations**: Non-blocking file copy/move/delete\n- 🎨 **Modern TUI**: Built with Textual framework\n- 🖼️ **Rich Preview**: Syntax highlighting, directory preview\n- 🔌 **Extensible**: Plugin system support\n\n### 🚀 Quick Start\n\n```bash\n# Install\npip install smartfile-tui\n\n# Run\nsmartfile\n# or\nsft\n```\n\nSee full documentation above or visit [GitHub Repository](https://github.com/gitstq/smartfile-tui).\n\n---\n\n\u003ca name=\"繁體中文\"\u003e\u003c/a\u003e\n## 🎉 項目介紹 (繁體中文)\n\nSmartFile-TUI 是一款**現代化、AI驅動的終端檔案管理器**，融合了傳統檔案管理器的效率與現代AI技術的智能特性。\n\n### ✨ 核心特性\n\n- 🤖 **AI智能分類**：自動識別檔案類型並分類\n- 🔍 **語義搜尋**：不僅匹配檔名，更理解搜尋意圖\n- ⚡ **非同步操作**：複製/移動/刪除不阻塞介面\n- 🎨 **現代化TUI**：基於 Textual 框架\n- 🖼️ **豐富預覽**：語法高亮、目錄預覽\n- 🔌 **可擴展**：支援插件系統\n\n### 🚀 快速開始\n\n```bash\n# 安裝\npip install smartfile-tui\n\n# 執行\nsmartfile\n# 或\nsft\n```\n\n完整文件請參考上方的簡體中文版本或訪問 [GitHub 倉庫](https://github.com/gitstq/smartfile-tui)。\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by SmartFile Team**\n\n[⭐ Star us on GitHub](https://github.com/gitstq/smartfile-tui) | [🐛 Report Bug](https://github.com/gitstq/smartfile-tui/issues) | [💡 Request Feature](https://github.com/gitstq/smartfile-tui/issues)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fsmartfile-tui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fsmartfile-tui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fsmartfile-tui/lists"}