fund-cli 3.1.0__tar.gz → 3.2.0__tar.gz

{fund_cli-3.1.0 → fund_cli-3.2.0}/CHANGELOG.md

@@ -5,6 +5,45 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
 并且本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [3.2.0] - 2026-05-10
+
+### Added - 数据质量风险治理体系（核心特性）
+- 五层数据质量治理架构
+  - Layer 1 数据采集层质量门禁: DataManager路由改用Gateway，激活熔断器/重试/降级
+  - Layer 2 数据标准化管道: Normalizer集成Pydantic模型验证、重复检测、净值范围校验
+  - Layer 3 数据质量检查引擎: Expectation风格8项自动化检查（非空/数据量/列完整/净值非空/净值范围/收益率范围/日期唯一/时效性）
+  - Layer 4 计算验证层: 12项指标合理性边界验证、交叉验证（PerformanceAnalyzer vs RiskAnalyzer）
+  - Layer 5 输出合规层: 报告完整性验证、免责声明检查、质量徽章
+- 质量门禁 (QualityGate): 分析入口强制执行数据质量检查，不达标拦截
+- 计算结果验证器 (CalcValidator): Sharpe/回撤/波动率/Beta/VaR等12项指标合理性检查
+- 交叉验证器 (CrossValidator): 多引擎计算结果交叉比对
+- AI输出验证器 (AIOutputValidator): AI生成文本与源数据一致性校验、矛盾表述检测
+- 报告验证器 (ReportValidator): 必需字段检查、模板数据完整性、免责声明检查
+- 审计日志 (AuditLogger): 质量检查/分析操作/报告生成日志，支持合规审计和查询
+- 合规风控报告生成器 (RiskControlReporter): 风险概览/集中度分析/合规检查数据填充
+- 质量配置 (QualityConfig): 质量门禁阈值、异常检测参数、审计日志配置
+- Monitor扩展: 支持回撤/波动率/夏普比率监控规则
+- 71个新增单元测试（覆盖全部6个新模块）
+- 总测试数: 2001 passed
+
+### Changed
+- DataManager: 关键方法(get_fund_info/nav/holdings/manager/benchmark)路由改用Gateway+Normalizer
+- DataSourceGateway: 激活请求级内存缓存(5min TTL)，修复hash碰撞(MD5)，print→logging
+- DataCache: 版本控制(CACHE_VERSION)、1GB容量限制、增强统计信息
+- Normalizer: Pydantic模型验证集成、重复行检测、净值范围校验(0<nav<=10000)
+- validators.py: 新增validate_nav_value/validate_daily_return/validate_data_min_rows/validate_date_strict
+- decorators.py: retry增加指数退避+抖动，新增validate_input装饰器
+- report_cmd.py: 修复空数据问题，集成ReportValidator，实现真实数据获取和分析
+- analyze_cmd.py: 集成质量门禁+交叉验证+计算验证，显示质量评分
+
+### Fixed
+- DataManager第107行日志变量bug（主数据源切换日志显示错误）
+- report_cmd.py传入空metrics={}的严重问题
+- 风控报告模板(risk_control)无后端数据填充
+- DataQualityChecker孤岛模块（从未被自动调用）
+- Pydantic模型与数据流脱节（11个模型零调用）
+- validators.py/decorators.py死代码（7个工具零调用）
+
 ## [3.1.0] - 2026-05-09
 
 ### Added

