Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 36 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,42 @@ concurrency:
cancel-in-progress: true

jobs:
nvidia-runtime:
name: NVIDIA runtime clean startup regression
runs-on: windows-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
- name: Restore the known incomplete official release runtime
shell: pwsh
run: |
$archive = Join-Path $env:RUNNER_TEMP 'GoAgent-0.4.21-win-x64-nvidia-portable.7z'
Invoke-WebRequest 'https://github.com/wimi321/GoAgent/releases/download/v0.4.21/GoAgent-0.4.21-win-x64-nvidia-portable.7z' -OutFile $archive
if ((Get-FileHash -LiteralPath $archive -Algorithm SHA256).Hash -ne '7b52ab7e87e3356c22f28ec028bb7c91f2e825f9e78ddcb894f0d313ab2ac8a8') { throw 'Regression archive SHA-256 mismatch' }
& 7z x $archive '-o.nvidia-regression' 'resources/data/katago/bin/win32-x64/*' -y
if ($LASTEXITCODE -ne 0) { throw 'Regression runtime extraction failed' }
- name: Reject original missing NVRTC even if runner has CUDA installed
shell: pwsh
run: |
node --input-type=module -e "import assert from 'node:assert/strict'; import {checkWindowsRuntimeDependencies} from './scripts/lib/windows_pe_dependencies.mjs'; await assert.rejects(checkWindowsRuntimeDependencies('.nvidia-regression/resources/data/katago/bin/win32-x64', {nvidia:true}), {message:'Missing bundled dependency: katago.exe -> nvrtc64_120_0.dll'}); console.log('Original package rejected: missing bundled nvrtc64_120_0.dll');" | Tee-Object -FilePath .nvidia-regression/before.log
if ($LASTEXITCODE -ne 0) { throw 'Missing NVRTC regression assertion failed' }
- name: Prepare and execute corrected runtime with clean environment
shell: pwsh
run: |
node scripts/prepare_nvidia_nvrtc.mjs --runtime-dir=.nvidia-regression/resources/data/katago/bin/win32-x64
if ($LASTEXITCODE -ne 0) { throw 'NVRTC preparation failed' }
node scripts/check_windows_katago_runtime.mjs --runtime-dir=.nvidia-regression/resources/data/katago/bin/win32-x64 --nvidia --evidence=.nvidia-regression/after.json
if ($LASTEXITCODE -ne 0) { throw 'Clean executable version probe failed' }
- uses: actions/upload-artifact@v4
if: always()
with:
name: nvidia-clean-startup-evidence
path: |
.nvidia-regression/before.log
.nvidia-regression/after.json

website:
name: Website build and download checks
runs-on: ubuntu-latest
Expand Down
13 changes: 13 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -599,6 +599,12 @@ jobs:
--flavor=nvidia \
--source-label="${GOAGENT_NVIDIA_KATAGO_ASSET_REPO}@${GOAGENT_NVIDIA_KATAGO_ASSET_RELEASE_TAG}:${GOAGENT_NVIDIA_KATAGO_ASSET_PATTERN}"

- name: Bundle verified official CUDA NVRTC
run: node scripts/prepare_nvidia_nvrtc.mjs

- name: Check NVIDIA runtime with clean DLL search paths
run: node scripts/check_windows_katago_runtime.mjs --runtime-dir=data/katago/bin/win32-x64 --nvidia

- name: Bundle official KataGo Transformer model (NVIDIA)
shell: bash
run: |
Expand Down Expand Up @@ -664,6 +670,13 @@ jobs:
- name: Verify packaged Codex App Server
run: node scripts/smoke_codex_packaged_runtime.mjs --root=release --expect=win32-x64

- name: Check final NVIDIA portable and NSIS payload with clean DLL search paths
shell: pwsh
run: |
$version = node -p "JSON.parse(require('fs').readFileSync('package.json','utf8')).version"
node scripts/check_windows_katago_runtime.mjs --nvidia "--artifact=release/$version/GoAgent-$version-win-x64-nvidia-portable.7z" "--artifact=release/$version/GoAgent-$version-win-x64-nvidia.exe" "--evidence=release/$version/nvidia-clean-katago.json"
if ($LASTEXITCODE -ne 0) { throw "Final NVIDIA KataGo runtime check failed" }

- name: Smoke NVIDIA packaged Windows app
run: node scripts/smoke_windows_packaged_app.mjs --mode=nvidia --require-katago

