89 lines
4.7 KiB
Markdown
89 lines
4.7 KiB
Markdown
# TUI: Assistant 応答の Markdown スタイル表示
|
||
|
||
## 背景
|
||
|
||
LLM の出力は実質 Markdown だが、TUI は `Block::AssistantText { text }` を
|
||
`push_padded_lines` で 1 行ずつ素のテキストとして
|
||
`Style(MessageKind::Assistant)` に流しているだけで、`**強調**` /
|
||
`` `code` `` / `# 見出し` / `- list` 等の記号がそのまま見える状態になっている
|
||
（`crates/tui/src/ui.rs:592-595, 640-648`）。スタイルが付かないため、
|
||
構造のあるアシスタント応答は読みにくい。
|
||
|
||
ratatui 0.30 の `Vec<Line<'static>>` で表現できる範囲のスタイル付けで
|
||
十分目的を満たせる。既存の `wrap_line_into`（`crates/tui/src/ui.rs:473-`）が
|
||
span 単位のラップを既に実装しているため、Markdown レンダラは
|
||
スタイル付きの `Vec<Line>` を返すだけでよく、ラップ／スクロール／overview
|
||
畳み込みの仕組みを変える必要はない。
|
||
|
||
## 方針
|
||
|
||
- `pulldown-cmark` を `tui` クレートの依存に追加し、Event ストリームを
|
||
既存の `MessageKind` / `ratatui::style::Style` 体系へ畳み込む小さな
|
||
自前レンダラを `crates/tui/src/markdown.rs` に置く。
|
||
- レンダラの公開面は `render(text: &str, base: Style) -> Vec<Line<'static>>`
|
||
程度の 1 関数。`Block::AssistantText` の `Mode::Detail` / `Mode::Normal`
|
||
描画から呼ぶ。`Mode::Overview` は現行通り 1 行畳み込み（Markdown 記号
|
||
含めて表示しても情報量はほぼ同じなので素のテキストでよい）。
|
||
- ストリーミング中の不完全要素（未閉鎖の `**` や開きっぱなしのフェンス）
|
||
は CommonMark の流儀（テキスト扱い／EOF で閉じる）に任せる。挙動が
|
||
破綻する場合だけ末尾要素を素のテキストにフォールバックする小さな
|
||
後処理を入れる余地を残す。
|
||
- `tui-markdown` クレートは採用しない。syntect 依存でビルドが肥大する
|
||
割にカスタマイズが効かず、本クレートの色味（`MessageKind`
|
||
パレット）との整合を握りにくいため。
|
||
|
||
## 対応する Markdown 要素
|
||
|
||
最小限の "対応できる範囲" を以下に限定する。CommonMark + GFM の一部。
|
||
|
||
- 強調: `**bold**` / `*italic*` / `~~strike~~`（GFM）
|
||
- インラインコード: `` `code` ``
|
||
- フェンスコードブロック: ` ```lang ` / ` ``` `（言語タグは無視、
|
||
ブロック全体を等幅・低彩度の背景／前景で塗る）
|
||
- 見出し: H1〜H4（H5/H6 は H4 と同等）
|
||
- 箇条書きリスト: `-` / `*` / `+`、ネスト可（深さ分インデント）
|
||
- 順序リスト: `1.` / `1)`、ネスト可（番号は元の値で表示）
|
||
- 引用: `> ...`（ネスト可）
|
||
- 水平線: `---` / `***`
|
||
- リンク: `[text](url)` の `text` をリンク色で着色（URL は表示しない）
|
||
|
||
## 範囲外
|
||
|
||
- 表（GFM table）
|
||
- 画像 ``（テキストとしても表示しない）
|
||
- HTML パススルー（タグはそのまま生テキストで出る）
|
||
- 数式（`$...$` / `$$...$$`）
|
||
- コードブロックの syntax highlighting
|
||
- リンクのターミナルクリック（OSC 8）／URL の自動表示
|
||
- `Thinking` 本文 / `SystemMessage` への適用
|
||
（同じ `markdown::render` を後で差せばよい。本チケットは
|
||
`Block::AssistantText` のみ）
|
||
- ライブストリーム最中の "途中要素のフォールバック" の作り込み
|
||
（CommonMark のデフォルト挙動で破綻が見えたら別チケット）
|
||
|
||
## 完了条件
|
||
|
||
- アシスタント応答に含まれる上記要素が、それぞれ視認可能な
|
||
スタイルで描画される。
|
||
- ストリーミング中、テキストが追記されるたびに描画が更新され、
|
||
フェンスコードブロックの開きが先に着いて中身が後から流れる
|
||
ようなケースでも、テキスト全体の見た目が大きく崩れない。
|
||
- `Mode::Detail` / `Mode::Normal` で Markdown スタイルが、
|
||
`Mode::Overview` では従来通りの 1 行畳み込みが出る。
|
||
- 既存の `wrap_line_into` によるラップ・右パディング・スクロール
|
||
が引き続き機能する（行幅計算が乱れない）。
|
||
|
||
## 影響範囲
|
||
|
||
- `crates/tui/Cargo.toml`: `pulldown-cmark` を追加（`cargo add` 経由）。
|
||
- `crates/tui/src/markdown.rs`: 新設。`render(&str, Style) -> Vec<Line<'static>>`。
|
||
- `crates/tui/src/ui.rs`: `Block::AssistantText` 分岐で Markdown
|
||
レンダラを呼ぶ。`Mode::Overview` は現行のまま。
|
||
- `crates/tui/src/main.rs` または `lib.rs`: 新モジュールの宣言。
|
||
|
||
## Review
|
||
|
||
- 状態: Approve
|
||
- レビュー詳細: [./tui-assistant-markdown.review.md](./tui-assistant-markdown.review.md)
|
||
- 日付: 2026-05-05
|