50 lines
2.4 KiB
Markdown
50 lines
2.4 KiB
Markdown
# 配方树工作台
|
|
|
|
这是给策划直接使用的本地数据工具。它编辑的不是一份演示副本，而是项目中的权威配方书：`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，避免维护第二套数值。
|