Expand Down
9 changes: 8 additions & 1 deletion build/afterPack.cjs
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
const { createHash } = require('node:crypto')
const { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, statSync } = require('node:fs')
const { join } = require('node:path')
const { Arch } = require('builder-util')
const { pathToFileURL } = require('node:url')
const { Arch } = require('electron-builder')

module.exports = async function afterPack(context) {
const projectDir = context.packager.projectDir
Expand Down Expand Up @@ -29,4 +30,10 @@ module.exports = async function afterPack(context) {
copyFileSync(manifestPath, join(destinationDir, 'manifest.json'))
copyFileSync(join(projectDir, 'data', 'codex', 'LICENSE'), join(destinationDir, 'LICENSE'))
if (context.electronPlatformName !== 'win32') chmodSync(destination, 0o755)

const editionPath = join(resources, 'data', 'katago', 'edition.json')
if (context.electronPlatformName === 'win32' && existsSync(editionPath) && JSON.parse(readFileSync(editionPath, 'utf8')).flavor === 'nvidia') {
const { checkRuntime } = await import(pathToFileURL(join(projectDir, 'scripts', 'check_windows_katago_runtime.mjs')).href)
await checkRuntime(join(resources, 'data', 'katago', 'bin', 'win32-x64'), true)
}
}
43 changes: 43 additions & 0 deletions design-qa.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,48 @@
# Official Website Design QA

## 2026-10-19 redesign

result: automated checks passed and screenshots reviewed; maintainer review of the preview pending.

Scope:

- Homepage rebuilt around one real game: an SVG board of move 127 of the ear-reddening game with
KataGo's suggestions and the real whole-game win-rate curve, a dark showcase with a new 2x
screenshot of the application at the same position, a seven-tile feature bento (two real
crops, five schematic tiles), three steps, the compact download chooser and a closing band.
- New header (application icon, LizzieYzy Next wordmark, one-row navigation, download button) and
a dark footer with product, topic and community columns. The old footer gap and the default
disclosure marker are gone.
- Guide, FAQ, privacy and changelog rewritten for all seven languages in one data file and one
component; the unused per-language GoAgent copy was removed. Privacy now covers LizzieYzy Next
first. The changelog summarizes next-2026-10-17.1.
- The four Chinese topic pages were rewritten without jargon and now use real screenshots.
- Removed three generated mock-ups of the interface (`lizzieyzy-next-workbench.jpg`,
`goagent-workbench.jpg`, `go-tools-hero.jpg`) and three unused images; the contract rejects
the mock-ups. New sharing image, favicon and touch icon from the application's own icon.
- No release assets, catalog, update protocol, R2 objects or DNS were changed.

Verification:

- `pnpm website:build`: 46 routes. `astro check`: 0 errors, 0 warnings. `node --test
website/tests/*.test.mjs`: 17 passed. `pnpm check:website` passed.
- DOM measurements in headless Chrome with real scrollbars and the live catalog served to the
page: 22 key pages (all seven homepages, downloads, guide, FAQ, privacy, changelog, topic
pages) at 320, 390, 768, 1024, 1280, 1440 and 1920 px, and all 46 pages at 360 and 1280 px. No
element outside the viewport, text contrast at least 4.5:1 (3:1 for large text), targets at
least 40 px, no console errors.
- The desktop header keeps one navigation row from 1041 to 1280 px in all seven languages.
- Screenshots reviewed: homepage at 1440 and 390 px (zh-CN), the hero of every other language
at 1440 px, English and Thai at 390 px, and every content and topic page at 1280 px.
Fixed from that review: mid-word wraps in CJK headings and the hero lead, oversized Japanese and
English headlines, Thai letter-spacing, and a contrast false alarm on the numbered stones.

Limits: Windows rendering (Microsoft YaHei, Segoe UI) was not observed on a Windows machine,
and no screen reader was used. Look at the Cloudflare Pages preview on Windows and macOS before
merging to `main`, because merging deploys to goagent.top.

## 2026-10-02 redesign

final result: passed

Date: 2026-10-02. Scope: local implementation and browser verification, not production deployment.
Expand Down
79 changes: 79 additions & 0 deletions docs/WINDOWS_NVIDIA_RUNTIME.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
# Windows NVIDIA runtime packaging and clean startup gate

The v0.4.21 NVIDIA portable release includes KataGo 1.17.1 but omits its direct
`nvrtc64_120_0.dll` dependency. An isolated Windows test returned loader status
`0xC0000135`; adding the official NVRTC pair made `katago.exe version` succeed,
and withdrawing the pair reproduced the failure. The source runtime manifest
lists CUDA Runtime, cuBLAS, nvJitLink and cuDNN, but not NVRTC.

## Preparation

After restoring the existing NVIDIA source runtime, run:

```sh
node scripts/prepare_nvidia_nvrtc.mjs
node scripts/check_windows_katago_runtime.mjs --runtime-dir=data/katago/bin/win32-x64 --nvidia
```

Preparation supplements the source bundle with official CUDA NVRTC 12.1.105,
matching its CUDA 12.1 runtime and KataGo's compiled CUDA 12.1.66. The archive,
both DLLs and license have pinned SHA-256 checksums in
`scripts/lib/nvidia_nvrtc.mjs`. An offline archive can be provided with
`--archive=<local-zip>`; it receives the same checks. Generated binaries remain
ignored by Git, and a generated `goagent-nvrtc.json` records provenance.

Official metadata:
https://developer.download.nvidia.com/compute/cuda/redist/redistrib_12.1.1.json

Official archive:
https://developer.download.nvidia.com/compute/cuda/redist/cuda_nvrtc/windows-x86_64/cuda_nvrtc-windows-x86_64-12.1.105-archive.zip

Archive SHA-256:
`7fa294726483b10815305fe1c07c9ceb23e048fc43bb459775eb68dee82d1a8f`.

## License handling

The archive's `LICENSE` is byte-identical (SHA-256
`b9ee12782ca117b887588d99ae1b8c24deb59105e05417fe28ffbd7a55896dd1`) to the
CUDA Runtime license in the source bundle. CUDA Supplement Attachment A lists
the Windows NVIDIA Runtime Compilation Library (`nvrtc.dll` and
`nvrtc-builtins.dll`) as distributable components, subject to the agreement's
distribution conditions. The unmodified license is carried alongside the
existing NVIDIA notices as `licenses/nvidia-runtime/cuda_nvrtc-LICENSE`.
There is no license-acceptance flag, installer or system Toolkit dependency.
Changes to this pinned version or license require maintainer review; this
patch does not accept a new license or publish a distribution.

