Skip to content

👾 Open Computer Use – Open-Source Alternative to Codex Computer Use

Run smoke fixture headlessly

Leo8b5e720c7281
diff --git a/apps/OpenComputerUseFixture/Sources/OpenComputerUseFixture/main.swift b/apps/OpenComputerUseFixture/Sources/OpenComputerUseFixture/main.swift
index f09eb5a..1f02d00 100644
--- a/apps/OpenComputerUseFixture/Sources/OpenComputerUseFixture/main.swift
+++ b/apps/OpenComputerUseFixture/Sources/OpenComputerUseFixture/main.swift
@@ -90,12 +90,19 @@ final class FixtureAppDelegate: NSObject, NSApplicationDelegate, NSTextFieldDele
private var counter = 0
private weak var observedScrollView: NSScrollView?
private var commandObserver: NSObjectProtocol?
+ private let headless: Bool
+
+ init(headless: Bool) {
+ self.headless = headless
+ }
func applicationDidFinishLaunching(_ notification: Notification) {
buildWindow()
startCommandObserver()
updateExportedState()
- NSApp.activate(ignoringOtherApps: true)
+ if !headless {
+ NSApp.activate(ignoringOtherApps: true)
+ }
}
func applicationWillTerminate(_ notification: Notification) {
@@ -183,7 +190,11 @@ final class FixtureAppDelegate: NSObject, NSApplicationDelegate, NSTextFieldDele
inputField.widthAnchor.constraint(equalToConstant: 320),
])
- window.makeKeyAndOrderFront(nil)
+ if headless {
+ window.orderOut(nil)
+ } else {
+ window.makeKeyAndOrderFront(nil)
+ }
}
@objc
@@ -422,10 +433,20 @@ enum OpenComputerUseFixtureMain {
@MainActor
static func main() {
let application = NSApplication.shared
- application.setActivationPolicy(.regular)
- let delegate = FixtureAppDelegate()
+ let headless = fixtureHeadlessMode()
+ application.setActivationPolicy(headless ? .accessory : .regular)
+ let delegate = FixtureAppDelegate(headless: headless)
Self.delegate = delegate
application.delegate = delegate
application.run()
}
}
+
+private func fixtureHeadlessMode(environment: [String: String] = ProcessInfo.processInfo.environment) -> Bool {
+ switch environment["OPEN_COMPUTER_USE_FIXTURE_HEADLESS"]?.lowercased() {
+ case "1", "true", "yes", "on":
+ return true
+ default:
+ return false
+ }
+}
diff --git a/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift b/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift
index 032c04d..8a63f02 100644
--- a/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift
+++ b/apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift
@@ -168,6 +168,7 @@ enum OpenComputerUseSmokeSuite {
let fixture = Process()
fixture.executableURL = fixtureURL
+ fixture.environment = smokeFixtureEnvironment()
fixture.standardOutput = Pipe()
fixture.standardError = Pipe()
try fixture.run()
@@ -350,6 +351,12 @@ enum OpenComputerUseSmokeSuite {
return environment
}
+ private static func smokeFixtureEnvironment() -> [String: String] {
+ var environment = ProcessInfo.processInfo.environment
+ environment["OPEN_COMPUTER_USE_FIXTURE_HEADLESS"] = "1"
+ return environment
+ }
+
private static func locateProductsDirectory() throws -> URL {
let executableURL = URL(fileURLWithPath: CommandLine.arguments[0]).resolvingSymlinksInPath()
return executableURL.deletingLastPathComponent()
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 05d92ac..b01a964 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -133,7 +133,7 @@
- 单元测试:`swift test`
- standalone cursor 构建:`swift build --product StandaloneCursor`
- cursor lab 构建:`swift build --product CursorMotion`
-- 端到端 smoke:`./scripts/run-tool-smoke-tests.sh`(标准 9-tool smoke + visual cursor idle smoke)
+- 端到端 smoke:`./scripts/run-tool-smoke-tests.sh`(标准 9-tool smoke + visual cursor idle smoke;脚本默认以 headless 模式启动内部 fixture,避免在用户桌面弹出测试窗口)
- app 打包:`./scripts/build-open-computer-use-app.sh debug`
- npm staging:`node ./scripts/npm/build-packages.mjs`
- release tgz:`./scripts/release-package.sh`
diff --git a/docs/histories/2026-05/20260508-1045-headless-smoke-fixture.md b/docs/histories/2026-05/20260508-1045-headless-smoke-fixture.md
new file mode 100644
index 0000000..6390039
--- /dev/null
+++ b/docs/histories/2026-05/20260508-1045-headless-smoke-fixture.md
@@ -0,0 +1,27 @@
+## [2026-05-08 10:45] | Task: Headless smoke fixture
+
+### Execution Context
+* **Agent ID**: `Codex`
+* **Base Model**: `GPT-5`
+* **Runtime**: `Codex CLI`
+
+### User Query
+> `./scripts/run-tool-smoke-tests.sh` 每次运行都会出现橙色弹窗,去掉这个不必要的窗口。
+
+### Changes Overview
+**Scope:** OpenComputerUseFixture, OpenComputerUseSmokeSuite, OpenComputerUseKit, docs
+
+**Key Actions:**
+- **Headless fixture mode**: 为 smoke fixture 增加 `OPEN_COMPUTER_USE_FIXTURE_HEADLESS` 开关,headless 时不激活、不置前窗口。
+- **Smoke runner default**: smoke suite 启动 fixture 时默认注入 headless 环境变量。
+- **Discovery compatibility**: 允许内部 fixture 即使以 accessory activation policy 运行也能被测试发现。
+- **Architecture docs**: 记录 smoke 脚本默认使用 headless fixture,避免在用户桌面弹出测试窗口。
+
+### Design Intent (Why)
+smoke 测试需要真实 fixture 承载 AX 控件和测试命令,但不需要把可见测试窗口弹到用户桌面。将 headless 作为 fixture 的显式环境开关,可以让脚本默认安静运行,同时保留手动调试时打开可见窗口的能力。
+
+### Files Modified
+- `apps/OpenComputerUseFixture/Sources/OpenComputerUseFixture/main.swift`
+- `apps/OpenComputerUseSmokeSuite/Sources/OpenComputerUseSmokeSuite/main.swift`
+- `packages/OpenComputerUseKit/Sources/OpenComputerUseKit/AppDiscovery.swift`
+- `docs/ARCHITECTURE.md`
diff --git a/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/AppDiscovery.swift b/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/AppDiscovery.swift
index 0d2e164..ba97d72 100644
--- a/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/AppDiscovery.swift
+++ b/packages/OpenComputerUseKit/Sources/OpenComputerUseKit/AppDiscovery.swift
@@ -363,7 +363,11 @@ enum AppDiscovery {
}
private static func isUserFacingListApp(_ app: NSRunningApplication) -> Bool {
- app.activationPolicy == .regular
+ if appName(app) == FixtureBridge.appName {
+ return true
+ }
+
+ return app.activationPolicy == .regular
}
private static func bundleDisplayName(_ bundle: Bundle?) -> String? {