快速开始

克隆、构建 nano-use，然后拍下你的第一张截图，还可以把它加入 PATH。

前置条件

你需要一台装好 Git、Rust 工具链和 Apple 构建工具的 Mac。先确认这些都能正常运行：git --version、rustc --version、cargo --version 和 xcode-select -p。下面的命令还会用到 macOS 自带的 base64、sips 和"预览"；智能体示例另外需要 Python 3。

这个固定版本在 2026-09-06 使用 macOS 26.6.2、Rust 1.88.0、Xcode 26.6 完成了构建并成功解码截图。截图依赖启用了 macOS 14.0 和 15.2 的 API，但这次验证不能证明所有旧版 macOS 也兼容。

取得并构建文档对应版本

在一个可以创建新 nano-use 文件夹的目录下运行：

git clone https://github.com/Golenspade/nano-use.git
cd nano-use
git checkout --detach c473c6176aeda7ff9c2969bb12ac36967352bfac
cargo build --locked --release
./target/release/nano-use --help

帮助信息会列出八个操作命令——包括 screenshot、click、keypress——还有 Clap 自带的 help。这个版本没有 --version 参数，想确认检出版本可以用 git rev-parse HEAD。后面的命令都假设你在仓库根目录下。

得到并打开第一张截图

如果 macOS 弹出权限请求，给实际启动命令的那个应用开启"屏幕录制"。注意终端和 IDE 的权限上下文可能不同，给哪个就在哪个里操作。改完权限后，可能需要重启那个应用才能生效。

./target/release/nano-use screenshot > screenshot.b64 &&
  /usr/bin/base64 -D -i screenshot.b64 -o screenshot.png &&
  /usr/bin/sips -g pixelWidth -g pixelHeight screenshot.png &&
  open screenshot.png

一切顺利的话，命令正常退出，sips 显示正数像素尺寸，打开的图片就是你要观察的那个桌面。CLI 输出的是 base64 文本，不是原始 PNG 字节——直接把 screenshot.b64 改名成 .png 并不能解码。错误信息写入 stderr，&& 链会在截图失败时阻止后续的解码和打开。截图可能包含桌面隐私信息，分享前先检查内容。

可选：使用简短命令名

上面的相对路径不需要安装就能用。如果想在当前 shell 里直接输入 nano-use：

mkdir -p "$HOME/.local/bin"
cp ./target/release/nano-use "$HOME/.local/bin/nano-use"
export PATH="$HOME/.local/bin:$PATH"
nano-use --help

export 只对当前 shell 生效。想让以后的会话也能用，把同样的 PATH 设置加到你的 shell 配置文件里。

下一步

发送输入操作之前先读命令参考。要接入外部智能体，可以参考智能体集成里的只观察适配器。构建、截图或输入出了问题，去看权限与故障排查。