feat(computer-use): add a headless X11/i3 environment

Give the idols-ruby and idols-kana VMs a headless computer-use
environment: Xvfb plus i3, driven by cua-driver (and computer-use-linux
as a fallback). Includes the system module (AT-SPI, fonts, Mesa, Clash
Verge proxy, proxy-region timezone), the home i3 module (Xvfb/i3/x11vnc
services, browser flags), host wiring and an eval test.
This commit is contained in:
Ryan Yin committed 2026-09-21 21:31:27 +08:00
1 parent 90761a6b73
commit 00aab5f562
11 files changed
+316 -2

No files matched your search

+58
View File
@@ -0,0 +1,58 @@
{
config,
lib,
pkgs,
pkgs-master,
myvars,
...
}:
let
cfg = config.modules.desktop.computerUse;
username = myvars.username;
# Keep the guest timezone consistent with the proxy's exit region. A
# China-based timezone with a US/JP exit IP is a strong automation signal.
timeZone = if cfg.proxyRegion == "jp" then "Asia/Tokyo" else "America/Los_Angeles";
in
{
options.modules.desktop.computerUse = {
enable = lib.mkEnableOption "headless computer-use environment (X11 + desktop automation)";
proxyRegion = lib.mkOption {
type = lib.types.enum [
"us"
"jp"
];
default = "us";
description = "Proxy exit region; keeps the timezone consistent with the egress IP.";
};
};
config = lib.mkIf cfg.enable {
users.users."${username}".linger = true;
# computer-use-linux / cua-driver read the AT-SPI accessibility tree.
services.gnome.at-spi2-core.enable = true;
# A sparse font set is itself a browser fingerprinting signal, so ship the
# same rich font set the desktops use.
modules.desktop.fonts.enable = true;
# Mesa userspace (software GL for X11).
hardware.graphics.enable = true;
# Match the proxy's exit region.
time.timeZone = lib.mkForce timeZone;
# Browsers keep their profile/preferences in dconf.
programs.dconf.enable = true;
# Clash Verge provides the proxy. Its core is started by the GUI, which is
# launched inside the session; service mode + TUN mode come from the module.
programs.clash-verge = {
enable = true;
package = pkgs-master.clash-verge-rev;
serviceMode = true;
tunMode = true;
};
};
}