介绍
# Financial Calculator
全面的金融计算，包括终值、现值、折扣/加价定价、复利和对比表。
## 快速开始
### CLI 使用
```bash # 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% ```
### Web UI
启动交互式计算器：
```bash ./scripts/launch_ui.sh [port] # Default port: 5050 # Opens at: http://localhost:5050 # Auto-creates venv and installs Flask if needed ```
或者手动启动： ```bash 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 种计算器类型，配有直观的选项卡 - 实时计算 - 交互式表格 - 美观的渐变 UI - 响应式设计（适配移动端）
## 计算器
### 1. 终值 (FV) 计算投资在未来通过复利增长后的价值。
**用例：** - 投资增长预测 - 储蓄账户增长 - 退休规划
**输入：** - 本金金额 - 年利率（%） - 时间周期（年） - 复利频率（年/季/月/日）
### 2. 现值 (PV) 计算未来金额的当前价值（折现值）。
**用例：** - 贷款估值 - 债券定价 - 投资分析
**输入：** - 终值 - 年折现率（%） - 时间周期（年） - 复利频率
### 3. 折扣计算器 计算应用百分比折扣后的最终价格。
**用例：** - 零售定价 - 促销计算 - 成本节约分析
**输入：** - 原价 - 折扣百分比
**输出：** - 折扣金额 - 最终价格 - 节省百分比
### 4. 加价计算器 根据成本和加价百分比计算销售价格。
**用例：** - 产品定价 - 利润率计算 - 商业定价策略
**输入：** - 成本价 - 加价百分比
**输出：** - 加价金额 - 销售价格 - 利润率（占销售价格的百分比）
### 5. 复利计算 复利计算的详细细分。
**用例：** - 利息分析 - 有效利率比较 - 贷款利息计算
**输出：** - 最终金额 - 总利息收入 - 实际年利率
### 6. 终值表 生成跨越多个利率和时间周期的对比表。
**用例：** - 投资情景对比 - 利率筛选 - 长期规划
**功能特点：** - 添加多个利率 - 添加多个时间周期 - 在可排序的表格中查看所有组合 - 查看总收益和收益百分比
### 7. 折扣表 比较同一价格的多个折扣百分比。
**用例：** - 批量定价策略 - 促销规划 - 价格比较
**功能特点：** - 添加多个折扣百分比 - 查看所有折扣情景 - 比较最终价格和节省金额
## 安装
需要 Python 3.7+ 和 Flask：
```bash pip install flask ```
或者使用 venv：
```bash python3 -m venv venv source venv/bin/activate pip install flask ```
## Python API
导入计算模块：
```python 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`。
## 提示
**利率格式：** - CLI：使用小数（5% 用 0.05 表示） - Web UI：使用百分比（5% 用 5 表示） - Python API：使用小数（5% 用 0.05 表示）
**复利频率：** - 1 = 每年 - 4 = 每季度 - 12 = 每月 - 365 = 每天
**表格生成：** 进行有意义的比较的最佳实践： - 终值表：使用 3-5 个利率，4-6 个时间周期 - 折扣表：使用 5-10 个折扣百分比 - 保持表格简洁以便于分析
**性能：** - Web UI 计算是即时的 - 包含超过 100 种组合的表格可能需要几秒钟 - 对于单次计算，CLI 是最快的
## 常见工作流程
### 投资规划 1. 使用**终值计算器**预测单项投资 2. 生成**终值表**以比较不同利率 3. 查看**复利计算**以获取详细细分
### 定价策略 1. 使用**加价计算器**设定销售价格 2. 生成**折扣表**以规划促销 3. 比较利润率和最终价格
### 贷款分析 1. 使用**现值计算器**评估贷款价值 2. 查看**复利计算**以了解总利息成本 3. 生成**终值表**以比较贷款条款