fund-cli 2.0.0__py3-none-any.whl

fund_cli/commands/config_cmd.py

@@ -0,0 +1,97 @@
+"""
+配置管理命令
+
+提供配置查看和设置功能。
+"""
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from fund_cli.config import get_config
+
+app = typer.Typer(help="配置管理命令")
+console = Console()
+
+
+@app.command("show")
+def show_config() -> None:
+    """显示当前配置。"""
+    try:
+        config = get_config()
+
+        table = Table(title="当前配置")
+        table.add_column("配置项", style="cyan")
+        table.add_column("值", style="green")
+
+        # 应用配置
+        table.add_row("应用名称", config.app_name)
+        table.add_row("调试模式", str(config.debug))
+
+        # 数据配置
+        table.add_row("AKShare启用", str(config.data.akshare_enabled))
+        table.add_row("缓存TTL", f"{config.data.cache_ttl}秒")
+        table.add_row("缓存目录", config.data.cache_dir)
+
+        # 分析配置
+        table.add_row("无风险利率", f"{config.analysis.risk_free_rate * 100}%")
+        table.add_row("默认基准", config.analysis.default_benchmark)
+
+        console.print(table)
+
+    except Exception as e:
+        console.print(f"[red]获取配置失败: {e}[/red]")
+
+
+@app.command("output")
+def output_config(
+    format: str = typer.Option(None, help="默认输出格式: table/csv/json"),
+    encoding: str = typer.Option(None, help="CSV编码"),
+    decimal: int = typer.Option(None, help="数字小数位"),
+):
+    """输出格式配置 (FUND-CONFIG-004)"""
+    from fund_cli.config import AppConfig
+
+    config = AppConfig()
+    if format:
+        config.output.default_format = format
+    if encoding:
+        config.output.csv_encoding = encoding
+    if decimal is not None:
+        config.output.number_decimal = decimal
+
+    console.print("\n[bold]输出格式配置[/bold]")
+    table = Table(show_header=True, header_style="bold blue")
+    table.add_column("配置项", style="cyan")
+    table.add_column("当前值")
+    table.add_row("默认格式", config.output.default_format)
+    table.add_row("CSV编码", config.output.csv_encoding)
+    table.add_row("CSV分隔符", config.output.csv_delimiter)
+    table.add_row("JSON缩进", str(config.output.json_indent))
+    table.add_row("数字小数位", str(config.output.number_decimal))
+    table.add_row("日期格式", config.output.date_format)
+    console.print(table)
+
+
+@app.command("set")
+def set_config(
+    key: str = typer.Argument(..., help="配置键"),
+    value: str = typer.Argument(..., help="配置值"),
+):
+    """设置配置项"""
+    from fund_cli.config import AppConfig
+
+    AppConfig()
+    console.print(f"[green]配置 {key} = {value} 已设置[/green]")
+    console.print("[yellow]注意: 当前仅显示，持久化配置请编辑 .env 文件[/yellow]")
+
+
+@app.callback(invoke_without_command=True)
+def default(ctx: typer.Context) -> None:
+    """默认显示配置"""
+    if ctx.invoked_subcommand is None:
+        show_config()
+
+
+if __name__ == "__main__":
+    app()

fund_cli/commands/data_cmd.py

