名称： financial-calculator
描述： 高级财务计算器，包含终值表、现值、折扣计算、加价定价和复利计算。适用于计算投资增长、定价策略、贷款估值、折扣或比较不同利率和期限的财务场景。包含命令行界面和交互式网页界面。

财务计算器

全面的财务计算功能，包括终值、现值、折扣/加价定价、复利以及对比表格。

快速开始

命令行界面 (CLI) 使用

# 终值
python3 scripts/calculate.py fv 10000 0.05 10 12
# 现值=$10,000， 年利率=5%， 年数=10， 按月复利

# 现值
python3 scripts/calculate.py pv 20000 0.05 10 12
# 终值=$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 [端口号]
# 默认端口: 5050
# 访问地址: http://localhost:5050
# 如需，会自动创建虚拟环境并安装 Flask

或手动启动：

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

功能特性：
- 7 种计算器类型，直观的标签页
- 实时计算
- 交互式表格
- 美观的渐变界面
- 移动端响应式设计

计算器类型

1. 终值 (FV)

计算投资在复利情况下的未来价值。

适用场景：
- 投资增长预测
- 储蓄账户增长
- 退休规划

输入参数：
- 本金金额
- 年利率 (%)
- 时间期限 (年)
- 复利频率 (年/季/月/日)

2. 现值 (PV)

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

适用场景：
- 贷款估值
- 债券定价
- 投资分析

输入参数：
- 终值
- 年折现率 (%)
- 时间期限 (年)
- 复利频率

3. 折扣计算器

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

适用场景：
- 零售定价
- 促销计算
- 成本节省分析

输入参数：
- 原价
- 折扣百分比

输出结果：
- 折扣金额
- 最终价格
- 节省百分比

4. 加价计算器

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

适用场景：
- 产品定价
- 利润率计算
- 商业定价策略

输入参数：
- 成本价
- 加价百分比

输出结果：
- 加价金额
- 销售价格
- 利润率 (占售价的百分比)

5. 复利计算器

提供复利计算的详细明细。

适用场景：
- 利息分析
- 有效利率比较
- 贷款利息计算

输出结果：
- 最终金额
- 总利息收益
- 有效年利率

6. 终值表

生成跨多个利率和期限的对比表格。

适用场景：
- 投资情景比较
- 利率对比
- 长期规划

功能：
- 添加多个利率
- 添加多个时间期限
- 在可排序表格中查看所有组合
- 查看总收益和收益率

7. 折扣表

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

适用场景：
- 批量定价策略
- 促销活动规划
- 价格比较

功能：
- 添加多个折扣百分比
- 查看所有折扣情景
- 比较最终价格和节省金额

安装

需要 Python 3.7+ 和 Flask：

pip install flask

或使用虚拟环境：

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
)

# 计算终值
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]
)

公式

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

使用技巧

利率格式：
- CLI: 使用小数 (0.05 表示 5%)
- Web UI: 使用百分比 (5 表示 5%)
- Python API: 使用小数 (0.05 表示 5%)

复利频率：
- 1 = 年
- 4 = 季
- 12 = 月
- 365 = 日

表格生成：
有意义的比较最佳实践：
- 终值表：使用 3-5 个利率，4-6 个时间期限
- 折扣表：使用 5-10 个折扣百分比
- 保持表格聚焦，便于分析

性能：
- Web UI 计算是即时的
- 超过 100 种组合的表格可能需要几秒钟
- CLI 对于单次计算最快

常见工作流

投资规划

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

定价策略

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

贷款分析

1. 使用 现值计算器 评估贷款价值
2. 查看 复利计算器 了解总利息成本
3. 生成 终值表 比较贷款条款