大家好！我是 @qian-o，Zenith.NET v0.0.6 正式發佈了！

這個版本的核心主題是 精簡：為了讓 API 更好地適配即將上線的 Metal 後端，我們對資源綁定模型、着色器階段和光線追蹤方案做了一次大規模的重構和瘦身。

📦 GitHub 倉庫：https://github.com/qian-o/Zenith.NET
📚 文檔站點：https://qian-o.github.io/Zenith.NET

🎯 項目簡介

Zenith.NET 是一個現代的、跨平台的 .NET 圖形與計算庫，旨在為 .NET 開發者提供統一的 GPU 編程接口。無論你是要做高性能渲染、圖形應用，還是 GPU 通用計算，Zenith.NET 都能幫你屏蔽底層 API 的差異，讓代碼在不同平台上無縫運行。

✨ 本次更新亮點

🔄 ResourceSet → ResourceTable

資源集合從 ResourceSet 全面更名為 ResourceTable，綁定方式也做了簡化：

之前：commandBuffer.SetResourceSet(resourceSet, index);
現在：commandBuffer.SetResourceTable(resourceTable);

不再需要手動傳入索引，使用更直觀。

📦 單一 ResourceLayout

所有管線描述（Graphics / Compute / MeshShading）中的 ResourceLayout[] 統一改為單個 ResourceLayout?。這個改動大幅降低了資源綁定的複雜度，同時也更貼合 Metal 的設計模型，為後續 Metal 後端上線掃清了障礙。

🚀 移除 RayTracingPipeline，擁抱 RayQuery

這是本次最大的變更。我們移除了獨立的 RayTracingPipeline，包括 HitGroup、DispatchRays() 等全部相關 API。

光線追蹤現在統一通過 RayQuery 實現，可以在任意着色器階段中使用，不再需要專用的光追管線。這個方向更靈活，跨後端兼容性也更好。

✂️ 清理歷史着色器階段

移除了 Hull、Domain、Geometry 等傳統着色器階段，以及所有光追專用階段（RayGeneration、Miss、ClosestHit 等）。PrimitiveTopology 也精簡掉了鄰接拓撲和 PatchList。

這些功能在現代圖形 API 中已經被 Mesh Shading 和 RayQuery 取代，清理後 API 表面更小更乾淨。

📐 MeshShading 線程組大小

MeshShadingPipelineDesc 新增了 Object 和 Mesh 階段的線程組大小字段，給予開發者更精細的調度控制。

🍎 Apple 平台統一命名

文檔和 Issue 模板中原來分開的 "macOS" 和 "iOS" 統一為 Apple 標籤，更清晰地表達對整個蘋果生態的支持。

⚠️ 破壞性變更一覽

如果你從 v0.0.5 升級，請注意以下改動：

• ResourceSet / ResourceSetDesc → ResourceTable / ResourceTableDesc
• ResourceLayout[] → ResourceLayout?
• SetResourceSet(resourceSet, index) → SetResourceTable(resourceTable)
• RayTracingPipeline、HitGroup、DispatchRays() 已移除，請改用 RayQuery
• Hull、Domain、Geometry 着色器階段已移除
• PrimitiveTopology 鄰接拓撲和 PatchList 已移除

🗺️ 接下來的計劃

• Metal 後端 — 將在近期版本中正式上線，初步計劃基於 SharpMetal 或 .NET macios TFM 搭建，具體技術路線還在評估中
• SkiaSharp 集成

🚧 當前狀態

• ⚠️ 預覽版本 — API 後續仍可能有破壞性變更
• ⚠️ Metal 後端開發中 — macOS / iOS 原生支持即將到來
• ✅ 文檔已上線 — 入門教程和 API 參考已可用
• ✅ 6 大 UI 框架集成 — 覆蓋主流 .NET UI 方案

💬 討論與反饋

如果你有任何疑問、建議、Bug 反饋或功能請求，歡迎通過 GitHub Issues 和 Discussions 交流。

🧧 今天是除夕，祝全球華人 2026 新春快樂，馬年大吉，萬事如意！

感謝大家的關注和支持，歡迎 Star ⭐ 和提 Issue，我們下個版本見！🚀