金融计算器

全面的金融计算功能，包括未来价值、现值、折价/溢价定价、复利及对比分析表。

快速开始

命令行使用

# Future Value
python3 scripts/calculate.py fv 10000 0.05 10 12
# PV=$10,000, Rate=5%, Years=10, Monthly compounding

# Present Value
python3 scripts/calculate.py pv 20000 0.05 10 12
# FV=$20,000, Rate=5%, Years=10, Monthly compounding

# Discount
python3 scripts/calculate.py discount 100 20
# Price=$100, Discount=20%

# Markup
python3 scripts/calculate.py markup 100 30
# Cost=$100, Markup=30%

# Future Value Table
python3 scripts/calculate.py fv_table 10000 0.03 0.05 0.07 --periods 1 5 10 20
# Principal=$10,000, Rates=3%,5%,7%, Periods=1,5,10,20 years

# Discount Table
python3 scripts/calculate.py discount_table 100 10 15 20 25 30
# Price=$100, Discounts=10%,15%,20%,25%,30%

网页界面

启动交互式计算器：

./scripts/launch_ui.sh [port]
# Default port: 5050
# Opens at: http://localhost:5050
# Auto-creates venv and installs Flask if needed

或手动操作：

cd skills/financial-calculator
python3 -m venv venv  # First time only
venv/bin/pip install flask  # First time only
venv/bin/python scripts/web_ui.py [port]

功能特色：

• 7种计算器类型，配备直观标签页
• 实时计算
• 交互式表格
• 精美的渐变界面
• 移动端响应式设计

计算器类型

1. 未来价值（FV）

计算复利条件下投资未来的价值。

应用场景：

• 投资增长预测
• 储蓄账户增长
• 退休规划

输入参数：

• 本金金额
• 年利率（%）
• 时间期限（年）
• 复利频率（每年/每季度/每月/每日）

2. 现值（PV）

计算未来金额的当前价值（折现值）。

使用场景：

• 贷款估值
• 债券定价
• 投资分析

输入项：

• 未来价值
• 年折现率（%）
• 时间期限（年）
• 复利频率

3. 折扣计算器

计算应用百分比折扣后的最终价格。

使用场景：

• 零售定价
• 销售计算
• 成本节约分析

输入项：

• 原价
• 折扣百分比

输出项：

• 折扣金额
• 最终价格
• 节省百分比

4. 加价计算器

根据成本和加价百分比计算销售价格。

使用场景：

• 产品定价
• 利润率计算
• 商业定价策略

输入项：

• 成本价格
• 加价百分比

输出项：

• 加价金额
• 销售价格
• 利润率（占销售价格的百分比）

5. 复利计算器

复利计算的详细分解。

使用场景：

• 利息分析
• 有效利率比较
• 贷款利息计算

输出项：

• 最终金额
• 总利息收益
• 有效年利率

6. 终值表

生成跨多个利率和时间段的对比表。

使用场景：

• 投资情景对比
• 利率筛选
• 长期规划

功能：

• 添加多个利率
• 添加多个时间段
• 在可排序表格中查看所有组合
• 查看总收益和收益百分比

7. 折扣表

比较同一价格的多个折扣百分比。

使用场景：

• 批量定价策略
• 促销规划
• 价格对比

功能：

• 添加多个折扣百分比
• 查看所有折扣方案
• 比较最终价格与节省金额

安装

需要 Python 3.7+ 和 Flask：

pip install flask

或使用 venv：

python3 -m venv venv
source venv/bin/activate
pip install flask

Python API

导入计算模块：

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

# Calculate FV
fv = future_value(
    present_value=10000,
    rate=0.05,  # 5% as decimal
    periods=10,
    compound_frequency=12  # Monthly
)

# Generate table
table = generate_fv_table(
    principal=10000,
    rates=[0.03, 0.05, 0.07],  # As decimals
    periods=[1, 5, 10, 20]
)

公式

请参阅references/formulas.md以获取所有计算的详细数学公式、示例和用例。

提示

利率格式：

• 命令行界面：使用小数（0.05 表示 5%）
• 网页用户界面：使用百分比（5 表示 5%）
• Python API：使用小数（0.05 表示 5%）

复利频率：

• 1 = 年复利
• 4 = 季度复利
• 12 = 月复利
• 365 = 日复利

表格生成：进行有意义比较的最佳实践：

• 终值表：使用3-5个利率，4-6个时间段
• 贴现表：使用5-10个贴现百分比
• 保持表格简洁以便于分析

性能：

• Web界面计算即时完成
• 超过100种组合的表格可能需要几秒钟
• 命令行界面对于单次计算最快

常见工作流程

投资规划

1. 使用终值计算器来预测单项投资
2. 生成终值表以比较不同利率
3. 查看复利获取详细分解

定价策略

1. 使用加价计算器来设定售价
2. 生成折扣表用于规划促销活动
3. 比较利润率和最终价格

贷款分析

1. 使用现值计算器为贷款估值
2. 检查复利计算总利息成本
3. 生成终值表以比较贷款条款