mirror of
https://github.com/HuLaSpark/HuLa.git
synced 2026-09-01 14:52:48 +08:00
wanwanruwoxin
49aef65e5c
* feat(store): ✨ rust集成 sqlite * chore(config): 🔨 移除一些不必要的文件 * feat(common): ✨ 群组信息 command * feat(common): ✨ rust 重构 * feat(common): ✨ tauri 登录命令 存储 token * feat(common): ✨ tauri 存储 room 信息 * feat(common): ✨ sqlite 存储房间信息，群成员信息 * feat(common): ✨ 修改我的群的信息 * feat(common): ✨ 游标分页查询群组成员 * feat(common): ✨ 查询全部群成员；优化前端显示逻辑 * feat(common): ✨ 更新 gitignore * feat(common): ✨ 使用缓存检测是否强制更新本地数据，或采取静默更新 * fix(hook): 🐛 枚举使用错误修复 * feat(common): ✨ sqlite 存储会话 * feat(common): ✨ sqlite 存储聊天信息 * fix(common): 🐛 sqlite需要根据登录的用户 id 进行数据隔离 * fix(common): 🐛 添加 sqlite数据库迁移代码 * fix(view): 🐛 会话接口新增detailId;sqlite 数据结构变更;登录保存用户 id bug 修复; * feat(common): ✨ sqlite 存储消息 * fix(common): 🐛 sqlite 存储消息体异常 * feat(common): ✨ 添加 tauri 日志插件 * feat(common): ✨ rust 层发送消息 * fix(component): 🐛 群成员监听显示问题;tauri 事件监听响应多次问题;消息列表显示顺序问题; * fix(common): 🐛 im_message 表关闭 nickname 非空限制 * fix(common): 🐛 设置账号第一次在客户端登录,设置is_init 为 true,进行初始化获取近期所有消息 * fix(common): 🐛 配置 tauri 的环境变量,用于 migration 启动 * fix(common): 🐛 登录之后,聊天页面初始化,未显示聊天记录 bug * feat(system): ✨ 合并master * style(common): 💄 引入 tauri websocket; 格式化 rust 代码; * fix(common): 🐛 ws 接收消息存储本地 * fix(common): 🐛 rust 报错没有在前端提示问题修复 * fix(common): 🐛 修复登录页面请求接口 bug,以及首屏骨架屏问题; * fix(common): 🐛 token 更新bug修复 * feat(common): ✨ 离线消息同步 * fix(common): 🐛 将数据库迁移 crate 集成到主进程中 * style(common): 💄 修改 tauri 日志配置,输出日志到 logs 目录下;并对日志级别添加颜色; * feat(common): ✨ 引入 tauri-devtools * docs(common): 📝 env文件修改 * fix(common): 🐛 rust 依赖调整;配置调整; * build(config): 📦 修改配置 --------- Co-authored-by: Dawn <2439646234@qq.com>
An instant messaging system built with Tauri, Vite 7, Vue 3, and TypeScript
📊 Project Statistics
🔖 Project Certification
🛠️ Tech Stack
中文 | English | Deutsch | Español | français | 日本語 | 한국어 | Português | Русский
🌐 Supported Platforms
| Platform | Supported Versions |
|---|---|
| Windows | Windows 10, Windows 11 |
| macOS | macOS 10.5+ |
| Linux | Ubuntu 22.0+ |
| iOS/iPadOS | iOS 9.0+, iPadOS 9.0+ |
| Android | Android 8.0+ |
📝 Project Introduction
HuLa is an instant messaging system built with Tauri, Vite 7, Vue 3, and TypeScript. It leverages Tauri's cross-platform capabilities and Vue 3's reactive design, combined with TypeScript's type safety features and Vite 7's fast build process, providing users with an efficient, secure, and user-friendly communication solution.
🛠️ Tech Stack
- Tauri: Provides a lightweight, high-performance desktop application container for this project, enabling us to develop cross-platform desktop applications using frontend technology stack. Tauri's design philosophy is to minimize resource consumption while ensuring security.
- Vite 7: Vite is a modern frontend build tool that leverages native ES module imports to provide a fast development server, while also offering powerful support for production environment packaging. Vite 7 is its latest version, bringing more optimizations and features.
- Vue 3: Vue 3 is a progressive JavaScript framework for building user interfaces. Its Composition API, better TypeScript integration, and mobile optimization make developing complex single-page applications simpler and more efficient.
- TypeScript: TypeScript is a superset of JavaScript that adds a type system on top of JavaScript. This allows us to catch more errors during development and provides better editor support.
🖼️ Project Preview
🎨 Interface Showcase
💬 Main Chat Interface |
🗨️ Chat Conversation Interface |
😊 Emoji Selection |
⚙️ System Settings |
🌟 Feature Highlights
📱 Diverse Messaging |
🎨 Status Toggle |
📷 Image Viewer |
👥 Group Management |
🤖 ChatBot Plugin Features |
🤖 ChatBot Settings Page |
✨ Features
🎯 Development Progress Overview
🔐 User Authentication System
| Feature | Description | Status |
|---|---|---|
| 🔑 | Username/Password Login |  |
| 📱 | QR Code Scan Login | |
| 💻 | Multi-device Login Management | |
💬 Message Communication
| Feature | Description | Status |
|---|---|---|
| 👤 | One-on-one Private Chat | |
| 👥 | Group Chat | |
| ↩️ | Message Recall | |
| 📢 | @Mention & Reply Features | |
| 👁️ | Message Read Status | |
| 😊 | Emoji Features | |
| 🖱️ | Message Right-click Menu | |
| 🔗 | Link Preview Cards | |
| 👍 | Message Like Interaction | |
🤝 Social Management
| Feature | Description | Status |
|---|---|---|
| ➕ | Add & Remove Friends | |
| 🔍 | Friend Search | |
| 🏢 | Group Creation & Management | |
| 🟢 | Friend Online Status | |
| 🎖️ | Friend Badge System | |
| 🚫 | Block & Do Not Disturb | |
| 📤 | Message Forwarding |  |
| 📋 | Group Announcements | |
| 🏷️ | Nickname & Remark Management | |
🎨 User Experience
| Feature | Description | Status |
|---|---|---|
| 🖼️ | Modern UI Design | |
| 🌙 | Dark & Light Theme | |
| 🎭 | Skin Theme Switching | |
🛠️ System Features
| Feature | Description | Status |
|---|---|---|
| 🪟 | Multi-window Management | |
| 🔔 | System Tray Notifications | |
| 📷 | Image Viewer | |
| ✂️ | Screenshot Feature | |
| 📁 | File Upload (Qiniu Cloud) | |
| 🔄 | Auto-update System | |
🌐 Cross-platform Support
| Feature | Description | Status |
|---|---|---|
| 💻 | Windows/macOS/Linux | |
| 📱 | iOS/Android Adaptation | |
🤖 AI Integration
| Feature | Description | Status |
|---|---|---|
| 🧠 | AI Chat Assistant | |
| 🔌 | Multi-platform AI Support | |
👏 Thanks to all Contributors!
📥 Installation & Running
# Clone the project
git clone https://gitee.com/HulaSpark/HuLa.git
# or
git clone https://github.com/HulaSpark/HuLa.git
# Enter project directory
cd HuLa
# Install dependencies
pnpm install
# Run development server
pnpm run tauri:dev
# Build for production
pnpm run tauri:build
⚠️ Important Notes (macOS Users)
Downloading installation packages from the web may show a damaged package prompt, possibly encountering certificate issues due to macOS security mechanisms. Please follow these steps to resolve:
1. Open "System Settings" - "Security & Privacy", check as shown: Allow apps downloaded from "Anywhere" to run:
2. If errors persist, execute the following commands in Terminal:
## Execute before installation
sudo xattr -rd com.apple.quarantine path/to/your/downloaded/package
## If already installed, execute the following
sudo xattr -r -d com.apple.quarantine /Applications/ApplicationName.app
📋 Commit Guidelines
Execute pnpm run commit to invoke git commit interaction, complete information input and selection according to prompts.
⚖️ Disclaimer
- This project is provided as an open-source project. Developers do not provide any form of explicit or implicit warranties for the functionality, security, or applicability of the software within the scope permitted by law.
- Users clearly understand and agree that the risk of using this software is entirely borne by the user. The software is provided on an "as is" and "as available" basis. Developers do not provide any form of warranty, whether explicit or implicit, including but not limited to warranties of merchantability, fitness for a particular purpose, and non-infringement.
- Under no circumstances shall developers or their suppliers be liable for any direct, indirect, incidental, special, punitive, or consequential damages, including but not limited to profit loss, business interruption, personal information leakage, or other commercial damages or losses arising from the use of this software.
- All users conducting secondary development on this project must commit to using this software for legal purposes and are responsible for complying with local laws and regulations.
- Developers have the right to modify the software's functions or features at any time, as well as any part of this disclaimer, and these modifications may be reflected in the form of software updates.
The final interpretation of this disclaimer belongs to the developers
🎁 Support the Project
💝 Sponsor Support
If you find HuLa helpful, welcome to sponsor and support us. Your support is our motivation to keep moving forward!
💬 Join Community
🤝 HuLa Community Discussion Group
Join developers and users for discussions, get the latest news and technical support
📱 Scan to Join WeChat Discussion Group
🙏 Thanks to Sponsors
💎 Contributors Hall of Fame
Thanks to the following friends for their generous support of the HuLa project!
🏆 Gold Sponsors ($15+)
| 💝 Date | 👤 Sponsor | 💰 Amount | 🏷️ Platform |
|---|---|---|---|
| 2025-04-25 | 上官俊斌 | ¥200 |
 |
