# 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**: 194
- **Forks**: 68
- **Created**: 2025-01-22
- **Last Updated**: 2025-09-01

## 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。

## 项目截图

- 聊天桌面应用 Login / Register

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

![注册](./.doc/register.png)

<table align="center">
  <tr>
    <td align="center">
      <img src="./.doc/chat1.png" alt="浅色主题" width="280" style="border-radius: 0.5rem; box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); margin: 6px;">
      <br><em>🌙 深浅色主题</em>
    </td>
    <td align="center">
      <img src="./.doc/group-ai-ds.png" alt="AI机器人" width="280" style="border-radius: 0.5rem; box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); margin: 6px;">
      <br><em>🤖 AI机器人 (DeepSeek、Gemini)</em>
    </td>
    <td align="center">
      <img src="./.doc/rtc1.png" alt="语音视频聊天" width="280" style="border-radius: 0.5rem; box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); margin: 6px;">
      <br><em>📞 语音视频聊天 WebRTC</em>
    </td>
  </tr>
  <tr>
    <td align="center">
      <img src="./.doc/chat.png" alt="主页" width="280" style="border-radius: 0.5rem; box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); margin: 6px;">
      <br><em>🏠 主页界面</em>
    </td>
    <td align="center">
      <img src="./.doc/group-ai-2.png" alt="AI群聊" width="280" style="border-radius: 0.5rem; box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); margin: 6px;">
      <br><em>🤖 AI群聊功能</em>
    </td>
    <td align="center">
      <img src="./.doc/rtc3.png" alt="屏幕共享" width="280" style="border-radius: 0.5rem; box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); margin: 6px;">
      <br><em>📺 屏幕内容共享</em>
    </td>
  </tr>
  <tr>
    <td align="center">
      <img src="./.doc/chat2.png" alt="暗黑主题" width="280" style="border-radius: 0.5rem; box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); margin: 6px;">
      <br><em>🌙 暗黑主题</em>
    </td>
    <td align="center">
      <img src="./.doc/chat3.png" alt="AI购物聊天" width="280" style="border-radius: 0.5rem; box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); margin: 6px;">
      <br><em>🛒 AI购物聊天</em>
    </td>
    <td align="center">
      <img src="./.doc/chat4.png" alt="账号与安全" width="280" style="border-radius: 0.5rem; box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); margin: 6px;">
      <br><em>🔐 账号与安全</em>
    </td>
  </tr>
  <tr>
    <td align="center">
      <img src="./.doc/group-ai-1.png" alt="AI机器人广场" width="280" style="border-radius: 0.5rem; box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); margin: 6px;">
      <br><em>🤖 AI机器人广场</em>
    </td>
    <td align="center">
      <img src="./.doc/chat3.2.png" alt="购物功能" width="280" style="border-radius: 0.5rem; box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); margin: 6px;">
      <br><em>🛍️ 购物功能界面</em>
    </td>
    <td align="center">
      <img src="./.doc/chat5.png" alt="设备管理" width="280" style="border-radius: 0.5rem; box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); margin: 6px;">
      <br><em>📱 设备管理</em>
    </td>
  </tr>
  <tr>
    <td align="center">
      <img src="./.doc/chat6-light.png" alt="设置页面" width="280" style="border-radius: 0.5rem; box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05); margin: 6px;">
      <br><em>⚙️ 设置页面</em>
    </td>
    <td align="center"></td>
    <td align="center"></td>
  </tr>
</table>

- 移动端适配

<div>
 <img src="./.doc/chat12.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src="./.doc/chat14.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src="./.doc/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/chat8.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src="./.doc/chat10.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src="./.doc/chat15.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src="./.doc/chat11.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src="./.doc/chat17.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src="./.doc/chat16.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
 <img src="./.doc/chat9.png" width = "160" style="display:inline-block;" alt="移动端适配" align=center />
</div>

## 🌌 系统功能

![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       |

## ❓ 常见问题 | 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)