为《燕云十六声》（Where Winds Meet）做的纯本地数据计算工具：算材料、算缺口、算天数。 不读游戏内存、不模拟按键、不发网络请求——不含任何游戏自动化，只有算术。
| 命令 | 用途 | 例子 |
|---|---|---|
vigor |
心力积累模拟（含溢出合成心力丹机制） | 攒 3 天心力能刷多少次据点 |
stamina |
体力积累模拟 | 明天体力会不会溢出浪费 |
when |
攒到目标心力还要几天 | 新武学上线前攒爆发 |
plan |
养成材料总需求 → 对比库存算缺口 → 按日产出估天数 | 武学 60→80×2 套 + 叠音 5→10×6 件 |
零依赖（纯 Python 标准库），所有游戏数值放在 data/*.json，改数值不用动代码。
pip install -e .
# 心力规划：当前 550，攒 3 天后有多少可用（含心力丹折算）
wmt vigor --current 550 --days 3
# 攒到 1800 心力（≈3 次心法箱爆发）还要几天
wmt when --target 1800 --current 550 --pills 2
# 养成规划：武学 60→80 两套 + 叠音 5→10 六件
wmt plan wuxue:60:80:2 dieyin:5:10:6 --inventory my_progress --markdown plan.mdplan 输出总需求、缺口清单、每种材料按你日程（data/income.json）估算的攒齐天数，
以及受最大缺口限制的最短完成时间；--markdown 可导出清单贴进笔记或 issue。
| 文件 | 内容 | 数据可靠性 |
|---|---|---|
data/caps.json |
心力/体力上限、每日恢复、心力丹合成阈值 | ✅ 机制数值来自公开攻略（见下） |
data/wuxue.json |
武学升级/突破材料表 | ⚠ 示例数值，待校对 |
data/dieyin.json |
装备叠音强化/突破材料表 | ⚠ 示例数值，待校对 |
data/income.json |
你每天实际产出的材料量 | 按个人日程填写 |
data/my_progress.json |
当前库存 | 按个人进度填写 |
为什么材料表是示例数值：每级精确消耗需要大量游戏内核对，社区也没有权威全表。 工具的价值在计算引擎（区间汇总、多份叠加、缺口、天数估算），数值错了改 JSON 即可。 欢迎提 PR 校对数值——这是本仓库最需要的贡献。
- 燕云十六声体力使用规划 - 游侠手游：体力每日恢复 450、上限 2500，可兑换宝钱/制作
- 心力体力全攻略 - 17173：心力上限 600、每日回复 180，溢出每 60 点合成心力丹
- 每周限购材料汇总 - 游侠手游：寒铁（叠音突破）、独山玉（叠音强化）、脂尾羊皮（叠音突破）
- 战力养成建议 - 游民星空：双武学天赋同时生效，武学等级影响造诣
- 速刷武学升级突破材料 - 3DM：青石锁等材料获取途径
- 官方 FAQ
windsmeet-tools/
├── windsmeet_tools/ # 计算引擎（纯标准库）
│ ├── data.py # 数据加载/目标解析
│ ├── vigor.py # 心力/体力模拟（上限截断、溢出合成）
│ ├── planner.py # 需求汇总/缺口/天数估算/Markdown 渲染
│ └── cli.py # 命令行入口
├── data/ # 全部游戏数值（JSON，可直接编辑）
├── tests/ # pytest
└── .github/workflows/ # CI（3.10/3.11/3.12）
- 本项目与网易/Everstone Studio 无关，仅供个人游戏规划使用。
- 不包含任何自动化、宏、外挂或内存读取工具；使用本工具不会影响你的账号。
- 游戏数值可能随版本变动，使用前请对照游戏内核对
data/中的数值。