## Final artifact verification

Requires Windows, Node 22+, PowerShell 7 (`pwsh.exe`) and full 7-Zip (`7z`,
including its NSIS handler; `7za` / `7zr` alone cannot read NSIS installers).

```sh
node scripts/check_windows_katago_runtime.mjs --nvidia --artifact=release/0.4.21/GoAgent-0.4.21-win-x64-nvidia-portable.7z --artifact=release/0.4.21/GoAgent-0.4.21-win-x64-nvidia.exe --evidence=release/0.4.21/nvidia-clean-katago.json
```

This extracts each final artifact to a private temporary directory. For NSIS,
it extracts `app-64.7z` without executing the installer. It validates the x64
PE normal and delay import closure, requiring non-system dependencies to exist
beside the engine, then checks the explicit NVRTC pair and license hashes.
CUDA DLLs cannot be satisfied by the developer's PATH or System32.

The actual `version` subprocess runs in an empty temporary working directory
with a cleared environment, Windows-only PATH, hidden window and process-local
loader dialog suppression. It must exit zero and report executable KataGo
1.17.1 with the CUDA backend within ten seconds. Embedded binary metadata and
GPU-less smoke exemptions cannot satisfy this gate. The existing NVIDIA app
smoke also invokes this preflight before launching Electron.

CI restores the hash-pinned official v0.4.21 portable release as a regression
fixture, requires the original missing dependency to be rejected, supplements
NVRTC, and requires clean executable startup. The release workflow checks the
prepared runtime and both final NVIDIA artifacts before upload. The afterPack
hook also checks packaged NVIDIA runtimes, including local builds. The packaging
hook imports `Arch` from its declared `electron-builder` dependency, avoiding
an undeclared transitive import under pnpm's isolated layout.

