> ## Documentation Index
> Fetch the complete documentation index at: https://docs.claboard.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Sesli Asistan

> Konuşma tanıma ile eller serbest görev yönetimi

Claude Board, sesli komutlar kullanarak görev oluşturmanızı, durum kontrolü yapmanızı ve board'unuzu yönetmenizi sağlayan yerleşik bir sesli asistan içerir.

<Frame>
  <img src="https://mintcdn.com/bahri/LhHfZeA1RQn4U7C6/images/feature-voice.svg?fit=max&auto=format&n=LhHfZeA1RQn4U7C6&q=85&s=fae13315dbf7cef296433bd5418de065" alt="Voice Assistant" width="900" height="260" data-path="images/feature-voice.svg" />
</Frame>

## Başlarken

Asistan panelini açmak için sağ alt köşedeki **mikrofon butonuna** (kayan eylem butonu) tıklayın. Panel açıkken mikrofonu açıp kapatmak için **Alt+V** tuşuna da basabilirsiniz.

## Mevcut Komutlar

| Komut               | Ne yapar                                                        |
| ------------------- | --------------------------------------------------------------- |
| **"Create task"**   | Yeni bir görev oluşturmak için çok adımlı bir akış başlatır     |
| **"List tasks"**    | Duruma göre görev sayılarını bildirir                           |
| **"Change status"** | Bir görevi yeni bir duruma taşıma sürecinde size rehberlik eder |
| **"Help"**          | Mevcut tüm komutları listeler                                   |
| **"Cancel"**        | Aktif herhangi bir işlemi durdurur                              |

## Görev Oluşturma Akışı

"Create task" dediğinizde, asistan sizi şu adımlardan geçirir:

1. **Başlık** — "Görev başlığı ne olmalı?"
2. **Açıklama** — "Bir açıklama eklemek ister mısınız?" (atlamak için "skip" deyin)
3. **Tür** — "Tür ne? Feature, bugfix, refactor, docs, test veya chore."
4. **Öncelik** — "Öncelik? None, low, medium veya high."
5. **Onay** — "Oluşturayım mı?" ("yes" veya "no" deyin)

## Özellikler

### Metinden Konuşmaya

Asistan yanıtlarını sesli olarak okur. Sesi kapatmak/açmak için panel başlığındaki hoparlör simgesini değiştirin.

### Ses Görselleştiricisi

Mikrofon aktifken panelde, ses giriş seviyelerini gösteren gerçek zamanlı bir dalga formu görselleştiricisi görünür.

### Ses Efektleri

* Dinleme başladığında **yükselen bip**
* Dinleme durduğunda **alçalan bip**

### Komut İpuçları

Asistan boşta olduğunda, yaygın komutlara hızlı erişim için tıklanabilir öneri yongaları görünür.

### Metin Girişi

Panel'in altındaki metin giriş alanına komutları da yazabilirsiniz. Sesli ve metin girişi aynı şekilde çalışır.

### Klavye Kısayolu

Tıklamadan mikrofonu açmak/kapatmak için **Alt+V** tuşuna basın.

## Mimari

Sesli asistan modüler bir eklenti mimarisi kullanır:

```
features/voice/
├── VoiceAssistant.jsx           # İnce UI kaplaği (FAB + panel)
├── VoiceAssistantProvider.jsx   # React context + durum makinesi
├── engine/
│   ├── ttsEngine.js             # Metinden konuşmaya (Web Speech API)
│   ├── sttEngine.js             # Dalga formu için ses analizcisi
│   └── soundEffects.js          # Web Audio API bip efektleri
├── intent/
│   ├── intentParser.js          # Desen tabanlı niyet algılama
│   └── entityExtractors.js      # Tür, öncelik, model çıkarımı
├── commands/
│   ├── commandRegistry.js       # Eklenti kayıt defteri
│   ├── createTaskCommand.js     # "Create task" akışı
│   ├── listTasksCommand.js      # "List tasks"
│   ├── changeStatusCommand.js   # "Change status" akışı
│   ├── helpCommand.js           # "Help"
│   └── cancelCommand.js         # "Cancel"
└── components/
    ├── ChatPanel.jsx            # Mesaj listesi + kontroller
    ├── AudioVisualizer.jsx      # Canvas dalga formu
    └── CommandHints.jsx         # Öneri yongaları
```

### Özel Komut Ekleme

Yeni bir sesli komut eklemek için:

1. `commands/` klasöründe yeni bir dosya oluşturun (örn. `myCommand.js`)
2. Desenler, akış durumları ve bir çalıştırma fonksiyonu ile `registerCommand()` kullanın
3. Dosyayı `commands/index.js` içinde ice aktarın

Başka hiçbir dosyanın değişmesine gerek yoktur — kayıt defteri yeni komutları otomatik olarak keşfeder.

## Tarayıcı Desteği

Sesli asistan, [Web Speech API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Speech_API) için tarayıcı desteği gerektirir:

* **Chrome / Edge** — Tam destek (tanıma + sentez)
* **Safari** — Yalnızca sentez (tanıma yok)
* **Firefox** — Sınırlı destek

Konuşma tanıma mevcut değilse, mikrofon butonu devre dışı bırakılır ancak metin girişi yine de çalışır.

## Görev Penceresinde Sesle Yazım

Asistandan bağımsız olarak, görev oluşturma penceresi de doğrudan sesle yazım için **başlık** ve **açıklama** alanlarında mikrofon butonlarına sahiptir. Bunlar bağımsız çalışır ve form alanlarını hızlıca doldurmak için kullanışlıdır.
