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:
nethur status --json
nethur computer permissions --json
nethur computer capabilities --jsonpermissions 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.
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
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 --jsonListelenen 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:
nethur computer get-app-state --app com.microsoft.edgemac --jsonUygulama 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
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> --jsonHam 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:
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 --jsonHassas 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:
nethur skills install --skill computer-useBecerilerin nasıl alındığı için Beceri kaydı ve MCP sayfasına bakın.
Sonraki adımlar
- Nethür CLI genel bakış — CLI yüzeyinin geri kalanı (çalışma alanları, terminal, tarayıcı).
- Beceri kaydı ve MCP — bu CLI'yi ajanlara dağıtma.