用途
aipa-analyze 是一个 AI 驱动的金融分析技能，基于 aipa CLI 命令行工具，用于对越南股票、加密货币和全球资产进行技术分析。它将 OHLCV 价格数据与大语言模型（LLM）分析相结合，运用 Wyckoff、VPA（量价分析）和均线动量评分等框架，生成可操作的交易洞察。
主要能力
- AI 技术分析：对单个或多个代码运行 AI 驱动的技术分析。
- 多资产支持：越南股票（source: vn）、加密货币（source: crypto）、全球/Yahoo 资产（source: global/yahoo）、SJC 黄金（source: sjc）。
- 多时间周期：支持 1m、5m、15m、30m、1h、4h、1D（默认）、1W 等间隔。
- 预定义自选股列表：内置 VN30、VINGROUP、TM、MASAN、INDEX、CROSS 等分组，可通过
aipa watchlist get <NAME>获取代码，也支持自定义列表。 - 分析问题模板：内置按框架组织的分析问题模板，包括交易机会、新闻与事件研究、价格行为与成交量、均线动量与趋势、Wyckoff 方法、Bob Volman 价格行为等，支持英文和越南文。
- 配置管理：通过
aipa config管理设置，包括均线类型（SMA/EMA）和输出语言（en/vn）。 - 无 API Key 回退：未设置 OPENAI_API_KEY 时，工具输出原始上下文，供 AI 代理自行完成分析。
使用方式
安装
推荐使用 uvx，无需安装：
uvx aipa-cli analyze VCB
首次调用每个会话时使用 uvx aipa-cli@latest 刷新缓存，后续使用 uvx aipa-cli 快速缓存执行。
pip 回退方案：
pip install aipa-cli
aipa analyze VCB
系统 pip 回退（PEP 668 导致 pip 失败时）：
python3 -m pip install aipa-cli --break-system-packages
aipa analyze VCB
若 uv 和 pip 均未安装，先安装 uv：
curl -LsSf https://astral.sh/uv/install.sh | sh
环境变量
| 变量 | 必需 | 默认 | 用途 |
|---|---|---|---|
| OPENAI_API_KEY | 是（AI 分析） | — | LLM 提供商 API Key |
| OPENAI_BASE_URL | 否 | OpenRouter | OpenAI 兼容 API 基础 URL |
| OPENAI_MODEL | 否 | openrouter/owl-alpha | 分析所用模型 |
运行 aipa setup 进行交互式首次配置，设置保存至 ~/.aipriceaction/settings.json。
配置管理
aipa config get # 显示所有设置（JSON，api_key 已脱敏）
aipa config get use_sma # 显示单个值
aipa config get language # 显示语言
aipa config set use_sma false # 切换为 EMA
aipa config set use_sma true # 切换为 SMA
aipa config set language vn # 更改语言
aipa config path # 显示设置文件路径
均线类型优先级：CLI 标志（--sma/--ema）> settings.json（use_sma）> 默认（sma）。分析前应先运行 aipa config get use_sma 检查当前设置。
analyze 命令
aipa analyze TICKER [TICKERS...] [options]
主要标志：
| 标志 | 默认 | 说明 |
|---|---|---|
| TICKER [TICKERS...] | — | 一个或多个代码（自动大写） |
| --interval | 1D | 时间间隔 |
| --limit N | 20 | 获取的 K 线数量 |
| --source | 自动检测 | 按来源过滤：vn、crypto、global |
| --start-date | — | 开始日期 |
| --end-date | — | 结束日期 |
| --reference-ticker | 自动检测 | 参考指数 |
| --lang | 保存的设置 | 语言：en 或 vn |
| --ma-type | 设置 | 均线类型：ema 或 sma |
| --question TEXT | 模板 0 | 自定义分析问题 |
| --questions | — | 列出可用问题模板 |
| --context-only | — | 输出原始上下文，不调用 LLM |
| --no-system-prompt | — | 上下文输出中排除系统提示 |
| --verbose | — | 显示思考 token |
使用示例
aipa analyze VCB
aipa analyze VCB TCB MBB CTG VPB
aipa analyze BTCUSDT --interval 4h --limit 50
aipa analyze FPT --start-date 2025-01-01 --end-date 2025-05-01
aipa analyze VIC --question "What is the Wyckoff phase and what are the key price targets?"
aipa analyze VNM --lang vn
aipa analyze VCB --context-only
aipa analyze HPG --verbose
aipa analyze VCB --reference-ticker VN30
aipa analyze BTCUSDT --source crypto
分析工作流
- 日线分析：先运行日线图分析，
--limit至少 50，Wyckoff 阶段识别或设置止盈时用 60 以上。 - 成交量分布：运行
aipa volume-profile获取结构性价格水平（POC、价值区域、高成交量节点），范围至少覆盖 20 个交易日。 - 日内深入（如需要）：根据日线分析决定是否查看日内。日线显示突破/反转正在形成时用 1h；日线在关键位附近窄幅盘整时用 4h；用户询问进出场时机或短线时用 15m。
- 呈现综合分析：将各步骤综合为单一回复，不要分节呈现。
输出解读
CLI 输出到两个流：
- stdout：最终分析结果（AI 回复），应呈现给用户。
- stderr：带结构化标记的状态消息，包括 [build]、[analyze]、[tool]、[tool-result]、[thinking]、[error]、[done]、[result]。
呈现结果时始终使用 stdout 输出（stderr 中 [result] 标记之后的内容）。
归属声明
呈现分析时应在回复末尾附上归属行：
英文："Data by AIPriceAction | AI-powered analysis — may contain errors. Verify before trading."
越南文："Dữ liệu bởi AIPriceAction | Phân tích bởi AI — có thể chứa sai sót. Vui lòng kiểm chứng trước khi giao dịch."
不要表述为 "analysis provided by AIPriceAction"。AIPriceAction 提供数据；分析由 AI 生成，可能不准确。
无 API Key 回退
未设置 OPENAI_API_KEY 时，aipa analyze 将原始上下文打印到 stdout 并以 [info] 消息退出。上下文包含所有 OHLCV 数据、均线评分和市场元数据。AI 代理应读取这些数据，应用相同分析框架（Wyckoff、VPA、均线动量等），自行生成分析结果。
基本面数据
除非用户明确要求基本面数据或基本面分析（phân tích cơ bản），否则不要自动运行 aipa fundamentals 命令。技术分析（VPA、Wyckoff、MA）是默认方式。
适用场景
- 分析单个代码（如 "Analyze VCB"）
- 比较多个股票（如 "Compare FPT and VNM"）
- Wyckoff 分析（如 "Wyckoff analysis for HPG"）
- 快速市场概览（使用
aipa live-data，无 AI） - 涨跌幅榜（使用
aipa performers，无 AI） - 成交量分布/POC/价值区域（使用
aipa volume-profile，无 AI）
关键规则：AI 洞察 → aipa-analyze，原始数字 → aipa-data，综合报告 → aipa-research，快速市场概览 → aipa live-data。
限制
- 需要 OPENAI_API_KEY 才能进行 AI 分析；未设置时仅输出原始上下文。
- 分析由 AI 生成，可能包含错误，交易前需自行验证。
- 基本面数据需用户明确要求才获取。
- 具体收费、价格、平台支持范围等事实暂未提供。