@@ -0,0 +1,106 @@
+"""
+数据管理命令
+
+提供数据缓存管理、数据导出等功能。
+"""
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from fund_cli.core.data_manager import get_data_manager
+
+app = typer.Typer(help="数据管理命令")
+console = Console()
+
+
+@app.command("stats")
+def cache_stats() -> None:
+    """查看数据缓存统计信息。"""
+    try:
+        dm = get_data_manager()
+        stats = dm.get_cache_stats()
+
+        table = Table(title="缓存统计")
+        table.add_column("指标", style="cyan")
+        table.add_column("值", style="green")
+
+        table.add_row("缓存条目数", str(stats.get("size", 0)))
+        table.add_row("缓存大小", f"{stats.get('volume', 0) / 1024 / 1024:.2f} MB")
+        table.add_row("缓存目录", stats.get("directory", "-"))
+
+        console.print(table)
+
+    except Exception as e:
+        console.print(f"[red]获取缓存统计失败: {e}[/red]")
+
+
+@app.command("clear")
+def clear_cache() -> None:
+    """清空数据缓存。"""
+    try:
+        dm = get_data_manager()
+        dm.clear_cache()
+        console.print("[green]缓存已清空[/green]")
+    except Exception as e:
+        console.print(f"[red]清空缓存失败: {e}[/red]")
+
+
+@app.command("quality")
+def data_quality(fund_code: str = typer.Argument(..., help="基金代码")):
+    """数据质量检查 (FUND-DATA-005)"""
+    from fund_cli.core.data_quality import DataQualityChecker
+
+    checker = DataQualityChecker()
+    result = checker.check(fund_code)
+    console.print(f"\n[bold]{fund_code}[/bold] 数据质量报告：")
+    console.print(f"  整体状态: [bold]{result.get('overall_status', 'unknown')}[/bold]")
+    if "completeness" in result:
+        c = result["completeness"]
+        console.print(
+            f"  完整性评分: {c['score']}/100 (共{c['total_rows']}行, 缺失{sum(c['missing_values'].values())}个)"
+        )
+    if "accuracy" in result:
+        a = result["accuracy"]
+        console.print(f"  准确性评分: {a['score']}/100 (异常值{a['anomaly_count']}个)")
+    if "timeliness" in result:
+        t = result["timeliness"]
+        console.print(f"  时效性: {t['status']} (最后更新: {t.get('last_date', 'N/A')})")
+
+
+@app.command("update")
+def incremental_update(fund_code: str = typer.Argument(..., help="基金代码")):
+    """增量更新 (FUND-DATA-006)"""
+    from fund_cli.core.data_quality import DataQualityChecker
+
+    checker = DataQualityChecker()
+    result = checker.incremental_update(fund_code)
+    if result["status"] == "success":
+        console.print(f"[green]{fund_code}: 新增 {result['new_records']} 条记录[/green]")
+    else:
+        console.print(f"[red]{fund_code}: 更新失败 - {result.get('message', '')}[/red]")
+
+
+@app.command("batch-download")
+def batch_download(
+    fund_codes: str = typer.Argument(..., help="基金代码，逗号分隔"),
+    output: str = typer.Option(None, help="输出目录"),
+):
+    """批量下载 (FUND-DATA-007)"""
+    from fund_cli.core.data_quality import DataQualityChecker
+
+    codes = [c.strip() for c in fund_codes.split(",")]
+    checker = DataQualityChecker()
+    with console.status("正在批量下载..."):
+        result = checker.batch_download(codes)
+    console.print("\n[bold]批量下载完成[/bold]")
+    console.print(f"  总计: {result['total']} 只基金")
+    console.print(f"  成功: [green]{result['success']}[/green]")
+    console.print(f"  失败: [red]{result['failed']}[/red]")
+    for code, detail in result["details"].items():
+        if detail["status"] == "error":
+            console.print(f"    {code}: {detail.get('message', '失败')}")
+
+
+if __name__ == "__main__":
+    app()

fund_cli/commands/filter_cmd.py

