fund-cli 2.0.0__py3-none-any.whl

fund_cli/commands/interactive_cmd.py

@@ -0,0 +1,84 @@
+"""交互式模式"""
+
+import typer
+from rich import box
+from rich.console import Console
+from rich.panel import Panel
+
+app = typer.Typer(help="交互式模式")
+console = Console()
+
+
+@app.command()
+def interactive_mode():
+    """启动交互式REPL模式 (CLI-UX-006)"""
+    try:
+        from prompt_toolkit import PromptSession
+        from prompt_toolkit.completion import WordCompleter
+        from prompt_toolkit.history import InMemoryHistory
+    except ImportError:
+        console.print("[yellow]需要安装 prompt_toolkit: pip install prompt_toolkit[/yellow]")
+        raise typer.Exit(1) from None
+
+    commands = [
+        "info",
+        "filter",
+        "analyze",
+        "compare",
+        "optimize",
+        "monitor",
+        "holding",
+        "manager",
+        "data",
+        "config",
+        "help",
+        "exit",
+        "quit",
+    ]
+
+    completer = WordCompleter(commands, ignore_case=True)
+    session = PromptSession(completer=completer, history=InMemoryHistory())
+
+    console.print(
+        Panel(
+            "[bold]Fund CLI 交互式模式[/bold]\n"
+            "输入命令（如 info 000001）或 help 查看帮助\n"
+            "输入 exit 或 quit 退出",
+            box=box.ROUNDED,
+            border_style="blue",
+        )
+    )
+
+    while True:
+        try:
+            user_input = session.prompt("fund> ").strip()
+        except (EOFError, KeyboardInterrupt):
+            console.print("\n[yellow]再见！[/yellow]")
+            break
+
+        if not user_input:
+            continue
+
+        if user_input.lower() in ("exit", "quit"):
+            console.print("[yellow]再见！[/yellow]")
+            break
+
+        if user_input.lower() == "help":
+            console.print("可用命令: info, filter, analyze, compare, optimize,")
+            console.print("          monitor, holding, manager, data, config")
+            console.print("输入 exit 或 quit 退出")
+            continue
+
+        # 执行命令
+        try:
+            from typer.testing import CliRunner
+
+            from fund_cli.cli import app as main_app
+
+            runner = CliRunner()
+            args = user_input.split()
+            result = runner.invoke(main_app, args)
+            if result.output:
+                console.print(result.output)
+        except Exception as e:
+            console.print(f"[red]错误: {e}[/red]")

fund_cli/commands/main.py

@@ -0,0 +1,17 @@
+"""
+命令主入口
+
+CLI 命令模块的主入口，提供命令注册辅助功能。
+"""
+
+
+def register_commands(app, commands: dict) -> None:
+    """
+    批量注册子命令
+
+    Args:
+        app: Typer 主应用
+        commands: {名称: 子应用} 字典
+    """
+    for name, sub_app in commands.items():
+        app.add_typer(sub_app, name=name)

fund_cli/commands/manager_cmd.py

