{"id":36964800,"url":"https://github.com/aitiotekt/dock-cleat","last_synced_at":"2026-01-13T19:45:54.138Z","repository":{"id":328540453,"uuid":"1115600529","full_name":"aitiotekt/dock-cleat","owner":"aitiotekt","description":"An app to help lock your Mac's Dock to your main screen. As the Dock can sometimes appear on secondary screens or move unexpectedly when multiscreens.","archived":false,"fork":false,"pushed_at":"2025-12-14T17:47:16.000Z","size":7019,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-12-15T16:17:27.341Z","etag":null,"topics":["dock","lock","mac","macos","multiscreen","screens","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aitiotekt.png","metadata":{"files":{"readme":"README-zh.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-13T07:00:26.000Z","updated_at":"2025-12-14T17:47:15.000Z","dependencies_parsed_at":"2025-12-15T19:00:13.839Z","dependency_job_id":null,"html_url":"https://github.com/aitiotekt/dock-cleat","commit_stats":null,"previous_names":["aitiotekt/dock-cleat"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/aitiotekt/dock-cleat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitiotekt%2Fdock-cleat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitiotekt%2Fdock-cleat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitiotekt%2Fdock-cleat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitiotekt%2Fdock-cleat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aitiotekt","download_url":"https://codeload.github.com/aitiotekt/dock-cleat/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitiotekt%2Fdock-cleat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28397826,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dock","lock","mac","macos","multiscreen","screens","swift"],"created_at":"2026-01-13T19:45:53.648Z","updated_at":"2026-01-13T19:45:54.131Z","avatar_url":"https://github.com/aitiotekt.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# DockCleat\n\n\u003cimg src=\"assets/icon.png\" alt=\"DockCleat 图标\" width=\"128\" height=\"128\"\u003e\n\n**将 Mac 的 Dock 锁定到指定屏幕和位置**\n\n[![CI](https://github.com/aitiotekt/dock-cleat/workflows/Build%20and%20Release/badge.svg)](https://github.com/aitiotekt/dock-cleat/actions) [![版本](https://img.shields.io/github/v/release/aitiotekt/dock-cleat?label=版本)](https://github.com/aitiotekt/dock-cleat/releases) [![Swift](https://img.shields.io/badge/Swift-orange.svg?logo=swift)](https://swift.org) [![macOS](https://img.shields.io/badge/macOS-14.0+-lightgrey.svg)](https://www.apple.com/macos) [![许可证](https://img.shields.io/badge/许可证-MIT-green.svg)](LICENSE)\n\n[中文](README-zh.md) | [English](README.md)\n\n\u003c/div\u003e\n\n---\n\nDockCleat 是一款 macOS 实用工具，帮助您将 Dock 锁定到指定的屏幕和位置。在使用多显示器时，Dock 有时会出现在次要屏幕上或意外移动。DockCleat 会自动监控并强制执行您首选的 Dock 配置。\n\n## ✨ 功能特性\n\n- 🔒 **Dock 锁定**：将 Dock 锁定到指定的屏幕和位置\n- 📍 **位置控制**：选择底部、左侧或右侧位置\n- 🖥️ **多显示器支持**：选择显示 Dock 的屏幕\n- 🛡️ **实时事件阻塞**：自动防止 Dock 移动尝试\n- 🎨 **主题与本地化**：支持浅色/深色主题和英语/中文\n- 🚀 **登录启动**：可选择在登录时自动启动应用\n- 📊 **菜单栏集成**：从菜单栏快速访问控制\n\n## 📸 截图\n\n### 主窗口\n\u003cimg src=\"assets/screenshots/main_window.png\" alt=\"主窗口\" width=\"375\"\u003e\n\n### 通用设置\n\u003cimg src=\"assets/screenshots/general_settings.png\" alt=\"通用设置\" width=\"375\"\u003e\n\n### 菜单栏上下文菜单\n\u003cimg src=\"assets/screenshots/context_menu.png\" alt=\"菜单栏上下文菜单\" width=\"375\"\u003e\n\n## 📋 系统要求\n\n- macOS 14.0 (Sonoma) 或更高版本\n- 辅助功能权限（事件阻塞所需）\n\n## 🚀 安装\n\n### 一般用户\n\n1. 前往 [Releases](https://github.com/aitiotekt/dock-cleat/releases)\n2. 下载最新的 `DockCleat-v*.zip` 文件\n3. 解压 ZIP 文件，将 `DockCleat.app` 移动到应用程序文件夹\n4. 从应用程序中启动 DockCleat\n\n### 开发者\n\n1. 克隆仓库：\n   ```bash\n   git clone https://github.com/aitiotekt/dock-cleat.git\n   cd dock-cleat\n   ```\n\n2. 在 Xcode 中打开 `DockCleat.xcodeproj`\n\n3. 构建项目 (⌘R) 或使用命令行：\n   ```bash\n   xcodebuild -scheme DockCleat -configuration Release\n   ```\n\n4. 构建好的应用位于 `build/Build/Products/Release/DockCleat.app`\n\n## 📖 使用说明\n\n### 主窗口\n\n主窗口通过两个标签页提供所有设置：\n\n- **Dock 设置**：启用锁定、选择位置（底部/左侧/右侧）、选择目标屏幕、切换自动隐藏\n- **通用设置**：语言、主题、可见性选项、登录启动、权限和状态\n\n### 菜单栏\n\n点击菜单栏图标可快速切换锁定、更改设置和打开主窗口。\n\n### 首次启动\n\n1. 启动 DockCleat 并在提示时授予辅助功能权限\n2. 配置您首选的 Dock 位置和目标屏幕\n3. 启用 Dock 锁定以开始监控\n\n## 🔧 工作原理\n\nDockCleat 使用 Core Graphics 事件拦截来拦截鼠标事件并防止 Dock 移动尝试。它还使用 AppleScript 控制 Dock 设置，并监控屏幕配置变化以自动恢复您的首选设置。\n\n## 🔐 隐私\n\nDockCleat 需要辅助功能权限来拦截鼠标事件。此权限仅在本地使用，不会收集或传输任何数据。\n\n## 🐛 故障排除\n\n- **Dock 未锁定**：确保\"启用 Dock 锁定\"已打开并授予了辅助功能权限\n- **CPU 使用率过高**：Dock 锁定经过优化，在禁用时使用最少的资源\n- **菜单栏未显示**：检查\"通用设置\"中的\"在菜单栏中显示\"\n\n## 📝 许可证\n\nMIT 许可证 - 详见 [LICENSE](LICENSE) 文件。\n\n## 👤 作者\n\n[@aitiotekt](https://github.com/aitiotekt)\n\n## 🙏 致谢\n\n- 部分参考了 [DockAnchor](https://github.com/bwya77/DockAnchor)\n- 使用 SwiftUI 和 Core Graphics 构建\n- 本项目在 AI 辅助下开发\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faitiotekt%2Fdock-cleat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faitiotekt%2Fdock-cleat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faitiotekt%2Fdock-cleat/lists"}