用途
港股外资流向分析器用于分析外资通过港股通、QFII、直接投资等方式投资港股的资金流向和投资偏好，帮助使用者把握国际资金动向和投资机会。
主要能力
外资流向监控：统计外资总流入/流出，涵盖港股通外资流向、QFII 资金动向以及直接投资资金流向。
机构偏好分析：包括外资机构持仓分析、行业偏好变化、个股偏好排名与投资风格分析。
资金来源分析：按地区来源、机构类型、投资策略进行分类，并进行资金稳定性评估。
投资行为分析：分析买卖行为模式、持仓变化趋势、调仓时机与投资周期。
指标与模式分析：提供流向指标（净流入、流入强度、流入持续性、流入动量）、偏好指标（行业偏好度、个股偏好度、风格偏好、风险偏好）、行为指标（持仓集中度、换手率、持仓周期、调仓幅度），以及趋势分析与模式识别（季节模式、事件模式、周期模式、政策模式）。
使用方式
工具通过命令行脚本调用，例如：
# 获取外资流向
python scripts/foreign_flow.py --flow
# 获取机构偏好
python scripts/foreign_flow.py --preference
# 获取资金来源
python scripts/foreign_flow.py --source
# 获取投资行为
python scripts/foreign_flow.py --behavior
高级分析示例：
python scripts/foreign_flow.py --history 30
python scripts/foreign_flow.py --preference-change
python scripts/foreign_flow.py --source-analysis
python scripts/foreign_flow.py --behavior-pattern
配置选项支持按地区、机构类型、投资策略、时间周期分析，以及简洁模式、详细模式与排序选项，如：
python scripts/foreign_flow.py --by-region
python scripts/foreign_flow.py --by-institution
python scripts/foreign_flow.py --by-strategy
python scripts/foreign_flow.py --by-period
python scripts/foreign_flow.py --simple
python scripts/foreign_flow.py --detailed
python scripts/foreign_flow.py --sort by_amount
输出支持表格格式（含股票代码、股票名称、外资流入、持仓变化、偏好评级等列）与 JSON 格式（含日期、外资流向、机构偏好、来源分布等字段）。
适用场景
投资决策：跟踪外资动向、识别外资偏好、把握资金面变化、制定跟投策略。
风险管理：监控外资流出风险、识别流动性风险、评估市场情绪、控制仓位风险。
研究分析：外资行为研究、资金流向与收益关系、国际资本流动研究、市场开放度分析。
数据源与更新频率
主要数据源包括港交所（港股通外资数据）、证监会（QFII 持仓数据）、各大券商（外资研究报告）与数据供应商（外资流向数据）。
更新频率：实时数据在交易时间内实时更新，日度数据每日收盘后更新，持仓数据季度更新，历史数据提供 10 年以上。
限制与注意事项
数据延迟：外资数据有 T+1 延迟。 披露频率：QFII 数据披露频率较低。 估算数据：部分数据为估算值。 汇率影响：需考虑汇率波动影响。 政策影响：需关注政策变化影响。
版本
v1.0.0（2026-02-15）：初始版本发布，支持外资流向监控、机构偏好分析、资金来源分析与投资行为分析。