Bilgisayar kullanımı

Yerel masaüstü uygulamalarını erişilebilirlik ağaçları, ekran görüntüleri ve güvenli arayüz eylemleriyle bir ajandan sürün.

nethur computer CLI'si bir ajanın yerel masaüstü uygulamalarını incelemesine ve kontrol etmesine olanak verir — çalışan uygulamaları listelemek, erişilebilirlik ağaçlarını okumak, kontrollere tıklamak, değer ayarlamak, metin yazmak, kaydırmak ve ekran görüntüsü almak. Bir görev terminal veya yerleşik tarayıcı yerine işletim sistemini ya da üçüncü taraf bir uygulamayı çalıştırmayı gerektirdiğinde kullanın.

İlk kurulum

Çalışma zamanını ve izinleri kontrol edin:

shell
nethur status --json
nethur computer permissions --json
nethur computer capabilities --json

permissions eksik bir şey bildiriyorsa Sistem Ayarları'nda Nethür Computer Use için Erişilebilirlik (macOS'ta Ekran Kaydı) verin, sonra doğrulamak için permissions --json komutunu yeniden çalıştırın.

Anlık görüntü → eyleme geç → anlık görüntü

Her etkileşim aynı döngüyü izler: uygulamanın geçerli durumunu oku, belirli bir öğe üzerinde eyleme geç, sonra sonucu doğrulamak için durumu yeniden oku.

shell
nethur computer list-apps --json
nethur computer get-app-state --app com.spotify.client --json
nethur computer click --app com.spotify.client --element-index 42 --json

Öğe dizinleri en son get-app-state sonucuna kapsamlıdır ve seyrek olabilir. --json çıktısında ağacı result.snapshot.treeText içinden okuyun. elementCount değerinden dizin uydurmayın. Bir dizini yeniden kullanmadan önce gezinme, odak değişikliği, kaydırma veya herhangi bir uygulama yeniden oluşturmasından sonra durumu yenileyin.

Çok pencereli uygulamalar

bash
nethur computer list-windows --app com.microsoft.edgemac --json
nethur computer get-app-state --app com.microsoft.edgemac --window-id <id> --json
nethur computer click --app com.microsoft.edgemac --window-id <id> --element-index 12 --json

Listelenen id none değilse kararlı --window-id tercih edin; aksi halde --window-index kullanın.

Uygulama seçme

list-apps tarafından döndürülen paket kimliklerini tercih edin:

shell
nethur computer get-app-state --app com.microsoft.edgemac --json

Uygulama adları belirsiz değilse çalışır (--app Spotify). Yalnızca paket kimliği ve ad çakıştığında --app pid:<sayı> kullanın.

Kullanılabilir eylemler

shell
nethur computer click --app <app> --element-index <i> --json
nethur computer set-value --app <app> --element-index <i> --value "text" --json
nethur computer type-text --app <app> --text "text" --json
nethur computer press-key --app <app> --key Return --json
nethur computer hotkey --app <app> --key CmdOrCtrl+A --json
nethur computer paste-text --app <app> --text "text" --json
nethur computer scroll --app <app> --element-index <i> --direction down --json
nethur computer drag --app <app> --from-x 100 --from-y 100 --to-x 300 --to-y 300 --json
nethur computer perform-secondary-action --app <app> --element-index <i> --action <name> --json

Ham type-text veya press-key yerine anlamsal eylemleri (click, set-value, perform-secondary-action) tercih edin — doğrudan erişilebilirlik öğelerini hedeflerler ve klavye girdisinin yapamayacağı odak değişikliklerinden sağ çıkarlar.

Erişilebilirlik hedeflemesi başarısız olduğunda koordinatlara dikkatlice düşün:

bash
nethur computer click --app com.apple.Safari --x 120 --y 340 --json
nethur computer drag --app <app> --from-element-index 3 --to-element-index 9 --json

Hassas girdi

Sırları kabuk geçmişine düşmemeleri için stdin üzerinden geçirin:

printf '%s' "$TEXT" | nethur computer set-value \
  --app com.apple.Safari --element-index 7 --value-stdin --json

--text-stdin, type-text ve paste-text için aynı şekilde çalışır.

Linux ve Windows'ta eylem yükleri yardımcı çalışırken kısa süreliğine yerel bir işlem dosyasından da geçer. Stdin sırları kabuk geçmişinden uzak tutar ama her yerel gözlemciden gizlemez; görev açıkça gerektirmedikçe sır göndermekten kaçının.

Ekran görüntüleri

get-app-state bir erişilebilirlik ağacı ve varsayılan olarak bir ekran görüntüsü döndürür. --json ile görüntü baytları diske yazılır ve yol yanıta gömülmek yerine screenshot.path içinde döndürülür. Pikseller gerekmiyorsa --no-screenshot geçin (daha hızlı, daha küçük yük). Yakalamadan önce gizli veya simge durumuna küçültülmüş bir pencereyi görünür hale getirmek için --restore-window geçin.

Bir ajandan kullanma

Paketlenmiş computer-use becerisi aynı komut yüzeyini güvenlik rehberliğiyle paketler. Ajanın beceri dizinine kurun:

shell
nethur skills install --skill computer-use

Becerilerin nasıl alındığı için Beceri kaydı ve MCP sayfasına bakın.

Sonraki adımlar