# WorkingMate

**Repository Path**: CanFlyhang/WorkingMate

## Basic Information

- **Project Name**: WorkingMate
- **Description**: WorkingMate 是一个基于 React Native 开发的智能语音助手应用。它拥有独特的赛博朋克风格 UI，集成了 DeepSeek 大模型进行对话，并使用火山引擎（豆包）的 ASR 和 TTS 服务实现全双工语音交互。
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-04
- **Last Updated**: 2026-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WorkingMate (工作伴侣) 🤖

WorkingMate 是一个基于 **React Native** 开发的智能语音助手应用。它拥有独特的**赛博朋克风格** UI，集成了 **DeepSeek** 大模型进行对话，并使用火山引擎（豆包）的 ASR 和 TTS 服务实现全双工语音交互。

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Platform](https://img.shields.io/badge/platform-Android-green.svg)
![React Native](https://img.shields.io/badge/React%20Native-0.83-blue)

## ✨ 主要特性 (Features)

*   **👁️ 赛博之眼 (Cyber Eyes)**
    *   **拟人化交互**：支持眨眼、眼球跟随、睡眠模式（呼噜泡）。
    *   **情感表达**：根据对话内容自动识别情感，展示“开心😄”、“生气😠”、“惊讶😲”、“难过😢”等表情。
*   **🧠 智能大脑**
    *   接入 **DeepSeek** 大模型，支持流式输出，响应迅速。
    *   具备上下文理解能力，提供智能回复。
*   **🗣️ 全双工语音交互**
    *   **ASR**: 实时语音转文字（基于豆包 WebSocket 协议）。
    *   **TTS**: 实时流式语音合成（基于豆包 V1 WebSocket 协议），声音自然流畅。
    *   **关键词唤醒**: 支持 "鸡腿航" 唤醒，"拜拜" 进入休眠。
*   **🌊 沉浸式体验**
    *   **思考状态**: 带有呼吸感的思考气泡动画。
    *   **声波可视化**: 随音量跳动的赛博风格波形条。
*   **📱 多端适配**
    *   自适应布局，完美支持 Android 手机和平板。
    *   横屏模式优化。

## 🛠️ 技术栈 (Tech Stack)

*   **Core**: React Native, TypeScript
*   **UI/Animation**: Animated API, react-native-orientation-locker
*   **AI Services**:
    *   LLM: DeepSeek API
    *   ASR/TTS: Volcano Engine (Doubao) WebSocket
*   **Native Modules**:
    *   `react-native-audio-record`: 录音
    *   `react-native-sound`: 音频播放
    *   `react-native-live-audio-stream`: 实时音频流

## 🚀 快速开始 (Getting Started)

### 前置要求 (Prerequisites)

*   Node.js >= 20
*   JDK 17+
*   Android Studio & Android SDK

### 安装 (Installation)

1.  **克隆仓库**

    ```bash
    git clone https://github.com/yourusername/WorkingMate.git
    cd WorkingMate
    ```

2.  **安装依赖**

    ```bash
    npm install
    ```

3.  **配置 API Keys** (⚠️ 重要)

    本项目依赖外部 AI 服务，你需要自行申请并配置 API Key。

    *   **DeepSeek 配置**:
        打开 `src/services/DeepSeekService.ts`，填入你的 API Key：
        ```typescript
        export const deepseekService = {
          apiKey: 'YOUR_DEEPSEEK_API_KEY',
          // ...
        }
        ```

    *   **火山引擎 (Doubao) 配置**:
        打开 `src/config/DoubaoConfig.ts`，填入你的 AppID 和 Access Token：
        ```typescript
        export const DOUBAO_CONFIG = {
            APPID: 'YOUR_APPID',
            ACCESS_TOKEN: 'YOUR_ACCESS_TOKEN',
            // ...
        };
        ```

4.  **运行应用**

    连接 Android 设备或启动模拟器：

    ```bash
    npm start
    # 在新终端窗口中
    npm run android
    ```

## 📂 项目结构 (Project Structure)

```
WorkingMate/
├── android/             # Android 原生代码
├── src/
│   ├── config/          # 配置文件 (API Keys)
│   ├── hooks/           # Custom Hooks (useDoubaoAsr.ts - 核心逻辑)
│   ├── services/        # 核心服务 (ASR, TTS, LLM)
│   └── ...
├── App.tsx              # 主入口 & UI 逻辑
└── README.md            # 说明文档
```

## 🤝 贡献 (Contributing)

欢迎提交 Issue 和 Pull Request！

## 📄 许可证 (License)

MIT License