Skip to content

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

Refine macOS app icon sizing

Leo2a7ade2ae0e9
diff --git a/apps/OpenComputerUse/Sources/OpenComputerUse/PermissionOnboardingApp.swift b/apps/OpenComputerUse/Sources/OpenComputerUse/PermissionOnboardingApp.swift
index 7cb61cc..c01960c 100644
--- a/apps/OpenComputerUse/Sources/OpenComputerUse/PermissionOnboardingApp.swift
+++ b/apps/OpenComputerUse/Sources/OpenComputerUse/PermissionOnboardingApp.swift
@@ -1154,8 +1154,9 @@ enum Branding {
let image = NSImage(size: NSSize(width: size, height: size))
image.lockFocus()
- let rect = CGRect(origin: .zero, size: image.size)
- let tile = NSBezierPath(roundedRect: rect, xRadius: size * 0.22, yRadius: size * 0.22)
+ let canvasInset = size * (92.0 / 1024.0)
+ let rect = CGRect(origin: .zero, size: image.size).insetBy(dx: canvasInset, dy: canvasInset)
+ let tile = NSBezierPath(roundedRect: rect, xRadius: rect.width * 0.22, yRadius: rect.height * 0.22)
let gradient = NSGradient(colors: [
NSColor(calibratedRed: 0.12, green: 0.67, blue: 0.99, alpha: 1),
@@ -1164,11 +1165,11 @@ enum Branding {
gradient.draw(in: tile, angle: 20)
func point(_ x: CGFloat, _ y: CGFloat) -> CGPoint {
- CGPoint(x: size * x / 256, y: size * (1 - y / 256))
+ CGPoint(x: rect.minX + rect.width * x / 256, y: rect.minY + rect.height * (1 - y / 256))
}
func scale(_ value: CGFloat) -> CGFloat {
- size * value / 256
+ rect.width * value / 256
}
let arc = NSBezierPath()
diff --git a/assets/app-icons/open-computer-use-1024.png b/assets/app-icons/open-computer-use-1024.png
new file mode 100644
index 0000000..1278cb2
Binary files /dev/null and b/assets/app-icons/open-computer-use-1024.png differ
diff --git a/docs/histories/2026-04/20260420-2028-shrink-app-icon-safe-area.md b/docs/histories/2026-04/20260420-2028-shrink-app-icon-safe-area.md
new file mode 100644
index 0000000..b43ff36
--- /dev/null
+++ b/docs/histories/2026-04/20260420-2028-shrink-app-icon-safe-area.md
@@ -0,0 +1,33 @@
+## [2026-04-20 20:28] | Task: 调整 Cursor Motion 的 Dock 图标尺寸
+
+### 🤖 Execution Context
+* **Agent ID**: `Codex`
+* **Base Model**: `GPT-5`
+* **Runtime**: `Codex CLI / zsh / macOS`
+
+### 📥 User Query
+> “我们调整一下吧,和其他APP一样的宽高”
+
+### 🛠 Changes Overview
+**Scope:** `scripts/`、`apps/`、`docs/`
+
+**Key Actions:**
+- **[收缩 icon 有效画布]**: `scripts/render-open-computer-use-icon.swift` 现在会给 `1024x1024` app icon 母版留出 `92px` 的透明安全边,不再让背景 tile 直接顶满整张画布。
+- **[同步 app 内 branding 几何]**: `apps/OpenComputerUse/Sources/OpenComputerUse/PermissionOnboardingApp.swift` 里的 `Branding.makeAppIconImage` 同步采用相同 inset,避免打包 icon 和 app 内品牌图形几何继续分叉。
+- **[按系统 icon 量级校准]**: 额外对比了本机 `Terminal` / `Notes` / `QuickTime Player` 的 `.icns` 内容边界,确认标准 Apple icon 的水平安全边大约在 `7.8%`,因此把 inset 从初版 `6%` 再调整到更接近系统量级的 `8%`。
+- **[落 checked-in 1024 母版]**: 新增仓库内的 `1024x1024` master PNG,并让打包脚本改走 `master PNG -> .iconset -> .icns` 的 CLI 链路,后续如果还要微调 Dock 观感,只需要修改这一张母版。
+- **[微调 2px optical inset]**: 根据后续肉眼检查,把 `1024x1024` 母版的有效内容边界从约 `81...942` 进一步收敛到 `83...940`,等价于上下左右各再减少约 `2px`。
+- **[微调 1px optical inset]**: 根据 Dock 复查反馈,把母版有效内容边界继续从 `83...940` 收敛到 `84...939`,等价于上下左右各再减少 `1px`。
+- **[改用可见步长继续缩小]**: 因为 `1024` 母版里的 `1px` 映射到 Dock 后肉眼几乎不可见,这次把有效内容边界从 `84...939` 直接收敛到 `92...931`,让 Dock 里能看到明确缩小效果。
+- **[补变更留档]**: 新增这份 history,记录这次针对 Dock 图标有效尺寸的收口。
+
+### 🧠 Design Intent (Why)
+Dock 会统一缩放整个 icon 画布,但不会替不同应用做额外的光学校正。之前我们的 icon 背景直接铺满画布,导致在同一排 Dock 图标里看起来明显更高。把有效图形统一内缩一圈,并对齐到本机 Apple app icon 的常见安全边量级,比继续依赖系统显示结果更稳定;同时把 icon 资产链收口到一张 checked-in `1024x1024` 母版,也能避免后续继续在临时几何脚本里追着 Dock 效果做不可追踪的微调。
+
+### 📁 Files Modified
+- `assets/app-icons/open-computer-use-1024.png`
+- `scripts/build-apple-iconset.sh`
+- `scripts/render-open-computer-use-icon.swift`
+- `scripts/build-open-computer-use-app.sh`
+- `apps/OpenComputerUse/Sources/OpenComputerUse/PermissionOnboardingApp.swift`
+- `docs/histories/2026-04/20260420-2028-shrink-app-icon-safe-area.md`
diff --git a/scripts/build-apple-iconset.sh b/scripts/build-apple-iconset.sh
new file mode 100755
index 0000000..138d9b2
--- /dev/null
+++ b/scripts/build-apple-iconset.sh
@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+usage() {
+ cat <<'EOF'
+Usage: ./scripts/build-apple-iconset.sh <master-1024.png> <output.iconset>
+
+Build a macOS .iconset from a square 1024x1024 PNG master asset.
+EOF
+}
+
+if [[ $# -ne 2 ]]; then
+ usage >&2
+ exit 1
+fi
+
+source_png="$1"
+output_dir="$2"
+
+if [[ ! -f "${source_png}" ]]; then
+ echo "Missing source PNG: ${source_png}" >&2
+ exit 1
+fi
+
+width="$(sips -g pixelWidth "${source_png}" 2>/dev/null | awk '/pixelWidth:/ { print $2 }')"
+height="$(sips -g pixelHeight "${source_png}" 2>/dev/null | awk '/pixelHeight:/ { print $2 }')"
+
+if [[ "${width}" != "1024" || "${height}" != "1024" ]]; then
+ echo "Source PNG must be 1024x1024, got ${width}x${height}: ${source_png}" >&2
+ exit 1
+fi
+
+mkdir -p "${output_dir}"
+
+render_icon() {
+ local size="$1"
+ local destination="$2"
+
+ sips -s format png -z "${size}" "${size}" "${source_png}" --out "${destination}" >/dev/null
+}
+
+render_icon 16 "${output_dir}/icon_16x16.png"
+render_icon 32 "${output_dir}/[email protected]"
+render_icon 32 "${output_dir}/icon_32x32.png"
+render_icon 64 "${output_dir}/[email protected]"
+render_icon 128 "${output_dir}/icon_128x128.png"
+render_icon 256 "${output_dir}/[email protected]"
+render_icon 256 "${output_dir}/icon_256x256.png"
+render_icon 512 "${output_dir}/[email protected]"
+render_icon 512 "${output_dir}/icon_512x512.png"
+cp "${source_png}" "${output_dir}/[email protected]"
diff --git a/scripts/build-open-computer-use-app.sh b/scripts/build-open-computer-use-app.sh
index 9ed7e7f..ddb010c 100755
--- a/scripts/build-open-computer-use-app.sh
+++ b/scripts/build-open-computer-use-app.sh
@@ -239,7 +239,8 @@ release_app_bundle_name="Open Computer Use.app"
development_app_bundle_name="Open Computer Use (Dev).app"
legacy_app_bundle_name="OpenComputerUse.app"
bundle_icon_name="OpenComputerUse.icns"
-icon_render_script="${repo_root}/scripts/render-open-computer-use-icon.swift"
+icon_master_png="${repo_root}/assets/app-icons/open-computer-use-1024.png"
+iconset_build_script="${repo_root}/scripts/build-apple-iconset.sh"
bundle_display_name="Open Computer Use"
bundle_identifier="com.ifuryst.opencomputeruse"
@@ -288,6 +289,16 @@ esac
chmod +x "${macos_dir}/OpenComputerUse"
+if [[ ! -f "${icon_master_png}" ]]; then
+ echo "Missing icon master PNG: ${icon_master_png}" >&2
+ exit 1
+fi
+
+if [[ ! -f "${iconset_build_script}" ]]; then
+ echo "Missing iconset build script: ${iconset_build_script}" >&2
+ exit 1
+fi
+
icon_work_dir="$(mktemp -d "${TMPDIR:-/tmp}/open-computer-use-icon.XXXXXX")"
cleanup() {
if [[ -n "${icon_work_dir:-}" ]]; then
@@ -297,7 +308,7 @@ cleanup() {
trap cleanup EXIT
iconset_dir="${icon_work_dir}/OpenComputerUse.iconset"
mkdir -p "${iconset_dir}"
-swift "${icon_render_script}" "${iconset_dir}"
+"${iconset_build_script}" "${icon_master_png}" "${iconset_dir}"
iconutil -c icns "${iconset_dir}" -o "${resources_dir}/${bundle_icon_name}"
cat > "${contents_dir}/Info.plist" <<PLIST
diff --git a/scripts/render-open-computer-use-icon.swift b/scripts/render-open-computer-use-icon.swift
index 887fb15..eeae742 100644
--- a/scripts/render-open-computer-use-icon.swift
+++ b/scripts/render-open-computer-use-icon.swift
@@ -77,8 +77,12 @@ func writeIconPNG(named fileName: String, pixelSize: Int, to directoryURL: URL)
func drawAppIcon(size: CGFloat) {
// Keep this geometry aligned with Branding.makeAppIconImage in the app target.
- let rect = CGRect(origin: .zero, size: CGSize(width: size, height: size))
- let tile = NSBezierPath(roundedRect: rect, xRadius: size * 0.22, yRadius: size * 0.22)
+ let canvasInset = size * (92.0 / 1024.0)
+ let rect = CGRect(origin: .zero, size: CGSize(width: size, height: size)).insetBy(
+ dx: canvasInset,
+ dy: canvasInset
+ )
+ let tile = NSBezierPath(roundedRect: rect, xRadius: rect.width * 0.22, yRadius: rect.height * 0.22)
let gradient = NSGradient(colors: [
NSColor(calibratedRed: 0.12, green: 0.67, blue: 0.99, alpha: 1),
@@ -87,11 +91,11 @@ func drawAppIcon(size: CGFloat) {
gradient.draw(in: tile, angle: 20)
func point(_ x: CGFloat, _ y: CGFloat) -> CGPoint {
- CGPoint(x: size * x / 256, y: size * (1 - y / 256))
+ CGPoint(x: rect.minX + rect.width * x / 256, y: rect.minY + rect.height * (1 - y / 256))
}
func scale(_ value: CGFloat) -> CGFloat {
- size * value / 256
+ rect.width * value / 256
}
let arc = NSBezierPath()