@@ -0,0 +1,74 @@
+"""
+基金经理命令
+
+提供基金经理信息查询、业绩统计和稳定性分析功能。
+"""
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from fund_cli.analysis.manager import ManagerAnalyzer
+from fund_cli.core.data_manager import DataManager
+
+app = typer.Typer(help="基金经理命令")
+console = Console()
+
+
+@app.command("info")
+def manager_info(fund_code: str = typer.Argument(..., help="基金代码")):
+    """查询基金经理信息 (FUND-MANAGER-001)"""
+    dm = DataManager()
+    try:
+        manager_data = dm.get_fund_manager(fund_code)
+        analyzer = ManagerAnalyzer()
+        info = analyzer.manager_info(manager_data)
+        console.print("\n[bold]基金经理信息[/bold]")
+        console.print(f"  姓名: {info['name']}")
+        console.print(f"  基金: {info['fund_name']}")
+        console.print(f"  公司: {info['company']}")
+        console.print(f"  任职日期: {info['start_date']}")
+        console.print(f"  任职天数: {info['tenure_days']}")
+    except Exception as e:
+        console.print(f"[red]获取经理信息失败: {e}[/red]")
+        raise typer.Exit(1) from None
+
+
+@app.command("performance")
+def manager_performance(fund_code: str = typer.Argument(..., help="基金代码")):
+    """经理业绩统计 (FUND-MANAGER-002)"""
+    dm = DataManager()
+    try:
+        manager_data = dm.get_fund_manager(fund_code)
+        analyzer = ManagerAnalyzer()
+        stats = analyzer.performance_stats(manager_data)
+        console.print(f"\n[bold]{manager_data.get('name', '')}[/bold] 业绩统计：")
+        table = Table(show_header=True, header_style="bold blue")
+        table.add_column("指标", style="cyan")
+        table.add_column("值", justify="right")
+        table.add_row("管理基金数", str(stats["total_funds"]))
+        table.add_row("平均收益率", f"{stats['avg_return']:.2f}%")
+        table.add_row("最佳基金", stats["best_fund"])
+        table.add_row("最佳收益率", f"{stats['best_return']:.2f}%")
+        console.print(table)
+    except Exception as e:
+        console.print(f"[red]业绩统计失败: {e}[/red]")
+        raise typer.Exit(1) from None
+
+
+@app.command("stability")
+def manager_stability(fund_code: str = typer.Argument(..., help="基金代码")):
+    """经理稳定性分析 (FUND-MANAGER-003)"""
+    dm = DataManager()
+    try:
+        manager_data = dm.get_fund_manager(fund_code)
+        analyzer = ManagerAnalyzer()
+        stability = analyzer.stability_analysis(manager_data)
+        console.print(f"\n[bold]{manager_data.get('name', '')}[/bold] 稳定性分析：")
+        console.print(f"  任职年限: {stability['tenure_years']}年")
+        console.print(f"  稳定性等级: [bold]{stability['stability_level']}[/bold]")
+        console.print(f"  稳定性评分: {stability['stability_score']}/5")
+        console.print(f"  多基金管理: {'是' if stability['multi_fund_manager'] else '否'}")
+    except Exception as e:
+        console.print(f"[red]稳定性分析失败: {e}[/red]")
+        raise typer.Exit(1) from None

fund_cli/commands/monitor_cmd.py

@@ -0,0 +1,113 @@
+"""监控预警命令"""
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+app = typer.Typer(help="监控预警命令")
+console = Console()
+
+
+def _get_monitor(config_dir: str = "~/.fund_cli"):
+    from fund_cli.core.monitor import FundMonitor
+
+    return FundMonitor(config_dir=config_dir)
+
+
+@app.command("add")
+def add_to_pool(
+    fund_code: str = typer.Argument(..., help="基金代码"),
+    group: str = typer.Option("default", help="分组名称"),
+):
+    """添加基金到监控池 (FUND-MONITOR-001)"""
+    monitor = _get_monitor()
+    monitor.add_to_pool(fund_code, group)
+    console.print(f"[green]已添加 {fund_code} 到 {group} 监控池[/green]")
+
+
+@app.command("remove")
+def remove_from_pool(
+    fund_code: str = typer.Argument(..., help="基金代码"),
+    group: str = typer.Option(None, help="分组名称"),
+):
+    """从监控池移除基金"""
+    monitor = _get_monitor()
+    if monitor.remove_from_pool(fund_code, group):
+        console.print(f"[green]已从监控池移除 {fund_code}[/green]")
+    else:
+        console.print(f"[yellow]{fund_code} 不在监控池中[/yellow]")
+
+
+@app.command("list")
+def list_pool(
+    group: str = typer.Option(None, help="分组名称"),
+):
+    """列出监控池中的基金 (FUND-MONITOR-001)"""
+    monitor = _get_monitor()
+    funds = monitor.list_pool(group)
+    if not funds:
+        console.print("[yellow]监控池为空[/yellow]")
+        return
+
+    table = Table(show_header=True, header_style="bold blue")
+    table.add_column("基金代码", style="cyan")
+    table.add_column("分组")
+    table.add_column("添加时间")
+    for f in funds:
+        table.add_row(f["code"], f.get("group", "default"), f.get("added_at", ""))
+    console.print(table)
+    console.print(f"\n共 {len(funds)} 只基金")
+
+
+@app.command("watch")
+def watch_fund(
+    fund_code: str = typer.Argument(..., help="基金代码"),
+    threshold: float = typer.Option(-2.0, help="预警阈值(%)"),
+):
+    """监控基金净值变动 (FUND-MONITOR-002)"""
+    monitor = _get_monitor()
+    monitor.add_to_pool(fund_code)
+    monitor.add_rule(fund_code, "nav_change", threshold)
+    console.print(f"[green]已开始监控 {fund_code}，阈值: {threshold}%[/green]")
+
+
+@app.command("check")
+def check_all():
+    """检查所有监控基金的净值变动"""
+    monitor = _get_monitor()
+    codes = monitor.get_all_fund_codes()
+    if not codes:
+        console.print("[yellow]监控池为空，请先添加基金[/yellow]")
+        return
+
+    console.print(f"正在检查 {len(codes)} 只基金...")
+    alerts = monitor.check_nav_changes(codes)
+    if alerts:
+        table = Table(show_header=True, header_style="bold red")
+        table.add_column("基金代码", style="cyan")
+        table.add_column("日收益率", justify="right", style="red")
+        table.add_column("阈值", justify="right")
+        for a in alerts:
+            table.add_row(a["fund_code"], f"{a['daily_return']:.2f}%", f"{a['threshold']:.2f}%")
+        console.print(table)
+        console.print(f"\n[bold red]{len(alerts)} 只基金触发预警[/bold red]")
+    else:
+        console.print("[green]所有基金正常，无预警[/green]")
+
+
+@app.command("alert")
+def alert_list():
+    """查看预警规则"""
+    monitor = _get_monitor()
+    rules = monitor.get_rules()
+    if not rules:
+        console.print("[yellow]暂无预警规则[/yellow]")
+        return
+
+    table = Table(show_header=True, header_style="bold blue")
+    table.add_column("基金代码", style="cyan")
+    table.add_column("规则类型")
+    table.add_column("阈值", justify="right")
+    for r in rules:
+        table.add_row(r["fund_code"], r["rule_type"], f"{r['threshold']:.2f}%")
+    console.print(table)

