Compare commits
15
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
0b846084cc | ||
|
|
36f1b9d787 | ||
|
|
0e03d07dac | ||
|
|
5ab297b7b7 | ||
|
|
ebea4a7eda | ||
|
|
372389c521 | ||
|
|
7ad1519a4c | ||
|
|
5a890553b2 | ||
|
|
a4b18e698c | ||
|
|
32fdcf82f3 | ||
|
|
a7329fc45c | ||
|
|
f32c10d758 | ||
|
|
9b5d1cd486 | ||
|
|
01d3afd504 | ||
|
|
1a655237f5 |
No files matched your search
+237
@@ -29,6 +29,243 @@ under a `## [x.y.z] - date` heading in the same commit that bumps `VERSION`, the
|
||||
|
||||
### Added
|
||||
|
||||
- **The Games library fills the window, switches to a list, counts its games and refreshes** (owner requests, beta.11).
|
||||
The cards were 300 px in a plain wrap, so a wide window left up to a card's width empty at the right and the third pill
|
||||
("Hooking off") was cut; the grid now has as many columns as fit at 300 px or wider, every card an equal share of the
|
||||
width, and the pills wrap. A button beside the sort switches to a **list** — one row per game with its store, engine,
|
||||
status, sessions, playtime and last played — and the choice is remembered (`ui.library_view`). The title counts the
|
||||
games. **Refresh** reads the library again, looks in the stores for games installed since and offers only those (*No
|
||||
new games* when there are none), and marks every entry whose executable is gone **Not installed** — the tooltip says
|
||||
when it is the drive that is not connected; nothing is removed. The page also reloads by itself when a session ends or
|
||||
an import adds games while it is open (an import made from the menu used to show only after leaving the page).
|
||||
- **Import hides the games already in the library** (owner request, beta.11): on a re-import they were most of the list
|
||||
and pushed the new ones out of sight. *Show the N games already in the library* brings them back, dimmed, and a row
|
||||
that cannot be imported has its box disabled (a tick on it was taken and ignored).
|
||||
|
||||
- **Three CrackProof titles on the anti-cheat title list** (owner request, beta.11): Umamusume: Pretty Derby (Steam
|
||||
`3224770`), Heaven Burns Red (`1973710`) and Madoka Magica Magia Exedra (`2987800`). Each store page states *"Uses
|
||||
Kernel Level Anti-Cheat"* and names HyperTech's CrackProof; its driver loads from `System32` under a numbered name,
|
||||
outside the game's folder, so nothing of the game's own can name it and the list does, by Steam id only (no executable
|
||||
name was verified). ANOTHER EDEN, which a community list also names, is left out: its store page says nothing of the
|
||||
kind. Rules `2026.10.1` — every game is re-checked once, and these games' hooking is turned off like any title-list
|
||||
finding, never under a user-mode exception (`19_SAFETY` check 3).
|
||||
|
||||
### Changed
|
||||
|
||||
- **The user-mode anti-cheat exception no longer needs sessions measured before it — its first two sessions are a
|
||||
trial** (owner decision D38, beta.11). D33 asked for two successful hooked sessions before a grant, but since beta.8 a
|
||||
game is blocked the moment it is added, so a blocked game could never earn them, and a reset ledger lost the ones it
|
||||
had: after the owner deleted theirs, GIRLS' FRONTLINE 2 read *"Not eligible: 0 successful hooked session(s), two are
|
||||
needed"* for good. A grant now needs no session. Until two sessions under it have succeeded, the game page says
|
||||
*trial: N of 2*, and any end during the trial — a crash, a safety unhook, the Overlay's own stop, a new finding, or a
|
||||
stored hooked session that recorded no frame or did not end normally — ends the exception **for good** (schema 0017,
|
||||
`games.ac_exception_trial_failed_at`, set once and never cleared; the Agent refuses a grant with `TrialFailed` and the
|
||||
store refuses one in SQL; a twin merge keeps the mark). Every other condition is unchanged — one user-mode family, no
|
||||
`.sys` in the game's folder, no title list — and after the trial an end is what it was. The disclosure is
|
||||
`ac-exception-dialog/2`: it names no session count and has a *Trial* paragraph (`ja` stays English until reviewed).
|
||||
**Legal text:** Disclaimer 2.9 (§2A) and EULA 1.4, so the Legal Gate opens once; the accuracy block, `SECURITY.md` and
|
||||
`LIMITATIONS.md` say the same; CLAUDE.md rule 2 carries the amendment (`19_SAFETY` §The user-mode exception).
|
||||
|
||||
### Fixed
|
||||
|
||||
- **The exception's card and list say what is true** (found with D38): an eligible game's *Anti-cheat* card said hooking
|
||||
"cannot be turned on" beside a usable *Make exception…* — it now says hooking is off unless you make one; the Settings
|
||||
list showed each game's session count twice and listed games that could never qualify, with no action — it lists only
|
||||
games it can act on; a tolerant scan that found nothing of the family was said as "the check could not finish" — it
|
||||
says the family was not found; and a blocked game whose executable could not be read stayed *Checking…* for ever — the
|
||||
sweep now answers it. **Refresh** shows only while a row is being checked, the one time it can change anything.
|
||||
|
||||
## [0.1.0-beta.10] - 2026-09-28
|
||||
|
||||
**The tenth pre-release: how each game was shown, the agent as administrator if you choose it, and the exact Unreal
|
||||
Engine version.** The same unsigned installer: verify its hash against `SHA256SUMS.txt`, then *More info → Run anyway*.
|
||||
What changed for a user:
|
||||
|
||||
- **The display mode** — exclusive full-screen, borderless, windowed or minimised, as a share of each session, with the
|
||||
window's size and the monitor's — on the session summary, the game page, the Trend (three new metrics) and Compare,
|
||||
for measured and unmeasured sessions alike. Only a measured Direct3D game can say *exclusive*; others read
|
||||
*full-screen or borderless* when the window covers the screen.
|
||||
- **Run the agent as administrator** — a Settings option, off by default. Windows asks every time the agent starts;
|
||||
games you start from FrameLedger still run with your standard rights; it changes nothing in the anti-cheat guard.
|
||||
- **The exact Unreal Engine version** on a game's page, read from its executable, with what it rests on.
|
||||
- **What FrameLedger cannot do** is one page — Help ▸ Limitations, and `LIMITATIONS.md` — and the games it has been run
|
||||
with are listed in `docs/LIST_GAME_TESTED.md`.
|
||||
- **The Privacy Policy (2.5) and the Disclaimer (2.8) say so**, so the Legal Gate opens once after the update. The EULA
|
||||
is unchanged.
|
||||
|
||||
**Updating from `0.1.0-beta.9`:**
|
||||
|
||||
- Quit the App (tray icon → Exit) and end `FrameLedger.Agent.exe` before running the installer.
|
||||
- Schemas 0015 and 0016 add columns; the database opens in place. Sessions recorded before show the display mode as N/A.
|
||||
- The shared-memory layout between the agent and a measured game changed (version 4): **a game that was running while
|
||||
you updated must be restarted before it can be measured** — the app says so when it meets the old layout.
|
||||
- Every game is re-detected once (rules `2026.09.6`), which fills in the Unreal Engine versions.
|
||||
|
||||
### Added
|
||||
|
||||
- **The exact Unreal Engine version on a game's page** (owner request, beta.10). The Agent reads it from the game's
|
||||
shipping executable on disk — its version number and the engine's build name compiled into it (`++UE5+Release-5.1`)
|
||||
— and the page says which of the two it rests on: *Unreal Engine 4.27.2* for Lies of P, *5.4.4* for Clair Obscur:
|
||||
Expedition 33, *5.1* for SILENT HILL 2 (whose studio replaced the version number with its own), and "not found in the
|
||||
executable" where neither says anything (Cronos, Rune Factory). Measured on ten installed Unreal titles before it was
|
||||
written: eight read, two honestly none. The file is read, never the game's process; a protected executable is scanned
|
||||
whole, once per version of the file (up to 7.5 s on a USB drive for Black Myth: Wukong), and the scan stops if the Agent
|
||||
is asked to. Rules `2026.09.6`: every game is re-detected once. Schema 0015 adds `games.engine_version_source`.
|
||||
|
||||
- **How each game was shown, and for how much of the session** (owner request, beta.10): exclusive fullscreen, borderless,
|
||||
windowed or minimised, with the window's size, the monitor it was on and its refresh rate, and the swap chain's back
|
||||
buffer. On the session summary (a *Display* card and a line with every share), the game page (the last measured session,
|
||||
and a *Display* column in Sessions), the Trend (three new metrics: the share of each session in exclusive fullscreen,
|
||||
borderless and windowed), Compare (three rows, never ranked) and both exports (the CSV's `# display:` line, the JSON's
|
||||
aggregates). **Both tiers:** a game that was not hooked has its window read from outside, which can say windowed or
|
||||
*fullscreen or borderless* but never which of those two — only the swap chain of a hooked DirectX game can say
|
||||
exclusive. What Windows does with an exclusive game behind the scenes ("fullscreen optimizations") is not visible to
|
||||
FrameLedger, and a game's menu may call a borderless window "Fullscreen": the swap chain's answer is the one shown.
|
||||
Sessions recorded before, and one recovered after a crash, read N/A. Schema 0016 adds fifteen `sessions.display_*`
|
||||
columns, and `sessions.swap_effect` — a column with no writer since the first schema — is now filled.
|
||||
|
||||
- **Run the capture agent as administrator — your choice, off by default** (owner request, beta.10). Settings ▸ Capture
|
||||
agent ▸ *Run the agent as administrator* shows what it adds (measuring a game that itself runs as administrator; the CPU
|
||||
temperature where PawnIO is installed), what it does not change (a game with anti-cheat is still refused; a Vulkan game
|
||||
run as administrator is still not measured) and the risk of a per-user, unsigned install, before it turns on. Then
|
||||
**Windows asks every time the agent starts** — also at logon, when its prompt may wait on the taskbar; there is no
|
||||
silent way. Answer No and the agent runs with your standard rights and says so; answer with another administrator
|
||||
account and that agent refuses to run, because its data would not be yours. **Games you start from FrameLedger always
|
||||
run with your standard rights**, and nothing FrameLedger does enables a privilege (a CI test on an elevated runner and a
|
||||
source check hold both). While the prompt waits, the status pill says so. With the option off, an App started as
|
||||
administrator no longer makes the agent an administrator's too. Updating now also waits for an administrator agent's
|
||||
process to let go of its files.
|
||||
|
||||
- **What FrameLedger cannot do, in one place** (beta.10). `LIMITATIONS.md` lists the limits of the whole software in
|
||||
plain words — the games it will not measure, what an unmeasured session holds, frame generation, upscaling and ray
|
||||
tracing, the display mode, the engine version, sensors, the admin mode, the platform and your data — each linked to its
|
||||
details; the app shows it under **Help ▸ Limitations**. `docs/LIST_GAME_TESTED.md` lists the real games FrameLedger has
|
||||
been run with and what was measured on each.
|
||||
|
||||
### Changed
|
||||
|
||||
- **The legal documents say what beta.10 does** — you will be shown two of them again once. **Privacy Policy 2.5** adds
|
||||
how a tracked game's window is shown (read from Windows) and the engine version read from an Unreal Engine game's
|
||||
executable, and says for the first time two things the software already did: it reads the content of a library game's
|
||||
executable (engine and library markers, its import table) and the processor load and memory in use. **Disclaimer 2.8**
|
||||
adds §5A — running the capture agent as administrator, what it does and does not do, and its risk — and points at the
|
||||
new limitations page and the tested-games list. The End-User License Agreement is unchanged (1.3).
|
||||
|
||||
- **Groundwork for the display mode (beta.10): the injected component reports how the game presents** — whether its swap
|
||||
chain is in exclusive fullscreen, which window it presents to, its back buffer and swap effect — at most twice a second,
|
||||
from two getters on the swap chain the game passed (measured at 13–15 ns each on the test fixture: nothing a frame rate
|
||||
can see). The shared-memory layout moves to version 4 (a new region; the frame ring moved behind it): **a game that is
|
||||
running while FrameLedger is updated must be restarted before it can be measured**, which the app already says when it
|
||||
meets an old layout. What the app shows from it is the display mode under *Added*.
|
||||
|
||||
### Fixed
|
||||
|
||||
- **An Unreal game's engine version was a bare "4" or "5"** — and for most titles nothing at all. The rule's pattern had two
|
||||
capture groups and the evaluator keeps the first, and it read only a version string most executables leave empty.
|
||||
Schema 0015 removes the digits the old rule wrote (only where detection wrote them — a version you typed stays), and the
|
||||
rules validator now refuses any version pattern that does not compile or that captures anything but exactly one group.
|
||||
|
||||
- **A Direct3D 12 game that resized through `ResizeBuffers1` kept its old output size in every later frame.** That call is
|
||||
not hooked; the swap chain's size is now re-read twice a second, so a resize by either route is seen.
|
||||
|
||||
## [0.1.0-beta.9] - 2026-09-26
|
||||
|
||||
**The ninth pre-release: one narrow exception you can make yourself for a game whose only anti-cheat runs in user
|
||||
mode and that FrameLedger has measured before.** The same unsigned installer: verify its hash against
|
||||
`SHA256SUMS.txt`, then *More info → Run anyway*. What changed for a user:
|
||||
|
||||
- **A user-mode anti-cheat exception, per game, off by default** (Settings ▸ Capture). It is offered only where the
|
||||
only anti-cheat found runs entirely in user mode — no driver or service, no driver file in the game's folder — the
|
||||
game is on no title list, and FrameLedger has measured it hooked successfully at least twice. You make it one game
|
||||
at a time, after a disclosure that states the ban risk; the guard still runs every check under it and ends it on
|
||||
anything new, a crash or safety stop under it, or a game update. Sessions under it are marked.
|
||||
- **The Disclaimer (2.7) and the EULA (1.3) say so**, so the Legal Gate opens once after the update. The Privacy
|
||||
Policy is unchanged.
|
||||
|
||||
**Updating from `0.1.0-beta.8`:**
|
||||
|
||||
- Quit the App (tray icon → Exit) and end `FrameLedger.Agent.exe` before running the installer.
|
||||
- Schema 0014 adds columns; the database opens in place. Nothing changes for any game until you turn the option on.
|
||||
- With the option on, the Agent looks at each game whose hooking it turned off within a minute and lists the ones
|
||||
that qualify; a game shipping a kernel driver (Aniimo's `NEPKernel.sys`, for one) never does.
|
||||
|
||||
### Added
|
||||
|
||||
- **A user-mode anti-cheat exception you can make yourself, per game** (owner decision D33). Settings ▸ Capture ▸
|
||||
*Allow hooking in games with user-mode anti-cheat that were measured before* — off by default. On, it lists the games
|
||||
FrameLedger found eligible: the only anti-cheat in the game runs entirely in user mode (no driver or service, no
|
||||
driver file anywhere in the game's folder), the game is on no title list, and FrameLedger has measured it hooked
|
||||
successfully at least twice. **Make exception…** shows a disclosure — the ban risk, possibly days later and invisible
|
||||
to FrameLedger; what is still refused; how the exception ends — and asks you to accept the risk for that game. The
|
||||
exception turns nothing on: you then turn hooking on for the game on its page, through the usual consent dialog, and
|
||||
the guard still runs every check and refuses anything else it finds. The game's page shows the exception's state
|
||||
(eligible; not eligible and why; in force; suspended; ended and why), the library card says **Exception**, and a
|
||||
session hooked under it is marked in the Sessions tab and its summary. It ends by itself on a new finding, a crash or
|
||||
safety stop under it, FrameLedger stopping because another anti-cheat loaded, or a game update; turning the option
|
||||
off suspends every exception. Aniimo stays blocked: it ships a kernel driver (`NEPKernel.sys`).
|
||||
|
||||
- **Groundwork for the user-mode anti-cheat exception** (owner decision D33, 2026-09-26; the option, the list and the
|
||||
disclosure arrive later in this train). The guard can now be asked to let ONE named anti-cheat family through, and
|
||||
grants it only for a family whose every signal — in the built-in floor and in the rules file — is user-mode: no
|
||||
driver, no service, no `.sys` (on today's rules NetEase Yidun, AhnLab HackShield, Anybrain and FredaikisAntiCheat).
|
||||
It still runs every check and keeps scanning past what it let through, so a second anti-cheat, a kernel driver in
|
||||
the game's folder, a title list, a driver or service on the machine, or a scan that could not finish still refuses;
|
||||
a pass that let something through says so and names it. The injected Overlay learns the same family before it
|
||||
starts watching the game's module loads, so a late-loading module of that family does not stop it and any other
|
||||
anti-cheat still does. Nothing asks for any of this yet: every game is judged exactly as in beta.8.
|
||||
- **The Agent can grant, keep and end a user-mode anti-cheat exception** (D33; the Settings option, the list and the
|
||||
disclosure arrive in the next PR, so nothing in the App asks for one yet). With the option on
|
||||
(`hooking.usermode_ac_exceptions`, off by default), the Agent's library scan asks each blocked game one question —
|
||||
would the guard let exactly its blocking family through, with no kernel driver and nothing else found — and counts
|
||||
its successful hooked sessions; a game with both and at least two sessions is eligible. A grant rests on facts the
|
||||
Agent gathers itself when asked, is bound to the executable's bytes and turns nothing on: hooking is the usual
|
||||
consent dialog afterwards. Under it the Agent tells the Overlay the family before injecting, names it to the guard at
|
||||
the start and at every 30 s re-scan, and marks the session with it. It ends — hooking off, the block standing, the
|
||||
reason kept — on a new finding, a safety unhook, the Overlay stopping for another anti-cheat, a crash while hooked, a
|
||||
game update, or when the user withdraws it; turning the option off suspends every exception without deleting any.
|
||||
Schema 0014 adds the columns; the database opens in place.
|
||||
|
||||
### Changed
|
||||
|
||||
- **Legal: Disclaimer 2.7 and EULA 1.3.** Disclaimer §2A describes the user-mode exception and its risk; the EULA's
|
||||
code-injection clause names it and what making one means. The accuracy block and SECURITY.md say it too. The Legal
|
||||
Gate shows the two changed documents once more; the Privacy Policy is unchanged (2.4).
|
||||
|
||||
## [0.1.0-beta.8] - 2026-09-25
|
||||
|
||||
**The eighth pre-release: anti-cheat is found before you ask, a session says what the game and the driver were, and
|
||||
a frame-generation session's numbers and charts are the application's.** The same unsigned installer: verify its
|
||||
hash against `SHA256SUMS.txt`, then *More info → Run anyway*. What changed for a user:
|
||||
|
||||
- **Anti-cheat is looked for harder, and before you ask.** Twenty-two families (74 entries), any kernel driver in a
|
||||
game's folder, and per-title lists by Steam app id and executable name. The Agent checks every game in your library
|
||||
on its own, turns hooking off for those with anti-cheat, and their pages show what was found instead of the hooking
|
||||
switch. Their sessions are still recorded, with play time and sensors.
|
||||
- **A game's page says what its files say** — 64-bit or 32-bit, the file and store versions, the DLSS / FSR / XeSS
|
||||
libraries it ships — and a 32-bit game's hooking cannot be turned on.
|
||||
- **NVIDIA App overrides are shown**: each session records the driver profile the game ran under (DLSS preset and
|
||||
mode, frame generation, Smooth Motion), read from the driver and never changed.
|
||||
- **Reasons read as what they are**: End task is not a crash, a refusal says what happened, a launch that could not
|
||||
start says why, a missing executable says whether its drive is disconnected.
|
||||
- **Trend works on first open**, with Native and Presented FPS as two metrics, and FPS can show two decimals
|
||||
(Settings ▸ Window).
|
||||
- **A frame-generation session's lows, median and stutter are over application frames**, a pause no longer counts as
|
||||
one long frame, and the charts draw what they say — including the sensors of a session that was not hooked.
|
||||
- **The Privacy Policy (2.4) is updated**, so the Legal Gate opens once after the update: it now names what the
|
||||
software reads to check every library game for anti-cheat, the version information of the game's files, and the
|
||||
NVIDIA driver's settings for your games — all on your PC, none of it sent anywhere.
|
||||
|
||||
**Updating from `0.1.0-beta.7`:**
|
||||
|
||||
- Quit the App (tray icon → Exit) and end `FrameLedger.Agent.exe` before running the installer.
|
||||
- Schemas 0010–0013 add columns; the database opens in place.
|
||||
- Shortly after the Agent starts it checks every game in your library for anti-cheat, once; a game where it finds
|
||||
some has its hooking turned off for good, with a notice if hooking was on.
|
||||
- Sessions recorded before keep the numbers they were stored with; the corrected lows and the in-step sensor overlay
|
||||
apply to sessions recorded from now on.
|
||||
|
||||
### Added
|
||||
|
||||
- **FrameLedger finds the anti-cheat games in your library on its own, and hides their hooking switch** (owner decision
|
||||
2026-09-25). The Agent now scans every game in the library for anti-cheat — once, and again whenever the rules or the
|
||||
game's executable change — where until now it scanned only a game someone asked to hook, so most games had never
|
||||
|
||||
@@ -16,6 +16,8 @@ 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-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.
|
||||
5. **The hook must never crash the game.** Every hook body: SEH-guarded, allocation-free, lock-free, no logging, no exceptions crossing the boundary. On repeated faults, self-disable (`17_HOOK_ENGINE` §Fault policy).
|
||||
@@ -175,6 +177,10 @@ The version handshake is wired end to end as of 2026-08-05: `FlGuardBuildId` giv
|
||||
8. `docs/18_GPU_VENDOR_APIS.md` — layered GPU telemetry (DXGI/PDH · LHM · NVAPI) + vendor-SDK licence rules
|
||||
9. `docs/06_DATA_MODEL.md` · `docs/07_IPC.md` · `docs/08_UI.md` · `docs/16_WPFUI_SYNTAX.md`
|
||||
10. Remaining (`09`–`15`).
|
||||
11. **`LIMITATIONS.md`** (repository root; shown in the App under Help ▸ Limitations) — what the WHOLE software cannot
|
||||
do, in the user's words, each item linked to its details. When a change moves a limit, the page changes in the same
|
||||
PR (D36, 2026-09-27). **`docs/LIST_GAME_TESTED.md`** — the real games FrameLedger has been run with and what each
|
||||
session measured, from a copy of the owner's ledger and the repository's own evidence (D35).
|
||||
|
||||
**Before writing native or capture code, read `docs/20_OPEN_QUESTIONS.md`.** It
|
||||
lists the defects and gaps that survived the doc audit — things the other
|
||||
|
||||
+130
@@ -0,0 +1,130 @@
|
||||
# What FrameLedger cannot do
|
||||
|
||||
FrameLedger measures a game by loading a small component into it — only for a game you added and switched
|
||||
hooking on for — and reading the graphics calls the game makes. That is why it can tell the real render
|
||||
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.10.*
|
||||
|
||||
## Games it will not measure
|
||||
|
||||
- **Games with anti-cheat.** FrameLedger looks for anti-cheat before it touches a game and refuses when it
|
||||
finds one — there is no switch that overrides this. The one exception is an anti-cheat that runs entirely
|
||||
inside the game (no driver, no service), which you can allow per game after a warning; its first two
|
||||
sessions are a trial, and one that does not go well ends the exception for good. A ban is still possible and
|
||||
may come days later. Kernel anti-cheat is never allowed.
|
||||
([Safety](docs/19_SAFETY_AND_ANTICHEAT.md))
|
||||
- **Anti-cheat FrameLedger does not know about.** The list of anti-cheat products is FrameLedger's own and
|
||||
can be incomplete. A game protected by something unknown may be hooked; that is a risk to your account
|
||||
that you take by switching hooking on.
|
||||
- **32-bit games and Direct3D 9 games.** Only 64-bit Direct3D 11, Direct3D 12 and OpenGL games are measured
|
||||
from their own calls; a 32-bit or Direct3D 9 game is recorded without measurement.
|
||||
- **Vulkan games, unless FrameLedger starts them.** A Vulkan game is measured only when FrameLedger launches it
|
||||
with its Vulkan layer switched on; one started another way is not observed by the layer.
|
||||
- **Games that run as administrator,** unless you turn on *Run the agent as administrator* in Settings
|
||||
(off by default; Windows asks every time the agent starts). **A process Windows protects** stays closed
|
||||
either way.
|
||||
- **Vulkan games that run as administrator.** Windows' Vulkan loader does not load FrameLedger's Vulkan
|
||||
layer into an elevated game, so admin mode does not help there.
|
||||
- **A game that was already running when FrameLedger was updated** — restart the game once.
|
||||
- **Games you did not switch hooking on for.** Adding a game only records its sessions; measuring it is a
|
||||
separate, per-game choice with its own warning.
|
||||
|
||||
## What an unmeasured session contains
|
||||
|
||||
When a game is not measured — any of the reasons above — its session still records **how long it ran, the
|
||||
machine's sensors (GPU temperature, load, power; CPU load; memory) and why nothing was measured.** Every
|
||||
frame-rate, upscaler, frame-generation and ray-tracing value reads **N/A**, never 0. How the game's window was
|
||||
shown is recorded too, from outside the game. ([Capture](docs/04_CAPTURE.md))
|
||||
|
||||
## Frame rate and frame generation
|
||||
|
||||
- **One inflated number is never shown.** When frame generation is measured, the page shows the game's own
|
||||
frames and the displayed frames together (`62 → 118 FPS (×1.9 FG)`). When it cannot be measured, the page
|
||||
shows **Presented FPS** with a sentence saying whether generated frames could be included.
|
||||
- **Frame generation done by the driver outside the game** (AMD Fluid Motion Frames, NVIDIA Smooth Motion)
|
||||
is not visible to FrameLedger; the rates shown are what the game presented.
|
||||
- Frame generation is counted on **Direct3D games** only. DLSS Frame Generation and FSR frame generation are
|
||||
named from the calls the game makes; any other generator is shown only as *active*, never named, and where
|
||||
the generated frames cannot be counted the page shows Presented FPS with a note instead of a factor.
|
||||
- **A session whose frame generation changed** (menus, loading, a settings change) shows the factor of the
|
||||
state it spent most of its time in, with the share of the session it covers — never an average of the two.
|
||||
([Metrics](docs/03_METRICS.md))
|
||||
|
||||
## Upscaling and ray tracing
|
||||
|
||||
- The upscaler is read from the game's calls: DLSS and NIS through NVIDIA Streamline, and FSR through AMD's
|
||||
FidelityFX libraries. **Intel XeSS is not read** (its licence forbids it), FSR 2 and upscalers built into the
|
||||
game are not identified, and Vulkan and OpenGL games read N/A. Where no hook saw DLSS but the NVIDIA driver
|
||||
reports it, the page says it is the driver's report.
|
||||
- **The quality preset** (Quality, Balanced, …) has not been reported on any game yet, and the render
|
||||
resolution is N/A where the game's own calls do not carry it (DLSS without Streamline, for one).
|
||||
- **Ray tracing** is *Yes*, *No* or *N/A* — measured from the game's ray-tracing calls on Direct3D 12, and
|
||||
N/A where FrameLedger could not look. **Path tracing is never stated as a fact**: there is no API signal
|
||||
for it. You can correct any of these by hand, and your correction is labelled as yours.
|
||||
- HDR output, NVIDIA Reflex latency, each game's own video-memory use and shader-compilation stutter are
|
||||
**not measured yet** — they read N/A. Video memory in use on the whole graphics card is recorded.
|
||||
([Accuracy](legal/ACCURACY.md))
|
||||
|
||||
## Display mode (full-screen, borderless, windowed)
|
||||
|
||||
- **Exclusive full-screen is known only for a measured Direct3D (DXGI) game** — the game's own swap chain
|
||||
says so. For OpenGL, Vulkan and unmeasured games, a window covering the screen reads *Fullscreen or
|
||||
borderless*, never either one.
|
||||
- **What Windows does behind the game is not visible:** a game in exclusive full-screen may still be shown
|
||||
through Windows' compositor ("fullscreen optimizations"), and a game's menu may call a borderless window
|
||||
"Fullscreen". FrameLedger reports what the game asked for.
|
||||
- The mode is sampled ten times a second in a measured session and once a second in an unmeasured one; very
|
||||
short switches can be missed. A session recovered after a crash, and every session recorded before
|
||||
beta.10, read N/A. ([Display mode](docs/03_METRICS.md#display-mode--both-tiers-beta10))
|
||||
|
||||
## Engine version
|
||||
|
||||
- The exact version is read for **Unreal Engine 4 and 5** games, from the game's executable file on disk.
|
||||
A studio can remove or rename what it is read from; then the page says the version was not found.
|
||||
**Unreal Engine 3 and older are not recognised.** Other engines show a version only where their files
|
||||
state one. ([Detection](docs/05_DETECTION.md))
|
||||
|
||||
## Sensors
|
||||
|
||||
- GPU temperature, load, power and memory are best supported on **NVIDIA** GPUs. **AMD and Intel GPUs have
|
||||
not been tested** on real hardware yet.
|
||||
- **CPU temperature** needs *Run the agent as administrator* and the separately installed PawnIO driver, and
|
||||
has not been verified on real hardware yet. CPU load is the time the processor was busy — not Task
|
||||
Manager's "utility" figure, which can exceed 100%. ([Telemetry](docs/18_GPU_VENDOR_APIS.md))
|
||||
|
||||
## Running the agent as administrator
|
||||
|
||||
Off by default. When on, **Windows asks every time the agent starts** and names an unknown publisher, because
|
||||
FrameLedger is not signed. It lets FrameLedger open games that run as administrator and read the CPU
|
||||
temperature; it does not bypass anti-cheat, does not open protected processes, and does not make games you
|
||||
start from FrameLedger run as administrator. **The risk:** FrameLedger is installed in your user folder, so a
|
||||
program running under your account could replace its files and would then run as administrator the next time
|
||||
you accept the prompt. Turn it on only if you trust everything that runs under your account.
|
||||
([Architecture, ADR-9](docs/01_ARCHITECTURE.md))
|
||||
|
||||
## Platform and what has been tested
|
||||
|
||||
- **Windows 10 22H2 or Windows 11, 64-bit only.**
|
||||
- The games FrameLedger has actually been run with, and what was measured on each, are listed in
|
||||
[LIST_GAME_TESTED.md](docs/LIST_GAME_TESTED.md). Everything was measured on one machine (an NVIDIA
|
||||
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.
|
||||
|
||||
## Your data
|
||||
|
||||
- Everything stays on your computer (`%LOCALAPPDATA%\FrameLedger`). FrameLedger sends no telemetry; its only
|
||||
network requests are the update check and the update download, both to GitHub, and the check can be switched
|
||||
off. The anti-cheat list and the detection rules ship with each version — **a newer list reaches you only with
|
||||
the next update.** ([Privacy policy](legal/PRIVACY_POLICY.md))
|
||||
- Per-frame data is kept for the **last 20 sessions of each game** (configurable); older sessions keep their
|
||||
summaries.
|
||||
- A newer version upgrades the database in place, and an **older version cannot open it again** — there is
|
||||
no downgrade.
|
||||
|
||||
## Installation
|
||||
|
||||
FrameLedger's programs are **not code-signed**: Windows SmartScreen may warn when you install it, and the
|
||||
administrator prompt names an unknown publisher. Each release publishes SHA-256 checksums you can compare.
|
||||
@@ -5,8 +5,8 @@
|
||||
> No telemetry. No accounts. All data stays on your machine.
|
||||
|
||||
<!-- accuracy-block:begin -->
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-09-23.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.7`** (2026-09-23), an unsigned installer built from that tag with its
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-09-28.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.10`** (2026-09-28), 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
|
||||
@@ -24,7 +24,9 @@
|
||||
> named FSR 3 from the older DLLs, and FSR without a version from the newer ones, which host both
|
||||
> FSR 3.1 and FSR 4. FSR 2, and FSR shipped any other way, is not identified. For DLSS titles that
|
||||
> bypass Streamline, the NVIDIA driver's own per-process record is stored with the session and shown
|
||||
> as *DLSS (driver-reported)*. Intel XeSS is **not** read (its SDK licence
|
||||
> as *DLSS (driver-reported)*. The NVIDIA driver's profile for the game — the DLSS and frame-generation
|
||||
> overrides the NVIDIA App sets — is read, never changed, and shown as the driver's settings beside what
|
||||
> was measured. Intel XeSS is **not** read (its SDK licence
|
||||
> forbids it), and neither is an upscaler compiled into the game: those read `N/A`, or "Unknown
|
||||
> upscaler" when another vendor's hook ran in the game. Vulkan and OpenGL titles read `N/A`.
|
||||
> - **Quality preset:** not reported on any title measured. The one route this software may use — the
|
||||
@@ -45,9 +47,18 @@
|
||||
> FG are named from the calls the game makes; any other generator (XeSS-FG, one compiled into the game)
|
||||
> is shown only as active with the technology not identified, and is never named. Where a technology is
|
||||
> named but its frames could not be counted, or frame generation is not measured, the software shows
|
||||
> **Presented FPS** with a note on what it may include — never a Native figure.
|
||||
> **Presented FPS** with a note on what it may include — never a Native figure. Where generated frames
|
||||
> were counted, the lows, median and stutter are taken over application frames only.
|
||||
> - **Ray tracing:** Yes/No measured on Direct3D 12 from ray-dispatch and acceleration-structure-build
|
||||
> calls; the technique and path tracing are `N/A`, and so is ray tracing on other APIs.
|
||||
> - **Display mode:** how each game's window was shown — exclusive full-screen, borderless, windowed or
|
||||
> minimised — as a share of the session, with the window's size and the monitor's, in every session.
|
||||
> Exclusive full-screen is known only for Direct3D titles FrameLedger injects into, from the game's own
|
||||
> swap chain; for every other session the window alone is read, and a window covering its monitor reads
|
||||
> *full-screen or borderless*. What Windows does behind the game (fullscreen optimizations) is not visible.
|
||||
> - **Engine version:** the exact Unreal Engine 4 or 5 version, read from the game's executable on disk and
|
||||
> labelled with what it rests on; `N/A` where the executable names none. Other engines show what their own
|
||||
> files state.
|
||||
> - **Video memory:** in use on the whole graphics card, recorded from Windows and GPU-driver telemetry
|
||||
> and charted. **Not measured at all:** each game's own video-memory use and budget, which frame
|
||||
> spikes were shader compilation, PC latency (Reflex), and HDR. Stutter count and stutter time are
|
||||
@@ -55,16 +66,20 @@
|
||||
> - **Processor and memory:** how busy the processor was (time busy, all cores together — not the
|
||||
> frequency-scaled figure Task Manager draws) and how much system memory was in use, read from
|
||||
> Windows once a second and charted. Processor temperature is read only when the Agent runs as
|
||||
> administrator with PawnIO installed, and that reading has not yet been checked on real hardware;
|
||||
> everywhere else it is `N/A`.
|
||||
> administrator — an option, off by default, for which Windows asks at every start of the Agent — with
|
||||
> PawnIO installed, and that reading has not yet been checked on real hardware; everywhere else it is `N/A`.
|
||||
> - **Safety:** every pre-injection check runs before injection, including the signed-by-a-known-vendor
|
||||
> half of the suspicious-module rule. During every capture the Agent re-runs the checks every 30 s and
|
||||
> stops capturing on a refusal: a Direct3D or OpenGL game's hooks are removed, and the Vulkan layer
|
||||
> goes passthrough. A global switch in Settings turns all hooking off, and a running capture stops at
|
||||
> its next check; it can only refuse, never permit. **There is no override.** A finding about a game — anti-cheat
|
||||
> named in its process, in its folder or on its title lists — turns hooking off for that game, whether found
|
||||
> before injection, at a session's start or by the 30 s re-check; the game's page says so, and nothing turns it
|
||||
> back on for that executable.
|
||||
> named in its process or in its folder (any kernel driver there counts), or the game on a title list by its
|
||||
> store id or executable name — turns hooking off for that game, whether found by the Agent's own check of every
|
||||
> game in the library, before injection, at a session's start or by the 30 s re-check; the game's page says so,
|
||||
> and nothing turns it back on for that executable — except a user-mode exception you make yourself, per game,
|
||||
> in Settings (off by default): only where the only finding is one anti-cheat that runs entirely in user mode, with
|
||||
> no driver file in the game's folder. Its first two sessions are a trial, and one that does not go well ends it
|
||||
> for good. The guard still runs every check under it and ends it on anything new; a ban remains possible.
|
||||
>
|
||||
> Where a value is not measured it reads `N/A`, with two exceptions: FPS then shows Presented FPS with a
|
||||
> note on what it may include, and ray-tracing flags may show a value you set yourself, labelled as
|
||||
@@ -100,7 +115,7 @@ FrameLedger is built to keep that risk small and to be honest about it:
|
||||
| Safeguard | |
|
||||
|---|---|
|
||||
| **Off by default** | Injection is disabled for every game until you enable it individually, after a consent prompt |
|
||||
| **Hard refusal** | Known anti-cheat/anti-tamper components are detected before injection and every 30 s during a session. Detected ⇒ FrameLedger refuses, or stops capturing at the next scan — so up to 30 s can pass before it reacts to anti-cheat that loads mid-session. For Direct3D/OpenGL that means hooks are removed; for Vulkan it means the layer goes passthrough, because a layer cannot leave the loader chain of a running game. **There is no override — not in settings, not in a config file, not on the command line**<br><br>✅ **Both halves run since 2026-09-10.** The *pre-injection* refusal runs every documented check, and during every capture the Agent re-runs them every 30 s: the component inside the game removes its hooks within one frame of being told to, and within 65 s if it stops hearing from the scanner. *(Until 2026-09-15 this cell said the in-session re-scan did not run at all, which stopped being true when the Agent's capture loop landed.)* For a Vulkan title the stop is the layer's own: it checks the scanner's counter on every present and goes passthrough within one present of the stop flag, or after 65 s without a scan — a title that has stopped presenting is not stopped by that deadline, and presents nothing to be observed either. |
|
||||
| **Hard refusal** | Known anti-cheat/anti-tamper components are detected before injection and every 30 s during a session. Detected ⇒ FrameLedger refuses, or stops capturing at the next scan — so up to 30 s can pass before it reacts to anti-cheat that loads mid-session. For Direct3D/OpenGL that means hooks are removed; for Vulkan it means the layer goes passthrough, because a layer cannot leave the loader chain of a running game. **There is no override — not in settings, not in a config file, not on the command line**<br><br>**One narrow exception since beta.9 (owner decision D33):** per game, after its own disclosure and only while a Settings option (off by default) is on, a game whose only finding is one anti-cheat that runs entirely in user mode — no driver file in its folder, on no title list — and that FrameLedger has measured successfully at least twice may be hooked under a user-mode exception. The guard still runs every check under it, refuses anything else it finds, and ends it on anything new; a ban remains possible (`legal/DISCLAIMER.md` §2A).<br><br>✅ **Both halves run since 2026-09-10.** The *pre-injection* refusal runs every documented check, and during every capture the Agent re-runs them every 30 s: the component inside the game removes its hooks within one frame of being told to, and within 65 s if it stops hearing from the scanner. *(Until 2026-09-15 this cell said the in-session re-scan did not run at all, which stopped being true when the Agent's capture loop landed.)* For a Vulkan title the stop is the layer's own: it checks the scanner's counter on every present and goes passthrough within one present of the stop flag, or after 65 s without a scan — a title that has stopped presenting is not stopped by that deadline, and presents nothing to be observed either. |
|
||||
| **No evasion, ever** | FrameLedger does not hide, rename, obfuscate, or disguise itself. It keeps its real name, real exports, and version info. It is meant to be plainly visible to any security software that looks. This is an architectural rule, not a setting |
|
||||
| **Read-only** | It never reads or writes game memory, never modifies game behavior, never touches saves or input, and never changes GPU clocks, fans, or power limits |
|
||||
| **Always a way out** | FrameLedger refuses rather than pushes through. When the guard finds anti-cheat, or the hook fails, or you have not enabled a game, it **stops** — and records the session anyway: start, end, duration, whatever hardware sensors your machine provides, and the reason there is nothing else. Every measured value reads `N/A`; it never estimates one.<br><br>**The way out is that it does not inject, not that it measures another way.** An earlier version of this row promised a no-injection measurement mode. It was designed around Intel PresentMon, that was dropped on 2026-08-27 after measurement, and no replacement was chosen — so **frame times require hooking**. Said in this row rather than a footnote because the row is in the SAFETY table, and a reader deciding whether to enable a game needs the real alternative, not a comfortable one |
|
||||
@@ -123,11 +138,11 @@ The tier is recorded on every session and shown in the UI. Metrics unavailable a
|
||||
| Component | Runs as | Role |
|
||||
|---|---|---|
|
||||
| `FrameLedger.exe` | Standard user | Fluent desktop UI (WPF + [WPF UI](https://github.com/lepoco/wpfui)), charts, library, settings |
|
||||
| `FrameLedger.Agent.exe` | Standard user (elevation optional) | Injection control, safety guard, data collection, GPU telemetry, storage |
|
||||
| `FrameLedger.Agent.exe` | Standard user — as administrator only when you turn that on in Settings, and Windows asks at every start (beta.10) | Injection control, safety guard, data collection, GPU telemetry, storage |
|
||||
| `FrameLedger.Overlay.dll` | Inside the game | C++20 hooks + lock-free shared-memory writer. Records only; never analyzes, allocates, or blocks |
|
||||
| `FrameLedger.VkLayer.dll` | Inside the game | Vulkan implicit layer (Vulkan titles use this instead of injection) |
|
||||
|
||||
Elevation is **optional — for everything.** Hooked capture is the normal path and runs as a standard user, and there is no longer any tier that needs more than that. Elevation unlocks exactly two extras: CPU temperature sensors (not read yet — see the block above), and attaching to games that themselves run elevated. ~~and the Tier-2 ETW fallback. If you expect to rely on Tier 2, run the Agent elevated.~~ — there is no ETW fallback to rely on.
|
||||
Elevation is **optional — for everything.** Hooked capture is the normal path and runs as a standard user, and there is no longer any tier that needs more than that. Elevation unlocks exactly two extras: CPU temperature sensors (~~not read yet~~ read with PawnIO, not yet checked on real hardware — see the block above), and attaching to games that themselves run elevated. ~~and the Tier-2 ETW fallback. If you expect to rely on Tier 2, run the Agent elevated.~~ — there is no ETW fallback to rely on. **Since beta.10 it is a choice in Settings** — *Run the agent as administrator*, off by default: Windows asks every time the agent starts, games you start from FrameLedger still run as you, and `LIMITATIONS.md` says what it does not change.
|
||||
|
||||
## Requirements
|
||||
|
||||
@@ -137,7 +152,7 @@ Elevation is **optional — for everything.** Hooked capture is the normal path
|
||||
|
||||
## Install
|
||||
|
||||
> **The latest pre-release is `v0.1.0-beta.7` (2026-09-23); before it `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.10` (2026-09-28); before it `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**.
|
||||
@@ -165,4 +180,4 @@ If you find a game with anti-cheat that FrameLedger fails to detect, please open
|
||||
|
||||
---
|
||||
|
||||
**Status:** pre-release (beta). Seven 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). Ten 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.
|
||||
+23
@@ -31,6 +31,29 @@ now turns the game's hooking off. What IS a security report: any way to reach an
|
||||
setting, a crafted rules file, a pipe message, a database edit the Agent honours — or a finding about a game that
|
||||
does not turn its hooking off.
|
||||
|
||||
Since 0.1.0-beta.9 one narrow exception exists (owner decision D33, `docs/19_SAFETY_AND_ANTICHEAT.md` §The user-mode
|
||||
exception): per game, only for one anti-cheat family that is user-mode throughout, with the guard still running every
|
||||
check. The grant is a record in your own database, like the consent stamp; what keeps it narrow is the guard, which
|
||||
decides itself which family it may let through. So these are security reports too: the guard letting through a family
|
||||
that has a driver, a service or a `.sys` in the floor or the rules; an exception applying to a game with a kernel
|
||||
driver in its folder, on a title list, or with a second anti-cheat; the Agent writing a grant on a pipe message
|
||||
without its own tolerant pre-scan; an exception that survives a new finding, a crash or safety stop under it, or a
|
||||
changed executable; since 0.1.0-beta.11 (D38), an exception that survives a session during its two-session trial that
|
||||
did not go well, and any grant written for a game whose earlier exception failed its trial; and the Overlay tolerating
|
||||
a family the guard did not.
|
||||
|
||||
## Running the agent as administrator
|
||||
|
||||
Since 0.1.0-beta.10 the capture agent can run as administrator — an option, off by default (owner decision D34,
|
||||
`docs/01_ARCHITECTURE.md` ADR-9) — and Windows asks at every start of the agent. The residual risk is stated to the user
|
||||
rather than solved: FrameLedger installs per user and unsigned, so a program running under the same account could replace
|
||||
its files and be run as administrator when the user next accepts the prompt. What IS a security report: any way the
|
||||
agent becomes administrator WITHOUT that prompt (a task, a service, an inherited token the option did not choose); a game
|
||||
or any other program that an elevated agent starts with its own token instead of the desktop shell's; any privilege the
|
||||
agent enables (none is — `tools/chokepoint-check.ps1` forbids the enablers under `src/`); an elevated agent that runs for
|
||||
another account than the one that asked; and a named object an elevated agent creates that the same user's unelevated
|
||||
processes can no longer open, or that another user can.
|
||||
|
||||
## A safety gap — a game with anti-cheat that FrameLedger fails to detect
|
||||
|
||||
This is treated with the same priority as a security report, and it takes the **public** route: open
|
||||
|
||||
@@ -142,3 +142,17 @@ covers\*.jpg
|
||||
- **ADR-7 (2026-07, core change):** **Capture moves to in-process graphics-API hooking**, C++20 DLL + MinHook, with a Vulkan implicit layer for Vulkan. Rationale: passive detection of DLSS/upscaling/frame-generation/RT state showed large errors against real games; those states are only knowable at the API boundary. Trade-offs accepted: anti-cheat exposure (mitigated by the hard guard in `19_SAFETY`, offline titles only), crash risk in the host process (mitigated by SEH guards + fault policy + auto-disable), a second toolchain in the build, and per-API maintenance as vendors change SDKs. Scope limited to titles the user explicitly opts in.
|
||||
- **ADR-8:** **No evasion, ever** (`19_SAFETY` §What we will never build). This is an architectural constraint, not a preference — it defines what "correct" means for this codebase.
|
||||
- **ADR-9:** Elevation demoted from required to optional; the Agent runs as a standard user by default.
|
||||
**Chosen, not inherited, since beta.10 (owner decision D34, 2026-09-27):** Settings ▸ Capture agent ▸ *Run the agent as
|
||||
administrator* (`capture.run_elevated`, off by default, a versioned disclosure — `agent-admin-dialog/1` — before it turns
|
||||
on). With it on, **Windows is asked every time the Agent starts** — a UAC prompt owned by the App's window when the App
|
||||
starts it, flashing on the taskbar when the logon task does — and there is no silent path: no "highest privileges" task,
|
||||
no service. The elevated Agent is started for one user (`--serve --for-user <SID>`) and refuses to run as another
|
||||
account (exit 11: a standard user answered with an administrator's password, and that account's `%LOCALAPPDATA%` is not
|
||||
this user's ledger); a declined prompt leaves a standard user's Agent that says so (`--elevation declined`,
|
||||
`HelloAck.ElevationOutcome`). With it off, an App started as administrator starts the Agent with the desktop shell's
|
||||
token. **A game an elevated Agent starts gets the shell's token too** (`Infrastructure.Startup.UnelevatedProcess`) —
|
||||
`LaunchGame` reaches the Agent over a pipe any process of the user may open, so an elevated launch would be a silent
|
||||
elevation — and nothing enables a privilege (`TokenPrivileges` reads them; `tools/chokepoint-check.ps1` forbids the
|
||||
enablers under `src/`). It buys what it always did: attaching to a game that runs as administrator, and the CPU
|
||||
temperature with PawnIO. It does not open a process an anti-cheat driver protects (D21), and a Vulkan game that runs as
|
||||
administrator stays unmeasured — the Khronos loader ignores the HKCU implicit layers for an elevated process.
|
||||
+9
-3
@@ -15,9 +15,10 @@ Requirement IDs (`FR-x`, `NFR-x`) are referenced by other docs, commits, and tes
|
||||
### FR-2 Hooking consent & control (new, safety-critical — see `19_SAFETY`)
|
||||
- FR-2.1 Hooking is **off by default for every game**. Enabling requires a per-game consent dialog stating what is injected, why, and the anti-cheat/ban risk.
|
||||
- FR-2.2 The static anti-cheat pre-scan disables the toggle outright for titles shipping anti-cheat; the reason is shown and the control is not clickable. Since 2026-09-25 (beta.8, owner decision) the Agent runs that pre-scan over every library entry itself — once per rules version and executable, whether or not hooking was ever asked for — and by default the game's page shows only the finding in place of the Hooking card (Settings: *Hide hooking on anti-cheat games*, `ui.hide_anticheat_hooking`); the library card says "Anti-cheat". The reason is always on the page (`19_SAFETY` §What a finding does to the game).
|
||||
- FR-2.3 The runtime guard refuses injection and refuses to continue a session when anti-cheat is detected. **No override exists anywhere in the UI, config, or CLI.**
|
||||
- FR-2.3 The runtime guard refuses injection and refuses to continue a session when anti-cheat is detected. **No override exists anywhere in the UI, config, or CLI.** *(Since 2026-09-26 one narrow, evidence-bound exception exists — FR-2.8. It is not an override: the guard still runs every check and decides itself which anti-cheat family it may let through.)*
|
||||
- FR-2.4 Global "disable all hooking" kill switch in Settings; also honored by the Vulkan layer.
|
||||
- FR-2.7 (owner decision 2026-09-22; it was a per-game override for one day, withdrawn) A finding about a game — anti-cheat named in its process, on its title lists or in its folder — turns hooking off for that game wherever the guard makes it: at the pre-scan, at a session's start, at the 30 s re-scan, or (since 2026-09-25) at the Agent's pre-scan of the library. The row carries the reason, the game's page and the notice say so, and nothing overrides it (`19_SAFETY` §What a finding does to the game).
|
||||
- FR-2.8 (owner decision D33, 2026-09-26) **The user-mode anti-cheat exception.** A Settings option, off by default, lets the user grant a per-game exception to a game whose only anti-cheat findings are ONE family that is user-mode throughout (no driver, service or `.sys` in the floor or the rules), whose install tree holds no `.sys`, which is on no title list, ~~and which FrameLedger has measured hooked at least twice (successful Tier-1 sessions)~~ and no exception of which ever ended during its trial (D38, 2026-10-03: a grant needs no session; its first two hooked sessions are a trial, and an end during the trial — any end below, or a stored hooked session with no frames or an abnormal exit — ends it for good, `games.ac_exception_trial_failed_at`). The Agent computes that eligibility itself; the user grants each game through a versioned disclosure that states the ban risk; hooking is then turned on through FR-2.1's dialog as ever. Machine-wide drivers and services, title lists, kernel drivers in the game folder, the fuzzy tier, a scan that could not finish, an unreadable process, a 32-bit game, the kill switch and Vulkan are never excepted. A new finding, a crash / safety unhook / Overlay stop under it, or a changed executable ends it; the option off suspends it; the block itself is never cleared and stays shown (FR-2.2). Sessions under it are marked with the family (`19_SAFETY` §The user-mode exception).
|
||||
- FR-2.5 Repeated crashes shortly after injection auto-disable hooking for that game, with an explanation and a manual re-enable path.
|
||||
- FR-2.6 Users can always see, per session, which tier produced the data.
|
||||
|
||||
@@ -58,8 +59,9 @@ Requirement IDs (`FR-x`, `NFR-x`) are referenced by other docs, commits, and tes
|
||||
- FR-6.5 Session tags and notes.
|
||||
|
||||
### FR-7 Detection
|
||||
- FR-7.1 Static: engine, engine version, store platform, store id, publisher, game version (`05_DETECTION`).
|
||||
- FR-7.2 Runtime: API, present mode, swap effect, HDR, upscaler, FG, RT — all Tier 1, all measured.
|
||||
- FR-7.1 Static: engine, engine version, store platform, store id, publisher, game version (`05_DETECTION`; the Unreal Engine version since 2026-09-27, §Engine version).
|
||||
- FR-7.2 Runtime: API, present mode, swap effect, HDR, upscaler, FG, RT — all Tier 1, all measured. (Present mode and HDR have no writer yet, `05_DETECTION` §Runtime facts; swap effect is written since beta.10 from the display-mode sample.)
|
||||
- FR-7.4 Display mode (beta.10, owner request 2026-09-27): how each session's game was shown — exclusive fullscreen, borderless, windowed, minimised, or *fullscreen or borderless* where nothing could tell the two apart — as a share of the session's time, with the window, back buffer and monitor sizes; both tiers (Tier 2 from the window alone); shown on the session summary, the game page, the Trend (three share metrics) and Compare, and exported (`03_METRICS` §Display mode).
|
||||
- FR-7.3 Rules ship as `detection-rules.json`, updatable independently of releases; **anticheat-block updates apply regardless of the user's rules auto-update preference.**
|
||||
|
||||
### FR-8 Tri-state flags
|
||||
@@ -73,6 +75,10 @@ Requirement IDs (`FR-x`, `NFR-x`) are referenced by other docs, commits, and tes
|
||||
- FR-9.3 Chart PNG.
|
||||
|
||||
### FR-10 Settings
|
||||
|
||||
> **beta.10 (D34):** "Agent elevation (optional — explains what it unlocks)" is the admin mode — *Run the agent as
|
||||
> administrator*, off by default, a disclosure before it turns on, Windows' prompt at every Agent start (`01_ARCHITECTURE`
|
||||
> ADR-9, `08_UI` §Settings).
|
||||
Language (en/vi/ja), theme, start with Windows, minimize to tray, background capture, **global hooking kill switch**, min session length, telemetry interval, retention, Agent elevation (optional — explains what it unlocks), Vulkan layer registration state, update channel, online metadata opt-in, reopen legal documents.
|
||||
|
||||
### FR-11 Legal Gate
|
||||
|
||||
+66
-1
@@ -681,6 +681,70 @@ Derived extras (Tier 1): `rays_per_pixel` (mean dispatch volume ÷ output pixels
|
||||
> 2026-08-20 `maxTraceRecursionDepth` has no producer: `CreateStateObject` is a separate PR,
|
||||
> and `pt_confidence` reads it, which is one of the reasons Path Tracing is still `N/A`.
|
||||
|
||||
## Display mode — both tiers (beta.10)
|
||||
|
||||
**Owner request, 2026-09-27:** "detect the game's window size and whether it runs full-screen, borderless or windowed,
|
||||
and how much of the time". Schema 0016 (`06_DATA_MODEL`), shared-memory region 4 (`07_IPC`, layout 4), the Agent's
|
||||
`Application.Capture.DisplaySampler`, Domain's `Display.DisplayModeClassifier` and `Display.DisplayTally`.
|
||||
|
||||
**Two witnesses, and neither reads the game.**
|
||||
|
||||
1. *The swap chain's own answer* — Tier 1, DXGI only. The Overlay asks `IDXGISwapChain::GetFullscreenState` and `GetDesc`
|
||||
on the chain the game passed to `Present`, at most twice a second per chain, and publishes the chain with the largest
|
||||
back buffer in region 4: its window, back buffer, swap effect, and whether it is exclusive (`17_HOOK_ENGINE` §Hook
|
||||
inventory — polled, not a `SetFullscreenState` hook). OpenGL publishes its window and client area with no exclusive
|
||||
answer; the Vulkan layer publishes nothing yet.
|
||||
2. *The window from outside* — both tiers. The Agent asks user32 about the game's top-level window: minimised or not, the
|
||||
client area in screen coordinates, the monitor it is on and that monitor's refresh rate — per-monitor DPI aware while it
|
||||
asks, because the Agent runs DPI-unaware and Windows would otherwise scale another process's coordinates
|
||||
(`Infrastructure.Display.WindowGeometryProbe`). The window is the one region 4 names when it still belongs to the game
|
||||
(a handle is reused once its window is gone), else the largest visible, uncloaked, non-tool top-level window of any
|
||||
process running the game's executable — found by image path in the watcher's snapshot for a Tier-2 session that never
|
||||
opened the process. This is the focus sample's class of question: CLAUDE.md rule 4 is about game memory, and no handle
|
||||
to the game's process is opened for it.
|
||||
|
||||
**The ladder, per sample** (`DisplayModeClassifier`):
|
||||
|
||||
| Mode | When | Column (ms) |
|
||||
|---|---|---|
|
||||
| No window | no window could be read and the chain did not say exclusive | `display_nowindow_ms` — outside every share |
|
||||
| Minimized | the window is minimised | `display_minimized_ms` |
|
||||
| Exclusive fullscreen | a region-4 sample under 2 s old in which the swap chain SAID exclusive | `display_exclusive_ms` |
|
||||
| Borderless | the client area covers its monitor (±1 px each edge) and the chain said not exclusive | `display_borderless_ms` |
|
||||
| Fullscreen or borderless | the client area covers its monitor and nothing could say which — OpenGL, Vulkan, every Tier-2 session | `display_covers_ms` |
|
||||
| Windowed | anything else | `display_windowed_ms` |
|
||||
|
||||
**Time, not ticks.** A sample stands for the wall time until the next: every drain tick (100 ms) hooked, every hold tick
|
||||
(1 s) at Tier 2 — so the two add up in one unit, milliseconds. An interval that ends on a paused tick is dropped, which
|
||||
excludes a pause to within one tick at each edge, as the frame series' gap does. A mode's **share** is its milliseconds
|
||||
over the observed time (every mode but *No window*). `display_changes` counts samples whose mode differs from the one
|
||||
before, no-window samples skipped. The sizes — `display_window_*` (client area), `display_buffer_*` (back buffer),
|
||||
`display_monitor_*` and `display_monitor_hz` — are the ones seen in the mode that lasted longest; `display_source` is the
|
||||
strongest witness any sample had (`swapchain` > `opengl` > `window`). `sessions.swap_effect`, a column since 0001 with no
|
||||
writer, is written from region 4.
|
||||
|
||||
**What it cannot say** (the user-facing list is `LIMITATIONS.md`):
|
||||
|
||||
- *Exclusive* is what the game asked DXGI for. Windows may still present such a game through the compositor ("fullscreen
|
||||
optimizations"), and a flip-model borderless window may be promoted to independent flip; neither is visible without a
|
||||
trace session, which FrameLedger does not have (`20_OPEN_QUESTIONS` §G).
|
||||
- A game's menu may call a borderless window "Fullscreen"; the swap chain's answer is what is reported.
|
||||
- A minimised game issues only occlusion probes, which the hook drops before sampling: a region-4 sample older than 2 s
|
||||
keeps its window and loses its exclusive bits.
|
||||
- Tier 2, OpenGL and Vulkan can never tell exclusive from borderless. Their covering time is *Fullscreen or borderless*,
|
||||
and the trend draws no exclusive or borderless point for a session with any of it.
|
||||
- A session recovered from its `.partial` file has no display facts — the tally is not in the crash file — and reads
|
||||
N/A. The focus pair, which the partial carries, is the precedent this does not follow.
|
||||
|
||||
**A side effect of region 4's poll (layout 4).** `GetDesc` every 500 ms also refreshes the chain's output size, which
|
||||
catches a `ResizeBuffers1` the hook inventory does not have: a title that resizes through it now splits its segments at the
|
||||
change and reads "settings changed mid-session" (FR-6.4), which is what it was.
|
||||
|
||||
**Where it is shown** (`08_UI`): the session summary's Display card and line, the game page's last measured session and
|
||||
its Sessions column, three Trend metrics — *Exclusive fullscreen share %*, *Borderless share %*, *Windowed share %*, every
|
||||
tier, and a mode switch is not a mid-session change for them (switching resizes the swap chain; the share is what that
|
||||
switch was) — three Compare rows, never ranked, and the CSV's `# display:` line (§Export schema) and the JSON's aggregates.
|
||||
|
||||
## Per-process VRAM (Tier 1)
|
||||
|
||||
`vramUsedMb` from `IDXGIAdapter3::QueryVideoMemoryInfo(LOCAL)` inside the game = **this game's** usage and budget. **MiB, truncating, and it must use the same divisor as `vramBudgetMb`** — the two are compared, and mismatched rounding would put a systematic bias into `budget_exceeded_pct`. Residual: a flip within 1 MiB of the budget, 0.004% of a 24 GiB card. Stored as its own series and clearly labelled apart from the adapter-wide figure from `18_GPU_VENDOR_APIS`. Aggregates: avg, max, and `budget_exceeded_pct` (share of samples where `CurrentUsage > Budget`, i.e. the driver was likely evicting — a genuinely useful stutter explanation).
|
||||
@@ -700,6 +764,7 @@ Per session over 1 Hz samples: `avg` (mean of non-null), `max`. Sensor timeline
|
||||
| Path tracing | heuristic, confidence-scored, never asserted | not available |
|
||||
| Per-process VRAM | exact | not available |
|
||||
| PC latency | as reported by Reflex | not available |
|
||||
| Display mode (beta.10) | per 100 ms sample: exclusive fullscreen as the swap chain answers it (DXGI; OpenGL and Vulkan cannot say), borderless, windowed, minimised; the window's size from user32 | per 1 s sample, from the window alone: windowed, minimised, or *fullscreen or borderless* — never split |
|
||||
| GPU temp / load / power | vendor API accuracy, ±1 s sampling | same |
|
||||
| CPU temperature | sensor-inherent ±1–2 °C, needs LHM + PawnIO + elevation. **Read since 2026-09-21** (`Telemetry.LhmCpuTemperatureReader`: the package sensor, else the hottest core) and **unmeasured on real hardware** — no elevated run with PawnIO has been taken (`20_OPEN_QUESTIONS` §CPU) | same |
|
||||
| CPU load | **time busy over elapsed, every logical processor** (`GetSystemTimes`, 1 Hz, unprivileged; since 2026-09-21). Not Task Manager's "utility", which is frequency-scaled and exceeds 100 under turbo — the two are different numbers and this one is stated as what it is. Null on a session's first tick (no interval yet), never 0 | same |
|
||||
@@ -732,4 +797,4 @@ Per-column sources, and what a *Tier-2* export does instead:
|
||||
| `vram_mb` | `vram_proc` per-frame blob. Note the value is refreshed at 1 Hz (`17_HOOK_ENGINE` §Memory) so it is a held sample, not a per-frame measurement — the header block says so | `N/A` |
|
||||
| `reflex_latency_us` | `latency_us` blob; **finalize must write it** | `N/A` |
|
||||
|
||||
Plus a `#`-prefixed header block: game, date, **capture tier**, api, present mode, hardware snapshot, segment list, the tri-state flags with their sources, and the note that `vram_mb` is 1 Hz-sampled. The tier belongs in the header because a Tier-2 export is missing whole columns and anyone reading it later must know why.
|
||||
Plus a `#`-prefixed header block: game, date, **capture tier**, api, present mode, swap effect, **the display line** (beta.10: `# display:` with each mode's milliseconds, the changes, the source and the window / back buffer / monitor sizes, or `N/A` for a session recorded before — §Display mode; a mode is the session's, not a frame's, so it is not a column), hardware snapshot, segment list, the tri-state flags with their sources, and the note that `vram_mb` is 1 Hz-sampled. The tier belongs in the header because a Tier-2 export is missing whole columns and anyone reading it later must know why.
|
||||
+24
-2
@@ -38,7 +38,9 @@ public interface IFrameSource : IAsyncDisposable
|
||||
> with `FlGuardBuildId`), `ITargetLivenessSource` (`HeldProcessLivenessSource`, §S29(e)),
|
||||
> `ITargetResolver` (`TargetResolver`, path only — never a pid), `IProcessLauncher`
|
||||
> (`ProcessLauncher`, launch mode), `IRuntimeModuleSnapshot`, `INgxDriverProbe`,
|
||||
> `IExecutableMarkerScan`. `ShmRingReader` itself gains no interface and no second consumer
|
||||
> ~~`IExecutableMarkerScan`~~ — **corrected 2026-09-27:** the marker scan is the recorder's, not the loop's; the loop's
|
||||
> later ports are `IKillSwitch` (FR-2.4), `ICapturePauseSource`, `IUserModeExceptionSwitch` and
|
||||
> `IOverlayToleranceChannel` (D33) and `IDisplayProbe` (beta.10). `ShmRingReader` itself gains no interface and no second consumer
|
||||
> (`NoSecondRingReaderTests`). A **pure move**: the loop's ordering rules, its tests and the
|
||||
> capture host's report are byte-for-byte what they were; the host is now a thin shell that
|
||||
> composes the same objects. What the table below used to call `HookedFrameSource` is this.
|
||||
@@ -175,6 +177,13 @@ which makes the notification more important than it was, not less.
|
||||
|
||||
**Launch mode (preferred).** User starts the game from FrameLedger (or FrameLedger is set as the launch wrapper): `CreateProcess(CREATE_SUSPENDED)` → guard → inject → `ResumeThread`. Catches swapchain creation and upscaler init, which attach mode can miss entirely — a game that creates its DLSS feature during startup will otherwise report `upscaler = unknown` for the whole session.
|
||||
|
||||
> **An elevated Agent starts the game as a standard user (beta.10, the admin mode, D34).** `ProcessLauncher` checks its
|
||||
> own token: elevated, it starts the game with the desktop shell's token (`Infrastructure.Startup.UnelevatedProcess` —
|
||||
> `GetShellWindow`'s process, its token duplicated, `CreateProcessWithTokenW`, the same explicit environment the kill
|
||||
> switch decides), pins it from the start's own handle, and never falls back to its own token: with no shell the launch
|
||||
> fails with `Launch_Error_1400`. `LaunchGame` is a pipe command any process of the user can send; an elevated launch would
|
||||
> be an elevation without a prompt.
|
||||
|
||||
> **Built 2026-09-06 (P1 item 2) as "inject late", which is the only shape §S1 left possible, and the
|
||||
> sentence above is kept as the intent it does not quite describe.** A `CREATE_SUSPENDED` target has
|
||||
> loaded nothing and the module scan *fails* against it (`ERROR_PARTIAL_COPY`, §S1 measured), so the guard
|
||||
@@ -227,6 +236,18 @@ Its result is authoritative: no code path may inject without a passing check, an
|
||||
|
||||
What the Agent checks **before** asking the guard is the thing the native side structurally cannot see: **per-game consent** (CLAUDE.md rule 1). Consent is a record of something a human did, so `HookedCaptureGate` refuses an unconsented or un-enabled game without the guard ever being called.
|
||||
|
||||
> **The user-mode exception (D33, 2026-09-26) — one branch, and it only narrows.** A blocked game is refused
|
||||
> `PreviouslyBlocked` before the guard is asked, as ever, UNLESS `HookRequest.FromConsent` found its exception in
|
||||
> force: `hooking.usermode_ac_exceptions` on, a grant on the row made on the executable on disk, the block naming that
|
||||
> family (`UserModeExceptionRules.CoveredFamily`) — and the session could publish the Overlay's channel
|
||||
> (`IOverlayToleranceChannel`, `07_IPC` §D) BEFORE building the request. Then the gate hands the guard the family's
|
||||
> NAME through the same entry (`GuardedInjectAsync` / `…WhenReadyAsync`), the guard decides whether to honour it and
|
||||
> runs every check, and every 30 s re-scan names it again (`GuardSupervisor(guard, toleratedFamily)`). A blocked row
|
||||
> whose exception does not apply is hooking-off before the process is opened, like any other. A hooked session under
|
||||
> it is marked (`sessions.ac_exception_family`, `; ac-exception=<family>` in the notes), and a finding about the game,
|
||||
> a safety unhook, the Overlay's own stop or a crash while hooked ends the exception (`UserModeExceptionLapsePolicy`,
|
||||
> after the row is stored). `19_SAFETY` §The user-mode exception is the rule; this is where the loop applies it.
|
||||
|
||||
> **Where it lives, corrected 2026-08-06.** This sentence said "lives in SQLite", and was the
|
||||
> only line in the tree that said where consent lives — while no database, no `games` table
|
||||
> and no consent writer existed in any `.cs` file (§S27). The port is
|
||||
@@ -279,6 +300,7 @@ What the Agent checks **before** asking the guard is the thing the native side s
|
||||
> **The PAIR, because zero is not a finding.** A process owning no top-level window at all — `hook-harness` presents to a composition swapchain and has none — is unfocused on every tick of every run. Reporting that as focus loss would fire on every integration run and teach the reader to ignore the line, which is the could-not-look/looked-and-found-nothing collision `FlRtTier` and `upscalerQuality` already exist to avoid.
|
||||
>
|
||||
> **It is attribution, never the guard.** What refuses a mixed window is `FgWindow.BatchRefusal`, computed from the records alone, so a caller that never wires focus still cannot publish an averaged ratio. Focus is what lets the report name the cause.
|
||||
- **Each drain tick also samples the display mode (beta.10)** — `Application.Capture.DisplaySampler` on the same tick as focus: shared-memory region 4 (the presenting chain's window, back buffer, swap effect and exclusive state, as the Overlay last asked them) and the window's geometry from outside (`IDisplayProbe`, `Infrastructure.Display.WindowGeometryProbe`), classified and added up by the time each sample stood for; a paused tick drops the interval it ends. The last sample is closed before the last drain, and the tally rides out on `CaptureOutcome.Display`. **The Tier-2 hold samples too**, once per hold tick (1 s): the window only — by the pinned pid when the loop holds one, else by every process running the executable in the watcher's snapshot (`ITargetResolver.PidsOf`, image path only — never a name), still opening nothing. The recorder writes the tally on the row's skeleton, so both tiers store it (`03_METRICS` §Display mode, `06_DATA_MODEL` 0016).
|
||||
- **Dropped records are computed here, not read from the header.** The Overlay has no reader index and cannot know whether a slot it overwrites was consumed. The Agent owns the read index, so it owns the accounting: when `writeIndex - readIndex > capacity`, add the excess to the session's data-quality counter and resume at `writeIndex - capacity`. A non-zero value means the Agent stalled for over ~16 s — log it, surface it as a session warning, never silently accept it.
|
||||
|
||||
> **That sentence is true only because the read index is seeded from the writer at
|
||||
@@ -299,7 +321,7 @@ What the Agent checks **before** asking the guard is the thing the native side s
|
||||
|
||||
| Thread | Cadence | Owns | Touches |
|
||||
|---|---|---|---|
|
||||
| **Session loop** (`CaptureSession.RunAsync`, one async loop per session) | `Task.Delay(100 ms)` drain ticks; the 30 s guard scan is awaited inline | The ring reader, for the life of the session — drain, `PublishGuardResult`, `SetPaused`, `RequestLogFlush` — and the record buffer it fills | Samples foreground per tick, drains the telemetry queue per tick (PR-D), writes `.partial` itself (PR-D) |
|
||||
| **Session loop** (`CaptureSession.RunAsync`, one async loop per session) | `Task.Delay(100 ms)` drain ticks; the 30 s guard scan is awaited inline | The ring reader, for the life of the session — drain, `PublishGuardResult`, `SetPaused`, `RequestLogFlush` — and the record buffer it fills | Samples foreground and the display mode per tick (beta.10), drains the telemetry queue per tick (PR-D), writes `.partial` itself (PR-D) |
|
||||
| **Telemetry** (`fl-telemetry`, `TelemetryPoller`, one per session) | 1 Hz, never faster than 500 ms | Its own `ConcurrentQueue` of `TelemetrySample` | Reads the composite source only; L2 has a thread of its own inside the library, and the composite is read from this thread and no other |
|
||||
| **Watcher** (built 2026-09-10, PR-F: `CaptureOrchestrator.RunAsync` on a `PeriodicTimer(1 s)`) | 1 Hz process snapshot | The watcher's events and the running-session table — ~~`PollOnceAsync` is their only writer; there is no `Channel`, because there is no second consumer~~ **since 2026-09-13 (P3 PR-1b) the table has one lock**: `PollOnceAsync` on the timer, `LaunchAsync` and `StopSession` from the pipe's tasks (HANDOFF §P3 D12 as built — two commands do not justify a channel); the sessions themselves never take it | The `games` rows (one read per poll) and never the ring; each session it starts runs on its own task |
|
||||
| **Finalize** (PR-D) | Once, on the session loop's task | The one SQLite connection, behind a `SemaphoreSlim(1)` | `ApplicationStopping` cancels the loop; finalize gets a grace window, then the `.partial` stays for recovery |
|
||||
|
||||
+54
-3
@@ -26,11 +26,16 @@ Derived in the Agent from the record stream; the mapping is in `03_METRICS`. Sum
|
||||
| Reflex on + PC latency | NVAPI Reflex hooks |
|
||||
| Per-process VRAM | `QueryVideoMemoryInfo` |
|
||||
| PSO compilation events | pipeline-creation hooks |
|
||||
| Display mode — exclusive fullscreen / borderless / windowed / minimised, with the window, back buffer and monitor (beta.10) | `GetFullscreenState` + `GetDesc` polled on the presenting chain (≤ 2 Hz, shared-memory region 4), and the window's geometry read by the Agent **out of process** — so this row is **both tiers**: a Tier-2 session has the window alone, and never splits exclusive from borderless (`03_METRICS` §Display mode) |
|
||||
|
||||
> **Not built, 2026-09-15:** four rows above have no writer yet — HDR output, Reflex and PC latency, per-process
|
||||
> VRAM, and PSO compilation events. The Overlay never sets their measured bits, so every calculator over them
|
||||
> returns nothing and the columns stay null; `legal/ACCURACY.md` lists them as not measured. This table is the
|
||||
> design; the block is the state.
|
||||
>
|
||||
> **2026-09-27 (beta.10):** the first row's *swap effect* has a writer since schema 0016 — region 4's `GetDesc`, stored
|
||||
> in `sessions.swap_effect` as a name (`flip_discard`, …) — and the display-mode row is new. **Present mode has none**,
|
||||
> and the block above did not list it: `sessions.present_mode` is null on every row, and the pages say N/A.
|
||||
|
||||
> **"present-count delta" is removed from the FG row, and it was not merely unreliable —
|
||||
> it was structurally zero.** `03_METRICS` §Frame Generation retired that rung on
|
||||
@@ -42,7 +47,7 @@ Derived in the Agent from the record stream; the mapping is in `03_METRICS`. Sum
|
||||
> stale-by-not-being-touched failure this project keeps recording; `06_DATA_MODEL`'s
|
||||
> `fg_source` enum carried the same value and is corrected in the same pass.
|
||||
|
||||
~~Tier-2 sessions have `upscaler = unknown`, resolutions `N/A`, RT `N/A`, and an FG mode only if cadence resolves it.~~ **Simpler since 2026-08-28: a Tier-2 session detects NOTHING.** It has no frames, so cadence has nothing to run over. `upscaler`, resolutions, RT and FG all read `N/A`, and the static-hint tier (below) is the only thing that says anything about such a title — which it labels *inference*, never measurement.
|
||||
~~Tier-2 sessions have `upscaler = unknown`, resolutions `N/A`, RT `N/A`, and an FG mode only if cadence resolves it.~~ **Simpler since 2026-08-28: a Tier-2 session detects NOTHING.** It has no frames, so cadence has nothing to run over. `upscaler`, resolutions, RT and FG all read `N/A`, and the static-hint tier (below) is the only thing that says anything about such a title — which it labels *inference*, never measurement. **The one exception since beta.10 is how its window was shown** (the display-mode row), which the Agent reads from outside the game in either tier.
|
||||
|
||||
## Static hints — rules engine
|
||||
|
||||
@@ -61,7 +66,7 @@ Rules are **data, not code**: `rules/detection-rules.json`, bundled and updatabl
|
||||
|
||||
The `anticheat` block is the same file that feeds the hard guard in `19_SAFETY` — shipping it as updatable data is what lets a newly-protected game be blocked without waiting for an app release. **Rules updates that touch the `anticheat` block are treated as security updates:** applied on next check regardless of the user's auto-update preference for other rules.
|
||||
|
||||
Signal types evaluated by `RuleEvaluator` (Domain): `file_exists`, `dir_exists`, `sibling_glob`, **`path_contains`**, `pe_company_contains`, `pe_product_contains`, `strings_contains` (bounded 8 MB scan), `manifest_field`. Combine with `all` / `any` — **not nested**, which schemaVersion 2 forbids. Version extractors: `pe_file_version` (of the sibling its `from` names, not of the executable), `pe_product_version_regex`, **`strings_regex`**, `manifest_field`.
|
||||
Signal types evaluated by `RuleEvaluator` (Domain): `file_exists`, `dir_exists`, `sibling_glob`, **`path_contains`**, `pe_company_contains`, `pe_product_contains`, `strings_contains` (bounded 8 MB scan), `manifest_field`. Combine with `all` / `any` — **not nested**, which schemaVersion 2 forbids. Version extractors: `pe_file_version` (of the sibling its `from` names, not of the executable), `pe_product_version_regex`, **`strings_regex`**, `manifest_field`, and since 2026-09-27 **`unreal_build`** (no parameter; decided in code, §Engine version). A regex extractor must capture exactly **one** group — the evaluator returns the first — and `rules-validate.ps1` refuses any other count and any pattern that does not compile (both promised by the rules file's `$comment` and enforced by nothing until beta.10).
|
||||
|
||||
> `path_contains` and `strings_regex` were in the shipped data and the schema
|
||||
> and missing from this list; the schema's own `$comment` said so and nobody had
|
||||
@@ -132,7 +137,7 @@ Recorded as a residual risk, not as a solved problem.
|
||||
| Engine | Signals | Version |
|
||||
|---|---|---|
|
||||
| Unity | `UnityPlayer.dll` sibling **or** `<Exe>_Data/` dir | FileVersion of `UnityPlayer.dll` |
|
||||
| Unreal 4/5 | exe matches `*-Win64-Shipping.exe` **or** `*/Content/Paks/*.pak` | ProductVersion regex `\+\+UE(4\|5)\+Release-(\d+\.\d+)` |
|
||||
| Unreal 4/5 | exe matches `*-Win64-Shipping.exe` **or** `*/Content/Paks/*.pak` | `unreal_build` (since 2026-09-27, §Engine version): the shipping executable's numeric file version and the engine's branch name inside it. ~~ProductVersion regex `\+\+UE(4\|5)\+Release-(\d+\.\d+)`~~ — two capture groups, of which the evaluator returns the first, so every Unreal version it ever stored was a bare `4` or `5` |
|
||||
| Godot | `.pck` sibling **or** `strings_contains("Godot Engine v")` | strings regex `Godot Engine v(\d+\.\d+[\.\d]*)` |
|
||||
| GameMaker | `data.win` | `N/A` |
|
||||
| RPG Maker MV/MZ | `nw.dll` **and** `package.json` siblings (since 2026-09-16) | `N/A` — the `.js` header needs a `from` that `strings_regex` lacks |
|
||||
@@ -188,6 +193,52 @@ Order matters (first match wins). Engine is user-overridable.
|
||||
|
||||
Everything else in the table is in the data and has a fixture; `rules-validate.ps1` fails if a rule id has no fixture directory, or a fixture no rule.
|
||||
|
||||
### Engine version — Unreal Engine (beta.10, 2026-09-27, schema 0015)
|
||||
|
||||
The owner asked for "the exact Unreal Engine version (3.0, 4.5, 5.1 …) on the game's page". What was shipped could not
|
||||
give one: the rule read only the executable's `ProductVersion` string, which most shipping executables leave empty, and
|
||||
its regex had two capture groups, so the one answer it could give was `4` or `5`. **Measured before anything was written,
|
||||
read-only, on the owner's ten Unreal titles** (`spike-notes` §Unreal Engine versions):
|
||||
|
||||
| Title | Numeric file version | Version strings / company | Branch name in the bytes | Read as |
|
||||
|---|---|---|---|---|
|
||||
| Black Myth: Wukong | 5.0.0.0 | none | `++UE5+Release-5.0` (290 MB into `.code`; `.rdata` 8 KB) | 5.0.0 |
|
||||
| Cronos: The New Dawn (demo) | 1.2.0.0 | the studio's | none | — |
|
||||
| Clair Obscur: Expedition 33 | 5.4.4.0 | none | none | 5.4.4 (file version) |
|
||||
| Hell Is Us | 5.5.4.0 | `UE5-CL-0` / Nacon | none (the studio's own branch) | 5.5.4 (file version) |
|
||||
| Lies of P | 4.27.2.0 | none | none | 4.27.2 (file version) |
|
||||
| Martha Is Dead | 4.27.0.0 | none | `++UE4+Release-4.27` (`.rdata`) | 4.27.0 |
|
||||
| Rune Factory: Guardians of Azuma | 1.0.3.0 | none | none | — |
|
||||
| SILENT HILL 2 | 1.0.0.5 | the studio's | `++UE5+Release-5.1` (`.rdata`) | 5.1 |
|
||||
| UMIGARI | 5.5.4.0 | `++UE5+Release-5.5-CL-40574608` / Epic Games, Inc. | (in the strings) | 5.5.4 |
|
||||
| AbyssMemory | 4.26.1.0 | none | `++UE4+Release-4.26` (`.rdata`) | 4.26.1 |
|
||||
|
||||
**Two witnesses, each wrong in its own way.** The numeric file version (`VS_FIXEDFILEINFO`) is the engine's
|
||||
MAJOR.MINOR.PATCH unless the studio replaced it (Cronos, SILENT HILL 2, Rune Factory); the branch name the engine compiles
|
||||
in (a UTF-16 string) names the release line and no patch, and is missing wherever a studio renamed its branch or the
|
||||
executable is packed. `Domain.Detection.UnrealVersion.Decide` takes them in order: **(1)** both, agreeing on MAJOR.MINOR →
|
||||
the file's MAJOR.MINOR.PATCH (`unreal_branch_file`); **(2)** a branch name alone → MAJOR.MINOR (`unreal_branch`); **(3)**
|
||||
no branch name, and a file version that reads as an engine's (4.0–4.27, 5.0–5.9, patch ≤ 20) where nothing says the studio
|
||||
replaced it — no version strings, a string naming the same `UE4`/`UE5`, or Epic's company name → MAJOR.MINOR.PATCH
|
||||
(`unreal_file_version`); **(4)** anything else → no version. The third rung is the weakest (a studio could number its own
|
||||
game 4.2 and ship no strings), which is why `games.engine_version_source` keeps the rung and the game page says it.
|
||||
|
||||
**Where it is read.** `StaticGameDetector` makes a second read for the one engine that matched — never the probe for every
|
||||
game in the library: `GameFileProbe.ReadUnrealBuildAsync` picks the row's own executable when it is the shipping build
|
||||
(`*-Win64-Shipping.exe`, `*-WinGDK-Shipping.exe`), else the largest shipping executable the walk listed (a row pointing at
|
||||
the launcher stub at the install root), and `UnrealBuildReader` reads its version resource and — unless the version strings
|
||||
already name the branch — scans its `.rdata` section for the branch name: 15–39 MB in nine of the ten titles. An `.rdata`
|
||||
under 1 MiB (Black Myth's protector merged its constants elsewhere) sends the scan over the whole file, bounded at 1 GiB and
|
||||
stopping at the first chunk that names a release line. Chunks are 4 MB with an overlap, so a name cut by a chunk's edge is
|
||||
read whole and never as the digits that fitted; cancellation is observed between chunks. Measured through the shipped
|
||||
reader on the same ten files: every row above as tabled, 16 ms to 1.1 s each and 7.5 s for Black Myth, on the owner's USB
|
||||
drive — once per executable, because the detection key (rules version + size + mtime) changes only when the file does.
|
||||
|
||||
**What it is not.** UE3 titles are not detected as Unreal at all (the rule's signals are UE4/5's layout) and have no
|
||||
numbered release lines to report. A version the user typed is never overwritten and carries no witness. Rules
|
||||
`2026.09.6` change the key, so every library entry is read again once; schema 0015 removes the bare `4`/`5` the old rule
|
||||
wrote, where detection wrote it.
|
||||
|
||||
### Platform signatures & metadata
|
||||
|
||||
| Platform | Signals | Metadata |
|
||||
|
||||
+83
-2
@@ -2,7 +2,7 @@
|
||||
|
||||
`%LOCALAPPDATA%\FrameLedger\ledger.db`. Pragmas: `journal_mode=WAL`, `synchronous=NORMAL`, `foreign_keys=ON`, `busy_timeout=5000`. `Microsoft.Data.Sqlite` + Dapper; all writes in explicit transactions.
|
||||
|
||||
**Writer ownership:** Agent writes `sessions`, `session_segments`, `frame_blobs`, `sensor_blobs`, `hardware_snapshots`, the hook-state columns on `games`, **and since P4 PR-1 (2026-09-14) the *detected* columns on `games`** — `engine`, `engine_version`, `platform` under the per-field provenance rule (`05_DETECTION` §Caching: a `user` field is never touched), `capability_flags` whole, and the cache key `detection_rules_version` / `detection_exe_size_bytes` / `detection_exe_mtime_ms`, and since schema 0011 (2026-09-25) the executable's own facts `exe_machine` / `exe_file_version` / `exe_product_version` / `library_versions`, written whole like the flags — through `IGameRepository.ApplyDetectionAsync` only. The UI and the Agent were both already writers of `games`; this adds columns to the Agent's half, not a third writer (HANDOFF §P4). **And since P4 PR-4 the UI's library import writes `platform`, `store_id` and `game_version` through `ApplyStoreMetadataAsync`** — the same per-field provenance rule, badged `detected` (a store's record is not the user's typing), on columns the UI already owned. **And since 2026-09-23 the Agent's relocator merges two entries for one executable under two drive letters** (`IGameMerge`, HANDOFF D26, `19_SAFETY` §A moved drive is the same executable): in one transaction it re-parents the dropped entry's `sessions` to the survivor (before the delete — `sessions.game_id` cascades), carries a block or a crash auto-disable still in force to the survivor (`hook_enabled` only ever to 0; `hook_blocked_reason` is copied, never originated or cleared), adds the crash counts, deletes the dropped `games` row, and then moves the survivor to the file's path (after the delete — `exe_path` is UNIQUE). It is the one Agent write that deletes a `games` row; it never touches a consent column. **And since 2026-09-23 the UI writes `record_sessions`** (schema 0009, FR-1.6): the entry's recording switch, which the Agent only reads — off, the watcher does not watch for the program. The script's one data change switches it off for entries an old import made for Steam's own tools (`SteamLibrarySource.KnownTools`, the ids as of the script); a twin merge keeps it off when either twin had it off. **And since 2026-09-25 the Agent's pre-scan of the library (`19_SAFETY` §What a finding does to the game) writes the hook-state columns of every entry, not only of those the user asked to hook** — `hook_prescan_state`, and on a finding `hook_enabled = 0` and `hook_blocked_reason` — and its own key, `hook_prescan_rules_version` / `hook_prescan_exe_size_bytes` / `hook_prescan_exe_mtime_ms` (schema 0010), through `IGameConsentStore.RecordPreScanAsync` only: columns that were already the Agent's, never over a block, never a new row. **Maintenance (P4 PR-7) adds no writer:** the retention sweep on demand is the Agent's, asked over the pipe; the UI's `VACUUM` rewrites pages with the same contents and changes no row (§Retention built note). UI writes `games` (user-editable fields — since P3 PR-3 that is the FR-1.3 metadata, the `*_default` tri-states, and `removed_at`; never a `hook_*` column), `session_annotations` (tags, notes, and since schema 0002 the FR-8.3 overrides — which is WHY they are on this table and not on `sessions`), `settings`, `legal_acceptance`. Both read everything. The ports say the same in their names: `IGameRepository.UpdateMetadataAsync` / `SetTriStateDefaultAsync` / `RemoveAsync`, `ISessionAnnotationRepository`, `RegisteredSettings`, `ILegalAcceptanceStore.RecordAsync` (all P3 PR-3).
|
||||
**Writer ownership:** Agent writes `sessions`, `session_segments`, `frame_blobs`, `sensor_blobs`, `hardware_snapshots`, the hook-state columns on `games`, **and since P4 PR-1 (2026-09-14) the *detected* columns on `games`** — `engine`, `engine_version`, `platform` under the per-field provenance rule (`05_DETECTION` §Caching: a `user` field is never touched), `capability_flags` whole, and the cache key `detection_rules_version` / `detection_exe_size_bytes` / `detection_exe_mtime_ms`, and since schema 0011 (2026-09-25) the executable's own facts `exe_machine` / `exe_file_version` / `exe_product_version` / `library_versions`, written whole like the flags — through `IGameRepository.ApplyDetectionAsync` only. The UI and the Agent were both already writers of `games`; this adds columns to the Agent's half, not a third writer (HANDOFF §P4). **And since P4 PR-4 the UI's library import writes `platform`, `store_id` and `game_version` through `ApplyStoreMetadataAsync`** — the same per-field provenance rule, badged `detected` (a store's record is not the user's typing), on columns the UI already owned. **And since 2026-09-23 the Agent's relocator merges two entries for one executable under two drive letters** (`IGameMerge`, HANDOFF D26, `19_SAFETY` §A moved drive is the same executable): in one transaction it re-parents the dropped entry's `sessions` to the survivor (before the delete — `sessions.game_id` cascades), carries a block or a crash auto-disable still in force to the survivor (`hook_enabled` only ever to 0; `hook_blocked_reason` is copied, never originated or cleared), adds the crash counts, deletes the dropped `games` row, and then moves the survivor to the file's path (after the delete — `exe_path` is UNIQUE). It is the one Agent write that deletes a `games` row; it never touches a consent column. **And since 2026-09-23 the UI writes `record_sessions`** (schema 0009, FR-1.6): the entry's recording switch, which the Agent only reads — off, the watcher does not watch for the program. The script's one data change switches it off for entries an old import made for Steam's own tools (`SteamLibrarySource.KnownTools`, the ids as of the script); a twin merge keeps it off when either twin had it off. **And since 2026-09-25 the Agent's pre-scan of the library (`19_SAFETY` §What a finding does to the game) writes the hook-state columns of every entry, not only of those the user asked to hook** — `hook_prescan_state`, and on a finding `hook_enabled = 0` and `hook_blocked_reason` — and its own key, `hook_prescan_rules_version` / `hook_prescan_exe_size_bytes` / `hook_prescan_exe_mtime_ms` (schema 0010), through `IGameConsentStore.RecordPreScanAsync` only: columns that were already the Agent's, never over a block, never a new row. **And since 2026-09-26 (schema 0014, D33) the Agent writes the user-mode exception's columns** — `ac_exception_*` on `games` through `IGameConsentStore` only (eligibility from the sweep, a grant from the `SetAntiCheatException` command, every end), and `sessions.ac_exception_family` with the session — the grant only after the user accepted its disclosure in the UI, which asks and never writes. **Maintenance (P4 PR-7) adds no writer:** the retention sweep on demand is the Agent's, asked over the pipe; the UI's `VACUUM` rewrites pages with the same contents and changes no row (§Retention built note). UI writes `games` (user-editable fields — since P3 PR-3 that is the FR-1.3 metadata, the `*_default` tri-states, and `removed_at`; never a `hook_*` column), `session_annotations` (tags, notes, and since schema 0002 the FR-8.3 overrides — which is WHY they are on this table and not on `sessions`), `settings`, `legal_acceptance`. Both read everything. The ports say the same in their names: `IGameRepository.UpdateMetadataAsync` / `SetTriStateDefaultAsync` / `RemoveAsync`, `ISessionAnnotationRepository`, `RegisteredSettings`, `ILegalAcceptanceStore.RecordAsync` (all P3 PR-3).
|
||||
|
||||
## Schema (v2 — hook architecture)
|
||||
|
||||
@@ -46,6 +46,9 @@ CREATE TABLE games (
|
||||
platform TEXT NOT NULL DEFAULT 'none', -- steam|gog|epic|itch|none
|
||||
store_id TEXT,
|
||||
engine TEXT, engine_version TEXT,
|
||||
-- (schema 0015, ALTERed last) engine_version_source TEXT: where engine_version came from — a
|
||||
-- Domain.Detection.EngineVersionSource id (unreal_branch_file | unreal_branch | unreal_file_version, or the rule's
|
||||
-- extractor type); NULL for a version the user typed. Written with the version only (05_DETECTION §Engine version)
|
||||
publisher TEXT, game_version TEXT,
|
||||
cover_path TEXT, notes TEXT,
|
||||
removed_at INTEGER, -- schema 0002 (P3 PR-3): FR-1.4 "remove, keep sessions" — the row stays
|
||||
@@ -63,6 +66,24 @@ CREATE TABLE games (
|
||||
hook_prescan_exe_size_bytes INTEGER, -- library last scanned the row under — the rules version and the
|
||||
hook_prescan_exe_mtime_ms INTEGER, -- executable's size and mtime; NULL = never scanned by the sweep.
|
||||
-- Change executable clears them with hook_prescan_state
|
||||
-- schema 0014 (2026-09-26, D33): the user-mode anti-cheat exception, a layer OVER hook_blocked_reason, never its clearing
|
||||
ac_exception_eligible INTEGER NOT NULL DEFAULT 0, -- the Agent's sweep: the exception may be granted now
|
||||
ac_exception_verdict TEXT, -- its tolerant pre-scan, Reason|Family|Signal; NULL = nothing asked
|
||||
ac_exception_sessions INTEGER NOT NULL DEFAULT 0, -- D38: successful sessions under the grant in force (its trial)
|
||||
ac_exception_checked_rules_version TEXT, -- the key the verdict was reached under: rules, executable size and
|
||||
ac_exception_checked_exe_size_bytes INTEGER, -- mtime, and the block text itself
|
||||
ac_exception_checked_exe_mtime_ms INTEGER,
|
||||
ac_exception_checked_block TEXT,
|
||||
ac_exception_at INTEGER, -- the user's grant; NULL = no exception in force
|
||||
ac_exception_family TEXT, -- the family it covers (kept as history once it ends)
|
||||
ac_exception_disclosure_version TEXT, -- AntiCheatExceptionDisclosure.Version the user accepted
|
||||
ac_exception_exe_size_bytes INTEGER, -- the executable the grant was made on; other bytes end it
|
||||
ac_exception_exe_mtime_ms INTEGER,
|
||||
ac_exception_lapsed_at INTEGER, -- when and why the last grant ended (UserModeExceptionLapse:
|
||||
ac_exception_lapsed_reason TEXT, -- Withdrawn|ExecutableChanged|NoLongerEligible|NewFinding|
|
||||
-- SafetyUnhook|OverlayStopped|SessionCrashed|TrialFailed)
|
||||
-- schema 0017 (2026-10-03, D38): an exception of this game ended during its trial — for good; never cleared
|
||||
ac_exception_trial_failed_at INTEGER,
|
||||
hook_autodisabled_reason TEXT, -- set after repeated crashes
|
||||
hook_crash_count INTEGER NOT NULL DEFAULT 0,
|
||||
capability_flags TEXT, -- JSON: what the game SHIPS — never a measurement. Since P4 PR-1 (2026-09-14) a JSON
|
||||
@@ -255,7 +276,23 @@ CREATE TABLE sessions (
|
||||
avg_cpu_temp REAL, max_cpu_temp REAL,
|
||||
avg_gpu_temp REAL, max_gpu_temp REAL, max_gpu_hotspot REAL,
|
||||
avg_gpu_load REAL, avg_cpu_load REAL, avg_ram_mb REAL,
|
||||
avg_gpu_power_w REAL, throttle_pct REAL
|
||||
avg_gpu_power_w REAL, throttle_pct REAL,
|
||||
|
||||
-- schema 0016 (2026-09-27, beta.10): the display mode, both tiers (03_METRICS §Display mode). Milliseconds per mode,
|
||||
-- each sample standing for the time until the next (100 ms hooked, 1 s at Tier 2), a pause not counted; nowindow is
|
||||
-- outside every share. NULL before, on a session recovered from its .partial file, and where the loop never sampled —
|
||||
-- N/A, never 0. Written on the recorder's SKELETON: a Tier-2 session never reaches the aggregator.
|
||||
display_exclusive_ms INTEGER, -- the swap chain SAID exclusive (DXGI only)
|
||||
display_borderless_ms INTEGER, -- covers its monitor, the chain said not exclusive
|
||||
display_windowed_ms INTEGER,
|
||||
display_covers_ms INTEGER, -- covers its monitor and nothing could say which ("fullscreen or borderless")
|
||||
display_minimized_ms INTEGER,
|
||||
display_nowindow_ms INTEGER, -- no window could be read
|
||||
display_changes INTEGER, -- mode changes between samples
|
||||
display_source TEXT, -- swapchain | opengl | window: the strongest witness any sample had
|
||||
display_window_w INTEGER, display_window_h INTEGER, -- client area, in the mode that lasted longest
|
||||
display_buffer_w INTEGER, display_buffer_h INTEGER, -- the swap chain's back buffer, same mode
|
||||
display_monitor_w INTEGER, display_monitor_h INTEGER, display_monitor_hz INTEGER
|
||||
);
|
||||
CREATE INDEX ix_sessions_game_started ON sessions(game_id, started_at DESC);
|
||||
|
||||
@@ -354,8 +391,11 @@ switch's rule); integers are invariant-culture within an inclusive range; choice
|
||||
| `ui.minimize_to_tray` | bool | `0` | | UI (PR-8) |
|
||||
| `ui.hide_anticheat_hooking` | bool | `1` | | UI (beta.8, 2026-09-25): the game page of an entry the guard found anti-cheat in shows the finding in place of its Hooking card (`08_UI` §Game detail) |
|
||||
| `ui.fps_decimals` | bool | `0` | | UI (beta.8, 2026-09-25): every FPS figure with two decimals ("62.40") instead of a whole number |
|
||||
| `ui.library_view` | choice `grid`\|`list` | `grid` | | UI (beta.11, 2026-10-03): the Games library as a grid of cards that fills the width, or as a list; written by the page's own switch, no Settings row (`08_UI` §Games) |
|
||||
| `capture.background` | bool | `1` | | Agent |
|
||||
| `hooking.kill_switch` | bool | `0` | | Agent (FR-2.4, since P2 PR-F) |
|
||||
| `hooking.usermode_ac_exceptions` | bool | `0` | | Agent, at every session start and command (FR-2.8, D33, 2026-09-26): off suspends every user-mode exception without deleting any; on, the user still grants each eligible game |
|
||||
| `capture.run_elevated` | bool | `0` | | The App when it starts the Agent, and an Agent the logon task started — both BEFORE the Agent exists, through `Infrastructure.Startup.RunElevatedSetting` (one row, `PRAGMA query_only`, no version gate, anything but `1` is off) (D34, beta.10): on, Windows is asked for administrator rights at every Agent start (`01_ARCHITECTURE` ADR-9) |
|
||||
| `capture.min_session_s` | int | `30` | 5–600 | Agent, per session (FR-3.6) |
|
||||
| `telemetry.interval_ms` | int | `1000` | 500–2000 | Agent, per session (FR-3.5) |
|
||||
| `retention.raw_sessions_per_game` | int | `20` | 0–10000; **0 = unlimited** | Agent, per session (§Retention) |
|
||||
@@ -511,6 +551,47 @@ Sequential embedded SQL (`Migrations/0001_init.sql`, `0002_*.sql`, …), applied
|
||||
> `FgPreset`, `FgMode` beside its masks (additive JSON fields; older rows lack them). `LatestVersion` is 12;
|
||||
> `LedgerDatabaseTests.ScriptTwelveAddsTheDriverProfileColumn`.
|
||||
|
||||
> **`0014_usermode_ac_exception.sql` (beta.9, 2026-09-26, owner decision D33) — the user-mode anti-cheat exception.**
|
||||
> Fourteen `games.ac_exception_*` columns in three groups — the Agent's eligibility answer about a blocked row and its
|
||||
> key, the user's grant, and how the last grant ended — and `sessions.ac_exception_family`, the family a HOOKED session
|
||||
> ran under the exception with. `ADD COLUMN` only; no row changes, so a blocked row stays blocked, not eligible, with
|
||||
> no grant, until the Agent and the user say otherwise (`19_SAFETY` §The user-mode exception). Written through
|
||||
> `IGameConsentStore` only — `RecordExceptionEligibilityAsync` (the sweep), `GrantAntiCheatExceptionAsync` (the
|
||||
> `SetAntiCheatException` command; the store applies `UserModeExceptionRules.IsEligible` itself), `RevokeAntiCheatExceptionAsync`
|
||||
> (every end) — plus one downgrade in `ChangeExecutableAsync`, which ends a grant (`ExecutableChanged`) and forgets
|
||||
> the eligibility. The grant and the eligibility are each bound in SQL to the block they were reached about. `LatestVersion`
|
||||
> is 14; `LedgerDatabaseTests.ScriptFourteenAddsTheExceptionColumnsAndChangesNoRow`.
|
||||
|
||||
> **`0015_engine_version_source.sql` (beta.10, 2026-09-27) — where an engine version came from.** `games.engine_version_source`
|
||||
> (`05_DETECTION` §Engine version): the witness an Unreal version rests on, or the rule's extractor type for every other
|
||||
> engine; written by `ApplyDetectionAsync` only where the run's version was taken (a `user` field keeps none), cleared by a
|
||||
> user's edit of the version (`UpdateMetadataAsync`). The script's one data change removes the bare `4` / `5` the old
|
||||
> Unreal rule wrote (a two-group regex returning its first group) — **only where `field_provenance` says `detected`**: a
|
||||
> value the user typed, one with no badge (which reads as the user's) and one whose provenance does not parse stay as they
|
||||
> were, and the last does not fail the migration (`CASE WHEN json_valid(…)`, since SQLite promises no order for `AND`).
|
||||
> `LatestVersion` is 15; `LedgerDatabaseTests.ScriptFifteenAddsTheWitnessAndRemovesOnlyTheOldRulesDetectedDigit`.
|
||||
|
||||
> **`0016_display_mode.sql` (beta.10, 2026-09-27) — how the game was shown.** Fifteen `sessions.display_*` columns
|
||||
> (`03_METRICS` §Display mode): milliseconds in each mode, the changes, the witness, and the window / back buffer / monitor
|
||||
> sizes in the mode that lasted longest. ADD COLUMN only, no data change: a session recorded before reads N/A. Written by
|
||||
> the recorder on the row's skeleton (`Recording.SessionDisplayColumns.WithDisplay`), so a Tier-2 session — which never
|
||||
> reaches the aggregator — has them too; `sessions.swap_effect`, a column since 0001, gets its first writer from the same
|
||||
> facts. `SessionRowColumns` is hand-edited (its generator is not in the repository) and reads by name. `LatestVersion` is
|
||||
> 16; `LedgerDatabaseTests.ScriptSixteenAddsTheDisplayColumnsAndAnEarlierSessionHasNone`,
|
||||
> `SqliteSessionRepositoryTests.ASessionRoundTripsColumnForColumn`.
|
||||
|
||||
> **`0017_exception_trial.sql` (beta.11, 2026-10-03, owner decision D38) — the exception's trial.** One column,
|
||||
> `games.ac_exception_trial_failed_at`: when an exception of the game ended during its trial (`19_SAFETY` §The user-mode
|
||||
> exception), NULL when none did. ADD COLUMN only, no data change: a grant made under D33 stays in force and carries no
|
||||
> mark. Written by the Agent's revoke only (`IGameConsentStore.RevokeAntiCheatExceptionAsync(…, trialFailed)`), set once
|
||||
> (`COALESCE`), cleared by nothing — not by `ChangeExecutableAsync`, which does not name it — and carried by a twin merge
|
||||
> (the earlier of two). The store applies it in SQL: no eligibility is written as eligible and no grant is written over
|
||||
> it. `ac_exception_sessions` (0014) changes meaning without a script: since D38 it is the trial's progress under the grant
|
||||
> in force, which the sweep rewrites on its first pass. `LatestVersion` is 17;
|
||||
> `LedgerDatabaseTests.ScriptSeventeenAddsTheTrialMarkAndChangesNoRow`,
|
||||
> `SqliteGameConsentStoreTests.AnEndDuringTheTrialMarksTheGameAndNothingClearsIt`,
|
||||
> `SqliteGameMergeTests.AFailedExceptionTrialOnEitherTwinMarksTheSurvivor`.
|
||||
|
||||
> **Every open used to migrate, and one that should not have did — 2026-09-16.** The Agent's `--console sessions`,
|
||||
> a verb that prints, was run against the owner's ledger while the file on disk was at schema 2 and applied 0003 and
|
||||
> 0004 to it. `LedgerDatabase.OpenReadOnlyAsync` exists since that day: an existing file, `PRAGMA query_only`, no
|
||||
|
||||
+83
-6
@@ -12,13 +12,15 @@ Three channels, each chosen for its constraints:
|
||||
|
||||
Created by the Overlay on init, opened by the Agent. Name is deliberately plain and identifiable (`19_SAFETY` — no obfuscated object names).
|
||||
|
||||
Layout — **four regions, each exactly one 64-byte cache line before the ring**:
|
||||
Layout — **~~four~~ five regions, each exactly one 64-byte cache line before the ring** (layout 4 since
|
||||
2026-09-27, beta.10: region 4 is new and the ring moved from `0xC0` to `0x100`):
|
||||
|
||||
```
|
||||
[0x0000] FlShmHandshake 64 B write-once by the Overlay at init
|
||||
[0x0040] FlWriterState 64 B Overlay-written (writeIndex touched every present)
|
||||
[0x0080] FlControlBlock 64 B Agent-written
|
||||
[0x00C0] FlFrameRecord[capacity] (64 B each, power-of-two capacity)
|
||||
[0x00C0] FlDisplayState 64 B Overlay-written, at most every 500 ms per chain (layout 4)
|
||||
[0x0100] FlFrameRecord[capacity] (64 B each, power-of-two capacity)
|
||||
```
|
||||
|
||||
The header is split in two on purpose. The immutable handshake and the
|
||||
@@ -49,9 +51,19 @@ struct alignas(64) FlWriterState { // Overlay-written
|
||||
uint32_t rtStateObjectsCreated; // @32 session count, published at 1 Hz
|
||||
uint32_t rasterPsoCreated; // @36 session count, published at 1 Hz
|
||||
uint32_t runtimeCensus; // @40 FlRuntimeCensus bits; watchdog-published, OR-only (2026-09-03, took reserved[0])
|
||||
uint32_t reserved[5]; // @44..63 must be zero; reserved for additive fields
|
||||
uint32_t slTagCensus; // @44 FlSlTagType bits per route (2026-09-05)
|
||||
uint32_t dxgiPresentsUnseen; // @48 presents DXGI counted beyond the hooked ones (2026-09-05, saturating)
|
||||
uint32_t dxgiPresentSamples; // @52 hooked presents on which that counter was read
|
||||
uint16_t loaderSignals; // @56 the LoadLibrary detour's installed bit + wake count (2026-09-06)
|
||||
uint16_t earlyStopFamily; // @58 1-based floor family index of an early stop; 0 = none (2026-09-06)
|
||||
uint32_t dxgiPresentsBeforeHook; // @60 presents before the first hooked one (2026-09-06) -- the LAST word:
|
||||
// no slack left, so layout 4 added a region rather than a field
|
||||
};
|
||||
|
||||
> **This block showed `reserved[5]` at @44 until 2026-09-27** — five words the header had spent by 2026-09-06
|
||||
> (`slTagCensus`, the two DXGI counters, the loader words, `dxgiPresentsBeforeHook`). `fl_shm.h` is normative and the
|
||||
> mirror test reads the header, so nothing broke; a reader of this page was told there was room where there was none.
|
||||
|
||||
struct alignas(64) FlControlBlock { // Agent-written
|
||||
uint32_t pauseRequested; // @0
|
||||
uint32_t unhookRequested; // @4 19_SAFETY: set when the guard fires mid-session
|
||||
@@ -61,12 +73,41 @@ struct alignas(64) FlControlBlock { // Agent-written
|
||||
uint32_t reserved[11]; // @20..63 must be zero
|
||||
};
|
||||
|
||||
struct alignas(64) FlDisplayState { // Overlay-written (layout 4, 2026-09-27, beta.10)
|
||||
uint32_t seq; // @0 seqlock: odd while a writer is inside; the writer CASes and SKIPS if taken
|
||||
uint32_t flags; // @4 FlDisplayFlags: SAMPLED | EXCLUSIVE_KNOWN | EXCLUSIVE | OPENGL
|
||||
uint64_t hwnd; // @8 OutputWindow (DXGI) or WindowFromDC (OpenGL); 0 = a composition chain
|
||||
uint32_t bufferWidth; // @16 the back buffer (DXGI) / client area (OpenGL)
|
||||
uint32_t bufferHeight; // @20
|
||||
uint32_t swapEffect; // @24 DXGI_SWAP_EFFECT + 1 (DISCARD is 0); 0 = not read
|
||||
uint32_t swapFlags; // @28 DXGI_SWAP_CHAIN_DESC.Flags
|
||||
uint32_t chainId; // @32 the FlFrameRecord.swapchainId described
|
||||
uint32_t samples; // @36 samples published (wraps)
|
||||
uint64_t sampleQpc; // @40 QPC of the last sample
|
||||
uint32_t reserved[4]; // @48..63 must be zero
|
||||
};
|
||||
|
||||
static_assert(sizeof(FlShmHandshake) == 64);
|
||||
static_assert(sizeof(FlWriterState) == 64);
|
||||
static_assert(sizeof(FlControlBlock) == 64);
|
||||
static_assert(FL_SHM_RING_OFFSET == 0xC0 && FL_SHM_RING_OFFSET % 64 == 0);
|
||||
static_assert(sizeof(FlDisplayState) == 64);
|
||||
static_assert(FL_SHM_DISPLAY_OFFSET == 0xC0 && FL_SHM_RING_OFFSET == 0x100 && FL_SHM_RING_OFFSET % 64 == 0);
|
||||
```
|
||||
|
||||
**Region 4 — the presenting swap chain's display facts (layout 4, 2026-09-27, beta.10).** The owner asked for the game's
|
||||
window size and display mode (exclusive fullscreen / borderless / windowed) and the share of a session each took. The two
|
||||
facts only the process knows — whether the chain is in exclusive fullscreen, and which window it presents to — are
|
||||
getters on the chain the title passed to the hooked Present (`GetFullscreenState`, `GetDesc`), asked at most every 500 ms
|
||||
per chain; everything else — the window's rectangle and style, its monitor, the classification — is the Agent's, read
|
||||
out of process with user32 at the drain tick, exactly as the foreground sample is (`03_METRICS` §Display mode). The
|
||||
region describes ONE chain: the largest back buffer, and a chain silent for 2 s gives way; `chainId` names it. It is a
|
||||
seqlock the writer never waits on — a writer that finds `seq` odd (another presenting thread inside) skips the sample and
|
||||
the next present retries — and `ShmRingReader.DisplayState` takes a copy between two reads of an even, unchanged `seq`
|
||||
(eight attempts, then null for that tick). The Vulkan layer never writes it (all zeros: nothing sampled); an OpenGL stream
|
||||
writes the window and client size with no exclusive bits, which a reader treats as *unknown*, never as *windowed*. A
|
||||
minimised game presents only `DXGI_PRESENT_TEST`, which the hook drops before sampling, so a `sampleQpc` older than 2 s
|
||||
leaves the exclusive bits unknown.
|
||||
|
||||
The cross-process fields are declared as plain integers and accessed through
|
||||
`std::atomic_ref` rather than as `std::atomic<T>` members. `std::atomic<T>` has
|
||||
no guaranteed layout, cannot be memcpy'd, and cannot be mirrored by a C#
|
||||
@@ -260,6 +301,28 @@ same class of bug as record drift.
|
||||
Agent is inert from the beginning rather than enjoying a grace window.
|
||||
- If `unhookRequested` is set, the Overlay disables hooks within one frame and sets `status = unhooked`. This path must be the fastest, most-tested code in the DLL: it is the safety stop.
|
||||
|
||||
## D — the tolerance mapping (`Local\FrameLedger.Tolerate.<pid>`), D33 (2026-09-26)
|
||||
|
||||
Agent → Overlay, once, BEFORE the injection it concerns: the anti-cheat family NAMES a game's user-mode exception
|
||||
covers (`19_SAFETY` §The user-mode exception). It cannot live in A + B: the Overlay creates that mapping on init and the
|
||||
Agent opens it afterwards, while the Overlay's loader detour must know the tolerance from the moment it exists.
|
||||
|
||||
```cpp
|
||||
struct FlTolerance { // fl_tolerance.h; 16 + 8 x 64 = 528 B, no padding
|
||||
uint32_t magic; // @0 FL_TOLERANCE_MAGIC ("FLTL")
|
||||
uint32_t version; // @4 FL_TOLERANCE_VERSION (1)
|
||||
uint32_t count; // @8 names used, <= 8
|
||||
uint32_t reserved; // @12 zero
|
||||
char families[8][64]; // @16 NUL-terminated ASCII family names
|
||||
};
|
||||
```
|
||||
|
||||
Created by the Agent for the game's pid, current user only, held for the session; read once by the Overlay's
|
||||
`InitThread` before `InstallLoaderHook`, which resolves every name against its own compiled floor and honours only a
|
||||
user-mode family. Absent, malformed or naming anything else: nothing is tolerated. Mirrored as `FlTolerance` /
|
||||
`ToleranceLayout` in `FrameLedger.Shared` and held to the native layout by `ShmLayoutMirrorTests` through
|
||||
`fl-layout-dump`. *(Built in beta.9: PR-1, the Overlay reads it; PR-2, the Agent writes it — `Infrastructure.Capture.OverlayToleranceChannel`, security descriptor `O:<user>D:P(A;;GR;;;<user>)` stated rather than defaulted (an elevated Agent's default DACL omits the user, and the Overlay in an unelevated game could not open it), a name that already exists refused as not ours, and a channel that cannot be published is no exception: the session then names no family and the blocked game is refused as before.)*
|
||||
|
||||
## C — command pipe (`\\.\pipe\FrameLedger.v2`)
|
||||
|
||||
Unchanged in spirit from v1, bumped to `v2` for the new message set.
|
||||
@@ -323,11 +386,12 @@ Unchanged in spirit from v1, bumped to `v2` for the new message set.
|
||||
|
||||
| Type | Dir | Payload / notes |
|
||||
|---|---|---|
|
||||
| `Hello` | UI→A | `{ appVersion, protocol: 2 }` → `HelloAck { agentVersion, protocol, pid, elevated, overlayBuildId, vulkanLayerRegistered, telemetrySource /* composite, e.g. l1+lhm+nvapi */, cpuTempAvailable, disclosureVersion /* P3 PR-4, D14: the FR-2.1 text this Agent stamps against */, ~~etwAvailable~~ }` — `etwAvailable` struck 2026-09-13 with the tier it described (2026-08-28); `pid` added. `vulkanLayerRegistered` is **false by construction** today (the layer is per-launch, never registered) and `cpuTempAvailable` false unelevated; `telemetrySource` is the composite stood up once on the first `Hello` |
|
||||
| `Hello` | UI→A | `{ appVersion, protocol: 2 }` → `HelloAck { agentVersion, protocol, pid, elevated, overlayBuildId, vulkanLayerRegistered, telemetrySource /* composite, e.g. l1+lhm+nvapi */, cpuTempAvailable, disclosureVersion /* P3 PR-4, D14: the FR-2.1 text this Agent stamps against */, exceptionDisclosureVersion /* D33, 2026-09-26: the user-mode exception's disclosure this Agent grants against */, elevationOutcome /* beta.10, D34: the admin mode's answer at this start — granted, declined, other-account, failed — or null when nobody asked */, ~~etwAvailable~~ }` — `etwAvailable` struck 2026-09-13 with the tier it described (2026-08-28); `pid` added. `vulkanLayerRegistered` is **false by construction** today (the layer is per-launch, never registered) and `cpuTempAvailable` false unelevated; `telemetrySource` is the composite stood up once on the first `Hello` |
|
||||
| `GetStatus` | UI→A | → `StatusAck { state, activeSession?, tier? }` — and `activeSessions[]`, one `{ sessionGuid, gameId, gameName?, pid, tier, startedAt, hold? }` per running session. **`hold` added 2026-09-23, optional:** present on a session held unhooked (Tier 2), with the same words `SessionStarted.hold` carries; a session listed at tier 2 WITHOUT a `hold` has not attached yet — it is starting, not held. The App reads this list on every (re)connect (§Client behavior) |
|
||||
| `SetWatchlist` | UI→A | `{ entries: [{ gameId?, exePath }] }` — ~~full replace~~ **ensure, never remove** (built 2026-09-13, PR-1b): each entry's path is normalised by the Agent, its row ensured with hooking OFF when new, and the ack is `WatchlistAck { games: [{ gameId, exePath, name }], unreadable: [exePath] }`; `gameId` in a request is a hint and never trusted over the path. UI re-sends on connect. **Carries no hooking state** (see §The pipe is not a trust boundary). *Since the App writes `games` rows itself under `06_DATA_MODEL` §Writer ownership (HANDOFF §P3 D15), this is the pipe's way of adding a row, not the only one; the watcher reads the table at 1 Hz either way.* |
|
||||
| `LaunchGame` | UI→A | `{ gameId, arguments? }` → ~~suspended-launch~~ launch mode as built ("inject late", `04_CAPTURE` §Launch mode) → `LaunchAck { gameId, accepted, outcome, sessionGuid? }` — `outcome` is `Accepted` · `UnknownGame` · `SessionRunning` (one per game at a time) · `Unavailable` · `RecordingOff` (2026-09-23: the entry's recording switch is off, FR-1.6 — FrameLedger does not start what it will not record). *(Built 2026-09-13, PR-1b: `CaptureOrchestrator.LaunchAsync` over an `ILaunchRecorderFactory` the Agent composes with the Vulkan layer's environment — or none when FR-2.4's switch is on — and the launcher election runs after, as the console's `launch` does; the elected session is not addressable by the launch's guid.)* |
|
||||
| `SetHookEnabled` | UI→A | `{ gameId, enabled, disclosureVersion? }` — Agent re-runs the static AC pre-scan and may reply `Refused`. **The Agent stamps the consent timestamp itself.** *(Built 2026-09-13, PR-1b, as far as it can be: `enabled: false` → `RevokeAsync` → `HookEnabledAck { gameId, enabled: false, outcome }`; `enabled: true` → the pre-scan of the executable's directory, a refusal or a "could not verify" recorded through `RecordGuardBlockAsync` and answered `Refused { gameId, reason, family?, signal? }`; a clean scan → ~~**`Error DisclosureUnavailable`, nothing stamped** — the reviewed FR-2.1 text does not exist, and a client's `disclosureVersion` is a claim, not a disclosure shown. PR-4 replaces that last branch with the stamp~~ **since PR-4 (2026-09-13): the client's `disclosureVersion` compared with the Agent's own `SafetyDisclosure.Version`; equal → the stamp from the Agent's clock with `ConsentProvenance.ConsentDialog`, answered `HookEnabledAck { enabled, outcome, prescan: "clean" }`; anything else → `Error DisclosureVersionMismatch`, nothing written (D14). `DisclosureUnavailable` remains for a composition that wired no version, which `--serve` never is.)* **Since beta.8 (2026-09-25):** the pre-scan is of the executable (the guard resolves the install root, PR-2 of that train), and BEFORE it an executable known not to run as x64 is answered `Refused { gameId, reason: "ExecutableNotX64", signal: "x86" | "anycpu32" | "arm64" | "arm" }` with nothing scanned and nothing written — not a guard reason and not a block (`05_DETECTION` §What the files say about themselves). |
|
||||
| `SetHookEnabled` | UI→A | `{ gameId, enabled, disclosureVersion? }` — Agent re-runs the static AC pre-scan and may reply `Refused`. **The Agent stamps the consent timestamp itself.** *(Built 2026-09-13, PR-1b, as far as it can be: `enabled: false` → `RevokeAsync` → `HookEnabledAck { gameId, enabled: false, outcome }`; `enabled: true` → the pre-scan of the executable's directory, a refusal or a "could not verify" recorded through `RecordGuardBlockAsync` and answered `Refused { gameId, reason, family?, signal? }`; a clean scan → ~~**`Error DisclosureUnavailable`, nothing stamped** — the reviewed FR-2.1 text does not exist, and a client's `disclosureVersion` is a claim, not a disclosure shown. PR-4 replaces that last branch with the stamp~~ **since PR-4 (2026-09-13): the client's `disclosureVersion` compared with the Agent's own `SafetyDisclosure.Version`; equal → the stamp from the Agent's clock with `ConsentProvenance.ConsentDialog`, answered `HookEnabledAck { enabled, outcome, prescan: "clean" }`; anything else → `Error DisclosureVersionMismatch`, nothing written (D14). `DisclosureUnavailable` remains for a composition that wired no version, which `--serve` never is.)* **Since beta.8 (2026-09-25):** the pre-scan is of the executable (the guard resolves the install root, PR-2 of that train), and BEFORE it an executable known not to run as x64 is answered `Refused { gameId, reason: "ExecutableNotX64", signal: "x86" | "anycpu32" | "arm64" | "arm" }` with nothing scanned and nothing written — not a guard reason and not a block (`05_DETECTION` §What the files say about themselves). **Since D33 (2026-09-26):** for a blocked game whose user-mode exception is in force for the executable on disk (the option on, a grant made on these bytes, the block naming that family) the pre-scan NAMES the family, and a pass under it is stamped as ever and answered `prescan: "exception"`; a finding about the game under it also ends the exception. |
|
||||
| `SetAntiCheatException` | UI→A | **Added 2026-09-26 (D33).** `{ gameId, enabled, disclosureVersion? }` — grant or withdraw a game's user-mode anti-cheat exception (`19_SAFETY` §The user-mode exception). `enabled: false` → the exception ends (`Withdrawn`), hooking goes off while the block stands → `AntiCheatExceptionAck { gameId, granted: false, outcome, family? }`. `enabled: true` → `Error DisclosureVersionMismatch` unless `disclosureVersion` is the Agent's `AntiCheatExceptionDisclosure.Version`; `Error ExceptionsOff` while `hooking.usermode_ac_exceptions` is off; `Refused { reason: "BlockNotExceptionable" }` for a title list or an unreadable block; then the Agent's OWN facts — ~~the successful Tier-1 sessions (`Refused { reason: "TooFewSessions", signal: <count> }` under two)~~ *(D38, 2026-10-03: no session is needed)*; a game an exception of which ended during its trial is refused before anything is scanned (`Refused { reason: "TrialFailed", family, signal: <unix ms> }`); a tolerant pre-scan of the executable on disk naming the block's family (`Refused { reason, family, signal }` unless the guard let exactly that family through) — and the store writes the grant only over facts that make the game eligible, and never over a failed trial → `AntiCheatExceptionAck { granted, outcome, family }`. **A grant turns nothing on**: hooking is FR-2.1's `SetHookEnabled`, afterwards. Not answered (`UnknownType`) by an Agent composed without the exception. |
|
||||
| `PauseCapture` / `ResumeCapture` | UI→A | global → `PauseAck { paused }`; `StatusAck.paused` reports it. *(Built 2026-09-13, PR-1b: one in-memory flag, `CapturePause`, read by every session loop at its tick and told to the ring once per transition; supervision — the guard scan, the kill switch, the safety stop — never pauses. Not persisted: an Agent that restarts resumes.)* |
|
||||
| `StopSession` | UI→A | `{ sessionGuid }` — graceful ~~unhook~~ stop + finalize → `StopAck { sessionGuid, accepted, reason? }`. *(Built 2026-09-13, PR-1b: the orchestrator names every session it starts and cancels THAT session's stop token; the loop reads it at its next tick, drains once more, and ends as `SessionEndReason.StoppedByUser` — `exit_status = normal`, the row stored like any other, the target left running. A guid nobody runs is `accepted: false`. Distinct from the host's cancellation, which leaves a `.partial`.)* |
|
||||
| `UpdateRules` | UI→A | **no payload** — a trigger, not a source. The Agent re-reads only its own `%LOCALAPPDATA%\FrameLedger\rules\` copy → `UpdateRulesAck { outcome }`. *(Built 2026-09-13, PR-1b: the seeder's `EnsureSeededAsync` outcome; a payload naming a path is ignored, and a test sends one to prove it.)* |
|
||||
@@ -398,6 +462,19 @@ message, and that message always re-scans.
|
||||
> before this the reason was swallowed, and a refusal looked exactly like an absent Agent). The Agent it does start
|
||||
> is watched until it exits and its exit code logged, so exit 10 — the folder was already claimed — is visible in
|
||||
> the App's log. `AgentConnectionTests` pins both.
|
||||
> **Amended 2026-09-27 (beta.10, the admin mode, D34): a start may ask Windows first.** With `capture.run_elevated` on
|
||||
> and this App a standard user's, the start is a UAC prompt owned by the App's window (`IAgentLauncher.WillAskForElevation`
|
||||
> turns the pill into *Waiting for administrator permission*), and while it is up the folder's `ElevationMarker`
|
||||
> (`Local\FrameLedger.Agent.Elevating.<hash>`) is held — `RunningAgent` reads it as "an Agent is coming", so the App never
|
||||
> prompts beside the logon task's Agent, which holds the same marker while its own prompt waits on the taskbar. A declined
|
||||
> prompt starts the standard user's Agent with `--elevation declined`; an elevated Agent that exits 11 (another account
|
||||
> answered) makes the App start standard-user Agents until it restarts.
|
||||
- **Named objects an elevated process creates state their DACL (beta.10).** An elevated token's default DACL grants
|
||||
Administrators and SYSTEM and not the user, so an object an elevated Agent creates with it cannot be opened by the same
|
||||
user's unelevated App or game: the pipe (`PipeAccessControl`), the tolerance mapping (§D) and — since beta.10 — the
|
||||
ledger's migration lock (`Infrastructure.Startup.SharedMutex`: owner the user, full access to the user, Administrators
|
||||
and SYSTEM) each carry an explicit descriptor. The instance lock and the elevation marker are only ever probed, and a
|
||||
probe that is refused reads as "held".
|
||||
- Treat the pipe as unreliable: library, history and charts must all work with the Agent offline. Only live status degrades.
|
||||
- SQLite is the source of truth for anything persisted; pipe events are refresh signals (except `SessionProgress`, which is live-only by design).
|
||||
- `CaptureRefused`, `SafetyUnhook` and (since 2026-09-25) `HookingTurnedOff` are **never** collapsed into a generic error toast — they get dedicated, explanatory UI (`08_UI` §Notifications).
|
||||
|
||||
+90
-2
@@ -24,7 +24,11 @@ WPF + **WPF UI (Wpf.Ui, Fluent)**. Shell = `ui:FluentWindow` with custom `ui:Tit
|
||||
**Menu bar**
|
||||
- **File:** Add game… · Import library (Steam / GOG / Epic / itch.io) · Export ▸ (Session CSV / Session JSON / Chart PNG) · Exit
|
||||
- **Tools:** Agent status… · Update detection rules · Vulkan layer registration… · Open data folder · Database maintenance…
|
||||
- **Help:** Check for updates · Report a bug… · Documentation · About FrameLedger (App / Developer / Third-party licenses tabs)
|
||||
- **Help:** Check for updates · Report a bug… · Documentation · Limitations · About FrameLedger (App / Developer / Third-party licenses tabs)
|
||||
|
||||
> **Help ▸ Limitations, beta.10 (D36):** `LIMITATIONS.md` as the build embeds it (`Services.LimitationsDocument`), in a
|
||||
> read-only, scrolling WPF UI `MessageBox` with *Open on GitHub*. It is information, not one of FR-11's documents:
|
||||
> nothing is accepted or recorded, and the Disclaimer points at it.
|
||||
|
||||
The Menu sits in its own row **below** the TitleBar (never inside the drag region — 16 §Gotchas).
|
||||
|
||||
@@ -171,6 +175,25 @@ All screens are `Page`s registered with the navigation page provider and navigat
|
||||
|
||||
### Games (grid → detail)
|
||||
- `GridView`-style panel of cover cards (`ui:CardAction`): name, platform badge, engine badge, total playtime, last played, mini trend sparkline (avg Native FPS last 10 sessions). Sort/filter/`ui:AutoSuggestBox` search.
|
||||
> **The library, beta.11 (owner requests 2026-10-03).** *The empty band on the right:* the cards were 300 px in a plain
|
||||
> `WrapPanel`, so at ~1350 px three fitted and a card's width was left unused; the grid is now
|
||||
> `Controls.UniformWrapPanel` — as many columns as fit at 300 px or wider, every card an equal share of the width, each row
|
||||
> as tall as its tallest card — and the pill row wraps instead of cutting its last pill. **Grid or list** (owner's choice:
|
||||
> switch between the two): the button beside the sort shows the other view; the list is one row per game (name, store,
|
||||
> engine, status, sessions, played, last played; double-click or Enter opens it), and the choice is `ui.library_view`.
|
||||
> **The count** is in the title (*Games · 42*). **Refresh** reads the library again, then asks the stores for games installed
|
||||
> since (`ImportLibraryFlow.RunAsync(onlyNew: true)`: *No new games* and no checklist when there are none), and every entry
|
||||
> whose executable is not on disk carries a **Not installed** pill — its tooltip is the game page's own sentence for it,
|
||||
> the drive that is not connected or the path the file is gone from (`GameLibrary.ExecutableExists` and
|
||||
> `Formats.ExecutableMissingText`, asked off the UI thread on every listing, never stored; nothing is removed for it). **The page reloads by itself** while it is on screen when a session ends (`SessionCompleted`) or an
|
||||
> import adds games (`LibraryChanges` — navigating to the page already on screen does nothing in WPF UI 4.3.0, so an
|
||||
> import from the menu never showed until the page was left). **Import** (FR-1.2): the games already in the library — at
|
||||
> this path or under another drive letter — are hidden by default (*Show the N games already in the library* brings them
|
||||
> back, dimmed), and a row that cannot be imported has its box disabled; the XAML comment said "cannot be ticked" while a
|
||||
> tick was taken and ignored. Tests: `GamesViewModelTests`, `ImportLibraryFlowTests.RefreshOffersOnlyNewGamesAndSaysWhenThereAreNone`,
|
||||
> `…GamesAlreadyInTheLibraryAreHiddenUntilAskedFor`, `PagesLoadTests.TheLibraryGridFillsItsWidthAndTheListViewReplacesIt`,
|
||||
> `…TheImportChecklistRendersWithTheExistingRowsShown`.
|
||||
>
|
||||
- **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):
|
||||
@@ -224,6 +247,33 @@ All screens are `Page`s registered with the navigation page provider and navigat
|
||||
> blocked row: its one action could only be refused. Tests: `GameDetailViewModelTests` (hidden, shown, the card
|
||||
> pill), `BlockedReasonTextTests`, `PagesLoadTests.AnAntiCheatGamesPageRendersTheFindingInPlaceOfTheHookingCard`.
|
||||
>
|
||||
> **D38 (2026-10-03, beta.11): the trial.** *Not eligible: N successful hooked session(s), two are needed* is gone — a
|
||||
> grant needs no session. The card reads *Exception in force since … — trial: N of 2 good sessions so far* until the
|
||||
> trial is over, *Not eligible: an exception of this game ended during its trial on …, so none can be made again* after
|
||||
> a failed one, and *Not eligible now: {family} was not found in the game's folder when it was checked* where the
|
||||
> tolerant scan found nothing of the family (it used to say the check "could not finish"). The **Anti-cheat** card of an
|
||||
> eligible game says hooking is off *unless you make a user-mode exception for it (below)* — "cannot be turned on" beside
|
||||
> a usable *Make exception…* contradicted itself. The disclosure (`ac-exception-dialog/2`) names no session count and
|
||||
> has a **Trial** paragraph. Tests: `GameDetailViewModelTests.WhyAGameIsNotEligibleIsSaidOnItsPage`,
|
||||
> `SettingsViewModelTests.TheExceptionOptionIsOffByDefaultAndItsListFollowsTheAgentsColumns`, `AntiCheatExceptionsTests`.
|
||||
>
|
||||
> **The user-mode exception (2026-09-26, beta.9, owner decision D33).** While Settings' option is on, a blocked
|
||||
> game's page shows a **User-mode exception** card with the Agent's answer about it (`Services.ExceptionView` over
|
||||
> `GameRow.AcException` — the App reads those columns and writes none): *Eligible — no exception made* with **Make
|
||||
> exception…**; *Checking…* until the Agent has looked at this block; *Not eligible: N successful hooked session(s), two
|
||||
> are needed*; *Not eligible: the guard also found {family} ({signal})* — Aniimo's *Kernel driver in the game folder
|
||||
> (NEPKernel.sys)*; *Not eligible: {family} is not user-mode throughout*; and how the last exception ended. **Make
|
||||
> exception…** opens the exception's disclosure (`AntiCheatExceptionPrompt`, text `Safety_Exception_*` versioned by
|
||||
> `AntiCheatExceptionDisclosure.Version`, the primary button bound to the ticked *I accept the risk of a ban for this
|
||||
> game*, Enter = *Keep it blocked*) and then `SetAntiCheatException`; the Agent gathers the facts and grants or
|
||||
> refuses, and the page says which. An exception in force brings the Hooking card back — even while anti-cheat cards
|
||||
> are hidden — with its switch usable through FR-2.1's dialog as ever, the finding still under it; **Withdraw
|
||||
> exception** ends it and turns hooking off. With the option off a kept exception is shown *suspended* and the switch
|
||||
> is disabled again. The library card says **Exception** for a game carrying one; a hooked session under it is
|
||||
> *Hooked · exception* in the Sessions tab (the tooltip names the family) and its summary has one line saying so.
|
||||
> Tests: `GameDetailViewModelTests.AnEligibleGameOffersTheExceptionAndOneInForceMakesTheSwitchUsable`,
|
||||
> `…WhyAGameIsNotEligibleIsSaidOnItsPage`, `AntiCheatExceptionsTests`.
|
||||
>
|
||||
> **Details (2026-09-25, beta.8, schema 0011).** A `ui:CardExpander` **Details** under the two rows, expanded, says
|
||||
> what the game's files and its store say (`05_DETECTION` §What the files say about themselves): *Runs as* (64-bit
|
||||
> (x64) · 32-bit (x86) · ARM64 · .NET, any CPU (runs as 64-bit) · …), *File version* and *Product version* (the
|
||||
@@ -242,6 +292,15 @@ All screens are `Page`s registered with the navigation page provider and navigat
|
||||
2. **Frametime** — ScottPlot timeline of selected session (decimated), stutter markers, sensor overlay toggle (temp on right axis).
|
||||
3. **Distribution** — FPS histogram + percentile curve of selected session(s).
|
||||
4. **Trend** — metric-over-date line (selector: Native avg / Displayed avg / 1% Low / 0.1% Low / max GPU temp), vertical **hardware-change markers** with tooltip "GPU driver 572.16 → 576.02" (FR-6.3).
|
||||
|
||||
> **The display mode, beta.10 (FR-7.4, `03_METRICS` §Display mode).** The **Last session measured** row adds how that
|
||||
> session was shown — the mode that lasted longest with its share and the window's size (`Display: Borderless 92% ·
|
||||
> 2560×1440`); the **Sessions** tab has a *Display* column for every session, Tier 2 included (the mode shown longest,
|
||||
> with a tooltip carrying every share, the changes, the window on its monitor, the back buffer and the witness), `N/A`
|
||||
> for a session recorded before; the **Trend** has three more metrics — *Exclusive fullscreen share %*, *Borderless
|
||||
> share %*, *Windowed share %* — over every session whatever its tier, never left out as a mid-session change (a mode
|
||||
> switch resizes the swap chain, and the share is what that switch was), with no exclusive or borderless point for a
|
||||
> session that had any time nothing could split (`Services.DisplayText`, `Charts.TrendSeriesBuilder.DisplayShare`).
|
||||
5. **Sensors** — temp/load/power/VRAM timelines per session; per-process VRAM and adapter-wide VRAM as separate, differently-labelled series.
|
||||
6. **Latency** *(Tier 1 + Reflex only)* — PC latency timeline, avg/p95.
|
||||
|
||||
@@ -286,7 +345,7 @@ All screens are `Page`s registered with the navigation page provider and navigat
|
||||
> PNGs have an opaque background (`ChartTheme.SavePng`: the window's colour under the transparent figure).
|
||||
|
||||
### Session summary (secondary `FluentWindow`, also the post-session toast target)
|
||||
Stat cards (Avg uses `FpsReadout`, Median, 1% Low, 0.1% Low, Min/Max, σ, stutter %, duration), TriState chips, API/PresentMode/upscaler line, crash `InfoBar` (Severity=Error) when `crashed`, frametime chart, sensor strip, tags/notes editor, Export buttons.
|
||||
Stat cards (Avg uses `FpsReadout`, Median, 1% Low, 0.1% Low, Min/Max, σ, stutter %, duration, **Display** — beta.10: the mode shown longest with its share and the window's size, both tiers), TriState chips, API/PresentMode/upscaler line, **the display line** (beta.10: every mode's share, the changes, the window on its monitor at its refresh rate, the back buffer and swap effect, and what the facts rested on — "the swap chain said whether it was exclusive" or "from the window alone: exclusive fullscreen cannot be told from borderless"; absent for a session recorded before), crash `InfoBar` (Severity=Error) when `crashed`, frametime chart, sensor strip, tags/notes editor, Export buttons.
|
||||
|
||||
> **Built 2026-09-14 (P3 PR-6).** `Windows/SessionSummaryWindow` (a secondary `FluentWindow` with its own
|
||||
> `ContentDialogHost`), opened from a Sessions-tab row (double-click or Open) and from the Dashboard's recent
|
||||
@@ -387,6 +446,9 @@ Session picker (2–5, cross-game allowed) → overlaid percentile curves + stat
|
||||
> separate rows (never one column), Median, the lows, stutter time %, max GPU °C, duration — with the best
|
||||
> value of each row bold and accent-coloured (higher wins for FPS, lower for temperature and stutter; N/A is
|
||||
> never best), and a Tier-2 session's cells at N/A. Export PNG through `Plot.SavePng`.
|
||||
>
|
||||
> **beta.10:** three rows after Duration — *Display mode* (every share), *Window* and *Monitor* (with its refresh
|
||||
> rate) — facts, not scores: no mode is better than another, so none is ever marked best, and every tier has them.
|
||||
|
||||
### Logs
|
||||
Tail view of `ui-*.log` / `agent-*.log` (toggle), level filter, search (`ui:AutoSuggestBox`), pause-scroll; buttons: Open logs folder, Export bug bundle (routes to 10_LOGGING flow).
|
||||
@@ -408,6 +470,17 @@ Sections per FR-10 using the WPF UI settings idiom: `ui:CardControl`/`ui:CardExp
|
||||
|
||||
Agent section: elevation state with a plain explanation of what elevation *optionally* unlocks (CPU temperature, elevated-game attach — ~~ETW fallback~~, which no longer exists) and that it is **not required by any capture tier**; task state, Register/Repair/Remove task, "Start agent at logon", background capture toggle. Privacy: online-metadata opt-in with plain-language explanation. Legal: reopen documents.
|
||||
|
||||
> **The admin mode, beta.10 (owner decision D34; `01_ARCHITECTURE` ADR-9).** The Agent section has a switch, *Run the agent
|
||||
> as administrator* (`capture.run_elevated`, off by default). Turning it on opens a `ContentDialog`
|
||||
> (`Services.AgentAdminPrompt`, text `FrameLedger.Shared`'s `Safety_AdminMode_*`, version `agent-admin-dialog/1` in its
|
||||
> corner) whose primary button is enabled only by ticking "I understand…" and whose default button keeps standard rights;
|
||||
> declined, nothing is written. Either way the row is written and the Agent restarts — asked to stop over the pipe, its
|
||||
> instance lock waited out, the connection's next round starting it the new way — **except under a running session**,
|
||||
> which the restart would end: then the snackbar says the change applies at the Agent's next start. The elevation line
|
||||
> says why a standard user's Agent is one when Windows was asked (`HelloAck.ElevationOutcome`: declined, answered by
|
||||
> another account, could not start), and while the prompt waits the status pill reads *Waiting for administrator
|
||||
> permission* (`AgentConnectionState.Elevating`).
|
||||
|
||||
> **Built 2026-09-14 (P3 PR-8a), with three rows deferred to PR-8b and one to PR-9.** `SettingsViewModel` over
|
||||
> `Application.Settings.RegisteredSettings` (the registry of `06_DATA_MODEL` §Settings registry — every write is
|
||||
> one `settings` row, and a key the Agent reads gets the 4 s "Applied. The capture agent reads it at the next
|
||||
@@ -449,6 +522,21 @@ Agent section: elevation state with a plain explanation of what elevation *optio
|
||||
> **2026-09-25 (beta.8):** Capture gained *Hide hooking on anti-cheat games* (`ui.hide_anticheat_hooking`, on by
|
||||
> default) between the kill switch and the Vulkan layer row — §Games says what it hides; the game's page reads it at
|
||||
> each load. It hides a control that could only be refused, never the finding.
|
||||
>
|
||||
> **2026-09-26 (beta.9, D33):** Capture gained *Allow hooking in games with user-mode anti-cheat that were measured
|
||||
> before* (`hooking.usermode_ac_exceptions`, off by default), below the hide switch, and under it the **User-mode
|
||||
> exceptions** list — the games the Agent found eligible (**Make exception…**), held back only by the session count,
|
||||
> or carrying an exception (**Withdraw**), each with its finding, its successful hooked sessions and its state; with
|
||||
> the option off only kept exceptions are listed, *suspended*. *Checking…* shows until the Agent has answered about
|
||||
> every blocked game, and **Refresh** re-reads the list (the Agent's sweep runs every 15 s). The option is an
|
||||
> Agent-read key and takes effect at the next session start and command.
|
||||
>
|
||||
> **2026-10-03 (beta.11, D38):** the option reads *Allow hooking in games whose only anti-cheat runs in user mode*, and
|
||||
> its body names the trial. The list shows **only rows with an action** — eligible (**Make exception…**) or carrying an
|
||||
> exception (**Withdraw**); "held back only by the session count" is gone with the count, and a game that can never
|
||||
> qualify is explained on its own page. Each row is the game, its finding and its state — the state carries a grant's
|
||||
> trial (*Exception in force since … — trial: 1 of 2 good sessions so far*), so the separate count line that repeated it
|
||||
> is gone. **Refresh** shows only while a row is *Checking…*, the one time it can change anything.
|
||||
|
||||
### First-run flow
|
||||
1. Legal Gate (FR-11): four documents, scrollable, links to GitHub-hosted versions, single Accept.
|
||||
|
||||
@@ -62,6 +62,9 @@ Consent, refusal, and safety-unhook text (FR-2.1, `19_SAFETY`) is **reviewed lik
|
||||
- No machine-drafted `ja` in this category — a mistranslated ban warning is a real harm. These keys are marked `<comment>safety: human review required</comment>` and ~~the `ja` build fails the resx audit until a human reviewer signs off; until then the `en` string is shown as fallback rather than an unreviewed translation~~ **as built (2026-09-13): the audit is red on a `Safety_*` key in `ja` that carries neither `safety: human review required` nor `safety: reviewed by <name>`, and red on one marked review-required whose value is anything but the `en` string verbatim** — the key-set rule forbids leaving it out, so "shown as `en` until signed" is true by construction (the value IS the English), not by a runtime fallback. Signing = replacing the comment with `safety: reviewed by <name>` beside the reviewed text.
|
||||
- Never soften the wording per locale. "May result in a permanent ban of your account" must survive translation with the same force in all three languages.
|
||||
- Key prefix `Safety_*` so they are easy to audit as a group.
|
||||
- **`Safety_Exception_*` (2026-09-26, D33)** is the user-mode exception's disclosure: the same rules — `ja` ships the
|
||||
English verbatim marked for review — and its own version, `AntiCheatExceptionDisclosure.Version`, bumped when any of
|
||||
those strings changes meaning, exactly as `SafetyDisclosure.Version` is for `Safety_Consent_*`.
|
||||
|
||||
> **What is in scope, stated 2026-08-06 because a binary now exists that is not.** These rules
|
||||
> govern the **shipped** application's user-visible strings — what `12_BUILD` §Publish & package
|
||||
|
||||
+10
-1
@@ -36,6 +36,11 @@ Binaries are not code-signed (project policy). Consequences and mitigations, doc
|
||||
|
||||
SemVer `MAJOR.MINOR.PATCH`. Tag `vX.Y.Z` triggers the release workflow (13_CI_CD). `MAJOR` bumps for DB schema or IPC protocol breaks; migrations must cover every released `MAJOR-1` version.
|
||||
|
||||
> **Under `0.x` this rule is not applied, and every pre-release says so by shipping one anyway** (SemVer §4: a major version
|
||||
> zero is initial development). Schemas 0008–0015 and the shared-memory layout 4 (2026-09-27, beta.10) each shipped in a
|
||||
> `0.1.0-beta.N`. What protects a user is not the number: the ledger migrates in place (`06_DATA_MODEL` §Migrations), and a
|
||||
> layout mismatch is refused at attach with "restart the game" (`07_IPC` §Protocol rules). The rule applies from `1.0.0`.
|
||||
|
||||
## Built 2026-09-14 (P4 PR-5) — what exists, and where it deviates from the above
|
||||
|
||||
`src/FrameLedger.App/Update/`. Velopack 1.2.0 (`Directory.Packages.props`, pinned since P0, referenced since
|
||||
@@ -66,7 +71,11 @@ flow, and the tests run the flow over a fake client because nothing here may tou
|
||||
connect SEEDS the running set rather than being OR-ed with it forever — before, a session running when the App
|
||||
connected held every download at `Deferred` until the next reconnect, hours after it ended.
|
||||
- **Apply:** `Shutdown` to the Agent over the pipe, the connection's relaunch held (`IAgentLink.SetLaunchHold`),
|
||||
the pipe watched until it drops (10 s; an Agent that does not stop leaves everything as it was and says so),
|
||||
the pipe watched until it drops (10 s; an Agent that does not stop leaves everything as it was and says so) —
|
||||
**and since beta.10 the data folder's instance lock watched until it is let go, within the same 10 s**: an Agent run as
|
||||
administrator (the admin mode) holds the install directory's files exactly as long as its process lives, and one that
|
||||
holds the folder without answering this App (still starting, another version) is never updated under — the apply is
|
||||
refused with `Update_AgentStillRunning` instead,
|
||||
then `WaitExitThenApplyUpdates(asset, silent: false, restart: true)` and the host ends. The restarted App
|
||||
starts the Agent beside itself as always, and when Velopack reports the restart (`OnRestarted`) the host reads
|
||||
the logon task: `Stale` (the action path moved) runs `--install-task`, this user's own task, and says so in the
|
||||
|
||||
+1
-1
@@ -88,7 +88,7 @@ Launch profiles:
|
||||
|
||||
Native debugging notes: use **`hook-harness`, never a real game**, for step-through debugging — a breakpoint inside a present hook of a real game freezes it in ways anti-cheat and drivers both dislike. Enable the Vulkan validation layers when touching `FrameLedger.VkLayer`. Application Verifier + PageHeap on the harness catches ring-buffer bugs early.
|
||||
|
||||
Agent flags: `--serve`, `--console`, `--write-crash-dump <file>` (2026-09-17: the crash-dump helper a crashing App or Agent starts; it dumps its parent and takes no pid — `10_LOGGING` §Crash handling), ~~`--diag`~~ (the App's — `FrameLedger.exe --diag`, `10_LOGGING`; the Agent answers exit 2 for it), `--install-task`, `--uninstall-task`, `--register-vklayer`, `--unregister-vklayer` (all four real since 2026-09-14, P3 PR-8b: the task is `\FrameLedger\FrameLedger.Agent` through the Task Scheduler COM API — `schtasks /Create /SC ONLOGON` is "Access is denied" unelevated on the dev box, measured — this user's logon trigger, interactive token, lowest run level; the layer registration is `17_HOOK_ENGINE` §Vulkan's HKCU value).
|
||||
Agent flags: `--serve` (since beta.10 with at most one of `--for-user <SID>` — the account an Agent started as administrator must be, else it exits 11 — or `--elevation declined|other-account|failed` — its starter asked Windows and got this; both from the admin mode, `01_ARCHITECTURE` ADR-9), `--console`, `--write-crash-dump <file>` (2026-09-17: the crash-dump helper a crashing App or Agent starts; it dumps its parent and takes no pid — `10_LOGGING` §Crash handling), ~~`--diag`~~ (the App's — `FrameLedger.exe --diag`, `10_LOGGING`; the Agent answers exit 2 for it), `--install-task`, `--uninstall-task`, `--register-vklayer`, `--unregister-vklayer` (all four real since 2026-09-14, P3 PR-8b: the task is `\FrameLedger\FrameLedger.Agent` through the Task Scheduler COM API — `schtasks /Create /SC ONLOGON` is "Access is denied" unelevated on the dev box, measured — this user's logon trigger, interactive token, lowest run level; the layer registration is `17_HOOK_ENGINE` §Vulkan's HKCU value).
|
||||
|
||||
> **Built 2026-09-10 (P2 PR-F): `--serve` and `--console`; the other five answer "not implemented in P2"
|
||||
> with exit 2** rather than being silently accepted (`--diag` is the App's anyway, `10_LOGGING`). The console
|
||||
|
||||
+1
-1
@@ -298,7 +298,7 @@ Findings written to `docs/spike-notes.md`. Nothing in P1 starts until the exit c
|
||||
> `logs\overlay-<pid>-*.log` (init / Agent request / stop), `opengl32!wglSwapBuffers` with the harness's
|
||||
> `--opengl` mode. **D3D9 is not built and will not be**: `20_OPEN_QUESTIONS` §Scope decisions rules it out
|
||||
> of v1 (the Overlay is x64-only and those titles are 32-bit); listing it here was the roadmap's, not the
|
||||
> scope's. What P1 still leaves ⏳ in `17_HOOK_ENGINE` §Hook inventory: `SetFullscreenState`,
|
||||
> scope's. What P1 still leaves ⏳ in `17_HOOK_ENGINE` §Hook inventory: ~~`SetFullscreenState`~~ (polled instead, 2026-09-27),
|
||||
> `SetColorSpace1`, `CreateSwapChain*`, `ID3D12Device5::CreateStateObject`, the Vulkan RT / pipeline entries,
|
||||
> §Pipeline and §Memory/latency — feature rows, each with its own measurement question, not P1's core. P2
|
||||
> (the Agent, the recorder, SQLite) is next per this file.
|
||||
|
||||
+13
-3
@@ -57,6 +57,16 @@ The injected DLL. Its whole job: install hooks, write 64-byte records into a rin
|
||||
> them and the loader does not list them. Body under `FL_HOOK_GUARD`, no allocation, no lock, no
|
||||
> logging (rule 5). Exercised by `hook-harness --load-after-ms N PATH` (up to four), against the real
|
||||
> Overlay in a real target, both jobs.
|
||||
>
|
||||
> **D33 (2026-09-26): one family may be tolerated.** Before `InstallLoaderHook`, `InitThread` reads
|
||||
> `Local\FrameLedger.Tolerate.<pid>` once (`fl_tolerance.h`; absent = nothing tolerated, the ordinary case),
|
||||
> resolves each name against its OWN compiled floor, honours only a family whose whole footprint there is
|
||||
> user-mode (`fl::guard::FamilyIsUserModeOnly`) and keeps a 64-bit mask over the floor's module families. The
|
||||
> detour's only change is one bit test before (b): a tolerated family's module loading late is not an early stop.
|
||||
> **Overhead:** one relaxed-acquire `uint64` load, a shift and a compare, on the floor-match branch alone — a branch
|
||||
> that fires approximately never — and nothing on the present path; the tolerance is read on the init thread, not in
|
||||
> a hook body (and logged there as `TOLERANCE`). ctest `fl_guard` `[D33]` loads a decoy `NEP2.dll` 2.5 s in: the
|
||||
> Overlay keeps recording when the mapping names NetEase Yidun, and stops when it names Easy Anti-Cheat.
|
||||
4. Install present hooks for what exists (below).
|
||||
5. Install feature hooks (upscaler / RT / PSO) lazily — the first time their module appears.
|
||||
6. Publish `status = ready` in the handshake block.
|
||||
@@ -133,7 +143,7 @@ Every hook must be listed here with a purpose. Anything not on this list is not
|
||||
> Reset is load-bearing — and no vendor symbol is resolved by name, so `FL_HOOK_INVENTORY`
|
||||
> and `hookinventory-check` do not cover them at all.
|
||||
> **Every other row below is unwritten**, including
|
||||
> `SetFullscreenState`, `SetColorSpace1`, `CreateSwapChain*`, ~~`wglSwapBuffers`~~ (built 2026-09-06, #141, its row below),
|
||||
> ~~`SetFullscreenState`~~ (polled instead since 2026-09-27, its row below), `SetColorSpace1`, `CreateSwapChain*`, ~~`wglSwapBuffers`~~ (built 2026-09-06, #141, its row below),
|
||||
> `ID3D12Device5::CreateStateObject`, §Pipeline and §Memory/latency.
|
||||
>
|
||||
> Stated here because the distinction is invisible from the table. What a writer may then
|
||||
@@ -169,7 +179,7 @@ Every hook must be listed here with a purpose. Anything not on this list is not
|
||||
|---|---|
|
||||
| ✅ `IDXGISwapChain::Present`, `Present1` | Frame boundary, QPC, sync interval, present flags. **`DXGI_PRESENT_TEST` calls are dropped without a record** — the occlusion probe submits nothing, and a minimised game emits a stream of them (`07_IPC` §Protocol rules). **Since 2026-09-05 the hook also reads `IDXGISwapChain::GetLastPresentCount` on the chain it just saw** (rule 4: the same COM object `FindOrAdd` already calls `GetDesc` on, no new hook) and publishes `dxgiPresentSamples` / `dxgiPresentsUnseen` — DXGI's count of presents on that chain that this hook never saw, the in-process half of `20_OPEN_QUESTIONS` §H5 Leg 1. One virtual call per hooked present, costed by `hook-harness --probe-frames`. **And per record since the same night: `dxgiUnseen` @52 under `FL_MEASURED_DXGI_PRESENTS`**, so the consumer's window counts `Displayed = hooked + unseen` per bucket (`03_METRICS` §Displayed may be DXGI-COUNTED) — measured 2.90 / 2.95 on DL:TB at Streamline 2.8.0, 0 on 2.7.3 and 2.10.3. **And since 2026-09-06 (P1 item 2) the same read, at the FIRST hooked present on the first hooked chain, is published once as `FlWriterState.dxgiPresentsBeforeHook` @60** — DXGI's count of presents that ran before the hook was in, launch mode's cost meter (`20_OPEN_QUESTIONS` §S1); 0xFFFFFFFF until a present is seen, set before the present hooks go in. **Corrected 2026-09-14 (`fl_dxgi_count.h`, ctest `fl_dxgi_count`):** a reading that went *backwards* — a chain released and re-created at the same address inherits the slot's old count — used to wrap `now − previous` to ~4e9, saturate the record byte at 255 (the `DxgiSaturated` refusal) and add the wrap to the session total: the owner's ledger held `dxgi_unseen_total = 4294967243`. A regression is now a reset (no delta claimed, nothing added, the slot re-armed) and the total saturates at `UINT32_MAX` rather than wrapping. Cost: one compare on the same virtual call; measured per `14_TESTING` §Hook overhead in the PR |
|
||||
| ✅ `IDXGISwapChain::ResizeBuffers` · ⏳ `ResizeTarget` | Output resolution changes mid-session. `ResizeBuffers` re-reads the swapchain description *after* the original returns; `ResizeTarget` is not hooked |
|
||||
| ⏳ `IDXGISwapChain::SetFullscreenState` | Fullscreen ↔ borderless transitions |
|
||||
| ~~⏳ `IDXGISwapChain::SetFullscreenState`~~ **not hooked — polled (2026-09-27, beta.10)** | ~~Fullscreen ↔ borderless transitions~~ **Region 4, `FlDisplayState` (`07_IPC`, layout 4).** DXGI leaves exclusive fullscreen by itself — focus lost, Alt+Enter inside its own window hook — without the title calling this method, so a hook would miss exactly the transitions a mode share must count. Instead the present hook asks, **at most every 500 ms per chain**, two getters on the chain the title passed: `GetFullscreenState(&fs, nullptr)` (no `IDXGIOutput` taken) and `GetDesc` (the window, the back buffer, the swap effect). Rule 4: the same object `FindOrAdd` already calls `GetDesc` on and the counter reads — no new hook, no read beyond it; the window's geometry and the classification are the Agent's, out of process. `GetDesc` again also refreshes the size every record carries, which closes `IDXGISwapChain3::ResizeBuffers1` (unhooked: a D3D12 title resizing through it kept its old size until now). Published through a seqlock the writer never waits on (a taken lock skips the sample). OpenGL publishes the window and client size `ReadGlSize` already holds, with no exclusive bits. Cost per `14_TESTING` §Hook overhead in the PR |
|
||||
| ⏳ `IDXGISwapChain3::SetColorSpace1` | HDR output detection. **`IDXGISwapChain3`, not 4** — 4 adds only `SetHDRMetaData` (`20_OPEN_QUESTIONS` §H9 — *answered and removed with H1/H3/H4 in the P0 spike (`6b1fa83`); this row used to say `IDXGISwapChain4`, and the corrected interface here IS the answer, so the citation points at history rather than at a live entry*). Unbuilt, which is why `colorSpace` reads `NOT_REPORTED` and `FL_MEASURED_HDR` stays clear. **When it is built, the writer must initialise `colorSpace = FL_COLOR_SPACE_SDR` at swapchain identification** — an SDR title never calls `SetColorSpace1`, so "hook live, no call" would otherwise sit at `NOT_REPORTED` forever and HDR's definite `No` would be unreachable. DXGI documents G22/Rec.709 as the default, which makes SDR a *measured* default rather than an affirmative negative |
|
||||
| ⏳ `IDXGIFactory::CreateSwapChain*` | Capture swapchain desc (format, buffer count, swap effect, flags) at creation. Unbuilt — the swapchain description is currently read on demand in the present hook via `GetDesc` |
|
||||
| ✅ `wglSwapBuffers` (2026-09-06, P1 item 4) | OpenGL titles: one record per `opengl32!wglSwapBuffers`, `api` = OpenGL, the output size from `GetClientRect` on the window the HDC belongs to (first sighting and every 256th present, so a resize is caught without a second hook), **no `FL_MEASURED_PRESENT_ARGS`** — the call has no sync interval and no flags. A MinHook inline patch on the flat export (measured 2026-08-05: a `jmp` thunk into the vendor ICD, relocated like any first instruction), installed at init when `opengl32.dll` is already mapped and lazily on the watchdog otherwise, with the `LoadLibrary` detour waking it for `opengl32.dll`. Exercised by `hook-harness --opengl --hold-presenting N`, which calls **gdi32's `SwapBuffers`** the way a title does — measured to reach the hook (ctest `fl_guard` `[opengl]`, on Microsoft's generic renderer, so it runs on CI too). The one system-module row below carries the inventory asymmetry |
|
||||
@@ -614,7 +624,7 @@ Every hook body is wrapped:
|
||||
```
|
||||
|
||||
- Any SEH exception inside our code ⇒ increment `faultCount`, record which hook, **return control to the original function** so the game continues.
|
||||
- 3 faults total ⇒ set `status = self_disabled`, uninstall all hooks (`MH_DisableHook(MH_ALL_HOOKS)`), stop writing, stay dormant. The Agent sees the flag and finalizes the session as `degraded`.
|
||||
- 3 faults total ⇒ set `status = self_disabled`, ~~uninstall all hooks (`MH_DisableHook(MH_ALL_HOOKS)`)~~ restore each patch's prologue only while its bytes are still our jump (compare-and-restore per patch through `StopObserving`, §Unhooking, §H7 — `MH_ALL_HOOKS` would have removed an overlay chained after us; corrected 2026-09-27), stop writing, stay dormant. The Agent sees the flag and finalizes the session as `degraded`.
|
||||
- Never `__try` around the call to the original function — only around *our* code, so we never mask a game bug as ours or vice versa.
|
||||
- The trampoline call to the original is always executed exactly once, on every path, including error paths.
|
||||
|
||||
|
||||
@@ -122,7 +122,10 @@ CPU and motherboard sensors remain LHM-only, elevated-only, PawnIO-dependent, an
|
||||
> unelevated by design, so the unprivileged layer's behaviour never depends on privilege) only when the process is
|
||||
> elevated AND `PawnIo.IsInstalled`; it takes the package sensor (`CPU Package`, `Core (Tctl/Tdie)`) and falls back to the
|
||||
> hottest core. **Unmeasured on real hardware**: exercised against a fake `ILhmComputer` only; the first elevated run
|
||||
> with PawnIO is the measurement. `HelloAck.cpuTempAvailable` reports those same two conditions (it was a constant
|
||||
> with PawnIO is the measurement — **which the user can now choose to make (beta.10, the admin mode: Settings ▸ Capture
|
||||
> agent ▸ Run the agent as administrator, `01_ARCHITECTURE` ADR-9)**; until beta.10 an elevated Agent existed only when an
|
||||
> App started as administrator happened to start it, and `PrivilegeFootprintTests` now asserts on the elevated CI runner
|
||||
> that opening this CPU group enables no privilege. `HelloAck.cpuTempAvailable` reports those same two conditions (it was a constant
|
||||
> `false`). A tick only the machine answered is still queued, under a placeholder `GpuSample` with
|
||||
> `TelemetryLayer.None` and no field. The `.partial` sensor chunk carries the three values in bits 12–14 of the
|
||||
> existing 16-bit presence mask, so an older file reads back with an empty reading.
|
||||
|
||||
@@ -18,7 +18,7 @@ These are permanently out of scope. A PR implementing any of them is rejected re
|
||||
- Hiding, renaming, or randomizing the DLL, its exports, or its shared-memory object names
|
||||
- Thread hiding (`NtSetInformationThread`/`ThreadHideFromDebugger`) or debugger-evasion tricks
|
||||
- Signature-breaking obfuscation/packing of our own binaries
|
||||
- Any "bypass" setting, "stealth mode", or documentation explaining how to defeat the guard below. *(The first two words left this line on 2026-09-21 and returned on 2026-09-22 — §What a finding does to the game.)*
|
||||
- Any "bypass" setting, "stealth mode", or documentation explaining how to defeat the guard below. *(The first two words left this line on 2026-09-21 and returned on 2026-09-22 — §What a finding does to the game. The one exception the owner has granted since, D33 on 2026-09-26, is not a bypass: the guard still runs every check and decides itself which family is user-mode — §The user-mode exception.)*
|
||||
- Reading or writing game memory outside the arguments of APIs we hooked
|
||||
- Kernel drivers of our own
|
||||
|
||||
@@ -235,12 +235,20 @@ 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:** 30 Steam app ids and 33 executable names across nine families —
|
||||
> **What is listed, and why a title list at all:** 33 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).
|
||||
> 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).
|
||||
> 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
|
||||
> numbered name (`usrdrv017864.sys`, ValveSoftware/Proton#8853), outside the game's folder, so the `.sys` rule cannot
|
||||
> see it before the first run and no driver token could name it. Each of the three store pages states *"Uses Kernel
|
||||
> Level Anti-Cheat"* and CrackProof (read 2026-10-03); ANOTHER EDEN, which a community list also names, was left out
|
||||
> because its store page says nothing of the kind.
|
||||
> Every app id was checked against its Steam store page; Call of Duty's changed when Activision split CoD HQ, so only
|
||||
> ids with a live store page are listed. The per-title lists are **floored** like the families: a rules file can
|
||||
> add a title and cannot take one off. `rules-validate` refuses a name engines and tools share (`Game.exe`,
|
||||
@@ -357,7 +365,7 @@ Implemented in `FrameLedger.Injector` and reached from managed code through a th
|
||||
> That needs a real game library, and it is a false-refusal path, so it is
|
||||
> recorded rather than assumed benign.
|
||||
|
||||
Any check failing ⇒ **injection is refused**. The UI shows which check fired and offers Tier-2 (ETW) capture instead, which requires no injection — but does require an elevated Agent, so the offer must state that plainly and fall through to Tier 3 rather than appearing to succeed and recording nothing (`04_CAPTURE` §Frame source abstraction).
|
||||
Any check failing ⇒ **injection is refused**. The UI shows which check fired and ~~offers Tier-2 (ETW) capture instead, which requires no injection — but does require an elevated Agent, so the offer must state that plainly and fall through to Tier 3 rather than appearing to succeed and recording nothing (`04_CAPTURE` §Frame source abstraction)~~ **records the session unmeasured — Tier 2: its duration, the machine's sensors and the reason — which needs no injection and no elevation; there is no ETW rung and no Tier 3 since 2026-08-28** (corrected 2026-09-27: this sentence outlived the ladder it described by a month).
|
||||
|
||||
### The payload is checked too, and for a long time it was not
|
||||
|
||||
@@ -394,7 +402,7 @@ the injection primitive, not a fifth question about the title.
|
||||
- **Absent** is still `kInjectionFailed`, not `kPayloadNotOurs`. A damaged install
|
||||
and a misuse of the ABI are different problems and must not share a reason.
|
||||
|
||||
> **There is no override.** ~~There is one, since 2026-09-21, and it is none of the things this paragraph named~~ *(one day; withdrawn 2026-09-22)*: still no hidden setting, no config-file flag, no CLI switch, no "advanced users" escape hatch, no global form. If a user disagrees with a specific entry, the path is still a GitHub issue against the rules file, reviewed in public. What exists is below.
|
||||
> **There is no override.** ~~There is one, since 2026-09-21, and it is none of the things this paragraph named~~ *(one day; withdrawn 2026-09-22)*: still no hidden setting, no config-file flag, no CLI switch, no "advanced users" escape hatch, no global form. If a user disagrees with a specific entry, the path is still a GitHub issue against the rules file, reviewed in public. What exists is below — and since 2026-09-26 (D33), one narrow, evidence-bound exception for anti-cheat that is user-mode throughout, which lets a named family through while every check still runs (§The user-mode exception).
|
||||
|
||||
### What a finding does to the game — owner decision 2026-09-22
|
||||
|
||||
@@ -455,7 +463,8 @@ card is back with the finding under its disabled switch. The finding itself is o
|
||||
|
||||
**What clears it.** Nothing, as before: the block outlives *Change executable* and a re-import (§A game already enabled
|
||||
can become blocked later). The owner asked for hooking to be turned off when anti-cheat is detected, not for a second
|
||||
switch.
|
||||
switch. *(Still true under D33: an exception is a separate layer over the block, never a clearing of it — §The user-mode
|
||||
exception.)*
|
||||
|
||||
**D21 stands as a fact.** A process an anti-cheat driver protects is `SessionEndReason.TargetUnreadable` (2026-09-21:
|
||||
every candidate of that name exists and none can be opened; ELDEN RING under Easy Anti-Cheat on the owner's machine).
|
||||
@@ -467,6 +476,100 @@ still finds the injection primitives in exactly that file and the evasion primit
|
||||
to four methods (`NoSecondMatcherTests`). `FloorFamilies` is untouched.
|
||||
|
||||
|
||||
### The user-mode exception — owner decision 2026-09-26 (D33)
|
||||
|
||||
**Why it exists.** The beta.8 library sweep turned hooking off for *GIRLS' FRONTLINE 2: EXILIUM* on a documented,
|
||||
unmeasured rule — NetEase Yidun, `AntiCheatFile NEP2.dll` — after FrameLedger had measured that game hooked (three
|
||||
normal Tier-1 sessions in the owner's ledger, 474,143 frames). The owner asked for a way to keep measuring a game like
|
||||
that, and chose, against the rule this document had kept since 2026-09-22 and with that rule quoted back to them, **an
|
||||
exception the user grants per game, bound to evidence, and only for anti-cheat that is user-mode throughout.** The
|
||||
reasons D22 withdrew the override are answered one by one: it "did nothing where it was wanted" — ~~an exception is only
|
||||
offered where FrameLedger has already measured the game hooked~~ *(D38 below: the measurement now comes under the grant,
|
||||
as its trial)*; it "only exposed the user to the risk its own disclosure described" — that risk stands, and the disclosure
|
||||
says so, including that a ban can arrive days later and that FrameLedger cannot know.
|
||||
|
||||
> **Amended 2026-10-03 (owner decision D38): the evidence comes after the grant, as a trial.** The owner deleted their
|
||||
> ledger and found *GIRLS' FRONTLINE 2* "Not eligible: 0 successful hooked session(s), two are needed" — for good. The rule
|
||||
> below was a catch-22 for every game it could ever meet again: since beta.8 the library sweep blocks a game the moment
|
||||
> it is added, a blocked game is never hooked without a grant (`CaptureSession` sends it to Tier 2 before the resolver),
|
||||
> so it can never earn the two sessions, and a reset ledger loses the ones it had. D33's evidence was reachable only for a
|
||||
> game measured before its block, and only while those rows lasted. Asked with that, the owner chose: **a grant needs no
|
||||
> session; the first two hooked sessions under it are a trial; any of them that does not go well ends the exception for
|
||||
> good** (`games.ac_exception_trial_failed_at`, schema 0017, which nothing clears). Every other condition is unchanged.
|
||||
|
||||
**What may be excepted — all of it must hold:**
|
||||
|
||||
- every finding about the game is `BlockedModule`, `AntiCheatFile` or `AntiCheatDirectory` of **one** family;
|
||||
- that family's whole footprint is user-mode — no `drivers` entry, no `services` entry and no `*.sys` among its `files`, in
|
||||
the compiled floor or the rules file (`fl::guard::FamilyIsUserModeOnly`). The floor cannot be shrunk, so data can make a
|
||||
family kernel-level and never the reverse. On today's data that leaves NetEase Yidun, AhnLab HackShield, Anybrain and
|
||||
FredaikisAntiCheat; 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
|
||||
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`
|
||||
(which since beta.8 includes End task's exit code 1 and a user's stop), never crashed, never unhooked for safety.~~
|
||||
**Since D38 (2026-10-03): no session is needed** — and no exception of the game has ever ended during its trial
|
||||
(`ac_exception_trial_failed_at` is NULL).
|
||||
|
||||
**Never excepted, whatever the user ticked:** a machine-wide `BlockedDriver` or `BlockedService`, the fuzzy tier
|
||||
(`SuspiciousUnsigned`), a scan that could not look or finish, unusable rules, `TargetUnreadable` (D21), a 32-bit target,
|
||||
the kill switch, and a Vulkan target (the implicit layer's own self-scan stays strict).
|
||||
|
||||
**How the guard takes it.** The four evaluating ABI entries carry `toleratedFamilies` — a NAME, never evidence
|
||||
(`fl_guard_abi.h`). The guard resolves it against its own rules (`ResolveTolerance`), keeps only a user-mode family,
|
||||
runs every check, lets that family's modules, files and folders through **and keeps scanning past them**, so a second
|
||||
family, a suspicious module or a `.sys` further in still refuses. A pass that let something through is
|
||||
`kAllowedUserModeException` (reason 28, the slot the withdrawn bypass left) with the family and the signal; the session it
|
||||
starts is marked with them.
|
||||
|
||||
**How the Overlay takes it.** The Overlay stops observing when a floor module loads after injection, so the Agent
|
||||
publishes the exception's family names in `Local\FrameLedger.Tolerate.<pid>` (`fl_tolerance.h`) before it asks the guard
|
||||
to inject, and the Overlay's init thread reads them once, before its loader detour exists — resolving each against its
|
||||
own compiled floor and honouring only a user-mode family. A mapping that names anything else tolerates nothing, and the
|
||||
Agent's 30 s re-scan keeps judging every other signal.
|
||||
|
||||
**What ends it.** A new finding outside the excepted family at any of the four moments above writes the block as before
|
||||
and revokes the exception; a session under it that crashes, is unhooked for safety or is stopped by the Overlay's
|
||||
in-process floor stop revokes it; an executable change ends it with the consent it shared a fingerprint with; turning
|
||||
the option off suspends every exception. **The block itself is never cleared** — the exception is a separate layer over
|
||||
it, and the finding stays on the game's page (FR-2.2).
|
||||
|
||||
**The trial (D38).** Until two sessions under a grant have succeeded — hooked, stored, frames recorded, `normal`
|
||||
(`ISessionRepository.CountSuccessfulUnderGrantAsync`: under that family, started at or after the grant) — the grant is in
|
||||
its trial, and the App says so ("trial: 1 of 2"). During the trial **any** end of the list above ends the exception
|
||||
**for good**, and so does a stored hooked session that recorded no frame or did not end normally
|
||||
(`UserModeExceptionLapse.TrialFailed`, decided by `UserModeExceptionLapsePolicy` when the recorder stores the row): the
|
||||
end is recorded with its own reason and `ac_exception_trial_failed_at` is set. While it is set the sweep writes the game
|
||||
not eligible, the Agent refuses a grant (`Refused.reason = TrialFailed`, the signal is when) and the store refuses one in
|
||||
SQL; withdrawing, a game update, *Change executable* and a twin merge all keep it. A session too short to be stored, or
|
||||
one that was never hooked, proves nothing either way and is not judged. After the trial, an end is what it was under
|
||||
D33: the exception may be made again once the sweep finds the game eligible. Deleting sessions can only lengthen a trial
|
||||
— the count is read, never stored as a grant's own fact.
|
||||
|
||||
**What it is not.** Not a bypass of a live refusal, not a global switch (a Settings option off by default enables the list,
|
||||
and the user ticks each game), not reachable from the command line, and not evasion: the DLL stays `LoadLibraryW`-loaded,
|
||||
named and visible (rule 3). `InjectViaLoadLibrary` still has internal linkage in `fl_guard.cpp`; `tools/chokepoint-check.ps1`
|
||||
is unchanged.
|
||||
|
||||
*Built in beta.9. PR-1: the guard's tolerance and the Overlay's channel. PR-2: the Agent — the option
|
||||
(`hooking.usermode_ac_exceptions`, off), the sweep's eligibility pass (a tolerant pre-scan keyed on the rules, the
|
||||
executable and the block; the session count every pass), the `SetAntiCheatException` command (the Agent gathers the
|
||||
facts itself; the store applies the rule), the gate's one branch with the channel published before the request, the
|
||||
re-scans naming the family, the session's mark, and every end (`UserModeExceptionLapse`) — schema 0014. PR-3: the
|
||||
option and the list in Settings, the versioned disclosure (`Safety_Exception_*`, `AntiCheatExceptionDisclosure`), the
|
||||
game page's exception card and its usable switch under an exception in force, the marks, and the legal text
|
||||
(Disclaimer §2A 2.7, EULA 1.3, the accuracy block, SECURITY.md) — `08_UI` §Games.*
|
||||
|
||||
*D38 in beta.11 (2026-10-03): `UserModeExceptionRules.TrialSessions` replaces `RequiredSessions`; eligibility is the
|
||||
guard's answer and the trial mark; `ac_exception_sessions` is the trial's progress; schema 0017
|
||||
(`ac_exception_trial_failed_at`); `Refused.reason` `TrialFailed` replaces `TooFewSessions`; the disclosure is
|
||||
`ac-exception-dialog/2` (its `Why` names no count, a new `Trial` paragraph); the Settings list shows only games it can act
|
||||
on; and a sweep that cannot read the executable answers "could not verify" instead of leaving the row "checking" for ever.
|
||||
Legal text: Disclaimer §2A 2.9, EULA 1.4, the accuracy block, SECURITY.md, LIMITATIONS.md.*
|
||||
|
||||
|
||||
### The floor data cannot remove
|
||||
|
||||
**There was a local bypass, and this paragraph is the reason it no longer works
|
||||
@@ -616,6 +719,7 @@ normative documentation. Write tokens here exactly as the data must hold them.
|
||||
| Activision Ricochet | `files` | name | `randgrid.sys` | 2026-09-25 |
|
||||
| FredaikisAntiCheat | `directories` | name | `FredaikisAntiCheat` | 2026-09-25 |
|
||||
| **Valve VAC** | — | — | ~~**No data yet** — needs `blockedStoreIds`, whose half of check 3 **cannot be called**~~ **Per-title lists since 2026-09-25** (check 3): 13 Steam app ids and 8 executables, the store half wired. VAC runs inside Steam, so no module, driver or file of the game's own can name it — this row stays a dash on purpose. (**Measured 2026-08-04: a real VAC title returned `Allow`**, `spike-notes.md` §13 — the gap these lists close.) | 2026-09-25 |
|
||||
| **CrackProof** | — | — | **Per-title list since 2026-10-03** (check 3, rules `2026.10.1`): 3 Steam app ids, no executables. Its kernel driver loads from `System32` under a numbered name, so no module, driver or file of the game's own can name it — this row stays a dash on purpose, like VAC's. | 2026-10-03 |
|
||||
|
||||
The "no data yet" rows are deliberately kept rather than deleted. An admitted
|
||||
gap is reviewable; a deleted row is invisible. ~~Activision Ricochet's was one of them~~ — it has data since
|
||||
@@ -797,6 +901,26 @@ injected or layered**.
|
||||
|
||||
If `OpenProcess` with the needed rights fails (protected process, higher integrity), do **not** escalate creatively. Report "cannot attach" and offer Tier-2. Never attempt to acquire privileges beyond running the Agent elevated at the user's explicit request.
|
||||
|
||||
> **The explicit request exists since beta.10 (owner decision D34, 2026-09-27): the admin mode.** An option off by default,
|
||||
> turned on through a versioned disclosure (`Safety_AdminMode_*`, `agent-admin-dialog/1`) that states what it adds, what it
|
||||
> does not change, how Windows asks and the risk of a per-user install; then **Windows asks at every start of the Agent**
|
||||
> (`01_ARCHITECTURE` ADR-9). What it does NOT do, each held by code rather than by this paragraph:
|
||||
>
|
||||
> - **It clears no finding and opens no protected process.** The guard runs exactly as unelevated: the driver scan asks
|
||||
> `NtQuerySystemInformation`, and a process an anti-cheat driver protects stays `TargetUnreadable` (D21) — elevation turns
|
||||
> "could not look" into an answer only where Windows would give any administrator one.
|
||||
> - **It enables no privilege.** An elevated token holds `SeDebugPrivilege` and `SeLoadDriverPrivilege` disabled and they
|
||||
> stay so: `AdjustTokenPrivileges`, `RtlAdjustPrivilege`, `EnterDebugMode` and the debug privilege's name may not appear
|
||||
> under `src/` (`tools/chokepoint-check.ps1`), and `PrivilegeFootprintTests` asserts on the elevated CI runner that opening
|
||||
> targets and LibreHardwareMonitor's CPU group enabled none.
|
||||
> - **It elevates no game.** A game started from FrameLedger gets the desktop shell's token (`UnelevatedProcess`); with no
|
||||
> shell to take one from, the launch is refused with that reason (`Launch_Error_1400`), never made elevated instead.
|
||||
> - **It is not silent.** Every start asks; a start that was declined serves as a standard user and says so; the prompt
|
||||
> answered by another account ends that Agent before it touches anything (exit 11).
|
||||
>
|
||||
> The residual risk is stated to the user, not solved: FrameLedger installs per user and unsigned, so a program running
|
||||
> under the account could replace its files and be run as administrator the next time the user accepts the prompt.
|
||||
|
||||
## User-facing consent
|
||||
|
||||
Enabling hooking is a **per-game** action, gated by a one-time dialog per game that states, in plain language:
|
||||
|
||||
@@ -40,6 +40,18 @@ Rules for this document:
|
||||
> where it could inject it only exposed the user. The owner asked for the opposite: a finding turns the game's hooking
|
||||
> off, wherever the guard makes it. `19_SAFETY` §What a finding does to the game is the specification; CLAUDE.md rule 2 is
|
||||
> unstruck. The two open items above (kernel-level families, the ja text) are moot.
|
||||
>
|
||||
> **2026-09-26 — one narrow exception, by owner decision D33, with the 2026-09-22 withdrawal quoted back.** Beta.8's
|
||||
> library sweep blocked a game FrameLedger had measured hooked (GIRLS' FRONTLINE 2: EXILIUM, NetEase Yidun `NEP2.dll`),
|
||||
> and the owner chose an evidence-bound, per-game exception for anti-cheat that is user-mode throughout (`19_SAFETY`
|
||||
> §The user-mode exception; CLAUDE.md rule 2's amendment). The two reasons D22 gave are answered: it is offered only
|
||||
> where FrameLedger has already measured the game hooked, and its risk is stated in its own disclosure. *(2026-10-03,
|
||||
> D38: the first of the two no longer holds as written — a game blocked at add time could never be measured, so the
|
||||
> measurement moved under the grant as a two-session trial whose failure is for good.)* **What stays
|
||||
> open, and is the owner's:** the `ja` text of `Safety_Exception_*`, which ships as English until a reviewer signs;
|
||||
> whether a family the rules file makes kernel-level later should end existing exceptions at once (today it does, at
|
||||
> the sweep's next pass and at every session start); and a real-hardware check that NEP2.dll's load time relative to
|
||||
> the injection is covered on the owner's machine (the ctest decoy covers the late load).
|
||||
|
||||
| # | Decision | Consequence |
|
||||
|---|---|---|
|
||||
@@ -94,7 +106,7 @@ or it becomes the next stale status claim this file exists to record.
|
||||
| **S1** | ◐ **launch mode built as "inject late" 2026-09-06 (P1 item 2); the cost is now measured per title** | `FlGuardedInjectWhenReady` polls until a presentation runtime is mapped, then runs the full guard; `dxgiPresentsBeforeHook` and the reported wait are the input the 2026-08-05 deferral lacked. The ruling "inject late vs. no launch mode" is answered by construction — inject late exists — and whether it is *preferred* per title is what the numbers decide |
|
||||
| **S13(c)** | ✅ **salvageable, and salvaged 2026-09-06** | The externally observable proxy the entry proposed is what was built; the missing input is produced by every launched session |
|
||||
| **S19(b)** | 🅓 **deferred, rationale written — and MEASURED** | CI 2026-08-05: the fragment fires on `System.Security.Cryptography.ProtectedData.dll` loaded by a .NET **test host**, i.e. inside a real scan set in the launch-mode arrangement — refusing our own injection. The entry's "plausible and unmeasured" is superseded; the deferral rationale (a `CryptCATAdmin*` PR doing network I/O inside the hard gate, NFR-10) still stands. *(Marked 🔴 until 2026-08-27. The measurement belongs in this cell, not in the marker — a glyph that means "deferred" and a glyph that means "open defect" cannot be the same one in a table audited by counting.)* |
|
||||
| **S14** | ✅ **both halves wired and seeded 2026-09-25** (exe half 2026-08-05) | ~~The store-id half's only in-policy route is P4's platform metadata extractors feeding a guard-side resolver~~ — built as a guard-side seam that reads Steam's `appmanifest_*.acf` and GOG's `goggame-<id>.info` itself; an install no store names is not refused, unreadable store metadata is. 30 Steam ids and 33 executables listed (rules 2026.09.4), floored. Epic has no reader |
|
||||
| **S14** | ✅ **both halves wired and seeded 2026-09-25** (exe half 2026-08-05) | ~~The store-id half's only in-policy route is P4's platform metadata extractors feeding a guard-side resolver~~ — built as a guard-side seam that reads Steam's `appmanifest_*.acf` and GOG's `goggame-<id>.info` itself; an install no store names is not refused, unreadable store metadata is. 30 Steam ids and 33 executables listed (rules 2026.09.4), floored; 33 Steam ids since 2026-10-03 (rules 2026.10.1: three CrackProof titles, `19_SAFETY` check 3). Epic has no reader |
|
||||
| **S23-1** | ✅ **resolved 2026-08-05** | `FlGuardBuildId` gives the Agent a build id of its own, and `ShmHandshakeValidator` performs the comparison `07_IPC` and `04_CAPTURE` both specify. Every refusal path is driven, including **both ids empty** — the shape the feature shipped in, where `"" == ""` reported `Ok` for every process on the machine |
|
||||
| **S23-4** | ✅ **resolved 2026-08-05** | `19_SAFETY` §During a session said "the module scan and the driver scan"; `EvaluateImpl` runs four. Reworded to "every pre-injection check" so it cannot go stale when a check is added, with the two omissions named — `services` is the only tier measured firing on real anti-cheat, and the pre-scan is the only one touching the filesystem |
|
||||
| **S2 part three** | ✅ **built 2026-09-06 (P1 item 3)** | In-layer supervision on the present path, landed with `vkQueuePresentKHR`; `unhookRequested` and the tick deadline both stop the layer (passthrough with the reason on the mapping), proven by a fake loader chain and a 1.5 s test-only flavour of the DLL |
|
||||
@@ -4338,7 +4350,7 @@ Each of these is referenced by an existing doc but specified nowhere.
|
||||
|
||||
| Area | What is missing | Referenced by |
|
||||
|---|---|---|
|
||||
| **Agent lifecycle** | Scheduled-task definition, start-at-logon, how elevation is requested and persisted, what "Repair" repairs. **`--serve` exists since 2026-09-10 (P2 PR-F)** — a Generic Host around the watcher, stopped by Ctrl+C with a 15 s finalize grace — and `--install-task` / `--uninstall-task` answer "not implemented in P2"; the task definition and start-at-logon are what stays open. **One Agent per data folder since 2026-09-17** (`01_ARCHITECTURE` §Lifecycle: `AgentInstanceLock`, exit 10; beta.1 ran four after an elevated App was refused by the pipe). **Still open from that morning:** (1) the ring's single consumer is enforced across data folders only by `NoSecondRingReaderTests`' source sweep — a developer's `--console --data-dir` capture beside the installed Agent can still attach a second reader to one game's `Local\FrameLedger.Ring.<pid>`, and a runtime claim beside the mapping would close it; (2) elevation is inherited, not chosen — an App started as administrator starts an elevated Agent, which injects and writes the ledger as administrator | `08_UI` Settings, `11_UPDATER`, `12_BUILD` flags |
|
||||
| **Agent lifecycle** | Scheduled-task definition, start-at-logon, how elevation is requested and persisted, what "Repair" repairs. **`--serve` exists since 2026-09-10 (P2 PR-F)** — a Generic Host around the watcher, stopped by Ctrl+C with a 15 s finalize grace — and `--install-task` / `--uninstall-task` answer "not implemented in P2"; the task definition and start-at-logon are what stays open. **One Agent per data folder since 2026-09-17** (`01_ARCHITECTURE` §Lifecycle: `AgentInstanceLock`, exit 10; beta.1 ran four after an elevated App was refused by the pipe). **Still open from that morning:** (1) the ring's single consumer is enforced across data folders only by `NoSecondRingReaderTests`' source sweep — a developer's `--console --data-dir` capture beside the installed Agent can still attach a second reader to one game's `Local\FrameLedger.Ring.<pid>`, and a runtime claim beside the mapping would close it; (2) ~~elevation is inherited, not chosen — an App started as administrator starts an elevated Agent, which injects and writes the ledger as administrator~~ **closed 2026-09-27 (beta.10, owner decision D34): chosen** — `capture.run_elevated`, a UAC prompt at every Agent start, the logon task's Agent asking through its own prompt, and with the option off an administrator's App starts the Agent with the shell's token (`01_ARCHITECTURE` ADR-9). "How elevation is requested and persisted" is that: requested by the prompt, persisted as one settings row and never as a task's run level | `08_UI` Settings, `11_UPDATER`, `12_BUILD` flags |
|
||||
| **Session identity** | ~~`sessions` has no GUID column, yet `SessionStarted`/`StopSession`/`.partial` files are all keyed by `sessionGuid`.~~ **`sessions.session_guid` (UNIQUE) exists since 2026-09-09 (P2 PR-B), with `qpc_epoch` / `qpc_frequency` beside it.** ~~Still open: the `.partial` file format is undefined, and it is the crash-recovery artifact — PR-D's, pre-committed in HANDOFF §P2 (CRC-framed append-only chunks, the valid prefix wins)~~ **Built 2026-09-10 (P2 PR-D): `06_DATA_MODEL` §The `.partial` file, `PartialSessionFile` + `PartialRecovery`, killed at every byte in the merge gate.** What stays open here is the pipe's use of the guid (P3) | `07_IPC`, `04_CAPTURE`, `06_DATA_MODEL` |
|
||||
| ~~**Settings registry**~~ | ~~The `settings` table is key/value with no key list, defaults, types, or validation — and no message for the UI to push a changed setting to the Agent.~~ **Decided 2026-09-13 (HANDOFF §P3 decision D16)**: the key list with defaults and ranges, and *no* push message — the Agent re-reads its keys at each session start. **Built the same day (P3 PR-3):** `06_DATA_MODEL` §Settings registry (12 keys), `Application.Settings.SettingsRegistry` + `RegisteredSettings` (validating writes, tolerant reads), `SettingsRecorderPolicy` resolving `capture.min_session_s` / `telemetry.interval_ms` / `retention.raw_sessions_per_game` at each session start. **Row closed** | `06_DATA_MODEL`, FR-10 |
|
||||
| **Error taxonomy** | `07_IPC` lists `CaptureError` codes; no canonical mapping to resx keys and user-facing text, though `09_I18N` requires safety strings to be reviewed as legal text | `07_IPC`, `09_I18N` |
|
||||
|
||||
+134
-6
@@ -746,8 +746,11 @@ Cyberpunk 2077 never chains `sl::DLSSOptions`, so 0xFF there is the title's trut
|
||||
call, and if built, the byte stays 0xFF and the report says *derived*.
|
||||
- **Do not** reach for `slDLSSSetOptions` via `slGetFeatureFunction`: §2b refused it on five
|
||||
grounds that have not changed, and NGX-direct `NVSDK_NGX_Parameter_GetUI` is licence-blocked.
|
||||
- **Alan Wake 2 did not run on 2026-09-04** (the owner tried every workaround; the title is
|
||||
broken on this machine), so the measurement moved to **Dying Light: The Beast at DLSS**, the
|
||||
- ~~**Alan Wake 2 did not run on 2026-09-04** (the owner tried every workaround; the title is
|
||||
broken on this machine)~~ **Corrected 2026-09-27 (owner):** it did run late that evening — the run reports
|
||||
`alanwake2-224851` and `alanwake2-230707` hold two captures (DLSS + RR, ray tracing *Yes*, 92.52 FPS; then ray
|
||||
tracing off, Presented 114.52), neither with the quality preset, which is what this item needed. The earlier
|
||||
attempts that day failed, so the measurement moved to **Dying Light: The Beast at DLSS**, the
|
||||
first Streamline title measured whose batches carry `kFeatureDLSS` — identity `Dlss` on 4,575
|
||||
of 4,575 batches. It read `UpscalerParams = 0` on three captures, because DL:TB ships
|
||||
**Streamline 2.8.0, which deprecates `slSetTag` for `slSetTagForFrame`**, and only the
|
||||
@@ -1310,9 +1313,13 @@ charts (6) after Games (5) because the summary opens from the Sessions tab; Sett
|
||||
(`PipeTransmissionMode.Message`, `PipeOptions.Asynchronous | CurrentUserOnly`, remote clients rejected,
|
||||
two instances), the ACL a `PipeSecurity` of the current user's SID plus Administrators~~ **`CreateNamedPipe`
|
||||
itself (CsWin32), so the flags and the DACL are stated in code rather than left to a library default:**
|
||||
message mode, overlapped, `PIPE_REJECT_REMOTE_CLIENTS`, two instances, the SDDL `D:P(A;;GA;;;<user>)(A;;GA;;;BA)`
|
||||
on every instance, and the client's token user compared to the server's by impersonation on the client's
|
||||
first frame (the kernel refuses it earlier). The CLIENT uses `PipeOptions.CurrentUserOnly`. *(As built
|
||||
message mode, overlapped, `PIPE_REJECT_REMOTE_CLIENTS`, two instances, the SDDL ~~`D:P(A;;GA;;;<user>)(A;;GA;;;BA)`~~
|
||||
`O:<user>D:P(A;;GA;;;<user>)(A;;GA;;;BA)` (the owner stated since 2026-09-17) on every instance, and the client's
|
||||
token user compared to the server's by impersonation on the client's first frame (the kernel refuses it earlier).
|
||||
The CLIENT ~~uses `PipeOptions.CurrentUserOnly`~~ checks the pipe's owner against its own token USER
|
||||
(`PipeAccessControl.RequireOwnedByCurrentUser`, 2026-09-17) — `CurrentUserOnly` compares the token's default owner,
|
||||
which an elevated token sets to Administrators, and refused the same user's Agent across elevation (corrected
|
||||
2026-09-27). *(As built
|
||||
2026-09-13; the wording above was the plan's, kept struck because it named a library path the build did not
|
||||
take.)* Framing is
|
||||
`07_IPC` §C as written: 4-byte LE length + UTF-8 JSON ≤ 1 MB, `Shared.Ipc.IpcEnvelope { type, id?, payload }`,
|
||||
@@ -1558,7 +1565,7 @@ và legal"), so the Legal Gate shows both once.
|
||||
|
||||
## 2026-09-25 — the beta.8 train
|
||||
|
||||
*Status is `CHANGELOG.md` `[Unreleased]` (then `[0.1.0-beta.8]`); this is what no other file carries. The owner's list
|
||||
*Status is `CHANGELOG.md` `[0.1.0-beta.8]`; this is what no other file carries. The owner's list
|
||||
(eight items: the anti-cheat set as large and strict as possible, hiding the hook part for anti-cheat games, more
|
||||
metadata, NVIDIA App overrides, clearer reasons, a working Trend, FPS decimals, chart fixes) is planned as nine PRs in
|
||||
one approved plan; each PR cites it.*
|
||||
@@ -1640,6 +1647,110 @@ only be refused, never the finding (FR-2.2).
|
||||
64-bit build of the same game under *Change executable* can be hooked; the sweep's turn-off uses
|
||||
`hook_autodisabled_reason`, which the page does not offer to undo while the file is still 32-bit.
|
||||
|
||||
## 2026-09-26 — the beta.9 train: the user-mode exception (D33)
|
||||
|
||||
*Status is `CHANGELOG.md` `[0.1.0-beta.9]`; this is what no other file carries. The approved plan
|
||||
is four PRs: PR-1 the guard's tolerance and the Overlay's channel, PR-2 the Agent (eligibility, gate, records, schema
|
||||
0014, IPC), PR-3 the App, strings, docs and legal text, PR-4 the release.*
|
||||
|
||||
**Decision (D33, owner, 2026-09-26, asked with rule 2 and D22 quoted back).** The beta.8 sweep turned hooking off for
|
||||
GIRLS' FRONTLINE 2: EXILIUM (NetEase Yidun, `AntiCheatFile NEP2.dll`, a documented and unmeasured rule) after it had
|
||||
been measured hooked; the owner asked for an exception list for user-mode anti-cheat games measured at Tier 1 before.
|
||||
Chosen, all four options as recommended: **evidence-bound, per game** (a Settings option off by default, then the user
|
||||
ticks each eligible game); **≥ 2 successful Tier-1 sessions**; **Aniimo stays blocked** (it unpacks `NEPKernel.sys` beside
|
||||
`NEP2.dll` — the D30 `.sys` rule is never excepted); **the legal text changes** (Disclaimer §2A 2.7, EULA 1.3, the
|
||||
accuracy block, SECURITY.md, FR-2.3; Privacy stays 2.4). Eligibility, what is never excepted and every lapse are in
|
||||
`19_SAFETY` §The user-mode exception; the rule-2 amendment is in CLAUDE.md.
|
||||
|
||||
**Evidence it rests on (read from a COPY of the owner's ledger and their logs, 2026-09-26).** GF2: three normal Tier-1
|
||||
sessions under the current entry (474,143 frames; three more from 2026-09-21 went with a removed entry), no `.sys` in
|
||||
its tree. Aniimo: one Tier-1 session stored `crashed` (End task before beta.8, no exit code kept). A randomly named
|
||||
kernel driver (`lyoxztfx.sys`) was installed on 2026-09-21 at 15:38 and is gone now, service and file, by something
|
||||
the logs cannot name — the residual the disclosure states: a driver outside the game folder that no rule names is
|
||||
invisible to every check.
|
||||
|
||||
**Traps met on the way:**
|
||||
- **The ring cannot carry anything the Overlay needs before its detour is armed** — the Overlay creates it. Hence the
|
||||
separate `Local\FrameLedger.Tolerate.<pid>` mapping the Agent creates BEFORE the injection (`fl_tolerance.h`).
|
||||
- **A tolerant scan must keep scanning.** Every sink that used to stop at the first hit returns `true` on a tolerated
|
||||
one, or a second family / a `.sys` further in would pass: the same load-order fail-open §S22(b) closed for the
|
||||
exemption.
|
||||
- **A prefix value of a user-mode family can match a `.sys`**; the tolerant file sink refuses any `.sys` itself.
|
||||
- **CA2101 rejects `[MarshalAs(LPUTF8Str)] string`** on a P/Invoke; the tolerance crosses as NUL-terminated UTF-8
|
||||
`byte[]`, the shape `FlGuardCheckRules` already used.
|
||||
- **The Vulkan branch evaluates strictly**: the layer's self-scan goes inert on any anti-cheat module, so an exception
|
||||
there could only buy a session that measures nothing.
|
||||
- **An elevated Agent's default DACL omits the user** (`PipeAccessControl`'s remarks): a tolerance mapping created with
|
||||
it could not be opened by the Overlay in an unelevated game, and the exception would fail as the Overlay's own stop.
|
||||
`OverlayToleranceChannel` states `O:<user>D:P(A;;GR;;;<user>)`; a test proves the user can read it and nobody can
|
||||
open it to write.
|
||||
- **`hook_enabled` can be 1 on a blocked row now** — only because an exception once applied. `CaptureSession.RunAsync`
|
||||
therefore treats a blocked row whose exception does not apply right now as hooking-off BEFORE the resolver opens
|
||||
anything, or the option off would reopen the Borderless-Gaming problem of 2026-09-22.
|
||||
- **The store applies the eligibility rule itself** (`GrantAntiCheatExceptionAsync` answers `NotEligible`), and the
|
||||
grant and the eligibility are bound in SQL to the block text they were reached about: a block rewritten between the
|
||||
read and the write leaves the row alone. SQLite evaluates every `SET` from the old row, which is what lets
|
||||
`ChangeExecutableAsync`'s `CASE WHEN ac_exception_at IS NOT NULL` record the end of the grant it clears.
|
||||
- **CA1711 rejects a type whose name ends in `Exception`**: the rules class is `UserModeExceptionRules`, the reasons
|
||||
`UserModeExceptionLapse`.
|
||||
|
||||
## 2026-09-27 — the beta.10 train: the display mode, the admin mode, the Unreal Engine version
|
||||
|
||||
*Status is `CHANGELOG.md` `[0.1.0-beta.10]`; this is what no other file carries. The approved plan was six PRs:
|
||||
PR-1 the Unreal version (schema 0015), PR-2 the Overlay's display region (shared-memory layout 4), PR-3 the display mode
|
||||
in the Agent and the App (schema 0016), PR-4 the admin mode, PR-5 docs, legal text and the tested-games list, PR-6 the
|
||||
release.*
|
||||
|
||||
**Decisions (owner, 2026-09-27, asked before the plan — do not re-ask):**
|
||||
|
||||
- **D34 — the admin mode asks Windows at EVERY Agent start.** The UAC prompt appears whenever the Agent starts with
|
||||
`capture.run_elevated` on — owned by the App's window when the App starts it, flashing on the taskbar when the logon
|
||||
task does. No "highest privileges" task, no service, no silent path. Games an elevated Agent starts get the desktop
|
||||
shell's token. The elevated Agent is started for one user (`--for-user <SID>`) and exits 11 as any other account.
|
||||
- **D35 — the tested-games list comes from a COPY of the owner's ledger** (scratchpad, Python `sqlite3`; never a
|
||||
FrameLedger binary against the data folder) plus the repository's own evidence, and **the owner reviews it before it
|
||||
is committed** — the repository is public.
|
||||
- **D36 — legal text changes where it would become false** (Privacy 2.5, Disclaimer 2.8; EULA stays 1.3), **and
|
||||
`LIMITATIONS.md` exists**: a user-facing list of what the WHOLE software cannot do, at the repository root and in the
|
||||
App under Help ▸ Limitations — not one of FR-11's accepted documents (the Legal Gate records an acceptance per
|
||||
document, and this is information, not terms).
|
||||
- **D37 — each PR merges when its CI is green**, then the release PR and the GPG-signed tag.
|
||||
|
||||
**What was measured before it was written:**
|
||||
|
||||
- **Unreal versions, ten installed titles, read-only** (`spike-notes` §15): eight read (4.26.1 … 5.5.4), two honestly
|
||||
none (Cronos demo, Rune Factory). Black Myth: Wukong's executable is protected (`.rdata` empty) and its build name sits
|
||||
in `.code` — the whole-file fallback read it in 7.5 s from the owner's USB drive.
|
||||
- **The display region's cost** (hook-harness `--probe-frames`, WARP): `GetFullscreenState` 12.6–13.1 ns, `GetDesc`
|
||||
13.6–14.5 ns per call, at most twice a second per swap chain.
|
||||
|
||||
**Traps met on the way:**
|
||||
|
||||
- **A test run reseeds the rules file in the REAL data folder** (`RulesSeeder` in the integration tests writes
|
||||
`%LOCALAPPDATA%\FrameLedger\rules`). PR-1's rules `2026.09.6` carry an extractor type (`unreal_build`) the installed
|
||||
beta.9 cannot parse: its detection sweep says "rules unusable" until that Agent restarts — its seeder sees a file it
|
||||
wrote itself (the marker's hash) and puts its own back — or beta.10 is installed. The guard reads the same file and is
|
||||
unaffected (it ignores version extractors). Worth a scratch rules folder for the tests one day.
|
||||
- **`DXGI_SWAP_EFFECT_DISCARD` is 0** — region 4 stores the effect plus one, the vendor-zero trap.
|
||||
- **A minimised game presents only what the hook drops** (occlusion probes): a region-4 sample older than 2 s says
|
||||
nothing about exclusivity now; the Agent keeps its window and drops its exclusive bits.
|
||||
- **The Agent is DPI-unaware**: Windows scales another process's window coordinates for it. The window reader switches
|
||||
its thread to per-monitor-aware (V2) for the calls and back.
|
||||
- **A Tier-2 session never reaches the aggregator** — display columns live on the recorder's skeleton, or a Tier-2 row
|
||||
would carry none.
|
||||
- **`SessionRowColumns` is generated by a script that is not in the repository** — edit it by hand, by name.
|
||||
- **`CreateProcessWithTokenW` needs `SeImpersonatePrivilege`**, which an unelevated (filtered) token does not hold: the
|
||||
shell-token start is testable only on the elevated CI runner, and a runner with UAC off has an elevated shell — so the
|
||||
test compares the child's elevation with the SHELL's, never with "unelevated".
|
||||
- **An elevated token's default DACL omits the user** (again): the ledger's migration lock is now a `SharedMutex` with a
|
||||
stated descriptor; the instance lock and the elevation marker are only probed, and a refused probe reads as held.
|
||||
- **`CA2025` flags a disposable handed to an un-awaited task** even when ownership moves to it; the launcher says so in
|
||||
a suppression with its reason, or splits the method so the analyzer can see it.
|
||||
- **Heredocs mangle backslashes and `\a`** (`D:\another` became `D:<BEL>nother` in a test). Patch scripts are written
|
||||
with the Write tool and run by path; a scan for control characters before the gate catches the rest.
|
||||
|
||||
**Owner-only, added to the list below:** item 7.
|
||||
|
||||
## Owner-only — no PR can close these
|
||||
|
||||
1. **§S23-2 — branch protection.** `Rules / validate` is not a required status check on
|
||||
@@ -1665,6 +1776,23 @@ only be refused, never the finding (FR-2.2).
|
||||
5. **Re-ratify §S18 blocker 3 and §S27's basis** once P2's PR-C/PR-F make the Agent the shipped
|
||||
injecting entry point (§P2, decision D4). The PRs restate both entries; whether the
|
||||
restatement stands is the owner's.
|
||||
6. ~~**D33's first real use (beta.9).**~~ **Done by 2026-09-27, read from a copy of the owner's ledger:** three normal
|
||||
hooked sessions of GIRLS' FRONTLINE 2 under the exception (NetEase Yidun) on 2026-09-26 and 09-27, the longest
|
||||
3 h 9 min; the `ja` review below is still owed. *(The item as written:)* Turn the option on; GIRLS' FRONTLINE 2 should be listed eligible (NetEase
|
||||
Yidun, `NEP2.dll`, three sessions); make the exception, turn hooking on and play one session: hooked, marked
|
||||
*Hooked · exception*, not stopped by the 30 s re-scan or by the Overlay when `NEP2.dll` loads. Aniimo should read
|
||||
*not eligible* with its `NEPKernel.sys`; the option off makes the next session Tier 2 with the exception kept. And
|
||||
the `ja` text of `Safety_Exception_*`, which ships as English until a reviewer signs.
|
||||
7. **beta.10 on real hardware.** (a) **The display mode:** one DXGI game taken through exclusive full-screen →
|
||||
borderless → windowed in one session — the summary's shares, the Sessions column, the Trend's three share metrics —
|
||||
with a note of what the game's own menu called each mode. (b) **The admin mode:** turn it on → the disclosure → the
|
||||
UAC prompt → Settings says *Running elevated*; decline it → *the administrator prompt was declined*; sign out and in
|
||||
with the logon task → the prompt waits on the taskbar and one Agent results; start a game from FrameLedger while
|
||||
elevated → Task Manager's *Elevated* column says *No*; a game that runs as administrator → hooked; the CPU temperature
|
||||
with PawnIO (closes §M10 if it reads). (c) **The Unreal Engine version** on each Unreal game's page. (d) The Legal
|
||||
Gate shows Privacy 2.5 and Disclaimer 2.8 once. (e) The `ja` text of `Safety_AdminMode_*`, English until reviewed.
|
||||
(f) `docs/LIST_GAME_TESTED.md` — reviewed and approved by the owner before it was committed (D35, 2026-09-27);
|
||||
keep it current as games are run.
|
||||
|
||||
**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
|
||||
|
||||
@@ -0,0 +1,71 @@
|
||||
# Games FrameLedger has been run with
|
||||
|
||||
*As of 2026-09-27 (0.1.0-beta.10). Built from a copy of the developer's own FrameLedger database and the repository's
|
||||
measurement notes, and reviewed by the project's owner before it was published. It lists what happened on one machine;
|
||||
it promises nothing about any other.*
|
||||
|
||||
**The machine.** Every row below was run on one PC: an NVIDIA GeForce RTX 5080 (the only graphics card), an Intel Core
|
||||
i7-14700KF, 32 GB of DDR5, Windows 11 (Insider builds 26300 → 29648) and a 2560×1440, 240 Hz monitor. **No AMD or Intel
|
||||
graphics card and no second machine has been tested**, and **no real Vulkan or OpenGL game has been measured** — every
|
||||
measurement below is Direct3D 11 or 12. What the tiers mean and what FrameLedger cannot do: [LIMITATIONS.md](../LIMITATIONS.md).
|
||||
|
||||
**Two periods.** From 2026-08-03 to 2026-09-06 the games were measured with the developer's capture tool, one run at a
|
||||
time against the game's own settings menu (reports in [spike-notes.md](spike-notes.md)). From 2026-09-16 the shipped
|
||||
app and agent recorded them as a user would; the database holds the sessions from 2026-09-22 on — earlier ones went
|
||||
with the 2026-09-16 recovery and with library entries removed since.
|
||||
|
||||
## Measured — hooked (Tier 1)
|
||||
|
||||
| Game | Engine | API | What was measured | When | Evidence |
|
||||
|---|---|---|---|---|---|
|
||||
| Cyberpunk 2077 | — | D3D12 | DLSS Balanced 1485×835 → 2560×1440, exact against its settings file; DLSS Frame Generation off ×1.00, ×3 (61.4 → 183.5 FPS), ×4 (58.7 → 234.1); FSR 3 + FSR frame generation ×2 (74.3 → 148.6); ray tracing *Yes* with path tracing on and *No* with it off, as set | 2026-08-15 → 09-05, about 25 runs | [spike-notes §8, §9, §11](spike-notes.md) |
|
||||
| Dying Light: The Beast | — | D3D12 | DLSS Frame Generation ×4: Native 70.5 → Displayed 282.1 FPS, counted through DXGI; FSR + FSR frame generation ×2 (70.5 → 140.9); ray tracing *Yes* | 2026-09-04 → 09-06 | [spike-notes §9](spike-notes.md), [03_METRICS §Frame Generation](03_METRICS.md) |
|
||||
| Hell Is Us | Unreal Engine 5.5.4 | D3D12 | DLSS Frame Generation ×4 (76.5 → 306.2); DLSS shown as *driver-reported* (it bypasses Streamline); FSR + FSR frame generation ×2 (85.7 → 171.4); XeSS frame generation shown as Presented FPS only; ray tracing *No* | 2026-09-03 → 09-16 | [spike-notes §8, §9](spike-notes.md) |
|
||||
| Black Myth: Wukong | Unreal Engine 5.0.0 | D3D12 | DLSS Frame Generation ×4 (55.4 → 221.5); ray tracing *Yes* (16.2 % of frames in the app's session); a session that changed state showed its steady state (×4.1) instead of an average | 2026-08-20 → 09-16 | [spike-notes §9, §14](spike-notes.md) |
|
||||
| Clair Obscur: Expedition 33 | Unreal Engine 5.4.4 | D3D12 | DLSS + Frame Generation ×4 (54.9 → 218.4) and ×2 (76.0 → 149.8); frame generation off read *none*, with DXGI agreeing; ray tracing *No* | 2026-09-04 → 09-06 | [spike-notes §9](spike-notes.md) |
|
||||
| Rune Factory: Guardians of Azuma | Unreal Engine (version not in the executable) | D3D12 | DLSS Frame Generation ×4 (128.9 → 513.0); FSR frame generation compiled into the game counted ×2 but not named; ray tracing *No* (the game has none) | 2026-08-20 → 09-06 | [spike-notes §9](spike-notes.md) |
|
||||
| Kingdom Come: Deliverance II | — | D3D12 | FSR (3.1 or 4) at 1505×847 → 2560×1440; frame generation *none* (the game ships none); ray tracing *No* | 2026-09-04 | [spike-notes §9](spike-notes.md) |
|
||||
| Lies of P | Unreal Engine 4.27.2 | D3D12 | FSR 3 at 1506×848 → 2560×1440 with FSR frame generation ×2.04 (57.1 → 116.4) in the app; frame generation off read *none*; DLSS shown as *driver-reported*; ray tracing *No* | 2026-08-03 → 09-16 | [spike-notes §7, §9, §14](spike-notes.md) |
|
||||
| Onimusha: Way of the Sword (demo) | RE Engine | D3D12 | DLSS + DLSS Frame Generation: ×3.67 and ×3.93 with the capture tool, ×4.00 in the app's steady state (60 → 240 FPS), ×3.0 (60 → 180) in the app on 2026-09-22; ray tracing *Yes* | 2026-09-05 → 09-22 | [spike-notes §9, §14](spike-notes.md), database |
|
||||
| Cronos: The New Dawn (demo) | Unreal Engine (version not in the executable) | D3D12 | DLSS with frame generation off (105 FPS, *none*); on ×2 (86.8 → 172.7), DLSS Frame Generation named; ray tracing *Yes* | 2026-09-06 → 09-16 | [spike-notes §9, §14](spike-notes.md) |
|
||||
| Alan Wake 2 | — | D3D12 | Path tracing Ultra with DLSS and Ray Reconstruction: ray tracing *Yes* (96.8 % of frames), frame generation read ×1.00 (the game did not apply the setting that run). On 2026-09-04: DLSS with ray tracing *Yes* (99 % of frames), 92.5 FPS, frame generation *none* by count; then ray tracing off (*No*), DLSS, Presented 114.5 FPS. The quality preset was never read | 2026-08-04 → 09-04 | [spike-notes §8](spike-notes.md), run reports |
|
||||
| SILENT HILL 2 | Unreal Engine 5.1 | D3D12 | DLSS Frame Generation identified, frames not counted (Presented 78 FPS); DLSS *driver-reported*; ray tracing *Yes* | 2026-09-25 | database |
|
||||
| DARK SOULS III | FromSoftware | D3D11 | Presented 59.8 FPS; no upscaler, frame generation or ray tracing loaded | 2026-09-03 | [spike-notes §9](spike-notes.md) |
|
||||
| Sekiro: Shadows Die Twice | FromSoftware | D3D11 | Presented 60 FPS (the game's cap), two sessions of 15 min and 2 h 18 min | 2026-09-26 | database |
|
||||
| Yu-Gi-Oh! Master Duel | Unity 6000.0 | D3D11 | Presented 239 FPS across six sessions (up to 5 h 25 min) | 2026-09-22 → 09-25 | database |
|
||||
| GIRLS' FRONTLINE 2: EXILIUM | Unity 2019.4 | D3D11 | Presented 53–101 FPS; the last three sessions under the user-mode anti-cheat exception (NetEase Yidun), one of them 3 h 9 min, all ended normally | 2026-09-21 → 09-27 | database, [HANDOFF](HANDOFF.md) |
|
||||
| Aniimo | Unity 2022.3 | D3D12 | DLSS at 1707×960 → 2560×1440, frame generation *none* (×1.00, 205 FPS), ray tracing *No* — then blocked (below) | 2026-09-22 | database |
|
||||
| AbyssMemory | Unreal Engine 4.26.1 | D3D11 | Presented 55 FPS, one short session | 2026-09-22 | database |
|
||||
| Umamusume: Pretty Derby | Unity 2022.3 | D3D11 | Presented 37 FPS, one session | 2026-09-27 | database |
|
||||
| 恋しかるべき (KOISHIKARUBEKI) | Unity 6000.3 | D3D11 | Presented 59.6 FPS | 2026-09-03 | [spike-notes §9](spike-notes.md) |
|
||||
| Flower in Us | RPG Maker MV/MZ (NW.js) | D3D11 | Presented 59.8 FPS over three swap chains, after two refusals that found the game's browser process ambiguous (fixed) | 2026-09-03 → 09-04 | [spike-notes §9](spike-notes.md) |
|
||||
| UMIGARI | Unreal Engine 5.5.4 | D3D12 | Presented 95–97 FPS, frame generation *none*, ray tracing *No* | 2026-09-05 → 09-06 | run reports only |
|
||||
|
||||
## Recorded without measurement (Tier 2)
|
||||
|
||||
| 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 |
|
||||
| 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 |
|
||||
|
||||
## Refused by the anti-cheat guard
|
||||
|
||||
| Game | What was found | When | Evidence |
|
||||
|---|---|---|---|
|
||||
| ELDEN RING | Easy Anti-Cheat: its folder, and a process Windows would not let FrameLedger open. Nothing was ever injected; eight sessions recorded without measurement | 2026-09-21 → 09-27 | [CHANGELOG](../CHANGELOG.md), database |
|
||||
| GIRLS' FRONTLINE 2: EXILIUM | NetEase Yidun (`NEP2.dll`, user mode) — turned hooking off after it had been measured; measured again since 2026-09-26 under the user-mode exception its owner made | 2026-09-25 | [19_SAFETY](19_SAFETY_AND_ANTICHEAT.md) |
|
||||
| Aniimo | NetEase Yidun with a kernel driver (`NEPKernel.sys`) in the game's folder — never eligible for an exception | 2026-09-25 | [19_SAFETY](19_SAFETY_AND_ANTICHEAT.md) |
|
||||
| Goose Goose Duck | Easy Anti-Cheat's service running, and its folder | 2026-08-04 | [spike-notes §13](spike-notes.md) |
|
||||
| Neverness To Everness | Anti-Cheat Expert's kernel driver in the game's folder | 2026-08-04 | [spike-notes §13](spike-notes.md) |
|
||||
| Counter-Strike 2 | Valve Anti-Cheat — refused by FrameLedger's title list since beta.8. On 2026-08-04 the checks alone allowed it (VAC is invisible to them); nothing was injected | 2026-08-04, beta.8 | [spike-notes §13](spike-notes.md), [19_SAFETY](19_SAFETY_AND_ANTICHEAT.md) |
|
||||
|
||||
Also refused before any injection: **Deadly Heart Gambit** — a 32-bit game (2026-08-03).
|
||||
|
||||
## Engine version read from the executable only
|
||||
|
||||
The Unreal Engine version (beta.10) was checked against ten installed Unreal games without running them: Hell Is Us
|
||||
5.5.4, Black Myth: Wukong 5.0.0, Clair Obscur: Expedition 33 5.4.4, Lies of P 4.27.2, SILENT HILL 2 5.1, UMIGARI 5.5.4,
|
||||
AbyssMemory 4.26.1, **Martha Is Dead 4.27.0**; Cronos (demo) and Rune Factory name no version in their executables and
|
||||
read *not found*. ([spike-notes §15](spike-notes.md), [05_DETECTION §Engine version](05_DETECTION.md))
|
||||
+21
-1
@@ -2489,7 +2489,9 @@ FrameLedger.Agent --console sessions --last 1
|
||||
```
|
||||
|
||||
**The row half is read — 2026-09-16, the shipped Agent, not the console.** The owner ran the App with its `--serve`
|
||||
Agent for an afternoon (18 hooked sessions, attach mode, `late_attach = 1`, every one watcher-driven from a Steam
|
||||
Agent for an afternoon (18 hooked sessions — **count note, 2026-09-27:** `CHANGELOG` 2026-09-17 says *all nine hooked
|
||||
sessions of 2026-09-16*; neither count was re-made when the other was written, and the ledger as it stands today holds no
|
||||
session from that day, so the discrepancy is recorded rather than resolved — attach mode, `late_attach = 1`, every one watcher-driven from a Steam
|
||||
launch rather than the `launch` verb above — a Steam title started from its Shipping executable relaunches through
|
||||
Steam, so the console recipe is the wrong vehicle for a Steam library and the product's own path is the right one).
|
||||
`sessions.id = 10`, **Lies of P**, 16:11, 147 s, `d3d12`, 16,221 frames, `guard_ticks_published = 5`, Overlay
|
||||
@@ -2564,3 +2566,21 @@ inspects module sizes is the way to fill it.
|
||||
Unchanged by P2 and repeated here because it is the other measurement no PR can close: the
|
||||
compare-and-restore path is proven against a fixture (`ctest fl_unhook_inline`), and §H7 still asks
|
||||
for one capture with each of the six overlays actually resident on the dev machine.
|
||||
|
||||
## 15 · Unreal Engine versions in shipping executables *(2026-09-27, beta.10)*
|
||||
|
||||
Measured read-only on the owner's machine (i7-14700KF, RTX 5080, Windows 11 29648): every `*-Win64-Shipping.exe`
|
||||
under `D:\SteamLibrary\steamapps\common` (a USB drive), before the extractor was written, then again through the
|
||||
shipped `UnrealBuildReader` once it was. Nothing was copied or written; the numbers are in `05_DETECTION` §Engine version
|
||||
(the table is not repeated here).
|
||||
|
||||
- **Numeric file version** (`VS_FIXEDFILEINFO`): the engine's MAJOR.MINOR.PATCH in seven of ten; a studio's own in three
|
||||
(Cronos 1.2.0.0, Rune Factory 1.0.3.0, SILENT HILL 2 1.0.0.5). The version *strings* are empty in six of ten.
|
||||
- **Branch name** (UTF-16 `++UE4+Release-M.m` / `++UE5+Release-M.m`): present in five — in `.rdata` in four (15–30 MB
|
||||
sections), and 290 MB into `.code` in Black Myth: Wukong, whose protected executable has an 8 KB `.rdata`; in UMIGARI
|
||||
also in the version strings. Absent in five (Hell Is Us carries `UE5-CL-0`: a renamed branch).
|
||||
- **The shipped reader, same ten files:** every version as tabled — 8 read, 2 honestly none — in 16 ms to 1.1 s each and
|
||||
7.5 s for Black Myth (the whole-file fallback, stopping at the first chunk that names a release line). A first pass
|
||||
that scanned only a PE's `.rdata` read Black Myth as `5.0.0` from the file version alone; the 1 MiB `.rdata` floor
|
||||
(`UnrealBuildReader.MinRdataBytes`) is what moved it to the stronger rung.
|
||||
- No UE3 title is installed; the rule does not detect UE3 at all.
|
||||
+24
-9
@@ -11,8 +11,8 @@
|
||||
that changes what FrameLedger.Overlay or the capture host does; date the change.
|
||||
HTML comments are not part of the block.
|
||||
-->
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-09-23.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.7`** (2026-09-23), an unsigned installer built from that tag with its
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-09-28.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.10`** (2026-09-28), 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
|
||||
@@ -30,7 +30,9 @@
|
||||
> named FSR 3 from the older DLLs, and FSR without a version from the newer ones, which host both
|
||||
> FSR 3.1 and FSR 4. FSR 2, and FSR shipped any other way, is not identified. For DLSS titles that
|
||||
> bypass Streamline, the NVIDIA driver's own per-process record is stored with the session and shown
|
||||
> as *DLSS (driver-reported)*. Intel XeSS is **not** read (its SDK licence
|
||||
> as *DLSS (driver-reported)*. The NVIDIA driver's profile for the game — the DLSS and frame-generation
|
||||
> overrides the NVIDIA App sets — is read, never changed, and shown as the driver's settings beside what
|
||||
> was measured. Intel XeSS is **not** read (its SDK licence
|
||||
> forbids it), and neither is an upscaler compiled into the game: those read `N/A`, or "Unknown
|
||||
> upscaler" when another vendor's hook ran in the game. Vulkan and OpenGL titles read `N/A`.
|
||||
> - **Quality preset:** not reported on any title measured. The one route this software may use — the
|
||||
@@ -51,9 +53,18 @@
|
||||
> FG are named from the calls the game makes; any other generator (XeSS-FG, one compiled into the game)
|
||||
> is shown only as active with the technology not identified, and is never named. Where a technology is
|
||||
> named but its frames could not be counted, or frame generation is not measured, the software shows
|
||||
> **Presented FPS** with a note on what it may include — never a Native figure.
|
||||
> **Presented FPS** with a note on what it may include — never a Native figure. Where generated frames
|
||||
> were counted, the lows, median and stutter are taken over application frames only.
|
||||
> - **Ray tracing:** Yes/No measured on Direct3D 12 from ray-dispatch and acceleration-structure-build
|
||||
> calls; the technique and path tracing are `N/A`, and so is ray tracing on other APIs.
|
||||
> - **Display mode:** how each game's window was shown — exclusive full-screen, borderless, windowed or
|
||||
> minimised — as a share of the session, with the window's size and the monitor's, in every session.
|
||||
> Exclusive full-screen is known only for Direct3D titles FrameLedger injects into, from the game's own
|
||||
> swap chain; for every other session the window alone is read, and a window covering its monitor reads
|
||||
> *full-screen or borderless*. What Windows does behind the game (fullscreen optimizations) is not visible.
|
||||
> - **Engine version:** the exact Unreal Engine 4 or 5 version, read from the game's executable on disk and
|
||||
> labelled with what it rests on; `N/A` where the executable names none. Other engines show what their own
|
||||
> files state.
|
||||
> - **Video memory:** in use on the whole graphics card, recorded from Windows and GPU-driver telemetry
|
||||
> and charted. **Not measured at all:** each game's own video-memory use and budget, which frame
|
||||
> spikes were shader compilation, PC latency (Reflex), and HDR. Stutter count and stutter time are
|
||||
@@ -61,16 +72,20 @@
|
||||
> - **Processor and memory:** how busy the processor was (time busy, all cores together — not the
|
||||
> frequency-scaled figure Task Manager draws) and how much system memory was in use, read from
|
||||
> Windows once a second and charted. Processor temperature is read only when the Agent runs as
|
||||
> administrator with PawnIO installed, and that reading has not yet been checked on real hardware;
|
||||
> everywhere else it is `N/A`.
|
||||
> administrator — an option, off by default, for which Windows asks at every start of the Agent — with
|
||||
> PawnIO installed, and that reading has not yet been checked on real hardware; everywhere else it is `N/A`.
|
||||
> - **Safety:** every pre-injection check runs before injection, including the signed-by-a-known-vendor
|
||||
> half of the suspicious-module rule. During every capture the Agent re-runs the checks every 30 s and
|
||||
> stops capturing on a refusal: a Direct3D or OpenGL game's hooks are removed, and the Vulkan layer
|
||||
> goes passthrough. A global switch in Settings turns all hooking off, and a running capture stops at
|
||||
> its next check; it can only refuse, never permit. **There is no override.** A finding about a game — anti-cheat
|
||||
> named in its process, in its folder or on its title lists — turns hooking off for that game, whether found
|
||||
> before injection, at a session's start or by the 30 s re-check; the game's page says so, and nothing turns it
|
||||
> back on for that executable.
|
||||
> named in its process or in its folder (any kernel driver there counts), or the game on a title list by its
|
||||
> store id or executable name — turns hooking off for that game, whether found by the Agent's own check of every
|
||||
> game in the library, before injection, at a session's start or by the 30 s re-check; the game's page says so,
|
||||
> and nothing turns it back on for that executable — except a user-mode exception you make yourself, per game,
|
||||
> in Settings (off by default): only where the only finding is one anti-cheat that runs entirely in user mode, with
|
||||
> no driver file in the game's folder. Its first two sessions are a trial, and one that does not go well ends it
|
||||
> for good. The guard still runs every check under it and ends it on anything new; a ban remains possible.
|
||||
>
|
||||
> Where a value is not measured it reads `N/A`, with two exceptions: FPS then shows Presented FPS with a
|
||||
> note on what it may include, and ray-tracing flags may show a value you set yourself, labelled as
|
||||
|
||||
+65
-15
@@ -1,6 +1,6 @@
|
||||
# FrameLedger — Disclaimer
|
||||
|
||||
**Version:** 2.6 · **Effective:** {{RELEASE_DATE}}
|
||||
**Version:** 2.9 · **Effective:** {{RELEASE_DATE}}
|
||||
|
||||
> **How this document is kept true.** The statement of what FrameLedger measures (§4) is `legal/ACCURACY.md`,
|
||||
> embedded here and in `README.md` and bound to its source by `tools/accuracy-check.ps1`, which fails the build when a
|
||||
@@ -11,7 +11,9 @@
|
||||
## 0. This is pre-release (beta) software
|
||||
|
||||
**FrameLedger is a beta.** Every build published so far is a pre-release. It has been tested on a small number of
|
||||
machines and games, and **it certainly still contains bugs — some of them not yet known to anyone.** Features can
|
||||
machines and games — the games are listed in `docs/LIST_GAME_TESTED.md` in the project's repository, and what the software
|
||||
cannot do is listed in `LIMITATIONS.md` there and in the app under Help ▸ Limitations — and **it certainly still contains
|
||||
bugs — some of them not yet known to anyone.** Features can
|
||||
change or disappear between builds, recorded data can turn out to be wrong, and an update can require your data to be
|
||||
migrated.
|
||||
|
||||
@@ -53,7 +55,7 @@ Install it somewhere only you can write to, and verify the published SHA-256 che
|
||||
FrameLedger is designed to reduce that risk substantially:
|
||||
|
||||
- Injection is **off by default** and must be enabled by you **per game**.
|
||||
- Before injecting, and every 30 seconds afterwards, FrameLedger scans for known anti-cheat and anti-tamper components. **If it finds one, it refuses to inject; if a session is already running, it stops at the next scan.** No setting turns this off, globally or per game (§2A). Because the scan runs every 30 seconds rather than continuously, anti-cheat that loads mid-session may be present for **up to 30 seconds** before FrameLedger detects it and stops.
|
||||
- Before injecting, and every 30 seconds afterwards, FrameLedger scans for known anti-cheat and anti-tamper components. **If it finds one, it refuses to inject; if a session is already running, it stops at the next scan.** No setting turns this off, globally or per game; the one exception you can make yourself, per game, still runs every check and is described in §2A. Because the scan runs every 30 seconds rather than continuously, anti-cheat that loads mid-session may be present for **up to 30 seconds** before FrameLedger detects it and stops.
|
||||
|
||||
**And there is a second, longer window you should know about.** The part of FrameLedger running inside the game also stops on its own if it loses contact with the part doing the scanning — because a scanner that has stopped cannot protect you. It waits **65 seconds** before concluding that contact is lost, so that one delayed scan on a busy machine does not end your session. In the worst case those windows combine: if the scanner stops at the moment anti-cheat appears, the component inside the game may keep running for up to **65 seconds** afterwards. That number is 65 and not 30, and this document says so rather than leaving the 30 above to imply it.
|
||||
|
||||
@@ -79,13 +81,31 @@ FrameLedger is designed to reduce that risk substantially:
|
||||
|
||||
**FrameLedger is intended for offline and single-player play. If you enable injection for a game with any online or competitive component, you do so entirely at your own risk and are solely responsible for the consequences, including compliance with that game's terms of service.**
|
||||
|
||||
## 2A. There is no way past the guard
|
||||
## 2A. There is no way past the guard — and one narrow exception you can make yourself
|
||||
|
||||
Versions 0.1.0-beta.3 and 0.1.0-beta.4 offered a per-game switch to overrule the guard. **It has been removed.** If
|
||||
FrameLedger finds anti-cheat or anti-tamper software in a game — before it injects, when a session starts, or during a
|
||||
session — it refuses, turns hooking off for that game, and says so on the game's page. There is no setting, per game or
|
||||
global, that turns that back on for that executable. Sessions recorded under the earlier switch stay in your database,
|
||||
marked as such in their notes.
|
||||
global, that overrules that. Sessions recorded under the earlier switch stay in your database, marked as such in their
|
||||
notes.
|
||||
|
||||
**Since 0.1.0-beta.9 there is one exception, and it is not a way past the guard.** A Settings option, off unless you
|
||||
turn it on, lets you make an exception — one game at a time, after a disclosure you must accept — for a game whose only
|
||||
finding is a single anti-cheat that works entirely in user mode (no kernel driver, no service, and no driver file
|
||||
anywhere in the game's folder) and that is on no list of titles FrameLedger refuses. Since 0.1.0-beta.11 the game does
|
||||
not need to have been measured before: **the first two sessions under the exception are a trial**, and if one of them
|
||||
does not go well — it crashes, records nothing, does not end normally, is stopped for safety, or something new is found
|
||||
— the exception ends and can never be made again for that game. Under it the guard still runs every check, before
|
||||
injecting and every 30 seconds, and still refuses anything else it finds; after the trial the exception ends by itself
|
||||
when something new is found, when a session under it crashes or is stopped for safety, or when the game is updated, and
|
||||
turning the option off suspends it. Sessions recorded under it are marked with the anti-cheat they ran beside. **Two
|
||||
good sessions are not evidence that the anti-cheat did not notice** — a ban may still come later.
|
||||
|
||||
**It exists because users asked for it, and it carries exactly the risk this document describes.** That anti-cheat
|
||||
may still detect FrameLedger in the game and warn, block or permanently ban your account — possibly days later — and
|
||||
FrameLedger cannot know whether it did. Earlier sessions that went well are no promise about the next one. **Do not
|
||||
use it with a game you play online or competitively unless you accept losing that account;** the developer cannot
|
||||
reverse a ban.
|
||||
|
||||
|
||||
## 3. Stability
|
||||
@@ -97,8 +117,8 @@ Software running inside another process can, in principle, destabilize it. Frame
|
||||
Frame timing is derived from high-resolution timestamps taken at the moment the game presents each frame; upscaling, frame-generation and ray-tracing state are read from the parameters the game passes to those APIs. This is substantially more accurate than inferring settings from files on disk, but **no measurement is guaranteed to be exact**:
|
||||
|
||||
<!-- accuracy-block:begin -->
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-09-23.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.7`** (2026-09-23), an unsigned installer built from that tag with its
|
||||
> ⚠ **What FrameLedger actually measures today — 2026-09-28.** The software is a beta; its latest
|
||||
> **pre-release is `0.1.0-beta.10`** (2026-09-28), 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
|
||||
@@ -116,7 +136,9 @@ Frame timing is derived from high-resolution timestamps taken at the moment the
|
||||
> named FSR 3 from the older DLLs, and FSR without a version from the newer ones, which host both
|
||||
> FSR 3.1 and FSR 4. FSR 2, and FSR shipped any other way, is not identified. For DLSS titles that
|
||||
> bypass Streamline, the NVIDIA driver's own per-process record is stored with the session and shown
|
||||
> as *DLSS (driver-reported)*. Intel XeSS is **not** read (its SDK licence
|
||||
> as *DLSS (driver-reported)*. The NVIDIA driver's profile for the game — the DLSS and frame-generation
|
||||
> overrides the NVIDIA App sets — is read, never changed, and shown as the driver's settings beside what
|
||||
> was measured. Intel XeSS is **not** read (its SDK licence
|
||||
> forbids it), and neither is an upscaler compiled into the game: those read `N/A`, or "Unknown
|
||||
> upscaler" when another vendor's hook ran in the game. Vulkan and OpenGL titles read `N/A`.
|
||||
> - **Quality preset:** not reported on any title measured. The one route this software may use — the
|
||||
@@ -137,9 +159,18 @@ Frame timing is derived from high-resolution timestamps taken at the moment the
|
||||
> FG are named from the calls the game makes; any other generator (XeSS-FG, one compiled into the game)
|
||||
> is shown only as active with the technology not identified, and is never named. Where a technology is
|
||||
> named but its frames could not be counted, or frame generation is not measured, the software shows
|
||||
> **Presented FPS** with a note on what it may include — never a Native figure.
|
||||
> **Presented FPS** with a note on what it may include — never a Native figure. Where generated frames
|
||||
> were counted, the lows, median and stutter are taken over application frames only.
|
||||
> - **Ray tracing:** Yes/No measured on Direct3D 12 from ray-dispatch and acceleration-structure-build
|
||||
> calls; the technique and path tracing are `N/A`, and so is ray tracing on other APIs.
|
||||
> - **Display mode:** how each game's window was shown — exclusive full-screen, borderless, windowed or
|
||||
> minimised — as a share of the session, with the window's size and the monitor's, in every session.
|
||||
> Exclusive full-screen is known only for Direct3D titles FrameLedger injects into, from the game's own
|
||||
> swap chain; for every other session the window alone is read, and a window covering its monitor reads
|
||||
> *full-screen or borderless*. What Windows does behind the game (fullscreen optimizations) is not visible.
|
||||
> - **Engine version:** the exact Unreal Engine 4 or 5 version, read from the game's executable on disk and
|
||||
> labelled with what it rests on; `N/A` where the executable names none. Other engines show what their own
|
||||
> files state.
|
||||
> - **Video memory:** in use on the whole graphics card, recorded from Windows and GPU-driver telemetry
|
||||
> and charted. **Not measured at all:** each game's own video-memory use and budget, which frame
|
||||
> spikes were shader compilation, PC latency (Reflex), and HDR. Stutter count and stutter time are
|
||||
@@ -147,16 +178,20 @@ Frame timing is derived from high-resolution timestamps taken at the moment the
|
||||
> - **Processor and memory:** how busy the processor was (time busy, all cores together — not the
|
||||
> frequency-scaled figure Task Manager draws) and how much system memory was in use, read from
|
||||
> Windows once a second and charted. Processor temperature is read only when the Agent runs as
|
||||
> administrator with PawnIO installed, and that reading has not yet been checked on real hardware;
|
||||
> everywhere else it is `N/A`.
|
||||
> administrator — an option, off by default, for which Windows asks at every start of the Agent — with
|
||||
> PawnIO installed, and that reading has not yet been checked on real hardware; everywhere else it is `N/A`.
|
||||
> - **Safety:** every pre-injection check runs before injection, including the signed-by-a-known-vendor
|
||||
> half of the suspicious-module rule. During every capture the Agent re-runs the checks every 30 s and
|
||||
> stops capturing on a refusal: a Direct3D or OpenGL game's hooks are removed, and the Vulkan layer
|
||||
> goes passthrough. A global switch in Settings turns all hooking off, and a running capture stops at
|
||||
> its next check; it can only refuse, never permit. **There is no override.** A finding about a game — anti-cheat
|
||||
> named in its process, in its folder or on its title lists — turns hooking off for that game, whether found
|
||||
> before injection, at a session's start or by the 30 s re-check; the game's page says so, and nothing turns it
|
||||
> back on for that executable.
|
||||
> named in its process or in its folder (any kernel driver there counts), or the game on a title list by its
|
||||
> store id or executable name — turns hooking off for that game, whether found by the Agent's own check of every
|
||||
> game in the library, before injection, at a session's start or by the 30 s re-check; the game's page says so,
|
||||
> and nothing turns it back on for that executable — except a user-mode exception you make yourself, per game,
|
||||
> in Settings (off by default): only where the only finding is one anti-cheat that runs entirely in user mode, with
|
||||
> no driver file in the game's folder. Its first two sessions are a trial, and one that does not go well ends it
|
||||
> for good. The guard still runs every check under it and ends it on anything new; a ban remains possible.
|
||||
>
|
||||
> Where a value is not measured it reads `N/A`, with two exceptions: FPS then shows Presented FPS with a
|
||||
> note on what it may include, and ray-tracing flags may show a value you set yourself, labelled as
|
||||
@@ -188,6 +223,21 @@ be the difference between a game that runs and one that does not. Turn hooking o
|
||||
|
||||
FrameLedger reads GPU telemetry through vendor libraries that ship with your graphics driver. It **only reads** — it never changes clocks, fan curves, power limits, or any other hardware setting. Optional CPU-temperature support relies on the separate third-party **PawnIO** driver, which you install at your own discretion under its own license; some anti-cheat systems object to third-party kernel drivers regardless of what they are used for.
|
||||
|
||||
## 5A. Running the capture agent as administrator — optional, and your decision
|
||||
|
||||
Since 0.1.0-beta.10 a Settings option, off unless you turn it on, starts FrameLedger's capture agent as administrator.
|
||||
**Windows asks you every time the agent starts** — also when you sign in — and the prompt names an unknown publisher,
|
||||
because FrameLedger is not code-signed. It lets FrameLedger open and measure a game that itself runs as administrator,
|
||||
and read the CPU temperature where PawnIO is installed. It changes nothing in the anti-cheat guard (§2, §2A), opens no
|
||||
process that Windows or an anti-cheat driver protects, and never starts a game as administrator: games you start from
|
||||
FrameLedger run with your standard rights.
|
||||
|
||||
**The risk is yours.** FrameLedger is installed in your user folder, which any program running under your Windows
|
||||
account can change (§1). If such a program replaced FrameLedger's files, it would run with administrator rights the next
|
||||
time you accept the prompt. Accept it only for a copy you installed from the project's GitHub Releases, and turn the
|
||||
option on only if you trust everything that runs under your account. The developer is not responsible for what runs
|
||||
under an administrator prompt you accept.
|
||||
|
||||
## 6. Third-party names
|
||||
|
||||
Windows and DirectX are trademarks of Microsoft Corporation. NVIDIA, DLSS, Reflex, NVAPI, AMD, FSR, Intel, XeSS, Vulkan, Steam, GOG, Epic Games, itch.io, Unity, Unreal Engine, and all other product names are trademarks of their respective owners. FrameLedger is an independent project and is **not affiliated with, endorsed by, or sponsored by** any of them, including any game publisher or anti-cheat vendor.
|
||||
|
||||
+2
-2
@@ -1,6 +1,6 @@
|
||||
# FrameLedger — End User License Agreement (EULA)
|
||||
|
||||
**Version:** 1.2 · **Effective:** {{RELEASE_DATE}}
|
||||
**Version:** 1.4 · **Effective:** {{RELEASE_DATE}}
|
||||
|
||||
This End User License Agreement ("Agreement") applies to **FrameLedger** ("the Software"), developed and published by **poli0981** ("the Developer"), contactable at <contact@poli0981.dev> — see <https://poli0981.dev/> for other contact channels.
|
||||
|
||||
@@ -14,7 +14,7 @@ The Software records game performance data, hardware telemetry (temperatures, lo
|
||||
|
||||
## 2A. Code injection — your responsibility
|
||||
|
||||
To measure rendering settings accurately, the Software can load a component into a game process, **but only for games you have individually enabled**, after a consent prompt that explains the risk. The Software refuses to do so when it detects anti-cheat or anti-tamper software, turns hooking off for that game, and provides no means to override that refusal (Disclaimer §2A).
|
||||
To measure rendering settings accurately, the Software can load a component into a game process, **but only for games you have individually enabled**, after a consent prompt that explains the risk. The Software refuses to do so when it detects anti-cheat or anti-tamper software, turns hooking off for that game, and provides no means to override that refusal — except a narrow, per-game exception for anti-cheat that works entirely in user mode, which you may make yourself, after a separate disclosure, whose first two sessions are a trial that ends it for good if one of them does not go well, and under which the Software still runs every check (Disclaimer §2A). By making such an exception you accept, for that game, the risk described in (b) below.
|
||||
|
||||
By enabling this feature for a game, you confirm that:
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# FrameLedger — Privacy Policy
|
||||
|
||||
**Version:** 2.3 · **Effective:** {{RELEASE_DATE}}
|
||||
**Version:** 2.5 · **Effective:** {{RELEASE_DATE}}
|
||||
|
||||
**Short version: everything stays on your PC. FrameLedger has no accounts, no telemetry, no analytics, and never uploads your data anywhere.**
|
||||
|
||||
@@ -9,7 +9,7 @@
|
||||
Stored in `%LOCALAPPDATA%\FrameLedger` on your device:
|
||||
|
||||
- Your game library entries (names, executable paths, metadata you or the app filled in, and whether each one is recorded).
|
||||
- Performance sessions: frame timing series, computed statistics, hardware sensor series (temperatures, load, memory usage), session duration, crash flags, tags and notes you write.
|
||||
- Performance sessions: frame timing series, computed statistics, hardware sensor series (temperatures, load, memory usage), session duration, crash flags, the graphics driver's settings the game ran under (NVIDIA only), how the game's window was shown (full-screen, borderless or windowed, for how long, its size and the monitor's), tags and notes you write.
|
||||
- A hardware snapshot per session (CPU/GPU model, driver version, RAM size, OS build, display mode) used for the "what changed between sessions" feature.
|
||||
- App settings, logs (rotated daily — the app keeps 7 days, the capture agent 14 — including the logs written by the component loaded into games), and, after a crash of the app itself, crash dump files.
|
||||
- Which games you enabled code injection for, and when you consented.
|
||||
@@ -37,11 +37,15 @@ The "Report a bug" feature builds a zip file **on your device**, shows you exact
|
||||
|
||||
## 4. What the app can technically observe
|
||||
|
||||
To do its job, FrameLedger observes: which of *your tracked* executables — the entries in your library whose recording is on — are running, and their process trees; the parameters your games pass to the graphics APIs it intercepts (presentation, upscaling, ray tracing, pipeline creation); video-memory usage reported by the graphics runtime; loaded module names of a game being captured (for detection and for the anti-cheat safety check); and hardware sensor values from your graphics driver's own libraries.
|
||||
To do its job, FrameLedger observes: which of *your tracked* executables — the entries in your library whose recording is on — are running, and their process trees; the parameters your games pass to the graphics APIs it intercepts (presentation, upscaling, ray tracing, pipeline creation); video-memory usage reported by the graphics runtime; loaded module names of a game being captured (for detection and for the anti-cheat safety check); the names of the files in each library game's install folder, the version information of its executable and of the upscaling libraries it ships, the content of its executable file (the markers of the engine and of the graphics libraries it carries, the libraries it imports, and the engine build name an Unreal Engine game carries), and the store files that name it (Steam's and GOG's, on your disk) — to detect its engine, its engine version and its features and to check it for anti-cheat before any injection is possible; the size, position and state of a tracked game's window and the monitor it is on, read from Windows and not from the game, and — for a game FrameLedger injects into — whether the game asked for exclusive full-screen; the NVIDIA driver's settings for your tracked executables (read only: the DLSS and frame-generation overrides the NVIDIA App set); hardware sensor values from your graphics driver's own libraries; and how busy the processor is and how much memory is in use, from Windows' own counters.
|
||||
|
||||
It does **not** read game memory outside those API parameters, and does not read game saves, chat, input content, network traffic, or anything unrelated to performance measurement. It records only for programs you added to your library and did not switch recording off for — a program whose recording is off is not watched at all — and injects only into games you individually enabled.
|
||||
|
||||
> **History.** Version 2.3 (2026-09-23) adds the per-entry recording switch. Before it, every program in your library was recorded whenever it ran, which recorded a utility that starts with Windows at every boot.
|
||||
>
|
||||
> Version 2.4 (2026-09-25, 0.1.0-beta.8) names what the software reads to check every game in your library for anti-cheat — until then it checked only a game you asked to hook — and to name the versions of its files, and the NVIDIA driver's settings for your games. The files of a library game's folder were already read to detect its engine and features; this version is the first to say so.
|
||||
>
|
||||
> Version 2.5 (2026-09-27, 0.1.0-beta.10) adds how a tracked game's window is shown — read from Windows — and the engine build name read from an Unreal Engine game's executable. It is also the first version to say two things the software already did: it reads the **content** of a library game's executable (markers in its first 8 MB and its import table, since the detection of engines and features; and, when a session starts, the graphics-library markers in the whole file), and it reads the processor load and the memory in use (since 0.1.0-beta.3). Nothing here leaves your device, as before.
|
||||
|
||||
All of this stays on your device. None of it is transmitted anywhere.
|
||||
|
||||
|
||||
@@ -40,7 +40,7 @@
|
||||
"level, which made it a check that could not fire."
|
||||
],
|
||||
"schemaVersion": 2,
|
||||
"rulesVersion": "2026.09.5",
|
||||
"rulesVersion": "2026.10.1",
|
||||
|
||||
"engines": [
|
||||
{
|
||||
@@ -59,7 +59,7 @@
|
||||
{ "type": "sibling_glob", "value": "*-Win64-Shipping.exe" },
|
||||
{ "type": "sibling_glob", "value": "*/Content/Paks/*.pak" }
|
||||
] },
|
||||
"version": { "type": "pe_product_version_regex", "value": "\\+\\+UE(4|5)\\+Release-(\\d+\\.\\d+)" }
|
||||
"version": { "type": "unreal_build" }
|
||||
},
|
||||
{
|
||||
"id": "rpgmaker_mv",
|
||||
@@ -419,7 +419,10 @@
|
||||
{ "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." },
|
||||
{ "store": "steam", "id": "3405690", "family": "EA AntiCheat", "reason": "Protected by EA AntiCheat (Javelin), a kernel anti-cheat." }
|
||||
{ "store": "steam", "id": "3405690", "family": "EA AntiCheat", "reason": "Protected by EA AntiCheat (Javelin), a kernel anti-cheat." },
|
||||
{ "store": "steam", "id": "3224770", "family": "CrackProof", "reason": "Protected by CrackProof (HyperTech), a kernel anti-cheat; its driver is not in the game's folder." },
|
||||
{ "store": "steam", "id": "1973710", "family": "CrackProof", "reason": "Protected by CrackProof (HyperTech), a kernel anti-cheat; its driver is not in the game's folder." },
|
||||
{ "store": "steam", "id": "2987800", "family": "CrackProof", "reason": "Protected by CrackProof (HyperTech), a kernel anti-cheat; its driver is not in the game's folder." }
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -196,6 +196,15 @@
|
||||
"type": { "const": "manifest_field" },
|
||||
"field": { "$ref": "#/$defs/manifestFieldPath" }
|
||||
}
|
||||
},
|
||||
{
|
||||
"$comment": "beta.10: Unreal Engine's build facts (the shipping executable's numeric file version and the engine's branch name inside it), decided in code (Domain.Detection.UnrealVersion) rather than by a pattern - which is why it takes no parameter.",
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["type"],
|
||||
"properties": {
|
||||
"type": { "const": "unreal_build" }
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
using System.Globalization;
|
||||
using System.Security.Principal;
|
||||
using FrameLedger.Infrastructure.Startup;
|
||||
|
||||
namespace FrameLedger.Agent.Cli;
|
||||
|
||||
@@ -11,6 +13,13 @@ namespace FrameLedger.Agent.Cli;
|
||||
/// <b><c>--data-dir</c> exists only under <c>--console</c></b> (HANDOFF §P2 decision D6): an integration test
|
||||
/// needs a scratch ledger, and CI must never touch the profile. <c>--serve</c> with it is an error rather than an
|
||||
/// ignored option, because an ignored option is how the product directory becomes selectable by accident.
|
||||
/// <para>
|
||||
/// <b><c>--serve</c> takes two options since beta.10, and only these</b> (the Agent's admin mode, owner decision D34):
|
||||
/// <c>--for-user <SID></c>, which the starter passes to the Agent it asked Windows to elevate — the Agent refuses to run
|
||||
/// as any other account (<c>AgentElevation.ExitOtherAccount</c>) — and <c>--elevation <outcome></c>, which says the
|
||||
/// starter asked and was not granted, so this Agent does not ask again. Neither names a directory, a target or a check; the
|
||||
/// data folder is still the profile's and nothing else.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
internal sealed record AgentCommandLine
|
||||
{
|
||||
@@ -29,7 +38,7 @@ internal sealed record AgentCommandLine
|
||||
};
|
||||
|
||||
private const string _usage =
|
||||
"usage: FrameLedger.Agent --serve\n"
|
||||
"usage: FrameLedger.Agent --serve [--for-user <SID> | --elevation declined|other-account|failed]\n"
|
||||
+ " FrameLedger.Agent --register-vklayer | --unregister-vklayer | --install-task | --uninstall-task\n"
|
||||
+ " FrameLedger.Agent --write-crash-dump <file> (started by a crashing App or Agent; dumps that parent)\n"
|
||||
+ " FrameLedger.Agent --console [--data-dir <dir>] consent list | consent grant --exe <path> | consent revoke --exe <path>\n"
|
||||
@@ -59,6 +68,12 @@ internal sealed record AgentCommandLine
|
||||
|
||||
public string? DataDirectory { get; init; }
|
||||
|
||||
/// <summary><c>--serve --for-user</c>: the account whose Agent this elevated process must be (beta.10, D34).</summary>
|
||||
public string? ForUser { get; init; }
|
||||
|
||||
/// <summary><c>--serve --elevation</c>: the starter asked for elevation and got this instead (<c>AgentElevation.Refusals</c>).</summary>
|
||||
public string? ElevationRefusal { get; init; }
|
||||
|
||||
/// <summary>The file <see cref="AgentVerb.WriteCrashDump"/> writes — a path, never a pid.</summary>
|
||||
public string? CrashDumpFile { get; init; }
|
||||
|
||||
@@ -97,9 +112,7 @@ internal sealed record AgentCommandLine
|
||||
|
||||
if (string.Equals(args[0], "--serve", StringComparison.Ordinal))
|
||||
{
|
||||
return args.Length == 1
|
||||
? new AgentCommandLine { Verb = AgentVerb.Serve }
|
||||
: new AgentCommandLine { Error = "--serve takes no options; --data-dir exists only under --console (the product directory is not selectable)" };
|
||||
return ParseServe(args[1..]);
|
||||
}
|
||||
|
||||
if (!string.Equals(args[0], "--console", StringComparison.Ordinal))
|
||||
@@ -110,6 +123,41 @@ internal sealed record AgentCommandLine
|
||||
return ParseConsole(args[1..]);
|
||||
}
|
||||
|
||||
/// <summary><c>--serve</c>, alone or with ONE of its two admin-mode options (beta.10).</summary>
|
||||
private static AgentCommandLine ParseServe(string[] rest)
|
||||
{
|
||||
const string onlyThese = "--serve takes only --for-user <SID> or --elevation declined|other-account|failed (the agent's admin mode); "
|
||||
+ "--data-dir exists only under --console (the product directory is not selectable)";
|
||||
if (rest.Length == 0)
|
||||
{
|
||||
return new AgentCommandLine { Verb = AgentVerb.Serve };
|
||||
}
|
||||
|
||||
if (rest.Length != 2)
|
||||
{
|
||||
return new AgentCommandLine { Error = onlyThese };
|
||||
}
|
||||
|
||||
switch (rest[0])
|
||||
{
|
||||
case "--for-user":
|
||||
try
|
||||
{
|
||||
// A SID in its string form, validated as one: the Agent compares it with its own token's user.
|
||||
return new AgentCommandLine { Verb = AgentVerb.Serve, ForUser = new SecurityIdentifier(rest[1]).Value };
|
||||
}
|
||||
catch (ArgumentException)
|
||||
{
|
||||
return new AgentCommandLine { Error = $"--for-user needs a SID, not '{rest[1]}'" };
|
||||
}
|
||||
|
||||
case "--elevation" when AgentElevation.Refusals.Contains(rest[1], StringComparer.Ordinal):
|
||||
return new AgentCommandLine { Verb = AgentVerb.Serve, ElevationRefusal = rest[1] };
|
||||
default:
|
||||
return new AgentCommandLine { Error = onlyThese };
|
||||
}
|
||||
}
|
||||
|
||||
private static AgentCommandLine ParseConsole(string[] rest)
|
||||
{
|
||||
(AgentVerb verb, int at, int words) = VerbOf(rest);
|
||||
|
||||
@@ -0,0 +1,8 @@
|
||||
namespace FrameLedger.Agent.Composition;
|
||||
|
||||
/// <summary>
|
||||
/// The admin mode's answer at this Agent's start (beta.10, owner decision D34): registered by <c>--serve</c> alone, read into
|
||||
/// <c>HelloAck.ElevationOutcome</c>. Null when nobody asked — the option off, or elevation inherited from whoever started it.
|
||||
/// </summary>
|
||||
/// <param name="Outcome">One of <c>Infrastructure.Startup.AgentElevation</c>'s outcomes, or null.</param>
|
||||
internal sealed record AgentElevationState(string? Outcome);
|
||||
@@ -9,7 +9,7 @@ namespace FrameLedger.Agent.Composition;
|
||||
/// <summary>What <c>HelloAck</c> says about this process, read once at composition.</summary>
|
||||
internal static class AgentIdentityFactory
|
||||
{
|
||||
public static AgentIdentity OfThisProcess(string vkLayerDirectory)
|
||||
public static AgentIdentity OfThisProcess(string vkLayerDirectory, string? elevationOutcome = null)
|
||||
{
|
||||
ArgumentException.ThrowIfNullOrWhiteSpace(vkLayerDirectory);
|
||||
string buildId = NativeAntiCheatGuard.BuildId();
|
||||
@@ -25,7 +25,11 @@ internal static class AgentIdentityFactory
|
||||
// PawnIO installed. It was a constant false while nothing read a CPU sensor at all.
|
||||
CpuTempAvailable: Infrastructure.Telemetry.LhmEnvironment.IsElevated && Infrastructure.Telemetry.LhmEnvironment.IsPawnIoInstalled == true,
|
||||
// D14: the FR-2.1 text this build stamps against; the App compares it with its own before showing the dialog.
|
||||
DisclosureVersion: SafetyDisclosure.Version);
|
||||
DisclosureVersion: SafetyDisclosure.Version,
|
||||
// D33: the user-mode exception's disclosure, under the same rule.
|
||||
ExceptionDisclosureVersion: AntiCheatExceptionDisclosure.Version,
|
||||
// beta.10 (D34): what the admin mode's prompt answered at this start; null when nobody asked.
|
||||
ElevationOutcome: elevationOutcome);
|
||||
}
|
||||
|
||||
private static string Version()
|
||||
|
||||
@@ -4,6 +4,7 @@ using FrameLedger.Application.Consent;
|
||||
using FrameLedger.Application.Persistence;
|
||||
using FrameLedger.Application.Recording;
|
||||
using FrameLedger.Application.Telemetry;
|
||||
using FrameLedger.Infrastructure.Display;
|
||||
using FrameLedger.Infrastructure.Telemetry;
|
||||
|
||||
namespace FrameLedger.Agent.Composition;
|
||||
@@ -35,6 +36,10 @@ internal sealed class AgentRecording
|
||||
private readonly CapturePause _pause;
|
||||
private readonly IRecorderPolicy _policy;
|
||||
private readonly IDriverProfileSource _profiles;
|
||||
private readonly IUserModeExceptionSwitch _exceptions;
|
||||
private readonly IOverlayToleranceChannel _tolerance;
|
||||
private readonly WindowGeometryProbe _display = new();
|
||||
private readonly UserModeExceptionLapsePolicy _exceptionLapse;
|
||||
|
||||
public AgentRecording(
|
||||
IGameConsentStore store,
|
||||
@@ -55,9 +60,15 @@ internal sealed class AgentRecording
|
||||
ISessionObserver observer,
|
||||
CapturePause pause,
|
||||
IRecorderPolicy policy,
|
||||
IDriverProfileSource profiles)
|
||||
IDriverProfileSource profiles,
|
||||
IUserModeExceptionSwitch exceptions,
|
||||
IOverlayToleranceChannel tolerance,
|
||||
UserModeExceptionLapsePolicy exceptionLapse)
|
||||
{
|
||||
_profiles = profiles;
|
||||
_exceptions = exceptions;
|
||||
_tolerance = tolerance;
|
||||
_exceptionLapse = exceptionLapse;
|
||||
_store = store;
|
||||
_gate = gate;
|
||||
_guard = guard;
|
||||
@@ -108,7 +119,8 @@ internal sealed class AgentRecording
|
||||
new RecorderOptions { MinimumSessionLength = minimum, PartialFlushInterval = flush },
|
||||
_observer,
|
||||
_policy,
|
||||
_profiles);
|
||||
_profiles,
|
||||
_exceptionLapse);
|
||||
}
|
||||
|
||||
/// <summary>L1 + L2 + L3 under the composite, one poller per session; the poller owns and disposes the layers. The interval is the session's (<c>telemetry.interval_ms</c>, D16).</summary>
|
||||
@@ -174,7 +186,11 @@ internal sealed class AgentRecording
|
||||
launcher,
|
||||
observer,
|
||||
_killSwitch,
|
||||
_pause);
|
||||
_pause,
|
||||
_exceptions,
|
||||
_tolerance,
|
||||
// beta.10: the game's window, read out of process on the loop's ticks (03_METRICS §Display mode).
|
||||
_display);
|
||||
|
||||
/// <summary>The session and its collaborators, wired the only way the Agent allows; the recorder supplies the observer.</summary>
|
||||
private sealed class Factory(AgentRecording owner, int seconds, IProcessLauncher? launcher) : ICaptureSessionFactory
|
||||
|
||||
@@ -70,6 +70,7 @@ internal static class AgentServices
|
||||
services.AddSingleton<IRecorderPolicy, SettingsRecorderPolicy>();
|
||||
services.AddSingleton<SettingsKillSwitch>();
|
||||
services.AddSingleton<IKillSwitch>(static sp => sp.GetRequiredService<SettingsKillSwitch>());
|
||||
AddUserModeException(services);
|
||||
|
||||
// The gate and the guard: one native facade, one managed gate in front of it.
|
||||
services.AddSingleton<IAntiCheatGuard, NativeAntiCheatGuard>();
|
||||
@@ -111,6 +112,18 @@ internal static class AgentServices
|
||||
return services;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// D33 (owner decision 2026-09-26): the user-mode exception's option (one row in <c>settings</c>), its channel to the
|
||||
/// Overlay (<c>Local\FrameLedger.Tolerate.<pid></c>, created before an injection under it), and the policy that ends
|
||||
/// it when a session under it ends badly.
|
||||
/// </summary>
|
||||
private static void AddUserModeException(IServiceCollection services)
|
||||
{
|
||||
services.AddSingleton<IUserModeExceptionSwitch, SettingsUserModeExceptionSwitch>();
|
||||
services.AddSingleton<IOverlayToleranceChannel>(static _ => new OverlayToleranceChannel(static line => Serilog.Log.Information("{Line}", line)));
|
||||
services.AddSingleton(static sp => new UserModeExceptionLapsePolicy(sp.GetRequiredService<IGameConsentStore>(), sp.GetRequiredService<ISessionRepository>()));
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// What the NVIDIA driver says about a session, through the bridge (never into a game): the per-process NGX words (P2
|
||||
/// PR-E2), and since beta.8 the driver profile each session's executable runs under — the NVIDIA App's DLSS and
|
||||
@@ -165,7 +178,10 @@ internal static class AgentServices
|
||||
sp.GetRequiredService<IExecutableIdentitySource>(),
|
||||
static line => Serilog.Log.Information("{Line}", line),
|
||||
sp.GetRequiredService<IIpcEventPublisher>(),
|
||||
id => sp.GetRequiredService<CaptureOrchestrator>().IsRecording(id)));
|
||||
id => sp.GetRequiredService<CaptureOrchestrator>().IsRecording(id),
|
||||
// D33: the evidence and the option the user-mode exception's eligibility needs.
|
||||
sp.GetRequiredService<ISessionRepository>(),
|
||||
sp.GetRequiredService<IUserModeExceptionSwitch>()));
|
||||
|
||||
// The layer's registration follows the ledger (P4 PR-2, 12_BUILD §The Vulkan layer is not registered at
|
||||
// install time): the same manifest and key --register-vklayer writes, reconciled after every consent change
|
||||
@@ -197,7 +213,36 @@ internal static class AgentServices
|
||||
// host's under --serve and a logged no-op under --console (TryAdd: --serve registers its own first).
|
||||
services.AddSingleton<CapturePause>();
|
||||
services.TryAddSingleton<IAgentLifetime, NoAgentLifetime>();
|
||||
services.AddSingleton(static sp => new AgentCommandHandler(
|
||||
services.AddSingleton(static sp => CommandHandler(sp));
|
||||
services.AddSingleton<IIpcRequestHandler>(static sp => new AgentRequestHandler(
|
||||
AgentIdentityFactory.OfThisProcess(sp.GetRequiredService<AgentPaths>().VkLayerDirectory, sp.GetService<AgentElevationState>()?.Outcome),
|
||||
TelemetryDescriptor(),
|
||||
() => sp.GetRequiredService<SessionEventPublisher>().Status,
|
||||
() => sp.GetRequiredService<AgentCommandHandler>()));
|
||||
services.AddSingleton(static sp => new PipeServer(
|
||||
sp.GetRequiredService<PipeServerOptions>(),
|
||||
sp.GetRequiredService<IIpcRequestHandler>(),
|
||||
static line => Serilog.Log.Information("{Line}", line)));
|
||||
services.AddSingleton<IIpcEventPublisher>(static sp => sp.GetRequiredService<PipeServer>());
|
||||
services.AddSingleton(static sp => new SessionEventPublisher(sp.GetRequiredService<IIpcEventPublisher>(), TimeProvider.System));
|
||||
services.AddSingleton<ISessionObserver>(static sp => sp.GetRequiredService<SessionEventPublisher>());
|
||||
services.AddSingleton(static sp => new CaptureOrchestrator(
|
||||
sp.GetRequiredService<ISessionRecorder>(),
|
||||
sp.GetRequiredService<IGameRepository>(),
|
||||
sp.GetRequiredService<IProcessSnapshotSource>(),
|
||||
sp.GetRequiredService<IExecutableIdentitySource>(),
|
||||
new OrchestratorOptions { PayloadPath = AgentPaths.Payload },
|
||||
static line => Serilog.Log.Information("{Line}", line),
|
||||
sp.GetRequiredService<ILaunchRecorderFactory>(),
|
||||
sp.GetRequiredService<ExecutableRelocator>(),
|
||||
sp.GetRequiredService<LatestProcessSnapshot>()));
|
||||
services.AddSingleton<ILaunchRecorderFactory, AgentLaunches>();
|
||||
|
||||
}
|
||||
|
||||
/// <summary>The command half of the pipe (P3 PR-1b) over the Agent's own adapters — every command it answers, D33's included.</summary>
|
||||
private static AgentCommandHandler CommandHandler(IServiceProvider sp) =>
|
||||
new AgentCommandHandler(
|
||||
sp.GetRequiredService<IGameRepository>(),
|
||||
sp.GetRequiredService<IGameConsentStore>(),
|
||||
sp.GetRequiredService<IAntiCheatGuard>(),
|
||||
@@ -223,32 +268,11 @@ internal static class AgentServices
|
||||
ct => new RetentionSweep(sp.GetRequiredService<ISessionRepository>(), sp.GetRequiredService<RegisteredSettings>()).RunAsync(ct),
|
||||
sp.GetRequiredService<ExecutableRelocator>(),
|
||||
// beta.8: an executable that cannot run as x64 is refused before anything is scanned or stamped.
|
||||
new PeArchitectureSource()));
|
||||
services.AddSingleton<IIpcRequestHandler>(static sp => new AgentRequestHandler(
|
||||
AgentIdentityFactory.OfThisProcess(sp.GetRequiredService<AgentPaths>().VkLayerDirectory),
|
||||
TelemetryDescriptor(),
|
||||
() => sp.GetRequiredService<SessionEventPublisher>().Status,
|
||||
() => sp.GetRequiredService<AgentCommandHandler>()));
|
||||
services.AddSingleton(static sp => new PipeServer(
|
||||
sp.GetRequiredService<PipeServerOptions>(),
|
||||
sp.GetRequiredService<IIpcRequestHandler>(),
|
||||
static line => Serilog.Log.Information("{Line}", line)));
|
||||
services.AddSingleton<IIpcEventPublisher>(static sp => sp.GetRequiredService<PipeServer>());
|
||||
services.AddSingleton(static sp => new SessionEventPublisher(sp.GetRequiredService<IIpcEventPublisher>(), TimeProvider.System));
|
||||
services.AddSingleton<ISessionObserver>(static sp => sp.GetRequiredService<SessionEventPublisher>());
|
||||
services.AddSingleton(static sp => new CaptureOrchestrator(
|
||||
sp.GetRequiredService<ISessionRecorder>(),
|
||||
sp.GetRequiredService<IGameRepository>(),
|
||||
sp.GetRequiredService<IProcessSnapshotSource>(),
|
||||
sp.GetRequiredService<IExecutableIdentitySource>(),
|
||||
new OrchestratorOptions { PayloadPath = AgentPaths.Payload },
|
||||
static line => Serilog.Log.Information("{Line}", line),
|
||||
sp.GetRequiredService<ILaunchRecorderFactory>(),
|
||||
sp.GetRequiredService<ExecutableRelocator>(),
|
||||
sp.GetRequiredService<LatestProcessSnapshot>()));
|
||||
services.AddSingleton<ILaunchRecorderFactory, AgentLaunches>();
|
||||
|
||||
}
|
||||
new PeArchitectureSource(),
|
||||
// D33: the user-mode exception's option and disclosure version (D38: no session count any more).
|
||||
new AntiCheatExceptionCommands(
|
||||
sp.GetRequiredService<IUserModeExceptionSwitch>(),
|
||||
AntiCheatExceptionDisclosure.Version));
|
||||
|
||||
/// <summary>
|
||||
/// <c>HelloAck.telemetrySource</c>: the layers this machine composes, read once on the first <c>Hello</c> by
|
||||
|
||||
@@ -14,7 +14,12 @@
|
||||
//
|
||||
// The maintenance flags (P3 PR-8b) — --register-vklayer, --unregister-vklayer, --install-task, --uninstall-task —
|
||||
// run over the product directory and exit; --diag is the App's (10_LOGGING) and answers "not implemented", exit 2.
|
||||
//
|
||||
// The admin mode (beta.10, owner decision D34): with capture.run_elevated on, a plain --serve that is not elevated — the
|
||||
// logon task's — asks Windows once (a UAC prompt on the taskbar) to start an elevated Agent for this user and hands over to
|
||||
// it; declined, it serves as before and says so. Decided before the folder is claimed or anything is written.
|
||||
|
||||
using System.Diagnostics;
|
||||
using FrameLedger.Agent.Cli;
|
||||
using FrameLedger.Agent.Composition;
|
||||
using FrameLedger.Agent.Hosting;
|
||||
@@ -51,6 +56,12 @@ internal static class Program
|
||||
}
|
||||
|
||||
AgentPaths paths = cmd.DataDirectory is { } dir ? new AgentPaths(Path.GetFullPath(dir)) : AgentPaths.Default;
|
||||
ElevationDecision elevation = cmd.Verb == AgentVerb.Serve ? await DecideElevationAsync(cmd, paths).ConfigureAwait(false) : ElevationDecision.NotAsked;
|
||||
if (elevation.Exit is { } decided)
|
||||
{
|
||||
return decided;
|
||||
}
|
||||
|
||||
using AgentInstanceLock? claim = ClaimDataDirectory(cmd.Verb, paths, out bool heldElsewhere);
|
||||
if (heldElsewhere)
|
||||
{
|
||||
@@ -59,36 +70,11 @@ internal static class Program
|
||||
|
||||
ConfigureLogging(paths);
|
||||
HookCrashHandlers(paths);
|
||||
LogElevation(elevation);
|
||||
|
||||
try
|
||||
{
|
||||
// Before anything else. The guard reads this file on every evaluation and refuses every title
|
||||
// when it is absent, so a capture started before the seed lands would fail for a reason that
|
||||
// has nothing to do with the game (§S20).
|
||||
RulesSeedOutcome seeded = await new RulesSeeder(new FileSystemRulesStore()).EnsureSeededAsync().ConfigureAwait(false);
|
||||
AgentConsole.Line($"rules: {Describe(seeded)}");
|
||||
Log.Information("rules: {Outcome}", seeded);
|
||||
if (seeded is RulesSeedOutcome.WriteFailed or RulesSeedOutcome.PackagedSeedUnusable)
|
||||
{
|
||||
return _exitRulesFailed;
|
||||
}
|
||||
|
||||
LedgerDatabase? db = await OpenLedgerOrSayWhyAsync(cmd.Verb, paths).ConfigureAwait(false);
|
||||
if (db is null)
|
||||
{
|
||||
return cmd.Verb == AgentVerb.DbPath ? _exitOk : _exitLedgerRefused;
|
||||
}
|
||||
|
||||
await using (db.ConfigureAwait(false))
|
||||
{
|
||||
return cmd.Verb switch
|
||||
{
|
||||
AgentVerb.Serve => await ServeAsync(db, paths).ConfigureAwait(false),
|
||||
AgentVerb.RegisterVkLayer or AgentVerb.UnregisterVkLayer or AgentVerb.InstallTask or AgentVerb.UninstallTask =>
|
||||
await new MaintenanceVerbs(db, paths).RunAsync(cmd).ConfigureAwait(false),
|
||||
_ => await ConsoleAsync(cmd, db, paths).ConfigureAwait(false),
|
||||
};
|
||||
}
|
||||
return await RunAsync(cmd, paths, elevation.Outcome).ConfigureAwait(false);
|
||||
}
|
||||
catch (Exception ex) when (ex is not OutOfMemoryException)
|
||||
{
|
||||
@@ -103,6 +89,38 @@ internal static class Program
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>The rules, the ledger and the verb, once the folder is claimed and the log is open.</summary>
|
||||
private static async Task<int> RunAsync(AgentCommandLine cmd, AgentPaths paths, string? elevationOutcome)
|
||||
{
|
||||
// Before anything else. The guard reads this file on every evaluation and refuses every title
|
||||
// when it is absent, so a capture started before the seed lands would fail for a reason that
|
||||
// has nothing to do with the game (§S20).
|
||||
RulesSeedOutcome seeded = await new RulesSeeder(new FileSystemRulesStore()).EnsureSeededAsync().ConfigureAwait(false);
|
||||
AgentConsole.Line($"rules: {Describe(seeded)}");
|
||||
Log.Information("rules: {Outcome}", seeded);
|
||||
if (seeded is RulesSeedOutcome.WriteFailed or RulesSeedOutcome.PackagedSeedUnusable)
|
||||
{
|
||||
return _exitRulesFailed;
|
||||
}
|
||||
|
||||
LedgerDatabase? db = await OpenLedgerOrSayWhyAsync(cmd.Verb, paths).ConfigureAwait(false);
|
||||
if (db is null)
|
||||
{
|
||||
return cmd.Verb == AgentVerb.DbPath ? _exitOk : _exitLedgerRefused;
|
||||
}
|
||||
|
||||
await using (db.ConfigureAwait(false))
|
||||
{
|
||||
return cmd.Verb switch
|
||||
{
|
||||
AgentVerb.Serve => await ServeAsync(db, paths, elevationOutcome).ConfigureAwait(false),
|
||||
AgentVerb.RegisterVkLayer or AgentVerb.UnregisterVkLayer or AgentVerb.InstallTask or AgentVerb.UninstallTask =>
|
||||
await new MaintenanceVerbs(db, paths).RunAsync(cmd).ConfigureAwait(false),
|
||||
_ => await ConsoleAsync(cmd, db, paths).ConfigureAwait(false),
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>A usage error or a flag this binary does not implement is answered before any file is touched.</summary>
|
||||
private static int? AnswerWithoutLogging(AgentCommandLine cmd)
|
||||
{
|
||||
@@ -164,6 +182,83 @@ internal static class Program
|
||||
return claim;
|
||||
}
|
||||
|
||||
/// <summary>What the admin mode decided at this start: the outcome <c>HelloAck</c> reports, and an exit code when this process stops here.</summary>
|
||||
private sealed record ElevationDecision(string? Outcome, int? Exit, string? Detail)
|
||||
{
|
||||
public static readonly ElevationDecision NotAsked = new(null, null, null);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// The admin mode (beta.10, D34), before anything is claimed or written: an elevated Agent started for another account
|
||||
/// stops (exit 11); an Agent told the answer was no says so; a plain <c>--serve</c> with the option on and no elevation —
|
||||
/// the logon task's — asks Windows once and hands over to the elevated Agent, or carries on as a standard user's.
|
||||
/// </summary>
|
||||
private static async Task<ElevationDecision> DecideElevationAsync(AgentCommandLine cmd, AgentPaths paths)
|
||||
{
|
||||
if (cmd.ForUser is { } sid)
|
||||
{
|
||||
if (!AgentElevation.IsCurrentUser(sid))
|
||||
{
|
||||
// The prompt was answered with another account's credentials: its %LOCALAPPDATA% is not this user's ledger.
|
||||
AgentConsole.Problem($"this elevated Agent runs as another account than the one that asked ({sid}); it exits (exit {AgentElevation.ExitOtherAccount})");
|
||||
return new ElevationDecision(null, AgentElevation.ExitOtherAccount, null);
|
||||
}
|
||||
|
||||
return new ElevationDecision(Environment.IsPrivilegedProcess ? AgentElevation.Granted : null, null, "started for this user by a UAC prompt");
|
||||
}
|
||||
|
||||
if (cmd.ElevationRefusal is { } refusal)
|
||||
{
|
||||
return new ElevationDecision(refusal, null, "the process that started this Agent asked Windows and got: " + refusal);
|
||||
}
|
||||
|
||||
if (Environment.IsPrivilegedProcess || !RunElevatedSetting.Read(paths.Database) || AgentInstanceLock.IsHeld(paths.DataDirectory))
|
||||
{
|
||||
// Elevated already (inherited), the option off, or an Agent already serves: nothing to ask; the claim decides the rest.
|
||||
return ElevationDecision.NotAsked;
|
||||
}
|
||||
|
||||
using ElevationMarker? marker = ElevationMarker.TryAcquire(paths.DataDirectory);
|
||||
if (marker is null)
|
||||
{
|
||||
AgentConsole.Problem($"another FrameLedger Agent is being started as administrator for {paths.DataDirectory}; this one exits (exit {AgentInstanceLock.ExitHeldElsewhere})");
|
||||
return new ElevationDecision(null, AgentInstanceLock.ExitHeldElsewhere, null);
|
||||
}
|
||||
|
||||
string arguments = "--serve --for-user " + AgentElevation.CurrentUserSid();
|
||||
using Process? elevated = AgentElevation.Start(Environment.ProcessPath ?? Path.Combine(AppContext.BaseDirectory, "FrameLedger.Agent.exe"),
|
||||
arguments, ownerWindow: 0, out string? refused, out int? error);
|
||||
if (elevated is null)
|
||||
{
|
||||
return new ElevationDecision(refused, null, $"the UAC prompt was {(string.Equals(refused, AgentElevation.Declined, StringComparison.Ordinal) ? "declined" : "not shown")} (error {error?.ToString(System.Globalization.CultureInfo.InvariantCulture) ?? "none"})");
|
||||
}
|
||||
|
||||
(bool claimed, int? code) = await AgentElevation.WaitForClaimAsync(elevated, paths.DataDirectory, TimeSpan.FromMinutes(2)).ConfigureAwait(false);
|
||||
if (claimed)
|
||||
{
|
||||
// Handed over: the elevated Agent logs its own start; this one writes nothing and leaves.
|
||||
return new ElevationDecision(null, _exitOk, null);
|
||||
}
|
||||
|
||||
return code == AgentElevation.ExitOtherAccount
|
||||
? new ElevationDecision(AgentElevation.OtherAccount, null, "the UAC prompt was answered with another account, whose Agent refused to run")
|
||||
: new ElevationDecision(AgentElevation.Failed, null, $"the elevated Agent did not start serving (exit {code?.ToString(System.Globalization.CultureInfo.InvariantCulture) ?? "none"})");
|
||||
}
|
||||
|
||||
/// <summary>The decision in the log, and what an elevated Agent's token has enabled (read, never changed: TokenPrivileges).</summary>
|
||||
private static void LogElevation(ElevationDecision elevation)
|
||||
{
|
||||
if (elevation.Outcome is { } outcome)
|
||||
{
|
||||
Log.Information("elevation: {Outcome} — {Detail}", outcome, elevation.Detail);
|
||||
}
|
||||
|
||||
if (Environment.IsPrivilegedProcess)
|
||||
{
|
||||
Log.Information("elevation: this Agent runs as administrator; enabled privileges: {Privileges}", string.Join(", ", TokenPrivileges.Enabled()));
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Null when a print verb refuses the ledger — at another schema, or not there — said on the console and in the log
|
||||
/// rather than as a crash: nothing about this machine is broken.
|
||||
@@ -236,9 +331,11 @@ internal static class Program
|
||||
}
|
||||
|
||||
/// <summary>The product's mode: a Generic Host around the watcher, stopped by Ctrl+C or the service manager.</summary>
|
||||
private static async Task<int> ServeAsync(LedgerDatabase db, AgentPaths paths)
|
||||
private static async Task<int> ServeAsync(LedgerDatabase db, AgentPaths paths, string? elevationOutcome)
|
||||
{
|
||||
HostApplicationBuilder builder = Host.CreateApplicationBuilder();
|
||||
// The admin mode's answer at this start (beta.10), for HelloAck.
|
||||
builder.Services.AddSingleton(new AgentElevationState(elevationOutcome));
|
||||
// The host's log into agent-*.log (2026-09-23). A background service that threw stopped the host with nothing in
|
||||
// the file: the Generic Host logs that through Microsoft.Extensions.Logging, which was never routed here.
|
||||
builder.Services.AddSerilog();
|
||||
|
||||
@@ -274,6 +274,12 @@ public partial class App : System.Windows.Application
|
||||
// FR-2.1 (P3 PR-4): the consent dialog and the request it ends in; the toggle that opens it is the game page's (PR-5).
|
||||
builder.Services.AddSingleton<IConsentPrompt, ConsentPrompt>();
|
||||
builder.Services.AddSingleton<HookingConsent>();
|
||||
// D33 (owner decision 2026-09-26): the user-mode exception's disclosure and the request it ends in; the list is
|
||||
// Settings', the button on a blocked game's page.
|
||||
builder.Services.AddSingleton<IAntiCheatExceptionPrompt, AntiCheatExceptionPrompt>();
|
||||
// The admin mode's disclosure (beta.10, D34), shown before capture.run_elevated is turned on.
|
||||
builder.Services.AddSingleton<IAgentAdminPrompt, AgentAdminPrompt>();
|
||||
builder.Services.AddSingleton<AntiCheatExceptions>();
|
||||
|
||||
AddLibrary(builder.Services);
|
||||
|
||||
@@ -304,7 +310,8 @@ public partial class App : System.Windows.Application
|
||||
/// <summary>The Agent over the pipe (07_IPC §Client behavior): connect, start it when it is not there, tell the shell.</summary>
|
||||
private static void AddAgentLink(IServiceCollection services)
|
||||
{
|
||||
services.AddSingleton<IAgentLauncher, AgentLauncher>();
|
||||
// The admin mode's prompt (beta.10) belongs to the main window; the handle is read when a start asks, never earlier.
|
||||
services.AddSingleton<IAgentLauncher>(static sp => AgentLauncher.ForApp(() => sp.GetRequiredService<ShellHost>().Handle));
|
||||
services.AddSingleton(static sp => new AgentConnection(
|
||||
sp.GetRequiredService<IAgentLauncher>(),
|
||||
static () => new PipeClient(),
|
||||
@@ -410,6 +417,8 @@ public partial class App : System.Windows.Application
|
||||
sp.GetRequiredService<IExecutableLocator>(),
|
||||
static line => Serilog.Log.Information("{Line}", line)));
|
||||
services.AddSingleton<IImportReview, ImportReviewPrompt>();
|
||||
// beta.11: the Games page on screen reloads when an import adds games (navigating to itself does nothing).
|
||||
services.AddSingleton<LibraryChanges>();
|
||||
services.AddSingleton<ImportLibraryFlow>();
|
||||
}
|
||||
|
||||
|
||||
@@ -40,4 +40,16 @@ public enum TrendMetric
|
||||
/// of the session, so it is treated as a mid-session change: left out by default, drawn marked when those are included.
|
||||
/// </summary>
|
||||
FgFactor,
|
||||
|
||||
/// <summary>
|
||||
/// The three below are beta.10's (<c>03_METRICS</c> §Display mode): the share of the session's observed time in a mode,
|
||||
/// every session whatever its tier — the window is read out of process. Exclusive fullscreen and borderless have a point
|
||||
/// only where the whole observed time could be told apart; a window that covered its monitor while nothing could ask the
|
||||
/// swap chain counts as neither.
|
||||
/// </summary>
|
||||
DisplayExclusiveShare,
|
||||
|
||||
DisplayBorderlessShare,
|
||||
|
||||
DisplayWindowedShare,
|
||||
}
|
||||
@@ -2,6 +2,7 @@ using System.Diagnostics.CodeAnalysis;
|
||||
using System.Globalization;
|
||||
using FrameLedger.App.Services;
|
||||
using FrameLedger.Application.Persistence;
|
||||
using FrameLedger.Domain.Display;
|
||||
using FrameLedger.Domain.Sessions;
|
||||
|
||||
namespace FrameLedger.App.Charts;
|
||||
@@ -44,13 +45,20 @@ public static class TrendSeriesBuilder
|
||||
/// <summary>How many sessions FR-6.4 leaves out at the default setting.</summary>
|
||||
public static int ExcludedCount(IReadOnlyList<SessionRow> rows) => ExcludedCount(rows, TrendMetric.PresentedFps);
|
||||
|
||||
/// <summary>Whether a session can have a point for <paramref name="metric"/>: a frame rate needs the hooks; the machine is every session's.</summary>
|
||||
/// <summary>
|
||||
/// Whether a session can have a point for <paramref name="metric"/>: a frame rate needs the hooks; the machine is every
|
||||
/// session's, and so is the display mode (beta.10) — the window is read out of process whether or not anything was hooked.
|
||||
/// </summary>
|
||||
public static bool Counts(SessionRow row, TrendMetric metric)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(row);
|
||||
return row.Tier == CaptureTier.Hooked || IsMachineMetric(metric);
|
||||
return row.Tier == CaptureTier.Hooked || IsMachineMetric(metric) || IsDisplayMetric(metric);
|
||||
}
|
||||
|
||||
/// <summary>The display-mode shares (beta.10).</summary>
|
||||
public static bool IsDisplayMetric(TrendMetric metric) =>
|
||||
metric is TrendMetric.DisplayExclusiveShare or TrendMetric.DisplayBorderlessShare or TrendMetric.DisplayWindowedShare;
|
||||
|
||||
/// <summary>The metrics that are telemetry, recorded by every session whatever its tier.</summary>
|
||||
public static bool IsMachineMetric(TrendMetric metric) => metric is TrendMetric.MaxGpuTemp or TrendMetric.AvgGpuLoad or TrendMetric.AvgGpuPower
|
||||
or TrendMetric.AvgCpuLoad or TrendMetric.MaxCpuTemp or TrendMetric.AvgRam;
|
||||
@@ -68,6 +76,13 @@ public static class TrendSeriesBuilder
|
||||
public static bool IsPartial(SessionRow row, TrendMetric metric)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(row);
|
||||
// A display share is the whole session's by construction (beta.10): switching between fullscreen and a window resizes
|
||||
// the swap chain, which is exactly what marks a session "settings changed" — the share is what that change was.
|
||||
if (IsDisplayMetric(metric))
|
||||
{
|
||||
return false;
|
||||
}
|
||||
|
||||
// A steady state (CLAUDE.md rule 6, 2026-09-17) is the factor's AND the Native / Displayed rates beside it: all three
|
||||
// describe the state the session spent most of its generating time in, never the whole session (beta.8).
|
||||
return row.SettingsChangedMidSession
|
||||
@@ -101,10 +116,27 @@ public static class TrendSeriesBuilder
|
||||
TrendMetric.MaxCpuTemp => row.MaxCpuTemp,
|
||||
TrendMetric.AvgRam => row.AvgRamMb,
|
||||
TrendMetric.FgFactor => readout.Kind == FpsReadoutKind.Generated ? readout.Factor : null,
|
||||
TrendMetric.DisplayExclusiveShare => DisplayShare(row, DisplayMode.ExclusiveFullscreen),
|
||||
TrendMetric.DisplayBorderlessShare => DisplayShare(row, DisplayMode.Borderless),
|
||||
TrendMetric.DisplayWindowedShare => DisplayShare(row, DisplayMode.Windowed),
|
||||
_ => null,
|
||||
};
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// A mode's share of the session's observed time (0–100), or null: no display facts on the row, no window ever read, or —
|
||||
/// for exclusive fullscreen and borderless — time the two could not be told apart, which would make either share a guess.
|
||||
/// </summary>
|
||||
private static double? DisplayShare(SessionRow row, DisplayMode mode)
|
||||
{
|
||||
if (DisplayText.Of(row) is not { ObservedMs: > 0 } display)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
return mode is DisplayMode.ExclusiveFullscreen or DisplayMode.Borderless && !display.ExclusivityKnown ? null : display.SharePercent(mode);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// One marker per day that changed (beta.8): every difference found on that day in one label, line after line — two
|
||||
/// labels at one position were drawn over each other.
|
||||
|
||||
@@ -0,0 +1,105 @@
|
||||
using System.Windows;
|
||||
using System.Windows.Controls;
|
||||
|
||||
namespace FrameLedger.App.Controls;
|
||||
|
||||
/// <summary>
|
||||
/// The library grid's panel (beta.11, owner request 2026-10-03: "the empty band on the right"): as many columns as
|
||||
/// <see cref="MinItemWidth"/> allows across the width it is given, every item stretched to an equal share of it, so a row
|
||||
/// is always full — a plain <see cref="WrapPanel"/> of 300 px cards left up to a card's width unused at the right. Each row
|
||||
/// is as tall as its tallest item. Not virtualizing: a library is hundreds of rows at most.
|
||||
/// </summary>
|
||||
public sealed class UniformWrapPanel : Panel
|
||||
{
|
||||
public static readonly DependencyProperty MinItemWidthProperty = DependencyProperty.Register(
|
||||
nameof(MinItemWidth), typeof(double), typeof(UniformWrapPanel), new FrameworkPropertyMetadata(300.0, FrameworkPropertyMetadataOptions.AffectsMeasure));
|
||||
|
||||
public static readonly DependencyProperty SpacingProperty = DependencyProperty.Register(
|
||||
nameof(Spacing), typeof(double), typeof(UniformWrapPanel), new FrameworkPropertyMetadata(12.0, FrameworkPropertyMetadataOptions.AffectsMeasure));
|
||||
|
||||
/// <summary>The narrowest an item may be; the column count is the most that fit at this width or wider.</summary>
|
||||
public double MinItemWidth
|
||||
{
|
||||
get => (double)GetValue(MinItemWidthProperty);
|
||||
set => SetValue(MinItemWidthProperty, value);
|
||||
}
|
||||
|
||||
/// <summary>The gap between columns and between rows.</summary>
|
||||
public double Spacing
|
||||
{
|
||||
get => (double)GetValue(SpacingProperty);
|
||||
set => SetValue(SpacingProperty, value);
|
||||
}
|
||||
|
||||
/// <summary>How many columns of at least <paramref name="minItemWidth"/> fit in <paramref name="width"/>, never fewer than one.</summary>
|
||||
public static int ColumnsFor(double width, double minItemWidth, double spacing)
|
||||
{
|
||||
if (double.IsNaN(width) || double.IsInfinity(width) || minItemWidth <= 0)
|
||||
{
|
||||
return 1;
|
||||
}
|
||||
|
||||
return Math.Max(1, (int)Math.Floor((width + spacing) / (minItemWidth + spacing)));
|
||||
}
|
||||
|
||||
/// <summary>Each item's width when <paramref name="columns"/> share <paramref name="width"/> with gaps between them.</summary>
|
||||
public static double ItemWidthFor(double width, int columns, double spacing) =>
|
||||
columns <= 0 ? 0 : Math.Max(0, (width - ((columns - 1) * spacing)) / columns);
|
||||
|
||||
protected override Size MeasureOverride(Size availableSize)
|
||||
{
|
||||
double width = double.IsInfinity(availableSize.Width) ? MinItemWidth : availableSize.Width;
|
||||
int columns = ColumnsFor(width, MinItemWidth, Spacing);
|
||||
double itemWidth = ItemWidthFor(width, columns, Spacing);
|
||||
double height = 0;
|
||||
double rowHeight = 0;
|
||||
int column = 0;
|
||||
int rows = 0;
|
||||
foreach (UIElement child in InternalChildren)
|
||||
{
|
||||
child.Measure(new Size(itemWidth, double.PositiveInfinity));
|
||||
rowHeight = Math.Max(rowHeight, child.DesiredSize.Height);
|
||||
if (++column == columns)
|
||||
{
|
||||
height += rowHeight;
|
||||
rows++;
|
||||
rowHeight = 0;
|
||||
column = 0;
|
||||
}
|
||||
}
|
||||
|
||||
if (column > 0)
|
||||
{
|
||||
height += rowHeight;
|
||||
rows++;
|
||||
}
|
||||
|
||||
return new Size(width, height + (Math.Max(0, rows - 1) * Spacing));
|
||||
}
|
||||
|
||||
protected override Size ArrangeOverride(Size finalSize)
|
||||
{
|
||||
int columns = ColumnsFor(finalSize.Width, MinItemWidth, Spacing);
|
||||
double itemWidth = ItemWidthFor(finalSize.Width, columns, Spacing);
|
||||
UIElement[] children = [.. InternalChildren.Cast<UIElement>()];
|
||||
double y = 0;
|
||||
for (int start = 0; start < children.Length; start += columns)
|
||||
{
|
||||
int end = Math.Min(start + columns, children.Length);
|
||||
double rowHeight = 0;
|
||||
for (int i = start; i < end; i++)
|
||||
{
|
||||
rowHeight = Math.Max(rowHeight, children[i].DesiredSize.Height);
|
||||
}
|
||||
|
||||
for (int i = start; i < end; i++)
|
||||
{
|
||||
children[i].Arrange(new Rect((i - start) * (itemWidth + Spacing), y, itemWidth, rowHeight));
|
||||
}
|
||||
|
||||
y += rowHeight + Spacing;
|
||||
}
|
||||
|
||||
return finalSize;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,35 @@
|
||||
<UserControl x:Class="FrameLedger.App.Dialogs.AgentAdminDialogContent"
|
||||
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
|
||||
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
|
||||
xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml"
|
||||
xmlns:vm="clr-namespace:FrameLedger.App.ViewModels"
|
||||
d:DataContext="{d:DesignInstance Type=vm:AgentAdminDialogViewModel}"
|
||||
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
|
||||
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
|
||||
mc:Ignorable="d"
|
||||
MaxWidth="640">
|
||||
<!--
|
||||
The admin mode's disclosure (beta.10, D34; 19_SAFETY §Elevated targets), text from FrameLedger.Shared's
|
||||
Safety_AdminMode_* only, versioned by AgentAdminDisclosure.Version. It states what the option adds, what it does not
|
||||
change, how Windows asks, and the risk; every colour is a theme brush.
|
||||
-->
|
||||
<ScrollViewer MaxHeight="520" VerticalScrollBarVisibility="Auto">
|
||||
<StackPanel>
|
||||
<ui:TextBlock Text="{x:Static vm:AgentAdminDialogViewModel.Intro}" TextWrapping="Wrap" />
|
||||
<ui:TextBlock Margin="0,14,0,0" Text="{x:Static vm:AgentAdminDialogViewModel.Adds}" TextWrapping="Wrap" />
|
||||
<ui:TextBlock Margin="0,8,0,0" Text="{x:Static vm:AgentAdminDialogViewModel.Unchanged}" TextWrapping="Wrap" />
|
||||
<ui:TextBlock Margin="0,8,0,0" Text="{x:Static vm:AgentAdminDialogViewModel.Prompt}" TextWrapping="Wrap" />
|
||||
|
||||
<Border Margin="0,14,0,0" Padding="12" CornerRadius="6" Background="{DynamicResource CardBackgroundFillColorDefaultBrush}">
|
||||
<ui:TextBlock FontWeight="SemiBold" Text="{x:Static vm:AgentAdminDialogViewModel.Risk}" TextWrapping="Wrap" />
|
||||
</Border>
|
||||
|
||||
<CheckBox x:Name="Acceptance"
|
||||
Margin="0,18,0,0"
|
||||
AutomationProperties.Name="{x:Static vm:AgentAdminDialogViewModel.AcceptText}"
|
||||
Content="{x:Static vm:AgentAdminDialogViewModel.AcceptText}"
|
||||
IsChecked="{Binding Accepted, Mode=TwoWay}" />
|
||||
<ui:TextBlock Margin="0,12,0,0" HorizontalAlignment="Right" Appearance="Tertiary" Text="{x:Static vm:AgentAdminDialogViewModel.Version}" />
|
||||
</StackPanel>
|
||||
</ScrollViewer>
|
||||
</UserControl>
|
||||
@@ -0,0 +1,18 @@
|
||||
using System.Windows.Controls;
|
||||
using FrameLedger.App.ViewModels;
|
||||
|
||||
namespace FrameLedger.App.Dialogs;
|
||||
|
||||
/// <summary>The body of the admin mode's <c>ContentDialog</c>; the buttons are the dialog's own (<see cref="Services.AgentAdminPrompt"/>).</summary>
|
||||
public partial class AgentAdminDialogContent : UserControl
|
||||
{
|
||||
public AgentAdminDialogContent(AgentAdminDialogViewModel viewModel)
|
||||
{
|
||||
ViewModel = viewModel ?? throw new ArgumentNullException(nameof(viewModel));
|
||||
DataContext = viewModel;
|
||||
InitializeComponent();
|
||||
Loaded += (_, _) => Acceptance.Focus();
|
||||
}
|
||||
|
||||
public AgentAdminDialogViewModel ViewModel { get; }
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
<UserControl x:Class="FrameLedger.App.Dialogs.AntiCheatExceptionDialogContent"
|
||||
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
|
||||
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
|
||||
xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml"
|
||||
xmlns:vm="clr-namespace:FrameLedger.App.ViewModels"
|
||||
d:DataContext="{d:DesignInstance Type=vm:AntiCheatExceptionDialogViewModel}"
|
||||
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
|
||||
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
|
||||
mc:Ignorable="d"
|
||||
MaxWidth="640">
|
||||
<!--
|
||||
D33's disclosure (19_SAFETY §The user-mode exception), text from FrameLedger.Shared's Safety_Exception_* only,
|
||||
versioned by AntiCheatExceptionDisclosure.Version. It states why the exception is offered, the risk, what is still
|
||||
refused, how it ends, and that it turns nothing on; it recommends neither choice. Every colour is a theme brush.
|
||||
-->
|
||||
<ScrollViewer MaxHeight="520" VerticalScrollBarVisibility="Auto">
|
||||
<StackPanel>
|
||||
<ui:TextBlock Text="{Binding Intro}" TextWrapping="Wrap" />
|
||||
<ui:TextBlock Margin="0,14,0,0" Text="{Binding Why}" TextWrapping="Wrap" />
|
||||
<ui:TextBlock Margin="0,8,0,0" FontWeight="SemiBold" Text="{x:Static vm:AntiCheatExceptionDialogViewModel.Trial}" TextWrapping="Wrap" />
|
||||
|
||||
<Border Margin="0,14,0,0" Padding="12" CornerRadius="6" Background="{DynamicResource CardBackgroundFillColorDefaultBrush}">
|
||||
<ui:TextBlock FontWeight="SemiBold" Text="{Binding Risk}" TextWrapping="Wrap" />
|
||||
</Border>
|
||||
|
||||
<ui:TextBlock Margin="0,14,0,0" Text="{Binding Still}" TextWrapping="Wrap" />
|
||||
<ui:TextBlock Margin="0,8,0,0" Text="{x:Static vm:AntiCheatExceptionDialogViewModel.Ends}" TextWrapping="Wrap" />
|
||||
<ui:TextBlock Margin="0,8,0,0" Text="{x:Static vm:AntiCheatExceptionDialogViewModel.Next}" TextWrapping="Wrap" />
|
||||
<ui:TextBlock Margin="0,8,0,0" FontWeight="SemiBold" Text="{x:Static vm:AntiCheatExceptionDialogViewModel.Online}" TextWrapping="Wrap" />
|
||||
|
||||
<CheckBox x:Name="Acceptance"
|
||||
Margin="0,18,0,0"
|
||||
AutomationProperties.Name="{x:Static vm:AntiCheatExceptionDialogViewModel.AcceptText}"
|
||||
Content="{x:Static vm:AntiCheatExceptionDialogViewModel.AcceptText}"
|
||||
IsChecked="{Binding Accepted, Mode=TwoWay}" />
|
||||
</StackPanel>
|
||||
</ScrollViewer>
|
||||
</UserControl>
|
||||
@@ -0,0 +1,18 @@
|
||||
using System.Windows.Controls;
|
||||
using FrameLedger.App.ViewModels;
|
||||
|
||||
namespace FrameLedger.App.Dialogs;
|
||||
|
||||
/// <summary>The body of D33's <c>ContentDialog</c>; the buttons are the dialog's own (<see cref="Services.AntiCheatExceptionPrompt"/>).</summary>
|
||||
public partial class AntiCheatExceptionDialogContent : UserControl
|
||||
{
|
||||
public AntiCheatExceptionDialogContent(AntiCheatExceptionDialogViewModel viewModel)
|
||||
{
|
||||
ViewModel = viewModel ?? throw new ArgumentNullException(nameof(viewModel));
|
||||
DataContext = viewModel;
|
||||
InitializeComponent();
|
||||
Loaded += (_, _) => Acceptance.Focus();
|
||||
}
|
||||
|
||||
public AntiCheatExceptionDialogViewModel ViewModel { get; }
|
||||
}
|
||||
@@ -10,14 +10,35 @@
|
||||
MinWidth="640">
|
||||
<!--
|
||||
FR-1.2's review checklist: nothing is added until the user says which; a row that is already in the library
|
||||
or has no executable cannot be ticked. Import never enables hooking (the intro says so).
|
||||
or has no executable cannot be ticked (its box is disabled since beta.11 - before, a tick was taken and ignored).
|
||||
Rows already in the library are hidden unless "Show the N games already in the library" is ticked, and then
|
||||
dimmed. Import never enables hooking (the intro says so).
|
||||
-->
|
||||
<StackPanel>
|
||||
<ui:TextBlock TextWrapping="Wrap" Text="{x:Static vm:ImportReviewViewModel.Intro}" />
|
||||
<CheckBox Margin="0,8,0,0" Content="{Binding ShowExistingText}" IsChecked="{Binding ShowExisting, Mode=TwoWay}"
|
||||
Visibility="{Binding HasExisting, Converter={StaticResource BoolToVis}}" />
|
||||
<DataGrid Margin="0,10,0,8" MaxHeight="360" AutoGenerateColumns="False" CanUserAddRows="False" HeadersVisibility="Column"
|
||||
ItemsSource="{Binding Rows}" SelectionMode="Single" IsReadOnly="False">
|
||||
ItemsSource="{Binding Shown}" SelectionMode="Single" IsReadOnly="False">
|
||||
<DataGrid.RowStyle>
|
||||
<Style TargetType="DataGridRow" BasedOn="{StaticResource {x:Type DataGridRow}}">
|
||||
<Style.Triggers>
|
||||
<DataTrigger Binding="{Binding IsExisting}" Value="True">
|
||||
<Setter Property="Opacity" Value="0.55" />
|
||||
</DataTrigger>
|
||||
</Style.Triggers>
|
||||
</Style>
|
||||
</DataGrid.RowStyle>
|
||||
<DataGrid.Columns>
|
||||
<DataGridCheckBoxColumn Binding="{Binding IsSelected, UpdateSourceTrigger=PropertyChanged}" Width="40" />
|
||||
<DataGridTemplateColumn Width="40">
|
||||
<DataGridTemplateColumn.CellTemplate>
|
||||
<DataTemplate>
|
||||
<CheckBox HorizontalAlignment="Center" IsEnabled="{Binding CanImport}"
|
||||
AutomationProperties.Name="{Binding Name}"
|
||||
IsChecked="{Binding IsSelected, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}" />
|
||||
</DataTemplate>
|
||||
</DataGridTemplateColumn.CellTemplate>
|
||||
</DataGridTemplateColumn>
|
||||
<DataGridTextColumn Header="{x:Static vm:ImportReviewViewModel.ColumnPlatform}" Binding="{Binding PlatformText}" IsReadOnly="True" Width="Auto" />
|
||||
<DataGridTextColumn Header="{x:Static vm:ImportReviewViewModel.ColumnName}" Binding="{Binding Name}" IsReadOnly="True" Width="2*" />
|
||||
<DataGridTextColumn Header="{x:Static vm:ImportReviewViewModel.ColumnExe}" Binding="{Binding ExeText}" IsReadOnly="True" Width="3*" />
|
||||
|
||||
@@ -45,6 +45,8 @@
|
||||
<EmbeddedResource Include="..\..\legal\DISCLAIMER.md" LogicalName="legal/DISCLAIMER.md" />
|
||||
<EmbeddedResource Include="..\..\legal\PRIVACY_POLICY.md" LogicalName="legal/PRIVACY_POLICY.md" />
|
||||
<EmbeddedResource Include="..\..\LICENSE" LogicalName="LICENSE" />
|
||||
<!-- beta.10 (D36): what the whole software cannot do, shown under Help > Limitations; information, not one of FR-11's accepted documents. -->
|
||||
<EmbeddedResource Include="..\..\LIMITATIONS.md" LogicalName="LIMITATIONS.md" />
|
||||
</ItemGroup>
|
||||
|
||||
<ItemGroup>
|
||||
|
||||
@@ -71,6 +71,7 @@
|
||||
<MenuItem Header="{x:Static res:Strings.Menu_Help_CheckUpdates}" Command="{Binding ViewModel.CheckForUpdatesCommand}" />
|
||||
<MenuItem Header="{x:Static res:Strings.Menu_Help_ReportBug}" Command="{Binding ViewModel.ReportBugCommand}" />
|
||||
<MenuItem Header="{x:Static res:Strings.Menu_Help_Documentation}" Command="{Binding ViewModel.DocumentationCommand}" />
|
||||
<MenuItem Header="{x:Static res:Strings.Menu_Help_Limitations}" Command="{Binding ViewModel.LimitationsCommand}" />
|
||||
<Separator />
|
||||
<MenuItem Header="{x:Static res:Strings.Menu_Help_About}" Command="{Binding ViewModel.AboutCommand}" />
|
||||
</MenuItem>
|
||||
|
||||
@@ -150,6 +150,33 @@
|
||||
</ui:CardControl.Header>
|
||||
</ui:CardControl>
|
||||
|
||||
<!-- D33 (owner decision 2026-09-26): the user-mode exception on a blocked game, its state the Agent's (19_SAFETY §The user-mode exception) -->
|
||||
<ui:CardControl Margin="0,12,0,0" Icon="{ui:SymbolIcon ShieldTask24}"
|
||||
Visibility="{Binding ViewModel.ExceptionCardVisible, Converter={StaticResource BoolToVis}}">
|
||||
<ui:CardControl.Header>
|
||||
<StackPanel>
|
||||
<ui:TextBlock FontTypography="BodyStrong" Text="{x:Static vm:GameDetailViewModel.ExceptionHeader}" />
|
||||
<ui:TextBlock Appearance="Secondary" TextWrapping="Wrap" Text="{Binding ViewModel.ExceptionText}" />
|
||||
<ui:TextBlock Appearance="Secondary" TextWrapping="Wrap" Text="{Binding ViewModel.ExceptionInForceText}"
|
||||
Visibility="{Binding ViewModel.ExceptionInForceText, Converter={StaticResource NullToCollapsed}}" />
|
||||
<ui:TextBlock Appearance="Secondary" TextWrapping="Wrap" Text="{Binding ViewModel.ExceptionSuspendedText}"
|
||||
Visibility="{Binding ViewModel.ExceptionSuspendedText, Converter={StaticResource NullToCollapsed}}" />
|
||||
<ui:TextBlock Appearance="Tertiary" TextWrapping="Wrap" Text="{Binding ViewModel.ExceptionLapseText}"
|
||||
Visibility="{Binding ViewModel.ExceptionLapseText, Converter={StaticResource NullToCollapsed}}" />
|
||||
</StackPanel>
|
||||
</ui:CardControl.Header>
|
||||
<StackPanel Orientation="Horizontal">
|
||||
<ui:Button Appearance="Secondary"
|
||||
Command="{Binding ViewModel.GrantExceptionCommand}"
|
||||
Content="{x:Static vm:GameDetailViewModel.GrantExceptionText}"
|
||||
Visibility="{Binding ViewModel.CanGrantException, Converter={StaticResource BoolToVis}}" />
|
||||
<ui:Button Appearance="Secondary"
|
||||
Command="{Binding ViewModel.WithdrawExceptionCommand}"
|
||||
Content="{x:Static vm:GameDetailViewModel.WithdrawExceptionText}"
|
||||
Visibility="{Binding ViewModel.CanWithdrawException, Converter={StaticResource BoolToVis}}" />
|
||||
</StackPanel>
|
||||
</ui:CardControl>
|
||||
|
||||
<!-- hooking control (FR-2.1 / FR-2.2 / FR-2.5) -->
|
||||
<StackPanel Visibility="{Binding ViewModel.HookingSectionVisible, Converter={StaticResource BoolToVis}}">
|
||||
<ui:CardControl Margin="0,12,0,0" Header="{x:Static vm:GameDetailViewModel.HookingHeader}" Icon="{ui:SymbolIcon ShieldTask24}">
|
||||
@@ -229,6 +256,14 @@
|
||||
<DataGridTextColumn Header="{x:Static res:Strings.Sessions_Col_Resolution}" Binding="{Binding ResolutionText}" />
|
||||
<DataGridTextColumn Header="{x:Static res:Strings.Sessions_Col_GpuTemp}" Binding="{Binding GpuTempText}" />
|
||||
<DataGridTextColumn Header="{x:Static res:Strings.Sessions_Col_Api}" Binding="{Binding ApiText}" />
|
||||
<!-- beta.10: both tiers; the tooltip carries every share, the window, the back buffer and the source -->
|
||||
<DataGridTemplateColumn Header="{x:Static res:Strings.Sessions_Col_Display}">
|
||||
<DataGridTemplateColumn.CellTemplate>
|
||||
<DataTemplate DataType="{x:Type vm:SessionItemViewModel}">
|
||||
<TextBlock Text="{Binding DisplayModeText}" ToolTip="{Binding DisplayModeTooltip}" />
|
||||
</DataTemplate>
|
||||
</DataGridTemplateColumn.CellTemplate>
|
||||
</DataGridTemplateColumn>
|
||||
<DataGridTemplateColumn>
|
||||
<DataGridTemplateColumn.CellTemplate>
|
||||
<DataTemplate DataType="{x:Type vm:SessionItemViewModel}">
|
||||
|
||||
@@ -4,10 +4,16 @@
|
||||
xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml"
|
||||
xmlns:res="clr-namespace:FrameLedger.App"
|
||||
xmlns:vm="clr-namespace:FrameLedger.App.ViewModels"
|
||||
xmlns:controls="clr-namespace:FrameLedger.App.Controls"
|
||||
Title="{x:Static res:Strings.Games_Header}"
|
||||
AllowDrop="True"
|
||||
Drop="OnDrop">
|
||||
<!-- 08_UI §Games: cards (ui:CardAction), search, sort; FR-1.1 add by pick or by dropping an .exe here. -->
|
||||
<!--
|
||||
08_UI §Games: search, sort, FR-1.1 add by pick or by dropping an .exe here. Since beta.11 (owner requests 2026-10-03):
|
||||
the count in the title; a grid of cards that fills the width (UniformWrapPanel - a WrapPanel of 300 px cards left a
|
||||
card's width unused at the right) or a list (ui.library_view); Refresh reads the library again, offers the games the
|
||||
stores installed since, and marks the entries whose executable is gone.
|
||||
-->
|
||||
<ScrollViewer>
|
||||
<StackPanel Style="{StaticResource PageRoot}">
|
||||
<Grid>
|
||||
@@ -16,8 +22,10 @@
|
||||
<ColumnDefinition Width="Auto" />
|
||||
<ColumnDefinition Width="Auto" />
|
||||
<ColumnDefinition Width="Auto" />
|
||||
<ColumnDefinition Width="Auto" />
|
||||
<ColumnDefinition Width="Auto" />
|
||||
</Grid.ColumnDefinitions>
|
||||
<ui:TextBlock Grid.Column="0" FontTypography="Title" Text="{x:Static vm:GamesViewModel.Header}" />
|
||||
<ui:TextBlock Grid.Column="0" FontTypography="Title" Text="{Binding ViewModel.HeaderText}" />
|
||||
<ui:TextBox Grid.Column="1" MinWidth="220" Margin="0,0,12,0" VerticalAlignment="Center"
|
||||
AutomationProperties.Name="{x:Static vm:GamesViewModel.SearchPlaceholder}"
|
||||
Icon="{ui:SymbolIcon Search24}"
|
||||
@@ -29,7 +37,21 @@
|
||||
ItemsSource="{x:Static vm:GamesViewModel.Sorts}"
|
||||
SelectedValue="{Binding ViewModel.Sort, Mode=TwoWay}"
|
||||
SelectedValuePath="Value" />
|
||||
<ui:Button Grid.Column="3" Appearance="Primary" VerticalAlignment="Center"
|
||||
<!-- The view switch: the one button shown is the other view. -->
|
||||
<StackPanel Grid.Column="3" Margin="0,0,8,0" VerticalAlignment="Center" Orientation="Horizontal">
|
||||
<ui:Button Appearance="Secondary" Command="{Binding ViewModel.ShowListCommand}" Icon="{ui:SymbolIcon AppsList24}"
|
||||
ToolTip="{x:Static vm:GamesViewModel.ListText}" AutomationProperties.Name="{x:Static vm:GamesViewModel.ListText}"
|
||||
Visibility="{Binding ViewModel.ListView, Converter={StaticResource InverseBoolToVis}}" />
|
||||
<ui:Button Appearance="Secondary" Command="{Binding ViewModel.ShowGridCommand}" Icon="{ui:SymbolIcon Grid24}"
|
||||
ToolTip="{x:Static vm:GamesViewModel.GridText}" AutomationProperties.Name="{x:Static vm:GamesViewModel.GridText}"
|
||||
Visibility="{Binding ViewModel.ListView, Converter={StaticResource BoolToVis}}" />
|
||||
</StackPanel>
|
||||
<ui:Button Grid.Column="4" Margin="0,0,12,0" Appearance="Secondary" VerticalAlignment="Center"
|
||||
Command="{Binding ViewModel.RefreshCommand}"
|
||||
Content="{x:Static vm:GamesViewModel.RefreshText}"
|
||||
ToolTip="{x:Static vm:GamesViewModel.RefreshToolTip}"
|
||||
Icon="{ui:SymbolIcon ArrowClockwise24}" />
|
||||
<ui:Button Grid.Column="5" Appearance="Primary" VerticalAlignment="Center"
|
||||
Command="{Binding ViewModel.AddGameCommand}"
|
||||
Content="{x:Static vm:GamesViewModel.AddText}"
|
||||
Icon="{ui:SymbolIcon Add24}" />
|
||||
@@ -42,34 +64,42 @@
|
||||
Text="{x:Static vm:GamesViewModel.NoMatchText}"
|
||||
Visibility="{Binding ViewModel.NoMatch, Converter={StaticResource BoolToVis}}" />
|
||||
|
||||
<ItemsControl Margin="0,16,0,0" ItemsSource="{Binding ViewModel.Games}">
|
||||
<!-- The grid: as many columns as fit at 300 px or wider, each card an equal share of the width. -->
|
||||
<ItemsControl x:Name="CardGrid" Margin="0,16,0,0" ItemsSource="{Binding ViewModel.Games}"
|
||||
Visibility="{Binding ViewModel.ListView, Converter={StaticResource InverseBoolToVis}}">
|
||||
<ItemsControl.ItemsPanel>
|
||||
<ItemsPanelTemplate>
|
||||
<WrapPanel />
|
||||
<controls:UniformWrapPanel MinItemWidth="300" Spacing="12" />
|
||||
</ItemsPanelTemplate>
|
||||
</ItemsControl.ItemsPanel>
|
||||
<ItemsControl.ItemTemplate>
|
||||
<DataTemplate DataType="{x:Type vm:GameCardViewModel}">
|
||||
<ui:CardAction Width="300" Margin="0,0,12,12" IsChevronVisible="False"
|
||||
<ui:CardAction IsChevronVisible="False" VerticalAlignment="Stretch" VerticalContentAlignment="Top"
|
||||
Command="{Binding DataContext.ViewModel.OpenCommand, RelativeSource={RelativeSource AncestorType=Page}}"
|
||||
CommandParameter="{Binding}"
|
||||
Icon="{ui:SymbolIcon Games24}">
|
||||
<StackPanel>
|
||||
<ui:TextBlock FontTypography="BodyStrong" Text="{Binding Name}" TextTrimming="CharacterEllipsis" />
|
||||
<StackPanel Orientation="Horizontal" Margin="0,4,0,0">
|
||||
<Border Style="{StaticResource TagPill}" Margin="0,0,6,0"
|
||||
<!-- Pills wrap to a second line rather than being cut (the third one was, at 300 px). -->
|
||||
<WrapPanel Margin="0,4,0,0">
|
||||
<Border Style="{StaticResource TagPill}" Margin="0,0,6,4"
|
||||
Visibility="{Binding HasPlatform, Converter={StaticResource BoolToVis}}">
|
||||
<TextBlock Style="{StaticResource TagPillText}" Text="{Binding PlatformText}" />
|
||||
</Border>
|
||||
<Border Style="{StaticResource TagPill}" Margin="0,0,6,0"
|
||||
<Border Style="{StaticResource TagPill}" Margin="0,0,6,4"
|
||||
Visibility="{Binding HasEngine, Converter={StaticResource BoolToVis}}">
|
||||
<TextBlock Style="{StaticResource TagPillText}" Text="{Binding EngineText}" />
|
||||
</Border>
|
||||
<Border Style="{StaticResource HookStatePill}">
|
||||
<Border Style="{StaticResource HookStatePill}" Margin="0,0,6,4">
|
||||
<TextBlock Style="{StaticResource HookStatePillText}" Text="{Binding HookText}" />
|
||||
</Border>
|
||||
</StackPanel>
|
||||
<ui:TextBlock Margin="0,6,0,0" Appearance="Secondary" Text="{Binding SessionsText}" />
|
||||
<Border x:Name="NotInstalledPill" Style="{StaticResource TagPill}" Margin="0,0,6,4"
|
||||
ToolTip="{Binding NotInstalledToolTip}"
|
||||
Visibility="{Binding NotInstalled, Converter={StaticResource BoolToVis}}">
|
||||
<TextBlock Style="{StaticResource TagPillText}" Text="{x:Static res:Strings.Games_Card_NotInstalled}" />
|
||||
</Border>
|
||||
</WrapPanel>
|
||||
<ui:TextBlock Margin="0,2,0,0" Appearance="Secondary" Text="{Binding SessionsText}" />
|
||||
<ui:TextBlock Appearance="Secondary" Text="{Binding PlaytimeText}" />
|
||||
<ui:TextBlock Appearance="Secondary" Text="{Binding LastPlayedText}" />
|
||||
</StackPanel>
|
||||
@@ -77,6 +107,29 @@
|
||||
</DataTemplate>
|
||||
</ItemsControl.ItemTemplate>
|
||||
</ItemsControl>
|
||||
|
||||
<!-- The list: one row per game across the width; double-click or Enter opens it. -->
|
||||
<DataGrid x:Name="GameList" Margin="0,16,0,0" AutoGenerateColumns="False" CanUserAddRows="False" CanUserDeleteRows="False"
|
||||
CanUserSortColumns="False" HeadersVisibility="Column" IsReadOnly="True" SelectionMode="Single"
|
||||
ItemsSource="{Binding ViewModel.Games}"
|
||||
MouseDoubleClick="OnListDoubleClick" KeyDown="OnListKeyDown"
|
||||
Visibility="{Binding ViewModel.ListView, Converter={StaticResource BoolToVis}}">
|
||||
<DataGrid.Columns>
|
||||
<DataGridTextColumn Header="{x:Static res:Strings.Games_List_Name}" Binding="{Binding Name}" Width="3*" />
|
||||
<DataGridTextColumn Header="{x:Static res:Strings.Games_List_Store}" Binding="{Binding PlatformText}" Width="Auto" />
|
||||
<DataGridTextColumn Header="{x:Static res:Strings.Games_List_Engine}" Binding="{Binding EngineText}" Width="*" />
|
||||
<DataGridTemplateColumn Header="{x:Static res:Strings.Games_List_Status}" Width="*">
|
||||
<DataGridTemplateColumn.CellTemplate>
|
||||
<DataTemplate>
|
||||
<TextBlock Margin="4,0" VerticalAlignment="Center" Text="{Binding StatusText}" ToolTip="{Binding NotInstalledToolTip}" />
|
||||
</DataTemplate>
|
||||
</DataGridTemplateColumn.CellTemplate>
|
||||
</DataGridTemplateColumn>
|
||||
<DataGridTextColumn Header="{x:Static res:Strings.Games_List_Sessions}" Binding="{Binding SessionCount}" Width="Auto" />
|
||||
<DataGridTextColumn Header="{x:Static res:Strings.Games_List_Played}" Binding="{Binding PlaytimeValue}" Width="Auto" />
|
||||
<DataGridTextColumn Header="{x:Static res:Strings.Games_List_LastPlayed}" Binding="{Binding LastPlayedValue}" Width="Auto" />
|
||||
</DataGrid.Columns>
|
||||
</DataGrid>
|
||||
</StackPanel>
|
||||
</ScrollViewer>
|
||||
</Page>
|
||||
@@ -1,4 +1,5 @@
|
||||
using System.Windows;
|
||||
using System.Windows.Input;
|
||||
using FrameLedger.App.ViewModels;
|
||||
using Wpf.Ui.Abstractions.Controls;
|
||||
|
||||
@@ -11,6 +12,9 @@ public partial class GamesPage : INavigableView<GamesViewModel>
|
||||
ViewModel = viewModel ?? throw new ArgumentNullException(nameof(viewModel));
|
||||
DataContext = this;
|
||||
InitializeComponent();
|
||||
// beta.11: the page reloads itself while it is on screen (a session ends, an import adds games), and lets go after.
|
||||
Loaded += (_, _) => ViewModel.Attach();
|
||||
Unloaded += (_, _) => ViewModel.Detach();
|
||||
}
|
||||
|
||||
public GamesViewModel ViewModel { get; }
|
||||
@@ -23,4 +27,25 @@ public partial class GamesPage : INavigableView<GamesViewModel>
|
||||
_ = ViewModel.DropAsync(paths);
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>The list view opens a game on a double-click, as the cards do on a click.</summary>
|
||||
private void OnListDoubleClick(object sender, MouseButtonEventArgs e) => OpenSelected();
|
||||
|
||||
/// <summary>…and on Enter, so the list is usable from the keyboard.</summary>
|
||||
private void OnListKeyDown(object sender, KeyEventArgs e)
|
||||
{
|
||||
if (e.Key == Key.Enter)
|
||||
{
|
||||
OpenSelected();
|
||||
e.Handled = true;
|
||||
}
|
||||
}
|
||||
|
||||
private void OpenSelected()
|
||||
{
|
||||
if (GameList.SelectedItem is GameCardViewModel card)
|
||||
{
|
||||
ViewModel.OpenCommand.Execute(card);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -66,6 +66,69 @@
|
||||
IsChecked="{Binding ViewModel.HideAntiCheatHooking, Mode=TwoWay}" />
|
||||
</ui:CardControl>
|
||||
|
||||
<!-- D33 (owner decision 2026-09-26): the user-mode anti-cheat exception — the option, off by default, and the games it concerns. -->
|
||||
<ui:CardExpander Margin="0,8,0,0" IsExpanded="{Binding ViewModel.UserModeExceptions, Mode=OneWay}" Icon="{ui:SymbolIcon ShieldTask24}">
|
||||
<ui:CardExpander.Header>
|
||||
<Grid>
|
||||
<Grid.ColumnDefinitions>
|
||||
<ColumnDefinition Width="*" />
|
||||
<ColumnDefinition Width="Auto" />
|
||||
</Grid.ColumnDefinitions>
|
||||
<StackPanel Grid.Column="0">
|
||||
<ui:TextBlock FontTypography="BodyStrong" Text="{x:Static res:Strings.Settings_Exceptions_Label}" TextWrapping="Wrap" />
|
||||
<ui:TextBlock MaxWidth="520" HorizontalAlignment="Left" Appearance="Secondary" TextWrapping="Wrap"
|
||||
Text="{x:Static res:Strings.Settings_Exceptions_Body}" />
|
||||
</StackPanel>
|
||||
<ui:ToggleSwitch Grid.Column="1" Margin="12,0" AutomationProperties.Name="{x:Static res:Strings.Settings_Exceptions_Label}"
|
||||
IsChecked="{Binding ViewModel.UserModeExceptions, Mode=TwoWay}" />
|
||||
</Grid>
|
||||
</ui:CardExpander.Header>
|
||||
<StackPanel>
|
||||
<ui:TextBlock FontTypography="BodyStrong" Text="{x:Static res:Strings.Settings_Exceptions_Header}" />
|
||||
<ui:TextBlock Appearance="Secondary" TextWrapping="Wrap" Text="{x:Static res:Strings.Settings_Exceptions_Suspended}"
|
||||
Visibility="{Binding ViewModel.ExceptionsSuspended, Converter={StaticResource BoolToVis}}" />
|
||||
<ui:TextBlock Appearance="Secondary" TextWrapping="Wrap" Text="{x:Static res:Strings.Settings_Exceptions_Checking}"
|
||||
Visibility="{Binding ViewModel.ExceptionsChecking, Converter={StaticResource BoolToVis}}" />
|
||||
<ui:TextBlock Appearance="Secondary" Text="{x:Static res:Strings.Settings_Exceptions_Empty}"
|
||||
Visibility="{Binding ViewModel.ExceptionGames.Count, Converter={StaticResource ZeroToVisible}}" />
|
||||
<ItemsControl ItemsSource="{Binding ViewModel.ExceptionGames}">
|
||||
<ItemsControl.ItemTemplate>
|
||||
<DataTemplate>
|
||||
<Grid Margin="0,6">
|
||||
<Grid.ColumnDefinitions>
|
||||
<ColumnDefinition Width="*" />
|
||||
<ColumnDefinition Width="Auto" />
|
||||
</Grid.ColumnDefinitions>
|
||||
<StackPanel Grid.Column="0">
|
||||
<ui:TextBlock FontTypography="BodyStrong" Text="{Binding Name}" />
|
||||
<ui:TextBlock Appearance="Secondary" TextWrapping="Wrap" Text="{Binding FindingText}" />
|
||||
<ui:TextBlock Appearance="Secondary" TextWrapping="Wrap" Text="{Binding StateText}" />
|
||||
<ui:TextBlock Appearance="Tertiary" TextWrapping="Wrap" Text="{Binding LapseText}"
|
||||
Visibility="{Binding LapseText, Converter={StaticResource NullToCollapsed}}" />
|
||||
</StackPanel>
|
||||
<StackPanel Grid.Column="1" Margin="12,0,0,0" VerticalAlignment="Center" Orientation="Horizontal">
|
||||
<ui:Button Appearance="Secondary"
|
||||
Command="{Binding GrantCommand}"
|
||||
Content="{x:Static res:Strings.Settings_Exceptions_Grant}"
|
||||
Visibility="{Binding CanGrant, Converter={StaticResource BoolToVis}}" />
|
||||
<ui:Button Appearance="Secondary"
|
||||
Command="{Binding WithdrawCommand}"
|
||||
Content="{x:Static res:Strings.Settings_Exceptions_Withdraw}"
|
||||
Visibility="{Binding CanWithdraw, Converter={StaticResource BoolToVis}}" />
|
||||
</StackPanel>
|
||||
</Grid>
|
||||
</DataTemplate>
|
||||
</ItemsControl.ItemTemplate>
|
||||
</ItemsControl>
|
||||
<!-- Only while the Agent is still answering: the sweep publishes nothing, so this is how its answer arrives. -->
|
||||
<ui:Button Margin="0,8,0,0"
|
||||
Appearance="Secondary"
|
||||
Command="{Binding ViewModel.RefreshExceptionsCommand}"
|
||||
Content="{x:Static res:Strings.Settings_Exceptions_Refresh}"
|
||||
Visibility="{Binding ViewModel.ExceptionsChecking, Converter={StaticResource BoolToVis}}" />
|
||||
</StackPanel>
|
||||
</ui:CardExpander>
|
||||
|
||||
<ui:CardExpander Margin="0,8,0,0" Icon="{ui:SymbolIcon Layer24}">
|
||||
<ui:CardExpander.Header>
|
||||
<Grid>
|
||||
@@ -162,6 +225,16 @@
|
||||
</ui:CardExpander.Header>
|
||||
<ui:TextBlock Appearance="Secondary" Text="{x:Static res:Strings.Settings_Agent_Elevation_Body}" TextWrapping="Wrap" />
|
||||
</ui:CardExpander>
|
||||
<!-- beta.10, the admin mode (D34): off by default; on shows the disclosure, and Windows asks at every Agent start. -->
|
||||
<ui:CardControl Margin="0,8,0,0" Icon="{ui:SymbolIcon Shield24}">
|
||||
<ui:CardControl.Header>
|
||||
<StackPanel>
|
||||
<ui:TextBlock FontTypography="BodyStrong" Text="{x:Static res:Strings.Settings_Agent_RunElevated_Label}" />
|
||||
<ui:TextBlock MaxWidth="560" HorizontalAlignment="Left" Appearance="Secondary" Text="{x:Static res:Strings.Settings_Agent_RunElevated_Body}" TextWrapping="Wrap" />
|
||||
</StackPanel>
|
||||
</ui:CardControl.Header>
|
||||
<ui:ToggleSwitch AutomationProperties.Name="{x:Static res:Strings.Settings_Agent_RunElevated_Label}" IsChecked="{Binding ViewModel.RunElevated, Mode=TwoWay}" />
|
||||
</ui:CardControl>
|
||||
<ui:CardControl Margin="0,8,0,0" Icon="{ui:SymbolIcon CalendarClock24}">
|
||||
<ui:CardControl.Header>
|
||||
<StackPanel>
|
||||
|
||||
@@ -0,0 +1,39 @@
|
||||
using System.Windows.Data;
|
||||
using FrameLedger.App.Dialogs;
|
||||
using FrameLedger.App.ViewModels;
|
||||
using Wpf.Ui;
|
||||
using Wpf.Ui.Controls;
|
||||
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>
|
||||
/// The admin mode's disclosure in WPF UI, the same shape as D33's (<see cref="AntiCheatExceptionPrompt"/>): the primary button
|
||||
/// is bound to the ticked acceptance and disabled until it is ticked; the close button keeps standard rights and is the
|
||||
/// default, so Enter never turns the mode on.
|
||||
/// </summary>
|
||||
public sealed class AgentAdminPrompt : IAgentAdminPrompt
|
||||
{
|
||||
private readonly IContentDialogService _dialogs;
|
||||
|
||||
public AgentAdminPrompt(IContentDialogService dialogs) => _dialogs = dialogs ?? throw new ArgumentNullException(nameof(dialogs));
|
||||
|
||||
public async Task<bool> ShowAsync(CancellationToken ct = default)
|
||||
{
|
||||
var viewModel = new AgentAdminDialogViewModel();
|
||||
var dialog = new ContentDialog
|
||||
{
|
||||
Title = AgentAdminDialogViewModel.Title,
|
||||
Content = new AgentAdminDialogContent(viewModel),
|
||||
PrimaryButtonText = AgentAdminDialogViewModel.TurnOnText,
|
||||
CloseButtonText = AgentAdminDialogViewModel.CancelText,
|
||||
DefaultButton = ContentDialogButton.Close,
|
||||
IsPrimaryButtonEnabled = false,
|
||||
DialogMaxWidth = 700,
|
||||
};
|
||||
_ = dialog.SetBinding(ContentDialog.IsPrimaryButtonEnabledProperty,
|
||||
new Binding(nameof(AgentAdminDialogViewModel.Accepted)) { Source = viewModel, Mode = BindingMode.OneWay });
|
||||
|
||||
ContentDialogResult result = await _dialogs.ShowAsync(dialog, ct).ConfigureAwait(true);
|
||||
return result == ContentDialogResult.Primary && viewModel.Accepted;
|
||||
}
|
||||
}
|
||||
@@ -151,7 +151,8 @@ public sealed class AgentConnection : IAgentLink, IAsyncDisposable
|
||||
running = _launcher.RunningAgent;
|
||||
if (running is null)
|
||||
{
|
||||
Set(AgentConnectionState.Starting, null, null);
|
||||
// The admin mode (beta.10): the start blocks while Windows' prompt waits for its answer, and the pill says why.
|
||||
Set(_launcher.WillAskForElevation ? AgentConnectionState.Elevating : AgentConnectionState.Starting, null, null);
|
||||
if (_launcher.TryStart())
|
||||
{
|
||||
Interlocked.Increment(ref _launches);
|
||||
|
||||
@@ -17,4 +17,10 @@ public enum AgentConnectionState
|
||||
|
||||
/// <summary>No Agent executable is beside this one; nothing to start, rounds continue in case one appears.</summary>
|
||||
Missing,
|
||||
|
||||
/// <summary>
|
||||
/// The Agent is being started as administrator (beta.10, the admin mode): Windows' prompt is up, owned by this window or
|
||||
/// flashing on the taskbar, and the round waits for its answer.
|
||||
/// </summary>
|
||||
Elevating,
|
||||
}
|
||||
@@ -1,6 +1,7 @@
|
||||
using System.ComponentModel;
|
||||
using System.Diagnostics;
|
||||
using System.IO;
|
||||
using FrameLedger.Infrastructure.Persistence;
|
||||
using FrameLedger.Infrastructure.Startup;
|
||||
using Serilog;
|
||||
|
||||
@@ -8,14 +9,29 @@ namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>Starts the Agent beside this executable, as its own process — it must outlive the App (background capture).</summary>
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// Never a second one (2026-09-17): <see cref="RunningAgent"/> probes the data folder's <see cref="AgentInstanceLock"/>,
|
||||
/// and the last Agent this App started is watched until it exits, with its exit code logged — exit
|
||||
/// <see cref="AgentInstanceLock.ExitHeldElsewhere"/> is an Agent that found the folder already claimed.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>The admin mode</b> (beta.10, owner decision D34). With <c>capture.run_elevated</c> on and this App a standard user's,
|
||||
/// Windows is asked — a UAC prompt owned by the App's window — every time this App starts the Agent. Accepted: the Agent
|
||||
/// starts as administrator for THIS user (<c>--for-user</c>). Declined: the Agent starts as a standard user and says so
|
||||
/// (<c>--elevation declined</c>), and the answer is not asked again for that start. Answered with another account: that
|
||||
/// account's Agent refuses to run (exit 11), and until this App restarts it starts the standard user's instead of asking
|
||||
/// again. With the option off and this App elevated, the Agent starts with the desktop shell's token — the option is the
|
||||
/// only thing that makes the Agent an administrator's. While a prompt is up the folder's <see cref="ElevationMarker"/> is
|
||||
/// held, so the logon task's Agent does not prompt beside it.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public sealed class AgentLauncher : IAgentLauncher
|
||||
{
|
||||
private readonly string _dataDirectory;
|
||||
private readonly Func<bool> _runElevated;
|
||||
private readonly Func<nint> _ownerWindow;
|
||||
private Task _lastStarted = Task.CompletedTask;
|
||||
private volatile bool _otherAccountAnswered;
|
||||
|
||||
public AgentLauncher()
|
||||
: this(UiPaths.DataDirectory)
|
||||
@@ -23,8 +39,15 @@ public sealed class AgentLauncher : IAgentLauncher
|
||||
}
|
||||
|
||||
/// <summary>A launcher that probes <paramref name="dataDirectory"/>'s claim — a test's folder, never the user's.</summary>
|
||||
internal AgentLauncher(string dataDirectory) =>
|
||||
internal AgentLauncher(string dataDirectory, Func<bool>? runElevated = null, Func<nint>? ownerWindow = null)
|
||||
{
|
||||
_dataDirectory = dataDirectory ?? throw new ArgumentNullException(nameof(dataDirectory));
|
||||
_runElevated = runElevated ?? (() => RunElevatedSetting.Read(Path.Combine(_dataDirectory, LedgerPaths.DatabaseFileName)));
|
||||
_ownerWindow = ownerWindow ?? (static () => 0);
|
||||
}
|
||||
|
||||
/// <summary>The launcher the App composes: the user's folder, and the main window as the prompt's owner.</summary>
|
||||
public static AgentLauncher ForApp(Func<nint> ownerWindow) => new(UiPaths.DataDirectory, ownerWindow: ownerWindow);
|
||||
|
||||
private static string AgentPath => Path.Combine(AppContext.BaseDirectory, "FrameLedger.Agent.exe");
|
||||
|
||||
@@ -33,9 +56,13 @@ public sealed class AgentLauncher : IAgentLauncher
|
||||
/// <inheritdoc />
|
||||
public string? RunningAgent =>
|
||||
AgentInstanceLock.IsHeld(_dataDirectory) ? $"an Agent already holds {_dataDirectory}"
|
||||
: ElevationMarker.IsHeld(_dataDirectory) ? "an Agent is being started as administrator (a UAC prompt may be waiting on the taskbar)"
|
||||
: !_lastStarted.IsCompleted ? "the Agent this App started last is still starting"
|
||||
: null;
|
||||
|
||||
/// <inheritdoc />
|
||||
public bool WillAskForElevation => !Environment.IsPrivilegedProcess && !_otherAccountAnswered && _runElevated();
|
||||
|
||||
public bool TryStart()
|
||||
{
|
||||
if (!CanLaunch)
|
||||
@@ -43,10 +70,88 @@ public sealed class AgentLauncher : IAgentLauncher
|
||||
return false;
|
||||
}
|
||||
|
||||
bool wanted = _runElevated();
|
||||
if (wanted && !Environment.IsPrivilegedProcess)
|
||||
{
|
||||
return _otherAccountAnswered ? StartPlain("--serve --elevation " + AgentElevation.OtherAccount) : StartElevated();
|
||||
}
|
||||
|
||||
return !wanted && Environment.IsPrivilegedProcess ? StartWithShellToken() : StartPlain("--serve");
|
||||
}
|
||||
|
||||
/// <summary>The UAC prompt; declined or failed, the standard user's Agent, which says so.</summary>
|
||||
[System.Diagnostics.CodeAnalysis.SuppressMessage("Reliability", "CA2025:Ensure tasks using 'IDisposable' instances complete before the instances are disposed",
|
||||
Justification = "the process and the marker are handed to the watch task, which disposes both; this method disposes neither after the handover")]
|
||||
private bool StartElevated()
|
||||
{
|
||||
ElevationMarker? marker = ElevationMarker.TryAcquire(_dataDirectory);
|
||||
if (marker is null)
|
||||
{
|
||||
// Someone else's prompt is up (the logon task's Agent): its answer starts the Agent; this round starts nothing.
|
||||
Log.Information("agent: another start is asking for administrator rights; not asking twice");
|
||||
return false;
|
||||
}
|
||||
|
||||
Log.Information("agent: asking Windows to start the Agent as administrator (capture.run_elevated)");
|
||||
Process? started = AgentElevation.Start(AgentPath, "--serve --for-user " + AgentElevation.CurrentUserSid(), _ownerWindow(), out string? refusal, out int? error);
|
||||
if (started is null)
|
||||
{
|
||||
marker.Dispose();
|
||||
Log.Information("agent: the administrator prompt was {Refusal} (error {Error}); starting the Agent as a standard user", refusal, error);
|
||||
return StartPlain("--serve --elevation " + (refusal ?? AgentElevation.Failed));
|
||||
}
|
||||
|
||||
Log.Information("agent: started {Path} as administrator (pid {Pid})", AgentPath, started.Id);
|
||||
_lastStarted = WatchElevatedAsync(started, marker);
|
||||
return true;
|
||||
}
|
||||
|
||||
/// <summary>This App is elevated and the option is off: the Agent gets the desktop shell's token, as a double-click would.</summary>
|
||||
private bool StartWithShellToken()
|
||||
{
|
||||
(int Pid, IDisposable Process)? started = UnelevatedProcess.Start(AgentPath, "--serve", AppContext.BaseDirectory,
|
||||
new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase), out int error);
|
||||
if (started is not { } s)
|
||||
{
|
||||
// No shell to take a standard user's token from: the Agent inherits this App's elevation, as before beta.10, and
|
||||
// the Settings page says it runs elevated.
|
||||
Log.Warning("agent: could not start the Agent as a standard user (error {Error}); it inherits this App's elevation", error);
|
||||
return StartPlain("--serve");
|
||||
}
|
||||
|
||||
Process? agent = Watchable(s);
|
||||
if (agent is not null)
|
||||
{
|
||||
Log.Information("agent: started {Path} --serve (pid {Pid}) as a standard user; this App is elevated and the admin mode is off", AgentPath, s.Pid);
|
||||
_lastStarted = WatchUntilExitAsync(agent);
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/// <summary>The started Agent as a <see cref="Process"/>, taken while the start's own handle still holds its id; null when it is gone already.</summary>
|
||||
private static Process? Watchable((int Pid, IDisposable Process) started)
|
||||
{
|
||||
using (started.Process)
|
||||
{
|
||||
try
|
||||
{
|
||||
return Process.GetProcessById(started.Pid);
|
||||
}
|
||||
catch (ArgumentException)
|
||||
{
|
||||
// Gone already; its exit code is lost with it, and the next round says whether an Agent answers.
|
||||
return null;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private bool StartPlain(string arguments)
|
||||
{
|
||||
Process? started;
|
||||
try
|
||||
{
|
||||
started = Process.Start(new ProcessStartInfo(AgentPath, "--serve")
|
||||
started = Process.Start(new ProcessStartInfo(AgentPath, arguments)
|
||||
{
|
||||
UseShellExecute = false,
|
||||
CreateNoWindow = true,
|
||||
@@ -64,22 +169,54 @@ public sealed class AgentLauncher : IAgentLauncher
|
||||
return false;
|
||||
}
|
||||
|
||||
// An elevated App starts an elevated Agent: the token is inherited, and it is what 07_IPC §C's owner check is about.
|
||||
Log.Information("agent: started {Path} --serve (pid {Pid}{Elevated})", AgentPath, started.Id,
|
||||
// An elevated App starts an elevated Agent here only when the admin mode is on (the token is inherited) or when no
|
||||
// standard user's token could be had; 07_IPC §C's owner check is what makes either reachable.
|
||||
Log.Information("agent: started {Path} {Arguments} (pid {Pid}{Elevated})", AgentPath, arguments, started.Id,
|
||||
Environment.IsPrivilegedProcess ? ", elevated like this App" : string.Empty);
|
||||
_lastStarted = WatchUntilExitAsync(started);
|
||||
return true;
|
||||
}
|
||||
|
||||
private static async Task WatchUntilExitAsync(Process agent)
|
||||
/// <summary>Holds the marker until the elevated Agent claims the folder or exits; exit 11 is remembered for this App's life.</summary>
|
||||
private async Task WatchElevatedAsync(Process agent, ElevationMarker marker)
|
||||
{
|
||||
using (marker)
|
||||
{
|
||||
await AgentElevation.WaitForClaimAsync(agent, _dataDirectory, TimeSpan.FromMinutes(2)).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
int? code = await WaitForExitCodeAsync(agent).ConfigureAwait(false);
|
||||
if (code == AgentElevation.ExitOtherAccount)
|
||||
{
|
||||
_otherAccountAnswered = true;
|
||||
Log.Warning("agent: the administrator prompt was answered with another account, whose Agent refused to run; "
|
||||
+ "until this App restarts the Agent starts as a standard user");
|
||||
}
|
||||
}
|
||||
|
||||
private static async Task WatchUntilExitAsync(Process agent) => await WaitForExitCodeAsync(agent).ConfigureAwait(false);
|
||||
|
||||
private static async Task<int?> WaitForExitCodeAsync(Process agent)
|
||||
{
|
||||
using (agent)
|
||||
{
|
||||
int pid = agent.Id;
|
||||
await agent.WaitForExitAsync().ConfigureAwait(false);
|
||||
int code = agent.ExitCode;
|
||||
int? code;
|
||||
try
|
||||
{
|
||||
code = agent.ExitCode;
|
||||
}
|
||||
catch (Exception ex) when (ex is InvalidOperationException or Win32Exception)
|
||||
{
|
||||
code = null;
|
||||
}
|
||||
|
||||
Log.Information("agent: pid {Pid} exited {Code}{Meaning}", pid, code,
|
||||
code == AgentInstanceLock.ExitHeldElsewhere ? " — another Agent already holds the data folder" : string.Empty);
|
||||
code == AgentInstanceLock.ExitHeldElsewhere ? " — another Agent already holds the data folder"
|
||||
: code == AgentElevation.ExitOtherAccount ? " — it ran as another account than this App's user"
|
||||
: string.Empty);
|
||||
return code;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -13,6 +13,7 @@ public static class AgentStatusPresentation
|
||||
AgentConnectionState.Starting => (Strings.Agent_State_Starting, ControlAppearance.Info),
|
||||
AgentConnectionState.Offline => (Strings.Agent_State_Offline, ControlAppearance.Caution),
|
||||
AgentConnectionState.Missing => (Strings.Agent_State_Missing, ControlAppearance.Danger),
|
||||
AgentConnectionState.Elevating => (Strings.Agent_State_Elevating, ControlAppearance.Info),
|
||||
_ => throw new ArgumentOutOfRangeException(nameof(state), state, "not a connection state"),
|
||||
};
|
||||
|
||||
|
||||
@@ -0,0 +1,7 @@
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>
|
||||
/// D33: what the exception's disclosure names — the game, the anti-cheat family and its signal. (D38 took the session count
|
||||
/// out: a grant needs no session, and its first two are a trial the disclosure describes.)
|
||||
/// </summary>
|
||||
public sealed record AntiCheatExceptionFacts(string GameName, string Family, string Signal);
|
||||
@@ -0,0 +1,29 @@
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>D33: how a request to grant or withdraw one game's user-mode exception ended.</summary>
|
||||
public enum AntiCheatExceptionOutcome
|
||||
{
|
||||
/// <summary>The Agent wrote the grant (<c>AntiCheatExceptionAck.granted = true</c>). Hooking is still off until FR-2.1.</summary>
|
||||
Granted,
|
||||
|
||||
/// <summary>The exception is not in force any more (<c>granted = false</c> on a withdrawal).</summary>
|
||||
Withdrawn,
|
||||
|
||||
/// <summary>The user closed the disclosure without accepting; nothing was sent.</summary>
|
||||
Declined,
|
||||
|
||||
/// <summary>The Agent's own facts did not make the game eligible (<c>Refused</c>).</summary>
|
||||
Refused,
|
||||
|
||||
/// <summary>The Agent grants against another version of the disclosure than this app shows; the dialog was not opened.</summary>
|
||||
VersionMismatch,
|
||||
|
||||
/// <summary>The option is off in Settings (<c>Error ExceptionsOff</c>); nothing was granted.</summary>
|
||||
OptionOff,
|
||||
|
||||
/// <summary>No connected Agent; nothing was sent.</summary>
|
||||
AgentUnavailable,
|
||||
|
||||
/// <summary>The Agent answered and did not grant (a store outcome, an <c>Error</c>, a timeout); <c>Detail</c> says which.</summary>
|
||||
Failed,
|
||||
}
|
||||
@@ -0,0 +1,41 @@
|
||||
using System.Windows.Data;
|
||||
using FrameLedger.App.Dialogs;
|
||||
using FrameLedger.App.ViewModels;
|
||||
using Wpf.Ui;
|
||||
using Wpf.Ui.Controls;
|
||||
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>
|
||||
/// D33's disclosure in WPF UI, the same shape as FR-2.1's (<see cref="ConsentPrompt"/>): the primary button is bound to the
|
||||
/// ticked acceptance and disabled until it is ticked; the close button keeps the game blocked and is the default, so Enter
|
||||
/// never makes an exception.
|
||||
/// </summary>
|
||||
public sealed class AntiCheatExceptionPrompt : IAntiCheatExceptionPrompt
|
||||
{
|
||||
private readonly IContentDialogService _dialogs;
|
||||
|
||||
public AntiCheatExceptionPrompt(IContentDialogService dialogs) => _dialogs = dialogs ?? throw new ArgumentNullException(nameof(dialogs));
|
||||
|
||||
public async Task<bool> ShowAsync(AntiCheatExceptionFacts facts, CancellationToken ct = default)
|
||||
{
|
||||
var viewModel = new AntiCheatExceptionDialogViewModel(facts);
|
||||
var dialog = new ContentDialog
|
||||
{
|
||||
Title = viewModel.Title,
|
||||
Content = new AntiCheatExceptionDialogContent(viewModel),
|
||||
PrimaryButtonText = AntiCheatExceptionDialogViewModel.GrantText,
|
||||
CloseButtonText = AntiCheatExceptionDialogViewModel.CancelText,
|
||||
// Enter keeps the game blocked; only a click on the (acceptance-gated) primary makes the exception.
|
||||
DefaultButton = ContentDialogButton.Close,
|
||||
IsPrimaryButtonEnabled = false,
|
||||
DialogMaxWidth = 700,
|
||||
};
|
||||
_ = dialog.SetBinding(ContentDialog.IsPrimaryButtonEnabledProperty,
|
||||
new Binding(nameof(AntiCheatExceptionDialogViewModel.Accepted)) { Source = viewModel, Mode = BindingMode.OneWay });
|
||||
|
||||
ContentDialogResult result = await _dialogs.ShowAsync(dialog, ct).ConfigureAwait(true);
|
||||
// The binding is the gate on the button; this is the same rule read once more at the moment that matters.
|
||||
return result == ContentDialogResult.Primary && viewModel.Accepted;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,52 @@
|
||||
using System.Globalization;
|
||||
using FrameLedger.Shared.Ipc;
|
||||
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>D33: how an ask for a user-mode exception ended, and — for a refusal — what the Agent named.</summary>
|
||||
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
|
||||
public sealed record AntiCheatExceptionResult(AntiCheatExceptionOutcome Outcome, string? Detail = null, RefusedAck? Refusal = null)
|
||||
{
|
||||
public static AntiCheatExceptionResult Of(AntiCheatExceptionOutcome outcome) => new(outcome);
|
||||
|
||||
/// <summary>The outcome a user wanted: the exception made, or withdrawn.</summary>
|
||||
public bool Succeeded => Outcome is AntiCheatExceptionOutcome.Granted or AntiCheatExceptionOutcome.Withdrawn;
|
||||
|
||||
/// <summary>What to tell the user about <paramref name="gameName"/>, or null when there is nothing to say (a declined disclosure).</summary>
|
||||
public string? MessageFor(string gameName) => Outcome switch
|
||||
{
|
||||
AntiCheatExceptionOutcome.Granted => string.Format(CultureInfo.CurrentCulture, Strings.Exception_Result_Granted_Format, gameName),
|
||||
AntiCheatExceptionOutcome.Withdrawn => string.Format(CultureInfo.CurrentCulture, Strings.Exception_Result_Withdrawn_Format, gameName),
|
||||
AntiCheatExceptionOutcome.Refused => string.Format(CultureInfo.CurrentCulture, Strings.Exception_Result_Refused_Format, gameName,
|
||||
RefusalText() ?? Detail ?? Strings.Common_NotAvailable),
|
||||
AntiCheatExceptionOutcome.VersionMismatch => Shared.Strings.Safety_Exception_VersionMismatch,
|
||||
AntiCheatExceptionOutcome.OptionOff => Shared.Strings.Safety_Exception_OptionOff,
|
||||
AntiCheatExceptionOutcome.AgentUnavailable => Shared.Strings.Safety_Consent_AgentUnavailable,
|
||||
AntiCheatExceptionOutcome.Failed => Detail ?? Strings.Common_NotAvailable,
|
||||
_ => null,
|
||||
};
|
||||
|
||||
/// <summary>Why no exception was made, in the user's language: a failed trial (D38), the finding, or the block's kind.</summary>
|
||||
public string? RefusalText()
|
||||
{
|
||||
if (Refusal is null)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
return Refusal.Reason switch
|
||||
{
|
||||
"TrialFailed" => string.Format(CultureInfo.CurrentCulture, Strings.Exception_State_TrialFailed_Format, TrialFailedDate(Refusal.Signal)),
|
||||
"BlockNotExceptionable" => Strings.Exception_State_NotAsked,
|
||||
"PreScanFailed" or "RulesUnreadable" or "RulesMalformed" or "RulesIncomplete" => Strings.Exception_State_CouldNotVerify,
|
||||
_ => string.Format(CultureInfo.CurrentCulture, Strings.Exception_State_Refused_Format,
|
||||
Refusal.Family ?? Formats.GuardReasonText(Refusal.Reason), Refusal.Signal ?? Strings.Common_NotAvailable),
|
||||
};
|
||||
}
|
||||
|
||||
/// <summary>D38: the Agent sends when the trial failed as unix milliseconds; anything else reads as not available.</summary>
|
||||
private static string TrialFailedDate(string? unixMs) =>
|
||||
long.TryParse(unixMs, NumberStyles.Integer, CultureInfo.InvariantCulture, out long ms)
|
||||
? Formats.Date(DateTimeOffset.FromUnixTimeMilliseconds(ms))
|
||||
: Strings.Common_NotAvailable;
|
||||
}
|
||||
@@ -0,0 +1,104 @@
|
||||
using System.IO;
|
||||
using FrameLedger.Infrastructure.Ipc;
|
||||
using FrameLedger.Shared.Ipc;
|
||||
using FrameLedger.Shared.Safety;
|
||||
using Serilog;
|
||||
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>
|
||||
/// D33 (owner decision 2026-09-26) from the App's side: the version handshake (the dialog is not opened when the Agent
|
||||
/// grants against other text), the disclosure, and the one message that may ask for a user-mode exception
|
||||
/// (<c>SetAntiCheatException</c>). Like <see cref="HookingConsent"/> it asserts nothing: it sends the version it showed,
|
||||
/// and the Agent re-checks the option, the block, a tolerant pre-scan of the file on disk and the session count, and
|
||||
/// grants or refuses (<c>07_IPC</c> §The pipe is not a trust boundary).
|
||||
/// </summary>
|
||||
public sealed class AntiCheatExceptions
|
||||
{
|
||||
private readonly IAgentRequests _agent;
|
||||
private readonly IAntiCheatExceptionPrompt _prompt;
|
||||
|
||||
public AntiCheatExceptions(IAgentRequests agent, IAntiCheatExceptionPrompt prompt)
|
||||
{
|
||||
_agent = agent ?? throw new ArgumentNullException(nameof(agent));
|
||||
_prompt = prompt ?? throw new ArgumentNullException(nameof(prompt));
|
||||
}
|
||||
|
||||
/// <summary>Show the disclosure for the game in <paramref name="facts"/> and, on its acceptance, ask the Agent for the exception.</summary>
|
||||
public async Task<AntiCheatExceptionResult> GrantAsync(long gameId, AntiCheatExceptionFacts facts, CancellationToken ct = default)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(facts);
|
||||
HelloAck? hello = _agent.Hello;
|
||||
if (hello is null || !_agent.IsConnected)
|
||||
{
|
||||
return AntiCheatExceptionResult.Of(AntiCheatExceptionOutcome.AgentUnavailable);
|
||||
}
|
||||
|
||||
if (!string.Equals(hello.ExceptionDisclosureVersion, AntiCheatExceptionDisclosure.Version, StringComparison.Ordinal))
|
||||
{
|
||||
// Showing text the Agent would not grant against is a dialog whose button cannot mean what it says.
|
||||
Log.Warning("exception: the Agent grants against {Theirs}, this app shows {Ours}; the dialog was not opened",
|
||||
hello.ExceptionDisclosureVersion, AntiCheatExceptionDisclosure.Version);
|
||||
return new AntiCheatExceptionResult(AntiCheatExceptionOutcome.VersionMismatch, hello.ExceptionDisclosureVersion);
|
||||
}
|
||||
|
||||
if (!await _prompt.ShowAsync(facts, ct).ConfigureAwait(true))
|
||||
{
|
||||
return AntiCheatExceptionResult.Of(AntiCheatExceptionOutcome.Declined);
|
||||
}
|
||||
|
||||
return await SendAsync(new SetAntiCheatExceptionRequest(gameId, Enabled: true, AntiCheatExceptionDisclosure.Version), ct).ConfigureAwait(true);
|
||||
}
|
||||
|
||||
/// <summary>Withdraw the game's exception; no dialog — a withdrawal only takes hooking away.</summary>
|
||||
public Task<AntiCheatExceptionResult> WithdrawAsync(long gameId, CancellationToken ct = default) =>
|
||||
_agent.IsConnected
|
||||
? SendAsync(new SetAntiCheatExceptionRequest(gameId, Enabled: false, null), ct)
|
||||
: Task.FromResult(AntiCheatExceptionResult.Of(AntiCheatExceptionOutcome.AgentUnavailable));
|
||||
|
||||
private async Task<AntiCheatExceptionResult> SendAsync(SetAntiCheatExceptionRequest request, CancellationToken ct)
|
||||
{
|
||||
try
|
||||
{
|
||||
IpcEnvelope ack = await _agent.RequestAsync(IpcMessageType.SetAntiCheatException, request, ct).ConfigureAwait(true);
|
||||
return Interpret(ack, request.Enabled);
|
||||
}
|
||||
catch (Exception ex) when (ex is IpcRequestException or TimeoutException or IOException or InvalidOperationException)
|
||||
{
|
||||
Log.Warning(ex, "exception: SetAntiCheatException(game {GameId}, {Enabled}) did not complete", request.GameId, request.Enabled);
|
||||
string? code = (ex as IpcRequestException)?.Code;
|
||||
AntiCheatExceptionOutcome outcome = code switch
|
||||
{
|
||||
IpcErrorCode.DisclosureVersionMismatch => AntiCheatExceptionOutcome.VersionMismatch,
|
||||
IpcErrorCode.ExceptionsOff => AntiCheatExceptionOutcome.OptionOff,
|
||||
_ => AntiCheatExceptionOutcome.Failed,
|
||||
};
|
||||
return new AntiCheatExceptionResult(outcome, code ?? ex.GetType().Name);
|
||||
}
|
||||
}
|
||||
|
||||
private static AntiCheatExceptionResult Interpret(IpcEnvelope ack, bool granting)
|
||||
{
|
||||
if (string.Equals(ack.Type, IpcMessageType.Refused, StringComparison.Ordinal))
|
||||
{
|
||||
RefusedAck? refused = IpcCodec.Payload<RefusedAck>(ack);
|
||||
return new AntiCheatExceptionResult(AntiCheatExceptionOutcome.Refused, refused?.Reason, refused);
|
||||
}
|
||||
|
||||
if (!string.Equals(ack.Type, IpcMessageType.AntiCheatExceptionAck, StringComparison.Ordinal))
|
||||
{
|
||||
return new AntiCheatExceptionResult(AntiCheatExceptionOutcome.Failed, "UnexpectedAck:" + ack.Type);
|
||||
}
|
||||
|
||||
AntiCheatExceptionAck? answer = IpcCodec.Payload<AntiCheatExceptionAck>(ack);
|
||||
if (answer is null)
|
||||
{
|
||||
return new AntiCheatExceptionResult(AntiCheatExceptionOutcome.Failed, "EmptyAck");
|
||||
}
|
||||
|
||||
// A withdrawal of an exception that was not in force is still the state the user asked for.
|
||||
return granting
|
||||
? answer.Granted ? new(AntiCheatExceptionOutcome.Granted, answer.Outcome) : new(AntiCheatExceptionOutcome.Failed, answer.Outcome)
|
||||
: answer.Granted ? new(AntiCheatExceptionOutcome.Failed, answer.Outcome) : new(AntiCheatExceptionOutcome.Withdrawn, answer.Outcome);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,167 @@
|
||||
using System.Diagnostics.CodeAnalysis;
|
||||
using System.Globalization;
|
||||
using FrameLedger.Application.Persistence;
|
||||
using FrameLedger.Application.Recording;
|
||||
using FrameLedger.Domain.Display;
|
||||
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>
|
||||
/// A session's display facts as the pages say them (beta.10, <c>03_METRICS</c> §Display mode): the mode that lasted longest
|
||||
/// with its share, every mode's share, and the sizes and the source behind them. A mode is never named more certainly than
|
||||
/// its source allows — a window that covered its monitor while nothing could ask the swap chain is "Fullscreen or
|
||||
/// borderless", never either.
|
||||
/// </summary>
|
||||
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
|
||||
public static class DisplayText
|
||||
{
|
||||
/// <summary>The order the shares are said in: the fullscreen end first.</summary>
|
||||
private static readonly DisplayMode[] _order =
|
||||
[DisplayMode.ExclusiveFullscreen, DisplayMode.Borderless, DisplayMode.CoversScreen, DisplayMode.Windowed, DisplayMode.Minimized];
|
||||
|
||||
/// <summary>The row's display facts, or null for a row that has none (written before beta.10, or recovered from a crash file).</summary>
|
||||
public static DisplaySummary? Of(SessionRow row) => SessionDisplayColumns.DisplayOf(row);
|
||||
|
||||
public static string ModeName(DisplayMode mode) => mode switch
|
||||
{
|
||||
DisplayMode.ExclusiveFullscreen => Strings.Display_Mode_Exclusive,
|
||||
DisplayMode.Borderless => Strings.Display_Mode_Borderless,
|
||||
DisplayMode.CoversScreen => Strings.Display_Mode_CoversScreen,
|
||||
DisplayMode.Windowed => Strings.Display_Mode_Windowed,
|
||||
DisplayMode.Minimized => Strings.Display_Mode_Minimized,
|
||||
_ => Strings.Display_Mode_NoWindow,
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// The mode that lasted longest and its share (<c>Borderless 92%</c>); "No window" when a window was never read; N/A for a
|
||||
/// row without display facts.
|
||||
/// </summary>
|
||||
public static string Headline(DisplaySummary? display)
|
||||
{
|
||||
if (display is null)
|
||||
{
|
||||
return Strings.Common_NotAvailable;
|
||||
}
|
||||
|
||||
return display.Dominant is { } mode
|
||||
? Share(mode, display.SharePercent(mode))
|
||||
: display.MinimizedMs > 0 ? Share(DisplayMode.Minimized, display.SharePercent(DisplayMode.Minimized)) : Strings.Display_Mode_NoWindow;
|
||||
}
|
||||
|
||||
/// <summary>Every mode the session spent time in, fullscreen end first (<c>Exclusive fullscreen 8% · Borderless 92%</c>).</summary>
|
||||
public static string Shares(DisplaySummary? display)
|
||||
{
|
||||
if (display is null)
|
||||
{
|
||||
return Strings.Common_NotAvailable;
|
||||
}
|
||||
|
||||
string[] parts = [.. _order.Where(m => display.SharePercent(m) is > 0).Select(m => Share(m, display.SharePercent(m)))];
|
||||
return parts.Length == 0 ? Strings.Display_Mode_NoWindow : string.Join(" · ", parts);
|
||||
}
|
||||
|
||||
/// <summary>The window's client size in the mode that lasted longest, or N/A.</summary>
|
||||
public static string Window(DisplaySummary? display) =>
|
||||
display is { WindowWidth: > 0 and int w, WindowHeight: > 0 and int h } ? Size(w, h) : Strings.Common_NotAvailable;
|
||||
|
||||
/// <summary>The monitor the window was on, with its refresh rate when known, or N/A.</summary>
|
||||
public static string Monitor(DisplaySummary? display) => display switch
|
||||
{
|
||||
{ MonitorWidth: > 0 and int w, MonitorHeight: > 0 and int h, MonitorHz: > 0 and int hz }
|
||||
=> string.Format(CultureInfo.CurrentCulture, Strings.Display_SizeHz_Format, w, h, hz),
|
||||
{ MonitorWidth: > 0 and int w, MonitorHeight: > 0 and int h } => Size(w, h),
|
||||
_ => Strings.Common_NotAvailable,
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// Everything the row says about the display, as one line for the session summary and the tooltips: the shares, the
|
||||
/// changes, the window on its monitor, the back buffer and its swap effect, and what it all rested on. Null for a row
|
||||
/// without display facts.
|
||||
/// </summary>
|
||||
public static string? Line(DisplaySummary? display)
|
||||
{
|
||||
if (display is null)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
var parts = new List<string> { Shares(display) };
|
||||
if (display.Changes > 0)
|
||||
{
|
||||
parts.Add(display.Changes == 1
|
||||
? Strings.Display_Changes_One
|
||||
: string.Format(CultureInfo.CurrentCulture, Strings.Display_Changes_Format, display.Changes));
|
||||
}
|
||||
|
||||
if (display is { WindowWidth: > 0 and int ww, WindowHeight: > 0 and int wh })
|
||||
{
|
||||
parts.Add(display is { MonitorWidth: > 0 and int mw, MonitorHeight: > 0 and int mh }
|
||||
? display.MonitorHz is > 0 and int hz
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.Display_WindowOnMonitorHz_Format, ww, wh, mw, mh, hz)
|
||||
: string.Format(CultureInfo.CurrentCulture, Strings.Display_WindowOnMonitor_Format, ww, wh, mw, mh)
|
||||
: string.Format(CultureInfo.CurrentCulture, Strings.Display_Window_Format, ww, wh));
|
||||
}
|
||||
|
||||
if (display is { BufferWidth: > 0 and uint bw, BufferHeight: > 0 and uint bh })
|
||||
{
|
||||
parts.Add(display.SwapEffect is { Length: > 0 } effect
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.Display_BufferEffect_Format, bw, bh, effect)
|
||||
: string.Format(CultureInfo.CurrentCulture, Strings.Display_Buffer_Format, bw, bh));
|
||||
}
|
||||
|
||||
if (SourceText(display.Source) is { } source)
|
||||
{
|
||||
parts.Add(source);
|
||||
}
|
||||
|
||||
return string.Format(CultureInfo.CurrentCulture, Strings.Display_Line_Format, string.Join(" · ", parts));
|
||||
}
|
||||
|
||||
/// <summary>What the facts rested on, said with what it means for exclusive fullscreen; null when no window was read.</summary>
|
||||
public static string? SourceText(string? source) => source switch
|
||||
{
|
||||
DisplaySource.SwapChain => Strings.Display_Source_SwapChain,
|
||||
DisplaySource.OpenGl => Strings.Display_Source_OpenGl,
|
||||
DisplaySource.Window => Strings.Display_Source_Window,
|
||||
_ => null,
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// The row's display facts for the CSV's <c># display:</c> line — InvariantCulture and the stored names, as every export
|
||||
/// line is, so a file reads the same in every UI language.
|
||||
/// </summary>
|
||||
public static string ExportLine(DisplaySummary? display)
|
||||
{
|
||||
if (display is null)
|
||||
{
|
||||
return "N/A (not recorded: a session recorded before beta.10, or recovered from its crash file)";
|
||||
}
|
||||
|
||||
CultureInfo inv = CultureInfo.InvariantCulture;
|
||||
string Pair(int? w, int? h) => w is > 0 && h is > 0 ? w.Value.ToString(inv) + "x" + h.Value.ToString(inv) : "n/a";
|
||||
string buffer = display is { BufferWidth: > 0 and uint bw, BufferHeight: > 0 and uint bh } ? bw.ToString(inv) + "x" + bh.ToString(inv) : "n/a";
|
||||
string hz = display.MonitorHz is > 0 and int r ? "@" + r.ToString(inv) : string.Empty;
|
||||
return string.Join("; ",
|
||||
"exclusive_ms=" + display.ExclusiveMs.ToString(inv),
|
||||
"borderless_ms=" + display.BorderlessMs.ToString(inv),
|
||||
"covers_ms=" + display.CoversMs.ToString(inv),
|
||||
"windowed_ms=" + display.WindowedMs.ToString(inv),
|
||||
"minimized_ms=" + display.MinimizedMs.ToString(inv),
|
||||
"nowindow_ms=" + display.NoWindowMs.ToString(inv),
|
||||
"changes=" + display.Changes.ToString(inv),
|
||||
"source=" + (display.Source ?? "n/a"),
|
||||
"window=" + Pair(display.WindowWidth, display.WindowHeight),
|
||||
"buffer=" + buffer,
|
||||
"monitor=" + Pair(display.MonitorWidth, display.MonitorHeight) + hz);
|
||||
}
|
||||
|
||||
/// <summary>A share as a person reads it: whole percent, and "<1%" for time that was there but rounds to none.</summary>
|
||||
internal static string Percent(double share) => share is > 0 and < 0.5
|
||||
? "<1%"
|
||||
: Math.Round(share, MidpointRounding.AwayFromZero).ToString("0", CultureInfo.CurrentCulture) + "%";
|
||||
|
||||
private static string Share(DisplayMode mode, double? share) =>
|
||||
share is double s ? string.Format(CultureInfo.CurrentCulture, Strings.Display_Share_Format, ModeName(mode), Percent(s)) : ModeName(mode);
|
||||
|
||||
private static string Size(int w, int h) => string.Format(CultureInfo.CurrentCulture, Strings.Display_Size_Format, w, h);
|
||||
}
|
||||
@@ -0,0 +1,120 @@
|
||||
using System.Globalization;
|
||||
using FrameLedger.Application.AntiCheat;
|
||||
using FrameLedger.Application.Persistence;
|
||||
using FrameLedger.Domain.AntiCheat;
|
||||
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>
|
||||
/// D33 (owner decision 2026-09-26): a blocked game's user-mode exception as the App shows it — in force (and, since D38, how
|
||||
/// far its trial has come), eligible, being checked, or why not — read from the Agent's columns
|
||||
/// (<see cref="GameRow.AcException"/>). The App decides nothing here: every state is a reading of what the Agent wrote, and
|
||||
/// the grant itself is the Agent's to make.
|
||||
/// </summary>
|
||||
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
|
||||
public sealed record ExceptionView(ExceptionViewKind Kind, string Text, string? Family, string? Signal, int Sessions, string? LapseText)
|
||||
{
|
||||
/// <summary>An exception may be asked for now.</summary>
|
||||
public bool CanGrant => Kind == ExceptionViewKind.Eligible;
|
||||
|
||||
/// <summary>An exception is on the row and may be withdrawn.</summary>
|
||||
public bool CanWithdraw => Kind == ExceptionViewKind.Granted;
|
||||
|
||||
/// <summary>
|
||||
/// The row's exception, or null for a row it says nothing about (not blocked). Granted first — a grant stays until the
|
||||
/// Agent or the user ends it — then the block's kind, then a failed trial (D38: for good, whatever a check says), then
|
||||
/// the sweep's answer about THIS block.
|
||||
/// </summary>
|
||||
public static ExceptionView? Of(GameRow row)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(row);
|
||||
if (!row.BlockedByGuard)
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
AntiCheatExceptionState x = row.AcException;
|
||||
StoredBlock? block = StoredBlock.Parse(row.HookBlockedReason);
|
||||
string? lapse = x.LapsedReason is { } reason && x.LapsedAt is { } at
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.Exception_Lapsed_Format, Formats.Date(at), LapseWords(reason))
|
||||
: null;
|
||||
if (x.IsGranted)
|
||||
{
|
||||
return new(ExceptionViewKind.Granted, GrantedText(x), x.Family, block?.Signal, x.Sessions, lapse);
|
||||
}
|
||||
|
||||
if (block is not { IsExceptionable: true } b)
|
||||
{
|
||||
return new(ExceptionViewKind.NotEligible, Strings.Exception_State_NotAsked, block?.Family, block?.Signal, x.Sessions, lapse);
|
||||
}
|
||||
|
||||
if (x.TrialFailedAt is { } failed)
|
||||
{
|
||||
return new(ExceptionViewKind.NotEligible, string.Format(CultureInfo.CurrentCulture, Strings.Exception_State_TrialFailed_Format, Formats.Date(failed)),
|
||||
b.Family, b.Signal, x.Sessions, lapse);
|
||||
}
|
||||
|
||||
if (!string.Equals(x.CheckedBlock, row.HookBlockedReason, StringComparison.Ordinal))
|
||||
{
|
||||
return new(ExceptionViewKind.Checking, Strings.Exception_State_Checking, b.Family, b.Signal, x.Sessions, lapse);
|
||||
}
|
||||
|
||||
if (x.Eligible)
|
||||
{
|
||||
return new(ExceptionViewKind.Eligible, Strings.Exception_State_Eligible, b.Family, b.Signal, x.Sessions, lapse);
|
||||
}
|
||||
|
||||
// A guard that let the family through over a row that does not say eligible is an answer from before D38 (it
|
||||
// counted sessions); the Agent's next pass rewrites it, so until then it is being checked.
|
||||
return StoredBlock.Parse(x.Verdict) is { Reason: AntiCheatRefusalReason.AllowedUnderUserModeException }
|
||||
? new(ExceptionViewKind.Checking, Strings.Exception_State_Checking, b.Family, b.Signal, x.Sessions, lapse)
|
||||
: new(ExceptionViewKind.NotEligible, WhyNot(b, x), b.Family, b.Signal, x.Sessions, lapse);
|
||||
}
|
||||
|
||||
/// <summary>Why the last grant ended, in words.</summary>
|
||||
public static string LapseWords(string reason) => reason switch
|
||||
{
|
||||
UserModeExceptionLapse.Withdrawn => Strings.Exception_Lapse_Withdrawn,
|
||||
UserModeExceptionLapse.ExecutableChanged => Strings.Exception_Lapse_ExecutableChanged,
|
||||
UserModeExceptionLapse.NoLongerEligible => Strings.Exception_Lapse_NoLongerEligible,
|
||||
UserModeExceptionLapse.NewFinding => Strings.Exception_Lapse_NewFinding,
|
||||
UserModeExceptionLapse.SafetyUnhook => Strings.Exception_Lapse_SafetyUnhook,
|
||||
UserModeExceptionLapse.OverlayStopped => Strings.Exception_Lapse_OverlayStopped,
|
||||
UserModeExceptionLapse.SessionCrashed => Strings.Exception_Lapse_SessionCrashed,
|
||||
UserModeExceptionLapse.TrialFailed => Strings.Exception_Lapse_TrialFailed,
|
||||
_ => reason,
|
||||
};
|
||||
|
||||
/// <summary>D38: a grant in its trial says how far it has come; one past it says only since when.</summary>
|
||||
private static string GrantedText(AntiCheatExceptionState x) =>
|
||||
UserModeExceptionRules.InTrial(x.Sessions)
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.Exception_State_GrantedTrial_Format, Formats.Date(x.GrantedAt!.Value), x.Sessions,
|
||||
UserModeExceptionRules.TrialSessions)
|
||||
: string.Format(CultureInfo.CurrentCulture, Strings.Exception_State_Granted_Format, Formats.Date(x.GrantedAt!.Value));
|
||||
|
||||
private static string WhyNot(StoredBlock block, AntiCheatExceptionState x)
|
||||
{
|
||||
StoredBlock? verdict = StoredBlock.Parse(x.Verdict);
|
||||
if (verdict is null)
|
||||
{
|
||||
return Strings.Exception_State_NotAsked;
|
||||
}
|
||||
|
||||
// A plain pass: the tolerant scan found nothing of the family, so it confirmed nothing — the check DID finish
|
||||
// (it used to be said as "could not finish").
|
||||
if (verdict.Value.Reason == AntiCheatRefusalReason.Allow)
|
||||
{
|
||||
return string.Format(CultureInfo.CurrentCulture, Strings.Exception_State_NotFound_Format, block.Family);
|
||||
}
|
||||
|
||||
if (!verdict.Value.IsExceptionable && verdict.Value.Family.Length == 0)
|
||||
{
|
||||
return Strings.Exception_State_CouldNotVerify;
|
||||
}
|
||||
|
||||
// The same finding back means the guard does not honour this family: it is not user-mode throughout.
|
||||
return string.Equals(verdict.Value.Family, block.Family, StringComparison.Ordinal)
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.Exception_State_NotUserMode_Format, block.Family)
|
||||
: string.Format(CultureInfo.CurrentCulture, Strings.Exception_State_Refused_Format, verdict.Value.Family, verdict.Value.Signal);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,21 @@
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>D33: the states a blocked game's user-mode exception is shown in (<see cref="ExceptionView"/>).</summary>
|
||||
/// <remarks>
|
||||
/// D38 (2026-10-03) removed <c>TooFewSessions</c>: a grant needs no session any more, so "not yet" is no longer a state —
|
||||
/// a game is eligible, being checked, or not eligible for a reason that says whether it can change.
|
||||
/// </remarks>
|
||||
public enum ExceptionViewKind
|
||||
{
|
||||
/// <summary>An exception is on the row (in its trial or past it).</summary>
|
||||
Granted,
|
||||
|
||||
/// <summary>The Agent found the game eligible; no exception has been made.</summary>
|
||||
Eligible,
|
||||
|
||||
/// <summary>The Agent has not answered about this block yet (the option was just turned on, or the block changed).</summary>
|
||||
Checking,
|
||||
|
||||
/// <summary>Not eligible, for the reason in the text.</summary>
|
||||
NotEligible,
|
||||
}
|
||||
@@ -419,6 +419,7 @@ public static class Formats
|
||||
5 => Strings.Launch_Error_5,
|
||||
193 => Strings.Launch_Error_193,
|
||||
740 => Strings.Launch_Error_740,
|
||||
1400 => Strings.Launch_Error_1400,
|
||||
_ => string.Format(CultureInfo.CurrentCulture, Strings.Launch_Error_Format, error),
|
||||
};
|
||||
|
||||
|
||||
@@ -0,0 +1,11 @@
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>
|
||||
/// The admin mode's disclosure as a question (beta.10, owner decision D34): shows the versioned text and answers whether the
|
||||
/// user understood and chose to have the Agent started as administrator. The WPF implementation is
|
||||
/// <see cref="AgentAdminPrompt"/>; a test substitutes an answer.
|
||||
/// </summary>
|
||||
public interface IAgentAdminPrompt
|
||||
{
|
||||
Task<bool> ShowAsync(CancellationToken ct = default);
|
||||
}
|
||||
@@ -17,6 +17,12 @@ public interface IAgentLauncher
|
||||
/// </summary>
|
||||
string? RunningAgent { get; }
|
||||
|
||||
/// <summary>
|
||||
/// Whether <see cref="TryStart"/> would show Windows' administrator prompt (beta.10, the admin mode on and this App a
|
||||
/// standard user's) — the pill says so while the round waits for the answer. A launcher that never asks answers false.
|
||||
/// </summary>
|
||||
bool WillAskForElevation => false;
|
||||
|
||||
/// <summary>Start <c>FrameLedger.Agent.exe --serve</c>, detached; false when it could not be started.</summary>
|
||||
bool TryStart();
|
||||
}
|
||||
@@ -22,4 +22,9 @@ public interface IAgentLink : IAgentRequests
|
||||
/// apply asks the Agent to stop and must not have it restarted under the updater). Released on a failed apply.
|
||||
/// </summary>
|
||||
void SetLaunchHold(bool hold);
|
||||
|
||||
/// <summary>Skip the wait before the next connect round (the banner's Retry; the admin mode's restart, beta.10).</summary>
|
||||
void RetryNow()
|
||||
{
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,11 @@
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>
|
||||
/// D33's disclosure as a question: shows the versioned text for one game and answers whether the user accepted the risk
|
||||
/// and chose to make the exception. The WPF implementation is <see cref="AntiCheatExceptionPrompt"/>; a test substitutes an
|
||||
/// answer.
|
||||
/// </summary>
|
||||
public interface IAntiCheatExceptionPrompt
|
||||
{
|
||||
Task<bool> ShowAsync(AntiCheatExceptionFacts facts, CancellationToken ct = default);
|
||||
}
|
||||
@@ -8,7 +8,8 @@ namespace FrameLedger.App.Services;
|
||||
/// <summary>
|
||||
/// File ▸ Import library… (FR-1.2, P4 PR-4): discover every installed store's titles, show the review checklist,
|
||||
/// add what the user ticked — hooking off for every one, as File ▸ Add game… would — and land on the Games page.
|
||||
/// Nothing is launched, nothing is fetched, nothing is added without a tick.
|
||||
/// Nothing is launched, nothing is fetched, nothing is added without a tick. Since beta.11 the Games page's Refresh runs
|
||||
/// it for new games only: when every title found is already in the library it says so and shows no checklist.
|
||||
/// </summary>
|
||||
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime; a cached CompositeFormat would pin the first culture")]
|
||||
public sealed class ImportLibraryFlow
|
||||
@@ -17,17 +18,22 @@ public sealed class ImportLibraryFlow
|
||||
private readonly IImportReview _review;
|
||||
private readonly IMessageStrip _strip;
|
||||
private readonly IPageNavigator _navigator;
|
||||
private readonly LibraryChanges? _changes;
|
||||
|
||||
public ImportLibraryFlow(LibraryImporter importer, IImportReview review, IMessageStrip strip, IPageNavigator navigator)
|
||||
public ImportLibraryFlow(LibraryImporter importer, IImportReview review, IMessageStrip strip, IPageNavigator navigator, LibraryChanges? changes = null)
|
||||
{
|
||||
_importer = importer ?? throw new ArgumentNullException(nameof(importer));
|
||||
_review = review ?? throw new ArgumentNullException(nameof(review));
|
||||
_strip = strip ?? throw new ArgumentNullException(nameof(strip));
|
||||
_navigator = navigator ?? throw new ArgumentNullException(nameof(navigator));
|
||||
_changes = changes;
|
||||
}
|
||||
|
||||
/// <summary>The report, or null when nothing was found or the user cancelled.</summary>
|
||||
public async Task<ImportReport?> RunAsync(CancellationToken ct = default)
|
||||
/// <summary>
|
||||
/// The report, or null when nothing was found or the user cancelled. <paramref name="onlyNew"/> (the Games page's
|
||||
/// Refresh): when no title found can be imported, say "no new games" and show nothing.
|
||||
/// </summary>
|
||||
public async Task<ImportReport?> RunAsync(bool onlyNew = false, CancellationToken ct = default)
|
||||
{
|
||||
IReadOnlyList<ImportCandidate> candidates = await _importer.DiscoverAsync(ct).ConfigureAwait(true);
|
||||
if (candidates.Count == 0)
|
||||
@@ -36,6 +42,12 @@ public sealed class ImportLibraryFlow
|
||||
return null;
|
||||
}
|
||||
|
||||
if (onlyNew && !candidates.Any(static c => c.CanImport))
|
||||
{
|
||||
_strip.Info(Strings.Import_Title, Strings.Import_NothingNew);
|
||||
return null;
|
||||
}
|
||||
|
||||
IReadOnlyList<ImportCandidate>? selected = await _review.ReviewAsync(candidates, ct).ConfigureAwait(true);
|
||||
if (selected is null || selected.Count == 0)
|
||||
{
|
||||
@@ -46,6 +58,8 @@ public sealed class ImportLibraryFlow
|
||||
_strip.Success(Strings.Import_Title, string.Format(CultureInfo.CurrentCulture, Strings.Import_Done_Format, report.Added, report.Skipped));
|
||||
if (report.Added > 0)
|
||||
{
|
||||
// The Games page, if it is the one on screen, does not reload on a navigation to itself: say so to it.
|
||||
_changes?.Announce();
|
||||
_navigator.Navigate<GamesPage>();
|
||||
}
|
||||
|
||||
|
||||
@@ -0,0 +1,16 @@
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>
|
||||
/// The App's own "the library's rows changed" signal (beta.11, owner request 2026-10-03): an import adds entries, and a
|
||||
/// page already on screen reloads. Navigating to the page that is on screen does nothing in WPF UI 4.3.0, so the Games
|
||||
/// page never saw an import made from File ▸ Import library… while it was open. The Agent's own changes (a merge, a
|
||||
/// finding, a new session) reach the page through its session events and the Refresh button.
|
||||
/// </summary>
|
||||
public sealed class LibraryChanges
|
||||
{
|
||||
/// <summary>Raised on the thread that changed the library — the UI thread for every caller today.</summary>
|
||||
public event EventHandler? Changed;
|
||||
|
||||
/// <summary>Say that entries were added, removed or replaced.</summary>
|
||||
public void Announce() => Changed?.Invoke(this, EventArgs.Empty);
|
||||
}
|
||||
@@ -0,0 +1,31 @@
|
||||
using System.IO;
|
||||
|
||||
namespace FrameLedger.App.Services;
|
||||
|
||||
/// <summary>
|
||||
/// <c>LIMITATIONS.md</c> (beta.10, owner decision D36): what the whole software cannot do, in the user's terms — embedded at
|
||||
/// build time from the repository root and shown under Help ▸ Limitations, so the App shows exactly the text this build
|
||||
/// was reviewed with.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <b>Information, not terms.</b> It is NOT one of FR-11's documents (<see cref="LegalDocuments.Keys"/>): the Legal Gate
|
||||
/// records an acceptance per document it shows, and nothing here is accepted. The Disclaimer points at it instead.
|
||||
/// </remarks>
|
||||
public static class LimitationsDocument
|
||||
{
|
||||
/// <summary>The embedded resource's name (<c>FrameLedger.App.csproj</c>).</summary>
|
||||
public const string ResourceName = "LIMITATIONS.md";
|
||||
|
||||
/// <summary>The same text in the repository, for the dialog's button.</summary>
|
||||
public static readonly Uri OnGitHub = new(IssueLink.Repository + "/blob/main/LIMITATIONS.md");
|
||||
|
||||
/// <summary>The document's text, authoring comments removed.</summary>
|
||||
/// <exception cref="InvalidOperationException">The build did not embed it.</exception>
|
||||
public static string Load()
|
||||
{
|
||||
using Stream stream = typeof(LimitationsDocument).Assembly.GetManifestResourceStream(ResourceName)
|
||||
?? throw new InvalidOperationException($"the build did not embed {ResourceName}");
|
||||
using var reader = new StreamReader(stream);
|
||||
return LegalDocuments.StripComments(reader.ReadToEnd());
|
||||
}
|
||||
}
|
||||
@@ -100,7 +100,17 @@ public sealed class SessionExporter
|
||||
w.WriteLine("# started_at: " + row.StartedAt.ToString("O", _inv));
|
||||
w.WriteLine("# ended_at: " + row.EndedAt.ToString("O", _inv));
|
||||
w.WriteLine("# capture_tier: " + ((int)row.Tier).ToString(_inv) + (row.Tier == CaptureTier.Hooked ? " (hooked, measured)" : " (not hooked: duration and sensors only; no per-frame rows)"));
|
||||
if (row.AcExceptionFamily is { Length: > 0 } excepted)
|
||||
{
|
||||
// D33: a session hooked under the game's user-mode anti-cheat exception says so wherever it goes (the JSON carries
|
||||
// the column in its aggregates).
|
||||
w.WriteLine("# ac_exception: " + excepted + " (hooked under the game's user-mode anti-cheat exception)");
|
||||
}
|
||||
|
||||
w.WriteLine("# api: " + (row.Api ?? "N/A") + "; present_mode: " + (row.PresentMode ?? "N/A") + "; swap_effect: " + (row.SwapEffect ?? "N/A"));
|
||||
// beta.10 (03_METRICS §Display mode): milliseconds per mode, both tiers — a header line, because the per-frame columns
|
||||
// are 03_METRICS' fixed list and a mode is the session's, not a frame's.
|
||||
w.WriteLine("# display: " + DisplayText.ExportLine(DisplayText.Of(row)));
|
||||
w.WriteLine("# hardware: " + (hardware is null ? "N/A" : string.Join("; ", new[] { hardware.CpuName, hardware.GpuName, hardware.GpuDriver, hardware.OsBuild, hardware.DisplayRes }.Where(static s => !string.IsNullOrEmpty(s)))));
|
||||
w.WriteLine("# rt: " + row.RtFlag + " (" + (row.RtSource ?? "n/a") + "); pt: " + row.PtFlag + " (" + (row.PtSource ?? "n/a") + "); rr: " + row.RrFlag + " (" + (row.RrSource ?? "n/a") + ")");
|
||||
w.WriteLine("# fg_mode: " + row.FgMode + "; fg_source: " + (row.FgSource ?? "n/a") + "; presented_qualifier: " + (row.PresentedQualifier ?? "n/a"));
|
||||
|
||||
@@ -19,6 +19,13 @@ public sealed class ShellHost(IServiceProvider services, INavigationService navi
|
||||
private MainWindow? _current;
|
||||
private Type _page = typeof(DashboardPage);
|
||||
private bool _exiting;
|
||||
private long _handle;
|
||||
|
||||
/// <summary>
|
||||
/// The live window's handle, for Windows' administrator prompt to belong to (beta.10, the admin mode); 0 before the first
|
||||
/// window. Written on the UI thread when a window is shown, read from the Agent connection's thread.
|
||||
/// </summary>
|
||||
public nint Handle => (nint)Interlocked.Read(ref _handle);
|
||||
|
||||
public void Show()
|
||||
{
|
||||
@@ -27,6 +34,7 @@ public sealed class ShellHost(IServiceProvider services, INavigationService navi
|
||||
window.Closed += OnClosed;
|
||||
_current = window;
|
||||
window.Show();
|
||||
Interlocked.Exchange(ref _handle, new System.Windows.Interop.WindowInteropHelper(window).Handle);
|
||||
navigation.Navigate(_page);
|
||||
// NFR-4 "cold start ≤ 2 s": measured from the process's own start, printed every run so a regression is a log line.
|
||||
Serilog.Log.Information("ui: shell shown {Ms} ms after process start", (long)(DateTime.Now - System.Diagnostics.Process.GetCurrentProcess().StartTime).TotalMilliseconds);
|
||||
|
||||
Generated
+306
@@ -42,6 +42,7 @@ public static class Strings
|
||||
nameof(Agent_Banner_Retry),
|
||||
nameof(Agent_State_Connected),
|
||||
nameof(Agent_State_Connecting),
|
||||
nameof(Agent_State_Elevating),
|
||||
nameof(Agent_State_Missing),
|
||||
nameof(Agent_State_Offline),
|
||||
nameof(Agent_State_Starting),
|
||||
@@ -130,16 +131,19 @@ public static class Strings
|
||||
nameof(Compare_Legend_Format),
|
||||
nameof(Compare_Metric_AvgCpuLoad),
|
||||
nameof(Compare_Metric_AvgGpuLoad),
|
||||
nameof(Compare_Metric_Display),
|
||||
nameof(Compare_Metric_Displayed),
|
||||
nameof(Compare_Metric_Duration),
|
||||
nameof(Compare_Metric_MaxCpuTemp),
|
||||
nameof(Compare_Metric_MaxGpuTemp),
|
||||
nameof(Compare_Metric_Median),
|
||||
nameof(Compare_Metric_Monitor),
|
||||
nameof(Compare_Metric_Native),
|
||||
nameof(Compare_Metric_P01Low),
|
||||
nameof(Compare_Metric_P1Low),
|
||||
nameof(Compare_Metric_Presented),
|
||||
nameof(Compare_Metric_StutterPct),
|
||||
nameof(Compare_Metric_Window),
|
||||
nameof(Compare_Mixed_Body),
|
||||
nameof(Compare_Mixed_Legend),
|
||||
nameof(Compare_Mixed_Proceed),
|
||||
@@ -180,6 +184,26 @@ public static class Strings
|
||||
nameof(Dashboard_Totals_Playtime),
|
||||
nameof(Dashboard_Totals_ThisWeek),
|
||||
nameof(Diag_Written_Format),
|
||||
nameof(Display_Buffer_Format),
|
||||
nameof(Display_BufferEffect_Format),
|
||||
nameof(Display_Changes_Format),
|
||||
nameof(Display_Changes_One),
|
||||
nameof(Display_Line_Format),
|
||||
nameof(Display_Mode_Borderless),
|
||||
nameof(Display_Mode_CoversScreen),
|
||||
nameof(Display_Mode_Exclusive),
|
||||
nameof(Display_Mode_Minimized),
|
||||
nameof(Display_Mode_NoWindow),
|
||||
nameof(Display_Mode_Windowed),
|
||||
nameof(Display_Share_Format),
|
||||
nameof(Display_Size_Format),
|
||||
nameof(Display_SizeHz_Format),
|
||||
nameof(Display_Source_OpenGl),
|
||||
nameof(Display_Source_SwapChain),
|
||||
nameof(Display_Source_Window),
|
||||
nameof(Display_Window_Format),
|
||||
nameof(Display_WindowOnMonitor_Format),
|
||||
nameof(Display_WindowOnMonitorHz_Format),
|
||||
nameof(EditGame_Detected),
|
||||
nameof(EditGame_Name),
|
||||
nameof(EditGame_Notes),
|
||||
@@ -213,6 +237,29 @@ public static class Strings
|
||||
nameof(End_WriterNeverInstalledHooks),
|
||||
nameof(End_WriterSelfDisabled),
|
||||
nameof(End_WriterStoppedBlocklisted),
|
||||
nameof(Exception_Finding_Format),
|
||||
nameof(Exception_Lapse_ExecutableChanged),
|
||||
nameof(Exception_Lapse_NewFinding),
|
||||
nameof(Exception_Lapse_NoLongerEligible),
|
||||
nameof(Exception_Lapse_OverlayStopped),
|
||||
nameof(Exception_Lapse_SafetyUnhook),
|
||||
nameof(Exception_Lapse_SessionCrashed),
|
||||
nameof(Exception_Lapse_TrialFailed),
|
||||
nameof(Exception_Lapse_Withdrawn),
|
||||
nameof(Exception_Lapsed_Format),
|
||||
nameof(Exception_Result_Granted_Format),
|
||||
nameof(Exception_Result_Refused_Format),
|
||||
nameof(Exception_Result_Withdrawn_Format),
|
||||
nameof(Exception_State_Checking),
|
||||
nameof(Exception_State_CouldNotVerify),
|
||||
nameof(Exception_State_Eligible),
|
||||
nameof(Exception_State_Granted_Format),
|
||||
nameof(Exception_State_GrantedTrial_Format),
|
||||
nameof(Exception_State_NotAsked),
|
||||
nameof(Exception_State_NotFound_Format),
|
||||
nameof(Exception_State_NotUserMode_Format),
|
||||
nameof(Exception_State_Refused_Format),
|
||||
nameof(Exception_State_TrialFailed_Format),
|
||||
nameof(Exe_DriveMissing_Format),
|
||||
nameof(Exe_FileMissing_Format),
|
||||
nameof(Exit_Code_Format),
|
||||
@@ -313,12 +360,14 @@ public static class Strings
|
||||
nameof(Fps_Native_Tooltip),
|
||||
nameof(Fps_None_Tooltip),
|
||||
nameof(Fps_Presented_Format),
|
||||
nameof(GameDetail_AntiCheat_Exceptionable_Format),
|
||||
nameof(GameDetail_AntiCheat_Format),
|
||||
nameof(GameDetail_AntiCheat_Header),
|
||||
nameof(GameDetail_Back),
|
||||
nameof(GameDetail_ChangeExe),
|
||||
nameof(GameDetail_Details_Architecture),
|
||||
nameof(GameDetail_Details_Engine),
|
||||
nameof(GameDetail_Details_EngineVersion),
|
||||
nameof(GameDetail_Details_FileVersion),
|
||||
nameof(GameDetail_Details_Header),
|
||||
nameof(GameDetail_Details_Libraries),
|
||||
@@ -331,6 +380,15 @@ public static class Strings
|
||||
nameof(GameDetail_Details_Store),
|
||||
nameof(GameDetail_Details_Version),
|
||||
nameof(GameDetail_Edit),
|
||||
nameof(GameDetail_EngineVersion_Branch),
|
||||
nameof(GameDetail_EngineVersion_BranchAndFile),
|
||||
nameof(GameDetail_EngineVersion_FileVersion),
|
||||
nameof(GameDetail_EngineVersion_NotFound),
|
||||
nameof(GameDetail_Exception_Grant),
|
||||
nameof(GameDetail_Exception_Granted_Format),
|
||||
nameof(GameDetail_Exception_Header),
|
||||
nameof(GameDetail_Exception_Suspended),
|
||||
nameof(GameDetail_Exception_Withdraw),
|
||||
nameof(GameDetail_ExeMissing),
|
||||
nameof(GameDetail_Hooking_Body),
|
||||
nameof(GameDetail_Hooking_Busy),
|
||||
@@ -363,21 +421,35 @@ public static class Strings
|
||||
nameof(GameDetail_Tab_Trend),
|
||||
nameof(Games_Add),
|
||||
nameof(Games_Card_AntiCheat),
|
||||
nameof(Games_Card_Exception),
|
||||
nameof(Games_Card_HookOff),
|
||||
nameof(Games_Card_HookOn),
|
||||
nameof(Games_Card_LastPlayed_Format),
|
||||
nameof(Games_Card_NeverPlayed),
|
||||
nameof(Games_Card_NotInstalled),
|
||||
nameof(Games_Card_NotRecorded),
|
||||
nameof(Games_Card_Playtime_Format),
|
||||
nameof(Games_Card_Sessions_Format),
|
||||
nameof(Games_Empty),
|
||||
nameof(Games_Header),
|
||||
nameof(Games_Header_Count_Format),
|
||||
nameof(Games_List_Engine),
|
||||
nameof(Games_List_LastPlayed),
|
||||
nameof(Games_List_Name),
|
||||
nameof(Games_List_Played),
|
||||
nameof(Games_List_Sessions),
|
||||
nameof(Games_List_Status),
|
||||
nameof(Games_List_Store),
|
||||
nameof(Games_NoMatch),
|
||||
nameof(Games_Refresh),
|
||||
nameof(Games_Refresh_ToolTip),
|
||||
nameof(Games_Search_Placeholder),
|
||||
nameof(Games_Sort_Label),
|
||||
nameof(Games_Sort_LastPlayed),
|
||||
nameof(Games_Sort_Name),
|
||||
nameof(Games_Sort_Playtime),
|
||||
nameof(Games_View_Grid),
|
||||
nameof(Games_View_List),
|
||||
nameof(Guard_ConsentMissing),
|
||||
nameof(Guard_DriverScanFailed),
|
||||
nameof(Guard_HookNotEnabled),
|
||||
@@ -412,9 +484,11 @@ public static class Strings
|
||||
nameof(Import_Note_Moved),
|
||||
nameof(Import_Note_NoExe),
|
||||
nameof(Import_NothingFound),
|
||||
nameof(Import_NothingNew),
|
||||
nameof(Import_SelectAll),
|
||||
nameof(Import_Selected_Format),
|
||||
nameof(Import_SelectNone),
|
||||
nameof(Import_ShowExisting_Format),
|
||||
nameof(Import_Title),
|
||||
nameof(Latency_Avg),
|
||||
nameof(Latency_Axis),
|
||||
@@ -423,6 +497,7 @@ public static class Strings
|
||||
nameof(Latency_P95),
|
||||
nameof(Latency_Series),
|
||||
nameof(Latency_Stats_Format),
|
||||
nameof(Launch_Error_1400),
|
||||
nameof(Launch_Error_193),
|
||||
nameof(Launch_Error_2),
|
||||
nameof(Launch_Error_3),
|
||||
@@ -430,6 +505,8 @@ public static class Strings
|
||||
nameof(Launch_Error_740),
|
||||
nameof(Launch_Error_Format),
|
||||
nameof(Launch_Failed_Format),
|
||||
nameof(Limitations_OnGitHub),
|
||||
nameof(Limitations_Title),
|
||||
nameof(Logs_Bundle_Exported_Format),
|
||||
nameof(Logs_Bundle_Failed_Format),
|
||||
nameof(Logs_Empty),
|
||||
@@ -488,6 +565,7 @@ public static class Strings
|
||||
nameof(Menu_Help_About),
|
||||
nameof(Menu_Help_CheckUpdates),
|
||||
nameof(Menu_Help_Documentation),
|
||||
nameof(Menu_Help_Limitations),
|
||||
nameof(Menu_Help_ReportBug),
|
||||
nameof(Menu_Tools),
|
||||
nameof(Menu_Tools_AgentStatus),
|
||||
@@ -565,8 +643,10 @@ public static class Strings
|
||||
nameof(Sensors_Series_VramProcess),
|
||||
nameof(Sensors_Temps_Header),
|
||||
nameof(Sensors_Vram_Header),
|
||||
nameof(Session_UnderException_Format),
|
||||
nameof(Sessions_Col_Api),
|
||||
nameof(Sessions_Col_Date),
|
||||
nameof(Sessions_Col_Display),
|
||||
nameof(Sessions_Col_Displayed),
|
||||
nameof(Sessions_Col_Duration),
|
||||
nameof(Sessions_Col_Exit),
|
||||
@@ -581,8 +661,16 @@ public static class Strings
|
||||
nameof(Settings_Agent_Elevated),
|
||||
nameof(Settings_Agent_Elevation_Body),
|
||||
nameof(Settings_Agent_Elevation_Label),
|
||||
nameof(Settings_Agent_ElevationDeclined),
|
||||
nameof(Settings_Agent_ElevationFailed),
|
||||
nameof(Settings_Agent_ElevationOtherAccount),
|
||||
nameof(Settings_Agent_Header),
|
||||
nameof(Settings_Agent_NotElevated),
|
||||
nameof(Settings_Agent_RunElevated_AfterSession),
|
||||
nameof(Settings_Agent_RunElevated_Body),
|
||||
nameof(Settings_Agent_RunElevated_Label),
|
||||
nameof(Settings_Agent_RunElevated_NotStopped),
|
||||
nameof(Settings_Agent_RunElevated_Restarting),
|
||||
nameof(Settings_Agent_Task_Installed),
|
||||
nameof(Settings_Agent_Task_Label),
|
||||
nameof(Settings_Agent_Task_NotInstalled),
|
||||
@@ -600,6 +688,15 @@ public static class Strings
|
||||
nameof(Settings_Capture_Header),
|
||||
nameof(Settings_Channel_Beta),
|
||||
nameof(Settings_Channel_Stable),
|
||||
nameof(Settings_Exceptions_Body),
|
||||
nameof(Settings_Exceptions_Checking),
|
||||
nameof(Settings_Exceptions_Empty),
|
||||
nameof(Settings_Exceptions_Grant),
|
||||
nameof(Settings_Exceptions_Header),
|
||||
nameof(Settings_Exceptions_Label),
|
||||
nameof(Settings_Exceptions_Refresh),
|
||||
nameof(Settings_Exceptions_Suspended),
|
||||
nameof(Settings_Exceptions_Withdraw),
|
||||
nameof(Settings_FpsDecimals_Body),
|
||||
nameof(Settings_FpsDecimals_Label),
|
||||
nameof(Settings_Header),
|
||||
@@ -686,6 +783,7 @@ public static class Strings
|
||||
nameof(Summary_Show_Sensors),
|
||||
nameof(Summary_Stat_Avg),
|
||||
nameof(Summary_Stat_Cpu),
|
||||
nameof(Summary_Stat_Display),
|
||||
nameof(Summary_Stat_Duration),
|
||||
nameof(Summary_Stat_Gpu),
|
||||
nameof(Summary_Stat_LoadTemp_Format),
|
||||
@@ -723,6 +821,7 @@ public static class Strings
|
||||
nameof(Tier_Dash_Tooltip),
|
||||
nameof(Tier_Hooked),
|
||||
nameof(Tier_Hooked_Tooltip),
|
||||
nameof(Tier_HookedException),
|
||||
nameof(Tier_NA_Tooltip),
|
||||
nameof(Tier_NotHooked),
|
||||
nameof(Tier_NotHooked_Tooltip),
|
||||
@@ -754,7 +853,10 @@ public static class Strings
|
||||
nameof(Trend_Metric_AvgGpuLoad),
|
||||
nameof(Trend_Metric_AvgGpuPower),
|
||||
nameof(Trend_Metric_AvgRam),
|
||||
nameof(Trend_Metric_DisplayBorderless),
|
||||
nameof(Trend_Metric_Displayed),
|
||||
nameof(Trend_Metric_DisplayExclusive),
|
||||
nameof(Trend_Metric_DisplayWindowed),
|
||||
nameof(Trend_Metric_FgFactor),
|
||||
nameof(Trend_Metric_Label),
|
||||
nameof(Trend_Metric_MaxCpuTemp),
|
||||
@@ -830,6 +932,8 @@ public static class Strings
|
||||
|
||||
public static string Agent_State_Connecting => ResourceManager.GetString(nameof(Agent_State_Connecting), Culture) ?? nameof(Agent_State_Connecting);
|
||||
|
||||
public static string Agent_State_Elevating => ResourceManager.GetString(nameof(Agent_State_Elevating), Culture) ?? nameof(Agent_State_Elevating);
|
||||
|
||||
public static string Agent_State_Missing => ResourceManager.GetString(nameof(Agent_State_Missing), Culture) ?? nameof(Agent_State_Missing);
|
||||
|
||||
public static string Agent_State_Offline => ResourceManager.GetString(nameof(Agent_State_Offline), Culture) ?? nameof(Agent_State_Offline);
|
||||
@@ -1006,6 +1110,8 @@ public static class Strings
|
||||
|
||||
public static string Compare_Metric_AvgGpuLoad => ResourceManager.GetString(nameof(Compare_Metric_AvgGpuLoad), Culture) ?? nameof(Compare_Metric_AvgGpuLoad);
|
||||
|
||||
public static string Compare_Metric_Display => ResourceManager.GetString(nameof(Compare_Metric_Display), Culture) ?? nameof(Compare_Metric_Display);
|
||||
|
||||
public static string Compare_Metric_Displayed => ResourceManager.GetString(nameof(Compare_Metric_Displayed), Culture) ?? nameof(Compare_Metric_Displayed);
|
||||
|
||||
public static string Compare_Metric_Duration => ResourceManager.GetString(nameof(Compare_Metric_Duration), Culture) ?? nameof(Compare_Metric_Duration);
|
||||
@@ -1016,6 +1122,8 @@ public static class Strings
|
||||
|
||||
public static string Compare_Metric_Median => ResourceManager.GetString(nameof(Compare_Metric_Median), Culture) ?? nameof(Compare_Metric_Median);
|
||||
|
||||
public static string Compare_Metric_Monitor => ResourceManager.GetString(nameof(Compare_Metric_Monitor), Culture) ?? nameof(Compare_Metric_Monitor);
|
||||
|
||||
public static string Compare_Metric_Native => ResourceManager.GetString(nameof(Compare_Metric_Native), Culture) ?? nameof(Compare_Metric_Native);
|
||||
|
||||
public static string Compare_Metric_P01Low => ResourceManager.GetString(nameof(Compare_Metric_P01Low), Culture) ?? nameof(Compare_Metric_P01Low);
|
||||
@@ -1026,6 +1134,8 @@ public static class Strings
|
||||
|
||||
public static string Compare_Metric_StutterPct => ResourceManager.GetString(nameof(Compare_Metric_StutterPct), Culture) ?? nameof(Compare_Metric_StutterPct);
|
||||
|
||||
public static string Compare_Metric_Window => ResourceManager.GetString(nameof(Compare_Metric_Window), Culture) ?? nameof(Compare_Metric_Window);
|
||||
|
||||
public static string Compare_Mixed_Body => ResourceManager.GetString(nameof(Compare_Mixed_Body), Culture) ?? nameof(Compare_Mixed_Body);
|
||||
|
||||
public static string Compare_Mixed_Legend => ResourceManager.GetString(nameof(Compare_Mixed_Legend), Culture) ?? nameof(Compare_Mixed_Legend);
|
||||
@@ -1106,6 +1216,46 @@ public static class Strings
|
||||
|
||||
public static string Diag_Written_Format => ResourceManager.GetString(nameof(Diag_Written_Format), Culture) ?? nameof(Diag_Written_Format);
|
||||
|
||||
public static string Display_Buffer_Format => ResourceManager.GetString(nameof(Display_Buffer_Format), Culture) ?? nameof(Display_Buffer_Format);
|
||||
|
||||
public static string Display_BufferEffect_Format => ResourceManager.GetString(nameof(Display_BufferEffect_Format), Culture) ?? nameof(Display_BufferEffect_Format);
|
||||
|
||||
public static string Display_Changes_Format => ResourceManager.GetString(nameof(Display_Changes_Format), Culture) ?? nameof(Display_Changes_Format);
|
||||
|
||||
public static string Display_Changes_One => ResourceManager.GetString(nameof(Display_Changes_One), Culture) ?? nameof(Display_Changes_One);
|
||||
|
||||
public static string Display_Line_Format => ResourceManager.GetString(nameof(Display_Line_Format), Culture) ?? nameof(Display_Line_Format);
|
||||
|
||||
public static string Display_Mode_Borderless => ResourceManager.GetString(nameof(Display_Mode_Borderless), Culture) ?? nameof(Display_Mode_Borderless);
|
||||
|
||||
public static string Display_Mode_CoversScreen => ResourceManager.GetString(nameof(Display_Mode_CoversScreen), Culture) ?? nameof(Display_Mode_CoversScreen);
|
||||
|
||||
public static string Display_Mode_Exclusive => ResourceManager.GetString(nameof(Display_Mode_Exclusive), Culture) ?? nameof(Display_Mode_Exclusive);
|
||||
|
||||
public static string Display_Mode_Minimized => ResourceManager.GetString(nameof(Display_Mode_Minimized), Culture) ?? nameof(Display_Mode_Minimized);
|
||||
|
||||
public static string Display_Mode_NoWindow => ResourceManager.GetString(nameof(Display_Mode_NoWindow), Culture) ?? nameof(Display_Mode_NoWindow);
|
||||
|
||||
public static string Display_Mode_Windowed => ResourceManager.GetString(nameof(Display_Mode_Windowed), Culture) ?? nameof(Display_Mode_Windowed);
|
||||
|
||||
public static string Display_Share_Format => ResourceManager.GetString(nameof(Display_Share_Format), Culture) ?? nameof(Display_Share_Format);
|
||||
|
||||
public static string Display_Size_Format => ResourceManager.GetString(nameof(Display_Size_Format), Culture) ?? nameof(Display_Size_Format);
|
||||
|
||||
public static string Display_SizeHz_Format => ResourceManager.GetString(nameof(Display_SizeHz_Format), Culture) ?? nameof(Display_SizeHz_Format);
|
||||
|
||||
public static string Display_Source_OpenGl => ResourceManager.GetString(nameof(Display_Source_OpenGl), Culture) ?? nameof(Display_Source_OpenGl);
|
||||
|
||||
public static string Display_Source_SwapChain => ResourceManager.GetString(nameof(Display_Source_SwapChain), Culture) ?? nameof(Display_Source_SwapChain);
|
||||
|
||||
public static string Display_Source_Window => ResourceManager.GetString(nameof(Display_Source_Window), Culture) ?? nameof(Display_Source_Window);
|
||||
|
||||
public static string Display_Window_Format => ResourceManager.GetString(nameof(Display_Window_Format), Culture) ?? nameof(Display_Window_Format);
|
||||
|
||||
public static string Display_WindowOnMonitor_Format => ResourceManager.GetString(nameof(Display_WindowOnMonitor_Format), Culture) ?? nameof(Display_WindowOnMonitor_Format);
|
||||
|
||||
public static string Display_WindowOnMonitorHz_Format => ResourceManager.GetString(nameof(Display_WindowOnMonitorHz_Format), Culture) ?? nameof(Display_WindowOnMonitorHz_Format);
|
||||
|
||||
public static string EditGame_Detected => ResourceManager.GetString(nameof(EditGame_Detected), Culture) ?? nameof(EditGame_Detected);
|
||||
|
||||
public static string EditGame_Name => ResourceManager.GetString(nameof(EditGame_Name), Culture) ?? nameof(EditGame_Name);
|
||||
@@ -1172,6 +1322,52 @@ public static class Strings
|
||||
|
||||
public static string End_WriterStoppedBlocklisted => ResourceManager.GetString(nameof(End_WriterStoppedBlocklisted), Culture) ?? nameof(End_WriterStoppedBlocklisted);
|
||||
|
||||
public static string Exception_Finding_Format => ResourceManager.GetString(nameof(Exception_Finding_Format), Culture) ?? nameof(Exception_Finding_Format);
|
||||
|
||||
public static string Exception_Lapse_ExecutableChanged => ResourceManager.GetString(nameof(Exception_Lapse_ExecutableChanged), Culture) ?? nameof(Exception_Lapse_ExecutableChanged);
|
||||
|
||||
public static string Exception_Lapse_NewFinding => ResourceManager.GetString(nameof(Exception_Lapse_NewFinding), Culture) ?? nameof(Exception_Lapse_NewFinding);
|
||||
|
||||
public static string Exception_Lapse_NoLongerEligible => ResourceManager.GetString(nameof(Exception_Lapse_NoLongerEligible), Culture) ?? nameof(Exception_Lapse_NoLongerEligible);
|
||||
|
||||
public static string Exception_Lapse_OverlayStopped => ResourceManager.GetString(nameof(Exception_Lapse_OverlayStopped), Culture) ?? nameof(Exception_Lapse_OverlayStopped);
|
||||
|
||||
public static string Exception_Lapse_SafetyUnhook => ResourceManager.GetString(nameof(Exception_Lapse_SafetyUnhook), Culture) ?? nameof(Exception_Lapse_SafetyUnhook);
|
||||
|
||||
public static string Exception_Lapse_SessionCrashed => ResourceManager.GetString(nameof(Exception_Lapse_SessionCrashed), Culture) ?? nameof(Exception_Lapse_SessionCrashed);
|
||||
|
||||
public static string Exception_Lapse_TrialFailed => ResourceManager.GetString(nameof(Exception_Lapse_TrialFailed), Culture) ?? nameof(Exception_Lapse_TrialFailed);
|
||||
|
||||
public static string Exception_Lapse_Withdrawn => ResourceManager.GetString(nameof(Exception_Lapse_Withdrawn), Culture) ?? nameof(Exception_Lapse_Withdrawn);
|
||||
|
||||
public static string Exception_Lapsed_Format => ResourceManager.GetString(nameof(Exception_Lapsed_Format), Culture) ?? nameof(Exception_Lapsed_Format);
|
||||
|
||||
public static string Exception_Result_Granted_Format => ResourceManager.GetString(nameof(Exception_Result_Granted_Format), Culture) ?? nameof(Exception_Result_Granted_Format);
|
||||
|
||||
public static string Exception_Result_Refused_Format => ResourceManager.GetString(nameof(Exception_Result_Refused_Format), Culture) ?? nameof(Exception_Result_Refused_Format);
|
||||
|
||||
public static string Exception_Result_Withdrawn_Format => ResourceManager.GetString(nameof(Exception_Result_Withdrawn_Format), Culture) ?? nameof(Exception_Result_Withdrawn_Format);
|
||||
|
||||
public static string Exception_State_Checking => ResourceManager.GetString(nameof(Exception_State_Checking), Culture) ?? nameof(Exception_State_Checking);
|
||||
|
||||
public static string Exception_State_CouldNotVerify => ResourceManager.GetString(nameof(Exception_State_CouldNotVerify), Culture) ?? nameof(Exception_State_CouldNotVerify);
|
||||
|
||||
public static string Exception_State_Eligible => ResourceManager.GetString(nameof(Exception_State_Eligible), Culture) ?? nameof(Exception_State_Eligible);
|
||||
|
||||
public static string Exception_State_Granted_Format => ResourceManager.GetString(nameof(Exception_State_Granted_Format), Culture) ?? nameof(Exception_State_Granted_Format);
|
||||
|
||||
public static string Exception_State_GrantedTrial_Format => ResourceManager.GetString(nameof(Exception_State_GrantedTrial_Format), Culture) ?? nameof(Exception_State_GrantedTrial_Format);
|
||||
|
||||
public static string Exception_State_NotAsked => ResourceManager.GetString(nameof(Exception_State_NotAsked), Culture) ?? nameof(Exception_State_NotAsked);
|
||||
|
||||
public static string Exception_State_NotFound_Format => ResourceManager.GetString(nameof(Exception_State_NotFound_Format), Culture) ?? nameof(Exception_State_NotFound_Format);
|
||||
|
||||
public static string Exception_State_NotUserMode_Format => ResourceManager.GetString(nameof(Exception_State_NotUserMode_Format), Culture) ?? nameof(Exception_State_NotUserMode_Format);
|
||||
|
||||
public static string Exception_State_Refused_Format => ResourceManager.GetString(nameof(Exception_State_Refused_Format), Culture) ?? nameof(Exception_State_Refused_Format);
|
||||
|
||||
public static string Exception_State_TrialFailed_Format => ResourceManager.GetString(nameof(Exception_State_TrialFailed_Format), Culture) ?? nameof(Exception_State_TrialFailed_Format);
|
||||
|
||||
public static string Exe_DriveMissing_Format => ResourceManager.GetString(nameof(Exe_DriveMissing_Format), Culture) ?? nameof(Exe_DriveMissing_Format);
|
||||
|
||||
public static string Exe_FileMissing_Format => ResourceManager.GetString(nameof(Exe_FileMissing_Format), Culture) ?? nameof(Exe_FileMissing_Format);
|
||||
@@ -1372,6 +1568,8 @@ public static class Strings
|
||||
|
||||
public static string Fps_Presented_Format => ResourceManager.GetString(nameof(Fps_Presented_Format), Culture) ?? nameof(Fps_Presented_Format);
|
||||
|
||||
public static string GameDetail_AntiCheat_Exceptionable_Format => ResourceManager.GetString(nameof(GameDetail_AntiCheat_Exceptionable_Format), Culture) ?? nameof(GameDetail_AntiCheat_Exceptionable_Format);
|
||||
|
||||
public static string GameDetail_AntiCheat_Format => ResourceManager.GetString(nameof(GameDetail_AntiCheat_Format), Culture) ?? nameof(GameDetail_AntiCheat_Format);
|
||||
|
||||
public static string GameDetail_AntiCheat_Header => ResourceManager.GetString(nameof(GameDetail_AntiCheat_Header), Culture) ?? nameof(GameDetail_AntiCheat_Header);
|
||||
@@ -1384,6 +1582,8 @@ public static class Strings
|
||||
|
||||
public static string GameDetail_Details_Engine => ResourceManager.GetString(nameof(GameDetail_Details_Engine), Culture) ?? nameof(GameDetail_Details_Engine);
|
||||
|
||||
public static string GameDetail_Details_EngineVersion => ResourceManager.GetString(nameof(GameDetail_Details_EngineVersion), Culture) ?? nameof(GameDetail_Details_EngineVersion);
|
||||
|
||||
public static string GameDetail_Details_FileVersion => ResourceManager.GetString(nameof(GameDetail_Details_FileVersion), Culture) ?? nameof(GameDetail_Details_FileVersion);
|
||||
|
||||
public static string GameDetail_Details_Header => ResourceManager.GetString(nameof(GameDetail_Details_Header), Culture) ?? nameof(GameDetail_Details_Header);
|
||||
@@ -1408,6 +1608,24 @@ public static class Strings
|
||||
|
||||
public static string GameDetail_Edit => ResourceManager.GetString(nameof(GameDetail_Edit), Culture) ?? nameof(GameDetail_Edit);
|
||||
|
||||
public static string GameDetail_EngineVersion_Branch => ResourceManager.GetString(nameof(GameDetail_EngineVersion_Branch), Culture) ?? nameof(GameDetail_EngineVersion_Branch);
|
||||
|
||||
public static string GameDetail_EngineVersion_BranchAndFile => ResourceManager.GetString(nameof(GameDetail_EngineVersion_BranchAndFile), Culture) ?? nameof(GameDetail_EngineVersion_BranchAndFile);
|
||||
|
||||
public static string GameDetail_EngineVersion_FileVersion => ResourceManager.GetString(nameof(GameDetail_EngineVersion_FileVersion), Culture) ?? nameof(GameDetail_EngineVersion_FileVersion);
|
||||
|
||||
public static string GameDetail_EngineVersion_NotFound => ResourceManager.GetString(nameof(GameDetail_EngineVersion_NotFound), Culture) ?? nameof(GameDetail_EngineVersion_NotFound);
|
||||
|
||||
public static string GameDetail_Exception_Grant => ResourceManager.GetString(nameof(GameDetail_Exception_Grant), Culture) ?? nameof(GameDetail_Exception_Grant);
|
||||
|
||||
public static string GameDetail_Exception_Granted_Format => ResourceManager.GetString(nameof(GameDetail_Exception_Granted_Format), Culture) ?? nameof(GameDetail_Exception_Granted_Format);
|
||||
|
||||
public static string GameDetail_Exception_Header => ResourceManager.GetString(nameof(GameDetail_Exception_Header), Culture) ?? nameof(GameDetail_Exception_Header);
|
||||
|
||||
public static string GameDetail_Exception_Suspended => ResourceManager.GetString(nameof(GameDetail_Exception_Suspended), Culture) ?? nameof(GameDetail_Exception_Suspended);
|
||||
|
||||
public static string GameDetail_Exception_Withdraw => ResourceManager.GetString(nameof(GameDetail_Exception_Withdraw), Culture) ?? nameof(GameDetail_Exception_Withdraw);
|
||||
|
||||
public static string GameDetail_ExeMissing => ResourceManager.GetString(nameof(GameDetail_ExeMissing), Culture) ?? nameof(GameDetail_ExeMissing);
|
||||
|
||||
public static string GameDetail_Hooking_Body => ResourceManager.GetString(nameof(GameDetail_Hooking_Body), Culture) ?? nameof(GameDetail_Hooking_Body);
|
||||
@@ -1472,6 +1690,8 @@ public static class Strings
|
||||
|
||||
public static string Games_Card_AntiCheat => ResourceManager.GetString(nameof(Games_Card_AntiCheat), Culture) ?? nameof(Games_Card_AntiCheat);
|
||||
|
||||
public static string Games_Card_Exception => ResourceManager.GetString(nameof(Games_Card_Exception), Culture) ?? nameof(Games_Card_Exception);
|
||||
|
||||
public static string Games_Card_HookOff => ResourceManager.GetString(nameof(Games_Card_HookOff), Culture) ?? nameof(Games_Card_HookOff);
|
||||
|
||||
public static string Games_Card_HookOn => ResourceManager.GetString(nameof(Games_Card_HookOn), Culture) ?? nameof(Games_Card_HookOn);
|
||||
@@ -1480,6 +1700,8 @@ public static class Strings
|
||||
|
||||
public static string Games_Card_NeverPlayed => ResourceManager.GetString(nameof(Games_Card_NeverPlayed), Culture) ?? nameof(Games_Card_NeverPlayed);
|
||||
|
||||
public static string Games_Card_NotInstalled => ResourceManager.GetString(nameof(Games_Card_NotInstalled), Culture) ?? nameof(Games_Card_NotInstalled);
|
||||
|
||||
public static string Games_Card_NotRecorded => ResourceManager.GetString(nameof(Games_Card_NotRecorded), Culture) ?? nameof(Games_Card_NotRecorded);
|
||||
|
||||
public static string Games_Card_Playtime_Format => ResourceManager.GetString(nameof(Games_Card_Playtime_Format), Culture) ?? nameof(Games_Card_Playtime_Format);
|
||||
@@ -1490,8 +1712,28 @@ public static class Strings
|
||||
|
||||
public static string Games_Header => ResourceManager.GetString(nameof(Games_Header), Culture) ?? nameof(Games_Header);
|
||||
|
||||
public static string Games_Header_Count_Format => ResourceManager.GetString(nameof(Games_Header_Count_Format), Culture) ?? nameof(Games_Header_Count_Format);
|
||||
|
||||
public static string Games_List_Engine => ResourceManager.GetString(nameof(Games_List_Engine), Culture) ?? nameof(Games_List_Engine);
|
||||
|
||||
public static string Games_List_LastPlayed => ResourceManager.GetString(nameof(Games_List_LastPlayed), Culture) ?? nameof(Games_List_LastPlayed);
|
||||
|
||||
public static string Games_List_Name => ResourceManager.GetString(nameof(Games_List_Name), Culture) ?? nameof(Games_List_Name);
|
||||
|
||||
public static string Games_List_Played => ResourceManager.GetString(nameof(Games_List_Played), Culture) ?? nameof(Games_List_Played);
|
||||
|
||||
public static string Games_List_Sessions => ResourceManager.GetString(nameof(Games_List_Sessions), Culture) ?? nameof(Games_List_Sessions);
|
||||
|
||||
public static string Games_List_Status => ResourceManager.GetString(nameof(Games_List_Status), Culture) ?? nameof(Games_List_Status);
|
||||
|
||||
public static string Games_List_Store => ResourceManager.GetString(nameof(Games_List_Store), Culture) ?? nameof(Games_List_Store);
|
||||
|
||||
public static string Games_NoMatch => ResourceManager.GetString(nameof(Games_NoMatch), Culture) ?? nameof(Games_NoMatch);
|
||||
|
||||
public static string Games_Refresh => ResourceManager.GetString(nameof(Games_Refresh), Culture) ?? nameof(Games_Refresh);
|
||||
|
||||
public static string Games_Refresh_ToolTip => ResourceManager.GetString(nameof(Games_Refresh_ToolTip), Culture) ?? nameof(Games_Refresh_ToolTip);
|
||||
|
||||
public static string Games_Search_Placeholder => ResourceManager.GetString(nameof(Games_Search_Placeholder), Culture) ?? nameof(Games_Search_Placeholder);
|
||||
|
||||
public static string Games_Sort_Label => ResourceManager.GetString(nameof(Games_Sort_Label), Culture) ?? nameof(Games_Sort_Label);
|
||||
@@ -1502,6 +1744,10 @@ public static class Strings
|
||||
|
||||
public static string Games_Sort_Playtime => ResourceManager.GetString(nameof(Games_Sort_Playtime), Culture) ?? nameof(Games_Sort_Playtime);
|
||||
|
||||
public static string Games_View_Grid => ResourceManager.GetString(nameof(Games_View_Grid), Culture) ?? nameof(Games_View_Grid);
|
||||
|
||||
public static string Games_View_List => ResourceManager.GetString(nameof(Games_View_List), Culture) ?? nameof(Games_View_List);
|
||||
|
||||
public static string Guard_ConsentMissing => ResourceManager.GetString(nameof(Guard_ConsentMissing), Culture) ?? nameof(Guard_ConsentMissing);
|
||||
|
||||
public static string Guard_DriverScanFailed => ResourceManager.GetString(nameof(Guard_DriverScanFailed), Culture) ?? nameof(Guard_DriverScanFailed);
|
||||
@@ -1570,12 +1816,16 @@ public static class Strings
|
||||
|
||||
public static string Import_NothingFound => ResourceManager.GetString(nameof(Import_NothingFound), Culture) ?? nameof(Import_NothingFound);
|
||||
|
||||
public static string Import_NothingNew => ResourceManager.GetString(nameof(Import_NothingNew), Culture) ?? nameof(Import_NothingNew);
|
||||
|
||||
public static string Import_SelectAll => ResourceManager.GetString(nameof(Import_SelectAll), Culture) ?? nameof(Import_SelectAll);
|
||||
|
||||
public static string Import_Selected_Format => ResourceManager.GetString(nameof(Import_Selected_Format), Culture) ?? nameof(Import_Selected_Format);
|
||||
|
||||
public static string Import_SelectNone => ResourceManager.GetString(nameof(Import_SelectNone), Culture) ?? nameof(Import_SelectNone);
|
||||
|
||||
public static string Import_ShowExisting_Format => ResourceManager.GetString(nameof(Import_ShowExisting_Format), Culture) ?? nameof(Import_ShowExisting_Format);
|
||||
|
||||
public static string Import_Title => ResourceManager.GetString(nameof(Import_Title), Culture) ?? nameof(Import_Title);
|
||||
|
||||
public static string Latency_Avg => ResourceManager.GetString(nameof(Latency_Avg), Culture) ?? nameof(Latency_Avg);
|
||||
@@ -1592,6 +1842,8 @@ public static class Strings
|
||||
|
||||
public static string Latency_Stats_Format => ResourceManager.GetString(nameof(Latency_Stats_Format), Culture) ?? nameof(Latency_Stats_Format);
|
||||
|
||||
public static string Launch_Error_1400 => ResourceManager.GetString(nameof(Launch_Error_1400), Culture) ?? nameof(Launch_Error_1400);
|
||||
|
||||
public static string Launch_Error_193 => ResourceManager.GetString(nameof(Launch_Error_193), Culture) ?? nameof(Launch_Error_193);
|
||||
|
||||
public static string Launch_Error_2 => ResourceManager.GetString(nameof(Launch_Error_2), Culture) ?? nameof(Launch_Error_2);
|
||||
@@ -1606,6 +1858,10 @@ public static class Strings
|
||||
|
||||
public static string Launch_Failed_Format => ResourceManager.GetString(nameof(Launch_Failed_Format), Culture) ?? nameof(Launch_Failed_Format);
|
||||
|
||||
public static string Limitations_OnGitHub => ResourceManager.GetString(nameof(Limitations_OnGitHub), Culture) ?? nameof(Limitations_OnGitHub);
|
||||
|
||||
public static string Limitations_Title => ResourceManager.GetString(nameof(Limitations_Title), Culture) ?? nameof(Limitations_Title);
|
||||
|
||||
public static string Logs_Bundle_Exported_Format => ResourceManager.GetString(nameof(Logs_Bundle_Exported_Format), Culture) ?? nameof(Logs_Bundle_Exported_Format);
|
||||
|
||||
public static string Logs_Bundle_Failed_Format => ResourceManager.GetString(nameof(Logs_Bundle_Failed_Format), Culture) ?? nameof(Logs_Bundle_Failed_Format);
|
||||
@@ -1722,6 +1978,8 @@ public static class Strings
|
||||
|
||||
public static string Menu_Help_Documentation => ResourceManager.GetString(nameof(Menu_Help_Documentation), Culture) ?? nameof(Menu_Help_Documentation);
|
||||
|
||||
public static string Menu_Help_Limitations => ResourceManager.GetString(nameof(Menu_Help_Limitations), Culture) ?? nameof(Menu_Help_Limitations);
|
||||
|
||||
public static string Menu_Help_ReportBug => ResourceManager.GetString(nameof(Menu_Help_ReportBug), Culture) ?? nameof(Menu_Help_ReportBug);
|
||||
|
||||
public static string Menu_Tools => ResourceManager.GetString(nameof(Menu_Tools), Culture) ?? nameof(Menu_Tools);
|
||||
@@ -1876,10 +2134,14 @@ public static class Strings
|
||||
|
||||
public static string Sensors_Vram_Header => ResourceManager.GetString(nameof(Sensors_Vram_Header), Culture) ?? nameof(Sensors_Vram_Header);
|
||||
|
||||
public static string Session_UnderException_Format => ResourceManager.GetString(nameof(Session_UnderException_Format), Culture) ?? nameof(Session_UnderException_Format);
|
||||
|
||||
public static string Sessions_Col_Api => ResourceManager.GetString(nameof(Sessions_Col_Api), Culture) ?? nameof(Sessions_Col_Api);
|
||||
|
||||
public static string Sessions_Col_Date => ResourceManager.GetString(nameof(Sessions_Col_Date), Culture) ?? nameof(Sessions_Col_Date);
|
||||
|
||||
public static string Sessions_Col_Display => ResourceManager.GetString(nameof(Sessions_Col_Display), Culture) ?? nameof(Sessions_Col_Display);
|
||||
|
||||
public static string Sessions_Col_Displayed => ResourceManager.GetString(nameof(Sessions_Col_Displayed), Culture) ?? nameof(Sessions_Col_Displayed);
|
||||
|
||||
public static string Sessions_Col_Duration => ResourceManager.GetString(nameof(Sessions_Col_Duration), Culture) ?? nameof(Sessions_Col_Duration);
|
||||
@@ -1908,10 +2170,26 @@ public static class Strings
|
||||
|
||||
public static string Settings_Agent_Elevation_Label => ResourceManager.GetString(nameof(Settings_Agent_Elevation_Label), Culture) ?? nameof(Settings_Agent_Elevation_Label);
|
||||
|
||||
public static string Settings_Agent_ElevationDeclined => ResourceManager.GetString(nameof(Settings_Agent_ElevationDeclined), Culture) ?? nameof(Settings_Agent_ElevationDeclined);
|
||||
|
||||
public static string Settings_Agent_ElevationFailed => ResourceManager.GetString(nameof(Settings_Agent_ElevationFailed), Culture) ?? nameof(Settings_Agent_ElevationFailed);
|
||||
|
||||
public static string Settings_Agent_ElevationOtherAccount => ResourceManager.GetString(nameof(Settings_Agent_ElevationOtherAccount), Culture) ?? nameof(Settings_Agent_ElevationOtherAccount);
|
||||
|
||||
public static string Settings_Agent_Header => ResourceManager.GetString(nameof(Settings_Agent_Header), Culture) ?? nameof(Settings_Agent_Header);
|
||||
|
||||
public static string Settings_Agent_NotElevated => ResourceManager.GetString(nameof(Settings_Agent_NotElevated), Culture) ?? nameof(Settings_Agent_NotElevated);
|
||||
|
||||
public static string Settings_Agent_RunElevated_AfterSession => ResourceManager.GetString(nameof(Settings_Agent_RunElevated_AfterSession), Culture) ?? nameof(Settings_Agent_RunElevated_AfterSession);
|
||||
|
||||
public static string Settings_Agent_RunElevated_Body => ResourceManager.GetString(nameof(Settings_Agent_RunElevated_Body), Culture) ?? nameof(Settings_Agent_RunElevated_Body);
|
||||
|
||||
public static string Settings_Agent_RunElevated_Label => ResourceManager.GetString(nameof(Settings_Agent_RunElevated_Label), Culture) ?? nameof(Settings_Agent_RunElevated_Label);
|
||||
|
||||
public static string Settings_Agent_RunElevated_NotStopped => ResourceManager.GetString(nameof(Settings_Agent_RunElevated_NotStopped), Culture) ?? nameof(Settings_Agent_RunElevated_NotStopped);
|
||||
|
||||
public static string Settings_Agent_RunElevated_Restarting => ResourceManager.GetString(nameof(Settings_Agent_RunElevated_Restarting), Culture) ?? nameof(Settings_Agent_RunElevated_Restarting);
|
||||
|
||||
public static string Settings_Agent_Task_Installed => ResourceManager.GetString(nameof(Settings_Agent_Task_Installed), Culture) ?? nameof(Settings_Agent_Task_Installed);
|
||||
|
||||
public static string Settings_Agent_Task_Label => ResourceManager.GetString(nameof(Settings_Agent_Task_Label), Culture) ?? nameof(Settings_Agent_Task_Label);
|
||||
@@ -1946,6 +2224,24 @@ public static class Strings
|
||||
|
||||
public static string Settings_Channel_Stable => ResourceManager.GetString(nameof(Settings_Channel_Stable), Culture) ?? nameof(Settings_Channel_Stable);
|
||||
|
||||
public static string Settings_Exceptions_Body => ResourceManager.GetString(nameof(Settings_Exceptions_Body), Culture) ?? nameof(Settings_Exceptions_Body);
|
||||
|
||||
public static string Settings_Exceptions_Checking => ResourceManager.GetString(nameof(Settings_Exceptions_Checking), Culture) ?? nameof(Settings_Exceptions_Checking);
|
||||
|
||||
public static string Settings_Exceptions_Empty => ResourceManager.GetString(nameof(Settings_Exceptions_Empty), Culture) ?? nameof(Settings_Exceptions_Empty);
|
||||
|
||||
public static string Settings_Exceptions_Grant => ResourceManager.GetString(nameof(Settings_Exceptions_Grant), Culture) ?? nameof(Settings_Exceptions_Grant);
|
||||
|
||||
public static string Settings_Exceptions_Header => ResourceManager.GetString(nameof(Settings_Exceptions_Header), Culture) ?? nameof(Settings_Exceptions_Header);
|
||||
|
||||
public static string Settings_Exceptions_Label => ResourceManager.GetString(nameof(Settings_Exceptions_Label), Culture) ?? nameof(Settings_Exceptions_Label);
|
||||
|
||||
public static string Settings_Exceptions_Refresh => ResourceManager.GetString(nameof(Settings_Exceptions_Refresh), Culture) ?? nameof(Settings_Exceptions_Refresh);
|
||||
|
||||
public static string Settings_Exceptions_Suspended => ResourceManager.GetString(nameof(Settings_Exceptions_Suspended), Culture) ?? nameof(Settings_Exceptions_Suspended);
|
||||
|
||||
public static string Settings_Exceptions_Withdraw => ResourceManager.GetString(nameof(Settings_Exceptions_Withdraw), Culture) ?? nameof(Settings_Exceptions_Withdraw);
|
||||
|
||||
public static string Settings_FpsDecimals_Body => ResourceManager.GetString(nameof(Settings_FpsDecimals_Body), Culture) ?? nameof(Settings_FpsDecimals_Body);
|
||||
|
||||
public static string Settings_FpsDecimals_Label => ResourceManager.GetString(nameof(Settings_FpsDecimals_Label), Culture) ?? nameof(Settings_FpsDecimals_Label);
|
||||
@@ -2118,6 +2414,8 @@ public static class Strings
|
||||
|
||||
public static string Summary_Stat_Cpu => ResourceManager.GetString(nameof(Summary_Stat_Cpu), Culture) ?? nameof(Summary_Stat_Cpu);
|
||||
|
||||
public static string Summary_Stat_Display => ResourceManager.GetString(nameof(Summary_Stat_Display), Culture) ?? nameof(Summary_Stat_Display);
|
||||
|
||||
public static string Summary_Stat_Duration => ResourceManager.GetString(nameof(Summary_Stat_Duration), Culture) ?? nameof(Summary_Stat_Duration);
|
||||
|
||||
public static string Summary_Stat_Gpu => ResourceManager.GetString(nameof(Summary_Stat_Gpu), Culture) ?? nameof(Summary_Stat_Gpu);
|
||||
@@ -2192,6 +2490,8 @@ public static class Strings
|
||||
|
||||
public static string Tier_Hooked_Tooltip => ResourceManager.GetString(nameof(Tier_Hooked_Tooltip), Culture) ?? nameof(Tier_Hooked_Tooltip);
|
||||
|
||||
public static string Tier_HookedException => ResourceManager.GetString(nameof(Tier_HookedException), Culture) ?? nameof(Tier_HookedException);
|
||||
|
||||
public static string Tier_NA_Tooltip => ResourceManager.GetString(nameof(Tier_NA_Tooltip), Culture) ?? nameof(Tier_NA_Tooltip);
|
||||
|
||||
public static string Tier_NotHooked => ResourceManager.GetString(nameof(Tier_NotHooked), Culture) ?? nameof(Tier_NotHooked);
|
||||
@@ -2254,8 +2554,14 @@ public static class Strings
|
||||
|
||||
public static string Trend_Metric_AvgRam => ResourceManager.GetString(nameof(Trend_Metric_AvgRam), Culture) ?? nameof(Trend_Metric_AvgRam);
|
||||
|
||||
public static string Trend_Metric_DisplayBorderless => ResourceManager.GetString(nameof(Trend_Metric_DisplayBorderless), Culture) ?? nameof(Trend_Metric_DisplayBorderless);
|
||||
|
||||
public static string Trend_Metric_Displayed => ResourceManager.GetString(nameof(Trend_Metric_Displayed), Culture) ?? nameof(Trend_Metric_Displayed);
|
||||
|
||||
public static string Trend_Metric_DisplayExclusive => ResourceManager.GetString(nameof(Trend_Metric_DisplayExclusive), Culture) ?? nameof(Trend_Metric_DisplayExclusive);
|
||||
|
||||
public static string Trend_Metric_DisplayWindowed => ResourceManager.GetString(nameof(Trend_Metric_DisplayWindowed), Culture) ?? nameof(Trend_Metric_DisplayWindowed);
|
||||
|
||||
public static string Trend_Metric_FgFactor => ResourceManager.GetString(nameof(Trend_Metric_FgFactor), Culture) ?? nameof(Trend_Metric_FgFactor);
|
||||
|
||||
public static string Trend_Metric_Label => ResourceManager.GetString(nameof(Trend_Metric_Label), Culture) ?? nameof(Trend_Metric_Label);
|
||||
|
||||
@@ -61,6 +61,10 @@
|
||||
<value>エージェントを起動中…</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Agent_State_Elevating" xml:space="preserve">
|
||||
<value>管理者の許可を待っています…</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="App_Title" xml:space="preserve">
|
||||
<value>FrameLedger</value>
|
||||
<comment>review</comment>
|
||||
@@ -141,6 +145,10 @@
|
||||
<value>ゲーム</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_Header_Count_Format" xml:space="preserve">
|
||||
<value>ゲーム · {0}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Logs_Empty" xml:space="preserve">
|
||||
<value>このソースのログファイルはまだありません。</value>
|
||||
<comment>review</comment>
|
||||
@@ -285,6 +293,14 @@
|
||||
<value>このマシンの Steam、GOG Galaxy、Epic、itch.io にインストール済みのゲームは見つかりませんでした。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Import_NothingNew" xml:space="preserve">
|
||||
<value>新しいゲームはありません。ストアにインストールされているゲームはすべてライブラリーにあります。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Import_ShowExisting_Format" xml:space="preserve">
|
||||
<value>ライブラリーにある {0} 件のゲームを表示する</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Import_Done_Format" xml:space="preserve">
|
||||
<value>{0} 件のゲームをフック無効で追加しました。{1} 件はそのままです。</value>
|
||||
<comment>review</comment>
|
||||
@@ -305,6 +321,18 @@
|
||||
<value>ドキュメント</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Menu_Help_Limitations" xml:space="preserve">
|
||||
<value>制限事項</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Limitations_Title" xml:space="preserve">
|
||||
<value>FrameLedger にできないこと</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Limitations_OnGitHub" xml:space="preserve">
|
||||
<value>GitHub で開く</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Menu_Help_ReportBug" xml:space="preserve">
|
||||
<value>不具合を報告…</value>
|
||||
<comment>review</comment>
|
||||
@@ -677,6 +705,86 @@
|
||||
<value>{0}×{1}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Mode_Exclusive" xml:space="preserve">
|
||||
<value>排他的フルスクリーン</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Mode_Borderless" xml:space="preserve">
|
||||
<value>ボーダーレス</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Mode_CoversScreen" xml:space="preserve">
|
||||
<value>フルスクリーンまたはボーダーレス</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Mode_Windowed" xml:space="preserve">
|
||||
<value>ウィンドウ</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Mode_Minimized" xml:space="preserve">
|
||||
<value>最小化</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Mode_NoWindow" xml:space="preserve">
|
||||
<value>ウィンドウを読み取れず</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Share_Format" xml:space="preserve">
|
||||
<value>{0} {1}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Size_Format" xml:space="preserve">
|
||||
<value>{0}×{1}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_SizeHz_Format" xml:space="preserve">
|
||||
<value>{0}×{1} @ {2} Hz</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Changes_One" xml:space="preserve">
|
||||
<value>1 回切り替え</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Changes_Format" xml:space="preserve">
|
||||
<value>{0} 回切り替え</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Window_Format" xml:space="preserve">
|
||||
<value>ウィンドウ {0}×{1}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_WindowOnMonitor_Format" xml:space="preserve">
|
||||
<value>{2}×{3} のモニター上のウィンドウ {0}×{1}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_WindowOnMonitorHz_Format" xml:space="preserve">
|
||||
<value>{2}×{3}・{4} Hz のモニター上のウィンドウ {0}×{1}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Buffer_Format" xml:space="preserve">
|
||||
<value>バックバッファー {0}×{1}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_BufferEffect_Format" xml:space="preserve">
|
||||
<value>バックバッファー {0}×{1}({2})</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Source_SwapChain" xml:space="preserve">
|
||||
<value>排他かどうかはスワップチェーンが報告</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Source_OpenGl" xml:space="preserve">
|
||||
<value>OpenGL:排他的フルスクリーンとボーダーレスは区別できません</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Source_Window" xml:space="preserve">
|
||||
<value>ウィンドウのみから:排他的フルスクリーンとボーダーレスは区別できません</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Display_Line_Format" xml:space="preserve">
|
||||
<value>表示:{0}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Format_Temperature_Format" xml:space="preserve">
|
||||
<value>{0:0} °C</value>
|
||||
<comment>review</comment>
|
||||
@@ -881,10 +989,58 @@
|
||||
<value>ゲームを追加…</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_Refresh" xml:space="preserve">
|
||||
<value>更新</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_Refresh_ToolTip" xml:space="preserve">
|
||||
<value>ライブラリーを読み直し、その後にインストールされたゲームをストアから探し、実行ファイルがなくなったゲームに印を付けます</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_View_Grid" xml:space="preserve">
|
||||
<value>グリッドで表示</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_View_List" xml:space="preserve">
|
||||
<value>リストで表示</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_List_Name" xml:space="preserve">
|
||||
<value>名前</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_List_Store" xml:space="preserve">
|
||||
<value>ストア</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_List_Engine" xml:space="preserve">
|
||||
<value>エンジン</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_List_Status" xml:space="preserve">
|
||||
<value>状態</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_List_Sessions" xml:space="preserve">
|
||||
<value>セッション</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_List_Played" xml:space="preserve">
|
||||
<value>プレイ時間</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_List_LastPlayed" xml:space="preserve">
|
||||
<value>最終プレイ</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_Card_NotRecorded" xml:space="preserve">
|
||||
<value>記録しない</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_Card_NotInstalled" xml:space="preserve">
|
||||
<value>未インストール</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_Card_HookOff" xml:space="preserve">
|
||||
<value>フック無効</value>
|
||||
<comment>review</comment>
|
||||
@@ -957,6 +1113,10 @@
|
||||
<value>API</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Sessions_Col_Display" xml:space="preserve">
|
||||
<value>表示</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Sessions_Col_Date" xml:space="preserve">
|
||||
<value>日付</value>
|
||||
<comment>review</comment>
|
||||
@@ -1329,6 +1489,18 @@
|
||||
<value>時間</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Compare_Metric_Display" xml:space="preserve">
|
||||
<value>表示モード</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Compare_Metric_Window" xml:space="preserve">
|
||||
<value>ウィンドウ</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Compare_Metric_Monitor" xml:space="preserve">
|
||||
<value>モニター</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Compare_Metric_MaxGpuTemp" xml:space="preserve">
|
||||
<value>GPU 最高 °C</value>
|
||||
<comment>review</comment>
|
||||
@@ -1649,6 +1821,38 @@
|
||||
<value>標準ユーザーとして実行中です。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_Label" xml:space="preserve">
|
||||
<value>エージェントを管理者として実行</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_Body" xml:space="preserve">
|
||||
<value>既定ではオフです。オンにすると、ログオン時を含め、エージェントが起動するたびに Windows が確認します。FrameLedger から起動したゲームは引き続き標準ユーザーの権限で実行されます。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Agent_ElevationDeclined" xml:space="preserve">
|
||||
<value>標準ユーザーとして実行中です: 管理者の確認が拒否されました。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Agent_ElevationOtherAccount" xml:space="preserve">
|
||||
<value>標準ユーザーとして実行中です: 別のアカウントで確認に応答されました。そのアカウントのエージェントはあなたのデータを使いません。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Agent_ElevationFailed" xml:space="preserve">
|
||||
<value>標準ユーザーとして実行中です: Windows はエージェントを管理者として起動できませんでした。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_Restarting" xml:space="preserve">
|
||||
<value>保存しました。エージェントを再起動します。オプションがオンの場合は Windows が許可を求めます。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_AfterSession" xml:space="preserve">
|
||||
<value>保存しました。セッションが実行中のため、次に起動するまでエージェントは現在の権限のままです。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_NotStopped" xml:space="preserve">
|
||||
<value>保存しましたが、エージェントが停止しませんでした。次に起動するまで現在の権限のままです。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Agent_Task_Label" xml:space="preserve">
|
||||
<value>ログオン時にエージェントを起動</value>
|
||||
<comment>review</comment>
|
||||
@@ -2396,6 +2600,18 @@
|
||||
<value>FG倍率 ×</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Trend_Metric_DisplayExclusive" xml:space="preserve">
|
||||
<value>排他的フルスクリーンの割合 %</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Trend_Metric_DisplayBorderless" xml:space="preserve">
|
||||
<value>ボーダーレスの割合 %</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Trend_Metric_DisplayWindowed" xml:space="preserve">
|
||||
<value>ウィンドウの割合 %</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Sensors_Series_CpuTemp" xml:space="preserve">
|
||||
<value>CPU °C</value>
|
||||
<comment>review</comment>
|
||||
@@ -2428,6 +2644,10 @@
|
||||
<value>CPU</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Summary_Stat_Display" xml:space="preserve">
|
||||
<value>表示</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Summary_Stat_LoadTemp_Format" xml:space="preserve">
|
||||
<value>平均 {0} · 最大 {1}</value>
|
||||
<comment>review</comment>
|
||||
@@ -2521,6 +2741,10 @@
|
||||
<value>検出: {0}。このゲームのフックはオフで、オンにすることはできません。セッションにはプレイ時間とセンサーの値だけが記録されます。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_AntiCheat_Exceptionable_Format" xml:space="preserve">
|
||||
<value>検出: {0}。ユーザーモードの例外を作成しない限り(下記)、このゲームのフックはオフです。例外がなければ、セッションにはプレイ時間とセンサーの値だけが記録されます。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_Card_AntiCheat" xml:space="preserve">
|
||||
<value>アンチチート</value>
|
||||
<comment>review</comment>
|
||||
@@ -2530,7 +2754,7 @@
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_HideAntiCheatHooking_Body" xml:space="preserve">
|
||||
<value>アンチチートが検出されたゲームはフックできません。オンにするとゲームのページには検出内容だけが表示され、オフにすると無効化されたフックのスイッチも表示されます。どちらの場合も、フックなしで記録は続きます。</value>
|
||||
<value>アンチチートが検出されたゲームは、ユーザーモード例外(下記)を作成しない限りフックできません。オンにするとゲームのページには検出内容だけが表示され、オフにすると無効化されたフックのスイッチも表示されます。どちらの場合も、フックなしで記録は続きます。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Notice_HookingOff_Title_Format" xml:space="preserve">
|
||||
@@ -2609,6 +2833,26 @@
|
||||
<value>エンジン</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_EngineVersion" xml:space="preserve">
|
||||
<value>エンジンのバージョン</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_EngineVersion_BranchAndFile" xml:space="preserve">
|
||||
<value>ゲームの実行ファイル内にあるエンジンのビルド名とバージョン番号から。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_EngineVersion_Branch" xml:space="preserve">
|
||||
<value>ゲームの実行ファイル内にあるエンジンのビルド名から。パッチ番号はそこに記録されていません。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_EngineVersion_FileVersion" xml:space="preserve">
|
||||
<value>実行ファイルのバージョン番号のみから。スタジオが独自の番号に置き換えることがあるため、確実ではなく可能性が高い値として扱ってください。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_EngineVersion_NotFound" xml:space="preserve">
|
||||
<value>ゲームの実行ファイル内に見つかりません。実行ファイルが圧縮・保護されているか、スタジオがエンジンのビルド名を変更している可能性があります。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Libraries" xml:space="preserve">
|
||||
<value>同梱ライブラリ</value>
|
||||
<comment>review</comment>
|
||||
@@ -3033,6 +3277,10 @@
|
||||
<value>ゲームには管理者権限が必要です</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Launch_Error_1400" xml:space="preserve">
|
||||
<value>標準ユーザーの権限でゲームを起動するためのデスクトップ シェルがありません (エージェントは管理者として実行されており、その方法でゲームを起動することはありません)</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Launch_Failed_Format" xml:space="preserve">
|
||||
<value>{0}({1})</value>
|
||||
<comment>review</comment>
|
||||
@@ -3113,4 +3361,164 @@
|
||||
<value>W</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Label" xml:space="preserve">
|
||||
<value>アンチチートがユーザーモードのみで動作するゲームでフックを許可する</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Body" xml:space="preserve">
|
||||
<value>既定ではオフです。オンにすると、アンチチートがユーザーモードのみで動作する(カーネルドライバーがなく、ほかに何も検出されない)ゲームに、開示を確認したうえでゲームごとに例外を与えられます。最初の2回のフックセッションは試用期間で、うまくいかなかったセッションが1回でもあると例外は永久に終了します。ガードはすべてのチェックを続け、アカウント停止の可能性は残ります。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Header" xml:space="preserve">
|
||||
<value>ユーザーモード例外</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Empty" xml:space="preserve">
|
||||
<value>ライブラリに対象のゲームはありません。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Suspended" xml:space="preserve">
|
||||
<value>オプションがオフです。下の例外は保持されますが適用されません。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Grant" xml:space="preserve">
|
||||
<value>例外を作成…</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Withdraw" xml:space="preserve">
|
||||
<value>取り消す</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_Finding_Format" xml:space="preserve">
|
||||
<value>{0} — {1}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_State_Granted_Format" xml:space="preserve">
|
||||
<value>{0} から例外が有効</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_State_GrantedTrial_Format" xml:space="preserve">
|
||||
<value>{0} から例外が有効 — 試用中: 良好なセッション {1}/{2} 回</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_State_Eligible" xml:space="preserve">
|
||||
<value>対象 — 例外は未作成</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_State_Checking" xml:space="preserve">
|
||||
<value>確認中…</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_State_Refused_Format" xml:space="preserve">
|
||||
<value>対象外: ガードは {0}({1})も検出しました</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_State_NotUserMode_Format" xml:space="preserve">
|
||||
<value>対象外: {0} は完全なユーザーモードではない(ドライバーまたはサービスがある)ため、FrameLedger は例外にしません</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_State_NotAsked" xml:space="preserve">
|
||||
<value>対象外: この検出は単一のアンチチートのモジュール・ファイル・フォルダーではありません</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_State_CouldNotVerify" xml:space="preserve">
|
||||
<value>現在は対象外: 確認を完了できませんでした。自動で再実行されます</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_State_TrialFailed_Format" xml:space="preserve">
|
||||
<value>対象外: このゲームの例外は {0} に試用期間中に終了したため、再び作成することはできません</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_State_NotFound_Format" xml:space="preserve">
|
||||
<value>現在は対象外: 確認時にゲームのフォルダーで {0} が見つかりませんでした。ブロックは維持されます</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_Lapsed_Format" xml:space="preserve">
|
||||
<value>直近の例外は {0} に終了しました: {1}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_Lapse_Withdrawn" xml:space="preserve">
|
||||
<value>取り消されました</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_Lapse_ExecutableChanged" xml:space="preserve">
|
||||
<value>ゲームが更新されました</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_Lapse_NoLongerEligible" xml:space="preserve">
|
||||
<value>ゲームが条件を満たさなくなりました</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_Lapse_NewFinding" xml:space="preserve">
|
||||
<value>ゲームで新たなアンチチートが検出されました</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_Lapse_SafetyUnhook" xml:space="preserve">
|
||||
<value>例外下のセッションが安全のため停止されました</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_Lapse_OverlayStopped" xml:space="preserve">
|
||||
<value>別のアンチチートが読み込まれたため FrameLedger が観測を停止しました</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_Lapse_SessionCrashed" xml:space="preserve">
|
||||
<value>例外下のセッションがクラッシュしました</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_Lapse_TrialFailed" xml:space="preserve">
|
||||
<value>試用期間中のセッションがうまくいきませんでした(フレームが記録されなかったか、正常に終了しませんでした)</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_Result_Granted_Format" xml:space="preserve">
|
||||
<value>{0} の例外を作成しました。計測するときは、ゲームのページでフックをオンにしてください。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_Result_Withdrawn_Format" xml:space="preserve">
|
||||
<value>{0} の例外を取り消しました。フックはオフです。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Exception_Result_Refused_Format" xml:space="preserve">
|
||||
<value>{0} の例外は作成されませんでした: {1}</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Header" xml:space="preserve">
|
||||
<value>ユーザーモード例外</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Granted_Format" xml:space="preserve">
|
||||
<value>{0} に対するユーザーモード例外のもとでフックできます。ガードはすべてのチェックを続け、アカウント停止の可能性は残ります。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Suspended" xml:space="preserve">
|
||||
<value>このゲームの例外は保持されていますが、設定でオプションがオフのため適用されません。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Grant" xml:space="preserve">
|
||||
<value>例外を作成…</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Withdraw" xml:space="preserve">
|
||||
<value>例外を取り消す</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Refresh" xml:space="preserve">
|
||||
<value>更新</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Checking" xml:space="preserve">
|
||||
<value>キャプチャエージェントがライブラリを確認しています。対象のゲームは1分以内にここに表示されます。更新して確認してください。</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Tier_HookedException" xml:space="preserve">
|
||||
<value>フック・例外</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Games_Card_Exception" xml:space="preserve">
|
||||
<value>例外</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
<data name="Session_UnderException_Format" xml:space="preserve">
|
||||
<value>{0} のユーザーモード例外のもとでフック</value>
|
||||
<comment>review</comment>
|
||||
</data>
|
||||
</root>
|
||||
@@ -51,6 +51,9 @@
|
||||
<data name="Agent_State_Starting" xml:space="preserve">
|
||||
<value>Starting agent…</value>
|
||||
</data>
|
||||
<data name="Agent_State_Elevating" xml:space="preserve">
|
||||
<value>Waiting for administrator permission…</value>
|
||||
</data>
|
||||
<data name="App_Title" xml:space="preserve">
|
||||
<value>FrameLedger</value>
|
||||
</data>
|
||||
@@ -111,6 +114,9 @@
|
||||
<data name="Games_Header" xml:space="preserve">
|
||||
<value>Games</value>
|
||||
</data>
|
||||
<data name="Games_Header_Count_Format" xml:space="preserve">
|
||||
<value>Games · {0}</value>
|
||||
</data>
|
||||
<data name="Logs_Empty" xml:space="preserve">
|
||||
<value>No log file yet for this source.</value>
|
||||
</data>
|
||||
@@ -219,6 +225,12 @@
|
||||
<data name="Import_NothingFound" xml:space="preserve">
|
||||
<value>No installed games were found in Steam, GOG Galaxy, Epic or itch.io on this machine.</value>
|
||||
</data>
|
||||
<data name="Import_NothingNew" xml:space="preserve">
|
||||
<value>No new games: every game your stores have installed is already in the library.</value>
|
||||
</data>
|
||||
<data name="Import_ShowExisting_Format" xml:space="preserve">
|
||||
<value>Show the {0} games already in the library</value>
|
||||
</data>
|
||||
<data name="Import_Done_Format" xml:space="preserve">
|
||||
<value>{0} game(s) added with hooking off; {1} left as they were.</value>
|
||||
</data>
|
||||
@@ -234,6 +246,15 @@
|
||||
<data name="Menu_Help_Documentation" xml:space="preserve">
|
||||
<value>Documentation</value>
|
||||
</data>
|
||||
<data name="Menu_Help_Limitations" xml:space="preserve">
|
||||
<value>Limitations</value>
|
||||
</data>
|
||||
<data name="Limitations_Title" xml:space="preserve">
|
||||
<value>What FrameLedger cannot do</value>
|
||||
</data>
|
||||
<data name="Limitations_OnGitHub" xml:space="preserve">
|
||||
<value>Open on GitHub</value>
|
||||
</data>
|
||||
<data name="Menu_Help_ReportBug" xml:space="preserve">
|
||||
<value>Report a bug…</value>
|
||||
</data>
|
||||
@@ -513,6 +534,66 @@
|
||||
<data name="Format_Resolution_Single_Format" xml:space="preserve">
|
||||
<value>{0}×{1}</value>
|
||||
</data>
|
||||
<data name="Display_Mode_Exclusive" xml:space="preserve">
|
||||
<value>Exclusive fullscreen</value>
|
||||
</data>
|
||||
<data name="Display_Mode_Borderless" xml:space="preserve">
|
||||
<value>Borderless</value>
|
||||
</data>
|
||||
<data name="Display_Mode_CoversScreen" xml:space="preserve">
|
||||
<value>Fullscreen or borderless</value>
|
||||
</data>
|
||||
<data name="Display_Mode_Windowed" xml:space="preserve">
|
||||
<value>Windowed</value>
|
||||
</data>
|
||||
<data name="Display_Mode_Minimized" xml:space="preserve">
|
||||
<value>Minimized</value>
|
||||
</data>
|
||||
<data name="Display_Mode_NoWindow" xml:space="preserve">
|
||||
<value>No window read</value>
|
||||
</data>
|
||||
<data name="Display_Share_Format" xml:space="preserve">
|
||||
<value>{0} {1}</value>
|
||||
</data>
|
||||
<data name="Display_Size_Format" xml:space="preserve">
|
||||
<value>{0}×{1}</value>
|
||||
</data>
|
||||
<data name="Display_SizeHz_Format" xml:space="preserve">
|
||||
<value>{0}×{1} @ {2} Hz</value>
|
||||
</data>
|
||||
<data name="Display_Changes_One" xml:space="preserve">
|
||||
<value>changed once</value>
|
||||
</data>
|
||||
<data name="Display_Changes_Format" xml:space="preserve">
|
||||
<value>changed {0} times</value>
|
||||
</data>
|
||||
<data name="Display_Window_Format" xml:space="preserve">
|
||||
<value>window {0}×{1}</value>
|
||||
</data>
|
||||
<data name="Display_WindowOnMonitor_Format" xml:space="preserve">
|
||||
<value>window {0}×{1} on a {2}×{3} monitor</value>
|
||||
</data>
|
||||
<data name="Display_WindowOnMonitorHz_Format" xml:space="preserve">
|
||||
<value>window {0}×{1} on a {2}×{3} monitor at {4} Hz</value>
|
||||
</data>
|
||||
<data name="Display_Buffer_Format" xml:space="preserve">
|
||||
<value>back buffer {0}×{1}</value>
|
||||
</data>
|
||||
<data name="Display_BufferEffect_Format" xml:space="preserve">
|
||||
<value>back buffer {0}×{1} ({2})</value>
|
||||
</data>
|
||||
<data name="Display_Source_SwapChain" xml:space="preserve">
|
||||
<value>the swap chain said whether it was exclusive</value>
|
||||
</data>
|
||||
<data name="Display_Source_OpenGl" xml:space="preserve">
|
||||
<value>OpenGL: exclusive fullscreen cannot be told from borderless</value>
|
||||
</data>
|
||||
<data name="Display_Source_Window" xml:space="preserve">
|
||||
<value>from the window alone: exclusive fullscreen cannot be told from borderless</value>
|
||||
</data>
|
||||
<data name="Display_Line_Format" xml:space="preserve">
|
||||
<value>Display: {0}</value>
|
||||
</data>
|
||||
<data name="Format_Temperature_Format" xml:space="preserve">
|
||||
<value>{0:0} °C</value>
|
||||
</data>
|
||||
@@ -666,9 +747,45 @@
|
||||
<data name="Games_Add" xml:space="preserve">
|
||||
<value>Add game…</value>
|
||||
</data>
|
||||
<data name="Games_Refresh" xml:space="preserve">
|
||||
<value>Refresh</value>
|
||||
</data>
|
||||
<data name="Games_Refresh_ToolTip" xml:space="preserve">
|
||||
<value>Read the library again, look in your stores for games installed since, and mark games whose executable is gone</value>
|
||||
</data>
|
||||
<data name="Games_View_Grid" xml:space="preserve">
|
||||
<value>Show as a grid</value>
|
||||
</data>
|
||||
<data name="Games_View_List" xml:space="preserve">
|
||||
<value>Show as a list</value>
|
||||
</data>
|
||||
<data name="Games_List_Name" xml:space="preserve">
|
||||
<value>Name</value>
|
||||
</data>
|
||||
<data name="Games_List_Store" xml:space="preserve">
|
||||
<value>Store</value>
|
||||
</data>
|
||||
<data name="Games_List_Engine" xml:space="preserve">
|
||||
<value>Engine</value>
|
||||
</data>
|
||||
<data name="Games_List_Status" xml:space="preserve">
|
||||
<value>Status</value>
|
||||
</data>
|
||||
<data name="Games_List_Sessions" xml:space="preserve">
|
||||
<value>Sessions</value>
|
||||
</data>
|
||||
<data name="Games_List_Played" xml:space="preserve">
|
||||
<value>Played</value>
|
||||
</data>
|
||||
<data name="Games_List_LastPlayed" xml:space="preserve">
|
||||
<value>Last played</value>
|
||||
</data>
|
||||
<data name="Games_Card_NotRecorded" xml:space="preserve">
|
||||
<value>Not recorded</value>
|
||||
</data>
|
||||
<data name="Games_Card_NotInstalled" xml:space="preserve">
|
||||
<value>Not installed</value>
|
||||
</data>
|
||||
<data name="Games_Card_HookOff" xml:space="preserve">
|
||||
<value>Hooking off</value>
|
||||
</data>
|
||||
@@ -723,6 +840,9 @@
|
||||
<data name="Sessions_Col_Api" xml:space="preserve">
|
||||
<value>API</value>
|
||||
</data>
|
||||
<data name="Sessions_Col_Display" xml:space="preserve">
|
||||
<value>Display</value>
|
||||
</data>
|
||||
<data name="Sessions_Col_Date" xml:space="preserve">
|
||||
<value>Date</value>
|
||||
</data>
|
||||
@@ -1002,6 +1122,15 @@
|
||||
<data name="Compare_Metric_Duration" xml:space="preserve">
|
||||
<value>Duration</value>
|
||||
</data>
|
||||
<data name="Compare_Metric_Display" xml:space="preserve">
|
||||
<value>Display mode</value>
|
||||
</data>
|
||||
<data name="Compare_Metric_Window" xml:space="preserve">
|
||||
<value>Window</value>
|
||||
</data>
|
||||
<data name="Compare_Metric_Monitor" xml:space="preserve">
|
||||
<value>Monitor</value>
|
||||
</data>
|
||||
<data name="Compare_Metric_MaxGpuTemp" xml:space="preserve">
|
||||
<value>Max GPU °C</value>
|
||||
</data>
|
||||
@@ -1242,6 +1371,30 @@
|
||||
<data name="Settings_Agent_NotElevated" xml:space="preserve">
|
||||
<value>Running as a standard user.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_Label" xml:space="preserve">
|
||||
<value>Run the agent as administrator</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_Body" xml:space="preserve">
|
||||
<value>Off by default. When on, Windows asks every time the agent starts, at logon too. Games you start from FrameLedger still run with your standard rights.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_ElevationDeclined" xml:space="preserve">
|
||||
<value>Running as a standard user: the administrator prompt was declined.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_ElevationOtherAccount" xml:space="preserve">
|
||||
<value>Running as a standard user: the prompt was answered with another account, and that account's agent does not use your data.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_ElevationFailed" xml:space="preserve">
|
||||
<value>Running as a standard user: Windows could not start the agent as administrator.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_Restarting" xml:space="preserve">
|
||||
<value>Saved. The agent restarts now; with the option on, Windows asks for permission.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_AfterSession" xml:space="preserve">
|
||||
<value>Saved. A session is running, so the agent keeps its current rights until it next starts.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_NotStopped" xml:space="preserve">
|
||||
<value>Saved, but the agent did not stop; it keeps its current rights until it next starts.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_Task_Label" xml:space="preserve">
|
||||
<value>Start the agent at logon</value>
|
||||
</data>
|
||||
@@ -1806,6 +1959,15 @@ Open the log folder?</value>
|
||||
<data name="Trend_Metric_FgFactor" xml:space="preserve">
|
||||
<value>FG factor ×</value>
|
||||
</data>
|
||||
<data name="Trend_Metric_DisplayExclusive" xml:space="preserve">
|
||||
<value>Exclusive fullscreen share %</value>
|
||||
</data>
|
||||
<data name="Trend_Metric_DisplayBorderless" xml:space="preserve">
|
||||
<value>Borderless share %</value>
|
||||
</data>
|
||||
<data name="Trend_Metric_DisplayWindowed" xml:space="preserve">
|
||||
<value>Windowed share %</value>
|
||||
</data>
|
||||
<data name="Sensors_Series_CpuTemp" xml:space="preserve">
|
||||
<value>CPU °C</value>
|
||||
</data>
|
||||
@@ -1830,6 +1992,9 @@ Open the log folder?</value>
|
||||
<data name="Summary_Stat_Cpu" xml:space="preserve">
|
||||
<value>CPU</value>
|
||||
</data>
|
||||
<data name="Summary_Stat_Display" xml:space="preserve">
|
||||
<value>Display</value>
|
||||
</data>
|
||||
<data name="Summary_Stat_LoadTemp_Format" xml:space="preserve">
|
||||
<value>{0} avg · {1} max</value>
|
||||
</data>
|
||||
@@ -1901,6 +2066,9 @@ The documents below are the full terms; this summary does not replace them.</val
|
||||
<data name="GameDetail_AntiCheat_Format" xml:space="preserve">
|
||||
<value>Found: {0}. Hooking is off for this game and cannot be turned on; its sessions record play time and sensors only.</value>
|
||||
</data>
|
||||
<data name="GameDetail_AntiCheat_Exceptionable_Format" xml:space="preserve">
|
||||
<value>Found: {0}. Hooking is off for this game unless you make a user-mode exception for it (below); without one, its sessions record play time and sensors only.</value>
|
||||
</data>
|
||||
<data name="Games_Card_AntiCheat" xml:space="preserve">
|
||||
<value>Anti-cheat</value>
|
||||
</data>
|
||||
@@ -1908,7 +2076,7 @@ The documents below are the full terms; this summary does not replace them.</val
|
||||
<value>Hide hooking on anti-cheat games</value>
|
||||
</data>
|
||||
<data name="Settings_HideAntiCheatHooking_Body" xml:space="preserve">
|
||||
<value>A game in which anti-cheat was found can never be hooked. On, its page shows only what was found; off, it also shows the disabled Hooking switch. Either way it is still recorded without hooking.</value>
|
||||
<value>A game in which anti-cheat was found cannot be hooked, unless you make a user-mode exception for it (below). On, its page shows only what was found; off, it also shows the disabled Hooking switch. Either way it is still recorded without hooking.</value>
|
||||
</data>
|
||||
<data name="Notice_HookingOff_Title_Format" xml:space="preserve">
|
||||
<value>{0}: hooking turned off</value>
|
||||
@@ -1967,6 +2135,21 @@ The documents below are the full terms; this summary does not replace them.</val
|
||||
<data name="GameDetail_Details_Engine" xml:space="preserve">
|
||||
<value>Engine</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_EngineVersion" xml:space="preserve">
|
||||
<value>Engine version</value>
|
||||
</data>
|
||||
<data name="GameDetail_EngineVersion_BranchAndFile" xml:space="preserve">
|
||||
<value>From the engine's build name and the version number in the game's executable.</value>
|
||||
</data>
|
||||
<data name="GameDetail_EngineVersion_Branch" xml:space="preserve">
|
||||
<value>From the engine's build name in the game's executable. The patch number is not recorded there.</value>
|
||||
</data>
|
||||
<data name="GameDetail_EngineVersion_FileVersion" xml:space="preserve">
|
||||
<value>From the executable's version number only. A studio can replace that number with its own, so treat it as likely rather than certain.</value>
|
||||
</data>
|
||||
<data name="GameDetail_EngineVersion_NotFound" xml:space="preserve">
|
||||
<value>Not found in the game's executable. It may be packed or protected, or the studio renamed the engine's build.</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Libraries" xml:space="preserve">
|
||||
<value>Ships with</value>
|
||||
</data>
|
||||
@@ -2285,6 +2468,9 @@ The documents below are the full terms; this summary does not replace them.</val
|
||||
<data name="Launch_Error_740" xml:space="preserve">
|
||||
<value>the game requires administrator rights</value>
|
||||
</data>
|
||||
<data name="Launch_Error_1400" xml:space="preserve">
|
||||
<value>there is no desktop shell to start the game with a standard user's rights (the agent runs as administrator, and never starts a game that way)</value>
|
||||
</data>
|
||||
<data name="Launch_Failed_Format" xml:space="preserve">
|
||||
<value>{0} ({1})</value>
|
||||
</data>
|
||||
@@ -2345,4 +2531,124 @@ The documents below are the full terms; this summary does not replace them.</val
|
||||
<data name="Sensors_Axis_Watts" xml:space="preserve">
|
||||
<value>W</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Label" xml:space="preserve">
|
||||
<value>Allow hooking in games whose only anti-cheat runs in user mode</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Body" xml:space="preserve">
|
||||
<value>Off by default. On, a game whose only anti-cheat runs in user mode — no kernel driver, nothing else found — can be given an exception below, one game at a time, after a disclosure. Its first two hooked sessions are a trial: one that does not go well ends the exception for good. The guard still runs every check, and a ban remains possible.</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Header" xml:space="preserve">
|
||||
<value>User-mode exceptions</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Empty" xml:space="preserve">
|
||||
<value>No game in your library qualifies.</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Suspended" xml:space="preserve">
|
||||
<value>The option is off: the exceptions below are kept but do not apply.</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Grant" xml:space="preserve">
|
||||
<value>Make exception…</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Withdraw" xml:space="preserve">
|
||||
<value>Withdraw</value>
|
||||
</data>
|
||||
<data name="Exception_Finding_Format" xml:space="preserve">
|
||||
<value>{0} — {1}</value>
|
||||
</data>
|
||||
<data name="Exception_State_Granted_Format" xml:space="preserve">
|
||||
<value>Exception in force since {0}</value>
|
||||
</data>
|
||||
<data name="Exception_State_GrantedTrial_Format" xml:space="preserve">
|
||||
<value>Exception in force since {0} — trial: {1} of {2} good sessions so far</value>
|
||||
</data>
|
||||
<data name="Exception_State_Eligible" xml:space="preserve">
|
||||
<value>Eligible — no exception made</value>
|
||||
</data>
|
||||
<data name="Exception_State_Checking" xml:space="preserve">
|
||||
<value>Checking…</value>
|
||||
</data>
|
||||
<data name="Exception_State_Refused_Format" xml:space="preserve">
|
||||
<value>Not eligible: the guard also found {0} ({1})</value>
|
||||
</data>
|
||||
<data name="Exception_State_NotUserMode_Format" xml:space="preserve">
|
||||
<value>Not eligible: {0} is not user-mode throughout (it has a driver or a service), so FrameLedger never excepts it</value>
|
||||
</data>
|
||||
<data name="Exception_State_NotAsked" xml:space="preserve">
|
||||
<value>Not eligible: this finding is not a module, file or folder of one anti-cheat</value>
|
||||
</data>
|
||||
<data name="Exception_State_CouldNotVerify" xml:space="preserve">
|
||||
<value>Not eligible now: the check could not finish; it runs again by itself</value>
|
||||
</data>
|
||||
<data name="Exception_State_TrialFailed_Format" xml:space="preserve">
|
||||
<value>Not eligible: an exception of this game ended during its trial on {0}, so none can be made again</value>
|
||||
</data>
|
||||
<data name="Exception_State_NotFound_Format" xml:space="preserve">
|
||||
<value>Not eligible now: {0} was not found in the game's folder when it was checked; the block stays</value>
|
||||
</data>
|
||||
<data name="Exception_Lapsed_Format" xml:space="preserve">
|
||||
<value>The last exception ended on {0}: {1}</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_Withdrawn" xml:space="preserve">
|
||||
<value>you withdrew it</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_ExecutableChanged" xml:space="preserve">
|
||||
<value>the game was updated</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_NoLongerEligible" xml:space="preserve">
|
||||
<value>the game no longer qualifies</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_NewFinding" xml:space="preserve">
|
||||
<value>new anti-cheat was found in the game</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_SafetyUnhook" xml:space="preserve">
|
||||
<value>a session under it was stopped for safety</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_OverlayStopped" xml:space="preserve">
|
||||
<value>FrameLedger stopped observing because another anti-cheat loaded</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_SessionCrashed" xml:space="preserve">
|
||||
<value>a session under it crashed</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_TrialFailed" xml:space="preserve">
|
||||
<value>a session during its trial did not go well (no frames recorded, or it did not end normally)</value>
|
||||
</data>
|
||||
<data name="Exception_Result_Granted_Format" xml:space="preserve">
|
||||
<value>Exception made for {0}. Turn hooking on for the game on its page when you want to measure it.</value>
|
||||
</data>
|
||||
<data name="Exception_Result_Withdrawn_Format" xml:space="preserve">
|
||||
<value>Exception withdrawn for {0}; its hooking is off.</value>
|
||||
</data>
|
||||
<data name="Exception_Result_Refused_Format" xml:space="preserve">
|
||||
<value>No exception was made for {0}: {1}</value>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Header" xml:space="preserve">
|
||||
<value>User-mode exception</value>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Granted_Format" xml:space="preserve">
|
||||
<value>Hooking may run under a user-mode exception for {0}. The guard still runs every check; a ban remains possible.</value>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Suspended" xml:space="preserve">
|
||||
<value>An exception is kept for this game, but the option is off in Settings, so it does not apply.</value>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Grant" xml:space="preserve">
|
||||
<value>Make exception…</value>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Withdraw" xml:space="preserve">
|
||||
<value>Withdraw exception</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Refresh" xml:space="preserve">
|
||||
<value>Refresh</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Checking" xml:space="preserve">
|
||||
<value>The capture agent is checking your library; the games that qualify appear here within a minute. Refresh to see them.</value>
|
||||
</data>
|
||||
<data name="Tier_HookedException" xml:space="preserve">
|
||||
<value>Hooked · exception</value>
|
||||
</data>
|
||||
<data name="Games_Card_Exception" xml:space="preserve">
|
||||
<value>Exception</value>
|
||||
</data>
|
||||
<data name="Session_UnderException_Format" xml:space="preserve">
|
||||
<value>Hooked under the user-mode exception for {0}</value>
|
||||
</data>
|
||||
</root>
|
||||
@@ -46,6 +46,9 @@
|
||||
<data name="Agent_State_Starting" xml:space="preserve">
|
||||
<value>Đang khởi động agent…</value>
|
||||
</data>
|
||||
<data name="Agent_State_Elevating" xml:space="preserve">
|
||||
<value>Đang chờ quyền quản trị…</value>
|
||||
</data>
|
||||
<data name="App_Title" xml:space="preserve">
|
||||
<value>FrameLedger</value>
|
||||
</data>
|
||||
@@ -106,6 +109,9 @@
|
||||
<data name="Games_Header" xml:space="preserve">
|
||||
<value>Game</value>
|
||||
</data>
|
||||
<data name="Games_Header_Count_Format" xml:space="preserve">
|
||||
<value>Game · {0}</value>
|
||||
</data>
|
||||
<data name="Logs_Empty" xml:space="preserve">
|
||||
<value>Chưa có tệp nhật ký cho nguồn này.</value>
|
||||
</data>
|
||||
@@ -214,6 +220,12 @@
|
||||
<data name="Import_NothingFound" xml:space="preserve">
|
||||
<value>Không tìm thấy game nào đã cài trong Steam, GOG Galaxy, Epic hay itch.io trên máy này.</value>
|
||||
</data>
|
||||
<data name="Import_NothingNew" xml:space="preserve">
|
||||
<value>Không có game mới: mọi game các store đã cài đều đã có trong thư viện.</value>
|
||||
</data>
|
||||
<data name="Import_ShowExisting_Format" xml:space="preserve">
|
||||
<value>Hiện {0} game đã có trong thư viện</value>
|
||||
</data>
|
||||
<data name="Import_Done_Format" xml:space="preserve">
|
||||
<value>Đã thêm {0} game với hooking tắt; {1} giữ nguyên.</value>
|
||||
</data>
|
||||
@@ -229,6 +241,15 @@
|
||||
<data name="Menu_Help_Documentation" xml:space="preserve">
|
||||
<value>Tài liệu</value>
|
||||
</data>
|
||||
<data name="Menu_Help_Limitations" xml:space="preserve">
|
||||
<value>Giới hạn</value>
|
||||
</data>
|
||||
<data name="Limitations_Title" xml:space="preserve">
|
||||
<value>Những điều FrameLedger không làm được</value>
|
||||
</data>
|
||||
<data name="Limitations_OnGitHub" xml:space="preserve">
|
||||
<value>Mở trên GitHub</value>
|
||||
</data>
|
||||
<data name="Menu_Help_ReportBug" xml:space="preserve">
|
||||
<value>Báo lỗi…</value>
|
||||
</data>
|
||||
@@ -508,6 +529,66 @@
|
||||
<data name="Format_Resolution_Single_Format" xml:space="preserve">
|
||||
<value>{0}×{1}</value>
|
||||
</data>
|
||||
<data name="Display_Mode_Exclusive" xml:space="preserve">
|
||||
<value>Toàn màn hình độc quyền</value>
|
||||
</data>
|
||||
<data name="Display_Mode_Borderless" xml:space="preserve">
|
||||
<value>Không viền</value>
|
||||
</data>
|
||||
<data name="Display_Mode_CoversScreen" xml:space="preserve">
|
||||
<value>Toàn màn hình hoặc không viền</value>
|
||||
</data>
|
||||
<data name="Display_Mode_Windowed" xml:space="preserve">
|
||||
<value>Cửa sổ</value>
|
||||
</data>
|
||||
<data name="Display_Mode_Minimized" xml:space="preserve">
|
||||
<value>Thu nhỏ</value>
|
||||
</data>
|
||||
<data name="Display_Mode_NoWindow" xml:space="preserve">
|
||||
<value>Không đọc được cửa sổ</value>
|
||||
</data>
|
||||
<data name="Display_Share_Format" xml:space="preserve">
|
||||
<value>{0} {1}</value>
|
||||
</data>
|
||||
<data name="Display_Size_Format" xml:space="preserve">
|
||||
<value>{0}×{1}</value>
|
||||
</data>
|
||||
<data name="Display_SizeHz_Format" xml:space="preserve">
|
||||
<value>{0}×{1} @ {2} Hz</value>
|
||||
</data>
|
||||
<data name="Display_Changes_One" xml:space="preserve">
|
||||
<value>đổi 1 lần</value>
|
||||
</data>
|
||||
<data name="Display_Changes_Format" xml:space="preserve">
|
||||
<value>đổi {0} lần</value>
|
||||
</data>
|
||||
<data name="Display_Window_Format" xml:space="preserve">
|
||||
<value>cửa sổ {0}×{1}</value>
|
||||
</data>
|
||||
<data name="Display_WindowOnMonitor_Format" xml:space="preserve">
|
||||
<value>cửa sổ {0}×{1} trên màn hình {2}×{3}</value>
|
||||
</data>
|
||||
<data name="Display_WindowOnMonitorHz_Format" xml:space="preserve">
|
||||
<value>cửa sổ {0}×{1} trên màn hình {2}×{3} ở {4} Hz</value>
|
||||
</data>
|
||||
<data name="Display_Buffer_Format" xml:space="preserve">
|
||||
<value>back buffer {0}×{1}</value>
|
||||
</data>
|
||||
<data name="Display_BufferEffect_Format" xml:space="preserve">
|
||||
<value>back buffer {0}×{1} ({2})</value>
|
||||
</data>
|
||||
<data name="Display_Source_SwapChain" xml:space="preserve">
|
||||
<value>swap chain cho biết có độc quyền hay không</value>
|
||||
</data>
|
||||
<data name="Display_Source_OpenGl" xml:space="preserve">
|
||||
<value>OpenGL: không phân biệt được toàn màn hình độc quyền với không viền</value>
|
||||
</data>
|
||||
<data name="Display_Source_Window" xml:space="preserve">
|
||||
<value>chỉ từ cửa sổ: không phân biệt được toàn màn hình độc quyền với không viền</value>
|
||||
</data>
|
||||
<data name="Display_Line_Format" xml:space="preserve">
|
||||
<value>Hiển thị: {0}</value>
|
||||
</data>
|
||||
<data name="Format_Temperature_Format" xml:space="preserve">
|
||||
<value>{0:0} °C</value>
|
||||
</data>
|
||||
@@ -661,9 +742,45 @@
|
||||
<data name="Games_Add" xml:space="preserve">
|
||||
<value>Thêm game…</value>
|
||||
</data>
|
||||
<data name="Games_Refresh" xml:space="preserve">
|
||||
<value>Làm mới</value>
|
||||
</data>
|
||||
<data name="Games_Refresh_ToolTip" xml:space="preserve">
|
||||
<value>Đọc lại thư viện, tìm trong các store những game mới cài, và đánh dấu game không còn file chạy</value>
|
||||
</data>
|
||||
<data name="Games_View_Grid" xml:space="preserve">
|
||||
<value>Hiển thị dạng lưới</value>
|
||||
</data>
|
||||
<data name="Games_View_List" xml:space="preserve">
|
||||
<value>Hiển thị dạng danh sách</value>
|
||||
</data>
|
||||
<data name="Games_List_Name" xml:space="preserve">
|
||||
<value>Tên</value>
|
||||
</data>
|
||||
<data name="Games_List_Store" xml:space="preserve">
|
||||
<value>Store</value>
|
||||
</data>
|
||||
<data name="Games_List_Engine" xml:space="preserve">
|
||||
<value>Engine</value>
|
||||
</data>
|
||||
<data name="Games_List_Status" xml:space="preserve">
|
||||
<value>Trạng thái</value>
|
||||
</data>
|
||||
<data name="Games_List_Sessions" xml:space="preserve">
|
||||
<value>Phiên</value>
|
||||
</data>
|
||||
<data name="Games_List_Played" xml:space="preserve">
|
||||
<value>Đã chơi</value>
|
||||
</data>
|
||||
<data name="Games_List_LastPlayed" xml:space="preserve">
|
||||
<value>Chơi lần cuối</value>
|
||||
</data>
|
||||
<data name="Games_Card_NotRecorded" xml:space="preserve">
|
||||
<value>Không ghi</value>
|
||||
</data>
|
||||
<data name="Games_Card_NotInstalled" xml:space="preserve">
|
||||
<value>Chưa cài</value>
|
||||
</data>
|
||||
<data name="Games_Card_HookOff" xml:space="preserve">
|
||||
<value>Hooking tắt</value>
|
||||
</data>
|
||||
@@ -718,6 +835,9 @@
|
||||
<data name="Sessions_Col_Api" xml:space="preserve">
|
||||
<value>API</value>
|
||||
</data>
|
||||
<data name="Sessions_Col_Display" xml:space="preserve">
|
||||
<value>Hiển thị</value>
|
||||
</data>
|
||||
<data name="Sessions_Col_Date" xml:space="preserve">
|
||||
<value>Ngày</value>
|
||||
</data>
|
||||
@@ -997,6 +1117,15 @@
|
||||
<data name="Compare_Metric_Duration" xml:space="preserve">
|
||||
<value>Thời lượng</value>
|
||||
</data>
|
||||
<data name="Compare_Metric_Display" xml:space="preserve">
|
||||
<value>Chế độ hiển thị</value>
|
||||
</data>
|
||||
<data name="Compare_Metric_Window" xml:space="preserve">
|
||||
<value>Cửa sổ</value>
|
||||
</data>
|
||||
<data name="Compare_Metric_Monitor" xml:space="preserve">
|
||||
<value>Màn hình</value>
|
||||
</data>
|
||||
<data name="Compare_Metric_MaxGpuTemp" xml:space="preserve">
|
||||
<value>GPU tối đa °C</value>
|
||||
</data>
|
||||
@@ -1237,6 +1366,30 @@
|
||||
<data name="Settings_Agent_NotElevated" xml:space="preserve">
|
||||
<value>Đang chạy với quyền người dùng thường.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_Label" xml:space="preserve">
|
||||
<value>Chạy agent với quyền quản trị</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_Body" xml:space="preserve">
|
||||
<value>Mặc định tắt. Khi bật, Windows sẽ hỏi mỗi lần agent khởi động, kể cả lúc đăng nhập. Game bạn khởi động từ FrameLedger vẫn chạy với quyền người dùng thường.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_ElevationDeclined" xml:space="preserve">
|
||||
<value>Đang chạy với quyền người dùng thường: hộp thoại quyền quản trị đã bị từ chối.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_ElevationOtherAccount" xml:space="preserve">
|
||||
<value>Đang chạy với quyền người dùng thường: hộp thoại được trả lời bằng một tài khoản khác, và agent của tài khoản đó không dùng dữ liệu của bạn.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_ElevationFailed" xml:space="preserve">
|
||||
<value>Đang chạy với quyền người dùng thường: Windows không thể khởi động agent với quyền quản trị.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_Restarting" xml:space="preserve">
|
||||
<value>Đã lưu. Agent đang khởi động lại; khi tuỳ chọn bật, Windows sẽ hỏi quyền.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_AfterSession" xml:space="preserve">
|
||||
<value>Đã lưu. Một phiên đang chạy, nên agent giữ quyền hiện tại cho đến lần khởi động sau.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_RunElevated_NotStopped" xml:space="preserve">
|
||||
<value>Đã lưu, nhưng agent không dừng; nó giữ quyền hiện tại cho đến lần khởi động sau.</value>
|
||||
</data>
|
||||
<data name="Settings_Agent_Task_Label" xml:space="preserve">
|
||||
<value>Khởi động agent khi đăng nhập</value>
|
||||
</data>
|
||||
@@ -1801,6 +1954,15 @@ Mở thư mục log?</value>
|
||||
<data name="Trend_Metric_FgFactor" xml:space="preserve">
|
||||
<value>Hệ số FG ×</value>
|
||||
</data>
|
||||
<data name="Trend_Metric_DisplayExclusive" xml:space="preserve">
|
||||
<value>Tỉ lệ toàn màn hình độc quyền %</value>
|
||||
</data>
|
||||
<data name="Trend_Metric_DisplayBorderless" xml:space="preserve">
|
||||
<value>Tỉ lệ không viền %</value>
|
||||
</data>
|
||||
<data name="Trend_Metric_DisplayWindowed" xml:space="preserve">
|
||||
<value>Tỉ lệ cửa sổ %</value>
|
||||
</data>
|
||||
<data name="Sensors_Series_CpuTemp" xml:space="preserve">
|
||||
<value>CPU °C</value>
|
||||
</data>
|
||||
@@ -1825,6 +1987,9 @@ Mở thư mục log?</value>
|
||||
<data name="Summary_Stat_Cpu" xml:space="preserve">
|
||||
<value>CPU</value>
|
||||
</data>
|
||||
<data name="Summary_Stat_Display" xml:space="preserve">
|
||||
<value>Hiển thị</value>
|
||||
</data>
|
||||
<data name="Summary_Stat_LoadTemp_Format" xml:space="preserve">
|
||||
<value>TB {0} · tối đa {1}</value>
|
||||
</data>
|
||||
@@ -1896,6 +2061,9 @@ Các tài liệu bên dưới là điều khoản đầy đủ; phần tóm tắ
|
||||
<data name="GameDetail_AntiCheat_Format" xml:space="preserve">
|
||||
<value>Đã phát hiện: {0}. Hooking đã tắt cho game này và không thể bật; các phiên của nó chỉ ghi thời gian chơi và cảm biến.</value>
|
||||
</data>
|
||||
<data name="GameDetail_AntiCheat_Exceptionable_Format" xml:space="preserve">
|
||||
<value>Đã phát hiện: {0}. Hooking đã tắt cho game này trừ khi bạn tạo ngoại lệ user-mode cho nó (bên dưới); nếu không, các phiên của nó chỉ ghi thời gian chơi và cảm biến.</value>
|
||||
</data>
|
||||
<data name="Games_Card_AntiCheat" xml:space="preserve">
|
||||
<value>Anti-cheat</value>
|
||||
</data>
|
||||
@@ -1903,7 +2071,7 @@ Các tài liệu bên dưới là điều khoản đầy đủ; phần tóm tắ
|
||||
<value>Ẩn phần hooking ở game có anti-cheat</value>
|
||||
</data>
|
||||
<data name="Settings_HideAntiCheatHooking_Body" xml:space="preserve">
|
||||
<value>Game được phát hiện có anti-cheat sẽ không bao giờ được hook. Bật: trang game chỉ hiện điều đã phát hiện; tắt: hiện thêm công tắc Hooking bị vô hiệu hoá. Dù bật hay tắt, game vẫn được ghi mà không hook.</value>
|
||||
<value>Game được phát hiện có anti-cheat sẽ không được hook, trừ khi bạn tạo ngoại lệ user-mode cho nó (bên dưới). Bật: trang game chỉ hiện điều đã phát hiện; tắt: hiện thêm công tắc Hooking bị vô hiệu hoá. Dù bật hay tắt, game vẫn được ghi mà không hook.</value>
|
||||
</data>
|
||||
<data name="Notice_HookingOff_Title_Format" xml:space="preserve">
|
||||
<value>{0}: đã tắt hooking</value>
|
||||
@@ -1962,6 +2130,21 @@ Các tài liệu bên dưới là điều khoản đầy đủ; phần tóm tắ
|
||||
<data name="GameDetail_Details_Engine" xml:space="preserve">
|
||||
<value>Engine</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_EngineVersion" xml:space="preserve">
|
||||
<value>Phiên bản engine</value>
|
||||
</data>
|
||||
<data name="GameDetail_EngineVersion_BranchAndFile" xml:space="preserve">
|
||||
<value>Lấy từ tên bản dựng của engine và số phiên bản trong file thực thi của game.</value>
|
||||
</data>
|
||||
<data name="GameDetail_EngineVersion_Branch" xml:space="preserve">
|
||||
<value>Lấy từ tên bản dựng của engine trong file thực thi của game. Số bản vá không được ghi ở đó.</value>
|
||||
</data>
|
||||
<data name="GameDetail_EngineVersion_FileVersion" xml:space="preserve">
|
||||
<value>Chỉ lấy từ số phiên bản của file thực thi. Studio có thể thay số đó bằng số của riêng họ, nên đây là khả năng cao chứ không chắc chắn.</value>
|
||||
</data>
|
||||
<data name="GameDetail_EngineVersion_NotFound" xml:space="preserve">
|
||||
<value>Không tìm thấy trong file thực thi của game. File có thể đã bị nén hoặc bảo vệ, hoặc studio đã đổi tên bản dựng của engine.</value>
|
||||
</data>
|
||||
<data name="GameDetail_Details_Libraries" xml:space="preserve">
|
||||
<value>Đi kèm</value>
|
||||
</data>
|
||||
@@ -2280,6 +2463,9 @@ Các tài liệu bên dưới là điều khoản đầy đủ; phần tóm tắ
|
||||
<data name="Launch_Error_740" xml:space="preserve">
|
||||
<value>game yêu cầu quyền quản trị</value>
|
||||
</data>
|
||||
<data name="Launch_Error_1400" xml:space="preserve">
|
||||
<value>không có desktop shell để khởi động game với quyền người dùng thường (agent đang chạy với quyền quản trị, và không bao giờ khởi động game theo cách đó)</value>
|
||||
</data>
|
||||
<data name="Launch_Failed_Format" xml:space="preserve">
|
||||
<value>{0} ({1})</value>
|
||||
</data>
|
||||
@@ -2340,4 +2526,124 @@ Các tài liệu bên dưới là điều khoản đầy đủ; phần tóm tắ
|
||||
<data name="Sensors_Axis_Watts" xml:space="preserve">
|
||||
<value>W</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Label" xml:space="preserve">
|
||||
<value>Cho phép hooking ở game chỉ có anti-cheat chạy ở user mode</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Body" xml:space="preserve">
|
||||
<value>Mặc định tắt. Khi bật, game có anti-cheat duy nhất chạy ở user mode — không có kernel driver, không phát hiện gì khác — có thể được cấp ngoại lệ bên dưới, từng game một, sau một bản công bố rủi ro. Hai phiên hook đầu tiên là phiên thử: một phiên không ổn sẽ kết thúc ngoại lệ vĩnh viễn. Bộ bảo vệ vẫn chạy mọi bước kiểm tra, và vẫn có thể bị khoá tài khoản.</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Header" xml:space="preserve">
|
||||
<value>Ngoại lệ user-mode</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Empty" xml:space="preserve">
|
||||
<value>Không có game nào trong thư viện đủ điều kiện.</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Suspended" xml:space="preserve">
|
||||
<value>Tuỳ chọn đang tắt: các ngoại lệ bên dưới được giữ lại nhưng không có hiệu lực.</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Grant" xml:space="preserve">
|
||||
<value>Tạo ngoại lệ…</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Withdraw" xml:space="preserve">
|
||||
<value>Rút lại</value>
|
||||
</data>
|
||||
<data name="Exception_Finding_Format" xml:space="preserve">
|
||||
<value>{0} — {1}</value>
|
||||
</data>
|
||||
<data name="Exception_State_Granted_Format" xml:space="preserve">
|
||||
<value>Ngoại lệ có hiệu lực từ {0}</value>
|
||||
</data>
|
||||
<data name="Exception_State_GrantedTrial_Format" xml:space="preserve">
|
||||
<value>Ngoại lệ có hiệu lực từ {0} — đang thử: đã có {1}/{2} phiên tốt</value>
|
||||
</data>
|
||||
<data name="Exception_State_Eligible" xml:space="preserve">
|
||||
<value>Đủ điều kiện — chưa tạo ngoại lệ</value>
|
||||
</data>
|
||||
<data name="Exception_State_Checking" xml:space="preserve">
|
||||
<value>Đang kiểm tra…</value>
|
||||
</data>
|
||||
<data name="Exception_State_Refused_Format" xml:space="preserve">
|
||||
<value>Không đủ điều kiện: bộ bảo vệ còn phát hiện {0} ({1})</value>
|
||||
</data>
|
||||
<data name="Exception_State_NotUserMode_Format" xml:space="preserve">
|
||||
<value>Không đủ điều kiện: {0} không chạy hoàn toàn ở user mode (có driver hoặc service), nên FrameLedger không bao giờ cấp ngoại lệ</value>
|
||||
</data>
|
||||
<data name="Exception_State_NotAsked" xml:space="preserve">
|
||||
<value>Không đủ điều kiện: phát hiện này không phải module, tệp hay thư mục của một anti-cheat</value>
|
||||
</data>
|
||||
<data name="Exception_State_CouldNotVerify" xml:space="preserve">
|
||||
<value>Hiện chưa đủ điều kiện: lần kiểm tra không hoàn tất; nó sẽ tự chạy lại</value>
|
||||
</data>
|
||||
<data name="Exception_State_TrialFailed_Format" xml:space="preserve">
|
||||
<value>Không đủ điều kiện: một ngoại lệ của game này đã kết thúc trong thời gian thử vào {0}, nên không thể tạo lại</value>
|
||||
</data>
|
||||
<data name="Exception_State_NotFound_Format" xml:space="preserve">
|
||||
<value>Hiện không đủ điều kiện: lúc kiểm tra không thấy {0} trong thư mục game; lệnh chặn vẫn giữ nguyên</value>
|
||||
</data>
|
||||
<data name="Exception_Lapsed_Format" xml:space="preserve">
|
||||
<value>Ngoại lệ gần nhất đã kết thúc ngày {0}: {1}</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_Withdrawn" xml:space="preserve">
|
||||
<value>bạn đã rút lại</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_ExecutableChanged" xml:space="preserve">
|
||||
<value>game đã được cập nhật</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_NoLongerEligible" xml:space="preserve">
|
||||
<value>game không còn đủ điều kiện</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_NewFinding" xml:space="preserve">
|
||||
<value>phát hiện anti-cheat mới trong game</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_SafetyUnhook" xml:space="preserve">
|
||||
<value>một phiên dưới ngoại lệ bị dừng vì an toàn</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_OverlayStopped" xml:space="preserve">
|
||||
<value>FrameLedger ngừng quan sát vì một anti-cheat khác được nạp</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_SessionCrashed" xml:space="preserve">
|
||||
<value>một phiên dưới ngoại lệ bị crash</value>
|
||||
</data>
|
||||
<data name="Exception_Lapse_TrialFailed" xml:space="preserve">
|
||||
<value>một phiên trong thời gian thử không ổn (không ghi được frame nào, hoặc không kết thúc bình thường)</value>
|
||||
</data>
|
||||
<data name="Exception_Result_Granted_Format" xml:space="preserve">
|
||||
<value>Đã tạo ngoại lệ cho {0}. Khi muốn đo, hãy bật hooking cho game trên trang của nó.</value>
|
||||
</data>
|
||||
<data name="Exception_Result_Withdrawn_Format" xml:space="preserve">
|
||||
<value>Đã rút ngoại lệ cho {0}; hooking của nó đã tắt.</value>
|
||||
</data>
|
||||
<data name="Exception_Result_Refused_Format" xml:space="preserve">
|
||||
<value>Không tạo ngoại lệ cho {0}: {1}</value>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Header" xml:space="preserve">
|
||||
<value>Ngoại lệ user-mode</value>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Granted_Format" xml:space="preserve">
|
||||
<value>Hooking có thể chạy dưới ngoại lệ user-mode cho {0}. Bộ bảo vệ vẫn chạy mọi bước kiểm tra; vẫn có thể bị khoá tài khoản.</value>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Suspended" xml:space="preserve">
|
||||
<value>Game này có ngoại lệ được giữ lại, nhưng tuỳ chọn đang tắt trong Cài đặt nên nó không có hiệu lực.</value>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Grant" xml:space="preserve">
|
||||
<value>Tạo ngoại lệ…</value>
|
||||
</data>
|
||||
<data name="GameDetail_Exception_Withdraw" xml:space="preserve">
|
||||
<value>Rút ngoại lệ</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Refresh" xml:space="preserve">
|
||||
<value>Làm mới</value>
|
||||
</data>
|
||||
<data name="Settings_Exceptions_Checking" xml:space="preserve">
|
||||
<value>Capture agent đang kiểm tra thư viện; các game đủ điều kiện sẽ hiện ở đây trong vòng một phút. Bấm Làm mới để xem.</value>
|
||||
</data>
|
||||
<data name="Tier_HookedException" xml:space="preserve">
|
||||
<value>Hook · ngoại lệ</value>
|
||||
</data>
|
||||
<data name="Games_Card_Exception" xml:space="preserve">
|
||||
<value>Ngoại lệ</value>
|
||||
</data>
|
||||
<data name="Session_UnderException_Format" xml:space="preserve">
|
||||
<value>Được hook dưới ngoại lệ user-mode cho {0}</value>
|
||||
</data>
|
||||
</root>
|
||||
@@ -22,6 +22,7 @@ public sealed partial class UpdateService : ObservableObject, IDisposable
|
||||
private static readonly TimeSpan _defaultAgentStopTimeout = TimeSpan.FromSeconds(10);
|
||||
|
||||
private readonly TimeSpan _agentStopTimeout;
|
||||
private readonly Func<bool> _agentHeld;
|
||||
private readonly IUpdateClient _client;
|
||||
private readonly IAgentLink _agent;
|
||||
private readonly RegisteredSettings _settings;
|
||||
@@ -42,12 +43,15 @@ public sealed partial class UpdateService : ObservableObject, IDisposable
|
||||
private int _percent;
|
||||
|
||||
/// <summary>
|
||||
/// The flow over its ports; subscribes to the Agent link for the session facts FR-12 needs. The last parameter is
|
||||
/// how long the apply waits for the pipe to drop after <c>Shutdown</c> (10 s), overridable as a test's clock.
|
||||
/// The flow over its ports; subscribes to the Agent link for the session facts FR-12 needs. <paramref name="agentStopTimeout"/>
|
||||
/// is how long the apply waits for the Agent to stop after <c>Shutdown</c> (10 s), overridable as a test's clock;
|
||||
/// <paramref name="agentHeld"/> is whether an Agent process still holds the data folder (the instance lock), a test's own.
|
||||
/// </summary>
|
||||
public UpdateService(IUpdateClient client, IAgentLink agent, RegisteredSettings settings, IUpdatePrompts prompts, IShellPresence shell, IMessageStrip strip, TimeSpan? agentStopTimeout = null)
|
||||
public UpdateService(IUpdateClient client, IAgentLink agent, RegisteredSettings settings, IUpdatePrompts prompts, IShellPresence shell, IMessageStrip strip,
|
||||
TimeSpan? agentStopTimeout = null, Func<bool>? agentHeld = null)
|
||||
{
|
||||
_agentStopTimeout = agentStopTimeout ?? _defaultAgentStopTimeout;
|
||||
_agentHeld = agentHeld ?? (static () => Infrastructure.Startup.AgentInstanceLock.IsHeld(Services.UiPaths.DataDirectory));
|
||||
_client = client ?? throw new ArgumentNullException(nameof(client));
|
||||
_agent = agent ?? throw new ArgumentNullException(nameof(agent));
|
||||
_settings = settings ?? throw new ArgumentNullException(nameof(settings));
|
||||
@@ -268,11 +272,17 @@ public sealed partial class UpdateService : ObservableObject, IDisposable
|
||||
Stage = IsSessionActive ? UpdateStage.Deferred : UpdateStage.Ready;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// The Agent stopped, or none was running: the pipe has dropped AND no process holds the data folder any more. Since
|
||||
/// beta.10 the second half matters — an Agent run as administrator (the admin mode) holds the install directory's files
|
||||
/// exactly as long as its process lives, and one that holds the folder without answering this App (still starting,
|
||||
/// another version) must not have the files replaced under it.
|
||||
/// </summary>
|
||||
private async Task<bool> StopAgentAsync(CancellationToken ct)
|
||||
{
|
||||
if (!_agent.IsConnected)
|
||||
{
|
||||
return true;
|
||||
return !_agentHeld();
|
||||
}
|
||||
|
||||
try
|
||||
@@ -285,7 +295,7 @@ public sealed partial class UpdateService : ObservableObject, IDisposable
|
||||
}
|
||||
|
||||
DateTimeOffset deadline = DateTimeOffset.UtcNow + _agentStopTimeout;
|
||||
while (_agent.IsConnected)
|
||||
while (_agent.IsConnected || _agentHeld())
|
||||
{
|
||||
if (DateTimeOffset.UtcNow >= deadline)
|
||||
{
|
||||
|
||||
@@ -0,0 +1,37 @@
|
||||
using CommunityToolkit.Mvvm.ComponentModel;
|
||||
using FrameLedger.Shared.Safety;
|
||||
using SafetyStrings = FrameLedger.Shared.Strings;
|
||||
|
||||
namespace FrameLedger.App.ViewModels;
|
||||
|
||||
/// <summary>
|
||||
/// The admin mode's disclosure (beta.10, owner decision D34; <c>19_SAFETY</c> §Elevated targets): what running the Agent as
|
||||
/// administrator adds, what it does not change, how Windows asks, and the risk of a per-user install. <see cref="Accepted"/>
|
||||
/// — the user ticking that they understand — is the one thing that enables the dialog's primary button.
|
||||
/// </summary>
|
||||
public sealed partial class AgentAdminDialogViewModel : ObservableObject
|
||||
{
|
||||
[ObservableProperty]
|
||||
private bool _accepted;
|
||||
|
||||
public static string Title => SafetyStrings.Safety_AdminMode_Title;
|
||||
|
||||
public static string Intro => SafetyStrings.Safety_AdminMode_Intro;
|
||||
|
||||
public static string Adds => SafetyStrings.Safety_AdminMode_Adds;
|
||||
|
||||
public static string Unchanged => SafetyStrings.Safety_AdminMode_Unchanged;
|
||||
|
||||
public static string Prompt => SafetyStrings.Safety_AdminMode_Prompt;
|
||||
|
||||
public static string Risk => SafetyStrings.Safety_AdminMode_Risk;
|
||||
|
||||
public static string AcceptText => SafetyStrings.Safety_AdminMode_Accept;
|
||||
|
||||
public static string TurnOnText => SafetyStrings.Safety_AdminMode_TurnOn;
|
||||
|
||||
public static string CancelText => SafetyStrings.Safety_AdminMode_Cancel;
|
||||
|
||||
/// <summary>The version of the text shown, in the dialog's corner, as FR-2.1's dialog shows its own.</summary>
|
||||
public static string Version => AgentAdminDisclosure.Version;
|
||||
}
|
||||
@@ -0,0 +1,56 @@
|
||||
using System.Globalization;
|
||||
using CommunityToolkit.Mvvm.ComponentModel;
|
||||
using FrameLedger.App.Services;
|
||||
using SafetyStrings = FrameLedger.Shared.Strings;
|
||||
|
||||
namespace FrameLedger.App.ViewModels;
|
||||
|
||||
/// <summary>
|
||||
/// D33's disclosure content (<c>19_SAFETY</c> §The user-mode exception): why the exception is offered, its trial (D38), the
|
||||
/// risk at the same grain as FR-2.1's dialog, what is still refused, how it ends, and that it turns nothing on. <see cref="Accepted"/> — the
|
||||
/// user ticking "I accept the risk of a ban for this game" — is the one thing that enables the dialog's primary button.
|
||||
/// </summary>
|
||||
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime; a cached CompositeFormat would pin the first culture")]
|
||||
public sealed partial class AntiCheatExceptionDialogViewModel : ObservableObject
|
||||
{
|
||||
[ObservableProperty]
|
||||
private bool _accepted;
|
||||
|
||||
public AntiCheatExceptionDialogViewModel(AntiCheatExceptionFacts facts)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(facts);
|
||||
Facts = facts;
|
||||
Title = string.Format(CultureInfo.CurrentCulture, SafetyStrings.Safety_Exception_Title_Format, facts.GameName);
|
||||
Intro = string.Format(CultureInfo.CurrentCulture, SafetyStrings.Safety_Exception_Intro_Format, facts.Family, facts.Signal);
|
||||
Why = string.Format(CultureInfo.CurrentCulture, SafetyStrings.Safety_Exception_Why_Format, facts.Family);
|
||||
Risk = string.Format(CultureInfo.CurrentCulture, SafetyStrings.Safety_Exception_Risk_Format, facts.Family);
|
||||
Still = string.Format(CultureInfo.CurrentCulture, SafetyStrings.Safety_Exception_Still_Format, facts.Family);
|
||||
}
|
||||
|
||||
public AntiCheatExceptionFacts Facts { get; }
|
||||
|
||||
public string Title { get; }
|
||||
|
||||
public string Intro { get; }
|
||||
|
||||
public string Why { get; }
|
||||
|
||||
public string Risk { get; }
|
||||
|
||||
public string Still { get; }
|
||||
|
||||
/// <summary>D38: the grant's first two sessions are a trial, and one that does not go well ends it for good.</summary>
|
||||
public static string Trial => SafetyStrings.Safety_Exception_Trial;
|
||||
|
||||
public static string Ends => SafetyStrings.Safety_Exception_Ends;
|
||||
|
||||
public static string Next => SafetyStrings.Safety_Exception_Next;
|
||||
|
||||
public static string Online => SafetyStrings.Safety_Exception_Online;
|
||||
|
||||
public static string AcceptText => SafetyStrings.Safety_Exception_Accept;
|
||||
|
||||
public static string GrantText => SafetyStrings.Safety_Exception_Grant;
|
||||
|
||||
public static string CancelText => SafetyStrings.Safety_Exception_Cancel;
|
||||
}
|
||||
@@ -193,6 +193,11 @@ public sealed partial class CompareViewModel : ObservableObject
|
||||
Rows.Add(Row(Strings.Compare_Metric_AvgCpuLoad, rows, static r => r.AvgCpuLoad, Formats.Percent, higherIsBetter: null));
|
||||
Rows.Add(Row(Strings.Compare_Metric_MaxCpuTemp, rows, static r => r.MaxCpuTemp, Formats.Temperature, higherIsBetter: false));
|
||||
Rows.Add(new CompareRowViewModel(Strings.Compare_Metric_Duration, [.. rows.Select(static r => new CompareCell(Formats.Duration(r.DurationSeconds), false))]));
|
||||
|
||||
// beta.10: how each session was shown, both tiers. Facts, not scores: no mode is better than another, so none is best.
|
||||
Rows.Add(new CompareRowViewModel(Strings.Compare_Metric_Display, [.. rows.Select(static r => new CompareCell(DisplayText.Shares(DisplayText.Of(r)), false))]));
|
||||
Rows.Add(new CompareRowViewModel(Strings.Compare_Metric_Window, [.. rows.Select(static r => new CompareCell(DisplayText.Window(DisplayText.Of(r)), false))]));
|
||||
Rows.Add(new CompareRowViewModel(Strings.Compare_Metric_Monitor, [.. rows.Select(static r => new CompareCell(DisplayText.Monitor(DisplayText.Of(r)), false))]));
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
|
||||
@@ -0,0 +1,50 @@
|
||||
using System.Globalization;
|
||||
using CommunityToolkit.Mvvm.Input;
|
||||
using FrameLedger.App.Services;
|
||||
|
||||
namespace FrameLedger.App.ViewModels;
|
||||
|
||||
/// <summary>
|
||||
/// One row of Settings ▸ Capture's user-mode exception list (D33): the game, what was found, the state — which carries a
|
||||
/// grant's trial since D38, so no separate count line repeats it — and the one action the state allows, making the
|
||||
/// exception (through its disclosure) or withdrawing it.
|
||||
/// </summary>
|
||||
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
|
||||
public sealed partial class ExceptionGameViewModel
|
||||
{
|
||||
private readonly Func<ExceptionGameViewModel, Task> _grant;
|
||||
private readonly Func<ExceptionGameViewModel, Task> _withdraw;
|
||||
|
||||
public ExceptionGameViewModel(long gameId, string name, ExceptionView view, Func<ExceptionGameViewModel, Task> grant, Func<ExceptionGameViewModel, Task> withdraw)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(view);
|
||||
GameId = gameId;
|
||||
Name = name ?? throw new ArgumentNullException(nameof(name));
|
||||
View = view;
|
||||
_grant = grant ?? throw new ArgumentNullException(nameof(grant));
|
||||
_withdraw = withdraw ?? throw new ArgumentNullException(nameof(withdraw));
|
||||
FindingText = string.Format(CultureInfo.CurrentCulture, Strings.Exception_Finding_Format, view.Family ?? Strings.Common_NotAvailable, view.Signal ?? Strings.Common_NotAvailable);
|
||||
}
|
||||
|
||||
public long GameId { get; }
|
||||
|
||||
public string Name { get; }
|
||||
|
||||
public ExceptionView View { get; }
|
||||
|
||||
public string FindingText { get; }
|
||||
|
||||
public string StateText => View.Text;
|
||||
|
||||
public string? LapseText => View.LapseText;
|
||||
|
||||
public bool CanGrant => View.CanGrant;
|
||||
|
||||
public bool CanWithdraw => View.CanWithdraw;
|
||||
|
||||
[RelayCommand]
|
||||
private Task GrantAsync() => _grant(this);
|
||||
|
||||
[RelayCommand]
|
||||
private Task WithdrawAsync() => _withdraw(this);
|
||||
}
|
||||
@@ -5,17 +5,21 @@ using FrameLedger.App.Services;
|
||||
namespace FrameLedger.App.ViewModels;
|
||||
|
||||
/// <summary>
|
||||
/// One library card (<c>08_UI</c> §Games): name, platform and engine badges, playtime, last played, hooking state — or, since
|
||||
/// 2026-09-23, "Not recorded" in its place for an entry whose recording is off, and since 2026-09-25 "Anti-cheat" for one
|
||||
/// the guard found anti-cheat in. The sparkline is PR-6's.
|
||||
/// One library entry (<c>08_UI</c> §Games), as a card in the grid or a row in the list: name, platform and engine badges,
|
||||
/// playtime, last played, hooking state — or, since 2026-09-23, "Not recorded" in its place for an entry whose recording is
|
||||
/// off, and since 2026-09-25 "Anti-cheat" for one the guard found anti-cheat in; since beta.11 "Not installed" beside it
|
||||
/// when its executable is not on disk (<see cref="GameLibrary.ExecutableExists"/>, read when the library is listed, never
|
||||
/// stored), with the game page's own words for why (<see cref="Formats.ExecutableMissingText"/>).
|
||||
/// </summary>
|
||||
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
|
||||
public sealed class GameCardViewModel
|
||||
{
|
||||
public GameCardViewModel(GameCard card)
|
||||
public GameCardViewModel(GameCard card, bool installed = true)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(card);
|
||||
Card = card;
|
||||
NotInstalled = !installed;
|
||||
NotInstalledToolTip = installed ? null : Formats.ExecutableMissingText(card.Row.Fingerprint.ExePath);
|
||||
Id = card.Row.Id;
|
||||
Name = card.Row.Name;
|
||||
PlatformText = Formats.Platform(card.Row.Platform);
|
||||
@@ -25,14 +29,20 @@ public sealed class GameCardViewModel
|
||||
// An entry the guard found anti-cheat in says so (beta.8): its hooking is off for good, and "Hooking off" read as
|
||||
// a switch the user could still flip. Not recorded still comes first — nothing runs for it at all.
|
||||
AntiCheat = Recorded && card.Row.BlockedByGuard;
|
||||
// D33: a blocked game with a user-mode exception on its row says so; whether Settings' option lets it apply is the
|
||||
// game page's to say.
|
||||
Excepted = AntiCheat && card.Row.AcException.IsGranted;
|
||||
HookText = !Recorded ? Strings.Games_Card_NotRecorded
|
||||
: Excepted ? Strings.Games_Card_Exception
|
||||
: AntiCheat ? Strings.Games_Card_AntiCheat
|
||||
: HookOn ? Strings.Games_Card_HookOn : Strings.Games_Card_HookOff;
|
||||
SessionCount = card.Summary?.SessionCount ?? 0;
|
||||
TotalSeconds = card.Summary?.TotalSeconds ?? 0;
|
||||
LastPlayedAt = card.Summary?.LastPlayedAt;
|
||||
SessionsText = string.Format(CultureInfo.CurrentCulture, Strings.Games_Card_Sessions_Format, SessionCount);
|
||||
PlaytimeText = string.Format(CultureInfo.CurrentCulture, Strings.Games_Card_Playtime_Format, Formats.Playtime(TotalSeconds));
|
||||
PlaytimeValue = Formats.Playtime(TotalSeconds);
|
||||
PlaytimeText = string.Format(CultureInfo.CurrentCulture, Strings.Games_Card_Playtime_Format, PlaytimeValue);
|
||||
LastPlayedValue = LastPlayedAt is DateTimeOffset when ? Formats.Date(when) : Strings.Games_Card_NeverPlayed;
|
||||
LastPlayedText = LastPlayedAt is DateTimeOffset at
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.Games_Card_LastPlayed_Format, Formats.Date(at))
|
||||
: Strings.Games_Card_NeverPlayed;
|
||||
@@ -63,6 +73,9 @@ public sealed class GameCardViewModel
|
||||
/// </summary>
|
||||
public bool AntiCheat { get; }
|
||||
|
||||
/// <summary>D33: the anti-cheat game carries a user-mode exception (<c>games.ac_exception_at</c>); the pill says "Exception".</summary>
|
||||
public bool Excepted { get; }
|
||||
|
||||
public string HookText { get; }
|
||||
|
||||
public long SessionCount { get; }
|
||||
@@ -76,4 +89,19 @@ public sealed class GameCardViewModel
|
||||
public string PlaytimeText { get; }
|
||||
|
||||
public string LastPlayedText { get; }
|
||||
|
||||
/// <summary>The list view's playtime cell: the duration alone.</summary>
|
||||
public string PlaytimeValue { get; }
|
||||
|
||||
/// <summary>The list view's last-played cell: the date alone, or "not played yet".</summary>
|
||||
public string LastPlayedValue { get; }
|
||||
|
||||
/// <summary>beta.11: the "Not installed" pill shows — the file, or the drive it was on, is not there now.</summary>
|
||||
public bool NotInstalled { get; }
|
||||
|
||||
/// <summary>What the pill means here — the drive that is not connected, or the path the file is gone from; null when installed.</summary>
|
||||
public string? NotInstalledToolTip { get; }
|
||||
|
||||
/// <summary>The list view's status cell: what the hook pill says, and "Not installed" after it when that is so.</summary>
|
||||
public string StatusText => NotInstalled ? HookText + " · " + Strings.Games_Card_NotInstalled : HookText;
|
||||
}
|
||||
@@ -42,10 +42,14 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
private readonly IHardwareSnapshotRepository _hardware;
|
||||
private readonly SessionSelection _selection;
|
||||
private readonly RegisteredSettings? _settings;
|
||||
private readonly AntiCheatExceptions? _exceptions;
|
||||
private readonly long? _gameId;
|
||||
|
||||
// ui.hide_anticheat_hooking (2026-09-25), read at each load; on until the settings say otherwise, as its default is.
|
||||
private bool _hideAntiCheatHooking = true;
|
||||
|
||||
// hooking.usermode_ac_exceptions (D33, 2026-09-26), read at each load; off until the settings say otherwise.
|
||||
private bool _exceptionsOn;
|
||||
private GameDetail? _detail;
|
||||
|
||||
[ObservableProperty]
|
||||
@@ -107,6 +111,32 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
[ObservableProperty]
|
||||
private bool _hookingSectionVisible = true;
|
||||
|
||||
/// <summary>
|
||||
/// D33: the user-mode exception's card on a blocked game — shown while the option is on, and for an exception kept while
|
||||
/// it is off; its state is the Agent's (<see cref="ExceptionView"/>).
|
||||
/// </summary>
|
||||
[ObservableProperty]
|
||||
private bool _exceptionCardVisible;
|
||||
|
||||
[ObservableProperty]
|
||||
private string? _exceptionText;
|
||||
|
||||
/// <summary>D33: what an exception in force means, on the page it applies to; null otherwise.</summary>
|
||||
[ObservableProperty]
|
||||
private string? _exceptionInForceText;
|
||||
|
||||
[ObservableProperty]
|
||||
private string? _exceptionSuspendedText;
|
||||
|
||||
[ObservableProperty]
|
||||
private string? _exceptionLapseText;
|
||||
|
||||
[ObservableProperty]
|
||||
private bool _canGrantException;
|
||||
|
||||
[ObservableProperty]
|
||||
private bool _canWithdrawException;
|
||||
|
||||
/// <summary>
|
||||
/// Why the switch cannot be turned on when the executable cannot run as x64 (beta.8, <c>exe_machine</c>); null otherwise.
|
||||
/// A switch that is on for such a game can still be turned off.
|
||||
@@ -172,8 +202,9 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
public GameDetailViewModel(GameLibrary library, GameSelection selection, HookingConsent consent, IPageNavigator navigator,
|
||||
IConfirmations confirmations, IEditGamePrompt edit, IMessageStrip strip, ISessionSummaryOpener summaries,
|
||||
SessionSeriesLoader loader, IHardwareSnapshotRepository hardware, SessionSelection sessionSelection, IGamePicker picker,
|
||||
RegisteredSettings? settings = null, IAgentLink? agent = null)
|
||||
RegisteredSettings? settings = null, IAgentLink? agent = null, AntiCheatExceptions? exceptions = null)
|
||||
{
|
||||
_exceptions = exceptions;
|
||||
_settings = settings;
|
||||
_agent = agent;
|
||||
_picker = picker ?? throw new ArgumentNullException(nameof(picker));
|
||||
@@ -194,6 +225,12 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
|
||||
public static string BackText => Strings.GameDetail_Back;
|
||||
|
||||
public static string ExceptionHeader => Strings.GameDetail_Exception_Header;
|
||||
|
||||
public static string GrantExceptionText => Strings.GameDetail_Exception_Grant;
|
||||
|
||||
public static string WithdrawExceptionText => Strings.GameDetail_Exception_Withdraw;
|
||||
|
||||
public static string EditText => Strings.GameDetail_Edit;
|
||||
|
||||
public static string RemoveText => Strings.GameDetail_Remove;
|
||||
@@ -292,6 +329,9 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
new(TrendMetric.MaxCpuTemp, Strings.Trend_Metric_MaxCpuTemp),
|
||||
new(TrendMetric.AvgRam, Strings.Trend_Metric_AvgRam),
|
||||
new(TrendMetric.FgFactor, Strings.Trend_Metric_FgFactor),
|
||||
new(TrendMetric.DisplayExclusiveShare, Strings.Trend_Metric_DisplayExclusive),
|
||||
new(TrendMetric.DisplayBorderlessShare, Strings.Trend_Metric_DisplayBorderless),
|
||||
new(TrendMetric.DisplayWindowedShare, Strings.Trend_Metric_DisplayWindowed),
|
||||
];
|
||||
|
||||
/// <summary>The selected session's decoded series (null: none selected, Tier 2, or swept).</summary>
|
||||
@@ -346,6 +386,7 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
if (_settings is not null)
|
||||
{
|
||||
_hideAntiCheatHooking = await _settings.GetBooleanAsync(SettingsRegistry.UiHideAntiCheatHooking, ct).ConfigureAwait(true);
|
||||
_exceptionsOn = await _settings.GetBooleanAsync(SettingsRegistry.HookingUserModeExceptions, ct).ConfigureAwait(true);
|
||||
}
|
||||
|
||||
Present(detail);
|
||||
@@ -510,6 +551,13 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
[RelayCommand]
|
||||
private Task ToggleRecordingAsync() => RunAsync(ToggleRecordingCoreAsync);
|
||||
|
||||
/// <summary>D33: the exception's disclosure, then the request; the Agent gathers the facts and grants or refuses.</summary>
|
||||
[RelayCommand]
|
||||
private Task GrantExceptionAsync() => RunAsync(GrantExceptionCoreAsync);
|
||||
|
||||
[RelayCommand]
|
||||
private Task WithdrawExceptionAsync() => RunAsync(WithdrawExceptionCoreAsync);
|
||||
|
||||
[RelayCommand]
|
||||
private Task ReEnableHookingAsync() => RunAsync(EnableAsync);
|
||||
|
||||
@@ -671,6 +719,61 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
_navigator.Navigate<GamesPage>();
|
||||
}
|
||||
|
||||
private async Task GrantExceptionCoreAsync()
|
||||
{
|
||||
if (Game is null || ExceptionView.Of(Game) is not { CanGrant: true } view)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
Busy = true;
|
||||
try
|
||||
{
|
||||
AntiCheatExceptionResult result = _exceptions is null
|
||||
? AntiCheatExceptionResult.Of(AntiCheatExceptionOutcome.AgentUnavailable)
|
||||
: await _exceptions.GrantAsync(Game.Id, new AntiCheatExceptionFacts(Game.Name, view.Family ?? string.Empty, view.Signal ?? string.Empty))
|
||||
.ConfigureAwait(true);
|
||||
Notice(result, Game.Name);
|
||||
}
|
||||
finally
|
||||
{
|
||||
Busy = false;
|
||||
}
|
||||
|
||||
await LoadAsync().ConfigureAwait(true);
|
||||
}
|
||||
|
||||
private async Task WithdrawExceptionCoreAsync()
|
||||
{
|
||||
if (Game is null)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
Busy = true;
|
||||
try
|
||||
{
|
||||
AntiCheatExceptionResult result = _exceptions is null
|
||||
? AntiCheatExceptionResult.Of(AntiCheatExceptionOutcome.AgentUnavailable)
|
||||
: await _exceptions.WithdrawAsync(Game.Id).ConfigureAwait(true);
|
||||
Notice(result, Game.Name);
|
||||
}
|
||||
finally
|
||||
{
|
||||
Busy = false;
|
||||
}
|
||||
|
||||
await LoadAsync().ConfigureAwait(true);
|
||||
}
|
||||
|
||||
/// <summary>D33: an exception's outcome as this page's notice — a success is said, not only shown by the card changing.</summary>
|
||||
private void Notice(AntiCheatExceptionResult result, string gameName)
|
||||
{
|
||||
NoticeText = result.MessageFor(gameName);
|
||||
NoticeSeverity = result.Succeeded ? InfoBarSeverity.Success : InfoBarSeverity.Warning;
|
||||
OnPropertyChanged(nameof(NoticeVisible));
|
||||
}
|
||||
|
||||
/// <summary>A refusal, a mismatch or a failure is a persistent notice on the page; a success clears it.</summary>
|
||||
private void Notice(HookingConsentResult result)
|
||||
{
|
||||
@@ -764,6 +867,7 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
bool detected = EditGameViewModel.IsDetectedField(row.FieldProvenanceJson, "game_version");
|
||||
AddDetail(detected ? Strings.GameDetail_Details_Store : Strings.GameDetail_Details_Version, Formats.StoreVersion(row.Platform, row.GameVersion, detected));
|
||||
AddDetail(Strings.GameDetail_Details_Engine, EngineText(row));
|
||||
AddDetail(Strings.GameDetail_Details_EngineVersion, EngineVersionSourceText(row));
|
||||
if (row.ExeMachine is not null)
|
||||
{
|
||||
Details.Add(new GameDetailRow(Strings.GameDetail_Details_Libraries, row.Libraries.Count == 0
|
||||
@@ -814,6 +918,15 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
{
|
||||
Measured.Add(chip.Text);
|
||||
}
|
||||
|
||||
// beta.10: how that session was shown — the mode that lasted longest and the window's size.
|
||||
if (DisplayText.Of(lastHooked) is { } display)
|
||||
{
|
||||
string window = DisplayText.Window(display);
|
||||
string headline = DisplayText.Headline(display);
|
||||
Measured.Add(string.Format(CultureInfo.CurrentCulture, Strings.Display_Line_Format,
|
||||
string.Equals(window, Strings.Common_NotAvailable, StringComparison.Ordinal) ? headline : headline + " · " + window));
|
||||
}
|
||||
}
|
||||
|
||||
private void PresentHooking(GameRow row)
|
||||
@@ -826,7 +939,11 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
// An executable that cannot run as x64 (beta.8): turning hooking ON could only be refused; a switch that is on
|
||||
// (enabled before this build read the file) can still be turned off.
|
||||
bool notX64 = ExecutableArchitecture.IsKnownNotHookable(row.ExeMachine);
|
||||
HookToggleEnabled = !blocked && !Busy && (row.HookEnabled || !notX64);
|
||||
// D33: a blocked game whose user-mode exception is in force (the option on, a grant on the row) may be switched on —
|
||||
// through FR-2.1's dialog as ever, and the Agent's pre-scan names the family; the finding stays on the page.
|
||||
ExceptionView? exception = ExceptionView.Of(row);
|
||||
bool exceptionInForce = _exceptionsOn && exception is { Kind: ExceptionViewKind.Granted };
|
||||
HookToggleEnabled = (!blocked || exceptionInForce) && !Busy && (row.HookEnabled || !notX64);
|
||||
NotX64Text = notX64 && !blocked
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.Hooking_NotX64_Format, Formats.Architecture(row.ExeMachine))
|
||||
: null;
|
||||
@@ -838,9 +955,14 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
|
||||
// beta.8 (owner request 2026-09-25): for an anti-cheat game the card is a switch that can never be turned on, so
|
||||
// by default it gives way to the finding alone. The setting off keeps the card, with the finding under it.
|
||||
HookingSectionVisible = !(blocked && _hideAntiCheatHooking);
|
||||
HookingSectionVisible = !(blocked && _hideAntiCheatHooking) || exceptionInForce;
|
||||
PresentException(exception, exceptionInForce);
|
||||
// 2026-10-03: "cannot be turned on" beside a usable "Make exception…" contradicted itself; an eligible game's card
|
||||
// says what would turn it on.
|
||||
AntiCheatText = found is not null && !HookingSectionVisible
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.GameDetail_AntiCheat_Format, found)
|
||||
? string.Format(CultureInfo.CurrentCulture,
|
||||
_exceptionsOn && exception is { Kind: ExceptionViewKind.Eligible } ? Strings.GameDetail_AntiCheat_Exceptionable_Format : Strings.GameDetail_AntiCheat_Format,
|
||||
found)
|
||||
: null;
|
||||
// Its "Turn hooking back on" could only be refused once anti-cheat was found, or for an executable that cannot run
|
||||
// as x64, so neither row offers it.
|
||||
@@ -850,6 +972,20 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
UnverifiedText = string.Equals(row.HookPrescanState, "unverified", StringComparison.Ordinal) ? Strings.GameDetail_Hooking_Unverified : null;
|
||||
}
|
||||
|
||||
/// <summary>D33: the exception card — its state from the Agent's columns, and the one action that state allows.</summary>
|
||||
private void PresentException(ExceptionView? view, bool inForce)
|
||||
{
|
||||
ExceptionCardVisible = view is not null && (_exceptionsOn || view.Kind == ExceptionViewKind.Granted);
|
||||
ExceptionText = view?.Text;
|
||||
ExceptionLapseText = view?.LapseText;
|
||||
ExceptionInForceText = inForce && view?.Family is { } family
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.GameDetail_Exception_Granted_Format, family)
|
||||
: null;
|
||||
ExceptionSuspendedText = view is { Kind: ExceptionViewKind.Granted } && !_exceptionsOn ? Strings.GameDetail_Exception_Suspended : null;
|
||||
CanGrantException = _exceptionsOn && view is { CanGrant: true } && !Busy;
|
||||
CanWithdrawException = view is { CanWithdraw: true } && !Busy;
|
||||
}
|
||||
|
||||
private void PresentSessions(GameDetail detail)
|
||||
{
|
||||
Sessions.Clear();
|
||||
@@ -864,6 +1000,25 @@ public sealed partial class GameDetailViewModel : ObservableObject
|
||||
private static string EngineText(GameRow row) =>
|
||||
row.Engine is null || row.EngineVersion is null ? Formats.Engine(row.Engine) : Formats.Engine(row.Engine) + " " + row.EngineVersion;
|
||||
|
||||
/// <summary>
|
||||
/// Which witness an Unreal Engine version rests on (beta.10, schema 0015) — said, because the executable's version
|
||||
/// number and the engine's build name can each be wrong in their own way (<c>05_DETECTION</c> §Engine version). An
|
||||
/// Unreal title whose executable names no version says so once the sweep has read it; other engines add no line.
|
||||
/// </summary>
|
||||
internal static string? EngineVersionSourceText(GameRow row)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(row);
|
||||
return row.EngineVersionSource switch
|
||||
{
|
||||
EngineVersionSource.UnrealBranchAndFile => Strings.GameDetail_EngineVersion_BranchAndFile,
|
||||
EngineVersionSource.UnrealBranch => Strings.GameDetail_EngineVersion_Branch,
|
||||
EngineVersionSource.UnrealFileVersion => Strings.GameDetail_EngineVersion_FileVersion,
|
||||
null when string.Equals(row.Engine, "unreal", StringComparison.Ordinal) && row.EngineVersion is null && row.ExeMachine is not null
|
||||
=> Strings.GameDetail_EngineVersion_NotFound,
|
||||
_ => null,
|
||||
};
|
||||
}
|
||||
|
||||
private static Domain.Metrics.Tri DefaultOf(GameRow row, TriStateKind kind) => kind switch
|
||||
{
|
||||
TriStateKind.RayTracing => row.RtDefault,
|
||||
|
||||
@@ -1,19 +1,39 @@
|
||||
using System.Collections.ObjectModel;
|
||||
using System.Globalization;
|
||||
using CommunityToolkit.Mvvm.ComponentModel;
|
||||
using CommunityToolkit.Mvvm.Input;
|
||||
using FrameLedger.App.Pages;
|
||||
using FrameLedger.App.Services;
|
||||
using FrameLedger.Application.Settings;
|
||||
using FrameLedger.Shared.Ipc;
|
||||
|
||||
namespace FrameLedger.App.ViewModels;
|
||||
|
||||
/// <summary>The Games grid (<c>08_UI</c> §Games): every game in the library as a card, searched and sorted in memory; add by pick or drop; open by click.</summary>
|
||||
/// <summary>
|
||||
/// The Games library (<c>08_UI</c> §Games): every game in the library, searched and sorted in memory; add by pick or drop;
|
||||
/// open by click. Since beta.11 (owner requests 2026-10-03): shown as a grid of cards that fills the width or as a list
|
||||
/// (<c>ui.library_view</c>), with the count in the header; <b>Refresh</b> reloads the library, looks in the stores for games
|
||||
/// installed since and offers only those, and marks entries whose executable is gone ("Not installed"); and the page
|
||||
/// reloads by itself when a session ends or an import adds games while it is on screen.
|
||||
/// </summary>
|
||||
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
|
||||
public sealed partial class GamesViewModel : ObservableObject
|
||||
{
|
||||
private const string _listValue = "list";
|
||||
private const string _gridValue = "grid";
|
||||
|
||||
private readonly GameLibrary _library;
|
||||
private readonly GameSelection _selection;
|
||||
private readonly IPageNavigator _navigator;
|
||||
private readonly AddGameFlow _addGame;
|
||||
private readonly ImportLibraryFlow? _import;
|
||||
private readonly RegisteredSettings? _settings;
|
||||
private readonly IAgentLink? _agent;
|
||||
private readonly LibraryChanges? _changes;
|
||||
private readonly UiThread _ui = new();
|
||||
private IReadOnlyList<GameCardViewModel> _all = [];
|
||||
private bool _viewRead;
|
||||
private bool _attached;
|
||||
|
||||
[ObservableProperty]
|
||||
private string _search = string.Empty;
|
||||
@@ -27,17 +47,27 @@ public sealed partial class GamesViewModel : ObservableObject
|
||||
[ObservableProperty]
|
||||
private bool _noMatch;
|
||||
|
||||
public GamesViewModel(GameLibrary library, GameSelection selection, IPageNavigator navigator, AddGameFlow addGame)
|
||||
[ObservableProperty]
|
||||
private string _headerText = Strings.Games_Header;
|
||||
|
||||
/// <summary>The list instead of the grid (<c>ui.library_view</c>); remembered when the user changes it.</summary>
|
||||
[ObservableProperty]
|
||||
private bool _listView;
|
||||
|
||||
public GamesViewModel(GameLibrary library, GameSelection selection, IPageNavigator navigator, AddGameFlow addGame, ImportLibraryFlow? import = null,
|
||||
RegisteredSettings? settings = null, IAgentLink? agent = null, LibraryChanges? changes = null)
|
||||
{
|
||||
_library = library ?? throw new ArgumentNullException(nameof(library));
|
||||
_selection = selection ?? throw new ArgumentNullException(nameof(selection));
|
||||
_navigator = navigator ?? throw new ArgumentNullException(nameof(navigator));
|
||||
_addGame = addGame ?? throw new ArgumentNullException(nameof(addGame));
|
||||
_import = import;
|
||||
_settings = settings;
|
||||
_agent = agent;
|
||||
_changes = changes;
|
||||
Pending = LoadAsync();
|
||||
}
|
||||
|
||||
public static string Header => Strings.Games_Header;
|
||||
|
||||
public static string EmptyText => Strings.Games_Empty;
|
||||
|
||||
public static string NoMatchText => Strings.Games_NoMatch;
|
||||
@@ -48,6 +78,14 @@ public sealed partial class GamesViewModel : ObservableObject
|
||||
|
||||
public static string SortLabel => Strings.Games_Sort_Label;
|
||||
|
||||
public static string RefreshText => Strings.Games_Refresh;
|
||||
|
||||
public static string RefreshToolTip => Strings.Games_Refresh_ToolTip;
|
||||
|
||||
public static string GridText => Strings.Games_View_Grid;
|
||||
|
||||
public static string ListText => Strings.Games_View_List;
|
||||
|
||||
public static IReadOnlyList<Choice<GamesSort>> Sorts { get; } =
|
||||
[
|
||||
new(GamesSort.Name, Strings.Games_Sort_Name),
|
||||
@@ -62,11 +100,85 @@ public sealed partial class GamesViewModel : ObservableObject
|
||||
|
||||
public async Task LoadAsync(CancellationToken ct = default)
|
||||
{
|
||||
await ReadViewAsync(ct).ConfigureAwait(true);
|
||||
IReadOnlyList<GameCard> cards = await _library.ListCardsAsync(ct).ConfigureAwait(true);
|
||||
_all = [.. cards.Select(static c => new GameCardViewModel(c))];
|
||||
// Whether each executable is on disk is a file-system question per entry — a drive that is gone can take a moment
|
||||
// to say so — so it is asked off the UI thread, the game page's own way (GameLibrary.ExecutableExists).
|
||||
bool[] installed = await Task.Run(() => cards.Select(static c => GameLibrary.ExecutableExists(c.Row.Fingerprint.ExePath)).ToArray(), ct)
|
||||
.ConfigureAwait(true);
|
||||
_all = [.. cards.Select((c, i) => new GameCardViewModel(c, installed[i]))];
|
||||
HeaderText = string.Format(CultureInfo.CurrentCulture, Strings.Games_Header_Count_Format, _all.Count);
|
||||
Apply();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Listens while the page is on screen: a session that ends changes a card's count, playtime and last played, and an
|
||||
/// import made from the menu adds cards. The page calls it on Loaded and <see cref="Detach"/> on Unloaded; the link and
|
||||
/// the notifier are singletons and must not hold the page.
|
||||
/// </summary>
|
||||
public void Attach()
|
||||
{
|
||||
if (_attached)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
if (_agent is not null)
|
||||
{
|
||||
_agent.EventReceived += OnAgentEvent;
|
||||
}
|
||||
|
||||
if (_changes is not null)
|
||||
{
|
||||
_changes.Changed += OnLibraryChanged;
|
||||
}
|
||||
|
||||
_attached = true;
|
||||
}
|
||||
|
||||
public void Detach()
|
||||
{
|
||||
if (!_attached)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
if (_agent is not null)
|
||||
{
|
||||
_agent.EventReceived -= OnAgentEvent;
|
||||
}
|
||||
|
||||
if (_changes is not null)
|
||||
{
|
||||
_changes.Changed -= OnLibraryChanged;
|
||||
}
|
||||
|
||||
_attached = false;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// beta.11: the library read again, then the stores asked for games installed since — offered in the import checklist,
|
||||
/// the games already in the library hidden — and read again when any was added. A game whose executable is gone is
|
||||
/// marked on its card by the read; nothing is removed.
|
||||
/// </summary>
|
||||
[RelayCommand]
|
||||
private async Task RefreshAsync()
|
||||
{
|
||||
Pending = LoadAsync();
|
||||
await Pending.ConfigureAwait(true);
|
||||
if (_import is not null && await _import.RunAsync(onlyNew: true).ConfigureAwait(true) is { Added: > 0 })
|
||||
{
|
||||
Pending = LoadAsync();
|
||||
await Pending.ConfigureAwait(true);
|
||||
}
|
||||
}
|
||||
|
||||
[RelayCommand]
|
||||
private void ShowGrid() => ListView = false;
|
||||
|
||||
[RelayCommand]
|
||||
private void ShowList() => ListView = true;
|
||||
|
||||
[RelayCommand]
|
||||
private async Task AddGameAsync() => _ = await _addGame.RunAsync().ConfigureAwait(true);
|
||||
|
||||
@@ -96,6 +208,43 @@ public sealed partial class GamesViewModel : ObservableObject
|
||||
|
||||
partial void OnSortChanged(GamesSort value) => Apply();
|
||||
|
||||
partial void OnListViewChanged(bool value)
|
||||
{
|
||||
if (_viewRead && _settings is not null)
|
||||
{
|
||||
_ = SaveViewAsync(value);
|
||||
}
|
||||
}
|
||||
|
||||
private async Task SaveViewAsync(bool list) =>
|
||||
await _settings!.SetAsync(SettingsRegistry.UiLibraryView, list ? _listValue : _gridValue).ConfigureAwait(true);
|
||||
|
||||
/// <summary>The remembered view, read once per page before the first list — so reading it is not taken for a change.</summary>
|
||||
private async Task ReadViewAsync(CancellationToken ct)
|
||||
{
|
||||
if (_viewRead)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
if (_settings is not null)
|
||||
{
|
||||
ListView = string.Equals(await _settings.GetAsync(SettingsRegistry.UiLibraryView, ct).ConfigureAwait(true), _listValue, StringComparison.Ordinal);
|
||||
}
|
||||
|
||||
_viewRead = true;
|
||||
}
|
||||
|
||||
private void OnAgentEvent(object? sender, AgentEventArgs e) => _ui.Post(() =>
|
||||
{
|
||||
if (string.Equals(e.Envelope.Type, IpcMessageType.SessionCompleted, StringComparison.Ordinal))
|
||||
{
|
||||
Pending = LoadAsync();
|
||||
}
|
||||
});
|
||||
|
||||
private void OnLibraryChanged(object? sender, EventArgs e) => _ui.Post(() => Pending = LoadAsync());
|
||||
|
||||
private void Apply()
|
||||
{
|
||||
IEnumerable<GameCardViewModel> shown = _all;
|
||||
|
||||
@@ -25,6 +25,12 @@ public sealed partial class ImportCandidateViewModel : ObservableObject
|
||||
|
||||
public bool CanImport => Candidate.CanImport;
|
||||
|
||||
/// <summary>
|
||||
/// Already in the library — at this path, or (since 2026-09-23) the same file under another drive letter. Since beta.11
|
||||
/// such a row is hidden unless the user asks to see it, and then shown dimmed with a box that cannot be ticked.
|
||||
/// </summary>
|
||||
public bool IsExisting => Candidate.AlreadyInLibrary || Candidate.MovedFrom is not null;
|
||||
|
||||
public string PlatformText => Formats.Platform(Candidate.Game.Platform);
|
||||
|
||||
public string Name => Candidate.Game.Name;
|
||||
|
||||
@@ -8,7 +8,12 @@ using FrameLedger.Application.Import;
|
||||
|
||||
namespace FrameLedger.App.ViewModels;
|
||||
|
||||
/// <summary>FR-1.2's review checklist: every candidate the stores found, ticked by default where it can be imported; the count follows the ticks.</summary>
|
||||
/// <summary>
|
||||
/// FR-1.2's review checklist: every candidate the stores found, ticked by default where it can be imported; the count
|
||||
/// follows the ticks. Since beta.11 (owner request 2026-10-03) the games already in the library are hidden by default —
|
||||
/// on a re-import they were most of the list and pushed the new ones out of sight — and <see cref="ShowExisting"/> brings
|
||||
/// them back, dimmed, their boxes disabled.
|
||||
/// </summary>
|
||||
[SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime; a cached CompositeFormat would pin the first culture")]
|
||||
public sealed partial class ImportReviewViewModel : ObservableObject
|
||||
{
|
||||
@@ -17,6 +22,9 @@ public sealed partial class ImportReviewViewModel : ObservableObject
|
||||
[NotifyPropertyChangedFor(nameof(SelectedText))]
|
||||
private int _selectedCount;
|
||||
|
||||
[ObservableProperty]
|
||||
private bool _showExisting;
|
||||
|
||||
public ImportReviewViewModel(IReadOnlyList<ImportCandidate> candidates)
|
||||
{
|
||||
ArgumentNullException.ThrowIfNull(candidates);
|
||||
@@ -27,11 +35,25 @@ public sealed partial class ImportReviewViewModel : ObservableObject
|
||||
Rows.Add(row);
|
||||
}
|
||||
|
||||
ExistingCount = Rows.Count(static r => r.IsExisting);
|
||||
ShowExistingText = string.Format(CultureInfo.CurrentCulture, Strings.Import_ShowExisting_Format, ExistingCount);
|
||||
Refilter();
|
||||
Recount();
|
||||
}
|
||||
|
||||
/// <summary>Every candidate, shown or not.</summary>
|
||||
public ObservableCollection<ImportCandidateViewModel> Rows { get; } = [];
|
||||
|
||||
/// <summary>What the checklist shows: every row, less those already in the library unless <see cref="ShowExisting"/>.</summary>
|
||||
public ObservableCollection<ImportCandidateViewModel> Shown { get; } = [];
|
||||
|
||||
/// <summary>Rows already in the library (at this path or another drive letter).</summary>
|
||||
public int ExistingCount { get; }
|
||||
|
||||
public bool HasExisting => ExistingCount > 0;
|
||||
|
||||
public string ShowExistingText { get; }
|
||||
|
||||
public static string Title => Strings.Import_Title;
|
||||
|
||||
public static string Intro => Strings.Import_Intro;
|
||||
@@ -77,4 +99,15 @@ public sealed partial class ImportReviewViewModel : ObservableObject
|
||||
}
|
||||
|
||||
private void Recount() => SelectedCount = Rows.Count(static r => r.IsSelected && r.CanImport);
|
||||
|
||||
partial void OnShowExistingChanged(bool value) => Refilter();
|
||||
|
||||
private void Refilter()
|
||||
{
|
||||
Shown.Clear();
|
||||
foreach (ImportCandidateViewModel r in Rows.Where(r => ShowExisting || !r.IsExisting))
|
||||
{
|
||||
Shown.Add(r);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -224,6 +224,36 @@ public sealed partial class MainWindowViewModel : ObservableObject, IDisposable
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Help ▸ Limitations (beta.10, D36): <c>LIMITATIONS.md</c> as this build embeds it, read-only and scrollable, with the
|
||||
/// repository's copy one button away. Information, not terms — nothing is recorded.
|
||||
/// </summary>
|
||||
[RelayCommand]
|
||||
private async Task LimitationsAsync()
|
||||
{
|
||||
var text = new System.Windows.Controls.TextBox
|
||||
{
|
||||
Text = LimitationsDocument.Load(),
|
||||
IsReadOnly = true,
|
||||
TextWrapping = System.Windows.TextWrapping.Wrap,
|
||||
VerticalScrollBarVisibility = System.Windows.Controls.ScrollBarVisibility.Auto,
|
||||
MaxHeight = 520,
|
||||
Width = 680,
|
||||
};
|
||||
System.Windows.Automation.AutomationProperties.SetName(text, Strings.Limitations_Title);
|
||||
var box = new MessageBox
|
||||
{
|
||||
Title = Strings.Limitations_Title,
|
||||
Content = text,
|
||||
PrimaryButtonText = Strings.Limitations_OnGitHub,
|
||||
CloseButtonText = Strings.Common_Close,
|
||||
};
|
||||
if (await box.ShowDialogAsync().ConfigureAwait(true) == MessageBoxResult.Primary && !_urls.Open(LimitationsDocument.OnGitHub))
|
||||
{
|
||||
_snackbar.Show(Strings.Limitations_Title, Strings.BugReport_BrowserRefused, ControlAppearance.Caution, new SymbolIcon(SymbolRegular.Warning24), TimeSpan.FromSeconds(4));
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>Help ▸ Report a bug… (P4 PR-3): <c>10_LOGGING</c> §Bug report flow steps 2–4, the same flow the Logs page's button runs.</summary>
|
||||
[RelayCommand]
|
||||
private async Task ReportBugAsync() => _ = await _bugReports.RunAsync().ConfigureAwait(true);
|
||||
|
||||
@@ -1,3 +1,4 @@
|
||||
using System.Globalization;
|
||||
using FrameLedger.App.Services;
|
||||
using FrameLedger.Application.Persistence;
|
||||
using FrameLedger.Application.TriState;
|
||||
@@ -10,6 +11,7 @@ namespace FrameLedger.App.ViewModels;
|
||||
/// <see cref="FpsPresentation"/> (<c>—</c> for a measured none, <c>N/A</c> for not measured, never blank, never
|
||||
/// zero — FR-4.9), the lows, resolution · upscaler, the chips resolved with the annotation and the game default.
|
||||
/// </summary>
|
||||
[System.Diagnostics.CodeAnalysis.SuppressMessage("Performance", "CA1863:Use 'CompositeFormat'", Justification = "the format strings are resources that follow the UI culture, which changes at runtime")]
|
||||
public sealed class SessionItemViewModel
|
||||
{
|
||||
public SessionItemViewModel(SessionRow row, SessionAnnotation? annotation, GameRow game)
|
||||
@@ -21,8 +23,12 @@ public sealed class SessionItemViewModel
|
||||
DateText = Formats.Date(row.StartedAt);
|
||||
DurationText = Formats.Duration(row.DurationSeconds);
|
||||
IsHooked = row.Tier == CaptureTier.Hooked;
|
||||
TierText = IsHooked ? Strings.Tier_Hooked : Strings.Tier_NotHooked;
|
||||
TierTooltip = IsHooked ? Strings.Tier_Hooked_Tooltip : Strings.Tier_NotHooked_Tooltip;
|
||||
// D33: a hooked session under the game's user-mode exception is marked with it wherever its tier is said.
|
||||
TierText = !IsHooked ? Strings.Tier_NotHooked : row.AcExceptionFamily is null ? Strings.Tier_Hooked : Strings.Tier_HookedException;
|
||||
TierTooltip = !IsHooked ? Strings.Tier_NotHooked_Tooltip
|
||||
: row.AcExceptionFamily is { } family
|
||||
? Strings.Tier_Hooked_Tooltip + Environment.NewLine + string.Format(CultureInfo.CurrentCulture, Strings.Session_UnderException_Format, family)
|
||||
: Strings.Tier_Hooked_Tooltip;
|
||||
NativeText = FpsPresentation.NativeColumn(row);
|
||||
DisplayedText = FpsPresentation.DisplayedColumn(row);
|
||||
FgText = FpsPresentation.FactorColumn(row);
|
||||
@@ -31,6 +37,10 @@ public sealed class SessionItemViewModel
|
||||
P01LowText = IsHooked ? Formats.Fps(row.P01LowFps) : Strings.Common_NotAvailable;
|
||||
ResolutionText = IsHooked ? Formats.Resolution(row.RenderW, row.RenderH, row.OutputW, row.OutputH) + " · " + Formats.Upscaler(row.Upscaler, row.UpscalerQuality, row.UpscalerDriverReported) : Strings.Common_NotAvailable;
|
||||
GpuTempText = Formats.Temperature(row.MaxGpuTemp);
|
||||
// beta.10: both tiers — the window is read out of process whether or not the game was hooked.
|
||||
Domain.Display.DisplaySummary? display = DisplayText.Of(row);
|
||||
DisplayModeText = DisplayText.Headline(display);
|
||||
DisplayModeTooltip = DisplayText.Line(display);
|
||||
ApiText = IsHooked ? Formats.Api(row.Api) : Strings.Common_NotAvailable;
|
||||
ExitText = Formats.ExitStatusText(row.ExitStatus);
|
||||
IsCrashed = row.ExitStatus == ExitStatus.Crashed;
|
||||
@@ -70,6 +80,12 @@ public sealed class SessionItemViewModel
|
||||
|
||||
public string GpuTempText { get; }
|
||||
|
||||
/// <summary>The mode the session was shown in longest, with its share; N/A for a row recorded before beta.10.</summary>
|
||||
public string DisplayModeText { get; }
|
||||
|
||||
/// <summary>Every share, the window on its monitor, the back buffer and the source; null for a row without display facts.</summary>
|
||||
public string? DisplayModeTooltip { get; }
|
||||
|
||||
public string ApiText { get; }
|
||||
|
||||
public string ExitText { get; }
|
||||
|
||||
@@ -78,6 +78,17 @@ public sealed partial class SessionSummaryViewModel : ObservableObject
|
||||
[ObservableProperty]
|
||||
private string _exitLine = string.Empty;
|
||||
|
||||
/// <summary>D33: the session was hooked under the game's user-mode exception, and for which anti-cheat; null otherwise.</summary>
|
||||
[ObservableProperty]
|
||||
private string? _exceptionLine;
|
||||
|
||||
/// <summary>
|
||||
/// How the game was shown (beta.10, schema 0016): every mode's share, the window on its monitor, the back buffer and what
|
||||
/// the facts rested on — in either tier; null for a row recorded before, or recovered from its crash file.
|
||||
/// </summary>
|
||||
[ObservableProperty]
|
||||
private string? _displayLine;
|
||||
|
||||
/// <summary>Tier 2's payload (2026-09-22): why this session measured nothing, from the row's notes; empty for a hooked row.</summary>
|
||||
[ObservableProperty]
|
||||
private string _tier2Reason = string.Empty;
|
||||
@@ -321,6 +332,9 @@ public sealed partial class SessionSummaryViewModel : ObservableObject
|
||||
Tier2Reason = IsHooked ? string.Empty : Formats.Tier2Reason(row.CaptureNotes);
|
||||
ExitLine = string.Format(CultureInfo.CurrentCulture, Strings.Exit_Line_Format,
|
||||
Formats.ExitText(row.ExitStatus, Application.Recording.CaptureNotes.Parse(row.CaptureNotes)));
|
||||
ExceptionLine = row.AcExceptionFamily is { } family
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.Session_UnderException_Format, family)
|
||||
: null;
|
||||
Readout = FpsPresentation.FromRow(row);
|
||||
Line = string.Format(CultureInfo.CurrentCulture, Strings.Summary_Line_Format,
|
||||
IsHooked ? Formats.Api(row.Api) : Strings.Tier_NotHooked, row.PresentMode ?? Strings.Common_NotAvailable,
|
||||
@@ -331,6 +345,7 @@ public sealed partial class SessionSummaryViewModel : ObservableObject
|
||||
LibrariesLine = LoadedLibraries(row.RuntimeModulesJson, Game.Libraries);
|
||||
DriverProfileLine = NvidiaOverrides.ProfileLine(row.DriverProfileJson);
|
||||
DriverStateLine = NvidiaOverrides.DriverLine(row.NgxDriverWordsJson);
|
||||
DisplayLine = DisplayText.Line(DisplayText.Of(row));
|
||||
Tags = _annotation is null ? string.Empty : string.Join(", ", _annotation.Tags);
|
||||
Notes = _annotation?.Notes ?? string.Empty;
|
||||
HasDisplayed = Series?.HasGenerated == true;
|
||||
@@ -356,6 +371,12 @@ public sealed partial class SessionSummaryViewModel : ObservableObject
|
||||
? string.Format(CultureInfo.CurrentCulture, Strings.Summary_Stat_Stutter_Format, count, pct) : Strings.Common_NotAvailable));
|
||||
Stats.Add(new StatCardModel(Strings.Summary_Stat_Duration, Formats.Duration(row.DurationSeconds)));
|
||||
|
||||
// beta.10, both tiers: the mode the game was shown in longest, and the window's size in it.
|
||||
Domain.Display.DisplaySummary? display = DisplayText.Of(row);
|
||||
string window = DisplayText.Window(display);
|
||||
Stats.Add(new StatCardModel(Strings.Summary_Stat_Display, DisplayText.Headline(display),
|
||||
string.Equals(window, Strings.Common_NotAvailable, StringComparison.Ordinal) ? null : window));
|
||||
|
||||
// The machine, both tiers: telemetry is what a not-hooked session still has. Load is the average, temperature the peak.
|
||||
Stats.Add(new StatCardModel(Strings.Summary_Stat_Gpu, string.Format(CultureInfo.CurrentCulture, Strings.Summary_Stat_LoadTemp_Format, Formats.Percent(row.AvgGpuLoad), Formats.Temperature(row.MaxGpuTemp))));
|
||||
Stats.Add(new StatCardModel(Strings.Summary_Stat_Cpu, string.Format(CultureInfo.CurrentCulture, Strings.Summary_Stat_LoadTemp_Format, Formats.Percent(row.AvgCpuLoad), Formats.Temperature(row.MaxCpuTemp))));
|
||||
|
||||
@@ -8,7 +8,9 @@ using CommunityToolkit.Mvvm.Input;
|
||||
using FrameLedger.App.Services;
|
||||
using FrameLedger.Application.Persistence;
|
||||
using FrameLedger.Application.Settings;
|
||||
using FrameLedger.Infrastructure.Ipc;
|
||||
using FrameLedger.Infrastructure.Startup;
|
||||
using FrameLedger.Shared.Ipc;
|
||||
|
||||
namespace FrameLedger.App.ViewModels;
|
||||
|
||||
@@ -39,8 +41,18 @@ public sealed partial class SettingsViewModel : ObservableObject
|
||||
private readonly IAgentTool _tool;
|
||||
private readonly WindowClosePolicy _closePolicy;
|
||||
private readonly IFirstRunFlow _firstRun;
|
||||
private readonly AntiCheatExceptions? _exceptions;
|
||||
private readonly IAgentAdminPrompt? _adminPrompt;
|
||||
private readonly Func<bool> _agentHeld;
|
||||
private bool _loading = true;
|
||||
|
||||
/// <summary>
|
||||
/// <c>capture.run_elevated</c> (beta.10, owner decision D34): the Agent is started as administrator — Windows asks at every
|
||||
/// start. Turning it on shows the disclosure first; either way the Agent restarts when no session is running.
|
||||
/// </summary>
|
||||
[ObservableProperty]
|
||||
private bool _runElevated;
|
||||
|
||||
[ObservableProperty]
|
||||
private AppTheme _selectedTheme;
|
||||
|
||||
@@ -73,6 +85,18 @@ public sealed partial class SettingsViewModel : ObservableObject
|
||||
[ObservableProperty]
|
||||
private bool _hideAntiCheatHooking = true;
|
||||
|
||||
/// <summary>
|
||||
/// <c>hooking.usermode_ac_exceptions</c> (D33, owner decision 2026-09-26): whether a game's user-mode anti-cheat exception
|
||||
/// may apply at all. Off by default; off suspends every exception below without deleting any.
|
||||
/// </summary>
|
||||
[ObservableProperty]
|
||||
[NotifyPropertyChangedFor(nameof(ExceptionsSuspended))]
|
||||
private bool _userModeExceptions;
|
||||
|
||||
/// <summary>D33: the Agent has not answered about every blocked game yet (the option was just turned on).</summary>
|
||||
[ObservableProperty]
|
||||
private bool _exceptionsChecking;
|
||||
|
||||
/// <summary><c>ui.fps_decimals</c> (beta.8): every FPS figure with two decimals ("62.40") instead of a whole number.</summary>
|
||||
[ObservableProperty]
|
||||
private bool _fpsTwoDecimals;
|
||||
@@ -120,8 +144,17 @@ public sealed partial class SettingsViewModel : ObservableObject
|
||||
IMaintenanceState maintenance,
|
||||
IAgentTool tool,
|
||||
WindowClosePolicy closePolicy,
|
||||
IFirstRunFlow firstRun)
|
||||
IFirstRunFlow firstRun,
|
||||
AntiCheatExceptions? exceptions = null,
|
||||
IAgentAdminPrompt? adminPrompt = null,
|
||||
Func<bool>? agentHeld = null)
|
||||
{
|
||||
// The admin mode's disclosure (a composition without it — a test — cannot turn the mode on), and the probe of the
|
||||
// data folder's instance lock the restart waits on (a test's own).
|
||||
_adminPrompt = adminPrompt;
|
||||
_agentHeld = agentHeld ?? (static () => AgentInstanceLock.IsHeld(UiPaths.DataDirectory));
|
||||
// D33: the user-mode exception's requests; a composition without it (a test) answers that the Agent is unavailable.
|
||||
_exceptions = exceptions;
|
||||
_firstRun = firstRun ?? throw new ArgumentNullException(nameof(firstRun));
|
||||
_maintenance = maintenance ?? throw new ArgumentNullException(nameof(maintenance));
|
||||
_tool = tool ?? throw new ArgumentNullException(nameof(tool));
|
||||
@@ -182,6 +215,15 @@ public sealed partial class SettingsViewModel : ObservableObject
|
||||
|
||||
public ObservableCollection<HookedGameViewModel> HookedGames { get; } = [];
|
||||
|
||||
/// <summary>
|
||||
/// D33: the games the user-mode exception concerns — in force, eligible, or held back only by the session count. The rest
|
||||
/// of the blocked games say why not on their own pages.
|
||||
/// </summary>
|
||||
public ObservableCollection<ExceptionGameViewModel> ExceptionGames { get; } = [];
|
||||
|
||||
/// <summary>D33: the option is off and exceptions are kept below that do not apply.</summary>
|
||||
public bool ExceptionsSuspended => !UserModeExceptions && ExceptionGames.Any(static g => g.CanWithdraw);
|
||||
|
||||
public string KillSwitchState => KillSwitch ? Strings.Settings_KillSwitch_On : Strings.Settings_KillSwitch_Off;
|
||||
|
||||
/// <summary>12_BUILD: the registration exists only while a hook-enabled game references the Vulkan loader (P4 PR-2) — the button follows the same rule as the Agent's reconciler.</summary>
|
||||
@@ -224,6 +266,78 @@ public sealed partial class SettingsViewModel : ObservableObject
|
||||
|
||||
partial void OnKillSwitchChanged(bool value) => Persist(SettingsRegistry.HookingKillSwitch, value);
|
||||
|
||||
partial void OnRunElevatedChanged(bool value)
|
||||
{
|
||||
if (!_loading)
|
||||
{
|
||||
Pending = ApplyRunElevatedAsync(value);
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>On: the disclosure, and nothing is written unless it is accepted. Then the row, then the Agent's restart.</summary>
|
||||
private async Task ApplyRunElevatedAsync(bool value)
|
||||
{
|
||||
if (value && (_adminPrompt is null || !await _adminPrompt.ShowAsync().ConfigureAwait(true)))
|
||||
{
|
||||
_loading = true;
|
||||
try
|
||||
{
|
||||
RunElevated = false;
|
||||
}
|
||||
finally
|
||||
{
|
||||
_loading = false;
|
||||
}
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
await _settings.SetAsync(SettingsRegistry.CaptureRunElevated, value ? "1" : "0").ConfigureAwait(true);
|
||||
await RestartAgentAsync().ConfigureAwait(true);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// The mode is decided when the Agent starts, so it restarts — never under a running session, which the Shutdown would
|
||||
/// end. It is asked to stop over the pipe, its folder's instance lock is waited out (the process has gone), and the
|
||||
/// connection's next round starts it the new way.
|
||||
/// </summary>
|
||||
private async Task RestartAgentAsync()
|
||||
{
|
||||
string label = Strings.Settings_Agent_RunElevated_Label;
|
||||
if (_agent.Status?.ActiveSessions is { Count: > 0 })
|
||||
{
|
||||
_strip.Info(label, Strings.Settings_Agent_RunElevated_AfterSession);
|
||||
return;
|
||||
}
|
||||
|
||||
if (_agent.IsConnected)
|
||||
{
|
||||
try
|
||||
{
|
||||
await _agent.RequestAsync(IpcMessageType.Shutdown, new ShutdownRequest()).ConfigureAwait(true);
|
||||
}
|
||||
catch (Exception ex) when (ex is IpcRequestException or TimeoutException or IOException or InvalidOperationException)
|
||||
{
|
||||
Serilog.Log.Warning(ex, "settings: the Agent did not acknowledge Shutdown for the admin mode's restart");
|
||||
}
|
||||
}
|
||||
|
||||
DateTimeOffset deadline = DateTimeOffset.UtcNow + TimeSpan.FromSeconds(20);
|
||||
while (_agentHeld() && DateTimeOffset.UtcNow < deadline)
|
||||
{
|
||||
await Task.Delay(200).ConfigureAwait(true);
|
||||
}
|
||||
|
||||
if (_agentHeld())
|
||||
{
|
||||
_strip.Warn(label, Strings.Settings_Agent_RunElevated_NotStopped);
|
||||
return;
|
||||
}
|
||||
|
||||
_agent.RetryNow();
|
||||
_strip.Info(label, Strings.Settings_Agent_RunElevated_Restarting);
|
||||
}
|
||||
|
||||
partial void OnMinSessionSecondsChanged(int oldValue, int newValue) => PersistNumber(SettingsRegistry.CaptureMinSessionSeconds, Strings.Settings_MinSession_Label, oldValue, newValue, v => MinSessionSeconds = v);
|
||||
|
||||
partial void OnTelemetryIntervalMsChanged(int oldValue, int newValue) => PersistNumber(SettingsRegistry.TelemetryIntervalMs, Strings.Settings_Interval_Label, oldValue, newValue, v => TelemetryIntervalMs = v);
|
||||
@@ -234,6 +348,21 @@ public sealed partial class SettingsViewModel : ObservableObject
|
||||
|
||||
partial void OnHideAntiCheatHookingChanged(bool value) => Persist(SettingsRegistry.UiHideAntiCheatHooking, value);
|
||||
|
||||
/// <summary>D33: the option is one settings row the Agent reads at every session start and command; the list follows it.</summary>
|
||||
partial void OnUserModeExceptionsChanged(bool value)
|
||||
{
|
||||
if (!_loading)
|
||||
{
|
||||
Pending = WriteThenRefreshAsync(SettingsRegistry.HookingUserModeExceptions, value ? "1" : "0");
|
||||
}
|
||||
}
|
||||
|
||||
private async Task WriteThenRefreshAsync(SettingDefinition definition, string value)
|
||||
{
|
||||
await WriteAsync(definition, value).ConfigureAwait(true);
|
||||
await RefreshCoreAsync().ConfigureAwait(true);
|
||||
}
|
||||
|
||||
partial void OnFpsTwoDecimalsChanged(bool value)
|
||||
{
|
||||
if (_loading)
|
||||
@@ -356,6 +485,8 @@ public sealed partial class SettingsViewModel : ObservableObject
|
||||
BackgroundCapture = await _settings.GetBooleanAsync(SettingsRegistry.CaptureBackground).ConfigureAwait(true);
|
||||
MinimizeToTray = await _settings.GetBooleanAsync(SettingsRegistry.UiMinimizeToTray).ConfigureAwait(true);
|
||||
HideAntiCheatHooking = await _settings.GetBooleanAsync(SettingsRegistry.UiHideAntiCheatHooking).ConfigureAwait(true);
|
||||
UserModeExceptions = await _settings.GetBooleanAsync(SettingsRegistry.HookingUserModeExceptions).ConfigureAwait(true);
|
||||
RunElevated = await _settings.GetBooleanAsync(SettingsRegistry.CaptureRunElevated).ConfigureAwait(true);
|
||||
FpsTwoDecimals = await _settings.GetBooleanAsync(SettingsRegistry.UiFpsDecimals).ConfigureAwait(true);
|
||||
OnlineMetadata = await _settings.GetBooleanAsync(SettingsRegistry.PrivacyOnlineMetadata).ConfigureAwait(true);
|
||||
UpdateChannel = await _settings.GetAsync(SettingsRegistry.UpdateChannel).ConfigureAwait(true);
|
||||
@@ -381,12 +512,28 @@ public sealed partial class SettingsViewModel : ObservableObject
|
||||
HookedGames.Add(new HookedGameViewModel(card.Row.Id, card.Row.Name, RevokeAsync, CapabilityFlags.Contains(card.Row.CapabilityFlagsJson, "vulkan")));
|
||||
}
|
||||
|
||||
PresentExceptions(cards);
|
||||
|
||||
Shared.Ipc.HelloAck? hello = _agent.Hello;
|
||||
ElevationText = hello is null ? Strings.Settings_VkLayer_Unknown : hello.Elevated ? Strings.Settings_Agent_Elevated : Strings.Settings_Agent_NotElevated;
|
||||
ElevationText = ElevationTextOf(_agent.State, hello);
|
||||
MaintenanceSnapshot = await _maintenance.ReadAsync().ConfigureAwait(true);
|
||||
OnPropertyChanged(nameof(CanRegisterLayer));
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// What the Agent's rights are, and — beta.10 — why a standard user's Agent is one when the admin mode asked Windows and
|
||||
/// was not granted (<c>HelloAck.ElevationOutcome</c>).
|
||||
/// </summary>
|
||||
internal static string ElevationTextOf(AgentConnectionState state, HelloAck? hello) => hello switch
|
||||
{
|
||||
null => state == AgentConnectionState.Elevating ? Strings.Agent_State_Elevating : Strings.Settings_VkLayer_Unknown,
|
||||
{ Elevated: true } => Strings.Settings_Agent_Elevated,
|
||||
{ ElevationOutcome: AgentElevation.Declined } => Strings.Settings_Agent_ElevationDeclined,
|
||||
{ ElevationOutcome: AgentElevation.OtherAccount } => Strings.Settings_Agent_ElevationOtherAccount,
|
||||
{ ElevationOutcome: AgentElevation.Failed } => Strings.Settings_Agent_ElevationFailed,
|
||||
_ => Strings.Settings_Agent_NotElevated,
|
||||
};
|
||||
|
||||
private async Task RunToolAsync(string flag, string label)
|
||||
{
|
||||
IsToolRunning = true;
|
||||
@@ -410,6 +557,73 @@ public sealed partial class SettingsViewModel : ObservableObject
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>D33: the exception list from the Agent's columns — the App reads them and never writes one.</summary>
|
||||
private void PresentExceptions(IReadOnlyList<GameCard> cards)
|
||||
{
|
||||
ExceptionGames.Clear();
|
||||
bool checking = false;
|
||||
foreach (GameCard card in cards.Where(static c => c.Row.InLibrary).OrderBy(static c => c.Row.Name, StringComparer.CurrentCultureIgnoreCase))
|
||||
{
|
||||
if (ExceptionView.Of(card.Row) is not { } view)
|
||||
{
|
||||
continue;
|
||||
}
|
||||
|
||||
checking |= view.Kind == ExceptionViewKind.Checking;
|
||||
// With the option off only a kept grant is listed (suspended): nothing may be made while it is off. On, a row is
|
||||
// listed only when it has an action — make or withdraw (2026-10-03: a game that can never qualify was listed with
|
||||
// none, and its page says why).
|
||||
bool listed = UserModeExceptions
|
||||
? view.Kind is ExceptionViewKind.Granted or ExceptionViewKind.Eligible
|
||||
: view.Kind == ExceptionViewKind.Granted;
|
||||
if (listed)
|
||||
{
|
||||
ExceptionGames.Add(new ExceptionGameViewModel(card.Row.Id, card.Row.Name, view, GrantExceptionAsync, WithdrawExceptionAsync));
|
||||
}
|
||||
}
|
||||
|
||||
ExceptionsChecking = UserModeExceptions && checking;
|
||||
OnPropertyChanged(nameof(ExceptionsSuspended));
|
||||
}
|
||||
|
||||
/// <summary>D33: the disclosure, then the request; the Agent gathers the facts and grants or refuses.</summary>
|
||||
private async Task GrantExceptionAsync(ExceptionGameViewModel game)
|
||||
{
|
||||
AntiCheatExceptionResult result = _exceptions is null
|
||||
? AntiCheatExceptionResult.Of(AntiCheatExceptionOutcome.AgentUnavailable)
|
||||
: await _exceptions.GrantAsync(game.GameId, new AntiCheatExceptionFacts(game.Name, game.View.Family ?? string.Empty,
|
||||
game.View.Signal ?? string.Empty)).ConfigureAwait(true);
|
||||
await ReportExceptionAsync(game.Name, result).ConfigureAwait(true);
|
||||
}
|
||||
|
||||
private async Task WithdrawExceptionAsync(ExceptionGameViewModel game)
|
||||
{
|
||||
AntiCheatExceptionResult result = _exceptions is null
|
||||
? AntiCheatExceptionResult.Of(AntiCheatExceptionOutcome.AgentUnavailable)
|
||||
: await _exceptions.WithdrawAsync(game.GameId).ConfigureAwait(true);
|
||||
await ReportExceptionAsync(game.Name, result).ConfigureAwait(true);
|
||||
}
|
||||
|
||||
private async Task ReportExceptionAsync(string name, AntiCheatExceptionResult result)
|
||||
{
|
||||
if (result.MessageFor(name) is { } message)
|
||||
{
|
||||
if (result.Succeeded)
|
||||
{
|
||||
_strip.Success(name, message);
|
||||
}
|
||||
else
|
||||
{
|
||||
_strip.Warn(name, message);
|
||||
}
|
||||
}
|
||||
|
||||
await RefreshCoreAsync().ConfigureAwait(true);
|
||||
}
|
||||
|
||||
[RelayCommand]
|
||||
private Task RefreshExceptionsAsync() => RefreshAsync();
|
||||
|
||||
private async Task RevokeAsync(HookedGameViewModel game)
|
||||
{
|
||||
HookingConsentResult result = await _consent.DisableAsync(game.GameId).ConfigureAwait(true);
|
||||
|
||||
@@ -38,6 +38,11 @@
|
||||
<!-- header line + chips -->
|
||||
<ui:TextBlock Appearance="Secondary" Text="{Binding ViewModel.Line}" />
|
||||
<ui:TextBlock Appearance="Secondary" TextWrapping="Wrap" Text="{Binding ViewModel.ExitLine}" />
|
||||
<ui:TextBlock Appearance="Secondary" TextWrapping="Wrap" Text="{Binding ViewModel.ExceptionLine}"
|
||||
Visibility="{Binding ViewModel.ExceptionLine, Converter={StaticResource NullToCollapsed}}" />
|
||||
<!-- beta.10: how the game was shown, in either tier (03_METRICS §Display mode) -->
|
||||
<ui:TextBlock Appearance="Secondary" TextWrapping="Wrap" Text="{Binding ViewModel.DisplayLine}"
|
||||
Visibility="{Binding ViewModel.DisplayLine, Converter={StaticResource NullToCollapsed}}" />
|
||||
<ui:TextBlock Appearance="Tertiary" TextWrapping="Wrap" Text="{Binding ViewModel.HardwareLine}" />
|
||||
<ui:TextBlock Appearance="Tertiary" TextWrapping="Wrap" Text="{Binding ViewModel.LibrariesLine}"
|
||||
Visibility="{Binding ViewModel.LibrariesLine, Converter={StaticResource NullToCollapsed}}" />
|
||||
|
||||
@@ -10,5 +10,12 @@ public sealed record AntiCheatPreScanReport
|
||||
public int Current { get; init; }
|
||||
public int Unreadable { get; init; }
|
||||
public bool RulesUnusable { get; init; }
|
||||
|
||||
/// <summary>D33: blocked entries whose user-mode exception eligibility the pass (re)wrote.</summary>
|
||||
public int ExceptionsChecked { get; init; }
|
||||
|
||||
/// <summary>D33: exceptions the pass ended — an executable that changed, a game no longer eligible.</summary>
|
||||
public int ExceptionsEnded { get; init; }
|
||||
|
||||
public int Scanned => Found + Clean + Unverified;
|
||||
}
|
||||
@@ -1,3 +1,4 @@
|
||||
using FrameLedger.Application.Capture;
|
||||
using FrameLedger.Application.Consent;
|
||||
using FrameLedger.Application.Detection;
|
||||
using FrameLedger.Application.Ipc;
|
||||
@@ -34,6 +35,13 @@ namespace FrameLedger.Application.AntiCheat;
|
||||
/// session start whatever this sweep wrote, exactly as it did before. It never opens a game's process — the scan
|
||||
/// reads the executable's path, its install folder and the store's files.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>A blocked entry is never scanned for a new block, and since D33 (owner decision 2026-09-26) it is asked one other
|
||||
/// question</b> — whether its user-mode exception may be granted (<see cref="ExceptionPassAsync"/>): while the option is
|
||||
/// on, a tolerant pre-scan naming the block's family, keyed like the pre-scan so it re-runs only when the rules, the
|
||||
/// executable or the block change, and a count of the successful Tier-1 sessions. With the option on or off, a grant
|
||||
/// made on bytes that are no longer on disk ends. Nothing here grants anything or clears a block.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public sealed class AntiCheatPreScanSweep : IDisposable
|
||||
{
|
||||
@@ -44,12 +52,19 @@ public sealed class AntiCheatPreScanSweep : IDisposable
|
||||
private readonly IExecutableIdentitySource _identity;
|
||||
private readonly IIpcEventPublisher? _pipe;
|
||||
private readonly Func<long, bool> _isRecording;
|
||||
private readonly ISessionRepository? _sessions;
|
||||
private readonly IUserModeExceptionSwitch? _exceptions;
|
||||
private readonly Action<string> _log;
|
||||
private readonly SemaphoreSlim _wake = new(0, 1);
|
||||
|
||||
public AntiCheatPreScanSweep(IGameRepository games, IGameConsentStore consent, IAntiCheatGuard guard, IDetectionRulesSource rules,
|
||||
IExecutableIdentitySource identity, Action<string> log, IIpcEventPublisher? pipe = null, Func<long, bool>? isRecording = null)
|
||||
IExecutableIdentitySource identity, Action<string> log, IIpcEventPublisher? pipe = null, Func<long, bool>? isRecording = null,
|
||||
ISessionRepository? sessions = null, IUserModeExceptionSwitch? exceptions = null)
|
||||
{
|
||||
// D33: the evidence and the option the exception pass needs; a sweep composed without them asks no exception
|
||||
// question at all (the unshipped host, the tests that are not about it).
|
||||
_sessions = sessions;
|
||||
_exceptions = exceptions;
|
||||
_games = games ?? throw new ArgumentNullException(nameof(games));
|
||||
_consent = consent ?? throw new ArgumentNullException(nameof(consent));
|
||||
_guard = guard ?? throw new ArgumentNullException(nameof(guard));
|
||||
@@ -98,8 +113,9 @@ public sealed class AntiCheatPreScanSweep : IDisposable
|
||||
ct.ThrowIfCancellationRequested();
|
||||
if (game.BlockedByGuard)
|
||||
{
|
||||
// A block is final: nothing scans it again, and nothing this sweep writes could read as clearing it.
|
||||
report = report with { Blocked = report.Blocked + 1 };
|
||||
// A block is final: nothing scans it for a new one, and nothing this sweep writes could read as clearing
|
||||
// it. What is asked of it since D33 is whether its user-mode exception may be granted.
|
||||
report = await ExceptionPassAsync(game, rulesVersion, report with { Blocked = report.Blocked + 1 }, ct).ConfigureAwait(false);
|
||||
continue;
|
||||
}
|
||||
|
||||
@@ -124,7 +140,7 @@ public sealed class AntiCheatPreScanSweep : IDisposable
|
||||
private async ValueTask<AntiCheatPreScanReport> ScanAsync(GameRow game, ExecutableFingerprint onDisk, string rulesVersion,
|
||||
AntiCheatPreScanReport report, CancellationToken ct)
|
||||
{
|
||||
AntiCheatVerdict verdict = await _guard.PreScanGameAsync(onDisk.ExePath, ct).ConfigureAwait(false);
|
||||
AntiCheatVerdict verdict = await _guard.PreScanGameAsync(onDisk.ExePath, toleratedFamily: null, ct).ConfigureAwait(false);
|
||||
if (await _consent.RecordPreScanAsync(onDisk, verdict, rulesVersion, ct).ConfigureAwait(false) != ConsentWriteOutcome.Written)
|
||||
{
|
||||
return report;
|
||||
@@ -150,6 +166,119 @@ public sealed class AntiCheatPreScanSweep : IDisposable
|
||||
: report with { Unverified = report.Unverified + 1 };
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// D33: the exception question about one BLOCKED entry. A grant made on bytes that are no longer on disk ends whether
|
||||
/// or not the option is on; the rest runs only while it is — a tolerant pre-scan naming the block's family when the
|
||||
/// rules, the executable or the block changed since the last one, and (D38) the trial's progress under the grant in
|
||||
/// force every pass — and ends a grant the facts no longer support. A scan that could not answer ends nothing: the
|
||||
/// session start runs the full check anyway.
|
||||
/// </summary>
|
||||
private async ValueTask<AntiCheatPreScanReport> ExceptionPassAsync(GameRow game, string rulesVersion, AntiCheatPreScanReport report,
|
||||
CancellationToken ct)
|
||||
{
|
||||
if (_sessions is null || game.HookBlockedReason is not { Length: > 0 } block || _isRecording(game.Id))
|
||||
{
|
||||
return report;
|
||||
}
|
||||
|
||||
if (_identity.Read(game.Fingerprint.ExePath) is not { } onDisk)
|
||||
{
|
||||
return await UnreadableAsync(game, block, rulesVersion, report, ct).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
AntiCheatExceptionState state = game.AcException;
|
||||
bool granted = state.IsGranted;
|
||||
if (granted && !state.GrantCovers(onDisk))
|
||||
{
|
||||
report = await EndAsync(game, UserModeExceptionLapse.ExecutableChanged, "its executable changed", report, ct).ConfigureAwait(false);
|
||||
granted = false;
|
||||
}
|
||||
|
||||
if (_exceptions is null || !await _exceptions.IsOnAsync(ct).ConfigureAwait(false))
|
||||
{
|
||||
return report;
|
||||
}
|
||||
|
||||
StoredBlock? parsed = StoredBlock.Parse(block);
|
||||
// D38: the trial's progress under the grant in force — what the App shows; eligibility no longer counts sessions.
|
||||
int sessions = granted && state.Family is { Length: > 0 } family && state.GrantedAt is { } grantedAt
|
||||
? await _sessions.CountSuccessfulUnderGrantAsync(game.Id, family, grantedAt, ct).ConfigureAwait(false)
|
||||
: 0;
|
||||
bool fresh = state.IsCheckedFor(onDisk, rulesVersion, block);
|
||||
AntiCheatVerdict? verdict = parsed is not { IsExceptionable: true } b
|
||||
? null
|
||||
: fresh && StoredVerdict(state.Verdict) is { } stored
|
||||
? stored
|
||||
: await _guard.PreScanGameAsync(onDisk.ExePath, b.Family, ct).ConfigureAwait(false);
|
||||
|
||||
bool eligible = verdict is { } v && UserModeExceptionRules.IsEligible(parsed, v, state.TrialFailed);
|
||||
if (!fresh || eligible != state.Eligible || sessions != state.Sessions)
|
||||
{
|
||||
if (await _consent.RecordExceptionEligibilityAsync(onDisk, block, verdict, sessions, rulesVersion, ct).ConfigureAwait(false)
|
||||
== ConsentWriteOutcome.Written)
|
||||
{
|
||||
report = report with { ExceptionsChecked = report.ExceptionsChecked + 1 };
|
||||
_log($"prescan: {game.Name} — user-mode exception {(eligible ? "eligible" : "not eligible")} "
|
||||
+ $"({(verdict is { } said ? Said(said) : "not a module, file or folder finding")}"
|
||||
+ (state.TrialFailed ? "; an earlier exception failed its trial" : string.Empty)
|
||||
+ (granted ? $"; trial {sessions} of {UserModeExceptionRules.TrialSessions}" : string.Empty) + ")");
|
||||
}
|
||||
}
|
||||
|
||||
bool couldNotVerify = verdict is { IsAllowed: false, IsFindingAboutTheGame: false };
|
||||
return granted && !eligible && !couldNotVerify
|
||||
? await EndAsync(game, UserModeExceptionLapse.NoLongerEligible, "the game is no longer eligible", report, ct).ConfigureAwait(false)
|
||||
: report;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 2026-10-03: a blocked entry whose executable cannot be read is ANSWERED while the option is on — "the check could not
|
||||
/// run" (<c>PreScanFailed</c>, no family), keyed on no bytes so the first readable pass scans again — rather than left
|
||||
/// "checking" for ever, which is what returning early did. A grant is left alone: the session start runs the full check.
|
||||
/// </summary>
|
||||
private async ValueTask<AntiCheatPreScanReport> UnreadableAsync(GameRow game, string block, string rulesVersion, AntiCheatPreScanReport report,
|
||||
CancellationToken ct)
|
||||
{
|
||||
AntiCheatExceptionState state = game.AcException;
|
||||
if (_exceptions is null || state.IsGranted || !await _exceptions.IsOnAsync(ct).ConfigureAwait(false))
|
||||
{
|
||||
return report;
|
||||
}
|
||||
|
||||
if (string.Equals(state.CheckedBlock, block, StringComparison.Ordinal)
|
||||
&& StoredBlock.Parse(state.Verdict) is { Reason: AntiCheatRefusalReason.PreScanFailed, Family.Length: 0 })
|
||||
{
|
||||
return report; // already said, and nothing has changed that a pass could see
|
||||
}
|
||||
|
||||
var nothingRead = new ExecutableFingerprint { ExePath = game.Fingerprint.ExePath, SizeBytes = 0, MtimeUnixMs = 0 };
|
||||
AntiCheatVerdict couldNotRun = AntiCheatVerdict.Refused(AntiCheatRefusalReason.PreScanFailed, string.Empty, Path.GetFileName(game.Fingerprint.ExePath));
|
||||
if (await _consent.RecordExceptionEligibilityAsync(nothingRead, block, couldNotRun, 0, rulesVersion, ct).ConfigureAwait(false) == ConsentWriteOutcome.Written)
|
||||
{
|
||||
_log($"prescan: {game.Name} — user-mode exception not checked: the executable could not be read");
|
||||
report = report with { ExceptionsChecked = report.ExceptionsChecked + 1 };
|
||||
}
|
||||
|
||||
return report;
|
||||
}
|
||||
|
||||
private async ValueTask<AntiCheatPreScanReport> EndAsync(GameRow game, string lapse, string why, AntiCheatPreScanReport report, CancellationToken ct)
|
||||
{
|
||||
if (await _consent.RevokeAntiCheatExceptionAsync(game.Fingerprint.ExePath, lapse, ct: ct).ConfigureAwait(false) != ConsentWriteOutcome.Written)
|
||||
{
|
||||
return report;
|
||||
}
|
||||
|
||||
_log($"prescan: {game.Name} — user-mode exception ended: {why} ({lapse})");
|
||||
return report with { ExceptionsEnded = report.ExceptionsEnded + 1 };
|
||||
}
|
||||
|
||||
/// <summary>A stored tolerant verdict (<c>Reason|Family|Signal</c>) back as the verdict it was; null when it cannot be read.</summary>
|
||||
private static AntiCheatVerdict? StoredVerdict(string? stored) =>
|
||||
StoredBlock.Parse(stored) is { } v ? AntiCheatVerdict.FromNative((int)v.Reason, v.Family, v.Signal) : null;
|
||||
|
||||
private static string Said(AntiCheatVerdict v) => $"{v.Reason} {v.Family} {v.Signal}".Trim();
|
||||
|
||||
/// <summary>The pre-scan's own key (schema 0010) against the rules and the file right now: any difference is a re-scan.</summary>
|
||||
public static bool IsStale(GameRow game, ExecutableFingerprint onDisk, string rulesVersion)
|
||||
{
|
||||
|
||||
@@ -23,10 +23,16 @@ namespace FrameLedger.Application.AntiCheat;
|
||||
/// the far side of a returned verdict.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public sealed class GuardSupervisor(IAntiCheatGuard guard)
|
||||
public sealed class GuardSupervisor(IAntiCheatGuard guard, string? toleratedFamily = null)
|
||||
{
|
||||
private readonly IAntiCheatGuard _guard = guard ?? throw new ArgumentNullException(nameof(guard));
|
||||
|
||||
/// <summary>
|
||||
/// D33: the family the session's user-mode exception covers, named to every re-scan exactly as it was to the injection
|
||||
/// — the guard still honours it only for a user-mode family and refuses on anything else. Null for every other session.
|
||||
/// </summary>
|
||||
public string? ToleratedFamily { get; } = toleratedFamily;
|
||||
|
||||
/// <summary>
|
||||
/// Completed guard evaluations. Published to <c>FlControlBlock.guardTicks</c>.
|
||||
/// </summary>
|
||||
@@ -66,7 +72,7 @@ public sealed class GuardSupervisor(IAntiCheatGuard guard)
|
||||
return false;
|
||||
}
|
||||
|
||||
AntiCheatVerdict verdict = await _guard.EvaluateAsync(targetPid, ct).ConfigureAwait(false);
|
||||
AntiCheatVerdict verdict = await _guard.EvaluateAsync(targetPid, ToleratedFamily, ct).ConfigureAwait(false);
|
||||
|
||||
// THE ONE SITE. Everything above can fail, throw or cancel; nothing
|
||||
// below runs unless a verdict actually came back.
|
||||
|
||||
@@ -31,8 +31,9 @@ namespace FrameLedger.Application.AntiCheat;
|
||||
public sealed class HookRequest
|
||||
{
|
||||
private HookRequest(int targetPid, string payloadPath, bool hookEnabled, DateTimeOffset? consentedAt,
|
||||
string? blockedReason, int waitForPresentationRuntimeMs, bool killSwitchEngaged)
|
||||
string? blockedReason, int waitForPresentationRuntimeMs, bool killSwitchEngaged, string? toleratedFamily = null)
|
||||
{
|
||||
ToleratedFamily = toleratedFamily;
|
||||
TargetPid = targetPid;
|
||||
PayloadPath = payloadPath;
|
||||
HookEnabled = hookEnabled;
|
||||
@@ -86,6 +87,17 @@ public sealed class HookRequest
|
||||
/// <summary><c>games.hook_blocked_reason</c>; non-null means the toggle is disabled.</summary>
|
||||
public string? BlockedReason { get; }
|
||||
|
||||
/// <summary>
|
||||
/// D33 (owner decision 2026-09-26): the anti-cheat family the game's user-mode exception covers for THIS session, or
|
||||
/// null — the NAME the gate hands the guard, which decides itself whether to honour it.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// Set only by <see cref="FromConsent"/>, from the stored grant, and only when the caller says the exception is in force
|
||||
/// for this session — the option is on and the Overlay's channel exists (<see cref="UserModeExceptionRules.CoveredFamily"/>).
|
||||
/// Without it a blocked game is refused before the guard is asked, exactly as before D33.
|
||||
/// </remarks>
|
||||
public string? ToleratedFamily { get; }
|
||||
|
||||
/// <summary>
|
||||
/// Build the request the gate evaluates, from a stored record and the executable
|
||||
/// as it is on disk right now.
|
||||
@@ -96,9 +108,13 @@ public sealed class HookRequest
|
||||
/// <param name="payloadPath">The Overlay, resolved beside the guard (§S22).</param>
|
||||
/// <param name="waitForPresentationRuntimeMs">Launch mode's budget; zero is attach mode.</param>
|
||||
/// <param name="killSwitchEngaged">FR-2.4's global switch as read from the settings store just now (decision D7).</param>
|
||||
/// <param name="exceptionInForce">
|
||||
/// D33: <c>hooking.usermode_ac_exceptions</c> is on AND the Overlay's tolerance channel was published for this pid. False
|
||||
/// — the default, and every caller before D33 — asks the guard to tolerate nothing.
|
||||
/// </param>
|
||||
public static HookRequest FromConsent(
|
||||
GameConsentRecord record, ExecutableFingerprint observed, int targetPid, string payloadPath,
|
||||
int waitForPresentationRuntimeMs = 0, bool killSwitchEngaged = false)
|
||||
int waitForPresentationRuntimeMs = 0, bool killSwitchEngaged = false, bool exceptionInForce = false)
|
||||
{
|
||||
ArgumentException.ThrowIfNullOrWhiteSpace(payloadPath);
|
||||
ArgumentOutOfRangeException.ThrowIfNegative(waitForPresentationRuntimeMs);
|
||||
@@ -129,7 +145,9 @@ public sealed class HookRequest
|
||||
consentedAt = null;
|
||||
}
|
||||
|
||||
// THE FAMILY COMES FROM THE STORED GRANT, never from a caller: the caller can only say whether the exception is in
|
||||
// force this session, which can only turn it off.
|
||||
return new HookRequest(targetPid, payloadPath, record.HookEnabled, consentedAt, record.BlockedReason,
|
||||
waitForPresentationRuntimeMs, killSwitchEngaged);
|
||||
waitForPresentationRuntimeMs, killSwitchEngaged, UserModeExceptionRules.CoveredFamily(record, observed, exceptionInForce));
|
||||
}
|
||||
}
|
||||
@@ -78,7 +78,7 @@ public sealed class HookedCaptureGate(IAntiCheatGuard guard)
|
||||
"the per-game consent dialog has not been accepted");
|
||||
}
|
||||
|
||||
if (request.BlockedReason is { Length: > 0 } blocked)
|
||||
if (request.BlockedReason is { Length: > 0 } blocked && request.ToleratedFamily is null)
|
||||
{
|
||||
// 19_SAFETY §A game already enabled can become blocked later: a
|
||||
// patch adds anti-cheat, or updated rules newly match. hook_enabled
|
||||
@@ -87,11 +87,15 @@ public sealed class HookedCaptureGate(IAntiCheatGuard guard)
|
||||
return AntiCheatVerdict.Refused(AntiCheatRefusalReason.PreviouslyBlocked, "previously blocked", blocked);
|
||||
}
|
||||
|
||||
// D33 (owner decision 2026-09-26): a blocked game reaches the guard only under its user-mode exception, and then
|
||||
// with the family NAMED — the guard honours it only for a family that is user-mode throughout, runs every check
|
||||
// and keeps scanning past what it lets through. Every other game names none, which is the strict guard of before.
|
||||
//
|
||||
// Launch mode is the same gate reached through the guard's WAITING entry: the consent checks
|
||||
// above are identical, and what differs is only WHEN the guard's full scan runs (P1 item 2).
|
||||
return request.WaitForPresentationRuntimeMs > 0
|
||||
? await _guard.GuardedInjectWhenReadyAsync(request.TargetPid, request.PayloadPath,
|
||||
request.WaitForPresentationRuntimeMs, ct).ConfigureAwait(false)
|
||||
: await _guard.GuardedInjectAsync(request.TargetPid, request.PayloadPath, ct).ConfigureAwait(false);
|
||||
request.WaitForPresentationRuntimeMs, request.ToleratedFamily, ct).ConfigureAwait(false)
|
||||
: await _guard.GuardedInjectAsync(request.TargetPid, request.PayloadPath, request.ToleratedFamily, ct).ConfigureAwait(false);
|
||||
}
|
||||
}
|
||||
@@ -19,6 +19,14 @@ namespace FrameLedger.Application.AntiCheat;
|
||||
/// then passes to an injector. <see cref="GuardedInjectAsync"/> injects, or
|
||||
/// refuses. The guard owns the chokepoint (§S13(b)).
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// <b>Every method takes <c>toleratedFamily</c> since D33 (owner decision 2026-09-26)</b> — the NAME of the one anti-cheat
|
||||
/// family a game's user-mode exception covers, or null for none, and required rather than defaulted so every caller
|
||||
/// states which it means. It is a name and never evidence: the guard resolves it against its own rules, honours it only
|
||||
/// for a family whose every signal is user-mode, runs every check and keeps scanning past what it lets through
|
||||
/// (<c>19_SAFETY</c> §The user-mode exception). A pass that let something through is
|
||||
/// <see cref="AntiCheatRefusalReason.AllowedUnderUserModeException"/>.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public interface IAntiCheatGuard
|
||||
{
|
||||
@@ -27,14 +35,14 @@ public interface IAntiCheatGuard
|
||||
/// in-session re-scan of <c>19_SAFETY</c> §During a session, which must
|
||||
/// reach a verdict about a process we are already inside.
|
||||
/// </summary>
|
||||
ValueTask<AntiCheatVerdict> EvaluateAsync(int targetPid, CancellationToken ct = default);
|
||||
ValueTask<AntiCheatVerdict> EvaluateAsync(int targetPid, string? toleratedFamily, CancellationToken ct = default);
|
||||
|
||||
/// <summary>
|
||||
/// Run every check and, only on a pass, inject. There is no overload that
|
||||
/// skips the checks and no way to supply evidence — the guard collects its
|
||||
/// own, so a caller can ask but only the guard answers.
|
||||
/// </summary>
|
||||
ValueTask<AntiCheatVerdict> GuardedInjectAsync(int targetPid, string payloadPath, CancellationToken ct = default);
|
||||
ValueTask<AntiCheatVerdict> GuardedInjectAsync(int targetPid, string payloadPath, string? toleratedFamily, CancellationToken ct = default);
|
||||
|
||||
/// <summary>
|
||||
/// Launch mode (P1 item 2). Wait — up to <paramref name="timeoutMs"/> — until the target has mapped a
|
||||
@@ -50,7 +58,7 @@ public interface IAntiCheatGuard
|
||||
/// <see cref="AntiCheatRefusalReason.LaunchNoPresentationRuntime"/>. The caller launched and holds
|
||||
/// the process; the guard creates and terminates nothing.
|
||||
/// </remarks>
|
||||
ValueTask<AntiCheatVerdict> GuardedInjectWhenReadyAsync(int targetPid, string payloadPath, int timeoutMs,
|
||||
ValueTask<AntiCheatVerdict> GuardedInjectWhenReadyAsync(int targetPid, string payloadPath, int timeoutMs, string? toleratedFamily,
|
||||
CancellationToken ct = default);
|
||||
|
||||
/// <summary>
|
||||
@@ -79,5 +87,5 @@ public interface IAntiCheatGuard
|
||||
/// on passing while the thing it guards grew somewhere else.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
ValueTask<AntiCheatVerdict> PreScanGameAsync(string executablePath, CancellationToken ct = default);
|
||||
ValueTask<AntiCheatVerdict> PreScanGameAsync(string executablePath, string? toleratedFamily, CancellationToken ct = default);
|
||||
}
|
||||
@@ -0,0 +1,36 @@
|
||||
namespace FrameLedger.Application.AntiCheat;
|
||||
|
||||
/// <summary>
|
||||
/// D33: why a user-mode exception ended — <c>games.ac_exception_lapsed_reason</c>, one of these words, which the App
|
||||
/// says in the user's language (<c>19_SAFETY</c> §The user-mode exception, What ends it).
|
||||
/// </summary>
|
||||
public static class UserModeExceptionLapse
|
||||
{
|
||||
/// <summary>The user withdrew it.</summary>
|
||||
public const string Withdrawn = "Withdrawn";
|
||||
|
||||
/// <summary>The executable is not the one the grant was made on: a game update, or <i>Change executable</i>.</summary>
|
||||
public const string ExecutableChanged = "ExecutableChanged";
|
||||
|
||||
/// <summary>The guard no longer lets the game through under it: a new finding, a <c>.sys</c>, the family turned kernel-level.</summary>
|
||||
public const string NoLongerEligible = "NoLongerEligible";
|
||||
|
||||
/// <summary>A finding about the game at a session's start, at the 30 s re-scan or when hooking was turned on.</summary>
|
||||
public const string NewFinding = "NewFinding";
|
||||
|
||||
/// <summary>A session under it was unhooked for safety by the 30 s re-scan.</summary>
|
||||
public const string SafetyUnhook = "SafetyUnhook";
|
||||
|
||||
/// <summary>The Overlay stopped observing on its own: another anti-cheat's module loaded in the game.</summary>
|
||||
public const string OverlayStopped = "OverlayStopped";
|
||||
|
||||
/// <summary>A session under it ended in a crash.</summary>
|
||||
public const string SessionCrashed = "SessionCrashed";
|
||||
|
||||
/// <summary>
|
||||
/// D38: a session in its trial did not succeed — hooked and stored, but it recorded no frame or did not end normally —
|
||||
/// and nothing more specific said why. Any end during the trial, this one or another, also marks the game so that no
|
||||
/// exception can be made for it again (<c>games.ac_exception_trial_failed_at</c>).
|
||||
/// </summary>
|
||||
public const string TrialFailed = "TrialFailed";
|
||||
}
|
||||
Loaded 100 of 264 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user