feat(mx): 集成东方财富妙想API并新增AI选股功能

- 新增MiaoXiangSearchProvider实现东方财富妙想资讯搜索支持
- 配置文件增加MX_APIKEY环境变量支持多个妙想API Key
- 新增AI选股API端点，支持自然语言条件智能选股
- WebUI添加AI选股页面及相关路由和侧边栏入口
- 实现前端调用AI选股API并展示选股结果和提交深度分析功能
- 调整核心配置管理以支持妙想API Key的加载和校验
- 更新.gitignore和配置示例以支持妙想API相关文件和文档
- 日志、错误处理和消息提示完善AI选股功能用户体验

Author: DengGuiXing

.env.example

@@ -260,6 +260,9 @@ BRAVE_API_KEYS=
 # 留空时默认自动从 searx.space 拉取公共实例；若不希望访问公共实例，可将下方开关设为 false
 SEARXNG_BASE_URLS=
 SEARXNG_PUBLIC_INSTANCES_ENABLED=true
+# 东方财富妙想 API Key（金融新闻搜索 + 智能选股，支持多个，逗号分隔）
+# 获取: https://mkapi2.dfcfs.com/
+# MX_APIKEY=your_miaoxiang_key_here
 
 # ===================================
 # Social Sentiment Intelligence (US stocks only)

.gitignore

@@ -80,3 +80,192 @@ static/
 /apps/dsa-desktop/node_modules/
 
 .codex
