Merge pull request #233 from gameknife/dev

Dev

Author: gameknife

.gitattributes

@@ -0,0 +1 @@
+assets/typescript/Engine.d.ts text eol=lf

.github/workflows/gnb-release.yml

@@ -7,8 +7,12 @@ on:
       - dev
     paths:
       - 'tools/gnb/**/*.go'
+      - 'tools/gnb/**/*.html'
       - 'tools/gnb/go.mod'
       - 'tools/gnb/go.sum'
+      - 'scripts/gnb-init.sh'
+      - 'scripts/gnb-init.ps1'
+      - 'scripts/publish-gnb.ps1'
   workflow_dispatch:
 
 concurrency:

.github/workflows/linux_self.yml

@@ -20,5 +20,12 @@ jobs:
       - uses: actions/checkout@v4
         with:
           clean: false
+      - uses: actions/setup-go@v5
+        with:
+          go-version-file: tools/gnb/go.mod
+      - name: Build latest gnb
+        run: |
+          cd tools/gnb
+          go build -trimpath -ldflags="-s -w -X main.version=$(git -C "$GITHUB_WORKSPACE" rev-parse HEAD)" -o "$GITHUB_WORKSPACE/gnb" ./cmd/gnb
       - run: ./gnb.sh setup
       - run: ./gnb.sh build

.github/workflows/macos_self.yml

@@ -20,5 +20,12 @@ jobs:
       - uses: actions/checkout@v4
         with:
           clean: false
+      - uses: actions/setup-go@v5
+        with:
+          go-version-file: tools/gnb/go.mod
+      - name: Build latest gnb
+        run: |
+          cd tools/gnb
+          go build -trimpath -ldflags="-s -w -X main.version=$(git -C "$GITHUB_WORKSPACE" rev-parse HEAD)" -o "$GITHUB_WORKSPACE/gnb" ./cmd/gnb
       - run: ./gnb.sh setup
       - run: ./gnb.sh build

.gitignore

@@ -360,6 +360,7 @@ cmake-build-*/
 /imgui.ini
 /editor.ini
 /traces/
+/ai_secrets.local.json
 
 # spec local test glb
 assets/models/bistro_simple.glb
@@ -395,6 +396,7 @@ assets/textures/studio_small_09_1k.hdr
 assets/textures/sunset_fairway_1k.hdr
 assets/textures/umhlanga_sunrise_1k.hdr
 tools/optional-pak/output/
