用途
aipa-fundamentals 是一个面向越南股票的基本面分析工作流技能，由 AIPriceAction 开发。它基于 aipa CLI 获取公司概况、财务比率以及排名/筛选数据，不依赖 LLM，也不需要 API 密钥。该技能适用于用户明确要求进行基本面分析（如“phân tích cơ bản”）的场景，围绕 11 个关键基本面问题构建结构化分析框架，帮助判断一只股票是否值得长期持有。
主要能力
该技能提供以下命令能力：
- info：获取公司概况，包括行业、市值、当前价格、流通股数、主要股东和高管信息。
- ratios：获取财务比率，支持按类别筛选，类别包括估值（PE、PB、PS、EV/EBITDA、Price/CashFlow、股息率、市值）、盈利（ROE、ROA、ROIC、毛利率、税后利润率、税前利润率、EBIT 利润率、NIM）、效率（资产周转率、固定资产周转率、现金周期、DSO、DIO、DPO）、杠杆（Debt/Equity、财务杠杆、权益/负债、权益/贷款、权益/总资产）、流动性（流动比率、速动比率、现金比率）和银行（NPL、LDR、CAR、CASA、CIR、非利息收入、存款/贷款增长、LLR 比率）。
- rank：按 50 多个字段对股票进行排名，支持升序或降序，可指定年份、期间、观察列表和数据源。
- screen：多条件筛选，支持 PE、PB、ROE、ROA、股息率、Debt/Equity、NPL、CAR、CIR、市值和行业等过滤条件。
- ticker-list：发现可用股票代码，可按数据源和分组筛选。
- watchlist：管理预定义和自定义观察列表，如 VN30、VINGROUP、MASAN、INDEX、CROSS 等。
- config：管理设置，包括 MA 类型（SMA/EMA）和输出语言（en/vn）。
该技能还内置了越南市场的核心板块分组（银行、房地产、证券、蓝筹/核心经济、企业生态圈），用于辅助分析。
使用方式
推荐使用 uvx 运行，无需安装：
uvx aipa-cli fundamentals info VCB
uvx aipa-cli fundamentals ratios VCB --latest
uvx aipa-cli fundamentals rank --sort-by roe
uvx aipa-cli fundamentals screen --watchlist VN30 --pe-max 20 --roe-min 0.10
如果 uv 不可用，可使用 pip 回退方案：
pip install aipa-cli
aipa fundamentals info VCB
如果 pip 因 PEP 668 失败，可使用系统 pip：
python3 -m pip install aipa-cli --break-system-packages
aipa fundamentals info VCB
如果 uv 和 pip 都未安装，先安装 uv：
curl -LsSf https://astral.sh/uv/install.sh | sh
使用前需验证版本，要求 aipa-cli >= 0.1.48：
uvx aipa-cli --version
该技能不需要环境变量，首次调用时会下载约 15-20 MB 的 vn.zip 并缓存到本地。
适用场景
- 对越南股票进行基本面分析，回答 11 个关键投资问题。
- 按行业分批并行分析多只股票，由 supervisor 分解请求并生成子代理。
- 对多只股票进行基本面比较，先使用 rank 和 screen 进行并排排名和筛选，再对入围股票进行深入分析。
- 按板块或观察列表进行排名和筛选。
- 发现可用股票代码和板块分组。
限制
- 基本面数据（info、ratios、rank、screen）目前仅适用于越南股票。对于非越南代码（加密货币、全球股票），资料中提及了“Non-VN Fallback”部分，但未提供具体细节。
- 数据源包括越南股票（vn）、加密货币（crypto）、全球/Yahoo（global/yahoo）和 SJC 黄金（sjc），但基本面数据仅限越南股票。
- 需要 aipa-cli >= 0.1.48。
- 使用前应运行
aipa config get use_sma检查当前 MA 类型设置，不应假设为 SMA。 - 输出模板使用 template.md，需替换所有 [giá trị] 占位符。
- 资料中未提供收费、价格或具体效果信息。