liurenchaxin/docs/AI_AGENT_TASKS/CLAUDE_CODE_IMPLEMENTATION.md

5.5 KiB
Raw Blame History

💻 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.py
  • src/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

必须保持的特性:

  1. 向后兼容 - 不破坏现有功能
  2. 优雅降级 - OpenBB不可用时的备选方案
  3. 文化内核 - 保持八仙论道的文化特色
  4. 模块化设计 - 便于单元测试和维护

性能要求:

  • 数据获取响应时间 < 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使用示例
  • 故障排除指南

📅 开发里程碑

里程碑13天

  • 核心引擎实现
  • 基础单元测试
  • 简单集成验证

里程碑22天

  • Streamlit界面增强
  • 八仙特色功能
  • 性能优化

里程碑31天

  • 完整测试覆盖
  • 代码审查和优化
  • 文档完善

💡 创新挑战

请在实现中展现创新:

  1. 智能数据融合算法
  2. 八仙个性化数据处理
  3. 实时性能监控机制
  4. 用户体验优化

⚠️ 特别注意

文化敏感性:

  • 确保八仙角色的准确性和尊重性
  • 保持传统文化与现代技术的平衡
  • 避免过度商业化的表达

技术债务控制:

  • 避免硬编码
  • 保持配置的灵活性
  • 确保代码的可维护性

注意: 代码是文化的载体,请让每一行代码都体现稷下学宫的智慧!