fund-tax-optimizer

# 基金税务优化 (Fund Tax Optimizer)

智能税务规划与赎回时机优化工具，帮助用户降低投资税务成本。

## 功能概述

- **赎回费优化**: 计算最佳赎回时机、持有期管理
- **税收损失收割**: 识别亏损仓位、建议置换时机
- **分红方式选择**: 现金分红vs红利再投资收益对比
- **税务计算器**: 赎回收益、税负估算
- **持有期监控**: 追踪各笔投资持有期、预警提醒
- **税务报告**: 年度税务汇总、申报辅助

## 使用方法

### 命令行调用

```bash
# 赎回时机优化
fund-tax --optimize --holdings holdings.json --target 50000

# 税收损失收割
fund-tax --harvest --portfolio portfolio.json

# 分红方式对比
fund-tax --dividend --compare --amount 100000 --years 5
```

### Python API

```python
from fund_tax_optimizer import TaxOptimizer

optimizer = TaxOptimizer()

# 赎回优化
result = optimizer.optimize_redemption(
    holdings=holdings,
    target_amount=50000
)

# 税收损失收割
harvest = optimizer.tax_loss_harvest(portfolio)
```

## 基金赎回费率表

### 股票型/混合型基金

| 持有期 | 赎回费率 | 备注 |
|:---|:---:|:---|
| < 7天 | 1.50% | 惩罚性费率 |
| 7-30天 | 0.75% | 短期费率 |
| 30-365天 | 0.50% | 中期费率 |
| 1-2年 | 0.25% | 长期费率 |
| > 2年 | 0% | 免赎回费 |

### C类份额

| 持有期 | 赎回费率 |
|:---|:---:|
| < 7天 | 1.50% |
| > 30天 | 0% |

**特点**: C类无申购费，按日计提销售服务费(约0.4%/年)，适合短期持有

## 赎回优化策略

### 持有期管理

```
目标: 尽量持有满免赎回费期限

优化策略:
1. 优先赎回已免费的份额
2. 其次赎回费率最低的份额
3. 避免7天内赎回(费率1.5%)
4. 大额赎回考虑分批

总成本 = Σ(赎回份额 × 净值 × 赎回费率)
```

### 先进先出 vs 后进先出

| 方法 | 适用场景 | 特点 |
|:---|:---|:---|
| 先进先出(FIFO) | 默认方式 | 先买的先卖，通常持有期更长、费率更低 |
| 后进先出(LIFO) | 特定策略 | 后买的先卖，可保留早期低成本份额 |
| 指定份额 | 精确控制 | 指定赎回特定批次 |

## 税收损失收割 (Tax Loss Harvesting)

### 原理

```
卖出亏损头寸 → 确认资本损失 → 抵减资本利得 → 降低税负
           ↓
        30天后买回同类资产 (避免洗售规则)
```

### 计算示例

```
已实现收益: +¥10,000
已实现亏损: -¥5,000
净应税收益: ¥5,000
节省税款: ¥5,000 × 20% = ¥1,000

若不收割:
净应税收益: ¥10,000
应缴税款: ¥10,000 × 20% = ¥2,000

节省: ¥1,000
```

### 洗售规则 (Wash Sale)

```
卖出亏损后30天内买回相同或实质性相似证券:
  → 损失不能抵税
  → 成本基价调整

避免方法:
  1. 等待31天后再买回
  2. 立即买入相似但不相同的基金
  3. 买入ETF替代指数基金
```

## 分红方式选择

### 现金分红 vs 红利再投资

| 维度 | 现金分红 | 红利再投资 |
|:---|:---|:---|
| 现金流 | 获得现金 | 增加份额 |
| 复利效应 | 无 | 有 |
| 灵活性 | 高 | 低 |
| 适合人群 | 需要现金流 | 长期积累 |

### 收益对比计算

```
初始投资: ¥100,000
年化收益: 10%
分红率: 3%
投资期限: 5年

现金分红:
  每年获得: ¥100,000 × 3% = ¥3,000
  5年累计: ¥15,000 (未再投资)
  期末价值: ¥100,000 × (1.07)^5 = ¥140,255
  总价值: ¥140,255 + ¥15,000 = ¥155,255

红利再投资:
  期末价值: ¥100,000 × (1.10)^5 = ¥161,051

差额: ¥161,051 - ¥155,255 = ¥5,796 (3.7%)
```

## 输出格式

### 赎回优化报告

```json
{
  "optimization_id": "TAX_20260321_001",
  "analysis_date": "2026-03-21",
  "target_amount": 50000,
  "recommendations": [
    {
      "fund_code": "000001",
      "fund_name": "华夏成长",
      "redemption_lots": [
        {
          "lot_id": "LOT_20230115",
          "shares": 1000,
          "cost_basis": 1.20,
          "current_nav": 1.50,
          "holding_days": 796,
          "redemption_fee": 0,
          "proceeds": 1500
        }
      ],
      "total_shares": 1000,
      "total_proceeds": 1500,
      "total_fee": 0,
      "realized_gain": 300
    }
  ],
  "summary": {
    "total_redeemed": 50000,
    "total_fees": 0,
    "weighted_fee_rate": 0,
    "realized_gains": 12000
  }
}
```

