liurenchaxin/internal/baxian_sanqing_system_guide.md

🌟 八仙论道+三清验证系统使用指南

📖 系统概述

八仙论道+三清验证系统是一个基于AutoGen的AI辩论系统，结合OpenManus田野调查验证的智能决策平台。系统通过以下流程工作：

八仙论道 (AutoGen辩论) 
    ↓
太清道德天尊 (逻辑分析)
    ↓
上清灵宝天尊 (田野调查 - OpenManus)
    ↓
玉清元始天尊 (最终决策)

🎭 八仙角色设定

先天八卦布局

        乾☰ 吕洞宾 (剑仙投资顾问)
    兑☱ 钟汉离         巽☴ 蓝采和 (情绪分析师)
震☳ 铁拐李                 坤☷ 何仙姑 (风控专家)  
    艮☶ 曹国舅         坎☵ 张果老 (技术分析)
        离☲ 韩湘子 (基本面研究)

角色专长

• 吕洞宾 🗡️: 剑仙投资顾问，高风险高收益策略
• 何仙姑 🌸: 慈悲风控专家，稳健保守策略
• 铁拐李 ⚡: 逆向思维大师，挑战主流观点
• 蓝采和 🎵: 情绪分析师，市场情绪感知
• 张果老 📊: 技术分析仙，图表模式识别
• 韩湘子 📈: 基本面研究员，财务数据分析
• 曹国舅 🏛️: 宏观经济学家，政策影响分析
• 钟汉离 🔢: 量化交易专家，数据驱动策略

🔮 三清验证体系

太清道德天尊 ☯️

• 职责: 观察现实，分析辩论结果的逻辑一致性
• 功能:
  • 从知识库检索历史背景
  • 分析论断的逻辑关系
  • 评估可验证性
  • 生成调查计划

上清灵宝天尊 🔮

• 职责: 执行田野调查，通过OpenManus验证论断
• 功能:
  • 网页数据爬取
  • 新闻真实性验证
  • 市场数据核实
  • 社交情绪分析

玉清元始天尊 ⚡

• 职责: 综合所有信息，做出最终决策
• 功能:
  • 综合分析所有证据
  • 计算最终置信度
  • 生成实施建议
  • 制定监控计划

🚀 快速开始

1. 环境准备

# 克隆项目
git clone <your-repo-url>
cd <project-directory>

# 运行快速启动脚本
chmod +x quick_start_baxian_sanqing.sh
./quick_start_baxian_sanqing.sh

2. 配置环境变量

编辑 .env.baxian_sanqing 文件：

# 必需配置
OPENMANUS_URL=https://your-openmanus-instance.com
OPENMANUS_API_KEY=your_api_key
ZILLIZ_HOST=your-zilliz-host.com
ZILLIZ_USERNAME=your_username
ZILLIZ_PASSWORD=your_password
OPENAI_API_KEY=your_openai_key

3. 启动系统

# 交互模式
python3 scripts/start_baxian_sanqing_system.py --interactive

# 命令行模式
python3 scripts/start_baxian_sanqing_system.py --topic "特斯拉Q4财报影响分析"

💡 使用示例

示例1: 股票分析

topic = "苹果公司Q1财报对股价影响分析"
context = {
    "current_price": 150.0,
    "market_cap": "2.5T",
    "recent_news": ["iPhone销量超预期", "服务业务增长强劲"],
    "analyst_consensus": "买入"
}

# 系统将自动执行：
# 1. 八仙论道 - 多角度分析
# 2. 三清验证 - 田野调查验证
# 3. 生成综合报告

示例2: 加密货币趋势

topic = "比特币价格趋势分析"
context = {
    "current_price": 45000,
    "market_sentiment": "谨慎乐观",
    "institutional_activity": "持续买入",
    "regulatory_news": "美国ETF获批"
}

📊 输出报告结构

综合报告包含：

