Bu sayfa İngilizce belgenin çevirisidir. Komutlar, tanımlayıcılar ve örnekler aynıdır. Çalışma zamanı 7.24.4 · SDK 2.6.7. İngilizce kaynak

Ses bildirimleri

Durum: Güncel Kapsam: AX Code TUI sesi ve sözlü uyarılar Son inceleme: 2026-09-12 Sahip: AX Code çalışma zamanı bakımcıları

TUI, AX Code dikkatinizi istediğinde bir sistem sesi çalabilir veya kısa bir şablon tümce söyleyebilir:

İzin isteği — bir araç onayınızı bekliyor.
Ajan sorusu — ajan size bir soru sordu.
Tur tamam — çalıştırma bitti (varsayılan kapalı).
Oturum hatası — tur başarısız oldu.

Ses, uçbirim bildirimiyle aynı tetiklere biner (OSC 9 masaüstü bildirimi veya OSC 9 desteklenmeyen yerde uçbirim zili) ve aynı notifications.enabled anahtarıyla kapılanır. Varsayılan kapalıdır; açmak bildirimlerin başka hiçbir yanını değiştirmez.

Yapılandırma

notifications.sound değerini tui.json içinde ayarlayın:

{
  "notifications": {
    "enabled": true,
    "sound": "chime",
    "events": {
      "permission": true,
      "question": true,
      "complete": false,
      "error": true
    }
  }
}

Alan	Değerler	Varsayılan	Anlam
`enabled`	mantıksal	`true`	Uçbirim bildirimleri ve ses için ana kapı.
`sound`	`"off"`, `"chime"`, `"speak"`	`"off"`	`chime` bir sistem sesi çalar; `speak` ses sentezler.
`voice`	dizgi	`""`	Platform ses adı (macOS üzerinde `say -v '?'`); boş = varsayılan.
`rate`	tamsayı	`0`	Desteklendiği yerde konuşma hızı (macOS words/min, 1–500); 0 = varsayılan.
`events.permission`	mantıksal	`true`	İzin isteklerinde uyar.
`events.question`	mantıksal	`true`	Ajan sorularında uyar.
`events.complete`	mantıksal	`false`	Bir tur tamamlandığında uyar.
`events.error`	mantıksal	`true`	Oturum hatalarında uyar.

Geçersiz değerler alan alan atılır: kötü bir sound değeri diğer ayarlarınızı etkilemeden "off" değerine döner.

Platform desteği

Platform	Zil	Konuşma	Gereksinim
macOS	`afplay` (sistem sesi)	`say`	Yerleşik.
Windows	`System.Media.SoundPlayer`	`System.Speech`	Yerleşik (PowerShell).
Linux	`paplay`, geri dönüş `canberra-gtk-play`	`spd-say`, geri dönüş `espeak-ng`	PulseAudio/`libcanberra` ve/veya `speech-dispatcher`/`espeak-ng` kurun.

Bulunurluk çalışma zamanında yoklanır. Kullanılabilir bir arka uç yoksa ses adımı sessizce atlanır ve uçbirim bildirimi geri dönüş olarak kalır. Oynatma serileştirilir (bir seferde bir ses, yinelemeler birleşir), her olay en çok bir kez uyarır ve arabirim oynatmayı asla beklemez. Başsız çalıştırmalar (ax-code run) hiç ses çalmaz.

Ne söylenir

Konuşma yalnızca dört sabit şablon kullanır: Approval required: <tool>, Question: <first question>, Session idle: <session title> ve AX Code error. Metin kısaltılır ve denetim karakterlerinden arındırılır. Araç argümanları, yüklerden gelen dosya yolları, model çıktısı ve hata iletileri asla söylenmez — bu sınırlar içinde paylaşılan alanlar için güvenlidir.

Kancalarla özel sesler

Tam denetim için (kendi ses dosyanız, farklı metin, ek olaylar) herhangi bir oynatıcıyı yaşam döngüsü kancaları üzerinden bağlayın — ses bildirimleri kapalıyken de çalışır. AX_CODE_TRUST_PROJECT_CONFIG=1 ile katıldıktan sonra .ax-code/hooks.json oluşturun:

{
  "hooks": [
    { "event": "Stop", "command": "afplay /System/Library/Sounds/Glass.aiff" },
    { "event": "PreToolUse", "matcher": "bash|edit|write", "command": "say 'AX Code needs approval'" }
  ]
}

Platformunuzun oynatıcısını kullanın (macOS üzerinde afplay, Linux üzerinde paplay, Windows üzerinde PowerShell [System.Media]). Kanca komutları kabuk parçalarıdır — yaşam döngüsü yolunu geciktirememeleri için ateşle ve unut olarak tutun.

Dış bir bildirge oluşturmak

Dış araçlar (durum çubukları, mobil anlık bildirim, bir masaüstü uygulaması) sunucunun olay akışına abone olup permission.asked, question.asked, session.status ve session.error olaylarına tepki verebilir — bkz. HTTP ve OpenAPI uyumluluğu.