## 示例

### 示例1: 赎回时机优化

**输入**:
```
需要赎回5万元，优化赎回顺序
```

**输出**:
```
📊 赎回优化报告

目标金额: ¥50,000
优化策略: 最小化赎回费

建议赎回顺序:

1. 华夏成长混合 (000001)
   份额: 8,000份
   批次: 2023-01-15购入 (持有796天 ✅)
   净值: ¥1.50
   赎回费: 0% (持有>2年)
   金额: ¥12,000
   收益: +¥2,400

2. 易方达蓝筹精选 (000002)
   份额: 15,000份
   批次: 2024-06-01购入 (持有293天)
   净值: ¥1.20
   赎回费: 0.25% (持有1-2年)
   金额: ¥18,000
   费用: ¥45
   净额: ¥17,955

3. 中欧时代先锋 (000003)
   份额: 14,000份
   批次: 2025-02-01购入 (持有48天 ⚠️)
   净值: ¥1.50
   赎回费: 0.5% (持有30-365天)
   金额: ¥21,000
   费用: ¥105
   净额: ¥20,895

汇总:
  总赎回金额: ¥51,000
  总赎回费: ¥150 (0.29%)
  净到账: ¥50,850
  实现收益: ¥8,400

⚠️ 警告:
  • 中欧时代先锋持有期较短，建议:
    a) 等待满1年再赎回 (省¥52.5)
    b) 或换其他已满2年的份额

💡 优化建议:
  • 优先使用持有>2年的份额
  • 避免使用<30天的份额 (费率0.75%)
  • 考虑使用C类份额 (持有>30天免费)
```

### 示例2: 税收损失收割

**输入**:
```
分析税收损失收割机会
```

**输出**:
```
📊 税收损失收割报告

当前持仓:
  已实现收益: +¥15,000
  未实现收益: +¥8,000
  未实现亏损: -¥6,500

可收割亏损:
  1. 广发科技创新 (000009)
     亏损: -¥4,200
     持有期: 180天
     建议: ✅ 卖出收割

  2. 某新能源基金 (000XXX)
     亏损: -¥2,300
     持有期: 90天
     建议: ✅ 卖出收割

收割收益:
  总可收割亏损: ¥6,500
  抵减收益后净收益: ¥15,000 - ¥6,500 = ¥8,500
  节省税款: ¥6,500 × 20% = ¥1,300

再投资方案 (避免洗售):
  方案A: 等待31天后买回
    风险: 期间上涨错失机会
    
  方案B: 立即买入替代基金
    广发科技 → 买入南方科技创新
    新能源基金 → 买入碳中和ETF
    
  方案C: 将资金转入其他资产
    如: 债券基金、货币基金

执行建议:
  ✅ 建议在年度结束前执行
  ✅ 优先收割亏损>¥1,000的仓位
  ⚠️ 记录所有交易成本
  📅 设置31天后买回提醒
```

### 示例3: 分红方式对比

**输入**:
```
对比现金分红和红利再投资，10万元投资5年
```

**输出**:
```
📊 分红方式对比报告

投资参数:
  初始金额: ¥100,000
  预期年化: 10%
  分红率: 3%/年
  投资期限: 5年

现金分红方案:
  每年获得现金: ¥3,000
  5年累计现金: ¥15,000
  期末净值增长: ¥140,255 (7%复利)
  总价值: ¥155,255
  总收益率: 55.3%

红利再投资方案:
  每年份额增长: 3%
  期末价值: ¥161,051 (10%复利)
  总收益率: 61.1%

对比:
              现金分红      红利再投资    差额
  期末价值:   ¥155,255     ¥161,051     +¥5,796
  总收益率:   55.3%        61.1%        +5.8pp
  年化收益:   9.2%         10.0%        +0.8pp

建议:
  ✅ 长期投资者(>3年): 选择红利再投资
  ✅ 需要现金流: 选择现金分红
  💡 可在"账户设置"中随时更改分红方式

注意:
  现金分红的资金建议单独投资，不要闲置
  红利再投资无申购费，但成本基价会调整
```

## 注意事项

1. 赎回费是基金运营成本的一部分，不同基金差异较大
2. C类份额适合短期持有，A类适合长期投资
3. 税收损失收割需考虑交易成本和市场时机
4. 中国目前基金赎回暂免个税，主要关注赎回费
5. 分红方式可随时更改，一般T+1生效
6. 定期审视持仓的持有期，规划赎回顺序

## 依赖

```
numpy>=1.20.0
pandas>=1.3.0
```

## 作者

FinClaw - 上海财经大学金融研究工具