{fund_cli-3.1.0 → fund_cli-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fund-cli
-Version: 3.1.0
+Version: 3.2.0
 Summary: 专业基金分析CLI工具 - 面向机构客户
 Project-URL: Homepage, https://github.com/jarrey-0804/fund-cli
 Project-URL: Documentation, https://fund-cli.readthedocs.io
@@ -72,7 +72,7 @@ Description-Content-Type: text/markdown
 
 **专业基金分析CLI工具 - 面向机构客户**
 
-[![Version](https://img.shields.io/badge/version-3.1.0-blue.svg)](https://github.com/jarrey-0804/fund-cli)
+[![Version](https://img.shields.io/badge/version-3.2.0-blue.svg)](https://github.com/jarrey-0804/fund-cli)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
@@ -85,6 +85,23 @@ Description-Content-Type: text/markdown
 
 Fund CLI 是一款面向机构客户的专业基金分析命令行工具，提供基金筛选、业绩分析、组合对比、风险监控等功能。基于开源技术栈构建，支持多数据源接入和AI辅助分析。
 
+## v3.2 新特性
+
+### 五层数据质量治理架构
+- **Layer 1 数据采集层**: Gateway路由 + 熔断器/重试/降级机制
+- **Layer 2 数据标准化管道**: Pydantic模型验证 + 重复检测 + 净值范围校验
+- **Layer 3 质量检查引擎**: 8项Expectation风格自动化检查
+- **Layer 4 计算验证层**: 12项指标合理性边界验证 + 交叉验证
+- **Layer 5 输出合规层**: 报告完整性验证 + 免责声明检查
+
+### 新增质量模块
+- **QualityGate**: 分析入口强制执行数据质量检查
+- **CalcValidator**: Sharpe/回撤/波动率等12项指标合理性验证
+- **CrossValidator**: PerformanceAnalyzer与RiskAnalyzer交叉验证
+- **AIOutputValidator**: AI生成内容与源数据一致性校验
+- **ReportValidator**: 报告必需字段和合规性检查
+- **AuditLogger**: 质量检查/分析操作/报告生成审计日志
+
 ## v3.1 新特性
 
 ### 多数据源架构
@@ -125,6 +142,7 @@ Fund CLI 是一款面向机构客户的专业基金分析命令行工具，提
 - **多数据源架构** (v3.1) - Tushare/AKShare/Wind 统一接入，熔断降级机制
 - **报告引擎** (v3.1) - HTML/Markdown/PDF/Word/PPT 5种格式报告
 - **AI增强** (v3.1) - 规则引擎 + OpenAI 双后端智能分析
+- **数据质量治理** (v3.2) - 五层质量架构 + 审计日志 + 合规验证
 
 ---
 

{fund_cli-3.1.0 → fund_cli-3.2.0}/README.md

@@ -4,7 +4,7 @@
 
 **专业基金分析CLI工具 - 面向机构客户**
 
-[![Version](https://img.shields.io/badge/version-3.1.0-blue.svg)](https://github.com/jarrey-0804/fund-cli)
+[![Version](https://img.shields.io/badge/version-3.2.0-blue.svg)](https://github.com/jarrey-0804/fund-cli)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
@@ -17,6 +17,23 @@
 
 Fund CLI 是一款面向机构客户的专业基金分析命令行工具，提供基金筛选、业绩分析、组合对比、风险监控等功能。基于开源技术栈构建，支持多数据源接入和AI辅助分析。
 
+## v3.2 新特性
+
+### 五层数据质量治理架构
+- **Layer 1 数据采集层**: Gateway路由 + 熔断器/重试/降级机制
+- **Layer 2 数据标准化管道**: Pydantic模型验证 + 重复检测 + 净值范围校验
+- **Layer 3 质量检查引擎**: 8项Expectation风格自动化检查
+- **Layer 4 计算验证层**: 12项指标合理性边界验证 + 交叉验证
+- **Layer 5 输出合规层**: 报告完整性验证 + 免责声明检查
+
+### 新增质量模块
+- **QualityGate**: 分析入口强制执行数据质量检查
+- **CalcValidator**: Sharpe/回撤/波动率等12项指标合理性验证
+- **CrossValidator**: PerformanceAnalyzer与RiskAnalyzer交叉验证
+- **AIOutputValidator**: AI生成内容与源数据一致性校验
+- **ReportValidator**: 报告必需字段和合规性检查
+- **AuditLogger**: 质量检查/分析操作/报告生成审计日志
+
 ## v3.1 新特性
 
 ### 多数据源架构
@@ -57,6 +74,7 @@ Fund CLI 是一款面向机构客户的专业基金分析命令行工具，提
 - **多数据源架构** (v3.1) - Tushare/AKShare/Wind 统一接入，熔断降级机制
 - **报告引擎** (v3.1) - HTML/Markdown/PDF/Word/PPT 5种格式报告
 - **AI增强** (v3.1) - 规则引擎 + OpenAI 双后端智能分析
+- **数据质量治理** (v3.2) - 五层质量架构 + 审计日志 + 合规验证
 
 ---
 

{fund_cli-3.1.0 → fund_cli-3.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fund-cli"
-version = "3.1.0"
+version = "3.2.0"
 description = "专业基金分析CLI工具 - 面向机构客户"
 readme = "README.md"
 license = {text = "MIT"}

{fund_cli-3.1.0 → fund_cli-3.2.0}/src/fund_cli/__init__.py

@@ -12,7 +12,7 @@ warnings.filterwarnings(
     message=r".*allowed_objects.*will change.*",
 )
 
-__version__ = "3.1.0"
+__version__ = "3.2.0"
 __author__ = "Fund CLI Team"
 __license__ = "MIT"
 

{fund_cli-3.1.0 → fund_cli-3.2.0}/src/fund_cli/ai/agent.py

@@ -91,9 +91,7 @@ class FundAgent:
                     from langgraph.checkpoint.postgres.aio import AsyncPostgresSaver
 
                     logger.info("使用 PostgreSQL 持久化存储")
-                    return AsyncPostgresSaver.from_conn_string(
-                        config.database.connection_string
-                    )
+                    return AsyncPostgresSaver.from_conn_string(config.database.connection_string)
                 except ImportError:
                     logger.warning("langgraph-checkpoint-postgres 未安装，回退到 MemorySaver")
                     return MemorySaver()
@@ -121,7 +119,8 @@ class FundAgent:
                 temperature=config.temperature,
                 max_tokens=config.max_tokens,
                 api_key=config.qwen_api_key or config.api_key,
-                base_url=config.qwen_base_url or "https://dashscope.aliyuncs.com/compatible-mode/v1",
+                base_url=config.qwen_base_url
+                or "https://dashscope.aliyuncs.com/compatible-mode/v1",
             )
         else:
             # 默认使用 OpenAI
@@ -153,26 +152,12 @@ class FundAgent:
         if self.enable_human_review:
             # 启用人工审核时，增加 human_review 分支
             workflow.add_node("human_review", create_human_input_node())
-            workflow.add_conditional_edges(
-                "llm",
-                router_node,
-                {
-                    "tools": "tools",
-                    "end": "summary"
-                }
-            )
+            workflow.add_conditional_edges("llm", router_node, {"tools": "tools", "end": "summary"})
             workflow.add_edge("tools", "llm")
             workflow.add_edge("summary", "human_review")
             workflow.add_edge("human_review", END)
         else:
-            workflow.add_conditional_edges(
-                "llm",
-                router_node,
-                {
-                    "tools": "tools",
-                    "end": "summary"
-                }
-            )
+            workflow.add_conditional_edges("llm", router_node, {"tools": "tools", "end": "summary"})
             workflow.add_edge("tools", "llm")
             workflow.add_edge("summary", END)
 
@@ -182,10 +167,7 @@ class FundAgent:
         return workflow
 
     async def ainvoke(
-        self,
-        user_input: str,
-        user_id: str = "default",
-        thread_id: str | None = None
+        self, user_input: str, user_id: str = "default", thread_id: str | None = None
     ) -> str:
         """
         异步调用 Agent
@@ -201,12 +183,7 @@ class FundAgent:
         if thread_id is None:
             thread_id = str(uuid.uuid4())
 
-        config = {
-            "configurable": {
-                "user_id": user_id,
-                "thread_id": thread_id
-            }
-        }
+        config = {"configurable": {"user_id": user_id, "thread_id": thread_id}}
 
         # 准备初始状态
         initial_state: FundAgentState = {
@@ -219,7 +196,7 @@ class FundAgent:
             "needs_human_review": False,
             "human_feedback": None,
             "final_response": None,
-            "error": None
+            "error": None,
         }
 
         try:
@@ -234,7 +211,7 @@ class FundAgent:
             messages = result.get("messages", [])
             if messages:
                 last_message = messages[-1]
-                if hasattr(last_message, 'content'):
+                if hasattr(last_message, "content"):
                     return last_message.content
 
             return "抱歉，我无法处理您的请求。"
@@ -243,10 +220,7 @@ class FundAgent:
             return f"执行过程中出现错误: {str(e)}"
 
     def invoke(
-        self,
-        user_input: str,
-        user_id: str = "default",
-        thread_id: str | None = None
+        self, user_input: str, user_id: str = "default", thread_id: str | None = None
     ) -> str:
         """
         同步调用 Agent
@@ -267,9 +241,7 @@ class FundAgent:
             loop = asyncio.new_event_loop()
             asyncio.set_event_loop(loop)
 
-        return loop.run_until_complete(
-            self.ainvoke(user_input, user_id, thread_id)
-        )
+        return loop.run_until_complete(self.ainvoke(user_input, user_id, thread_id))
 
     def get_history(self, user_id: str, thread_id: str) -> list:
         """
@@ -282,12 +254,7 @@ class FundAgent:
         Returns:
             对话历史列表
         """
-        config = {
-            "configurable": {
-                "user_id": user_id,
-                "thread_id": thread_id
-            }
-        }
+        config = {"configurable": {"user_id": user_id, "thread_id": thread_id}}
 
         try:
             history = list(self.app.get_state_history(config))
@@ -316,9 +283,7 @@ _fund_agent: FundAgent | None = None
 
 
 def get_fund_agent(
-    llm: BaseChatModel | None = None,
-    checkpointer=None,
-    force_new: bool = False
+    llm: BaseChatModel | None = None, checkpointer=None, force_new: bool = False
 ) -> FundAgent:
     """
     获取 Fund Agent 实例（单例）

{fund_cli-3.1.0 → fund_cli-3.2.0}/src/fund_cli/ai/analyzer.py

@@ -79,12 +79,12 @@ class AIAnalyzer:
 
             fund_text = f"""
 基金 {i + 1}: {code}
-- 名称: {info.get('name', '未知')}
-- 类型: {info.get('type', '未知')}
-- 年化收益: {metrics.get('cagr', 0)}%
-- 夏普比率: {metrics.get('sharpe_ratio', 0)}
-- 最大回撤: {metrics.get('max_drawdown', 0)}%
-- 波动率: {metrics.get('volatility', 0)}%
+- 名称: {info.get("name", "未知")}
+- 类型: {info.get("type", "未知")}
+- 年化收益: {metrics.get("cagr", 0)}%
+- 夏普比率: {metrics.get("sharpe_ratio", 0)}
+- 最大回撤: {metrics.get("max_drawdown", 0)}%
+- 波动率: {metrics.get("volatility", 0)}%
 """
             funds_text.append(fund_text)
 

{fund_cli-3.1.0 → fund_cli-3.2.0}/src/fund_cli/ai/memory.py

@@ -33,9 +33,7 @@ from typing import Any
 try:
     import chromadb
 except ImportError as exc:
-    raise ImportError(
-        "chromadb 包未安装，请执行: pip install chromadb"
-    ) from exc
+    raise ImportError("chromadb 包未安装，请执行: pip install chromadb") from exc
 
 logger = logging.getLogger(__name__)
 

{fund_cli-3.1.0 → fund_cli-3.2.0}/src/fund_cli/ai/nodes.py

@@ -89,10 +89,7 @@ def create_llm_node(llm):
         # 调用 LLM
         response = llm_with_tools.invoke(messages, config)
 
-        return {
-            "messages": [response],
-            "current_step": "llm_response"
-        }
+        return {"messages": [response], "current_step": "llm_response"}
 
     return llm_node
 
@@ -128,7 +125,11 @@ def router_node(state: FundAgentState) -> Literal["tools", "end"]:
     last_message = messages[-1]
 
     # 检查是否有工具调用
-    if isinstance(last_message, AIMessage) and hasattr(last_message, 'tool_calls') and last_message.tool_calls:
+    if (
+        isinstance(last_message, AIMessage)
+        and hasattr(last_message, "tool_calls")
+        and last_message.tool_calls
+    ):
         return "tools"
 
     return "end"
@@ -146,10 +147,7 @@ def create_error_handler_node():
 
         if error:
             error_message = f"执行过程中出现错误: {error}"
-            return {
-                "messages": [AIMessage(content=error_message)],
-                "final_response": error_message
-            }
+            return {"messages": [AIMessage(content=error_message)], "final_response": error_message}
 
         return {}
 
@@ -169,10 +167,7 @@ def create_human_input_node():
         # 目前返回一个提示消息
         prompt = "请提供更多信息以继续分析..."
 
-        return {
-            "messages": [AIMessage(content=prompt)],
-            "current_step": "waiting_for_input"
-        }
+        return {"messages": [AIMessage(content=prompt)], "current_step": "waiting_for_input"}
 
     return human_input_node
 
@@ -190,10 +185,8 @@ def create_summary_node():
 
         # 提取 AI 的最后一条消息作为最终响应
         for msg in reversed(messages):
-            if isinstance(msg, AIMessage) and not getattr(msg, 'tool_calls', None):
-                return {
-                    "final_response": msg.content
-                }
+            if isinstance(msg, AIMessage) and not getattr(msg, "tool_calls", None):
+                return {"final_response": msg.content}
 
         return {"final_response": "分析完成。"}
 

{fund_cli-3.1.0 → fund_cli-3.2.0}/src/fund_cli/ai/providers.py

@@ -280,7 +280,7 @@ def get_provider(config: AIConfig | None = None) -> LLMProvider:
 
     if provider_class is None:
         raise ValueError(
-            f"不支持的提供商: {provider_name}. " f"支持的提供商: {', '.join(providers.keys())}"
+            f"不支持的提供商: {provider_name}. 支持的提供商: {', '.join(providers.keys())}"
         )
 
     return provider_class(config)  # type: ignore[abstract]