+.qoder/repowiki/zh/content/快速开始.md
+.qoder/repowiki/zh/content/项目概述.md
+.qoder/repowiki/zh/content/API参考文档/分析报告API.md
+.qoder/repowiki/zh/content/API参考文档/股票数据API.md
+.qoder/repowiki/zh/content/API参考文档/回测引擎API.md
+.qoder/repowiki/zh/content/API参考文档/历史数据管理API.md
+.qoder/repowiki/zh/content/API参考文档/系统配置API.md
+.qoder/repowiki/zh/content/API参考文档/用户认证API.md
+.qoder/repowiki/zh/content/API参考文档/用量监控API.md
+.qoder/repowiki/zh/content/API参考文档/组合管理API.md
+.qoder/repowiki/zh/content/API参考文档/AI代理系统API.md
+.qoder/repowiki/zh/content/API参考文档/API参考文档.md
+.qoder/repowiki/zh/content/开发指南/版本控制与协作.md
+.qoder/repowiki/zh/content/开发指南/测试策略与实施.md
+.qoder/repowiki/zh/content/开发指南/持续集成与部署.md
+.qoder/repowiki/zh/content/开发指南/代码规范与最佳实践.md
+.qoder/repowiki/zh/content/开发指南/调试工具与技巧.md
+.qoder/repowiki/zh/content/开发指南/开发环境搭建.md
+.qoder/repowiki/zh/content/开发指南/开发指南.md
+.qoder/repowiki/zh/content/扩展开发/第三方集成.md
+.qoder/repowiki/zh/content/扩展开发/分析策略扩展.md
+.qoder/repowiki/zh/content/扩展开发/扩展开发.md
+.qoder/repowiki/zh/content/扩展开发/数据提供者扩展.md
+.qoder/repowiki/zh/content/扩展开发/通知发送器扩展.md
+.qoder/repowiki/zh/content/扩展开发/AI代理扩展.md
+.qoder/repowiki/zh/content/故障排除/常见问题诊断.md
+.qoder/repowiki/zh/content/故障排除/故障排除.md
+.qoder/repowiki/zh/content/故障排除/配置问题排查.md
+.qoder/repowiki/zh/content/故障排除/日志分析与调试.md
+.qoder/repowiki/zh/content/故障排除/网络问题诊断.md
+.qoder/repowiki/zh/content/故障排除/系统监控与告警.md
+.qoder/repowiki/zh/content/故障排除/性能调优与优化.md
+.qoder/repowiki/zh/content/最佳实践/安全考虑.md
+.qoder/repowiki/zh/content/最佳实践/成本优化.md
+.qoder/repowiki/zh/content/最佳实践/使用建议.md
+.qoder/repowiki/zh/content/最佳实践/团队协作.md
+.qoder/repowiki/zh/content/最佳实践/维护指南.md
+.qoder/repowiki/zh/content/最佳实践/性能优化.md
+.qoder/repowiki/zh/content/最佳实践/最佳实践.md
+.qoder/repowiki/zh/content/核心功能模块/核心功能模块.md
+.qoder/repowiki/zh/content/核心功能模块/AI智能分析引擎/代理系统架构.md
+.qoder/repowiki/zh/content/核心功能模块/AI智能分析引擎/代理协作机制.md
+.qoder/repowiki/zh/content/核心功能模块/AI智能分析引擎/风险分析代理.md
+.qoder/repowiki/zh/content/核心功能模块/AI智能分析引擎/技术分析代理.md
+.qoder/repowiki/zh/content/核心功能模块/AI智能分析引擎/决策代理.md
+.qoder/repowiki/zh/content/核心功能模块/AI智能分析引擎/AI智能分析引擎.md
+.qoder/repowiki/zh/content/核心功能模块/回测引擎/服务集成与API.md
+.qoder/repowiki/zh/content/核心功能模块/回测引擎/回测引擎.md
+.qoder/repowiki/zh/content/核心功能模块/回测引擎/回测引擎核心架构.md
+.qoder/repowiki/zh/content/核心功能模块/回测引擎/量化策略配置.md
+.qoder/repowiki/zh/content/核心功能模块/回测引擎/性能指标与分析.md
+.qoder/repowiki/zh/content/核心功能模块/数据提供者系统/基本面数据适配器.md
+.qoder/repowiki/zh/content/核心功能模块/数据提供者系统/数据提供者系统.md
+.qoder/repowiki/zh/content/核心功能模块/数据提供者系统/数据源策略与切换机制.md
+.qoder/repowiki/zh/content/核心功能模块/数据提供者系统/数据源基类与接口.md
+.qoder/repowiki/zh/content/核心功能模块/数据提供者系统/AkShare数据源.md
+.qoder/repowiki/zh/content/核心功能模块/数据提供者系统/Tushare数据源.md
+.qoder/repowiki/zh/content/核心功能模块/数据提供者系统/YFinance数据源.md
+.qoder/repowiki/zh/content/核心功能模块/股票数据分析系统/股票数据分析系统.md
+.qoder/repowiki/zh/content/核心功能模块/股票数据分析系统/基本面分析.md
+.qoder/repowiki/zh/content/核心功能模块/股票数据分析系统/技术分析工具.md
+.qoder/repowiki/zh/content/核心功能模块/股票数据分析系统/数据标准化流程.md
+.qoder/repowiki/zh/content/核心功能模块/股票数据分析系统/新闻情感分析.md
+.qoder/repowiki/zh/content/核心功能模块/通知系统/多渠道路由机制.md
+.qoder/repowiki/zh/content/核心功能模块/通知系统/通知规则设置.md
+.qoder/repowiki/zh/content/核心功能模块/通知系统/通知渠道配置.md
+.qoder/repowiki/zh/content/核心功能模块/通知系统/通知系统.md
+.qoder/repowiki/zh/content/核心功能模块/通知系统/消息模板设计.md
+.qoder/repowiki/zh/content/用户界面/移动端适配.md
+.qoder/repowiki/zh/content/用户界面/用户界面.md
+.qoder/repowiki/zh/content/用户界面/主题系统.md
+.qoder/repowiki/zh/content/用户界面/桌面应用.md
+.qoder/repowiki/zh/content/用户界面/UI组件库/布局组件.md
+.qoder/repowiki/zh/content/用户界面/UI组件库/基础组件.md
+.qoder/repowiki/zh/content/用户界面/UI组件库/数据展示组件.md
+.qoder/repowiki/zh/content/用户界面/UI组件库/专用组件.md
+.qoder/repowiki/zh/content/用户界面/UI组件库/UI组件库.md
+.qoder/repowiki/zh/content/用户界面/Web界面/布局系统.md
+.qoder/repowiki/zh/content/用户界面/Web界面/回测工具.md
+.qoder/repowiki/zh/content/用户界面/Web界面/聊天分析界面.md
+.qoder/repowiki/zh/content/用户界面/Web界面/路由系统.md
+.qoder/repowiki/zh/content/用户界面/Web界面/设置配置.md
+.qoder/repowiki/zh/content/用户界面/Web界面/通用组件库.md
+.qoder/repowiki/zh/content/用户界面/Web界面/投资组合管理.md
+.qoder/repowiki/zh/content/用户界面/Web界面/仪表板页面.md
+.qoder/repowiki/zh/content/用户界面/Web界面/Web界面.md
+.qoder/repowiki/zh/content/系统架构/系统架构.md
+.qoder/repowiki/zh/content/系统架构/组件交互.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理编排器.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理工厂模式.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/AI代理架构.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理工具系统/代理工具系统.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理工具系统/分析工具.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理工具系统/工具注册表核心.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理工具系统/回测工具.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理工具系统/市场工具.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理工具系统/数据工具.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理工具系统/搜索工具.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理技能系统/代理技能系统.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理技能系统/技能代理执行.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理技能系统/技能管理器.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理技能系统/技能加载系统.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理技能系统/技能聚合系统.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理技能系统/技能路由系统.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理技能系统/技能数据模型.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理技能系统/默认技能配置.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理类型系统/代理类型系统.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理类型系统/风险代理.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理类型系统/基础代理类.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理类型系统/技术分析代理.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理类型系统/决策代理.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理类型系统/投资组合代理.md
+.qoder/repowiki/zh/content/系统架构/AI代理架构/代理类型系统/智能代理.md
+.qoder/repowiki/zh/content/系统架构/API架构/路由系统.md
+.qoder/repowiki/zh/content/系统架构/API架构/请求响应流程.md
+.qoder/repowiki/zh/content/系统架构/API架构/中间件栈.md
+.qoder/repowiki/zh/content/系统架构/API架构/API版本控制.md
+.qoder/repowiki/zh/content/系统架构/API架构/API架构.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据存储系统.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据缓存系统.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据架构.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据提供者系统/东方财富数据源.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据提供者系统/数据提供者系统.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据提供者系统/数据源管理器.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据提供者系统/数据源基类.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据提供者系统/长桥数据源.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据提供者系统/AkShare数据源.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据提供者系统/Baostock数据源.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据提供者系统/PyTDX数据源.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据提供者系统/TickFlow数据源.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据提供者系统/Tushare数据源.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据提供者系统/Yahoo Finance数据源.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据标准化系统/财务数据适配器.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据标准化系统/股票代码标准化.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据标准化系统/股票指数加载.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据标准化系统/数据标准化系统.md
+.qoder/repowiki/zh/content/系统架构/数据架构/数据标准化系统/数据质量控制.md
+.qoder/repowiki/zh/content/系统架构/通知架构/通知发送器.md
+.qoder/repowiki/zh/content/系统架构/通知架构/通知架构.md
+.qoder/repowiki/zh/content/系统架构/通知架构/通知路由机制.md
+.qoder/repowiki/zh/content/系统架构/通知架构/通知配置管理.md
+.qoder/repowiki/zh/content/系统架构/通知架构/消息模板系统.md
+.qoder/repowiki/zh/content/部署指南/备份与恢复.md
+.qoder/repowiki/zh/content/部署指南/部署指南.md
+.qoder/repowiki/zh/content/部署指南/监控告警系统.md
+.qoder/repowiki/zh/content/部署指南/生产环境部署.md
+.qoder/repowiki/zh/content/部署指南/性能优化策略.md
+.qoder/repowiki/zh/content/部署指南/Docker容器化部署.md
+.qoder/repowiki/zh/content/配置管理/配置管理.md
+.qoder/repowiki/zh/content/配置管理/系统配置.md
+.qoder/repowiki/zh/content/配置管理/性能配置.md
+.qoder/repowiki/zh/content/配置管理/AI模型配置/多键支持.md
+.qoder/repowiki/zh/content/配置管理/AI模型配置/多提供商集成.md
+.qoder/repowiki/zh/content/配置管理/AI模型配置/降级回退策略.md
+.qoder/repowiki/zh/content/配置管理/AI模型配置/提供商特定配置.md
+.qoder/repowiki/zh/content/配置管理/AI模型配置/通道路由系统.md
+.qoder/repowiki/zh/content/配置管理/AI模型配置/温度参数管理.md
+.qoder/repowiki/zh/content/配置管理/AI模型配置/AI模型配置.md
+.qoder/repowiki/zh/content/配置管理/数据源配置/数据缓存配置.md
+.qoder/repowiki/zh/content/配置管理/数据源配置/数据源架构设计.md
+.qoder/repowiki/zh/content/配置管理/数据源配置/数据源降级机制.md
+.qoder/repowiki/zh/content/配置管理/数据源配置/数据源配置.md
+.qoder/repowiki/zh/content/配置管理/数据源配置/AkShare数据源配置.md
+.qoder/repowiki/zh/content/配置管理/数据源配置/LongBridge数据源配置.md
+.qoder/repowiki/zh/content/配置管理/数据源配置/Tushare数据源配置.md
+.qoder/repowiki/zh/content/配置管理/数据源配置/Yahoo Finance数据源配置.md
+.qoder/repowiki/zh/content/配置管理/通知配置/飞书通知配置.md
+.qoder/repowiki/zh/content/配置管理/通知配置/通知路由规则.md
+.qoder/repowiki/zh/content/配置管理/通知配置/通知模板系统.md
+.qoder/repowiki/zh/content/配置管理/通知配置/通知配置.md
+.qoder/repowiki/zh/content/配置管理/通知配置/通知渠道总览.md
+.qoder/repowiki/zh/content/配置管理/通知配置/邮件通知配置.md
+.qoder/repowiki/zh/content/配置管理/通知配置/自定义Webhook配置.md
+.qoder/repowiki/zh/content/配置管理/通知配置/Discord和Slack配置.md
+.qoder/repowiki/zh/content/配置管理/通知配置/Pushover通知配置.md
+.qoder/repowiki/zh/content/配置管理/通知配置/Telegram通知配置.md
+.qoder/repowiki/zh/meta/repowiki-metadata.json
+wiki/index.md
+wiki/log.md
+wiki/SCHEMA.md
+.qoder/skills/mx-data/_meta.json
+.qoder/skills/mx-data/mx_data.py
+.qoder/skills/mx-data/SKILL.md
+.qoder/skills/mx-search/_meta.json
+.qoder/skills/mx-search/mx_search.py
+.qoder/skills/mx-search/SKILL.md
+.qoder/skills/mx-xuangu/_meta.json
+.qoder/skills/mx-xuangu/mx_xuangu.py
+.qoder/skills/mx-xuangu/SKILL.md

