# JiwuChat

**Repository Path**: KiWi233333/JiwuChat

## Basic Information

- **Project Name**: JiwuChat
- **Description**: JiwuChat 🍂 : 轻量级跨平台IM聊天应用，集成AI机器人( DeepSeek/Gemini/Kimi... )、音视频通话及AI购物。支持多端消息同步，自定义主题，高效便捷 🍒
- **Primary Language**: TypeScript
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: https://blog.jiwuchat.top/
- **GVP Project**: No

## Statistics

- **Stars**: 203
- **Forks**: 71
- **Created**: 2025-01-22
- **Last Updated**: 2025-11-03

## Categories & Tags

**Categories**: im

**Tags**: Tauri2, nuxt3, 即时通讯, AI, IM

## README

<div align=center>
 <div align=center margin="10em" style="margin:4em 0 0 0;font-size: 30px;letter-spacing:0.3em;">
<img src="./.doc/jiwuchat-tauri.png" width="140px" height="140px" alt="图片名称" align=center />
 </div>
 <h2 align=center style="margin: 2em 0;">极物聊天 Tauri APP</h2>

<div>
      <a href="https://github.com/Kiwi233333/JiwuChat" target="_blank">
        <img class="disabled-img-view" src="https://img.shields.io/badge/Github-项目地址-blueviolet.svg?style=plasticr" alt="项目地址" >
      </a>
      <a href="https://github.com/Kiwi233333/JiwuChat/stargazers" target="_blank">
        <img class="disabled-img-view" alt="License"
          src="https://img.shields.io/github/stars/Kiwi233333/JiwuChat.svg?style=social">
      </a>
    </div>
    <div>
      <a href="https://github.com/Kiwi233333/JiwuChat/commits" target="_blank">
        <img class="disabled-img-view" alt="Commit"
          src="https://img.shields.io/github/commit-activity/m/Kiwi233333/JiwuChat">
      </a>
      <a href="https://github.com/Kiwi233333/JiwuChat/issues" target="_blank">
        <img class="disabled-img-view" alt="Issues" src="https://img.shields.io/github/issues/Kiwi233333/JiwuChat">
      </a>
    </div>
    <div>
      <a href="`https://github.com/Kiwi233333/JiwuChat/blob/main/LICENSE`" target="_blank">
          <img class="disabled-img-view" alt="License"
          src="https://img.shields.io/github/license/Kiwi233333/JiwuChat">
      </a>
      <a href="https://app.netlify.com/sites/jiwuchat/deploys" target="_blank">
          <img src="https://api.netlify.com/api/v1/badges/b68ad9ac-53e5-4c5a-ac56-a8882ffe7697/deploy-status" alt="+QQ群"/>
      </a>
      <a href="https://qm.qq.com/q/iSaETNVdKw" target="_blank">
        <img src="https://img.shields.io/badge/QQ群:939204073 -blue?logo=tencentqq&logoColor=white" alt="QQ群"/>
      </a>
    </div>
    <div>
      <a href="https://www.deepseek.com/" target="_blank" style="margin: 2px;">
        <img alt="DeepSeek AI" src="https://github.com/deepseek-ai/DeepSeek-V2/blob/main/figures/badge.svg?raw=true" />
      </a>
    </div>

