内容
<div align="center">
# 注解
**您的代理的画笔盒。**
<img src="docs/media/tools.gif" width="800" alt="每个注解工具都在注释自己的名称 — 环形环绕， 下划线下划线， 高亮高亮， 箭头指向 — 然后擦除， 然后‘立即安装’被圈出">
</div>
## 1. 安装应用程序
[**下载最新版本 →**](../../releases/latest)
## 2. 安装工具
告诉您的代理：
```
在 https://github.com/adammcarter/annotate 安装 MCP 工具
```
## 3. 让您的代理绘图
- 学习新应用程序
- 在游戏中获得指针
- 找到复杂想法的帮助
注解允许您的代理直接在您的屏幕上绘图。
# 为什么
想要学习 Blender 但发现它太复杂？
不确定在塔防游戏中下一个放置的物品位置？
正在研究一个新想法，但某些东西不太对劲？
您的代理可以告诉您确切的 x 和 y 坐标，但这不是很有帮助...
现在您的代理可以直接在您的屏幕上**指向**。
# 工具
| | |
|---|---|
| `annotate_circle` | 环绕某物。工作马车 — 需要标签。 |
| `annotate_underline` | 下划线短语，保持文字可读。 |
| `annotate_highlight` | 在区域上涂上标记。 |
| `annotate_arrow` | 指向无法绘制的物体。 |
| `annotate_text` | 在没有控件的情况下说明某些事情。 |
| `annotate_locate` | 查找实际元素的确切位置，以便准确无误。 |
| `annotate_screens` | 哪个显示屏，什么比例。 |
| `annotate_clear` | 删除所有内容。 |
# 权限
- **权限。** 注解需要可访问性（系统设置 → 隐私和安全 → 可访问性）第一次运行。其他功能不需要。
- **隐私。** 注解绘制并读取 UI 元素位置。它从不捕获您的屏幕，也不会建立网络连接。
- **信任。** 绘制和读取不遵循相同的标准，因为它们不是相同的权限。
# 代理安装信息
一旦注解安装完成，MCP 服务器已经在磁盘上 — 它包含在应用程序包中：
```
/Applications/Annotate.app/Contents/MacOS/annotate-mcp
```
该路径是整个配置，并且在任何地方都相同。它通过标准输入/输出与 MCP 通信，并在应用程序未运行时启动应用程序本身。
## Claude
```
claude mcp add annotate /Applications/Annotate.app/Contents/MacOS/annotate-mcp
```
## Codex
```toml
[mcp_servers.annotate]
command = "/Applications/Annotate.app/Contents/MacOS/annotate-mcp"
```
## Cursor, Windsurf, Zed 和任何使用 `mcpServers` 的其他软件
```json
{
"mcpServers": {
"annotate": {
"command": "/Applications/Annotate.app/Contents/MacOS/annotate-mcp"
}
}
}
```
# 反馈
发现问题？或喜欢的功能？ 我很乐意知道！
请随意 [打开问题](https://github.com/adammcarter/annotate/issues/new).
# 开发者和贡献者
```
代理 ──MCP──▶ annotate-mcp ──unix socket──▶ Annotate.app ──▶ 您的屏幕
```
`Packages/AnnotateCore` 是纯几何和线路协议 — 没有 AppKit，没有 UI。每个标记都从其注释 ID 种子，因此它具有自己的特征，并且可以精确重现，这使得绘图可以通过黄金测试固定，而不是通过目测。`Annotate/` 是应用程序：每个屏幕的点击叠加层，核心动画渲染和控制套接字。`Packages/AnnotateMCP` 是_stdio_服务器，它将工具调用转换为套接字命令。
[`docs/DESIGN.md`](docs/DESIGN.md) 涵盖了为什么墨水看起来是这样的。[`docs/adr/`](docs/adr) 有决策，包括尝试和拒绝的替代方案。
## 贡献
请随意 fork、更新或修复此仓库 — 理想情况下，先打开问题。
在 macOS 14+ 上运行。构建需要 Xcode 26，需要 macOS 26 — 应用程序图标是 Icon Composer 包，只有该工具链才能编译。
```sh
open Annotate.xcodeproj # ⌘R — 它出现在菜单栏中
bash Tools/guided-tour.sh # 45 秒的介绍，在您自己的屏幕上绘制
swift test --package-path Packages/AnnotateCore
xcodebuild -project Annotate.xcodeproj -scheme Annotate -destination 'platform=macOS' test
```
两件事需要注意，在更改任何绘图内容之前：
**生成器绘制次数和绘制顺序是像素合同。** 在函数之间移动绘图是安全的；重新排序一个会默默更改每个现有标记。 在 `PenStroke.swift` 顶部有一个较长的注释。
**离线渲染不是证据。** 这里的几个错误在渲染的 PNG 中看起来很完美，但在实际合成的屏幕上却不正确。 通过运行应用程序确认。
# 许可证
MIT — 见 [LICENSE](LICENSE)。