{
  "executive_summary": {
    "topic": "分析主题",
    "final_decision": "APPROVE/CONDITIONAL_APPROVE/REJECT",
    "verification_confidence": 0.85,
    "recommendation": "具体建议"
  },
  "baxian_debate": {
    "participants": ["吕洞宾", "何仙姑", "铁拐李", "蓝采和"],
    "key_claims": ["关键论断1", "关键论断2"],
    "conclusions": "辩论结论"
  },
  "sanqing_verification": {
    "taiqing_observation": "逻辑分析结果",
    "shangqing_investigation": "田野调查结果", 
    "yuqing_decision": "最终决策"
  },
  "implementation_plan": ["实施步骤"],
  "risk_assessment": "风险评估",
  "monitoring_plan": "监控计划"
}

⚙️ 高级配置

自定义八仙配置

编辑 config/baxian_sanqing_config.yaml:

baxian_agents:
  吕洞宾:
    model_config:
      model: "gpt-4"
      temperature: 0.7
      max_tokens: 1000

验证参数调整

verification:
  confidence_threshold: 0.6
  max_verification_tasks: 10
  sanqing_weights:
    original_debate: 0.3
    taiqing_logic: 0.3
    shangqing_field: 0.4

OpenManus任务配置

field_investigation:
  task_types:
    web_scraping:
      enabled: true
      default_timeout: 300
    news_verification:
      enabled: true
      sources: ["reuters", "bloomberg"]

🔧 故障排除

常见问题

1. OpenManus连接失败

# 检查网络连接
curl -s $OPENMANUS_URL/health

# 验证API密钥
curl -H "Authorization: Bearer $OPENMANUS_API_KEY" $OPENMANUS_URL/api/status

2. Zilliz连接问题

# 测试连接
from pymilvus import connections
connections.connect(
    host="your-host",
    port="19530", 
    user="username",
    password="password"
)

3. AutoGen模型配置

# 检查OpenAI API密钥
export OPENAI_API_KEY=your_key
python3 -c "import openai; print(openai.Model.list())"

日志调试

# 查看详细日志
tail -f logs/baxian_sanqing.log

# 调整日志级别
export LOG_LEVEL=DEBUG

📈 性能优化

并发配置

performance:
  max_concurrent_debates: 3
  max_concurrent_verifications: 5
  cache_enabled: true
  cache_ttl: 3600

资源监控

# 监控系统资源
htop

# 监控网络连接
netstat -an | grep :19530  # Zilliz
netstat -an | grep :443    # OpenManus HTTPS

🔐 安全考虑

API密钥管理

• 使用环境变量存储敏感信息
• 定期轮换API密钥
• 限制API访问权限

数据安全

security:
  data_encryption:
    enabled: true
    algorithm: "AES-256"
  access_control:
    require_authentication: true

🚀 扩展开发

添加新的八仙角色

# 在配置文件中添加新角色
new_agent = BaxianAgent(
    name="新仙人",
    role="专业角色",
    gua_position="八卦位置",
    system_message="角色描述",
    model_config={"model": "gpt-4", "temperature": 0.6}
)

自定义验证任务

# 继承FieldTask类
class CustomFieldTask(FieldTask):
    def __init__(self, custom_params):
        super().__init__(...)
        self.custom_params = custom_params

集成新的数据源

# 在田野调查中添加新的数据源
async def custom_data_source_verification(self, claim):
    # 实现自定义验证逻辑
    pass

📞 支持与反馈

获取帮助

• 查看日志文件: logs/baxian_sanqing.log
• 运行诊断: python3 scripts/start_baxian_sanqing_system.py --help
• 检查系统状态: 在交互模式中选择"系统状态"

贡献代码

1. Fork项目
2. 创建功能分支
3. 提交Pull Request
4. 参与代码审查

---

🌟 系统特色

🎭 易经智慧融入AI

• 基于先天八卦的角色设计
• 体用关系的辩论逻辑
• 三清验证的层次结构

🔮 实地验证机制

• OpenManus自动化调查
• 多源数据交叉验证
• 置信度动态调整

⚡ 智能决策支持

• 多维度分析框架
• 风险评估体系
• 实施指导方案

🌟 这才是真正的太公心易！以易经智慧指导AI投资分析！