用途:生成 Interactive Brokers 组合行动报告,分析所有账户持仓,获取财报日期,并为每个仓位给出红/黄/绿风险指示。适用于用户要求组合复盘、行动项、财报风险检查时。
主要能力:输出包含风险等级、财报日期、技术指标和价差分组的 JSON;报告含关键摘要、需立即处理(2 天内到期)、1 周内到期、本周财报预警、下周财报、2 周内到期、长期持仓分析、优先行动项、仓位规模摘要、财报日历与技术分析摘要(RSI、趋势、SMA、MACD、ADX)。
使用方式:本地需运行 TWS 或 IB Gateway 并启用 API。模拟盘端口 7497,实盘端口 7496。可设 IB_PORT 环境变量作为默认端口,优先级为 --port > IB_PORT > 内置默认;端口失败会自动回退,若成功则记住账户类型复用。
命令:uv run python scripts/report.py [--port PORT] [--account ACCOUNT]。若未装 uv 或找不到 pyproject.toml,将 uv run python 替换为 python。参数:--port 默认 7497;--account 可选,默认全账户。报告依 templates/markdown-template.md 生成,保存到 sandbox/,文件名 ib_portfolio_action_report_{ACCOUNT}{YYYY-MM-DD}{HHmm}.md。依赖 ib-async、pandas-ta、yfinance。所有时间戳用 America/New_York,JSON 含 generated_at 与 data_delay。
限制:需本地 TWS/IB Gateway 且 API 已启用;两端口均失败时需用户自行确认。其他信息暂未提供。