# chat-client

**Repository Path**: openkylin/chat-client

## Basic Information

- **Project Name**: chat-client
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2024-08-16
- **Last Updated**: 2025-12-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Chat-Client

## 概述

Chat-Client 是一个智能语音助手应用，旨在提供全面的智能对话体验，并具备任务请求和任务规划功能。本项目以 llm-agent 作为后端服务，界面基于 Flutter 框架开发，具有跨平台、设计灵活、性能高效、界面美观以及用户体验好等优势。

## 主要功能

- **模型配置和选择**：用户可以根据需要选择不同的 AI 模型，以适应不同的对话和任务场景。
- **场景切换**：支持多场景操作，用户可以根据不同的使用环境或需求切换场景。
- **会话管理**：有效管理当前和历史会话，支持多任务处理。
- **历史记录管理**：自动保存所有会话记录，方便用户随时查阅过往对话。
- **上下文开关**：支持用户在不同上下文中切换，以便更灵活地处理不同类型的对话。
- **富文本显示功能**：对话内容支持富文本格式，用户可以更好地查看和理解信息，包括文本格式、链接、图片等。
- **文件拖拽支持**：用户可以直接拖拽文件到对话界面，以便上传数据或分享信息。
- **知识库管理**：允许用户添加、编辑或删除知识库内容，支持知识的持续积累和优化。
- **语音对话功能**：支持语音输入和输出，提供更自然的交互方式。
- **文本选择唤醒**：用户可以通过选择文本来唤醒助手，选择文本自动填充。
- **语音唤醒能力**：用户可以通过特定的唤醒词启动语音对话，无需手动操作。

## 技术栈

- **前端**：Flutter
- **后端**：llm-agent (具体后端技术栈依赖于 llm-agent 的实现)

## 安装指南

### 环境要求

- Flutter SDK
- 添加环境变量 export PATH=~/flutter/bin:$PATH
- Dart SDK
- 适用于开发的 IDE（推荐使用 VSCode 或 Android Studio）

### 步骤

1. 克隆仓库到本地：
   ```bash
   git clone https://gitee.com/openkylin/chat-client.git
   ```
2. 进入项目目录：
   ```bash
   cd chat-client
   ```
3. 安装依赖：
   ```bash
   sudo apt update
   sudo apt install -y \
      build-essential curl git \
      unzip xz-utils clang \
      cmake libglu1-mesa  zip \
      ninja-build pkg-config  \
      libstdc++-12-dev libgtk-3-dev \
      liblzma-dev libsqlite3-dev \
      libayatana-appindicator3-dev \
      libstdc++-12-dev \
      libstdc++-14-dev
   flutter pub get
   ```
4. 运行应用：
   ```bash
   flutter run
   ```

## 使用说明

- 启动应用后，用户可以通过简洁的界面进行交互。
- 通过设置面板，用户可以配置 AI 模型，切换场景或管理会话。
- 上下文开关功能允许用户在不同对话上下文之间快速切换，根据需求调整助手的响应。
- 富文本显示功能使用户能够以更美观和易读的方式查看对话内容，包括支持文本格式、链接和图片等。
- 拖拽文件到对话框可以快速上传文件。
- 通过底部的工具栏，用户可以访问历史记录或管理知识库。

## 参与贡献

欢迎对本项目的贡献！请遵循以下步骤：

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request

## 许可证

本项目使用 GPL-3.0 许可证，详情请参见 [LICENSE](LICENSE) 文件。

---

感谢您对 Chat-Client 项目的关注，我们期待您的参与和反馈，共同打造更好的智能语音助手。