Compare commits
5
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
beb248c8bd | ||
|
|
df113c0888 | ||
|
|
1070cd303f | ||
|
|
f8ecc19371 | ||
|
|
57a428846e |
No files matched your search
+42
-1
@@ -28,6 +28,46 @@ numeric core and does not move; the heading is the full version — corrected 20
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
### Changed
|
||||
|
||||
- **The documents in the app scroll further and smoothly** — the user guide, Help ▸ Limitations, About's documents, the
|
||||
Legal Gate and the update notes. A wheel notch moved them a fixed short step whatever the wheel or touchpad sent;
|
||||
it now moves the number of lines Windows is set to scroll (a screen if it is set to that), about twice as far by
|
||||
default, in proportion for a touchpad, and glides there unless Windows' animations are off. At the end of the update
|
||||
notes the wheel scrolls the window instead; Ctrl+wheel still zooms. A page is drawn once when it is opened, not two or
|
||||
three times, and going back to a page you have read in the same window is immediate.
|
||||
|
||||
### Security
|
||||
|
||||
- **Four itch.io downloads this project's documentation used as examples carry malware.** HELLO, HELLO WORLD!, A Doll's
|
||||
Locket - Remake, City of Bones and Träumerei Chapter 2 put the same 213 MB program in front of their RPG Maker game.
|
||||
Read without running it, it ships a registry file that switches off Windows' script scanning (AMSI) and adds
|
||||
Microsoft Defender exclusions, carries an encrypted payload, and checks for virtual machines and debuggers before it
|
||||
starts the game. The documentation called it a launcher and, for A Doll's Locket, said to measure it with the agent
|
||||
running as administrator: that advice is withdrawn. If you installed one of them, remove it and scan your PC.
|
||||
FrameLedger itself does not change: it reads a game's files to find its engine and anti-cheat, and does not judge
|
||||
whether a game is safe (`docs/spike-notes.md` §20).
|
||||
|
||||
### Fixed
|
||||
|
||||
- **An anti-cheat kept beside a game's executable is found before anything is injected.** The safety check looked three folder
|
||||
levels into a game's install folder and no further, so an anti-cheat beside an executable that is itself three levels down
|
||||
was never seen: Wuthering Waves keeps Tencent's Anti-Cheat Expert in `Client\Binaries\Win64\AntiCheatExpert\`, its
|
||||
page read clean, and a session with hooking turned on was hooked for 37 seconds before the check that runs every 30 seconds
|
||||
met the anti-cheat's driver — and because a driver counts for the whole PC, the game's hooking stayed on. The check now also
|
||||
looks in the executable's own folder, on the game's page and before every injection. Wuthering Waves is also named by its
|
||||
Steam id (owner decision D58), and ACE's files, its second driver, its driver's service and its module are named (detection
|
||||
rules `2026.10.4`). Every game is checked for anti-cheat once more after the update; one found this way has its hooking
|
||||
turned off, as any finding does (`docs/19_SAFETY_AND_ANTICHEAT.md` §Pre-injection checks, item 4).
|
||||
|
||||
## [0.1.0-beta.20] - 2026-10-12
|
||||
|
||||
**The twentieth pre-release: the engine version of Ren'Py games.** The same unsigned installer: verify its hash against
|
||||
`SHA256SUMS.txt`, then *More info → Run anyway*.
|
||||
|
||||
**Updating from `0.1.0-beta.19`:** Help ▸ Check for updates, then *Restart to update* with no game running. The Privacy
|
||||
Policy (2.9) is shown once for you to accept. Every game is read once more for its engine (detection rules `2026.10.3`).
|
||||
|
||||
### Added
|
||||
|
||||
- **The engine version of Ren'Py games**, as Unity's, Godot's and RPG Maker's have been shown since beta.19 — on the game's
|
||||
@@ -82,7 +122,8 @@ helper is not changed: re-point it with *Change executable…*.
|
||||
deeper) and the import took it as the game. A helper named by the store is skipped now and the executable is guessed —
|
||||
the import list says so — and the guess takes the executable beside NW.js's `nw.dll` and `package.json`, the process
|
||||
that draws (`css\Game.exe` there; its launcher asks for administrator, so it is measured with *Run the agent as
|
||||
administrator* on). The import also no longer offers a store's game again when the library has it at another
|
||||
administrator* on — *withdrawn 2026-10-13: that launcher is malware, do not run it; [0.1.0-beta.21]'s Security*). The
|
||||
import also no longer offers a store's game again when the library has it at another
|
||||
executable: an entry already there is re-pointed with *Change executable…* (`docs/05_DETECTION.md` §Library import).
|
||||
- **The Games page shows its newest read of the library.** When two reads overlapped — a session ending while an import
|
||||
added games — the one that started first could finish last and be shown, an older list until the next read.
|
||||
|
||||
@@ -16,7 +16,7 @@ A C++ DLL (`FrameLedger.Overlay.dll`) is injected into games the user explicitly
|
||||
> **Amended 2026-09-22 (owner decision): the override of 2026-09-21 is withdrawn, and the sentence above is the rule again.** For one day (releases `0.1.0-beta.3` and `beta.4`) a per-game override existed. The owner withdrew it: no entry point, no message, no column (schema 0008 drops 0007's five), no string. Do not add one in any form.
|
||||
>
|
||||
> **A finding turns the game's hooking off** (`19_SAFETY` §What a finding does to the game). An anti-cheat named in the game itself — its process, its title lists, its folder — is written to the row exactly as the pre-scan always wrote it (`hook_enabled = 0`, `hook_blocked_reason`, `hook_prescan_state = 'blocked'`), and since 2026-09-22 also when the guard finds it at a session's start or at the 30 s re-scan (`AntiCheatVerdict.IsFindingAboutTheGame`). A machine-wide driver or service refuses that session only. The notice, the game's page, the session's notes and the Agent's log all say it happened. Nothing clears the block, as before.
|
||||
> **Amended 2026-09-26 (owner decision D33): one narrow, evidence-bound exception.** Asked with the 2026-09-22 withdrawal and this rule quoted back, the owner chose a per-game exception for anti-cheat that is **user-mode throughout** — a Settings option off by default, then the user ticks each eligible game through a versioned disclosure (bans are possible and can arrive days later). Eligible only when every finding about the game is `BlockedModule` / `AntiCheatFile` / `AntiCheatDirectory` of ONE family whose floor-and-file footprint has no driver, service or `.sys` (`fl::guard::FamilyIsUserModeOnly` — the GUARD decides, from a family NAME the caller passes), no `.sys` is anywhere in the install tree, no title list names the game, and the ledger holds ≥ 2 successful Tier-1 sessions of it. Drivers, services, title lists, the `.sys` rule, the fuzzy tier, scan failures, `TargetUnreadable`, 32-bit, the kill switch and Vulkan are never excepted. The guard runs every check and keeps scanning past the tolerated family (`kAllowedUserModeException`, reason 28); the Overlay learns the family from `Local\FrameLedger.Tolerate.<pid>` before its loader detour exists. A new finding, a crash / safety unhook / floor stop under it, or an executable change ends it; the block is never cleared. **No other form of override is to be added** (`19_SAFETY` §The user-mode exception).
|
||||
> **Amended 2026-09-26 (owner decision D33): one narrow, evidence-bound exception.** Asked with the 2026-09-22 withdrawal and this rule quoted back, the owner chose a per-game exception for anti-cheat that is **user-mode throughout** — a Settings option off by default, then the user ticks each eligible game through a versioned disclosure (bans are possible and can arrive days later). Eligible only when every finding about the game is `BlockedModule` / `AntiCheatFile` / `AntiCheatDirectory` of ONE family whose floor-and-file footprint has no driver, service or `.sys` (`fl::guard::FamilyIsUserModeOnly` — the GUARD decides, from a family NAME the caller passes), no `.sys` is anywhere in the install tree *(within check 4's reach: three levels under the install root and, since 2026-10-13, under the executable's own folder)*, no title list names the game, and the ledger holds ≥ 2 successful Tier-1 sessions of it. Drivers, services, title lists, the `.sys` rule, the fuzzy tier, scan failures, `TargetUnreadable`, 32-bit, the kill switch and Vulkan are never excepted. The guard runs every check and keeps scanning past the tolerated family (`kAllowedUserModeException`, reason 28); the Overlay learns the family from `Local\FrameLedger.Tolerate.<pid>` before its loader detour exists. A new finding, a crash / safety unhook / floor stop under it, or an executable change ends it; the block is never cleared. **No other form of override is to be added** (`19_SAFETY` §The user-mode exception).
|
||||
> **Amended 2026-10-03 (owner decision D38): the evidence moved from before the grant to its trial.** "≥ 2 successful Tier-1 sessions" above could never be met by a game blocked at add time — since beta.8 that is every blocked game — nor after a ledger reset. Asked with that, the owner chose: a grant needs no session; the first two hooked sessions under it are a trial, and any end during the trial (a crash, a safety unhook, a floor stop, a new finding, or a stored hooked session with no frames or an abnormal exit) ends the exception **for good** (`games.ac_exception_trial_failed_at`, schema 0017, never cleared). Every other condition above is unchanged, and so is the last sentence.
|
||||
3. **Never implement evasion.** No manual mapping, no PE header erasure, no thread hiding, no signature obfuscation, no unlinking from the PEB module list. Injection uses documented `LoadLibraryW`. The DLL keeps its real name, real exports, and version info. A performance tool must be *visible* to anti-cheat, not hidden from it. Any PR that makes FrameLedger harder to detect is rejected on principle.
|
||||
4. **Never read or write game memory outside our own hooks.** We read arguments passed to APIs we hooked and COM/handle objects we legitimately own. No pattern scanning for game internals, no reading player/entity state, no writing to game memory. Ever.
|
||||
|
||||
@@ -76,7 +76,7 @@
|
||||
|
||||
<ItemGroup Label="Analyzers (build-time only)">
|
||||
<PackageVersion Include="Roslynator.Analyzers" Version="5.0.1" />
|
||||
<PackageVersion Include="Meziantou.Analyzer" Version="3.0.294" />
|
||||
<PackageVersion Include="Meziantou.Analyzer" Version="3.0.299" />
|
||||
<PackageVersion Include="Microsoft.VisualStudio.Threading.Analyzers" Version="18.7.23" />
|
||||
</ItemGroup>
|
||||
|
||||
|
||||
+4
-1
@@ -5,7 +5,7 @@ hooking on for — and reading the graphics calls the game makes. That is why it
|
||||
resolution, the upscaler, frame generation and ray tracing apart. It is also where its limits come from. This
|
||||
page lists them in plain words; each item links to the document that has the details.
|
||||
|
||||
*Beta software: this page describes version 0.1.0-beta.19.*
|
||||
*Beta software: this page describes version 0.1.0-beta.20.*
|
||||
|
||||
## Games it will not measure
|
||||
|
||||
@@ -163,6 +163,9 @@ you accept the prompt. Turn it on only if you trust everything that runs under y
|
||||
GeForce RTX 5080 with an Intel Core i7-14700KF on Windows 11); other hardware is untested.
|
||||
- **No real Vulkan or OpenGL game has been measured yet** — only FrameLedger's own test program.
|
||||
- There is **no in-game overlay**; everything is shown in the FrameLedger window.
|
||||
- **FrameLedger does not tell whether a game is safe to run.** It reads a game's files to find its engine and its
|
||||
anti-cheat, never to judge it, and recording or measuring a game vouches for nothing. Four itch.io downloads this
|
||||
project once used as examples turned out to carry malware ([details](docs/spike-notes.md)).
|
||||
|
||||
## Your data
|
||||
|
||||
|
||||
@@ -12,7 +12,7 @@ pages.
|
||||
|
||||
<!-- accuracy-block:begin -->
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-10-06.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.19`** (2026-10-12), an unsigned installer built from that tag with its
|
||||
> **pre-release is `0.1.0-beta.20`** (2026-10-12), an unsigned installer built from that tag with its
|
||||
> checksums published beside it. The source holds the desktop app
|
||||
> (library, store import, charts, settings) and the background Agent, which records a session when a
|
||||
> game in the library runs (unless you switched its recording off), injects only into games you enabled
|
||||
@@ -166,7 +166,7 @@ Elevation is **optional — for everything.** Hooked capture is the normal path
|
||||
|
||||
## Install
|
||||
|
||||
> **The latest pre-release is `v0.1.0-beta.19` (2026-10-12); before it `v0.1.0-beta.18` (2026-10-07), `v0.1.0-beta.17` (2026-10-07), `v0.1.0-beta.16` (2026-10-06), `v0.1.0-beta.15` (2026-10-06), `v0.1.0-beta.14` (2026-10-06), `v0.1.0-beta.13` (2026-10-04), `v0.1.0-beta.12` (2026-10-04), `v0.1.0-beta.11` (2026-10-03), `v0.1.0-beta.10` (2026-09-28), `v0.1.0-beta.9` (2026-09-26), `v0.1.0-beta.8` (2026-09-25), `v0.1.0-beta.7` (2026-09-23), `v0.1.0-beta.6` (2026-09-23), `v0.1.0-beta.5` (2026-09-22), `v0.1.0-beta.4` (2026-09-21), `v0.1.0-beta.3` (2026-09-21), `v0.1.0-beta.2` (2026-09-17) and `v0.1.0-beta.1` (2026-09-16).** They are pre-releases: read `CHANGELOG.md`'s section for the one you install — what it measures, what it does not yet, and how to update — before installing. A source build is `docs/12_BUILD.md`.
|
||||
> **The latest pre-release is `v0.1.0-beta.20` (2026-10-12); before it `v0.1.0-beta.19` (2026-10-12), `v0.1.0-beta.18` (2026-10-07), `v0.1.0-beta.17` (2026-10-07), `v0.1.0-beta.16` (2026-10-06), `v0.1.0-beta.15` (2026-10-06), `v0.1.0-beta.14` (2026-10-06), `v0.1.0-beta.13` (2026-10-04), `v0.1.0-beta.12` (2026-10-04), `v0.1.0-beta.11` (2026-10-03), `v0.1.0-beta.10` (2026-09-28), `v0.1.0-beta.9` (2026-09-26), `v0.1.0-beta.8` (2026-09-25), `v0.1.0-beta.7` (2026-09-23), `v0.1.0-beta.6` (2026-09-23), `v0.1.0-beta.5` (2026-09-22), `v0.1.0-beta.4` (2026-09-21), `v0.1.0-beta.3` (2026-09-21), `v0.1.0-beta.2` (2026-09-17) and `v0.1.0-beta.1` (2026-09-16).** They are pre-releases: read `CHANGELOG.md`'s section for the one you install — what it measures, what it does not yet, and how to update — before installing. A source build is `docs/12_BUILD.md`.
|
||||
|
||||
1. Download the latest `FrameLedger.App-win-Setup.exe` from [Releases](https://github.com/poli0981/frameledger/releases). It installs into `%LOCALAPPDATA%\FrameLedger.App`; your data stays in `%LOCALAPPDATA%\FrameLedger`, and uninstalling asks before touching it.
|
||||
2. SmartScreen may warn — releases are not code-signed (free, open-source project). Verify the SHA-256 checksum published with each release, then **More info → Run anyway**.
|
||||
@@ -215,4 +215,4 @@ GPU telemetry is layered so the project never depends on a proprietary vendor li
|
||||
|
||||
---
|
||||
|
||||
**Status:** pre-release (beta). Nineteen tagged pre-releases so far; see `CHANGELOG.md` for what each one changed and the accuracy block at the top of this file for what is and is not measured. It is not feature-complete, it certainly still has bugs, and `legal/DISCLAIMER.md` §0 says what that means for you.
|
||||
**Status:** pre-release (beta). Twenty tagged pre-releases so far; see `CHANGELOG.md` for what each one changed and the accuracy block at the top of this file for what is and is not measured. It is not feature-complete, it certainly still has bugs, and `legal/DISCLAIMER.md` §0 says what that means for you.
|
||||
+13
-6
@@ -277,7 +277,8 @@ the game's files* once the sweep has read a row of these engines and found none.
|
||||
**Where it is read.** Beside the row's executable first: `UnityPlayer.dll` (else the shallowest one the walk listed) and
|
||||
`<exe>_Data` (else a `*_Data` beside that player); `<exe>.pck`. RPG Maker's files are looked for beside the executable and
|
||||
up to two folders above it, as `RpgMakerTitle` already looked for a title — a launcher-fronted game keeps its runtime in
|
||||
a subfolder (A Doll's Locket's `css\`, HELLO, HELLO WORLD!'s `swiftshader\`); a `Library=` that points outside the ini's
|
||||
a subfolder (A Doll's Locket's `css\`, HELLO, HELLO WORLD!'s `swiftshader\` — *both "launchers" are malware, D57,
|
||||
`spike-notes.md` §20*); a `Library=` that points outside the ini's
|
||||
folder is named and not read. Version resources and at most a few kilobytes of any file; the whole detection of one entry
|
||||
measured 24 ms to 4.1 s on the owner's USB drive, nearly all of it the install's walk, once per executable and rules
|
||||
version. The Privacy Policy says so since 2.8 (§4).
|
||||
@@ -359,7 +360,12 @@ engine compiled only, reads as not found. One Ren'Py install was measured.
|
||||
> toast helper. The pick was **butler's verdict**, taken as is: butler stores a *filtered* verdict (the shallowest
|
||||
> candidates, minus those whose manifest asks for elevation) and does not rank what is left, and on that install the
|
||||
> 213 MB `DollsLocket.exe` launcher asks for administrator while the NW.js runtime sits a level deeper in `css\`, so the
|
||||
> helper was the whole verdict (read from the owner's `butler.db`, read-only). Three changes:
|
||||
> helper was the whole verdict (read from the owner's `butler.db`, read-only). *(Corrected 2026-10-13, owner decision
|
||||
> D57: that "launcher" — the same 213 MB program HELLO, HELLO WORLD!, City of Bones and Träumerei put in front of their
|
||||
> runtime — is malware: it ships a registry file that switches off Windows' script scanning and adds Microsoft Defender
|
||||
> exclusions (`spike-notes.md` §20). Do not run it. The admin-mode sentence below is withdrawn; the three changes stand
|
||||
> as rules about helpers and NW.js layouts, and the import still takes a store's own pick when it is not a helper.)*
|
||||
> Three changes:
|
||||
> **(1)** a verdict candidate whose whole name is a runtime helper (`ExecutableLocator.RuntimeHelperNames`:
|
||||
> `notification_helper`, `crashpad_handler`, `UnityCrashHandler64/32`, `CrashReportClient`, NW.js's `nwjc` and
|
||||
> `chromedriver`) or that sits in a Unity plugin folder is skipped, and with nothing left the locator guesses and the
|
||||
@@ -369,8 +375,9 @@ engine compiled only, reads as not found. One Ren'Py install was measured.
|
||||
> rule's own signal — as an NW.js runtime (owner decision D56), below the Unity and Unreal layouts (an NW.js folder can
|
||||
> be a tool shipped beside such a game) and above a name match (the launcher in front of the runtime is named after the
|
||||
> install): the install's guess is `css\Game.exe`, the process that draws, as D28 pointed HELLO, HELLO WORLD!'s entry at
|
||||
> its runtime by hand. That runtime starts elevated (its launcher asks for administrator), so it is measured with the
|
||||
> admin mode on (D34). **(3)** Discovery matches a store title to an entry by **platform + store id** as well as by
|
||||
> its runtime by hand. ~~That runtime starts elevated (its launcher asks for administrator), so it is measured with the
|
||||
> admin mode on (D34).~~ *(Withdrawn 2026-10-13, D57: it starts elevated because the malware in front of it asks for
|
||||
> administrator.)* **(3)** Discovery matches a store title to an entry by **platform + store id** as well as by
|
||||
> path: the entry an earlier import made at another executable is "already in the library" (the log names its path),
|
||||
> so a corrected guess never adds the same game a second time — that entry is re-pointed with Change executable…, and
|
||||
> nothing rewrites it by itself (D25/D27). Tests: `ExecutableLocatorTests.AnNwjsRuntimeBeatsTheLauncherNamedAfterTheInstallAndItsHelpersAreDropped`,
|
||||
@@ -434,12 +441,12 @@ it does not claim who loaded it.
|
||||
|
||||
Before a game is ever launched with hooking enabled, the static scan checks for anti-cheat SDKs shipped alongside it (`EasyAntiCheat/` directory, BattlEye binaries, EOS anti-cheat components, etc.). A hit **disables the hooking toggle for that game entirely** in the UI, with an explanation — the user cannot enable it, so the guard never even has to fire at launch. Prevention beats interception.
|
||||
|
||||
**Implemented in the native guard, not here** (`fl_prescan.cpp`, exposed as ~~`FlStaticPreScan`~~ `FlStaticPreScanGame` since 2026-09-25, which takes the executable, resolves the install root itself and runs check 3 as well). It uses the same `MatchName` and the same rules file as the injection guard, matching directory names against the `anticheat.directories` group and file names against `anticheat.files`. Nothing managed matches a blocklist (§S15 item 1).
|
||||
**Implemented in the native guard, not here** (`fl_prescan.cpp`, exposed as ~~`FlStaticPreScan`~~ `FlStaticPreScanGame` since 2026-09-25, which takes the executable, resolves the install root itself and runs check 3 as well). It uses the same `MatchName` and the same rules file as the injection guard, matching directory names against the `anticheat.directories` group and file names against `anticheat.files`. Nothing managed matches a blocklist (§S15 item 1). **It walks two folders since 2026-10-13:** the install root and, when the executable lives below it, the executable's own folder — each three levels deep. The root alone missed Wuthering Waves' `Client\Binaries\Win64\AntiCheatExpert\`, which sits beside the executable and four levels under the root (`19_SAFETY` §Pre-injection checks, item 4; `spike-notes.md` §19).
|
||||
|
||||
Three things this section previously implied that are not true, and are worth stating:
|
||||
|
||||
- **The UI answer is advisory.** It decides whether the toggle is *offered*; it does not gate injection. The same scan runs a second time inside the guard's chokepoint against a directory derived from the target's own pid, so "prevention beats interception" is a convenience, not the enforcement.
|
||||
- **A hit disables the toggle; "could not scan" must not.** The scan is tri-state. `Reason::kPreScanFailed` — directory absent, unlistable, past a bound, or behind a reparse point — is *neither* a hit nor a pass. It must surface as "could not verify", distinct from "anti-cheat found": disabling the toggle on it would be a false refusal with no appeal, and clearing it would be a fail-open.
|
||||
- **A hit disables the toggle; "could not scan" must not.** The scan is tri-state. `Reason::kPreScanFailed` — directory absent, unlistable, past the entry bound, or behind a reparse point — is *neither* a hit nor a pass. *("Past a bound" until 2026-10-13: the depth bound is a reach, not a refusal — a folder at the last level is named and never opened, and the walk still reads as complete.)* It must surface as "could not verify", distinct from "anti-cheat found": disabling the toggle on it would be a false refusal with no appeal, and clearing it would be a fail-open.
|
||||
- **The token list is thin.** `directories` and `files` ~~carry three tokens today~~ *(corrected 2026-10-04: rules 2026.10.1 carry 9 directory families (12 names) and 18 file families (55 names), and since 2026-09-25 any `*.sys` in the install tree is a finding by code, not data)*. Widening needs verified names; a guessed token fails closed by never firing, which is a silent hole (`19_SAFETY` §Blocklist seed).
|
||||
|
||||
## Caching & privacy constraints
|
||||
|
||||
+9
-2
@@ -66,7 +66,14 @@ WPF + **WPF UI (Wpf.Ui, Fluent)**. Shell = `ui:FluentWindow` with custom `ui:Tit
|
||||
> off** — a tag is shown as the text it is; **no image is fetched** — its description stands in; a node the renderer
|
||||
> does not know is shown as its own source text, and `MarkdownRendererTests` proves for every embedded document that
|
||||
> no word of its plain text is lost and no table is left as `|---|` source. The GPL's `LICENSE` is not Markdown: it is
|
||||
> shown as written, monospace. Colours and the font are theme resources (`16_WPFUI_SYNTAX` §FlowDocument). Links
|
||||
> shown as written, monospace. Colours and the font are theme resources (`16_WPFUI_SYNTAX` §FlowDocument).
|
||||
> **The wheel and the render, beta.21 (owner request 2026-10-13: "scrolling the documents is slow"):** a notch moves
|
||||
> Windows' *lines to scroll* at a browser's line (100/3 DIP; three lines = 100 DIP, scaled by the zoom; a delta in
|
||||
> proportion, so a touchpad's small deltas move a little; Windows' *one screen at a time* a screen) and eases there in
|
||||
> about 120 ms unless Windows' animations are off — WPF moved a fixed 48 DIP per message, whatever its delta. At its ends
|
||||
> the view leaves the wheel to what holds it (the update notes' dialog), and Ctrl+wheel stays the zoom. A page is
|
||||
> rendered once (`MarkdownView.Show`; three bindings changing ask for one render, ahead of layout), and a view keeps the
|
||||
> last 16 documents it rendered, so going back to a page costs its layout only (`MarkdownViewTests`). Links
|
||||
> follow `Markdown/MarkdownLinks`: http, https and mailto through `IUrlOpener`; `#section` scrolls to the heading
|
||||
> (GitHub's anchors); a relative path resolves against the document's place in the repository and opens in the App
|
||||
> when the window holds that page, on GitHub otherwise — **at this build's own source** (`Services/RepositoryLinks`:
|
||||
@@ -294,7 +301,7 @@ All screens are `Page`s registered with the navigation page provider and navigat
|
||||
- **Game detail:**
|
||||
- Header: cover, name, publisher, version, platform, engine+version, API + Present Mode of last session, `FpsReadout` (lifetime avg), TriState chips, Edit button.
|
||||
- **Two clearly separated rows** (`05_DETECTION` §Capability hints — conflating these was the old design's core mistake):
|
||||
- **Supports** — greyed capability chips from files on disk ("Supports DLSS-G", "Supports XeSS"). Static inference.
|
||||
- **Supports** — greyed capability chips from files on disk ("Supports DLSS-G", "Supports XeSS"). Static inference. With none: *not scanned yet* until the Agent's sweep has read the executable, then *none found* (beta.21 — it read "not scanned yet" for every game that ships none of the files).
|
||||
- **Last session measured** — accent chips with real values ("DLSS Quality · 1440p → 2160p", "Frame Generation DLSS-G ×1.9", "Ray Tracing: Yes"). Measured.
|
||||
- **Hooking control** (`ui:CardControl` with `ToggleSwitch`): off by default. Turning it on opens the consent dialog (FR-2.1). When the static anti-cheat pre-scan blocked it, the switch is **disabled** with the reason shown inline and no way to force it. When auto-disabled after crashes, an `InfoBar` explains and offers manual re-enable.
|
||||
|
||||
|
||||
@@ -250,6 +250,11 @@ On startup and on `ApplicationThemeManager.Changed`: for every live plot set fig
|
||||
A `ContentDialog` whose content should not scroll as a whole sets `ScrollViewer.VerticalScrollBarVisibility="Disabled"`
|
||||
on the dialog: its content row then has the window's height, and a `*` row inside it can hold a list that scrolls alone
|
||||
(`ImportReviewPrompt`).
|
||||
- [ ] **A `ScrollViewer` moves a FIXED 48 DIP per wheel message, whatever its delta** (`ScrollViewer._mouseWheelDelta`,
|
||||
read from .NET 10.0.12; measured on a `FlowDocumentScrollViewer`: deltas of −1, −15, −120 and −360 each moved 48). It
|
||||
ignores Windows' *lines to scroll*, and a precision touchpad's small deltas each jump the whole step — a long document
|
||||
read as slow and jerky while its layout cost about a millisecond a step. `Controls/MarkdownView` handles
|
||||
`PreviewMouseWheel` itself (beta.21): the delta in proportion at Windows' lines, eased, unhandled at its ends.
|
||||
- [ ] **ScottPlot 5 zooms on every wheel and never marks it handled.** Without `Charts/ChartWheel` a wheel over a chart
|
||||
zoomed it and scrolled the page at once; a plain wheel is the page's, Ctrl+wheel the chart's, for every plot that
|
||||
`ChartTheme.Attach` registers.
|
||||
|
||||
@@ -267,13 +267,17 @@ Implemented in `FrameLedger.Injector` and reached from managed code through a th
|
||||
> be read (a manifest that will not open, more than 4096 of them, a listing error) refuses as `PreScanFailed`. With
|
||||
> nothing listed, nothing is read. Epic has no reader: an Epic install carries no identity to this check.
|
||||
>
|
||||
> **What is listed, and why a title list at all:** 33 Steam app ids and 33 executable names across ten families —
|
||||
> **What is listed, and why a title list at all:** ~~33~~ 34 Steam app ids and 33 executable names across ten families —
|
||||
> Valve VAC (CS2, Dota 2, TF2, Deadlock and Valve's older VAC titles), Riot Vanguard, Roblox Hyperion, Blizzard's
|
||||
> online titles ("Blizzard Warden"), Call of Duty (Activision Ricochet), NetEase (Marvel Rivals, NARAKA, FragPunk,
|
||||
> Once Human), ACE (Delta Force, Arena Breakout: Infinite), HoYoverse and EA (Battlefield 2042/6, EA SPORTS FC 25/26),
|
||||
> and since 2026-10-03 (rules `2026.10.1`, owner's list) HyperTech's **CrackProof** (Umamusume: Pretty Derby
|
||||
> `3224770`, Heaven Burns Red `1973710`, Madoka Magica Magia Exedra `2987800` — Steam ids only: no executable name
|
||||
> was verified, and a guessed one is a false refusal waiting for an unrelated game).
|
||||
> was verified, and a guessed one is a false refusal waiting for an unrelated game). **Since 2026-10-13 (rules
|
||||
> `2026.10.4`, owner decision D58) Wuthering Waves `3513350`, under ACE**, by its Steam id alone (its executable,
|
||||
> `Client-Win64-Shipping.exe`, is a name Unreal games share): its ACE sits beside the executable, where check 4 did
|
||||
> not reach until the same rules (item 4 below), and a session was hooked for 37 s on 2026-10-12 before the 30 s
|
||||
> re-scan met the driver — a machine-wide finding, which turned nothing off (`spike-notes.md` §19).
|
||||
> These are the titles whose anti-cheat leaves nothing of the game's own for checks 1, 2 and 4 to find — VAC runs
|
||||
> inside Steam, Blizzard's scanner is built into the game — or whose kernel driver loads only after the checks run.
|
||||
> CrackProof is the second kind: a Proton log of Umamusume shows its driver loaded from `C:\Windows\System32` under a
|
||||
@@ -337,7 +341,8 @@ Implemented in `FrameLedger.Injector` and reached from managed code through a th
|
||||
> `ResolveInstallRoot`, plus check 3 on the executable's name and the install's store identity.
|
||||
|
||||
> **Implemented, and stated narrowly.** `fl_prescan.cpp` walks the target's
|
||||
> own directory (derived from its pid, never from a caller-supplied path) to
|
||||
> install root and, since 2026-10-13, its executable's own folder (both derived from its pid, never from a
|
||||
> caller-supplied path — "Which directory" below) to
|
||||
> **depth 3** — raised from 2 on 2026-08-04 (§S22, `spike-notes.md` §13), because a
|
||||
> title shipping its own kernel driver two levels below the install root was
|
||||
> invisible from where the scan starts, so the blocklist row naming it could not
|
||||
@@ -382,6 +387,21 @@ Implemented in `FrameLedger.Injector` and reached from managed code through a th
|
||||
> appeal. A nested executable outside a recognised store layout is therefore
|
||||
> still scanned narrowly; that residual is stated, not closed.
|
||||
>
|
||||
> **Amended 2026-10-13: the root AND the executable's folder.** The root replaced the executable's folder, and
|
||||
> that was half the answer. The walk reaches three levels below where it starts, and an Unreal executable is
|
||||
> already three below its root, so a folder **beside** the executable is four: MEASURED on Wuthering Waves, whose
|
||||
> Tencent ACE lives in `Client\Binaries\Win64\AntiCheatExpert\` (with `ACE-BASE.sys` and `ACE-CORE.sys` in it). The
|
||||
> walk from the root listed `Win64` and never opened it, so the library pre-scan read the game clean three times,
|
||||
> hooking stayed available, and the first session was hooked for 37 s until the 30 s re-scan met ACE's driver —
|
||||
> machine-wide, so nothing was turned off (`spike-notes.md` §19). Neverness To Everness keeps a second
|
||||
> `AntiCheatExpert\` beside its `HTGame.exe`, six levels down, that no walk had seen either. Check 4 now walks the
|
||||
> root and then, when the executable lives below it, the executable's own folder — same walk, same reach, its own
|
||||
> 4096-entry budget, the same matcher and the same D33 tolerance (`ScanGameFolders`). `ImageDirectory` names the
|
||||
> executable's folder and the checks resolve the root from it. Raising the reach instead was measured and rejected:
|
||||
> depth 4 still misses NTE's folder, and at depth 5 three installed titles overrun 4096 entries (Yu-Gi-Oh! Master
|
||||
> Duel: 41,251), which would refuse them. Measured across the owner's 83 Steam installs, the second walk costs at most
|
||||
> 103 entries and newly finds exactly those two folders.
|
||||
>
|
||||
> **What it does not cover.** Beyond the above, the residual is an anti-cheat
|
||||
> SDK sitting on disk whose service is not installed and whose module is not
|
||||
> loaded; checks 1, 2 and 2b already cover the rest. And today the `directories` + `files`
|
||||
@@ -393,9 +413,11 @@ Implemented in `FrameLedger.Injector` and reached from managed code through a th
|
||||
> closed by never firing, which is a silent hole.
|
||||
>
|
||||
> **Every uncertainty refuses**, with `Reason::kPreScanFailed` rather than a
|
||||
> hit: directory absent or unlistable, either bound exceeded, a name we could
|
||||
> hit: directory absent or unlistable, ~~either bound exceeded~~ the 4096-entry bound exceeded, a name we could
|
||||
> not convert, or a reparse point — which is never followed, because a
|
||||
> junction can hide an `EasyAntiCheat/` beneath it. **Unmeasured:** how often
|
||||
> junction can hide an `EasyAntiCheat/` beneath it. *(Corrected 2026-10-13: the DEPTH bound never refused. It is a
|
||||
> reach — a folder at the last level is named and not opened, and the walk still reads as complete — which is how
|
||||
> Wuthering Waves' ACE was missed; the paragraph above is what answers it.)* **Unmeasured:** how often
|
||||
> a legitimate library trips the reparse-point rule or the 4096-entry bound.
|
||||
> That needs a real game library, and it is a false-refusal path, so it is
|
||||
> recorded rather than assumed benign.
|
||||
@@ -544,7 +566,7 @@ says so, including that a ban can arrive days later and that FrameLedger cannot
|
||||
FredaikisAntiCheat and Roblox Hyperion *(Hyperion added 2026-10-04: its rows are one module and one file; its only title
|
||||
is on the executable list, so it is never excepted in practice)*; Easy Anti-Cheat, BattlEye, ACE, NetEase Anti-Cheat, mihoyo protect, Vanguard, Ricochet and every
|
||||
other family carry a driver or a service and are never excepted;
|
||||
- no `*.sys` anywhere in the install tree — the kernel-driver rule (D30) is never excepted, whichever family a driver
|
||||
- no `*.sys` anywhere in the install tree *(within check 4's reach: three levels under the install root and, since 2026-10-13, under the executable's own folder)* — the kernel-driver rule (D30) is never excepted, whichever family a driver
|
||||
belongs to (so *Aniimo*, which unpacks `NEPKernel.sys` beside `NEP2.dll` on its first run, stays blocked);
|
||||
- the game is on no title list (`BlockedExecutable`, `BlockedStoreId` — the notorious titles are there by design);
|
||||
- ~~the ledger holds **at least two successful Tier-1 sessions** of the game: hooked, frames recorded, `exit_status = normal`
|
||||
@@ -726,10 +748,13 @@ normative documentation. Write tokens here exactly as the data must hold them.
|
||||
| mihoyo protect | `services` | name | `mhyprot2`, `mhyprot3`, `HoYoKProtect` | 2026-09-25 |
|
||||
| mihoyo protect | `files` | name | `mhypbase.dll`, `mhyprot2.sys`, `mhyprot3.sys`, `HoYoKProtect.sys` | 2026-09-25 |
|
||||
| Anti-Cheat Expert | `modules` | prefix | `SGuard`, `AntiCheatExpert` | 2026-09-25 |
|
||||
| Anti-Cheat Expert | `modules` | exact | `ACE-Base64.dll` | 2026-10-13 |
|
||||
| Anti-Cheat Expert | `drivers` | exact | `ACE-BASE.sys`, `ACE-ADVT.sys`, `ACE-GAME.sys` — **machine-wide refusal** (check 2) | seed |
|
||||
| Anti-Cheat Expert | `drivers` | exact | `ACE-CORE.sys` — **machine-wide refusal** (check 2) | 2026-10-13 |
|
||||
| Anti-Cheat Expert | `directories` | name | `AntiCheatExpert`, `AceAntibotClient` | 2026-09-25 |
|
||||
| Anti-Cheat Expert | `services` | name | `AntiCheatExpert Protection`, `AntiCheatExpert Service` | seed |
|
||||
| Anti-Cheat Expert | `services` | name | `AntiCheatExpert Protection`, `AntiCheatExpert Service`, `ACE-BASE` | seed; `ACE-BASE` 2026-10-13 |
|
||||
| Anti-Cheat Expert | `files` | name | `PGameProtectDriver_X64.sys`, `SGuard64.exe`, `SGuardSvc64.exe` | seed; `SGuard64.exe`, `SGuardSvc64.exe` 2026-09-25 |
|
||||
| Anti-Cheat Expert | `files` | name | `ACE-BASE.sys`, `ACE-CORE.sys`, `ACE-Base64.dll`, `ACE-Service64.exe`, `ACE-Setup64.exe` (measured in Wuthering Waves' folder) | 2026-10-13 |
|
||||
| EA AntiCheat | `modules` | prefix | `EAAntiCheat` | 2026-09-25 |
|
||||
| EA AntiCheat | `drivers` | exact | `EAAntiCheat.sys` — **machine-wide refusal** (check 2) | 2026-09-25 |
|
||||
| EA AntiCheat | `files` | name | `EAAntiCheat.Installer.exe`, `EAAntiCheat.GameServiceLauncher.exe`, `EAAntiCheat.GameServiceLauncher.dll` | 2026-09-25 |
|
||||
|
||||
+32
-4
@@ -1494,7 +1494,8 @@ wrongly-named entry through `SessionRecorder`'s `EnsureAsync`); the running tabl
|
||||
launch election registers its session and defers to the watcher's. **What it costs:** a game whose FOLDER moved records
|
||||
nothing until *Change executable* — accepted, because the alternative is exactly what put HHW's sessions under Flower
|
||||
in Us. **D28 (owner, same day):** HHW itself is measured by pointing an entry at `swiftshader\Game.exe` (the NW.js
|
||||
runtime its .NET launcher starts); no launcher-following in beta.6.
|
||||
runtime its .NET launcher starts); no launcher-following in beta.6. *(Corrected 2026-10-13, D57: that ".NET launcher"
|
||||
is malware — `spike-notes.md` §20. Nothing here asks for it to be run.)*
|
||||
|
||||
**Decision (D26, owner: "the library still shows two entries side by side after the drive letter changed, with the
|
||||
data unchanged").** The Agent merges two entries for one executable under two drive letters by itself: the stale
|
||||
@@ -2123,7 +2124,7 @@ blends into the background in dark mode").
|
||||
|
||||
**Owner-only, added to the list below:** item 14.
|
||||
|
||||
## **START HERE** — 2026-10-12, 0.1.0-beta.19: the import's helper, the folder Change executable opens in, three engines' versions, uninstalled games
|
||||
## ~~**START HERE**~~ — 2026-10-12, 0.1.0-beta.19: the import's helper, the folder Change executable opens in, three engines' versions, uninstalled games *(struck 2026-10-12: the head is §beta.20 below)*
|
||||
|
||||
*Status is `CHANGELOG.md` `[0.1.0-beta.19]`; this is what no other file carries. The owner's list (2026-10-12, four items):
|
||||
*Change executable…* opens in the game's root folder; the version of RPG Maker, Unity and Godot games; A Doll's Locket -
|
||||
@@ -2142,7 +2143,9 @@ then the release.*
|
||||
finding does to the game).
|
||||
- **D56 — an NW.js runtime is the import's game**: an executable beside `nw.dll` + `package.json` ranks as the engine's
|
||||
own layout, below Unity's and Unreal's and above a name match, so a launcher-fronted RPG Maker MV/MZ install is pointed
|
||||
at the process that draws. D28 did that by hand for HELLO, HELLO WORLD!; the locator now picks the same file.
|
||||
at the process that draws. D28 did that by hand for HELLO, HELLO WORLD!; ~~the locator now picks the same file~~
|
||||
*(corrected 2026-10-13: the locator does, and an import never asks it there — itch's own pick names the program in
|
||||
front, which is not a helper, so the import takes it; and that program is malware, D57 — §beta.21)*.
|
||||
- **The owner's existing A Doll's Locket entry is not rewritten** (D25/D27): *Change executable…* re-points it, and the
|
||||
import no longer offers a twin of the same store title.
|
||||
- **The train (owner, 2026-10-12, after the PRs were up):** "commit, push và release luôn" — each PR squash-merged by the
|
||||
@@ -2195,6 +2198,26 @@ a Ren'Py game's engine version from `renpy/vc_version.py` (rules `2026.10.3`, Pr
|
||||
once at the next update; `05_DETECTION` §Engine version — Ren'Py) and strikes item 15. Merged for the next pre-release;
|
||||
no release was asked for.
|
||||
|
||||
## **START HERE** — 2026-10-12, 0.1.0-beta.20: the engine version of Ren'Py games
|
||||
|
||||
*Status is `CHANGELOG.md` `[0.1.0-beta.20]`; this is what no other file carries.* The owner, the same evening as beta.19 and
|
||||
after confirming it on real hardware: "tiếp tục với 1 pr kèm với detect version game dùng ren'py", then "tung bản beta20
|
||||
rồi đóng phiên hẳn". One PR — #299, a Ren'Py game's version from the engine's own `renpy/vc_version.py` (rules
|
||||
`2026.10.3`, Privacy Policy 2.9, item 15 struck) — then the release.
|
||||
|
||||
**Decisions:** none new. The Privacy Policy 2.9 wording — one item added to §4's list, "the version file of a Ren'Py
|
||||
game's engine" — was shown to the owner with #299 and released on their word.
|
||||
|
||||
**Traps met on the way:**
|
||||
|
||||
- **`keyboxd` can fail with "Input/output error" while the key is unlocked**: `gpgconf --kill keyboxd` alone brings it
|
||||
back on the next use; killing `gpg-agent` would drop the cached passphrase and wait on a pinentry.
|
||||
- **A test run still seeds the owner's live rules** (§beta.19's trap): rules `2026.10.3` cannot be parsed by an installed
|
||||
beta.19, so the owner's `detection-rules.json` and `.seeded` were copied aside before each local gate and back after.
|
||||
- **Loop a test class you touched before the merge** (§beta.19): `GamesViewModelTests` then ran 340 times green after #297.
|
||||
|
||||
**Owner-only, added to the list below:** item 16.
|
||||
|
||||
## Owner-only — no PR can close these
|
||||
|
||||
1. **§S23-2 — branch protection.** `Rules / validate` is not a required status check on
|
||||
@@ -2303,7 +2326,8 @@ no release was asked for.
|
||||
Demo and 衔蝶 (the App's restart at 17:47 had started the ten minutes again), the library then reading *Games · 46*.
|
||||
*(The item as written:)* (a) **A Doll's Locket - Remake:** its page ▸ *Change executable…* opens in `Dolls
|
||||
Locket\`; pick `css\Game.exe`. Its launcher asks for administrator, so the runtime is measured only with *Run the agent
|
||||
as administrator* on — otherwise the session says why nothing was measured. (b) **Refresh** offers no second A Doll's
|
||||
as administrator* on — otherwise the session says why nothing was measured. *(Withdrawn 2026-10-13, D57: that
|
||||
launcher is malware — do not run it; `spike-notes.md` §20.)* (b) **Refresh** offers no second A Doll's
|
||||
Locket. (c) **Engine versions:** a Unity game's page (*Unity 2022.3.62f2* on Umamusume, *Unity 2019.4.40* on GIRLS'
|
||||
FRONTLINE 2), Godot's (*Godot 4.4.1* on 衔蝶), RPG Maker's (*RPG Maker MZ 1.10.0*, *RPG Maker MV 1.6.2* on Flower in
|
||||
Us, *RPG Maker VX Ace (RGSS 3.0.1)*), each with its *Engine version* line. (d) **Uninstall a game that has no session**
|
||||
@@ -2311,6 +2335,10 @@ no release was asked for.
|
||||
together are said in one notice that names both; with the USB drive unplugged nothing is removed; *Remove uninstalled
|
||||
games* off keeps it. (e) The Legal Gate shows the Privacy Policy 2.8
|
||||
once. (f) The `ja` strings marked `review`.
|
||||
16. **beta.20 on real hardware.** (a) **Bound Between Desks:** its page reads *Ren'Py 8.5.0*, and its *Engine version*
|
||||
line says it was read from the engine's version file (`renpy/vc_version.py`); the first sweep after the update reads
|
||||
every game once more (rules `2026.10.3`). (b) The Legal Gate shows the Privacy Policy 2.9 once. (c) The `ja` string
|
||||
marked `review` (`GameDetail_EngineVersion_RenPyVcVersion`).
|
||||
|
||||
**Answered 2026-08-05, do not re-ask:** remove `gameguard` and keep `guard` (approved
|
||||
over a red `Rules` gate, with the reasoning recorded in the merge commit); vendor NVAPI
|
||||
|
||||
@@ -48,7 +48,7 @@ with the 2026-09-16 recovery and with library entries removed since.
|
||||
|
||||
| Game | Why nothing was measured | When | Evidence |
|
||||
|---|---|---|---|
|
||||
| HELLO, HELLO WORLD! | A 32-bit game (RPG Maker MV): refused by the guard once, and two sessions with hooking switched off — each recorded with its duration and sensors | 2026-09-23 | database |
|
||||
| HELLO, HELLO WORLD! | A 32-bit game (RPG Maker MV): refused by the guard once, and two sessions with hooking switched off — each recorded with its duration and sensors. *Its itch.io download puts malware in front of the game — do not run it (noted 2026-10-13, [spike-notes §20](spike-notes.md))* | 2026-09-23 | database |
|
||||
| Umamusume: Pretty Derby | Three sessions played with hooking switched off for the game | 2026-09-27 | database |
|
||||
| Sekiro: Shadows Die Twice | One session played with hooking switched off | 2026-09-25 | database |
|
||||
| GIRLS' FRONTLINE 2: EXILIUM | One session whose process Windows would not let FrameLedger open, and two recovered after the agent itself stopped mid-session (*interrupted*) | 2026-09-22 → 09-23 | database |
|
||||
|
||||
+92
-3
@@ -2656,9 +2656,11 @@ Godot, RPG Maker.
|
||||
- **Detect time** is the whole detection of one entry — the install's walk, the rules and the second read — on the USB
|
||||
drive; the second read itself is a version resource and at most a few kilobytes. It runs once per executable and rules
|
||||
version, like Unreal's.
|
||||
- **Four of the itch installs front their runtime with a 213 MB .NET launcher** (HELLO, HELLO WORLD!, A Doll's Locket -
|
||||
Remake — whose launcher asks for administrator —, City of Bones and Träumerei) — the reason the import's choice of
|
||||
executable changed in the same train (`05_DETECTION` §Library import, D56).
|
||||
- ~~**Four of the itch installs front their runtime with a 213 MB .NET launcher**~~ **Four of the itch installs put a
|
||||
213 MB .NET program in front of their runtime, and it is malware** *(corrected 2026-10-13, owner decision D57 — §20;
|
||||
do not run it)* (HELLO, HELLO WORLD!, A Doll's Locket - Remake — whose launcher asks for administrator —, City of
|
||||
Bones and Träumerei) — read as a launcher, the reason the import's choice of executable changed in the same train
|
||||
(`05_DETECTION` §Library import, D56).
|
||||
- **Not measured:** RPG Maker 2000/2003 (`RPG_RT.exe`; none installed, and no rule detects it), XP and VX (no install —
|
||||
their RGSS1/RGSS2 libraries are read by the same rule as VX Ace's, unmeasured), a Unity build older than 2019 (its
|
||||
player is the executable, with no `UnityPlayer.dll`), a Godot 3 export, and a Godot pack appended to the executable
|
||||
@@ -2683,3 +2685,90 @@ renpy_vc_version` in 79 ms; Dialoop (`unity 6000.3.3f1`), Plethora of Bullets 2
|
||||
|
||||
- **Not measured:** an older Ren'Py (no other install), whose `vc_version.py` may name no `version` — it then reads as
|
||||
not found; a build that ships the engine compiled only (none seen).
|
||||
|
||||
## 19 · Anti-cheat beside the executable — Wuthering Waves *(2026-10-13, beta.21, owner decision D58)*
|
||||
|
||||
The owner's report: FrameLedger found no anti-cheat in `D:\SteamLibrary\steamapps\common\Wuthering Waves` (Steam
|
||||
`3513350`, Unreal Engine 4.26.2). Read-only, on the owner's disk and in the Agent's own log.
|
||||
|
||||
**The layout.** The install root holds the launcher `Wuthering Waves.exe` (483,768 bytes), `Client\`, `Engine\` and
|
||||
`ClearThirdParty.exe`; the library entry is the shipping binary `Client\Binaries\Win64\Client-Win64-Shipping.exe`
|
||||
(169,213,960 bytes). Beside it, `Client\Binaries\Win64\AntiCheatExpert\` holds Tencent's ACE: `ACE-BASE.sys`
|
||||
(4,125,432), `ACE-CORE.sys` (3,923,120) with `ACE-CORE.sys2`, `.sysa` and `.sysa2`, `ACE-Base64.dll` (69,736,848),
|
||||
`ACE-Service64.exe`, `ACE-Setup64.exe`, `ACE-Base.dat` and `pld.dat`. The folder is **four levels** under the root;
|
||||
entries per level under the root: 6, 10, 31, 276, 109, 136 (levels 1–6). Neverness To Everness keeps a second
|
||||
`AntiCheatExpert\` beside its `HTGame.exe`, at `Client\WindowsNoEditor\HT\Binaries\Win64\` — **six** levels down.
|
||||
|
||||
**Why it read clean.** Check 4 walked the install root only (since 2026-09-25), three levels deep, and a folder at the
|
||||
last level is named and never opened, silently: the walk listed `Win64` and reported a complete, clean tree. The rules
|
||||
already named the folder (`directories`: `AntiCheatExpert`); the walk never handed the name to the matcher.
|
||||
|
||||
**What it cost, from the Agent's log.** Added by import 2026-10-11 19:50:19 → `prescan: scanned 2 — anti-cheat 1, clean 1`
|
||||
(the anti-cheat was NTE's `PGameProtectDriver_X64.sys`, three levels down); re-scanned after the game's update at
|
||||
21:22:14, clean; re-added 2026-10-13 18:30:44, clean. With hooking turned on, the session of 2026-10-12 started at
|
||||
21:10:20 found nothing — ACE's driver not yet loaded, its services stopped — and was injected; at 21:10:57 the 30 s
|
||||
re-scan met `ACE-BASE.sys` (written to `System32\drivers` at 21:10 by the game's ACE setup) and unhooked:
|
||||
`SafetyUnhook; Saved (tier 1, exit=UnhookedSafety, frames=0); guard=BlockedDriver/Anti-Cheat Expert`. A driver is a
|
||||
machine-wide finding, which refuses the session and turns nothing off, so the game's hooking stayed on. Registered on
|
||||
the machine afterwards: the kernel service `ACE-BASE` (demand start) and the user-mode `AntiCheatExpert Protection`.
|
||||
|
||||
**The options, measured across the owner's 83 Steam installs** (read-only listings):
|
||||
|
||||
| Option | Cost | Newly finds | Verdict |
|
||||
|---|---|---|---|
|
||||
| Walk the executable's own folder too | ≤ 103 entries (NTE), 95 for Wuthering Waves | exactly the two `AntiCheatExpert\` folders above | **taken** |
|
||||
| Depth 3 → 4 | one constant; peak 1,627 entries (Half-Life 2) | Wuthering Waves' folder name only — NTE's is six levels down, and the folder's files stay out of reach | rejected |
|
||||
| Depth 5 or more | over 4096 entries for Yu-Gi-Oh! Master Duel (41,251), Yasha (12,215), GIRLS' FRONTLINE 2 (9,969) | — | rejected: those games would read *could not verify* and be refused at session start, GF2 under its D33 exception included |
|
||||
| Make the depth cap refuse | — | — | rejected: it would refuse nearly every game |
|
||||
|
||||
**Taken (rules `2026.10.4`):** check 4 walks the install root, then the executable's folder when it lives below the
|
||||
root (`ScanGameFolders`, `fl_prescan.cpp`), each with its own 4096-entry budget; the five `ACE-*` names join the
|
||||
`files` group, `ACE-CORE.sys` the `drivers` group, `ACE-BASE` the `services` group and `ACE-Base64.dll` a `modules`
|
||||
row of its own (so an injected Overlay stops itself if it loads); and Wuthering Waves' Steam id is on the title list.
|
||||
The version bump is what makes every game's pre-scan run again: the sweep re-scans only when the rules version or the
|
||||
executable changes.
|
||||
|
||||
- **Not measured:** that the game loads `ACE-Base64.dll` (no session has run since), and whether ACE's other titles
|
||||
keep the same layout.
|
||||
|
||||
## 20 · The launcher in front of four itch installs is malware *(2026-10-13, beta.21, owner decision D57)*
|
||||
|
||||
§17 read the 213 MB program four itch.io downloads put in front of their RPG Maker game as a *launcher*, and the
|
||||
documentation built on that reading (D28, D56's rationale, HANDOFF item 15(a), which told the owner to run A Doll's
|
||||
Locket's with the agent as administrator). Read on 2026-10-13 without running anything — file listings, the itch
|
||||
receipt, version resources, the .NET metadata strings and the files beside it — it is not a launcher. **It is malware.
|
||||
Do not run it.**
|
||||
|
||||
| Download (itch) | The program | SHA-256 | Beside it |
|
||||
|---|---|---|---|
|
||||
| HELLO, HELLO WORLD! (5015466) | `HELLOHELLOWORLD.exe`, 213,572,096 bytes | `053553514C3E34865393654477631DEFB50B36509F44B8ADC5B1E555E1F64FD1` | `locales\ml.reg`, `locales\ko.xml` |
|
||||
| A Doll's Locket - Remake (5085165) | `DollsLocket.exe`, 213,745,664 bytes | `51D3271AD0FFAF3652DAB9F66C1279CB2CA16F46A6AB2E5173D032600C1E5E53` | `data\Items.reg`, `data\Armors.xml` |
|
||||
| City of Bones | `CityofBones.exe`, 213,557,760 bytes | `CA81BE260941E7BE2D87FE6852E7DAD0D432A84F071C2C578A7BD06BE7E61248` | `System\Windowskin.reg`, `System\RGSS301.xml` |
|
||||
| Träumerei Chapter 2 | `TräumereiChapter2.exe`, 213,559,808 bytes | `65D4CCB7065227A0ED08D8977CA2F00F1E2A6DDC5F375C2C32E115D90DE29E4D` | `System\Game.reg`, `System\RGSS301.xml` |
|
||||
|
||||
- **The four programs are one .NET program**, unsigned, its version resource Visual Studio's template named after each
|
||||
game (`HELLOHELLOWORLD`, version 1.0.0.7, "Copyright © 2026"), and nearly all of its size embedded resources.
|
||||
- **Beside each, two files named like the game's own.** A 3,060-byte Windows registry file — byte-identical in all four —
|
||||
that sets `AmsiEnable = 0` under `HKCU` and `HKLM\SOFTWARE\Microsoft\Windows Script\Settings` (it switches off
|
||||
Windows' script scanning), and under `HKLM\SOFTWARE\Policies\Microsoft\Windows Defender` adds exclusions for the `.exe`
|
||||
and `.msi` extensions and for `powershell.exe`, `rundll32.exe`, `msiexec.exe` and `regasm.exe`, and sets
|
||||
`SpynetReporting = 0` and `SubmitSamplesConsent = 2` (no cloud protection, no samples sent). And a 3,216-byte `.xml`
|
||||
that is no XML: high-entropy bytes, a different blob in each download.
|
||||
- **What the program's own metadata names** (type and member names, read as strings): checks for virtual machines
|
||||
(VMware, VirtualBox, QEMU, Hyper-V, Xen, KVM, Bochs, Parallels — through WMI, the registry and the firmware) and for
|
||||
debuggers (`IsDebuggerPresent`, `CheckRemoteDebuggerPresent`, `NtQueryInformationProcess` on the debug port, object and
|
||||
flags, hardware breakpoints, debugger windows); AES decryption of Base64 text; PowerShell run inside the process
|
||||
(`CreateRunspace`, `AddScript`); registry writes; steps named `RunPayload` and `PayloadStep`; and the game it starts
|
||||
afterwards — the RPG Maker runtime beside it (`swiftshader\Game.exe`, `css\Game.exe`, `Game.exe` with
|
||||
`RGSS301.dll`), which is what makes it look like the game.
|
||||
- **Where it sits in each download:** the itch receipt of HELLO, HELLO WORLD! lists the program, the runtime in
|
||||
`swiftshader\` and both disguised files as what the download installed; nothing was added afterwards.
|
||||
|
||||
**What changes in FrameLedger (D57): the documentation, not the import.** The import still takes a store's own pick when
|
||||
it is not a helper (beta.19) — FrameLedger reads a game's files to find its engine and anti-cheat, never to judge
|
||||
whether it is safe, and a store's verdict stays the store's. What is corrected in place: §17's bullet, `05_DETECTION`
|
||||
§Library import (D56's rationale and its admin-mode sentence), HANDOFF D28, D56 and item 15(a), the beta.19 CHANGELOG
|
||||
entry, and the HELLO, HELLO WORLD! row of `LIST_GAME_TESTED.md`; `LIMITATIONS.md` says FrameLedger does not tell a safe
|
||||
game from an unsafe one.
|
||||
|
||||
- **Not measured, and not to be:** what the payload does. Nothing here was run, decrypted or uploaded anywhere.
|
||||
+1
-1
@@ -12,7 +12,7 @@
|
||||
HTML comments are not part of the block.
|
||||
-->
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-10-06.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.19`** (2026-10-12), an unsigned installer built from that tag with its
|
||||
> **pre-release is `0.1.0-beta.20`** (2026-10-12), an unsigned installer built from that tag with its
|
||||
> checksums published beside it. The source holds the desktop app
|
||||
> (library, store import, charts, settings) and the background Agent, which records a session when a
|
||||
> game in the library runs (unless you switched its recording off), injects only into games you enabled
|
||||
|
||||
+1
-1
@@ -114,7 +114,7 @@ Frame timing is derived from high-resolution timestamps taken at the moment the
|
||||
|
||||
<!-- accuracy-block:begin -->
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-10-06.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.19`** (2026-10-12), an unsigned installer built from that tag with its
|
||||
> **pre-release is `0.1.0-beta.20`** (2026-10-12), an unsigned installer built from that tag with its
|
||||
> checksums published beside it. The source holds the desktop app
|
||||
> (library, store import, charts, settings) and the background Agent, which records a session when a
|
||||
> game in the library runs (unless you switched its recording off), injects only into games you enabled
|
||||
|
||||
@@ -42,7 +42,7 @@
|
||||
"level, which made it a check that could not fire."
|
||||
],
|
||||
"schemaVersion": 2,
|
||||
"rulesVersion": "2026.10.3",
|
||||
"rulesVersion": "2026.10.4",
|
||||
|
||||
"engines": [
|
||||
{
|
||||
@@ -223,7 +223,9 @@
|
||||
{ "family": "EQU8", "match": "prefix", "values": [ "equ8" ],
|
||||
"note": "Splitgate. Documented (SteamDB EQU8); module names unmeasured." },
|
||||
{ "family": "Xigncode3", "match": "exact", "values": [ "x3.xem" ],
|
||||
"note": "x3.xem is XIGNCODE3's loader, LoadLibrary'd as an ordinary module (documented). The files row names the same token in the install tree." }
|
||||
"note": "x3.xem is XIGNCODE3's loader, LoadLibrary'd as an ordinary module (documented). The files row names the same token in the install tree." },
|
||||
{ "family": "Anti-Cheat Expert", "match": "exact", "values": [ "ACE-Base64.dll" ],
|
||||
"note": "ACE's user-mode module, MEASURED on disk 2026-10-13 in Wuthering Waves' AntiCheatExpert/ folder; that the game loads it is unmeasured. Exact, not prefix: 'ACE-' is four characters over a namespace we do not own. Appended, as every row since 2026-09-25." }
|
||||
],
|
||||
"drivers": [
|
||||
{ "family": "Riot Vanguard", "match": "exact", "values": [ "vgk.sys" ], "scope": "machine" },
|
||||
@@ -233,6 +235,8 @@
|
||||
"note": "MEASURED 2026-08-04: EasyAntiCheat_EOSSys was Running as a kernel driver while a real EAC title played, and matched NOTHING in this group — the refusal came from the service check instead. A family caught through only one of five groups is one rename away from being missed." },
|
||||
{ "family": "Anti-Cheat Expert", "match": "exact", "values": [ "ACE-BASE.sys", "ACE-ADVT.sys", "ACE-GAME.sys" ], "scope": "machine",
|
||||
"note": "ACE-BASE.sys and ACE-ADVT.sys MEASURED under System32\\drivers on the dev machine 2026-08-04. ACE-GAME.sys is a documented sibling and is UNMEASURED: a blocklist may over-cover, never under-cover. Exact not prefix — 'ACE-' is four characters over a namespace we do not own." },
|
||||
{ "family": "Anti-Cheat Expert", "match": "exact", "values": [ "ACE-CORE.sys" ], "scope": "machine",
|
||||
"note": "On disk beside ACE-BASE.sys in Wuthering Waves' AntiCheatExpert/ folder (MEASURED 2026-10-13); that it loads is unmeasured. Exact, as the row above." },
|
||||
{ "family": "BattlEye", "match": "exact", "values": [ "BEDaisy.sys" ], "scope": "machine",
|
||||
"note": "BattlEye's kernel driver, loaded by BEService while a protected game runs and unloaded after (documented, BattlEye FAQ). Unmeasured." },
|
||||
{ "family": "FACEIT", "match": "exact", "values": [ "FACEIT.sys" ], "scope": "machine",
|
||||
@@ -262,7 +266,7 @@
|
||||
{ "family": "Easy Anti-Cheat", "values": [ "EasyAntiCheat", "EasyAntiCheat_EOS" ] },
|
||||
{ "family": "BattlEye", "values": [ "BattlEye" ] },
|
||||
{ "family": "Anti-Cheat Expert", "values": [ "AntiCheatExpert", "AceAntibotClient" ],
|
||||
"note": "Documented (SteamDB FileDetectionRuleSets, AntiCheatExpert). Unmeasured." },
|
||||
"note": "Documented (SteamDB FileDetectionRuleSets). AntiCheatExpert MEASURED 2026-10-13 beside the executables of Wuthering Waves and Neverness To Everness, reached from the executable's own folder and never from the root. AceAntibotClient is unmeasured." },
|
||||
{ "family": "nProtect GameGuard", "values": [ "GameGuard" ] },
|
||||
{ "family": "Xigncode3", "values": [ "XIGNCODE", "XIGNCODE3" ] },
|
||||
{ "family": "AhnLab HackShield", "values": [ "HShield" ],
|
||||
@@ -278,8 +282,8 @@
|
||||
{ "family": "Easy Anti-Cheat", "values": [ "EasyAntiCheat", "EasyAntiCheat_EOS", "EasyAntiCheat_EOSSys" ] },
|
||||
{ "family": "Riot Vanguard", "values": [ "vgc", "vgk" ],
|
||||
"note": "vgk is the kernel driver's service, started at boot like vgk.sys itself." },
|
||||
{ "family": "Anti-Cheat Expert", "values": [ "AntiCheatExpert Protection", "AntiCheatExpert Service" ],
|
||||
"note": "'AntiCheatExpert Protection' MEASURED registered on the dev machine 2026-08-04 by Neverness To Everness. The sibling name is unmeasured." },
|
||||
{ "family": "Anti-Cheat Expert", "values": [ "AntiCheatExpert Protection", "AntiCheatExpert Service", "ACE-BASE" ],
|
||||
"note": "'AntiCheatExpert Protection' MEASURED registered on the dev machine 2026-08-04 by Neverness To Everness; 'ACE-BASE', the kernel service of ACE-BASE.sys, MEASURED registered there 2026-10-13. 'AntiCheatExpert Service' is unmeasured." },
|
||||
{ "family": "BattlEye", "values": [ "BEService", "BEDaisy" ],
|
||||
"note": "BEService is started by a protected game and stops after it; BEDaisy is the driver's service. A stopped service is absent (19_SAFETY). Unmeasured." },
|
||||
{ "family": "FACEIT", "values": [ "FACEIT", "FACEITService" ],
|
||||
@@ -298,6 +302,8 @@
|
||||
"note": "Shipped beside the game. This note said 'not a loadable module' until 2026-09-25: XIGNCODE3 LoadLibrary's x3.xem as its loader (documented), which is why the modules group names it too." },
|
||||
{ "family": "Anti-Cheat Expert", "values": [ "PGameProtectDriver_X64.sys", "SGuard64.exe", "SGuardSvc64.exe" ],
|
||||
"note": "A KERNEL DRIVER shipped inside the game install. MEASURED at 'Neverness To Everness/NTEGlobal/driver/' 2026-08-04, where check 4 returned Allow: no group named it, and the fuzzy tier is modules-only — so a name containing 'protect' sat in the game's tree and the static scan walked past." },
|
||||
{ "family": "Anti-Cheat Expert", "values": [ "ACE-BASE.sys", "ACE-CORE.sys", "ACE-Base64.dll", "ACE-Service64.exe", "ACE-Setup64.exe" ],
|
||||
"note": "MEASURED 2026-10-13 in Wuthering Waves' Client/Binaries/Win64/AntiCheatExpert/, beside its executable and four levels under its install root, which the walk from the root never opened: check 4 also walks the executable's own folder since then." },
|
||||
{ "family": "Easy Anti-Cheat", "values": [ "EasyAntiCheat_EOS_Setup.exe", "EasyAntiCheat_Setup.exe", "EasyAntiCheat_x64.dll", "EasyAntiCheat_x86.dll", "EasyAntiCheat_EOS.sys", "start_protected_game.exe", "eac_server64.dll" ],
|
||||
"note": "For a layout where the EasyAntiCheat folder sits deeper than the scan reaches. start_protected_game.exe is the EAC launcher FromSoftware titles ship (ELDEN RING's appeared in the owner's Windows Application log on 2026-09-21)." },
|
||||
{ "family": "BattlEye", "values": [ "BEService.exe", "BEService_x64.exe", "BEClient.dll", "BEClient_x64.dll", "BEDaisy.sys" ],
|
||||
@@ -418,6 +424,7 @@
|
||||
{ "store": "steam", "id": "2139460", "family": "NetEase Anti-Cheat", "reason": "Protected by NetEase's kernel anti-cheat (NEAC)." },
|
||||
{ "store": "steam", "id": "2507950", "family": "Anti-Cheat Expert", "reason": "Protected by Tencent Anti-Cheat Expert (ACE), a kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "2073620", "family": "Anti-Cheat Expert", "reason": "Protected by Tencent Anti-Cheat Expert (ACE), a kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "3513350", "family": "Anti-Cheat Expert", "reason": "Wuthering Waves, protected by Tencent Anti-Cheat Expert (ACE), a kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "1517290", "family": "EA AntiCheat", "reason": "Protected by EA AntiCheat (Javelin), a kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "2807960", "family": "EA AntiCheat", "reason": "Protected by EA AntiCheat (Javelin), a kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "2669320", "family": "EA AntiCheat", "reason": "Protected by EA AntiCheat (Javelin), a kernel anti-cheat." },
|
||||
|
||||
@@ -110,6 +110,8 @@ public partial class App : System.Windows.Application
|
||||
_host = BuildHost(_db, appearance, registered, closePolicy);
|
||||
await _host.StartAsync().ConfigureAwait(true);
|
||||
Log.Information("ui: started ({Version}), ledger {Ledger}", UiIdentity.Version, UiPaths.Database);
|
||||
// beta.21: tier 0 is software rendering (a VM without a GPU, Remote Desktop) - every scroll drawn on the CPU.
|
||||
Log.Information("ui: render tier {Tier} (2 = the GPU draws; 0 = software)", System.Windows.Media.RenderCapability.Tier >> 16);
|
||||
if (UiPaths.IsViewer)
|
||||
{
|
||||
Log.Warning("ui: a VIEWER over {Folder} (--data-dir, D52): no Agent is started or contacted, nothing on this PC is changed", UiPaths.DataDirectory);
|
||||
@@ -192,7 +194,8 @@ public partial class App : System.Windows.Application
|
||||
Log.Warning(ex, "diag: the hardware could not be read; its lines are n/a");
|
||||
}
|
||||
|
||||
string report = DiagReport.Build(UiIdentity.Version, UiPaths.DataDirectory, UiPaths.Logs, schema, values, new AgentLauncher().CanLaunch, now, hardware);
|
||||
string report = DiagReport.Build(UiIdentity.Version, UiPaths.DataDirectory, UiPaths.Logs, schema, values, new AgentLauncher().CanLaunch, now, hardware,
|
||||
System.Windows.Media.RenderCapability.Tier >> 16);
|
||||
string path = DiagReport.Write(UiPaths.Logs, report, now);
|
||||
await Console.Out.WriteLineAsync(string.Format(CultureInfo.CurrentCulture, Strings.Diag_Written_Format, path)).ConfigureAwait(true);
|
||||
Log.Information("ui: --diag written to {Path}", path);
|
||||
|
||||
@@ -97,9 +97,8 @@ public partial class DocumentBrowser : UserControl
|
||||
|
||||
private void ShowPage(DocumentPage? page)
|
||||
{
|
||||
View.DocumentPath = page?.Path;
|
||||
View.IsPlainText = page?.IsPlainText ?? false;
|
||||
View.MarkdownText = page?.Text ?? string.Empty;
|
||||
// One render, now (beta.21): the three properties one by one rendered the old text under the new path first.
|
||||
View.Show(page?.Text ?? string.Empty, page?.IsPlainText ?? false, page?.Path);
|
||||
AutomationProperties.SetName(View, page?.Title ?? string.Empty);
|
||||
PageChanged?.Invoke(this, EventArgs.Empty);
|
||||
}
|
||||
|
||||
@@ -4,7 +4,10 @@
|
||||
using System.Windows;
|
||||
using System.Windows.Controls;
|
||||
using System.Windows.Documents;
|
||||
using System.Windows.Input;
|
||||
using System.Windows.Media;
|
||||
using System.Windows.Navigation;
|
||||
using System.Windows.Threading;
|
||||
using FrameLedger.App.Markdown;
|
||||
using FrameLedger.App.Services;
|
||||
|
||||
@@ -18,8 +21,32 @@ namespace FrameLedger.App.Controls;
|
||||
/// (<see cref="RepositoryLinkRequested"/>), which shows it when the App embeds it, and otherwise opens on GitHub at this
|
||||
/// build's source (<see cref="RepositoryLinks"/>); anything else is not followed.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// <b>The wheel (beta.21, owner request 2026-10-13: "scrolling the documents is slow").</b> WPF's scroll viewer moves a
|
||||
/// fixed 48 DIP per wheel message, whatever its delta — about two and a half lines of body text, Windows' "lines to
|
||||
/// scroll" ignored, and a precision touchpad's small deltas each jumping the whole step (measured: −1, −15, −120 and −360
|
||||
/// all moved 48). Layout costs about a millisecond a step, so the step was the problem, not drawing. The view now moves
|
||||
/// <see cref="WheelStep"/>: the delta in proportion, Windows' lines per notch at a browser's line (100/3 DIP), scaled by
|
||||
/// the zoom — and eases there over about 120 ms unless Windows' animations are off. At either end it leaves the wheel
|
||||
/// unhandled, so whatever holds the view (the update notes' dialog) scrolls instead. Ctrl+wheel stays the zoom.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>One render per page.</b> Each of the three properties rendered the whole document on its own, so a page change
|
||||
/// rendered the old text under the new path first, and the Legal Gate's three bindings rendered three times. Property
|
||||
/// changes now ask for one render, posted to the dispatcher ahead of layout; <see cref="Show"/> sets all three and renders
|
||||
/// at once; and a document this view has rendered is kept (<see cref="CacheCapacity"/>), so going back to a page costs
|
||||
/// its layout and nothing else.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public sealed class MarkdownView : FlowDocumentScrollViewer
|
||||
{
|
||||
/// <summary>A line of the wheel's step: Chromium scrolls 100 DIP for Windows' default three lines at 100%.</summary>
|
||||
internal const double WheelLineDip = 100.0 / 3.0;
|
||||
|
||||
/// <summary>How many rendered documents one view keeps (the user guide has twelve pages and Limitations).</summary>
|
||||
internal const int CacheCapacity = 16;
|
||||
|
||||
public static readonly DependencyProperty MarkdownTextProperty =
|
||||
DependencyProperty.Register(nameof(MarkdownText), typeof(string), typeof(MarkdownView), new PropertyMetadata(null, OnSourceChanged));
|
||||
|
||||
@@ -29,7 +56,18 @@ public sealed class MarkdownView : FlowDocumentScrollViewer
|
||||
public static readonly DependencyProperty DocumentPathProperty =
|
||||
DependencyProperty.Register(nameof(DocumentPath), typeof(string), typeof(MarkdownView), new PropertyMetadata(null, OnSourceChanged));
|
||||
|
||||
private readonly Dictionary<RenderKey, RenderedMarkdown> _cache = [];
|
||||
private readonly LinkedList<RenderKey> _recent = new();
|
||||
private IReadOnlyDictionary<string, Block> _anchors = new Dictionary<string, Block>(StringComparer.Ordinal);
|
||||
private RenderKey? _shown;
|
||||
private bool _batching;
|
||||
private DispatcherOperation? _pending;
|
||||
|
||||
private ScrollViewer? _scroller;
|
||||
private double _wheelTarget = double.NaN;
|
||||
private double _lastSetOffset = double.NaN;
|
||||
private TimeSpan _lastFrame;
|
||||
private bool _easing;
|
||||
|
||||
public MarkdownView()
|
||||
{
|
||||
@@ -38,7 +76,8 @@ public sealed class MarkdownView : FlowDocumentScrollViewer
|
||||
VerticalScrollBarVisibility = ScrollBarVisibility.Auto;
|
||||
Focusable = true;
|
||||
AddHandler(Hyperlink.RequestNavigateEvent, new RequestNavigateEventHandler(OnRequestNavigate));
|
||||
Rebuild();
|
||||
Unloaded += (_, _) => StopEasing();
|
||||
RenderNow();
|
||||
}
|
||||
|
||||
/// <summary>A link to another file of the repository; the host shows it and sets Handled, or it opens on GitHub.</summary>
|
||||
@@ -69,31 +108,226 @@ public sealed class MarkdownView : FlowDocumentScrollViewer
|
||||
public IUrlOpener UrlOpener { get; set; } = new ShellUrlOpener();
|
||||
|
||||
/// <summary>The headings this document can scroll to, by anchor.</summary>
|
||||
public IReadOnlyCollection<string> Anchors => [.. _anchors.Keys];
|
||||
public IReadOnlyCollection<string> Anchors
|
||||
{
|
||||
get
|
||||
{
|
||||
RenderIfPending();
|
||||
return [.. _anchors.Keys];
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>How many documents this view has rendered from text — a cache hit is not one (for tests).</summary>
|
||||
internal int Renders { get; private set; }
|
||||
|
||||
/// <summary>Where the wheel is taking the view, or NaN when it is not easing it there (for tests).</summary>
|
||||
internal double ScrollTarget => _wheelTarget;
|
||||
|
||||
/// <summary>The template's scroll viewer, once the template is applied (for tests).</summary>
|
||||
internal ScrollViewer? Scroller => _scroller;
|
||||
|
||||
/// <summary>The modifier keys held, read when the wheel turns; a test gives its own rather than the real keyboard's.</summary>
|
||||
internal Func<ModifierKeys> CurrentModifiers { get; set; } = static () => Keyboard.Modifiers;
|
||||
|
||||
/// <summary>Windows' "lines to scroll" per notch (−1: a screen); a test gives its own.</summary>
|
||||
internal Func<int> WheelScrollLines { get; set; } = static () => SystemParameters.WheelScrollLines;
|
||||
|
||||
/// <summary>Whether the wheel eases to its target; off where Windows' animations are, and in tests.</summary>
|
||||
internal bool EaseWheel { get; set; } = SystemParameters.ClientAreaAnimation;
|
||||
|
||||
/// <summary>Shows a document: the three properties at once, rendered once, now.</summary>
|
||||
public void Show(string? text, bool isPlainText, string? path)
|
||||
{
|
||||
_batching = true;
|
||||
try
|
||||
{
|
||||
DocumentPath = path;
|
||||
IsPlainText = isPlainText;
|
||||
MarkdownText = text;
|
||||
}
|
||||
finally
|
||||
{
|
||||
_batching = false;
|
||||
}
|
||||
|
||||
RenderNow();
|
||||
}
|
||||
|
||||
/// <summary>Brings the heading with <paramref name="anchor"/> into view; whether the document has it.</summary>
|
||||
public bool ScrollTo(string anchor)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(anchor);
|
||||
RenderIfPending();
|
||||
if (!_anchors.TryGetValue(anchor, out Block? block))
|
||||
{
|
||||
return false;
|
||||
}
|
||||
|
||||
StopEasing();
|
||||
block.BringIntoView();
|
||||
return true;
|
||||
}
|
||||
|
||||
private static void OnSourceChanged(DependencyObject d, DependencyPropertyChangedEventArgs e) => ((MarkdownView)d).Rebuild();
|
||||
|
||||
private void Rebuild()
|
||||
/// <summary>
|
||||
/// The distance one wheel message moves the view, in DIP (positive: down). <paramref name="delta"/> in proportion (120 is a
|
||||
/// notch); <paramref name="wheelScrollLines"/> lines per notch at <see cref="WheelLineDip"/>, or a screen
|
||||
/// (<paramref name="viewportHeight"/>) when Windows says −1; scaled by <paramref name="zoomPercent"/>.
|
||||
/// </summary>
|
||||
internal static double WheelStep(int delta, int wheelScrollLines, double viewportHeight, double zoomPercent)
|
||||
{
|
||||
string text = MarkdownText ?? string.Empty;
|
||||
RenderedMarkdown rendered = IsPlainText ? MarkdownRenderer.RenderPlainText(text) : MarkdownRenderer.Render(text, DocumentPath);
|
||||
double notches = delta / 120.0;
|
||||
double perNotch = wheelScrollLines < 0 ? viewportHeight : wheelScrollLines * WheelLineDip * zoomPercent / 100.0;
|
||||
return -notches * perNotch;
|
||||
}
|
||||
|
||||
public override void OnApplyTemplate()
|
||||
{
|
||||
base.OnApplyTemplate();
|
||||
StopEasing();
|
||||
_scroller = GetTemplateChild("PART_ContentHost") as ScrollViewer;
|
||||
}
|
||||
|
||||
protected override void OnPreviewMouseWheel(MouseWheelEventArgs e)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(e);
|
||||
base.OnPreviewMouseWheel(e);
|
||||
if (e.Handled || _scroller is not { } scroller || (CurrentModifiers() & ModifierKeys.Control) != ModifierKeys.None)
|
||||
{
|
||||
return; // Ctrl+wheel is the zoom
|
||||
}
|
||||
|
||||
double step = WheelStep(e.Delta, WheelScrollLines(), scroller.ViewportHeight, Zoom);
|
||||
if (step == 0 || double.IsNaN(step))
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
double from = double.IsNaN(_wheelTarget) ? scroller.VerticalOffset : _wheelTarget;
|
||||
double to = Math.Clamp(from + step, 0, scroller.ScrollableHeight);
|
||||
if (Math.Abs(to - scroller.VerticalOffset) < 0.5 && double.IsNaN(_wheelTarget))
|
||||
{
|
||||
return; // at the end it would move toward: the wheel is the host's
|
||||
}
|
||||
|
||||
e.Handled = true;
|
||||
if (!EaseWheel)
|
||||
{
|
||||
scroller.ScrollToVerticalOffset(to);
|
||||
return;
|
||||
}
|
||||
|
||||
_wheelTarget = to;
|
||||
if (!_easing)
|
||||
{
|
||||
_easing = true;
|
||||
_lastFrame = TimeSpan.Zero;
|
||||
_lastSetOffset = scroller.VerticalOffset;
|
||||
CompositionTarget.Rendering += OnRendering;
|
||||
}
|
||||
}
|
||||
|
||||
private static void OnSourceChanged(DependencyObject d, DependencyPropertyChangedEventArgs e) => ((MarkdownView)d).RequestRender();
|
||||
|
||||
[System.Diagnostics.CodeAnalysis.SuppressMessage("Usage", "VSTHRD001:Avoid legacy thread switching APIs", Justification = "a WPF application has no JoinableTaskFactory; this posts to the view's own dispatcher from its own thread, at a priority ahead of layout, and never waits (ScrollBarHiding does the same)")]
|
||||
private void RequestRender()
|
||||
{
|
||||
if (_batching || _pending is not null)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
// Ahead of layout, after whatever is setting the other properties has set them.
|
||||
_pending = Dispatcher.InvokeAsync(RenderIfPending, DispatcherPriority.DataBind);
|
||||
}
|
||||
|
||||
private void RenderIfPending()
|
||||
{
|
||||
if (_pending is null)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
RenderNow();
|
||||
}
|
||||
|
||||
private void RenderNow()
|
||||
{
|
||||
if (_pending is { } pending)
|
||||
{
|
||||
_ = pending.Abort();
|
||||
_pending = null;
|
||||
}
|
||||
|
||||
var key = new RenderKey(DocumentPath, IsPlainText, MarkdownText ?? string.Empty);
|
||||
if (_shown is { } shown && shown.Equals(key))
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
if (!_cache.TryGetValue(key, out RenderedMarkdown? rendered))
|
||||
{
|
||||
rendered = key.IsPlainText ? MarkdownRenderer.RenderPlainText(key.Text) : MarkdownRenderer.Render(key.Text, key.Path);
|
||||
Renders++;
|
||||
_cache[key] = rendered;
|
||||
}
|
||||
else
|
||||
{
|
||||
_ = _recent.Remove(key);
|
||||
}
|
||||
|
||||
_ = _recent.AddFirst(key);
|
||||
while (_recent.Count > CacheCapacity && _recent.Last is { } oldest)
|
||||
{
|
||||
_ = _cache.Remove(oldest.Value);
|
||||
_recent.RemoveLast();
|
||||
}
|
||||
|
||||
StopEasing();
|
||||
_anchors = rendered.Anchors;
|
||||
_shown = key;
|
||||
Document = rendered.Document;
|
||||
}
|
||||
|
||||
private void OnRendering(object? sender, EventArgs e)
|
||||
{
|
||||
if (_scroller is not { } scroller || double.IsNaN(_wheelTarget))
|
||||
{
|
||||
StopEasing();
|
||||
return;
|
||||
}
|
||||
|
||||
// Something else moved the view since the last frame (the scroll bar, the keyboard, a link): it is theirs now.
|
||||
if (Math.Abs(scroller.VerticalOffset - _lastSetOffset) > 1)
|
||||
{
|
||||
StopEasing();
|
||||
return;
|
||||
}
|
||||
|
||||
TimeSpan now = (e as RenderingEventArgs)?.RenderingTime ?? TimeSpan.Zero;
|
||||
double elapsedMs = _lastFrame == TimeSpan.Zero ? 16 : Math.Clamp((now - _lastFrame).TotalMilliseconds, 1, 100);
|
||||
_lastFrame = now;
|
||||
|
||||
// Exponential ease-out: about 95% of the way in 120 ms, however many notches have been added on the way.
|
||||
double remaining = _wheelTarget - scroller.VerticalOffset;
|
||||
double next = Math.Abs(remaining) < 0.5 ? _wheelTarget : scroller.VerticalOffset + (remaining * (1 - Math.Exp(-elapsedMs / 40.0)));
|
||||
scroller.ScrollToVerticalOffset(next);
|
||||
_lastSetOffset = next;
|
||||
if (next == _wheelTarget)
|
||||
{
|
||||
StopEasing();
|
||||
}
|
||||
}
|
||||
|
||||
private void StopEasing()
|
||||
{
|
||||
_wheelTarget = double.NaN;
|
||||
if (_easing)
|
||||
{
|
||||
_easing = false;
|
||||
CompositionTarget.Rendering -= OnRendering;
|
||||
}
|
||||
}
|
||||
|
||||
private void OnRequestNavigate(object sender, RequestNavigateEventArgs e)
|
||||
{
|
||||
e.Handled = true;
|
||||
@@ -116,4 +350,7 @@ public sealed class MarkdownView : FlowDocumentScrollViewer
|
||||
_ = ScrollTo(anchor);
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>What a rendered document depends on: theme and language are not in it — its colours are resource references.</summary>
|
||||
private readonly record struct RenderKey(string? Path, bool IsPlainText, string Text);
|
||||
}
|
||||
@@ -233,7 +233,7 @@ public static class MarkdownRenderer
|
||||
int columns = Math.Max(table.ColumnDefinitions.Count, rows.Select(static r => r.Count).DefaultIfEmpty(0).Max());
|
||||
for (int i = 0; i < columns; i++)
|
||||
{
|
||||
wpf.Columns.Add(new TableColumn { Width = GridLength.Auto });
|
||||
wpf.Columns.Add(new TableColumn()); // WPF's default width is already Auto (read by reflection, beta.21)
|
||||
}
|
||||
|
||||
var group = new TableRowGroup();
|
||||
|
||||
@@ -74,7 +74,7 @@
|
||||
<StackPanel>
|
||||
<ui:TextBlock FontTypography="BodyStrong" Text="{x:Static vm:GameDetailViewModel.SupportsHeader}" />
|
||||
<ui:TextBlock Margin="0,6,0,0" Style="{StaticResource TertiaryText}" TextWrapping="Wrap"
|
||||
Text="{x:Static vm:GameDetailViewModel.SupportsEmptyText}"
|
||||
Text="{Binding ViewModel.SupportsEmptyText}"
|
||||
Visibility="{Binding ViewModel.SupportsEmpty, Converter={StaticResource BoolToVis}}" />
|
||||
<ItemsControl Margin="0,6,0,0" ItemsSource="{Binding ViewModel.Supports}">
|
||||
<ItemsControl.ItemsPanel>
|
||||
|
||||
@@ -26,7 +26,8 @@ public static class DiagReport
|
||||
}
|
||||
|
||||
/// <summary>The report text. <paramref name="settings"/> is every registry key's effective value; <paramref name="schemaVersion"/> null when the ledger could not be opened.</summary>
|
||||
public static string Build(string appVersion, string dataDirectory, string logsDirectory, long? schemaVersion, IReadOnlyDictionary<string, string> settings, bool agentBesideApp, DateTimeOffset now, HardwareSnapshot? hardware = null)
|
||||
public static string Build(string appVersion, string dataDirectory, string logsDirectory, long? schemaVersion, IReadOnlyDictionary<string, string> settings, bool agentBesideApp, DateTimeOffset now, HardwareSnapshot? hardware = null,
|
||||
int? renderTier = null)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(settings);
|
||||
var sb = new StringBuilder();
|
||||
@@ -48,6 +49,8 @@ public static class DiagReport
|
||||
sb.AppendLine(CultureInfo.InvariantCulture, $"gpu_driver: {hardware?.GpuDriver ?? "n/a"}");
|
||||
sb.AppendLine(CultureInfo.InvariantCulture, $"ram_gb: {(hardware?.RamGb is double gb ? gb.ToString("0.#", CultureInfo.InvariantCulture) : "n/a")}");
|
||||
sb.AppendLine(CultureInfo.InvariantCulture, $"display: {hardware?.DisplayRes ?? "n/a"}{(hardware?.DisplayHz is double hz ? " @ " + hz.ToString("0.#", CultureInfo.InvariantCulture) + " Hz" : string.Empty)}");
|
||||
// beta.21: WPF's rendering tier — 0 is software rendering, where every scroll of a document is drawn on the CPU.
|
||||
sb.AppendLine(CultureInfo.InvariantCulture, $"render_tier: {(renderTier is int tier ? tier.ToString(CultureInfo.InvariantCulture) : "n/a")}");
|
||||
sb.AppendLine("settings:");
|
||||
foreach (SettingDefinition definition in SettingsRegistry.All)
|
||||
{
|
||||
|
||||
Generated
+3
@@ -488,6 +488,7 @@ public static class Strings
|
||||
nameof(GameDetail_Supports_Empty),
|
||||
nameof(GameDetail_Supports_Format),
|
||||
nameof(GameDetail_Supports_Header),
|
||||
nameof(GameDetail_Supports_None),
|
||||
nameof(GameDetail_Tab_Distribution),
|
||||
nameof(GameDetail_Tab_Frametime),
|
||||
nameof(GameDetail_Tab_Latency),
|
||||
@@ -1995,6 +1996,8 @@ public static class Strings
|
||||
|
||||
public static string GameDetail_Supports_Header => ResourceManager.GetString(nameof(GameDetail_Supports_Header), Culture) ?? nameof(GameDetail_Supports_Header);
|
||||
|
||||
public static string GameDetail_Supports_None => ResourceManager.GetString(nameof(GameDetail_Supports_None), Culture) ?? nameof(GameDetail_Supports_None);
|
||||
|
||||
public static string GameDetail_Tab_Distribution => ResourceManager.GetString(nameof(GameDetail_Tab_Distribution), Culture) ?? nameof(GameDetail_Tab_Distribution);
|
||||
|
||||
public static string GameDetail_Tab_Frametime => ResourceManager.GetString(nameof(GameDetail_Tab_Frametime), Culture) ?? nameof(GameDetail_Tab_Frametime);
|
||||
|
||||
@@ -4217,4 +4217,8 @@
|
||||
<value>{0} は FrameLedger 自身のデータ フォルダーです。--data-dir はそのコピー用で、テスト ビルドが記録先のデータベースを開かないようにするためのものです。このフォルダーを使うには --data-dir を付けずに FrameLedger を起動してください。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Supports_None" xml:space="preserve">
|
||||
<value>見つかりません — ゲームのフォルダーには、ルールが挙げるアップスケーラー、フレーム生成、Vulkan のファイルがありません。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
</root>
|
||||
@@ -3173,4 +3173,7 @@ The documents below are the full terms; this summary does not replace them.</val
|
||||
<data name="DataDir_Profile_Format" xml:space="preserve">
|
||||
<value>{0} is FrameLedger's own data folder. --data-dir is for a copy of it, so that a test build never opens the database you record into. To use this folder, start FrameLedger without --data-dir.</value>
|
||||
</data>
|
||||
<data name="GameDetail_Supports_None" xml:space="preserve">
|
||||
<value>None found — the game's folder holds no upscaler, frame-generation or Vulkan file the rules name.</value>
|
||||
</data>
|
||||
</root>
|
||||
@@ -3168,4 +3168,7 @@ Các văn bản bên dưới là điều khoản đầy đủ; bản tóm tắt
|
||||
<data name="DataDir_Profile_Format" xml:space="preserve">
|
||||
<value>{0} là thư mục dữ liệu của chính FrameLedger. --data-dir dành cho một bản sao của nó, để một bản thử nghiệm không bao giờ mở cơ sở dữ liệu bạn đang ghi vào. Để dùng thư mục này, hãy mở FrameLedger không kèm --data-dir.</value>
|
||||
</data>
|
||||
<data name="GameDetail_Supports_None" xml:space="preserve">
|
||||
<value>Không tìm thấy — thư mục game không có file upscaler, frame generation hay Vulkan nào mà bộ quy tắc liệt kê.</value>
|
||||
</data>
|
||||
</root>
|
||||
@@ -83,6 +83,14 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
[ObservableProperty]
|
||||
private bool _supportsEmpty = true;
|
||||
|
||||
/// <summary>
|
||||
/// What the Supports card says when it lists nothing (beta.21): "not scanned yet" until the Agent's sweep has read the
|
||||
/// executable, then that none of the files the rules name was found. It said "not scanned yet" for every game that
|
||||
/// ships none of them — a scanned RPG Maker game's page contradicted its own Details card.
|
||||
/// </summary>
|
||||
[ObservableProperty]
|
||||
private string _supportsEmptyText = Strings.GameDetail_Supports_Empty;
|
||||
|
||||
[ObservableProperty]
|
||||
private string _measuredEmptyText = string.Empty;
|
||||
|
||||
@@ -277,8 +285,6 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
|
||||
public static string SupportsHeader => Strings.GameDetail_Supports_Header;
|
||||
|
||||
public static string SupportsEmptyText => Strings.GameDetail_Supports_Empty;
|
||||
|
||||
public static string MeasuredHeader => Strings.GameDetail_Measured_Header;
|
||||
|
||||
public static string RecordingHeader => Strings.GameDetail_Recording_Header;
|
||||
@@ -1025,6 +1031,9 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
}
|
||||
|
||||
SupportsEmpty = Supports.Count == 0;
|
||||
|
||||
// The Details card's own test: a row the sweep has read carries the executable's machine.
|
||||
SupportsEmptyText = row.ExeMachine is null ? Strings.GameDetail_Supports_Empty : Strings.GameDetail_Supports_None;
|
||||
}
|
||||
|
||||
private void PresentDetails(GameDetail detail)
|
||||
|
||||
@@ -320,15 +320,17 @@ struct Sources {
|
||||
|
||||
// Check 4 — the static pre-scan.
|
||||
//
|
||||
// The directory the target's image lives in. kFailed means we could not
|
||||
// The directory the target's image lives in — its OWN folder (2026-10-13;
|
||||
// until then the seam resolved the install root itself, and a folder beside
|
||||
// a nested executable was out of check 4's reach). The checks resolve the
|
||||
// install root from it (ResolveInstallRoot). kFailed means we could not
|
||||
// name it, which refuses: check 4 cannot run against a directory we cannot
|
||||
// find, and "we did not look" has never been a pass in this file.
|
||||
Collected (*ImageDirectory)(std::uint32_t pid, wchar_t* out, std::size_t cap) = nullptr;
|
||||
|
||||
// The target's executable LEAF NAME, for check 3. A separate seam from
|
||||
// ImageDirectory because it is a different fact: that one deliberately
|
||||
// resolves the INSTALL ROOT (Unreal puts the exe three levels below it), and
|
||||
// the name is exactly what it throws away.
|
||||
// ImageDirectory because it is a different fact: that one strips the name
|
||||
// to name the folder, and the name is exactly what it throws away.
|
||||
//
|
||||
// NARROW on purpose. `blockedExecutables` is ASCII by schema and
|
||||
// MatchesBlockedExecutable compares ASCII, so converting here keeps one
|
||||
|
||||
@@ -90,7 +90,10 @@ FL_GUARD_ABI void FlGuardedInjectWhenReady(std::uint32_t targetPid, const wchar_
|
||||
// It replaced FlStaticPreScan(gameDirectory) on 2026-09-25. That export scanned the directory it was given, and its
|
||||
// one caller gave the executable's own folder, so an Unreal title's root-level EasyAntiCheat/ was never seen by the
|
||||
// scan that decides whether hooking may be enabled. This one resolves the install root itself (ResolveInstallRoot, as
|
||||
// the chokepoint always did) and adds check 3: the executable's name and the install's store identity.
|
||||
// the chokepoint always did) and adds check 3: the executable's name and the install's store identity. Since
|
||||
// 2026-10-13 check 4 walks the executable's own folder too when it lives below the root, here and in the chokepoint
|
||||
// alike: the root's walk reaches three levels, and Wuthering Waves keeps its AntiCheatExpert\ beside an executable
|
||||
// that is already three levels down.
|
||||
//
|
||||
// It reports through FlGuardResult rather than an outcome enum of its own, so there is ONE reason table and ONE
|
||||
// mirror surface: kAllow means clean; BlockedExecutable, BlockedStoreId, AntiCheatDirectory and AntiCheatFile name
|
||||
|
||||
@@ -54,8 +54,18 @@ namespace fl::guard {
|
||||
// because the entry cap is a REFUSAL: overrunning it does not scan less, it
|
||||
// refuses the title.
|
||||
//
|
||||
// Both caps are REFUSALS, not truncations. A walk that stopped early has not
|
||||
// seen the directory, and this file has no "scanned what we could" state.
|
||||
// THE TWO CAPS ARE NOT THE SAME KIND — corrected 2026-10-13. This said both were
|
||||
// refusals, and only the ENTRY cap is: overrunning it, an unreadable name or a
|
||||
// reparse point is kIncomplete, which refuses. The DEPTH cap is a REACH: a folder
|
||||
// at the last level is reported by name and never opened, silently — so what it
|
||||
// holds is not seen, and the walk still reads as complete. Raising it is not the
|
||||
// answer: at depth 5 three installed titles overrun 4096 entries (Master Duel
|
||||
// 41,251), which would refuse them. What the reach cost was measured instead:
|
||||
// Wuthering Waves keeps `AntiCheatExpert\` beside its executable at
|
||||
// `Client\Binaries\Win64\` — four levels under the install root — and the walk
|
||||
// from the root read it clean. Check 4 therefore walks the root AND, when the
|
||||
// executable lives below it, the executable's own folder (ScanGameFolders,
|
||||
// fl_prescan.cpp): each with this reach and its own entry budget.
|
||||
inline constexpr std::size_t kMaxPreScanDepth = 3;
|
||||
inline constexpr std::size_t kMaxPreScanEntries = 4096;
|
||||
|
||||
@@ -84,6 +94,11 @@ inline constexpr std::size_t kMaxPreScanPathLen = 1024;
|
||||
// `D:\games\Title\` is a folder of other games, and refusing this title because
|
||||
// a sibling ships anti-cheat is a false refusal with no appeal.
|
||||
//
|
||||
// The root REPLACED the executable's folder as check 4's one walk on 2026-09-25,
|
||||
// and that was half right: what sits at the root (Lies of P's EasyAntiCheat/) is
|
||||
// seen, what sits beside a nested executable is not (kMaxPreScanDepth). Since
|
||||
// 2026-10-13 check 4 walks both.
|
||||
//
|
||||
// Returns false if the result does not fit, which the caller treats as
|
||||
// "cannot determine".
|
||||
[[nodiscard]] bool ResolveInstallRoot(const wchar_t* exeDir, wchar_t* out, std::size_t cap) noexcept;
|
||||
@@ -96,8 +111,9 @@ inline constexpr std::size_t kMaxPreScanPathLen = 1024;
|
||||
// game's hooking off like any finding (19_SAFETY §What a finding does to the game); the owner took that trade.
|
||||
inline constexpr const char* kKernelDriverInTreeFamily = "Kernel driver in the game folder";
|
||||
|
||||
// Check 4, as EvaluateImpl runs it: derive the target's directory from its pid,
|
||||
// then scan it.
|
||||
// Check 4, as EvaluateImpl runs it: derive the target's own folder from its pid
|
||||
// (Sources::ImageDirectory), resolve the install root from it, then walk the root
|
||||
// and — when they differ — the executable's folder.
|
||||
//
|
||||
// Takes Sources because every evidence input in this guard is a seam — an input
|
||||
// whose failure path cannot be exercised is an input whose failure path is
|
||||
@@ -119,13 +135,14 @@ inline constexpr const char* kKernelDriverInTreeFamily = "Kernel driver in the g
|
||||
// read.
|
||||
[[nodiscard]] Verdict CheckStoreIdentity(const Sources& s, const Rules& rules, const wchar_t* installRoot) noexcept;
|
||||
|
||||
// The same, as EvaluateImpl runs it: the install root derived from the pid, exactly as check 4 derives it.
|
||||
// The same, as EvaluateImpl runs it: the install root resolved from the target's own folder, exactly as check 4
|
||||
// resolves it.
|
||||
[[nodiscard]] Verdict CheckBlockedStoreId(const Sources& s, const Rules& rules, std::uint32_t targetPid) noexcept;
|
||||
|
||||
// The advisory form, for the question "can this game be enabled at all?" (FR-2.2) and for the Agent's pre-scan of
|
||||
// the library (19_SAFETY §What a finding does to the game). Same matcher, same polarity, no pid: check 3 (the
|
||||
// executable's own name, and the store identity of its install root) and check 4 (the install root's tree), from the
|
||||
// EXECUTABLE's path.
|
||||
// executable's own name, and the store identity of its install root) and check 4 (the install root's tree, and the
|
||||
// executable's own folder's tree when it lives below the root — 2026-10-13), from the EXECUTABLE's path.
|
||||
//
|
||||
// It takes the executable, not a directory, since 2026-09-25. It took a directory, and its one caller passed the
|
||||
// executable's own folder while nothing resolved the install root — so the pre-scan that decides whether hooking may
|
||||
|
||||
@@ -337,13 +337,15 @@ Collected ImageDirectoryImpl(std::uint32_t pid, wchar_t* out, std::size_t cap) n
|
||||
}
|
||||
*lastSep = L'\0';
|
||||
|
||||
// The INSTALL ROOT, not the executable's directory. Unreal puts the exe at
|
||||
// <root>\<Project>\Binaries\Win64\, and EasyAntiCheat/ sits at the root —
|
||||
// measured on Lies of P, where the pre-scan saw seven files none of which
|
||||
// could have been an anti-cheat SDK.
|
||||
if (!ResolveInstallRoot(path, out, cap)) {
|
||||
// The executable's OWN folder (2026-10-13). The checks derive the install
|
||||
// root from it (ResolveInstallRoot) and check 4 walks both. Until then this
|
||||
// returned the root, which is where Lies of P keeps EasyAntiCheat/ — and
|
||||
// that alone left a folder BESIDE an Unreal executable, three levels below
|
||||
// the root, out of the walk's reach: Wuthering Waves' AntiCheatExpert\.
|
||||
if (wcslen(path) + 1 > cap) {
|
||||
return Collected::kFailed; // truncating a path yields a DIFFERENT directory
|
||||
}
|
||||
wcscpy_s(out, cap, path);
|
||||
return Collected::kOk;
|
||||
}
|
||||
|
||||
|
||||
@@ -158,6 +158,23 @@ Verdict ScanWith(const Sources& s, const Rules& rules, const wchar_t* dir, const
|
||||
return Passed();
|
||||
}
|
||||
|
||||
// Check 4's two walks (2026-10-13): the install root's tree, then — when the executable lives below the root — the
|
||||
// executable's own folder's tree. The walk reaches kMaxPreScanDepth levels below the folder it starts from
|
||||
// (fl_prescan.h), and an Unreal executable sits three levels below its root, so a folder BESIDE it is four: MEASURED on
|
||||
// Wuthering Waves, whose `Client\Binaries\Win64\AntiCheatExpert\` the root's walk listed the parent of and never
|
||||
// opened, and which therefore read clean. Same walk, same caps, same tolerance and the same record of a tolerated
|
||||
// finding; the first refusal is the answer.
|
||||
Verdict ScanGameFolders(const Sources& s, const Rules& rules, const wchar_t* root, const wchar_t* exeDir,
|
||||
const Tolerance* tolerance, ToleratedFinding* finding) noexcept {
|
||||
if (Verdict v = ScanWith(s, rules, root, tolerance, finding); !v.Allowed()) {
|
||||
return v;
|
||||
}
|
||||
if (exeDir == nullptr || exeDir[0] == L'\0' || _wcsicmp(root, exeDir) == 0) {
|
||||
return Passed(); // the executable lives at its root: the one walk saw its folder
|
||||
}
|
||||
return ScanWith(s, rules, exeDir, tolerance, finding);
|
||||
}
|
||||
|
||||
// Case-insensitive comparison of one path segment.
|
||||
bool SegmentIs(const wchar_t* begin, const wchar_t* end, const wchar_t* literal) noexcept {
|
||||
const std::size_t n = static_cast<std::size_t>(end - begin);
|
||||
@@ -240,15 +257,16 @@ Verdict PreScanGameWith(const wchar_t* exePath, const Sources& s, const char* to
|
||||
return Refused(Reason::kBlockedExecutable, hit->family, leaf);
|
||||
}
|
||||
|
||||
// Check 3's store half, then check 4 — both over the install root. Title lists are never tolerated (D33): only
|
||||
// check 4 takes the exception, and only for a user-mode family.
|
||||
// Check 3's store half over the install root, then check 4 over the root and the executable's own folder. Title
|
||||
// lists are never tolerated (D33): only check 4 takes the exception, and only for a user-mode family.
|
||||
if (Verdict v = CheckStoreIdentity(s, rules, root); !v.Allowed()) {
|
||||
return v;
|
||||
}
|
||||
Tolerance tolerance;
|
||||
ResolveTolerance(rules, toleratedFamilies, tolerance);
|
||||
ToleratedFinding finding;
|
||||
if (Verdict v = ScanWith(s, rules, root, tolerance.any ? &tolerance : nullptr, &finding); !v.Allowed()) {
|
||||
if (Verdict v = ScanGameFolders(s, rules, root, dir, tolerance.any ? &tolerance : nullptr, &finding);
|
||||
!v.Allowed()) {
|
||||
return v;
|
||||
}
|
||||
return finding.seen ? ToleratedVerdict(finding) : Passed();
|
||||
@@ -335,7 +353,11 @@ Verdict CheckStaticPreScan(const Sources& s, const Rules& rules, std::uint32_t t
|
||||
// 19_SAFETY has no "three of four checks passed" state.
|
||||
return Refused(Reason::kPreScanFailed, nullptr, "could not establish the target's directory");
|
||||
}
|
||||
return ScanWith(s, rules, dir, tolerance, finding);
|
||||
wchar_t root[kMaxPreScanPathLen] = {};
|
||||
if (!ResolveInstallRoot(dir, root, kMaxPreScanPathLen)) {
|
||||
return Refused(Reason::kPreScanFailed, nullptr, "could not establish the game's install root");
|
||||
}
|
||||
return ScanGameFolders(s, rules, root, dir, tolerance, finding);
|
||||
}
|
||||
|
||||
Verdict CheckStoreIdentity(const Sources& s, const Rules& rules, const wchar_t* installRoot) noexcept {
|
||||
@@ -370,10 +392,14 @@ Verdict CheckBlockedStoreId(const Sources& s, const Rules& rules, std::uint32_t
|
||||
if (s.ImageDirectory == nullptr) {
|
||||
return Refused(Reason::kPreScanFailed, nullptr, "no image-path source");
|
||||
}
|
||||
wchar_t root[kMaxPreScanPathLen] = {};
|
||||
if (s.ImageDirectory(targetPid, root, kMaxPreScanPathLen) != Collected::kOk || root[0] == L'\0') {
|
||||
wchar_t dir[kMaxPreScanPathLen] = {};
|
||||
if (s.ImageDirectory(targetPid, dir, kMaxPreScanPathLen) != Collected::kOk || dir[0] == L'\0') {
|
||||
return Refused(Reason::kPreScanFailed, nullptr, "could not establish the target's directory");
|
||||
}
|
||||
wchar_t root[kMaxPreScanPathLen] = {};
|
||||
if (!ResolveInstallRoot(dir, root, kMaxPreScanPathLen)) {
|
||||
return Refused(Reason::kPreScanFailed, nullptr, "could not establish the game's install root");
|
||||
}
|
||||
return CheckStoreIdentity(s, rules, root);
|
||||
}
|
||||
|
||||
|
||||
+183
-10
@@ -154,6 +154,14 @@ struct Fake {
|
||||
std::wstring imageDirectory = L"C:\\Games\\Example";
|
||||
Collected imageDirectoryResult = Collected::kOk;
|
||||
std::wstring lastScannedDir; // what check 4 was asked to walk
|
||||
// 2026-10-13: check 4 walks the install root AND the executable's own folder. A directory named here answers with
|
||||
// its own listing; any other answers with `dirEntries`, so every case written before keeps its meaning.
|
||||
struct Listing {
|
||||
std::vector<std::pair<std::string, bool>> entries;
|
||||
Collected result = Collected::kOk;
|
||||
};
|
||||
std::map<std::wstring, Listing> listingAt;
|
||||
std::vector<std::wstring> scannedDirs; // every directory check 4 was asked to walk, in order
|
||||
|
||||
// Check 3's store half (2026-09-25). Defaults to "this install carries no store identity", so every
|
||||
// pre-existing case keeps its meaning now that the floor lists store ids: check 3 asks, and allows.
|
||||
@@ -312,12 +320,15 @@ Collected FakeImageFileName(std::uint32_t, char* out, std::size_t cap) {
|
||||
|
||||
Collected FakeEnumDirEntries(const wchar_t* dir, DirEntrySink sink, void* ctx) {
|
||||
g.lastScannedDir = dir != nullptr ? dir : L"";
|
||||
for (const auto& e : g.dirEntries) {
|
||||
g.scannedDirs.push_back(g.lastScannedDir);
|
||||
const auto own = g.listingAt.find(g.lastScannedDir);
|
||||
const auto& entries = own != g.listingAt.end() ? own->second.entries : g.dirEntries;
|
||||
for (const auto& e : entries) {
|
||||
if (!sink(ctx, e.first.c_str(), e.second)) {
|
||||
break;
|
||||
}
|
||||
}
|
||||
return g.dirEntriesResult;
|
||||
return own != g.listingAt.end() ? own->second.result : g.dirEntriesResult;
|
||||
}
|
||||
|
||||
Collected FakeStoreIdentity(const wchar_t* installRoot, char* out, std::size_t cap) {
|
||||
@@ -3759,10 +3770,13 @@ TEST_CASE("a directory listing that FAILED is undetermined, not clean", "[guard]
|
||||
}
|
||||
|
||||
TEST_CASE("a TRUNCATED directory listing is undetermined, not clean", "[guard][prescan][failclosed]") {
|
||||
// The entry cap, the depth cap and an unfollowed reparse point all arrive
|
||||
// The entry cap, an unreadable name and an unfollowed reparse point arrive
|
||||
// here as kIncomplete. An empty-but-incomplete listing is the exact shape
|
||||
// of this project's worst defect: it reads as "nothing found" when it means
|
||||
// "we did not finish looking".
|
||||
// "we did not finish looking". The DEPTH cap does not arrive here, and this
|
||||
// comment said it did until 2026-10-13: it is a reach — a folder at the last
|
||||
// level is named and never opened, and the walk still reports kOk — which
|
||||
// is why check 4 walks the executable's own folder too (fl_prescan.h).
|
||||
ResetFake();
|
||||
g.dirEntries = {{"game.exe", false}};
|
||||
g.dirEntriesResult = Collected::kIncomplete;
|
||||
@@ -3951,17 +3965,95 @@ TEST_CASE("the advisory pre-scan reaches the same verdict as the one inside the
|
||||
CHECK(StaticPreScanGameWithSources(L"C:\\Games\\Example\\", FakeSources()).reason == Reason::kPreScanFailed);
|
||||
}
|
||||
|
||||
TEST_CASE("the advisory pre-scan walks the INSTALL ROOT, not the executable's folder", "[guard][prescan]") {
|
||||
TEST_CASE("the advisory pre-scan walks the INSTALL ROOT first, then the executable's folder", "[guard][prescan]") {
|
||||
// Until 2026-09-25 the advisory pre-scan scanned the directory it was handed, and the Agent handed it the
|
||||
// executable's own folder: for Lies of P's layout, a folder of seven files, with EasyAntiCheat/ three levels up.
|
||||
// The chokepoint resolved the root all along; the scan that decides whether hooking may be enabled did not.
|
||||
// The chokepoint resolved the root all along; the scan that decides whether hooking may be enabled did not. A hit
|
||||
// at the root is the answer, so nothing is walked after it.
|
||||
const std::wstring root = LR"(D:\SteamLibrary\steamapps\common\Lies of P)";
|
||||
const std::wstring exe = root + LR"(\LiesofP\Binaries\Win64\LOP-Win64-Shipping.exe)";
|
||||
ResetFake();
|
||||
g.dirEntries = {{"EasyAntiCheat", true}};
|
||||
const Verdict v = StaticPreScanGameWithSources(
|
||||
LR"(D:\SteamLibrary\steamapps\common\Lies of P\LiesofP\Binaries\Win64\LOP-Win64-Shipping.exe)", FakeSources());
|
||||
const Verdict v = StaticPreScanGameWithSources(exe.c_str(), FakeSources());
|
||||
CHECK(v.reason == Reason::kAntiCheatDirectory);
|
||||
CHECK(g.lastScannedDir == LR"(D:\SteamLibrary\steamapps\common\Lies of P)");
|
||||
CHECK(g.lastStoreRoot == LR"(D:\SteamLibrary\steamapps\common\Lies of P)");
|
||||
CHECK(g.lastScannedDir == root);
|
||||
CHECK(g.scannedDirs.size() == 1);
|
||||
CHECK(g.lastStoreRoot == root);
|
||||
|
||||
// A clean root: the executable's own folder is walked next (2026-10-13), and both are clean.
|
||||
ResetFake();
|
||||
g.dirEntries = {{"LOP-Win64-Shipping.exe", false}};
|
||||
CHECK(StaticPreScanGameWithSources(exe.c_str(), FakeSources()).Allowed());
|
||||
REQUIRE(g.scannedDirs.size() == 2);
|
||||
CHECK(g.scannedDirs[0] == root);
|
||||
CHECK(g.scannedDirs[1] == root + LR"(\LiesofP\Binaries\Win64)");
|
||||
}
|
||||
|
||||
TEST_CASE("an anti-cheat folder beside a nested executable refuses -- Wuthering Waves", "[guard][prescan]") {
|
||||
// MEASURED 2026-10-13 (spike-notes §19). Wuthering Waves keeps Tencent's ACE in `Client\Binaries\Win64\
|
||||
// AntiCheatExpert\`, beside `Client-Win64-Shipping.exe` and four levels under its install root. The root's walk named
|
||||
// `Win64` and never opened it (kMaxPreScanDepth), so the library pre-scan read the game clean three times, and a
|
||||
// session was hooked for 37 s before the 30 s re-scan met ACE's driver — a machine-wide finding, which turned
|
||||
// nothing off. The root's listing here is what the real walk returns to that depth.
|
||||
const std::wstring root = LR"(D:\SteamLibrary\steamapps\common\Wuthering Waves)";
|
||||
const std::wstring exeDir = root + LR"(\Client\Binaries\Win64)";
|
||||
const std::wstring exe = exeDir + LR"(\Client-Win64-Shipping.exe)";
|
||||
|
||||
ResetFake();
|
||||
g.listingAt[root].entries = {
|
||||
{"Client", true}, {"Binaries", true}, {"Win64", true}, {"Engine", true}, {"Wuthering Waves.exe", false}};
|
||||
g.listingAt[exeDir].entries = {
|
||||
{"AntiCheatExpert", true}, {"ACE-BASE.sys", false}, {"Client-Win64-Shipping.exe", false}};
|
||||
|
||||
const Verdict advisory = StaticPreScanGameWithSources(exe.c_str(), FakeSources());
|
||||
REQUIRE_FALSE(advisory.Allowed());
|
||||
CHECK(advisory.reason == Reason::kAntiCheatDirectory);
|
||||
CHECK(std::strcmp(advisory.family, "Anti-Cheat Expert") == 0);
|
||||
CHECK(std::strcmp(advisory.signal, "AntiCheatExpert") == 0);
|
||||
REQUIRE(g.scannedDirs.size() == 2);
|
||||
CHECK(g.scannedDirs[1] == exeDir);
|
||||
|
||||
// The chokepoint, from the pid: the seam names the executable's folder, the store half asks the root resolved from
|
||||
// it, and check 4 walks both.
|
||||
g.scannedDirs.clear();
|
||||
g.imageDirectory = exeDir;
|
||||
const Verdict chokepoint = EvaluateWithSources(1234, FakeSources());
|
||||
REQUIRE_FALSE(chokepoint.Allowed());
|
||||
CHECK(chokepoint.reason == Reason::kAntiCheatDirectory);
|
||||
CHECK(std::strcmp(chokepoint.family, "Anti-Cheat Expert") == 0);
|
||||
CHECK(g.lastStoreRoot == root);
|
||||
REQUIRE(g.scannedDirs.size() == 2);
|
||||
CHECK(g.scannedDirs[0] == root);
|
||||
CHECK(g.scannedDirs[1] == exeDir);
|
||||
}
|
||||
|
||||
TEST_CASE("an executable at its install root is walked once", "[guard][prescan]") {
|
||||
ResetFake();
|
||||
g.dirEntries = {{"game.exe", false}};
|
||||
CHECK(StaticPreScanGameWithSources(LR"(D:\SteamLibrary\steamapps\common\Some Title\game.exe)", FakeSources())
|
||||
.Allowed());
|
||||
REQUIRE(g.scannedDirs.size() == 1);
|
||||
CHECK(g.scannedDirs[0] == LR"(D:\SteamLibrary\steamapps\common\Some Title)");
|
||||
|
||||
// So is one no store boundary names — its folder is its root — from the pid as from the path.
|
||||
ResetFake();
|
||||
g.dirEntries = {{"game.exe", false}};
|
||||
CHECK(EvaluateWithSources(1234, FakeSources()).Allowed());
|
||||
REQUIRE(g.scannedDirs.size() == 1);
|
||||
CHECK(g.scannedDirs[0] == L"C:\\Games\\Example");
|
||||
}
|
||||
|
||||
TEST_CASE("a walk of the executable's folder that could not finish refuses after a clean root",
|
||||
"[guard][prescan][failclosed]") {
|
||||
const std::wstring root = LR"(D:\SteamLibrary\steamapps\common\Nested)";
|
||||
const std::wstring exeDir = root + LR"(\Game\Binaries\Win64)";
|
||||
ResetFake();
|
||||
g.listingAt[root].entries = {{"Game", true}};
|
||||
g.listingAt[exeDir].entries = {{"Game-Win64-Shipping.exe", false}};
|
||||
g.listingAt[exeDir].result = Collected::kIncomplete;
|
||||
const Verdict v = StaticPreScanGameWithSources((exeDir + LR"(\Game-Win64-Shipping.exe)").c_str(), FakeSources());
|
||||
REQUIRE_FALSE(v.Allowed());
|
||||
CHECK(v.reason == Reason::kPreScanFailed);
|
||||
}
|
||||
|
||||
TEST_CASE("the advisory pre-scan runs check 3 on the executable's own name", "[guard][prescan][check3]") {
|
||||
@@ -4172,6 +4264,67 @@ TEST_CASE("the real seam reads a GOG product id, and a plain folder carries none
|
||||
RemoveDirectoryW(root.c_str());
|
||||
}
|
||||
|
||||
TEST_CASE("the real walk reaches an anti-cheat folder beside a nested executable", "[guard][prescan][real]") {
|
||||
// Wuthering Waves' layout, on disk (2026-10-13). From the root the real walk names `Win64` and never opens it — the
|
||||
// reach this test pins — and check 4's second walk, from the executable's own folder, finds `AntiCheatExpert\`.
|
||||
const std::wstring lib = MakeTempTree(L"nested");
|
||||
const std::wstring steamapps = lib + L"\\steamapps";
|
||||
const std::wstring root = steamapps + L"\\common\\Game";
|
||||
const std::wstring exeDir = root + L"\\Client\\Binaries\\Win64";
|
||||
const std::wstring ac = exeDir + L"\\AntiCheatExpert";
|
||||
for (const std::wstring& d : {lib, steamapps, steamapps + L"\\common", root, root + L"\\Client",
|
||||
root + L"\\Client\\Binaries", exeDir, ac}) {
|
||||
CreateDirectoryW(d.c_str(), nullptr);
|
||||
}
|
||||
const std::wstring exe = exeDir + L"\\Game-Win64-Shipping.exe";
|
||||
WriteText(exe, "MZ");
|
||||
WriteText(ac + L"\\ACE-Base64.dll", "MZ");
|
||||
|
||||
Sources s = SystemSources();
|
||||
REQUIRE(s.EnumerateDirEntries != nullptr);
|
||||
|
||||
std::vector<std::string> fromRoot;
|
||||
const DirEntrySink collect = [](void* ctx, const char* name, bool) {
|
||||
static_cast<std::vector<std::string>*>(ctx)->push_back(name);
|
||||
return true;
|
||||
};
|
||||
REQUIRE(s.EnumerateDirEntries(root.c_str(), collect, &fromRoot) == Collected::kOk);
|
||||
CHECK(std::find(fromRoot.begin(), fromRoot.end(), "Win64") != fromRoot.end());
|
||||
CHECK(std::find(fromRoot.begin(), fromRoot.end(), "AntiCheatExpert") == fromRoot.end());
|
||||
|
||||
// The pre-scan over the real walk and the real store seam (no manifest names this install), with the fixture's
|
||||
// rules: the floor carries ACE's folder whatever the file says.
|
||||
ResetFake();
|
||||
s.ReadRulesFile = &FakeReadRules;
|
||||
const Verdict v = StaticPreScanGameWithSources(exe.c_str(), s);
|
||||
REQUIRE_FALSE(v.Allowed());
|
||||
CHECK(v.reason == Reason::kAntiCheatDirectory);
|
||||
CHECK(std::strcmp(v.family, "Anti-Cheat Expert") == 0);
|
||||
|
||||
// The folder gone, the same tree is clean: the second walk refuses nothing it should not.
|
||||
DeleteFileW((ac + L"\\ACE-Base64.dll").c_str());
|
||||
RemoveDirectoryW(ac.c_str());
|
||||
CHECK(StaticPreScanGameWithSources(exe.c_str(), s).Allowed());
|
||||
|
||||
DeleteFileW(exe.c_str());
|
||||
for (const std::wstring& d :
|
||||
{exeDir, root + L"\\Client\\Binaries", root + L"\\Client", root, steamapps + L"\\common", steamapps, lib}) {
|
||||
RemoveDirectoryW(d.c_str());
|
||||
}
|
||||
}
|
||||
|
||||
TEST_CASE("the real ImageDirectory names the executable's own folder", "[guard][prescan][real]") {
|
||||
// Not the install root (2026-10-13): the checks resolve that themselves, and check 4 walks both.
|
||||
wchar_t self[MAX_PATH] = {};
|
||||
REQUIRE(GetModuleFileNameW(nullptr, self, MAX_PATH) != 0);
|
||||
std::wstring folder(self);
|
||||
folder.resize(folder.find_last_of(L"\\/"));
|
||||
|
||||
wchar_t out[kMaxPreScanPathLen] = {};
|
||||
REQUIRE(SystemSources().ImageDirectory(GetCurrentProcessId(), out, kMaxPreScanPathLen) == Collected::kOk);
|
||||
CHECK(_wcsicmp(out, folder.c_str()) == 0);
|
||||
}
|
||||
|
||||
// ===========================================================================
|
||||
// Check 2b against the REAL service control manager.
|
||||
//
|
||||
@@ -5887,6 +6040,26 @@ TEST_CASE("D33 -- the advisory pre-scan answers the same question the chokepoint
|
||||
CHECK(std::string(aniimo.family) == kKernelDriverInTreeFamily);
|
||||
}
|
||||
|
||||
TEST_CASE("D33 -- the executable's folder is walked under the same exception", "[guard][D33][prescan]") {
|
||||
// 2026-10-13: check 4's second walk takes the tolerance and the finding record exactly as the first does — the
|
||||
// family's file beside a nested executable is recorded, and a kernel driver there still refuses.
|
||||
const std::wstring root = LR"(D:\SteamLibrary\steamapps\common\Nested Yidun)";
|
||||
const std::wstring exeDir = root + LR"(\Game\Binaries\Win64)";
|
||||
const std::wstring exe = exeDir + LR"(\Game-Win64-Shipping.exe)";
|
||||
ResetFake();
|
||||
g.listingAt[root].entries = {{"Game", true}};
|
||||
g.listingAt[exeDir].entries = {{"Game-Win64-Shipping.exe", false}, {"NEP2.dll", false}};
|
||||
|
||||
const Verdict v = StaticPreScanGameWithSources(exe.c_str(), FakeSources(), kYidun);
|
||||
CHECK(v.reason == Reason::kAllowedUserModeException);
|
||||
CHECK(std::string(v.signal) == "NEP2.dll");
|
||||
|
||||
g.listingAt[exeDir].entries.push_back({"NEPKernel.sys", false});
|
||||
const Verdict driver = StaticPreScanGameWithSources(exe.c_str(), FakeSources(), kYidun);
|
||||
CHECK(driver.reason == Reason::kAntiCheatFile);
|
||||
CHECK(std::string(driver.family) == kKernelDriverInTreeFamily);
|
||||
}
|
||||
|
||||
TEST_CASE("D33 -- the excepted family's module loading late does not stop the Overlay; any other family still does",
|
||||
"[guard][inject][shm][loader][D33]") {
|
||||
// The Overlay's half. A decoy named `NEP2.dll` (NetEase Yidun's module, an exact floor match) loads 2.5 s after
|
||||
|
||||
@@ -36,6 +36,9 @@ public sealed class DiagReportTests
|
||||
}
|
||||
|
||||
report.Should().Contain(" capture.min_session_s = 30", "a key with no row reports its default");
|
||||
report.Should().Contain("render_tier: n/a", "no tier given");
|
||||
DiagReport.Build("1.2.3", @"C:\data", @"C:\data\logs", 2, values, agentBesideApp: true, now, renderTier: 0)
|
||||
.Should().Contain("render_tier: 0", "beta.21: software rendering, where every scroll is drawn on the CPU, is named");
|
||||
}
|
||||
|
||||
[Fact]
|
||||
|
||||
@@ -238,6 +238,35 @@ public sealed class GameDetailViewModelTests
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// beta.21: a game the sweep has read and found none of the capability files in says so — the card read "not scanned yet"
|
||||
/// for every such game, as HELLO, HELLO WORLD!'s page did beside a Details card that had been read.
|
||||
/// </summary>
|
||||
[Fact]
|
||||
public async Task TheSupportsCardSaysNotScannedOnlyUntilTheSweepHasReadTheExecutable()
|
||||
{
|
||||
await using ScratchLedger s = await ScratchLedger.OpenAsync();
|
||||
GameRow game = await s.GameAsync("Plain");
|
||||
|
||||
(GameDetailViewModel unread, _, _, _, _) = await BuildAsync(s, game.Id);
|
||||
unread.SupportsEmpty.Should().BeTrue();
|
||||
unread.SupportsEmptyText.Should().Be(Strings.GameDetail_Supports_Empty, "the sweep has not read this game yet");
|
||||
|
||||
(await s.Games.ApplyDetectionAsync(game.Id, new DetectionWrite
|
||||
{
|
||||
EngineId = "rpgmaker_mv",
|
||||
CapabilityIds = [],
|
||||
RulesVersion = "2026.10.4",
|
||||
ExeSizeBytes = 1,
|
||||
ExeMtimeMs = 1,
|
||||
ExeArchitecture = ExecutableArchitecture.X64,
|
||||
}, Ct)).Should().BeTrue();
|
||||
|
||||
(GameDetailViewModel read, _, _, _, _) = await BuildAsync(s, game.Id);
|
||||
read.SupportsEmpty.Should().BeTrue("the game ships none of the files the rules name");
|
||||
read.SupportsEmptyText.Should().Be(Strings.GameDetail_Supports_None);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public async Task TheHeaderTheTwoRowsAndTheSessionsTabReadFromTheLedger()
|
||||
{
|
||||
|
||||
@@ -0,0 +1,154 @@
|
||||
// SPDX-License-Identifier: GPL-3.0-only
|
||||
// Copyright (C) 2026 poli0981 - additional terms under GPLv3 section 7: see NOTICE
|
||||
|
||||
using System.Windows;
|
||||
using System.Windows.Controls;
|
||||
using System.Windows.Input;
|
||||
using FluentAssertions;
|
||||
using FrameLedger.App.Controls;
|
||||
using Xunit;
|
||||
|
||||
namespace FrameLedger.App.Tests;
|
||||
|
||||
/// <summary>
|
||||
/// beta.21 (owner request 2026-10-13: "scrolling the documents in the app is slow"): the wheel moves a document by Windows'
|
||||
/// lines at a browser's line instead of WPF's fixed 48 DIP, in proportion to the delta, and leaves its ends to the host; a
|
||||
/// page is rendered once, and a page shown before is not rendered again.
|
||||
/// </summary>
|
||||
public sealed class MarkdownViewTests
|
||||
{
|
||||
private static readonly string _longText = string.Join("\n\n", Enumerable.Range(1, 400).Select(static i => "Paragraph " + i + ": a few words that wrap."));
|
||||
|
||||
[Fact]
|
||||
public void TheWheelStepFollowsTheDeltaWindowsLinesAndTheZoom()
|
||||
{
|
||||
MarkdownView.WheelStep(-120, 3, 600, 100).Should().BeApproximately(100, 1e-9, "three lines at a browser's line, downwards");
|
||||
MarkdownView.WheelStep(120, 3, 600, 100).Should().BeApproximately(-100, 1e-9);
|
||||
MarkdownView.WheelStep(-15, 3, 600, 100).Should().BeApproximately(12.5, 1e-9, "a touchpad's small delta moves in proportion");
|
||||
MarkdownView.WheelStep(-120, 3, 600, 200).Should().BeApproximately(200, 1e-9, "zoomed in, a line is taller");
|
||||
MarkdownView.WheelStep(-120, -1, 600, 100).Should().BeApproximately(600, 1e-9, "Windows' \"one screen at a time\"");
|
||||
MarkdownView.WheelStep(-120, 0, 600, 100).Should().Be(0);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public async Task TheWheelMovesTheDocumentByItsStepAndLeavesItsEndsToTheHost()
|
||||
{
|
||||
(double notch, double touch, bool atEnd, bool withCtrl) = await PagesLoadTests.OnStaAsync(static () =>
|
||||
{
|
||||
var view = new MarkdownView { EaseWheel = false, WheelScrollLines = static () => 3, CurrentModifiers = static () => ModifierKeys.None };
|
||||
view.Show(_longText, isPlainText: false, path: "LIMITATIONS.md");
|
||||
Layout(view);
|
||||
ScrollViewer scroller = view.Scroller ?? throw new InvalidOperationException("the template has no PART_ContentHost");
|
||||
scroller.ScrollableHeight.Should().BeGreaterThan(1000, "the document is longer than its view");
|
||||
|
||||
Wheel(view, -120).Should().BeTrue();
|
||||
Layout(view);
|
||||
double afterNotch = scroller.VerticalOffset;
|
||||
|
||||
Wheel(view, -15).Should().BeTrue();
|
||||
Layout(view);
|
||||
double afterTouch = scroller.VerticalOffset;
|
||||
|
||||
scroller.ScrollToVerticalOffset(scroller.ScrollableHeight);
|
||||
Layout(view);
|
||||
bool handledAtEnd = Wheel(view, -120);
|
||||
|
||||
scroller.ScrollToVerticalOffset(0);
|
||||
Layout(view);
|
||||
view.CurrentModifiers = static () => ModifierKeys.Control;
|
||||
bool handledWithCtrl = Wheel(view, -120);
|
||||
return (afterNotch, afterTouch, handledAtEnd, handledWithCtrl);
|
||||
});
|
||||
|
||||
notch.Should().BeApproximately(100, 0.5, "one notch is three lines of 100/3 DIP, not WPF's fixed 48");
|
||||
touch.Should().BeApproximately(112.5, 0.5, "a delta of 15 is an eighth of a notch");
|
||||
atEnd.Should().BeFalse("at the end the wheel is the host's — the update notes' dialog scrolls instead");
|
||||
withCtrl.Should().BeFalse("Ctrl+wheel is the zoom's, never the scroll's");
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public async Task EasingAddsEveryNotchToTheTargetAndANewPageStopsIt()
|
||||
{
|
||||
(double first, double second, double afterShow) = await PagesLoadTests.OnStaAsync(static () =>
|
||||
{
|
||||
var view = new MarkdownView { EaseWheel = true, WheelScrollLines = static () => 3, CurrentModifiers = static () => ModifierKeys.None };
|
||||
view.Show(_longText, isPlainText: false, path: "LIMITATIONS.md");
|
||||
Layout(view);
|
||||
Wheel(view, -120).Should().BeTrue();
|
||||
double target1 = view.ScrollTarget;
|
||||
Wheel(view, -120).Should().BeTrue();
|
||||
double target2 = view.ScrollTarget;
|
||||
view.Show("# Another page", isPlainText: false, path: "guide/README.md");
|
||||
return (target1, target2, view.ScrollTarget);
|
||||
});
|
||||
|
||||
first.Should().BeApproximately(100, 0.5);
|
||||
second.Should().BeApproximately(200, 0.5, "a notch turned while easing adds to where the view is going, not to where it is");
|
||||
double.IsNaN(afterShow).Should().BeTrue("a new page ends the easing");
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public async Task APageIsRenderedOnceAndAPageShownBeforeIsNotRenderedAgain()
|
||||
{
|
||||
(int one, int two, int back, int evicted) = await PagesLoadTests.OnStaAsync(static () =>
|
||||
{
|
||||
var view = new MarkdownView();
|
||||
int start = view.Renders; // the constructor's empty document
|
||||
view.Show("# One\n\ntext", isPlainText: false, path: "guide/a.md");
|
||||
int afterOne = view.Renders - start;
|
||||
view.Show("# Two\n\ntext", isPlainText: false, path: "guide/b.md");
|
||||
int afterTwo = view.Renders - start;
|
||||
view.Show("# One\n\ntext", isPlainText: false, path: "guide/a.md");
|
||||
int afterBack = view.Renders - start;
|
||||
|
||||
for (int i = 0; i < MarkdownView.CacheCapacity; i++)
|
||||
{
|
||||
view.Show("# Page " + i, isPlainText: false, path: "guide/p" + i + ".md");
|
||||
}
|
||||
|
||||
int beforeEvicted = view.Renders;
|
||||
view.Show("# Two\n\ntext", isPlainText: false, path: "guide/b.md");
|
||||
return (afterOne, afterTwo, afterBack, view.Renders - beforeEvicted);
|
||||
});
|
||||
|
||||
one.Should().Be(1, "Show sets the three properties and renders once");
|
||||
two.Should().Be(2);
|
||||
back.Should().Be(2, "a page this view has rendered is kept");
|
||||
evicted.Should().Be(1, "past the cache's capacity the oldest page is rendered again");
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public async Task PropertiesSetOneByOneAreRenderedOnceAheadOfLayout()
|
||||
{
|
||||
(int beforePump, int afterPump, bool hasAnchor) = await PagesLoadTests.OnStaAsync(static () =>
|
||||
{
|
||||
var view = new MarkdownView();
|
||||
int start = view.Renders;
|
||||
view.DocumentPath = "guide/a.md";
|
||||
view.IsPlainText = false;
|
||||
view.MarkdownText = "# Heading\n\ntext";
|
||||
int before = view.Renders - start;
|
||||
Visuals.Pump();
|
||||
int after = view.Renders - start;
|
||||
return (before, after, view.Anchors.Count > 0);
|
||||
});
|
||||
|
||||
beforePump.Should().Be(0, "a binding's change asks for a render; it does not render the half-set page");
|
||||
afterPump.Should().Be(1, "three changes, one render");
|
||||
hasAnchor.Should().BeTrue();
|
||||
}
|
||||
|
||||
private static void Layout(FrameworkElement element)
|
||||
{
|
||||
element.Measure(new Size(700, 600));
|
||||
element.Arrange(new Rect(0, 0, 700, 600));
|
||||
element.UpdateLayout();
|
||||
}
|
||||
|
||||
private static bool Wheel(UIElement over, int delta)
|
||||
{
|
||||
var wheel = new MouseWheelEventArgs(Mouse.PrimaryDevice, Environment.TickCount, delta) { RoutedEvent = UIElement.PreviewMouseWheelEvent };
|
||||
over.RaiseEvent(wheel);
|
||||
return wheel.Handled;
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user