chore: restore project readme

README.md

@@ -1,10 +1,52 @@
 ---
-title: Finance Advisor Agent
-emoji: 🐨
-colorFrom: gray
-colorTo: purple
+title: 金融分析顾问 (Finance Advisor)
+emoji: 📈
+colorFrom: blue
+colorTo: indigo
 sdk: docker
+app_port: 7860
+short_description: 基于AI的个性化金融投资分析与建议助手
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Finance Advisor Agent (金融分析顾问)
+
+## 项目简介
+这是一个基于 **Vue 3 + Flask** 的金融分析对话平台，旨在为用户提供个性化的投资建议。
+项目集成了 **SiliconFlow (硅基流)** 的 AI 能力，能够通过自然语言对话，根据用户的风险偏好提供专业的资产配置建议。
+
+## 核心功能
+1.  **AI 智能投顾**: 集成 DeepSeek-V3 (via SiliconFlow)，提供专业的实时投资问答。
+2.  **风险评估**: 专业的心理测评问卷，准确评估用户的风险承受能力。
+3.  **资产仪表板**: 基于 ECharts 的动态可视化图表，展示推荐的资产配置组合。
+4.  **Mock Mode**: 内置模拟模式，在无 API Key 情况下也能完整体验所有流程。
+
+## 技术栈
+- **Frontend**: Vue 3, TypeScript, Tailwind CSS, Element Plus, ECharts
+- **Backend**: Python Flask, SQLAlchemy (SQLite), Flask-JWT-Extended
+- **AI**: OpenAI SDK (Compatible with SiliconFlow)
+
+## 快速开始
+本应用已配置为 Hugging Face Spaces 运行环境 (Docker SDK)。
+
+### 本地运行
+1. 安装依赖:
+   ```bash
+   pip install -r requirements.txt
+   pnpm install
+   ```
+
+2. 配置环境变量 (可选):
+   创建 `.env` 文件并添加:
+   ```
+   SILICONFLOW_API_KEY=your_key_here
+   ```
+
+3. 启动:
+   ```bash
+   # 后端
+   python app.py
+   
+   # 前端
+   pnpm run dev
+   ```