+tools/brotato3d-pak/output/
 
 # third party libraries
 src/ThirdParty/*/bin/
@@ -421,3 +423,12 @@ android/app/libs/SDL3-*.aar
 # Phase 3 占位资产 — 受版权保护，不得入库
 assets/_placeholder/*
 !assets/_placeholder/README.md
+
+# Brotato3D SFX/icons — 已从 _placeholder 升格为正式路径，但内容仍为 Brotato 解包参考资产，
+# 翻新（替换为自制 / CC0）之前不得入库。
+assets/sounds/brotato3d/sfx/
+assets/textures/brotato3d/icons/
+assets/paks/brotato3d.pak
+
+# 本地草稿、宣传材料 — 不入库，仅本地保留
+marketing/

.spec/ARCHIVE.md

@@ -0,0 +1,18 @@
+# Archive
+
+## Pre-workflow（2026-05-14 之前）
+
+从旧版根目录 `TODO.md` 迁移。无 ID、无 journal，仅保留原始描述。
+
+- [x] 提交当前修改
+- [x] 确认 AmbientCube 的改造，目前 Voxel 的更新和 GPU 读取是正确的，但 AmbientCube 感觉没有工作。但 hwlightbake 在执行
+- [x] 提交目前的修改
+- [x] 清理上下文
+- [x] 恢复 wireframe 的工作，这里 wireframePipeline_，可考虑直接写在 imgui 绘制前，直接绘制在最终输出之上。不要像之前一样尝试写在 RT_DENOISED 上
+- [x] Options 下的 bool HotReload{true} 已经废弃，移除整个选项以及相关无用的逻辑
+- [x] wireframe 的修改有些问题，只有当 scale 为 native 的时候，绘制正常。当使用 quality 等缩放模式的时候，线框会位于画面的左上角。修复这个问题
+- [x] 提交目前的修改
+- [x] 把本地 feature/productive-ui-refactor 分支关于 ui 的重构以及前面的 Brotato3D Tweaks 的提交合并到本分支，并运行验证通过
+- [x] 彻底解决 LDraw 的那个单元测试错误，如果是因为 Optional 资源问题，实在不行，干掉它
+- [x] 目前 .\gnb.bat run xxxx 无法带上 target 本身支持的 cmdline，很不方便，请改造。比如 .\gnb.bat run gkNextRenderer --help，可以把 gkNextRenderer 本身的 help 打印出来。当然不一定是我说的这样，能够有办法带参数即可
+- [x] Brotato3D 目前应该在游戏过程中一直在重建 BVH 和刷新 voxel 数据。我希望是尽量减少刷新，除了一开始的场景，后续主角，敌人的移动，动态碎块，prop 都不应该影响 BVH 和 voxel。这样 cpu 线程压力会小很多。请作这个调整。

.spec/README.md

@@ -0,0 +1,108 @@
+# .spec — 交互式工作流规范
+
+gkNextRenderer 项目的 spec 驱动开发工作流目录。AGENT 在当前 session 内根据这些文件调度任务，**不调用其他 agent，不 sleep**。
+
+## 文件结构
+
+| 路径 | 用途 | 谁写 |
+| --- | --- | --- |
+| `TODO.md` | 活跃任务列表 | 用户（任务内容）+ AGENT（状态字符、journal 链接） |
+| `ARCHIVE.md` | 归档的完成任务 | `gnb todo archive` 或用户 |
+| `specs/<id>.md` | 复杂任务的详细规格，**仅 spec 类任务需要** | 用户 |
+| `journal/<id>.md` | 任务完成报告，一任务一文件 | AGENT |
+| `blockers/<id>.md` | AGENT 卡住时的提问，一任务一文件 | AGENT |
+
+## TODO.md 格式
+
+```markdown
+# TODO
+
+## Milestone: <名字>  <!-- status: active|done -->
+
+### 下一步
+- [ ] `#00018` [P0][BUG] 修复贴图采样越界
+- [/] `#00019` [P1][FEAT] 体积雾 → specs/00019.md
+- [!] `#00020` [SPIKE] work graphs (blockers/00020.md)
+
+### 待规划
+- [ ] `#00021` [IDEA] 试试 NRD 降噪
+
+### 最近完成
+- [x] `#00017` [BUG] 修复贴图过滤 → journal/00017.md (2026-05-13)
+```
+
+### 三个段落
+
+- **下一步**：AGENT 只扫这一段，按从上到下顺序执行
+- **待规划**：想法池/积压。AGENT **完全不动**，从待规划挪到下一步由用户操作
+- **最近完成**：累积完成的任务，定期由 `gnb todo archive` 移到 ARCHIVE.md
+
+### 状态字符
+
+| 字符 | 含义 |
+| --- | --- |
+| `[ ]` | pending |
+| `[/]` | doing（执行中，正常不持久化此状态，crash 恢复用） |
+| `[x]` | done |
+| `[!]` | blocked（对应 `blockers/<id>.md` 有说明） |
+
+### ID
+
+五位全局递增数字 `#00001` ~ `#99999`。新 ID 取当前所有任务（含 ARCHIVE）中最大 ID + 1。
+
+### 内联标签
+
+- 优先级：`[P0]` `[P1]` `[P2]`
+- 类型：`[BUG]` `[FEAT]` `[IDEA]` `[SPIKE]` `[REFACTOR]` `[DOC]`
+
+## journal/`<id>`.md 格式
+
+```markdown
+---
+task: 00018
+completed: 2026-05-14T15:30:00
+build_ok: true
+---
+
+## 做了什么
+…
+
+## 改动文件
+- `src/Rendering/VolumeFog.cpp`
+
+## 风险/遗留
+- ⚠️ 与 SSR 有交互问题，未处理
+```
+
+## blockers/`<id>`.md 格式
+
+```markdown
+---
+task: 00018
+blocked_at: 2026-05-14T15:30:00
+---
+
+## 歧义点
+任务描述里说"修复采样越界"，但越界发生在两处：
+1. `SampleEnvironment.hlsl:42` — 已知问题
+2. `VolumeFog.cpp:128` — 看上去也有类似模式
+
+## 候选方案
+- A. 只修 1
+- B. 修 1 + 2
+
+等用户答复后继续。
+```
+
+## AGENT 行为边界
+
+**可改**：
+- TODO.md 中任务的状态字符（`[ ]` → `[x]` / `[!]`）
+- TODO.md 中任务行末追加 journal 链接
+- `journal/`、`blockers/` 下的文件
+
+**不可改**：
+- TODO.md 中任务标题、ID、优先级、类型、所属段落
+- `specs/` 下的文件（用户写的需求）
+- `ARCHIVE.md`（归档由工具或用户操作）
+- "待规划"段任何任务

.spec/TODO.md

@@ -0,0 +1,33 @@
+# TODO
+
+## Milestone: 工作流落地  <!-- status: active -->
+
+### 下一步
+
+### 待规划
+- [ ] `#00024` [FEAT] AIService Agent 化 Phase 8：MagicaLego AI 接入 agent loop → specs/00024.md
+- [ ] `#00025` [DOC] AIService Agent 化 Phase 9：端到端集成测试 + AGENT_GUIDE/AIAgentSystem.md → specs/00025.md
+- [ ] `#00007` [FEAT] 目前的vcpkg是固定在一个老版本的，把项目依赖升级到最新的vcpkg版本，2026.04.27。并绑定版本，解决各种编译和运行问题。
+- [ ] `#00011` [IDEA] gnb在gkmini上host一个持久的todolist，作为一个“服务器”同步，可以随时随地进行任务管理
+- [ ] `#00012` [FEAT] 让 gkNextRenderer 主管线原生运行在浏览器（WebGPU 后端） → specs/00012.md
+
+### 最近完成
+- [x] `#00001` [IDEA] 介绍gnb技术栈  → journal/00001.md (2026-05-14)
+- [x] `#00002` [IDEA] 介绍typescript整合  → journal/00002.md (2026-05-14)
+- [x] `#00003` 介绍brotato3D  → journal/00003.md (2026-05-18)
+- [x] `#00004` [IDEA] 介绍flappybird  → journal/00004.md (2026-05-18)
+- [x] `#00005` [FEAT] 在windows下，设置 SDL 的 Windows DPI awareness 为 unaware, 使用系统拉伸的方式适配DPI缩放  → journal/00005.md (2026-05-18)
+- [x] `#00008` [IDEA] gnb的todolist要增加维护功能，可以调换add的任务顺序。
+- [x] `#00009` [IDEA] gnb需要能够给add的task增加spec文件，写明执行的详细背景信息
+- [x] `#00013` [REFACTOR] 重构 SwModernNoAmbient 渲染流程：Lambert+IBL + CSM 阴影 → journal/00013.md (2026-05-20)
+- [x] `#00014` [FEAT] 把 `gnb loc` 接到 dashboard（分类表格 + 柱图），同步关闭 #00010 → journal/00014.md (2026-05-26)
+- [x] `#00016` [DOCS] AGENTS.md 维护：对照当前项目结构清理过时信息（含已删/重命名的模块、命令、特性），补全新增子项目与工具（dashboard chat、loc、CSM 等），控制总篇幅 → journal/00016.md (2026-05-26)
+- [x] `#00017` [REFACTOR] AIService Agent 化 Phase 1：LLM 协议升级（tools schema + provider Chat 接口） → journal/00017.md (2026-05-27)
+- [x] `#00018` [FEAT] AIService Agent 化 Phase 2：本地 llama provider（复用 gnb llama-server，PID 自动发现） → journal/00018.md (2026-05-27)
+- [x] `#00019` [FEAT] AIService Agent 化 Phase 3：Agent Loop + Tool Registry + 主线程 dispatcher → journal/00019.md (2026-05-27)
+- [x] `#00020` [FEAT] AIService Agent 化 Phase 4：通用知识工具（list_dir/find_symbol/read_file/git_log 等，C++ 移植 gnb） → journal/00020.md (2026-05-27)
+- [x] `#00021` [FEAT] AIService Agent 化 Phase 5：编辑器工具集（包装 EditorScriptExecutor + DEFERRED high-risk） → journal/00021.md (2026-05-27)
+- [x] `#00022` [FEAT] AIService Agent 化 Phase 6：AI Panel UI 升级（步骤可视化 + 停止 + 模式开关） → journal/00022.md (2026-05-27)
+- [x] `#00023` [REFACTOR] AIService Agent 化 Phase 7：FEditorAIService 主路径切换到 agent，砍掉大 system prompt → journal/00023.md (2026-05-27)
+- [x] `#00026` [IDEA] 让SCAD的LLM生成结果更加结构化，按module拆分文件 → specs/00026.md → journal/00026.md (2026-05-31)
+- [x] `#00027` [IDEA] 优化SCAD Studio的交互逻辑 → specs/00027.md (blockers/00027.md)

.spec/journal/00001.md

@@ -0,0 +1,23 @@
+---
+task: 00001
+completed: 2026-05-14T16:53:33.4733882+08:00
+build_ok: false
+---
+
+## 做了什么
+
+补了一份 `gnb` 技术栈说明文档，介绍它的启动层、CLI 层、配置层、执行模块层、外部依赖和维护边界。
+
+同时在现有 `docs/gnb-cli.md` 和 `tools/gnb/README.md` 中加入跳转，避免 `gnb` 只有命令手册，没有实现视角的入口说明。
+
+## 改动文件
+
+- `docs/gnb-tech-stack.md`
+- `docs/gnb-cli.md`
+- `tools/gnb/README.md`
+- `.spec/TODO.md`
+
+## 风险/遗留
+
+- 未运行构建或自动化测试；本次仅修改 Markdown 文档和 spec 元数据。
+- `TODO.md` 中当前存在重复的 `#00001` 编号（“下一步”和“待规划”各一条），本次按 spec 边界未改任务标题或 ID。

.spec/journal/00002.md

@@ -0,0 +1,23 @@
+---
+task: 00002
+completed: 2026-05-14T17:02:32.2719456+08:00
+build_ok: false
+---
+
+## 做了什么
+
+新增 TypeScript 整合说明文档，介绍 `assets/typescript` 到 `assets/scripts` 的编译路径、bundled `tsc` 工具链、QuickJS 模块加载、生命周期封装、绑定与 `Engine.d.ts` 生成、热重载行为和验证方式。
+
+同时在 README 的 QuickJS 能力介绍和 `AGENT_GUIDE/QuickJSBindings.md` 中加入入口链接，方便从项目概览或绑定 cookbook 跳到这份说明。
+
+## 改动文件
+
+- `docs/typescript-integration.md`
+- `README.md`
+- `AGENT_GUIDE/QuickJSBindings.md`
+- `.spec/TODO.md`
+
+## 风险/遗留
+
+- 未运行构建或自动化测试；本次仅修改 Markdown 文档和 spec 元数据。
+- 工作区中存在与本任务无关的既有变更，本次未处理。