[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-cruzyjapan--Gemini-CLI-UI":3,"tool-cruzyjapan--Gemini-CLI-UI":64},[4,16,31,40,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":15},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,2,"2026-04-06T19:52:38",[13,14],"插件","开发框架","ready",{"id":17,"name":18,"github_repo":19,"description_zh":20,"stars":21,"difficulty_score":10,"last_commit_at":22,"category_tags":23,"status":15},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",85052,"2026-04-08T11:03:08",[24,25,26,13,27,28,29,14,30],"图像","数据工具","视频","Agent","其他","语言模型","音频",{"id":32,"name":33,"github_repo":34,"description_zh":35,"stars":36,"difficulty_score":37,"last_commit_at":38,"category_tags":39,"status":15},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70806,3,"2026-04-08T11:10:08",[29,27,14,13],{"id":41,"name":42,"github_repo":43,"description_zh":44,"stars":45,"difficulty_score":10,"last_commit_at":46,"category_tags":47,"status":15},51,"gstack","garrytan\u002Fgstack","gstack 是 Y Combinator CEO Garry Tan 亲自开源的一套 AI 工程化配置，旨在将 Claude Code 升级为你的虚拟工程团队。面对单人开发难以兼顾产品战略、架构设计、代码审查及质量测试的挑战，gstack 提供了一套标准化解决方案，帮助开发者实现堪比二十人团队的高效产出。\n\n这套配置特别适合希望提升交付效率的创始人、技术负责人，以及初次尝试 Claude Code 的开发者。gstack 的核心亮点在于内置了 15 个具有明确职责的 AI 角色工具，涵盖 CEO、设计师、工程经理、QA 等职能。用户只需通过简单的斜杠命令（如 `\u002Freview` 进行代码审查、`\u002Fqa` 执行测试、`\u002Fplan-ceo-review` 规划功能），即可自动化处理从需求分析到部署上线的全链路任务。\n\n所有操作基于 Markdown 和斜杠命令，无需复杂配置，完全免费且遵循 MIT 协议。gstack 不仅是一套工具集，更是一种现代化的软件工厂实践，让单人开发者也能拥有严谨的工程流程。",66972,"2026-04-08T11:10:00",[27,13],{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":15},3074,"gpt4free","xtekky\u002Fgpt4free","gpt4free 是一个由社区驱动的开源项目，旨在聚合多种可访问的大型语言模型（LLM）和媒体生成接口，让用户能更灵活、便捷地使用前沿 AI 能力。它解决了直接调用各类模型时面临的接口分散、门槛高或成本昂贵等痛点，通过统一的标准将不同提供商的资源整合在一起。\n\n无论是希望快速集成 AI 功能的开发者、需要多模型对比测试的研究人员，还是想免费体验最新技术的普通用户，都能从中受益。gpt4free 提供了丰富的使用方式：既包含易于上手的 Python 和 JavaScript 客户端库，也支持部署本地图形界面（GUI），更提供了兼容 OpenAI 标准的 REST API，方便无缝替换现有应用后端。\n\n其技术亮点在于强大的多提供商支持架构，能够动态调度包括 Opus、Gemini、DeepSeek 等多种主流模型资源，并支持 Docker 一键部署及本地推理。项目秉持社区优先原则，在降低使用门槛的同时，也为贡献者提供了扩展新接口的便利框架，是探索和利用多样化 AI 资源的实用工具。",65970,"2026-04-04T01:02:03",[13,29,27],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":15},193,"meilisearch","meilisearch\u002Fmeilisearch","Meilisearch 是一个开源的极速搜索服务，专为现代应用和网站打造，开箱即用。它能帮助开发者快速集成高质量的搜索功能，无需复杂的配置或额外的数据预处理。传统搜索方案往往需要大量调优才能实现准确结果，而 Meilisearch 内置了拼写容错、同义词识别、即时响应等实用特性，并支持 AI 驱动的混合搜索（结合关键词与语义理解），显著提升用户查找信息的体验。\n\nMeilisearch 特别适合 Web 开发者、产品团队或初创公司使用，尤其适用于需要快速上线搜索功能的场景，如电商网站、内容平台或 SaaS 应用。它提供简洁的 RESTful API 和多种语言 SDK，部署简单，资源占用低，本地开发或生产环境均可轻松运行。对于希望在不依赖大型云服务的前提下，为用户提供流畅、智能搜索体验的团队来说，Meilisearch 是一个高效且友好的选择。",57019,"2026-04-08T10:53:37",[24,27,25,14,13,28],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":80,"owner_email":78,"owner_twitter":78,"owner_website":81,"owner_url":82,"languages":83,"stars":95,"forks":96,"last_commit_at":97,"license":98,"difficulty_score":37,"env_os":99,"env_gpu":100,"env_ram":100,"env_deps":101,"category_tags":114,"github_topics":115,"view_count":10,"oss_zip_url":78,"oss_zip_packed_at":78,"status":15,"created_at":122,"updated_at":123,"faqs":124,"releases":125},5619,"cruzyjapan\u002FGemini-CLI-UI","Gemini-CLI-UI","A responsive web-based UI that provides an intuitive interface for Google's Gemini CLI, enabling AI-assisted coding from any device. Features include interactive chat, integrated   terminal, file explorer with live editing, Git integration, and session management. ","Gemini-CLI-UI 是一款专为 Google 官方 AI 编程助手 Gemini CLI 打造的响应式网页界面。它打破了传统命令行工具的操作壁垒，让用户无需记忆复杂指令，即可通过直观的图形界面在电脑、平板或手机上轻松进行 AI 辅助编程。\n\n该工具主要解决了原生 CLI 缺乏可视化交互、移动端适配困难以及文件管理不便等痛点。它将原本枯燥的终端操作转化为包含交互式聊天、集成终端、实时文件编辑器和 Git 版本控制的一站式工作台。用户不仅能像在本地编辑器中一样直接浏览和修改代码，还能可视化管理多个会话历史，随时恢复之前的对话上下文。\n\n这款软件非常适合希望提升开发效率的软件工程师、需要在不同设备间灵活切换工作的全栈开发者，以及想要尝试 AI 编程但畏惧命令行门槛的技术爱好者。其独特的技术亮点包括支持多模型切换（如 Gemini 2.5 Pro）、提供谨慎可控的\"YOLO 模式”以跳过确认提示加速操作，以及默认禁用高风险工具的安全机制，确保用户在享受便利的同时保障项目安全。无论是本地开发还是远程协作，Gemini-CLI-UI 都能提供流畅且一致的使用体验。","\u003Cdiv align=\"center\">\n  \u003Cimg src=\"public\u002Flogo.svg\" alt=\"Gemini CLI UI\" width=\"64\" height=\"64\">\n  \u003Ch1>Gemini CLI UI\u003C\u002Fh1>\n\u003C\u002Fdiv>\n\nA desktop and mobile UI for [Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli), Google's official CLI for AI-assisted coding. You can use it locally or remotely to view your active projects and sessions in Gemini CLI and make changes to them the same way you would do it in Gemini CLI. This gives you a proper interface that works everywhere.\n\n\n## Screenshots\n\n\u003Cdiv align=\"center\">\n\u003Ctable>\n\u003Ctr>\n\u003Ctd align=\"center\">\n\u003Ch3>Chat View\u003C\u002Fh3>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcruzyjapan_Gemini-CLI-UI_readme_36f65bafba4b.png\" alt=\"Desktop Interface\" width=\"400\">\n\u003Cbr>\n\u003Cem>Main interface showing project overview and chat\u003C\u002Fem>\n\u003C\u002Ftd>\n\u003Ctd align=\"center\">\n\u003Ch3>Setting\u003C\u002Fh3>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcruzyjapan_Gemini-CLI-UI_readme_b3d193f517ae.png\" alt=\"Mobile Interface\" width=\"400\">\n\u003Cbr>\n\u003Cem>Setting\u003C\u002Fem>\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\u003Ctable>\n\u003Ctr>\n\u003Ctd align=\"center\">\n\u003Ch3>Chat View\u003C\u002Fh3>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcruzyjapan_Gemini-CLI-UI_readme_100ff30b1136.png\" alt=\"Desktop Interface\" width=\"800\">\n\u003Cbr>\n\u003Cem>Gemini CLI UI Diagram\u003C\u002Fem>\n\u003C\u002Ftd>\n\u003C\u002Ftable>\n\u003C\u002Fdiv align=\"center\">\n\n## Features\n\n- **Responsive Design** - Works seamlessly across desktop, tablet, and mobile so you can also use Gemini CLI from mobile\n- **Interactive Chat Interface** - Built-in chat interface for seamless communication with Gemini CLI\n- **Integrated Shell Terminal** - Direct access to Gemini CLI through built-in shell functionality\n- **File Explorer** - Interactive file tree with syntax highlighting and live editing\n- **Git Explorer** - View, stage and commit your changes. You can also switch branches\n- **Session Management** - Resume conversations, manage multiple sessions, and track history\n- **Model Selection** - Choose from multiple Gemini models including Gemini 2.5 Pro\n- **YOLO Mode** - Skip confirmation prompts for faster operations (use with caution)\n\n## Quick Start\n\n### Prerequisites\n\n- [Node.js](https:\u002F\u002Fnodejs.org\u002F) v20 or higher\n- [Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli) installed and configured\n\n### Installation\n\n1. **Clone the repository:**\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fcruzyjapan\u002FGemini-CLI-UI.git\ncd Gemini-CLI-UI\n```\n\n2. **Install dependencies:**\n```bash\nnpm install\n```\n\n3. **Configure environment:**\n```bash\ncp .env.example .env\n# Edit .env with your preferred settings\n```\n\n**Note**: The `.env` file has been removed for security. Always copy `.env.example` to `.env` when using and modify settings as needed.\n\n4. **Start the application:**\n```bash\n# Development mode (with hot reload)\nnpm run dev\n```\nThe application will start at the port you specified in your .env\n\n5. **Open your browser:**\n   - Development: `http:\u002F\u002Flocalhost:4009`\n\n## Security & Tools Configuration\n\n**🔒 Important Notice**: All Gemini CLI tools are **disabled by default**. This prevents potentially harmful operations from running automatically.\n\n### Enabling Tools\n\nTo use Gemini CLI's full functionality, you'll need to manually enable tools:\n\n1. **Open Tools Settings** - Click the gear icon in the sidebar\n2. **Enable Selectively** - Turn on only the tools you need\n3. **Apply Settings** - Your preferences are saved locally\n\n### About YOLO Mode\n\nYOLO mode (\"You Only Live Once\") is equivalent to Gemini CLI's `--yolo` flag, skipping all confirmation prompts. This mode speeds up your work but should be used with caution.\n\n**Recommended approach**: Start with basic tools enabled and add more as needed. You can always adjust these settings later.\n\n## Usage Guide\n\n### Core Features\n\n#### Project Management\nThe UI automatically discovers Gemini CLI projects from `~\u002F.gemini\u002Fprojects\u002F` and provides:\n- **Visual Project Browser** - All available projects with metadata and session counts\n- **Project Actions** - Rename, delete, and organize projects\n- **Smart Navigation** - Quick access to recent projects and sessions\n\n#### Chat Interface\n- **Use responsive chat or Gemini CLI** - You can either use the adapted chat interface or use the shell button to connect to Gemini CLI\n- **Real-time Communication** - Stream responses from Gemini with WebSocket connection\n- **Session Management** - Resume previous conversations or start fresh sessions\n- **Message History** - Complete conversation history with timestamps and metadata\n- **Multi-format Support** - Text, code blocks, and file references\n- **Image Upload** - Upload and ask questions about images in chat\n\n#### File Explorer & Editor\n- **Interactive File Tree** - Browse project structure with expand\u002Fcollapse navigation\n- **Live File Editing** - Read, modify, and save files directly in the interface\n- **Syntax Highlighting** - Support for multiple programming languages\n- **File Operations** - Create, rename, delete files and directories\n\n#### Git Explorer\n- **Visualize Changes** - See current changes in real-time\n- **Stage and Commit** - Create Git commits directly from the UI\n- **Branch Management** - Switch and manage branches\n\n#### Session Management\n- **Session Persistence** - All conversations automatically saved\n- **Session Organization** - Group sessions by project and timestamp\n- **Session Actions** - Rename, delete, and export conversation history\n- **Cross-device Sync** - Access sessions from any device\n\n### Mobile App\n- **Responsive Design** - Optimized for all screen sizes\n- **Touch-friendly Interface** - Swipe gestures and touch navigation\n- **Mobile Navigation** - Bottom tab bar for easy thumb navigation\n- **Adaptive Layout** - Collapsible sidebar and smart content prioritization\n- **Add to Home Screen** - Add a shortcut to your home screen and the app will behave like a PWA\n\n## Architecture\n\n### System Overview\n\n```\n┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐\n│   Frontend      │    │   Backend       │    │  Gemini CLI     │\n│   (React\u002FVite)  │◄──►│ (Express\u002FWS)    │◄──►│  Integration    │\n└─────────────────┘    └─────────────────┘    └─────────────────┘\n```\n\n### Backend (Node.js + Express)\n- **Express Server** - RESTful API with static file serving (Port: 4008)\n- **WebSocket Server** - Communication for chats and project refresh\n- **Gemini CLI Integration** - Process spawning and management\n- **Session Management** - JSONL parsing and conversation persistence\n- **File System API** - Exposing file browser for projects\n- **Authentication System** - Secure login and session management (SQLite database: geminicliui_auth.db)\n\n### Frontend (React + Vite)\n- **React 18** - Modern component architecture with hooks\n- **CodeMirror** - Advanced code editor with syntax highlighting\n- **Tailwind CSS** - Utility-first CSS framework\n- **Responsive Design** - Mobile-first approach\n\n## Configuration Details\n\n### Port Settings\n- **API Server**: Port 4008 (default)\n- **Frontend Dev Server**: Port 4009 (default)\n- These ports can be changed in the `.env` file\n\n### Database Configuration\n\n#### Initial Setup and Table Structure\n- **Database File**: `server\u002Fdatabase\u002Fgeminicliui_auth.db`\n- **Database Type**: SQLite 3\n- **Initialization**: Automatically created and initialized on server startup\n\n#### User Table Details\n\n**Table Name**: `geminicliui_users`\n\n| Column | Data Type | Constraints | Description |\n|--------|-----------|-------------|-------------|\n| `id` | INTEGER | PRIMARY KEY AUTOINCREMENT | Unique user identifier |\n| `username` | TEXT | UNIQUE NOT NULL | Login username (email recommended) |\n| `password_hash` | TEXT | NOT NULL | bcrypt hashed password |\n| `created_at` | DATETIME | DEFAULT CURRENT_TIMESTAMP | Account creation timestamp |\n| `last_login` | DATETIME | NULL | Last login timestamp |\n| `is_active` | BOOLEAN | DEFAULT 1 | Account active\u002Finactive status |\n\n**Indexes**:\n- `idx_geminicliui_users_username`: For fast username lookups\n- `idx_geminicliui_users_active`: For filtering active users\n\n#### First Run Setup\n1. On first server startup, database file is automatically created if it doesn't exist\n2. Table structure is loaded from `server\u002Fdatabase\u002Finit.sql`\n3. First access displays user registration screen\n4. First user is registered as administrator\n\n#### Security Features\n- Passwords are hashed with bcrypt before storage\n- JWT token-based authentication system\n- Session management with timeout functionality\n- SQL injection protection (prepared statements used)\n\n## Troubleshooting\n\n### Common Issues & Solutions\n\n#### \"No Gemini projects found\"\n**Problem**: The UI shows no projects or empty project list\n**Solutions**:\n- Ensure Gemini CLI is properly installed\n- Run `gemini` command in at least one project directory to initialize\n- Verify `~\u002F.gemini\u002Fprojects\u002F` directory exists and has proper permissions\n\n#### File Explorer Issues\n**Problem**: Files not loading, permission errors, empty directories\n**Solutions**:\n- Check project directory permissions (`ls -la` in terminal)\n- Verify the project path exists and is accessible\n- Review server console logs for detailed error messages\n- Ensure you're not trying to access system directories outside project scope\n\n#### Model Selection Not Working\n**Problem**: Selected model is not being used\n**Solutions**:\n- After selecting a model in settings, make sure to click \"Save Settings\"\n- Clear browser local storage and reconfigure\n- Verify the model name is displayed correctly in the chat interface\n\n## License\n\nGNU General Public License v3.0 - see [LICENSE](LICENSE) file for details.\n\nThis project is open source and free to use, modify, and distribute under the GPL v3 license.\n\n### Original Project\n\nThis project is based on [Claude Code UI](https:\u002F\u002Fgithub.com\u002Fsiteboon\u002Fclaudecodeui) (GPL v3.0) with customizations.\n\n**Major Changes:**\n- Adapted from Claude CLI to Gemini CLI\n- Added authentication system (SQLite-based)\n- Gemini-specific model selection feature\n- Enhanced Japanese language support\n- UI adjustments and Gemini branding\n\nThanks to the original Claude Code UI project.\n\n## Acknowledgments\n\n### Built With\n- **[Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli)** - Google's official CLI\n- **[React](https:\u002F\u002Freact.dev\u002F)** - User interface library\n- **[Vite](https:\u002F\u002Fvitejs.dev\u002F)** - Fast build tool and dev server\n- **[Tailwind CSS](https:\u002F\u002Ftailwindcss.com\u002F)** - Utility-first CSS framework\n- **[CodeMirror](https:\u002F\u002Fcodemirror.net\u002F)** - Advanced code editor\n\n## Support & Community\n\n### Stay Updated\n- **Star** this repository to show support\n- **Watch** for updates and new releases\n- **Follow** the project for announcements\n\n---","\u003Cdiv align=\"center\">\n  \u003Cimg src=\"public\u002Flogo.svg\" alt=\"Gemini CLI UI\" width=\"64\" height=\"64\">\n  \u003Ch1>Gemini CLI UI\u003C\u002Fh1>\n\u003C\u002Fdiv>\n\nGemini CLI 的桌面和移动界面，它是 Google 官方提供的 AI 辅助编程命令行工具。您可以在本地或远程使用它来查看 Gemini CLI 中的活动项目和会话，并以与在 Gemini CLI 中相同的方式对其进行修改。这为您提供了一个可在任何地方使用的完善界面。\n\n\n## 截图\n\n\u003Cdiv align=\"center\">\n\u003Ctable>\n\u003Ctr>\n\u003Ctd align=\"center\">\n\u003Ch3>聊天视图\u003C\u002Fh3>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcruzyjapan_Gemini-CLI-UI_readme_36f65bafba4b.png\" alt=\"桌面界面\" width=\"400\">\n\u003Cbr>\n\u003Cem>显示项目概览和聊天的主要界面\u003C\u002Fem>\n\u003C\u002Ftd>\n\u003Ctd align=\"center\">\n\u003Ch3>设置\u003C\u002Fh3>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcruzyjapan_Gemini-CLI-UI_readme_b3d193f517ae.png\" alt=\"移动界面\" width=\"400\">\n\u003Cbr>\n\u003Cem>设置\u003C\u002Fem>\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\u003Ctable>\n\u003Ctr>\n\u003Ctd align=\"center\">\n\u003Ch3>聊天视图\u003C\u002Fh3>\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcruzyjapan_Gemini-CLI-UI_readme_100ff30b1136.png\" alt=\"桌面界面\" width=\"800\">\n\u003Cbr>\n\u003Cem>Gemini CLI UI 架构图\u003C\u002Fem>\n\u003C\u002Ftd>\n\u003C\u002Ftable>\n\u003C\u002Fdiv align=\"center\">\n\n## 功能\n\n- **响应式设计** - 在桌面、平板和手机上都能无缝运行，因此您也可以在手机上使用 Gemini CLI\n- **交互式聊天界面** - 内置聊天界面，可与 Gemini CLI 无缝沟通\n- **集成的 Shell 终端** - 通过内置的 shell 功能直接访问 Gemini CLI\n- **文件管理器** - 带语法高亮和实时编辑功能的交互式文件树\n- **Git 管理器** - 查看、暂存并提交您的更改。您还可以切换分支\n- **会话管理** - 恢复对话、管理多个会话并跟踪历史记录\n- **模型选择** - 可从包括 Gemini 2.5 Pro 在内的多个 Gemini 模型中进行选择\n- **YOLO 模式** - 跳过确认提示以加快操作速度（请谨慎使用）\n\n## 快速入门\n\n### 先决条件\n\n- [Node.js](https:\u002F\u002Fnodejs.org\u002F) v20 或更高版本\n- 已安装并配置好 [Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli)\n\n### 安装\n\n1. **克隆仓库：**\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fcruzyjapan\u002FGemini-CLI-UI.git\ncd Gemini-CLI-UI\n```\n\n2. **安装依赖：**\n```bash\nnpm install\n```\n\n3. **配置环境：**\n```bash\ncp .env.example .env\n# 根据您的偏好编辑 .env 文件\n```\n\n**注意**：出于安全考虑，已移除 `.env` 文件。使用时请务必复制 `.env.example` 到 `.env`，并根据需要修改设置。\n\n4. **启动应用：**\n```bash\n# 开发模式（支持热重载）\nnpm run dev\n```\n应用程序将按照您在 `.env` 文件中指定的端口启动。\n\n5. **打开浏览器：**\n   - 开发环境：`http:\u002F\u002Flocalhost:4009`\n\n## 安全与工具配置\n\n**🔒 重要提示**：所有 Gemini CLI 工具默认处于禁用状态。这可以防止潜在的有害操作自动运行。\n\n### 启用工具\n\n要使用 Gemini CLI 的全部功能，您需要手动启用工具：\n\n1. **打开工具设置** - 点击侧边栏中的齿轮图标\n2. **选择性启用** - 仅开启您需要的工具\n3. **应用设置** - 您的偏好将被本地保存\n\n### 关于 YOLO 模式\n\nYOLO 模式（“You Only Live Once”）相当于 Gemini CLI 的 `--yolo` 标志，可跳过所有确认提示。此模式可加快您的工作速度，但应谨慎使用。\n\n**建议做法**：先启用基本工具，然后根据需要逐步添加更多工具。您随时可以调整这些设置。\n\n## 使用指南\n\n### 核心功能\n\n#### 项目管理\n该界面会自动从 `~\u002F.gemini\u002Fprojects\u002F` 中发现 Gemini CLI 项目，并提供：\n- **可视化项目浏览器** - 所有可用项目及其元数据和会话数量\n- **项目操作** - 重命名、删除和整理项目\n- **智能导航** - 快速访问最近的项目和会话\n\n#### 聊天界面\n- **使用响应式聊天或 Gemini CLI** - 您可以选择使用适配后的聊天界面，或点击 shell 按钮连接到 Gemini CLI\n- **实时通信** - 通过 WebSocket 连接流式传输来自 Gemini 的回复\n- **会话管理** - 恢复之前的对话或开始新的会话\n- **消息历史** - 包含时间戳和元数据的完整对话历史\n- **多格式支持** - 文本、代码块和文件引用\n- **图片上传** - 在聊天中上传图片并提问\n\n#### 文件管理器与编辑器\n- **交互式文件树** - 浏览项目结构，支持展开\u002F折叠导航\n- **实时文件编辑** - 直接在界面中读取、修改和保存文件\n- **语法高亮** - 支持多种编程语言\n- **文件操作** - 创建、重命名、删除文件和目录\n\n#### Git 管理器\n- **可视化更改** - 实时查看当前更改\n- **暂存与提交** - 直接从界面创建 Git 提交\n- **分支管理** - 切换和管理分支\n\n#### 会话管理\n- **会话持久化** - 所有对话都会自动保存\n- **会话组织** - 按项目和时间戳对会话进行分组\n- **会话操作** - 重命名、删除和导出对话历史\n- **跨设备同步** - 可从任何设备访问会话\n\n### 移动应用\n- **响应式设计** - 针对所有屏幕尺寸优化\n- **触控友好界面** - 滑动手势和触控导航\n- **移动端导航** - 底部标签栏便于拇指操作\n- **自适应布局** - 折叠侧边栏和智能内容优先级排序\n- **添加到主屏幕** - 将快捷方式添加到主屏幕后，应用将表现得像 PWA 一样\n\n## 架构\n\n### 系统概述\n\n```\n┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐\n│   前端          │    │   后端          │    │  Gemini CLI     │\n│   (React\u002FVite)  │◄──►│ (Express\u002FWS)    │◄──►│  集成           │\n└─────────────────┘    └─────────────────┘    └─────────────────┘\n```\n\n### 后端（Node.js + Express）\n- **Express 服务器** - 提供 RESTful API 和静态文件服务（端口：4008）\n- **WebSocket 服务器** - 用于聊天和项目刷新的通信\n- **Gemini CLI 集成** - 进程创建和管理\n- **会话管理** - JSONL 解析和对话持久化\n- **文件系统 API** - 向用户暴露项目文件浏览器\n- **认证系统** - 安全登录和会话管理（SQLite 数据库：geminicliui_auth.db）\n\n### 前端（React + Vite）\n- **React 18** - 使用 hooks 的现代组件架构\n- **CodeMirror** - 具有语法高亮功能的高级代码编辑器\n- **Tailwind CSS** - 基于实用程序的 CSS 框架\n- **响应式设计** - 以移动设备为先的设计方法\n\n## 配置详情\n\n### 端口设置\n- **API 服务器**：端口 4008（默认）\n- **前端开发服务器**：端口 4009（默认）\n- 这些端口可以在 `.env` 文件中更改\n\n### 数据库配置\n\n#### 初始设置与表结构\n- **数据库文件**: `server\u002Fdatabase\u002Fgeminicliui_auth.db`\n- **数据库类型**: SQLite 3\n- **初始化**: 服务器启动时自动创建并初始化\n\n#### 用户表详情\n\n**表名**: `geminicliui_users`\n\n| 列名         | 数据类型   | 约束               | 描述                                   |\n|--------------|------------|--------------------|----------------------------------------|\n| `id`         | INTEGER    | 主键自增           | 唯一用户标识符                         |\n| `username`   | TEXT       | 唯一，非空         | 登录用户名（推荐使用邮箱）             |\n| `password_hash` | TEXT     | 非空               | bcrypt 加密后的密码哈希值              |\n| `created_at` | DATETIME   | 默认当前时间戳     | 账户创建时间戳                         |\n| `last_login` | DATETIME   | 可为空             | 最后登录时间戳                         |\n| `is_active`  | BOOLEAN    | 默认 1             | 账户启用\u002F禁用状态                      |\n\n**索引**:\n- `idx_geminicliui_users_username`: 用于快速查找用户名\n- `idx_geminicliui_users_active`: 用于筛选活跃用户\n\n#### 首次运行设置\n1. 服务器首次启动时，若数据库文件不存在，则会自动创建。\n2. 表结构从 `server\u002Fdatabase\u002Finit.sql` 中加载。\n3. 首次访问时会显示用户注册界面。\n4. 第一个注册的用户将被设为管理员。\n\n#### 安全特性\n- 密码在存储前使用 bcrypt 进行哈希处理。\n- 基于 JWT 的认证系统。\n- 具有超时功能的会话管理。\n- SQL 注入防护（使用预处理语句）。\n\n## 故障排除\n\n### 常见问题及解决方案\n\n#### “未找到 Gemini 项目”\n**问题**: 界面显示无项目或项目列表为空。\n**解决方案**:\n- 确保 Gemini CLI 已正确安装。\n- 至少在一个项目目录中运行 `gemini` 命令以进行初始化。\n- 检查 `~\u002F.gemini\u002Fprojects\u002F` 目录是否存在且权限正确。\n\n#### 文件浏览器问题\n**问题**: 文件无法加载、权限错误、目录为空。\n**解决方案**:\n- 检查项目目录权限（在终端中运行 `ls -la`）。\n- 确认项目路径存在且可访问。\n- 查看服务器控制台日志以获取详细错误信息。\n- 确保未尝试访问项目范围之外的系统目录。\n\n#### 模型选择无效\n**问题**: 选择的模型未生效。\n**解决方案**:\n- 在设置中选择模型后，请务必点击“保存设置”。\n- 清除浏览器本地存储并重新配置。\n- 确认聊天界面中正确显示所选模型名称。\n\n## 许可证\n\nGNU 通用公共许可证 v3.0 - 详情请参阅 [LICENSE](LICENSE) 文件。\n\n本项目为开源项目，可在 GPL v3 许可证下自由使用、修改和分发。\n\n### 原始项目\n\n本项目基于 [Claude Code UI](https:\u002F\u002Fgithub.com\u002Fsiteboon\u002Fclaudecodeui)（GPL v3.0），并进行了定制化开发。\n\n**主要改动**:\n- 由 Claude CLI 改为 Gemini CLI。\n- 添加了基于 SQLite 的认证系统。\n- 引入了 Gemini 特有的模型选择功能。\n- 增强了对日语的支持。\n- 对 UI 进行了调整，并加入了 Gemini 品牌元素。\n\n感谢原始的 Claude Code UI 项目。\n\n## 致谢\n\n### 使用的技术\n- **[Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli)** - Google 官方 CLI\n- **[React](https:\u002F\u002Freact.dev\u002F)** - 用户界面库\n- **[Vite](https:\u002F\u002Fvitejs.dev\u002F)** - 快速构建工具及开发服务器\n- **[Tailwind CSS](https:\u002F\u002Ftailwindcss.com\u002F)** - 实用优先的 CSS 框架\n- **[CodeMirror](https:\u002F\u002Fcodemirror.net\u002F)** - 高级代码编辑器\n\n## 支持与社区\n\n### 关注最新动态\n- 点赞此仓库以表示支持。\n- 关注以获取更新和新版本发布。\n- 关注项目以接收相关公告。\n\n---","# Gemini-CLI-UI 快速上手指南\n\nGemini-CLI-UI 是一个专为 Google 官方 AI 编程助手 [Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli) 设计的桌面与移动端图形界面。它允许你通过浏览器直观地管理项目、进行对话聊天、编辑代码文件以及操作 Git，同时支持本地或远程部署。\n\n## 环境准备\n\n在开始之前，请确保你的系统满足以下要求：\n\n*   **Node.js**: 版本 v20 或更高。\n    *   *国内用户建议*：可使用 [cnpm](https:\u002F\u002Fnpmmirror.com\u002F) 或配置 npm 镜像源加速下载。\n    *   检查版本：`node -v`\n*   **Gemini CLI**: 必须已安装并完成基础配置。\n    *   确保已在终端运行过 `gemini` 命令至少一次，以初始化项目目录 (`~\u002F.gemini\u002Fprojects\u002F`)。\n*   **Git**: 用于克隆仓库及管理项目版本控制。\n\n## 安装步骤\n\n### 1. 克隆项目仓库\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fcruzyjapan\u002FGemini-CLI-UI.git\ncd Gemini-CLI-UI\n```\n\n### 2. 安装依赖\n建议使用国内镜像源加速安装过程：\n```bash\n# 使用 npm 原生配置淘宝镜像\nnpm install --registry=https:\u002F\u002Fregistry.npmmirror.com\n```\n\n### 3. 配置环境变量\n复制示例配置文件并修改所需设置（如端口号等）：\n```bash\ncp .env.example .env\n```\n> **注意**：出于安全考虑，项目中不包含默认的 `.env` 文件。请务必执行上述复制操作，并根据需要编辑 `.env` 文件。\n\n### 4. 启动应用\n以开发模式启动（支持热重载）：\n```bash\nnpm run dev\n```\n应用将在 `.env` 文件中指定的端口启动（默认为前端 **4009**，后端 API **4008**）。\n\n## 基本使用\n\n### 1. 访问界面\n打开浏览器访问：\n```text\nhttp:\u002F\u002Flocalhost:4009\n```\n首次运行时，系统将自动创建 SQLite 数据库并要求你注册管理员账号。\n\n### 2. 核心功能概览\n*   **项目浏览**：界面会自动扫描 `~\u002F.gemini\u002Fprojects\u002F` 下的所有 Gemini 项目，点击即可进入。\n*   **智能对话**：\n    *   直接在聊天框输入指令与 Gemini 交互。\n    *   支持上传图片进行分析。\n    *   可切换不同的 Gemini 模型（如 Gemini 2.5 Pro）。\n*   **文件与 Git 管理**：\n    *   左侧文件树支持实时查看、编辑和保存代码（带语法高亮）。\n    *   Git 面板可查看变更、暂存文件、提交代码及切换分支。\n*   **工具权限控制**（重要）：\n    *   出于安全考虑，所有 Gemini CLI 工具默认**禁用**。\n    *   点击侧边栏齿轮图标进入设置，按需开启特定工具（如文件写入、终端执行等）。\n    *   **YOLO 模式**：开启后可跳过确认提示以加快操作速度，请谨慎使用。\n\n### 3. 移动端适配\n该界面采用响应式设计，可直接在手机浏览器中使用。你也可以选择“添加到主屏幕”，将其作为 PWA（渐进式 Web 应用）安装，获得类似原生 App 的体验。","资深后端工程师李明正在通勤途中，急需利用碎片时间修复线上项目的紧急 Bug 并验证代码逻辑。\n\n### 没有 Gemini-CLI-UI 时\n- **设备受限严重**：由于缺乏图形界面，手机无法运行复杂的命令行交互，只能干着急等到回公司用电脑处理。\n- **操作繁琐易错**：在纯文本终端中难以直观浏览项目文件结构，修改多行代码时极易因误触导致语法错误。\n- **上下文割裂**：无法同时查看 Git 变更差异与 AI 对话历史，切换分支或提交代码时需要频繁中断思路去执行独立命令。\n- **安全风险难控**：AI 自动执行文件修改前缺乏可视化的确认步骤，容易在不知情的情况下覆盖重要配置。\n\n### 使用 Gemini-CLI-UI 后\n- **全端无缝协作**：借助响应式网页设计，李明在平板上即可通过直观的聊天窗口和文件树，像在公司一样流畅地进行 AI 辅助编程。\n- **可视化高效编辑**：内置的代码编辑器支持语法高亮和实时预览，他能直接选中报错函数让 AI 重构，无需手动敲入冗长指令。\n- **工作流深度集成**：Git 面板让他一边与 AI 讨论修复方案，一边直接查看 Diff、暂存更改并提交 Commit，保持了思维连贯性。\n- **可控的自动化**：通过设置页按需开启工具权限，他在关键操作前能清晰看到 AI 的计划并手动确认，彻底消除了“盲跑”脚本的隐患。\n\nGemini-CLI-UI 将原本局限于桌面的命令行能力解放到任意设备，让开发者在任何场景下都能拥有安全、可视且高效的全栈编程体验。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcruzyjapan_Gemini-CLI-UI_36f65baf.png","cruzyjapan","Cruzy Japan","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fcruzyjapan_ffa24580.png",null,"Cruzy Japan Co., Ltd.","Tokyo\u002FJapan","https:\u002F\u002Fwww.cruzy.jp","https:\u002F\u002Fgithub.com\u002Fcruzyjapan",[84,88,91],{"name":85,"color":86,"percentage":87},"JavaScript","#f1e05a",96.9,{"name":89,"color":90,"percentage":10},"CSS","#663399",{"name":92,"color":93,"percentage":94},"HTML","#e34c26",1.1,657,160,"2026-04-07T21:25:50","GPL-3.0","Linux, macOS, Windows","未说明",{"notes":102,"python":103,"dependencies":104},"该工具是基于 Web 的界面，需要预先安装并配置好 Google 官方的 Gemini CLI。后端使用 Node.js (Express) 和 SQLite 数据库（自动初始化），前端使用 React + Vite。默认端口为 API 4008 和前端开发服务器 4009（可在 .env 中修改）。出于安全考虑，所有 Gemini CLI 工具默认禁用，需在设置中手动启用。首次运行会自动创建用户管理系统，第一个注册用户将成为管理员。","不需要",[105,106,107,108,109,110,111,112,113],"Node.js v20+","React 18","Vite","Express","Tailwind CSS","CodeMirror","SQLite3","bcrypt","jsonwebtoken",[13],[116,117,118,119,120,121],"code-assistant","gemini-ai","gemini-cli","google-gemini","google-gemini-cli","session-management","2026-03-27T02:49:30.150509","2026-04-09T02:44:00.533278",[],[]]