financial-calculator

用途

Financial Calculator 是一个综合性的财务计算工具，用于处理常见的财务计算，包括终值（Future Value）、现值（Present Value）、折扣与加价定价、复利，以及生成对比表格。它适合需要快速进行投资增长预测、产品定价、贷款估值等计算的用户。

主要能力

该技能提供 7 种计算器类型：

终值（FV）：计算投资在复利下的未来价值。输入包括本金、年利率、时间（年）和复利频率（年/季/月/日）。适用于投资增长预测、储蓄账户增长、退休规划。
现值（PV）：计算未来金额的当前价值（折现值）。输入包括未来值、年折现率、时间（年）和复利频率。适用于贷款估值、债券定价、投资分析。
折扣计算器：计算应用百分比折扣后的最终价格。输入原价和折扣百分比，输出折扣金额、最终价格和节省百分比。适用于零售定价、促销计算、成本节省分析。
加价计算器：根据成本和加价百分比计算销售价格。输入成本价和加价百分比，输出加价金额、销售价格和利润率（占销售价格的百分比）。适用于产品定价、利润计算、商业定价策略。
复利：提供复利计算的详细分解。输出最终金额、总利息和有效年利率。适用于利息分析、有效利率比较、贷款利息计算。
终值表：跨多个利率和时间段生成对比表格。可添加多个利率和时间段，查看所有组合的排序表格，并显示总收益和收益百分比。适用于投资场景比较、利率比较、长期规划。
折扣表：比较同一价格下的多个折扣百分比。可添加多个折扣百分比，查看所有折扣场景，比较最终价格和节省金额。适用于批量定价策略、促销规划、价格比较。

使用方式

命令行（CLI）

使用 python3 scripts/calculate.py 命令，支持以下子命令：

终值：python3 scripts/calculate.py fv 10000 0.05 10 12（PV=$10,000，利率=5%，年数=10，按月复利）
现值：python3 scripts/calculate.py pv 20000 0.05 10 12（FV=$20,000，利率=5%，年数=10，按月复利）
折扣：python3 scripts/calculate.py discount 100 20（价格=$100，折扣=20%）
加价：python3 scripts/calculate.py markup 100 30（成本=$100，加价=30%）
终值表：python3 scripts/calculate.py fv_table 10000 0.03 0.05 0.07 --periods 1 5 10 20（本金=$10,000，利率=3%,5%,7%，周期=1,5,10,20年）
折扣表：python3 scripts/calculate.py discount_table 100 10 15 20 25 30（价格=$100，折扣=10%,15%,20%,25%,30%）

网页界面（Web UI）

启动交互式计算器：

./scripts/launch_ui.sh [port]
# 默认端口：5050
# 打开地址：http://localhost:5050
# 自动创建 venv 并在需要时安装 Flask

或手动启动：

cd skills/financial-calculator
python3 -m venv venv  # 仅首次
venv/bin/pip install flask  # 仅首次
venv/bin/python scripts/web_ui.py [port]

网页界面特性：7 种计算器类型，带直观选项卡；实时计算；交互式表格；美观的渐变 UI；移动端响应式设计。

Python API

可导入计算模块：

from calculate import (
    future_value,
    present_value,
    discount_amount,
    markup_price,
    compound_interest,
    generate_fv_table,
    generate_discount_table
)

# 计算 FV
fv = future_value(
    present_value=10000,
    rate=0.05,  # 5% 以小数表示
    periods=10,
    compound_frequency=12  # 按月
)

# 生成表格
table = generate_fv_table(
    principal=10000,
    rates=[0.03, 0.05, 0.07],  # 以小数表示
    periods=[1, 5, 10, 20]
)

适用场景

投资规划：使用 FV 计算器预测单笔投资，生成 FV 表比较不同利率，查看复利详细分解。
定价策略：使用加价计算器设定销售价格，生成折扣表规划促销，比较利润率和最终价格。
贷款分析：使用 PV 计算器估值贷款，查看复利计算总利息成本，生成 FV 表比较贷款条款。

限制与注意事项

需要 Python 3.7+ 和 Flask（pip install flask）。
利率格式：CLI 和 Python API 使用小数（0.05 表示 5%），Web UI 使用百分比（5 表示 5%）。
复利频率：1=年，4=季，12=月，365=日。
表格生成建议：FV 表使用 3-5 个利率、4-6 个时间段；折扣表使用 5-10 个折扣百分比；保持表格聚焦以便分析。
性能：Web UI 计算即时完成；超过 100 个组合的表格可能需要几秒钟；CLI 对于单次计算最快。
详细数学公式、示例和用例参见 references/formulas.md。