fund_cli/commands/optimize_cmd.py

@@ -0,0 +1,192 @@
+"""组合优化命令"""
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from fund_cli.data.models import OptimizationConstraint
+
+app = typer.Typer(help="组合优化命令")
+console = Console()
+
+
+def _get_returns(fund_codes: list[str], period: str):
+    """获取多基金收益率数据"""
+    from datetime import date, timedelta
+
+    import pandas as pd
+
+    from fund_cli.core.data_manager import DataManager
+
+    dm = DataManager()
+    end = date.today()
+    days_map = {"1m": 30, "3m": 90, "6m": 180, "1y": 365, "2y": 730, "3y": 1095}
+    start = end - timedelta(days=days_map.get(period, 365))
+
+    all_nav = {}
+    for code in fund_codes:
+        try:
+            nav_df = dm.get_fund_nav(code, start_date=start, end_date=end)
+            if not nav_df.empty and "daily_return" in nav_df.columns:
+                nav_df = nav_df.dropna(subset=["daily_return"])
+                nav_df["daily_return"] = nav_df["daily_return"] / 100.0
+                all_nav[code] = nav_df.set_index("nav_date")["daily_return"]
+        except Exception:
+            continue
+
+    if not all_nav:
+        return None
+
+    return pd.DataFrame(all_nav)
+
+
+@app.command("mean-variance")
+def mean_variance(
+    fund_codes: str = typer.Argument(..., help="基金代码，逗号分隔"),
+    period: str = typer.Option("1y", help="分析周期"),
+    risk_free: float = typer.Option(0.03, help="无风险利率"),
+    min_weight: float = typer.Option(0.0, help="最小权重"),
+    max_weight: float = typer.Option(1.0, help="最大权重"),
+):
+    """均值-方差优化 (PORTFOLIO-OPT-001)"""
+    codes = [c.strip() for c in fund_codes.split(",")]
+    returns = _get_returns(codes, period)
+    if returns is None or returns.empty:
+        console.print("[red]无法获取收益率数据[/red]")
+        raise typer.Exit(1) from None
+
+    from fund_cli.core.optimizers.mean_variance import MeanVarianceOptimizer
+
+    constraints = OptimizationConstraint(min_weight=min_weight, max_weight=max_weight)
+    optimizer = MeanVarianceOptimizer(risk_free_rate=risk_free)
+    result = optimizer.optimize(returns, constraints)
+
+    console.print("\n[bold]均值-方差优化结果[/bold]")
+    _print_result(result)
+
+
+@app.command("max-sharpe")
+def max_sharpe(
+    fund_codes: str = typer.Argument(..., help="基金代码，逗号分隔"),
+    period: str = typer.Option("1y", help="分析周期"),
+    risk_free: float = typer.Option(0.03, help="无风险利率"),
+    min_weight: float = typer.Option(0.0, help="最小权重"),
+    max_weight: float = typer.Option(1.0, help="最大权重"),
+):
+    """最大夏普比率优化 (PORTFOLIO-OPT-002)"""
+    codes = [c.strip() for c in fund_codes.split(",")]
+    returns = _get_returns(codes, period)
+    if returns is None or returns.empty:
+        console.print("[red]无法获取收益率数据[/red]")
+        raise typer.Exit(1) from None
+
+    from fund_cli.core.optimizers.max_sharpe import MaxSharpeOptimizer
+
+    constraints = OptimizationConstraint(min_weight=min_weight, max_weight=max_weight)
+    optimizer = MaxSharpeOptimizer(risk_free_rate=risk_free)
+    result = optimizer.optimize(returns, constraints)
+
+    console.print("\n[bold]最大夏普比率优化结果[/bold]")
+    _print_result(result)
+
+
+@app.command("risk-parity")
+def risk_parity(
+    fund_codes: str = typer.Argument(..., help="基金代码，逗号分隔"),
+    period: str = typer.Option("1y", help="分析周期"),
+):
+    """风险平价优化 (PORTFOLIO-OPT-003)"""
+    codes = [c.strip() for c in fund_codes.split(",")]
+    returns = _get_returns(codes, period)
+    if returns is None or returns.empty:
+        console.print("[red]无法获取收益率数据[/red]")
+        raise typer.Exit(1) from None
+
+    from fund_cli.core.optimizers.risk_parity import RiskParityOptimizer
+
+    optimizer = RiskParityOptimizer()
+    result = optimizer.optimize(returns)
+
+    console.print("\n[bold]风险平价优化结果[/bold]")
+    _print_result(result)
+
+
+@app.command("frontier")
+def efficient_frontier(
+    fund_codes: str = typer.Argument(..., help="基金代码，逗号分隔"),
+    period: str = typer.Option("1y", help="分析周期"),
+    points: int = typer.Option(50, help="前沿点数"),
+):
+    """有效前沿计算 (PORTFOLIO-OPT-006)"""
+    codes = [c.strip() for c in fund_codes.split(",")]
+    returns = _get_returns(codes, period)
+    if returns is None or returns.empty:
+        console.print("[red]无法获取收益率数据[/red]")
+        raise typer.Exit(1) from None
+
+    from fund_cli.core.optimizers.efficient_frontier import EfficientFrontierCalculator
+
+    calc = EfficientFrontierCalculator()
+    result = calc.calculate(returns, n_points=points)
+
+    console.print(f"\n[bold]有效前沿[/bold] ({result['n_points']}个点)")
+    console.print(
+        f"  收益范围: {min(result['frontier_returns']):.2%} ~ {max(result['frontier_returns']):.2%}"
+    )
+    console.print(
+        f"  波动范围: {min(result['frontier_volatilities']):.2%} ~ {max(result['frontier_volatilities']):.2%}"
+    )
+
+
+@app.command("backtest")
+def backtest(
+    fund_codes: str = typer.Argument(..., help="基金代码，逗号分隔"),
+    weights: str = typer.Option(None, help="权重，逗号分隔(如0.4,0.3,0.3)"),
+    period: str = typer.Option("1y", help="分析周期"),
+    rebalance: str = typer.Option("monthly", help="再平衡频率"),
+):
+    """组合回测 (PORTFOLIO-OPT-007)"""
+    codes = [c.strip() for c in fund_codes.split(",")]
+    returns = _get_returns(codes, period)
+    if returns is None or returns.empty:
+        console.print("[red]无法获取收益率数据[/red]")
+        raise typer.Exit(1) from None
+
+    w = None
+    if weights:
+        w_list = [float(x.strip()) for x in weights.split(",")]
+        if len(w_list) == len(codes):
+            w = dict(zip(codes, w_list, strict=False))
+
+    from fund_cli.analysis.backtest import BacktestAnalyzer
+
+    analyzer = BacktestAnalyzer()
+    result = analyzer.run_backtest(returns, weights=w, rebalance_freq=rebalance)
+
+    console.print("\n[bold]组合回测结果[/bold]")
+    table = Table(show_header=True, header_style="bold blue")
+    table.add_column("指标", style="cyan")
+    table.add_column("值", justify="right")
+    table.add_row("累计收益率", f"{result['total_return']:.2f}%")
+    table.add_row("年化收益率", f"{result['annual_return']:.2f}%")
+    table.add_row("年化波动率", f"{result['annual_volatility']:.2f}%")
+    table.add_row("夏普比率", f"{result['sharpe_ratio']:.4f}")
+    table.add_row("最大回撤", f"{result['max_drawdown']:.2f}%")
+    table.add_row("日胜率", f"{result['win_rate']:.1f}%")
+    table.add_row("交易天数", str(result["trading_days"]))
+    console.print(table)
+
+
+def _print_result(result: dict) -> None:
+    """打印优化结果"""
+    console.print(f"  方法: {result['method']}")
+    console.print(f"  预期收益: {result['expected_return']:.2%}")
+    console.print(f"  预期波动: {result['volatility']:.2%}")
+    console.print(f"  夏普比率: {result['sharpe_ratio']:.4f}")
+    console.print("\n  [bold]权重分配:[/bold]")
+    table = Table(show_header=True, header_style="bold blue")
+    table.add_column("基金代码", style="cyan")
+    table.add_column("权重", justify="right")
+    for code, weight in sorted(result["weights"].items(), key=lambda x: x[1], reverse=True):
+        table.add_row(code, f"{weight:.2%}")
+    console.print(table)

