# 配方树工作台

这是给策划直接使用的本地数据工具。它编辑的不是一份演示副本，而是项目中的权威配方书：`data/recipe-book.json`。

## 打开

在 Windows 资源管理器中双击 `start-editor.cmd`。启动器会在本机打开浏览器页面，保存服务只监听 `127.0.0.1`，不会对局域网或互联网开放。

如果浏览器没有自动打开，也可以在本目录运行：

```powershell
node server.mjs
```

随后访问 `http://127.0.0.1:8765/tools/recipe-tree-editor/`。

## 日常使用

1. 从左侧切换配方、物品或设施，并用阶段、生态区和搜索缩小范围。
2. 中央默认显示选中条目的上下游；“全局”模式用于检查整条阶段结构。
3. 在右侧修改数值。所有修改会立即反映到图谱和校验结果，并自动保留一份浏览器草稿。
4. 先处理顶部的错误，再点“保存数据”。直接保存会写回 `data/recipe-book.json`，并在 `data/backups/` 生成时间戳备份。
5. `Ctrl+Z` / `Ctrl+Y` 撤销和重做，`Ctrl+S` 保存，`/` 聚焦搜索。

## 魔法配方字段

- 输入方式“消耗”：每批永久扣除。
- “催化”：参与仪式但不扣除，例如锚核和边界石。
- “流体”：来自魔力或物质管网的批次输入。
- “状态”：要求物品携带某种法则状态。
- `min` / `max`：随机数量的安全上下界，`amount` 是策划估算用期望值。
- `weight`：传送门结果袋权重，同一配方的权重总和必须为 100。
- `chance`：独立概率；当所有产出都是概率项时，总和必须为 1。
- `entropy`：每批给仪式网络或传送门增加的熵压力。

## 保存安全

- 有结构错误时，界面和服务端都会拒绝写入。
- 修改 ID 会自动更新配方引用；仍被引用的物品或设施不能直接删除。
- 浏览器草稿不是项目文件，顶部会一直显示“未保存”，直到直接保存成功。
- 本地服务不可用时，“保存数据”会退化为下载 JSON；此时需要手动替换项目数据文件。

## 校验

```powershell
node tests.mjs
```

测试覆盖引用完整性、科技 ID、结果袋权重、依赖图构建和首次折跃关键上游。当前 Godot 原型尚未消费这份数据；等内容运行时建立后，应直接读取这份 JSON 或由它生成 Godot Resource，避免维护第二套数值。