api/v1/endpoints/__init__.py

@@ -19,6 +19,7 @@
     agent,
     usage,
     portfolio,
+    screen,
 )
 __all__ = [
     "health",
@@ -31,4 +32,5 @@
     "agent",
     "usage",
     "portfolio",
+    "screen",
 ]

api/v1/endpoints/screen.py

@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*-
+"""
+===================================
+AI 选股 API 端点（基于东方财富妙想智能选股）
+===================================
+
+职责：
+1. 接收自然语言选股条件
+2. 复用 miaoxiang_tools 中的 smart_stock_screen 实现
+3. 返回结构化选股结果
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, List, Optional
+
+from fastapi import APIRouter, HTTPException
+from pydantic import BaseModel, Field
+
+from src.agent.tools.miaoxiang_tools import _handle_smart_stock_screen
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter()
+
+
+class ScreenQueryRequest(BaseModel):
+    """AI 选股请求"""
+    query: str = Field(..., min_length=1, max_length=500, description="自然语言选股条件，如 '今天涨幅超过5%的A股'")
+
+
+class ScreenQueryResponse(BaseModel):
+    """AI 选股响应"""
+    success: bool
+    query: str
+    results_count: int = 0
+    returned_count: int = 0
+    data_source: Optional[str] = None
+    results: List[Dict[str, Any]] = Field(default_factory=list)
+    message: Optional[str] = None
+    error: Optional[str] = None
+
+
+@router.post(
+    "/query",
+    response_model=ScreenQueryResponse,
+    summary="AI 智能选股",
+    description="通过自然语言条件调用东方财富妙想 API 筛选股票。需配置 MX_APIKEY。",
+)
+def screen_query(payload: ScreenQueryRequest) -> ScreenQueryResponse:
+    query = payload.query.strip()
+    if not query:
+        raise HTTPException(status_code=400, detail="选股条件不能为空")
+
+    logger.info("AI screen query: %s", query)
+    result = _handle_smart_stock_screen(query)
+
+    # Error case: MX_APIKEY not configured or all keys failed
+    if "error" in result:
+        err_msg = result["error"]
+        if "not configured" in err_msg or "MX_APIKEY" in err_msg:
+            raise HTTPException(
+                status_code=503,
+                detail="AI 选股功能未启用：请在设置页配置 MX_APIKEY（东方财富妙想 API Key）。",
+            )
+        return ScreenQueryResponse(
+            success=False,
+            query=query,
+            error=err_msg,
+        )
+
+    return ScreenQueryResponse(
+        success=bool(result.get("success", False)),
+        query=result.get("query", query),
+        results_count=int(result.get("results_count", 0) or 0),
+        returned_count=int(result.get("returned_count", 0) or 0),
+        data_source=result.get("data_source"),
+        results=result.get("results", []) or [],
+        message=result.get("message"),
+    )

api/v1/router.py

@@ -11,7 +11,7 @@
 
 from fastapi import APIRouter
 
-from api.v1.endpoints import analysis, auth, history, stocks, backtest, system_config, agent, usage, portfolio
+from api.v1.endpoints import analysis, auth, history, stocks, backtest, system_config, agent, usage, portfolio, screen
 
 # 创建 v1 版本主路由
 router = APIRouter(prefix="/api/v1")
@@ -69,3 +69,9 @@
     prefix="/portfolio",
     tags=["Portfolio"]
 )
+
+router.include_router(
+    screen.router,
+    prefix="/screen",
+    tags=["Screen"]
+)

apps/dsa-web/src/App.tsx

@@ -8,6 +8,7 @@ import LoginPage from './pages/LoginPage';
 import NotFoundPage from './pages/NotFoundPage';
 import ChatPage from './pages/ChatPage';
 import PortfolioPage from './pages/PortfolioPage';
+import ScreenPage from './pages/ScreenPage';
 import { ApiErrorAlert, Shell } from './components/common';
 import { AuthProvider, useAuth } from './contexts/AuthContext';
 import { useAgentChatStore } from './stores/agentChatStore';
@@ -62,6 +63,7 @@ const AppContent: React.FC = () => {
     <Routes>
       <Route element={<Shell />}>
         <Route path="/" element={<HomePage />} />
+        <Route path="/screen" element={<ScreenPage />} />
         <Route path="/chat" element={<ChatPage />} />
         <Route path="/portfolio" element={<PortfolioPage />} />
         <Route path="/backtest" element={<BacktestPage />} />

apps/dsa-web/src/api/screen.ts

@@ -0,0 +1,36 @@
+import apiClient from './index';
+import { toCamelCase } from './utils';
+
+// ============ Types ============
+
+/** A single stock row returned by the AI screen endpoint. */
+export type ScreenResultRow = Record<string, string>;
+
+export interface ScreenResponse {
+  success: boolean;
+  query: string;
+  resultsCount: number;
+  returnedCount: number;
+  dataSource?: string;
+  results: ScreenResultRow[];
+  message?: string;
+  error?: string;
+}
+
+// ============ API ============
+
+export const screenApi = {
+  /**
+   * Trigger an AI-powered stock screen using natural language conditions.
+   * @param query Natural language screening query (e.g. "今天涨幅超过5%的A股")
+   */
+  query: async (query: string): Promise<ScreenResponse> => {
+    const response = await apiClient.post<Record<string, unknown>>(
+      '/api/v1/screen/query',
+      { query },
+    );
+    return toCamelCase<ScreenResponse>(response.data);
+  },
+};
+
+export default screenApi;

apps/dsa-web/src/components/layout/ShellHeader.tsx

@@ -11,6 +11,7 @@ type ShellHeaderProps = {
 
 const TITLES: Record<string, { title: string; description: string }> = {
   '/': { title: '首页', description: '股票分析与历史报告工作台' },
+  '/screen': { title: 'AI选股', description: '自然语言智能选股' },
   '/chat': { title: '问股', description: '多轮策略问答与历史会话管理' },
   '/backtest': { title: '回测', description: '回测任务与结果浏览' },
   '/settings': { title: '设置', description: '系统配置、模型与认证管理' },