Tunglies
a0ce1cdadf
* chore(perf): use the external measurement harness Keep real Traffic, Logs and Connections scenes and the isolated native entry beside product APIs. Invoke the standalone runner with an explicit project path and remove bundled measurement orchestration. Support the optional owned virtual display and read-only isolation snapshots without changing ordinary product startup or networking. * docs: scope agent guidance to the active task Keep behavior and ownership guidance with the relevant task routes, including the external performance adapter workflow. Preserve focused self-review for routine changes and independent review where required. * docs(perf): link the standalone harness repository Link the harness repository and operating guide, and document first-time checkout setup while preserving explicit paths for routine invocation. * fix(perf): account for external harness dependencies in Knip * chore(perf): keep tool dependencies and guidance outside the product * docs(perf): keep product guidance focused on the adapter
2.2 KiB
Product measurement adapter
This directory owns the isolated native entry, real Traffic/Logs/Connections imports, initialization, JavaScript socket adapter, replay receiver and minimal DOM layer. These evolve with product APIs and use the product's React/Tauri/Wry versions. Keep the explicit perf build gates; ordinary builds need no external tool.
The external clash-verge-rev-harness operating guide owns running, sampling, reports, comparison and owned cleanup. Follow its first setup and installation instructions, reusing an existing checkout. For subsequent calls, pass both absolute roots:
project=/absolute/path/to/clash-verge-rev
harness=/absolute/path/to/clash-verge-rev-harness
node "$harness/build.mjs" --project "$project" --output target/perf/build
caffeinate -di node "$harness/run.mjs" --project "$project" --binary target/perf/build/clash-verge --output target/perf/smoke --repeat 1 --seconds 5 --warmup 2
node "$harness/compare.mjs" "$project/target/perf/smoke" "$project/target/perf/smoke"
JavaScript socket replacement does not measure native plugin IPC. DOM mutation/text hashes show view-input delivery, not painting or cache ownership. Adapter changes require reviewing measurement meaning under the external validation requirements.
For virtual display mode, this adapter places only the hidden measurement window on the exact owned NSScreen, checks complete visibleFrame containment, mode/Space flags and nonactivation, and exits on drift. The tool owns helper lifecycle and topology restoration; see its virtual display guide.
isolation.json owns the product configuration and process watch scope; keep it
aligned with product data directories and executable names. The tool owns
command isolation snapshots.
The adapter must not load daily configuration or control Core, Service, TUN, DNS
or system proxy.