# tools/ —— 独立小工具

这个目录放**与游戏协议无关的独立小工具**：纯计算、纯文件处理。
它们**不联网**、**不碰游戏服务器**、也**不依赖 `api/` 与 `config.py`**。

## 约定

| 约定 | 说明 |
|---|---|
| 一个工具一个子目录 | `tools/<工具名>/` |
| 自包含 | 工具之间不互相依赖，单独拷走也能跑 |
| 纯本地 | 不联网、不写游戏服务器；最多读本机文件 |
| 无第三方依赖 | 只用 Python 标准库（除非工具自己的 README 里写明） |
| 登记 | 新增工具时，在下面的「已有工具」表里加一行 |

## 已有工具

| 工具 | 目录 | 干什么 |
|---|---|---|
| 谱面达成率计算器 | [`chart_achievement/`](chart_achievement/) | 按判定数算谱面达成率与 DX 分；也可由达成率倒算判定组合 |

## 怎么跑

```bash
# 进工具目录，直接 python 跑（各工具的参数见它自己的说明）
cd tools/chart_achievement
python chart_achievement.py --help
```

---