feat: 更新readme

Author: keqian

.gitignore

@@ -202,4 +202,6 @@ secrets.json
 .env.production
 
 # Local development
-local_*
+local_*
+.python-version
+qdrant_data

DOCKER.md

@@ -32,6 +32,7 @@ MICROSOFT_TTS_KEY=your_azure_tts_key
 
 ```bash
 # 构建并启动所有服务
+cd /Users/king/Develop/self/mystical-oracle
 docker-compose up -d
 
 # 查看服务状态
@@ -109,24 +110,24 @@ docker-compose exec mystical-oracle bash
 1. **Ollama 模型下载失败**
    ```bash
    # 手动下载模型
-   docker-compose exec ollama ollama pull qwen2.5:latest
+docker-compose exec ollama ollama pull qwen2.5:latest
    ```
 
 2. **端口冲突**
    ```bash
    # 修改 docker-compose.yml 中的端口映射
-   ports:
-     - "8001:8000"  # 将宿主机端口改为 8001
+ports:
+  - "8001:8000"  # 将宿主机端口改为 8001
    ```
 
 3. **内存不足**
    ```bash
    # 增加 Docker 内存限制或使用更小的模型
-   # 在 docker-compose.yml 中添加:
-   deploy:
-     resources:
-       limits:
-         memory: 4G
+# 在 docker-compose.yml 中添加:
+deploy:
+  resources:
+    limits:
+      memory: 4G
    ```
 
 ### 日志查看
@@ -175,6 +176,14 @@ deploy:
 
 ## 扩展部署
 
+### 单容器部署
+
+如果您需要更简单的部署方式，可以使用单容器部署：
+
+```bash
+docker-compose -f docker-compose.single.yml up -d
+```
+
 ### 多实例部署
 
 ```bash
@@ -202,16 +211,14 @@ server {
 }
 ```
 
-## 安全建议
+## 部署注意事项
 
-1. **不要在生产环境暴露所有端口**
-2. **使用强密码和 API 密钥**
-3. **启用 HTTPS**
-4. **定期更新镜像**
-5. **配置防火墙规则**
+- 确保防火墙已开放所需端口
+- 在生产环境中，建议使用 HTTPS 加密通信
+- 定期备份持久化数据卷
+- 对于高流量场景，考虑使用 Kubernetes 进行容器编排
+- 监控系统资源使用情况，及时调整资源限制
 
-```bash
-# 只暴露必要端口
-ports:
-  - "127.0.0.1:8000:8000"  # 只允许本地访问
-```
+---
+
+使用 Docker 部署可以大大简化环境配置和依赖管理，让您专注于使用和扩展 Mystical Oracle 服务。

README.md

@@ -21,20 +21,26 @@ mystical-oracle/
 ├── agent.py              # 核心 Agent 类
 ├── server.py             # FastAPI Web 服务器
 ├── config/               # 配置管理
-│   ├── settings.py       # 系统配置
-│   └── keys.py          # API 密钥管理
-├── prompts/             # 提示词模板
-│   ├── system_prompts.py # 系统提示词
-│   └── mood_prompts.py  # 情绪相关提示词
-├── services/            # 业务服务
-│   ├── tools.py         # 工具函数集合
-│   └── tts_service.py   # 语音合成服务
-├── models/              # 数据模型
-│   └── user.py          # 用户数据模型
-├── utils/               # 工具函数
-│   └── helpers.py       # 辅助函数
-├── requirements.txt     # 依赖包列表
-└── README.md           # 项目说明文档
+│   ├── __init__.py
+│   ├── logger.py
+│   └── settings.py       # 系统配置和密钥管理
+├── prompts/              # 提示词模板
+│   ├── __init__.py
+│   ├── mood_prompts.py   # 情绪相关提示词
+│   └── system_prompts.py # 系统提示词
+├── services/             # 业务服务
+│   ├── tools.py          # 工具函数集合
+│   └── tts_service.py    # 语音合成服务
+├── models/               # 数据模型
+│   └── user.py           # 用户数据模型
+├── utils/                # 工具函数
+│   └── helpers.py        # 辅助函数
+├── requirements.txt      # 依赖包列表
+├── README.md             # 项目说明文档
+├── DOCKER.md             # Docker 部署文档
+├── Dockerfile            # Docker 构建文件
+├── docker-compose.yml    # Docker Compose 配置
+└── docker-compose.single.yml # 单容器部署配置
 ```
 
 ## 环境要求
@@ -48,7 +54,8 @@ mystical-oracle/
 
 1. **克隆项目**
    ```bash
-   cd /Users/king/Develop/self/mystical-oracle
+   git clone <repository-url>
+   cd mystical-oracle
    ```
 
 2. **安装依赖**
@@ -139,7 +146,7 @@ python server.py
 - 系统提示词设置
 
 ### API 密钥管理
-在 `config/keys.py` 中集中管理所有 API 密钥，支持环境变量和默认值。
+所有 API 密钥在 `config/settings.py` 中集中管理，支持环境变量和默认值。
 
 ### 提示词模板
 在 `prompts/` 目录下管理所有提示词模板，便于维护和调整。