用途:监控与管理保证金生活策略,跟踪保证金余额、利息成本、股息覆盖率及组合对保证金的安全阈值,并依据策略里程碑给出数据驱动的扩展建议。
主要能力:从本地数据库读取保证金事实;计算月度/年度利息成本、股息收入、覆盖率(股息÷利息)、组合对保证金比率;执行保证金跳升告警(新余额超过旧余额加阈值即停止并等待确认);按时间里程碑(第6、12、18个月)给出扩展提示;按绿/黄/红/临界阈值生成告警。
使用方式:先执行同步(强制同步优先),命令为 uv run python -m src.integrations.snaptrade.sync_db(或 refresh_all),确认 balances 表带有本次运行的 synced_at 后再读取数据;随后运行 uv run python -m src.analysis.margin_metrics --pretty 输出 JSON 指标。备用数据源:--source snaptrade(实时 API)、--source csv(旧版 Fidelity 余额 CSV)。个人静态假设来自 .env(如 FG_STRATEGY_START_DATE、FG_MARGIN_INTEREST_RATE、FG_MARGIN_JUMP_ALERT_THRESHOLD、各月提取目标、业务收入注入值等);组合价值、保证金余额、利息成本、股息收入、覆盖率、组合对保证金比率须在运行时读取或计算,不得硬编码。
适用场景:同步 SnapTrade 实时保证金余额、更新保证金余额或利率、计算覆盖率、评估保证金扩展决策、检查安全阈值。
限制:该技能为只读,family_office.db 仅由同步 CLI 写入,不得手工改行;balances 表以 account_id 为主键,仅保留当前一行、无历史,每次同步覆盖旧行;DB 与 SnapTrade 路径下 margin_interest_accrued_this_month 为 null(券商不暴露应计利息,仅 CSV 路径有);保证金余额为 0 时覆盖率报告为不适用而非相除;现金管理账户经 SimpleFIN 同步到 bank_transactions,不进入券商 balances 表。资料未提供具体价格、收费或平台支持信息。仅供教育用途,不构成投资建议,保证金借款存在损失超过本金的风险。