> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/HuLaSpark/HuLa) · [上游 README](https://github.com/HuLaSpark/HuLa/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
基于 Tauri、Vite 7、Vue 3 和 TypeScript 构建的即时通讯系统
中文 |
English |
Deutsch |
Español |
français |
日本語 |
한국어 |
Português |
Русский
## 🌐 支持的平台
| 平台 | 支持版本 |
|----------|-------------------|
| Windows | Windows 10、Windows 11 |
| macOS | macOS 10.5+（已支持 Mac26） |
| Linux | Ubuntu 22.0+ |
| iOS | iOS 9.0+（支持 iOS26 真机。Tauri 不支持在 iOS26 模拟器上运行的 Intel 芯片） |
| Android | Android 12+（SDK30+） |
| Web | ⚠️ 当前不支持（需自行移除相关功能） |
## 📝 项目简介
HuLa 是一款基于 Tauri、Vite 7、Vue 3 和 TypeScript 构建的即时通讯系统。它利用 Tauri 的跨平台能力以及 Vue 3 的响应式设计，结合 TypeScript 的类型安全特性和 Vite 7 的快速构建流程，为用户提供高效、安全且易用的通信解决方案。
## 🛠️ 技术栈
- **Tauri**：为本项目提供轻量、高性能的桌面应用容器，使我们能够使用前端技术栈开发跨平台桌面应用。Tauri 的设计理念是在确保安全的同时尽可能降低资源消耗。
- **Vite 7**：Vite 是一款现代前端构建工具，利用原生 ES 模块（ES module）导入提供快速的开发服务器，同时为生产环境打包提供强大支持。Vite 7 是其最新版本，带来更多优化与功能。
- **Vue 3**：Vue 3 是一款用于构建用户界面的渐进式 JavaScript 框架。其 Composition API、更好的 TypeScript 集成以及移动端优化，使开发复杂的单页应用（SPA）更加简单高效。
- **TypeScript**：TypeScript 是 JavaScript 的超集，在 JavaScript 之上添加了类型系统。这使我们能够在开发阶段捕获更多错误，并获得更好的编辑器支持。
## 🖼️ 项目预览
🎨 界面展示
PC 端界面展示，截图中未涵盖其他功能，请下载自行体验
移动端界面展示
## ✨ 功能特性
🎯 开发进度总览
### 🔐 用户认证系统
| 功能 | 描述 | 状态 |
|---------|-------------|--------|
| 🔑 | 用户名/密码登录 |  |
| 📱 | 二维码扫码登录 |  |
| 💻 | 多设备登录管理 |  |
### 💬 消息通讯
| 功能 | 描述 | 状态 |
|---------|-------------|--------|
| 👤 | 一对一私聊 |  |
| 👥 | 群聊 |  |
| ↩️ | 消息撤回 |  |
| 📢 | @提及与回复功能 |  |
| 👁️ | 消息已读状态 |  |
| 😊 | 表情功能 |  |
| 🖱️ | 消息右键菜单 |  |
| 🔗 | 链接预览卡片 |  |
| 👍 | 消息点赞互动 |  |
| 📔 | 聊天记录管理 |  |
### 🤝 社交管理
| 功能 | 描述 | 状态 |
|---------|-------------|--------|
| ➕ | 添加与删除好友 |  |
| 🔍 | 好友搜索 |  |
| 🏢 | 群组创建与管理 |  |
| 🟢 | 好友在线状态 |  |
| 🎖️ | 好友徽章系统 |  |
| 🚫 | 屏蔽与免打扰 |  |
| 📤 | 消息转发 |  |
| 📋 | 群公告 |  |
| 🏷️ | 昵称与备注管理 |  |
| 📍 | 获取与发送位置 |  |
| 🔥 | 扫码登录并加入群组 |  |
### 🎨 用户体验
| 功能 | 描述 | 状态 |
|---------|-------------|--------|
| 🖼️ | 现代化 UI 设计 |  |
| 🌙 | 深色与浅色主题 |  |
| 🎭 | 皮肤主题切换 |  |
### 🛠️ 系统功能
| 功能 | 描述 | 状态 |
|---------|-------------|--------|
| 🪟 | 多窗口管理 |  |
| 🔔 | 系统托盘通知 |  |
| 📷 | 图片查看器 |  |
| ✂️ | 截图功能 |  |
| 🎙️ | 语音通话 |  |
| 🎥 | 视频通话 |  |
| ⌨️ | 全局快捷键控制 |  |
| 📺 | 专用媒体查看器 |  |
| 📁 | 文件上传（七牛云） |  |
| 🔄 | 自动更新系统 |  |
| 🌍 | 国际化（i18n）支持 |  |
### 🌐 跨平台支持
| 功能 | 描述 | 状态 |
|---------|-------------|--------|
| 💻 | Windows/macOS/Linux |  |
| 📱 | iOS/Android 适配 |  |
### 🤖 AI 集成
| 功能 | 描述 | 状态 |
|---------|-------------|--------|
| 🧠 | AI 聊天助手 |  |
| 🔌 | 多平台 AI 支持 |  |
## 应用升级赞助
## 👏 感谢所有贡献者！
> [!NOTE]
> 特别感谢 [@dennis9486](https://github.com/dennis9486) 交付了位于 `src/components/common/Screenshot.vue` 的初始截图功能实现，为桌面端截图体验奠定了基础。
## 📥 安装与运行
```bash
# 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
```
## ⚠️ 重要说明（macOS 用户）
从网络下载安装包时，可能会出现安装包已损坏的提示，这可能是由于 macOS 安全机制导致的证书问题。请按以下步骤解决：
#### 1. 打开「系统设置」-「安全性与隐私」，按下图所示勾选：允许从「任何来源」下载的应用运行：
#### 2. 若问题仍未解决，请在终端中执行以下命令：
```bash
## Execute before installation
sudo xattr -rd com.apple.quarantine path/to/your/downloaded/package
```
```bash
## If already installed, execute the following
sudo xattr -r -d com.apple.quarantine /Applications/ApplicationName.app
```
## 📋 提交规范
执行 **pnpm run commit** 以调用 _git commit_ 交互流程，根据提示完成信息填写与选择。
## ⚖️ 免责声明
1. 本项目以开源项目形式提供。在法律允许的范围内，开发者不对软件的功能、安全性或适用性提供任何形式的明示或默示担保。
2. 用户明确理解并同意，使用本软件的风险完全由用户自行承担。软件按「现状」和「可用」基础提供。开发者不提供任何形式的担保，无论是明示还是默示，包括但不限于适销性、特定用途适用性和不侵权的担保。
3. 在任何情况下，开发者或其供应商均不对因使用本软件而产生的任何直接、间接、附带、特殊、惩罚性或后果性损害承担责任，包括但不限于利润损失、业务中断、个人信息泄露或其他商业损害或损失。
4. 所有对本项目进行二次开发的用户，均须承诺将本软件用于合法用途，并负责遵守当地法律法规。
5. 开发者有权随时修改软件的功能或特性，以及本免责声明的任何部分，这些修改可能以软件更新的形式体现。
**本免责声明的最终解释权归开发者所有**
## 🎁 支持项目
💝 赞助支持
如果你觉得 HuLa 有帮助，欢迎赞助支持我们。你的支持是我们持续前进的动力！
---
## 💬 加入社区
🤝 HuLa 社区交流群
与开发者和用户一起讨论，获取最新消息与技术支持
使用 HuLa 移动端应用扫描下方 Issues 群二维码，随时分享反馈。
## 🙏 感谢赞助商
💎 贡献者名人堂
感谢以下朋友对 HuLa 项目的慷慨支持！
### 💎 钻石赞助商（￥1000+）
| 💝 日期 | 👤 赞助商 | 💰 金额 | 🏷️ 平台 |
|---------|----------|--------|---------|
| 2025-09-12 | **翟可** | `¥1688` |  |
### 🏆 黄金赞助商（$15+）
| 💝 日期 | 👤 赞助商 | 💰 金额 | 🏷️ 平台 |
|---------|----------|--------|---------|
| 2025-12-13 | **M（PiDAOLab）** | `¥500` |  |
| 2025-11-12 | **星** | `¥500` |  |
| 2025-09-03 | **烛火** | `¥500` |  |
| 2025-09-05 | **Orion** | `¥200` |  |
| 2025-10-24 | **唐勇（伏威）** | `¥400` |  |
| 2025-08-26 | **唐勇** | `¥200` |  |
| 2025-04-25 | **上官俊斌** | `¥200` |  |
| 2025-05-27 | **临安居士** | `¥188` |  |
| 2025-04-20 | **姜兴(Simon)** | `¥188` |  |
| 2025-02-17 | **禾硕** | `¥168` |  |
| 2025-10-16 | **xx豪** | `¥101` |  |
| 2025-12-25 | **三愿** | `¥100` |  |
| 2025-10-15 | **兵** | `¥100` |  |
| 2025-08-13 | **zhongjing** | `¥100` |  |
| 2025-07-15 | **粉兔** | `¥100` |  |
| 2025-02-8 | **Boom....** | `¥100` |  |
### 🥈 银牌赞助商（$8-14）
| 💝 日期 | 👤 赞助者 | 💰 金额 | 🏷️ 平台 |
|---------|----------|--------|---------|
| 2025-11-29 | **Sven** | `¥66` |  |
| 2025-06-26 | **m udDy🐖** | `¥88` |  |
| 2025-05-09 | **犹豫，就会败北。** | `¥88` |  |
| 2025-04-01 | **墨** | `¥88.88` |  |
| 2025-02-8 | **邓伟** | `¥88` |  |
| 2025-02-7 | **dennis** | `¥40` |  |
| 2025-11-5 | **匿名用户** | `¥66` |  |
| 2025-02-6 | **小二** | `¥62` |  |
| 2025-05-15 | **孤鸿影** | `¥56` |  |
| 2026-01-14 | **赵赫** | `¥50` |  |
| 2026-01-05 | **Dumbness** | `¥50` |  |
### 🥉 铜牌赞助商（$3-7）
| 💝 日期 | 👤 赞助者 | 💰 金额 | 🏷️ 平台 |
|---------|----------|--------|---------|
| 2025-08-12 | **云鹏** | `¥20` |  |
| 2025-08-12 | ***持** | `¥20` |  |
| 2025-06-03 | **洪流** | `¥20` |  |
| 2025-05-27 | **刘启成** | `¥20` |  |
| 2025-05-20 | **匿名赞助者** | `¥20` |  |
> 📝 **温馨提示**
> 本列表为人工更新。若您已赞助但未列入，请联系我们：
> 🐛 [GitHub Issue](https://github.com/HuLaSpark/HuLa/issues) | 📧 Email: `2439646234@qq.com` | 💬 WeChat: `cy2439646234`
---
## 📄 开源许可证
⚖️ 许可证信息
本项目遵循开源许可协议。详细信息请查看上方的许可证报告
---
🌟 感谢您的关注
如果您觉得 HuLa 有价值，请给我们一颗 ⭐ Star，这是对我们最大的鼓励！
让我们一起打造更好的即时通讯体验 🚀
