SocioPal | 社学搭子 🎓

English | 简体中文

🌟 项目简介 (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.

3.9 KiB Raw Permalink Blame History Unescape Escape