WinForge Native · WinForge 原生版

WinForge Native is an independent, experimental C++20/C++/WinRT port of WinForge. The .NET 11 WinUI 3 application remains the canonical, feature-complete shipping app. This repository does not replace it.

WinForge Native 係 WinForge 嘅獨立實驗性 C++20／C++/WinRT 移植版。正式、功能完整同持續發佈嘅版本仍然係 .NET 11 WinUI 3 app；呢個 repository 唔會取代佢。

Current status · 目前狀態

• 346 fixed routes and five dynamic route families are tracked against a pinned managed-oracle snapshot.

• 38 fixed routes currently have genuine native renderers and remain marked in-progress until every evidence dimension passes; 308 are not-started.

• Standard-C++ logic is isolated in src/WinForge.Core; the WinUI 3 shell is in src/WinForge.App.

• The release payload is C++ only: no CLR hosting, C++/CLI, managed launcher/updater, or managed executable delegation.

• 對住固定受控版 oracle snapshot 追蹤 346 條固定 route 同五組動態 route。

• 目前 38 條固定 route 有真正原生 renderer；未齊全部證據前仍標示 in-progress，其餘 308 條係 not-started。

• 標準 C++ 邏輯喺 src/WinForge.Core，WinUI 3 shell 喺 src/WinForge.App。

• 發佈內容只限 C++：唔用 CLR hosting、C++/CLI、受控版 launcher/updater，亦唔會轉交功能畀受控版 executable。

Build · 建置

Requirements: Windows 11, Visual Studio 2022 with MSVC v143 C++ UWP tools and Windows SDK 10.0.26100+, PowerShell, NuGet restore support, and vcpkg.

vcpkg install --triplet x64-windows-static --x-manifest-root=.
msbuild WinForge.Native.sln /t:Restore /p:RestorePackagesConfig=true /p:Configuration=Debug /p:Platform=x64
msbuild WinForge.Native.sln /p:Configuration=Debug /p:Platform=x64
tests\native\WinForge.Core.Tests\bin\x64\Debug\WinForge.Core.Tests.exe
powershell -ExecutionPolicy Bypass -File eng\native\Test-NativeCatalogParity.ps1
powershell -ExecutionPolicy Bypass -File eng\native\Test-NativeInstallerContract.ps1

The repository driver discovers the installed MSVC/UWP toolchain and its bundled vcpkg, restores PCRE2 and NuGet packages, and can build, deep-link, and capture one owned window:

powershell -ExecutionPolicy Bypass -File .agents\skills\run-winforge\driver.ps1 -Build -Page percent -NoCapture

Oracle synchronization · Oracle 同步

oracle/managed-catalog-manifest.json is an immutable snapshot from codingmachineedge/WinForge commit 8d1050228a12782e0f96deb654ee2509267cbbab. Release CI validates against that committed snapshot and never follows an unpinned upstream branch.

To intentionally refresh the catalog, check out an exact managed WinForge commit and run:

powershell -ExecutionPolicy Bypass -File eng\native\Export-NativeCatalog.ps1 `
  -ManagedRepoRoot C:\path\to\pinned\WinForge

Review the generated catalog and parity-ledger implications before committing. · 如要更新 catalog，必須指定已固定 commit 嘅受控版 checkout，並喺提交前審核所有 catalog 同 parity ledger 影響。

Releases and history · 發佈同歷史

Every successful push or manual release workflow run builds and tests first, then publishes one installer plus one portable ZIP under the new native-v1.1.x series. Historical native-v1.0.x tags, releases, assets, and download URLs remain in the original WinForge releases as immutable provenance; they were not copied or deleted.

每次成功 push 或手動 release workflow 都會先建置同測試，再發佈一個安裝程式同一個可攜 ZIP，版本由新 native-v1.1.x 系列開始。舊 native-v1.0.x tag、release、asset 同下載連結繼續保留喺原本 WinForge releases 做不可變來源證明，冇複製亦冇刪除。

See the published documentation, repository documentation, roadmap, and handoff. Licensed under MIT.