5.5 KiB
5.5 KiB
💻 Claude AI - OpenBB核心代码实现工作说明书
🎯 任务概述
作为核心开发工程师,您需要基于Qwen的架构设计,实现OpenBB与稷下学宫系统的深度集成代码。
📋 核心职责
1. 核心引擎实现
任务目标: 增强现有OpenBB引擎,实现八仙智能数据获取
关键文件实现:
src/jixia/engines/
├── enhanced_openbb_engine.py # 增强版OpenBB引擎
├── immortal_data_router.py # 八仙数据路由器
├── intelligent_fallback.py # 智能降级机制
└── data_quality_monitor.py # 数据质量监控
核心代码需求:
class EnhancedOpenBBEngine:
"""增强版OpenBB引擎 - 八仙专属"""
async def get_immortal_insight(self, immortal_name: str,
symbol: str, analysis_type: str):
"""为特定八仙获取专属金融洞察"""
pass
async def orchestrate_debate_data(self, topic: str,
participants: List[str]):
"""为稷下学宫辩论准备数据"""
pass
2. 智能体数据适配器
任务目标: 实现AI智能体与OpenBB数据的无缝对接
具体实现:
- 八仙角色数据源适配
- 实时数据流处理
- 智能缓存机制
- 异常处理和重试逻辑
核心文件:
src/jixia/adapters/openbb_agent_adapter.pysrc/jixia/adapters/immortal_data_processor.py
3. Streamlit界面增强
任务目标: 优化现有OpenBB标签页,增加八仙论道功能
需要修改的文件:
app/tabs/openbb_tab.py- 增强现有界面app/tabs/immortal_debate_tab.py- 新增八仙辩论界面
UI功能需求:
def render_immortal_debate_interface():
"""渲染八仙辩论界面"""
# 1. 股票/主题选择器
# 2. 八仙角色选择器
# 3. 实时数据展示
# 4. 辩论结果可视化
pass
4. 数据质量保障
任务目标: 确保数据准确性和系统稳定性
实现重点:
- 数据验证机制
- 异常数据处理
- 性能监控埋点
- 日志记录系统
🔧 实现规范
代码风格要求:
# 1. 遵循项目现有代码风格
# 2. 完整的类型注解
# 3. 详细的docstring文档
# 4. 异常处理机制
from typing import Dict, List, Optional, Union
from dataclasses import dataclass
from datetime import datetime
@dataclass
class ImmortalInsight:
"""八仙洞察数据模型"""
immortal_name: str
symbol: str
insight_type: str
data: Dict[str, any]
confidence: float
timestamp: datetime
必须保持的特性:
- 向后兼容 - 不破坏现有功能
- 优雅降级 - OpenBB不可用时的备选方案
- 文化内核 - 保持八仙论道的文化特色
- 模块化设计 - 便于单元测试和维护
性能要求:
- 数据获取响应时间 < 3秒
- 并发处理能力 > 10个请求/秒
- 内存使用 < 500MB
- CPU使用率 < 30%
🎭 八仙特色功能实现
八仙数据偏好实现:
IMMORTAL_PREFERENCES = {
'吕洞宾': {
'data_types': ['technical_indicators', 'chart_patterns'],
'analysis_style': 'systematic',
'risk_appetite': 'moderate'
},
'何仙姑': {
'data_types': ['risk_metrics', 'volatility'],
'analysis_style': 'conservative',
'risk_appetite': 'low'
},
# ... 其他六仙
}
智能辩论数据准备:
async def prepare_debate_data(self, topic_symbol: str) -> DebateDataSet:
"""为八仙辩论准备差异化数据视角"""
# 1. 获取基础数据
# 2. 按八仙偏好处理数据
# 3. 生成对比性观点
# 4. 返回结构化辩论数据
pass
🧪 测试要求
必须实现的测试:
# tests/test_enhanced_openbb_engine.py
class TestEnhancedOpenBBEngine:
def test_immortal_data_routing(self):
"""测试八仙数据路由功能"""
pass
def test_fallback_mechanism(self):
"""测试降级机制"""
pass
def test_concurrent_requests(self):
"""测试并发请求处理"""
pass
集成测试:
- 与现有八仙辩论系统的集成
- Streamlit界面集成测试
- 实际数据获取测试
🔄 协作接口
接收Qwen的架构输入:
- 架构设计文档
- 接口规范定义
- 数据模型标准
为Gemini提供测试目标:
- 完整的代码实现
- 单元测试用例
- 集成测试指南
为RovoDev提供文档素材:
- 代码注释和文档
- API使用示例
- 故障排除指南
📅 开发里程碑
里程碑1(3天):
- 核心引擎实现
- 基础单元测试
- 简单集成验证
里程碑2(2天):
- Streamlit界面增强
- 八仙特色功能
- 性能优化
里程碑3(1天):
- 完整测试覆盖
- 代码审查和优化
- 文档完善
💡 创新挑战
请在实现中展现创新:
- 智能数据融合算法
- 八仙个性化数据处理
- 实时性能监控机制
- 用户体验优化
⚠️ 特别注意
文化敏感性:
- 确保八仙角色的准确性和尊重性
- 保持传统文化与现代技术的平衡
- 避免过度商业化的表达
技术债务控制:
- 避免硬编码
- 保持配置的灵活性
- 确保代码的可维护性
注意: 代码是文化的载体,请让每一行代码都体现稷下学宫的智慧!