{"id":45637128,"url":"https://github.com/kiwi233333/jiwu-chat-core","last_synced_at":"2026-03-01T06:01:04.082Z","repository":{"id":340146149,"uuid":"1163807308","full_name":"KiWi233333/jiwu-chat-core","owner":"KiWi233333","description":"JiwuChat 🥝 : 轻量级跨平台IM聊天应用（自部署版），支持Docker 一键启动、多端消息同步、自定义主题等... 🍒 | 🌟 Star if you like it!","archived":false,"fork":false,"pushed_at":"2026-02-25T17:42:31.000Z","size":46906,"stargazers_count":12,"open_issues_count":0,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-27T09:28:04.324Z","etag":null,"topics":["android","chat","desktop","docker","im","nuxt3","tauri","vue"],"latest_commit_sha":null,"homepage":"https://jiwuchat.top","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KiWi233333.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-22T07:10:00.000Z","updated_at":"2026-02-25T17:37:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"badac63c-07ce-4676-b82a-9e0f044fb5ed","html_url":"https://github.com/KiWi233333/jiwu-chat-core","commit_stats":null,"previous_names":["kiwi233333/jiwu-chat-core"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/KiWi233333/jiwu-chat-core","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KiWi233333%2Fjiwu-chat-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KiWi233333%2Fjiwu-chat-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KiWi233333%2Fjiwu-chat-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KiWi233333%2Fjiwu-chat-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KiWi233333","download_url":"https://codeload.github.com/KiWi233333/jiwu-chat-core/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KiWi233333%2Fjiwu-chat-core/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29961852,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T05:59:08.471Z","status":"ssl_error","status_checked_at":"2026-03-01T05:58:04.208Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","chat","desktop","docker","im","nuxt3","tauri","vue"],"created_at":"2026-02-24T01:56:43.838Z","updated_at":"2026-03-01T06:01:04.025Z","avatar_url":"https://github.com/KiWi233333.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"frontend/.doc/jiwuchat-tauri.png\" width=\"120\" alt=\"JiwuChat\" /\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003e\n  \u003cstrong\u003eJiwuChat - 极物聊天\u003c/strong\u003e\n\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"./frontend/README.md\"\u003e前端文档\u003c/a\u003e ·\n  \u003ca href=\"./backend/README.md\"\u003e后端文档\u003c/a\u003e ·\n  \u003ca href=\"./frontend/Run.md\"\u003e运行说明\u003c/a\u003e ·\n  \u003ca href=\"https://blog.jiwuchat.top/\"\u003e官网\u003c/a\u003e \n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/KiWi233333/JiwuChat\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/Github-项目地址-blueviolet?style=flat\" alt=\"项目地址\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/KiWi233333/JiwuChat/stargazers\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/KiWi233333/JiwuChat?style=social\" alt=\"Stars\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://qm.qq.com/q/iSaETNVdKw\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/QQ群-939204073-blue?logo=tencentqq\u0026logoColor=white\" alt=\"QQ群\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n**多语言**：简体中文（本文） | [English](frontend/.doc/README.en.md) | [Deutsch](frontend/.doc/README.de.md) | [Español](frontend/.doc/README.es.md) | [Français](frontend/.doc/README.fr.md) | [日本語](frontend/.doc/README.ja.md) | [한국어](frontend/.doc/README.ko.md) | [Português](frontend/.doc/README.pt.md) | [Русский](frontend/.doc/README.ru.md)\n\n---\n\n## 介绍\n\n本仓库为 **Jiwu Chat Core** 单体仓库（Monorepo），包含极物聊天客户端与极物圈后端 API，前后端同仓便于本地联调与统一维护。\n\n- **前端 [JiwuChat](frontend/)**：基于 **Tauri 2** 与 **Nuxt 4** 的轻量（约 10MB）多平台聊天应用，支持桌面 / Web / 移动端；具备实时消息、深浅色主题等。\n- **后端 [Jiwu Hub API](backend/)**：基于 **Spring Boot 3.5** 与 **Java 21** 的后端服务，提供用户与系统管理、资源管理、账单钱包，以及基于 **Netty WebSocket** 的实时聊天能力，可与本仓库前端或其他客户端配合使用。\n\n一套代码多端适配，前后端分离便于扩展与二次开发。\n\n---\n\n## 一套代码，多端适配\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"frontend/.doc/previews.png\" alt=\"多端适配\" width=\"800\" /\u003e\n\u003c/p\u003e\n\n---\n\n## 默认账号\n\n| 项目 | 说明         |\n| ---- | ------------ |\n| 账号 | `superAdmin` |\n| 密码 | `123456`     |\n\n---\n\n## 仓库结构\n\n```\njiwu-chat-core/\n├── frontend/          # JiwuChat 客户端（Nuxt 4 + Tauri 2）\n│   ├── app/            # Nuxt 应用源码（页面、组件、composables）\n│   ├── src-tauri/      # Tauri 2 桌面/移动端 Rust 层\n│   ├── .doc/           # 截图、多语言 README\n│   ├── README.md       # 前端详细说明与截图\n│   └── Run.md          # 前端运行与调试说明\n├── backend/            # 极物圈 API（Spring Boot 3.5）\n│   ├── jiwu-chat-common-core/   # 公共核心（注解、异常、工具、配置）\n│   ├── jiwu-chat-common-data/  # 公共数据层（实体、Mapper、缓存、事件）\n│   ├── jiwu-chat-module-user/  # 用户服务（注册登录、资料、地址、钱包）\n│   ├── jiwu-chat-module-sys/   # 系统管理（角色、权限、菜单、API Key）\n│   ├── jiwu-chat-module-res/   # 资源管理（上传、OSS）\n│   ├── jiwu-chat-module-chat/  # 实时聊天（Netty WebSocket、消息、群组）\n│   ├── jiwu-chat-module-admin/ # 管理后台 API\n│   ├── jiwu-chat-starter/      # 启动模块（主类与配置）\n│   ├── docker-entrypoint-initdb.d/   # 数据库初始化脚本\n│   └── README.md       # 后端模块说明、API、部署\n└── README.md           # 本文件（主项目说明）\n```\n\n- 前端详细说明（技术栈、开发、截图、多语言）：[frontend/README.md](frontend/README.md)\n- 后端详细说明（模块、接口、环境变量、部署）：[backend/README.md](backend/README.md)\n- 前端运行与调试：[frontend/Run.md](frontend/Run.md)\n- **致谢**：[MallChat](https://github.com/zongzibinbin/MallChat)、Tauri、Nuxt、Vue、Spring Boot、MyBatis Plus、Netty、Knife4j 等开源项目。\n\n---\n\n## 快速开始\n\n\u003e **🛠 在线配置器**：可视化填写环境变量、自动生成 `.env` 文件与完整启动命令 →\n\u003e **[https://kiwi233333.github.io/jiwu-chat-core/](https://kiwi233333.github.io/jiwu-chat-core/)**\n\n\u003c!-- 配置图片+超链接 ./assets/config.png --\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"./assets/config.png\"\u003e\u003cimg src=\"./assets/config.png\" width=\"800\" alt=\"配置器\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n### 一、使用预构建镜像（推荐新用户）\n\n需已安装 [Docker](https://docs.docker.com/get-docker/) 与 Docker Compose。镜像见 [GitHub Packages](https://github.com/KiWi233333/jiwu-chat-core/pkgs/container/jiwu-chat-core)。\n\n**1. 拉取镜像**\n\n```bash\ndocker pull ghcr.io/kiwi233333/jiwu-chat-core:latest\n```\n\n**2. 创建配置（含 .env）**\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/KiWi233333/jiwu-chat-core/main/deploy/install.sh | bash -s latest\n```\n\n**3. 部署**\n\n```bash\ncd jiwu-chat-core \u0026\u0026 docker compose up -d\n```\n\n等待约 1–2 分钟（MySQL 初始化）后访问：前端 http://localhost:3000 · API http://localhost:9090 · 文档 http://localhost:9090/doc.html。默认账号 `superAdmin` / `123456`。\n\n### 二、Docker 一键启动（从源码构建，推荐开发）\n\n无需本地安装 MySQL / Redis / RabbitMQ / JDK / Node，在项目根目录从源码构建并启动完整系统：\n\n```bash\n# 在项目根目录执行（首次会构建镜像，约 5–15 分钟）\n./scripts/docker-start.sh\n\n# 或直接使用 docker compose\ndocker compose up -d --build\n```\n\n启动后可访问：\n\n| 服务      | 地址                                              |\n| --------- | ------------------------------------------------- |\n| 前端      | http://localhost:3000（npx serve .output/public） |\n| 后端 API  | http://localhost:9090                             |\n| API 文档  | http://localhost:9090/doc.html                    |\n| WebSocket | ws://localhost:9091/ws                            |\n\n默认体验账号：`ikun233` / `123456`。停止服务：`docker compose down`。详细说明见 [DOCKER.md](DOCKER.md)；前后端可配置项见 [CONFIG.md](CONFIG.md)（根目录 `.env`）。\n\n### 三、环境要求概览（本地开发）\n\n| 端   | 要求                                                                                          |\n| ---- | --------------------------------------------------------------------------------------------- |\n| 前端 | Node.js ≥20、pnpm ≥10、Rust（[Tauri 前置文档](https://tauri.app/zh-cn/start/prerequisites/)） |\n| 后端 | JDK 21+、Maven 3.8+、MySQL 8.0+、Redis 6.0+、RabbitMQ 3.11+（可选）                           |\n\n### 1. 克隆仓库\n\n```bash\ngit clone \u003c本仓库地址\u003e\ncd jiwu-chat-core\n```\n\n### 2. 启动后端\n\n```bash\ncd backend\n# 首次需初始化数据库，见 backend/docker-entrypoint-initdb.d/README-DB.md\nmysql -u root -p \u003c docker-entrypoint-initdb.d/jiwu-chat-db.sql\n\nmvn clean compile\nmvn spring-boot:run -pl jiwu-chat-starter\n```\n\n| 服务      | 地址                           |\n| --------- | ------------------------------ |\n| HTTP API  | http://localhost:9090          |\n| API 文档  | http://localhost:9090/doc.html |\n| WebSocket | ws://localhost:9091/ws         |\n\n### 3. 启动前端\n\n```bash\ncd frontend\npnpm install\npnpm run dev:nuxt    # Web 开发\npnpm run dev:tauri   # 桌面开发\n```\n\n更多命令（构建、移动端、调试）见 [frontend/README.md](frontend/README.md) 与 [frontend/Run.md](frontend/Run.md)。\n\n---\n\n## 技术栈概览\n\n| 端   | 类别       | 技术                                                       |\n| ---- | ---------- | ---------------------------------------------------------- |\n| 前端 | 框架       | Nuxt 4、Tauri 2、Vue 3、TypeScript                         |\n| 前端 | UI / 状态  | Element Plus、Pinia、UnoCSS                                |\n| 前端 | 构建       | Vite (rolldown-vite)、Nuxi                                 |\n| 后端 | 语言与框架 | Java 21、Spring Boot 3.5                                   |\n| 后端 | 数据与缓存 | MySQL 8、MyBatis Plus、Redis、Caffeine、RabbitMQ、Redisson |\n| 后端 | 实时通讯   | Netty WebSocket                                            |\n| 后端 | 文档       | Knife4j (OpenAPI 3)                                        |\n\n更细版本与说明见 [frontend/README.md](frontend/README.md) 与 [backend/README.md](backend/README.md)。\n\n---\n\n## 项目截图\n\n- **桌面端 / 移动端 / Web 端** 更多截图与说明见 [frontend/README.md#项目截图](frontend/README.md#项目截图)。\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"frontend/.doc/desktop/login.png\" width=\"280\" alt=\"登录\" /\u003e\n  \u003cimg src=\"frontend/.doc/desktop/home.png\" width=\"280\" alt=\"首页\" /\u003e\n  \u003cimg src=\"frontend/.doc/desktop/ai.png\" width=\"280\" alt=\"AI群聊\" /\u003e\n\u003c/p\u003e\n\n---\n\n## 系统功能\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"frontend/.doc/JiwuChat%20功能导图.png\" alt=\"功能导图\" width=\"700\" /\u003e\n\u003c/p\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cstrong\u003e功能表格（展开/折叠）\u003c/strong\u003e\u003c/summary\u003e\n\n| 模块       | 子模块     | 功能描述                                                       | 是否达成 |\n| ---------- | ---------- | -------------------------------------------------------------- | -------- |\n| 用户模块   | 账户管理   | 用户注册、登录、历史登录账号选择                               | ✅       |\n|            | 账号安全   | 邮箱/手机号绑定提醒、设备管理、账号安全验证                    | ✅       |\n| 消息模块   | 基础聊天   | 文本消息、图片消息、视频消息、文件上传、消息撤回、消息已读状态 | ✅       |\n|            | 数据同步   | 多设备消息同步、阅读状态同步                                   | ✅       |\n|            | 高级聊天   | 消息引用回复、@提及功能、公告、撤回消息重新编辑                | ✅       |\n| 会话模块   | 会话管理   | 会话列表、置顶会话、隐藏会话、会话未读数统计、会话排序         | ✅       |\n| 群聊模块   | 群聊操作   | 创建群聊、退出群聊、查看群聊详情                               | ✅       |\n|            | 群成员管理 | 群成员管理、设置管理员、撤销管理员、获取@列表                  | ✅       |\n| 联系人模块 | 好友操作   | 好友申请、好友搜索、好友列表、拒绝好友申请、删除好友           | ✅       |\n|            | 资料与通知 | 好友详情查看、申请未读数统计                                   | ✅       |\n| 通知系统   | 消息通知   | 桌面通知、系统托盘提醒、铃声设置、消息免打扰                   | ✅       |\n| 扩展功能   | 综合集成   | 博客集成                                                       | ✅       |\n| 其他模块   | 其他功能   | 聊天社交功能、文件下载管理、翻译工具（AI 翻译/腾讯翻译）       | ✅       |\n|            | 文件与播放 | 图片预览器、视频播放器、文件下载、批量图片上传                 | ✅       |\n|            | 主题配置   | 深浅色主题切换、系统主题跟随、字体设置、自适应布局             | ✅       |\n|            | 平台兼容   | Windows、macOS、Linux、Android、Web 端适配                     | ✅       |\n\n\u003c/details\u003e\n\n---\n\n## 常见问题\n\n- **前端**：安装与运行、Tauri 构建、多端调试等见 [frontend/README.md](frontend/README.md) 的「常见问题」与 [frontend/Run.md](frontend/Run.md)。\n- **后端**：数据库/表未创建、WebSocket 连不上、上传/短信/邮件配置等见 [backend/README.md](backend/README.md) 的「常见问题」与 [backend/使用说明.md](backend/使用说明.md)（如有）。\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cstrong\u003emacOS 安装提示「已损坏」或证书问题\u003c/strong\u003e\u003c/summary\u003e\n\nmacOS 安装时若提示“安装包已损坏”或证书相关，可按以下处理：\n\n1. 系统设置 → 安全性与隐私 → 允许“任何来源”的 App（若可见）。\n2. **安装前**在终端执行（将 `JiwuChat_1.8.0_aarch64.dmg` 换成实际文件名）：\n   ```bash\n   sudo xattr -rd com.apple.quarantine JiwuChat_1.8.0_aarch64.dmg\n   ```\n3. **已安装**则执行：\n   ```bash\n   sudo xattr -r -d com.apple.quarantine /Applications/JiwuChat.app\n   ```\n\n\u003c/details\u003e\n\n- 其它问题欢迎在仓库 [Issues](https://github.com/KiWi233333/JiwuChat/issues) 留言或通过下方联系方式反馈。\n\n---\n\n## 免责声明\n\n- 本仓库仅供学习与交流使用，软件按「原样」提供，不提供任何明示或暗示的保证。\n- 作者及贡献者不对因使用本软件而产生的任何直接、间接、附带或后果性损害承担责任。\n- 使用者应自行确保其使用行为符合所在地区法律法规，因违规使用产生的法律责任由使用者自行承担。\n- 赞助行为为自愿支持，不构成任何服务或承诺。\n\n---\n\n## ☕ 赞助支持\n\n如果您觉得 JiwuChat 对您有帮助，欢迎赞助支持，您的支持是我们不断前进的动力！\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/wechat.png\" width=\"200\" alt=\"微信支付\" /\u003e\n  \u003cimg src=\"assets/alipay.png\" width=\"200\" alt=\"支付宝\" /\u003e\n\u003c/p\u003e\n\n---\n\n## 联系方式\n\n- 邮箱：[kiwi2333@qq.com](mailto:kiwi2333@qq.com)\n- QQ：[1329634286](https://wpa.qq.com/msgrd?v=3\u0026uin=1329634286\u0026site=qqq\u0026menu=yes)\n- QQ 群：[939204073](https://qm.qq.com/q/iSaETNVdKw)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiwi233333%2Fjiwu-chat-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkiwi233333%2Fjiwu-chat-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiwi233333%2Fjiwu-chat-core/lists"}