wehub-resource-sync
28 KiB
Note
本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 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 交付了位于
src/components/common/Screenshot.vue的初始截图功能实现，为桌面端截图体验奠定了基础。
📥 安装与运行
# 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. 若问题仍未解决，请在终端中执行以下命令：
## 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
📋 提交规范
执行 pnpm run commit 以调用 git commit 交互流程，根据提示完成信息填写与选择。
⚖️ 免责声明
- 本项目以开源项目形式提供。在法律允许的范围内，开发者不对软件的功能、安全性或适用性提供任何形式的明示或默示担保。
- 用户明确理解并同意，使用本软件的风险完全由用户自行承担。软件按「现状」和「可用」基础提供。开发者不提供任何形式的担保，无论是明示还是默示，包括但不限于适销性、特定用途适用性和不侵权的担保。
- 在任何情况下，开发者或其供应商均不对因使用本软件而产生的任何直接、间接、附带、特殊、惩罚性或后果性损害承担责任，包括但不限于利润损失、业务中断、个人信息泄露或其他商业损害或损失。
- 所有对本项目进行二次开发的用户，均须承诺将本软件用于合法用途，并负责遵守当地法律法规。
- 开发者有权随时修改软件的功能或特性，以及本免责声明的任何部分，这些修改可能以软件更新的形式体现。
本免责声明的最终解释权归开发者所有
🎁 支持项目
💝 赞助支持
如果你觉得 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 | 📧 Email:
2439646234@qq.com| 💬 WeChat:cy2439646234
📄 开源许可证
⚖️ 许可证信息
本项目遵循开源许可协议。详细信息请查看上方的许可证报告
🌟 感谢您的关注
如果您觉得 HuLa 有价值，请给我们一颗 ⭐ Star，这是对我们最大的鼓励！
让我们一起打造更好的即时通讯体验 🚀