贷款与房贷方案分析：比较固定/ARM、15年/30年、摊销…

当用户询问房贷月供、摊销表、固定 vs ARM、15/30 年比较、提前还款、买点数、APR、PMI、HELOC 或可负担房价时，用公式和脚本量化比较贷款方案。

适用场景

解决思路

1. 明确并记录输入：房价、首付、贷款额 P、年利率、期限、费用、当前余额、房产价值、信用分数、DTI、储备等；将年利率转为月利率 r=年利率/12，期限转为月数 n=年数×12。
2. 对固定利率贷款：使用 PMT = P × [r(1+r)^n] / [(1+r)^n - 1] 计算固定月供；说明利率和月供在整个贷款期内不变。
3. 对固定利率贷款，列出优点：月供可预测、抵御利率上升、预算简单；列出缺点：初始利率通常高于 ARM、利率下降时除非再融资否则无收益。
4. 对固定利率贷款，默认同时比较 30 年和 15 年期限。
5. 对 ARM：识别固定期和调整频率，按 X/Y ARM 记号解析，如 5/1 ARM=前5年固定、之后每年调整；7/1、10/1 同理。
6. 对 ARM：计算完全指数化利率 = 指数（如 SOFR、1-year Treasury）+ margin（如 2.75%）。
7. 对 ARM：读取并应用 rate caps：initial adjustment cap（如2%）、periodic cap（如2%）、lifetime cap（如5%），用于估算最坏调整。
8. 对 ARM：仅在计划在固定期结束前出售或再融资、预期利率下降、或能承受利率波动时评估其适用性。
9. 对每期还款拆分：利息部分 = 剩余余额 × 月利率；本金部分 = PMT - 利息部分；说明利息递减、本金递增。
10. 计算总利息：Total interest = n × PMT - P；可计算总还款 = n × PMT。
11. 用示例验证：对 $400K、30年、6.5% 贷款，PMT=$2,528，总还款=$910,178，总利息=$510,178。
12. 计算任意时点剩余余额：B_k = P × [(1+r)^n - (1+r)^k] / [(1+r)^n - 1]。
13. 分析额外还款：每 1 美元额外还款全部用于减少本金；计算新期限、总利息和节省额；强调越早还省息越多。
14. 提供额外还款方法：一次性 lump sum、固定每月额外还款、biweekly payments（26 个半额还款=每年 13 个全额还款）。
15. 计算 mortgage points：1 point = 贷款额的 1%（如 $400K 的 1 point = $4,000）；通常降低利率约 0.25%，但随 lender/market 变化。
16. 计算 points breakeven = points cost / monthly savings，得到回本月数；若计划持有超过 breakeven 且可 itemize deductions（points 可能在购买当年抵税），再建议买 points。
17. 区分 interest rate 与 APR：interest rate 是本金年化借款成本；APR 包含利率加某些费用（origination fees、points、PMI），按贷款期年化。
18. 比较贷款报价时用 APR，因为 APR > interest rate（有费用时总是如此），能反映不同费用结构的真实成本。
19. 分析 HELOC：计算 CLTV = (first mortgage balance + HELOC limit) / home value；检查多数 lender 要求 CLTV ≤ 80-90%。
20. 分析 HELOC 期限结构：draw period 通常 10 年，可灵活借还、常为 interest-only；repayment period 通常 20 年，不能再提取且完全摊销。
21. 分析 HELOC 利率：通常 variable rate = prime rate + margin，随市场波动；按利率上升情景做预算。
22. 评估 HELOC 用途：home improvements、debt consolidation、emergency backup；不要作为 primary emergency fund；提醒房屋是 collateral，违约可能 foreclosure。
23. 评估贷款资格：FICO 分数门槛：conventional 620+、FHA 580+、最佳利率 700+。
24. 计算并检查 DTI：front-end ≤ 28%，back-end ≤ 36-43%（按 program 变化）。
25. 计算并检查 LTV = loan amount / property value；LTV 越低风险越低、条款越好。
26. 检查 reserves：closing 后在 liquid assets 中保留 2-6 个月还款额。
27. 检查 employment/income：稳定收入历史，通常需要 2 年文档。
28. 分析 PMI：conventional loan LTV > 80% 时需 PMI；成本 0.5-1.5% of loan amount annually，加入月供。
29. 计算 PMI 移除：按原始 amortization 到 78% LTV 自动移除；可在 80% LTV 申请移除。
30. 给出 PMI 避免策略：20% down payment、piggyback loan（80/10/10）、lender-paid PMI（更高利率）、VA loan（无 PMI）；说明 PMI 只利好 lender，对借款人是纯成本。
31. 比较 15 年 vs 30 年：15 年首付月供更高、利率通常低 0.5-0.75%、总利息大幅更少、更快积累 equity；30 年月供低、更灵活、总利息更高。
32. 推荐 hybrid 方案：选 30 年保留灵活性，但按 15 年的金额做额外还款。
33. 执行 Example 1：给定 home price $500K、down payment $100K、loan amount $400K、30-year 6.5%、15-year 5.9%；计算 30-year PMT、总利息，15-year PMT、总利息、月供差和利息节省；得到 30-year PMT=$2,528、总利息=$510,178；15-year PMT=$3,354、总利息=$203,694；月供多 $826，省息 $306,484；15 年月供高 33% 但总利息省 60%。
34. 执行 Example 2：给定 $300K 30-year 6.5% mortgage（payment=$1,896.20/month），每月额外还 $200 到本金，总付款 $2,096.20/month；计算无额外还款总利息 $382,633。
35. 用 closed-form 估算新期限：n = -ln(1 - P × r / PMT_total) / ln(1+r)，其中 r=0.065/12=0.005417；得到约 276.3 payments。
36. 用逐月 amortization 精确模拟，最后一期部分还款；得到 277 months=23 years 1 month（约 23.1 年），总利息 $279,185；closed form 与精确表接近。
37. 计算额外还款收益：利息节省 $382,633-$279,185=$103,449；时间节省 360-277=83 months≈6.9 years；额外本金总额约 276×$200=$55,200；每 1 美元额外还款节省利息约 $1.87。
38. 检查常见陷阱：不要只比较 interest rate 而不比较 APR；APR 包含费用，更真实。
39. 检查 ARM teaser rates：固定期结束且利率上调时可能造成 payment shock。
40. 检查 points：若在 breakeven 前出售或再融资，买 points 不划算。
41. 检查 HELOC variable rate 风险：上升利率环境中要预算利率上升。
42. 检查 PMI：高 LTV 贷款因 PMI 比表面更贵，把 PMI 计入总月供。
43. 检查 opportunity cost：额外还 3-4% 房贷 vs 投资预期 7-10% 回报。
44. 检查 lender 比较：向多个 lender 询价，同一借款人利率报价可能相差 0.5%+。
45. 检查再融资：不要把期限重置为 30 年而延长总还款期，即使利率更低；把 closing costs 纳入再融资决策（参考 debt-management refinance breakeven）。
46. 参考相关技能：debt-management 处理 refinancing analysis、debt payoff vs investing、DTI；emergency-fund 处理 reserves；tax-efficiency 处理 mortgage interest deductibility、points deduction；savings-goals 处理 down payment；liquidity-management 处理 mortgage payments 现金流。
47. 运行参考实现：`uv run scripts/lending.py`（PEP 723 header 自动解析依赖）；或 `python3 scripts/lending.py`（需先 `pip install numpy scipy`）。
48. 裸运行脚本会打印 demo，覆盖 payment calculation、extra-payment impact、LTV/PMI、DSCR、balloon payments、refinance analysis、points breakeven、ARM resets。
49. 使用 `--verify` 重新计算 demo 数字并断言与技能 worked examples 匹配；打印 PASS/FAIL，不匹配时退出码非零。
50. 使用 `--help` 列出可用 classes 和 functions。
51. 优先把文件作为模块导入：`from lending import LendingAnalysis`，而不是独立运行。

适用边界 · 注意事项

• 当缺少贷款金额、利率、期限、费用、信用分数、DTI、房产价值等关键输入时，不适用做精确月供、APR、PMI 或资格结论。
• 当计划在 points breakeven 前出售或再融资时，不适用建议购买 points。
• 当借款人无法承受月供波动、没有足够 reserves，或把 HELOC/ARM 当作主要应急资金时，不适用推荐 HELOC/ARM 作为首选方案。