chore: W1 项目骨架 — 基线 v1.0 架构落盘（Godot 4.7.2 / gl_compatibility）
架构基线：docs/architecture/2026-10-19-F-architecture.md（v1.0） 范围：WRATH OF THE DEAD《怨返》单人挂机 · GDScript · 1280×720 · 12 班底数据驱动 - 骨架：project.godot（4.7 + GL Compatibility）、架构 §2.1 完整目录树（含占位说明）、 .gitignore/.gitattributes（LF 纪律）、README.md、CLAUDE.md、export_presets.cfg 占位、 pipeline/README.md（3ds Max 侧契约） - 数据管线段 1：data/sheets/generators.csv（GDD §3.1 十二班底逐值抄录） + data/schema/generators.schema.json（v0）+ src/tools/sheet_importer.gd （import_all/import_sheet/validate + ImportReport + .tres stub + 行号/列名/原因失败策略） + src/tools/import_main.gd（CI CLI 入口）+ data/build/generators.json（字节级确定性产物） - 探针：P1（SCREEN_TEXTURE/CanvasLayer 排序）与 P3（NoiseTexture2D seamless）场景代码与 截图/统计工具；实测手册与结论模板在工作区 docs/engineering/（随仓库外文档树） - CI：数据门激活（import_all + schema validate + build 漂移门）；单测/sim/导出 W3+ 注释占位； 4.7.2 headless CLI 行为标注待本机验证 待用户侧：P1/P3 实测回填结论；P6 字体许可 / P7 GPU 实测；look-dev 游魂初版（Max 侧）
This commit is contained in:
程基岩（engineering-lead） committed
commit
856326a766
42 files changed
+1814
No files matched your search
@@ -0,0 +1,18 @@
|
|||||||
|
# 行尾纪律：CI 的 build/*.json 漂移门依赖稳定行尾；文本文件一律 LF 入库
|
||||||
|
*.gd text eol=lf
|
||||||
|
*.gdshader text eol=lf
|
||||||
|
*.tscn text eol=lf
|
||||||
|
*.tres text eol=lf
|
||||||
|
*.json text eol=lf
|
||||||
|
*.csv text eol=lf
|
||||||
|
*.cfg text eol=lf
|
||||||
|
*.yml text eol=lf
|
||||||
|
*.md text eol=lf
|
||||||
|
*.svg text eol=lf
|
||||||
|
.gitattributes text eol=lf
|
||||||
|
.gitignore text eol=lf
|
||||||
|
.gitkeep text eol=lf
|
||||||
|
project.godot text eol=lf
|
||||||
|
*.txt text eol=lf
|
||||||
|
*.ms text eol=lf
|
||||||
|
*.py text eol=lf
|
||||||
@@ -0,0 +1,99 @@
|
|||||||
|
# ============================================================================
|
||||||
|
# CI —— F《怨返》数据门（架构 §7.2；W1 激活部分）
|
||||||
|
#
|
||||||
|
# W1 激活：checkout → setup Godot 4.7.2 → headless import → SheetImporter
|
||||||
|
# import_all → schema validate → build 漂移门（git diff）
|
||||||
|
# W3 激活：GUT 单测（需先合入 gd-unit-testing addon） —— 见下方注释块
|
||||||
|
# W4 激活：headless sim 14 门报告（artifact） —— 见下方注释块
|
||||||
|
# W5 激活：Windows 导出 → artifact（templates + export_presets 补全）
|
||||||
|
#
|
||||||
|
# 待本机验证（4.7.x 超出训练数据）：
|
||||||
|
# - `godot --headless --path . --import` 的 4.7.2 实际行为（若失效改 -e --quit-after 200）
|
||||||
|
# - setup-godot@v1 对 4.7.2 版本串/模板的支持
|
||||||
|
# 首跑后按实际更新本文件与 README §5。
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
name: CI
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
data-gate:
|
||||||
|
name: data-gate（schema v0 数据门）
|
||||||
|
runs-on: windows-latest
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Godot 4.7.2
|
||||||
|
uses: chickensoft-games/setup-godot@v1
|
||||||
|
with:
|
||||||
|
version: 4.7.2
|
||||||
|
export-templates: false # W5 导出步骤再置 true
|
||||||
|
|
||||||
|
- name: Godot version sanity
|
||||||
|
run: godot --headless --version
|
||||||
|
|
||||||
|
# 首次 import：生成全局类缓存 + 资源导入（SheetImporter 才能被解析）
|
||||||
|
- name: Headless import
|
||||||
|
run: godot --headless --path . --import
|
||||||
|
|
||||||
|
# 数据门 1：CSV → build/*.json（schema 违规 = 中止 + 行号/列名/原因，退出码 1）
|
||||||
|
- name: SheetImporter import_all
|
||||||
|
run: godot --headless --path . -s res://src/tools/import_main.gd
|
||||||
|
|
||||||
|
# 数据门 2：build/*.json 对 schema 合规性
|
||||||
|
- name: Schema validate
|
||||||
|
run: godot --headless --path . -s res://src/tools/import_main.gd -- --validate-only
|
||||||
|
|
||||||
|
# 数据门 3：漂移门——改了 CSV 没重新生成提交 build = 红（"CI 生成并提交"纪律）
|
||||||
|
# 行尾由 .gitattributes 钉 LF，避免格式性误报
|
||||||
|
- name: Build drift check
|
||||||
|
run: git diff --exit-code -- data/build/
|
||||||
|
shell: bash
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# W3 激活（前置：合入 gd-unit-testing addon 到 addons/gut/）：
|
||||||
|
# unit-tests:
|
||||||
|
# runs-on: windows-latest
|
||||||
|
# steps:
|
||||||
|
# - uses: actions/checkout@v4
|
||||||
|
# - uses: chickensoft-games/setup-godot@v1
|
||||||
|
# with: { version: "4.7.2", export-templates: false }
|
||||||
|
# - run: godot --headless --path . --import
|
||||||
|
# - run: godot --headless --path . -s res://addons/gut/gut_cmdln.gd
|
||||||
|
# -gtest=res://tests/unit -gexit
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# W4 激活（sim 14 门；W6 起门 #5/#10 设硬门，此前 informational）：
|
||||||
|
# sim-gates:
|
||||||
|
# runs-on: windows-latest
|
||||||
|
# steps:
|
||||||
|
# - uses: actions/checkout@v4
|
||||||
|
# - uses: chickensoft-games/setup-godot@v1
|
||||||
|
# with: { version: "4.7.2", export-templates: false }
|
||||||
|
# - run: godot --headless --path . --import
|
||||||
|
# - run: godot --headless --path . -s res://src/core/sim/sim_main.gd
|
||||||
|
# - uses: actions/upload-artifact@v4
|
||||||
|
# with: { name: sim-report, path: tests/sim_reports/ }
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# W5 激活（release tag：Windows 导出 → artifact → 人工上传 Steamworks）：
|
||||||
|
# export-windows:
|
||||||
|
# if: startsWith(github.ref, 'refs/tags/')
|
||||||
|
# runs-on: windows-latest
|
||||||
|
# steps:
|
||||||
|
# - uses: actions/checkout@v4
|
||||||
|
# - uses: chickensoft-games/setup-godot@v1
|
||||||
|
# with: { version: "4.7.2", export-templates: true }
|
||||||
|
# - run: godot --headless --path . --import
|
||||||
|
# - run: godot --headless --path . --export-release "Windows Desktop" build/wrath-of-the-dead.exe
|
||||||
|
# - uses: actions/upload-artifact@v4
|
||||||
|
# with: { name: windows-build, path: build/ }
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
+21
@@ -0,0 +1,21 @@
|
|||||||
|
# ---- Godot 4 ----
|
||||||
|
.godot/
|
||||||
|
/android/
|
||||||
|
.import/
|
||||||
|
|
||||||
|
# ---- 导出产物（架构 §2.1：data/build 是数据产物不受影响，见下方排除只锚根目录）----
|
||||||
|
/build/
|
||||||
|
*.exe
|
||||||
|
*.pck
|
||||||
|
*.dmg
|
||||||
|
*.app
|
||||||
|
*.zip
|
||||||
|
|
||||||
|
# ---- 系统垃圾 ----
|
||||||
|
.DS_Store
|
||||||
|
Thumbs.db
|
||||||
|
desktop.ini
|
||||||
|
|
||||||
|
# ---- 编辑器临时 ----
|
||||||
|
*.tmp
|
||||||
|
*.bak
|
||||||
@@ -0,0 +1,74 @@
|
|||||||
|
# CLAUDE.md —— F《WRATH OF THE DEAD / 怨返》工程偏好
|
||||||
|
|
||||||
|
> 由 `docs/architecture/2026-10-19-F-architecture.md`（v1.0）派生 · 2026-10-19 · W1
|
||||||
|
> 本文件为工程宪法摘要；**冲突时以架构文档为准**；架构更新须两边同步。目标 ≤100 行。
|
||||||
|
|
||||||
|
## 引擎版本纪律
|
||||||
|
|
||||||
|
- **钉 Godot 4.7.x 补丁线，当前 4.7.2**（`project.godot` config/features）；小版本补丁可升，**跨 minor（4.8）上线后不追**；
|
||||||
|
- GDScript + GodotSteam **v4.23.1**（GDExtension 构建必须与 4.7.x 匹配；升级引擎 = 重新获取匹配构建）；
|
||||||
|
- renderer：`gl_compatibility`（2D 合成 + 核显底线；改 renderer = ADR 级动作）；
|
||||||
|
- ⚠ **知识缺口**：4.7.x 超出训练数据。API 不确定 → 先查官方文档/探针实测，**不臆造 API**；缺口持续标注，`docs/engine-reference/` 待补（架构 §11 P0）。
|
||||||
|
|
||||||
|
## 路径作用域编码标准（架构 §2.2）
|
||||||
|
|
||||||
|
| 作用域 | 纪律 |
|
||||||
|
|---|---|
|
||||||
|
| `src/core/` | 纯逻辑；禁 `extends Node`/访问场景树；`tick()` 零分配；100% 被 sim 与 GUT 无头复用 |
|
||||||
|
| `src/game/` | 唯一权威状态持有者；系统在此 tick；不直连 Steam（走 platform/）；不碰渲染 |
|
||||||
|
| `src/presentation/` | **只读快照 + 发命令**；UI 不持有游戏状态（仅视图本地态）；禁反向写 core |
|
||||||
|
| `src/platform/` | Steam API 唯一出口；`game/` 禁直调 `Steam.*` |
|
||||||
|
| `src/tools/` | `@tool` 标注；CI 可 headless；运行时场景禁引用 |
|
||||||
|
| `data/` | 零代码；稳定字符串 ID；**不重编号**；schema 违规 = CI 红 |
|
||||||
|
| `pipeline/` | 契约 = 命名 + 导出参数；唯一逐资产代码 = sprite 路径 |
|
||||||
|
| network | **不适用**：单人买断无网络代码 |
|
||||||
|
|
||||||
|
依赖方向：`presentation → game → core`；`game → platform`；`tools → data`。禁反向、禁跨层。
|
||||||
|
|
||||||
|
## 数据驱动红线（架构 §9.2 + ADR-3）
|
||||||
|
|
||||||
|
1. 零硬编码：一切数值进 `data/sheets/` → JSON → Resource；
|
||||||
|
2. **新资产 = 加行**；唯一逐资产代码 = `GeneratorDef.sprite_row`；
|
||||||
|
3. 新增资产若需改代码 = **设计失败，回退重做**；
|
||||||
|
4. 稳定 ID 永不重编号/复用；schema 违规 = CI 红（行号+列名+原因，禁跳过坏行）；
|
||||||
|
5. 数值列禁千分位；`_cn/_en` 本地化后缀；引用列填目标 ID；
|
||||||
|
6. "AI 让加一个班底变便宜了"禁用作加范围理由。
|
||||||
|
|
||||||
|
## ADR 一句话（架构 §8，均已接受）
|
||||||
|
|
||||||
|
- **ADR-1**：预渲染 2 朝向 billboard，不用实时 3D（用户比较优势在批渲染）；
|
||||||
|
- **ADR-2**：单趟 fused 全屏后处理 shader（posterize→LUT→纸纹→暗角），UI 层在其上；
|
||||||
|
- **ADR-3**：美术数据行纪律（新资产=加行；唯一逐资产代码 = sprite 路径）；
|
||||||
|
- **ADR-4**：AI 仅内部使用（mood board/概念），不进包体、不出厂、商店页披露填 No。
|
||||||
|
|
||||||
|
## 探针状态（W1）
|
||||||
|
|
||||||
|
| 探针 | 状态 | 手册 / 结论 |
|
||||||
|
|---|---|---|
|
||||||
|
| P1 SCREEN_TEXTURE/CanvasLayer | ⏳ 待用户实测 | `docs/engineering/2026-10-19-f-w1-probe-p1-manual.md` → `docs/engineering/probes/P1-result.md` |
|
||||||
|
| P3 noise seamless 平铺 | ⏳ 待用户实测 | `docs/engineering/2026-10-19-f-w1-probe-p3-manual.md` → `docs/engineering/probes/P3-result.md` |
|
||||||
|
| P6 字体许可 / P7 用户 GPU | ⏳ 用户侧任务（W1） | 不在本仓库；结论回填 probes/ |
|
||||||
|
| P2/P4/P5/P8-P11 | 未启动 | 架构 §11 排期（W2-W5） |
|
||||||
|
|
||||||
|
**不过的回退**：P1 → SubViewport+BackBufferCopy（+2-4h）；P3 → 脚本预烘焙无缝纹理（+0.5-1h）。
|
||||||
|
|
||||||
|
## 常用命令
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 数据门（导入 + 校验）
|
||||||
|
godot --headless --path . --import
|
||||||
|
godot --headless --path . -s res://src/tools/import_main.gd # import_all
|
||||||
|
godot --headless --path . -s res://src/tools/import_main.gd -- --validate-only
|
||||||
|
# 运行：编辑器 F5（main scene W2 起）；探针：打开 tests/probe_* 场景 F6
|
||||||
|
```
|
||||||
|
|
||||||
|
## 数据管线速查
|
||||||
|
|
||||||
|
`data/sheets/*.csv` →（SheetImporter，本仓库 `src/tools/`）→ `data/build/*.json`（提交）→（W3 `.tres`）→ DataRegistry。
|
||||||
|
单向流动：游戏永不写 `data/`；sim 与游戏读同一份 build。契约见 `README.md` + 架构 §3。
|
||||||
|
|
||||||
|
## 纪律提醒
|
||||||
|
|
||||||
|
- 写代码前**先写测试**（GUT W3 起）；每个 Story 留测试证据路径；
|
||||||
|
- 高影响动作（提交/删除/上线）须用户审批；本仓库 `git` 提交信息写架构基线；
|
||||||
|
- 目录微调 = 架构 §2.1 变更 = ADR 流程，不擅自挪目录。
|
||||||
@@ -0,0 +1,93 @@
|
|||||||
|
# WRATH OF THE DEAD / 怨返（项目代号 F）
|
||||||
|
|
||||||
|
> 含冤而死，那就招一支阴兵，杀回人间。
|
||||||
|
> Wrongfully dead? Raise a ghost army and fight your way back to the living world.
|
||||||
|
|
||||||
|
单人挂机（idle）· Godot 4.7.2 + GDScript · Zad Archery 式横版 · 水墨绘卷视觉
|
||||||
|
架构基线：`docs/architecture/2026-10-19-F-architecture.md`（v1.0，2026-10-19）
|
||||||
|
工程宪法摘要：`CLAUDE.md`（必读）
|
||||||
|
|
||||||
|
## 1. 环境要求
|
||||||
|
|
||||||
|
| 项 | 要求 | 备注 |
|
||||||
|
|---|---|---|
|
||||||
|
| 引擎 | **Godot 4.7.2**（.NET 不需要，纯 GDScript） | 钉 4.7.x 补丁线；跨 minor 不追 |
|
||||||
|
| 导出模板 | 4.7.2 stable 模板（W5 CI 打包前安装） | Editor → Manage Export Templates |
|
||||||
|
| Steam | GodotSteam v4.23.1（W5 接入，W1 不依赖） | addon 二进制暂未入库 |
|
||||||
|
| GPU | 核显可跑（性能底线 30fps） | 用户 GPU 实测定预算（探针 P7） |
|
||||||
|
|
||||||
|
## 2. 快速开始
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1) 编辑器打开本目录（project.godot）→ 等待首次资源导入
|
||||||
|
# 2) 数据门验证（headless）
|
||||||
|
godot --headless --path . --import
|
||||||
|
godot --headless --path . -s res://src/tools/import_main.gd # import_all（期望 RESULT: PASS）
|
||||||
|
godot --headless --path . -s res://src/tools/import_main.gd -- --validate-only
|
||||||
|
# 3) 跑探针：编辑器打开 tests/probe_p1_screen_texture/probe_p1.tscn → F6
|
||||||
|
# （main scene 自 W2 起由 game/ 编排层提供，F5 直接运行）
|
||||||
|
git status # import_all 后 data/build 应无 diff（提交物已校准）
|
||||||
|
```
|
||||||
|
|
||||||
|
## 3. 仓库地图（架构 §2.1）
|
||||||
|
|
||||||
|
```
|
||||||
|
project.godot / export_presets.cfg / icon.svg / CLAUDE.md
|
||||||
|
data/sheets/*.csv 内容唯一源（策划维护；一行=一资产/一参数）
|
||||||
|
data/schema/*.json 每张表一份 JSON Schema（CI 数据门）
|
||||||
|
data/build/*.json SheetImporter 产物（提交；sim 与游戏共用）
|
||||||
|
src/core/ 纯逻辑：numbers / economy / save / sim（W3 起）
|
||||||
|
src/game/ 编排层：GameState / DataRegistry / 各 Director
|
||||||
|
src/platform/ SteamService（W5）
|
||||||
|
src/presentation/ 表现层：stage / hud / panels / modals / post
|
||||||
|
src/tools/ @tool：sheet_importer.gd + import_main.gd（CI 入口）
|
||||||
|
assets/ sprites / luts / shaders / themes / fonts
|
||||||
|
tests/ probe_*（W1）/ unit（W3 起）/ sim_reports（W4 起）
|
||||||
|
pipeline/ 3ds Max 侧契约（README.md；Max 脚本用户主场）
|
||||||
|
.github/workflows/ CI 数据门（W3+ 激活单测/sim/导出）
|
||||||
|
```
|
||||||
|
|
||||||
|
## 4. 数据管线（"年更=加行"的地基，架构 §3）
|
||||||
|
|
||||||
|
```
|
||||||
|
data/sheets/*.csv ──SheetImporter（src/tools/，@tool/CI headless）──► data/build/*.json
|
||||||
|
│ schema 校验（违规=中止+行号/列名/原因）
|
||||||
|
▼（W3）
|
||||||
|
*.tres Resource ──► DataRegistry ──► 游戏 + sim（同一份，零漂移）
|
||||||
|
```
|
||||||
|
|
||||||
|
- 三条铁律：① 单向流动（游戏永不写 `data/`）；② sim 与游戏读同一份 build；③ 数值改动**只改 CSV 不动代码**；
|
||||||
|
- CSV 规范：稳定字符串 ID（不重编号）；`_cn/_en` 后缀；数值列禁千分位；引用列填目标 ID；
|
||||||
|
- build JSON 由导入器的确定性序列化器生成（字节稳定）——**改 CSV 后必须重跑 import 并提交 build**，否则 CI 漂移门红；
|
||||||
|
- **W1 已知**：`display_en` 为工程侧临时译名（待文策渊按 GDD §8.4 glossary 确认）；`unlock_hall/unlock_gate` 引用的 halls/upgrades 表 W2 落盘后激活跨表引用校验。
|
||||||
|
|
||||||
|
## 5. CI（架构 §7.2）
|
||||||
|
|
||||||
|
`.github/workflows/ci.yml`：push/PR → checkout → setup Godot 4.7.2 → headless import → `import_all` → schema `validate` → build 漂移门（git diff）。
|
||||||
|
单元测试（W3，GUT）、sim 14 门（W4）、Windows 导出（W5）为注释占位，标注了激活条件。
|
||||||
|
**待本机验证**：4.7.2 的 `--headless --import` CLI 行为（备选 `-e --quit-after 200`）——首跑后按实际更新本 README。
|
||||||
|
|
||||||
|
## 6. W1 探针（用户侧实测，30min/项）
|
||||||
|
|
||||||
|
| 探针 | 手册（工作区 docs/engineering/） | 回填 |
|
||||||
|
|---|---|---|
|
||||||
|
| P1 后处理纹理语义 | `2026-10-19-f-w1-probe-p1-manual.md` | `docs/engineering/probes/P1-result.md` |
|
||||||
|
| P3 noise 平铺 | `2026-10-19-f-w1-probe-p3-manual.md` | `docs/engineering/probes/P3-result.md` |
|
||||||
|
|
||||||
|
P6（字体许可）/P7（GPU）为用户侧任务，结论同样回填 probes/。
|
||||||
|
|
||||||
|
## 7. 纪律速览（详见 CLAUDE.md / 架构 §9）
|
||||||
|
|
||||||
|
- look-dev 冻结（W2 生死门）：冻结前不加新资产类型；Max 侧不回炉；调色只在 Godot 侧；
|
||||||
|
- 水墨四色面积纪律：墨 ~65 / 骨白 ~25 / 朱砂 ≤8% / 靛 ≤7%；
|
||||||
|
- 终局 ≤1e14；三乘区加法优先禁乘性深度叠加；
|
||||||
|
- network 作用域不适用（单人无网络代码）；AI 不进包体（ADR-4）。
|
||||||
|
|
||||||
|
## 8. W1 状态与待办
|
||||||
|
|
||||||
|
- [x] 项目骨架 + git 首提交（本 README 同步日期）
|
||||||
|
- [x] 数据管线段 1（generators.csv 12 行 + schema v0 + SheetImporter v0.1 + build 提交）
|
||||||
|
- [x] 探针 P1/P3 代码 + 实测手册 + 结论模板
|
||||||
|
- [ ] 用户：跑 P1/P3 实测并回填结论；P6/P7 用户侧任务
|
||||||
|
- [ ] 用户：look-dev 游魂初版（Max 侧）→ 导入验证 sprite_row 路径
|
||||||
|
- [ ] W2 计划：管线贯通 demo（CSV→12 槽 UI）、sim 骨架、军列带纸面原型
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# assets/fonts —— 子集化 OFL 字体（LXGW WenKai/Ma Shan Zheng 标题 + Noto Sans SC 正文 + JetBrains Mono 数字）。P6 许可复核后落盘；子集脚本 pipeline/fonts/（架构 §7.4）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# assets/luts —— per-hall LUT PNG（tools/lut_generator.gd 产物，64×1）。W4 起（架构 §5.3）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# assets/shaders —— 后处理 fused shader / 母题 shader / 单位描边兜底。探针 P1 通过后落盘（架构 §5.2）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# assets/sprites/units —— billboard 精灵：2 朝向×2 帧 + units_atlas.png（MultiMesh）。Max 侧批量渲染产物（pipeline/ 契约）；look-dev 游魂 W1-2 首片。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# assets/sprites/vfx —— 墨点/笔触/斩弧（管线报告 §1.2）。W6 juice 最小集。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# assets/themes —— 水墨 Theme（界格/卷轴/印章语言；禁圆角卡片/默认组件蓝）。W4-W6（GDD §7.2④）。
|
||||||
@@ -0,0 +1,149 @@
|
|||||||
|
{
|
||||||
|
"sheet": "generators",
|
||||||
|
"schema_version": 0,
|
||||||
|
"columns": [
|
||||||
|
"id",
|
||||||
|
"display_cn",
|
||||||
|
"display_en",
|
||||||
|
"base_cost",
|
||||||
|
"cost_ratio",
|
||||||
|
"base_rate",
|
||||||
|
"unlock_hall",
|
||||||
|
"unlock_gate",
|
||||||
|
"sprite_row"
|
||||||
|
],
|
||||||
|
"rows": [
|
||||||
|
{
|
||||||
|
"id": "gen_01_youhun",
|
||||||
|
"display_cn": "游魂",
|
||||||
|
"display_en": "Wandering Souls",
|
||||||
|
"base_cost": 15,
|
||||||
|
"cost_ratio": 1.13,
|
||||||
|
"base_rate": 0.1,
|
||||||
|
"unlock_hall": "none",
|
||||||
|
"unlock_gate": "none",
|
||||||
|
"sprite_row": "res://assets/sprites/units/gen_01_youhun"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "gen_02_yinbing",
|
||||||
|
"display_cn": "阴兵",
|
||||||
|
"display_en": "Ghost Soldiers",
|
||||||
|
"base_cost": 120,
|
||||||
|
"cost_ratio": 1.14,
|
||||||
|
"base_rate": 1,
|
||||||
|
"unlock_hall": "none",
|
||||||
|
"unlock_gate": "none",
|
||||||
|
"sprite_row": "res://assets/sprites/units/gen_02_yinbing"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "gen_03_guizu",
|
||||||
|
"display_cn": "鬼卒班",
|
||||||
|
"display_en": "Ghost Constables",
|
||||||
|
"base_cost": 1200,
|
||||||
|
"cost_ratio": 1.15,
|
||||||
|
"base_rate": 8,
|
||||||
|
"unlock_hall": "hall_01_qinguang",
|
||||||
|
"unlock_gate": "up_gate_guizu",
|
||||||
|
"sprite_row": "res://assets/sprites/units/gen_03_guizu"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "gen_04_biliao",
|
||||||
|
"display_cn": "勾魂笔僚",
|
||||||
|
"display_en": "Death-Scribe Clerks",
|
||||||
|
"base_cost": 12000,
|
||||||
|
"cost_ratio": 1.15,
|
||||||
|
"base_rate": 50,
|
||||||
|
"unlock_hall": "hall_02_chujiang",
|
||||||
|
"unlock_gate": "up_gate_biliao",
|
||||||
|
"sprite_row": "res://assets/sprites/units/gen_04_biliao"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "gen_05_tangpu",
|
||||||
|
"display_cn": "孟婆汤铺",
|
||||||
|
"display_en": "Meng Po's Soup Stall",
|
||||||
|
"base_cost": 120000,
|
||||||
|
"cost_ratio": 1.16,
|
||||||
|
"base_rate": 400,
|
||||||
|
"unlock_hall": "hall_03_songdi",
|
||||||
|
"unlock_gate": "up_gate_tangpu",
|
||||||
|
"sprite_row": "res://assets/sprites/units/gen_05_tangpu"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "gen_06_nanmin",
|
||||||
|
"display_cn": "枉死城难民团",
|
||||||
|
"display_en": "Refugee Camp of the Wrongfully Dead",
|
||||||
|
"base_cost": 1200000,
|
||||||
|
"cost_ratio": 1.16,
|
||||||
|
"base_rate": 3000,
|
||||||
|
"unlock_hall": "hall_04_wuguan",
|
||||||
|
"unlock_gate": "up_gate_nanmin",
|
||||||
|
"sprite_row": "res://assets/sprites/units/gen_06_nanmin"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "gen_07_shuban",
|
||||||
|
"display_cn": "阴律司书办",
|
||||||
|
"display_en": "Clerks of the Nether Court",
|
||||||
|
"base_cost": 12000000,
|
||||||
|
"cost_ratio": 1.17,
|
||||||
|
"base_rate": 24000,
|
||||||
|
"unlock_hall": "hall_05_yama",
|
||||||
|
"unlock_gate": "up_gate_shuban",
|
||||||
|
"sprite_row": "res://assets/sprites/units/gen_07_shuban"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "gen_08_bingfang",
|
||||||
|
"display_cn": "幽都兵坊",
|
||||||
|
"display_en": "Armory of the Dark Capital",
|
||||||
|
"base_cost": 120000000,
|
||||||
|
"cost_ratio": 1.17,
|
||||||
|
"base_rate": 180000,
|
||||||
|
"unlock_hall": "hall_06_biancheng",
|
||||||
|
"unlock_gate": "up_gate_bingfang",
|
||||||
|
"sprite_row": "res://assets/sprites/units/gen_08_bingfang"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "gen_09_wodi",
|
||||||
|
"display_cn": "十殿卧底",
|
||||||
|
"display_en": "Sleeper Agents in the Ten Courts",
|
||||||
|
"base_cost": 1200000000,
|
||||||
|
"cost_ratio": 1.18,
|
||||||
|
"base_rate": 1400000,
|
||||||
|
"unlock_hall": "hall_07_taishan",
|
||||||
|
"unlock_gate": "up_gate_wodi",
|
||||||
|
"sprite_row": "res://assets/sprites/units/gen_09_wodi"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "gen_10_xingzhe",
|
||||||
|
"display_cn": "轮回裂隙行者",
|
||||||
|
"display_en": "Rift Walkers of the Wheel",
|
||||||
|
"base_cost": 12000000000,
|
||||||
|
"cost_ratio": 1.18,
|
||||||
|
"base_rate": 11000000,
|
||||||
|
"unlock_hall": "hall_08_dushi",
|
||||||
|
"unlock_gate": "up_gate_xingzhe",
|
||||||
|
"sprite_row": "res://assets/sprites/units/gen_10_xingzhe"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "gen_11_yinhun",
|
||||||
|
"display_cn": "六道引魂人",
|
||||||
|
"display_en": "Soul Guides of the Six Paths",
|
||||||
|
"base_cost": 120000000000,
|
||||||
|
"cost_ratio": 1.19,
|
||||||
|
"base_rate": 85000000,
|
||||||
|
"unlock_hall": "hall_09_pingdeng",
|
||||||
|
"unlock_gate": "up_gate_yinhun",
|
||||||
|
"sprite_row": "res://assets/sprites/units/gen_11_yinhun"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "gen_12_tianzi",
|
||||||
|
"display_cn": "幽冥天子",
|
||||||
|
"display_en": "Emperor of the Netherworld",
|
||||||
|
"base_cost": 1200000000000,
|
||||||
|
"cost_ratio": 1.2,
|
||||||
|
"base_rate": 650000000,
|
||||||
|
"unlock_hall": "none",
|
||||||
|
"unlock_gate": "up_gate_tianzi",
|
||||||
|
"sprite_row": "res://assets/sprites/units/gen_12_tianzi"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,84 @@
|
|||||||
|
{
|
||||||
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
||||||
|
"$id": "generators.schema.json",
|
||||||
|
"title": "generators 表 schema v0（十二班底发生器，数值抄录自 GDD §3.1）",
|
||||||
|
"description": "架构 §3.2 CSV 规范落盘。数值列禁千分位；引用列填目标 ID 或 none；ID 一旦分配永不重编号。v0 仅做单表校验：unlock_hall/unlock_gate 引用的 halls.csv / upgrades.csv 目标表 W2 落盘，届时激活跨表引用完整性校验。",
|
||||||
|
"x-supported-keywords": [
|
||||||
|
"type", "properties", "required", "items", "enum", "pattern",
|
||||||
|
"minimum", "maximum", "minLength", "minItems", "maxItems",
|
||||||
|
"additionalProperties", "const"
|
||||||
|
],
|
||||||
|
"x-unique": ["id"],
|
||||||
|
"type": "object",
|
||||||
|
"required": ["sheet", "schema_version", "columns", "rows"],
|
||||||
|
"properties": {
|
||||||
|
"sheet": { "const": "generators" },
|
||||||
|
"schema_version": { "const": 0 },
|
||||||
|
"columns": {
|
||||||
|
"type": "array",
|
||||||
|
"items": { "type": "string" },
|
||||||
|
"minItems": 9
|
||||||
|
},
|
||||||
|
"rows": {
|
||||||
|
"type": "array",
|
||||||
|
"minItems": 12,
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"required": [
|
||||||
|
"id", "display_cn", "display_en", "base_cost",
|
||||||
|
"cost_ratio", "base_rate", "unlock_hall", "unlock_gate", "sprite_row"
|
||||||
|
],
|
||||||
|
"properties": {
|
||||||
|
"id": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^gen_[0-9]{2}_[a-z0-9]+$",
|
||||||
|
"description": "稳定字符串 ID；永不重编号、永不复用（年更=加行）"
|
||||||
|
},
|
||||||
|
"display_cn": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1,
|
||||||
|
"description": "简体名（GDD §3.1 班底名）"
|
||||||
|
},
|
||||||
|
"display_en": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1,
|
||||||
|
"description": "英文名——W1 工程侧临时译名，待文策渊按 GDD §8.4 glossary 口径确认后回填"
|
||||||
|
},
|
||||||
|
"base_cost": {
|
||||||
|
"type": "number",
|
||||||
|
"minimum": 1,
|
||||||
|
"description": "C0（GDD §3.1）；整数写法，禁千分位与 K/M/B/T 后缀"
|
||||||
|
},
|
||||||
|
"cost_ratio": {
|
||||||
|
"type": "number",
|
||||||
|
"minimum": 1,
|
||||||
|
"maximum": 2,
|
||||||
|
"description": "r（1.13→1.20，GDD §3.1）"
|
||||||
|
},
|
||||||
|
"base_rate": {
|
||||||
|
"type": "number",
|
||||||
|
"minimum": 0,
|
||||||
|
"description": "rate/s（GDD §3.1）；阴德/秒"
|
||||||
|
},
|
||||||
|
"unlock_hall": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^(none|hall_[0-9]{2}_[a-z]+)$",
|
||||||
|
"description": "殿门闸门 ID（halls.csv 行 ID）或 none"
|
||||||
|
},
|
||||||
|
"unlock_gate": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^(none|up_gate_[a-z0-9_]+)$",
|
||||||
|
"description": "路引闸门 ID（upgrades.csv 行 ID）或 none；gen_12 的敕封前置（宿慧≥60 且转世≥2）属 upgrades.csv 行内规则，W2 建模"
|
||||||
|
},
|
||||||
|
"sprite_row": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^res://assets/sprites/[a-z_]+/[a-z0-9_]+$",
|
||||||
|
"description": "★ ADR-3：唯一允许的逐资产代码 = sprite 路径前缀（Max 侧命名 <unit_id>_<l|r>_<frame>.png）"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
id,display_cn,display_en,base_cost,cost_ratio,base_rate,unlock_hall,unlock_gate,sprite_row
|
||||||
|
gen_01_youhun,游魂,Wandering Souls,15,1.13,0.1,none,none,res://assets/sprites/units/gen_01_youhun
|
||||||
|
gen_02_yinbing,阴兵,Ghost Soldiers,120,1.14,1,none,none,res://assets/sprites/units/gen_02_yinbing
|
||||||
|
gen_03_guizu,鬼卒班,Ghost Constables,1200,1.15,8,hall_01_qinguang,up_gate_guizu,res://assets/sprites/units/gen_03_guizu
|
||||||
|
gen_04_biliao,勾魂笔僚,Death-Scribe Clerks,12000,1.15,50,hall_02_chujiang,up_gate_biliao,res://assets/sprites/units/gen_04_biliao
|
||||||
|
gen_05_tangpu,孟婆汤铺,Meng Po's Soup Stall,120000,1.16,400,hall_03_songdi,up_gate_tangpu,res://assets/sprites/units/gen_05_tangpu
|
||||||
|
gen_06_nanmin,枉死城难民团,Refugee Camp of the Wrongfully Dead,1200000,1.16,3000,hall_04_wuguan,up_gate_nanmin,res://assets/sprites/units/gen_06_nanmin
|
||||||
|
gen_07_shuban,阴律司书办,Clerks of the Nether Court,12000000,1.17,24000,hall_05_yama,up_gate_shuban,res://assets/sprites/units/gen_07_shuban
|
||||||
|
gen_08_bingfang,幽都兵坊,Armory of the Dark Capital,120000000,1.17,180000,hall_06_biancheng,up_gate_bingfang,res://assets/sprites/units/gen_08_bingfang
|
||||||
|
gen_09_wodi,十殿卧底,Sleeper Agents in the Ten Courts,1200000000,1.18,1400000,hall_07_taishan,up_gate_wodi,res://assets/sprites/units/gen_09_wodi
|
||||||
|
gen_10_xingzhe,轮回裂隙行者,Rift Walkers of the Wheel,12000000000,1.18,11000000,hall_08_dushi,up_gate_xingzhe,res://assets/sprites/units/gen_10_xingzhe
|
||||||
|
gen_11_yinhun,六道引魂人,Soul Guides of the Six Paths,120000000000,1.19,85000000,hall_09_pingdeng,up_gate_yinhun,res://assets/sprites/units/gen_11_yinhun
|
||||||
|
gen_12_tianzi,幽冥天子,Emperor of the Netherworld,1200000000000,1.20,650000000,none,up_gate_tianzi,res://assets/sprites/units/gen_12_tianzi
|
||||||
|
@@ -0,0 +1,46 @@
|
|||||||
|
; ============================================================================
|
||||||
|
; export_presets.cfg —— W1 占位版本
|
||||||
|
; 主预设：Windows Desktop x86_64（架构 §7.1）；macOS/Linux 次预设 W5 补。
|
||||||
|
; 本文件为手工最小占位；W5 CI 打包前用编辑器 Project > Export 向导重新生成校准
|
||||||
|
; （4.7 选项键以编辑器实际导出为准——4.7.x 超出训练数据，此处仅保证可解析）。
|
||||||
|
; 导出模板：Godot 4.7.2 stable 导出模板（Editor > Manage Export Templates）。
|
||||||
|
; ============================================================================
|
||||||
|
|
||||||
|
[preset.0]
|
||||||
|
|
||||||
|
name="Windows Desktop"
|
||||||
|
platform="Windows Desktop"
|
||||||
|
runnable=true
|
||||||
|
advanced_settings=false
|
||||||
|
dedicated_server=false
|
||||||
|
custom_features=""
|
||||||
|
export_filter="all_resources"
|
||||||
|
include_filter=""
|
||||||
|
exclude_filter=""
|
||||||
|
export_path="build/wrath-of-the-dead.exe"
|
||||||
|
patches=PackedStringArray()
|
||||||
|
encryption_include_filters=""
|
||||||
|
encryption_exclude_filters=""
|
||||||
|
seed=0
|
||||||
|
encrypt_pck=false
|
||||||
|
encrypt_directory=false
|
||||||
|
|
||||||
|
[preset.0.options]
|
||||||
|
|
||||||
|
custom_template/debug=""
|
||||||
|
custom_template/release=""
|
||||||
|
binary_format/architecture="x86_64"
|
||||||
|
texture_format/bptc=true
|
||||||
|
texture_format/s3tc=true
|
||||||
|
texture_format/etc=false
|
||||||
|
texture_format/etc2=false
|
||||||
|
application/modify_resources=true
|
||||||
|
application/icon=""
|
||||||
|
application/file_version=""
|
||||||
|
application/product_version=""
|
||||||
|
application/company_name=""
|
||||||
|
application/product_name="WRATH OF THE DEAD"
|
||||||
|
application/file_description=""
|
||||||
|
application/copyright=""
|
||||||
|
application/trademarks=""
|
||||||
|
ssh_remote_deploy/enabled=false
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128">
|
||||||
|
<rect width="128" height="128" fill="#1A1614"/>
|
||||||
|
<circle cx="64" cy="64" r="36" fill="none" stroke="#EDE6D8" stroke-width="7"/>
|
||||||
|
<path d="M64 22 v84 M22 64 h84" stroke="#B03A2E" stroke-width="5"/>
|
||||||
|
<circle cx="64" cy="64" r="6" fill="#B03A2E"/>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 345 B |
@@ -0,0 +1,48 @@
|
|||||||
|
# pipeline/ —— 3ds Max 侧协作契约（工程侧规格，用户主场）
|
||||||
|
|
||||||
|
> 架构依据：`docs/architecture/2026-10-19-F-architecture.md` §7.3 ｜ 撰写：程基岩（W1）
|
||||||
|
> **边界纪律**：本目录是**契约**不是实现——`batch_render.ms` / `asset_manifest.csv` 由用户（3ds Max 侧）实现；工程侧只消费资产不碰 Max。Max 侧交片后不回炉（除造型错误）；所有调色动作只在 Godot 侧（ADR-1 / 架构 §9.1 C2）。
|
||||||
|
|
||||||
|
## 1. 命名约定（与 `data/sheets/generators.csv` 的 `sprite_row` 对齐）
|
||||||
|
|
||||||
|
```
|
||||||
|
<unit_id>_<朝向>_<帧>.png
|
||||||
|
```
|
||||||
|
|
||||||
|
- `<unit_id>` = `generators.csv` 的 `id` 列（如 `gen_01_youhun`）——**新单位先在 CSV 加行，再出图**（ADR-3：新资产 = 加行）；
|
||||||
|
- `<朝向>`：`l`（面左）/ `r`（面右）——军列向右推进时用 `r`，殿王战主角提刀用 `l`；
|
||||||
|
- `<帧>`：`0`（站立）/ `1`（行军起伏）——MVP 每朝向 2 帧（架构 §5.1）；
|
||||||
|
- 示例：`gen_01_youhun_r_0.png`、`gen_03_guizu_l_1.png`；
|
||||||
|
- 交付位置：`assets/sprites/units/`（本仓库）；图集打包在 W2+ 由 `tools/` 侧脚本合 `units_atlas.png` + UV manifest。
|
||||||
|
|
||||||
|
## 2. 规格（每片必守）
|
||||||
|
|
||||||
|
| 项 | 规格 | 依据 |
|
||||||
|
|---|---|---|
|
||||||
|
| 世界尺度 | 统一身高尺度：单位 256px 画布 ≈ 统一世界高度（十殿单位同尺度） | 架构 §5.1 |
|
||||||
|
| 轴心 | 统一**脚底轴心**（bottom-center） | 架构 §5.1 |
|
||||||
|
| 尺寸档 | 单位 256×256 / 殿王·套件 512×512 / 商店 hero 1024×1024 | 架构 §5.1 |
|
||||||
|
| 格式 | PNG 32-bit **直通 alpha**（不做预乘、不烘背景） | 架构 §5.1 |
|
||||||
|
| 上色 | Ink'n'Paint **3 阶平色** + 墨黑 `#1A1614` 描边**一带**（粗细一致 ±1px @256） | 架构 §9.1 冻结评审 #6 |
|
||||||
|
| 描边写入 | 描边烘焙进 sprite（主方案）；P2 探针复核 alpha 边缘 halo | 架构 §11 P2 |
|
||||||
|
| 面数/灯光 | primitive 摆件 + 三灯即可；不追求写实 | 管线报告 §1.2 |
|
||||||
|
| 剪影 | 可读剪影优先（评审 #3）；刑典母题走剪影 + 文字暗示（GDD §0.3 IP 红线） | GDD §0.3 |
|
||||||
|
|
||||||
|
## 3. look-dev 三件套（W1-2 生死门，架构 §10.1）
|
||||||
|
|
||||||
|
1. **一单位**：游魂 `gen_01_youhun`，2 朝向 × 2 帧，256×256；
|
||||||
|
2. **一背景**：第 1 殿秦广王 band（远景水墨 shader 层 + 中景剪影套件 3-5 件 + 近景地面）——背景层为**程序化 shader**（架构 §5.3），Max 侧只出剪影套件；
|
||||||
|
3. **一殿王**：秦广王 512×512。
|
||||||
|
|
||||||
|
完整 shader 堆栈在线后走 §10.1 十项冻结评审（签字 + 参数快照 + 截图入 `docs/engineering/`）。
|
||||||
|
|
||||||
|
## 4. `asset_manifest.csv`（用户侧维护，建议列）
|
||||||
|
|
||||||
|
`id, name, variant, size, has_left, has_right, frames, notes` —— 与 `generators.csv` 同 ID 口径； batch_render.ms 从本清单读批量出图。
|
||||||
|
|
||||||
|
## 5. W1 状态
|
||||||
|
|
||||||
|
- [x] 契约文档（本文件）；
|
||||||
|
- [ ] `batch_render.ms`（用户，2-4h 一次性投入）；
|
||||||
|
- [ ] `asset_manifest.csv`（用户，随首单位建立）；
|
||||||
|
- [ ] look-dev 首单位 `gen_01_youhun` 初版（用户）+ 导入 Godot 可见（工程侧验收：sprite_row 路径即）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# pipeline/maxscript —— batch_render.ms + asset_manifest.csv 属用户（3ds Max 侧）任务；本目录在 W1 留空。契约见 ../README.md（架构 §7.3）。
|
||||||
@@ -0,0 +1,37 @@
|
|||||||
|
; Engine configuration file.
|
||||||
|
; ============================================================================
|
||||||
|
; F《WRATH OF THE DEAD / 怨返》—— Godot 4.7.x 补丁线（当前钉 4.7.2）
|
||||||
|
; 架构基线：docs/architecture/2026-10-19-F-architecture.md §7.1（W1 落盘）
|
||||||
|
; 纪律：小版本补丁可升；跨 minor（4.8）上线后不追。
|
||||||
|
; 知识缺口声明：4.7.x 超出训练数据范围——本文件键名均为 Godot 4.x 稳定键，
|
||||||
|
; 首次用编辑器打开时若有迁移/配置提示，记录到 docs/engineering/ 后同步更新本
|
||||||
|
; 文件与 CLAUDE.md；不要静默跨 minor。
|
||||||
|
; ============================================================================
|
||||||
|
|
||||||
|
config_version=5
|
||||||
|
|
||||||
|
[application]
|
||||||
|
|
||||||
|
config/name="WRATH OF THE DEAD"
|
||||||
|
config/description="Wrongfully dead? Raise a ghost army and fight your way back to the living world."
|
||||||
|
run/main_scene=""
|
||||||
|
config/features=PackedStringArray("4.7", "GL Compatibility")
|
||||||
|
config/icon="res://icon.svg"
|
||||||
|
|
||||||
|
[display]
|
||||||
|
|
||||||
|
window/size/viewport_width=1280
|
||||||
|
window/size/viewport_height=720
|
||||||
|
window/size/window_width_override=1280
|
||||||
|
window/size/window_height_override=720
|
||||||
|
window/stretch/mode="canvas_items"
|
||||||
|
window/stretch/aspect="expand"
|
||||||
|
|
||||||
|
[rendering]
|
||||||
|
|
||||||
|
renderer/rendering_method="gl_compatibility"
|
||||||
|
renderer/rendering_method.mobile="gl_compatibility"
|
||||||
|
2d/snap/snap_2d_transforms_to_pixel=true
|
||||||
|
2d/snap/snap_2d_vertices_to_pixel=true
|
||||||
|
textures/vram_compression/import_etc2_astc=true
|
||||||
|
textures/vram_compression/import_s3tc_bptc=true
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# src/core/economy —— 权威经济核心：EconomyState.tick() 10Hz 确定性；GeneratorDef/UpgradeDef Resource 数据行；MultiplierSet 三乘区；PrestigeModel；OfflineModel。W3 落盘（架构 §4.2）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# src/core/numbers —— BigNumber(double 封装 + ≤1e14 断言) / number_format(K/M/B/T + tabular)。W3 落盘（架构 §2.1/§4.2）。纪律：core 无 Node 依赖、零热路径分配。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# src/core/save —— save_game.gd（SAVE_VERSION + read/write）+ migration_registry.gd（版本链迁移，每迁移函数配单测）。W5 落盘（架构 §3.5/§6）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# src/core/sim —— 无头平衡模拟器：sim_main.gd（extends SceneTree）+ simulator.gd + strategies/ + gates.gd（14 门）。W2 骨架 / W4 首轮（架构 §10.3）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# src/game —— 编排层（唯一权威状态）：GameState / DataRegistry / EventDirector / UnlockDirector / BossBattle。W2-W6 落盘（架构 §2.3/§4）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# src/platform —— SteamService：GodotSteam v4.23.1 唯一封装。game/ 禁止直调 Steam.*。W5 落盘（架构 §6.4）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# src/presentation —— 表现层：只读快照 + 发命令；UI 不持有游戏状态。stage/hud/panels/modals/post 子域。W2 起落盘（架构 §5）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# src/presentation/hud —— HUD 条（阴德/秒、十殿小地图、下一目标进度条）。W4-W6（架构 §7.1/GDD §7.1）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# src/presentation/modals —— 绘卷语言模态：冤魂申诉竖卷 / 殿王战过场 / 转世 / 敕封。W6（架构 §7.1）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# src/presentation/panels —— 右滑抽屉：升级树（5 页签）/ 成就殿堂 / 冤案卡册。W4-W6（架构 §7.1）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# src/presentation/post —— post_process_rect.gd：单趟 fused 后处理载体（posterize→LUT→纸纹→暗角；UI 层其上）。P1 过后 W3-W4 落盘（架构 §5.2）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# src/presentation/stage —— stage_root.tscn / camera_rig.gd / hall_band.gd / army_band.gd / boss_arena.gd。W3 起落盘（架构 §4.3）。
|
||||||
@@ -0,0 +1,51 @@
|
|||||||
|
extends SceneTree
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# SheetImporter CLI 入口（CI headless / 编辑器外批量导入）
|
||||||
|
# 用法：
|
||||||
|
# godot --headless --path . -s res://src/tools/import_main.gd
|
||||||
|
# godot --headless --path . -s res://src/tools/import_main.gd -- --validate-only
|
||||||
|
# 退出码：0 = 无违规；1 = 有违规或异常（CI 数据门按此判红）
|
||||||
|
#
|
||||||
|
# 依赖：使用前先跑 `godot --headless --path . --import`（生成全局类缓存，
|
||||||
|
# 本脚本才能解析全局 class_name SheetImporter）。参见 .github/workflows/ci.yml。
|
||||||
|
#
|
||||||
|
# 注意：4.7.x 超出训练数据——`-s` + SceneTree 入口模式为 4.x 稳定模式；
|
||||||
|
# 若 4.7.2 行为变化，按实际报错修正并记录到 docs/engineering/。
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
func _initialize() -> void:
|
||||||
|
var user_args := OS.get_cmdline_user_args()
|
||||||
|
var all_args := OS.get_cmdline_args()
|
||||||
|
var validate_only := user_args.has("--validate-only") or all_args.has("--validate-only")
|
||||||
|
var code := 0
|
||||||
|
if validate_only:
|
||||||
|
code = _run_validate()
|
||||||
|
else:
|
||||||
|
code = _run_import()
|
||||||
|
quit(code)
|
||||||
|
|
||||||
|
|
||||||
|
func _run_import() -> int:
|
||||||
|
print("=== SheetImporter import_all：sheets → build/*.json（schema 校验 + 差异化报告）===")
|
||||||
|
var report := SheetImporter.import_all()
|
||||||
|
for s in report.sheets:
|
||||||
|
print(s.summary())
|
||||||
|
print(report.summary())
|
||||||
|
if report.ok():
|
||||||
|
print("RESULT: PASS（%d 表 / %d 行 / 0 违规）" % [report.sheets.size(), report.row_count])
|
||||||
|
return 0
|
||||||
|
push_error("RESULT: FAIL（%d 条违规；schema 违规 = 构建红，禁止跳过坏行静默导入）" % report.violations.size())
|
||||||
|
return 1
|
||||||
|
|
||||||
|
|
||||||
|
func _run_validate() -> int:
|
||||||
|
print("=== SheetImporter validate：data/build 对 schema 合规性 ===")
|
||||||
|
var violations := SheetImporter.validate(SheetImporter.BUILD_DIR)
|
||||||
|
if violations.is_empty():
|
||||||
|
print("RESULT: PASS（build 目录全部合规）")
|
||||||
|
return 0
|
||||||
|
for v in violations:
|
||||||
|
push_error(v)
|
||||||
|
push_error("RESULT: FAIL（%d 条违规）" % violations.size())
|
||||||
|
return 1
|
||||||
@@ -0,0 +1,636 @@
|
|||||||
|
@tool
|
||||||
|
class_name SheetImporter
|
||||||
|
extends RefCounted
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# SheetImporter v0.1 —— CSV → JSON 单向数据管线（架构 §3）
|
||||||
|
#
|
||||||
|
# 铁律（架构 §3.1/§3.2/§3.3）：
|
||||||
|
# ① 单向流动：本工具只写 data/build/；游戏永不写 data/
|
||||||
|
# ② schema 违规 = 导入中止 + 违规清单（行号 + 列名 + 原因）；禁止跳过坏行静默导入
|
||||||
|
# ③ 一行 = 一条数据；首列 id 稳定字符串 ID，永不重编号、永不复用（年更=加行）
|
||||||
|
# ④ 数值列禁千分位/禁单位后缀；文本列空 = 回退（schema required 已挡空值）
|
||||||
|
#
|
||||||
|
# 入口（headless/CI）：src/tools/import_main.gd
|
||||||
|
# godot --headless --path . -s res://src/tools/import_main.gd
|
||||||
|
# godot --headless --path . -s res://src/tools/import_main.gd -- --validate-only
|
||||||
|
#
|
||||||
|
# 范围声明（W1 骨架）：
|
||||||
|
# - CSV → data/build/*.json：完整可用
|
||||||
|
# - → *.tres：接口在（export_tres），W3 GeneratorDef 落盘后启用（ADR-3）
|
||||||
|
# - 跨表引用完整性（halls/upgrades 等目标表）：W2 落盘后激活（schema 已预留说明）
|
||||||
|
#
|
||||||
|
# 知识缺口：Godot 4.7.x 超出训练数据。本文件只用 4.x 稳定 API
|
||||||
|
# （DirAccess / FileAccess / JSON / RegEx / String）。本机首跑若有 API
|
||||||
|
# 报错，按 4.7.2 实际报错修正，并记录到 docs/engineering/。
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
const SHEETS_DIR := "res://data/sheets"
|
||||||
|
const SCHEMA_DIR := "res://data/schema"
|
||||||
|
const BUILD_DIR := "res://data/build"
|
||||||
|
|
||||||
|
## 本工具实现的 JSON Schema 子集白名单；schema 出现白名单外关键词 = schema 违规
|
||||||
|
const SUPPORTED_KEYWORDS: Array[String] = [
|
||||||
|
"type", "properties", "required", "items", "enum", "pattern",
|
||||||
|
"minimum", "maximum", "minLength", "minItems", "maxItems",
|
||||||
|
"additionalProperties", "const",
|
||||||
|
]
|
||||||
|
const META_KEYWORDS: Array[String] = ["$schema", "$id", "title", "description"]
|
||||||
|
|
||||||
|
|
||||||
|
class ImportReport extends RefCounted:
|
||||||
|
var sheet: String = ""
|
||||||
|
var csv_path: String = ""
|
||||||
|
var json_path: String = ""
|
||||||
|
var row_count: int = 0
|
||||||
|
var added: int = 0
|
||||||
|
var changed: int = 0
|
||||||
|
var removed: int = 0
|
||||||
|
var violations: Array[String] = []
|
||||||
|
var notes: Array[String] = []
|
||||||
|
var tres_export: Array[String] = []
|
||||||
|
var sheets: Array = [] ## import_all 聚合时的子报告
|
||||||
|
|
||||||
|
func ok() -> bool:
|
||||||
|
return violations.is_empty()
|
||||||
|
|
||||||
|
func summary() -> String:
|
||||||
|
var lines := PackedStringArray()
|
||||||
|
var head := "表 %s：%d 行（+%d 新增 / ~%d 变更 / -%d 删除）→ %s" % [
|
||||||
|
sheet, row_count, added, changed, removed,
|
||||||
|
json_path.get_file() if json_path != "" else "未写盘"
|
||||||
|
]
|
||||||
|
lines.append(head)
|
||||||
|
for v in violations:
|
||||||
|
lines.append(" [违规] " + v)
|
||||||
|
for n in notes:
|
||||||
|
lines.append(" [备注] " + n)
|
||||||
|
for t in tres_export:
|
||||||
|
lines.append(" [tres] " + t)
|
||||||
|
return "\n".join(lines)
|
||||||
|
|
||||||
|
|
||||||
|
# ----------------------------------------------------------------------------
|
||||||
|
# 公开接口（架构 §3.3 签名级）
|
||||||
|
# ----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
## 全量导入：sheets → build/*.json。返回聚合报告（新增/变更/违规行）。
|
||||||
|
static func import_all() -> ImportReport:
|
||||||
|
var report := ImportReport.new()
|
||||||
|
report.sheet = "ALL"
|
||||||
|
if not DirAccess.dir_exists_absolute(SHEETS_DIR):
|
||||||
|
report.violations.append("表目录不存在：%s" % SHEETS_DIR)
|
||||||
|
return report
|
||||||
|
var csv_files := DirAccess.get_files_at(SHEETS_DIR)
|
||||||
|
csv_files.sort()
|
||||||
|
if csv_files.is_empty():
|
||||||
|
report.violations.append("表目录为空：%s" % SHEETS_DIR)
|
||||||
|
return report
|
||||||
|
var done := 0
|
||||||
|
for file in csv_files:
|
||||||
|
if not file.ends_with(".csv"):
|
||||||
|
continue
|
||||||
|
var csv_path := "%s/%s" % [SHEETS_DIR, file]
|
||||||
|
var sheet_name := file.get_basename()
|
||||||
|
var schema_path := "%s/%s.schema.json" % [SCHEMA_DIR, sheet_name]
|
||||||
|
var schema_v: Variant = _load_json_file(schema_path)
|
||||||
|
if not (schema_v is Dictionary):
|
||||||
|
report.violations.append("%s 的 schema 缺失或解析失败（每张表必须有 data/schema/<表名>.schema.json）" % file)
|
||||||
|
continue
|
||||||
|
var result: Dictionary = import_sheet(csv_path, schema_v)
|
||||||
|
done += 1
|
||||||
|
report.sheets.append(result)
|
||||||
|
report.added += int(result.get("added", 0))
|
||||||
|
report.changed += int(result.get("changed", 0))
|
||||||
|
report.removed += int(result.get("removed", 0))
|
||||||
|
var tr: Array = result.get("typed_rows", [])
|
||||||
|
report.row_count += tr.size()
|
||||||
|
var sub_v: Array = result.get("violations", [])
|
||||||
|
for v in sub_v:
|
||||||
|
report.violations.append(str(v))
|
||||||
|
var sub_n: Array = result.get("notes", [])
|
||||||
|
for n in sub_n:
|
||||||
|
report.notes.append(str(n))
|
||||||
|
var sub_t: Array = result.get("tres_export", [])
|
||||||
|
for t in sub_t:
|
||||||
|
report.tres_export.append(str(t))
|
||||||
|
if done == 0:
|
||||||
|
report.violations.append("未找到任何 CSV 表：%s" % SHEETS_DIR)
|
||||||
|
return report
|
||||||
|
|
||||||
|
|
||||||
|
## 单表导入；typed_rows 为按 schema 转换后的强类型字典数组（建表头顺序键序）。
|
||||||
|
static func import_sheet(csv_path: String, schema: Dictionary) -> Dictionary:
|
||||||
|
var out := {
|
||||||
|
"ok": false,
|
||||||
|
"sheet": _sheet_name(schema),
|
||||||
|
"csv_path": csv_path,
|
||||||
|
"json_path": "",
|
||||||
|
"columns": [],
|
||||||
|
"typed_rows": [],
|
||||||
|
"added": 0, "changed": 0, "removed": 0,
|
||||||
|
"violations": [],
|
||||||
|
"notes": [],
|
||||||
|
"tres_export": [],
|
||||||
|
}
|
||||||
|
# 0) schema 自检：关键词白名单
|
||||||
|
var kw_err := _check_schema_keywords(schema)
|
||||||
|
if kw_err != "":
|
||||||
|
out.violations.append(kw_err)
|
||||||
|
return out
|
||||||
|
# 1) 读 CSV
|
||||||
|
var text := FileAccess.get_file_as_string(csv_path)
|
||||||
|
if text == "":
|
||||||
|
out.violations.append("%s：文件为空或读取失败" % csv_path.get_file())
|
||||||
|
return out
|
||||||
|
var parsed: Dictionary = _parse_csv(text)
|
||||||
|
if parsed.has("error"):
|
||||||
|
out.violations.append(str(parsed.error))
|
||||||
|
return out
|
||||||
|
var header: Array = parsed.header
|
||||||
|
var rows: Array = parsed.rows
|
||||||
|
# 2) 表头 对 schema 列声明
|
||||||
|
var items := _rows_items(schema)
|
||||||
|
var row_props := _row_props(schema)
|
||||||
|
if row_props.is_empty() or items.is_empty():
|
||||||
|
out.violations.append("schema 缺少 rows.items.properties 定义（schema 结构错误）")
|
||||||
|
return out
|
||||||
|
var required_v: Variant = items.get("required", [])
|
||||||
|
var required: Array = required_v if required_v is Array else []
|
||||||
|
var missing := PackedStringArray()
|
||||||
|
var extra := PackedStringArray()
|
||||||
|
for col in required:
|
||||||
|
if not header.has(col):
|
||||||
|
missing.append(str(col))
|
||||||
|
for col in header:
|
||||||
|
if not row_props.has(col):
|
||||||
|
extra.append(str(col))
|
||||||
|
if not missing.is_empty():
|
||||||
|
out.violations.append("%s：表头缺少必填列 %s（CSV 规范：列名与 schema 严格一致）" % [csv_path.get_file(), str(missing)])
|
||||||
|
if not extra.is_empty():
|
||||||
|
out.violations.append("%s：表头出现 schema 未声明列 %s（新增列 = schema 版本升级，勿静默加列）" % [csv_path.get_file(), str(extra)])
|
||||||
|
if header.size() != required.size() and missing.is_empty() and extra.is_empty():
|
||||||
|
out.violations.append("%s：表头列数 %d ≠ schema 声明 %d（疑似重复列名）" % [csv_path.get_file(), header.size(), required.size()])
|
||||||
|
if not out.violations.is_empty():
|
||||||
|
return out
|
||||||
|
# 3) 行级转换 + 校验（每个错误带 CSV 行号 + 列名 + 原因）
|
||||||
|
var typed_rows: Array = []
|
||||||
|
var row_lines: Array = []
|
||||||
|
for r in rows:
|
||||||
|
var line_no: int = int(r.line)
|
||||||
|
var cells: Array = r.cells
|
||||||
|
if cells.size() != header.size():
|
||||||
|
out.violations.append("%s 第 %d 行：列数 %d ≠ 表头 %d（检查是否漏/多逗号，或单元格内逗号未用引号包裹）" % [csv_path.get_file(), line_no, cells.size(), header.size()])
|
||||||
|
continue
|
||||||
|
var row := {}
|
||||||
|
for i in header.size():
|
||||||
|
var col: String = header[i]
|
||||||
|
var raw: String = str(cells[i])
|
||||||
|
var prop: Dictionary = row_props.get(col, {})
|
||||||
|
var conv: Dictionary = _convert(raw, prop)
|
||||||
|
if conv.error != "":
|
||||||
|
out.violations.append("%s 第 %d 行 列 '%s'：%s" % [csv_path.get_file(), line_no, col, str(conv.error)])
|
||||||
|
else:
|
||||||
|
var sc := _check_scalar(prop, conv.value)
|
||||||
|
if sc != "":
|
||||||
|
out.violations.append("%s 第 %d 行 列 '%s'：%s（得到 '%s'）" % [csv_path.get_file(), line_no, col, sc, str(conv.value)])
|
||||||
|
row[col] = conv.value
|
||||||
|
typed_rows.append(row)
|
||||||
|
row_lines.append(line_no)
|
||||||
|
# 4) 行级规则：唯一 ID（schema x-unique）+ 最少行数（GDD 锁定 12）
|
||||||
|
var unique_v: Variant = schema.get("x-unique", [])
|
||||||
|
if unique_v is Array:
|
||||||
|
for uc in unique_v:
|
||||||
|
var ucs := str(uc)
|
||||||
|
var seen := {}
|
||||||
|
var idx := 0
|
||||||
|
for row in typed_rows:
|
||||||
|
var idv := str(row.get(ucs, "<missing>"))
|
||||||
|
if seen.has(idv):
|
||||||
|
out.violations.append("%s 第 %d 行 列 '%s'：重复值 '%s'（稳定 ID 永不重编号/复用；前次出现约第 %d 行）" % [
|
||||||
|
csv_path.get_file(), int(row_lines[idx]), ucs, idv, int(seen[idv])])
|
||||||
|
seen[idv] = int(row_lines[idx])
|
||||||
|
idx += 1
|
||||||
|
if items.has("minItems") and typed_rows.size() < int(items.minItems):
|
||||||
|
out.violations.append("%s：数据行 %d < schema minItems %d（GDD 锁定 12 班底；删行 = 设计动作，走 ADR 流程）" % [csv_path.get_file(), typed_rows.size(), int(items.minItems)])
|
||||||
|
if not out.violations.is_empty():
|
||||||
|
return out # 失败策略：有违规不写 build，导入中止
|
||||||
|
# 5) 组装 build 文档（确定性 canonical JSON）+ 写盘
|
||||||
|
var doc := {
|
||||||
|
"sheet": _sheet_name(schema),
|
||||||
|
"schema_version": _schema_version(schema),
|
||||||
|
"columns": header,
|
||||||
|
"rows": typed_rows,
|
||||||
|
}
|
||||||
|
var json_path := "%s/%s.json" % [BUILD_DIR, _sheet_name(schema)]
|
||||||
|
# 先读旧 build（差异化对比必须在覆盖前读）
|
||||||
|
var prev: Variant = _load_json_file(json_path)
|
||||||
|
var prev_rows: Array = []
|
||||||
|
if prev is Dictionary:
|
||||||
|
prev_rows = prev.get("rows", [])
|
||||||
|
DirAccess.make_dir_recursive_absolute(BUILD_DIR)
|
||||||
|
var f := FileAccess.open(json_path, FileAccess.WRITE)
|
||||||
|
if f == null:
|
||||||
|
out.violations.append("写入失败：%s（%s）" % [json_path, error_string(FileAccess.get_open_error())])
|
||||||
|
return out
|
||||||
|
f.store_string(_canonical_json(doc, "") + "\n")
|
||||||
|
f.close()
|
||||||
|
out.json_path = json_path
|
||||||
|
out.columns = header
|
||||||
|
out.typed_rows = typed_rows
|
||||||
|
# 6) 与旧 build 对比：新增/变更/删除（按稳定 ID）
|
||||||
|
if prev_rows.is_empty():
|
||||||
|
out.added = typed_rows.size()
|
||||||
|
out.notes.append("首次生成 %s" % json_path.get_file())
|
||||||
|
else:
|
||||||
|
var new_by_id := {}
|
||||||
|
for row in typed_rows:
|
||||||
|
new_by_id[str(row.get("id", ""))] = row
|
||||||
|
var old_by_id := {}
|
||||||
|
for row in prev_rows:
|
||||||
|
old_by_id[str(row.get("id", ""))] = row
|
||||||
|
for id in new_by_id:
|
||||||
|
if not old_by_id.has(id):
|
||||||
|
out.added += 1
|
||||||
|
elif _canonical_json(new_by_id[id], "") != _canonical_json(old_by_id[id], ""):
|
||||||
|
out.changed += 1
|
||||||
|
for id in old_by_id:
|
||||||
|
if not new_by_id.has(id):
|
||||||
|
out.removed += 1
|
||||||
|
# 7) .tres 导出（v0.1 stub：接口在，W3 启用——见 export_tres）
|
||||||
|
var tres: Array[String] = export_tres(json_path, BUILD_DIR + "/tres")
|
||||||
|
out.tres_export = tres
|
||||||
|
out.ok = true
|
||||||
|
return out
|
||||||
|
|
||||||
|
|
||||||
|
## 校验 build/*.json 对 schema 的合规性；违规列表为空 = 通过。
|
||||||
|
## 行号约定：rows[i] 报为"第 i+2 行"（对齐 CSV 物理行，表头 = 第 1 行）。
|
||||||
|
static func validate(json_dir: String) -> Array[String]:
|
||||||
|
var violations: Array[String] = []
|
||||||
|
if not DirAccess.dir_exists_absolute(json_dir):
|
||||||
|
violations.append("build 目录不存在：%s（先运行 import_all）" % json_dir)
|
||||||
|
return violations
|
||||||
|
var schema_files := DirAccess.get_files_at(SCHEMA_DIR)
|
||||||
|
schema_files.sort()
|
||||||
|
for sf in schema_files:
|
||||||
|
if not sf.ends_with(".schema.json"):
|
||||||
|
continue
|
||||||
|
var sheet_name := sf.substr(0, sf.length() - ".schema.json".length())
|
||||||
|
var schema_v: Variant = _load_json_file("%s/%s" % [SCHEMA_DIR, sf])
|
||||||
|
if not (schema_v is Dictionary):
|
||||||
|
violations.append("schema 解析失败：%s" % sf)
|
||||||
|
continue
|
||||||
|
var json_path := "%s/%s.json" % [json_dir, sheet_name]
|
||||||
|
var doc: Variant = _load_json_file(json_path)
|
||||||
|
if doc == null:
|
||||||
|
violations.append("缺少 build 产物：%s（运行 import_all 生成）" % json_path)
|
||||||
|
continue
|
||||||
|
var where := "%s → %s" % [sheet_name, json_path.get_file()]
|
||||||
|
_validate_value(doc, schema_v, where, "", violations, -1)
|
||||||
|
return violations
|
||||||
|
|
||||||
|
|
||||||
|
## ★ ADR-3：唯一允许的逐资产代码 = sprite 路径（已是 CSV 列）。
|
||||||
|
## .tres 生成 v0.1 = stub：接口定义在此，W3 GeneratorDef 数据类落盘后启用。
|
||||||
|
static func export_tres(build_json_path: String, out_dir: String) -> Array[String]:
|
||||||
|
return ["[stub] %s → %s/*.tres：W3 GeneratorDef 落盘后启用（数据行 → Resource）" % [build_json_path.get_file(), out_dir]]
|
||||||
|
|
||||||
|
|
||||||
|
# ----------------------------------------------------------------------------
|
||||||
|
# CSV 解析（RFC4180 简化版：引号包裹 + "" 转义；v0 不支持内嵌换行）
|
||||||
|
# ----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
static func _parse_csv(text: String) -> Dictionary:
|
||||||
|
if text.begins_with("\ufeff"):
|
||||||
|
text = text.substr(1)
|
||||||
|
var header: Array = []
|
||||||
|
var rows: Array = []
|
||||||
|
var cells: Array = []
|
||||||
|
var cell := ""
|
||||||
|
var quoted := false
|
||||||
|
var in_quotes := false
|
||||||
|
var line := 1
|
||||||
|
var i := 0
|
||||||
|
var n := text.length()
|
||||||
|
while i < n:
|
||||||
|
var c := text[i]
|
||||||
|
if in_quotes:
|
||||||
|
if c == '"':
|
||||||
|
if i + 1 < n and text[i + 1] == '"':
|
||||||
|
cell += '"'
|
||||||
|
i += 2
|
||||||
|
continue
|
||||||
|
in_quotes = false
|
||||||
|
i += 1
|
||||||
|
continue
|
||||||
|
cell += c
|
||||||
|
i += 1
|
||||||
|
continue
|
||||||
|
if c == '"' and cell == "":
|
||||||
|
in_quotes = true
|
||||||
|
quoted = true
|
||||||
|
i += 1
|
||||||
|
continue
|
||||||
|
if c == ",":
|
||||||
|
cells.append(_cell_value(cell, quoted))
|
||||||
|
cell = ""
|
||||||
|
quoted = false
|
||||||
|
i += 1
|
||||||
|
continue
|
||||||
|
if c == "\r":
|
||||||
|
i += 1
|
||||||
|
continue
|
||||||
|
if c == "\n":
|
||||||
|
cells.append(_cell_value(cell, quoted))
|
||||||
|
_push_line(cells, line, header, rows)
|
||||||
|
cells = []
|
||||||
|
cell = ""
|
||||||
|
quoted = false
|
||||||
|
line += 1
|
||||||
|
i += 1
|
||||||
|
continue
|
||||||
|
cell += c
|
||||||
|
i += 1
|
||||||
|
if in_quotes:
|
||||||
|
return {"error": "CSV 引号未闭合（v0 规范：单元格内双引号以 \"\" 转义；不支持内嵌换行）"}
|
||||||
|
if cell != "" or quoted or not cells.is_empty():
|
||||||
|
cells.append(_cell_value(cell, quoted))
|
||||||
|
_push_line(cells, line, header, rows)
|
||||||
|
return {"header": header, "rows": rows}
|
||||||
|
|
||||||
|
|
||||||
|
static func _cell_value(cell: String, was_quoted: bool) -> String:
|
||||||
|
# v0 简化：非引号单元格去首尾空白；引号单元格原样保留（本项目无首尾空白敏感数据）
|
||||||
|
return cell if was_quoted else cell.strip_edges()
|
||||||
|
|
||||||
|
|
||||||
|
static func _push_line(cells: Array, line_no: int, header: Array, rows: Array) -> void:
|
||||||
|
if cells.size() == 1 and str(cells[0]).strip_edges() == "":
|
||||||
|
return # 跳过空行
|
||||||
|
if header.is_empty():
|
||||||
|
for c in cells:
|
||||||
|
if not (c is String):
|
||||||
|
return
|
||||||
|
header.append_array(cells)
|
||||||
|
return
|
||||||
|
rows.append({"line": line_no, "cells": cells})
|
||||||
|
|
||||||
|
|
||||||
|
# ----------------------------------------------------------------------------
|
||||||
|
# 类型转换 / 标量校验
|
||||||
|
# ----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
static func _convert(raw: String, prop: Dictionary) -> Dictionary:
|
||||||
|
var t := str(prop.get("type", "string"))
|
||||||
|
match t:
|
||||||
|
"string":
|
||||||
|
return {"value": raw, "error": ""}
|
||||||
|
"integer":
|
||||||
|
if _re_match("^[+-]?[0-9]+$", raw) == false:
|
||||||
|
return {"value": null, "error": "期望 integer，得到 '%s'（数值列禁千分位/禁单位后缀；示例：1200000）" % raw}
|
||||||
|
return {"value": int(raw), "error": ""}
|
||||||
|
"number":
|
||||||
|
if _re_match("^[+-]?([0-9]+(\\.[0-9]+)?|\\.[0-9]+)$", raw) == false:
|
||||||
|
return {"value": null, "error": "期望 number，得到 '%s'（数值列禁千分位与 K/M/B/T 后缀；示例：1.2K → 1200）" % raw}
|
||||||
|
if raw.contains("."):
|
||||||
|
return {"value": float(raw), "error": ""}
|
||||||
|
return {"value": int(raw), "error": ""}
|
||||||
|
"boolean":
|
||||||
|
var low := raw.to_lower()
|
||||||
|
if low in ["true", "1", "yes"]:
|
||||||
|
return {"value": true, "error": ""}
|
||||||
|
if low in ["false", "0", "no"]:
|
||||||
|
return {"value": false, "error": ""}
|
||||||
|
return {"value": null, "error": "期望 boolean，得到 '%s'（true/false）" % raw}
|
||||||
|
_:
|
||||||
|
return {"value": null, "error": "schema 声明了本工具不支持的类型 '%s'" % t}
|
||||||
|
return {"value": raw, "error": ""}
|
||||||
|
|
||||||
|
|
||||||
|
static func _re_match(pattern: String, text: String) -> bool:
|
||||||
|
var re := RegEx.new()
|
||||||
|
if re.compile(pattern) != OK:
|
||||||
|
push_warning("RegEx 编译失败：%s" % pattern)
|
||||||
|
return false
|
||||||
|
return re.search(text) != null
|
||||||
|
|
||||||
|
|
||||||
|
static func _check_scalar(prop: Dictionary, value: Variant) -> String:
|
||||||
|
if prop.has("const"):
|
||||||
|
var cv: Variant = prop.const
|
||||||
|
if value != cv:
|
||||||
|
return "必须等于常量 %s" % str(cv)
|
||||||
|
if prop.has("enum"):
|
||||||
|
var allowed: Variant = prop.enum
|
||||||
|
if allowed is Array and not allowed.has(value):
|
||||||
|
return "取值必须为 %s 之一" % str(allowed)
|
||||||
|
if prop.has("pattern") and value is String:
|
||||||
|
if _re_match(str(prop.pattern), value) == false:
|
||||||
|
return "不匹配模式 %s" % str(prop.pattern)
|
||||||
|
if value is int or value is float:
|
||||||
|
if prop.has("minimum") and float(value) < float(prop.minimum):
|
||||||
|
return "小于下限 %s" % str(prop.minimum)
|
||||||
|
if prop.has("maximum") and float(value) > float(prop.maximum):
|
||||||
|
return "大于上限 %s" % str(prop.maximum)
|
||||||
|
if prop.has("minLength") and value is String and value.length() < int(prop.minLength):
|
||||||
|
return "长度 %d < minLength %d" % [value.length(), int(prop.minLength)]
|
||||||
|
return ""
|
||||||
|
|
||||||
|
|
||||||
|
static func _type_ok(value: Variant, t: String) -> bool:
|
||||||
|
match t:
|
||||||
|
"string":
|
||||||
|
return value is String
|
||||||
|
"integer":
|
||||||
|
if value is int:
|
||||||
|
return true
|
||||||
|
if value is float:
|
||||||
|
return is_finite(value) and is_equal_approx(value, float(int(value)))
|
||||||
|
return false
|
||||||
|
"number":
|
||||||
|
return value is int or value is float
|
||||||
|
"boolean":
|
||||||
|
return value is bool
|
||||||
|
return false
|
||||||
|
|
||||||
|
|
||||||
|
# ----------------------------------------------------------------------------
|
||||||
|
# 文档校验（build/*.json 对 schema；schema 子集白名单可查）
|
||||||
|
# ----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
static func _validate_value(value: Variant, node: Dictionary, where: String, path: String, violations: Array[String], row_index: int) -> void:
|
||||||
|
var loc := _loc(where, path, row_index)
|
||||||
|
var declared := str(node.get("type", ""))
|
||||||
|
if declared != "" and not _type_ok(value, declared):
|
||||||
|
violations.append("%s类型期望 %s，得到 %s（'%s'）" % [loc, declared, type_string(typeof(value)), _brief(value)])
|
||||||
|
return
|
||||||
|
if not (value is Dictionary or value is Array):
|
||||||
|
var sc := _check_scalar(node, value)
|
||||||
|
if sc != "":
|
||||||
|
violations.append("%s%s（得到 '%s'）" % [loc, sc, _brief(value)])
|
||||||
|
return
|
||||||
|
if value is Dictionary:
|
||||||
|
var props_v: Variant = node.get("properties", {})
|
||||||
|
var props: Dictionary = props_v if props_v is Dictionary else {}
|
||||||
|
var req_v: Variant = node.get("required", [])
|
||||||
|
if req_v is Array:
|
||||||
|
for rk in req_v:
|
||||||
|
if not value.has(rk):
|
||||||
|
violations.append("%s缺少必填列 '%s'" % [loc, str(rk)])
|
||||||
|
var add_v: Variant = node.get("additionalProperties", true)
|
||||||
|
var add_allowed := true
|
||||||
|
if add_v is bool:
|
||||||
|
add_allowed = add_v
|
||||||
|
for k in value.keys():
|
||||||
|
var ks := str(k)
|
||||||
|
if not props.has(ks):
|
||||||
|
if not add_allowed:
|
||||||
|
violations.append("%s出现 schema 未声明的列 '%s'（新增列 = schema 版本升级，勿静默加列）" % [loc, ks])
|
||||||
|
continue
|
||||||
|
_validate_value(value[k], props[ks], where, _join_path(path, ks), violations, row_index)
|
||||||
|
return
|
||||||
|
# value is Array
|
||||||
|
if node.has("minItems") and value.size() < int(node.minItems):
|
||||||
|
violations.append("%s数量 %d < minItems %d" % [loc, value.size(), int(node.minItems)])
|
||||||
|
if node.has("maxItems") and value.size() > int(node.maxItems):
|
||||||
|
violations.append("%s数量 %d > maxItems %d" % [loc, value.size(), int(node.maxItems)])
|
||||||
|
var items_v: Variant = node.get("items", null)
|
||||||
|
if items_v is Dictionary:
|
||||||
|
var idx := 0
|
||||||
|
for item in value:
|
||||||
|
var next_row := idx if path == "rows" else row_index
|
||||||
|
_validate_value(item, items_v, where, "%s[%d]" % [path, idx], violations, next_row)
|
||||||
|
idx += 1
|
||||||
|
|
||||||
|
|
||||||
|
static func _check_schema_keywords(schema: Dictionary) -> String:
|
||||||
|
var bad := PackedStringArray()
|
||||||
|
_walk_schema(schema, bad)
|
||||||
|
if bad.is_empty():
|
||||||
|
return ""
|
||||||
|
return "schema 使用了本工具未支持的关键词：%s（支持集：%s）" % [str(bad), str(SUPPORTED_KEYWORDS)]
|
||||||
|
|
||||||
|
|
||||||
|
static func _walk_schema(node: Dictionary, bad: PackedStringArray) -> void:
|
||||||
|
for k in node.keys():
|
||||||
|
var ks := str(k)
|
||||||
|
if not ks.begins_with("x-") and not SUPPORTED_KEYWORDS.has(ks) and not META_KEYWORDS.has(ks):
|
||||||
|
bad.append(ks)
|
||||||
|
for key in ["properties", "items", "additionalProperties"]:
|
||||||
|
if node.has(key):
|
||||||
|
var v: Variant = node[key]
|
||||||
|
if v is Dictionary:
|
||||||
|
_walk_schema(v, bad)
|
||||||
|
elif v is Array:
|
||||||
|
for item in v:
|
||||||
|
if item is Dictionary:
|
||||||
|
_walk_schema(item, bad)
|
||||||
|
|
||||||
|
|
||||||
|
# ----------------------------------------------------------------------------
|
||||||
|
# 确定性 canonical JSON 序列化（build 产物字节稳定 = CI 漂移门可字节比对）
|
||||||
|
# ----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
static func _canonical_json(value: Variant, indent: String) -> String:
|
||||||
|
if value is Dictionary:
|
||||||
|
if value.is_empty():
|
||||||
|
return "{}"
|
||||||
|
var lines := PackedStringArray()
|
||||||
|
for k in value.keys():
|
||||||
|
lines.append("%s\t%s: %s" % [indent, JSON.stringify(str(k)), _canonical_json(value[k], indent + "\t")])
|
||||||
|
return "{\n" + ",\n".join(lines) + "\n" + indent + "}"
|
||||||
|
if value is Array:
|
||||||
|
if value.is_empty():
|
||||||
|
return "[]"
|
||||||
|
var lines := PackedStringArray()
|
||||||
|
for v in value:
|
||||||
|
lines.append("%s\t%s" % [indent, _canonical_json(v, indent + "\t")])
|
||||||
|
return "[\n" + ",\n".join(lines) + "\n" + indent + "]"
|
||||||
|
if value is String:
|
||||||
|
return JSON.stringify(value)
|
||||||
|
if value is bool:
|
||||||
|
return "true" if value else "false"
|
||||||
|
if value is int:
|
||||||
|
return str(value)
|
||||||
|
if value is float:
|
||||||
|
if is_finite(value) and is_equal_approx(value, float(int(value))) and absf(value) < 1e15:
|
||||||
|
return str(int(value))
|
||||||
|
return str(value)
|
||||||
|
return JSON.stringify(str(value))
|
||||||
|
|
||||||
|
|
||||||
|
# ----------------------------------------------------------------------------
|
||||||
|
# 小工具
|
||||||
|
# ----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
static func _rows_items(schema: Dictionary) -> Dictionary:
|
||||||
|
var props_v: Variant = schema.get("properties", {})
|
||||||
|
if not (props_v is Dictionary):
|
||||||
|
return {}
|
||||||
|
var rows_v: Variant = props_v.get("rows", {})
|
||||||
|
if not (rows_v is Dictionary):
|
||||||
|
return {}
|
||||||
|
var items_v: Variant = rows_v.get("items", {})
|
||||||
|
return items_v if items_v is Dictionary else {}
|
||||||
|
|
||||||
|
|
||||||
|
static func _row_props(schema: Dictionary) -> Dictionary:
|
||||||
|
var items := _rows_items(schema)
|
||||||
|
var props_v: Variant = items.get("properties", {})
|
||||||
|
return props_v if props_v is Dictionary else {}
|
||||||
|
|
||||||
|
|
||||||
|
static func _sheet_name(schema: Dictionary) -> String:
|
||||||
|
var props_v: Variant = schema.get("properties", {})
|
||||||
|
if props_v is Dictionary:
|
||||||
|
var sheet_v: Variant = props_v.get("sheet", {})
|
||||||
|
if sheet_v is Dictionary and sheet_v.has("const"):
|
||||||
|
return str(sheet_v.const)
|
||||||
|
var title := str(schema.get("title", "unknown"))
|
||||||
|
return title.split(" ")[0] if title != "" else "unknown"
|
||||||
|
|
||||||
|
|
||||||
|
static func _schema_version(schema: Dictionary) -> int:
|
||||||
|
var props_v: Variant = schema.get("properties", {})
|
||||||
|
if props_v is Dictionary:
|
||||||
|
var ver_v: Variant = props_v.get("schema_version", {})
|
||||||
|
if ver_v is Dictionary and ver_v.has("const"):
|
||||||
|
return int(ver_v.const)
|
||||||
|
return 0
|
||||||
|
|
||||||
|
|
||||||
|
static func _load_json_file(path: String) -> Variant:
|
||||||
|
if not FileAccess.file_exists(path):
|
||||||
|
return null
|
||||||
|
var text := FileAccess.get_file_as_string(path)
|
||||||
|
if text == "":
|
||||||
|
return null
|
||||||
|
var data: Variant = JSON.parse_string(text)
|
||||||
|
if data == null:
|
||||||
|
push_warning("JSON 解析失败：%s" % path)
|
||||||
|
return null
|
||||||
|
return data
|
||||||
|
|
||||||
|
|
||||||
|
static func _loc(where: String, path: String, row_index: int) -> String:
|
||||||
|
if row_index >= 0:
|
||||||
|
if path == "":
|
||||||
|
return "%s 第 %d 行：" % [where, row_index + 2]
|
||||||
|
return "%s 第 %d 行 %s：" % [where, row_index + 2, path]
|
||||||
|
if path == "":
|
||||||
|
return "%s：" % where
|
||||||
|
return "%s %s：" % [where, path]
|
||||||
|
|
||||||
|
|
||||||
|
static func _join_path(path: String, key: String) -> String:
|
||||||
|
if path == "":
|
||||||
|
return key
|
||||||
|
return "%s.%s" % [path, key]
|
||||||
|
|
||||||
|
|
||||||
|
static func _brief(v: Variant) -> String:
|
||||||
|
var s := str(v)
|
||||||
|
if s.length() > 32:
|
||||||
|
s = s.substr(0, 32) + "…"
|
||||||
|
return s
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
# 探针 P1 —— SCREEN_TEXTURE / CanvasLayer 排序语义
|
||||||
|
|
||||||
|
验证 Godot 4.7 后处理三问（架构 §11 P1 / §5.2 ADR-2）：
|
||||||
|
① 背景色是否含入 SCREEN_TEXTURE 采样；② CanvasLayer 排序（L0 世界 < L1 后处理 < L2 UI）；③ UI 层是否被后处理污染。
|
||||||
|
|
||||||
|
**完整实测手册（必读，约 30 分钟）**：
|
||||||
|
`docs/engineering/2026-10-19-f-w1-probe-p1-manual.md`（本仓库外的工作区文档树）
|
||||||
|
|
||||||
|
**跑法**：编辑器打开 `tests/probe_p1_screen_texture/probe_p1.tscn` → F6 运行当前场景。
|
||||||
|
键位：`1` 直通 / `2` 反色 / `3` 红染 / `4` 纯绿 / `V` 显隐后处理层 / `S` 截图到 `user://` / `Esc` 退出。
|
||||||
|
控制台会打印引擎版本 / rendering_method / 显卡适配器——回填结论时连同截图一起归档。
|
||||||
|
|
||||||
|
**结论回填**：`docs/engineering/probes/P1-result.md`
|
||||||
|
**不过的回退**：SubViewport + BackBufferCopy（架构预算 +2-4h）。
|
||||||
@@ -0,0 +1,183 @@
|
|||||||
|
extends Node
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# 探针 P1 —— Godot 4.7 hint_screen_texture / SCREEN_TEXTURE 语义
|
||||||
|
# 架构依据：§11 P1 / §5.2（ADR-2 单趟 fused 后处理的 CanvasLayer 拓扑）
|
||||||
|
# 实测手册：docs/engineering/2026-10-19-f-w1-probe-p1-manual.md
|
||||||
|
# 结论回填：docs/engineering/probes/P1-result.md
|
||||||
|
#
|
||||||
|
# 三问：
|
||||||
|
# ① 背景/世界色是否含入 SCREEN_TEXTURE 采样（后处理 L1 能否看见 L0）
|
||||||
|
# ② CanvasLayer 排序语义（L1 后处理在 L0 世界之上、L2 UI 之下）
|
||||||
|
# ③ UI 层是否被后处理污染（UI 保持 crisp、不被 shader 调制）
|
||||||
|
#
|
||||||
|
# 场景在 _ready() 中代码化搭建（不手写 .tscn 降低出错面）。
|
||||||
|
# 键位：1 直通 | 2 反色 | 3 红染 | 4 纯绿 | V 显/隐后处理层 | S 截图 user:// | Esc 退出
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
enum PostMode { PASSTHROUGH, INVERT, RED_TINT, SOLID_GREEN }
|
||||||
|
|
||||||
|
var _post: ColorRect
|
||||||
|
var _post_visible := true
|
||||||
|
var _mode: int = PostMode.PASSTHROUGH
|
||||||
|
var _mat: ShaderMaterial
|
||||||
|
var _hud: Label
|
||||||
|
var _shot_n := 0
|
||||||
|
|
||||||
|
|
||||||
|
func _ready() -> void:
|
||||||
|
_build_world()
|
||||||
|
_build_post()
|
||||||
|
_build_ui()
|
||||||
|
_print_environment()
|
||||||
|
|
||||||
|
|
||||||
|
func _build_world() -> void:
|
||||||
|
var world := CanvasLayer.new()
|
||||||
|
world.name = "L0_World"
|
||||||
|
world.layer = 0
|
||||||
|
add_child(world)
|
||||||
|
|
||||||
|
var bg := ColorRect.new()
|
||||||
|
bg.name = "Background"
|
||||||
|
bg.color = Color("#23384F") # 已知底色：后处理里能看见它 = 世界含入采样
|
||||||
|
bg.set_anchors_preset(Control.PRESET_FULL_RECT)
|
||||||
|
world.add_child(bg)
|
||||||
|
|
||||||
|
var marker := ColorRect.new()
|
||||||
|
marker.name = "WorldMarker"
|
||||||
|
marker.color = Color("#D08A2E")
|
||||||
|
marker.position = Vector2(400, 240)
|
||||||
|
marker.size = Vector2(480, 240)
|
||||||
|
world.add_child(marker)
|
||||||
|
|
||||||
|
var world_label := Label.new()
|
||||||
|
world_label.name = "WorldLabel"
|
||||||
|
world_label.text = "L0 World: bg #23384F + marker #D08A2E"
|
||||||
|
world_label.position = Vector2(24, 180)
|
||||||
|
world_label.add_theme_color_override("font_color", Color.WHITE)
|
||||||
|
world.add_child(world_label)
|
||||||
|
|
||||||
|
|
||||||
|
func _build_post() -> void:
|
||||||
|
var post_layer := CanvasLayer.new()
|
||||||
|
post_layer.name = "L1_PostProcess"
|
||||||
|
post_layer.layer = 1
|
||||||
|
add_child(post_layer)
|
||||||
|
|
||||||
|
var sh := load("res://tests/probe_p1_screen_texture/probe_p1.gdshader") as Shader
|
||||||
|
_mat = ShaderMaterial.new()
|
||||||
|
_mat.shader = sh
|
||||||
|
_mat.set_shader_parameter("mode", PostMode.PASSTHROUGH)
|
||||||
|
|
||||||
|
_post = ColorRect.new()
|
||||||
|
_post.name = "PostProcessRect"
|
||||||
|
_post.material = _mat
|
||||||
|
_post.mouse_filter = Control.MOUSE_FILTER_IGNORE
|
||||||
|
_post.set_anchors_preset(Control.PRESET_FULL_RECT)
|
||||||
|
post_layer.add_child(_post)
|
||||||
|
|
||||||
|
|
||||||
|
func _build_ui() -> void:
|
||||||
|
var ui_layer := CanvasLayer.new()
|
||||||
|
ui_layer.name = "L2_UI"
|
||||||
|
ui_layer.layer = 2
|
||||||
|
add_child(ui_layer)
|
||||||
|
|
||||||
|
var root := Control.new()
|
||||||
|
root.name = "UIRoot"
|
||||||
|
root.set_anchors_preset(Control.PRESET_FULL_RECT)
|
||||||
|
ui_layer.add_child(root)
|
||||||
|
|
||||||
|
# UI 样本：四色板 + 一块纯白。被后处理污染 = 颜色变了/出现着色/纸纹
|
||||||
|
var chip_colors := [
|
||||||
|
Color("#1A1614"), Color("#EDE6D8"), Color("#B03A2E"),
|
||||||
|
Color("#3A5A6B"), Color("#FFFFFF"),
|
||||||
|
]
|
||||||
|
var chip_names := ["墨 #1A1614", "骨白 #EDE6D8", "朱砂 #B03A2E", "靛 #3A5A6B", "纯白 #FFFFFF"]
|
||||||
|
for i in chip_colors.size():
|
||||||
|
var chip := ColorRect.new()
|
||||||
|
chip.name = "Chip%d" % i
|
||||||
|
chip.color = chip_colors[i]
|
||||||
|
chip.size = Vector2(200, 40)
|
||||||
|
chip.position = Vector2(960, 48 + i * 56)
|
||||||
|
root.add_child(chip)
|
||||||
|
var lbl := Label.new()
|
||||||
|
lbl.name = "ChipLabel%d" % i
|
||||||
|
lbl.text = chip_names[i]
|
||||||
|
lbl.position = Vector2(1010, 54 + i * 56)
|
||||||
|
if chip_colors[i].get_luminance() > 0.5:
|
||||||
|
lbl.add_theme_color_override("font_color", Color.BLACK)
|
||||||
|
else:
|
||||||
|
lbl.add_theme_color_override("font_color", Color.WHITE)
|
||||||
|
root.add_child(lbl)
|
||||||
|
|
||||||
|
_hud = Label.new()
|
||||||
|
_hud.name = "HUDHelp"
|
||||||
|
_hud.text = _help_text()
|
||||||
|
_hud.position = Vector2(24, 648)
|
||||||
|
_hud.add_theme_color_override("font_color", Color.WHITE)
|
||||||
|
root.add_child(_hud)
|
||||||
|
|
||||||
|
|
||||||
|
func _help_text() -> String:
|
||||||
|
var mode_names := ["PASS直通", "INVERT反色", "RED红染", "GREEN纯绿"]
|
||||||
|
var mode_name := mode_names[_mode] if _mode >= 0 and _mode < mode_names.size() else "?"
|
||||||
|
return "探针 P1 | 1 直通 2 反色 3 红染 4 纯绿 | V 显/隐后处理层（当前:%s）| S 截图到 user:// | Esc 退出 | 当前 mode=%s" % [
|
||||||
|
"显示" if _post_visible else "隐藏", mode_name]
|
||||||
|
|
||||||
|
|
||||||
|
func _input(event: InputEvent) -> void:
|
||||||
|
var key_event := event as InputEventKey
|
||||||
|
if key_event != null and key_event.pressed and not key_event.echo:
|
||||||
|
match key_event.keycode:
|
||||||
|
KEY_1:
|
||||||
|
_set_mode(PostMode.PASSTHROUGH)
|
||||||
|
KEY_2:
|
||||||
|
_set_mode(PostMode.INVERT)
|
||||||
|
KEY_3:
|
||||||
|
_set_mode(PostMode.RED_TINT)
|
||||||
|
KEY_4:
|
||||||
|
_set_mode(PostMode.SOLID_GREEN)
|
||||||
|
KEY_V:
|
||||||
|
_post_visible = not _post_visible
|
||||||
|
_post.visible = _post_visible
|
||||||
|
_hud.text = _help_text()
|
||||||
|
KEY_S:
|
||||||
|
_screenshot()
|
||||||
|
KEY_ESCAPE:
|
||||||
|
get_tree().quit()
|
||||||
|
|
||||||
|
|
||||||
|
func _set_mode(m: int) -> void:
|
||||||
|
_mode = m
|
||||||
|
_mat.set_shader_parameter("mode", m)
|
||||||
|
_hud.text = _help_text()
|
||||||
|
var mode_names := ["PASS直通", "INVERT反色", "RED红染", "GREEN纯绿"]
|
||||||
|
print("P1 mode → %d（%s）" % [m, mode_names[m] if m >= 0 and m < mode_names.size() else "?"])
|
||||||
|
|
||||||
|
|
||||||
|
func _screenshot() -> void:
|
||||||
|
var tex := get_viewport().get_texture()
|
||||||
|
if tex == null:
|
||||||
|
push_warning("P1: viewport texture 为空，回退：请用系统截图（Win+Shift+S）")
|
||||||
|
return
|
||||||
|
var img := tex.get_image()
|
||||||
|
if img == null:
|
||||||
|
push_warning("P1: get_image() 失败，回退：请用系统截图（Win+Shift+S）")
|
||||||
|
return
|
||||||
|
var path := "user://p1_mode_%d_%02d.png" % [_mode, _shot_n]
|
||||||
|
_shot_n += 1
|
||||||
|
var err := img.save_png(path)
|
||||||
|
print("P1 screenshot → ", path, " err=", err)
|
||||||
|
|
||||||
|
|
||||||
|
func _print_environment() -> void:
|
||||||
|
var v := Engine.get_version_info()
|
||||||
|
print("=== P1 probe 环境（截图请连同此段一起归档）===")
|
||||||
|
print("godot: %d.%d.%d %s" % [int(v.major), int(v.minor), int(v.patch), str(v.status)])
|
||||||
|
print("rendering_method: ", ProjectSettings.get_setting("rendering/renderer/rendering_method"))
|
||||||
|
print("adapter: ", RenderingServer.get_video_adapter_name())
|
||||||
|
print("viewport: ", get_viewport().get_visible_rect().size)
|
||||||
|
print("stretch: ", ProjectSettings.get_setting("display/window/stretch/mode"), " / ", ProjectSettings.get_setting("display/window/stretch/aspect"))
|
||||||
|
print("=== 键位：1 直通 | 2 反色 | 3 红染 | 4 纯绿 | V 显隐后处理 | S 截图 | Esc 退出 ===")
|
||||||
@@ -0,0 +1,26 @@
|
|||||||
|
shader_type canvas_item;
|
||||||
|
|
||||||
|
// ============================================================================
|
||||||
|
// 探针 P1 shader —— SCREEN_TEXTURE 语义（架构 §11 P1 / §5.2 ADR-2）
|
||||||
|
// 由 probe_p1.gd 以 ShaderMaterial 挂到 L1 全屏 ColorRect 上。
|
||||||
|
// mode（uniform int）：
|
||||||
|
// 0 直通 —— 验证"背景/世界是否含入 SCREEN_TEXTURE 采样"
|
||||||
|
// 1 反色 —— 放大世界内容差异，便于肉眼确认采样到了 L0
|
||||||
|
// 2 红色染色 —— L1 全屏染色：验证 L2 UI 是否被后处理污染（UI 应保持原色 crisp）
|
||||||
|
// 3 纯绿 —— 顺序验证：整屏变绿 = CanvasLayer 排序 L0<L1<L2 符合预期
|
||||||
|
// ============================================================================
|
||||||
|
|
||||||
|
uniform int mode = 0;
|
||||||
|
|
||||||
|
void fragment() {
|
||||||
|
vec4 screen = texture(SCREEN_TEXTURE, SCREEN_UV);
|
||||||
|
if (mode == 0) {
|
||||||
|
COLOR = screen;
|
||||||
|
} else if (mode == 1) {
|
||||||
|
COLOR = vec4(1.0 - screen.rgb, screen.a);
|
||||||
|
} else if (mode == 2) {
|
||||||
|
COLOR = vec4(screen.r, 0.0, 0.0, 1.0);
|
||||||
|
} else {
|
||||||
|
COLOR = vec4(0.0, 1.0, 0.0, 1.0);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
[gd_scene load_steps=2 format=3]
|
||||||
|
|
||||||
|
[ext_resource type="Script" path="res://tests/probe_p1_screen_texture/probe_p1.gd" id="1"]
|
||||||
|
|
||||||
|
[node type="Node" name="ProbeP1ScreenTexture"]
|
||||||
|
script = ExtResource("1")
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
# 探针 P3 —— NoiseTexture2D / FastNoiseLite 平铺语义
|
||||||
|
|
||||||
|
验证 `seamless = true` 是否真正可平铺（架构 §11 P3；纸纹 pass 的 tileable 前提，管线报告 §6.3）。
|
||||||
|
屏上为 `seamless = true/false` 两个 2×2 平铺网格（红线 = tile 边界）；按 `S` 生成边界差图 PNG（`user://p3_diff_*.png`）并打印 wrap/grad 比统计。
|
||||||
|
|
||||||
|
**完整实测手册（必读，约 30 分钟）**：
|
||||||
|
`docs/engineering/2026-10-19-f-w1-probe-p3-manual.md`（本仓库外的工作区文档树）
|
||||||
|
|
||||||
|
**跑法**：编辑器打开 `tests/probe_p3_noise_tiling/probe_p3.tscn` → F6 运行当前场景。
|
||||||
|
键位：`S` 生成检查图 + 打印统计 / `Esc` 退出。
|
||||||
|
|
||||||
|
**结论回填**：`docs/engineering/probes/P3-result.md`
|
||||||
|
**不过的回退**：脚本预烘焙无缝纹理（用 Image 环绕混合生成 256² 纸纹源，不进 NoiseTexture2D）。
|
||||||
|
|
||||||
|
**知识缺口标注**：`FastNoiseLite.TYPE_SIMPLEX` / `FRACTAL_FBM` / `NoiseTexture2D.seamless` / `seamless_blend_ratio`
|
||||||
|
为 4.x 稳定名；若 4.7.2 打开报错，按实际属性名修正并记录到 `docs/engineering/`。
|
||||||
@@ -0,0 +1,167 @@
|
|||||||
|
extends Node2D
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# 探针 P3 —— NoiseTexture2D / FastNoiseLite 平铺语义（架构 §11 P3）
|
||||||
|
# 依据：管线报告 §6.3；作用于 §5.2 纸纹 pass（双尺度 noise 有序抖动的 tileable 前提）
|
||||||
|
# 实测手册：docs/engineering/2026-10-19-f-w1-probe-p3-manual.md
|
||||||
|
# 结论回填：docs/engineering/probes/P3-result.md
|
||||||
|
#
|
||||||
|
# 验证：seamless = true 是否真正可平铺
|
||||||
|
# - 屏上：左右两个 2×2 tile 网格（红线 = tile 边界 @256px）肉直视读接缝
|
||||||
|
# - 按 S：生成边界差图 PNG（user://p3_diff_*.png）+ 控制台统计
|
||||||
|
# * wrap_* = |左边缘-右边缘| / |上边缘-下边缘|（平铺接缝强度）
|
||||||
|
# * grad_mean = 相邻像素平均差（自然梯度基线）
|
||||||
|
# * seamless 若有效：wrap ≈ grad（同数量级）；若无效：wrap >> grad
|
||||||
|
#
|
||||||
|
# 知识缺口：FastNoiseLite/NoiseTexture2D 属性名（seamless / seamless_blend_ratio /
|
||||||
|
# TYPE_SIMPLEX / FRACTAL_FBM）为 4.x 稳定名；4.7.2 若报错按实际属性名修正并记录。
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
const NOISE_SIZE := 256 # 每 tile 256×256；面板 512×512 = 2×2 平铺
|
||||||
|
const PANEL_SIZE := 512
|
||||||
|
|
||||||
|
var _textures: Array = []
|
||||||
|
|
||||||
|
|
||||||
|
func _ready() -> void:
|
||||||
|
_textures = [_make_texture(true), _make_texture(false)]
|
||||||
|
var positions := [Vector2(96, 160), Vector2(672, 160)]
|
||||||
|
var titles := ["seamless = true", "seamless = false"]
|
||||||
|
for i in _textures.size():
|
||||||
|
var tr := TextureRect.new()
|
||||||
|
tr.name = "Panel%d" % i
|
||||||
|
tr.texture = _textures[i]
|
||||||
|
tr.position = positions[i]
|
||||||
|
tr.size = Vector2(PANEL_SIZE, PANEL_SIZE)
|
||||||
|
tr.stretch_mode = TextureRect.STRETCH_TILE
|
||||||
|
tr.mouse_filter = Control.MOUSE_FILTER_IGNORE
|
||||||
|
add_child(tr)
|
||||||
|
var overlay := SeamOverlay.new()
|
||||||
|
overlay.position = positions[i]
|
||||||
|
add_child(overlay)
|
||||||
|
var t := Label.new()
|
||||||
|
t.name = "PanelTitle%d" % i
|
||||||
|
t.text = "%s（红线 = tile 边界；面板内 2×2 平铺）" % titles[i]
|
||||||
|
t.position = Vector2(int(positions[i].x), 128)
|
||||||
|
t.add_theme_color_override("font_color", Color.WHITE)
|
||||||
|
add_child(t)
|
||||||
|
var hud := Label.new()
|
||||||
|
hud.name = "HUDHelp"
|
||||||
|
hud.text = "探针 P3 | 对比两侧红线处接缝（错位/亮度跳变=异常）| S 生成检查图到 user:// 并打印统计 | Esc 退出"
|
||||||
|
hud.position = Vector2(96, 648)
|
||||||
|
hud.add_theme_color_override("font_color", Color.WHITE)
|
||||||
|
add_child(hud)
|
||||||
|
_print_environment()
|
||||||
|
|
||||||
|
|
||||||
|
func _make_texture(seamless: bool) -> NoiseTexture2D:
|
||||||
|
var fnl := FastNoiseLite.new()
|
||||||
|
fnl.seed = 20261019
|
||||||
|
fnl.noise_type = FastNoiseLite.TYPE_SIMPLEX
|
||||||
|
fnl.frequency = 0.02
|
||||||
|
fnl.fractal_type = FastNoiseLite.FRACTAL_FBM
|
||||||
|
fnl.fractal_octaves = 3
|
||||||
|
fnl.fractal_lacunarity = 2.0
|
||||||
|
fnl.fractal_gain = 0.5
|
||||||
|
var nt := NoiseTexture2D.new()
|
||||||
|
nt.width = NOISE_SIZE
|
||||||
|
nt.height = NOISE_SIZE
|
||||||
|
nt.noise = fnl
|
||||||
|
nt.seamless = seamless
|
||||||
|
nt.seamless_blend_ratio = 0.25
|
||||||
|
nt.generate_mipmaps = false
|
||||||
|
return nt
|
||||||
|
|
||||||
|
|
||||||
|
func _input(event: InputEvent) -> void:
|
||||||
|
var key_event := event as InputEventKey
|
||||||
|
if key_event != null and key_event.pressed and not key_event.echo:
|
||||||
|
match key_event.keycode:
|
||||||
|
KEY_S:
|
||||||
|
_generate_check_images()
|
||||||
|
KEY_ESCAPE:
|
||||||
|
get_tree().quit()
|
||||||
|
|
||||||
|
|
||||||
|
func _generate_check_images() -> void:
|
||||||
|
var names := ["seamless", "periodic"]
|
||||||
|
print("=== P3 检查图与统计 ===")
|
||||||
|
for i in _textures.size():
|
||||||
|
var nt: NoiseTexture2D = _textures[i]
|
||||||
|
var img := nt.get_image()
|
||||||
|
if img == null:
|
||||||
|
push_warning("P3: NoiseTexture2D.get_image() 返回 null（%s）。回退：系统截图（Win+Shift+S）+ 肉眼判读。" % names[i])
|
||||||
|
continue
|
||||||
|
var w := img.get_width()
|
||||||
|
var h := img.get_height()
|
||||||
|
# 边界差图（×8 放大）：wrap 接缝越亮 = 平铺越不连续
|
||||||
|
var strip_v := Image.create(w, h, false, Image.FORMAT_RGBA8)
|
||||||
|
var strip_h := Image.create(w, h, false, Image.FORMAT_RGBA8)
|
||||||
|
for y in h:
|
||||||
|
var dv := _amp(absf(img.get_pixel(0, y).r - img.get_pixel(w - 1, y).r))
|
||||||
|
for x in w:
|
||||||
|
strip_v.set_pixel(x, y, Color(dv, dv, dv, 1.0))
|
||||||
|
for x in w:
|
||||||
|
var dh := _amp(absf(img.get_pixel(x, 0).r - img.get_pixel(x, h - 1).r))
|
||||||
|
for y in h:
|
||||||
|
strip_h.set_pixel(x, y, Color(dh, dh, dh, 1.0))
|
||||||
|
strip_v.save_png("user://p3_diff_v_%s.png" % names[i])
|
||||||
|
strip_h.save_png("user://p3_diff_h_%s.png" % names[i])
|
||||||
|
var stats := _edge_stats(img)
|
||||||
|
print("%s: wrap_v mean=%.5f max=%.5f | wrap_h mean=%.5f max=%.5f | grad_mean=%.5f → wrap/grad v=%.2fx h=%.2fx" % [
|
||||||
|
names[i], stats.wrap_v_mean, stats.wrap_v_max, stats.wrap_h_mean, stats.wrap_h_max, stats.grad_mean,
|
||||||
|
stats.wrap_v_mean / maxf(stats.grad_mean, 1e-9), stats.wrap_h_mean / maxf(stats.grad_mean, 1e-9)])
|
||||||
|
print("PNG 位置：%APPDATA%/Godot/app_userdata/<项目名>/p3_diff_*.png")
|
||||||
|
print("判读：seamless 行 wrap/grad ≈ 1-3x = 可用；periodic 行 wrap/grad ≫ 1 = 对照组生效（说明指标有效）")
|
||||||
|
|
||||||
|
|
||||||
|
func _amp(d: float) -> float:
|
||||||
|
return clampf(d * 8.0, 0.0, 1.0)
|
||||||
|
|
||||||
|
|
||||||
|
func _edge_stats(img: Image) -> Dictionary:
|
||||||
|
var w := img.get_width()
|
||||||
|
var h := img.get_height()
|
||||||
|
var wrap_v := 0.0
|
||||||
|
var wrap_v_max := 0.0
|
||||||
|
for y in h:
|
||||||
|
var d := absf(img.get_pixel(0, y).r - img.get_pixel(w - 1, y).r)
|
||||||
|
wrap_v += d
|
||||||
|
wrap_v_max = maxf(wrap_v_max, d)
|
||||||
|
var wrap_h := 0.0
|
||||||
|
var wrap_h_max := 0.0
|
||||||
|
for x in w:
|
||||||
|
var d := absf(img.get_pixel(x, 0).r - img.get_pixel(x, h - 1).r)
|
||||||
|
wrap_h += d
|
||||||
|
wrap_h_max = maxf(wrap_h_max, d)
|
||||||
|
var grad := 0.0
|
||||||
|
for y in h:
|
||||||
|
for x in w - 1:
|
||||||
|
grad += absf(img.get_pixel(x, y).r - img.get_pixel(x + 1, y).r)
|
||||||
|
return {
|
||||||
|
"wrap_v_mean": wrap_v / h,
|
||||||
|
"wrap_v_max": wrap_v_max,
|
||||||
|
"wrap_h_mean": wrap_h / w,
|
||||||
|
"wrap_h_max": wrap_h_max,
|
||||||
|
"grad_mean": grad / float((w - 1) * h),
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
func _print_environment() -> void:
|
||||||
|
var v := Engine.get_version_info()
|
||||||
|
print("=== P3 probe 环境 ===")
|
||||||
|
print("godot: %d.%d.%d %s" % [int(v.major), int(v.minor), int(v.patch), str(v.status)])
|
||||||
|
print("rendering_method: ", ProjectSettings.get_setting("rendering/renderer/rendering_method"))
|
||||||
|
print("adapter: ", RenderingServer.get_video_adapter_name())
|
||||||
|
print("noise: FastNoiseLite simplex fbm oct3 f0.02 | tile 256×256 | blend_ratio 0.25")
|
||||||
|
|
||||||
|
|
||||||
|
class SeamOverlay extends Node2D:
|
||||||
|
const TILE := 256
|
||||||
|
const PANEL := 512
|
||||||
|
|
||||||
|
func _draw() -> void:
|
||||||
|
var c := Color(1.0, 0.2, 0.2, 0.6)
|
||||||
|
draw_line(Vector2(TILE, 0), Vector2(TILE, PANEL), c, 1.0)
|
||||||
|
draw_line(Vector2(0, TILE), Vector2(PANEL, TILE), c, 1.0)
|
||||||
|
draw_rect(Rect2(Vector2.ZERO, Vector2(PANEL, PANEL)), c, false, 1.0)
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
[gd_scene load_steps=2 format=3]
|
||||||
|
|
||||||
|
[ext_resource type="Script" path="res://tests/probe_p3_noise_tiling/probe_p3.gd" id="1"]
|
||||||
|
|
||||||
|
[node type="Node2D" name="ProbeP3NoiseTiling"]
|
||||||
|
script = ExtResource("1")
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# tests/sim_reports —— 模拟器 14 门报告 report-<date>.json（git 跟踪，月度对账证据）。W4 首轮（架构 §9.3/§10.3）。
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# tests/unit —— GUT 单测（core 全覆盖：公式/迁移/格式化）。W3 激活；GUT addon 待合入（CI W3 占位）。
|
||||||
Reference in new issue
Block a user