Skip to content

Commit a94635a

Browse files
committed
doc: 完成项目 ReadMe
1 parent c087959 commit a94635a

File tree

3 files changed

+153
-11
lines changed

3 files changed

+153
-11
lines changed

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2025 Program
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

README-zh.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
<p align="center"><img src="public/icon.svg" width="100" height="100"></p>
2+
<h1 align="center">Flow Message</h1>
3+
4+
<div align="center">
5+
6+
[![star](https://img.shields.io/github/stars/ProgramCX/flow_im_app?logo=github&style=round-square)](https://github.com/ProgramCX/flow_im_app/stargazers)
7+
[![license](https://img.shields.io/github/license/ProgramCX/flow_im_app?style=round-square&logo=github)](https://github.com/ProgramCX/flow_im_app/blob/main/LICENSE)
8+
[![Activity](https://img.shields.io/github/last-commit/ProgramCX/flow_im_app?style=round-square&logo=github)](#)
9+
[![Frame](https://img.shields.io/badge/Frame-Vue3.x/Electron-orange.svg?style=round-square&logo=github)](#)
10+
11+
</div>
12+
13+
>
14+
15+
[English](README.md) | 中文
16+
17+
## 介绍
18+
Flow Message 是一个基于 Vue3.x 和 Electron 的跨平台即时通讯软件,旨在为用户提供一个安全、快速、稳定的聊天环境。Flow Message 支持多种平台,包括 Windows、macOS 和 Linux。
19+
20+
## 功能
21+
- **跨平台支持**:Flow Message 支持 Windows、macOS 和 Linux 等多个操作系统,确保用户在不同设备上都能享受一致的使用体验。
22+
23+
- **安全性**:Flow Message 采用先进的加密技术,确保用户的聊天记录和个人信息安全无忧。
24+
25+
- **快速稳定**:Flow Message 基于 Electron 和 Vue3.x 构建,具有良好的性能和稳定性,确保用户在使用过程中不会遇到卡顿或崩溃的问题。
26+
27+
- **简洁易用的界面**:Flow Message 采用简洁明了的设计风格,用户可以轻松上手,无需复杂的学习过程。
28+
29+
- **多种聊天功能**:Flow Message 支持文本、图片、语音等多种聊天方式,满足用户的不同需求。
30+
31+
## 贡献
32+
33+
欢迎任何形式的贡献,包括但不限于代码、文档、设计等。
34+
35+
## 安装步骤
36+
1. 克隆项目
37+
```bash
38+
git clone https://github.com/ProgramCX/flow_im_app.git
39+
```
40+
2. 安装依赖
41+
```bash
42+
cd flow_im_app
43+
44+
cnpm install #如果你在中国大陆地区,建议使用cnpm安装依赖
45+
```
46+
47+
3. 启动项目
48+
```bash
49+
npm run dev
50+
```
51+
4. 浏览器预览项目
52+
```bash
53+
npm run preview
54+
```
55+
56+
5. 打包项目
57+
```bash
58+
npm run build
59+
```
60+
61+
**注意**:
62+
由于打包需要下载electron的安装包,在中国大陆地区可能无法下载,可以自行到[electron release 页面](https://github.com/electron/electron/releases)下载和控制台打印输出链接信息中对应版本的安装包,放到项目根目录下的`electron`文件夹中。Windows 用户建议放在 %LOCALAPPDATA%/electron/Cache 目录下,并且解压到该目录下。
63+
64+
6. 打包完成后,安装包会在 `release` 目录下生成。
65+
66+
## 协议
67+
68+
Flow Message 使用 [MIT License](LICENSE) 协议.
69+
70+
---
71+
72+
感谢您使用 Flow Message,我们期待您的反馈和建议!

README.md

Lines changed: 60 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,67 @@
1-
# Vue 3 + TypeScript + Vite
1+
<p align="center"><img src="public/icon.svg" width="100" height="100"></p>
2+
<h1 align="center">Flow Message</h1>
23

3-
This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `<script setup>` SFCs, check out the [script setup docs](https://v3.vuejs.org/api/sfc-script-setup.html#sfc-script-setup) to learn more.
4+
<div align="center">
45

5-
## Recommended IDE Setup
6+
[![star](https://img.shields.io/github/stars/ProgramCX/flow_im_app?logo=github&style=round-square)](https://github.com/ProgramCX/flow_im_app/stargazers)
7+
[![license](https://img.shields.io/github/license/ProgramCX/flow_im_app?style=round-square&logo=github)](https://github.com/ProgramCX/flow_im_app/blob/main/LICENSE)
8+
[![Activity](https://img.shields.io/github/last-commit/ProgramCX/flow_im_app?style=round-square&logo=github)](#)
9+
[![Frame](https://img.shields.io/badge/Frame-Vue3.x/Electron-orange.svg?style=round-square&logo=github)](#)
610

7-
- [VS Code](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur) + [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin).
11+
</div>
812

9-
## Type Support For `.vue` Imports in TS
13+
>
1014
11-
TypeScript cannot handle type information for `.vue` imports by default, so we replace the `tsc` CLI with `vue-tsc` for type checking. In editors, we need [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin) to make the TypeScript language service aware of `.vue` types.
15+
English | [中文](README-zh.md)
1216

13-
If the standalone TypeScript plugin doesn't feel fast enough to you, Volar has also implemented a [Take Over Mode](https://github.com/johnsoncodehk/volar/discussions/471#discussioncomment-1361669) that is more performant. You can enable it by the following steps:
17+
## Introduction
1418

15-
1. Disable the built-in TypeScript Extension
16-
1. Run `Extensions: Show Built-in Extensions` from VSCode's command palette
17-
2. Find `TypeScript and JavaScript Language Features`, right click and select `Disable (Workspace)`
18-
2. Reload the VSCode window by running `Developer: Reload Window` from the command palette.
19+
Flow Message is a cross-platform instant messaging software based on Vue3.x and Electron, designed to provide users with a secure, fast, and stable communication environment. It supports multiple platforms including Windows, macOS, and Linux.
20+
21+
## Features
22+
23+
- **Cross-Platform Support**: Enjoy a consistent experience on Windows, macOS, and Linux.
24+
- **Security**: Utilizes advanced encryption technology to protect your chat records and personal information.
25+
- **Fast and Stable**: Built on Electron and Vue3.x, ensuring smooth performance without lags or crashes.
26+
- **Simple and Intuitive Interface**: A clean design that makes it easy to get started.
27+
- **Multiple Chat Functions**: Supports text, images, and voice messages to meet various communication needs.
28+
29+
## Contributing
30+
31+
Contributions in any form—code, documentation, design, etc.—are welcome.
32+
33+
## Installation Steps
34+
35+
1. Clone the repository:
36+
```bash
37+
git clone https://github.com/ProgramCX/flow_im_app.git
38+
```
39+
2. Install dependencies:
40+
```bash
41+
cd flow_im_app
42+
cnpm install # If you are in mainland China, using cnpm is recommended.
43+
```
44+
3. Start the project:
45+
```bash
46+
npm run dev
47+
```
48+
4. Preview the project in the browser:
49+
```bash
50+
npm run preview
51+
```
52+
5. Build the project:
53+
```bash
54+
npm run build
55+
```
56+
**Note**:
57+
Due to package download requirements for Electron, users in mainland China might face download issues. Please manually download the corresponding Electron package from the [Electron releases page](https://github.com/electron/electron/releases) and place it in the `electron` folder in the project root. For Windows users, it is recommended to place it in `%LOCALAPPDATA%/electron/Cache` and extract it there.
58+
59+
After building, the installer will be generated in the `release` directory.
60+
61+
## License
62+
63+
Flow Message is released under the [MIT License](LICENSE).
64+
65+
---
66+
67+
Thank you for using Flow Message! We look forward to your feedback and suggestions.

0 commit comments

Comments
 (0)