| 2025-05-27 | 临安居士 | ¥188 |
|
| 2025-04-20 | 姜兴(Simon) | ¥188 |
|
| 2025-02-17 | 禾硕 | ¥168 |
 |
| 2025-07-15 | 粉兔 | ¥100 |
 |
| 2025-02-8 | Boom.... | ¥100 |
|
🥈 Silver Sponsors ($8-14)
| 💝 Date | 👤 Sponsor | 💰 Amount | 🏷️ Platform |
|---|---|---|---|
| 2025-06-26 | m udDy🐖 | ¥88 |
|
| 2025-05-09 | 犹豫，就会败北。 | ¥88 |
|
| 2025-04-01 | 墨 | ¥88.88 |
|
| 2025-02-8 | 邓伟 | ¥88 |
|
| 2025-02-7 | dennis | ¥80 |
 |
| 2025-02-6 | 小二 | ¥62 |
|
| 2025-05-15 | 孤鸿影 | ¥56 |
|
🥉 Bronze Sponsors ($3-7)
| 💝 Date | 👤 Sponsor | 💰 Amount | 🏷️ Platform |
|---|---|---|---|
| 2025-06-03 | 洪流 | ¥20 |
|
| 2025-05-27 | 刘启成 | ¥20 |
|
| 2025-05-20 | 匿名赞助者 | ¥20 |
|
📝 Friendly Reminder
This list is manually updated. If you have sponsored but are not listed, please contact us:
🐛 GitHub Issue | 📧 Email:2439646234@qq.com| 💬 WeChat:cy2439646234
📄 Open Source License
⚖️ License Information
This project follows open source license agreements. For detailed information, please check the license report above
🌟 Thank You for Your Attention
If you find HuLa valuable, please give us a ⭐ Star, which is the greatest encouragement for us!
Let's build a better instant messaging experience together 🚀