@@ -0,0 +1,286 @@
+"""
+基金筛选命令
+
+提供基金筛选、排序、导出等功能。
+"""
+
+from enum import Enum
+
+import typer
+from rich.console import Console
+
+from fund_cli.core.data_manager import get_data_manager
+from fund_cli.views.tables import TableRenderer
+
+app = typer.Typer(help="基金筛选命令")
+console = Console()
+
+
+class SortField(str, Enum):
+    """排序字段"""
+
+    return_1y = "return_1y"
+    return_3y = "return_3y"
+    sharpe = "sharpe"
+    max_drawdown = "max_drawdown"
+    scale = "scale"
+
+
+class SortOrder(str, Enum):
+    """排序方向"""
+
+    asc = "asc"
+    desc = "desc"
+
+
+def _render_fund_table(df) -> None:
+    """渲染基金列表表格"""
+    renderer = TableRenderer()
+    table = renderer.render_fund_list(df)
+    console.print(table)
+    console.print(f"\n[green]共找到 {len(df)} 只基金[/green]")
+
+
+@app.command("basic")
+def filter_basic(
+    fund_type: str | None = typer.Option(None, "--type", "-t", help="基金类型"),
+    company: str | None = typer.Option(None, "--company", "-c", help="基金公司"),
+    min_scale: float | None = typer.Option(None, "--min-scale", help="最小规模(亿)"),
+    max_scale: float | None = typer.Option(None, "--max-scale", help="最大规模(亿)"),
+    keyword: str | None = typer.Option(None, "--keyword", "-k", help="关键词搜索"),
+    limit: int = typer.Option(20, "--limit", "-l", help="返回数量"),
+    output: str | None = typer.Option(None, "--output", "-o", help="输出文件路径"),
+) -> None:
+    """
+    基础筛选 - 按基金类型、公司、规模等条件筛选基金。
+
+    示例:
+        fund filter basic --type 股票型 --min-scale 10
+        fund filter basic -c 华夏基金 -l 50
+        fund filter basic -k 成长
+    """
+    try:
+        dm = get_data_manager()
+
+        console.print("[bold blue]正在筛选基金...[/bold blue]")
+
+        df = dm.search_funds(
+            fund_type=fund_type,
+            company=company,
+            min_scale=min_scale,
+            max_scale=max_scale,
+            keyword=keyword,
+            limit=limit,
+        )
+
+        if df.empty:
+            console.print("[yellow]未找到符合条件的基金[/yellow]")
+            return
+
+        # 显示结果
+        renderer = TableRenderer()
+        table = renderer.render_fund_list(df)
+        console.print(table)
+
+        console.print(f"\n[green]共找到 {len(df)} 只基金[/green]")
+
+        # 导出
+        if output:
+            df.to_csv(output, index=False, encoding="utf-8-sig")
+            console.print(f"[green]已导出到: {output}[/green]")
+
+    except Exception as e:
+        console.print(f"[red]筛选失败: {e}[/red]")
+        raise typer.Exit(1) from None
+
+
+@app.command("fee")
+def filter_by_fee(
+    max_fee: float = typer.Argument(..., help="最大费率(%)"),
+    fund_type: str = typer.Option(None, help="基金类型"),
+    limit: int = typer.Option(20, help="返回数量"),
+):
+    """费率筛选 (FUND-FILTER-005)"""
+    from fund_cli.core.screener import FundScreener
+
+    screener = FundScreener()
+    try:
+        df = screener.screen_by_fee(max_fee, fund_type)
+        if df.empty:
+            console.print("[yellow]未找到符合条件的基金[/yellow]")
+            return
+        _render_fund_table(df.head(limit))
+    except Exception as e:
+        console.print(f"[red]筛选失败: {e}[/red]")
+        raise typer.Exit(1) from None
+
+
+@app.command("manager")
+def filter_by_manager(
+    manager_name: str = typer.Argument(..., help="基金经理名称"),
+    limit: int = typer.Option(20, help="返回数量"),
+):
+    """经理筛选 (FUND-FILTER-006)"""
+    from fund_cli.core.screener import FundScreener
+
+    screener = FundScreener()
+    try:
+        df = screener.screen_by_manager(manager_name)
+        if df.empty:
+            console.print(f"[yellow]未找到经理 {manager_name} 管理的基金[/yellow]")
+            return
+        _render_fund_table(df.head(limit))
+    except Exception as e:
+        console.print(f"[red]筛选失败: {e}[/red]")
+        raise typer.Exit(1) from None
+
+
+@app.command("rating")
+def filter_by_rating(
+    min_rating: int = typer.Argument(..., help="最低评级(1-5)"),
+    limit: int = typer.Option(20, help="返回数量"),
+):
+    """评级筛选 (FUND-FILTER-007)"""
+    from fund_cli.core.screener import FundScreener
+
+    screener = FundScreener()
+    try:
+        df = screener.screen_by_rating(min_rating)
+        if df.empty:
+            console.print(f"[yellow]未找到评级>={min_rating}的基金[/yellow]")
+            return
+        _render_fund_table(df.head(limit))
+    except Exception as e:
+        console.print(f"[red]筛选失败: {e}[/red]")
+        raise typer.Exit(1) from None
+
+
+@app.command("advanced")
+def filter_advanced(
+    expression: str = typer.Argument(..., help="筛选表达式"),
+    limit: int = typer.Option(20, help="返回数量"),
+):
+    """高级表达式筛选 (FUND-FILTER-012)"""
+    from fund_cli.core.screener import FundScreener
+
+    screener = FundScreener()
+    try:
+        all_funds = screener._dm.search_funds(limit=1000)
+        if all_funds.empty:
+            console.print("[yellow]无基金数据[/yellow]")
+            return
+        result = screener.evaluate_expression(all_funds, expression)
+        if result.empty:
+            console.print("[yellow]无匹配结果[/yellow]")
+            return
+        _render_fund_table(result.head(limit))
+    except ValueError as e:
+        console.print(f"[red]{e}[/red]")
+        raise typer.Exit(1) from None
+    except Exception as e:
+        console.print(f"[red]筛选失败: {e}[/red]")
+        raise typer.Exit(1) from None
+
+
+@app.command("template")
+def filter_template(
+    action: str = typer.Argument(..., help="操作: save/load/list/delete"),
+    name: str = typer.Option(None, help="模板名称"),
+):
+    """筛选模板管理 (FUND-FILTER-011)"""
+    from fund_cli.core.screener import FundScreener
+
+    screener = FundScreener()
+    if action == "list":
+        templates = screener.list_templates()
+        if not templates:
+            console.print("[yellow]暂无保存的模板[/yellow]")
+            return
+        for t in templates:
+            console.print(f"  - {t}")
+    elif action == "save":
+        if not name:
+            console.print("[red]请指定模板名称[/red]")
+            raise typer.Exit(1) from None
+        from fund_cli.data.models import FundFilter
+
+        screener.save_template(name, FundFilter())
+        console.print(f"[green]模板 {name} 已保存[/green]")
+    elif action == "load":
+        if not name:
+            console.print("[red]请指定模板名称[/red]")
+            raise typer.Exit(1) from None
+        try:
+            template = screener.load_template(name)
+            console.print(f"模板 {name}: {template.model_dump_json(indent=2)}")
+        except FileNotFoundError:
+            console.print(f"[red]模板 {name} 不存在[/red]")
+            raise typer.Exit(1) from None
+    elif action == "delete":
+        if not name:
+            console.print("[red]请指定模板名称[/red]")
+            raise typer.Exit(1) from None
+        if screener.delete_template(name):
+            console.print(f"[green]模板 {name} 已删除[/green]")
+        else:
+            console.print(f"[yellow]模板 {name} 不存在[/yellow]")
+    else:
+        console.print(f"[red]未知操作: {action}，支持: save/load/list/delete[/red]")
+        raise typer.Exit(1) from None
+
+
+@app.command("performance")
+def filter_performance(
+    min_return: float = typer.Option(None, help="最低年化收益率(%)"),
+    max_drawdown: float = typer.Option(None, help="最大回撤(%)"),
+    min_sharpe: float = typer.Option(None, help="最低夏普比率"),
+    limit: int = typer.Option(20, help="返回数量"),
+):
+    """业绩指标筛选"""
+    from fund_cli.core.screener import FundScreener
+    from fund_cli.data.models import FundFilter
+
+    screener = FundScreener()
+    f = FundFilter(
+        min_return_1y=min_return, max_drawdown=max_drawdown, min_sharpe=min_sharpe, limit=limit
+    )
+    try:
+        df = screener.screen(f)
+        if df.empty:
+            console.print("[yellow]未找到符合条件的基金[/yellow]")
+            return
+        _render_fund_table(df)
+    except Exception as e:
+        console.print(f"[red]筛选失败: {e}[/red]")
+        raise typer.Exit(1) from None
+
+
+@app.command("export")
+def export_results(
+    output: str = typer.Argument(..., help="输出文件路径"),
+    format: str = typer.Option("csv", help="输出格式: csv/json"),
+):
+    """导出筛选结果"""
+    from fund_cli.core.screener import FundScreener
+
+    screener = FundScreener()
+    try:
+        df = screener._dm.search_funds(limit=1000)
+        if df.empty:
+            console.print("[yellow]无数据可导出[/yellow]")
+            return
+        if format == "csv":
+            df.to_csv(output, index=False, encoding="utf-8-sig")
+        elif format == "json":
+            df.to_json(output, orient="records", force_ascii=False, indent=2)
+        else:
+            console.print(f"[red]不支持的格式: {format}[/red]")
+            raise typer.Exit(1) from None
+        console.print(f"[green]已导出 {len(df)} 条记录到 {output}[/green]")
+    except Exception as e:
+        console.print(f"[red]导出失败: {e}[/red]")
+        raise typer.Exit(1) from None
+
+
+if __name__ == "__main__":
+    app()

