﻿# ダイホンヤ 取扱説明書

音声作品（シチュエーションボイス / ASMR / ドラマCD）の台本を書くためのデスクトップアプリです。
インターネット接続なしで動作し、台本データが外部へ送信されることはありません。

- 対応OS: Windows 10 / 11（64bit）
- 必要メモリ: 4GB 以上　／　ディスク空き: 1GB 以上
- 本書のバージョン: v1.0.0 向け


---

## インストールと初回起動

1. `ダイホンヤ Setup 1.0.0.exe` を実行してインストールします。
   インストールしたくない場合は `Daihonya-portable.exe` をそのまま起動してください。
2. 初回起動時、Windows の SmartScreen が警告を出すことがあります。
   このアプリはコード署名を行っていないためで、**「詳細情報」→「実行」** で起動できます。
3. 起動するとサンプル台本が開きます。そのまま書き始められます。
4. 初回はチュートリアル（全10ステップ）が自動表示されます。
   後から見るときは **メニュー → チュートリアル** から開けます。

起動に十数秒かかることがあります（内部で台本処理サーバーを立ち上げているためです）。
ポータブル版は初回のみ自己展開を行うため、ウィンドウが出るまで 1 分ほどかかることがあります。

### データの保存場所

作成した台本は次の場所に保存されます。バックアップはこのフォルダを丸ごとコピーしてください。

```
%USERPROFILE%\.daihonya\data\documents\
```

保存は **5秒ごとの自動保存** と、ヘッダーの **保存** ボタン（Ctrl+S）の両方で行われます。

---

## 画面の見かた

| 場所 | 内容 |
|---|---|
| 上部ヘッダー | メニュー / 保存 / エクスポート / 画面の切替 / 設定 |
| 左パネル | トラック（章）の一覧。＋で追加、ダブルクリックで名前変更 |
| 中央 | 台本エディタ、または DAW 風タイムライン（上のタブで切替） |
| 右パネル | 校正 / 生成 / キャラ辞書 / プロンプト |
| 下部ステータスバー | AI（LLM）の接続状態とモデル名 |

**トラック**は章・シーンの単位です。1作品を複数トラックに分けて管理できます。

---

## 台本の書きかた（記法）

行の書き方でクリップの種類が自動的に決まり、色分けとタイムラインへの反映が行われます。

| 書き方 | 種類 | 例 |
|---|---|---|
| `キャラ名「セリフ」` | セリフ | `ユイ「おかえりなさい」` |
| `001 キャラ名「セリフ」` | 通し番号つきセリフ | `001 ユイ「ただいま」` |
| `キャラ名（演技）「セリフ」` | 演技指示つき | `ユイ（小声で）「起きてる？」` |
| `N「ナレーション」` | ナレーション | `N「夜が更けていく」` |
| `（ … ）` | ト書き | `（ゆっくり近づく）` |
| `【SE：…】` | 効果音 | `【SE：ドアが開く音】` |
| `【BGM：…】` | BGM | `【BGM：静かなピアノ】` |
| `【環境音：…】` | 環境音 | `【環境音：雨】` |
| `【距離：…】` | 距離・定位の指示 | `【距離：耳元】` |
| `【間：2秒】` | 間 | `【間：2秒】` |
| `＠＠＠＠＠` | アドリブ | 全角＠の数がおおよその長さ |

`【任意のタグ：…】` の形なら**独自のタグ**を作れます（例: `【心音：ゆっくり】`）。
作ったタグは自動的にタイムラインのレーンになり、色が割り当てられます。

### 行とクリップの関係

- **1行 = 1クリップ**です。`Enter` で改行すると新しいクリップになります。
- 同じクリップの中で改行したいときは **`Shift + Enter`** を使ってください。

### 入力を助ける機能

- **定型文ボタン**（エディタ上部の `SE` `BGM` `環境音` `間` `距離` `ナレ`）
  … カーソル位置に記法を挿入します。`＋定型文` で自分の定型文を登録できます。
