ヘルプ
aya-bot のチュートリアルと、実装済み機能の一覧です。
困った時はDiscordで !aya help と送信してください。
更新: 2026-08-10
チュートリアル
まず知っておくこと
aya-bot は Discord の投稿を、Irodori-TTS で読み上げるBotです。
（※未登録のチャンネルの読み上げするにはBotの設定が必要です）
ボイスチャンネルのテキストはBotが直接読み上げます。
テキストチャンネルでは音声ファイルを添付して返信します。
- 声の番号は !aya voice の一覧と [aya] の voice: で共通です。
- 話し方は Caption（ムード）や、メッセージ内のスタイル絵文字で変わります。
- ルールは 利用ガイド を見てください。
はじめの 3 ステップ
VC で聴く場合
- 自分が VC に入る
- 必要なら !aya join（テキストCHからも可。auto-join もある）
- 対象チャンネルに投稿する → マイク経由で読まれる
- 止めるときは !aya stop（VC 専用）
音声ファイルで受け取る場合
text-audio 対象チャンネルでは、投稿に対して音声ファイルが添付返信されます。 長い文や丁寧に作りたい文は、文章作成 で [aya] を作って貼るのが楽です。
実装済み機能一覧
| 機能 | できること |
|---|---|
| 通常読み上げ | 対象チャンネルの投稿を TTS。VC 再生または音声ファイル返信。 |
| スキップ | 先頭 // でその投稿だけ読まない。 |
| 声切替 | 個人 / 全体の voice。番号は固定スロット（1〜）。 |
| Caption ムード | !aya mood。話し方を sticky で保持（user > global > none）。 |
| スタイル絵文字 | Unicode 絵文字が Irodori の演出タグになる。!aya emoji で一覧。 |
| [aya] 自由生成 | voice / caption / text を明示。テキストCHは常時。VC は freegen on のときだけ。 |
| 短文 duration 補正 | 参照ボイスで 6 文字以下のとき duration_scale=0.7（間延び対策）。 |
| 読み替え辞書 | 共有辞書で読みを補正（GUI 側で編集）。 |
| bad / nice | ノイズ時リロール、良い読みの記憶（gold-label）。リプライ必須。 |
| readuser | 特定ユーザーの読み上げ on/off（管理者）。 |
| サイト補助 | 文章作成 / コピペ帳 / 本ページ。 |
コマンド一覧
Discord の !aya help と同じ分類です。コピペは コピペ帳 へ。
VC
| コマンド | 内容 |
|---|---|
| !aya join | Bot を VC へ入れる（テキストCHからも可） |
| !aya stop | 再生停止＆キュー清空（VC専用） |
| !aya freegen on|off | VC で [aya] を一時許可（既定 off・退出で自動 off・VC専用） |
| !aya freegen | freegen の状態表示（VC専用） |
設定（どこでも可）
| コマンド | 内容 |
|---|---|
| !aya voice | 声一覧 |
| !aya voice <N> | 自分の声を番号で切替 |
| !aya voice global <N> | 全体の既定声 |
| !aya voice reset | 自分の声設定をリセット |
| !aya mood | Caption ムード一覧 |
| !aya mood <id> | ムード設定（global / reset / off / reload あり） |
| !aya emoji | スタイル絵文字一覧 |
| !aya readuser @user … | on / off / off-permanent / status（管理者） |
| !aya / !aya help | Discord 内ヘルプ |
[aya] 自由生成
voice・Caption・本文を明示したいときに使います。テキストチャンネルでは常時OK（音声ファイル返信）。 VC マイク読み上げは !aya freegen on のあいだだけです。
[aya] voice: 7 caption: 感情豊かに。 text: ねえ、ちょっと聞いてよ。 [/aya]
- voice: は !aya voice の番号（推奨）。alias 可。実験用 NONE（リファレンスなし）。
- caption: は話し方。本文には入りません。省略可。
- コードフェンス（言語タグ aya）も同等。
- 構文ミスは生成せず、短い ERROR が返ります。
生成した音声にノイズが乗っている時は
| やりたいこと | 操作 |
|---|---|
| リロール | ユーザー本文、または aya の音声にリプライして !aya bad |
| 良い読みを覚える | aya の音声にリプライして !aya nice（短い言葉向け・成功 ⭐） |
- リプライ必須（直前ターゲット自動では動きません）。
- !aya nice は aya 音声へのリプライのみ・おおむね 12 文字以下。
- VC チャットの !aya bad 成功時は文章返信なし（✅ / ❌）。
うまく動かない時
- 対象チャンネルに投稿しているか
- 先頭が // になっていないか
- VC で聴くなら Bot が入っているか（!aya join）
- 文が長すぎないか
- !aya nice なら aya の音声にリプライしているか
- 自宅 PC 運用のため、Bot / TTS が止まっていることがある
利用上のお願い（法令・Discord・Irodori）は 利用ガイド。