官网：[JiwuChat](https://blog.jiwuchat.top/) <br> 语言 : **简体中文** | [English](./.doc/README.en.md) | [Deutsch](./.doc/README.de.md) | [Español](./.doc/README.es.md) | [Français](./.doc/README.fr.md) | [日本語](./.doc/README.ja.md) | [한국어](./.doc/README.ko.md) | [Português](./.doc/README.pt.md) | [Русский](./.doc/README.ru.md)

</div>

## 介绍

JiwuChat 是一款基于 Tauri2 和 Nuxt3 构建的轻量`(~10MB)`多平台聊天应用，具备多种实时消息、AI群聊机器人（`讯飞星火`、`KimiAI`等已接入）、`WebRTC 音视频通话`、屏幕共享以及 AI 购物功能。它支持无缝跨设备通信，涵盖文本、图片、文件和语音等多种消息，还支持群聊和可定制化设置。提供浅色/深色模式，助力高效社交网络。✨

## 一套代码，多端适配

![多端适配](.doc/previews.png)

## 默认账号

- 账号：ikun233
- 密码：123456
- 体验：[Web端地址](https://jiwuchat.top/)

> ⚠ 注：~~该账号上传文件、修改个人信息、修改密码等部分没有权限，只作为测试账号使用。~~

> 👀 感谢大家的支持，项目还在开发阶段，后端暂未开源，欢迎大家提出宝贵意见，如有问题请联系邮箱或QQ。

## 项目截图

- 🖥️ **桌面端**

![登录](.doc/desktop/login.png)

![首页](.doc/desktop/home.png)

![AI对话暗色主题](.doc/desktop/home_ai_dark.png)

![AI群聊功能](.doc/desktop/ai.png)

![好友列表](.doc/desktop/friend.png)

![账号与安全](.doc/desktop/safe.png)

![API 开发](.doc/desktop/api_key.png)

![扩展菜单](.doc/desktop/extention_menu.png)

![扩展-悦读时光](.doc/desktop/extention_book.png)

![设置页面](.doc/desktop/setting.png)

- 📱 **移动端适配**

<div>
 <img src=".doc/mobile/chat12.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src=".doc/mobile/chat14.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src=".doc/mobile/chat13.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src="./.doc/chat7.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src="./.doc/rtc2.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src="./.doc/rtc_remove_desktop.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src=".doc/mobile/chat8.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src=".doc/mobile/chat10.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src=".doc/mobile/chat15.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src=".doc/mobile/chat11.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src=".doc/mobile/chat17.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src=".doc/mobile/chat16.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src=".doc/mobile/chat9.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
</div>

- 🌐 **Web端**

![Web端](.doc/web/login.png)

## 🌌 系统功能

![Modules](.doc/JiwuChat%20功能导图.png)

<details>
  <summary>功能表格【展开/折叠】</summary>

| 模块       | 子模块     | 功能描述                                                                | 是否达成 |
| ---------- | ---------- | ----------------------------------------------------------------------- | -------- |
| 用户模块   | 账户管理   | 用户注册、登录、历史登录账号选择                                        | ✅       |
|            | 账号安全   | 邮箱/手机号绑定提醒、设备管理、账号安全验证                             | ✅       |
| 消息模块   | 基础聊天   | 文本消息、图片消息、视频消息、文件上传、消息撤回、消息已读状态          | ✅       |
|            | 数据同步   | 多设备消息同步、阅读状态同步                                            | ✅       |
|            | 高级聊天   | 消息引用回复、@提及功能、公告、撤回消息重新编辑                         | ✅       |
| 会话模块   | 会话管理   | 会话列表、置顶会话、隐藏会话、会话未读数统计、会话排序                  | ✅       |
| 群聊模块   | 群聊操作   | 创建群聊、退出群聊、查看群聊详情                                        | ✅       |
|            | 群成员管理 | 群成员管理、设置管理员、撤销管理员、获取@列表                           | ✅       |
| 联系人模块 | 好友操作   | 好友申请、好友搜索、好友列表、拒绝好友申请、删除好友                    | ✅       |
|            | 资料与通知 | 好友详情查看、申请未读数统计                                            | ✅       |
| AI模块     | 对话功能   | 私聊AI、群聊AI、多AI同时聊天                                            | ✅       |
|            | 模型管理   | 支持Gmini、Kimi AI、DeepSeek、硅基流动等多厂商模型、模型列表、token计算 | ✅       |
|            | 广场功能   | AI机器人广场展示                                                        | ✅       |
| 通讯模块   | 音视频通话 | 基于WebRtc的语音通话、视频通话、屏幕共享                                | ✅       |
|            | 通话记录   | 通话状态更新、挂断记录                                                  | ✅       |
| 通知系统   | 消息通知   | 桌面通知、系统托盘提醒、铃声设置、消息免打扰                            | ✅       |
| 扩展功能   | 综合集成   | 商城集成、博客集成、更新日志面板                                        | ✅       |
| 其他模块   | 其他功能   | 聊天社交功能、AI购物功能、文件下载管理、翻译工具（AI翻译/腾讯翻译）功能 | ✅       |
|            | 文件与播放 | 图片预览器、视频播放器、文件下载、批量图片上传                          | ✅       |
|            | 主题配置   | 深浅色主题切换、系统主题跟随、字体设置、自适应布局                      | ✅       |
|            | 平台兼容   | Windows、MacOS、Linux、Android、Web端适配                               | ✅       |

</details>

## ⏳ 开发

### 📦 前置操作

- 前置环境、配置 [Tauri 官方文档](https://tauri.app/zh-cn/start/prerequisites/)

### ✨ 文档说明

- 详细操作文档可查看 [Run.md](./Run.md)

### 🔧 涉及技术栈 | Tech Stack

| 类别           | 技术/组件    | 版本号     |
| -------------- | ------------ | ---------- |
| 框架           | Nuxt         | ^3.14.159+ |
|                | Tauri        | ^2.1.0     |
| UI 组件库      | Element Plus | ^2.8.4     |
| 状态管理       | Pinia        | 2.1.7      |
| 工具库         | Vueuse       | 10.11.0    |
| 构建与开发工具 | Nuxi         | lts        |
|                | Vite         | lts        |
| 代码质量       | ESLint       | 8.56.0     |
|                | Prettier     | 3.3.2      |
| 类型检查       | TypeScript   | 5.3.2      |
| 样式处理       | Sass         | 1.77.6     |

## 📢 推广 | Promotion

**302.AI** 是一个按用量付费的企业级AI资源平台，提供市场上最新、最全面的AI模型和API，以及多种开箱即用的在线AI应用。

[![302.AI](.doc/promotion/302.AI.jpg)](https://share.302.ai/T4GVx3)

<hr/>

## ❓ 常见问题 | FAQ

- **MacOS 用户安装出现错误：**

<!-- 折叠 -->
<details>
macOS 系统下载并安装本项目时，可能会提示“安装包已损坏”或遇到证书相关问题，这是由于系统安全机制所致。请按以下步骤操作：

1. 打开「系统设置」-「安全性与隐私」，勾选允许“任何来源”下载的 App 运行（如图所示：img_10.png）。
2. 若仍有报错，请在终端执行以下命令：

   **安装前执行：**

   ```shell
   sudo xattr -rd com.apple.quarantine 你的安装包路径/下载的安装包名称
   ```

   **如果已经安装，则执行：**

   ```shell
   sudo xattr -r -d com.apple.quarantine /Applications/应用名称.app
   ```

</details>

- 如有常见问题，欢迎在 [Issues](https://github.com/KiWi233333/JiwuChat/Issues) 区留言，或通过下方联系方式反馈，我们会及时补充与解答。

## 🦾 趋势

![JiwuChat Star History Chart](https://api.star-history.com/svg?repos=KiWi233333/JiwuChat&type=Date)

## 💬 联系方式

- 邮箱：[kiwi2333@qq.com](mailto:kiwi2333@qq.com)
- QQ: [1329634286](https://wpa.qq.com/msgrd?v=3&uin=1329634286&site=qqq&menu=yes)
- QQ群: [939204073](https://qm.qq.com/q/iSaETNVdKw)