核心功能
VNStock Free Expert 是一个面向越南股票市场的端到端量化分析工作流，专为 vnstock 库的免费额度场景设计。它提供从股票池构建、市场数据与财务数据收集、多因子评分排序，到最终生成分析师风格投资备忘录的完整链路。
显著优势
1. 免费额度友好：内置严格的速率控制（无 API Key 时 ≤20 请求/分钟，免费 Key 时 ≤60 请求/分钟），默认 3.2 秒/请求的安全间隔
2. 数据治理完善：强制要求报告置信度等级（High/Medium/Low），输出覆盖率统计与关键缺失字段披露
3. 模块化设计：支持分步执行（build_universe → collect_market_data → collect_fundamentals → score_stocks → generate_report）或一键运行完整流程
4. 下游兼容：单票深度分析时输出标准化 JSON bundle，可直接对接 equity-valuation-framework 和 portfolio-risk-manager
5. 弹性容错：符号级失败日志记录，不将缺失指标归零，关键步骤失败时中断并报告
潜在局限
- 数据源限制：优先 KBS、备选 VCI，明确禁用 TCBS；Screener API 默认可用性取决于用户本地版本
- 免费额度天花板：大规模全市场扫描仍受速率限制，需依赖缓存分块策略
- 依赖外部库：要求 Python 3.x、vnstock、pandas 及网络环境
- 置信度门槛严格：High 置信度需 ≥95% 股票覆盖、≥80% 关键指标覆盖、硬错误 ≤5%，实践中较难达成
适用人群
- 越南股票市场个人投资者与量化研究员
- 需在免费额度下进行批量股票筛选与初步估值的用户
- 希望将 vnstock 数据接入下游估值/风控框架的开发者
常规风险
- 数据时效性：免费源可能存在延迟，需关注
as_of_date与stale data风险披露 - 供应商依赖：KBS/VCI 接口变更可能导致脚本失效
- 排名结论稳健性：Low 置信度场景下仅提供方向性结论，需人工复核缺失输入
- API Key 管理：本地
.env文件存储需用户自行保障安全