Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Run the checks no automated test covers, on a real Mac

未关闭
#129 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
42/100
Issue 类型
缺陷
描述清晰度
描述清楚
活跃度
活跃
技术栈
macos, swift

调研方向

Start with npm run live-check, then follow the checklist in issue #129 on the required real-Mac setup; use docs/mcp.md for the Codex check. Run each scenario exactly as written, excluding macOS 27, and record any failed behavior in linked bug issues. Done means every pass/fail box is resolved and the two unknowns are answered.

由索引模型根据 Issue 内容生成。

描述

These checks have never run on a real Mac, and no automated check covers them. Everything else that shipped is covered by npm run live-check, by unit tests, or by agents using the tools every day.

Tick a check when it passes. If one fails, open a bug and link it here. Close this issue when every box is ticked.

  • Automated run: npm run live-check reports PASS for every check.

Safety. If one of these fails, a clipboard is lost or a mouse button stays held down.

  • Kill the MCP client while desktop_insert is pasting into TextEdit. Afterwards the clipboard holds either the original contents, or the inserted text with the reservation held. Older contents are never restored over a newer copy. (#3)
  • Quit Desktop Tools right after an insert that returned unknown, then relaunch it. desktop_clipboard_write is still refused until the receiving app quits. (#3)
  • Paste an image into a plain-text TextEdit document. The result is unknown with clipboard_ownership: "reserved", and quitting TextEdit releases the reservation. (#99)
  • Kill the client during a 5 s desktop_press, and again during a 5 s desktop_drag. Both times the button is up within about 7 s, and a later click works. (#45, #2)
  • Turn on Pause All Input. desktop_click and desktop_clipboard_write are refused, while desktop_windows and desktop_inspect still work. Resuming lets the same click through, and a relaunch starts unpaused. (#100)

Never run on macOS 27. These were built from documentation or from how older macOS versions behave.

  • Notifications: desktop_notifications reads a banner, and desktop_notification_action close, open and an app action (Reminders "Mark as Completed") each do what they say. If they don't, record the banner's AX roles and action names. (#74)
  • Spaces: desktop_switch_space switches. A window on another Space reports availability.reason: other_space, and switching to that Space recovers it. (#66, #1)
  • desktop_fullscreen enters full screen, then exits back to a desktop Space. (#78)
  • Two displays, one left of or above the main one: desktop_click, desktop_scroll and desktop_drag on the second display land where intended. Rearranging the displays between inspect and click gets the click refused. (#2)
  • desktop_system_key volume, mute, play/pause and brightness keys work. (#80)
  • Slack or VS Code: the first desktop_inspect turns on web accessibility and lists the app's web fields, and the window still moves and resizes normally. (#107)
  • Approved Agents: a new agent's first action shows the prompt. Allow lets it through, and Revoke and Forget work from the menu. (#120)
  • Codex: with the [mcp_servers.desktop] entry from docs/mcp.md, desktop_apps, desktop_inspect and one desktop_type complete. (#27)

Unknowns to answer. These aren't pass/fail; write the answer here.

  • Numbers and Excel: does desktop_set_cell find an editable control in a cell, or refuse with CELL_NOT_EDITABLE? (#92)
  • desktop_close on a Finder window once returned unknown although the window closed. Does that still happen? (#4)

The focus bug (#23) and background paste into web apps (#5) have their own issues.

主要语言
Swift
星标
0
派生
0
平均合并
19 分钟
30 天内合并 PR
107

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

githubnext/desktop-tools 的其他 Issue

查看 githubnext/desktop-tools 的全部 Issue

相似的 Issue

更多 Swift Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。