核心用法
VNStock Free Expert 是一个端到端的越南股市分析技能，基于 vnstock Python 库构建，专为免费用户 tier 设计。它通过模块化脚本实现从股票池构建、市场数据采集、基本面分析到评分排名的完整工作流。
执行流程：
1. 环境验证 — 检查 Python 3.x、vnstock、pandas 及可选的 API 密钥
2. 构建股票池 — 按指数(VN30/VN100)、交易所或自定义代码列表筛选
3. 采集市场数据 — OHLCV 价格及 3M/6M/12M 动量收益，默认 3.2 秒/请求限速
4. 采集基本面 — 财务指标与质量数据，优先使用 KBS 数据源，VCI 降级备选
5. 评分排名 — 多因子综合打分
6. 生成研报 — 输出分析师风格的 Markdown 投资备忘录
关键特性：
- 严格限速：无 API 键≤20 请求/分钟，免费键≤60 请求/分钟
- 置信度标准：强制输出 High/Medium/Low 评级，附带覆盖率统计与缺失字段披露
- 下游兼容：单票深度分析时输出标准化 JSON bundle，可直接对接估值与风控框架
- TCBS 禁用：明确禁止使用 TCBS 数据源，规避合规与稳定性风险
显著优点
- 免费层安全：内置请求节流、缓存复用、错误恢复机制，避免账号封禁
- 结构化输出：强制置信度披露、风险清单、数据质量说明，符合专业分析规范
- 模块化设计：支持流水线运行(run_pipeline.py)或单脚本调用，灵活适配不同场景
- 生态集成：与
equity-valuation-framework、portfolio-risk-manager等下游技能无缝衔接
潜在缺点与局限性
- 数据源依赖：KBS/VCI 服务中断时无其他合规备选(TCBS 被禁用)
- Screener API 不可用：除非用户确认本地版本已恢复，否则无法使用筛选器接口
- 越南市场局限：仅覆盖越南交易所，无法分析其他东南亚市场
- 速率瓶颈：免费层 3.2 秒/请求的保守 pacing 对大规模全市场扫描效率有限
- 无实时流数据：基于历史批次采集，非实时行情驱动
适合人群
- 越南股市个人投资者与量化爱好者
- 需要在免费额度内完成系统化股票筛选的分析师
- 希望生成标准化投研备忘录并对接下游估值工具的用户
- 对数据质量透明度有要求、能接受 Medium/Low 置信度场景的用户
常规风险
- 数据 stale 风险：API 延迟或采集失败导致基本面数据滞后
- 覆盖缺口：关键字段缺失可能翻转排名结论，需严格遵循置信度披露规则
- 提供商单点故障：KBS/VCI 任一服务异常将直接影响数据完整性
- 合规边界：超限速可能导致临时封禁，脚本虽内置保护但非绝对保险