This is a loader / executable version check, not GPU model initialization,
analysis throughput, complete LoadLibrary discovery or interactive installation
validation. A real NVIDIA GPU analysis smoke is still needed for release QA.
2 changes: 2 additions & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,8 @@
"check:katago-assets:release": "node scripts/check_katago_assets.mjs --mode=release",
"check:no-lite-release-assets": "node scripts/check_no_lite_release_assets.mjs",
"check:nvidia-release-assets": "node scripts/check_nvidia_release_assets.mjs",
"prepare:nvidia-nvrtc": "node scripts/prepare_nvidia_nvrtc.mjs",
"check:windows-katago-runtime": "node scripts/check_windows_katago_runtime.mjs",
"check:release-notes-i18n": "node scripts/check_release_notes_i18n.mjs",
"check:release-quality": "pnpm check:teacher-quality && pnpm check:no-lite-release-assets && pnpm check:nvidia-release-assets && pnpm check:release-notes-i18n && pnpm check:tts-assets && pnpm smoke:tts && pnpm smoke:release-artifacts",
"check:p0-beta": "node scripts/p0_beta_acceptance.mjs",
Expand Down
3 changes: 3 additions & 0 deletions scripts/check_nvidia_release_assets.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,9 @@ const requiredWorkflowFragments = [
'nvidia_katago_asset_release_tag',
'nvidia_katago_asset_pattern',
'package-nvidia-windows',
'node scripts/prepare_nvidia_nvrtc.mjs',
'Check final NVIDIA portable and NSIS payload with clean DLL search paths',
'node scripts/check_windows_katago_runtime.mjs --nvidia',
'wimi321/lizzieyzy-next',
'*windows64.nvidia.portable.zip',
'--copy-runtime-dir',
Expand Down
46 changes: 32 additions & 14 deletions scripts/check_website.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -45,9 +45,6 @@ requireFile('website/src/pages/compare.astro')
requireFile('website/src/pages/[locale].astro')
requireFile('website/src/pages/[locale]/[page].astro')
requireFile('website/src/components/DownloadChooser.astro')
requireFile('website/public/images/download-page-bg.webp')
requireFile('website/public/images/download-icons/windows.svg')
requireFile('website/public/images/download-icons/apple.svg')
requireFile('website/DEPLOYMENT.md')
requireFile('.github/workflows/deploy-website.yml')
requireFile('website/public/sitemap.xml')
Expand All @@ -64,6 +61,7 @@ const downloadPage = read('website/src/pages/download.astro')
const docsPage = read('website/src/pages/docs.astro')
const faqPage = read('website/src/pages/faq.astro')
const changelogPage = read('website/src/pages/changelog.astro')
const pagesCopy = read('website/src/data/pages-copy.mjs')
const localizedHome = read('website/src/pages/[locale].astro')
const localizedPages = read('website/src/pages/[locale]/[page].astro')
const downloadChooser = read('website/src/components/DownloadChooser.astro')
Expand All @@ -84,10 +82,27 @@ if (!index.includes('<HomePage lang="zh-CN"')) fail('homepage must use the share
for (const keyword of ['LizzieYzy Next', '下过的每一盘', '免费开源', 'AI 解说需自行连接服务']) {
if (!homeCopy.includes(keyword)) fail(`homepage must include user-facing guidance: ${keyword}`)
}
for (const keyword of ['review-hero', 'review-steps', 'DownloadChooser', 'compact', 'lizzie-review.webp']) {
for (const keyword of ['class="hero', 'GoBoard', 'showcase', 'lizzie-earred-127.webp', 'bento', 'step-list', 'DownloadChooser', 'compact', 'closing']) {
if (!home.includes(keyword)) fail(`homepage must retain the selected design and real product image: ${keyword}`)
}
for (const asset of ['lizzie-review.webp', 'review-room.webp', 'review-download.webp']) requireFile(`website/public/images/${asset}`)
for (const image of ['lizzie-earred-127.webp', 'lizzie-curve-problems.webp', 'lizzie-candidates.webp', 'og-lizzieyzy-next.jpg', 'lizzieyzy-next-icon.png']) {
requireFile(`website/public/images/${image}`)
}
// Product pictures must be real screenshots of the application, never generated mock-ups.
for (const path of walk(join(websiteRoot, 'src'))) {
const body = readFileSync(path, 'utf8')
for (const mockup of ['workbench.jpg', 'go-tools-hero', 'home-hero-board']) {
if (body.includes(mockup)) fail(`${relative(root, path)} must not use the generated mock-up image ${mockup}`)
}
}
for (const keyword of ['featuresTitle', 'features:']) {
if (!homeCopy.includes(keyword)) fail(`homepage copy must include the feature grid: ${keyword}`)
}
for (const name of ['site.css', 'home.css', 'download.css']) {
const css = read(`website/src/styles/${name}`)
if (/width:\s*100vw|50vw\)/.test(css)) fail(`${name}: full-bleed bands must not use 100vw; it overflows next to classic Windows scrollbars`)
}
if (!read('website/src/components/SiteIcon.astro').includes('?raw')) fail('SiteIcon must inline SVG so icons follow currentColor')
if (index.includes(chooserCopy)) fail('homepage hero must not use unnecessary chooser copy')
if (index.includes('打不开再用')) fail('homepage should use priority/backup wording instead of troubleshooting-first wording')
if (!layout.includes('https://github.com/wimi321/GoAgent/releases')) fail('footer must retain the experimental project link')
Expand Down Expand Up @@ -164,15 +179,18 @@ for (const keyword of ['Cloudflare R2', 'mirrorUrls', 'SHA256', 'manifest']) {
for (const keyword of ['nvidia50.cuda', 'rtx50:', 'CPU build if unsure', '不确定时优先使用 CPU 通用版']) {
if (downloadChooser.includes(keyword)) fail(`download chooser must not restore the obsolete Windows recommendation: ${keyword}`)
}
for (const keyword of ['不用研究术语', '第一步:先下载 LizzieYzy Next', '官网下载中心']) {
if (!docsPage.includes(keyword)) fail(`docs page must contain simple user guidance: ${keyword}`)
for (const [page, file] of [['docs', docsPage], ['faq', faqPage], ['privacy', privacy], ['changelog', changelogPage]]) {
if (!file.includes(`<ContentPage lang="zh-CN" page="${page}" />`)) fail(`${page} page must use the shared seven-language ContentPage`)
}
for (const keyword of ['不用研究术语', '下载并解压', '官网下载中心', '整盘速览', '问题手']) {
if (!pagesCopy.includes(keyword)) fail(`guide must contain simple user guidance: ${keyword}`)
}
if (docsPage.includes('百度网盘打不开:')) fail('docs page should not lead with Baidu troubleshooting wording')
for (const keyword of ['我应该先下载哪个?', '我该点哪个下载?', '不用先懂']) {
if (!faqPage.includes(keyword)) fail(`FAQ page must answer normal-user questions: ${keyword}`)
if (pagesCopy.includes('百度网盘打不开:')) fail('guide should not lead with Baidu troubleshooting wording')
for (const keyword of ['我该下载哪个版本?', '需要另外安装 KataGo 或下载权重吗?', '不用先懂']) {
if (!pagesCopy.includes(keyword)) fail(`FAQ must answer normal-user questions: ${keyword}`)
}
for (const keyword of ['官网首页更简单', '多语言页面同步更新', '普通用户不用先理解项目区别']) {
if (!changelogPage.includes(keyword)) fail(`changelog page must use user-facing copy: ${keyword}`)
for (const keyword of ['next-2026-10-17.1', '当前正式版', 'GitHub Releases']) {
if (!pagesCopy.includes(keyword)) fail(`changelog must summarize the stable release for users: ${keyword}`)
}
for (const keyword of ['HomePage', 'localeSlugs', 'getStaticPaths']) {
if (!localizedHome.includes(keyword)) fail(`localized homepage must share the same components: ${keyword}`)
Expand All @@ -193,8 +211,8 @@ if (localizedHome.includes('README')) fail('localized homepage should say offici
for (const keyword of ['DownloadChooser', 'downloadMeta', '<DownloadChooser lang={meta.lang} />']) {
if (!localizedPages.includes(keyword)) fail(`localized download pages must use the unified chooser: ${keyword}`)
}
for (const keyword of ['本地', 'LLM', 'TTS']) {
if (!privacy.includes(keyword)) fail(`privacy page must contain ${keyword}`)
for (const keyword of ['本地', 'LLM', 'TTS', '遥测', 'user-data', '诊断包']) {
if (!pagesCopy.includes(keyword)) fail(`privacy page must contain ${keyword}`)
}
for (const keyword of ['Cloudflare Pages', 'Cloudflare R2', 'download.goagent.top', 'lizzieyzy-next-downloads']) {
if (!deployment.includes(keyword)) fail(`DEPLOYMENT.md must contain ${keyword}`)
Expand Down
Loading
Loading