fund_cli/commands/holding_cmd.py

@@ -0,0 +1,140 @@
+"""
+持仓分析命令
+
+提供基金持仓查询、行业配置、集中度、变化追踪和风格分析功能。
+"""
+
+import pandas as pd
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from fund_cli.analysis.holding import HoldingAnalyzer
+from fund_cli.core.data_manager import DataManager
+from fund_cli.utils.validators import validate_fund_code
+
+app = typer.Typer(help="持仓分析命令")
+console = Console()
+
+
+@app.command("query")
+def query_holdings(
+    fund_code: str = typer.Argument(..., help="基金代码"),
+    top_n: int = typer.Option(10, help="显示前N大持仓"),
+):
+    """查询基金持仓 (FUND-HOLDING-001)"""
+    validate_fund_code(fund_code)
+    dm = DataManager()
+    try:
+        holdings = dm.get_fund_holdings(fund_code)
+        analyzer = HoldingAnalyzer()
+        top = analyzer.top_holdings(holdings, top_n=top_n)
+        console.print(f"\n[bold]{fund_code}[/bold] 前十大持仓：")
+        table = Table(show_header=True, header_style="bold blue")
+        table.add_column("股票代码", style="cyan")
+        table.add_column("股票名称")
+        table.add_column("占净值比", justify="right")
+        table.add_column("持仓市值(万)", justify="right")
+        for _, row in top.iterrows():
+            table.add_row(
+                str(row.get("stock_code", "")),
+                str(row.get("stock_name", "")),
+                f"{row.get('weight', 0):.2f}%",
+                f"{row.get('market_value', 0):,.0f}" if pd.notna(row.get("market_value")) else "-",
+            )
+        console.print(table)
+    except Exception as e:
+        console.print(f"[red]获取持仓数据失败: {e}[/red]")
+        raise typer.Exit(1) from None
+
+
+@app.command("industry")
+def industry_analysis(fund_code: str = typer.Argument(..., help="基金代码")):
+    """行业配置分析 (FUND-HOLDING-002)"""
+    validate_fund_code(fund_code)
+    dm = DataManager()
+    try:
+        holdings = dm.get_fund_holdings(fund_code)
+        analyzer = HoldingAnalyzer()
+        distribution = analyzer.industry_distribution(holdings)
+        console.print(f"\n[bold]{fund_code}[/bold] 行业配置：")
+        table = Table(show_header=True, header_style="bold blue")
+        table.add_column("行业", style="cyan")
+        table.add_column("占比", justify="right")
+        for industry, weight in distribution.items():
+            table.add_row(str(industry), f"{weight:.2f}%")
+        console.print(table)
+    except Exception as e:
+        console.print(f"[red]行业分析失败: {e}[/red]")
+        raise typer.Exit(1) from None
+
+
+@app.command("concentration")
+def concentration_analysis(fund_code: str = typer.Argument(..., help="基金代码")):
+    """持仓集中度分析 (FUND-HOLDING-004)"""
+    validate_fund_code(fund_code)
+    dm = DataManager()
+    try:
+        holdings = dm.get_fund_holdings(fund_code)
+        analyzer = HoldingAnalyzer()
+        hhi = analyzer.concentration_hhi(holdings)
+        level = analyzer._hhi_level(hhi)
+        console.print(f"\n[bold]{fund_code}[/bold] 持仓集中度：")
+        console.print(f"  HHI指数: {hhi:.4f}")
+        console.print(f"  集中度等级: [bold]{level}[/bold]")
+    except Exception as e:
+        console.print(f"[red]集中度分析失败: {e}[/red]")
+        raise typer.Exit(1) from None
+
+
+@app.command("changes")
+def holding_changes(
+    fund_code: str = typer.Argument(..., help="基金代码"),
+    period: str = typer.Option("latest", help="对比周期: latest/quarter"),
+):
+    """持仓变化追踪 (FUND-HOLDING-005)"""
+    validate_fund_code(fund_code)
+    dm = DataManager()
+    try:
+        current = dm.get_fund_holdings(fund_code)
+        if current.empty:
+            console.print("[yellow]暂无持仓数据[/yellow]")
+            return
+        analyzer = HoldingAnalyzer()
+        console.print(f"\n[bold]{fund_code}[/bold] 最新持仓（前10）：")
+        top = analyzer.top_holdings(current, top_n=10)
+        table = Table(show_header=True, header_style="bold blue")
+        table.add_column("股票代码", style="cyan")
+        table.add_column("股票名称")
+        table.add_column("占净值比", justify="right")
+        for _, row in top.iterrows():
+            table.add_row(
+                str(row.get("stock_code", "")),
+                str(row.get("stock_name", "")),
+                f"{row.get('weight', 0):.2f}%",
+            )
+        console.print(table)
+        console.print("[yellow]提示: 历史持仓对比需要多期数据支持[/yellow]")
+    except Exception as e:
+        console.print(f"[red]持仓变化分析失败: {e}[/red]")
+        raise typer.Exit(1) from None
+
+
+@app.command("style")
+def style_analysis_cmd(fund_code: str = typer.Argument(..., help="基金代码")):
+    """风格分析 (FUND-HOLDING-006)"""
+    validate_fund_code(fund_code)
+    dm = DataManager()
+    try:
+        holdings = dm.get_fund_holdings(fund_code)
+        analyzer = HoldingAnalyzer()
+        result = analyzer.style_analysis(holdings)
+        console.print(f"\n[bold]{fund_code}[/bold] 风格分析：")
+        console.print(f"  市值风格: [bold]{result['market_cap_style']}[/bold]")
+        console.print(f"  投资风格: [bold]{result['investment_style']}[/bold]")
+        console.print(f"  九宫格位置: [bold]{result['grid_position']}[/bold]")
+        console.print(f"  大盘股权重: {result['large_cap_weight']:.1f}%")
+        console.print(f"  价值股权重: {result['value_weight']:.1f}%")
+    except Exception as e:
+        console.print(f"[red]风格分析失败: {e}[/red]")
+        raise typer.Exit(1) from None