fund_cli/config.py

@@ -0,0 +1,163 @@
+"""
+Fund CLI 配置管理
+
+使用 Pydantic Settings 管理应用配置，支持环境变量和 .env 文件。
+"""
+
+from pathlib import Path
+
+from pydantic import Field, field_validator
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class DataConfig(BaseSettings):
+    """数据源配置"""
+
+    model_config = SettingsConfigDict(env_prefix="FUND_DATA_")
+
+    # AKShare 配置
+    akshare_enabled: bool = Field(default=True, description="是否启用AKShare数据源")
+
+    # Tushare 配置
+    tushare_token: str | None = Field(default=None, description="Tushare API Token")
+
+    # Wind 配置
+    wind_enabled: bool = Field(default=False, description="是否启用Wind数据源")
+    wind_username: str | None = Field(default=None, description="Wind用户名")
+    wind_password: str | None = Field(default=None, description="Wind密码")
+
+    # 缓存配置
+    cache_ttl: int = Field(default=3600, description="缓存过期时间（秒）")
+    cache_dir: str = Field(default="~/.fund_cli/cache", description="缓存目录")
+
+    @field_validator("cache_dir")
+    @classmethod
+    def expand_cache_dir(cls, v: str) -> str:
+        """展开缓存目录路径"""
+        return str(Path(v).expanduser())
+
+
+class AnalysisConfig(BaseSettings):
+    """分析配置"""
+
+    model_config = SettingsConfigDict(env_prefix="FUND_ANALYSIS_")
+
+    risk_free_rate: float = Field(default=0.03, description="无风险利率")
+    default_benchmark: str = Field(default="000300", description="默认基准指数代码")
+    default_period: str = Field(default="1y", description="默认分析周期")
+
+    @field_validator("risk_free_rate")
+    @classmethod
+    def validate_risk_free_rate(cls, v: float) -> float:
+        """验证无风险利率范围"""
+        if not 0 <= v <= 1:
+            raise ValueError("无风险利率必须在 0-1 之间")
+        return v
+
+
+class AIConfig(BaseSettings):
+    """AI配置（V2.0功能）"""
+
+    model_config = SettingsConfigDict(env_prefix="FUND_AI_")
+
+    provider: str = Field(default="openai", description="LLM提供商: openai/qwen/litellm")
+    model: str = Field(default="gpt-4", description="模型名称")
+    api_key: str | None = Field(default=None, description="API密钥")
+    api_base: str | None = Field(default=None, description="API基础URL")
+    temperature: float = Field(default=0.7, description="温度参数(0-2)")
+    max_tokens: int = Field(default=2000, description="最大token数")
+    timeout: int = Field(default=30, description="请求超时(秒)")
+    retry_count: int = Field(default=3, description="重试次数")
+
+    # Qwen专用配置
+    qwen_api_key: str | None = Field(default=None, description="阿里云Qwen API Key")
+    qwen_base_url: str = Field(
+        default="https://dashscope.aliyuncs.com/api/v1", description="Qwen API地址"
+    )
+    qwen_model: str = Field(
+        default="qwen-max", description="Qwen模型: qwen-max/qwen-plus/qwen-turbo"
+    )
+
+    @field_validator("temperature")
+    @classmethod
+    def validate_temperature(cls, v: float) -> float:
+        """验证温度参数范围"""
+        if not 0 <= v <= 2:
+            raise ValueError("温度参数必须在 0-2 之间")
+        return v
+
+    @field_validator("retry_count")
+    @classmethod
+    def validate_retry_count(cls, v: int) -> int:
+        """验证重试次数"""
+        if not 0 <= v <= 10:
+            raise ValueError("重试次数必须在 0-10 之间")
+        return v
+
+
+class LogConfig(BaseSettings):
+    """日志配置"""
+
+    model_config = SettingsConfigDict(env_prefix="FUND_LOG_")
+
+    level: str = Field(default="INFO", description="日志级别")
+    file: str | None = Field(default=None, description="日志文件路径")
+
+
+class OutputConfig(BaseSettings):
+    """输出格式配置"""
+
+    model_config = SettingsConfigDict(env_prefix="FUND_OUTPUT_")
+
+    default_format: str = Field(default="table", description="默认输出格式")
+    csv_encoding: str = Field(default="utf-8-sig", description="CSV编码")
+    csv_delimiter: str = Field(default=",", description="CSV分隔符")
+    json_indent: int = Field(default=2, description="JSON缩进")
+    number_decimal: int = Field(default=2, description="数字小数位")
+    date_format: str = Field(default="%Y-%m-%d", description="日期格式")
+
+
+class AppConfig(BaseSettings):
+    """应用主配置"""
+
+    model_config = SettingsConfigDict(
+        env_file=".env",
+        env_file_encoding="utf-8",
+        env_nested_delimiter="__",
+        extra="ignore",
+    )
+
+    # 应用信息
+    app_name: str = Field(default="Fund CLI", description="应用名称")
+    debug: bool = Field(default=False, description="调试模式")
+    dev_mode: bool = Field(default=False, description="开发模式")
+
+    # 嵌套配置
+    data: DataConfig = Field(default_factory=DataConfig)
+    analysis: AnalysisConfig = Field(default_factory=AnalysisConfig)
+    ai: AIConfig = Field(default_factory=AIConfig)
+    log: LogConfig = Field(default_factory=LogConfig)
+    output: OutputConfig = Field(default_factory=OutputConfig)
+
+
+# 全局配置实例
+_config: AppConfig | None = None
+
+
+def get_config() -> AppConfig:
+    """获取配置实例（单例模式）"""
+    global _config
+    if _config is None:
+        _config = AppConfig()
+    return _config
+
+
+def reload_config() -> AppConfig:
+    """重新加载配置"""
+    global _config
+    _config = AppConfig()
+    return _config
+
+
+# 便捷访问
+config = get_config()

fund_cli/core/__init__.py

@@ -0,0 +1,8 @@
+"""核心模块 - 数据管理器、分析引擎、优化引擎、报告生成器"""
+
+from fund_cli.core.analyzer import Analyzer
+from fund_cli.core.data_manager import DataManager
+from fund_cli.core.optimizer import Optimizer
+from fund_cli.core.reporter import Reporter
+
+__all__ = ["DataManager", "Analyzer", "Optimizer", "Reporter"]