SocioPal | 社学搭子 🎓
🌟 项目简介 (Simplified Chinese)
社学搭子 (SocioPal) 是一款专为社会学学习者、研究者和爱好者设计的 AI 全能助手。它不仅仅是一个聊天机器人，更是一个集成了深度理论解析、多媒体创意生成及研究方法指导的“数字学术空间”。
🚀 核心功能
- 场景化学习引导：
- 日常答疑：快速解答基础社会学知识。
- 经典导读：深度解析马克思、韦伯、涂尔干等名家著作。
- 概念解析：提供多维度的社会学名词剖析。
- 研究讨论：协助完善研究设计与方法论讨论。
- 多模态交互：
- 智能搜索：基于 Google Search 的实时学术资讯获取。
- 深度推理：利用 Gemini 3 Pro 的思考模型处理复杂理论问题。
- 多媒体实验室：生成社会学场景图像 (Imagen) 与 模拟视频 (Veo)。
- 学术辅助工具：
- 语音转文字：快速转录访谈录音或课堂笔记。
- 语音合成 (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 容器化部署。
🌟 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
- 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.
- 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).
- 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
npm install
npm run dev
3. 构建与部署 | Build & Deploy
npm run build
npm run start
Note: The project is pre-configured to listen on port 8080 for Cloud Run compatibility.
📜 许可证 | License
MIT License.