# Fuse 开发者指南

## 项目结构

```
fuse/
├── moon.mod              # 包元数据（name=fuse, Apache-2.0）
├── README.md             # API 参考 + 快速开始
├── GUIDE.md              # 新手指南
├── CONTRIBUTING.md       # 本文件
├── LICENSE               # Apache-2.0
└── src/
    ├── lib/
    │   ├── moon.pkg      # 依赖声明
    │   └── fuse.mbt      # 主库源码（~270行）
    └── main/
        ├── moon.pkg
        └── main.mbt      # Demo
```

## 构建

```bash
moon check      # 编译检查
moon test       # 运行测试（6个）
moon build      # 构建
```

## 状态机设计

```
Closed ──failure_threshold──▶ Open ──cooldown──▶ HalfOpen
  ▲                              ▲                  │
  │                              │   [half失败]      │
  └── half_open_limit successes ─┘                   │
                                                     │
                        Open ◀────────────────────────┘
```

## 可贡献方向

- 指数退避算法（动态 cooldown）
- 半开状态的渐进式探测
- 按错误类型分类计数
- 真实时钟替代 tick 计数器

## 许可证

Apache-2.0