快速開始

複製、建置 nano-use，拍下你的第一張截圖，也可以把它加到 PATH 裡。

先決條件

你需要一台裝好 Git、Rust 工具鏈和 Apple 建置工具的 Mac。先確認這些都能正常運作：git --version、rustc --version、cargo --version 和 xcode-select -p。接下來的操作還會用到 macOS 內建的 base64、sips 和「預覽程式」；Agent 範例另外需要 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 設定檔裡。

下一步

送出輸入操作之前先讀命令參考。要串接外部智慧體，可以參考智慧體整合裡的觀察範例。建置、截圖或輸入出了問題，去看權限與疑難排解。