# SocioPal | 社学搭子 🎓

[English](#english) | [简体中文](#simplified-chinese)

---

<a name="simplified-chinese"></a>
## 🌟 项目简介 (Simplified Chinese)

**社学搭子 (SocioPal)** 是一款专为社会学学习者、研究者和爱好者设计的 AI 全能助手。它不仅仅是一个聊天机器人，更是一个集成了深度理论解析、多媒体创意生成及研究方法指导的“数字学术空间”。

### 🚀 核心功能

1.  **场景化学习引导**：
    *   **日常答疑**：快速解答基础社会学知识。
    *   **经典导读**：深度解析马克思、韦伯、涂尔干等名家著作。
    *   **概念解析**：提供多维度的社会学名词剖析。
    *   **研究讨论**：协助完善研究设计与方法论讨论。
2.  **多模态交互**：
    *   **智能搜索**：基于 Google Search 的实时学术资讯获取。
    *   **深度推理**：利用 Gemini 3 Pro 的思考模型处理复杂理论问题。
    *   **多媒体实验室**：生成社会学场景图像 (Imagen) 与 模拟视频 (Veo)。
3.  **学术辅助工具**：
    *   **语音转文字**：快速转录访谈录音或课堂笔记。
    *   **语音合成 (TTS)**：沉浸式听读理论文献。
    *   **本地备份**：支持全量数据导出与导入，确保学术资料安全。

### 🛠️ 技术栈

*   **前端**：React 18 + TypeScript + Tailwind CSS
*   **AI 引擎**：Google Gemini API (@google/genai)
*   **模型选择**：
    *   文本/推理：Gemini 3 Pro (Thinking), Gemini 3 Flash
    *   图像：Gemini 3 Pro Image (High Quality)
    *   视频：Veo 3.1 Fast
    *   语音：Gemini 2.5 Flash Native Audio
*   **部署**：支持 Vite 构建，完美兼容 Cloud Run 容器化部署。

---

<a name="english"></a>
## 🌟 Project Introduction (English)

**SocioPal** is an all-in-one AI companion tailored for sociology students, researchers, and enthusiasts. More than just a chatbot, it serves as a "Digital Academic Space" integrating theoretical depth, multimedia generation, and methodological guidance.

### 🚀 Key Features

1.  **Scenario-Based Learning**:
    *   **Daily Q&A**: Fast answers to foundational sociology questions.
    *   **Classic Readings**: Guided analysis of Marx, Weber, Durkheim, and other masters.
    *   **Concept Analysis**: Multi-dimensional breakdown of complex sociological terms.
    *   **Research Advisor**: Assistance with research design and methodology discussion.
2.  **Multimodal Interaction**:
    *   **Google Search Grounding**: Real-time academic information retrieval.
    *   **Deep Reasoning**: Leverages Gemini 3 Pro's thinking capabilities for complex theory.
    *   **Multimedia Studio**: Generate sociology-themed images (Imagen) and simulated videos (Veo).
3.  **Academic Utilities**:
    *   **Transcription**: Quickly convert interview recordings or lecture notes to text.
    *   **Text-to-Speech (TTS)**: Immersive listening experience for theoretical texts.
    *   **Local Backup**: Full data export and import to keep your academic progress safe.

### 🛠️ Tech Stack

*   **Frontend**: React 18 + TypeScript + Tailwind CSS
*   **AI Engine**: Google Gemini API (@google/genai)
*   **Models**:
    *   Text/Reasoning: Gemini 3 Pro (with Thinking), Gemini 3 Flash
    *   Imaging: Gemini 3 Pro Image (High Quality)
    *   Video: Veo 3.1 Fast
    *   Audio: Gemini 2.5 Flash Native Audio
*   **Deployment**: Vite-powered, fully compatible with Cloud Run containerization.

---

## 📦 快速开始 | Quick Start

### 1. 环境变量配置 | Environment Variables
在您的构建环境或 `.env` 文件中配置以下变量：
`API_KEY`: 您的 Google Gemini API Key.

### 2. 运行项目 | Running Locally
```bash
npm install
npm run dev
```

### 3. 构建与部署 | Build & Deploy
```bash
npm run build
npm run start
```
*Note: The project is pre-configured to listen on port 8080 for Cloud Run compatibility.*

## 📜 许可证 | License
MIT License.