- **クリップ一覧**ボタン … 登録済みのキャラ・タグから選んで行を追加します。
- **縦書き / 横書き** … 右上のボタンで切り替えます。縦書きではページ送り表示も使えます。

---

## 種類（タグ）を変更する

書いたあとから行の種類を変えられます。**内容の文章はそのまま引き継がれます。**

| 方法 | 操作 |
|---|---|
| 1行だけ変える | 行の左（縦書きでは上）のタグバッジをクリック → 種類を選ぶ |
| まとめて変える | 複数行を選択 → 右クリック → **選択範囲を一括変換…** → 種類を選ぶ |
| 名前・色を変える | タイムラインのレーン名をダブルクリック |

一括変換では選択した行が**それぞれ独立したクリップのまま**変換されます。`Ctrl+Z` で元に戻せます。

---

## タイムライン

エディタ上部の **タイムライン** タブに切り替えると、台本を時間軸で確認できます。

- クリップの幅 = 読み上げの推定秒数。全体の尺が一目でわかります
- ホイール = 縦スクロール／`Shift`+ホイール = 横スクロール／`Ctrl`+ホイール = クリップ幅
- 章（トラック）ごとの文字数と推定尺は左パネルに表示されます

推定尺の換算レート（何文字で何分か）は **設定** から変更できます。

---

## 書き出し（エクスポート）

ヘッダーの **エクスポート** から選びます。

| 形式 | 用途 |
|---|---|
| テキスト (.txt) | 汎用・共有用 |

---

## ショートカット

| キー | 動作 |
|---|---|
| `Ctrl + S` | 保存 |
| `Ctrl + Shift + E` | テキストで書き出し |
| `Ctrl + Z` / `Ctrl + Y` | 元に戻す / やり直し |
| `Shift + Enter` | 同じクリップ内で改行 |
| `Ctrl + ホイール` | 画面の拡大 / 縮小 |
| `Ctrl + +` / `-` / `0` | 拡大 / 縮小 / 等倍に戻す |
| `Ctrl + /` | ショートカット一覧 |

---

## 設定

**設定**ボタンから変更できます。

- テーマ（7色）／エディタの文字サイズ
- 尺の換算レート（何文字を30分とみなすか）
- 既定の書字方向（縦書き / 横書き）
- ページ分け（1ページあたりの段落数。0で無効）
- 既定のモデル名

---

## 困ったときは

**起動時に「Windows によって PC が保護されました」と出る**
→ コード署名を行っていないための警告です。「詳細情報」→「実行」で起動できます。

**起動が遅い / ウィンドウがなかなか出ない**
→ 内部で台本処理サーバーを立ち上げているため、十数秒かかります。ポータブル版は
初回のみ自己展開を行うため 1 分ほどかかることがあります。


**縦書きで新しいトラックに文字が入力できない**
→ 本文エリアの余白をクリックしてからご入力ください。

**台本を別のPCへ移したい**
→ メニュー →「プロジェクトをファイルに保存(.json)」で書き出し、移動先で
「プロジェクトファイルを開く(.json)」から読み込んでください。

---

## サポート

動作の不具合・ご質問は下記までご連絡ください。

- メール: tokoyo.support@gmail.com

ご連絡の際は、起きている症状と、お使いの環境（Windows のバージョン）をお知らせください。

---

## 権利について

- 本ソフトウェアを使って作成した台本・音声などの**成果物の権利は利用者に帰属します**。
  用途の制限はありません（商用利用可）。
- 本ソフトウェア自体の再配布・転売・リバースエンジニアリングは禁止です。詳細は同梱の `LICENSE` を参照してください。
- 同梱しているオープンソースソフトウェアの表記は `THIRD-PARTY-NOTICES.md` にあります。
- AIの生成結果の内容について作者は責任を負いません。利用者の責任でご確認ください。
